jig-ui 0.24.0 → 0.25.0

package/CHANGELOG.md

@@ -1,5 +1,107 @@
 # Changelog
 
+## 0.25.0 (2026-10-09)
+
+Link previews, code and tables that reflow on an `editorial` phone, and the
+gate's rules stated before a session stops.
+
+### Added
+
+- **The render probe measures a box that scrolls sideways.** `editorial`
+  allows no scrolling region on a phone (`M-01`), and the probe only measured
+  a page wider than the screen. In a control run on this release's reflow
+  text, a spec said the code would wrap and the built page scrolled it in a
+  box, and nothing caught it. The probe now records each box that scrolls
+  sideways, and on an `editorial` surface at phone width each is a measured
+  failure: a critique reports it, `ship` counts it, and the gate holds make and
+  tweak until the page reflows.
+- **J-164: an indexable page a link preview cannot read.** A page pasted into a
+  message or a post is met as a card before anyone opens it, and the card is
+  built from `og:title` and `og:description`. Section J said it covered the link
+  preview, and no rule asked for one, so `seo` and `check` passed a site with no
+  preview on any page. `check` reports it in a file that writes its own
+  `<head>`, and in a head fragment (`<svelte:head>`, Astro, `next/head`) that
+  writes the page's own description and no `og:description`, which no layout
+  can supply; elsewhere a layout may write it, and the render decides: the probe
+  now reads `og:description`, and a served page missing either tag is a
+  finding on the page. An image and `og:url` need the page's full address, so
+  the rule asks for them once a site has one. 160 rules, 40 of them decided by
+  a machine.
+
+### Changed
+
+- **`editorial` on a phone says what replaces a scrolling box.** `L-01` sent a
+  wide code block or table to scroll inside itself, and the same sentence said
+  `editorial` allows no scrolling region on mobile, naming nothing in its
+  place. `L-01`, `D-115` and `M-01` now say it: a code block keeps its line
+  breaks and indents and wraps its long lines, a table too wide for the screen
+  stacks its rows with each cell's column name in front and stays a `<table>`,
+  and a long identifier breaks where it must.
+- **`E-51`'s near-universal glyphs are a test, not a list.** Close, search and
+  menu were read as the only icon-only controls allowed. The rule now asks
+  whether most readers would name the glyph the same way without its label,
+  with examples that pass (a theme's sun and moon, a well-known service's mark)
+  and that do not.
+- **`E-28` says what a browser's own tab stop on an `<iframe>` gets.** One that
+  only shows something is taken out of the tab order rather than given states;
+  one the reader uses keeps its stop and shows focus.
+- **spec, mockup and tweak each end with what the gate holds them to.** A short
+  "Before you stop" list names the checks the Stop hook makes on what that
+  command records, beyond the shape its steps already teach: where it may write, whose words a quotation is, the check record's
+  format, what counts as the owner's confirmation or approval, and what
+  `tweak.json` holds. Sessions learned these from refusals, and each refusal
+  cost a round of fixing, re-checking and committing. A test pairs each check
+  with its line in the list, so a check added without one fails.
+- **`jig check` exits non-zero on a mechanical error, with or without `--ci`.**
+  It used to exit 0 whatever it found, so a pre-commit hook, a CI step or a
+  script running it as a linter read a run full of errors as a pass. Judgment
+  findings are still reported without failing the run. `--ci` now only limits
+  the run to the mechanical rules.
+
+### Fixed
+
+- **The skill and `spec` say `L-01` has six steps, and `spec` names the sixth.**
+  `L-01` gained step 6, how a screen collapses, and both kept telling the agent
+  to run "its five steps", so it stopped before the one that gives the phone
+  composition. In a control run on this release's reflow text, a spec chose a
+  sideways-scrolling code block for an `editorial` phone. A test now ties the
+  count to `L-01`'s own step headings.
+- **`I-118` exempts quoted output in the rule and in `check`, as the probe
+  already did.** The rule exempted a quotation in `<blockquote>` or `<q>`; the
+  render probe also leaves `<pre>`, `<code>`, `<samp>` and `<kbd>` alone, and
+  `check` exempted none of them. A page quoting a tool's real output was told
+  by `check` to rewrite it, and by the rule to keep the quotation's own
+  punctuation. All three now agree.
+- **A critique is no longer held on what the page fails.** An em dash on the
+  rendered page, a missing or overlong title or description, unresolved tokens
+  or the browser's default font are failures of the page, not of the review.
+  `verdicts` reported them as a critique left incomplete, so the gate held the
+  critique session until they were gone, and the session could clear them only
+  by editing the page, which a critique never does. They are now listed apart,
+  under `!`, as `measured=` on the `JIG_VERDICTS` line, and once each rather than
+  at every width. A critique reports them and finishes; `ship` counts them as
+  findings, and the gate holds make and tweak until the page is fixed. A verdict
+  the probe contradicts still means the review re-runs.
+- **A quoted `mockup:` value reads as the value it holds.** A spec that wrote
+  `mockup: "skipped — the owner: \"…\""`, valid YAML, read to the gate as the
+  word `"skipped`, so every tweak of the page was refused for having no approved
+  drawing, and the check that the owner's words are quoted was silently skipped.
+- **An em dash inside tool output no longer counts as the page's own.** The
+  probe leaves quotations and `<pre>`, `<code>`, `<samp>` and `<kbd>` out of the
+  dash scan, but it cut them out of the page's text one string at a time. An
+  inline `<code>` earlier in the prose, such as a rule id, removed those
+  characters from the output block below it, the block no longer matched, and
+  its dash was reported. Quotations are now left out of the text as it is read.
+- **The README no longer says every command is also a slash command.** `gate`
+  has no slash form (only the Stop hook runs it), and six slash commands are
+  agent procedures with no command of their own in the CLI. The table under it
+  was right; the sentence above it now says what the table does.
+- **`check` no longer says it examined nothing while reporting findings.** A
+  file styled only with utility classes, such as `class="p-[13px]"`, is read by
+  H-47 but was left out of the styled-file count. A change to such a file
+  reported H-47 errors and, below them, that no file carried a style region. The
+  count now includes markup whose class attributes hold classes.
+
 ## 0.24.0 (2026-09-30)
 
 The owner's word held to one rule, Jig's instructions in your project's AGENTS.md,

package/README.md

@@ -27,13 +27,13 @@ later.
 Jig is **a skill your coding agent reads**, and **a CLI you can run yourself**.
 They are two halves of the same thing, and the split is not arbitrary:
 
-- Of the 159 rules, **39 can be decided by a machine** — a hard-coded colour, a
+- Of the 160 rules, **40 can be decided by a machine** — a hard-coded colour, a
   contrast ratio below the floor, a removed focus ring. The CLI decides those.
 - The other **120 are judgment** — whether an empty state says anything useful,
   whether a label reads as an instruction, whether motion earns its place. No
   regex settles those. An agent reads the rules and applies them.
 
-Running only the CLI gets you the 39. Running only the agent gets you the 120 with
+Running only the CLI gets you the 40. Running only the agent gets you the 120 with
 no verification. **A clean `jig check` is not a clean review**, and the skill
 says so to every agent that reads it.
 
@@ -406,7 +406,7 @@ overwrites a config or brand file you have edited.
 | --- | --- |
 | `install --agent <name> [--scope project\|global] [--hook]` | Puts the skill and its rules where your agent will find them. At project scope, also keeps Jig's block in `AGENTS.md` (and `CLAUDE.md` for Claude Code); with `--hook`, adds the Stop hook. |
 | `init [--yes]` | Sets the project up: CSS system, brand colour, token files, `jig.config.json`, wired imports, baseline check. |
-| `check [--all] [--ci] [--json]` | Runs the rules a machine can decide. Reports findings by rule id. |
+| `check [--all] [--ci] [--json]` | Runs the rules a machine can decide. Reports findings by rule id, and exits non-zero on any mechanical error. |
 | `update` | Refreshes an install to a newer version, leaving alone any file you have edited. |
 | `seo [--json]` | Audits what a search engine and a link preview read, across the whole project: a route whose metadata says `noindex` sitting in the sitemap, two pages claiming one title, a sitemap that lists nothing or lists paths a crawler drops. Whether a sitemap and a robots file exist is counted, not reported: no rule asks for either, and a site with no domain yet cannot write an honest sitemap. Needs no config, no decisions and no spec. |
 | `checksum <spec>` | Prints a spec's checksum, the value its `.checked.json` records as `spec`, so the spec's reader never computes it by hand. |
@@ -422,7 +422,7 @@ Flags worth knowing:
 | --- | --- |
 | `check --all` | Scan the whole repo instead of just changed files. Use on a first run. |
 | `explain --list` | Every rule id and title. Add a section letter (`explain G --list`) for one section. |
