@journeykit/canon 0.29.0 → 0.31.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.29.0" 
+.TH canon-regime 1  "regime 0.31.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.29.0
+v0.31.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.29.0" 
+.TH canon-report-build 1  "build 0.31.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.29.0
+v0.31.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.29.0" 
+.TH canon-report-check 1  "check 0.31.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.29.0
+v0.31.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.29.0" 
+.TH canon-report-snapshot 1  "snapshot 0.31.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.29.0
+v0.31.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.29.0" 
+.TH canon-report 1  "report 0.31.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.29.0
+v0.31.0

package/man/canon-retrieve.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-retrieve 1  "retrieve 0.29.0" 
+.TH canon-retrieve 1  "retrieve 0.31.0" 
 .SH NAME
 canon\-retrieve \- Fetch role\-scoped strategy guidance
 .SH SYNOPSIS
-\fBcanon retrieve\fR [\fB\-\-as\fR] <\fB\-\-for\-role\fR> [\fB\-\-regime\fR] [\fB\-\-domain\fR] [\fB\-\-subject\-id\fR] [\fB\-\-limit\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] 
+\fBcanon retrieve\fR [\fB\-\-as\fR] <\fB\-\-for\-role\fR> [\fB\-\-regime\fR] [\fB\-\-domain\fR] [\fB\-\-subject\fR] [\fB\-\-limit\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] 
 .SH DESCRIPTION
 Fetch role\-scoped strategy guidance
 .SH OPTIONS
@@ -30,12 +30,12 @@ orchestrator
 Role scope; with \-\-regime must equal its leading segment
 .TP
 \fB\-\-regime\fR \fI<KEY>\fR
-Full regime key (<role>/<repo>/<area>/<hash>); mutually exclusive with \-\-domain/\-\-subject\-id
+Full regime key (<role>/<repo>/<area>/<hash>); mutually exclusive with \-\-domain/\-\-subject
 .TP
 \fB\-\-domain\fR \fI<NAME>\fR
 Derive the regime from a domain slug; mutually exclusive with \-\-regime
 .TP
-\fB\-\-subject\-id\fR \fI<SUBJECT_ID>\fR
+\fB\-\-subject\fR \fI<SUBJECT_ID>\fR
 Narrow \-\-domain to one subject_id; requires \-\-domain, mutually exclusive with \-\-regime
 .TP
 \fB\-\-limit\fR \fI<N>\fR [default: 5]
@@ -53,4 +53,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.29.0
+v0.31.0

