@domandigital/craft 0.12.0 → 0.14.0

package/dist/{chunk-S3NZAVU6.js → chunk-OOZOEWGD.js}

@@ -6,7 +6,7 @@ import {
   isCream,
   normaliseFamily,
   parseColour
-} from "./chunk-AL6MRG6V.js";
+} from "./chunk-GQVEYTBY.js";
 
 // src/direction/licences.ts
 var LICENCES = [

package/dist/{chunk-CDAJUS5U.js → chunk-PBK6SYH5.js}

@@ -1,23 +1,24 @@
 import {
-  groundName,
-  hueName,
-  loadNull,
-  shapeName
-} from "./chunk-LHGY43LL.js";
-import {
-  readSnapshot
-} from "./chunk-ZKVJ7K6X.js";
+  loadNull
+} from "./chunk-XVBR2UPH.js";
 import {
   parseFlags,
   toJson
-} from "./chunk-J3QUROJ5.js";
+} from "./chunk-3OTKMKJQ.js";
 import {
-  fingerprint,
-  fingerprintDistance
-} from "./chunk-PZ4MF2VV.js";
+  readSnapshot
+} from "./chunk-WUACK2HX.js";
 import {
-  auditSnapshot
-} from "./chunk-AL6MRG6V.js";
+  COMPONENT_ROLES,
+  auditSnapshot,
+  closestComponents,
+  estateComponentPairs,
+  fingerprint,
+  fingerprintDistance,
+  groundName,
+  hueName,
+  shapeName
+} from "./chunk-GQVEYTBY.js";
 
 // src/estate/cli.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -80,7 +81,7 @@ function siblingLine(briefs) {
 }
 
 // src/estate/cli.ts
