Documentation
¶
Overview ¶
Package acknowledgeillegal implements the `aiwf acknowledge-illegal` verb. It is the per-verb subpackage that internal/cli/root.go's NewRootCmd wires via NewCmd(); per the M-0115 pattern, every cmd/aiwf verb lives under internal/cli/<verb>/.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func NewCmd ¶
NewCmd builds `aiwf acknowledge-illegal <sha> --reason "..."`. The verb is the retroactive sovereign-override mechanism for the fsm-history-consistent rule's illegal-transition findings (M-0136 closes G-0150's request for a non-config-file exemption path).
The verb requires a `human/...` actor (sovereign acts trace to a named human) and a non-empty `--reason`. Per M-0136 design, the acknowledgment is an empty commit carrying aiwf-force-for: <sha> alongside the standard aiwf-verb / aiwf-actor / aiwf-reason trailers — no aiwf.yaml entry, no history rewrite.
G-0231 item 3: an optional `--for-entity <id>` flag binds the ack to a specific (SHA, entity) pair. The verb verifies at write time that <sha>'s diff actually touches <id>'s file; if not, the ack is refused. Required when acking against provenance-untrailered-entity-commit.
func Run ¶
func Run(sha, actor, root, reason, forEntity string, out cliutil.OutputFormat) int
Run executes `aiwf acknowledge-illegal`. Returns one of the cliutil.Exit* codes; the caller (RunE in NewCmd) wraps the int in cliutil.WrapExitCode so Cobra's RunE channel preserves the exit code through the run() dispatcher.
Types ¶
This section is empty.