@domandigital/craft 0.15.0 → 0.17.0

package/dist/{chunk-YDURAOYR.js → chunk-6TSDYETQ.js}

@@ -4,14 +4,16 @@ import {
   REFLEX_FONTS_1,
   REFLEX_FONTS_2,
   SHARED_PART,
-  TRADE_NOUNS,
   deltaEOk,
   isAiViolet,
   isCream,
   levenshtein,
   normaliseFamily,
   parseColour
-} from "./chunk-LFNSB6W7.js";
+} from "./chunk-WFB6F3BN.js";
+import {
+  TRADE_NOUNS
+} from "./chunk-4QWEAL4G.js";
 
 // src/direction/types.ts
 var DIRECTION_VERSION = 2;

package/dist/{chunk-2IQ5OXFR.js → chunk-DARKHE6A.js}

@@ -1,11 +1,11 @@
 import {
   snapshotUrl,
   snapshotUrls
-} from "./chunk-OUQ25LY2.js";
+} from "./chunk-SL5VZJ2J.js";
 import {
   describeTypicality,
   loadNull
-} from "./chunk-RXXRXV3V.js";
+} from "./chunk-ZUYERAFM.js";
 import {
   SOURCE_FILE,
   finish,
@@ -13,9 +13,11 @@ import {
   loadExceptions,
   parseFlags,
   prepareReport,
-  readPaths,
+  readPaths
+} from "./chunk-O5B5ELJH.js";
+import {
   toJson
-} from "./chunk-MUVFECFC.js";
+} from "./chunk-QIEDBL4J.js";
 import {
   readSnapshot
 } from "./chunk-WUACK2HX.js";
@@ -25,7 +27,7 @@ import {
   fingerprint,
   scanSource,
   typicality
-} from "./chunk-LFNSB6W7.js";
+} from "./chunk-WFB6F3BN.js";
 
 // src/audit/cli.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";

package/dist/{cli-FCKHYAVZ.js → chunk-NTIPJ5U7.js}

@@ -1,49 +1,3 @@
-import {
-  merge
-} from "./chunk-2IQ5OXFR.js";
-import "./chunk-OUQ25LY2.js";
-import "./chunk-JYNXGCYZ.js";
-import {
-  SIBLING_AT,
-  compareToEstate,
-  loadEstate
-} from "./chunk-QU6Q2QZZ.js";
-import {
-  PAGE_TYPES,
-  validateDirection
-} from "./chunk-YDURAOYR.js";
-import {
-  loadNull
-} from "./chunk-RXXRXV3V.js";
-import "./chunk-OQXTQQAU.js";
-import {
-  COPY_FILE,
-  NOT_COPY_DIR,
-  SOURCE_FILE,
-  applySeverity,
-  loadConfig,
-  loadExceptions,
-  parseFlags,
-  readPaths,
-  toJson
-} from "./chunk-MUVFECFC.js";
-import {
-  readSnapshot
-} from "./chunk-WUACK2HX.js";
-import {
-  CATALOGUE,
-  auditSnapshot,
-  checkCopy,
-  fingerprint,
-  scanSource,
-  typicality
-} from "./chunk-LFNSB6W7.js";
-import "./chunk-QYBAVU3P.js";
-
-// src/report/cli.ts
-import { existsSync, readFileSync, writeFileSync } from "fs";
-import { dirname, resolve } from "path";
-
 // src/report/index.ts
 var TELL_HEAVY = 3;
 var MIN_DECIDED = 5;
@@ -199,144 +153,7 @@ function choiceOfShared(part) {
   return /running order/.test(part) ? void 0 : "motif";
 }
 
