@journeykit/canon 0.30.0 → 0.32.0

package/man/canon-init.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-init 1  "init 0.30.0" 
+.TH canon-init 1  "init 0.32.0" 
 .SH NAME
 canon\-init \- Set up canon in a repo (canon.yaml, a starter policy, the AGENTS.md block, a plans home)
 .SH SYNOPSIS
@@ -95,4 +95,4 @@ it installs nothing and says how to choose. The answer is recorded as
 Rerunning in a repo that has canon.yaml leaves canon.yaml and .canon/policy.yaml
 alone and only refreshes the canon block in AGENTS.md.
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-inventory-sync.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-inventory-sync 1  "sync 0.30.0" 
+.TH canon-inventory-sync 1  "sync 0.32.0" 
 .SH NAME
 canon\-inventory\-sync \- Validate each spec root, then materialize scenario index records
 .SH SYNOPSIS
@@ -47,4 +47,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-inventory.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-inventory 1  "inventory 0.30.0" 
+.TH canon-inventory 1  "inventory 0.32.0" 
 .SH NAME
 canon\-inventory \- Index a validated .feature corpus into the scenario ledger
 .SH SYNOPSIS
@@ -36,4 +36,4 @@ Print version
 canon\-inventory\-sync(1)
 Validate each spec root, then materialize scenario index records
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-ledger-compact.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-ledger-compact 1  "compact 0.30.0" 
+.TH canon-ledger-compact 1  "compact 0.32.0" 
 .SH NAME
 canon\-ledger\-compact \- Move superseded versions of every record out of the ledger into the archive
 .SH SYNOPSIS
@@ -47,4 +47,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-ledger.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-ledger 1  "ledger 0.30.0" 
+.TH canon-ledger 1  "ledger 0.32.0" 
 .SH NAME
 canon\-ledger \- Keep the ledger to the current version of each record
 .SH SYNOPSIS
@@ -51,4 +51,4 @@ this is for a ledger written before 0.23, or after an interrupted move. Idempote
 `canon migrate` runs it. A record that carries a standing claim (a flagged overlay, a
 brief override, an approval at the current evidence) stays in the ledger.
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-migrate.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-migrate 1  "migrate 0.30.0" 
+.TH canon-migrate 1  "migrate 0.32.0" 
 .SH NAME
 canon\-migrate \- Bring a repo from an earlier canon up to date: the 0.17 layout (specs, changes, approvals, skills, .gitignore), the 0.28 hooks, scripts and skill stub (backed up under .canon/migrate\-backup/), the 0.23 latest\-only ledger (superseded versions to .canon/archive) and 0.23 review pins
 .SH SYNOPSIS
-\fBcanon migrate\fR [\fB\-\-as\fR] [\fB\-\-repo\fR] [\fB\-\-commit\fR] [\fB\-\-plan\-digest\fR] [\fB\-\-revert\fR] [\fB\-\-backup\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] 
+\fBcanon migrate\fR [\fB\-\-as\fR] [\fB\-\-repo\fR] [\fB\-\-commit\fR] [\fB\-\-plan\-digest\fR] [\fB\-\-revert\fR] [\fB\-\-backup\fR] [\fB\-\-relayed\-via\fR] [\fB\-\-actor\fR] [\fB\-\-approver\fR] [\fB\-\-note\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] 
 .SH DESCRIPTION
 Bring a repo from an earlier canon up to date: the 0.17 layout (specs, changes, approvals, skills, .gitignore), the 0.28 hooks, scripts and skill stub (backed up under .canon/migrate\-backup/), the 0.23 latest\-only ledger (superseded versions to .canon/archive) and 0.23 review pins
 .SH OPTIONS
