@erclx/canon 5.53.0 → 5.54.0

package/src/commands/design.ts

@@ -1,53 +1,30 @@
-import { copyFileSync, existsSync, mkdirSync } from 'node:fs'
-import { basename, join, relative, resolve } from 'node:path'
+import { existsSync } from 'node:fs'
+import { join, relative } from 'node:path'
 import type { Command } from 'commander'
-import {
-  createDesignAdapter,
-  DESIGN_INSTALL_DIR,
-  DESIGN_PROJECT_SUBDIR,
-} from '@/design/adapter'
 import { buildDesignCss } from '@/design/css'
 import { HAND_DRAWN_FONT_FACES } from '@/design/fonts'
-import { addProjectFace, listProjectFaces } from '@/design/project-fonts'
-import { renderDesignDoc } from '@/design/render'
-import { DESIGN_BASE_CSS, DESIGN_DOCUMENT, regenDesign } from '@/design/regen'
+import { DESIGN_DOCUMENT, regenDesign } from '@/design/regen'
 import { checkoutMismatchWarning, PROJECT_ROOT } from '@/roots/project'
-import { creationRel, SCRATCH } from '@/roots/record'
-import { surfaceDir } from '@/roots/surface'
-import { recordStamp, runDomainSync } from '@/sync/engine'
-import { isDirectory, resolveTarget } from '@/targets/validate'
-import {
-  intro,
-  logAdd,
-  logError,
-  logInfo,
-  logWarn,
-  outro,
-  palette,
-} from '@/cli/ui'
+import { logWarn, palette } from '@/cli/ui'
 
 export function register(program: Command): void {
   const design = program
     .command('design')
     .helpOption('-h, --help', 'Show this help message')
-    .description(
-      'Design system commands (regen, css, render, install, sync, fonts)',
-    )
+    .description('Design system commands (regen, css)')
 
   design
     .command('regen')
     .helpOption('-h, --help', 'Show this help message')
-    .description(
-      'Rewrite canon/DESIGN.md and the base stylesheet from src/design/tokens.ts',
-    )
+    .description('Rewrite canon/DESIGN.md from src/design/tokens.ts')
     .addHelpText(
       'after',
       [
         '',
-        'Unlike install and sync, this runs against the toolkit checkout rather',
-        'than a target. It rewrites the record and the base stylesheet from the',
-        'token module and refuses where the record is absent, which is what the',
-        'CLI installed into a project as a dependency looks like.',
+        'This runs against the toolkit checkout rather than a target. It',
+        'rewrites the record from the token module and refuses where the record',
+        'is absent, which is what the CLI installed into a project as a',
+        'dependency looks like.',
         '',
       ].join('\n'),
     )
@@ -60,10 +37,10 @@ export function register(program: Command): void {
       // so each emits it after its own opener rather than ahead of the branch.
       const mismatch = checkoutMismatchWarning(process.cwd())
 
-      // Both outputs resolve from `PROJECT_ROOT`, which is the installed
+      // The output resolves from `PROJECT_ROOT`, which is the installed
       // package directory when the CLI runs out of a target's `node_modules`.
-      // The record is the one output that is already committed here and ships
-      // with no package, so its absence is what separates the two.
+      // The record is already committed here and ships with no package, so
+      // its absence is what separates the two.
       if (!existsSync(join(PROJECT_ROOT, DESIGN_DOCUMENT))) {
         process.stderr.write(`${GREY}┌${NC}\n`)
         if (mismatch !== undefined) logWarn(mismatch)
@@ -79,11 +56,9 @@ export function register(program: Command): void {
       )
       if (mismatch !== undefined) logWarn(mismatch)
       const result = regenDesign(PROJECT_ROOT)
-      for (const path of [result.documentPath, result.cssPath]) {
-        process.stderr.write(
-          `${GREY}│${NC} ${GREEN}✓${NC} ${relative(PROJECT_ROOT, path)}\n`,
-        )
-      }
+      process.stderr.write(
+        `${GREY}│${NC} ${GREEN}✓${NC} ${relative(PROJECT_ROOT, result.documentPath)}\n`,
+      )
       process.stderr.write(`${GREY}└${NC}\n`)
     })
 
@@ -107,278 +82,4 @@ export function register(program: Command): void {
         }),
       )
     })
