@domandigital/craft 0.22.0 → 0.22.1

package/dist/audit.cjs

@@ -228,7 +228,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,
@@ -284,6 +294,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,
@@ -413,12 +451,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.")
+      ]
     }
   },
   {
@@ -469,11 +520,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.")]
     }
   },
@@ -554,6 +605,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",
@@ -1955,6 +2040,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);
@@ -2405,6 +2553,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",
@@ -3158,7 +3375,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
@@ -3172,6 +3391,8 @@ 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" },
   "ai-vocabulary": { tier: "review", label: "AI vocabulary" },
   "stock-phrase": { tier: "review", label: "stock phrase" },
   "hollow-imperative": { tier: "review", label: "hollow imperative" },
@@ -3397,6 +3618,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: {
@@ -3913,7 +4161,7 @@ var IMAGERY_TELLS = [
 ];
 
 // src/character/check.ts
-var CATALOGUE_VERSION = "2026.10.4";
+var CATALOGUE_VERSION = "2026.10.5";
 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,