@nurix/etna 0.19.3 → 0.19.4

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

@@ -1,4 +1,4 @@
-// skills/design/scripts/validate-combinations.mjs — schema validator for the combination datasets (data/combinations/): file presence, byte-exact headers, sequential ids, tier/density/surface vocabularies, symbol-glyph ban, palette hex + WCAG contrast floors, chart token discipline, lucide/font registry membership, and manifest row-count parity. Importable (validateCombinations(dir)) and runnable as a CLI.
+// 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";
@@ -7,14 +7,15 @@ 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", "product-router.csv", "charts.csv", "icons.csv", "landing.csv"];
-const REQUIRED_FILES = [...CSV_FILES, "manifest.json", "lucide-names.json", "fonts-known.json", "Readme.md"];
+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"],
-    "palettes.csv": ["id", "palette", "tier", "product_affinity", "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"],
+    "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"],
@@ -24,7 +25,20 @@ const HEADERS = {
 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"]);
-const VALID_KEY_SURFACES = new Set(["list-detail", "dashboard", "entity-detail", "create-edit", "log-stream", "command-center"]);
+// 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/;
@@ -141,9 +155,11 @@ function checkGeneric(file, csv, errors) {
     });
 }
 
-// palettes.csv: uppercase 6-digit hex in all 34 color cells + WCAG contrast floors.
+// 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];
@@ -163,6 +179,50 @@ function checkPalettes(csv, errors) {
     }
 }
 
+// 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) {
@@ -199,7 +259,7 @@ function checkIcons(csv, dir, errors) {
     }
 }
 
-// typography.csv rows against the fonts-known.json registry (family -> known weights) + contrast vocabulary.
+// 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
@@ -224,6 +284,31 @@ function checkTypography(csv, dir, errors) {
         }
         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`);
     }
 }
 
@@ -236,7 +321,7 @@ function checkDensityAndSurfaces(file, csv, errors) {
             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_KEY_SURFACES.has(surface))
+                if (!VALID_ARCHETYPES.has(surface))
                     errors.push(`product-router.csv row ${row._line} (${row.product_type}): unknown key_surface "${surface}"`);
         }
     }
@@ -249,8 +334,32 @@ function checkLanding(csv, errors) {
             errors.push(`landing.csv row ${row._line} (${row.pattern}): tier must be dormant-marketing (got "${row.tier}")`);
 }
 
-// manifest.json: datasets entry per CSV with the required keys and a rows.total matching the actual row count.
-function checkManifest(dir, csvs, errors) {
+// 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;
@@ -261,11 +370,24 @@ function checkManifest(dir, csvs, errors) {
         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}"`);
-        const total = entry.rows && typeof entry.rows === "object" ? entry.rows.total : undefined;
-        if (typeof total !== "number") errors.push(`manifest.json: datasets entry for ${file} has no numeric rows.total`);
-        else if (csvs[file] && total !== csvs[file].rows.length)
-            errors.push(`manifest.json: ${file} rows.total=${total} but the CSV has ${csvs[file].rows.length} data rows`);
+        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.
@@ -286,13 +408,16 @@ export function validateCombinations(dir) {
     }
 
     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);
-    checkManifest(dir, csvs, 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nurix/etna",
-    "version": "0.19.3",
+    "version": "0.19.4",
     "description": "Bootstrap a project with a Nurix harness — copies the harness's CLAUDE.md, skills, agents, rules, and hooks directly into the project from a bundled payload (no marketplace fetch, no network).",
     "type": "module",
     "bin": {