@domandigital/craft 0.14.0 → 0.15.0

package/dist/{cli-3CGUKXY4.js → cli-22TSWAX6.js}

@@ -4,11 +4,13 @@ import {
   formatPairs,
   loadEstate,
   runEstate
-} from "./chunk-PBK6SYH5.js";
-import "./chunk-XVBR2UPH.js";
-import "./chunk-3OTKMKJQ.js";
+} from "./chunk-QU6Q2QZZ.js";
+import "./chunk-YDURAOYR.js";
+import "./chunk-RXXRXV3V.js";
+import "./chunk-OQXTQQAU.js";
+import "./chunk-MUVFECFC.js";
 import "./chunk-WUACK2HX.js";
-import "./chunk-GQVEYTBY.js";
+import "./chunk-LFNSB6W7.js";
 import "./chunk-QYBAVU3P.js";
 export {
   formatComponentPairs,

package/dist/{cli-WSHPSWVU.js → cli-5ACKICBO.js}

@@ -4,13 +4,14 @@ import {
   merge,
   resolvePages,
   runAudit
-} from "./chunk-7T5WR74C.js";
-import "./chunk-Q7ILL2HV.js";
+} from "./chunk-2IQ5OXFR.js";
+import "./chunk-OUQ25LY2.js";
 import "./chunk-JYNXGCYZ.js";
-import "./chunk-XVBR2UPH.js";
-import "./chunk-3OTKMKJQ.js";
+import "./chunk-RXXRXV3V.js";
+import "./chunk-OQXTQQAU.js";
+import "./chunk-MUVFECFC.js";
 import "./chunk-WUACK2HX.js";
-import "./chunk-GQVEYTBY.js";
+import "./chunk-LFNSB6W7.js";
 import "./chunk-QYBAVU3P.js";
 export {
   describeComponents,

package/dist/{cli-O3CDSONO.js → cli-7OZCYOQY.js}

@@ -1,14 +1,17 @@
-import {
-  DIRECTION_VERSION,
-  validateDirection
-} from "./chunk-OOZOEWGD.js";
 import {
   decodePng
 } from "./chunk-JYNXGCYZ.js";
+import {
+  DIRECTION_VERSION,
+  PAGE_TYPES,
+  PROPOSED,
+  researchPrompt,
+  validateDirection
+} from "./chunk-YDURAOYR.js";
 import {
   parseFlags,
   toJson
-} from "./chunk-3OTKMKJQ.js";
+} from "./chunk-MUVFECFC.js";
 import {
   readSnapshot
 } from "./chunk-WUACK2HX.js";
@@ -21,7 +24,7 @@ import {
   isCream,
   oklchToRgb,
   parseColour
-} from "./chunk-GQVEYTBY.js";
+} from "./chunk-LFNSB6W7.js";
 import "./chunk-QYBAVU3P.js";
 
 // src/direction/cli.ts
@@ -44,11 +47,31 @@ function initDirection(input) {
     body: empty(fp.body.family),
     ...fp.roundness !== null ? { shape: empty(fp.roundness >= 0.45 ? "pill buttons" : fp.roundness <= 0.05 ? "square corners" : `corners at ${Math.round(fp.roundness * 100)}% of button height`) } : {}
   } : {};
