@journeykit/canon 0.36.0 → 0.37.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 (115) hide show
  1. package/dist/skills/SKILL.src.md +13 -2
  2. package/dist/skills/reference/canon-gate.md +11 -0
  3. package/dist/skills/reference/canon-learn.md +7 -2
  4. package/dist/skills/reference/canon-review.md +5 -3
  5. package/dist/skills/reference/canon-storage.md +2 -2
  6. package/dist/skills/reference/canon-subject.md +5 -4
  7. package/dist/skills/reference/role-implementer.md +3 -1
  8. package/dist/skills/reference/role-reviewer.md +1 -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-store.1 +2 -2
  14. package/man/canon-artifacts-verify.1 +2 -2
  15. package/man/canon-artifacts.1 +2 -2
  16. package/man/canon-brief-approve.1 +6 -4
  17. package/man/canon-brief-check.1 +2 -2
  18. package/man/canon-brief-show.1 +2 -2
  19. package/man/canon-brief.1 +2 -2
  20. package/man/canon-change-new.1 +2 -2
  21. package/man/canon-change.1 +2 -2
  22. package/man/canon-completion.1 +2 -2
  23. package/man/canon-context-pack-add.1 +2 -2
  24. package/man/canon-context-pack-show.1 +2 -2
  25. package/man/canon-context-pack-verify.1 +2 -2
  26. package/man/canon-context-pack.1 +2 -2
  27. package/man/canon-context.1 +2 -2
  28. package/man/canon-dashboard.1 +2 -2
  29. package/man/canon-demo-init.1 +2 -2
  30. package/man/canon-demo-review.1 +2 -2
  31. package/man/canon-demo.1 +2 -2
  32. package/man/canon-dispatch-begin.1 +2 -2
  33. package/man/canon-dispatch-diff.1 +2 -2
  34. package/man/canon-dispatch-end.1 +2 -2
  35. package/man/canon-dispatch.1 +2 -2
  36. package/man/canon-divergence-accept.1 +3 -3
  37. package/man/canon-divergence-add.1 +3 -3
  38. package/man/canon-divergence-defer.1 +3 -3
  39. package/man/canon-divergence-list.1 +3 -3
  40. package/man/canon-divergence-resolve.1 +2 -2
  41. package/man/canon-divergence.1 +2 -2
  42. package/man/canon-evidence-add.1 +6 -6
  43. package/man/canon-evidence-approval-payload.1 +3 -3
  44. package/man/canon-evidence-audit.1 +5 -5
  45. package/man/canon-evidence.1 +2 -2
  46. package/man/canon-export.1 +4 -4
  47. package/man/canon-feature-new.1 +2 -2
  48. package/man/canon-feature.1 +2 -2
  49. package/man/canon-finding-add.1 +4 -4
  50. package/man/canon-finding-close.1 +4 -6
  51. package/man/canon-finding-list.1 +2 -2
  52. package/man/canon-finding.1 +2 -2
  53. package/man/canon-format.1 +2 -2
  54. package/man/canon-gate-check.1 +2 -2
  55. package/man/canon-gate-install-hooks.1 +2 -2
  56. package/man/canon-gate-promote.1 +2 -2
  57. package/man/canon-gate.1 +2 -2
  58. package/man/canon-ingest-plans.1 +2 -2
  59. package/man/canon-ingest-records.1 +2 -2
  60. package/man/canon-ingest-sessions.1 +2 -2
  61. package/man/canon-ingest.1 +2 -2
  62. package/man/canon-init.1 +5 -4
  63. package/man/canon-inventory-sync.1 +2 -2
  64. package/man/canon-inventory.1 +2 -2
  65. package/man/canon-ledger-compact.1 +2 -2
  66. package/man/canon-ledger.1 +2 -2
  67. package/man/canon-migrate.1 +2 -2
  68. package/man/canon-plugin-sync.1 +2 -2
  69. package/man/canon-plugin.1 +2 -2
  70. package/man/canon-policy-approve.1 +2 -2
  71. package/man/canon-policy-show.1 +2 -2
  72. package/man/canon-policy.1 +2 -2
  73. package/man/canon-prompt-add.1 +2 -2
  74. package/man/canon-prompt-show.1 +2 -2
  75. package/man/canon-prompt.1 +2 -2
  76. package/man/canon-purge.1 +3 -3
  77. package/man/canon-query.1 +3 -3
  78. package/man/canon-regime-show.1 +2 -2
  79. package/man/canon-regime.1 +2 -2
  80. package/man/canon-report-build.1 +2 -2
  81. package/man/canon-report-check.1 +2 -2
  82. package/man/canon-report-snapshot.1 +2 -2
  83. package/man/canon-report.1 +2 -2
  84. package/man/canon-retrieve.1 +2 -2
  85. package/man/canon-review-change.1 +3 -3
  86. package/man/canon-review-scenario.1 +3 -3
  87. package/man/canon-review.1 +2 -2
  88. package/man/canon-scenario-new.1 +2 -2
  89. package/man/canon-scenario.1 +2 -2
  90. package/man/canon-schema.1 +2 -2
  91. package/man/canon-search.1 +2 -2
  92. package/man/canon-selftest.1 +2 -2
  93. package/man/canon-skills-check.1 +3 -3
  94. package/man/canon-skills-doctor.1 +3 -3
  95. package/man/canon-skills-install.1 +3 -3
  96. package/man/canon-skills-show.1 +2 -2
  97. package/man/canon-skills.1 +2 -2
  98. package/man/canon-status.1 +2 -2
  99. package/man/canon-strategy-approval-payload.1 +3 -3
  100. package/man/canon-strategy-promote.1 +2 -2
  101. package/man/canon-strategy-rollback.1 +3 -3
  102. package/man/canon-strategy.1 +2 -2
  103. package/man/canon-subject-adopt.1 +2 -2
  104. package/man/canon-subject-move.1 +2 -2
  105. package/man/canon-subject-new.1 +2 -2
  106. package/man/canon-subject-show.1 +2 -2
  107. package/man/canon-subject-unadopt.1 +2 -2
  108. package/man/canon-subject.1 +2 -2
  109. package/man/canon-task-done.1 +2 -2
  110. package/man/canon-task.1 +2 -2
  111. package/man/canon-tier-age.1 +2 -2
  112. package/man/canon-tier.1 +2 -2
  113. package/man/canon-trace.1 +2 -2
  114. package/man/canon.1 +2 -2
  115. 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-prompt-add 1 "add 0.36.0"
