@journeykit/canon 0.30.0 → 0.32.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.32.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.32.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.30.0" 
+.TH canon-selftest 1  "selftest 0.32.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.30.0
+v0.32.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.30.0" 
+.TH canon-skills-check 1  "check 0.32.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.30.0
+v0.32.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.30.0" 
+.TH canon-skills-doctor 1  "doctor 0.32.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.30.0
+v0.32.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.30.0" 
+.TH canon-skills-install 1  "install 0.32.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.30.0
+v0.32.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.30.0" 
+.TH canon-skills-show 1  "show 0.32.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.30.0
+v0.32.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.30.0" 
+.TH canon-skills 1  "skills 0.32.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.30.0
+v0.32.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.30.0" 
+.TH canon-status 1  "status 0.32.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.30.0
+v0.32.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.30.0" 
+.TH canon-strategy-approval-payload 1  "approval-payload 0.32.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.30.0
+v0.32.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.30.0" 
+.TH canon-strategy-promote 1  "promote 0.32.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.30.0
+v0.32.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.30.0" 
+.TH canon-strategy-rollback 1  "rollback 0.32.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.30.0
+v0.32.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.30.0" 
+.TH canon-strategy 1  "strategy 0.32.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.30.0
+v0.32.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.30.0" 
+.TH canon-subject-adopt 1  "adopt 0.32.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.30.0
+v0.32.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.30.0" 
+.TH canon-subject-move 1  "move 0.32.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.30.0
+v0.32.0

package/man/canon-subject-new.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-subject-new 1  "new 0.30.0" 
+.TH canon-subject-new 1  "new 0.32.0" 
 .SH NAME
 canon\-subject\-new \- Author a new subject at status `proposed`
 .SH SYNOPSIS
