@erclx/canon 5.68.0 → 5.70.0

package/src/design/favicon.ts

@@ -1,37 +1,109 @@
-export interface FaviconColors {
+export interface ThemePair {
   readonly light: string
   readonly dark: string
 }
 
-/** The favicon's own fills, chosen for tab size and apart from the page accent tokens. */
+export interface FaviconColors {
+  /** The tile the mark sits on, dark wherever no theme applies. */
+  readonly tile: ThemePair
+  /** The tile's edge, drawn on light alone. */
+  readonly edge: string
+  /** The c, in the text ink of each theme. */
+  readonly c: ThemePair
+  /** The pip, in the brand pair rather than the page accent. */
+  readonly pip: ThemePair
+}
+
+/** The mark's own colors, picked on the board and kept apart from the page accent tokens. */
 export const FAVICON_COLORS: FaviconColors = {
-  light: '#c42938',
-  dark: '#e54e40',
+  tile: { light: '#fbfaf8', dark: '#1b1a18' },
+  edge: '#dcdad6',
+  c: { light: '#2c2c29', dark: '#d9d7d4' },
+  pip: { light: '#c2380e', dark: '#ff6b42' },
 }
 
-/**
- * The shapes only, with the source's authoring comment dropped. Both fills are
- * replaced by a rule rather than an attribute so one branch can flip both.
- */
-export function renderFavicon(mark: string, colors: FaviconColors): string {
-  const shapes = mark
+/** The mark spans 96 of a 132 tile, with the tile's corner at 28% of its side. */
+const MARK_IN_TILE = 96 / 132
+const TILE_RADIUS = 0.28
+/** About one pixel at a 32 pixel tab icon, drawn inside the tile's bounds. */
+const EDGE_WIDTH = 4
+
+/** The source's shapes, with its authoring comment and `currentColor` fills dropped. */
+function markShapes(mark: string): string {
+  return mark
     .replace(/<!--[\s\S]*?-->/, '')
     .trim()
     .replace(/^<svg[^>]*>/, '')
     .replace(/<\/svg>$/, '')
     .replaceAll(' fill="currentColor"', '')
     .trim()
+}
 
-  return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="10 10 80 80">
+function markView(mark: string): [number, number, number, number] {
+  const view = /viewBox="([^"]+)"/
+    .exec(mark)?.[1]
+    .trim()
+    .split(/[\s,]+/)
+  const numbers = view?.map(Number) ?? []
+  if (numbers.length !== 4 || numbers.some((n) => !Number.isFinite(n))) {
+    throw new Error('the mark carries no viewBox of four numbers')
+  }
+  return numbers as [number, number, number, number]
+}
+
+const round = (n: number): number => Math.round(n * 100) / 100
+
+/**
+ * The mark on its tile. The base rules draw the dark set, which a renderer
+ * ignoring the media query shows, and a light preference swaps in the light
+ * set. A browser reports light when no scheme is set, so a tab there shows the
+ * light tile. Every fill is a rule rather than an attribute so the light branch
+ * can flip them all.
+ */
+export function renderFavicon(mark: string, colors: FaviconColors): string {
+  const [x, y, width, height] = markView(mark)
+  const side = Math.max(width, height) / MARK_IN_TILE
+  const left = round(x + width / 2 - side / 2)
+  const top = round(y + height / 2 - side / 2)
+  const inset = EDGE_WIDTH / 2
+  const shapes = markShapes(mark)
+
+  return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${left} ${top} ${round(side)} ${round(side)}">
   <style>
-    path, rect { fill: ${colors.light}; }
-    @media (prefers-color-scheme: dark) { path, rect { fill: ${colors.dark}; } }
+    .tile { fill: ${colors.tile.dark}; stroke: ${colors.tile.dark}; }
+    .c { fill: ${colors.c.dark}; }
+    .pip { fill: ${colors.pip.dark}; }
+    @media (prefers-color-scheme: light) {
+      .tile { fill: ${colors.tile.light}; stroke: ${colors.edge}; }
+      .c { fill: ${colors.c.light}; }
+      .pip { fill: ${colors.pip.light}; }
+    }
   </style>
+  <rect class="tile" x="${round(left + inset)}" y="${round(top + inset)}" width="${round(side - EDGE_WIDTH)}" height="${round(side - EDGE_WIDTH)}" rx="${round(side * TILE_RADIUS - inset)}" stroke-width="${EDGE_WIDTH}" />
+  <g class="c">
   ${shapes.replace(/\n\s*/g, '\n  ')}
+  </g>
 </svg>
 `
 }
 
+/**
+ * The bare mark in fixed fills, for a surface that loads it as an image and
+ * so has neither a CSS context for `currentColor` nor a theme of its own.
+ */
+export function renderMark(
+  mark: string,
+  fills: { readonly c: string; readonly pip: string },
+): string {
+  const svg = mark.replace(/<!--[\s\S]*?-->/, '').trim()
+  const pipFill = /(<[a-z]+ [^>]*class="pip"[^>]*?) fill="[^"]*"/
+  if (!pipFill.test(svg)) {
+    throw new Error('the mark carries no filled .pip shape')
+  }
+  const pip = svg.replace(pipFill, `$1 fill="${fills.pip}"`)
+  return `${pip.replaceAll('currentColor', fills.c)}\n`
+}
+
 /**
  * The `<link rel="icon">` a page carries the rendered favicon in, inlined so a
  * generated page needs no sibling file and no href that varies with its depth.

package/src/design/reference.ts

@@ -0,0 +1,98 @@
+/**
+ * The pure half of `scripts/core/design-sync.ts`, ported from Frameboard's
+ * own sync. Frameboard frames load a shared kit, while this board's frames
+ * load their project's `../assets/`, so each project's assets land under
+ * `kit/<project>/assets/` in `canon/design/`, mirroring the board, and no two
+ * projects can overwrite one another's files of the same name.
+ */
+
+/** A `frames.json` entry the sync cannot capture, named so the file can be fixed. */
+export class MappingError extends Error {}
+
+const REFERENCE = /^[a-z0-9]+(-[a-z0-9]+)*\/[a-z0-9]+(-[a-z0-9]+)*$/
+const BOARD_REF = /^[^/\s]+\/[^/\s]+\/[^/\s]+$/
+// A link starts at a quote or `url(`, so `../../assets/` is left alone, and a
+// file name stops at `#` or `?`, which address a part of the file.
+const BOARD_LINK = /(["'(]\s*)\.\.\/assets\//g
+const BOARD_ASSET = /["'(]\s*\.\.\/assets\/([^"'()\s#?]+)/g
+
+/**
+ * Reads `frames.json`, mapping each reference, `<group>/<name>`, to the
+ * board frame `<project>/<page>/<frame>` it is captured from. An entry in
+ * any other shape throws rather than filing into the wrong folder.
+ */
+export function parseFrameMap(json: string): Map<string, string> {
+  const parsed: unknown = JSON.parse(json)
+  const frames =
+    typeof parsed === 'object' && parsed !== null && 'frames' in parsed
+      ? parsed.frames
+      : undefined
+  if (typeof frames !== 'object' || frames === null) {
+    throw new MappingError('frames.json needs a frames object.')
+  }
+  const map = new Map<string, string>()
+  for (const [reference, ref] of Object.entries(frames)) {
+    if (!REFERENCE.test(reference)) {
+      throw new MappingError(
+        `frames.json entry "${reference}" needs a kebab-case <group>/<name>.`,
+      )
+    }
+    if (typeof ref !== 'string' || !BOARD_REF.test(ref)) {
+      throw new MappingError(
+        `frames.json entry "${reference}" needs a board frame as <project>/<page>/<frame>.`,
+      )
+    }
+    map.set(reference, ref)
+  }
+  return map
+}
+
+/** The mapped board frames the board does not hold. */
+export function missingFrames(
+  map: ReadonlyMap<string, string>,
+  board: ReadonlySet<string>,
+): string[] {
+  return [...map.values()].filter((ref) => !board.has(ref))
+}
+
+/**
+ * What the folder holds of a board frame: its project asset links moved to
+ * the project's kit, every other link left as the frame wrote it. The HTML
+ * is not reformatted, since the formatter ignores the folder and the sync is
+ * its one writer.
+ */
+export function toReference(html: string, project: string): string {
+  return html.replaceAll(BOARD_LINK, `$1../kit/${project}/assets/`)
+}
+
+/** The project assets a frame loads, by their path under `assets/`, each once. */
+export function boardAssets(html: string): string[] {
+  return [...new Set([...html.matchAll(BOARD_ASSET)].map((match) => match[1]))]
+}
+
+export interface Drift {
+  readonly changed: readonly string[]
+  /** PNGs whose bytes differ, a warning since a PNG varies with the browser build. */
+  readonly pngDiffers: readonly string[]
+  readonly missing: readonly string[]
+  readonly stray: readonly string[]
+}
+
+/** Compares what a sync would write against the files the folder holds, the HTML as the source and a PNG as derived. */
+export function classifyDrift(
+  expected: ReadonlyMap<string, string | Uint8Array>,
+  tracked: ReadonlyMap<string, string | Uint8Array>,
+): Drift {
+  const changed: string[] = []
+  const pngDiffers: string[] = []
+  const missing: string[] = []
+  for (const [path, data] of expected) {
+    const copy = tracked.get(path)
+    if (copy === undefined) missing.push(path)
+    else if (!Buffer.from(copy).equals(Buffer.from(data))) {
+      ;(path.endsWith('.png') ? pngDiffers : changed).push(path)
+    }
+  }
+  const stray = [...tracked.keys()].filter((path) => !expected.has(path))
+  return { changed, pngDiffers, missing, stray }
+}

package/src/design/render.ts

@@ -3,6 +3,7 @@ import { join } from 'node:path'
 import type { Cell, DesignDoc, Row } from '@/design/parse'
 import { parseDesignDoc } from '@/design/parse'
 import { fontFaceBlock } from '@/design/css'
+import { faviconLink } from '@/design/favicon'
 import type { FontFace } from '@/design/fonts'
 import { FONT_FACES } from '@/design/fonts'
 import { colorValue } from '@/design/tokens'
@@ -12,16 +13,6 @@ export interface RenderResult {
   cssPath: string
 }
 
-/**
- * The same path data as `assets/brand/mark.svg`, colored via `colorValue`
- * since a data URI has no CSS context to resolve `currentColor` against and
- * this page renders on the light chrome `previewChrome()` sets up.
- */
-const FAVICON_COLOR = colorValue('light-accent') ?? '#a4471c'
-const FAVICON_HREF = `data:image/svg+xml,${encodeURIComponent(
-  `<svg xmlns="http://www.w3.org/2000/svg" viewBox="10 10 80 80"><path d="M34,20 L15,28 L15,72 L34,80 Z M66,20 L85,28 L85,72 L66,80 Z" fill="${FAVICON_COLOR}" /><rect x="44" y="15" width="12" height="70" rx="2" fill="${FAVICON_COLOR}" /></svg>`,
-)}`
-
 export interface RenderOptions {
   /**
    * Declare each vendored face the typography table names, and let the page
@@ -29,6 +20,11 @@ export interface RenderOptions {
    * base64 block a target's render would otherwise grow by unasked.
    */
   readonly embedFonts?: boolean
+  /**
+   * A rendered favicon SVG to inline in the head. The caller reads and renders
+   * the mark, so this module reads no brand file a target does not carry.
+   */
+  readonly favicon?: string
 }
 
 export function renderDesignDoc(
@@ -42,7 +38,10 @@ export function renderDesignDoc(
   const htmlPath = join(outDir, 'index.html')
   const faces = options.embedFonts ? namedFaces(doc) : []
   writeFileSync(cssPath, buildCss(doc, faces))
-  writeFileSync(htmlPath, buildHtml(doc, bodyFamily(doc, faces)))
+  writeFileSync(
+    htmlPath,
+    buildHtml(doc, bodyFamily(doc, faces), options.favicon),
+  )
   return { htmlPath, cssPath }
 }
 
@@ -218,7 +217,11 @@ function previewChrome(): string {
   return ['  :root {', ...lines, '  }'].join('\n')
 }
 
-function buildHtml(doc: DesignDoc, bodyStack: string): string {
+function buildHtml(
+  doc: DesignDoc,
+  bodyStack: string,
+  favicon: string | undefined,
+): string {
   const sections = [
     sectionPersonality(doc.personality),
     sectionColor(doc.color),
@@ -239,8 +242,7 @@ function buildHtml(doc: DesignDoc, bodyStack: string): string {
   return `<!doctype html>
 <html lang="en">
 <head>
-<meta charset="utf-8">
-<link rel="icon" href="${FAVICON_HREF}">
+<meta charset="utf-8">${favicon === undefined ? '' : `\n${faviconLink(favicon)}`}
 <title>Design tokens</title>
 <link rel="stylesheet" href="design.css">
 <style>

package/src/design/tokens.ts

@@ -100,7 +100,7 @@ export const REVIEWED = '2026-10-24'
 
 export const TOKENS: DesignTokens = {
   personality:
-    'Warm neutrals under one rust accent, set in Geist. The page reads as prose, and monospace appears only where a surface shows what a shell printed. One accent carries every count, link, and primary action.',
+    'Warm neutrals with actions in ink, set in Geist. The page reads as prose, and monospace appears only where a surface shows a path, a command, or what a shell printed. The rust accent marks a status the surface it shows would color, and the landing page carries none, leaving the vermilion pip of the mark as its one hue.',
 
   colorRules: [
     'One accent. Never promote a second color into a structural role.',
@@ -155,7 +155,7 @@ export const TOKENS: DesignTokens = {
     },
     {
       role: 'accent',
-      intent: 'install command, mark, primary action',
+      intent: 'a status the surface would color, such as an open pull request',
       value: '#c76b5f',
       grounds: DARK_GROUNDS,
     },
@@ -208,7 +208,7 @@ export const TOKENS: DesignTokens = {
     },
     {
       role: 'light-accent',
-      intent: 'links and primary action on light',
+      intent: 'a status the surface would color, on light',
       value: '#ad4a4b',
       grounds: LIGHT_GROUNDS,
     },
@@ -361,6 +361,7 @@ export const TOKENS: DesignTokens = {
 
   iconography: [
     'No icon library. `assets/brand/mark.svg` is the one authored icon.',
+    'The mark takes its own colors from `src/design/favicon.ts`, never the accent: the c in the text ink and the pip in a vermilion pair.',
     'The terminal draws glyphs: `│ ├ ✓ ! ✗ + - ◆ ◇ ❯`.',
   ],
 }

package/src/gate/stages.ts

@@ -248,6 +248,12 @@ export const STAGES: readonly Stage[] = [
         failure:
           'The tab icon drifted from the token source. Run bun run check and commit web/public/favicon.svg.',
       },
+      {
+        kind: 'drift',
+        pathspec: 'assets/brand/mark-color*.svg',
+        failure:
+          'The README mark pair drifted from the mark source. Run bun run check and commit assets/brand/mark-color.svg and assets/brand/mark-color-light.svg.',
+      },
       { kind: 'measure', measure: designProse },
     ],
     success: 'Design source clean',
@@ -402,9 +408,9 @@ export const STAGES: readonly Stage[] = [
     checks: [
       {
         kind: 'cli',
-        argv: ['gov', 'audit', '--gate'],
+        argv: ['gov', 'audit', '--gate', '--touched'],
         failure:
-          'A rule in a gated folder is past a shape limit or short of its ledger. Run bun src/cli.ts gov audit.',
+          'A rule in a gated folder is past a shape limit or short of its ledger. Run bun src/cli.ts gov audit --touched.',
       },
     ],
   },

package/src/gov/audit.ts

@@ -1,6 +1,6 @@
 import { existsSync, statSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
-import { join, relative, resolve, sep } from 'node:path'
+import { join, normalize, relative, resolve, sep } from 'node:path'
 import { listRuleFiles } from '@/gov/payload'
 
 /**
@@ -57,6 +57,19 @@ export const PRACTICE_FOLDERS: readonly string[] = [
   'tooling',
 ]
 
+/**
+ * The folders whose rules record house decisions. Their ledger is checked
+ * wherever one exists and owed only by a rule the branch touched, since the
+ * reasoning behind an older bullet was never written down and no backfill
+ * recovers it.
+ */
+export const CORE_FOLDERS: readonly string[] = [
+  'canon',
+  'claude',
+  'code',
+  'writing',
+]
+
 const SHIPPED_RULES = join('governance', 'rules')
 const LEDGERS = join('governance', 'ledger')
 
@@ -316,29 +329,41 @@ export function compareLedger(
     .filter((entry) => entry.bullets !== entry.rows)
 }
 
-/** Where a rule's ledger lives, or nothing when its folder carries none. */
-function ledgerPath(file: string): string | undefined {
+/**
+ * Where a rule's ledger lives and whether its absence is a finding, or nothing
+ * when its folder carries none.
+ */
+function ledgerFor(
+  file: string,
+  touched: ReadonlySet<string>,
+): { path: string; owed: boolean } | undefined {
   const prefix = `${SHIPPED_RULES}${sep}`
   if (!file.startsWith(prefix)) return undefined
   const rest = file.slice(prefix.length)
   const folder = rest.split(sep)[0]
-  if (!PRACTICE_FOLDERS.includes(folder)) return undefined
-  return join(LEDGERS, rest)
+  const path = join(LEDGERS, rest)
+  if (PRACTICE_FOLDERS.includes(folder)) return { path, owed: true }
+  if (CORE_FOLDERS.includes(folder)) return { path, owed: touched.has(file) }
+  return undefined
 }
 
 async function readLedger(
   root: string,
   file: string,
   groups: readonly HeadingCount[],
+  touched: ReadonlySet<string>,
 ): Promise<LedgerReading> {
-  const path = ledgerPath(file)
-  if (path === undefined) return { status: 'not-required' }
+  const ledger = ledgerFor(file, touched)
+  if (ledger === undefined) return { status: 'not-required' }
+  const { path } = ledger
 
   let text: string
   try {
     text = await readFile(resolve(root, path), 'utf8')
   } catch {
-    return { status: 'missing', path }
+    return ledger.owed
+      ? { status: 'missing', path }
+      : { status: 'not-required' }
   }
 
   return {
@@ -352,14 +377,22 @@ async function readLedger(
  * Measures every rule this tree authors, or the files named.
  *
  * A tree holding `governance/rules/` is a canon checkout, read across both
- * authored corpora with a ledger asked of each outside-practice rule. Any
- * other tree is a target, read at `.claude/rules/project/` alone with no
+ * authored corpora with a ledger asked of each outside-practice rule and of
+ * each core rule in `touched`, and checked for any core rule carrying one.
+ * Any other tree is a target, read at `.claude/rules/project/` alone with no
  * ledger asked, since ledgers never ship.
+ *
+ * `touched` holds paths relative to the root, and leaving it out reads no core
+ * rule as touched.
  */
 export async function readRuleAudit(
   root: string,
   paths: readonly string[] = [],
+  options: { readonly touched?: readonly string[] } = {},
 ): Promise<RuleAuditReport> {
+  const touched = new Set(
+    (options.touched ?? []).map((path) => normalize(path)),
+  )
   const scope = existsSync(resolve(root, SHIPPED_RULES)) ? 'canon' : 'target'
   const corpus = scope === 'canon' ? CANON_CORPUS : TARGET_CORPUS
 
@@ -421,7 +454,11 @@ export async function readRuleAudit(
   for (const abs of files) {
     const file = relative(root, abs)
     const { groups, ...shape } = measureRule(await readFile(abs, 'utf8'))
-    rules.push({ file, ...shape, ledger: await readLedger(root, file, groups) })
+    rules.push({
+      file,
+      ...shape,
+      ledger: await readLedger(root, file, groups, touched),
+    })
   }
 
   return { kind: 'measured', scope, corpus, rules }

package/src/gov/detect.ts

@@ -253,7 +253,7 @@ function isLiteral(pattern: string): boolean {
 
 /**
  * A literal pattern is also tested on disk, since evidence such as
- * `.canon/canvas` sits in a folder a target's own `.gitignore` excludes, and
+ * `.canon/board` sits in a folder a target's own `.gitignore` excludes, and
  * the git listing never carries it.
  */
 function matchEntry(

package/src/init/steps.ts

@@ -7,8 +7,8 @@ import { GATED_CONFIG_REL, gateScopeRoots } from '@/markdown/gated'
 export type RunFactory = (args: readonly string[]) => () => Promise<boolean>
 
 /**
- * States the same fact as `docs/target/migrations.md`'s backup section in its
- * own words. Keep the two in step by hand; nothing compares them.
+ * States the same fact as `docs/migrations/by-hand.md`'s backup section
+ * in its own words. Keep the two in step by hand; nothing compares them.
  */
 const RECORDS_SETUP_NOTICE =
   "No private repository to push to yet. Run 'canon records push' once one exists to print the one-time setup command, or --skip records to silence this."

package/src/markdown/scope.ts

@@ -136,8 +136,6 @@ export const GATED_PATHS: readonly string[] = [
   'claude/skills/build-in-slices/references/adopted.md',
   'claude/skills/canon-cli/REQUIREMENT.md',
   'claude/skills/canon-cli/SKILL.md',
-  'claude/skills/canon-feedback-triage/REQUIREMENT.md',
-  'claude/skills/canon-feedback-triage/SKILL.md',
   'claude/skills/canon-feedback/REQUIREMENT.md',
   'claude/skills/canon-feedback/SKILL.md',
   'claude/skills/canon-feedback/references/template.md',
@@ -202,10 +200,10 @@ export const GATED_PATHS: readonly string[] = [
   'claude/skills/document-repair/REQUIREMENT.md',
   'claude/skills/document-repair/SKILL.md',
   'claude/skills/document-repair/references/batches.md',
-  'claude/skills/pick-by-eye/REQUIREMENT.md',
-  'claude/skills/pick-by-eye/SKILL.md',
-  'claude/skills/pick-by-eye/references/board.md',
-  'claude/skills/pick-by-eye/references/live-arms.md',
+  'claude/skills/design-pick/REQUIREMENT.md',
+  'claude/skills/design-pick/SKILL.md',
+  'claude/skills/design-pick/references/board.md',
+  'claude/skills/design-pick/references/live-arms.md',
   'claude/skills/write-doc/REQUIREMENT.md',
   'claude/skills/write-doc/SKILL.md',
   'claude/skills/write-doc/references/context.md',
@@ -229,10 +227,6 @@ export const GATED_PATHS: readonly string[] = [
   'claude/skills/design-identity/REQUIREMENT.md',
   'claude/skills/design-identity/SKILL.md',
   'claude/skills/design-identity/references/card-route.md',
-  'claude/skills/plan-ready/REQUIREMENT.md',
-  'claude/skills/plan-ready/SKILL.md',
-  'claude/skills/plan-ready/references/assembly.md',
-  'claude/skills/plan-ready/references/ready.md',
   'claude/skills/git-branch/REQUIREMENT.md',
   'claude/skills/git-branch/SKILL.md',
   'claude/skills/git-branch/references/branch.md',
@@ -391,10 +385,10 @@ export const GATED_PATHS: readonly string[] = [
   'claude/skills/test-first/references/adopted.md',
   'claude/skills/ui-checklist/REQUIREMENT.md',
   'claude/skills/ui-checklist/SKILL.md',
-  'claude/skills/ux-audit/REQUIREMENT.md',
-  'claude/skills/ux-audit/SKILL.md',
-  'claude/skills/ux-measure/REQUIREMENT.md',
-  'claude/skills/ux-measure/SKILL.md',
+  'claude/skills/ui-audit/REQUIREMENT.md',
+  'claude/skills/ui-audit/SKILL.md',
+  'claude/skills/ui-measure/REQUIREMENT.md',
+  'claude/skills/ui-measure/SKILL.md',
   'claude/skills/write-human/REQUIREMENT.md',
   'claude/skills/write-human/SKILL.md',
   'claude/skills/write-human/references/adopted.md',
@@ -404,6 +398,7 @@ export const GATED_PATHS: readonly string[] = [
   'claude/skills/youtube-transcripts/SKILL.md',
   '.claude/skills/internal-claude/REQUIREMENT.md',
   '.claude/skills/internal-docs/REQUIREMENT.md',
+  '.claude/skills/internal-feedback-triage/REQUIREMENT.md',
   '.claude/skills/internal-governance/REQUIREMENT.md',
   '.claude/skills/internal-rule-audit/REQUIREMENT.md',
   '.claude/skills/internal-sandbox-check/REQUIREMENT.md',

package/src/migrate/record-layout.ts

@@ -88,8 +88,9 @@ const RENDER = [SCRATCH, 'render'] as const
  * Every move this migration makes, as record-relative paths.
  *
  * The first two rows are batch 2's. The rest are batch 3's, in the order the
- * intake's review-folder pass listed them. A later batch appends here rather
- * than adding a second table.
+ * intake's review-folder pass listed them, then the design board, moved to
+ * the `.canon/board` folder Frameboard names. A later batch appends here
+ * rather than adding a second table.
  */
 export const RECORD_LAYOUT_MOVES: readonly RecordLayoutMove[] = [
   { kind: 'folder', from: ['review', 'memory'], to: ['memory', 'review'] },
@@ -130,6 +131,7 @@ export const RECORD_LAYOUT_MOVES: readonly RecordLayoutMove[] = [
     picks: ['picks'],
     evidence: ['evidence'],
   },
+  { kind: 'folder', from: ['canvas'], to: ['board'] },
 ]
 
 function resolveRecord(root: string, segments: readonly string[]): string {
@@ -346,7 +348,7 @@ function entriesOf(dir: string, isDirectory: boolean): string[] {
 }
 
 /**
- * What `pick-by-eye` Step 6 writes into the folder it archives a choice to:
+ * What `design-pick` Step 6 writes into the folder it archives a choice to:
  * a capture per canvas frame, named `arm-<id>`. A design handoff marks a pick
  * folder an earlier skill wrote. A folder carrying neither is evidence.
  */

package/src/migrate/skill-names.ts

@@ -54,6 +54,15 @@ import { defineRenameRules, type RenameRules } from '@/migrate/rename'
  * target on the oldest spelling lands in one pass rather than two.
  * `draft-ready` alone keys on its namespaced forms below rather than here.
  *
+ * Four skills then moved into the family their job belongs to. `pick-by-eye`
+ * was the one step of the design flow without the `design-` prefix, so it
+ * became `design-pick`. `ui-record` filmed footage while "record" already
+ * named the design record, so it became `ui-film`. `ux-audit` and
+ * `ux-measure` were the only `ux-` skills beside the `ui-` ones, so they
+ * became `ui-audit` and `ui-measure`. `draft-and-pick`, `claude-ux-audit`,
+ * and `claude-ux-measure` are retargeted onto the new names for the same
+ * reason `claude-ui-test` was.
+ *
  * Every name takes two words. Ten of these would have landed as a bare single
  * word under a plain strip, and a bare word such as `review` or `docs` is a
  * substring of ordinary prose with no token left for a later sweep to find.
@@ -92,8 +101,10 @@ export const SKILL_NAME_MAP: Readonly<Record<string, string>> = {
   'claude-teach': 'teach-workspace',
   'claude-ui-test': 'ui-checklist',
   'ui-test': 'ui-checklist',
-  'claude-ux-audit': 'ux-audit',
-  'claude-ux-measure': 'ux-measure',
+  'claude-ux-audit': 'ui-audit',
+  'claude-ux-measure': 'ui-measure',
+  'ux-audit': 'ui-audit',
+  'ux-measure': 'ui-measure',
   'claude-worker': 'role-worker',
   'claude-worktree': 'session-worktree',
   'canon-screencast': 'script-screencast',
@@ -110,8 +121,10 @@ export const SKILL_NAME_MAP: Readonly<Record<string, string>> = {
   'draft-figure': 'draw-figure',
   'draft-identity': 'design-identity',
   'draft-slides': 'make-deck',
-  'draft-and-pick': 'pick-by-eye',
+  'draft-and-pick': 'design-pick',
   'draft-screencast': 'script-screencast',
+  'pick-by-eye': 'design-pick',
+  'ui-record': 'ui-film',
 }
 
 /**
@@ -190,6 +203,10 @@ export const RENAMED_DRAFT_POINTERS: readonly string[] = [
  * what shipped or what a session ran under whatever name was current then, so
  * rewriting one makes it testify to a release or a run that never happened.
  *
+ * A replay fixture is excluded on the same argument. It records a real
+ * project's tree as that project held it, so a rewrite changes what the replay
+ * proves.
+ *
  * The record archives need no entry here. They are gitignored, so the tracked
  * listing every sweep reads never reaches them.
  */
@@ -197,7 +214,7 @@ export const SKILL_NAME_RULES: RenameRules = defineRenameRules({
   replacements: { ...SKILL_NAME_MAP, ...SKILL_CITATION_MAP },
   keepMarker: 'canon-keep-retired',
   wholeToken: true,
-  excludedPrefixes: ['scripts/eval/result-'],
+  excludedPrefixes: ['scripts/eval/result-', 'sandbox/fixtures/replay/'],
   excludedPaths: [
     'CHANGELOG.md',
     'src/migrate/skill-names.ts',

package/src/migrate/status.ts

@@ -8,9 +8,9 @@ interface Migration {
 
 /**
  * Every `canon migrate` subcommand in the order a project runs them, records
- * first. This is the source for that order, and `docs/target/migrations.md`
- * cites the verb rather than keeping a second list. A new migration joins by
- * one line here.
+ * first. This is the source for that order, and
+ * `docs/migrations/by-verb.md` cites the verb rather than keeping a
+ * second list. A new migration joins by one line here.
  */
 export const MIGRATIONS: readonly Migration[] = [
   { name: 'records', flags: [] },