@domandigital/craft 0.20.4 → 0.21.0

package/dist/cli-EYHRJJAX.js

@@ -0,0 +1,241 @@
+import {
+  EMPTY_BASELINE,
+  checkExceptions,
+  hasUnexcusedEntries,
+  judgeGrowth,
+  judgeMeasured,
+  judgeRoutes,
+  judgeStatic,
+  parseBaseline,
+  routesFromManifest,
+  routesFromPages,
+  scanPhoneFirst,
+  writeBaseline
+} from "./chunk-BQ7H23QP.js";
+import {
+  SOURCE_FILE,
+  readPaths
+} from "./chunk-4WAIOZ4W.js";
+import {
+  toJson
+} from "./chunk-QIEDBL4J.js";
+import "./chunk-DE2ZAV4G.js";
+import "./chunk-ONA73THJ.js";
+import "./chunk-QYBAVU3P.js";
+
+// src/phone/cli.ts
+import { existsSync as existsSync2, readdirSync as readdirSync2, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { join as join2, resolve as resolve2 } from "path";
+
+// src/phone/discover.ts
+import { execFileSync } from "child_process";
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { basename, dirname, join, relative, resolve, sep } from "path";
+var PAGE_FILE = /^page\.(?:tsx|ts|jsx|js|mdx)$/;
+function pageFiles(dir, base = dir, into = []) {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isDirectory()) {
+      if (entry.name !== "node_modules" && !entry.name.startsWith(".")) pageFiles(join(dir, entry.name), base, into);
+    } else if (entry.isFile() && PAGE_FILE.test(entry.name)) into.push(relative(base, join(dir, entry.name)));
+  }
+  return into;
+}
+function discoverRoutes(cwd, source, appDir, routesManifest) {
+  const explicit = appDir === void 0 ? void 0 : Array.isArray(appDir) ? appDir : [appDir];
+  const candidates = explicit ?? source.flatMap((s) => [s, join(s, "app"), join(s, "src", "app")]).filter((s) => basename(resolve(cwd, s)) === "app");
+  const routes = /* @__PURE__ */ new Set();
+  const from = [];
+  for (const dir of candidates) {
+    const abs = resolve(cwd, dir);
+    if (!existsSync(abs)) {
+      if (explicit) throw new Error(`appDir ${dir} is not there`);
+      continue;
+    }
+    const pages = pageFiles(abs);
+    if (pages.length === 0) continue;
+    from.push(dir);
+    for (const r of routesFromPages(pages)) routes.add(r);
+  }
+  if (routesManifest) {
+    const file = resolve(cwd, routesManifest);
+    if (!existsSync(file)) throw new Error(`routesManifest ${routesManifest} is not there. Build the app first, or use appDir.`);
+    from.push(routesManifest);
+    for (const r of routesFromManifest(JSON.parse(readFileSync(file, "utf8")))) routes.add(r);
+  }
+  return { routes: [...routes].sort(), from };
+}
+var majorOf = (range) => {
+  if (typeof range !== "string" || /^(?:catalog|workspace|link|file):/.test(range)) return null;
+  const m = range.match(/\d+/);
+  return m ? Number(m[0]) : null;
+};
+var readJson = (file) => {
+  try {
+    return JSON.parse(readFileSync(file, "utf8"));
+  } catch {
+    return null;
+  }
+};
+function tailwindMajor(dir) {
+  for (let at = resolve(dir); ; at = dirname(at)) {
+    const installed = majorOf(readJson(join(at, "node_modules", "tailwindcss", "package.json"))?.version);
+    if (installed !== null) return installed;
+    const pkg = readJson(join(at, "package.json"));
+    const declared = majorOf(pkg?.dependencies?.tailwindcss) ?? majorOf(pkg?.devDependencies?.tailwindcss);
+    if (declared !== null) return declared;
+    if (dirname(at) === at) return null;
+  }
+}
+function tailwind3Files(cwd, source, forced) {
+  const dirs = source.map((s) => resolve(cwd, s));
+  const versions = Object.fromEntries(source.map((s, i) => [s, forced ?? tailwindMajor(dirs[i])]));
+  return {
+    versions,
+    isV3: (path) => {
+      const abs = resolve(cwd, path);
+      return source.some((s, i) => (abs === dirs[i] || abs.startsWith(dirs[i] + sep)) && versions[s] === 3);
+    }
+  };
+}
+var git = (cwd, args) => execFileSync("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+var defaultBase = (flag, env = process.env) => flag ?? (env.GITHUB_BASE_REF ? `origin/${env.GITHUB_BASE_REF}` : "origin/main");
+function readBaseCopy(cwd, baselinePath, ref) {
+  try {
+    git(cwd, ["rev-parse", "--is-inside-work-tree"]);
+  } catch {
+    return { kind: "not-git" };
+  }
+  try {
+    git(cwd, ["rev-parse", "--verify", "--quiet", `${ref}^{commit}`]);
+  } catch {
+    return { kind: "no-ref", ref };
+  }
+  const rel = relative(cwd, baselinePath).split(sep).join("/");
+  let text;
+  try {
+    text = git(cwd, ["show", `${ref}:${rel.startsWith("..") ? rel : `./${rel}`}`]);
+  } catch {
+    return { kind: "no-file", ref };
+  }
+  return { kind: "found", ref, baseline: parseBaseline(JSON.parse(text), `${ref}:${rel}`) };
+}
+
+// src/phone/cli.ts
+var USAGE = "usage: craft phone-first [--config phone-first.json] [--measured <dir>] [--base <ref>] [--update-baseline] [--json]";
+function parse(args) {
+  const flags = { config: "phone-first.json", update: false, json: false };
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === "--update-baseline") flags.update = true;
+    else if (a === "--json") flags.json = true;
+    else if (a === "--config" || a === "--measured" || a === "--base") {
+      const v = args[++i];
+      if (!v || v.startsWith("--")) return `${a} needs a value`;
+      if (a === "--config") flags.config = v;
+      else if (a === "--base") flags.base = v;
+      else flags.measured = v;
+    } else return `unknown argument ${a}`;
+  }
+  return flags;
+}
+function loadConfig(path) {
+  if (!existsSync2(path)) throw new Error(`no ${path}. Write one: { "source": ["<dirs with styles and components>"], "baseline": "phone-first.baseline.json" }`);
+  const c = JSON.parse(readFileSync2(path, "utf8"));
+  if (!Array.isArray(c.source) || c.source.length === 0 || c.source.some((s) => typeof s !== "string")) throw new Error(`${path}: "source" should list the folders to scan`);
+  if (c.ignore !== void 0 && (!Array.isArray(c.ignore) || c.ignore.some((s) => typeof s !== "string"))) throw new Error(`${path}: "ignore" should be a list of globs`);
+  if (c.exceptions !== void 0 && !Array.isArray(c.exceptions)) throw new Error(`${path}: "exceptions" should be a list of { "file", "reason" }`);
+  if (c.excludeRoutes !== void 0 && !Array.isArray(c.excludeRoutes)) throw new Error(`${path}: "excludeRoutes" should be a list of { "route", "reason" }`);
+  if (c.appDir !== void 0 && typeof c.appDir !== "string" && !(Array.isArray(c.appDir) && c.appDir.every((d) => typeof d === "string"))) throw new Error(`${path}: "appDir" should be a folder or a list of folders`);
+  if (c.tailwind !== void 0 && typeof c.tailwind !== "number") throw new Error(`${path}: "tailwind" should be the major version, 3 or 4`);
+  return { ...c, source: c.source, ignore: c.ignore ?? [], exceptions: c.exceptions ?? [], excludeRoutes: c.excludeRoutes ?? [], baseline: c.baseline ?? "phone-first.baseline.json" };
+}
+function loadBaseline(path) {
+  if (!existsSync2(path)) return EMPTY_BASELINE;
+  return parseBaseline(JSON.parse(readFileSync2(path, "utf8")), path);
+}
+function loadMeasured(dir) {
+  if (!existsSync2(dir)) throw new Error(`--measured ${dir}: no such folder. Run the portal's phone-first specs first; they write it.`);
+  const routes = readdirSync2(dir).filter((f) => f.endsWith(".json")).sort().map((f) => JSON.parse(readFileSync2(join2(dir, f), "utf8")));
+  if (routes.length === 0) throw new Error(`--measured ${dir}: no measured routes in it. Did the phone-first specs run?`);
+  return routes;
+}
+function runPhoneFirst(args, io) {
+  const flags = parse(args);
+  if (typeof flags === "string") {
+    io.err(`craft phone-first: ${flags}
+${USAGE}`);
+    return 2;
+  }
+  try {
+    const config = loadConfig(resolve2(io.cwd, flags.config));
+    const baselinePath = resolve2(io.cwd, config.baseline);
+    const baseline = loadBaseline(baselinePath);
+    const exceptionProblems = checkExceptions(config.exceptions, (f) => existsSync2(resolve2(io.cwd, f)));
+    const sources = config.source.filter((s2) => existsSync2(resolve2(io.cwd, s2)));
+    const missing = config.source.filter((s2) => !sources.includes(s2));
+    if (missing.length) throw new Error(`${flags.config}: source ${missing.join(", ")} not found`);
+    const files = readPaths(sources, io.cwd, SOURCE_FILE, void 0, config.ignore);
+    const tailwind = tailwind3Files(io.cwd, sources, config.tailwind);
+    const { findings, excused } = scanPhoneFirst(files, config.exceptions, { tailwind3: tailwind.isV3 });
+    const routes = flags.measured ? loadMeasured(resolve2(io.cwd, flags.measured)) : null;
+    if (flags.update) {
+      const next = writeBaseline(findings, routes ?? [], baseline.note, baseline);
+      if (!routes) next.measured = baseline.measured;
+      writeFileSync(baselinePath, `${JSON.stringify(next, null, 2)}
+`);
+      io.out(`craft phone-first: wrote ${config.baseline} (${next.static.reduce((n, s2) => n + s2.count, 0)} static, ${next.measured.reduce((n, m2) => n + m2.count, 0)} measured)`);
+      return exceptionProblems.length ? 1 : 0;
+    }
+    const s = judgeStatic(findings, baseline);
+    const m = routes ? judgeMeasured(routes, baseline) : { fresh: [], stale: [], known: 0 };
+    const base = defaultBase(flags.base);
+    const copy = hasUnexcusedEntries(baseline) ? readBaseCopy(io.cwd, baselinePath, base) : null;
+    const grown = copy?.kind === "found" ? judgeGrowth(baseline, copy.baseline, copy.ref) : [];
+    const baseProblems = copy?.kind === "no-ref" ? [`cannot see ${copy.ref}, so the baseline cannot be compared with it. Fetch it first (\`git fetch origin main\`, or \`fetch-depth: 0\` on actions/checkout), or name another base with --base <ref>.`] : [];
+    const baseNote = copy?.kind === "not-git" ? "baseline growth not checked: not a git checkout" : copy?.kind === "no-file" ? `no ${config.baseline} on ${copy.ref} yet, so this baseline is the first` : null;
+    const app = routes ? discoverRoutes(io.cwd, sources, config.appDir, config.routesManifest) : null;
+    const covered = app && routes ? judgeRoutes(app.routes, routes.map((r) => r.route), config.excludeRoutes) : null;
+    const routeNote = routes && app && app.routes.length === 0 ? "route coverage not checked: no Next app folder with page files in source (set appDir)" : null;
+    const failed = exceptionProblems.length + s.fresh.length + s.stale.length + m.fresh.length + m.stale.length + grown.length + baseProblems.length + (covered ? covered.missing.length + covered.problems.length : 0) > 0;
+    if (flags.json) {
+      io.out(toJson({ pass: !failed, files: files.length, excused, routes: routes?.map((r) => r.route) ?? null, exceptionProblems, static: s, measured: m, baseline: { base, grown, problems: baseProblems, note: baseNote }, pages: covered ? { ...covered, found: app.routes.length } : null, tailwind: tailwind.versions }));
+      return failed ? 1 : 0;
+    }
+    const wide = routes?.some((r) => r.viewports) ?? false;
+    const section = (title, lines) => lines.length ? `
+${title}
+${lines.map((l) => `  ${l}`).join("\n")}` : "";
+    const known = s.known + m.known;
+    const summary = [
+      `${files.length} files${routes ? ` and ${routes.length} route${routes.length === 1 ? "" : "s"} at ${wide ? "every viewport" : "375px"}` : ""}`,
+      excused ? `${excused} recorded exception${excused === 1 ? "" : "s"}` : null,
+      known ? `${known} known breach${known === 1 ? "" : "es"} in ${config.baseline}` : null,
+      covered && app.routes.length ? `${app.routes.length} page route${app.routes.length === 1 ? "" : "s"} covered` : null
+    ].filter(Boolean).join(", ");
+    if (!failed) {
+      io.out(`craft phone-first: pass. ${summary}.${[baseNote, routeNote].filter(Boolean).map((n) => `
+  note: ${n}`).join("")}`);
+      return 0;
+    }
+    io.err(
+      [
+        `craft phone-first: fail. ${summary}.`,
+        section("The exceptions:", exceptionProblems),
+        section("Built desktop first (write the phone as the base styles and widen with min-width; a genuine exception takes `mobile-first-ok: <reason>` on its line):", s.fresh),
+        section(wide ? "Measured across the viewports, phone first:" : "Measured at 375px:", m.fresh),
+        section(`Page routes the gate never measures (add the route to the phone-first specs with seeded data; a page that only redirects goes in "excludeRoutes" with its reason):`, covered?.missing ?? []),
+        section("excludeRoutes:", covered?.problems ?? []),
+        section(`The baseline holds entries that ${copy?.kind === "found" ? copy.ref : base} does not (the baseline only shrinks: fix the breach where it is, or, for third-party UI or a destructive-only form, add the entry with a "reason". If main shrank the baseline since this branch left it, merge main first):`, grown),
+        section("The base branch:", baseProblems),
+        section("The baseline claims more than is there (good: lower it, so the fix stays fixed):", [...s.stale, ...m.stale])
+      ].join("")
+    );
+    return 1;
+  } catch (error) {
+    io.err(`craft phone-first: ${error.message}`);
+    return 2;
+  }
+}
+export {
+  runPhoneFirst
+};