@@ -41,6 +41,18 @@ Undo the last committed migrate (restores what it backed up, undoes its moves an
 \fB\-\-backup\fR \fI<DIR>\fR
 With \-\-revert, the backup directory to restore (default: the newest under .canon/migrate\-backup/)
 .TP
+\fB\-\-relayed\-via\fR \fI<NAME>\fR
+With \-\-commit, record the human\*(Aqs answer to a plan that re\-binds `Approved:` lines on their behalf: the tool they were asked with (`ask`, `AskUserQuestion`, `chat`); an agent role may commit such a plan only with it
+.TP
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR
+With \-\-relayed\-via, the agent\*(Aqs actor id (default: the CANON_ACTOR environment variable)
+.TP
+\fB\-\-approver\fR \fI<NAME>\fR
+With \-\-relayed\-via, who the human is
+.TP
+\fB\-\-note\fR \fI<TEXT>\fR
+With \-\-relayed\-via, the human\*(Aqs answer as they gave it
+.TP
 \fB\-\-json\fR
 Output JSON instead of the human\-readable form
 .TP
@@ -102,5 +114,10 @@ Refuses (exit 2, nothing written) on uncommitted changes under a path it
 moves, on a destination that already exists, on a change directory that could
 stop halfway, and on a canon.yaml edit it cannot make with every other byte
 kept. canon.yaml is written atomically.
+\- Change briefs in the 0.30 format (`canon:` comments, Korean headings) are rewritten to the 0.31
+  format: comments gone, waivers in the frontmatter, headings in English. The plan says first whether it
+  re\-binds an `Approved:` digest or a chore review pin; then `\-\-commit` is the human\*(Aqs (HUMAN_ONLY for
+  every agent role). `\-\-revert` restores them byte for byte and refuses, naming the file, when one changed
+  since the migrate.
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-plugin-sync.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-plugin-sync 1  "sync 0.30.0" 
+.TH canon-plugin-sync 1  "sync 0.32.0" 
 .SH NAME
 canon\-plugin\-sync \- Validate and write a plugin\*(Aqs overlay records
 .SH SYNOPSIS
@@ -50,4 +50,4 @@ Print version
 <\fIPLUGIN_ID\fR>
 A .canon/plugins/<id>/plugin.yaml manifest id (e.g. porting)
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-plugin.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-plugin 1  "plugin 0.30.0" 
+.TH canon-plugin 1  "plugin 0.32.0" 
 .SH NAME
 canon\-plugin \- Sync plugin overlay records onto the ledger
 .SH SYNOPSIS
@@ -36,4 +36,4 @@ Print version
 canon\-plugin\-sync(1)
 Validate and write a plugin\*(Aqs overlay records
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-policy-approve.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-policy-approve 1  "approve 0.30.0" 
+.TH canon-policy-approve 1  "approve 0.32.0" 
 .SH NAME
 canon\-policy\-approve \- Approve the current .canon/policy.yaml (written directly; nothing to promote)
 .SH SYNOPSIS
-\fBcanon policy approve\fR <\fB\-\-approver\fR> [\fB\-\-as\fR] [\fB\-\-note\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] 
+\fBcanon policy approve\fR <\fB\-\-approver\fR> [\fB\-\-as\fR] [\fB\-\-note\fR] [\fB\-\-relayed\-via\fR] [\fB\-\-actor\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] 
 .SH DESCRIPTION
 Approve the current .canon/policy.yaml (written directly; nothing to promote)
 .SH OPTIONS
@@ -32,6 +32,12 @@ orchestrator
 \fB\-\-note\fR \fI<TEXT>\fR
 Why, or what was reviewed
 .TP
+\fB\-\-relayed\-via\fR \fI<NAME>\fR
+Record the human\*(Aqs answer on their behalf: the tool they were asked with (`ask`, `AskUserQuestion`, `chat`); an agent role may run the call only with it, and then \-\-note carries the human\*(Aqs answer
+.TP
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR
+With \-\-relayed\-via, the agent\*(Aqs actor id (default: the CANON_ACTOR environment variable)
+.TP
 \fB\-\-repo\fR \fI<DIR>\fR
 The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
 .TP
@@ -47,4 +53,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-policy-show.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-policy-show 1  "show 0.30.0" 
+.TH canon-policy-show 1  "show 0.32.0" 
 .SH NAME
 canon\-policy\-show \- Show the policy\*(Aqs digest and its approval (who, when, which bytes)
 .SH SYNOPSIS
@@ -38,4 +38,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-policy.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-policy 1  "policy 0.30.0" 
+.TH canon-policy 1  "policy 0.32.0" 
 .SH NAME
 canon\-policy \- Record who approved the gate\*(Aqs policy (.canon/policy.yaml) and which bytes
 .SH SYNOPSIS
@@ -49,4 +49,4 @@ approval (or whose approval cannot be read) fails closed: `gate check` exits 1
 and `subject move` refuses to ship or reopen; `\-\-override\-reason` does not
 waive it. `canon policy show` reads the approval back.
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-prompt-add.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-prompt-add 1  "add 0.30.0" 
+.TH canon-prompt-add 1  "add 0.32.0" 
 .SH NAME
 canon\-prompt\-add \- Add a prompt bundle from a repository\-local JSON manifest
 .SH SYNOPSIS
@@ -44,4 +44,4 @@ Print help
 <\fINAME@VERSION\fR>
 The bundle to register, `NAME@VERSION`
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-prompt-show.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-prompt-show 1  "show 0.30.0" 
+.TH canon-prompt-show 1  "show 0.32.0" 
 .SH NAME
 canon\-prompt\-show \- Select a registered prompt bundle version
 .SH SYNOPSIS
@@ -38,4 +38,4 @@ Print help
 <\fINAME@VERSION\fR>
 The bundle to show, `NAME@VERSION`
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-prompt.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-prompt 1  "prompt 0.30.0" 
+.TH canon-prompt 1  "prompt 0.32.0" 
 .SH NAME
 canon\-prompt \- Register and select versioned prompt bundles
 .SH SYNOPSIS
@@ -40,4 +40,4 @@ Examples:
   canon prompt add reviewer@v1 \-\-manifest .canon/reviewer.json
   canon prompt show reviewer@v1 \-\-json
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-purge.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-purge 1  "purge 0.30.0" 
+.TH canon-purge 1  "purge 0.32.0" 
 .SH NAME
 canon\-purge \- Remove allowlisted records older than a cutoff: the bare run previews the removal set and its planDigest, `\-\-commit \-\-plan\-digest <DIGEST>` deletes it
 .SH SYNOPSIS
@@ -67,4 +67,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-query.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-query 1  "query 0.30.0" 
+.TH canon-query 1  "query 0.32.0" 
 .SH NAME
 canon\-query \- Read stored records across every storage tier
 .SH SYNOPSIS
-\fBcanon query\fR [\fB\-\-as\fR] <\fB\-\-kind\fR> [\fB\-\-since\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-plugin\-id\fR] [\fB\-\-history\fR] [\fB\-\-change\-id\fR] [\fB\-\-status\fR] [\fB\-\-domain\fR] [\fB\-\-include\-sensitive\fR] [\fB\-\-limit\fR] [\fB\-\-cursor\fR] [\fB\-\-all\fR] [\fB\-\-fields\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] 
+\fBcanon query\fR [\fB\-\-as\fR] <\fB\-\-kind\fR> [\fB\-\-since\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-plugin\fR] [\fB\-\-history\fR] [\fB\-\-change\fR] [\fB\-\-status\fR] [\fB\-\-domain\fR] [\fB\-\-include\-sensitive\fR] [\fB\-\-limit\fR] [\fB\-\-cursor\fR] [\fB\-\-all\fR] [\fB\-\-fields\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] 
 .SH DESCRIPTION
 Read stored records across every storage tier
 .SH OPTIONS
@@ -72,13 +72,13 @@ The repo to act on (default: the nearest ancestor directory holding a canon.yaml
 \fB\-\-json\fR
 Output JSON instead of the human\-readable form
 .TP
-\fB\-\-plugin\-id\fR \fI<PLUGIN_ID>\fR
+\fB\-\-plugin\fR \fI<PLUGIN_ID>\fR
 Project a plugin\*(Aqs overlay fields onto each record (fail\-soft)
 .TP
 \fB\-\-history\fR
 Every version of the kind, the ledger\*(Aqs and the archive\*(Aqs, oldest first, instead of the current records
 .TP
-\fB\-\-change\-id\fR \fI<CHANGE_ID>\fR
+\fB\-\-change\fR \fI<CHANGE_ID>\fR
 Scope \-\-kind change/task to one ChangeId (other kinds exit 2)
 .TP
 \fB\-\-status\fR \fI<STATUS>\fR
@@ -108,4 +108,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-regime-show.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-regime-show 1  "show 0.30.0" 
+.TH canon-regime-show 1  "show 0.32.0" 
 .SH NAME
 canon\-regime\-show \- Build a canonical regime key for hook scripts
 .SH SYNOPSIS
@@ -47,4 +47,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-regime.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-regime 1  "regime 0.30.0" 
+.TH canon-regime 1  "regime 0.32.0" 
 .SH NAME
 canon\-regime \- Build a canonical regime key for hook scripts
 .SH SYNOPSIS
@@ -36,4 +36,4 @@ Print version
 canon\-regime\-show(1)
 Build a canonical regime key for hook scripts
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-report-build.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-report-build 1  "build 0.30.0" 
+.TH canon-report-build 1  "build 0.32.0" 
 .SH NAME
 canon\-report\-build \- Write the status report (.canon/REPORT.md)
 .SH SYNOPSIS
@@ -41,4 +41,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-report-check.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-report-check 1  "check 0.30.0" 
+.TH canon-report-check 1  "check 0.32.0" 
 .SH NAME
 canon\-report\-check \- Byte\-diff .canon/REPORT.md against a fresh build (0 fresh, 1 missing or drifted); writes nothing
 .SH SYNOPSIS
@@ -38,4 +38,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-report-snapshot.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-report-snapshot 1  "snapshot 0.30.0" 
+.TH canon-report-snapshot 1  "snapshot 0.32.0" 
 .SH NAME
 canon\-report\-snapshot \- Export the panel marts to <DIR>/*.parquet plus manifest.json
 .SH SYNOPSIS
@@ -44,4 +44,4 @@ Print version
 <\fIDIR\fR>
 The output directory (created if absent)
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-report.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-report 1  "report 0.30.0" 
+.TH canon-report 1  "report 0.32.0" 
 .SH NAME
 canon\-report \- Build, check, or snapshot the status report
 .SH SYNOPSIS
@@ -42,4 +42,4 @@ Byte\-diff .canon/REPORT.md against a fresh build (0 fresh, 1 missing or drifted
 canon\-report\-snapshot(1)
 Export the panel marts to <DIR>/*.parquet plus manifest.json
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-retrieve.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-retrieve 1  "retrieve 0.30.0" 
+.TH canon-retrieve 1  "retrieve 0.32.0" 
 .SH NAME
 canon\-retrieve \- Fetch role\-scoped strategy guidance
 .SH SYNOPSIS
-\fBcanon retrieve\fR [\fB\-\-as\fR] <\fB\-\-for\-role\fR> [\fB\-\-regime\fR] [\fB\-\-domain\fR] [\fB\-\-subject\-id\fR] [\fB\-\-limit\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] 
+\fBcanon retrieve\fR [\fB\-\-as\fR] <\fB\-\-for\-role\fR> [\fB\-\-regime\fR] [\fB\-\-domain\fR] [\fB\-\-subject\fR] [\fB\-\-limit\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] 
 .SH DESCRIPTION
 Fetch role\-scoped strategy guidance
 .SH OPTIONS
@@ -30,12 +30,12 @@ orchestrator
 Role scope; with \-\-regime must equal its leading segment
 .TP
 \fB\-\-regime\fR \fI<KEY>\fR
-Full regime key (<role>/<repo>/<area>/<hash>); mutually exclusive with \-\-domain/\-\-subject\-id
+Full regime key (<role>/<repo>/<area>/<hash>); mutually exclusive with \-\-domain/\-\-subject
 .TP
 \fB\-\-domain\fR \fI<NAME>\fR
 Derive the regime from a domain slug; mutually exclusive with \-\-regime
 .TP
-\fB\-\-subject\-id\fR \fI<SUBJECT_ID>\fR
+\fB\-\-subject\fR \fI<SUBJECT_ID>\fR
 Narrow \-\-domain to one subject_id; requires \-\-domain, mutually exclusive with \-\-regime
 .TP
 \fB\-\-limit\fR \fI<N>\fR [default: 5]
@@ -53,4 +53,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-review-change.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-review-change 1  "change 0.30.0" 
+.TH canon-review-change 1  "change 0.32.0" 
 .SH NAME
 canon\-review\-change \- Write one attributed Review record for a chore change directly to the ledger (exactly one provenance ref required). The review signs the chore\*(Aqs invariants and checks against the diff and pins the change\*(Aqs brief; an edit to the brief stales it. A chore needs exactly this one review before `subject move \-\-to shipped`
 .SH SYNOPSIS
-\fBcanon review change\fR [\fB\-\-as\fR] [\fB\-\-project\-id\fR] <\fB\-\-actor\-id\fR> [\fB\-\-rev\fR] [\fB\-\-upstream\-ref\fR] [\fB\-\-original\-spec\-ref\fR] [\fB\-\-role\fR] [\fB\-\-session\-id\fR] [\fB\-\-review\-outcome\fR] [\fB\-\-reviewer\-provider\fR] [\fB\-\-reviewer\-model\fR] [\fB\-\-reviewer\-harness\fR] [\fB\-\-artifact\fR] [\fB\-\-max\-artifact\-mib\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fICHANGE_ID\fR> 
+\fBcanon review change\fR [\fB\-\-as\fR] [\fB\-\-project\fR] <\fB\-\-actor\fR> [\fB\-\-rev\fR] [\fB\-\-upstream\-ref\fR] [\fB\-\-original\-spec\-ref\fR] [\fB\-\-role\fR] [\fB\-\-session\fR] [\fB\-\-review\-outcome\fR] [\fB\-\-reviewer\-provider\fR] [\fB\-\-reviewer\-model\fR] [\fB\-\-reviewer\-harness\fR] [\fB\-\-artifact\fR] [\fB\-\-max\-artifact\-mib\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fICHANGE_ID\fR> 
 .SH DESCRIPTION
 Write one attributed Review record for a chore change directly to the ledger (exactly one provenance ref required). The review signs the chore\*(Aqs invariants and checks against the diff and pins the change\*(Aqs brief; an edit to the brief stales it. A chore needs exactly this one review before `subject move \-\-to shipped`
 .SH OPTIONS
@@ -26,10 +26,10 @@ reviewer
 orchestrator
 .RE
 .TP
-\fB\-\-project\-id\fR \fI<PROJECT_ID>\fR
+\fB\-\-project\fR \fI<PROJECT_ID>\fR
 Spec corpus id of the scenarios. Required only when canon.yaml configures more than one spec root
 .TP
-\fB\-\-actor\-id\fR \fI<ACTOR_ID>\fR
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR
 The reviewer\*(Aqs id (recorded as the review\*(Aqs author and as its reviewer; line breaks refused)
 .TP
 \fB\-\-rev\fR \fI<REV>\fR [default: HEAD]
@@ -44,7 +44,7 @@ Provenance ref (mutually exclusive with \-\-upstream\-ref; exactly one required)
 \fB\-\-role\fR \fI<ROLE>\fR
 The reviewer\*(Aqs role. Required unless the declared role (\-\-as / CANON_ROLE) is implementer or reviewer, which it then defaults to
 .TP
-\fB\-\-session\-id\fR \fI<SESSION_ID>\fR
+\fB\-\-session\fR \fI<SESSION_ID>\fR
 The reviewing session (recorded as actor.session_id). Under require_review.distinct_actor a review whose session also attested the scenario\*(Aqs evidence does not count
 .TP
 \fB\-\-review\-outcome\fR \fI<REVIEW_OUTCOME>\fR [default: signed]
@@ -95,4 +95,4 @@ Print version
 <\fICHANGE_ID\fR>
 The chore change to review
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-review-scenario.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-review-scenario 1  "scenario 0.30.0" 
+.TH canon-review-scenario 1  "scenario 0.32.0" 
 .SH NAME
 canon\-review\-scenario \- Write one attributed Review record per scenario directly to the ledger, nothing to promote (exactly one provenance ref required). A review pins the scenario\*(Aqs digest and what its latest evidence says (verdict and checks); it counts only while both are unchanged. Each scenario must be indexed, or nothing is written (exit 2)
 .SH SYNOPSIS
-\fBcanon review scenario\fR [\fB\-\-as\fR] [\fB\-\-project\-id\fR] <\fB\-\-actor\-id\fR> [\fB\-\-rev\fR] [\fB\-\-upstream\-ref\fR] [\fB\-\-original\-spec\-ref\fR] [\fB\-\-role\fR] [\fB\-\-session\-id\fR] [\fB\-\-review\-outcome\fR] [\fB\-\-reviewer\-provider\fR] [\fB\-\-reviewer\-model\fR] [\fB\-\-reviewer\-harness\fR] [\fB\-\-artifact\fR] [\fB\-\-max\-artifact\-mib\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fISCENARIO_ID\fR> 
+\fBcanon review scenario\fR [\fB\-\-as\fR] [\fB\-\-project\fR] <\fB\-\-actor\fR> [\fB\-\-rev\fR] [\fB\-\-upstream\-ref\fR] [\fB\-\-original\-spec\-ref\fR] [\fB\-\-role\fR] [\fB\-\-session\fR] [\fB\-\-review\-outcome\fR] [\fB\-\-reviewer\-provider\fR] [\fB\-\-reviewer\-model\fR] [\fB\-\-reviewer\-harness\fR] [\fB\-\-artifact\fR] [\fB\-\-max\-artifact\-mib\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fISCENARIO_ID\fR> 
 .SH DESCRIPTION
 Write one attributed Review record per scenario directly to the ledger, nothing to promote (exactly one provenance ref required). A review pins the scenario\*(Aqs digest and what its latest evidence says (verdict and checks); it counts only while both are unchanged. Each scenario must be indexed, or nothing is written (exit 2)
 .SH OPTIONS
@@ -26,10 +26,10 @@ reviewer
 orchestrator
 .RE
 .TP
-\fB\-\-project\-id\fR \fI<PROJECT_ID>\fR
+\fB\-\-project\fR \fI<PROJECT_ID>\fR
 Spec corpus id of the scenarios. Required only when canon.yaml configures more than one spec root
 .TP
-\fB\-\-actor\-id\fR \fI<ACTOR_ID>\fR
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR
 The reviewer\*(Aqs id (recorded as the review\*(Aqs author and as its reviewer; line breaks refused)
 .TP
 \fB\-\-rev\fR \fI<REV>\fR [default: HEAD]
@@ -44,7 +44,7 @@ Provenance ref (mutually exclusive with \-\-upstream\-ref; exactly one required)
 \fB\-\-role\fR \fI<ROLE>\fR
 The reviewer\*(Aqs role. Required unless the declared role (\-\-as / CANON_ROLE) is implementer or reviewer, which it then defaults to
 .TP
-\fB\-\-session\-id\fR \fI<SESSION_ID>\fR
+\fB\-\-session\fR \fI<SESSION_ID>\fR
 The reviewing session (recorded as actor.session_id). Under require_review.distinct_actor a review whose session also attested the scenario\*(Aqs evidence does not count
 .TP
 \fB\-\-review\-outcome\fR \fI<REVIEW_OUTCOME>\fR [default: signed]
@@ -95,4 +95,4 @@ Print version
 <\fISCENARIO_ID\fR>
 The reviewed scenarios (`<area>.<surface>.<nn>`), one review each, all or nothing. Each must have a record (`canon inventory sync`), or nothing is written (exit 2)
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-review.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-review 1  "review 0.30.0" 
+.TH canon-review 1  "review 0.32.0" 
 .SH NAME
 canon\-review \- Record an attributed review verdict
 .SH SYNOPSIS
@@ -39,4 +39,4 @@ Write one attributed Review record per scenario directly to the ledger, nothing
 canon\-review\-change(1)
 Write one attributed Review record for a chore change directly to the ledger (exactly one provenance ref required). The review signs the chore\*(Aqs invariants and checks against the diff and pins the change\*(Aqs brief; an edit to the brief stales it. A chore needs exactly this one review before `subject move \-\-to shipped`
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-scenario-new.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-scenario-new 1  "new 0.30.0" 
+.TH canon-scenario-new 1  "new 0.32.0" 
 .SH NAME
 canon\-scenario\-new \- Append a tagged scenario stub to its .feature file (created if missing); many at once with `\-\-input`
 .SH SYNOPSIS
-\fBcanon scenario new\fR [\fB\-\-as\fR] <\fB\-\-title\fR> [\fB\-\-subject\-id\fR] [\fB\-\-lane\fR] [\fB\-\-case\fR] [\fB\-\-flow\fR] [\fB\-\-change\-id\fR] [\fB\-\-actor\-id\fR] [\fB\-\-session\-id\fR] [\fB\-\-feature\fR] [\fB\-\-project\-id\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fISCENARIO_ID\fR> 
+\fBcanon scenario new\fR [\fB\-\-as\fR] <\fB\-\-title\fR> [\fB\-\-subject\fR] [\fB\-\-lane\fR] [\fB\-\-case\fR] [\fB\-\-flow\fR] [\fB\-\-change\fR] [\fB\-\-actor\fR] [\fB\-\-session\fR] [\fB\-\-feature\fR] [\fB\-\-project\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fISCENARIO_ID\fR> 
 .SH DESCRIPTION
 Append a tagged scenario stub to its .feature file (created if missing); many at once with `\-\-input`
 .SH OPTIONS
@@ -29,7 +29,7 @@ orchestrator
 \fB\-\-title\fR \fI<TEXT>\fR
 The Scenario: header label
 .TP
-\fB\-\-subject\-id\fR \fI<SUBJECT_ID>\fR
+\fB\-\-subject\fR \fI<SUBJECT_ID>\fR
 Optional subject id tag to pin above the scenario
 .TP
 \fB\-\-lane\fR \fI<NAME>\fR
@@ -39,24 +39,24 @@ Optional lane tag to classify the scenario
 Optional case tag: which path of the behavior this scenario specifies (`happy`, `failure`, `edge` in the base vocabulary)
 .TP
 \fB\-\-flow\fR \fI<FLOW_ID>\fR
-The brief flow step this scenario covers (`F1`): writes `@flow:<change>.<F\-id>`. The change is \-\-change\-id, else the newest change of \-\-subject\-id, else the only live change
+The brief flow step this scenario covers (`F1`): writes `@flow:<change>.<F\-id>`. The change is \-\-change, else the newest change of \-\-subject, else the only live change
 .TP
-\fB\-\-change\-id\fR \fI<CHANGE_ID>\fR
-The change whose brief defines \-\-flow (default: \-\-subject\-id\*(Aqs newest adopted change)
+\fB\-\-change\fR \fI<CHANGE_ID>\fR
+The change whose brief defines \-\-flow (default: \-\-subject\*(Aqs newest adopted change)
 .TP
-\fB\-\-actor\-id\fR \fI<ACTOR_ID>\fR [default: canon\-scaffold]
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR [default: canon\-scaffold]
 Agent id written into provenance (env: CANON_ACTOR)
 .RS
 May also be specified with the \fBCANON_ACTOR\fR environment variable. 
 .RE
 .TP
-\fB\-\-session\-id\fR \fI<SESSION_ID>\fR
+\fB\-\-session\fR \fI<SESSION_ID>\fR
 The acting session (recorded as actor.session_id); optional
 .TP
 \fB\-\-feature\fR \fI<FILE>\fR
 Target .feature file (default: derived from <tag>; must live under a specs.roots[] entry)
 .TP
-\fB\-\-project\-id\fR \fI<PROJECT_ID>\fR
+\fB\-\-project\fR \fI<PROJECT_ID>\fR
 Which configured `specs.roots[]` entry to write under, by its id. Required only when the repo configures more than one
 .TP
 \fB\-\-repo\fR \fI<DIR>\fR
@@ -77,4 +77,4 @@ Print version
 <\fISCENARIO_ID\fR>
 <area>.<surface>.<nn> scenario tag
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-scenario.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-scenario 1  "scenario 0.30.0" 
+.TH canon-scenario 1  "scenario 0.32.0" 
 .SH NAME
 canon\-scenario \- Add a tagged scenario to a .feature spec file
 .SH SYNOPSIS
@@ -36,4 +36,4 @@ Print version
 canon\-scenario\-new(1)
 Append a tagged scenario stub to its .feature file (created if missing); many at once with `\-\-input`
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-schema.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-schema 1  "schema 0.30.0" 
+.TH canon-schema 1  "schema 0.32.0" 
 .SH NAME
 canon\-schema \- Describe canon\*(Aqs own commands: list them, or show one command\*(Aqs arguments, options, effect and exit codes
 .SH SYNOPSIS
@@ -60,4 +60,4 @@ The bare listing is unfiltered: every command. `\-\-as <ROLE>` lists only that r
 CANON_ROLE variable never filters or fails `schema` (an invalid value is a warning in meta.warnings).
 A command whose effect depends on its arguments carries `effectNote`.
 .SH VERSION
-v0.30.0
+v0.32.0