@domandigital/craft 0.9.0 → 0.10.0

package/dist/index.cjs

@@ -91,6 +91,7 @@ __export(index_exports, {
   estatePairs: () => estatePairs,
   exitDuration: () => exitDuration,
   extractHtml: () => extractHtml,
+  findClaims: () => findClaims,
   findColours: () => findColours,
   fingerprint: () => fingerprint,
   fingerprintDistance: () => fingerprintDistance,
@@ -98,6 +99,7 @@ __export(index_exports, {
   fluidSpace: () => fluidSpace,
   fluidType: () => fluidType,
   fontClass: () => fontClass,
+  formatClaims: () => formatClaims,
   formatComparison: () => formatComparison,
   formatHex: () => formatHex,
   formatReport: () => formatReport,
@@ -114,6 +116,7 @@ __export(index_exports, {
   isCream: () => isCream,
   makeSnapshot: () => makeSnapshot,
   motionTokens: () => motionTokens,
+  namedSources: () => namedSources,
   nearest: () => nearest,
   normaliseFamily: () => normaliseFamily,
   nullPrompt: () => nullPrompt,
@@ -1932,10 +1935,14 @@ var COPY_TELLS = [
     surface: "copy",
     why: "Three fragments in a row ('Fast. Friendly. Local.' or 'No fuss. No jargon. Just results.') is the second wave's favourite rhythm.",
     fix: "Write one sentence that says which of the three is true, and how you know.",
-    detect: phrases([/(?:\b[A-Z][\w'’-]*(?:\s+[\w'’-]+){0,2}[.!]\s+){2}[A-Z][\w'’-]*(?:\s+[\w'’-]+){0,2}[.!](?=\s|$)/], quoted),
+    // The fragments share one paragraph: "You don't. Again.", a blank line, then "It's frustrating." is two beats, not three.
+    detect: phrases([/(?:\b[A-Z][\w'’-]*(?:[ \t]+[\w'’-]+){0,2}[.!](?:[ \t]+|[ \t]*\n(?![ \t]*\n)[ \t]*)){2}[A-Z][\w'’-]*(?:[ \t]+[\w'’-]+){0,2}[.!](?=\s|$)/], quoted),
     fixtures: {
-      flag: [f("content/home.md", "No fuss. No jargon. Just results.")],
-      pass: [f("content/home.md", "We fix boilers the same day, and we tell you the price before we start.")]
+      flag: [f("content/home.md", "No fuss. No jargon. Just results."), f("content/home.md", "No fuss.\nNo jargon.\nJust results.")],
+      pass: [
+        f("content/home.md", "We fix boilers the same day, and we tell you the price before we start."),
+        f("content/guide.md", "Your competitor appears in the top three. You don't. Again.\n\nIt's frustrating.")
+      ]
     }
   },
   {
@@ -1954,6 +1961,14 @@ var COPY_TELLS = [
   }
 ];
 var ING_TAIL = /,\s+(?:ensuring|highlighting|underscoring|showcasing|reflecting|demonstrating|emphasi[sz]ing|fostering|cementing|solidifying|reinforcing|symboli[sz]ing|signalling|signaling)\b[^.!?\n]{0,80}/i;
+var PROMPT_CONTEXT = [
+  /\b(?:the|this|that)\s+(?:attached|uploaded|provided)\s+(?:(?:Perplexity|ChatGPT|Claude|Gemini|Copilot)\s+)?(?:research|research file|research pack|source file|sources)\b/i,
+  /\b(?:attached|uploaded)\s+(?:Perplexity|ChatGPT|Claude|Gemini|Copilot)\b/i,
+  /\bthe\s+(?:attached|uploaded|provided)\s+brief\s+(?:asks|says|wants|requests|suggests|mentions)\b/i
+];
+function gerundList(block, _match, index) {
+  return /(?:^|[(,;:]\s*)\w+ing\b[^,.;()!?]{0,40}$/.test(block.text.slice(Math.max(0, index - 60), index));
+}
 var VAGUE_ATTRIBUTION = [
   /\b(?:studies|research|experts|scientists|surveys|statistics|the data)\s+(?:show|shows|suggest|suggests|agree|say|says|confirm|confirms|prove|proves|indicate|indicates)\b/i,
   /\b(?:many|most)\s+(?:experts|people|customers|professionals|homeowners)\s+(?:agree|say|believe)\b/i,
@@ -2039,8 +2054,10 @@ function inlineLabelHits(ctx) {
       run = [];
     };
     for (const line of lines) {
-      const m = /^\s*(?:[-*+]|\d+\.)\s+\*\*[^*]{1,40}:?\*\*:?\s+(\S.*)$/.exec(line);
-      if (m && m[1].trim().split(/\s+/).length <= 6) run.push(offset);
+      const m = /^\s*[-*+]\s+\*\*([^*]{1,40}?):?\*\*:?\s+(\S.*)$/.exec(line);
+      const data = m && /[\d£$€%`]|https?:|^\*\*/.test(m[2]);
+      const named = m && /\S[A-Z]|[./]/.test(m[1]);
+      if (m && !data && !named && m[2].trim().split(/\s+/).length <= 6) run.push(offset);
       else flush();
       offset += line.length + 1;
     }
@@ -2078,6 +2095,29 @@ var RESEARCH_TELLS = [
       ]
     }
   },
+  {
+    id: "prompt-context",
+    name: "Prompt context",
+    generation: 1,
+    severity: "warn",
+    surface: "copy",
+    why: "'This article uses the attached Perplexity research file as the primary source', 'the attached research is right to say': the model talking about what it was given. A reader of a web page has no attachment. Found 38 times across five live DD articles in 2026-09, none caught by any other tell.",
+    fix: "Delete the reference to the research or brief. Where it carried a claim, name the real source or cut the claim.",
+    detect: phrases(PROMPT_CONTEXT, quoted),
+    fixtures: {
+      flag: [
+        f("content/guide.md", "This article uses the attached Perplexity research file as the primary source."),
+        f("content/guide.md", "The attached research is right to say these platforms suit early-stage businesses."),
+        f("content/guide.md", "That is exactly how the uploaded research frames the category."),
+        f("content/guide.md", "The attached brief asks for the point that most tradespeople miss.")
+      ],
+      pass: [
+        f("content/guide.md", "We research every quote before we send it."),
+        f("app/email.tsx", `export const Invoice = () => <p>Your invoice is attached.</p>;`),
+        f("content/guide.md", "BrightLocal's research shows that reviews drive 20% of local ranking.")
+      ]
+    }
+  },
   {
     id: "placeholder",
     name: "Unfilled placeholder",
@@ -2130,7 +2170,11 @@ var RESEARCH_TELLS = [
       pass: [
         f("content/home.md", "- Pages load in under a second\n- Card details never touch our server\n- Support by phone until 8pm\n"),
         f("content/home.md", "- **Speed:** Faster pages\n- **Security:** Safer data\n"),
-        f("content/guide.md", "- **GDC**: The statutory regulator for all dental professionals.\n- **GCC**: The statutory regulator for chiropractors in the UK.\n- **CQC**: The independent regulator of health and social care in England.\n")
+        f("content/guide.md", "- **GDC**: The statutory regulator for all dental professionals.\n- **GCC**: The statutory regulator for chiropractors in the UK.\n- **CQC**: The independent regulator of health and social care in England.\n"),
+        f("content/guide.md", "- **Per page**: \xA3100-\xA3200 per page\n- **Hourly**: \xA350-\xA375/hour\n- **Day rate**: \xA3350-\xA3500\n"),
+        f("content/guide.md", "- **Law Society Find a Solicitor:** For solicitors\n- **AccountingWEB / ICAEW directories:** For accountants\n- **NHS.uk:** For NHS services\n"),
+        f("content/guide.md", "1. **Visit PageSpeed Insights** and paste the address\n2. **Enter their URL** and run it\n3. **Note their scores** for later\n"),
+        f("content/guide.md", "- **Structural problems:** **REBUILD.**\n- **Messaging issues:** **REFRESH.**\n- **Neither:** **LEAVE IT.**\n")
       ]
     }
   },
@@ -2142,7 +2186,7 @@ var RESEARCH_TELLS = [
     surface: "copy",
     why: "'..., ensuring peace of mind', '..., highlighting our commitment': a participle tacked on the end that claims significance and names no mechanism. One of the most common shapes in the Wikipedia guide to AI writing.",
     fix: "Cut the tail, or replace it with the mechanism: 'so you can drop the car off before work'.",
-    detect: phrases([ING_TAIL], (m) => quoted(m.replace(/^,\s*/, ""))),
+    detect: phrases([ING_TAIL], (m) => quoted(m.replace(/^,\s*/, "")), void 0, gerundList),
     fixtures: {
       flag: [
         f("content/home.md", "Every engineer is Gas Safe registered, ensuring complete peace of mind."),
@@ -2150,7 +2194,8 @@ var RESEARCH_TELLS = [
       ],
       pass: [
         f("content/home.md", "We open at 7am, so you can drop the car off before work."),
-        f("content/home.md", "Engineers arrive by 9, carrying the parts for most boilers.")
+        f("content/home.md", "Engineers arrive by 9, carrying the parts for most boilers."),
+        f("content/guide.md", "Many items (claiming your GBP, ensuring NAP consistency, writing title tags) are straightforward.")
       ]
     }
   },
@@ -2400,6 +2445,7 @@ function repeatHits(ctx) {
     for (const s of sentences(doc2)) {
       const words2 = normal(s.text);
       if (words2.length < RUN || !/[.!?]["'’”)]*$/.test(s.text)) continue;
+      if (/^\s*\[\^[\w-]+\]:/.test(s.text)) continue;
       const key = words2.join(" ");
       const earlier = whole.get(key);
       if (earlier) {
@@ -2597,7 +2643,15 @@ var DENSITY_TELLS = [
         f2("content/proposal.md", doc("We check every valve before the engineer leaves the house.\n\nMore here.\n\nWe check every valve before the engineer leaves the house.")),
         f2("content/proposal.md", doc("We check every valve before the engineer leaves the house.\n\nBy then we check every valve before the engineer leaves the site."))
       ],
-      pass: [f2("content/proposal.md", doc("We check every valve before the engineer leaves the house.\n\nThe engineer leaves once the customer has signed the sheet."))]
+      pass: [
+        f2("content/proposal.md", doc("We check every valve before the engineer leaves the house.\n\nThe engineer leaves once the customer has signed the sheet.")),
+        f2(
+          "content/guide.md",
+          doc(
+            "The Independent Healthcare Providers Network Private Patient Insight Report 2024 found that private demand rose.[^1]\n\n[^1]: Independent Healthcare Providers Network, Private Patient Insight Report 2024, published online."
+          )
+        )
+      ]
     }
   },
   {
@@ -3634,6 +3688,9 @@ var HOUSE = {
   "closing-summary": { tier: "review", label: "closing summary" },
   "false-range": { tier: "review", label: "false range" },
   "placeholder": { tier: "review", label: "unfilled placeholder" },
+  // Every estate hit so far is real (38 in five DD articles, 2026-09-24), but
+  // a proposal can honestly say "the attached research". Review until measured there.
+  "prompt-context": { tier: "review", label: "prompt context: the model naming its own inputs" },
   "question-reveal": { tier: "review", label: "staged reveal" },
   "inline-label-list": { tier: "review", label: "bold-label bullets" },
   "phrase-density": { tier: "review", label: "density" },
@@ -4316,7 +4373,7 @@ var RENDERED_PATHS = {
 };
 
 // src/character/check.ts
-var CATALOGUE_VERSION = "2026.09.7";
+var CATALOGUE_VERSION = "2026.09.8";
 var CATALOGUE = [...SOURCE_TELLS, ...COPY_TELLS, ...RESEARCH_TELLS, ...DENSITY_TELLS].map(
   (t) => RENDERED_PATHS[t.id] ? { ...t, rendered: RENDERED_PATHS[t.id] } : t
 );
@@ -4581,6 +4638,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 LINK2 = /\[([^\]]+)\]\((https?:\/\/[^)\s]+)\)|\bhttps?:\/\/[^\s<>"')\]]+/g;
+function cleanName(raw) {
+  const words2 = raw.trim().replace(/[.,;:]+$/, "").split(/\s+/);
+  while (words2.length && NOT_A_SOURCE.test(words2[0])) words2.shift();
+  return words2.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(LINK2)) 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 sentences2(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 sentences2(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((f4) => CLAIM_KINDS.has(f4.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(report2, label = "craft copy claims") {
+  const { claims, unsourced } = report2;
+  if (claims.length === 0) return `${label}: no prices, figures, dates or named sources in ${report2.files} file${report2.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((f4) => f4.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/fingerprint/index.ts
 var FINGERPRINT_VERSION = 1;
 var CHROMATIC = 0.03;
@@ -5544,6 +5715,7 @@ function retrofitPlan(report2, direction) {
   estatePairs,
   exitDuration,
   extractHtml,
+  findClaims,
   findColours,
   fingerprint,
   fingerprintDistance,
@@ -5551,6 +5723,7 @@ function retrofitPlan(report2, direction) {
   fluidSpace,
   fluidType,
   fontClass,
+  formatClaims,
   formatComparison,
   formatHex,
   formatReport,
@@ -5567,6 +5740,7 @@ function retrofitPlan(report2, direction) {
   isCream,
   makeSnapshot,
   motionTokens,
+  namedSources,
   nearest,
   normaliseFamily,
   nullPrompt,

package/dist/index.d.cts

@@ -1031,7 +1031,7 @@ interface CheckReport {
  * Bumped whenever an entry is added, removed or its detection changes, so a
  * report can say which list it was judged against.
  */
-declare const CATALOGUE_VERSION = "2026.09.7";
+declare const CATALOGUE_VERSION = "2026.09.8";
 declare const CATALOGUE: readonly Tell[];
 declare function tellById(id: string): Tell | undefined;
 /**
@@ -1147,6 +1147,47 @@ interface FactComparison {
 declare function compareFacts(before: string, after: string): FactComparison;
 declare function formatComparison(result: FactComparison, beforePath: string, afterPath: string): string;
 
+/**
+ * The claims list: every sentence a reader would take as a checkable fact.
+ *
+ * No tell can say whether "Bark charges £2,000 to £7,000" is true. The worst
+ * faults in the DD article that set this off (2026-09-24) were figures like
+ * that: a wrong range, an unsourced day rate, a study quoted past what it
+ * found. Every one passed the copy check, because the prose was fine.
+ *
+ * So this does not judge. It lists each sentence holding a price, a figure, a
+ * date or a named source, marks whether the sentence names where it came
+ * from, and leaves the verdict to a person with the primary source open.
+ * "Sourced" means a source is named, not that it says what the sentence
+ * claims: that is exactly what the person checks.
+ *
+ * Pure over text. `craft copy claims <paths...>` is the command.
+ */
+
+interface Claim {
+    path: string;
+    line: number;
+    /** The sentence, trimmed to a readable length. */
+    sentence: string;
+    /** The prices, figures and dates in it. */
+    facts: Fact[];
+    /** Who the sentence says it comes from: a name, a publication or a link. Empty when nobody is named. */
+    sources: string[];
+    /**
+     * A source named earlier in the same paragraph. A hint for the person, never
+     * a pass: the sentence may be the writer's own arithmetic on top of it.
+     */
+    nearby?: string[];
+}
+interface ClaimsReport {
+    files: number;
+    claims: Claim[];
+    unsourced: number;
+}
+declare function namedSources(sentence: string): string[];
+declare function findClaims(files: SourceFile[]): ClaimsReport;
+declare function formatClaims(report: ClaimsReport, label?: string): string;
+
 /**
  * The rendered detection path for tells that can be seen on a live page.
  *
@@ -1779,4 +1820,4 @@ declare function characterReport(input: CharacterInputs, copyTells?: Set<string>
 
 declare function retrofitPlan(report: CharacterReport, direction?: ArtDirection | null): string;
 
-export { AI_PHRASES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type Area, type ArtDirection, BUZZWORDS, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type ContrastCheck, type ContrastReport, type CopyTell, type CraftTokensInput, type CraftTokensResult, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionProblem, type DirectionReport, type DirectionSource, type DurationName, EASE, EASE_TUPLE, ESTATE_VERSION, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, FINGERPRINT_VERSION, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, type Gamut, type Generation, HOUSE, HOUSE_BUDGET, HOUSE_TYPE, type HarvestCandidate, type HarvestOptions, type Hit, type HouseRule, type HouseTier, LIGHTNESS_CURVE, MIN_DECIDED, MIN_RUNS, type MotionDecision, type MotionKind, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PILL_LIMIT, PLAINER_WORDS, PROPOSED, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, SCALE, SHADCN_LIMIT, SHADCN_PRIMITIVES, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPRING, STOCK_PHRASES, type SectionKind, type SectionRhythmOptions, type SemanticInput, type SemanticResult, type Severity, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Surface, TELL_HEAVY, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type Tell, type TellException, type TypeStep, type Typicality, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, applyHouseGate, auditSnapshot, catalogueTable, characterReport, checkCopy, checkPair, checkRestraint, choicesOf, compareFacts, compareToEstate, craftTokens, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estatePairs, exitDuration, extractHtml, findColours, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatComparison, formatHex, formatReport, groundName, harvest, hexToOklch, houseRule, hueName, hueSwatch, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isCream, makeSnapshot, motionTokens, nearest, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, paletteFromPixels, parseColour, parseHex, propose, protectedFacts, ramp, rampFromAnchors, retrofitPlan, runTell, scanSource, sectionRhythm, semantic, shapeName, sharedParts, shouldAnimate, siblingLine, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, typeFeatureTokens, typicality, validateDirection, visibleText, wcagContrast, wordListsJson };
+export { AI_PHRASES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type Area, type ArtDirection, BUZZWORDS, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type ContrastCheck, type ContrastReport, type CopyTell, type CraftTokensInput, type CraftTokensResult, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionProblem, type DirectionReport, type DirectionSource, type DurationName, EASE, EASE_TUPLE, ESTATE_VERSION, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, FINGERPRINT_VERSION, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, type Gamut, type Generation, HOUSE, HOUSE_BUDGET, HOUSE_TYPE, type HarvestCandidate, type HarvestOptions, type Hit, type HouseRule, type HouseTier, LIGHTNESS_CURVE, MIN_DECIDED, MIN_RUNS, type MotionDecision, type MotionKind, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PILL_LIMIT, PLAINER_WORDS, PROPOSED, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, SCALE, SHADCN_LIMIT, SHADCN_PRIMITIVES, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPRING, STOCK_PHRASES, type SectionKind, type SectionRhythmOptions, type SemanticInput, type SemanticResult, type Severity, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Surface, TELL_HEAVY, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type Tell, type TellException, type TypeStep, type Typicality, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, applyHouseGate, auditSnapshot, catalogueTable, characterReport, checkCopy, checkPair, checkRestraint, choicesOf, compareFacts, compareToEstate, craftTokens, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estatePairs, exitDuration, extractHtml, findClaims, findColours, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatClaims, formatComparison, formatHex, formatReport, groundName, harvest, hexToOklch, houseRule, hueName, hueSwatch, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isCream, makeSnapshot, motionTokens, namedSources, nearest, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, paletteFromPixels, parseColour, parseHex, propose, protectedFacts, ramp, rampFromAnchors, retrofitPlan, runTell, scanSource, sectionRhythm, semantic, shapeName, sharedParts, shouldAnimate, siblingLine, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, typeFeatureTokens, typicality, validateDirection, visibleText, wcagContrast, wordListsJson };

package/dist/index.d.ts

@@ -1031,7 +1031,7 @@ interface CheckReport {
  * Bumped whenever an entry is added, removed or its detection changes, so a
  * report can say which list it was judged against.
  */
-declare const CATALOGUE_VERSION = "2026.09.7";
+declare const CATALOGUE_VERSION = "2026.09.8";
 declare const CATALOGUE: readonly Tell[];
 declare function tellById(id: string): Tell | undefined;
 /**
@@ -1147,6 +1147,47 @@ interface FactComparison {
 declare function compareFacts(before: string, after: string): FactComparison;
 declare function formatComparison(result: FactComparison, beforePath: string, afterPath: string): string;
 
+/**
+ * The claims list: every sentence a reader would take as a checkable fact.
+ *
+ * No tell can say whether "Bark charges £2,000 to £7,000" is true. The worst
+ * faults in the DD article that set this off (2026-09-24) were figures like
+ * that: a wrong range, an unsourced day rate, a study quoted past what it
+ * found. Every one passed the copy check, because the prose was fine.
+ *
+ * So this does not judge. It lists each sentence holding a price, a figure, a
+ * date or a named source, marks whether the sentence names where it came
+ * from, and leaves the verdict to a person with the primary source open.
+ * "Sourced" means a source is named, not that it says what the sentence
+ * claims: that is exactly what the person checks.
+ *
+ * Pure over text. `craft copy claims <paths...>` is the command.
+ */
+
+interface Claim {
+    path: string;
+    line: number;
+    /** The sentence, trimmed to a readable length. */
+    sentence: string;
+    /** The prices, figures and dates in it. */
+    facts: Fact[];
+    /** Who the sentence says it comes from: a name, a publication or a link. Empty when nobody is named. */
+    sources: string[];
+    /**
+     * A source named earlier in the same paragraph. A hint for the person, never
+     * a pass: the sentence may be the writer's own arithmetic on top of it.
+     */
+    nearby?: string[];
+}
+interface ClaimsReport {
+    files: number;
+    claims: Claim[];
+    unsourced: number;
+}
+declare function namedSources(sentence: string): string[];
+declare function findClaims(files: SourceFile[]): ClaimsReport;
+declare function formatClaims(report: ClaimsReport, label?: string): string;
+
 /**
  * The rendered detection path for tells that can be seen on a live page.
  *
@@ -1779,4 +1820,4 @@ declare function characterReport(input: CharacterInputs, copyTells?: Set<string>
 
 declare function retrofitPlan(report: CharacterReport, direction?: ArtDirection | null): string;
 
-export { AI_PHRASES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type Area, type ArtDirection, BUZZWORDS, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type ContrastCheck, type ContrastReport, type CopyTell, type CraftTokensInput, type CraftTokensResult, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionProblem, type DirectionReport, type DirectionSource, type DurationName, EASE, EASE_TUPLE, ESTATE_VERSION, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, FINGERPRINT_VERSION, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, type Gamut, type Generation, HOUSE, HOUSE_BUDGET, HOUSE_TYPE, type HarvestCandidate, type HarvestOptions, type Hit, type HouseRule, type HouseTier, LIGHTNESS_CURVE, MIN_DECIDED, MIN_RUNS, type MotionDecision, type MotionKind, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PILL_LIMIT, PLAINER_WORDS, PROPOSED, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, SCALE, SHADCN_LIMIT, SHADCN_PRIMITIVES, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPRING, STOCK_PHRASES, type SectionKind, type SectionRhythmOptions, type SemanticInput, type SemanticResult, type Severity, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Surface, TELL_HEAVY, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type Tell, type TellException, type TypeStep, type Typicality, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, applyHouseGate, auditSnapshot, catalogueTable, characterReport, checkCopy, checkPair, checkRestraint, choicesOf, compareFacts, compareToEstate, craftTokens, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estatePairs, exitDuration, extractHtml, findColours, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatComparison, formatHex, formatReport, groundName, harvest, hexToOklch, houseRule, hueName, hueSwatch, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isCream, makeSnapshot, motionTokens, nearest, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, paletteFromPixels, parseColour, parseHex, propose, protectedFacts, ramp, rampFromAnchors, retrofitPlan, runTell, scanSource, sectionRhythm, semantic, shapeName, sharedParts, shouldAnimate, siblingLine, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, typeFeatureTokens, typicality, validateDirection, visibleText, wcagContrast, wordListsJson };
+export { AI_PHRASES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type Area, type ArtDirection, BUZZWORDS, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type ContrastCheck, type ContrastReport, type CopyTell, type CraftTokensInput, type CraftTokensResult, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionProblem, type DirectionReport, type DirectionSource, type DurationName, EASE, EASE_TUPLE, ESTATE_VERSION, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, FINGERPRINT_VERSION, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, type Gamut, type Generation, HOUSE, HOUSE_BUDGET, HOUSE_TYPE, type HarvestCandidate, type HarvestOptions, type Hit, type HouseRule, type HouseTier, LIGHTNESS_CURVE, MIN_DECIDED, MIN_RUNS, type MotionDecision, type MotionKind, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PILL_LIMIT, PLAINER_WORDS, PROPOSED, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, SCALE, SHADCN_LIMIT, SHADCN_PRIMITIVES, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPRING, STOCK_PHRASES, type SectionKind, type SectionRhythmOptions, type SemanticInput, type SemanticResult, type Severity, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Surface, TELL_HEAVY, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type Tell, type TellException, type TypeStep, type Typicality, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, applyHouseGate, auditSnapshot, catalogueTable, characterReport, checkCopy, checkPair, checkRestraint, choicesOf, compareFacts, compareToEstate, craftTokens, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estatePairs, exitDuration, extractHtml, findClaims, findColours, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatClaims, formatComparison, formatHex, formatReport, groundName, harvest, hexToOklch, houseRule, hueName, hueSwatch, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isCream, makeSnapshot, motionTokens, namedSources, nearest, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, paletteFromPixels, parseColour, parseHex, propose, protectedFacts, ramp, rampFromAnchors, retrofitPlan, runTell, scanSource, sectionRhythm, semantic, shapeName, sharedParts, shouldAnimate, siblingLine, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, typeFeatureTokens, typicality, validateDirection, visibleText, wcagContrast, wordListsJson };