package/dist/{cli-AFKXDGUH.js → cli-PBCU7Z64.js}

@@ -9,13 +9,13 @@ import {
   runHarvest,
   runNull,
   serveDir
-} from "./chunk-KQF44RI3.js";
+} from "./chunk-FNB3NP57.js";
 import "./chunk-OQXTQQAU.js";
-import "./chunk-NQAYRK2K.js";
+import "./chunk-4WAIOZ4W.js";
 import "./chunk-QIEDBL4J.js";
 import "./chunk-WUACK2HX.js";
-import "./chunk-JGWOA4LI.js";
-import "./chunk-7DQDF3VL.js";
+import "./chunk-DE2ZAV4G.js";
+import "./chunk-ONA73THJ.js";
 import "./chunk-QYBAVU3P.js";
 export {
   describeTypicality,

package/dist/{cli-6AZVLNWL.js → cli-RHDNHL4U.js}

@@ -19,10 +19,10 @@ import {
   checkReason,
   researchPrompt,
   validateDirection
-} from "./chunk-S3L7TEJF.js";
+} from "./chunk-G47ZCBD5.js";
 import {
   parseFlags
-} from "./chunk-NQAYRK2K.js";
+} from "./chunk-4WAIOZ4W.js";
 import {
   toJson
 } from "./chunk-QIEDBL4J.js";
