cli

type CompatibilityResult struct {
	Installed  string `json:"installed"`
	Required   string `json:"required"` // empty when no requirement is declared
	Compatible bool   `json:"compatible"`
	// Development is true when the installed version is not a recognized semantic
	// version (a local "dev" build): the requirement is waved through rather than
	// enforced, so a machine consumer can tell this apart from a genuine match.
	Development bool   `json:"development"`
	Runefile    string `json:"runefile"` // resolved path, empty when none found
}

type Interrupted struct{ Err error }

type LSPOptions struct {
	LogFile  string // path to write logs to; empty means stderr
	LogLevel string // error|warn|info|debug (coarse for the MVP)
}

type Options struct {
	File       string // -f/--file
	List       bool   // --list
	DryRun     bool   // --dry-run
	Summary    bool   // --summary
	Dump       bool   // --dump
	DumpFormat string // --format (with --dump)
	Set        []string
	Watch      bool
	Choose     bool
	Yes        bool
	Quiet      bool
	Fmt        bool
	ClearCache bool

	// IgnoreVersion bypasses the Runefile's minimum_version gate for this run
	// (the CLI-only --ignore-version flag). It is never settable from a Runefile.
	IgnoreVersion bool
	// MCPAllowIgnoreVersion lets the MCP/agent server run despite an unmet
	// minimum_version. It is an operator-only opt (a `rune serve` flag), disabled
	// by default, and never settable from a Runefile.
	MCPAllowIgnoreVersion bool

	// Resolved per-stream color decisions (see cmd/rune): ColorStdout gates
	// --list and --help (which write to stdout); ColorStderr gates Rune's own
	// messages — status/echo/cache lines and diagnostics — on stderr.
	ColorStdout bool
	ColorStderr bool
	Version     string
	Cwd         string
	Ctx         context.Context // cancelled on SIGINT (nil => Background)
	Stdin       io.Reader
	Stdout      io.Writer
	Stderr      io.Writer

	// Commands are the reserved subcommand names (and aliases). They are used
	// only to enrich the "unknown task" error with a did-you-mean suggestion.
	Commands []string
}

type TaskCandidate struct {
	Name string
	Doc  string
}

type TaskFailure struct {
	Err    error
	Silent bool
}

type UsageError struct{ Err error }

type ValidationError struct{ Err error }