@journeykit/canon 0.34.0 → 0.36.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.34.0" 
+.TH canon-ingest-plans 1  "plans 0.36.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
@@ -50,4 +50,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-ingest-records 1  "records 0.36.0" 
 .SH NAME
 canon\-ingest\-records \- Import review/divergence/task/handoff records and derive verdicts
 .SH SYNOPSIS
@@ -53,4 +53,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-ingest-sessions 1  "sessions 0.36.0" 
 .SH NAME
 canon\-ingest\-sessions \- Import agent CLI session transcripts (omp/pi, Claude Code, Codex, Hermes)
 .SH SYNOPSIS
@@ -59,4 +59,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-ingest 1  "ingest 0.36.0" 
 .SH NAME
 canon\-ingest \- Import agent sessions, records, and plans into canon\*(Aqs store
 .SH SYNOPSIS
@@ -47,4 +47,4 @@ Examples:
   canon ingest records
   canon ingest plans
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-init 1  "init 0.36.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
@@ -86,13 +86,13 @@ scenario; standard adds a `@case:failure` scenario per feature surface; strict
 adds independent review. The level is the first line of .canon/policy.yaml and
 `canon status` shows it.
 
-Harnesses (\-\-providers): on a terminal, init asks which harnesses get the canon
-skill, with the detected ones (.claude, .codex, .omp, .pi directories) checked.
-Without a terminal or \-\-providers it takes the detected ones; with none detected
-it installs nothing and says how to choose. The answer is recorded as
-`skills: { providers: [...] }` in canon.yaml (`\-\-providers none` records `[]`).
+Harnesses (\-\-providers): init never asks. Without \-\-providers it takes the
+detected harnesses (.claude, .codex, .omp, .pi directories), on a terminal or
+not; with none detected it installs nothing and says how to choose. The answer is
+recorded as `skills: { providers: [...] }` in canon.yaml (`\-\-providers none`
+records `[]`).
 
 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.34.0
+v0.36.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.34.0" 
+.TH canon-inventory-sync 1  "sync 0.36.0" 
 .SH NAME
 canon\-inventory\-sync \- Validate each spec root, then materialize scenario index records
 .SH SYNOPSIS
@@ -47,4 +47,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-inventory 1  "inventory 0.36.0" 
 .SH NAME
 canon\-inventory \- Index a validated .feature corpus into the scenario ledger
 .SH SYNOPSIS
@@ -36,4 +36,4 @@ Print version
 canon\-inventory\-sync(1)
 Validate each spec root, then materialize scenario index records
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-ledger-compact 1  "compact 0.36.0" 
 .SH NAME
 canon\-ledger\-compact \- Move superseded versions of every record out of the ledger into the archive
 .SH SYNOPSIS
@@ -27,10 +27,10 @@ orchestrator
 .RE
 .TP
 \fB\-\-commit\fR
-Act on the previewed plan; needs \-\-plan\-digest
+Make the change; without it the command only previews.
 .TP
-\fB\-\-plan\-digest\fR \fI<DIGEST>\fR
-The `planDigest` the preview printed; the run acts only if the plan recomputed now has this digest
+\fB\-\-plan\-digest\fR \fI<PLAN_DIGEST>\fR
+The digest of the preview this commit carries out.
 .TP
 \fB\-\-repo\fR \fI<DIR>\fR
 The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
@@ -47,4 +47,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-ledger 1  "ledger 0.36.0" 
 .SH NAME
 canon\-ledger \- Keep the ledger to the current version of each record
 .SH SYNOPSIS
@@ -38,7 +38,7 @@ Move superseded versions of every record out of the ledger into the archive
 .SH EXTRA
 Examples:
   canon ledger compact
-  canon ledger compact \-\-commit \-\-plan\-digest <DIGEST>
+  canon ledger compact \-\-commit \-\-plan\-digest <PLAN_DIGEST>
 
 The bare run previews the move and prints its planDigest.
 
@@ -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.34.0
+v0.36.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.34.0" 
+.TH canon-migrate 1  "migrate 0.36.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
@@ -30,10 +30,10 @@ orchestrator
 The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
 .TP
 \fB\-\-commit\fR
-Act on the previewed plan; needs \-\-plan\-digest
+Make the change; without it the command only previews.
 .TP
-\fB\-\-plan\-digest\fR \fI<DIGEST>\fR
-The `planDigest` the preview printed; the run acts only if the plan recomputed now has this digest
+\fB\-\-plan\-digest\fR \fI<PLAN_DIGEST>\fR
+The digest of the preview this commit carries out.
 .TP
 \fB\-\-revert\fR
 Undo the last committed migrate (restores what it backed up, undoes its moves and its Postgres and R2 re\-keying); previews first, `\-\-commit \-\-plan\-digest` acts
@@ -67,9 +67,9 @@ Print version
 .SH EXTRA
 Examples:
   canon migrate
-  canon migrate \-\-commit \-\-plan\-digest <DIGEST>
+  canon migrate \-\-commit \-\-plan\-digest <PLAN_DIGEST>
   canon migrate \-\-revert
-  canon migrate \-\-revert \-\-commit \-\-plan\-digest <DIGEST>
+  canon migrate \-\-revert \-\-commit \-\-plan\-digest <PLAN_DIGEST>
 
 The bare run prints the plan and its planDigest and writes nothing; \-\-commit \-\-plan\-digest applies exactly that plan. Idempotent:
 a second run finds nothing to move, and a run that stopped partway is finished
@@ -116,8 +116,8 @@ stop halfway, and on a canon.yaml edit it cannot make with every other byte
 kept. canon.yaml is written atomically.
 \- Change briefs in the 0.30 format (`canon:` comments, Korean headings) are rewritten to the 0.31
   format: comments gone, waivers in the frontmatter, headings in English. The plan says first whether it
-  re\-binds an `Approved:` digest or a chore review pin; then `\-\-commit` is the human\*(Aqs (HUMAN_ONLY for
+  re\-binds an `Approved:` digest or a chore review pin; then `\-\-commit` is the human\*(Aqs (ACTOR_DENIED for
   every agent role). `\-\-revert` restores them byte for byte and refuses, naming the file, when one changed
   since the migrate.
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-plugin-sync 1  "sync 0.36.0" 
 .SH NAME
 canon\-plugin\-sync \- Validate and write a plugin\*(Aqs overlay records
 .SH SYNOPSIS
@@ -50,4 +50,4 @@ Print version
 <\fIPLUGIN_ID\fR>
 A .canon/plugins/<id>/plugin.yaml manifest id (e.g. porting)
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-plugin 1  "plugin 0.36.0" 
 .SH NAME
 canon\-plugin \- Sync plugin overlay records onto the ledger
 .SH SYNOPSIS
@@ -36,4 +36,4 @@ Print version
 canon\-plugin\-sync(1)
 Validate and write a plugin\*(Aqs overlay records
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-policy-approve 1  "approve 0.36.0" 
 .SH NAME
 canon\-policy\-approve \- Approve the current .canon/policy.yaml (written directly; nothing to promote)
 .SH SYNOPSIS
@@ -53,4 +53,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-policy-show 1  "show 0.36.0" 
 .SH NAME
 canon\-policy\-show \- Show the policy\*(Aqs digest and its approval (who, when, which bytes)
 .SH SYNOPSIS
@@ -38,4 +38,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-policy 1  "policy 0.36.0" 
 .SH NAME
 canon\-policy \- Record who approved the gate\*(Aqs policy (.canon/policy.yaml) and which bytes
 .SH SYNOPSIS
@@ -49,4 +49,4 @@ approval (or whose approval cannot be read) fails closed: `gate check` exits 1
 and `subject move` refuses to ship or reopen; `\-\-override\-reason` does not
 waive it. `canon policy show` reads the approval back.
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-prompt-add 1  "add 0.36.0" 
 .SH NAME
 canon\-prompt\-add \- Add a prompt bundle from a repository\-local JSON manifest
 .SH SYNOPSIS
@@ -44,4 +44,4 @@ Print help
 <\fINAME@VERSION\fR>
 The bundle to register, `NAME@VERSION`
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-prompt-show 1  "show 0.36.0" 
 .SH NAME
 canon\-prompt\-show \- Select a registered prompt bundle version
 .SH SYNOPSIS
@@ -38,4 +38,4 @@ Print help
 <\fINAME@VERSION\fR>
 The bundle to show, `NAME@VERSION`
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-prompt 1  "prompt 0.36.0" 
 .SH NAME
 canon\-prompt \- Register and select versioned prompt bundles
 .SH SYNOPSIS
@@ -40,4 +40,4 @@ Examples:
   canon prompt add reviewer@v1 \-\-manifest .canon/reviewer.json
   canon prompt show reviewer@v1 \-\-json
 .SH VERSION
-v0.34.0
+v0.36.0

package/man/canon-purge.1

@@ -1,12 +1,12 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-purge 1  "purge 0.34.0" 
+.TH canon-purge 1  "purge 0.36.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
+canon\-purge \- Remove allowlisted records older than a cutoff: the bare run previews the removal set and its planDigest, `\-\-commit \-\-plan\-digest <PLAN_DIGEST>` deletes it
 .SH SYNOPSIS
 \fBcanon purge\fR [\fB\-\-as\fR] <\fB\-\-kind\fR> <\fB\-\-before\fR> [\fB\-\-commit\fR] [\fB\-\-plan\-digest\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] 
 .SH DESCRIPTION
-Remove allowlisted records older than a cutoff: the bare run previews the removal set and its planDigest, `\-\-commit \-\-plan\-digest <DIGEST>` deletes it
+Remove allowlisted records older than a cutoff: the bare run previews the removal set and its planDigest, `\-\-commit \-\-plan\-digest <PLAN_DIGEST>` deletes it
 .SH OPTIONS
 .TP
 \fB\-\-as\fR \fI<ROLE>\fR
@@ -47,10 +47,10 @@ trajectory
 Remove records strictly before this time (RFC3339 or YYYY\-MM\-DD, UTC)
 .TP
 \fB\-\-commit\fR
-Act on the previewed plan; needs \-\-plan\-digest
+Make the change; without it the command only previews.
 .TP
-\fB\-\-plan\-digest\fR \fI<DIGEST>\fR
-The `planDigest` the preview printed; the run acts only if the plan recomputed now has this digest
+\fB\-\-plan\-digest\fR \fI<PLAN_DIGEST>\fR
+The digest of the preview this commit carries out.
 .TP
 \fB\-\-repo\fR \fI<DIR>\fR
 The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
@@ -67,4 +67,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-query 1  "query 0.36.0" 
 .SH NAME
 canon\-query \- Read stored records across every storage tier
 .SH SYNOPSIS
@@ -108,4 +108,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-regime-show 1  "show 0.36.0" 
 .SH NAME
 canon\-regime\-show \- Build a canonical regime key for hook scripts
 .SH SYNOPSIS
@@ -47,4 +47,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-regime 1  "regime 0.36.0" 
 .SH NAME
 canon\-regime \- Build a canonical regime key for hook scripts
 .SH SYNOPSIS
@@ -36,4 +36,4 @@ Print version
 canon\-regime\-show(1)
 Build a canonical regime key for hook scripts
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-report-build 1  "build 0.36.0" 
 .SH NAME
 canon\-report\-build \- Write the status report (.canon/REPORT.md)
 .SH SYNOPSIS
@@ -41,4 +41,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-report-check 1  "check 0.36.0" 
 .SH NAME
 canon\-report\-check \- Byte\-diff .canon/REPORT.md against a fresh build (0 fresh, 1 missing or drifted); writes nothing
 .SH SYNOPSIS
@@ -38,4 +38,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-report-snapshot 1  "snapshot 0.36.0" 
 .SH NAME
 canon\-report\-snapshot \- Export the panel marts to <DIR>/*.parquet plus manifest.json
 .SH SYNOPSIS
@@ -44,4 +44,4 @@ Print version
 <\fIDIR\fR>
 The output directory (created if absent)
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-report 1  "report 0.36.0" 
 .SH NAME
 canon\-report \- Build, check, or snapshot the status report
 .SH SYNOPSIS
@@ -42,4 +42,4 @@ Byte\-diff .canon/REPORT.md against a fresh build (0 fresh, 1 missing or drifted
 canon\-report\-snapshot(1)
 Export the panel marts to <DIR>/*.parquet plus manifest.json
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-retrieve 1  "retrieve 0.36.0" 
 .SH NAME
 canon\-retrieve \- Fetch role\-scoped strategy guidance
 .SH SYNOPSIS
@@ -53,4 +53,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-review-change 1  "change 0.36.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
@@ -33,7 +33,7 @@ Spec corpus id of the scenarios. Required only when canon.yaml configures more t
 The reviewer\*(Aqs id (recorded as the review\*(Aqs author and as its reviewer; line breaks refused)
 .TP
 \fB\-\-rev\fR \fI<REV>\fR [default: HEAD]
-The commit this record is about: any git revision (`HEAD~1`, a branch, a tag, a short sha); the full sha is recorded with the code tree it saw. The default HEAD records the working tree as it stands (uncommitted code included), and a commit made from it has the same code tree. Outside git, or with no commit, the command refuses (NO_COMMIT)
+The commit this record is about: any git revision (`HEAD~1`, a branch, a tag, a short sha); the full sha is recorded with the code tree it saw. The default HEAD records the working tree as it stands (uncommitted code included), and a commit made from it has the same code tree. Outside git, or with no commit, the command refuses (COMMIT_REQUIRED)
 .TP
 \fB\-\-upstream\-ref\fR \fI<TEXT>\fR
 Provenance ref (mutually exclusive with \-\-original\-spec\-ref; exactly one required)
@@ -95,4 +95,4 @@ Print version
 <\fICHANGE_ID\fR>
 The chore change to review
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-review-scenario 1  "scenario 0.36.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
@@ -33,7 +33,7 @@ Spec corpus id of the scenarios. Required only when canon.yaml configures more t
 The reviewer\*(Aqs id (recorded as the review\*(Aqs author and as its reviewer; line breaks refused)
 .TP
 \fB\-\-rev\fR \fI<REV>\fR [default: HEAD]
-The commit this record is about: any git revision (`HEAD~1`, a branch, a tag, a short sha); the full sha is recorded with the code tree it saw. The default HEAD records the working tree as it stands (uncommitted code included), and a commit made from it has the same code tree. Outside git, or with no commit, the command refuses (NO_COMMIT)
+The commit this record is about: any git revision (`HEAD~1`, a branch, a tag, a short sha); the full sha is recorded with the code tree it saw. The default HEAD records the working tree as it stands (uncommitted code included), and a commit made from it has the same code tree. Outside git, or with no commit, the command refuses (COMMIT_REQUIRED)
 .TP
 \fB\-\-upstream\-ref\fR \fI<TEXT>\fR
 Provenance ref (mutually exclusive with \-\-original\-spec\-ref; exactly one required)
@@ -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.34.0
+v0.36.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.34.0" 
+.TH canon-review 1  "review 0.36.0" 
 .SH NAME
 canon\-review \- Record an attributed review verdict
 .SH SYNOPSIS
@@ -39,4 +39,4 @@ Write one attributed Review record per scenario directly to the ledger, nothing
 canon\-review\-change(1)
 Write one attributed Review record for a chore change directly to the ledger (exactly one provenance ref required). The review signs the chore\*(Aqs invariants and checks against the diff and pins the change\*(Aqs brief; an edit to the brief stales it. A chore needs exactly this one review before `subject move \-\-to shipped`
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-scenario-new 1  "new 0.36.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
@@ -77,4 +77,4 @@ Print version
 <\fISCENARIO_ID\fR>
 <area>.<surface>.<nn> scenario tag
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-scenario 1  "scenario 0.36.0" 
 .SH NAME
 canon\-scenario \- Add a tagged scenario to a .feature spec file
 .SH SYNOPSIS
@@ -36,4 +36,4 @@ Print version
 canon\-scenario\-new(1)
 Append a tagged scenario stub to its .feature file (created if missing); many at once with `\-\-input`
 .SH VERSION
-v0.34.0
+v0.36.0

package/man/canon-schema.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-schema 1  "schema 0.34.0" 
+.TH canon-schema 1  "schema 0.36.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\-\-warnings\fR] [\fB\-\-warning\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\-\-schemas\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
@@ -29,6 +29,9 @@ orchestrator
 \fB\-\-json\fR
 Output JSON instead of the human\-readable form
 .TP
+\fB\-\-schemas\fR
+Print the JSON Schemas the command\*(Aqs refs reach, its `Input` and the `rejects` of its validators, instead of its call surface (needs a command path)
+.TP
 \fB\-\-errors\fR
 Print every error code any command can emit, with its meaning and reasons, instead of a command
 .TP
@@ -54,9 +57,10 @@ Examples:
   canon schema
   canon schema \-\-json
   canon schema evidence add \-\-json
+  canon schema evidence add \-\-schemas \-\-json
   canon schema \-\-as reviewer \-\-json
   canon schema \-\-errors \-\-json
-  canon schema \-\-error CONFIG_MISSING
+  canon schema \-\-error CONFIG_REQUIRED
   canon schema \-\-warnings \-\-json
   canon schema \-\-warning OLD_LAYOUT_FOUND
 
@@ -67,5 +71,7 @@ nearest matches.
 The bare listing is unfiltered: every command. `\-\-as <ROLE>` lists only that role\*(Aqs commands; the
 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`.
+
+The tree holds the options commands share, defined once; a command names them. A command document is its call surface only: members at their default and the options and codes every command has (`\-\-json`, `\-\-input`, `\-\-fields`, `USAGE`, `INTERNAL`, ...) are left out. `\-\-schemas` with a command path prints the JSON Schemas the command\*(Aqs refs reach, `Input` (the schema of one `\-\-input` document) and the `rejects` of its validators.
 .SH VERSION
-v0.34.0
+v0.36.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.34.0" 
+.TH canon-search 1  "search 0.36.0" 
 .SH NAME
 canon\-search \- Search records, brief sections and scenario text, with each hit\*(Aqs neighbors in the record graph
 .SH SYNOPSIS
@@ -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.34.0
+v0.36.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.34.0" 
+.TH canon-selftest 1  "selftest 0.36.0" 
 .SH NAME
 canon\-selftest \- Run canon\*(Aqs built\-in fixture self\-tests
 .SH SYNOPSIS
@@ -66,4 +66,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.34.0
+v0.36.0