@@ -38,8 +38,8 @@ import {
   isCream,
   oklchToRgb,
   parseColour
-} from "./chunk-JGWOA4LI.js";
-import "./chunk-7DQDF3VL.js";
+} from "./chunk-DE2ZAV4G.js";
+import "./chunk-ONA73THJ.js";
 import "./chunk-QYBAVU3P.js";
 
 // src/direction/cli.ts
@@ -484,7 +484,7 @@ var readJson = (path) => JSON.parse(readFileSync(path, "utf8"));
 async function snapshotFrom(target, cwd) {
   if (!target) return void 0;
   if (/^https?:\/\//.test(target)) {
-    const { snapshotUrl } = await import("./audit-BN2GSFKT.js");
+    const { snapshotUrl } = await import("./audit-LQ2TDISV.js");
     return snapshotUrl(target);
   }
   return readSnapshot(readJson(resolve(cwd, target)), target);

package/dist/{cli-OYVZOHHV.js → cli-XAWJWK7I.js}

@@ -4,16 +4,16 @@ import {
   merge,
   resolvePages,
   runAudit
-} from "./chunk-2276FJVN.js";
-import "./chunk-YOZLPNJS.js";
+} from "./chunk-BYXDX66D.js";
+import "./chunk-6DRBFDWT.js";
 import "./chunk-JYNXGCYZ.js";
