@erclx/canon 4.88.1 → 4.89.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.88.1",
+  "version": "4.89.0",
   "author": {
     "name": "Eric Le",
     "url": "https://github.com/erclx"

package/package.json

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

package/src/design/base.css

@@ -4,26 +4,26 @@
    file changes freely and nothing a project wrote lives in it. */
 
 :root {
-  --color-background: #191512;
-  --color-surface: #211c19;
-  --color-chrome: #241e1a;
-  --color-border: #2f2823;
-  --color-text: #f4efe9;
-  --color-text-body: #c9c0b7;
-  --color-text-secondary: #a79d94;
-  --color-muted: #948a81;
-  --color-accent: #e0724b;
+  --color-background: #0f0e0c;
+  --color-surface: #151412;
+  --color-chrome: #1b1a18;
+  --color-border: #2a2926;
+  --color-text: #d9d7d4;
+  --color-text-body: #aeada9;
+  --color-text-secondary: #8c8b86;
+  --color-muted: #7f7f7c;
+  --color-accent: #c76b5f;
   --color-success: #61c454;
-  --color-light-background: #faf7f2;
-  --color-light-surface: #f4efe6;
-  --color-light-chrome: #ede4d6;
-  --color-light-text: #1a1815;
-  --color-light-text-body: #3d3630;
-  --color-light-text-secondary: #5c544b;
-  --color-light-muted: #726b62;
-  --color-light-accent: #a4471c;
+  --color-light-background: #fbfaf8;
+  --color-light-surface: #f1f1ee;
+  --color-light-chrome: #e9e8e5;
+  --color-light-text: #2c2c29;
+  --color-light-text-body: #4b4947;
+  --color-light-text-secondary: #666561;
+  --color-light-muted: #6e6d6c;
+  --color-light-accent: #ad4a4b;
   --color-light-success: #2d6b22;
-  --color-light-border: #e4dcd0;
+  --color-light-border: #d5d4d1;
   --space-xs: 6px;
   --space-sm: 12px;
   --space-md: 18px;

package/src/design/tokens.ts

@@ -108,58 +108,64 @@ export const TOKENS: DesignTokens = {
     '',
     'Warning and error hold ANSI codes because that is what `scripts/lib/ui.sh` writes and no rendered surface implements an equivalent. Giving either a hex value would invent a mapping no file has, so they carry no contrast reading either.',
     '',
-    'Success is the one of the three that does have a rendered equivalent, which is why it carries a hex. `assets/captures/install.html` marks every confirmed step with it, and the shell writes `ANSI 32` for the same role, so the two are one role in two registers rather than one value in two spellings. The hex is what the rendered surface picked and no reading claims the terminal renders that value. It declares `background` alone as its ground, since that is the only role it is drawn on, where every other dark text role is drawn on both.',
+    'Success is the one of the three that does have a rendered equivalent, which is why it carries a hex. `assets/captures/install.html` marks every confirmed step with it, and the shell writes `ANSI 32` for the same role, so the two are one role in two registers rather than one value in two spellings. The hex is what the rendered surface picked and no reading claims the terminal renders that value. It declares `background` alone as its ground, since that is the only role it is drawn on, where every other dark text role is drawn on both. It is the one role below that is not derived.',
+    '',
+    "Every other role is derived rather than picked, solved in OKLCH by binary search for the lightness that hits a target contrast against its ground, using this module's own anchors. Six anchors are the whole system: ground lightness 0.985 light and 0.165 dark, neutral chroma 0.003 light and 0.004 dark, neutral hue 90 both, accent hue 22 light and 28 dark, accent chroma 0.13 light and 0.12 dark for a mark and 0.095 light and 0.09 dark for a fill. Only the mark step is rendered below, in `accent`. That token already stands in for a fill in practice: `assets/captures/hero.html`'s `.cmd` rule paints its whole background with `var(--color-accent)` and sets text on top, which is a fill use rather than a mark one. The fill chroma step has no token of its own yet, so a lower-saturation `accent-fill` would recolor that button rather than introduce a new consumer. Targets, which are inputs rather than results: text 13.5, body 8.6, secondary 5.6, muted 4.6, accent 5.2. Dark is its own anchor set rather than an inversion of light, and every arm measured in the groundwork behind this landed on identical neutral ratios, which is what made the accent choice a question about hue alone.",
+    '',
+    '`muted` and `light-muted` solve against `surface` rather than `background`. Both declare two grounds and the groundwork solved its target against one, so the recorded hex cleared 4.6 against `background` and read 4.40 dark, 4.24 light against `surface`, the tighter of the two since surface sits a step closer to its text color. The values here are re-solved for the same 4.6 target read against `surface` instead, which clears both: 4.58 dark, 4.56 light against `surface`, and 4.80 dark, 4.95 light against `background`.',
+    '',
+    'The accent is a quiet red at hue 22 light, 28 dark, chosen over a vivid red that read as an error state against a page reporting success, over indigo which carries less distinctiveness at hue 280 in tooling already dominated by that hue, and over rust at hue 42, a larger temperature shift than the problem required. The debt this accepts: `error` and `warning` now share a register with the most repeated element on every rendered surface, so both need differentiating by lightness or by an icon rather than by hue, and that work is unscheduled.',
   ].join('\n'),
 
   color: [
     {
       role: 'background',
       intent: 'page canvas',
-      value: '#191512',
+      value: '#0f0e0c',
     },
     {
       role: 'surface',
       intent: 'cards, panels, raised blocks',
-      value: '#211c19',
+      value: '#151412',
     },
     {
       role: 'chrome',
       intent: 'the window titlebar, one step above the canvas',
-      value: '#241e1a',
+      value: '#1b1a18',
     },
     {
       role: 'border',
       intent: 'every rule and panel edge',
-      value: '#2f2823',
+      value: '#2a2926',
     },
     {
       role: 'text',
       intent: 'headings, counts, emphasized runs',
-      value: '#f4efe9',
+      value: '#d9d7d4',
       grounds: DARK_GROUNDS,
     },
     {
       role: 'text-body',
       intent: 'default body copy',
-      value: '#c9c0b7',
+      value: '#aeada9',
       grounds: DARK_GROUNDS,
     },
     {
       role: 'text-secondary',
       intent: 'labels, captions, supporting copy',
-      value: '#a79d94',
+      value: '#8c8b86',
       grounds: DARK_GROUNDS,
     },
     {
       role: 'muted',
       intent: 'the faintest step, trailing notes',
-      value: '#948a81',
+      value: '#7f7f7c',
       grounds: DARK_GROUNDS,
     },
     {
       role: 'accent',
       intent: 'install command, mark, primary action',
-      value: '#e0724b',
+      value: '#c76b5f',
       grounds: DARK_GROUNDS,
     },
     {
@@ -173,46 +179,46 @@ export const TOKENS: DesignTokens = {
     {
       role: 'light-background',
       intent: 'page canvas on a light ground',
-      value: '#faf7f2',
+      value: '#fbfaf8',
     },
     {
       role: 'light-surface',
       intent: 'cards and panels on a light ground',
-      value: '#f4efe6',
+      value: '#f1f1ee',
     },
     {
       role: 'light-chrome',
       intent: 'the window titlebar, one step above the canvas',
-      value: '#ede4d6',
+      value: '#e9e8e5',
     },
     {
       role: 'light-text',
       intent: 'primary text on a light ground',
-      value: '#1a1815',
+      value: '#2c2c29',
       grounds: LIGHT_GROUNDS,
     },
     {
       role: 'light-text-body',
       intent: 'default body copy on a light ground',
-      value: '#3d3630',
+      value: '#4b4947',
       grounds: LIGHT_GROUNDS,
     },
     {
       role: 'light-text-secondary',
       intent: 'labels, captions, supporting copy on a light ground',
-      value: '#5c544b',
+      value: '#666561',
       grounds: LIGHT_GROUNDS,
     },
     {
       role: 'light-muted',
       intent: 'secondary text on a light ground',
-      value: '#726b62',
+      value: '#6e6d6c',
       grounds: LIGHT_GROUNDS,
     },
     {
       role: 'light-accent',
       intent: 'links and primary action on light',
-      value: '#a4471c',
+      value: '#ad4a4b',
       grounds: LIGHT_GROUNDS,
     },
     {
@@ -224,7 +230,7 @@ export const TOKENS: DesignTokens = {
     {
       role: 'light-border',
       intent: 'rules and panel edges on light',
-      value: '#e4dcd0',
+      value: '#d5d4d1',
       verify: true,
     },
   ],