-\fBcanon subject new\fR [\fB\-\-as\fR] <\fB\-\-domain\fR> <\fB\-\-title\fR> [\fB\-\-summary\fR] [\fB\-\-owner\-role\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 new\fR [\fB\-\-as\fR] <\fB\-\-domain\fR> <\fB\-\-title\fR> [\fB\-\-summary\fR] [\fB\-\-owner\-role\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
 Author a new subject at status `proposed`
 .SH OPTIONS
@@ -38,10 +38,10 @@ The subject\*(Aqs summary (optional)
 \fB\-\-owner\-role\fR \fI<ROLE>\fR [default: implementer]
 The accountable owning role (default: implementer)
 .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
 .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
@@ -62,4 +62,4 @@ Print version
 <\fISUBJECT_ID\fR>
 The subject\*(Aqs kebab\-slug id
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-subject-show.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-subject-show 1  "show 0.30.0" 
+.TH canon-subject-show 1  "show 0.32.0" 
 .SH NAME
 canon\-subject\-show \- Show a subject (read\-only)
 .SH SYNOPSIS
@@ -41,4 +41,4 @@ Print version
 <\fISUBJECT_ID\fR>
 The subject to show
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-subject-unadopt.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-subject-unadopt 1  "unadopt 0.30.0" 
+.TH canon-subject-unadopt 1  "unadopt 0.32.0" 
 .SH NAME
 canon\-subject\-unadopt \- Take a change back out of a subject (the mirror of adopt; refused for a change whose brief is approved)
 .SH SYNOPSIS
-\fBcanon subject unadopt\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 unadopt\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
 Take a change back out of a subject (the mirror of adopt; refused for a change whose brief is approved)
 .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 change to take out of the subject
 .TP
 \fB\-\-repo\fR \fI<DIR>\fR
@@ -51,7 +51,7 @@ Print version
 The subject to take the change out of
 .SH EXTRA
 Examples:
-  canon subject unadopt demo \-\-change\-id add\-login
+  canon subject unadopt demo \-\-change add\-login
 
 Removes the link on both sides (the subject\*(Aqs change list and the change\*(Aqs
 subject list). The change and its brief stay and can be adopted elsewhere, for
@@ -60,4 +60,4 @@ change whose brief carries an `Approved:` line: it is the subject\*(Aqs approved
 scope, and for a change a scenario the subject owns is tagged
 `@flow:<change>.*` for (remove or retag it first). A pair that is not linked writes nothing and exits 0.
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-subject.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-subject 1  "subject 0.30.0" 
+.TH canon-subject 1  "subject 0.32.0" 
 .SH NAME
 canon\-subject \- Create and manage subjects (durable product units)
 .SH SYNOPSIS
@@ -48,4 +48,4 @@ Show a subject (read\-only)
 canon\-subject\-move(1)
 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 VERSION
-v0.30.0
+v0.32.0

package/man/canon-task-done.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-task-done 1  "done 0.30.0" 
+.TH canon-task-done 1  "done 0.32.0" 
 .SH NAME
 canon\-task\-done \- Flip one task checkbox, gated on real evidence (fails closed)
 .SH SYNOPSIS
@@ -44,4 +44,4 @@ Print version
 <\fITASK_ID\fR>
 The task id (<change_id>#<n>)
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-task.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-task 1  "task 0.30.0" 
+.TH canon-task 1  "task 0.32.0" 
 .SH NAME
 canon\-task \- Flip a plan task\*(Aqs checkbox once committed evidence supports it
 .SH SYNOPSIS
@@ -39,4 +39,4 @@ Flip one task checkbox, gated on real evidence (fails closed)
 Examples:
   canon task done my\-change#3
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-tier-age.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-tier-age 1  "age 0.30.0" 
+.TH canon-tier-age 1  "age 0.32.0" 
 .SH NAME
 canon\-tier\-age \- Apply canon.yaml aging rules, moving old records to their destination tier
 .SH SYNOPSIS
@@ -47,4 +47,4 @@ Print help
 \fB\-V\fR, \fB\-\-version\fR
 Print version
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-tier.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon-tier 1  "tier 0.30.0" 
+.TH canon-tier 1  "tier 0.32.0" 
 .SH NAME
 canon\-tier \- Age records between storage tiers
 .SH SYNOPSIS
@@ -36,4 +36,4 @@ Print version
 canon\-tier\-age(1)
 Apply canon.yaml aging rules, moving old records to their destination tier
 .SH VERSION
-v0.30.0
+v0.32.0

package/man/canon-trace.1

@@ -0,0 +1,56 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH canon-trace 1  "trace 0.32.0" 
+.SH NAME
+canon\-trace \- Follow a finding\*(Aqs review loop in time order: review, finding, fix, re\-review, evidence
+.SH SYNOPSIS
+\fBcanon trace\fR [\fB\-\-as\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fIID\fR> 
+.SH DESCRIPTION
+Follow a finding\*(Aqs review loop in time order: review, finding, fix, re\-review, evidence
+.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\-\-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
+<\fIID\fR>
+A review id (26 characters), a commit sha (7 to 40 hex digits, the first characters are enough) or a finding key (`<change>_<round>_<seq>`, as `canon query \-\-kind finding` shows it)
+.SH EXTRA
+Examples:
+  canon trace s43\-findings\-are\-records_1_2
+  canon trace 5fa1e16 \-\-json
+  canon trace 01J9ZXQ4M2K7V8R3T5W6Y0N1PA
+
+The operand is a finding key, a commit sha (the first 7 or more characters) or a review id. The
+chain holds every record joined to it by the review loop (the review that raised a finding, the
+refix commit, the re\-review pinned at it, the evidence at those commits), one entry per version,
+the ledger archive\*(Aqs old versions included, oldest first. Reads the same derived index as
+`canon search`. Exit 2 for an id no record says, an ambiguous sha prefix or an operand of none
+of the three shapes.
+.SH VERSION
+v0.32.0

package/man/canon.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH canon 1  "canon 0.30.0" 
+.TH canon 1  "canon 0.32.0" 
 .SH NAME
 canon \- Specs, evidence gates, and agent memory for your repo
 .SH SYNOPSIS
@@ -120,6 +120,12 @@ Build a canonical regime key for hook scripts
 canon\-query(1)
 Read stored records across every storage tier
 .TP
+canon\-search(1)
+Search records, brief sections and scenario text, with each hit\*(Aqs neighbors in the record graph
+.TP
+canon\-trace(1)
+Follow a finding\*(Aqs review loop in time order: review, finding, fix, re\-review, evidence
+.TP
 canon\-export(1)
 Export a redacted retention manifest without deleting records
 .TP
@@ -166,4 +172,4 @@ Learn more:
   plus the script sidecar; `skills check` and `skills doctor` inspect the
   target without deleting user files.
 .SH VERSION
-v0.30.0
+v0.32.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@journeykit/canon",
-  "version": "0.30.0",
+  "version": "0.32.0",
   "description": "canon — harness knowledge substrate. JS launcher: platform detection + native binary resolution.",
   "license": "MIT",
   "type": "module",
@@ -34,9 +34,9 @@
   },
   "dependencies": {},
   "optionalDependencies": {
-    "@journeykit/canon-core-darwin-arm64": "0.30.0",
-    "@journeykit/canon-core-linux-x64": "0.30.0",
-    "@journeykit/canon-core-win32-x64": "0.30.0"
+    "@journeykit/canon-core-darwin-arm64": "0.32.0",
+    "@journeykit/canon-core-linux-x64": "0.32.0",
+    "@journeykit/canon-core-win32-x64": "0.32.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",