up

type HeadlessOptions struct {
	GlobalFlags        *flags.GlobalFlags
	DevsyConfig        *config.Config
	CLIOptions         provider2.CLIOptions
	ProviderOptions    []string
	SecretsFile        string
	FeatureSecretsFile string
}

type Options struct {
	Source           string // git URL, local path, image, or workspace name
	Name             string // explicit workspace ID override
	Provider         string // provider name override
	IDE              string // ide name; "none" to skip launching
	DevcontainerPath string // path to devcontainer.json, relative to project
	// DevContainerSource overrides devcontainer discovery (e.g. "image:<ref>"),
	// used by snapshot restore to run the committed image directly.
	DevContainerSource string
	// RunArgs are extra `docker run` arguments to apply when DevContainerSource
	// suppresses the project devcontainer.json, so runArgs it would have set
	// (e.g. --add-host) still take effect. Used by snapshot restore to replay
	// the original devcontainer.json's runArgs.
	RunArgs []string
	// ContainerEnv are extra container environment variables to apply under
	// the same suppressed-discovery circumstances as RunArgs. Used by
	// snapshot restore to replay the original devcontainer.json's containerEnv.
	ContainerEnv map[string]string
}

type UpCmd struct {
	provider2.CLIOptions
	*flags.GlobalFlags

	Machine string

	ProviderOptions []string

	FromSnapshot string // snapshot ref to restore from, e.g. ghcr.io/acme/s:my-ws-20260731150405-abcxyz

	ConfigureSSH       bool
	GPGAgentForwarding bool
	SSHTunnelMode      bool
	IDELaunch          opener.IDELaunchMode
	Reconfigure        bool

	SSHConfigPath      string
	SecretsFile        string
	FeatureSecretsFile string
	WorkspaceFolder    string

	DotfilesSource        string
	DotfilesScript        string
	DotfilesTargetPath    string
	DotfilesScriptEnv     []string // Key=Value to pass to install script
	DotfilesScriptEnvFile []string // Paths to files containing Key=Value pairs to pass to install script

	// See cmd.runDetached.
	Detach bool

	// Out receives result/error JSON envelopes; nil falls back to os.Stdout.
	Out io.Writer
	// contains filtered or unexported fields
}