-var USAGE = "usage: craft estate add <url | snapshot.json> --id <id> [--client <name>] | craft estate compare [<url | snapshot.json | id>] [--null <dir>] [--json] [--strict]";
+var USAGE = "usage: craft estate add <url | snapshot.json> --id <id> [--client <name>] | craft estate compare [<url | snapshot.json | id>] [--null <dir>] [--component <role>] [--json] [--strict]";
 function loadEstate(path) {
   if (!existsSync(path)) return emptyEstate();
   const data = JSON.parse(readFileSync(path, "utf8"));
@@ -94,7 +95,7 @@ async function snapshotOf(target, cwd) {
     return snap;
   }
   if (!/^https?:\/\//.test(target)) throw new Error(`${target} is neither a URL, a snapshot file, nor a site in the register`);
-  const { snapshotUrl } = await import("./audit-5QWFLZ6L.js");
+  const { snapshotUrl } = await import("./audit-6WHR7ZTV.js");
   return snapshotUrl(target);
 }
 var line = (distance, sibling, shared) => `${distance.toFixed(2)}${sibling ? "  SIBLING" : ""}${shared.length ? `  shares ${shared.join(", ")}` : ""}`;
@@ -110,6 +111,21 @@ function formatPairs(pairs, at, sites) {
   for (const p of pairs) lines.push(`  ${`${p.a} + ${p.b}`.padEnd(34)} ${line(p.distance, p.sibling, p.shared)}`);
   return lines.join("\n");
 }
+function componentRole(name) {
+  if (!COMPONENT_ROLES.includes(name)) throw new Error(`--component takes one of ${COMPONENT_ROLES.join(", ")}`);
+  return name;
+}
+var withRole = (register, role) => register.sites.filter((s) => (s.fingerprint.sections ?? []).some((x) => x.role === role)).length;
+function formatComponentPairs(role, pairs, measured, sites) {
+  const lines = [`craft estate: ${role} components, ${measured} of ${sites} sites have one, closest pairs first (no sibling line yet: ranked, not judged)`];
+  for (const p of pairs) lines.push(`  ${`${p.a} + ${p.b}`.padEnd(34)} ${p.distance.toFixed(2)}${p.shared.length ? `  shares ${p.shared.join(", ")}` : ""}`);
+  if (pairs.length === 0) {
+    lines.push(
+      measured < 2 ? `  fewer than two sites have a ${role} section measured. Roles come from snapshot version 2: re-add the sites from a fresh snapshot.` : "  no pairs"
+    );
+  }
+  return lines.join("\n");
+}
 async function runEstate(args, io) {
   try {
     const flags = parseFlags(args);
@@ -136,6 +152,24 @@ async function runEstate(args, io) {
       io.out(formatMatches(flags.id, compareToEstate(fp, next, { exclude: flags.id, siblingAt: at }).slice(0, 3), at));
       return 0;
     }
+    if (sub === "compare" && flags.component) {
+      const role = componentRole(flags.component);
+      if (!target) {
+        const pairs2 = estateComponentPairs(register, role);
+        const measured = withRole(register, role);
+        io.out(flags.json ? toJson({ role, measured, sites: register.sites.length, pairs: pairs2 }) : formatComponentPairs(role, pairs2, measured, register.sites.length));
+        return 0;
+      }
+      const known = register.sites.find((s) => s.id === target);
+      const fp = known ? known.fingerprint : fingerprint(await snapshotOf(target, io.cwd));
+      if (!(fp.sections ?? []).some((x) => x.role === role)) throw new Error(`${known?.id ?? target} has no ${role} section measured (roles need snapshot version 2)`);
+      const pairs = register.sites.filter((s) => s.id !== known?.id).flatMap((s) => {
+        const c = closestComponents(fp, s.fingerprint, role);
+        return c ? [{ a: known?.id ?? target, b: s.id, ...c }] : [];
+      }).sort((x, y) => x.distance - y.distance);
+      io.out(flags.json ? toJson({ role, measured: withRole(register, role), sites: register.sites.length, pairs }) : formatComponentPairs(role, pairs, withRole(register, role), register.sites.length));
+      return 0;
+    }
     if (sub === "compare") {
       if (!target) {
         const pairs = estatePairs(register, at);
@@ -161,5 +195,6 @@ export {
   loadEstate,
   formatMatches,
   formatPairs,
+  formatComponentPairs,
   runEstate
 };

package/dist/{chunk-ULPI335S.js → chunk-Q7ILL2HV.js}

@@ -2,12 +2,12 @@ import {
   decodePng
 } from "./chunk-JYNXGCYZ.js";
 import {
+  auditSnapshot,
   fingerprint
-} from "./chunk-PZ4MF2VV.js";
+} from "./chunk-GQVEYTBY.js";
 import {
-  SNAPSHOT_VERSION,
-  auditSnapshot
-} from "./chunk-AL6MRG6V.js";
+  SNAPSHOT_VERSION
+} from "./chunk-QYBAVU3P.js";
 
 // src/audit/collect.ts
 function collectInPage() {
@@ -220,7 +220,7 @@ function collectInPage() {
     let covered = 0;
     let minX = Infinity;
     let maxX = -Infinity;
-    let textBlocks = 0;
+    let textBlocks2 = 0;
     let centred = 0;
     for (const n of leaves) {
       const r = box(n);
@@ -232,14 +232,14 @@ function collectInPage() {
       left += split * r.height;
       right += (r.width - split) * r.height;
       if (ownText(n).length > 1) {
-        textBlocks += 1;
+        textBlocks2 += 1;
         const mid = r.left + r.width / 2;
         if (style(n).textAlign === "center" || Math.abs(mid - centreX) < vw * 0.03 && r.width < b.width * 0.8) centred += 1;
       }
     }
     const round = (v) => Math.round(v * 1e3) / 1e3;
     return {
-      centredShare: textBlocks ? round(centred / textBlocks) : 0,
+      centredShare: textBlocks2 ? round(centred / textBlocks2) : 0,
       mirrorSymmetry: left + right > 0 ? round(1 - Math.abs(left - right) / (left + right)) : 1,
       whitespaceRatio: round(Math.max(0, 1 - Math.min(1, covered / Math.max(1, b.width * b.height)))),
       contentWidthRatio: leaves.length ? round(Math.min(1, (maxX - minX) / vw)) : 0,
@@ -277,22 +277,87 @@ function collectInPage() {
     if (cards >= 3 && iconCards >= 2) return "features";
     return kind;
   };
+  const partsOf = (el) => {
+    const inside = Array.from(el.querySelectorAll("*")).slice(0, 1500).filter(shown);
+    const badges = [];
+    for (const n of inside) {
+      const t = ownText(n);
+      if (t.length < 2 || t.length > 24 || badges.length >= 5) continue;
+      const cs = style(n);
+      const r = box(n);
+      const radius = px(cs.borderTopLeftRadius);
+      const drawn = painted(cs.backgroundColor) || px(cs.borderTopWidth) >= 1;
+      if (drawn && r.height <= 40 && r.width <= 240 && radius >= r.height / 3 && !isControl(n)) badges.push(t);
+    }
+    const avatars = inside.filter((n) => {
+      if (n.tagName !== "IMG") return false;
+      const r = box(n);
+      const rad = style(n).borderTopLeftRadius;
+      const round = rad.endsWith("%") ? parseFloat(rad) >= 40 : px(rad) >= r.width * 0.4;
+      return r.width <= 96 && r.width >= 16 && Math.abs(r.width - r.height) <= r.width * 0.15 && round;
+    }).length;
+    const carousel = inside.some((n) => {
+      const cs = style(n);
+      if (n.getAttribute("aria-roledescription") === "carousel" || cs.scrollSnapType && cs.scrollSnapType !== "none") return true;
+      if (/^(auto|scroll|hidden)$/.test(cs.overflowX) && n.children.length >= 3 && n.scrollWidth > n.clientWidth * 1.2) return true;
+      return /^(BUTTON|A)$/.test(n.tagName) && /\b(prev|previous|next)\b/i.test(n.getAttribute("aria-label") ?? "");
+    });
+    return { badges, avatars, carousel };
+  };
+  const TEXT_BLOCK = "h1, h2, h3, h4, h5, h6, p, li, blockquote, figcaption, dt, dd, td, th, summary, cite, q";
+  const CHROME = "nav, [role=navigation], footer, [role=contentinfo], button, [role=button], [aria-hidden=true], script, style, noscript, template";
+  const readable = (el) => {
+    if (!shown(el)) return false;
+    const r = el.getBoundingClientRect();
+    return r.width > 2 && r.height > 2;
+  };
+  const textBlocks = (scope, limit, keep = () => true) => {
+    const out = [];
+    const seen = /* @__PURE__ */ new Set();
+    const add = (el) => {
+      const t = (el.textContent ?? "").replace(/\s+/g, " ").trim().slice(0, 300);
+      if (t.length < 2 || seen.has(t)) return;
+      seen.add(t);
+      out.push(t);
+    };
+    for (const el of Array.from(scope.querySelectorAll(TEXT_BLOCK))) {
+      if (out.length >= limit) break;
+      if (el.parentElement?.closest(TEXT_BLOCK) || el.closest(CHROME) || !readable(el) || !keep(el)) continue;
+      add(el);
+    }
+    for (const el of Array.from(scope.querySelectorAll("div, span"))) {
+      if (out.length >= limit) break;
+      if (ownText(el).split(" ").length < 3) continue;
+      if (el.closest(TEXT_BLOCK) || el.closest(CHROME) || el.closest("a") || !readable(el) || !keep(el)) continue;
+      add(el);
+    }
+    return out;
+  };
+  const inChromeHeader = (el) => {
+    const h = el.closest("header");
+    return Boolean(h && !h.querySelector("h1"));
+  };
+  const firstScreenText = textBlocks(document.body, 12, (el) => {
+    const b = box(el);
+    return b.top < vh && b.top + b.height > 0 && !inChromeHeader(el) && !el.closest("a");
+  });
   const kept = blocks.slice(0, 40);
   const sections = kept.map((el, index) => {
     const b = box(el);
     const heading = el.querySelector("h1, h2, h3");
     const label = (heading?.textContent ?? el.textContent ?? "").replace(/\s+/g, " ").trim().slice(0, 60);
-    const images = Array.from(el.querySelectorAll("img, svg")).filter((i) => shown(i) && box(i).height <= 90);
+    const images2 = Array.from(el.querySelectorAll("img, svg")).filter((i) => shown(i) && box(i).height <= 90);
     const textChars = (el.textContent ?? "").replace(/\s+/g, "").length;
     const numbers = Array.from(el.querySelectorAll("*")).filter((n) => /^[£$€]?\d[\d,.]*\s?(?:[%+kKmM★]|\/5|\+)?$/.test(ownText(n)) && px(style(n).fontSize) >= 24).length;
     const { cards, iconCards } = cardsIn(el);
     let kind = "text";
     if (marqueeTargets.some((t) => el.contains(t))) kind = "marquee";
     else if (h1 && el.contains(h1) || index === 0 && b.top < vh) kind = "hero";
-    else if (images.length >= 4 && textChars < 300) kind = "logos";
+    else if (images2.length >= 4 && textChars < 300) kind = "logos";
     else if (numbers >= 3 && textChars < 600) kind = "stats";
     else if (cards >= 3) kind = "cards";
     const geometry = geometryOf(el, b);
+    const parts = partsOf(el);
     return {
       top: Math.round(b.top),
       height: Math.round(b.height),
@@ -302,7 +367,10 @@ function collectInPage() {
       iconCards,
       hiddenAtLoad: b.top > vh && hiddenAtLoad(el),
       role: roleOf(el, kind, geometry, b, cards, iconCards, index === kept.length - 1),
-      geometry
+      geometry,
+      ...parts,
+      figures: numbers,
+      text: textBlocks(el, 40)
     };
   });
   if (header && sections.length === 0) {
@@ -384,6 +452,81 @@ function collectInPage() {
     const width = para.getBoundingClientRect().width - px(cs.paddingLeft) - px(cs.paddingRight);
     if (avg > 0 && width > 0) bodyLineLengthCh = Math.round(width / avg);
   }
+  const unwrap = (raw) => {
+    if (raw.startsWith("data:")) return raw.slice(0, 64);
+    try {
+      const u = new URL(raw, location.href);
+      const inner = /\/_(?:next|vercel)\/image$/.test(u.pathname) ? u.searchParams.get("url") : null;
+      if (inner) return new URL(inner, location.href).href;
+      const cf = u.pathname.match(/^\/cdn-cgi\/image\/[^/]+\/(.+)$/);
+      if (cf) return /^https?:\/\//.test(cf[1]) ? cf[1] : new URL(`/${cf[1]}`, location.href).href;
+      return u.href;
+    } catch {
+      return raw.slice(0, 200);
+    }
+  };
+  const roundBox = (el, w) => {
+    const rad = style(el).borderTopLeftRadius;
+    return rad.endsWith("%") ? parseFloat(rad) >= 40 : px(rad) >= w * 0.4;
+  };
+  const sectionOf = (el) => {
+    const i = kept.findIndex((k) => k.contains(el));
+    return i === -1 ? null : i;
+  };
+  const roleOfImage = (el, src, w, h, alt) => {
+    const vector = /\.svg(?:[?#]|$)/i.test(src) || src.startsWith("data:image/svg");
+    const square = Math.abs(w - h) <= w * 0.15;
+    if (w >= 16 && w <= 96 && square && (roundBox(el, w) || el.parentElement !== null && roundBox(el.parentElement, w))) return "avatar";
+    const section = sectionOf(el);
+    const hint = `${alt ?? ""} ${src} ${typeof el.className === "string" ? el.className : ""}`;
+    if (/\blogo\b/i.test(hint) || section !== null && sections[section]?.kind === "logos" || el.closest("header, footer, nav") && h <= 120) return "logo";
+    if (Math.max(w, h) <= (vector ? 120 : 72)) return "icon";
+    if (vector) return "illustration";
+    return w >= 160 && h >= 120 ? "photo" : "icon";
+  };
+  const images = [];
+  const seenImage = /* @__PURE__ */ new Set();
+  const addImage = (el, raw, alt, decorative, background) => {
+    const b = box(el);
+    if (!raw || b.width < 8 || b.height < 8) return;
+    const src = unwrap(raw);
+    const key = `${src} ${Math.round(b.top)} ${Math.round(b.left)}`;
+    if (seenImage.has(key)) return;
+    seenImage.add(key);
+    let host = null;
+    try {
+      host = src.startsWith("data:") ? null : new URL(src).hostname;
+    } catch {
+      host = null;
+    }
+    images.push({
+      src,
+      host,
+      width: Math.round(b.width),
+      height: Math.round(b.height),
+      top: Math.round(b.top),
+      role: roleOfImage(el, src, b.width, b.height, alt),
+      alt,
+      decorative,
+      section: sectionOf(el),
+      background
+    });
+  };
+  for (const img of Array.from(document.querySelectorAll("img")).slice(0, 400)) {
+    if (!shown(img)) continue;
+    const alt = img.getAttribute("alt");
+    const decorative = alt === "" || img.getAttribute("aria-hidden") === "true" || /^(?:presentation|none)$/.test(img.getAttribute("role") ?? "");
+    addImage(img, img.currentSrc || img.getAttribute("src") || "", alt, decorative, false);
+  }
+  for (const el of all) {
+    const bgImage = style(el).backgroundImage || "";
+    if (!bgImage.includes("url(")) continue;
+    const b = box(el);
+    if (b.width < 160 || b.height < 120 || !shown(el)) continue;
+    const m = bgImage.match(/url\(\s*["']?([^"')]+)["']?\s*\)/);
+    if (m) addImage(el, m[1], null, true, true);
+  }
+  images.sort((a, b) => b.width * b.height - a.width * a.height);
   const toList = (m) => Array.from(m, ([value, v]) => ({ value, area: Math.round(v.area), chars: v.chars })).sort((a, b) => b.area - a.area || b.chars - a.chars);
   const nums = (s) => Array.from(s).sort((a, b) => a - b);
   return {
@@ -403,6 +546,8 @@ function collectInPage() {
       return mean > 0 ? Math.round(sd / mean * 1e3) / 1e3 : null;
     })(),
     effects,
+    images: images.slice(0, 60),
+    firstScreenText,
     motion: {
       hiddenSections: sections.filter((s) => s.hiddenAtLoad).length,
       sections: sections.length,
@@ -494,7 +639,60 @@ function visualMeasures(img, maxSamples = 1e6) {
   };
 }
 
+// src/snapshot/provenance.ts
+var PROVENANCE_SCAN_BYTES = 256 * 1024;
+var AI_SOURCE_TYPES = ["compositeWithTrainedAlgorithmicMedia", "trainedAlgorithmicMedia"];
+var MARKER = new RegExp(`(?:${AI_SOURCE_TYPES.join("|")})`);
+var C2PA_BOX = /jumd[\s\S]{16,24}c2pa/;
+var C2PA_PNG = /caBX/;
+function latin1(bytes) {
+  let out = "";
+  for (let i = 0; i < bytes.length; i += 8192) {
+    out += String.fromCharCode(...bytes.subarray(i, Math.min(bytes.length, i + 8192)));
+  }
+  return out;
+}
+function xmpPackets(text) {
+  const out = [];
+  const open = /<x:xmpmeta\b|<\?xpacket begin/g;
+  let m;
+  while (m = open.exec(text)) {
+    const close = text.indexOf(m[0].startsWith("<x:") ? "</x:xmpmeta>" : "<?xpacket end", m.index);
+    out.push([m.index, close === -1 ? text.length : close]);
+    if (close === -1) break;
+    open.lastIndex = close;
+  }
+  return out;
+}
+function scanProvenance(bytes) {
+  const head = bytes.subarray(0, PROVENANCE_SCAN_BYTES);
+  const text = latin1(head);
+  const c2pa = C2PA_BOX.test(text) || text.startsWith("\x89PNG") && C2PA_PNG.test(text);
+  const m = MARKER.exec(text);
+  if (!m) return { digitalSourceType: null, source: null, c2pa, bytes: head.length };
+  const inXmp = xmpPackets(text).some(([a, b]) => m.index >= a && m.index < b);
+  return { digitalSourceType: m[0], source: inXmp ? "xmp" : c2pa ? "c2pa" : "other", c2pa, bytes: head.length };
+}
+
 // src/audit/index.ts
+var PROVENANCE_MAX_IMAGES = 24;
+var PROVENANCE_BUDGET_MS = 2e4;
+async function readProvenance(page, images, timeoutMs) {
+  if (!page.request) return;
+  const deadline = Date.now() + PROVENANCE_BUDGET_MS;
+  const wanted = [...new Set(images.filter((i) => i.role !== "icon" && i.role !== "logo" && /^https?:\/\//.test(i.src)).map((i) => i.src))].slice(0, PROVENANCE_MAX_IMAGES);
+  for (const src of wanted) {
+    const left = deadline - Date.now();
+    if (left < 500) break;
+    try {
+      const res = await page.request.get(src, { headers: { Range: `bytes=0-${PROVENANCE_SCAN_BYTES - 1}` }, timeout: Math.min(timeoutMs, left) });
+      if (!res.ok()) continue;
+      const provenance = scanProvenance(await res.body());
+      for (const image of images) if (image.src === src) image.provenance = provenance;
+    } catch {
+    }
+  }
+}
 var VISUAL_MAX_HEIGHT = 6e3;
 async function loadPlaywright() {
   for (const name of ["playwright", "playwright-core"]) {
@@ -513,6 +711,7 @@ async function snapshotPage(page, url, options = {}) {
   await page.waitForTimeout(options.introWindowMs ?? 5e3);
   const late = await page.evaluate(overlayInPage).catch(() => false);
   const data = await page.evaluate(collectInPage);
+  if (data.images && options.provenance !== false) await readProvenance(page, data.images, 8e3);
   let visual;
   if (page.screenshot && options.visual !== false) {
     try {
@@ -578,6 +777,8 @@ async function audit(url, options = {}) {
 export {
   collectInPage,
   overlayInPage,
+  PROVENANCE_MAX_IMAGES,
+  PROVENANCE_BUDGET_MS,
   VISUAL_MAX_HEIGHT,
   loadPlaywright,
   snapshotPage,

package/dist/chunk-QYBAVU3P.js

@@ -0,0 +1,6 @@
+// src/snapshot/types.ts
+var SNAPSHOT_VERSION = 2;
+
+export {
+  SNAPSHOT_VERSION
+};

package/dist/{chunk-ZKVJ7K6X.js → chunk-WUACK2HX.js}

@@ -1,6 +1,6 @@
 import {
   SNAPSHOT_VERSION
-} from "./chunk-AL6MRG6V.js";
+} from "./chunk-QYBAVU3P.js";
 
 // src/snapshot/migrate.ts
 var READABLE_SNAPSHOT_VERSIONS = [1, 2];
@@ -15,5 +15,6 @@ function readSnapshot(data, source = "snapshot") {
 }
 
 export {
+  READABLE_SNAPSHOT_VERSIONS,
   readSnapshot
 };

package/dist/chunk-XVBR2UPH.js

@@ -0,0 +1,217 @@
+import {
+  parseFlags,
+  toJson
+} from "./chunk-3OTKMKJQ.js";
+import {
+  readSnapshot
+} from "./chunk-WUACK2HX.js";
+import {
+  CATALOGUE_VERSION,
+  NULL_VERSION,
+  auditSnapshot,
+  checkCopy,
+  extractHtml,
+  extractStrings,
+  fingerprint,
+  harvest,
+  hueSwatch,
+  nullPrompt,
+  scanSource
+} from "./chunk-GQVEYTBY.js";
+
+// src/null/cli.ts
+import { spawn } from "child_process";
+import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "fs";
+import { tmpdir } from "os";
+import { join, relative, resolve } from "path";
+import { pathToFileURL } from "url";
+var readJson = (path) => JSON.parse(readFileSync(path, "utf8"));
+var pad = (n) => String(n).padStart(2, "0");
+function generate(prompt, model) {
+  const bin = process.env.CRAFT_CLAUDE ?? "claude";
+  const args = ["-p", "--tools", "", "--no-session-persistence", "--disable-slash-commands", "--setting-sources", "", "--strict-mcp-config", ...model ? ["--model", model] : [], prompt];
+  const cwd = mkdtempSync(join(tmpdir(), "craft-null-"));
+  return new Promise((done, fail) => {
+    const child = spawn(bin, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
+    let out = "";
+    let err = "";
+    child.stdout.on("data", (d) => out += d.toString());
+    child.stderr.on("data", (d) => err += d.toString());
+    child.on("error", (e) => fail(new Error(`${bin}: ${e.message}. Install Claude Code, or set CRAFT_CLAUDE.`)));
+    child.on("close", (code) => {
+      rmSync(cwd, { recursive: true, force: true });
+      if (code === 0) done(out);
+      else fail(new Error(`${bin} exited ${code}: ${(err || out).trim().slice(0, 200)}`));
+    });
+  });
+}
+async function pool(items, size, work) {
+  const queue = [...items];
+  await Promise.all(Array.from({ length: Math.max(1, Math.min(size, queue.length)) }, async () => {
+    for (let item = queue.shift(); item !== void 0; item = queue.shift()) await work(item);
+  }));
+}
+function nullPath(target, cwd) {
+  const abs = resolve(cwd, target);
+  return existsSync(abs) && statSync(abs).isDirectory() ? join(abs, "null.json") : abs;
+}
+function loadNull(target, cwd) {
+  const path = nullPath(target, cwd);
+  if (!existsSync(path)) throw new Error(`no null model at ${target}. Build one with craft null build.`);
+  const model = readJson(path);
+  if (model.version !== NULL_VERSION) throw new Error(`${target} is null model version ${String(model.version)}; this craft reads ${NULL_VERSION}`);
+  return model;
+}
+function measureRun(id, html, snapshot) {
+  const file = { path: `${id}.html`, text: html };
+  const tells = new Set([...auditSnapshot(snapshot).findings, ...scanSource([file]).findings].map((f) => f.tell));
+  const copy = [...new Set(extractStrings(file).filter((b) => !b.literal).map((b) => b.text.replace(/\s+/g, " ").trim()).filter(Boolean))];
+  return { id, fingerprint: fingerprint(snapshot), tells: [...tells].sort(), copy };
+}
+async function build(flags, io) {
+  const brief = flags.brief ?? (flags.direction ? readJson(resolve(io.cwd, flags.direction)).brief : void 0);
+  if (!brief || brief.trim().split(/\s+/).length < 5) throw new Error('usage: craft null build --brief "<who, where, what they do>" --out <dir> [--runs 20] [--parallel 4]');
+  if (!flags.out) throw new Error("--out <dir> is where the pages and null.json go");
+  const runs = Number(flags.runs ?? 20);
+  const parallel = Number(flags.parallel ?? 4);
+  if (!Number.isInteger(runs) || runs < 5) throw new Error("--runs needs a whole number, 5 or more");
+  const dir = resolve(io.cwd, flags.out);
+  const pages = join(dir, "pages");
+  const shots = join(dir, "snapshots");
+  mkdirSync(pages, { recursive: true });
+  mkdirSync(shots, { recursive: true });
+  const prompt = nullPrompt(brief);
+  const ids = Array.from({ length: runs }, (_, i) => pad(i + 1));
+  for (const id of ids) {
+    const path = join(pages, `${id}.html`);
+    if (!existsSync(path)) continue;
+    const raw = readFileSync(path, "utf8");
+    const html = extractHtml(raw);
+    if (!html) {
+      writeFileSync(join(pages, `${id}.reply.txt`), raw);
+      rmSync(path);
+      rmSync(join(shots, `${id}.json`), { force: true });
+      io.out(`  ${id} was a reply, not a page: kept as ${id}.reply.txt and generated again`);
+    } else if (html !== raw) writeFileSync(path, html);
+  }
+  const missing = ids.filter((id) => !existsSync(join(pages, `${id}.html`)));
+  const failed = [];
+  if (missing.length) io.out(`craft null: generating ${missing.length} page${missing.length === 1 ? "" : "s"}, ${parallel} at a time`);
+  await pool(missing, parallel, async (id) => {
+    try {
+      const reply = await generate(prompt, flags.model);
+      const html = extractHtml(reply);
+      if (!html) {
+        writeFileSync(join(pages, `${id}.reply.txt`), reply);
+        failed.push(`${id}: the reply held no HTML page (kept as ${id}.reply.txt)`);
+        return;
+      }
+      writeFileSync(join(pages, `${id}.html`), html);
+      io.out(`  ${id} written`);
+    } catch (error) {
+      failed.push(`${id}: ${error.message}`);
+    }
+  });
+  const toShoot = ids.filter((id) => existsSync(join(pages, `${id}.html`)) && !existsSync(join(shots, `${id}.json`)));
+  if (toShoot.length) {
+    io.out(`craft null: snapshotting ${toShoot.length} page${toShoot.length === 1 ? "" : "s"}`);
+    const { snapshotUrls } = await import("./audit-6WHR7ZTV.js");
+    const results = await snapshotUrls(toShoot.map((id) => pathToFileURL(join(pages, `${id}.html`)).href));
+    results.forEach((r, i) => {
+      const id = toShoot[i];
+      if (r.snapshot) writeFileSync(join(shots, `${id}.json`), `${JSON.stringify({ ...r.snapshot, url: `pages/${id}.html` }, null, 2)}
+`);
+      else failed.push(`${id}: the page would not render: ${r.error}`);
+    });
+  }
+  const measured = ids.filter((id) => existsSync(join(pages, `${id}.html`)) && existsSync(join(shots, `${id}.json`))).map((id) => measureRun(id, readFileSync(join(pages, `${id}.html`), "utf8"), readSnapshot(readJson(join(shots, `${id}.json`)), `${id}.json`)));
+  const model = {
+    version: NULL_VERSION,
+    brief: brief.trim(),
+    prompt,
+    model: flags.model ?? "default",
+    catalogueVersion: CATALOGUE_VERSION,
+    builtAt: (/* @__PURE__ */ new Date()).toISOString(),
+    runs: measured
+  };
+  writeFileSync(join(dir, "null.json"), `${JSON.stringify(model, null, 2)}
+`);
+  io.out(`craft null: ${measured.length} of ${runs} pages in ${relative(io.cwd, join(dir, "null.json")) || "null.json"}`);
+  for (const f of failed) io.err(`  ${f}`);
+  if (measured.length < runs) {
+    io.err(`craft null: ${runs - measured.length} missing. Run the same command again to fill them in.`);
+    return 1;
+  }
+  return 0;
+}
+function copyTell(phrase) {
+  const text = `We found that ${phrase} was there.`;
+  const hit = checkCopy([{ path: "phrase.md", text }]).findings[0];
+  return hit ? hit.tell : null;
+}
+function formatHarvest(candidates, models) {
+  const lines = [`craft tells harvest: ${models.reduce((s, m) => s + m.runs.length, 0)} null pages from ${models.length} brief${models.length === 1 ? "" : "s"}`];
+  const fresh = candidates.filter((c) => !c.known);
+  const known = candidates.filter((c) => c.known);
+  const runs = models.flatMap((m) => m.runs);
+  const line = (c) => {
+    const swatch = c.kind === "accent" ? hueSwatch(runs, c.value) : null;
+    const where = models.length > 1 ? `, ${c.briefs} brief${c.briefs === 1 ? "" : "s"}` : "";
+    return `  ${c.kind.padEnd(8)} ${`${c.value}${swatch ? ` (${swatch})` : ""}`.padEnd(44)} ${c.runs} of ${c.of}${where}${c.known ? `  caught by ${c.known}` : ""}`;
+  };
+  lines.push("", "Not on the catalogue: candidates for the next generation. A person decides.");
+  lines.push(...fresh.length ? fresh.map(line) : ["  none"]);
+  lines.push("", "Already caught: the catalogue still describes what the model builds.");
+  lines.push(...known.length ? known.map(line) : ["  none"]);
+  return lines.join("\n");
+}
+function describeTypicality(t, pages, briefs) {
+  const pct = Math.round(t.score * 100);
+  return [
+    `Typicality against ${pages} null pages from ${briefs} brief${briefs === 1 ? "" : "s"}`,
+    `  score      ${t.score.toFixed(2)}: ${t.typical ? "typical" : "not typical"}. ${pct}% of the model's own pages sit further from the rest than this one.`,
+    `  distance   ${t.distance.toFixed(3)} to its nearest null pages; the null's own median is ${t.baseline.toFixed(3)}`,
+    `  nearest    ${t.nearest.map((n) => `${n.id} ${n.distance.toFixed(2)}`).join(", ")}`,
+    `  shares     ${t.shared.map((s) => `${s.part} ${s.value} (${s.runs} of ${s.of})`).join(", ") || "no choice with a quarter of the null"}`
+  ].join("\n");
+}
+async function runNull(args, io) {
+  try {
+    const flags = parseFlags(args);
+    if (typeof flags === "string") throw new Error(flags);
+    if (flags.positional[0] !== "build") throw new Error('usage: craft null build --brief "<text>" --out <dir> [--runs 20] [--parallel 4] [--model <name>]');
+    return await build(flags, io);
+  } catch (error) {
+    io.err(`craft: ${error.message}`);
+    return 2;
+  }
+}
+function runHarvest(args, io) {
+  const flags = parseFlags(args);
+  if (typeof flags === "string") throw new Error(flags);
+  const targets = flags.positional.slice(1);
+  if (targets.length === 0) throw new Error("usage: craft tells harvest <null.json | dir>... [--share 0.25] [--json]");
+  const paths = targets.flatMap((t) => {
+    const abs = resolve(io.cwd, t);
+    if (existsSync(abs) && statSync(abs).isDirectory() && !existsSync(join(abs, "null.json"))) {
+      return readdirSync(abs).map((d) => join(abs, d, "null.json")).filter((p) => existsSync(p));
+    }
+    return [t];
+  });
+  const models = paths.map((p) => loadNull(p, io.cwd));
+  const minShare = flags.share === void 0 ? void 0 : Number(flags.share);
+  if (minShare !== void 0 && !(minShare > 0 && minShare <= 1)) throw new Error("--share needs a number above 0 and at most 1");
+  const candidates = harvest(models, { minShare, copyTell });
+  io.out(flags.json ? toJson({ briefs: models.map((m) => m.brief), candidates }) : formatHarvest(candidates, models));
+  return 0;
+}
+
+export {
+  nullPath,
+  loadNull,
+  measureRun,
+  formatHarvest,
+  describeTypicality,
+  runNull,
+  runHarvest
+};