@journeykit/canon 0.33.0 → 0.34.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 (118) hide show
  1. package/dist/skills/SKILL.src.md +24 -10
  2. package/dist/skills/reference/canon-authoring.md +2 -2
  3. package/dist/skills/reference/canon-context.md +2 -2
  4. package/dist/skills/reference/canon-gate.md +1 -1
  5. package/dist/skills/reference/canon-review.md +1 -1
  6. package/dist/skills/reference/canon-storage.md +5 -3
  7. package/dist/skills/reference/canon-subject.md +1 -1
  8. package/dist/skills/reference/role-implementer.md +33 -33
  9. package/dist/skills/reference/role-orchestrator.md +63 -63
  10. package/dist/skills/reference/role-planner.md +24 -24
  11. package/dist/skills/reference/role-reviewer.md +26 -26
  12. package/man/canon-adapter-authorize.1 +3 -3
  13. package/man/canon-adapter-validate.1 +3 -3
  14. package/man/canon-adapter.1 +3 -3
  15. package/man/canon-artifacts-move.1 +3 -3
  16. package/man/canon-artifacts-store.1 +3 -3
  17. package/man/canon-artifacts-verify.1 +3 -3
  18. package/man/canon-artifacts.1 +3 -3
  19. package/man/canon-brief-approve.1 +3 -3
  20. package/man/canon-brief-check.1 +3 -3
  21. package/man/canon-brief-show.1 +3 -3
  22. package/man/canon-brief.1 +3 -3
  23. package/man/canon-change-new.1 +3 -3
  24. package/man/canon-change.1 +3 -3
  25. package/man/canon-completion.1 +3 -3
  26. package/man/canon-context-pack-add.1 +3 -3
  27. package/man/canon-context-pack-show.1 +3 -3
  28. package/man/canon-context-pack-verify.1 +3 -3
  29. package/man/canon-context-pack.1 +3 -3
  30. package/man/canon-context.1 +4 -4
  31. package/man/canon-dashboard.1 +3 -3
  32. package/man/canon-demo-init.1 +3 -3
  33. package/man/canon-demo-review.1 +3 -3
  34. package/man/canon-demo.1 +3 -3
  35. package/man/canon-dispatch-begin.1 +3 -3
  36. package/man/canon-dispatch-diff.1 +3 -3
  37. package/man/canon-dispatch-end.1 +3 -3
  38. package/man/canon-dispatch.1 +3 -3
  39. package/man/canon-divergence-accept.1 +3 -3
  40. package/man/canon-divergence-add.1 +3 -3
  41. package/man/canon-divergence-defer.1 +3 -3
  42. package/man/canon-divergence-list.1 +6 -6
  43. package/man/canon-divergence-resolve.1 +3 -3
  44. package/man/canon-divergence.1 +3 -3
  45. package/man/canon-evidence-add.1 +3 -3
  46. package/man/canon-evidence-approval-payload.1 +3 -3
  47. package/man/canon-evidence-audit.1 +3 -3
  48. package/man/canon-evidence.1 +3 -3
  49. package/man/canon-export.1 +6 -6
  50. package/man/canon-feature-new.1 +3 -3
  51. package/man/canon-feature.1 +3 -3
  52. package/man/canon-finding-add.1 +4 -4
  53. package/man/canon-finding-close.1 +3 -3
  54. package/man/canon-finding-list.1 +6 -6
  55. package/man/canon-finding.1 +3 -3
  56. package/man/canon-format.1 +3 -3
  57. package/man/canon-gate-check.1 +3 -3
  58. package/man/canon-gate-install-hooks.1 +3 -3
  59. package/man/canon-gate-promote.1 +3 -3
  60. package/man/canon-gate.1 +3 -3
  61. package/man/canon-ingest-plans.1 +3 -3
  62. package/man/canon-ingest-records.1 +3 -3
  63. package/man/canon-ingest-sessions.1 +3 -3
  64. package/man/canon-ingest.1 +3 -3
  65. package/man/canon-init.1 +4 -4
  66. package/man/canon-inventory-sync.1 +3 -3
  67. package/man/canon-inventory.1 +3 -3
  68. package/man/canon-ledger-compact.1 +3 -3
  69. package/man/canon-ledger.1 +3 -3
  70. package/man/canon-migrate.1 +3 -3
  71. package/man/canon-plugin-sync.1 +3 -3
  72. package/man/canon-plugin.1 +3 -3
  73. package/man/canon-policy-approve.1 +3 -3
  74. package/man/canon-policy-show.1 +3 -3
  75. package/man/canon-policy.1 +3 -3
  76. package/man/canon-prompt-add.1 +3 -3
  77. package/man/canon-prompt-show.1 +3 -3
  78. package/man/canon-prompt.1 +3 -3
  79. package/man/canon-purge.1 +3 -3
  80. package/man/canon-query.1 +6 -6
  81. package/man/canon-regime-show.1 +3 -3
  82. package/man/canon-regime.1 +3 -3
  83. package/man/canon-report-build.1 +3 -3
  84. package/man/canon-report-check.1 +3 -3
  85. package/man/canon-report-snapshot.1 +3 -3
  86. package/man/canon-report.1 +3 -3
  87. package/man/canon-retrieve.1 +4 -4
  88. package/man/canon-review-change.1 +3 -3
  89. package/man/canon-review-scenario.1 +3 -3
  90. package/man/canon-review.1 +3 -3
  91. package/man/canon-scenario-new.1 +3 -3
  92. package/man/canon-scenario.1 +3 -3
  93. package/man/canon-schema.1 +14 -6
  94. package/man/canon-search.1 +3 -3
  95. package/man/canon-selftest.1 +3 -3
  96. package/man/canon-skills-check.1 +3 -3
  97. package/man/canon-skills-doctor.1 +3 -3
  98. package/man/canon-skills-install.1 +3 -3
  99. package/man/canon-skills-show.1 +3 -3
  100. package/man/canon-skills.1 +3 -3
  101. package/man/canon-status.1 +4 -4
  102. package/man/canon-strategy-approval-payload.1 +3 -3
  103. package/man/canon-strategy-promote.1 +3 -3
  104. package/man/canon-strategy-rollback.1 +3 -3
  105. package/man/canon-strategy.1 +3 -3
  106. package/man/canon-subject-adopt.1 +3 -3
  107. package/man/canon-subject-move.1 +3 -3
  108. package/man/canon-subject-new.1 +4 -4
  109. package/man/canon-subject-show.1 +3 -3
  110. package/man/canon-subject-unadopt.1 +3 -3
  111. package/man/canon-subject.1 +3 -3
  112. package/man/canon-task-done.1 +3 -3
  113. package/man/canon-task.1 +3 -3
  114. package/man/canon-tier-age.1 +3 -3
  115. package/man/canon-tier.1 +3 -3
  116. package/man/canon-trace.1 +3 -3
  117. package/man/canon.1 +3 -3
  118. 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-regime-show 1 "show 0.33.0"
