@domandigital/craft 0.7.0 → 0.8.0

package/dist/audit.js

@@ -4,15 +4,22 @@ var isProsePath = (path) => /\.(md|markdown|mdx|txt)$/i.test(path);
 function allText(ctx) {
   return [...ctx.blocks.filter((b) => isProsePath(b.path)), ...ctx.strings.filter((b) => !isProsePath(b.path))];
 }
+var LINK = /\b(?:https?:\/\/|www\.)[^\s<>"'`)\]]+|\]\([^)\s]+\)/gi;
+function linkSpans(text) {
+  return [...text.matchAll(LINK)].map((m) => [m.index ?? 0, (m.index ?? 0) + m[0].length]);
+}
+var insideLink = (spans, at) => spans.some(([a, b]) => at >= a && at < b);
 function phrases(patterns, label, source = (ctx) => ctx.blocks, skip = () => false) {
   return (ctx) => {
     const hits = [];
     for (const block of source(ctx)) {
       const spans = [];
+      const links = linkSpans(block.text);
       for (const pattern of patterns) {
         const global = new RegExp(pattern.source, pattern.flags.includes("g") ? pattern.flags : `${pattern.flags}g`);
         for (const m of block.text.matchAll(global)) {
           if (skip(block, m[0], m.index ?? 0)) continue;
+          if (insideLink(links, m.index ?? 0)) continue;
           spans.push([m.index ?? 0, (m.index ?? 0) + m[0].length, m[0]]);
         }
       }
@@ -53,7 +60,14 @@ var AI_WORDS = [
   "moreover",
   "navigating",
   "ever-evolving",
-  "unparalleled"
+  "unparalleled",
+  // Measured: Kobak et al. 2024 (arXiv 2406.07016) found these 10 to 14 times
+  // above their expected rate in post-ChatGPT abstracts. Academic, so warn only.
+  "underscore",
+  "underscores",
+  "underscoring",
+  "showcasing",
+  "pivotal"
 ];
 var STOCK_PHRASES = [
   "in today's digital age",
@@ -67,7 +81,11 @@ var STOCK_PHRASES = [
   "curated",
   "crafted with care",
   "tailored to your",
-  "peace of mind"
+  "peace of mind",
+  "so here's",
+  "in an era where",
+  "the future looks bright",
+  "only time will tell"
 ];
 var AI_PHRASES = [
   "let's dive in",
@@ -200,7 +218,7 @@ function lineAround(text, index) {
 var emptyState = (block, match, index = 0) => SIGNED_IN.test(block.path) || DATA_ABSENCE.test(isProsePath(block.path) ? lineAround(block.text, index) : block.text) || DATA_ABSENCE.test(match);
 var NO_X_NO_Y = /\bno\s+[\w'’ ]{2,30},\s*no\s+\w/i;
 var NO_X_BADGE = /^no\s+[\w'’\- ]{2,28}[.!]?$/i;
-var EMOJI = /[\u{1F300}-\u{1FAFF}\u{1F1E6}-\u{1F1FF}]+/u;
+var EMOJI = /(?:[\u{1F300}-\u{1FAFF}\u{1F1E6}-\u{1F1FF}\u2728\u2705\u274C\u274E\u2757\u2753\u26A1\u2B50\u2764]|[\u2600-\u27BF]\uFE0F)+/u;
 var placeholderDash = (block) => block.literal === true && /^[\s—]*$/.test(block.text);
 function badgeHits(ctx) {
   const hits = [];
@@ -243,10 +261,16 @@ var COPY_TELLS = [
     surface: "copy",
     why: "Phrases every generated services page uses. They fill space where a fact should be.",
     fix: "Replace the phrase with the fact behind it: a number, a name, a place, a time.",
-    detect: phrases([wordList(STOCK_PHRASES)], quoted),
+    detect: phrases([wordList(STOCK_PHRASES), /\b(?:in|on|along)\s+(?:its|their|his|her)\s+journey\b/i], quoted),
     fixtures: {
-      flag: [f("content/home.md", "Take your plumbing to the next level with peace of mind.")],
-      pass: [f("content/home.md", "Gas Safe registered since 2009. Same-day callouts in Brackley.")]
+      flag: [
+        f("content/home.md", "Take your plumbing to the next level with peace of mind."),
+        f("content/home.md", "We meet each practice where it is in its journey.")
+      ],
+      pass: [
+        f("content/home.md", "Gas Safe registered since 2009. Same-day callouts in Brackley."),
+        f("content/home.md", "We mapped the patient journey from booking to aftercare.")
+      ]
     }
   },
   {
@@ -271,7 +295,11 @@ var COPY_TELLS = [
         f("content/home.md", "In today's rapidly evolving market, we help."),
         f("content/home.md", "Whether you're a landlord or a tenant, call us.")
       ],
-      pass: [f("content/home.md", "Book in three taps. We confirm by text within the hour.")]
+      pass: [
+        f("content/home.md", "Book in three taps. We confirm by text within the hour."),
+        f("content/home.md", "Book at https://example.com/seamless-booking today."),
+        f("content/home.md", "[Book a slot](/seamless-booking) today.")
+      ]
     }
   },
   {
@@ -420,8 +448,14 @@ var COPY_TELLS = [
     fix: "Remove it. Typographic marks are fine: a star for a rating, a middot as a separator, an arrow in a link.",
     detect: phrases([new RegExp(EMOJI.source, "u")], (m) => `emoji ${m}`, (ctx) => ctx.strings),
     fixtures: {
-      flag: [f("content/home.md", "New treatments this month \u2728\u{1F680}"), f("app/cta.tsx", `export const label = "Book \u{1F680}";`)],
-      pass: [f("content/home.md", "Rated \u2605\u2605\u2605\u2605\u2605 \xB7 Book now \u2192")]
+      flag: [
+        f("content/home.md", "New treatments this month \u2728\u{1F680}"),
+        f("app/cta.tsx", `export const label = "Book \u{1F680}";`),
+        f("content/home.md", "New treatments this month \u2728"),
+        f("content/home.md", "Same-day callouts \u2705"),
+        f("content/home.md", "Open Sundays \u2600\uFE0F")
+      ],
+      pass: [f("content/home.md", "Rated \u2605\u2605\u2605\u2605\u2605 \xB7 Book now \u2192"), f("content/home.md", "\u2713 Gas Safe registered")]
     }
   },
   {
@@ -519,6 +553,695 @@ 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 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,
+  /\bit\s+is\s+(?:widely|generally|commonly)\s+(?:known|accepted|believed|agreed)\b/i
+];
+function sourced(block, _match, index) {
+  const before = block.text.slice(Math.max(0, index - 40), index);
+  if (/(?:\b[A-Z][\w&]*[’']s|\b[A-Z]{2,}[a-z]*)\s+$/.test(before)) return true;
+  const rest = block.text.slice(index, index + 400);
+  const end = rest.search(/[.!?](?:\s|$)/);
+  const sentence = rest.slice(0, end === -1 ? rest.length : end + 16);
+  return /\[\^\w+\]|\]\(https?:|\(source|according to [A-Z]|\bper [A-Z]/.test(sentence);
+}
+var CLOSING_SUMMARY = /(?:^|[.!?]\s+|\n\s*|>\s*)(?:Overall|In conclusion|In summary|To sum up|All in all|In short|To summari[sz]e),/;
+var FALSE_RANGE = [
+  /\bfrom\s+(?:[\w'’-]+\s+){0,3}[\w'’-]+\s+to\s+(?:[\w'’-]+\s+){0,3}[\w'’-]+\s+alike\b/i,
+  /\b(?:everyone|anyone)\s+from\s+(?:[\w'’-]+\s+){0,3}[\w'’-]+\s+to\s+(?:[\w'’-]+\s*){1,4}/i
+];
+var RESIDUE = [
+  /\bas an AI(?:\s+language)?\s+(?:model|assistant)\b/i,
+  /(?:^|\n|>)\s*(?:Certainly|Sure|Absolutely|Of course|Great question)[!,.]\s+(?:Here(?:['’]s| is| are)|Below)\b/i,
+  /\bhere(?:['’]s| is)\s+(?:a|an|the|your)\s+(?:revised|rewritten|updated|polished|refined|improved|draft|more concise)\s+(?:version|draft|copy)\b/i,
+  /\blet me know if you(?:['’]d| would) like me to\b/i,
+  /\b(?:my|the) (?:knowledge|training) cut-?off\b|\bas of my last (?:update|training)\b/i,
+  /\bI hope this helps\b/i,
+  // Citation tokens a chat tool leaves in copied text.
+  // A run of them is one paste: "citeturn11search1turn10view0" is one finding.
+  // ChatGPT wraps them in invisible private-use characters (U+E200 to U+E202),
+  // which survive a copy and paste into a CMS: found live, 2026-09-23.
+  /[\uE200-\uE2FF]*(?:cite)?[\uE200-\uE2FF]*(?:turn\d+(?:search|news|view|fetch|file|image)\d+[\uE200-\uE2FF]*)+/,
+  /:?contentReference\[oaicite:\d+\](?:\{index=\d+\})?/,
+  /【\d+(?:[:†][^】]{0,40})?】/
+];
+var AI_UTM = /utm_source=(?:chatgpt\.com|chat\.openai\.com|openai|perplexity(?:\.ai)?|claude\.ai|copilot(?:\.microsoft\.com)?|gemini(?:\.google\.com)?)\b/gi;
+function residueHits(ctx) {
+  const hits = phrases(RESIDUE, quoted, allText)(ctx);
+  for (const file of ctx.files) {
+    for (const m of file.text.matchAll(AI_UTM)) hits.push({ path: file.path, offset: m.index ?? 0, message: `link tracked as copied from a chat assistant: "${m[0]}"` });
+  }
+  return hits;
+}
+var PLACEHOLDER = [
+  /\[(?:insert|your|add|company|client|business|customer|name of|placeholder)\b[^\]\n]{0,40}\](?!\()/i,
+  /\blorem ipsum\b/i,
+  /\bTODO_PLACEHOLDER\b/
+];
+var PLACEHOLDER_ELEMENT = />\s*(\[(?:insert|your|add|company|client|business|customer|name of|placeholder)\b[^\]\n<]{0,40}\])\s*</gi;
+function insideQuotes(block, _match, index) {
+  const lineStart = block.text.lastIndexOf("\n", index - 1) + 1;
+  const before = block.text.slice(lineStart, index);
+  const straight = (before.match(/"/g) ?? []).length;
+  const curly = (before.match(/“/g) ?? []).length - (before.match(/”/g) ?? []).length;
+  return straight % 2 === 1 || curly > 0;
+}
+function placeholderHits(ctx) {
+  const hits = phrases(PLACEHOLDER, quoted, allText, insideQuotes)(ctx);
+  const seen = new Set(hits.map((h) => `${h.path}:${h.offset}`));
+  for (const file of ctx.files) {
+    if (isProsePath(file.path)) continue;
+    for (const m of file.text.matchAll(PLACEHOLDER_ELEMENT)) {
+      const offset = (m.index ?? 0) + m[0].indexOf(m[1]);
+      if (!seen.has(`${file.path}:${offset}`)) hits.push({ path: file.path, offset, message: quoted(m[1]) });
+    }
+  }
+  return hits;
+}
+var QUESTION_REVEAL = [
+  /\b(?:The|Our|What['’]s the|Here['’]s the)\s+(?:result|catch|secret|answer|difference|best part|twist|kicker|bottom line|upshot)\?\s+[A-Z0-9]/,
+  /\?\s+It means\b/
+];
+function inlineLabelHits(ctx) {
+  const hits = [];
+  for (const file of ctx.files) {
+    if (!isProsePath(file.path)) continue;
+    const lines = file.text.split("\n");
+    let run = [];
+    let offset = 0;
+    const flush = () => {
+      if (run.length >= 3) hits.push({ path: file.path, offset: run[0], message: `${run.length} bullets in a row open with a bold label and a colon` });
+      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);
+      else flush();
+      offset += line.length + 1;
+    }
+    flush();
+  }
+  return hits;
+}
+var RESEARCH_TELLS = [
+  {
+    id: "chatbot-residue",
+    name: "Chatbot residue",
+    generation: 1,
+    severity: "warn",
+    surface: "copy",
+    why: "'Certainly! Here's a revised version', 'as an AI language model', a citeturn0search0 token, a link tracked utm_source=chatgpt.com: text that exists only because a chat reply was pasted whole. This is evidence, not style.",
+    fix: "Delete the residue. Then read the whole passage again, because the rest of it came from the same paste.",
+    detect: residueHits,
+    fixtures: {
+      flag: [
+        f("content/home.md", "Certainly! Here's a revised version of your home page."),
+        f("content/home.md", "As an AI language model, I cannot visit your salon."),
+        f("content/home.md", "Let me know if you'd like me to shorten it."),
+        f("content/home.md", "Prices start at \xA340 citeturn0search3 for a full set."),
+        f("content/home.md", "Prices start at \xA340. citeturn11search1turn10view0turn2view3"),
+        f("content/home.md", "Prices start at \xA340. \uE200cite\uE202turn11search1\uE202turn10view0\uE201"),
+        f("content/home.md", "Prices start at \xA340 :contentReference[oaicite:2]{index=2} for a full set."),
+        f("content/home.md", "Prices start at \xA340\u30104\u2020source\u3011 for a full set."),
+        f("app/guide.tsx", `export const Guide = () => <a href="https://example.com/guide?utm_source=chatgpt.com">Read the guide</a>;`),
+        f("content/home.md", "Here's a more concise version for the hero.")
+      ],
+      pass: [
+        f("content/home.md", "Certainly the busiest week of the year: book early."),
+        f("content/home.md", "Here's the price list for 2026."),
+        f("app/guide.tsx", `export const Guide = () => <a href="https://example.com/guide?utm_source=newsletter">Read the guide</a>;`)
+      ]
+    }
+  },
+  {
+    id: "placeholder",
+    name: "Unfilled placeholder",
+    generation: 1,
+    severity: "warn",
+    surface: "copy",
+    why: "'[Insert testimonial]', '[Your Name]', lorem ipsum, TODO_PLACEHOLDER: scaffolding a reader must never see, and the clearest sign a page shipped before anyone read it.",
+    fix: "Fill it from the client or the proof source, or remove the element. Never invent the missing fact to close it.",
+    detect: placeholderHits,
+    fixtures: {
+      flag: [
+        f("content/home.md", "Rated 5 stars by [Insert client name] and others."),
+        f("content/home.md", "Lorem ipsum dolor sit amet."),
+        f("content/home.md", "Rated TODO_PLACEHOLDER: google_rating from our reviews."),
+        f("app/card.tsx", `export const Quote = () => <blockquote>[Insert testimonial here]</blockquote>;`)
+      ],
+      pass: [
+        f("content/home.md", "Manage bookings in [your account](/account)."),
+        f("content/guide.md", 'After 90 days, check your ranking for "[your trade] [your town]" on Google.'),
+        f("content/guide.md", "Send a short message: \u201CThanks for choosing [Business Name]! Leave us a review.\u201D"),
+        f("content/home.md", "Rated 4.9 from 212 Google reviews.")
+      ]
+    }
+  },
+  {
+    id: "question-reveal",
+    name: "Staged reveal",
+    generation: 2,
+    severity: "warn",
+    surface: "copy",
+    why: "'The result? Faster growth.', 'What does this mean for you? It means...': the writer asks the reader's question for them and answers it. An infomercial hook, and a favourite of generated copy.",
+    fix: "State the answer: 'Most customers book again within six weeks.'",
+    detect: phrases(QUESTION_REVEAL, quoted),
+    fixtures: {
+      flag: [f("content/home.md", "We rebuilt the booking flow. The result? Twice the bookings."), f("content/home.md", "What does this mean for you? It means fewer missed calls.")],
+      pass: [f("content/faq.md", "How long does a set last? About three weeks with gel."), f("content/home.md", "We rebuilt the booking flow, and bookings doubled in a month.")]
+    }
+  },
+  {
+    id: "inline-label-list",
+    name: "Bold-label bullets",
+    generation: 2,
+    severity: "warn",
+    surface: "copy",
+    why: "'**Speed:** Faster pages' three times in a row: a short label restated in a few words, the list shape generated copy defaults to. A definition list, with a real explanation after each label, is not this.",
+    fix: "Drop the labels and write each bullet as the fact: 'Pages load in under a second'. Keep labels only where they help a reader navigate, as in a specification.",
+    detect: inlineLabelHits,
+    fixtures: {
+      flag: [f("content/home.md", "- **Speed:** Faster pages\n- **Security:** Safer data\n- **Support:** Help when you need it\n")],
+      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")
+      ]
+    }
+  },
+  {
+    id: "ing-tail",
+    name: "Empty -ing tail",
+    generation: 2,
+    severity: "warn",
+    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*/, ""))),
+    fixtures: {
+      flag: [
+        f("content/home.md", "Every engineer is Gas Safe registered, ensuring complete peace of mind."),
+        f("app/about.tsx", `export const About = () => <p>We have served Brackley since 2009, highlighting our commitment to the town.</p>;`)
+      ],
+      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.")
+      ]
+    }
+  },
+  {
+    id: "vague-attribution",
+    name: "Unnamed source",
+    generation: 1,
+    severity: "warn",
+    surface: "copy",
+    why: "'Studies show', 'experts agree', 'it is widely known': a claim credited to nobody. A reader cannot check it, and the house proof rule forbids a claim nobody can check.",
+    fix: "Name the source and the number ('A 2023 Which? survey of 2,000 drivers found...') or cut the claim.",
+    detect: phrases(VAGUE_ATTRIBUTION, quoted, (ctx) => ctx.blocks, sourced),
+    fixtures: {
+      flag: [
+        f("content/home.md", "Studies show that regular servicing saves money."),
+        f("content/home.md", "Most experts agree a boiler lasts fifteen years."),
+        f("content/home.md", "It is widely known that gel damages nails.")
+      ],
+      pass: [
+        f("content/home.md", "A 2023 Which? survey of 2,000 owners found serviced boilers failed half as often."),
+        f("content/home.md", "BrightLocal's research shows that reviews drive 20% of local ranking."),
+        f("content/home.md", "Research shows 62% of consumers avoid a business with wrong hours.[^7]"),
+        f("content/home.md", "Our customers rate us 4.9 from 212 Google reviews.")
+      ]
+    }
+  },
+  {
+    id: "closing-summary",
+    name: "Closing summary",
+    generation: 1,
+    severity: "warn",
+    surface: "copy",
+    why: "'Overall,', 'In conclusion,', 'In short,': a paragraph that announces it is summing up, then restates what the reader has just read.",
+    fix: "Cut the summary. End on the last new fact, or on the next step: 'Book a survey and we'll quote within two days'.",
+    detect: phrases([CLOSING_SUMMARY], (m) => quoted(m.replace(/^[.!?>\s]+/, ""))),
+    fixtures: {
+      flag: [
+        f("content/home.md", "We rewire, test and certify.\n\nOverall, we are the right choice for your home."),
+        f("content/home.md", "Prices start at \xA340. In conclusion, we offer great value.")
+      ],
+      pass: [f("content/home.md", "We rewire, test and certify.\n\nBook a survey and we'll quote within two days.")]
+    }
+  },
+  {
+    id: "false-range",
+    name: "False range",
+    generation: 1,
+    severity: "warn",
+    surface: "copy",
+    why: "'From first-time buyers to seasoned investors alike' names two ends of no real scale, to sound as if it covers everyone. It describes nobody.",
+    fix: "Say who you actually serve, or cut it. A real range is fine: 'from 9am to 5pm', 'from small repairs to full rewires'.",
+    detect: phrases(FALSE_RANGE, quoted),
+    fixtures: {
+      flag: [
+        f("content/home.md", "We help clients from first-time buyers to seasoned investors alike."),
+        f("content/home.md", "Everyone from students to retirees loves our cakes.")
+      ],
+      pass: [
+        f("content/home.md", "Open from 9am to 5pm, Monday to Saturday."),
+        f("content/home.md", "We take on everything from small repairs to full rewires.")
+      ]
+    }
+  }
+];
+
+// src/character/tells/density.ts
+var DOCUMENT = /\.(md|markdown|mdx|txt|html?)$/i;
+var MIN_WORDS = 400;
+var WORD = /[A-Za-z0-9£$€][\w'’£$€%.,-]*/g;
+var countWords = (text) => (text.match(WORD) ?? []).length;
+function documents(ctx) {
+  const byPath = /* @__PURE__ */ new Map();
+  for (const block of ctx.blocks) {
+    if (!DOCUMENT.test(block.path) || block.literal) continue;
+    const list = byPath.get(block.path) ?? [];
+    list.push(block);
+    byPath.set(block.path, list);
+  }
+  const docs = [];
+  for (const [path, blocks] of byPath) {
+    const text = blocks.map((b) => withoutHeadings(b.text)).join("\n");
+    const words = countWords(text);
+    if (words >= MIN_WORDS) docs.push({ path, blocks, words });
+  }
+  return docs;
+}
+var withoutHeadings = (text) => text.replace(/^\s{0,3}#{1,6}\s.*$/gm, "");
+var allowed = (doc2, floor, per1000) => Math.max(floor, Math.floor(doc2.words * per1000 / 1e3));
+var thousands = (n) => n.toLocaleString("en-GB");
+function sentences(doc2) {
+  const out = [];
+  for (const block of doc2.blocks) {
+    const text = withoutHeadings(block.text);
+    for (const para of text.matchAll(/[^\n]+(?:\n(?!\s*\n)[^\n]+)*/g)) {
+      const body = para[0];
+      const start = para.index ?? 0;
+      for (const m of body.matchAll(/[^.!?]+[.!?]+["'’”)]*|[^.!?]+$/g)) {
+        const raw = m[0];
+        const trimmed = raw.trim();
+        if (countWords(trimmed) === 0) continue;
+        const lead = raw.length - raw.trimStart().length;
+        out.push({ text: trimmed.replace(/\s+/g, " "), offset: block.offset + start + (m.index ?? 0) + lead });
+      }
+    }
+  }
+  return out;
+}
+var RATES = [
+  { label: "rather than", pattern: /\brather\s+than\b/i, floor: 4, per1000: 0.9, why: "the document's one move" },
+  { label: "instead of", pattern: /\binstead\s+of\b/i, floor: 4, per1000: 0.7, why: "the reflex swap once 'rather than' is edited out" },
+  { label: "actually", pattern: /\bactually\b/i, floor: 2, per1000: 0.35, why: "filler, the sentence means the same without it" },
+  { label: "properly", pattern: /\bproperly\b/i, floor: 3, per1000: 0.4, why: "filler, the sentence means the same without it" },
+  { label: "genuinely", pattern: /\bgenuinely\b/i, floor: 1, per1000: 0.2, why: "reaching for sincerity: one is emphasis, two is a tic" },
+  {
+    label: "the single ...est",
+    pattern: /\bthe\s+single\s+(?:\w+est|most|\w+\s+most)\b/i,
+    floor: 1,
+    per1000: 0.15,
+    why: "if three things are the single most important, none is"
+  },
+  { label: "That is / This is opener", pattern: /^(?:That\s+is|That['’]s|This\s+is)\b/, opener: true, floor: 4, per1000: 0.7, why: "pointing back instead of moving on" },
+  { label: "Every opener", pattern: /^Every\b/, opener: true, floor: 4, per1000: 0.6, why: "the same sweeping opener, again" },
+  {
+    label: "Worth noting opener",
+    pattern: /^(?:Worth\s+(?:knowing|noting|saying|mentioning|remembering)|It(?:['’]s|\s+is)\s+worth\s+(?:knowing|noting|saying|mentioning|remembering))\b/,
+    opener: true,
+    floor: 3,
+    per1000: 0.5,
+    why: "a hedge that lets a sentence start without committing"
+  },
+  {
+    label: "negation-led opener",
+    pattern: /^(?:None\s+of|Not\s+one|Not\s+a\s+single|Nothing|No\s+one|Nobody|Never)\b/,
+    opener: true,
+    floor: 5,
+    per1000: 1,
+    why: "each earns its place once or twice; at twenty the document has one move"
+  },
+  {
+    label: "participle triad",
+    pattern: /\b[a-z]{3,}ed,\s+[a-z]{3,}ed,?\s+and\s+[a-z]{3,}ed\b/i,
+    floor: 3,
+    per1000: 0.6,
+    why: "'researched, written and referenced' is fine once and a cadence in bulk"
+  }
+];
+function rateHits(ctx) {
+  const hits = [];
+  for (const doc2 of documents(ctx)) {
+    const list = sentences(doc2);
+    for (const rate of RATES) {
+      const found = [];
+      const global = new RegExp(rate.pattern.source, rate.pattern.flags.replace("g", "") + "g");
+      for (const s of list) {
+        if (rate.opener) {
+          if (rate.pattern.test(s.text)) found.push(s);
+        } else {
+          const n = (s.text.match(global) ?? []).length;
+          for (let k = 0; k < n; k += 1) found.push(s);
+        }
+      }
+      const limit = allowed(doc2, rate.floor, rate.per1000);
+      if (found.length > limit) {
+        hits.push({
+          path: doc2.path,
+          offset: found[limit].offset,
+          message: `"${rate.label}" ${found.length} times in ${thousands(doc2.words)} words (allows ${limit}): ${rate.why}`,
+          excerpt: found[limit].text.slice(0, 120)
+        });
+      }
+    }
+  }
+  return hits;
+}
+function aphorismHits(ctx) {
+  const hits = [];
+  for (const doc2 of documents(ctx)) {
+    const found = [];
+    for (const block of doc2.blocks) {
+      let at = 0;
+      for (const line of withoutHeadings(block.text).split("\n")) {
+        const text = line.trim().replace(/^[-*>]\s+/, "");
+        const parts2 = text.match(/[^.!?]+[.!?]+/g) ?? [];
+        if (parts2.length === 2 && parts2.join("").length >= text.length - 1 && parts2.every((p) => countWords(p) >= 2 && countWords(p) <= 7)) {
+          found.push({ text, offset: block.offset + at + line.indexOf(text.charAt(0)) });
+        }
+        at += line.length + 1;
+      }
+    }
+    const limit = allowed(doc2, 5, 1.2);
+    if (found.length > limit) {
+      hits.push({
+        path: doc2.path,
+        offset: found[limit].offset,
+        message: `${found.length} two-line aphorisms in ${thousands(doc2.words)} words (allows ${limit}). Keep the one that lands hardest`,
+        excerpt: found[limit].text
+      });
+    }
+  }
+  return hits;
+}
+var CONTRACTION = /\b(?:\w+n['’]t|\w+['’](?:re|ve|ll|m|d)|(?:it|that|there|here|what|who|he|she|let|where)['’]s)\b/gi;
+function contractionHits(ctx) {
+  const hits = [];
+  for (const doc2 of documents(ctx)) {
+    if (doc2.words < 800) continue;
+    const text = doc2.blocks.map((b) => withoutHeadings(b.text)).join("\n");
+    const count2 = (text.match(CONTRACTION) ?? []).length;
+    const rate = count2 * 1e3 / doc2.words;
+    if (rate < 1) {
+      const first = sentences(doc2)[0];
+      hits.push({
+        path: doc2.path,
+        offset: first?.offset ?? 0,
+        message: `${count2} contraction${count2 === 1 ? "" : "s"} in ${thousands(doc2.words)} words. Prose with none reads stiff; formal legal pages are the exception`
+      });
+    }
+  }
+  return hits;
+}
+function rhythmHits(ctx) {
+  const hits = [];
+  for (const doc2 of documents(ctx)) {
+    const list = sentences(doc2);
+    if (list.length < 40) continue;
+    const lengths = list.map((s) => countWords(s.text));
+    const mean = lengths.reduce((a, b) => a + b, 0) / lengths.length;
+    const sd = Math.sqrt(lengths.reduce((a, b) => a + (b - mean) ** 2, 0) / lengths.length);
+    const cv = sd / mean;
+    if (cv < 0.42) {
+      hits.push({
+        path: doc2.path,
+        offset: list[0].offset,
+        message: `${list.length} sentences averaging ${mean.toFixed(1)} words with little variation (spread ${cv.toFixed(2)}, reads metronomic below 0.42)`
+      });
+    }
+  }
+  return hits;
+}
+var normal = (s) => s.toLowerCase().replace(/[’]/g, "'").match(/[a-z0-9£$€'%]+/g) ?? [];
+function repeatHits(ctx) {
+  const hits = [];
+  const RUN = 9;
+  for (const doc2 of documents(ctx)) {
+    const whole = /* @__PURE__ */ new Map();
+    const runs = /* @__PURE__ */ new Map();
+    for (const s of sentences(doc2)) {
+      const words = normal(s.text);
+      if (words.length < RUN || !/[.!?]["'’”)]*$/.test(s.text)) continue;
+      const key = words.join(" ");
+      const earlier = whole.get(key);
+      if (earlier) {
+        hits.push({ path: doc2.path, offset: s.offset, message: `the same sentence appears twice (${words.length} words)`, excerpt: s.text.slice(0, 120) });
+        continue;
+      }
+      whole.set(key, s);
+      let reported = false;
+      for (let i = 0; i + RUN <= words.length && !reported; i += 1) {
+        const run = words.slice(i, i + RUN).join(" ");
+        const seen = runs.get(run);
+        if (seen && seen.key !== key) {
+          hits.push({ path: doc2.path, offset: s.offset, message: `shares a ${RUN}-word run with an earlier sentence: "${run}"`, excerpt: s.text.slice(0, 120) });
+          reported = true;
+        } else if (!seen) {
+          runs.set(run, { sentence: s, key });
+        }
+      }
+    }
+  }
+  return hits;
+}
+function headings(file) {
+  const out = [];
+  for (const m of file.text.matchAll(/^\s{0,3}#{1,6}\s+(.+?)\s*#*\s*$/gm)) {
+    out.push({ text: m[1], offset: (m.index ?? 0) + m[0].indexOf(m[1]), end: (m.index ?? 0) + m[0].length });
+  }
+  for (const m of file.text.matchAll(/<h[1-6]\b[^>]*>([\s\S]*?)<\/h[1-6]>/gi)) {
+    const text = m[1].replace(/<[^>]+>/g, "").replace(/\s+/g, " ").trim();
+    if (text) out.push({ text, offset: (m.index ?? 0) + m[0].indexOf(m[1]), end: (m.index ?? 0) + m[0].length });
+  }
+  return out.sort((a, b) => a.offset - b.offset);
+}
+function longFiles(ctx) {
+  const docs = new Map(documents(ctx).map((d) => [d.path, d]));
+  return ctx.files.filter((f4) => docs.has(f4.path)).map((file) => ({ file, doc: docs.get(file.path) }));
+}
+var HEADING_SHAPES = [
+  ["X, and Y", /^[^,]{2,}, and [^,]{2,}$/i],
+  ["X, because Y", /^[^,]{2,}, because [^,]{2,}$/i],
+  ["comma list", /^[A-Z][\w'’-]*(?:, [\w'’-]+){2,}(?:,? (?:and|or) [\w'’-]+)?\.?$/]
+];
+function headingShapeHits(ctx) {
+  const hits = [];
+  for (const { file, doc: doc2 } of longFiles(ctx)) {
+    const found = [];
+    for (const heading of headings(file)) {
+      const shape = HEADING_SHAPES.find(([, re]) => re.test(heading.text));
+      if (shape) found.push({ heading, shape: shape[0] });
+    }
+    const limit = allowed(doc2, 3, 0.5);
+    if (found.length > limit) {
+      hits.push({
+        path: file.path,
+        offset: found[limit].heading.offset,
+        message: `${found.length} headings share one shape (${[...new Set(found.map((f4) => f4.shape))].join(", ")}), allows ${limit}`,
+        excerpt: found[limit].heading.text
+      });
+    }
+  }
+  return hits;
+}
+function headingEchoHits(ctx) {
+  const hits = [];
+  for (const { file } of longFiles(ctx)) {
+    for (const heading of headings(file)) {
+      const words = normal(heading.text);
+      if (words.length < 4) continue;
+      const after = file.text.slice(heading.end, heading.end + 600).trimStart().replace(/^\s*(?:<\/?(?:p|div|section)\b[^>]*>\s*)*/i, "");
+      const opening = normal(after.split(/\n\s*\n/)[0] ?? "").slice(0, words.length);
+      if (opening.join(" ") === words.join(" ")) {
+        hits.push({ path: file.path, offset: heading.offset, message: `the heading "${heading.text}" is repeated as the first words under it` });
+      }
+    }
+  }
+  return hits;
+}
+var FILLER_WORDS = "boiler van kitchen garden studio market street window roof tile paint brush ladder hedge lawn fence gate shop counter oven bread flour kettle chair table shelf lamp cable socket switch meter valve pipe tap sink drain gutter brick mortar timber plank screw bolt hinge lock key door frame glass mirror towel basin morning evening winter summer spring autumn monday tuesday friday weekend hour minute week month year fitted checked cleaned painted mended booked quoted delivered collected measured sanded sealed wired local quiet small large early late busy bright warm dry".split(" ");
+function filler(words, seed = 1, options = {}) {
+  const { contractions = true, uniform } = options;
+  const shape = [5, 17, 9, 24, 6, 13, 31, 8, 11, 4, 20, 15];
+  let state = seed;
+  const next = (n) => {
+    state = (state * 1103515245 + 12345) % 2147483648;
+    return state % n;
+  };
+  const out = [];
+  let count2 = 0;
+  let i = 0;
+  while (count2 < words) {
+    const length = uniform ?? shape[i % shape.length];
+    const s = [];
+    for (let w = 0; w < length; w += 1) s.push(FILLER_WORDS[next(FILLER_WORDS.length)]);
+    if (contractions && i % 6 === 2) s.splice(1, 0, "we're");
+    s[0] = s[0].charAt(0).toUpperCase() + s[0].slice(1);
+    out.push(`${s.join(" ")}.`);
+    count2 += s.length;
+    i += 1;
+  }
+  const paragraphs = [];
+  for (let p = 0; p < out.length; p += 4) paragraphs.push(out.slice(p, p + 4).join(" "));
+  return paragraphs.join("\n\n");
+}
+var f2 = (path, text) => ({ path, text });
+var doc = (extra, seed = 1) => `${filler(520, seed)}
+
+${extra}
+`;
+var times = (n, sentence) => Array.from({ length: n }, (_, i) => sentence(i)).join(" ");
+var DENSITY_TELLS = [
+  {
+    id: "phrase-density",
+    name: "Leaned-on phrase",
+    generation: 2,
+    severity: "warn",
+    surface: "copy",
+    why: "'Rather than', 'actually', 'That is...' openers, participle triads: each is ordinary English once, and a document that uses one far above its rate has one move and repeats it.",
+    fix: "Keep the instances that land hardest and vary or cut the rest. Never delete every one: the count is the problem, not the phrase.",
+    detect: rateHits,
+    fixtures: {
+      flag: [
+        f2("content/proposal.md", doc(times(6, (i) => `We fitted boiler ${i} rather than patching it.`))),
+        f2("content/proposal.md", doc(times(6, (i) => `We sealed roof ${i} instead of patching it.`))),
+        f2("content/proposal.md", doc(times(4, (i) => `Room ${i} actually needed a new valve.`))),
+        f2("content/proposal.md", doc(times(5, (i) => `Gate ${i} was properly hung.`))),
+        f2("content/proposal.md", doc(times(3, (i) => `Kitchen ${i} was genuinely tidy.`))),
+        f2("content/proposal.md", doc(times(3, (i) => `Pipe ${i} is the single biggest risk.`))),
+        f2("content/proposal.md", doc(times(6, (i) => `That is why tap ${i} leaks.`))),
+        f2("content/proposal.md", doc(times(6, (i) => `Every tap ${i} gets checked.`))),
+        f2("content/proposal.md", doc(times(5, (i) => `Worth noting: valve ${i} sticks.`))),
+        f2("content/proposal.md", doc(times(7, (i) => `None of room ${i} needed paint.`))),
+        f2("content/proposal.md", doc(times(5, (i) => `Wall ${i} was measured, sanded and sealed.`))),
+        f2("site/index.html", `<html><body><p>${filler(520, 3)}</p><p>${times(6, (i) => `We fitted boiler ${i} rather than patching it.`)}</p></body></html>`)
+      ],
+      pass: [
+        f2("content/proposal.md", doc(times(3, (i) => `We fitted boiler ${i} rather than patching it.`))),
+        f2("content/short.md", times(6, (i) => `We fitted boiler ${i} rather than patching it.`)),
+        f2("app/page.tsx", `export const copy = [${Array.from({ length: 40 }, (_, i) => `"We fitted boiler ${i} rather than patching it."`).join(", ")}];`)
+      ]
+    }
+  },
+  {
+    id: "aphorism-density",
+    name: "Aphorism cadence",
+    generation: 2,
+    severity: "warn",
+    surface: "copy",
+    why: "Two clipped sentences alone on a line ('All of this already exists. The job is making it findable.') land once. Closing every section, they are a cadence a reader learns to hear.",
+    fix: "Keep the strongest one. Fold the rest into the paragraph above as plain statements.",
+    detect: aphorismHits,
+    fixtures: {
+      flag: [f2("content/proposal.md", doc(Array.from({ length: 7 }, (_, i) => `The site exists. Job ${i} makes it findable.`).join("\n\n")))],
+      pass: [f2("content/proposal.md", doc(Array.from({ length: 3 }, (_, i) => `The site exists. Job ${i} makes it findable.`).join("\n\n")))]
+    }
+  },
+  {
+    id: "contraction-scarcity",
+    name: "No contractions",
+    generation: 1,
+    severity: "warn",
+    surface: "copy",
+    why: "A long document with almost no contractions reads stiff and machine-made. People write 'we're' and 'don't'.",
+    fix: "Contract where you would in speech: 'we are' to 'we're', 'do not' to 'don't'. Formal legal pages are the deliberate exception.",
+    detect: contractionHits,
+    fixtures: {
+      flag: [f2("content/proposal.md", filler(900, 5, { contractions: false }))],
+      pass: [f2("content/proposal.md", filler(900, 5)), f2("content/short.md", filler(500, 5, { contractions: false }))]
+    }
+  },
+  {
+    id: "sentence-rhythm",
+    name: "Metronomic rhythm",
+    generation: 2,
+    severity: "warn",
+    surface: "copy",
+    why: "Sentence after sentence of the same length reads generated. A person's sentences run long, then short, then long again.",
+    fix: "Break one long sentence in two, join two short ones, and let some sentences be flat and plain.",
+    detect: rhythmHits,
+    fixtures: {
+      flag: [f2("content/proposal.md", filler(600, 7, { uniform: 12 }))],
+      pass: [f2("content/proposal.md", filler(600, 7))]
+    }
+  },
+  {
+    id: "repeated-sentence",
+    name: "Repeated sentence",
+    generation: 1,
+    severity: "warn",
+    surface: "copy",
+    why: "The same sentence on two pages, or the same nine words lightly edited, is one of the strongest signs a document was assembled rather than written.",
+    fix: "Say it once, where it matters most, and write the second place fresh.",
+    detect: repeatHits,
+    fixtures: {
+      flag: [
+        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."))]
+    }
+  },
+  {
+    id: "heading-shape",
+    name: "One heading shape",
+    generation: 2,
+    severity: "warn",
+    surface: "copy",
+    why: "Headings that all share one shape ('X, and Y', 'X, because Y', 'Keep, rewrite, consolidate, retire') read as a template filled in section by section.",
+    fix: "Write each heading for its section. Most should be a plain noun phrase.",
+    detect: headingShapeHits,
+    fixtures: {
+      flag: [
+        f2("content/proposal.md", ["## Fast, and fairly priced", "## Local, and insured", "## Tidy, and quiet", "## Early, and on time", "", filler(520, 9)].join("\n\n")),
+        f2("site/index.html", `<h2>Fast, because we care</h2><h2>Tidy, because it matters</h2><h2>Early, because you asked</h2><h2>Quiet, because neighbours</h2><p>${filler(520, 9)}</p>`),
+        f2("content/proposal.md", ["## Keep, rewrite, retire", "## Fix, paint, seal", "## Book, quote, fit", "## Plan, build, check", "", filler(520, 9)].join("\n\n"))
+      ],
+      pass: [f2("content/proposal.md", ["## Pricing", "## Fast, and fairly priced", "## Who we are", "## Areas we cover", "", filler(520, 9)].join("\n\n"))]
+    }
+  },
+  {
+    id: "heading-echo",
+    name: "Heading echoed",
+    generation: 2,
+    severity: "warn",
+    surface: "copy",
+    why: "A heading repeated word for word as the first line under it spends the reader's attention twice on the same words.",
+    fix: "Let the first sentence say something the heading did not.",
+    detect: headingEchoHits,
+    fixtures: {
+      flag: [
+        f2("content/proposal.md", `## We fix boilers the same day
+
+We fix boilers the same day across Brackley.
+
+${filler(520, 11)}`),
+        f2("site/index.html", `<h2>We fix boilers the same day</h2>
+<p>We fix boilers the same day across Brackley.</p><p>${filler(520, 11)}</p>`)
+      ],
+      pass: [f2("content/proposal.md", `## We fix boilers the same day
+
+Call before noon and an engineer is with you by six.
+
+${filler(520, 11)}`)]
+    }
+  }
+];
 
 // src/color/oklch.ts
 var clamp01 = (n) => n < 0 ? 0 : n > 1 ? 1 : n;
@@ -582,8 +1305,8 @@ function parts(fn) {
 function hslToRgb(h, s, l) {
   const k = (n) => (n + h / 30) % 12;
   const a = s * Math.min(l, 1 - l);
-  const f3 = (n) => l - a * Math.max(-1, Math.min(k(n) - 3, Math.min(9 - k(n), 1)));
-  return { r: f3(0), g: f3(8), b: f3(4) };
+  const f4 = (n) => l - a * Math.max(-1, Math.min(k(n) - 3, Math.min(9 - k(n), 1)));
+  return { r: f4(0), g: f4(8), b: f4(4) };
 }
 var clamp012 = (n) => Math.min(1, Math.max(0, n));
 function parseColour(raw) {
@@ -695,7 +1418,7 @@ function firstMatch(text, pattern) {
   return m ? m.index : -1;
 }
 var FRAMEWORK_PALETTE = /^--(?:color-)?(?:slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-\d+$|^--tw-/;
-var f2 = (path, text) => ({ path, text });
+var f3 = (path, text) => ({ path, text });
 function familyNames(value) {
   return value.split(",").map((v) => v.trim().replace(/^["']|["']$/g, "").trim()).filter(Boolean);
 }
@@ -1160,14 +1883,14 @@ var SOURCE_TELLS = [
     detect: fontTell(REFLEX_FONTS_1),
     fixtures: {
       flag: [
-        f2("app/layout.tsx", `import { Inter } from "next/font/google";
+        f3("app/layout.tsx", `import { Inter } from "next/font/google";
 const inter = Inter({ subsets: ["latin"] });`),
-        f2("index.html", `<link href="https://fonts.googleapis.com/css2?family=Poppins:wght@400;600" rel="stylesheet">`),
-        f2("tailwind.config.js", `fontFamily: { sans: ["Roboto", "sans-serif"] }`),
-        f2("main.ts", `import "@fontsource/montserrat";`),
-        f2("components/A.tsx", `<p className="font-['Open_Sans']">x</p>`)
+        f3("index.html", `<link href="https://fonts.googleapis.com/css2?family=Poppins:wght@400;600" rel="stylesheet">`),
+        f3("tailwind.config.js", `fontFamily: { sans: ["Roboto", "sans-serif"] }`),
+        f3("main.ts", `import "@fontsource/montserrat";`),
+        f3("components/A.tsx", `<p className="font-['Open_Sans']">x</p>`)
       ],
-      pass: [f2("app/layout.tsx", `import { Bricolage_Grotesque } from "next/font/google";`)]
+      pass: [f3("app/layout.tsx", `import { Bricolage_Grotesque } from "next/font/google";`)]
     }
   },
   {
@@ -1180,10 +1903,10 @@ const inter = Inter({ subsets: ["latin"] });`),
     fix: "Pick the display face from the client's world (signage, packaging, the trade's lettering) and record why in art-direction.json. If this face really is the right one, declare an exception with the reason and the evidence.",
     detect: fontTell(REFLEX_FONTS_2),
     fixtures: {
-      flag: [f2("src/styles.css", `@theme {
+      flag: [f3("src/styles.css", `@theme {
   --font-sans: "DM Sans", system-ui, sans-serif;
 }`)],
-      pass: [f2("src/styles.css", `@theme {
+      pass: [f3("src/styles.css", `@theme {
   --font-sans: "Hanken Grotesk", system-ui, sans-serif;
 }`)]
     }
@@ -1199,10 +1922,10 @@ const inter = Inter({ subsets: ["latin"] });`),
     detect: violetHits,
     fixtures: {
       flag: [
-        f2("components/Hero.tsx", `<a className="rounded-md bg-indigo-600 px-4 py-2 text-white">Book</a>`),
-        f2("app/globals.css", `:root { --accent: #5a35d1; }`)
+        f3("components/Hero.tsx", `<a className="rounded-md bg-indigo-600 px-4 py-2 text-white">Book</a>`),
+        f3("app/globals.css", `:root { --accent: #5a35d1; }`)
       ],
-      pass: [f2("components/Hero.tsx", `<a className="rounded-md bg-emerald-700 px-4 py-2 text-white">Book</a>`)]
+      pass: [f3("components/Hero.tsx", `<a className="rounded-md bg-emerald-700 px-4 py-2 text-white">Book</a>`)]
     }
   },
   {
@@ -1216,10 +1939,10 @@ const inter = Inter({ subsets: ["latin"] });`),
     detect: gradientHits,
     fixtures: {
       flag: [
-        f2("components/Hero.tsx", `<section className="bg-gradient-to-r from-blue-600 to-purple-600">`),
-        f2("app/globals.css", `.hero { background: linear-gradient(135deg, #2563eb, #9333ea); }`)
+        f3("components/Hero.tsx", `<section className="bg-gradient-to-r from-blue-600 to-purple-600">`),
+        f3("app/globals.css", `.hero { background: linear-gradient(135deg, #2563eb, #9333ea); }`)
       ],
-      pass: [f2("components/Hero.tsx", `<section className="bg-gradient-to-b from-stone-100 to-stone-200">`)]
+      pass: [f3("components/Hero.tsx", `<section className="bg-gradient-to-b from-stone-100 to-stone-200">`)]
     }
   },
   {
@@ -1233,10 +1956,10 @@ const inter = Inter({ subsets: ["latin"] });`),
     detect: gradientTextHits,
     fixtures: {
       flag: [
-        f2("components/Hero.tsx", `<h1 className="bg-gradient-to-r from-rose-500 to-amber-500 bg-clip-text text-transparent">`),
-        f2("app/globals.css", `.headline { -webkit-background-clip: text; color: transparent; }`)
+        f3("components/Hero.tsx", `<h1 className="bg-gradient-to-r from-rose-500 to-amber-500 bg-clip-text text-transparent">`),
+        f3("app/globals.css", `.headline { -webkit-background-clip: text; color: transparent; }`)
       ],
-      pass: [f2("components/Hero.tsx", `<h1 className="font-display text-5xl text-ink">`)]
+      pass: [f3("components/Hero.tsx", `<h1 className="font-display text-5xl text-ink">`)]
     }
   },
   {
@@ -1250,10 +1973,10 @@ const inter = Inter({ subsets: ["latin"] });`),
     detect: glassHits,
     fixtures: {
       flag: [
-        f2("components/Hero.tsx", `<div className="rounded-2xl bg-white/10 p-8 backdrop-blur-md">`),
-        f2("app/globals.css", `.card { background: rgb(255 255 255 / .1); backdrop-filter: blur(12px); }`)
+        f3("components/Hero.tsx", `<div className="rounded-2xl bg-white/10 p-8 backdrop-blur-md">`),
+        f3("app/globals.css", `.card { background: rgb(255 255 255 / .1); backdrop-filter: blur(12px); }`)
       ],
-      pass: [f2("components/Hero.tsx", `<div className="rounded-sm bg-paper p-8">`)]
+      pass: [f3("components/Hero.tsx", `<div className="rounded-sm bg-paper p-8">`)]
     }
   },
   {
@@ -1266,10 +1989,10 @@ const inter = Inter({ subsets: ["latin"] });`),
     fix: "Follow the hero with the thing only this business has: the work, the place, the person. Put proof where a doubt arises.",
     detect: heroThenProofHits,
     fixtures: {
-      flag: [f2("app/page.tsx", `export default function Page() {
+      flag: [f3("app/page.tsx", `export default function Page() {
   return (<main><Hero /><TrustStrip /><Services /></main>);
 }`)],
-      pass: [f2("app/page.tsx", `export default function Page() {
+      pass: [f3("app/page.tsx", `export default function Page() {
   return (<main><Hero /><Workshop /><TrustStrip /></main>);
 }`)]
     }
@@ -1285,7 +2008,7 @@ const inter = Inter({ subsets: ["latin"] });`),
     detect: iconGridHits,
     fixtures: {
       flag: [
-        f2(
+        f3(
           "components/Features.tsx",
           `import { Heart } from "lucide-react";
 <div className="grid grid-cols-1 gap-6 md:grid-cols-3">
@@ -1293,7 +2016,7 @@ const inter = Inter({ subsets: ["latin"] });`),
 </div>`
         )
       ],
-      pass: [f2("components/Features.tsx", `<ul className="divide-y">
+      pass: [f3("components/Features.tsx", `<ul className="divide-y">
   <li className="flex justify-between py-3">Gel manicure <span>\xA332</span></li>
 </ul>`)]
     }
@@ -1308,8 +2031,8 @@ const inter = Inter({ subsets: ["latin"] });`),
     fix: `Keep one gated signature moment per page (STANDARD section 7) and let the rest arrive still. The limit here is ${REVEAL_LIMIT} per scan.`,
     detect: revealHits,
     fixtures: {
-      flag: [f2("app/page.tsx", Array.from({ length: REVEAL_LIMIT + 1 }, (_, i) => `<Reveal><Block n={${i}} /></Reveal>`).join("\n"))],
-      pass: [f2("app/page.tsx", `<Reveal><Signature /></Reveal>
+      flag: [f3("app/page.tsx", Array.from({ length: REVEAL_LIMIT + 1 }, (_, i) => `<Reveal><Block n={${i}} /></Reveal>`).join("\n"))],
+      pass: [f3("app/page.tsx", `<Reveal><Signature /></Reveal>
 <Block />
 <Block />`)]
     }
@@ -1324,8 +2047,8 @@ const inter = Inter({ subsets: ["latin"] });`),
     fix: `Choose the shape language on purpose (and record it), then use the pill only where it means something. The limit here is ${PILL_LIMIT} per scan.`,
     detect: pillHits,
     fixtures: {
-      flag: [f2("components/Tags.tsx", Array.from({ length: PILL_LIMIT + 1 }, () => `<span className="rounded-full px-3">tag</span>`).join("\n"))],
-      pass: [f2("components/Tags.tsx", `<span className="rounded-full px-3">tag</span>
+      flag: [f3("components/Tags.tsx", Array.from({ length: PILL_LIMIT + 1 }, () => `<span className="rounded-full px-3">tag</span>`).join("\n"))],
+      pass: [f3("components/Tags.tsx", `<span className="rounded-full px-3">tag</span>
 <a className="rounded-sm px-4">Book</a>`)]
     }
   },
@@ -1339,8 +2062,8 @@ const inter = Inter({ subsets: ["latin"] });`),
     fix: "Delete the primitives nothing imports. Restyle the ones that stay so they belong to this site.",
     detect: shadcnHits,
     fixtures: {
-      flag: [SHADCN_PRIMITIVES.slice(0, SHADCN_LIMIT).map((name) => f2(`src/components/ui/${name}.tsx`, `export function X() { return null; }`))],
-      pass: [f2("src/components/ui/button.tsx", `export function Button() { return null; }`)]
+      flag: [SHADCN_PRIMITIVES.slice(0, SHADCN_LIMIT).map((name) => f3(`src/components/ui/${name}.tsx`, `export function X() { return null; }`))],
+      pass: [f3("src/components/ui/button.tsx", `export function Button() { return null; }`)]
     }
   },
   {
@@ -1354,11 +2077,11 @@ const inter = Inter({ subsets: ["latin"] });`),
     detect: creamHits,
     fixtures: {
       flag: [
-        f2("app/globals.css", `body { background-color: #f5efe6; }`),
-        f2("app/page.tsx", `<main className="bg-cream text-ink">`),
-        f2("app/page.tsx", `<main className="bg-[#f7f1e8]">`)
+        f3("app/globals.css", `body { background-color: #f5efe6; }`),
+        f3("app/page.tsx", `<main className="bg-cream text-ink">`),
+        f3("app/page.tsx", `<main className="bg-[#f7f1e8]">`)
       ],
-      pass: [f2("app/globals.css", `body { background-color: #ffffff; }`)]
+      pass: [f3("app/globals.css", `body { background-color: #ffffff; }`)]
     }
   },
   {
@@ -1372,11 +2095,11 @@ const inter = Inter({ subsets: ["latin"] });`),
     detect: italicSerifHits,
     fixtures: {
       flag: [
-        f2("components/Hero.tsx", `<h1 className="font-display text-6xl">Nails, <em>reimagined</em></h1>`),
-        f2("components/Hero.tsx", `<span className="font-serif italic">reimagined</span>`),
-        f2("app/globals.css", `.hero h1 { font-style: italic; }`)
+        f3("components/Hero.tsx", `<h1 className="font-display text-6xl">Nails, <em>reimagined</em></h1>`),
+        f3("components/Hero.tsx", `<span className="font-serif italic">reimagined</span>`),
+        f3("app/globals.css", `.hero h1 { font-style: italic; }`)
       ],
-      pass: [f2("components/Hero.tsx", `<h1 className="font-display text-6xl">Nails in Brackley</h1>
+      pass: [f3("components/Hero.tsx", `<h1 className="font-display text-6xl">Nails in Brackley</h1>
 <p><em>Walk-ins</em> welcome.</p>`)]
     }
   },
@@ -1391,12 +2114,12 @@ const inter = Inter({ subsets: ["latin"] });`),
     detect: eyebrowChipHits,
     fixtures: {
       flag: [
-        f2("components/Hero.tsx", `<span className="inline-flex rounded-full border px-3 py-1 text-xs">Now booking</span>
+        f3("components/Hero.tsx", `<span className="inline-flex rounded-full border px-3 py-1 text-xs">Now booking</span>
 <h1>Nails in Brackley</h1>`),
-        f2("components/Hero.tsx", `<span className={cn("rounded-full px-3 text-xs", "bg-rose-500/10")}>New</span>
+        f3("components/Hero.tsx", `<span className={cn("rounded-full px-3 text-xs", "bg-rose-500/10")}>New</span>
 <h1>Nails</h1>`)
       ],
-      pass: [f2("components/Hero.tsx", `<h1>Nails in Brackley</h1>
+      pass: [f3("components/Hero.tsx", `<h1>Nails in Brackley</h1>
 <span className="inline-flex rounded-full border px-3 py-1 text-xs">Tag</span>`)]
     }
   },
@@ -1410,9 +2133,9 @@ const inter = Inter({ subsets: ["latin"] });`),
     fix: "Use the client's own marks, photography or numerals. If an icon earns its place, set it inline with the text.",
     detect: iconTileStackHits,
     fixtures: {
-      flag: [f2("components/Card.tsx", `import { Sparkles } from "lucide-react";
+      flag: [f3("components/Card.tsx", `import { Sparkles } from "lucide-react";
 <div className="flex size-10 items-center justify-center rounded-lg bg-violet-100"><Sparkles /></div>`)],
-      pass: [f2("components/Card.tsx", `import { Sparkles } from "lucide-react";
+      pass: [f3("components/Card.tsx", `import { Sparkles } from "lucide-react";
 <p className="flex items-center gap-2"><Sparkles className="size-4" />Aftercare</p>`)]
     }
   },
@@ -1426,8 +2149,8 @@ const inter = Inter({ subsets: ["latin"] });`),
     fix: "Lay content out by what it is. If one item matters most, give it the page, not a double-width tile.",
     detect: bentoHits,
     fixtures: {
-      flag: [f2("components/Features.tsx", `<div className="grid grid-cols-3"><div className="md:col-span-2 md:row-span-2" /><div /></div>`)],
-      pass: [f2("components/Features.tsx", `<div className="grid grid-cols-3"><div className="col-span-2" /><div /></div>`)]
+      flag: [f3("components/Features.tsx", `<div className="grid grid-cols-3"><div className="md:col-span-2 md:row-span-2" /><div /></div>`)],
+      pass: [f3("components/Features.tsx", `<div className="grid grid-cols-3"><div className="col-span-2" /><div /></div>`)]
     }
   },
   {
@@ -1441,10 +2164,10 @@ const inter = Inter({ subsets: ["latin"] });`),
     detect: glowHits,
     fixtures: {
       flag: [
-        f2("components/Hero.tsx", `<div className="absolute -top-20 left-1/2 h-96 w-96 rounded-full bg-rose-400/30 blur-3xl" />`),
-        f2("app/globals.css", `.hero { background: radial-gradient(circle at top, rgb(244 63 94 / .25), transparent 60%); }`)
+        f3("components/Hero.tsx", `<div className="absolute -top-20 left-1/2 h-96 w-96 rounded-full bg-rose-400/30 blur-3xl" />`),
+        f3("app/globals.css", `.hero { background: radial-gradient(circle at top, rgb(244 63 94 / .25), transparent 60%); }`)
       ],
-      pass: [f2("components/Hero.tsx", `<div className="absolute inset-0 bg-black/40" />`)]
+      pass: [f3("components/Hero.tsx", `<div className="absolute inset-0 bg-black/40" />`)]
     }
   },
   {
@@ -1458,13 +2181,13 @@ const inter = Inter({ subsets: ["latin"] });`),
     detect: gridBackgroundHits,
     fixtures: {
       flag: [
-        f2(
+        f3(
           "app/globals.css",
           `.hero { background-image: linear-gradient(to right, #e5e5e5 1px, transparent 1px), linear-gradient(to bottom, #e5e5e5 1px, transparent 1px); background-size: 24px 24px; }`
         ),
-        f2("components/Hero.tsx", `<div className="absolute inset-0 bg-[linear-gradient(to_right,#8882_1px,transparent_1px)] bg-[size:24px_24px]" />`)
+        f3("components/Hero.tsx", `<div className="absolute inset-0 bg-[linear-gradient(to_right,#8882_1px,transparent_1px)] bg-[size:24px_24px]" />`)
       ],
-      pass: [f2("app/globals.css", `.hero { background-image: url(/shopfront.avif); }`)]
+      pass: [f3("app/globals.css", `.hero { background-image: url(/shopfront.avif); }`)]
     }
   },
   {
@@ -1478,10 +2201,10 @@ const inter = Inter({ subsets: ["latin"] });`),
     detect: marqueeHits,
     fixtures: {
       flag: [
-        f2("app/globals.css", `@keyframes marquee { from { transform: translateX(0) } to { transform: translateX(-50%) } }`),
-        f2("components/Logos.tsx", `import Marquee from "react-fast-marquee";`)
+        f3("app/globals.css", `@keyframes marquee { from { transform: translateX(0) } to { transform: translateX(-50%) } }`),
+        f3("components/Logos.tsx", `import Marquee from "react-fast-marquee";`)
       ],
-      pass: [f2("app/globals.css", `@keyframes fade { from { opacity: 0 } to { opacity: 1 } }`)]
+      pass: [f3("app/globals.css", `@keyframes fade { from { opacity: 0 } to { opacity: 1 } }`)]
     }
   },
   {
@@ -1495,10 +2218,10 @@ const inter = Inter({ subsets: ["latin"] });`),
     detect: thinBorderWideShadowHits,
     fixtures: {
       flag: [
-        f2("components/Card.tsx", `<div className="rounded-2xl border border-black/5 bg-white shadow-2xl">`),
-        f2("app/globals.css", `.card { border: 1px solid rgb(0 0 0 / .06); box-shadow: 0 20px 48px rgb(0 0 0 / .08); }`)
+        f3("components/Card.tsx", `<div className="rounded-2xl border border-black/5 bg-white shadow-2xl">`),
+        f3("app/globals.css", `.card { border: 1px solid rgb(0 0 0 / .06); box-shadow: 0 20px 48px rgb(0 0 0 / .08); }`)
       ],
-      pass: [f2("components/Card.tsx", `<div className="rounded-sm border border-ink bg-white">`)]
+      pass: [f3("components/Card.tsx", `<div className="rounded-sm border border-ink bg-white">`)]
     }
   },
   {
@@ -1512,15 +2235,61 @@ const inter = Inter({ subsets: ["latin"] });`),
     detect: introHits,
     fixtures: {
       flag: [
-        f2("components/IntroCinematic.tsx", `const seen = sessionStorage.getItem("intro");
+        f3("components/IntroCinematic.tsx", `const seen = sessionStorage.getItem("intro");
 export function IntroCinematic() { return <AnimatePresence /> }`),
-        f2("app/page.tsx", `<><Preloader /><Hero /></>`)
+        f3("app/page.tsx", `<><Preloader /><Hero /></>`)
       ],
-      pass: [f2("components/Introduction.md", `An introduction to the studio.`)]
+      pass: [f3("components/Introduction.md", `An introduction to the studio.`)]
     }
   }
 ];
 
+// src/character/house.ts
+var HOUSE = {
+  "em-dash": { tier: "block", label: "em dash, use a full stop or a comma" },
+  emoji: { tier: "block", label: "emoji" },
+  "not-just-but": { tier: "block", label: "contrastive negation. The template is the tell, not the sentiment. Say the positive claim" },
+  "no-x-no-y": {
+    tier: "block",
+    label: '"No X, no Y" list. Defining the brand by what it is not, itemised, is the same template as contrastive negation'
+  },
+  "no-x-badge": { tier: "block", label: 'standalone "No X" badge. Reads as a slapped-on kicker, and worse when reused across pieces' },
+  "ai-phrase": { tier: "block", label: "AI tell" },
+  "plainer-word": { tier: "block", label: "a plainer word exists. Name the mechanism instead" },
+  "plain-english": { tier: "block", label: 'use "properly explained"' },
+  buzzword: { tier: "block", label: "forbidden phrase" },
+  "negative-reassurance": { tier: "block", label: "negative reassurance, say what they get" },
+  "review-phrase": { tier: "review", label: "review tier" },
+  "ai-vocabulary": { tier: "review", label: "AI vocabulary" },
+  "stock-phrase": { tier: "review", label: "stock phrase" },
+  "hollow-imperative": { tier: "review", label: "hollow imperative" },
+  "rhetorical-opener": { tier: "review", label: "rhetorical question opener" },
+  "staccato-triplet": { tier: "review", label: "staccato triplet" },
+  "where-x-meets-y": { tier: "review", label: "'where X meets Y'" },
+  "ing-tail": { tier: "review", label: "empty -ing tail" },
+  "vague-attribution": { tier: "review", label: "unnamed source" },
+  "closing-summary": { tier: "review", label: "closing summary" },
+  "false-range": { tier: "review", label: "false range" },
+  // The first candidate for block: evidence of a pasted chat reply, not a
+  // matter of style. Blocks once its estate hits have been read (ROADMAP.md).
+  "chatbot-residue": { tier: "review", label: "chatbot residue" },
+  "placeholder": { tier: "review", label: "unfilled placeholder" },
+  "question-reveal": { tier: "review", label: "staged reveal" },
+  "inline-label-list": { tier: "review", label: "bold-label bullets" },
+  "phrase-density": { tier: "review", label: "density" },
+  "aphorism-density": { tier: "review", label: "density" },
+  "contraction-scarcity": { tier: "review", label: "density" },
+  "sentence-rhythm": { tier: "review", label: "density" },
+  "repeated-sentence": { tier: "review", label: "repetition" },
+  "heading-shape": { tier: "review", label: "headings" },
+  "heading-echo": { tier: "review", label: "headings" },
+  // Banned only "when vague", per the rules. Too noisy for a sweep.
+  "vague-word": { tier: "explicit", label: "vague" }
+};
+function houseRule(id, name = id) {
+  return HOUSE[id] ?? { tier: "review", label: name };
+}
+
 // src/character/parse.ts
 function lineAt(text, offset) {
   let line = 1;
@@ -1669,8 +2438,8 @@ var oklchOf = (value) => parseColour(value)?.oklch ?? null;
 function reflexFonts(list) {
   const wanted = new Map(list.map((n) => [n.toLowerCase(), n]));
   return (s) => {
-    const total = s.fonts.reduce((n, f3) => n + f3.chars, 0) || 1;
-    const display = s.fonts.reduce((n, f3) => n + f3.displayChars, 0) || 1;
+    const total = s.fonts.reduce((n, f4) => n + f4.chars, 0) || 1;
+    const display = s.fonts.reduce((n, f4) => n + f4.displayChars, 0) || 1;
     const hits = [];
     const seen = /* @__PURE__ */ new Set();
     const h1 = s.headings.find((h) => h.level === 1);
@@ -1871,8 +2640,8 @@ var RENDERED_PATHS = {
 };
 
 // src/character/check.ts
-var CATALOGUE_VERSION = "2026.09.3";
-var CATALOGUE = [...SOURCE_TELLS, ...COPY_TELLS].map(
+var CATALOGUE_VERSION = "2026.09.6";
+var CATALOGUE = [...SOURCE_TELLS, ...COPY_TELLS, ...RESEARCH_TELLS, ...DENSITY_TELLS].map(
   (t) => RENDERED_PATHS[t.id] ? { ...t, rendered: RENDERED_PATHS[t.id] } : t
 );
 function tellById(id) {
@@ -1907,7 +2676,8 @@ function toFinding(tell, hit2, texts) {
     line: texts.has(hit2.path) ? lineAt(text, hit2.offset) : 0,
     excerpt: hit2.excerpt ?? excerptAt(text, hit2.offset),
     message: hit2.message,
-    fix: tell.fix
+    fix: tell.fix,
+    ...tell.surface === "copy" ? { house: houseRule(tell.id, tell.name).tier } : {}
   };
 }
 function report(tells, files, run, options) {
@@ -2086,14 +2856,14 @@ function collectInPage() {
       t.chars += chars;
       text.set(cs.color, t);
       const family = firstFamily(cs.fontFamily);
-      const f3 = fonts.get(family) ?? { chars: 0, displayChars: 0, italicChars: 0, weights: /* @__PURE__ */ new Set() };
+      const f4 = fonts.get(family) ?? { chars: 0, displayChars: 0, italicChars: 0, weights: /* @__PURE__ */ new Set() };
       const size = px(cs.fontSize);
       const weight = parseInt(cs.fontWeight, 10) || 400;
-      f3.chars += chars;
-      if (/^H[1-3]$/.test(el.tagName) || size >= 28) f3.displayChars += chars;
-      if (cs.fontStyle === "italic" || cs.fontStyle.startsWith("oblique")) f3.italicChars += chars;
-      f3.weights.add(weight);
-      fonts.set(family, f3);
+      f4.chars += chars;
+      if (/^H[1-3]$/.test(el.tagName) || size >= 28) f4.displayChars += chars;
+      if (cs.fontStyle === "italic" || cs.fontStyle.startsWith("oblique")) f4.italicChars += chars;
+      f4.weights.add(weight);
+      fonts.set(family, f4);
       sizes.add(Math.round(size));
       weights.add(weight);
     }
@@ -2109,7 +2879,7 @@ function collectInPage() {
   const htmlBg = getComputedStyle(document.documentElement).backgroundColor;
   const bodyBg = getComputedStyle(document.body).backgroundColor;
   const ground = painted(bodyBg) ? bodyBg : painted(htmlBg) ? htmlBg : "rgb(255, 255, 255)";
-  const headings = Array.from(document.querySelectorAll("h1, h2, h3")).filter(shown).slice(0, 60).map((h) => {
+  const headings2 = Array.from(document.querySelectorAll("h1, h2, h3")).filter(shown).slice(0, 60).map((h) => {
     const cs = style(h);
     const italic = cs.fontStyle !== "normal";
     const italicPart = !italic && Array.from(h.querySelectorAll("*")).some((c) => style(c).fontStyle !== "normal" && (c.textContent ?? "").trim().length > 0);
@@ -2325,8 +3095,8 @@ function collectInPage() {
     pageHeight: document.documentElement.scrollHeight,
     ground,
     colours: { backgrounds: toList(bg).slice(0, 60), text: toList(text).sort((a, b) => b.chars - a.chars).slice(0, 40) },
-    fonts: Array.from(fonts, ([family, f3]) => ({ family, chars: f3.chars, displayChars: f3.displayChars, italicChars: f3.italicChars, weights: nums(f3.weights) })).sort((a, b) => b.chars - a.chars),
-    headings,
+    fonts: Array.from(fonts, ([family, f4]) => ({ family, chars: f4.chars, displayChars: f4.displayChars, italicChars: f4.italicChars, weights: nums(f4.weights) })).sort((a, b) => b.chars - a.chars),
+    headings: headings2,
     controls,
     sections,
     effects,