@domandigital/craft 0.9.0 → 0.10.0

package/dist/{chunk-YLQE35PN.js → chunk-JKIDWHG3.js}

@@ -8,7 +8,7 @@ import {
   fileKind,
   houseRule,
   scanSource
-} from "./chunk-ZT3WLN7R.js";
+} from "./chunk-3NGWXZZE.js";
 
 // src/character/cli.ts
 import { execFileSync } from "child_process";
@@ -96,6 +96,120 @@ function formatComparison(result, beforePath, afterPath) {
   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'-]*)*";
+var NOT_A_SOURCE = /^(?:We|I|It|This|That|These|Those|They|He|She|You|Our|Your|The|A|An|Each|Every|Most|Many|Some|One|Research|Studies|Experts|Data|Analysis|If|When|So|But|And|Or|In|On|At|From|For|By|As|Since|After|Before|Across|Over|Under|Its|Their|External|Source|UK|US|EU|Sometimes|Public|Recent|Industry|Independent|What|How|Why|Who|Where|Businesses|Customers|Clients|Patients|Consumers|People|Users|Online)$/;
+var NOUN = "study|survey|report|research|analysis|benchmark|benchmarks|guidelines|docs|documentation|help centre|help center|pricing page|figures|statistics|case study";
+var OWNED_NOUN = "guide|audit|support|pricing|data|site|website|blog";
+var VERB = "found|finds|reports?|reported|says|said|states?|stated|estimates?|estimated|recommends?|publishes|published|advertises|advertised|shows|showed|claims";
+var ATTRIBUTION = [
+  new RegExp(`\\b[Aa]ccording to\\s+(?:the\\s+)?(${PROPER})`, "g"),
+  new RegExp(`\\b(?:${NOUN})\\s+(?:by|from|commissioned by)\\s+(?:the\\s+)?(${PROPER})`, "g"),
+  // "Akamai’s 2017 retail study", "the 2020 Deloitte study", "Bark’s UK guide", "Wix’s own developer guidelines".
+  new RegExp(`\\b(${PROPER})(?:(?:\u2019s|'s)\\s+(?:own\\s+)?(?:\\d{4}\\s+)?(?:[A-Za-z]+\\s+)?(?:${NOUN}|${OWNED_NOUN})|\\s+(?:\\d{4}\\s+)?(?:[a-z]+\\s+)?(?:${NOUN}))\\b`, "g"),
+  // "Google also reported", "Shopify UK currently advertises".
+  new RegExp(`\\b(${PROPER})\\s+(?:also\\s+|now\\s+|currently\\s+|still\\s+)?(?:${VERB})\\b`, "g"),
+  /\((?:[Ss]ources?:\s*|via\s+(?=[A-Z]))([^)]+)\)/g,
+  /^\s*(?:source|sources)\s*:\s*(.+)$/gim
+];
+var LINK = /\[([^\]]+)\]\((https?:\/\/[^)\s]+)\)|\bhttps?:\/\/[^\s<>"')\]]+/g;
+function cleanName(raw) {
+  const words = raw.trim().replace(/[.,;:]+$/, "").split(/\s+/);
+  while (words.length && NOT_A_SOURCE.test(words[0])) words.shift();
+  return words.join(" ").replace(/(?:’s|'s)(?=\s|$).*$/, "").trim();
+}
+var IMPERATIVE = /^(?:Add|Use|Check|Make|Get|Set|Include|Create|Update|List|Keep|Ask|Write|Track|Test|Claim|Build|Link|Submit|Verify|Review|Fix|Remove|Upload|Respond|Reply|Choose|Pick|Start|Run|Open|Install|Connect|Enable|Turn|Put|Give|Send|Book|Call|Read|See|Try|Compare|Aim|Target|Avoid|Post|Share|Mark|Tag)$/;
+var atStart = (sentence, index) => /^[\s*_"“”’(>#|-]*(?:\d{1,3}[.)]\s*)?[\s*_]*(?:[\w ]+:\**\s*)?$/.test(sentence.slice(0, index)) || /\|\s*\**$/.test(sentence.slice(0, index));
+function namedSources(sentence) {
+  const found = /* @__PURE__ */ new Set();
+  ATTRIBUTION.forEach((pattern, i) => {
+    for (const m of sentence.matchAll(pattern)) {
+      const raw = m[1].trim();
+      const word = !/\s/.test(raw) && !/[’']s$/.test(m[0].split(/\s+/)[0]);
+      if (i === 2 && word && atStart(sentence, m.index ?? 0)) continue;
+      if (IMPERATIVE.test(raw.split(/\s+/)[0]) && atStart(sentence, m.index ?? 0)) continue;
+      const name = cleanName(raw);
+      if (!name || name.length < 2 || !/\s/.test(name) && /[a-z]ing$/.test(name)) continue;
+      found.add(name);
+    }
+  });
+  for (const m of sentence.matchAll(LINK)) found.add(m[2] ?? m[0]);
+  return [...found];
+}
+var FOOTNOTE_REF = /\[\^([\w-]+)\](?!:)/g;
+var FOOTNOTE_DEF = /^[ \t]*\[\^([\w-]+)\]:[ \t]*(.+)$/gm;
+var ASSUMPTION = /^(?:\*\*)?(?:assume|suppose|imagine|say|let's say|for example, say|picture)\b/i;
+var LEAD = /^\s*(?:#{1,6}\s+|>\s*|[-*+]\s+|\d+[.)]\s+)*/;
+function sentences(text) {
+  const out = [];
+  let start = 0;
+  let paragraph = 0;
+  const push = (end) => {
+    const raw = text.slice(start, end);
+    const lead = raw.length - raw.trimStart().length;
+    if (raw.trim()) out.push({ text: raw.trim(), offset: start + lead, paragraph });
+  };
+  for (const m of text.matchAll(/(?<!(?:^|\n)[ \t]*\d{1,3})[.!?](?:\[\^[\w-]+\])*(?=["”’)]?[ \t]+["“(*]*[A-Z0-9£$€])|\n+/g)) {
+    const end = (m.index ?? 0) + m[0].length;
+    push(end);
+    start = end;
+    if (/\n\s*\n/.test(m[0]) || /^\s*(?:#|\|)/.test(text.slice(end))) paragraph += 1;
+  }
+  push(text.length);
+  return out;
+}
+var MAX = 180;
+var trim = (s) => s.length > MAX ? `${s.slice(0, MAX - 1).trimEnd()}\u2026` : s;
+function findClaims(files) {
+  const claims = [];
+  for (const file of files) {
+    for (const block of extractCopy(file)) {
+      const notes = new Map([...block.text.matchAll(FOOTNOTE_DEF)].map((m) => [m[1], m[2].trim()]));
+      let carried;
+      for (const s of sentences(block.text)) {
+        if (/^\s*#{1,6}\s/.test(s.text) || /^\s*\[\^[\w-]+\]:/.test(s.text)) continue;
+        const refs = [...s.text.matchAll(FOOTNOTE_REF)].map((m) => notes.get(m[1]) ?? `footnote ${m[1]}`);
+        const text = s.text.replace(FOOTNOTE_REF, "");
+        const body = text.replace(LEAD, "");
+        const own = [...namedSources(text), ...refs];
+        if (own.length) carried = { paragraph: s.paragraph, sources: own };
+        if (ASSUMPTION.test(body)) continue;
+        const facts = protectedFacts(body).filter((f) => CLAIM_KINDS.has(f.kind));
+        if (facts.length === 0 && own.length === 0) continue;
+        const nearby = own.length === 0 && carried?.paragraph === s.paragraph ? carried.sources : void 0;
+        const at = block.offset + s.offset;
+        claims.push({
+          path: file.path,
+          line: file.text.slice(0, at).split("\n").length,
+          sentence: trim(text.replace(/\s+/g, " ")),
+          facts,
+          sources: own,
+          ...nearby ? { nearby } : {}
+        });
+      }
+    }
+  }
+  return { files: files.length, claims, unsourced: claims.filter((c) => c.sources.length === 0).length };
+}
+function formatClaims(report, label = "craft copy claims") {
+  const { claims, unsourced } = report;
+  if (claims.length === 0) return `${label}: no prices, figures, dates or named sources in ${report.files} file${report.files === 1 ? "" : "s"}.`;
+  const lines = [
+    `${label}: ${claims.length} claim${claims.length === 1 ? "" : "s"} to check, ${unsourced} with no source named.`,
+    "  Check each against its primary source before it ships. Sourced means a source is named, not that it agrees."
+  ];
+  for (const c of claims) {
+    const what = [
+      ...c.facts.map((f) => f.value),
+      ...c.sources.map((s) => `source: ${s}`),
+      ...c.nearby ? [`${c.nearby.join(", ")} named earlier in the paragraph: does it cover this?`] : []
+    ].join(" \xB7 ");
+    lines.push("", `  ${c.path}:${c.line}  ${c.sources.length ? "sourced  " : "UNSOURCED"}  ${what}`, `    ${c.sentence}`);
+  }
+  return lines.join("\n");
+}
+
 // src/character/format.ts
 function formatReport(report, title) {
   const lines = [];
@@ -141,6 +255,7 @@ Usage
   craft scan [paths...] [--staged] [--json] [--strict] [--direction <file>]
   craft copy <paths...> [--gate] [--json] [--strict] [--direction <file>]
   craft copy compare <before> <after> [--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>]
@@ -162,6 +277,9 @@ 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.
+          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.
 tells     The catalogue this build judges against. harvest reads null models
           for choices the model keeps making that the catalogue does not know.
 snapshot  Render a page in a browser and save what it looks like, as JSON.
@@ -274,25 +392,25 @@ var NOT_COPY_DIR = (name) => name.startsWith("_");
 function run(argv, io) {
   const [command, ...rest] = argv;
   if (command === "direction") {
-    return import("./cli-3XPEGBUR.js").then((m) => m.runDirection(rest, io));
+    return import("./cli-2WBGTBKD.js").then((m) => m.runDirection(rest, io));
   }
   if (command === "report" || command === "retrofit") {
-    return import("./cli-V55MTIOP.js").then((m) => m.runReport(command, rest, io));
+    return import("./cli-ADQQURNR.js").then((m) => m.runReport(command, rest, io));
   }
   if (command === "estate") {
-    return import("./cli-J7C6TI2B.js").then((m) => m.runEstate(rest, io));
+    return import("./cli-VQUNNIZM.js").then((m) => m.runEstate(rest, io));
   }
   if (command === "null") {
-    return import("./cli-4VAOH7ST.js").then((m) => m.runNull(rest, io));
+    return import("./cli-PRWTNFVP.js").then((m) => m.runNull(rest, io));
   }
   if (command === "tells" && rest[0] === "harvest") {
-    return import("./cli-4VAOH7ST.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
+    return import("./cli-PRWTNFVP.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
       io.err(`craft: ${error.message}`);
       return 2;
     });
   }
   if (command === "snapshot" || command === "audit") {
-    return import("./cli-WDSVVHKG.js").then((m) => m.runAudit(command, rest, io));
+    return import("./cli-EK3GSAOW.js").then((m) => m.runAudit(command, rest, io));
   }
   if (!command || command === "help" || command === "--help" || command === "-h") {
     io.out(HELP);
@@ -334,6 +452,14 @@ function run(argv, io) {
       io.out(flags.json ? JSON.stringify(result, null, 2) : formatComparison(result, flags.positional[0], flags.positional[1]));
       return result.lost.length || result.added.length ? 1 : 0;
     }
+    if (command === "copy" && rest[0] === "claims") {
+      const flags = parseFlags(rest.slice(1));
+      if (typeof flags === "string") throw new Error(flags);
+      if (flags.positional.length === 0) throw new Error("usage: craft copy claims <paths...> [--json]");
+      const report = findClaims(readPaths(flags.positional, io.cwd, COPY_FILE, NOT_COPY_DIR));
+      io.out(flags.json ? JSON.stringify(report, null, 2) : formatClaims(report));
+      return 0;
+    }
     if (command === "scan" || command === "copy") {
       const flags = parseFlags(rest);
       if (typeof flags === "string") throw new Error(flags);

package/dist/{chunk-JRMU6GYX.js → chunk-JWHC67ZS.js}

@@ -6,7 +6,7 @@ import {
   isCream,
   normaliseFamily,
   parseColour
-} from "./chunk-ZT3WLN7R.js";
+} from "./chunk-3NGWXZZE.js";
 
 // src/direction/types.ts
 var DIRECTION_VERSION = 1;

package/dist/{chunk-EHNEGKFR.js → chunk-QMYERCBB.js}

@@ -3,7 +3,7 @@ import {
   fontClass,
   normaliseFamily,
   parseColour
-} from "./chunk-ZT3WLN7R.js";
+} from "./chunk-3NGWXZZE.js";
 
 // src/fingerprint/index.ts
 var FINGERPRINT_VERSION = 1;

package/dist/{chunk-BYY32NIN.js → chunk-TSKRBIOC.js}

@@ -1,10 +1,10 @@
 import {
   fingerprint
-} from "./chunk-EHNEGKFR.js";
+} from "./chunk-QMYERCBB.js";
 import {
   SNAPSHOT_VERSION,
   auditSnapshot
-} from "./chunk-ZT3WLN7R.js";
+} from "./chunk-3NGWXZZE.js";
 
 // src/audit/collect.ts
 function collectInPage() {

package/dist/{chunk-DAENYJUO.js → chunk-U2JTFQKO.js}

@@ -1,26 +1,26 @@
 import {
   snapshotUrl
-} from "./chunk-BYY32NIN.js";
+} from "./chunk-TSKRBIOC.js";
 import {
   describeTypicality,
   loadNull,
   typicality
-} from "./chunk-VKQDOUHO.js";
+} from "./chunk-APO4BT2F.js";
 import {
   SOURCE_FILE,
   finish,
   loadExceptions,
   parseFlags,
   readPaths
-} from "./chunk-YLQE35PN.js";
+} from "./chunk-JKIDWHG3.js";
 import {
   fingerprint
-} from "./chunk-EHNEGKFR.js";
+} from "./chunk-QMYERCBB.js";
 import {
   SNAPSHOT_VERSION,
   auditSnapshot,
   scanSource
-} from "./chunk-ZT3WLN7R.js";
+} from "./chunk-3NGWXZZE.js";
 
 // src/audit/cli.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";

package/dist/{cli-3XPEGBUR.js → cli-2WBGTBKD.js}

@@ -1,13 +1,13 @@
 import {
   DIRECTION_VERSION,
   validateDirection
-} from "./chunk-JRMU6GYX.js";
+} from "./chunk-JWHC67ZS.js";
 import {
   parseFlags
-} from "./chunk-YLQE35PN.js";
+} from "./chunk-JKIDWHG3.js";
 import {
   fingerprint
-} from "./chunk-EHNEGKFR.js";
+} from "./chunk-QMYERCBB.js";
 import {
   deltaEOk,
   formatHex,
@@ -16,7 +16,7 @@ import {
   isCream,
   oklchToRgb,
   parseColour
-} from "./chunk-ZT3WLN7R.js";
+} from "./chunk-3NGWXZZE.js";
 
 // src/direction/cli.ts
 import { existsSync, readdirSync, readFileSync, writeFileSync } from "fs";

package/dist/{cli-V55MTIOP.js → cli-ADQQURNR.js}

@@ -1,19 +1,19 @@
 import {
   validateDirection
-} from "./chunk-JRMU6GYX.js";
+} from "./chunk-JWHC67ZS.js";
 import {
   merge
-} from "./chunk-DAENYJUO.js";
-import "./chunk-BYY32NIN.js";
+} from "./chunk-U2JTFQKO.js";
+import "./chunk-TSKRBIOC.js";
 import {
   SIBLING_AT,
   compareToEstate,
   loadEstate
-} from "./chunk-5LI2VFN5.js";
+} from "./chunk-2NQFIDLE.js";
 import {
   loadNull,
   typicality
-} from "./chunk-VKQDOUHO.js";
+} from "./chunk-APO4BT2F.js";
 import {
   COPY_FILE,
   NOT_COPY_DIR,
@@ -21,17 +21,17 @@ import {
   loadExceptions,
   parseFlags,
   readPaths
-} from "./chunk-YLQE35PN.js";
+} from "./chunk-JKIDWHG3.js";
 import {
   fingerprint
-} from "./chunk-EHNEGKFR.js";
+} from "./chunk-QMYERCBB.js";
 import {
   CATALOGUE,
   SNAPSHOT_VERSION,
   auditSnapshot,
   checkCopy,
   scanSource
-} from "./chunk-ZT3WLN7R.js";
+} from "./chunk-3NGWXZZE.js";
 
 // src/report/cli.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -259,7 +259,7 @@ async function runReport(command, args, io) {
       snap = JSON.parse(readFileSync(local, "utf8"));
       if (snap.version !== SNAPSHOT_VERSION) throw new Error(`${target2} is not a snapshot`);
     } else {
-      const { snapshotUrl } = await import("./audit-5P65UMFL.js");
+      const { snapshotUrl } = await import("./audit-EGDNWSQB.js");
       snap = await snapshotUrl(target2);
     }
     const fp = fingerprint(snap);