-| `check --ci` | Mechanical bucket only — deterministic, and exits non-zero on any error. |
+| `check --ci` | Mechanical bucket only, so the run is deterministic. |
 | `check --json` | Machine-readable findings, for tooling or for reading every finding when the terminal output elides repeats. |
 | `init --yes` | Non-interactive; accept every derived default. |
 | `install --scope global` | Install once for every project. |
@@ -435,9 +435,12 @@ mean it could never move.
 
 ### As slash commands
 
-Every command is also a slash command in your agent, installed alongside the
-skill. `/jig check --all` does what `npx jig-ui check --all` does, and then acts
-on the result — the CLI reports, the agent applies the judgment half.
+Every command but `gate`, which only the Stop hook runs, is also a slash command
+in your agent, installed alongside the skill. `/jig check --all` does what
+`npx jig-ui check --all` does, and then acts on the result — the CLI reports, the
+agent applies the judgment half. Six slash commands are agent procedures with no
+command of their own in the CLI: `decide`, `spec`, `mockup`, `make`, `critique` and
+`tweak` (`critique` runs `verdicts` and `probe` along the way).
 
 | Slash command | Equivalent |
 | --- | --- |
@@ -642,7 +645,8 @@ metadata in the same change as the headline, and `check` holds the budgets.
 
 **Which pages are meant to be found is decided by mode, not by taste.**
 `editorial` is first-visit content, so it is indexable and needs its own title
-and description. `product` and `operator` are what somebody reaches after signing
+and description, and its own link preview (`og:title` and `og:description`) for
+the card a pasted link shows. `product` and `operator` are what somebody reaches after signing
 in, so they must carry `noindex` — an admin screen in a search result is an
 invitation, and a sign-in page in one invites credential stuffing. A spec
 overrides the default per page, with a reason: a CV shared by link, a
@@ -697,7 +701,7 @@ No agent required. `check` is a linter with a design system behind it.
 ```bash
 npx jig-ui@latest check --all      # everything
 npx jig-ui@latest check            # just what changed
-npx jig-ui@latest check --ci       # for CI: deterministic, non-zero on error
+npx jig-ui@latest check --ci       # for CI: mechanical rules only, deterministic
 npx jig-ui@latest check --json     # for tooling
 ```
 
@@ -793,7 +797,7 @@ treatment.
 
 | File | Contents |
 | --- | --- |
-| `rules/00-anti-patterns.md` | 128 universal rules with corrections |
+| `rules/00-anti-patterns.md` | 129 universal rules with corrections |
 | `rules/01-modes.md` | `editorial` / `product` / `operator` profiles |
 | `rules/02-tokens.md` | Token contract, naming, consumption |
 | `rules/03-patterns.md` | Component anatomy and behaviour |

package/dist/index.js

@@ -2098,6 +2098,139 @@ function isReaderText(file) {
   return hasExtension(file, STYLE_HOST_EXTENSIONS);
 }
 