+  const part = () => ({ value: "", evidence: [] });
   return {
     $schema: "https://unpkg.com/@domandigital/craft/art-direction.schema.json",
     version: DIRECTION_VERSION,
     client: input.client ?? "",
     brief: input.brief ?? "",
+    // Empty on purpose, like the reasons: the first validate lists the job and the structure as undecided.
+    job: {
+      statement: { verb: "", object: "", context: "" },
+      functional: part(),
+      emotional: part(),
+      social: part(),
+      consideration: { value: "low", because: "", evidence: [] },
+      objections: [],
+      language: [],
+      evidence: []
+    },
+    hierarchy: {
+      home: {
+        primaryAction: { value: "", positions: [], because: "" },
+        order: fp?.sections?.length ? fp.sections.map((s) => ({ role: s.role, because: "" })) : [],
+        lead: { value: "", because: "" },
+        journey: []
+      }
+    },
     sources: [],
     choices,
     ...input.exceptions?.length ? { exceptions: input.exceptions } : {}
@@ -56,7 +79,6 @@ function initDirection(input) {
 }
 
 // src/direction/propose.ts
-var PROPOSED = "PROPOSED:";
 function srgbToLinear(c) {
   return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
 }
@@ -118,7 +140,13 @@ function accentCandidates(input) {
       const parsed = parseColour(c);
       if (!parsed || !chromatic(parsed.oklch)) continue;
       const o = parsed.oklch;
-      const siblings = (input.estate ?? []).map((e) => ({ id: e.id, d: e.fingerprint.accent ? deltaEOk(o, e.fingerprint.accent) : 1 }));
+      const siblings = [
+        ...(input.estate ?? []).map((e) => ({ id: e.id, d: e.fingerprint.accent ? deltaEOk(o, e.fingerprint.accent) : 1 })),
+        ...(input.declared ?? []).flatMap((e) => {
+          const p = parseColour(e.accent);
+          return p ? [{ id: `${e.id} (declared)`, d: deltaEOk(o, p.oklch) }] : [];
+        })
+      ];
       const nearest = siblings.sort((a, b) => a.d - b.d)[0];
       const penalty = isAiViolet(o) ? 1 : 0;
       out.push({
@@ -174,15 +202,26 @@ function propose(input) {
 
 // src/direction/cli.ts
 var readJson = (path) => JSON.parse(readFileSync(path, "utf8"));
-function fingerprintFrom(path, cwd) {
-  return path ? fingerprint(readJson(resolve(cwd, path))) : void 0;
+async function snapshotFrom(target, cwd) {
+  if (!target) return void 0;
+  if (/^https?:\/\//.test(target)) {
+    const { snapshotUrl } = await import("./audit-MTUC24XU.js");
+    return snapshotUrl(target);
+  }
+  return readSnapshot(readJson(resolve(cwd, target)), target);
+}
+function declaredFrom(path, cwd) {
+  if (!path || !path.endsWith(".json")) return [];
+  const register = readJson(resolve(cwd, path));
+  return register.sites ?? [];
 }
+var TEXT_SOURCE = /\.(?:txt|md|markdown|csv|json|html?)$/i;
 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 (register.sites ?? []).filter((s) => s.fingerprint).map((s) => ({ id: s.id, fingerprint: s.fingerprint }));
   }
   return readdirSync(root).filter((f) => f.endsWith(".json")).flatMap((f) => {
     try {
@@ -193,23 +232,33 @@ function estateFrom(dir, cwd) {
     }
   });
 }
-function runDirection(args, io) {
+async function runDirection(args, io) {
   try {
     const flags = parseFlags(args);
     if (typeof flags === "string") throw new Error(flags);
     const [sub] = flags.positional;
     const file = resolve(io.cwd, flags.direction ?? "art-direction.json");
-    const current = fingerprintFrom(flags.snapshot, io.cwd);
+    if (sub === "research") {
+      const base = existsSync(file) ? readJson(file) : {};
+      const brief = flags.brief ?? base.brief;
+      if (!brief || brief.trim().split(/\s+/).length < 5) throw new Error('usage: craft direction research --brief "<who, where, what they do>" [--visual], or run it next to an art-direction.json with a brief');
+      io.out(researchPrompt({ brief, client: flags.client ?? base.client, visual: flags.visual }));
+      return 0;
+    }
+    const page = flags.page ?? "home";
+    if (!PAGE_TYPES.includes(page)) throw new Error(`--page takes one of ${PAGE_TYPES.join(", ")}`);
+    const snapshot = await snapshotFrom(flags.snapshot, io.cwd);
+    const current = snapshot ? fingerprint(snapshot) : void 0;
     if (sub === "init") {
       const out = resolve(io.cwd, flags.out ?? "art-direction.json");
       if (existsSync(out) && !flags.out) {
         const existing = readJson(out);
         if (existing.version !== void 0) throw new Error(`${out} already records choices. Pass --out to write elsewhere.`);
-        const next = initDirection({ client: flags.client, current, exceptions: existing.exceptions });
+        const next = initDirection({ client: flags.client, brief: flags.brief, current, exceptions: existing.exceptions });
         writeFileSync(out, `${JSON.stringify(next, null, 2)}
 `);
       } else {
-        writeFileSync(out, `${JSON.stringify(initDirection({ client: flags.client, current }), null, 2)}
+        writeFileSync(out, `${JSON.stringify(initDirection({ client: flags.client, brief: flags.brief, current }), null, 2)}
 `);
       }
       io.out(`craft direction: wrote ${out}. Add the sources and a reason for every choice, then run craft direction validate.`);
@@ -217,14 +266,30 @@ function runDirection(args, io) {
     }
     if (sub === "validate") {
       if (!existsSync(file)) throw new Error(`no ${file}. Run craft direction init.`);
-      const report = validateDirection(readJson(file), {
+      const direction = readJson(file);
+      const estate = declaredFrom(flags.estate, io.cwd);
+      const report = validateDirection(direction, {
         fingerprint: current,
-        pathExists: (p) => existsSync(resolve(dirname(file), p))
+        snapshot,
+        page,
+        strict: flags.strict,
+        pathExists: (p) => existsSync(resolve(dirname(file), p)),
+        readSource: (s) => {
+          if (!s.path || /^https?:/.test(s.path) || !TEXT_SOURCE.test(s.path)) return void 0;
+          const path = resolve(dirname(file), s.path);
+          return existsSync(path) ? readFileSync(path, "utf8") : void 0;
+        },
+        estate,
+        estateId: estate.find((s) => s.client && s.client === direction.client)?.id
       });
       if (flags.json) io.out(toJson(report));
       else {
         for (const p of report.problems) io.out(`  ${p.severity === "error" ? "error" : "warn "}  ${p.at || "(file)"}  ${p.message}`);
-        io.out(`craft direction: ${report.valid ? "valid" : "not valid"}, ${report.decided} of 7 choices decided with a reason.`);
+        const l = report.layers;
+        const pages = l.hierarchy.map((h) => `${h.page} ${h.decided} of ${h.total}`).join(", ");
+        io.out(
+          `craft direction: ${report.valid ? "valid" : "not valid"}. Job ${l.job ? "decided" : "not decided"}; hierarchy ${pages || "not decided"}; tokens ${l.tokens.decided} of ${l.tokens.total}.${l.complete ? " Every layer decided." : ""}`
+        );
       }
       return report.valid ? 0 : 1;
     }
@@ -243,7 +308,8 @@ function runDirection(args, io) {
           return s;
         }
       });
-      const result = propose({ client: base.client, brief: base.brief, sources, current, estate: estateFrom(flags.estate, io.cwd) });
+      const declared = declaredFrom(flags.estate, io.cwd).flatMap((s) => s.direction?.accent && s.client !== base.client ? [{ id: s.id, accent: s.direction.accent }] : []);
+      const result = propose({ client: base.client, brief: base.brief, sources, current, estate: estateFrom(flags.estate, io.cwd), declared });
       const merged = { ...base, sources, choices: { ...result.direction.choices, ...stripUndecided(base.choices) }, ...base.exceptions ? { exceptions: base.exceptions } : {} };
       const text = `${JSON.stringify(merged, null, 2)}
 `;
@@ -254,7 +320,7 @@ function runDirection(args, io) {
       }
       return 0;
     }
-    throw new Error("usage: craft direction init | validate | propose");
+    throw new Error("usage: craft direction init | validate | propose | research");
   } catch (error) {
     io.err(`craft: ${error.message}`);
     return 2;

package/dist/{cli-WG3UJNUF.js → cli-FCKHYAVZ.js}

@@ -1,19 +1,21 @@
-import {
-  validateDirection
-} from "./chunk-OOZOEWGD.js";
 import {
   merge
-} from "./chunk-7T5WR74C.js";
-import "./chunk-Q7ILL2HV.js";
+} from "./chunk-2IQ5OXFR.js";
+import "./chunk-OUQ25LY2.js";
 import "./chunk-JYNXGCYZ.js";
 import {
   SIBLING_AT,
   compareToEstate,
   loadEstate
-} from "./chunk-PBK6SYH5.js";
+} from "./chunk-QU6Q2QZZ.js";
+import {
+  PAGE_TYPES,
+  validateDirection
+} from "./chunk-YDURAOYR.js";
 import {
   loadNull
-} from "./chunk-XVBR2UPH.js";
+} from "./chunk-RXXRXV3V.js";
+import "./chunk-OQXTQQAU.js";
 import {
   COPY_FILE,
   NOT_COPY_DIR,
@@ -24,7 +26,7 @@ import {
   parseFlags,
   readPaths,
   toJson
-} from "./chunk-3OTKMKJQ.js";
+} from "./chunk-MUVFECFC.js";
 import {
   readSnapshot
 } from "./chunk-WUACK2HX.js";
@@ -35,7 +37,7 @@ import {
   fingerprint,
   scanSource,
   typicality
-} from "./chunk-GQVEYTBY.js";
+} from "./chunk-LFNSB6W7.js";
 import "./chunk-QYBAVU3P.js";
 
 // src/report/cli.ts
@@ -141,8 +143,16 @@ function characterReport(input, copyTells = /* @__PURE__ */ new Set()) {
   }
   if (input.direction) {
     const d = input.direction;
-    const raised2 = !d.valid || d.decided < MIN_DECIDED;
-    signals.push({ id: "reasons", raised: raised2, detail: `${d.decided} of 7 choices decided with a reason${d.valid ? "" : ", art-direction.json has errors"}` });
+    const layers = d.layers;
+    const raised2 = !d.valid || d.decided < MIN_DECIDED || !layers.complete;
+    const pages = layers.hierarchy.map((p) => `${p.page} ${p.decided} of ${p.total}`).join(", ");
+    const detail = [
+      `job ${layers.job ? "decided" : "not decided"}`,
+      `hierarchy ${pages || "not decided"}`,
+      `${d.decided} of 7 choices decided with a reason`
+    ].join("; ");
+    signals.push({ id: "reasons", raised: raised2, detail: `${detail}${d.valid ? "" : ", art-direction.json has errors"}` });
+    if (!layers.job) actions.push({ area: "direction", what: "Write the job map: what the visitor is trying to get done, from reviews, enquiries and conversations. Run craft direction research for the questions.", why: "structure and look are decided from the job", priority: 1 });
     for (const p of d.problems) {
       const key = p.at.match(/^choices\.(\w+)/)?.[1];
       if (p.severity === "error" || p.message === "not decided yet") {
@@ -258,12 +268,14 @@ async function runReport(command, args, io) {
     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-6WHR7ZTV.js");
+      const { snapshotUrl } = await import("./audit-MTUC24XU.js");
       snap = await snapshotUrl(target2);
     }
     const fp = fingerprint(snap);
@@ -290,7 +302,18 @@ async function runReport(command, args, io) {
     let directionReport = null;
     if (existsSync(directionFile)) {
       direction = JSON.parse(readFileSync(directionFile, "utf8"));
-      directionReport = validateDirection(direction, { fingerprint: fp, pathExists: (p) => existsSync(resolve(dirname(directionFile), p)) });
+      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}`);
     }

package/dist/{cli-Z2IQG3LC.js → cli-FLG3ZCAF.js}

@@ -6,10 +6,11 @@ import {
   nullPath,
   runHarvest,
   runNull
-} from "./chunk-XVBR2UPH.js";
-import "./chunk-3OTKMKJQ.js";
+} from "./chunk-RXXRXV3V.js";
+import "./chunk-OQXTQQAU.js";
+import "./chunk-MUVFECFC.js";
 import "./chunk-WUACK2HX.js";
-import "./chunk-GQVEYTBY.js";
+import "./chunk-LFNSB6W7.js";
 import "./chunk-QYBAVU3P.js";
 export {
   describeTypicality,

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   run
-} from "./chunk-3OTKMKJQ.js";
-import "./chunk-GQVEYTBY.js";
+} from "./chunk-MUVFECFC.js";
+import "./chunk-LFNSB6W7.js";
 import "./chunk-QYBAVU3P.js";
 
 // src/cli.ts

package/dist/generate.js

@@ -0,0 +1,6 @@
+import {
+  generate
+} from "./chunk-OQXTQQAU.js";
+export {
+  generate
+};