@domandigital/craft 0.14.0 → 0.15.0

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

@@ -16,7 +16,7 @@ import {
   protectedFacts,
   scanSource,
   visibleText
-} from "./chunk-GQVEYTBY.js";
+} from "./chunk-LFNSB6W7.js";
 
 // src/character/config.ts
 var DEFAULT_IGNORE = [".claude", ".agents", ".cursor"];
@@ -377,12 +377,13 @@ 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 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]
 
@@ -461,10 +462,11 @@ var VALUE_FLAGS = {
   "--pages": "pages",
   "--viewport": "viewport",
   "--component": "component",
-  "--competitor": "competitor"
+  "--competitor": "competitor",
+  "--page": "page"
 };
 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 };
   for (let i = 0; i < args.length; i += 1) {
     const a = args[i];
     if (a === "--json") flags.json = true;
@@ -472,6 +474,8 @@ 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 in VALUE_FLAGS) {
       const value = args[i + 1];
       i += 1;
@@ -576,7 +580,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-MTUC24XU.js");
   return snapshotUrl(target);
 }
 async function briefFor(flags, cwd) {
@@ -587,7 +591,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-FLG3ZCAF.js");
     return loadNull(flags.null, cwd).brief;
   }
   return void 0;
@@ -613,25 +617,25 @@ 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-7OZCYOQY.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-FCKHYAVZ.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-22TSWAX6.js").then((m) => m.runEstate(rest, io));
   }
   if (command === "null") {
-    return import("./cli-Z2IQG3LC.js").then((m) => m.runNull(rest, io));
+    return import("./cli-FLG3ZCAF.js").then((m) => m.runNull(rest, io));
   }
   if (command === "tells" && rest[0] === "harvest") {
-    return import("./cli-Z2IQG3LC.js").then((m) => m.runHarvest(rest, io)).catch((error) => {
+    return import("./cli-FLG3ZCAF.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-5ACKICBO.js").then((m) => m.runAudit(command, rest, io));
   }
   if (!command || command === "help" || command === "--help" || command === "-h") {
     io.out(HELP);

package/dist/chunk-OQXTQQAU.js

@@ -0,0 +1,27 @@
+// src/null/generate.ts
+import { spawn } from "child_process";
+import { mkdtempSync, rmSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+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)}`));
+    });
+  });
+}
+
+export {
+  generate
+};

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

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

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

@@ -1,15 +1,23 @@
+import {
+  compareDirections,
+  compareToDeclared,
+  formatDirectionMatches,
+  summariseDirection,
+  validateDirection
+} from "./chunk-YDURAOYR.js";
 import {
   loadNull
-} from "./chunk-XVBR2UPH.js";
+} from "./chunk-RXXRXV3V.js";
 import {
   parseFlags,
   toJson
-} from "./chunk-3OTKMKJQ.js";
+} from "./chunk-MUVFECFC.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-LFNSB6W7.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-MTUC24XU.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-RXXRXV3V.js}

@@ -1,7 +1,10 @@
+import {
+  generate
+} from "./chunk-OQXTQQAU.js";
 import {
   parseFlags,
   toJson
-} from "./chunk-3OTKMKJQ.js";
+} from "./chunk-MUVFECFC.js";
 import {
   readSnapshot
 } from "./chunk-WUACK2HX.js";
@@ -17,34 +20,14 @@ import {
   hueSwatch,
   nullPrompt,
   scanSource
-} from "./chunk-GQVEYTBY.js";
+} from "./chunk-LFNSB6W7.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 { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "fs";
 import { join, relative, resolve } from "path";
 import { pathToFileURL } from "url";
 var readJson = (path) => JSON.parse(readFileSync(path, "utf8"));
 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 () => {
@@ -115,7 +98,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-MTUC24XU.js");
     const results = await snapshotUrls(toShoot.map((id) => pathToFileURL(join(pages, `${id}.html`)).href));
     results.forEach((r, i) => {
       const id = toShoot[i];