@domandigital/craft 0.22.0 → 0.23.0

package/dist/audit.js

@@ -193,7 +193,17 @@ var REVIEW_PHRASES = [
   "by far the most",
   "hands down the",
   "arguably the best",
-  "bar none"
+  "bar none",
+  // "plain" as a self-description, the way "clear" is: say what the reader gets.
+  "plain answer",
+  "plain answers",
+  "plain recommendation",
+  "plain explanation",
+  "plain explanations",
+  "plain advice",
+  "plain guidance",
+  "plain-speaking",
+  "plain speaking"
 ];
 var SALES_TAGLINES = [
   /\bwhere it (?:really |truly )?(?:counts|matters)(?: most)?\b/i,
@@ -249,6 +259,34 @@ var CLIPPED = [
   // "Alright Carlo, built you a proper site": the "I" left out
   /(?<=^|[\n>"“]|[.!?—–-]\s*|,\s+)(?:[Bb]uilt|[Mm]ade|[Pp]ut together|[Kk]nocked up)\s+(?:you|your\s+\w+|the\s+\w+)\s+an?\b/
 ];
+var PLAIN_FAMILY = [
+  /\b(?:plain english|explained plainly|plainly explained)\b/i,
+  /\bplainly\b(?!\s+marked\b)/i,
+  /\bin\s+plain\s+(?:terms|language|words|speak)\b/i
+];
+var CONFESSION = [
+  // "What this is and is not:", "what we are and aren't"
+  /\bwhat\s+(?:this|it|we|our\s+\w+)\s+(?:is|are)\s+and\s+(?:is\s+not|isn['’]t|are\s+not|aren['’]t)\b/i,
+  // "What we are not", a label on its own; not "what we are not responsible for"
+  /(?<!\band\s)\bwhat\s+we(?:\s+are|['’]re)\s+not\b(?!\s+(?:responsible|liable|able|allowed|sure)\b)/i,
+  /\bwhat\s+we\s+(?:don['’]t|do\s+not)\s+do\b/i,
+  // "We have not yet built and run", "we haven't yet worked with"
+  /\bwe(?:\s+have|['’]ve)\s+not\s+yet\s+(?:built|run|done|worked|delivered|shipped|launched)\b/i,
+  /\bwe\s+haven['’]t\s+(?:yet\s+)?(?:built|run|done|worked\s+with|delivered)\b/i,
+  /\bwhat\s+we\s+have\s+and\s+(?:haven['’]t|have\s+not)\s+(?:done|built|run)\b/i,
+  // "Our clinic experience so far is one practice"
+  /\bour\s+(?:[\w-]+\s+){0,3}experience\s+so\s+far\s+(?:is|has\s+been|covers)\b/i,
+  /\bso\s+far\s+(?:is|has\s+been)\s+(?:one|a\s+single|just\s+one)\b/i,
+  /\bwhere\s+our\s+experience\s+(?:applies|ends|stops|runs\s+out)\b/i,
+  /\bwhat\s+we\s+(?:would|['’]d|will|still)\s+need\s+to\s+learn\b/i,
+  // "what we would and wouldn't take on", "what we won't take on"
+  /\b(?:would|will)\s+and\s+(?:wouldn['’]t|would\s+not|won['’]t|will\s+not)\s+take\s+on\b/i,
+  /\bwhat\s+we\s+(?:won['’]t|wouldn['’]t|would\s+not|will\s+not)\s+take\s+on\b/i,
+  // "Who we don't work with", "who this is not for", "we're not for everyone"
+  /\bwho\s+we\s+(?:don['’]t|do\s+not|won['’]t|will\s+not)\s+(?:work\s+with|serve|help|take\s+on)\b/i,
+  /\bwho\s+(?:this|it|we)\s+(?:is|are|['’]re)\s+not\s+for\b|\bwho\s+(?:this|it)\s+isn['’]t\s+for\b/i,
+  /\b(?:we|this)\s+(?:are|is|['’]re|['’]s)\s+not\s+(?:for\s+everyone|the\s+right\s+fit\s+for)\b/i
+];
 var NEGATION = [
   // "It's not just a haircut, it's an experience."
   /\b(?:it['’]?s|it is|this is|this isn['’]t|we['’]re|we are|they['’]re)\s+(?:not|more than)\s+(?:just|only|merely|simply)?\s*[^.!?\n]{1,60}?[,;.—-]\s*(?:it['’]?s|it is|this is|we['’]re|we are|they['’]re)\b/i,
@@ -262,8 +300,33 @@ var NEGATION = [
   /\b(?:is|are|was|were)(?:n’t|n't)\b[^.;]{2,60},\s*(?:it|they|that|this)(?:’s|'s|’re|'re)\b/i,
   /\bless\s+about\b[^.;]{2,50}\bmore\s+about\b/i,
   // parallel participle, no repeated subject: "dispatched from here, not shipped in from Seoul"
-  /\b\w{3,}ed\b[^,.;:]{0,40},\s*not\s+\w{3,}ed\b/i
+  /\b\w{3,}ed\b[^,.;:]{0,40},\s*not\s+\w{3,}ed\b/i,
+  // parallel gerund: "renting Microsoft's services, not running servers". The
+  // -thing pronouns and the -ing prepositions are not verbs.
+  /\b(?!(?:some|no|any|every)thing\b)\w{3,}ing\b[^,.;:]{0,40},\s*not\s+(?!(?:some|no|any|every)thing\b|(?:during|according|including|regarding|morning|evening)\b)\w{3,}ing\b/i
+];
+var SOFT_CONTRAST = [
+  // ", not registration." closing the sentence. Not when "not" negates what follows.
+  /,\s*not\s+(?!(?:yet|least|only|just|merely|simply|to|all|always|even|ever|necessarily|really|quite|exactly|enough|sure|that|because|so|much|many|once|often|every|including|counting|unlike|until|if|when|unless|though|although|or|and|but)\b)(?:(?:a|an|the|your|our|their|its|his|her|my|any)\s+)?[\w'’-]+(?:\s+[\w'’-]+){0,3}(?=\s*(?:[.!?)"”]|$))/im,
+  // "the league's own threshold, not a legal one"
+  /,\s*not\s+(?:a|an|the)\s+(?:[\w'’-]+\s+)?one\b/i,
+  // "renting computing over the internet instead of owning it"
+  /\b(?!(?:some|no|any|every)thing\b)\w{3,}ing\b[^.;:!?]{0,60}?\binstead\s+of\s+(?!(?:some|no|any|every)thing\b)\w{3,}ing\b/i
 ];
+var PAIR_TOKEN = String.raw`(?:[£$€]?\d[\d,.]*%?|[\w'’£$€-]+)`;
+var PAIR_NUMBER = String.raw`(?:one|two|three|four|five|six|seven|eight|nine|ten|eleven|twelve|\d[\d,]*)`;
+var PARALLEL_PAIR = [
+  // anaphora: "same site, same £8,000", "per user, per month". "No X, no Y" is no-x-no-y's.
+  new RegExp(String.raw`\b(?!no\b)(\w+)[ \t]+${PAIR_TOKEN},[ \t]+\1[ \t]+${PAIR_TOKEN}(?=[ \t]*(?:[.!?]|$))`, "im"),
+  // isocolon on its own line: "One form, seven workflows"
+  new RegExp(String.raw`^[ \t]*(?:#{1,6}[ \t]+)?${PAIR_NUMBER}[ \t]+[\w'’-]+,[ \t]+${PAIR_NUMBER}[ \t]+[\w'’-]+[.!]?[ \t]*$`, "im"),
+  // a verbless list as a tagline: "Service account, match-day reminders, analytics."
+  /^[ \t]*(?:#{1,6}[ \t]+)?[A-Z][\w'’-]*(?:[ \t]+(?!(?:and|or)\b)[\w'’-]+){0,2}(?:,[ \t]+(?!(?:and|or)\b)[\w'’-]+(?:[ \t]+(?!(?:and|or)\b)[\w'’-]+){0,2}){2,3}\.[ \t]*$/m
+];
+var alreadyBlocked = (block, match, index) => {
+  const sentence = block.text.slice(Math.max(0, index - 80), index + match.length);
+  return NEGATION.some((pattern) => pattern.test(sentence));
+};
 var DATA_ABSENCE = /\b(?:yet|found|available|configured|selected|assigned|scheduled|recorded|on file|to show|to display|results|match|matches|matching|data|in this period)\b/i;
 var SIGNED_IN = /(?:^|\/)(?:admin|portal|dashboard|embedded)\//;
 function lineAround(text, index) {
@@ -378,12 +441,25 @@ var COPY_TELLS = [
     generation: 2,
     severity: "warn",
     surface: "copy",
-    why: "Told to avoid jargon, a model announces that it is avoiding jargon. 'Explained plainly' swaps a synonym and keeps the tell.",
-    fix: "Use the house replacement, 'properly explained', or drop the claim and let the copy show it.",
-    detect: phrases([/\b(?:plain english|explained plainly|plainly explained)\b/i], quoted),
+    why: "Told to avoid jargon, a model announces that it is avoiding jargon: 'in plain English', 'stated plainly', 'we'll tell you plainly', 'in plain terms'. The founder bans the whole family (20 October 2026); a reader takes it as filler.",
+    fix: "Drop the adverb and say the thing: 'Our prices, stated plainly' becomes 'Our prices'. Where the claim matters, the house replacement for 'plain English' is 'properly explained'.",
+    detect: phrases(PLAIN_FAMILY, quoted),
     fixtures: {
-      flag: [f("content/home.md", "Your options, in plain English.")],
-      pass: [f("content/home.md", "Your options, properly explained.")]
+      flag: [
+        f("content/home.md", "Your options, in plain English."),
+        // Eunice Ordor's draft lines, Pastel 986559 #12 and #13 (her diagnosis taken, her wording not).
+        f("content/clinics.md", "Tell us what's happening and we'll say plainly what we would take on."),
+        f("content/pricing.md", "DD's payment terms, plainly stated."),
+        f("content/clinics.md", "We explain our findings in plain terms."),
+        f("content/clinics.md", "We share findings in plain language.")
+      ],
+      pass: [
+        f("content/home.md", "Your options, properly explained."),
+        f("content/pricing.md", "Our payment terms: 30% when you sign, the rest at launch."),
+        // The Apache and zlib licence wording, copied into a repo as it is.
+        f("LICENSE.txt", "Altered source versions must be plainly marked as such."),
+        f("content/menu.md", "Plain or seeded bagels, and plain-language allergen notes.")
+      ]
     }
   },
   {
@@ -434,11 +510,11 @@ var COPY_TELLS = [
     generation: 1,
     severity: "warn",
     surface: "copy",
-    why: "Truly, genuinely, clear, ultimately, 'the single most', 'bar none': normal English once, and a tell when they stack. The house rules keep them for review, never blocking.",
+    why: "Truly, genuinely, clear, ultimately, 'a plain recommendation', 'the single most', 'bar none': normal English once, and a tell when they stack. The house rules keep them for review, never blocking.",
     fix: "Keep the one that lands hardest and cut the rest. 'What is genuinely excellent' reads better as 'what is excellent'.",
     detect: phrases([new RegExp(`(?:^|\\b)(?:${[...REVIEW_PHRASES].sort((a, b) => b.length - a.length).map((p) => escape(p).replace(/^(\w)/, "\\b$1").replace(/(\w)$/, "$1\\b")).join("|")})`, "i")], quoted),
     fixtures: {
-      flag: [f("content/home.md", "We are truly proud of it."), f("content/home.md", "You leave with a clear next step.")],
+      flag: [f("content/home.md", "We are truly proud of it."), f("content/home.md", "You leave with a clear next step."), f("content/process.md", "You get a plain recommendation and someone who knows your systems.")],
       pass: [f("content/home.md", "We have fitted 400 boilers since 2009."), f("content/home.md", "Keep a safe clearance around the meter.")]
     }
   },
@@ -519,6 +595,40 @@ var COPY_TELLS = [
       ]
     }
   },
+  {
+    id: "confession-line",
+    name: "Confession line",
+    generation: 2,
+    severity: "warn",
+    surface: "copy",
+    why: "'What this is and is not', 'we have not yet built', 'our experience so far is one practice', 'what we would and wouldn't take on': a model scopes a business by confessing its limits. It reads as small print, and it turns a buyer away before they make contact.",
+    fix: "Scope by being precise about what is true, and leave the door open: 'Built and run by us for Sensphere, a practice whose clinicians work across several sites.' Keep contractual facts (eligibility, who runs what) and say them as what the buyer gets.",
+    detect: phrases(CONFESSION, quoted),
+    fixtures: {
+      flag: [
+        // Each one from the DD site, as Eunice Ordor flagged it (Pastel 986559 #8, #12, #13).
+        f("content/clinics.md", "What this is and is not: a practice portal we built and run for one practice."),
+        f("content/clinics.md", "We have not yet built and run the digital systems of a practice with several clinicians."),
+        f("content/home.md", "Including the client portal we run for Sensphere. Our clinic experience so far is one practice."),
+        f("content/clinics.md", "Tell us what's happening and we'll say what we would and wouldn't take on."),
+        f("content/clinics.md", "We will say what carries over from this work and what we would need to learn first."),
+        f("content/clinics.md", "We will tell you where our experience applies directly and where it is close."),
+        f("content/about.md", "What we are not"),
+        f("content/about.md", "Who we don't work with: anyone who needs a site this week."),
+        f("content/mobile.md", "Mobile is our newest line, so we tell you what we have and haven't done.")
+      ],
+      pass: [
+        f("content/clinics.md", "Built and run by us for Sensphere, a growing practice whose clinicians work remotely."),
+        f("content/home.md", "The client portal we run for Sensphere."),
+        // Contractual facts, said as they are.
+        f("content/pricing.md", "Pay monthly is open to UK residents aged 18 and over, subject to status."),
+        f("content/pricing.md", "Your monthly payments do not buy the site; the buy-out price does."),
+        f("content/terms.md", "What we are responsible for, and what we are not responsible for, is in clause 4."),
+        f("content/insurance.md", "Ask what your policy does and does not cover."),
+        f("emails/deposit.md", "We have not yet received your deposit, so the date is still open.")
+      ]
+    }
+  },
   {
     id: "hollow-imperative",
     name: "Hollow imperative",
@@ -597,7 +707,7 @@ var COPY_TELLS = [
     generation: 2,
     severity: "warn",
     surface: "copy",
-    why: "'It's not just a haircut, it's an experience', 'dispatched from here, not shipped in': the contrast-and-reveal template is the most recognisable construction in generated copy.",
+    why: "'It's not just a haircut, it's an experience', 'dispatched from here, not shipped in': the contrast-and-reveal template (correctio, antithesis: see COPY.md) is the most recognisable construction in generated copy.",
     fix: "Say the positive claim and drop the contrast.",
     detect: phrases(NEGATION, quoted, allText),
     fixtures: {
@@ -608,12 +718,54 @@ var COPY_TELLS = [
         f("content/home.md", "Hairdressing isn't a job, it's art."),
         f("content/home.md", "It is less about the tools and more about the eye."),
         f("content/home.md", "Order today and it's dispatched from here, not shipped in from Seoul."),
-        f("app/offer.tsx", `export const outcome = "The whole path, not just the ads.";`)
+        f("app/offer.tsx", `export const outcome = "The whole path, not just the ads.";`),
+        // From a 92EL report that passed the gate, October 2026.
+        f("content/report.md", "These are reported, not assumed to pass."),
+        f("content/report.md", "The deletion is proposed, not automated."),
+        f("content/report.md", "For 92EL, that means renting Microsoft's services, not running servers."),
+        f("content/home.md", "Your team should spend time delivering services, not managing bookings.")
       ],
       pass: [
         f("content/home.md", "A haircut, a hot towel and a straight-razor finish."),
         f("content/home.md", "They are cosmetics, not medicines."),
-        f("content/home.md", "The box arrived red, not led astray by a dented corner.")
+        f("content/home.md", "The box arrived red, not led astray by a dented corner."),
+        f("content/home.md", "We fix boilers in the morning, not in the evening."),
+        f("content/report.md", "Players never open the lists."),
+        f("content/report.md", "It is not tested at national scale."),
+        f("content/report.md", "Do not invent anything."),
+        f("content/report.md", "Nothing is copied by hand."),
+        f("content/report.md", "Results are checked by a person and not yet automated.")
+      ]
+    }
+  },
+  {
+    id: "trailing-contrast",
+    name: "Trailing contrast",
+    generation: 2,
+    severity: "warn",
+    surface: "copy",
+    why: "'Edge matters for game servers, not registration', 'the league's own threshold, not a legal one', 'renting computing instead of owning it': the contrast template (correctio, antithesis: see COPY.md) in its softer forms. A genuine disclaimer has the same shape, so a person decides.",
+    fix: "Say the positive claim on its own: 'Edge matters for game servers.' Keep the contrast only where the reader would otherwise assume the other thing, such as a legal disclaimer.",
+    detect: phrases(SOFT_CONTRAST, quoted, allText, alreadyBlocked),
+    fixtures: {
+      flag: [
+        // From a 92EL report that passed the gate, October 2026.
+        f("content/report.md", "Edge matters for game servers, not registration."),
+        f("content/report.md", "Age 18 is the league's own threshold, not a legal one."),
+        f("content/report.md", "Cloud computing means renting computing over the internet instead of owning it."),
+        f("content/home.md", "Real Square data, not a vanity metric.")
+      ],
+      pass: [
+        f("content/home.md", "Rewire, retile and replumb a bathroom in five days."),
+        f("content/report.md", "Players never open the lists."),
+        f("content/report.md", "It is not tested at national scale."),
+        f("content/report.md", "Do not invent anything."),
+        f("content/report.md", "Nothing is copied by hand."),
+        f("content/report.md", "Results are checked by a person and not yet automated."),
+        f("content/home.md", "Pay by card, not to mention Apple Pay."),
+        f("content/home.md", "Card instead of cash is fine."),
+        // The blocking rule reports this one; it is not reported twice.
+        f("content/report.md", "The deletion is proposed, not automated.")
       ]
     }
   },
@@ -663,7 +815,7 @@ var COPY_TELLS = [
     generation: 2,
     severity: "warn",
     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.",
+    why: "Three fragments in a row ('Fast. Friendly. Local.' or 'No fuss. No jargon. Just results.') (a tricolon in asyndeton: see COPY.md) is the second wave's favourite rhythm.",
     fix: "Write one sentence that says which of the three is true, and how you know.",
     // 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),
@@ -675,6 +827,36 @@ var COPY_TELLS = [
       ]
     }
   },
+  {
+    id: "parallel-pair",
+    name: "Verbless parallel pair",
+    generation: 2,
+    severity: "warn",
+    surface: "copy",
+    why: "'One form, seven workflows', 'Same site, same \xA38,000': two matched fragments with no verb (isocolon, often with anaphora or asyndeton: see COPY.md), the staccato triplet's two-part cousin. It sounds decided and says less than a sentence would.",
+    fix: "Write the sentence the pair stands for: 'One form and seven workflows replace the spreadsheets.' A short label on a slide can stay if a person reads it and it earns its place.",
+    detect: phrases(PARALLEL_PAIR, quoted),
+    fixtures: {
+      flag: [
+        // From 92EL deliverables, October 2026.
+        f("content/deck.md", "# One form, seven workflows"),
+        f("content/deck.md", "One form, seven workflows."),
+        f("content/deck.md", "Same site, same \xA38,000."),
+        f("content/deck.md", "Pay per user, per month"),
+        f("content/deck.md", "Service account, match-day reminders, analytics.")
+      ],
+      pass: [
+        f("content/deck.md", "Forms, SharePoint, Outlook and Teams"),
+        f("content/deck.md", "One form and seven workflows replace 92EL's spreadsheets and email chains."),
+        f("content/deck.md", "PulseCloud Technologies, for 92EL senior management"),
+        f("content/deck.md", "41 of 50 passed, 12 after a fix."),
+        f("content/deck.md", "Pay monthly for each user"),
+        f("content/home.md", "We fix boilers the same day, and we tell you the price before we start."),
+        // The blocking no-x-no-y reports this one.
+        f("content/home.md", "We reply within a day. No obligation, no spam.")
+      ]
+    }
+  },
   {
     id: "where-x-meets-y",
     name: "'Where X meets Y'",
@@ -1920,6 +2102,69 @@ function eyebrowChipHits(ctx) {
   }
   return hits;
 }
+var HERO_OPEN = /<(section|header|div|main|article|Section|Container)\b[^>]*?\b(?:class|className|id)\s*=\s*(?:"|'|\{\s*[`"']?)[^"'`>]*?(?<![a-z])hero(?![a-z])[^>]*>/gi;
+function closeOf(text, tag, from) {
+  const re = new RegExp(`<(/?)${tag}\\b[^>]*?(/?)>`, "g");
+  re.lastIndex = from;
+  let depth = 0;
+  for (let m = re.exec(text); m; m = re.exec(text)) {
+    if (m[2] === "/") continue;
+    depth += m[1] === "/" ? -1 : 1;
+    if (depth === 0) return m.index + m[0].length;
+    if (m.index - from > 8e3) break;
+  }
+  return Math.min(text.length, from + 4e3);
+}
+function heroSpans(path, text) {
+  if (/(?:^|[\\/])[\w-]*hero[\w-]*\.(?:astro|tsx|jsx|vue|svelte)$/i.test(path)) return [[0, text.length]];
+  const spans = [];
+  for (const m of text.matchAll(HERO_OPEN)) {
+    const at = m.index ?? 0;
+    if (spans.some(([a, b]) => at >= a && at < b)) continue;
+    spans.push([at, closeOf(text, m[1], at)]);
+  }
+  if (spans.length > 0) return spans;
+  const h1 = text.search(/<h1\b/);
+  if (h1 === -1) return [];
+  const rest = text.slice(h1);
+  const end = rest.search(/<\/(?:section|header)>|<section\b/);
+  return [[h1, h1 + Math.min(end === -1 ? rest.length : end, 1500)]];
+}
+var CONTROL = /<(a|button|Button|ButtonLink|LinkButton|Link|Cta|CTA|CallToAction)\b([^>]*)>([\s\S]{0,300}?)<\/\1>/g;
+var BUTTON_COMPONENT = /^(?:Button|ButtonLink|LinkButton|Cta|CTA|CallToAction)$/;
+var BUTTON_CLASS = /(?<![a-z])(?:btn|button|cta)(?![a-z])/i;
+var TOGGLE = /\baria-(?:expanded|controls|haspopup)\b|\btype\s*=\s*["']submit["']/;
+var NOT_A_LANDING = /(?:^|[\\/])(?:error|global-error|not-found|404|500)\.\w+$|[\\/](?:admin|portal|dashboard|account|\(qa\)|\(app\)|qa)[\\/]/i;
+function buttonLabel(attrs, inner) {
+  const text = inner.replace(/<[^>]*>/g, " ").replace(/\{[^}]*\}/g, " ").replace(/\s+/g, " ").trim();
+  if (text && !/[{}()=]/.test(text)) return text.slice(0, 40);
+  return attrs.match(/\bhref\s*=\s*["'{`$]*\{?([^"'}`\s]+)/)?.[1] ?? "a button";
+}
+function heroCtaPairHits(ctx) {
+  const hits = [];
+  for (const file of ctx.files) {
+    if (file.kind !== "markup" || NOT_A_LANDING.test(file.path)) continue;
+    const text = file.text.replace(/\\"/g, ' "');
+    for (const [start, end] of heroSpans(file.path, text)) {
+      const span = text.slice(start, end).replace(/<(nav|form)\b[\s\S]*?<\/\1>/gi, (s) => " ".repeat(s.length));
+      const buttons = [];
+      for (const m of span.matchAll(CONTROL)) {
+        const [, tag, attrs, inner] = m;
+        if (TOGGLE.test(attrs)) continue;
+        const cls = attrs.match(/\b(?:class|className|variant)\s*=\s*(?:"([^"]*)"|'([^']*)'|\{([^}]*)\})/g)?.join(" ") ?? "";
+        const tw = /\bpx-\d/.test(cls) && /\bpy-\d/.test(cls) && /\b(?:bg-|border\b|border-|rounded)/.test(cls);
+        if (BUTTON_COMPONENT.test(tag) || BUTTON_CLASS.test(cls) || tw || /\brole\s*=\s*["']button["']/.test(attrs)) {
+          buttons.push({ label: buttonLabel(attrs, inner), offset: start + (m.index ?? 0) });
+        }
+      }
+      if (buttons.length >= 2) {
+        const names = buttons.slice(0, 3).map((b) => `"${b.label}"`).join(", ");
+        hits.push({ path: file.path, offset: buttons[1].offset, message: `${buttons.length} buttons side by side in the hero: ${names}` });
+      }
+    }
+  }
+  return hits;
+}
 function iconTiles(file) {
   return file.classUnits.filter((unit) => {
     const sized = has(unit, /^size-(?:8|9|10|11|12|14)$/) || (find(unit, /^h-(?:8|9|10|11|12|14)$/) ?? "x").slice(2) === (find(unit, /^w-(?:8|9|10|11|12|14)$/) ?? "y").slice(2);
@@ -2370,6 +2615,75 @@ const inter = Inter({ subsets: ["latin"] });`),
 <span className="inline-flex rounded-full border px-3 py-1 text-xs">Tag</span>`)]
     }
   },
+  {
+    id: "hero-cta-pair",
+    name: "Two buttons in the hero",
+    generation: 1,
+    severity: "warn",
+    surface: "source",
+    why: "A filled button beside an outline or ghost one ('Get a free quote' / 'See our plans') is in 140 of 140 heroes Claude builds for a brief. Two equal asks make the visitor choose before they know anything, and say nobody decided what the page is for.",
+    fix: "Keep one button, the ask the page exists for. Put the second route in the copy as a text link ('or see the work first'), or lower down where it answers a question.",
+    detect: heroCtaPairHits,
+    fixtures: {
+      flag: [
+        // Eunice Ordor's #5 and #36 (Pastel 986559): the DD site's own hero and process close.
+        f3(
+          "src/components/Hero.astro",
+          `<section class="hero">
+  <h1>We run the systems behind your website</h1>
+  <a href="/contact" class="btn btn-primary">Get in touch</a>
+  <a href="/work" class="btn btn-ghost">See our work</a>
+</section>`
+        ),
+        // The null build's hero, verbatim in shape (calibration/null/rmp/pages/05.html).
+        f3(
+          "index.html",
+          `<nav><a class="btn" href="#contact">Quote</a></nav>
+<section id="hero" class="hero">
+  <h1>Electricians in Uxbridge</h1>
+  <a href="#contact" class="btn btn-primary">Book a Free Quote</a>
+  <a href="tel:+441895555210" class="btn btn-outline">Call 01895 555 210</a>
+</section>`
+        ),
+        f3(
+          "app/page.tsx",
+          `<section className="relative py-24">
+  <h1 className="text-5xl">Nails in Brackley</h1>
+  <div className="flex gap-4">
+    <Button asChild><a href="/book">Book now</a></Button>
+    <Button variant="outline">View treatments</Button>
+  </div>
+</section>`
+        )
+      ],
+      pass: [
+        // One button, and the second route as a text link in the sentence.
+        f3(
+          "src/components/Hero.astro",
+          `<section class="hero">
+  <h1>We run the systems behind your website</h1>
+  <p>Tell us what's going on, or <a href="/work">see the work first</a>.</p>
+  <a href="/contact" class="btn btn-primary">Get in touch</a>
+</section>`
+        ),
+        // A button in the nav and a search form are not the hero's ask.
+        f3(
+          "index.html",
+          `<header class="hero">
+  <nav><a class="btn" href="/book">Book</a></nav>
+  <h1>Barbers in Manchester</h1>
+  <a class="btn" href="/book">Book a cut</a>
+  <form><button class="btn" type="submit">Search</button></form>
+</header>`
+        ),
+        f3("app/page.tsx", `<section className="py-24">
+  <h1 className="text-5xl">Nails in Brackley</h1>
+  <a className="rounded bg-ink px-5 py-3" href="/book">Book now</a>
+</section>
+<section><a className="rounded bg-ink px-5 py-3" href="/prices">Prices</a></section>`)
+      ]
+    }
+  },
   {
     id: "icon-tile-stack",
     name: "Icon in a tinted tile",
@@ -3123,7 +3437,9 @@ var HOUSE = {
   "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"' },
+  // Widened 2026-10-20 (founder) to bare "plainly" and "in plain terms/language/words";
+  // estate hits read first (DOM-1058), nearly all the stock "stated plainly".
+  "plain-english": { tier: "block", label: 'the plain-English family. Drop the adverb and say the thing, or use "properly explained"' },
   buzzword: { tier: "block", label: "forbidden phrase" },
   "negative-reassurance": { tier: "block", label: "negative reassurance, say what they get" },
   // Evidence of a pasted chat reply, not a matter of style. Moved from review
@@ -3137,6 +3453,13 @@ var HOUSE = {
   "stock-email-line": { tier: "review", label: "stock email line, start with the reason for writing and end with the next step" },
   // New 2026-10-19 (founder): review first, like every new tell, until estate hits are read.
   "matey-register": { tier: "review", label: "matey register, write plain and complete British English" },
+  // New 2026-10-20 (founder, from Eunice Ordor's review): review first, like every new tell.
+  "confession-line": { tier: "review", label: "confession line, scope the work by saying precisely what is true" },
+  // New 2026-10-23 (a 92EL report passed the gate with three): review, because a
+  // genuine disclaimer has the same shape. The gerund pair joined not-just-but.
+  // New 2026-10-23 (founder, from 92EL deliverables): review, since a short slide label is often fine.
+  "parallel-pair": { tier: "review", label: "verbless parallel pair, write the sentence it stands for" },
+  "trailing-contrast": { tier: "review", label: "trailing contrast. Say the positive claim, unless it is a disclaimer the reader needs" },
   "ai-vocabulary": { tier: "review", label: "AI vocabulary" },
   "stock-phrase": { tier: "review", label: "stock phrase" },
   "hollow-imperative": { tier: "review", label: "hollow imperative" },
@@ -3362,6 +3685,33 @@ var RENDERED_PATHS = {
     detect: (s) => s.effects.eyebrowChip ? [hit(s, "a small bordered pill sits above the headline")] : [],
     fixtures: { flag: [makeSnapshot({ effects: { eyebrowChip: true } })], pass: [makeSnapshot()] }
   },
+  "hero-cta-pair": {
+    // Version 2 geometry counts buttons and button-styled links per section. A
+    // header painted inside the hero's box adds its own button, which the
+    // source path can tell apart and this one cannot; a ghost button with no
+    // fill or border is not counted, so this path under-reports.
+    detect: (s) => {
+      const first = s.sections[0];
+      const controls = first?.geometry?.controls ?? 0;
+      return first && (first.role ?? first.kind) === "hero" && controls >= 2 ? [hit(s, `${controls} buttons in the hero`, first.label)] : [];
+    },
+    fixtures: {
+      flag: [
+        {
+          ...makeSnapshot(),
+          sections: makeSnapshot().sections.map((x, i) => i === 0 ? { ...x, role: "hero", geometry: { centredShare: 0.2, mirrorSymmetry: 0.6, whitespaceRatio: 0.6, contentWidthRatio: 0.8, background: "rgb(255, 255, 255)", controls: 2 } } : x)
+        }
+      ],
+      pass: [
+        makeSnapshot(),
+        // One button, with the second route as a text link: one control.
+        {
+          ...makeSnapshot(),
+          sections: makeSnapshot().sections.map((x, i) => i === 0 ? { ...x, role: "hero", geometry: { centredShare: 0.2, mirrorSymmetry: 0.6, whitespaceRatio: 0.6, contentWidthRatio: 0.8, background: "rgb(255, 255, 255)", controls: 1 } } : x)
+        }
+      ]
+    }
+  },
   "icon-tile-grid": {
     detect: (s) => s.sections.filter((x) => x.cards >= 3 && x.iconCards >= 3).map((x) => hit(s, `${x.iconCards} icon cards in a row`, x.label)),
     fixtures: {
@@ -3878,7 +4228,7 @@ var IMAGERY_TELLS = [
 ];
 
 // src/character/check.ts
-var CATALOGUE_VERSION = "2026.10.4";
+var CATALOGUE_VERSION = "2026.10.7";
 var CATALOGUE = [
   ...[...SOURCE_TELLS, ...COPY_TELLS, ...RESEARCH_TELLS, ...DENSITY_TELLS].map((t) => RENDERED_PATHS[t.id] ? { ...t, rendered: RENDERED_PATHS[t.id] } : t),
   ...SPECIFICITY_COPY_TELLS,