-// src/report/retrofit.ts
-var HEADINGS = {
-  direction: "Decide first",
-  type: "Type",
-  colour: "Colour",
-  shape: "Shape",
-  effects: "Effects",
-  motion: "Motion",
-  layout: "How sections look (not where they sit)",
-  copy: "Copy"
-};
-var ORDER = ["direction", "type", "colour", "shape", "effects", "motion", "layout", "copy"];
-function target(a, direction) {
-  if (!a.choice || a.area === "direction") return "";
-  const c = direction?.choices?.[a.choice];
-  if (c && c.because && !c.because.startsWith("PROPOSED:")) return `
-  - Use: **${c.value}** for ${a.choice}. ${c.because}`;
-  return `
-  - Waits on: deciding **${a.choice}** in art-direction.json.`;
-}
-function retrofitPlan(report, direction) {
-  const lines = [
-    `# Retrofit: ${report.site}`,
-    "",
-    `**Now:** ${report.verdict}. ${report.summary}`,
-    "",
-    "| Signal | Raised | Reading |",
-    "|---|---|---|",
-    ...report.signals.map((s) => `| ${s.id} | ${s.raised === null ? "not measured" : s.raised ? "yes" : "no"} | ${s.detail} |`),
-    "",
-    "**Done when** `craft report` says *decided*: fewer than three design tells, typicality under 0.10 against this brief's null, no sibling in the estate, and at least five of the seven choices decided with a reason.",
-    ""
-  ];
-  let n = 0;
-  for (const area of ORDER) {
-    const list = report.actions.filter((a) => a.area === area);
-    if (list.length === 0) continue;
-    n += 1;
-    lines.push(`## ${n}. ${HEADINGS[area]}`, "");
-    for (const a of list) lines.push(`- [ ] ${a.what} *(${a.why})*${target(a, direction)}`);
-    lines.push("");
-  }
-  if (n === 0) lines.push("Nothing to change.", "");
-  lines.push(
-    "## Leave alone",
-    "",
-    "Navigation, the order of the sections, where the call to action sits, reading order and legibility. Change the look, never the page grammar. A layout tell above is about how a section looks: the icon tiles, the chip, the strip. The section stays where it is.",
-    ""
-  );
-  return lines.join("\n");
-}
-
-// src/report/cli.ts
-var USAGE = "usage: craft report|retrofit <url | snapshot.json> [--repo <dir>] [--null <dir>] [--estate <estate.json>] [--direction <file>] [--json] [--out <file>]";
-var sameUrl = (a, b) => a.replace(/\/+$/, "").toLowerCase() === b.replace(/\/+$/, "").toLowerCase();
-function formatCharacter(r) {
-  const lines = [`craft report ${r.site}`, "", `Verdict: ${r.verdict.toUpperCase()}. ${r.summary}`, ""];
-  for (const s of r.signals) lines.push(`  ${s.id.padEnd(11)} ${s.raised === null ? "\xB7" : s.raised ? "RAISED" : "ok"}  ${s.detail}`);
-  lines.push("", "What to do, in order:");
-  r.actions.slice(0, 12).forEach((a, i) => lines.push(`  ${String(i + 1).padStart(2)}. [${a.area}] ${a.what}`, `      ${a.why}`));
-  if (r.actions.length > 12) lines.push(`  ...and ${r.actions.length - 12} more: craft retrofit writes them all.`);
-  return lines.join("\n");
-}
-async function runReport(command, args, io) {
-  try {
-    const flags = parseFlags(args);
-    if (typeof flags === "string") throw new Error(flags);
-    const target2 = flags.positional[0];
-    if (!target2) throw new Error(USAGE);
-    const page = flags.page ?? "home";
-    if (!PAGE_TYPES.includes(page)) throw new Error(`--page takes one of ${PAGE_TYPES.join(", ")}`);
-    const local = resolve(io.cwd, target2);
-    let snap;
-    if (/\.json$/i.test(target2) && existsSync(local)) {
-      snap = readSnapshot(JSON.parse(readFileSync(local, "utf8")), target2);
-    } else {
-      const { snapshotUrl } = await import("./audit-MTUC24XU.js");
-      snap = await snapshotUrl(target2);
-    }
-    const fp = fingerprint(snap);
-    const repo = flags.repo ? resolve(io.cwd, flags.repo) : null;
-    const exceptions = loadExceptions(flags, repo ?? io.cwd);
-    const config = loadConfig(flags, repo ?? io.cwd);
-    let findings = auditSnapshot(snap, { exceptions });
-    if (repo) {
-      findings = merge(scanSource(readPaths(["."], repo, SOURCE_FILE, void 0, config.ignore), { exceptions }), findings);
-      const copyPaths = config.copyPaths ?? ["."];
-      findings = merge(findings, checkCopy(readPaths(copyPaths, repo, COPY_FILE, (d) => NOT_COPY_DIR(d) || d === "docs", config.ignore), { exceptions }));
-    }
-    findings = applySeverity(findings, config);
-    const nulls = flags.null ? flags.null.split(",").map((p) => loadNull(p.trim(), io.cwd)) : [];
-    const typical = nulls.length ? typicality(fp, nulls.flatMap((m, i) => m.runs.map((r) => nulls.length > 1 ? { ...r, id: `${i + 1}/${r.id}` } : r))) : null;
-    let estate = null;
-    if (flags.estate) {
-      const register = loadEstate(resolve(io.cwd, flags.estate));
-      const self = register.sites.find((s) => sameUrl(s.url, snap.url));
-      estate = compareToEstate(fp, register, { exclude: self?.id, siblingAt: SIBLING_AT });
-    }
-    const directionFile = resolve(repo ?? io.cwd, flags.direction ?? "art-direction.json");
-    let direction = null;
-    let directionReport = null;
-    if (existsSync(directionFile)) {
-      direction = JSON.parse(readFileSync(directionFile, "utf8"));
-      directionReport = validateDirection(direction, {
-        fingerprint: fp,
-        snapshot: snap,
-        page,
-        strict: flags.strict,
-        pathExists: (p) => existsSync(resolve(dirname(directionFile), p)),
-        readSource: (s) => {
-          if (!s.path || /^https?:/.test(s.path) || !/\.(?:txt|md|markdown|csv|json|html?)$/i.test(s.path)) return void 0;
-          const path = resolve(dirname(directionFile), s.path);
-          return existsSync(path) ? readFileSync(path, "utf8") : void 0;
-        }
-      });
-    } else if (flags.direction) {
-      throw new Error(`no such file: ${flags.direction}`);
-    }
-    const copyTells = new Set(CATALOGUE.filter((t) => t.surface === "copy").map((t) => t.id));
-    const report = characterReport({ site: snap.url, findings, typicality: typical, estate, direction: directionReport }, copyTells);
-    if (command === "retrofit") {
-      const plan = retrofitPlan(report, direction);
-      if (flags.out) {
-        writeFileSync(resolve(io.cwd, flags.out), plan);
-        io.out(`craft retrofit: ${report.actions.length} step${report.actions.length === 1 ? "" : "s"} for ${snap.url} in ${flags.out}`);
-      } else io.out(plan);
-      return 0;
-    }
-    io.out(flags.json ? toJson(report) : formatCharacter(report));
-    if (flags.out) writeFileSync(resolve(io.cwd, flags.out), `${toJson(report)}
-`);
-    return flags.strict && report.verdict !== "decided" ? 1 : 0;
-  } catch (error) {
-    io.err(`craft: ${error.message}`);
-    return 2;
-  }
-}
 export {
-  formatCharacter,
-  runReport
+  TELL_HEAVY,
+  characterReport
 };

