Documentation
¶
Overview ¶
Package cmd assembles the tai CLI's urfave/cli command tree.
Subcommands land here as their OpenSpec changes are applied. The package is the single seam every test and the production binary uses to build the command — there is no global state, and the function is cheap to call repeatedly.
Index ¶
Constants ¶
const RepoFlag = "repo"
RepoFlag is the canonical name of the global `--repo` flag. Exported so subcommand wiring (and tests) can reference it without re-stating the literal.
Variables ¶
This section is empty.
Functions ¶
func NewRoot ¶
func NewRoot(opts ...RootOption) *cli.Command
NewRoot returns a freshly-assembled tai root command.
Writer / ErrWriter / Reader default to os.Stdout/Stderr/Stdin on the returned value; tests in plugins/triage/internal/cmdtest swap them for buffers.
Three hooks are wired here to make stderr single-source and to ensure unknown subcommands route through the foundation's error contract:
- Action: a root-level fallback that fires when no subcommand matched. If positional arguments are present (i.e. `tai bogus`), returns UnknownSubcommand. If none are present (`tai`), shows help.
- OnUsageError: converts urfave/cli's parser/usage failures into *errcode.Error{Code: UnknownSubcommand} so the printer in pkg/cliout owns the rendered template.
- ExitErrHandler: a no-op. urfave/cli's default HandleExitCoder prints the error to its package-level ErrWriter and calls os.Exit; we want neither. Setting a no-op handler lets the error flow back to cliexec.Run, where main.go takes over.
func RequireRepo ¶
RequireRepo resolves the repo identity for a subcommand action. It is the canonical entry point — subcommands that need repo context call it from their Action and either get a valid Identity back or surface the structured error to the user.
The resolver applies the foundation's precedence: --repo flag value (validated via repoctx.ParseIdentity) > working-directory auto-detect via `git config --get remote.origin.url`.
"Repo-independent" subcommands (e.g. tai install, tai --help, tai --version) are simply those whose Action does NOT call RequireRepo. The opt-in shape keeps the contract explicit at the call site rather than hidden in a registry: a reader of the subcommand's Action sees whether it needs repo context.
Types ¶
type RootOption ¶
type RootOption func(*rootConfig)
RootOption configures NewRoot. Production calls NewRoot() with no options; tests pass WithBundle to swap the install/uninstall bundle without touching package-level mutable state.
func WithBundle ¶
func WithBundle(b installer.Bundle) RootOption
WithBundle overrides the bundle that `tai install` and `tai uninstall` reconcile against. Production calls NewRoot() without this option; tests use it to inject a fake bundle.
Source Files