cli

type CleanupDeps struct {
	// RepoDir is the target repo's local working-copy path — the same
	// Config.TargetRepo value run/init use. Checked for git-repo validity
	// strictly before any lock is acquired (KTD5); a blank, missing, or
	// non-git RepoDir degrades the repo-side steps to a no-op (KTD6)
	// rather than failing the whole command.
	RepoDir string
	// Schedule bundles CheckScheduleState/RemoveSchedule's dependencies.
	// Schedule deregistration is attempted regardless of RepoDir's
	// validity or lock state (KTD5, KTD6).
	Schedule ScheduleDeps
	// Interactive gates the whole command (KTD12): cleanup always shows a
	// confirmation prompt and has no non-interactive override, so it fails
	// fast when no TTY is present, mirroring init.go's isInteractive/R5
	// pattern.
	Interactive bool
	// Accessible drives the confirmation huh.Confirm field in accessible
	// (TTY-free) mode; every test in this package sets it true, mirroring
	// WizardDeps.Accessible (KTD2).
	Accessible bool
	// Input and Output are the confirmation form's IO streams. Nil defers
	// to huh's own defaults (the real terminal, in interactive mode);
	// tests set both to drive the prompt entirely TTY-free.
	Input  io.Reader
	Output io.Writer
}

type CleanupResult struct {
	// Declined is true when the confirmation prompt was declined (or, in
	// production, interrupted via ctrl+c — indistinguishable from a
	// decline in accessible mode, see KTD2). No other field is meaningful
	// when this is true: nothing was touched.
	Declined bool
	// RepoValid reports whether RepoDir was confirmed present and a valid
	// git working tree. False means the repo-side steps below were
	// skipped as a no-op (KTD6): schedule deregistration proceeded
	// regardless.
	RepoValid bool
	// Schedule is the schedule's state as found *before* any removal
	// attempt (KTD7): ScheduleRegistered means something was found and
	// removed (assuming Cleanup's error is nil), ScheduleNotRegistered
	// means there was nothing to remove, and ScheduleCheckFailed means the
	// live state couldn't be determined at all. RemoveSchedule's own
	// return value can't distinguish "removed" from "already absent" (both
	// collapse to ScheduleNotRegistered post-removal) — this field
	// preserves that distinction instead (R11, AE3, AE4).
	Schedule ScheduleState
	// ReadmeStripped is true only if README.md actually had marker
	// interior content cleared (idempotent: a already-clean README leaves
	// this false, not an error).
	ReadmeStripped bool
	// DirRemoved is true only if .token-profile/ actually existed and was
	// removed (idempotent: an already-absent directory leaves this false).
	DirRemoved bool
}

type InitDeps struct {
	// Config supplies TargetRepo — checked fail-fast by Init itself, since
	// init_test.go needs to exercise that error path directly — plus the
	// same breakdown/window settings the first run consumes.
	Config config.Config
	// Client resolves this machine's local usage for the first run.
	Client *agentsview.Client
	// MachineID identifies this machine's snapshot file for the first run.
	MachineID string
	// Now stands in for "the current time" for the first run; see RunDeps.Now.
	Now time.Time
	// RepoDir is the target repo's working-copy path. Kept separate from
	// Config.TargetRepo so tests can point it at a scratch git fixture,
	// mirroring RunDeps.RepoDir.
	RepoDir string
	// ScheduleDest is where the scheduling entry snippet is written.
	// Injectable — rather than hardcoded to the real crontab/LaunchAgents
	// location — so tests scaffold and assert against a scratch path
	// without touching the real machine's schedule.
	ScheduleDest string
	// BinaryPath is the token-profile executable the scheduling entry
	// invokes.
	BinaryPath string
	// ConfigPath is the --config value the scheduling entry passes to
	// `token-profile run`.
	ConfigPath string
	// PathEnv, when non-empty, is propagated into both the reviewable
	// scheduling-entry snippet and the live-installed schedule (see
	// ScheduleDeps.PathEnv) — normally the PATH `init` itself ran with,
	// since that's the environment that already proved PATH-dependent
	// lookups (agentsview) resolve.
	PathEnv string
	// Stdout receives the same post-publish confirmation as RunDeps.Stdout
	// — propagated into the RunDeps Init builds internally below, so init
	// gets this output through the same shared run() core, no separate
	// implementation.
	Stdout io.Writer
	// Stdin is the post-init schedule-registration prompt's input source
	// (R4) — read via confirmYesNo's bufio-scanner y/N pattern.
	Stdin io.Reader
	// PromptSchedule gates whether the schedule-registration prompt is
	// shown at all. Resolved once by NewInitCmd via isInteractive(os.Stdin)
	// rather than Init re-deriving it from Stdin's own concrete type, so
	// tests can drive the prompt through a plain strings.Reader — isInteractive
	// would otherwise always report false for such a fixture.
	PromptSchedule bool
	// RegisterSchedule, when true, installs the refresh schedule directly —
	// skipping the interactive Y/N prompt entirely, regardless of
	// PromptSchedule — so an unattended re-run of init (e.g. from a
	// provisioning script, with no TTY present) can still opt into
	// InstallSchedule. Set via --register-schedule; false is the default
	// no-op, preserving today's prompt-or-skip behavior.
	RegisterSchedule bool
	// Schedule carries the live schedule-registration's install-time
	// parameters not already covered above: PlistPath (the real LaunchAgents
	// location InstallSchedule targets, darwin only) plus Launchctl/Crontab
	// overrides for tests. Label, BinaryPath, ConfigPath, and Interval are
	// filled in by offerScheduleRegistration itself.
	Schedule ScheduleDeps
	// DryRun propagates into the RunDeps Init builds internally, stopping
	// the first run before commit/push (R7-R9), and additionally skips the
	// schedule-registration prompt (R4) entirely (R8, AE2) — registering a
	// live schedule is exactly the kind of non-reversible step a dry run
	// must never reach.
	DryRun bool
	// HistoryPath is where Init records its scaffolding-plus-first-run
	// outcome (R1), the same store `run` records to — an adopter's very
	// first invocation is otherwise invisible to `status`. An empty value
	// silently disables recording, mirroring RunDeps.HistoryPath's own
	// nil-is-a-no-op convention.
	HistoryPath string
}

