@journeykit/canon 0.37.0 → 0.38.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/dist/skills/SKILL.src.md +22 -11
  2. package/dist/skills/reference/canon-gate.md +30 -1
  3. package/dist/skills/reference/canon-review.md +10 -1
  4. package/dist/skills/reference/canon-storage.md +29 -3
  5. package/dist/skills/reference/role-implementer.md +4 -3
  6. package/dist/skills/reference/role-orchestrator.md +20 -10
  7. package/dist/skills/reference/role-planner.md +1 -1
  8. package/dist/skills/reference/role-reviewer.md +4 -1
  9. package/man/canon-adapter-authorize.1 +2 -2
  10. package/man/canon-adapter-validate.1 +2 -2
  11. package/man/canon-adapter.1 +2 -2
  12. package/man/canon-artifacts-move.1 +2 -2
  13. package/man/canon-artifacts-prune.1 +75 -0
  14. package/man/canon-artifacts-store.1 +2 -2
  15. package/man/canon-artifacts-verify.1 +2 -2
  16. package/man/canon-artifacts.1 +5 -2
  17. package/man/canon-brief-approve.1 +2 -2
  18. package/man/canon-brief-check.1 +2 -2
  19. package/man/canon-brief-show.1 +2 -2
  20. package/man/canon-brief.1 +2 -2
  21. package/man/canon-change-new.1 +2 -2
  22. package/man/canon-change.1 +2 -2
  23. package/man/canon-completion.1 +2 -2
  24. package/man/canon-context-pack-add.1 +2 -2
  25. package/man/canon-context-pack-show.1 +2 -2
  26. package/man/canon-context-pack-verify.1 +2 -2
  27. package/man/canon-context-pack.1 +2 -2
  28. package/man/canon-context.1 +2 -2
  29. package/man/canon-dashboard.1 +2 -2
  30. package/man/canon-demo-init.1 +2 -2
  31. package/man/canon-demo-review.1 +2 -2
  32. package/man/canon-demo.1 +2 -2
  33. package/man/canon-dispatch-begin.1 +3 -3
  34. package/man/canon-dispatch-diff.1 +2 -2
  35. package/man/canon-dispatch-end.1 +2 -2
  36. package/man/canon-dispatch.1 +2 -2
  37. package/man/canon-divergence-accept.1 +2 -2
  38. package/man/canon-divergence-add.1 +2 -2
  39. package/man/canon-divergence-defer.1 +2 -2
  40. package/man/canon-divergence-list.1 +2 -2
  41. package/man/canon-divergence-resolve.1 +2 -2
  42. package/man/canon-divergence.1 +2 -2
  43. package/man/canon-evidence-add.1 +2 -2
  44. package/man/canon-evidence-approval-payload.1 +2 -2
  45. package/man/canon-evidence-audit.1 +3 -3
  46. package/man/canon-evidence.1 +2 -2
  47. package/man/canon-export.1 +2 -2
  48. package/man/canon-feature-new.1 +2 -2
  49. package/man/canon-feature.1 +2 -2
  50. package/man/canon-finding-add.1 +2 -2
  51. package/man/canon-finding-close.1 +4 -4
  52. package/man/canon-finding-list.1 +3 -3
  53. package/man/canon-finding.1 +2 -2
  54. package/man/canon-format.1 +2 -2
  55. package/man/canon-gate-check.1 +2 -2
  56. package/man/canon-gate-install-hooks.1 +2 -2
  57. package/man/canon-gate-promote.1 +2 -2
  58. package/man/canon-gate.1 +2 -2
  59. package/man/canon-ingest-plans.1 +2 -2
  60. package/man/canon-ingest-records.1 +2 -2
  61. package/man/canon-ingest-sessions.1 +2 -2
  62. package/man/canon-ingest.1 +2 -2
  63. package/man/canon-init.1 +28 -10
  64. package/man/canon-inventory-sync.1 +2 -2
  65. package/man/canon-inventory.1 +2 -2
  66. package/man/canon-ledger-compact.1 +2 -2
  67. package/man/canon-ledger.1 +2 -2
  68. package/man/canon-migrate.1 +2 -2
  69. package/man/canon-plugin-sync.1 +2 -2
  70. package/man/canon-plugin.1 +2 -2
  71. package/man/canon-policy-approve.1 +2 -2
  72. package/man/canon-policy-show.1 +2 -2
  73. package/man/canon-policy.1 +2 -2
  74. package/man/canon-prompt-add.1 +2 -2
  75. package/man/canon-prompt-show.1 +2 -2
  76. package/man/canon-prompt.1 +2 -2
  77. package/man/canon-purge.1 +2 -2
  78. package/man/canon-query.1 +2 -2
  79. package/man/canon-regime-show.1 +2 -2
  80. package/man/canon-regime.1 +2 -2
  81. package/man/canon-report-build.1 +2 -2
  82. package/man/canon-report-check.1 +2 -2
  83. package/man/canon-report-snapshot.1 +2 -2
  84. package/man/canon-report.1 +2 -2
  85. package/man/canon-retrieve.1 +2 -2
  86. package/man/canon-review-change.1 +2 -2
  87. package/man/canon-review-scenario.1 +2 -2
  88. package/man/canon-review.1 +2 -2
  89. package/man/canon-scenario-new.1 +2 -2
  90. package/man/canon-scenario.1 +2 -2
  91. package/man/canon-schema.1 +2 -2
  92. package/man/canon-search.1 +2 -2
  93. package/man/canon-selftest.1 +2 -2
  94. package/man/canon-skills-check.1 +22 -5
  95. package/man/canon-skills-doctor.1 +24 -7
  96. package/man/canon-skills-install.1 +22 -5
  97. package/man/canon-skills-show.1 +2 -2
  98. package/man/canon-skills.1 +3 -3
  99. package/man/canon-status.1 +2 -2
  100. package/man/canon-strategy-approval-payload.1 +2 -2
  101. package/man/canon-strategy-promote.1 +2 -2
  102. package/man/canon-strategy-rollback.1 +3 -3
  103. package/man/canon-strategy.1 +2 -2
  104. package/man/canon-subject-adopt.1 +2 -2
  105. package/man/canon-subject-move.1 +2 -2
  106. package/man/canon-subject-new.1 +2 -2
  107. package/man/canon-subject-show.1 +2 -2
  108. package/man/canon-subject-unadopt.1 +2 -2
  109. package/man/canon-subject.1 +2 -2
  110. package/man/canon-task-done.1 +2 -2
  111. package/man/canon-task.1 +2 -2
  112. package/man/canon-tier-age.1 +2 -2
  113. package/man/canon-tier.1 +2 -2
  114. package/man/canon-trace.1 +4 -4
  115. package/man/canon.1 +3 -3
  116. package/package.json +4 -4
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-skills-show 1 "show 0.37.0"
3
+ .TH canon-skills-show 1 "show 0.38.0"
4
4
  .SH NAME
