@journeykit/canon 0.37.0 → 0.39.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 (119) hide show
  1. package/dist/skills/SKILL.src.md +29 -13
  2. package/dist/skills/reference/canon-artifact-ingest.md +0 -2
  3. package/dist/skills/reference/canon-gate.md +56 -2
  4. package/dist/skills/reference/canon-report-dashboard.md +27 -36
  5. package/dist/skills/reference/canon-review.md +10 -1
  6. package/dist/skills/reference/canon-storage.md +54 -4
  7. package/dist/skills/reference/role-implementer.md +6 -5
  8. package/dist/skills/reference/role-orchestrator.md +28 -23
  9. package/dist/skills/reference/role-planner.md +3 -3
  10. package/dist/skills/reference/role-reviewer.md +6 -3
  11. package/man/canon-adapter-authorize.1 +2 -2
  12. package/man/canon-adapter-validate.1 +2 -2
  13. package/man/canon-adapter.1 +2 -2
  14. package/man/canon-artifacts-move.1 +2 -2
  15. package/man/canon-artifacts-prune.1 +77 -0
  16. package/man/canon-artifacts-store.1 +2 -2
  17. package/man/canon-artifacts-verify.1 +4 -2
  18. package/man/canon-artifacts.1 +5 -2
  19. package/man/canon-brief-approve.1 +2 -2
  20. package/man/canon-brief-check.1 +2 -2
  21. package/man/canon-brief-show.1 +2 -2
  22. package/man/canon-brief.1 +2 -2
  23. package/man/canon-change-new.1 +2 -2
  24. package/man/canon-change.1 +2 -2
  25. package/man/canon-completion.1 +2 -2
  26. package/man/canon-context-pack-add.1 +2 -2
  27. package/man/canon-context-pack-show.1 +2 -2
  28. package/man/canon-context-pack-verify.1 +2 -2
  29. package/man/canon-context-pack.1 +2 -2
  30. package/man/canon-context.1 +2 -2
  31. package/man/canon-dashboard.1 +2 -2
  32. package/man/canon-demo-init.1 +2 -2
  33. package/man/canon-demo-review.1 +2 -2
  34. package/man/canon-demo.1 +2 -2
  35. package/man/canon-dispatch-begin.1 +3 -3
  36. package/man/canon-dispatch-diff.1 +2 -2
  37. package/man/canon-dispatch-end.1 +2 -2
  38. package/man/canon-dispatch.1 +2 -2
  39. package/man/canon-divergence-accept.1 +2 -2
  40. package/man/canon-divergence-add.1 +2 -2
  41. package/man/canon-divergence-defer.1 +2 -2
  42. package/man/canon-divergence-list.1 +2 -2
  43. package/man/canon-divergence-resolve.1 +2 -2
  44. package/man/canon-divergence.1 +2 -2
  45. package/man/canon-evidence-add.1 +3 -3
  46. package/man/canon-evidence-approval-payload.1 +2 -2
  47. package/man/canon-evidence-audit.1 +3 -3
  48. package/man/canon-evidence.1 +2 -2
  49. package/man/canon-export.1 +2 -6
  50. package/man/canon-feature-new.1 +2 -2
  51. package/man/canon-feature.1 +2 -2
  52. package/man/canon-finding-add.1 +2 -2
  53. package/man/canon-finding-close.1 +4 -4
  54. package/man/canon-finding-list.1 +3 -3
  55. package/man/canon-finding.1 +2 -2
  56. package/man/canon-format.1 +2 -2
  57. package/man/canon-gate-check.1 +2 -2
  58. package/man/canon-gate-install-hooks.1 +2 -2
  59. package/man/canon-gate-promote.1 +2 -2
  60. package/man/canon-gate.1 +2 -2
  61. package/man/canon-ingest-plans.1 +2 -2
  62. package/man/canon-ingest-records.1 +2 -2
  63. package/man/canon-ingest.1 +4 -8
  64. package/man/canon-init.1 +28 -10
  65. package/man/canon-inventory-sync.1 +2 -2
  66. package/man/canon-inventory.1 +2 -2
  67. package/man/canon-ledger-compact.1 +2 -2
  68. package/man/canon-ledger.1 +2 -2
  69. package/man/canon-migrate.1 +2 -2
  70. package/man/canon-plugin-sync.1 +2 -2
  71. package/man/canon-plugin.1 +2 -2
  72. package/man/canon-policy-approve.1 +2 -2
  73. package/man/canon-policy-show.1 +2 -2
  74. package/man/canon-policy.1 +2 -2
  75. package/man/canon-prompt-add.1 +2 -2
  76. package/man/canon-prompt-show.1 +2 -2
  77. package/man/canon-prompt.1 +2 -2
  78. package/man/canon-purge.1 +8 -8
  79. package/man/canon-query.1 +2 -6
  80. package/man/canon-regime-show.1 +2 -2
  81. package/man/canon-regime.1 +2 -2
  82. package/man/canon-report-build.1 +2 -2
  83. package/man/canon-report-check.1 +2 -2
  84. package/man/canon-report-snapshot.1 +2 -2
  85. package/man/canon-report.1 +2 -2
  86. package/man/canon-retrieve.1 +2 -2
  87. package/man/canon-review-change.1 +2 -2
  88. package/man/canon-review-scenario.1 +2 -2
  89. package/man/canon-review.1 +2 -2
  90. package/man/canon-scenario-new.1 +2 -2
  91. package/man/canon-scenario.1 +2 -2
  92. package/man/canon-schema.1 +2 -2
  93. package/man/canon-search.1 +2 -6
  94. package/man/canon-selftest.1 +2 -4
  95. package/man/canon-skills-check.1 +22 -5
  96. package/man/canon-skills-doctor.1 +24 -7
  97. package/man/canon-skills-install.1 +22 -5
  98. package/man/canon-skills-show.1 +2 -4
  99. package/man/canon-skills.1 +3 -3
  100. package/man/canon-status.1 +2 -2
  101. package/man/canon-strategy-approval-payload.1 +2 -2
  102. package/man/canon-strategy-promote.1 +2 -2
  103. package/man/canon-strategy-rollback.1 +3 -3
  104. package/man/canon-strategy.1 +2 -2
  105. package/man/canon-subject-adopt.1 +2 -2
  106. package/man/canon-subject-move.1 +2 -2
  107. package/man/canon-subject-new.1 +2 -2
  108. package/man/canon-subject-show.1 +2 -2
  109. package/man/canon-subject-unadopt.1 +2 -2
  110. package/man/canon-subject.1 +2 -2
  111. package/man/canon-task-done.1 +2 -2
  112. package/man/canon-task.1 +2 -2
  113. package/man/canon-tier-age.1 +2 -2
  114. package/man/canon-tier.1 +2 -2
  115. package/man/canon-trace.1 +4 -4
  116. package/man/canon.1 +5 -5
  117. package/package.json +4 -4
  118. package/dist/skills/reference/canon-session-ingest.md +0 -224
  119. package/man/canon-ingest-sessions.1 +0 -62
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.39.0"
4
4
  .SH NAME
