@domandigital/craft 0.6.0 → 0.8.0

package/dist/chunk-X65RDW65.js

@@ -0,0 +1,364 @@
+import {
+  CATALOGUE,
+  CATALOGUE_VERSION,
+  applyHouseGate,
+  checkCopy,
+  extractCopy,
+  extractStrings,
+  fileKind,
+  houseRule,
+  scanSource
+} from "./chunk-CZHRNPDD.js";
+
+// src/character/cli.ts
+import { execFileSync } from "child_process";
+import { existsSync, readFileSync, readdirSync, statSync } from "fs";
+import { join, relative, resolve } from "path";
+
+// src/character/facts.ts
+var MONTH = "(?:Jan(?:uary)?|Feb(?:ruary)?|Mar(?:ch)?|Apr(?:il)?|May|Jun(?:e)?|Jul(?:y)?|Aug(?:ust)?|Sep(?:t(?:ember)?)?|Oct(?:ober)?|Nov(?:ember)?|Dec(?:ember)?)";
+var PATTERNS = [
+  ["url", /\bhttps?:\/\/[^\s<>"'`)\]]+|\bwww\.[^\s<>"'`)\]]+/gi],
+  ["email", /\b[\w.+-]+@[\w-]+(?:\.[\w-]+)+\b/g],
+  ["phone", /(?:\+44\s?\(?0?\)?\s?|\b0)\d(?:[\s-]?\d){8,9}\b/g],
+  ["postcode", /\b[A-Z]{1,2}\d[A-Z\d]?\s?\d[A-Z]{2}\b/g],
+  ["money", /[£$€]\s?\d[\d,]*(?:\.\d{1,2})?(?:\s?(?:k|m|bn)\b)?|\b\d[\d,]*(?:\.\d{1,2})?\s?(?:pounds|GBP)\b/gi],
+  ["date", new RegExp(`\\b\\d{1,2}(?:st|nd|rd|th)?\\s+${MONTH}\\b(?:\\s+\\d{4})?|\\b${MONTH}\\s+\\d{1,2}(?:st|nd|rd|th)?\\b(?:,?\\s+\\d{4})?|\\b${MONTH}\\s+\\d{4}\\b|\\b\\d{1,2}\\/\\d{1,2}\\/\\d{2,4}\\b|\\b(?:19|20)\\d{2}\\b`, "g")],
+  ["time", /\b\d{1,2}(?:[:.]\d{2})?\s?(?:am|pm)\b|\b\d{1,2}:\d{2}\b/gi],
+  ["number", /\b\d[\d,]*(?:\.\d+)?%?|\b\d+(?:\.\d+)?\s?(?:per ?cent)\b/gi]
+];
+var NAME = /[A-Z][a-zA-Z’'&-]*[a-zA-Z](?:\s+(?:of|and|&|the)?\s*[A-Z][a-zA-Z’'&-]*[a-zA-Z])*/g;
+var normalise = (kind, value) => {
+  const v = value.trim();
+  if (kind === "phone") return v.replace(/[^\d+]/g, "").replace(/^\+44\(?0?\)?/, "0").replace(/^\+44/, "0");
+  if (kind === "money" || kind === "number") return v.replace(/[\s,]/g, "").toLowerCase();
+  if (kind === "postcode") return v.replace(/\s/g, "").toUpperCase();
+  if (kind === "url") return v.replace(/[.,;:]+$/, "").toLowerCase();
+  return v.replace(/\s+/g, " ").toLowerCase();
+};
+function visibleText(file) {
+  const prose = /\.(md|markdown|mdx|txt)$/i.test(file.path);
+  return (prose ? extractCopy(file) : extractStrings(file)).map((b) => b.text).join("\n");
+}
+function protectedFacts(text) {
+  const facts = [];
+  let rest = 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)]) {
+      const value = m[0].replace(/[.,;:]+$/, "");
+      facts.push({ kind, value, key: `${kind}:${normalise(kind, value)}` });
+      mask(m.index ?? 0, m[0].length);
+    }
+  }
+  const lines = rest.split("\n");
+  for (const line of lines) {
+    if (/^\s{0,3}#{1,6}\s/.test(line)) continue;
+    for (const m of line.matchAll(NAME)) {
+      const at = m.index ?? 0;
+      const before = line.slice(0, at).trimEnd();
+      const opensSentence = before === "" || /[.!?:"“(>*-]$/.test(before) || /^\s*(?:[-*+]|\d+\.)$/.test(before);
+      const word = m[0];
+      const acronym = /^[A-Z]{2,}$/.test(word);
+      if (opensSentence && !acronym && !/\s/.test(word)) continue;
+      if (word === "I") continue;
+      facts.push({ kind: "name", value: word, key: `name:${normalise("name", word)}` });
+    }
+  }
+  return facts;
+}
+var unique = (facts) => [...new Map(facts.map((f) => [f.key, f])).values()];
+function compareFacts(before, after) {
+  const a = unique(protectedFacts(before));
+  const b = unique(protectedFacts(after));
+  const inA = new Set(a.map((f) => f.key));
+  const inB = new Set(b.map((f) => f.key));
+  return {
+    before: a.length,
+    after: b.length,
+    lost: a.filter((f) => !inB.has(f.key)),
+    added: b.filter((f) => !inA.has(f.key))
+  };
+}
+function formatComparison(result, beforePath, afterPath) {
+  const lines = [`craft copy compare: ${beforePath} -> ${afterPath}`, `  ${result.before} protected facts before, ${result.after} after`];
+  if (result.lost.length) {
+    lines.push("", `  Lost (${result.lost.length}): restore each, or say why it went`);
+    for (const f of result.lost) lines.push(`    ${f.kind.padEnd(9)} ${f.value}`);
+  }
+  if (result.added.length) {
+    lines.push("", `  Added (${result.added.length}): each needs a source, or it is invented`);
+    for (const f of result.added) lines.push(`    ${f.kind.padEnd(9)} ${f.value}`);
+  }
+  if (!result.lost.length && !result.added.length) lines.push("", "  Every fact kept, nothing added.");
+  return lines.join("\n");
+}
+
+// src/character/format.ts
+function formatReport(report, title) {
+  const lines = [];
+  let current = "";
+  for (const f of report.findings) {
+    if (f.path !== current) {
+      current = f.path;
+      lines.push("", f.path);
+    }
+    lines.push(`  ${String(f.line).padStart(4)}  ${f.tell} (gen ${f.generation}, ${f.severity})  ${f.message}`);
+    lines.push(`        ${f.excerpt}`);
+  }
+  const fixes = new Map(report.findings.map((f) => [f.tell, f.fix]));
+  if (fixes.size > 0) {
+    lines.push("", "What to do instead:");
+    for (const [tell, fix] of fixes) lines.push(`  ${tell}: ${fix}`);
+  }
+  for (const r of report.rejectedExceptions) {
+    lines.push("", `Exception not applied (${r.exception.tell}): ${r.reason}`);
+  }
+  for (const e of report.excepted) {
+    lines.push("", `Excepted: ${e.count} \xD7 ${e.tell}, because ${e.because}`);
+  }
+  if (report.suppressed.length > 0) {
+    lines.push("", `Suppressed: ${report.suppressed.length} marked copy-ok or craft-ok (${report.suppressed.map((s) => `${s.path}:${s.line}`).join(", ")})`);
+  }
+  const { summary } = report;
+  const gens = `gen 1: ${summary.byGeneration[1]}, gen 2: ${summary.byGeneration[2]}, gen 3: ${summary.byGeneration[3]}`;
+  lines.push(
+    "",
+    `${title}: ${summary.findings} finding${summary.findings === 1 ? "" : "s"} in ${summary.files} file${summary.files === 1 ? "" : "s"} (${gens}). Catalogue ${report.catalogueVersion}.`
+  );
+  return lines.join("\n").replace(/^\n/, "");
+}
+
+// src/character/cli.ts
+var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "build", "out", ".next", ".turbo", ".vercel", "coverage", "vendor", ".cache"]);
+var MAX_BYTES = 1e6;
+var NOT_SITE_COPY = /^(?:README|CHANGELOG|CLAUDE|AGENTS|CONTRIBUTING|LICENSE|CODE_OF_CONDUCT|SECURITY)(?:\.[a-z]+)?$/i;
+var HELP = `craft: find the AI look and say what to do instead.
+
+Usage
+  craft scan [paths...] [--staged] [--json] [--strict] [--direction <file>]
+  craft copy <paths...> [--gate] [--json] [--strict] [--direction <file>]
+  craft copy compare <before> <after> [--json]
+  craft tells list [--json]
+  craft tells harvest <null.json | dir>... [--share 0.25] [--json]
+  craft snapshot <url> [--out <file>] [--width <px>] [--height <px>]
+  craft audit <url | snapshot.json> [--repo <dir>] [--null <null.json>] [--out <file>] [--json] [--strict]
+  craft direction init [--snapshot <file>] [--client <name>] [--out <file>]
+  craft direction validate [--snapshot <file>] [--direction <file>] [--json]
+  craft direction propose [--snapshot <file>] [--estate <estate.json | dir>] [--out <file>]
+  craft null build --brief "<text>" --out <dir> [--runs 20] [--parallel 4] [--model <name>]
+  craft estate add <url | snapshot.json> --id <id> [--client <name>] [--estate <file>]
+  craft estate compare [<url | snapshot.json | id>] [--null <dir>] [--json] [--strict]
+  craft report <url | snapshot.json> [--repo <dir>] [--null <dir>] [--estate <file>] [--direction <file>] [--json] [--strict]
+  craft retrofit <url | snapshot.json> [the same] [--out RETROFIT.md]
+
+scan      Markup, component code and stylesheets (source and compiled CSS).
+          --staged reads the git index, for a pre-commit hook.
+copy      The prose in Markdown, markup and content files.
+          --gate applies the house copy policy: the blocking tier of COPY.md
+          fails the run. What copy-check and the pre-commit hook run.
+          compare lists the protected facts (prices, numbers, dates, times,
+          phones, emails, links, postcodes, names) a rewrite lost or added.
+          Exit 1 if any: restore it, source it, or say why.
+tells     The catalogue this build judges against. harvest reads null models
+          for choices the model keeps making that the catalogue does not know.
+snapshot  Render a page in a browser and save what it looks like, as JSON.
+audit     Judge a rendered page (live, or a saved snapshot) and fingerprint it.
+          --repo also scans that site's source, so one report covers both.
+          --null scores how typical it is against a null model (comma-separate
+          several to pool them).
+          snapshot and audit need Playwright: npm i -D playwright.
+direction The site's art-direction.json: every choice with a reason from the
+          client's world. init writes today's choices with empty reasons;
+          validate applies the reason rule; propose reads colours off the
+          sources' PNG photos and drafts choices for a person to confirm.
+null      The counterfactual: about 20 pages \`claude -p\` builds from the brief
+          alone, snapshotted and fingerprinted into null.json. Resumable.
+estate    The register of shipped sites (estate.json). add fingerprints a site;
+          compare lists the nearest, and marks siblings: two sites closer than
+          two pages Claude builds for one brief. --strict exits 1 on a sibling.
+report    Every signal for one site: tells, typicality, the estate, the reasons.
+          A verdict (default, mixed, decided, unproven) and what to do, in order.
+          Anything not given is "not measured", and never counts as a pass.
+retrofit  The report as a checklist: decide, then change type, colour, shape,
+          effects, motion and copy. Never the page grammar.
+
+Exceptions come from art-direction.json in the working directory, or --direction.
+Every tell ships as warn: exit 1 only on a block, or on any finding with --strict.`;
+var VALUE_FLAGS = {
+  "--direction": "direction",
+  "--out": "out",
+  "--repo": "repo",
+  "--width": "width",
+  "--height": "height",
+  "--snapshot": "snapshot",
+  "--estate": "estate",
+  "--client": "client",
+  "--brief": "brief",
+  "--runs": "runs",
+  "--parallel": "parallel",
+  "--model": "model",
+  "--share": "share",
+  "--null": "null",
+  "--id": "id"
+};
+function parseFlags(args) {
+  const flags = { positional: [], json: false, strict: false, staged: false, gate: false };
+  for (let i = 0; i < args.length; i += 1) {
+    const a = args[i];
+    if (a === "--json") flags.json = true;
+    else if (a === "--strict") flags.strict = true;
+    else if (a === "--staged") flags.staged = true;
+    else if (a === "--gate") flags.gate = true;
+    else if (a in VALUE_FLAGS) {
+      const value = args[i + 1];
+      i += 1;
+      if (!value || value.startsWith("--")) return `${a} needs a value`;
+      flags[VALUE_FLAGS[a]] = value;
+    } else if (a.startsWith("--")) return `unknown option ${a}`;
+    else flags.positional.push(a);
+  }
+  return flags;
+}
+function walk(root, cwd, into, wanted, skipDir = (_) => false) {
+  const stat = statSync(root);
+  if (stat.isFile()) {
+    if (stat.size <= MAX_BYTES) into.push({ path: relative(cwd, root) || root, text: readFileSync(root, "utf8") });
+    return;
+  }
+  for (const entry of readdirSync(root, { withFileTypes: true })) {
+    if (entry.isDirectory()) {
+      if (!SKIP_DIRS.has(entry.name) && !skipDir(entry.name)) walk(join(root, entry.name), cwd, into, wanted, skipDir);
+    } else if (entry.isFile() && wanted(entry.name)) {
+      walk(join(root, entry.name), cwd, into, wanted, skipDir);
+    }
+  }
+}
+function readPaths(paths, cwd, wanted, skipDir) {
+  const files = [];
+  for (const p of paths) {
+    const abs = resolve(cwd, p);
+    if (!existsSync(abs)) throw new Error(`no such path: ${p}`);
+    walk(abs, cwd, files, wanted, skipDir);
+  }
+  return files;
+}
+function readStaged(cwd, wanted) {
+  const names = execFileSync("git", ["diff", "--cached", "--name-only", "--diff-filter=ACMR", "-z"], { cwd, encoding: "utf8" }).split("\0").filter((p) => p && wanted(p));
+  return names.map((path) => ({
+    path,
+    // The index, not the working tree: the commit is what gets checked.
+    text: execFileSync("git", ["show", `:${path}`], { cwd, encoding: "utf8", maxBuffer: MAX_BYTES * 4 })
+  }));
+}
+function loadExceptions(flags, cwd) {
+  const path = resolve(cwd, flags.direction ?? "art-direction.json");
+  if (!existsSync(path)) {
+    if (flags.direction) throw new Error(`no such file: ${flags.direction}`);
+    return [];
+  }
+  const data = JSON.parse(readFileSync(path, "utf8"));
+  return Array.isArray(data.exceptions) ? data.exceptions : [];
+}
+function finish(report, flags, title, io) {
+  io.out(flags.json ? JSON.stringify(report, null, 2) : formatReport(report, title));
+  if (report.summary.blocking > 0) return 1;
+  if (flags.strict && report.summary.findings > 0) return 1;
+  return 0;
+}
+var SOURCE_FILE = (p) => ["markup", "script", "css"].includes(fileKind(p)) && !/\.d\.ts$|\.min\.js$/.test(p);
+var COPY_FILE = (p) => (["markup", "prose", "script"].includes(fileKind(p)) || /\.jsonl?$/i.test(p)) && !NOT_SITE_COPY.test(p.split("/").pop() ?? p) && !/(?:^|\/)(?:package(?:-lock)?|tsconfig[\w.-]*|art-direction)\.json$/.test(p);
+var NOT_COPY_DIR = (name) => name.startsWith("_");
+function run(argv, io) {
+  const [command, ...rest] = argv;
+  if (command === "direction") {
+    return import("./cli-KA3JDNDH.js").then((m) => m.runDirection(rest, io));
+  }
+  if (command === "report" || command === "retrofit") {
+    return import("./cli-LZ7R6KJM.js").then((m) => m.runReport(command, rest, io));
+  }
+  if (command === "estate") {
+    return import("./cli-SHLNRHK6.js").then((m) => m.runEstate(rest, io));
+  }
+  if (command === "null") {
+    return import("./cli-F7ONSKZS.js").then((m) => m.runNull(rest, io));
+  }
+  if (command === "tells" && rest[0] === "harvest") {
+    return import("./cli-F7ONSKZS.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
+      io.err(`craft: ${error.message}`);
+      return 2;
+    });
+  }
+  if (command === "snapshot" || command === "audit") {
+    return import("./cli-FKJOMOOF.js").then((m) => m.runAudit(command, rest, io));
+  }
+  if (!command || command === "help" || command === "--help" || command === "-h") {
+    io.out(HELP);
+    return command ? 0 : 2;
+  }
+  try {
+    if (command === "tells") {
+      const flags = parseFlags(rest);
+      if (typeof flags === "string") throw new Error(flags);
+      if (flags.positional[0] !== "list") throw new Error("usage: craft tells list [--json] | craft tells harvest <null.json>...");
+      if (flags.json) {
+        const data = CATALOGUE.map(({ id, name, generation, surface, severity, why, fix }) => ({
+          id,
+          name,
+          generation,
+          surface,
+          severity,
+          why,
+          fix,
+          ...surface === "copy" ? { house: houseRule(id, name).tier, houseLabel: houseRule(id, name).label } : {}
+        }));
+        io.out(JSON.stringify({ version: CATALOGUE_VERSION, tells: data }, null, 2));
+      } else {
+        io.out(`Catalogue ${CATALOGUE_VERSION}`);
+        for (const t of CATALOGUE) io.out(`  ${t.id.padEnd(24)} gen ${t.generation}  ${t.surface.padEnd(6)}  ${t.name}`);
+      }
+      return 0;
+    }
+    if (command === "copy" && rest[0] === "compare") {
+      const flags = parseFlags(rest.slice(1));
+      if (typeof flags === "string") throw new Error(flags);
+      if (flags.positional.length !== 2) throw new Error("usage: craft copy compare <before> <after> [--json]");
+      const [before, after] = flags.positional.map((p) => {
+        const abs = resolve(io.cwd, p);
+        if (!existsSync(abs)) throw new Error(`no such path: ${p}`);
+        return visibleText({ path: p, text: readFileSync(abs, "utf8") });
+      });
+      const result = compareFacts(before, after);
+      io.out(flags.json ? JSON.stringify(result, null, 2) : formatComparison(result, flags.positional[0], flags.positional[1]));
+      return result.lost.length || result.added.length ? 1 : 0;
+    }
+    if (command === "scan" || command === "copy") {
+      const flags = parseFlags(rest);
+      if (typeof flags === "string") throw new Error(flags);
+      const wanted = command === "scan" ? SOURCE_FILE : COPY_FILE;
+      if (command === "copy" && flags.positional.length === 0 && !flags.staged) throw new Error("usage: craft copy <paths...>");
+      const files = flags.staged ? readStaged(io.cwd, wanted) : readPaths(flags.positional.length > 0 ? flags.positional : ["."], io.cwd, wanted, command === "copy" ? NOT_COPY_DIR : void 0);
+      const exceptions = loadExceptions(flags, io.cwd);
+      let report = command === "scan" ? scanSource(files, { exceptions }) : checkCopy(files, { exceptions });
+      if (command === "copy" && flags.gate) report = applyHouseGate(report);
+      return finish(report, flags, command === "scan" ? "craft scan" : "craft copy", io);
+    }
+    throw new Error(`unknown command "${command}". Run craft --help.`);
+  } catch (error) {
+    io.err(`craft: ${error.message}`);
+    return 2;
+  }
+}
+
+export {
+  parseFlags,
+  readPaths,
+  loadExceptions,
+  finish,
+  SOURCE_FILE,
+  COPY_FILE,
+  NOT_COPY_DIR,
+  run
+};