3
+ .TH canon-regime-show 1 "show 0.34.0"
4
4
  .SH NAME
5
5
  canon\-regime\-show \- Build a canonical regime key for hook scripts
6
6
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ Build a canonical regime key for hook scripts
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -47,4 +47,4 @@ Print help
47
47
  \fB\-V\fR, \fB\-\-version\fR
48
48
  Print version
49
49
  .SH VERSION
50
- v0.33.0
50
+ v0.34.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.33.0"
3
+ .TH canon-regime 1 "regime 0.34.0"
4
4
  .SH NAME
5
5
  canon\-regime \- Build a canonical regime key for hook scripts
6
6
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ Build a canonical regime key for hook scripts
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -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.33.0
39
+ v0.34.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.33.0"
3
+ .TH canon-report-build 1 "build 0.34.0"
4
4
  .SH NAME
5
5
  canon\-report\-build \- Write the status report (.canon/REPORT.md)
6
6
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ Write the status report (.canon/REPORT.md)
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -41,4 +41,4 @@ Print help
41
41
  \fB\-V\fR, \fB\-\-version\fR
42
42
  Print version
43
43
  .SH VERSION
44
- v0.33.0
44
+ v0.34.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.33.0"
3
+ .TH canon-report-check 1 "check 0.34.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
@@ -10,7 +10,7 @@ Byte\-diff .canon/REPORT.md against a fresh build (0 fresh, 1 missing or drifted
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -38,4 +38,4 @@ Print help
38
38
  \fB\-V\fR, \fB\-\-version\fR
39
39
  Print version
40
40
  .SH VERSION
41
- v0.33.0
41
+ v0.34.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.33.0"
3
+ .TH canon-report-snapshot 1 "snapshot 0.34.0"
4
4
  .SH NAME
5
5
  canon\-report\-snapshot \- Export the panel marts to <DIR>/*.parquet plus manifest.json
6
6
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ Export the panel marts to <DIR>/*.parquet plus manifest.json
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -44,4 +44,4 @@ Print version
44
44
  <\fIDIR\fR>
45
45
  The output directory (created if absent)
46
46
  .SH VERSION
47
- v0.33.0
47
+ v0.34.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.33.0"
3
+ .TH canon-report 1 "report 0.34.0"
4
4
  .SH NAME
5
5
  canon\-report \- Build, check, or snapshot the status report
6
6
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ Build, check, or snapshot the status report
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -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.33.0
45
+ v0.34.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.33.0"
3
+ .TH canon-retrieve 1 "retrieve 0.34.0"
4
4
  .SH NAME
5
5
  canon\-retrieve \- Fetch role\-scoped strategy guidance
6
6
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ Fetch role\-scoped strategy guidance
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -39,7 +39,7 @@ Derive the regime from a domain slug; mutually exclusive with \-\-regime
39
39
  Narrow \-\-domain to one subject_id; requires \-\-domain, mutually exclusive with \-\-regime
40
40
  .TP
41
41
  \fB\-\-limit\fR \fI<N>\fR [default: 5]
42
- Cap on the guidance items returned (default: 5)
42
+ Cap on the guidance items returned
43
43
  .TP
44
44
  \fB\-\-repo\fR \fI<DIR>\fR
45
45
  The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
@@ -53,4 +53,4 @@ Print help
53
53
  \fB\-V\fR, \fB\-\-version\fR
54
54
  Print version
55
55
  .SH VERSION
56
- v0.33.0
56
+ v0.34.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.33.0"
3
+ .TH canon-review-change 1 "change 0.34.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
@@ -10,7 +10,7 @@ Write one attributed Review record for a chore change directly to the ledger (ex
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -95,4 +95,4 @@ Print version
95
95
  <\fICHANGE_ID\fR>
96
96
  The chore change to review
97
97
  .SH VERSION
98
- v0.33.0
98
+ v0.34.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.33.0"
3
+ .TH canon-review-scenario 1 "scenario 0.34.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
@@ -10,7 +10,7 @@ Write one attributed Review record per scenario directly to the ledger, nothing
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -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.33.0
98
+ v0.34.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.33.0"
3
+ .TH canon-review 1 "review 0.34.0"
4
4
  .SH NAME
5
5
  canon\-review \- Record an attributed review verdict
6
6
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ Record an attributed review verdict
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -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.33.0
42
+ v0.34.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.33.0"
3
+ .TH canon-scenario-new 1 "new 0.34.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
@@ -10,7 +10,7 @@ Append a tagged scenario stub to its .feature file (created if missing); many at
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -77,4 +77,4 @@ Print version
77
77
  <\fISCENARIO_ID\fR>
78
78
  <area>.<surface>.<nn> scenario tag
79
79
  .SH VERSION
80
- v0.33.0
80
+ v0.34.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.33.0"
3
+ .TH canon-scenario 1 "scenario 0.34.0"
4
4
  .SH NAME
5
5
  canon\-scenario \- Add a tagged scenario to a .feature spec file
6
6
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ Add a tagged scenario to a .feature spec file
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -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.33.0
39
+ v0.34.0
@@ -1,16 +1,16 @@
1
1
  .ie \n(.g .ds Aq \(aq
2
2
  .el .ds Aq '
3
- .TH canon-schema 1 "schema 0.33.0"
3
+ .TH canon-schema 1 "schema 0.34.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
7
- \fBcanon schema\fR [\fB\-\-as\fR] [\fB\-\-json\fR] [\fB\-\-errors\fR] [\fB\-\-error\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fIPATH\fR]
7
+ \fBcanon schema\fR [\fB\-\-as\fR] [\fB\-\-json\fR] [\fB\-\-errors\fR] [\fB\-\-error\fR] [\fB\-\-warnings\fR] [\fB\-\-warning\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fIPATH\fR]
8
8
  .SH DESCRIPTION
9
9
  Describe canon\*(Aqs own commands: list them, or show one command\*(Aqs arguments, options, effect and exit codes
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -30,10 +30,16 @@ orchestrator
30
30
  Output JSON instead of the human\-readable form
31
31
  .TP
32
32
  \fB\-\-errors\fR
33
- Print every error code any command can emit, with its meaning, instead of a command
33
+ Print every error code any command can emit, with its meaning and reasons, instead of a command
34
34
  .TP
35
35
  \fB\-\-error\fR \fI<CODE>\fR
36
- Show one error code: its meaning, exit, retryable and fix (an unknown code exits 2)
36
+ Show one error code: its meaning, exit, retryable, fix and reasons (an unknown code, or a code that is only a warning, exits 2)
37
+ .TP
38
+ \fB\-\-warnings\fR
39
+ Print every warning code, with its meaning, instead of a command
40
+ .TP
41
+ \fB\-\-warning\fR \fI<CODE>\fR
42
+ Show one warning code: its meaning and fix (an unknown code exits 2)
37
43
  .TP
38
44
  \fB\-h\fR, \fB\-\-help\fR
39
45
  Print help
@@ -51,6 +57,8 @@ Examples:
51
57
  canon schema \-\-as reviewer \-\-json
52
58
  canon schema \-\-errors \-\-json
53
59
  canon schema \-\-error CONFIG_MISSING
60
+ canon schema \-\-warnings \-\-json
61
+ canon schema \-\-warning OLD_LAYOUT_FOUND
54
62
 
55
63
  Generated from the command tree itself, so it never drifts from what the parser accepts.
56
64
  Touches no repo and no network: it works from any directory. An unknown path exits 2 and names the
@@ -60,4 +68,4 @@ The bare listing is unfiltered: every command. `\-\-as <ROLE>` lists only that r
60
68
  CANON_ROLE variable never filters or fails `schema` (an invalid value is a warning in meta.warnings).
61
69
  A command whose effect depends on its arguments carries `effectNote`.
62
70
  .SH VERSION
63
- v0.33.0
71
+ v0.34.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.33.0"
3
+ .TH canon-search 1 "search 0.34.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
@@ -10,7 +10,7 @@ Search records, brief sections and scenario text, with each hit\*(Aqs neighbors
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -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.33.0
104
+ v0.34.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.33.0"
3
+ .TH canon-selftest 1 "selftest 0.34.0"
4
4
  .SH NAME
5
5
  canon\-selftest \- Run canon\*(Aqs built\-in fixture self\-tests
6
6
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ Run canon\*(Aqs built\-in fixture self\-tests
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -66,4 +66,4 @@ Print help
66
66
  \fB\-V\fR, \fB\-\-version\fR
67
67
  Print version
68
68
  .SH VERSION
69
- v0.33.0
69
+ v0.34.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.33.0"
3
+ .TH canon-skills-check 1 "check 0.34.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
@@ -10,7 +10,7 @@ Check canonical projections without writing; exit 1 on drift, a legacy remnant,
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -44,4 +44,4 @@ Print help
44
44
  \fB\-V\fR, \fB\-\-version\fR
45
45
  Print version
46
46
  .SH VERSION
47
- v0.33.0
47
+ v0.34.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.33.0"
3
+ .TH canon-skills-doctor 1 "doctor 0.34.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
@@ -10,7 +10,7 @@ Print diagnostics for canonical projections, the install lock\*(Aqs canon versio
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -44,4 +44,4 @@ Print help
44
44
  \fB\-V\fR, \fB\-\-version\fR
45
45
  Print version
46
46
  .SH VERSION
47
- v0.33.0
47
+ v0.34.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.33.0"
3
+ .TH canon-skills-install 1 "install 0.34.0"
4
4
  .SH NAME
5
5
  canon\-skills\-install \- Install the canonical `canon` bundle or legacy developer skills
6
6
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ Install the canonical `canon` bundle or legacy developer skills
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -50,4 +50,4 @@ Print help
50
50
  \fB\-V\fR, \fB\-\-version\fR
51
51
  Print version
52
52
  .SH VERSION
53
- v0.33.0
53
+ v0.34.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.33.0"
3
+ .TH canon-skills-show 1 "show 0.34.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
@@ -10,7 +10,7 @@ Print a guide built into this binary (markdown on stdout); the installed SKILL.m
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -101,4 +101,4 @@ role\-planner
101
101
  role\-reviewer
102
102
  .RE
103
103
  .SH VERSION
104
- v0.33.0
104
+ v0.34.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.33.0"
3
+ .TH canon-skills 1 "skills 0.34.0"
4
4
  .SH NAME
5
5
  canon\-skills \- Install canon\*(Aqs agent guides into a repo
6
6
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ Install canon\*(Aqs agent guides into a repo
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -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.33.0
48
+ v0.34.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.33.0"
3
+ .TH canon-status 1 "status 0.34.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
@@ -10,7 +10,7 @@ Show where this repo stands: subjects by status, their gaps, and the next comman
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -33,7 +33,7 @@ The repo to act on (default: the nearest ancestor directory holding a canon.yaml
33
33
  Output JSON instead of the human\-readable form
34
34
  .TP
35
35
  \fB\-\-fields\fR \fI<FIELDS>\fR
36
- With \-\-json, keep only these top\-level report fields (comma\-separated); an unknown field is refused (camelCase and snake_case both match)
36
+ With \-\-json, keep only these members of the report (comma\-separated field paths; `canon schema status \-\-json` lists them under outputs[].fields.paths)
37
37
  .TP
38
38
  \fB\-h\fR, \fB\-\-help\fR
39
39
  Print help
@@ -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.33.0
56
+ v0.34.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.33.0"
3
+ .TH canon-strategy-approval-payload 1 "approval-payload 0.34.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
@@ -10,7 +10,7 @@ The unsigned approval payload bytes an external signer signs (a read: identical
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -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.33.0
53
+ v0.34.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.33.0"
3
+ .TH canon-strategy-promote 1 "promote 0.34.0"
4
4
  .SH NAME
5
5
  canon\-strategy\-promote \- Promote a strategy after paired evaluation and signed approval
6
6
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ Promote a strategy after paired evaluation and signed approval
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -56,4 +56,4 @@ Print version
56
56
  <\fISTRATEGY_ID\fR>
57
57
  The StrategyId (ULID) to promote
58
58
  .SH VERSION
59
- v0.33.0
59
+ v0.34.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.33.0"
3
+ .TH canon-strategy-rollback 1 "rollback 0.34.0"
4
4
  .SH NAME
5
5
  canon\-strategy\-rollback \- Disable an active strategy with durable rollback provenance
6
6
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ Disable an active strategy with durable rollback provenance
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -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.33.0
62
+ v0.34.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.33.0"
3
+ .TH canon-strategy 1 "strategy 0.34.0"
4
4
  .SH NAME
5
5
  canon\-strategy \- Promote a proven strategy into the git\-tracked tier
6
6
  .SH SYNOPSIS
@@ -10,7 +10,7 @@ Promote a proven strategy into the git\-tracked tier
10
10
  .SH OPTIONS
11
11
  .TP
12
12
  \fB\-\-as\fR \fI<ROLE>\fR
13
- The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` defaults to it
13
+ The role you act as: planner, implementer, reviewer or orchestrator. Overrides `CANON_ROLE`. `schema` and `context` list only the role\*(Aqs commands, `status` keeps its steps, and `\-\-role` on `evidence add` / `evidence audit` / `review scenario` / `review change` is this role unless given
14
14
  .br
15
15
 
16
16
  .br
@@ -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.33.0
45
+ v0.34.0