@tendrilapp/cli 0.1.4 → 0.1.5

package/dist/tendril.js

@@ -1008,6 +1008,13 @@ function ingestEnvelope(setDir, slug, tool, payload) {
 `);
   return { overwrote };
 }
+function assetUrlsFromEnvelopeText(text) {
+  const byUrl = /* @__PURE__ */ new Map();
+  for (const m of text.matchAll(/const\s+\w+\s*=\s*"(https?:\/\/[^"]+\/assets?\/([a-z0-9-]+)\.(svg|png))"/gi)) {
+    byUrl.set(m[1], `asset-${m[2]}.${m[3].toLowerCase()}`);
+  }
+  return [...byUrl].map(([url, name]) => ({ url, name }));
+}
 function ingestAsset(setDir, slug, name, content) {
   const manifest = loadManifest(setDir);
   if (!manifest.reps.some((r) => r.slug === slug)) throw new Error(`unknown rep "${slug}" \u2014 not in the planned manifest`);
@@ -1789,7 +1796,7 @@ var init_browser = __esm({
 });
 
 // packages/verify/src/runtime.ts
-import { mkdtempSync, symlinkSync } from "node:fs";
+import { existsSync as existsSync4, mkdtempSync, symlinkSync } from "node:fs";
 import os from "node:os";
 import path4 from "node:path";
 import { fileURLToPath } from "node:url";
@@ -1799,13 +1806,25 @@ function runtimePackageRoot() {
   return path4.resolve(path4.dirname(fileURLToPath(import.meta.url)), "..");
 }
 function runtimeNodeModules() {
-  return path4.join(runtimePackageRoot(), "node_modules");
+  const root = runtimePackageRoot();
+  for (let dir = root; ; dir = path4.dirname(dir)) {
+    const candidate = path4.basename(dir) === "node_modules" ? dir : path4.join(dir, "node_modules");
+    if (existsSync4(path4.join(candidate, "react"))) return candidate;
+    if (path4.dirname(dir) === dir) break;
+  }
+  throw new Error(
+    `Tendril's installed dependencies are missing: no node_modules containing react found at or above ${root}. This is an INSTALLATION problem, not a component error \u2014 reinstall with \`npm install -g @tendrilapp/cli\` (or \`tendrilapp\`) and retry.`
+  );
 }
 function newScratchDir(prefix) {
   const dir = mkdtempSync(path4.join(os.tmpdir(), `tendril-${prefix}-`));
+  const nodeModules = runtimeNodeModules();
   try {
-    symlinkSync(runtimeNodeModules(), path4.join(dir, "node_modules"), "junction");
-  } catch {
+    symlinkSync(nodeModules, path4.join(dir, "node_modules"), "junction");
+  } catch (err) {
+    throw new Error(
+      `Tendril could not link its dependencies into the scratch dir (${nodeModules} -> ${dir}): ${err instanceof Error ? err.message : String(err)}. This is an environment problem, not a component error.`
+    );
   }
   return dir;
 }
