@journeykit/canon 0.30.0 → 0.31.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.31.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.31.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.31.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.31.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.31.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.31.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.31.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.31.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.31.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.31.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.31.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.31.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.31.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.31.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.31.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.31.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@journeykit/canon",
-  "version": "0.30.0",
+  "version": "0.31.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.31.0",
+    "@journeykit/canon-core-linux-x64": "0.31.0",
+    "@journeykit/canon-core-win32-x64": "0.31.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",