-
-  design
-    .command('render')
-    .helpOption('-h, --help', 'Show this help message')
-    .description('Render DESIGN.md tokens to HTML and CSS preview')
-    .option(
-      '-s, --source <path>',
-      'Source DESIGN.md path',
-      relative(process.cwd(), surfaceDir(process.cwd(), 'DESIGN.md')),
-    )
-    .option(
-      '-o, --out <path>',
-      'Output directory',
-      creationRel(process.cwd(), SCRATCH, 'render', 'design'),
-    )
-    .option(
-      '--embed-fonts',
-      'Declare each vendored face the typography table names, and set the page body in the body stack',
-    )
-    .action((opts: { source: string; out: string; embedFonts?: boolean }) => {
-      const sourcePath = resolve(process.cwd(), opts.source)
-      const outDir = resolve(process.cwd(), opts.out)
-      const { GREEN, GREY, NC, RED, WHITE } = palette(process.stderr)
-      if (!existsSync(sourcePath)) {
-        process.stderr.write(
-          `${GREY}┌${NC}\n${GREY}│${NC} ${RED}✗${NC} ${opts.source} not found\n${GREY}└${NC}\n`,
-        )
-        process.exitCode = 1
-        return
-      }
-      process.stderr.write(
-        `${GREY}┌${NC}\n${GREY}│${NC} ${WHITE}Render design tokens${NC}\n`,
-      )
-      const result = renderDesignDoc(sourcePath, outDir, {
-        embedFonts: opts.embedFonts,
-      })
-      process.stderr.write(
-        `${GREY}│${NC} ${GREEN}✓${NC} ${result.htmlPath}\n${GREY}│${NC} ${GREEN}✓${NC} ${result.cssPath}\n${GREY}└${NC}\n`,
-      )
-    })
-
-  design
-    .command('install')
-    .description('Install the base stylesheet into a project')
-    .argument('[target]', 'Target directory', '.')
-    .helpOption('-h, --help', 'Show this help message')
-    .addHelpText(
-      'after',
-      [
-        '',
-        'Installs one toolkit-owned file and creates no override. A project',
-        `overrides a value by writing ${join(DESIGN_INSTALL_DIR, DESIGN_PROJECT_SUBDIR)}/`,
-        'itself, which sync never touches. Nothing arrives on a project that',
-        'has not run this, so a design value reaches a target on an install',
-        'rather than on the next sync. A base stylesheet already installed is',
-        'replaced.',
-        '',
-        'Exit codes:',
-        '  0  the stylesheet was installed',
-        '  1  the target is missing or is the toolkit root, or the toolkit',
-        '     source is absent',
-        '',
-      ].join('\n'),
-    )
-    .action(async (target: string) => {
-      process.exitCode = await runInstall(target)
-    })
-
-  design
-    .command('sync')
-    .description(
-      'Update the base stylesheet already installed under .claude/design/',
-    )
-    .argument('[target]', 'Target directory', '.')
-    .helpOption('-h, --help', 'Show this help message')
-    .addHelpText(
-      'after',
-      [
-        '',
-        'Replaces the shipped design files under .claude/design/ with the',
-        'toolkit copy, edited or not, and leaves',
-        `${join(DESIGN_INSTALL_DIR, DESIGN_PROJECT_SUBDIR)}/ alone. It deletes nothing it finds no`,
-        'source for.',
-        '',
-        'Exit codes:',
-        '  0  synced, already up to date, or the prompt was cancelled',
-        '  1  the target is missing or is the toolkit root',
-        '',
-      ].join('\n'),
-    )
-    .action(async (target: string) => {
-      process.exitCode = await runDomainSync(
-        createDesignAdapter(PROJECT_ROOT),
-        target,
-        { protectedRoot: PROJECT_ROOT },
-      )
-    })
-
-  registerFonts(design)
-}
-
-const FONTS_DIR = join(DESIGN_INSTALL_DIR, DESIGN_PROJECT_SUBDIR, 'fonts')
-
-interface FontsRefused {
-  readonly ok: false
-  readonly reason: string
-  readonly detail: string
-}
-
-function writeJson(record: unknown): void {
-  process.stdout.write(`${JSON.stringify(record)}\n`)
-}
-
-function refuseFonts(
-  title: string,
-  refusal: FontsRefused,
-  emitJson: boolean,
-): number {
-  if (emitJson) writeJson(refusal)
-  intro(title)
-  logError(refusal.detail)
-  outro()
-  return 1
-}
-
-/** A target that is a directory, or the refusal naming the path given. */
-function fontsTarget(target: string): string | FontsRefused {
-  const resolved = resolve(target)
-  if (!isDirectory(resolved)) {
-    return {
-      ok: false,
-      reason: 'no-target',
-      detail: `Target directory not found: ${target}`,
-    }
-  }
-  return resolved
-}
-
-function registerFonts(design: Command): void {
-  const fonts = design
-    .command('fonts')
-    .helpOption('-h, --help', 'Show this help message')
-    .description(`Read and add the project's own faces under ${FONTS_DIR}/`)
-    .addHelpText(
-      'after',
-      [
-        '',
-        `Faces are declared as @font-face rules in ${join(DESIGN_INSTALL_DIR, DESIGN_PROJECT_SUBDIR)}/fonts.css,`,
-        'which the canvas embeds into every frame. Sync never writes the folder.',
-        '',
-      ].join('\n'),
-    )
-
-  fonts
-    .command('list')
-    .helpOption('-h, --help', 'Show this help message')
-    .description('List each face the project override sheets declare')
-    .argument('[target]', 'Target directory', '.')
-    .option('--json', 'Emit the record on stdout')
-    .action((target: string, opts: { json?: boolean }) => {
-      const title = 'canon design fonts list'
-      const resolved = fontsTarget(target)
-      if (typeof resolved !== 'string') {
-        process.exitCode = refuseFonts(title, resolved, Boolean(opts.json))
-        return
-      }
-      const faces = listProjectFaces(resolved)
-      if (opts.json) writeJson({ ok: true, faces })
-      intro(title)
-      if (faces.length === 0) logInfo(`No faces declared under ${FONTS_DIR}/`)
-      for (const face of faces) {
-        const line = `${face.family} ${face.weight} ${face.style}: ${face.file} in ${face.sheet}`
-        if (face.present) logInfo(line)
-        else logWarn(`${line} (${face.problem ?? 'missing'})`)
-      }
-      outro()
-    })
-
-  fonts
-    .command('add')
-    .helpOption('-h, --help', 'Show this help message')
-    .description(
-      `Copy a woff2, woff, ttf, or otf face into ${FONTS_DIR}/ and declare it`,
-    )
-    .argument('<file>', 'Font file to copy')
-    .argument('[target]', 'Target directory', '.')
-    .requiredOption('--family <name>', 'Family name the face declares')
-    .option('--weight <n>', "Weight, or a range such as '100 900'", '400')
-    .option('--style <style>', 'normal or italic', 'normal')
-    .option('--json', 'Emit the record on stdout')
-    .action(
-      (
-        file: string,
-        target: string,
-        opts: { family: string; weight: string; style: string; json?: boolean },
-      ) => {
-        const title = 'canon design fonts add'
-        const emitJson = Boolean(opts.json)
-        const resolved = fontsTarget(target)
-        if (typeof resolved !== 'string') {
-          process.exitCode = refuseFonts(title, resolved, emitJson)
-          return
-        }
-        if (resolved === PROJECT_ROOT) {
-          process.exitCode = refuseFonts(
-            title,
-            {
-              ok: false,
-              reason: 'toolkit-root',
-              detail:
-                'Cannot run against toolkit root. Files here are the source of truth.',
-            },
-            emitJson,
-          )
-          return
-        }
-        const outcome = addProjectFace(resolved, resolve(file), {
-          family: opts.family,
-          weight: opts.weight,
-          style: opts.style,
-        })
-        if (!outcome.ok) {
-          process.exitCode = refuseFonts(title, outcome, emitJson)
-          return
-        }
-        if (emitJson) writeJson(outcome)
-        intro(title)
-        logAdd(join(DESIGN_INSTALL_DIR, DESIGN_PROJECT_SUBDIR, outcome.file))
-        logInfo(
-          `Declared ${outcome.family} ${outcome.weight} ${outcome.style} in ${outcome.sheet}`,
-        )
-        outro()
-      },
-    )
-}
-
-/**
- * Copies the base and stops. The override folder is deliberately not created:
- * an empty override is a file the project did not ask for and did not write,
- * the three-way merge already handles a missing side, and an empty file invites
- * a target to fill it before it has an opinion.
- */
-async function runInstall(target: string): Promise<number> {
-  intro('canon design install')
-
-  const resolved = resolveTarget(target, PROJECT_ROOT)
-  if (typeof resolved === 'number') {
-    outro()
-    return resolved
-  }
-
-  const source = join(PROJECT_ROOT, DESIGN_BASE_CSS)
-  if (!existsSync(source)) {
-    logError(
-      `No base stylesheet at ${DESIGN_BASE_CSS}. Run canon design regen.`,
-    )
-    outro()
-    return 1
-  }
-
-  const dir = join(resolved, DESIGN_INSTALL_DIR)
-  mkdirSync(dir, { recursive: true })
-
-  const dest = join(dir, basename(source))
-  copyFileSync(source, dest)
-  logAdd(relative(resolved, dest))
-
-  await recordStamp(createDesignAdapter(PROJECT_ROOT), resolved, new Date())
-
-  logInfo(
-    `Override a value in ${join(DESIGN_INSTALL_DIR, DESIGN_PROJECT_SUBDIR)}/, which sync leaves alone.`,
-  )
-  outro()
-  return 0
 }