3
+ .TH canon-prompt-add 1 "add 0.37.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.36.0
47
+ v0.37.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.36.0"
3
+ .TH canon-prompt-show 1 "show 0.37.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.36.0
41
+ v0.37.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.36.0"
3
+ .TH canon-prompt 1 "prompt 0.37.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.36.0
43
+ v0.37.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.36.0"
3
+ .TH canon-purge 1 "purge 0.37.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
@@ -44,7 +44,7 @@ trajectory
44
44
  .RE
45
45
  .TP
46
46
  \fB\-\-before\fR \fI<TIMESTAMP>\fR
47
- Remove records strictly before this time (RFC3339 or YYYY\-MM\-DD, UTC)
47
+ Remove records strictly before this time: an RFC 3339 date (`2030\-01\-01`, UTC midnight) or date\-time (`2030\-01\-01T10:00:00Z`)
48
48
  .TP
49
49
  \fB\-\-commit\fR
50
50
  Make the change; without it the command only previews.
@@ -67,4 +67,4 @@ Print help
67
67
  \fB\-V\fR, \fB\-\-version\fR
68
68
  Print version
69
69
  .SH VERSION
70
- v0.36.0
70
+ v0.37.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.36.0"
3
+ .TH canon-query 1 "query 0.37.0"
4
4
  .SH NAME
5
5
  canon\-query \- Read stored records across every storage tier
6
6
  .SH SYNOPSIS
@@ -64,7 +64,7 @@ finding
64
64
  .RE
65
65
  .TP
66
66
  \fB\-\-since\fR \fI<TIMESTAMP>\fR
67
- Only records with at >= <since> (RFC3339/ISO\-8601)
67
+ Only records with at >= <since>: an RFC 3339 date (`2030\-01\-01`, UTC midnight) or date\-time (`2030\-01\-01T10:00:00Z`)
68
68
  .TP
69
69
  \fB\-\-repo\fR \fI<DIR>\fR
70
70
  The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
@@ -108,4 +108,4 @@ Print help
108
108
  \fB\-V\fR, \fB\-\-version\fR
109
109
  Print version
110
110
  .SH VERSION
111
- v0.36.0
111
+ v0.37.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.36.0"
3
+ .TH canon-regime-show 1 "show 0.37.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.36.0
50
+ v0.37.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.36.0"
3
+ .TH canon-regime 1 "regime 0.37.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.36.0
39
+ v0.37.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.36.0"
3
+ .TH canon-report-build 1 "build 0.37.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.36.0
44
+ v0.37.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.36.0"
3
+ .TH canon-report-check 1 "check 0.37.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.36.0
41
+ v0.37.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.36.0"
3
+ .TH canon-report-snapshot 1 "snapshot 0.37.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.36.0
47
+ v0.37.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.36.0"
3
+ .TH canon-report 1 "report 0.37.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.36.0
45
+ v0.37.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.36.0"
3
+ .TH canon-retrieve 1 "retrieve 0.37.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.36.0
56
+ v0.37.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.36.0"
3
+ .TH canon-review-change 1 "change 0.37.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
@@ -30,7 +30,7 @@ orchestrator
30
30
  Spec corpus id of the scenarios. Required only when canon.yaml configures more than one spec root
