@erclx/canon 5.51.0 → 5.53.0

package/docs/target/migrations.md

@@ -8,6 +8,8 @@ category: Agent surface
 
 Each section is a move a project runs once, when it was scaffolded before the change it names. Run `canon upgrade` first, then `canon migrate status --json` to list the moves a project still needs in the order to run them. The recurring sync that follows is in [target sync](sync.md).
 
+`canon:target-update` is the guided path through both. It runs the moves in that order once you approve its preview.
+
 ## Move the records first, once
 
 Gitignored session records, being the task board, plans, review reports, and scratch, moved from `.claude/` to `.canon/`. Run these from inside the project, and read the `ok` field of the `--json` record rather than the exit code.
@@ -128,7 +130,7 @@ From the registry the walk reports `historyUnavailable`, so check both paths by
 | `git-commit`      | `commit`, `versioning`                                        |
 | `git-pr`          | `pr`, `publish`                                               |
 | `markdown-craft`  | `markdown`                                                    |
-| `teach-workspace` | `glossary`, `teach`                                           |
+| `teach-workspace` | `glossary`, `teach` <!-- canon-keep-retired -->               |
 | `plan-groundwork` | `groundwork`, `groundwork-spikes`                             |
 | `plan-intake`     | `intake`                                                      |
 | `plan-feature`    | `plan`, `plan-lifecycle`                                      |
@@ -146,6 +148,15 @@ The wireframes record is retired, and nothing deletes what a project holds.
 - Delete the `@canon/wireframes/index.md` line in your `CLAUDE.md` with the folder. `canon claude sync` does not rewrite it.
 - `canon gov sync` removes `.claude/rules/canon/standards/wireframes.md`
 
+## Keep or delete the retired product files, your call
+
+The learning workspace, the deck renderer, and the app recorder are retired with their verbs and skills, and nothing deletes what a project holds.
+
+- `.canon/teach/` holds rendered HTML that opens as it is, so it needs nothing <!-- canon-keep-retired -->
+- `.canon/slides/` and a `demos/` folder hold sources nothing renders any more, so delete them once nothing cites them <!-- canon-keep-retired -->
+- Replace a `canon:teach-workspace` reference with `canon:teach-craft` by hand, since `canon migrate skill-names` does not rewrite it <!-- canon-keep-retired -->
+- Delete a `canon:make-deck`, `canon:script-screencast`, `canon:record-screencast`, `canon:read-frames`, or `canon:video-craft` reference, since none has a successor <!-- canon-keep-retired -->
+
 ## Move decisions out of a held architecture record, once
 
 The toolkit no longer seeds `canon/ARCHITECTURE.md`, and a held file and its `CLAUDE.md` import stay. Move a trap a session would hit into that domain's `## Gotchas`, then delete the file and its `@canon/ARCHITECTURE.md` line.

package/docs/target/projects.md

@@ -47,7 +47,7 @@ The chain runs these phases:
 - The `verify` phase runs the installed `package.json` scripts and reports pass or fail
 - The `indexes` phase bootstraps `index.md` over the project's documentation folders, confirming candidates with you
 
-An existing project goes to `canon:target-check` first. For the Claude layer alone, run `canon claude init` and then `canon:target-setup indexes`. Run `canon:target-setup verify deep` by hand for the heavier smoke and screenshot pass.
+An existing project goes to `canon:target-check` first, then to `canon:target-update` to apply the catch-up. For the Claude layer alone, run `canon claude init` and then `canon:target-setup indexes`. Run `canon:target-setup verify deep` by hand for the heavier smoke and screenshot pass.
 
 Keep the `## Scripts` table in `canon/context/development/local-loop.md` current as scripts are added. A split entry keeps it in any entry directly under `development/`, grouping a long set into short tables under lead sentences. <!-- audit-ignore-citations: canon/context/development/local-loop.md -->
 

package/docs/target/sync.md

@@ -10,7 +10,7 @@ A target pulls toolkit changes per domain, through one catch-all and several tar
 
 ## Check first
 