@@ -1968,7 +1987,11 @@ var init_token_lint = __esm({
       "unset",
       "none",
       "auto",
-      "0"
+      "0",
+      // Positional/structural keywords, not themable values: a fully
+      // tokenised `box-shadow: var(--x) inset` was flagged for the literal
+      // `inset` (first Windows component run).
+      "inset"
     ];
     STYLELINT_CONFIG = {
       // The MODULE, not the name string: stylelint resolves plugin strings
@@ -3074,7 +3097,7 @@ var init_paths = __esm({
 
 // packages/verify/src/font-resolve.ts
 import { createHash } from "node:crypto";
-import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
 import os2 from "node:os";
 import path9 from "node:path";
 function fontCacheDir() {
@@ -3082,21 +3105,32 @@ function fontCacheDir() {
   if (env !== void 0 && env !== "") return path9.resolve(env);
   return path9.join(os2.homedir(), ".tendril", "fonts");
 }
+function googleQueryCandidates(family) {
+  const stripped = family.replace(/\s+(Variable|VF)$/i, "");
+  return stripped === family ? [family] : [family, stripped];
+}
 async function resolveFonts(family, weights, cacheDir = DEFAULT_FONT_CACHE) {
   mkdirSync2(cacheDir, { recursive: true });
   const resolved = [];
   const failures = [];
-  let css;
+  let css = null;
+  let lastStatus = 0;
   try {
-    const cssUrl = `https://fonts.googleapis.com/css2?family=${encodeURIComponent(family).replace(/%20/g, "+")}:wght@${weights.join(";")}&display=swap`;
-    const res = await fetch(cssUrl, { headers: { "User-Agent": UA } });
-    if (!res.ok) {
+    for (const queryName of googleQueryCandidates(family)) {
+      const cssUrl = `https://fonts.googleapis.com/css2?family=${encodeURIComponent(queryName).replace(/%20/g, "+")}:wght@${weights.join(";")}&display=swap`;
+      const res = await fetch(cssUrl, { headers: { "User-Agent": UA } });
+      if (res.ok) {
+        css = await res.text();
+        break;
+      }
+      lastStatus = res.status;
+    }
+    if (css === null) {
       return {
         resolved,
-        failures: weights.map((weight) => ({ family, weight, reason: `Google Fonts returned HTTP ${res.status} \u2014 family not available there? For a licensed or private face use \`tendril fonts add\` with a local file` }))
+        failures: weights.map((weight) => ({ family, weight, reason: `Google Fonts returned HTTP ${lastStatus} \u2014 family not available there? For a licensed or private face use \`tendril fonts add\` with a local file` }))
       };
     }
-    css = await res.text();
   } catch (err) {
     return { resolved, failures: weights.map((weight) => ({ family, weight, reason: `offline or fetch failed: ${err instanceof Error ? err.message : String(err)}` })) };
   }
@@ -3124,7 +3158,7 @@ async function resolveFonts(family, weights, cacheDir = DEFAULT_FONT_CACHE) {
     }
   }
   const mPath = path9.join(cacheDir, "manifest.json");
-  const prior = existsSync4(mPath) ? JSON.parse(readFileSync3(mPath, "utf8")) : [];
+  const prior = existsSync5(mPath) ? JSON.parse(readFileSync3(mPath, "utf8")) : [];
   const portable2 = resolved.map((m) => ({ ...m, file: path9.basename(m.file) }));
   const merged = [...prior.filter((p) => !resolved.some((m) => m.family === p.family && m.weight === p.weight)), ...portable2];
   if (resolved.length > 0) writeFileSync3(mPath, `${JSON.stringify(merged, null, 2)}
@@ -3133,7 +3167,7 @@ async function resolveFonts(family, weights, cacheDir = DEFAULT_FONT_CACHE) {
 }
 function addLocalFont(family, weight, filePath, cacheDir = DEFAULT_FONT_CACHE) {
   const src = path9.resolve(filePath);
-  if (!existsSync4(src)) throw new Error(`font file not found: ${src}`);
+  if (!existsSync5(src)) throw new Error(`font file not found: ${src}`);
   const ext = path9.extname(src).toLowerCase();
   if (![".woff2", ".woff", ".ttf", ".otf"].includes(ext)) {
     throw new Error(`unsupported font file "${ext}" \u2014 use .woff2 (preferred), .woff, .ttf or .otf`);
@@ -3146,7 +3180,7 @@ function addLocalFont(family, weight, filePath, cacheDir = DEFAULT_FONT_CACHE) {
   writeFileSync3(file, bytes);
   const face = { family, weight, source: `local:${path9.basename(src)}`, sha256, file };
   const mPath = path9.join(cacheDir, "manifest.json");
-  const prior = existsSync4(mPath) ? JSON.parse(readFileSync3(mPath, "utf8")) : [];
+  const prior = existsSync5(mPath) ? JSON.parse(readFileSync3(mPath, "utf8")) : [];
   const merged = [...prior.filter((p) => !(p.family === family && p.weight === weight)), { ...face, file: path9.basename(file) }];
   writeFileSync3(mPath, `${JSON.stringify(merged, null, 2)}
 `);
@@ -3155,7 +3189,7 @@ function addLocalFont(family, weight, filePath, cacheDir = DEFAULT_FONT_CACHE) {
 function checkFontLock(lockPath, cacheDir = DEFAULT_FONT_CACHE) {
   const lock = JSON.parse(readFileSync3(lockPath, "utf8"));
   const mPath = path9.join(cacheDir, "manifest.json");
-  const manifest = existsSync4(mPath) ? JSON.parse(readFileSync3(mPath, "utf8")) : [];
+  const manifest = existsSync5(mPath) ? JSON.parse(readFileSync3(mPath, "utf8")) : [];
   return lock.map((l) => {
     const m = manifest.find((x) => x.family === l.family && x.weight === l.weight);
     if (m === void 0) return { family: l.family, weight: l.weight, status: "missing" };
@@ -3164,7 +3198,7 @@ function checkFontLock(lockPath, cacheDir = DEFAULT_FONT_CACHE) {
 }
 function resolvedFontFamilies(cacheDir = DEFAULT_FONT_CACHE) {
   const mPath = path9.join(cacheDir, "manifest.json");
-  if (!existsSync4(mPath)) return [];
+  if (!existsSync5(mPath)) return [];
   let entries;
   try {
     entries = JSON.parse(readFileSync3(mPath, "utf8"));
@@ -3182,7 +3216,7 @@ function resolvedFontFamilies(cacheDir = DEFAULT_FONT_CACHE) {
 }
 function requiredFontsManifest(families, cacheDir = DEFAULT_FONT_CACHE) {
   const mPath = path9.join(cacheDir, "manifest.json");
-  const manifest = existsSync4(mPath) ? JSON.parse(readFileSync3(mPath, "utf8")) : [];
+  const manifest = existsSync5(mPath) ? JSON.parse(readFileSync3(mPath, "utf8")) : [];
   return manifest.filter((f) => families.includes(f.family));
 }
 var DEFAULT_FONT_CACHE, UA;
@@ -3195,13 +3229,13 @@ var init_font_resolve = __esm({
 });
 
 // packages/verify/src/font-faces.ts
-import { existsSync as existsSync5, readFileSync as readFileSync4 } from "node:fs";
+import { existsSync as existsSync6, readFileSync as readFileSync4 } from "node:fs";
 import path10 from "node:path";
 function fontFaceCss(manifestPath2 = path10.join(fontCacheDir(), "manifest.json")) {
-  if (!existsSync5(manifestPath2)) return "";
+  if (!existsSync6(manifestPath2)) return "";
   const manifest = JSON.parse(readFileSync4(manifestPath2, "utf8"));
   const resolveFile = (f) => {
-    if (path10.isAbsolute(f) && existsSync5(f)) return f;
+    if (path10.isAbsolute(f) && existsSync6(f)) return f;
     return path10.resolve(path10.dirname(manifestPath2), path10.basename(f));
   };
   const byFile = /* @__PURE__ */ new Map();
@@ -3245,7 +3279,7 @@ var init_mount_limits = __esm({
 });
 
 // packages/verify/src/admission.ts
-import { readFileSync as readFileSync5, readdirSync as readdirSync2, existsSync as existsSync6, writeFileSync as writeFileSync4 } from "node:fs";
+import { readFileSync as readFileSync5, readdirSync as readdirSync2, existsSync as existsSync7, writeFileSync as writeFileSync4 } from "node:fs";
 import path11 from "node:path";
 import { build as build2 } from "esbuild";
 import postcss from "postcss";
@@ -3254,7 +3288,7 @@ import { chromium as chromium2 } from "playwright-core";
 function fontWeightsByFamily() {
   const mPath = path11.join(fontCacheDir(), "manifest.json");
   const out = /* @__PURE__ */ new Map();
-  if (!existsSync6(mPath)) return out;
+  if (!existsSync7(mPath)) return out;
   for (const f of JSON.parse(readFileSync5(mPath, "utf8")))
     out.set(f.family, [...out.get(f.family) ?? [], f.weight]);
   return out;
@@ -3477,7 +3511,7 @@ __export(behavior_exports, {
   compileMount: () => compileMount,
   recordingIsDark: () => recordingIsDark
 });
-import { existsSync as existsSync7, readFileSync as readFileSync6 } from "node:fs";
+import { existsSync as existsSync8, readFileSync as readFileSync6 } from "node:fs";
 import path13 from "node:path";
 import { build as build3 } from "esbuild";
 import { chromium as chromium3 } from "playwright-core";
@@ -3488,7 +3522,7 @@ function getFontFaces() {
 }
 async function compileMount(task, bundleDir) {
   const entryTsx = path13.join(bundleDir, task.entry);
-  if (!existsSync7(entryTsx)) return { error: `${task.entry} missing` };
+  if (!existsSync8(entryTsx)) return { error: `${task.entry} missing` };
   const mountSrc = `
 import { createElement } from "react";
 import { createRoot } from "react-dom/client";
@@ -3701,7 +3735,7 @@ function recordingIsDark(task) {
   const rep = task.configs[0]?.rep;
   if (rep === void 0) return false;
   const f = path13.join(task.set, rep, "get_screenshot.json");
-  if (!existsSync7(f)) return false;
+  if (!existsSync8(f)) return false;
   try {
     const env = JSON.parse(readFileSync6(f, "utf8")).content.find((c) => c.type === "image");
     if (env?.data === void 0) return false;
@@ -3775,7 +3809,7 @@ async function checkBehaviors(task, bundleDir, opts = {}) {
   const deadlineMs = timeoutMs + 1e4;
   const js = await compileMount(task, bundleDir);
   if (typeof js !== "string") return task.behaviors.map((b) => ({ id: b.id, pass: false, detail: js.error }));
-  const css = ["tokens.css", "styles.css"].map((f) => path13.join(bundleDir, f)).filter((f) => existsSync7(f)).map((f) => readFileSync6(f, "utf8")).join("\n");
+  const css = ["tokens.css", "styles.css"].map((f) => path13.join(bundleDir, f)).filter((f) => existsSync8(f)).map((f) => readFileSync6(f, "utf8")).join("\n");
   const server = await chromium3.launchServer({ executablePath: resolveChrome(), headless: true, args: [MEMORY_CAP_ARG] });
   const browser = await chromium3.connect(server.wsEndpoint());
   const results = [];
@@ -3918,7 +3952,7 @@ var init_behavior = __esm({
 });
 
 // packages/verify/src/bundle-quality.ts
-import { readFileSync as readFileSync7, rmSync as rmSync2, writeFileSync as writeFileSync5, existsSync as existsSync8 } from "node:fs";
+import { readFileSync as readFileSync7, rmSync as rmSync2, writeFileSync as writeFileSync5, existsSync as existsSync9 } from "node:fs";
 import path14 from "node:path";
 function definedVars(tokensCss) {
   if (tokensCss === void 0) return void 0;
@@ -3931,9 +3965,9 @@ async function checkBundleQuality(bundleDir, entry) {
   const entryPath = path14.join(bundleDir, entry);
   const cssPath = path14.join(bundleDir, "styles.css");
   const tokensPath = path14.join(bundleDir, "tokens.css");
-  const css = existsSync8(cssPath) ? readFileSync7(cssPath, "utf8") : "";
-  const tokensCss = existsSync8(tokensPath) ? readFileSync7(tokensPath, "utf8") : void 0;
-  if (existsSync8(entryPath)) {
+  const css = existsSync9(cssPath) ? readFileSync7(cssPath, "utf8") : "";
+  const tokensCss = existsSync9(tokensPath) ? readFileSync7(tokensPath, "utf8") : void 0;
+  if (existsSync9(entryPath)) {
     const workDir = newScratchDir("quality");
     try {
       const tsxPath = path14.join(workDir, entry);
@@ -4000,7 +4034,7 @@ var init_effect_geometry = __esm({
 });
 
 // packages/verify/src/bundle-score.ts
-import { existsSync as existsSync9, mkdirSync as mkdirSync3, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "node:fs";
+import { existsSync as existsSync10, mkdirSync as mkdirSync3, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "node:fs";
 import path15 from "node:path";
 import { build as build4 } from "esbuild";
 import { chromium as chromium4 } from "playwright-core";
@@ -4064,7 +4098,7 @@ function repRef(set, rep) {
 }
 function repEffectExtents(set, rep) {
   const file = path15.join(set, rep, "get_design_context.json");
-  if (!existsSync9(file)) return void 0;
+  if (!existsSync10(file)) return void 0;
   try {
     const text = JSON.parse(readFileSync8(file, "utf8")).content.map((c) => c.text ?? "").join("\n");
     const extents = shadowExtents(text);
@@ -4078,8 +4112,8 @@ async function scoreBundleForTask(task, bundleDir, bar = BAR, opts = {}) {
   const CONFIGS2 = task.configs;
   const timeoutMs = opts.mountDeadlineMs ?? ENGINE_MOUNT_DEADLINE_MS;
   const entryTsx = path15.join(bundleDir, task.entry);
-  if (!existsSync9(entryTsx)) return CONFIGS2.map((c) => ({ rep: c.rep, similarity: 0, inkRecall: 0, exact: { similarity: 0, inkRecall: 0 }, pass: false, error: `${task.entry} missing` }));
-  const css = ["tokens.css", "styles.css"].map((f) => path15.join(bundleDir, f)).filter((f) => existsSync9(f)).map((f) => readFileSync8(f, "utf8")).join("\n");
+  if (!existsSync10(entryTsx)) return CONFIGS2.map((c) => ({ rep: c.rep, similarity: 0, inkRecall: 0, exact: { similarity: 0, inkRecall: 0 }, pass: false, error: `${task.entry} missing` }));
+  const css = ["tokens.css", "styles.css"].map((f) => path15.join(bundleDir, f)).filter((f) => existsSync10(f)).map((f) => readFileSync8(f, "utf8")).join("\n");
   const mountSrc = `
 import { createElement } from "react";
 import { createRoot } from "react-dom/client";
@@ -4281,7 +4315,7 @@ var init_prelude = __esm({
 });
 
 // packages/verify/src/parity.ts
-import { existsSync as existsSync10, readFileSync as readFileSync9 } from "node:fs";
+import { existsSync as existsSync11, readFileSync as readFileSync9 } from "node:fs";
 import path16 from "node:path";
 import { chromium as chromium6 } from "playwright-core";
 function getFontFaces3() {
@@ -4311,7 +4345,7 @@ async function checkHoverParity(task, bundleDir, opts = {}) {
   const deadlineMs = timeoutMs + 1e4;
   const js = await compileMount(task, bundleDir);
   if (typeof js !== "string") return configs.map((c) => ({ id: `parity:${c.rep}`, pass: false, detail: js.error }));
-  const css = ["tokens.css", "styles.css"].map((f) => path16.join(bundleDir, f)).filter((f) => existsSync10(f)).map((f) => readFileSync9(f, "utf8")).join("\n");
+  const css = ["tokens.css", "styles.css"].map((f) => path16.join(bundleDir, f)).filter((f) => existsSync11(f)).map((f) => readFileSync9(f, "utf8")).join("\n");
   const server = await chromium6.launchServer({ executablePath: resolveChrome(), headless: true, args: [MEMORY_CAP_ARG] });
   const browser = await chromium6.connect(server.wsEndpoint());
   const results = [];
@@ -4391,7 +4425,7 @@ var init_parity = __esm({
 
 // packages/verify/src/composition.ts
 import { createRequire } from "node:module";
-import { existsSync as existsSync11, readFileSync as readFileSync10 } from "node:fs";
+import { existsSync as existsSync12, readFileSync as readFileSync10 } from "node:fs";
 import path17 from "node:path";
 import { build as build6 } from "esbuild";
 import { chromium as chromium7 } from "playwright-core";
@@ -4401,7 +4435,7 @@ function getFontFaces4() {
 }
 async function compileInstrumentedMount(task, bundleDir) {
   const entryTsx = path17.join(bundleDir, task.entry);
-  if (!existsSync11(entryTsx)) return { error: `${task.entry} missing` };
+  if (!existsSync12(entryTsx)) return { error: `${task.entry} missing` };
   const requireFromVerify = createRequire(path17.join(VERIFY_PKG_DIR, "package.json"));
   let realJsxPath;
   try {
@@ -4465,7 +4499,7 @@ function expectedParts(task, roles, mainSlug) {
 }
 function interiorRegions(setDir, roles) {
   const mains = roles.main;
-  const withInterior = mains.filter((m) => existsSync11(path17.join(setDir, m, "get_metadata_interior.json")));
+  const withInterior = mains.filter((m) => existsSync12(path17.join(setDir, m, "get_metadata_interior.json")));
   if (withInterior.length === 0) {
     return { unavailable: "no interior geometry recorded for any main (pre-obligation set) \u2014 re-record with `tendril record` to enable crop checks" };
   }
@@ -4482,7 +4516,7 @@ async function checkCropComposition(task, bundleDir, regions, opts = {}) {
   if (typeof js !== "string") {
     return regions.map((r) => ({ id: cropId(r), pass: false, similarity: 0, inkRecall: 0, detail: js.error }));
   }
-  const css = ["tokens.css", "styles.css"].map((f) => path17.join(bundleDir, f)).filter((f) => existsSync11(f)).map((f) => readFileSync10(f, "utf8")).join("\n");
+  const css = ["tokens.css", "styles.css"].map((f) => path17.join(bundleDir, f)).filter((f) => existsSync12(f)).map((f) => readFileSync10(f, "utf8")).join("\n");
   const server = await chromium7.launchServer({ executablePath: resolveChrome(), headless: true, args: [MEMORY_CAP_ARG] });
   const browser = await chromium7.connect(server.wsEndpoint());
   const PAD = 4;
@@ -4587,7 +4621,7 @@ async function checkStructuralComposition(task, bundleDir, roles, opts = {}) {
   const deadlineMs = timeoutMs + 1e4;
   const js = await compileInstrumentedMount(task, bundleDir);
   if (typeof js !== "string") return [...results, ...mains.map((m) => ({ id: `composition:${m}`, pass: false, detail: js.error }))];
-  const css = ["tokens.css", "styles.css"].map((f) => path17.join(bundleDir, f)).filter((f) => existsSync11(f)).map((f) => readFileSync10(f, "utf8")).join("\n");
+  const css = ["tokens.css", "styles.css"].map((f) => path17.join(bundleDir, f)).filter((f) => existsSync12(f)).map((f) => readFileSync10(f, "utf8")).join("\n");
   const server = await chromium7.launchServer({ executablePath: resolveChrome(), headless: true, args: [MEMORY_CAP_ARG] });
   const browser = await chromium7.connect(server.wsEndpoint());
   try {
@@ -4677,13 +4711,13 @@ export const jsxs = (t, p, k) => real.jsxs(t, inject(t, p), k);
 });
 
 // packages/verify/src/occlusion.ts
-import { existsSync as existsSync12 } from "node:fs";
+import { existsSync as existsSync13 } from "node:fs";
 import path18 from "node:path";
 import { build as build7 } from "esbuild";
 import { chromium as chromium8 } from "playwright-core";
 async function compileTwoUp(task, bundleDir) {
   const entryTsx = path18.join(bundleDir, task.entry);
-  if (!existsSync12(entryTsx)) return { error: `${task.entry} missing` };
+  if (!existsSync13(entryTsx)) return { error: `${task.entry} missing` };
   const src = `
 import { createElement } from "react";
 import { createRoot } from "react-dom/client";
@@ -4862,9 +4896,48 @@ var init_src4 = __esm({
   }
 });
 
-// packages/cli/src/env.ts
-import { existsSync as existsSync13, readFileSync as readFileSync11 } from "node:fs";
+// packages/cli/src/environment.ts
+import { existsSync as existsSync14, readFileSync as readFileSync11 } from "node:fs";
 import path19 from "node:path";
+import { createHash as createHash2 } from "node:crypto";
+import { fileURLToPath as fileURLToPath4 } from "node:url";
+function cliVersion() {
+  try {
+    return JSON.parse(readFileSync11(path19.join(path19.dirname(fileURLToPath4(import.meta.url)), "..", "package.json"), "utf8")).version ?? "dev";
+  } catch {
+    return "dev";
+  }
+}
+function environmentStamp(taskFamilies) {
+  const manifestPath2 = path19.join(fontCacheDir(), "manifest.json");
+  let fontsHash = null;
+  if (existsSync14(manifestPath2)) {
+    try {
+      const entries = JSON.parse(readFileSync11(manifestPath2, "utf8"));
+      const scoped = taskFamilies === void 0 || taskFamilies === null ? entries : entries.filter((f) => taskFamilies.some((fam) => fam.toLowerCase() === f.family.toLowerCase()));
+      const faces = scoped.map((f) => `${f.family}:${f.weight}:${f.sha256}`).sort();
+      fontsHash = faces.length === 0 ? null : createHash2("sha256").update(faces.join("\n")).digest("hex").slice(0, 16);
+    } catch {
+      fontsHash = null;
+    }
+  }
+  let chrome = "unavailable";
+  try {
+    chrome = resolveChrome();
+  } catch {
+  }
+  return { chrome, chromeVersion: chrome === "unavailable" ? null : chromeVersion(), fontsManifestSha256: fontsHash };
+}
+var init_environment = __esm({
+  "packages/cli/src/environment.ts"() {
+    "use strict";
+    init_src4();
+  }
+});
+
+// packages/cli/src/env.ts
+import { existsSync as existsSync15, readFileSync as readFileSync12 } from "node:fs";
+import path20 from "node:path";
 function parseEnv(content) {
   const entries = /* @__PURE__ */ new Map();
   for (const line of content.split("\n")) {
@@ -4876,9 +4949,9 @@ function parseEnv(content) {
 function resolveCredential(name) {
   const fromProcess = process.env[name];
   if (fromProcess) return fromProcess;
-  const envPath = path19.resolve(process.env["INIT_CWD"] ?? process.cwd(), ".env");
-  if (!existsSync13(envPath)) return void 0;
-  return parseEnv(readFileSync11(envPath, "utf8")).get(name);
+  const envPath = path20.resolve(process.env["INIT_CWD"] ?? process.cwd(), ".env");
+  if (!existsSync15(envPath)) return void 0;
+  return parseEnv(readFileSync12(envPath, "utf8")).get(name);
 }
 var init_env = __esm({
   "packages/cli/src/env.ts"() {
@@ -6133,6 +6206,8 @@ var record_exports = {};
 __export(record_exports, {
   instanceLeads: () => instanceLeads,
   isFigmaAssetUrl: () => isFigmaAssetUrl,
+  isLocalAssetUrl: () => isLocalAssetUrl,
+  nextPayload: () => nextPayload,
   runRecordAsset: () => runRecordAsset,
   runRecordFetch: () => runRecordFetch,
   runRecordFinish: () => runRecordFinish,
@@ -6141,11 +6216,11 @@ __export(record_exports, {
   runRecordPlan: () => runRecordPlan,
   runRecordStatus: () => runRecordStatus
 });
-import { existsSync as existsSync16, readFileSync as readFileSync14 } from "node:fs";
-import path23 from "node:path";
+import { existsSync as existsSync18, readFileSync as readFileSync15, readdirSync as readdirSync4 } from "node:fs";
+import path24 from "node:path";
 import { writeFileSync as writeFileSync8 } from "node:fs";
 function symbolsFromMetadataEnvelope(file, sourceFrame) {
-  const env = JSON.parse(readFileSync14(file, "utf8"));
+  const env = JSON.parse(readFileSync15(file, "utf8"));
   const text = env.content.map((c) => c.text ?? "").join("\n");
   const symbols = [];
   const walk2 = (node, ancestor) => {
@@ -6189,7 +6264,7 @@ function runRecordPlan(opts) {
   for (const spec of opts.metadataFiles) {
     const [file, frame] = spec.split("@");
     try {
-      symbols.push(...symbolsFromMetadataEnvelope(path23.resolve(file), frame));
+      symbols.push(...symbolsFromMetadataEnvelope(path24.resolve(file), frame));
     } catch (err) {
       fail(opts, ExitCode.InputValidation, {
         error: `could not read metadata envelope ${file}: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}`,
@@ -6221,7 +6296,7 @@ function runRecordPlan(opts) {
     const leads = opts.metadataFiles.flatMap((spec) => {
       const [file] = spec.split("@");
       try {
-        const env = JSON.parse(readFileSync14(path23.resolve(file), "utf8"));
+        const env = JSON.parse(readFileSync15(path24.resolve(file), "utf8"));
         return instanceLeads(env.content.map((c) => c.text ?? "").join("\n"));
       } catch {
         return [];
@@ -6296,27 +6371,28 @@ function runRecordPlan(opts) {
     }
   );
 }
-function runRecordNext(opts) {
-  const instruction = nextInstruction(opts.setDir);
-  const status = sessionStatus(opts.setDir);
+function nextPayload(setDir) {
+  const instruction = nextInstruction(setDir);
+  const status = sessionStatus(setDir);
   const progress = { recordedReps: status.reps.filter((x) => x.missing.length === 0).length, totalReps: status.reps.length };
-  if (instruction === null && !existsSync16(path23.join(opts.setDir, "get_variable_defs.json"))) {
-    const manifest = loadManifest(opts.setDir);
+  if (instruction === null && !existsSync18(path24.join(setDir, "get_variable_defs.json"))) {
+    const manifest = loadManifest(setDir);
     const frameNode = Object.keys(manifest.sourceFrames ?? {})[0] ?? manifest.reps[0]?.nodeId ?? "";
-    emitData(opts, { slug: "__set__", nodeId: frameNode, tool: "get_variable_defs", note: `SET-LEVEL: call get_variable_defs on the component frame and ingest with --rep __set__. ${ENVELOPE_HELP}`, progress }, () => {
-      process.stdout.write(`get_variable_defs (SET-LEVEL) on node ${frameNode} \u2192 ingest with --rep __set__
-`);
-    });
-    return;
+    return { slug: "__set__", nodeId: frameNode, tool: "get_variable_defs", note: `SET-LEVEL: call get_variable_defs on the component frame and ingest with --rep __set__. ${ENVELOPE_HELP}`, progress };
   }
-  emitData(opts, instruction === null ? { complete: true, progress } : { ...instruction, note: `${instruction.note}. ${ENVELOPE_HELP}`, progress }, () => {
-    if (instruction === null) {
+  return instruction === null ? { complete: true, progress } : { ...instruction, note: `${instruction.note}. ${ENVELOPE_HELP}`, progress };
+}
+function runRecordNext(opts) {
+  const payload = nextPayload(opts.setDir);
+  emitData(opts, payload, () => {
+    if (payload["complete"] === true) {
       process.stdout.write("set complete \u2014 every planned rep has its required envelopes\n");
       return;
     }
-    process.stdout.write(`[${progress.recordedReps}/${progress.totalReps} reps] ${instruction.tool} for ${instruction.slug} (node ${instruction.nodeId})
-  \u2192 ${instruction.note}
-  \u2192 then: tendril record ingest --set <dir> --rep ${instruction.slug} --tool ${instruction.tool} --file <envelope.json>
+    const progress = payload["progress"];
+    process.stdout.write(`[${progress.recordedReps}/${progress.totalReps} reps] ${payload["tool"]} for ${payload["slug"]} (node ${payload["nodeId"]})
+  \u2192 ${payload["note"]}
+  \u2192 then: tendril record ingest --set <dir> --rep ${payload["slug"]} --tool ${payload["tool"]} --file <envelope.json>
 `);
   });
 }
@@ -6331,6 +6407,29 @@ function isFigmaAssetUrl(raw) {
   if (u.username !== "" || u.password !== "") return false;
   return u.hostname === "figma.com" || u.hostname.endsWith(".figma.com");
 }
+function isLocalAssetUrl(raw) {
+  let u;
+  try {
+    u = new URL(raw);
+  } catch {
+    return false;
+  }
+  if (u.username !== "" || u.password !== "") return false;
+  return (u.protocol === "http:" || u.protocol === "https:") && (u.hostname === "localhost" || u.hostname === "127.0.0.1");
+}
+async function fetchAssetBytes(startUrl, allowed) {
+  let url = startUrl;
+  let res = await fetch(url, { redirect: "manual" });
+  for (let hop = 0; res.status >= 300 && res.status < 400 && hop < 5; hop++) {
+    const next = res.headers.get("location");
+    if (next === null) break;
+    url = new URL(next, url).toString();
+    if (!allowed(url)) throw new Error(`redirect left the allowed hosts: ${url}`);
+    res = await fetch(url, { redirect: "manual" });
+  }
+  if (!res.ok) throw new Error(`HTTP ${res.status}`);
+  return Buffer.from(await res.arrayBuffer());
+}
 async function runRecordFetch(opts) {
   if (!isFigmaAssetUrl(opts.url)) {
     fail(opts, ExitCode.InputValidation, {
@@ -6341,17 +6440,7 @@ async function runRecordFetch(opts) {
   }
   let bytes;
   try {
-    let url = opts.url;
-    let res = await fetch(url, { redirect: "manual" });
-    for (let hop = 0; res.status >= 300 && res.status < 400 && hop < 5; hop++) {
-      const next = res.headers.get("location");
-      if (next === null) break;
-      url = new URL(next, url).toString();
-      if (!isFigmaAssetUrl(url)) throw new Error(`redirect left Figma: ${url}`);
-      res = await fetch(url, { redirect: "manual" });
-    }
-    if (!res.ok) throw new Error(`HTTP ${res.status}`);
-    bytes = Buffer.from(await res.arrayBuffer());
+    bytes = await fetchAssetBytes(opts.url, isFigmaAssetUrl);
   } catch (err) {
     fail(opts, ExitCode.InputValidation, {
       error: `asset fetch failed: ${err instanceof Error ? err.message : String(err)}`,
@@ -6369,7 +6458,7 @@ async function runRecordFetch(opts) {
   const payload = { content: [{ type: "image", data: bytes.toString("base64"), mimeType: "image/png" }] };
   try {
     const { overwrote } = ingestEnvelope(opts.setDir, opts.rep, opts.tool, payload);
-    emitData(opts, { rep: opts.rep, tool: opts.tool, bytes: bytes.length, overwrote, source: "cli-fetch" }, () => {
+    emitData(opts, { rep: opts.rep, tool: opts.tool, bytes: bytes.length, overwrote, source: "cli-fetch", next: nextPayload(opts.setDir) }, () => {
       process.stdout.write(`fetched + ingested ${opts.rep}/${opts.tool} (${bytes.length} bytes, no model in the byte path)
 `);
     });
@@ -6381,15 +6470,47 @@ async function runRecordFetch(opts) {
     });
   }
 }
-function runRecordIngest(opts) {
+async function autoFetchAssets(setDir, rep, envelopeText2) {
+  const fetched = [];
+  const skipped = [];
+  const failed = [];
+  for (const { url, name } of assetUrlsFromEnvelopeText(envelopeText2)) {
+    if (existsSync18(path24.join(setDir, rep, name))) {
+      skipped.push(name);
+      continue;
+    }
+    if (!isAutoFetchAssetUrl(url)) {
+      failed.push({ name, url, reason: "host not on the auto-fetch allowlist (Figma hosts and the desktop app's localhost only)" });
+      continue;
+    }
+    try {
+      const bytes = await fetchAssetBytes(url, isAutoFetchAssetUrl);
+      if (name.endsWith(".svg") && !bytes.toString("utf8", 0, 512).includes("<svg")) throw new Error("response is not an SVG (expired URL usually returns HTML)");
+      if (name.endsWith(".png") && !(bytes.length > 8 && bytes[0] === 137 && bytes[1] === 80)) throw new Error("response is not a PNG (expired URL usually returns HTML)");
+      ingestAsset(setDir, rep, name, bytes);
+      fetched.push(name);
+    } catch (err) {
+      failed.push({ name, url, reason: err instanceof Error ? err.message : String(err) });
+    }
+  }
+  return { fetched, skipped, failed };
+}
+async function runRecordIngest(opts) {
   let payload;
   try {
-    payload = JSON.parse(readFileSync14(path23.resolve(opts.file), "utf8"));
+    payload = opts.raw === true ? { content: [{ type: "text", text: readFileSync15(path24.resolve(opts.file), "utf8") }] } : JSON.parse(readFileSync15(path24.resolve(opts.file), "utf8"));
   } catch (err) {
     fail(opts, ExitCode.InputValidation, {
       error: `cannot read envelope file: ${err instanceof Error ? err.message : String(err)}`,
       code: "envelope-unreadable",
-      remediation: "Pass the tool response saved verbatim as JSON."
+      remediation: "Pass the tool response saved verbatim: as JSON, or as raw text with --raw."
+    });
+  }
+  if (opts.raw === true && opts.tool === "get_screenshot") {
+    fail(opts, ExitCode.InputValidation, {
+      error: "--raw is for text tool responses; screenshots are binary",
+      code: "envelope-invalid",
+      remediation: "Use `tendril record fetch` with the image_url instead."
     });
   }
   if (opts.rep === "__set__" && opts.tool === "get_variable_defs") {
@@ -6401,18 +6522,25 @@ function runRecordIngest(opts) {
         remediation: "Save the get_variable_defs response verbatim as a text envelope."
       });
     }
-    writeFileSync8(path23.join(opts.setDir, "get_variable_defs.json"), `${JSON.stringify(payload, null, 1)}
+    writeFileSync8(path24.join(opts.setDir, "get_variable_defs.json"), `${JSON.stringify(payload, null, 1)}
 `);
-    emitData(opts, { ingested: "get_variable_defs", rep: "__set__", setLevel: true }, () => {
+    emitData(opts, { ingested: "get_variable_defs", rep: "__set__", setLevel: true, next: nextPayload(opts.setDir) }, () => {
       process.stdout.write("set-level get_variable_defs ingested\n");
     });
     return;
   }
   try {
     const { overwrote } = ingestEnvelope(opts.setDir, opts.rep, opts.tool, payload);
-    emitData(opts, { rep: opts.rep, tool: opts.tool, overwrote }, () => {
+    const assets = opts.tool === "get_design_context" ? await autoFetchAssets(opts.setDir, opts.rep, payload.content.map((c) => c.text ?? "").join("\n")) : void 0;
+    emitData(opts, { rep: opts.rep, tool: opts.tool, overwrote, ...assets !== void 0 ? { assets } : {}, next: nextPayload(opts.setDir) }, () => {
       process.stdout.write(`ingested ${opts.rep}/${opts.tool}${overwrote ? " (overwrote prior recording)" : ""}
 `);
+      if (assets !== void 0) {
+        for (const a of assets.fetched) process.stdout.write(`  asset fetched ${a}
+`);
+        for (const f of assets.failed) process.stdout.write(`  ASSET FAILED ${f.name}: ${f.reason} \u2014 download it and run tendril record asset
+`);
+      }
     });
   } catch (err) {
     fail(opts, ExitCode.InputValidation, {
@@ -6423,8 +6551,44 @@ function runRecordIngest(opts) {
   }
 }
 function runRecordAsset(opts) {
+  if (opts.dir !== void 0) {
+    const dir = path24.resolve(opts.dir);
+    const names = readdirSync4(dir).filter((f) => /^asset-[\w.-]+\.(svg|png|jpe?g|webp|gif)$/i.test(f));
+    if (names.length === 0) {
+      fail(opts, ExitCode.InputValidation, {
+        error: `no asset-*.<ext> files found in ${dir}`,
+        code: "asset-rejected",
+        remediation: "Name downloaded assets asset-<id>.<ext> (the id from the asset URL), or pass --name/--file for a single asset."
+      });
+    }
+    const ingested = [];
+    try {
+      for (const name of names) {
+        ingestAsset(opts.setDir, opts.rep, name, readFileSync15(path24.join(dir, name)));
+        ingested.push(name);
+      }
+    } catch (err) {
+      fail(opts, ExitCode.InputValidation, {
+        error: `after ${ingested.length} ingested: ${err instanceof Error ? err.message : String(err)}`,
+        code: "asset-rejected",
+        remediation: "Assets must be named asset-<id>.<ext>, size-capped, and SVGs must carry no active content."
+      });
+    }
+    emitData(opts, { rep: opts.rep, assets: ingested }, () => {
+      for (const name of ingested) process.stdout.write(`ingested ${opts.rep}/${name}
+`);
+    });
+    return;
+  }
+  if (opts.name === void 0 || opts.file === void 0) {
+    fail(opts, ExitCode.InputValidation, {
+      error: "pass --name and --file for a single asset, or --dir for a batch",
+      code: "asset-rejected",
+      remediation: "tendril record asset --set <dir> --rep <slug> --dir <downloads-dir>"
+    });
+  }
   try {
-    ingestAsset(opts.setDir, opts.rep, opts.name, readFileSync14(path23.resolve(opts.file)));
+    ingestAsset(opts.setDir, opts.rep, opts.name, readFileSync15(path24.resolve(opts.file)));
     emitData(opts, { rep: opts.rep, asset: opts.name }, () => {
       process.stdout.write(`ingested ${opts.rep}/${opts.name}
 `);
@@ -6452,7 +6616,7 @@ ${status.reps.filter((r) => r.missing.length > 0).length} rep(s) pending
 function runRecordFinish(opts) {
   const manifest = loadManifest(opts.setDir);
   const derived = deriveRoles(opts.setDir, manifest);
-  const roles = opts.rolesFile !== void 0 ? { ...JSON.parse(readFileSync14(path23.resolve(opts.rolesFile), "utf8")), humanOverride: true } : { main: derived.main, parts: derived.parts, external: derived.external, humanOverride: false };
+  const roles = opts.rolesFile !== void 0 ? { ...JSON.parse(readFileSync15(path24.resolve(opts.rolesFile), "utf8")), humanOverride: true } : { main: derived.main, parts: derived.parts, external: derived.external, humanOverride: false };
   emitData(opts, { derived, confirmed: opts.confirmRoles }, () => {
     process.stdout.write(`derived mains: ${derived.main.join(", ") || "(none)"}
 `);
@@ -6479,11 +6643,11 @@ function runRecordFinish(opts) {
     });
   }
   const updated = { ...manifest, roles };
-  writeFileSync8(path23.join(opts.setDir, "recording-set.json"), `${JSON.stringify(updated, null, 1)}
+  writeFileSync8(path24.join(opts.setDir, "recording-set.json"), `${JSON.stringify(updated, null, 1)}
 `);
   if (!opts.json) process.stdout.write("roles written to recording-set.json\n");
 }
-var ENVELOPE_HELP;
+var ENVELOPE_HELP, isAutoFetchAssetUrl;
 var init_record = __esm({
   "packages/cli/src/commands/record.ts"() {
     "use strict";
@@ -6491,6 +6655,7 @@ var init_record = __esm({
     init_src();
     init_output();
     ENVELOPE_HELP = 'Envelope format: text tools save {"content":[{"type":"text","text":"<VERBATIM response text incl. any Currently-selected-nodes block>"}]}; get_screenshot: do NOT download the image yourself \u2014 pass its image_url to `tendril record fetch` (MCP: tendril_record_fetch), which pulls the bytes to disk directly. That keeps the pixel ground truth out of your context and costs one approval instead of a shell command per asset. Assets are asset-<first-8-hex-of-figma-uuid>.<ext>; their URLs appear as const declarations inside the design-context text and also expire.';
+    isAutoFetchAssetUrl = (url) => isFigmaAssetUrl(url) || isLocalAssetUrl(url);
   }
 });
 
@@ -6681,8 +6846,8 @@ var init_engine_curated = __esm({
 });
 
 // packages/generate/src/loop.ts
-import { existsSync as existsSync17, mkdirSync as mkdirSync5, readFileSync as readFileSync15, renameSync, writeFileSync as writeFileSync9 } from "node:fs";
-import path24 from "node:path";
+import { existsSync as existsSync19, mkdirSync as mkdirSync5, readFileSync as readFileSync16, renameSync, writeFileSync as writeFileSync9 } from "node:fs";
+import path25 from "node:path";
 import { z as z11 } from "zod";
 function objective(scores, behaviors) {
   const vals = scores.map((s) => Math.min(s.similarity, s.inkRecall));
@@ -6713,9 +6878,9 @@ ${preludeLines.join("\n")}` : ""}
 Fix the FAIL configs (region coordinates are in the recorded screenshot's frame; ink<1 means recorded foreground pixels your render does not cover). Do not regress PASS configs. ${mode === "files" ? "Update the files in your candidate directory and re-run the score." : "Reply with the complete corrected files in the same FILE format."}`;
 }
 function archivePriorRun(outDir) {
-  if (!existsSync17(path24.join(outDir, "run-log.json")) && !existsSync17(path24.join(outDir, "loop-state.json"))) return void 0;
+  if (!existsSync19(path25.join(outDir, "run-log.json")) && !existsSync19(path25.join(outDir, "loop-state.json"))) return void 0;
   let n = 1;
-  while (existsSync17(`${outDir}-prev-${n}`)) n += 1;
+  while (existsSync19(`${outDir}-prev-${n}`)) n += 1;
   renameSync(outDir, `${outDir}-prev-${n}`);
   return `${outDir}-prev-${n}`;
 }
@@ -6724,14 +6889,14 @@ async function runEngineLoop(opts) {
   const plateau = opts.plateau ?? 2;
   const progress = opts.onProgress ?? (() => {
   });
-  const statePath = path24.join(opts.outDir, "loop-state.json");
-  const resuming = opts.resume === true && existsSync17(statePath);
+  const statePath = path25.join(opts.outDir, "loop-state.json");
+  const resuming = opts.resume === true && existsSync19(statePath);
   if (!resuming) {
     const archived = archivePriorRun(opts.outDir);
     if (archived !== void 0) progress(`previous run archived to ${archived}`);
   }
   mkdirSync5(opts.outDir, { recursive: true });
-  const scratch = path24.join(opts.outDir, ".candidate");
+  const scratch = path25.join(opts.outDir, ".candidate");
   let attempts = [];
   let log = [];
   let best;
@@ -6739,7 +6904,7 @@ async function runEngineLoop(opts) {
   let nonAccepted = 0;
   let stopReason = "max-iterations";
   if (resuming) {
-    const restored = LoopStateSchema.parse(JSON.parse(readFileSync15(statePath, "utf8")));
+    const restored = LoopStateSchema.parse(JSON.parse(readFileSync16(statePath, "utf8")));
     attempts = restored.attempts;
     log = restored.iterations;
     spentUsd = restored.spentUsd;
@@ -6759,7 +6924,7 @@ async function runEngineLoop(opts) {
   };
   const writeCandidate = (files) => {
     mkdirSync5(scratch, { recursive: true });
-    for (const [name, content] of Object.entries(files)) writeFileSync9(path24.join(scratch, name), content);
+    for (const [name, content] of Object.entries(files)) writeFileSync9(path25.join(scratch, name), content);
   };
   const scoreCandidate = async (candidate, iter, usd, modelMs) => {
     writeCandidate(candidate.files);
@@ -6817,8 +6982,8 @@ async function runEngineLoop(opts) {
       const usd = candidate.usage?.usd ?? 0;
       spentUsd += usd;
       if (candidate.raw !== void 0) {
-        mkdirSync5(path24.join(opts.outDir, "responses"), { recursive: true });
-        writeFileSync9(path24.join(opts.outDir, "responses", `iter-${iter}.md`), candidate.raw);
+        mkdirSync5(path25.join(opts.outDir, "responses"), { recursive: true });
+        writeFileSync9(path25.join(opts.outDir, "responses", `iter-${iter}.md`), candidate.raw);
       }
       if (candidate.files[opts.entry] === void 0 || candidate.files["styles.css"] === void 0) {
         const finish = candidate.usage?.finishReason ?? "?";
@@ -6844,10 +7009,10 @@ async function runEngineLoop(opts) {
       }
     }
   }
-  if (best !== void 0) for (const [name, content] of Object.entries(best.files)) writeFileSync9(path24.join(opts.outDir, name), content);
+  if (best !== void 0) for (const [name, content] of Object.entries(best.files)) writeFileSync9(path25.join(opts.outDir, name), content);
   const final = best !== void 0 ? await opts.score(opts.outDir) : { scores: [], behaviors: [] };
   writeFileSync9(
-    path24.join(opts.outDir, "run-log.json"),
+    path25.join(opts.outDir, "run-log.json"),
     `${JSON.stringify(
       {
         ...opts.meta,
@@ -6914,8 +7079,8 @@ var init_loop2 = __esm({
 });
 
 // packages/generate/src/brief.ts
-import { existsSync as existsSync18, readFileSync as readFileSync16 } from "node:fs";
-import path25 from "node:path";
+import { existsSync as existsSync20, readFileSync as readFileSync17 } from "node:fs";
+import path26 from "node:path";
 function singleAxes2(name) {
   const parsed = parseVariantAxes(name);
   if (parsed === void 0) return void 0;
@@ -7111,7 +7276,7 @@ function authorBehaviors(api) {
   return { behaviors, prelude: { controls: interactive ? ["> *"] : [], textInputs: [] }, disclosures };
 }
 function envelopeText(file) {
-  return JSON.parse(readFileSync16(file, "utf8")).content[0]?.text ?? "";
+  return JSON.parse(readFileSync17(file, "utf8")).content[0]?.text ?? "";
 }
 function recordedFontNeeds(setDir) {
   const byFamily = /* @__PURE__ */ new Map();
@@ -7146,13 +7311,13 @@ function recordedFontNeeds(setDir) {
     }
   };
   const manifest = loadManifest(setDir);
-  const setDefs = path25.join(setDir, "get_variable_defs.json");
-  if (existsSync18(setDefs)) fromDefs(envelopeText(setDefs));
+  const setDefs = path26.join(setDir, "get_variable_defs.json");
+  if (existsSync20(setDefs)) fromDefs(envelopeText(setDefs));
   for (const rep of manifest.reps) {
-    const ctx = path25.join(setDir, rep.slug, "get_design_context.json");
-    if (existsSync18(ctx)) fromEmission(envelopeText(ctx));
-    const defs = path25.join(setDir, rep.slug, "get_variable_defs.json");
-    if (existsSync18(defs)) fromDefs(envelopeText(defs));
+    const ctx = path26.join(setDir, rep.slug, "get_design_context.json");
+    if (existsSync20(ctx)) fromEmission(envelopeText(ctx));
+    const defs = path26.join(setDir, rep.slug, "get_variable_defs.json");
+    if (existsSync20(defs)) fromDefs(envelopeText(defs));
   }
   return [...byFamily.entries()].map(([family, paired]) => {
     const weights = /* @__PURE__ */ new Set([...paired, ...unpaired]);
@@ -7171,8 +7336,8 @@ function authorTaskFromSet(setDir, opts = {}) {
   const poses = [];
   const missing = [];
   for (const rep of manifest.reps) {
-    const metaFile = path25.join(setDir, rep.slug, "get_metadata.json");
-    if (!existsSync18(metaFile)) {
+    const metaFile = path26.join(setDir, rep.slug, "get_metadata.json");
+    if (!existsSync20(metaFile)) {
       missing.push(rep.slug);
       continue;
     }
@@ -7186,8 +7351,8 @@ function authorTaskFromSet(setDir, opts = {}) {
   if (missing.length > 0) {
     throw new Error(`recording set ${setDir} is missing metadata for ${missing.length} rep(s): ${missing.slice(0, 5).join(", ")}${missing.length > 5 ? ", \u2026" : ""}`);
   }
-  const setMeta = path25.join(setDir, "get_metadata.json");
-  const latticeNames = manifest.latticeNames ?? (existsSync18(setMeta) ? [...envelopeText(setMeta).matchAll(/name="([^"]*)"/g)].map((m) => decodeXmlEntities(m[1])) : void 0);
+  const setMeta = path26.join(setDir, "get_metadata.json");
+  const latticeNames = manifest.latticeNames ?? (existsSync20(setMeta) ? [...envelopeText(setMeta).matchAll(/name="([^"]*)"/g)].map((m) => decodeXmlEntities(m[1])) : void 0);
   const defaults = { ...manifest.defaults ?? {}, ...opts.defaults ?? {} };
   const recordedFonts = recordedFontFamilies(setDir);
   const api = authorComponentApi({
@@ -7299,10 +7464,10 @@ var init_brief = __esm({
 });
 
 // packages/generate/src/segments.ts
-import { existsSync as existsSync19, readFileSync as readFileSync17, readdirSync as readdirSync4 } from "node:fs";
-import path26 from "node:path";
+import { existsSync as existsSync21, readFileSync as readFileSync18, readdirSync as readdirSync5 } from "node:fs";
+import path27 from "node:path";
 function repText(set, rep, tool) {
-  return JSON.parse(readFileSync17(path26.join(set, rep, `${tool}.json`), "utf8")).content[0]?.text ?? "";
+  return JSON.parse(readFileSync18(path27.join(set, rep, `${tool}.json`), "utf8")).content[0]?.text ?? "";
 }
 function stripFigmaInstructions(emission) {
   const STYLE_FACTS = "These styles are contained in the design:";
@@ -7362,17 +7527,17 @@ DROPPED from the map, untrustworthy in the source export \u2014 for these, each
 function buildSegments(task, mode = "fenced") {
   const SET = task.set;
   let rawDefs = {};
-  if (existsSync19(path26.join(SET, "get_variable_defs.json"))) {
-    const text = JSON.parse(readFileSync17(path26.join(SET, "get_variable_defs.json"), "utf8")).content[0]?.text ?? "{}";
+  if (existsSync21(path27.join(SET, "get_variable_defs.json"))) {
+    const text = JSON.parse(readFileSync18(path27.join(SET, "get_variable_defs.json"), "utf8")).content[0]?.text ?? "{}";
     try {
       rawDefs = JSON.parse(text);
     } catch {
     }
   } else {
     for (const cfg of task.configs) {
-      const f = path26.join(SET, cfg.rep, "get_variable_defs.json");
-      if (!existsSync19(f)) continue;
-      const text = JSON.parse(readFileSync17(f, "utf8")).content[0]?.text ?? "{}";
+      const f = path27.join(SET, cfg.rep, "get_variable_defs.json");
+      if (!existsSync21(f)) continue;
+      const text = JSON.parse(readFileSync18(f, "utf8")).content[0]?.text ?? "{}";
       try {
         for (const [k, v] of Object.entries(JSON.parse(text))) rawDefs[k] ??= v;
       } catch {
@@ -7380,8 +7545,8 @@ function buildSegments(task, mode = "fenced") {
     }
   }
   const emissionTexts = task.configs.map((cfg) => {
-    const f = path26.join(SET, cfg.rep, "get_design_context.json");
-    return existsSync19(f) ? JSON.parse(readFileSync17(f, "utf8")).content[0]?.text ?? "" : "";
+    const f = path27.join(SET, cfg.rep, "get_design_context.json");
+    return existsSync21(f) ? JSON.parse(readFileSync18(f, "utf8")).content[0]?.text ?? "" : "";
   });
   const { map, note } = cleanTokenMap(rawDefs, emissionTexts);
   const defs = JSON.stringify(map, null, 1);
@@ -7396,9 +7561,9 @@ ${defs}
   for (const cfg of task.configs) {
     const meta = stripFigmaInstructions(repText(SET, cfg.rep, "get_metadata"));
     const emission = stripFigmaInstructions(repText(SET, cfg.rep, "get_design_context"));
-    const assets = readdirSync4(path26.join(SET, cfg.rep)).filter((f) => f.startsWith("asset-") && f.endsWith(".svg")).map((f) => `asset ${f}:
+    const assets = readdirSync5(path27.join(SET, cfg.rep)).filter((f) => f.startsWith("asset-") && f.endsWith(".svg")).map((f) => `asset ${f}:
 \`\`\`svg
-${readFileSync17(path26.join(SET, cfg.rep, f), "utf8")}
+${readFileSync18(path27.join(SET, cfg.rep, f), "utf8")}
 \`\`\``).join("\n");
     parts.push(`
 ## Config ${cfg.rep} \u2192 ${cfg.component} ${JSON.stringify(cfg.props)}
@@ -7489,9 +7654,9 @@ var init_adapter = __esm({
 });
 
 // packages/generate/src/bundle-emit.ts
-import { createHash as createHash2 } from "node:crypto";
-import { existsSync as existsSync20, readFileSync as readFileSync18, readdirSync as readdirSync5, writeFileSync as writeFileSync10 } from "node:fs";
-import path27 from "node:path";
+import { createHash as createHash3 } from "node:crypto";
+import { existsSync as existsSync22, readFileSync as readFileSync19, readdirSync as readdirSync6, writeFileSync as writeFileSync10 } from "node:fs";
+import path28 from "node:path";
 function pinFromConfigs(configs) {
   const domains = /* @__PURE__ */ new Map();
   const kinds = /* @__PURE__ */ new Map();
@@ -7540,22 +7705,22 @@ function cssFontFamilies(css) {
   return [...out];
 }
 function countLatticeSymbols(setDir) {
-  const manifestFile = path27.join(setDir, "recording-set.json");
-  if (existsSync20(manifestFile)) {
+  const manifestFile = path28.join(setDir, "recording-set.json");
+  if (existsSync22(manifestFile)) {
     try {
-      const lattice = JSON.parse(readFileSync18(manifestFile, "utf8")).latticeNames;
+      const lattice = JSON.parse(readFileSync19(manifestFile, "utf8")).latticeNames;
       if (lattice !== void 0 && lattice.length > 0) return lattice.length;
     } catch {
     }
   }
   const files = [
-    path27.join(setDir, "get_metadata.json"),
-    ...existsSync20(setDir) ? readdirSync5(setDir).filter((f) => /^get_metadata-.*\.json$/.test(f)).map((f) => path27.join(setDir, f)) : []
-  ].filter((f) => existsSync20(f));
+    path28.join(setDir, "get_metadata.json"),
+    ...existsSync22(setDir) ? readdirSync6(setDir).filter((f) => /^get_metadata-.*\.json$/.test(f)).map((f) => path28.join(setDir, f)) : []
+  ].filter((f) => existsSync22(f));
   if (files.length === 0) return null;
   let count = 0;
   for (const f of files) {
-    const text = JSON.parse(readFileSync18(f, "utf8")).content[0]?.text ?? "";
+    const text = JSON.parse(readFileSync19(f, "utf8")).content[0]?.text ?? "";
     count += [...text.matchAll(/name="([^"]*)"/g)].filter((m) => m[1].includes("=")).length;
   }
   return count > 0 ? count : null;
@@ -7563,23 +7728,23 @@ function countLatticeSymbols(setDir) {
 function recordingSetHash(setDir, configs) {
   const relPaths = [];
   for (const name of ["recording-set.json", "completeness-manifest.json", "get_variable_defs.json", "get_metadata.json"]) {
-    if (existsSync20(path27.join(setDir, name))) relPaths.push(name);
+    if (existsSync22(path28.join(setDir, name))) relPaths.push(name);
   }
   for (const cfg of configs) {
     for (const f of ["get_design_context.json", "get_metadata.json", "get_screenshot.json", "get_variable_defs.json"]) {
-      if (existsSync20(path27.join(setDir, cfg.rep, f))) relPaths.push(`${cfg.rep}/${f}`);
+      if (existsSync22(path28.join(setDir, cfg.rep, f))) relPaths.push(`${cfg.rep}/${f}`);
     }
-    if (existsSync20(path27.join(setDir, cfg.rep))) {
-      for (const asset of readdirSync5(path27.join(setDir, cfg.rep)).filter((f) => f.startsWith("asset-"))) {
+    if (existsSync22(path28.join(setDir, cfg.rep))) {
+      for (const asset of readdirSync6(path28.join(setDir, cfg.rep)).filter((f) => f.startsWith("asset-"))) {
         relPaths.push(`${cfg.rep}/${asset}`);
       }
     }
   }
   return hashRecordingSet(
     relPaths,
-    (p) => new Uint8Array(readFileSync18(path27.join(setDir, p))),
+    (p) => new Uint8Array(readFileSync19(path28.join(setDir, p))),
     (chunks) => {
-      const h = createHash2("sha256");
+      const h = createHash3("sha256");
       for (const c of chunks) h.update(c);
       return h.digest("hex");
     }
@@ -7595,8 +7760,8 @@ function emitBundleV1(opts) {
   const lattice = countLatticeSymbols(opts.task.set);
   const interaction = opts.behaviors.filter((b) => !b.id.startsWith("prelude:"));
   const prelude = opts.behaviors.filter((b) => b.id.startsWith("prelude:"));
-  const cssFiles = ["styles.css", "tokens.css"].map((f) => path27.join(opts.bundleDir, f)).filter((f) => existsSync20(f));
-  const families = cssFontFamilies(cssFiles.map((f) => readFileSync18(f, "utf8")).join("\n"));
+  const cssFiles = ["styles.css", "tokens.css"].map((f) => path28.join(opts.bundleDir, f)).filter((f) => existsSync22(f));
+  const families = cssFontFamilies(cssFiles.map((f) => readFileSync19(f, "utf8")).join("\n"));
   const requiredFonts = requiredFontsManifest(families, opts.fontCacheDir).map((f) => ({
     family: f.family,
     weight: f.weight,
@@ -7625,7 +7790,7 @@ function emitBundleV1(opts) {
         // resolvable via verify's --set override).
         path: (() => {
           const base = process.env["INIT_CWD"] ?? process.cwd();
-          const rel = path27.relative(base, opts.task.set);
+          const rel = path28.relative(base, opts.task.set);
           return rel !== "" && !rel.startsWith("..") ? rel : opts.task.set;
         })(),
         component: opts.componentName,
@@ -7649,14 +7814,14 @@ function emitBundleV1(opts) {
     })
   };
   const written = [];
-  const manifestPath2 = path27.join(opts.bundleDir, "component.json");
+  const manifestPath2 = path28.join(opts.bundleDir, "component.json");
   writeFileSync10(manifestPath2, `${JSON.stringify(manifest, null, 2)}
 `);
   written.push(manifestPath2);
-  const stylesPath = path27.join(opts.bundleDir, "styles.css");
-  if (existsSync20(stylesPath)) {
+  const stylesPath = path28.join(opts.bundleDir, "styles.css");
+  if (existsSync22(stylesPath)) {
     const comment = cssProvenanceComment({ pass, scored: statuses.length, certified, latticeConfigs: lattice });
-    const current = readFileSync18(stylesPath, "utf8");
+    const current = readFileSync19(stylesPath, "utf8");
     const stripped = current.replace(/^\/\* tendril bundle v\d+ [^]*?\*\/\n/, "");
     writeFileSync10(stylesPath, `${comment}
 ${stripped}`);
@@ -7705,8 +7870,8 @@ __export(fonts_exports, {
   runFontsResolveSet: () => runFontsResolveSet,
   runFontsStatus: () => runFontsStatus
 });
-import { existsSync as existsSync21, readFileSync as readFileSync19 } from "node:fs";
-import path28 from "node:path";
+import { existsSync as existsSync23, readFileSync as readFileSync20 } from "node:fs";
+import path29 from "node:path";
 async function runFontsResolve(opts) {
   const result = await resolveFonts(opts.family, opts.weights, opts.cacheDir);
   emitData(opts, result, () => {
@@ -7717,11 +7882,11 @@ async function runFontsResolve(opts) {
   });
   if (result.failures.length > 0) {
     warn(opts, `${result.failures.length} face(s) unresolved \u2014 verification will refuse to score under substitution`);
-    process.exit(ExitCode.FontsUnproven);
+    process.exitCode = ExitCode.FontsUnproven;
   }
 }
 async function runFontsResolveSet(opts) {
-  const setDir = path28.resolve(process.env["INIT_CWD"] ?? process.cwd(), opts.set);
+  const setDir = path29.resolve(process.env["INIT_CWD"] ?? process.cwd(), opts.set);
   let needs = [];
   try {
     needs = recordedFontNeeds(setDir);
@@ -7766,20 +7931,20 @@ async function runFontsResolveSet(opts) {
   });
   if (failures.length > 0) {
     warn(opts, `${failures.length} face(s) unresolved \u2014 verification will refuse to score under substitution`);
-    process.exit(ExitCode.FontsUnproven);
+    process.exitCode = ExitCode.FontsUnproven;
   }
 }
 function runFontsStatus(opts) {
-  const manifestPath2 = path28.join(opts.cacheDir, "manifest.json");
-  if (!existsSync21(manifestPath2)) {
+  const manifestPath2 = path29.join(opts.cacheDir, "manifest.json");
+  if (!existsSync23(manifestPath2)) {
     fail(opts, ExitCode.FontsUnproven, {
       error: `no font cache at ${opts.cacheDir}`,
       code: "fonts-unresolved",
       remediation: 'Run `tendril fonts resolve --set <recording-dir>` (or `tendril fonts resolve "<Family>" --weights 400 500 600`) first.'
     });
   }
-  const faces = JSON.parse(readFileSync19(manifestPath2, "utf8"));
-  const lockVerdicts = opts.lock !== void 0 ? checkFontLock(path28.resolve(opts.lock), opts.cacheDir) : null;
+  const faces = JSON.parse(readFileSync20(manifestPath2, "utf8"));
+  const lockVerdicts = opts.lock !== void 0 ? checkFontLock(path29.resolve(opts.lock), opts.cacheDir) : null;
   emitData(opts, { faces, lockVerdicts }, () => {
     for (const f of faces) process.stdout.write(`cached ${f.family} ${f.weight} (${f.sha256.slice(0, 12)}\u2026)
 `);
@@ -7828,37 +7993,6 @@ var init_fonts = __esm({
   }
 });
 
-// packages/cli/src/environment.ts
-import { existsSync as existsSync22, readFileSync as readFileSync20 } from "node:fs";
-import path29 from "node:path";
-import { createHash as createHash3 } from "node:crypto";
-function environmentStamp(taskFamilies) {
-  const manifestPath2 = path29.join(fontCacheDir(), "manifest.json");
-  let fontsHash = null;
-  if (existsSync22(manifestPath2)) {
-    try {
-      const entries = JSON.parse(readFileSync20(manifestPath2, "utf8"));
-      const scoped = taskFamilies === void 0 || taskFamilies === null ? entries : entries.filter((f) => taskFamilies.some((fam) => fam.toLowerCase() === f.family.toLowerCase()));
-      const faces = scoped.map((f) => `${f.family}:${f.weight}:${f.sha256}`).sort();
-      fontsHash = faces.length === 0 ? null : createHash3("sha256").update(faces.join("\n")).digest("hex").slice(0, 16);
-    } catch {
-      fontsHash = null;
-    }
-  }
-  let chrome = "unavailable";
-  try {
-    chrome = resolveChrome();
-  } catch {
-  }
-  return { chrome, chromeVersion: chrome === "unavailable" ? null : chromeVersion(), fontsManifestSha256: fontsHash };
-}
-var init_environment = __esm({
-  "packages/cli/src/environment.ts"() {
-    "use strict";
-    init_src4();
-  }
-});
-
 // packages/cli/src/font-guidance.ts
 function fontsUnprovenRemediation(setDir) {
   if (setDir !== void 0) {
@@ -7895,7 +8029,7 @@ __export(verify_exports, {
   interactionCoverage: () => interactionCoverage,
   runVerify: () => runVerify
 });
-import { existsSync as existsSync23, readFileSync as readFileSync21 } from "node:fs";
+import { existsSync as existsSync24, readFileSync as readFileSync21 } from "node:fs";
 import path30 from "node:path";
 function interactionCoverage(behaviors) {
   const interaction = behaviors.filter((b) => !b.id.startsWith("prelude:"));
@@ -7934,7 +8068,7 @@ async function runVerify(opts) {
   const callerCwd = process.env["INIT_CWD"] ?? process.cwd();
   const setOverride = opts.set !== void 0 ? path30.resolve(callerCwd, opts.set) : void 0;
   opts = { ...opts, bundleDir: path30.resolve(callerCwd, opts.bundleDir), ...setOverride !== void 0 ? { set: setOverride } : {} };
-  if (!existsSync23(opts.bundleDir)) {
+  if (!existsSync24(opts.bundleDir)) {
     fail(opts, ExitCode.InputValidation, {
       error: `bundle directory not found: ${opts.bundleDir}`,
       code: "bundle-missing",
@@ -7943,7 +8077,7 @@ async function runVerify(opts) {
   }
   const manifestPath2 = path30.join(opts.bundleDir, "component.json");
   let manifest;
-  if (existsSync23(manifestPath2)) {
+  if (existsSync24(manifestPath2)) {
     const { manifest: parsed, issues } = readBundleManifest(readFileSync21(manifestPath2, "utf8"));
     if (issues.length > 0) {
       fail(opts, ExitCode.InputValidation, {
@@ -7973,11 +8107,11 @@ async function runVerify(opts) {
     const resolveSetDir = (p) => {
       if (path30.isAbsolute(p)) return p;
       const fromRepo = path30.resolve(REPO_ROOT, p);
-      if (existsSync23(fromRepo)) return fromRepo;
+      if (existsSync24(fromRepo)) return fromRepo;
       return path30.resolve(callerCwd, p);
     };
     const setDir = opts.set ?? resolveSetDir(manifest.provenance.recordingSet.path);
-    if (!existsSync23(path30.join(setDir, "recording-set.json")) && !Object.values(TASKS).some((t) => path30.resolve(t.set) === path30.resolve(setDir))) {
+    if (!existsSync24(path30.join(setDir, "recording-set.json")) && !Object.values(TASKS).some((t) => path30.resolve(t.set) === path30.resolve(setDir))) {
       fail(opts, ExitCode.RecordingIncomplete, {
         error: `recording set not found or unmanifested: ${setDir}`,
         code: "recording-set-missing",
@@ -7985,7 +8119,7 @@ async function runVerify(opts) {
       });
     }
     const registry = Object.values(TASKS).find((t) => path30.resolve(t.set) === path30.resolve(setDir));
-    if (registry !== void 0 && !existsSync23(path30.join(setDir, "recording-set.json"))) {
+    if (registry !== void 0 && !existsSync24(path30.join(setDir, "recording-set.json"))) {
       const recordedSlugs = registry.configs.map((c) => c.rep);
       const adapterSlugs = Object.keys(manifest.propAdapter);
       unmapped = recordedSlugs.filter((s) => !adapterSlugs.includes(s));
@@ -8010,7 +8144,7 @@ async function runVerify(opts) {
     }
     for (const name of [manifest.entry, "styles.css", "tokens.css"]) {
       const p = path30.join(opts.bundleDir, name);
-      if (!existsSync23(p)) continue;
+      if (!existsSync24(p)) continue;
       const issues = checkBundleSourceFile(name, new Uint8Array(readFileSync21(p)));
       if (issues.length > 0) {
         fail(opts, ExitCode.InputValidation, {
@@ -8035,7 +8169,7 @@ async function runVerify(opts) {
     });
   }
   const missing = task.configs.filter(
-    (c) => !existsSync23(path30.join(task.set, c.rep, "get_screenshot.json")) || !existsSync23(path30.join(task.set, c.rep, "get_metadata.json"))
+    (c) => !existsSync24(path30.join(task.set, c.rep, "get_screenshot.json")) || !existsSync24(path30.join(task.set, c.rep, "get_metadata.json"))
   );
   if (missing.length > 0) {
     fail(opts, ExitCode.RecordingIncomplete, {
@@ -8048,7 +8182,7 @@ async function runVerify(opts) {
   const evidenceDir = path30.join(opts.bundleDir, "verify-evidence");
   const scores = await scoreBundleForTask(task, opts.bundleDir, bar, { evidenceDir, onProgress: emitProgress });
   const quality = await checkBundleQuality(opts.bundleDir, task.entry);
-  const bundleCss = ["tokens.css", "styles.css"].map((f) => path30.join(opts.bundleDir, f)).filter((f) => existsSync23(f)).map((f) => readFileSync21(f, "utf8")).join("\n");
+  const bundleCss = ["tokens.css", "styles.css"].map((f) => path30.join(opts.bundleDir, f)).filter((f) => existsSync24(f)).map((f) => readFileSync21(f, "utf8")).join("\n");
   const occlusion = await checkSiblingOcclusion(task, opts.bundleDir, bundleCss);
   const parity = await checkHoverParity(task, opts.bundleDir);
   const behaviors = [...await checkBehaviors(task, opts.bundleDir), ...parity];
@@ -8236,11 +8370,11 @@ __export(engine_exports, {
   runEngineBrief: () => runEngineBrief,
   runEngineScore: () => runEngineScore
 });
-import { existsSync as existsSync24, mkdirSync as mkdirSync6, readFileSync as readFileSync22, writeFileSync as writeFileSync11 } from "node:fs";
+import { existsSync as existsSync25, mkdirSync as mkdirSync6, readFileSync as readFileSync22, writeFileSync as writeFileSync11 } from "node:fs";
 import path31 from "node:path";
 function resolveEngineTask(opts, callerCwd) {
   const asPath = path31.resolve(callerCwd, opts.taskOrSet);
-  const isSet = existsSync24(path31.join(asPath, "recording-set.json"));
+  const isSet = existsSync25(path31.join(asPath, "recording-set.json"));
   const registry = TASKS[opts.taskOrSet];
   if (registry !== void 0 && !isSet) return { task: registry, name: opts.taskOrSet };
   if (isSet) {
@@ -8270,7 +8404,7 @@ function runEngineBrief(opts) {
   const segments = buildSegments(task, "files");
   let notRecorded;
   const manifestPath2 = path31.join(task.set, "recording-set.json");
-  if (existsSync24(manifestPath2)) {
+  if (existsSync25(manifestPath2)) {
     notRecorded = JSON.parse(readFileSync22(manifestPath2, "utf8")).notRecorded;
   }
   const unverified = notRecorded !== void 0 && notRecorded !== "" ? `
@@ -8278,7 +8412,7 @@ function runEngineBrief(opts) {
 === UNVERIFIED SURFACE (recorded-set disclosure \u2014 these poses were never recorded; nothing verifies them) ===
 ${notRecorded}` : "";
   let fontProvisioning;
-  if (existsSync24(manifestPath2)) {
+  if (existsSync25(manifestPath2)) {
     const provided = resolvedFontFamilies().map((f) => f.family);
     const unprovided = recordedFontFamilies(task.set).filter((r) => !provided.some((p) => p.toLowerCase() === r.toLowerCase()));
     if (unprovided.length > 0) {
@@ -8347,7 +8481,7 @@ async function runEngineScore(opts) {
   const callerCwd = process.env["INIT_CWD"] ?? process.cwd();
   const candidateDir = path31.resolve(callerCwd, opts.candidateDir);
   const { task, name, apiPin } = resolveEngineTask(opts, callerCwd);
-  if (!existsSync24(candidateDir)) {
+  if (!existsSync25(candidateDir)) {
     fail(opts, ExitCode.InputValidation, {
       error: `candidate directory not found: ${candidateDir}`,
       code: "candidate-missing",
@@ -8469,7 +8603,7 @@ __export(generate_recorded_exports, {
   runGenerateRecorded: () => runGenerateRecorded
 });
 import { confirm as confirm3, isCancel as isCancel3 } from "@clack/prompts";
-import { existsSync as existsSync25 } from "node:fs";
+import { existsSync as existsSync26 } from "node:fs";
 import path32 from "node:path";
 async function runGenerateRecorded(opts) {
   const callerCwd = process.env["INIT_CWD"] ?? process.cwd();
@@ -8479,7 +8613,7 @@ async function runGenerateRecorded(opts) {
   let taskName;
   let authoredApi;
   let composition;
-  const isSet = existsSync25(path32.join(recordedAsPath, "recording-set.json"));
+  const isSet = existsSync26(path32.join(recordedAsPath, "recording-set.json"));
   const registry = TASKS[opts.recorded];
   if (registry !== void 0 && !isSet) {
     task = registry;
@@ -8515,7 +8649,7 @@ async function runGenerateRecorded(opts) {
     });
   }
   const missing = task.configs.filter(
-    (c) => !existsSync25(path32.join(task.set, c.rep, "get_screenshot.json")) || !existsSync25(path32.join(task.set, c.rep, "get_metadata.json")) || !existsSync25(path32.join(task.set, c.rep, "get_design_context.json"))
+    (c) => !existsSync26(path32.join(task.set, c.rep, "get_screenshot.json")) || !existsSync26(path32.join(task.set, c.rep, "get_metadata.json")) || !existsSync26(path32.join(task.set, c.rep, "get_design_context.json"))
   );
   if (missing.length > 0) {
     fail(opts, ExitCode.RecordingIncomplete, {
@@ -8728,13 +8862,14 @@ import { CommanderError } from "commander";
 
 // packages/cli/src/program.ts
 init_src3();
+init_environment();
 import { Command } from "commander";
 
 // packages/cli/src/commands/doctor.ts
 init_src4();
 init_src();
-import { existsSync as existsSync14, readFileSync as readFileSync12 } from "node:fs";
-import path20 from "node:path";
+import { existsSync as existsSync16, readFileSync as readFileSync13 } from "node:fs";
+import path21 from "node:path";
 
 // packages/cli/src/describe.ts
 var COMMON_EXIT_CODES = {
@@ -8751,6 +8886,7 @@ function printDescription(description) {
 
 // packages/cli/src/commands/doctor.ts
 init_env();
+init_environment();
 init_output();
 var DEFAULT_MCP_URL = "http://127.0.0.1:3845/mcp";
 var DOCTOR_DESCRIPTION = {
@@ -8811,9 +8947,9 @@ async function runDoctorChecks(options) {
       remediation: "Install Google Chrome (or Chromium), or set CHROME_PATH to a Chromium-family browser binary."
     });
   }
-  const fontManifest = path20.join(fontCacheDir(), "manifest.json");
+  const fontManifest = path21.join(fontCacheDir(), "manifest.json");
   checks.push(
-    existsSync14(fontManifest) ? { name: "font-cache", ok: true, detail: `resolved font cache at ${fontCacheDir()} (${JSON.parse(readFileSync12(fontManifest, "utf8")).length} faces)` } : {
+    existsSync16(fontManifest) ? { name: "font-cache", ok: true, detail: `resolved font cache at ${fontCacheDir()} (${JSON.parse(readFileSync13(fontManifest, "utf8")).length} faces)` } : {
       name: "font-cache",
       ok: true,
       detail: `font cache empty at ${fontCacheDir()} \u2014 normal on a fresh machine; faces resolve per design system at first use`,
@@ -8834,7 +8970,9 @@ async function runDoctor(flags) {
     return;
   }
   const report = await runDoctorChecks({ ...flags.mcpUrl ? { mcpUrl: flags.mcpUrl } : {} });
-  emitData(flags, report, () => {
+  emitData(flags, { version: cliVersion(), ...report }, () => {
+    process.stdout.write(`tendril ${cliVersion()}
+`);
     for (const check of report.checks) {
       process.stdout.write(`${check.ok ? "\u2713" : "\u2717"} ${check.name}: ${check.detail}
 `);
@@ -8850,7 +8988,7 @@ async function runDoctor(flags) {
 init_src3();
 import { intro, isCancel, outro, password } from "@clack/prompts";
 import fs from "node:fs";
-import path21 from "node:path";
+import path22 from "node:path";
 init_env();
 init_output();
 var INIT_DESCRIPTION = {
@@ -8889,7 +9027,7 @@ async function runInit(flags) {
     printDescription(INIT_DESCRIPTION);
     return;
   }
-  const envPath = path21.resolve(process.cwd(), ".env");
+  const envPath = path22.resolve(process.cwd(), ".env");
   const existing = fs.existsSync(envPath) ? parseEnv(fs.readFileSync(envPath, "utf8")) : /* @__PURE__ */ new Map();
   let figmaToken = flags.figmaToken ?? existing.get(ENV_KEYS.figma);
   let openrouterKey = flags.openrouterKey ?? existing.get(ENV_KEYS.openrouter);
@@ -8910,7 +9048,7 @@ async function runInit(flags) {
   next.set(ENV_KEYS.figma, figmaToken);
   next.set(ENV_KEYS.openrouter, openrouterKey);
   const changed = existing.get(ENV_KEYS.figma) !== next.get(ENV_KEYS.figma) || existing.get(ENV_KEYS.openrouter) !== next.get(ENV_KEYS.openrouter);
-  const gitignorePath = path21.resolve(process.cwd(), ".gitignore");
+  const gitignorePath = path22.resolve(process.cwd(), ".gitignore");
   const gitignore = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, "utf8") : "";
   const gitignoreCoversEnv = gitignore.split("\n").some((line) => [".env", ".env", ".env*"].includes(line.trim()));
   if (flags.dryRun) {
@@ -8961,7 +9099,7 @@ init_src();
 init_src5();
 init_src2();
 import { confirm as confirm2, isCancel as isCancel2 } from "@clack/prompts";
-import { readFileSync as readFileSync13, readdirSync as readdirSync3, existsSync as existsSync15 } from "node:fs";
+import { readFileSync as readFileSync14, readdirSync as readdirSync3, existsSync as existsSync17 } from "node:fs";
 init_env();
 init_output();
 
@@ -8970,7 +9108,7 @@ init_src2();
 init_src4();
 init_src6();
 import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync7 } from "node:fs";
-import path22 from "node:path";
+import path23 from "node:path";
 
 // packages/cli/src/assets-module.ts
 init_src();
@@ -9306,7 +9444,7 @@ async function runGenerationPipeline(input) {
   });
   const written = [];
   if (!input.dryRun) {
-    const dir = path22.resolve(input.outDir, semantics.componentName);
+    const dir = path23.resolve(input.outDir, semantics.componentName);
     mkdirSync4(dir, { recursive: true });
     const files = {
       // Bundle-local tokens: THE emission the component's CSS resolves
@@ -9330,13 +9468,13 @@ async function runGenerationPipeline(input) {
 `
     };
     for (const [name, content] of Object.entries(files)) {
-      const filePath = path22.join(dir, name);
+      const filePath = path23.join(dir, name);
       writeFileSync7(filePath, content);
       written.push(filePath);
     }
     for (const artifact of emitTokenArtifacts(input.mapping)) {
-      const filePath = path22.resolve(input.outDir, artifact.path);
-      mkdirSync4(path22.dirname(filePath), { recursive: true });
+      const filePath = path23.resolve(input.outDir, artifact.path);
+      mkdirSync4(path23.dirname(filePath), { recursive: true });
       writeFileSync7(filePath, artifact.content);
       written.push(filePath);
     }
@@ -9395,7 +9533,7 @@ var GENERATE_DESCRIPTION = {
 function resolveProvidedSource(flags, contextFile) {
   let raw;
   try {
-    raw = readFileSync13(contextFile, "utf8");
+    raw = readFileSync14(contextFile, "utf8");
   } catch {
     fail(flags, ExitCode.InputValidation, {
       error: `Cannot read context file "${contextFile}".`,
@@ -9514,11 +9652,11 @@ token mapping (${mapping.flat.length} variables):
   let initialCode;
   let initialSemantics;
   try {
-    if (existsSync15(flags.out)) {
+    if (existsSync17(flags.out)) {
       for (const entry of readdirSync3(flags.out)) {
         const cjPath = `${flags.out}/${entry}/component.json`;
-        if (!existsSync15(cjPath)) continue;
-        const cj = JSON.parse(readFileSync13(cjPath, "utf8"));
+        if (!existsSync17(cjPath)) continue;
+        const cj = JSON.parse(readFileSync14(cjPath, "utf8"));
         if (cj.name !== void 0 && Array.isArray(cj.props)) {
           previousApi = JSON.stringify({
             componentName: cj.name,
@@ -9526,14 +9664,14 @@ token mapping (${mapping.flat.length} variables):
           });
           const tsxPath = `${flags.out}/${entry}/${cj.name}.tsx`;
           const cssPath = `${flags.out}/${entry}/${cj.name}.css`;
-          if (flags.refine && existsSync15(tsxPath) && existsSync15(cssPath)) {
+          if (flags.refine && existsSync17(tsxPath) && existsSync17(cssPath)) {
             initialCode = {
-              tsx: readFileSync13(tsxPath, "utf8"),
-              css: readFileSync13(cssPath, "utf8")
+              tsx: readFileSync14(tsxPath, "utf8"),
+              css: readFileSync14(cssPath, "utf8")
             };
             const semPath = `${flags.out}/${entry}/semantics.json`;
-            if (existsSync15(semPath)) {
-              initialSemantics = JSON.parse(readFileSync13(semPath, "utf8"));
+            if (existsSync17(semPath)) {
+              initialSemantics = JSON.parse(readFileSync14(semPath, "utf8"));
             }
           }
           break;
@@ -9687,7 +9825,7 @@ function buildProgram() {
   const program = new Command();
   program.name("tendril").description(
     "Figma design systems \u2192 agent-safe, verified front-end code.\nEvery command supports --json (data on stdout, JSON errors on stderr)\nand --describe (machine-readable schema)."
-  ).version("0.0.0").option("--json", "machine-readable output", false).option("--yes", "assume yes; never prompt", false).option("--dry-run", "describe mutations without performing them", false).option("--describe", "print the command's schema as JSON and exit", false).option("--verbosity <level>", "concise | detailed", "concise").exitOverride();
+  ).version(cliVersion()).option("--json", "machine-readable output", false).option("--yes", "assume yes; never prompt", false).option("--dry-run", "describe mutations without performing them", false).option("--describe", "print the command's schema as JSON and exit", false).option("--verbosity <level>", "concise | detailed", "concise").exitOverride();
   program.command("init").description("Configure Figma + OpenRouter credentials in .env (idempotent).").option("--figma-token <token>", "Figma personal access token").option("--openrouter-key <key>", "OpenRouter API key").action(async (_opts, cmd) => {
     const flags = globalFlags(cmd);
     const local = cmd.opts();
@@ -9721,11 +9859,11 @@ function buildProgram() {
     const { runRecordNext: runRecordNext2 } = await Promise.resolve().then(() => (init_record(), record_exports));
     runRecordNext2({ ...flags, setDir: cmd.opts()["set"] });
   });
-  record.command("ingest").requiredOption("--set <dir>", "recording set directory").requiredOption("--rep <slug>", "planned rep slug").requiredOption("--tool <tool>", "get_design_context | get_metadata | get_screenshot | get_variable_defs").requiredOption("--file <file>", "verbatim envelope JSON").action(async (_o, cmd) => {
+  record.command("ingest").requiredOption("--set <dir>", "recording set directory").requiredOption("--rep <slug>", "planned rep slug").requiredOption("--tool <tool>", "get_design_context | get_metadata | get_screenshot | get_variable_defs").requiredOption("--file <file>", "verbatim envelope JSON (or raw response text with --raw)").option("--raw", "the file holds the tool response TEXT verbatim; the CLI builds the envelope").action(async (_o, cmd) => {
     const flags = globalFlags(cmd.parent.parent);
     const local = cmd.opts();
     const { runRecordIngest: runRecordIngest2 } = await Promise.resolve().then(() => (init_record(), record_exports));
-    runRecordIngest2({ ...flags, setDir: local["set"], rep: local["rep"], tool: local["tool"], file: local["file"] });
+    await runRecordIngest2({ ...flags, setDir: local["set"], rep: local["rep"], tool: local["tool"], file: local["file"], raw: local["raw"] });
   });
   record.command("fetch").description("Download a Figma asset URL straight to disk and ingest it \u2014 no shell, no model in the byte path.").requiredOption("--set <dir>", "recording set directory").requiredOption("--rep <slug>", "planned rep slug").requiredOption("--tool <tool>", "get_screenshot").requiredOption("--url <url>", "image_url from the Figma tool response, verbatim").action(async (_o, cmd) => {
     const flags = globalFlags(cmd.parent.parent);
@@ -9733,11 +9871,11 @@ function buildProgram() {
     const { runRecordFetch: runRecordFetch2 } = await Promise.resolve().then(() => (init_record(), record_exports));
     await runRecordFetch2({ ...flags, setDir: local["set"], rep: local["rep"], tool: local["tool"], url: local["url"] });
   });
-  record.command("asset").requiredOption("--set <dir>", "recording set directory").requiredOption("--rep <slug>", "planned rep slug").requiredOption("--name <name>", "asset-<id>.<ext>").requiredOption("--file <file>", "downloaded asset file").action(async (_o, cmd) => {
+  record.command("asset").requiredOption("--set <dir>", "recording set directory").requiredOption("--rep <slug>", "planned rep slug").option("--name <name>", "asset-<id>.<ext> (single-asset mode)").option("--file <file>", "downloaded asset file (single-asset mode)").option("--dir <dir>", "batch mode: ingest every asset-*.<ext> in this directory").action(async (_o, cmd) => {
     const flags = globalFlags(cmd.parent.parent);
     const local = cmd.opts();
     const { runRecordAsset: runRecordAsset2 } = await Promise.resolve().then(() => (init_record(), record_exports));
-    runRecordAsset2({ ...flags, setDir: local["set"], rep: local["rep"], name: local["name"], file: local["file"] });
+    runRecordAsset2({ ...flags, setDir: local["set"], rep: local["rep"], name: local["name"], file: local["file"], dir: local["dir"] });
   });
   record.command("finish").requiredOption("--set <dir>", "recording set directory").option("--confirm-roles", "HUMAN-ONLY: accept the derived role proposal", false).option("--roles-file <file>", "override roles with a reviewed JSON graph").action(async (_o, cmd) => {
     const flags = globalFlags(cmd.parent.parent);