package/dist/{chunk-MUVFECFC.js → chunk-O5B5ELJH.js}

@@ -1,22 +1,27 @@
+import {
+  toJson
+} from "./chunk-QIEDBL4J.js";
 import {
   CATALOGUE,
   CATALOGUE_VERSION,
   HOUSE_LOCKED,
   applyHouseGate,
   checkCopy,
+  holdHouseBlocks,
+  houseRule,
+  scanSource
+} from "./chunk-WFB6F3BN.js";
+import {
   compareCompetitor,
   compareFacts,
   extractCopy,
   fileKind,
   formatComparison,
   formatCompetitor,
-  holdHouseBlocks,
-  houseRule,
   pageCopy,
   protectedFacts,
-  scanSource,
   visibleText
-} from "./chunk-LFNSB6W7.js";
+} from "./chunk-4QWEAL4G.js";
 
 // src/character/config.ts
 var DEFAULT_IGNORE = [".claude", ".agents", ".cursor"];
@@ -80,12 +85,6 @@ function applySeverity(report, config) {
   return { ...report, findings, summary: { ...report.summary, blocking: findings.filter((f) => f.severity === "block").length } };
 }
 
-// src/character/json.ts
-var JSON_SCHEMA_VERSION = 1;
-function toJson(data) {
-  return JSON.stringify({ schemaVersion: JSON_SCHEMA_VERSION, ...data }, null, 2);
-}
-
 // src/character/cli.ts
 import { execFileSync } from "child_process";
 import { existsSync, readFileSync, readdirSync, statSync, writeFileSync } from "fs";