-`canon sync --check <path>` reports drift without writing, split by cause. `canon:target-check` groups the same state by domain and repairs nothing.
+`canon sync --check <path>` reports drift without writing, split by cause. `canon:target-check` groups the same state by domain and repairs nothing. `canon:target-update` is the guided path, previewing the drift and then applying it on your go-ahead.
 
 The report opens with the binary version against the newest published one, and a version behind means run `canon upgrade` first.
 

package/docs/workflow/parallel-features.md

@@ -32,7 +32,7 @@ Assert the orchestrator role in one warm session with `canon:role-orchestrator`.
 
 - To pick otherwise, rewrite that line as `overridden at execution to <pick>,` plus the measurement, and add one line to the open task's `## Findings`
 
-- `canon records validate plans [plan]` reports a plan breaking its standard, plus `structure` misses that never set the exit, and takes `groundwork`, `intake`, and `teach`
+- `canon records validate plans [plan]` reports a plan breaking its standard, plus `structure` misses that never set the exit, and takes `groundwork` and `intake`
 - `canon records push` and `canon records pull` carry `.canon/` to and from a private repository. See [records](../agents/records.md).
 - `canon records size`, `canon records prune-tmp`, and `canon records stale canonical` report folder size, idle scratch, and releases since the requirements review
 - `canon tasks archive` moves a shipped plan to `.canon/plans/archive/` and retargets the task's `Plan:` line

package/docs/workflow/skill-map-on-request.md

