@journeykit/canon 0.27.0 → 0.28.0

package/man/canon-tier.1

@@ -0,0 +1,39 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH canon-tier 1  "tier 0.28.0" 
+.SH NAME
+canon\-tier \- Age records between storage tiers
+.SH SYNOPSIS
+\fBcanon tier\fR [\fB\-\-as\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fIsubcommands\fR>
+.SH DESCRIPTION
+Age records between storage tiers
+.SH OPTIONS
+.TP
+\fB\-\-as\fR \fI<ROLE>\fR
+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
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+planner
+.IP \(bu 2
+implementer
+.IP \(bu 2
+reviewer
+.IP \(bu 2
+orchestrator
+.RE
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help
+.TP
+\fB\-V\fR, \fB\-\-version\fR
+Print version
+.SH SUBCOMMANDS
+.TP
+canon\-tier\-age(1)
+Apply canon.yaml aging rules, moving old records to their destination tier
+.SH VERSION
+v0.28.0

package/man/canon.1

@@ -0,0 +1,169 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH canon 1  "canon 0.28.0" 
+.SH NAME
+canon \- Specs, evidence gates, and agent memory for your repo
+.SH SYNOPSIS
+\fBcanon\fR [\fB\-\-as\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fIsubcommands\fR>
+.SH DESCRIPTION
+canon keeps a repo\*(Aqs specs, review evidence, and agent strategy memory in one place: author .feature specs, task done completion on real evidence, ingest agent sessions, and retrieve role\-scoped guidance.
+.SH OPTIONS
+.TP
+\fB\-\-as\fR \fI<ROLE>\fR
+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
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+planner
+.IP \(bu 2
+implementer
+.IP \(bu 2
+reviewer
+.IP \(bu 2
+orchestrator
+.RE
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help (see a summary with \*(Aq\-h\*(Aq)
+.TP
+\fB\-V\fR, \fB\-\-version\fR
+Print version
+.SH SUBCOMMANDS
+.TP
+canon\-init(1)
+Set up canon in a repo (canon.yaml, a starter policy, the AGENTS.md block, a plans home)
+.TP
+canon\-migrate(1)
+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
+.TP
+canon\-policy(1)
+Record who approved the gate\*(Aqs policy (.canon/policy.yaml) and which bytes
+.TP
+canon\-demo(1)
+Try the evidence loop end\-to\-end in a throwaway demo repo
+.TP
+canon\-status(1)
+Show where this repo stands: subjects by status, their gaps, and the next commands
+.TP
+canon\-context(1)
+Show what you can author here: record kinds, fields, enums, policies
+.TP
+canon\-context\-pack(1)
+Create, inspect, and verify reproducible context packs
+.TP
+canon\-adapter(1)
+Validate a provider\-neutral adapter response without executing a provider
+.TP
+canon\-prompt(1)
+Register and select versioned prompt bundles
+.TP
+canon\-format(1)
+Validate a spec/artifact corpus against canon\*(Aqs format
+.TP
+canon\-feature(1)
+Scaffold a new .feature spec file
+.TP
+canon\-scenario(1)
+Add a tagged scenario to a .feature spec file
+.TP
+canon\-subject(1)
+Create and manage subjects (durable product units)
+.TP
+canon\-change(1)
+Write a plan change (.canon/changes/<slug>/brief.md) and adopt it into a subject
+.TP
+canon\-brief(1)
+Check a change\*(Aqs brief (PRD format) and see the next steps; never edits
+.TP
+canon\-inventory(1)
+Index a validated .feature corpus into the scenario ledger
+.TP
+canon\-gate(1)
+Run evidence gates, promote staged records, install hooks
+.TP
+canon\-task(1)
+Flip a plan task\*(Aqs checkbox once committed evidence supports it
+.TP
+canon\-evidence(1)
+Author a staged, attributed evidence attestation for a plan task
+.TP
+canon\-artifacts(1)
+Check or move the evidence artifact store (local, or an object\-store tier)
+.TP
+canon\-finding(1)
+Record one code\-review finding as a durable record
+.TP
+canon\-review(1)
+Record an attributed review verdict
+.TP
+canon\-divergence(1)
+Stage, promote, resolve, and inspect spec divergences
+.TP
+canon\-ingest(1)
+Import agent sessions, records, and plans into canon\*(Aqs store
+.TP
+canon\-retrieve(1)
+Fetch role\-scoped strategy guidance
+.TP
+canon\-strategy(1)
+Promote a proven strategy into the git\-tracked tier
+.TP
+canon\-dispatch(1)
+Begin an agent run with retrieved guidance recorded
+.TP
+canon\-regime(1)
+Build a canonical regime key for hook scripts
+.TP
+canon\-query(1)
+Read stored records across every storage tier
+.TP
+canon\-export(1)
+Export a redacted retention manifest without deleting records
+.TP
+canon\-purge(1)
+Remove allowlisted records older than a cutoff: the bare run previews the removal set and its planDigest, `\-\-commit \-\-plan\-digest <DIGEST>` deletes it
+.TP
+canon\-report(1)
+Build, check, or snapshot the status report
+.TP
+canon\-dashboard(1)
+Serve the local status dashboard
+.TP
+canon\-plugin(1)
+Sync plugin overlay records onto the ledger
+.TP
+canon\-skills(1)
+Install canon\*(Aqs agent guides into a repo
+.TP
+canon\-tier(1)
+Age records between storage tiers
+.TP
+canon\-ledger(1)
+Keep the ledger to the current version of each record
+.TP
+canon\-selftest(1)
+Run canon\*(Aqs built\-in fixture self\-tests
+.TP
+canon\-schema(1)
+Describe canon\*(Aqs own commands: list them, or show one command\*(Aqs arguments, options, effect and exit codes
+.TP
+canon\-completion(1)
+Write the shell completion script for canon (bash, zsh or fish)
+.SH EXTRA
+Examples:
+  canon init                Set up canon in the current repo
+  canon demo init           Scaffold a throwaway demo repo to try the evidence loop
+  canon format spec         Validate a spec corpus
+  canon gate check          Run the evidence gate
+
+Learn more:
+  Use `canon <command> \-\-help` for details on any command.
+  `canon skills show canon` prints the guide built into this binary;
+  `canon skills install` writes a short stub of it per selected provider,
+  plus the script sidecar; `skills check` and `skills doctor` inspect the
+  target without deleting user files.
+.SH VERSION
+v0.28.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@journeykit/canon",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "canon — harness knowledge substrate. JS launcher: platform detection + native binary resolution.",
   "license": "MIT",
   "type": "module",
@@ -10,8 +10,12 @@
   },
   "files": [
     "bin.js",
-    "dist/**/*"
+    "dist/**/*",
+    "man"
   ],
+  "directories": {
+    "man": "./man"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -30,9 +34,9 @@
   },
   "dependencies": {},
   "optionalDependencies": {
-    "@journeykit/canon-core-darwin-arm64": "0.27.0",
-    "@journeykit/canon-core-linux-x64": "0.27.0",
-    "@journeykit/canon-core-win32-x64": "0.27.0"
+    "@journeykit/canon-core-darwin-arm64": "0.28.0",
+    "@journeykit/canon-core-linux-x64": "0.28.0",
+    "@journeykit/canon-core-win32-x64": "0.28.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",