@tendrilapp/cli 0.1.4 → 0.1.6

package/dist/tendril.js

@@ -1008,6 +1008,21 @@ function ingestEnvelope(setDir, slug, tool, payload) {
 `);
   return { overwrote };
 }
+function envelopeTextContent(env) {
+  const parts = env?.content ?? [];
+  return parts.map((c) => c.text ?? "").filter((t) => t !== "").join("\n");
+}
+function envelopeFirstTextPart(env) {
+  const parts = env?.content ?? [];
+  return parts.find((c) => typeof c.text === "string" && c.text !== "")?.text ?? "";
+}
+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 +1804,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 +1814,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 +1995,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 +3105,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 +3113,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 +3166,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 +3175,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 +3188,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 +3197,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 +3206,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 +3224,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 +3237,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 +3287,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 +3296,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 +3519,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 +3530,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 +3743,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 +3817,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 +3960,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 +3973,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 +4042,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 +4106,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 +4120,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";
@@ -4275,13 +4317,13 @@ var init_prelude = __esm({
 - Component root: -webkit-font-smoothing: antialiased and -moz-osx-font-smoothing: grayscale (recorded rasterization); font-synthesis: none (a missing font weight must fall back visibly, never fake-bold); color-scheme MATCHING YOUR RECORDING (light for a light capture, dark for a dark one) and direction: ltr \u2014 pin them, so the render cannot follow the viewer OS preference and drift from the capture it is graded against; isolation: isolate (own stacking context; overlay z-indexes never fight the host).
 - Interactive controls (buttons, options): touch-action: manipulation and user-select: none. Text inputs stay selectable (never user-select: none on them).
 - Scrollable popovers/menus: overscroll-behavior: contain.
-- Focus rings on :focus-visible, never bare :focus (keyboard shows the ring; mouse click must not leave one).
+- Focus indicators bind to :focus-visible, never bare :focus. If the recording contains a focus pose, style the indicator from that recorded truth. If NO focus pose is recorded, do NOT invent ring colors/widths/offsets \u2014 an invented ring is unrecorded pixels; keep the browser's default focus indicator (leave outline in place on :focus-visible) and state the gap in your report. Text inputs match :focus-visible even on mouse click BY SPEC \u2014 that is platform-correct accessibility, never a bug to suppress with JS modality tracking.
 - Every animation wrapped in @media (prefers-reduced-motion: no-preference) or disabled under reduce.`;
   }
 });
 
 // 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 +4353,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 +4433,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 +4443,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 +4507,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 +4524,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 +4629,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 +4719,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 +4904,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 +4957,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 +6214,8 @@ var record_exports = {};
 __export(record_exports, {
   instanceLeads: () => instanceLeads,
   isFigmaAssetUrl: () => isFigmaAssetUrl,
+  isLocalAssetUrl: () => isLocalAssetUrl,
+  nextPayload: () => nextPayload,
   runRecordAsset: () => runRecordAsset,
   runRecordFetch: () => runRecordFetch,
   runRecordFinish: () => runRecordFinish,
@@ -6141,11 +6224,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 +6272,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 +6304,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 +6379,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 +6415,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 +6448,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 +6466,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 +6478,53 @@ 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"));
+    if (opts.rawParts === true) {
+      const parts = JSON.parse(readFileSync15(path24.resolve(opts.file), "utf8"));
+      if (!Array.isArray(parts) || parts.length === 0 || parts.some((p) => typeof p !== "string")) throw new Error("--raw-parts file must be a non-empty JSON array of strings");
+      payload = { content: parts.map((text) => ({ type: "text", text })) };
+    } else {
+      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.rawParts === 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 +6536,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 +6565,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 +6630,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 +6657,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 +6669,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 +6860,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 +6892,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 +6903,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 +6918,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 +6938,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 +6996,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 +7023,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 +7093,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 +7290,7 @@ function authorBehaviors(api) {
   return { behaviors, prelude: { controls: interactive ? ["> *"] : [], textInputs: [] }, disclosures };
 }
 function envelopeText(file) {
-  return JSON.parse(readFileSync16(file, "utf8")).content[0]?.text ?? "";
+  return envelopeFirstTextPart(JSON.parse(readFileSync17(file, "utf8")));
 }
 function recordedFontNeeds(setDir) {
   const byFamily = /* @__PURE__ */ new Map();
@@ -7146,13 +7325,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 +7350,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 +7365,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 +7478,11 @@ 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 ?? "";
+  const env = JSON.parse(readFileSync18(path27.join(set, rep, `${tool}.json`), "utf8"));
+  return tool === "get_design_context" ? envelopeFirstTextPart(env) : envelopeTextContent(env);
 }
 function stripFigmaInstructions(emission) {
   const STYLE_FACTS = "These styles are contained in the design:";
@@ -7362,17 +7542,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 = envelopeFirstTextPart(JSON.parse(readFileSync18(path27.join(SET, "get_variable_defs.json"), "utf8"))) || "{}";
     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 = envelopeFirstTextPart(JSON.parse(readFileSync18(f, "utf8"))) || "{}";
       try {
         for (const [k, v] of Object.entries(JSON.parse(text))) rawDefs[k] ??= v;
       } catch {
@@ -7380,8 +7560,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) ? envelopeFirstTextPart(JSON.parse(readFileSync18(f, "utf8"))) : "";
   });
   const { map, note } = cleanTokenMap(rawDefs, emissionTexts);
   const defs = JSON.stringify(map, null, 1);
@@ -7396,9 +7576,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)}
@@ -7431,6 +7611,7 @@ var cssIdent;
 var init_segments = __esm({
   "packages/generate/src/segments.ts"() {
     "use strict";
+    init_src();
     cssIdent = (name) => name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
   }
 });
