@erclx/canon 4.49.0 → 4.50.0

package/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "canon",
   "description": "Automated governance, versioning, and discovery tools for Claude Code.",
-  "version": "4.49.0",
+  "version": "4.50.0",
   "author": {
     "name": "Eric Le",
     "url": "https://github.com/erclx"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@erclx/canon",
   "type": "module",
-  "version": "4.49.0",
+  "version": "4.50.0",
   "description": "Infrastructure and quality tooling for developer workflows",
   "license": "MIT",
   "bin": {

package/src/design/base.css

@@ -28,14 +28,22 @@
   --space-frame-top: 44px;
   --space-frame-inline: 52px;
   --space-frame-bottom: 38px;
+  --type-display-family: Noto Sans Mono, DejaVu Sans Mono, monospace;
   --type-display-size: 34px;
   --type-display-lh: 1.3;
+  --type-page-display-family: Noto Sans, DejaVu Sans, sans-serif;
+  --type-page-display-size: 52px;
+  --type-page-display-lh: 1.1;
+  --type-heading-family: Noto Sans Mono, DejaVu Sans Mono, monospace;
   --type-heading-size: 19px;
   --type-heading-lh: 1.3;
+  --type-body-family: Noto Sans Mono, DejaVu Sans Mono, monospace;
   --type-body-size: 16px;
   --type-body-lh: 1.65;
+  --type-label-family: Noto Sans Mono, DejaVu Sans Mono, monospace;
   --type-label-size: 12px;
   --type-label-lh: 1.45;
+  --type-code-family: Noto Sans Mono, DejaVu Sans Mono, monospace;
   --type-code-size: 14.5px;
   --type-code-lh: 1.3;
   --radius-frame: 12px;

package/src/design/css.ts

@@ -76,6 +76,7 @@ function tokenProperties(tokens: DesignTokens): string[] {
   }
 
   for (const role of tokens.typography) {
+    lines.push(`  --type-${slug(role.role)}-family: ${role.family};`)
     lines.push(`  --type-${slug(role.role)}-size: ${role.size};`)
     lines.push(`  --type-${slug(role.role)}-lh: ${role.lineHeight};`)
   }

package/src/design/tokens.ts

@@ -68,9 +68,21 @@ export interface DesignTokens {
   readonly preamble: string
 }
 
-/** The one monospace stack every surface that renders text declares. */
+/** The monospace stack every surface but the landing page hero declares. */
 const MONO = 'Noto Sans Mono, DejaVu Sans Mono, monospace'
 
+/**
+ * The proportional stack the landing page hero declares and nothing else does.
+ * Noto Sans is the proportional sibling of the mono above rather than a face
+ * picked for taste, so the pairing is one superfamily rather than two systems.
+ *
+ * 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
+ * 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.
+ */
+const SANS = 'Noto Sans, DejaVu Sans, sans-serif'
+
 const DARK_GROUNDS = ['background', 'surface'] as const
 const LIGHT_GROUNDS = ['light-background', 'light-surface'] as const
 
@@ -87,6 +99,8 @@ export const TOKENS: DesignTokens = {
 
   personality: [
     'Warm neutrals carry the frame under a single rust accent, rendered in the same monospace the terminal uses. The subject picks the register rather than taste: a toolkit whose primary surface is a shell has no proportional voice available, so the rendered surfaces match the terminal instead of the reverse. One accent carries every count, link, and primary action. Promoting a second and third into structural roles is what reads as a generated interface, so the palette stays at one.',
+    '',
+    'One surface is carved out of the sentence above, and it is the landing page hero. A rendered surface here shows a reader what the terminal did, so matching the terminal is what makes it legible. A public page addresses somebody who has never opened the terminal at all, and the shell has no voice available for that, which is the reverse of the case the rule was written for. The `page-display` role below is the whole of the carve-out. Every other role on that page stays monospace, including its body, its controls, and every frame it embeds, so the page reads as two families rather than as a second design system.',
   ].join('\n'),
 
   colorNote: [
@@ -193,7 +207,9 @@ export const TOKENS: DesignTokens = {
   ],
 
   typographyNote: [
-    'One family covers every role. The size scale runs from 11.5 to 34 pixels across ten values, and five of them map onto a role. The other five are adjustments inside a single component and get no role here, since a scale with five invented steps reads as a system the surfaces do not implement. They are 11.5, 12.5, 13, 14, and 15 pixels.',
+    'One family covers every role but `page-display`, which is the landing page hero and takes the proportional sibling of the same superfamily. The size scale runs from 11.5 to 52 pixels, and six values map onto a role. Five further values are adjustments inside a single component and get no role here, since a scale with five invented steps reads as a system the surfaces do not implement. They are 11.5, 12.5, 13, 14, and 15 pixels.',
+    '',
+    'The 52 pixel step sits above the 34 the rest of the scale tops out at, and it is the one size no other surface reaches. A hero headline set at the display cap reads as a section heading rather than an opening, which four rendered arms measured on 2026-09-04 before the step was added.',
     '',
     'A tagged cell is one no rendering surface exercises yet, which is a declaration the system has not tested rather than one it has.',
     '',
@@ -208,6 +224,14 @@ export const TOKENS: DesignTokens = {
       size: '34px',
       lineHeight: '1.3',
     },
+    {
+      role: 'page-display',
+      family: SANS,
+      weight: '700',
+      size: '52px',
+      lineHeight: '1.1',
+      verify: ['family', 'size', 'lineHeight'],
+    },
     {
       role: 'heading',
       family: MONO,

package/src/tasks/archive.ts

@@ -400,7 +400,8 @@ export async function planCitations(
 
   const stems = await listTaskStems(dir)
   if (!stems.includes(stem)) {
-    return refuse('no-match', `No task named ${stem} on the board.`, stems)
+    const unmatched = describeUnmatchedStem(stems, stem)
+    return refuse(unmatched.reason, unmatched.message, unmatched.detail)
   }
 
   const target = readPlanTarget(await readFile(join(dir, `${stem}.md`), 'utf8'))
@@ -488,6 +489,45 @@ function refuse(
   return { ok: false, reason, message, detail }
 }
 
+export interface UnmatchedStem {
+  readonly reason: 'no-match' | 'ambiguous'
+  readonly message: string
+  readonly detail: readonly string[]
+}
+
+/**
+ * The three-way refusal a bare stem earns once it fails an exact match:
+ * exactly one task starts with it, several do, or none does. `archive.ts`'s
+ * own `resolveStem`, `planCitations`, and `record.ts`'s `resolveStem` all
+ * refuse a stem this way, so the wording lives once rather than three times.
+ */
+export function describeUnmatchedStem(
+  stems: readonly string[],
+  name: string,
+): UnmatchedStem {
+  const prefixed = stems.filter((stem) => stem.startsWith(name))
+  if (prefixed.length === 1) {
+    const [match] = prefixed
+    return {
+      reason: 'no-match',
+      message: `${name} does not name a task by itself. One task starts with it: ${match}. Pass the full name instead.`,
+      detail: [match],
+    }
+  }
+  if (prefixed.length > 1) {
+    return {
+      reason: 'ambiguous',
+      message: `${name} does not name a task by itself. ${prefixed.length} tasks start with it. Pass the full name instead.`,
+      detail: prefixed,
+    }
+  }
+  return {
+    reason: 'no-match',
+    message: `No task named ${name} on the board.`,
+    detail: stems,
+  }
+}
+
 async function resolveStem(
   dir: string,
   selector: TaskSelector,
@@ -496,27 +536,11 @@ async function resolveStem(
 
   if (selector.kind === 'stem') {
     if (!stems.includes(selector.stem)) {
-      const prefixed = stems.filter((stem) => stem.startsWith(selector.stem))
-      if (prefixed.length === 1) {
-        const [match] = prefixed
-        return refuse(
-          'no-match',
-          `${selector.stem} does not name a task by itself. One task starts with it: ${match}. Pass the full name to archive it.`,
-          [match],
-        )
-      }
-      if (prefixed.length > 1) {
-        return refuse(
-          'ambiguous',
-          `${selector.stem} does not name a task by itself. ${prefixed.length} tasks start with it. Pass the full name to archive one.`,
-          prefixed,
-        )
-      }
-      return refuse(
-        'no-match',
-        `No task named ${selector.stem} on the board.`,
+      const { reason, message, detail } = describeUnmatchedStem(
         stems,
+        selector.stem,
       )
+      return refuse(reason, message, detail)
     }
     return selector.stem
   }

package/src/tasks/record.ts

@@ -3,6 +3,7 @@ import { readFile, writeFile } from 'node:fs/promises'
 import { basename, join, relative } from 'node:path'
 import { planCandidates } from '@/tasks/answers'
 import {
+  describeUnmatchedStem,
   fenceMask,
   linkTo,
   listTaskStems,
@@ -241,11 +242,11 @@ async function resolveStem(
 
   if (selector.kind === 'stem') {
     if (!stems.includes(selector.stem)) {
-      return refuse(
-        'no-match',
-        `No task named ${selector.stem} on the board.`,
+      const { reason, message, detail } = describeUnmatchedStem(
         stems,
+        selector.stem,
       )
+      return refuse(reason, message, detail)
     }
     return selector.stem
   }

package/tooling/astro/configs/playwright.config.ts

@@ -22,5 +22,6 @@ export default defineConfig({
     command: 'bun run build && bun run preview',
     url: baseURL,
     reuseExistingServer: false,
+    env: { ASTRO_PREVIEW_BACKGROUND: '0' },
   },
 })