@domandigital/craft 0.14.0 → 0.16.0

package/dist/{chunk-PBK6SYH5.js → chunk-CVG5GSMN.js}

@@ -1,15 +1,23 @@
+import {
+  compareDirections,
+  compareToDeclared,
+  formatDirectionMatches,
+  summariseDirection,
+  validateDirection
+} from "./chunk-WAV6AKR4.js";
 import {
   loadNull
-} from "./chunk-XVBR2UPH.js";
+} from "./chunk-LWVGIJ5A.js";
 import {
   parseFlags,
   toJson
-} from "./chunk-3OTKMKJQ.js";
+} from "./chunk-LXDNIJFG.js";
 import {
   readSnapshot
 } from "./chunk-WUACK2HX.js";
 import {
   COMPONENT_ROLES,
+  SHARED_PART,
   auditSnapshot,
   closestComponents,
   estateComponentPairs,
@@ -18,7 +26,7 @@ import {
   groundName,
   hueName,
   shapeName
-} from "./chunk-GQVEYTBY.js";
+} from "./chunk-B2MJLGF6.js";
 
 // src/estate/cli.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -37,7 +45,7 @@ function addSite(register, site) {
 }
 function sharedParts(a, b, d = fingerprintDistance(a, b)) {
   const out = [];
-  const close = (k) => d.parts[k] <= 0.2;
+  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`);
@@ -52,14 +60,14 @@ function sharedParts(a, b, d = fingerprintDistance(a, b)) {
 }
 function compareToEstate(target, register, options = {}) {
   const at = options.siblingAt ?? SIBLING_AT;
-  return register.sites.filter((s) => s.id !== options.exclude).map((s) => {
+  return register.sites.filter((s) => s.id !== options.exclude && s.fingerprint).map((s) => {
     const d = fingerprintDistance(target, s.fingerprint);
     return { id: s.id, distance: d.total, sibling: d.total < at, shared: sharedParts(target, s.fingerprint, d) };
   }).sort((a, b) => a.distance - b.distance);
 }
 function estatePairs(register, siblingAt = SIBLING_AT) {
   const out = [];
-  const s = register.sites;
+  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);
@@ -81,7 +89,7 @@ function siblingLine(briefs) {
 }
 
 // src/estate/cli.ts
-var USAGE = "usage: craft estate add <url | snapshot.json> --id <id> [--client <name>] | craft estate compare [<url | snapshot.json | id>] [--null <dir>] [--component <role>] [--json] [--strict]";
+var USAGE = "usage: craft estate add [<url | snapshot.json>] --id <id> [--client <name>] [--direction <art-direction.json>] | craft estate compare [<url | snapshot.json | id>] [--null <dir>] [--component <role>] [--directions] [--json] [--strict]";
 function loadEstate(path) {
   if (!existsSync(path)) return emptyEstate();
   const data = JSON.parse(readFileSync(path, "utf8"));
@@ -95,7 +103,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-6WHR7ZTV.js");
+  const { snapshotUrl } = await import("./audit-UJCUWORL.js");
   return snapshotUrl(target);
 }
 var line = (distance, sibling, shared) => `${distance.toFixed(2)}${sibling ? "  SIBLING" : ""}${shared.length ? `  shares ${shared.join(", ")}` : ""}`;
@@ -115,7 +123,7 @@ function componentRole(name) {
   if (!COMPONENT_ROLES.includes(name)) throw new Error(`--component takes one of ${COMPONENT_ROLES.join(", ")}`);
   return name;
 }
-var withRole = (register, role) => register.sites.filter((s) => (s.fingerprint.sections ?? []).some((x) => x.role === role)).length;
+var withRole = (register, role) => register.sites.filter((s) => (s.fingerprint?.sections ?? []).some((x) => x.role === role)).length;
 function formatComponentPairs(role, pairs, measured, sites) {
   const lines = [`craft estate: ${role} components, ${measured} of ${sites} sites have one, closest pairs first (no sibling line yet: ranked, not judged)`];
   for (const p of pairs) lines.push(`  ${`${p.a} + ${p.b}`.padEnd(34)} ${p.distance.toFixed(2)}${p.shared.length ? `  shares ${p.shared.join(", ")}` : ""}`);
@@ -134,6 +142,19 @@ async function runEstate(args, io) {
     const file = resolve(io.cwd, flags.estate ?? "estate.json");
     const register = loadEstate(file);
     const at = flags.null ? siblingLine(flags.null.split(",").map((p) => loadNull(p.trim(), io.cwd).runs.map((r) => r.fingerprint))) : SIBLING_AT;
+    const directionFile = flags.direction ? JSON.parse(readFileSync(resolve(io.cwd, flags.direction), "utf8")) : void 0;
+    if (directionFile && !validateDirection(directionFile).valid) throw new Error("the direction has errors: run craft direction validate before registering it");
+    const declared = () => summariseDirection(directionFile);
+    if (sub === "add" && !target && flags.id && flags.direction) {
+      const existing = register.sites.find((s) => s.id === flags.id);
+      const direction = declared();
+      const next = addSite(register, { ...existing ?? { id: flags.id, client: flags.client ?? directionFile.client, url: "", tells: [], addedAt: (/* @__PURE__ */ new Date()).toISOString() }, direction });
+      writeFileSync(file, `${JSON.stringify(next, null, 2)}
+`);
+      io.out(`craft estate: ${flags.id} direction recorded.`);
+      io.out(formatDirectionMatches(flags.id, compareToDeclared(direction, next.sites, flags.id)));
+      return 0;
+    }
     if (sub === "add") {
       if (!target || !flags.id) throw new Error(USAGE);
       const snap = await snapshotOf(target, io.cwd);
@@ -144,7 +165,8 @@ async function runEstate(args, io) {
         url: snap.url,
         fingerprint: fp,
         tells: [...new Set(auditSnapshot(snap).findings.map((f) => f.tell))].sort(),
-        addedAt: snap.capturedAt
+        addedAt: snap.capturedAt,
+        ...flags.direction ? { direction: declared() } : register.sites.find((s) => s.id === flags.id)?.direction ? { direction: register.sites.find((s) => s.id === flags.id).direction } : {}
       });
       writeFileSync(file, `${JSON.stringify(next, null, 2)}
 `);
@@ -152,6 +174,17 @@ async function runEstate(args, io) {
       io.out(formatMatches(flags.id, compareToEstate(fp, next, { exclude: flags.id, siblingAt: at }).slice(0, 3), at));
       return 0;
     }
+    if (sub === "compare" && flags.directions) {
+      const withDirection = register.sites.filter((s) => s.direction);
+      const pairs = withDirection.flatMap((a, i) => withDirection.slice(i + 1).map((b) => ({ a: a.id, b: b.id, ...compareDirections(a.direction, b.direction) })));
+      pairs.sort((x, y) => y.shared.length - x.shared.length);
+      if (flags.json) io.out(toJson({ sites: withDirection.length, pairs }));
+      else {
+        io.out(`craft estate: ${withDirection.length} of ${register.sites.length} sites have a declared direction, ${pairs.filter((p) => p.flagged).length} pair(s) worth a look (ranked, not judged)`);
+        for (const p of pairs) io.out(`  ${`${p.a} + ${p.b}`.padEnd(34)} ${p.flagged ? "LOOK  " : "      "}${p.shared.length ? `shares ${p.shared.join(", ")}` : "nothing shared"}`);
+      }
+      return 0;
+    }
     if (sub === "compare" && flags.component) {
       const role = componentRole(flags.component);
       if (!target) {
@@ -161,9 +194,10 @@ async function runEstate(args, io) {
         return 0;
       }
       const known = register.sites.find((s) => s.id === target);
+      if (known && !known.fingerprint) throw new Error(`${target} has a declared direction only; add a snapshot to compare rendered components`);
       const fp = known ? known.fingerprint : fingerprint(await snapshotOf(target, io.cwd));
       if (!(fp.sections ?? []).some((x) => x.role === role)) throw new Error(`${known?.id ?? target} has no ${role} section measured (roles need snapshot version 2)`);
-      const pairs = register.sites.filter((s) => s.id !== known?.id).flatMap((s) => {
+      const pairs = register.sites.filter((s) => s.id !== known?.id && s.fingerprint).flatMap((s) => {
         const c = closestComponents(fp, s.fingerprint, role);
         return c ? [{ a: known?.id ?? target, b: s.id, ...c }] : [];
       }).sort((x, y) => x.distance - y.distance);
@@ -177,6 +211,7 @@ async function runEstate(args, io) {
         return flags.strict && pairs.some((p) => p.sibling) ? 1 : 0;
       }
       const known = register.sites.find((s) => s.id === target);
+      if (known && !known.fingerprint) throw new Error(`${target} has a declared direction only; add a snapshot to compare rendered sites`);
       const fp = known ? known.fingerprint : fingerprint(await snapshotOf(target, io.cwd));
       const matches = compareToEstate(fp, register, { exclude: known?.id, siblingAt: at });
       io.out(flags.json ? toJson({ siblingAt: at, matches }) : formatMatches(known?.id ?? target, matches, at));

package/dist/{chunk-XVBR2UPH.js → chunk-LWVGIJ5A.js}

@@ -1,12 +1,16 @@
+import {
+  generate
+} from "./chunk-OQXTQQAU.js";
 import {
   parseFlags,
   toJson
-} from "./chunk-3OTKMKJQ.js";
+} from "./chunk-LXDNIJFG.js";
 import {
   readSnapshot
 } from "./chunk-WUACK2HX.js";
 import {
   CATALOGUE_VERSION,
+  MIN_RUNS,
   NULL_VERSION,
   auditSnapshot,
   checkCopy,
@@ -17,34 +21,20 @@ import {
   hueSwatch,
   nullPrompt,
   scanSource
-} from "./chunk-GQVEYTBY.js";
+} from "./chunk-B2MJLGF6.js";
 
 // src/null/cli.ts
-import { spawn } from "child_process";
-import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "fs";
-import { tmpdir } from "os";
-import { join, relative, resolve } from "path";
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "fs";
+import { createServer } from "http";
+import { extname, join, relative, resolve, sep } from "path";
 import { pathToFileURL } from "url";
 var readJson = (path) => JSON.parse(readFileSync(path, "utf8"));
+var NULL_USAGE = [
+  'usage: 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>"'
+].join("\n");
 var pad = (n) => String(n).padStart(2, "0");
-function generate(prompt, model) {
-  const bin = process.env.CRAFT_CLAUDE ?? "claude";
-  const args = ["-p", "--tools", "", "--no-session-persistence", "--disable-slash-commands", "--setting-sources", "", "--strict-mcp-config", ...model ? ["--model", model] : [], prompt];
-  const cwd = mkdtempSync(join(tmpdir(), "craft-null-"));
-  return new Promise((done, fail) => {
-    const child = spawn(bin, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
-    let out = "";
-    let err = "";
-    child.stdout.on("data", (d) => out += d.toString());
-    child.stderr.on("data", (d) => err += d.toString());
-    child.on("error", (e) => fail(new Error(`${bin}: ${e.message}. Install Claude Code, or set CRAFT_CLAUDE.`)));
-    child.on("close", (code) => {
-      rmSync(cwd, { recursive: true, force: true });
-      if (code === 0) done(out);
-      else fail(new Error(`${bin} exited ${code}: ${(err || out).trim().slice(0, 200)}`));
-    });
-  });
-}
 async function pool(items, size, work) {
   const queue = [...items];
   await Promise.all(Array.from({ length: Math.max(1, Math.min(size, queue.length)) }, async () => {
@@ -55,6 +45,15 @@ function nullPath(target, cwd) {
   const abs = resolve(cwd, target);
   return existsSync(abs) && statSync(abs).isDirectory() ? join(abs, "null.json") : abs;
 }
+function expandNullTargets(targets, cwd) {
+  return targets.flatMap((t) => {
+    const abs = resolve(cwd, t);
+    if (existsSync(abs) && statSync(abs).isDirectory() && !existsSync(join(abs, "null.json"))) {
+      return readdirSync(abs).sort().map((d) => join(abs, d, "null.json")).filter((p) => existsSync(p));
+    }
+    return [t];
+  });
+}
 function loadNull(target, cwd) {
   const path = nullPath(target, cwd);
   if (!existsSync(path)) throw new Error(`no null model at ${target}. Build one with craft null build.`);
@@ -62,10 +61,11 @@ function loadNull(target, cwd) {
   if (model.version !== NULL_VERSION) throw new Error(`${target} is null model version ${String(model.version)}; this craft reads ${NULL_VERSION}`);
   return model;
 }
-function measureRun(id, html, snapshot) {
+function measureRun(id, html, snapshot, styles = []) {
   const file = { path: `${id}.html`, text: html };
-  const tells = new Set([...auditSnapshot(snapshot).findings, ...scanSource([file]).findings].map((f) => f.tell));
-  const copy = [...new Set(extractStrings(file).filter((b) => !b.literal).map((b) => b.text.replace(/\s+/g, " ").trim()).filter(Boolean))];
+  const tells = new Set([...auditSnapshot(snapshot).findings, ...scanSource([file, ...styles]).findings].map((f) => f.tell));
+  let copy = [...new Set(extractStrings(file).filter((b) => !b.literal).map((b) => b.text.replace(/\s+/g, " ").trim()).filter(Boolean))];
+  if (copy.length === 0) copy = [...new Set(snapshot.sections.flatMap((s) => s.text ?? []).map((t) => t.replace(/\s+/g, " ").trim()).filter(Boolean))];
   return { id, fingerprint: fingerprint(snapshot), tells: [...tells].sort(), copy };
 }
 async function build(flags, io) {
@@ -115,7 +115,7 @@ async function build(flags, io) {
   const toShoot = ids.filter((id) => existsSync(join(pages, `${id}.html`)) && !existsSync(join(shots, `${id}.json`)));
   if (toShoot.length) {
     io.out(`craft null: snapshotting ${toShoot.length} page${toShoot.length === 1 ? "" : "s"}`);
-    const { snapshotUrls } = await import("./audit-6WHR7ZTV.js");
+    const { snapshotUrls } = await import("./audit-UJCUWORL.js");
     const results = await snapshotUrls(toShoot.map((id) => pathToFileURL(join(pages, `${id}.html`)).href));
     results.forEach((r, i) => {
       const id = toShoot[i];
@@ -144,6 +144,142 @@ async function build(flags, io) {
   }
   return 0;
 }
+function findImportPages(dir) {
+  const pages = [];
+  for (const e of readdirSync(dir, { withFileTypes: true })) {
+    if (e.isFile() && /\.html?$/i.test(e.name)) pages.push({ id: e.name.replace(/\.html?$/i, ""), root: dir, entry: e.name });
+    else if (e.isDirectory() && existsSync(join(dir, e.name, "index.html"))) pages.push({ id: e.name, root: join(dir, e.name), entry: "index.html" });
+  }
+  const ids = pages.map((p) => p.id);
+  const twice = ids.find((id, i) => ids.indexOf(id) !== i);
+  if (twice) throw new Error(`"${twice}" is both a file and a folder; rename one`);
+  return pages.sort((a, b) => a.id.localeCompare(b.id));
+}
+var TYPES = {
+  ".html": "text/html",
+  ".htm": "text/html",
+  ".css": "text/css",
+  ".js": "text/javascript",
+  ".mjs": "text/javascript",
+  ".json": "application/json",
+  ".svg": "image/svg+xml",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".webp": "image/webp",
+  ".avif": "image/avif",
+  ".gif": "image/gif",
+  ".ico": "image/x-icon",
+  ".woff": "font/woff",
+  ".woff2": "font/woff2",
+  ".ttf": "font/ttf",
+  ".otf": "font/otf"
+};
+function serveDir(root) {
+  const server = createServer((req, res) => {
+    let file;
+    try {
+      file = resolve(root, `.${decodeURIComponent(new URL(req.url ?? "/", "http://local").pathname)}`);
+    } catch {
+      res.statusCode = 400;
+      return void res.end();
+    }
+    if (file !== root && !file.startsWith(root + sep)) {
+      res.statusCode = 403;
+      return void res.end();
+    }
+    if (existsSync(file) && statSync(file).isDirectory()) file = join(file, "index.html");
+    if (!existsSync(file)) {
+      res.statusCode = 404;
+      return void res.end();
+    }
+    res.setHeader("content-type", TYPES[extname(file).toLowerCase()] ?? "application/octet-stream");
+    res.end(readFileSync(file));
+  });
+  return new Promise((done, fail) => {
+    server.once("error", fail);
+    server.listen(
+      0,
+      "127.0.0.1",
+      () => done({
+        base: `http://127.0.0.1:${server.address().port}`,
+        close: () => new Promise((closed) => server.close(() => closed()))
+      })
+    );
+  });
+}
+function stylesheets(root, id) {
+  const found = [];
+  const walk = (dir) => {
+    for (const e of readdirSync(dir, { withFileTypes: true })) {
+      const path = join(dir, e.name);
+      if (e.isDirectory() && e.name !== "node_modules" && !e.name.startsWith(".")) walk(path);
+      else if (e.isFile() && e.name.endsWith(".css") && statSync(path).size <= 1e6) found.push({ path: `${id}/${relative(root, path)}`, text: readFileSync(path, "utf8") });
+    }
+  };
+  walk(root);
+  return found;
+}
+async function importPages(flags, io) {
+  const usage = 'usage: craft null import <dir> --builder <name> --brief "<who, where, what they do>" [--out <dir>] [--model <name>]';
+  const from = flags.positional[1];
+  const brief = flags.brief?.trim();
+  if (!from || flags.positional.length > 2 || !flags.builder || !brief || brief.split(/\s+/).length < 5) throw new Error(usage);
+  const dir = resolve(io.cwd, from);
+  if (!existsSync(dir) || !statSync(dir).isDirectory()) throw new Error(`no directory at ${from}`);
+  const pages = findImportPages(dir);
+  if (pages.length < MIN_RUNS) throw new Error(`${from} holds ${pages.length} page${pages.length === 1 ? "" : "s"}; a null model needs at least ${MIN_RUNS}`);
+  const out = resolve(io.cwd, flags.out ?? from);
+  const shots = join(out, "snapshots");
+  mkdirSync(shots, { recursive: true });
+  const failed = [];
+  const toShoot = pages.filter((p) => !existsSync(join(shots, `${p.id}.json`)));
+  if (toShoot.length) {
+    io.out(`craft null: snapshotting ${toShoot.length} page${toShoot.length === 1 ? "" : "s"} from ${flags.builder}`);
+    const { snapshotUrls } = await import("./audit-UJCUWORL.js");
+    const servers = /* @__PURE__ */ new Map();
+    try {
+      for (const p of toShoot) if (!servers.has(p.root)) servers.set(p.root, await serveDir(p.root));
+      const urls = toShoot.map((p) => `${servers.get(p.root)?.base}/${p.entry === "index.html" ? "" : encodeURIComponent(p.entry)}`);
+      const results = await snapshotUrls(urls);
+      results.forEach((r, i) => {
+        const p = toShoot[i];
+        if (r.snapshot) writeFileSync(join(shots, `${p.id}.json`), `${JSON.stringify({ ...r.snapshot, url: relative(out, join(p.root, p.entry)) }, null, 2)}
+`);
+        else failed.push(`${p.id}: the page would not render: ${r.error}`);
+      });
+    } finally {
+      await Promise.all([...servers.values()].map((s) => s.close()));
+    }
+  }
+  const measured = pages.filter((p) => existsSync(join(shots, `${p.id}.json`))).map(
+    (p) => measureRun(
+      p.id,
+      readFileSync(join(p.root, p.entry), "utf8"),
+      readSnapshot(readJson(join(shots, `${p.id}.json`)), `${p.id}.json`),
+      p.root === dir ? [] : stylesheets(p.root, p.id)
+    )
+  );
+  if (measured.length < MIN_RUNS) {
+    for (const f of failed) io.err(`  ${f}`);
+    throw new Error(`only ${measured.length} of ${pages.length} pages rendered; a null model needs at least ${MIN_RUNS}`);
+  }
+  const model = {
+    version: NULL_VERSION,
+    brief,
+    prompt: nullPrompt(brief),
+    model: flags.model ?? "unknown",
+    builder: flags.builder,
+    catalogueVersion: CATALOGUE_VERSION,
+    builtAt: (/* @__PURE__ */ new Date()).toISOString(),
+    runs: measured
+  };
+  writeFileSync(join(out, "null.json"), `${JSON.stringify(model, null, 2)}
+`);
+  io.out(`craft null: ${measured.length} of ${pages.length} pages from ${flags.builder} in ${relative(io.cwd, join(out, "null.json")) || "null.json"}`);
+  for (const f of failed) io.err(`  ${f}`);
+  return measured.length < pages.length ? 1 : 0;
+}
 function copyTell(phrase) {
   const text = `We found that ${phrase} was there.`;
   const hit = checkCopy([{ path: "phrase.md", text }]).findings[0];
@@ -179,7 +315,13 @@ async function runNull(args, io) {
   try {
     const flags = parseFlags(args);
     if (typeof flags === "string") throw new Error(flags);
-    if (flags.positional[0] !== "build") throw new Error('usage: craft null build --brief "<text>" --out <dir> [--runs 20] [--parallel 4] [--model <name>]');
+    if (flags.positional[0] === "import") return await importPages(flags, io);
+    if (flags.positional[0] === "prompt") {
+      if (!flags.brief || flags.brief.trim().split(/\s+/).length < 5) throw new Error('usage: craft null prompt --brief "<who, where, what they do>"');
+      io.out(nullPrompt(flags.brief));
+      return 0;
+    }
+    if (flags.positional[0] !== "build") throw new Error(NULL_USAGE);
     return await build(flags, io);
   } catch (error) {
     io.err(`craft: ${error.message}`);
@@ -191,14 +333,7 @@ function runHarvest(args, io) {
   if (typeof flags === "string") throw new Error(flags);
   const targets = flags.positional.slice(1);
   if (targets.length === 0) throw new Error("usage: craft tells harvest <null.json | dir>... [--share 0.25] [--json]");
-  const paths = targets.flatMap((t) => {
-    const abs = resolve(io.cwd, t);
-    if (existsSync(abs) && statSync(abs).isDirectory() && !existsSync(join(abs, "null.json"))) {
-      return readdirSync(abs).map((d) => join(abs, d, "null.json")).filter((p) => existsSync(p));
-    }
-    return [t];
-  });
-  const models = paths.map((p) => loadNull(p, io.cwd));
+  const models = expandNullTargets(targets, io.cwd).map((p) => loadNull(p, io.cwd));
   const minShare = flags.share === void 0 ? void 0 : Number(flags.share);
   if (minShare !== void 0 && !(minShare > 0 && minShare <= 1)) throw new Error("--share needs a number above 0 and at most 1");
   const candidates = harvest(models, { minShare, copyTell });
@@ -208,8 +343,11 @@ function runHarvest(args, io) {
 
 export {
   nullPath,
+  expandNullTargets,
   loadNull,
   measureRun,
+  findImportPages,
+  serveDir,
   formatHarvest,
   describeTypicality,
   runNull,

package/dist/{chunk-3OTKMKJQ.js → chunk-LXDNIJFG.js}

@@ -16,7 +16,7 @@ import {
   protectedFacts,
   scanSource,
   visibleText
-} from "./chunk-GQVEYTBY.js";
+} from "./chunk-B2MJLGF6.js";
 
 // src/character/config.ts
 var DEFAULT_IGNORE = [".claude", ".agents", ".cursor"];
@@ -377,14 +377,18 @@ Usage
   craft snapshot <url> [--out <file>] [--width <px>] [--height <px>]
   craft audit <url | snapshot.json> [--repo <dir>] [--null <null.json>] [--out <file>] [--json] [--strict] [ci options]
   craft audit --pages <sitemap.xml | urls.txt> [--viewport 390,768,1440] [the same]
-  craft direction init [--snapshot <file>] [--client <name>] [--out <file>]
-  craft direction validate [--snapshot <file>] [--direction <file>] [--json]
+  craft direction init [--snapshot <file | url>] [--client <name>] [--brief "<text>"] [--out <file>]
+  craft direction validate [--snapshot <file | url>] [--page home] [--estate <estate.json>] [--direction <file>] [--strict] [--json]
+  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 estate add <url | snapshot.json> --id <id> [--client <name>] [--estate <file>]
-  craft estate compare [<url | snapshot.json | id>] [--null <dir>] [--json] [--strict]
+  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]
 
 scan      Markup, component code and stylesheets (source and compiled CSS).
           --staged reads the git index, for a pre-commit hook.
@@ -418,6 +422,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.
@@ -426,6 +434,11 @@ 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.
 
 ci options (scan, copy, audit)
   --baseline <file>     Report only findings the baseline does not already
@@ -461,10 +474,12 @@ var VALUE_FLAGS = {
   "--pages": "pages",
   "--viewport": "viewport",
   "--component": "component",
-  "--competitor": "competitor"
+  "--competitor": "competitor",
+  "--page": "page",
+  "--builder": "builder"
 };
 function parseFlags(args) {
-  const flags = { positional: [], json: false, strict: false, staged: false, gate: false, updateBaseline: 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;
@@ -472,6 +487,9 @@ function parseFlags(args) {
     else if (a === "--staged") flags.staged = true;
     else if (a === "--gate") flags.gate = true;
     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;
@@ -576,7 +594,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-6WHR7ZTV.js");
+  const { snapshotUrl } = await import("./audit-UJCUWORL.js");
   return snapshotUrl(target);
 }
 async function briefFor(flags, cwd) {
@@ -587,7 +605,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-Z2IQG3LC.js");
+    const { loadNull } = await import("./cli-AVYNHBFJ.js");
     return loadNull(flags.null, cwd).brief;
   }
   return void 0;
@@ -613,25 +631,28 @@ async function compareWithCompetitor(flags, io) {
 function run(argv, io) {
   const [command, ...rest] = argv;
   if (command === "direction") {
-    return import("./cli-O3CDSONO.js").then((m) => m.runDirection(rest, io));
+    return import("./cli-K4LSRYBE.js").then((m) => m.runDirection(rest, io));
   }
   if (command === "report" || command === "retrofit") {
-    return import("./cli-WG3UJNUF.js").then((m) => m.runReport(command, rest, io));
+    return import("./cli-CWORJYOU.js").then((m) => m.runReport(command, rest, io));
   }
   if (command === "estate") {
-    return import("./cli-3CGUKXY4.js").then((m) => m.runEstate(rest, io));
+    return import("./cli-PEATEW57.js").then((m) => m.runEstate(rest, io));
   }
   if (command === "null") {
-    return import("./cli-Z2IQG3LC.js").then((m) => m.runNull(rest, io));
+    return import("./cli-AVYNHBFJ.js").then((m) => m.runNull(rest, io));
+  }
+  if (command === "calibrate") {
+    return import("./cli-3GQROFCB.js").then((m) => m.runCalibrate(rest, io));
   }
   if (command === "tells" && rest[0] === "harvest") {
-    return import("./cli-Z2IQG3LC.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
+    return import("./cli-AVYNHBFJ.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
       io.err(`craft: ${error.message}`);
       return 2;
     });
   }
   if (command === "snapshot" || command === "audit") {
-    return import("./cli-WSHPSWVU.js").then((m) => m.runAudit(command, rest, io));
+    return import("./cli-52M62QBN.js").then((m) => m.runAudit(command, rest, io));
   }
   if (!command || command === "help" || command === "--help" || command === "-h") {
     io.out(HELP);