+// src/check/length.ts
+var LENGTH_UNITS = [
+  "px",
+  "rem",
+  "em",
+  "pt",
+  "vh",
+  "vw",
+  "vmin",
+  "vmax",
+  "ch",
+  "ex"
+];
+var UNITS = LENGTH_UNITS.join("|");
+var LENGTH_RE = new RegExp(`^-?\\d*\\.?\\d+(?:${UNITS})$`, "i");
+var LENGTH_SCAN_RE = new RegExp(`(-?\\d*\\.?\\d+)(${UNITS})`, "gi");
+function isExcludedLength(value, unit) {
+  if (value === 0) return true;
+  return unit.toLowerCase() === "px" && (Math.abs(value) === 1 || Math.abs(value) === 2);
+}
+function hasHardCodedLength(value) {
+  LENGTH_SCAN_RE.lastIndex = 0;
+  let m;
+  while (m = LENGTH_SCAN_RE.exec(value)) {
+    if (!isExcludedLength(parseFloat(m[1]), m[2])) return true;
+  }
+  return false;
+}
+
+// src/check/tailwind.ts
+var CLASS_ATTR = /\b(?:class|className)\s*=\s*/g;
+function readBraced(source, open) {
+  let depth = 0;
+  for (let i = open; i < source.length; i++) {
+    const ch = source[i];
+    if (ch === '"' || ch === "'" || ch === "`") {
+      const quote = ch;
+      i++;
+      while (i < source.length && source[i] !== quote) {
+        if (source[i] === "\\") i++;
+        i++;
+      }
+      continue;
+    }
+    if (ch === "{") depth++;
+    else if (ch === "}" && --depth === 0) return source.slice(open + 1, i);
+  }
+  return null;
+}
+function classAttributeValues(source) {
+  const out = [];
+  const lineAt = (offset) => source.slice(0, offset).split("\n").length;
+  for (const m of source.matchAll(CLASS_ATTR)) {
+    const at = m.index + m[0].length;
+    const opener = source[at];
+    if (opener === '"' || opener === "'") {
+      const end = source.indexOf(opener, at + 1);
+      if (end !== -1) out.push({ classes: source.slice(at + 1, end), line: lineAt(at) });
+      continue;
+    }
+    if (opener !== "{") continue;
+    const raw = readBraced(source, at);
+    if (raw === null) continue;
+    const literals = [...raw.matchAll(/(["'`])([\s\S]*?)\1/g)].map(
+      (q) => q[2].replace(/\$\{[\s\S]*?\}/g, " ")
+    );
+    if (literals.length > 0) out.push({ classes: literals.join(" ").trim(), line: lineAt(at) });
+  }
+  return out;
+}
+var ARBITRARY = /(?:^|\s)(?:[\w-]+:)*([a-z][\w-]*)-\[([^\]\s]+)\]/gi;
+var COLOUR = /^(?:#[0-9a-f]{3,8}|(?:rgba?|hsla?|oklch|oklab|lab|lch|color)\()/i;
+var LENGTH_PARTS = /^(-?\d*\.?\d+)([a-z]+)$/i;
+function arbitraryValues(classes) {
+  const out = [];
+  for (const m of classes.matchAll(ARBITRARY)) {
+    const [, utility, rawValue] = m;
+    const value = rawValue.replace(/_/g, " ");
+    if (/var\(|--/.test(value)) continue;
+    if (COLOUR.test(value)) {
+      out.push({ utility, value, kind: "colour" });
+      continue;
+    }
+    if (!LENGTH_RE.test(value)) continue;
+    const parts = LENGTH_PARTS.exec(value);
+    if (isExcludedLength(parseFloat(parts[1]), parts[2])) continue;
+    out.push({ utility, value, kind: "length" });
+  }
+  return out;
+}
+var PALETTE = {
+  white: "#ffffff",
+  black: "#000000",
+  "gray-50": "#f9fafb",
+  "gray-100": "#f3f4f6",
+  "gray-200": "#e5e7eb",
+  "gray-300": "#d1d5db",
+  "gray-400": "#9ca3af",
+  "gray-500": "#6b7280",
+  "gray-600": "#4b5563",
+  "gray-700": "#374151",
+  "gray-800": "#1f2937",
+  "gray-900": "#111827",
+  "gray-950": "#030712",
+  "slate-50": "#f8fafc",
+  "slate-400": "#94a3b8",
+  "slate-500": "#64748b",
+  "slate-800": "#1e293b",
+  "slate-900": "#0f172a",
+  "slate-950": "#020617",
+  "zinc-400": "#a1a1aa",
+  "zinc-500": "#71717a",
+  "zinc-900": "#18181b",
+  "neutral-400": "#a3a3a3",
+  "neutral-500": "#737373",
+  "neutral-900": "#171717",
+  "stone-400": "#a8a29e",
+  "stone-500": "#78716c",
+  "stone-900": "#1c1917"
+};
+function palettePairs(classes) {
+  let background;
+  let foreground;
+  for (const token of classes.split(/\s+/)) {
+    const bare2 = token.replace(/^(?:[\w-]+:)*/, "");
+    const bg = /^bg-(.+)$/.exec(bare2);
+    const fg = /^text-(.+)$/.exec(bare2);
+    if (bg && PALETTE[bg[1]]) background = PALETTE[bg[1]];
+    if (fg && PALETTE[fg[1]]) foreground = PALETTE[fg[1]];
+  }
+  return background && foreground ? [{ background, foreground }] : [];
+}
+
 // src/check/run.ts
 import { readFileSync as readFileSync15 } from "fs";
 import { join as join19 } from "path";
@@ -2904,139 +3037,6 @@ var pureBlackWhite = {
   }
 };
 
-// src/check/length.ts
-var LENGTH_UNITS = [
-  "px",
-  "rem",
-  "em",
-  "pt",
-  "vh",
-  "vw",
-  "vmin",
-  "vmax",
-  "ch",
-  "ex"
-];
-var UNITS = LENGTH_UNITS.join("|");
-var LENGTH_RE = new RegExp(`^-?\\d*\\.?\\d+(?:${UNITS})$`, "i");
-var LENGTH_SCAN_RE = new RegExp(`(-?\\d*\\.?\\d+)(${UNITS})`, "gi");
-function isExcludedLength(value, unit) {
-  if (value === 0) return true;
-  return unit.toLowerCase() === "px" && (Math.abs(value) === 1 || Math.abs(value) === 2);
-}
-function hasHardCodedLength(value) {
-  LENGTH_SCAN_RE.lastIndex = 0;
-  let m;
-  while (m = LENGTH_SCAN_RE.exec(value)) {
-    if (!isExcludedLength(parseFloat(m[1]), m[2])) return true;
-  }
-  return false;
-}
-
-// src/check/tailwind.ts
-var CLASS_ATTR = /\b(?:class|className)\s*=\s*/g;
-function readBraced(source, open) {
-  let depth = 0;
-  for (let i = open; i < source.length; i++) {
-    const ch = source[i];
-    if (ch === '"' || ch === "'" || ch === "`") {
-      const quote = ch;
-      i++;
-      while (i < source.length && source[i] !== quote) {
-        if (source[i] === "\\") i++;
-        i++;
-      }
-      continue;
-    }
-    if (ch === "{") depth++;
-    else if (ch === "}" && --depth === 0) return source.slice(open + 1, i);
-  }
-  return null;
-}
-function classAttributeValues(source) {
-  const out = [];
-  const lineAt = (offset) => source.slice(0, offset).split("\n").length;
-  for (const m of source.matchAll(CLASS_ATTR)) {
-    const at = m.index + m[0].length;
-    const opener = source[at];
-    if (opener === '"' || opener === "'") {
-      const end = source.indexOf(opener, at + 1);
-      if (end !== -1) out.push({ classes: source.slice(at + 1, end), line: lineAt(at) });
-      continue;
-    }
-    if (opener !== "{") continue;
-    const raw = readBraced(source, at);
-    if (raw === null) continue;
-    const literals = [...raw.matchAll(/(["'`])([\s\S]*?)\1/g)].map(
-      (q) => q[2].replace(/\$\{[\s\S]*?\}/g, " ")
-    );
-    if (literals.length > 0) out.push({ classes: literals.join(" ").trim(), line: lineAt(at) });
-  }
-  return out;
-}
-var ARBITRARY = /(?:^|\s)(?:[\w-]+:)*([a-z][\w-]*)-\[([^\]\s]+)\]/gi;
-var COLOUR = /^(?:#[0-9a-f]{3,8}|(?:rgba?|hsla?|oklch|oklab|lab|lch|color)\()/i;
-var LENGTH_PARTS = /^(-?\d*\.?\d+)([a-z]+)$/i;
-function arbitraryValues(classes) {
-  const out = [];
-  for (const m of classes.matchAll(ARBITRARY)) {
-    const [, utility, rawValue] = m;
-    const value = rawValue.replace(/_/g, " ");
-    if (/var\(|--/.test(value)) continue;
-    if (COLOUR.test(value)) {
-      out.push({ utility, value, kind: "colour" });
-      continue;
-    }
-    if (!LENGTH_RE.test(value)) continue;
-    const parts = LENGTH_PARTS.exec(value);
-    if (isExcludedLength(parseFloat(parts[1]), parts[2])) continue;
-    out.push({ utility, value, kind: "length" });
-  }
-  return out;
-}
-var PALETTE = {
-  white: "#ffffff",
-  black: "#000000",
-  "gray-50": "#f9fafb",
-  "gray-100": "#f3f4f6",
-  "gray-200": "#e5e7eb",
-  "gray-300": "#d1d5db",
-  "gray-400": "#9ca3af",
-  "gray-500": "#6b7280",
-  "gray-600": "#4b5563",
-  "gray-700": "#374151",
-  "gray-800": "#1f2937",
-  "gray-900": "#111827",
-  "gray-950": "#030712",
-  "slate-50": "#f8fafc",
-  "slate-400": "#94a3b8",
-  "slate-500": "#64748b",
-  "slate-800": "#1e293b",
-  "slate-900": "#0f172a",
-  "slate-950": "#020617",
-  "zinc-400": "#a1a1aa",
-  "zinc-500": "#71717a",
-  "zinc-900": "#18181b",
-  "neutral-400": "#a3a3a3",
-  "neutral-500": "#737373",
-  "neutral-900": "#171717",
-  "stone-400": "#a8a29e",
-  "stone-500": "#78716c",
-  "stone-900": "#1c1917"
-};
-function palettePairs(classes) {
-  let background;
-  let foreground;
-  for (const token of classes.split(/\s+/)) {
-    const bare2 = token.replace(/^(?:[\w-]+:)*/, "");
-    const bg = /^bg-(.+)$/.exec(bare2);
-    const fg = /^text-(.+)$/.exec(bare2);
-    if (bg && PALETTE[bg[1]]) background = PALETTE[bg[1]];
-    if (fg && PALETTE[fg[1]]) foreground = PALETTE[fg[1]];
-  }
-  return background && foreground ? [{ background, foreground }] : [];
-}
-
 // src/check/detectors/contrast-floor.ts
 var FLOOR = 4.5;
 var LARGE_FLOOR = 3;
@@ -3631,7 +3631,7 @@ var EM_DASH = /—/;
 var TAG = /<\/?[A-Za-z][\w.:-]*(?:\s[^<>]*)?\/?>/g;
 function maskNonProse(source) {
   const blank3 = (m) => " ".repeat(m.length);
-  return source.replace(/^---\n[\s\S]*?\n---/, blank3).replace(/<script\b[\s\S]*?<\/script\s*>/gi, blank3).replace(/<style\b[\s\S]*?<\/style\s*>/gi, blank3).replace(/<!--[\s\S]*?-->/g, blank3).replace(/\/\*[\s\S]*?\*\//g, blank3).replace(/(^|[^:])\/\/[^\n]*/g, (m, p1) => p1 + " ".repeat(m.length - p1.length));
+  return source.replace(/^---\n[\s\S]*?\n---/, blank3).replace(/<script\b[\s\S]*?<\/script\s*>/gi, blank3).replace(/<style\b[\s\S]*?<\/style\s*>/gi, blank3).replace(/<(blockquote|q|pre|code|samp|kbd)\b[^>]*>[\s\S]*?<\/\1\s*>/gi, blank3).replace(/<!--[\s\S]*?-->/g, blank3).replace(/\/\*[\s\S]*?\*\//g, blank3).replace(/(^|[^:])\/\/[^\n]*/g, (m, p1) => p1 + " ".repeat(m.length - p1.length));
 }
 function markdownProse(source) {
   const blank3 = (m) => " ".repeat(m.length);
@@ -3914,6 +3914,8 @@ function firstGroup(match) {
   if (!value) return void 0;
   return { value, index: match.index ?? 0 };
 }
+var PREVIEW_TITLE = /property\s*=\s*["']og:title["']|(?:^|[\s{,])["']?(?:ogTitle|og:title)["']?\s*:|openGraph\s*:\s*\{[^}]*?\btitle\s*:/;
+var PREVIEW_DESCRIPTION = /property\s*=\s*["']og:description["']|(?:^|[\s{,])["']?(?:ogDescription|og:description)["']?\s*:|openGraph\s*:\s*\{[^}]*?\bdescription\s*:/;
 function readMetadata(source) {
   const htmlTitle = firstGroup(HTML_TITLE.exec(source));
   const title = htmlTitle ?? firstGroup(KEYED_TITLE.exec(source));
@@ -3931,6 +3933,9 @@ function readMetadata(source) {
     description: description && !/^\{|\$\{/.test(description.value) ? description : void 0,
     hasTitle: ANY_TITLE.test(source),
     hasDescription: ANY_DESCRIPTION.test(source),
+    hasPreviewTitle: PREVIEW_TITLE.test(source),
+    hasPreviewDescription: PREVIEW_DESCRIPTION.test(source),
+    hasPreview: PREVIEW_TITLE.test(source) && PREVIEW_DESCRIPTION.test(source),
     declares: DECLARES.test(source),
     computedTitle: COMPUTED_TITLE.test(source),
     noindex: NOINDEX.some((re) => re.test(source))
@@ -3943,6 +3948,7 @@ var TITLE_BUDGET = 60;
 var DESCRIPTION_BUDGET = 155;
 
 // src/check/detectors/metadata.ts
+var HEAD_FRAGMENT = /<svelte:head[\s>]|<head[\s>]|<Head[\s>]|<Helmet[\s>]|slot\s*=\s*["']head["']/;
 var INVENTED_DATE = /(?:lastModified|datePublished|dateModified|publishedTime|modifiedTime)\s*:\s*(?:new Date\(\s*\)|Date\.now\(\s*\))/;
 var metadata = {
   name: "metadata",
@@ -3976,9 +3982,19 @@ var metadata = {
       if (indexable && !found.hasDescription) {
         at("J-121", 0, "this page has no meta description \u2014 the search engine writes one from whatever text it finds first, usually the navigation");
       }
+      if (indexable && !found.hasPreview) {
+        const missing = [!found.hasPreviewTitle && "og:title", !found.hasPreviewDescription && "og:description"].filter(Boolean).join(" and ");
+        at("J-164", 0, found.hasPreviewTitle || found.hasPreviewDescription ? `this page has no ${missing} \u2014 a link to it, pasted into a message or a post, shows a card with that part guessed` : "this page has no link preview (og:title and og:description) \u2014 a link to it, pasted into a message or a post, shows a card built from whatever the page happens to carry");
+      }
       if (!indexable && !found.noindex) {
         at("J-123", 0, `this surface is ${ctx.mode}, which is what somebody reaches after signing in, and the page carries no noindex \u2014 robots.txt is public and advisory, and is not this`);
       }
+    } else {
+      const own = HEAD_FRAGMENT.test(raw) ? HTML_DESCRIPTION.exec(raw) ?? HTML_DESCRIPTION_REVERSED.exec(raw) : null;
+      const indexable = ctx.mode !== "product" && ctx.mode !== "operator";
+      if (indexable && own && found.description && !found.hasPreviewDescription) {
+        at("J-164", own.index, `this file writes the page's description but no og:description${found.hasPreviewTitle ? "" : " or og:title"} \u2014 a link to it, pasted into a message or a post, shows a card without the description written here`);
+      }
     }
     return findings.filter((f) => f.ruleId === ctx.ruleId);
   }
@@ -4837,6 +4853,9 @@ function auditTokenLayer(projectRoot) {
 }
 
 // src/commands/check.ts
+function checkExitCode(result) {
+  return result.hasError ? 1 : 0;
+}
 var LEGACY_INDEX_REL = join25(".jig", "rules.index.json");
 function resolveIndexPath(projectRoot) {
   const legacy = join25(projectRoot, LEGACY_INDEX_REL);
@@ -4913,7 +4932,9 @@ function check(opts) {
   const withStyles = files.filter((f) => {
     try {
       const src = readFileSync21(join25(opts.projectRoot, f), "utf8");
-      return hasExtension(f, CSS_EXTENSIONS) ? src.trim().length > 0 : maskNonStyleRegions(src, f).trim().length > 0;
+      if (hasExtension(f, CSS_EXTENSIONS)) return src.trim().length > 0;
+      if (maskNonStyleRegions(src, f).trim().length > 0) return true;
+      return isMarkupHost(f) && classAttributeValues(src).some((a) => a.classes.trim().length > 0);
     } catch {
       return false;
     }
@@ -6119,12 +6140,18 @@ var PROBE_SCRIPT = `(async () => {
   // 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, pre, code, samp, kbd')) {
-    const quoted = (q.innerText || '').trim();
-    if (quoted) ownText = ownText.split(quoted).join('\\n');
-  }
+  // the probe blocked a page for words it had rightly not rewritten. The
+  // quotations are hidden while the text is read, not cut out of it by string:
+  // an inline <code>A-01</code> earlier in the prose removed "A-01" from the
+  // output block below it, so the block no longer matched and its dash counted.
+  const quotedEls = [...document.querySelectorAll('blockquote, q, pre, code, samp, kbd')];
+  const hide = document.createElement('style');
+  hide.textContent = '[data-jig-quoted] { display: none !important; }';
+  for (const q of quotedEls) q.setAttribute('data-jig-quoted', '');
+  document.head.appendChild(hide);
+  const ownText = document.body.innerText || '';
+  hide.remove();
+  for (const q of quotedEls) q.removeAttribute('data-jig-quoted');
   const junk = [...new Set(text.match(/\\$\\{|\\{\\{|\\bundefined\\b|\\bNaN\\b|\\[object Object\\]/g) || [])];
   const unresolved = new Set();
   for (const sheet of document.styleSheets) {
@@ -6294,6 +6321,17 @@ var PROBE_SCRIPT = `(async () => {
     fauxSeen.add(key);
     fauxFaces.push({ family: first.trim().replace(/^["']|["']$/g, ''), weight, style: italic ? 'italic' : 'normal', text: (el.innerText || '').trim().slice(0, 40) });
   }
+  // M-01: \`editorial\` allows no box that scrolls sideways on a phone; a code
+  // block wraps and a wide table stacks (L-01, step 6). In a control run a
+  // spec said the code would wrap and the built page scrolled it, and nothing
+  // measured the box: the page itself was not wider than the screen.
+  const sidewaysBoxes = [];
+  for (const el of [...document.body.querySelectorAll('*')].slice(0, 4000)) {
+    if (sidewaysBoxes.length >= 5) break;
+    const ox = getComputedStyle(el).overflowX;
+    if ((ox !== 'auto' && ox !== 'scroll') || el.scrollWidth <= el.clientWidth + 1 || !vis(el)) continue;
+    sidewaysBoxes.push({ box: el.tagName.toLowerCase() + (el.classList[0] ? '.' + el.classList[0] : ''), text: (el.innerText || '').trim().replace(/\\s+/g, ' ').slice(0, 40), scrollWidth: el.scrollWidth, clientWidth: el.clientWidth });
+  }
   return JSON.stringify({
     jigProbe: ${PROBE_VERSION},
     url: location.href,
@@ -6301,6 +6339,7 @@ var PROBE_SCRIPT = `(async () => {
     scrollWidth: doc.scrollWidth,
     clientWidth: doc.clientWidth,
     sidewaysScroll: doc.scrollWidth > doc.clientWidth,
+    sidewaysBoxes,
     bodyFont: getComputedStyle(document.body).fontFamily,
     defaultFont: getComputedStyle(document.body).fontFamily === defaultFont,
     unresolvedTokens: [...unresolved],
@@ -6317,6 +6356,7 @@ var PROBE_SCRIPT = `(async () => {
       canonical: (document.querySelector('link[rel=canonical]') || {}).href || '',
       robots: (document.querySelector('meta[name=robots]') || {}).content || '',
       ogTitle: (document.querySelector('meta[property="og:title"]') || {}).content || '',
+      ogDescription: (document.querySelector('meta[property="og:description"]') || {}).content || '',
       ogImage: (document.querySelector('meta[property="og:image"]') || {}).content || '',
     },
     contentWidth: Math.round(region.getBoundingClientRect().width),
@@ -6765,29 +6805,34 @@ function readProbes(projectRoot, dir, errors) {
 }
 var TITLE_BUDGET2 = 60;
 var DESCRIPTION_BUDGET2 = 155;
-function probeContradictions(probes, verdictOf, indexable = true) {
+function probeCheck(probes, verdictOf, indexable = true, mode) {
   const errors = [];
+  const failures = [];
   const clean = (id) => ["ok", "n/a"].includes(verdictOf(id) ?? "");
   const at = (p) => `probe-${p.width}.json`;
   for (const p of probes) {
     if (p.sidewaysScroll && clean("D-115")) {
       errors.push(`D-115 is "${verdictOf("D-115")}", but ${at(p)} measured the page ${p.scrollWidth}px wide in a ${p.clientWidth}px viewport \u2014 it scrolls sideways.`);
     }
+    if (mode === "editorial" && p.width <= 480 && p.sidewaysBoxes?.length) {
+      const shown = p.sidewaysBoxes.map((b) => `${b.box}${b.text ? ` ("${b.text}")` : ""}, ${b.scrollWidth}px in ${b.clientWidth}px`).join("; ");
+      failures.push(`${at(p)}: ${p.sidewaysBoxes.length === 1 ? "a box scrolls" : `${p.sidewaysBoxes.length} boxes scroll`} sideways on a phone: ${shown}. \`editorial\` allows no scrolling region on mobile (M-01): a code block wraps its long lines, keeping its line breaks and indents, and a wide table stacks its rows (L-01, step 6).`);
+    }
     if (p.defaultFont) {
-      errors.push(`${at(p)}: the page renders in the browser's default font (${p.bodyFont ?? "unknown"}) \u2014 its styles are not applying. No review of this page can pass until they do.`);
+      failures.push(`${at(p)}: the page renders in the browser's default font (${p.bodyFont ?? "unknown"}) \u2014 its styles are not applying. No review of this page can pass until they do.`);
     }
     if (p.fauxFaces?.length) {
       const shown = p.fauxFaces.map((f) => `${f.family} ${f.weight}${f.style === "italic" ? " italic" : ""} ("${f.text}")`).join(", ");
-      errors.push(`${at(p)}: the page asks for ${shown}, and no loaded face covers ${p.fauxFaces.length === 1 ? "it" : "them"}, so the browser fakes the weight or slant from the nearest face it has. Load that weight, or use one the page already loads.`);
+      failures.push(`${at(p)}: the page asks for ${shown}, and no loaded face covers ${p.fauxFaces.length === 1 ? "it" : "them"}, so the browser fakes the weight or slant from the nearest face it has. Load that weight, or use one the page already loads.`);
     }
     if (p.unresolvedTokens.length) {
-      errors.push(`${at(p)}: ${p.unresolvedTokens.length} token(s) have no value in the browser (${p.unresolvedTokens.slice(0, 6).join(", ")}) \u2014 every property using them is dropped (H-117).`);
+      failures.push(`${at(p)}: ${p.unresolvedTokens.length} token(s) have no value in the browser (${p.unresolvedTokens.slice(0, 6).join(", ")}) \u2014 every property using them is dropped (H-117).`);
     }
     for (const inv of p.orderInversions ?? []) {
-      errors.push(`${at(p)}: "${inv.seenFirst}" is read first on screen but comes after "${inv.markupFirst}" in the markup. At this width the markup order is not the reading order (H-119) \u2014 reorder the document, or move it with CSS that leaves the order intact.`);
+      failures.push(`${at(p)}: "${inv.seenFirst}" is read first on screen but comes after "${inv.markupFirst}" in the markup. At this width the markup order is not the reading order (H-119) \u2014 reorder the document, or move it with CSS that leaves the order intact.`);
     }
     if (p.emDashes?.length) {
-      errors.push(`${at(p)}: the rendered page shows an em dash in ${p.emDashes.map((t) => `"${t}"`).join(", ")} (I-118) \u2014 use a full stop, a comma, a colon, or a second element.`);
+      failures.push(`${at(p)}: the rendered page shows an em dash in ${p.emDashes.map((t) => `"${t}"`).join(", ")} (I-118) \u2014 use a full stop, a comma, a colon, or a second element.`);
     }
     if (clean("B-106") && p.strandedCount) {
       const shown = (p.strandedWords ?? []).map((w) => `"${w.word}" (in "${w.text}\u2026")`).join(", ");
@@ -6801,17 +6846,21 @@ function probeContradictions(probes, verdictOf, indexable = true) {
     if (head && p.width === probes[0]?.width) {
       const noindex = /noindex/i.test(head.robots);
       if (indexable && !noindex) {
-        if (!head.title) errors.push(`${at(p)}: the page served no <title> (J-121) \u2014 a search result then shows a truncated URL.`);
-        else if (head.title.length > TITLE_BUDGET2) errors.push(`${at(p)}: the title served is ${head.title.length} characters, past the ${TITLE_BUDGET2} a search result shows (J-122): "${head.title}".`);
-        if (!head.description) errors.push(`${at(p)}: the page served no meta description (J-121) \u2014 the search engine writes one from whatever text it finds first, usually the navigation.`);
-        else if (head.description.length > DESCRIPTION_BUDGET2) errors.push(`${at(p)}: the description served is ${head.description.length} characters, past the ${DESCRIPTION_BUDGET2} (J-122).`);
+        if (!head.title) failures.push(`${at(p)}: the page served no <title> (J-121) \u2014 a search result then shows a truncated URL.`);
+        else if (head.title.length > TITLE_BUDGET2) failures.push(`${at(p)}: the title served is ${head.title.length} characters, past the ${TITLE_BUDGET2} a search result shows (J-122): "${head.title}".`);
+        if (!head.description) failures.push(`${at(p)}: the page served no meta description (J-121) \u2014 the search engine writes one from whatever text it finds first, usually the navigation.`);
+        else if (head.description.length > DESCRIPTION_BUDGET2) failures.push(`${at(p)}: the description served is ${head.description.length} characters, past the ${DESCRIPTION_BUDGET2} (J-122).`);
+        if (typeof head.ogDescription === "string" && (!head.ogTitle || !head.ogDescription)) {
+          const missing = [!head.ogTitle && "og:title", !head.ogDescription && "og:description"].filter(Boolean).join(" and ");
+          failures.push(`${at(p)}: the page served no ${missing} (J-164) \u2014 a link to it, pasted into a message or a post, shows a card built from whatever the page happens to carry.`);
+        }
       }
       if (!indexable && !noindex) {
-        errors.push(`${at(p)}: this page is not indexable, and the page served no noindex (J-123). robots.txt is public and advisory, and is not this.`);
+        failures.push(`${at(p)}: this page is not indexable, and the page served no noindex (J-123). robots.txt is public and advisory, and is not this.`);
       }
     }
     if (p.junkText.length) {
-      errors.push(`${at(p)}: the rendered text contains ${p.junkText.map((j) => `"${j}"`).join(", ")} \u2014 template code or a failed value is showing to readers.`);
+      failures.push(`${at(p)}: the rendered text contains ${p.junkText.map((j) => `"${j}"`).join(", ")} \u2014 template code or a failed value is showing to readers.`);
     }
   }
   const navClean = clean("P-14") || clean("E-61");
@@ -6842,7 +6891,7 @@ function probeContradictions(probes, verdictOf, indexable = true) {
       if (broken.length) errors.push(`P-14 is "${verdictOf("P-14")}", but ${at(phone)} operated the menu: ${broken.join("; ")}.`);
     }
   }
-  return errors;
+  return { contradictions: errors, failures };
 }
 
 // src/check/decisions.ts
@@ -7336,6 +7385,7 @@ function verifyVerdicts(opts) {
     const v = screenVerdicts.find((x) => typeof x.id === "string" && x.id.trim().toUpperCase() === id);
     return typeof v?.verdict === "string" ? v.verdict : void 0;
   };
+  const measured = [];
   let specFront = "";
   try {
     specFront = readText(join38(opts.projectRoot, ".jig", "specs", `${opts.surface}.spec.md`)).split(/^---\s*$/m)[1] ?? "";
@@ -7344,14 +7394,24 @@ function verifyVerdicts(opts) {
   if (specIndexableField(specFront) === "unreadable") {
     errors.push(`.jig/specs/${opts.surface}.spec.md: \`indexable:\` is neither true nor false, so this review cannot tell whether the page is meant to be found and does not guess. Write \`indexable: true\` or \`indexable: false\`, and put the reason in the spec's body.`);
   } else {
-    errors.push(...probeContradictions(probes, verdictOf, specIndexable(opts.projectRoot, opts.surface)));
+    const mode = /^\s*mode\s*:\s*["']?(\w+)/im.exec(specFront)?.[1]?.toLowerCase();
+    const probed = probeCheck(probes, verdictOf, specIndexable(opts.projectRoot, opts.surface), mode);
+    errors.push(...probed.contradictions);
+    const seen = /* @__PURE__ */ new Set();
+    for (const failure of probed.failures) {
+      const what = failure.replace(/^probe-\d+\.json: /, "");
+      if (!seen.has(what)) {
+        seen.add(what);
+        measured.push(failure);
+      }
+    }
   }
   if (screen.state === "ran" && !rendered) screen.state = "skipped";
   const decisions = checkDecisions(opts.projectRoot, dir, errors);
   const field = (a) => a.state === "ran" ? `ran:${a.judged}` : `${a.state}:${a.judged}${a.state === "incomplete" ? `/${a.total}` : ""}`;
-  const line = `JIG_VERDICTS: surface=${opts.surface} screen=${field(screen)} code=${field(code)} decisions=${field(decisions)} rendered=${rendered ? "yes" : "no"} findings=${screen.findings + code.findings + decisions.findings}${(screen.ruled ?? 0) + (code.ruled ?? 0) ? ` ruled=${(screen.ruled ?? 0) + (code.ruled ?? 0)}` : ""}`;
+  const line = `JIG_VERDICTS: surface=${opts.surface} screen=${field(screen)} code=${field(code)} decisions=${field(decisions)} rendered=${rendered ? "yes" : "no"} findings=${screen.findings + code.findings + decisions.findings}${(screen.ruled ?? 0) + (code.ruled ?? 0) ? ` ruled=${(screen.ruled ?? 0) + (code.ruled ?? 0)}` : ""}${measured.length ? ` measured=${measured.length}` : ""}`;
   const previous = previousFindings(opts.projectRoot, dir);
-  return { ok: errors.length === 0, errors, screen, code, decisions, rendered, line, ...previous ? { previous } : {} };
+  return { ok: errors.length === 0, errors, screen, code, decisions, rendered, measured, line, ...previous ? { previous } : {} };
 }
 function previousFindings(projectRoot, dir) {
   const git = (args) => execFileSync3("git", args, { cwd: projectRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
@@ -7816,6 +7876,10 @@ function pageStatus(projectRoot, surface) {
   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 (v.measured.length) {
+    const also = findings > 0 ? `, and ${findings} finding${findings === 1 ? "" : "s"} the owner has not ruled on` : "";
+    return { surface, state: "findings", detail: `the page fails ${v.measured.length} check${v.measured.length === 1 ? "" : "s"} the render probe measured (\`jig verdicts ${surface}\` lists them)${also}` };
+  }
   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" };
 }
@@ -7879,7 +7943,15 @@ function ownerWordProblem(word, quoted, owner, where) {
 function specChecksum(body) {
   return createHash2("sha256").update(body.replace(/\r\n/g, "\n").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 mockupField(body) {
+  const raw = /^\s*mockup\s*:\s*(.*)$/im.exec(body.split(/^---\s*$/m)[1] ?? "")?.[1]?.trim() ?? "";
+  const double = /^"((?:[^"\\]|\\.)*)"\s*(?:#.*)?$/.exec(raw);
+  if (double) return double[1].replace(/\\(.)/g, "$1").trim();
+  const single = /^'((?:[^']|'')*)'\s*(?:#.*)?$/.exec(raw);
+  if (single) return single[1].replace(/''/g, "'").trim();
+  return raw;
+}
+var mockupLine = mockupField;
 function mockupWordProblems(spec, then, owner) {
   const now = mockupLine(spec.body);
   if (now === mockupLine(then)) return [];
@@ -8199,7 +8271,7 @@ function commandProblems(root, command, surface, 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() ?? "";
+    const mockup = mockupField(spec.body);
     if (/^pending/i.test(mockup) || !mockup) problems.push(`${spec.path}: \`mockup:\` is still pending. It records the user's own word \u2014 approved, or skipped with their reason.`);
     const at = /^\s*mockup_at\s*:\s*(.+)$/im.exec(front)?.[1]?.trim().replace(/^["']|["']$/g, "") ?? "";
     if (/^approved/i.test(mockup)) {
@@ -8212,7 +8284,7 @@ function commandProblems(root, command, surface, start, owner = "") {
   if (command === "tweak" && spec) problems.push(...tweakProblems(root, spec, owner, start));
   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] ?? "";
+    const mockup = mockupField(spec.body);
     const at = /^\s*mockup_at\s*:\s*(.+)$/im.exec(front)?.[1]?.trim().replace(/^["']|["']$/g, "") ?? "";
     if (/^approved/i.test(mockup) && /\.html?$/i.test(at) && !/^https?:/i.test(at)) {
       const drift = approvedDrawingProblems(root, spec.body, at);
@@ -8233,7 +8305,7 @@ function commandProblems(root, command, surface, start, owner = "") {
   }
   if (command === "mockup" && spec) {
     const front = spec.body.split(/^---\s*$/m)[1] ?? "";
-    const mockup = /^\s*mockup\s*:\s*(\S+)/im.exec(front)?.[1] ?? "";
+    const mockup = mockupField(spec.body);
     const at = /^\s*mockup_at\s*:\s*(.+)$/im.exec(front)?.[1]?.trim().replace(/^["']|["']$/g, "") ?? "";
     if (/^approved/i.test(mockup) && at && !/^https?:/i.test(at) && existsSync27(join43(root, at))) {
       const changedAfter = drawingChangedAfterApproval(root, spec.path, at);
@@ -8361,8 +8433,8 @@ function tweakProblems(root, spec, owner = "", start) {
   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\`.`);
-  const mockup = /^\s*mockup\s*:\s*(\S+)/im.exec(front)?.[1] ?? "";
-  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\`.`);
+  const mockup = mockupField(spec.body);
+  if (!/^(approved|skipped)/i.test(mockup)) problems.push(`${spec.path}: \`mockup:\` is ${mockup.split(/\s/)[0] || "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(join43(root, ".jig", "critique", surface));
@@ -8536,6 +8608,13 @@ ${result.report}`);
 ` + shown.join("\n") + (v.errors.length > shown.length ? `
   \u2026 and ${v.errors.length - shown.length} more` : "")
         );
+      } else if (v.measured.length && command !== "critique") {
+        const shown = v.measured.slice(0, 6).map((e) => `  ${e}`);
+        problems.push(
+          `jig verdicts ${surface}: the page fails what the render probe measured. Fix the page, then re-take the probes (\`jig verdicts ${surface} --reprobe\`).
+` + shown.join("\n") + (v.measured.length > shown.length ? `
+  \u2026 and ${v.measured.length - shown.length} more` : "")
+        );
       }
     }
   }
@@ -8874,6 +8953,10 @@ program.command("verdicts").description("Verify a critique's verdict files and c
       console.error(`  The page changed after these probes. \`jig verdicts ${surface} --reprobe\` re-takes them on the page as it is now.`);
     }
     if (result.ok) console.log(`  Every rule in both passes has a verdict.`);
+    if (result.measured.length) {
+      console.log(`  The page fails ${result.measured.length} check(s) the render probe measured. They are findings on the page, for make or tweak to fix; a critique reports them and leaves the page as it is:`);
+      for (const failure of result.measured) console.log(`  ! ${failure}`);
+    }
     const since = result.decisions.since ?? [];
     if (since.length) console.log(`  ${since.length} decision(s) recorded after this critique, for the next one to judge: ${since.join(", ")}.`);
     const p = result.previous;
@@ -8894,7 +8977,7 @@ program.command("check").description("Check the repo against Jig's mechanical +
   // this as widening the RULES and attested a clean diff as a clean project.
   "scan every file in the repo, not just those changed since HEAD (same rules either way)",
   false
-).option("--ci", "mechanical bucket only; exits non-zero on any error, deterministic", false).option("--json", "emit findings as JSON", false).action((opts) => {
+).option("--ci", "mechanical bucket only, so the run is deterministic", false).option("--json", "emit findings as JSON", false).action((opts) => {
   const projectRoot = findProjectRoot(process.cwd());
   try {
     const result = check({
@@ -8905,7 +8988,8 @@ program.command("check").description("Check the repo against Jig's mechanical +
       ci: opts.ci
     });
     console.log(opts.json ? JSON.stringify(result.findings, null, 2) : result.report);
-    if (opts.ci && result.hasError) process.exit(1);
+    const code = checkExitCode(result);
+    if (code !== 0) process.exit(code);
   } catch (err) {
     console.error(err.message);
     process.exit(1);

package/examples/J-164.html

@@ -0,0 +1,7 @@
+<!-- J-164 · An indexable page a link preview cannot read -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="font-size:12px;color:#57534e;margin-bottom:6px">Sam, in a team chat:</div><div style="background:#fff;border:1px solid #d6d3d1;border-radius:8px;padding:10px;"><div style="color:#1a0dab;font-size:13px">tidewell.io/pricing</div><div style="border-left:3px solid #d6d3d1;margin-top:8px;padding-left:8px;font-size:12px;color:#4d5156">Tidewell<br>Home · Product · Docs · Pricing · Sign in</div></div><div style="font-size:11px;color:#5c5c5c;margin-top:8px">No preview tags: the card is the site's name and its navigation.</div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="font-size:12px;color:#57534e;margin-bottom:6px">Sam, in a team chat:</div><div style="background:#fff;border:1px solid #d6d3d1;border-radius:8px;padding:10px;"><div style="color:#1a0dab;font-size:13px">tidewell.io/pricing</div><div style="border-left:3px solid #3f6212;margin-top:8px;padding-left:8px;font-size:12px;color:#1f1f1f"><b>Pricing · Tidewell</b><br><span style="color:#4d5156">Three plans, billed monthly or yearly. Cancel any time.</span></div></div><div style="font-size:11px;color:#5c5c5c;margin-top:8px">og:title and og:description: the card says what the page is.</div></div>
+</figure>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jig-ui",
-  "version": "0.24.0",
-  "description": "A design system for coding agents. 159 numbered UI rules, brand x mode design tokens, and an installer for Claude Code, Codex, Cursor and opencode.",
+  "version": "0.25.0",
+  "description": "A design system for coding agents. 160 numbered UI rules, brand x mode design tokens, and an installer for Claude Code, Codex, Cursor and opencode.",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {

package/rules/00-anti-patterns.md

@@ -365,7 +365,7 @@ Without `viewport-fit=cover`, the browser keeps the page inside the safe area on
 
 ### D-115 The page scrolls sideways on a phone
 ❌ At phone width the whole page is wider than the screen — a data table, a long URL, an image, a `width: 100vw` element or a fixed-width block pushes it out, and the reader can drag the page left and right
-✅ At every width, nothing makes the page wider than the screen. Content that is genuinely wider — a data table, a code block — scrolls inside its own container with a visible edge (`E-62`), and the page itself never does. `editorial` goes further and allows no scrolling regions on mobile at all (`M-01`).
+✅ At every width, nothing makes the page wider than the screen. Content that is genuinely wider — a data table, a code block — scrolls inside its own container with a visible edge (`E-62`), and the page itself never does. `editorial` goes further and allows no scrolling regions on mobile at all (`M-01`): there a code block wraps its long lines and a wide table stacks its rows (`L-01`, step 6).
 Judge it on a render, not in the source: at 360px, `document.documentElement.scrollWidth` must not be greater than `document.documentElement.clientWidth`. The usual causes are each one line to fix — `overflow-wrap: anywhere` on text the author does not control, `max-width: 100%` on media, `width: 100%` instead of `100vw` (which includes the scrollbar), and a wrapper with `overflow-x: auto` around anything tabular.
 A page that scrolls sideways is not merely untidy. The reader's vertical swipes drift, the page slides half off the screen, and every line of text needs re-centring before it can be read.
 
@@ -376,6 +376,7 @@ Agents render the happy path. This section exists because that is the single mos
 ### E-28 Missing states
 ❌ A component with only a default appearance
 ✅ Every interactive element defines: `hover`, `focus-visible`, `active`, `disabled`. Every data view defines: loading, empty, error, and partial/truncated.
+A browser makes an `<iframe>` a tab stop whether or not anything in it can be used. One that only shows something, with nothing inside to operate or scroll, is taken out of the tab order (`tabindex="-1"`) rather than given states it has no use for; a keyboard reader otherwise meets a stop with nothing to see. One the reader uses (a player, a map, a form) keeps its stop and shows focus.
 
 ### E-29 Focus removed without replacement
 ❌ `outline: none` with nothing in its place
@@ -411,7 +412,7 @@ Where disabling is genuinely right, put a message beside it or a tooltip on it e
 ❌ A toolbar of icon-only buttons whose meaning depends on recognising the glyph
 ✅ A visible text label beside the icon, or the icon plus label on the primary path.
 This is **not** the same problem as `E-34`. An `aria-label` serves a screen reader and does nothing for a sighted user with low computer literacy, or anyone meeting an unfamiliar glyph. Both are required.
-Icon-only is acceptable for a small set of near-universal glyphs (close, search, menu) and in `operator`, where repetition builds recognition — and even there, on first-run surfaces the label stays.
+Icon-only is acceptable for a small set of near-universal glyphs and in `operator`, where repetition builds recognition — and even there, on first-run surfaces the label stays. Close, search and menu are examples, not the whole list: the test is whether most readers would name the glyph the same way without the label. A sun and moon for the theme, or a service's own widely known mark linking to it, usually pass; a funnel, a sparkle or a lightning bolt does not. An icon-only control still carries its name in text a screen reader reads (`E-34`).
 
 ### E-52 Unconventional controls
 ❌ A bespoke form field, checkbox or select that looks and behaves unlike every other one the user has met
@@ -713,6 +714,11 @@ A second copy of the positioning is a second thing to keep in step by hand, whic
 ✅ Concatenate the static routes unconditionally, and let a failed read yield the stale list rather than an empty one. When a list is genuinely empty, prove it before shipping.
 An empty sitemap is not a missing sitemap. It is a positive claim, and the crawler believes it.
 
+### J-164 An indexable page a link preview cannot read
+❌ A link pasted into a message or a post that shows a bare address, or the site's name over a line of its navigation
+✅ Every indexable page states its own preview: `og:title` and `og:description`, beside its `<title>` and meta description, and `og:type` for what it is (`article` for a post). An image and `og:url` take the page's full address: add them once the site has one, never as a relative path.
+The card is met before the page, often by someone who never opens it. Without these tags each service builds the card from whatever it finds, and they find different things. A preview is copy, like the title and description: the change that rewrites the page rewrites its card (`J-120`), and a value the page already holds is read, not typed again (`J-126`).
+
 ---
 
 ## K. Safety at the interface

package/rules/01-modes.md

@@ -85,7 +85,7 @@ Resolved values: `02-tokens.md` — the option sets for type, spacing, radius an
 - One hero maximum, at the top. A second full-viewport section is a second hero.
 - Every page states its subject above the fold in text, not only in an image.
 - Prose blocks are measure-capped even when the container is wide.
-- No horizontal scrolling regions on mobile. Reflow instead.
+- No horizontal scrolling regions on mobile. Reflow instead: a code block wraps its long lines, keeping its line breaks and indents, and a table too wide for the screen stacks its rows, each cell with its column's name (`L-01`, step 6).
 - JavaScript: **none by default.** A content page ships no script unless a feature on it needs some: a theme toggle, a search box, a filter. That is a default, not an absolute zero. Each script names, in a comment, the feature and the decision or rule that asks for it, and a review judges whether the feature needs it and whether it is as small as the feature allows, not whether it exists. What the budget forbids is script no feature asks for: a framework runtime to render static text, a library for one effect, tracking bundled into the page. **Behaviour a rule requires is not a feature and is not counted**: a few lines whose only job is something a rule asks for and the browser does not give, such as `Escape` closing a `<details>` menu, or a tap outside closing a menu in a fixed header (`P-14`), are allowed in every mode, under 1 KB, with the rule named in a comment. Nothing else rides along in them.
 
 ---
@@ -190,7 +190,7 @@ Attempting to vary these by mode is a category error:
 - **Accessibility floors.** Contrast, focus indication, target size, semantic markup. Identical in all three. `operator` being dense does not license a 24px tap target or a 3:1 body contrast.
 - **Brand identity.** Palette, typeface, logo, voice.
 - **State completeness.** Every mode renders loading, empty, error and disabled.
-- **The anti-pattern file.** All 128 rules in it apply everywhere.
+- **The anti-pattern file.** All 129 rules in it apply everywhere.
 
 ---
 

package/rules/03-patterns.md

@@ -564,10 +564,20 @@ everything else follows from.
    fluid: they track the viewport between a floor and a ceiling with no media
    query at all. A hand-written ladder of sizes per breakpoint reintroduces the
    jumps the scale exists to remove, and goes stale the moment the scale changes.
-5. **Content that is genuinely wider scrolls inside itself.** A code block, a
-   wide table, a long identifier: its own container scrolls with a visible edge
-   (`E-62`), keeps its type size, and the page never scrolls sideways (`D-115`).
-   `editorial` allows no scrolling region on mobile at all (`M-01`).
+5. **Content that is genuinely wider scrolls inside itself, except in
+   `editorial` on a phone.** A code block, a wide table, a long identifier: its
+   own container scrolls with a visible edge (`E-62`), keeps its type size, and
+   the page never scrolls sideways (`D-115`). `editorial` allows no scrolling
+   region on mobile (`M-01`), so there each one reflows instead:
+   - **A code block** keeps its line breaks and indents and wraps a long line
+     (`white-space: pre-wrap`, `overflow-wrap: anywhere`). What is copied is
+     the source as written, not the wrapped lines.
+   - **A table too wide to fit** stacks its rows: each row a block, each cell a
+     line with its column's name in front. It stays a `<table>` with its header
+     row, so a screen reader still reads it as one. Where it fits, it stays a
+     table: the switch is the width at which its columns stop fitting.
+   - **A long identifier** (a URL, a hash, a file path) breaks where it must
+     (`overflow-wrap: anywhere`).
 6. **Each transition happens where the content needs it.** The width at which
    three columns stop fitting is a property of the columns, not of a device. Set
    it from the content, and expect the numbers to differ per component.

package/rules/05-copy.md

@@ -90,7 +90,7 @@ Whichever you choose, be consistent across sibling elements — a list where thr
 Interface text is read in fragments, at a glance, in a space someone else's content has to fit too. An em dash is a pause the reader has to interpret: it stands in for a comma, a colon, a bracket or a full stop, and which one it is only becomes clear after reading past it. The punctuation that says exactly one thing is faster.
 It is also the clearest tell of machine-written copy. Generated text reaches for the em dash far more often than a person does, and readers have learned to notice. Copy that reads as generated is copy the reader trusts less, whatever it says.
 This is about interface strings: labels, buttons, headings, errors, empty states, help text, and the prose a page ships. Markdown counts where a framework renders it as a page, which is most of them (`src/content`, `content/`, MDX routes). A repository document does not: `README.md`, `CHANGELOG.md`, `AGENTS.md` and their kin are written for whoever works on the code, and so are your commit messages and this file.
-A verbatim quotation keeps its own punctuation. Text a page quotes from another source (a document, a spec, a person), marked as a quotation with `<blockquote>` or `<q>`, is that source's words, and changing them to satisfy this rule would misquote it. The page's own copy around the quotation, and any heading or label it gives it, is still held to the rule.
+A verbatim quotation keeps its own punctuation. Text a page quotes from another source (a document, a spec, a person), marked as a quotation with `<blockquote>` or `<q>`, is that source's words, and so is a program's own output or code shown as it is, in `<pre>`, `<code>`, `<samp>` or `<kbd>`. Changing either to satisfy this rule would misquote it. The page's own copy around the quotation, and any heading or label it gives it, is still held to the rule.
 The en dash keeps its one job: ranges, where it is read as "to" (`2–10 seats`, `Mon–Fri`). That is not a pause, and it is not affected.
 
 ### I-87 Inconsistent vocabulary

package/rules.index.json

@@ -864,6 +864,13 @@
     "since": "0.14.0",
     "pass": "code"
   },
+  {
+    "id": "J-164",
+    "bucket": "mechanical",
+    "severity": "warning",
+    "since": "0.25.0",
+    "detector": "metadata"
+  },
   {
     "id": "K-128",
     "bucket": "mechanical",

package/templates/COMMAND.md.tmpl

@@ -322,10 +322,12 @@ Write the answer as `critique: each` or `critique: at-ship`.
 
 ### 2. Run `L-01`
 
-Read `L-01 · Layout method` in `{{rules_path}}/03-patterns.md` and run its five
+Read `L-01 · Layout method` in `{{rules_path}}/03-patterns.md` and run its six
 steps against the answers. The spec's structural half **is** that output — group,
-order by importance, space from the inside out, align to a grid, and state the
-hierarchy plainly enough that the squint question can be answered against it.
+order by importance, space from the inside out, align to a grid, state the
+hierarchy plainly enough that the squint question can be answered against it,
+and decide how it collapses. Step 6 is where the phone composition comes from,
+including what this mode does with a code block or table wider than the screen.
 
 ### 3. Write it down — one composition per screen size
 
@@ -483,7 +485,7 @@ to the spec, never the spec to the decisions.
 - **"The design system decides" is not a value.** When the user defers — "you decide",
   "whatever Jig says", "leave it to the system" — that is an instruction to look the
   answer up, not a phrase to copy into the spec. Search in this order: the `P-`
-  pattern for the component (`{{command_prefix}}explain <component>`), `L-01`'s five
+  pattern for the component (`{{command_prefix}}explain <component>`), `L-01`'s six
   steps, then the rules. Write the composition that lookup gives — "stacked, Pro
   first", "Menu button, links in a vertical list" — and cite the id it came from.
   Three of six specs in a live run wrote "arrangement decided by design system" into
@@ -599,6 +601,34 @@ its size's frame of the drawing at `mockup_at:`. Otherwise a spec can go through
 several confirmed rounds after its drawing was approved and still say `approved`
 over a drawing of none of them.
 
+### Before you stop: what the gate holds a spec to
+
+With the Stop hook, each of these keeps the session open until it is fixed. Get
+them right as you write, not after the gate names them:
+
+- **A spec writes under `.jig/` only.** A change to `DECISIONS.md`, a stylesheet or
+  a page is for `{{command_prefix}}decide`, `make` or `tweak`: record in the spec
+  what the owner said, and hand the change on.
+- **The front matter holds Jig's fields and nothing else.** Anything more goes in
+  the prose below it.
+- **Quotation marks within a few words after "owner", or after "the user said",
+  mark the owner's words.** What is inside them must be what the owner said: in
+  this conversation, in `DECISIONS.md`, or already in the spec. To name a
+  decision, a heading or a file near the word "owner", leave the quotation marks
+  off.
+- **`<name>.checked.json` is of the spec as it stands.** Its `spec` value matches
+  `{{scripts_path}} checksum <name>`, so an edit after the check means a second
+  check, of what changed.
+- **Each fact has one `source`:** a path from the project root, `path:line`, or a
+  URL, and nothing else. The file exists and the line is in it. Two places are two
+  facts; what you found at the source goes in `note`.
+- **`holds` is `true`, `false` or `"unchecked"`, with a `note` for anything but
+  `true`.** A fact found false is fixed in the spec before the owner is asked.
+- **`confirmed: true` only on the owner's yes, in this session, to the sheet you
+  showed them.** Words in the request that started the session came before the
+  sheet existed, and are not a reply to it, even when they say the owner
+  confirms. Show the sheet and stop.
+
 ## mockup
 
 **Low-fidelity design.** Draw the confirmed spec in grayscale, at every size it
@@ -849,6 +879,22 @@ confirmed again.
 With the Stop hook, the gate reads the quotation after `approved` or `skipped` and
 holds it to what the owner said in this session.
 
+### Before you stop: what the gate holds a mockup to
+
+- **A mockup writes under `.jig/` only:** the drawing in `.jig/mockups/`, and the
+  spec's `mockup:` and `mockup_at:` lines.
+- **The drawing shows what the spec lists**, at every size, and either side of each
+  switch the page crosses. The gate checks this before you put it to the owner.
+- **`mockup:` stays `pending` until the owner answers.** Then it is `approved` or
+  `skipped`, followed by their words in quotation marks: the reply that approves
+  this drawing, or says to skip it. Words that only say they looked at it, or
+  that are about something else, are not their word on the drawing. Ask them
+  whether they approve it for `make`, and quote the answer.
+- **`mockup_at:` names the approved drawing**, a file under `.jig/mockups/` that
+  exists, or a link.
+- **An approved drawing does not change.** Changing it after approval sets
+  `mockup: pending` and puts it to the owner again.
+
 Then stop. The next step is `{{command_prefix}}make`.
 
 ## make
@@ -1242,9 +1288,13 @@ The probe opens the phone menu, presses Escape, measures sideways scroll, and re
 whether the styles and tokens actually applied. `verdicts` refuses `rendered: true`
 without a probe at each width, and refuses an `ok` the probe contradicts — a `P-14`
 "ok" on a menu that did not open, a `D-115` "ok" on a page that scrolls sideways. It
-also fails a page that renders in the browser's default font, or shows `${` to
-readers, whatever the verdicts say. Never write a probe file yourself: when it
-disagrees with you, it is the review that is wrong.
+also names what the page fails whatever the verdicts say: it renders in the
+browser's default font, shows `${` or an em dash to readers, or serves a missing
+or overlong title or description. Those are findings on the page, listed under
+`!` and counted as `measured=` on the `JIG_VERDICTS` line. Put each in the report;
+make or tweak fixes them, and the critique leaves the page as it is.
+Never write a probe file yourself: when it disagrees with you, it is the review
+that is wrong.
 Then run:
 
 ```
@@ -1540,6 +1590,21 @@ judges it, and leave the verdicts alone. The page then owes a critique, and
 `{{command_prefix}}ship` will not pass until one has judged it. Never defer it
 on your own account: the gate refuses a deferral nobody gave.
 
+### Before you stop: what the gate holds a tweak to
+
+- **The spec is confirmed, and its mockup approved or skipped.** A page that has
+  neither goes through `mockup` and `make`.
+- **The page's regions and its approved drawing stay as they were.** A change to
+  what the page holds goes through `spec` and `mockup`.
+- **`tweak.json` holds `at`, `change`, `ids` and, when the owner said so,
+  `deferred`, and no other field.**
+- **`change` is the owner's words for the change, exactly as they gave them in
+  this session.** Nothing goes before or after them, not even a label such as
+  "the owner's words:". What you made of them goes in the spec's Tweak entry.
+- **`ids` names at least one rule or decision**, and each is re-judged by a reader
+  that did not make the change, unless `deferred` quotes the owner telling you to
+  leave it for later (or is `true` where the page's critique waits for ship).
+
 ### Finish
 
 Report what changed, in the owner's words; the decision and spec lines you

package/templates/SKILL.md.tmpl

@@ -49,7 +49,7 @@ cite the number when you follow or deliberately break one.
    says is lost to every check. If it keeps recurring, tell the owner, since
    Jig may be missing a field.
    **Building a screen rather than a single component?** Read `L-01 · Layout
-   method` in `{{rules_path}}/03-patterns.md` and run its five steps before
+   method` in `{{rules_path}}/03-patterns.md` and run its six steps before
    writing any markup. It is a procedure, not a component, so step 4 never
    selects it and nothing else will. (`explain L-01` prints it too, but the
    file is the source — do not skip the step if the command is unavailable.)