@journeykit/canon 0.33.0 → 0.35.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.33.0" 
+.TH canon-plugin-sync 1  "sync 0.35.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.33.0
+v0.35.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.33.0" 
+.TH canon-plugin 1  "plugin 0.35.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.33.0
+v0.35.0

package/man/canon-policy-approve.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-policy-approve 1  "approve 0.33.0" 
+.TH canon-policy-approve 1  "approve 0.35.0" 
 .SH NAME
 canon\-policy\-approve \- Approve the current .canon/policy.yaml (written directly; nothing to promote)
 .SH SYNOPSIS
@@ -13,7 +13,7 @@ Approve the current .canon/policy.yaml (written directly; nothing to promote)
 Who approved it (a human\*(Aqs name or id)
 .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.33.0
+v0.35.0

package/man/canon-policy-show.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-policy-show 1  "show 0.33.0" 
+.TH canon-policy-show 1  "show 0.35.0" 
 .SH NAME
 canon\-policy\-show \- Show the policy\*(Aqs digest and its approval (who, when, which bytes)
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Show the policy\*(Aqs digest and its approval (who, when, which bytes)
 .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.35.0

package/man/canon-policy.1

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

package/man/canon-prompt-add.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-prompt-add 1  "add 0.33.0" 
+.TH canon-prompt-add 1  "add 0.35.0" 
 .SH NAME
 canon\-prompt\-add \- Add a prompt bundle from a repository\-local JSON manifest
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Add a prompt bundle from a repository\-local JSON manifest
 .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 @@ Print help
 <\fINAME@VERSION\fR>
 The bundle to register, `NAME@VERSION`
 .SH VERSION
-v0.33.0
+v0.35.0

package/man/canon-prompt-show.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-prompt-show 1  "show 0.33.0" 
+.TH canon-prompt-show 1  "show 0.35.0" 
 .SH NAME
 canon\-prompt\-show \- Select a registered prompt bundle version
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Select a registered prompt bundle version
 .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
 <\fINAME@VERSION\fR>
 The bundle to show, `NAME@VERSION`
 .SH VERSION
-v0.33.0
+v0.35.0

package/man/canon-prompt.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-prompt 1  "prompt 0.33.0" 
+.TH canon-prompt 1  "prompt 0.35.0" 
 .SH NAME
 canon\-prompt \- Register and select versioned prompt bundles
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Register and select versioned prompt bundles
 .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
@@ -40,4 +40,4 @@ Examples:
   canon prompt add reviewer@v1 \-\-manifest .canon/reviewer.json
   canon prompt show reviewer@v1 \-\-json
 .SH VERSION
-v0.33.0
+v0.35.0

package/man/canon-purge.1

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

package/man/canon-query.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-query 1  "query 0.33.0" 
+.TH canon-query 1  "query 0.35.0" 
 .SH NAME
 canon\-query \- Read stored records across every storage tier
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Read stored records across every storage tier
 .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
@@ -90,8 +90,8 @@ Scope \-\-kind subject by domain (other kinds exit 2)
 \fB\-\-include\-sensitive\fR
 Permit sensitive query output 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)
@@ -100,7 +100,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 top\-level record fields (comma\-separated); an unknown field is refused (camelCase and snake_case both match)
+With \-\-json, keep only these members of each record (comma\-separated field paths; `canon schema query \-\-json` lists them under outputs[].fields.paths)
 .TP
 \fB\-h\fR, \fB\-\-help\fR
 Print help
@@ -108,4 +108,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.33.0
+v0.35.0

package/man/canon-regime-show.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-regime-show 1  "show 0.33.0" 
+.TH canon-regime-show 1  "show 0.35.0" 
 .SH NAME
 canon\-regime\-show \- Build a canonical regime key for hook scripts
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Build a canonical regime key for hook scripts
 .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.35.0

package/man/canon-regime.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-regime 1  "regime 0.33.0" 
+.TH canon-regime 1  "regime 0.35.0" 
 .SH NAME
 canon\-regime \- Build a canonical regime key for hook scripts
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Build a canonical regime key for hook scripts
 .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\-regime\-show(1)
 Build a canonical regime key for hook scripts
 .SH VERSION
-v0.33.0
+v0.35.0

package/man/canon-report-build.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-report-build 1  "build 0.33.0" 
+.TH canon-report-build 1  "build 0.35.0" 
 .SH NAME
 canon\-report\-build \- Write the status report (.canon/REPORT.md)
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Write the status report (.canon/REPORT.md)
 .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.35.0

package/man/canon-report-check.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-report-check 1  "check 0.33.0" 
+.TH canon-report-check 1  "check 0.35.0" 
 .SH NAME
 canon\-report\-check \- Byte\-diff .canon/REPORT.md against a fresh build (0 fresh, 1 missing or drifted); writes nothing
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Byte\-diff .canon/REPORT.md against a fresh build (0 fresh, 1 missing or drifted
 .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.35.0

package/man/canon-report-snapshot.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-report-snapshot 1  "snapshot 0.33.0" 
+.TH canon-report-snapshot 1  "snapshot 0.35.0" 
 .SH NAME
 canon\-report\-snapshot \- Export the panel marts to <DIR>/*.parquet plus manifest.json
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Export the panel marts to <DIR>/*.parquet plus manifest.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
@@ -44,4 +44,4 @@ Print version
 <\fIDIR\fR>
 The output directory (created if absent)
 .SH VERSION
-v0.33.0
+v0.35.0

package/man/canon-report.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-report 1  "report 0.33.0" 
+.TH canon-report 1  "report 0.35.0" 
 .SH NAME
 canon\-report \- Build, check, or snapshot the status report
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Build, check, or snapshot the status report
 .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 @@ Byte\-diff .canon/REPORT.md against a fresh build (0 fresh, 1 missing or drifted
 canon\-report\-snapshot(1)
 Export the panel marts to <DIR>/*.parquet plus manifest.json
 .SH VERSION
-v0.33.0
+v0.35.0

package/man/canon-retrieve.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-retrieve 1  "retrieve 0.33.0" 
+.TH canon-retrieve 1  "retrieve 0.35.0" 
 .SH NAME
 canon\-retrieve \- Fetch role\-scoped strategy guidance
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Fetch role\-scoped strategy guidance
 .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
@@ -39,7 +39,7 @@ Derive the regime from a domain slug; mutually exclusive with \-\-regime
 Narrow \-\-domain to one subject_id; requires \-\-domain, mutually exclusive with \-\-regime
 .TP
 \fB\-\-limit\fR \fI<N>\fR [default: 5]
-Cap on the guidance items returned (default: 5)
+Cap on the guidance items returned
 .TP
 \fB\-\-repo\fR \fI<DIR>\fR
 The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
@@ -53,4 +53,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.33.0
+v0.35.0

package/man/canon-review-change.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-review-change 1  "change 0.33.0" 
+.TH canon-review-change 1  "change 0.35.0" 
 .SH NAME
 canon\-review\-change \- Write one attributed Review record for a chore change directly to the ledger (exactly one provenance ref required). The review signs the chore\*(Aqs invariants and checks against the diff and pins the change\*(Aqs brief; an edit to the brief stales it. A chore needs exactly this one review before `subject move \-\-to shipped`
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Write one attributed Review record for a chore change directly to the ledger (ex
 .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
@@ -95,4 +95,4 @@ Print version
 <\fICHANGE_ID\fR>
 The chore change to review
 .SH VERSION
-v0.33.0
+v0.35.0

package/man/canon-review-scenario.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-review-scenario 1  "scenario 0.33.0" 
+.TH canon-review-scenario 1  "scenario 0.35.0" 
 .SH NAME
 canon\-review\-scenario \- Write one attributed Review record per scenario directly to the ledger, nothing to promote (exactly one provenance ref required). A review pins the scenario\*(Aqs digest and what its latest evidence says (verdict and checks); it counts only while both are unchanged. Each scenario must be indexed, or nothing is written (exit 2)
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Write one attributed Review record per scenario directly to the ledger, nothing
 .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
@@ -95,4 +95,4 @@ Print version
 <\fISCENARIO_ID\fR>
 The reviewed scenarios (`<area>.<surface>.<nn>`), one review each, all or nothing. Each must have a record (`canon inventory sync`), or nothing is written (exit 2)
 .SH VERSION
-v0.33.0
+v0.35.0

package/man/canon-review.1

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

package/man/canon-scenario-new.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-scenario-new 1  "new 0.33.0" 
+.TH canon-scenario-new 1  "new 0.35.0" 
 .SH NAME
 canon\-scenario\-new \- Append a tagged scenario stub to its .feature file (created if missing); many at once with `\-\-input`
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Append a tagged scenario stub to its .feature file (created if missing); many 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
@@ -77,4 +77,4 @@ Print version
 <\fISCENARIO_ID\fR>
 <area>.<surface>.<nn> scenario tag
 .SH VERSION
-v0.33.0
+v0.35.0

package/man/canon-scenario.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-scenario 1  "scenario 0.33.0" 
+.TH canon-scenario 1  "scenario 0.35.0" 
 .SH NAME
 canon\-scenario \- Add a tagged scenario to a .feature spec file
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Add a tagged scenario to a .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\-scenario\-new(1)
 Append a tagged scenario stub to its .feature file (created if missing); many at once with `\-\-input`
 .SH VERSION
-v0.33.0
+v0.35.0

package/man/canon-schema.1

@@ -1,16 +1,16 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-schema 1  "schema 0.33.0" 
+.TH canon-schema 1  "schema 0.35.0" 
 .SH NAME
 canon\-schema \- Describe canon\*(Aqs own commands: list them, or show one command\*(Aqs arguments, options, effect and exit codes
 .SH SYNOPSIS
-\fBcanon schema\fR [\fB\-\-as\fR] [\fB\-\-json\fR] [\fB\-\-errors\fR] [\fB\-\-error\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fIPATH\fR] 
+\fBcanon schema\fR [\fB\-\-as\fR] [\fB\-\-json\fR] [\fB\-\-errors\fR] [\fB\-\-error\fR] [\fB\-\-warnings\fR] [\fB\-\-warning\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fIPATH\fR] 
 .SH DESCRIPTION
 Describe canon\*(Aqs own commands: list them, or show one command\*(Aqs arguments, options, effect and exit codes
 .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
@@ -30,10 +30,16 @@ orchestrator
 Output JSON instead of the human\-readable form
 .TP
 \fB\-\-errors\fR
-Print every error code any command can emit, with its meaning, instead of a command
+Print every error code any command can emit, with its meaning and reasons, instead of a command
 .TP
 \fB\-\-error\fR \fI<CODE>\fR
-Show one error code: its meaning, exit, retryable and fix (an unknown code exits 2)
+Show one error code: its meaning, exit, retryable, fix and reasons (an unknown code, or a code that is only a warning, exits 2)
+.TP
+\fB\-\-warnings\fR
+Print every warning code, with its meaning, instead of a command
+.TP
+\fB\-\-warning\fR \fI<CODE>\fR
+Show one warning code: its meaning and fix (an unknown code exits 2)
 .TP
 \fB\-h\fR, \fB\-\-help\fR
 Print help
@@ -51,6 +57,8 @@ Examples:
   canon schema \-\-as reviewer \-\-json
   canon schema \-\-errors \-\-json
   canon schema \-\-error CONFIG_MISSING
+  canon schema \-\-warnings \-\-json
+  canon schema \-\-warning OLD_LAYOUT_FOUND
 
 Generated from the command tree itself, so it never drifts from what the parser accepts.
 Touches no repo and no network: it works from any directory. An unknown path exits 2 and names the
@@ -60,4 +68,4 @@ The bare listing is unfiltered: every command. `\-\-as <ROLE>` lists only that r
 CANON_ROLE variable never filters or fails `schema` (an invalid value is a warning in meta.warnings).
 A command whose effect depends on its arguments carries `effectNote`.
 .SH VERSION
-v0.33.0
+v0.35.0

package/man/canon-search.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-search 1  "search 0.33.0" 
+.TH canon-search 1  "search 0.35.0" 
 .SH NAME
 canon\-search \- Search records, brief sections and scenario text, with each hit\*(Aqs neighbors in the record graph
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Search records, brief sections and scenario text, with each hit\*(Aqs neighbors
 .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
@@ -101,4 +101,4 @@ A read that first brings a derived index up to date: .canon/index/search.db, git
 rebuilt in full when any input changed; deleting it changes nothing but data.index.rebuilt.
 Exit 0 with empty hits when nothing matches; exit 2 for an empty text.
 .SH VERSION
-v0.33.0
+v0.35.0

package/man/canon-selftest.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-selftest 1  "selftest 0.33.0" 
+.TH canon-selftest 1  "selftest 0.35.0" 
 .SH NAME
 canon\-selftest \- Run canon\*(Aqs built\-in fixture self\-tests
 .SH SYNOPSIS
@@ -10,7 +10,7 @@ Run canon\*(Aqs built\-in fixture self\-tests
 .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
@@ -66,4 +66,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.33.0
+v0.35.0