@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
package/man/canon-init.1 CHANGED
@@ -1,10 +1,10 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-init 1 "init 0.37.0"
3
+ .TH canon-init 1 "init 0.38.0"
4
4
  .SH NAME
5
5
  canon\-init \- Set up canon in a repo (canon.yaml, a starter policy, the AGENTS.md block, a plans home)
6
6
  .SH SYNOPSIS
7
- \fBcanon init\fR [\fB\-\-as\fR] [\fB\-\-repo\fR] [\fB\-\-check\fR] [\fB\-\-no\-agents\-md\fR] [\fB\-\-policy\fR] [\fB\-\-no\-policy\fR] [\fB\-\-providers\fR] [\fB\-\-language\fR] [\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR]
7
+ \fBcanon init\fR [\fB\-\-as\fR] [\fB\-\-repo\fR] [\fB\-\-check\fR] [\fB\-\-no\-agents\-md\fR] [\fB\-\-policy\fR] [\fB\-\-no\-policy\fR] [\fB\-\-harness\fR] [\fB\-\-no\-harness\fR] [\fB\-\-language\fR] [\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR]
8
8
  .SH DESCRIPTION
9
9
  Set up canon in a repo (canon.yaml, a starter policy, the AGENTS.md block, a plans home)
10
10
  .SH OPTIONS
@@ -53,8 +53,25 @@ strict: Standard, plus independent review
53
53
  \fB\-\-no\-policy\fR
54
54
  Do not write the starter .canon/policy.yaml
55
55
  .TP
