@journeykit/canon 0.32.0 → 0.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.0
+v0.34.0

package/man/canon-finding.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-finding 1  "finding 0.32.0" 
+.TH canon-finding 1  "finding 0.34.0" 
 .SH NAME
 canon\-finding \- Record one code\-review finding as a durable record
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Record one code\-review finding as a durable record
 .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
@@ -64,4 +64,4 @@ RECORDED OBSERVATION, NOT PROOF — canon never verifies that the defect
 existed, that it was fixed, or that \-\-introduced\-rev is the true cause.
 See `canon finding add \-\-help` for exactly what it does and does not establish.
 .SH VERSION
-v0.32.0
+v0.34.0

package/man/canon-format.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-format 1  "format 0.32.0" 
+.TH canon-format 1  "format 0.34.0" 
 .SH NAME
 canon\-format \- Validate a spec/artifact corpus against canon\*(Aqs format
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Validate a spec/artifact corpus against canon\*(Aqs format
 .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
@@ -46,4 +46,4 @@ Examples:
   canon format spec
   canon format spec \-\-repo ~/work/myrepo
 .SH VERSION
-v0.32.0
+v0.34.0

package/man/canon-gate-check.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-gate-check 1  "check 0.32.0" 
+.TH canon-gate-check 1  "check 0.34.0" 
 .SH NAME
 canon\-gate\-check \- Run the coverage/ledger/staleness/trust checks (0 clean, 1 red, 2 usage)
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Run the coverage/ledger/staleness/trust checks (0 clean, 1 red, 2 usage)
 .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.32.0
+v0.34.0

package/man/canon-gate-install-hooks.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-gate-install-hooks 1  "install-hooks 0.32.0" 
+.TH canon-gate-install-hooks 1  "install-hooks 0.34.0" 
 .SH NAME
 canon\-gate\-install\-hooks \- Install the gate hook into .claude/settings.json / .codex/hooks.json
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Install the gate hook into .claude/settings.json / .codex/hooks.json
 .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
@@ -56,4 +56,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.32.0
+v0.34.0

package/man/canon-gate-promote.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-gate-promote 1  "promote 0.32.0" 
+.TH canon-gate-promote 1  "promote 0.34.0" 
 .SH NAME
 canon\-gate\-promote \- Promote staged records (evidence, findings, divergences) to the committed ledger
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Promote staged records (evidence, findings, divergences) to the committed ledger
 .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 help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.32.0
+v0.34.0

package/man/canon-gate.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-gate 1  "gate 0.32.0" 
+.TH canon-gate 1  "gate 0.34.0" 
 .SH NAME
 canon\-gate \- Run evidence gates, promote staged records, install hooks
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Run evidence gates, promote staged records, install hooks
 .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 @@ Examples:
   canon task done my\-change#3
   canon gate install\-hooks
 .SH VERSION
-v0.32.0
+v0.34.0

package/man/canon-ingest-plans.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-ingest-plans 1  "plans 0.32.0" 
+.TH canon-ingest-plans 1  "plans 0.34.0" 
 .SH NAME
 canon\-ingest\-plans \- Import plans as Change/Task records: canon\*(Aqs own .canon/changes, then the configured external sources (openspec, superpowers)
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Import plans as Change/Task records: canon\*(Aqs own .canon/changes, then the co
 .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
@@ -50,4 +50,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.32.0
+v0.34.0

package/man/canon-ingest-records.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-ingest-records 1  "records 0.32.0" 
+.TH canon-ingest-records 1  "records 0.34.0" 
 .SH NAME
 canon\-ingest\-records \- Import review/divergence/task/handoff records and derive verdicts
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Import review/divergence/task/handoff records and derive verdicts
 .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
@@ -53,4 +53,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.32.0
+v0.34.0

package/man/canon-ingest-sessions.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-ingest-sessions 1  "sessions 0.32.0" 
+.TH canon-ingest-sessions 1  "sessions 0.34.0" 
 .SH NAME
 canon\-ingest\-sessions \- Import agent CLI session transcripts (omp/pi, Claude Code, Codex, Hermes)
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Import agent CLI session transcripts (omp/pi, Claude Code, Codex, Hermes)
 .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 help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.32.0
+v0.34.0

package/man/canon-ingest.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-ingest 1  "ingest 0.32.0" 
+.TH canon-ingest 1  "ingest 0.34.0" 
 .SH NAME
 canon\-ingest \- Import agent sessions, records, and plans into canon\*(Aqs store
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Import agent sessions, records, and plans into canon\*(Aqs store
 .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 @@ Examples:
   canon ingest records
   canon ingest plans
 .SH VERSION
-v0.32.0
+v0.34.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.32.0" 
+.TH canon-init 1  "init 0.34.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
@@ -10,7 +10,7 @@ Set up canon in a repo (canon.yaml, a starter policy, the AGENTS.md block, a pla
 .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,7 +36,7 @@ Validate an existing canon.yaml instead of writing one
 Do not write or refresh the canon block in AGENTS.md
 .TP
 \fB\-\-policy\fR \fI<LEVEL>\fR [default: strict]
-Level of the starter .canon/policy.yaml [default: strict]
+Level of the starter .canon/policy.yaml
 .br
 
 .br
@@ -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.32.0
+v0.34.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.32.0" 
+.TH canon-inventory-sync 1  "sync 0.34.0" 
 .SH NAME
 canon\-inventory\-sync \- Validate each spec root, then materialize scenario index records
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Validate each spec root, then materialize scenario index 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
@@ -47,4 +47,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.32.0
+v0.34.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.32.0" 
+.TH canon-inventory 1  "inventory 0.34.0" 
 .SH NAME
 canon\-inventory \- Index a validated .feature corpus into the scenario ledger
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Index a validated .feature corpus into the scenario ledger
 .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\-inventory\-sync(1)
 Validate each spec root, then materialize scenario index records
 .SH VERSION
-v0.32.0
+v0.34.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.32.0" 
+.TH canon-ledger-compact 1  "compact 0.34.0" 
 .SH NAME
 canon\-ledger\-compact \- Move superseded versions of every record out of the ledger into the archive
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Move superseded versions of every record out of the ledger into the archive
 .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.32.0
+v0.34.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.32.0" 
+.TH canon-ledger 1  "ledger 0.34.0" 
 .SH NAME
 canon\-ledger \- Keep the ledger to the current version of each record
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Keep the ledger to the current version of each record
 .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
@@ -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.32.0
+v0.34.0

package/man/canon-migrate.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-migrate 1  "migrate 0.32.0" 
+.TH canon-migrate 1  "migrate 0.34.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
@@ -10,7 +10,7 @@ Bring a repo from an earlier canon up to date: the 0.17 layout (specs, changes,
 .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
@@ -120,4 +120,4 @@ kept. canon.yaml is written atomically.
   every agent role). `\-\-revert` restores them byte for byte and refuses, naming the file, when one changed
   since the migrate.
 .SH VERSION
-v0.32.0
+v0.34.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.32.0" 
+.TH canon-plugin-sync 1  "sync 0.34.0" 
 .SH NAME
 canon\-plugin\-sync \- Validate and write a plugin\*(Aqs overlay records
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Validate and write a plugin\*(Aqs overlay 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
@@ -50,4 +50,4 @@ Print version
 <\fIPLUGIN_ID\fR>
 A .canon/plugins/<id>/plugin.yaml manifest id (e.g. porting)
 .SH VERSION
-v0.32.0
+v0.34.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.32.0" 
+.TH canon-plugin 1  "plugin 0.34.0" 
 .SH NAME
 canon\-plugin \- Sync plugin overlay records onto the ledger
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Sync plugin overlay records onto the ledger
 .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\-plugin\-sync(1)
 Validate and write a plugin\*(Aqs overlay records
 .SH VERSION
-v0.32.0
+v0.34.0