type RunDeps struct {
	// Config supplies the breakdown mode and trailing window.
	Config config.Config
	// Client resolves this machine's local usage via agentsview.
	Client *agentsview.Client
	// MachineID identifies this machine's snapshot directory within RepoDir.
	MachineID string
	// Now stands in for "the current time" throughout the run: it bounds
	// the trailing-window --since cutoff, the streak's "today", and the
	// rendered "last updated" timestamp. An explicit field (rather than
	// time.Now() called internally) keeps Run deterministic under test.
	Now time.Time
	// RepoDir is the target repo's working-copy path on disk — where the
	// snapshot is written, the README lives, and git operations run.
	// Kept separate from Config.TargetRepo so tests can point it at a
	// scratch git fixture without constructing a full config file.
	RepoDir string
	// Stdout receives a one-line confirmation — the headline summary plus
	// the just-published commit's short hash — after a successful
	// publish. Nil is valid and silently discards this output, so every
	// existing RunDeps literal that doesn't set it keeps behaving exactly
	// as before.
	Stdout io.Writer
	// DryRun stops run before gitops.Publish's stage/commit/push (R7, R9):
	// usage resolution, the snapshot write, the card render, and the README
	// injection all still happen for real, leaving the working tree with
	// real, inspectable changes — only the commit and push are skipped, in
	// favor of a printed summary of what would have been committed.
	DryRun bool
	// HistoryPath is where Run records this invocation's outcome (R1). An
	// empty value silently disables recording, mirroring Stdout's own
	// nil-is-a-no-op convention — every RunDeps literal that predates this
	// field keeps behaving exactly as before.
	HistoryPath string
}

type ScheduleDeps struct {
	// GOOS selects the darwin (launchctl) vs. other (crontab) mechanism.
	// Empty defaults to runtime.GOOS.
	GOOS string
	// Label uniquely identifies the scheduled entry: the launchd plist's
	// Label key on darwin, or a marker comment tagging the crontab entry
	// elsewhere. Mirrors launchdLabel (init.go).
	Label string
	// BinaryPath is the token-profile executable the scheduled entry
	// invokes. Only read by InstallSchedule.
	BinaryPath string
	// ConfigPath is the --config value the scheduled entry passes to
	// `run`. Only read by InstallSchedule.
	ConfigPath string
	// Interval is the scheduled-run cadence. Assumed already validated
	// against config.Config's divisor set (KTD10) by the time it reaches
	// here — this package never re-validates it. Only read by
	// InstallSchedule.
	Interval time.Duration
	// PathEnv, when non-empty, is written into the scheduled entry's own
	// environment (launchd's EnvironmentVariables PATH, cron's PATH= line)
	// — both mechanisms otherwise give a scheduled job a minimal PATH (e.g.
	// launchd's default is just /usr/bin:/bin:/usr/sbin:/sbin), which
	// doesn't include common install locations like /opt/homebrew/bin,
	// breaking PATH-dependent lookups (agentsview) the interactive session
	// that ran `init` already resolved fine. Empty leaves the scheduler's
	// own default environment in effect. Only read by InstallSchedule.
	PathEnv string
	// PlistPath is where InstallSchedule writes the launchd job's plist
	// before bootstrapping it (darwin only).
	PlistPath string
	// Launchctl overrides the launchctl executable resolved via
	// exec.LookPath. Empty defaults to "launchctl".
	Launchctl string
	// Crontab overrides the crontab executable resolved via
	// exec.LookPath. Empty defaults to "crontab".
	Crontab string
}

type ScheduleState int

type StatusDeps struct {
	// Schedule is passed to CheckScheduleState as-is. Only Label (plus the
	// GOOS/Launchctl/Crontab test overrides) is actually read for this
	// read-only check.
	Schedule ScheduleDeps
	// HistoryPath is where Status reads recorded run outcomes from.
	HistoryPath string
	// Stdout receives the rendered report. Nil is valid and silently
	// discards the report, mirroring RunDeps.Stdout's own nil-is-a-no-op
	// convention.
	Stdout io.Writer
}

type WizardDeps struct {
	// GitUserName resolves the operator's global git user.name, used to
	// pre-fill RepoName/LocalPath. Injected so tests don't depend on the
	// real machine's git config, mirroring bootstrapDeps.GitUserName.
	GitUserName func(ctx context.Context) string

	// Accessible drives the underlying huh.Form in accessible (TTY-free)
	// mode. Production callers leave this false so the form renders
	// interactively; every test in this package sets it true (KTD2).
	Accessible bool

	// Input and Output are the form's IO streams. Nil defers to huh's own
	// defaults (the real terminal, in interactive mode); tests set both to
	// drive the form entirely TTY-free.
	Input  io.Reader
	Output io.Writer
}

type WizardResult struct {
	// RepoName is the GitHub username/handle used to construct the
	// profile-repo clone URL via the existing username/username
	// convention (see profileRepoURL).
	RepoName string
	// CloneProtocol is the URL scheme to clone RepoName's profile repo
	// with.
	CloneProtocol config.CloneProtocol
	// LocalPath is where the profile repo should be cloned to locally.
	LocalPath string
}