5
5
  canon\-query \- Read stored records across every storage tier
6
6
  .SH SYNOPSIS
@@ -40,12 +40,8 @@ task
40
40
  .IP \(bu 2
41
41
  scenario
42
42
  .IP \(bu 2
43
- session
44
- .IP \(bu 2
45
43
  run
46
44
  .IP \(bu 2
47
- event
48
- .IP \(bu 2
49
45
  handoff
50
46
  .IP \(bu 2
51
47
  review
@@ -108,4 +104,4 @@ Print help
108
104
  \fB\-V\fR, \fB\-\-version\fR
109
105
  Print version
110
106
  .SH VERSION
111
- v0.37.0
107
+ v0.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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
@@ -40,12 +40,8 @@ task
40
40
  .IP \(bu 2
41
41
  scenario
42
42
  .IP \(bu 2
43
- session
44
- .IP \(bu 2
45
43
  run
46
44
  .IP \(bu 2
47
- event
48
- .IP \(bu 2
49
45
  handoff
50
46
  .IP \(bu 2
51
47
  review
@@ -101,4 +97,4 @@ A read that first brings a derived index up to date: .canon/index/search.db, git
101
97
  rebuilt in full when any input changed; deleting it changes nothing but data.index.rebuilt.
102
98
  Exit 0 with empty hits when nothing matches; exit 2 for an empty text.
103
99
  .SH VERSION
104
- v0.37.0
100
+ v0.39.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.39.0"
4
4
  .SH NAME
5
5
  canon\-selftest \- Run canon\*(Aqs built\-in fixture self\-tests
6
6
  .SH SYNOPSIS
@@ -44,8 +44,6 @@ policy\-expressions
44
44
  .IP \(bu 2
45
45
  format\-authority
46
46
  .IP \(bu 2
47
- session\-ingest
48
- .IP \(bu 2
49
47
  canon\-context
50
48
  .IP \(bu 2
51
49
  artifact\-ingest
@@ -66,4 +64,4 @@ Print help
66
64
  \fB\-V\fR, \fB\-\-version\fR
67
65
  Print version
68
66
  .SH VERSION
69
- v0.37.0
67
+ v0.39.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.39.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.39.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.39.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.39.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.39.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.39.0
@@ -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.39.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
@@ -84,8 +84,6 @@ canon\-retrieve
84
84
  .IP \(bu 2
85
85
  canon\-review
86
86
  .IP \(bu 2
87
- canon\-session\-ingest
88
- .IP \(bu 2
89
87
  canon\-storage
90
88
  .IP \(bu 2
91
89
  canon\-subject
@@ -101,4 +99,4 @@ role\-planner
101
99
  role\-reviewer
102
100
  .RE
103
101
  .SH VERSION
104
- v0.37.0
102
+ v0.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.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.39.0