@@ -382,10 +381,16 @@ Usage
   craft direction research [--brief "<who, where, what>"] [--visual]
   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 null import <dir> --builder <name> --brief "<text>" [--out <dir>] [--model <name>]
+  craft null prompt --brief "<text>"
   craft estate add [<url | snapshot.json>] --id <id> [--client <name>] [--direction <art-direction.json>] [--estate <file>]
   craft estate compare [<url | snapshot.json | id>] [--null <dir>] [--directions] [--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]
+  craft calibrate <labels.json> [--out <dir>] [--fresh] [--json]
+  craft register list [--json]
+  craft register brief <plain|persuasive|warm|literary> [--json]
+  craft register check <file> --as <register> [--json]
 
 scan      Markup, component code and stylesheets (source and compiled CSS).
           --staged reads the git index, for a pre-commit hook.
@@ -419,6 +424,10 @@ direction The site's art-direction.json: every choice with a reason from 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.
+          import does the same for pages another builder made (v0, Lovable):
+          each an HTML file, or a folder holding a built index.html, served
+          on loopback so its asset paths resolve. prompt prints what to give
+          the builder, so its pages answer the same brief. 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.
@@ -427,6 +436,15 @@ report    Every signal for one site: tells, typicality, the estate, the reasons.
           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.
+calibrate How well the catalogue separates a labelled set (ai, human,
+          ai-looking): precision and recall per tell, and CHARACTER.md's
+          first three targets. --out keeps results.json and any snapshots it
+          took; --fresh takes every snapshot again. A page not measured is
+          listed, and never counts as a pass. A measure: always exit 0.
+register  Writing in a chosen register (REGISTERS.md). brief prints what to
+          do before drafting; check places a draft of five or more
+          paragraphs against the human baselines for that register. Never
+          fails: exit 0, or 2 on bad usage.
 
 ci options (scan, copy, audit)
   --baseline <file>     Report only findings the baseline does not already