package/dist/cli-F7ONSKZS.js

@@ -0,0 +1,21 @@
+import {
+  describeTypicality,
+  formatHarvest,
+  loadNull,
+  measureRun,
+  nullPath,
+  runHarvest,
+  runNull
+} from "./chunk-K253ZXB3.js";
+import "./chunk-X65RDW65.js";
+import "./chunk-OGSYVCMU.js";
+import "./chunk-CZHRNPDD.js";
+export {
+  describeTypicality,
+  formatHarvest,
+  loadNull,
+  measureRun,
+  nullPath,
+  runHarvest,
+  runNull
+};

package/dist/cli-FKJOMOOF.js

@@ -0,0 +1,15 @@
+import {
+  describeFingerprint,
+  merge,
+  runAudit
+} from "./chunk-35OX6C4H.js";
+import "./chunk-Q4MN3OXF.js";
+import "./chunk-K253ZXB3.js";
+import "./chunk-X65RDW65.js";
+import "./chunk-OGSYVCMU.js";
+import "./chunk-CZHRNPDD.js";
+export {
+  describeFingerprint,
+  merge,
+  runAudit
+};

package/dist/{cli-F7W4F3ER.js → cli-KA3JDNDH.js}

@@ -1,43 +1,27 @@
+import {
+  DIRECTION_VERSION,
+  validateDirection
+} from "./chunk-ULYKASLA.js";
+import {
+  parseFlags
+} from "./chunk-X65RDW65.js";
 import {
   fingerprint
-} from "./chunk-HYGFP3LB.js";
+} from "./chunk-OGSYVCMU.js";
 import {
-  REFLEX_FONTS_1,
-  REFLEX_FONTS_2,
   deltaEOk,
   formatHex,
   hexToOklch,
   isAiViolet,
   isCream,
-  normaliseFamily,
   oklchToRgb,
-  parseColour,
-  parseFlags
-} from "./chunk-GWMSSRIQ.js";
+  parseColour
+} from "./chunk-CZHRNPDD.js";
 
 // src/direction/cli.ts
 import { existsSync, readdirSync, readFileSync, writeFileSync } from "fs";
 import { dirname, join, resolve } from "path";
 
