app

type App struct {
	// contains filtered or unexported fields
}

type CtlOptions struct {
	// Name is `ctl new --name` (the session to create) and is unused by
	// `ctl rename`, whose new name is a positional argument.
	Name string
	// Cwd is `ctl new --cwd`: the working directory to start in.
	Cwd string
	// Command is `ctl new --command`: typed into the new session's shell.
	Command string
	// Group is `ctl new --group` (the group to create the session in) and
	// `ctl list --group` (show only that group). The group verbs take theirs
	// as a positional argument instead, since there it is the target rather
	// than a modifier.
	Group string
	// Tail is `ctl read --tail`: last N lines only. Zero is the whole
	// scrollback.
	Tail int
	// Enter is `ctl send --enter`: append a carriage return to the text.
	// Off by default — pressing Enter is an explicit act, same as tmux's
	// send-keys.
	Enter bool
	// JSON prints the raw control.Response instead of the human rendering,
	// for a caller that would rather parse than scrape.
	JSON bool
	// State is `ctl wait --state`: the agent state to wait for (idle/working/
	// blocked/done).
	State string
	// Timeout is `ctl wait --timeout`, in seconds. Zero or unset means
	// control.DefaultWaitTimeout.
	Timeout int
}

type Invocation struct {
	Options

	// Command is one of the Command* constants.
	Command string
	// Arg is the sub-command's positional argument: the file to approve for
	// `allow`, the verb for `config`, empty for `init`.
	Arg string
	// CtlVerb is `ctl`'s verb, one of pkg/control's Verb* constants, already
	// checked against ctlVerbs.
	CtlVerb string
	// CtlArgs are the verb's positional arguments, count already checked.
	CtlArgs []string
	// Ctl are `ctl`'s flags.
	Ctl CtlOptions
}

type Options struct {
	// ConfigFile is --config-file/-f: an explicit project file, which wins over
	// every other discovery rule.
	ConfigFile string
	// NoAutostart is --no-autostart: open the UI without starting anything the
	// project file declares.
	NoAutostart bool
	// Version is --version: print the build version and exit, without touching
	// the terminal or the config. Not a sub-command, since it must also work as
	// a trailing flag (`lazyshell --version`) the way most CLIs accept it.
	Version bool
	// Agents is `init --agents`: print the AI agent hook config blocks
	// instead of writing lazyshell.yml. Meaningless outside CommandInit, so
	// checked only there — see PrintAgentHookConfig.
	Agents bool
	// EnvFiles is one or more --env-file flags, in the order given: extra
	// .env-style files loaded for every session this run creates, after each
	// session's own default "<cwd>/.env" — see session.Manager.DefaultEnvFiles.
	EnvFiles []string
	// NoEnvFile is --no-env-file: skip the automatic "<cwd>/.env" lookup
	// entirely, for every session this run creates.
	NoEnvFile bool
	// Check is `update --check`: report what the latest release is and stop,
	// without downloading or replacing anything. Meaningless outside
	// CommandUpdate, so checked only there — same as Agents above.
	Check bool
	// Force is `update --force`: install the latest release even when the
	// installed version is not older than it, or is not a published version at
	// all (a binary built from source).
	Force bool
	// Debug is --debug: record every keystroke, action and lifecycle event to
	// config.DebugLogPath() and show the last of them in a floating panel over
	// the output panel (F12 toggles it). Off by default and deliberately not a
	// config key: it is a "I am chasing something right now" switch, not a
	// preference, and the log holds everything typed into a shell.
	Debug bool
}