-import "./chunk-KQF44RI3.js";
+import "./chunk-FNB3NP57.js";
 import "./chunk-OQXTQQAU.js";
-import "./chunk-NQAYRK2K.js";
+import "./chunk-4WAIOZ4W.js";
 import "./chunk-QIEDBL4J.js";
 import "./chunk-WUACK2HX.js";
-import "./chunk-JGWOA4LI.js";
-import "./chunk-7DQDF3VL.js";
+import "./chunk-DE2ZAV4G.js";
+import "./chunk-ONA73THJ.js";
 import "./chunk-QYBAVU3P.js";
 export {
   describeComponents,

package/dist/{cli-7HKVVL3P.js → cli-YSGPGQ7R.js}

@@ -3,21 +3,21 @@ import {
 } from "./chunk-OKVHWXYV.js";
 import {
   merge
-} from "./chunk-2276FJVN.js";
-import "./chunk-YOZLPNJS.js";
+} from "./chunk-BYXDX66D.js";
+import "./chunk-6DRBFDWT.js";
 import "./chunk-JYNXGCYZ.js";
 import {
   SIBLING_AT,
   compareToEstate,
   loadEstate
-} from "./chunk-GBDPNNC2.js";
+} from "./chunk-STWH5EYU.js";
 import {
   PAGE_TYPES,
   validateDirection
-} from "./chunk-S3L7TEJF.js";
+} from "./chunk-G47ZCBD5.js";
 import {
   loadNull
-} from "./chunk-KQF44RI3.js";
+} from "./chunk-FNB3NP57.js";
 import "./chunk-OQXTQQAU.js";
 import {
   COPY_FILE,
@@ -28,7 +28,7 @@ import {
   loadExceptions,
   parseFlags,
   readPaths
-} from "./chunk-NQAYRK2K.js";
+} from "./chunk-4WAIOZ4W.js";
 import {
   toJson
 } from "./chunk-QIEDBL4J.js";
