@journeykit/canon 0.33.0 → 0.34.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.33.0" 
+.TH canon-dashboard 1  "dashboard 0.34.0" 
 .SH NAME
 canon\-dashboard \- Serve the local status dashboard
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Serve the local status dashboard
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -47,4 +47,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.33.0
+v0.34.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.33.0" 
+.TH canon-demo-init 1  "init 0.34.0" 
 .SH NAME
 canon\-demo\-init \- Scaffold the demo repo (gate starts RED)
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Scaffold the demo repo (gate starts RED)
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -41,4 +41,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.33.0
+v0.34.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.33.0" 
+.TH canon-demo-review 1  "review 0.34.0" 
 .SH NAME
 canon\-demo\-review \- Record the missing reviewer evidence (gate turns GREEN)
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Record the missing reviewer evidence (gate turns GREEN)
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -41,4 +41,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.33.0
+v0.34.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.33.0" 
+.TH canon-demo 1  "demo 0.34.0" 
 .SH NAME
 canon\-demo \- Try the evidence loop end\-to\-end in a throwaway demo repo
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Try the evidence loop end\-to\-end in a throwaway demo repo
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -44,4 +44,4 @@ Examples:
   canon gate check   # RED
   canon demo review && canon gate check   # GREEN
 .SH VERSION
-v0.33.0
+v0.34.0

package/man/canon-dispatch-begin.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-dispatch-begin 1  "begin 0.33.0" 
+.TH canon-dispatch-begin 1  "begin 0.34.0" 
 .SH NAME
 canon\-dispatch\-begin \- Mint a Run manifest with retrieved guidance and context/policy lineage
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Mint a Run manifest with retrieved guidance and context/policy lineage
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -77,4 +77,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.33.0
+v0.34.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.33.0" 
+.TH canon-dispatch-diff 1  "diff 0.34.0" 
 .SH NAME
 canon\-dispatch\-diff \- Diff the declared plan DAG against the observed execution graph
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Diff the declared plan DAG against the observed execution graph
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -38,4 +38,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.33.0
+v0.34.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.33.0" 
+.TH canon-dispatch-end 1  "end 0.34.0" 
 .SH NAME
 canon\-dispatch\-end \- Close a dispatched run with a terminal status and an ended_at
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Close a dispatched run with a terminal status and an ended_at
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -57,4 +57,4 @@ Print version
 <\fIRUN_ID\fR>
 The RunId (ULID) minted by `canon dispatch begin`
 .SH VERSION
-v0.33.0
+v0.34.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.33.0" 
+.TH canon-dispatch 1  "dispatch 0.34.0" 
 .SH NAME
 canon\-dispatch \- Begin an agent run with retrieved guidance recorded
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Begin an agent run with retrieved guidance recorded
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -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.33.0
+v0.34.0

package/man/canon-divergence-accept.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-divergence-accept 1  "accept 0.33.0" 
+.TH canon-divergence-accept 1  "accept 0.34.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
@@ -10,7 +10,7 @@ Accept a divergent scenario as a tracked known gap (a reviewer step): its latest
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -74,4 +74,4 @@ Print version
 <\fISCENARIO_ID\fR>
 The accepted scenarios (`<area>.<surface>.<nn>`), one acceptance each, all or nothing
 .SH VERSION
-v0.33.0
+v0.34.0

