@tendrilapp/cli 0.1.23 → 0.1.25

package/dist/tendril.js

@@ -14,11 +14,11 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/core/src/ir.ts
+// packages/core/src/ir.ts
 import { z } from "zod";
 var IrLayoutSchema, IrMotionSchema, IrPositionSchema, IrNodeSchema, ComponentIrSchema;
 var init_ir = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/core/src/ir.ts"() {
+  "packages/core/src/ir.ts"() {
     "use strict";
     IrLayoutSchema = z.object({
       mode: z.enum(["flex-row", "flex-column", "grid", "none"]),
@@ -110,14 +110,14 @@ var init_ir = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/source.ts
+// packages/figma/src/source.ts
 var init_source = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/source.ts"() {
+  "packages/figma/src/source.ts"() {
     "use strict";
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/svg-safety.ts
+// packages/figma/src/svg-safety.ts
 function checkSvgSafety(source) {
   const issues = [];
   if (!/<\s*svg\b/i.test(source)) issues.push("not an <svg> document");
@@ -132,7 +132,7 @@ function assetExportName(key) {
 }
 var UNSAFE_PATTERNS;
 var init_svg_safety = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/svg-safety.ts"() {
+  "packages/figma/src/svg-safety.ts"() {
     "use strict";
     UNSAFE_PATTERNS = [
       [/<\s*script\b/i, "script element"],
@@ -146,11 +146,11 @@ var init_svg_safety = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/provided.ts
+// packages/figma/src/provided.ts
 import { z as z2 } from "zod";
 var ProvidedVariableSchema, RangeSchema, PinnedPlacementSchema, VariantValueFactsSchema, ProvidedMetadataSchema, ProvidedContextSchema, ProvidedContextSource;
 var init_provided = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/provided.ts"() {
+  "packages/figma/src/provided.ts"() {
     "use strict";
     init_svg_safety();
     ProvidedVariableSchema = z2.object({
@@ -269,7 +269,7 @@ var init_provided = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/mcp/client.ts
+// packages/figma/src/mcp/client.ts
 function parseMessages(body, contentType) {
   if (body.trim() === "") return [];
   if (!contentType.includes("text/event-stream")) {
@@ -285,7 +285,7 @@ function parseMessages(body, contentType) {
 }
 var PROTOCOL_VERSION, McpUnavailableError, McpProtocolError, McpHttpClient;
 var init_client = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/mcp/client.ts"() {
+  "packages/figma/src/mcp/client.ts"() {
     "use strict";
     PROTOCOL_VERSION = "2025-06-18";
     McpUnavailableError = class extends Error {
@@ -389,7 +389,7 @@ var init_client = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/mcp/normalize.ts
+// packages/figma/src/mcp/normalize.ts
 function decodeXmlEntities(v) {
   return v.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&amp;/g, "&");
 }
@@ -472,7 +472,7 @@ function mergeVariantAxes(childNames) {
 }
 var TAG_TO_TYPE, TAG_RE, ATTR_RE;
 var init_normalize = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/mcp/normalize.ts"() {
+  "packages/figma/src/mcp/normalize.ts"() {
     "use strict";
     init_svg_safety();
     TAG_TO_TYPE = {
@@ -488,10 +488,10 @@ var init_normalize = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/mock/fixtures/button.ts
+// packages/figma/src/mock/fixtures/button.ts
 var buttonVariables, buttonMetadata, buttonNodeTree;
 var init_button = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/mock/fixtures/button.ts"() {
+  "packages/figma/src/mock/fixtures/button.ts"() {
     "use strict";
     buttonVariables = [
       {
@@ -600,10 +600,10 @@ var init_button = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/mock/mock-source.ts
+// packages/figma/src/mock/mock-source.ts
 var MockFigmaSource;
 var init_mock_source = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/mock/mock-source.ts"() {
+  "packages/figma/src/mock/mock-source.ts"() {
     "use strict";
     init_button();
     MockFigmaSource = class {
@@ -640,7 +640,7 @@ var init_mock_source = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/css-ident.ts
+// packages/figma/src/css-ident.ts
 function canonicalCssIdentPart(part) {
   return part.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
@@ -649,27 +649,27 @@ function variableNameToCssVar(name) {
   return `--${parts.join("-")}`;
 }
 var init_css_ident = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/css-ident.ts"() {
+  "packages/figma/src/css-ident.ts"() {
     "use strict";
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/mcp/var-decoder.ts
+// packages/figma/src/mcp/var-decoder.ts
 var init_var_decoder = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/mcp/var-decoder.ts"() {
+  "packages/figma/src/mcp/var-decoder.ts"() {
     "use strict";
     init_css_ident();
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/mcp/font-normalize.ts
+// packages/figma/src/mcp/font-normalize.ts
 var init_font_normalize = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/mcp/font-normalize.ts"() {
+  "packages/figma/src/mcp/font-normalize.ts"() {
     "use strict";
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/provided-recording.ts
+// packages/figma/src/provided-recording.ts
 import { z as z3 } from "zod";
 function checkPngPayload(base64) {
   let raw;
@@ -684,7 +684,7 @@ function checkPngPayload(base64) {
 }
 var MAX_EMISSION_BYTES, MAX_IMAGE_BYTES, MAX_ASSET_BYTES, PNG_MAGIC, TextEnvelopeSchema, ImageEnvelopeSchema, ProvidedRepSchema, ManifestWireSchema, ProvidedRecordingSetSchema;
 var init_provided_recording = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/provided-recording.ts"() {
+  "packages/figma/src/provided-recording.ts"() {
     "use strict";
     init_svg_safety();
     MAX_EMISSION_BYTES = 2 * 1024 * 1024;
@@ -752,7 +752,7 @@ var init_provided_recording = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/recording/axis-defaults.ts
+// packages/figma/src/recording/axis-defaults.ts
 function resolveAxisDefaultWithRule(domain, recorded, override) {
   if (override !== void 0) return { value: override, rule: "override" };
   const literal = domain.find((v) => kebab(v) === "default" || kebab(v) === "enabled");
@@ -787,7 +787,7 @@ function resolveAxisDefault(domain, recorded, override) {
 }
 var INTERACTION_STATES, BOOLEAN_STATES, ENGAGED_STATES, INTERACTION_EVIDENCE_VALUES, kebab, OFF_VALUES, ON_VALUES;
 var init_axis_defaults = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/recording/axis-defaults.ts"() {
+  "packages/figma/src/recording/axis-defaults.ts"() {
     "use strict";
     INTERACTION_STATES = /* @__PURE__ */ new Set(["hover", "focus", "focus-visible", "active", "pressed"]);
     BOOLEAN_STATES = /* @__PURE__ */ new Set(["disabled", "loading"]);
@@ -810,7 +810,7 @@ var init_axis_defaults = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/recording/plan.ts
+// packages/figma/src/recording/plan.ts
 function singleAxes(name) {
   const parsed = parseVariantAxes(name);
   if (parsed === void 0) return void 0;
@@ -920,7 +920,7 @@ function planQueue(symbols, opts = {}) {
 }
 var kebab2;
 var init_plan = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/recording/plan.ts"() {
+  "packages/figma/src/recording/plan.ts"() {
     "use strict";
     init_normalize();
     init_axis_defaults();
@@ -928,7 +928,75 @@ var init_plan = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/recording/session.ts
+// packages/figma/src/recording/envelope-content.ts
+function envelopeParts(payload) {
+  const content = payload?.content;
+  if (!Array.isArray(content)) return null;
+  const blocks = content;
+  const text = blocks.map((b) => typeof b.text === "string" ? b.text : "").filter((t) => t !== "").join("\n");
+  const image = blocks.find((b) => b.type === "image" && typeof b.data === "string");
+  return image === void 0 ? { text } : { text, imageData: image.data };
+}
+function namedCause(text, table) {
+  return table.find((entry) => entry.pattern.test(text))?.cause;
+}
+function jsonObjectPayload(text) {
+  try {
+    const value = JSON.parse(text);
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+  } catch {
+    return null;
+  }
+}
+function checkEnvelopeContent(tool, payload) {
+  const parts = envelopeParts(payload);
+  if (parts === null) return { ok: true };
+  const { text, imageData } = parts;
+  const serviceError = namedCause(text, SERVICE_ERROR_SIGNATURES);
+  if (serviceError !== void 0) return { ok: false, reason: serviceError };
+  const reject = (expected) => {
+    const hint = namedCause(text, FAILURE_HINTS);
+    return { ok: false, reason: hint === void 0 ? expected : `${hint} \u2014 ${expected}` };
+  };
+  switch (tool) {
+    case "get_metadata":
+    case "get_metadata_interior":
+      return NODE_MARKUP.test(text) ? { ok: true } : reject('no node markup in the response (a get_metadata response contains elements like <symbol id="\u2026"> or <frame id="\u2026">)');
+    case "get_design_context":
+      return CODE_DECLARATION.test(text) || ANY_MARKUP.test(text) ? { ok: true } : reject("no code emission or markup in the response (a get_design_context response contains a component's code, or node markup when the design is too large)");
+    case "get_variable_defs":
+      return jsonObjectPayload(text) === null ? reject("the response is not a JSON object of variable definitions") : { ok: true };
+    case "get_screenshot": {
+      if (imageData === void 0) return reject("no image block in the response (a get_screenshot envelope carries base64 PNG bytes)");
+      const png = checkPngPayload(imageData);
+      return png.ok ? { ok: true } : reject(png.reason);
+    }
+  }
+}
+var NODE_MARKUP, ANY_MARKUP, CODE_DECLARATION, SERVICE_ERROR_SIGNATURES, FAILURE_HINTS;
+var init_envelope_content = __esm({
+  "packages/figma/src/recording/envelope-content.ts"() {
+    "use strict";
+    init_provided_recording();
+    NODE_MARKUP = /<[A-Za-z][\w:.-]*(?:\s[^>]*)?\sid="[^"]+"/;
+    ANY_MARKUP = /<[A-Za-z][\w:.-]*(?:\s[^>]*)?\/?>/;
+    CODE_DECLARATION = /(?:^|\n)[ \t]*(?:const|let|var|function|class|export|import|type|interface|async|@)\b/;
+    SERVICE_ERROR_SIGNATURES = [
+      { pattern: /reached the .{0,60}tool call limit/i, cause: "the Figma MCP reported that the account's tool-call limit is exhausted" },
+      { pattern: /tool call limit for your/i, cause: "the Figma MCP reported that the account's tool-call limit is exhausted" },
+      { pattern: /upgrade your (?:seat|plan)/i, cause: "the Figma MCP returned an upgrade/quota notice" }
+    ];
+    FAILURE_HINTS = [
+      { pattern: /\brate[- ]limit/i, cause: "the response looks like a rate-limit error" },
+      { pattern: /\b(?:429|too many requests)\b/i, cause: "the response looks like a rate-limit error" },
+      { pattern: /\b(?:quota|billing|subscription|seat)\b/i, cause: "the response looks like a quota/plan notice" },
+      { pattern: /\b(?:unauthorized|forbidden|not authorized|access denied|401|403)\b/i, cause: "the response looks like an authorization error" },
+      { pattern: /\b(?:error|failed|failure|timed out|timeout)\b/i, cause: "the response looks like an error message" }
+    ];
+  }
+});
+
+// packages/figma/src/recording/session.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { z as z4 } from "zod";
@@ -1036,10 +1104,14 @@ function ingestEnvelope(setDir, slug, tool, payload) {
   if (!RECORD_TOOLS.includes(tool)) {
     throw new Error(`unknown tool "${tool}" \u2014 expected one of ${RECORD_TOOLS.join(", ")}`);
   }
+  const content = checkEnvelopeContent(tool, payload);
+  if (!content.ok) {
+    throw new Error(`${slug}/${tool} was NOT recorded \u2014 ${content.reason}. ${REINGEST_GUIDANCE}`);
+  }
   const schema = tool === "get_screenshot" ? ImageEnvelopeSchema : TextEnvelopeSchema;
   const parsed = schema.safeParse(payload);
   if (!parsed.success) {
-    throw new Error(`${slug}/${tool}: envelope rejected at the boundary: ${parsed.error.issues[0]?.message ?? "invalid"}`);
+    throw new Error(`${slug}/${tool} was NOT recorded \u2014 envelope rejected at the boundary: ${parsed.error.issues[0]?.message ?? "invalid"}. ${REINGEST_GUIDANCE}`);
   }
   const file = containedPath(setDir, slug, `${tool}.json`);
   mkdirSync(path.dirname(file), { recursive: true });
@@ -1076,12 +1148,13 @@ function ingestAsset(setDir, slug, name, content) {
   mkdirSync(path.dirname(file), { recursive: true });
   writeFileSync(file, content);
 }
-var RECORD_TOOLS, INTERIOR_TOOL, REQUIRED_TOOLS, SessionManifestSchema, manifestPath, PROTOCOL_ORDER, byProtocolOrder;
+var RECORD_TOOLS, INTERIOR_TOOL, REQUIRED_TOOLS, SessionManifestSchema, manifestPath, PROTOCOL_ORDER, byProtocolOrder, REINGEST_GUIDANCE;
 var init_session = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/recording/session.ts"() {
+  "packages/figma/src/recording/session.ts"() {
     "use strict";
     init_svg_safety();
     init_provided_recording();
+    init_envelope_content();
     init_plan();
     RECORD_TOOLS = ["get_design_context", "get_metadata", "get_screenshot", "get_variable_defs", "get_metadata_interior"];
     INTERIOR_TOOL = "get_metadata_interior";
@@ -1120,10 +1193,11 @@ var init_session = __esm({
     manifestPath = (setDir) => path.join(setDir, "recording-set.json");
     PROTOCOL_ORDER = ["get_metadata", "get_design_context", "get_screenshot", "get_variable_defs", "get_metadata_interior"];
     byProtocolOrder = (tools) => [...tools].sort((a, b) => PROTOCOL_ORDER.indexOf(a) - PROTOCOL_ORDER.indexOf(b));
+    REINGEST_GUIDANCE = "Nothing was written. Recording persists per rep and resumes from disk, so re-run the same command with the real response; if the Figma MCP reported a tool-call or rate limit, wait for the quota to reset first.";
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/recording/roles.ts
+// packages/figma/src/recording/roles.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
 import path2 from "node:path";
 function emissionIdSets(emission) {
@@ -1192,16 +1266,16 @@ function deriveRoles(setDir, manifest) {
 }
 var NODE_ID_RE;
 var init_roles = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/recording/roles.ts"() {
+  "packages/figma/src/recording/roles.ts"() {
     "use strict";
     init_session();
     NODE_ID_RE = /data-node-id="([^"]+)"/g;
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/index.ts
+// packages/figma/src/index.ts
 var init_src = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/figma/src/index.ts"() {
+  "packages/figma/src/index.ts"() {
     "use strict";
     init_source();
     init_provided();
@@ -1216,16 +1290,17 @@ var init_src = __esm({
     init_axis_defaults();
     init_plan();
     init_session();
+    init_envelope_content();
     init_roles();
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/tokens/src/dtcg.ts
+// packages/tokens/src/dtcg.ts
 function variableNameToPath(name) {
   return name.split("/").map(canonicalCssIdentPart).filter((part) => part.length > 0);
 }
-function tokenPathToCssVar(path38) {
-  return `--${path38.join("-")}`;
+function tokenPathToCssVar(path40) {
+  return `--${path40.join("-")}`;
 }
 function toDtcgToken(variable, defaultMode) {
   const modes = Object.keys(variable.valuesByMode);
@@ -1269,11 +1344,11 @@ function toDtcgToken(variable, defaultMode) {
 }
 function mapVariablesToDtcg(variables, defaultMode = "light") {
   const entries = variables.map((variable) => {
-    const path38 = variableNameToPath(variable.name);
-    if (path38.length === 0) {
+    const path40 = variableNameToPath(variable.name);
+    if (path40.length === 0) {
       throw new DtcgMappingError("empty-name", `Figma variable ${variable.id} has an empty name`);
     }
-    return { variable, path: path38 };
+    return { variable, path: path40 };
   });
   const groupPrefixes = /* @__PURE__ */ new Set();
   for (const e of entries) {
@@ -1294,21 +1369,21 @@ function mapVariablesToDtcg(variables, defaultMode = "light") {
   }
   const tokens = {};
   const flat = [];
-  for (const { variable, path: path38 } of entries) {
+  for (const { variable, path: path40 } of entries) {
     const token = toDtcgToken(variable, defaultMode);
     let group = tokens;
-    for (const segment of path38.slice(0, -1)) {
+    for (const segment of path40.slice(0, -1)) {
       const existing = group[segment];
       group = existing ?? (group[segment] = {});
     }
-    const leaf = path38[path38.length - 1];
+    const leaf = path40[path40.length - 1];
     if (group[leaf] !== void 0) {
-      throw new DtcgMappingError("duplicate-path", `Duplicate token path "${path38.join(".")}" (variable ${variable.id})`);
+      throw new DtcgMappingError("duplicate-path", `Duplicate token path "${path40.join(".")}" (variable ${variable.id})`);
     }
     group[leaf] = token;
     flat.push({
-      path: path38.join("."),
-      cssVar: tokenPathToCssVar(path38),
+      path: path40.join("."),
+      cssVar: tokenPathToCssVar(path40),
       type: token.$type,
       value: token.$value
     });
@@ -1326,7 +1401,7 @@ function mapVariablesToDtcg(variables, defaultMode = "light") {
 }
 var DIMENSION_COLLECTIONS, DtcgMappingError;
 var init_dtcg = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/tokens/src/dtcg.ts"() {
+  "packages/tokens/src/dtcg.ts"() {
     "use strict";
     init_src();
     DIMENSION_COLLECTIONS = /* @__PURE__ */ new Set(["spacing", "radius", "size", "border-width"]);
@@ -1341,7 +1416,7 @@ var init_dtcg = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/tokens/src/emit.ts
+// packages/tokens/src/emit.ts
 function decomposeFontValue(raw, valueByCssVar) {
   const field = (name) => new RegExp(`${name}:\\s*("[^"]*"|[^,)]+)`).exec(raw)?.[1]?.trim();
   const resolve = (v) => {
@@ -1408,7 +1483,7 @@ export default {
 }
 var STYLE_WEIGHTS;
 var init_emit = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/tokens/src/emit.ts"() {
+  "packages/tokens/src/emit.ts"() {
     "use strict";
     init_src();
     STYLE_WEIGHTS = {
@@ -1427,7 +1502,7 @@ var init_emit = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/tokens/src/synthesize.ts
+// packages/tokens/src/synthesize.ts
 function synthesizeSpacingVariables(tree, variantFacts, existing) {
   if (existing.some((v) => v.collection === "spacing")) return [];
   const values = /* @__PURE__ */ new Set();
@@ -1466,7 +1541,7 @@ function synthesizeSpacingVariables(tree, variantFacts, existing) {
 }
 var SPACING_FIELDS;
 var init_synthesize = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/tokens/src/synthesize.ts"() {
+  "packages/tokens/src/synthesize.ts"() {
     "use strict";
     SPACING_FIELDS = [
       "paddingTop",
@@ -1478,9 +1553,9 @@ var init_synthesize = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/tokens/src/index.ts
+// packages/tokens/src/index.ts
 var init_src2 = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/tokens/src/index.ts"() {
+  "packages/tokens/src/index.ts"() {
     "use strict";
     init_dtcg();
     init_emit();
@@ -1489,7 +1564,7 @@ var init_src2 = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/core/src/ir-builder.ts
+// packages/core/src/ir-builder.ts
 function isObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -1497,9 +1572,9 @@ function boundId(value) {
   return isObject(value) && typeof value["boundVariableId"] === "string" ? value["boundVariableId"] : void 0;
 }
 function resolveBinding(ctx, id) {
-  const path38 = ctx.pathById.get(id);
-  if (path38 === void 0) ctx.unresolved.add(id);
-  return path38;
+  const path40 = ctx.pathById.get(id);
+  if (path40 === void 0) ctx.unresolved.add(id);
+  return path40;
 }
 function parseVariantProps(name) {
   if (!name.includes("=")) return void 0;
@@ -1534,8 +1609,8 @@ function walk(ctx, raw) {
       if (!isObject(paint) || paint["visible"] === false) continue;
       const id = boundId(paint);
       if (id !== void 0) {
-        const path38 = resolveBinding(ctx, id);
-        if (path38 !== void 0) tokens.add(path38);
+        const path40 = resolveBinding(ctx, id);
+        if (path40 !== void 0) tokens.add(path40);
       } else if (typeof paint["color"] === "string") {
         ctx.hardcoded.push({ node: name, property, value: paint["color"] });
       }
@@ -1543,8 +1618,8 @@ function walk(ctx, raw) {
   }
   const radiusId = boundId(raw["cornerRadius"]);
   if (radiusId !== void 0) {
-    const path38 = resolveBinding(ctx, radiusId);
-    if (path38 !== void 0) tokens.add(path38);
+    const path40 = resolveBinding(ctx, radiusId);
+    if (path40 !== void 0) tokens.add(path40);
   } else if (typeof raw["cornerRadius"] === "number" && raw["cornerRadius"] !== 0) {
     ctx.hardcoded.push({ node: name, property: "border-radius", value: `${raw["cornerRadius"]}px` });
   }
@@ -1554,10 +1629,10 @@ function walk(ctx, raw) {
     layout = { mode: layoutMode === "HORIZONTAL" ? "flex-row" : "flex-column" };
     const gapId = boundId(raw["itemSpacing"]);
     if (gapId !== void 0) {
-      const path38 = resolveBinding(ctx, gapId);
-      if (path38 !== void 0) {
-        layout.gap = path38;
-        tokens.add(path38);
+      const path40 = resolveBinding(ctx, gapId);
+      if (path40 !== void 0) {
+        layout.gap = path40;
+        tokens.add(path40);
       }
     } else if (typeof raw["itemSpacing"] === "number" && raw["itemSpacing"] !== 0) {
       ctx.hardcoded.push({ node: name, property: "gap", value: `${raw["itemSpacing"]}px` });
@@ -1566,10 +1641,10 @@ function walk(ctx, raw) {
     for (const field of PADDING_FIELDS) {
       const id = boundId(raw[field]);
       if (id !== void 0) {
-        const path38 = resolveBinding(ctx, id);
-        if (path38 !== void 0) {
-          paddingPaths.push(path38);
-          tokens.add(path38);
+        const path40 = resolveBinding(ctx, id);
+        if (path40 !== void 0) {
+          paddingPaths.push(path40);
+          tokens.add(path40);
         }
       } else if (typeof raw[field] === "number" && raw[field] !== 0) {
         ctx.hardcoded.push({ node: name, property: field, value: `${raw[field]}px` });
@@ -1674,7 +1749,7 @@ function canonicalizeFactIdents(variantFacts) {
 }
 var RAW_PAYLOAD_FLAG_BYTES, MIN_HEALTHY_RATIO, RATIO_CHECK_MIN_BYTES, PADDING_FIELDS;
 var init_ir_builder = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/core/src/ir-builder.ts"() {
+  "packages/core/src/ir-builder.ts"() {
     "use strict";
     init_src2();
     init_src2();
@@ -1685,10 +1760,10 @@ var init_ir_builder = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/core/src/exit-codes.ts
+// packages/core/src/exit-codes.ts
 var ExitCode;
 var init_exit_codes = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/core/src/exit-codes.ts"() {
+  "packages/core/src/exit-codes.ts"() {
     "use strict";
     ExitCode = {
       Success: 0,
@@ -1709,7 +1784,7 @@ var init_exit_codes = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/core/src/readiness.ts
+// packages/core/src/readiness.ts
 function collectDefaultNamedLayers(tree, found) {
   const name = tree["name"];
   const visible = tree["visible"];
@@ -1759,15 +1834,15 @@ function scoreReadiness(metadata, tree) {
 }
 var DEFAULT_LAYER_NAME;
 var init_readiness = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/core/src/readiness.ts"() {
+  "packages/core/src/readiness.ts"() {
     "use strict";
     DEFAULT_LAYER_NAME = /^(Group|Frame|Rectangle|Ellipse|Vector|Component)\s*\d*$/;
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/core/src/index.ts
+// packages/core/src/index.ts
 var init_src3 = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/core/src/index.ts"() {
+  "packages/core/src/index.ts"() {
     "use strict";
     init_ir();
     init_ir_builder();
@@ -1776,20 +1851,72 @@ var init_src3 = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/browser.ts
-import { execFileSync } from "node:child_process";
-import { existsSync as existsSync3, readdirSync } from "node:fs";
+// packages/cli/src/invocation.ts
+import { existsSync as existsSync3, realpathSync } from "node:fs";
 import path3 from "node:path";
+import { fileURLToPath } from "node:url";
+function findPathTendril(pathEnv, platform) {
+  const dirs = pathEnv.split(path3.delimiter).filter((d) => d !== "" && !/node_modules[\\/]\.bin/.test(d) && !/[\\/]_npx[\\/]/.test(d));
+  const names = platform === "win32" ? ["tendril.cmd", "tendril.bat"] : ["tendril"];
+  for (const dir of dirs) {
+    for (const name of names) {
+      const candidate = path3.join(dir, name);
+      if (existsSync3(candidate)) return candidate;
+    }
+  }
+  return null;
+}
+function packageRootOf(file) {
+  let dir = path3.dirname(file);
+  for (; ; ) {
+    if (existsSync3(path3.join(dir, "package.json"))) return dir;
+    const parent = path3.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function resolveInvocation(pathEnv, platform, selfFile = fileURLToPath(import.meta.url)) {
+  const binary = findPathTendril(pathEnv, platform);
+  if (binary === null) return NPX_INVOCATION;
+  try {
+    const onPath = packageRootOf(realpathSync(binary));
+    const self = packageRootOf(realpathSync(selfFile));
+    if (onPath === null || self === null) return NPX_INVOCATION;
+    return realpathSync(onPath) === realpathSync(self) ? "tendril" : NPX_INVOCATION;
+  } catch {
+    return NPX_INVOCATION;
+  }
+}
+function tendrilInvocation() {
+  cached ??= resolveInvocation(process.env["PATH"] ?? "", process.platform);
+  return cached;
+}
+function tendrilCommand(args) {
+  return `${tendrilInvocation()} ${args}`;
+}
+var NPX_INVOCATION, cached;
+var init_invocation = __esm({
+  "packages/cli/src/invocation.ts"() {
+    "use strict";
+    NPX_INVOCATION = "npx -y -p @tendrilapp/cli@latest tendril";
+    cached = null;
+  }
+});
+
+// packages/verify/src/browser.ts
+import { execFileSync } from "node:child_process";
+import { existsSync as existsSync4, readdirSync } from "node:fs";
+import path4 from "node:path";
 function resolveChrome() {
   const fromEnv = process.env["TENDRIL_CHROME"] ?? process.env["CHROME_PATH"];
   if (fromEnv !== void 0 && fromEnv !== "") {
-    if (!existsSync3(fromEnv)) {
+    if (!existsSync4(fromEnv)) {
       throw new Error(`CHROME_PATH points at ${fromEnv}, which does not exist \u2014 fix the variable or unset it to use discovery`);
     }
     return fromEnv;
   }
   const candidates = process.platform === "darwin" ? MAC_CANDIDATES : process.platform === "win32" ? WIN_CANDIDATES : [];
-  for (const c of candidates) if (existsSync3(c)) return c;
+  for (const c of candidates) if (existsSync4(c)) return c;
   if (process.platform !== "win32") {
     for (const name of PATH_NAMES) {
       try {
@@ -1803,7 +1930,7 @@ function resolveChrome() {
 }
 function versionFromInstallDir(exePath) {
   try {
-    const builds = readdirSync(path3.dirname(exePath), { withFileTypes: true }).filter((e) => e.isDirectory() && /^\d+(\.\d+){3}$/.test(e.name)).map((e) => e.name.split(".").map(Number));
+    const builds = readdirSync(path4.dirname(exePath), { withFileTypes: true }).filter((e) => e.isDirectory() && /^\d+(\.\d+){3}$/.test(e.name)).map((e) => e.name.split(".").map(Number));
     builds.sort((a, b) => a[0] - b[0] || a[1] - b[1] || a[2] - b[2] || a[3] - b[3]);
     return builds.length === 0 ? null : builds[builds.length - 1].join(".");
   } catch {
@@ -1815,7 +1942,7 @@ function windowsBrowserName(exePath) {
   if (p.includes("\\google\\chrome\\")) return "Google Chrome";
   if (p.includes("\\microsoft\\edge\\")) return "Microsoft Edge";
   if (p.includes("chromium")) return "Chromium";
-  return path3.win32.basename(exePath, ".exe");
+  return path4.win32.basename(exePath, ".exe");
 }
 function chromeVersion() {
   if (_version !== void 0) return _version;
@@ -1834,7 +1961,7 @@ function chromeVersion() {
 }
 var MAC_CANDIDATES, WIN_CANDIDATES, PATH_NAMES, _version;
 var init_browser = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/browser.ts"() {
+  "packages/verify/src/browser.ts"() {
     "use strict";
     MAC_CANDIDATES = [
       "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
@@ -1849,33 +1976,33 @@ var init_browser = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/runtime.ts
-import { existsSync as existsSync4, mkdtempSync, symlinkSync } from "node:fs";
+// packages/verify/src/runtime.ts
+import { existsSync as existsSync5, mkdtempSync, symlinkSync } from "node:fs";
 import { createRequire } from "node:module";
 import os from "node:os";
-import path4 from "node:path";
-import { fileURLToPath } from "node:url";
+import path5 from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 function runtimePackageRoot() {
   const env = process.env["TENDRIL_PACKAGE_ROOT"];
-  if (env !== void 0 && env !== "") return path4.resolve(env);
-  return path4.resolve(path4.dirname(fileURLToPath(import.meta.url)), "..");
+  if (env !== void 0 && env !== "") return path5.resolve(env);
+  return path5.resolve(path5.dirname(fileURLToPath2(import.meta.url)), "..");
 }
 function runtimeNodeModules() {
   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;
+  for (let dir = root; ; dir = path5.dirname(dir)) {
+    const candidate = path5.basename(dir) === "node_modules" ? dir : path5.join(dir, "node_modules");
+    if (existsSync5(path5.join(candidate, "react"))) return candidate;
+    if (path5.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 dir = mkdtempSync(path5.join(os.tmpdir(), `tendril-${prefix}-`));
   const nodeModules = runtimeNodeModules();
   try {
-    symlinkSync(nodeModules, path4.join(dir, "node_modules"), "junction");
+    symlinkSync(nodeModules, path5.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.`
@@ -1884,7 +2011,7 @@ function newScratchDir(prefix) {
   return dir;
 }
 function reactPinPlugin() {
-  const req = createRequire(path4.join(runtimePackageRoot(), "package.json"));
+  const req = createRequire(path5.join(runtimePackageRoot(), "package.json"));
   return {
     name: "tendril-react-pin",
     setup(b) {
@@ -1899,12 +2026,12 @@ function reactPinPlugin() {
   };
 }
 var init_runtime = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/runtime.ts"() {
+  "packages/verify/src/runtime.ts"() {
     "use strict";
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/gates.ts
+// packages/verify/src/gates.ts
 function scanForbiddenPatterns(source) {
   const violations = [];
   const lines = source.split("\n");
@@ -1923,7 +2050,7 @@ function scanForbiddenPatterns(source) {
 }
 var FORBIDDEN_PATTERNS;
 var init_gates = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/gates.ts"() {
+  "packages/verify/src/gates.ts"() {
     "use strict";
     FORBIDDEN_PATTERNS = [
       { name: "eslint-disable", regex: /eslint-disable/ },
@@ -1935,11 +2062,11 @@ var init_gates = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/tsc-check.ts
+// packages/verify/src/tsc-check.ts
 import ts from "typescript";
-import path5 from "node:path";
+import path6 from "node:path";
 function runTscStrict(files) {
-  const program = ts.createProgram(files.map((f) => path5.resolve(f)), STRICT_OPTIONS);
+  const program = ts.createProgram(files.map((f) => path6.resolve(f)), STRICT_OPTIONS);
   const diagnostics = ts.getPreEmitDiagnostics(program);
   const mapped = diagnostics.map((d) => {
     const file = d.file?.fileName;
@@ -1955,7 +2082,7 @@ function runTscStrict(files) {
 }
 var STRICT_OPTIONS;
 var init_tsc_check = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/tsc-check.ts"() {
+  "packages/verify/src/tsc-check.ts"() {
     "use strict";
     STRICT_OPTIONS = {
       strict: true,
@@ -1975,7 +2102,7 @@ var init_tsc_check = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/token-lint.ts
+// packages/verify/src/token-lint.ts
 import strictValue from "stylelint-declaration-strict-value";
 import stylelint from "stylelint";
 async function runTokenLint(css, fileLabel = "generated.css", definedVars2, recordedMapEmpty = false) {
@@ -2036,7 +2163,7 @@ async function runTokenLint(css, fileLabel = "generated.css", definedVars2, reco
 }
 var TOKEN_ENFORCED_PROPERTIES, ALLOWED_KEYWORDS, STYLELINT_CONFIG, LEGAL_CUSTOM_PROP;
 var init_token_lint = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/token-lint.ts"() {
+  "packages/verify/src/token-lint.ts"() {
     "use strict";
     TOKEN_ENFORCED_PROPERTIES = [
       "/color$/",
@@ -2096,9 +2223,9 @@ var init_token_lint = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/loop.ts
+// packages/verify/src/loop.ts
 import { rmSync, writeFileSync as writeFileSync2 } from "node:fs";
-import path6 from "node:path";
+import path7 from "node:path";
 async function runChecks(componentName, files, extraFiles, definedVars2) {
   const findings = [];
   for (const violation of scanForbiddenPatterns(files.tsx)) {
@@ -2113,10 +2240,10 @@ async function runChecks(componentName, files, extraFiles, definedVars2) {
   }
   const workDir = newScratchDir("loop");
   try {
-    const tsxPath = path6.join(workDir, `${componentName}.tsx`);
+    const tsxPath = path7.join(workDir, `${componentName}.tsx`);
     writeFileSync2(tsxPath, files.tsx);
     for (const [name, content] of Object.entries(extraFiles ?? {})) {
-      writeFileSync2(path6.join(workDir, name), content);
+      writeFileSync2(path7.join(workDir, name), content);
     }
     const tsc = runTscStrict([tsxPath]);
     for (const d of tsc.diagnostics) {
@@ -2170,7 +2297,7 @@ function definedVarsFrom(tokensCss) {
 }
 var SKIPPED_CHECKS;
 var init_loop = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/loop.ts"() {
+  "packages/verify/src/loop.ts"() {
     "use strict";
     init_runtime();
     init_gates();
@@ -2180,7 +2307,7 @@ var init_loop = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/report.ts
+// packages/verify/src/report.ts
 import { z as z5 } from "zod";
 function isTokenEnforcedProperty(property) {
   return enforcedMatchers.some((m) => m.test(property));
@@ -2220,7 +2347,7 @@ function buildReport(input) {
 }
 var ReportSchema, enforcedMatchers;
 var init_report = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/report.ts"() {
+  "packages/verify/src/report.ts"() {
     "use strict";
     init_token_lint();
     ReportSchema = z5.object({
@@ -2282,7 +2409,7 @@ var init_report = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/mount-limits.ts
+// packages/verify/src/mount-limits.ts
 function lcdTextEnabled() {
   return process.env["TENDRIL_ENABLE_LCD_TEXT"] === "1";
 }
@@ -2300,14 +2427,14 @@ function raceMountDeadline(work, deadlineMs, onDeadline) {
 }
 var MEMORY_CAP_ARG, ENGINE_MOUNT_DEADLINE_MS;
 var init_mount_limits = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/mount-limits.ts"() {
+  "packages/verify/src/mount-limits.ts"() {
     "use strict";
     MEMORY_CAP_ARG = "--js-flags=--max-old-space-size=512";
     ENGINE_MOUNT_DEADLINE_MS = 3e4;
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/image-diff.ts
+// packages/verify/src/image-diff.ts
 import { PNG } from "pngjs";
 import pixelmatch from "pixelmatch";
 function channelDistance(a, b) {
@@ -2749,7 +2876,7 @@ function cropPng(png, x, y, width, height) {
 }
 var INK_DELTA, ABSENT_RADIUS, ABSENT_MIN_PX;
 var init_image_diff = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/image-diff.ts"() {
+  "packages/verify/src/image-diff.ts"() {
     "use strict";
     INK_DELTA = 30;
     ABSENT_RADIUS = 3;
@@ -2757,9 +2884,9 @@ var init_image_diff = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/visual-facts.ts
-import path7 from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+// packages/verify/src/visual-facts.ts
+import path8 from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 import { build } from "esbuild";
 import { chromium } from "playwright-core";
 function resolveAxisValue(declared, props, axis, value) {
@@ -3298,12 +3425,12 @@ ${input.files.css}
 }
 var RESOLVE_DIR, TOLERANCE_PX, WIDTH_SLACK, IMAGE_SIMILARITY_FLOOR, INK_RECALL_FLOOR;
 var init_visual_facts = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/visual-facts.ts"() {
+  "packages/verify/src/visual-facts.ts"() {
     "use strict";
     init_browser();
     init_mount_limits();
     init_image_diff();
-    RESOLVE_DIR = path7.resolve(path7.dirname(fileURLToPath2(import.meta.url)), "..");
+    RESOLVE_DIR = path8.resolve(path8.dirname(fileURLToPath3(import.meta.url)), "..");
     TOLERANCE_PX = 2;
     WIDTH_SLACK = 0.25;
     IMAGE_SIMILARITY_FLOOR = 0.8;
@@ -3311,27 +3438,27 @@ var init_visual_facts = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/paths.ts
-import path8 from "node:path";
-import { fileURLToPath as fileURLToPath3 } from "node:url";
+// packages/verify/src/paths.ts
+import path9 from "node:path";
+import { fileURLToPath as fileURLToPath4 } from "node:url";
 var VERIFY_PKG_DIR, REPO_ROOT;
 var init_paths = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/paths.ts"() {
+  "packages/verify/src/paths.ts"() {
     "use strict";
-    VERIFY_PKG_DIR = path8.resolve(path8.dirname(fileURLToPath3(import.meta.url)), "..");
-    REPO_ROOT = path8.resolve(VERIFY_PKG_DIR, "..", "..");
+    VERIFY_PKG_DIR = path9.resolve(path9.dirname(fileURLToPath4(import.meta.url)), "..");
+    REPO_ROOT = path9.resolve(VERIFY_PKG_DIR, "..", "..");
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/font-resolve.ts
+// packages/verify/src/font-resolve.ts
 import { createHash } from "node:crypto";
-import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
 import os2 from "node:os";
-import path9 from "node:path";
+import path10 from "node:path";
 function fontCacheDir() {
   const env = process.env["TENDRIL_FONT_CACHE"];
-  if (env !== void 0 && env !== "") return path9.resolve(env);
-  return path9.join(os2.homedir(), ".tendril", "fonts");
+  if (env !== void 0 && env !== "") return path10.resolve(env);
+  return path10.join(os2.homedir(), ".tendril", "fonts");
 }
 function normalizeFontLicense(value) {
   return typeof value === "string" && FONT_LICENSES.includes(value) ? value : "unknown";
@@ -3396,25 +3523,25 @@ async function resolveFonts(family, weights, cacheDir = DEFAULT_FONT_CACHE) {
       }
       const bytes = new Uint8Array(await fileRes.arrayBuffer());
       const sha256 = createHash("sha256").update(bytes).digest("hex");
-      const file = path9.join(cacheDir, `${family.toLowerCase().replace(/\s+/g, "-")}-${weight}.woff2`);
+      const file = path10.join(cacheDir, `${family.toLowerCase().replace(/\s+/g, "-")}-${weight}.woff2`);
       writeFileSync3(file, bytes);
       resolved.push({ family, weight, source: url, sha256, file, license: meta.license, ...meta.family !== null ? { servedFamily: meta.family } : {} });
     } catch (err) {
       failures.push({ family, weight, reason: `download failed: ${err instanceof Error ? err.message : String(err)}` });
     }
   }
-  const mPath = path9.join(cacheDir, "manifest.json");
-  const prior = existsSync5(mPath) ? JSON.parse(readFileSync3(mPath, "utf8")) : [];
-  const portable2 = resolved.map((m) => ({ ...m, file: path9.basename(m.file) }));
+  const mPath = path10.join(cacheDir, "manifest.json");
+  const prior = existsSync6(mPath) ? JSON.parse(readFileSync3(mPath, "utf8")) : [];
+  const portable2 = resolved.map((m) => ({ ...m, file: path10.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)}
 `);
   return { resolved, failures };
 }
 function addLocalFont(family, weight, filePath, cacheDir = DEFAULT_FONT_CACHE) {
-  const src = path9.resolve(filePath);
-  if (!existsSync5(src)) throw new Error(`font file not found: ${src}`);
-  const ext = path9.extname(src).toLowerCase();
+  const src = path10.resolve(filePath);
+  if (!existsSync6(src)) throw new Error(`font file not found: ${src}`);
+  const ext = path10.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`);
   }
@@ -3422,20 +3549,20 @@ function addLocalFont(family, weight, filePath, cacheDir = DEFAULT_FONT_CACHE) {
   if (bytes.length === 0) throw new Error(`font file is empty: ${src}`);
   mkdirSync2(cacheDir, { recursive: true });
   const sha256 = createHash("sha256").update(bytes).digest("hex");
-  const file = path9.join(cacheDir, `${family.toLowerCase().replace(/\s+/g, "-")}-${weight}${ext}`);
+  const file = path10.join(cacheDir, `${family.toLowerCase().replace(/\s+/g, "-")}-${weight}${ext}`);
   writeFileSync3(file, bytes);
-  const face = { family, weight, source: `local:${path9.basename(src)}`, sha256, file, license: "unknown" };
-  const mPath = path9.join(cacheDir, "manifest.json");
-  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) }];
+  const face = { family, weight, source: `local:${path10.basename(src)}`, sha256, file, license: "unknown" };
+  const mPath = path10.join(cacheDir, "manifest.json");
+  const prior = existsSync6(mPath) ? JSON.parse(readFileSync3(mPath, "utf8")) : [];
+  const merged = [...prior.filter((p) => !(p.family === family && p.weight === weight)), { ...face, file: path10.basename(file) }];
   writeFileSync3(mPath, `${JSON.stringify(merged, null, 2)}
 `);
   return face;
 }
 function checkFontLock(lockPath, cacheDir = DEFAULT_FONT_CACHE) {
   const lock = JSON.parse(readFileSync3(lockPath, "utf8"));
-  const mPath = path9.join(cacheDir, "manifest.json");
-  const manifest = existsSync5(mPath) ? JSON.parse(readFileSync3(mPath, "utf8")) : [];
+  const mPath = path10.join(cacheDir, "manifest.json");
+  const manifest = existsSync6(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" };
@@ -3443,8 +3570,8 @@ function checkFontLock(lockPath, cacheDir = DEFAULT_FONT_CACHE) {
   });
 }
 function resolvedFontFamilies(cacheDir = DEFAULT_FONT_CACHE) {
-  const mPath = path9.join(cacheDir, "manifest.json");
-  if (!existsSync5(mPath)) return [];
+  const mPath = path10.join(cacheDir, "manifest.json");
+  if (!existsSync6(mPath)) return [];
   let entries;
   try {
     entries = JSON.parse(readFileSync3(mPath, "utf8"));
@@ -3461,8 +3588,8 @@ function resolvedFontFamilies(cacheDir = DEFAULT_FONT_CACHE) {
   return [...byFamily.entries()].map(([family, w]) => ({ family, weights: [...w].sort((a, b) => a - b) }));
 }
 function requiredFontsManifest(families, cacheDir = DEFAULT_FONT_CACHE) {
-  const mPath = path9.join(cacheDir, "manifest.json");
-  const manifest = existsSync5(mPath) ? JSON.parse(readFileSync3(mPath, "utf8")) : [];
+  const mPath = path10.join(cacheDir, "manifest.json");
+  const manifest = existsSync6(mPath) ? JSON.parse(readFileSync3(mPath, "utf8")) : [];
   const wanted = new Set(families.map((f) => f.toLowerCase()));
   return manifest.filter((f) => wanted.has(f.family.toLowerCase())).map((f) => ({
     family: f.family,
@@ -3475,8 +3602,8 @@ function requiredFontsManifest(families, cacheDir = DEFAULT_FONT_CACHE) {
   }));
 }
 function facesMissingLicense(cacheDir = DEFAULT_FONT_CACHE) {
-  const mPath = path9.join(cacheDir, "manifest.json");
-  if (!existsSync5(mPath)) return [];
+  const mPath = path10.join(cacheDir, "manifest.json");
+  if (!existsSync6(mPath)) return [];
   let entries;
   try {
     entries = JSON.parse(readFileSync3(mPath, "utf8"));
@@ -3488,8 +3615,8 @@ function facesMissingLicense(cacheDir = DEFAULT_FONT_CACHE) {
   ).map((e) => ({ family: e.family, weight: e.weight, sha256: e.sha256 }));
 }
 function verifiedFontFamilies(cacheDir = DEFAULT_FONT_CACHE) {
-  const mPath = path9.join(cacheDir, "manifest.json");
-  if (!existsSync5(mPath)) return [];
+  const mPath = path10.join(cacheDir, "manifest.json");
+  if (!existsSync6(mPath)) return [];
   let entries;
   try {
     entries = JSON.parse(readFileSync3(mPath, "utf8"));
@@ -3499,8 +3626,8 @@ function verifiedFontFamilies(cacheDir = DEFAULT_FONT_CACHE) {
   const byFamily = /* @__PURE__ */ new Map();
   for (const e of entries) {
     if (typeof e.family !== "string" || typeof e.weight !== "number" || typeof e.file !== "string") continue;
-    const file = path9.isAbsolute(e.file) && existsSync5(e.file) ? e.file : path9.resolve(cacheDir, path9.basename(e.file));
-    if (!existsSync5(file)) continue;
+    const file = path10.isAbsolute(e.file) && existsSync6(e.file) ? e.file : path10.resolve(cacheDir, path10.basename(e.file));
+    if (!existsSync6(file)) continue;
     if (createHash("sha256").update(readFileSync3(file)).digest("hex") !== e.sha256) continue;
     const set = byFamily.get(e.family) ?? /* @__PURE__ */ new Set();
     set.add(e.weight);
@@ -3510,7 +3637,7 @@ function verifiedFontFamilies(cacheDir = DEFAULT_FONT_CACHE) {
 }
 var DEFAULT_FONT_CACHE, UA, FONT_LICENSES, GOOGLE_LICENSE_IDS, GOOGLE_FONT_FILE_PREFIX;
 var init_font_resolve = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/font-resolve.ts"() {
+  "packages/verify/src/font-resolve.ts"() {
     "use strict";
     DEFAULT_FONT_CACHE = fontCacheDir();
     UA = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/49.0.2623.87 Safari/537.36";
@@ -3525,65 +3652,76 @@ var init_font_resolve = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/font-faces.ts
+// packages/verify/src/font-faces.ts
 import { createHash as createHash2 } from "node:crypto";
-import { existsSync as existsSync6, readFileSync as readFileSync4 } from "node:fs";
-import path10 from "node:path";
-function fontFaceCss(manifestPath2 = path10.join(fontCacheDir(), "manifest.json")) {
-  if (!existsSync6(manifestPath2)) return "";
+import { existsSync as existsSync7, readFileSync as readFileSync4 } from "node:fs";
+import path11 from "node:path";
+function injectedGroups(manifestPath2) {
+  if (!existsSync7(manifestPath2)) return { groups: [], shared: false };
   const claimed = JSON.parse(readFileSync4(manifestPath2, "utf8"));
-  const resolveEntry = (f) => {
-    if (path10.isAbsolute(f) && existsSync6(f)) return f;
-    return path10.resolve(path10.dirname(manifestPath2), path10.basename(f));
-  };
-  const manifest = claimed.filter((f) => {
-    const file = resolveEntry(f.file);
-    if (!existsSync6(file)) return false;
-    return createHash2("sha256").update(readFileSync4(file)).digest("hex") === f.sha256;
-  });
-  const resolveFile = (f) => {
-    if (path10.isAbsolute(f) && existsSync6(f)) return f;
-    return path10.resolve(path10.dirname(manifestPath2), path10.basename(f));
-  };
+  const resolveFile = (f) => path11.isAbsolute(f) && existsSync7(f) ? f : path11.resolve(path11.dirname(manifestPath2), path11.basename(f));
   const byFile = /* @__PURE__ */ new Map();
-  for (const f of manifest) {
+  for (const f of claimed) {
+    const file = resolveFile(f.file);
+    if (!existsSync7(file)) continue;
+    if (createHash2("sha256").update(readFileSync4(file)).digest("hex") !== f.sha256) continue;
     const k = `${f.family}:${f.file}`;
-    const e = byFile.get(k) ?? { family: f.family, weights: [], file: resolveFile(f.file) };
+    const e = byFile.get(k) ?? { family: f.family, weights: [], file };
     e.weights.push(f.weight);
     byFile.set(k, e);
   }
-  const files = new Set([...byFile.values()].map((e) => e.file));
-  const shared = files.size < byFile.size;
-  return [...byFile.values()].map((e) => {
-    const weight = shared || e.weights.length > 1 ? "100 700" : String(e.weights[0]);
+  const groups = [...byFile.values()];
+  return { groups, shared: new Set(groups.map((e) => e.file)).size < groups.length };
+}
+function fontFaceCss(manifestPath2 = path11.join(fontCacheDir(), "manifest.json")) {
+  const { groups, shared } = injectedGroups(manifestPath2);
+  return groups.map((e) => {
+    const weight = shared || e.weights.length > 1 ? `${SPAN[0]} ${SPAN[1]}` : String(e.weights[0]);
     return `@font-face { font-family: '${e.family}'; font-weight: ${weight}; font-style: normal; src: url(data:font/woff2;base64,${readFileSync4(e.file).toString("base64")}) format('woff2'); }`;
   }).join("\n");
 }
+function injectedFamilyWeights(manifestPath2 = path11.join(fontCacheDir(), "manifest.json")) {
+  const { groups, shared } = injectedGroups(manifestPath2);
+  const out = /* @__PURE__ */ new Map();
+  for (const g of groups) {
+    const key = g.family.toLowerCase();
+    const e = out.get(key) ?? { weights: /* @__PURE__ */ new Set(), span: false };
+    for (const w of g.weights) e.weights.add(w);
+    if (shared || g.weights.length > 1) e.span = true;
+    out.set(key, e);
+  }
+  return out;
+}
+function servesWeight(coverage, weight) {
+  return coverage.weights.has(weight) || coverage.span && weight >= SPAN[0] && weight <= SPAN[1];
+}
+var SPAN;
 var init_font_faces = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/font-faces.ts"() {
+  "packages/verify/src/font-faces.ts"() {
     "use strict";
     init_font_resolve();
+    SPAN = [100, 700];
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/admission.ts
-import { readFileSync as readFileSync5, readdirSync as readdirSync2, existsSync as existsSync7, writeFileSync as writeFileSync4 } from "node:fs";
-import path11 from "node:path";
+// packages/verify/src/admission.ts
+import { readFileSync as readFileSync5, readdirSync as readdirSync2, existsSync as existsSync8, writeFileSync as writeFileSync4 } from "node:fs";
+import path12 from "node:path";
 import { build as build2 } from "esbuild";
 import postcss from "postcss";
 import tailwindcss from "tailwindcss";
 import { chromium as chromium2 } from "playwright-core";
 function fontWeightsByFamily() {
-  const mPath = path11.join(fontCacheDir(), "manifest.json");
+  const mPath = path12.join(fontCacheDir(), "manifest.json");
   const out = /* @__PURE__ */ new Map();
-  if (!existsSync7(mPath)) return out;
+  if (!existsSync8(mPath)) return out;
   for (const f of JSON.parse(readFileSync5(mPath, "utf8")))
     out.set(f.family, [...out.get(f.family) ?? [], f.weight]);
   return out;
 }
 var FONT_WEIGHTS;
 var init_admission = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/admission.ts"() {
+  "packages/verify/src/admission.ts"() {
     "use strict";
     init_paths();
     init_src();
@@ -3596,11 +3734,11 @@ var init_admission = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/tasks.ts
-import path12 from "node:path";
+// packages/verify/src/tasks.ts
+import path13 from "node:path";
 var CALENDAR_CONFIGS, CALENDAR_API, CALENDAR_BEHAVIORS, BUTTON_CONFIGS, BUTTON_API, COMBO_FIX, COMBO_CONFIGS, COMBO_API, MODAL_CONFIGS, MODAL_API, BUTTON_BEHAVIORS, COMBO_BEHAVIORS, MODAL_BEHAVIORS, TASKS;
 var init_tasks = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/tasks.ts"() {
+  "packages/verify/src/tasks.ts"() {
     "use strict";
     init_paths();
     CALENDAR_CONFIGS = [
@@ -3677,7 +3815,7 @@ export function Button(props: {
   [key: string]: unknown; // MUST spread unknown props (incl. data-*) onto the root element
 })
 
-Rules: plain CSS in styles.css (tokens.css optional, loaded first) \u2014 no Tailwind, no imports beyond react/react-dom. disabled buttons are unfocusable; the spinner honors prefers-reduced-motion (animation: none under the media query). Interactive states are REAL (:hover, :focus-visible) AND statically forceable via the data-tendril-state attribute ("hover" | "focus-visible") spread onto the root; forced and real selectors must share one declaration block, e.g. :is(:hover, [data-tendril-state~="hover"]). The host sizes nothing: the button is its natural recorded size. Fonts: 'Inter' is provided. Inline all SVGs (loading spinner, icons).
+Rules: plain CSS in styles.css (tokens.css optional, loaded first) \u2014 no Tailwind, no imports beyond react/react-dom. disabled buttons are unfocusable; the spinner honors prefers-reduced-motion (animation: none under the media query). Interactive states are REAL (:hover, :focus-visible) AND statically forceable via the data-tendril-state attribute ("hover" | "focus-visible") spread onto the root; forced and real selectors must share one declaration block, e.g. :is(:hover, [data-tendril-state~="hover"]). ROOT SIZE IS YOURS AND PIXELS DO NOT CHECK IT, IN EITHER DIRECTION: the mount floors your root to the recorded box (#root > *{min-width:<recorded w>px;min-height:<recorded h>px} \u2014 a floor, never a cap) and the image the scorer compares is a CROP of that box. So a button that computes NARROWER or SHORTER is stretched back and captures byte-identically to a correct one (measured on a real <button>), and an oversized one shows only where its own border, radius or shadow lands back inside the crop. Take both root dimensions from the recorded box, never from a score. Fonts: 'Inter' is provided. Inline all SVGs (loading spinner, icons).
 
 BEHAVIORAL CONTRACT (machine-verified, gating): the root is a focusable <button> with cursor:pointer; real :hover visibly changes it; the loading spinner has a RUNNING CSS animation. Static lookalikes fail.`;
     COMBO_FIX = {
@@ -3757,7 +3895,7 @@ BEHAVIORAL CONTRACT (machine-verified, gating): the primary action and close con
     ];
     TASKS = {
       calendar: {
-        set: path12.join(REPO_ROOT, "examples/recordings/shadcn-poc-calendar"),
+        set: path13.join(REPO_ROOT, "examples/recordings/shadcn-poc-calendar"),
         entry: "Calendar.tsx",
         configs: CALENDAR_CONFIGS,
         systemApi: CALENDAR_API,
@@ -3765,7 +3903,7 @@ BEHAVIORAL CONTRACT (machine-verified, gating): the primary action and close con
         prelude: { controls: ['[data-tendril-part="day"]'], textInputs: [] }
       },
       "shadcn-button": {
-        set: path12.join(REPO_ROOT, "examples/recordings/shadcn-poc-button"),
+        set: path13.join(REPO_ROOT, "examples/recordings/shadcn-poc-button"),
         entry: "Button.tsx",
         configs: BUTTON_CONFIGS,
         systemApi: BUTTON_API,
@@ -3773,7 +3911,7 @@ BEHAVIORAL CONTRACT (machine-verified, gating): the primary action and close con
         prelude: { controls: ["> *"], textInputs: [] }
       },
       combobox: {
-        set: path12.join(REPO_ROOT, "examples/recordings/carbon-poc-combobox"),
+        set: path13.join(REPO_ROOT, "examples/recordings/carbon-poc-combobox"),
         entry: "ComboBox.tsx",
         configs: COMBO_CONFIGS,
         systemApi: COMBO_API,
@@ -3781,7 +3919,7 @@ BEHAVIORAL CONTRACT (machine-verified, gating): the primary action and close con
         prelude: { controls: ['[role="option"]'], textInputs: ["input"], popover: { selector: '[role="listbox"]', trigger: "input" } }
       },
       modal: {
-        set: path12.join(REPO_ROOT, "examples/recordings/carbon-poc-modal"),
+        set: path13.join(REPO_ROOT, "examples/recordings/carbon-poc-modal"),
         entry: "Modal.tsx",
         configs: MODAL_CONFIGS,
         systemApi: MODAL_API,
@@ -3792,15 +3930,15 @@ BEHAVIORAL CONTRACT (machine-verified, gating): the primary action and close con
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/behavior.ts
+// packages/verify/src/behavior.ts
 var behavior_exports = {};
 __export(behavior_exports, {
   checkBehaviors: () => checkBehaviors,
   compileMount: () => compileMount,
   recordingIsDark: () => recordingIsDark
 });
-import { existsSync as existsSync8, readFileSync as readFileSync6 } from "node:fs";
-import path13 from "node:path";
+import { existsSync as existsSync9, readFileSync as readFileSync6 } from "node:fs";
+import path14 from "node:path";
 import { build as build3 } from "esbuild";
 import { chromium as chromium3 } from "playwright-core";
 import { PNG as PNG2 } from "pngjs";
@@ -3809,12 +3947,12 @@ function getFontFaces() {
   return _fontFaces;
 }
 async function compileMount(task, bundleDir) {
-  const entryTsx = path13.join(bundleDir, task.entry);
-  if (!existsSync8(entryTsx)) return { error: `${task.entry} missing` };
+  const entryTsx = path14.join(bundleDir, task.entry);
+  if (!existsSync9(entryTsx)) return { error: `${task.entry} missing` };
   const mountSrc = `
 import { createElement } from "react";
 import { createRoot } from "react-dom/client";
-import * as B from ${JSON.stringify(path13.resolve(entryTsx))};
+import * as B from ${JSON.stringify(path14.resolve(entryTsx))};
 const cfg = (window as unknown as { __cfg: { component: string; props: Record<string, unknown>; spyProps?: string[] } }).__cfg;
 const C = (B as Record<string, unknown>)[cfg.component] as Parameters<typeof createElement>[0] | undefined;
 // Callbacks cannot ride the JSON config: specs NAME spy props and the
@@ -4066,8 +4204,8 @@ async function runSteps(page, spec, renderPose) {
 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 (!existsSync8(f)) return false;
+  const f = path14.join(task.set, rep, "get_screenshot.json");
+  if (!existsSync9(f)) return false;
   try {
     const env = JSON.parse(readFileSync6(f, "utf8")).content.find((c) => c.type === "image");
     if (env?.data === void 0) return false;
@@ -4141,7 +4279,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) => existsSync8(f)).map((f) => readFileSync6(f, "utf8")).join("\n");
+  const css = ["tokens.css", "styles.css"].map((f) => path14.join(bundleDir, f)).filter((f) => existsSync9(f)).map((f) => readFileSync6(f, "utf8")).join("\n");
   const server = await chromium3.launchServer({ executablePath: resolveChrome(), headless: true, args: mountArgs() });
   const browser = await chromium3.connect(server.wsEndpoint());
   const results = [];
@@ -4248,7 +4386,7 @@ body{margin:0;padding:20px}
 }
 var _fontFaces, ANIMATED_PROBE, COMMIT_GAP_CLOSED, POSE_GAP_FLOOR, PRELUDE_ROOT_PROPS;
 var init_behavior = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/behavior.ts"() {
+  "packages/verify/src/behavior.ts"() {
     "use strict";
     init_runtime();
     init_browser();
@@ -4283,9 +4421,9 @@ var init_behavior = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/bundle-quality.ts
-import { readFileSync as readFileSync7, rmSync as rmSync2, writeFileSync as writeFileSync5, existsSync as existsSync9 } from "node:fs";
-import path14 from "node:path";
+// packages/verify/src/bundle-quality.ts
+import { readFileSync as readFileSync7, rmSync as rmSync2, writeFileSync as writeFileSync5, existsSync as existsSync10 } from "node:fs";
+import path15 from "node:path";
 function definedVars(tokensCss) {
   if (tokensCss === void 0) return void 0;
   const names = /* @__PURE__ */ new Set();
@@ -4294,7 +4432,7 @@ function definedVars(tokensCss) {
 }
 function recordedTokenMapEmpty(setDir, reps) {
   const readMap = (file) => {
-    if (!existsSync9(file)) return void 0;
+    if (!existsSync10(file)) return void 0;
     try {
       const parsed = JSON.parse(envelopeFirstTextPart(JSON.parse(readFileSync7(file, "utf8"))) || "{}");
       return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
@@ -4302,28 +4440,93 @@ function recordedTokenMapEmpty(setDir, reps) {
       return {};
     }
   };
-  const setLevel = readMap(path14.join(setDir, "get_variable_defs.json"));
+  const setLevel = readMap(path15.join(setDir, "get_variable_defs.json"));
   if (setLevel !== void 0) return Object.keys(setLevel).length === 0;
   let recorded = false;
   for (const rep of reps) {
-    const m = readMap(path14.join(setDir, rep, "get_variable_defs.json"));
+    const m = readMap(path15.join(setDir, rep, "get_variable_defs.json"));
     if (m === void 0) continue;
     recorded = true;
     if (Object.keys(m).length > 0) return false;
   }
   return recorded;
 }
-async function checkBundleQuality(bundleDir, entry, set) {
+function scannable(css) {
+  const blank = (m) => m.replace(/[^\n]/g, " ");
+  return css.replace(/\/\*[^]*?\*\//g, blank).replace(/@font-face\s*{[^}]*}/g, blank);
+}
+function usedWeights(css) {
+  const out = /* @__PURE__ */ new Set();
+  for (const m of css.matchAll(/font-weight\s*:\s*([^;}]+)/g)) {
+    const v = declValue(m[1]).toLowerCase();
+    if (v === "bold") out.add(700);
+    else if (v === "normal") out.add(400);
+    else if (/^\d{1,4}$/.test(v)) out.add(Number(v));
+  }
+  return [...out].sort((a, b) => a - b);
+}
+function fontStacks(css) {
+  const out = [];
+  for (const m of css.matchAll(/font-family\s*:\s*([^;}]+)/g)) {
+    const text = declValue(m[1]);
+    const families = text.split(",").map((f) => f.trim().replace(/^['"]|['"]$/g, "")).filter((f) => f !== "");
+    if (families.length > 0) out.push({ families, line: css.slice(0, m.index).split("\n").length, text });
+  }
+  return out;
+}
+function fontStackFindings(sheets, coverage) {
+  if (coverage.size === 0) return [];
+  const scanned = sheets.map((s) => ({ file: s.file, css: scannable(s.css) }));
+  const weights = [...new Set(scanned.flatMap((s) => usedWeights(s.css)))].sort((a, b) => a - b);
+  if (weights.length === 0) return [];
   const findings = [];
-  const entryPath = path14.join(bundleDir, entry);
-  const cssPath = path14.join(bundleDir, "styles.css");
-  const tokensPath = path14.join(bundleDir, "tokens.css");
-  const css = existsSync9(cssPath) ? readFileSync7(cssPath, "utf8") : "";
-  const tokensCss = existsSync9(tokensPath) ? readFileSync7(tokensPath, "utf8") : void 0;
-  if (existsSync9(entryPath)) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const sheet of scanned) {
+    for (const stack of fontStacks(sheet.css)) {
+      if (seen.has(stack.text)) continue;
+      seen.add(stack.text);
+      const family = stack.families[0];
+      const bound = coverage.get(family.toLowerCase());
+      if (bound === void 0) continue;
+      const unserved = weights.filter((w) => !servesWeight(bound, w));
+      if (unserved.length === 0) continue;
+      const rescue = stack.families.slice(1).find((f) => {
+        const c = coverage.get(f.toLowerCase());
+        return c !== void 0 && unserved.every((w) => servesWeight(c, w));
+      });
+      const has = bound.span ? "100\u2013700" : [...bound.weights].sort((a, b) => a - b).join(", ");
+      const list = unserved.join(", ");
+      const renders = !bound.span && bound.weights.size === 1 ? `renders in the ${[...bound.weights][0]} face` : "renders in whichever of those faces is nearest";
+      findings.push({
+        kind: "font-stack",
+        file: sheet.file,
+        line: stack.line,
+        message: `font-family ${stack.text} binds to '${family}', which the font kit provides at ${has} \u2014 CSS matches the FAMILY first and picks a weight only inside it (a later family is never consulted for a missing weight, and the prelude's font-synthesis: none rules out faux-bold), so text at weight ${list} ${renders}, silently. ` + (rescue !== void 0 ? `'${rescue}' in this same stack provides ${list}: list it first.` : `No family in this stack provides ${list} \u2014 if the recording shows ${unserved.length === 1 ? "that weight" : "those weights"}, run \`tendril fonts resolve "${family}" --weights ${unserved.join(" ")}\` and re-score.`) + " ADVISORY: the finding gates nothing \u2014 but the wrong face changes pixels, and this fix alone took a measured run from 7 to 9 certified."
+      });
+    }
+  }
+  return findings;
+}
+async function checkBundleQuality(bundleDir, entry, set, fontManifest) {
+  const findings = [];
+  const entryPath = path15.join(bundleDir, entry);
+  const cssPath = path15.join(bundleDir, "styles.css");
+  const tokensPath = path15.join(bundleDir, "tokens.css");
+  const css = existsSync10(cssPath) ? readFileSync7(cssPath, "utf8") : "";
+  const tokensCss = existsSync10(tokensPath) ? readFileSync7(tokensPath, "utf8") : void 0;
+  findings.push(
+    ...fontStackFindings(
+      [
+        { file: "styles.css", css },
+        ...tokensCss === void 0 ? [] : [{ file: "tokens.css", css: tokensCss }]
+      ],
+      injectedFamilyWeights(fontManifest)
+    )
+  );
+  if (existsSync10(entryPath)) {
     const workDir = newScratchDir("quality");
     try {
-      const tsxPath = path14.join(workDir, entry);
+      const tsxPath = path15.join(workDir, entry);
       writeFileSync5(tsxPath, readFileSync7(entryPath, "utf8"));
       for (const d of runTscStrict([tsxPath]).diagnostics) {
         findings.push({ kind: "tsc", file: entry, ...d.line === void 0 ? {} : { line: d.line }, message: `TS${d.code}: ${d.message}` });
@@ -4340,17 +4543,20 @@ async function checkBundleQuality(bundleDir, entry, set) {
   }
   return { findings, tokensAbsent: tokensCss === void 0 && !/var\(\s*--/.test(css) };
 }
+var declValue;
 var init_bundle_quality = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/bundle-quality.ts"() {
+  "packages/verify/src/bundle-quality.ts"() {
     "use strict";
     init_src();
+    init_font_faces();
     init_runtime();
     init_tsc_check();
     init_token_lint();
+    declValue = (raw) => raw.trim().replace(/\s*!important$/i, "").trim();
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/effect-geometry.ts
+// packages/verify/src/effect-geometry.ts
 function fold(into, dx, dy, radius, spread) {
   const reach = radius + spread;
   into.top = Math.max(into.top, reach - dy);
@@ -4382,15 +4588,15 @@ function extentsExplainPad(near, far, pad, tolerance = 2) {
 }
 var NO_EXTENTS;
 var init_effect_geometry = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/effect-geometry.ts"() {
+  "packages/verify/src/effect-geometry.ts"() {
     "use strict";
     NO_EXTENTS = { top: 0, right: 0, bottom: 0, left: 0 };
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/bundle-score.ts
-import { existsSync as existsSync10, mkdirSync as mkdirSync3, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "node:fs";
-import path15 from "node:path";
+// packages/verify/src/bundle-score.ts
+import { existsSync as existsSync11, mkdirSync as mkdirSync3, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "node:fs";
+import path16 from "node:path";
 import { build as build4 } from "esbuild";
 import { chromium as chromium4 } from "playwright-core";
 function getFontFaces2() {
@@ -4444,7 +4650,7 @@ function chooseSeat(cropAt, ref, padW, padH, backdrop, origin, extents) {
 }
 function metadataRoot(set, rep) {
   try {
-    const text = JSON.parse(readFileSync8(path15.join(set, rep, "get_metadata.json"), "utf8")).content.map((c) => c.text ?? "").join("\n");
+    const text = JSON.parse(readFileSync8(path16.join(set, rep, "get_metadata.json"), "utf8")).content.map((c) => c.text ?? "").join("\n");
     return parseMetadataStructure(text);
   } catch {
     return void 0;
@@ -4499,17 +4705,17 @@ function smallSemanticNodes(set, rep, maxArea = 1024) {
   });
 }
 function repMeta(set, rep) {
-  const text = JSON.parse(readFileSync8(path15.join(set, rep, "get_metadata.json"), "utf8")).content.map((c) => c.text ?? "").join("\n");
+  const text = JSON.parse(readFileSync8(path16.join(set, rep, "get_metadata.json"), "utf8")).content.map((c) => c.text ?? "").join("\n");
   const root = parseMetadataStructure(text);
   return { w: Math.round(root.width ?? 100), h: Math.round(root.height ?? 40) };
 }
 function repRef(set, rep) {
-  const env = JSON.parse(readFileSync8(path15.join(set, rep, "get_screenshot.json"), "utf8")).content.find((c) => c.type === "image");
+  const env = JSON.parse(readFileSync8(path16.join(set, rep, "get_screenshot.json"), "utf8")).content.find((c) => c.type === "image");
   return Uint8Array.from(Buffer.from(env?.data ?? "", "base64"));
 }
 function repEffectExtents(set, rep) {
-  const file = path15.join(set, rep, "get_design_context.json");
-  if (!existsSync10(file)) return void 0;
+  const file = path16.join(set, rep, "get_design_context.json");
+  if (!existsSync11(file)) return void 0;
   try {
     const text = JSON.parse(readFileSync8(file, "utf8")).content.map((c) => c.text ?? "").join("\n");
     const extents = shadowExtents(text);
@@ -4522,13 +4728,13 @@ async function scoreBundleForTask(task, bundleDir, bar = BAR, opts = {}) {
   if (opts.evidenceDir !== void 0) mkdirSync3(opts.evidenceDir, { recursive: true });
   const CONFIGS2 = task.configs;
   const timeoutMs = opts.mountDeadlineMs ?? ENGINE_MOUNT_DEADLINE_MS;
-  const entryTsx = path15.join(bundleDir, task.entry);
-  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 entryTsx = path16.join(bundleDir, task.entry);
+  if (!existsSync11(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) => path16.join(bundleDir, f)).filter((f) => existsSync11(f)).map((f) => readFileSync8(f, "utf8")).join("\n");
   const mountSrc = `
 import { createElement } from "react";
 import { createRoot } from "react-dom/client";
-import * as B from ${JSON.stringify(path15.resolve(entryTsx))};
+import * as B from ${JSON.stringify(path16.resolve(entryTsx))};
 const cfg = (window as unknown as { __cfg: { component: string; props: Record<string, unknown> } }).__cfg;
 const C = (B as Record<string, unknown>)[cfg.component] as Parameters<typeof createElement>[0] | undefined;
 const root = document.getElementById("root");
@@ -4623,12 +4829,12 @@ body{margin:0;background:rgb(${backdrop.join(",")})}
             return name === void 0 ? c : { ...c, name };
           });
           if (opts.evidenceDir !== void 0) {
-            writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-render.png`), scored);
-            writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-ref.png`), ref);
-            writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-diff.png`), diffPng(scored, ref));
+            writeFileSync6(path16.join(opts.evidenceDir, `${cfg.rep}-render.png`), scored);
+            writeFileSync6(path16.join(opts.evidenceDir, `${cfg.rep}-ref.png`), ref);
+            writeFileSync6(path16.join(opts.evidenceDir, `${cfg.rep}-diff.png`), diffPng(scored, ref));
             for (const [i, c] of absent.slice(0, 3).entries()) {
-              writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-absent-${i}-ref.png`), zoomCrop(ref, c));
-              writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-absent-${i}-render.png`), zoomCrop(scored, c));
+              writeFileSync6(path16.join(opts.evidenceDir, `${cfg.rep}-absent-${i}-ref.png`), zoomCrop(ref, c));
+              writeFileSync6(path16.join(opts.evidenceDir, `${cfg.rep}-absent-${i}-render.png`), zoomCrop(scored, c));
             }
           }
           return {
@@ -4688,7 +4894,7 @@ body{margin:0;background:rgb(${backdrop.join(",")})}
 }
 var BAR, MARGIN, _fontFaces2, CONFIGS, SEAT_WINDOW, EFFECT_BLEED_MAX;
 var init_bundle_score = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/bundle-score.ts"() {
+  "packages/verify/src/bundle-score.ts"() {
     "use strict";
     init_runtime();
     init_browser();
@@ -4706,11 +4912,11 @@ var init_bundle_score = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/containment.ts
+// packages/verify/src/containment.ts
 import { build as build5 } from "esbuild";
 import { chromium as chromium5 } from "playwright-core";
 var init_containment = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/containment.ts"() {
+  "packages/verify/src/containment.ts"() {
     "use strict";
     init_runtime();
     init_browser();
@@ -4720,14 +4926,14 @@ var init_containment = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/prelude.ts
+// packages/verify/src/prelude.ts
 var PRELUDE_CONTRACT;
 var init_prelude = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/prelude.ts"() {
+  "packages/verify/src/prelude.ts"() {
     "use strict";
     PRELUDE_CONTRACT = `BUNDLE PRELUDE (machine-verified on computed styles \u2014 the harness page provides NONE of this; your CSS must):
 - Containment reset on the component subtree: margin 0, box-sizing border-box, line-height/letter-spacing/font-family inherited from the root (host globals must not leak in).
-- 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).
+- Component root: -webkit-font-smoothing: antialiased and -moz-osx-font-smoothing: grayscale (recorded rasterization); font-synthesis: none (no faux bold or italic \u2014 text renders in the face your stack actually binds, so a weight the kit cannot serve reaches the score instead of being faked; it does NOT fall through to the next family in the stack); 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 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 indicator for keyboard focus and state the gap in your report. Text inputs match :focus-visible even on mouse click BY SPEC; the ONE permitted refinement is suppressing the indicator on a POSITIVELY OBSERVED pointer press, fail-safe toward showing it (programmatic focus, restored focus, and assistive tech all count as keyboard and keep the ring \u2014 WCAG 2.4.7 binds keyboard operation). Never suppress more broadly than an observed press, and never restyle what you kept.
@@ -4735,9 +4941,9 @@ var init_prelude = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/parity.ts
-import { existsSync as existsSync11, readFileSync as readFileSync9 } from "node:fs";
-import path16 from "node:path";
+// packages/verify/src/parity.ts
+import { existsSync as existsSync12, readFileSync as readFileSync9 } from "node:fs";
+import path17 from "node:path";
 import { chromium as chromium6 } from "playwright-core";
 function getFontFaces3() {
   _fontFaces3 ??= fontFaceCss();
@@ -4766,7 +4972,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) => existsSync11(f)).map((f) => readFileSync9(f, "utf8")).join("\n");
+  const css = ["tokens.css", "styles.css"].map((f) => path17.join(bundleDir, f)).filter((f) => existsSync12(f)).map((f) => readFileSync9(f, "utf8")).join("\n");
   const server = await chromium6.launchServer({ executablePath: resolveChrome(), headless: true, args: mountArgs() });
   const browser = await chromium6.connect(server.wsEndpoint());
   const results = [];
@@ -4835,7 +5041,7 @@ body{margin:0;padding:20px}
 }
 var _fontFaces3;
 var init_parity = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/parity.ts"() {
+  "packages/verify/src/parity.ts"() {
     "use strict";
     init_browser();
     init_behavior();
@@ -4844,10 +5050,10 @@ var init_parity = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/composition.ts
+// packages/verify/src/composition.ts
 import { createRequire as createRequire2 } from "node:module";
-import { existsSync as existsSync12, readFileSync as readFileSync10 } from "node:fs";
-import path17 from "node:path";
+import { existsSync as existsSync13, readFileSync as readFileSync10 } from "node:fs";
+import path18 from "node:path";
 import { build as build6 } from "esbuild";
 import { chromium as chromium7 } from "playwright-core";
 function getFontFaces4() {
@@ -4855,9 +5061,9 @@ function getFontFaces4() {
   return _fontFaces4;
 }
 async function compileInstrumentedMount(task, bundleDir) {
-  const entryTsx = path17.join(bundleDir, task.entry);
-  if (!existsSync12(entryTsx)) return { error: `${task.entry} missing` };
-  const requireFromVerify = createRequire2(path17.join(VERIFY_PKG_DIR, "package.json"));
+  const entryTsx = path18.join(bundleDir, task.entry);
+  if (!existsSync13(entryTsx)) return { error: `${task.entry} missing` };
+  const requireFromVerify = createRequire2(path18.join(VERIFY_PKG_DIR, "package.json"));
   let realJsxPath;
   try {
     realJsxPath = requireFromVerify.resolve("react/jsx-runtime");
@@ -4868,7 +5074,7 @@ async function compileInstrumentedMount(task, bundleDir) {
 import { createElement } from "react";
 import { createRoot } from "react-dom/client";
 import { __registerParts } from "react/jsx-runtime";
-import * as B from ${JSON.stringify(path17.resolve(entryTsx))};
+import * as B from ${JSON.stringify(path18.resolve(entryTsx))};
 const cfg = (window as unknown as { __cfg: { component: string; props: Record<string, unknown>; partComponents: string[] } }).__cfg;
 const pairs: Array<[unknown, string]> = [];
 for (const name of cfg.partComponents) {
@@ -4923,7 +5129,7 @@ function expectedParts(task, roles, mainSlug) {
 }
 function interiorRegions(setDir, roles) {
   const mains = roles.main;
-  const withInterior = mains.filter((m) => existsSync12(path17.join(setDir, m, "get_metadata_interior.json")));
+  const withInterior = mains.filter((m) => existsSync13(path18.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" };
   }
@@ -4940,7 +5146,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) => existsSync12(f)).map((f) => readFileSync10(f, "utf8")).join("\n");
+  const css = ["tokens.css", "styles.css"].map((f) => path18.join(bundleDir, f)).filter((f) => existsSync13(f)).map((f) => readFileSync10(f, "utf8")).join("\n");
   const server = await chromium7.launchServer({ executablePath: resolveChrome(), headless: true, args: mountArgs() });
   const browser = await chromium7.connect(server.wsEndpoint());
   const PAD = 4;
@@ -5045,7 +5251,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) => existsSync12(f)).map((f) => readFileSync10(f, "utf8")).join("\n");
+  const css = ["tokens.css", "styles.css"].map((f) => path18.join(bundleDir, f)).filter((f) => existsSync13(f)).map((f) => readFileSync10(f, "utf8")).join("\n");
   const server = await chromium7.launchServer({ executablePath: resolveChrome(), headless: true, args: mountArgs() });
   const browser = await chromium7.connect(server.wsEndpoint());
   try {
@@ -5110,7 +5316,7 @@ body{margin:0;padding:20px}
 }
 var _fontFaces4, REAL_JSX_SPEC, JSX_SHIM, CROP_BAR, cropId;
 var init_composition = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/composition.ts"() {
+  "packages/verify/src/composition.ts"() {
     "use strict";
     init_runtime();
     init_browser();
@@ -5134,18 +5340,18 @@ export const jsxs = (t, p, k) => real.jsxs(t, inject(t, p), k);
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/occlusion.ts
-import { existsSync as existsSync13 } from "node:fs";
-import path18 from "node:path";
+// packages/verify/src/occlusion.ts
+import { existsSync as existsSync14 } from "node:fs";
+import path19 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 (!existsSync13(entryTsx)) return { error: `${task.entry} missing` };
+  const entryTsx = path19.join(bundleDir, task.entry);
+  if (!existsSync14(entryTsx)) return { error: `${task.entry} missing` };
   const src = `
 import { createElement } from "react";
 import { createRoot } from "react-dom/client";
-import * as B from ${JSON.stringify(path18.resolve(entryTsx))};
+import * as B from ${JSON.stringify(path19.resolve(entryTsx))};
 const cfg = (window as unknown as { __cfg: { component: string; props: Record<string, unknown> } }).__cfg;
 const C = (B as Record<string, unknown>)[cfg.component] as Parameters<typeof createElement>[0] | undefined;
 for (const id of ["first", "second"]) {
@@ -5283,7 +5489,7 @@ body{margin:0;padding:16px;display:flex;flex-direction:column;gap:8px;align-item
 }
 var OVERLAY_SELECTOR;
 var init_occlusion = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/occlusion.ts"() {
+  "packages/verify/src/occlusion.ts"() {
     "use strict";
     init_runtime();
     init_browser();
@@ -5292,9 +5498,9 @@ var init_occlusion = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/index.ts
+// packages/verify/src/index.ts
 var init_src4 = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/verify/src/index.ts"() {
+  "packages/verify/src/index.ts"() {
     "use strict";
     init_browser();
     init_runtime();
@@ -5322,22 +5528,22 @@ var init_src4 = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/environment.ts
-import { existsSync as existsSync14, readFileSync as readFileSync11 } from "node:fs";
-import path19 from "node:path";
+// packages/cli/src/environment.ts
+import { existsSync as existsSync15, readFileSync as readFileSync11 } from "node:fs";
+import path20 from "node:path";
 import { createHash as createHash3 } from "node:crypto";
-import { fileURLToPath as fileURLToPath4 } from "node:url";
+import { fileURLToPath as fileURLToPath5 } from "node:url";
 function cliVersion() {
   try {
-    return JSON.parse(readFileSync11(path19.join(path19.dirname(fileURLToPath4(import.meta.url)), "..", "package.json"), "utf8")).version ?? "dev";
+    return JSON.parse(readFileSync11(path20.join(path20.dirname(fileURLToPath5(import.meta.url)), "..", "package.json"), "utf8")).version ?? "dev";
   } catch {
     return "dev";
   }
 }
 function environmentStamp(taskFamilies) {
-  const manifestPath2 = path19.join(fontCacheDir(), "manifest.json");
+  const manifestPath2 = path20.join(fontCacheDir(), "manifest.json");
   let fontsHash = null;
-  if (existsSync14(manifestPath2)) {
+  if (existsSync15(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()));
@@ -5357,20 +5563,20 @@ function environmentStamp(taskFamilies) {
   return { chrome, chromeVersion: ver === null ? null : ver + lcdSuffix, fontsManifestSha256: fontsHash };
 }
 var init_environment = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/environment.ts"() {
+  "packages/cli/src/environment.ts"() {
     "use strict";
     init_src4();
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/describe.ts
+// packages/cli/src/describe.ts
 function printDescription(description) {
   process.stdout.write(`${JSON.stringify(description, null, 2)}
 `);
 }
 var COMMON_EXIT_CODES;
 var init_describe = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/describe.ts"() {
+  "packages/cli/src/describe.ts"() {
     "use strict";
     COMMON_EXIT_CODES = {
       0: "success",
@@ -5382,9 +5588,9 @@ var init_describe = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/env.ts
-import { existsSync as existsSync15, readFileSync as readFileSync12 } from "node:fs";
-import path20 from "node:path";
+// packages/cli/src/env.ts
+import { existsSync as existsSync16, readFileSync as readFileSync12 } from "node:fs";
+import path21 from "node:path";
 function parseEnv(content) {
   const entries = /* @__PURE__ */ new Map();
   for (const line of content.split("\n")) {
@@ -5396,17 +5602,17 @@ function parseEnv(content) {
 function resolveCredential(name) {
   const fromProcess = process.env[name];
   if (fromProcess) return fromProcess;
-  const envPath = path20.resolve(process.env["INIT_CWD"] ?? process.cwd(), ".env");
-  if (!existsSync15(envPath)) return void 0;
+  const envPath = path21.resolve(process.env["INIT_CWD"] ?? process.cwd(), ".env");
+  if (!existsSync16(envPath)) return void 0;
   return parseEnv(readFileSync12(envPath, "utf8")).get(name);
 }
 var init_env = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/env.ts"() {
+  "packages/cli/src/env.ts"() {
     "use strict";
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/output.ts
+// packages/cli/src/output.ts
 var output_exports = {};
 __export(output_exports, {
   PROGRESS_PREFIX: () => PROGRESS_PREFIX,
@@ -5450,23 +5656,23 @@ function warn(flags, message) {
 }
 var PROGRESS_PREFIX;
 var init_output = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/output.ts"() {
+  "packages/cli/src/output.ts"() {
     "use strict";
     init_src3();
     PROGRESS_PREFIX = "@tendril-progress ";
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/entitlement.ts
-import { chmodSync, existsSync as existsSync16, mkdirSync as mkdirSync4, readFileSync as readFileSync13, writeFileSync as writeFileSync7 } from "node:fs";
+// packages/cli/src/entitlement.ts
+import { chmodSync, existsSync as existsSync17, mkdirSync as mkdirSync4, readFileSync as readFileSync13, writeFileSync as writeFileSync7 } from "node:fs";
 import crypto from "node:crypto";
 import os3 from "node:os";
-import path21 from "node:path";
+import path22 from "node:path";
 function entitlementPath() {
-  return process.env["TENDRIL_ENTITLEMENT_PATH"] ?? path21.join(os3.homedir(), ".tendril", "entitlement.json");
+  return process.env["TENDRIL_ENTITLEMENT_PATH"] ?? path22.join(os3.homedir(), ".tendril", "entitlement.json");
 }
 function readStoredEntitlement(file = entitlementPath()) {
-  if (!existsSync16(file)) return void 0;
+  if (!existsSync17(file)) return void 0;
   try {
     const parsed = JSON.parse(readFileSync13(file, "utf8"));
     if (typeof parsed.token !== "string" || typeof parsed.lastRefreshAt !== "number") return void 0;
@@ -5476,7 +5682,7 @@ function readStoredEntitlement(file = entitlementPath()) {
   }
 }
 function writeStoredEntitlement(stored, file = entitlementPath()) {
-  mkdirSync4(path21.dirname(file), { recursive: true });
+  mkdirSync4(path22.dirname(file), { recursive: true });
   writeFileSync7(file, `${JSON.stringify(stored, null, 2)}
 `);
   chmodSync(file, 384);
@@ -5502,11 +5708,11 @@ function checkEntitlement(opts = {}) {
   const now = opts.now ?? Date.now();
   const stored = "stored" in opts ? opts.stored : readStoredEntitlement();
   if (stored === void 0) {
-    return { ok: false, code: "entitlement-required", error: "no entitlement on this machine \u2014 record and generate need an active Tendril plan (verify stays free, always)", remediation: ACTIVATE_REMEDIATION };
+    return { ok: false, code: "entitlement-required", error: "no entitlement on this machine \u2014 record and generate need an active Tendril plan (verify stays free, always)", remediation: activateRemediation() };
   }
   const parsed = parseEntitlementToken(stored.token);
   if ("error" in parsed) {
-    return { ok: false, code: "entitlement-invalid", error: `stored entitlement is unreadable: ${parsed.error}`, remediation: ACTIVATE_REMEDIATION };
+    return { ok: false, code: "entitlement-invalid", error: `stored entitlement is unreadable: ${parsed.error}`, remediation: activateRemediation() };
   }
   const pem = keys[parsed.claims.kid];
   const valid = pem !== void 0 && (() => {
@@ -5517,14 +5723,14 @@ function checkEntitlement(opts = {}) {
     }
   })();
   if (!valid) {
-    return { ok: false, code: "entitlement-invalid", error: "stored entitlement failed signature verification", remediation: ACTIVATE_REMEDIATION };
+    return { ok: false, code: "entitlement-invalid", error: "stored entitlement failed signature verification", remediation: activateRemediation() };
   }
   if (now > parsed.claims.exp + TOLERANCE_MS) {
     return {
       ok: false,
       code: "entitlement-expired",
       error: "entitlement expired (and the offline tolerance window has passed)",
-      remediation: `Reconnect and ${ACTIVATE_REMEDIATION}`
+      remediation: `Reconnect and ${activateRemediation()}`
     };
   }
   if (now < stored.lastRefreshAt - CLOCK_ROLLBACK_MS) {
@@ -5532,7 +5738,7 @@ function checkEntitlement(opts = {}) {
       ok: false,
       code: "entitlement-clock",
       error: "system clock sits more than a day before the last entitlement refresh",
-      remediation: `Fix the system clock, then ${ACTIVATE_REMEDIATION}`
+      remediation: `Fix the system clock, then ${activateRemediation()}`
     };
   }
   return { ok: true, mode: "active", claims: parsed.claims, stale: now > parsed.claims.exp };
@@ -5543,26 +5749,27 @@ function requireEntitlement(flags) {
     fail(flags, ExitCode.Auth, { error: status.error, code: status.code, remediation: status.remediation });
   }
 }
-var ENT_PREFIX, PUBLIC_KEYS, TOLERANCE_MS, CLOCK_ROLLBACK_MS, b64urlDecode, ACTIVATE_REMEDIATION;
+var ENT_PREFIX, PUBLIC_KEYS, TOLERANCE_MS, CLOCK_ROLLBACK_MS, b64urlDecode, activateRemediation;
 var init_entitlement = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/entitlement.ts"() {
+  "packages/cli/src/entitlement.ts"() {
     "use strict";
     init_src3();
+    init_invocation();
     init_output();
     ENT_PREFIX = "tendril-ent.v1.";
     PUBLIC_KEYS = {};
     TOLERANCE_MS = 24 * 60 * 60 * 1e3;
     CLOCK_ROLLBACK_MS = 24 * 60 * 60 * 1e3;
     b64urlDecode = (s) => Buffer.from(s, "base64url");
-    ACTIVATE_REMEDIATION = "Run `tendril activate` in your terminal (a browser approval \u2014 never paste license material into an agent chat).";
+    activateRemediation = () => `Run \`${tendrilCommand("activate")}\` in your terminal (a browser approval \u2014 never paste license material into an agent chat).`;
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/doctor.ts
+// packages/cli/src/commands/doctor.ts
 import { spawnSync } from "node:child_process";
-import { existsSync as existsSync17, readFileSync as readFileSync14, readdirSync as readdirSync3 } from "node:fs";
+import { existsSync as existsSync18, readFileSync as readFileSync14, readdirSync as readdirSync3 } from "node:fs";
 import os4 from "node:os";
-import path22 from "node:path";
+import path23 from "node:path";
 async function runDoctorChecks(options) {
   const checks = [];
   const mcpUrl = options.mcpUrl ?? DEFAULT_MCP_URL;
@@ -5592,7 +5799,7 @@ async function runDoctorChecks(options) {
       name: "openrouter-key",
       ok: false,
       detail: "OPENROUTER_API_KEY not set \u2014 optional; only the curated API-model engine needs it",
-      remediation: "Run `tendril init` to store your OpenRouter key (BYOK) if you plan to use the curated engine."
+      remediation: `Run \`${tendrilCommand("init")}\` to store your OpenRouter key (BYOK) if you plan to use the curated engine.`
     }
   );
   try {
@@ -5606,17 +5813,17 @@ async function runDoctorChecks(options) {
       remediation: "Install Google Chrome (or Chromium), or set CHROME_PATH to a Chromium-family browser binary."
     });
   }
-  const fontManifest = path22.join(fontCacheDir(), "manifest.json");
+  const fontManifest = path23.join(fontCacheDir(), "manifest.json");
   checks.push(
-    existsSync17(fontManifest) ? { name: "font-cache", ok: true, detail: `resolved font cache at ${fontCacheDir()} (${JSON.parse(readFileSync14(fontManifest, "utf8")).length} faces)` } : {
+    existsSync18(fontManifest) ? { name: "font-cache", ok: true, detail: `resolved font cache at ${fontCacheDir()} (${JSON.parse(readFileSync14(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`,
-      remediation: "Nothing to do now: `tendril fonts resolve --set <recording-dir>` fetches exactly what a recording declares, and generate/verify name that command when they need it."
+      remediation: `Nothing to do now: \`${tendrilCommand("fonts resolve --set <recording-dir>")}\` fetches exactly what a recording declares, and generate/verify name that command \u2014 with the set filled in \u2014 when they need it.`
     }
   );
-  const pluginRoot = path22.join(os4.homedir(), ".claude", "plugins", "cache", "tendrilapp", "tendril");
-  if (existsSync17(pluginRoot)) {
+  const pluginRoot = path23.join(os4.homedir(), ".claude", "plugins", "cache", "tendrilapp", "tendril");
+  if (existsSync18(pluginRoot)) {
     try {
       const versions = readdirSync3(pluginRoot).filter((v) => /^\d+\.\d+\.\d+$/.test(v));
       const newest = versions.sort((a, b) => versionIsNewer(a, b) ? 1 : -1)[0];
@@ -5660,17 +5867,6 @@ async function runDoctorChecks(options) {
   });
   return { ok: checks.filter((c) => c.name !== "figma-pat" && c.name !== "openrouter-key" && c.name !== "path-skew").every((c) => c.ok), checks };
 }
-function findPathTendril(pathEnv, platform) {
-  const dirs = pathEnv.split(path22.delimiter).filter((d) => d !== "" && !/node_modules[\\/]\.bin/.test(d) && !/[\\/]_npx[\\/]/.test(d));
-  const names = platform === "win32" ? ["tendril.cmd", "tendril.bat"] : ["tendril"];
-  for (const dir of dirs) {
-    for (const name of names) {
-      const candidate = path22.join(dir, name);
-      if (existsSync17(candidate)) return candidate;
-    }
-  }
-  return null;
-}
 function probeVersion(binary) {
   const windowsShim = /\.(cmd|bat)$/i.test(binary);
   const res = windowsShim ? spawnSync(`"${binary}" --version`, { shell: true, timeout: 5e3, encoding: "utf8" }) : spawnSync(binary, ["--version"], { timeout: 5e3, encoding: "utf8" });
@@ -5735,13 +5931,14 @@ async function runDoctor(flags) {
 }
 var DEFAULT_MCP_URL, DOCTOR_DESCRIPTION;
 var init_doctor = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/doctor.ts"() {
+  "packages/cli/src/commands/doctor.ts"() {
     "use strict";
     init_src4();
     init_src();
     init_describe();
     init_env();
     init_environment();
+    init_invocation();
     init_output();
     init_entitlement();
     DEFAULT_MCP_URL = "http://127.0.0.1:3845/mcp";
@@ -5763,7 +5960,7 @@ var init_doctor = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/llm/src/model-config.ts
+// packages/llm/src/model-config.ts
 import { z as z6 } from "zod";
 function resolveModel(config, requestedId) {
   const entry = config.allowlist.find((m) => m.id === requestedId);
@@ -5784,7 +5981,7 @@ function resolveModel(config, requestedId) {
 }
 var ModelStatusSchema, ModelEntrySchema, ModelConfigSchema, DEFAULT_MODEL_CONFIG;
 var init_model_config = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/llm/src/model-config.ts"() {
+  "packages/llm/src/model-config.ts"() {
     "use strict";
     ModelStatusSchema = z6.enum(["verified", "degraded"]);
     ModelEntrySchema = z6.object({
@@ -5873,10 +6070,10 @@ var init_model_config = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/llm/src/openrouter.ts
+// packages/llm/src/openrouter.ts
 var FALLBACK_KINDS, DEFAULT_REQUEST_TIMEOUT_MS, OpenRouterClient;
 var init_openrouter = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/llm/src/openrouter.ts"() {
+  "packages/llm/src/openrouter.ts"() {
     "use strict";
     FALLBACK_KINDS = /* @__PURE__ */ new Set(["rate-limit", "server", "network", "timeout"]);
     DEFAULT_REQUEST_TIMEOUT_MS = 6e5;
@@ -6003,7 +6200,7 @@ var init_openrouter = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/llm/src/semantics.ts
+// packages/llm/src/semantics.ts
 import { z as z7 } from "zod";
 function portable(node) {
   if (Array.isArray(node)) return node.map(portable);
@@ -6041,7 +6238,7 @@ function docsJsonSchema() {
 }
 var PropTypeSchema, SemanticsSchema, CodegenOutputSchema, DocsOutputSchema;
 var init_semantics = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/llm/src/semantics.ts"() {
+  "packages/llm/src/semantics.ts"() {
     "use strict";
     PropTypeSchema = z7.discriminatedUnion("kind", [
       z7.object({ kind: z7.literal("enum"), values: z7.array(z7.string()).min(1) }),
@@ -6130,10 +6327,10 @@ var init_semantics = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/llm/src/golden/button.ts
+// packages/llm/src/golden/button.ts
 var goldenButtonSemantics, goldenButtonCode, goldenButtonDocs;
 var init_button2 = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/llm/src/golden/button.ts"() {
+  "packages/llm/src/golden/button.ts"() {
     "use strict";
     goldenButtonSemantics = {
       componentName: "Button",
@@ -6291,7 +6488,7 @@ handling come from the platform.
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/llm/src/prompt.ts
+// packages/llm/src/prompt.ts
 function buildStablePrefix(input) {
   const tokens = [...input.tokenLines].sort().join("\n");
   const golden = `GOLDEN EXAMPLE (canonical quality bar)
@@ -6325,7 +6522,7 @@ ${input.irJson}` });
 }
 var SYSTEM_RULES;
 var init_prompt = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/llm/src/prompt.ts"() {
+  "packages/llm/src/prompt.ts"() {
     "use strict";
     init_button2();
     SYSTEM_RULES = `You generate production React components from a design-system IR.
@@ -6421,10 +6618,10 @@ strictly in the requested JSON shape.`;
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/llm/src/generation-model.ts
+// packages/llm/src/generation-model.ts
 var MockGenerationModel, MAX_SCHEMA_ATTEMPTS, OpenRouterGenerationModel;
 var init_generation_model = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/llm/src/generation-model.ts"() {
+  "packages/llm/src/generation-model.ts"() {
     "use strict";
     init_openrouter();
     init_prompt();
@@ -6581,9 +6778,9 @@ ${JSON.stringify(semantics)}`,
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/llm/src/index.ts
+// packages/llm/src/index.ts
 var init_src5 = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/llm/src/index.ts"() {
+  "packages/llm/src/index.ts"() {
     "use strict";
     init_model_config();
     init_openrouter();
@@ -6594,11 +6791,11 @@ var init_src5 = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/metadata/src/component-json.ts
+// packages/metadata/src/component-json.ts
 import { z as z8 } from "zod";
 var TokenUseSchema, AntiPatternSchema, ComponentJsonSchema;
 var init_component_json = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/metadata/src/component-json.ts"() {
+  "packages/metadata/src/component-json.ts"() {
     "use strict";
     TokenUseSchema = z8.object({
       /** DTCG token path, e.g. "color.primary". */
@@ -6650,7 +6847,7 @@ var init_component_json = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/metadata/src/extract.ts
+// packages/metadata/src/extract.ts
 import { parse } from "react-docgen";
 function extractProps(tsxSource, filename) {
   const docs = parse(tsxSource, { filename });
@@ -6723,13 +6920,13 @@ function buildComponentJson(input) {
   });
 }
 var init_extract = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/metadata/src/extract.ts"() {
+  "packages/metadata/src/extract.ts"() {
     "use strict";
     init_component_json();
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/metadata/src/recording-set.ts
+// packages/metadata/src/recording-set.ts
 import { z as z9 } from "zod";
 function roleLossToken(loss) {
   return loss.kind === "main" ? `main:${loss.main}` : `part:${loss.part}${EDGE_ARROW}${loss.main}`;
@@ -6790,7 +6987,7 @@ function validateRecordingSet(manifest, fileExists) {
 }
 var RECORDING_SET_VERSION, EnvelopeSchema, RepEntrySchema, RolesSchema, EDGE_ARROW, RecordingSetManifestSchema, REQUIRED_REP_FILES;
 var init_recording_set = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/metadata/src/recording-set.ts"() {
+  "packages/metadata/src/recording-set.ts"() {
     "use strict";
     RECORDING_SET_VERSION = 1;
     EnvelopeSchema = z9.object({
@@ -6851,7 +7048,7 @@ var init_recording_set = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/metadata/src/bundle.ts
+// packages/metadata/src/bundle.ts
 import { z as z10 } from "zod";
 function readBundleManifest(raw) {
   if (Buffer.byteLength(raw, "utf8") > MAX_BUNDLE_MANIFEST_BYTES) {
@@ -6920,7 +7117,7 @@ function hashRecordingSet(relPaths, readFile, sha256) {
 }
 var BUNDLE_VERSION, ConfigStatusSchema, PinnedPropSchema, PropAdapterSchema, RequiredFontSchema, ConfigClaimSchema, BehaviorClaimSchema, BundleProvenanceSchema, BundleComponentJsonSchema, MAX_BUNDLE_MANIFEST_BYTES, MAX_BUNDLE_SOURCE_BYTES;
 var init_bundle = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/metadata/src/bundle.ts"() {
+  "packages/metadata/src/bundle.ts"() {
     "use strict";
     init_recording_set();
     BUNDLE_VERSION = 1;
@@ -7018,9 +7215,9 @@ var init_bundle = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/metadata/src/index.ts
+// packages/metadata/src/index.ts
 var init_src6 = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/metadata/src/index.ts"() {
+  "packages/metadata/src/index.ts"() {
     "use strict";
     init_component_json();
     init_extract();
@@ -7029,7 +7226,7 @@ var init_src6 = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/activate.ts
+// packages/cli/src/commands/activate.ts
 var activate_exports = {};
 __export(activate_exports, {
   ENTITLEMENT_SERVICE_URL: () => ENTITLEMENT_SERVICE_URL,
@@ -7054,7 +7251,7 @@ async function runActivate(flags) {
     fail(flags, ExitCode.Auth, {
       error: `could not start activation: ${err instanceof Error ? err.message : String(err)}`,
       code: "entitlement-service-unreachable",
-      remediation: "Check your connection and retry `tendril activate`."
+      remediation: `Check your connection and retry \`${tendrilCommand("activate")}\`.`
     });
   }
   process.stderr.write(`To activate Tendril, visit:
@@ -7081,7 +7278,7 @@ Waiting for approval\u2026
       fail(flags, ExitCode.Auth, {
         error: `activation was not approved (HTTP ${res.status})`,
         code: "entitlement-denied",
-        remediation: "Retry `tendril activate`; if it persists, check the account's plan in the portal."
+        remediation: `Retry \`${tendrilCommand("activate")}\`; if it persists, check the account's plan in the portal.`
       });
     }
     token = (await res.json()).token;
@@ -7091,7 +7288,7 @@ Waiting for approval\u2026
     fail(flags, ExitCode.Auth, {
       error: "activation timed out before the browser approval arrived",
       code: "entitlement-timeout",
-      remediation: "Run `tendril activate` again and complete the browser step within the shown window."
+      remediation: `Run \`${tendrilCommand("activate")}\` again and complete the browser step within the shown window.`
     });
   }
   const parsed = parseEntitlementToken(token);
@@ -7099,7 +7296,7 @@ Waiting for approval\u2026
     fail(flags, ExitCode.Auth, {
       error: `service returned an unusable token: ${parsed.error}`,
       code: "entitlement-invalid",
-      remediation: "Retry `tendril activate`; report this if it persists \u2014 it is a service-side fault."
+      remediation: `Retry \`${tendrilCommand("activate")}\`; report this if it persists \u2014 it is a service-side fault.`
     });
   }
   if (Object.keys(PUBLIC_KEYS).length > 0) {
@@ -7114,23 +7311,26 @@ Waiting for approval\u2026
 }
 var ENTITLEMENT_SERVICE_URL;
 var init_activate = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/activate.ts"() {
+  "packages/cli/src/commands/activate.ts"() {
     "use strict";
     init_src3();
     init_entitlement();
+    init_invocation();
     init_output();
     ENTITLEMENT_SERVICE_URL = void 0;
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/record.ts
+// packages/cli/src/commands/record.ts
 var record_exports = {};
 __export(record_exports, {
   instanceLeads: () => instanceLeads,
+  interactionDisclosure: () => interactionDisclosure,
   isFigmaAssetUrl: () => isFigmaAssetUrl,
   isLocalAssetUrl: () => isLocalAssetUrl,
   narrowedRoles: () => narrowedRoles,
   nextPayload: () => nextPayload,
+  recordsInteractionState: () => recordsInteractionState,
   runRecordAsset: () => runRecordAsset,
   runRecordFetch: () => runRecordFetch,
   runRecordFinish: () => runRecordFinish,
@@ -7140,10 +7340,30 @@ __export(record_exports, {
   runRecordPlan: () => runRecordPlan,
   runRecordStatus: () => runRecordStatus
 });
-import { existsSync as existsSync19, mkdtempSync as mkdtempSync2, readFileSync as readFileSync16, readdirSync as readdirSync5 } from "node:fs";
+import { existsSync as existsSync20, mkdtempSync as mkdtempSync2, readFileSync as readFileSync16, readdirSync as readdirSync5 } from "node:fs";
 import os5 from "node:os";
-import path25 from "node:path";
+import path26 from "node:path";
 import { writeFileSync as writeFileSync9 } from "node:fs";
+function recordsInteractionState(reports) {
+  const evident = (s) => stateTokens(s).some((t) => INTERACTION_EVIDENCE_VALUES.has(t));
+  return reports.some((r) => evident(r.axis) || r.domain.some(evident));
+}
+function interactionDisclosure(component, reports) {
+  const recordedVariants = reports.map((r) => ({ axis: r.axis, values: r.domain }));
+  const variantSummary = recordedVariants.length === 0 ? "" : recordedVariants.length === 1 ? `${recordedVariants[0].axis} variants for ${andList(recordedVariants[0].values)}` : `variants for ${andList(recordedVariants.map((v) => `${v.axis} (${andList(v.values)})`))}`;
+  const has = recordedVariants.length > 0;
+  const statement = `Your ${component} component ${has ? `has ${variantSummary} \u2014 but none of them is a hover, focus or pressed state` : "has no variants at all, so none of it is a hover, focus or pressed state"}. Nothing in the recording shows how ${component} looks when someone hovers it, tabs to it, or is using it, so Tendril has no picture of those to check the build against. Tendril still builds controls as real, working controls \u2014 never a static lookalike \u2014 and, with no focus state recorded, it uses the browser's own focus indicator rather than inventing a focus ring. You do not need to answer this: recording carries on either way.`;
+  const designFix = `If ${component} should look different when it is focused or hovered, that change belongs in Figma rather than in the code: add a Focus (or Hover) variant to the ${component} component set, record it, and Tendril will match it exactly. If ${component} is not something people interact with, there is nothing to do.`;
+  return {
+    component,
+    recordedVariants,
+    variantSummary,
+    statement,
+    designFix,
+    instruction: "DISCLOSURE, not a question. Say `statement` and `designFix` to a present user at PLAN time, in the SAME message as defaultsToConfirm and every other plan-time question \u2014 one message per session, never one per component and never mid-generation. No answer is required and nothing blocks; proceed with recording whatever they say. State ONLY what `recordedVariants` contains: never infer from the component's NAME what kind of control it is. Non-interactive runs: put the statement in your report.",
+    blocking: false
+  };
+}
 function symbolsFromMetadataEnvelope(file, sourceFrame) {
   const env = JSON.parse(readFileSync16(file, "utf8"));
   const text = env.content.map((c) => c.text ?? "").join("\n");
@@ -7203,7 +7423,7 @@ function runRecordPlan(opts) {
   if (rawFile !== void 0) {
     try {
       const envelope = rawEnvelopeFromFile(rawFile, opts.metadataRawPartsFile !== void 0);
-      const tmp = path25.join(mkdtempSync2(path25.join(os5.tmpdir(), "tendril-plan-meta-")), "get_metadata.json");
+      const tmp = path26.join(mkdtempSync2(path26.join(os5.tmpdir(), "tendril-plan-meta-")), "get_metadata.json");
       writeFileSync9(tmp, JSON.stringify(envelope));
       metadataEntries.push({ file: tmp });
     } catch (err) {
@@ -7225,7 +7445,7 @@ function runRecordPlan(opts) {
   let metadataTruncated = false;
   for (const { file, frame } of metadataEntries) {
     try {
-      const parsed = symbolsFromMetadataEnvelope(path25.resolve(file), frame);
+      const parsed = symbolsFromMetadataEnvelope(path26.resolve(file), frame);
       symbols.push(...parsed.symbols);
       if (parsed.truncated) metadataTruncated = true;
     } catch (err) {
@@ -7258,7 +7478,7 @@ function runRecordPlan(opts) {
   if (symbols.length === 0) {
     const leads = metadataEntries.flatMap(({ file }) => {
       try {
-        const env = JSON.parse(readFileSync16(path25.resolve(file), "utf8"));
+        const env = JSON.parse(readFileSync16(path26.resolve(file), "utf8"));
         return instanceLeads(env.content.map((c) => c.text ?? "").join("\n"));
       } catch {
         return [];
@@ -7297,8 +7517,47 @@ function runRecordPlan(opts) {
   const { manifest, plan, resumed, toppedUp } = planSet(opts.setDir, opts.component, symbols, { ...Object.keys(defaults).length > 0 ? { defaults } : {}, ...opts.sample === true ? { sample: true } : {} });
   const defaultReports = reportAxisDefaults(symbols, Object.keys(defaults).length > 0 ? defaults : void 0);
   const toConfirm = resumed ? [] : defaultReports.filter((r) => (r.rule === "non-interaction" || r.rule === "frequency") && r.domain.length > 1);
-  const callLow = manifest.reps.length * 3;
-  const callHigh = manifest.reps.length * 4;
+  const interactionStatesToConfirm = recordsInteractionState(defaultReports) ? void 0 : interactionDisclosure(manifest.component, defaultReports);
+  const poses = manifest.reps.length;
+  const callLow = poses * FIGMA_CALLS_PER_REP;
+  const callHigh = poses * FIGMA_CALLS_PER_REP_WORST;
+  const posesRemaining = sessionStatus(opts.setDir).reps.filter((r) => r.missing.length > 0).length;
+  const callsNeeded = posesRemaining * FIGMA_CALLS_PER_REP;
+  const callSentence = posesRemaining === poses ? `${poses} poses \xD7 ${FIGMA_CALLS_PER_REP} calls per pose = ${callsNeeded} Figma calls` : `${posesRemaining} poses still to record \xD7 ${FIGMA_CALLS_PER_REP} calls per pose = ${callsNeeded} Figma calls (${poses - posesRemaining} of ${poses} already on disk)`;
+  const arithmetic = `${callSentence} (up to ${posesRemaining * FIGMA_CALLS_PER_REP_WORST} if screenshots or assets need a second fetch)`;
+  const multiDay = callsNeeded > MULTI_DAY_CALL_THRESHOLD;
+  const feasibilityCheck = {
+    arithmetic,
+    callsNeeded,
+    callsWorstCase: posesRemaining * FIGMA_CALLS_PER_REP_WORST,
+    posesToRecord: posesRemaining,
+    callsPerPose: FIGMA_CALLS_PER_REP,
+    instruction: "BEFORE the first recording call, call the Figma MCP `whoami` tool \u2014 it names the seat and plan and is EXEMPT from Figma's tool-call limits, so this check costs nothing and spends no quota. Read the daily tool-call allowance for that seat/plan and divide: callsNeeded \xF7 allowance = days this set needs. Tendril owns the multiplication above; the allowance is Figma's and is theirs to change, so take it from whoami and never from memory.",
+    surface: multiDay ? "This set exceeds every daily allowance we have heard of, so it CANNOT finish in one day. State the verdict to the user in plain numbers BEFORE recording anything and let them choose from `options` \u2014 do not start on the assumption it will fit." : "Say nothing about cost if the division fits inside one day's allowance \u2014 a set that comfortably fits is not worth the user's attention. Surface the verdict and `options` only when it does not fit.",
+    verdictTemplate: `${callSentence}. Your <seat> seat on <plan> allows <allowance>/day. This set needs about <days> day(s) at that rate.`,
+    options: [
+      {
+        id: "pace",
+        decidedBy: "user, and you can carry it out",
+        text: "Spread the recording across days, staying inside the daily allowance. Nothing is lost at a limit: the set persists after every pose and re-running the same command resumes from disk, so a rate limit costs waiting, never recorded work."
+      },
+      {
+        id: "sample",
+        // Sampling trades away lattice coverage, so it stays a human
+        // decision structurally, not by instruction: it exists only as
+        // a CLI flag and the MCP surface has no parameter for it.
+        decidedBy: "HUMAN ONLY \u2014 offer it, never choose it, and you cannot run it",
+        text: "Record a reduced pose set (anchor + one-factor sweeps + conflict crosses) instead of the full variant matrix. This buys calls with coverage \u2014 sampling is blind to multi-axis interactions and the report discloses the poses it skipped \u2014 so only the user may accept that trade. There is no tool parameter for it; the user runs it themselves in their own terminal, before any pose is recorded.",
+        userRuns: [`rm ${path26.join(opts.setDir, "recording-set.json")}`, `${tendrilCommand(`record plan --set ${opts.setDir} --component ${manifest.component}`)} --sample`]
+      },
+      {
+        id: "larger-allowance",
+        decidedBy: "user",
+        text: "A seat or plan with a larger daily allowance, if their organisation allows it. Figma's terms, not ours \u2014 state it as an option, never as advice to spend money."
+      }
+    ],
+    limitHintIfWhoamiIsSilent: LIMIT_HINT
+  };
   emitData(
     opts,
     {
@@ -7314,11 +7573,19 @@ function runRecordPlan(opts) {
       ...metadataTruncated ? { metadataTruncated: true } : {},
       ...toppedUp !== void 0 ? { toppedUp } : {},
       notRecorded: manifest.notRecorded ?? null,
-      figmaCallEstimate: { reps: manifest.reps.length, calls: `~${callLow}\u2013${callHigh}` },
+      // The whole-set ledger, numbers only — what recording this queue
+      // from nothing costs. What it costs FROM HERE, and what to do
+      // about it, is feasibilityCheck's job.
+      figmaCallEstimate: { reps: poses, callsPerRep: FIGMA_CALLS_PER_REP, calls: `~${callLow}\u2013${callHigh}`, callsMin: callLow, callsMax: callHigh },
+      // A sibling of defaultsToConfirm: a handshake the agent completes
+      // with the user before the queue costs anything, not a field to
+      // relay as duration.
+      feasibilityCheck,
       // Cold-start fix (run 7): the first instruction rides the plan
       // response, so record_next is never needed to begin — it exists
       // only for resuming.
       next: nextPayload(opts.setDir),
+      ...interactionStatesToConfirm !== void 0 ? { interactionStatesToConfirm } : {},
       ...toConfirm.length > 0 ? {
         defaultsToConfirm: {
           instruction: "HEURISTIC defaults: the designer named no literal Default and no override was given, so the code guessed the component's zero point \u2014 the pose an empty-props mount shows and the pose behaviour checks aim at. When a USER is present, ask each question below BEFORE recording; if they pick a different value, re-run this exact plan command with --default <Axis>=<Value> (allowed until the first envelope is ingested; frozen with the recording after). Non-interactive: proceed with the resolved values and state them in your report.",
@@ -7331,6 +7598,42 @@ function runRecordPlan(opts) {
       } : {}
     },
     () => {
+      const writeFeasibility = () => {
+        if (callsNeeded === 0) return;
+        process.stdout.write(`recording cost: ${arithmetic}
+`);
+        if (multiDay) {
+          process.stdout.write(`FEASIBILITY: ${callsNeeded} calls exceeds every daily Figma allowance we have heard of \u2014 this CANNOT finish in one day.
+`);
+          process.stdout.write(`  ask Figma whoami (free \u2014 exempt from tool-call limits) for this seat's daily allowance, divide ${callsNeeded} by it, and say how many DAYS this needs before recording
+`);
+          process.stdout.write(`  (a) pace it across days \u2014 the set persists after every pose, so a rate limit costs waiting, never recorded work
+`);
+          process.stdout.write(`  (b) record fewer poses \u2014 YOUR call, not an agent's: delete recording-set.json and re-plan with --sample (buys calls with coverage)
+`);
+          process.stdout.write(`  (c) a seat or plan with a larger daily allowance
+`);
+        } else {
+          process.stdout.write(`FEASIBILITY: check ${callsNeeded} against this seat's daily Figma allowance (ask whoami \u2014 it is free) before recording; it only needs raising if it does not fit
+`);
+        }
+      };
+      const writeInteraction = () => {
+        if (interactionStatesToConfirm === void 0) return;
+        const d = interactionStatesToConfirm;
+        process.stdout.write(
+          `CONFIRM   states: ${d.component} records no hover, focus or pressed state${d.recordedVariants.length > 0 ? ` \u2014 it has ${d.variantSummary}` : " (it has no variants at all)"}
+`
+        );
+        process.stdout.write(`  nothing in the recording shows how it looks when someone hovers it, tabs to it, or is using it
+`);
+        process.stdout.write(`  Tendril still builds controls as real controls \u2014 never a static lookalike \u2014 and uses the browser's own focus indicator instead of inventing a focus ring
+`);
+        process.stdout.write(`  want a focus ring of your own? add a Focus variant to the ${d.component} component set in Figma and record again \u2014 Tendril will match it exactly
+`);
+        process.stdout.write(`  nothing to answer \u2014 recording carries on either way
+`);
+      };
       if (resumed) {
         if (opts.sample === true && (manifest.planMode ?? "sample") === "full") {
           process.stdout.write("NOTE: --sample has no effect on a resumed full-matrix set \u2014 delete recording-set.json to re-plan sampled (partial coverage is a deliberate choice)\n");
@@ -7344,18 +7647,20 @@ function runRecordPlan(opts) {
           process.stdout.write(`resumed existing plan (${manifest.reps.length} reps, ${manifest.planMode ?? "sample"} mode) \u2014 delete recording-set.json to re-plan
 `);
         }
+        writeFeasibility();
+        writeInteraction();
         return;
       }
       for (const r of plan.reps) process.stdout.write(`planned ${r.slug.padEnd(24)} ${r.nodeId} (${r.tier})
 `);
       if (plan.notRecorded.length > 0) process.stdout.write(`not recorded (${plan.notRecorded.length}): disclosed in the manifest
 `);
-      process.stdout.write(`estimated recording cost: ~${callLow}\u2013${callHigh} Figma calls for ${manifest.reps.length} reps
-`);
+      writeFeasibility();
       for (const q2 of toConfirm) {
         process.stdout.write(`CONFIRM   ${q2.axis}: default resolved to "${q2.value}" by heuristic (${q2.rule}) \u2014 ask the user; change with --default before recording
 `);
       }
+      writeInteraction();
     }
   );
 }
@@ -7363,7 +7668,7 @@ 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 && !existsSync19(path25.join(setDir, "get_variable_defs.json"))) {
+  if (instruction === null && !existsSync20(path26.join(setDir, "get_variable_defs.json"))) {
     const manifest = loadManifest(setDir);
     const frameNode = Object.keys(manifest.sourceFrames ?? {})[0] ?? manifest.reps[0]?.nodeId ?? "";
     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 };
@@ -7380,7 +7685,7 @@ function runRecordNext(opts) {
     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>
+  \u2192 then: ${tendrilCommand(`record ingest --set ${path26.resolve(opts.setDir)} --rep ${payload["slug"]} --tool ${payload["tool"]} --file <envelope.json>`)}
 `);
   });
 }
@@ -7454,7 +7759,7 @@ async function autoFetchAssets(setDir, rep, envelopeText2) {
   const skipped = [];
   const failed = [];
   for (const { url, name } of assetUrlsFromEnvelopeText(envelopeText2)) {
-    if (existsSync19(path25.join(setDir, rep, name))) {
+    if (existsSync20(path26.join(setDir, rep, name))) {
       skipped.push(name);
       continue;
     }
@@ -7476,16 +7781,16 @@ async function autoFetchAssets(setDir, rep, envelopeText2) {
 }
 function rawEnvelopeFromFile(file, parts) {
   if (parts) {
-    const blocks = JSON.parse(readFileSync16(path25.resolve(file), "utf8"));
+    const blocks = JSON.parse(readFileSync16(path26.resolve(file), "utf8"));
     if (!Array.isArray(blocks) || blocks.length === 0 || blocks.some((p) => typeof p !== "string")) throw new Error("parts file must be a non-empty JSON array of strings");
     return { content: blocks.map((text) => ({ type: "text", text })) };
   }
-  return { content: [{ type: "text", text: readFileSync16(path25.resolve(file), "utf8") }] };
+  return { content: [{ type: "text", text: readFileSync16(path26.resolve(file), "utf8") }] };
 }
 async function runRecordIngest(opts) {
   let payload;
   try {
-    payload = opts.rawParts === true || opts.raw === true ? rawEnvelopeFromFile(opts.file, opts.rawParts === true) : JSON.parse(readFileSync16(path25.resolve(opts.file), "utf8"));
+    payload = opts.rawParts === true || opts.raw === true ? rawEnvelopeFromFile(opts.file, opts.rawParts === true) : JSON.parse(readFileSync16(path26.resolve(opts.file), "utf8"));
   } catch (err) {
     fail(opts, ExitCode.InputValidation, {
       error: `cannot read envelope file: ${err instanceof Error ? err.message : String(err)}`,
@@ -7497,7 +7802,7 @@ async function runRecordIngest(opts) {
     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."
+      remediation: `Use \`${tendrilCommand(`record fetch --set ${path26.resolve(opts.setDir)} --rep ${opts.rep} --tool ${opts.tool} --url <image_url>`)}\` instead.`
     });
   }
   if (opts.rep === "__set__" && opts.tool === "get_variable_defs") {
@@ -7509,7 +7814,15 @@ async function runRecordIngest(opts) {
         remediation: "Save the get_variable_defs response verbatim as a text envelope."
       });
     }
-    writeFileSync9(path25.join(opts.setDir, "get_variable_defs.json"), `${JSON.stringify(payload, null, 1)}
+    const content = checkEnvelopeContent("get_variable_defs", payload);
+    if (!content.ok) {
+      fail(opts, ExitCode.InputValidation, {
+        error: `set-level get_variable_defs was NOT recorded \u2014 ${content.reason}`,
+        code: "envelope-rejected",
+        remediation: REINGEST_GUIDANCE
+      });
+    }
+    writeFileSync9(path26.join(opts.setDir, "get_variable_defs.json"), `${JSON.stringify(payload, null, 1)}
 `);
     emitData(opts, { ingested: "get_variable_defs", rep: "__set__", setLevel: true, next: nextPayload(opts.setDir) }, () => {
       process.stdout.write("set-level get_variable_defs ingested\n");
@@ -7525,7 +7838,7 @@ async function runRecordIngest(opts) {
       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
+        for (const f of assets.failed) process.stdout.write(`  ASSET FAILED ${f.name}: ${f.reason} \u2014 download it, then: ${tendrilCommand(`record asset --set ${path26.resolve(opts.setDir)} --rep ${opts.rep} --name ${f.name} --file <downloaded-file>`)}
 `);
       }
     });
@@ -7533,7 +7846,7 @@ async function runRecordIngest(opts) {
     fail(opts, ExitCode.InputValidation, {
       error: err instanceof Error ? err.message : String(err),
       code: "envelope-rejected",
-      remediation: "The envelope failed boundary validation \u2014 record the tool response again, verbatim, and re-ingest."
+      remediation: "Fix what the error names, then re-run this exact command \u2014 recording resumes from disk, so nothing already recorded is lost."
     });
   }
 }
@@ -7598,14 +7911,14 @@ async function runRecordIngestRep(opts) {
     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
+      for (const f of assets.failed) process.stdout.write(`  ASSET FAILED ${f.name}: ${f.reason} \u2014 download it, then: ${tendrilCommand(`record asset --set ${path26.resolve(opts.setDir)} --rep ${opts.rep} --name ${f.name} --file <downloaded-file>`)}
 `);
     }
   });
 }
 function runRecordAsset(opts) {
   if (opts.dir !== void 0) {
-    const dir = path25.resolve(opts.dir);
+    const dir = path26.resolve(opts.dir);
     const names = readdirSync5(dir).filter((f) => /^asset-[\w.-]+\.(svg|png|jpe?g|webp|gif)$/i.test(f));
     if (names.length === 0) {
       fail(opts, ExitCode.InputValidation, {
@@ -7617,7 +7930,7 @@ function runRecordAsset(opts) {
     const ingested = [];
     try {
       for (const name of names) {
-        ingestAsset(opts.setDir, opts.rep, name, readFileSync16(path25.join(dir, name)));
+        ingestAsset(opts.setDir, opts.rep, name, readFileSync16(path26.join(dir, name)));
         ingested.push(name);
       }
     } catch (err) {
@@ -7637,11 +7950,11 @@ function runRecordAsset(opts) {
     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>"
+      remediation: tendrilCommand(`record asset --set ${path26.resolve(opts.setDir)} --rep ${opts.rep} --dir <downloads-dir>`)
     });
   }
   try {
-    ingestAsset(opts.setDir, opts.rep, opts.name, readFileSync16(path25.resolve(opts.file)));
+    ingestAsset(opts.setDir, opts.rep, opts.name, readFileSync16(path26.resolve(opts.file)));
     emitData(opts, { rep: opts.rep, asset: opts.name }, () => {
       process.stdout.write(`ingested ${opts.rep}/${opts.name}
 `);
@@ -7677,7 +7990,7 @@ function narrowedRoles(derived, override) {
 function rolesFromFile(opts, file, derived) {
   let json;
   try {
-    json = JSON.parse(readFileSync16(path25.resolve(file), "utf8"));
+    json = JSON.parse(readFileSync16(path26.resolve(file), "utf8"));
   } catch (err) {
     fail(opts, ExitCode.InputValidation, {
       error: `cannot read roles file ${file}: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}`,
@@ -7715,11 +8028,11 @@ function rolesFromFile(opts, file, derived) {
   };
 }
 function runRecordFinish(opts) {
-  if (!existsSync19(path25.join(opts.setDir, "recording-set.json"))) {
+  if (!existsSync20(path26.join(opts.setDir, "recording-set.json"))) {
     fail(opts, ExitCode.InputValidation, {
       error: `no recording-set.json in ${opts.setDir}`,
       code: "no-recording-set",
-      remediation: `Run \`tendril record plan --set ${opts.setDir} --component <name> --metadata <envelope.json>\` first \u2014 \`record finish\` closes a set the planner opened.`
+      remediation: `Run \`${tendrilCommand(`record plan --set ${path26.resolve(opts.setDir)} --component <name> --metadata <envelope.json>`)}\` first \u2014 \`record finish\` closes a set the planner opened.`
     });
   }
   const { manifest, raw } = readManifestFile(opts.setDir);
@@ -7747,17 +8060,17 @@ function runRecordFinish(opts) {
     fail(opts, ExitCode.ConfirmationRequired, {
       error: "--confirm-roles (and --roles-file) require an interactive terminal \u2014 this confirmation is human-only",
       code: "roles-confirmation-not-interactive",
-      remediation: "A human runs `tendril record finish --set <dir> --confirm-roles` in their own terminal. Agents: show the proposal to your operator instead of confirming it."
+      remediation: `A human runs \`${tendrilCommand(`record finish --set ${path26.resolve(opts.setDir)} --confirm-roles`)}\` in their own terminal. Agents: show the proposal to your operator instead of confirming it.`
     });
   }
   const merged = { ...raw, roles };
-  const { issues } = validateRecordingSet(merged, (rel) => existsSync19(path25.join(opts.setDir, rel)));
+  const { issues } = validateRecordingSet(merged, (rel) => existsSync20(path26.join(opts.setDir, rel)));
   const errors = issues.filter((i) => i.severity === "error");
   if (errors.length > 0) {
     fail(opts, ExitCode.InputValidation, {
       error: `recording set rejected \u2014 roles NOT written: ${errors.map((e) => e.message).join("; ")}`,
       code: "recording-set-invalid",
-      remediation: "Fix the set (`tendril record status --set <dir>` lists missing envelopes) or the roles graph, then re-run `record finish`."
+      remediation: `Fix the set (\`${tendrilCommand(`record status --set ${path26.resolve(opts.setDir)}`)}\` lists missing envelopes) or the roles graph, then re-run \`record finish\`.`
     });
   }
   for (const issue of issues) if (issue.severity === "warning") warn(opts, issue.message);
@@ -7768,29 +8081,49 @@ function runRecordFinish(opts) {
 `);
   }
 }
-var ENVELOPE_HELP, isAutoFetchAssetUrl, describeRoleLoss;
+var FIGMA_CALLS_PER_REP, FIGMA_CALLS_PER_REP_WORST, MULTI_DAY_CALL_THRESHOLD, LIMIT_HINT, stateTokens, MAX_SPOKEN_VALUES, andList, ENVELOPE_HELP, isAutoFetchAssetUrl, describeRoleLoss;
 var init_record = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/record.ts"() {
+  "packages/cli/src/commands/record.ts"() {
     "use strict";
     init_src3();
     init_src();
     init_src6();
     init_output();
     init_entitlement();
-    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.';
+    init_invocation();
+    FIGMA_CALLS_PER_REP = 3;
+    FIGMA_CALLS_PER_REP_WORST = 4;
+    MULTI_DAY_CALL_THRESHOLD = 600;
+    LIMIT_HINT = {
+      status: "UNVERIFIED \u2014 recorded 2026-08-14 from Figma's published documentation and one field report; Figma changes these at will.",
+      use: "Use ONLY if whoami states no allowance, and say it is unverified when you show it. The allowance whoami reports always wins.",
+      perDayByPlan: {
+        "Dev/Full seat, Professional": "~200 tool calls/day",
+        "Dev/Full seat, Organization or Enterprise": "~600 tool calls/day",
+        Starter: "~6 tool calls/month"
+      },
+      burst: "A per-minute ceiling is documented alongside the daily one, so parallel recorders can trip a limit long before the daily budget runs out."
+    };
+    stateTokens = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").split("-").filter((t) => t !== "");
+    MAX_SPOKEN_VALUES = 6;
+    andList = (items) => {
+      const shown = items.length <= MAX_SPOKEN_VALUES ? items : [...items.slice(0, MAX_SPOKEN_VALUES), `${items.length - MAX_SPOKEN_VALUES} more`];
+      return shown.length <= 1 ? shown[0] ?? "" : `${shown.slice(0, -1).join(", ")} and ${shown[shown.length - 1]}`;
+    };
+    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 \`${tendrilCommand("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);
     describeRoleLoss = (loss) => loss.kind === "main" ? `drops main "${loss.main}"` : `stops "${loss.part}" being a part of main "${loss.main}"`;
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/engine.ts
+// packages/generate/src/engine.ts
 var init_engine = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/engine.ts"() {
+  "packages/generate/src/engine.ts"() {
     "use strict";
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/parse.ts
+// packages/generate/src/parse.ts
 function parseFiles(text, entry) {
   const out = /* @__PURE__ */ new Map();
   const re = /```[a-z]*[^\n]*\n(?:\/\/|\/\*)[ \t]*FILE:[ \t]*([\w.]+)[ \t]*(?:\*\/)?[ \t]*\n([\s\S]*?)```/g;
@@ -7823,15 +8156,15 @@ ${content}\`\`\``);
   return blocks.join("\n");
 }
 var init_parse = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/parse.ts"() {
+  "packages/generate/src/parse.ts"() {
     "use strict";
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/engine-curated.ts
+// packages/generate/src/engine-curated.ts
 var CuratedEngine;
 var init_engine_curated = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/engine-curated.ts"() {
+  "packages/generate/src/engine-curated.ts"() {
     "use strict";
     init_parse();
     CuratedEngine = class {
@@ -7969,9 +8302,9 @@ var init_engine_curated = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/loop.ts
-import { existsSync as existsSync20, mkdirSync as mkdirSync6, readFileSync as readFileSync17, renameSync, writeFileSync as writeFileSync10 } from "node:fs";
-import path26 from "node:path";
+// packages/generate/src/loop.ts
+import { existsSync as existsSync21, mkdirSync as mkdirSync6, readFileSync as readFileSync17, renameSync, writeFileSync as writeFileSync10 } from "node:fs";
+import path27 from "node:path";
 import { z as z11 } from "zod";
 function objective(scores, behaviors) {
   const vals = scores.map((s) => Math.min(s.similarity, s.inkRecall));
@@ -8005,12 +8338,12 @@ ${preludeLines.join("\n")}` : ""}${absentLines.length > 0 ? `
 MISSING FEATURES (absent-ink clusters \u2014 recorded marks your render leaves out or paints invisibly; GATING at the cert bar. Fix the named node's ink \u2014 a config carrying one cannot certify):
 ${absentLines.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). Reading the pair: ink=1 with LOW sim means nothing is missing \u2014 shapes or positions are wrong, do not chase missing ink; LOW ink with high sim means recorded marks are absent or painted invisibly. 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."}`;
+Fix the FAIL configs (region coordinates are in the recorded screenshot's frame; ink<1 means recorded foreground pixels your render does not cover). Reading the pair: ink credits a recorded pixel when ANY render ink lands within 1px of it, so ink=1 proves coverage \u2014 not presence, shape, or colour. A wrong-shaped mark over the right region, or a wrong-coloured one that is still ink, scores 1.000; and a recorded mark within ~30 channel-sum of the backdrop (#f6f6f6 on white is 27) is not ink at all, so it can be absent at ink 1.000 with no MISSING line. With ink=1 AND low sim, coverage held while pixels differ, so start with the TWO causes below \u2014 but never read ink=1 as "nothing is missing": confirm every faint or small recorded mark (hairlines, dividers, low-contrast controls) exists in your render. GEOMETRY: wrong position/size/radius; the diff shows shifted edges and bands. WRONG TEXT WEIGHT OR FACE: the diff shows a uniform haze over glyph runs; CSS binds the font FAMILY before the weight, a later family in the stack is never consulted for a weight the first one lacks, and font-synthesis: none rules out faux-bold \u2014 so a stack led by a family the kit holds at one weight renders every other weight in that face, silently. Check the font stack against the kit's cached faces before concluding geometry is at fault. LOW ink with high sim means recorded marks are absent or painted invisibly. 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 (!existsSync20(path26.join(outDir, "run-log.json")) && !existsSync20(path26.join(outDir, "loop-state.json"))) return void 0;
+  if (!existsSync21(path27.join(outDir, "run-log.json")) && !existsSync21(path27.join(outDir, "loop-state.json"))) return void 0;
   let n = 1;
-  while (existsSync20(`${outDir}-prev-${n}`)) n += 1;
+  while (existsSync21(`${outDir}-prev-${n}`)) n += 1;
   renameSync(outDir, `${outDir}-prev-${n}`);
   return `${outDir}-prev-${n}`;
 }
@@ -8019,14 +8352,14 @@ async function runEngineLoop(opts) {
   const plateau = opts.plateau ?? 2;
   const progress = opts.onProgress ?? (() => {
   });
-  const statePath = path26.join(opts.outDir, "loop-state.json");
-  const resuming = opts.resume === true && existsSync20(statePath);
+  const statePath = path27.join(opts.outDir, "loop-state.json");
+  const resuming = opts.resume === true && existsSync21(statePath);
   if (!resuming) {
     const archived = archivePriorRun(opts.outDir);
     if (archived !== void 0) progress(`previous run archived to ${archived}`);
   }
   mkdirSync6(opts.outDir, { recursive: true });
-  const scratch = path26.join(opts.outDir, ".candidate");
+  const scratch = path27.join(opts.outDir, ".candidate");
   let attempts = [];
   let log = [];
   let best;
@@ -8054,7 +8387,7 @@ async function runEngineLoop(opts) {
   };
   const writeCandidate = (files) => {
     mkdirSync6(scratch, { recursive: true });
-    for (const [name, content] of Object.entries(files)) writeFileSync10(path26.join(scratch, name), content);
+    for (const [name, content] of Object.entries(files)) writeFileSync10(path27.join(scratch, name), content);
   };
   const scoreCandidate = async (candidate, iter, usd, modelMs) => {
     writeCandidate(candidate.files);
@@ -8112,8 +8445,8 @@ async function runEngineLoop(opts) {
       const usd = candidate.usage?.usd ?? 0;
       spentUsd += usd;
       if (candidate.raw !== void 0) {
-        mkdirSync6(path26.join(opts.outDir, "responses"), { recursive: true });
-        writeFileSync10(path26.join(opts.outDir, "responses", `iter-${iter}.md`), candidate.raw);
+        mkdirSync6(path27.join(opts.outDir, "responses"), { recursive: true });
+        writeFileSync10(path27.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 ?? "?";
@@ -8139,10 +8472,10 @@ async function runEngineLoop(opts) {
       }
     }
   }
-  if (best !== void 0) for (const [name, content] of Object.entries(best.files)) writeFileSync10(path26.join(opts.outDir, name), content);
+  if (best !== void 0) for (const [name, content] of Object.entries(best.files)) writeFileSync10(path27.join(opts.outDir, name), content);
   const final = best !== void 0 ? await opts.score(opts.outDir) : { scores: [], behaviors: [] };
   writeFileSync10(
-    path26.join(opts.outDir, "run-log.json"),
+    path27.join(opts.outDir, "run-log.json"),
     `${JSON.stringify(
       {
         ...opts.meta,
@@ -8163,7 +8496,7 @@ async function runEngineLoop(opts) {
 }
 var better, RegionSchema, ConfigScoreSchema, BehaviorResultSchema, LoopStateSchema;
 var init_loop2 = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/loop.ts"() {
+  "packages/generate/src/loop.ts"() {
     "use strict";
     better = (a, b) => a[0] !== b[0] ? a[0] > b[0] : a[1] !== b[1] ? a[1] > b[1] : a[2] > b[2];
     RegionSchema = z11.object({ x0: z11.number(), y0: z11.number(), x1: z11.number(), y1: z11.number(), density: z11.number() });
@@ -8208,9 +8541,9 @@ var init_loop2 = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/brief.ts
-import { existsSync as existsSync21, readFileSync as readFileSync18 } from "node:fs";
-import path27 from "node:path";
+// packages/generate/src/brief.ts
+import { existsSync as existsSync22, readFileSync as readFileSync18 } from "node:fs";
+import path28 from "node:path";
 function singleAxes2(name) {
   const parsed = parseVariantAxes(name);
   if (parsed === void 0) return void 0;
@@ -8369,7 +8702,7 @@ ${propLines.join("\n")}
 
 ${syntheticCombos.length > 0 ? `UNRECORDED REACHABLE COMBINATIONS: the design's exclusive axis cannot express ${syntheticCombos.join(", ")} \u2014 the API split makes them reachable with NO recorded truth. Compose them from the recorded per-axis truth (paint variables: one axis sets, the other consumes), never invent a bespoke look, and list them in your report.
 ` : ""}${slots.length > 0 ? `CONTENT PROPS: every string prop defaults to its RECORDED text \u2014 render the PROP, never a hardcoded literal. Configs pass per-pose recorded strings wherever the recording varies, and pixels enforce them: a hardcoded string fails those configs. Content presence (a heading that only exists in some poses) follows the AXIS props; the string prop only supplies the text. RICH-TEXT DEFAULTS: when the recorded content is a multi-run rich node (mixed weights, an underlined link span) whose concatenation is the prop's default string, a plain-string default would flatten the recorded formatting \u2014 default the parameter to undefined and render the recorded rich markup when the prop is absent; a caller-supplied string then renders plainly. That mirrors the design tool's own emission logic and keeps every recorded pose pixel-exact.
-` : ""}Rules: generated element ids come from React's useId() \u2014 never Math.random() in render/state init (SSR hydration hazard; measured: two same-day bundles disagreed). Plain CSS in styles.css (tokens.css optional, loaded first) \u2014 no Tailwind, no imports beyond react/react-dom, and NEVER import the stylesheet from the entry module: the harness injects tokens.css and styles.css itself, and an entry that imports CSS does not compile here (measured cost: one full round, every config 0). The component renders the RECORDED content as its defaults \u2014 reproduce it from the emissions. ${forcingCanon}${fontsLine}The host sizes nothing: the component is its natural recorded size. FLUIDITY AFFORDANCE (emit it always): every ROOT width declaration rides width: var(--tendril-root-width, <recorded>px) with that pose's recorded width as the fallback \u2014 per-variant root widths reuse the SAME property name with their own recorded fallbacks. With the property unset this is byte-equivalent truth: identical pixels, identical operability measurement (measured: flipping roots to a bare 100% held 20/20 pixels but made a commit check unmeasurable \u2014 the recorded pin carries real signal). A consumer makes an instance fluid by setting --tendril-root-width (e.g. 100%) on a wrapper, no edit to certified CSS. Widths only: recorded heights and internal geometry stay literal \u2014 fixed heights are often genuine design intent.`;
+` : ""}Rules: generated element ids come from React's useId() \u2014 never Math.random() in render/state init (SSR hydration hazard; measured: two same-day bundles disagreed). Plain CSS in styles.css (tokens.css optional, loaded first) \u2014 no Tailwind, no imports beyond react/react-dom, and NEVER import the stylesheet from the entry module: the harness injects tokens.css and styles.css itself, and an entry that imports CSS does not compile here (measured cost: one full round, every config 0). The component renders the RECORDED content as its defaults \u2014 reproduce it from the emissions. ${forcingCanon}${fontsLine}ROOT SIZE IS YOURS AND PIXELS DO NOT CHECK IT, IN EITHER DIRECTION: the mount floors your root to the recorded box (#root > *{min-width:<recorded w>px;min-height:<recorded h>px} \u2014 a floor, never a cap), and the image the scorer compares is a CROP of that box, so paint outside it is never compared at all. Measured through the real scorer against a correct 120x40 root: an UNDERSIZED 80x28 root and OVERSIZED 160x52 and 124x44 roots ALL scored sim 1.000 / ink 1.000 with a byte-identical crop, as long as internals stay literal and top-left anchored. An oversized root shows only when its own border, radius or shadow \u2014 or a re-centred internal layout \u2014 lands back inside the crop. And some roots are not floored at all: a non-replaced INLINE root (a bare <label>, or an <a href> for a link variant) ignores width/height/min-width/min-height entirely and renders content-sized whatever you declare. So take both root dimensions from the recorded box in the payload, and give the root a display that honours them \u2014 no score, passing or failing, is evidence they are right. FLUIDITY AFFORDANCE (emit it always): every ROOT width declaration rides width: var(--tendril-root-width, <recorded>px) with that pose's recorded width as the fallback \u2014 per-variant root widths reuse the SAME property name with their own recorded fallbacks. With the property unset this is byte-equivalent truth: identical pixels, identical operability measurement (measured: flipping roots to a bare 100% held 20/20 pixels but made a commit check unmeasurable \u2014 the recorded pin carries real signal). A consumer makes an instance fluid by setting --tendril-root-width (e.g. 100%) on a wrapper, no edit to certified CSS. Widths only: recorded heights and internal geometry stay literal \u2014 fixed heights are often genuine design intent.`;
   const mappedTokens = /* @__PURE__ */ new Set([...forcedStates, ...props.filter((p) => p.kind === "boolean").map((p) => p.name)]);
   const unmappedInteractionEvidence = interactionEvidence.filter((e) => {
     const sel = e.endsWith(" (selection axis)");
@@ -8449,8 +8782,8 @@ function envelopeText(file) {
 }
 function dismissEvidence(setDir, repSlugs) {
   for (const slug of repSlugs) {
-    const f = path27.join(setDir, slug, "get_design_context.json");
-    if (!existsSync21(f)) continue;
+    const f = path28.join(setDir, slug, "get_design_context.json");
+    if (!existsSync22(f)) continue;
     const text = envelopeText(f);
     const propHit = /[{,]\s*(\w*dismiss\w*)\s*=\s*(?:true|false)\b/i.exec(text) ?? /\b(\w*dismiss\w*)\??\s*:\s*boolean\b/i.exec(text);
     if (propHit !== null) return `emission prop "${propHit[1]}"`;
@@ -8494,13 +8827,13 @@ function recordedFontNeeds(setDir, opts = {}) {
     }
   };
   const manifest = loadManifest(setDir);
-  const setDefs = path27.join(setDir, "get_variable_defs.json");
-  if (existsSync21(setDefs)) fromDefs(envelopeText(setDefs));
+  const setDefs = path28.join(setDir, "get_variable_defs.json");
+  if (existsSync22(setDefs)) fromDefs(envelopeText(setDefs));
   for (const rep of manifest.reps) {
-    const ctx = path27.join(setDir, rep.slug, "get_design_context.json");
-    if (existsSync21(ctx)) fromEmission(envelopeText(ctx));
-    const defs = path27.join(setDir, rep.slug, "get_variable_defs.json");
-    if (existsSync21(defs)) fromDefs(envelopeText(defs));
+    const ctx = path28.join(setDir, rep.slug, "get_design_context.json");
+    if (existsSync22(ctx)) fromEmission(envelopeText(ctx));
+    const defs = path28.join(setDir, rep.slug, "get_variable_defs.json");
+    if (existsSync22(defs)) fromDefs(envelopeText(defs));
   }
   return [...byFamily.entries()].map(([family, paired]) => {
     const weights = /* @__PURE__ */ new Set([...paired, ...opts.pairedOnly === true ? [] : unpaired]);
@@ -8511,8 +8844,8 @@ function symbolFontGlyphCount(setDir, reps) {
   const PUA = /[\uE000-\uF8FF\u{F0000}-\u{FFFFD}\u{100000}-\u{10FFFD}]/u;
   const glyphs = /* @__PURE__ */ new Set();
   for (const rep of reps) {
-    const file = path27.join(setDir, rep, "get_metadata.json");
-    if (!existsSync21(file)) continue;
+    const file = path28.join(setDir, rep, "get_metadata.json");
+    if (!existsSync22(file)) continue;
     try {
       const text = JSON.parse(readFileSync18(file, "utf8")).content.map((c) => c.text ?? "").join("\n");
       for (const m of text.matchAll(/<text\s[^>]*name="([^"]*)"/g)) {
@@ -8540,8 +8873,8 @@ function recordedTextSlots(setDir, repSlugs) {
   const propRep = [];
   const perRep = [];
   for (const slug of repSlugs) {
-    const f = path27.join(setDir, slug, "get_design_context.json");
-    if (!existsSync21(f)) continue;
+    const f = path28.join(setDir, slug, "get_design_context.json");
+    if (!existsSync22(f)) continue;
     const code = envelopeText(f);
     const props = /* @__PURE__ */ new Map();
     for (const m of code.matchAll(/[{,]\s*(\w+)\s*=\s*"((?:[^"\\]|\\.)*)"/g)) {
@@ -8566,8 +8899,8 @@ function recordedTextSlots(setDir, repSlugs) {
   }
   const axisValuesBySlug = /* @__PURE__ */ new Map();
   for (const slug of repSlugs) {
-    const metaFile = path27.join(setDir, slug, "get_metadata.json");
-    if (!existsSync21(metaFile)) continue;
+    const metaFile = path28.join(setDir, slug, "get_metadata.json");
+    if (!existsSync22(metaFile)) continue;
     const name = symbolName(envelopeText(metaFile));
     if (name === void 0) continue;
     const values = /* @__PURE__ */ new Set();
@@ -8666,8 +8999,8 @@ function authorTaskFromSet(setDir, opts = {}) {
   const poses = [];
   const missing = [];
   for (const rep of manifest.reps) {
-    const metaFile = path27.join(setDir, rep.slug, "get_metadata.json");
-    if (!existsSync21(metaFile)) {
+    const metaFile = path28.join(setDir, rep.slug, "get_metadata.json");
+    if (!existsSync22(metaFile)) {
       missing.push(rep.slug);
       continue;
     }
@@ -8681,8 +9014,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 = path27.join(setDir, "get_metadata.json");
-  const latticeNames = manifest.latticeNames ?? (existsSync21(setMeta) ? [...envelopeText(setMeta).matchAll(/name="([^"]*)"/g)].map((m) => decodeXmlEntities(m[1])) : void 0);
+  const setMeta = path28.join(setDir, "get_metadata.json");
+  const latticeNames = manifest.latticeNames ?? (existsSync22(setMeta) ? [...envelopeText(setMeta).matchAll(/name="([^"]*)"/g)].map((m) => decodeXmlEntities(m[1])) : void 0);
   const defaults = { ...manifest.defaults ?? {}, ...opts.defaults ?? {} };
   const recordedFonts = recordedFontFamilies(setDir);
   const textSlots = recordedTextSlots(setDir, manifest.reps.map((r) => r.slug));
@@ -8767,7 +9100,7 @@ ALL prose instructions live ABOVE the task payload \u2014 the payload contains o
 
 ASSETS: inline the SVG assets you RENDER byte-verbatim, unchanged \u2014 never redraw or approximate an icon. Recorded assets that no scored config displays may be omitted. Two techniques reconcile that rule with reuse (both measured at 1.000): a glyph recorded once but shown in several colors keeps its bytes (fill attribute included) and is repainted with a CSS fill rule \u2014 a CSS declaration outranks an SVG presentation attribute, so one verbatim copy serves every tone; and multi-part glyphs needing fractional placement can nest each verbatim asset as a child <svg x= y=> inside one integer-origin frame (SVG user-space coordinates are exact), an alternative to the transform: scale() pattern.
 
-GEOMETRY ARBITRATION (when emission styling and the recorded box disagree, the BOX wins): Figma strokes are INSIDE the box \u2014 border+padding sums that overshoot a recorded dimension mean use an inset box-shadow or subtract the border from the padding. That rule covers strokes AT the box edge only: when a config's reference PNG is LARGER than its recorded box, the recording itself proves an OUTWARD effect \u2014 a hover ring, glow, or shadow past the frame \u2014 and the outward part is drawn outward (box-shadow spread, outline), never forced inside. On such configs the score report carries a "seat" field ({x, y} \u2014 where the recorded box sits inside the larger reference), derived from the recording's own effect geometry (shadow offset/radius/spread) \u2014 informational, so an offset shadow's asymmetric bleed is not misread as a registration error. Following strokes-inside against a padded reference contradicts the recorded pad and cost a measured five configs a full round. The harness mounts each config at its recorded box (width \xD7 height, floors not clamps); build to those dimensions, not to guessed viewports. Known rasterizer delta: Chrome often seats small text ONE PIXEL HIGHER than Figma in an identically sized box. Correct it with a PAINT-ONLY offset on those text runs \u2014 position: relative with top: 1px \u2014 never with padding or margin, which would grow the recorded box this same paragraph calls truth. TREAT IT AS A MEASUREMENT, NOT A RULE: measured cases are 12px/16px and 14px/20px needing the nudge and 14px/18px not, so font size alone does not predict it and neither does any formula we can currently defend. RULE ORDER when both could apply (run 7: a config sat 0.0004 under the bar AND showed uniform spread \u2014 the rules pointed opposite ways): read the DIFF FIRST; the uniform-spread stop-rule below OUTRANKS the try-it rule here. Only when the diff shows a shifted band: apply the nudge, re-score, and keep it only if it helped. Four measured signatures, so do not expect one: on one kit it drove ink recall to 1.000; on another ink was already 1.000 and only similarity moved (mean 0.961 \u2192 0.976, four configs from 0.003 above the bar to 0.028); on a third it REGRESSED a passing bundle from 9/9 to 3/9 configs and had to be reverted; on a fourth it made every FAILING config worse too (tinted in-section surfaces: ink dropped ~0.011 across all eight configs and pushed a passing one under the bar). It is a hypothesis to score, never a default \u2014 NEVER apply it to a bundle that already passes, and when the failing family's diff shows a uniform low-density spread across the glyph band rather than a shifted band, the cause is rasterization weight, not seating: the nudge cannot help and a heavier hypothesis has no recorded truth to justify it \u2014 report the honest sub-bar result instead. Design-token NAMES in the payload are Figma names \u2014 canonicalize to valid CSS idents (lowercase kebab, e.g. "Text/text-primary" \u2192 --text-text-primary) if you emit tokens.css; literal values are equally acceptable. NEVER invent a token to satisfy a lint finding: quality findings are advisory, and a recorded value the kit has no token for is CORRECT as a literal \u2014 a made-up token name corrupts the tokens file as a record of the kit.
+GEOMETRY ARBITRATION (when emission styling and the recorded box disagree, the BOX wins): Figma strokes are INSIDE the box \u2014 border+padding sums that overshoot a recorded dimension mean use an inset box-shadow or subtract the border from the padding. That rule covers strokes AT the box edge only: when a config's reference PNG is LARGER than its recorded box, the recording itself proves an OUTWARD effect \u2014 a hover ring, glow, or shadow past the frame \u2014 and the outward part is drawn outward (box-shadow spread, outline), never forced inside. On such configs the score report carries a "seat" field ({x, y} \u2014 where the recorded box sits inside the larger reference), derived from the recording's own effect geometry (shadow offset/radius/spread) \u2014 informational, so an offset shadow's asymmetric bleed is not misread as a registration error. Following strokes-inside against a padded reference contradicts the recorded pad and cost a measured five configs a full round. The harness mounts each config at its recorded box (width \xD7 height) and FLOORS your root to it, never caps it; build to those recorded dimensions, not to guessed viewports \u2014 the prescribed API below says what that floor hides. Known rasterizer delta: Chrome often seats small text ONE PIXEL HIGHER than Figma in an identically sized box. Correct it with a PAINT-ONLY offset on those text runs \u2014 position: relative with top: 1px \u2014 never with padding or margin, which would grow the recorded box this same paragraph calls truth. TREAT IT AS A MEASUREMENT, NOT A RULE: measured cases are 12px/16px and 14px/20px needing the nudge and 14px/18px not, so font size alone does not predict it and neither does any formula we can currently defend. RULE ORDER when both could apply (run 7: a config sat 0.0004 under the bar AND showed uniform spread \u2014 the rules pointed opposite ways): read the DIFF FIRST; the uniform-spread stop-rule below OUTRANKS the try-it rule here. Only when the diff shows a shifted band: apply the nudge, re-score, and keep it only if it helped. Four measured signatures, so do not expect one: on one kit it drove ink recall to 1.000; on another ink was already 1.000 and only similarity moved (mean 0.961 \u2192 0.976, four configs from 0.003 above the bar to 0.028); on a third it REGRESSED a passing bundle from 9/9 to 3/9 configs and had to be reverted; on a fourth it made every FAILING config worse too (tinted in-section surfaces: ink dropped ~0.011 across all eight configs and pushed a passing one under the bar). It is a hypothesis to score, never a default \u2014 NEVER apply it to a bundle that already passes, and when the failing family's diff shows a uniform low-density spread across the glyph band rather than a shifted band, the cause is rasterization weight, not seating: the nudge cannot help and a heavier hypothesis has no recorded truth to justify it \u2014 report the honest sub-bar result instead. Design-token NAMES in the payload are Figma names \u2014 canonicalize to valid CSS idents (lowercase kebab, e.g. "Text/text-primary" \u2192 --text-text-primary) if you emit tokens.css; literal values are equally acceptable. NEVER invent a token to satisfy a lint finding: quality findings are advisory, and a recorded value the kit has no token for is CORRECT as a literal \u2014 a made-up token name corrupts the tokens file as a record of the kit.
 
 RECORDED BOXES ARE TRUTH even when inconsistent: the same string may
 have different recorded widths across variants (designer resizing) \u2014 a
@@ -8784,13 +9117,13 @@ PAINT & PLATFORM TRAPS (each measured on a paid run; every one passed typecheck,
 - A native <dialog> carries user-agent padding: 1em. Override every side, or the root grows past its recorded box and every band inside shifts.
 - THE PAGE CANVAS IS NOT YOURS. Never paint the recording's page background into the component \u2014 no canvas-coloured plates across the root box, no square shadow spread carrying the canvas past the frame. The mount composites your render over the recorded canvas, so transparency wherever the recording shows canvas is both correct and scores correctly; the score report's canvasCoupling counts canvas pixels your render refuses to let the page repaint, and a component that paints the canvas is wrong on every real page.
 - TOKENS SCOPE TO YOUR ROOT CLASS, NEVER :root. Bundles compose on real pages: token names on :root collide across independently generated components and the last stylesheet loaded silently rewrites the others (measured: two colliding names flipped certified surfaces translucent). Declare every token under the component's root class.
-- WHEN TWO AXES BOTH CONTROL PAINT, THEY COMPOSE THROUGH CUSTOM PROPERTIES \u2014 one axis SETS variables, the other CONSUMES them. Direct paint rules on both axes have equal specificity, so source order silently drops one axis for exactly the crossed poses (measured: variant \xD7 tone \u2014 primary+critical rendered dark neutral instead of the recorded red; the sampled scorer never sees crossed poses, so nothing catches it but pixels in use).
+- WHEN TWO AXES BOTH CONTROL PAINT, THEY COMPOSE THROUGH CUSTOM PROPERTIES \u2014 one axis SETS variables, the other CONSUMES them. Direct paint rules on both axes have equal specificity, so source order silently drops one axis for exactly the crossed poses (measured: variant \xD7 tone \u2014 primary+critical rendered dark neutral instead of the recorded red). CROSSED POSES ARE SCORED: the harness mounts every RECORDED pose, crosses included \u2014 measured on a bundle passing 20/20 (13 single-axis configs, 7 crosses), adding one later same-specificity rule left every single-axis config the rule did not itself target byte-stable and dropped all five crossed configs it touched from ~0.99 to sim 0.09\u20130.16. Only a cross with NO recorded pose goes ungraded.
 
 INTERACTION-READY BY DEFAULT: components are real controls, never static lookalikes \u2014 use the native element matching the archetype (button, input[type=radio|checkbox], select\u2026), real handlers, keyboard operability, and real state (checked/disabled/:hover/:focus-visible). Behavioral checks fail statues. (The forcing-hook rule is specified once, in the prescribed API below.) Your file runs in a bare browser bundle: it must be fully self-contained. IMPORT EVERY React API you use explicitly \u2014 e.g. import { useState, useRef, useEffect } from "react" \u2014 nothing is provided globally; a missing import crashes the mount and every config scores 0.
 
 STATE SEMANTICS (prescribed \u2014 do not choose your own):
 - The component OWNS its interaction state, seeded from the prop. A selection/checked prop supplies the INITIAL value; user interaction updates internal state and must visibly commit without any parent re-render. A purely controlled component that ignores its own clicks fails the behavioral checks. Call an on\u2026Change callback when one is in the prescribed API, but never depend on it to update your own paint.
-- Read-only means operable but not committable: the control stays focusable and in the accessibility tree with aria-readonly="true", and cancels commit on both pointer and keyboard. Do NOT use pointer-events:none or disabled to fake it \u2014 both destroy focusability, and disabled means something different.
+- Read-only means operable but not committable: the control stays focusable and in the accessibility tree with aria-readonly="true", and cancels commit on both pointer and keyboard. Do NOT fake it with pointer-events:none or disabled. pointer-events:none removes only the POINTER path \u2014 the element stops being hit-tested, so clicks land on whatever is behind it \u2014 while Tab still reaches it and .focus() still lands: the control still takes focus and still commits from the KEYBOARD (measured in Chrome: Space checked a pointer-events:none checkbox). Of the two, ONLY disabled refuses focus, which is why reaching for pointer-events:none to make a pose unfocusable fails disabled-not-focusable with "disabled element took focus".
 - GEOMETRY FOLLOWS PROPS; ONLY PAINT FOLLOWS LIVE STATE. Per-variant sizing must key off the pose props the caller passed, never off live interaction state \u2014 otherwise clicking resizes the component (a recorded selected/unselected width difference is a designer artifact, not a consequence of selection). The scorer renders static poses and structurally cannot see this, so it is on you.
 
 ${systemApi}
@@ -8801,7 +9134,7 @@ RESOLVED FOR THIS RECORDING: it is ${opts.colorScheme}-mode truth, so pin color-
 }
 var PoseCompletenessError, kebab3, camel, pascal, RESERVED_PROPS, axisPropName, isStateAxis, DISMISS_NAMES, symbolName, STYLE_WEIGHTS2, styleWeight;
 var init_brief = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/brief.ts"() {
+  "packages/generate/src/brief.ts"() {
     "use strict";
     init_src();
     init_src4();
@@ -8855,11 +9188,11 @@ var init_brief = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/segments.ts
-import { existsSync as existsSync22, readFileSync as readFileSync19, readdirSync as readdirSync6 } from "node:fs";
-import path28 from "node:path";
+// packages/generate/src/segments.ts
+import { existsSync as existsSync23, readFileSync as readFileSync19, readdirSync as readdirSync6 } from "node:fs";
+import path29 from "node:path";
 function repText(set, rep, tool) {
-  const env = JSON.parse(readFileSync19(path28.join(set, rep, `${tool}.json`), "utf8"));
+  const env = JSON.parse(readFileSync19(path29.join(set, rep, `${tool}.json`), "utf8"));
   return tool === "get_design_context" ? envelopeFirstTextPart(env) : envelopeTextContent(env);
 }
 function stripFigmaInstructions(emission) {
@@ -8920,16 +9253,16 @@ 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 (existsSync22(path28.join(SET, "get_variable_defs.json"))) {
-    const text = envelopeFirstTextPart(JSON.parse(readFileSync19(path28.join(SET, "get_variable_defs.json"), "utf8"))) || "{}";
+  if (existsSync23(path29.join(SET, "get_variable_defs.json"))) {
+    const text = envelopeFirstTextPart(JSON.parse(readFileSync19(path29.join(SET, "get_variable_defs.json"), "utf8"))) || "{}";
     try {
       rawDefs = JSON.parse(text);
     } catch {
     }
   } else {
     for (const cfg of task.configs) {
-      const f = path28.join(SET, cfg.rep, "get_variable_defs.json");
-      if (!existsSync22(f)) continue;
+      const f = path29.join(SET, cfg.rep, "get_variable_defs.json");
+      if (!existsSync23(f)) continue;
       const text = envelopeFirstTextPart(JSON.parse(readFileSync19(f, "utf8"))) || "{}";
       try {
         for (const [k, v] of Object.entries(JSON.parse(text))) rawDefs[k] ??= v;
@@ -8938,8 +9271,8 @@ function buildSegments(task, mode = "fenced") {
     }
   }
   const emissionTexts = task.configs.map((cfg) => {
-    const f = path28.join(SET, cfg.rep, "get_design_context.json");
-    return existsSync22(f) ? envelopeFirstTextPart(JSON.parse(readFileSync19(f, "utf8"))) : "";
+    const f = path29.join(SET, cfg.rep, "get_design_context.json");
+    return existsSync23(f) ? envelopeFirstTextPart(JSON.parse(readFileSync19(f, "utf8"))) : "";
   });
   const { map, note } = cleanTokenMap(rawDefs, emissionTexts);
   const defs = JSON.stringify(map, null, 1);
@@ -8954,9 +9287,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 = readdirSync6(path28.join(SET, cfg.rep)).filter((f) => f.startsWith("asset-") && f.endsWith(".svg")).map((f) => `asset ${f}:
+    const assets = readdirSync6(path29.join(SET, cfg.rep)).filter((f) => f.startsWith("asset-") && f.endsWith(".svg")).map((f) => `asset ${f}:
 \`\`\`svg
-${readFileSync19(path28.join(SET, cfg.rep, f), "utf8")}
+${readFileSync19(path29.join(SET, cfg.rep, f), "utf8")}
 \`\`\``).join("\n");
     parts.push(`
 ## Config ${cfg.rep} \u2192 ${cfg.component} ${JSON.stringify(cfg.props)}
@@ -8981,20 +9314,20 @@ Optionally a third block with \`/* FILE: tokens.css */\`.`);
   } else {
     parts.push(`
 ## Output format
-Write the COMPLETE files (${task.entry}, styles.css, optional tokens.css) into your candidate directory. Do not paste file contents into chat \u2014 the scorer reads the directory.`);
+Write the COMPLETE files (${task.entry}, styles.css, optional tokens.css) into ONE candidate directory: \`tendril-out/${path29.basename(task.set)}-candidate/\` unless you were handed another path. Pass that same directory to \`tendril engine score\` every round and keep writing into it \u2014 the scorer stamps the bundle there, writes its evidence beside your files, and appends its score-history.jsonl lines there (one when a round starts, one when it scores); a fresh directory each round throws all of that away. Do not paste file contents into chat \u2014 the scorer reads the directory.`);
   }
   return parts.join("\n");
 }
 var cssIdent;
 var init_segments = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/segments.ts"() {
+  "packages/generate/src/segments.ts"() {
     "use strict";
     init_src();
     cssIdent = (name) => name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/consent.ts
+// packages/generate/src/consent.ts
 function formatConsentLines(e) {
   return [
     `engine=${e.engineId} model=${e.modelId} route=${e.providerRoute}`,
@@ -9004,12 +9337,12 @@ function formatConsentLines(e) {
   ];
 }
 var init_consent = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/consent.ts"() {
+  "packages/generate/src/consent.ts"() {
     "use strict";
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/adapter.ts
+// packages/generate/src/adapter.ts
 function resolveAdapterSettings(entry, overrides = {}) {
   const notes = [];
   let maxTokens = DEFAULT_MAX_TOKENS;
@@ -9041,16 +9374,16 @@ function resolveAdapterSettings(entry, overrides = {}) {
 }
 var DEFAULT_MAX_TOKENS;
 var init_adapter = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/adapter.ts"() {
+  "packages/generate/src/adapter.ts"() {
     "use strict";
     DEFAULT_MAX_TOKENS = 2e4;
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/bundle-emit.ts
+// packages/generate/src/bundle-emit.ts
 import { createHash as createHash4 } from "node:crypto";
-import { copyFileSync, existsSync as existsSync23, mkdirSync as mkdirSync7, readFileSync as readFileSync20, readdirSync as readdirSync7, rmSync as rmSync3, writeFileSync as writeFileSync11 } from "node:fs";
-import path29 from "node:path";
+import { copyFileSync, existsSync as existsSync24, mkdirSync as mkdirSync7, readFileSync as readFileSync20, readdirSync as readdirSync7, rmSync as rmSync3, writeFileSync as writeFileSync11 } from "node:fs";
+import path30 from "node:path";
 function pinFromConfigs(configs) {
   const domains = /* @__PURE__ */ new Map();
   const kinds = /* @__PURE__ */ new Map();
@@ -9119,9 +9452,9 @@ function fontsCssFor(faces, bundleDir, cacheDir = DEFAULT_FONT_CACHE, substitute
   const notices = [];
   const licenseTexts = /* @__PURE__ */ new Map();
   for (const face of faces) {
-    const src = path29.join(cacheDir, path29.basename(face.file));
-    const target = `./fonts/${path29.basename(face.file)}`;
-    const format = FONT_FORMATS[path29.extname(face.file).toLowerCase()] ?? "truetype";
+    const src = path30.join(cacheDir, path30.basename(face.file));
+    const target = `./fonts/${path30.basename(face.file)}`;
+    const format = FONT_FORMATS[path30.extname(face.file).toLowerCase()] ?? "truetype";
     const family = face.family.replace(/['\\]/g, "").replace(/\*\//g, "");
     const decl = `@font-face { font-family: '${family}'; font-weight: ${face.weight}; font-style: normal; src: url(${target}) format('${format}'); }`;
     const license = normalizeFontLicense(face.license);
@@ -9151,14 +9484,14 @@ function fontsCssFor(faces, bundleDir, cacheDir = DEFAULT_FONT_CACHE, substitute
           `/* ${decl} */`
         );
       }
-    } else if (existsSync23(src) && createHash4("sha256").update(readFileSync20(src)).digest("hex") === face.sha256) {
-      mkdirSync7(path29.join(bundleDir, "fonts"), { recursive: true });
-      copyFileSync(src, path29.join(bundleDir, "fonts", path29.basename(face.file)));
+    } else if (existsSync24(src) && createHash4("sha256").update(readFileSync20(src)).digest("hex") === face.sha256) {
+      mkdirSync7(path30.join(bundleDir, "fonts"), { recursive: true });
+      copyFileSync(src, path30.join(bundleDir, "fonts", path30.basename(face.file)));
       licenseTexts.set(terms.file, terms.text);
       const upstream = upstreamAttribution(face);
       notices.push(
         "",
-        `${face.family.replace(/[\r\n]+/g, " ")} ${face.weight} \u2014 ./${path29.basename(face.file)}`,
+        `${face.family.replace(/[\r\n]+/g, " ")} ${face.weight} \u2014 ./${path30.basename(face.file)}`,
         `  licence:   ${terms.title} \u2014 full text in ./${terms.file}`,
         `  source:    ${face.source}`,
         `  sha256:    ${face.sha256}`,
@@ -9172,9 +9505,9 @@ function fontsCssFor(faces, bundleDir, cacheDir = DEFAULT_FONT_CACHE, substitute
   }
   if (lines.length === 0) return null;
   if (notices.length > 0) {
-    const fontsDir = path29.join(bundleDir, "fonts");
-    for (const [file, text] of licenseTexts) writeFileSync11(path29.join(fontsDir, file), text);
-    writeFileSync11(path29.join(fontsDir, "NOTICE.txt"), `${[NOTICE_PREAMBLE, ...notices].join("\n")}
+    const fontsDir = path30.join(bundleDir, "fonts");
+    for (const [file, text] of licenseTexts) writeFileSync11(path30.join(fontsDir, file), text);
+    writeFileSync11(path30.join(fontsDir, "NOTICE.txt"), `${[NOTICE_PREAMBLE, ...notices].join("\n")}
 `);
     header.push(
       "/* REDISTRIBUTION: the face files in ./fonts/ are redistributed under the licences",
@@ -9186,8 +9519,8 @@ function fontsCssFor(faces, bundleDir, cacheDir = DEFAULT_FONT_CACHE, substitute
 `;
 }
 function countLatticeSymbols(setDir) {
-  const manifestFile = path29.join(setDir, "recording-set.json");
-  if (existsSync23(manifestFile)) {
+  const manifestFile = path30.join(setDir, "recording-set.json");
+  if (existsSync24(manifestFile)) {
     try {
       const lattice = JSON.parse(readFileSync20(manifestFile, "utf8")).latticeNames;
       if (lattice !== void 0 && lattice.length > 0) return lattice.length;
@@ -9195,9 +9528,9 @@ function countLatticeSymbols(setDir) {
     }
   }
   const files = [
-    path29.join(setDir, "get_metadata.json"),
-    ...existsSync23(setDir) ? readdirSync7(setDir).filter((f) => /^get_metadata-.*\.json$/.test(f)).map((f) => path29.join(setDir, f)) : []
-  ].filter((f) => existsSync23(f));
+    path30.join(setDir, "get_metadata.json"),
+    ...existsSync24(setDir) ? readdirSync7(setDir).filter((f) => /^get_metadata-.*\.json$/.test(f)).map((f) => path30.join(setDir, f)) : []
+  ].filter((f) => existsSync24(f));
   if (files.length === 0) return null;
   let count = 0;
   for (const f of files) {
@@ -9209,21 +9542,21 @@ 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 (existsSync23(path29.join(setDir, name))) relPaths.push(name);
+    if (existsSync24(path30.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 (existsSync23(path29.join(setDir, cfg.rep, f))) relPaths.push(`${cfg.rep}/${f}`);
+      if (existsSync24(path30.join(setDir, cfg.rep, f))) relPaths.push(`${cfg.rep}/${f}`);
     }
-    if (existsSync23(path29.join(setDir, cfg.rep))) {
-      for (const asset of readdirSync7(path29.join(setDir, cfg.rep)).filter((f) => f.startsWith("asset-"))) {
+    if (existsSync24(path30.join(setDir, cfg.rep))) {
+      for (const asset of readdirSync7(path30.join(setDir, cfg.rep)).filter((f) => f.startsWith("asset-"))) {
         relPaths.push(`${cfg.rep}/${asset}`);
       }
     }
   }
   return hashRecordingSet(
     relPaths,
-    (p) => new Uint8Array(readFileSync20(path29.join(setDir, p))),
+    (p) => new Uint8Array(readFileSync20(path30.join(setDir, p))),
     (chunks) => {
       const h = createHash4("sha256");
       for (const c of chunks) h.update(c);
@@ -9246,7 +9579,7 @@ 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) => path29.join(opts.bundleDir, f)).filter((f) => existsSync23(f));
+  const cssFiles = ["styles.css", "tokens.css"].map((f) => path30.join(opts.bundleDir, f)).filter((f) => existsSync24(f));
   const families = cssFontFamilies(cssFiles.map((f) => readFileSync20(f, "utf8")).join("\n"));
   const requiredFonts = requiredFontsManifest(families, opts.fontCacheDir).map((f) => ({
     family: f.family,
@@ -9276,7 +9609,7 @@ function emitBundleV1(opts) {
         // resolvable via verify's --set override).
         path: (() => {
           const base = process.env["INIT_CWD"] ?? process.cwd();
-          const rel = path29.relative(base, opts.task.set);
+          const rel = path30.relative(base, opts.task.set);
           return rel !== "" && !rel.startsWith("..") ? rel : opts.task.set;
         })(),
         component: opts.componentName,
@@ -9300,12 +9633,12 @@ function emitBundleV1(opts) {
     })
   };
   const written = [];
-  const manifestPath2 = path29.join(opts.bundleDir, "component.json");
+  const manifestPath2 = path30.join(opts.bundleDir, "component.json");
   writeFileSync11(manifestPath2, `${JSON.stringify(manifest, null, 2)}
 `);
   written.push(manifestPath2);
-  const stylesPath = path29.join(opts.bundleDir, "styles.css");
-  if (existsSync23(stylesPath)) {
+  const stylesPath = path30.join(opts.bundleDir, "styles.css");
+  if (existsSync24(stylesPath)) {
     const comment = cssProvenanceComment({ pass, scored: statuses.length, certified, latticeConfigs: lattice });
     const current = readFileSync20(stylesPath, "utf8");
     const stripped = current.replace(/^\/\* tendril bundle v\d+ [^]*?\*\/\n/, "");
@@ -9313,8 +9646,8 @@ function emitBundleV1(opts) {
 ${stripped}`);
     written.push(stylesPath);
   }
-  const fontsCssPath = path29.join(opts.bundleDir, "fonts.css");
-  rmSync3(path29.join(opts.bundleDir, "fonts"), { recursive: true, force: true });
+  const fontsCssPath = path30.join(opts.bundleDir, "fonts.css");
+  rmSync3(path30.join(opts.bundleDir, "fonts"), { recursive: true, force: true });
   rmSync3(fontsCssPath, { force: true });
   const fontsCss = fontsCssFor(requiredFontsManifest(families, opts.fontCacheDir), opts.bundleDir, opts.fontCacheDir, opts.substitutedFamilies ?? []);
   if (fontsCss !== null) {
@@ -9327,7 +9660,7 @@ ${stripped}`);
 }
 var FONT_FORMATS, BARS, NOTICE_PREAMBLE, OFL_1_1_TEXT, UFL_1_0_TEXT, APACHE_2_0_TEXT, REDISTRIBUTABLE;
 var init_bundle_emit = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/bundle-emit.ts"() {
+  "packages/generate/src/bundle-emit.ts"() {
     "use strict";
     init_src6();
     init_src();
@@ -9742,9 +10075,9 @@ DEALINGS IN THE FONT SOFTWARE.
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/index.ts
+// packages/generate/src/index.ts
 var init_src7 = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/generate/src/index.ts"() {
+  "packages/generate/src/index.ts"() {
     "use strict";
     init_engine();
     init_engine_curated();
@@ -9758,7 +10091,7 @@ var init_src7 = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/fonts.ts
+// packages/cli/src/commands/fonts.ts
 var fonts_exports = {};
 __export(fonts_exports, {
   DEFAULT_FONT_CACHE: () => DEFAULT_FONT_CACHE,
@@ -9768,8 +10101,8 @@ __export(fonts_exports, {
   runFontsResolveSet: () => runFontsResolveSet,
   runFontsStatus: () => runFontsStatus
 });
-import { existsSync as existsSync24, readFileSync as readFileSync21 } from "node:fs";
-import path30 from "node:path";
+import { existsSync as existsSync25, readFileSync as readFileSync21 } from "node:fs";
+import path31 from "node:path";
 async function runFontsResolve(opts) {
   const result = await resolveFonts(opts.family, opts.weights, opts.cacheDir);
   emitData(opts, result, () => {
@@ -9784,7 +10117,7 @@ async function runFontsResolve(opts) {
   }
 }
 async function runFontsResolveSet(opts) {
-  const setDir = path30.resolve(process.env["INIT_CWD"] ?? process.cwd(), opts.set);
+  const setDir = path31.resolve(process.env["INIT_CWD"] ?? process.cwd(), opts.set);
   let needs = [];
   try {
     needs = recordedFontNeeds(setDir);
@@ -9792,19 +10125,19 @@ async function runFontsResolveSet(opts) {
     fail(opts, ExitCode.InputValidation, {
       error: `cannot read font needs from ${setDir}: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}`,
       code: "font-needs-unreadable",
-      remediation: 'Point --set at a directory recorded with `tendril record` (it carries recording-set.json), or resolve a family explicitly: tendril fonts resolve "<Family>" --weights 400 500 600.'
+      remediation: `Point --set at a directory recorded with \`${tendrilCommand("record plan")}\` (it carries recording-set.json), or resolve a family explicitly: ${tendrilCommand('fonts resolve "<Family>" --weights 400 500 600')}.`
     });
   }
   if (needs.length === 0) {
     fail(opts, ExitCode.InputValidation, {
       error: `recording set ${setDir} declares no detectable font families`,
       code: "font-needs-empty",
-      remediation: 'Resolve the family the design uses explicitly: tendril fonts resolve "<Family>" --weights 400 500 600.'
+      remediation: `Resolve the family the design uses explicitly: ${tendrilCommand('fonts resolve "<Family>" --weights 400 500 600')}.`
     });
   }
   const inCache = new Set(resolvedFontFamilies(opts.cacheDir).flatMap((f) => f.weights.map((w) => `${f.family.toLowerCase()}:${w}`)));
   const unstamped = new Map(facesMissingLicense(opts.cacheDir).map((f) => [`${f.family.toLowerCase()}:${f.weight}`, f.sha256]));
-  const cached = [];
+  const cached2 = [];
   const resolved = [];
   const failures = [];
   const relicensed = [];
@@ -9817,7 +10150,7 @@ async function runFontsResolveSet(opts) {
       const key = `${need.family.toLowerCase()}:${w}`;
       if (!inCache.has(key)) missing.push(w);
       else if (unstamped.has(key)) toStamp.push(w);
-      else cached.push({ family: need.family, weight: w });
+      else cached2.push({ family: need.family, weight: w });
     }
     if (missing.length > 0) {
       const result = await resolveFonts(need.family, missing, opts.cacheDir);
@@ -9834,10 +10167,10 @@ async function runFontsResolveSet(opts) {
       unlicensed.push(...result.failures);
     }
   }
-  emitData(opts, { set: setDir, needs, cached, resolved, relicensed, unlicensed, failures }, () => {
+  emitData(opts, { set: setDir, needs, cached: cached2, resolved, relicensed, unlicensed, failures }, () => {
     process.stdout.write(`set declares: ${needs.map((n) => `${n.family} (${n.weights.join(", ")})`).join(" \xB7 ")}
 `);
-    for (const f of cached) process.stdout.write(`cached   ${f.family} ${f.weight}
+    for (const f of cached2) process.stdout.write(`cached   ${f.family} ${f.weight}
 `);
     for (const f of resolved) process.stdout.write(`resolved ${f.family} ${f.weight} (${f.sha256.slice(0, 12)}\u2026)
 `);
@@ -9857,16 +10190,16 @@ async function runFontsResolveSet(opts) {
   }
 }
 function runFontsStatus(opts) {
-  const manifestPath2 = path30.join(opts.cacheDir, "manifest.json");
-  if (!existsSync24(manifestPath2)) {
+  const manifestPath2 = path31.join(opts.cacheDir, "manifest.json");
+  if (!existsSync25(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.'
+      remediation: `Run \`${tendrilCommand("fonts resolve --set <recording-dir>")}\` (or \`${tendrilCommand('fonts resolve "<Family>" --weights 400 500 600')}\`) first.`
     });
   }
   const faces = JSON.parse(readFileSync21(manifestPath2, "utf8"));
-  const lockVerdicts = opts.lock !== void 0 ? checkFontLock(path30.resolve(opts.lock), opts.cacheDir) : null;
+  const lockVerdicts = opts.lock !== void 0 ? checkFontLock(path31.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)
 `);
@@ -9897,7 +10230,10 @@ function runFontsAdd(opts) {
     fail(opts, ExitCode.InputValidation, {
       error: err instanceof Error ? err.message : String(err),
       code: "font-add-failed",
-      remediation: 'Pass a font file you are licensed to use: tendril fonts add "S\xF6hne" 400 ./fonts/soehne-400.woff2'
+      // The face file is the user's own licensed asset: this command
+      // can name every argument but that one, so it stays a marked
+      // blank rather than a fabricated path that looks real.
+      remediation: `Pass a font file you are licensed to use, by absolute path: ${tendrilCommand(`fonts add "${opts.family}" ${opts.weight} <absolute-path-to-face.woff2>`)}`
     });
   }
   emitData(opts, face, () => {
@@ -9906,28 +10242,32 @@ function runFontsAdd(opts) {
   });
 }
 var init_fonts = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/fonts.ts"() {
+  "packages/cli/src/commands/fonts.ts"() {
     "use strict";
     init_src3();
     init_src4();
     init_src7();
     init_output();
+    init_invocation();
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/font-guidance.ts
+// packages/cli/src/font-guidance.ts
+import path32 from "node:path";
 function fontsUnprovenRemediation(setDir) {
-  if (setDir !== void 0) {
+  const set = setDir === void 0 ? void 0 : path32.resolve(setDir);
+  if (set !== void 0) {
     try {
-      const needs = recordedFontNeeds(setDir);
+      const needs = recordedFontNeeds(set);
       if (needs.length > 0) {
         const families = needs.map((n) => `"${n.family}"`).join(", ");
-        return `Run \`tendril fonts resolve --set ${setDir}\` \u2014 the recording declares ${families}; faces land in ${DEFAULT_FONT_CACHE}.`;
+        return `Run \`${tendrilCommand(`fonts resolve --set ${set}`)}\` \u2014 the recording declares ${families}; faces land in ${DEFAULT_FONT_CACHE}.`;
       }
     } catch {
     }
   }
-  return `Run \`tendril fonts resolve --set <recording-dir>\` (or \`tendril fonts resolve "<Family>" --weights 400 500 600\`) to populate the font cache \u2014 the cache read is ${DEFAULT_FONT_CACHE}.`;
+  const target = set ?? "<recording-dir>";
+  return `Run \`${tendrilCommand(`fonts resolve --set ${target}`)}\` (or \`${tendrilCommand('fonts resolve "<Family>" --weights 400 500 600')}\`) to populate the font cache \u2014 the cache read is ${DEFAULT_FONT_CACHE}.`;
 }
 function taskFontFamilies(setDir) {
   try {
@@ -9969,28 +10309,33 @@ function missingWeights(setDir, cacheDir) {
   return gaps;
 }
 var init_font_guidance = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/font-guidance.ts"() {
+  "packages/cli/src/font-guidance.ts"() {
     "use strict";
     init_src4();
     init_src7();
+    init_invocation();
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/verify.ts
+// packages/cli/src/commands/verify.ts
 var verify_exports = {};
 __export(verify_exports, {
   NO_ROLE_MANIFEST: () => NO_ROLE_MANIFEST,
   ROLES_NOT_RESOLVED: () => ROLES_NOT_RESOLVED,
   checkSummarySegments: () => checkSummarySegments,
   compositionReport: () => compositionReport,
+  eyeCheck: () => eyeCheck,
   failureTally: () => failureTally,
   foldConfigStatus: () => foldConfigStatus,
   interactionCoverage: () => interactionCoverage,
+  occlusionReport: () => occlusionReport,
+  operabilityLine: () => operabilityLine,
+  operabilityReport: () => operabilityReport,
   resolveComposition: () => resolveComposition,
   runVerify: () => runVerify
 });
-import { existsSync as existsSync25, readFileSync as readFileSync22 } from "node:fs";
-import path31 from "node:path";
+import { existsSync as existsSync26, readFileSync as readFileSync22 } from "node:fs";
+import path33 from "node:path";
 function interactionCoverage(behaviors) {
   const interaction = behaviors.filter((b) => !b.id.startsWith("prelude:"));
   return {
@@ -10000,6 +10345,43 @@ function interactionCoverage(behaviors) {
     operability: interaction.length > 0 && interaction.every((b) => b.pass) ? "verified" : "unverified"
   };
 }
+function operabilityReport(input) {
+  const { interactionChecks, interactionPassed, preludeChecks } = interactionCoverage(input.behaviors);
+  const prelude = ` The ${preludeChecks} behavior check(s) that did run are page-level prelude style hygiene, which says nothing about whether the component works.`;
+  if (interactionChecks === 0) {
+    const evidence = input.interactionEvidence;
+    if (evidence === void 0) {
+      return {
+        short: "nothing authored; recorded poses never derived",
+        unavailable: `no interaction behaviours were authored for this component, and this run never derived the recording's interactive poses \u2014 nothing about focus, typing, or keyboard operation was measured, and nothing here rules out a static lookalike.${prelude}`
+      };
+    }
+    if (evidence.length > 0) {
+      return {
+        short: "interactive poses recorded, none authored",
+        unavailable: `the recording PROVES interactive poses (${evidence.join(
+          ", "
+        )}) and ZERO interaction behaviours were authored to cover them \u2014 nothing about focus, typing, or keyboard operation was measured; this is an instrument failure, not a working component.${prelude}`
+      };
+    }
+    return { short: "no interactive poses recorded", unavailable: `${NO_INTERACTIVE_POSES}${prelude}` };
+  }
+  if (interactionPassed < interactionChecks) {
+    const failed = interactionChecks - interactionPassed;
+    return {
+      checks: interactionChecks,
+      passed: interactionPassed,
+      short: `${failed} of ${interactionChecks} interaction check(s) failed`,
+      unverified: `the interaction checks RAN and ${failed} of ${interactionChecks} failed (each named in the FAIL behavior rows) \u2014 this component WAS exercised and did not behave as the recording requires; unverified here means measured and wrong, not unmeasured.`
+    };
+  }
+  return { checks: interactionChecks, passed: interactionPassed };
+}
+function operabilityLine(state) {
+  if ("unavailable" in state) return `UNVERIFIED  operability \u2014 ${state.unavailable}`;
+  if ("unverified" in state) return `UNVERIFIED  operability \u2014 ${state.unverified}`;
+  return void 0;
+}
 function foldConfigStatus(s, failDemotions, substitutedFamilies) {
   const { exact: _exact, ...reported } = s;
   let status = tierOf(s, BARS2.cert);
@@ -10038,8 +10420,18 @@ function checkSummarySegments(input) {
   const tally = (rows) => `${rows.filter((r) => r.pass).length}/${rows.length}`;
   const { availability } = input;
   const composition = availability.unavailable !== void 0 ? `composition NOT CHECKED (${availability.short})` : `composition ${tally(input.structural)} structural, ${input.crops !== void 0 ? `${tally(input.crops)} crops` : "crops unavailable"} (roles: ${rolesSourceLabel(availability.roles)}${(availability.roles.narrowingAccepted ?? []).length > 0 ? `, ${(availability.roles.narrowingAccepted ?? []).length} narrowing(s) accepted: ${(availability.roles.narrowingAccepted ?? []).join(", ")}` : ""})`;
-  const occlusion = input.occlusion.length === 0 ? "occlusion not applicable (no overlay declared)" : `occlusion ${tally(input.occlusion)}`;
-  return ` \xB7 ${composition} \xB7 ${occlusion}`;
+  const occ = occlusionReport(input.occlusion);
+  const occlusion = "unavailable" in occ ? `occlusion not applicable (${NO_OVERLAY_DECLARED})` : `occlusion ${tally(input.occlusion)}`;
+  const operability = "short" in input.operability ? `operability UNVERIFIED (${input.operability.short})` : `operability ${input.operability.passed}/${input.operability.checks} interaction`;
+  return ` \xB7 ${operability} \xB7 ${composition} \xB7 ${occlusion}`;
+}
+function occlusionReport(occlusion) {
+  if (occlusion.length === 0) {
+    return {
+      unavailable: "the bundle declares no overlay (no open-state config and no prelude popover) \u2014 the sibling-occlusion check DOES NOT APPLY and nothing about overlay stacking was measured; an empty check list is this state, not a clean bill"
+    };
+  }
+  return { checks: occlusion.length, passed: occlusion.filter((o) => o.pass).length };
 }
 function compositionReport(input) {
   const { availability, regions } = input;
@@ -10057,6 +10449,13 @@ function compositionReport(input) {
     crops: input.crops ?? { unavailable: cropsUnavailable }
   };
 }
+function eyeCheck(bundleDir) {
+  return {
+    command: tendrilCommand(`inspect "${bundleDir}"`),
+    sheetPath: path33.join(bundleDir, "verify-evidence", "inspect.html"),
+    note: "magnified recorded-vs-rendered crops of every small node; scores cannot see shape. The command WRITES/refreshes the sheet at sheetPath \u2014 re-run it after every verify; an existing sheet may show stale crops."
+  };
+}
 function failureTally(t) {
   return `${t.configs.length} config(s), ${t.behaviors.length} behavior(s), ${t.structural.length + t.crops.length} composition check(s), ${t.occlusion.length} occlusion check(s) below the ${t.bar} bar${t.evidenceUnverified ? "; PLUS the interaction-evidence instrument gate failed (operability could not be verified \u2014 see FAIL interaction-evidence above)" : ""} \u2014 bundle written, verdict honest (Q4)`;
 }
@@ -10065,7 +10464,7 @@ function taskFromManifest(opts, manifest, setDir) {
   const adapterSlugs = Object.keys(manifest.propAdapter);
   const unmapped = recordedSlugs.filter((s) => !adapterSlugs.includes(s));
   const adapterOnly = adapterSlugs.filter((s) => !recordedSlugs.includes(s));
-  const registry = Object.values(TASKS).find((t) => path31.resolve(t.set) === path31.resolve(setDir));
+  const registry = Object.values(TASKS).find((t) => path33.resolve(t.set) === path33.resolve(setDir));
   const authored = (() => {
     if (registry !== void 0) return void 0;
     try {
@@ -10074,7 +10473,7 @@ function taskFromManifest(opts, manifest, setDir) {
       fail(opts, ExitCode.InputValidation, {
         error: `cannot author the verification task from ${setDir}: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}`,
         code: "AUTHORING_FAILED",
-        remediation: "Fix the recording set (duplicate/colliding poses fail authoring by design \u2014 check `tendril record status` and the set's variant names)."
+        remediation: `Fix the recording set (duplicate/colliding poses fail authoring by design \u2014 check \`${tendrilCommand(`record status --set ${setDir}`)}\` and the set's variant names).`
       });
     }
   })();
@@ -10091,24 +10490,27 @@ function taskFromManifest(opts, manifest, setDir) {
     task,
     unmapped,
     adapterOnly,
-    interactionEvidence: authored?.api.interactionEvidence ?? [],
+    // Registry sets carry hand-declared behaviors and no derivation
+    // runs, so their evidence is UNKNOWN, not empty: an empty list is
+    // spent downstream as "the recording holds no interactive pose".
+    interactionEvidence: authored?.api.interactionEvidence,
     unmappedInteractionEvidence: authored?.api.unmappedInteractionEvidence ?? []
   };
 }
 async function runVerify(opts) {
   const callerCwd = process.env["INIT_CWD"] ?? process.cwd();
-  const setOverride = opts.set !== void 0 ? path31.resolve(callerCwd, opts.set) : void 0;
-  opts = { ...opts, bundleDir: path31.resolve(callerCwd, opts.bundleDir), ...setOverride !== void 0 ? { set: setOverride } : {} };
-  if (!existsSync25(opts.bundleDir)) {
+  const setOverride = opts.set !== void 0 ? path33.resolve(callerCwd, opts.set) : void 0;
+  opts = { ...opts, bundleDir: path33.resolve(callerCwd, opts.bundleDir), ...setOverride !== void 0 ? { set: setOverride } : {} };
+  if (!existsSync26(opts.bundleDir)) {
     fail(opts, ExitCode.InputValidation, {
       error: `bundle directory not found: ${opts.bundleDir}`,
       code: "bundle-missing",
       remediation: "Point at a generated bundle directory (containing component.json, the entry module, and styles.css)."
     });
   }
-  const manifestPath2 = path31.join(opts.bundleDir, "component.json");
+  const manifestPath2 = path33.join(opts.bundleDir, "component.json");
   let manifest;
-  if (existsSync25(manifestPath2)) {
+  if (existsSync26(manifestPath2)) {
     const { manifest: parsed, issues } = readBundleManifest(readFileSync22(manifestPath2, "utf8"));
     if (issues.length > 0) {
       fail(opts, ExitCode.InputValidation, {
@@ -10121,7 +10523,7 @@ async function runVerify(opts) {
   }
   let task;
   let unmapped = [];
-  let interactionEvidence = [];
+  let interactionEvidence;
   let unmappedInteractionEvidence = [];
   let availability = ROLES_NOT_RESOLVED;
   if (opts.task !== void 0) {
@@ -10136,21 +10538,21 @@ async function runVerify(opts) {
     task = registry;
   } else if (manifest !== void 0) {
     const resolveSetDir = (p) => {
-      if (path31.isAbsolute(p)) return p;
-      const fromRepo = path31.resolve(REPO_ROOT, p);
-      if (existsSync25(fromRepo)) return fromRepo;
-      return path31.resolve(callerCwd, p);
+      if (path33.isAbsolute(p)) return p;
+      const fromRepo = path33.resolve(REPO_ROOT, p);
+      if (existsSync26(fromRepo)) return fromRepo;
+      return path33.resolve(callerCwd, p);
     };
     const setDir = opts.set ?? resolveSetDir(manifest.provenance.recordingSet.path);
-    if (!existsSync25(path31.join(setDir, "recording-set.json")) && !Object.values(TASKS).some((t) => path31.resolve(t.set) === path31.resolve(setDir))) {
+    if (!existsSync26(path33.join(setDir, "recording-set.json")) && !Object.values(TASKS).some((t) => path33.resolve(t.set) === path33.resolve(setDir))) {
       fail(opts, ExitCode.RecordingIncomplete, {
         error: `recording set not found or unmanifested: ${setDir}`,
         code: "recording-set-missing",
         remediation: "Pass --set <dir> pointing at the recording set this bundle was generated from."
       });
     }
-    const registry = Object.values(TASKS).find((t) => path31.resolve(t.set) === path31.resolve(setDir));
-    if (registry !== void 0 && !existsSync25(path31.join(setDir, "recording-set.json"))) {
+    const registry = Object.values(TASKS).find((t) => path33.resolve(t.set) === path33.resolve(setDir));
+    if (registry !== void 0 && !existsSync26(path33.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));
@@ -10174,8 +10576,8 @@ async function runVerify(opts) {
       warn(opts, `recording set content differs from the bundle's provenance stamp (${hash.slice(0, 12)}\u2026 vs ${manifest.provenance.recordingSet.hash.slice(0, 12)}\u2026) \u2014 scores apply to the CURRENT set`);
     }
     for (const name of [manifest.entry, "styles.css", "tokens.css"]) {
-      const p = path31.join(opts.bundleDir, name);
-      if (!existsSync25(p)) continue;
+      const p = path33.join(opts.bundleDir, name);
+      if (!existsSync26(p)) continue;
       const issues = checkBundleSourceFile(name, new Uint8Array(readFileSync22(p)));
       if (issues.length > 0) {
         fail(opts, ExitCode.InputValidation, {
@@ -10214,7 +10616,7 @@ async function runVerify(opts) {
     warn(opts, `font weights (advisory): the recording implies weights ${g.declared.join(", ")} for "${g.family}" \u2014 cache provides ${g.provided.join(", ")}; nearest-weight rendering may shift stroke density (certification stays family-gated; implied weights can leak across families)`);
   }
   const missing = task.configs.filter(
-    (c) => !existsSync25(path31.join(task.set, c.rep, "get_screenshot.json")) || !existsSync25(path31.join(task.set, c.rep, "get_metadata.json"))
+    (c) => !existsSync26(path33.join(task.set, c.rep, "get_screenshot.json")) || !existsSync26(path33.join(task.set, c.rep, "get_metadata.json"))
   );
   if (missing.length > 0) {
     fail(opts, ExitCode.RecordingIncomplete, {
@@ -10224,10 +10626,10 @@ async function runVerify(opts) {
     });
   }
   const bar = BARS2[opts.bar];
-  const evidenceDir = path31.join(opts.bundleDir, "verify-evidence");
+  const evidenceDir = path33.join(opts.bundleDir, "verify-evidence");
   const scores = await scoreBundleForTask(task, opts.bundleDir, bar, { evidenceDir, onProgress: emitProgress });
   const quality = await checkBundleQuality(opts.bundleDir, task.entry, { dir: task.set, reps: task.configs.map((c) => c.rep) });
-  const bundleCss = ["tokens.css", "styles.css"].map((f) => path31.join(opts.bundleDir, f)).filter((f) => existsSync25(f)).map((f) => readFileSync22(f, "utf8")).join("\n");
+  const bundleCss = ["tokens.css", "styles.css"].map((f) => path33.join(opts.bundleDir, f)).filter((f) => existsSync26(f)).map((f) => readFileSync22(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];
@@ -10258,7 +10660,8 @@ async function runVerify(opts) {
   const certified = statuses.filter((s) => s.status === "certified").length;
   const occlusionFailures = occlusion.filter((o) => !o.pass);
   const coverage = interactionCoverage(behaviors);
-  const evidenceUnverified = interactionEvidence.length > 0 && coverage.interactionChecks === 0;
+  const operability = operabilityReport({ behaviors, interactionEvidence });
+  const evidenceUnverified = (interactionEvidence?.length ?? 0) > 0 && coverage.interactionChecks === 0;
   const okExceptDemotion = pixelFailures.length === 0 && behaviorFailures.length === 0 && structuralFailures.length === 0 && cropFailures.length === 0 && occlusionFailures.length === 0 && !evidenceUnverified;
   const certBlockedByAbsentInk = opts.bar === "cert" ? absentInkDemoted : [];
   const ok = okExceptDemotion && certBlockedByAbsentInk.length === 0;
@@ -10298,7 +10701,11 @@ async function runVerify(opts) {
       // read exactly like a verified one — measured, a statue and a real
       // control produced the same 6/6. The split is the honest form.
       ...coverage,
-      ...interactionEvidence.length > 0 ? { interactionEvidence } : {},
+      ...interactionEvidence !== void 0 && interactionEvidence.length > 0 ? { interactionEvidence } : {},
+      // The one-word verdict's CAUSE, in the channel that has no summary
+      // line to carry it. `operability` above keeps its key and values;
+      // this says which of its meanings the run actually produced.
+      operabilityCheck: operability,
       // Poses the recording proves interactive that no operability
       // check covers — pixel-verified only. The first cold kit shipped
       // pressed/focus this way with nothing in the report saying so.
@@ -10312,6 +10719,10 @@ async function runVerify(opts) {
     // silently inherited neither.
     quality: { findings: quality.findings, tokensAbsent: quality.tokensAbsent },
     occlusion,
+    // The rows' STATE, which the rows alone cannot carry (see
+    // occlusionReport): the agent channel had no counterpart to the
+    // human line's "occlusion not applicable (no overlay declared)".
+    occlusionCheck: occlusionReport(occlusion),
     configs: statuses,
     behaviors,
     evidence: { dir: evidenceDir, files: "per config: <rep>-render.png, <rep>-ref.png, <rep>-diff.png" },
@@ -10323,15 +10734,7 @@ async function runVerify(opts) {
     ...certBlockedByAbsentInk.length > 0 ? { certBlockedByAbsentInk } : {},
     ...weightGaps.length > 0 ? { fontWeightGaps: weightGaps } : {},
     ...lcdTextEnabled() ? { environmentOverrides: ["enable-lcd-text"] } : {},
-    // Run 13 finding 1: the eye-check nudge lived only in the human
-    // footer, so MCP-driven agents — the documented path — were never
-    // told the check exists and shipped without ever opening a sheet.
-    // Structured here so every consumer sees it.
-    eyeCheck: {
-      command: `tendril inspect "${opts.bundleDir}"`,
-      sheetPath: path31.join(opts.bundleDir, "verify-evidence", "inspect.html"),
-      note: "magnified recorded-vs-rendered crops of every small node; scores cannot see shape. The command WRITES/refreshes the sheet at sheetPath \u2014 re-run it after every verify; an existing sheet may show stale crops."
-    }
+    eyeCheck: eyeCheck(opts.bundleDir)
   };
   emitData(opts, report, () => {
     for (const s of statuses) {
@@ -10363,11 +10766,10 @@ async function runVerify(opts) {
       process.stdout.write(`UNAVAILABLE composition crops \u2014 ${regionsOut.unavailable}
 `);
     }
-    const ic = interactionCoverage(behaviors);
     process.stdout.write(
       `
 ${certified}/${statuses.length} certified \xB7 ${report.coverage.pass}/${statuses.length} \u2265 pass bar \xB7 behaviors ${behaviors.length - behaviorFailures.length}/${behaviors.length}${checkSummarySegments(
-        { availability, structural, crops, occlusion }
+        { availability, structural, crops, occlusion, operability }
       )}
 `
     );
@@ -10396,14 +10798,13 @@ ${certified}/${statuses.length} certified \xB7 ${report.coverage.pass}/${statuse
     }
     if (evidenceUnverified) {
       process.stdout.write(
-        `FAIL      interaction-evidence \u2014 the recording proves interactive poses (${interactionEvidence.join(", ")}) and ZERO interaction behaviors were verified. The authoring vocabulary did not map them; this is an instrument failure, not a verified component. Mappable today: ${[...INTERACTION_STATES, ...BOOLEAN_STATES].join("/")} \u2014 on an axis named State (checked/selected state axes are recorded as evidence but not yet authorable \u2014 widening is on the roadmap; this is not fixable from component code).
-`
-      );
-    } else if (ic.interactionChecks === 0) {
-      process.stdout.write(
-        `UNVERIFIED  operability \u2014 0 interaction checks were authored for this component; the behaviors above are page-level style hygiene. Nothing here says the component responds to a user.
+        `FAIL      interaction-evidence \u2014 the recording proves interactive poses (${(interactionEvidence ?? []).join(", ")}) and ZERO interaction behaviors were verified. The authoring vocabulary did not map them; this is an instrument failure, not a verified component. Mappable today: ${[...INTERACTION_STATES, ...BOOLEAN_STATES].join("/")} \u2014 on an axis named State (checked/selected state axes are recorded as evidence but not yet authorable \u2014 widening is on the roadmap; this is not fixable from component code).
 `
       );
+    } else {
+      const line = operabilityLine(operability);
+      if (line !== void 0) process.stdout.write(`${line}
+`);
     }
     if (unmappedInteractionEvidence.length > 0) {
       process.stdout.write(
@@ -10425,18 +10826,20 @@ ${certified}/${statuses.length} certified \xB7 ${report.coverage.pass}/${statuse
     }
     process.stdout.write(`environment: chrome=${report.environment.chromeVersion ?? report.environment.chrome} fonts=${report.environment.fontsManifestSha256 ?? "UNRESOLVED"}
 `);
-    const shippedFonts = requiredFontsManifest(cssFontFamilies(["styles.css", "tokens.css"].map((f) => path31.join(opts.bundleDir, f)).filter((f) => existsSync25(f)).map((f) => readFileSync22(f, "utf8")).join("\n")));
+    const shippedFonts = requiredFontsManifest(cssFontFamilies(["styles.css", "tokens.css"].map((f) => path33.join(opts.bundleDir, f)).filter((f) => existsSync26(f)).map((f) => readFileSync22(f, "utf8")).join("\n")));
     if (shippedFonts.length > 0 && substitutedFamilies.length === 0) {
       process.stdout.write(`fonts: scored with Tendril-cache faces \u2014 a consuming app must provision the same families (the bundle ships fonts.css when faces are shippable; sha-pinned list in component.json requiredFonts)
 `);
     }
     for (const g of weightGaps) {
-      process.stdout.write(`fonts (weight gap): "${g.family}" declares ${g.declared.join(", ")} \u2014 cache provides ${g.provided.join(", ")}; nearest-weight rendering may shift stroke density (advisory, never a gate). Fix: tendril fonts resolve --set ${task.set}
-`);
+      process.stdout.write(
+        `fonts (weight gap): "${g.family}" declares ${g.declared.join(", ")} \u2014 cache provides ${g.provided.join(", ")}; nearest-weight rendering may shift stroke density (advisory, never a gate). Fix: ${tendrilCommand(`fonts resolve --set ${task.set}`)}
+`
+      );
     }
     process.stdout.write(`evidence: ${evidenceDir} (render/ref/diff per config)
 `);
-    process.stdout.write(`eye check: tendril inspect "${opts.bundleDir}" \u2014 magnified recorded-vs-rendered crops of every small node; scores cannot see shape (re-run after every verify)
+    process.stdout.write(`eye check: ${report.eyeCheck.command} \u2014 magnified recorded-vs-rendered crops of every small node; scores cannot see shape (re-run after every verify)
 `);
   });
   if (opts.bar === "cert" && substitutedFamilies.length > 0) {
@@ -10476,9 +10879,9 @@ ${certified}/${statuses.length} certified \xB7 ${report.coverage.pass}/${statuse
     process.exitCode = ExitCode.VerificationFailed;
   }
 }
-var BARS2, NO_ROLE_MANIFEST, ROLES_NOT_RESOLVED, UNSTAMPED_ROLES;
+var BARS2, NO_INTERACTIVE_POSES, NO_ROLE_MANIFEST, ROLES_NOT_RESOLVED, UNSTAMPED_ROLES, NO_OVERLAY_DECLARED;
 var init_verify = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/verify.ts"() {
+  "packages/cli/src/commands/verify.ts"() {
     "use strict";
     init_src3();
     init_src6();
@@ -10487,11 +10890,13 @@ var init_verify = __esm({
     init_src4();
     init_environment();
     init_font_guidance();
+    init_invocation();
     init_output();
     BARS2 = {
       pass: { sim: 0.95, ink: 0.95 },
       cert: { sim: 0.97, ink: 0.95 }
     };
+    NO_INTERACTIVE_POSES = "no interactive poses recorded \u2014 nothing about focus, typing, or keyboard operation was measured; a component that is not a control passes this field.";
     NO_ROLE_MANIFEST = Object.freeze({
       short: "no role manifest",
       unavailable: "the recording set declares no role manifest \u2014 composition (structural + crop) was NEVER CHECKED; nothing here says the main renders the SHIPPED part modules rather than a pixel-identical re-implementation"
@@ -10501,45 +10906,46 @@ var init_verify = __esm({
       unavailable: "this run never resolved a role manifest \u2014 the legacy --task adapter and pre-manifest reference sets skip the set's roles block entirely, so composition (structural + crop) was NEVER CHECKED and the set was never asked what it declares; nothing here says the main renders the SHIPPED part modules rather than a pixel-identical re-implementation"
     });
     UNSTAMPED_ROLES = "unstamped";
+    NO_OVERLAY_DECLARED = "no overlay declared";
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/engine.ts
+// packages/cli/src/commands/engine.ts
 var engine_exports = {};
 __export(engine_exports, {
   runEngineBrief: () => runEngineBrief,
   runEngineScore: () => runEngineScore
 });
-import { appendFileSync, existsSync as existsSync26, mkdirSync as mkdirSync8, readFileSync as readFileSync23, writeFileSync as writeFileSync12 } from "node:fs";
-import path32 from "node:path";
+import { appendFileSync, existsSync as existsSync27, mkdirSync as mkdirSync8, readFileSync as readFileSync23, writeFileSync as writeFileSync12 } from "node:fs";
+import path34 from "node:path";
 function resolveEngineTask(opts, callerCwd) {
-  const asPath = path32.resolve(callerCwd, opts.taskOrSet);
-  const isSet = existsSync26(path32.join(asPath, "recording-set.json"));
+  const asPath = path34.resolve(callerCwd, opts.taskOrSet);
+  const isSet = existsSync27(path34.join(asPath, "recording-set.json"));
   const registry = TASKS[opts.taskOrSet];
-  if (registry !== void 0 && !isSet) return { task: registry, name: opts.taskOrSet, disclosures: [], interactionEvidence: [] };
+  if (registry !== void 0 && !isSet) return { task: registry, name: opts.taskOrSet, ref: opts.taskOrSet, disclosures: [], interactionEvidence: void 0 };
   if (isSet) {
     try {
       const authored = authorTaskFromSet(asPath);
       for (const d of authored.disclosures) warn(opts, d);
-      return { task: authored.task, name: path32.basename(asPath), disclosures: authored.disclosures, interactionEvidence: authored.api.interactionEvidence, apiPin: { props: authored.api.apiPin.props, forcedStates: authored.api.apiPin.forcedStates } };
+      return { task: authored.task, name: path34.basename(asPath), ref: asPath, disclosures: authored.disclosures, interactionEvidence: authored.api.interactionEvidence, apiPin: { props: authored.api.apiPin.props, forcedStates: authored.api.apiPin.forcedStates } };
     } catch (err) {
       fail(opts, ExitCode.InputValidation, {
         error: `cannot author a task from ${asPath}: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}`,
         code: "AUTHORING_FAILED",
-        remediation: "Complete the recording set (tendril record status) or use a reference task name."
+        remediation: `Complete the recording set (${tendrilCommand(`record status --set ${asPath}`)}) or use a reference task name.`
       });
     }
   }
   fail(opts, ExitCode.InputValidation, {
     error: `"${opts.taskOrSet}" is neither a reference task nor a recorded set`,
     code: "UNKNOWN_RECORDED_INPUT",
-    remediation: `Pick a task (${Object.keys(TASKS).join(", ")}) or point at a set recorded with \`tendril record\`.`
+    remediation: `Pick a task (${Object.keys(TASKS).join(", ")}) or point at a set recorded with \`${tendrilCommand("record plan")}\`.`
   });
 }
 function runEngineBrief(opts) {
   requireEntitlement(opts);
   const callerCwd = process.env["INIT_CWD"] ?? process.cwd();
-  const { task, name, disclosures } = resolveEngineTask(opts, callerCwd);
+  const { task, name, ref, disclosures } = resolveEngineTask(opts, callerCwd);
   const bar = BARS3[opts.bar];
   const disclosureBlock = disclosures.length > 0 ? `
 
@@ -10548,8 +10954,8 @@ ${disclosures.map((d) => `- ${d}`).join("\n")}` : "";
   const brief = buildBrief(task.systemApi, bar, { colorScheme: recordingIsDark(task) ? "dark" : "light" }) + disclosureBlock;
   const segments = buildSegments(task, "files");
   let notRecorded;
-  const manifestPath2 = path32.join(task.set, "recording-set.json");
-  if (existsSync26(manifestPath2)) {
+  const manifestPath2 = path34.join(task.set, "recording-set.json");
+  if (existsSync27(manifestPath2)) {
     notRecorded = JSON.parse(readFileSync23(manifestPath2, "utf8")).notRecorded;
   }
   const unverified = notRecorded !== void 0 && notRecorded !== "" ? `
@@ -10558,7 +10964,7 @@ ${disclosures.map((d) => `- ${d}`).join("\n")}` : "";
 DO NOT INVENT PIXELS FOR THESE POSES. Implement them ONLY as the composition of recorded per-axis truth (the custom-property composition rule: one paint axis sets variables, the other consumes) and list every such pose in your report as UNRECORDED-COMPOSED. Recording them is the real fix: re-plan the set (full matrix is the default) and record the missing poses.
 ${notRecorded}` : "";
   let fontProvisioning;
-  if (existsSync26(manifestPath2)) {
+  if (existsSync27(manifestPath2)) {
     const missingFams = unprovisionedFamilies(task.set);
     const unprovided = unprovisionedFaces(task.set);
     const weightOnly = missingFams.length === 0;
@@ -10566,16 +10972,17 @@ ${notRecorded}` : "";
       const names = unprovided.map((f) => `'${f}'`).join(", ");
       const PROPRIETARY = /^(sf pro|sf compact|sf mono|new york|pingfang|segoe ui|helvetica neue|proxima nova|avenir)/i;
       const allProprietary = unprovided.every((f) => PROPRIETARY.test(f.trim()));
+      const resolveCommand = tendrilCommand(`fonts resolve --set ${task.set}`);
       fontProvisioning = {
         unprovided,
         question: {
           prompt: weightOnly ? `This design implies font ${unprovided.length === 1 ? "weight" : "weights"} the local kit lacks: ${names} (the ${missingFams.length === 0 && unprovided.length === 1 ? "family itself is" : "families themselves are"} provisioned). How should it be handled?` : `This design's text uses ${names}, which is not in the local font kit. How should it be handled?`,
           options: [
-            allProprietary && !weightOnly ? `(Recommended) ${names} ${unprovided.length === 1 ? "is a proprietary face" : "are proprietary faces"} \u2014 Google Fonts cannot serve ${unprovided.length === 1 ? "it" : "them"}, so skip \`fonts resolve\`: run \`tendril fonts add "<Family>" <weight> <file>\` with the .woff2/.ttf/.otf you hold a licence for (the file never leaves this machine), then re-run this brief \u2014 exact text fidelity.` : `(Recommended) Run \`tendril fonts resolve --set ${task.set}\` \u2014 open-source families are fetched automatically. Any face that fails there is one you license privately: run \`tendril fonts add "<Family>" <weight> <file>\` with the .woff2/.ttf/.otf you hold (the file never leaves this machine). Then re-run this brief \u2014 exact text fidelity.`,
+            allProprietary && !weightOnly ? `(Recommended) ${names} ${unprovided.length === 1 ? "is a proprietary face" : "are proprietary faces"} \u2014 Google Fonts cannot serve ${unprovided.length === 1 ? "it" : "them"}, so skip \`fonts resolve\`: run \`${tendrilCommand('fonts add "<Family>" <weight> <file>')}\` with the .woff2/.ttf/.otf you hold a licence for (the file never leaves this machine), then re-run this brief \u2014 exact text fidelity.` : `(Recommended) Run \`${resolveCommand}\` \u2014 open-source families are fetched automatically. Any face that fails there is one you license privately: run \`${tendrilCommand('fonts add "<Family>" <weight> <file>')}\` with the .woff2/.ttf/.otf you hold (the file never leaves this machine). Then re-run this brief \u2014 exact text fidelity.`,
             weightOnly ? "Continue with nearest-weight rendering: the family is provisioned, certification remains possible, and the gap rides the report as an advisory (fontWeightGaps); resolving removes it." : 'Continue with a substitute face: generation proceeds in a provided family, no config can score "certified" under it (cert-bar runs exit fonts-unproven after their report), the substitution is disclosed, and small text differences are expected and not fixable from CSS.'
           ]
         },
-        nonInteractive: weightOnly ? `Run \`tendril fonts resolve --set ${task.set}\` if quick, or continue \u2014 the weight gap is an advisory, never a gate.` : opts.bar === "cert" ? `Resolve the families first (\`tendril fonts resolve --set ${task.set}\`) \u2014 this loop targets the cert bar, and scoring exits fonts-unproven under a substitute, so continuing without resolving is a dead end.` : "Continue with the substitute and state the substitution in your report."
+        nonInteractive: weightOnly ? `Run \`${resolveCommand}\` if quick, or continue \u2014 the weight gap is an advisory, never a gate.` : opts.bar === "cert" ? `Resolve the families first (\`${resolveCommand}\`) \u2014 this loop targets the cert bar, and scoring exits fonts-unproven under a substitute, so continuing without resolving is a dead end.` : "Continue with the substitute and state the substitution in your report."
       };
     }
   }
@@ -10583,8 +10990,8 @@ ${notRecorded}` : "";
 
 === TASK PAYLOAD (recorded truth, verbatim) ===
 ${segments}`;
-  const payloadFile = path32.resolve(callerCwd, opts.out ?? `tendril-out/${name}-brief.md`);
-  mkdirSync8(path32.dirname(payloadFile), { recursive: true });
+  const payloadFile = path34.resolve(callerCwd, opts.out ?? `tendril-out/${name}-brief.md`);
+  mkdirSync8(path34.dirname(payloadFile), { recursive: true });
   writeFileSync12(payloadFile, payload);
   emitData(
     opts,
@@ -10613,7 +11020,7 @@ ${segments}`;
         "Settle the proposer model (see modelSelection \u2014 ask the user when one is present), then:",
         `Read ${payloadFile} completely \u2014 it is the system brief plus every recorded config's emission, box, and assets.`,
         `Write the complete bundle files (${task.entry}, styles.css, optional tokens.css) into a candidate directory.`,
-        `Run \`tendril engine score ${name} <candidateDir> --bar ${opts.bar} --model ${opts.model ?? "<declared-model>"} --json\` \u2014 the CLI is the sole judge, and it refuses to score an undeclared model.`,
+        `Run \`${tendrilCommand(`engine score ${ref} <candidateDir> --bar ${opts.bar} --model ${opts.model ?? "<declared-model>"} --json`)}\` \u2014 the CLI is the sole judge, and it refuses to score an undeclared model.`,
         "Apply the returned feedback and re-score. Stop when all checks pass or two consecutive scores fail to improve.",
         "Never edit recording sets; never claim scores yourself \u2014 only the score command's output counts."
       ]
@@ -10626,18 +11033,23 @@ ${segments}`;
     }
   );
 }
+function appendScoreHistory(candidateDir, entry) {
+  appendFileSync(path34.join(candidateDir, "score-history.jsonl"), `${JSON.stringify({ at: (/* @__PURE__ */ new Date()).toISOString(), ...entry })}
+`);
+}
 async function runEngineScore(opts) {
   requireEntitlement(opts);
   const callerCwd = process.env["INIT_CWD"] ?? process.cwd();
-  const candidateDir = path32.resolve(callerCwd, opts.candidateDir);
+  const candidateDir = path34.resolve(callerCwd, opts.candidateDir);
   const { task, name, apiPin, interactionEvidence } = resolveEngineTask(opts, callerCwd);
-  if (!existsSync26(candidateDir)) {
+  if (!existsSync27(candidateDir)) {
     fail(opts, ExitCode.InputValidation, {
       error: `candidate directory not found: ${candidateDir}`,
       code: "candidate-missing",
       remediation: `Write ${task.entry} and styles.css into a directory and pass it.`
     });
   }
+  appendScoreHistory(candidateDir, { event: "round-start", bar: opts.bar });
   if (!fontsResolved()) {
     fail(opts, ExitCode.FontsUnproven, {
       error: "resolved font cache absent \u2014 scoring under system font substitution is refused",
@@ -10655,10 +11067,10 @@ async function runEngineScore(opts) {
   for (const g of missingWeights(task.set)) {
     warn(opts, `font weights (advisory): the recording implies weights ${g.declared.join(", ")} for "${g.family}" \u2014 cache provides ${g.provided.join(", ")}; nearest-weight rendering may shift stroke density (certification stays family-gated; implied weights can leak across families)`);
   }
-  if (opts.rebind !== true && existsSync26(path32.join(candidateDir, "component.json"))) {
+  if (opts.rebind !== true && existsSync27(path34.join(candidateDir, "component.json"))) {
     const prior = (() => {
       try {
-        const read = readBundleManifest(readFileSync23(path32.join(candidateDir, "component.json"), "utf8"));
+        const read = readBundleManifest(readFileSync23(path34.join(candidateDir, "component.json"), "utf8"));
         return read.manifest === void 0 ? { unreadable: true } : { hash: read.manifest.provenance.recordingSet.hash, path: read.manifest.provenance.recordingSet.path };
       } catch {
         return { unreadable: true };
@@ -10680,7 +11092,7 @@ async function runEngineScore(opts) {
     }
   }
   const bar = BARS3[opts.bar];
-  const evidenceDir = path32.join(candidateDir, "verify-evidence");
+  const evidenceDir = path34.join(candidateDir, "verify-evidence");
   const scores = await scoreBundleForTask(task, candidateDir, bar, { evidenceDir, onProgress: emitProgress });
   const parity = await checkHoverParity(task, candidateDir);
   const behaviors = [...await checkBehaviors(task, candidateDir), ...parity];
@@ -10723,11 +11135,10 @@ METRIC DEADBAND (read before iterating on near-misses): the scored similarity/in
     environment: environmentStamp(taskFontFamilies(task.set)),
     substitutedFamilies
   });
-  appendFileSync(
-    path32.join(candidateDir, "score-history.jsonl"),
-    `${JSON.stringify({ at: (/* @__PURE__ */ new Date()).toISOString(), bar: opts.bar, pass: obj[0], total, certified: certifiedReps.length, floor: obj[1], mean: obj[2] })}
-`
-  );
+  appendScoreHistory(candidateDir, { event: "round-scored", bar: opts.bar, pass: obj[0], total, certified: certifiedReps.length, floor: obj[1], mean: obj[2] });
+  const coverage = interactionCoverage(behaviors);
+  const operability = operabilityReport({ behaviors, interactionEvidence });
+  const evidenceUnverified = (interactionEvidence?.length ?? 0) > 0 && coverage.interactionChecks === 0;
   emitData(
     opts,
     {
@@ -10741,7 +11152,14 @@ METRIC DEADBAND (read before iterating on near-misses): the scored similarity/in
       // The loop's oracle must say what verify says: without this an
       // MCP-driven agent literally cannot tell a hollow verdict (all
       // behaviour passes are prelude hygiene) from a verified one.
-      coverage: interactionCoverage(behaviors),
+      //
+      // `operability` alone is ONE WORD covering four different states,
+      // and this is the channel where run 15's miss happened: the agent
+      // driving the loop reads this JSON and nothing else. It gets the
+      // same sentence verify's report carries, from the same function —
+      // fixing verify's channel and not this one would have left the
+      // reader who actually acts on it exactly where they were.
+      coverage: { ...coverage, operabilityCheck: operability },
       parityCoverage,
       evidenceDir,
       bundleManifest: emitted.written[0],
@@ -10752,7 +11170,7 @@ METRIC DEADBAND (read before iterating on near-misses): the scored similarity/in
       // Run 11: generators read allPass:true and reported success on
       // bundles verify then FAILED on the interaction-evidence gate —
       // the oracle must say what verify will say, including this.
-      ...interactionEvidence.length > 0 && interactionCoverage(behaviors).interactionChecks === 0 ? { interactionEvidenceUnverified: true, verifyWillFail: "interaction-evidence \u2014 the recording proves interactive poses none of the authored behaviors cover; not fixable from component code; REPORT it, do not iterate on it" } : {},
+      ...evidenceUnverified ? { interactionEvidenceUnverified: true, verifyWillFail: "interaction-evidence \u2014 the recording proves interactive poses none of the authored behaviors cover; not fixable from component code; REPORT it, do not iterate on it" } : {},
       certification: { certified: certifiedReps.length, total: scores.length, bar: certBar, note: "tierOf on exact values + parity and absent-ink demotion; verify's composition checks can demote further" }
     },
     () => {
@@ -10763,12 +11181,12 @@ METRIC DEADBAND (read before iterating on near-misses): the scored similarity/in
       process.stdout.write(`
 ${obj[0]}/${total} \xB7 certified ${certifiedReps.length}/${total} \xB7 floor=${obj[1].toFixed(3)} \xB7 mean=${obj[2].toFixed(3)} \xB7 evidence: ${evidenceDir}
 `);
-      const ic = interactionCoverage(behaviors);
-      if (interactionEvidence.length > 0 && ic.interactionChecks === 0) {
-        process.stdout.write(`INSTRUMENT GAP \u2014 the recording proves interactive poses (${interactionEvidence.join(", ")}) and zero interaction behaviors were authored; verify WILL fail this bundle (interaction-evidence). Not fixable from component code \u2014 report it, do not iterate on it.
+      if (evidenceUnverified) {
+        process.stdout.write(`INSTRUMENT GAP \u2014 the recording proves interactive poses (${(interactionEvidence ?? []).join(", ")}) and zero interaction behaviors were authored; verify WILL fail this bundle (interaction-evidence). Not fixable from component code \u2014 report it, do not iterate on it.
 `);
-      } else if (ic.interactionChecks === 0) {
-        process.stdout.write(`UNVERIFIED operability \u2014 0 interaction checks; the behaviour passes above are page-level style hygiene
+      } else {
+        const line = operabilityLine(operability);
+        if (line !== void 0) process.stdout.write(`${line}
 `);
       }
     }
@@ -10793,7 +11211,7 @@ ${obj[0]}/${total} \xB7 certified ${certifiedReps.length}/${total} \xB7 floor=${
 }
 var BARS3;
 var init_engine2 = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/engine.ts"() {
+  "packages/cli/src/commands/engine.ts"() {
     "use strict";
     init_src3();
     init_src7();
@@ -10802,6 +11220,7 @@ var init_engine2 = __esm({
     init_font_guidance();
     init_src4();
     init_output();
+    init_invocation();
     init_entitlement();
     init_verify();
     init_src4();
@@ -10812,16 +11231,16 @@ var init_engine2 = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/codeconnect.ts
+// packages/cli/src/commands/codeconnect.ts
 var codeconnect_exports = {};
 __export(codeconnect_exports, {
   runCodeConnect: () => runCodeConnect
 });
-import { existsSync as existsSync27, readFileSync as readFileSync24, writeFileSync as writeFileSync13 } from "node:fs";
-import path33 from "node:path";
+import { existsSync as existsSync28, readFileSync as readFileSync24, writeFileSync as writeFileSync13 } from "node:fs";
+import path35 from "node:path";
 function runCodeConnect(opts) {
   const callerCwd = process.env["INIT_CWD"] ?? process.cwd();
-  const bundleDir = path33.resolve(callerCwd, opts.bundleDir);
+  const bundleDir = path35.resolve(callerCwd, opts.bundleDir);
   let url;
   try {
     url = new URL(opts.figmaUrl);
@@ -10837,7 +11256,7 @@ function runCodeConnect(opts) {
   }
   let manifest;
   try {
-    const read = readBundleManifest(readFileSync24(path33.join(bundleDir, "component.json"), "utf8"));
+    const read = readBundleManifest(readFileSync24(path35.join(bundleDir, "component.json"), "utf8"));
     if (read.manifest === void 0) throw new Error(read.issues.map((i) => i.message).join("; ") || "no component.json");
     manifest = read.manifest;
   } catch (err) {
@@ -10847,8 +11266,8 @@ function runCodeConnect(opts) {
       remediation: "Point at a bundle produced by the Tendril pipeline (it carries component.json), and verify it first."
     });
   }
-  const setDir = path33.resolve(callerCwd, opts.set ?? manifest.provenance.recordingSet.path);
-  if (!existsSync27(path33.join(setDir, "recording-set.json"))) {
+  const setDir = path35.resolve(callerCwd, opts.set ?? manifest.provenance.recordingSet.path);
+  if (!existsSync28(path35.join(setDir, "recording-set.json"))) {
     fail(opts, ExitCode.InputValidation, {
       error: `recording set not found at ${setDir}`,
       code: "codeconnect-no-set",
@@ -10862,15 +11281,15 @@ function runCodeConnect(opts) {
     fail(opts, ExitCode.InputValidation, {
       error: `cannot author the API from ${setDir}: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}`,
       code: "codeconnect-authoring-failed",
-      remediation: "The set must be a complete protocol recording (tendril record status)."
+      remediation: `The set must be a complete protocol recording (${tendrilCommand(`record status --set ${setDir}`)}).`
     });
   }
   const api = authored.api;
   const component = api.component;
   const recManifest = loadManifest(setDir);
   const poseNames = recManifest.latticeNames ?? recManifest.reps.map((r) => {
-    const meta = path33.join(setDir, r.slug, "get_metadata.json");
-    if (!existsSync27(meta)) return void 0;
+    const meta = path35.join(setDir, r.slug, "get_metadata.json");
+    if (!existsSync28(meta)) return void 0;
     try {
       return /name="([^"]*)"/.exec(envelopeFirstTextPart(JSON.parse(readFileSync24(meta, "utf8"))))?.[1];
     } catch {
@@ -10889,7 +11308,7 @@ function runCodeConnect(opts) {
     fail(opts, ExitCode.InputValidation, {
       error: "the recording set's content no longer matches the hash this bundle was scored against \u2014 its verification claims describe a different recording",
       code: "codeconnect-set-drift",
-      remediation: "Re-run `tendril verify` (or engine score) against the current set, then re-emit."
+      remediation: `Re-run \`${tendrilCommand(`verify ${bundleDir} --set ${setDir}`)}\` (or engine score) against the current set, then re-emit.`
     });
   }
   const boolProps = api.props.filter((p) => p.kind === "boolean");
@@ -10930,7 +11349,7 @@ function runCodeConnect(opts) {
     axisLines.push(`const ${varName} = instance.getEnum(${q(axis)}, { ${entries.join(", ")} })`);
     fragmentVars.push(varName);
   }
-  const entryRel = path33.relative(callerCwd, path33.join(bundleDir, manifest.entry));
+  const entryRel = path35.relative(callerCwd, path35.join(bundleDir, manifest.entry));
   const trust = manifest.trustStatement.split("\n")[0] ?? "";
   const lines = [
     `// url=${opts.figmaUrl}`,
@@ -10951,7 +11370,7 @@ function runCodeConnect(opts) {
     `}`,
     ``
   ].join("\n");
-  const outFile = path33.resolve(callerCwd, opts.out ?? path33.join(bundleDir, `${component}.figma.ts`));
+  const outFile = path35.resolve(callerCwd, opts.out ?? path35.join(bundleDir, `${component}.figma.ts`));
   writeFileSync13(outFile, lines);
   emitData(
     opts,
@@ -10976,48 +11395,49 @@ function runCodeConnect(opts) {
 }
 var kebab4, q;
 var init_codeconnect = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/codeconnect.ts"() {
+  "packages/cli/src/commands/codeconnect.ts"() {
     "use strict";
     init_src3();
     init_src7();
     init_src();
     init_src6();
+    init_invocation();
     init_output();
     kebab4 = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
     q = (s) => `'${s.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029")}'`;
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/mcp/src/server.ts
+// packages/mcp/src/server.ts
 import { createHash as createHash5 } from "node:crypto";
-import { existsSync as existsSync28, mkdtempSync as mkdtempSync3, readFileSync as readFileSync25, readdirSync as readdirSync8, writeFileSync as writeFileSync14 } from "node:fs";
+import { existsSync as existsSync29, mkdtempSync as mkdtempSync3, readFileSync as readFileSync25, readdirSync as readdirSync8, writeFileSync as writeFileSync14 } from "node:fs";
 import os6 from "node:os";
-import path34 from "node:path";
-import { fileURLToPath as fileURLToPath5 } from "node:url";
+import path36 from "node:path";
+import { fileURLToPath as fileURLToPath6 } from "node:url";
 import { z as z12 } from "zod";
 function sourceHash() {
-  const dir = path34.dirname(fileURLToPath5(import.meta.url));
+  const dir = path36.dirname(fileURLToPath6(import.meta.url));
   const h = createHash5("sha256");
   for (const f of readdirSync8(dir).filter((n) => n.endsWith(".ts")).sort()) {
     h.update(f);
-    h.update(readFileSync25(path34.join(dir, f)));
+    h.update(readFileSync25(path36.join(dir, f)));
   }
   return h.digest("hex").slice(0, 16);
 }
 var REPO_ROOT3, CLI_BIN, BUNDLED_CLI, CLI_SPAWN, str, optStr, TOOLS, BOOT_HASH;
 var init_server = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/mcp/src/server.ts"() {
+  "packages/mcp/src/server.ts"() {
     "use strict";
-    REPO_ROOT3 = path34.resolve(path34.dirname(fileURLToPath5(import.meta.url)), "..", "..", "..");
-    CLI_BIN = path34.join(REPO_ROOT3, "packages", "cli", "src", "bin.ts");
-    BUNDLED_CLI = path34.join(path34.dirname(fileURLToPath5(import.meta.url)), "tendril.js");
-    CLI_SPAWN = existsSync28(BUNDLED_CLI) ? { cmd: process.execPath, prefix: [BUNDLED_CLI] } : { cmd: "npx", prefix: ["tsx", CLI_BIN] };
+    REPO_ROOT3 = path36.resolve(path36.dirname(fileURLToPath6(import.meta.url)), "..", "..", "..");
+    CLI_BIN = path36.join(REPO_ROOT3, "packages", "cli", "src", "bin.ts");
+    BUNDLED_CLI = path36.join(path36.dirname(fileURLToPath6(import.meta.url)), "tendril.js");
+    CLI_SPAWN = existsSync29(BUNDLED_CLI) ? { cmd: process.execPath, prefix: [BUNDLED_CLI] } : { cmd: "npx", prefix: ["tsx", CLI_BIN] };
     str = (d) => z12.string().describe(d);
     optStr = (d) => z12.string().optional().describe(d);
     TOOLS = [
       {
         name: "tendril_record_plan",
-        description: "ENTRY POINT for implementing/building a React component from a Figma design or figma.com URL \u2014 start the Tendril pipeline here (after loading the tendril skill, if installed). Plans a recording session: computes the rep queue (anchor + one-factor + conflict crosses) from the verbatim get_metadata response (pass its blocks via metadataParts \u2014 no file to write) and persists the set manifest. Resumes if the set already exists. The output may carry USER QUESTIONS \u2014 defaultsToConfirm (which pose is the component's default) or a multiple-component-sets error (which set to record): render them to a present user and apply the answers via `defaults` / `componentSet`; non-interactive runs follow each question's stated fallback. Recording cost is stated in figmaCallEstimate, never asked about \u2014 proceed with what the user provided.",
+        description: "ENTRY POINT for implementing/building a React component from a Figma design or figma.com URL \u2014 start the Tendril pipeline here (after loading the tendril skill, if installed). Plans a recording session: computes the rep queue (anchor + one-factor + conflict crosses) from the verbatim get_metadata response (pass its blocks via metadataParts \u2014 no file to write) and persists the set manifest. Resumes if the set already exists. The output may carry USER QUESTIONS \u2014 defaultsToConfirm (which pose is the component's default) or a multiple-component-sets error (which set to record): render them to a present user and apply the answers via `defaults` / `componentSet`; non-interactive runs follow each question's stated fallback. It may also carry `interactionStatesToConfirm` \u2014 the recording holds no hover/focus/pressed state, so nothing shows how the component behaves when someone uses it: say its `statement` and `designFix` in that SAME one message (the fix is a Figma variant, not code). It is a disclosure, not a gate \u2014 no answer is required and recording proceeds regardless. The output also carries `feasibilityCheck`: the call arithmetic for this queue plus the free `whoami` check that turns it into a verdict \u2014 complete that handshake BEFORE the first recording call, and surface the verdict to the user when the set does not fit their daily allowance.",
         schema: z12.object({
           setDir: str("recording set directory to create/resume"),
           component: str("component/system name"),
@@ -11041,7 +11461,7 @@ var init_server = __esm({
           const single = i["metadata"];
           const parts = i["metadataParts"];
           if (single !== void 0 || parts !== void 0) {
-            const tmp = path34.join(mkdtempSync3(path34.join(os6.tmpdir(), "tendril-envelope-")), "response.txt");
+            const tmp = path36.join(mkdtempSync3(path36.join(os6.tmpdir(), "tendril-envelope-")), "response.txt");
             if (single !== void 0) {
               writeFileSync14(tmp, single);
               argvOut.push("--metadata-raw-file", tmp);
@@ -11112,7 +11532,7 @@ var init_server = __esm({
           const bridge = (label, single, parts) => {
             if (single !== void 0 && parts !== void 0) throw new Error(`pass at most one of \`${label}\` and \`${label}Parts\``);
             if (single === void 0 && parts === void 0) return;
-            const tmp = path34.join(mkdtempSync3(path34.join(os6.tmpdir(), "tendril-envelope-")), "response.txt");
+            const tmp = path36.join(mkdtempSync3(path36.join(os6.tmpdir(), "tendril-envelope-")), "response.txt");
             if (single !== void 0) {
               writeFileSync14(tmp, single);
               argvOut.push(`--${label}-file`, tmp);
@@ -11155,7 +11575,7 @@ var init_server = __esm({
           const file = i["file"];
           if ([text, texts, file].filter((x) => x !== void 0).length !== 1) throw new Error("pass exactly one of `text` (single-block response), `texts` (multi-block response), or `file` (a saved envelope)");
           if (file !== void 0) return [...base, "--file", file];
-          const tmp = path34.join(mkdtempSync3(path34.join(os6.tmpdir(), "tendril-envelope-")), "response.txt");
+          const tmp = path36.join(mkdtempSync3(path36.join(os6.tmpdir(), "tendril-envelope-")), "response.txt");
           if (text !== void 0) {
             writeFileSync14(tmp, text);
             return [...base, "--file", tmp, "--raw"];
@@ -11302,7 +11722,7 @@ var init_server = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/permissions.ts
+// packages/cli/src/commands/permissions.ts
 var permissions_exports = {};
 __export(permissions_exports, {
   PERMISSIONS_DESCRIPTION: () => PERMISSIONS_DESCRIPTION,
@@ -11310,12 +11730,12 @@ __export(permissions_exports, {
   mergeAllowlist: () => mergeAllowlist,
   runPermissions: () => runPermissions
 });
-import { existsSync as existsSync29, mkdirSync as mkdirSync9, readFileSync as readFileSync26, writeFileSync as writeFileSync15 } from "node:fs";
+import { existsSync as existsSync30, mkdirSync as mkdirSync9, readFileSync as readFileSync26, writeFileSync as writeFileSync15 } from "node:fs";
 import os7 from "node:os";
-import path35 from "node:path";
+import path37 from "node:path";
 function mergeAllowlist(file, entries) {
   let settings = {};
-  if (existsSync29(file) && readFileSync26(file, "utf8").trim() !== "") {
+  if (existsSync30(file) && readFileSync26(file, "utf8").trim() !== "") {
     settings = JSON.parse(readFileSync26(file, "utf8"));
     if (settings === null || typeof settings !== "object" || Array.isArray(settings)) throw new Error("settings root is not an object");
   }
@@ -11328,7 +11748,7 @@ function mergeAllowlist(file, entries) {
   const alreadyPresent = entries.filter((e) => present.has(e));
   if (added.length > 0) {
     allow.push(...added);
-    mkdirSync9(path35.dirname(file), { recursive: true });
+    mkdirSync9(path37.dirname(file), { recursive: true });
     writeFileSync15(file, `${JSON.stringify(settings, null, 2)}
 `);
   }
@@ -11364,7 +11784,7 @@ async function runPermissions(flags) {
   const result = await buildPermissions({ ...flags.mcpUrl ? { mcpUrl: flags.mcpUrl } : {} });
   if (flags.write) {
     const base = process.env["INIT_CWD"] ?? process.cwd();
-    const file = flags.user ? path35.join(os7.homedir(), ".claude", "settings.json") : path35.join(base, ".claude", "settings.local.json");
+    const file = flags.user ? path37.join(os7.homedir(), ".claude", "settings.json") : path37.join(base, ".claude", "settings.local.json");
     if (flags.dryRun) {
       emitData(flags, { file, wouldAdd: result.toolEntries }, () => {
         process.stdout.write(`dry-run: would merge ${result.toolEntries.length} per-tool entries into ${file}
@@ -11397,7 +11817,7 @@ async function runPermissions(flags) {
       `Claude Code allowlist for the Tendril pipeline.
 One command installs it (project-local, idempotent):
 
-    tendril permissions --claude --write
+    ${tendrilCommand("permissions --claude --write")}
 
 Or paste into .claude/settings.json under permissions.allow:
 
@@ -11416,12 +11836,13 @@ ${result.directConfigNote}
 }
 var FIGMA_TOOL_FALLBACK, PERMISSIONS_DESCRIPTION, TENDRIL_PLUGIN_PREFIX, FIGMA_PLUGIN_PREFIX;
 var init_permissions = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/permissions.ts"() {
+  "packages/cli/src/commands/permissions.ts"() {
     "use strict";
     init_src3();
     init_src();
     init_server();
     init_describe();
+    init_invocation();
     init_output();
     init_doctor();
     FIGMA_TOOL_FALLBACK = ["get_metadata", "get_design_context", "get_screenshot", "get_variable_defs", "get_motion_context", "get_figjam"];
@@ -11451,27 +11872,27 @@ var init_permissions = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/inspect.ts
+// packages/cli/src/commands/inspect.ts
 var inspect_exports = {};
 __export(inspect_exports, {
   INSPECT_DESCRIPTION: () => INSPECT_DESCRIPTION,
   runInspect: () => runInspect
 });
-import { existsSync as existsSync30, readFileSync as readFileSync27, writeFileSync as writeFileSync16 } from "node:fs";
-import path36 from "node:path";
+import { existsSync as existsSync31, readFileSync as readFileSync27, writeFileSync as writeFileSync16 } from "node:fs";
+import path38 from "node:path";
 async function runInspect(opts) {
   if (opts.describe) {
     printDescription(INSPECT_DESCRIPTION);
     return;
   }
-  const bundleDir = path36.resolve(opts.bundleDir);
-  const evidenceDir = path36.join(bundleDir, "verify-evidence");
-  const manifestPath2 = path36.join(bundleDir, "component.json");
-  if (!existsSync30(evidenceDir) || !existsSync30(manifestPath2)) {
+  const bundleDir = path38.resolve(opts.bundleDir);
+  const evidenceDir = path38.join(bundleDir, "verify-evidence");
+  const manifestPath2 = path38.join(bundleDir, "component.json");
+  if (!existsSync31(evidenceDir) || !existsSync31(manifestPath2)) {
     fail(opts, ExitCode.InputValidation, {
-      error: `nothing to inspect in ${bundleDir} \u2014 ${existsSync30(manifestPath2) ? "no verify-evidence directory" : "no component.json"}`,
+      error: `nothing to inspect in ${bundleDir} \u2014 ${existsSync31(manifestPath2) ? "no verify-evidence directory" : "no component.json"}`,
       code: "no-evidence",
-      remediation: "Run `tendril verify <bundleDir>` first \u2014 inspect reads the ref/render evidence that run writes."
+      remediation: `Run \`${tendrilCommand(`verify ${bundleDir}`)}\` first \u2014 inspect reads the ref/render evidence that run writes.`
     });
   }
   const { manifest } = readBundleManifest(readFileSync27(manifestPath2, "utf8"));
@@ -11482,27 +11903,27 @@ async function runInspect(opts) {
       remediation: "Re-emit the bundle (score/verify rewrite component.json), then re-run inspect."
     });
   }
-  const setDir = path36.resolve(opts.set ?? manifest.provenance.recordingSet.path);
-  const reps = Object.keys(manifest.propAdapter).filter((rep) => existsSync30(path36.join(evidenceDir, `${rep}-ref.png`)) && existsSync30(path36.join(evidenceDir, `${rep}-render.png`)));
+  const setDir = path38.resolve(opts.set ?? manifest.provenance.recordingSet.path);
+  const reps = Object.keys(manifest.propAdapter).filter((rep) => existsSync31(path38.join(evidenceDir, `${rep}-ref.png`)) && existsSync31(path38.join(evidenceDir, `${rep}-render.png`)));
   if (reps.length === 0) {
     fail(opts, ExitCode.InputValidation, {
       error: "verify-evidence holds no ref/render pairs for this bundle's configs",
       code: "no-evidence",
-      remediation: "Run `tendril verify <bundleDir>` first \u2014 inspect reads the ref/render evidence that run writes."
+      remediation: `Run \`${tendrilCommand(`verify ${bundleDir}`)}\` first \u2014 inspect reads the ref/render evidence that run writes.`
     });
   }
   let crops = 0;
   const sections = [];
   for (const rep of reps) {
-    const ref = new Uint8Array(readFileSync27(path36.join(evidenceDir, `${rep}-ref.png`)));
-    const render = new Uint8Array(readFileSync27(path36.join(evidenceDir, `${rep}-render.png`)));
+    const ref = new Uint8Array(readFileSync27(path38.join(evidenceDir, `${rep}-ref.png`)));
+    const render = new Uint8Array(readFileSync27(path38.join(evidenceDir, `${rep}-render.png`)));
     const nodes = smallSemanticNodes(setDir, rep, opts.maxArea ?? 1024).slice(0, 12);
     const cells = [];
     for (const [i, n] of nodes.entries()) {
       const rect = { x: n.x, y: n.y, w: n.w, h: n.h };
       try {
-        writeFileSync16(path36.join(evidenceDir, `${rep}-inspect-${i}-ref.png`), zoomCrop(ref, rect));
-        writeFileSync16(path36.join(evidenceDir, `${rep}-inspect-${i}-render.png`), zoomCrop(render, rect));
+        writeFileSync16(path38.join(evidenceDir, `${rep}-inspect-${i}-ref.png`), zoomCrop(ref, rect));
+        writeFileSync16(path38.join(evidenceDir, `${rep}-inspect-${i}-render.png`), zoomCrop(render, rect));
       } catch {
         continue;
       }
@@ -11515,7 +11936,7 @@ async function runInspect(opts) {
       `<section><h2>${esc(rep)}</h2><div class="full"><span><em>recorded</em><img src="./${rep}-ref.png"></span><span><em>rendered</em><img src="./${rep}-render.png"></span><span><em>diff</em><img src="./${rep}-diff.png"></span></div>` + (cells.length > 0 ? `<div class="grid">${cells.join("")}</div>` : `<p class="none">no small recorded nodes in this config's sweep</p>`) + `</section>`
     );
   }
-  const sheet = path36.join(evidenceDir, "inspect.html");
+  const sheet = path38.join(evidenceDir, "inspect.html");
   writeFileSync16(
     sheet,
     `<!doctype html><meta charset="utf-8"><title>${esc(manifest.name)} \u2014 tendril inspect</title><style>
@@ -11540,12 +11961,13 @@ ${reps.length} config(s), ${crops} detail crop pair(s) \u2014 open the sheet and
 }
 var INSPECT_DESCRIPTION, esc;
 var init_inspect = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/inspect.ts"() {
+  "packages/cli/src/commands/inspect.ts"() {
     "use strict";
     init_src3();
     init_src6();
     init_src4();
     init_describe();
+    init_invocation();
     init_output();
     INSPECT_DESCRIPTION = {
       name: "inspect",
@@ -11568,7 +11990,7 @@ var init_inspect = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/generate-route.ts
+// packages/cli/src/commands/generate-route.ts
 var generate_route_exports = {};
 __export(generate_route_exports, {
   routeGenerate: () => routeGenerate
@@ -11581,28 +12003,28 @@ function routeGenerate(input) {
   return { path: "facts", ...input.url !== void 0 ? { url: input.url } : {} };
 }
 var init_generate_route = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/generate-route.ts"() {
+  "packages/cli/src/commands/generate-route.ts"() {
     "use strict";
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/generate-recorded.ts
+// packages/cli/src/commands/generate-recorded.ts
 var generate_recorded_exports = {};
 __export(generate_recorded_exports, {
   runGenerateRecorded: () => runGenerateRecorded
 });
 import { confirm as confirm3, isCancel as isCancel3 } from "@clack/prompts";
-import { existsSync as existsSync31, readFileSync as readFileSync28 } from "node:fs";
-import path37 from "node:path";
+import { existsSync as existsSync32, readFileSync as readFileSync28 } from "node:fs";
+import path39 from "node:path";
 async function runGenerateRecorded(opts) {
   const callerCwd = process.env["INIT_CWD"] ?? process.cwd();
-  const outDirAbs = path37.resolve(callerCwd, opts.out);
-  const recordedAsPath = path37.resolve(callerCwd, opts.recorded);
+  const outDirAbs = path39.resolve(callerCwd, opts.out);
+  const recordedAsPath = path39.resolve(callerCwd, opts.recorded);
   let task;
   let taskName;
   let authoredApi;
   let composition;
-  const isSet = existsSync31(path37.join(recordedAsPath, "recording-set.json"));
+  const isSet = existsSync32(path39.join(recordedAsPath, "recording-set.json"));
   const registry = TASKS[opts.recorded];
   if (registry !== void 0 && !isSet) {
     task = registry;
@@ -11611,7 +12033,7 @@ async function runGenerateRecorded(opts) {
     try {
       const authored = authorTaskFromSet(recordedAsPath);
       task = authored.task;
-      taskName = path37.basename(recordedAsPath);
+      taskName = path39.basename(recordedAsPath);
       authoredApi = authored.api;
       const roles = RolesSchema.safeParse(loadManifest(recordedAsPath).roles);
       if (roles.success) composition = roles.data;
@@ -11620,14 +12042,14 @@ async function runGenerateRecorded(opts) {
       fail(opts, ExitCode.InputValidation, {
         error: `cannot author a task from ${recordedAsPath}: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}`,
         code: "AUTHORING_FAILED",
-        remediation: "Complete the recording set (tendril record status) or use a reference-corpus task name."
+        remediation: `Complete the recording set (${tendrilCommand(`record status --set ${recordedAsPath}`)}) or use a reference-corpus task name.`
       });
     }
   } else {
     fail(opts, ExitCode.InputValidation, {
       error: `"${opts.recorded}" is neither a reference task nor a recorded set (no recording-set.json found)`,
       code: "UNKNOWN_RECORDED_INPUT",
-      remediation: `Pick a task (${Object.keys(TASKS).join(", ")}) or point at a set recorded with \`tendril record\`.`
+      remediation: `Pick a task (${Object.keys(TASKS).join(", ")}) or point at a set recorded with \`${tendrilCommand("record plan")}\`.`
     });
   }
   if (!fontsResolved()) {
@@ -11645,13 +12067,13 @@ async function runGenerateRecorded(opts) {
     warn(opts, `font weights (advisory): the recording implies weights ${g.declared.join(", ")} for "${g.family}" \u2014 cache provides ${g.provided.join(", ")}; nearest-weight rendering may shift stroke density (certification stays family-gated; implied weights can leak across families)`);
   }
   const missing = task.configs.filter(
-    (c) => !existsSync31(path37.join(task.set, c.rep, "get_screenshot.json")) || !existsSync31(path37.join(task.set, c.rep, "get_metadata.json")) || !existsSync31(path37.join(task.set, c.rep, "get_design_context.json"))
+    (c) => !existsSync32(path39.join(task.set, c.rep, "get_screenshot.json")) || !existsSync32(path39.join(task.set, c.rep, "get_metadata.json")) || !existsSync32(path39.join(task.set, c.rep, "get_design_context.json"))
   );
   if (missing.length > 0) {
     fail(opts, ExitCode.RecordingIncomplete, {
       error: `recording set ${task.set} is missing envelopes for ${missing.length} rep(s): ${missing.slice(0, 3).map((c) => c.rep).join(", ")}${missing.length > 3 ? ", \u2026" : ""}`,
       code: "recording-incomplete",
-      remediation: "Resume the recording session (`tendril record next`) until `tendril record status` reports the set complete."
+      remediation: `Resume the recording session (\`${tendrilCommand(`record next --set ${task.set}`)}\`) until \`${tendrilCommand(`record status --set ${task.set}`)}\` reports the set complete.`
     });
   }
   const modelId = opts.model ?? DEFAULT_MODEL_CONFIG.curatedDefault ?? DEFAULT_MODEL_CONFIG.bulk;
@@ -11672,7 +12094,7 @@ async function runGenerateRecorded(opts) {
     fail(opts, ExitCode.Auth, {
       error: "OPENROUTER_API_KEY is not configured \u2014 the curated engine needs an OpenRouter-compatible key.",
       code: "MISSING_OPENROUTER_KEY",
-      remediation: "Two paths: run `tendril init` to store your OpenRouter key (BYOK \u2014 your key, your inference), or drive the agent-harness engine explicitly with your own agent host."
+      remediation: `Two paths: run \`${tendrilCommand("init")}\` to store your OpenRouter key (BYOK \u2014 your key, your inference), or drive the agent-harness engine explicitly with your own agent host.`
     });
   }
   const bar = BARS4[opts.bar];
@@ -11715,8 +12137,8 @@ async function runGenerateRecorded(opts) {
 ` : `${line}
 `);
   if (opts.dryRun) {
-    emitData(opts, { dryRun: true, task: taskName, model: modelId, consent, wouldWrite: path37.join(outDirAbs, taskName) }, () => {
-      process.stdout.write(`dry-run: nothing sent, nothing written (would write ${path37.join(outDirAbs, taskName)})
+    emitData(opts, { dryRun: true, task: taskName, model: modelId, consent, wouldWrite: path39.join(outDirAbs, taskName) }, () => {
+      process.stdout.write(`dry-run: nothing sent, nothing written (would write ${path39.join(outDirAbs, taskName)})
 `);
     });
     return;
@@ -11739,10 +12161,10 @@ async function runGenerateRecorded(opts) {
       });
     }
   }
-  const bundleDir = path37.join(outDirAbs, taskName);
-  if (existsSync31(path37.join(bundleDir, "component.json"))) {
+  const bundleDir = path39.join(outDirAbs, taskName);
+  if (existsSync32(path39.join(bundleDir, "component.json"))) {
     try {
-      const prior = readBundleManifest(readFileSync28(path37.join(bundleDir, "component.json"), "utf8")).manifest;
+      const prior = readBundleManifest(readFileSync28(path39.join(bundleDir, "component.json"), "utf8")).manifest;
       if (prior !== void 0 && prior.provenance.recordingSet.hash !== recordingSetHash(task.set, task.configs)) {
         fail(opts, ExitCode.InputValidation, {
           error: `${bundleDir} already holds a bundle bound to recording set "${prior.provenance.recordingSet.path}" \u2014 generating here against a different set would silently rewrite its verification identity`,
@@ -11868,7 +12290,7 @@ ${certified}/${statuses.length} certified \xB7 ${statuses.length - pixelFailures
 }
 var BARS4;
 var init_generate_recorded = __esm({
-  "../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/generate-recorded.ts"() {
+  "packages/cli/src/commands/generate-recorded.ts"() {
     "use strict";
     init_src3();
     init_src5();
@@ -11879,6 +12301,7 @@ var init_generate_recorded = __esm({
     init_env();
     init_environment();
     init_font_guidance();
+    init_invocation();
     init_output();
     BARS4 = {
       pass: { sim: 0.95, ink: 0.95 },
@@ -11887,24 +12310,27 @@ var init_generate_recorded = __esm({
   }
 });
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/bin.ts
+// packages/cli/src/bin.ts
 init_src3();
+init_invocation();
 import { CommanderError } from "commander";
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/program.ts
+// packages/cli/src/program.ts
 init_src3();
 init_environment();
+init_invocation();
 init_doctor();
 import { Command } from "commander";
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/init.ts
+// packages/cli/src/commands/init.ts
 init_src3();
 init_describe();
 init_env();
+init_invocation();
 init_output();
 import { intro, isCancel, outro, password } from "@clack/prompts";
 import fs from "node:fs";
-import path23 from "node:path";
+import path24 from "node:path";
 var INIT_DESCRIPTION = {
   name: "init",
   summary: "Configure Figma and OpenRouter credentials in .env (idempotent).",
@@ -11941,7 +12367,7 @@ async function runInit(flags) {
     printDescription(INIT_DESCRIPTION);
     return;
   }
-  const envPath = path23.resolve(process.cwd(), ".env");
+  const envPath = path24.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);
@@ -11950,7 +12376,7 @@ async function runInit(flags) {
     fail(flags, ExitCode.InputValidation, {
       error: "Missing credentials and prompts are disabled.",
       code: "MISSING_CREDENTIALS",
-      remediation: "Pass --figma-token <token> and --openrouter-key <key>, or run `tendril init` in an interactive terminal."
+      remediation: `Pass --figma-token <token> and --openrouter-key <key>, or run \`${tendrilCommand("init")}\` in an interactive terminal.`
     });
   }
   if (interactive) {
@@ -11962,7 +12388,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 = path23.resolve(process.cwd(), ".gitignore");
+  const gitignorePath = path24.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) {
@@ -12007,26 +12433,27 @@ async function runInit(flags) {
   });
 }
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/generate.ts
+// packages/cli/src/commands/generate.ts
 init_src3();
 init_src();
 init_src5();
 init_src2();
 init_describe();
 init_env();
+init_invocation();
 init_output();
 init_entitlement();
 import { confirm as confirm2, isCancel as isCancel2 } from "@clack/prompts";
-import { readFileSync as readFileSync15, readdirSync as readdirSync4, existsSync as existsSync18 } from "node:fs";
+import { readFileSync as readFileSync15, readdirSync as readdirSync4, existsSync as existsSync19 } from "node:fs";
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/pipeline.ts
+// packages/cli/src/pipeline.ts
 init_src2();
 init_src4();
 init_src6();
 import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync8 } from "node:fs";
-import path24 from "node:path";
+import path25 from "node:path";
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/assets-module.ts
+// packages/cli/src/assets-module.ts
 init_src();
 var KEBAB_ATTRS = {
   "fill-rule": "fillRule",
@@ -12137,7 +12564,7 @@ function buildAssetsModule(assets, aliases = {}) {
   return { source, flags };
 }
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/pipeline.ts
+// packages/cli/src/pipeline.ts
 var VerifyFailedError = class extends Error {
   constructor(loop) {
     super(
@@ -12360,7 +12787,7 @@ async function runGenerationPipeline(input) {
   });
   const written = [];
   if (!input.dryRun) {
-    const dir = path24.resolve(input.outDir, semantics.componentName);
+    const dir = path25.resolve(input.outDir, semantics.componentName);
     mkdirSync5(dir, { recursive: true });
     const files = {
       // Bundle-local tokens: THE emission the component's CSS resolves
@@ -12384,13 +12811,13 @@ async function runGenerationPipeline(input) {
 `
     };
     for (const [name, content] of Object.entries(files)) {
-      const filePath = path24.join(dir, name);
+      const filePath = path25.join(dir, name);
       writeFileSync8(filePath, content);
       written.push(filePath);
     }
     for (const artifact of emitTokenArtifacts(input.mapping)) {
-      const filePath = path24.resolve(input.outDir, artifact.path);
-      mkdirSync5(path24.dirname(filePath), { recursive: true });
+      const filePath = path25.resolve(input.outDir, artifact.path);
+      mkdirSync5(path25.dirname(filePath), { recursive: true });
       writeFileSync8(filePath, artifact.content);
       written.push(filePath);
     }
@@ -12398,7 +12825,7 @@ async function runGenerationPipeline(input) {
   return { semantics, loop: finalLoop, report, componentJson, usageMd: docs.usageMd, written };
 }
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/commands/generate.ts
+// packages/cli/src/commands/generate.ts
 var TOOL_VERSION = "0.0.0";
 var GENERATE_DESCRIPTION = {
   name: "generate",
@@ -12454,7 +12881,7 @@ function resolveProvidedSource(flags, contextFile) {
     fail(flags, ExitCode.InputValidation, {
       error: `Cannot read context file "${contextFile}".`,
       code: "CONTEXT_UNREADABLE",
-      remediation: "Pass a readable JSON file via --context; run `tendril generate --describe` for the payload shape."
+      remediation: `Pass a readable JSON file via --context; run \`${tendrilCommand("generate --describe")}\` for the payload shape.`
     });
   }
   try {
@@ -12463,7 +12890,7 @@ function resolveProvidedSource(flags, contextFile) {
     fail(flags, ExitCode.InputValidation, {
       error: `Context file "${contextFile}" is not a valid design-context payload: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}`,
       code: "CONTEXT_INVALID",
-      remediation: "The payload must match { nodeTree, variables[], metadata, screenshotBase64? } \u2014 see `tendril generate --describe` and docs/adr/003-figma-access-strategy.md."
+      remediation: `The payload must match { nodeTree, variables[], metadata, screenshotBase64? } \u2014 see \`${tendrilCommand("generate --describe")}\` and docs/adr/003-figma-access-strategy.md.`
     });
   }
 }
@@ -12473,7 +12900,7 @@ function resolveSource(flags, url) {
     fail(flags, ExitCode.General, {
       error: "Live Figma transports (desktop MCP / REST) are not wired up yet.",
       code: "NOT_IMPLEMENTED",
-      remediation: "Use `tendril generate --context <file>` with an agent-fetched payload, or mock://button for the offline fixture; live transports are task 1.2 in docs/PLAN.md."
+      remediation: `Use \`${tendrilCommand("generate --context <file>")}\` with an agent-fetched payload, or mock://button for the offline fixture; live transports are task 1.2 in docs/PLAN.md.`
     });
   }
   fail(flags, ExitCode.InputValidation, {
@@ -12492,7 +12919,7 @@ async function runGenerate(url, flags) {
     fail(flags, ExitCode.InputValidation, {
       error: "Missing input: pass a recording set or reference task (recorded truth, the default), mock://button, or --context <file>.",
       code: "MISSING_ARGUMENT",
-      remediation: "Run `tendril generate --describe` to see arguments and examples."
+      remediation: `Run \`${tendrilCommand("generate --describe")}\` to see arguments and examples.`
     });
   }
   url ??= `provided://${flags.context}`;
@@ -12569,10 +12996,10 @@ token mapping (${mapping.flat.length} variables):
   let initialCode;
   let initialSemantics;
   try {
-    if (existsSync18(flags.out)) {
+    if (existsSync19(flags.out)) {
       for (const entry of readdirSync4(flags.out)) {
         const cjPath = `${flags.out}/${entry}/component.json`;
-        if (!existsSync18(cjPath)) continue;
+        if (!existsSync19(cjPath)) continue;
         const cj = JSON.parse(readFileSync15(cjPath, "utf8"));
         if (cj.name !== void 0 && Array.isArray(cj.props)) {
           previousApi = JSON.stringify({
@@ -12581,13 +13008,13 @@ 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 && existsSync18(tsxPath) && existsSync18(cssPath)) {
+          if (flags.refine && existsSync19(tsxPath) && existsSync19(cssPath)) {
             initialCode = {
               tsx: readFileSync15(tsxPath, "utf8"),
               css: readFileSync15(cssPath, "utf8")
             };
             const semPath = `${flags.out}/${entry}/semantics.json`;
-            if (existsSync18(semPath)) {
+            if (existsSync19(semPath)) {
               initialSemantics = JSON.parse(readFileSync15(semPath, "utf8"));
             }
           }
@@ -12617,7 +13044,7 @@ token mapping (${mapping.flat.length} variables):
       fail(flags, ExitCode.Auth, {
         error: "OPENROUTER_API_KEY is not configured.",
         code: "MISSING_OPENROUTER_KEY",
-        remediation: "Run `tendril init` to store your OpenRouter key in .env (BYOK \u2014 your key, your inference)."
+        remediation: `Run \`${tendrilCommand("init")}\` to store your OpenRouter key in .env (BYOK \u2014 your key, your inference).`
       });
     }
     genModel = new OpenRouterGenerationModel(new OpenRouterClient({ apiKey }), model.id, {
@@ -12726,7 +13153,7 @@ bundle written to ${flags.out}/${result.semantics.componentName}/:
   );
 }
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/program.ts
+// packages/cli/src/program.ts
 init_src4();
 function globalFlags(cmd) {
   const opts = cmd.optsWithGlobals();
@@ -12840,7 +13267,7 @@ function buildProgram() {
       fail2(flags, ExitCode.InputValidation, {
         error: family === void 0 ? "nothing to resolve \u2014 pass a family name or --set <recording-dir>" : "pass a family name OR --set, not both \u2014 --set derives families from the recording itself",
         code: "INPUT_VALIDATION",
-        remediation: 'tendril fonts resolve --set <recording-dir>, or tendril fonts resolve "<Family>" --weights 400 500 600'
+        remediation: `${tendrilCommand("fonts resolve --set <recording-dir>")}, or ${tendrilCommand('fonts resolve "<Family>" --weights 400 500 600')}`
       });
     }
     if (set !== void 0) {
@@ -12983,7 +13410,7 @@ function buildProgram() {
   return program;
 }
 
-// ../../../../../../Users/jordyarnoldussen/Desktop/Tendril/packages/cli/src/bin.ts
+// packages/cli/src/bin.ts
 try {
   await buildProgram().parseAsync(process.argv);
 } catch (err) {
@@ -12994,7 +13421,7 @@ try {
     const cliError2 = {
       error: err.message,
       code: "INPUT_VALIDATION",
-      remediation: "Run `tendril --help` or `<command> --describe` for usage."
+      remediation: `Run \`${tendrilCommand("--help")}\` or \`${tendrilCommand("<command> --describe")}\` for usage.`
     };
     process.stderr.write(`${JSON.stringify(cliError2)}
 `);