cliutil

Jul 22, 2026

Changes in this version

+ func CompleteHookNames(_ *cobra.Command, _ []string, _ string) ([]string, cobra.ShellCompDirective)

+ func ErrInternal(err error) error

+ func FinishVerbOutcome(ctx context.Context, root, label string, outcome *Outcome, err error, ...) (code int, sha string)

+ type Outcome struct

+ DryRun bool

+ Findings []check.Finding

+ Metadata map[string]any

+ NoOp bool

+ NoOpMessage string

+ Plans []*verb.Plan

+ Subject string

+ TextDetail func()

Jul 18, 2026

Changes in this version

+ func EmitVerbOutcome(log *slog.Logger, prefix string, code int, sha string)

+ func Errorf(format string, args ...any)

+ func Errorln(args ...any)

+ func Print(args ...any)

+ func Printf(format string, args ...any)

+ func Println(args ...any)

+ func ResolveLogger(rootDir string, getenv func(string) string) (log *slog.Logger, closeLog func() error)

+ func ResolveTraceLogger(rootDir string, getenv func(string) string) (log *slog.Logger, closeLog func() error)

type OutputFormat

+ CorrelationID string

+ Trace bool

+ func (o OutputFormat) Metadata(extra map[string]any) map[string]any

Jul 7, 2026

Changes in this version

+ func GateHookDecisions(hooks []skills.HookDef, enableHooks []string, formatJSON bool) map[string]bool

+ func RunStatuslineScaffoldForVersion(opts StatuslineOpts, binary version.Info) int

+ func SyncHookMaterialization(rootDir string, target skills.Target, hooks []skills.HookDef) int

type StatuslineOpts

+ AllowUntagged bool

Jul 3, 2026

Changes in this version

+ func RunStatuslineRemove(opts StatuslineRemoveOpts) int

+ type StatuslineRemoveOpts struct

+ Force bool

+ RootDir string

+ Scope string

Jul 3, 2026

Changes in this version

+ func AuthorizeOpeners(ctx context.Context, root string) (map[string]string, error)

+ func OpenersFrom(commits []CommitTrailers) map[string]string

+ func ReplayScopes(commits []CommitTrailers) []*scope.Scope

+ type CommitTrailers struct

+ SHA string

+ Trailers []gitops.Trailer

Jun 28, 2026

Changes in this version

+ func CompleteAreaArg(position int) func(*cobra.Command, []string, string) ([]string, cobra.ShellCompDirective)

+ func CompleteAreaValueArg(position int) func(*cobra.Command, []string, string) ([]string, cobra.ShellCompDirective)

+ func ConfiguredAreaMembersFull(rootDir string) []config.Member

+ func ConfiguredAreaRequired(rootDir string) bool

Jun 24, 2026

Changes in this version

+ func CompleteAreaFlag() func(*cobra.Command, []string, string) ([]string, cobra.ShellCompDirective)

+ func ConfiguredAreaMembers(rootDir string) []string

+ func ConfiguredAreas(rootDir string) (members []string, defaultLabel string)

+ func UndeclaredAreaNote(rootDir, area string) string

Jun 11, 2026

Changes in this version

+ func ConfiguredTrunkBranchShortName(rootDir string) string

May 31, 2026

Changes in this version

+ func RunStatuslineScaffold(opts StatuslineOpts) int

+ type StatuslineOpts struct

+ FormatJSON bool

+ RootDir string

+ Scope string

+ WireSettings bool

May 30, 2026

Changes in this version

+ const AnnotationRegisteredVerbs

May 28, 2026

Changes in this version

+ type OutputFormat struct

+ Format string

+ Pretty bool

+ func AddFormatFlags(cmd *cobra.Command) *OutputFormat

+ func (o OutputFormat) JSON() bool

May 21, 2026

Changes in this version

+ const ActorSourceFlag

+ const ActorSourceGitConfig

+ const ExitFindings

+ const ExitInternal

+ const ExitOK

+ const ExitUsage

+ func AcquireRepoLock(rootDir, verbDisplay string) (release func(), rc int)

+ func AllKindNames() []string

+ func AssertSupportedOS(goos string) error

+ func CompleteEntityIDArg(filter entity.Kind, position int) func(*cobra.Command, []string, string) ([]string, cobra.ShellCompDirective)

+ func CompleteEntityIDFlag(filter entity.Kind) func(*cobra.Command, []string, string) ([]string, cobra.ShellCompDirective)

+ func CompleteEntityIDs(filter entity.Kind) ([]string, cobra.ShellCompDirective)

+ func ConfiguredTitleMaxLength(rootDir string) int

+ func DecorateAndFinish(ctx context.Context, root, label string, t *tree.Tree, result *verb.Result, ...) int

+ func FinishVerb(ctx context.Context, root, label string, result *verb.Result, err error) int

+ func HasCommits(ctx context.Context, root string) bool

+ func IsTerminalPromote(k entity.Kind, newStatus string) bool

+ func JoinKinds(ks []entity.Kind) string

+ func LoadContractsBlock(rootDir string) (*aiwfyaml.Contracts, error)

+ func LoadContractsDoc(rootDir string) (*aiwfyaml.Doc, *aiwfyaml.Contracts, error)

+ func LoadEntityScopes(ctx context.Context, root, id string) ([]*scope.Scope, error)

+ func LoadTreeWithTrunk(ctx context.Context, rootDir string) (*tree.Tree, []tree.LoadError, error)

+ func ParseKind(s string) (entity.Kind, bool)

+ func ParseTestsFlag(raw, verbLabel string) (*gitops.TestMetrics, error)

+ func ReadBodyFile(path string) ([]byte, error)

+ func RegisterFormatCompletion(cmd *cobra.Command)

+ func ReorderFlagsFirst(args, knownFlags, knownBoolFlags []string) []string

+ func ResolveActor(explicit, root string) (string, error)

+ func ResolveActorWithSource(explicit, root string) (actor, source string, err error)

+ func ResolveCurrentEntityID(ctx context.Context, root, id string) (string, error)

+ func ResolveRoot(explicit string) (string, error)

+ func SplitCommaList(s string) []string

+ func StatusesForID(id string) []string

+ func WrapExitCode(code int) error

+ type ExitError struct

+ Code int

+ func (e *ExitError) Error() string

+ type ProvenanceContext struct

+ Actor string

+ CreationRefs []string

+ IsTerminalPromote bool

+ MoveSource string

+ Principal string

+ TargetID string

+ VerbKind verb.VerbKind