@@ -42,8 +42,8 @@ import {
   fingerprint,
   scanSource,
   typicality
-} from "./chunk-JGWOA4LI.js";
-import "./chunk-7DQDF3VL.js";
+} from "./chunk-DE2ZAV4G.js";
+import "./chunk-ONA73THJ.js";
 import "./chunk-QYBAVU3P.js";
 
 // src/report/cli.ts
@@ -126,7 +126,7 @@ async function runReport(command, args, io) {
     if (/\.json$/i.test(target2) && existsSync(local)) {
       snap = readSnapshot(JSON.parse(readFileSync(local, "utf8")), target2);
     } else {
-      const { snapshotUrl } = await import("./audit-BN2GSFKT.js");
+      const { snapshotUrl } = await import("./audit-LQ2TDISV.js");
       snap = await snapshotUrl(target2);
     }
     const fp = fingerprint(snap);

package/dist/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   run
-} from "./chunk-NQAYRK2K.js";
+} from "./chunk-4WAIOZ4W.js";
 import "./chunk-QIEDBL4J.js";
-import "./chunk-JGWOA4LI.js";
-import "./chunk-7DQDF3VL.js";
+import "./chunk-DE2ZAV4G.js";
+import "./chunk-ONA73THJ.js";
 import "./chunk-QYBAVU3P.js";
 
 // src/cli.ts