@@ -7489,9 +7670,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 +7721,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 = envelopeTextContent(JSON.parse(readFileSync19(f, "utf8")));
     count += [...text.matchAll(/name="([^"]*)"/g)].filter((m) => m[1].includes("=")).length;
   }
   return count > 0 ? count : null;
@@ -7563,23 +7744,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 +7776,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 +7806,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 +7830,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}`);
@@ -7671,6 +7852,7 @@ var init_bundle_emit = __esm({
   "packages/generate/src/bundle-emit.ts"() {
     "use strict";
     init_src6();
+    init_src();
     init_src4();
     BARS = {
       pass: { sim: 0.95, ink: 0.95 },
@@ -7705,8 +7887,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 +7899,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 +7948,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 +8010,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 +8046,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 +8085,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 +8094,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 +8124,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 +8136,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 +8161,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 +8186,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 +8199,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 +8387,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 +8421,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 +8429,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) {
@@ -8315,7 +8466,7 @@ ${segments}`;
       ...notRecorded !== void 0 && notRecorded !== "" ? { notRecorded } : {},
       ...fontProvisioning !== void 0 ? { fontProvisioning } : {},
       modelSelection: {
-        instruction: "The model declaration is MECHANICAL: `engine score` refuses to run without --model. When a user is present, ask BEFORE reading the payload, using the template below verbatim where your host renders option dialogs. The audience is non-technical: plain cost/quality language, no model knowledge assumed. In a non-interactive session pick the balanced tier, state the reason in your report, and declare it \u2014 a silent default is not possible.",
+        instruction: "The model declaration is MECHANICAL: `engine score` refuses to run without --model. ONLY ask when the answer can take effect \u2014 i.e. you can delegate implementation to an agent running the chosen model; if you cannot delegate in this session, skip the question, build as yourself, and declare your own model honestly (a question whose answer changes nothing wastes the user's trust \u2014 measured, second Windows run). When you do ask: BEFORE reading the payload, using the template below verbatim where your host renders option dialogs. The audience is non-technical: plain cost/quality language, no model knowledge assumed. In a non-interactive session pick the balanced tier, state the reason in your report, and declare it \u2014 a silent default is not possible.",
         questionTemplate: {
           prompt: "Which model should build this component? Every choice is scored by the same independent measurement \u2014 a cheaper model may need more attempts, but it can never ship a lower-quality certified result.",
           options: [
@@ -8347,7 +8498,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 +8620,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 +8630,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 +8666,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 +8879,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 +8903,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 +8964,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 +8987,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 +9005,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 +9044,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 +9065,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 +9116,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 +9125,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 +9461,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 +9485,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 +9550,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 +9669,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 +9681,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 +9842,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 +9876,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").option("--raw-parts", "the file holds a JSON array of response block texts (multi-block transport); each becomes a content part verbatim").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"], rawParts: local["rawParts"] });
   });
   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 +9888,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);