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 RepoEdge struct {
	From string // consumer label
	To   string // dependency label
}

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 StackInventory struct {
	Members        []StackMember
	SyntheticEdges []RepoEdge // C→D when follow maps consumer C into dep checkout D
	Warnings       []string   // warning: lines (missing/non-git replaces; skipped broken nested checkouts)
}

type StackMember struct {
	// Path is the checkout toplevel path (linked worktree or main).
	Path string
	// MainRepo is the main repository directory for this checkout.
	MainRepo string
	// Label is filepath.Base(MainRepo) — DAG/pin short name (not peel display path).
	Label string
	// Dirty is true when porcelain status is non-empty (untracked counts).
	Dirty bool
	// Linked is true when Path is a linked worktree (not the main checkout).
	Linked bool
}

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

type SyncResult struct {
	IntoMain int
	IntoWT   int
	Skipped  int
}

type UnwindApplyStats struct {
	HadPeels    bool // true when PeelOrder was non-empty
	Peeled      int
	Tagged      int
	Pinned      int
	Pushed      int
	Reinstalled int
}

type UnwindCascadePlan struct {
	Steps []UnwindCascadeStep
}

type UnwindCascadeStep struct {
	Kind UnwindCascadeStepKind
	// ModulePath is the tagged module (tag-next) or consumer module (pin).
	ModulePath string
	// DepModulePath is set for pin steps (dependency module path).
	DepModulePath string
	// TagOrVersion is the full next tag for tag-next, or go require version for pin.
	TagOrVersion string
}

type UnwindCascadeStepKind string

type UnwindFlags struct {
	DryRun         bool
	TagNext        bool
	Push           bool
	Force          bool // with Push: force-with-lease branch push
	Done           bool
	MergeBack      bool
	ReinstallLocal bool
	Color          bool
	NoColor        bool // --no-color: force plain stdout (mutually exclusive with Color)
	Sync           bool
	GenCommitMsg   bool
	GenCommitArgs  []string
	// AddAll stages all changes when cascade pin commits (and gen-commit when set).
	// Top-level --add-all is accepted with --unwind without requiring --commit.
	AddAll bool
	// ShowGraph is the read-only inspect path (--unwind --show-graph).
	ShowGraph bool
	// Verify is the read-only post-job audit path (--unwind --verify).
	Verify bool
	// JSON requests machine-readable show-graph / verify output.
	JSON bool
}

type UnwindGraphModuleEdge struct {
	From    string `json:"from"`
	To      string `json:"to"`
	Kind    string `json:"kind"` // require | replace
	Version string `json:"version,omitempty"`
	NewPath string `json:"new_path,omitempty"`
}

type UnwindGraphModuleNode struct {
	Path         string `json:"path"`
	Dir          string `json:"dir"`
	RepoLabel    string `json:"repo_label"`
	LatestTag    string `json:"latest_tag,omitempty"`
	NextTag      string `json:"next_tag,omitempty"`
	OwnedChanged bool   `json:"owned_changed,omitempty"`
	SkipReason   string `json:"skip_reason,omitempty"`
}

type UnwindGraphModules struct {
	Nodes []UnwindGraphModuleNode
	Edges []UnwindGraphModuleEdge
}

type UnwindGraphRepoNode struct {
	Display   string `json:"display"`
	Label     string `json:"label"`
	Linked    bool   `json:"linked"`
	Dirty     bool   `json:"dirty"`
	Branch    string `json:"branch,omitempty"`
	HeadShort string `json:"head_short,omitempty"`
	PeelIndex int    `json:"peel_index,omitempty"` // 1-based; 0 = not in peel
	Land      bool   `json:"land,omitempty"`
}

type UnwindGraphReport struct {
	WorkDir  string
	Repos    UnwindGraphRepos
	Modules  UnwindGraphModules
	Summary  UnwindGraphSummary
	Warnings []string
}

type UnwindGraphRepos struct {
	Nodes           []UnwindGraphRepoNode
	Edges           []RepoEdge
	PeelOrder       []string // display paths, free-first
	HasPendingEdges bool
	NeedsLand       bool
}

type UnwindGraphSummary struct {
	Repos       int    `json:"repos"`
	DirtyRepos  int    `json:"dirty_repos"`
	Modules     int    `json:"modules"`
	RepoEdges   int    `json:"repo_edges"`
	ModuleEdges int    `json:"module_edges"`
	PeelSteps   int    `json:"peel_steps"`
	Cycle       string `json:"cycle"`
	ApplyHint   string `json:"apply_hint,omitempty"`
}

type UnwindPlan struct {
	PeelOrder []string // labels, free-first
	// HasPendingEdges is true when residual pending graph has any edge.
	HasPendingEdges bool
	// NeedsLand is true when any pending member is a linked worktree.
	NeedsLand bool
}

type UnwindVerifyCheck struct {
	ID       string   `json:"id"`
	Severity string   `json:"severity"`
	Status   string   `json:"status"` // pass | fail
	Count    *int     `json:"count,omitempty"`
	Details  []string `json:"details,omitempty"`
}

type UnwindVerifyReport struct {
	WorkDir  string              `json:"work_dir"`
	Checks   []UnwindVerifyCheck `json:"checks"`
	Summary  UnwindVerifySummary `json:"summary"`
	Warnings []string            `json:"warnings"`
}

type UnwindVerifySummary struct {
	Checks int    `json:"checks"`
	Pass   int    `json:"pass"`
	Fail   int    `json:"fail"`
	Warn   int    `json:"warn"`
	Result string `json:"result"` // pass | fail
}

type WebServeOptions struct {
	WrkHome string
	Port    int
	Dev     bool
}