@@ -10,24 +10,15 @@ These skills serve a request rather than a moment. With the [skill map](skill-ma
 
 ## Generate an artifact on demand
 
-| Skill                     | When to use                                                                        |
-| ------------------------- | ---------------------------------------------------------------------------------- |
-| `canon:create-rule`       | A project rule the toolkit does not ship                                           |
-| `canon:create-skill`      | A new `SKILL.md`                                                                   |
-| `canon:write-doc`         | A new `docs/` page, context entry, or `README.md`                                  |
-| `canon:draft-doc`         | Never on purpose. A pointer naming `write-doc` <!-- canon-keep-retired -->         |
-| `canon:plan-ready`        | Finished files a worker should copy                                                |
-| `canon:draft-ready`       | Never on purpose. A pointer naming `plan-ready` <!-- canon-keep-retired -->        |
-| `canon:draw-figure`       | A figure or architecture view inside a doc                                         |
-| `canon:draft-figure`      | Never on purpose. A pointer naming `draw-figure` <!-- canon-keep-retired -->       |
-| `canon:ci-workflow`       | A GitHub Actions workflow file                                                     |
-| `canon:make-deck`         | A deck rendered to editable PowerPoint                                             |
-| `canon:draft-slides`      | Never on purpose. A pointer naming `make-deck` <!-- canon-keep-retired -->         |
-| `canon:script-screencast` | A recording script with beats seeded                                               |
-| `canon:draft-screencast`  | Never on purpose. A pointer naming `script-screencast` <!-- canon-keep-retired --> |
-| `canon:record-screencast` | Recording a screencast draft into a finished mp4                                   |
-| `canon:design-identity`   | A logo mark and social card                                                        |
-| `canon:draft-identity`    | Never on purpose. A pointer naming `design-identity` <!-- canon-keep-retired -->   |
+| Skill                   | When to use                                       |
+| ----------------------- | ------------------------------------------------- |
+| `canon:create-rule`     | A project rule the toolkit does not ship          |
+| `canon:create-skill`    | A new `SKILL.md`                                  |
+| `canon:write-doc`       | A new `docs/` page, context entry, or `README.md` |
+| `canon:plan-ready`      | Finished files a worker should copy               |
+| `canon:draw-figure`     | A figure or architecture view inside a doc        |
+| `canon:ci-workflow`     | A GitHub Actions workflow file                    |
+| `canon:design-identity` | A logo mark and social card                       |
 
 ## Answer a question at any point
 
@@ -35,9 +26,6 @@ These skills serve a request rather than a moment. With the [skill map](skill-ma
 | --------------------------- | ----------------------------------------------------- |
 | `canon:canon-cli`           | To pick a `canon` verb, or learn which can lose edits |
 | `canon:youtube-transcripts` | A video transcript wanted as context                  |
-| `canon:read-frames`         | To read a recorded demo back frame by frame           |
-| `canon:teach-workspace`     | To learn a subject across sessions                    |
+| `canon:teach-craft`         | To teach a subject so it sticks                       |
 | `canon:markdown-craft`      | Before a substantial markdown edit                    |
 | `canon:write-human`         | Before drafting or revising prose                     |
-
-Ask `canon:teach-workspace` to promote a learning workspace's reference pages and glossaries. It proposes a destination per page and waits. An Anthropic-owned subject goes to the wiki, an internal one to the matching context entry, and the rest to the public docs. A project with no wiki folder gets a refusal naming the folder to create.

package/docs/workflow/skill-map.md

@@ -17,19 +17,18 @@ Groups run in the order a project meets them. Every name `canon claude skills li
 
 ## Decide what to build
 
-| Skill                      | When to use                                                                  |
-| -------------------------- | ---------------------------------------------------------------------------- |
-| `canon:plan-intake`        | The input is a pile of findings                                              |
-| `canon:plan-intake-answer` | An intake folder holds unread slots                                          |
-| `canon:backlog-triage`     | The backlog needs pruning                                                    |
-| `canon:plan-groundwork`    | The state is unmeasured and approaches compete                               |
-| `canon:decision-escalate`  | Open decisions turn on your preference                                       |
-| `canon:pick-by-eye`        | The call is taste, wanting candidates side by side                           |
-| `canon:draft-and-pick`     | Never on purpose. A pointer naming `pick-by-eye` <!-- canon-keep-retired --> |
-| `canon:canvas-board`       | A direction should be drawn as editable frames                               |
-| `canon:task-board`         | A decided item needs a file on the board                                     |
-| `canon:plan-feature`       | The approach is settled and needs a plan                                     |
-| `canon:codebase-layout`    | A change adds a file and needs a folder                                      |
+| Skill                      | When to use                                        |
+| -------------------------- | -------------------------------------------------- |
+| `canon:plan-intake`        | The input is a pile of findings                    |
+| `canon:plan-intake-answer` | An intake folder holds unread slots                |
+| `canon:backlog-triage`     | The backlog needs pruning                          |
+| `canon:plan-groundwork`    | The state is unmeasured and approaches compete     |
+| `canon:decision-escalate`  | Open decisions turn on your preference             |
+| `canon:pick-by-eye`        | The call is taste, wanting candidates side by side |
+| `canon:canvas-board`       | A direction should be drawn as editable frames     |
+| `canon:task-board`         | A decided item needs a file on the board           |
+| `canon:plan-feature`       | The approach is settled and needs a plan           |
+| `canon:codebase-layout`    | A change adds a file and needs a folder            |
 
 ## Build the feature
 
@@ -47,7 +46,6 @@ Groups run in the order a project meets them. Every name `canon claude skills li
 | `canon:search-craft`          | Before searching outside the project               |
 | `canon:systematic-debugging`  | A test fails or a bug surfaces                     |
 | `canon:design-taste`          | Drafting or judging an interface                   |
-| `canon:video-craft`           | Before composing or judging a video                |
 | `canon:ui-checklist`          | After a UI change, to list what to check           |
 
 ## Check the work before it leaves the branch
@@ -103,6 +101,7 @@ Groups run in the order a project meets them. Every name `canon claude skills li
 | Skill                         | When to use                                             |
 | ----------------------------- | ------------------------------------------------------- |
 | `canon:target-check`          | In a target, to compare each domain with the toolkit    |
+| `canon:target-update`         | After a release, to catch a target up to the toolkit    |
 | `canon:document-repair`       | Rewrite a failing docs folder to the limits and gate it |
 | `canon:canon-feedback`        | The toolkit is broken, missing, or off                  |
 | `canon:canon-feedback-triage` | In the toolkit repo, to file feedback issues            |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@erclx/canon",
   "type": "module",
-  "version": "5.51.0",
+  "version": "5.53.0",
   "description": "Runs your agent's work and keeps its code good, on one setup for every repo.",
   "license": "MIT",
   "bin": {
@@ -54,10 +54,7 @@
     "@preact/signals": "^2.11.3",
     "commander": "^13.1.0",
     "execa": "^9.5.2",
-    "highlight.js": "^11.12.0",
-    "jszip": "^3.10.1",
     "playwright-core": "1.64.1",
-    "pptxgenjs": "^4.0.1",
     "preact": "^11.0.0"
   },
   "devDependencies": {

package/scripts/core/regen-web-previews.ts

@@ -2,19 +2,14 @@
  * Writes `web/public/previews/design-tokens/index.html` and `design.css` by
  * calling `renderDesignDoc` directly, the in-process pattern
  * `regen-web-favicon.ts` already takes rather than spawning a subprocess.
- * Writes `web/public/previews/teach-workspace/` the same way, calling
- * `generateNav` over an isolated copy of one workspace.
  *
- * Both are embedded live in a landing section as an `<iframe>` rather than a
+ * It is embedded live in a landing section as an `<iframe>` rather than a
  * screenshot, since `web/e2e/home.spec.ts` asserts no `<img>` renders inside
  * `<main>`.
  */
-import { cpSync, existsSync, mkdtempSync, readFileSync, rmSync } from 'node:fs'
-import { tmpdir } from 'node:os'
-import { join } from 'node:path'
+import { readFileSync } from 'node:fs'
 import { DESIGN_DOCUMENT } from '@/design/regen'
 import { renderDesignDoc } from '@/design/render'
-import { generateNav } from '@/teach/nav'
 
 const root = new URL('../..', import.meta.url).pathname
 
@@ -33,63 +28,3 @@ if (!/--(color|space|type|radius)-/.test(css)) {
 }
 
 console.log('regen-web-previews: wrote web/public/previews/design-tokens/')
-
-/**
- * The workspace ships alone, on its own isolated nav tree, rather than
- * copied straight out of `.canon/teach/`. That folder cross-links every
- * sibling workspace by relative path, including the operator's own personal
- * study notes, so a copy carrying its live chrome would ship either dead
- * links or a path into content never meant to be public. Regenerating the
- * chrome over a scratch copy holding this one workspace alone is what keeps
- * the jump menus from naming anything else.
- *
- * `.canon/teach/` is gitignored session scratch, per `claude/skills/teach-workspace/references/teach.md`, so
- * it exists on the machine that authored the lesson and nowhere else,
- * including CI. `web/public/previews/teach-workspace/` is therefore the
- * durable copy: committed once the workspace exists, regenerated here as a
- * local convenience when authoring continues, and left untouched by a build
- * that cannot see the source, the same way a target without Playwright still
- * builds against a committed capture.
- */
-const TEACH_SLUG = '04-governance-rule-loading'
-const teachSource = `${root}.canon/teach/${TEACH_SLUG}`
-
-if (!existsSync(teachSource)) {
-  console.log(
-    `regen-web-previews: no workspace at .canon/teach/${TEACH_SLUG} on this machine, leaving the committed web/public/previews/teach-workspace/ as is`,
-  )
-} else {
-  const scratchRoot = mkdtempSync(join(tmpdir(), 'canon-teach-preview-'))
-  try {
-    cpSync(teachSource, join(scratchRoot, '.canon', 'teach', TEACH_SLUG), {
-      recursive: true,
-    })
-
-    const nav = await generateNav(scratchRoot)
-    if (!nav.ok) {
-      console.error(`regen-web-previews: ${nav.message}`)
-      process.exit(1)
-    }
-    if (nav.lessons === 0) {
-      console.error(
-        'regen-web-previews: teach-workspace render carries no lesson, refusing an empty preview',
-      )
-      process.exit(1)
-    }
-
-    const dest = `${root}web/public/previews/teach-workspace`
-    rmSync(dest, { recursive: true, force: true })
-    cpSync(join(scratchRoot, '.canon', 'teach'), dest, {
-      recursive: true,
-      // Only the rendered chrome ships. MISSION.md, RESOURCES.md, and
-      // GLOSSARY.md carry links relative to `.canon/teach/`, which resolve to
-      // nothing once copied under `web/public/`, and nothing links to them
-      // from the rendered pages anyway.
-      filter: (path) => !path.endsWith('.md'),
-    })
-  } finally {
-    rmSync(scratchRoot, { recursive: true, force: true })
-  }
-
-  console.log('regen-web-previews: wrote web/public/previews/teach-workspace/')
-}

package/src/audits/catalog.ts

@@ -496,7 +496,6 @@ const RECORD_KINDS: readonly (readonly [string, Corpus])[] = [
   ['plans', 'per-machine'],
   ['groundwork', 'per-machine'],
   ['intake', 'per-machine'],
-  ['teach', 'per-machine'],
 ]
 
 /**

package/src/browser/engine.ts

@@ -7,9 +7,8 @@
  * The two absences are different states with different remedies. A package that
  * never resolved means the target installed the CLI without the engine, and a
  * binary that was never downloaded means the engine is present and its browser
- * is not. Both were spelled inside `src/demo/` when `demo` was the only command
- * driving a browser, and a second command is what makes them shared rather than
- * local.
+ * is not. Every command driving a browser reads both, so they sit here rather
+ * than beside one caller.
  */
 
 /** Fetches the browser revision the pinned engine expects. */
@@ -72,9 +71,7 @@ export interface KeyboardPage {
  * browser in pointer modality, where that rule does not match, so a reader
  * calling it alone reports every correctly styled element as unstyled.
  *
- * It moved here when `@/driver/probes/focus` became the second call site,
- * matching how the launch-failure split moved out of `src/demo/` once
- * `canon inventory` became the second command driving a browser. One press
+ * It moved here when `@/driver/probes/focus` became the second call site. One press
  * covers the page rather than the element that happens to hold focus, so it
  * survives the blur every reader takes next.
  */

package/src/capture/render.ts

@@ -16,7 +16,7 @@ import { formatStamp, hashSource, stampPath } from '@/capture/stamp'
  * `src/commands/capture.ts` reaches it through a dynamic import so `src/cli.ts`
  * never resolves the engine at startup.
  *
- * It ships, like `@/demo/drive`, `@/inventory/walk`, and `@/driver/drive`.
+ * It ships, like `@/inventory/walk` and `@/driver/drive`.
  * Regenerating this repository's own committed images was the reason it stayed
  * behind, and it was a reason about one caller rather than about the mechanism:
  * a target renders its own generated pages and proves its own fonts resolved,

package/src/claude/cases/authoring.ts

@@ -24,23 +24,11 @@ export const AUTHORING_CASES: readonly SkillCase[] = [
       'Write a brand-new docs page for the capture command, nothing under docs/ covers it yet.',
     expect: 'write-doc',
   },
-  {
-    prompt:
-      'I typed draft-doc and it said the doc skill was renamed to write-doc.', // canon-keep-retired
-    // The pointer answers under its old name on purpose. canon-keep-retired
-    expect: 'draft-doc',
-  },
   {
     prompt:
       'I already wrote the finished skill files, package them as a ready folder with a plan and a task for a worker to copy.',
     expect: 'plan-ready',
   },
-  {
-    prompt:
-      'I typed draft-ready and it said the ready skill was renamed to plan-ready.', // canon-keep-retired
-    // The pointer answers under its old name on purpose. canon-keep-retired
-    expect: 'draft-ready',
-  },
   {
     prompt: 'This project has no README.md at all, write one from scratch.',
     expect: 'write-doc',

package/src/claude/cases/misc.ts

@@ -12,12 +12,6 @@ export const MISC_CASES: readonly SkillCase[] = [
       'Show me a few different treatments for this callout so I can pick one by looking.',
     expect: 'pick-by-eye',
   },
-  {
-    prompt:
-      'I typed draft-and-pick and it said the pick skill was renamed to pick-by-eye.', // canon-keep-retired
-    // The pointer answers under its old name on purpose. canon-keep-retired
-    expect: 'draft-and-pick',
-  },
   {
     prompt:
       'Which layer of this landing page should I settle first, and what has to stay constant across it?',
@@ -28,12 +22,6 @@ export const MISC_CASES: readonly SkillCase[] = [
       'This project has no logo yet. Draft one and give me a social card to go with it.',
     expect: 'design-identity',
   },
-  {
-    prompt:
-      'I typed draft-identity and it said the identity skill was renamed to design-identity.', // canon-keep-retired
-    // The pointer answers under its old name on purpose. canon-keep-retired
-    expect: 'draft-identity',
-  },
   {
     prompt:
       'Draw the signup screen as a frame on the canvas, then restyle the element I just selected there.',
@@ -97,11 +85,6 @@ export const MISC_CASES: readonly SkillCase[] = [
       'Find me the strongest evidence on whether rent control reduces housing supply. Where should I look?',
     expect: 'search-craft',
   },
-  {
-    prompt:
-      'The composed demo video looks generic and the zoom drags. What should the captions say, and how fast should the push-in be?',
-    expect: 'video-craft',
-  },
   {
     prompt:
       "I've got the plan approved and it touches the parser, the command, and the docs. How should I build it so I don't end up with one giant diff?",

package/src/claude/cases/setup.ts

@@ -66,6 +66,13 @@ export const SETUP_CASES: readonly SkillCase[] = [
       'Report what this project has fallen behind the toolkit on, domain by domain, and fix nothing.',
     expect: 'target-check',
   },
+  // The applying half of the same moment. It previews what the check would
+  // report and then writes, which is the line between the two.
+  {
+    prompt:
+      'A new toolkit release is out, bring this project up to it and run whatever migrations it needs.',
+    expect: 'target-update',
+  },
   {
     prompt:
       "This project needs its own coding rule that the toolkit doesn't ship.",

package/src/claude/cases/workflow.ts

@@ -24,12 +24,6 @@ export const WORKFLOW_CASES: readonly SkillCase[] = [
     prompt: 'Draw me a diagram of how the pieces of this system connect.',
     expect: 'draw-figure',
   },
-  {
-    prompt:
-      'I typed draft-figure and it said the figure skill was renamed to draw-figure.', // canon-keep-retired
-    // The pointer answers under its old name on purpose. canon-keep-retired
-    expect: 'draft-figure',
-  },
   {
     prompt:
       'This onboarding doc needs a hand-drawn picture of the signup-to-active path, sketch it in and make sure it actually renders correctly.',
@@ -45,11 +39,6 @@ export const WORKFLOW_CASES: readonly SkillCase[] = [
       'Sketch out a plan for adding this new capability before we touch any code.',
     expect: 'plan-feature',
   },
-  {
-    prompt:
-      'The video just finished recording. Read it back and tell me what each part shows.',
-    expect: 'read-frames',
-  },
   {
     prompt:
       'We need to measure this properly before committing to an approach.',
@@ -92,11 +81,6 @@ export const WORKFLOW_CASES: readonly SkillCase[] = [
       'I pushed another commit to the open PR. Update the screenshot comparison on it so the reviewer sees the current head.',
     expect: 'pr-evidence',
   },
-  {
-    prompt:
-      'The screencast draft is finished. Turn it into an actual video now.',
-    expect: 'record-screencast',
-  },
   {
     prompt:
       'What should a review of a change look for beyond bugs, and how much evidence does a finding need?',
@@ -112,26 +96,6 @@ export const WORKFLOW_CASES: readonly SkillCase[] = [
       'Our backlog only ever grows, measure each row and suggest which to decline.',
     expect: 'backlog-triage',
   },
-  {
-    prompt: 'Draft me a script with beats for a screencast recording.',
-    expect: 'script-screencast',
-  },
-  {
-    prompt:
-      'I typed draft-screencast and it said the screencast skill was renamed to script-screencast.', // canon-keep-retired
-    // The pointer answers under its old name on purpose. canon-keep-retired
-    expect: 'draft-screencast',
-  },
-  {
-    prompt: 'Turn this topic into a slide deck I can render.',
-    expect: 'make-deck',
-  },
-  {
-    prompt:
-      'I typed draft-slides and it said the slides skill was renamed to make-deck.', // canon-keep-retired
-    // The pointer answers under its old name on purpose. canon-keep-retired
-    expect: 'draft-slides',
-  },
   // Rot across documents nobody changed is what this reads, rather than a
   // stated rule broken on a given line. It is also not `target-check`, which
   // asks whether a document exists and holds its sections rather than whether
@@ -168,8 +132,8 @@ export const WORKFLOW_CASES: readonly SkillCase[] = [
     expect: 'task-complete',
   },
   {
-    prompt: 'Open a learning workspace so I can study this topic properly.',
-    expect: 'teach-workspace',
+    prompt: 'Quiz me on what we covered about regular expressions yesterday.',
+    expect: 'teach-craft',
   },
   {
     prompt:

package/src/claude/skills-audit.ts

@@ -55,7 +55,6 @@ export const PRACTICE_SKILLS: readonly string[] = [
   join(SHIPPED_CORPUS, 'build-in-slices'),
   join(SHIPPED_CORPUS, 'deprecation-migration'),
   join(SHIPPED_CORPUS, 'search-craft'),
-  join(SHIPPED_CORPUS, 'video-craft'),
 ]
 
 /**

package/src/cli/help.ts

@@ -38,14 +38,11 @@ export const COMMAND_GROUPS: { title: string; rows: CommandRow[] }[] = [
     title: 'Author and render',
     rows: [
       ['design [cmd]', 'Design system'],
-      ['slides [cmd]', 'Slide decks'],
       ['capture [source]', 'Render HTML capture sources to PNG'],
       ['serve [dir]', 'Serve a directory on localhost, print the link'],
-      ['demo [cmd]', 'Record a running app'],
       ['inventory [subj]', 'Report one computed property across every route'],
       ['drive <url> <run>', 'Walk a page through interactions, measure each'],
       ['transcripts <url>', 'Fetch a YouTube transcript with frontmatter'],
-      ['teach [cmd]', 'Learning workspaces'],
       ['canvas [cmd]', 'Local canvas of pages and frames'],
     ],
   },
@@ -103,10 +100,7 @@ const EXAMPLES = [
   'canon docs agents',
   'canon design render',
   'canon canvas list --json',
-  'canon slides render',
-  'canon slides list --json',
   'canon capture assets/captures/install.html --selector .window --out assets/frames',
-  'canon serve .canon/teach',
   'canon inventory focus --json',
   'canon drive http://localhost:4173 run.json --json',
   'pbpaste | canon feedback',
@@ -114,7 +108,6 @@ const EXAMPLES = [
   'canon tasks --help --all',
   'canon tasks archive --pull-request 673 --json',
   'canon intake list toolkit-overview --unread --json',
-  'canon teach list --json',
   'canon comments scan src --json',
   'canon context audit --json',
   'canon markdown audit .claude/rules --json',

package/src/cli.ts

@@ -10,17 +10,14 @@ import { register as claude } from '@/commands/claude'
 import { register as indexes } from '@/commands/indexes'
 import { register as docs } from '@/commands/docs'
 import { register as design } from '@/commands/design'
-import { register as slides } from '@/commands/slides'
 import { register as capture } from '@/commands/capture'
 import { register as serve } from '@/commands/serve'
-import { register as demo } from '@/commands/demo'
 import { register as inventory } from '@/commands/inventory'
 import { register as driver } from '@/commands/driver'
 import { register as feedback } from '@/commands/feedback'
 import { register as transcripts } from '@/commands/transcripts'
 import { register as tasks } from '@/commands/tasks'
 import { register as intake } from '@/commands/intake'
-import { register as teach } from '@/commands/teach'
 import { register as canvas } from '@/commands/canvas'
 import { register as comments } from '@/commands/comments'
 import { register as context } from '@/commands/context'
@@ -71,17 +68,14 @@ claude(program)
 indexes(program)
 docs(program)
 design(program)
-slides(program)
 capture(program)
 serve(program)
-demo(program)
 inventory(program)
 driver(program)
 feedback(program)
 transcripts(program)
 tasks(program)
 intake(program)
-teach(program)
 canvas(program)
 comments(program)
 context(program)

package/src/commands/labels.ts

@@ -249,8 +249,8 @@ export function register(program: Command): void {
         '## Summary or ## Key changes, fails. A review, a release-please body,',
         'and a scan carrying no title skip this check.',
         '',
-        'It reports the density of that same body per section under `density`,',
-        'without failing on it: a bullet past 200 characters, more than 5 plain',
+        'It fails the density of that same body, reported per section under',
+        '`density`: a bullet past 200 characters, more than 5 plain',
         'bullets or 2 paragraphs in a row, a paragraph past 350 characters, any',
         'H3 or deeper heading, and Technical context mixing bullets with',
         'paragraphs. A bold label alone on a line splits a Key changes run, a',
@@ -279,11 +279,12 @@ export function register(program: Command): void {
         'not read, as GitHub does not read it.',
         '',
         'Exit codes:',
-        '  0  none of the eight found',
+        '  0  none of the nine found',
         '  1  refused, with the reason on stderr or in the JSON record',
         '  2  the title or body carries a phase label, a board identifier, a',
         '     session link, a banned character, a heading outside the closed',
-        '     list or a required one missing, a missing or stray closing line',
+        '     list or a required one missing, a density finding in the body, a',
+        '     missing or stray closing line',
         '     under --closes, or a title',
         "     breaking claude/skills/git-pr/references/pr.md's format, casing, or length",
         '',
@@ -718,9 +719,9 @@ async function runScan(opts: ScanOptions): Promise<number> {
     }
   }
 
-  // Reported and never gated yet. New bodies come back clean under the
-  // shape in pr.md first, so an older open pull request fails no edit event.
-  // A post is never gated, since CI reads one only after it is published.
+  // A body's density fails the scan. A post's never does, since the review
+  // post hook denies on exit 2 and scans with no title, so a post-density
+  // fail would block every dense review or reply post.
   const post = !sectionsChecked && isPost(resolved.body)
   const density = sectionsChecked
     ? bodyDensity(resolved.body)
@@ -859,6 +860,7 @@ async function runScan(opts: ScanOptions): Promise<number> {
     titleFormatIssues.length === 0 &&
     sections.outside.length === 0 &&
     sections.missing.length === 0 &&
+    !(sectionsChecked && density.length > 0) &&
     banFindings.length === 0 &&
     closing.missing.length === 0 &&
     closing.stray.length === 0

package/src/commands/records.ts

@@ -127,7 +127,6 @@ export function register(program: Command): void {
         'Examples:',
         '  canon records validate plans',
         '  canon records validate plans feature-records-by-heading',
-        '  canon records validate teach',
         '  canon records validate intake --json',
         '',
       ].join('\n'),

package/src/commands/serve.ts

@@ -40,8 +40,8 @@ export function register(program: Command): void {
         'starts it in the background and reads the record off stdout.',
         '',
         'Examples:',
-        '  canon serve .canon/teach',
-        '  canon serve .canon/teach --entry 03-fde-system-design/index.html',
+        '  canon serve site',
+        '  canon serve site --entry guide/index.html',
         '  canon serve dist --port 4000 --json',
         '  canon serve .canon/groundwork --index',
         '',