@domandigital/craft 0.5.0 → 0.7.0

package/dist/cli-TM2HWYN7.js

@@ -0,0 +1,312 @@
+import {
+  validateDirection
+} from "./chunk-J2BOAIHJ.js";
+import {
+  merge
+} from "./chunk-IQTZWNEK.js";
+import "./chunk-OA7SGPN4.js";
+import {
+  SIBLING_AT,
+  compareToEstate,
+  loadEstate
+} from "./chunk-CU5TZHOV.js";
+import {
+  loadNull,
+  typicality
+} from "./chunk-GV3QOTQU.js";
+import {
+  COPY_FILE,
+  NOT_COPY_DIR,
+  SOURCE_FILE,
+  loadExceptions,
+  parseFlags,
+  readPaths
+} from "./chunk-YYC4EGER.js";
+import {
+  fingerprint
+} from "./chunk-Q54JSNC5.js";
+import {
+  CATALOGUE,
+  SNAPSHOT_VERSION,
+  auditSnapshot,
+  checkCopy,
+  scanSource
+} from "./chunk-3AP4PJMX.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;
+var TELL_AREA = {
+  "reflex-font": { area: "type", choice: "display" },
+  "reflex-font-2": { area: "type", choice: "display" },
+  "italic-serif-display": { area: "type", choice: "display" },
+  "ai-violet": { area: "colour", choice: "accent" },
+  "blue-purple-gradient": { area: "colour", choice: "accent" },
+  "gradient-text": { area: "colour", choice: "accent" },
+  "cream-palette": { area: "colour", choice: "ground" },
+  "pill-everything": { area: "shape", choice: "shape" },
+  "shadcn-dump": { area: "shape", choice: "shape" },
+  "glass-panel": { area: "effects", choice: "motif" },
+  "radial-spotlight-glow": { area: "effects", choice: "motif" },
+  "grid-background": { area: "effects", choice: "motif" },
+  "thin-border-wide-shadow": { area: "effects", choice: "shape" },
+  "icon-tile-stack": { area: "effects", choice: "motif" },
+  "reveal-everywhere": { area: "motion", choice: "signature" },
+  "intro-cinematic": { area: "motion", choice: "signature" },
+  marquee: { area: "motion", choice: "signature" },
+  "hero-then-proof": { area: "layout" },
+  "icon-tile-grid": { area: "layout" },
+  "hero-eyebrow-chip": { area: "layout" },
+  "bento-grid": { area: "layout" }
+};
+var PART_AREA = {
+  display: { area: "type", choice: "display" },
+  body: { area: "type", choice: "body" },
+  accent: { area: "colour", choice: "accent" },
+  ground: { area: "colour", choice: "ground" },
+  shape: { area: "shape", choice: "shape" },
+  effects: { area: "effects", choice: "motif" },
+  motion: { area: "motion", choice: "signature" }
+};
+var DEFAULTS = /^(?:ground )?(?:white|grey)(?: ground)?$|no scroll reveals|no reveals|accent (?:none|neutral)|^no buttons|shape no buttons/;
+function designFindings(findings, copyTells) {
+  return (findings?.findings ?? []).filter((f) => !copyTells.has(f.tell));
+}
+function characterReport(input, copyTells = /* @__PURE__ */ new Set()) {
+  const actions = [];
+  const signals = [];
+  if (input.findings) {
+    const design = designFindings(input.findings, copyTells);
+    const distinct = [...new Set(design.map((f) => f.tell))];
+    signals.push({
+      id: "tells",
+      raised: distinct.length >= TELL_HEAVY,
+      detail: `${distinct.length} distinct design tell${distinct.length === 1 ? "" : "s"}${distinct.length ? `: ${distinct.join(", ")}` : ""}`
+    });
+    const seen = /* @__PURE__ */ new Set();
+    for (const f of design) {
+      if (seen.has(f.tell)) continue;
+      seen.add(f.tell);
+      const map = TELL_AREA[f.tell] ?? { area: "effects" };
+      const both = design.some((g) => g.tell === f.tell && g.line === 0) && design.some((g) => g.tell === f.tell && g.line > 0);
+      actions.push({ area: map.area, what: f.fix, why: `${f.name} (${f.tell}, gen ${f.generation})${both ? ", in source and on the page" : ""}`, priority: both ? 1 : 2, choice: map.choice });
+    }
+    const copy = (input.findings.findings ?? []).filter((f) => copyTells.has(f.tell));
+    const byTell = /* @__PURE__ */ new Map();
+    for (const f of copy) byTell.set(f.tell, [...byTell.get(f.tell) ?? [], f]);
+    for (const [tell, list] of byTell) {
+      actions.push({ area: "copy", what: list[0].fix, why: `${list[0].name} (${tell}), ${list.length} place${list.length === 1 ? "" : "s"}, first at ${list[0].path}${list[0].line ? `:${list[0].line}` : ""}`, priority: 3 });
+    }
+  } else {
+    signals.push({ id: "tells", raised: null, detail: "not measured" });
+  }
+  if (input.typicality) {
+    const t = input.typicality;
+    signals.push({ id: "typicality", raised: t.typical, detail: `score ${t.score.toFixed(2)}, ${t.typical ? "typical" : "not typical"} of what Claude builds for this brief` });
+    if (t.typical) {
+      for (const s of t.shared) {
+        const map = PART_AREA[s.part];
+        if (!map || DEFAULTS.test(`${s.part} ${s.value}`)) continue;
+        actions.push({ area: map.area, what: `Move off the model's pick for this brief: ${s.part} ${s.value}.`, why: `${s.runs} of ${s.of} null pages chose it`, priority: 1, choice: map.choice });
+      }
+    }
+  } else {
+    signals.push({ id: "typicality", raised: null, detail: "not measured: no null model for this brief" });
+  }
+  if (input.estate) {
+    const siblings = input.estate.filter((m) => m.sibling);
+    const nearest = input.estate[0];
+    signals.push({
+      id: "estate",
+      raised: siblings.length > 0,
+      detail: siblings.length ? `sibling of ${siblings.map((s) => `${s.id} (${s.distance.toFixed(2)})`).join(", ")}` : nearest ? `nearest ${nearest.id} at ${nearest.distance.toFixed(2)}, no sibling` : "the register is empty"
+    });
+    for (const s of siblings) {
+      for (const part of s.shared) {
+        if (DEFAULTS.test(part)) continue;
+        actions.push({ area: areaOfShared(part), what: `Differ from ${s.id}: both have ${part}.`, why: `sibling at ${s.distance.toFixed(2)}`, priority: 1, choice: choiceOfShared(part) });
+      }
+    }
+  } else {
+    signals.push({ id: "estate", raised: null, detail: "not measured: no estate register" });
+  }
+  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"}` });
+    for (const p of d.problems) {
+      const key = p.at.match(/^choices\.(\w+)/)?.[1];
+      if (p.severity === "error" || p.message === "not decided yet") {
+        actions.push({ area: "direction", what: key && p.message === "not decided yet" ? `Decide ${key}, with a source from the client's world.` : `${p.at || "art-direction.json"}: ${p.message}`, why: "the reason rule", priority: 1, choice: key });
+      }
+    }
+  } else {
+    signals.push({ id: "reasons", raised: null, detail: "not measured: no art-direction.json" });
+    actions.push({ area: "direction", what: "Write art-direction.json: run craft direction init, then give every choice a reason from the client's world.", why: "the reason rule", priority: 1 });
+  }
+  const raised = signals.filter((s) => s.raised === true).length;
+  const unmeasured = signals.filter((s) => s.raised === null).map((s) => s.id);
+  const verdict = raised >= 2 ? "default" : raised === 1 ? "mixed" : unmeasured.length ? "unproven" : "decided";
+  const summary = verdict === "default" ? `${raised} of 4 signals raised: nobody chose how this looks.` : verdict === "mixed" ? `1 of 4 signals raised: ${signals.find((s) => s.raised).id}.` : verdict === "decided" ? "No signal raised, and every choice carries a reason." : `No signal raised, but ${unmeasured.join(", ")} not measured. Unverified is not a pass.`;
+  const order = ["direction", "type", "colour", "shape", "effects", "motion", "layout", "copy"];
+  const merged = [];
+  for (const a of actions) {
+    const same = a.choice && a.area !== "direction" && a.area !== "copy" ? merged.find((m) => m.choice === a.choice && m.area === a.area) : void 0;
+    if (same) {
+      const fromTell = /\(\S+, gen \d\)/.test(a.why);
+      same.why = `${same.why}; ${fromTell ? a.why : `${a.what.replace(/\.$/, "")} (${a.why})`}`;
+      same.priority = Math.min(same.priority, a.priority);
+    } else merged.push({ ...a });
+  }
+  const unique = merged.filter((a, i) => merged.findIndex((b) => b.area === a.area && b.what === a.what) === i);
+  unique.sort((a, b) => a.priority - b.priority || order.indexOf(a.area) - order.indexOf(b.area));
+  return { site: input.site, verdict, summary, signals, actions: unique };
+}
+function areaOfShared(part) {
+  if (/headline|body$/.test(part)) return "type";
+  if (/accent|ground/.test(part)) return "colour";
+  if (/buttons/.test(part)) return "shape";
+  if (/reveal/.test(part)) return "motion";
+  if (/running order/.test(part)) return "layout";
+  return "effects";
+}
+function choiceOfShared(part) {
+  if (/headline/.test(part)) return "display";
+  if (/body$/.test(part)) return "body";
+  if (/accent/.test(part)) return "accent";
+  if (/ground/.test(part)) return "ground";
+  if (/buttons/.test(part)) return "shape";
+  if (/reveal/.test(part)) return "signature";
+  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 local = resolve(io.cwd, target2);
+    let snap;
+    if (/\.json$/i.test(target2) && existsSync(local)) {
+      snap = JSON.parse(readFileSync(local, "utf8"));
+      if (snap.version !== SNAPSHOT_VERSION) throw new Error(`${target2} is not a snapshot`);
+    } else {
+      const { snapshotUrl } = await import("./audit-YNODYB3U.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);
+    let findings = auditSnapshot(snap, { exceptions });
+    if (repo) {
+      findings = merge(scanSource(readPaths(["."], repo, SOURCE_FILE), { exceptions }), findings);
+      findings = merge(findings, checkCopy(readPaths(["."], repo, COPY_FILE, (d) => NOT_COPY_DIR(d) || d === "docs"), { exceptions }));
+    }
+    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, pathExists: (p) => existsSync(resolve(dirname(directionFile), p)) });
+    } 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 ? JSON.stringify(report, null, 2) : formatCharacter(report));
+    if (flags.out) writeFileSync(resolve(io.cwd, flags.out), `${JSON.stringify(report, null, 2)}
+`);
+    return flags.strict && report.verdict !== "decided" ? 1 : 0;
+  } catch (error) {
+    io.err(`craft: ${error.message}`);
+    return 2;
+  }
+}
+export {
+  formatCharacter,
+  runReport
+};

package/dist/cli.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import {
+  run
+} from "./chunk-YYC4EGER.js";
+import "./chunk-3AP4PJMX.js";
+
+// src/cli.ts
+process.stdout.on("error", (error) => {
+  if (error.code === "EPIPE") process.exit(process.exitCode ?? 0);
+  throw error;
+});
+void Promise.resolve(
+  run(process.argv.slice(2), {
+    cwd: process.cwd(),
+    out: (text) => process.stdout.write(`${text}
+`),
+    err: (text) => process.stderr.write(`${text}
+`)
+  })
+).then((code) => {
+  process.exitCode = code;
+});