@nurix/etna 0.19.11 → 0.19.12

package/data/harnesses/code/skills/design/scripts/snapshot-goldens.mjs

@@ -1,164 +0,0 @@
-#!/usr/bin/env node
-// skills/design/scripts/snapshot-goldens.mjs — snapshot golden hashes of the CSS emitted for every design-tokens artifact (data/design-tokens/<slug>/) into data/design-tokens/goldens.json, the byte-match regression oracle for the emission pipeline, then run the Tailwind compile smoke (emission contract 5): one emitted globals.css + personality.css + fonts.css set is actually compiled by @tailwindcss/vite (the fonts.css @fontsource imports resolve against local stubs) — goldens hash bytes and never compile them, so a byte-green gate can hide unbuildable CSS (a derivation comment containing a Tailwind utility literal closes the comment early). Emission uses --provisional: hint-carrying library twins are hashed at their provisional values (--emit alone still refuses on hints).
-
-import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { tmpdir } from "node:os";
-import { fileURLToPath } from "node:url";
-import { spawnSync } from "node:child_process";
-import { goldenHash } from "./lib/golden.mjs";
-
-const scriptsDir = dirname(fileURLToPath(import.meta.url));
-const skillDir = dirname(scriptsDir);
-const derivePersonalityScript = join(scriptsDir, "derive-personality.mjs");
-const tokensDir = join(skillDir, "data", "design-tokens");
-const goldensJsonPath = join(tokensDir, "goldens.json");
-
-// Where full emitted outputs are kept (one subdir per slug) — GOLDENS_EMIT_ROOT to pin it, else a fresh temp dir.
-const emitRoot = process.env.GOLDENS_EMIT_ROOT || mkdtempSync(join(tmpdir(), "design-goldens-"));
-mkdirSync(emitRoot, { recursive: true });
-
-// Every artifact directory under data/design-tokens/ (a directory holding design.tokens.json).
-const entries = readdirSync(tokensDir, { withFileTypes: true })
-  .filter((d) => d.isDirectory() && existsSync(join(tokensDir, d.name, "design.tokens.json")))
-  .map((d) => ({ slug: d.name, path: join(tokensDir, d.name) }))
-  .sort((a, b) => (a.slug < b.slug ? -1 : 1));
-
-const goldens = {};
-const failures = [];
-const provisional = [];
-
-for (const { slug, path } of entries) {
-  const outdir = join(emitRoot, slug);
-  const run = spawnSync(process.execPath, [derivePersonalityScript, path, "--emit", outdir, "--provisional"], { encoding: "utf8" });
-  if (run.status !== 0) {
-    failures.push({ slug, error: (run.stderr || run.stdout || `exit status ${run.status}`).trim() });
-    console.log(`FAIL ${slug}`);
-    continue;
-  }
-  const wasProvisional = /^emit PROVISIONAL/m.test(run.stdout || "");
-  if (wasProvisional) provisional.push(slug);
-  try {
-    const personalityCss = readFileSync(join(outdir, "src", "styles", "personality.css"), "utf8");
-    const globalsCss = readFileSync(join(outdir, "src", "styles", "globals.css"), "utf8");
-    goldens[slug] = { personality: goldenHash(personalityCss), globals: goldenHash(globalsCss) };
-    console.log(`OK   ${slug}${wasProvisional ? "  (provisional)" : ""}`);
-  } catch (err) {
-    failures.push({ slug, error: String((err && err.message) || err) });
-    console.log(`FAIL ${slug}`);
-  }
-}
-
-// Assemble the sorted-key document; "_meta" sorts first (ASCII "_" < "a").
-const document = {
-  _meta: {
-    description: "Post-carrier golden hashes of the CSS emitted by derive-personality.mjs --emit --provisional for every design-tokens artifact (data/design-tokens/<slug>/), dark-inclusive: an artifact shipping design.tokens.dark.json hashes its emitted :root[data-theme=\"dark\"] block too. Hint-carrying twins are hashed at their provisional $values (--emit without --provisional still refuses on hints). Each entry records the sha256 of the comment-stripped personality.css and globals.css (see scripts/lib/golden.mjs). The byte-match regression oracle for the emission pipeline; the Tailwind compile smoke (emission contract 5) runs after every refresh.",
-    generator: "scripts/snapshot-goldens.mjs",
-    strip: "css-comments",
-  },
-};
-for (const slug of Object.keys(goldens).sort()) document[slug] = goldens[slug];
-
-mkdirSync(dirname(goldensJsonPath), { recursive: true });
-writeFileSync(goldensJsonPath, JSON.stringify(document, null, 2) + "\n");
-
-console.log(`\n${entries.length} entries: ${Object.keys(goldens).length} OK (${provisional.length} provisional), ${failures.length} FAIL`);
-console.log(`goldens: ${goldensJsonPath}`);
-console.log(`emitted outputs: ${emitRoot}`);
-if (failures.length > 0) {
-  for (const f of failures) console.error(`\nFAIL ${f.slug}:\n${f.error}`);
-  process.exit(1);
-}
-
-// ---------------------------------------------------------------------------
-// Tailwind compile smoke (emission contract 5) — compile one emitted pair for real
-// ---------------------------------------------------------------------------
-
-// True when a spawn result reads as "npm cannot reach the registry" (the only degradable failure).
-function isNetworkFailure(res) {
-  const text = `${res.stderr || ""}${res.stdout || ""}`;
-  return res.error !== undefined || /ENOTFOUND|ETIMEDOUT|EAI_AGAIN|ECONNREFUSED|ENETUNREACH|network|offline/i.test(text);
-}
-
-// Compile the emitted pair of one slug with @tailwindcss/vite in a scratch project; exits non-zero
-// on a compile failure (the smoke is a gate). Degrades with a notice only when npm is unreachable.
-function runCompileSmoke(slug) {
-  const src = join(emitRoot, slug, "src", "styles");
-  if (!existsSync(join(src, "globals.css"))) {
-    console.error(`\ncompile smoke: no emitted output for ${slug} — cannot smoke`);
-    process.exit(1);
-  }
-  const smokeDir = process.env.GOLDENS_SMOKE_DIR || join(tmpdir(), "design-goldens-smoke");
-  mkdirSync(join(smokeDir, "src", "styles"), { recursive: true });
-
-  writeFileSync(join(smokeDir, "package.json"), JSON.stringify({
-    name: "design-goldens-smoke",
-    private: true,
-    type: "module",
-    devDependencies: { vite: "^7.0.0", tailwindcss: "^4.0.0", "@tailwindcss/vite": "^4.0.0" },
-  }, null, 2) + "\n");
-  writeFileSync(join(smokeDir, "vite.config.mjs"), `// design-goldens-smoke vite.config.mjs — @tailwindcss/vite over the emitted pair
-import { defineConfig } from "vite";
-import tailwindcss from "@tailwindcss/vite";
-export default defineConfig({ plugins: [tailwindcss()], logLevel: "error" });
-`);
-  // Utility classes in the content so the @theme-driven utilities (ramp, shadows, ladder roles,
-  // motion classes) actually generate — a bad @theme value fails here, not just at import.
-  writeFileSync(join(smokeDir, "index.html"), `<!doctype html>
-<html lang="en" data-style="${slug}" data-theme="light" data-density="standard">
-<head><meta charset="utf-8"><title>design-goldens-smoke</title></head>
-<body>
-  <div class="text-h1 tracking-tight p-4 gap-2 rounded-lg shadow-sm bg-surface-raised motion-lift">smoke</div>
-  <div class="text-display shadow-overlay bg-surface-overlay motion-stagger"><span>a</span><span>b</span></div>
-  <script type="module" src="/src/main.js"></script>
-</body>
-</html>
-`);
-  writeFileSync(join(smokeDir, "src", "main.js"), `// design-goldens-smoke entry — pulls the emitted pair through the Tailwind build
-import "./styles/globals.css";
-`);
-  for (const f of ["globals.css", "personality.css", "fonts.css"]) {
-    writeFileSync(join(smokeDir, "src", "styles", f), readFileSync(join(src, f), "utf8"));
-  }
-
-  if (!existsSync(join(smokeDir, "node_modules", "vite"))) {
-    const install = spawnSync("npm", ["install", "--no-audit", "--no-fund"], { cwd: smokeDir, encoding: "utf8" });
-    if (install.status !== 0) {
-      if (isNetworkFailure(install)) {
-        console.log(`\ncompile smoke SKIPPED — npm unreachable (${(install.stderr || "").split("\n")[0] || "no network"}); the goldens are hashed but this refresh is NOT compile-verified. Re-run snapshot-goldens.mjs online.`);
-        return;
-      }
-      console.error(`\ncompile smoke: npm install failed in ${smokeDir}:\n${(install.stderr || install.stdout || "").slice(0, 2000)}`);
-      process.exit(1);
-    }
-  }
-  // The library import resolves against a local stub: the smoke gates OUR emitted bytes compiling,
-  // not restricted-registry availability. Written after install so npm pruning cannot drop it.
-  const stubDir = join(smokeDir, "node_modules", "@nurix", "components");
-  mkdirSync(stubDir, { recursive: true });
-  writeFileSync(join(stubDir, "package.json"), JSON.stringify({ name: "@nurix/components", version: "0.0.0-smoke-stub", exports: { "./styles.css": "./styles.css" } }, null, 2) + "\n");
-  writeFileSync(join(stubDir, "styles.css"), `/* @nurix/components/styles.css — compile-smoke stub: import resolution + cascade shape only */
-:root { --background: oklch(1 0 0); --radius-sm: calc(var(--radius) - 4px); }
-`);
-  // The emitted fonts.css imports resolve against local @fontsource stubs for the same reason:
-  // the smoke gates OUR bytes compiling, never per-package registry availability.
-  const fontsCss = readFileSync(join(smokeDir, "src", "styles", "fonts.css"), "utf8");
-  for (const m of fontsCss.matchAll(/@import\s+['"]((@fontsource(?:-variable)?\/[^'"/]+)(?:\/([^'"]+))?)['"]/g)) {
-    const [, spec, pkgName, relFile] = m;
-    const rel = relFile || "index.css";
-    const pkgDir = join(smokeDir, "node_modules", ...pkgName.split("/"));
-    mkdirSync(dirname(join(pkgDir, rel)), { recursive: true });
-    writeFileSync(join(pkgDir, "package.json"), JSON.stringify({ name: pkgName, version: "0.0.0-smoke-stub" }, null, 2) + "\n");
-    writeFileSync(join(pkgDir, rel), `/* ${spec} — compile-smoke stub: import resolution only */\n`);
-  }
-
-  const build = spawnSync("npm", ["exec", "--no", "--", "vite", "build"], { cwd: smokeDir, encoding: "utf8" });
-  if (build.status !== 0) {
-    console.error(`\ncompile smoke FAILED — the emitted ${slug} pair does not compile under @tailwindcss/vite:`);
-    console.error((build.stderr || build.stdout || "").slice(0, 4000));
-    process.exit(1);
-  }
-  console.log(`compile smoke PASSED — emitted ${slug} pair compiles under @tailwindcss/vite (${smokeDir})`);
-}
-
-runCompileSmoke(goldens.nurix ? "nurix" : Object.keys(goldens).sort()[0]);