package/man/canon-review-change.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-review-change 1  "change 0.29.0" 
+.TH canon-review-change 1  "change 0.31.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
-\fBcanon review change\fR [\fB\-\-as\fR] [\fB\-\-project\-id\fR] <\fB\-\-actor\-id\fR> [\fB\-\-rev\fR] [\fB\-\-upstream\-ref\fR] [\fB\-\-original\-spec\-ref\fR] [\fB\-\-role\fR] [\fB\-\-session\-id\fR] [\fB\-\-review\-outcome\fR] [\fB\-\-reviewer\-provider\fR] [\fB\-\-reviewer\-model\fR] [\fB\-\-reviewer\-harness\fR] [\fB\-\-artifact\fR] [\fB\-\-max\-artifact\-mib\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fICHANGE_ID\fR> 
+\fBcanon review change\fR [\fB\-\-as\fR] [\fB\-\-project\fR] <\fB\-\-actor\fR> [\fB\-\-rev\fR] [\fB\-\-upstream\-ref\fR] [\fB\-\-original\-spec\-ref\fR] [\fB\-\-role\fR] [\fB\-\-session\fR] [\fB\-\-review\-outcome\fR] [\fB\-\-reviewer\-provider\fR] [\fB\-\-reviewer\-model\fR] [\fB\-\-reviewer\-harness\fR] [\fB\-\-artifact\fR] [\fB\-\-max\-artifact\-mib\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fICHANGE_ID\fR> 
 .SH DESCRIPTION
 Write 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 OPTIONS
@@ -26,10 +26,10 @@ reviewer
 orchestrator
 .RE
 .TP
-\fB\-\-project\-id\fR \fI<PROJECT_ID>\fR
+\fB\-\-project\fR \fI<PROJECT_ID>\fR
 Spec corpus id of the scenarios. Required only when canon.yaml configures more than one spec root
 .TP
-\fB\-\-actor\-id\fR \fI<ACTOR_ID>\fR
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR
 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]
@@ -44,7 +44,7 @@ Provenance ref (mutually exclusive with \-\-upstream\-ref; exactly one required)
 \fB\-\-role\fR \fI<ROLE>\fR
 The reviewer\*(Aqs role. Required unless the declared role (\-\-as / CANON_ROLE) is implementer or reviewer, which it then defaults to
 .TP
-\fB\-\-session\-id\fR \fI<SESSION_ID>\fR
+\fB\-\-session\fR \fI<SESSION_ID>\fR
 The reviewing session (recorded as actor.session_id). Under require_review.distinct_actor a review whose session also attested the scenario\*(Aqs evidence does not count
 .TP
 \fB\-\-review\-outcome\fR \fI<REVIEW_OUTCOME>\fR [default: signed]
@@ -95,4 +95,4 @@ Print version
 <\fICHANGE_ID\fR>
 The chore change to review
 .SH VERSION
-v0.29.0
+v0.31.0

package/man/canon-review-scenario.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-review-scenario 1  "scenario 0.29.0" 
+.TH canon-review-scenario 1  "scenario 0.31.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
-\fBcanon review scenario\fR [\fB\-\-as\fR] [\fB\-\-project\-id\fR] <\fB\-\-actor\-id\fR> [\fB\-\-rev\fR] [\fB\-\-upstream\-ref\fR] [\fB\-\-original\-spec\-ref\fR] [\fB\-\-role\fR] [\fB\-\-session\-id\fR] [\fB\-\-review\-outcome\fR] [\fB\-\-reviewer\-provider\fR] [\fB\-\-reviewer\-model\fR] [\fB\-\-reviewer\-harness\fR] [\fB\-\-artifact\fR] [\fB\-\-max\-artifact\-mib\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fISCENARIO_ID\fR> 
+\fBcanon review scenario\fR [\fB\-\-as\fR] [\fB\-\-project\fR] <\fB\-\-actor\fR> [\fB\-\-rev\fR] [\fB\-\-upstream\-ref\fR] [\fB\-\-original\-spec\-ref\fR] [\fB\-\-role\fR] [\fB\-\-session\fR] [\fB\-\-review\-outcome\fR] [\fB\-\-reviewer\-provider\fR] [\fB\-\-reviewer\-model\fR] [\fB\-\-reviewer\-harness\fR] [\fB\-\-artifact\fR] [\fB\-\-max\-artifact\-mib\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fISCENARIO_ID\fR> 
 .SH DESCRIPTION
 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 OPTIONS
@@ -26,10 +26,10 @@ reviewer
 orchestrator
 .RE
 .TP
-\fB\-\-project\-id\fR \fI<PROJECT_ID>\fR
+\fB\-\-project\fR \fI<PROJECT_ID>\fR
 Spec corpus id of the scenarios. Required only when canon.yaml configures more than one spec root
 .TP
-\fB\-\-actor\-id\fR \fI<ACTOR_ID>\fR
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR
 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]
@@ -44,7 +44,7 @@ Provenance ref (mutually exclusive with \-\-upstream\-ref; exactly one required)
 \fB\-\-role\fR \fI<ROLE>\fR
 The reviewer\*(Aqs role. Required unless the declared role (\-\-as / CANON_ROLE) is implementer or reviewer, which it then defaults to
 .TP
-\fB\-\-session\-id\fR \fI<SESSION_ID>\fR
+\fB\-\-session\fR \fI<SESSION_ID>\fR
 The reviewing session (recorded as actor.session_id). Under require_review.distinct_actor a review whose session also attested the scenario\*(Aqs evidence does not count
 .TP
 \fB\-\-review\-outcome\fR \fI<REVIEW_OUTCOME>\fR [default: signed]
@@ -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.29.0
+v0.31.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.29.0" 
+.TH canon-review 1  "review 0.31.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.29.0
+v0.31.0

package/man/canon-scenario-new.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-scenario-new 1  "new 0.29.0" 
+.TH canon-scenario-new 1  "new 0.31.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
-\fBcanon scenario new\fR [\fB\-\-as\fR] <\fB\-\-title\fR> [\fB\-\-subject\-id\fR] [\fB\-\-lane\fR] [\fB\-\-case\fR] [\fB\-\-flow\fR] [\fB\-\-change\-id\fR] [\fB\-\-actor\-id\fR] [\fB\-\-session\-id\fR] [\fB\-\-feature\fR] [\fB\-\-project\-id\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fISCENARIO_ID\fR> 
+\fBcanon scenario new\fR [\fB\-\-as\fR] <\fB\-\-title\fR> [\fB\-\-subject\fR] [\fB\-\-lane\fR] [\fB\-\-case\fR] [\fB\-\-flow\fR] [\fB\-\-change\fR] [\fB\-\-actor\fR] [\fB\-\-session\fR] [\fB\-\-feature\fR] [\fB\-\-project\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fISCENARIO_ID\fR> 
 .SH DESCRIPTION
 Append a tagged scenario stub to its .feature file (created if missing); many at once with `\-\-input`
 .SH OPTIONS
@@ -29,7 +29,7 @@ orchestrator
 \fB\-\-title\fR \fI<TEXT>\fR
 The Scenario: header label
 .TP
-\fB\-\-subject\-id\fR \fI<SUBJECT_ID>\fR
+\fB\-\-subject\fR \fI<SUBJECT_ID>\fR
 Optional subject id tag to pin above the scenario
 .TP
 \fB\-\-lane\fR \fI<NAME>\fR
@@ -39,24 +39,24 @@ Optional lane tag to classify the scenario
 Optional case tag: which path of the behavior this scenario specifies (`happy`, `failure`, `edge` in the base vocabulary)
 .TP
 \fB\-\-flow\fR \fI<FLOW_ID>\fR
-The brief flow step this scenario covers (`F1`): writes `@flow:<change>.<F\-id>`. The change is \-\-change\-id, else the newest change of \-\-subject\-id, else the only live change
+The brief flow step this scenario covers (`F1`): writes `@flow:<change>.<F\-id>`. The change is \-\-change, else the newest change of \-\-subject, else the only live change
 .TP
-\fB\-\-change\-id\fR \fI<CHANGE_ID>\fR
-The change whose brief defines \-\-flow (default: \-\-subject\-id\*(Aqs newest adopted change)
+\fB\-\-change\fR \fI<CHANGE_ID>\fR
+The change whose brief defines \-\-flow (default: \-\-subject\*(Aqs newest adopted change)
 .TP
-\fB\-\-actor\-id\fR \fI<ACTOR_ID>\fR [default: canon\-scaffold]
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR [default: canon\-scaffold]
 Agent id written into provenance (env: CANON_ACTOR)
 .RS
 May also be specified with the \fBCANON_ACTOR\fR environment variable. 
 .RE
 .TP
-\fB\-\-session\-id\fR \fI<SESSION_ID>\fR
+\fB\-\-session\fR \fI<SESSION_ID>\fR
 The acting session (recorded as actor.session_id); optional
 .TP
 \fB\-\-feature\fR \fI<FILE>\fR
 Target .feature file (default: derived from <tag>; must live under a specs.roots[] entry)
 .TP
-\fB\-\-project\-id\fR \fI<PROJECT_ID>\fR
+\fB\-\-project\fR \fI<PROJECT_ID>\fR
 Which configured `specs.roots[]` entry to write under, by its id. Required only when the repo configures more than one
 .TP
 \fB\-\-repo\fR \fI<DIR>\fR
@@ -77,4 +77,4 @@ Print version
 <\fISCENARIO_ID\fR>
 <area>.<surface>.<nn> scenario tag
 .SH VERSION
-v0.29.0
+v0.31.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.29.0" 
+.TH canon-scenario 1  "scenario 0.31.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.29.0
+v0.31.0

package/man/canon-schema.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-schema 1  "schema 0.29.0" 
+.TH canon-schema 1  "schema 0.31.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
@@ -60,4 +60,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.29.0
+v0.31.0

package/man/canon-search.1

@@ -0,0 +1,104 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH canon-search 1  "search 0.31.0" 
+.SH NAME
+canon\-search \- Search records, brief sections and scenario text, with each hit\*(Aqs neighbors in the record graph
+.SH SYNOPSIS
+\fBcanon search\fR [\fB\-\-as\fR] [\fB\-\-kind\fR] [\fB\-\-expand\fR] [\fB\-\-limit\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fITEXT\fR> 
+.SH DESCRIPTION
+Search records, brief sections and scenario text, with each hit\*(Aqs neighbors in the record 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
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+planner
+.IP \(bu 2
+implementer
+.IP \(bu 2
+reviewer
+.IP \(bu 2
+orchestrator
+.RE
+.TP
+\fB\-\-kind\fR \fI<KIND>\fR
+Keep only nodes of this kind among the hits (repeatable): a record kind, or `brief` for a brief section or flow step; the neighbors of the hits are of any kind
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+change
+.IP \(bu 2
+task
+.IP \(bu 2
+scenario
+.IP \(bu 2
+session
+.IP \(bu 2
+run
+.IP \(bu 2
+event
+.IP \(bu 2
+handoff
+.IP \(bu 2
+review
+.IP \(bu 2
+divergence
+.IP \(bu 2
+trajectory
+.IP \(bu 2
+strategy_item
+.IP \(bu 2
+evidence
+.IP \(bu 2
+subject
+.IP \(bu 2
+finding
+.IP \(bu 2
+brief
+.RE
+.TP
+\fB\-\-expand\fR \fI<N>\fR [default: 1]
+How many edges away from a hit its neighbors are listed (0: none)
+.TP
+\fB\-\-limit\fR \fI<N>\fR [default: 20]
+The most hits to list, best first (there is no next page)
+.TP
+\fB\-\-repo\fR \fI<DIR>\fR
+The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
+.TP
+\fB\-\-json\fR
+Output JSON instead of the human\-readable form
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help
+.TP
+\fB\-V\fR, \fB\-\-version\fR
+Print version
+.TP
+<\fITEXT\fR>
+The text to find in records, brief sections and scenario text: read as it is typed, so quotes and words such as AND are not syntax. Korean and any other text is found from three characters; a shorter text is found as a part of a node\*(Aqs text, in id order
+.SH EXTRA
+Examples:
+  canon search timeout
+  canon search "token is logged" \-\-kind finding \-\-json
+  canon search 한글 \-\-expand 2 \-\-limit 5
+
+Finds the nodes whose text holds the text typed (a record, a brief section or flow step, a
+scenario\*(Aqs title, steps and tables) and lists each hit with its neighbors: the records it
+names or that name it, the review loop around a finding, the brief step a scenario covers. A
+reference no committed source holds is a neighbor marked `placeholder`. Hits are ranked by
+full\-text score (ties by id) and only current versions are hits.
+
+A read that first brings a derived index up to date: .canon/index/search.db, gitignored and
+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.31.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.29.0" 
+.TH canon-selftest 1  "selftest 0.31.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.29.0
+v0.31.0

package/man/canon-skills-check.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-skills-check 1  "check 0.29.0" 
+.TH canon-skills-check 1  "check 0.31.0" 
 .SH NAME
 canon\-skills\-check \- Check canonical projections without writing; exit 1 on drift, a legacy remnant, or a lock another canon version wrote
 .SH SYNOPSIS
@@ -44,4 +44,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.29.0
+v0.31.0

package/man/canon-skills-doctor.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-skills-doctor 1  "doctor 0.29.0" 
+.TH canon-skills-doctor 1  "doctor 0.31.0" 
 .SH NAME
 canon\-skills\-doctor \- Print diagnostics for canonical projections, the install lock\*(Aqs canon version, legacy remnants, canon projections for a provider that is not selected, and other skills whose description claims build work; reports only, never edits
 .SH SYNOPSIS
@@ -44,4 +44,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.29.0
+v0.31.0

package/man/canon-skills-install.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-skills-install 1  "install 0.29.0" 
+.TH canon-skills-install 1  "install 0.31.0" 
 .SH NAME
 canon\-skills\-install \- Install the canonical `canon` bundle or legacy developer skills
 .SH SYNOPSIS
@@ -50,4 +50,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.29.0
+v0.31.0

package/man/canon-skills-show.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-skills-show 1  "show 0.29.0" 
+.TH canon-skills-show 1  "show 0.31.0" 
 .SH NAME
 canon\-skills\-show \- Print a guide built into this binary (markdown on stdout); the installed SKILL.md is a stub that points here
 .SH SYNOPSIS
@@ -101,4 +101,4 @@ role\-planner
 role\-reviewer
 .RE
 .SH VERSION
-v0.29.0
+v0.31.0

package/man/canon-skills.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-skills 1  "skills 0.29.0" 
+.TH canon-skills 1  "skills 0.31.0" 
 .SH NAME
 canon\-skills \- Install canon\*(Aqs agent guides into a repo
 .SH SYNOPSIS
@@ -45,4 +45,4 @@ Print diagnostics for canonical projections, the install lock\*(Aqs canon versio
 canon\-skills\-show(1)
 Print a guide built into this binary (markdown on stdout); the installed SKILL.md is a stub that points here
 .SH VERSION
-v0.29.0
+v0.31.0

package/man/canon-status.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-status 1  "status 0.29.0" 
+.TH canon-status 1  "status 0.31.0" 
 .SH NAME
 canon\-status \- Show where this repo stands: subjects by status, their gaps, and the next commands
 .SH SYNOPSIS
@@ -47,5 +47,10 @@ Examples:
 
 A read: exits 0 whatever it finds, and writes nothing. The counts come from the
 same joins `canon gate check` and `canon subject move` use.
+
+`briefs` lists one entry per change the subject answers for: tagged by one of its
+scenarios, with an `Approved:` line, or a chore; each has a status (approved,
+unapproved, changed) and a reason. A never\-approved untagged feature change is a
+pending draft (`pendingDrafts`) and blocks nothing. `statusVersion` is 4.
 .SH VERSION
-v0.29.0
+v0.31.0

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

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-strategy-approval-payload 1  "approval-payload 0.29.0" 
+.TH canon-strategy-approval-payload 1  "approval-payload 0.31.0" 
 .SH NAME
 canon\-strategy\-approval\-payload \- The unsigned approval payload bytes an external signer signs (a read: identical arguments give identical bytes)
 .SH SYNOPSIS
@@ -50,4 +50,4 @@ Print version
 <\fISTRATEGY_ID\fR>
 The StrategyId (ULID) whose approval payload to print
 .SH VERSION
-v0.29.0
+v0.31.0

package/man/canon-strategy-promote.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-strategy-promote 1  "promote 0.29.0" 
+.TH canon-strategy-promote 1  "promote 0.31.0" 
 .SH NAME
 canon\-strategy\-promote \- Promote a strategy after paired evaluation and signed approval
 .SH SYNOPSIS
@@ -56,4 +56,4 @@ Print version
 <\fISTRATEGY_ID\fR>
 The StrategyId (ULID) to promote
 .SH VERSION
-v0.29.0
+v0.31.0

package/man/canon-strategy-rollback.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-strategy-rollback 1  "rollback 0.29.0" 
+.TH canon-strategy-rollback 1  "rollback 0.31.0" 
 .SH NAME
 canon\-strategy\-rollback \- Disable an active strategy with durable rollback provenance
 .SH SYNOPSIS
-\fBcanon strategy rollback\fR [\fB\-\-as\fR] <\fB\-\-reason\fR> <\fB\-\-actor\-id\fR> <\fB\-\-signature\-file\fR> <\fB\-\-approval\-at\fR> [\fB\-\-contradicting\-trajectory\-id\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fISTRATEGY_ID\fR> 
+\fBcanon strategy rollback\fR [\fB\-\-as\fR] <\fB\-\-reason\fR> <\fB\-\-actor\fR> <\fB\-\-signature\-file\fR> <\fB\-\-approval\-at\fR> [\fB\-\-contradicting\-trajectory\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fISTRATEGY_ID\fR> 
 .SH DESCRIPTION
 Disable an active strategy with durable rollback provenance
 .SH OPTIONS
@@ -29,7 +29,7 @@ orchestrator
 \fB\-\-reason\fR \fI<TEXT>\fR
 Why the strategy is rolled back (signed: `strategy:<id>:rollback:<sha256(reason)>`)
 .TP
-\fB\-\-actor\-id\fR \fI<ACTOR_ID>\fR
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR
 The approver; must be a policy\-pinned approver
 .TP
 \fB\-\-signature\-file\fR \fI<FILE>\fR
@@ -38,7 +38,7 @@ Detached signature file over the rollback payload
 \fB\-\-approval\-at\fR \fI<TIMESTAMP>\fR
 When the approver signed: RFC3339, or YYYY\-MM\-DD (UTC midnight)
 .TP
-\fB\-\-contradicting\-trajectory\-id\fR \fI<ID>\fR
+\fB\-\-contradicting\-trajectory\fR \fI<ID>\fR
 A trajectory that contradicts the strategy (must exist in the trajectory store)
 .TP
 \fB\-\-repo\fR \fI<DIR>\fR
@@ -59,4 +59,4 @@ Print version
 <\fISTRATEGY_ID\fR>
 The StrategyId (ULID) to roll back
 .SH VERSION
-v0.29.0
+v0.31.0

package/man/canon-strategy.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-strategy 1  "strategy 0.29.0" 
+.TH canon-strategy 1  "strategy 0.31.0" 
 .SH NAME
 canon\-strategy \- Promote a proven strategy into the git\-tracked tier
 .SH SYNOPSIS
@@ -42,4 +42,4 @@ The unsigned approval payload bytes an external signer signs (a read: identical
 canon\-strategy\-rollback(1)
 Disable an active strategy with durable rollback provenance
 .SH VERSION
-v0.29.0
+v0.31.0

package/man/canon-subject-adopt.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-subject-adopt 1  "adopt 0.29.0" 
+.TH canon-subject-adopt 1  "adopt 0.31.0" 
 .SH NAME
 canon\-subject\-adopt \- Link an imported plan change to a subject (adopting it under another subject adds that subject; a change may belong to several)
 .SH SYNOPSIS
-\fBcanon subject adopt\fR [\fB\-\-as\fR] <\fB\-\-change\-id\fR> [\fB\-\-repo\fR] [\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fISUBJECT_ID\fR> 
+\fBcanon subject adopt\fR [\fB\-\-as\fR] <\fB\-\-change\fR> [\fB\-\-repo\fR] [\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fISUBJECT_ID\fR> 
 .SH DESCRIPTION
 Link an imported plan change to a subject (adopting it under another subject adds that subject; a change may belong to several)
 .SH OPTIONS
@@ -26,7 +26,7 @@ reviewer
 orchestrator
 .RE
 .TP
-\fB\-\-change\-id\fR \fI<CHANGE_ID>\fR
+\fB\-\-change\fR \fI<CHANGE_ID>\fR
 The imported Change\*(Aqs id
 .TP
 \fB\-\-repo\fR \fI<DIR>\fR
@@ -50,4 +50,4 @@ Print version
 <\fISUBJECT_ID\fR>
 The subject to adopt the change under
 .SH VERSION
-v0.29.0
+v0.31.0

package/man/canon-subject-move.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-subject-move 1  "move 0.29.0" 
+.TH canon-subject-move 1  "move 0.31.0" 
 .SH NAME
 canon\-subject\-move \- Move a subject to another lifecycle state (shipping is evidence\-gated; with spec_coverage.require_review, entering its scope is review\-gated; shipped → verifying reopens with \-\-reason)
 .SH SYNOPSIS
-\fBcanon subject move\fR [\fB\-\-as\fR] <\fB\-\-to\fR> [\fB\-\-override\-reason\fR] [\fB\-\-reason\fR] [\fB\-\-actor\-id\fR] [\fB\-\-session\-id\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fISUBJECT_ID\fR> 
+\fBcanon subject move\fR [\fB\-\-as\fR] <\fB\-\-to\fR> [\fB\-\-override\-reason\fR] [\fB\-\-reason\fR] [\fB\-\-actor\fR] [\fB\-\-session\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fISUBJECT_ID\fR> 
 .SH DESCRIPTION
 Move a subject to another lifecycle state (shipping is evidence\-gated; with spec_coverage.require_review, entering its scope is review\-gated; shipped → verifying reopens with \-\-reason)
 .SH OPTIONS
@@ -53,10 +53,10 @@ Move anyway when only the require_review checks (unreviewed\-promotion, open\-bl
 \fB\-\-reason\fR \fI<TEXT>\fR
 Why the subject moves (required for shipped → verifying, optional on every other transition); recorded on the subject with the actor
 .TP
-\fB\-\-actor\-id\fR \fI<ACTOR_ID>\fR [default: canon]
+\fB\-\-actor\fR \fI<ACTOR_ID>\fR [default: canon]
 The invoking actor\*(Aqs id, recorded with an \-\-override\-reason waiver or a \-\-reason
 .TP
-\fB\-\-session\-id\fR \fI<SESSION_ID>\fR
+\fB\-\-session\fR \fI<SESSION_ID>\fR
 The acting session (recorded as actor.session_id); optional
 .TP
 \fB\-\-repo\fR \fI<DIR>\fR
@@ -77,4 +77,4 @@ Print version
 <\fISUBJECT_ID\fR>
 The subject to move
 .SH VERSION
-v0.29.0
+v0.31.0