5
5
  canon\-skills\-show \- Print a guide built into this binary (markdown on stdout); the installed SKILL.md is a stub that points here
6
6
  .SH SYNOPSIS
@@ -101,4 +101,4 @@ role\-planner
101
101
  role\-reviewer
102
102
  .RE
103
103
  .SH VERSION
104
- v0.37.0
104
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-skills 1 "skills 0.37.0"
3
+ .TH canon-skills 1 "skills 0.38.0"
4
4
  .SH NAME
5
5
  canon\-skills \- Install canon\*(Aqs agent guides into a repo
6
6
  .SH SYNOPSIS
@@ -40,9 +40,9 @@ canon\-skills\-check(1)
40
40
  Check canonical projections without writing; exit 1 on drift, a legacy remnant, or a lock another canon version wrote
41
41
  .TP
42
42
  canon\-skills\-doctor(1)
43
- 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
43
+ Print diagnostics for canonical projections, the install lock\*(Aqs canon version, legacy remnants, canon projections for a harness that is not selected, and other skills whose description claims build work; reports only, never edits
44
44
  .TP
45
45
  canon\-skills\-show(1)
46
46
  Print a guide built into this binary (markdown on stdout); the installed SKILL.md is a stub that points here
47
47
  .SH VERSION
48
- v0.37.0
48
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-status 1 "status 0.37.0"
3
+ .TH canon-status 1 "status 0.38.0"
4
4
  .SH NAME
5
5
  canon\-status \- Show where this repo stands: subjects by status, their gaps, and the next commands
6
6
  .SH SYNOPSIS
@@ -53,4 +53,4 @@ scenarios, with an `Approved:` line, or a chore; each has a status (approved,
53
53
  unapproved, changed) and a reason. A never\-approved untagged feature change is a
54
54
  pending draft (`pendingDrafts`) and blocks nothing. `statusVersion` is 4.
55
55
  .SH VERSION
56
- v0.37.0
56
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-strategy-approval-payload 1 "approval-payload 0.37.0"
3
+ .TH canon-strategy-approval-payload 1 "approval-payload 0.38.0"
4
4
  .SH NAME
5
5
  canon\-strategy\-approval\-payload \- The unsigned approval payload bytes an external signer signs (a read: identical arguments give identical bytes)
6
6
  .SH SYNOPSIS
@@ -50,4 +50,4 @@ Print version
50
50
  <\fISTRATEGY_ID\fR>
51
51
  The StrategyId (ULID) whose approval payload to print
52
52
  .SH VERSION
53
- v0.37.0
53
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-strategy-promote 1 "promote 0.37.0"
3
+ .TH canon-strategy-promote 1 "promote 0.38.0"
4
4
  .SH NAME
5
5
  canon\-strategy\-promote \- Promote a strategy after paired evaluation and signed approval
6
6
  .SH SYNOPSIS
@@ -56,4 +56,4 @@ Print version
56
56
  <\fISTRATEGY_ID\fR>
57
57
  The StrategyId (ULID) to promote
58
58
  .SH VERSION
59
- v0.37.0
59
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-strategy-rollback 1 "rollback 0.37.0"
3
+ .TH canon-strategy-rollback 1 "rollback 0.38.0"
4
4
  .SH NAME
5
5
  canon\-strategy\-rollback \- Disable an active strategy with durable rollback provenance
6
6
  .SH SYNOPSIS
@@ -38,7 +38,7 @@ Detached signature file over the rollback payload
38
38
  \fB\-\-approval\-at\fR \fI<TIMESTAMP>\fR
39
39
  When the approver signed: an RFC 3339 date\-time (`2030\-01\-01T10:00:00Z`; a date alone is refused), the value the signature was made over
40
40
  .TP
41
- \fB\-\-contradicting\-trajectory\fR \fI<ID>\fR
41
+ \fB\-\-contradicting\-trajectory\fR \fI<TRAJECTORY_ID>\fR
42
42
  A trajectory that contradicts the strategy (must exist in the trajectory store)
43
43
  .TP
44
44
  \fB\-\-repo\fR \fI<DIR>\fR
@@ -59,4 +59,4 @@ Print version
59
59
  <\fISTRATEGY_ID\fR>
60
60
  The StrategyId (ULID) to roll back
61
61
  .SH VERSION
62
- v0.37.0
62
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-strategy 1 "strategy 0.37.0"
3
+ .TH canon-strategy 1 "strategy 0.38.0"
4
4
  .SH NAME
5
5
  canon\-strategy \- Promote a proven strategy into the git\-tracked tier
6
6
  .SH SYNOPSIS
@@ -42,4 +42,4 @@ The unsigned approval payload bytes an external signer signs (a read: identical
42
42
  canon\-strategy\-rollback(1)
43
43
  Disable an active strategy with durable rollback provenance
44
44
  .SH VERSION
45
- v0.37.0
45
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-subject-adopt 1 "adopt 0.37.0"
3
+ .TH canon-subject-adopt 1 "adopt 0.38.0"
4
4
  .SH NAME
5
5
  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)
6
6
  .SH SYNOPSIS
@@ -50,4 +50,4 @@ Print version
50
50
  <\fISUBJECT_ID\fR>
51
51
  The subject to adopt the change under
52
52
  .SH VERSION
53
- v0.37.0
53
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-subject-move 1 "move 0.37.0"
3
+ .TH canon-subject-move 1 "move 0.38.0"
4
4
  .SH NAME
5
5
  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)
6
6
  .SH SYNOPSIS
@@ -77,4 +77,4 @@ Print version
77
77
  <\fISUBJECT_ID\fR>
78
78
  The subject to move
79
79
  .SH VERSION
80
- v0.37.0
80
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-subject-new 1 "new 0.37.0"
3
+ .TH canon-subject-new 1 "new 0.38.0"
4
4
  .SH NAME
5
5
  canon\-subject\-new \- Author a new subject at status `proposed`
6
6
  .SH SYNOPSIS
@@ -62,4 +62,4 @@ Print version
62
62
  <\fISUBJECT_ID\fR>
63
63
  The subject\*(Aqs kebab\-slug id
64
64
  .SH VERSION
65
- v0.37.0
65
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-subject-show 1 "show 0.37.0"
3
+ .TH canon-subject-show 1 "show 0.38.0"
4
4
  .SH NAME
5
5
  canon\-subject\-show \- Show a subject (read\-only)
6
6
  .SH SYNOPSIS
@@ -41,4 +41,4 @@ Print version
41
41
  <\fISUBJECT_ID\fR>
42
42
  The subject to show
43
43
  .SH VERSION
44
- v0.37.0
44
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-subject-unadopt 1 "unadopt 0.37.0"
3
+ .TH canon-subject-unadopt 1 "unadopt 0.38.0"
4
4
  .SH NAME
5
5
  canon\-subject\-unadopt \- Take a change back out of a subject (the mirror of adopt; refused for a change whose brief is approved)
6
6
  .SH SYNOPSIS
@@ -60,4 +60,4 @@ change whose brief carries an `Approved:` line: it is the subject\*(Aqs approved
60
60
  scope, and for a change a scenario the subject owns is tagged
61
61
  `@flow:<change>.*` for (remove or retag it first). A pair that is not linked writes nothing and exits 0.
62
62
  .SH VERSION
63
- v0.37.0
63
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-subject 1 "subject 0.37.0"
3
+ .TH canon-subject 1 "subject 0.38.0"
4
4
  .SH NAME
5
5
  canon\-subject \- Create and manage subjects (durable product units)
6
6
  .SH SYNOPSIS
@@ -48,4 +48,4 @@ Show a subject (read\-only)
48
48
  canon\-subject\-move(1)
49
49
  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)
50
50
  .SH VERSION
51
- v0.37.0
51
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-task-done 1 "done 0.37.0"
3
+ .TH canon-task-done 1 "done 0.38.0"
4
4
  .SH NAME
5
5
  canon\-task\-done \- Flip one task checkbox, gated on real evidence (fails closed)
6
6
  .SH SYNOPSIS
@@ -44,4 +44,4 @@ Print version
44
44
  <\fITASK_ID\fR>
45
45
  The task id (<change_id>#<n>)
46
46
  .SH VERSION
47
- v0.37.0
47
+ v0.38.0
package/man/canon-task.1 CHANGED
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-task 1 "task 0.37.0"
3
+ .TH canon-task 1 "task 0.38.0"
4
4
  .SH NAME
5
5
  canon\-task \- Flip a plan task\*(Aqs checkbox once committed evidence supports it
6
6
  .SH SYNOPSIS
@@ -39,4 +39,4 @@ Flip one task checkbox, gated on real evidence (fails closed)
39
39
  Examples:
40
40
  canon task done my\-change#3
41
41
  .SH VERSION
42
- v0.37.0
42
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-tier-age 1 "age 0.37.0"
3
+ .TH canon-tier-age 1 "age 0.38.0"
4
4
  .SH NAME
5
5
  canon\-tier\-age \- Apply canon.yaml aging rules, moving old records to their destination tier
6
6
  .SH SYNOPSIS
@@ -47,4 +47,4 @@ Print help
47
47
  \fB\-V\fR, \fB\-\-version\fR
48
48
  Print version
49
49
  .SH VERSION
50
- v0.37.0
50
+ v0.38.0
package/man/canon-tier.1 CHANGED
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-tier 1 "tier 0.37.0"
3
+ .TH canon-tier 1 "tier 0.38.0"
4
4
  .SH NAME
5
5
  canon\-tier \- Age records between storage tiers
6
6
  .SH SYNOPSIS
@@ -36,4 +36,4 @@ Print version
36
36
  canon\-tier\-age(1)
37
37
  Apply canon.yaml aging rules, moving old records to their destination tier
38
38
  .SH VERSION
39
- v0.37.0
39
+ v0.38.0
package/man/canon-trace.1 CHANGED
@@ -1,10 +1,10 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-trace 1 "trace 0.37.0"
3
+ .TH canon-trace 1 "trace 0.38.0"
4
4
  .SH NAME
5
5
  canon\-trace \- Follow a finding\*(Aqs review loop in time order: review, finding, fix, re\-review, evidence
6
6
  .SH SYNOPSIS
7
- \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>
7
+ \fBcanon trace\fR [\fB\-\-as\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fITRACE_ID\fR>
8
8
  .SH DESCRIPTION
9
9
  Follow a finding\*(Aqs review loop in time order: review, finding, fix, re\-review, evidence
10
10
  .SH OPTIONS
@@ -38,7 +38,7 @@ Print help
38
38
  \fB\-V\fR, \fB\-\-version\fR
39
39
  Print version
40
40
  .TP
41
- <\fIID\fR>
41
+ <\fITRACE_ID\fR>
42
42
  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)
43
43
  .SH EXTRA
44
44
  Examples:
@@ -53,4 +53,4 @@ the ledger archive\*(Aqs old versions included, oldest first. Reads the same der
53
53
  `canon search`. Exit 2 for an id no record says, an ambiguous sha prefix or an operand of none
54
54
  of the three shapes.
55
55
  .SH VERSION
56
- v0.37.0
56
+ v0.38.0
package/man/canon.1 CHANGED
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon 1 "canon 0.37.0"
3
+ .TH canon 1 "canon 0.38.0"
4
4
  .SH NAME
5
5
  canon \- Specs, evidence gates, and agent memory for your repo
6
6
  .SH SYNOPSIS
@@ -168,8 +168,8 @@ Examples:
168
168
  Learn more:
169
169
  Use `canon <command> \-\-help` for details on any command.
170
170
  `canon skills show canon` prints the guide built into this binary;
171
- `canon skills install` writes a short stub of it per selected provider,
171
+ `canon skills install` writes a short stub of it per selected harness,
172
172
  plus the script sidecar; `skills check` and `skills doctor` inspect the
173
173
  target without deleting user files.
174
174
  .SH VERSION
175
- v0.37.0
175
+ v0.38.0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@journeykit/canon",
3
- "version": "0.37.0",
3
+ "version": "0.38.0",
4
4
  "description": "canon — harness knowledge substrate. JS launcher: platform detection + native binary resolution.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -34,9 +34,9 @@
34
34
  },
35
35
  "dependencies": {},
36
36
  "optionalDependencies": {
37
- "@journeykit/canon-core-darwin-arm64": "0.37.0",
38
- "@journeykit/canon-core-linux-x64": "0.37.0",
39
- "@journeykit/canon-core-win32-x64": "0.37.0"
37
+ "@journeykit/canon-core-darwin-arm64": "0.38.0",
38
+ "@journeykit/canon-core-linux-x64": "0.38.0",
39
+ "@journeykit/canon-core-win32-x64": "0.38.0"
40
40
  },
41
41
  "devDependencies": {
42
42
  "@types/node": "^20.0.0",