@domandigital/craft 0.20.1 → 0.20.3

package/dist/phone.d.cts

@@ -335,6 +335,35 @@ interface ViewportsResult extends MeasuredRoute {
  * not judge or throw on a finding: the baseline decides.
  */
 declare function measureViewports(page: ViewportPage, options: MeasureViewportsOptions): Promise<ViewportsResult>;
+/** The desktop context the wide half is measured in, beside `PHONE` for the phone half. Spread into `browser.newContext`. */
+declare const DESKTOP: {
+    readonly viewport: {
+        readonly width: 1024;
+        readonly height: 768;
+    };
+    readonly deviceScaleFactor: 1;
+};
+/** A page opened at the route, and how to close it when its half is measured. */
+interface OpenedPage {
+    page: ViewportPage;
+    close?: () => Promise<void>;
+}
+/**
+ * Every viewport for a route only the caller can open, such as a portal screen
+ * behind a sign-in (DOM-835). As `measureSite` does for a public page, the
+ * phone half is measured in a phone context and the wide half in a desktop
+ * one; `open(scope)` returns a page already at the route, signed in with the
+ * suite's fixtures, in `PHONE` for "phone" and `DESKTOP` for "wide". The two
+ * halves are merged and written once, for `craft phone-first --measured`.
+ *
+ *     await measureRoute(async (scope) => {
+ *       const context = await browser.newContext({ ...(scope === "phone" ? PHONE : DESKTOP), extraHTTPHeaders: auth });
+ *       const page = await context.newPage();
+ *       await page.goto(base + route);
+ *       return { page, close: () => context.close() };
+ *     }, { route, mainAction: 'a[href="/portal/requests/new"]' });
+ */
+declare function measureRoute(open: (scope: "phone" | "wide") => Promise<OpenedPage>, options: Omit<MeasureViewportsOptions, "scope">): Promise<ViewportsResult>;
 interface SitePage extends ViewportPage {
     goto(url: string): Promise<{
         ok(): boolean;
@@ -419,4 +448,4 @@ interface MeasurePhoneOptions {
  */
 declare function measurePhone(page: MinimalPage, options: MeasurePhoneOptions): Promise<MeasuredRoute>;
 
-export { BANDS, type Band, type Baseline, DEFAULT_MEASURED_DIR, DEFAULT_SWEEP, DEFAULT_THRESHOLDS, EMPTY_BASELINE, type FileException, type InPageGroup, type Judgement, LADDER, type MainAction, type MeasurePhoneOptions, type MeasureSiteOptions, type MeasureViewportsOptions, type MeasuredRoute, PHONE, PHONE_FLOORS, type PhoneCheck, type PhoneFloors, type RawPhoneFinding, SHORT_PHONE, type SiteBrowser, type SitePage, type SiteResult, type StaticFinding, type Sweep, type Thresholds, type Viewport, type ViewportArg, type ViewportPage, type ViewportsResult, WIDE_WIDTHS, bandOf, checkExceptions, formatWidths, judgeMeasured, judgeStatic, mainActionFor, measurePhone, measurePhoneInPage, measureSite, measureViewportInPage, measureViewports, mergeViewportFindings, normaliseElement, reasonOf, routeFile, scanPhoneFirst, sweepWidths, writeBaseline };
+export { BANDS, type Band, type Baseline, DEFAULT_MEASURED_DIR, DEFAULT_SWEEP, DEFAULT_THRESHOLDS, DESKTOP, EMPTY_BASELINE, type FileException, type InPageGroup, type Judgement, LADDER, type MainAction, type MeasurePhoneOptions, type MeasureSiteOptions, type MeasureViewportsOptions, type MeasuredRoute, type OpenedPage, PHONE, PHONE_FLOORS, type PhoneCheck, type PhoneFloors, type RawPhoneFinding, SHORT_PHONE, type SiteBrowser, type SitePage, type SiteResult, type StaticFinding, type Sweep, type Thresholds, type Viewport, type ViewportArg, type ViewportPage, type ViewportsResult, WIDE_WIDTHS, bandOf, checkExceptions, formatWidths, judgeMeasured, judgeStatic, mainActionFor, measurePhone, measurePhoneInPage, measureRoute, measureSite, measureViewportInPage, measureViewports, mergeViewportFindings, normaliseElement, reasonOf, routeFile, scanPhoneFirst, sweepWidths, writeBaseline };

package/dist/phone.d.ts

@@ -335,6 +335,35 @@ interface ViewportsResult extends MeasuredRoute {
  * not judge or throw on a finding: the baseline decides.
  */
 declare function measureViewports(page: ViewportPage, options: MeasureViewportsOptions): Promise<ViewportsResult>;
+/** The desktop context the wide half is measured in, beside `PHONE` for the phone half. Spread into `browser.newContext`. */
+declare const DESKTOP: {
+    readonly viewport: {
+        readonly width: 1024;
+        readonly height: 768;
+    };
+    readonly deviceScaleFactor: 1;
+};
+/** A page opened at the route, and how to close it when its half is measured. */
+interface OpenedPage {
+    page: ViewportPage;
+    close?: () => Promise<void>;
+}
+/**
+ * Every viewport for a route only the caller can open, such as a portal screen
+ * behind a sign-in (DOM-835). As `measureSite` does for a public page, the
+ * phone half is measured in a phone context and the wide half in a desktop
+ * one; `open(scope)` returns a page already at the route, signed in with the
+ * suite's fixtures, in `PHONE` for "phone" and `DESKTOP` for "wide". The two
+ * halves are merged and written once, for `craft phone-first --measured`.
+ *
+ *     await measureRoute(async (scope) => {
+ *       const context = await browser.newContext({ ...(scope === "phone" ? PHONE : DESKTOP), extraHTTPHeaders: auth });
+ *       const page = await context.newPage();
+ *       await page.goto(base + route);
+ *       return { page, close: () => context.close() };
+ *     }, { route, mainAction: 'a[href="/portal/requests/new"]' });
+ */
+declare function measureRoute(open: (scope: "phone" | "wide") => Promise<OpenedPage>, options: Omit<MeasureViewportsOptions, "scope">): Promise<ViewportsResult>;
 interface SitePage extends ViewportPage {
     goto(url: string): Promise<{
         ok(): boolean;
@@ -419,4 +448,4 @@ interface MeasurePhoneOptions {
  */
 declare function measurePhone(page: MinimalPage, options: MeasurePhoneOptions): Promise<MeasuredRoute>;
 
-export { BANDS, type Band, type Baseline, DEFAULT_MEASURED_DIR, DEFAULT_SWEEP, DEFAULT_THRESHOLDS, EMPTY_BASELINE, type FileException, type InPageGroup, type Judgement, LADDER, type MainAction, type MeasurePhoneOptions, type MeasureSiteOptions, type MeasureViewportsOptions, type MeasuredRoute, PHONE, PHONE_FLOORS, type PhoneCheck, type PhoneFloors, type RawPhoneFinding, SHORT_PHONE, type SiteBrowser, type SitePage, type SiteResult, type StaticFinding, type Sweep, type Thresholds, type Viewport, type ViewportArg, type ViewportPage, type ViewportsResult, WIDE_WIDTHS, bandOf, checkExceptions, formatWidths, judgeMeasured, judgeStatic, mainActionFor, measurePhone, measurePhoneInPage, measureSite, measureViewportInPage, measureViewports, mergeViewportFindings, normaliseElement, reasonOf, routeFile, scanPhoneFirst, sweepWidths, writeBaseline };
+export { BANDS, type Band, type Baseline, DEFAULT_MEASURED_DIR, DEFAULT_SWEEP, DEFAULT_THRESHOLDS, DESKTOP, EMPTY_BASELINE, type FileException, type InPageGroup, type Judgement, LADDER, type MainAction, type MeasurePhoneOptions, type MeasureSiteOptions, type MeasureViewportsOptions, type MeasuredRoute, type OpenedPage, PHONE, PHONE_FLOORS, type PhoneCheck, type PhoneFloors, type RawPhoneFinding, SHORT_PHONE, type SiteBrowser, type SitePage, type SiteResult, type StaticFinding, type Sweep, type Thresholds, type Viewport, type ViewportArg, type ViewportPage, type ViewportsResult, WIDE_WIDTHS, bandOf, checkExceptions, formatWidths, judgeMeasured, judgeStatic, mainActionFor, measurePhone, measurePhoneInPage, measureRoute, measureSite, measureViewportInPage, measureViewports, mergeViewportFindings, normaliseElement, reasonOf, routeFile, scanPhoneFirst, sweepWidths, writeBaseline };

package/dist/phone.js

@@ -673,6 +673,21 @@ async function measureViewports(page, options) {
   await page.evaluate(() => document.fonts?.ready.then(() => void 0), void 0);
   return finish(options.route, await collect(page, options), options.out);
 }
+var DESKTOP = { viewport: { width: 1024, height: 768 }, deviceScaleFactor: 1 };
+async function measureRoute(open, options) {
+  if (!options.route.startsWith("/")) throw new Error(`measureRoute: route "${options.route}" should start with /`);
+  const collected = [];
+  for (const scope of ["phone", "wide"]) {
+    const { page, close } = await open(scope);
+    try {
+      await page.evaluate(() => document.fonts?.ready.then(() => void 0), void 0);
+      collected.push(await collect(page, { ...options, scope }));
+    } finally {
+      await close?.();
+    }
+  }
+  return finish(options.route, { perViewport: collected.flatMap((c) => c.perViewport), tested: collected.flatMap((c) => c.tested) }, options.out);
+}
 async function measureSite(browser, options) {
   const result = { routes: [], errors: [] };
   for (const route of options.routes) {
@@ -680,7 +695,7 @@ async function measureSite(browser, options) {
     let failed = null;
     for (const [scope, context] of [
       ["phone", PHONE],
-      ["wide", { viewport: { width: 1024, height: 768 }, deviceScaleFactor: 1 }]
+      ["wide", DESKTOP]
     ]) {
       const ctx = await browser.newContext({ ...context });
       try {
@@ -723,6 +738,7 @@ export {
   DEFAULT_MEASURED_DIR,
   DEFAULT_SWEEP,
   DEFAULT_THRESHOLDS,
+  DESKTOP,
   EMPTY_BASELINE,
   LADDER,
   PHONE,
@@ -737,6 +753,7 @@ export {
   mainActionFor,
   measurePhone,
   measurePhoneInPage,
+  measureRoute,
   measureSite,
   measureViewportInPage,
   measureViewports,

package/dist/{viewports-cli-C4VXMPKK.js → viewports-cli-WWWWEBKI.js}

@@ -534,6 +534,7 @@ function writeMeasured(result, dir) {
   writeFileSync(join(dir, routeFile(route)), `${JSON.stringify({ route, ...viewport ? { viewport } : {}, ...viewports ? { viewports } : {}, findings }, null, 1)}
 `);
 }
+var DESKTOP = { viewport: { width: 1024, height: 768 }, deviceScaleFactor: 1 };
 async function measureSite(browser, options) {
   const result = { routes: [], errors: [] };
   for (const route of options.routes) {
@@ -541,7 +542,7 @@ async function measureSite(browser, options) {
     let failed = null;
     for (const [scope, context] of [
       ["phone", PHONE],
-      ["wide", { viewport: { width: 1024, height: 768 }, deviceScaleFactor: 1 }]
+      ["wide", DESKTOP]
     ]) {
       const ctx = await browser.newContext({ ...context });
       try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domandigital/craft",
-  "version": "0.20.1",
+  "version": "0.20.3",
   "private": false,
   "description": "The Doman Digital house craft standard as numbers: OKLCh colour ramps that snap to existing anchors, derived semantic tokens with measured WCAG and APCA contrast, one shared motion vocabulary for CSS and JS, and a base stylesheet. Zero dependencies.",
   "license": "Apache-2.0",
@@ -48,11 +48,13 @@
     "./package.json": "./package.json",
     "./craft.css": "./css/craft.css",
     "./craft.tailwind.css": "./css/craft.tailwind.css",
-    "./art-direction.schema.json": "./art-direction.schema.json"
+    "./art-direction.schema.json": "./art-direction.schema.json",
+    "./design-review.schema.json": "./design-review.schema.json"
   },
   "files": [
     "CHANGELOG.md",
     "art-direction.schema.json",
+    "design-review.schema.json",
     "CHARACTER.md",
     "COPY.md",
     "LICENSE",

package/dist/cli-MKZJMZUJ.js

@@ -1,337 +0,0 @@
-import {
-  decodePng
-} from "./chunk-JYNXGCYZ.js";
-import {
-  DIRECTION_VERSION,
-  PAGE_TYPES,
-  PROPOSED,
-  researchPrompt,
-  validateDirection
-} from "./chunk-2OBDCIVW.js";
-import {
-  parseFlags
-} from "./chunk-6NXPDCUO.js";
-import {
-  toJson
-} from "./chunk-QIEDBL4J.js";
-import {
-  readSnapshot
-} from "./chunk-WUACK2HX.js";
-import {
-  deltaEOk,
-  fingerprint,
-  formatHex,
-  hexToOklch,
-  isAiViolet,
-  isCream,
-  oklchToRgb,
-  parseColour
-} from "./chunk-JGWOA4LI.js";
-import "./chunk-7DQDF3VL.js";
-import "./chunk-QYBAVU3P.js";
-
-// src/direction/cli.ts
-import { existsSync, readdirSync, readFileSync, writeFileSync } from "fs";
-import { dirname, join, resolve } from "path";
-
-// src/direction/init.ts
-var hex = (o) => {
-  const { r, g, b } = oklchToRgb(o);
-  const clamp = (n) => Math.min(1, Math.max(0, n));
-  return formatHex({ r: clamp(r), g: clamp(g), b: clamp(b) });
-};
-function initDirection(input) {
-  const fp = input.current;
-  const empty = (value) => ({ value, because: "", evidence: [] });
-  const choices = fp ? {
-    ...fp.accent ? { accent: empty(hex(fp.accent)) } : {},
-    ground: empty(hex(fp.ground)),
-    display: empty(fp.display.family),
-    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 } : {}
-  };
-}
-
-// src/direction/propose.ts
-function srgbToLinear(c) {
-  return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
-}
-function toLab(r, g, b) {
-  const lr = srgbToLinear(r / 255);
-  const lg = srgbToLinear(g / 255);
-  const lb = srgbToLinear(b / 255);
-  const l = Math.cbrt(0.4122214708 * lr + 0.5363325363 * lg + 0.0514459929 * lb);
-  const m = Math.cbrt(0.2119034982 * lr + 0.6806995451 * lg + 0.1073969566 * lb);
-  const s = Math.cbrt(0.0883024619 * lr + 0.2817188376 * lg + 0.6299787005 * lb);
-  return [0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s, 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s, 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s];
-}
-function paletteFromPixels(rgba, k = 6, maxSamples = 2e4) {
-  const total = Math.floor(rgba.length / 4);
-  const step = Math.max(1, Math.floor(total / maxSamples));
-  const px = [];
-  for (let i = 0; i < total; i += step) {
-    const o = i * 4;
-    if (rgba[o + 3] < 128) continue;
-    px.push({ lab: toLab(rgba[o], rgba[o + 1], rgba[o + 2]), rgb: [rgba[o], rgba[o + 1], rgba[o + 2]] });
-  }
-  if (px.length === 0) return [];
-  const sorted = [...px].sort((a, b) => a.lab[0] - b.lab[0]);
-  const n = Math.min(k, px.length);
-  let centres = Array.from({ length: n }, (_, i) => sorted[Math.floor((i + 0.5) / n * sorted.length)].lab.slice());
-  let assign = new Array(px.length).fill(0);
-  for (let iter = 0; iter < 12; iter += 1) {
-    assign = px.map((p) => {
-      let best = 0;
-      let bestD = Infinity;
-      centres.forEach((c, j) => {
-        const d = (p.lab[0] - c[0]) ** 2 + (p.lab[1] - c[1]) ** 2 + (p.lab[2] - c[2]) ** 2;
-        if (d < bestD) {
-          bestD = d;
-          best = j;
-        }
-      });
-      return best;
-    });
-    centres = centres.map((c, j) => {
-      const members = px.filter((_, i) => assign[i] === j);
-      if (members.length === 0) return c;
-      return [0, 1, 2].map((d) => members.reduce((s, m) => s + m.lab[d], 0) / members.length);
-    });
-  }
-  return centres.map((_, j) => {
-    const members = px.filter((__, i) => assign[i] === j);
-    if (members.length === 0) return null;
-    const avg = [0, 1, 2].map((d) => members.reduce((s, m) => s + m.rgb[d], 0) / members.length / 255);
-    const hex2 = formatHex({ r: avg[0], g: avg[1], b: avg[2] });
-    return { hex: hex2, share: members.length / px.length, oklch: hexToOklch(hex2) };
-  }).filter((c) => c !== null).sort((a, b) => b.share - a.share);
-}
-var chromatic = (o) => o.c >= 0.04 && o.l >= 0.2 && o.l <= 0.85;
-function accentCandidates(input) {
-  const out = [];
-  for (const s of input.sources) {
-    for (const c of s.colours ?? []) {
-      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 })),
-        ...(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({
-        value: c.startsWith("#") ? c.toLowerCase() : c,
-        evidence: [s.id],
-        note: `from ${s.id} (${s.kind})${nearest ? `; nearest estate accent ${nearest.id} at \u0394E ${nearest.d.toFixed(2)}` : ""}${penalty ? "; in the reflex violet band" : ""}`,
-        score: (nearest ? Math.min(nearest.d, 0.3) : 0.3) - penalty + o.c
-      });
-    }
-  }
-  return out.sort((a, b) => b.score - a.score).map(({ score: _s, ...rest }) => rest);
-}
-function groundCandidates(input) {
-  const out = [];
-  for (const s of input.sources) {
-    for (const c of s.colours ?? []) {
-      const parsed = parseColour(c);
-      if (!parsed || parsed.oklch.l < 0.9) continue;
-      out.push({ value: c, evidence: [s.id], note: `a light colour from ${s.id}${isCream(parsed.oklch) ? "; reads as the cream tell, needs its reason" : ""}` });
-    }
-  }
-  return out;
-}
-function typeCandidates(input) {
-  return input.sources.filter((s) => s.lettering).map((s) => ({ value: "", evidence: [s.id], note: `find a face with the character of "${s.lettering}" on ${s.id}` }));
-}
-function propose(input) {
-  const proposals = [
-    { key: "accent", candidates: accentCandidates(input) },
-    { key: "ground", candidates: groundCandidates(input) },
-    { key: "display", candidates: typeCandidates(input) }
-  ];
-  const choices = {};
-  const draft = (p) => {
-    const top = p.candidates[0];
-    if (!top || !top.value) return void 0;
-    const source = input.sources.find((s) => s.id === top.evidence[0]);
-    return {
-      value: top.value,
-      because: `${PROPOSED} taken from the ${source.id}: ${source.note} Confirm it matches, then rewrite this in your own words.`,
-      evidence: top.evidence
-    };
-  };
-  for (const p of proposals) {
-    const c = draft(p);
-    if (c) choices[p.key] = c;
-  }
-  return {
-    proposals,
-    direction: { version: DIRECTION_VERSION, client: input.client, brief: input.brief, sources: input.sources, choices }
-  };
-}
-
-// src/direction/cli.ts
-var readJson = (path) => JSON.parse(readFileSync(path, "utf8"));
-async function snapshotFrom(target, cwd) {
-  if (!target) return void 0;
-  if (/^https?:\/\//.test(target)) {
-    const { snapshotUrl } = await import("./audit-BN2GSFKT.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 ?? []).filter((s) => s.fingerprint).map((s) => ({ id: s.id, fingerprint: s.fingerprint }));
-  }
-  return readdirSync(root).filter((f) => f.endsWith(".json")).flatMap((f) => {
-    try {
-      const snap = readSnapshot(readJson(join(root, f)), f);
-      return snap.fonts ? [{ id: f.replace(/(\.snapshot)?\.json$/, ""), fingerprint: fingerprint(snap) }] : [];
-    } catch {
-      return [];
-    }
-  });
-}
-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");
-    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, brief: flags.brief, current, exceptions: existing.exceptions });
-        writeFileSync(out, `${JSON.stringify(next, null, 2)}
-`);
-      } else {
-        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.`);
-      return 0;
-    }
-    if (sub === "validate") {
-      if (!existsSync(file)) throw new Error(`no ${file}. Run craft direction init.`);
-      const direction = readJson(file);
-      const estate = declaredFrom(flags.estate, io.cwd);
-      const report = validateDirection(direction, {
-        fingerprint: current,
-        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}`);
-        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;
-    }
-    if (sub === "propose") {
-      if (!existsSync(file)) throw new Error(`no ${file}. Run craft direction init and add the sources first.`);
-      const base = readJson(file);
-      const sources = (base.sources ?? []).map((s) => {
-        if (s.colours?.length || !s.path || !/\.png$/i.test(s.path)) return s;
-        const path = resolve(dirname(file), s.path);
-        if (!existsSync(path)) return s;
-        try {
-          const { rgba } = decodePng(readFileSync(path));
-          return { ...s, colours: paletteFromPixels(rgba).filter((c) => c.share >= 0.03).map((c) => c.hex) };
-        } catch (error) {
-          io.err(`craft direction: ${s.path}: ${error.message}`);
-          return s;
-        }
-      });
-      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)}
-`;
-      if (flags.out) writeFileSync(resolve(io.cwd, flags.out), text);
-      else io.out(text);
-      for (const p of result.proposals) {
-        io.err(`${p.key}: ${p.candidates.length ? p.candidates.map((c) => `${c.value || "?"} (${c.note})`).join("; ") : "nothing in the sources to draw on yet"}`);
-      }
-      return 0;
-    }
-    throw new Error("usage: craft direction init | validate | propose | research");
-  } catch (error) {
-    io.err(`craft: ${error.message}`);
-    return 2;
-  }
-}
-function stripUndecided(choices = {}) {
-  return Object.fromEntries(Object.entries(choices).filter(([, c]) => c && c.because && c.because.trim().length > 0));
-}
-export {
-  runDirection
-};