@domandigital/craft 0.16.0 → 0.17.0

package/dist/index.js

@@ -4466,7 +4466,7 @@ var SPECIFICITY_COPY_TELLS = [
     },
     rendered: {
       detect: (s) => {
-        if (!s.firstScreenText || !HOME_URL.test(s.url)) return [];
+        if (!s.firstScreenText || !(s.home ?? HOME_URL.test(s.url))) return [];
         const text = s.firstScreenText.join("\n");
         if (!text.trim() || !specificity(text).generic) return [];
         const h1 = s.headings.find((h) => h.level === 1 && h.top < s.viewport.height);
@@ -6244,6 +6244,1270 @@ function lexicalOf(text, brief) {
   };
 }
 
+// src/register/features.ts
+var REGISTER_FEATURES = [
+  "meanSentenceWords",
+  "contractionsPer100",
+  "youPer100",
+  "firstPersonPer100",
+  "passiveShare",
+  "meanWordLength"
+];
+var norm = (w) => w.toLowerCase().replace(/’/g, "'");
+var YOU = /* @__PURE__ */ new Set(["you", "your", "yours", "yourself", "yourselves", "you'll", "you're", "you've", "you'd"]);
+var FIRST = /* @__PURE__ */ new Set(["i", "me", "my", "mine", "we", "us", "our", "ours", "i'm", "i'll", "i've", "i'd", "we're", "we'll", "we've", "we'd"]);
+var CONTRACTION2 = /^[a-z]+(?:n't|'ll|'re|'ve|'d|'m)$|^(?:it|that|there|here|what|who|where|how|he|she|let)'s$/;
+var BE = "(?:am|is|are|was|were|be|been|being|'s|'re|'m)";
+var IRREGULAR = "(?:made|done|given|taken|seen|known|shown|written|built|sent|paid|held|told|found|kept|left|brought|bought|thought|taught|caught|sold|put|set|run|cut|chosen|driven|eaten|fallen|forgotten|hidden|broken|spoken|stolen|worn|torn|grown|drawn|thrown|flown|begun|sung|won|lost|met|led|read|heard|meant|spent|built|lent|dealt|felt|sought|fed|bred|laid|said|struck|hung|shut|hit|hurt|let|quit|spread|bound|wound|ground|understood|withdrawn|overseen|undertaken)";
+var PASSIVE = new RegExp(`\\b${BE}\\s+(?:[a-z]+ly\\s+)?(?:[a-z]+ed|[a-z]+en|${IRREGULAR})\\b`, "i");
+var ADJECTIVAL = /* @__PURE__ */ new Set([
+  "tired",
+  "interested",
+  "excited",
+  "pleased",
+  "worried",
+  "concerned",
+  "surprised",
+  "bored",
+  "scared",
+  "married",
+  "qualified",
+  "experienced",
+  "based",
+  "located",
+  "committed",
+  "dedicated",
+  "delighted",
+  "disappointed",
+  "involved",
+  "prepared",
+  "supposed",
+  "used",
+  "open",
+  "often",
+  "even",
+  "seven",
+  "eleven",
+  "listen",
+  "happen",
+  "then",
+  "when",
+  "ten",
+  "garden",
+  "kitchen",
+  "children",
+  "women",
+  "men",
+  "red",
+  "bed",
+  "need",
+  "indeed",
+  "shed",
+  "seed",
+  "feed",
+  "speed",
+  "hundred"
+]);
+function isPassive(sentence) {
+  const re = new RegExp(PASSIVE.source, "gi");
+  for (const m of sentence.matchAll(re)) {
+    const last = norm(m[0].trim().split(/\s+/).pop() ?? "");
+    if (last === "given" && /given\s+that\b/i.test(sentence.slice(m.index ?? 0))) continue;
+    if (!ADJECTIVAL.has(last)) return true;
+  }
+  return false;
+}
+function registerOf(text) {
+  const ss = splitSentences(text);
+  const ws = words(text).map(norm);
+  const n = ws.length;
+  const per100 = (k) => n === 0 ? 0 : 100 * k / n;
+  const letters = ws.reduce((s, w) => s + w.replace(/[^a-z]/g, "").length, 0);
+  return {
+    meanSentenceWords: ss.length === 0 ? 0 : n / ss.length,
+    contractionsPer100: per100(ws.filter((w) => CONTRACTION2.test(w)).length),
+    youPer100: per100(ws.filter((w) => YOU.has(w)).length),
+    firstPersonPer100: per100(ws.filter((w) => FIRST.has(w)).length),
+    passiveShare: ss.length === 0 ? 0 : ss.filter(isPassive).length / ss.length,
+    meanWordLength: n === 0 ? 0 : letters / n
+  };
+}
+
+// src/register/registers.ts
+var GOVUK = "GOV.UK writing guidelines";
+var MAILCHIMP = "Mailchimp Content Style Guide";
+var OGILVY = "Ogilvy, Ogilvy on Advertising (1983)";
+var CAPLES = "Caples, Tested Advertising Methods";
+var HOUSE2 = "house judgement";
+var ALWAYS = "Every register keeps the COPY.md blocking tier and the proof rule. Draft first, then run `craft copy <file>` on the draft.";
+var REGISTERS = [
+  {
+    id: "plain",
+    name: "Plain and trustworthy",
+    useFor: "Forms, policies, terms, instructions, and professional services where the reader must act correctly.",
+    directives: [
+      { text: "Put the most important information first, then taper down to the detail.", from: GOVUK },
+      { text: "Split any sentence over 25 words into two.", from: GOVUK },
+      { text: "Choose the short, common word: buy, help, about.", from: GOVUK },
+      { text: "Write in the active voice, so the reader sees who does what.", from: GOVUK },
+      { text: 'Address the reader as "you", as one person you can actually help.', from: GOVUK },
+      { text: `Use positive contractions such as "you'll", and write negatives out in full: "do not", "cannot".`, from: GOVUK },
+      { text: "Write headings that say what the section tells the reader, starting with a verb where you can.", from: GOVUK },
+      { text: "Give each paragraph one job.", from: HOUSE2 }
+    ],
+    example: {
+      before: "Should you wish to apply for a residents' parking permit, an application form must be completed and submitted to the council prior to the commencement of the permit period.",
+      after: "Apply for a residents' parking permit before you need it. Fill in the form online. It takes about 10 minutes.",
+      why: "The action comes first, the council is no longer the subject, and each sentence does one thing."
+    },
+    sources: [
+      {
+        name: GOVUK,
+        url: "https://guidance.publishing.service.gov.uk/writing-to-gov-uk-standards/writing-guidelines/",
+        note: 'Clear language (the 25-word split, short words, active voice, contractions), clear structure (most important first, headings) and right tone (address the user as "you"). Checked against the live pages on 2026-09-30.'
+      }
+    ]
+  },
+  {
+    id: "persuasive",
+    name: "Persuasive and concise",
+    useFor: "Landing pages, service pages, adverts and sales emails: copy whose job is one action.",
+    directives: [
+      { text: "Put the promise in the headline: what the reader gets, in words they would use.", from: OGILVY },
+      { text: "Back each claim with something the reader can check: a number, a name, a date, a price.", from: "COPY.md" },
+      { text: 'Write to one reader, as "you", about their problem before your service.', from: CAPLES },
+      { text: "Name the mechanism: how it works, how long it takes, what it costs.", from: "COPY.md" },
+      { text: "Answer the objection the reader already has, with evidence, in the sentence that follows the claim.", from: HOUSE2 },
+      { text: "Let the copy run as long as the facts last, and cut each sentence that carries none.", from: OGILVY },
+      { text: "Close with one specific action and what happens straight after it.", from: "COPY.md" }
+    ],
+    example: {
+      before: "Transform your garden with our premium landscaping solutions. Quality you can trust.",
+      after: "We lay a 40 square metre Indian sandstone patio in three days, for \xA34,800 fitted. Every job since 2014 is on our reviews page. Book a free site visit and get a fixed quote within 48 hours.",
+      why: "Size, material, time and price replace the adjectives, the proof sits next to the claim, and the close says what happens next. Fictional business."
+    },
+    sources: [
+      {
+        name: OGILVY,
+        note: "Headlines carry the promise because far more people read the headline than the body; specific, informative copy outsells vague copy. Taken from the widely quoted principles; a page-by-page check against the book is still to do."
+      },
+      {
+        name: CAPLES,
+        note: "Headlines that appeal to the reader's self-interest, and copy judged by tested response rather than taste. A page-by-page check against the book is still to do."
+      },
+      {
+        name: "COPY.md",
+        note: "Writing directives (lead with the fact, name the mechanism, persuade with something checkable) and the CTA rule."
+      }
+    ]
+  },
+  {
+    id: "warm",
+    name: "Warm and conversational",
+    useFor: "Customer emails, replies to enquiries, newsletters and small-business updates.",
+    directives: [
+      { text: "Write the way you would talk to a customer you like: contractions, everyday words.", from: MAILCHIMP },
+      { text: "Keep words and sentences simple; being clear matters more than being entertaining.", from: MAILCHIMP },
+      { text: "Say what the reader can do, in positive language.", from: MAILCHIMP },
+      { text: "Use the active voice.", from: MAILCHIMP },
+      { text: "Match the tone to how the reader feels right now: lighter for good news, calm and direct for a problem.", from: MAILCHIMP },
+      { text: "Keep humour dry and occasional, and only where it comes naturally.", from: MAILCHIMP },
+      { text: "Sign off as a person, with a name.", from: HOUSE2 }
+    ],
+    example: {
+      before: "Dear Valued Customer, We wish to inform you that your order has been dispatched and will be delivered in due course.",
+      after: "Hi Sam, your order's on its way. It left our Leicester workshop this morning and should reach you on Thursday. Any questions, just reply to this email. Priya",
+      why: 'A name at each end, a real day and place instead of "in due course", and a next step. Fictional business.'
+    },
+    sources: [
+      {
+        name: MAILCHIMP,
+        url: "https://styleguide.mailchimp.com/voice-and-tone/",
+        note: "Voice and tone (plainspoken, genuine, dry humour; clear before entertaining; adjust tone to the reader's state) and grammar and mechanics (active voice, contractions, positive language). Its allowance for emoji does not apply: emoji block under COPY.md. Checked against the live pages on 2026-09-30."
+      }
+    ]
+  },
+  {
+    id: "literary",
+    name: "Elegant and literary",
+    useFor: "Premium brands, makers, hospitality and anything sold on craft and taste rather than price.",
+    directives: [
+      { text: "Choose one precise noun over two adjectives.", from: HOUSE2 },
+      { text: "Let sentence length follow the thought: a long sentence to build, a short one to land.", from: "COPY.md" },
+      { text: "Carry the detail in concrete facts: material, place, process, time.", from: HOUSE2 },
+      { text: "Trust the reader with one image, state it once, and move on.", from: HOUSE2 },
+      { text: "Keep claims quiet and exact, and let the facts carry the prestige.", from: HOUSE2 },
+      { text: "Draw any metaphor from the maker's own work, and hold it for the whole piece.", from: HOUSE2 },
+      { text: "Read the draft aloud and rework each line that trips the breath.", from: HOUSE2 }
+    ],
+    example: {
+      before: "Our luxurious, handcrafted candles create an unforgettable ambience of elegance and sophistication.",
+      after: "Each candle is poured by hand in our Hebden Bridge workshop, forty to a batch. The wax is English rapeseed and the scent is cedar, cut with a little smoke. It burns for sixty hours, and the glass is yours to keep.",
+      why: "Place, material, scent and burn time do the work the adjectives claimed. Fictional business."
+    },
+    sources: [
+      {
+        name: HOUSE2,
+        note: "No public style authority exists for premium-brand prose. These directives are house judgement, to be revised as the estate grows."
+      },
+      {
+        name: "Register separation, 2026-09-29",
+        url: "calibration/copy-shape/report-registers.md",
+        note: "Literary prose (Gutenberg) carries about twice the comma density of the other human registers, the one feature that separated it from all four. Longer, jointed sentences are normal here."
+      }
+    ]
+  }
+];
+var REGISTER_IDS = REGISTERS.map((r) => r.id);
+function getRegister(id) {
+  return REGISTERS.find((r) => r.id === id);
+}
+function registerBrief(id) {
+  const r = getRegister(id);
+  if (!r) throw new Error(`unknown register "${id}". Registers: ${REGISTER_IDS.join(", ")}`);
+  const lines = [`Register: ${r.name} (${r.id})`, `Use for: ${r.useFor}`, "", "Before you draft:"];
+  r.directives.forEach((d, i) => lines.push(`  ${i + 1}. ${d.text} [${d.from}]`));
+  lines.push("", "Example (fictional):", `  Before: ${r.example.before}`, `  After:  ${r.example.after}`, `  Why:    ${r.example.why}`);
+  lines.push("", "Sources:");
+  for (const s of r.sources) lines.push(`  - ${s.name}${s.url ? ` (${s.url})` : ""}: ${s.note}`);
+  lines.push("", `Always: ${ALWAYS}`);
+  return lines.join("\n");
+}
+function registersDoc() {
+  const out = [];
+  for (const r of REGISTERS) {
+    out.push(`## ${r.name} (\`${r.id}\`)`, "", `**Use for:** ${r.useFor}`, "", "**Before you draft:**", "");
+    r.directives.forEach((d, i) => out.push(`${i + 1}. ${d.text} *(${d.from})*`));
+    out.push("", "**Example (fictional):**", "", `- Before: ${r.example.before}`, `- After: ${r.example.after}`, `- Why: ${r.example.why}`);
+    out.push("", "**Sources:**", "");
+    for (const s of r.sources) out.push(`- ${s.url ? `[${s.name}](${s.url})` : s.name}: ${s.note}`);
+    out.push("");
+  }
+  out.push(`**Always:** ${ALWAYS}`);
+  return out.join("\n");
+}
+
+// src/register/check.ts
+var REGISTER_BASELINE = {
+  plain: {
+    baseline: "institutional",
+    note: "Compared with Hansard: edited parliamentary debate, the closest free UK source, not plain writing itself."
+  },
+  persuasive: {
+    baseline: "marketing",
+    note: "Compared with 715 passages from UK small-business websites before 2021: a small sample."
+  },
+  warm: {
+    baseline: "business-email",
+    note: "Compared with Enron sent email, 1999 to 2002: corporate and American, not small-business email."
+  },
+  literary: {
+    baseline: "literary",
+    note: "Compared with English fiction and essays, 1726 to 1925: older than any premium brand's copy."
+  }
+};
+var MIN_PARAGRAPHS = 5;
+var CONTENT_FEATURES = /* @__PURE__ */ new Set(["hardPer100", "specificsPer100", "tradePer100", "figures", "names", "generic"]);
+var usable = (f4, b) => !CONTENT_FEATURES.has(f4) && b.p90 > b.p10;
+var LABELS = {
+  meanSentenceWords: "Words per sentence",
+  contractionsPer100: "Contractions per 100 words",
+  youPer100: '"You" per 100 words',
+  firstPersonPer100: '"I" and "we" per 100 words',
+  passiveShare: "Share of sentences in the passive",
+  meanWordLength: "Letters per word",
+  commasPer100: "Commas per 100 words",
+  commasPerSentence: "Commas per sentence",
+  clauseDepth: "Clauses per sentence",
+  nominalisationRate: 'Nominalisations ("the provision of") per 100 words',
+  pronounOpenerShare: "Share of sentences opening with a pronoun",
+  impersonalOpenerShare: 'Share of sentences opening impersonally ("It is", "There are")',
+  coordinationRate: 'Paired phrases ("fast and friendly") per 100 words',
+  participialRate: '"-ing" clauses per sentence',
+  tricolons: "Lists of three",
+  sentenceCv: "Spread of sentence lengths",
+  skeletonRepeat: "Repeated sentence patterns",
+  hardPer100: "Hard specifics (names, figures, dates) per 100 words",
+  specificsPer100: "Specifics of any kind per 100 words",
+  tradePer100: "Trade nouns per 100 words",
+  figures: "Figures per paragraph",
+  names: "Names per paragraph",
+  generic: "Share of paragraphs with no specific at all"
+};
+var featureLabel = (f4) => LABELS[f4] ?? f4;
+function documentParagraphs(text) {
+  return text.replace(/\r\n?/g, "\n").split(/\n\s*\n/).map((p) => p.replace(/\s*\n\s*/g, " ").trim()).filter((p) => p && !/^#{1,6}\s/.test(p));
+}
+function measure(paragraph) {
+  const out = {};
+  for (const [k, v] of Object.entries(shapeOf(paragraph))) out[k] = typeof v === "boolean" ? v ? 1 : 0 : v;
+  for (const [k, v] of Object.entries(lexicalOf(paragraph))) out[k] = v;
+  for (const [k, v] of Object.entries(registerOf(paragraph))) out[k] = v;
+  return out;
+}
+var fmt = (x) => Math.abs(x) >= 10 ? x.toFixed(0) : x.toFixed(Math.abs(x) >= 1 ? 1 : 2);
+function checkRegister(text, id, profile) {
+  const reg = getRegister(id);
+  if (!reg) throw new Error(`unknown register "${id}"`);
+  const { baseline, note } = REGISTER_BASELINE[id];
+  const target2 = profile[baseline];
+  if (!target2) throw new Error(`no baseline profile for "${baseline}"`);
+  const kept = documentParagraphs(text).filter((p) => isBlurb(shapeOf(p)));
+  const base = { register: id, baseline, paragraphs: kept.length, note };
+  if (kept.length < MIN_PARAGRAPHS) {
+    return {
+      ...base,
+      measured: false,
+      means: {},
+      outside: [],
+      nearest: [],
+      summary: `Only ${kept.length} paragraph${kept.length === 1 ? "" : "s"} of 2 to 8 sentences. The registers overlap too much to place anything shorter than ${MIN_PARAGRAPHS}; read it against the brief instead.`
+    };
+  }
+  const rows = kept.map(measure);
+  const features = [...new Set(Object.values(profile).flatMap((p) => Object.keys(p)))];
+  const means = {};
+  for (const f4 of features) {
+    const xs = rows.map((r) => r[f4]).filter((x) => typeof x === "number" && Number.isFinite(x));
+    if (xs.length) means[f4] = xs.reduce((s, x) => s + x, 0) / xs.length;
+  }
+  const outside = [];
+  for (const [f4, b] of Object.entries(target2)) {
+    const v = means[f4];
+    if (v === void 0 || b.separates.length === 0 || !usable(f4, b)) continue;
+    if (v >= b.p10 && v <= b.p90) continue;
+    const direction = v > b.p90 ? "higher" : "lower";
+    outside.push({
+      feature: f4,
+      value: v,
+      band: [b.p10, b.p90],
+      direction,
+      sentence: `${featureLabel(f4)}: ${fmt(v)}. ${reg.name} writing in the baseline runs ${fmt(b.p10)} to ${fmt(b.p90)}, so this is ${direction}.`
+    });
+  }
+  const nearest2 = Object.entries(profile).map(([register, bands]) => {
+    const zs = Object.entries(bands).filter(([f4, b]) => means[f4] !== void 0 && b.sd > 0 && usable(f4, b)).map(([f4, b]) => ((means[f4] - b.p50) / b.sd) ** 2);
+    return { register, distance: zs.length ? Math.sqrt(zs.reduce((s, z) => s + z, 0) / zs.length) : Infinity };
+  }).filter((n) => Number.isFinite(n.distance)).sort((a, b) => a.distance - b.distance);
+  const closest = nearest2[0]?.register;
+  const summary = (outside.length === 0 ? `All ${Object.entries(target2).filter(([f4, b]) => b.separates.length && usable(f4, b)).length} measured features sit inside the usual range for ${reg.name.toLowerCase()} writing.` : `${outside.length} feature${outside.length === 1 ? "" : "s"} outside the usual range for ${reg.name.toLowerCase()} writing.`) + (closest && closest !== baseline ? ` It reads closest to the ${closest} baseline.` : "");
+  return { ...base, measured: true, means, outside, nearest: nearest2, summary };
+}
+
+// src/register/profile.ts
+var PROFILE_PARAGRAPHS = 5;
+var PROFILE_MEASURED = "2026-09-30";
+var PROFILE = {
+  "business-email": {
+    "clauseDepth": {
+      "p10": 0.36,
+      "p50": 0.673,
+      "p90": 1.113,
+      "sd": 0.307,
+      "separates": [
+        "explanatory",
+        "institutional",
+        "literary"
+      ]
+    },
+    "commasPer100": {
+      "p10": 1.424,
+      "p50": 3.19,
+      "p90": 5.154,
+      "sd": 1.529,
+      "separates": [
+        "institutional",
+        "literary"
+      ]
+    },
+    "commasPerSentence": {
+      "p10": 0.2,
+      "p50": 0.467,
+      "p90": 0.826,
+      "sd": 0.262,
+      "separates": [
+        "explanatory",
+        "institutional",
+        "literary",
+        "marketing"
+      ]
+    },
+    "coordinationRate": {
+      "p10": 0,
+      "p50": 0.743,
+      "p90": 1.712,
+      "sd": 0.666,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "figures": {
+      "p10": 0.2,
+      "p50": 0.8,
+      "p90": 1.8,
+      "sd": 0.725,
+      "separates": [
+        "literary"
+      ]
+    },
+    "firstPersonPer100": {
+      "p10": 3.718,
+      "p50": 5.968,
+      "p90": 8.375,
+      "sd": 1.825,
+      "separates": [
+        "explanatory"
+      ]
+    },
+    "generic": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0.2,
+      "sd": 0.138,
+      "separates": [
+        "explanatory"
+      ]
+    },
+    "hardPer100": {
+      "p10": 4.289,
+      "p50": 7.127,
+      "p90": 11.308,
+      "sd": 2.843,
+      "separates": [
+        "explanatory",
+        "institutional",
+        "literary"
+      ]
+    },
+    "impersonalOpenerShare": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0.067,
+      "sd": 0.031,
+      "separates": [
+        "explanatory"
+      ]
+    },
+    "meanSentenceWords": {
+      "p10": 11.417,
+      "p50": 14.25,
+      "p90": 17.87,
+      "sd": 2.656,
+      "separates": [
+        "explanatory",
+        "literary"
+      ]
+    },
+    "meanWordLength": {
+      "p10": 3.858,
+      "p50": 4.16,
+      "p90": 4.459,
+      "sd": 0.231,
+      "separates": [
+        "explanatory"
+      ]
+    },
+    "names": {
+      "p10": 1.2,
+      "p50": 2.4,
+      "p90": 3.6,
+      "sd": 0.965,
+      "separates": [
+        "explanatory",
+        "institutional"
+      ]
+    },
+    "nominalisationRate": {
+      "p10": 0.625,
+      "p50": 1.93,
+      "p90": 3.831,
+      "sd": 1.264,
+      "separates": [
+        "institutional",
+        "marketing"
+      ]
+    },
+    "participialRate": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0.05,
+      "sd": 0.035,
+      "separates": [
+        "literary"
+      ]
+    },
+    "pronounOpenerShare": {
+      "p10": 0,
+      "p50": 0.05,
+      "p90": 0.15,
+      "sd": 0.068,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "sentenceCv": {
+      "p10": 0.344,
+      "p50": 0.468,
+      "p90": 0.6,
+      "sd": 0.099,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "skeletonRepeat": {
+      "p10": 0,
+      "p50": 0.017,
+      "p90": 0.063,
+      "sd": 0.031,
+      "separates": [
+        "institutional"
+      ]
+    },
+    "specificsPer100": {
+      "p10": 4.22,
+      "p50": 7.34,
+      "p90": 11.46,
+      "sd": 2.892,
+      "separates": [
+        "explanatory",
+        "institutional",
+        "literary"
+      ]
+    },
+    "tradePer100": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0.588,
+      "sd": 0.287,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "tricolons": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0.2,
+      "sd": 0.142,
+      "separates": [
+        "institutional",
+        "literary",
+        "marketing"
+      ]
+    }
+  },
+  "explanatory": {
+    "clauseDepth": {
+      "p10": 0.78,
+      "p50": 1.194,
+      "p90": 1.733,
+      "sd": 0.383,
+      "separates": [
+        "business-email",
+        "literary"
+      ]
+    },
+    "commasPer100": {
+      "p10": 2.579,
+      "p50": 4.164,
+      "p90": 6.089,
+      "sd": 1.423,
+      "separates": [
+        "literary"
+      ]
+    },
+    "commasPerSentence": {
+      "p10": 0.448,
+      "p50": 0.77,
+      "p90": 1.2,
+      "sd": 0.309,
+      "separates": [
+        "business-email",
+        "literary"
+      ]
+    },
+    "coordinationRate": {
+      "p10": 0.323,
+      "p50": 0.973,
+      "p90": 1.862,
+      "sd": 0.612,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "figures": {
+      "p10": 0,
+      "p50": 0.4,
+      "p90": 1.4,
+      "sd": 0.631,
+      "separates": [
+        "literary"
+      ]
+    },
+    "firstPersonPer100": {
+      "p10": 0.27,
+      "p50": 1.282,
+      "p90": 3.114,
+      "sd": 1.181,
+      "separates": [
+        "business-email",
+        "literary"
+      ]
+    },
+    "generic": {
+      "p10": 0,
+      "p50": 0.4,
+      "p90": 0.6,
+      "sd": 0.214,
+      "separates": [
+        "business-email",
+        "institutional"
+      ]
+    },
+    "hardPer100": {
+      "p10": 0.988,
+      "p50": 2.62,
+      "p90": 5.171,
+      "sd": 1.713,
+      "separates": [
+        "business-email",
+        "institutional",
+        "marketing"
+      ]
+    },
+    "impersonalOpenerShare": {
+      "p10": 0,
+      "p50": 0.04,
+      "p90": 0.14,
+      "sd": 0.061,
+      "separates": [
+        "business-email"
+      ]
+    },
+    "meanSentenceWords": {
+      "p10": 14.973,
+      "p50": 18.31,
+      "p90": 22.533,
+      "sd": 3.013,
+      "separates": [
+        "business-email"
+      ]
+    },
+    "meanWordLength": {
+      "p10": 4.207,
+      "p50": 4.466,
+      "p90": 4.752,
+      "sd": 0.213,
+      "separates": [
+        "business-email",
+        "literary"
+      ]
+    },
+    "names": {
+      "p10": 0.4,
+      "p50": 1.2,
+      "p90": 2.6,
+      "sd": 0.941,
+      "separates": [
+        "business-email",
+        "institutional"
+      ]
+    },
+    "nominalisationRate": {
+      "p10": 0.766,
+      "p50": 1.823,
+      "p90": 3.416,
+      "sd": 1.061,
+      "separates": [
+        "institutional",
+        "marketing"
+      ]
+    },
+    "participialRate": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0.1,
+      "sd": 0.045,
+      "separates": []
+    },
+    "pronounOpenerShare": {
+      "p10": 0,
+      "p50": 0.033,
+      "p90": 0.124,
+      "sd": 0.056,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "sentenceCv": {
+      "p10": 0.337,
+      "p50": 0.441,
+      "p90": 0.57,
+      "sd": 0.092,
+      "separates": []
+    },
+    "skeletonRepeat": {
+      "p10": 9e-3,
+      "p50": 0.039,
+      "p90": 0.091,
+      "sd": 0.036,
+      "separates": []
+    },
+    "specificsPer100": {
+      "p10": 1.04,
+      "p50": 2.7,
+      "p90": 5.36,
+      "sd": 1.731,
+      "separates": [
+        "business-email",
+        "institutional",
+        "marketing"
+      ]
+    },
+    "tradePer100": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0.427,
+      "sd": 0.216,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "tricolons": {
+      "p10": 0,
+      "p50": 0.2,
+      "p90": 0.6,
+      "sd": 0.222,
+      "separates": []
+    }
+  },
+  "institutional": {
+    "clauseDepth": {
+      "p10": 0.792,
+      "p50": 1.233,
+      "p90": 1.76,
+      "sd": 0.377,
+      "separates": [
+        "business-email",
+        "literary"
+      ]
+    },
+    "commasPer100": {
+      "p10": 3.03,
+      "p50": 4.435,
+      "p90": 5.941,
+      "sd": 1.165,
+      "separates": [
+        "business-email",
+        "literary"
+      ]
+    },
+    "commasPerSentence": {
+      "p10": 0.61,
+      "p50": 0.96,
+      "p90": 1.375,
+      "sd": 0.307,
+      "separates": [
+        "business-email",
+        "literary"
+      ]
+    },
+    "coordinationRate": {
+      "p10": 0.323,
+      "p50": 0.949,
+      "p90": 1.752,
+      "sd": 0.559,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "figures": {
+      "p10": 0,
+      "p50": 0.6,
+      "p90": 1.4,
+      "sd": 0.56,
+      "separates": [
+        "literary"
+      ]
+    },
+    "generic": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0.2,
+      "sd": 0.114,
+      "separates": [
+        "explanatory",
+        "literary",
+        "marketing"
+      ]
+    },
+    "hardPer100": {
+      "p10": 3.41,
+      "p50": 5.135,
+      "p90": 7.304,
+      "sd": 1.573,
+      "separates": [
+        "business-email",
+        "explanatory",
+        "literary"
+      ]
+    },
+    "impersonalOpenerShare": {
+      "p10": 0,
+      "p50": 0.033,
+      "p90": 0.109,
+      "sd": 0.051,
+      "separates": []
+    },
+    "names": {
+      "p10": 2,
+      "p50": 3.2,
+      "p90": 4.8,
+      "sd": 1.113,
+      "separates": [
+        "business-email",
+        "explanatory",
+        "literary",
+        "marketing"
+      ]
+    },
+    "nominalisationRate": {
+      "p10": 1.992,
+      "p50": 3.391,
+      "p90": 5.008,
+      "sd": 1.147,
+      "separates": [
+        "business-email",
+        "explanatory",
+        "literary"
+      ]
+    },
+    "participialRate": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0.1,
+      "sd": 0.044,
+      "separates": [
+        "literary"
+      ]
+    },
+    "pronounOpenerShare": {
+      "p10": 0,
+      "p50": 0.05,
+      "p90": 0.164,
+      "sd": 0.068,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "sentenceCv": {
+      "p10": 0.386,
+      "p50": 0.512,
+      "p90": 0.639,
+      "sd": 0.097,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "skeletonRepeat": {
+      "p10": 0.018,
+      "p50": 0.048,
+      "p90": 0.087,
+      "sd": 0.028,
+      "separates": [
+        "business-email"
+      ]
+    },
+    "specificsPer100": {
+      "p10": 3.36,
+      "p50": 5.2,
+      "p90": 7.4,
+      "sd": 1.612,
+      "separates": [
+        "business-email",
+        "explanatory",
+        "literary"
+      ]
+    },
+    "tradePer100": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0.157,
+      "sd": 0.101,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "tricolons": {
+      "p10": 0,
+      "p50": 0.2,
+      "p90": 0.6,
+      "sd": 0.233,
+      "separates": [
+        "business-email"
+      ]
+    }
+  },
+  "literary": {
+    "clauseDepth": {
+      "p10": 1.333,
+      "p50": 2.017,
+      "p90": 2.933,
+      "sd": 0.626,
+      "separates": [
+        "business-email",
+        "explanatory",
+        "institutional",
+        "marketing"
+      ]
+    },
+    "commasPer100": {
+      "p10": 5.997,
+      "p50": 8.1,
+      "p90": 10.586,
+      "sd": 1.815,
+      "separates": [
+        "business-email",
+        "explanatory",
+        "institutional",
+        "marketing"
+      ]
+    },
+    "commasPerSentence": {
+      "p10": 1.067,
+      "p50": 1.667,
+      "p90": 2.435,
+      "sd": 0.541,
+      "separates": [
+        "business-email",
+        "explanatory",
+        "institutional",
+        "marketing"
+      ]
+    },
+    "coordinationRate": {
+      "p10": 0.194,
+      "p50": 0.814,
+      "p90": 1.633,
+      "sd": 0.572,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "figures": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0,
+      "sd": 0.079,
+      "separates": [
+        "business-email",
+        "explanatory",
+        "institutional",
+        "marketing"
+      ]
+    },
+    "firstPersonPer100": {
+      "p10": 2.207,
+      "p50": 4.67,
+      "p90": 7.486,
+      "sd": 2.027,
+      "separates": [
+        "explanatory"
+      ]
+    },
+    "generic": {
+      "p10": 0,
+      "p50": 0.2,
+      "p90": 0.4,
+      "sd": 0.178,
+      "separates": [
+        "institutional"
+      ]
+    },
+    "hardPer100": {
+      "p10": 1.632,
+      "p50": 3.076,
+      "p90": 5.154,
+      "sd": 1.367,
+      "separates": [
+        "business-email",
+        "institutional"
+      ]
+    },
+    "impersonalOpenerShare": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0.067,
+      "sd": 0.039,
+      "separates": []
+    },
+    "meanSentenceWords": {
+      "p10": 15.083,
+      "p50": 20.35,
+      "p90": 27.027,
+      "sd": 4.744,
+      "separates": [
+        "business-email"
+      ]
+    },
+    "meanWordLength": {
+      "p10": 3.958,
+      "p50": 4.186,
+      "p90": 4.409,
+      "sd": 0.175,
+      "separates": [
+        "explanatory"
+      ]
+    },
+    "names": {
+      "p10": 1,
+      "p50": 1.8,
+      "p90": 3,
+      "sd": 0.816,
+      "separates": [
+        "institutional"
+      ]
+    },
+    "nominalisationRate": {
+      "p10": 0.444,
+      "p50": 1.334,
+      "p90": 2.486,
+      "sd": 0.817,
+      "separates": [
+        "institutional",
+        "marketing"
+      ]
+    },
+    "participialRate": {
+      "p10": 0,
+      "p50": 0.067,
+      "p90": 0.2,
+      "sd": 0.089,
+      "separates": [
+        "business-email",
+        "institutional"
+      ]
+    },
+    "pronounOpenerShare": {
+      "p10": 0,
+      "p50": 0.025,
+      "p90": 0.12,
+      "sd": 0.058,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "sentenceCv": {
+      "p10": 0.367,
+      "p50": 0.485,
+      "p90": 0.625,
+      "sd": 0.1,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "skeletonRepeat": {
+      "p10": 5e-3,
+      "p50": 0.029,
+      "p90": 0.07,
+      "sd": 0.028,
+      "separates": []
+    },
+    "specificsPer100": {
+      "p10": 1.8,
+      "p50": 3.28,
+      "p90": 5.24,
+      "sd": 1.365,
+      "separates": [
+        "business-email",
+        "institutional",
+        "marketing"
+      ]
+    },
+    "tradePer100": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0.508,
+      "sd": 0.275,
+      "separates": [
+        "marketing"
+      ]
+    },
+    "tricolons": {
+      "p10": 0,
+      "p50": 0.4,
+      "p90": 0.8,
+      "sd": 0.314,
+      "separates": [
+        "business-email"
+      ]
+    }
+  },
+  "marketing": {
+    "clauseDepth": {
+      "p10": 0.567,
+      "p50": 0.967,
+      "p90": 1.56,
+      "sd": 0.413,
+      "separates": [
+        "literary"
+      ]
+    },
+    "commasPer100": {
+      "p10": 2.169,
+      "p50": 4.087,
+      "p90": 6.434,
+      "sd": 1.667,
+      "separates": [
+        "literary"
+      ]
+    },
+    "commasPerSentence": {
+      "p10": 0.4,
+      "p50": 0.8,
+      "p90": 1.35,
+      "sd": 0.402,
+      "separates": [
+        "business-email",
+        "literary"
+      ]
+    },
+    "coordinationRate": {
+      "p10": 1.087,
+      "p50": 2.236,
+      "p90": 3.473,
+      "sd": 0.931,
+      "separates": [
+        "business-email",
+        "explanatory",
+        "institutional",
+        "literary"
+      ]
+    },
+    "figures": {
+      "p10": 0,
+      "p50": 0.4,
+      "p90": 1,
+      "sd": 0.427,
+      "separates": [
+        "literary"
+      ]
+    },
+    "generic": {
+      "p10": 0,
+      "p50": 0.2,
+      "p90": 0.6,
+      "sd": 0.206,
+      "separates": [
+        "institutional"
+      ]
+    },
+    "hardPer100": {
+      "p10": 1.899,
+      "p50": 4.549,
+      "p90": 8.227,
+      "sd": 2.655,
+      "separates": [
+        "explanatory"
+      ]
+    },
+    "impersonalOpenerShare": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0.1,
+      "sd": 0.047,
+      "separates": []
+    },
+    "names": {
+      "p10": 0.6,
+      "p50": 1.8,
+      "p90": 3.4,
+      "sd": 1.21,
+      "separates": [
+        "institutional"
+      ]
+    },
+    "nominalisationRate": {
+      "p10": 1.576,
+      "p50": 3.222,
+      "p90": 5.534,
+      "sd": 1.6,
+      "separates": [
+        "business-email",
+        "explanatory",
+        "literary"
+      ]
+    },
+    "participialRate": {
+      "p10": 0,
+      "p50": 0,
+      "p90": 0.133,
+      "sd": 0.062,
+      "separates": []
+    },
+    "pronounOpenerShare": {
+      "p10": 0.067,
+      "p50": 0.213,
+      "p90": 0.4,
+      "sd": 0.136,
+      "separates": [
+        "business-email",
+        "explanatory",
+        "institutional",
+        "literary"
+      ]
+    },
+    "sentenceCv": {
+      "p10": 0.275,
+      "p50": 0.377,
+      "p90": 0.52,
+      "sd": 0.096,
+      "separates": [
+        "business-email",
+        "institutional",
+        "literary"
+      ]
+    },
+    "skeletonRepeat": {
+      "p10": 0,
+      "p50": 0.031,
+      "p90": 0.081,
+      "sd": 0.038,
+      "separates": []
+    },
+    "specificsPer100": {
+      "p10": 2.54,
+      "p50": 5.2,
+      "p90": 9.18,
+      "sd": 2.733,
+      "separates": [
+        "explanatory",
+        "literary"
+      ]
+    },
+    "tradePer100": {
+      "p10": 0,
+      "p50": 0.592,
+      "p90": 1.515,
+      "sd": 0.612,
+      "separates": [
+        "business-email",
+        "explanatory",
+        "institutional",
+        "literary"
+      ]
+    },
+    "tricolons": {
+      "p10": 0,
+      "p50": 0.4,
+      "p90": 0.8,
+      "sd": 0.309,
+      "separates": [
+        "business-email"
+      ]
+    }
+  }
+};
+
 // src/character/baseline.ts
 var BASELINE_VERSION = 1;
 function fnv1a(text) {
@@ -7551,10 +8815,11 @@ function choiceOfShared(part) {
 }
 
 // src/calibrate/index.ts
-var LABELS = ["ai", "ai-looking", "human"];
+var LABELS2 = ["ai", "ai-looking", "human"];
 var FLAGGED_TARGET = 0.9;
 var HUMAN_TYPICAL_TARGET = 0.1;
 var SURFACE = new Map(CATALOGUE.map((t) => [t.id, t.surface]));
+var GENERATION = new Map(CATALOGUE.map((t) => [t.id, t.generation]));
 function designTells(tells) {
   return tells.filter((t) => SURFACE.has(t) && SURFACE.get(t) !== "copy");
 }
@@ -7583,15 +8848,15 @@ function flaggedTarget(target2, s, missing) {
 }
 function calibrate(pages, unmeasured = []) {
   const typicality2 = pages.length > 0 && pages.every((p) => p.typicality !== void 0);
-  const labels = LABELS.map((l) => summarise(l, pages, typicality2));
+  const labels = LABELS2.map((l) => summarise(l, pages, typicality2));
   const byLabel = Object.fromEntries(labels.map((s) => [s.label, s]));
   const missing = (l) => unmeasured.filter((u) => u.label === l).length;
   const positives = pages.filter((p) => positive(p.label)).length;
   const fired = new Set(pages.flatMap((p) => p.tells));
   const tells = [...fired].map((tell) => {
-    const hits = Object.fromEntries(LABELS.map((l) => [l, pages.filter((p) => p.label === l && p.tells.includes(tell)).length]));
+    const hits = Object.fromEntries(LABELS2.map((l) => [l, pages.filter((p) => p.label === l && p.tells.includes(tell)).length]));
     const on = hits.ai + hits["ai-looking"];
-    return { tell, hits, precision: round2(on / (on + hits.human)), recall: positives ? round2(on / positives) : null };
+    return { tell, generation: GENERATION.get(tell) ?? null, hits, precision: round2(on / (on + hits.human)), recall: positives ? round2(on / positives) : null };
   }).sort((a, b) => b.hits.ai + b.hits["ai-looking"] + b.hits.human - (a.hits.ai + a.hits["ai-looking"] + a.hits.human) || a.tell.localeCompare(b.tell));
   const human = byLabel.human;
   const humanNote = missing("human") ? `; ${missing("human")} not measured, counted neither way` : "";
@@ -7623,18 +8888,18 @@ function formatCalibration(c, notes = []) {
     lines.push("", `Not measured: ${c.unmeasured.length}. A page not measured never counts as a pass.`);
     for (const u of c.unmeasured) lines.push(`  ${u.id} (${u.label}): ${u.reason}`);
   }
-  lines.push("", "Targets");
+  lines.push("", "Flagged is a look-closer signal, not a verdict that a site is AI-made. Nothing gates on it.", "", "Targets");
   for (const t of c.targets) lines.push(`  ${t.target.padEnd(50)} ${t.met === null ? "not known" : t.met ? "met" : "NOT MET"}`, `    ${t.detail}`);
   lines.push("", `  ${"label".padEnd(11)} ${"pages".padStart(5)} ${"flagged".padStart(8)} ${"typical".padStart(8)} ${"tell-heavy".padStart(11)} ${"blocking".padStart(9)}`);
   for (const s of c.labels) {
     lines.push(`  ${s.label.padEnd(11)} ${String(s.pages).padStart(5)} ${String(s.flagged).padStart(8)} ${String(s.typical ?? "-").padStart(8)} ${String(s.tellHeavy).padStart(11)} ${String(s.blocking).padStart(9)}`);
   }
   lines.push("", "Per tell. A hit on ai or ai-looking counts for the tell; a hit on human counts against it.");
-  lines.push(`  ${"tell".padEnd(28)} ${"ai".padStart(7)} ${"ai-looking".padStart(10)} ${"human".padStart(7)} ${"precision".padStart(9)} ${"recall".padStart(7)}`);
+  lines.push(`  ${"tell".padEnd(28)} ${"gen".padStart(3)} ${"ai".padStart(7)} ${"ai-looking".padStart(10)} ${"human".padStart(7)} ${"precision".padStart(9)} ${"recall".padStart(7)}`);
   const of = (l) => c.labels.find((s) => s.label === l)?.pages ?? 0;
   for (const t of c.tells) {
     lines.push(
-      `  ${t.tell.padEnd(28)} ${`${t.hits.ai}/${of("ai")}`.padStart(7)} ${`${t.hits["ai-looking"]}/${of("ai-looking")}`.padStart(10)} ${`${t.hits.human}/${of("human")}`.padStart(7)} ${t.precision.toFixed(2).padStart(9)} ${(t.recall === null ? "-" : t.recall.toFixed(2)).padStart(7)}`
+      `  ${t.tell.padEnd(28)} ${String(t.generation ?? "-").padStart(3)} ${`${t.hits.ai}/${of("ai")}`.padStart(7)} ${`${t.hits["ai-looking"]}/${of("ai-looking")}`.padStart(10)} ${`${t.hits.human}/${of("human")}`.padStart(7)} ${t.precision.toFixed(2).padStart(9)} ${(t.recall === null ? "-" : t.recall.toFixed(2)).padStart(7)}`
     );
   }
   if (!c.tells.length) lines.push("  no tell fired");
@@ -7763,6 +9028,7 @@ export {
   CHOICE_KEYS,
   COMPONENT_ROLES,
   CONSIDERATION,
+  CONTENT_FEATURES,
   CONVENTION,
   CUSTOMER_KINDS,
   DEFAULT_IGNORE,
@@ -7793,11 +9059,12 @@ export {
   HUMAN_TYPICAL_TARGET,
   IMAGERY_TELLS,
   JSON_SCHEMA_VERSION,
-  LABELS,
+  LABELS2 as LABELS,
   LEXICAL_FEATURES,
   LICENCES,
   LIGHTNESS_CURVE,
   MIN_DECIDED,
+  MIN_PARAGRAPHS,
   MIN_RUNS,
   MOOD,
   NEGATIVE_REASSURANCE,
@@ -7806,6 +9073,9 @@ export {
   PILL_LIMIT,
   PLAINER_WORDS,
   PREFERENCE,
+  PROFILE,
+  PROFILE_MEASURED,
+  PROFILE_PARAGRAPHS,
   PROMO_BADGE,
   PROOF_NAMES,
   PROPOSED,
@@ -7814,6 +9084,10 @@ export {
   READABLE_SNAPSHOT_VERSIONS,
   REFLEX_FONTS_1,
   REFLEX_FONTS_2,
+  REGISTERS,
+  REGISTER_BASELINE,
+  REGISTER_FEATURES,
+  REGISTER_IDS,
   RENDERED_PATHS,
   RENDERED_TELLS,
   REVEAL_LIMIT,
@@ -7856,6 +9130,7 @@ export {
   checkOrder,
   checkPair,
   checkReason,
+  checkRegister,
   checkRestraint,
   choicesOf,
   clauseDepth,
@@ -7880,6 +9155,7 @@ export {
   densityCss,
   densityTokens,
   designTells,
+  documentParagraphs,
   emitCss,
   emptyEstate,
   estateComponentPairs,
@@ -7887,6 +9163,7 @@ export {
   exitDuration,
   extractHtml,
   faceLicence,
+  featureLabel,
   findClaims,
   findColours,
   findingKey,
@@ -7903,6 +9180,7 @@ export {
   formatDirectionMatches,
   formatHex,
   formatReport,
+  getRegister,
   globToRegExp,
   groundName,
   harvest,
@@ -7949,6 +9227,9 @@ export {
   ramp,
   rampFromAnchors,
   readSnapshot,
+  registerBrief,
+  registerOf,
+  registersDoc,
   renderedOrder,
   researchPrompt,
   retrofitPlan,