@erclx/canon 5.52.0 → 5.54.0

package/governance/detect.toml

@@ -9,8 +9,7 @@
 # root and in every folder to depth two. `files` are globs matched against the
 # target's git-listed paths to depth two, and against each folder on those
 # paths, so `.github/workflows` matches a folder holding a workflow. A glob with
-# no wildcard is also tested on disk, which reaches a gitignored path such as
-# `.canon/canvas`.
+# no wildcard is also tested on disk, which reaches a gitignored path.
 #
 # Every rule no stack reaches needs a table here, which the `unreferenced-rules`
 # gate stage checks, along with every key naming a live rule. A table for a rule
@@ -201,10 +200,6 @@ files = ["index.html", "*/index.html"]
 deps = ["react", "vue", "svelte", "astro", "next", "solid-js", "preact"]
 files = ["index.html", "*/index.html"]
 
-["canvas"]
-deps = []
-files = [".canon/canvas"]
-
 ["design-reference"]
 deps = []
 files = ["canon/design/*/"]

package/governance/renames.toml

@@ -73,4 +73,3 @@
 "460-design-taste" = "design-taste"
 "465-interface-casing" = "interface-casing"
 "470-motion" = "motion"
-"480-canvas" = "canvas"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@erclx/canon",
   "type": "module",
-  "version": "5.52.0",
+  "version": "5.54.0",
   "description": "Runs your agent's work and keeps its code good, on one setup for every repo.",
   "license": "MIT",
   "bin": {
@@ -51,14 +51,9 @@
     "web:e2e": "cd web && playwright test"
   },
   "dependencies": {
-    "@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"
+    "playwright-core": "1.64.1"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.8",
@@ -71,7 +66,6 @@
     "@types/bun": "^1.2.10",
     "@types/micromatch": "^4.0.10",
     "astro": "^6.1.9",
-    "happy-dom": "^20.14.5",
     "husky": "^9.1.7",
     "micromatch": "^4.0.8",
     "oxfmt": "0.73.0",

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,17 +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.',
-    expect: 'canvas-board',
-  },
   {
     prompt:
       'The operator picked the new settings panel, so land it in canon/design with an index row for it.',
@@ -97,11 +80,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/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,7 @@ 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'),
+  join(SHIPPED_CORPUS, 'teach-craft'),
 ]
 
 /**

package/src/cli/help.ts

@@ -38,15 +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'],
     ],
   },
   {
@@ -101,12 +97,7 @@ const EXAMPLES = [
   'canon indexes regen --dry-run --json',
   'canon docs list --json',
   '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 +105,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,18 +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'
 import { register as markdown } from '@/commands/markdown'
@@ -71,18 +67,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)
 markdown(program)