@domandigital/craft 0.12.0 → 0.14.0

package/dist/{chunk-J3QUROJ5.js → chunk-3OTKMKJQ.js}

@@ -4,13 +4,19 @@ import {
   HOUSE_LOCKED,
   applyHouseGate,
   checkCopy,
+  compareCompetitor,
+  compareFacts,
   extractCopy,
-  extractStrings,
   fileKind,
+  formatComparison,
+  formatCompetitor,
   holdHouseBlocks,
   houseRule,
-  scanSource
-} from "./chunk-AL6MRG6V.js";
+  pageCopy,
+  protectedFacts,
+  scanSource,
+  visibleText
+} from "./chunk-GQVEYTBY.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,6 +370,7 @@ 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]
@@ -468,6 +394,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.
@@ -528,7 +459,9 @@ var VALUE_FLAGS = {
   "--baseline": "baseline",
   "--sarif": "sarif",
   "--pages": "pages",
-  "--viewport": "viewport"
+  "--viewport": "viewport",
+  "--component": "component",
+  "--competitor": "competitor"
 };
 function parseFlags(args) {
   const flags = { positional: [], json: false, strict: false, staged: false, gate: false, updateBaseline: false };
@@ -636,28 +569,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-6WHR7ZTV.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-Z2IQG3LC.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-ZPJIWVEP.js").then((m) => m.runDirection(rest, io));
+    return import("./cli-O3CDSONO.js").then((m) => m.runDirection(rest, io));
   }
   if (command === "report" || command === "retrofit") {
-    return import("./cli-ZB2VJ7CY.js").then((m) => m.runReport(command, rest, io));
+    return import("./cli-WG3UJNUF.js").then((m) => m.runReport(command, rest, io));
   }
   if (command === "estate") {
-    return import("./cli-2DY3V3SF.js").then((m) => m.runEstate(rest, io));
+    return import("./cli-3CGUKXY4.js").then((m) => m.runEstate(rest, io));
   }
   if (command === "null") {
-    return import("./cli-C3JLFXMG.js").then((m) => m.runNull(rest, io));
+    return import("./cli-Z2IQG3LC.js").then((m) => m.runNull(rest, io));
   }
   if (command === "tells" && rest[0] === "harvest") {
-    return import("./cli-C3JLFXMG.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
+    return import("./cli-Z2IQG3LC.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
       io.err(`craft: ${error.message}`);
       return 2;
     });
   }
   if (command === "snapshot" || command === "audit") {
-    return import("./cli-QM2AQQMF.js").then((m) => m.runAudit(command, rest, io));
+    return import("./cli-WSHPSWVU.js").then((m) => m.runAudit(command, rest, io));
   }
   if (!command || command === "help" || command === "--help" || command === "-h") {
     io.out(HELP);
@@ -689,6 +663,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-PU5G5DUC.js → chunk-7T5WR74C.js}

@@ -1,15 +1,11 @@
 import {
   snapshotUrl,
   snapshotUrls
-} from "./chunk-ULPI335S.js";
+} from "./chunk-Q7ILL2HV.js";
 import {
   describeTypicality,
-  loadNull,
-  typicality
-} from "./chunk-LHGY43LL.js";
-import {
-  readSnapshot
-} from "./chunk-ZKVJ7K6X.js";
+  loadNull
+} from "./chunk-XVBR2UPH.js";
 import {
   SOURCE_FILE,
   finish,
@@ -19,14 +15,17 @@ import {
   prepareReport,
   readPaths,
   toJson
-} from "./chunk-J3QUROJ5.js";
+} from "./chunk-3OTKMKJQ.js";
 import {
-  fingerprint
-} from "./chunk-PZ4MF2VV.js";
+  readSnapshot
+} from "./chunk-WUACK2HX.js";
 import {
   auditSnapshot,
-  scanSource
-} from "./chunk-AL6MRG6V.js";
+  componentTypicalities,
+  fingerprint,
+  scanSource,
+  typicality
+} from "./chunk-GQVEYTBY.js";
 
 // src/audit/cli.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -51,6 +50,12 @@ function parseViewports(value) {
 }
 
 // src/audit/cli.ts
+function describeComponents(components, pageMeasured, nullMeasured) {
+  if (!pageMeasured) return "  components  not measured: the page's snapshot predates version 2";
+  if (!nullMeasured) return "  components  not measured: the null model predates snapshot version 2; rebuild it to compare components";
+  if (components.length === 0) return "  components  none the null model has enough pages of to compare";
+  return components.map((c, i) => `${i === 0 ? "  components" : "            "}  ${c.role.padEnd(13)} ${c.score.toFixed(2)}: ${c.typical ? "typical" : "not typical"} (${c.runs} null pages have one)`).join("\n");
+}
 var fmt = (o) => o ? `oklch(${o.l.toFixed(3)} ${o.c.toFixed(3)} ${o.h.toFixed(1)})` : "none";
 function describeFingerprint(fp) {
   return [
@@ -167,11 +172,17 @@ ${failed.map((f) => `  ${f.url}: ${f.error}`).join("\n")}`);
     const pooled = nulls.flatMap((m, i) => m.runs.map((r) => nulls.length > 1 ? { ...r, id: `${i + 1}/${r.id}` } : r));
     const pages = audited.map((a) => {
       const fp = fingerprint(a.snapshot);
-      return { url: a.snapshot.url, viewport: a.viewport, fingerprint: fp, typicality: nulls.length ? typicality(fp, pooled) : null };
+      return {
+        url: a.snapshot.url,
+        viewport: a.viewport,
+        fingerprint: fp,
+        typicality: nulls.length ? typicality(fp, pooled) : null,
+        components: nulls.length ? componentTypicalities(fp, pooled) : []
+      };
     });
     const unmeasured = failed.length > 0 && flags.strict ? 1 : 0;
     if (flags.json) {
-      const extra = single ? { fingerprint: pages[0].fingerprint, typicality: pages[0].typicality, snapshot: flags.out ?? null } : {};
+      const extra = single ? { fingerprint: pages[0].fingerprint, typicality: pages[0].typicality, components: pages[0].components, snapshot: flags.out ?? null } : {};
       io.out(toJson({ report: prepared, ...extra, pages, failed }));
       return Math.max(prepared.summary.blocking > 0 || flags.strict && prepared.summary.findings > 0 ? 1 : 0, unmeasured);
     }
@@ -184,6 +195,7 @@ ${failed.map((f) => `  ${f.url}: ${f.error}`).join("\n")}`);
       if (page.typicality) {
         io.out("");
         io.out(describeTypicality(page.typicality, pooled.length, nulls.length));
+        io.out(describeComponents(page.components, page.fingerprint.sections !== void 0, pooled.some((r) => r.fingerprint.sections !== void 0)));
       }
     }
     if (failed.length) {
@@ -199,6 +211,7 @@ ${failed.map((f) => `  ${f.url}: ${f.error}`).join("\n")}`);
 }
 
 export {
+  describeComponents,
   describeFingerprint,
   merge,
   resolvePages,