@journeykit/canon 0.31.0 → 0.32.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.
- package/dist/skills/SKILL.src.md +33 -14
- package/dist/skills/reference/brief-align.md +2 -2
- package/dist/skills/reference/brief-clarify.md +2 -2
- package/dist/skills/reference/brief-harden.md +2 -2
- package/dist/skills/reference/brief-polish.md +4 -4
- package/dist/skills/reference/brief-shape.md +2 -2
- package/dist/skills/reference/canon-gate.md +4 -4
- package/dist/skills/reference/canon-policy.md +7 -4
- package/dist/skills/reference/canon-report-dashboard.md +7 -4
- package/dist/skills/reference/canon-subject.md +5 -5
- package/dist/skills/reference/role-implementer.md +10 -8
- package/dist/skills/reference/role-orchestrator.md +35 -20
- package/dist/skills/reference/role-planner.md +67 -28
- package/dist/skills/reference/role-reviewer.md +22 -14
- package/man/canon-adapter-authorize.1 +2 -2
- package/man/canon-adapter-validate.1 +2 -2
- package/man/canon-adapter.1 +2 -2
- package/man/canon-artifacts-move.1 +2 -2
- package/man/canon-artifacts-store.1 +2 -2
- package/man/canon-artifacts-verify.1 +2 -2
- package/man/canon-artifacts.1 +2 -2
- package/man/canon-brief-approve.1 +12 -3
- package/man/canon-brief-check.1 +2 -2
- package/man/canon-brief-show.1 +6 -3
- package/man/canon-brief.1 +2 -2
- package/man/canon-change-new.1 +2 -2
- package/man/canon-change.1 +2 -2
- package/man/canon-completion.1 +2 -2
- package/man/canon-context-pack-add.1 +2 -2
- package/man/canon-context-pack-show.1 +2 -2
- package/man/canon-context-pack-verify.1 +2 -2
- package/man/canon-context-pack.1 +2 -2
- package/man/canon-context.1 +2 -2
- package/man/canon-dashboard.1 +2 -2
- package/man/canon-demo-init.1 +2 -2
- package/man/canon-demo-review.1 +2 -2
- package/man/canon-demo.1 +2 -2
- package/man/canon-dispatch-begin.1 +2 -2
- package/man/canon-dispatch-diff.1 +2 -2
- package/man/canon-dispatch-end.1 +2 -2
- package/man/canon-dispatch.1 +2 -2
- package/man/canon-divergence-accept.1 +12 -3
- package/man/canon-divergence-add.1 +2 -2
- package/man/canon-divergence-defer.1 +2 -2
- package/man/canon-divergence-list.1 +2 -2
- package/man/canon-divergence-resolve.1 +2 -2
- package/man/canon-divergence.1 +2 -2
- package/man/canon-evidence-add.1 +2 -2
- package/man/canon-evidence-approval-payload.1 +2 -2
- package/man/canon-evidence-audit.1 +2 -2
- package/man/canon-evidence.1 +2 -2
- package/man/canon-export.1 +2 -2
- package/man/canon-feature-new.1 +2 -2
- package/man/canon-feature.1 +2 -2
- package/man/canon-finding-add.1 +2 -2
- package/man/canon-finding-close.1 +2 -2
- package/man/canon-finding-list.1 +2 -2
- package/man/canon-finding.1 +2 -2
- package/man/canon-format.1 +2 -2
- package/man/canon-gate-check.1 +2 -2
- package/man/canon-gate-install-hooks.1 +2 -2
- package/man/canon-gate-promote.1 +2 -2
- package/man/canon-gate.1 +2 -2
- package/man/canon-ingest-plans.1 +2 -2
- package/man/canon-ingest-records.1 +2 -2
- package/man/canon-ingest-sessions.1 +2 -2
- package/man/canon-ingest.1 +2 -2
- package/man/canon-init.1 +2 -2
- package/man/canon-inventory-sync.1 +2 -2
- package/man/canon-inventory.1 +2 -2
- package/man/canon-ledger-compact.1 +2 -2
- package/man/canon-ledger.1 +2 -2
- package/man/canon-migrate.1 +15 -3
- package/man/canon-plugin-sync.1 +2 -2
- package/man/canon-plugin.1 +2 -2
- package/man/canon-policy-approve.1 +9 -3
- package/man/canon-policy-show.1 +2 -2
- package/man/canon-policy.1 +2 -2
- package/man/canon-prompt-add.1 +2 -2
- package/man/canon-prompt-show.1 +2 -2
- package/man/canon-prompt.1 +2 -2
- package/man/canon-purge.1 +2 -2
- package/man/canon-query.1 +2 -2
- package/man/canon-regime-show.1 +2 -2
- package/man/canon-regime.1 +2 -2
- package/man/canon-report-build.1 +2 -2
- package/man/canon-report-check.1 +2 -2
- package/man/canon-report-snapshot.1 +2 -2
- package/man/canon-report.1 +2 -2
- package/man/canon-retrieve.1 +2 -2
- package/man/canon-review-change.1 +2 -2
- package/man/canon-review-scenario.1 +2 -2
- package/man/canon-review.1 +2 -2
- package/man/canon-scenario-new.1 +2 -2
- package/man/canon-scenario.1 +2 -2
- package/man/canon-schema.1 +2 -2
- package/man/canon-search.1 +2 -2
- package/man/canon-selftest.1 +2 -2
- package/man/canon-skills-check.1 +2 -2
- package/man/canon-skills-doctor.1 +2 -2
- package/man/canon-skills-install.1 +2 -2
- package/man/canon-skills-show.1 +2 -2
- package/man/canon-skills.1 +2 -2
- package/man/canon-status.1 +2 -2
- package/man/canon-strategy-approval-payload.1 +2 -2
- package/man/canon-strategy-promote.1 +2 -2
- package/man/canon-strategy-rollback.1 +2 -2
- package/man/canon-strategy.1 +2 -2
- package/man/canon-subject-adopt.1 +2 -2
- package/man/canon-subject-move.1 +2 -2
- package/man/canon-subject-new.1 +2 -2
- package/man/canon-subject-show.1 +2 -2
- package/man/canon-subject-unadopt.1 +2 -2
- package/man/canon-subject.1 +2 -2
- package/man/canon-task-done.1 +2 -2
- package/man/canon-task.1 +2 -2
- package/man/canon-tier-age.1 +2 -2
- package/man/canon-tier.1 +2 -2
- package/man/canon-trace.1 +2 -2
- package/man/canon.1 +2 -2
- package/package.json +4 -4
package/man/canon-evidence.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-evidence 1 "evidence 0.
|
|
3
|
+
.TH canon-evidence 1 "evidence 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-evidence \- Author a staged, attributed evidence attestation for a plan task
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -54,4 +54,4 @@ each add to commit it (assigns run_seq).
|
|
|
54
54
|
|
|
55
55
|
See `canon evidence add \-\-help` for exactly what the gate does and does not check.
|
|
56
56
|
.SH VERSION
|
|
57
|
-
v0.
|
|
57
|
+
v0.32.0
|
package/man/canon-export.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-export 1 "export 0.
|
|
3
|
+
.TH canon-export 1 "export 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-export \- Export a redacted retention manifest without deleting records
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -105,4 +105,4 @@ Print help
|
|
|
105
105
|
\fB\-V\fR, \fB\-\-version\fR
|
|
106
106
|
Print version
|
|
107
107
|
.SH VERSION
|
|
108
|
-
v0.
|
|
108
|
+
v0.32.0
|
package/man/canon-feature-new.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-feature-new 1 "new 0.
|
|
3
|
+
.TH canon-feature-new 1 "new 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-feature\-new \- Create a fresh .feature file for a new area.surface
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -59,4 +59,4 @@ Print version
|
|
|
59
59
|
<\fISURFACE\fR>
|
|
60
60
|
<area>.<surface> the fresh .feature file scaffolds
|
|
61
61
|
.SH VERSION
|
|
62
|
-
v0.
|
|
62
|
+
v0.32.0
|
package/man/canon-feature.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-feature 1 "feature 0.
|
|
3
|
+
.TH canon-feature 1 "feature 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-feature \- Scaffold a new .feature spec file
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -36,4 +36,4 @@ Print version
|
|
|
36
36
|
canon\-feature\-new(1)
|
|
37
37
|
Create a fresh .feature file for a new area.surface
|
|
38
38
|
.SH VERSION
|
|
39
|
-
v0.
|
|
39
|
+
v0.32.0
|
package/man/canon-finding-add.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-finding-add 1 "add 0.
|
|
3
|
+
.TH canon-finding-add 1 "add 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-finding\-add \- Record one code\-review finding (promoted in the same run under `write: { promote: auto }` or with \-\-promote; under `write.promote: manual`, commit it with `canon gate promote`)
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -205,4 +205,4 @@ The loop:
|
|
|
205
205
|
Under `write.promote: manual` (no `write:` key), run `canon gate promote` to
|
|
206
206
|
commit it.
|
|
207
207
|
.SH VERSION
|
|
208
|
-
v0.
|
|
208
|
+
v0.32.0
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-finding-close 1 "close 0.
|
|
3
|
+
.TH canon-finding-close 1 "close 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-finding\-close \- Move an already\-committed finding\*(Aqs disposition (promoted in the same run under `write: { promote: auto }` or with \-\-promote; under `write.promote: manual`, commit it with `canon gate promote`)
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -114,4 +114,4 @@ Examples:
|
|
|
114
114
|
canon finding close s44\-spec\-derived\-worklist \-\-round 1 \-\-seq 9 \\
|
|
115
115
|
\-\-disposition rejected \-\-reason "not a defect"
|
|
116
116
|
.SH VERSION
|
|
117
|
-
v0.
|
|
117
|
+
v0.32.0
|
package/man/canon-finding-list.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-finding-list 1 "list 0.
|
|
3
|
+
.TH canon-finding-list 1 "list 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-finding\-list \- List a change\*(Aqs committed findings at their latest version: round, seq, severity, disposition, reviewer and summary
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -56,4 +56,4 @@ Print help
|
|
|
56
56
|
\fB\-V\fR, \fB\-\-version\fR
|
|
57
57
|
Print version
|
|
58
58
|
.SH VERSION
|
|
59
|
-
v0.
|
|
59
|
+
v0.32.0
|
package/man/canon-finding.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-finding 1 "finding 0.
|
|
3
|
+
.TH canon-finding 1 "finding 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-finding \- Record one code\-review finding as a durable record
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -64,4 +64,4 @@ RECORDED OBSERVATION, NOT PROOF — canon never verifies that the defect
|
|
|
64
64
|
existed, that it was fixed, or that \-\-introduced\-rev is the true cause.
|
|
65
65
|
See `canon finding add \-\-help` for exactly what it does and does not establish.
|
|
66
66
|
.SH VERSION
|
|
67
|
-
v0.
|
|
67
|
+
v0.32.0
|
package/man/canon-format.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-format 1 "format 0.
|
|
3
|
+
.TH canon-format 1 "format 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-format \- Validate a spec/artifact corpus against canon\*(Aqs format
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -46,4 +46,4 @@ Examples:
|
|
|
46
46
|
canon format spec
|
|
47
47
|
canon format spec \-\-repo ~/work/myrepo
|
|
48
48
|
.SH VERSION
|
|
49
|
-
v0.
|
|
49
|
+
v0.32.0
|
package/man/canon-gate-check.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-gate-check 1 "check 0.
|
|
3
|
+
.TH canon-gate-check 1 "check 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-gate\-check \- Run the coverage/ledger/staleness/trust checks (0 clean, 1 red, 2 usage)
|
|
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.
|
|
44
|
+
v0.32.0
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-gate-install-hooks 1 "install-hooks 0.
|
|
3
|
+
.TH canon-gate-install-hooks 1 "install-hooks 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-gate\-install\-hooks \- Install the gate hook into .claude/settings.json / .codex/hooks.json
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -56,4 +56,4 @@ Print help
|
|
|
56
56
|
\fB\-V\fR, \fB\-\-version\fR
|
|
57
57
|
Print version
|
|
58
58
|
.SH VERSION
|
|
59
|
-
v0.
|
|
59
|
+
v0.32.0
|
package/man/canon-gate-promote.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-gate-promote 1 "promote 0.
|
|
3
|
+
.TH canon-gate-promote 1 "promote 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-gate\-promote \- Promote staged records (evidence, findings, divergences) to the committed ledger
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -59,4 +59,4 @@ Print help
|
|
|
59
59
|
\fB\-V\fR, \fB\-\-version\fR
|
|
60
60
|
Print version
|
|
61
61
|
.SH VERSION
|
|
62
|
-
v0.
|
|
62
|
+
v0.32.0
|
package/man/canon-gate.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-gate 1 "gate 0.
|
|
3
|
+
.TH canon-gate 1 "gate 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-gate \- Run evidence gates, promote staged records, install hooks
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -47,4 +47,4 @@ Examples:
|
|
|
47
47
|
canon task done my\-change#3
|
|
48
48
|
canon gate install\-hooks
|
|
49
49
|
.SH VERSION
|
|
50
|
-
v0.
|
|
50
|
+
v0.32.0
|
package/man/canon-ingest-plans.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-ingest-plans 1 "plans 0.
|
|
3
|
+
.TH canon-ingest-plans 1 "plans 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-ingest\-plans \- Import plans as Change/Task records: canon\*(Aqs own .canon/changes, then the configured external sources (openspec, superpowers)
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -50,4 +50,4 @@ Print help
|
|
|
50
50
|
\fB\-V\fR, \fB\-\-version\fR
|
|
51
51
|
Print version
|
|
52
52
|
.SH VERSION
|
|
53
|
-
v0.
|
|
53
|
+
v0.32.0
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-ingest-records 1 "records 0.
|
|
3
|
+
.TH canon-ingest-records 1 "records 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-ingest\-records \- Import review/divergence/task/handoff records and derive verdicts
|
|
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.
|
|
56
|
+
v0.32.0
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-ingest-sessions 1 "sessions 0.
|
|
3
|
+
.TH canon-ingest-sessions 1 "sessions 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-ingest\-sessions \- Import agent CLI session transcripts (omp/pi, Claude Code, Codex, Hermes)
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -59,4 +59,4 @@ Print help
|
|
|
59
59
|
\fB\-V\fR, \fB\-\-version\fR
|
|
60
60
|
Print version
|
|
61
61
|
.SH VERSION
|
|
62
|
-
v0.
|
|
62
|
+
v0.32.0
|
package/man/canon-ingest.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-ingest 1 "ingest 0.
|
|
3
|
+
.TH canon-ingest 1 "ingest 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-ingest \- Import agent sessions, records, and plans into canon\*(Aqs store
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -47,4 +47,4 @@ Examples:
|
|
|
47
47
|
canon ingest records
|
|
48
48
|
canon ingest plans
|
|
49
49
|
.SH VERSION
|
|
50
|
-
v0.
|
|
50
|
+
v0.32.0
|
package/man/canon-init.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-init 1 "init 0.
|
|
3
|
+
.TH canon-init 1 "init 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-init \- Set up canon in a repo (canon.yaml, a starter policy, the AGENTS.md block, a plans home)
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -95,4 +95,4 @@ it installs nothing and says how to choose. The answer is recorded as
|
|
|
95
95
|
Rerunning in a repo that has canon.yaml leaves canon.yaml and .canon/policy.yaml
|
|
96
96
|
alone and only refreshes the canon block in AGENTS.md.
|
|
97
97
|
.SH VERSION
|
|
98
|
-
v0.
|
|
98
|
+
v0.32.0
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-inventory-sync 1 "sync 0.
|
|
3
|
+
.TH canon-inventory-sync 1 "sync 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-inventory\-sync \- Validate each spec root, then materialize scenario index records
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -47,4 +47,4 @@ Print help
|
|
|
47
47
|
\fB\-V\fR, \fB\-\-version\fR
|
|
48
48
|
Print version
|
|
49
49
|
.SH VERSION
|
|
50
|
-
v0.
|
|
50
|
+
v0.32.0
|
package/man/canon-inventory.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-inventory 1 "inventory 0.
|
|
3
|
+
.TH canon-inventory 1 "inventory 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-inventory \- Index a validated .feature corpus into the scenario ledger
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -36,4 +36,4 @@ Print version
|
|
|
36
36
|
canon\-inventory\-sync(1)
|
|
37
37
|
Validate each spec root, then materialize scenario index records
|
|
38
38
|
.SH VERSION
|
|
39
|
-
v0.
|
|
39
|
+
v0.32.0
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-ledger-compact 1 "compact 0.
|
|
3
|
+
.TH canon-ledger-compact 1 "compact 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-ledger\-compact \- Move superseded versions of every record out of the ledger into the archive
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -47,4 +47,4 @@ Print help
|
|
|
47
47
|
\fB\-V\fR, \fB\-\-version\fR
|
|
48
48
|
Print version
|
|
49
49
|
.SH VERSION
|
|
50
|
-
v0.
|
|
50
|
+
v0.32.0
|
package/man/canon-ledger.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-ledger 1 "ledger 0.
|
|
3
|
+
.TH canon-ledger 1 "ledger 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-ledger \- Keep the ledger to the current version of each record
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -51,4 +51,4 @@ this is for a ledger written before 0.23, or after an interrupted move. Idempote
|
|
|
51
51
|
`canon migrate` runs it. A record that carries a standing claim (a flagged overlay, a
|
|
52
52
|
brief override, an approval at the current evidence) stays in the ledger.
|
|
53
53
|
.SH VERSION
|
|
54
|
-
v0.
|
|
54
|
+
v0.32.0
|
package/man/canon-migrate.1
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-migrate 1 "migrate 0.
|
|
3
|
+
.TH canon-migrate 1 "migrate 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-migrate \- Bring a repo from an earlier canon up to date: the 0.17 layout (specs, changes, approvals, skills, .gitignore), the 0.28 hooks, scripts and skill stub (backed up under .canon/migrate\-backup/), the 0.23 latest\-only ledger (superseded versions to .canon/archive) and 0.23 review pins
|
|
6
6
|
.SH SYNOPSIS
|
|
7
|
-
\fBcanon migrate\fR [\fB\-\-as\fR] [\fB\-\-repo\fR] [\fB\-\-commit\fR] [\fB\-\-plan\-digest\fR] [\fB\-\-revert\fR] [\fB\-\-backup\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR]
|
|
7
|
+
\fBcanon migrate\fR [\fB\-\-as\fR] [\fB\-\-repo\fR] [\fB\-\-commit\fR] [\fB\-\-plan\-digest\fR] [\fB\-\-revert\fR] [\fB\-\-backup\fR] [\fB\-\-relayed\-via\fR] [\fB\-\-actor\fR] [\fB\-\-approver\fR] [\fB\-\-note\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
|
Bring a repo from an earlier canon up to date: the 0.17 layout (specs, changes, approvals, skills, .gitignore), the 0.28 hooks, scripts and skill stub (backed up under .canon/migrate\-backup/), the 0.23 latest\-only ledger (superseded versions to .canon/archive) and 0.23 review pins
|
|
10
10
|
.SH OPTIONS
|
|
@@ -41,6 +41,18 @@ Undo the last committed migrate (restores what it backed up, undoes its moves an
|
|
|
41
41
|
\fB\-\-backup\fR \fI<DIR>\fR
|
|
42
42
|
With \-\-revert, the backup directory to restore (default: the newest under .canon/migrate\-backup/)
|
|
43
43
|
.TP
|
|
44
|
+
\fB\-\-relayed\-via\fR \fI<NAME>\fR
|
|
45
|
+
With \-\-commit, record the human\*(Aqs answer to a plan that re\-binds `Approved:` lines on their behalf: the tool they were asked with (`ask`, `AskUserQuestion`, `chat`); an agent role may commit such a plan only with it
|
|
46
|
+
.TP
|
|
47
|
+
\fB\-\-actor\fR \fI<ACTOR_ID>\fR
|
|
48
|
+
With \-\-relayed\-via, the agent\*(Aqs actor id (default: the CANON_ACTOR environment variable)
|
|
49
|
+
.TP
|
|
50
|
+
\fB\-\-approver\fR \fI<NAME>\fR
|
|
51
|
+
With \-\-relayed\-via, who the human is
|
|
52
|
+
.TP
|
|
53
|
+
\fB\-\-note\fR \fI<TEXT>\fR
|
|
54
|
+
With \-\-relayed\-via, the human\*(Aqs answer as they gave it
|
|
55
|
+
.TP
|
|
44
56
|
\fB\-\-json\fR
|
|
45
57
|
Output JSON instead of the human\-readable form
|
|
46
58
|
.TP
|
|
@@ -108,4 +120,4 @@ kept. canon.yaml is written atomically.
|
|
|
108
120
|
every agent role). `\-\-revert` restores them byte for byte and refuses, naming the file, when one changed
|
|
109
121
|
since the migrate.
|
|
110
122
|
.SH VERSION
|
|
111
|
-
v0.
|
|
123
|
+
v0.32.0
|
package/man/canon-plugin-sync.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-plugin-sync 1 "sync 0.
|
|
3
|
+
.TH canon-plugin-sync 1 "sync 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-plugin\-sync \- Validate and write a plugin\*(Aqs overlay records
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -50,4 +50,4 @@ Print version
|
|
|
50
50
|
<\fIPLUGIN_ID\fR>
|
|
51
51
|
A .canon/plugins/<id>/plugin.yaml manifest id (e.g. porting)
|
|
52
52
|
.SH VERSION
|
|
53
|
-
v0.
|
|
53
|
+
v0.32.0
|
package/man/canon-plugin.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-plugin 1 "plugin 0.
|
|
3
|
+
.TH canon-plugin 1 "plugin 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-plugin \- Sync plugin overlay records onto the ledger
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -36,4 +36,4 @@ Print version
|
|
|
36
36
|
canon\-plugin\-sync(1)
|
|
37
37
|
Validate and write a plugin\*(Aqs overlay records
|
|
38
38
|
.SH VERSION
|
|
39
|
-
v0.
|
|
39
|
+
v0.32.0
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-policy-approve 1 "approve 0.
|
|
3
|
+
.TH canon-policy-approve 1 "approve 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-policy\-approve \- Approve the current .canon/policy.yaml (written directly; nothing to promote)
|
|
6
6
|
.SH SYNOPSIS
|
|
7
|
-
\fBcanon policy approve\fR <\fB\-\-approver\fR> [\fB\-\-as\fR] [\fB\-\-note\fR] [\fB\-\-repo\fR] [\fB\-\-json\fR] [\fB\-\-input\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR]
|
|
7
|
+
\fBcanon policy approve\fR <\fB\-\-approver\fR> [\fB\-\-as\fR] [\fB\-\-note\fR] [\fB\-\-relayed\-via\fR] [\fB\-\-actor\fR] [\fB\-\-repo\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
|
Approve the current .canon/policy.yaml (written directly; nothing to promote)
|
|
10
10
|
.SH OPTIONS
|
|
@@ -32,6 +32,12 @@ orchestrator
|
|
|
32
32
|
\fB\-\-note\fR \fI<TEXT>\fR
|
|
33
33
|
Why, or what was reviewed
|
|
34
34
|
.TP
|
|
35
|
+
\fB\-\-relayed\-via\fR \fI<NAME>\fR
|
|
36
|
+
Record the human\*(Aqs answer on their behalf: the tool they were asked with (`ask`, `AskUserQuestion`, `chat`); an agent role may run the call only with it, and then \-\-note carries the human\*(Aqs answer
|
|
37
|
+
.TP
|
|
38
|
+
\fB\-\-actor\fR \fI<ACTOR_ID>\fR
|
|
39
|
+
With \-\-relayed\-via, the agent\*(Aqs actor id (default: the CANON_ACTOR environment variable)
|
|
40
|
+
.TP
|
|
35
41
|
\fB\-\-repo\fR \fI<DIR>\fR
|
|
36
42
|
The repo to act on (default: the nearest ancestor directory holding a canon.yaml)
|
|
37
43
|
.TP
|
|
@@ -47,4 +53,4 @@ Print help
|
|
|
47
53
|
\fB\-V\fR, \fB\-\-version\fR
|
|
48
54
|
Print version
|
|
49
55
|
.SH VERSION
|
|
50
|
-
v0.
|
|
56
|
+
v0.32.0
|
package/man/canon-policy-show.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-policy-show 1 "show 0.
|
|
3
|
+
.TH canon-policy-show 1 "show 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-policy\-show \- Show the policy\*(Aqs digest and its approval (who, when, which bytes)
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -38,4 +38,4 @@ Print help
|
|
|
38
38
|
\fB\-V\fR, \fB\-\-version\fR
|
|
39
39
|
Print version
|
|
40
40
|
.SH VERSION
|
|
41
|
-
v0.
|
|
41
|
+
v0.32.0
|
package/man/canon-policy.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-policy 1 "policy 0.
|
|
3
|
+
.TH canon-policy 1 "policy 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-policy \- Record who approved the gate\*(Aqs policy (.canon/policy.yaml) and which bytes
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -49,4 +49,4 @@ approval (or whose approval cannot be read) fails closed: `gate check` exits 1
|
|
|
49
49
|
and `subject move` refuses to ship or reopen; `\-\-override\-reason` does not
|
|
50
50
|
waive it. `canon policy show` reads the approval back.
|
|
51
51
|
.SH VERSION
|
|
52
|
-
v0.
|
|
52
|
+
v0.32.0
|
package/man/canon-prompt-add.1
CHANGED
|
@@ -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.
|
|
3
|
+
.TH canon-prompt-add 1 "add 0.32.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.
|
|
47
|
+
v0.32.0
|
package/man/canon-prompt-show.1
CHANGED
|
@@ -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.
|
|
3
|
+
.TH canon-prompt-show 1 "show 0.32.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.
|
|
41
|
+
v0.32.0
|
package/man/canon-prompt.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-prompt 1 "prompt 0.
|
|
3
|
+
.TH canon-prompt 1 "prompt 0.32.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.
|
|
43
|
+
v0.32.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.
|
|
3
|
+
.TH canon-purge 1 "purge 0.32.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 <DIGEST>` deletes it
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -67,4 +67,4 @@ Print help
|
|
|
67
67
|
\fB\-V\fR, \fB\-\-version\fR
|
|
68
68
|
Print version
|
|
69
69
|
.SH VERSION
|
|
70
|
-
v0.
|
|
70
|
+
v0.32.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.
|
|
3
|
+
.TH canon-query 1 "query 0.32.0"
|
|
4
4
|
.SH NAME
|
|
5
5
|
canon\-query \- Read stored records across every storage tier
|
|
6
6
|
.SH SYNOPSIS
|
|
@@ -108,4 +108,4 @@ Print help
|
|
|
108
108
|
\fB\-V\fR, \fB\-\-version\fR
|
|
109
109
|
Print version
|
|
110
110
|
.SH VERSION
|
|
111
|
-
v0.
|
|
111
|
+
v0.32.0
|
package/man/canon-regime-show.1
CHANGED
|
@@ -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.
|
|
3
|
+
.TH canon-regime-show 1 "show 0.32.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.
|
|
50
|
+
v0.32.0
|
package/man/canon-regime.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-regime 1 "regime 0.
|
|
3
|
+
.TH canon-regime 1 "regime 0.32.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.
|
|
39
|
+
v0.32.0
|
package/man/canon-report-build.1
CHANGED
|
@@ -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.
|
|
3
|
+
.TH canon-report-build 1 "build 0.32.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.
|
|
44
|
+
v0.32.0
|
package/man/canon-report-check.1
CHANGED
|
@@ -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.
|
|
3
|
+
.TH canon-report-check 1 "check 0.32.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.
|
|
41
|
+
v0.32.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.
|
|
3
|
+
.TH canon-report-snapshot 1 "snapshot 0.32.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.
|
|
47
|
+
v0.32.0
|
package/man/canon-report.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-report 1 "report 0.
|
|
3
|
+
.TH canon-report 1 "report 0.32.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.
|
|
45
|
+
v0.32.0
|
package/man/canon-retrieve.1
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.ie \n(.g .ds Aq \(aq
|
|
2
2
|
.el .ds Aq '
|
|
3
|
-
.TH canon-retrieve 1 "retrieve 0.
|
|
3
|
+
.TH canon-retrieve 1 "retrieve 0.32.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.
|
|
56
|
+
v0.32.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.
|
|
3
|
+
.TH canon-review-change 1 "change 0.32.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.
|
|
98
|
+
v0.32.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.
|
|
3
|
+
.TH canon-review-scenario 1 "scenario 0.32.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.
|
|
98
|
+
v0.32.0
|