package/dist/cli-EK3GSAOW.js

@@ -0,0 +1,15 @@
+import {
+  describeFingerprint,
+  merge,
+  runAudit
+} from "./chunk-U2JTFQKO.js";
+import "./chunk-TSKRBIOC.js";
+import "./chunk-APO4BT2F.js";
+import "./chunk-JKIDWHG3.js";
+import "./chunk-QMYERCBB.js";
+import "./chunk-3NGWXZZE.js";
+export {
+  describeFingerprint,
+  merge,
+  runAudit
+};

package/dist/{cli-4VAOH7ST.js → cli-PRWTNFVP.js}

@@ -6,10 +6,10 @@ import {
   nullPath,
   runHarvest,
   runNull
-} from "./chunk-VKQDOUHO.js";
-import "./chunk-YLQE35PN.js";
-import "./chunk-EHNEGKFR.js";
-import "./chunk-ZT3WLN7R.js";
+} from "./chunk-APO4BT2F.js";
+import "./chunk-JKIDWHG3.js";
+import "./chunk-QMYERCBB.js";
+import "./chunk-3NGWXZZE.js";
 export {
   describeTypicality,
   formatHarvest,

package/dist/cli-VQUNNIZM.js

@@ -0,0 +1,16 @@
+import {
+  formatMatches,
+  formatPairs,
+  loadEstate,
+  runEstate
+} from "./chunk-2NQFIDLE.js";
+import "./chunk-APO4BT2F.js";
+import "./chunk-JKIDWHG3.js";
+import "./chunk-QMYERCBB.js";
+import "./chunk-3NGWXZZE.js";
+export {
+  formatMatches,
+  formatPairs,
+  loadEstate,
+  runEstate
+};

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   run
-} from "./chunk-YLQE35PN.js";
-import "./chunk-ZT3WLN7R.js";
+} from "./chunk-JKIDWHG3.js";
+import "./chunk-3NGWXZZE.js";
 
 // src/cli.ts
 process.stdout.on("error", (error) => {