package/src/commands/sync.ts

@@ -35,7 +35,6 @@ import { describeSkew } from '@/version/skew'
 
 const SYNC_ARGS: Record<SyncDomain, readonly string[]> = {
   governance: ['gov', 'sync'],
-  design: ['design', 'sync'],
   claude: ['claude', 'sync'],
 }
 
@@ -58,10 +57,10 @@ export function register(program: Command): void {
       'after',
       [
         '',
-        'Runs `canon gov sync`, `canon design sync`, and `canon claude sync`',
-        'on each domain installed, so each carries its own replace behavior:',
-        'governance replaces an edited rule and deletes a retired one, design',
-        'replaces its shipped files, and claude writes .gitignore alone.',
+        'Runs `canon gov sync` and `canon claude sync` on each domain',
+        'installed, so each carries its own replace behavior: governance',
+        'replaces an edited rule and deletes a retired one, and claude writes',
+        '.gitignore alone.',
         'Tooling is not synced. Refuses a dirty working tree.',
         '',
         'Exit codes:',

package/src/design/regen.ts

@@ -1,42 +1,20 @@
 import { mkdirSync, writeFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
-import { buildDesignCss } from '@/design/css'
 import { renderDesignDocument } from '@/design/document'
-import { NEUTRAL_TOKENS } from '@/design/neutral'
 
 /**
- * The two artifacts the token sources produce, written by `canon design regen`
- * and asserted for drift by the `design` stage of `bun run check`. The
- * document renders from `TOKENS` and the stylesheet from `NEUTRAL_TOKENS`.
- *
- * The document is what a person reads and the stylesheet is what a target
- * installs, and neither is edited by hand. That is the cost the operator took
- * on when the tokens moved into a module: two artifacts where the record used
- * to be one, and a regen step that has to run or both go stale silently. The
- * gate stage is what keeps silently out of it.
+ * The record the token module renders, written by `canon design regen` and
+ * asserted for drift by the `design` stage of `bun run check`. It is never
+ * edited by hand. That is the cost the operator took on when the tokens moved
+ * into a module: a regen step that has to run or the record goes stale
+ * silently. The gate stage is what keeps silently out of it.
  */
 
 /** The rendered record, at the path `claude/skills/design-record/references/design.md` fixes for it. */
 export const DESIGN_DOCUMENT = join('canon', 'DESIGN.md')
 
-/**
- * The base stylesheet a target installs. It sits inside `src/` because that is
- * the folder the published package ships, and beside the module that writes it
- * because a generated file kept away from its generator is one nobody thinks to
- * regenerate.
- */
-export const DESIGN_BASE_CSS = join('src', 'design', 'base.css')
-
-const BASE_BANNER = [
-  'Generated by `canon design regen` from src/design/neutral.ts. Do not edit.',
-  'This is the base half of a design install. A target overrides a value in',
-  '.claude/design/project/, which the three-way merge leaves alone, so this',
-  'file changes freely and nothing a project wrote lives in it.',
-].join('\n   ')
-
 export interface RegenResult {
   readonly documentPath: string
-  readonly cssPath: string
 }
 
 function write(root: string, rel: string, body: string): string {
@@ -49,10 +27,5 @@ function write(root: string, rel: string, body: string): string {
 export function regenDesign(root: string): RegenResult {
   return {
     documentPath: write(root, DESIGN_DOCUMENT, renderDesignDocument()),
-    cssPath: write(
-      root,
-      DESIGN_BASE_CSS,
-      buildDesignCss(NEUTRAL_TOKENS, { banner: BASE_BANNER }),
-    ),
   }
 }

package/src/design/render.ts

@@ -259,7 +259,7 @@ ${previewChrome()}
 </head>
 <body>
 <h1>Design tokens</h1>
-<p class="note">Generated from <code>canon/DESIGN.md</code> by <code>canon design render</code>. Token preview only, not a screen mock.</p>${summary}
+<p class="note">Generated from <code>canon/DESIGN.md</code> by <code>bun run web:previews</code>. Token preview only, not a screen mock.</p>${summary}
 ${sections.join('\n')}
 </body>
 </html>

package/src/design/tokens.ts

@@ -84,8 +84,9 @@ const MONO = 'Noto Sans Mono, DejaVu Sans Mono, monospace'
  * The proportional stack every role but `code` declares. Geist is the face the
  * visual-direction track set throughout, embedded through `FONT_FACES`.
  *
- * The stack stops at two names and a generic because `src/design/base.css` is
- * written by `canon design regen` and formatted by prettier, and a declaration
+ * The stack stops at two names and a generic because
+ * `web/src/styles/tokens.css` is written by `bun run web:tokens` and formatted
+ * by oxfmt, and a declaration
  * past 80 columns is wrapped by the second and flattened by the first. Every
  * emitted line stays inside the width so the two writers never disagree.
  */

package/src/gate/stages.ts

@@ -212,10 +212,10 @@ export const STAGES: readonly Stage[] = [
   },
   {
     // `canon/DESIGN.md`, the web stylesheet, and the tab icon are written
-    // from `src/design/tokens.ts`, the base stylesheet from
-    // `src/design/neutral.ts`, and none is edited by hand. Four artifacts
-    // from two token sources is the cost of the token move, and a render step that has to run is only safe while something fails
-    // when it did not, which is this. The record and the worked example are
+    // from `src/design/tokens.ts`, and none is edited by hand. Three
+    // artifacts from one token source is the cost of the token move, and a
+    // render step that has to run is only safe while something fails when it
+    // did not, which is this. The record and the worked example are
     // then counted against the prose budget, which the drift asserts cannot
     // see since a regenerated paragraph agrees with its source.
     id: 'design',
@@ -232,12 +232,6 @@ export const STAGES: readonly Stage[] = [
         failure:
           'The design record drifted from the token source. Run bun run check and commit canon/DESIGN.md.',
       },
-      {
-        kind: 'drift',
-        pathspec: 'src/design/base.css',
-        failure:
-          'The base stylesheet drifted from the token source. Run bun run check and commit src/design/base.css.',
-      },
       {
         kind: 'command',
         argv: ['bun', 'run', 'web:tokens'],

package/src/gov/audit.ts

@@ -45,13 +45,8 @@ export const RULE_GATED_FOLDERS: readonly string[] = [
 /**
  * Rule files in a gated folder whose findings `--gate` still passes, one path
  * each and never a folder, so a new rule beside one is gated the day it lands.
- *
- * `ui/canvas.md` carries a shape finding and no ledger, and v149.2 removes the
- * rule, so this entry goes with it.
  */
-export const RULE_GATE_EXEMPT: readonly string[] = [
-  join('governance', 'rules', 'ui', 'canvas.md'),
-]
+export const RULE_GATE_EXEMPT: readonly string[] = []
 
 /** The folders whose rules claim outside practice, so each carries a ledger. */
 export const PRACTICE_FOLDERS: readonly string[] = [

package/src/markdown/scope.ts

@@ -136,9 +136,6 @@ export const GATED_PATHS: readonly string[] = [
   'claude/skills/canon-feedback/REQUIREMENT.md',
   'claude/skills/canon-feedback/SKILL.md',
   'claude/skills/canon-feedback/references/template.md',
-  'claude/skills/canvas-board/REQUIREMENT.md',
-  'claude/skills/canvas-board/SKILL.md',
-  'claude/skills/canvas-board/references/canvas.md',
   'claude/skills/ci-workflow/REQUIREMENT.md',
   'claude/skills/ci-workflow/SKILL.md',
   'claude/skills/ci-workflow/references/workflows.md',
@@ -203,6 +200,7 @@ export const GATED_PATHS: readonly string[] = [
   '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/write-doc/REQUIREMENT.md',
   'claude/skills/write-doc/SKILL.md',
@@ -375,6 +373,7 @@ export const GATED_PATHS: readonly string[] = [
   'claude/skills/task-complete/references/unusable-baseline.md',
   'claude/skills/teach-craft/REQUIREMENT.md',
   'claude/skills/teach-craft/SKILL.md',
+  'claude/skills/teach-craft/references/adopted.md',
   'claude/skills/teach-craft/references/lesson-craft.md',
   'claude/skills/teach-craft/references/pedagogy.md',
   'claude/skills/test-craft/REQUIREMENT.md',
@@ -399,7 +398,6 @@ export const GATED_PATHS: readonly string[] = [
   'claude/skills/write-human/references/machine-tells.md',
   'claude/skills/youtube-transcripts/REQUIREMENT.md',
   'claude/skills/youtube-transcripts/SKILL.md',
-  '.claude/skills/internal-canvas/REQUIREMENT.md',
   '.claude/skills/internal-claude/REQUIREMENT.md',
   '.claude/skills/internal-docs/REQUIREMENT.md',
   '.claude/skills/internal-governance/REQUIREMENT.md',

package/src/shipped/references.ts

@@ -15,8 +15,7 @@ import { isMarked } from '@/sweep/exempt-marker'
  * number resolves.
  *
  * That is also what keeps the check a prose pattern rather than a parser.
- * `src/design/base.css` and `src/design/tokens.ts` carry sixteen values shaped
- * `#191512`, which no width or boundary rule separates from a pull request
+ * `src/design/tokens.ts` carries twenty values shaped `#191512`, which no width or boundary rule separates from a pull request
  * number, so telling them apart would need the line's syntactic position.
  */
 export const SHIPPED_CORPORA = [

package/src/sync/check.ts

@@ -2,7 +2,6 @@ import { existsSync } from 'node:fs'
 import { basename, join, sep } from 'node:path'
 import { execa } from 'execa'
 import { gitEnv } from '@/git/env'
-import { createDesignAdapter, DESIGN_INSTALL_DIR } from '@/design/adapter'
 import { createGovAdapter } from '@/gov/adapter'
 import { successorResolver } from '@/gov/renames'
 import { lookupRules } from '@/gov/install'
@@ -46,17 +45,11 @@ import { readSkew, type SkewReport } from '@/version/skew'
  * being one of these, because `src/tooling/` never calls `planSync`, so the
  * three lookups below have no entry to offer it. Standards and snippets left
  * the list with their install channels: nothing writes either corpus into a
- * target, so there is no installed copy to attribute.
- *
- * Design joins as a scanned domain rather than a stamp-only one because its
- * base file is attributed the same way a rule is, and its install marker is
- * what keeps it off a target that never asked for it: a project with no
- * `.claude/design/` is never scanned, so design values arrive on an install
- * rather than on the next sync.
+ * target, so there is no installed copy to attribute. Design left with its
+ * install verb for the same reason.
  */
 export const SCANNED_DOMAINS = [
   'governance',
-  'design',
 ] as const satisfies readonly StampDomain[]
 
 export type ScannedDomain = (typeof SCANNED_DOMAINS)[number]
@@ -68,17 +61,14 @@ export type ScannedDomain = (typeof SCANNED_DOMAINS)[number]
  */
 const SYNCED_SOURCES: Record<ScannedDomain, string> = {
   governance: 'governance/rules/',
-  design: 'src/design/',
 }
 
 const ADAPTERS: Record<ScannedDomain, (root: string) => SyncAdapter> = {
   governance: createGovAdapter,
-  design: createDesignAdapter,
 }
 
 const INSTALL_MARKERS: Record<ScannedDomain, readonly string[]> = {
   governance: ['.claude', 'rules', 'canon'],
-  design: DESIGN_INSTALL_DIR.split(sep),
 }
 
 export interface StateCounts {
@@ -215,33 +205,18 @@ export interface CheckReport {
   readonly skew: SkewReport
 }
 
-/**
- * Scanned domains a target takes deliberately rather than by being managed.
- *
- * An absent one is a choice, so it is never reported as unstamped. Governance
- * wants the opposite reading, since a managed target without it has yet to
- * install what every project is expected to carry, and naming it is the only
- * place that shows up.
- */
-export const OPT_IN_DOMAINS: readonly ScannedDomain[] = ['design']
-
 /**
  * Scanned domains this target should have stamped and has not, which is the
  * one line a domain nobody installed ever appears on.
  *
  * An unmigrated domain is excluded because the relocation is its remedy rather
- * than a sync, and an opt-in domain the target does not hold is excluded
- * because there is nothing there to stamp and the sync it would name refuses.
+ * than a sync.
  */
 export function uncoveredDomains(report: CheckReport): ScannedDomain[] {
   const unmigrated = new Set(report.unmigrated.map((entry) => entry.domain))
-  const installed = new Set(report.domains.map((entry) => entry.domain))
 
   return SCANNED_DOMAINS.filter(
-    (domain) =>
-      !report.covers.includes(domain) &&
-      !unmigrated.has(domain) &&
-      (!OPT_IN_DOMAINS.includes(domain) || installed.has(domain)),
+    (domain) => !report.covers.includes(domain) && !unmigrated.has(domain),
   )
 }
 

package/src/sync/stamp.ts

@@ -10,17 +10,17 @@ import { compareVersions, parseVersion } from '@/version/compare'
 import { readInstalled } from '@/version/installed'
 
 /**
- * Domains the stamp can record. Governance and design both attribute file by
- * file through the sync engine. Tooling runs its own inject and manifest
- * machinery, so it records the stack chain it resolved instead and carries no
- * file hashes.
+ * Domains the stamp can record. Governance attributes file by file through
+ * the sync engine. Tooling runs its own inject and manifest machinery, so it
+ * records the stack chain it resolved instead and carries no file hashes.
  *
  * A stamp written before the standards or snippets install channel closed
- * still carries a `standards` or `snippets` record. `isStamp` ignores the key
+ * still carries a `standards` or `snippets` record, and one written before the
+ * design install retired carries a `design` record. `isStamp` ignores the key
  * and `sortDomains` drops it on the next write, so the target loses a domain
  * nothing can refresh rather than losing the whole file.
  */
-export const STAMP_DOMAINS = ['governance', 'design', 'tooling'] as const
+export const STAMP_DOMAINS = ['governance', 'tooling'] as const
 
 export type StampDomain = (typeof STAMP_DOMAINS)[number]