56
- \fB\-\-providers\fR \fI<LIST>\fR
57
- Harnesses to install the canon skill for, without asking: `none`, or `claude`, `codex`, `omp`, `pi` in lowercase joined by single commas (no space, no empty item)
56
+ \fB\-\-harness\fR \fI<NAME>\fR
57
+ A harness to install the canon skill for, without asking (repeatable, once per name): `claude`, `codex`, `omp` or `pi`. Omitted, and no `\-\-no\-harness`: the detected harnesses
58
+ .br
59
+
60
+ .br
61
+ \fIPossible values:\fR
62
+ .RS 14
63
+ .IP \(bu 2
64
+ claude
65
+ .IP \(bu 2
66
+ codex
67
+ .IP \(bu 2
68
+ omp
69
+ .IP \(bu 2
70
+ pi
71
+ .RE
72
+ .TP
73
+ \fB\-\-no\-harness\fR
74
+ Install the canon skill for no harness: records an empty `skills.providers`
58
75
  .TP
59
76
  \fB\-\-language\fR \fI<TAG>\fR
60
77
  Language the briefs are written in (`en`, `ko`, or any tag: `en` headings, structure rules only); recorded as `language:` in canon.yaml
@@ -77,7 +94,7 @@ Print version
77
94
  Examples:
78
95
  canon init
79
96
  canon init \-\-policy light
80
- canon init \-\-providers claude,codex
97
+ canon init \-\-harness claude \-\-harness codex
81
98
  canon init \-\-no\-agents\-md \-\-no\-policy
82
99
  canon init \-\-check
83
100
 
@@ -86,14 +103,15 @@ scenario; standard adds a `@case:failure` scenario per feature surface; strict
86
103
  adds independent review. The level is the first line of .canon/policy.yaml and
87
104
  `canon status` shows it.
88
105
 
89
- Harnesses (\-\-providers): init never asks. Without \-\-providers it takes the
106
+ Harnesses (\-\-harness, \-\-no\-harness): init never asks. Without either it takes the
90
107
  detected harnesses (.claude, .codex, .omp, .pi directories), on a terminal or
91
108
  not; with none detected it installs nothing and says how to choose. The answer is
92
- recorded as `skills: { providers: [...] }` in canon.yaml (`\-\-providers none`
93
- records `[]`). The list is exact: `none`, or claude, codex, omp, pi in lowercase
94
- joined by single commas, with no space and no empty item.
109
+ recorded as `skills: { providers: [...] }` in canon.yaml (`\-\-no\-harness`
110
+ records `[]`). `\-\-harness` is given once per name, each one of claude, codex, omp or
111
+ pi in lowercase; a name given twice counts once, and `\-\-harness` with `\-\-no\-harness`
112
+ is refused.
95
113
 
96
114
  Rerunning in a repo that has canon.yaml leaves canon.yaml and .canon/policy.yaml
97
115
  alone and only refreshes the canon block in AGENTS.md.
98
116
  .SH VERSION
99
- v0.37.0
117
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-inventory-sync 1 "sync 0.37.0"
3
+ .TH canon-inventory-sync 1 "sync 0.38.0"
4
4
  .SH NAME
5
5
  canon\-inventory\-sync \- Validate each spec root, then materialize scenario index records
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
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-inventory 1 "inventory 0.37.0"
3
+ .TH canon-inventory 1 "inventory 0.38.0"
4
4
  .SH NAME
5
5
  canon\-inventory \- Index a validated .feature corpus into the scenario ledger
6
6
  .SH SYNOPSIS
@@ -36,4 +36,4 @@ Print version
36
36
  canon\-inventory\-sync(1)
37
37
  Validate each spec root, then materialize scenario index records
38
38
  .SH VERSION
39
- v0.37.0
39
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-ledger-compact 1 "compact 0.37.0"
3
+ .TH canon-ledger-compact 1 "compact 0.38.0"
4
4
  .SH NAME
5
5
  canon\-ledger\-compact \- Move superseded versions of every record out of the ledger into the archive
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
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-ledger 1 "ledger 0.37.0"
3
+ .TH canon-ledger 1 "ledger 0.38.0"
4
4
  .SH NAME
5
5
  canon\-ledger \- Keep the ledger to the current version of each record
6
6
  .SH SYNOPSIS
@@ -51,4 +51,4 @@ this is for a ledger written before 0.23, or after an interrupted move. Idempote
51
51
  `canon migrate` runs it. A record that carries a standing claim (a flagged overlay, a
52
52
  brief override, an approval at the current evidence) stays in the ledger.
53
53
  .SH VERSION
54
- v0.37.0
54
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-migrate 1 "migrate 0.37.0"
3
+ .TH canon-migrate 1 "migrate 0.38.0"
4
4
  .SH NAME
5
5
  canon\-migrate \- Bring a repo from an earlier canon up to date: the 0.17 layout (specs, changes, approvals, skills, .gitignore), the 0.28 hooks, scripts and skill stub (backed up under .canon/migrate\-backup/), the 0.23 latest\-only ledger (superseded versions to .canon/archive) and 0.23 review pins
6
6
  .SH SYNOPSIS
@@ -120,4 +120,4 @@ kept. canon.yaml is written atomically.
120
120
  every agent role). `\-\-revert` restores them byte for byte and refuses, naming the file, when one changed
121
121
  since the migrate.
122
122
  .SH VERSION
123
- v0.37.0
123
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-plugin-sync 1 "sync 0.37.0"
3
+ .TH canon-plugin-sync 1 "sync 0.38.0"
4
4
  .SH NAME
5
5
  canon\-plugin\-sync \- Validate and write a plugin\*(Aqs overlay records
6
6
  .SH SYNOPSIS
@@ -50,4 +50,4 @@ Print version
50
50
  <\fIPLUGIN_ID\fR>
51
51
  A .canon/plugins/<id>/plugin.yaml manifest id (e.g. porting)
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-plugin 1 "plugin 0.37.0"
3
+ .TH canon-plugin 1 "plugin 0.38.0"
4
4
  .SH NAME
5
5
  canon\-plugin \- Sync plugin overlay records onto the ledger
6
6
  .SH SYNOPSIS
@@ -36,4 +36,4 @@ Print version
36
36
  canon\-plugin\-sync(1)
37
37
  Validate and write a plugin\*(Aqs overlay records
38
38
  .SH VERSION
39
- v0.37.0
39
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-policy-approve 1 "approve 0.37.0"
3
+ .TH canon-policy-approve 1 "approve 0.38.0"
4
4
  .SH NAME
5
5
  canon\-policy\-approve \- Approve the current .canon/policy.yaml (written directly; nothing to promote)
6
6
  .SH SYNOPSIS
@@ -53,4 +53,4 @@ Print help
53
53
  \fB\-V\fR, \fB\-\-version\fR
54
54
  Print version
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-policy-show 1 "show 0.37.0"
3
+ .TH canon-policy-show 1 "show 0.38.0"
4
4
  .SH NAME
5
5
  canon\-policy\-show \- Show the policy\*(Aqs digest and its approval (who, when, which bytes)
6
6
  .SH SYNOPSIS
@@ -38,4 +38,4 @@ Print help
38
38
  \fB\-V\fR, \fB\-\-version\fR
39
39
  Print version
40
40
  .SH VERSION
41
- v0.37.0
41
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-policy 1 "policy 0.37.0"
3
+ .TH canon-policy 1 "policy 0.38.0"
4
4
  .SH NAME
5
5
  canon\-policy \- Record who approved the gate\*(Aqs policy (.canon/policy.yaml) and which bytes
6
6
  .SH SYNOPSIS
@@ -49,4 +49,4 @@ approval (or whose approval cannot be read) fails closed: `gate check` exits 1
49
49
  and `subject move` refuses to ship or reopen; `\-\-override\-reason` does not
50
50
  waive it. `canon policy show` reads the approval back.
51
51
  .SH VERSION
52
- v0.37.0
52
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-prompt-add 1 "add 0.37.0"
3
+ .TH canon-prompt-add 1 "add 0.38.0"
4
4
  .SH NAME
5
5
  canon\-prompt\-add \- Add a prompt bundle from a repository\-local JSON manifest
6
6
  .SH SYNOPSIS
@@ -44,4 +44,4 @@ Print help
44
44
  <\fINAME@VERSION\fR>
45
45
  The bundle to register, `NAME@VERSION`
46
46
  .SH VERSION
47
- v0.37.0
47
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-prompt-show 1 "show 0.37.0"
3
+ .TH canon-prompt-show 1 "show 0.38.0"
4
4
  .SH NAME
5
5
  canon\-prompt\-show \- Select a registered prompt bundle version
6
6
  .SH SYNOPSIS
@@ -38,4 +38,4 @@ Print help
38
38
  <\fINAME@VERSION\fR>
39
39
  The bundle to show, `NAME@VERSION`
40
40
  .SH VERSION
41
- v0.37.0
41
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-prompt 1 "prompt 0.37.0"
3
+ .TH canon-prompt 1 "prompt 0.38.0"
4
4
  .SH NAME
5
5
  canon\-prompt \- Register and select versioned prompt bundles
6
6
  .SH SYNOPSIS
@@ -40,4 +40,4 @@ Examples:
40
40
  canon prompt add reviewer@v1 \-\-manifest .canon/reviewer.json
41
41
  canon prompt show reviewer@v1 \-\-json
42
42
  .SH VERSION
43
- v0.37.0
43
+ v0.38.0
package/man/canon-purge.1 CHANGED
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-purge 1 "purge 0.37.0"
3
+ .TH canon-purge 1 "purge 0.38.0"
4
4
  .SH NAME
5
5
  canon\-purge \- Remove allowlisted records older than a cutoff: the bare run previews the removal set and its planDigest, `\-\-commit \-\-plan\-digest <PLAN_DIGEST>` deletes it
6
6
  .SH SYNOPSIS
@@ -67,4 +67,4 @@ Print help
67
67
  \fB\-V\fR, \fB\-\-version\fR
68
68
  Print version
69
69
  .SH VERSION
70
- v0.37.0
70
+ v0.38.0
package/man/canon-query.1 CHANGED
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-query 1 "query 0.37.0"
3
+ .TH canon-query 1 "query 0.38.0"
4
4
  .SH NAME
5
5
  canon\-query \- Read stored records across every storage tier
6
6
  .SH SYNOPSIS
@@ -108,4 +108,4 @@ Print help
108
108
  \fB\-V\fR, \fB\-\-version\fR
109
109
  Print version
110
110
  .SH VERSION
111
- v0.37.0
111
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-regime-show 1 "show 0.37.0"
3
+ .TH canon-regime-show 1 "show 0.38.0"
4
4
  .SH NAME
5
5
  canon\-regime\-show \- Build a canonical regime key for hook scripts
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
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-regime 1 "regime 0.37.0"
3
+ .TH canon-regime 1 "regime 0.38.0"
4
4
  .SH NAME
5
5
  canon\-regime \- Build a canonical regime key for hook scripts
6
6
  .SH SYNOPSIS
@@ -36,4 +36,4 @@ Print version
36
36
  canon\-regime\-show(1)
37
37
  Build a canonical regime key for hook scripts
38
38
  .SH VERSION
39
- v0.37.0
39
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-report-build 1 "build 0.37.0"
3
+ .TH canon-report-build 1 "build 0.38.0"
4
4
  .SH NAME
5
5
  canon\-report\-build \- Write the status report (.canon/REPORT.md)
6
6
  .SH SYNOPSIS
@@ -41,4 +41,4 @@ Print help
41
41
  \fB\-V\fR, \fB\-\-version\fR
42
42
  Print version
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-report-check 1 "check 0.37.0"
3
+ .TH canon-report-check 1 "check 0.38.0"
4
4
  .SH NAME
5
5
  canon\-report\-check \- Byte\-diff .canon/REPORT.md against a fresh build (0 fresh, 1 missing or drifted); writes nothing
6
6
  .SH SYNOPSIS
@@ -38,4 +38,4 @@ Print help
38
38
  \fB\-V\fR, \fB\-\-version\fR
39
39
  Print version
40
40
  .SH VERSION
41
- v0.37.0
41
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-report-snapshot 1 "snapshot 0.37.0"
3
+ .TH canon-report-snapshot 1 "snapshot 0.38.0"
4
4
  .SH NAME
5
5
  canon\-report\-snapshot \- Export the panel marts to <DIR>/*.parquet plus manifest.json
6
6
  .SH SYNOPSIS
@@ -44,4 +44,4 @@ Print version
44
44
  <\fIDIR\fR>
45
45
  The output directory (created if absent)
46
46
  .SH VERSION
47
- v0.37.0
47
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-report 1 "report 0.37.0"
3
+ .TH canon-report 1 "report 0.38.0"
4
4
  .SH NAME
5
5
  canon\-report \- Build, check, or snapshot the status report
6
6
  .SH SYNOPSIS
@@ -42,4 +42,4 @@ Byte\-diff .canon/REPORT.md against a fresh build (0 fresh, 1 missing or drifted
42
42
  canon\-report\-snapshot(1)
43
43
  Export the panel marts to <DIR>/*.parquet plus manifest.json
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-retrieve 1 "retrieve 0.37.0"
3
+ .TH canon-retrieve 1 "retrieve 0.38.0"
4
4
  .SH NAME
5
5
  canon\-retrieve \- Fetch role\-scoped strategy guidance
6
6
  .SH SYNOPSIS
@@ -53,4 +53,4 @@ Print help
53
53
  \fB\-V\fR, \fB\-\-version\fR
54
54
  Print version
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-review-change 1 "change 0.37.0"
3
+ .TH canon-review-change 1 "change 0.38.0"
4
4
  .SH NAME
5
5
  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`
6
6
  .SH SYNOPSIS
@@ -95,4 +95,4 @@ Print version
95
95
  <\fICHANGE_ID\fR>
96
96
  The chore change to review
97
97
  .SH VERSION
98
- v0.37.0
98
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-review-scenario 1 "scenario 0.37.0"
3
+ .TH canon-review-scenario 1 "scenario 0.38.0"
4
4
  .SH NAME
5
5
  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)
6
6
  .SH SYNOPSIS
@@ -95,4 +95,4 @@ Print version
95
95
  <\fISCENARIO_ID\fR>
96
96
  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)
97
97
  .SH VERSION
98
- v0.37.0
98
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-review 1 "review 0.37.0"
3
+ .TH canon-review 1 "review 0.38.0"
4
4
  .SH NAME
5
5
  canon\-review \- Record an attributed review verdict
6
6
  .SH SYNOPSIS
@@ -39,4 +39,4 @@ Write one attributed Review record per scenario directly to the ledger, nothing
39
39
  canon\-review\-change(1)
40
40
  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`
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-scenario-new 1 "new 0.37.0"
3
+ .TH canon-scenario-new 1 "new 0.38.0"
4
4
  .SH NAME
5
5
  canon\-scenario\-new \- Append a tagged scenario stub to its .feature file (created if missing); many at once with `\-\-input`
6
6
  .SH SYNOPSIS
@@ -77,4 +77,4 @@ Print version
77
77
  <\fISCENARIO_ID\fR>
78
78
  <area>.<surface>.<nn> scenario tag
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-scenario 1 "scenario 0.37.0"
3
+ .TH canon-scenario 1 "scenario 0.38.0"
4
4
  .SH NAME
5
5
  canon\-scenario \- Add a tagged scenario to a .feature spec file
6
6
  .SH SYNOPSIS
@@ -36,4 +36,4 @@ Print version
36
36
  canon\-scenario\-new(1)
37
37
  Append a tagged scenario stub to its .feature file (created if missing); many at once with `\-\-input`
38
38
  .SH VERSION
39
- v0.37.0
39
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-schema 1 "schema 0.37.0"
3
+ .TH canon-schema 1 "schema 0.38.0"
4
4
  .SH NAME
5
5
  canon\-schema \- Describe canon\*(Aqs own commands: list them, or show one command\*(Aqs arguments, options, effect and exit codes
6
6
  .SH SYNOPSIS
@@ -74,4 +74,4 @@ A command whose effect depends on its arguments carries `effectNote`.
74
74
 
75
75
  The tree holds the options commands share, defined once; a command names them. A command document is its call surface only: members at their default and the options and codes every command has (`\-\-json`, `\-\-input`, `\-\-fields`, `USAGE`, `INTERNAL`, ...) are left out. `\-\-schemas` with a command path prints the JSON Schemas the command\*(Aqs refs reach, `Input` (the schema of one `\-\-input` document) and the `rejects` of its validators.
76
76
  .SH VERSION
77
- v0.37.0
77
+ v0.38.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-search 1 "search 0.37.0"
3
+ .TH canon-search 1 "search 0.38.0"
4
4
  .SH NAME
5
5
  canon\-search \- Search records, brief sections and scenario text, with each hit\*(Aqs neighbors in the record graph
6
6
  .SH SYNOPSIS
@@ -101,4 +101,4 @@ A read that first brings a derived index up to date: .canon/index/search.db, git
101
101
  rebuilt in full when any input changed; deleting it changes nothing but data.index.rebuilt.
102
102
  Exit 0 with empty hits when nothing matches; exit 2 for an empty text.
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-selftest 1 "selftest 0.37.0"
3
+ .TH canon-selftest 1 "selftest 0.38.0"
4
4
  .SH NAME
5
5
  canon\-selftest \- Run canon\*(Aqs built\-in fixture self\-tests
6
6
  .SH SYNOPSIS
@@ -66,4 +66,4 @@ Print help
66
66
  \fB\-V\fR, \fB\-\-version\fR
67
67
  Print version
68
68
  .SH VERSION
69
- v0.37.0
69
+ v0.38.0
@@ -1,10 +1,10 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-skills-check 1 "check 0.37.0"
3
+ .TH canon-skills-check 1 "check 0.38.0"
4
4
  .SH NAME
5
5
  canon\-skills\-check \- Check canonical projections without writing; exit 1 on drift, a legacy remnant, or a lock another canon version wrote
6
6
  .SH SYNOPSIS
7
- \fBcanon skills check\fR [\fB\-\-as\fR] [\fB\-\-skills\-source\fR] [\fB\-\-repo\fR] [\fB\-\-providers\fR] [\fB\-\-json\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR]
7
+ \fBcanon skills check\fR [\fB\-\-as\fR] [\fB\-\-skills\-source\fR] [\fB\-\-repo\fR] [\fB\-\-harness\fR] [\fB\-\-no\-harness\fR] [\fB\-\-json\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR]
8
8
  .SH DESCRIPTION
9
9
  Check canonical projections without writing; exit 1 on drift, a legacy remnant, or a lock another canon version wrote
10
10
  .SH OPTIONS
@@ -32,8 +32,25 @@ Source directory; defaults to CANON_SKILLS_SOURCE or canon/skills
32
32
  \fB\-\-repo\fR \fI<DIR>\fR
33
33
  The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
34
34
  .TP
35
- \fB\-\-providers\fR \fI<LIST>\fR
36
- Providers to inspect: `none`, or `claude`, `codex`, `omp`, `pi` in lowercase joined by single commas (no space, no empty item). Omitted: as for install
35
+ \fB\-\-harness\fR \fI<NAME>\fR
36
+ A harness to inspect (repeatable, once per name): `claude`, `codex`, `omp` or `pi`. Omitted, and no `\-\-no\-harness`: as for install
37
+ .br
38
+
39
+ .br
40
+ \fIPossible values:\fR
41
+ .RS 14
42
+ .IP \(bu 2
43
+ claude
44
+ .IP \(bu 2
45
+ codex
46
+ .IP \(bu 2
47
+ omp
48
+ .IP \(bu 2
49
+ pi
50
+ .RE
51
+ .TP
52
+ \fB\-\-no\-harness\fR
53
+ Inspect no harness: the selection is an empty list
37
54
  .TP
38
55
  \fB\-\-json\fR
39
56
  Output JSON instead of the human\-readable form
@@ -44,4 +61,4 @@ Print help
44
61
  \fB\-V\fR, \fB\-\-version\fR
45
62
  Print version
46
63
  .SH VERSION
47
- v0.37.0
64
+ v0.38.0
@@ -1,12 +1,12 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-skills-doctor 1 "doctor 0.37.0"
3
+ .TH canon-skills-doctor 1 "doctor 0.38.0"
4
4
  .SH NAME
5
- 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
5
+ canon\-skills\-doctor \- 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
6
6
  .SH SYNOPSIS
7
- \fBcanon skills doctor\fR [\fB\-\-as\fR] [\fB\-\-skills\-source\fR] [\fB\-\-repo\fR] [\fB\-\-providers\fR] [\fB\-\-json\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR]
7
+ \fBcanon skills doctor\fR [\fB\-\-as\fR] [\fB\-\-skills\-source\fR] [\fB\-\-repo\fR] [\fB\-\-harness\fR] [\fB\-\-no\-harness\fR] [\fB\-\-json\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR]
8
8
  .SH DESCRIPTION
9
- 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
9
+ 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
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
@@ -32,8 +32,25 @@ Source directory; defaults to CANON_SKILLS_SOURCE or canon/skills
32
32
  \fB\-\-repo\fR \fI<DIR>\fR
33
33
  The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
34
34
  .TP
35
- \fB\-\-providers\fR \fI<LIST>\fR
36
- Providers to inspect: `none`, or `claude`, `codex`, `omp`, `pi` in lowercase joined by single commas (no space, no empty item). Omitted: as for install
35
+ \fB\-\-harness\fR \fI<NAME>\fR
36
+ A harness to inspect (repeatable, once per name): `claude`, `codex`, `omp` or `pi`. Omitted, and no `\-\-no\-harness`: as for install
37
+ .br
38
+
39
+ .br
40
+ \fIPossible values:\fR
41
+ .RS 14
42
+ .IP \(bu 2
43
+ claude
44
+ .IP \(bu 2
45
+ codex
46
+ .IP \(bu 2
47
+ omp
48
+ .IP \(bu 2
49
+ pi
50
+ .RE
51
+ .TP
52
+ \fB\-\-no\-harness\fR
53
+ Inspect no harness: the selection is an empty list
37
54
  .TP
38
55
  \fB\-\-json\fR
39
56
  Output JSON instead of the human\-readable form
@@ -44,4 +61,4 @@ Print help
44
61
  \fB\-V\fR, \fB\-\-version\fR
45
62
  Print version
46
63
  .SH VERSION
47
- v0.37.0
64
+ v0.38.0
@@ -1,10 +1,10 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-skills-install 1 "install 0.37.0"
3
+ .TH canon-skills-install 1 "install 0.38.0"
4
4
  .SH NAME
5
5
  canon\-skills\-install \- Install the canonical `canon` bundle or legacy developer skills
6
6
  .SH SYNOPSIS
7
- \fBcanon skills install\fR [\fB\-\-as\fR] [\fB\-\-skills\-source\fR] [\fB\-\-repo\fR] [\fB\-\-providers\fR] [\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR]
7
+ \fBcanon skills install\fR [\fB\-\-as\fR] [\fB\-\-skills\-source\fR] [\fB\-\-repo\fR] [\fB\-\-harness\fR] [\fB\-\-no\-harness\fR] [\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR]
8
8
  .SH DESCRIPTION
9
9
  Install the canonical `canon` bundle or legacy developer skills
10
10
  .SH OPTIONS
@@ -32,8 +32,25 @@ Developer override: read SKILL.src.md\*(Aqs frontmatter and scripts/ from this d
32
32
  \fB\-\-repo\fR \fI<DIR>\fR
33
33
  The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
34
34
  .TP
35
- \fB\-\-providers\fR \fI<LIST>\fR
36
- Providers to project: `none`, or `claude`, `codex`, `omp`, `pi` in lowercase joined by single commas (no space, no empty item); also rewrites `skills.providers` in the target\*(Aqs canon.yaml. Omitted: canon.yaml `skills.providers`, else the install lock\*(Aqs providers, else the detected `.claude`, `.codex`, `.omp`, `.pi` directories; none detected installs nothing. Codex is projected to `.agents/skills/canon/`
35
+ \fB\-\-harness\fR \fI<NAME>\fR
36
+ A harness to project (repeatable, once per name): `claude`, `codex`, `omp` or `pi`; also rewrites `skills.providers` in the target\*(Aqs canon.yaml. Omitted, and no `\-\-no\-harness`: canon.yaml `skills.providers`, else the install lock\*(Aqs providers, else the detected `.claude`, `.codex`, `.omp`, `.pi` directories; none detected installs nothing. Codex is projected to `.agents/skills/canon/`
37
+ .br
38
+
39
+ .br
40
+ \fIPossible values:\fR
41
+ .RS 14
42
+ .IP \(bu 2
43
+ claude
44
+ .IP \(bu 2
45
+ codex
46
+ .IP \(bu 2
47
+ omp
48
+ .IP \(bu 2
49
+ pi
50
+ .RE
51
+ .TP
52
+ \fB\-\-no\-harness\fR
53
+ Project no harness: records an empty `skills.providers` in the target\*(Aqs canon.yaml and installs nothing
37
54
  .TP
38
55
  \fB\-\-dry\-run\fR
39
56
  Validate fully and report what would be written, without writing anything
@@ -50,4 +67,4 @@ Print help
50
67
  \fB\-V\fR, \fB\-\-version\fR
51
68
  Print version
52
69
  .SH VERSION
53
- v0.37.0
70
+ v0.38.0