@@ -463,10 +481,11 @@ var VALUE_FLAGS = {
   "--viewport": "viewport",
   "--component": "component",
   "--competitor": "competitor",
-  "--page": "page"
+  "--page": "page",
+  "--builder": "builder"
 };
 function parseFlags(args) {
-  const flags = { positional: [], json: false, strict: false, staged: false, gate: false, updateBaseline: false, directions: false, visual: false };
+  const flags = { positional: [], json: false, strict: false, staged: false, gate: false, updateBaseline: false, directions: false, visual: false, fresh: false };
   for (let i = 0; i < args.length; i += 1) {
     const a = args[i];
     if (a === "--json") flags.json = true;
@@ -476,6 +495,7 @@ function parseFlags(args) {
     else if (a === "--update-baseline") flags.updateBaseline = true;
     else if (a === "--directions") flags.directions = true;
     else if (a === "--visual") flags.visual = true;
+    else if (a === "--fresh") flags.fresh = true;
     else if (a in VALUE_FLAGS) {
       const value = args[i + 1];
       i += 1;
@@ -580,7 +600,7 @@ async function pageSnapshot(target, cwd) {
     return readSnapshot(JSON.parse(readFileSync(local, "utf8")), target);
   }
   if (!/^https?:\/\//.test(target)) throw new Error(`${target} is neither a URL nor a snapshot file`);
-  const { snapshotUrl } = await import("./audit-MTUC24XU.js");
+  const { snapshotUrl } = await import("./audit-4SFSLCKY.js");
   return snapshotUrl(target);
 }
 async function briefFor(flags, cwd) {
@@ -591,7 +611,7 @@ async function briefFor(flags, cwd) {
     if (typeof brief === "string" && brief.trim()) return brief;
   } else if (flags.direction) throw new Error(`no such file: ${flags.direction}`);
   if (flags.null) {
-    const { loadNull } = await import("./cli-FLG3ZCAF.js");
+    const { loadNull } = await import("./cli-BN4IT6N2.js");
     return loadNull(flags.null, cwd).brief;
   }
   return void 0;
@@ -617,25 +637,31 @@ async function compareWithCompetitor(flags, io) {
 function run(argv, io) {
   const [command, ...rest] = argv;
   if (command === "direction") {
-    return import("./cli-7OZCYOQY.js").then((m) => m.runDirection(rest, io));
+    return import("./cli-Y7Y5IROK.js").then((m) => m.runDirection(rest, io));
   }
   if (command === "report" || command === "retrofit") {
-    return import("./cli-FCKHYAVZ.js").then((m) => m.runReport(command, rest, io));
+    return import("./cli-V44QEVS6.js").then((m) => m.runReport(command, rest, io));
+  }
+  if (command === "register") {
+    return import("./cli-JB4X5LAG.js").then((m) => m.runRegister(rest, io));
   }
   if (command === "estate") {
-    return import("./cli-22TSWAX6.js").then((m) => m.runEstate(rest, io));
+    return import("./cli-GXIW7F3E.js").then((m) => m.runEstate(rest, io));
   }
   if (command === "null") {
-    return import("./cli-FLG3ZCAF.js").then((m) => m.runNull(rest, io));
+    return import("./cli-BN4IT6N2.js").then((m) => m.runNull(rest, io));
+  }
+  if (command === "calibrate") {
+    return import("./cli-MDW7JTEF.js").then((m) => m.runCalibrate(rest, io));
   }
   if (command === "tells" && rest[0] === "harvest") {
-    return import("./cli-FLG3ZCAF.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
+    return import("./cli-BN4IT6N2.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
       io.err(`craft: ${error.message}`);
       return 2;
     });
   }
   if (command === "snapshot" || command === "audit") {
-    return import("./cli-5ACKICBO.js").then((m) => m.runAudit(command, rest, io));
+    return import("./cli-JZRQBCD4.js").then((m) => m.runAudit(command, rest, io));
   }
   if (!command || command === "help" || command === "--help" || command === "-h") {
     io.out(HELP);
@@ -722,7 +748,6 @@ function run(argv, io) {
 
 export {
   applySeverity,
-  toJson,
   parseFlags,
   readPaths,
   loadConfig,

package/dist/chunk-QIEDBL4J.js

@@ -0,0 +1,9 @@
+// src/character/json.ts
+var JSON_SCHEMA_VERSION = 1;
+function toJson(data) {
+  return JSON.stringify({ schemaVersion: JSON_SCHEMA_VERSION, ...data }, null, 2);
+}
+
+export {
+  toJson
+};

package/dist/{chunk-QU6Q2QZZ.js → chunk-RJVG5KA6.js}

@@ -4,14 +4,16 @@ import {
   formatDirectionMatches,
   summariseDirection,
   validateDirection
-} from "./chunk-YDURAOYR.js";
+} from "./chunk-6TSDYETQ.js";
 import {
   loadNull
-} from "./chunk-RXXRXV3V.js";
+} from "./chunk-ZUYERAFM.js";
+import {
+  parseFlags
+} from "./chunk-O5B5ELJH.js";
 import {
-  parseFlags,
   toJson
-} from "./chunk-MUVFECFC.js";
+} from "./chunk-QIEDBL4J.js";
 import {
   readSnapshot
 } from "./chunk-WUACK2HX.js";
@@ -26,7 +28,7 @@ import {
   groundName,
   hueName,
   shapeName
-} from "./chunk-LFNSB6W7.js";
+} from "./chunk-WFB6F3BN.js";
 
 // src/estate/cli.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -103,7 +105,7 @@ async function snapshotOf(target, cwd) {
     return snap;
   }
   if (!/^https?:\/\//.test(target)) throw new Error(`${target} is neither a URL, a snapshot file, nor a site in the register`);
-  const { snapshotUrl } = await import("./audit-MTUC24XU.js");
+  const { snapshotUrl } = await import("./audit-4SFSLCKY.js");
   return snapshotUrl(target);
 }
 var line = (distance, sibling, shared) => `${distance.toFixed(2)}${sibling ? "  SIBLING" : ""}${shared.length ? `  shares ${shared.join(", ")}` : ""}`;

package/dist/{chunk-OUQ25LY2.js → chunk-SL5VZJ2J.js}

@@ -4,7 +4,7 @@ import {
 import {
   auditSnapshot,
   fingerprint
-} from "./chunk-LFNSB6W7.js";
+} from "./chunk-WFB6F3BN.js";
 import {
   SNAPSHOT_VERSION
 } from "./chunk-QYBAVU3P.js";