jig-ui 0.13.0 → 0.14.1

package/dist/index.js

@@ -2,9 +2,9 @@
 
 // src/index.ts
 import { Command } from "commander";
-import { readFileSync as readFileSync28 } from "fs";
+import { readFileSync as readFileSync30 } from "fs";
 import { homedir as homedir2 } from "os";
-import { join as join35 } from "path";
+import { join as join37 } from "path";
 
 // src/paths.ts
 import { existsSync } from "fs";
@@ -387,8 +387,8 @@ function render(template, vars) {
 function escapeTableCell(value) {
   return value.replace(/\|/g, "\\|");
 }
-function renderCommandTable(metadata) {
-  const rows = Object.entries(metadata).map(([name, meta]) => {
+function renderCommandTable(metadata2) {
+  const rows = Object.entries(metadata2).map(([name, meta]) => {
     const signature = meta.argumentHint ? `${name} ${meta.argumentHint}` : name;
     const status = meta.status === "planned" ? "planned \u2014 not yet implemented" : meta.status === "agent" ? "agent procedure \u2014 no CLI to run" : "available";
     return `| \`${escapeTableCell(signature)}\` | ${escapeTableCell(meta.description)} | ${status} |`;
@@ -522,7 +522,7 @@ function bundleFiles(packageRoot2, dir) {
 var ASK_INSTRUCTION = "Ask the user directly in chat, one question at a time, and wait for an answer before continuing.";
 function buildSkillBody(packageRoot2, rulesPath, version2) {
   const template = readFileSync4(join7(packageRoot2, "templates", "SKILL.md.tmpl"), "utf8");
-  const metadata = JSON.parse(
+  const metadata2 = JSON.parse(
     readFileSync4(join7(packageRoot2, "templates", "command-metadata.json"), "utf8")
   );
   return render(template, {
@@ -533,16 +533,16 @@ function buildSkillBody(packageRoot2, rulesPath, version2) {
     // — so a reader following the skill could never upgrade.
     update_path: "npx jig-ui@latest",
     ask_instruction: ASK_INSTRUCTION,
-    available_commands: renderCommandTable(metadata),
+    available_commands: renderCommandTable(metadata2),
     config_file: "jig.config.json",
     rules_path: rulesPath
   });
 }
 function buildCommandBody(packageRoot2, rulesPath, version2, argsPlaceholder) {
-  const metadata = JSON.parse(
+  const metadata2 = JSON.parse(
     readFileSync4(join7(packageRoot2, "templates", "command-metadata.json"), "utf8")
   );
-  const subcommands = Object.entries(metadata).filter(([, meta]) => meta.status === "available" || meta.status === "agent").map(([name]) => name).sort();
+  const subcommands = Object.entries(metadata2).filter(([, meta]) => meta.status === "available" || meta.status === "agent").map(([name]) => name).sort();
   const templatePath = join7(packageRoot2, "templates", "COMMAND.md.tmpl");
   if (!existsSync5(templatePath)) return { body: "", subcommands };
   const template = readFileSync4(templatePath, "utf8");
@@ -1823,7 +1823,13 @@ var REPO_DOCUMENTS = /* @__PURE__ */ new Set([
   "agents",
   "claude",
   "gemini",
-  "copilot-instructions"
+  "copilot-instructions",
+  // Jig's own: the project's decisions live beside the token layer, in
+  // `jig/DECISIONS.md`, and are written for whoever builds here.
+  "decisions",
+  "reconcile",
+  "coverage",
+  "drift"
 ]);
 function isRepoDocument(file) {
   const base = file.split("/").pop() ?? file;
@@ -3473,6 +3479,149 @@ var semanticElement = {
   }
 };
 
+// src/check/metadata.ts
+var QUOTED = `(?:"([^"]*)"|'([^']*)'|\`([^\`]*)\`)`;
+var HTML_TITLE = /<title[^>]*>([\s\S]*?)<\/title\s*>/i;
+var HTML_DESCRIPTION = /<meta[^>]+name\s*=\s*["']description["'][^>]*content\s*=\s*["']([^"']*)["']/i;
+var HTML_DESCRIPTION_REVERSED = /<meta[^>]+content\s*=\s*["']([^"']*)["'][^>]*name\s*=\s*["']description["']/i;
+var KEYED_TITLE = new RegExp(`(?:^|[\\s{,])(?:title|ogTitle|og:title)\\s*:\\s*${QUOTED}`, "m");
+var KEYED_TITLE_ALL = new RegExp(`(?:^|[\\s{,])(?:title|ogTitle|og:title)\\s*:\\s*${QUOTED}`, "gm");
+var HTML_TITLE_ALL = /<title[^>]*>([\s\S]*?)<\/title\s*>/gi;
+var KEYED_DESCRIPTION = new RegExp(`(?:^|[\\s{,])(?:description|ogDescription|og:description)\\s*:\\s*${QUOTED}`, "m");
+var COMPUTED_TITLE = /(?:^|[\s{,])(?:title|ogTitle)\s*:\s*(?!["'`])[A-Za-z_$][\w$.?[\]()]*|(?:^|[\s{,])(?:title|ogTitle)\s*:\s*`[^`]*\$\{/m;
+var ANY_TITLE = /<title[\s>]|(?:^|[\s{,])(?:title|ogTitle)\s*:|['"]title['"]\s*[,:]|titleTemplate/im;
+var ANY_DESCRIPTION = /name\s*=\s*["']description["']|(?:^|[\s{,])(?:description|ogDescription)\s*:|['"]description['"]\s*[,:]/im;
+var DECLARES = /export\s+(?:const|async\s+function|function)\s+(?:metadata|generateMetadata|meta)\b|useSeoMeta\s*\(|useHead\s*\(|defineRouteMeta\s*\(|<svelte:head|<Head\b|next\/head|react-helmet|<title[^>]*>|<meta\b/i;
+var NOINDEX = [
+  /<meta[^>]+name\s*=\s*["']robots["'][^>]*content\s*=\s*["'][^"']*noindex/i,
+  /robots\s*:\s*{[^}]*index\s*:\s*false/i,
+  /robots\s*:\s*["'][^"']*noindex/i,
+  /["']noindex["']/i,
+  /X-Robots-Tag[^\n]*noindex/i,
+  /noindex\s*:\s*true/i
+];
+function firstGroup(match) {
+  if (!match) return void 0;
+  const value = (match[1] ?? match[2] ?? match[3] ?? "").trim();
+  if (!value) return void 0;
+  return { value, index: match.index ?? 0 };
+}
+function readMetadata(source) {
+  const htmlTitle = firstGroup(HTML_TITLE.exec(source));
+  const title = htmlTitle ?? firstGroup(KEYED_TITLE.exec(source));
+  const description = firstGroup(HTML_DESCRIPTION.exec(source)) ?? firstGroup(HTML_DESCRIPTION_REVERSED.exec(source)) ?? firstGroup(KEYED_DESCRIPTION.exec(source));
+  const titles = [];
+  for (const re of [HTML_TITLE_ALL, KEYED_TITLE_ALL]) {
+    for (const match of source.matchAll(re)) {
+      const found = firstGroup(match);
+      if (found && !/^\{|\$\{/.test(found.value)) titles.push(found);
+    }
+  }
+  return {
+    titles,
+    title: title && !/^\{|\$\{/.test(title.value) ? title : void 0,
+    description: description && !/^\{|\$\{/.test(description.value) ? description : void 0,
+    hasTitle: ANY_TITLE.test(source),
+    hasDescription: ANY_DESCRIPTION.test(source),
+    declares: DECLARES.test(source),
+    computedTitle: COMPUTED_TITLE.test(source),
+    noindex: NOINDEX.some((re) => re.test(source))
+  };
+}
+function isWholeDocument(source) {
+  return /<html[\s>]/i.test(source) && /<head[\s>]/i.test(source);
+}
+var TITLE_BUDGET = 60;
+var DESCRIPTION_BUDGET = 155;
+
+// src/check/detectors/metadata.ts
+var INVENTED_DATE = /(?:lastModified|datePublished|dateModified|publishedTime|modifiedTime)\s*:\s*(?:new Date\(\s*\)|Date\.now\(\s*\))/;
+var metadata = {
+  name: "metadata",
+  appliesTo: (file) => isReaderText(file),
+  run(_source, file, ctx) {
+    const raw = ctx.raw;
+    const found = readMetadata(raw);
+    const starts = buildLineIndex(raw);
+    const findings = [];
+    const at = (rule, offset, message) => {
+      const line = lineForOffset(starts, offset);
+      findings.push({ ...mkFinding(ctx, "metadata", file, line, message, sourceLine(raw, line)), ruleId: rule });
+    };
+    for (const title of found.titles) {
+      if (title.value.length > TITLE_BUDGET) {
+        at("J-122", title.index, `the title is ${title.value.length} characters, past the ${TITLE_BUDGET} a search result shows \u2014 the end is cut, mid-sentence`);
+      }
+    }
+    if (found.description && found.description.value.length > DESCRIPTION_BUDGET) {
+      at("J-122", found.description.index, `the description is ${found.description.value.length} characters, past the ${DESCRIPTION_BUDGET} a search result shows`);
+    }
+    const invented = INVENTED_DATE.exec(raw);
+    if (invented) {
+      at("J-125", invented.index, "a date generated at request time is false on every request, and repeated daily it teaches the crawler to disbelieve the field");
+    }
+    if (isWholeDocument(raw)) {
+      const indexable = ctx.mode !== "product" && ctx.mode !== "operator";
+      if (indexable && !found.hasTitle) {
+        at("J-121", 0, "this page has no <title> \u2014 a search result then shows a truncated URL");
+      }
+      if (indexable && !found.hasDescription) {
+        at("J-121", 0, "this page has no meta description \u2014 the search engine writes one from whatever text it finds first, usually the navigation");
+      }
+      if (!indexable && !found.noindex) {
+        at("J-123", 0, `this surface is ${ctx.mode}, which is what somebody reaches after signing in, and the page carries no noindex \u2014 robots.txt is public and advisory, and is not this`);
+      }
+    }
+    return findings.filter((f) => f.ruleId === ctx.ruleId);
+  }
+};
+
+// src/check/detectors/interface-safety.ts
+var BLANK_LINK = /<a\b[^>]*\btarget\s*=\s*["']_blank["'][^>]*>/gi;
+var HAS_NOOPENER = /\brel\s*=\s*["'][^"']*\bno(?:opener|referrer)\b/i;
+var HTML_SINK = /\bdangerouslySetInnerHTML|\bv-html|\binnerHTML\s*=|\{@html\b/g;
+var IN_SCRIPT = /<script\b[^>]*$/i;
+var SERIALISED = /JSON\.stringify\s*\(/;
+var LITERAL_SINK = /dangerouslySetInnerHTML\s*=\s*\{\{\s*__html:\s*["'`]|innerHTML\s*=\s*["'`]/;
+var CREDENTIAL_FIELD = /<input\b[^>]*\btype\s*=\s*["'](?:password)["'][^>]*>/gi;
+var AUTOCOMPLETE_OFF = /\bautocomplete\s*=\s*["'](?:off|false)["']/i;
+var IFRAME = /<iframe\b[^>]*>/gi;
+var HAS_SANDBOX = /\bsandbox\s*=/i;
+var EXTERNAL_SRC = /\bsrc\s*=\s*["'](?:https?:)?\/\//i;
+var interfaceSafety = {
+  name: "interface-safety",
+  appliesTo: (file) => isReaderText(file),
+  run(_source, file, ctx) {
+    const raw = ctx.raw;
+    const starts = buildLineIndex(raw);
+    const findings = [];
+    const at = (rule, offset, message) => {
+      const line = lineForOffset(starts, offset);
+      findings.push({ ...mkFinding(ctx, "interface-safety", file, line, message, sourceLine(raw, line)), ruleId: rule });
+    };
+    for (const link of raw.matchAll(BLANK_LINK)) {
+      if (HAS_NOOPENER.test(link[0])) continue;
+      at("K-128", link.index, 'a link opening a new tab with no rel="noopener" \u2014 the page it opens gets a handle on this window and can navigate it elsewhere');
+    }
+    for (const sink of raw.matchAll(HTML_SINK)) {
+      const context = raw.slice(sink.index, sink.index + 120);
+      if (LITERAL_SINK.test(context) || SERIALISED.test(context)) continue;
+      const before = raw.slice(Math.max(0, sink.index - 400), sink.index);
+      if (IN_SCRIPT.test(before.slice(before.lastIndexOf("<")))) continue;
+      at("K-129", sink.index, `${sink[0].replace(/\s*=$/, "")} writes a value into the page as markup \u2014 render it as text, or sanitise on the way in`);
+    }
+    for (const field of raw.matchAll(CREDENTIAL_FIELD)) {
+      if (!AUTOCOMPLETE_OFF.test(field[0])) continue;
+      at("K-130", field.index, "a password field with autocomplete off \u2014 this stops the password manager, not an attacker, and the reader falls back to one they can remember");
+    }
+    for (const frame of raw.matchAll(IFRAME)) {
+      if (HAS_SANDBOX.test(frame[0]) || !EXTERNAL_SRC.test(frame[0])) continue;
+      at("K-131", frame.index, "a frame of somebody else's page with no sandbox \u2014 give it only the capabilities the embed needs");
+    }
+    return findings.filter((f) => f.ruleId === ctx.ruleId);
+  }
+};
+
 // src/check/registry.ts
 var DETECTORS = [
   gradientText,
@@ -3492,7 +3641,9 @@ var DETECTORS = [
   menuState,
   undeclaredToken,
   emDash,
-  semanticElement
+  semanticElement,
+  metadata,
+  interfaceSafety
 ];
 function getDetector(name) {
   return DETECTORS.find((d) => d.name === name);
@@ -5056,8 +5207,8 @@ Could not write to ${wireTarget}: ${err.message}`);
 }
 
 // src/commands/verdicts.ts
-import { existsSync as existsSync19, readFileSync as readFileSync25 } from "fs";
-import { join as join32, resolve as resolve4 } from "path";
+import { existsSync as existsSync20, readFileSync as readFileSync26 } from "fs";
+import { join as join33, resolve as resolve4 } from "path";
 
 // src/rules/citations.ts
 import { join as join28 } from "path";
@@ -5080,7 +5231,7 @@ import { fileURLToPath as fileURLToPath2 } from "url";
 import { join as join30, relative as relative3, resolve as resolve3 } from "path";
 
 // src/probe/script.ts
-var PROBE_VERSION = 3;
+var PROBE_VERSION = 5;
 var PROBE_SCRIPT = `(async () => {
   const doc = document.documentElement;
   const vis = (e) => { const r = e.getBoundingClientRect(); const s = getComputedStyle(e); return r.width > 0 && r.height > 0 && s.visibility !== 'hidden' && s.display !== 'none'; };
@@ -5142,6 +5293,20 @@ var PROBE_SCRIPT = `(async () => {
       }
     }
   }
+  // What a wide screen exposes: a layout with no upper bound, and the lines it
+  // stretches. Measured rather than guessed \u2014 a paragraph's own width and font
+  // size give its length in characters, which is what B-11 is written about.
+  const region = document.querySelector('main') || document.body;
+  const prose = [...document.querySelectorAll('p, li, dd, blockquote')].filter(vis)
+    .map((el) => {
+      const r = el.getBoundingClientRect();
+      const size = parseFloat(getComputedStyle(el).fontSize) || 16;
+      const text = (el.textContent || '').trim();
+      // 0.5em per character is the usual approximation for a text face.
+      return { width: Math.round(r.width), chars: Math.round(r.width / (size * 0.5)), text: text.slice(0, 40), long: text.length > 80 };
+    })
+    .filter((p) => p.long)
+    .sort((a, b) => b.chars - a.chars)[0] || null;
   const navLinks = () => [...document.querySelectorAll('nav a, header a, [role=navigation] a')].filter(vis).length;
   // Measured before anything is clicked: what a reader sees on arrival.
   const navAtRest = navLinks();
@@ -5189,6 +5354,17 @@ var PROBE_SCRIPT = `(async () => {
     emDashes: [...new Set((text.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: {
+      title: (document.title || '').trim(),
+      description: (document.querySelector('meta[name=description]') || {}).content || '',
+      canonical: (document.querySelector('link[rel=canonical]') || {}).href || '',
+      robots: (document.querySelector('meta[name=robots]') || {}).content || '',
+      ogTitle: (document.querySelector('meta[property="og:title"]') || {}).content || '',
+      ogImage: (document.querySelector('meta[property="og:image"]') || {}).content || '',
+    },
+    contentWidth: Math.round(region.getBoundingClientRect().width),
+    contentMaxWidth: getComputedStyle(region).maxWidth,
+    longestLine: prose,
     landmarks: landmarks.map(describe),
     orderInversions: inversions.slice(0, 5),
     menu,
@@ -5402,7 +5578,7 @@ function pageFile(projectRoot, url) {
   if (!abs.startsWith(resolve3(projectRoot))) return void 0;
   return existsSync17(abs) ? abs : void 0;
 }
-var PROBE_WIDTHS = [360, 768, 1280];
+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.`);
@@ -5485,7 +5661,9 @@ function readProbes(projectRoot, dir, errors) {
   }
   return probes;
 }
-function probeContradictions(probes, verdictOf) {
+var TITLE_BUDGET2 = 60;
+var DESCRIPTION_BUDGET2 = 155;
+function probeContradictions(probes, verdictOf, indexable = true) {
   const errors = [];
   const clean = (id) => ["ok", "n/a"].includes(verdictOf(id) ?? "");
   const at = (p) => `probe-${p.width}.json`;
@@ -5505,6 +5683,23 @@ function probeContradictions(probes, verdictOf) {
     if (p.emDashes?.length) {
       errors.push(`${at(p)}: the rendered page shows an em dash in ${p.emDashes.map((t) => `"${t}"`).join(", ")} (I-118) \u2014 use a full stop, a comma, a colon, or a second element.`);
     }
+    const line = p.longestLine;
+    if (line && line.chars > 90 && clean("B-11")) {
+      errors.push(`B-11 is "${verdictOf("B-11")}", but ${at(p)} measured a line of about ${line.chars} characters ("${line.text}\u2026") \u2014 past every mode's measure. Cap prose at \`--measure-prose\`.`);
+    }
+    const head = p.head;
+    if (head && p.width === probes[0]?.width) {
+      const noindex = /noindex/i.test(head.robots);
+      if (indexable && !noindex) {
+        if (!head.title) errors.push(`${at(p)}: the page served no <title> (J-121) \u2014 a search result then shows a truncated URL.`);
+        else if (head.title.length > TITLE_BUDGET2) errors.push(`${at(p)}: the title served is ${head.title.length} characters, past the ${TITLE_BUDGET2} a search result shows (J-122): "${head.title}".`);
+        if (!head.description) errors.push(`${at(p)}: the page served no meta description (J-121) \u2014 the search engine writes one from whatever text it finds first, usually the navigation.`);
+        else if (head.description.length > DESCRIPTION_BUDGET2) errors.push(`${at(p)}: the description served is ${head.description.length} characters, past the ${DESCRIPTION_BUDGET2} (J-122).`);
+      }
+      if (!indexable && !noindex) {
+        errors.push(`${at(p)}: this page is not indexable, and the page served no noindex (J-123). robots.txt is public and advisory, and is not this.`);
+      }
+    }
     if (p.junkText.length) {
       errors.push(`${at(p)}: the rendered text contains ${p.junkText.map((j) => `"${j}"`).join(", ")} \u2014 template code or a failed value is showing to readers.`);
     }
@@ -5540,22 +5735,64 @@ function probeContradictions(probes, verdictOf) {
   return errors;
 }
 
+// src/check/decisions.ts
+import { existsSync as existsSync19, readFileSync as readFileSync25 } from "fs";
+import { join as join32 } from "path";
+var HEADING3 = /^(#{2,3})\s+(.+?)\s*$/gm;
+var NOT_A_DECISION = /^(unresolved|open questions?|undecided|contents?|index)$/i;
+function decisionsFile(projectRoot) {
+  for (const candidate of ["jig/DECISIONS.md", "DECISIONS.md", "src/jig/DECISIONS.md", "src/styles/jig/DECISIONS.md", ".jig/DECISIONS.md"]) {
+    if (existsSync19(join32(projectRoot, candidate))) return candidate;
+  }
+  return void 0;
+}
+function decisionNames(projectRoot) {
+  const path = decisionsFile(projectRoot);
+  if (!path) return [];
+  let body;
+  try {
+    body = readFileSync25(join32(projectRoot, path), "utf8");
+  } catch {
+    return [];
+  }
+  const names = [];
+  for (const match of body.matchAll(HEADING3)) {
+    const name = match[2].replace(/[`*]/g, "").trim();
+    if (!name || NOT_A_DECISION.test(name)) continue;
+    if (!names.includes(name)) names.push(name);
+  }
+  return names;
+}
+
 // 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 (!existsSync19(path)) return null;
+  if (!existsSync20(path)) return null;
   try {
-    return JSON.parse(readFileSync25(path, "utf8"));
+    return JSON.parse(readFileSync26(path, "utf8"));
   } catch (e) {
     errors.push(`${path}: not valid JSON (${e.message})`);
     return {};
   }
 }
+function specIndexable(projectRoot, surface) {
+  const path = join33(projectRoot, ".jig", "specs", `${surface}.spec.md`);
+  let front = "";
+  try {
+    front = readFileSync26(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 mode = /^\s*mode\s*:\s*(\w+)/im.exec(front)?.[1]?.toLowerCase();
+  return mode !== "product" && mode !== "operator";
+}
 function specNeedsNav(projectRoot, surface) {
-  const path = join32(projectRoot, ".jig", "specs", `${surface}.spec.md`);
-  if (!existsSync19(path)) return false;
-  const front = readFileSync25(path, "utf8").split(/^---\s*$/m)[1] ?? "";
+  const path = join33(projectRoot, ".jig", "specs", `${surface}.spec.md`);
+  if (!existsSync20(path)) return false;
+  const front = readFileSync26(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;
@@ -5603,10 +5840,55 @@ function checkArm(name, file, required, otherPass, extraAllowed, extraRequired,
   const judged = total - missing.length;
   return { state: missing.length ? "incomplete" : "ran", judged, total, findings };
 }
+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(join33(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.`
+    );
+    return { state: "missing", judged: 0, total: required.length, findings: 0 };
+  }
+  const list = Array.isArray(file.verdicts) ? file.verdicts : [];
+  if (!Array.isArray(file.verdicts)) errors.push('decisions.json has no "verdicts" array.');
+  const seen = /* @__PURE__ */ new Set();
+  let findings = 0;
+  for (const v of list) {
+    const name = typeof v.decision === "string" ? v.decision.trim() : "";
+    if (!name) {
+      errors.push("decisions.json: a verdict names no decision.");
+      continue;
+    }
+    const match = required.find((r) => r.toLowerCase() === name.toLowerCase());
+    if (!match) {
+      errors.push(`decisions.json: "${name}" is not a heading in DECISIONS.md. Judge the decisions the project made, not ones you name yourself.`);
+      continue;
+    }
+    if (seen.has(match)) {
+      errors.push(`decisions.json: "${match}" is judged more than once.`);
+      continue;
+    }
+    seen.add(match);
+    if (typeof v.verdict !== "string" || !VERDICTS.includes(v.verdict)) {
+      errors.push(`decisions.json: "${match}" has verdict ${JSON.stringify(v.verdict)} \u2014 it must be ok, finding or n/a.`);
+      continue;
+    }
+    const reason = typeof v.reason === "string" ? v.reason.trim() : "";
+    if (!reason) errors.push(`decisions.json: "${match}" has no reason. Name what on the page satisfies it, or what does not.`);
+    else if (ABSENCE.test(reason)) errors.push(`decisions.json: "${match}" \u2014 "${reason}" says the decision was not read.`);
+    if (v.verdict === "finding") findings++;
+  }
+  const missing = required.filter((r) => !seen.has(r));
+  if (missing.length) {
+    errors.push(`decisions.json: ${missing.length} of ${required.length} decisions have no verdict: ${missing.join(", ")}.`);
+  }
+  return { state: missing.length ? "incomplete" : "ran", judged: required.length - missing.length, total: required.length, findings };
+}
 function verifyVerdicts(opts) {
   const root = opts.packageRoot ?? assetRoot();
   const errors = [];
-  const index = JSON.parse(readFileSync25(join32(root, "rules.index.json"), "utf8"));
+  const index = JSON.parse(readFileSync26(join33(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);
@@ -5615,16 +5897,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 = join32(opts.projectRoot, ".jig", "critique", opts.surface);
-  const screenFile = readJson(join32(dir, "screen.json"), errors);
-  const codeFile = readJson(join32(dir, "code.json"), errors);
+  const dir = join33(opts.projectRoot, ".jig", "critique", opts.surface);
+  const screenFile = readJson(join33(dir, "screen.json"), errors);
+  const codeFile = readJson(join33(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) => !existsSync19(resolve4(opts.projectRoot, a)));
+    const absent = artefacts.filter((a) => !existsSync20(resolve4(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;
@@ -5632,7 +5914,7 @@ function verifyVerdicts(opts) {
   const probes = readProbes(opts.projectRoot, dir, errors);
   if (screenFile && screenFile.rendered === true) {
     const widths = new Set(probes.map((p) => p.width));
-    const missing = [360, 768, 1280].filter((w) => !widths.has(w));
+    const missing = PROBE_WIDTHS.filter((w) => !widths.has(w));
     if (missing.length) {
       errors.push(`screen.json says rendered: true, but there is no probe at ${missing.join(", ")}px. At each width run \`jig probe\` in the browser and save its output as probe-<width>.json.`);
       rendered = false;
@@ -5643,28 +5925,29 @@ 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));
+  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}` : ""}`;
-  const line = `JIG_VERDICTS: surface=${opts.surface} screen=${field(screen)} code=${field(code)} rendered=${rendered ? "yes" : "no"} findings=${screen.findings + code.findings}`;
-  return { ok: errors.length === 0, errors, screen, code, rendered, line };
+  const line = `JIG_VERDICTS: surface=${opts.surface} screen=${field(screen)} code=${field(code)} decisions=${field(decisions)} rendered=${rendered ? "yes" : "no"} findings=${screen.findings + code.findings + decisions.findings}`;
+  return { ok: errors.length === 0, errors, screen, code, decisions, rendered, line };
 }
 
 // src/commands/gate.ts
-import { existsSync as existsSync21, mkdirSync as mkdirSync8, readdirSync as readdirSync15, readFileSync as readFileSync27, writeFileSync as writeFileSync7 } from "fs";
+import { existsSync as existsSync22, mkdirSync as mkdirSync8, readdirSync as readdirSync15, readFileSync as readFileSync28, writeFileSync as writeFileSync7 } from "fs";
 import { createHash as createHash2 } from "crypto";
-import { join as join34 } from "path";
+import { join as join35 } from "path";
 
 // src/check/spec-shape.ts
-import { existsSync as existsSync20, readFileSync as readFileSync26, readdirSync as readdirSync14, statSync as statSync2 } from "fs";
-import { join as join33 } from "path";
+import { existsSync as existsSync21, readFileSync as readFileSync27, readdirSync as readdirSync14, statSync as statSync2 } from "fs";
+import { join as join34 } from "path";
 function newestSpec(projectRoot) {
-  const dir = join33(projectRoot, ".jig", "specs");
-  if (!existsSync20(dir)) return void 0;
+  const dir = join34(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(join33(dir, f)).mtimeMs })).sort((a, b) => b.at - a.at)[0].f;
-  return { path: `.jig/specs/${newest}`, slug: newest.replace(/\.spec\.md$|\.md$/, ""), body: readFileSync26(join33(dir, newest), "utf8") };
+  const newest = files.map((f) => ({ f, at: statSync2(join34(dir, f)).mtimeMs })).sort((a, b) => b.at - a.at)[0].f;
+  return { path: `.jig/specs/${newest}`, slug: newest.replace(/\.spec\.md$|\.md$/, ""), body: readFileSync27(join34(dir, newest), "utf8") };
 }
 function specProblems(spec) {
   const parts = spec.body.split(/^---\s*$/m);
@@ -5678,7 +5961,7 @@ function specProblems(spec) {
     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"]) {
+  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:\`.`);
@@ -5719,7 +6002,7 @@ 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", "desktop"]) {
+  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;
@@ -5733,10 +6016,10 @@ function navProblems(spec) {
 // src/commands/gate.ts
 var MAX_BLOCKS = 3;
 function lastJigCommand(transcriptPath) {
-  if (!transcriptPath || !existsSync21(transcriptPath)) return void 0;
+  if (!transcriptPath || !existsSync22(transcriptPath)) return void 0;
   let text;
   try {
-    text = readFileSync27(transcriptPath, "utf8");
+    text = readFileSync28(transcriptPath, "utf8");
   } catch {
     return void 0;
   }
@@ -5754,10 +6037,10 @@ function commandProblems(root, command) {
   const problems = [];
   const spec = newestSpec(root);
   if (command === "decide") {
-    const file = ["jig/DECISIONS.md", "DECISIONS.md", ".jig/DECISIONS.md"].map((p) => join34(root, p)).find((p) => existsSync21(p));
+    const file = ["jig/DECISIONS.md", "DECISIONS.md", ".jig/DECISIONS.md"].map((p) => join35(root, p)).find((p) => existsSync22(p));
     if (!file) problems.push("decide wrote no DECISIONS.md beside the token layer.");
     else {
-      const body = readFileSync27(file, "utf8");
+      const body = readFileSync28(file, "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.`");
       }
@@ -5778,15 +6061,18 @@ 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) && !existsSync21(join34(root, at))) problems.push(`${spec.path}: \`mockup_at: ${at}\` does not exist.`);
+      else if (!/^https?:/i.test(at) && !existsSync22(join35(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 = join34(root, ".jig", "critique");
-    const surfaces = existsSync21(dir) ? readdirSync15(dir).filter((s) => existsSync21(join34(dir, s, "screen.json")) || existsSync21(join34(dir, s, "code.json"))) : [];
+    const dir = join35(root, ".jig", "critique");
+    const surfaces = existsSync22(dir) ? readdirSync15(dir).filter((s) => existsSync22(join35(dir, s, "screen.json")) || existsSync22(join35(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) {
+        problems.push(`${surface}: ${v.decisions.total - v.decisions.judged} of ${v.decisions.total} decisions in DECISIONS.md have no verdict. A page can satisfy every rule and still break what this project decided.`);
+      }
       if (v.ok && v.screen.state === "skipped") {
         problems.push(`${surface}: the screen pass judged ${v.screen.judged} rules with rendered: false. Those rules are judged on a render \u2014 open the page at 360, 768 and 1280, run \`jig probe\` at each, and judge them there.`);
       }
@@ -5803,13 +6089,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 && existsSync21(join34(projectRoot, candidate))) return candidate;
+    if (candidate && existsSync22(join35(projectRoot, candidate))) return candidate;
   }
   return void 0;
 }
 function gate(opts) {
   const root = opts.projectRoot;
-  if (!existsSync21(join34(root, "jig.config.json")) && !existsSync21(join34(root, ".jig"))) {
+  if (!existsSync22(join35(root, "jig.config.json")) && !existsSync22(join35(root, ".jig"))) {
     return { block: false, reason: "" };
   }
   const command = lastJigCommand(opts.input.transcript_path);
@@ -5828,11 +6114,11 @@ function gate(opts) {
       );
     }
   }
-  const critiqueDir = join34(root, ".jig", "critique");
-  if (existsSync21(critiqueDir)) {
+  const critiqueDir = join35(root, ".jig", "critique");
+  if (existsSync22(critiqueDir)) {
     for (const surface of readdirSync15(critiqueDir)) {
-      const dir = join34(critiqueDir, surface);
-      if (!existsSync21(join34(dir, "screen.json")) && !existsSync21(join34(dir, "code.json"))) continue;
+      const dir = join35(critiqueDir, surface);
+      if (!existsSync22(join35(dir, "screen.json")) && !existsSync22(join35(dir, "code.json"))) continue;
       const v = verifyVerdicts({ projectRoot: root, surface });
       if (!v.ok) {
         const shown = v.errors.slice(0, 6).map((e) => `  ${e}`);
@@ -5846,10 +6132,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 = join34(root, ".jig", "gate.json");
+  const stateFile = join35(root, ".jig", "gate.json");
   let state = {};
   try {
-    state = JSON.parse(readFileSync27(stateFile, "utf8"));
+    state = JSON.parse(readFileSync28(stateFile, "utf8"));
   } catch {
   }
   if (problems.length === 0) {
@@ -5879,15 +6165,112 @@ ${problems.join("\n\n")}`
 }
 function save(file, state) {
   try {
-    mkdirSync8(join34(file, ".."), { recursive: true });
+    mkdirSync8(join35(file, ".."), { recursive: true });
     writeFileSync7(file, JSON.stringify(state), "utf8");
   } catch {
   }
 }
 
+// src/commands/seo.ts
+import { readFileSync as readFileSync29 } from "fs";
+import { join as join36 } 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;
+var TEST_FILE = /(^|\/)(test|tests|__tests__|spec|e2e|fixtures?|stories)\/|\.(test|spec|stories)\.[a-z]+$/i;
+var ROUTE_DIR = /(?:^|\/)(?:src\/|app\/)?(?:pages|routes)\/(.+)$/;
+var TEMPLATE = /\.(html?|php|erb|njk|hbs|handlebars|liquid|ejs|twig|jinja2?|j2|mustache)$/i;
+var PARTS_DIR = /(^|\/)_?(layouts?|components?|partials?|includes?)\//i;
+var ENDPOINT = /export\s+(?:const|async\s+function|function)\s+(?:GET|POST|PUT|PATCH|DELETE|ALL)\b/;
+function isPage(file, raw) {
+  if (TEST_FILE.test(file)) return false;
+  if (/(^|\/)app\/(.+\/)?page\.(tsx|jsx|ts|js|mdx|md)$/.test(file)) return true;
+  const route = ROUTE_DIR.exec(file);
+  if (route) {
+    const rest = route[1];
+    const name = rest.split("/").pop();
+    if (name.startsWith("+")) return name === "+page.svelte";
+    if (/(^|\/)api\//.test(rest) || name.startsWith("_")) return false;
+    if (/\.[a-z]+\.[cm]?[jt]s$/i.test(name)) return false;
+    if (/\.[cm]?[jt]s$/i.test(name)) return /export\s+default\b/.test(raw) && !ENDPOINT.test(raw);
+    return /\.(astro|html?|mdx?|vue|svelte|[jt]sx)$/i.test(name);
+  }
+  return TEMPLATE.test(file) && !PARTS_DIR.test(file) && isWholeDocument(raw);
+}
+function routeOf(file) {
+  const path = file.replace(/^(?:src\/pages|app\/pages|app\/routes|src\/routes|pages|routes|app|src|public|content)\//, "").replace(/(^|\/)(index|\+?page)\.(html?|astro|vue|svelte|[jt]sx?|md|mdx)$/i, "$1").replace(/\.(html?|astro|vue|svelte|[jt]sx?|md|mdx)$/i, "").replace(/\/$/, "");
+  return `/${path}`.replace(/\/+/g, "/");
+}
+function seo(opts) {
+  const root = opts.projectRoot;
+  const files = selectFiles(root, true).files;
+  const findings = [];
+  const add = (file, ruleId, severity, message) => findings.push({ file, ruleId, severity, message });
+  const pages = [];
+  let sitemapFiles = [];
+  let robotsFiles = [];
+  const sitemapRoutes = /* @__PURE__ */ new Map();
+  const pathLocs = [];
+  for (const file of files) {
+    let raw;
+    try {
+      raw = readFileSync29(join36(root, file), "utf8");
+    } catch {
+      continue;
+    }
+    if (SITEMAP_FILE.test(file)) {
+      sitemapFiles.push(file);
+      for (const match of raw.matchAll(ROUTE_IN_SITEMAP)) {
+        const value = (match[1] ?? match[2] ?? "").trim();
+        if (!value) continue;
+        if (match[1] && !/^https?:\/\//i.test(value)) pathLocs.push({ file, loc: value });
+        const path = value.replace(/^https?:\/\/[^/]+/i, "") || "/";
+        sitemapRoutes.set(path.replace(/\/$/, "") || "/", file);
+      }
+      continue;
+    }
+    if (ROBOTS_FILE.test(file)) {
+      robotsFiles.push(file);
+      continue;
+    }
+    if (!isPage(file, raw)) continue;
+    const found = readMetadata(raw);
+    const settled = found.titles.length === 1 && !found.computedTitle ? found.titles[0].value : void 0;
+    pages.push({ file, route: routeOf(file), title: settled, noindex: found.noindex });
+  }
+  for (const page of pages.filter((p) => p.noindex)) {
+    const listed = sitemapRoutes.get(page.route) ?? sitemapRoutes.get(`${page.route}/`);
+    if (listed) {
+      add(listed, "J-124", "error", `the sitemap lists ${page.route}, and ${page.file} says noindex. One answer per route: a crawler reading two picks one.`);
+    }
+  }
+  if (pathLocs.length > 0) {
+    const shown = pathLocs.slice(0, 3).map((p) => p.loc).join(", ");
+    add(pathLocs[0].file, "J-124", "error", `${pathLocs.length} sitemap entr${pathLocs.length === 1 ? "y is a path" : "ies are paths"} (${shown}), not a full URL. A crawler drops them; with no origin yet, no sitemap is the honest one.`);
+  }
+  const byTitle = /* @__PURE__ */ new Map();
+  for (const page of pages) {
+    if (!page.title || page.noindex) continue;
+    byTitle.set(page.title, [...byTitle.get(page.title) ?? [], page.file]);
+  }
+  for (const [title, where] of byTitle) {
+    if (where.length > 1) {
+      add(where[1], "J-121", "warning", `"${title}" is the title of ${where.length} pages (${where.join(", ")}). A result page showing the same line twice tells a reader nothing about either.`);
+    }
+  }
+  const indexable = pages.filter((p) => !p.noindex);
+  const publicSurface = opts.mode !== "product" && opts.mode !== "operator";
+  if (publicSurface && indexable.length > 0 && sitemapFiles.length > 0 && sitemapRoutes.size === 0) {
+    add(sitemapFiles[0], "J-127", "error", "the sitemap lists no routes. An empty sitemap is not a missing one: it is a claim that the site has nothing.");
+  }
+  const titleBudget = pages.filter((p) => p.title && p.title.length > TITLE_BUDGET).length;
+  const line = `JIG_SEO: pages=${pages.length} indexable=${indexable.length} noindex=${pages.length - indexable.length} sitemap=${sitemapFiles.length > 0 ? sitemapRoutes.size : "none"} robots=${robotsFiles.length > 0 ? "yes" : "no"} overlong=${titleBudget} findings=${findings.length}`;
+  return { findings, pages: pages.length, indexable: indexable.length, line };
+}
+
 // src/index.ts
 var packageRoot = getPackageRoot();
-var { version } = JSON.parse(readFileSync28(join35(packageRoot, "package.json"), "utf8"));
+var { version } = JSON.parse(readFileSync30(join37(packageRoot, "package.json"), "utf8"));
 function warnIfUnpublishedPin() {
   if (isPublishedBuild(packageRoot)) return;
   console.warn(
@@ -6013,6 +6396,24 @@ program.command("check").description("Check the repo against Jig's mechanical +
     process.exit(1);
   }
 });
+program.command("seo").description("Audit what a search engine and a link preview read, across the whole project.").option("--json", "emit findings as JSON", false).action((opts) => {
+  const projectRoot = findProjectRoot(process.cwd());
+  try {
+    const result = seo({ projectRoot, mode: resolveSurfaceMode(projectRoot) });
+    if (opts.json) {
+      console.log(JSON.stringify(result.findings, null, 2));
+    } else {
+      const symbol = { error: "\u2717", warning: "\u26A0", note: "\xB7" };
+      for (const f of result.findings) console.log(`  ${symbol[f.severity]} ${f.ruleId} ${f.message}  ${f.file}`);
+      if (result.findings.length === 0) console.log("  Nothing to fix in what a search engine reads.");
+      console.log(`  ${result.line}`);
+    }
+    process.exit(result.findings.some((f) => f.severity === "error") ? 1 : 0);
+  } catch (err) {
+    console.error(err.message);
+    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) => {
   if (opts.run) {
     if (!opts.save) {
@@ -6055,7 +6456,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(readFileSync28(0, "utf8") || "{}");
+    if (!process.stdin.isTTY) input = JSON.parse(readFileSync30(0, "utf8") || "{}");
   } catch {
   }
   const cwd = input.cwd ?? process.cwd();
@@ -6092,4 +6493,13 @@ program.command("init").description("Set the project up to use Jig: a brand file
     process.exit(1);
   }
 });
+function resolveSurfaceMode(projectRoot) {
+  try {
+    const config = JSON.parse(readFileSync30(join37(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 {
+    return void 0;
+  }
+}
 program.parse();