@domandigital/craft 0.13.0 → 0.15.0

package/dist/{chunk-3VTPI7BU.js → chunk-MUVFECFC.js}

@@ -4,13 +4,19 @@ import {
   HOUSE_LOCKED,
   applyHouseGate,
   checkCopy,
+  compareCompetitor,
+  compareFacts,
   extractCopy,
-  extractStrings,
   fileKind,
+  formatComparison,
+  formatCompetitor,
   holdHouseBlocks,
   houseRule,
-  scanSource
-} from "./chunk-GMVXADJ6.js";
+  pageCopy,
+  protectedFacts,
+  scanSource,
+  visibleText
+} from "./chunk-LFNSB6W7.js";
 
 // src/character/config.ts
 var DEFAULT_IGNORE = [".claude", ".agents", ".cursor"];
@@ -205,87 +211,6 @@ function toSarif(report, options) {
   };
 }
 
-// src/character/facts.ts
-var MONTH = "(?:Jan(?:uary)?|Feb(?:ruary)?|Mar(?:ch)?|Apr(?:il)?|May|Jun(?:e)?|Jul(?:y)?|Aug(?:ust)?|Sep(?:t(?:ember)?)?|Oct(?:ober)?|Nov(?:ember)?|Dec(?:ember)?)";
-var PATTERNS = [
-  ["url", /\bhttps?:\/\/[^\s<>"'`)\]]+|\bwww\.[^\s<>"'`)\]]+/gi],
-  ["email", /\b[\w.+-]+@[\w-]+(?:\.[\w-]+)+\b/g],
-  ["phone", /(?:\+44\s?\(?0?\)?\s?|\b0)\d(?:[\s-]?\d){8,9}\b/g],
-  ["postcode", /\b[A-Z]{1,2}\d[A-Z\d]?\s?\d[A-Z]{2}\b/g],
-  ["money", /[£$€]\s?\d[\d,]*(?:\.\d{1,2})?(?:\s?(?:k|m|bn)\b)?|\b\d[\d,]*(?:\.\d{1,2})?\s?(?:pounds|GBP)\b/gi],
-  ["date", new RegExp(`\\b\\d{1,2}(?:st|nd|rd|th)?\\s+${MONTH}\\b(?:\\s+\\d{4})?|\\b${MONTH}\\s+\\d{1,2}(?:st|nd|rd|th)?\\b(?:,?\\s+\\d{4})?|\\b${MONTH}\\s+\\d{4}\\b|\\b\\d{1,2}\\/\\d{1,2}\\/\\d{2,4}\\b|\\b(?:19|20)\\d{2}\\b`, "g")],
-  ["time", /\b\d{1,2}(?:[:.]\d{2})?\s?(?:am|pm)\b|\b\d{1,2}:\d{2}\b/gi],
-  ["number", /\b\d[\d,]*(?:\.\d+)?%?|\b\d+(?:\.\d+)?\s?(?:per ?cent)\b/gi]
-];
-var NAME = /[A-Z][a-zA-Z’'&-]*[a-zA-Z](?:\s+(?:of|and|&|the)?\s*[A-Z][a-zA-Z’'&-]*[a-zA-Z])*/g;
-var normalise = (kind, value) => {
-  const v = value.trim();
-  if (kind === "phone") return v.replace(/[^\d+]/g, "").replace(/^\+44\(?0?\)?/, "0").replace(/^\+44/, "0");
-  if (kind === "money" || kind === "number") return v.replace(/[\s,]/g, "").toLowerCase();
-  if (kind === "postcode") return v.replace(/\s/g, "").toUpperCase();
-  if (kind === "url") return v.replace(/[.,;:]+$/, "").toLowerCase();
-  return v.replace(/\s+/g, " ").toLowerCase();
-};
-function visibleText(file) {
-  const prose = /\.(md|markdown|mdx|txt)$/i.test(file.path);
-  return (prose ? extractCopy(file) : extractStrings(file)).map((b) => b.text).join("\n");
-}
-function protectedFacts(text) {
-  const facts = [];
-  let rest = text;
-  const mask = (start, length) => {
-    rest = rest.slice(0, start) + " ".repeat(length) + rest.slice(start + length);
-  };
-  for (const [kind, pattern] of PATTERNS) {
-    for (const m of [...rest.matchAll(pattern)]) {
-      const value = m[0].replace(/[.,;:]+$/, "");
-      facts.push({ kind, value, key: `${kind}:${normalise(kind, value)}` });
-      mask(m.index ?? 0, m[0].length);
-    }
-  }
-  const lines = rest.split("\n");
-  for (const line of lines) {
-    if (/^\s{0,3}#{1,6}\s/.test(line)) continue;
-    for (const m of line.matchAll(NAME)) {
-      const at = m.index ?? 0;
-      const before = line.slice(0, at).trimEnd();
-      const opensSentence = before === "" || /[.!?:"“(>*-]$/.test(before) || /^\s*(?:[-*+]|\d+\.)$/.test(before);
-      const word = m[0];
-      const acronym = /^[A-Z]{2,}$/.test(word);
-      if (opensSentence && !acronym && !/\s/.test(word)) continue;
-      if (word === "I") continue;
-      facts.push({ kind: "name", value: word, key: `name:${normalise("name", word)}` });
-    }
-  }
-  return facts;
-}
-var unique = (facts) => [...new Map(facts.map((f) => [f.key, f])).values()];
-function compareFacts(before, after) {
-  const a = unique(protectedFacts(before));
-  const b = unique(protectedFacts(after));
-  const inA = new Set(a.map((f) => f.key));
-  const inB = new Set(b.map((f) => f.key));
-  return {
-    before: a.length,
-    after: b.length,
-    lost: a.filter((f) => !inB.has(f.key)),
-    added: b.filter((f) => !inA.has(f.key))
-  };
-}
-function formatComparison(result, beforePath, afterPath) {
-  const lines = [`craft copy compare: ${beforePath} -> ${afterPath}`, `  ${result.before} protected facts before, ${result.after} after`];
-  if (result.lost.length) {
-    lines.push("", `  Lost (${result.lost.length}): restore each, or say why it went`);
-    for (const f of result.lost) lines.push(`    ${f.kind.padEnd(9)} ${f.value}`);
-  }
-  if (result.added.length) {
-    lines.push("", `  Added (${result.added.length}): each needs a source, or it is invented`);
-    for (const f of result.added) lines.push(`    ${f.kind.padEnd(9)} ${f.value}`);
-  }
-  if (!result.lost.length && !result.added.length) lines.push("", "  Every fact kept, nothing added.");
-  return lines.join("\n");
-}
-
 // src/character/claims.ts
 var CLAIM_KINDS = /* @__PURE__ */ new Set(["money", "number", "date"]);
 var PROPER = "[A-Z][\\w&.\u2019'-]*(?:\\s+(?:of|and|&|the|for)?\\s*[A-Z][\\w&.\u2019'-]*)*";
@@ -445,18 +370,20 @@ Usage
   craft scan [paths...] [--staged] [--json] [--strict] [--direction <file>] [ci options]
   craft copy [paths...] [--gate] [--json] [--strict] [--direction <file>] [ci options]
   craft copy compare <before> <after> [--json]
+  craft copy compare <url | snapshot.json> --competitor <url | snapshot.json> [--brief "<text>"] [--json]
   craft copy claims <paths...> [--json]
   craft tells list [--json]
   craft tells harvest <null.json | dir>... [--share 0.25] [--json]
   craft snapshot <url> [--out <file>] [--width <px>] [--height <px>]
   craft audit <url | snapshot.json> [--repo <dir>] [--null <null.json>] [--out <file>] [--json] [--strict] [ci options]
   craft audit --pages <sitemap.xml | urls.txt> [--viewport 390,768,1440] [the same]
-  craft direction init [--snapshot <file>] [--client <name>] [--out <file>]
-  craft direction validate [--snapshot <file>] [--direction <file>] [--json]
+  craft direction init [--snapshot <file | url>] [--client <name>] [--brief "<text>"] [--out <file>]
+  craft direction validate [--snapshot <file | url>] [--page home] [--estate <estate.json>] [--direction <file>] [--strict] [--json]
+  craft direction research [--brief "<who, where, what>"] [--visual]
   craft direction propose [--snapshot <file>] [--estate <estate.json | dir>] [--out <file>]
   craft null build --brief "<text>" --out <dir> [--runs 20] [--parallel 4] [--model <name>]
-  craft estate add <url | snapshot.json> --id <id> [--client <name>] [--estate <file>]
-  craft estate compare [<url | snapshot.json | id>] [--null <dir>] [--json] [--strict]
+  craft estate add [<url | snapshot.json>] --id <id> [--client <name>] [--direction <art-direction.json>] [--estate <file>]
+  craft estate compare [<url | snapshot.json | id>] [--null <dir>] [--directions] [--json] [--strict]
   craft report <url | snapshot.json> [--repo <dir>] [--null <dir>] [--estate <file>] [--direction <file>] [--json] [--strict]
   craft retrofit <url | snapshot.json> [the same] [--out RETROFIT.md]
 
@@ -468,6 +395,11 @@ copy      The prose in Markdown, markup and content files.
           compare lists the protected facts (prices, numbers, dates, times,
           phones, emails, links, postcodes, names) a rewrite lost or added.
           Exit 1 if any: restore it, source it, or say why.
+          With --competitor, reads both rendered pages instead and lists the
+          hero and service sentences holding no specific (place, name,
+          number, price, job) the other page does not also say. The brief's
+          terms come from --brief, else art-direction.json, else --null's
+          null.json. A measure, not a gate: always exit 0.
           claims lists every sentence holding a price, figure, date or named
           source, marked sourced or UNSOURCED, for a person to check against
           the primary source. It cannot tell true from false. Always exit 0.
@@ -529,10 +461,12 @@ var VALUE_FLAGS = {
   "--sarif": "sarif",
   "--pages": "pages",
   "--viewport": "viewport",
-  "--component": "component"
+  "--component": "component",
+  "--competitor": "competitor",
+  "--page": "page"
 };
 function parseFlags(args) {
-  const flags = { positional: [], json: false, strict: false, staged: false, gate: false, updateBaseline: false };
+  const flags = { positional: [], json: false, strict: false, staged: false, gate: false, updateBaseline: false, directions: false, visual: false };
   for (let i = 0; i < args.length; i += 1) {
     const a = args[i];
     if (a === "--json") flags.json = true;
@@ -540,6 +474,8 @@ function parseFlags(args) {
     else if (a === "--staged") flags.staged = true;
     else if (a === "--gate") flags.gate = true;
     else if (a === "--update-baseline") flags.updateBaseline = true;
+    else if (a === "--directions") flags.directions = true;
+    else if (a === "--visual") flags.visual = true;
     else if (a in VALUE_FLAGS) {
       const value = args[i + 1];
       i += 1;
@@ -637,28 +573,69 @@ function finish(report, flags, title, io) {
 var SOURCE_FILE = (p) => ["markup", "script", "css"].includes(fileKind(p)) && !/\.d\.ts$|\.min\.js$/.test(p);
 var COPY_FILE = (p) => (["markup", "prose", "script"].includes(fileKind(p)) || /\.jsonl?$/i.test(p)) && !NOT_SITE_COPY.test(p.split("/").pop() ?? p) && !/(?:^|\/)(?:package(?:-lock)?|tsconfig[\w.-]*|art-direction)\.json$/.test(p);
 var NOT_COPY_DIR = (name) => name.startsWith("_");
+async function pageSnapshot(target, cwd) {
+  const local = resolve(cwd, target);
+  if (/\.json$/i.test(target) && existsSync(local)) {
+    const { readSnapshot } = await import("./migrate-VIFAYIBM.js");
+    return readSnapshot(JSON.parse(readFileSync(local, "utf8")), target);
+  }
+  if (!/^https?:\/\//.test(target)) throw new Error(`${target} is neither a URL nor a snapshot file`);
+  const { snapshotUrl } = await import("./audit-MTUC24XU.js");
+  return snapshotUrl(target);
+}
+async function briefFor(flags, cwd) {
+  if (flags.brief) return flags.brief;
+  const direction = resolve(cwd, flags.direction ?? "art-direction.json");
+  if (existsSync(direction)) {
+    const brief = JSON.parse(readFileSync(direction, "utf8")).brief;
+    if (typeof brief === "string" && brief.trim()) return brief;
+  } else if (flags.direction) throw new Error(`no such file: ${flags.direction}`);
+  if (flags.null) {
+    const { loadNull } = await import("./cli-FLG3ZCAF.js");
+    return loadNull(flags.null, cwd).brief;
+  }
+  return void 0;
+}
+async function compareWithCompetitor(flags, io) {
+  try {
+    if (flags.positional.length !== 1 || !flags.competitor) throw new Error('usage: craft copy compare <url | snapshot.json> --competitor <url | snapshot.json> [--brief "<text>"] [--json]');
+    const brief = await briefFor(flags, io.cwd);
+    const [ours, theirs] = await Promise.all([pageSnapshot(flags.positional[0], io.cwd), pageSnapshot(flags.competitor, io.cwd)]);
+    const copy = [ours, theirs].map((snap, i) => {
+      const page = pageCopy(snap);
+      if (!page) throw new Error(`${[flags.positional[0], flags.competitor][i]} has no page text: snapshot it again with this craft`);
+      return page;
+    });
+    const result = compareCompetitor(copy[0], copy[1], brief);
+    io.out(flags.json ? toJson(result) : formatCompetitor(result));
+    return 0;
+  } catch (error) {
+    io.err(`craft: ${error.message}`);
+    return 2;
+  }
+}
 function run(argv, io) {
   const [command, ...rest] = argv;
   if (command === "direction") {
-    return import("./cli-DRKAMFAH.js").then((m) => m.runDirection(rest, io));
+    return import("./cli-7OZCYOQY.js").then((m) => m.runDirection(rest, io));
   }
   if (command === "report" || command === "retrofit") {
-    return import("./cli-J5ECRCD4.js").then((m) => m.runReport(command, rest, io));
+    return import("./cli-FCKHYAVZ.js").then((m) => m.runReport(command, rest, io));
   }
   if (command === "estate") {
-    return import("./cli-BKJMLD3H.js").then((m) => m.runEstate(rest, io));
+    return import("./cli-22TSWAX6.js").then((m) => m.runEstate(rest, io));
   }
   if (command === "null") {
-    return import("./cli-ILH7OO5G.js").then((m) => m.runNull(rest, io));
+    return import("./cli-FLG3ZCAF.js").then((m) => m.runNull(rest, io));
   }
   if (command === "tells" && rest[0] === "harvest") {
-    return import("./cli-ILH7OO5G.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
+    return import("./cli-FLG3ZCAF.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
       io.err(`craft: ${error.message}`);
       return 2;
     });
   }
   if (command === "snapshot" || command === "audit") {
-    return import("./cli-N2IDXH7W.js").then((m) => m.runAudit(command, rest, io));
+    return import("./cli-5ACKICBO.js").then((m) => m.runAudit(command, rest, io));
   }
   if (!command || command === "help" || command === "--help" || command === "-h") {
     io.out(HELP);
@@ -690,6 +667,7 @@ function run(argv, io) {
     if (command === "copy" && rest[0] === "compare") {
       const flags = parseFlags(rest.slice(1));
       if (typeof flags === "string") throw new Error(flags);
+      if (flags.competitor) return compareWithCompetitor(flags, io);
       if (flags.positional.length !== 2) throw new Error("usage: craft copy compare <before> <after> [--json]");
       const [before, after] = flags.positional.map((p) => {
         const abs = resolve(io.cwd, p);

package/dist/chunk-OQXTQQAU.js

@@ -0,0 +1,27 @@
+// src/null/generate.ts
+import { spawn } from "child_process";
+import { mkdtempSync, rmSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+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)}`));
+    });
+  });
+}
+
+export {
+  generate
+};

package/dist/{chunk-ZLDA2SYB.js → chunk-OUQ25LY2.js}

@@ -2,10 +2,12 @@ import {
   decodePng
 } from "./chunk-JYNXGCYZ.js";
 import {
-  SNAPSHOT_VERSION,
   auditSnapshot,
   fingerprint
-} from "./chunk-GMVXADJ6.js";
+} from "./chunk-LFNSB6W7.js";
+import {
+  SNAPSHOT_VERSION
+} from "./chunk-QYBAVU3P.js";
 
 // src/audit/collect.ts
 function collectInPage() {
@@ -218,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);
@@ -230,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,
@@ -302,6 +304,43 @@ function collectInPage() {
     });
     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);
@@ -330,7 +369,8 @@ function collectInPage() {
       role: roleOf(el, kind, geometry, b, cards, iconCards, index === kept.length - 1),
       geometry,
       ...parts,
-      figures: numbers
+      figures: numbers,
+      text: textBlocks(el, 40)
     };
   });
   if (header && sections.length === 0) {
@@ -507,6 +547,7 @@ function collectInPage() {
     })(),
     effects,
     images: images.slice(0, 60),
+    firstScreenText,
     motion: {
       hiddenSections: sections.filter((s) => s.hiddenAtLoad).length,
       sections: sections.length,

package/dist/{chunk-K2BZN4GA.js → chunk-QU6Q2QZZ.js}

@@ -1,15 +1,23 @@
 import {
-  loadNull
-} from "./chunk-ESCVTKPN.js";
+  compareDirections,
+  compareToDeclared,
+  formatDirectionMatches,
+  summariseDirection,
+  validateDirection
+} from "./chunk-YDURAOYR.js";
 import {
-  readSnapshot
-} from "./chunk-CZDOMIVS.js";
+  loadNull
+} from "./chunk-RXXRXV3V.js";
 import {
   parseFlags,
   toJson
-} from "./chunk-3VTPI7BU.js";
+} from "./chunk-MUVFECFC.js";
+import {
+  readSnapshot
+} from "./chunk-WUACK2HX.js";
 import {
   COMPONENT_ROLES,
+  SHARED_PART,
   auditSnapshot,
   closestComponents,
   estateComponentPairs,
@@ -18,7 +26,7 @@ import {
   groundName,
   hueName,
   shapeName
-} from "./chunk-GMVXADJ6.js";
+} from "./chunk-LFNSB6W7.js";
 
 // src/estate/cli.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -37,7 +45,7 @@ function addSite(register, site) {
 }
 function sharedParts(a, b, d = fingerprintDistance(a, b)) {
   const out = [];
-  const close = (k) => d.parts[k] <= 0.2;
+  const close = (k) => d.parts[k] <= SHARED_PART;
   if (close("accent")) out.push(a.accent || b.accent ? `${hueName(a.accent)} accent` : "no accent");
   if (close("type")) {
     if (a.display.family === b.display.family) out.push(`${a.display.family} headline`);
@@ -52,14 +60,14 @@ function sharedParts(a, b, d = fingerprintDistance(a, b)) {
 }
 function compareToEstate(target, register, options = {}) {
   const at = options.siblingAt ?? SIBLING_AT;
-  return register.sites.filter((s) => s.id !== options.exclude).map((s) => {
+  return register.sites.filter((s) => s.id !== options.exclude && s.fingerprint).map((s) => {
     const d = fingerprintDistance(target, s.fingerprint);
     return { id: s.id, distance: d.total, sibling: d.total < at, shared: sharedParts(target, s.fingerprint, d) };
   }).sort((a, b) => a.distance - b.distance);
 }
 function estatePairs(register, siblingAt = SIBLING_AT) {
   const out = [];
-  const s = register.sites;
+  const s = register.sites.filter((site) => site.fingerprint);
   for (let i = 0; i < s.length; i += 1) {
     for (let j = i + 1; j < s.length; j += 1) {
       const d = fingerprintDistance(s[i].fingerprint, s[j].fingerprint);
@@ -81,7 +89,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>] [--component <role>] [--json] [--strict]";
+var USAGE = "usage: craft estate add [<url | snapshot.json>] --id <id> [--client <name>] [--direction <art-direction.json>] | craft estate compare [<url | snapshot.json | id>] [--null <dir>] [--component <role>] [--directions] [--json] [--strict]";
 function loadEstate(path) {
   if (!existsSync(path)) return emptyEstate();
   const data = JSON.parse(readFileSync(path, "utf8"));
@@ -95,7 +103,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-5TYDYRXV.js");
+  const { snapshotUrl } = await import("./audit-MTUC24XU.js");
   return snapshotUrl(target);
 }
 var line = (distance, sibling, shared) => `${distance.toFixed(2)}${sibling ? "  SIBLING" : ""}${shared.length ? `  shares ${shared.join(", ")}` : ""}`;
@@ -115,7 +123,7 @@ 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;
+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(", ")}` : ""}`);
@@ -134,6 +142,19 @@ async function runEstate(args, io) {
     const file = resolve(io.cwd, flags.estate ?? "estate.json");
     const register = loadEstate(file);
     const at = flags.null ? siblingLine(flags.null.split(",").map((p) => loadNull(p.trim(), io.cwd).runs.map((r) => r.fingerprint))) : SIBLING_AT;
+    const directionFile = flags.direction ? JSON.parse(readFileSync(resolve(io.cwd, flags.direction), "utf8")) : void 0;
+    if (directionFile && !validateDirection(directionFile).valid) throw new Error("the direction has errors: run craft direction validate before registering it");
+    const declared = () => summariseDirection(directionFile);
+    if (sub === "add" && !target && flags.id && flags.direction) {
+      const existing = register.sites.find((s) => s.id === flags.id);
+      const direction = declared();
+      const next = addSite(register, { ...existing ?? { id: flags.id, client: flags.client ?? directionFile.client, url: "", tells: [], addedAt: (/* @__PURE__ */ new Date()).toISOString() }, direction });
+      writeFileSync(file, `${JSON.stringify(next, null, 2)}
+`);
+      io.out(`craft estate: ${flags.id} direction recorded.`);
+      io.out(formatDirectionMatches(flags.id, compareToDeclared(direction, next.sites, flags.id)));
+      return 0;
+    }
     if (sub === "add") {
       if (!target || !flags.id) throw new Error(USAGE);
       const snap = await snapshotOf(target, io.cwd);
@@ -144,7 +165,8 @@ async function runEstate(args, io) {
         url: snap.url,
         fingerprint: fp,
         tells: [...new Set(auditSnapshot(snap).findings.map((f) => f.tell))].sort(),
-        addedAt: snap.capturedAt
+        addedAt: snap.capturedAt,
+        ...flags.direction ? { direction: declared() } : register.sites.find((s) => s.id === flags.id)?.direction ? { direction: register.sites.find((s) => s.id === flags.id).direction } : {}
       });
       writeFileSync(file, `${JSON.stringify(next, null, 2)}
 `);
@@ -152,6 +174,17 @@ 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.directions) {
+      const withDirection = register.sites.filter((s) => s.direction);
+      const pairs = withDirection.flatMap((a, i) => withDirection.slice(i + 1).map((b) => ({ a: a.id, b: b.id, ...compareDirections(a.direction, b.direction) })));
+      pairs.sort((x, y) => y.shared.length - x.shared.length);
+      if (flags.json) io.out(toJson({ sites: withDirection.length, pairs }));
+      else {
+        io.out(`craft estate: ${withDirection.length} of ${register.sites.length} sites have a declared direction, ${pairs.filter((p) => p.flagged).length} pair(s) worth a look (ranked, not judged)`);
+        for (const p of pairs) io.out(`  ${`${p.a} + ${p.b}`.padEnd(34)} ${p.flagged ? "LOOK  " : "      "}${p.shared.length ? `shares ${p.shared.join(", ")}` : "nothing shared"}`);
+      }
+      return 0;
+    }
     if (sub === "compare" && flags.component) {
       const role = componentRole(flags.component);
       if (!target) {
@@ -161,9 +194,10 @@ async function runEstate(args, io) {
         return 0;
       }
       const known = register.sites.find((s) => s.id === target);
+      if (known && !known.fingerprint) throw new Error(`${target} has a declared direction only; add a snapshot to compare rendered components`);
       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 pairs = register.sites.filter((s) => s.id !== known?.id && s.fingerprint).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);
@@ -177,6 +211,7 @@ async function runEstate(args, io) {
         return flags.strict && pairs.some((p) => p.sibling) ? 1 : 0;
       }
       const known = register.sites.find((s) => s.id === target);
+      if (known && !known.fingerprint) throw new Error(`${target} has a declared direction only; add a snapshot to compare rendered sites`);
       const fp = known ? known.fingerprint : fingerprint(await snapshotOf(target, io.cwd));
       const matches = compareToEstate(fp, register, { exclude: known?.id, siblingAt: at });
       io.out(flags.json ? toJson({ siblingAt: at, matches }) : formatMatches(known?.id ?? target, matches, at));

package/dist/chunk-QYBAVU3P.js

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

package/dist/{chunk-ESCVTKPN.js → chunk-RXXRXV3V.js}

@@ -1,10 +1,13 @@
 import {
-  readSnapshot
-} from "./chunk-CZDOMIVS.js";
+  generate
+} from "./chunk-OQXTQQAU.js";
 import {
   parseFlags,
   toJson
-} from "./chunk-3VTPI7BU.js";
+} from "./chunk-MUVFECFC.js";
+import {
+  readSnapshot
+} from "./chunk-WUACK2HX.js";
 import {
   CATALOGUE_VERSION,
   NULL_VERSION,
@@ -17,34 +20,14 @@ import {
   hueSwatch,
   nullPrompt,
   scanSource
-} from "./chunk-GMVXADJ6.js";
+} from "./chunk-LFNSB6W7.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 { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "fs";
 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 () => {
@@ -115,7 +98,7 @@ async function build(flags, io) {
   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-5TYDYRXV.js");
+    const { snapshotUrls } = await import("./audit-MTUC24XU.js");
     const results = await snapshotUrls(toShoot.map((id) => pathToFileURL(join(pages, `${id}.html`)).href));
     results.forEach((r, i) => {
       const id = toShoot[i];

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

@@ -1,6 +1,6 @@
 import {
   SNAPSHOT_VERSION
-} from "./chunk-GMVXADJ6.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
 };