jig-ui 0.20.1 → 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";
@@ -40,6 +40,14 @@ function assetRoot(startDir = getPackageRoot()) {
 function isPublishedBuild(packageRoot2) {
   return packageRoot2.split(/[\\/]/).includes("node_modules");
 }
+function isDevVersion(version2) {
+  return !!version2 && /-dev(\.|$)/.test(version2);
+}
+function cliInvocation(version2) {
+  if (!version2) return "npx jig-ui";
+  return isDevVersion(version2) ? "jig" : `npx jig-ui@${version2}`;
+}
+var JIG_GATE_HOOK = /(?:\bjig-ui@[^\s"]+|^jig) gate\b/;
 
 // src/commands/install.ts
 import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
@@ -578,7 +586,7 @@ function buildSkillBody(packageRoot2, rulesPath, version2) {
   );
   return render(template, {
     command_prefix: "/jig ",
-    scripts_path: version2 ? `npx jig-ui@${version2}` : "npx jig-ui",
+    scripts_path: cliInvocation(version2),
     // `update` must NOT carry the pin. Pinned, it refreshes to the version
     // already installed — reporting "Updated Jig → <same version>" for a no-op
     // — so a reader following the skill could never upgrade.
@@ -597,7 +605,7 @@ function buildCommandBody(packageRoot2, rulesPath, version2, argsPlaceholder) {
   const templatePath = join7(packageRoot2, "templates", "COMMAND.md.tmpl");
   if (!existsSync5(templatePath)) return { body: "", subcommands };
   const template = readFileSync4(templatePath, "utf8");
-  const body = template.replace(/\{\{command_prefix\}\}/g, "/jig ").replace(/\{\{args_placeholder\}\}/g, argsPlaceholder).replace(/\{\{subcommand_list\}\}/g, subcommands.join(", ")).replace(/\{\{scripts_path\}\}/g, `npx jig-ui@${version2}`).replace(/\{\{update_path\}\}/g, "npx jig-ui@latest").replace(/\{\{rules_path\}\}/g, rulesPath).replace(/\{\{config_file\}\}/g, "jig.config.json");
+  const body = template.replace(/\{\{command_prefix\}\}/g, "/jig ").replace(/\{\{args_placeholder\}\}/g, argsPlaceholder).replace(/\{\{subcommand_list\}\}/g, subcommands.join(", ")).replace(/\{\{scripts_path\}\}/g, cliInvocation(version2)).replace(/\{\{update_path\}\}/g, "npx jig-ui@latest").replace(/\{\{rules_path\}\}/g, rulesPath).replace(/\{\{config_file\}\}/g, "jig.config.json");
   const unresolved = [...new Set(body.match(/\{\{[a-z_]+\}\}/g) ?? [])];
   if (unresolved.length > 0) {
     throw new Error(
@@ -724,7 +732,8 @@ function install(opts) {
 function hasStopHook(projectRoot) {
   try {
     const settings = readFileSync4(join7(projectRoot, ".claude", "settings.json"), "utf8");
-    return /\bjig-ui@[^\s"]+ gate\b/.test(settings);
+    const hooks = JSON.parse(settings).hooks?.Stop ?? [];
+    return hooks.some((group) => (group.hooks ?? []).some((h) => JIG_GATE_HOOK.test(h.command ?? "")));
   } catch {
     return false;
   }
@@ -739,9 +748,9 @@ function installStopHook(projectRoot, version2) {
       return false;
     }
   }
-  const command = `npx --yes jig-ui@${version2} gate`;
+  const command = isDevVersion(version2) ? "jig gate" : `npx --yes jig-ui@${version2} gate`;
   const hooks = settings.hooks ?? {};
-  const isJig = (h) => /\bjig-ui@[^\s]+ gate\b/.test(h.command ?? "");
+  const isJig = (h) => JIG_GATE_HOOK.test(h.command ?? "");
   const stop = (hooks.Stop ?? []).map((group) => ({ ...group, hooks: group.hooks.filter((h) => !isJig(h)) })).filter((group) => group.hooks.length > 0);
   stop.push({ hooks: [{ type: "command", command }] });
   settings.hooks = { ...hooks, Stop: stop };
@@ -5340,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(
@@ -5367,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"));
@@ -5474,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");
@@ -5490,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.
@@ -5771,7 +5789,7 @@ import { fileURLToPath as fileURLToPath2 } from "url";
 import { join as join33, relative as relative3, resolve as resolve4, sep as sep5 } from "path";
 
 // src/probe/script.ts
-var PROBE_VERSION = 8;
+var PROBE_VERSION = 9;
 var PROBE_SCRIPT = `(async () => {
   const doc = document.documentElement;
   // checkVisibility also sees content a closed <details> hides: Chromium hides
@@ -5786,9 +5804,12 @@ var PROBE_SCRIPT = `(async () => {
   const text = document.body.innerText || '';
   // I-118: a verbatim quotation keeps its own punctuation. Text marked as a
   // quotation is the source's words, so it is taken out before the dash scan;
-  // the page's own copy around it still counts.
+  // the page's own copy around it still counts. So is a tool's output or a
+  // command shown in <pre>, <code>, <samp> or <kbd>: jig-site's home page
+  // quotes \`jig check\`'s real output, whose own wording has an em dash, and
+  // the probe blocked a page for words it had rightly not rewritten.
   let ownText = text;
-  for (const q of document.querySelectorAll('blockquote, q')) {
+  for (const q of document.querySelectorAll('blockquote, q, pre, code, samp, kbd')) {
     const quoted = (q.innerText || '').trim();
     if (quoted) ownText = ownText.split(quoted).join('\\n');
   }
@@ -6557,12 +6578,22 @@ function decisionSections(body) {
   close();
   return sections;
 }
-function unsourcedReasons(current, before) {
+function changedWhys(current, before, newOnly = false) {
   const then = decisionSections(before);
-  const problems = [];
+  const paragraphs = (text) => text.split(/\n\s*\n/).map((p) => p.trim()).filter((p) => /^\*\*Why\b[^*]*:\*\*/.test(p));
+  const out = [];
   for (const [name, text] of decisionSections(current)) {
-    if (then.get(name) === text) continue;
-    const whys = text.split(/\n\s*\n/).filter((p) => /^\s*\*\*Why\b[^*]*:\*\*/.test(p));
+    const old = then.get(name);
+    if (old === text) continue;
+    const kept = newOnly && old !== void 0 ? new Set(paragraphs(old)) : /* @__PURE__ */ new Set();
+    const whys = paragraphs(text).filter((p) => !kept.has(p));
+    if (whys.length) out.push([name, whys]);
+  }
+  return out;
+}
+function unsourcedReasons(current, before, opts = {}) {
+  const problems = [];
+  for (const [name, whys] of changedWhys(current, before, opts.newWhysOnly)) {
     for (const why of whys) {
       const label = /^\s*\*\*(Why\b[^*]*):\*\*/.exec(why)[1];
       const said = why.replace(/^\s*\*\*Why\b[^*]*:\*\*/, "").trim();
@@ -6575,6 +6606,26 @@ function unsourcedReasons(current, before) {
   }
   return problems;
 }
+function quotesNotFrom(current, before, 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) => !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;
+      }
+    }
+  }
+  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";
@@ -6605,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}:\`.`);
   }
@@ -6615,7 +6670,7 @@ function specProblems(spec) {
       problems.push(`${spec.path} has no \`${size}:\` composition under \`sizes:\`. Every size is written in full, phone first; \`same-as:\` needs a \`why:\`.`);
       continue;
     }
-    if (line[1].trim()) {
+    if (line[1].replace(/(^|\s)#.*$/, "").trim()) {
       problems.push(`${spec.path}: \`${size}:\` is a one-line description. A size is a composition \u2014 \`regions:\` in order, \`hierarchy:\`, \`nav:\` \u2014 each on its own line, or \`same-as:\` with a \`why:\`.`);
       continue;
     }
@@ -6918,10 +6973,12 @@ function previousFindings(projectRoot, dir) {
   const files = ["screen.json", "code.json", "decisions.json"];
   const paths = files.map((f) => `${rel}/${f}`);
   let commit;
+  let target;
   try {
     const dirty = git(["status", "--porcelain", "--", ...paths]).trim() !== "";
     const touched = git(["log", "--format=%H", "-2", "--", ...paths]).split("\n").filter(Boolean);
     commit = dirty ? touched[0] ?? "" : touched[1] ?? "";
+    target = dirty ? void 0 : touched[0];
   } catch {
     return void 0;
   }
@@ -6942,7 +6999,7 @@ function previousFindings(projectRoot, dir) {
     }
     for (const v of Array.isArray(body.verdicts) ? body.verdicts : []) {
       const key = String(v.id ?? v.decision ?? "").trim();
-      if (key && typeof v.verdict === "string") out.set(f === "decisions.json" ? `"${key}"` : key.toUpperCase(), v.verdict);
+      if (key && typeof v.verdict === "string") out.set(f === "decisions.json" ? `"${key}"` : key.toUpperCase(), { verdict: v.verdict, reason: String(v.reason ?? "") });
     }
     return out;
   };
@@ -6952,22 +7009,69 @@ function previousFindings(projectRoot, dir) {
     for (const [k, v] of read(f, commit)) before.set(k, v);
     for (const [k, v] of read(f)) now.set(k, v);
   }
-  const result = { commit: commit.slice(0, 7), fixed: [], open: [], added: [], ruled: [] };
+  const changed = sourceChanges(git, commit, target);
+  const result = { commit: commit.slice(0, 7), fixed: [], unchanged: [], open: [], added: [], ruled: [] };
   for (const [k, v] of before) {
-    if (v !== "finding") continue;
-    const after = now.get(k);
+    if (v.verdict !== "finding") continue;
+    const after = now.get(k)?.verdict;
     if (after === "finding") result.open.push(k);
     else if (after === "ruled") result.ruled.push(k);
-    else if (after === "ok" || after === "n/a") result.fixed.push(k);
+    else if (after === "ok" || after === "n/a") (changed(v.reason) ? result.fixed : result.unchanged).push(k);
   }
-  for (const [k, v] of now) if (v === "finding" && before.get(k) !== "finding") result.added.push(k);
+  for (const [k, v] of now) if (v.verdict === "finding" && before.get(k)?.verdict !== "finding") result.added.push(k);
   return result;
 }
+var CITATION = /([\w@.\-[\]/]*[\w\]-]\.[a-z][a-z0-9]{0,5})(?::(\d+(?:-\d+)?(?:,\s*\d+(?:-\d+)?)*))?/gi;
+function sourceChanges(git, from, to) {
+  const range = to ? [from, to] : [from];
+  let tracked = [];
+  let changedFiles = /* @__PURE__ */ new Set();
+  try {
+    tracked = git(["ls-tree", "-r", "--name-only", from]).split("\n").filter((f) => f && !f.startsWith(".jig/"));
+    changedFiles = new Set(git(["diff", "--name-only", ...range, "--", ".", ":(exclude).jig"]).split("\n").filter(Boolean));
+  } catch {
+  }
+  const hunks = /* @__PURE__ */ new Map();
+  const oldRanges = (file) => {
+    let out = hunks.get(file);
+    if (out) return out;
+    out = [];
+    try {
+      for (const m of git(["diff", "-U0", ...range, "--", file]).matchAll(/^@@ -(\d+)(?:,(\d+))? /gm)) {
+        const start = Number(m[1]);
+        const count = m[2] === void 0 ? 1 : Number(m[2]);
+        out.push(count === 0 ? [start, start + 1] : [start, start + count - 1]);
+      }
+    } catch {
+    }
+    hunks.set(file, out);
+    return out;
+  };
+  return (reason) => {
+    let cited = false;
+    for (const m of reason.matchAll(CITATION)) {
+      const path = m[1].replace(/^\.\//, "");
+      const matches2 = tracked.filter((f) => f === path || f.endsWith(`/${path}`));
+      if (!matches2.length) continue;
+      cited = true;
+      const lines = (m[2] ?? "").split(",").map((r) => r.trim()).filter(Boolean).map((r) => {
+        const [a, b] = r.split("-").map(Number);
+        return [a, b ?? a];
+      });
+      for (const file of matches2) {
+        if (!changedFiles.has(file)) continue;
+        if (!lines.length) return true;
+        if (oldRanges(file).some(([hs, he]) => lines.some(([s, e]) => hs <= e && he >= s))) return true;
+      }
+    }
+    return cited ? false : changedFiles.size > 0;
+  };
+}
 
 // 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";
@@ -7053,7 +7157,7 @@ function specSwitches(specBody) {
   return value.replace(/^\[|\]$/g, "").split(",").map((n) => n.trim().replace(/^["']|["']$/g, "").replace(/^(--)?breakpoint-/, "")).filter(Boolean);
 }
 function readFrames(html) {
-  const opens = [...html.matchAll(/<\w+\b[^>]*\bclass\s*=\s*["'][^"']*\bframe\b[^"']*["'][^>]*>/gi)];
+  const opens = [...html.matchAll(/<\w+\b[^>]*\bclass\s*=\s*["']([^"']*)["'][^>]*>/gi)].filter((m) => m[1].split(/\s+/).includes("frame"));
   return opens.map((open, i) => {
     const tag = open[0];
     const body = html.slice(open.index + tag.length, opens[i + 1]?.index ?? html.length);
@@ -7119,7 +7223,9 @@ function regionDrawn(labels, region) {
   const found = (name) => labels.some((label) => labelMatches(label, name) || labelMatches(stripQualifiers(label), name));
   return found(region.name) || !!region.parts && region.parts.every(found);
 }
-function labelMatches(label, name) {
+function labelMatches(rawLabel, rawName) {
+  const label = rawLabel.replace(/[-_]+/g, " ").replace(/\s+/g, " ").trim();
+  const name = rawName.replace(/[-_]+/g, " ").replace(/\s+/g, " ").trim();
   return label === name || label.startsWith(`${name} `) || label.startsWith(`${name}:`) || new RegExp(`\\b${name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\b`).test(label);
 }
 function normalise(text) {
@@ -7139,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;
   }
@@ -7161,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 {
@@ -7196,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]);
@@ -7213,20 +7647,24 @@ 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);
+  return surfacesInPlay(root, invocation?.command, input.transcript_path, invocation?.surface);
 }
 function fileAtSessionStart(root, path, start) {
   const git = (args) => execFileSync4("git", args, { cwd: root, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
@@ -7237,19 +7675,48 @@ function fileAtSessionStart(root, path, start) {
     return "";
   }
 }
-function commandProblems(root, command, surface, start) {
+function changedOutsideRecords(root, start) {
+  const git = (args) => execFileSync4("git", args, { cwd: root, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+  try {
+    const base = start === void 0 ? "HEAD" : git(["rev-list", "-1", `--before=@${Math.floor(start / 1e3)}`, "HEAD"]).trim();
+    if (!base) return [];
+    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(join42(root, f)).mtimeMs >= start - 1e3;
+      } catch {
+        return false;
+      }
+    });
+    return [.../* @__PURE__ */ new Set([...changed, ...created])].sort();
+  } catch {
+    return [];
+  }
+}
+function drawingChangedAfterApproval(root, specPath, at) {
+  const git = (args) => execFileSync4("git", args, { cwd: root, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+  try {
+    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 !== readFileSync35(join42(root, at), "utf8") ? approvedIn.slice(0, 7) : void 0;
+  } catch {
+    return void 0;
+  }
+}
+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.`");
       }
       if (/\[TODO\]/.test(body)) problems.push("DECISIONS.md still contains [TODO] markers.");
-      problems.push(...unsourcedReasons(body, fileAtSessionStart(root, found, start)).map((p) => `DECISIONS.md: ${p}`));
+      problems.push(...unsourcedReasons(body, fileAtSessionStart(root, found, start), { newWhysOnly: true }).map((p) => `DECISIONS.md: ${p}`));
     }
   }
   if (command === "spec" || command === "mockup" || command === "make" || command === "critique" || command === "tweak") {
@@ -7259,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() ?? "";
@@ -7266,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] ?? "";
@@ -7285,12 +7756,31 @@ function commandProblems(root, command, surface, start) {
       }
     }
   }
+  if (command === "spec" || command === "mockup" || command === "critique") {
+    const outside = changedOutsideRecords(root, start);
+    if (outside.length) {
+      problems.push(
+        `${command} writes under .jig/ only, and this session changed ${outside.slice(0, 6).join(", ")}${outside.length > 6 ? ` and ${outside.length - 6} more` : ""}. Put them back as they were when the session began, and hand the change to \`/jig make\` (or \`/jig tweak\` for a small one to a built page). ` + (command === "critique" ? "A critique that changes the page it judges is grading its own work; report the finding instead." : "The build is make's.")
+      );
+    }
+  }
+  if (command === "mockup" && spec) {
+    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) && 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.`);
+      }
+    }
+  }
   if (command === "make") {
     const found = decisionsFile(root);
     if (found) {
       let now = "";
       try {
-        now = readFileSync32(join39(root, found), "utf8");
+        now = readFileSync35(join42(root, found), "utf8");
       } catch {
       }
       const then = fileAtSessionStart(root, found, start);
@@ -7299,9 +7789,39 @@ function commandProblems(root, command, surface, start) {
       }
     }
   }
+  if (command === "tweak" && spec) {
+    const found = decisionsFile(root);
+    if (found) {
+      let now = "";
+      try {
+        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(join42(root, ".jig", "critique", spec.slug))?.change;
+        if (change) problems.push(...quotesNotFrom(now, then, change).map((p) => `${found}: ${p}`));
+      }
+    }
+  }
+  if (command !== "update" && command !== "init" && command !== "install") {
+    for (const file of modeFiles(root)) {
+      let now = "";
+      try {
+        now = readFileSync35(join42(root, file), "utf8");
+      } catch {
+        continue;
+      }
+      const then = fileAtSessionStart(root, file, start);
+      if (then && now !== then) {
+        problems.push(`${file} changed in this session. A mode file is Jig's, refreshed by \`update\`; a value this project needs of its own goes in its brand file or its own stylesheet. Restore it (\`git checkout -- ${file}\`, or \`git show <commit>:${file}\` if the change is committed).`);
+      }
+    }
+  }
   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) {
@@ -7311,13 +7831,66 @@ function commandProblems(root, command, surface, start) {
         problems.push(`${surface2}: 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.`);
       }
     }
+    const own = specFor(root, surface)?.slug;
+    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.");
     }
   }
   return problems;
 }
-function tweakProblems(root, spec) {
+function drawingBeforeAsking(root, surface) {
+  const spec = specFor(root, surface);
+  if (!spec) return [];
+  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) || !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(readFileSync35(join42(root, ".jig", "state.json"), "utf8"));
+    return Object.keys(state.files ?? {}).filter((f) => /(^|\/)mode\.[\w-]+\.css$/.test(f));
+  } catch {
+    return [];
+  }
+}
+function reportOmissions(dir, surface) {
+  let report2;
+  try {
+    report2 = readFileSync35(join42(dir, "REPORT.md"), "utf8").toLowerCase();
+  } catch {
+    return [];
+  }
+  const missing = [];
+  for (const f of VERDICT_FILES) {
+    let file;
+    try {
+      file = JSON.parse(readFileSync35(join42(dir, f), "utf8"));
+    } catch {
+      continue;
+    }
+    for (const v of Array.isArray(file.verdicts) ? file.verdicts : []) {
+      if (v.verdict !== "finding") continue;
+      const key = String(v.id ?? v.decision ?? "").trim();
+      if (key && !report2.includes(key.toLowerCase())) missing.push(v.id ? key : `"${key}"`);
+    }
+  }
+  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, 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\`.`);
@@ -7325,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.`
@@ -7367,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 {
@@ -7379,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;
   }
@@ -7391,19 +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) {
@@ -7425,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}`);
@@ -7451,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) {
@@ -7490,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;
     }
@@ -7501,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 {
-    writeFileSync6(lockPath, JSON.stringify({ checksum: now, verdicts: verdictDigests(dir) }) + "\n", "utf8");
+    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), ...page ? { page } : {}, ...tweakAt ? { tweak: tweakAt } : {} }) + "\n", "utf8");
   } catch {
   }
 }
@@ -7511,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 "";
     }
@@ -7519,22 +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;
     }
@@ -7542,7 +8150,10 @@ function verdictGuard(root, command, inPlay) {
     if (command === "tweak" && (!inPlay || inPlay.includes(surface)) && locked !== now) {
       const own = tweakVerdictProblems(dir, surface, lock.verdicts);
       problems.push(...own);
-      if (own.length === 0) writeLock(lockPath, dir, now);
+      if (own.length === 0) {
+        writeLock(root, surface, lockPath, dir, now);
+        problems.push(...lockLeftBehind(root, surface));
+      }
       continue;
     }
     if (locked && locked !== now) {
@@ -7553,6 +8164,17 @@ function verdictGuard(root, command, inPlay) {
   }
   return problems;
 }
+function lockLeftBehind(root, surface) {
+  const rel = `.jig/critique/${surface}`;
+  try {
+    const status = (paths) => execFileSync4("git", ["status", "--porcelain", "--", ...paths], { cwd: root, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    if (!status([`${rel}/${LOCK}`])) return [];
+    if (status(VERDICT_FILES.map((f) => `${rel}/${f}`))) return [];
+  } catch {
+    return [];
+  }
+  return [`${rel}/${LOCK} was written when you stopped, after the verdicts it records were committed. Commit it on its own (\`git add ${rel}/${LOCK} && git commit -m "chore: record ${surface}'s verdict lock"\`), and nothing else.`];
+}
 function tweakVerdictProblems(dir, surface, lockedVerdicts) {
   const record = readTweak(dir);
   if (!record) {
@@ -7577,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;
     }
@@ -7589,113 +8211,22 @@ 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(
+      `Dev build ${version}: the skill, its commands and the Stop hook run the \`jig\` on your PATH, not npm, which has no such version. Keep this build installed while the project uses it, and install a published version to go back.`
+    );
+    return;
+  }
   if (isPublishedBuild(packageRoot)) return;
   console.warn(
     `Note: this is a source build, so the skill pins 'npx jig-ui@${version}' \u2014 a version that may not be published. Agents reading it will not be able to run the CLI until it is. Re-run install or update from a published build to correct the pin.`
@@ -7819,7 +8350,7 @@ program.command("verdicts").description("Verify a critique's verdict files and c
     const p = result.previous;
     if (p) {
       const list = (ids) => ids.length ? ` (${ids.slice(0, 8).join(", ")}${ids.length > 8 ? ", \u2026" : ""})` : "";
-      console.log(`  Since the critique before this one (${p.commit}): ${p.fixed.length} fixed${list(p.fixed)}, ${p.open.length} still open${list(p.open)}, ${p.ruled.length} ruled by the owner${list(p.ruled)}, ${p.added.length} new${list(p.added)}.`);
+      console.log(`  Since the critique before this one (${p.commit}): ${p.fixed.length} fixed${list(p.fixed)}, ${p.unchanged.length} judged ok though the lines they cited did not change${list(p.unchanged)}, ${p.open.length} still open${list(p.open)}, ${p.ruled.length} ruled by the owner${list(p.ruled)}, ${p.added.length} new${list(p.added)}.`);
     }
     console.log(`  ${result.line}`);
     process.exit(result.ok ? 0 : 1);
@@ -7869,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) {
@@ -7911,13 +8453,14 @@ 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();
   try {
     const projectRoot = findProjectRoot(cwd);
-    for (const surface of critiquedSurfaces(projectRoot)) {
+    const critiqued = critiquedSurfaces(projectRoot);
+    for (const surface of surfacesToProbe(projectRoot, input).filter((s) => critiqued.includes(s))) {
       const page = surfacePage(projectRoot, surface) ?? recordedPage(projectRoot, surface);
       if (!page) continue;
       try {
@@ -7950,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 {