package/dist/index.cjs

@@ -2058,6 +2058,33 @@ var OUTCOME_PROMISES = [
   /\byou(?:['’]ll| will)\s+(?:get|see|win|receive|start getting)\s+more\b/i,
   new RegExp(`\\b(?:will|we['\u2019]ll)\\s+(?:(?:bring|drive|generate|get)\\s+you|bring|drive|generate)\\s+more\\s+(?:[\\w-]+\\s+)?${SALES_RESULTS}\\b`, "i")
 ];
+var SENTENCE_START = String.raw`(?<=^|[\n>"“]|[.!?]\s+)`;
+var MATEY = [
+  // "Alright Carlo,", "Oi Dave", "Alright, mate"
+  /\b(?:Alright|Oi)(?:,\s*|\s+)(?:mate\b|[A-Z][a-z]+\b)/,
+  // "mate" as a form of address, not "a mate who knows"
+  /,\s*mate\b|\b(?:thanks|ta|cheers|alright|oi|fussed|sorry|worries|bother|hiya|hey)\s+mate\b/i,
+  /\b(?:innit|chuffed|lovely jubbly)\b|\bbish,?\s+bash,?\s+bosh\b|\bbob['’]?s\s+your\s+uncle\b/i,
+  /\bno\s+(?:worries|bother)\b|\bnot\s+fussed\b/i,
+  // "Right then," opening a sentence, not "the right then left turn"
+  new RegExp(`${SENTENCE_START}Right,?\\s+then\\b[,!.]`),
+  // "we'll get you sorted", "all sorted", "Sorted!", not "sorted by date"
+  /\b(?:all|get(?:ting)?\s+(?:it|that|this|you|them|everything)|got\s+(?:it|that|you)|you['’]re)\s+sorted\b(?!\s+(?:by|in|into|alphabetically)\b)/i,
+  new RegExp(`${SENTENCE_START}Sorted[.!]`),
+  // "proper" as an intensifier before an adjective, not "proper planning"
+  /\bproper\s+(?:good|nice|quick|tidy|lovely|decent|chuffed|busy|mint|smart|happy|gutted|brilliant|buzzing)\b/i,
+  /\bgive\s+(?:me|us)\s+a\s+(?:shout|bell|buzz|tinkle)\b/i,
+  /\bwhen\s+you\s+(?:get|have|['’]ve\s+got)\s+a\s+(?:sec|min|mo)\b/i,
+  /\bhave\s+a\s+(?:quick\s+)?(?:gander|squiz|nosey|nose(?:\s+(?:round|around))?)\b(?!\s+for\b)/i,
+  /\bcheck\s+out\s+(?:our|my|this|these)\b/i
+];
+var CLIPPED = [
+  /\b(?:take|takes|took|taking|have|has|had|having)\s+(?:quick\s+)?look\s+(?:at|on|over|through|in)\b/i,
+  /\bgive\s+(?:it|this|that|them)\s+(?:go|try|look|read|whirl|bash)\b(?![-\w])/i,
+  new RegExp(`${SENTENCE_START}Quick\\s+one\\b(?=\\s*[:,.!?\u2014\u2013-]|\\s+(?:for you|before|on|about)\\b)`),
+  // "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 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,
@@ -2294,6 +2321,40 @@ var COPY_TELLS = [
       ]
     }
   },
+  {
+    id: "matey-register",
+    name: "Matey register",
+    generation: 2,
+    severity: "warn",
+    surface: "copy",
+    why: "'Alright Dave,', 'no worries, we'll get you sorted', 'Quick one:', 'have look at': a put-on, over-familiar British voice, with the small words clipped out. A model asked to sound British writes it; the UK is broad, and a client reads it as cringe and a little rude.",
+    fix: "Write plain, complete British English. 'Alright Dave, built you a site' becomes 'Hi Dave, I have built you a site'; 'No worries, we'll get you sorted' becomes 'We can fit you in on Thursday'.",
+    detect: phrases([...MATEY, ...CLIPPED], quoted),
+    fixtures: {
+      flag: [
+        // From the portal's seeded prospect follow-ups, 2026-10-19.
+        f("emails/followup.md", "Alright Dave, it's Dmitri. No pressure, have a look when you get a min."),
+        f("emails/followup.md", "All good if you're not fussed mate, I'll leave it there."),
+        f("emails/followup.md", "Carlo, built the shop a proper site."),
+        f("content/contact.md", "No worries, we'll get you sorted."),
+        f("emails/quote.md", "Take look on these photos and give it go."),
+        f("emails/quote.md", "Quick one: is Thursday still good?"),
+        f("emails/quote.md", "Right then, here is the plan."),
+        f("content/reviews.md", "The fitters did a proper good job and we were chuffed.")
+      ],
+      pass: [
+        f("content/home.md", "Proper planning saves a second visit."),
+        f("content/certificates.md", "Download a sorted list of certificates, sorted by date."),
+        f("content/directions.md", "At the junction, take the right then left turn."),
+        // Chair and Blade's own approved line, and "mate" as a noun.
+        f("content/home.md", "Every cut starts with a proper chat about what you actually want."),
+        f("content/home.md", "It feels like getting a cut from a mate who knows what he is doing."),
+        f("emails/quote.md", "Have a look at the quote and ring me if Thursday does not work."),
+        f("content/contact.md", "Give us a ring on 01280 700123. We take a look at the fault before quoting."),
+        f("content/home.md", "Built to last, and made for older houses.")
+      ]
+    }
+  },
   {
     id: "hollow-imperative",
     name: "Hollow imperative",
@@ -2494,7 +2555,12 @@ var FALSE_RANGE = [
 ];
 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,
+  // At the start of a line, or after a sentence that ends in a full stop or
+  // an exclamation mark: "I hope this email finds you well! Certainly, here
+  // is the handover request." slipped through when only a line start counted
+  // (found live, 2026-10-19). Not after a question mark: an FAQ answer may
+  // honestly open "Do you work weekends? Absolutely, here are our hours."
+  /(?<=^|[\n>]|[.!]\s+)\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,
@@ -2510,6 +2576,13 @@ var RESIDUE = [
   /[\uE200-\uE2FF]*entity[\uE200-\uE2FF]*\["[a-z_]+"\s*,\s*"[^"\n]{1,80}"(?:\s*,\s*"[^"\n]{0,160}")*\][\uE200-\uE2FF]*/,
   /【\d+(?:[:†][^】]{0,40})?】/
 ];
+var STOCK_EMAIL = [
+  /\bI (?:hope|trust) (?:this|my|the) (?:e-?mail|message|note|letter) finds you(?: all)? (?:well|in good health)\b/i,
+  /\bI hope you(?:['’]re| are)(?: all)? (?:doing |keeping )?well\b/i,
+  /\b(?:I )?hope you(?:['’]re| are) having an? (?:great|good|lovely|wonderful|fantastic) (?:day|week|weekend)\b/i,
+  /\blet (?:me|us) know if you have any (?:further |other |more )?questions\b/i,
+  /\b(?:do not|don['’]t) hesitate to (?:contact|reach out|get in touch|ask|call)\b/i
+];
 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);
@@ -2591,15 +2664,39 @@ var RESEARCH_TELLS = [
         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.")
+        f("content/home.md", "Here's a more concise version for the hero."),
+        // The client handover email that a clean copy-check let through, 2026-10-19.
+        f("emails/handover.md", "Hi,\n\nI hope this email finds you well! Certainly, here is the handover request. Let me know if you have any questions.")
       ],
       pass: [
         f("content/home.md", "Certainly the busiest week of the year: book early."),
+        f("content/faq.md", "Do you work weekends? Absolutely, here are our hours."),
         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: "stock-email-line",
+    name: "Stock email line",
+    generation: 1,
+    severity: "warn",
+    surface: "copy",
+    why: "'I hope this email finds you well', 'let me know if you have any questions', 'don't hesitate to contact us': the opener and closer of a form email. A client reads past them, and a model drafting an email writes them every time.",
+    fix: "Cut the opener and start with the reason for writing. Replace the closer with the next step and who to ask: 'Ring me on 07700 900123 if the date does not work.'",
+    detect: phrases(STOCK_EMAIL, quoted),
+    fixtures: {
+      flag: [
+        f("emails/handover.md", "Hi,\n\nI hope this email finds you well! Certainly, here is the handover request. Let me know if you have any questions."),
+        f("emails/quote.md", "Hope you're having a great week. The quote is attached."),
+        f("content/contact.md", "Please don't hesitate to contact us about a rewire.")
+      ],
+      pass: [
+        f("emails/handover.md", "Hi Sam,\n\nThe handover pack is attached: certificates, the board schedule and the warranty. Ring me on 07700 900123 if anything is missing."),
+        f("content/contact.md", "If you have any questions, ring Jo on 01280 700123.")
+      ]
+    }
+  },
   {
     id: "prompt-context",
     name: "Prompt context",
@@ -5209,6 +5306,10 @@ var HOUSE = {
   // New 2026-10-14 (founder): review first, like every new tell, until estate hits are read.
   "sales-tagline": { tier: "review", label: "sales tagline, say what you will actually do" },
   "outcome-promise": { tier: "review", label: "outcome promise, promise the work, not the result" },
+  // New 2026-10-19: review first, like every new tell, until estate hits are read.
+  "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" },
   "ai-vocabulary": { tier: "review", label: "AI vocabulary" },
   "stock-phrase": { tier: "review", label: "stock phrase" },
   "hollow-imperative": { tier: "review", label: "hollow imperative" },
@@ -6414,7 +6515,7 @@ var IMAGERY_TELLS = [
 ];
 
 // src/character/check.ts
-var CATALOGUE_VERSION = "2026.10.2";
+var CATALOGUE_VERSION = "2026.10.4";
 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,

package/dist/index.d.cts

@@ -1252,7 +1252,7 @@ interface CheckReport {
  * Bumped whenever an entry is added, removed or its detection changes, so a
  * report can say which list it was judged against.
  */
-declare const CATALOGUE_VERSION = "2026.10.2";
+declare const CATALOGUE_VERSION = "2026.10.4";
 declare const CATALOGUE: readonly Tell[];
 declare function tellById(id: string): Tell | undefined;
 /**

package/dist/index.d.ts

@@ -1252,7 +1252,7 @@ interface CheckReport {
  * Bumped whenever an entry is added, removed or its detection changes, so a
  * report can say which list it was judged against.
  */
-declare const CATALOGUE_VERSION = "2026.10.2";
+declare const CATALOGUE_VERSION = "2026.10.4";
 declare const CATALOGUE: readonly Tell[];
 declare function tellById(id: string): Tell | undefined;
 /**