jig-ui 0.21.0 → 0.22.0

package/dist/index.js

@@ -2,9 +2,9 @@
 
 // src/index.ts
 import { Command } from "commander";
-import { readFileSync as readFileSync34 } from "fs";
+import { readFileSync as readFileSync36 } from "fs";
 import { homedir as homedir2 } from "os";
-import { join as join41 } from "path";
+import { join as join43 } from "path";
 
 // src/paths.ts
 import { existsSync } from "fs";
@@ -5349,6 +5349,7 @@ async function init(opts) {
   log(`Proposed brand colour: hsl(${proposal.h} ${proposal.s}% ${proposal.l}%) \u2014 ${proposal.detail}`);
   for (const line of describeValidation(validation)) log(line);
   let surfaces = DEFAULT_SURFACES;
+  let critique;
   if (!opts.yes) {
     for (let attempt = 0; attempt < 3; attempt++) {
       const answer = await prompt(
@@ -5376,6 +5377,12 @@ async function init(opts) {
         `  Could not parse '${surfaceAnswer}' as 'match:mode,match:mode' (modes: ${MODES2.join("/")}) \u2014 using the default ('/' \u2192 product) instead.`
       );
     }
+    const critiqueAnswer = (await prompt(
+      `When should pages be critiqued? Enter to decide page by page, 'each' after every build, or 'ship' to leave them for jig ship: `
+    )).toLowerCase();
+    if (/^(e|each)$/.test(critiqueAnswer)) critique = "each";
+    else if (/^(s|ship|at-ship)$/.test(critiqueAnswer)) critique = "at-ship";
+    else if (critiqueAnswer) log(`  Could not read '${critiqueAnswer}' \u2014 leaving it page by page; each spec will ask.`);
   }
   if (opts.yes) {
     const declared = readConfiguredSurfaces(join28(opts.projectRoot, "jig.config.json"));
@@ -5483,7 +5490,7 @@ ${configRelPath} already exists and was not created by 'jig init' (or has been e
     }
   }
   if (configAction === "written") {
-    const config = opts.yes ? { brand: brandRelPath } : { brand: brandRelPath, surfaces };
+    const config = opts.yes ? { brand: brandRelPath } : { brand: brandRelPath, surfaces, ...critique ? { critique } : {} };
     const content = `${JSON.stringify(config, null, 2)}
 `;
     writeFileSync4(configAbsPath, content, "utf8");
@@ -5499,6 +5506,8 @@ ${configRelPath} already exists and was not created by 'jig init' (or has been e
     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 = {
+      ...existing,
+      ...existing.critique === void 0 && critique ? { critique } : {},
       brand: brandStillResolves ? existingBrand : brandRelPath,
       // Same contract as the 'written' branch: never invent a mapping under
       // `--yes`. An existing declaration is always kept.
@@ -6598,14 +6607,12 @@ function unsourcedReasons(current, before, opts = {}) {
   return problems;
 }
 function quotesNotFrom(current, before, words) {
-  const norm = (t) => t.toLowerCase().replace(/[‘’]/g, "'").replace(/\s+/g, " ").trim();
-  const said = norm(words);
   const problems = [];
   for (const [name, whys] of changedWhys(current, before, true)) {
     for (const why of whys) {
       const label = /^\s*\*\*(Why\b[^*]*):\*\*/.exec(why)[1];
       if (/inferred/i.test(label)) continue;
-      const missing = [...why.matchAll(/["“]([^"”]{3,})["”]/g)].map((m) => m[1]).filter((q) => q.split(/…|\.\.\./).map((part) => norm(part).replace(/^[\s.,;:]+|[\s.,;:!?]+$/g, "")).filter(Boolean).some((part) => !said.includes(part)));
+      const missing = [...why.matchAll(/["“]([^"”]{3,})["”]/g)].map((m) => m[1]).filter((q) => !quoteHeld(q, words));
       if (missing.length) {
         problems.push(`"${name}": its \`**${label}:**\` quotes "${missing[0]}", which the owner's words in tweak.json (\`change\`) do not say. Quote the owner as tweak.json records them, or put your reading under \`**Why (inferred):**\`.`);
         break;
@@ -6614,6 +6621,11 @@ function quotesNotFrom(current, before, words) {
   }
   return problems;
 }
+var normQuote = (t) => t.toLowerCase().replace(/\\(?=["'\\])/g, "").replace(/[‘’]/g, "'").replace(/[“”]/g, '"').replace(/\s+/g, " ").trim();
+function quoteHeld(quote, words) {
+  const said = normQuote(words);
+  return quote.split(/…|\.\.\./).map((part) => normQuote(part).replace(/^[\s.,;:]+|[\s.,;:!?]+$/g, "")).filter(Boolean).every((part) => said.includes(part));
+}
 
 // src/check/spec-shape.ts
 import { existsSync as existsSync22, readFileSync as readFileSync29, readdirSync as readdirSync14, statSync as statSync4 } from "fs";
@@ -6644,6 +6656,10 @@ function specProblems(spec) {
   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.`);
   }
+  const critique = /^\s*critique\s*:\s*(.*)$/im.exec(front)?.[1]?.replace(/\s+#.*$/, "").trim();
+  if (critique !== void 0 && !/^(each|at-ship)$/i.test(critique)) {
+    problems.push(`${spec.path}: \`critique: ${critique}\` is neither \`each\` nor \`at-ship\`. Leave it out to follow the project's default.`);
+  }
   for (const field of ["feature", "surface", "mode", "sizes", "confirmed", "mockup"]) {
     if (!has(field)) problems.push(`${spec.path} frontmatter has no \`${field}:\`.`);
   }
@@ -7053,9 +7069,9 @@ function sourceChanges(git, from, to) {
 }
 
 // src/commands/gate.ts
-import { existsSync as existsSync24, mkdirSync as mkdirSync8, readdirSync as readdirSync15, readFileSync as readFileSync32, statSync as statSync5, writeFileSync as writeFileSync6 } from "fs";
-import { createHash as createHash2 } from "crypto";
-import { join as join39 } from "path";
+import { existsSync as existsSync26, mkdirSync as mkdirSync8, readdirSync as readdirSync16, readFileSync as readFileSync35, statSync as statSync5, writeFileSync as writeFileSync6 } from "fs";
+import { createHash as createHash3 } from "crypto";
+import { join as join42 } from "path";
 
 // src/check/mockup-drawing.ts
 import { readFileSync as readFileSync31 } from "fs";
@@ -7229,12 +7245,316 @@ function sizeBlock2(sizes, size) {
 
 // src/commands/gate.ts
 import { execFileSync as execFileSync4 } from "child_process";
+
+// src/commands/ship.ts
+import { existsSync as existsSync24, readdirSync as readdirSync15, readFileSync as readFileSync33 } from "fs";
+import { join as join40 } from "path";
+
+// src/commands/seo.ts
+import { readFileSync as readFileSync32 } from "fs";
+import { join as join39 } 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 = readFileSync32(join39(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/commands/ship.ts
+var NOT_COVERED = "security, performance, what a screen reader or a real device does, and deployment itself";
+function specCritique(specBody) {
+  const front = specBody?.split(/^---\s*$/m)[1] ?? "";
+  const value = /^\s*critique\s*:\s*([\w-]+)/im.exec(front)?.[1]?.toLowerCase();
+  return value === "each" || value === "at-ship" ? value : void 0;
+}
+function critiqueAtShip(projectRoot, specBody) {
+  const own = specCritique(specBody);
+  if (own) return own === "at-ship";
+  try {
+    return JSON.parse(readFileSync33(join40(projectRoot, "jig.config.json"), "utf8")).critique === "at-ship";
+  } catch {
+    return false;
+  }
+}
+function tweakDeferred(dir) {
+  let t;
+  try {
+    t = JSON.parse(readFileSync33(join40(dir, "tweak.json"), "utf8"));
+  } catch {
+    return false;
+  }
+  if (t.deferred === void 0 || t.deferred === false) return false;
+  let judged;
+  try {
+    judged = JSON.parse(readFileSync33(join40(dir, "verdicts.lock"), "utf8")).tweak;
+  } catch {
+  }
+  return judged !== t.at;
+}
+function pageChecksum(html) {
+  return checksum(html.replace(/(href|src)="[^"]*\.(css|js|mjs)(\?[^"]*)?"/g, '$1="asset.$2"'));
+}
+function changedSinceLock(projectRoot, dir) {
+  let lock;
+  try {
+    lock = JSON.parse(readFileSync33(join40(dir, "verdicts.lock"), "utf8"));
+  } catch {
+    return void 0;
+  }
+  const file = lock.page?.file;
+  if (!file || !lock.page?.checksum) return void 0;
+  try {
+    const html = readFileSync33(join40(projectRoot, file), "utf8");
+    return pageChecksum(html) !== lock.page.checksum && checksum(html) !== lock.page.checksum ? file : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function pageStatus(projectRoot, surface) {
+  const spec = readFileSync33(join40(projectRoot, ".jig", "specs", `${surface}.spec.md`), "utf8");
+  const front = spec.split(/^---\s*$/m)[1] ?? "";
+  if (!/^\s*confirmed\s*:\s*true\b/im.test(front)) {
+    return { surface, state: "in-progress", detail: "its spec is not confirmed, so nothing of it is built to ship" };
+  }
+  const dir = join40(projectRoot, ".jig", "critique", surface);
+  if (!existsSync24(join40(dir, "screen.json")) && !existsSync24(join40(dir, "code.json"))) {
+    return { surface, state: "never", detail: "never critiqued" };
+  }
+  if (tweakDeferred(dir)) return { surface, state: "deferred", detail: "a tweak deferred its re-judge" };
+  const changed = changedSinceLock(projectRoot, dir);
+  if (changed) return { surface, state: "changed", detail: `${changed} changed after it was judged` };
+  const v = verifyVerdicts({ projectRoot, surface });
+  const stale = v.errors.find((e) => /was taken (on|by) an older/.test(e));
+  let judgedPage = false;
+  try {
+    judgedPage = !!JSON.parse(readFileSync33(join40(dir, "verdicts.lock"), "utf8")).page?.checksum;
+  } catch {
+  }
+  if (stale && !judgedPage) return { surface, state: "changed", detail: "the page changed after its probes were taken" };
+  if (stale) return { surface, state: "reprobe", detail: `its page is as judged, but the styles or scripts it loads changed: re-probe it (\`jig verdicts ${surface} --reprobe\`)` };
+  if (!v.ok) return { surface, state: "incomplete", detail: `its critique is not complete: ${v.errors[0]}` };
+  const findings = v.screen.findings + v.code.findings + v.decisions.findings;
+  if (findings > 0) return { surface, state: "findings", detail: `${findings} finding${findings === 1 ? "" : "s"} the owner has not ruled on` };
+  return { surface, state: "judged", detail: "judged as it stands, nothing open" };
+}
+function ship(opts) {
+  const root = opts.projectRoot;
+  const mechanical = check({ projectRoot: root, homeDir: "", version: opts.version, all: true, ci: true });
+  const mechanicalErrors = mechanical.findings.filter((f) => f.bucket === "mechanical" && f.severity === "error").length;
+  const seoResult = seo({ projectRoot: root });
+  const seoErrors = seoResult.findings.filter((f) => f.severity === "error").length;
+  const specsDir = join40(root, ".jig", "specs");
+  const surfaces = existsSync24(specsDir) ? readdirSync15(specsDir).filter((f) => f.endsWith(".spec.md") && !f.startsWith("_")).map((f) => f.replace(/\.spec\.md$/, "")).sort() : [];
+  const pages = surfaces.map((s) => pageStatus(root, s));
+  const owed = pages.filter((p) => p.state !== "judged" && p.state !== "in-progress");
+  const ready = mechanicalErrors === 0 && seoErrors === 0 && owed.length === 0;
+  const count = (state) => pages.filter((p) => p.state === state).length;
+  const line = `JIG_SHIP: ready=${ready ? "yes" : "no"} mechanical=${mechanicalErrors} seo=${seoErrors} pages=${pages.length} judged=${count("judged")} owed=${owed.length} in-progress=${count("in-progress")}`;
+  const mark = { judged: "\u2713", never: "\u2717", changed: "\u2717", reprobe: "\u2717", deferred: "\u2717", incomplete: "\u2717", findings: "\u2717", "in-progress": "\xB7" };
+  const report2 = [
+    `  ${mechanicalErrors === 0 ? "\u2713" : "\u2717"} check --all --ci: ${mechanicalErrors} mechanical error${mechanicalErrors === 1 ? "" : "s"}`,
+    `  ${seoErrors === 0 ? "\u2713" : "\u2717"} seo: ${seoErrors} error${seoErrors === 1 ? "" : "s"}`,
+    ...pages.map((p) => `  ${mark[p.state]} ${p.surface}: ${p.detail}`),
+    owed.length ? `  Critique each page marked \u2717 (\`/jig critique <page>\`); fix what it finds, or record the owner's ruling, and run \`jig ship\` again.` : "",
+    `  Not checked by Jig, here or anywhere: ${NOT_COVERED}.`,
+    `  ${line}`
+  ].filter(Boolean).join("\n");
+  return { ready, mechanicalErrors, seoErrors, pages, line, report: report2 };
+}
+
+// src/check/spec-checked.ts
+import { existsSync as existsSync25, readFileSync as readFileSync34 } from "fs";
+import { createHash as createHash2 } from "crypto";
+import { join as join41 } from "path";
+function specChecksum(body) {
+  return createHash2("sha256").update(body.replace(/^\s*(confirmed|mockup)\s*:.*$/gim, "")).digest("hex");
+}
+var mockupLine = (body) => /^\s*mockup\s*:\s*(.*)$/im.exec(body.split(/^---\s*$/m)[1] ?? "")?.[1]?.trim() ?? "";
+function mockupWordProblems(spec, then, owner) {
+  const now = mockupLine(spec.body);
+  if (now === mockupLine(then)) return [];
+  const m = /^(approved|skipped)\b(.*)$/i.exec(now);
+  if (!m) return [];
+  const word = m[1].toLowerCase();
+  const quoted = /["“]([^"”]+)["”]/.exec(m[2])?.[1]?.trim();
+  if (!quoted) {
+    return [`${spec.path}: \`mockup: ${word}\` is recorded without the owner's words. Write \`mockup: ${word} \u2014 "<what they said>"\`, quoting the reply that ${word === "approved" ? "approved it" : "said to skip it"}.`];
+  }
+  if (!quoteHeld(quoted, owner)) {
+    return [`${spec.path}: \`mockup: ${word}\` quotes "${quoted}", which the owner did not say in this session. Quote their reply as they wrote it; ${word === "approved" ? "an approval" : "a skip"} nobody gave is not one.`];
+  }
+  return [];
+}
+function mockupPending(body) {
+  const now = mockupLine(body);
+  return !now || /^pending\b/i.test(now);
+}
+function ownerQuotes(body) {
+  const quote = String.raw`\\?["“]((?:[^"“”\\\n]|\\(?!"))+?)\\?["”]`;
+  const patterns = [
+    new RegExp(String.raw`\bowner(?:['’]s)?\b[^"“”\n]{0,30}?` + quote, "gi"),
+    new RegExp(String.raw`\buser(?:['’]s words)?\s*(?:(?:said|says|ruled|wrote|asked|answered|replied)\s*[:,]?|:)\s*` + quote, "gi")
+  ];
+  const out = [];
+  for (const pattern of patterns) {
+    for (const m of body.matchAll(pattern)) {
+      const q = m[1].trim();
+      if (q.length >= 3 && !/^not given\b/i.test(q) && !out.includes(q)) out.push(q);
+    }
+  }
+  return out;
+}
+function specCheckProblems(root, spec, then, owner, decisions) {
+  if (spec.body === then) return [];
+  const problems = [];
+  const held = new Set(ownerQuotes(then));
+  const sources = [owner, then, decisions].join("\n");
+  const unheld = ownerQuotes(spec.body).filter((q) => !held.has(q) && !quoteHeld(q, sources));
+  if (unheld.length) {
+    problems.push(
+      `${spec.path} gives ${unheld.length === 1 ? "a quotation" : `${unheld.length} quotations`} as the owner's that the owner's words do not hold: ${unheld.slice(0, 3).map((q) => `"${q.length > 80 ? `${q.slice(0, 80)}\u2026` : q}"`).join(", ")}. Quote the owner as they said it, or say it in your own words without quotation marks and ask them.`
+    );
+  }
+  const recordPath = `.jig/specs/${spec.slug}.checked.json`;
+  let record;
+  try {
+    record = JSON.parse(readFileSync34(join41(root, recordPath), "utf8"));
+  } catch {
+    problems.push(
+      `${recordPath} is missing. Before the owner is asked to confirm, a reader who did not write the spec checks its quotations against the owner's words and its facts against their sources, and writes that record (step 3c). The owner checks the spec by the sheet it gives them.`
+    );
+    return problems;
+  }
+  if (record.spec !== specChecksum(spec.body)) {
+    problems.push(`${recordPath} is of an earlier spec: the spec changed after it was checked. Have the spec as it stands checked again; the owner confirms what was checked.`);
+  }
+  if (!Array.isArray(record.quotes) || !Array.isArray(record.facts)) {
+    problems.push(`${recordPath} needs \`quotes\` and \`facts\`, each a list: every quotation given as the owner's, and every statement of how something works with the source it was checked against.`);
+    return problems;
+  }
+  const facts = record.facts;
+  const incomplete = facts.filter((f) => typeof f?.claim !== "string" || typeof f.source !== "string" || !f.source.trim() || ![true, false, "unchecked"].includes(f.holds));
+  if (incomplete.length) {
+    problems.push(`${recordPath}: ${incomplete.length} of its facts lack a \`claim\`, a \`source\` or a \`holds\` of true, false or "unchecked".`);
+  }
+  const wrong = facts.filter((f) => f?.holds === false);
+  if (wrong.length) {
+    problems.push(
+      `${spec.path} states ${wrong.length === 1 ? "a fact" : `${wrong.length} facts`} its reader found false at the source: ${wrong.slice(0, 3).map((f) => `"${String(f.claim)}" (${String(f.source)})`).join("; ")}. Fix the spec, then have it checked again, before the owner is asked.`
+    );
+  }
+  const unsaid = facts.filter((f) => f?.holds === "unchecked" && !(typeof f.note === "string" && f.note.trim()));
+  if (unsaid.length) problems.push(`${recordPath}: ${unsaid.length} unchecked ${unsaid.length === 1 ? "fact says" : "facts say"} nothing of why. Say in \`note\` why the source could not be opened; the owner opens it instead.`);
+  const missing = facts.map((f) => typeof f?.source === "string" ? f.source.trim() : "").filter((s) => s && !/^[a-z][a-z0-9+.-]*:\/\//i.test(s)).filter((s) => {
+    const [, file, line] = /^(.+?)(?::(\d+)(?:-\d+)?)?$/.exec(s) ?? [];
+    if (!file || !existsSync25(join41(root, file))) return true;
+    if (!line) return false;
+    try {
+      return Number(line) > readFileSync34(join41(root, file), "utf8").split("\n").length;
+    } catch {
+      return true;
+    }
+  });
+  if (missing.length) {
+    problems.push(`${recordPath} cites ${missing.length === 1 ? "a source" : "sources"} the project does not have: ${missing.slice(0, 4).join(", ")}. A fact is checked at a source that exists; name it as a path from the project root, or a URL.`);
+  }
+  return problems;
+}
+
+// src/commands/gate.ts
 var MAX_BLOCKS = 3;
 function lastJigInvocation(transcriptPath) {
-  if (!transcriptPath || !existsSync24(transcriptPath)) return void 0;
+  if (!transcriptPath || !existsSync26(transcriptPath)) return void 0;
   let text;
   try {
-    text = readFileSync32(transcriptPath, "utf8");
+    text = readFileSync35(transcriptPath, "utf8");
   } catch {
     return void 0;
   }
@@ -7251,18 +7571,42 @@ function lastJigInvocation(transcriptPath) {
     const content = entry.message?.content;
     const texts = typeof content === "string" ? [content] : Array.isArray(content) ? content.filter((b) => b?.type === "text" && typeof b.text === "string").map((b) => b.text) : [];
     for (const t of texts) {
-      const args = /<command-name>\/?jig<\/command-name>[\s\S]{0,200}?<command-args>([^<]*)<\/command-args>/.exec(t)?.[1] ?? /^\s*\/jig\s+([^\n]*)/.exec(t)?.[1];
+      const args = /<command-name>\/?jig<\/command-name>[\s\S]{0,200}?<command-args>([\s\S]*?)<\/command-args>/.exec(t)?.[1] ?? /^\s*\/jig\s+([^\n]*)/.exec(t)?.[1];
       const [command, surface] = (args ?? "").trim().split(/\s+/);
       if (command && /^[a-z]+$/i.test(command)) found = { command: command.toLowerCase(), ...surface && /^[\w.-]+$/.test(surface) ? { surface } : {} };
     }
   }
   return found;
 }
+function ownerWords(transcriptPath) {
+  if (!transcriptPath || !existsSync26(transcriptPath)) return "";
+  const said = [];
+  try {
+    for (const line of readFileSync35(transcriptPath, "utf8").split("\n")) {
+      if (!line.includes('"user"')) continue;
+      let entry;
+      try {
+        entry = JSON.parse(line);
+      } catch {
+        continue;
+      }
+      if (entry.type !== "user" || entry.isMeta) continue;
+      const content = entry.message?.content;
+      if (typeof content === "string") said.push(content);
+      else if (Array.isArray(content)) {
+        for (const b of content) if (b?.type === "text" && typeof b.text === "string") said.push(b.text);
+      }
+    }
+  } catch {
+    return "";
+  }
+  return said.join("\n");
+}
 function lastAssistantText(transcriptPath) {
-  if (!transcriptPath || !existsSync24(transcriptPath)) return void 0;
+  if (!transcriptPath || !existsSync26(transcriptPath)) return void 0;
   let found;
   try {
-    for (const line of readFileSync32(transcriptPath, "utf8").split("\n")) {
+    for (const line of readFileSync35(transcriptPath, "utf8").split("\n")) {
       if (!line.includes('"assistant"')) continue;
       let entry;
       try {
@@ -7286,9 +7630,9 @@ function asksOwner(text) {
 }
 var ASKS_THE_OWNER = /* @__PURE__ */ new Set(["decide", "spec", "mockup", "tweak"]);
 function sessionStart(transcriptPath) {
-  if (!transcriptPath || !existsSync24(transcriptPath)) return void 0;
+  if (!transcriptPath || !existsSync26(transcriptPath)) return void 0;
   try {
-    for (const line of readFileSync32(transcriptPath, "utf8").split("\n")) {
+    for (const line of readFileSync35(transcriptPath, "utf8").split("\n")) {
       const m = /"timestamp"\s*:\s*"([^"]+)"/.exec(line);
       if (m) {
         const t = Date.parse(m[1]);
@@ -7303,20 +7647,20 @@ function verdictsMtime(dir) {
   let newest = 0;
   for (const name of VERDICT_FILES) {
     try {
-      newest = Math.max(newest, statSync5(join39(dir, name)).mtimeMs);
+      newest = Math.max(newest, statSync5(join42(dir, name)).mtimeMs);
     } catch {
     }
   }
   return newest;
 }
 function surfacesInPlay(root, command, transcriptPath, surface) {
-  const critiqueDir = join39(root, ".jig", "critique");
-  if (!existsSync24(critiqueDir)) return [];
-  const all = readdirSync15(critiqueDir, { withFileTypes: true }).filter((d) => d.isDirectory() && !d.name.startsWith("_") && !d.name.startsWith(".")).map((d) => d.name);
+  const critiqueDir = join42(root, ".jig", "critique");
+  if (!existsSync26(critiqueDir)) return [];
+  const all = readdirSync16(critiqueDir, { withFileTypes: true }).filter((d) => d.isDirectory() && !d.name.startsWith("_") && !d.name.startsWith(".")).map((d) => d.name);
   const start = sessionStart(transcriptPath);
   if (start === void 0) return all;
   const current = command === "critique" || command === "tweak" ? specFor(root, surface)?.slug : void 0;
-  return all.filter((s) => s === current || verdictsMtime(join39(critiqueDir, s)) >= start - 1e3);
+  return all.filter((s) => s === current || verdictsMtime(join42(critiqueDir, s)) >= start - 1e3);
 }
 function surfacesToProbe(root, input) {
   const invocation = lastJigInvocation(input.transcript_path);
@@ -7339,7 +7683,7 @@ function changedOutsideRecords(root, start) {
     const changed = git(["diff", "--name-only", base, "--", ".", ":(exclude).jig"]).split("\n").filter(Boolean);
     const created = git(["ls-files", "--others", "--exclude-standard", "--", ".", ":(exclude).jig"]).split("\n").filter(Boolean).filter((f) => {
       try {
-        return start === void 0 || statSync5(join39(root, f)).mtimeMs >= start - 1e3;
+        return start === void 0 || statSync5(join42(root, f)).mtimeMs >= start - 1e3;
       } catch {
         return false;
       }
@@ -7355,19 +7699,19 @@ function drawingChangedAfterApproval(root, specPath, at) {
     const approvedIn = git(["log", "-1", "--format=%H", "-G", "^mockup[[:space:]]*:[[:space:]]*approved", "--", specPath]).trim();
     if (!approvedIn) return void 0;
     const then = git(["show", `${approvedIn}:./${at}`]);
-    return then !== readFileSync32(join39(root, at), "utf8") ? approvedIn.slice(0, 7) : void 0;
+    return then !== readFileSync35(join42(root, at), "utf8") ? approvedIn.slice(0, 7) : void 0;
   } catch {
     return void 0;
   }
 }
-function commandProblems(root, command, surface, start) {
+function commandProblems(root, command, surface, start, owner = "") {
   const problems = [];
   const spec = specFor(root, surface);
   if (command === "decide") {
     const found = decisionsFile(root);
     if (!found) problems.push("decide wrote no DECISIONS.md beside the token layer.");
     else {
-      const body = readFileSync32(join39(root, found), "utf8");
+      const body = readFileSync35(join42(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.`");
       }
@@ -7382,6 +7726,10 @@ function commandProblems(root, command, surface, start) {
       if (problems.length === 0) problems.push(...navProblems(spec));
     }
   }
+  if (command === "spec" && spec) problems.push(...specChecked(root, spec, start, owner));
+  if ((command === "spec" || command === "mockup" || command === "make") && spec) {
+    problems.push(...mockupWordProblems(spec, fileAtSessionStart(root, spec.path, start), owner));
+  }
   if (command === "mockup" && spec) {
     const front = spec.body.split(/^---\s*$/m)[1] ?? "";
     const mockup = /^\s*mockup\s*:\s*(.+)$/im.exec(front)?.[1]?.trim() ?? "";
@@ -7389,12 +7737,12 @@ function commandProblems(root, command, surface, start) {
     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) && !existsSync24(join39(root, at))) problems.push(`${spec.path}: \`mockup_at: ${at}\` does not exist.`);
+      else if (!/^https?:/i.test(at) && !existsSync26(join42(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 (at && /\.html?$/i.test(at) && existsSync24(join39(root, at))) problems.push(...mockupDrawingProblems(root, spec.body, at));
+    if (at && /\.html?$/i.test(at) && existsSync26(join42(root, at))) problems.push(...mockupDrawingProblems(root, spec.body, at));
   }
-  if (command === "tweak" && spec) problems.push(...tweakProblems(root, spec));
+  if (command === "tweak" && spec) problems.push(...tweakProblems(root, spec, owner));
   if ((command === "spec" || command === "make") && spec) {
     const front = spec.body.split(/^---\s*$/m)[1] ?? "";
     const mockup = /^\s*mockup\s*:\s*(\S+)/im.exec(front)?.[1] ?? "";
@@ -7420,7 +7768,7 @@ function commandProblems(root, command, surface, start) {
     const front = spec.body.split(/^---\s*$/m)[1] ?? "";
     const mockup = /^\s*mockup\s*:\s*(\S+)/im.exec(front)?.[1] ?? "";
     const at = /^\s*mockup_at\s*:\s*(.+)$/im.exec(front)?.[1]?.trim().replace(/^["']|["']$/g, "") ?? "";
-    if (/^approved/i.test(mockup) && at && !/^https?:/i.test(at) && existsSync24(join39(root, at))) {
+    if (/^approved/i.test(mockup) && at && !/^https?:/i.test(at) && existsSync26(join42(root, at))) {
       const changedAfter = drawingChangedAfterApproval(root, spec.path, at);
       if (changedAfter) {
         problems.push(`${at} has changed since the owner approved it (${changedAfter}). An approval is of the drawing as the owner saw it: set \`mockup: pending\` in ${spec.path} and ask again.`);
@@ -7432,7 +7780,7 @@ function commandProblems(root, command, surface, start) {
     if (found) {
       let now = "";
       try {
-        now = readFileSync32(join39(root, found), "utf8");
+        now = readFileSync35(join42(root, found), "utf8");
       } catch {
       }
       const then = fileAtSessionStart(root, found, start);
@@ -7446,13 +7794,13 @@ function commandProblems(root, command, surface, start) {
     if (found) {
       let now = "";
       try {
-        now = readFileSync32(join39(root, found), "utf8");
+        now = readFileSync35(join42(root, found), "utf8");
       } catch {
       }
       const then = fileAtSessionStart(root, found, start);
       if (now && now !== then) {
         problems.push(...unsourcedReasons(now, then, { newWhysOnly: true }).map((p) => `${found}: ${p}`));
-        const change = readTweak(join39(root, ".jig", "critique", spec.slug))?.change;
+        const change = readTweak(join42(root, ".jig", "critique", spec.slug))?.change;
         if (change) problems.push(...quotesNotFrom(now, then, change).map((p) => `${found}: ${p}`));
       }
     }
@@ -7461,7 +7809,7 @@ function commandProblems(root, command, surface, start) {
     for (const file of modeFiles(root)) {
       let now = "";
       try {
-        now = readFileSync32(join39(root, file), "utf8");
+        now = readFileSync35(join42(root, file), "utf8");
       } catch {
         continue;
       }
@@ -7472,8 +7820,8 @@ function commandProblems(root, command, surface, start) {
     }
   }
   if (command === "critique") {
-    const dir = join39(root, ".jig", "critique");
-    const surfaces = existsSync24(dir) ? readdirSync15(dir).filter((s) => existsSync24(join39(dir, s, "screen.json")) || existsSync24(join39(dir, s, "code.json"))) : [];
+    const dir = join42(root, ".jig", "critique");
+    const surfaces = existsSync26(dir) ? readdirSync16(dir).filter((s) => existsSync26(join42(dir, s, "screen.json")) || existsSync26(join42(dir, s, "code.json"))) : [];
     for (const surface2 of surfaces) {
       const v = verifyVerdicts({ projectRoot: root, surface: surface2 });
       if (v.ok && v.decisions.state !== "ran" && v.decisions.total > 0) {
@@ -7484,7 +7832,7 @@ function commandProblems(root, command, surface, start) {
       }
     }
     const own = specFor(root, surface)?.slug;
-    if (own && surfaces.includes(own)) problems.push(...reportOmissions(join39(dir, own), own));
+    if (own && surfaces.includes(own)) problems.push(...reportOmissions(join42(dir, own), own));
     if (surfaces.length === 0) {
       problems.push("critique wrote no verdict files. Each reader arm writes .jig/critique/<surface>/screen.json or code.json, and `jig verdicts <surface>` \u2014 not your own count \u2014 decides whether the review is complete. A report without them is not a review.");
     }
@@ -7497,13 +7845,22 @@ function drawingBeforeAsking(root, surface) {
   const front = spec.body.split(/^---\s*$/m)[1] ?? "";
   const named = /^\s*mockup_at\s*:\s*(.+)$/im.exec(front)?.[1]?.trim().replace(/^["']|["']$/g, "") ?? "";
   const at = named || `.jig/mockups/${spec.slug}.html`;
-  if (/^https?:/i.test(at) || !/\.html?$/i.test(at) || !existsSync24(join39(root, at))) return [];
+  if (/^https?:/i.test(at) || !/\.html?$/i.test(at) || !existsSync26(join42(root, at))) return [];
   const found = mockupDrawingProblems(root, spec.body, at);
   return found.length ? [`Fix the drawing before you put it to the owner; they approve what the spec lists, drawn. ${found.join(" ")}`] : [];
 }
+function specChecked(root, spec, start, owner) {
+  const found = decisionsFile(root);
+  let decisions = "";
+  try {
+    if (found) decisions = readFileSync35(join42(root, found), "utf8");
+  } catch {
+  }
+  return specCheckProblems(root, spec, fileAtSessionStart(root, spec.path, start), owner, decisions);
+}
 function modeFiles(root) {
   try {
-    const state = JSON.parse(readFileSync32(join39(root, ".jig", "state.json"), "utf8"));
+    const state = JSON.parse(readFileSync35(join42(root, ".jig", "state.json"), "utf8"));
     return Object.keys(state.files ?? {}).filter((f) => /(^|\/)mode\.[\w-]+\.css$/.test(f));
   } catch {
     return [];
@@ -7512,7 +7869,7 @@ function modeFiles(root) {
 function reportOmissions(dir, surface) {
   let report2;
   try {
-    report2 = readFileSync32(join39(dir, "REPORT.md"), "utf8").toLowerCase();
+    report2 = readFileSync35(join42(dir, "REPORT.md"), "utf8").toLowerCase();
   } catch {
     return [];
   }
@@ -7520,7 +7877,7 @@ function reportOmissions(dir, surface) {
   for (const f of VERDICT_FILES) {
     let file;
     try {
-      file = JSON.parse(readFileSync32(join39(dir, f), "utf8"));
+      file = JSON.parse(readFileSync35(join42(dir, f), "utf8"));
     } catch {
       continue;
     }
@@ -7533,7 +7890,7 @@ function reportOmissions(dir, surface) {
   if (!missing.length) return [];
   return [`.jig/critique/${surface}/REPORT.md leaves out ${missing.length === 1 ? "a finding" : `${missing.length} findings`} the verdict files hold: ${missing.slice(0, 8).join(", ")}. The report is what the owner and \`make\` read; name every finding in it, by id (a decision by its name).`];
 }
-function tweakProblems(root, spec) {
+function tweakProblems(root, spec, owner = "") {
   const problems = [];
   const front = spec.body.split(/^---\s*$/m)[1] ?? "";
   if (!/^\s*confirmed\s*:\s*true\b/im.test(front)) problems.push(`${spec.path} is not confirmed. A tweak changes a page the owner has confirmed; an unconfirmed spec goes through \`spec\`.`);
@@ -7541,13 +7898,21 @@ function tweakProblems(root, spec) {
   if (!/^(approved|skipped)/i.test(mockup)) problems.push(`${spec.path}: \`mockup:\` is ${mockup || "empty"}. A tweak changes a page whose drawing the owner has approved (or skipped); take a new page through \`mockup\` and \`make\`.`);
   else problems.push(...structureSinceApproval(root, spec, front));
   const surface = spec.slug;
-  const record = readTweak(join39(root, ".jig", "critique", surface));
+  const record = readTweak(join42(root, ".jig", "critique", surface));
   if (!record) {
     problems.push(`.jig/critique/${surface}/tweak.json is missing. It names the change in the owner's words (\`change\`), when it was made (\`at\`) and the rule ids and decisions re-judged for it (\`ids\`).`);
   } else {
     if (!record.change) problems.push(`.jig/critique/${surface}/tweak.json has no \`change\`: the owner's words for what changed.`);
     if (!record.ids.length) problems.push(`.jig/critique/${surface}/tweak.json names nothing to re-judge. A change that no rule and no decision could see needs no tweak; name the ones it can.`);
-    const unjudged = unjudgedTweakIds(join39(root, ".jig", "critique", surface), record);
+    if (record.deferred !== void 0) {
+      if (typeof record.deferred === "string" ? !record.deferred.trim() || !quoteHeld(record.deferred.replace(/^["“]|["”]$/g, ""), owner) : !critiqueAtShip(root, spec.body)) {
+        problems.push(
+          `.jig/critique/${surface}/tweak.json defers its re-judge, and nobody said to. \`deferred\` quotes the owner telling you to leave it for later, or is \`true\` where the page's spec says \`critique: at-ship\` (or, the spec silent, jig.config.json says \`"critique": "at-ship"\`). Otherwise re-judge what it names.`
+        );
+      }
+      return problems;
+    }
+    const unjudged = unjudgedTweakIds(join42(root, ".jig", "critique", surface), record);
     if (unjudged.length) {
       problems.push(
         `.jig/critique/${surface}: tweak.json names ${unjudged.slice(0, 6).join(", ")}${unjudged.length > 6 ? " and more" : ""} but no verdict for ${unjudged.length === 1 ? "it" : "them"} carries \`"tweak": "${record.at}"\`. Each named verdict is re-judged on the changed page by a reader that did not make the change.`
@@ -7583,9 +7948,9 @@ function structureSinceApproval(root, spec, front) {
     problems.push(`${spec.path}: the regions under \`sizes:\` differ from the ones the page had ${when}. A change to what the page holds is not a tweak: take it through \`spec\` and \`mockup\`.`);
   }
   const at = /^\s*mockup_at\s*:\s*(.+)$/im.exec(front)?.[1]?.trim().replace(/^["']|["']$/g, "");
-  if (at && !/^https?:/i.test(at) && existsSync24(join39(root, at))) {
+  if (at && !/^https?:/i.test(at) && existsSync26(join42(root, at))) {
     try {
-      if (git(["show", `${baseline}:./${at}`]) !== readFileSync32(join39(root, at), "utf8")) {
+      if (git(["show", `${baseline}:./${at}`]) !== readFileSync35(join42(root, at), "utf8")) {
         problems.push(`${at} has changed since ${when.replace(/^when /, "")}. A tweak leaves the drawing as approved; a change the drawing must show goes through \`mockup\`.`);
       }
     } catch {
@@ -7595,8 +7960,9 @@ function structureSinceApproval(root, spec, front) {
 }
 function readTweak(dir) {
   try {
-    const raw = JSON.parse(readFileSync32(join39(dir, "tweak.json"), "utf8"));
-    return { at: String(raw.at ?? ""), change: String(raw.change ?? "").trim(), ids: Array.isArray(raw.ids) ? raw.ids.map(String) : [] };
+    const raw = JSON.parse(readFileSync35(join42(dir, "tweak.json"), "utf8"));
+    const deferred = typeof raw.deferred === "string" || raw.deferred === true ? raw.deferred : void 0;
+    return { at: String(raw.at ?? ""), change: String(raw.change ?? "").trim(), ids: Array.isArray(raw.ids) ? raw.ids.map(String) : [], ...deferred !== void 0 ? { deferred } : {} };
   } catch {
     return void 0;
   }
@@ -7607,20 +7973,37 @@ 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 && existsSync24(join39(projectRoot, candidate))) return candidate;
+    if (candidate && existsSync26(join42(projectRoot, candidate))) return candidate;
   }
   return void 0;
 }
 function gate(opts) {
   const root = opts.projectRoot;
-  if (!existsSync24(join39(root, "jig.config.json")) && !existsSync24(join39(root, ".jig"))) {
+  if (!existsSync26(join42(root, "jig.config.json")) && !existsSync26(join42(root, ".jig"))) {
     return { block: false, reason: "" };
   }
   const invocation = lastJigInvocation(opts.input.transcript_path);
   const command = invocation?.command;
   const waiting = command !== void 0 && ASKS_THE_OWNER.has(command) && asksOwner(lastAssistantText(opts.input.transcript_path));
-  const problems = command && !waiting ? commandProblems(root, command, invocation?.surface, sessionStart(opts.input.transcript_path)).map((p) => `/jig ${command}: ${p}`) : [];
+  const start = sessionStart(opts.input.transcript_path);
+  const owner = command === "spec" || command === "mockup" || command === "make" || command === "tweak" ? ownerWords(opts.input.transcript_path) : "";
+  const problems = command && !waiting ? commandProblems(root, command, invocation?.surface, start, owner).map((p) => `/jig ${command}: ${p}`) : [];
   if (waiting && command === "mockup") problems.push(...drawingBeforeAsking(root, invocation?.surface).map((p) => `/jig mockup: ${p}`));
+  if (command === "ship" && !asksOwner(lastAssistantText(opts.input.transcript_path))) {
+    const result = ship({ projectRoot: root, version: opts.version });
+    if (!result.ready) problems.push(`/jig ship: the project is not ready to ship. Critique what is owed, fix what the critiques find or record the owner's ruling, and run \`jig ship\` again.
+${result.report}`);
+  }
+  if (command === "make") {
+    const spec = specFor(root, invocation?.surface);
+    if (spec && mockupPending(spec.body) && !asksOwner(lastAssistantText(opts.input.transcript_path))) {
+      problems.push(`/jig make: ${spec.path} still says \`mockup: pending\`: nobody has said whether to draw it. Ask the owner, draw it with \`/jig mockup\` or skip it; if they skip it, write \`mockup: skipped \u2014 "<their words>"\` and build from the spec alone.`);
+    }
+  }
+  if (waiting && command === "spec") {
+    const spec = specFor(root, invocation?.surface);
+    if (spec) problems.push(...specChecked(root, spec, start, owner).map((p) => `/jig spec: ${p}`));
+  }
   const selection = selectFiles(root, false);
   const changedUi = selection.mode === "changed" && selection.files.some((f) => isStyleBearing(f) || isReaderText(f));
   if (changedUi) {
@@ -7642,11 +8025,11 @@ function gate(opts) {
     }
   }
   problems.push(...verdictGuard(root, command, surfacesInPlay(root, command, opts.input.transcript_path, invocation?.surface)));
-  const critiqueDir = join39(root, ".jig", "critique");
-  if (existsSync24(critiqueDir)) {
+  const critiqueDir = join42(root, ".jig", "critique");
+  if (existsSync26(critiqueDir)) {
     for (const surface of surfacesInPlay(root, command, opts.input.transcript_path, invocation?.surface)) {
-      const dir = join39(critiqueDir, surface);
-      if (!existsSync24(join39(dir, "screen.json")) && !existsSync24(join39(dir, "code.json"))) continue;
+      const dir = join42(critiqueDir, surface);
+      if (!existsSync26(join42(dir, "screen.json")) && !existsSync26(join42(dir, "code.json"))) continue;
       const v = verifyVerdicts({ projectRoot: root, surface });
       if (!v.ok) {
         const shown = v.errors.slice(0, 6).map((e) => `  ${e}`);
@@ -7668,11 +8051,11 @@ ${problems.join("\n\n")}`
     };
   }
   const session = opts.input.session_id ?? "unknown";
-  const key = `${session}:${createHash2("sha256").update(problems.join("\n")).digest("hex").slice(0, 12)}`;
-  const stateFile = join39(root, ".jig", "gate.json");
+  const key = `${session}:${createHash3("sha256").update(problems.join("\n")).digest("hex").slice(0, 12)}`;
+  const stateFile = join42(root, ".jig", "gate.json");
   let state = {};
   try {
-    state = JSON.parse(readFileSync32(stateFile, "utf8"));
+    state = JSON.parse(readFileSync35(stateFile, "utf8"));
   } catch {
   }
   if (problems.length === 0) {
@@ -7707,7 +8090,7 @@ function verdictDigests(dir) {
   for (const f of VERDICT_FILES) {
     let file;
     try {
-      file = JSON.parse(readFileSync32(join39(dir, f), "utf8"));
+      file = JSON.parse(readFileSync35(join42(dir, f), "utf8"));
     } catch {
       continue;
     }
@@ -7718,9 +8101,16 @@ function verdictDigests(dir) {
   }
   return out;
 }
-function writeLock(lockPath, dir, now) {
+function writeLock(root, surface, lockPath, dir, now) {
+  const pageFile2 = recordedPage(root, surface);
+  let page;
+  try {
+    if (pageFile2) page = { file: pageFile2, checksum: pageChecksum(readFileSync35(join42(root, pageFile2), "utf8")) };
+  } catch {
+  }
+  const tweakAt = readTweak(dir)?.at;
   try {
-    writeFileSync6(lockPath, JSON.stringify({ checksum: now, verdicts: verdictDigests(dir) }) + "\n", "utf8");
+    writeFileSync6(lockPath, JSON.stringify({ checksum: now, verdicts: verdictDigests(dir), ...page ? { page } : {}, ...tweakAt ? { tweak: tweakAt } : {} }) + "\n", "utf8");
   } catch {
   }
 }
@@ -7728,7 +8118,7 @@ function verdictChecksum(dir) {
   const parts = VERDICT_FILES.map((f) => {
     try {
       return `${f}
-${readFileSync32(join39(dir, f), "utf8")}`;
+${readFileSync35(join42(dir, f), "utf8")}`;
     } catch {
       return "";
     }
@@ -7736,23 +8126,23 @@ ${readFileSync32(join39(dir, f), "utf8")}`;
   return parts.some(Boolean) ? checksum(parts.join("\n")) : void 0;
 }
 function verdictGuard(root, command, inPlay) {
-  const critiqueDir = join39(root, ".jig", "critique");
-  if (!existsSync24(critiqueDir)) return [];
+  const critiqueDir = join42(root, ".jig", "critique");
+  if (!existsSync26(critiqueDir)) return [];
   const problems = [];
-  for (const surface of readdirSync15(critiqueDir)) {
+  for (const surface of readdirSync16(critiqueDir)) {
     if (surface.startsWith("_")) continue;
-    const dir = join39(critiqueDir, surface);
+    const dir = join42(critiqueDir, surface);
     const now = verdictChecksum(dir);
     if (!now) continue;
-    const lockPath = join39(dir, LOCK);
-    if (command === "critique" && (!inPlay || inPlay.includes(surface))) {
-      writeLock(lockPath, dir, now);
+    const lockPath = join42(dir, LOCK);
+    if ((command === "critique" || command === "ship") && (!inPlay || inPlay.includes(surface))) {
+      writeLock(root, surface, lockPath, dir, now);
       problems.push(...lockLeftBehind(root, surface));
       continue;
     }
     let lock = {};
     try {
-      lock = JSON.parse(readFileSync32(lockPath, "utf8"));
+      lock = JSON.parse(readFileSync35(lockPath, "utf8"));
     } catch {
       continue;
     }
@@ -7761,7 +8151,7 @@ function verdictGuard(root, command, inPlay) {
       const own = tweakVerdictProblems(dir, surface, lock.verdicts);
       problems.push(...own);
       if (own.length === 0) {
-        writeLock(lockPath, dir, now);
+        writeLock(root, surface, lockPath, dir, now);
         problems.push(...lockLeftBehind(root, surface));
       }
       continue;
@@ -7809,7 +8199,7 @@ function unjudgedTweakIds(dir, record) {
   for (const f of VERDICT_FILES) {
     let file;
     try {
-      file = JSON.parse(readFileSync32(join39(dir, f), "utf8"));
+      file = JSON.parse(readFileSync35(join42(dir, f), "utf8"));
     } catch {
       continue;
     }
@@ -7821,112 +8211,15 @@ function unjudgedTweakIds(dir, record) {
 }
 function save(file, state) {
   try {
-    mkdirSync8(join39(file, ".."), { recursive: true });
+    mkdirSync8(join42(file, ".."), { recursive: true });
     writeFileSync6(file, JSON.stringify(state), "utf8");
   } catch {
   }
 }
 
-// src/commands/seo.ts
-import { readFileSync as readFileSync33 } from "fs";
-import { join as join40 } 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 = readFileSync33(join40(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(readFileSync34(join41(packageRoot, "package.json"), "utf8"));
+var { version } = JSON.parse(readFileSync36(join43(packageRoot, "package.json"), "utf8"));
 function warnIfUnpublishedPin() {
   if (isDevVersion(version)) {
     console.warn(
@@ -8107,6 +8400,17 @@ program.command("seo").description("Audit what a search engine and a link previe
     process.exit(1);
   }
 });
+program.command("ship").description("Say whether the project is ready to ship: no mechanical or seo errors, and every confirmed page judged as it stands with nothing open.").action(() => {
+  const projectRoot = findProjectRoot(process.cwd());
+  try {
+    const result = ship({ projectRoot, version });
+    console.log(result.report);
+    process.exit(result.ready ? 0 : 1);
+  } 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, 1280 and 1600 and either side of each --breakpoint-* the project declares, 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) {
@@ -8149,7 +8453,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(readFileSync34(0, "utf8") || "{}");
+    if (!process.stdin.isTTY) input = JSON.parse(readFileSync36(0, "utf8") || "{}");
   } catch {
   }
   const cwd = input.cwd ?? process.cwd();
@@ -8189,7 +8493,7 @@ program.command("init").description("Set the project up to use Jig: a brand file
 });
 function resolveSurfaceMode(projectRoot) {
   try {
-    const config = JSON.parse(readFileSync34(join41(projectRoot, "jig.config.json"), "utf8"));
+    const config = JSON.parse(readFileSync36(join43(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 {