-// src/direction/types.ts
-var DIRECTION_VERSION = 1;
-var SOURCE_KINDS = [
-  "livery",
-  "shopfront",
-  "signage",
-  "packaging",
-  "product",
-  "uniform",
-  "interior",
-  "place",
-  "material",
-  "trade",
-  "print",
-  "photo",
-  "founder"
-];
-var CHOICE_KEYS = ["accent", "ground", "display", "body", "shape", "motif", "signature"];
-
 // src/direction/init.ts
 var hex = (o) => {
   const { r, g, b } = oklchToRgb(o);
@@ -254,148 +238,6 @@ function propose(input) {
   };
 }
 
-// src/direction/validate.ts
-var PREFERENCE = /\b(?:client (?:likes|liked|wants|wanted|asked|chose|prefers?)|(?:we|they|i) (?:like|liked|love|loved|prefer)|on[- ]trend|trendy|popular|what (?:everyone|competitors) (?:uses?|does)|brand (?:colou?r|font|guidelines?) (?:is|are|says?))\b/i;
-var MOOD = /\b(?:modern|clean|fresh|professional|trustworthy|premium|elegant|sleek|timeless|minimal(?:ist)?|bold|vibrant|friendly|approachable|luxur(?:y|ious)|sophisticated|contemporary|stylish|warm|inviting|high[- ]end)\b/gi;
-var VALUE_WORDS = /* @__PURE__ */ new Set(["green", "blue", "navy", "black", "white", "cream", "grey", "gray", "gold", "yellow", "orange", "purple", "violet", "pink", "brown", "teal", "bottle", "dark", "light", "deep", "pale", "bright", "colour", "color", "font", "face", "serif", "sans", "type", "lettering"]);
-var STOP = /* @__PURE__ */ new Set(["with", "that", "this", "from", "their", "they", "have", "been", "were", "which", "what", "when", "where", "there", "about", "into", "onto", "over", "same", "each", "every"]);
-function words(text) {
-  return new Set((text.toLowerCase().match(/[a-z][a-z'-]{3,}/g) ?? []).map((w) => w.replace(/'s$/, "")).filter((w) => !STOP.has(w) && !VALUE_WORDS.has(w)));
-}
-function tellFor(key, value) {
-  if (key === "accent") {
-    const c = parseColour(value);
-    return c && isAiViolet(c.oklch) ? "ai-violet" : null;
-  }
-  if (key === "ground") {
-    const c = parseColour(value);
-    return c && isCream(c.oklch) ? "cream-palette" : null;
-  }
-  if (key === "display" || key === "body") {
-    const name = normaliseFamily(value).toLowerCase();
-    if (REFLEX_FONTS_1.some((f) => f.toLowerCase() === name)) return "reflex-font";
-    if (REFLEX_FONTS_2.some((f) => f.toLowerCase() === name)) return "reflex-font-2";
-  }
-  return null;
-}
-function validateDirection(input, ctx = {}) {
-  const problems = [];
-  const err = (at, message) => problems.push({ severity: "error", at, message });
-  const warn = (at, message) => problems.push({ severity: "warn", at, message });
-  if (!input || typeof input !== "object" || Array.isArray(input)) {
-    err("", "art-direction.json must be a JSON object");
-    return { valid: false, problems, decided: 0 };
-  }
-  const d = input;
-  const legacy = d.version === void 0 && d.choices === void 0 && Array.isArray(d.exceptions);
-  if (legacy) {
-    warn("", "exceptions only: run craft direction init to record the choices and their reasons");
-    return { valid: true, problems, decided: 0 };
-  }
-  if (d.version !== DIRECTION_VERSION) err("version", `version must be ${DIRECTION_VERSION}`);
-  if (typeof d.client !== "string" || !d.client.trim()) err("client", "name the client");
-  if (typeof d.brief !== "string" || d.brief.trim().split(/\s+/).length < 8) err("brief", "the brief needs a sentence: who, where, and what they do");
-  const sources = Array.isArray(d.sources) ? d.sources : [];
-  if (!Array.isArray(d.sources)) err("sources", "sources must be a list");
-  if (sources.length === 0) err("sources", "no sources: a reason needs something in the client's world to point at");
-  const ids = /* @__PURE__ */ new Set();
-  sources.forEach((s, i) => {
-    const at = `sources[${i}]`;
-    if (!s || typeof s !== "object") return err(at, "a source must be an object");
-    if (typeof s.id !== "string" || !/^[a-z0-9][a-z0-9-]*$/.test(s.id)) err(`${at}.id`, "id must be short kebab-case");
-    else if (ids.has(s.id)) err(`${at}.id`, `"${s.id}" is used twice`);
-    else ids.add(s.id);
-    if (!SOURCE_KINDS.includes(s.kind)) err(`${at}.kind`, `kind must be one of: ${SOURCE_KINDS.join(", ")}`);
-    if (typeof s.note !== "string" || s.note.trim().split(/\s+/).length < 3) err(`${at}.note`, "say what it is and where");
-    if (s.path && ctx.pathExists && !/^https?:/.test(s.path) && !ctx.pathExists(s.path)) err(`${at}.path`, `${s.path} does not exist`);
-    for (const [j, c] of (s.colours ?? []).entries()) if (!parseColour(c)) err(`${at}.colours[${j}]`, `"${c}" is not a colour`);
-  });
-  const choices = d.choices && typeof d.choices === "object" ? d.choices : {};
-  if (!d.choices || typeof d.choices !== "object") err("choices", "choices must be an object");
-  const exceptions = Array.isArray(d.exceptions) ? d.exceptions : [];
-  let decided = 0;
-  for (const key of Object.keys(choices)) {
-    if (!CHOICE_KEYS.includes(key)) err(`choices.${key}`, `not a choice craft knows. Choices are: ${CHOICE_KEYS.join(", ")}. Layout and navigation stay conventional.`);
-  }
-  for (const key of CHOICE_KEYS) {
-    const c = choices[key];
-    const at = `choices.${key}`;
-    if (!c) {
-      warn(at, "not decided yet");
-      continue;
-    }
-    let ok = true;
-    if (typeof c.value !== "string" || !c.value.trim()) {
-      err(`${at}.value`, "no value");
-      ok = false;
-    } else if ((key === "accent" || key === "ground") && !parseColour(c.value)) {
-      err(`${at}.value`, `"${c.value}" is not a colour`);
-      ok = false;
-    }
-    const because = typeof c.because === "string" ? c.because.trim() : "";
-    const evidence = Array.isArray(c.evidence) ? c.evidence : [];
-    if (because.split(/\s+/).filter(Boolean).length < 8) {
-      err(`${at}.because`, "a reason is at least a sentence. Without one this is a default, however good it looks.");
-      ok = false;
-    } else if (because.startsWith("PROPOSED:")) {
-      err(`${at}.because`, "a proposal, not yet a decision. Check it against the source, then rewrite the reason in your own words.");
-      ok = false;
-    } else {
-      if (PREFERENCE.test(because)) {
-        err(`${at}.because`, "that is a preference, not a reason. Say what in the client's world this comes from.");
-        ok = false;
-      }
-      const moods = because.match(MOOD) ?? [];
-      if (moods.length >= 2) {
-        err(`${at}.because`, `"${moods.join(", ")}" describes a mood, not a source. Name the thing it comes from.`);
-        ok = false;
-      }
-    }
-    if (evidence.length === 0) {
-      err(`${at}.evidence`, "cite at least one source");
-      ok = false;
-    }
-    for (const id of evidence) {
-      if (!ids.has(id)) {
-        err(`${at}.evidence`, `no source called "${id}"`);
-        ok = false;
-      }
-    }
-    if (ok) {
-      const cited = sources.filter((s) => evidence.includes(s.id));
-      const reasonWords = words(because);
-      const tied = cited.some((s) => reasonWords.has(s.id) || [...words(`${s.note} ${s.lettering ?? ""}`)].some((w) => reasonWords.has(w)));
-      if (!tied) {
-        err(`${at}.because`, `the reason does not mention what its evidence shows (${evidence.join(", ")}). Say what on it this comes from.`);
-        ok = false;
-      }
-    }
-    if (typeof c.value === "string") {
-      const tell = tellFor(key, c.value);
-      if (tell && !exceptions.some((e) => e.tell === tell)) {
-        err(`${at}.value`, `${c.value} is on the tell catalogue (${tell}). Keep it only with an exception for ${tell}, carrying the same reason.`);
-        ok = false;
-      }
-    }
-    const fp = ctx.fingerprint;
-    if (fp && typeof c.value === "string") {
-      if ((key === "accent" || key === "ground") && parseColour(c.value)) {
-        const declared = parseColour(c.value).oklch;
-        const measured = key === "accent" ? fp.accent : fp.ground;
-        if (measured && deltaEOk(declared, measured) > 0.08) {
-          warn(`${at}.value`, `the page does not show it: its ${key} measures oklch(${measured.l.toFixed(2)} ${measured.c.toFixed(3)} ${measured.h.toFixed(0)})`);
-        }
-      }
-      if (key === "display" || key === "body") {
-        const measured = key === "display" ? fp.display.family : fp.body.family;
-        if (normaliseFamily(c.value).toLowerCase() !== measured.toLowerCase()) warn(`${at}.value`, `the page sets ${measured}, not ${c.value}`);
-      }
-    }
-    if (ok) decided += 1;
-  }
-  return { valid: problems.every((p) => p.severity !== "error"), problems, decided };
-}
-
 // src/direction/cli.ts
 var readJson = (path) => JSON.parse(readFileSync(path, "utf8"));
 function fingerprintFrom(path, cwd) {
@@ -404,6 +246,10 @@ function fingerprintFrom(path, cwd) {
 function estateFrom(dir, cwd) {
   if (!dir) return [];
   const root = resolve(cwd, dir);
+  if (root.endsWith(".json")) {
+    const register = readJson(root);
+    return (register.sites ?? []).map((s) => ({ id: s.id, fingerprint: s.fingerprint }));
+  }
   return readdirSync(root).filter((f) => f.endsWith(".json")).flatMap((f) => {
     try {
       const snap = readJson(join(root, f));