package/man/canon-divergence-add.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-divergence-add 1  "add 0.33.0" 
+.TH canon-divergence-add 1  "add 0.34.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
@@ -10,7 +10,7 @@ Add a divergence candidate, staged with no run_seq yet (commit it with `canon ga
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -94,4 +94,4 @@ Print version
 <\fISCENARIO_ID\fR>
 The scenario (`<area>.<surface>.<nn>`)
 .SH VERSION
-v0.33.0
+v0.34.0

package/man/canon-divergence-defer.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-divergence-defer 1  "defer 0.33.0" 
+.TH canon-divergence-defer 1  "defer 0.34.0" 
 .SH NAME
 canon\-divergence\-defer \- Directly record a deferred divergence (requires \-\-reason/\-\-expiry)
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Directly record a deferred divergence (requires \-\-reason/\-\-expiry)
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -68,4 +68,4 @@ Print version
 <\fISCENARIO_ID\fR>
 The scenario (`<area>.<surface>.<nn>`)
 .SH VERSION
-v0.33.0
+v0.34.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.33.0" 
+.TH canon-divergence-list 1  "list 0.34.0" 
 .SH NAME
 canon\-divergence\-list \- List the current divergence burn\-down state
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ List the current divergence burn\-down state
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -35,8 +35,8 @@ Governs Deferred expiry; defaults to now
 \fB\-\-json\fR
 Print `{data, meta}` as JSON
 .TP
-\fB\-\-limit\fR \fI<N>\fR
-Return at most this many records (default 100)
+\fB\-\-limit\fR \fI<N>\fR [default: 100]
+Return at most this many records per page
 .TP
 \fB\-\-cursor\fR \fI<CURSOR>\fR
 Resume after the last record of the previous page (the `nextCursor` it reported)
@@ -45,7 +45,7 @@ Resume after the last record of the previous page (the `nextCursor` it reported)
 Return every record from the cursor on, not one page
 .TP
 \fB\-\-fields\fR \fI<FIELDS>\fR
-With \-\-json, keep only these scenario fields (comma\-separated): project_id, scenario_id, state, reason, expiry, tracking; an unknown field is refused (camelCase and snake_case both match)
+With \-\-json, keep only these members of each scenario (comma\-separated field paths: state, reason, expiry, tracking; projectId and scenarioId are always kept)
 .TP
 \fB\-h\fR, \fB\-\-help\fR
 Print help
@@ -53,4 +53,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.33.0
+v0.34.0

package/man/canon-divergence-resolve.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-divergence-resolve 1  "resolve 0.33.0" 
+.TH canon-divergence-resolve 1  "resolve 0.34.0" 
 .SH NAME
 canon\-divergence\-resolve \- Directly record a resolved divergence
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Directly record a resolved divergence
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -65,4 +65,4 @@ Print version
 <\fISCENARIO_ID\fR>
 The scenario (`<area>.<surface>.<nn>`)
 .SH VERSION
-v0.33.0
+v0.34.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.33.0" 
+.TH canon-divergence 1  "divergence 0.34.0" 
 .SH NAME
 canon\-divergence \- Stage, promote, resolve, and inspect spec divergences
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Stage, promote, resolve, and inspect spec divergences
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -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.33.0
+v0.34.0

package/man/canon-evidence-add.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-evidence-add 1  "add 0.33.0" 
+.TH canon-evidence-add 1  "add 0.34.0" 
 .SH NAME
 canon\-evidence\-add \- Record one attributed EvidenceRecord for a task or scenario (promoted in the same run under `write: { promote: auto }` or with \-\-promote; under `write.promote: manual`, commit it with `canon gate promote`)
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Record one attributed EvidenceRecord for a task or scenario (promoted in the sam
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -165,4 +165,4 @@ While a subject this record attests for (the scenario\*(Aqs @subject owner, or a
 AUDITS.
 An external evaluator\*(Aqs re\-audit is `canon evidence audit <SCENARIO_ID>`, not `\-\-kind audit`.
 .SH VERSION
-v0.33.0
+v0.34.0

package/man/canon-evidence-approval-payload.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-evidence-approval-payload 1  "approval-payload 0.33.0" 
+.TH canon-evidence-approval-payload 1  "approval-payload 0.34.0" 
 .SH NAME
 canon\-evidence\-approval\-payload \- Emit exact bytes for external `ssh\-keygen \-Y sign \-n canon\-approval\-v1`
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Emit exact bytes for external `ssh\-keygen \-Y sign \-n canon\-approval\-v1`
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -62,4 +62,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.33.0
+v0.34.0

package/man/canon-evidence-audit.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-evidence-audit 1  "audit 0.33.0" 
+.TH canon-evidence-audit 1  "audit 0.34.0" 
 .SH NAME
 canon\-evidence\-audit \- Record an external evaluator\*(Aqs re\-audit of one scenario (class `audit`; the verdict follows \-\-audit\-result; canon never runs the evaluator)
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Record an external evaluator\*(Aqs re\-audit of one scenario (class `audit`; the
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -118,4 +118,4 @@ The re\-audited scenario (`<area>.<surface>.<nn>`)
 .SH EXTRA
 Records an external evaluator\*(Aqs re\-audit of one scenario: \-\-evaluator, \-\-evaluator\-version, \-\-evaluator\-digest <sha256>, \-\-audit\-result confirmed|refuted|indeterminate, and optional \-\-report/\-\-artifact counterexamples, bound and stored like any report. canon never generates or runs the audit. An audit never becomes the scenario\*(Aqs declared verdict; a refuted latest audit is false\-success in canon gate check, whatever the declared verdict says.
 .SH VERSION
-v0.33.0
+v0.34.0

package/man/canon-evidence.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-evidence 1  "evidence 0.33.0" 
+.TH canon-evidence 1  "evidence 0.34.0" 
 .SH NAME
 canon\-evidence \- Author a staged, attributed evidence attestation for a plan task
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Author a staged, attributed evidence attestation for a plan task
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -54,4 +54,4 @@ each add to commit it (assigns run_seq).
 
 See `canon evidence add \-\-help` for exactly what the gate does and does not check.
 .SH VERSION
-v0.33.0
+v0.34.0

package/man/canon-export.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-export 1  "export 0.33.0" 
+.TH canon-export 1  "export 0.34.0" 
 .SH NAME
 canon\-export \- Export a redacted retention manifest without deleting records
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Export a redacted retention manifest without deleting records
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -81,8 +81,8 @@ Output JSON instead of the human\-readable form
 \fB\-\-include\-sensitive\fR
 Include records marked sensitive (only when policy explicitly allows it)
 .TP
-\fB\-\-limit\fR \fI<N>\fR
-Return at most this many records (default 100)
+\fB\-\-limit\fR \fI<N>\fR [default: 100]
+Return at most this many records per page
 .TP
 \fB\-\-cursor\fR \fI<CURSOR>\fR
 Resume after the last record of the previous page (the `nextCursor` it reported)
@@ -91,7 +91,7 @@ Resume after the last record of the previous page (the `nextCursor` it reported)
 Return every record from the cursor on, not one page
 .TP
 \fB\-\-fields\fR \fI<FIELDS>\fR
-Keep only these fields of each exported record (comma\-separated): kind, at, id, digest; an unknown field is refused (camelCase and snake_case both match)
+Keep only these members of the answer this call prints (comma\-separated field paths): of each exported record in the manifest, of the written answer with \-\-json and \-\-output, of the preview with \-\-dry\-run; `canon schema export \-\-json` lists the paths per output
 .TP
 \fB\-\-dry\-run\fR
 Validate fully and report what would be written, without writing anything
@@ -105,4 +105,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.33.0
+v0.34.0

package/man/canon-feature-new.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-feature-new 1  "new 0.33.0" 
+.TH canon-feature-new 1  "new 0.34.0" 
 .SH NAME
 canon\-feature\-new \- Create a fresh .feature file for a new area.surface
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Create a fresh .feature file for a new area.surface
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -59,4 +59,4 @@ Print version
 <\fISURFACE\fR>
 <area>.<surface> the fresh .feature file scaffolds
 .SH VERSION
-v0.33.0
+v0.34.0

package/man/canon-feature.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-feature 1  "feature 0.33.0" 
+.TH canon-feature 1  "feature 0.34.0" 
 .SH NAME
 canon\-feature \- Scaffold a new .feature spec file
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Scaffold a new .feature spec file
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -36,4 +36,4 @@ Print version
 canon\-feature\-new(1)
 Create a fresh .feature file for a new area.surface
 .SH VERSION
-v0.33.0
+v0.34.0

package/man/canon-finding-add.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-finding-add 1  "add 0.33.0" 
+.TH canon-finding-add 1  "add 0.34.0" 
 .SH NAME
 canon\-finding\-add \- Record one code\-review finding (promoted in the same run under `write: { promote: auto }` or with \-\-promote; under `write.promote: manual`, commit it with `canon gate promote`)
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Record one code\-review finding (promoted in the same run under `write: { promot
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -80,7 +80,7 @@ The commit this record is about: any git revision (`HEAD~1`, a branch, a tag, a
 The commit that closed it, any git revision (resolved to the full sha, with the code tree it saw). Permitted only with \-\-disposition fixed, where it defaults to HEAD. Existence only; canon never reads the commit\*(Aqs message or diff
 .TP
 \fB\-\-introduced\-rev\fR \fI<REV>\fR
-The SOURCED introducing commit, any git revision (resolved to the full sha). No default: leave it unset when it is not known, never guess (see \-\-help). Existence only; canon never reads the commit\*(Aqs message or diff
+The SOURCED introducing commit, any git revision (resolved to the full sha). Leave it unset when it is not known, never guess (see \-\-help). Existence only; canon never reads the commit\*(Aqs message or diff
 .TP
 \fB\-\-introduced\-unknown\fR
 Say the introducing commit is not known, instead of \-\-introduced\-rev. A new blocker or should\-fix needs one of the two; a note needs neither. Stored in its own field, never in the commit slot
@@ -205,4 +205,4 @@ The loop:
 Under `write.promote: manual` (no `write:` key), run `canon gate promote` to
 commit it.
 .SH VERSION
-v0.33.0
+v0.34.0

package/man/canon-finding-close.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-finding-close 1  "close 0.33.0" 
+.TH canon-finding-close 1  "close 0.34.0" 
 .SH NAME
 canon\-finding\-close \- Move an already\-committed finding\*(Aqs disposition (promoted in the same run under `write: { promote: auto }` or with \-\-promote; under `write.promote: manual`, commit it with `canon gate promote`)
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Move an already\-committed finding\*(Aqs disposition (promoted in the same run u
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -114,4 +114,4 @@ Examples:
   canon finding close s44\-spec\-derived\-worklist \-\-round 1 \-\-seq 9 \\
       \-\-disposition rejected \-\-reason "not a defect"
 .SH VERSION
-v0.33.0
+v0.34.0

package/man/canon-finding-list.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-finding-list 1  "list 0.33.0" 
+.TH canon-finding-list 1  "list 0.34.0" 
 .SH NAME
 canon\-finding\-list \- List a change\*(Aqs committed findings at their latest version: round, seq, severity, disposition, reviewer and summary
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ List a change\*(Aqs committed findings at their latest version: round, seq, seve
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
-The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
+The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
 .br
 
 .br
@@ -38,8 +38,8 @@ Print `{change_id, findings: [...], meta}` as JSON
 \fB\-\-repo\fR \fI<DIR>\fR
 The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
 .TP
-\fB\-\-limit\fR \fI<N>\fR
-Return at most this many records (default 100)
+\fB\-\-limit\fR \fI<N>\fR [default: 100]
+Return at most this many records per page
 .TP
 \fB\-\-cursor\fR \fI<CURSOR>\fR
 Resume after the last record of the previous page (the `nextCursor` it reported)
@@ -48,7 +48,7 @@ Resume after the last record of the previous page (the `nextCursor` it reported)
 Return every record from the cursor on, not one page
 .TP
 \fB\-\-fields\fR \fI<FIELDS>\fR
-With \-\-json, keep only these finding fields (comma\-separated): round, seq, severity, disposition, reviewer, summary, resolution_sha, file_ref; camelCase and snake_case both match
+With \-\-json, keep only these members of each finding (comma\-separated field paths: severity, disposition, reviewer, summary, resolutionSha, fileRef, reason; round and seq are always kept)
 .TP
 \fB\-h\fR, \fB\-\-help\fR
 Print help
@@ -56,4 +56,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.33.0
+v0.34.0