@journeykit/canon 0.21.0 → 0.21.1

package/dist/skills/reference/canon-authoring.md

@@ -110,6 +110,9 @@ Fix it and the next command indexes the files (see `canon-inventory`).
 
 - `--actor <id>` (or `CANON_ACTOR` in the environment) puts YOUR id on the
   provenance line. Default is `canon-scaffold`.
+- **Keep the `# canon:` lines when you fill in the scenario.** Dropping one
+  makes `canon inventory sync` abort on `missing-provenance`; restore it
+  from git history or a sibling scenario (the error shows its shape).
 - **Never hand-type, move, or edit a `# canon:` line.** The scaffold
   writes it directly above the scenario's tags:
 

package/dist/skills/reference/canon-subject.md

@@ -265,11 +265,13 @@ canon subject status: reopened `demo-subject` from shipped, recorded by `impl`:
 canon subject status: demo-subject → verifying — written directly; nothing to promote
 ```
 
-- `--reason "<one line>"` is required for `shipped → verifying` and
-  refused on any other transition (exit 2, as is a blank one). The new
-  record carries it with the actor and the change the work goes into:
+- `--reason "<one line>"` is required for `shipped → verifying` (exit 2
+  without it, as for a blank one) and optional on every other transition,
+  where it is an audit note. The new record carries it with the actor as
+  `status_reason: { reason: …, actor: { agent_id: impl } }`; a reopen also
+  records the change the work goes into:
   `reopen: { reason: …, change: c-demo, actor: { agent_id: impl } }`. The
-  next status write clears it, as it clears a waiver.
+  next status write clears both, as it clears a waiver.
 - Inside the approved scope it needs no human: the subject's newest
   adopted change's brief is approved, or there is no brief to answer.
   Otherwise it refuses, exit 1, naming the brief to approve, and

package/dist/skills/reference/role-implementer.md

@@ -39,7 +39,8 @@ After the first `status`, follow `meta.next` of each write; do not call
    violation or a duplicate id: it names each problem). Specs live at
    `<root>/kind=feature/area=<area>/<surface>.feature` under a `specs.roots[]`
    root (default `.canon/specs`); `reference/canon-authoring.md` has the
-   scaffold.
+   scaffold. When you fill in a scenario, keep its `# canon: {...}` provenance
+   lines: dropping one aborts `inventory sync` on `missing-provenance`.
 2. **Units.** Give each unit its own actor id and session id and pass them on
    everything it records. A delegated unit attests its own work; never attest
    another unit's work under your id.

package/dist/skills/reference/role-orchestrator.md

@@ -12,7 +12,7 @@ Every line is complete; fill the `<placeholders>`.
 canon status --as orchestrator --json --fields next,waitingOn   # at the start and when resuming
 canon brief approve --change <slug> --by "<the human>" --note "<their words>" --as orchestrator --json
 canon subject status <subject-id> --to <proposed|specced|building|verifying|shipped> --actor-id <unit> --as orchestrator --json
-canon subject status <subject-id> --to verifying --reason "<why>" --actor-id <unit> --as orchestrator --json   # follow-up on a shipped subject
+canon subject status <subject-id> --to verifying --reason "<why>" --actor-id <unit> --as orchestrator --json   # reopen a shipped subject (--reason is required here; any other transition accepts it as a note)
 canon gate check --as orchestrator --json
 ```
 

package/package.json

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