@journeykit/canon 0.30.0 → 0.32.0

package/man/canon-artifacts.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-artifacts 1  "artifacts 0.30.0" 
+.TH canon-artifacts 1  "artifacts 0.32.0" 
 .SH NAME
 canon\-artifacts \- Check or move the evidence artifact store (local, or an object\-store tier)
 .SH SYNOPSIS
@@ -42,4 +42,4 @@ Store the bound files of existing evidence records and current reviews in the ar
 canon\-artifacts\-move(1)
 Move the local artifact blobs to an object\-store tier, verify them, and remove the local copies
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-brief-approve.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-brief-approve 1  "approve 0.30.0" 
+.TH canon-brief-approve 1  "approve 0.32.0" 
 .SH NAME
 canon\-brief\-approve \- Record the human\*(Aqs approval of the brief, bound to its text; refused while `brief check` has blockers
 .SH SYNOPSIS
-\fBcanon brief 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] [\fICHANGE_ID\fR] 
+\fBcanon brief approve\fR <\fB\-\-approver\fR> [\fB\-\-as\fR] <\fB\-\-note\fR> [\fB\-\-relayed\-via\fR] [\fB\-\-actor\fR] [\fB\-\-digest\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
 Record the human\*(Aqs approval of the brief, bound to its text; refused while `brief check` has blockers
 .SH OPTIONS
@@ -32,6 +32,15 @@ orchestrator
 \fB\-\-note\fR \fI<TEXT>\fR
 The human\*(Aqs own words
 .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
+.TP
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR
+With \-\-relayed\-via, the agent\*(Aqs actor id (default: the CANON_ACTOR environment variable)
+.TP
+\fB\-\-digest\fR \fI<DIGEST>\fR
+With \-\-relayed\-via, the digest `canon brief show \-\-body` showed the human, as `<change>=<sha256:digest>`, once per change; a brief whose digest differs is refused
+.TP
 \fB\-\-repo\fR \fI<DIR>\fR
 The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
 .TP
@@ -48,15 +57,18 @@ Print help
 Print version
 .TP
 [\fICHANGE_ID\fR]
-The change to read (default: the repo\*(Aqs only live change)
+The changes to approve, one answer for all, none written unless every one is approvable (default: the repo\*(Aqs only live change)
 .SH EXTRA
 Examples:
   canon brief approve add\-login \-\-approver Ana \-\-note \*(AqGo. Ship the failure flow too.\*(Aq
+  canon brief approve add\-login add\-search fix\-sync \-\-approver Ana \-\-note \*(AqAll three, go.\*(Aq
 
-Writes `Approved: <who> <when> — "<words>" (brief sha256:<digest>)` into the
+Several ids take one name, one answer and one timestamp. Every id is checked
+first; one refused id refuses the call (BRIEF_APPROVE_REFUSED) and nothing is
+written. Writes `Approved: <who> <when> — "<words>" (brief sha256:<digest>)` into the
 brief (the digest covers the brief without its `Approved:` lines) and records
 `canon policy approve` in the same call. Edit the brief afterwards and it reads as
 not approved (BRIEF_CHANGED_SINCE_APPROVAL) until a human answers again and this
 runs again. Run it only from the human\*(Aqs answer, with their words as \-\-note.
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-brief-check.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-brief-check 1  "check 0.30.0" 
+.TH canon-brief-check 1  "check 0.32.0" 
 .SH NAME
 canon\-brief\-check \- Read the brief against the rules: blocker and advisory findings (exit 0 clean, 1 blockers, 2 refused)
 .SH SYNOPSIS
@@ -41,4 +41,4 @@ Print version
 [\fICHANGE_ID\fR]
 The change to read (default: the repo\*(Aqs only live change)
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-brief-show.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-brief-show 1  "show 0.30.0" 
+.TH canon-brief-show 1  "show 0.32.0" 
 .SH NAME
 canon\-brief\-show \- Show where the change stands and the next one to three steps; never edits
 .SH SYNOPSIS
-\fBcanon brief show\fR [\fB\-\-as\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fICHANGE_ID\fR] 
+\fBcanon brief show\fR [\fB\-\-as\fR] [\fB\-\-body\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fICHANGE_ID\fR] 
 .SH DESCRIPTION
 Show where the change stands and the next one to three steps; never edits
 .SH OPTIONS
@@ -26,6 +26,9 @@ reviewer
 orchestrator
 .RE
 .TP
+\fB\-\-body\fR
+Print the brief file\*(Aqs bytes as they are, then a last line with the approval digest `brief approve` would record (with \-\-json: `body` and `digest` fields); what a human is shown before they answer
+.TP
 \fB\-\-repo\fR \fI<DIR>\fR
 The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
 .TP
@@ -47,4 +50,4 @@ Examples:
 
 The operand names the change; without it the repo\*(Aqs only live change is read.
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-brief.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-brief 1  "brief 0.30.0" 
+.TH canon-brief 1  "brief 0.32.0" 
 .SH NAME
 canon\-brief \- Check a change\*(Aqs brief (PRD format) and see the next steps; never edits
 .SH SYNOPSIS
@@ -48,16 +48,17 @@ Examples:
   canon brief check add\-login \-\-json
 
 The brief is the PRD `canon change new` writes: sections are found by their
-`<!\-\- canon:section <key> role=… \-\->` marker, never by heading text. Blockers
+English `##` heading (Intent, Desired outcome, …), never by a comment. Blockers
 (structure) are a missing or out\-of\-order section, a duplicate flow id, step
 detail that does not match the flow ids, leftover placeholders, and, once the
 subject is building, a flow step with no scenario or no failure scenario.
 Advisories (prose) apply to normative sections, Intent and Questions, in the
 language each is written in (`language:` in canon.yaml overrides); only en and
 ko have rule lists.
-Waive one rule in one section with
-  <!\-\- canon:waive <rule\-id> <section\-key> "<reason>" \-\->
-A brief without markers (written before 0.19) checks as `brief.legacy`, an
-advisory. Without \-\-change\-id, the repo\*(Aqs only live change is checked.
+Waive one rule in one section with an entry of the frontmatter `waive` list
+(`rule`, `section`, `reason`, optional `match`). A brief in the 0.30 format
+gets one blocker, `brief.old\-format`: `canon migrate` rewrites it. A brief
+with fewer than two known headings (written before 0.19) checks as `brief.legacy`, an
+advisory. Without \-\-change, the repo\*(Aqs only live change is checked.
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-change-new.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-change-new 1  "new 0.30.0" 
+.TH canon-change-new 1  "new 0.32.0" 
 .SH NAME
 canon\-change\-new \- Write .canon/changes/<slug>/brief.md, import it, and adopt it into a subject
 .SH SYNOPSIS
-\fBcanon change new\fR [\fB\-\-as\fR] <\fB\-\-subject\-id\fR> [\fB\-\-change\-kind\fR] <\fB\-\-title\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 change new\fR [\fB\-\-as\fR] <\fB\-\-subject\fR> [\fB\-\-change\-kind\fR] <\fB\-\-title\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 .canon/changes/<slug>/brief.md, import it, and adopt it into a subject
 .SH OPTIONS
@@ -26,7 +26,7 @@ reviewer
 orchestrator
 .RE
 .TP
-\fB\-\-subject\-id\fR \fI<SUBJECT_ID>\fR
+\fB\-\-subject\fR \fI<SUBJECT_ID>\fR
 The existing subject to adopt the change under
 .TP
 \fB\-\-change\-kind\fR \fI<CHANGE_KIND>\fR [default: feature]
@@ -63,4 +63,4 @@ Print version
 <\fICHANGE_ID\fR>
 The change\*(Aqs slug (its change_id)
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-change.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-change 1  "change 0.30.0" 
+.TH canon-change 1  "change 0.32.0" 
 .SH NAME
 canon\-change \- Write a plan change (.canon/changes/<slug>/brief.md) and adopt it into a subject
 .SH SYNOPSIS
@@ -37,6 +37,6 @@ canon\-change\-new(1)
 Write .canon/changes/<slug>/brief.md, import it, and adopt it into a subject
 .SH EXTRA
 Examples:
-  canon change new add\-login \-\-subject\-id auth \-\-title \*(AqAdd login\*(Aq
+  canon change new add\-login \-\-subject auth \-\-title \*(AqAdd login\*(Aq
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-completion.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-completion 1  "completion 0.30.0" 
+.TH canon-completion 1  "completion 0.32.0" 
 .SH NAME
 canon\-completion \- Write the shell completion script for canon (bash, zsh or fish)
 .SH SYNOPSIS
@@ -57,4 +57,4 @@ Examples:
 
 The script is generated from the command tree, so it completes exactly what the parser accepts. It needs no repo and no network.
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-context-pack-add.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-context-pack-add 1  "add 0.30.0" 
+.TH canon-context-pack-add 1  "add 0.32.0" 
 .SH NAME
 canon\-context\-pack\-add \- Create an immutable context pack from a repository\-local JSON manifest
 .SH SYNOPSIS
@@ -44,4 +44,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-context-pack-show.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-context-pack-show 1  "show 0.30.0" 
+.TH canon-context-pack-show 1  "show 0.32.0" 
 .SH NAME
 canon\-context\-pack\-show \- Show a context pack after verifying its manifest and content objects
 .SH SYNOPSIS
@@ -41,4 +41,4 @@ Print version
 <\fIPACK_ID\fR>
 Context pack id (sha256:<64 hex digits>)
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-context-pack-verify.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-context-pack-verify 1  "verify 0.30.0" 
+.TH canon-context-pack-verify 1  "verify 0.32.0" 
 .SH NAME
 canon\-context\-pack\-verify \- Verify a context pack\*(Aqs manifest and immutable content objects
 .SH SYNOPSIS
@@ -41,4 +41,4 @@ Print version
 <\fIPACK_ID\fR>
 Context pack id (sha256:<64 hex digits>)
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-context-pack.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-context-pack 1  "context-pack 0.30.0" 
+.TH canon-context-pack 1  "context-pack 0.32.0" 
 .SH NAME
 canon\-context\-pack \- Create, inspect, and verify reproducible context packs
 .SH SYNOPSIS
@@ -47,4 +47,4 @@ Examples:
   canon context\-pack show sha256:<pack\-digest> \-\-repo . \-\-json
   canon context\-pack verify sha256:<pack\-digest>
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-context.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-context 1  "context 0.30.0" 
+.TH canon-context 1  "context 0.32.0" 
 .SH NAME
 canon\-context \- Show what you can author here: record kinds, fields, enums, policies
 .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-dashboard.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-dashboard 1  "dashboard 0.30.0" 
+.TH canon-dashboard 1  "dashboard 0.32.0" 
 .SH NAME
 canon\-dashboard \- Serve the local status dashboard
 .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-demo-init.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-demo-init 1  "init 0.30.0" 
+.TH canon-demo-init 1  "init 0.32.0" 
 .SH NAME
 canon\-demo\-init \- Scaffold the demo repo (gate starts RED)
 .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-demo-review.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-demo-review 1  "review 0.30.0" 
+.TH canon-demo-review 1  "review 0.32.0" 
 .SH NAME
 canon\-demo\-review \- Record the missing reviewer evidence (gate turns GREEN)
 .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-demo.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-demo 1  "demo 0.30.0" 
+.TH canon-demo 1  "demo 0.32.0" 
 .SH NAME
 canon\-demo \- Try the evidence loop end\-to\-end in a throwaway demo repo
 .SH SYNOPSIS
@@ -44,4 +44,4 @@ Examples:
   canon gate check   # RED
   canon demo review && canon gate check   # GREEN
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-dispatch-begin.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-dispatch-begin 1  "begin 0.30.0" 
+.TH canon-dispatch-begin 1  "begin 0.32.0" 
 .SH NAME
 canon\-dispatch\-begin \- Mint a Run manifest with retrieved guidance and context/policy lineage
 .SH SYNOPSIS
-\fBcanon dispatch begin\fR [\fB\-\-as\fR] [\fB\-\-role\fR] <\fB\-\-regime\fR> [\fB\-\-actor\-id\fR] [\fB\-\-session\-id\fR] [\fB\-\-provider\fR] [\fB\-\-model\fR] [\fB\-\-skill\-id\fR] [\fB\-\-skill\-digest\fR] [\fB\-\-manifest\fR] [\fB\-\-prompt\-bundle\fR] [\fB\-\-task\-id\fR] [\fB\-\-parent\-run\-id\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] 
+\fBcanon dispatch begin\fR [\fB\-\-as\fR] [\fB\-\-role\fR] <\fB\-\-regime\fR> [\fB\-\-actor\fR] [\fB\-\-session\fR] [\fB\-\-provider\fR] [\fB\-\-model\fR] [\fB\-\-skill\fR] [\fB\-\-skill\-digest\fR] [\fB\-\-manifest\fR] [\fB\-\-prompt\-bundle\fR] [\fB\-\-task\fR] [\fB\-\-parent\-run\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] 
 .SH DESCRIPTION
 Mint a Run manifest with retrieved guidance and context/policy lineage
 .SH OPTIONS
@@ -32,23 +32,23 @@ Role about to run; must equal \-\-regime\*(Aqs leading segment
 \fB\-\-regime\fR \fI<KEY>\fR
 Full regime key (<role>/<repo>/<area>/<hash>) to retrieve guidance for
 .TP
-\fB\-\-actor\-id\fR \fI<ACTOR_ID>\fR [default: canon]
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR [default: canon]
 The dispatching agent\*(Aqs id (recorded as the run\*(Aqs actor)
 .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\-\-provider\fR \fI<NAME>\fR
-Declared provider metadata (copied verbatim; never inferred from \-\-actor\-id)
+Declared provider metadata (copied verbatim; never inferred from \-\-actor)
 .TP
 \fB\-\-model\fR \fI<NAME>\fR
 Declared model metadata (copied verbatim)
 .TP
-\fB\-\-skill\-id\fR \fI<ID>\fR
+\fB\-\-skill\fR \fI<ID>\fR
 Skill that contributed to this run
 .TP
 \fB\-\-skill\-digest\fR \fI<DIGEST>\fR
-Declared skill digest; requires \-\-skill\-id
+Declared skill digest; requires \-\-skill
 .TP
 \fB\-\-manifest\fR \fI<FILE>\fR
 Explicit repository\-relative ContextPack input manifest
@@ -56,10 +56,10 @@ Explicit repository\-relative ContextPack input manifest
 \fB\-\-prompt\-bundle\fR \fI<NAME@VERSION>\fR
 Registered prompt bundle to select (`name@version`)
 .TP
-\fB\-\-task\-id\fR \fI<TASK_ID>\fR
+\fB\-\-task\fR \fI<TASK_ID>\fR
 Plan task this run serves (<change_id>#<n>); validated against the plan corpus
 .TP
-\fB\-\-parent\-run\-id\fR \fI<RUN_ID>\fR
+\fB\-\-parent\-run\fR \fI<RUN_ID>\fR
 RunId (ULID) of the run that dispatched this one
 .TP
 \fB\-\-repo\fR \fI<DIR>\fR
@@ -77,4 +77,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-dispatch-diff.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-dispatch-diff 1  "diff 0.30.0" 
+.TH canon-dispatch-diff 1  "diff 0.32.0" 
 .SH NAME
 canon\-dispatch\-diff \- Diff the declared plan DAG against the observed execution graph
 .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-dispatch-end.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-dispatch-end 1  "end 0.30.0" 
+.TH canon-dispatch-end 1  "end 0.32.0" 
 .SH NAME
 canon\-dispatch\-end \- Close a dispatched run with a terminal status and an ended_at
 .SH SYNOPSIS
@@ -57,4 +57,4 @@ Print version
 <\fIRUN_ID\fR>
 The RunId (ULID) minted by `canon dispatch begin`
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-dispatch.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-dispatch 1  "dispatch 0.30.0" 
+.TH canon-dispatch 1  "dispatch 0.32.0" 
 .SH NAME
 canon\-dispatch \- Begin an agent run with retrieved guidance recorded
 .SH SYNOPSIS
@@ -42,4 +42,4 @@ Close a dispatched run with a terminal status and an ended_at
 canon\-dispatch\-diff(1)
 Diff the declared plan DAG against the observed execution graph
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-divergence-accept.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-divergence-accept 1  "accept 0.30.0" 
+.TH canon-divergence-accept 1  "accept 0.32.0" 
 .SH NAME
 canon\-divergence\-accept \- Accept a divergent scenario as a tracked known gap (a reviewer step): its latest evidence must be divergent and not the accepting actor\*(Aqs or session\*(Aqs. The acceptance pins that evidence, so new evidence ends it, and lapses at \-\-expiry; until then the ship guard counts the cell as covered while `status` and `gate check` list it as `accepted\-divergence`
 .SH SYNOPSIS
-\fBcanon divergence accept\fR [\fB\-\-as\fR] [\fB\-\-project\-id\fR] <\fB\-\-reason\fR> <\fB\-\-tracking\fR> [\fB\-\-expiry\fR] <\fB\-\-actor\-id\fR> [\fB\-\-role\fR] [\fB\-\-session\-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 divergence accept\fR [\fB\-\-as\fR] [\fB\-\-project\fR] <\fB\-\-reason\fR> <\fB\-\-tracking\fR> [\fB\-\-expiry\fR] <\fB\-\-actor\fR> [\fB\-\-role\fR] [\fB\-\-session\fR] [\fB\-\-relayed\-via\fR] [\fB\-\-approver\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] <\fISCENARIO_ID\fR> 
 .SH DESCRIPTION
 Accept a divergent scenario as a tracked known gap (a reviewer step): its latest evidence must be divergent and not the accepting actor\*(Aqs or session\*(Aqs. The acceptance pins that evidence, so new evidence ends it, and lapses at \-\-expiry; until then the ship guard counts the cell as covered while `status` and `gate check` list it as `accepted\-divergence`
 .SH OPTIONS
@@ -26,7 +26,7 @@ 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\-\-reason\fR \fI<TEXT>\fR
@@ -38,15 +38,24 @@ Where the gap is tracked: an issue URL or reference
 \fB\-\-expiry\fR \fI<TIMESTAMP>\fR
 The date (YYYY\-MM\-DD, UTC) the acceptance stops holding; none means it holds until new evidence
 .TP
-\fB\-\-actor\-id\fR \fI<ACTOR_ID>\fR
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR
 The reviewer recording this (recorded as the divergence\*(Aqs reviewer and actor)
 .TP
 \fB\-\-role\fR \fI<ROLE>\fR
 Must be reviewer (default: the declared role, \-\-as / CANON_ROLE; required when none is declared)
 .TP
-\fB\-\-session\-id\fR \fI<SESSION_ID>\fR
+\fB\-\-session\fR \fI<SESSION_ID>\fR
 The accepting session (recorded as actor.session_id); it must not be one that attested the scenario\*(Aqs evidence
 .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 \-\-approver and \-\-note are required
+.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\-\-repo\fR \fI<DIR>\fR
 The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
 .TP
@@ -65,4 +74,4 @@ Print version
 <\fISCENARIO_ID\fR>
 The accepted scenarios (`<area>.<surface>.<nn>`), one acceptance each, all or nothing
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-divergence-add.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-divergence-add 1  "add 0.30.0" 
+.TH canon-divergence-add 1  "add 0.32.0" 
 .SH NAME
 canon\-divergence\-add \- Add a divergence candidate, staged with no run_seq yet (commit it with `canon gate promote \-\-kind divergence`, or in the same run with \-\-promote / `write: { promote: auto }`)
 .SH SYNOPSIS
-\fBcanon divergence add\fR [\fB\-\-as\fR] [\fB\-\-project\-id\fR] [\fB\-\-rev\fR] [\fB\-\-state\fR] [\fB\-\-reason\fR] [\fB\-\-expiry\fR] [\fB\-\-round\fR] <\fB\-\-actor\-id\fR> [\fB\-\-session\-id\fR] [\fB\-\-detail\fR] [\fB\-\-role\fR] [\fB\-\-promote\fR] [\fB\-\-no\-promote\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 divergence add\fR [\fB\-\-as\fR] [\fB\-\-project\fR] [\fB\-\-rev\fR] [\fB\-\-state\fR] [\fB\-\-reason\fR] [\fB\-\-expiry\fR] [\fB\-\-round\fR] <\fB\-\-actor\fR> [\fB\-\-session\fR] [\fB\-\-detail\fR] [\fB\-\-role\fR] [\fB\-\-promote\fR] [\fB\-\-no\-promote\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
 Add a divergence candidate, staged with no run_seq yet (commit it with `canon gate promote \-\-kind divergence`, or in the same run with \-\-promote / `write: { promote: auto }`)
 .SH OPTIONS
@@ -26,7 +26,7 @@ reviewer
 orchestrator
 .RE
 .TP
-\fB\-\-project\-id\fR \fI<PROJECT_ID>\fR
+\fB\-\-project\fR \fI<PROJECT_ID>\fR
 Spec corpus id of the scenario. Required only when canon.yaml configures more than one spec root
 .TP
 \fB\-\-rev\fR \fI<REV>\fR [default: HEAD]
@@ -58,10 +58,10 @@ When a deferral lapses (RFC3339 or YYYY\-MM\-DD, UTC); required with `\-\-state
 \fB\-\-round\fR \fI<N>\fR [default: 1]
 The review round this version belongs to (1\-based)
 .TP
-\fB\-\-actor\-id\fR \fI<ACTOR_ID>\fR
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR
 The reviewer recording this (recorded as the divergence\*(Aqs reviewer and actor)
 .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\-\-detail\fR \fI<TEXT>\fR
@@ -94,4 +94,4 @@ Print version
 <\fISCENARIO_ID\fR>
 The scenario (`<area>.<surface>.<nn>`)
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-divergence-defer.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-divergence-defer 1  "defer 0.30.0" 
+.TH canon-divergence-defer 1  "defer 0.32.0" 
 .SH NAME
 canon\-divergence\-defer \- Directly record a deferred divergence (requires \-\-reason/\-\-expiry)
 .SH SYNOPSIS
-\fBcanon divergence defer\fR [\fB\-\-as\fR] [\fB\-\-project\-id\fR] [\fB\-\-rev\fR] [\fB\-\-round\fR] <\fB\-\-actor\-id\fR> [\fB\-\-session\-id\fR] <\fB\-\-reason\fR> <\fB\-\-expiry\fR> [\fB\-\-role\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 divergence defer\fR [\fB\-\-as\fR] [\fB\-\-project\fR] [\fB\-\-rev\fR] [\fB\-\-round\fR] <\fB\-\-actor\fR> [\fB\-\-session\fR] <\fB\-\-reason\fR> <\fB\-\-expiry\fR> [\fB\-\-role\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
 Directly record a deferred divergence (requires \-\-reason/\-\-expiry)
 .SH OPTIONS
@@ -26,7 +26,7 @@ reviewer
 orchestrator
 .RE
 .TP
-\fB\-\-project\-id\fR \fI<PROJECT_ID>\fR
+\fB\-\-project\fR \fI<PROJECT_ID>\fR
 Spec corpus id of the scenario. Required only when canon.yaml configures more than one spec root
 .TP
 \fB\-\-rev\fR \fI<REV>\fR [default: HEAD]
@@ -35,10 +35,10 @@ The commit this record is about: any git revision (`HEAD~1`, a branch, a tag, a
 \fB\-\-round\fR \fI<N>\fR [default: 1]
 The review round this version belongs to (1\-based)
 .TP
-\fB\-\-actor\-id\fR \fI<ACTOR_ID>\fR
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR
 The reviewer recording this (recorded as the divergence\*(Aqs reviewer and actor)
 .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\-\-reason\fR \fI<TEXT>\fR
@@ -68,4 +68,4 @@ Print version
 <\fISCENARIO_ID\fR>
 The scenario (`<area>.<surface>.<nn>`)
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-divergence-list.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-divergence-list 1  "list 0.30.0" 
+.TH canon-divergence-list 1  "list 0.32.0" 
 .SH NAME
 canon\-divergence\-list \- List the current divergence burn\-down state
 .SH SYNOPSIS
@@ -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-divergence-resolve.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-divergence-resolve 1  "resolve 0.30.0" 
+.TH canon-divergence-resolve 1  "resolve 0.32.0" 
 .SH NAME
 canon\-divergence\-resolve \- Directly record a resolved divergence
 .SH SYNOPSIS
-\fBcanon divergence resolve\fR [\fB\-\-as\fR] [\fB\-\-project\-id\fR] [\fB\-\-rev\fR] [\fB\-\-round\fR] <\fB\-\-actor\-id\fR> [\fB\-\-session\-id\fR] [\fB\-\-detail\fR] [\fB\-\-role\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 divergence resolve\fR [\fB\-\-as\fR] [\fB\-\-project\fR] [\fB\-\-rev\fR] [\fB\-\-round\fR] <\fB\-\-actor\fR> [\fB\-\-session\fR] [\fB\-\-detail\fR] [\fB\-\-role\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
 Directly record a resolved divergence
 .SH OPTIONS
@@ -26,7 +26,7 @@ reviewer
 orchestrator
 .RE
 .TP
-\fB\-\-project\-id\fR \fI<PROJECT_ID>\fR
+\fB\-\-project\fR \fI<PROJECT_ID>\fR
 Spec corpus id of the scenario. Required only when canon.yaml configures more than one spec root
 .TP
 \fB\-\-rev\fR \fI<REV>\fR [default: HEAD]
@@ -35,10 +35,10 @@ The commit this record is about: any git revision (`HEAD~1`, a branch, a tag, a
 \fB\-\-round\fR \fI<N>\fR [default: 1]
 The review round this version belongs to (1\-based)
 .TP
-\fB\-\-actor\-id\fR \fI<ACTOR_ID>\fR
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR
 The reviewer recording this (recorded as the divergence\*(Aqs reviewer and actor)
 .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\-\-detail\fR \fI<TEXT>\fR
@@ -65,4 +65,4 @@ Print version
 <\fISCENARIO_ID\fR>
 The scenario (`<area>.<surface>.<nn>`)
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-divergence.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-divergence 1  "divergence 0.30.0" 
+.TH canon-divergence 1  "divergence 0.32.0" 
 .SH NAME
 canon\-divergence \- Stage, promote, resolve, and inspect spec divergences
 .SH SYNOPSIS
@@ -48,4 +48,4 @@ Accept a divergent scenario as a tracked known gap (a reviewer step): its latest
 canon\-divergence\-list(1)
 List the current divergence burn\-down state
 .SH VERSION
-v0.30.0
+v0.32.0