@domandigital/craft 0.15.0 → 0.16.0

package/dist/index.js

@@ -757,10 +757,10 @@ function stripLayers(css, ignored) {
   const names = new Set(ignored.map((n) => n.trim().toLowerCase()));
   let out = "";
   let i = 0;
-  const pattern = /@layer\s+([a-zA-Z0-9_-]+)\s*\{/gi;
+  const pattern2 = /@layer\s+([a-zA-Z0-9_-]+)\s*\{/gi;
   while (i < css.length) {
-    pattern.lastIndex = i;
-    const match = pattern.exec(css);
+    pattern2.lastIndex = i;
+    const match = pattern2.exec(css);
     if (match === null) {
       out += css.slice(i);
       break;
@@ -790,12 +790,12 @@ var CSS_WIDE_KEYWORDS = /* @__PURE__ */ new Set([
 ]);
 function atRuleBodies(css, prelude) {
   const out = [];
-  const pattern = new RegExp(
+  const pattern2 = new RegExp(
     prelude.source,
     prelude.flags.includes("g") ? prelude.flags : `${prelude.flags}g`
   );
   let match;
-  while ((match = pattern.exec(css)) !== null) {
+  while ((match = pattern2.exec(css)) !== null) {
     const start = match.index + match[0].length;
     let depth = 1;
     let i = start;
@@ -805,7 +805,7 @@ function atRuleBodies(css, prelude) {
       i += 1;
     }
     out.push(css.slice(start, i - 1));
-    pattern.lastIndex = i;
+    pattern2.lastIndex = i;
   }
   return out;
 }
@@ -838,9 +838,9 @@ function isVarOnlyList(value) {
   return parts2.length > 1 && parts2.every((part) => /^\s*var\(\s*--[\w-]+\s*\)\s*$/.test(part));
 }
 function distinctValues(css, property, props, unresolved) {
-  const pattern = new RegExp(`(?:^|[;{\\s])${property}\\s*:\\s*([^;}]+)`, "gi");
+  const pattern2 = new RegExp(`(?:^|[;{\\s])${property}\\s*:\\s*([^;}]+)`, "gi");
   const seen = /* @__PURE__ */ new Set();
-  for (const match of css.matchAll(pattern)) {
+  for (const match of css.matchAll(pattern2)) {
     const raw = match[1].trim().replace(/\s+/g, " ").toLowerCase();
     if (CSS_WIDE_KEYWORDS.has(raw)) continue;
     const value = unwrapShadowColor(raw);
@@ -1259,14 +1259,14 @@ function linkSpans(text) {
   return [...text.matchAll(LINK)].map((m) => [m.index ?? 0, (m.index ?? 0) + m[0].length]);
 }
 var insideLink = (spans, at) => spans.some(([a, b]) => at >= a && at < b);
-function phrases(patterns, label, source = (ctx) => ctx.blocks, skip = () => false) {
+function phrases(patterns2, label, source = (ctx) => ctx.blocks, skip = () => false) {
   return (ctx) => {
     const hits = [];
     for (const block of source(ctx)) {
       const spans = [];
       const links = linkSpans(block.text);
-      for (const pattern of patterns) {
-        const global = new RegExp(pattern.source, pattern.flags.includes("g") ? pattern.flags : `${pattern.flags}g`);
+      for (const pattern2 of patterns2) {
+        const global = new RegExp(pattern2.source, pattern2.flags.includes("g") ? pattern2.flags : `${pattern2.flags}g`);
         for (const m of block.text.matchAll(global)) {
           if (skip(block, m[0], m.index ?? 0)) continue;
           if (insideLink(links, m.index ?? 0)) continue;
@@ -2653,11 +2653,11 @@ function baseClass(cls) {
 function bases(unit) {
   return unit.classes.map(baseClass);
 }
-function has(unit, pattern) {
-  return bases(unit).some((c) => pattern.test(c));
+function has(unit, pattern2) {
+  return bases(unit).some((c) => pattern2.test(c));
 }
-function find(unit, pattern) {
-  return bases(unit).find((c) => pattern.test(c));
+function find(unit, pattern2) {
+  return bases(unit).find((c) => pattern2.test(c));
 }
 function arbitrary(cls) {
   const m = cls.match(/\[(.*)\]$/);
@@ -2673,9 +2673,9 @@ function eachUnit(ctx, fn) {
   }
   return hits;
 }
-function firstMatch(text, pattern) {
-  const m = pattern.exec(text);
-  pattern.lastIndex = 0;
+function firstMatch(text, pattern2) {
+  const m = pattern2.exec(text);
+  pattern2.lastIndex = 0;
   return m ? m.index : -1;
 }
 var FRAMEWORK_PALETTE = /^--(?:color-)?(?:slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-\d+$|^--tw-/;
@@ -3119,9 +3119,9 @@ function shadcnCardHits(ctx) {
 }
 function marqueeHits(ctx) {
   const hits = [];
-  const pattern = /@keyframes\s+[\w-]*marquee|animate-(?:marquee|scroll-x|infinite-scroll)\b|<Marquee\b|["']react-fast-marquee["']|ui\/marquee["']|animation(?:-name)?\s*:\s*[^;]*marquee/i;
+  const pattern2 = /@keyframes\s+[\w-]*marquee|animate-(?:marquee|scroll-x|infinite-scroll)\b|<Marquee\b|["']react-fast-marquee["']|ui\/marquee["']|animation(?:-name)?\s*:\s*[^;]*marquee/i;
   for (const file of ctx.files) {
-    const at = firstMatch(file.text, pattern);
+    const at = firstMatch(file.text, pattern2);
     if (at !== -1) hits.push({ path: file.path, offset: at, message: "scrolling marquee" });
   }
   return hits;
@@ -3963,8 +3963,8 @@ function protectedFacts(text) {
   const mask = (start, length) => {
     rest = rest.slice(0, start) + " ".repeat(length) + rest.slice(start + length);
   };
-  for (const [kind, pattern] of PATTERNS) {
-    for (const m of [...rest.matchAll(pattern)]) {
+  for (const [kind, pattern2] of PATTERNS) {
+    for (const m of [...rest.matchAll(pattern2)]) {
       const value = m[0].replace(/[.,;:]+$/, "");
       facts.push({ kind, value, key: `${kind}:${normalise(kind, value)}` });
       mask(m.index ?? 0, m[0].length);
@@ -4290,7 +4290,7 @@ function side(page, other, brief) {
 function compareCompetitor(ours, competitor, brief) {
   return { ours: side(ours, competitor, brief), competitor: side(competitor, ours, brief), brief: Boolean(brief) };
 }
-var pctOf = (share) => share === null ? "no sentences" : `${Math.round(share * 100)}%`;
+var pctOf = (share2) => share2 === null ? "no sentences" : `${Math.round(share2 * 100)}%`;
 function formatCompetitor(result) {
   const row = (label, s) => `    ${label.padEnd(11)} ${s.interchangeable.length} of ${s.sentences} (${pctOf(s.share)}), ${s.perHundred} specifics per 100 words`;
   const lines = [
@@ -4666,11 +4666,11 @@ function reflexFonts(list) {
     for (const font of s.fonts) {
       const name = wanted.get(normaliseFamily(font.family).toLowerCase());
       if (!name || seen.has(name)) continue;
-      const share = font.chars / total;
+      const share2 = font.chars / total;
       const displayShare = font.displayChars / display;
-      if (share >= 0.15 || displayShare >= 0.3) {
+      if (share2 >= 0.15 || displayShare >= 0.3) {
         seen.add(name);
-        hits.push(hit(s, `${name} sets ${pct(share)} of the text on the page${displayShare >= 0.3 ? ` and ${pct(displayShare)} of the headings` : ""}`));
+        hits.push(hit(s, `${name} sets ${pct(share2)} of the text on the page${displayShare >= 0.3 ? ` and ${pct(displayShare)} of the headings` : ""}`));
       }
     }
     return hits;
@@ -5873,8 +5873,8 @@ var IMPERATIVE = /^(?:Add|Use|Check|Make|Get|Set|Include|Create|Update|List|Keep
 var atStart = (sentence, index) => /^[\s*_"“”’(>#|-]*(?:\d{1,3}[.)]\s*)?[\s*_]*(?:[\w ]+:\**\s*)?$/.test(sentence.slice(0, index)) || /\|\s*\**$/.test(sentence.slice(0, index));
 function namedSources(sentence) {
   const found = /* @__PURE__ */ new Set();
-  ATTRIBUTION.forEach((pattern, i) => {
-    for (const m of sentence.matchAll(pattern)) {
+  ATTRIBUTION.forEach((pattern2, i) => {
+    for (const m of sentence.matchAll(pattern2)) {
       const raw = m[1].trim();
       const word = !/\s/.test(raw) && !/[’']s$/.test(m[0].split(/\s+/)[0]);
       if (i === 2 && word && atStart(sentence, m.index ?? 0)) continue;
@@ -6118,7 +6118,7 @@ function shapeOf(text) {
   const ss = splitSentences(text);
   const wordCount = words(text).length;
   const per100 = (n) => wordCount === 0 ? 0 : 100 * n / wordCount;
-  const share = (re) => ss.length === 0 ? 0 : ss.filter((s) => re.test(s)).length / ss.length;
+  const share2 = (re) => ss.length === 0 ? 0 : ss.filter((s) => re.test(s)).length / ss.length;
   const tri = ss.flatMap(tricolons);
   const commas = (text.match(/,/g) ?? []).length;
   return {
@@ -6132,9 +6132,9 @@ function shapeOf(text) {
     hedgeRate: per100(hedgeCount(text)),
     hedgedClose: hedgedClose(ss),
     nominalisationRate: per100(nominalisations(text)),
-    pronounOpenerShare: share(PRONOUN_OPENER),
-    transitionOpenerShare: share(TRANSITION_OPENER),
-    impersonalOpenerShare: share(IMPERSONAL_OPENER),
+    pronounOpenerShare: share2(PRONOUN_OPENER),
+    transitionOpenerShare: share2(TRANSITION_OPENER),
+    impersonalOpenerShare: share2(IMPERSONAL_OPENER),
     commasPerSentence: ss.length === 0 ? 0 : commas / ss.length,
     commasPer100: per100(commas),
     participialRate: ss.length === 0 ? 0 : ss.reduce((s, x) => s + participialClauses(x), 0) / ss.length,
@@ -6161,6 +6161,89 @@ function isBlurb(f4) {
   return f4.sentences >= 2 && f4.sentences <= 8 && f4.words >= 20 && f4.words <= 160;
 }
 
+// src/character/lexical.ts
+var JUZEK = "Juzek and Ward, arXiv:2412.11385, Appendix A (PubMed abstracts, 2020 to 2024)";
+var STUDY_WORDS = [
+  "delves",
+  "delved",
+  "delving",
+  "delve",
+  "showcasing",
+  "boasts",
+  "underscores",
+  "underscoring",
+  "comprehending",
+  "intricacies",
+  "surpassing",
+  "intricate"
+].map((word) => ({ word, source: JUZEK }));
+function vocabulary() {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  const add = (word, source) => {
+    const w = word.toLowerCase();
+    if (seen.has(w)) return;
+    seen.add(w);
+    out.push({ word: w, source });
+  };
+  for (const s of STUDY_WORDS) add(s.word, s.source);
+  for (const w of AI_WORDS) add(w, "AI_WORDS");
+  for (const w of PLAINER_WORDS) add(w, "PLAINER_WORDS");
+  for (const w of AI_PHRASES) add(w, "AI_PHRASES");
+  for (const w of STOCK_PHRASES) add(w, "STOCK_PHRASES");
+  for (const w of BUZZWORDS) add(w, "BUZZWORDS");
+  return out;
+}
+var escape4 = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var pattern = (w) => new RegExp(`(?<![\\w-])${escape4(w).replace(/\s+/g, "\\s+")}(?![\\w-])`, "gi");
+var compiled = null;
+var patterns = () => compiled ?? (compiled = vocabulary().map((v) => ({ ...v, re: pattern(v.word) })));
+var plain = (text) => text.replace(/[’‘]/g, "'").replace(/\s+/g, " ");
+function vocabularyCounts(text) {
+  const t = plain(text);
+  const out = /* @__PURE__ */ new Map();
+  for (const { word, re } of patterns()) {
+    const n = (t.match(re) ?? []).length;
+    if (n) out.set(word, n);
+  }
+  return out;
+}
+var LEXICAL_FEATURES = [
+  "listRate",
+  "studyRate",
+  "hardPer100",
+  "tradePer100",
+  "specificsPer100",
+  "generic",
+  "figures",
+  "names"
+];
+var STUDY = new Set(STUDY_WORDS.map((s) => s.word));
+var LISTED = new Set([...AI_WORDS, ...PLAINER_WORDS, ...AI_PHRASES, ...STOCK_PHRASES, ...BUZZWORDS].map((w) => w.toLowerCase()));
+var r3 = (n) => Math.round(n * 1e3) / 1e3;
+function lexicalOf(text, brief) {
+  const words3 = Math.max(1, countWords2(text));
+  const counts = vocabularyCounts(text);
+  let list = 0;
+  let study = 0;
+  for (const [w, n] of counts) {
+    if (STUDY.has(w)) study += n;
+    if (LISTED.has(w)) list += n;
+  }
+  const s = specificity(text, brief);
+  const kind = (...k) => s.specifics.filter((x) => k.includes(x.kind)).length;
+  return {
+    listRate: r3(list / words3 * 100),
+    studyRate: r3(study / words3 * 100),
+    hardPer100: r3(s.hard / words3 * 100),
+    tradePer100: r3(s.trade / words3 * 100),
+    specificsPer100: r3(s.perHundred),
+    generic: s.generic ? 1 : 0,
+    figures: kind("money", "date", "time", "number"),
+    names: kind("name", "brief")
+  };
+}
+
 // src/character/baseline.ts
 var BASELINE_VERSION = 1;
 function fnv1a(text) {
@@ -6261,23 +6344,23 @@ function parseCraftConfig(data, knownTells, source = "craft.config.json") {
   return { ignore, severity, ...data.copyPaths ? { copyPaths: data.copyPaths } : {} };
 }
 function globToRegExp(glob) {
-  const pattern = glob.replace(/^\.\//, "").replace(/\/$/, "").replace(/\/\*\*$/, "");
+  const pattern2 = glob.replace(/^\.\//, "").replace(/\/$/, "").replace(/\/\*\*$/, "");
   let body = "";
-  for (let i = 0; i < pattern.length; i += 1) {
-    const c = pattern[i];
-    if (c === "*" && pattern[i + 1] === "*") {
-      const slash = pattern[i + 2] === "/";
+  for (let i = 0; i < pattern2.length; i += 1) {
+    const c = pattern2[i];
+    if (c === "*" && pattern2[i + 1] === "*") {
+      const slash = pattern2[i + 2] === "/";
       body += slash ? "(?:.*/)?" : ".*";
       i += slash ? 2 : 1;
     } else if (c === "*") body += "[^/]*";
     else if (c === "?") body += "[^/]";
     else body += c.replace(/[.+^${}()|[\]\\]/g, "\\$&");
   }
-  const anywhere = !pattern.includes("/");
+  const anywhere = !pattern2.includes("/");
   return new RegExp(`^${anywhere ? "(?:.*/)?" : ""}${body}(?:/.*)?$`);
 }
-function ignoreMatcher(patterns) {
-  const res = patterns.map(globToRegExp);
+function ignoreMatcher(patterns2) {
+  const res = patterns2.map(globToRegExp);
   return (path) => {
     const p = path.replace(/\\/g, "/").replace(/^\.\//, "");
     return res.some((re) => re.test(p));
@@ -6444,11 +6527,11 @@ function visualMeasures(img, maxSamples = 1e6) {
   const sdRg = Math.sqrt(Math.max(0, sumRg2 / n - meanRg * meanRg));
   const sdYb = Math.sqrt(Math.max(0, sumYb2 / n - meanYb * meanYb));
   const colourfulness = Math.sqrt(sdRg ** 2 + sdYb ** 2) + 0.3 * Math.sqrt(meanRg ** 2 + meanYb ** 2);
-  const round2 = (v, d = 3) => Math.round(v * 10 ** d) / 10 ** d;
+  const round3 = (v, d = 3) => Math.round(v * 10 ** d) / 10 ** d;
   return {
-    colourfulness: round2(colourfulness, 1),
-    edgeDensity: round2(edgeN ? edges / edgeN : 0),
-    symmetry: round2(asymN ? 1 - asym / asymN / 255 : 1),
+    colourfulness: round3(colourfulness, 1),
+    edgeDensity: round3(edgeN ? edges / edgeN : 0),
+    symmetry: round3(asymN ? 1 - asym / asymN / 255 : 1),
     width: w,
     height: h,
     sampled: n
@@ -7312,62 +7395,6 @@ function propose(input) {
   };
 }
 
-// src/estate/index.ts
-var ESTATE_VERSION = 1;
-var SIBLING_AT = 0.31;
-function emptyEstate() {
-  return { version: ESTATE_VERSION, sites: [] };
-}
-function addSite(register, site) {
-  if (!/^[a-z0-9][a-z0-9-]*$/.test(site.id)) throw new Error(`site id "${site.id}" must be short kebab-case`);
-  const sites = [...register.sites.filter((s) => s.id !== site.id), site].sort((a, b) => a.id.localeCompare(b.id));
-  return { version: ESTATE_VERSION, sites };
-}
-function sharedParts(a, b, d = fingerprintDistance(a, b)) {
-  const out = [];
-  const close = (k) => d.parts[k] <= SHARED_PART;
-  if (close("accent")) out.push(a.accent || b.accent ? `${hueName(a.accent)} accent` : "no accent");
-  if (close("type")) {
-    if (a.display.family === b.display.family) out.push(`${a.display.family} headline`);
-    if (a.body.family === b.body.family) out.push(`${a.body.family} body`);
-  }
-  if (close("ground")) out.push(`${groundName(a.ground)} ground`);
-  if (close("shape")) out.push(`${shapeName(a.roundness)} buttons`);
-  if (close("motion")) out.push(a.motion > 0 || b.motion > 0 ? "scroll reveals" : "no reveals");
-  if (close("effects") && a.effects.length) out.push(a.effects.filter((e) => b.effects.includes(e)).join(", "));
-  if (close("layout")) out.push("running order");
-  return out;
-}
-function compareToEstate(target2, register, options = {}) {
-  const at = options.siblingAt ?? SIBLING_AT;
-  return register.sites.filter((s) => s.id !== options.exclude && s.fingerprint).map((s) => {
-    const d = fingerprintDistance(target2, s.fingerprint);
-    return { id: s.id, distance: d.total, sibling: d.total < at, shared: sharedParts(target2, s.fingerprint, d) };
-  }).sort((a, b) => a.distance - b.distance);
-}
-function estatePairs(register, siblingAt = SIBLING_AT) {
-  const out = [];
-  const s = register.sites.filter((site) => site.fingerprint);
-  for (let i = 0; i < s.length; i += 1) {
-    for (let j = i + 1; j < s.length; j += 1) {
-      const d = fingerprintDistance(s[i].fingerprint, s[j].fingerprint);
-      out.push({ a: s[i].id, b: s[j].id, distance: d.total, sibling: d.total < siblingAt, shared: sharedParts(s[i].fingerprint, s[j].fingerprint, d) });
-    }
-  }
-  return out.sort((x, y) => x.distance - y.distance);
-}
-function siblingLine(briefs) {
-  const d = [];
-  for (const runs of briefs) {
-    for (let i = 0; i < runs.length; i += 1) for (let j = i + 1; j < runs.length; j += 1) d.push(fingerprintDistance(runs[i], runs[j]).total);
-  }
-  if (d.length === 0) throw new Error("no null pages to measure the sibling line from");
-  d.sort((a, b) => a - b);
-  const mid = Math.floor(d.length / 2);
-  const m = d.length % 2 ? d[mid] : (d[mid - 1] + d[mid]) / 2;
-  return Math.round(m * 1e3) / 1e3;
-}
-
 // src/report/index.ts
 var TELL_HEAVY = 3;
 var MIN_DECIDED = 5;
@@ -7523,6 +7550,154 @@ function choiceOfShared(part) {
   return /running order/.test(part) ? void 0 : "motif";
 }
 
+// src/calibrate/index.ts
+var LABELS = ["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]));
+function designTells(tells) {
+  return tells.filter((t) => SURFACE.has(t) && SURFACE.get(t) !== "copy");
+}
+function isFlagged(page) {
+  return Boolean(page.typicality?.typical) || designTells(page.tells).length >= TELL_HEAVY;
+}
+var positive = (label) => label !== "human";
+var round2 = (n) => Math.round(n * 100) / 100;
+var share = (n, of) => `${n} of ${of} (${Math.round(100 * n / of)}%)`;
+function summarise(label, pages, typicality2) {
+  const mine = pages.filter((p) => p.label === label);
+  return {
+    label,
+    pages: mine.length,
+    // A set measured partly against the null would count the same page two ways.
+    flagged: mine.filter((p) => typicality2 ? isFlagged(p) : designTells(p.tells).length >= TELL_HEAVY).length,
+    typical: typicality2 ? mine.filter((p) => p.typicality?.typical).length : null,
+    tellHeavy: mine.filter((p) => designTells(p.tells).length >= TELL_HEAVY).length,
+    blocking: mine.reduce((s, p) => s + p.blocking, 0)
+  };
+}
+function flaggedTarget(target2, s, missing) {
+  const note = missing ? `; ${missing} not measured, counted neither way` : "";
+  if (s.pages === 0) return { target: target2, met: null, detail: `no page measured${note}` };
+  return { target: target2, met: s.flagged / s.pages >= FLAGGED_TARGET, detail: `${share(s.flagged, s.pages)} flagged, target ${FLAGGED_TARGET * 100}% or more${note}` };
+}
+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 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 on = hits.ai + hits["ai-looking"];
+    return { tell, 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` : "";
+  const targets = [
+    flaggedTarget("1. Generated pages get caught", byLabel.ai, missing("ai")),
+    human.pages === 0 ? { target: "2. Good human sites don't get caught", met: null, detail: `no page measured${humanNote}` } : {
+      target: "2. Good human sites don't get caught",
+      // A block hit fails it outright; without null models the other half is not known.
+      met: human.blocking > 0 ? false : human.typical === null ? null : human.typical / human.pages <= HUMAN_TYPICAL_TARGET,
+      detail: `${human.blocking} block hits, target 0; ${human.typical === null ? "typicality not measured (no null models)" : `${share(human.typical, human.pages)} typical, target ${HUMAN_TYPICAL_TARGET * 100}% or fewer`}${humanNote}`
+    },
+    flaggedTarget("3. Sites a person labelled AI-looking get caught", byLabel["ai-looking"], missing("ai-looking"))
+  ];
+  return {
+    pages: pages.length,
+    typicality: typicality2,
+    labels,
+    tells,
+    silent: CATALOGUE.map((t) => t.id).filter((id) => !fired.has(id)),
+    targets,
+    unmeasured
+  };
+}
+function formatCalibration(c, notes = []) {
+  const counts = c.labels.map((s) => `${s.pages} ${s.label}`).join(", ");
+  const lines = [`craft calibrate: ${c.pages} pages measured (${counts})`, ...notes];
+  if (!c.typicality) lines.push("No null models: flagged means tell-heavy only.");
+  if (c.unmeasured.length) {
+    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");
+  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)}`);
+  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)}`
+    );
+  }
+  if (!c.tells.length) lines.push("  no tell fired");
+  lines.push("", `Never fired on this set: ${c.silent.length} of ${CATALOGUE.length} catalogue tells.`);
+  return lines.join("\n");
+}
+
+// src/estate/index.ts
+var ESTATE_VERSION = 1;
+var SIBLING_AT = 0.31;
+function emptyEstate() {
+  return { version: ESTATE_VERSION, sites: [] };
+}
+function addSite(register, site) {
+  if (!/^[a-z0-9][a-z0-9-]*$/.test(site.id)) throw new Error(`site id "${site.id}" must be short kebab-case`);
+  const sites = [...register.sites.filter((s) => s.id !== site.id), site].sort((a, b) => a.id.localeCompare(b.id));
+  return { version: ESTATE_VERSION, sites };
+}
+function sharedParts(a, b, d = fingerprintDistance(a, b)) {
+  const out = [];
+  const close = (k) => d.parts[k] <= SHARED_PART;
+  if (close("accent")) out.push(a.accent || b.accent ? `${hueName(a.accent)} accent` : "no accent");
+  if (close("type")) {
+    if (a.display.family === b.display.family) out.push(`${a.display.family} headline`);
+    if (a.body.family === b.body.family) out.push(`${a.body.family} body`);
+  }
+  if (close("ground")) out.push(`${groundName(a.ground)} ground`);
+  if (close("shape")) out.push(`${shapeName(a.roundness)} buttons`);
+  if (close("motion")) out.push(a.motion > 0 || b.motion > 0 ? "scroll reveals" : "no reveals");
+  if (close("effects") && a.effects.length) out.push(a.effects.filter((e) => b.effects.includes(e)).join(", "));
+  if (close("layout")) out.push("running order");
+  return out;
+}
+function compareToEstate(target2, register, options = {}) {
+  const at = options.siblingAt ?? SIBLING_AT;
+  return register.sites.filter((s) => s.id !== options.exclude && s.fingerprint).map((s) => {
+    const d = fingerprintDistance(target2, s.fingerprint);
+    return { id: s.id, distance: d.total, sibling: d.total < at, shared: sharedParts(target2, s.fingerprint, d) };
+  }).sort((a, b) => a.distance - b.distance);
+}
+function estatePairs(register, siblingAt = SIBLING_AT) {
+  const out = [];
+  const s = register.sites.filter((site) => site.fingerprint);
+  for (let i = 0; i < s.length; i += 1) {
+    for (let j = i + 1; j < s.length; j += 1) {
+      const d = fingerprintDistance(s[i].fingerprint, s[j].fingerprint);
+      out.push({ a: s[i].id, b: s[j].id, distance: d.total, sibling: d.total < siblingAt, shared: sharedParts(s[i].fingerprint, s[j].fingerprint, d) });
+    }
+  }
+  return out.sort((x, y) => x.distance - y.distance);
+}
+function siblingLine(briefs) {
+  const d = [];
+  for (const runs of briefs) {
+    for (let i = 0; i < runs.length; i += 1) for (let j = i + 1; j < runs.length; j += 1) d.push(fingerprintDistance(runs[i], runs[j]).total);
+  }
+  if (d.length === 0) throw new Error("no null pages to measure the sibling line from");
+  d.sort((a, b) => a - b);
+  const mid = Math.floor(d.length / 2);
+  const m = d.length % 2 ? d[mid] : (d[mid - 1] + d[mid]) / 2;
+  return Math.round(m * 1e3) / 1e3;
+}
+
 // src/report/retrofit.ts
 var HEADINGS = {
   direction: "Decide first",
@@ -7604,6 +7779,7 @@ export {
   ESTATE_VERSION,
   EXIT_RATIO,
   FINGERPRINT_VERSION,
+  FLAGGED_TARGET,
   FUNCTION_WORDS,
   GROUND_SCALE,
   GROUND_SHARED,
@@ -7614,8 +7790,11 @@ export {
   HOUSE_BUDGET,
   HOUSE_LOCKED,
   HOUSE_TYPE,
+  HUMAN_TYPICAL_TARGET,
   IMAGERY_TELLS,
   JSON_SCHEMA_VERSION,
+  LABELS,
+  LEXICAL_FEATURES,
   LICENCES,
   LIGHTNESS_CURVE,
   MIN_DECIDED,
@@ -7656,6 +7835,7 @@ export {
   STOCK_FIGURES,
   STOCK_PHOTO_HOSTS,
   STOCK_PHRASES,
+  STUDY_WORDS,
   TELL_HEAVY,
   TRADE_NOUNS,
   TYPE_STEPS,
@@ -7669,6 +7849,7 @@ export {
   applySeverity,
   auditSnapshot,
   briefTerms,
+  calibrate,
   catalogueTable,
   characterReport,
   checkCopy,
@@ -7698,6 +7879,7 @@ export {
   deltaEOkHex,
   densityCss,
   densityTokens,
+  designTells,
   emitCss,
   emptyEstate,
   estateComponentPairs,
@@ -7714,6 +7896,7 @@ export {
   fluidSpace,
   fluidType,
   fontClass,
+  formatCalibration,
   formatClaims,
   formatComparison,
   formatCompetitor,
@@ -7738,8 +7921,10 @@ export {
   isBlurb,
   isCategoryLabel,
   isCream,
+  isFlagged,
   jobWords,
   layoutDistance,
+  lexicalOf,
   licencesJson,
   makeSnapshot,
   motionTokens,
@@ -7806,6 +7991,8 @@ export {
   validateJob,
   visibleText,
   visualMeasures,
+  vocabulary,
+  vocabularyCounts,
   wcagContrast,
   wordListsJson
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domandigital/craft",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "private": false,
   "description": "The Doman Digital house craft standard as numbers: OKLCh colour ramps that snap to existing anchors, derived semantic tokens with measured WCAG and APCA contrast, one shared motion vocabulary for CSS and JS, and a base stylesheet. Zero dependencies.",
   "license": "Apache-2.0",