package/data/harnesses/code/skills/design/scripts/validate-combinations.mjs

@@ -1,439 +0,0 @@
-// skills/design/scripts/validate-combinations.mjs — schema validator for the combination datasets (data/combinations/): file presence, byte-exact headers, sequential ids, tier/density/surface/theme/budget vocabularies, symbol-glyph ban, palette hex + WCAG contrast floors, style payload + checklist discipline, typography @fontsource binding, motion token-name discipline, chart token discipline, lucide/font registry membership, accent-preset scale shape, and manifest row/tier-count parity. Importable (validateCombinations(dir)) and runnable as a CLI.
-import { readFileSync, existsSync } from "node:fs";
-import { join, dirname, resolve } from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
-
-const SCRIPTS_DIR = dirname(fileURLToPath(import.meta.url));
-const SKILL_ROOT = join(SCRIPTS_DIR, "..");
-const DEFAULT_DIR = join(SKILL_ROOT, "data/combinations");
-
-const CSV_FILES = ["typography.csv", "palettes.csv", "styles.csv", "motion.csv", "product-router.csv", "charts.csv", "icons.csv", "landing.csv"];
-const REQUIRED_FILES = [...CSV_FILES, "manifest.json", "lucide-names.json", "fonts-known.json", "accent-presets.md", "Readme.md"];
-
-// Byte-exact, order-exact header contract per dataset.
-const HEADERS = {
-    "typography.csv": ["id", "pairing", "tier", "heading_family", "body_family", "mono_family", "contrast", "mood", "best_for", "heading_weights", "body_weights", "google_fonts_css", "notes", "css-import", "tailwind-config", "display-size-hint"],
-    "palettes.csv": ["id", "palette", "tier", "product_affinity", "theme", "mood", "background", "foreground", "card", "card-foreground", "popover", "popover-foreground", "muted", "muted-foreground", "border", "input", "ring", "primary", "primary-foreground", "secondary", "secondary-foreground", "accent", "accent-foreground", "destructive", "destructive-foreground", "success", "warning", "chart-1", "chart-2", "chart-3", "chart-4", "chart-5", "sidebar", "sidebar-foreground", "sidebar-primary", "sidebar-primary-foreground", "sidebar-accent", "sidebar-accent-foreground", "sidebar-border", "sidebar-ring", "notes"],
-    "styles.csv": ["id", "movement", "tier", "era", "keywords", "description", "palette_stance", "type_stance", "shape_stance", "motion_stance", "density_affinity", "best_for", "avoid_for", "token_leanings", "operator_note", "theme", "voice", "css-recipe", "checklist", "tokens-hint"],
-    "motion.csv": ["id", "moment", "tier", "keywords", "trigger", "duration_token", "easing_token", "transform_delta", "archetypes", "budget", "do", "dont", "performance_notes"],
-    "product-router.csv": ["id", "product_type", "tier", "keywords", "style_priority", "palette_stance", "type_stance", "density_tier", "key_surfaces", "decision_rules", "anti_patterns", "notes"],
-    "charts.csv": ["id", "data_shape", "tier", "keywords", "best_chart", "alternatives", "when", "when_not", "volume_guidance", "series_tokens", "a11y_notes", "fallback", "interaction"],
-    "icons.csv": ["id", "intent", "tier", "keywords", "lucide_name", "import_name", "usage", "notes"],
-    "landing.csv": ["id", "pattern", "tier", "keywords", "section_order", "cta_placement", "color_strategy", "effects", "conversion_notes"],
-};
-
-const VALID_TIERS = new Set(["operator-active", "dormant-marketing"]);
-const VALID_DENSITIES = new Set(["spacious", "standard", "dense"]);
-const VALID_TYPE_CONTRASTS = new Set(["serif+sans", "sans+sans", "sans+serif", "serif+serif", "display+sans", "mono+sans"]);
-// The closed six surface archetypes — product-router key_surfaces and motion archetypes both draw from it.
-const VALID_ARCHETYPES = new Set(["list-detail", "dashboard", "entity-detail", "create-edit", "log-stream", "command-center"]);
-const VALID_STYLE_THEMES = new Set(["light", "dark", "both"]);
-const VALID_PALETTE_THEMES = new Set(["light", "dark"]);
-const VALID_BUDGETS = new Set(["baseline", "brand-forward"]);
-// Legal temporal token names per design-tokens SCHEMA.md: the stored duration primitives (+ v2 stagger-unit) and ease-default plus its emit-derived ease-enter / ease-exit pair.
-const MOTION_DURATION_TOKENS = new Set(["duration-unit", "duration-fast", "duration-normal", "duration-slow", "stagger-unit"]);
-const MOTION_EASING_TOKENS = new Set(["ease-default", "ease-enter", "ease-exit"]);
-// The four executable style payload columns — non-empty on every operator-active row.
-const STYLE_PAYLOAD_COLUMNS = ["voice", "css-recipe", "checklist", "tokens-hint"];
-// One @fontsource import statement, as the css-import cell carries them ;-separated.
-const FONTSOURCE_IMPORT = /^@import '@fontsource(?:-variable)?\/([a-z0-9-]+)\/[a-z0-9.-]+\.css'$/;
-const ACCENT_PRESET_SCALES = 12;
-const ACCENT_PRESET_STEPS = 7;
-
-const UPPER_HEX = /^#[0-9A-F]{6}$/;
-const RAW_HEX_ANYWHERE = /#[0-9a-fA-F]{3,8}\b/;
-// Box drawing, geometric shapes, misc symbols, dingbats, misc symbols-and-arrows, VS16, and emoji — covers ✓ ⚡ ◐ ☐ and kin.
-const BANNED_GLYPHS = new RegExp("[\\u2500-\\u25FF\\u2600-\\u27BF\\u2B00-\\u2BFF\\uFE0F]|\\p{Extended_Pictographic}", "u");
-
-// Foreground-on-base pairs that must clear WCAG AA text contrast (>= 4.5:1).
-const AA_TEXT_PAIRS = [
-    ["background", "foreground"], ["card", "card-foreground"], ["popover", "popover-foreground"],
-    ["muted", "muted-foreground"], ["primary", "primary-foreground"], ["secondary", "secondary-foreground"],
-    ["accent", "accent-foreground"], ["destructive", "destructive-foreground"],
-    ["sidebar", "sidebar-foreground"], ["sidebar-primary", "sidebar-primary-foreground"],
-    ["sidebar-accent", "sidebar-accent-foreground"],
-];
-// Status/series colors that must clear >= 3:1 against background.
-const GRAPHIC_VS_BACKGROUND = ["success", "warning", "chart-1", "chart-2", "chart-3", "chart-4", "chart-5"];
-// The 34 color cells: everything between background and sidebar-ring inclusive in the palettes header.
-const PALETTE_COLOR_COLUMNS = HEADERS["palettes.csv"].slice(
-    HEADERS["palettes.csv"].indexOf("background"),
-    HEADERS["palettes.csv"].indexOf("sidebar-ring") + 1
-);
-
-// Read a UTF-8 file, returning null when it does not exist.
-function readSafe(path) {
-    return existsSync(path) ? readFileSync(path, "utf8") : null;
-}
-
-// Parse RFC4180-style CSV text into an array of field arrays (quotes + doubled-quote escapes honored).
-function parseCsv(text) {
-    const rows = [];
-    let field = "";
-    let record = [];
-    let inQuotes = false;
-    for (let i = 0; i < text.length; i++) {
-        const ch = text[i];
-        if (inQuotes) {
-            if (ch === '"') {
-                if (text[i + 1] === '"') { field += '"'; i++; }
-                else inQuotes = false;
-            } else field += ch;
-        } else if (ch === '"') inQuotes = true;
-        else if (ch === ",") { record.push(field); field = ""; }
-        else if (ch === "\n") { record.push(field); rows.push(record); record = []; field = ""; }
-        else if (ch === "\r") { /* skip */ }
-        else field += ch;
-    }
-    if (field.length > 0 || record.length > 0) { record.push(field); rows.push(record); }
-    return rows;
-}
-
-// WCAG 2.x relative luminance of an uppercase #RRGGBB hex.
-function relativeLuminance(hex) {
-    const chan = (v) => {
-        const c = v / 255;
-        return c <= 0.03928 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
-    };
-    const r = parseInt(hex.slice(1, 3), 16);
-    const g = parseInt(hex.slice(3, 5), 16);
-    const b = parseInt(hex.slice(5, 7), 16);
-    return 0.2126 * chan(r) + 0.7152 * chan(g) + 0.0722 * chan(b);
-}
-
-// WCAG contrast ratio between two #RRGGBB hex colors.
-function contrastRatio(hexA, hexB) {
-    const la = relativeLuminance(hexA);
-    const lb = relativeLuminance(hexB);
-    const [hi, lo] = la >= lb ? [la, lb] : [lb, la];
-    return (hi + 0.05) / (lo + 0.05);
-}
-
-// Load one CSV into { header, rows: [{...byExpectedColumn, _cells, _line}] }, or null (recording an error) when absent.
-function loadCsv(dir, file, errors) {
-    const text = readSafe(join(dir, file));
-    if (text === null) return null;
-    const raw = parseCsv(text).filter((r) => r.length > 1 || (r.length === 1 && r[0].trim() !== ""));
-    if (raw.length === 0) { errors.push(`${file}: file is empty`); return null; }
-    const expected = HEADERS[file];
-    const rows = raw.slice(1).map((cells, i) => {
-        const obj = {};
-        expected.forEach((k, idx) => { obj[k] = cells[idx] !== undefined ? cells[idx] : ""; });
-        obj._cells = cells;
-        obj._line = i + 2; // 1-based, after the header line
-        return obj;
-    });
-    return { header: raw[0], rows };
-}
-
-// Generic invariants shared by every dataset: exact header, column counts, sequential ids, unique names, valid tier, no symbol glyphs.
-function checkGeneric(file, csv, errors) {
-    const expected = HEADERS[file];
-    if (csv.header.length !== expected.length || expected.some((h, i) => csv.header[i] !== h))
-        errors.push(`${file}: header mismatch: expected [${expected.join(",")}] got [${csv.header.join(",")}]`);
-
-    const nameCol = expected[1];
-    const seenNames = new Map();
-    csv.rows.forEach((row, i) => {
-        if (row._cells.length !== expected.length)
-            errors.push(`${file} row ${row._line}: has ${row._cells.length} columns, expected ${expected.length}`);
-
-        if (!/^\d+$/.test(row.id) || parseInt(row.id, 10) !== i + 1)
-            errors.push(`${file} row ${row._line}: id "${row.id}" breaks 1..N sequence (expected ${i + 1})`);
-
-        const name = row[nameCol];
-        if (seenNames.has(name)) errors.push(`${file} row ${row._line}: duplicate ${nameCol} "${name}" (first at row ${seenNames.get(name)})`);
-        else seenNames.set(name, row._line);
-
-        if (!VALID_TIERS.has(row.tier))
-            errors.push(`${file} row ${row._line}: invalid tier "${row.tier}" (want operator-active|dormant-marketing)`);
-
-        for (const cell of row._cells) {
-            const m = BANNED_GLYPHS.exec(cell);
-            if (m) { errors.push(`${file} row ${row._line}: cell contains banned symbol glyph "${m[0]}"`); break; }
-        }
-    });
-}
-
-// palettes.csv: theme enum, uppercase 6-digit hex in all 34 color cells + WCAG contrast floors.
-function checkPalettes(csv, errors) {
-    for (const row of csv.rows) {
-        if (!VALID_PALETTE_THEMES.has(row.theme))
-            errors.push(`palettes.csv row ${row._line} (${row.palette}): invalid theme "${row.theme}" (want light|dark)`);
-        const valid = {};
-        for (const col of PALETTE_COLOR_COLUMNS) {
-            const v = row[col];
-            if (!UPPER_HEX.test(v)) errors.push(`palettes.csv row ${row._line} (${row.palette}): ${col} "${v}" is not uppercase #RRGGBB`);
-            else valid[col] = v;
-        }
-        for (const [base, fg] of AA_TEXT_PAIRS) {
-            if (!valid[base] || !valid[fg]) continue;
-            const ratio = contrastRatio(valid[base], valid[fg]);
-            if (ratio < 4.5) errors.push(`palettes.csv row ${row._line} (${row.palette}): ${fg} on ${base} contrast ${ratio.toFixed(2)}:1 < 4.5:1`);
-        }
-        for (const col of GRAPHIC_VS_BACKGROUND) {
-            if (!valid[col] || !valid.background) continue;
-            const ratio = contrastRatio(valid[col], valid.background);
-            if (ratio < 3) errors.push(`palettes.csv row ${row._line} (${row.palette}): ${col} vs background contrast ${ratio.toFixed(2)}:1 < 3:1`);
-        }
-    }
-}
-
-// styles.csv: theme enum + the payload rule — all four payload cells non-empty on operator-active rows, the checklist carrying 3-7 ;-separated items.
-function checkStyles(csv, errors) {
-    for (const row of csv.rows) {
-        if (!VALID_STYLE_THEMES.has(row.theme))
-            errors.push(`styles.csv row ${row._line} (${row.movement}): invalid theme "${row.theme}" (want light|dark|both)`);
-        if (row.tier !== "operator-active") continue;
-        for (const col of STYLE_PAYLOAD_COLUMNS)
-            if (row[col].trim() === "")
-                errors.push(`styles.csv row ${row._line} (${row.movement}): operator-active row has empty ${col} payload`);
-        const items = row.checklist.split(";").map((s) => s.trim()).filter((s) => s !== "");
-        if (row.checklist.trim() !== "" && (items.length < 3 || items.length > 7))
-            errors.push(`styles.csv row ${row._line} (${row.movement}): checklist has ${items.length} items (want 3-7)`);
-    }
-}
-
-// motion.csv: budget enum, archetypes from the closed six, duration/easing cells referencing only legal temporal token names.
-function checkMotion(csv, errors) {
-    for (const row of csv.rows) {
-        if (!VALID_BUDGETS.has(row.budget))
-            errors.push(`motion.csv row ${row._line} (${row.moment}): invalid budget "${row.budget}" (want baseline|brand-forward)`);
-
-        const archetypes = row.archetypes.split(";").map((s) => s.trim()).filter((s) => s !== "");
-        if (archetypes.length === 0)
-            errors.push(`motion.csv row ${row._line} (${row.moment}): archetypes cell is empty`);
-        for (const a of archetypes)
-            if (!VALID_ARCHETYPES.has(a))
-                errors.push(`motion.csv row ${row._line} (${row.moment}): unknown archetype "${a}"`);
-
-        const durations = row.duration_token.match(/duration-[a-z]+|stagger-unit/g) ?? [];
-        if (durations.length === 0)
-            errors.push(`motion.csv row ${row._line} (${row.moment}): duration_token names no duration token`);
-        for (const tok of durations)
-            if (!MOTION_DURATION_TOKENS.has(tok))
-                errors.push(`motion.csv row ${row._line} (${row.moment}): duration token "${tok}" not in the schema vocabulary (${[...MOTION_DURATION_TOKENS].join(",")})`);
-
-        const easings = row.easing_token.match(/ease-[a-z]+/g) ?? [];
-        if (easings.length === 0)
-            errors.push(`motion.csv row ${row._line} (${row.moment}): easing_token names no easing token`);
-        for (const tok of easings)
-            if (!MOTION_EASING_TOKENS.has(tok))
-                errors.push(`motion.csv row ${row._line} (${row.moment}): easing token "${tok}" not in the schema vocabulary (${[...MOTION_EASING_TOKENS].join(",")})`);
-    }
-}
-
-// charts.csv: operator-active only, --chart-N discipline in series_tokens, N in 1..5 everywhere, no raw hex.
-function checkCharts(csv, errors) {
-    for (const row of csv.rows) {
-        if (row.tier !== "operator-active")
-            errors.push(`charts.csv row ${row._line} (${row.data_shape}): tier must be operator-active (got "${row.tier}")`);
-        if (!/--chart-\d/.test(row.series_tokens))
-            errors.push(`charts.csv row ${row._line} (${row.data_shape}): series_tokens mentions no --chart-N token`);
-        if (RAW_HEX_ANYWHERE.test(row.series_tokens))
-            errors.push(`charts.csv row ${row._line} (${row.data_shape}): series_tokens contains raw hex "${RAW_HEX_ANYWHERE.exec(row.series_tokens)[0]}"`);
-        for (const cell of row._cells) {
-            for (const m of cell.matchAll(/--chart-(\d+)/g)) {
-                const n = parseInt(m[1], 10);
-                if (n < 1 || n > 5) errors.push(`charts.csv row ${row._line} (${row.data_shape}): --chart-${m[1]} out of range 1..5`);
-            }
-        }
-    }
-}
-
-// icons.csv rows against the lucide-names.json registry (kebab -> Pascal).
-function checkIcons(csv, dir, errors) {
-    const text = readSafe(join(dir, "lucide-names.json"));
-    if (text === null) return; // presence already reported
-    let reg;
-    try { reg = JSON.parse(text); } catch { errors.push("lucide-names.json does not parse as JSON"); return; }
-    for (const key of ["lucide_react_version", "fetched", "source", "icons"])
-        if (!(key in reg)) errors.push(`lucide-names.json: missing key "${key}"`);
-    if (typeof reg.icons !== "object" || reg.icons === null) { errors.push("lucide-names.json: \"icons\" is not an object"); return; }
-    if (!csv) return;
-    for (const row of csv.rows) {
-        if (!(row.lucide_name in reg.icons))
-            errors.push(`icons.csv row ${row._line} (${row.intent}): lucide_name "${row.lucide_name}" not in lucide-names.json`);
-        else if (row.import_name !== reg.icons[row.lucide_name])
-            errors.push(`icons.csv row ${row._line} (${row.intent}): import_name "${row.import_name}" != registry "${reg.icons[row.lucide_name]}"`);
-    }
-}
-
-// typography.csv rows against the fonts-known.json registry (family -> known weights), the contrast vocabulary, and the paste-ready payload columns: css-import parses as @fontsource statements whose package set is exactly the row's kebab-cased families, tailwind-config names all three families, display-size-hint non-empty.
-function checkTypography(csv, dir, errors) {
-    const text = readSafe(join(dir, "fonts-known.json"));
-    if (text === null) return; // presence already reported
-    let reg;
-    try { reg = JSON.parse(text); } catch { errors.push("fonts-known.json does not parse as JSON"); return; }
-    for (const key of ["fetched", "source", "families"])
-        if (!(key in reg)) errors.push(`fonts-known.json: missing key "${key}"`);
-    if (typeof reg.families !== "object" || reg.families === null) { errors.push("fonts-known.json: \"families\" is not an object"); return; }
-    if (!csv) return;
-    for (const row of csv.rows) {
-        for (const col of ["heading_family", "body_family", "mono_family"])
-            if (!(row[col] in reg.families))
-                errors.push(`typography.csv row ${row._line} (${row.pairing}): ${col} "${row[col]}" not in fonts-known.json`);
-        for (const [weightsCol, familyCol] of [["heading_weights", "heading_family"], ["body_weights", "body_family"]]) {
-            const known = reg.families[row[familyCol]];
-            if (!Array.isArray(known)) continue; // family membership error already reported
-            for (const tok of row[weightsCol].split(";").map((t) => t.trim()).filter((t) => t !== "")) {
-                if (!/^\d+$/.test(tok)) errors.push(`typography.csv row ${row._line} (${row.pairing}): ${weightsCol} entry "${tok}" is not an integer`);
-                else if (!known.includes(parseInt(tok, 10)))
-                    errors.push(`typography.csv row ${row._line} (${row.pairing}): weight ${tok} not a known weight of ${row[familyCol]} (known: ${known.join(",")})`);
-            }
-        }
-        if (!VALID_TYPE_CONTRASTS.has(row.contrast))
-            errors.push(`typography.csv row ${row._line} (${row.pairing}): invalid contrast "${row.contrast}"`);
-
-        // The font-binding contract at the data root: every import statement parses, and the imported package set is exactly the row's kebab-cased family set.
-        const families = [row.heading_family, row.body_family, row.mono_family];
-        const kebabs = new Set(families.map((f) => f.toLowerCase().replace(/ /g, "-")));
-        const pkgs = new Set();
-        const fragments = row["css-import"].split(";").map((s) => s.trim()).filter((s) => s !== "");
-        if (fragments.length === 0)
-            errors.push(`typography.csv row ${row._line} (${row.pairing}): css-import is empty`);
-        for (const frag of fragments) {
-            const m = FONTSOURCE_IMPORT.exec(frag);
-            if (!m) errors.push(`typography.csv row ${row._line} (${row.pairing}): css-import fragment "${frag}" is not an @import '@fontsource/<pkg>/....css' statement`);
-            else pkgs.add(m[1]);
-        }
-        for (const pkg of pkgs)
-            if (!kebabs.has(pkg))
-                errors.push(`typography.csv row ${row._line} (${row.pairing}): css-import package "${pkg}" matches none of the row's families`);
-        for (const kebab of kebabs)
-            if (fragments.length > 0 && !pkgs.has(kebab))
-                errors.push(`typography.csv row ${row._line} (${row.pairing}): family "${kebab}" has no css-import statement`);
-
-        for (const fam of new Set(families))
-            if (!row["tailwind-config"].includes(fam))
-                errors.push(`typography.csv row ${row._line} (${row.pairing}): tailwind-config does not name family "${fam}"`);
-        if (row["display-size-hint"].trim() === "")
-            errors.push(`typography.csv row ${row._line} (${row.pairing}): display-size-hint is empty`);
-    }
-}
-
-// styles.csv / product-router.csv density vocabulary + product-router key_surfaces vocabulary.
-function checkDensityAndSurfaces(file, csv, errors) {
-    const densityCol = file === "styles.csv" ? "density_affinity" : "density_tier";
-    const nameCol = HEADERS[file][1];
-    for (const row of csv.rows) {
-        if (!VALID_DENSITIES.has(row[densityCol]))
-            errors.push(`${file} row ${row._line} (${row[nameCol]}): invalid ${densityCol} "${row[densityCol]}" (want spacious|standard|dense)`);
-        if (file === "product-router.csv" && row.tier === "operator-active") {
-            for (const surface of row.key_surfaces.split(",").map((s) => s.trim()).filter((s) => s !== ""))
-                if (!VALID_ARCHETYPES.has(surface))
-                    errors.push(`product-router.csv row ${row._line} (${row.product_type}): unknown key_surface "${surface}"`);
-        }
-    }
-}
-
-// landing.csv: dormant-marketing on every row.
-function checkLanding(csv, errors) {
-    for (const row of csv.rows)
-        if (row.tier !== "dormant-marketing")
-            errors.push(`landing.csv row ${row._line} (${row.pattern}): tier must be dormant-marketing (got "${row.tier}")`);
-}
-
-// accent-presets.md: the accent table carries exactly 12 scales, each with 7 oklch step cells; returns the parsed scale count for manifest parity (null when unparseable).
-function checkAccentPresets(dir, errors) {
-    const text = readSafe(join(dir, "accent-presets.md"));
-    if (text === null) return null; // presence already reported
-    const lines = text.split("\n");
-    const headerIdx = lines.findIndex((l) => /^\|\s*Accent\s*\|/.test(l));
-    if (headerIdx === -1) { errors.push("accent-presets.md: accent table header row (| Accent | ...) not found"); return null; }
-    const stepLabels = lines[headerIdx].split("|").map((c) => c.trim()).filter((c) => /^\d+$/.test(c));
-    if (stepLabels.length !== ACCENT_PRESET_STEPS)
-        errors.push(`accent-presets.md: accent table declares ${stepLabels.length} step columns (want ${ACCENT_PRESET_STEPS})`);
-    let scales = 0;
-    for (let i = headerIdx + 2; i < lines.length && lines[i].startsWith("|"); i++) {
-        const cells = lines[i].split("|").slice(1, -1).map((c) => c.trim());
-        const name = cells[0] ?? "";
-        scales++;
-        const steps = cells.filter((c) => /`oklch\([^)]*\)`/.test(c));
-        if (steps.length !== ACCENT_PRESET_STEPS)
-            errors.push(`accent-presets.md: scale ${name} carries ${steps.length} oklch steps (want ${ACCENT_PRESET_STEPS})`);
-    }
-    if (scales !== ACCENT_PRESET_SCALES)
-        errors.push(`accent-presets.md: accent table carries ${scales} scales (want ${ACCENT_PRESET_SCALES})`);
-    return scales;
-}
-
-// manifest.json: datasets entry per CSV with the required keys and rows.total + tier counts matching the actual CSV, plus an accent-presets.md entry whose scales match the parsed table.
-function checkManifest(dir, csvs, accentScales, errors) {
-    const text = readSafe(join(dir, "manifest.json"));
-    if (text === null) return; // presence already reported
-    let manifest;
-    try { manifest = JSON.parse(text); } catch { errors.push("manifest.json does not parse as JSON"); return; }
-    if (typeof manifest.datasets !== "object" || manifest.datasets === null) { errors.push("manifest.json: missing \"datasets\" object"); return; }
-    for (const file of CSV_FILES) {
-        const entry = manifest.datasets[file] ?? manifest.datasets[file.replace(/\.csv$/, "")];
-        if (entry === undefined) { errors.push(`manifest.json: datasets has no entry for ${file}`); continue; }
-        for (const key of ["seed", "research", "quality_bar", "rows", "refresh_trigger"])
-            if (!(key in entry)) errors.push(`manifest.json: datasets entry for ${file} missing key "${key}"`);
-        if (!entry.rows || typeof entry.rows !== "object") { errors.push(`manifest.json: datasets entry for ${file} has no rows object`); continue; }
-        if (!csvs[file]) continue;
-        const actual = {
-            total: csvs[file].rows.length,
-            operator_active: csvs[file].rows.filter((r) => r.tier === "operator-active").length,
-            dormant_marketing: csvs[file].rows.filter((r) => r.tier === "dormant-marketing").length,
-        };
-        for (const key of ["total", "operator_active", "dormant_marketing"]) {
-            if (typeof entry.rows[key] !== "number") errors.push(`manifest.json: datasets entry for ${file} has no numeric rows.${key}`);
-            else if (entry.rows[key] !== actual[key])
-                errors.push(`manifest.json: ${file} rows.${key}=${entry.rows[key]} but the CSV has ${actual[key]}`);
-        }
-    }
-    const accent = manifest.datasets["accent-presets.md"];
-    if (accent === undefined) errors.push("manifest.json: datasets has no entry for accent-presets.md");
-    else if (typeof accent.scales !== "number") errors.push("manifest.json: accent-presets.md entry has no numeric scales");
-    else if (accentScales !== null && accent.scales !== accentScales)
-        errors.push(`manifest.json: accent-presets.md scales=${accent.scales} but the table carries ${accentScales}`);
-}
-
-// Validate every combination dataset in `dir`; returns a self-integrity-shaped result.
-export function validateCombinations(dir) {
-    const name = "combination-data validation";
-    if (!existsSync(dir))
-        return { name, pass: false, detail: "combinations dir missing", errors: [`${dir} does not exist`] };
-
-    const errors = [];
-    for (const file of REQUIRED_FILES)
-        if (!existsSync(join(dir, file))) errors.push(`missing ${file}`);
-
-    const csvs = {};
-    for (const file of CSV_FILES) {
-        const csv = loadCsv(dir, file, errors);
-        csvs[file] = csv;
-        if (csv) checkGeneric(file, csv, errors);
-    }
-
-    if (csvs["palettes.csv"]) checkPalettes(csvs["palettes.csv"], errors);
-    if (csvs["styles.csv"]) checkStyles(csvs["styles.csv"], errors);
-    if (csvs["motion.csv"]) checkMotion(csvs["motion.csv"], errors);
-    if (csvs["charts.csv"]) checkCharts(csvs["charts.csv"], errors);
-    checkIcons(csvs["icons.csv"], dir, errors);
-    checkTypography(csvs["typography.csv"], dir, errors);
-    if (csvs["styles.csv"]) checkDensityAndSurfaces("styles.csv", csvs["styles.csv"], errors);
-    if (csvs["product-router.csv"]) checkDensityAndSurfaces("product-router.csv", csvs["product-router.csv"], errors);
-    if (csvs["landing.csv"]) checkLanding(csvs["landing.csv"], errors);
-    const accentScales = checkAccentPresets(dir, errors);
-    checkManifest(dir, csvs, accentScales, errors);
-
-    const totalRows = CSV_FILES.reduce((n, f) => n + (csvs[f] ? csvs[f].rows.length : 0), 0);
-    return { name, pass: errors.length === 0, detail: errors.length ? `${errors.length} issue(s)` : `${CSV_FILES.length} datasets, ${totalRows} rows validated`, errors };
-}
-
-// CLI entry: node validate-combinations.mjs [--dir <path>]
-if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {
-    const args = process.argv.slice(2);
-    let dir = DEFAULT_DIR;
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === "--dir") dir = resolve(args[++i] || "");
-        else if (args[i].startsWith("--dir=")) dir = resolve(args[i].slice("--dir=".length));
-    }
-    const r = validateCombinations(dir);
-    if (r.pass) { console.log(`PASS  ${r.name} — ${r.detail}`); process.exit(0); }
-    console.error(`FAIL  ${r.name} — ${r.detail}`);
-    for (const e of r.errors) console.error(`   - ${e}`);
-    process.exit(1);
-}