pigment-mcp 0.9.0 → 0.14.0

package/cli.js

@@ -34493,7 +34493,7 @@ function resolveTokens(primitives, semantic) {
   for (const [path, token] of all) resolved.set(path, { value: resolveValue(token.value, /* @__PURE__ */ new Set([path])), type: token.type });
   return resolved;
 }
-var TemplateId, SemVer, Hex, AppId, Scenario, TemplateStatus, Manifest, DtcgType, DtcgToken, ComponentCategory, ComponentEntry, ComponentIndex, AUDIT_AREAS, AuditArea, Evidence, Signature, Analysis, RunRecord, GateResult, CriticScores, EvalReport, Registry;
+var TemplateId, SemVer, Hex, AppId, HoldoutAppId, RunAppId, Scenario, TemplateStatus, Manifest, DtcgType, DtcgToken, ComponentCategory, ComponentEntry, ComponentIndex, AUDIT_AREAS, AuditArea, Evidence, Signature, Analysis, RunRecord, GateResult, CriticFinding, score, CriticScores, EvalReport, Registry;
 var init_src = __esm({
   "../schema/src/index.ts"() {
     "use strict";
@@ -34502,6 +34502,8 @@ var init_src = __esm({
     SemVer = external_exports.string().regex(/^\d+\.\d+\.\d+(-[0-9a-z.-]+)?$/, "semantic version, e.g. 1.0.0 or 0.1.0-rc.1");
     Hex = external_exports.string().regex(/^#([0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/, "6 or 8 digit hex");
     AppId = external_exports.enum(["dashboard", "commerce", "blog", "settings"]);
+    HoldoutAppId = external_exports.enum(["landing", "docs"]);
+    RunAppId = external_exports.union([AppId, HoldoutAppId]);
     Scenario = external_exports.enum(["new", "existing", "ongoing"]);
     TemplateStatus = external_exports.enum(["draft", "candidate", "published", "deprecated"]);
     Manifest = external_exports.object({
@@ -34682,7 +34684,7 @@ var init_src = __esm({
       runId: external_exports.string(),
       template: TemplateId,
       version: SemVer,
-      app: AppId,
+      app: RunAppId,
       scenario: Scenario,
       agent: external_exports.enum(["claude", "codex"]),
       model: external_exports.string().optional(),
@@ -34700,17 +34702,33 @@ var init_src = __esm({
       threshold: external_exports.union([external_exports.number(), external_exports.string()]).optional(),
       detail: external_exports.string().optional()
     });
+    CriticFinding = external_exports.object({
+      severity: external_exports.enum(["blocker", "major", "minor"]),
+      /** Rubric area: referenceFidelity, crossAppConsistency, hierarchy, spacingRhythm, componentStates, polish, signature. */
+      area: external_exports.string(),
+      summary: external_exports.string(),
+      /** In how many of the evaluated samples it appears, and how many there were. */
+      samples: external_exports.number().int().min(0),
+      of: external_exports.number().int().min(1),
+      /** The spec's own wording or recipe causes it (a missing, ambiguous or contradictory rule). */
+      specCaused: external_exports.boolean().default(false),
+      evidence: external_exports.array(external_exports.string()).default([]),
+      /** A general rule that would prevent it in any product — never a fix tied to one demo app's screen or data. */
+      promptFix: external_exports.string().optional()
+    });
+    score = external_exports.number().min(0).max(5);
     CriticScores = external_exports.object({
-      referenceFidelity: external_exports.number().min(0).max(5).nullable(),
-      crossAppConsistency: external_exports.number().min(0).max(5),
-      hierarchy: external_exports.number().min(0).max(5),
-      spacingRhythm: external_exports.number().min(0).max(5),
-      componentStates: external_exports.number().min(0).max(5),
-      polish: external_exports.number().min(0).max(5),
-      /** Are the signature elements present across all four apps, placed per the application map, moving as specified? Null for packages without signatures. */
-      signature: external_exports.number().min(0).max(5).nullable().optional(),
-      notes: external_exports.array(external_exports.string()),
-      promptFixes: external_exports.array(external_exports.string()).describe("Concrete spec changes that would fix the observed problems")
+      /** Descriptive only (the verdict comes from findings). Older critic files gate on them. */
+      referenceFidelity: score.nullable().optional(),
+      crossAppConsistency: score.optional(),
+      hierarchy: score.optional(),
+      spacingRhythm: score.optional(),
+      componentStates: score.optional(),
+      polish: score.optional(),
+      signature: score.nullable().optional(),
+      findings: external_exports.array(CriticFinding).optional(),
+      notes: external_exports.array(external_exports.string()).default([]),
+      promptFixes: external_exports.array(external_exports.string()).default([]).describe("Concrete spec changes that would fix the observed problems")
     });
     EvalReport = external_exports.object({
       template: TemplateId,
@@ -34720,13 +34738,17 @@ var init_src = __esm({
       runs: external_exports.array(
         external_exports.object({
           runId: external_exports.string(),
-          app: AppId,
+          app: RunAppId,
           gates: external_exports.array(GateResult),
           metrics: external_exports.record(external_exports.string(), external_exports.number())
         })
       ),
       crossApp: external_exports.array(GateResult).default([]),
+      /** Measured layout defects (clipped or overlapping text, near-miss alignment, doubled rules, repeated drawings). */
+      layout: external_exports.array(external_exports.object({ app: RunAppId, runId: external_exports.string(), route: external_exports.string(), viewport: external_exports.string(), kind: external_exports.string(), where: external_exports.string(), detail: external_exports.string() })).optional(),
       critic: CriticScores.optional(),
+      /** Agent spend of this version and of its whole family (all candidates), for the record. */
+      cost: external_exports.object({ versionUsd: external_exports.number(), familyUsd: external_exports.number(), familyRuns: external_exports.number() }).optional(),
       verdict: external_exports.enum(["pass", "fail", "pending-review"]),
       reasons: external_exports.array(external_exports.string())
     });
@@ -34971,7 +34993,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@pigment/mcp",
-      version: "0.9.0",
+      version: "0.14.0",
       private: true,
       type: "module",
       description: "MCP server for Pigment design systems: tokens, rules, component specs and installation guides for your coding agent.",

package/content/registry.json

@@ -2,7 +2,7 @@
   "templates": [
     {
       "id": "margin-notes",
-      "latest": "1.1.0",
+      "latest": "1.2.0",
       "versions": [
         {
           "version": "1.0.0",
@@ -15,24 +15,36 @@
           "status": "published",
           "publishedAt": "2026-10-14T08:33:30.334Z",
           "sha256": "f6a26186965b8425d7b1ea620c737f58e8e907746b1550fb32a7b4bf98b6fa04"
+        },
+        {
+          "version": "1.2.0",
+          "status": "published",
+          "publishedAt": "2026-10-19T01:41:09.029Z",
+          "sha256": "99fb52e92bdc3b35b474a873f4bb4657e81d4e326cd26f8de56c1dc0b4a225f2"
         }
       ]
     },
     {
       "id": "inkleaf",
-      "latest": "1.0.0",
+      "latest": "1.1.0",
       "versions": [
         {
           "version": "1.0.0",
           "status": "published",
           "publishedAt": "2026-10-14T00:22:11.356Z",
           "sha256": "950225ff2a2540952b0acbdd499d07d8f78576262299a979d5d831145f51174b"
+        },
+        {
+          "version": "1.1.0",
+          "status": "published",
+          "publishedAt": "2026-10-19T05:40:05.888Z",
+          "sha256": "e2a38ffc279853fcb8b6de07028f16127319053e8b779f02a981ec396f26f85c"
         }
       ]
     },
     {
       "id": "night-cartridge",
-      "latest": "1.1.0",
+      "latest": "1.3.0",
       "versions": [
         {
           "version": "1.0.0",
@@ -45,18 +57,36 @@
           "status": "published",
           "publishedAt": "2026-10-15T04:49:09.540Z",
           "sha256": "a4e943cb722c1506dac7af6ab80341f3c28bbe1aef3184038d4a9cb863a06e30"
+        },
+        {
+          "version": "1.2.0",
+          "status": "published",
+          "publishedAt": "2026-10-18T13:46:07.189Z",
+          "sha256": "82dcfe93ef26940ddbb6a3d6bf15c4ab4539638de605ee9b206512e42a98ad63"
+        },
+        {
+          "version": "1.3.0",
+          "status": "published",
+          "publishedAt": "2026-10-19T07:10:06.232Z",
+          "sha256": "8dfc70ec02127dbf36f6c439290c2fc4a64fe4efef971ac76ec48522411f2717"
         }
       ]
     },
     {
       "id": "graphite-blueprint",
-      "latest": "1.0.0",
+      "latest": "1.1.0",
       "versions": [
         {
           "version": "1.0.0",
           "status": "published",
           "publishedAt": "2026-10-17T10:38:28.909Z",
           "sha256": "0a34e9d7f81627182cd5fba1eb0c1aa758350479c5bed36adf2e5962386e49df"
+        },
+        {
+          "version": "1.1.0",
+          "status": "published",
+          "publishedAt": "2026-10-18T11:26:12.349Z",
+          "sha256": "f15b112756c795d50a806d53754f2946f3436bbb81a841154c6220da93139063"
         }
       ]
     }

package/content/shots.json

@@ -35,6 +35,24 @@
     "settings.mobileLight": "/showcase/margin-notes/1.1.0/settings/settings-profile-mobile-light.png",
     "settings.mobileDark": "/showcase/margin-notes/1.1.0/settings/settings-profile-mobile-dark.png"
   },
+  "margin-notes@1.2.0": {
+    "blog.desktopLight": "/showcase/margin-notes/1.2.0/blog/home-desktop-light.png",
+    "blog.desktopDark": "/showcase/margin-notes/1.2.0/blog/home-desktop-dark.png",
+    "blog.mobileLight": "/showcase/margin-notes/1.2.0/blog/home-mobile-light.png",
+    "blog.mobileDark": "/showcase/margin-notes/1.2.0/blog/home-mobile-dark.png",
+    "commerce.desktopLight": "/showcase/margin-notes/1.2.0/commerce/home-desktop-light.png",
+    "commerce.desktopDark": "/showcase/margin-notes/1.2.0/commerce/home-desktop-dark.png",
+    "commerce.mobileLight": "/showcase/margin-notes/1.2.0/commerce/home-mobile-light.png",
+    "commerce.mobileDark": "/showcase/margin-notes/1.2.0/commerce/home-mobile-dark.png",
+    "dashboard.desktopLight": "/showcase/margin-notes/1.2.0/dashboard/home-desktop-light.png",
+    "dashboard.desktopDark": "/showcase/margin-notes/1.2.0/dashboard/home-desktop-dark.png",
+    "dashboard.mobileLight": "/showcase/margin-notes/1.2.0/dashboard/home-mobile-light.png",
+    "dashboard.mobileDark": "/showcase/margin-notes/1.2.0/dashboard/home-mobile-dark.png",
+    "settings.desktopLight": "/showcase/margin-notes/1.2.0/settings/settings-profile-desktop-light.png",
+    "settings.desktopDark": "/showcase/margin-notes/1.2.0/settings/settings-profile-desktop-dark.png",
+    "settings.mobileLight": "/showcase/margin-notes/1.2.0/settings/settings-profile-mobile-light.png",
+    "settings.mobileDark": "/showcase/margin-notes/1.2.0/settings/settings-profile-mobile-dark.png"
+  },
   "inkleaf@1.0.0": {
     "blog.desktopLight": "/showcase/inkleaf/1.0.0/blog/home-desktop-light.png",
     "blog.desktopDark": "/showcase/inkleaf/1.0.0/blog/home-desktop-dark.png",
@@ -53,6 +71,24 @@
     "settings.mobileLight": "/showcase/inkleaf/1.0.0/settings/settings-profile-mobile-light.png",
     "settings.mobileDark": "/showcase/inkleaf/1.0.0/settings/settings-profile-mobile-dark.png"
   },
+  "inkleaf@1.1.0": {
+    "blog.desktopLight": "/showcase/inkleaf/1.1.0/blog/home-desktop-light.png",
+    "blog.desktopDark": "/showcase/inkleaf/1.1.0/blog/home-desktop-dark.png",
+    "blog.mobileLight": "/showcase/inkleaf/1.1.0/blog/home-mobile-light.png",
+    "blog.mobileDark": "/showcase/inkleaf/1.1.0/blog/home-mobile-dark.png",
+    "commerce.desktopLight": "/showcase/inkleaf/1.1.0/commerce/home-desktop-light.png",
+    "commerce.desktopDark": "/showcase/inkleaf/1.1.0/commerce/home-desktop-dark.png",
+    "commerce.mobileLight": "/showcase/inkleaf/1.1.0/commerce/home-mobile-light.png",
+    "commerce.mobileDark": "/showcase/inkleaf/1.1.0/commerce/home-mobile-dark.png",
+    "dashboard.desktopLight": "/showcase/inkleaf/1.1.0/dashboard/home-desktop-light.png",
+    "dashboard.desktopDark": "/showcase/inkleaf/1.1.0/dashboard/home-desktop-dark.png",
+    "dashboard.mobileLight": "/showcase/inkleaf/1.1.0/dashboard/home-mobile-light.png",
+    "dashboard.mobileDark": "/showcase/inkleaf/1.1.0/dashboard/home-mobile-dark.png",
+    "settings.desktopLight": "/showcase/inkleaf/1.1.0/settings/settings-profile-desktop-light.png",
+    "settings.desktopDark": "/showcase/inkleaf/1.1.0/settings/settings-profile-desktop-dark.png",
+    "settings.mobileLight": "/showcase/inkleaf/1.1.0/settings/settings-profile-mobile-light.png",
+    "settings.mobileDark": "/showcase/inkleaf/1.1.0/settings/settings-profile-mobile-dark.png"
+  },
   "night-cartridge@1.0.0": {
     "blog.desktopLight": "/showcase/night-cartridge/1.0.0/blog/home-desktop-light.png",
     "blog.desktopDark": "/showcase/night-cartridge/1.0.0/blog/home-desktop-dark.png",
@@ -81,6 +117,26 @@
     "settings.desktopDark": "/showcase/night-cartridge/1.1.0/settings/settings-profile-desktop-dark.png",
     "settings.mobileDark": "/showcase/night-cartridge/1.1.0/settings/settings-profile-mobile-dark.png"
   },
+  "night-cartridge@1.2.0": {
+    "blog.desktopDark": "/showcase/night-cartridge/1.2.0/blog/home-desktop-dark.png",
+    "blog.mobileDark": "/showcase/night-cartridge/1.2.0/blog/home-mobile-dark.png",
+    "commerce.desktopDark": "/showcase/night-cartridge/1.2.0/commerce/home-desktop-dark.png",
+    "commerce.mobileDark": "/showcase/night-cartridge/1.2.0/commerce/home-mobile-dark.png",
+    "dashboard.desktopDark": "/showcase/night-cartridge/1.2.0/dashboard/home-desktop-dark.png",
+    "dashboard.mobileDark": "/showcase/night-cartridge/1.2.0/dashboard/home-mobile-dark.png",
+    "settings.desktopDark": "/showcase/night-cartridge/1.2.0/settings/settings-profile-desktop-dark.png",
+    "settings.mobileDark": "/showcase/night-cartridge/1.2.0/settings/settings-profile-mobile-dark.png"
+  },
+  "night-cartridge@1.3.0": {
+    "blog.desktopDark": "/showcase/night-cartridge/1.3.0/blog/home-desktop-dark.png",
+    "blog.mobileDark": "/showcase/night-cartridge/1.3.0/blog/home-mobile-dark.png",
+    "commerce.desktopDark": "/showcase/night-cartridge/1.3.0/commerce/home-desktop-dark.png",
+    "commerce.mobileDark": "/showcase/night-cartridge/1.3.0/commerce/home-mobile-dark.png",
+    "dashboard.desktopDark": "/showcase/night-cartridge/1.3.0/dashboard/home-desktop-dark.png",
+    "dashboard.mobileDark": "/showcase/night-cartridge/1.3.0/dashboard/home-mobile-dark.png",
+    "settings.desktopDark": "/showcase/night-cartridge/1.3.0/settings/settings-profile-desktop-dark.png",
+    "settings.mobileDark": "/showcase/night-cartridge/1.3.0/settings/settings-profile-mobile-dark.png"
+  },
   "graphite-blueprint@1.0.0": {
     "blog.desktopLight": "/showcase/graphite-blueprint/1.0.0/blog/home-desktop-light.png",
     "blog.desktopDark": "/showcase/graphite-blueprint/1.0.0/blog/home-desktop-dark.png",
@@ -98,5 +154,23 @@
     "settings.desktopDark": "/showcase/graphite-blueprint/1.0.0/settings/settings-profile-desktop-dark.png",
     "settings.mobileLight": "/showcase/graphite-blueprint/1.0.0/settings/settings-profile-mobile-light.png",
     "settings.mobileDark": "/showcase/graphite-blueprint/1.0.0/settings/settings-profile-mobile-dark.png"
+  },
+  "graphite-blueprint@1.1.0": {
+    "blog.desktopLight": "/showcase/graphite-blueprint/1.1.0/blog/home-desktop-light.png",
+    "blog.desktopDark": "/showcase/graphite-blueprint/1.1.0/blog/home-desktop-dark.png",
+    "blog.mobileLight": "/showcase/graphite-blueprint/1.1.0/blog/home-mobile-light.png",
+    "blog.mobileDark": "/showcase/graphite-blueprint/1.1.0/blog/home-mobile-dark.png",
+    "commerce.desktopLight": "/showcase/graphite-blueprint/1.1.0/commerce/home-desktop-light.png",
+    "commerce.desktopDark": "/showcase/graphite-blueprint/1.1.0/commerce/home-desktop-dark.png",
+    "commerce.mobileLight": "/showcase/graphite-blueprint/1.1.0/commerce/home-mobile-light.png",
+    "commerce.mobileDark": "/showcase/graphite-blueprint/1.1.0/commerce/home-mobile-dark.png",
+    "dashboard.desktopLight": "/showcase/graphite-blueprint/1.1.0/dashboard/home-desktop-light.png",
+    "dashboard.desktopDark": "/showcase/graphite-blueprint/1.1.0/dashboard/home-desktop-dark.png",
+    "dashboard.mobileLight": "/showcase/graphite-blueprint/1.1.0/dashboard/home-mobile-light.png",
+    "dashboard.mobileDark": "/showcase/graphite-blueprint/1.1.0/dashboard/home-mobile-dark.png",
+    "settings.desktopLight": "/showcase/graphite-blueprint/1.1.0/settings/settings-profile-desktop-light.png",
+    "settings.desktopDark": "/showcase/graphite-blueprint/1.1.0/settings/settings-profile-desktop-dark.png",
+    "settings.mobileLight": "/showcase/graphite-blueprint/1.1.0/settings/settings-profile-mobile-light.png",
+    "settings.mobileDark": "/showcase/graphite-blueprint/1.1.0/settings/settings-profile-mobile-dark.png"
   }
 }

package/content/templates/graphite-blueprint/1.1.0/CHANGELOG.md

@@ -0,0 +1,280 @@
+# Changelog
+
+## 1.1.0
+
+Phone tables, blueprints and section openers are steadier. On phones a table keeps only its first and pinned
+columns, so nothing runs under the pin; blueprints keep their size in rows and pairs; every content section opens
+the same way, and settings groups, hairlines and closings are built into the recipes instead of described.
+
+- Table, small screens: under `breakpoint.sm` only the first and the pinned column show; the first cell holds at most
+  two single-line lines ending in an ellipsis and every row has the same number of lines (was: secondary columns
+  hidden by name, so others could show under the pin). The pin's head is a short visible mono word; a badge naming
+  the row shows its dot only, its label kept for screen readers; first and last cells sit on the section's edges.
+- Table, sort: the chevron shows only on the sorted column, before the label in right-aligned heads, so the label
+  ends on the cells' edge.
+- Isometric blueprint: new `pair()` and `blueprint()` helpers; sizes are rendered CSS pixels; a row of three draws
+  each at `size.blueprintLg` (now 300px, was 280px) or its full column, never under `size.blueprintMd`; captions and
+  titles sit level across a row.
+- Split opener: every content section opens with the full opener (h2 and description), never a filter or count in
+  its place; prose sits `space.32` under its opener (was `space.96`); a content home's featured block is a mono
+  "FEATURED" label over its plate; the opener link ends in "→" ("↓" for an in-page anchor).
+- Hairlines: never two hairlines with nothing between them, at any distance (was: under 32px apart).
+- Typography: the closing statement is `clamp(h2, 6vw, display)`, two short sentences that break only between them;
+  counts and result lines are uppercase mono labels in every app; headings balance and paragraphs wrap pretty;
+  fonts are self-hosted, never from a font CDN.
+- Spacing and layout: settings groups are `space.48` apart, built into the recipe CSS; one left edge per page
+  (articles narrow from the right instead of centering); a form keeps its error summary directly above its actions
+  and moves focus to the first invalid field.
+- Spec plate: the first eight items use all eight kinds, and no kind repeats in a grid row, a grid column or
+  between neighbours; a caption fact is at most 18 characters and wraps rather than truncates.
+- Navigation: a detail page keeps its section marked; phone navigation wraps instead of clipping or scrolling.
+
+## 1.1.0-rc.7
+
+Four recurring findings fixed in the recipes: settings gaps stay 48px with an empty status line, plate grids never
+stack a kind in one column, a detail page keeps its section marked, and tables sit on their section's edges.
+
+- Spacing: `:is(.settings-group,.stack) [role=status]:empty` is visually hidden (`position:absolute`, 1px,
+  `clip-path:inset(50%)`) and stays in the accessibility tree; the 48px check runs with status regions empty (was: an
+  empty status paragraph as last child kept the grid gap, 56 to 64px).
+- Spec plate, `specKinds`: the first 8 items take all 8 kinds, each later pass of 8 is shifted by 3
+  (`order[(i+floor(i/8)*3)%8]`); Limits: no shared kind in a grid row, a grid column or between adjacent posts (was: the second pass repeated the first in the same order, so row 3 copied row 1 at 4 columns).
+- Navigation: on a detail route the section's pill or row shows the current look via an `is-section` class; `end`
+  and `aria-current` unchanged (was: no item marked on product detail).
+- Table: first cell `padding-left:0`, last cell `padding-right:0`, so text aligns with the section head and its count
+  (was: `space.12` inset on both ends).
+
+## 1.1.0-rc.6
+
+Rules that kept coming back now live in the recipe CSS: sort heads, the gap between settings groups and the rule
+under a masthead are built in, and pages keep one left edge.
+
+- Table, sort: `.tbl :is(.num,.pin) .sort-button{flex-direction:row-reverse}` in the recipe, and the chevron is
+  rendered only on the sorted column (was: prose naming `.sort-button` alone, plus an always-rendered empty chevron
+  that pushed the pin head 16px off its cells).
+- Never: two hairlines with nothing between them, at any distance (was: under 32px apart). Split opener: `.masthead`
+  gets the head's rule and the block after it draws none (`:is(.screen-head,.masthead)+*`), the first opener under a
+  masthead starts `space.96` below it; a rule always has content directly on both sides.
+- Split opener: `.opener{margin-bottom:space.96}` (`space.48` under 768px) and `.opener:has(+.prose){margin-bottom:space.32}`,
+  so prose sits 32px under its opener (was: 96px whatever followed). The opener link ends in "→" ("↓" for an in-page
+  anchor), never "+" (was: "→" or "+").
+- Spacing: settings groups are `.settings-group` siblings with the 48px gap in CSS (padding-bottom `space.48`, the next
+  group's hairline and `space.48` above its content, no margin under the last child) (was: a prose rule, measured at
+  51 to 64px).
+- Spec plate: a caption fact is at most 18 characters and never ellipsised; the caption spans the plate (`right:space.12`)
+  and wraps rather than truncates (was: no length limit).
+- Layout: one left edge per page; every page uses `size.container`, articles and docs narrow from the right (body at
+  `size.measure`, rail right), never centered in `size.containerProse` (was: `size.containerProse` for articles, which
+  gave articles a second left edge).
+- Verification: one measured line at 1440px and 390px with numbers and method: blueprint widths, right-aligned head x
+  against cells, every settings gap, the article's shared left x; the check line adds no double hairline, no
+  ellipsised caption, no "+" link.
+- Budget: true duplicates cut (Sig 3's "captions level" now in the subgrid CSS, Table's "only first and pin show" and
+  badge-dot sentences now in the CSS, Color use's banner pointer, Sig 6's restated h2 size, h1 note and mono-figures
+  line, the review loop's "undo the edit", the second closing example, the merged blueprint-measuring line, shorter wording in Sig 3, Sig 4, Sig 6, Text field and Layout).
+
+## 1.1.0-rc.5
+
+A content home opens with one large headline again, counts read the same in every app, phone table pins keep a
+visible label, and closings and failed forms behave the same way everywhere.
+
+- Split opener, Limits: a content home's featured block is a mono "FEATURED" label over its plate and text, no h2
+  (was: a full h2 opener, which pushed the lead plate below the fold); the plate's top sits above 900px at 1440px.
+- Split opener, Limits: prose beside an opener is one paragraph, longer prose goes under it; the description repeats no
+  phrase of the prose and each destination is linked once per section (was: only the first sentence was protected).
+- Typography: counts, result lines and the label over a closing are uppercase `.mono-label` in every app (was:
+  unstated, so two apps set them in sentence-case sans).
+- Typography, closing statement: two sentences of at most 12 characters, each one tone in a no-wrap span, one line from
+  `breakpoint.lg` and breaking only between sentences (was: a 24-character limit, which let a tone split mid-phrase).
+- Table, small screens: the pin head is a short visible mono word, or the value carries its unit ("4 projects") under a
+  hidden head; only an actions pin's head may be empty (was: hidden over any number).
+- Text field, error: when the first invalid field is more than a viewport above the banner, the same banner is repeated
+  as the form's first child, and the one above the actions stays (was: "the banner also opens the form").
+- Spacing: the 48px settings-group gap also runs from a form's actions to the next hairline. Layout: cards, grids and
+  tables in a settings group span the controls column's full width.
+- Verification: blueprint widths can be measured in a browser or from a 2x screenshot (pixels divided by 2); new checks
+  for one headline in the first viewport, no repeated phrase or link, readable pin heads, and the same mono counts and
+  one-line closing across apps.
+- Budget: true duplicates removed (pointer sentences, restated test-id and status-region notes, the group-count and
+  appearance notes now covered by Typography and Ongoing development).
+
+## 1.1.0-rc.4
+
+Closings stay two short lines on phones, blueprint rows and section prose line up, article pages open with their
+title and a wide plate again, and failed forms keep their summary next to the fields.
+
+- Typography, closing statement: copy at most 24 characters ("New posts. One email."), so it sets in 2 lines or fewer
+  at 48px at 390px (was: 1 or 2 sentences, which ran to 6 lines on phones); size stays
+  `clamp(h2, 6vw, display)`, longer copy in the form's helper line.
+- Isometric blueprint: `.bp-row` aligns to the start and each figure is a 3-row subgrid (caption, drawing on a shared
+  base, title and text), so captions and titles are level across the row. `slab()` draws the front vertical edge
+  (`.bp-edge`) and a rib round the sides when h is at least 0.3w.
+- Split opener, Limits: a section's prose follows its opener (right column or at `size.measure`), never below a figure
+  row in one half; the description never repeats the prose.
+- Applying the concept, new Article row: breadcrumb, h1, meta, then a `plate--wide` lead plate; the contents list is a
+  side rail on wide screens and a closed "On this page" after the plate on small ones, never above the h1.
+- Table, sort: in a right-aligned head the chevron comes before the label so the label ends on the cells' edge.
+- Text field, error: the banner sits directly above the actions; focus moves to the first invalid field, and the
+  banner also opens the form when that field is more than a viewport away. Layout: a form's preview sits above the
+  fields.
+- Spacing: settings groups are `space.48` from one group's last content to the next hairline, card grids included.
+- Verification: blueprint widths measured in the browser and pasted; new checks for the closing, blueprint captions,
+  section prose, article order, sortable heads, settings gaps and failed-submit focus.
+- Budget: true duplicates removed (Applying's app-header row, placements repeated from components, restated notes).
+
+## 1.1.0-rc.3
+
+Phone tables keep a row's second line whole, product pages show one figure number and get their stock line and
+numbered details back, and closings, legends, headings and KPI labels line up the same way in every app.
+
+- Table: a badge naming the row moves from beside the first cell's lines to inline at the end of the first line
+  (`margin-left:space.8`); under `breakpoint.sm` it shows its dot only, label in `.badge-label` for screen readers. The
+  pin's head is one short word or `.sr-only`, the pin at most its widest value plus `space.24`, and `.pin` (now
+  `.tbl .pin`) goes on the `th` too so the head aligns right like its cells.
+- Spec plate, Limits: one figure number per plate (its caption or a `.fig`, never both); the item name once per
+  viewport; no shared kind in a grid row or between adjacent posts. `specKinds` now waits until all 8 kinds are used
+  before repeating one (was: not among the previous 4), over the full list.
+- Applying → Product detail: the plate's caption is the only FIG; a mono `CATEGORY · IN STOCK` line over the name;
+  Details rows numbered in mono.
+- Never: a closing statement under `font.size.h2`. Typography: closing statement
+  `clamp(h2, 6vw, display)`, 1 or 2 sentences, longer copy in the form's helper line (was "`display` size").
+- Root setup: fonts self-hosted (font packages or local files, never a font CDN); headings `text-wrap:balance`,
+  `p, li` `text-wrap:pretty`; fieldset and legend padding and borders reset. Existing projects apply the same.
+- Card, KPI: the label stays on one line (ellipsis, full label in `title`; shorter or one card per row on phones) so
+  values align.
+- Layout: a preview, banner or panel stacked in a form column takes the form's width.
+- Verification: review pieces are rendered by temporarily editing an existing page and undoing the edit, never in new
+  files; at 390px a badged row's second line is uncut and KPI values are level.
+- Budget: true duplicates shortened (Character, Verification's recipe values and token-file check, Shape's checkbox
+  and toast radii, a few repeated parentheticals).
+
+## 1.1.0-rc.2
+
+Blueprints now fill their frame, content pages keep a large headline and description at every section, and phone
+navigation, segmented options and table pins stop clipping. Working rules trimmed in the previous candidate are back.
+
+- Isometric blueprint: new `pair()` (slab 2 at 2w right, w down, a marching link between their sides) and
+  `blueprint()` (viewBox cropped to the slabs' bounds plus 5%, figure group `g.bp-fig`); size is measured on the
+  drawn group (at least 85% of the svg; about 270px in a row of three, at least 240px at 1440px). `.bp--pair` CSS
+  removed (its 368px minimum did not fit a phone column); `.bp--md`, `.bp--sm` and a full-width `.bp--lg` under
+  `breakpoint.sm` added. Where: the about row is a stack, a connected pair and a box, never two that differ only in
+  slab count; 1-2-3 tier stacks only on plan cards. `size.blueprintLg` 280px → 300px.
+- Split opener, Limits: "one headline of `font.size.h2` or larger per viewport" replaced by: every content section
+  down the page opens with the full opener (48px h2 and the description right), filters or counts never replace the
+  description, section h2s never shrink to protect the h1. Applying → Blog: "one opener" → "an opener per section".
+- Split opener, Where: app sections (cart, checkout, settings groups) get a mono counter and title left, a one-line
+  description right; Applying → Cart says the same.
+- `.screen-head + *` loses its top border; Never: two hairlines under 32px apart with nothing between.
+- Navigation, sidebar under `breakpoint.lg`: "a pill row that scrolls inside itself" → text-only pills that wrap
+  (over 6 items: one pill named after the current page opens the sheet); never a clipped or scrolling nav row.
+- Table: row actions are bordered pills at every width; a badge naming the row stays in the first cell with its dot;
+  the pin holds one action or one status, right-aligned (`text-align:right`), empty when a row has no action.
+- Tabs, segmented pills: native radios visually hidden, selected by `:has(:checked)`, never a drawn circle or dot
+  (also in Never).
+- Spec plate: caption is number and one fact (`FIG 03 · 18 OZ CANVAS`, `NO. 07 · DESIGN`), never the number or
+  category alone.
+- Text field: the failed-submit banner on every form, one-field forms (newsletter) included.
+- Applying → Data table: a 1-to-5 load shows the dot meter beside its number.
+- Restored from the published version: "Closing sections: the dot field", "Closing statement: `display` size",
+  "never bare red text", the checkbox `z-index` note, the Motion pointer to signatures 1, 2, 3, 5, "(actions column
+  pinned)", the dashboard fallback wording, the `specKinds` comment, "exclamation marks or emoji", the empty-state
+  test-id note.
+- Verification: at 390px every nav item visible; blueprints measured on `.bp-fig`; every review route, page and
+  script deleted before finishing.
+- Budget: duplicate lines cut (surface map, quiet-stage values, glyph and dot-field values, Interaction lines for
+  tabs, menu items and checked controls, the dialog row of Applying, and others that repeat a recipe or component).
+
+## 1.1.0-rc.1
+
+Tables on phones now show only the first column and the pinned one, with long values ending in an ellipsis, and
+blueprints keep their size in groups.
+
+- Table, small screens: "hide secondary columns (location, last active, owner)" is replaced by: under `breakpoint.sm`
+  every column except the first and the pinned one is `display:none`; the first cell holds at most two single-line
+  lines with an ellipsis (`white-space:nowrap`, `text-overflow:ellipsis`, `max-width:0` cell), the second from the
+  cell's own text or `data-sub`; every row of a table has the same number of lines. New CSS block in the recipe.
+- Isometric blueprint, Limits: sizes are now rendered CSS pixels (`getBoundingClientRect().width`): a row of three
+  renders each drawing at `size.blueprintLg` or its full column, never under `size.blueprintMd`; each slab of a
+  connected pair at least `size.blueprintMd`. Was "a row of three at `size.blueprintLg`" and "half-widths are rendered
+  px". New `.bp-row`, `.bp--lg`, `.bp--pair` CSS.
+- Verification: two new steps, tables at 390px (two columns, no stray glyph, no cut word, equal rows) and a measured
+  width for every blueprint.
+- Budget: duplicate lines cut to stay under 7,500 words (Character shortened; stage gradient stops, dot-field and
+  toast-shimmer placements, Motion's signature pointer, checkbox z-index note, empty-state test-id note and others
+  that repeat a recipe, Applying or the Never list).
+
+## 1.0.0
+
+First release of Graphite Blueprint: a near-black instrument panel. Graphite greys stacked in five steps,
+1px hairlines, pill controls and one indigo kept for focus and selection. The product's own interface is the
+main image, set on a softly lit stage; work in progress speaks in a 5x5 dot matrix and a passing shimmer, and
+explanations are drawn as isometric hairline blueprints with mono figure captions. Dark is the default, with a
+light mode in cool neutral greys.
+
+- Ten defining rules and a Never list: the ground covers most of every screen, text in four steps of grey,
+  indigo at most three times a screen, hairlines instead of shadows, pills and 8px panels.
+- Six signature recipes: the spotlit stage, the dot-matrix status glyph, isometric blueprints with marching
+  connectors, spec plates for items without a picture, the working shimmer, and the split section opener.
+- Motion in two speeds: state changes in 100 to 160ms, slow stepped loops only for work in progress, and every
+  loop frozen on a readable frame under reduced motion.
+- Layout rules for dense screens: side-by-side panels end together, tables keep a pinned first column on small
+  screens, and frames never nest more than two deep.
+- 13 specified components with designed states, Inter and Geist Mono (both openly licensed).
+
+## 0.1.0-rc.3
+
+Panels side by side now end on one line, pinned table columns on phones no longer cut the text beside them, and
+stores close with a statement over the dot field again. Spec plates have twice as many figures, so neighbouring cards
+no longer look alike.
+
+- Spotlit stage: "panels in one row align to their content" is replaced by "panels in one row end together": the chart
+  stage stretches to the row height (at least `size.stageMini`) or the list beside it is capped with "View all →";
+  no empty band inside a panel, no column ending more than `space.48` above its neighbour.
+- Applying the concept, dashboard: the chart and the activity list end on one line, otherwise the chart takes the full
+  row and activity goes below.
+- Table, small screens: the pinned column is opaque (`color.surface.default`, or `card` inside a card), with a 1px
+  `color.border.subtle` edge and a 16px fade over the scrolling cells; under `breakpoint.sm` secondary columns are
+  hidden instead of half-visible.
+- Applying the concept, closing: was "newsletter" only; now newsletter, store and blog list pages end with a two-tone
+  statement over the dot field (a store: its shipping or returns promise).
+- Spec plate: figure kinds 4 → 8 (bars, perspective grid, ringed sphere, square lattice added); neighbours in a grid
+  never share a kind (`specKinds`).
+- Blueprint: slab half-widths are rendered pixels, at least 40; slabs side by side get `size.blueprintMd` each, and a
+  narrow column shows one slab and the connector instead of four shrunk ones.
+- Text field: a failed submit shows the danger banner (hairline box, `color.status.dangerTint` wash, danger dot) on
+  every form, checkout included; never bare red text.
+- Verification: rows at 1440px end within 48px of each other; no table cell cut mid-letter at 390px.
+
+## 0.1.0-rc.2
+
+Rows and controls stay clickable, count badges are readable, captions describe the item, and frames no longer stack
+inside each other. Slab drawings have tighter corners, plate figures sit centred and connectors move.
+
+- Checkbox and radio: the row's hit area now comes from wrapping input and text in the `<label>` (or padding the
+  label), never from an overlay; controls inside a row or card with a stretched link get `position:relative;z-index:1`.
+- Never: nothing stacked above a native control; no stage inside a bordered card or frames nested more than two deep;
+  no copy that explains the system or how a drawing was made.
+- Badge: the count badge is its own `.count` class (16px, `color.action.primary` fill, `color.text.onAction`
+  numeral), never combined with the generic badge.
+- Spotlit stage: sits on the ground or in one hairline cell; a panel whose content is a quiet stage drops its border
+  and fill; panels in a row align to their content. The blog featured post is a wide plate, not a stage.
+- Blueprint: vertex rounding `r` 14% → 8% and `s` 7% → 5% of the half-width; every connector marches except a
+  stopped connection.
+- Spec plate: the fan figure is centred (origin at the tile's centre line, length 66 to 78); every figure stays inside
+  the central 78%; captions name the item.
+- Table: under `breakpoint.md` the first column keeps `white-space:nowrap` and `min-width:160px`, cells wrap to at
+  most 2 lines.
+- Verification: click each checkbox, radio and switch on the box itself, run the project's end-to-end tests (or say
+  they were not run), and check badge and count legibility in both modes.
+- Unused primitives `space.64`, `motion.easing.inOut` and `motion.distance.flow` removed.
+
+## 0.1.0-rc.1
+
+First candidate of Graphite Blueprint, derived from the reference study. Dark is canonical; light comes from the
+reference's documentation theme, with derived light versions of the stage, blueprint, spec plate and glyph.
+
+- Tokens: graphite ladder, four text steps, white-alpha hairlines, one indigo, light and dark semantics; tertiary text
+  and control outlines lifted for contrast.
+- Signature elements: spotlit stage (lit and quiet), dot-matrix glyph with dot field and meter, isometric hairline
+  blueprint, spec plate, working shimmer and live edges, split opener with two-tone voice and mono figures.
+- Thirteen components specified, empty state included.

package/content/templates/graphite-blueprint/1.1.0/agent/instructions.md

@@ -0,0 +1,41 @@
+## New project
+
+1. Inspect the stack; propose an installation plan and wait for approval. Ask which appearances the product supports. Both: tokens.css follows the device; a theme switch sets `data-theme` on `html` only if the product has or asks for one. One: dark (`<html data-theme="dark">`, `color-scheme: dark`) unless the user asks for light.
+2. Copy `dist/tokens.css` into global styles (or map `dist/tokens.json` into the theme).
+3. Self-host Inter (variable, weights 400, 510 and 590) and Geist Mono 400 (the npm font packages or local files, `@font-face` with `font-display:swap`); never a font CDN. Root: body `color.surface.default`, `color.text.body`, sans `font.size.body`, `font.lineHeight.body`, `font.tracking.body`; headings primary, `text-wrap:balance`; `p, li{text-wrap:pretty}`; `fieldset{margin:0;padding:0;border:0;min-width:0} legend{padding:0}`; `pre, code, kbd, samp` mono; global `:focus-visible`; the reduced-motion block; `html, body{overflow-x:clip}`.
+4. Build the six signature elements first, as reusable pieces, one per recipe with all its helpers (`pair`, `blueprint`, `specKinds`, dot meter, `ScreenHead`, `.mono-label`). Review them (Verification) before any screen.
+5. Build the components with every state; place the signature elements per Applying the concept.
+6. Create `design-system/` with `VERSION` (`graphite-blueprint, updated <the spec's update date>`), the tokens, and `components.md`: conventions, where each signature element is used, each blueprint's subject by screen.
+7. Add to `AGENTS.md` and `CLAUDE.md` (create if missing): "UI work follows design-system/ — read it before building screens."
+
+## Existing project
+
+1. Audit styling, components, routes and tests; propose a migration plan and wait for approval. Ask about appearances as in New project.
+2. Map the tokens onto the existing variables (aliasing old names). A brand action color becomes `color.action.primary` (the inverse pill), never the accent. Fonts and root setup as in New project step 3.
+3. Build the signature elements, restyle one representative screen with them as a sample, and wait for review.
+4. Continue screen by screen, one commit each.
+5. Preserve routes, logic, API contracts, form fields and validation, test ids, text used by tests and accessibility attributes. Restyle existing markup; keep native inputs.
+6. Finish with `design-system/` and the pointer lines from New project.
+
+## Ongoing development
+
+- Read `design-system/` first; use semantic tokens and existing components; no hard-coded colors, sizes, radii, shadows or durations.
+- Every new screen gets the signature elements its context calls for in Applying the concept; a screen without them is unfinished.
+- Uncovered needs: compose from tokens and note it in `components.md`. Conflicting requests (colored primary, spinner, bold headings): present options.
+
+## Verification
+
+- Build passes; run the project's unit and end-to-end tests if they exist, else report they were not run.
+- Review loop, two rounds or more: render each signature piece alone at 2x, dark and light, in a temporarily edited existing page (never a new file); compare with its recipe (light falloff, 0.5px strokes, vertex rounding, hidden faces, lit and unlit dots, caption position), note three or more differences, fix, render again.
+- Each screen at 1440px and 390px, dark and light: no sideways scroll; status and row actions visible; no bare `serif` or `monospace` text; captions name the item; every badge, chip and count legible at 2x; columns of a row end within 48px of each other (1440px).
+- At 390px: every nav item fully visible; the closing at most 2 lines; tables show only the first and the pinned column, no stray glyph, no word cut except by an ellipsis, equal rows, a badged row's second line uncut; KPI values level.
+- Measure at 1440px and 390px and paste the numbers with the method (a browser's `getBoundingClientRect()`, or pixels ÷ 2 in a native-size 2x screenshot; never computed from CSS): each `.bp-fig` width against Signature 3 → Limits; each right-aligned head's right x (numbers, pin) beside its cells' (equal); each settings group's last visible block to the next rule, status regions empty (48); an article's left x for brand, breadcrumb, h1, Related and footer (one value).
+- Check: blueprint-row captions and titles level; section prose beside or under its opener, no phrase or link twice in a section; a content home's first viewport has one large headline; articles put h1, meta and lead plate before the contents list; every pin head readable; no two hairlines with nothing between, no plate caption ending in an ellipsis, no "+" on a link; a failed submit focuses the first invalid field, a banner within one viewport of it; across apps, counts, result lines and the closing's label are the same uppercase `.mono-label`, the closing one line at 1440px, one tone per sentence.
+- Reduced motion (emulated): nothing loops, glyphs show their rest frame, every block is final.
+- Tab through every screen: the indigo outline always visible. Click each checkbox, radio and switch on the box, not its label.
+- Walk the ten rules and the Never list. Check the diff: no review edit, page or script remains. Report files changed, what you could not apply, and your decisions.
+
+## Rollback
+
+- Each screen is its own commit and can be reverted alone.
+- Tokens, fonts, root setup and the signature pieces are separate commits, reverted last.

package/content/templates/graphite-blueprint/1.1.0/components/badge.md

@@ -0,0 +1,15 @@
+### Badge
+
+**Anatomy.** Height 20px, `radius.full`, padding 0 `space.8`, 1px `color.border.default`, transparent fill,
+`font.size.caption` sans 510 `color.text.body`; a leading 6px dot in the status hue (or a 12px status icon), gap
+`space.6`; the text in a `.badge-label` span. Count badge: its own class, never combined with `.badge`; on an
+icon button it sits inside the button (`position:absolute`, `pointer-events:none`):
+
+```css
+.count{display:inline-grid;place-items:center;min-width:16px;height:16px;padding:0 var(--space-4);border:0;
+  border-radius:var(--radius-full);background:var(--color-action-primary);color:var(--color-text-on-action);
+  font:var(--font-weight-semibold) var(--font-size-micro)/1 var(--font-family-sans);font-variant-numeric:tabular-nums;}
+```
+
+**States.** Static; interactive chips: Interaction (filter chip). Current: border `color.border.strong`.
+