jig-ui 0.16.0 → 0.17.0

package/dist/index.js

@@ -2,9 +2,9 @@
 
 // src/index.ts
 import { Command } from "commander";
-import { readFileSync as readFileSync31 } from "fs";
+import { readFileSync as readFileSync32 } from "fs";
 import { homedir as homedir2 } from "os";
-import { join as join38 } from "path";
+import { join as join39 } from "path";
 
 // src/paths.ts
 import { existsSync } from "fs";
@@ -844,15 +844,15 @@ function detectLegacyCursorRules(projectRoot) {
   }
   return { present: files.length > 0, files };
 }
-function describeLegacyFiles(report, headerLine, subheaderLine) {
-  if (!report.present) return [];
+function describeLegacyFiles(report2, headerLine, subheaderLine) {
+  if (!report2.present) return [];
   const lines = [];
   lines.push(`
 ${headerLine}`);
   lines.push(subheaderLine);
-  for (const f of report.files) lines.push(`    ${f.relPath}`);
-  const edited = report.files.filter((f) => f.modified === true).map((f) => f.relPath);
-  const unknown = report.files.filter((f) => f.modified === "unknown").map((f) => f.relPath);
+  for (const f of report2.files) lines.push(`    ${f.relPath}`);
+  const edited = report2.files.filter((f) => f.modified === true).map((f) => f.relPath);
+  const unknown = report2.files.filter((f) => f.modified === "unknown").map((f) => f.relPath);
   if (edited.length) {
     lines.push("  Edited since install \u2014 kept, never removed automatically:");
     for (const relPath of edited) lines.push(`    ${relPath}`);
@@ -863,22 +863,22 @@ ${headerLine}`);
   }
   return lines;
 }
-function describeLegacyReport(report) {
+function describeLegacyReport(report2) {
   return describeLegacyFiles(
-    report,
-    `Found a pre-0.4.0 Jig install in .jig/ (${report.files.length} file(s)). These are no longer used \u2014`,
+    report2,
+    `Found a pre-0.4.0 Jig install in .jig/ (${report2.files.length} file(s)). These are no longer used \u2014`,
     "  since 0.4.0 the skill and its rules live in your agent's skill directory, not the project:"
   );
 }
-function describeLegacyCursorReport(report) {
+function describeLegacyCursorReport(report2) {
   return describeLegacyFiles(
-    report,
-    `Found a legacy Cursor install (${report.files.length} file(s)). Cursor's skill has moved \u2014`,
+    report2,
+    `Found a legacy Cursor install (${report2.files.length} file(s)). Cursor's skill has moved \u2014`,
     "  from .cursor/rules/jig.mdc to .cursor/skills/jig/SKILL.md; these are no longer read:"
   );
 }
-function removableLegacyFiles(report) {
-  return report.files.filter((f) => f.modified === false).map((f) => f.relPath);
+function removableLegacyFiles(report2) {
+  return report2.files.filter((f) => f.modified === false).map((f) => f.relPath);
 }
 function removeLegacyFiles(projectRoot, relPaths) {
   for (const relPath of relPaths) {
@@ -1031,6 +1031,7 @@ function updateInitFiles(opts) {
 }
 
 // src/commands/explain.ts
+import { existsSync as existsSync9 } from "fs";
 import { join as join15 } from "path";
 
 // src/rules/load.ts
@@ -1410,7 +1411,12 @@ function explain(opts) {
   if (shape) {
     const id = `${shape[1]}-${shape[2]}`;
     const rule = rules.find((r) => r.id === id);
-    if (rule) return renderRule(rule);
+    if (rule) {
+      const example = join15(root, "examples", `${id}.html`);
+      return existsSync9(example) ? `${renderRule(rule)}
+
+Example: ${example} (a dont and a do, each a self-contained HTML fragment)` : renderRule(rule);
+    }
     const spec = specs.find((s) => s.id === id);
     if (spec) return renderSpec(spec);
     const siblings = entries.filter((e) => e.id.startsWith(`${shape[1]}-`)).map((e) => e.id).sort(byNumber);
@@ -1463,7 +1469,7 @@ function sectionsOf(entries) {
 }
 
 // src/commands/check.ts
-import { existsSync as existsSync14, readFileSync as readFileSync19 } from "fs";
+import { existsSync as existsSync15, readFileSync as readFileSync19 } from "fs";
 import { join as join24 } from "path";
 
 // src/check/files.ts
@@ -2764,9 +2770,9 @@ function palettePairs(classes) {
   let background;
   let foreground;
   for (const token of classes.split(/\s+/)) {
-    const bare = token.replace(/^(?:[\w-]+:)*/, "");
-    const bg = /^bg-(.+)$/.exec(bare);
-    const fg = /^text-(.+)$/.exec(bare);
+    const bare2 = token.replace(/^(?:[\w-]+:)*/, "");
+    const bg = /^bg-(.+)$/.exec(bare2);
+    const fg = /^text-(.+)$/.exec(bare2);
     if (bg && PALETTE[bg[1]]) background = PALETTE[bg[1]];
     if (fg && PALETTE[fg[1]]) foreground = PALETTE[fg[1]];
   }
@@ -2787,11 +2793,11 @@ function resolveFloor(body) {
   const raw = m[1].trim();
   const pxMatch = FONT_SIZE_PX_RE.exec(raw);
   const remMatch = FONT_SIZE_REM_RE.exec(raw);
-  let px;
-  if (pxMatch) px = parseFloat(pxMatch[1]);
-  else if (remMatch) px = parseFloat(remMatch[1]) * REM_TO_PX;
+  let px2;
+  if (pxMatch) px2 = parseFloat(pxMatch[1]);
+  else if (remMatch) px2 = parseFloat(remMatch[1]) * REM_TO_PX;
   else return LARGE_FLOOR;
-  const large = BOLD_RE.test(body) ? px >= 18.66 : px >= 24;
+  const large = BOLD_RE.test(body) ? px2 >= 18.66 : px2 >= 24;
   return large ? LARGE_FLOOR : FLOOR;
 }
 var DECL_RE = /(?<![-\w])(color|background(?:-color)?)\s*:\s*([^;]+)(?:;|$)/gi;
@@ -3142,8 +3148,8 @@ var inputZoom = {
       SIZE_RE.lastIndex = 0;
       let m;
       while (m = SIZE_RE.exec(block.body)) {
-        const px = pixels(m[1], ctx.mode);
-        if (px === void 0 || px >= ROOT_PX) continue;
+        const px2 = pixels(m[1], ctx.mode);
+        if (px2 === void 0 || px2 >= ROOT_PX) continue;
         const line = lineOfOffset(block, m.index);
         findings.push(
           mkFinding(
@@ -3151,7 +3157,7 @@ var inputZoom = {
             "input-zoom",
             file,
             line,
-            `form control text resolves to ${px}px; iOS zooms the page on focus below 16px`,
+            `form control text resolves to ${px2}px; iOS zooms the page on focus below 16px`,
             sourceLine(source, line)
           )
         );
@@ -3255,7 +3261,7 @@ var menuState = {
 };
 
 // src/check/declared-properties.ts
-import { existsSync as existsSync9, readFileSync as readFileSync12 } from "fs";
+import { existsSync as existsSync10, readFileSync as readFileSync12 } from "fs";
 import { join as join17 } from "path";
 var DECLARATION_RE = /(?<![\w-])['"]?(--[A-Za-z_][\w-]*)['"]?\s*:/g;
 var AT_PROPERTY_RE = /@property\s+(--[\w-]+)/g;
@@ -3271,7 +3277,7 @@ function readPackageImport(projectRoot, spec) {
   const base = join17(projectRoot, "node_modules", spec);
   for (const candidate of [base, `${base}.css`]) {
     try {
-      if (existsSync9(candidate) && candidate.endsWith(".css")) return readFileSync12(candidate, "utf8");
+      if (existsSync10(candidate) && candidate.endsWith(".css")) return readFileSync12(candidate, "utf8");
     } catch {
     }
   }
@@ -3635,6 +3641,335 @@ var interfaceSafety = {
   }
 };
 
+// src/check/detectors/generated-look.ts
+function report(ctx, name, file, raw, hits) {
+  const seen = /* @__PURE__ */ new Set();
+  return hits.filter((h) => seen.has(h.line) ? false : (seen.add(h.line), true)).map((h) => mkFinding(ctx, name, file, h.line, h.message, sourceLine(raw, h.line))).sort((a, b) => a.line - b.line);
+}
+function classLists(file, raw) {
+  if (!isMarkupHost(file)) return [];
+  return classAttributeValues(raw).map((a) => ({ classes: a.classes.split(/\s+/).filter(Boolean), line: a.line }));
+}
+var bare = (c) => c.replace(/^(?:[\w-]+:)+/, "").replace(/^!/, "");
+var px = (v) => {
+  const m = /^(-?\d*\.?\d+)(px|rem|em)?$/.exec(v.trim());
+  if (!m) return void 0;
+  const n = parseFloat(m[1]);
+  return m[2] === "rem" || m[2] === "em" ? n * 16 : n;
+};
+function twBorderWidth(suffix) {
+  if (!suffix) return 1;
+  const arb = /^\[(.+)\]$/.exec(suffix);
+  if (arb) return px(arb[1]) ?? 0;
+  return Number(suffix) || 0;
+}
+var TW_COLOUR = /^(?:red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-\d{2,3}/;
+function saturated(value, tokens, minS = 25, minAlpha = 0.2) {
+  const c = extractColorComponents(value.trim(), tokens);
+  return !!c && c.alpha >= minAlpha && c.hsl.s >= minS && c.hsl.l > 8 && c.hsl.l < 92;
+}
+function colourIn(value) {
+  return value.replace(/\b\d*\.?\d+(px|rem|em)\b/g, " ").replace(/\b(solid|dashed|dotted|double|groove|ridge|inset|outset|none|hidden)\b/gi, " ").trim();
+}
+var SIDE_DECL = /(?<![-\w])border-(left|inline-start|right|inline-end)(?:-width)?\s*:\s*([^;}]+)/gi;
+var OTHER_SIDE_WIDE = /(?<![-\w])border(?:-(?:top|bottom))?(?:-width)?\s*:\s*(\d*\.?\d+)px/gi;
+var sideTabBorder = {
+  name: "side-tab-border",
+  appliesTo: (file) => isStyleBearing(file),
+  run(source, file, ctx) {
+    const hits = [];
+    for (const block of leafBlocks(source)) {
+      if (/\bblockquote\b|\bq\b/.test(block.selector)) continue;
+      SIDE_DECL.lastIndex = 0;
+      let m;
+      while (m = SIDE_DECL.exec(block.body)) {
+        const width = Math.max(0, ...[...m[2].matchAll(/(\d*\.?\d+)(px|rem)/g)].map((w) => px(w[0]) ?? 0));
+        if (width < 3) continue;
+        const colour = colourIn(m[2]);
+        const colourDecl = new RegExp(`border-${m[1]}-color\\s*:\\s*([^;}]+)`, "i").exec(block.body)?.[1] ?? colour;
+        if (colourDecl && !saturated(colourDecl, ctx.tokens) && !/var\(--color-(?:brand|text-brand|stroke-brand|accent)/.test(colourDecl)) continue;
+        OTHER_SIDE_WIDE.lastIndex = 0;
+        if ([...block.body.matchAll(OTHER_SIDE_WIDE)].some((o) => parseFloat(o[1]) >= width)) continue;
+        hits.push({ line: lineOfOffset(block, m.index), message: `a ${width}px coloured stripe on one side of ${block.selector.trim()}: the shape of an alert on something that is not one` });
+      }
+    }
+    for (const { classes, line } of classLists(file, ctx.raw)) {
+      const plain = classes.map(bare);
+      const side = plain.map((c) => /^border-(l|s|r|e)(?:-(\d+|\[[^\]]+\]))?$/.exec(c)).find((x) => x && twBorderWidth(x[2]) >= 3);
+      if (!side) continue;
+      const colour = plain.find((c) => new RegExp(`^border-(?:${side[1]}-)?(.+)$`).test(c) && TW_COLOUR.test(c.replace(/^border-(?:[lsre]-)?/, "")));
+      if (!colour) continue;
+      if (plain.some((c) => /^border-(?:\d+|\[[^\]]+\])$/.test(c))) continue;
+      hits.push({ line, message: `\`${side[0]}\` with \`${colour}\`: a coloured stripe on one side, the shape of an alert on something that is not one` });
+    }
+    return report(ctx, "side-tab-border", file, ctx.raw, hits);
+  }
+};
+var BORDER_ALL = /(?<![-\w])border(?:-width)?\s*:\s*([^;}]+)/i;
+var RADIUS = /(?<![-\w])border-radius\s*:\s*([^;}]+)/i;
+var roundedAccentBorder = {
+  name: "rounded-accent-border",
+  appliesTo: (file) => isStyleBearing(file),
+  run(source, file, ctx) {
+    const hits = [];
+    for (const block of leafBlocks(source)) {
+      const border = BORDER_ALL.exec(block.body);
+      const radius = RADIUS.exec(block.body);
+      if (!border || !radius) continue;
+      const width = Math.max(0, ...[...border[1].matchAll(/(\d*\.?\d+)px/g)].map((w) => parseFloat(w[1])));
+      const r = /%|9999|999px/.test(radius[1]) ? 999 : Math.max(0, ...[...radius[1].matchAll(/(\d*\.?\d+)(px|rem)/g)].map((w) => px(w[0]) ?? 0));
+      if (width < 2 || r < 12) continue;
+      const colour = /border-color\s*:\s*([^;}]+)/i.exec(block.body)?.[1] ?? colourIn(border[1]);
+      if (!saturated(colour, ctx.tokens)) continue;
+      hits.push({ line: lineOfOffset(block, border.index), message: `a ${width}px coloured border on a ${r >= 999 ? "fully" : `${r}px`} rounded element: the outline becomes the most visible shape in it` });
+    }
+    for (const { classes, line } of classLists(file, ctx.raw)) {
+      const plain = classes.map(bare);
+      const width = plain.map((c) => /^border-(\d+|\[[^\]]+\])$/.exec(c)).find((x) => x && twBorderWidth(x[1]) >= 2);
+      const colour = plain.find((c) => /^border-/.test(c) && TW_COLOUR.test(c.slice("border-".length)));
+      const round3 = plain.find((c) => /^rounded-(?:xl|2xl|3xl|full|\[(?:1[2-9]|[2-9]\d|\d{3,})px\])$/.test(c));
+      if (width && colour && round3) hits.push({ line, message: `\`${width[0]} ${colour} ${round3}\`: a heavy coloured outline on a large curve` });
+    }
+    return report(ctx, "rounded-accent-border", file, ctx.raw, hits);
+  }
+};
+var BG_IMAGE = /(?<![-\w])background(?:-image)?\s*:\s*([^;}]+)/i;
+function gridLike(value, block, sizeHint) {
+  if (/repeating-(?:linear|radial)-gradient\(/i.test(value)) return true;
+  const linear = (value.match(/linear-gradient\(/gi) ?? []).length;
+  const radial = (value.match(/radial-gradient\(/gi) ?? []).length;
+  const lines = /\b1px\b|transparent\s+1px|\s1px\s*,\s*transparent/i.test(value);
+  const sized = sizeHint || (block ? /background-size\s*:/i.test(block.body) : false);
+  return sized && (linear >= 2 && lines || radial >= 1 && /\b1px\b|\b2px\b/.test(value));
+}
+var decorativeGridBackground = {
+  name: "decorative-grid-background",
+  appliesTo: (file) => isStyleBearing(file),
+  run(source, file, ctx) {
+    const hits = [];
+    for (const block of leafBlocks(source)) {
+      const bg = BG_IMAGE.exec(block.body);
+      if (bg && gridLike(bg[1], block, false)) {
+        hits.push({ line: lineOfOffset(block, bg.index), message: "a background of grid lines, dots or stripes behind content: noise at the contrast that makes text harder to read" });
+      }
+    }
+    for (const { classes, line } of classLists(file, ctx.raw)) {
+      const arb = classes.map(bare).filter((c) => /^bg-\[/.test(c)).map((c) => c.replace(/_/g, " "));
+      const image = arb.find((c) => /gradient\(/.test(c));
+      if (image && gridLike(image, void 0, arb.some((c) => /^bg-\[size:/.test(c)) || /repeating-/.test(image))) {
+        hits.push({ line, message: "a grid, dot or stripe background drawn with utility classes: decoration behind content" });
+      }
+    }
+    return report(ctx, "decorative-grid-background", file, ctx.raw, hits);
+  }
+};
+var SHADOW = /(?<![-\w])(box-shadow|text-shadow)\s*:\s*([^;}]+)/gi;
+var DROP = /drop-shadow\(\s*0(?:px)?\s+0(?:px)?\s+(\d*\.?\d+)px\s+([^)]+\)?)\s*\)/gi;
+var COLOUR_IN = /(?:rgba?|hsla?|oklch|oklab|lab|lch|color)\([^)]*\)|#[0-9a-f]{3,8}\b|var\([^)]*\)|\b[a-z]{3,}\b/i;
+function glowLayers(value, tokens) {
+  return value.split(/,(?![^(]*\))/).some((layer) => {
+    if (/\binset\b/.test(layer)) return false;
+    const colour = COLOUR_IN.exec(layer.replace(/\binset\b/, ""))?.[0];
+    if (!colour) return false;
+    const nums = [...layer.replace(colour, " ").matchAll(/-?\d*\.?\d+/g)].map((n) => parseFloat(n[0]));
+    if (nums.length < 3) return false;
+    const [x, y, blur] = nums;
+    if (x !== 0 || y !== 0 || blur < 8) return false;
+    return saturated(colour, tokens, 40, 0.15);
+  });
+}
+var glowAccent = {
+  name: "glow-accent",
+  appliesTo: (file) => isStyleBearing(file),
+  run(source, file, ctx) {
+    const hits = [];
+    for (const block of leafBlocks(source)) {
+      SHADOW.lastIndex = 0;
+      let m;
+      while (m = SHADOW.exec(block.body)) {
+        if (glowLayers(m[2], ctx.tokens)) hits.push({ line: lineOfOffset(block, m.index), message: `a coloured ${m[1]} glow: contrast added without meaning` });
+      }
+      DROP.lastIndex = 0;
+      while (m = DROP.exec(block.body)) {
+        if (parseFloat(m[1]) >= 8 && saturated(m[2], ctx.tokens, 40)) hits.push({ line: lineOfOffset(block, m.index), message: "a coloured drop-shadow glow: contrast added without meaning" });
+      }
+    }
+    for (const { classes, line } of classLists(file, ctx.raw)) {
+      const plain = classes.map(bare);
+      const arb = plain.find((c) => /^(?:shadow|drop-shadow)-\[/.test(c) && glowLayers(c.replace(/^[\w-]+-\[|\]$/g, "").replace(/_/g, " "), ctx.tokens));
+      const tinted = plain.find((c) => /^shadow-/.test(c) && TW_COLOUR.test(c.slice("shadow-".length)));
+      if (arb) hits.push({ line, message: `\`${arb}\`: a coloured glow` });
+      else if (tinted && plain.some((c) => /^shadow-(?:lg|xl|2xl)$/.test(c))) hits.push({ line, message: `\`${tinted}\`: a large shadow in a saturated colour, which reads as a glow` });
+    }
+    return report(ctx, "glow-accent", file, ctx.raw, hits);
+  }
+};
+var PAGE_SELECTOR = /(?:^|[\s,>])(?:html|body|:root|main)\b|--[\w-]*(?:bg|background|surface|page|canvas)[\w-]*/i;
+var TW_CREAM = /^bg-(?:amber|orange|yellow)-(?:50|100)$|^bg-stone-(?:100|200)$/;
+function cream(value, tokens) {
+  const c = extractColorComponents(value.trim(), tokens);
+  if (!c || c.alpha < 0.9) return false;
+  const { r, g, b } = c.rgb;
+  return Math.min(r, g, b) >= 215 && r >= g && g >= b && r - b >= 6;
+}
+var creamPalette = {
+  name: "cream-palette",
+  appliesTo: (file) => isStyleBearing(file),
+  run(source, file, ctx) {
+    const hits = [];
+    for (const block of leafBlocks(source)) {
+      for (const m of block.body.matchAll(/(?:^|[;{\s])((?:--[\w-]+|background(?:-color)?))\s*:\s*([^;}]+)/g)) {
+        const prop = m[1];
+        const onPage = prop.startsWith("--") ? PAGE_SELECTOR.test(prop) : PAGE_SELECTOR.test(block.selector);
+        if (!onPage || !cream(m[2], ctx.tokens)) continue;
+        hits.push({ line: lineOfOffset(block, m.index), message: `a cream page surface (${m[2].trim()}): the palette a model reaches for when asked to look tasteful` });
+      }
+    }
+    if (isMarkupHost(file)) {
+      for (const m of ctx.raw.matchAll(/<(html|body|main)\b[^>]*\b(?:class|className)\s*=\s*["']([^"']*)["']/gi)) {
+        const hit = m[2].split(/\s+/).map(bare).find((c) => TW_CREAM.test(c) || /^bg-\[#?[\w(),.%\s]+\]$/.test(c) && cream(c.slice(4, -1), ctx.tokens));
+        if (hit) hits.push({ line: lineForOffset(buildLineIndex(ctx.raw), m.index), message: `\`${hit}\` on <${m[1]}>: a cream page surface by default` });
+      }
+    }
+    return report(ctx, "cream-palette", file, ctx.raw, hits);
+  }
+};
+var pulsingDot = {
+  name: "pulsing-dot",
+  appliesTo: (file) => isStyleBearing(file),
+  run(source, file, ctx) {
+    const hits = [];
+    const pulsingClasses = /* @__PURE__ */ new Set();
+    for (const block of leafBlocks(source)) {
+      const anim = /(?<![-\w])animation(?:-name)?\s*:\s*([^;}]+)/i.exec(block.body);
+      if (!anim || !/\b(?:pulse|ping|blink|breathe|beacon|glow)[\w-]*/i.test(anim[1])) continue;
+      if (!/infinite/i.test(anim[1]) && !/animation-iteration-count\s*:\s*infinite/i.test(block.body)) continue;
+      const single = /^\s*\.([\w-]+)\s*$/.exec(block.selector);
+      if (single) pulsingClasses.add(single[1]);
+      if (!/border-radius\s*:\s*(?:50%|9999px|999px|100%)/i.test(block.body)) continue;
+      hits.push({ line: lineOfOffset(block, anim.index), message: "a round element pulsing forever: an alarm on a state that is not changing" });
+    }
+    for (const { classes, line } of classLists(file, ctx.raw)) {
+      const plain = classes.map(bare);
+      const ping = plain.includes("animate-ping");
+      const dot = plain.includes("rounded-full") && plain.some((c) => /^(?:size|w|h)-(?:1|1\.5|2|2\.5|3|3\.5)$/.test(c));
+      const pulsing = plain.includes("animate-pulse") || plain.some((c) => pulsingClasses.has(c));
+      if (ping || pulsing && dot) hits.push({ line, message: `a status dot that ${ping ? "pings" : "pulses"} forever: motion on a state that is not changing` });
+    }
+    return report(ctx, "pulsing-dot", file, ctx.raw, hits);
+  }
+};
+var HEADLINE_SELECTOR = /\bh1\b|\bh2\b|hero|display|headline|title/i;
+var SERIF = /font-family\s*:\s*([^;}]+)/i;
+function serifFamily(value) {
+  const first = value.split(",")[0].trim().toLowerCase();
+  if (/sans|mono|system-ui|ui-sans|inter\b|helvetica|arial/.test(first)) return false;
+  return /serif|georgia|garamond|playfair|fraunces|lora|merriweather|instrument serif|dm serif|cormorant|newsreader|times|baskerville|bodoni|caslon|libre caslon|source serif|pt serif|crimson/.test(value.toLowerCase());
+}
+var italicSerifDisplay = {
+  name: "italic-serif-display",
+  appliesTo: (file) => isStyleBearing(file),
+  run(source, file, ctx) {
+    const hits = [];
+    const serifClasses = /* @__PURE__ */ new Set();
+    for (const block of leafBlocks(source)) {
+      const family = SERIF.exec(block.body);
+      const single = /^\s*\.([\w-]+)\s*$/.exec(block.selector);
+      if (family && single && serifFamily(family[1])) serifClasses.add(single[1]);
+    }
+    for (const block of leafBlocks(source)) {
+      if (!HEADLINE_SELECTOR.test(block.selector) && !/\bh1\b.*\b(?:em|i)\b/.test(block.selector)) continue;
+      const italic = /font-style\s*:\s*italic/i.exec(block.body);
+      const family = SERIF.exec(block.body);
+      if (italic && family && serifFamily(family[1])) {
+        hits.push({ line: lineOfOffset(block, italic.index), message: `${block.selector.trim()} is an italic serif headline: the shortcut to an editorial look` });
+      }
+    }
+    if (isMarkupHost(file)) {
+      const starts = buildLineIndex(ctx.raw);
+      for (const m of ctx.raw.matchAll(/<(h[12])\b([^>]*)>([\s\S]{0,400}?)<\/\1\s*>/gi)) {
+        const own = (/\b(?:class|className)\s*=\s*["']([^"']*)["']/.exec(m[2])?.[1] ?? "").split(/\s+/).map(bare);
+        const serif = own.includes("font-serif") || own.some((c) => serifClasses.has(c) || /^font-\[.*serif/i.test(c) && !/sans/i.test(c));
+        const italicSelf = own.includes("italic");
+        const italicChild = /<(em|i)\b(?![^>]*\bnot-italic\b)/i.test(m[3]) || /\bclass(?:Name)?\s*=\s*["'][^"']*\bitalic\b/.test(m[3]);
+        const childSerif = /\bclass(?:Name)?\s*=\s*["'][^"']*\bfont-serif\b/.test(m[3]);
+        if (serif && (italicSelf || italicChild) || italicChild && childSerif) {
+          hits.push({ line: lineForOffset(starts, m.index), message: `an italic serif <${m[1].toLowerCase()}>: the shortcut to an editorial look` });
+        }
+      }
+    }
+    return report(ctx, "italic-serif-display", file, ctx.raw, hits);
+  }
+};
+var BEFORE_HEADING = /<(p|span|div|small|a)\b([^>]*)>((?:[^<]|<\/?(?:span|svg|path|circle|i|b|strong|em|img)\b[^>]*>){1,400}?)<\/\1\s*>\s*(?:<[^>]*>\s*){0,2}<(h[1-3])\b/gi;
+var LABEL_CLASS = /\b(?:eyebrow|kicker|overline|pretitle|pre-title|tagline|section-label|superscript-label)\b/i;
+function labelKind(attrs) {
+  const cls = /\b(?:class|className)\s*=\s*["']([^"']*)["']/.exec(attrs)?.[1] ?? "";
+  const plain = cls.split(/\s+/).map(bare);
+  const pill = plain.includes("rounded-full") && plain.some((c) => /^(?:border|bg-|ring)/.test(c)) && plain.some((c) => /^(?:px|py|p)-/.test(c));
+  if (pill) return "chip";
+  const caps = plain.includes("uppercase") && plain.some((c) => /^tracking-/.test(c) && !/tracking-(?:tight|tighter|normal)/.test(c));
+  if (caps || LABEL_CLASS.test(cls)) return "kicker";
+  return void 0;
+}
+function labelHits(raw) {
+  const out = [];
+  for (const m of raw.matchAll(BEFORE_HEADING)) {
+    const kind = labelKind(m[2]);
+    const text = m[3].replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim();
+    if (kind && text && text.length <= 60) out.push({ kind, heading: m[4].toLowerCase(), offset: m.index, text });
+  }
+  return out;
+}
+var headingKicker = {
+  name: "heading-kicker",
+  appliesTo: (file) => isReaderText(file) && isMarkupHost(file),
+  run(_source, file, ctx) {
+    const kickers = labelHits(ctx.raw).filter((h) => h.kind === "kicker");
+    if (kickers.length < 2) return [];
+    const starts = buildLineIndex(ctx.raw);
+    return report(ctx, "heading-kicker", file, ctx.raw, kickers.map((k) => ({
+      line: lineForOffset(starts, k.offset),
+      message: `"${k.text}" as a small caps line over an <${k.heading}>, one of ${kickers.length} in this file: a kicker over every heading`
+    })));
+  }
+};
+var eyebrowChip = {
+  name: "eyebrow-chip",
+  appliesTo: (file) => isReaderText(file) && isMarkupHost(file),
+  run(_source, file, ctx) {
+    const starts = buildLineIndex(ctx.raw);
+    return report(ctx, "eyebrow-chip", file, ctx.raw, labelHits(ctx.raw).filter((h) => h.kind === "chip" && h.heading === "h1").map((h) => ({ line: lineForOffset(starts, h.offset), message: `"${h.text}" in a pill over the headline: the shape of a control, pressed and doing nothing` })));
+  }
+};
+var NUMBER_LABEL = /<(span|p|div|small)\b[^>]*>\s*(?:\(|№\s*)?0[1-9](?:\s*[./)]|\s*\/\s*\d{2})?\s*<\/\1\s*>\s*(?:<[^>]*>\s*){0,2}<h[2-4]\b|<h[2-4]\b[^>]*>\s*(?:<[^>]+>\s*)?0[1-9]\s*(?:<\/[^>]+>)?\s*[.·—–/|:]?\s*(?:<[^>]+>)?\s*[A-Za-z]/gi;
+var numberedSectionLabels = {
+  name: "numbered-section-labels",
+  appliesTo: (file) => isReaderText(file) && isMarkupHost(file),
+  run(_source, file, ctx) {
+    const raw = ctx.raw.replace(/<ol\b[\s\S]*?<\/ol\s*>/gi, (m) => m.replace(/[^\n]/g, " "));
+    const found = [...raw.matchAll(NUMBER_LABEL)];
+    if (found.length < 2) return [];
+    const starts = buildLineIndex(ctx.raw);
+    return report(ctx, "numbered-section-labels", file, ctx.raw, found.map((m) => ({
+      line: lineForOffset(starts, m.index),
+      message: `a "0N" label on a section heading, one of ${found.length} here: a number promises an order`
+    })));
+  }
+};
+var generatedLookDetectors = [
+  sideTabBorder,
+  roundedAccentBorder,
+  decorativeGridBackground,
+  glowAccent,
+  creamPalette,
+  pulsingDot,
+  italicSerifDisplay,
+  headingKicker,
+  eyebrowChip,
+  numberedSectionLabels
+];
+
 // src/check/registry.ts
 var DETECTORS = [
   gradientText,
@@ -3656,7 +3991,8 @@ var DETECTORS = [
   emDash,
   semanticElement,
   metadata,
-  interfaceSafety
+  interfaceSafety,
+  ...generatedLookDetectors
 ];
 function getDetector(name) {
   return DETECTORS.find((d) => d.name === name);
@@ -3689,7 +4025,7 @@ function runChecks(projectRoot, files, index, tokens, bucketFilter, projectParti
 }
 
 // src/check/tokens.ts
-import { existsSync as existsSync10, readdirSync as readdirSync8, readFileSync as readFileSync14 } from "fs";
+import { existsSync as existsSync11, readdirSync as readdirSync8, readFileSync as readFileSync14 } from "fs";
 import { join as join19 } from "path";
 function rootDeclarations(source) {
   const out = {};
@@ -3706,7 +4042,7 @@ function rootDeclarations(source) {
 function loadTokenMap(projectRoot, consumerFiles = []) {
   const jig = {};
   const tokensDir = join19(projectRoot, ".jig", "tokens");
-  if (existsSync10(tokensDir)) {
+  if (existsSync11(tokensDir)) {
     for (const file of readdirSync8(tokensDir).filter((f) => f.endsWith(".css")).sort()) {
       Object.assign(jig, rootDeclarations(readFileSync14(join19(tokensDir, file), "utf8")));
     }
@@ -3737,7 +4073,7 @@ function loadTokenMap(projectRoot, consumerFiles = []) {
 }
 
 // src/check/exempt.ts
-import { existsSync as existsSync11, readFileSync as readFileSync15 } from "fs";
+import { existsSync as existsSync12, readFileSync as readFileSync15 } from "fs";
 import { join as join20 } from "path";
 function globToRegExp(glob) {
   let out = "";
@@ -3758,7 +4094,7 @@ function globToRegExp(glob) {
 }
 function readExemptions(projectRoot) {
   const configPath = join20(projectRoot, "jig.config.json");
-  if (!existsSync11(configPath)) return [];
+  if (!existsSync12(configPath)) return [];
   let declared;
   try {
     declared = JSON.parse(readFileSync15(configPath, "utf8")).exempt;
@@ -3874,7 +4210,7 @@ function hasMenuToggle(raw) {
 }
 
 // src/check/mode-wiring.ts
-import { existsSync as existsSync12, readFileSync as readFileSync17 } from "fs";
+import { existsSync as existsSync13, readFileSync as readFileSync17 } from "fs";
 import { dirname as dirname6, join as join22 } from "path";
 var MODES = ["editorial", "product", "operator"];
 function configProblems(config) {
@@ -3898,7 +4234,7 @@ function configProblems(config) {
 function modeWiringProblems(projectRoot) {
   let config;
   const path = join22(projectRoot, "jig.config.json");
-  if (!existsSync12(path)) return [];
+  if (!existsSync13(path)) return [];
   try {
     config = JSON.parse(readFileSync17(path, "utf8"));
   } catch {
@@ -3913,10 +4249,10 @@ function modeWiringProblems(projectRoot) {
   const rel = (f) => dir === "." ? f : `${dir}/${f}`;
   const multi = modes.length > 1;
   const barrelOf = (mode) => multi ? `theme.${mode}.css` : "theme.css";
-  const anyBarrel = ["theme.css", ...modes.map((m) => `theme.${m}.css`)].some((f) => existsSync12(join22(projectRoot, rel(f))));
+  const anyBarrel = ["theme.css", ...modes.map((m) => `theme.${m}.css`)].some((f) => existsSync13(join22(projectRoot, rel(f))));
   if (!anyBarrel) return [];
   const problems = [];
-  if (multi && existsSync12(join22(projectRoot, rel("theme.css")))) {
+  if (multi && existsSync13(join22(projectRoot, rel("theme.css")))) {
     problems.push({
       mode: modes[0],
       barrel: rel("theme.css"),
@@ -3940,7 +4276,7 @@ function modeWiringProblems(projectRoot) {
         barrel,
         message: `jig.config.json declares ${mode}, but ${barrel} imports ${imported ? `mode.${imported}.css` : "no mode file"} \u2014 the page is styled at ${imported ?? "no"} density`
       });
-    } else if (!existsSync12(join22(projectRoot, rel(modeFile)))) {
+    } else if (!existsSync13(join22(projectRoot, rel(modeFile)))) {
       problems.push({ mode, barrel, message: `jig.config.json declares ${mode}, but ${rel(modeFile)} does not exist` });
     }
   });
@@ -3948,7 +4284,7 @@ function modeWiringProblems(projectRoot) {
 }
 
 // src/check/token-audit.ts
-import { existsSync as existsSync13, readdirSync as readdirSync9, readFileSync as readFileSync18 } from "fs";
+import { existsSync as existsSync14, readdirSync as readdirSync9, readFileSync as readFileSync18 } from "fs";
 import { join as join23 } from "path";
 var TEXT_FLOOR = 4.5;
 var UI_FLOOR = 3;
@@ -4011,7 +4347,7 @@ function tokenFiles(projectRoot) {
     }
   };
   const statePath = join23(projectRoot, ".jig", "state.json");
-  if (existsSync13(statePath)) {
+  if (existsSync14(statePath)) {
     try {
       const state = JSON.parse(readFileSync18(statePath, "utf8"));
       const recorded = Object.keys(state.files ?? {}).filter((f) => f.endsWith(".css")).sort();
@@ -4021,7 +4357,7 @@ function tokenFiles(projectRoot) {
     }
   }
   const legacy = join23(projectRoot, ".jig", "tokens");
-  if (!existsSync13(legacy)) return [];
+  if (!existsSync14(legacy)) return [];
   return readdirSync9(legacy).filter((f) => f.endsWith(".css")).sort().map((f) => ({ path: `.jig/tokens/${f}`, source: readFileSync18(join23(legacy, f), "utf8") }));
 }
 function auditTokenLayer(projectRoot) {
@@ -4071,9 +4407,9 @@ function auditTokenLayer(projectRoot) {
     for (const { token, min, why } of NUMERIC_FLOORS) {
       const decl = scope[token];
       if (!decl) continue;
-      const px = /^([\d.]+)px$/.exec(decl.value.trim());
-      if (!px) continue;
-      const value = Number(px[1]);
+      const px2 = /^([\d.]+)px$/.exec(decl.value.trim());
+      if (!px2) continue;
+      const value = Number(px2[1]);
       if (value >= min) continue;
       problems.push({
         token,
@@ -4093,7 +4429,7 @@ function auditTokenLayer(projectRoot) {
 var LEGACY_INDEX_REL = join24(".jig", "rules.index.json");
 function resolveIndexPath(projectRoot) {
   const legacy = join24(projectRoot, LEGACY_INDEX_REL);
-  if (existsSync14(legacy)) return legacy;
+  if (existsSync15(legacy)) return legacy;
   return join24(assetRoot(), "rules.index.json");
 }
 function resolveMode(projectRoot) {
@@ -4203,7 +4539,7 @@ function check(opts) {
       }
     })
   );
-  const report = formatReport(findings, {
+  const report2 = formatReport(findings, {
     totalRules: index.length,
     // From the CLI's own bundle, like `explain` — the spec count describes the
     // system, not whatever a project happens to have vendored. A legacy project
@@ -4221,11 +4557,11 @@ function check(opts) {
     modeUnwired: modeWiringProblems(opts.projectRoot),
     waived
   });
-  return { findings, report, hasError, waived };
+  return { findings, report: report2, hasError, waived };
 }
 
 // src/commands/init.ts
-import { existsSync as existsSync15, mkdirSync as mkdirSync6, readdirSync as readdirSync10, readFileSync as readFileSync23, rmSync as rmSync2, writeFileSync as writeFileSync5 } from "fs";
+import { existsSync as existsSync16, mkdirSync as mkdirSync6, readdirSync as readdirSync10, readFileSync as readFileSync23, rmSync as rmSync2, writeFileSync as writeFileSync5 } from "fs";
 import { dirname as dirname7, isAbsolute, join as join28, resolve as resolve2, sep as sep3 } from "path";
 
 // src/init/detect.ts
@@ -4749,7 +5085,7 @@ function parseSurfaces(answer, fallback) {
   return parsed.length > 0 ? parsed : fallback;
 }
 function fileState(projectRoot, absPath, relPath, initManifest) {
-  const existsOnDisk = existsSync15(absPath);
+  const existsOnDisk = existsSync16(absPath);
   const tracked = !!initManifest && relPath in initManifest.files;
   const modified = tracked && isInitFileModified(projectRoot, relPath, initManifest);
   return { existsOnDisk, tracked, modified };
@@ -4760,11 +5096,11 @@ function isValidSurfaceArray(v) {
   );
 }
 function loadEffectiveConfig(projectRoot, configAbsPath, fallbackBrand, fallbackSurfaces) {
-  if (!existsSync15(configAbsPath)) return { brand: fallbackBrand, surfaces: fallbackSurfaces };
+  if (!existsSync16(configAbsPath)) return { brand: fallbackBrand, surfaces: fallbackSurfaces };
   try {
     const parsed = JSON.parse(readFileSync23(configAbsPath, "utf8"));
     const brandCandidate = typeof parsed.brand === "string" && parsed.brand ? parsed.brand : void 0;
-    const brandResolves = brandCandidate ? existsSync15(join28(projectRoot, ...brandCandidate.split("/"))) : false;
+    const brandResolves = brandCandidate ? existsSync16(join28(projectRoot, ...brandCandidate.split("/"))) : false;
     return {
       brand: brandResolves ? brandCandidate : fallbackBrand,
       surfaces: isValidSurfaceArray(parsed.surfaces) ? parsed.surfaces : fallbackSurfaces
@@ -4774,7 +5110,7 @@ function loadEffectiveConfig(projectRoot, configAbsPath, fallbackBrand, fallback
   }
 }
 function configuredBrandPath(projectRoot, configAbsPath) {
-  if (!existsSync15(configAbsPath)) return { path: null };
+  if (!existsSync16(configAbsPath)) return { path: null };
   let declared;
   try {
     declared = JSON.parse(readFileSync23(configAbsPath, "utf8")).brand;
@@ -4805,7 +5141,7 @@ function defaultTokenDir(detection) {
   return ["jig"];
 }
 function readConfiguredSurfaces(configAbsPath) {
-  if (!existsSync15(configAbsPath)) return null;
+  if (!existsSync16(configAbsPath)) return null;
   try {
     const parsed = JSON.parse(readFileSync23(configAbsPath, "utf8"));
     return isValidSurfaceArray(parsed.surfaces) ? parsed.surfaces : null;
@@ -4818,7 +5154,7 @@ function isCssModule(path) {
 }
 function legacyBrandFile(projectRoot) {
   const dir = join28(projectRoot, ".jig", "tokens");
-  if (!existsSync15(dir)) return void 0;
+  if (!existsSync16(dir)) return void 0;
   const found = readdirSync10(dir).find((f) => /^brand\.[\w.-]+\.css$/.test(f));
   return found ? relKey(".jig", "tokens", found) : void 0;
 }
@@ -4849,7 +5185,7 @@ var LEGACY_PAIR_RE = new RegExp(
   `@import\\s+["'][^"']*brand\\.[\\w.-]+\\.css["'];?\\r?\\n?\\s*@import\\s+["'][^"']*mode\\.(?:${MODES2.join("|")})\\.css["'];?\\r?\\n?`
 );
 function wireBarrel(absPath, barrelImport) {
-  const content = existsSync15(absPath) ? readFileSync23(absPath, "utf8") : "";
+  const content = existsSync16(absPath) ? readFileSync23(absPath, "utf8") : "";
   const line = `@import "${barrelImport}";`;
   if (content.includes(line)) return { status: "already-present" };
   const legacy = LEGACY_PAIR_RE.exec(content);
@@ -4877,10 +5213,10 @@ async function init(opts) {
       "'jig init' asks questions and stdin is not a terminal, so it cannot. Re-run with --yes to accept the derived defaults, or run it in a terminal. A jig.config.json does not replace --yes, because this check runs before it is read. With both, init takes the mode from the config instead of deriving it."
     );
   }
-  const migrateLegacy = async (report, describe) => {
-    if (!report.present) return;
-    for (const line of describe(report)) log(line);
-    const removable = removableLegacyFiles(report);
+  const migrateLegacy = async (report2, describe) => {
+    if (!report2.present) return;
+    for (const line of describe(report2)) log(line);
+    const removable = removableLegacyFiles(report2);
     if (removable.length === 0) return;
     if (opts.yes) {
       log("  Re-run without --yes to be prompted for removal, or delete them yourself.");
@@ -5055,7 +5391,7 @@ ${configRelPath} already exists and was not created by 'jig init' (or has been e
       existing = {};
     }
     const existingBrand = typeof existing.brand === "string" ? existing.brand : void 0;
-    const brandStillResolves = existingBrand ? existsSync15(join28(opts.projectRoot, ...existingBrand.split("/"))) : false;
+    const brandStillResolves = existingBrand ? existsSync16(join28(opts.projectRoot, ...existingBrand.split("/"))) : false;
     const existingSurfaces = Array.isArray(existing.surfaces) && existing.surfaces.length > 0 ? existing.surfaces : void 0;
     const merged = {
       brand: brandStillResolves ? existingBrand : brandRelPath,
@@ -5112,7 +5448,7 @@ ${configRelPath} already exists and was not created by 'jig init' (or has been e
   if (multiMode) {
     const rel = relKey(...tokensRelDir, "theme.css");
     const abs = join28(opts.projectRoot, ...tokensRelDir, "theme.css");
-    if (existsSync15(abs)) {
+    if (existsSync16(abs)) {
       const state = fileState(opts.projectRoot, abs, rel, initManifest);
       if (state.tracked && !state.modified) {
         rmSync2(abs);
@@ -5184,7 +5520,7 @@ ${configRelPath} already exists and was not created by 'jig init' (or has been e
   if (relocateTo && currentBrand) {
     const oldDir = currentBrand.split("/").slice(0, -1);
     const oldAbsDir = join28(opts.projectRoot, ...oldDir);
-    if (existsSync15(oldAbsDir)) {
+    if (existsSync16(oldAbsDir)) {
       for (const name of readdirSync10(oldAbsDir).filter((f) => f.endsWith(".css"))) {
         const rel = relKey(...oldDir, name);
         const abs = join28(oldAbsDir, name);
@@ -5201,14 +5537,14 @@ ${configRelPath} already exists and was not created by 'jig init' (or has been e
   const wireTarget = findWireTarget(detection);
   let wiring;
   if (multiMode) {
-    const bare = join28(opts.projectRoot, ...tokensRelDir, "theme.css");
+    const bare2 = join28(opts.projectRoot, ...tokensRelDir, "theme.css");
     for (const file of detection.cssFiles.filter((f) => !isTokenLayerFile(f))) {
       const abs = join28(opts.projectRoot, file);
       try {
         const before = readFileSync23(abs, "utf8");
         const after = before.split("\n").filter((l) => {
           const m = /^\s*@import\s+["']([^"']+)["'];?\s*$/.exec(l);
-          return !(m && !/^[a-z]+:|^\//i.test(m[1]) && resolve2(dirname7(abs), m[1]) === bare);
+          return !(m && !/^[a-z]+:|^\//i.test(m[1]) && resolve2(dirname7(abs), m[1]) === bare2);
         }).join("\n");
         if (after !== before) {
           writeFileSync5(abs, after, "utf8");
@@ -5237,7 +5573,7 @@ Could not edit ${file}: ${err.message}. Remove its import of ${relKey(...tokensR
       if (relocateTo && currentBrand) {
         const abs = join28(opts.projectRoot, wireTarget);
         const oldDirName = currentBrand.split("/").slice(0, -1).join("/");
-        const before = existsSync15(abs) ? readFileSync23(abs, "utf8") : "";
+        const before = existsSync16(abs) ? readFileSync23(abs, "utf8") : "";
         const after = before.split("\n").filter((l) => !(l.includes("@import") && l.includes(oldDirName))).join("\n");
         if (after !== before) writeFileSync5(abs, after, "utf8");
       }
@@ -5314,8 +5650,8 @@ Could not write to ${wireTarget}: ${err.message}`);
 }
 
 // src/commands/verdicts.ts
-import { existsSync as existsSync20, readFileSync as readFileSync27 } from "fs";
-import { join as join34, resolve as resolve4 } from "path";
+import { existsSync as existsSync23, readFileSync as readFileSync29 } from "fs";
+import { join as join36, resolve as resolve5 } from "path";
 
 // src/rules/citations.ts
 import { join as join29 } from "path";
@@ -5329,13 +5665,13 @@ function citableIds(packageRoot2) {
 }
 
 // src/probe/check.ts
-import { existsSync as existsSync18, readdirSync as readdirSync13, readFileSync as readFileSync25 } from "fs";
-import { join as join32 } from "path";
+import { existsSync as existsSync20, readdirSync as readdirSync13, readFileSync as readFileSync26 } from "fs";
+import { join as join33 } from "path";
 
 // src/probe/save.ts
-import { existsSync as existsSync17, mkdirSync as mkdirSync7, readdirSync as readdirSync12, readFileSync as readFileSync24, writeFileSync as writeFileSync6 } from "fs";
+import { existsSync as existsSync19, mkdirSync as mkdirSync7, readdirSync as readdirSync12, readFileSync as readFileSync25, writeFileSync as writeFileSync6 } from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { join as join31, relative as relative3, resolve as resolve3 } from "path";
+import { join as join32, relative as relative3, resolve as resolve4, sep as sep5 } from "path";
 
 // src/probe/script.ts
 var PROBE_VERSION = 5;
@@ -5348,6 +5684,14 @@ var PROBE_SCRIPT = `(async () => {
   const defaultFont = getComputedStyle(probe).fontFamily;
   probe.remove();
   const text = document.body.innerText || '';
+  // I-118: a verbatim quotation keeps its own punctuation. Text marked as a
+  // quotation is the source's words, so it is taken out before the dash scan;
+  // the page's own copy around it still counts.
+  let ownText = text;
+  for (const q of document.querySelectorAll('blockquote, q')) {
+    const quoted = (q.innerText || '').trim();
+    if (quoted) ownText = ownText.split(quoted).join('\\n');
+  }
   const junk = [...new Set(text.match(/\\$\\{|\\{\\{|\\bundefined\\b|\\bNaN\\b|\\[object Object\\]/g) || [])];
   const unresolved = new Set();
   for (const sheet of document.styleSheets) {
@@ -5458,7 +5802,7 @@ var PROBE_SCRIPT = `(async () => {
     defaultFont: getComputedStyle(document.body).fontFamily === defaultFont,
     unresolvedTokens: [...unresolved],
     junkText: junk,
-    emDashes: [...new Set((text.match(/[^.!?\\n]{0,28}\u2014[^.!?\\n]{0,28}/g) || []).map((t) => t.trim()))].slice(0, 5),
+    emDashes: [...new Set((ownText.match(/[^.!?\\n]{0,28}\u2014[^.!?\\n]{0,28}/g) || []).map((t) => t.trim()))].slice(0, 5),
     brokenImages: [...document.images].filter((i) => i.complete && i.naturalWidth === 0).length,
     navLinksVisible: navAtRest,
     head: {
@@ -5480,7 +5824,7 @@ var PROBE_SCRIPT = `(async () => {
 
 // src/probe/browser.ts
 import { spawn } from "child_process";
-import { existsSync as existsSync16, mkdtempSync, readdirSync as readdirSync11, rmSync as rmSync3 } from "fs";
+import { existsSync as existsSync17, mkdtempSync, readdirSync as readdirSync11, rmSync as rmSync3 } from "fs";
 import { homedir, tmpdir } from "os";
 import { join as join30 } from "path";
 var CHROME_ENV = ["JIG_CHROME", "CHROME_PATH", "PUPPETEER_EXECUTABLE_PATH", "CHROMIUM_PATH"];
@@ -5518,7 +5862,7 @@ function cachedBrowsers() {
         ["chrome-win64", "chrome.exe"]
       ]) {
         const candidate = join30(root, entry, ...rel);
-        if (existsSync16(candidate)) found.push(candidate);
+        if (existsSync17(candidate)) found.push(candidate);
       }
     }
   }
@@ -5527,13 +5871,13 @@ function cachedBrowsers() {
 function findChrome() {
   for (const key of CHROME_ENV) {
     const value = process.env[key];
-    if (value && existsSync16(value)) return value;
+    if (value && existsSync17(value)) return value;
   }
   for (const command of CHROME_COMMANDS) {
     const resolved = which(command);
     if (resolved) return resolved;
   }
-  for (const app of CHROME_APPS) if (existsSync16(app)) return app;
+  for (const app of CHROME_APPS) if (existsSync17(app)) return app;
   return cachedBrowsers()[0];
 }
 function which(command) {
@@ -5541,7 +5885,7 @@ function which(command) {
   for (const dir of dirs) {
     if (!dir) continue;
     const candidate = join30(dir, command);
-    if (existsSync16(candidate)) return candidate;
+    if (existsSync17(candidate)) return candidate;
   }
   return void 0;
 }
@@ -5586,8 +5930,13 @@ async function runProbe(opts) {
     });
     return await evaluate(endpoint, opts.url, opts.width, opts.height ?? 900, timeoutMs);
   } finally {
+    const exited = child.exitCode !== null ? Promise.resolve() : new Promise((done) => child.once("exit", () => done()));
     child.kill();
-    rmSync3(profile, { recursive: true, force: true });
+    await Promise.race([exited, new Promise((done) => setTimeout(done, 5e3))]);
+    try {
+      rmSync3(profile, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
+    } catch {
+    }
   }
 }
 async function evaluate(endpoint, url, width, height, timeoutMs) {
@@ -5646,6 +5995,59 @@ async function evaluate(endpoint, url, width, height, timeoutMs) {
   }
 }
 
+// src/probe/serve.ts
+import { createServer } from "http";
+import { existsSync as existsSync18, readFileSync as readFileSync24, statSync as statSync2 } from "fs";
+import { extname, join as join31, resolve as resolve3, sep as sep4 } from "path";
+var TYPES = {
+  ".html": "text/html; charset=utf-8",
+  ".htm": "text/html; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".js": "text/javascript; charset=utf-8",
+  ".mjs": "text/javascript; charset=utf-8",
+  ".json": "application/json",
+  ".txt": "text/plain; charset=utf-8",
+  ".xml": "application/xml",
+  ".svg": "image/svg+xml",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".avif": "image/avif",
+  ".ico": "image/x-icon",
+  ".woff": "font/woff",
+  ".woff2": "font/woff2",
+  ".ttf": "font/ttf",
+  ".otf": "font/otf"
+};
+async function serveDirectory(dir) {
+  const root = resolve3(dir);
+  const server = createServer((req, res) => {
+    let path = decodeURIComponent((req.url ?? "/").split("?")[0].split("#")[0]);
+    let file = resolve3(join31(root, path));
+    if (file !== root && !file.startsWith(root + sep4)) {
+      res.writeHead(403).end();
+      return;
+    }
+    if (existsSync18(file) && statSync2(file).isDirectory()) file = join31(file, "index.html");
+    else if (!existsSync18(file) && existsSync18(`${file}.html`)) file = `${file}.html`;
+    if (!existsSync18(file)) {
+      res.writeHead(404).end();
+      return;
+    }
+    res.writeHead(200, { "content-type": TYPES[extname(file).toLowerCase()] ?? "application/octet-stream" });
+    res.end(readFileSync24(file));
+  });
+  await new Promise((done) => server.listen(0, "127.0.0.1", done));
+  const address = server.address();
+  const port = typeof address === "object" && address ? address.port : 0;
+  return {
+    origin: `http://127.0.0.1:${port}`,
+    close: () => new Promise((done) => server.close(() => done()))
+  };
+}
+
 // src/probe/save.ts
 function saveProbe(opts) {
   let probe;
@@ -5660,19 +6062,25 @@ function saveProbe(opts) {
   const width = typeof probe.width === "number" ? probe.width : NaN;
   if (!Number.isFinite(width)) throw new Error("The probe output has no width. Evaluate it in a browser, at the width you are judging.");
   const url = typeof probe.url === "string" ? probe.url : "";
-  const page = pageFile(opts.projectRoot, url);
+  const page = opts.page ? projectFile(opts.projectRoot, opts.page) : pageFile(opts.projectRoot, url);
   if (!page) {
-    throw new Error(`The probe ran at ${url || "no url"}, which is not a file in this project. Open the page you built \u2014 a file:// URL under the project \u2014 and probe that.`);
+    throw new Error(`The probe ran at ${url || "no url"}, which is not a file in this project. Open the page you built, as a file:// URL under the project, or let \`jig probe --run <page> --serve <dir>\` serve it.`);
   }
   probe.pageFile = relative3(opts.projectRoot, page).split("\\").join("/");
-  probe.pageChecksum = checksum(readFileSync24(page, "utf8"));
+  if (opts.serveRoot) probe.serveRoot = relative3(opts.projectRoot, resolve4(opts.projectRoot, opts.serveRoot)).split("\\").join("/") || ".";
+  probe.pageChecksum = checksum(readFileSync25(page, "utf8"));
   probe.recordedAt = (/* @__PURE__ */ new Date()).toISOString();
-  const dir = join31(opts.projectRoot, ".jig", "critique", opts.surface);
+  const dir = join32(opts.projectRoot, ".jig", "critique", opts.surface);
   mkdirSync7(dir, { recursive: true });
-  const path = join31(dir, `probe-${width}.json`);
+  const path = join32(dir, `probe-${width}.json`);
   writeFileSync6(path, JSON.stringify(probe), "utf8");
   return { path: `.jig/critique/${opts.surface}/probe-${width}.json`, width, page: probe.pageFile };
 }
+function projectFile(projectRoot, path) {
+  const abs = resolve4(projectRoot, path);
+  if (abs !== resolve4(projectRoot) && !abs.startsWith(resolve4(projectRoot) + sep5)) return void 0;
+  return existsSync19(abs) ? abs : void 0;
+}
 function pageFile(projectRoot, url) {
   if (!url.startsWith("file://")) return void 0;
   let path;
@@ -5681,34 +6089,48 @@ function pageFile(projectRoot, url) {
   } catch {
     return void 0;
   }
-  const abs = resolve3(path);
-  if (!abs.startsWith(resolve3(projectRoot))) return void 0;
-  return existsSync17(abs) ? abs : void 0;
+  const abs = resolve4(path);
+  if (!abs.startsWith(resolve4(projectRoot))) return void 0;
+  return existsSync19(abs) ? abs : void 0;
 }
 var PROBE_WIDTHS = [360, 768, 1280, 1600];
 async function runAndSaveProbes(opts) {
-  const abs = resolve3(opts.projectRoot, opts.page);
-  if (!existsSync17(abs)) throw new Error(`${opts.page} does not exist, so there is nothing to render.`);
-  const url = /^https?:/i.test(opts.page) ? opts.page : `file://${abs}`;
+  const abs = resolve4(opts.projectRoot, opts.page);
+  if (!existsSync19(abs)) throw new Error(`${opts.page} does not exist, so there is nothing to render.`);
   const saved = [];
-  for (const width of opts.widths ?? PROBE_WIDTHS) {
-    const json = await runProbe({ url, width });
-    saved.push(saveProbe({ projectRoot: opts.projectRoot, surface: opts.surface, json }));
-  }
+  await withPageUrl(opts.projectRoot, abs, opts.serve, async (url) => {
+    for (const width of opts.widths ?? PROBE_WIDTHS) {
+      const json = await runProbe({ url, width });
+      saved.push(saveProbe({ projectRoot: opts.projectRoot, surface: opts.surface, json, page: abs, serveRoot: opts.serve }));
+    }
+  });
   return saved;
 }
+async function withPageUrl(projectRoot, abs, serve, use) {
+  if (!serve) return use(`file://${abs}`);
+  const root = resolve4(projectRoot, serve);
+  if (!existsSync19(root)) throw new Error(`${serve} does not exist, so there is nothing to serve.`);
+  if (!abs.startsWith(root + sep5)) throw new Error(`The page is not inside ${serve}, so serving ${serve} cannot show it.`);
+  const server = await serveDirectory(root);
+  try {
+    const path = relative3(root, abs).split(sep5).join("/");
+    await use(`${server.origin}/${path}`);
+  } finally {
+    await server.close();
+  }
+}
 async function ensureProbes(opts) {
-  const dir = join31(opts.projectRoot, ".jig", "critique", opts.surface);
-  const abs = resolve3(opts.projectRoot, opts.page);
+  const dir = join32(opts.projectRoot, ".jig", "critique", opts.surface);
+  const abs = resolve4(opts.projectRoot, opts.page);
   let current;
   try {
-    current = checksum(readFileSync24(abs, "utf8"));
+    current = checksum(readFileSync25(abs, "utf8"));
   } catch {
     return { recorded: [], reason: `${opts.page} could not be read` };
   }
   const missing = PROBE_WIDTHS.filter((width) => {
     try {
-      const probe = JSON.parse(readFileSync24(join31(dir, `probe-${width}.json`), "utf8"));
+      const probe = JSON.parse(readFileSync25(join32(dir, `probe-${width}.json`), "utf8"));
       return probe.jigProbe !== PROBE_VERSION || probe.pageChecksum !== current;
     } catch {
       return true;
@@ -5716,16 +6138,28 @@ async function ensureProbes(opts) {
   });
   if (missing.length === 0) return { recorded: [] };
   if (!findChrome()) return { recorded: [], reason: "no browser on this machine" };
-  const url = /^https?:/i.test(opts.page) ? opts.page : `file://${abs}`;
-  for (const width of missing) {
-    saveProbe({ projectRoot: opts.projectRoot, surface: opts.surface, json: await runProbe({ url, width }) });
+  let serve;
+  for (const width of PROBE_WIDTHS) {
+    try {
+      const probe = JSON.parse(readFileSync25(join32(dir, `probe-${width}.json`), "utf8"));
+      if (probe.serveRoot) {
+        serve = probe.serveRoot;
+        break;
+      }
+    } catch {
+    }
   }
+  await withPageUrl(opts.projectRoot, abs, serve, async (url) => {
+    for (const width of missing) {
+      saveProbe({ projectRoot: opts.projectRoot, surface: opts.surface, json: await runProbe({ url, width }), page: abs, serveRoot: serve });
+    }
+  });
   return { recorded: missing };
 }
 function critiquedSurfaces(projectRoot) {
-  const root = join31(projectRoot, ".jig", "critique");
-  if (!existsSync17(root)) return [];
-  return readdirSync12(root).filter((surface) => existsSync17(join31(root, surface, "screen.json")) || existsSync17(join31(root, surface, "code.json")));
+  const root = join32(projectRoot, ".jig", "critique");
+  if (!existsSync19(root)) return [];
+  return readdirSync12(root).filter((surface) => existsSync19(join32(root, surface, "screen.json")) || existsSync19(join32(root, surface, "code.json")));
 }
 
 // src/probe/check.ts
@@ -5733,11 +6167,11 @@ function stampProblem(projectRoot, file, p) {
   if (!p.pageChecksum || !p.pageFile) {
     return `${file} was not written by \`jig probe --save\`, so nothing measured it. Evaluate \`jig probe\` in the browser and pipe its output into \`jig probe --save <surface>\`.`;
   }
-  const page = pageFile(projectRoot, p.url ?? "");
-  if (!page) return `${file} names a page outside this project (${p.url ?? "no url"}).`;
+  const page = p.serveRoot ? projectFile(projectRoot, p.pageFile) : pageFile(projectRoot, p.url ?? "");
+  if (!page) return `${file} names a page outside this project (${p.serveRoot ? p.pageFile : p.url ?? "no url"}).`;
   let current;
   try {
-    current = readFileSync25(page, "utf8");
+    current = readFileSync26(page, "utf8");
   } catch {
     return `${file} was taken on ${p.pageFile}, which no longer exists.`;
   }
@@ -5747,11 +6181,11 @@ function stampProblem(projectRoot, file, p) {
   return void 0;
 }
 function readProbes(projectRoot, dir, errors) {
-  if (!existsSync18(dir)) return [];
+  if (!existsSync20(dir)) return [];
   const probes = [];
   for (const f of readdirSync13(dir).filter((n) => /^probe-\d+\.json$/.test(n)).sort()) {
     try {
-      const p = JSON.parse(readFileSync25(join32(dir, f), "utf8"));
+      const p = JSON.parse(readFileSync26(join33(dir, f), "utf8"));
       if (p.jigProbe !== PROBE_VERSION || typeof p.width !== "number") {
         errors.push(`${f} is not output of \`jig probe\` (version ${PROBE_VERSION}). Re-run the probe; do not write it by hand.`);
         continue;
@@ -5843,19 +6277,19 @@ function probeContradictions(probes, verdictOf, indexable = true) {
 }
 
 // src/check/decisions.ts
-import { existsSync as existsSync19, readFileSync as readFileSync26 } from "fs";
-import { join as join33, posix as posix3 } from "path";
+import { existsSync as existsSync21, readFileSync as readFileSync27 } from "fs";
+import { join as join34, posix as posix3 } from "path";
 var HEADING3 = /^(#{2,3})\s+(.+?)\s*$/gm;
 var NOT_A_DECISION = /^(unresolved|open questions?|undecided|contents?|index)$/i;
 function decisionsFile(projectRoot) {
   const candidates = ["jig/DECISIONS.md", "DECISIONS.md", "src/jig/DECISIONS.md", "src/styles/jig/DECISIONS.md", ".jig/DECISIONS.md"];
   try {
-    const brand = JSON.parse(readFileSync26(join33(projectRoot, "jig.config.json"), "utf8")).brand;
+    const brand = JSON.parse(readFileSync27(join34(projectRoot, "jig.config.json"), "utf8")).brand;
     if (typeof brand === "string" && brand.includes("/")) candidates.unshift(`${posix3.dirname(brand.replace(/^\.\//, ""))}/DECISIONS.md`);
   } catch {
   }
   for (const candidate of candidates) {
-    if (existsSync19(join33(projectRoot, candidate))) return candidate;
+    if (existsSync21(join34(projectRoot, candidate))) return candidate;
   }
   return void 0;
 }
@@ -5864,7 +6298,7 @@ function decisionNames(projectRoot) {
   if (!path) return [];
   let body;
   try {
-    body = readFileSync26(join33(projectRoot, path), "utf8");
+    body = readFileSync27(join34(projectRoot, path), "utf8");
   } catch {
     return [];
   }
@@ -5877,35 +6311,120 @@ function decisionNames(projectRoot) {
   return names;
 }
 
+// src/check/spec-shape.ts
+import { existsSync as existsSync22, readFileSync as readFileSync28, readdirSync as readdirSync14, statSync as statSync3 } from "fs";
+import { join as join35 } from "path";
+function newestSpec(projectRoot) {
+  const dir = join35(projectRoot, ".jig", "specs");
+  if (!existsSync22(dir)) return void 0;
+  const files = readdirSync14(dir).filter((f) => f.endsWith(".md"));
+  if (files.length === 0) return void 0;
+  const newest = files.map((f) => ({ f, at: statSync3(join35(dir, f)).mtimeMs })).sort((a, b) => b.at - a.at)[0].f;
+  return { path: `.jig/specs/${newest}`, slug: newest.replace(/\.spec\.md$|\.md$/, ""), body: readFileSync28(join35(dir, newest), "utf8") };
+}
+function specProblems(spec) {
+  const parts = spec.body.split(/^---\s*$/m);
+  const front = parts.length >= 3 ? parts[1] : "";
+  if (!front.trim()) {
+    return [`${spec.path} has no frontmatter. A spec is the frontmatter \u2014 feature, surface, mode, sizes (phone, tablet, desktop), states, decisions, later, mockup, confirmed \u2014 with the reasoning below it. Rewrite it in that shape.`];
+  }
+  const problems = [];
+  const has = (field) => new RegExp(`^\\s*${field}\\s*:`, "im").test(front);
+  if (specIndexableField(front) === "unreadable") {
+    problems.push(`${spec.path}: \`indexable:\` is neither true nor false. Write \`indexable: true\` or \`indexable: false\`; a per-page override and its reason go in the body, where they can be read without being parsed.`);
+  }
+  for (const field of ["feature", "surface", "mode", "sizes", "confirmed", "mockup"]) {
+    if (!has(field)) problems.push(`${spec.path} frontmatter has no \`${field}:\`.`);
+  }
+  const sizes = front.split(/^sizes\s*:/im)[1] ?? "";
+  for (const size of ["phone", "tablet", "desktop", "wide"]) {
+    const line = new RegExp(`^\\s+${size}\\s*:(.*)$`, "im").exec(sizes);
+    if (!line) {
+      problems.push(`${spec.path} has no \`${size}:\` composition under \`sizes:\`. Every size is written in full, phone first; \`same-as:\` needs a \`why:\`.`);
+      continue;
+    }
+    if (line[1].trim()) {
+      problems.push(`${spec.path}: \`${size}:\` is a one-line description. A size is a composition \u2014 \`regions:\` in order, \`hierarchy:\`, \`nav:\` \u2014 each on its own line, or \`same-as:\` with a \`why:\`.`);
+      continue;
+    }
+    const block = sizeBlock(sizes, size);
+    if (/^\s*same-as\s*:/im.test(block)) {
+      if (!/^\s*why\s*:/im.test(block)) problems.push(`${spec.path}: \`${size}\` claims \`same-as:\` with no \`why:\`. The claim is checked on a render, so it says why it holds.`);
+      continue;
+    }
+    for (const field of ["regions", "nav"]) {
+      if (!new RegExp(`^\\s*${field}\\s*:`, "im").test(block)) {
+        problems.push(`${spec.path}: \`${size}\` has no \`${field}:\`. Every size names its regions in order and what its navigation is at that width (\`nav: none\` when the screen has none).`);
+      }
+    }
+  }
+  return problems;
+}
+function sizeBlock(sizes, size) {
+  const start = new RegExp(`^\\s+${size}\\s*:.*$`, "im").exec(sizes);
+  if (!start) return "";
+  const rest = sizes.slice(start.index + start[0].length);
+  const indent = /^\s*/.exec(start[0])[0].length;
+  const lines = [];
+  for (const line of rest.split("\n")) {
+    if (line.trim() && /^\s*/.exec(line)[0].length <= indent) break;
+    lines.push(line);
+  }
+  return lines.join("\n");
+}
+var MENU_RE = /(?<!\b(?:no|not|without|never)\s)(?<!\bno\s\w{1,12}\s)\b(menu|hamburger|drawer|burger)\b/i;
+var NONE_RE = /^\s*(none|no navigation|n\/a|-)\b/i;
+function navProblems(spec) {
+  const front = spec.body.split(/^---\s*$/m)[1] ?? "";
+  const sizes = front.split(/^sizes\s*:/im)[1] ?? "";
+  const problems = [];
+  for (const size of ["tablet", "landscape", "desktop", "wide"]) {
+    const block = sizeBlock(sizes, size);
+    const nav = /^\s*nav\s*:\s*(.+)$/im.exec(block)?.[1]?.trim();
+    if (!nav || NONE_RE.test(nav)) continue;
+    if (MENU_RE.test(nav) && !/\bopen\b|\bexpanded\b/i.test(nav)) {
+      problems.push(`${spec.path}: \`${size}\` has \`nav: ${nav}\`. Run P-14's table at that width \u2014 where every destination fits, the links show and there is no menu button. A decision about where the button sits is about position, not whether it exists.`);
+    }
+  }
+  return problems;
+}
+function specIndexableField(front) {
+  const line = /^\s*indexable\s*:(.*)$/im.exec(front);
+  if (!line) return "absent";
+  const value = line[1].trim().replace(/^["']|["']$/g, "").toLowerCase();
+  if (value === "true" || value === "yes") return true;
+  if (value === "false" || value === "no") return false;
+  return "unreadable";
+}
+
 // src/commands/verdicts.ts
 var VERDICTS = ["ok", "finding", "n/a"];
 var ABSENCE = /\b(rule (not found|does not exist)|context unavailable|cannot (find|read|access) (the )?rule|not in (the )?(accessible )?corpus)\b/i;
 function readJson(path, errors) {
-  if (!existsSync20(path)) return null;
+  if (!existsSync23(path)) return null;
   try {
-    return JSON.parse(readFileSync27(path, "utf8"));
+    return JSON.parse(readFileSync29(path, "utf8"));
   } catch (e) {
     errors.push(`${path}: not valid JSON (${e.message})`);
     return {};
   }
 }
 function specIndexable(projectRoot, surface) {
-  const path = join34(projectRoot, ".jig", "specs", `${surface}.spec.md`);
+  const path = join36(projectRoot, ".jig", "specs", `${surface}.spec.md`);
   let front = "";
   try {
-    front = readFileSync27(path, "utf8").split(/^---\s*$/m)[1] ?? "";
+    front = readFileSync29(path, "utf8").split(/^---\s*$/m)[1] ?? "";
   } catch {
   }
-  const declared = /^\s*indexable\s*:\s*(\w+)/im.exec(front)?.[1]?.toLowerCase();
-  if (declared === "true" || declared === "yes") return true;
-  if (declared === "false" || declared === "no") return false;
+  const declared = specIndexableField(front);
+  if (declared === true || declared === false) return declared;
   const mode = /^\s*mode\s*:\s*(\w+)/im.exec(front)?.[1]?.toLowerCase();
   return mode !== "product" && mode !== "operator";
 }
 function specNeedsNav(projectRoot, surface) {
-  const path = join34(projectRoot, ".jig", "specs", `${surface}.spec.md`);
-  if (!existsSync20(path)) return false;
-  const front = readFileSync27(path, "utf8").split(/^---\s*$/m)[1] ?? "";
+  const path = join36(projectRoot, ".jig", "specs", `${surface}.spec.md`);
+  if (!existsSync23(path)) return false;
+  const front = readFileSync29(path, "utf8").split(/^---\s*$/m)[1] ?? "";
   const navField = [...front.matchAll(/^\s*nav:\s*(.+)$/gim)].some((m) => !/^\s*(none|n\/a|-)\b/i.test(m[1]));
   const navRegion = /^\s*-\s*(nav|navigation)\s*:/im.test(front);
   return navField || navRegion;
@@ -5956,7 +6475,7 @@ function checkArm(name, file, required, otherPass, extraAllowed, extraRequired,
 function checkDecisions(projectRoot, dir, errors) {
   const required = decisionNames(projectRoot);
   if (required.length === 0) return { state: "ran", judged: 0, total: 0, findings: 0 };
-  const file = readJson(join34(dir, "decisions.json"), errors);
+  const file = readJson(join36(dir, "decisions.json"), errors);
   if (!file) {
     errors.push(
       `decisions.json is missing. Every decision in DECISIONS.md is judged against the built page, one verdict each: ${required.slice(0, 4).join(", ")}${required.length > 4 ? `, and ${required.length - 4} more` : ""}. A page can satisfy every rule and still break what this project decided.`
@@ -6001,7 +6520,7 @@ function checkDecisions(projectRoot, dir, errors) {
 function verifyVerdicts(opts) {
   const root = opts.packageRoot ?? assetRoot();
   const errors = [];
-  const index = JSON.parse(readFileSync27(join34(root, "rules.index.json"), "utf8"));
+  const index = JSON.parse(readFileSync29(join36(root, "rules.index.json"), "utf8"));
   const judgment = index.filter((r) => r.bucket === "judgment");
   const screenIds = judgment.filter((r) => r.pass === "screen").map((r) => r.id);
   const codeIds = judgment.filter((r) => r.pass === "code").map((r) => r.id);
@@ -6010,16 +6529,16 @@ function verifyVerdicts(opts) {
     ...judgment.map((r) => [r.id, r.pass ?? ""])
   ]);
   const specIds = new Set(citableIds(root).filter((id) => /^[PMLRT]-\d+$/.test(id)));
-  const dir = join34(opts.projectRoot, ".jig", "critique", opts.surface);
-  const screenFile = readJson(join34(dir, "screen.json"), errors);
-  const codeFile = readJson(join34(dir, "code.json"), errors);
+  const dir = join36(opts.projectRoot, ".jig", "critique", opts.surface);
+  const screenFile = readJson(join36(dir, "screen.json"), errors);
+  const codeFile = readJson(join36(dir, "code.json"), errors);
   const screenExtraRequired = specNeedsNav(opts.projectRoot, opts.surface) ? ["P-14"] : [];
   const screen = checkArm("screen", screenFile, screenIds, passOf, specIds, screenExtraRequired, errors);
   const code = checkArm("code", codeFile, codeIds, passOf, specIds, [], errors);
   let rendered = false;
   if (screenFile && screenFile.rendered === true) {
     const artefacts = Array.isArray(screenFile.artefacts) ? screenFile.artefacts.filter((a) => typeof a === "string") : [];
-    const absent = artefacts.filter((a) => !existsSync20(resolve4(opts.projectRoot, a)));
+    const absent = artefacts.filter((a) => !existsSync23(resolve5(opts.projectRoot, a)));
     if (artefacts.length === 0) errors.push("screen.json says rendered: true but lists no artefacts. A render leaves a screenshot.");
     else if (absent.length) errors.push(`screen.json says rendered: true, but these artefacts do not exist: ${absent.join(", ")}.`);
     else rendered = true;
@@ -6038,7 +6557,16 @@ function verifyVerdicts(opts) {
     const v = screenVerdicts.find((x) => typeof x.id === "string" && x.id.trim().toUpperCase() === id);
     return typeof v?.verdict === "string" ? v.verdict : void 0;
   };
-  errors.push(...probeContradictions(probes, verdictOf, specIndexable(opts.projectRoot, opts.surface)));
+  let specFront = "";
+  try {
+    specFront = readFileSync29(join36(opts.projectRoot, ".jig", "specs", `${opts.surface}.spec.md`), "utf8").split(/^---\s*$/m)[1] ?? "";
+  } catch {
+  }
+  if (specIndexableField(specFront) === "unreadable") {
+    errors.push(`.jig/specs/${opts.surface}.spec.md: \`indexable:\` is neither true nor false, so this review cannot tell whether the page is meant to be found and does not guess. Write \`indexable: true\` or \`indexable: false\`, and put the reason in the spec's body.`);
+  } else {
+    errors.push(...probeContradictions(probes, verdictOf, specIndexable(opts.projectRoot, opts.surface)));
+  }
   if (screen.state === "ran" && !rendered) screen.state = "skipped";
   const decisions = checkDecisions(opts.projectRoot, dir, errors);
   const field = (a) => a.state === "ran" ? `ran:${a.judged}` : `${a.state}:${a.judged}${a.state === "incomplete" ? `/${a.total}` : ""}`;
@@ -6047,92 +6575,15 @@ function verifyVerdicts(opts) {
 }
 
 // src/commands/gate.ts
-import { existsSync as existsSync22, mkdirSync as mkdirSync8, readdirSync as readdirSync15, readFileSync as readFileSync29, writeFileSync as writeFileSync7 } from "fs";
+import { existsSync as existsSync24, mkdirSync as mkdirSync8, readdirSync as readdirSync15, readFileSync as readFileSync30, writeFileSync as writeFileSync7 } from "fs";
 import { createHash as createHash2 } from "crypto";
-import { join as join36 } from "path";
-
-// src/check/spec-shape.ts
-import { existsSync as existsSync21, readFileSync as readFileSync28, readdirSync as readdirSync14, statSync as statSync2 } from "fs";
-import { join as join35 } from "path";
-function newestSpec(projectRoot) {
-  const dir = join35(projectRoot, ".jig", "specs");
-  if (!existsSync21(dir)) return void 0;
-  const files = readdirSync14(dir).filter((f) => f.endsWith(".md"));
-  if (files.length === 0) return void 0;
-  const newest = files.map((f) => ({ f, at: statSync2(join35(dir, f)).mtimeMs })).sort((a, b) => b.at - a.at)[0].f;
-  return { path: `.jig/specs/${newest}`, slug: newest.replace(/\.spec\.md$|\.md$/, ""), body: readFileSync28(join35(dir, newest), "utf8") };
-}
-function specProblems(spec) {
-  const parts = spec.body.split(/^---\s*$/m);
-  const front = parts.length >= 3 ? parts[1] : "";
-  if (!front.trim()) {
-    return [`${spec.path} has no frontmatter. A spec is the frontmatter \u2014 feature, surface, mode, sizes (phone, tablet, desktop), states, decisions, later, mockup, confirmed \u2014 with the reasoning below it. Rewrite it in that shape.`];
-  }
-  const problems = [];
-  const has = (field) => new RegExp(`^\\s*${field}\\s*:`, "im").test(front);
-  for (const field of ["feature", "surface", "mode", "sizes", "confirmed", "mockup"]) {
-    if (!has(field)) problems.push(`${spec.path} frontmatter has no \`${field}:\`.`);
-  }
-  const sizes = front.split(/^sizes\s*:/im)[1] ?? "";
-  for (const size of ["phone", "tablet", "desktop", "wide"]) {
-    const line = new RegExp(`^\\s+${size}\\s*:(.*)$`, "im").exec(sizes);
-    if (!line) {
-      problems.push(`${spec.path} has no \`${size}:\` composition under \`sizes:\`. Every size is written in full, phone first; \`same-as:\` needs a \`why:\`.`);
-      continue;
-    }
-    if (line[1].trim()) {
-      problems.push(`${spec.path}: \`${size}:\` is a one-line description. A size is a composition \u2014 \`regions:\` in order, \`hierarchy:\`, \`nav:\` \u2014 each on its own line, or \`same-as:\` with a \`why:\`.`);
-      continue;
-    }
-    const block = sizeBlock(sizes, size);
-    if (/^\s*same-as\s*:/im.test(block)) {
-      if (!/^\s*why\s*:/im.test(block)) problems.push(`${spec.path}: \`${size}\` claims \`same-as:\` with no \`why:\`. The claim is checked on a render, so it says why it holds.`);
-      continue;
-    }
-    for (const field of ["regions", "nav"]) {
-      if (!new RegExp(`^\\s*${field}\\s*:`, "im").test(block)) {
-        problems.push(`${spec.path}: \`${size}\` has no \`${field}:\`. Every size names its regions in order and what its navigation is at that width (\`nav: none\` when the screen has none).`);
-      }
-    }
-  }
-  return problems;
-}
-function sizeBlock(sizes, size) {
-  const start = new RegExp(`^\\s+${size}\\s*:.*$`, "im").exec(sizes);
-  if (!start) return "";
-  const rest = sizes.slice(start.index + start[0].length);
-  const indent = /^\s*/.exec(start[0])[0].length;
-  const lines = [];
-  for (const line of rest.split("\n")) {
-    if (line.trim() && /^\s*/.exec(line)[0].length <= indent) break;
-    lines.push(line);
-  }
-  return lines.join("\n");
-}
-var MENU_RE = /(?<!\b(?:no|not|without|never)\s)(?<!\bno\s\w{1,12}\s)\b(menu|hamburger|drawer|burger)\b/i;
-var NONE_RE = /^\s*(none|no navigation|n\/a|-)\b/i;
-function navProblems(spec) {
-  const front = spec.body.split(/^---\s*$/m)[1] ?? "";
-  const sizes = front.split(/^sizes\s*:/im)[1] ?? "";
-  const problems = [];
-  for (const size of ["tablet", "landscape", "desktop", "wide"]) {
-    const block = sizeBlock(sizes, size);
-    const nav = /^\s*nav\s*:\s*(.+)$/im.exec(block)?.[1]?.trim();
-    if (!nav || NONE_RE.test(nav)) continue;
-    if (MENU_RE.test(nav) && !/\bopen\b|\bexpanded\b/i.test(nav)) {
-      problems.push(`${spec.path}: \`${size}\` has \`nav: ${nav}\`. Run P-14's table at that width \u2014 where every destination fits, the links show and there is no menu button. A decision about where the button sits is about position, not whether it exists.`);
-    }
-  }
-  return problems;
-}
-
-// src/commands/gate.ts
+import { join as join37 } from "path";
 var MAX_BLOCKS = 3;
 function lastJigCommand(transcriptPath) {
-  if (!transcriptPath || !existsSync22(transcriptPath)) return void 0;
+  if (!transcriptPath || !existsSync24(transcriptPath)) return void 0;
   let text;
   try {
-    text = readFileSync29(transcriptPath, "utf8");
+    text = readFileSync30(transcriptPath, "utf8");
   } catch {
     return void 0;
   }
@@ -6147,10 +6598,10 @@ function lastJigCommand(transcriptPath) {
   return found;
 }
 function lastAssistantText(transcriptPath) {
-  if (!transcriptPath || !existsSync22(transcriptPath)) return void 0;
+  if (!transcriptPath || !existsSync24(transcriptPath)) return void 0;
   let found;
   try {
-    for (const line of readFileSync29(transcriptPath, "utf8").split("\n")) {
+    for (const line of readFileSync30(transcriptPath, "utf8").split("\n")) {
       if (!line.includes('"assistant"')) continue;
       let entry;
       try {
@@ -6180,7 +6631,7 @@ function commandProblems(root, command) {
     const found = decisionsFile(root);
     if (!found) problems.push("decide wrote no DECISIONS.md beside the token layer.");
     else {
-      const body = readFileSync29(join36(root, found), "utf8");
+      const body = readFileSync30(join37(root, found), "utf8");
       if (!/^##\s+Unresolved\s*$/im.test(body)) {
         problems.push("DECISIONS.md has no `## Unresolved` section. Round 3 asks by name what is still undecided; write what the owner named, or `None named by the owner.`");
       }
@@ -6201,13 +6652,13 @@ function commandProblems(root, command) {
     const at = /^\s*mockup_at\s*:\s*(.+)$/im.exec(front)?.[1]?.trim().replace(/^["']|["']$/g, "") ?? "";
     if (/^approved/i.test(mockup)) {
       if (!at) problems.push(`${spec.path}: \`mockup_at:\` is empty. Record where the approved drawing is.`);
-      else if (!/^https?:/i.test(at) && !existsSync22(join36(root, at))) problems.push(`${spec.path}: \`mockup_at: ${at}\` does not exist.`);
+      else if (!/^https?:/i.test(at) && !existsSync24(join37(root, at))) problems.push(`${spec.path}: \`mockup_at: ${at}\` does not exist.`);
       else if (!/^https?:/i.test(at) && !at.startsWith(".jig/mockups/")) problems.push(`The drawing is at ${at}. A mockup lives in .jig/mockups/, outside what check scans and outside what ships.`);
     }
   }
   if (command === "critique") {
-    const dir = join36(root, ".jig", "critique");
-    const surfaces = existsSync22(dir) ? readdirSync15(dir).filter((s) => existsSync22(join36(dir, s, "screen.json")) || existsSync22(join36(dir, s, "code.json"))) : [];
+    const dir = join37(root, ".jig", "critique");
+    const surfaces = existsSync24(dir) ? readdirSync15(dir).filter((s) => existsSync24(join37(dir, s, "screen.json")) || existsSync24(join37(dir, s, "code.json"))) : [];
     for (const surface of surfaces) {
       const v = verifyVerdicts({ projectRoot: root, surface });
       if (v.ok && v.decisions.state !== "ran" && v.decisions.total > 0) {
@@ -6229,13 +6680,13 @@ function surfacePage(projectRoot, surface) {
   const declared = /^\s*surface\s*:\s*(.+)$/im.exec(front)?.[1]?.trim().replace(/^["']|["']$/g, "");
   const candidates = [declared, `${surface}.html`, declared ? `${declared.replace(/^\//, "")}.html` : void 0].filter((c) => !!c && /\.\w+$/.test(c) === (c === declared ? /\.\w+$/.test(c) : true));
   for (const candidate of candidates) {
-    if (candidate && existsSync22(join36(projectRoot, candidate))) return candidate;
+    if (candidate && existsSync24(join37(projectRoot, candidate))) return candidate;
   }
   return void 0;
 }
 function gate(opts) {
   const root = opts.projectRoot;
-  if (!existsSync22(join36(root, "jig.config.json")) && !existsSync22(join36(root, ".jig"))) {
+  if (!existsSync24(join37(root, "jig.config.json")) && !existsSync24(join37(root, ".jig"))) {
     return { block: false, reason: "" };
   }
   const command = lastJigCommand(opts.input.transcript_path);
@@ -6261,11 +6712,12 @@ function gate(opts) {
       );
     }
   }
-  const critiqueDir = join36(root, ".jig", "critique");
-  if (existsSync22(critiqueDir)) {
+  problems.push(...verdictGuard(root, command));
+  const critiqueDir = join37(root, ".jig", "critique");
+  if (existsSync24(critiqueDir)) {
     for (const surface of readdirSync15(critiqueDir)) {
-      const dir = join36(critiqueDir, surface);
-      if (!existsSync22(join36(dir, "screen.json")) && !existsSync22(join36(dir, "code.json"))) continue;
+      const dir = join37(critiqueDir, surface);
+      if (!existsSync24(join37(dir, "screen.json")) && !existsSync24(join37(dir, "code.json"))) continue;
       const v = verifyVerdicts({ projectRoot: root, surface });
       if (!v.ok) {
         const shown = v.errors.slice(0, 6).map((e) => `  ${e}`);
@@ -6279,10 +6731,10 @@ function gate(opts) {
   }
   const session = opts.input.session_id ?? "unknown";
   const key = `${session}:${createHash2("sha256").update(problems.join("\n")).digest("hex").slice(0, 12)}`;
-  const stateFile = join36(root, ".jig", "gate.json");
+  const stateFile = join37(root, ".jig", "gate.json");
   let state = {};
   try {
-    state = JSON.parse(readFileSync29(stateFile, "utf8"));
+    state = JSON.parse(readFileSync30(stateFile, "utf8"));
   } catch {
   }
   if (problems.length === 0) {
@@ -6310,17 +6762,60 @@ ${problems.join("\n\n")}`
 ${problems.join("\n\n")}`
   };
 }
+var VERDICT_FILES = ["screen.json", "code.json", "decisions.json"];
+var LOCK = "verdicts.lock";
+function verdictChecksum(dir) {
+  const parts = VERDICT_FILES.map((f) => {
+    try {
+      return `${f}
+${readFileSync30(join37(dir, f), "utf8")}`;
+    } catch {
+      return "";
+    }
+  });
+  return parts.some(Boolean) ? checksum(parts.join("\n")) : void 0;
+}
+function verdictGuard(root, command) {
+  const critiqueDir = join37(root, ".jig", "critique");
+  if (!existsSync24(critiqueDir)) return [];
+  const problems = [];
+  for (const surface of readdirSync15(critiqueDir)) {
+    const dir = join37(critiqueDir, surface);
+    const now = verdictChecksum(dir);
+    if (!now) continue;
+    const lockPath = join37(dir, LOCK);
+    if (command === "critique") {
+      try {
+        writeFileSync7(lockPath, JSON.stringify({ checksum: now }) + "\n", "utf8");
+      } catch {
+      }
+      continue;
+    }
+    let locked;
+    try {
+      locked = JSON.parse(readFileSync30(lockPath, "utf8")).checksum;
+    } catch {
+      continue;
+    }
+    if (locked && locked !== now) {
+      problems.push(
+        `.jig/critique/${surface}: the verdict files changed after \`/jig critique\` wrote them${command ? `, in a session that ran \`/jig ${command}\`` : ""}. Verdicts are the review's, not the builder's: restore them (\`git checkout -- .jig/critique/${surface}\`) and run \`/jig critique\` to judge the fix.`
+      );
+    }
+  }
+  return problems;
+}
 function save(file, state) {
   try {
-    mkdirSync8(join36(file, ".."), { recursive: true });
+    mkdirSync8(join37(file, ".."), { recursive: true });
     writeFileSync7(file, JSON.stringify(state), "utf8");
   } catch {
   }
 }
 
 // src/commands/seo.ts
-import { readFileSync as readFileSync30 } from "fs";
-import { join as join37 } from "path";
+import { readFileSync as readFileSync31 } from "fs";
+import { join as join38 } from "path";
 var SITEMAP_FILE = /(^|\/)sitemap(-index)?\.(xml|ts|js|mjs|tsx|jsx|rb|php|py)$/i;
 var ROBOTS_FILE = /(^|\/)robots\.(txt|ts|js|mjs|tsx|jsx)$/i;
 var ROUTE_IN_SITEMAP = /(?:<loc>\s*([^<\s]+)\s*<\/loc>)|(?:url\s*:\s*["'`]([^"'`]+)["'`])/gi;
@@ -6361,7 +6856,7 @@ function seo(opts) {
   for (const file of files) {
     let raw;
     try {
-      raw = readFileSync30(join37(root, file), "utf8");
+      raw = readFileSync31(join38(root, file), "utf8");
     } catch {
       continue;
     }
@@ -6417,7 +6912,7 @@ function seo(opts) {
 
 // src/index.ts
 var packageRoot = getPackageRoot();
-var { version } = JSON.parse(readFileSync31(join38(packageRoot, "package.json"), "utf8"));
+var { version } = JSON.parse(readFileSync32(join39(packageRoot, "package.json"), "utf8"));
 function warnIfUnpublishedPin() {
   if (isPublishedBuild(packageRoot)) return;
   console.warn(
@@ -6567,7 +7062,7 @@ program.command("seo").description("Audit what a search engine and a link previe
     process.exit(1);
   }
 });
-program.command("probe").description("Print the render probe. With --save, read what it returned on stdin and record it for `jig verdicts`.").option("--save <surface>", "record the probe's output (piped in) under .jig/critique/<surface>/").option("--run <page>", "render this page here, at 360, 768 and 1280, and record each (needs --save)").action(async (opts) => {
+program.command("probe").description("Print the render probe. With --save, read what it returned on stdin and record it for `jig verdicts`.").option("--save <surface>", "record the probe's output (piped in) under .jig/critique/<surface>/").option("--run <page>", "render this page here, at 360, 768, 1280 and 1600, and record each (needs --save)").option("--serve <dir>", "serve this directory over local http and load --run from it, so root-relative links resolve (a built static site)").action(async (opts) => {
   if (opts.run) {
     if (!opts.save) {
       console.error("  \u2717 --run records what it measures, so it needs --save <surface>.");
@@ -6575,7 +7070,7 @@ program.command("probe").description("Print the render probe. With --save, read
     }
     const projectRoot2 = findProjectRoot(process.cwd());
     try {
-      for (const saved of await runAndSaveProbes({ projectRoot: projectRoot2, surface: opts.save, page: opts.run })) {
+      for (const saved of await runAndSaveProbes({ projectRoot: projectRoot2, surface: opts.save, page: opts.run, serve: opts.serve })) {
         console.log(`  Recorded ${saved.path} \u2014 ${saved.page} at ${saved.width}px.`);
       }
     } catch (err) {
@@ -6609,7 +7104,7 @@ program.command("probe").description("Print the render probe. With --save, read
 program.command("gate").description("Run by the Claude Code Stop hook: block stopping while check or a critique fails.").action(async () => {
   let input = {};
   try {
-    if (!process.stdin.isTTY) input = JSON.parse(readFileSync31(0, "utf8") || "{}");
+    if (!process.stdin.isTTY) input = JSON.parse(readFileSync32(0, "utf8") || "{}");
   } catch {
   }
   const cwd = input.cwd ?? process.cwd();
@@ -6648,7 +7143,7 @@ program.command("init").description("Set the project up to use Jig: a brand file
 });
 function resolveSurfaceMode(projectRoot) {
   try {
-    const config = JSON.parse(readFileSync31(join38(projectRoot, "jig.config.json"), "utf8"));
+    const config = JSON.parse(readFileSync32(join39(projectRoot, "jig.config.json"), "utf8"));
     const modes = [...new Set((config.surfaces ?? []).map((s) => s.mode).filter(Boolean))];
     return modes.length === 1 ? modes[0] : void 0;
   } catch {