wrkcli

type Action string

type CaptureOpts struct {
	// Args are CLI args after the program name (same as wrkcli.Run).
	Args []string
	// Dir, when non-empty, is the virtual process cwd for the duration of the
	// call (via processCwd / captureDir under the capture mutex — no os.Chdir,
	// so parallel test Setup/git keep a valid real getcwd). Prefer absolute
	// paths. Omit when cwd is irrelevant (most short paths).
	Dir string
	// WrkHome, when non-empty, overrides WRK_HOME without os.Setenv (Parallel-safe).
	WrkHome string
	// Env are additional KEY=VAL entries. WRK_HOME and WRK_DATE are peeled into
	// capture overrides (no Setenv). Other keys still use temporary Setenv under
	// the capture mutex — avoid those when mixing with parallel Environ readers.
	Env []string
	// Stdin, when non-empty, replaces os.Stdin with a pipe containing this
	// data for the duration of the call (restored afterward). Use for
	// --confirm-from-stdin and similar non-TTY prompt paths. Empty leaves
	// the process stdin unchanged (typically not a pipe under go test).
	Stdin string
	// ScanTestPauseAfterFirstPrint is passed through to RunWithOpts (not env).
	// See RunOpts.ScanTestPauseAfterFirstPrint for docs and supporting tests.
	ScanTestPauseAfterFirstPrint time.Duration
	// WithGo is the injectable Go SDK resolver for dep-update versioned tidy.
	// Production leaves this zero; Capture tests set InstallDir + Download:false.
	WithGo withgo.ResolveOptions
}

type CaptureResult struct {
	Stdout   string
	Stderr   string
	ExitCode int
}

type CompletionRequest struct {
	Words []string
	CWord int
}

type Config struct {
	Version int            `json:"version"`
	Create  *CreateSection `json:"create,omitempty"`
}

type CreateAgent struct {
	Enabled        *bool    `json:"enabled,omitempty"`
	Runner         string   `json:"runner,omitempty"`
	PromptTemplate string   `json:"prompt_template,omitempty"`
	Args           []string `json:"args,omitempty"`
}

type CreateSection struct {
	Window   *CreateWindow   `json:"window,omitempty"`
	Terminal *CreateTerminal `json:"terminal,omitempty"`
	Agent    *CreateAgent    `json:"agent,omitempty"`
}

type CreateTerminal struct {
	// Mode is "new" | "reuse" | "smart"; absent/empty means terminal off.
	Mode string `json:"mode,omitempty"`
}

type CreateWindow struct {
	// Mode is "new" when window UX is on; absent/empty means off.
	Mode string `json:"mode,omitempty"`
}

type CreateWorktreeResult struct {
	Path   string
	Branch string
}

type DepUpdateAllAction struct {
	ConsumerModDir string
	ConsumerPath   string
	CheckoutPath   string // stack member Path containing the consumer
	DepModule      string
	DepDir         string // owner module dir on registered main path
	OldVersion     string
	NewVersion     string
	Tag            string
}

type DepUpdateAllPlan struct {
	Actions   []DepUpdateAllAction
	Already   int
	Skipped   int
	Warnings  []string // may include warning: prefix
	Checkouts int      // stack member count (used when there are no pin actions)
}

type DirHintOptions struct {
	RawArgs     []string
	Positionals []string
	DepMode     bool
}

type Edge struct {
	ConsumerProject string
	ConsumerModule  string
	DepPath         string
	DepVersion      string
	OwnerProject    string
}

type ExitCodeError struct {
	Code int
}

type Inventory struct {
	Projects     []ProjectEntry
	SkippedPaths []string
}

type LocalReinstallPlan struct {
	ModuleRoot  string
	ModulePath  string // full module path from go.mod
	ModuleName  string // basename of module path from go.mod
	BinDir      string
	Items       []PlanItem            // sorted lexicographically by BinName
	Diagnostics []ReinstallDiagnostic // sorted by BinName, then Kind
}

type Method string

type ModuleEntry struct {
	Dir      string // relative to project Path; "." for root
	Path     string // module path from go.mod
	Requires []RequireEntry
	Replaces []ReplaceEntry
}

type ModuleReinstallPlan struct {
	ModuleRoot  string
	ModulePath  string                // full module path from go.mod
	ModuleName  string                // basename of module path from go.mod
	RelDir      string                // module root relative to scan root ("." or slash path); set by FromWorkDir
	Items       []PlanItem            // sorted lexicographically by BinName
	Diagnostics []ReinstallDiagnostic // per-module; sorted by BinName, then Kind
}

type MultiLocalReinstallPlan struct {
	BinDir  string
	Modules []ModuleReinstallPlan
}

type PinLocalsAction struct {
	ConsumerModDir string
	ConsumerPath   string
	DepPath        string
	DepModDir      string
	RelPath        string // ./ or ../ slash form
	Kind           string // add | rewrite | already
}

type PinLocalsPlan struct {
	Actions  []PinLocalsAction
	Warnings []string // soft multi-owner etc. (may include warning: prefix)
}

type PlanItem struct {
	BinName string
	RelPath string // "./cmd/foo" or "./script/foo/install"
	Method  Method // "go-install" | "go-run-install"
	Action  Action // "install" | "skip"
}

type ProjectEntry struct {
	Path    string
	Modules []ModuleEntry
}

type ReinstallDiagnostic struct {
	Level   string // "notice" | "warning"
	Kind    string // "prefer-script" | "ambiguous-cmd" | "ambiguous-script"
	BinName string
	Paths   []string // sorted ./ relative paths involved
}

type ReinstallExecStats struct {
	Reinstalled int
	Skipped     int
	Failed      int
}

type ReplaceEntry struct {
	OldPath    string
	NewPath    string
	NewVersion string
}

type RequireEntry struct {
	Path    string
	Version string
}

type RunOpts struct {
	// Args are CLI args after the program name (same as Run).
	Args []string

	// ScanTestPauseAfterFirstPrint, when > 0, pauses after the first path
	// printed by --scan-git-repos so mid-scan interrupt tests can cancel
	// while the walk is still open. Production leaves this zero.
	//
	// Supporting tests:
	//   - cmd/wrk/tests/scan-git-repos/interrupt/sigint-after-first-path
	//   - (other leaves under scan-git-repos/interrupt/ if added)
	ScanTestPauseAfterFirstPrint time.Duration

	// WithGo is the injectable Go SDK resolver for dep-update versioned tidy.
	// Zero value: production defaults (userHomeDir()/installed, Download:true).
	WithGo withgo.ResolveOptions
}

type SourceRelease struct {
	ModulePath string
	Tag        string // full git tag, e.g. "v1.2.3" or "sub/v0.1.0"
	Version    string // go require version, e.g. "v1.2.3" or "v0.1.0"
}

type SourceReleasesResult struct {
	Releases []SourceRelease
	Missing  []string
}

type StatusPathLists struct {
	Primary  []string
	External []string
}

type SyncResult struct {
	IntoMain int
	IntoWT   int
	Skipped  int
}

type WebServeOptions struct {
	WrkHome string
	Port    int
	Dev     bool
}