31
31
  .TP
32
32
  \fB\-\-actor\fR \fI<ACTOR_ID>\fR
33
- The reviewer\*(Aqs id (recorded as the review\*(Aqs author and as its reviewer; line breaks refused)
33
+ The reviewer\*(Aqs id (recorded as the review\*(Aqs author and as its reviewer). One line of text: the white space around it is trimmed; a control character or line break inside it is refused
34
34
  .TP
35
35
  \fB\-\-rev\fR \fI<REV>\fR [default: HEAD]
36
36
  The commit this record is about: any git revision (`HEAD~1`, a branch, a tag, a short sha); the full sha is recorded with the code tree it saw. The default HEAD records the working tree as it stands (uncommitted code included), and a commit made from it has the same code tree. Outside git, or with no commit, the command refuses (COMMIT_REQUIRED)
@@ -95,4 +95,4 @@ Print version
95
95
  <\fICHANGE_ID\fR>
96
96
  The chore change to review
97
97
  .SH VERSION
98
- v0.36.0
98
+ v0.37.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.36.0"
3
+ .TH canon-review-scenario 1 "scenario 0.37.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
@@ -30,7 +30,7 @@ orchestrator
30
30
  Spec corpus id of the scenarios. Required only when canon.yaml configures more than one spec root
31
31
  .TP
32
32
  \fB\-\-actor\fR \fI<ACTOR_ID>\fR
33
- The reviewer\*(Aqs id (recorded as the review\*(Aqs author and as its reviewer; line breaks refused)
33
+ The reviewer\*(Aqs id (recorded as the review\*(Aqs author and as its reviewer). One line of text: the white space around it is trimmed; a control character or line break inside it is refused
34
34
  .TP
35
35
  \fB\-\-rev\fR \fI<REV>\fR [default: HEAD]
36
36
  The commit this record is about: any git revision (`HEAD~1`, a branch, a tag, a short sha); the full sha is recorded with the code tree it saw. The default HEAD records the working tree as it stands (uncommitted code included), and a commit made from it has the same code tree. Outside git, or with no commit, the command refuses (COMMIT_REQUIRED)
@@ -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.36.0
98
+ v0.37.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.36.0"
3
+ .TH canon-review 1 "review 0.37.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.36.0
42
+ v0.37.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.36.0"
3
+ .TH canon-scenario-new 1 "new 0.37.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.36.0
80
+ v0.37.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.36.0"
3
+ .TH canon-scenario 1 "scenario 0.37.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.36.0
39
+ v0.37.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.36.0"
3
+ .TH canon-schema 1 "schema 0.37.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.36.0
77
+ v0.37.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.36.0"
3
+ .TH canon-search 1 "search 0.37.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.36.0
104
+ v0.37.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.36.0"
3
+ .TH canon-selftest 1 "selftest 0.37.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.36.0
69
+ v0.37.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-skills-check 1 "check 0.36.0"
3
+ .TH canon-skills-check 1 "check 0.37.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
@@ -33,7 +33,7 @@ Source directory; defaults to CANON_SKILLS_SOURCE or canon/skills
33
33
  The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
34
34
  .TP
35
35
  \fB\-\-providers\fR \fI<LIST>\fR
36
- Providers to inspect (`claude`, `codex`, `omp`, `pi`, or a comma\-separated list). Omitted: as for install
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
37
37
  .TP
38
38
  \fB\-\-json\fR
39
39
  Output JSON instead of the human\-readable form
@@ -44,4 +44,4 @@ Print help
44
44
  \fB\-V\fR, \fB\-\-version\fR
45
45
  Print version
46
46
  .SH VERSION
47
- v0.36.0
47
+ v0.37.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-skills-doctor 1 "doctor 0.36.0"
3
+ .TH canon-skills-doctor 1 "doctor 0.37.0"
4
4
  .SH NAME
5
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
6
6
  .SH SYNOPSIS
@@ -33,7 +33,7 @@ Source directory; defaults to CANON_SKILLS_SOURCE or canon/skills
33
33
  The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
34
34
  .TP
35
35
  \fB\-\-providers\fR \fI<LIST>\fR
36
- Providers to inspect (`claude`, `codex`, `omp`, `pi`, or a comma\-separated list). Omitted: as for install
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
37
37
  .TP
38
38
  \fB\-\-json\fR
39
39
  Output JSON instead of the human\-readable form
@@ -44,4 +44,4 @@ Print help
44
44
  \fB\-V\fR, \fB\-\-version\fR
45
45
  Print version
46
46
  .SH VERSION
47
- v0.36.0
47
+ v0.37.0
@@ -1,6 +1,6 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-skills-install 1 "install 0.36.0"
3
+ .TH canon-skills-install 1 "install 0.37.0"
4
4
  .SH NAME
5
5
  canon\-skills\-install \- Install the canonical `canon` bundle or legacy developer skills
6
6
  .SH SYNOPSIS
@@ -33,7 +33,7 @@ Developer override: read SKILL.src.md\*(Aqs frontmatter and scripts/ from this d
33
33
  The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
34
34
  .TP
35
35
  \fB\-\-providers\fR \fI<LIST>\fR
36
- Providers to project (`claude`, `codex`, `omp`, `pi`, a comma\-separated list, or `none`); 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/`
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/`
37
37
  .TP
38
38
  \fB\-\-dry\-run\fR
39
39
  Validate fully and report what would be written, without writing anything
@@ -50,4 +50,4 @@ Print help
50
50
  \fB\-V\fR, \fB\-\-version\fR
51
51
  Print version
52
52
  .SH VERSION
53
- v0.36.0
53
+ v0.37.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.36.0"
3
+ .TH canon-skills-show 1 "show 0.37.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.36.0
104
+ v0.37.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.36.0"
3
+ .TH canon-skills 1 "skills 0.37.0"
4
4
  .SH NAME
5
5
  canon\-skills \- Install canon\*(Aqs agent guides into a repo
6
6
  .SH SYNOPSIS
@@ -45,4 +45,4 @@ Print diagnostics for canonical projections, the install lock\*(Aqs canon versio
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.36.0
48
+ v0.37.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.36.0"
3
+ .TH canon-status 1 "status 0.37.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.36.0
56
+ v0.37.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.36.0"
3
+ .TH canon-strategy-approval-payload 1 "approval-payload 0.37.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
@@ -33,7 +33,7 @@ The paired evaluation bundle the approval is for
33
33
  Who approves (the human whose detached signature the payload is for)
34
34
  .TP
35
35
  \fB\-\-approval\-at\fR \fI<TIMESTAMP>\fR
36
- The approval time that is signed into the payload: RFC3339, or YYYY\-MM\-DD (UTC midnight)
36
+ The approval time that is signed into the payload: an RFC 3339 date\-time (`2030\-01\-01T10:00:00Z`; a date alone is refused). Fix it once and give the same value to the signature and to `strategy rollback`
37
37
  .TP
38
38
  \fB\-\-repo\fR \fI<DIR>\fR
39
39
  The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
@@ -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.36.0
53
+ v0.37.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.36.0"
3
+ .TH canon-strategy-promote 1 "promote 0.37.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.36.0
59
+ v0.37.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.36.0"
3
+ .TH canon-strategy-rollback 1 "rollback 0.37.0"
4
4
  .SH NAME
5
5
  canon\-strategy\-rollback \- Disable an active strategy with durable rollback provenance
6
6
  .SH SYNOPSIS
@@ -36,7 +36,7 @@ The approver; must be a policy\-pinned approver
36
36
  Detached signature file over the rollback payload
37
37
  .TP
38
38
  \fB\-\-approval\-at\fR \fI<TIMESTAMP>\fR
39
- When the approver signed: RFC3339, or YYYY\-MM\-DD (UTC midnight)
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
41
  \fB\-\-contradicting\-trajectory\fR \fI<ID>\fR
42
42
  A trajectory that contradicts the strategy (must exist in the trajectory store)
@@ -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.36.0
62
+ v0.37.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.36.0"
3
+ .TH canon-strategy 1 "strategy 0.37.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.36.0
45
+ v0.37.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.36.0"
3
+ .TH canon-subject-adopt 1 "adopt 0.37.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.36.0
53
+ v0.37.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.36.0"
3
+ .TH canon-subject-move 1 "move 0.37.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.36.0
80
+ v0.37.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.36.0"
3
+ .TH canon-subject-new 1 "new 0.37.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.36.0
65
+ v0.37.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.36.0"
3
+ .TH canon-subject-show 1 "show 0.37.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.36.0
44
+ v0.37.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.36.0"
3
+ .TH canon-subject-unadopt 1 "unadopt 0.37.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.36.0
63
+ v0.37.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.36.0"
3
+ .TH canon-subject 1 "subject 0.37.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.36.0
51
+ v0.37.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.36.0"
3
+ .TH canon-task-done 1 "done 0.37.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.36.0
47
+ v0.37.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.36.0"
3
+ .TH canon-task 1 "task 0.37.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.36.0
42
+ v0.37.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.36.0"
3
+ .TH canon-tier-age 1 "age 0.37.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.36.0
50
+ v0.37.0