@tendrilapp/cli 0.1.33 → 0.1.34

package/dist/tendril.js

@@ -449,7 +449,7 @@ function parseVariantAxes(nodeName) {
   if (!nodeName.includes("=")) return void 0;
   const axes = {};
   for (const pair of nodeName.split(",")) {
-    const [key, value] = pair.split("=").map((s) => s.trim());
+    const [key, value] = pair.split("=").map((s) => decodeXmlEntities(s.trim()));
     if (key !== void 0 && key !== "" && value !== void 0 && value !== "") {
       axes[key] = [value];
     }
@@ -785,7 +785,7 @@ function resolveAxisDefaultWithRule(domain, recorded, override) {
 function resolveAxisDefault(domain, recorded, override) {
   return resolveAxisDefaultWithRule(domain, recorded, override).value;
 }
-var INTERACTION_STATES, BOOLEAN_STATES, ENGAGED_STATES, INTERACTION_EVIDENCE_VALUES, kebab, OFF_VALUES, ON_VALUES;
+var INTERACTION_STATES, BOOLEAN_STATES, ENGAGED_STATES, INTERACTION_EVIDENCE_VALUES, ENGAGED_STATE_VALUES, INTERACTION_TREATMENT_VALUES, kebab, OFF_VALUES, ON_VALUES;
 var init_axis_defaults = __esm({
   "packages/figma/src/recording/axis-defaults.ts"() {
     "use strict";
@@ -793,6 +793,32 @@ var init_axis_defaults = __esm({
     BOOLEAN_STATES = /* @__PURE__ */ new Set(["disabled", "loading"]);
     ENGAGED_STATES = /* @__PURE__ */ new Set(["selected", "checked", "indeterminate", "mixed", "open", "expanded"]);
     INTERACTION_EVIDENCE_VALUES = /* @__PURE__ */ new Set([
+      ...INTERACTION_STATES,
+      ...BOOLEAN_STATES,
+      "hovered",
+      "focused",
+      "press",
+      "selected",
+      "checked",
+      "unselected",
+      "unchecked",
+      "indeterminate",
+      // Cycle B C4: engaged/typing evidence. A dropdown's open pose and an
+      // input's typing pose PROVE the control is interactive — the sweep
+      // measured "the recording proves no interactive poses" printed for
+      // dropdowns and inputs (the trust anchor calling a control "not a
+      // control"). DELIBERATE VERDICT CHANGE, release-noted: a set with
+      // these poses and ZERO verified interaction behaviors now honestly
+      // fails the interaction-evidence gate instead of passing silently.
+      "open",
+      "expanded",
+      "typing",
+      "on",
+      "off",
+      "filled"
+    ]);
+    ENGAGED_STATE_VALUES = /* @__PURE__ */ new Set(["open", "expanded", "typing", "on", "off", "filled"]);
+    INTERACTION_TREATMENT_VALUES = /* @__PURE__ */ new Set([
       ...INTERACTION_STATES,
       ...BOOLEAN_STATES,
       "hovered",
@@ -1326,15 +1352,81 @@ var init_session = __esm({
   }
 });
 
+// packages/figma/src/recording/visibility.ts
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import path2 from "node:path";
+function effectivelyInvisible(node) {
+  if (node.hidden === true) return true;
+  if (node.width === 0 || node.height === 0) return true;
+  return false;
+}
+function repVisibility(setDir, slug) {
+  const file = path2.join(setDir, slug, "get_metadata.json");
+  if (!existsSync2(file)) return void 0;
+  let roots;
+  try {
+    roots = parseMetadataForest(envelopeTextContent(JSON.parse(readFileSync2(file, "utf8")))).roots;
+  } catch {
+    return void 0;
+  }
+  const byId = /* @__PURE__ */ new Map();
+  const byName = /* @__PURE__ */ new Map();
+  const hiddenIds = /* @__PURE__ */ new Set();
+  const walk2 = (n, underHidden) => {
+    const invisible = underHidden || effectivelyInvisible(n);
+    byId.set(n.id, !invisible);
+    if (invisible) hiddenIds.add(n.id);
+    const norm2 = normalizedLayerName(n.name);
+    if (norm2 !== "") byName.set(norm2, (byName.get(norm2) ?? false) || !invisible);
+    for (const c of n.children) walk2(c, invisible);
+  };
+  for (const rootNode of roots) walk2(rootNode, false);
+  return { byId, byName, hiddenIds };
+}
+function poseVisibility(setDir, repSlugs, match) {
+  const presentIn = [];
+  const visibleIn = [];
+  const norm2 = match.name === void 0 ? void 0 : normalizedLayerName(match.name);
+  for (const slug of repSlugs) {
+    const rep = repVisibility(setDir, slug);
+    if (rep === void 0) continue;
+    let present = false;
+    let visible = false;
+    if (match.nodeId !== void 0 && rep.byId.has(match.nodeId)) {
+      present = true;
+      visible = rep.byId.get(match.nodeId) === true;
+    }
+    if (!present && norm2 !== void 0 && rep.byName.has(norm2)) {
+      present = true;
+      visible = rep.byName.get(norm2) === true;
+    }
+    if (present) {
+      presentIn.push(slug);
+      if (visible) visibleIn.push(slug);
+    }
+  }
+  return { presentIn, visibleIn };
+}
+var normalizedLayerName, invisibleInEveryPose;
+var init_visibility = __esm({
+  "packages/figma/src/recording/visibility.ts"() {
+    "use strict";
+    init_normalize();
+    init_session();
+    normalizedLayerName = (name) => name.toLowerCase().replace(/[^a-z0-9]/g, "");
+    invisibleInEveryPose = (v) => v.presentIn.length > 0 && v.visibleIn.length === 0;
+  }
+});
+
 // packages/figma/src/recording/compose.ts
 import { createHash } from "node:crypto";
-import { existsSync as existsSync2, readFileSync as readFileSync2, readdirSync, statSync } from "node:fs";
-import path2 from "node:path";
+import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync, statSync } from "node:fs";
+import path3 from "node:path";
 import { z as z5 } from "zod";
 function buildComposeIndex(roots, depth = 3) {
   const found = [];
   const walk2 = (dir, remaining) => {
-    if (existsSync2(path2.join(dir, "recording-set.json"))) {
+    if (existsSync3(path3.join(dir, "recording-set.json"))) {
       found.push(dir);
       return;
     }
@@ -1347,17 +1439,17 @@ function buildComposeIndex(roots, depth = 3) {
     }
     for (const e of entries2) {
       if (e === "node_modules" || e.startsWith(".")) continue;
-      const full = path2.join(dir, e);
+      const full = path3.join(dir, e);
       try {
         if (statSync(full).isDirectory()) walk2(full, remaining - 1);
       } catch {
       }
     }
   };
-  for (const r of roots) walk2(path2.resolve(r), depth);
+  for (const r of roots) walk2(path3.resolve(r), depth);
   const seen = /* @__PURE__ */ new Set();
   const uniqueDirs = found.filter((d) => {
-    const key = path2.resolve(d);
+    const key = path3.resolve(d);
     if (seen.has(key)) return false;
     seen.add(key);
     return true;
@@ -1377,10 +1469,10 @@ function buildComposeIndex(roots, depth = 3) {
     for (const rep of manifest.reps) {
       variantNodeIds.add(rep.nodeId);
       repSlugByVariantNode.set(rep.nodeId, rep.slug);
-      const metaFile = path2.join(dir, rep.slug, "get_metadata.json");
-      if (!existsSync2(metaFile)) continue;
+      const metaFile = path3.join(dir, rep.slug, "get_metadata.json");
+      if (!existsSync3(metaFile)) continue;
       try {
-        const text = envelopeTextContent(JSON.parse(readFileSync2(metaFile, "utf8")));
+        const text = envelopeTextContent(JSON.parse(readFileSync3(metaFile, "utf8")));
         const ids = /* @__PURE__ */ new Set();
         const collect = (n) => {
           if (n.id !== "") ids.add(n.id);
@@ -1413,11 +1505,11 @@ function sameComponent(a, b) {
   return false;
 }
 function emissionTails(setDir, repSlug) {
-  const file = path2.join(setDir, repSlug, "get_design_context.json");
-  if (!existsSync2(file)) return /* @__PURE__ */ new Map();
+  const file = path3.join(setDir, repSlug, "get_design_context.json");
+  if (!existsSync3(file)) return /* @__PURE__ */ new Map();
   let text;
   try {
-    text = envelopeTextContent(JSON.parse(readFileSync2(file, "utf8")));
+    text = envelopeTextContent(JSON.parse(readFileSync3(file, "utf8")));
   } catch {
     return /* @__PURE__ */ new Map();
   }
@@ -1437,16 +1529,20 @@ function emissionTails(setDir, repSlug) {
   return byHead;
 }
 function hostInstances(setDir, repSlug) {
-  const metaFile = path2.join(setDir, repSlug, "get_metadata.json");
-  if (!existsSync2(metaFile)) return [];
+  const metaFile = path3.join(setDir, repSlug, "get_metadata.json");
+  if (!existsSync3(metaFile)) return [];
   try {
-    const text = envelopeTextContent(JSON.parse(readFileSync2(metaFile, "utf8")));
+    const text = envelopeTextContent(JSON.parse(readFileSync3(metaFile, "utf8")));
     const out = [];
-    const walk2 = (n) => {
-      if (n.type === "INSTANCE") out.push({ id: n.id, name: n.name });
-      for (const c of n.children) walk2(c);
+    const walkRoot = (root) => {
+      const walk2 = (n, underHidden) => {
+        const invisible = underHidden || effectivelyInvisible(n);
+        if (n.type === "INSTANCE") out.push({ id: n.id, name: n.name, visible: !invisible });
+        for (const c of n.children) walk2(c, invisible);
+      };
+      walk2(root, false);
     };
-    for (const root of parseMetadataForest(text).roots) walk2(root);
+    for (const root of parseMetadataForest(text).roots) walkRoot(root);
     return out;
   } catch {
     return [];
@@ -1455,12 +1551,32 @@ function hostInstances(setDir, repSlug) {
 function composeReport(index) {
   const edges = [];
   for (const host of index) {
+    const visibleEver = /* @__PURE__ */ new Map();
+    for (const [, repSlug] of host.repSlugByVariantNode) {
+      for (const inst of hostInstances(host.dir, repSlug)) {
+        visibleEver.set(inst.id, (visibleEver.get(inst.id) ?? false) || inst.visible);
+      }
+    }
     for (const [variantNodeId, slug] of host.repSlugByVariantNode) {
       void variantNodeId;
       const instances = hostInstances(host.dir, slug);
       if (instances.length === 0) continue;
       const tailsByHead = emissionTails(host.dir, slug);
       for (const inst of instances) {
+        if (visibleEver.get(inst.id) !== true) {
+          edges.push({
+            hostSet: host.dir,
+            hostRep: slug,
+            instanceId: inst.id,
+            instanceName: inst.name,
+            kind: "hidden",
+            partners: [],
+            disclosures: [
+              `HIDDEN in every recorded pose \u2014 the designer's off-switch is unambiguous, so no composition is proposed (obligations require visible recorded truth). If this region should compose, add a pose that SHOWS the instance and re-record.`
+            ]
+          });
+          continue;
+        }
         const tails = tailsByHead.get(inst.id) ?? /* @__PURE__ */ new Map();
         const disclosures = [];
         const refused = [];
@@ -1488,7 +1604,7 @@ function composeReport(index) {
         }
         const eligible = [];
         for (const g of groups) {
-          const uncaptured = [host.figmaFile === void 0 ? "the host set" : void 0, ...g.map((m) => m.figmaFile === void 0 ? path2.basename(m.dir) : void 0)].filter(
+          const uncaptured = [host.figmaFile === void 0 ? "the host set" : void 0, ...g.map((m) => m.figmaFile === void 0 ? path3.basename(m.dir) : void 0)].filter(
             (x) => x !== void 0
           );
           if (uncaptured.length > 0) {
@@ -1600,11 +1716,11 @@ function composeReport(index) {
   return edges;
 }
 function confirmedCompositionStatus(hostSet) {
-  const manifestFile = path2.join(hostSet, "recording-set.json");
-  if (!existsSync2(manifestFile)) return { rows: [] };
+  const manifestFile = path3.join(hostSet, "recording-set.json");
+  if (!existsSync3(manifestFile)) return { rows: [] };
   let rawEntries;
   try {
-    const parsed = JSON.parse(readFileSync2(manifestFile, "utf8"));
+    const parsed = JSON.parse(readFileSync3(manifestFile, "utf8"));
     rawEntries = Array.isArray(parsed["compositions"]) ? parsed["compositions"] : [];
   } catch {
     return { rows: [], malformed: "the recording-set manifest is not readable JSON" };
@@ -1623,11 +1739,11 @@ function confirmedCompositionStatus(hostSet) {
   const rows = [];
   for (const entry of confirmed) {
     const partnerRels = Object.keys(entry.partner.manifestSha256).map(fromStoredRel);
-    const partnerDirs = partnerRels.map((rel) => path2.resolve(hostSet, rel));
+    const partnerDirs = partnerRels.map((rel) => path3.resolve(hostSet, rel));
     const entryKey = fromStoredRel(entry.partner.key);
     const affectedReps = [...new Set(entry.instances.map((i) => i.hostRep))];
     const remediation = `re-run \`tendril compose --set ${hostSet}\` after repairing`;
-    const missing = partnerDirs.filter((d) => !existsSync2(path2.join(d, "recording-set.json")));
+    const missing = partnerDirs.filter((d) => !existsSync3(path3.join(d, "recording-set.json")));
     if (missing.length > 0) {
       rows.push({
         key: entryKey,
@@ -1635,17 +1751,17 @@ function confirmedCompositionStatus(hostSet) {
         status: "partner-missing",
         instances: entry.instances,
         affectedReps,
-        detail: `confirmed partner set(s) not found: ${missing.map((d) => toPosixRel(path2.relative(hostSet, d))).join(", ")} \u2014 the decision names recordings that are not there; ${remediation}`
+        detail: `confirmed partner set(s) not found: ${missing.map((d) => toPosixRel(path3.relative(hostSet, d))).join(", ")} \u2014 the decision names recordings that are not there; ${remediation}`
       });
       continue;
     }
     let stale = false;
     let unreadable;
     for (const rel of partnerRels) {
-      const file = path2.join(path2.resolve(hostSet, rel), "recording-set.json");
+      const file = path3.join(path3.resolve(hostSet, rel), "recording-set.json");
       try {
-        const bytes = readFileSync2(file);
-        loadManifest(path2.resolve(hostSet, rel));
+        const bytes = readFileSync3(file);
+        loadManifest(path3.resolve(hostSet, rel));
         const storedSha = entry.partner.manifestSha256[Object.keys(entry.partner.manifestSha256).find((k) => fromStoredRel(k) === rel)];
         if (createHashHex(bytes) !== storedSha) stale = true;
       } catch (err) {
@@ -1667,8 +1783,8 @@ function confirmedCompositionStatus(hostSet) {
     const edges = composeReport(buildComposeIndex([hostSet, ...partnerDirs]));
     const supportedInstances = /* @__PURE__ */ new Map();
     for (const e of edges) {
-      if (e.hostSet !== path2.resolve(hostSet) || e.kind !== "substitution" || e.pose === void 0) continue;
-      if (pairKeyFor(path2.resolve(hostSet), e.partners.map((p) => p.dir)) !== entryKey) continue;
+      if (e.hostSet !== path3.resolve(hostSet) || e.kind !== "substitution" || e.pose === void 0) continue;
+      if (pairKeyFor(path3.resolve(hostSet), e.partners.map((p) => p.dir)) !== entryKey) continue;
       supportedInstances.set(`${e.hostRep}\0${e.instanceId}`, e.pose.variantNodeId);
     }
     const unsupported = entry.instances.filter((i) => supportedInstances.get(`${i.hostRep}\0${i.instanceId}`) !== i.poseVariantNodeId);
@@ -1679,7 +1795,7 @@ function confirmedCompositionStatus(hostSet) {
       status: ok ? stale ? "stale-supported" : "supported" : stale ? "stale-unsupported" : "unsupported",
       instances: entry.instances,
       affectedReps: ok ? [] : [...new Set(unsupported.map((i) => i.hostRep))],
-      detail: ok ? stale ? "the partner manifest changed since the decision (pinned bytes differ) \u2014 the CURRENT recordings still support every confirmed edge" : "the recordings support every confirmed edge (identity, rep attribution and pose re-derived)" : `${unsupported.length} confirmed instance(s) are NOT supported by the current recordings (${unsupported.map((i) => `${i.hostRep}/${i.instanceId}`).join(", ")}) \u2014 a confirmed composition the evidence does not derive; ${remediation}`
+      detail: ok ? stale ? "the partner manifest changed since the decision (pinned bytes differ) \u2014 the CURRENT recordings still support every confirmed edge" : "the recordings support every confirmed edge (identity, rep attribution and pose re-derived)" : `${unsupported.length} confirmed instance(s) are NOT supported by the current recordings (${unsupported.map((i) => `${i.hostRep}/${i.instanceId}`).join(", ")}) \u2014 a confirmed composition the evidence does not derive; ${remediation}. If the instance is HIDDEN in every recorded pose, this confirmation predates the visibility principle (Cycle A) and re-running compose cannot re-open it (asked-once): either re-record a pose that SHOWS the instance, or remove this entry from the manifest's compositions array by hand \u2014 a retire flag is a named follow-up`
     });
   }
   return { rows, ...malformedEntries.length > 0 ? { malformed: malformedEntries.join("; ") } : {} };
@@ -1693,6 +1809,7 @@ var init_compose = __esm({
     "use strict";
     init_session();
     init_normalize();
+    init_visibility();
     CompositionEntrySchema = z5.object({
       v: z5.literal(1),
       partner: z5.object({
@@ -1706,39 +1823,53 @@ var init_compose = __esm({
     });
     norm = (s) => s.toLowerCase().replace(/\s+/g, " ").trim();
     FOOTER = /Node ids have been added to the code as data attributes/i;
-    kitLabel = (e) => `${e.displayName} [${path2.basename(e.dir)}${e.figmaFile !== void 0 ? `, file ${e.figmaFile}` : ", file identity NOT captured"}]`;
-    toPosixRel = (rel) => rel.split(path2.sep).join("/");
+    kitLabel = (e) => `${e.displayName} [${path3.basename(e.dir)}${e.figmaFile !== void 0 ? `, file ${e.figmaFile}` : ", file identity NOT captured"}]`;
+    toPosixRel = (rel) => rel.split(path3.sep).join("/");
     fromStoredRel = (rel) => rel.replace(/\\/g, "/");
-    pairKeyFor = (hostSet, dirs) => dirs.map((d) => toPosixRel(path2.relative(hostSet, d))).sort().join("+");
+    pairKeyFor = (hostSet, dirs) => dirs.map((d) => toPosixRel(path3.relative(hostSet, d))).sort().join("+");
   }
 });
 
 // packages/figma/src/recording/roles.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
-import path3 from "node:path";
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
+import path4 from "node:path";
 function emissionIdSets(emission) {
   const own = /* @__PURE__ */ new Set();
   const referenced = /* @__PURE__ */ new Set();
+  const tailsByHead = /* @__PURE__ */ new Map();
   for (const m of emission.matchAll(NODE_ID_RE)) {
     const id = m[1];
     if (id.startsWith("I")) {
       const segments = id.slice(1).split(";");
       const head = segments[0];
-      if (head !== void 0) own.add(head);
+      if (head !== void 0) {
+        own.add(head);
+        const tails = tailsByHead.get(head) ?? tailsByHead.set(head, /* @__PURE__ */ new Set()).get(head);
+        for (const seg of segments.slice(1)) tails.add(seg);
+      }
       for (const seg of segments.slice(1)) referenced.add(seg);
     } else {
       own.add(id);
     }
   }
-  return { own, referenced };
+  return { own, referenced, tailsByHead };
 }
 function deriveRoles(setDir, manifest) {
   const m = manifest ?? loadManifest(setDir);
-  const reps = m.reps.filter((r) => existsSync3(path3.join(setDir, r.slug, "get_design_context.json")));
+  const reps = m.reps.filter((r) => existsSync4(path4.join(setDir, r.slug, "get_design_context.json")));
   const sets = /* @__PURE__ */ new Map();
   for (const rep of reps) {
-    const env = JSON.parse(readFileSync3(path3.join(setDir, rep.slug, "get_design_context.json"), "utf8"));
+    const env = JSON.parse(readFileSync4(path4.join(setDir, rep.slug, "get_design_context.json"), "utf8"));
     const ids = emissionIdSets(env.content.map((c) => c.text ?? "").join("\n"));
+    const hiddenHeads = repVisibility(setDir, rep.slug)?.hiddenIds;
+    if (hiddenHeads !== void 0) {
+      const visibleTails = /* @__PURE__ */ new Set();
+      for (const [head, tails] of ids.tailsByHead) if (!hiddenHeads.has(head)) for (const t of tails) visibleTails.add(t);
+      for (const [head, tails] of ids.tailsByHead) {
+        if (!hiddenHeads.has(head)) continue;
+        for (const t of tails) if (!visibleTails.has(t)) ids.referenced.delete(t);
+      }
+    }
     ids.own.add(rep.nodeId);
     sets.set(rep.slug, ids);
   }
@@ -1785,6 +1916,7 @@ var init_roles = __esm({
   "packages/figma/src/recording/roles.ts"() {
     "use strict";
     init_session();
+    init_visibility();
     NODE_ID_RE = /data-node-id="([^"]+)"/g;
   }
 });
@@ -1806,6 +1938,7 @@ var init_src = __esm({
     init_axis_defaults();
     init_plan();
     init_compose();
+    init_visibility();
     init_session();
     init_envelope_content();
     init_roles();
@@ -1816,8 +1949,8 @@ var init_src = __esm({
 function variableNameToPath(name) {
   return name.split("/").map(canonicalCssIdentPart).filter((part) => part.length > 0);
 }
-function tokenPathToCssVar(path45) {
-  return `--${path45.join("-")}`;
+function tokenPathToCssVar(path46) {
+  return `--${path46.join("-")}`;
 }
 function toDtcgToken(variable, defaultMode) {
   const modes = Object.keys(variable.valuesByMode);
@@ -1861,11 +1994,11 @@ function toDtcgToken(variable, defaultMode) {
 }
 function mapVariablesToDtcg(variables, defaultMode = "light") {
   const entries = variables.map((variable) => {
-    const path45 = variableNameToPath(variable.name);
-    if (path45.length === 0) {
+    const path46 = variableNameToPath(variable.name);
+    if (path46.length === 0) {
       throw new DtcgMappingError("empty-name", `Figma variable ${variable.id} has an empty name`);
     }
-    return { variable, path: path45 };
+    return { variable, path: path46 };
   });
   const groupPrefixes = /* @__PURE__ */ new Set();
   for (const e of entries) {
@@ -1886,21 +2019,21 @@ function mapVariablesToDtcg(variables, defaultMode = "light") {
   }
   const tokens = {};
   const flat = [];
-  for (const { variable, path: path45 } of entries) {
+  for (const { variable, path: path46 } of entries) {
     const token = toDtcgToken(variable, defaultMode);
     let group = tokens;
-    for (const segment of path45.slice(0, -1)) {
+    for (const segment of path46.slice(0, -1)) {
       const existing = group[segment];
       group = existing ?? (group[segment] = {});
     }
-    const leaf = path45[path45.length - 1];
+    const leaf = path46[path46.length - 1];
     if (group[leaf] !== void 0) {
-      throw new DtcgMappingError("duplicate-path", `Duplicate token path "${path45.join(".")}" (variable ${variable.id})`);
+      throw new DtcgMappingError("duplicate-path", `Duplicate token path "${path46.join(".")}" (variable ${variable.id})`);
     }
     group[leaf] = token;
     flat.push({
-      path: path45.join("."),
-      cssVar: tokenPathToCssVar(path45),
+      path: path46.join("."),
+      cssVar: tokenPathToCssVar(path46),
       type: token.$type,
       value: token.$value
     });
@@ -2089,9 +2222,9 @@ function boundId(value) {
   return isObject(value) && typeof value["boundVariableId"] === "string" ? value["boundVariableId"] : void 0;
 }
 function resolveBinding(ctx, id) {
-  const path45 = ctx.pathById.get(id);
-  if (path45 === void 0) ctx.unresolved.add(id);
-  return path45;
+  const path46 = ctx.pathById.get(id);
+  if (path46 === void 0) ctx.unresolved.add(id);
+  return path46;
 }
 function parseVariantProps(name) {
   if (!name.includes("=")) return void 0;
@@ -2126,8 +2259,8 @@ function walk(ctx, raw) {
       if (!isObject(paint) || paint["visible"] === false) continue;
       const id = boundId(paint);
       if (id !== void 0) {
-        const path45 = resolveBinding(ctx, id);
-        if (path45 !== void 0) tokens.add(path45);
+        const path46 = resolveBinding(ctx, id);
+        if (path46 !== void 0) tokens.add(path46);
       } else if (typeof paint["color"] === "string") {
         ctx.hardcoded.push({ node: name, property, value: paint["color"] });
       }
@@ -2135,8 +2268,8 @@ function walk(ctx, raw) {
   }
   const radiusId = boundId(raw["cornerRadius"]);
   if (radiusId !== void 0) {
-    const path45 = resolveBinding(ctx, radiusId);
-    if (path45 !== void 0) tokens.add(path45);
+    const path46 = resolveBinding(ctx, radiusId);
+    if (path46 !== void 0) tokens.add(path46);
   } else if (typeof raw["cornerRadius"] === "number" && raw["cornerRadius"] !== 0) {
     ctx.hardcoded.push({ node: name, property: "border-radius", value: `${raw["cornerRadius"]}px` });
   }
@@ -2146,10 +2279,10 @@ function walk(ctx, raw) {
     layout = { mode: layoutMode === "HORIZONTAL" ? "flex-row" : "flex-column" };
     const gapId = boundId(raw["itemSpacing"]);
     if (gapId !== void 0) {
-      const path45 = resolveBinding(ctx, gapId);
-      if (path45 !== void 0) {
-        layout.gap = path45;
-        tokens.add(path45);
+      const path46 = resolveBinding(ctx, gapId);
+      if (path46 !== void 0) {
+        layout.gap = path46;
+        tokens.add(path46);
       }
     } else if (typeof raw["itemSpacing"] === "number" && raw["itemSpacing"] !== 0) {
       ctx.hardcoded.push({ node: name, property: "gap", value: `${raw["itemSpacing"]}px` });
@@ -2158,10 +2291,10 @@ function walk(ctx, raw) {
     for (const field of PADDING_FIELDS) {
       const id = boundId(raw[field]);
       if (id !== void 0) {
-        const path45 = resolveBinding(ctx, id);
-        if (path45 !== void 0) {
-          paddingPaths.push(path45);
-          tokens.add(path45);
+        const path46 = resolveBinding(ctx, id);
+        if (path46 !== void 0) {
+          paddingPaths.push(path46);
+          tokens.add(path46);
         }
       } else if (typeof raw[field] === "number" && raw[field] !== 0) {
         ctx.hardcoded.push({ node: name, property: field, value: `${raw[field]}px` });
@@ -2369,25 +2502,25 @@ var init_src3 = __esm({
 });
 
 // packages/cli/src/invocation.ts
-import { existsSync as existsSync4, realpathSync } from "node:fs";
-import path4 from "node:path";
+import { existsSync as existsSync5, realpathSync } from "node:fs";
+import path5 from "node:path";
 import { fileURLToPath } from "node:url";
 function findPathTendril(pathEnv, platform) {
-  const dirs = pathEnv.split(path4.delimiter).filter((d) => d !== "" && !/node_modules[\\/]\.bin/.test(d) && !/[\\/]_npx[\\/]/.test(d));
+  const dirs = pathEnv.split(path5.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 = path4.join(dir, name);
-      if (existsSync4(candidate)) return candidate;
+      const candidate = path5.join(dir, name);
+      if (existsSync5(candidate)) return candidate;
     }
   }
   return null;
 }
 function packageRootOf(file) {
-  let dir = path4.dirname(file);
+  let dir = path5.dirname(file);
   for (; ; ) {
-    if (existsSync4(path4.join(dir, "package.json"))) return dir;
-    const parent = path4.dirname(dir);
+    if (existsSync5(path5.join(dir, "package.json"))) return dir;
+    const parent = path5.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
@@ -2426,18 +2559,18 @@ var init_invocation = __esm({
 
 // packages/verify/src/browser.ts
 import { execFileSync } from "node:child_process";
-import { existsSync as existsSync5, readdirSync as readdirSync2 } from "node:fs";
-import path5 from "node:path";
+import { existsSync as existsSync6, readdirSync as readdirSync2 } from "node:fs";
+import path6 from "node:path";
 function resolveChrome() {
   const fromEnv = process.env["TENDRIL_CHROME"] ?? process.env["CHROME_PATH"];
   if (fromEnv !== void 0 && fromEnv !== "") {
-    if (!existsSync5(fromEnv)) {
+    if (!existsSync6(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 (existsSync5(c)) return c;
+  for (const c of candidates) if (existsSync6(c)) return c;
   if (process.platform !== "win32") {
     for (const name of PATH_NAMES) {
       try {
@@ -2451,7 +2584,7 @@ function resolveChrome() {
 }
 function versionFromInstallDir(exePath) {
   try {
-    const builds = readdirSync2(path5.dirname(exePath), { withFileTypes: true }).filter((e) => e.isDirectory() && /^\d+(\.\d+){3}$/.test(e.name)).map((e) => e.name.split(".").map(Number));
+    const builds = readdirSync2(path6.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 {
@@ -2463,7 +2596,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 path5.win32.basename(exePath, ".exe");
+  return path6.win32.basename(exePath, ".exe");
 }
 function chromeVersion() {
   if (_version !== void 0) return _version;
@@ -2498,32 +2631,32 @@ var init_browser = __esm({
 });
 
 // packages/verify/src/runtime.ts
-import { existsSync as existsSync6, mkdtempSync, symlinkSync } from "node:fs";
+import { existsSync as existsSync7, mkdtempSync, symlinkSync } from "node:fs";
 import { createRequire } from "node:module";
 import os from "node:os";
-import path6 from "node:path";
+import path7 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 path6.resolve(env);
-  return path6.resolve(path6.dirname(fileURLToPath2(import.meta.url)), "..");
+  if (env !== void 0 && env !== "") return path7.resolve(env);
+  return path7.resolve(path7.dirname(fileURLToPath2(import.meta.url)), "..");
 }
 function runtimeNodeModules() {
   const root = runtimePackageRoot();
-  for (let dir = root; ; dir = path6.dirname(dir)) {
-    const candidate = path6.basename(dir) === "node_modules" ? dir : path6.join(dir, "node_modules");
-    if (existsSync6(path6.join(candidate, "react"))) return candidate;
-    if (path6.dirname(dir) === dir) break;
+  for (let dir = root; ; dir = path7.dirname(dir)) {
+    const candidate = path7.basename(dir) === "node_modules" ? dir : path7.join(dir, "node_modules");
+    if (existsSync7(path7.join(candidate, "react"))) return candidate;
+    if (path7.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(path6.join(os.tmpdir(), `tendril-${prefix}-`));
+  const dir = mkdtempSync(path7.join(os.tmpdir(), `tendril-${prefix}-`));
   const nodeModules = runtimeNodeModules();
   try {
-    symlinkSync(nodeModules, path6.join(dir, "node_modules"), "junction");
+    symlinkSync(nodeModules, path7.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.`
@@ -2532,7 +2665,7 @@ function newScratchDir(prefix) {
   return dir;
 }
 function reactPinPlugin() {
-  const req = createRequire(path6.join(runtimePackageRoot(), "package.json"));
+  const req = createRequire(path7.join(runtimePackageRoot(), "package.json"));
   return {
     name: "tendril-react-pin",
     setup(b) {
@@ -2585,9 +2718,9 @@ var init_gates = __esm({
 
 // packages/verify/src/tsc-check.ts
 import ts from "typescript";
-import path7 from "node:path";
+import path8 from "node:path";
 function runTscStrict(files) {
-  const program = ts.createProgram(files.map((f) => path7.resolve(f)), STRICT_OPTIONS);
+  const program = ts.createProgram(files.map((f) => path8.resolve(f)), STRICT_OPTIONS);
   const diagnostics = ts.getPreEmitDiagnostics(program);
   const mapped = diagnostics.map((d) => {
     const file = d.file?.fileName;
@@ -2748,7 +2881,7 @@ var init_token_lint = __esm({
 
 // packages/verify/src/loop.ts
 import { rmSync, writeFileSync as writeFileSync2 } from "node:fs";
-import path8 from "node:path";
+import path9 from "node:path";
 async function runChecks(componentName, files, extraFiles, definedVars2) {
   const findings = [];
   for (const violation of scanForbiddenPatterns(files.tsx)) {
@@ -2763,10 +2896,10 @@ async function runChecks(componentName, files, extraFiles, definedVars2) {
   }
   const workDir = newScratchDir("loop");
   try {
-    const tsxPath = path8.join(workDir, `${componentName}.tsx`);
+    const tsxPath = path9.join(workDir, `${componentName}.tsx`);
     writeFileSync2(tsxPath, files.tsx);
     for (const [name, content] of Object.entries(extraFiles ?? {})) {
-      writeFileSync2(path8.join(workDir, name), content);
+      writeFileSync2(path9.join(workDir, name), content);
     }
     const tsc = runTscStrict([tsxPath]);
     for (const d of tsc.diagnostics) {
@@ -3417,7 +3550,7 @@ var init_image_diff = __esm({
 });
 
 // packages/verify/src/visual-facts.ts
-import path9 from "node:path";
+import path10 from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 import { build } from "esbuild";
 import { chromium } from "playwright-core";
@@ -3962,7 +4095,7 @@ var init_visual_facts = __esm({
     init_browser();
     init_mount_limits();
     init_image_diff();
-    RESOLVE_DIR = path9.resolve(path9.dirname(fileURLToPath3(import.meta.url)), "..");
+    RESOLVE_DIR = path10.resolve(path10.dirname(fileURLToPath3(import.meta.url)), "..");
     TOLERANCE_PX = 2;
     WIDTH_SLACK = 0.25;
     IMAGE_SIMILARITY_FLOOR = 0.8;
@@ -3971,14 +4104,14 @@ var init_visual_facts = __esm({
 });
 
 // packages/verify/src/paths.ts
-import path10 from "node:path";
+import path11 from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 var VERIFY_PKG_DIR, REPO_ROOT;
 var init_paths = __esm({
   "packages/verify/src/paths.ts"() {
     "use strict";
-    VERIFY_PKG_DIR = path10.resolve(path10.dirname(fileURLToPath4(import.meta.url)), "..");
-    REPO_ROOT = path10.resolve(VERIFY_PKG_DIR, "..", "..");
+    VERIFY_PKG_DIR = path11.resolve(path11.dirname(fileURLToPath4(import.meta.url)), "..");
+    REPO_ROOT = path11.resolve(VERIFY_PKG_DIR, "..", "..");
   }
 });
 
@@ -4097,9 +4230,9 @@ var init_font_collection = __esm({
 });
 
 // packages/verify/src/font-discovery.ts
-import { existsSync as existsSync7, readdirSync as readdirSync3, readFileSync as readFileSync4, realpathSync as realpathSync2 } from "node:fs";
+import { existsSync as existsSync8, readdirSync as readdirSync3, readFileSync as readFileSync5, realpathSync as realpathSync2 } from "node:fs";
 import os2 from "node:os";
-import path11 from "node:path";
+import path12 from "node:path";
 function weightFromSubfamily(subfamily) {
   for (const [re, w] of WEIGHT_TOKENS) if (re.test(subfamily)) return w;
   return void 0;
@@ -4145,7 +4278,7 @@ function faceAt(bytes, view, dirOffset, file, faceIndex) {
 }
 function facesInFile(file) {
   try {
-    const bytes = new Uint8Array(readFileSync4(file));
+    const bytes = new Uint8Array(readFileSync5(file));
     if (bytes.length < 12) return [];
     const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
     if (isCollection(bytes)) {
@@ -4165,13 +4298,13 @@ function facesInFile(file) {
 }
 function systemFontDirs() {
   const env = process.env["TENDRIL_SYSTEM_FONT_DIRS"];
-  if (env !== void 0 && env !== "") return env.split(path11.delimiter).filter((d) => d !== "" && existsSync7(d));
+  if (env !== void 0 && env !== "") return env.split(path12.delimiter).filter((d) => d !== "" && existsSync8(d));
   const home = os2.homedir();
-  const dirs = process.platform === "darwin" ? ["/System/Library/Fonts", "/Library/Fonts", path11.join(home, "Library", "Fonts")] : process.platform === "win32" ? [
-    path11.join(process.env["WINDIR"] ?? "C:\\Windows", "Fonts"),
-    ...process.env["LOCALAPPDATA"] !== void 0 ? [path11.join(process.env["LOCALAPPDATA"], "Microsoft", "Windows", "Fonts")] : []
-  ] : ["/usr/share/fonts", "/usr/local/share/fonts", path11.join(home, ".fonts"), path11.join(home, ".local", "share", "fonts")];
-  return dirs.filter((d) => existsSync7(d));
+  const dirs = process.platform === "darwin" ? ["/System/Library/Fonts", "/Library/Fonts", path12.join(home, "Library", "Fonts")] : process.platform === "win32" ? [
+    path12.join(process.env["WINDIR"] ?? "C:\\Windows", "Fonts"),
+    ...process.env["LOCALAPPDATA"] !== void 0 ? [path12.join(process.env["LOCALAPPDATA"], "Microsoft", "Windows", "Fonts")] : []
+  ] : ["/usr/share/fonts", "/usr/local/share/fonts", path12.join(home, ".fonts"), path12.join(home, ".local", "share", "fonts")];
+  return dirs.filter((d) => existsSync8(d));
 }
 function discoverSystemFaces(dirs = systemFontDirs(), depth = 3) {
   const seen = /* @__PURE__ */ new Set();
@@ -4185,10 +4318,10 @@ function discoverSystemFaces(dirs = systemFontDirs(), depth = 3) {
         continue;
       }
       for (const e of entries) {
-        const full = path11.join(dir, e.name);
+        const full = path12.join(dir, e.name);
         if (e.isDirectory()) {
           if (remaining > 1) faces.push(...walk2([full], remaining - 1));
-        } else if (FONT_EXTENSIONS.has(path11.extname(e.name).toLowerCase())) {
+        } else if (FONT_EXTENSIONS.has(path12.extname(e.name).toLowerCase())) {
           let key = full;
           try {
             key = realpathSync2(full);
@@ -4237,13 +4370,13 @@ var init_font_discovery = __esm({
 
 // packages/verify/src/font-resolve.ts
 import { createHash as createHash2 } from "node:crypto";
-import { existsSync as existsSync8, mkdirSync as mkdirSync2, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync9, mkdirSync as mkdirSync2, readFileSync as readFileSync6, writeFileSync as writeFileSync3 } from "node:fs";
 import os3 from "node:os";
-import path12 from "node:path";
+import path13 from "node:path";
 function fontCacheDir() {
   const env = process.env["TENDRIL_FONT_CACHE"];
-  if (env !== void 0 && env !== "") return path12.resolve(env);
-  return path12.join(os3.homedir(), ".tendril", "fonts");
+  if (env !== void 0 && env !== "") return path13.resolve(env);
+  return path13.join(os3.homedir(), ".tendril", "fonts");
 }
 function normalizeFontLicense(value) {
   return typeof value === "string" && FONT_LICENSES.includes(value) ? value : "unknown";
@@ -4308,29 +4441,29 @@ async function resolveFonts(family, weights, cacheDir = DEFAULT_FONT_CACHE) {
       }
       const bytes = new Uint8Array(await fileRes.arrayBuffer());
       const sha256 = createHash2("sha256").update(bytes).digest("hex");
-      const file = path12.join(cacheDir, `${family.toLowerCase().replace(/\s+/g, "-")}-${weight}.woff2`);
+      const file = path13.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 = path12.join(cacheDir, "manifest.json");
-  const prior = existsSync8(mPath) ? JSON.parse(readFileSync5(mPath, "utf8")) : [];
-  const portable2 = resolved.map((m) => ({ ...m, file: path12.basename(m.file) }));
+  const mPath = path13.join(cacheDir, "manifest.json");
+  const prior = existsSync9(mPath) ? JSON.parse(readFileSync6(mPath, "utf8")) : [];
+  const portable2 = resolved.map((m) => ({ ...m, file: path13.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, faceIndex, provenance = "local") {
-  const src = path12.resolve(filePath);
-  if (!existsSync8(src)) throw new Error(`font file not found: ${src}`);
-  const ext = path12.extname(src).toLowerCase();
+  const src = path13.resolve(filePath);
+  if (!existsSync9(src)) throw new Error(`font file not found: ${src}`);
+  const ext = path13.extname(src).toLowerCase();
   if (![".woff2", ".woff", ".ttf", ".otf", ".ttc"].includes(ext)) {
     throw new Error(`unsupported font file "${ext}" \u2014 use .woff2 (preferred), .woff, .ttf, .otf or .ttc`);
   }
-  let bytes = new Uint8Array(readFileSync5(src));
+  let bytes = new Uint8Array(readFileSync6(src));
   if (bytes.length === 0) throw new Error(`font file is empty: ${src}`);
   let storedExt = ext;
   if (isCollection(bytes)) {
@@ -4340,7 +4473,7 @@ function addLocalFont(family, weight, filePath, cacheDir = DEFAULT_FONT_CACHE, f
       const all = listCollectionFaces(bytes);
       const shown = (candidates.length > 0 ? candidates : all).map((f) => `  --face ${f.index}  ${f.family ?? "(unnamed)"}${f.subfamily !== void 0 ? ` ${f.subfamily}` : ""}`).join("\n");
       throw new Error(
-        `${path12.basename(src)} is a collection of ${all.length} faces and ${candidates.length === 0 ? `none is named "${family}"` : `${candidates.length} match "${family}"`} \u2014 name the one you mean with --face <index>:
+        `${path13.basename(src)} is a collection of ${all.length} faces and ${candidates.length === 0 ? `none is named "${family}"` : `${candidates.length} match "${family}"`} \u2014 name the one you mean with --face <index>:
 ${shown}`
       );
     }
@@ -4349,20 +4482,20 @@ ${shown}`
   }
   mkdirSync2(cacheDir, { recursive: true });
   const sha256 = createHash2("sha256").update(bytes).digest("hex");
-  const file = path12.join(cacheDir, `${family.toLowerCase().replace(/\s+/g, "-")}-${weight}${storedExt}`);
+  const file = path13.join(cacheDir, `${family.toLowerCase().replace(/\s+/g, "-")}-${weight}${storedExt}`);
   writeFileSync3(file, bytes);
-  const face = { family, weight, source: `${provenance}:${path12.basename(src)}`, sha256, file, license: "unknown" };
-  const mPath = path12.join(cacheDir, "manifest.json");
-  const prior = existsSync8(mPath) ? JSON.parse(readFileSync5(mPath, "utf8")) : [];
-  const merged = [...prior.filter((p) => !(p.family === family && p.weight === weight)), { ...face, file: path12.basename(file) }];
+  const face = { family, weight, source: `${provenance}:${path13.basename(src)}`, sha256, file, license: "unknown" };
+  const mPath = path13.join(cacheDir, "manifest.json");
+  const prior = existsSync9(mPath) ? JSON.parse(readFileSync6(mPath, "utf8")) : [];
+  const merged = [...prior.filter((p) => !(p.family === family && p.weight === weight)), { ...face, file: path13.basename(file) }];
   writeFileSync3(mPath, `${JSON.stringify(merged, null, 2)}
 `);
   return face;
 }
 function checkFontLock(lockPath, cacheDir = DEFAULT_FONT_CACHE) {
-  const lock = JSON.parse(readFileSync5(lockPath, "utf8"));
-  const mPath = path12.join(cacheDir, "manifest.json");
-  const manifest = existsSync8(mPath) ? JSON.parse(readFileSync5(mPath, "utf8")) : [];
+  const lock = JSON.parse(readFileSync6(lockPath, "utf8"));
+  const mPath = path13.join(cacheDir, "manifest.json");
+  const manifest = existsSync9(mPath) ? JSON.parse(readFileSync6(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" };
@@ -4370,11 +4503,11 @@ function checkFontLock(lockPath, cacheDir = DEFAULT_FONT_CACHE) {
   });
 }
 function resolvedFontFamilies(cacheDir = DEFAULT_FONT_CACHE) {
-  const mPath = path12.join(cacheDir, "manifest.json");
-  if (!existsSync8(mPath)) return [];
+  const mPath = path13.join(cacheDir, "manifest.json");
+  if (!existsSync9(mPath)) return [];
   let entries;
   try {
-    entries = JSON.parse(readFileSync5(mPath, "utf8"));
+    entries = JSON.parse(readFileSync6(mPath, "utf8"));
   } catch {
     return [];
   }
@@ -4388,8 +4521,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 = path12.join(cacheDir, "manifest.json");
-  const manifest = existsSync8(mPath) ? JSON.parse(readFileSync5(mPath, "utf8")) : [];
+  const mPath = path13.join(cacheDir, "manifest.json");
+  const manifest = existsSync9(mPath) ? JSON.parse(readFileSync6(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,
@@ -4402,11 +4535,11 @@ function requiredFontsManifest(families, cacheDir = DEFAULT_FONT_CACHE) {
   }));
 }
 function facesMissingLicense(cacheDir = DEFAULT_FONT_CACHE) {
-  const mPath = path12.join(cacheDir, "manifest.json");
-  if (!existsSync8(mPath)) return [];
+  const mPath = path13.join(cacheDir, "manifest.json");
+  if (!existsSync9(mPath)) return [];
   let entries;
   try {
-    entries = JSON.parse(readFileSync5(mPath, "utf8"));
+    entries = JSON.parse(readFileSync6(mPath, "utf8"));
   } catch {
     return [];
   }
@@ -4415,20 +4548,20 @@ 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 = path12.join(cacheDir, "manifest.json");
-  if (!existsSync8(mPath)) return [];
+  const mPath = path13.join(cacheDir, "manifest.json");
+  if (!existsSync9(mPath)) return [];
   let entries;
   try {
-    entries = JSON.parse(readFileSync5(mPath, "utf8"));
+    entries = JSON.parse(readFileSync6(mPath, "utf8"));
   } catch {
     return [];
   }
   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 = path12.isAbsolute(e.file) && existsSync8(e.file) ? e.file : path12.resolve(cacheDir, path12.basename(e.file));
-    if (!existsSync8(file)) continue;
-    if (createHash2("sha256").update(readFileSync5(file)).digest("hex") !== e.sha256) continue;
+    const file = path13.isAbsolute(e.file) && existsSync9(e.file) ? e.file : path13.resolve(cacheDir, path13.basename(e.file));
+    if (!existsSync9(file)) continue;
+    if (createHash2("sha256").update(readFileSync6(file)).digest("hex") !== e.sha256) continue;
     const set = byFamily.get(e.family) ?? /* @__PURE__ */ new Set();
     set.add(e.weight);
     byFamily.set(e.family, set);
@@ -4449,8 +4582,8 @@ function addSystemFamily(family, opts = {}) {
   const skipped = [];
   const overwrote = [];
   const cacheDir = opts.cacheDir ?? DEFAULT_FONT_CACHE;
-  const manifestFile = path12.join(cacheDir, "manifest.json");
-  const prior = existsSync8(manifestFile) ? JSON.parse(readFileSync5(manifestFile, "utf8")) : [];
+  const manifestFile = path13.join(cacheDir, "manifest.json");
+  const prior = existsSync9(manifestFile) ? JSON.parse(readFileSync6(manifestFile, "utf8")) : [];
   const taken = /* @__PURE__ */ new Set();
   for (const face of faces) {
     const skip = (reason) => skipped.push({ subfamily: face.subfamily, weight: face.weight, reason });
@@ -4512,17 +4645,17 @@ var init_font_resolve = __esm({
 
 // packages/verify/src/font-faces.ts
 import { createHash as createHash3 } from "node:crypto";
-import { existsSync as existsSync9, readFileSync as readFileSync6 } from "node:fs";
-import path13 from "node:path";
+import { existsSync as existsSync10, readFileSync as readFileSync7 } from "node:fs";
+import path14 from "node:path";
 function injectedGroups(manifestPath2) {
-  if (!existsSync9(manifestPath2)) return { groups: [], shared: false };
-  const claimed = JSON.parse(readFileSync6(manifestPath2, "utf8"));
-  const resolveFile = (f) => path13.isAbsolute(f) && existsSync9(f) ? f : path13.resolve(path13.dirname(manifestPath2), path13.basename(f));
+  if (!existsSync10(manifestPath2)) return { groups: [], shared: false };
+  const claimed = JSON.parse(readFileSync7(manifestPath2, "utf8"));
+  const resolveFile = (f) => path14.isAbsolute(f) && existsSync10(f) ? f : path14.resolve(path14.dirname(manifestPath2), path14.basename(f));
   const byFile = /* @__PURE__ */ new Map();
   for (const f of claimed) {
     const file = resolveFile(f.file);
-    if (!existsSync9(file)) continue;
-    if (createHash3("sha256").update(readFileSync6(file)).digest("hex") !== f.sha256) continue;
+    if (!existsSync10(file)) continue;
+    if (createHash3("sha256").update(readFileSync7(file)).digest("hex") !== f.sha256) continue;
     const k = `${f.family}:${f.file}`;
     const e = byFile.get(k) ?? { family: f.family, weights: [], file };
     e.weights.push(f.weight);
@@ -4531,14 +4664,14 @@ function injectedGroups(manifestPath2) {
   const groups = [...byFile.values()];
   return { groups, shared: new Set(groups.map((e) => e.file)).size < groups.length };
 }
-function fontFaceCss(manifestPath2 = path13.join(fontCacheDir(), "manifest.json")) {
+function fontFaceCss(manifestPath2 = path14.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,${readFileSync6(e.file).toString("base64")}) format('woff2'); }`;
+    return `@font-face { font-family: '${e.family}'; font-weight: ${weight}; font-style: normal; src: url(data:font/woff2;base64,${readFileSync7(e.file).toString("base64")}) format('woff2'); }`;
   }).join("\n");
 }
-function injectedFamilyWeights(manifestPath2 = path13.join(fontCacheDir(), "manifest.json")) {
+function injectedFamilyWeights(manifestPath2 = path14.join(fontCacheDir(), "manifest.json")) {
   const { groups, shared } = injectedGroups(manifestPath2);
   const out = /* @__PURE__ */ new Map();
   for (const g of groups) {
@@ -4563,17 +4696,17 @@ var init_font_faces = __esm({
 });
 
 // packages/verify/src/admission.ts
-import { readFileSync as readFileSync7, readdirSync as readdirSync4, existsSync as existsSync10, writeFileSync as writeFileSync4 } from "node:fs";
-import path14 from "node:path";
+import { readFileSync as readFileSync8, readdirSync as readdirSync4, existsSync as existsSync11, writeFileSync as writeFileSync4 } from "node:fs";
+import path15 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 = path14.join(fontCacheDir(), "manifest.json");
+  const mPath = path15.join(fontCacheDir(), "manifest.json");
   const out = /* @__PURE__ */ new Map();
-  if (!existsSync10(mPath)) return out;
-  for (const f of JSON.parse(readFileSync7(mPath, "utf8")))
+  if (!existsSync11(mPath)) return out;
+  for (const f of JSON.parse(readFileSync8(mPath, "utf8")))
     out.set(f.family, [...out.get(f.family) ?? [], f.weight]);
   return out;
 }
@@ -4593,26 +4726,26 @@ var init_admission = __esm({
 });
 
 // packages/verify/src/candidate-css.ts
-import { existsSync as existsSync11, readFileSync as readFileSync8, readdirSync as readdirSync5, statSync as statSync2 } from "node:fs";
-import path15 from "node:path";
+import { existsSync as existsSync12, readFileSync as readFileSync9, readdirSync as readdirSync5, statSync as statSync2 } from "node:fs";
+import path16 from "node:path";
 function candidateCss(bundleDir) {
-  const files = ["tokens.css", "styles.css"].map((f) => path15.join(bundleDir, f));
-  const composedRoot = path15.join(bundleDir, "composed");
+  const files = ["tokens.css", "styles.css"].map((f) => path16.join(bundleDir, f));
+  const composedRoot = path16.join(bundleDir, "composed");
   let composedDirs = [];
   try {
     composedDirs = readdirSync5(composedRoot).sort();
   } catch {
   }
   for (const entry of composedDirs) {
-    const dir = path15.join(composedRoot, entry);
+    const dir = path16.join(composedRoot, entry);
     try {
       if (!statSync2(dir).isDirectory()) continue;
     } catch {
       continue;
     }
-    files.push(path15.join(dir, "tokens.css"), path15.join(dir, "styles.css"));
+    files.push(path16.join(dir, "tokens.css"), path16.join(dir, "styles.css"));
   }
-  return files.filter((f) => existsSync11(f)).map((f) => readFileSync8(f, "utf8")).join("\n");
+  return files.filter((f) => existsSync12(f)).map((f) => readFileSync9(f, "utf8")).join("\n");
 }
 var init_candidate_css = __esm({
   "packages/verify/src/candidate-css.ts"() {
@@ -4621,12 +4754,18 @@ var init_candidate_css = __esm({
 });
 
 // packages/verify/src/tasks.ts
-import path16 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;
+import path17 from "node:path";
+var CONTRACT_CHECK_IDS, 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({
   "packages/verify/src/tasks.ts"() {
     "use strict";
     init_paths();
+    CONTRACT_CHECK_IDS = /* @__PURE__ */ new Set([
+      "ref-reaches-control",
+      "rest-props-reach-control",
+      "default-value-reaches-control",
+      "error-pose-wires-aria"
+    ]);
     CALENDAR_CONFIGS = [
       { rep: "calendar-default", component: "Calendar", props: { style: "Default", selectedDay: 7, today: 28 } },
       { rep: "calendar-new-york", component: "Calendar", props: { style: "New York", selectedDay: 7, today: 28 } },
@@ -4781,7 +4920,7 @@ BEHAVIORAL CONTRACT (machine-verified, gating): the primary action and close con
     ];
     TASKS = {
       calendar: {
-        set: path16.join(REPO_ROOT, "examples/recordings/shadcn-poc-calendar"),
+        set: path17.join(REPO_ROOT, "examples/recordings/shadcn-poc-calendar"),
         entry: "Calendar.tsx",
         configs: CALENDAR_CONFIGS,
         systemApi: CALENDAR_API,
@@ -4789,7 +4928,7 @@ BEHAVIORAL CONTRACT (machine-verified, gating): the primary action and close con
         prelude: { controls: ['[data-tendril-part="day"]'], textInputs: [] }
       },
       "shadcn-button": {
-        set: path16.join(REPO_ROOT, "examples/recordings/shadcn-poc-button"),
+        set: path17.join(REPO_ROOT, "examples/recordings/shadcn-poc-button"),
         entry: "Button.tsx",
         configs: BUTTON_CONFIGS,
         systemApi: BUTTON_API,
@@ -4797,7 +4936,7 @@ BEHAVIORAL CONTRACT (machine-verified, gating): the primary action and close con
         prelude: { controls: ["> *"], textInputs: [] }
       },
       combobox: {
-        set: path16.join(REPO_ROOT, "examples/recordings/carbon-poc-combobox"),
+        set: path17.join(REPO_ROOT, "examples/recordings/carbon-poc-combobox"),
         entry: "ComboBox.tsx",
         configs: COMBO_CONFIGS,
         systemApi: COMBO_API,
@@ -4805,7 +4944,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: path16.join(REPO_ROOT, "examples/recordings/carbon-poc-modal"),
+        set: path17.join(REPO_ROOT, "examples/recordings/carbon-poc-modal"),
         entry: "Modal.tsx",
         configs: MODAL_CONFIGS,
         systemApi: MODAL_API,
@@ -4819,12 +4958,13 @@ BEHAVIORAL CONTRACT (machine-verified, gating): the primary action and close con
 // packages/verify/src/behavior.ts
 var behavior_exports = {};
 __export(behavior_exports, {
+  POSE_GAP_FLOOR: () => POSE_GAP_FLOOR,
   checkBehaviors: () => checkBehaviors,
   compileMount: () => compileMount,
   recordingIsDark: () => recordingIsDark
 });
-import { existsSync as existsSync12, readFileSync as readFileSync9 } 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 build3 } from "esbuild";
 import { chromium as chromium3 } from "playwright-core";
 import { PNG as PNG2 } from "pngjs";
@@ -4833,13 +4973,13 @@ function getFontFaces() {
   return _fontFaces;
 }
 async function compileMount(task, bundleDir) {
-  const entryTsx = path17.join(bundleDir, task.entry);
-  if (!existsSync12(entryTsx)) return { error: `${task.entry} missing` };
+  const entryTsx = path18.join(bundleDir, task.entry);
+  if (!existsSync13(entryTsx)) return { error: `${task.entry} missing` };
   const mountSrc = `
 import { createElement } from "react";
 import { createRoot } from "react-dom/client";
-import * as B from ${JSON.stringify(path17.resolve(entryTsx))};
-const cfg = (window as unknown as { __cfg: { component: string; props: Record<string, unknown>; spyProps?: string[] } }).__cfg;
+import * as B from ${JSON.stringify(path18.resolve(entryTsx))};
+const cfg = (window as unknown as { __cfg: { component: string; props: Record<string, unknown>; spyProps?: string[]; refProbe?: boolean } }).__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
 // mount builds the functions, recording firings for dismissNotifies.
@@ -4850,6 +4990,15 @@ for (const name of cfg.spyProps ?? []) {
     (w.__tendrilFired ??= {})[name] = true;
   };
 }
+// Ref probe (Cycle D contract): attached ONLY when the spec carries
+// assertRefReachesControl \u2014 attaching a ref to a plain function
+// component logs a React warning, and legacy bundles must stay clean
+// on the checks that do not ask.
+if (cfg.refProbe === true) {
+  const ref = { current: null as unknown };
+  (window as unknown as { __tendrilRef?: { current: unknown } }).__tendrilRef = ref;
+  (props as Record<string, unknown>)["ref"] = ref;
+}
 const root = document.getElementById("root");
 if (root && C) createRoot(root).render(createElement(C, props));
 `;
@@ -4894,7 +5043,7 @@ async function runSteps(page, spec, renderPose) {
           await page.waitForTimeout(delay);
           await freezeAnimations(page);
           if (!(await shotRoot(page)).equals(idle)) {
-            return { id: spec.id, pass: false, detail: "unmeasurable: the component's pixels change at rest (free-running animation or timer) \u2014 the committed state cannot be observed through it" };
+            return { id: spec.id, pass: false, detail: "unmeasurable: the component's pixels change at rest (free-running animation or a timer in YOUR candidate) \u2014 the committed state cannot be observed through it; this IS fixable from code: keep every scored pose reachable with all motion idle (freezable CSS animation, no JS-driven repaints)" };
           }
         }
         try {
@@ -4914,7 +5063,11 @@ async function runSteps(page, spec, renderPose) {
         const gap = 1 - fromIdle.similarity;
         const residual = 1 - toTarget.similarity;
         if (gap < POSE_GAP_FLOOR) {
-          return { id: spec.id, pass: false, detail: `unmeasurable: the "${pose}" pose renders indistinguishably from the resting pose (gap ${gap.toFixed(4)}), so committing cannot be observed` };
+          return {
+            id: spec.id,
+            pass: false,
+            detail: `unmeasurable: this bundle renders the "${pose}" pose indistinguishably from its resting pose (gap ${gap.toFixed(4)}) \u2014 if the recording's own references DO differ (authored tasks verify this before prescribing the check), the candidate is not painting the committed treatment: fix that pose's paint; if they do not, no code change can help \u2014 report it instead of iterating`
+          };
         }
         if (residual > (1 - COMMIT_GAP_CLOSED) * gap) {
           return {
@@ -4934,7 +5087,7 @@ async function runSteps(page, spec, renderPose) {
         await page.waitForTimeout(150);
       } else if ("assertVisible" in step) {
         const visible = await page.evaluate(
-          `(() => { const el = document.querySelector('#root ${step.assertVisible}'); if (!el) return false; const r = el.getBoundingClientRect(); return r.width > 0 && r.height > 0 && getComputedStyle(el).visibility !== 'hidden' && getComputedStyle(el).display !== 'none'; })()`
+          `(() => { const el = document.querySelector('#root ${step.assertVisible}'); if (!el) return false; const r = el.getBoundingClientRect(); const cs = getComputedStyle(el); return r.width > 0 && r.height > 0 && cs.visibility !== 'hidden' && cs.display !== 'none' && parseFloat(cs.opacity) > 0; })()`
         );
         if (visible !== true) return { id: spec.id, pass: false, detail: `expected visible: ${step.assertVisible}` };
       } else if ("assertHidden" in step) {
@@ -4948,17 +5101,68 @@ async function runSteps(page, spec, renderPose) {
         if (cursor !== want) return { id: spec.id, pass: false, detail: `cursor on ${sel}: got "${String(cursor)}", want "${want}"` };
       } else if ("assertFocusable" in step) {
         const ok = await page.evaluate(
-          `(() => { const el = document.querySelector('#root ${step.assertFocusable}'); if (!el) return 'MISSING'; el.focus(); return document.activeElement === el ? true : 'not focusable (tag ' + el.tagName + ')'; })()`
+          `(() => { const el = document.querySelector('#root ${step.assertFocusable}'); if (!el) return 'MISSING \u2014 no element matches: a real native control must exist here'; el.focus(); return document.activeElement === el ? true : 'not focusable (tag ' + el.tagName + ') \u2014 .focus() did not land: a display:none/visibility:hidden element cannot take focus, and a non-form element needs to be a native control (or the control must not be disabled)'; })()`
         );
         if (ok !== true) return { id: spec.id, pass: false, detail: `focus ${step.assertFocusable}: ${String(ok)}` };
+      } else if ("assertRefReachesControl" in step) {
+        const verdict = await page.evaluate(
+          `(() => {
+            const el = document.querySelector('#root ${step.assertRefReachesControl}');
+            if (!el) return 'no element matches ${step.assertRefReachesControl} \u2014 the contract requires a native control';
+            const probe = window.__tendrilRef;
+            if (!probe || probe.current == null) return 'ref.current is null \u2014 the entry export must be a forwardRef component whose ref reaches the native control (a plain function component ignores the ref)';
+            return probe.current === el ? true : 'ref.current is <' + String(probe.current.tagName).toLowerCase() + '> but the control is <' + el.tagName.toLowerCase() + '> \u2014 forward the ref to the control element itself, not a wrapper';
+          })()`
+        );
+        if (verdict !== true) return { id: spec.id, pass: false, detail: `ref ${step.assertRefReachesControl}: ${String(verdict)}` };
       } else if ("assertAnimated" in step) {
         const animated = await page.evaluate(ANIMATED_PROBE);
-        if (animated !== true) return { id: spec.id, pass: false, detail: "no running animation anywhere in the subtree" };
+        if (animated !== true) return { id: spec.id, pass: false, detail: "no running animation anywhere in the subtree \u2014 this pose must carry a LIVE animation (CSS animation, a Web Animation, or SVG <animate>); a static spinner image satisfies pixels but fails this check" };
       } else if ("type" in step) {
         const [sel, text] = step.type;
         await page.click(`#root ${sel}`, { timeout: 2e3 });
         await page.keyboard.type(text, { delay: 20 });
         await page.waitForTimeout(200);
+      } else if ("typeChangesPixels" in step) {
+        const [sel, text] = step.typeChangesPixels;
+        await settle(page);
+        const before = await shotRoot(page);
+        await page.click(`#root ${sel}`, { timeout: 2e3 });
+        await page.keyboard.type(text, { delay: 20 });
+        await page.waitForTimeout(200);
+        await freezeAnimations(page);
+        const after = await shotRoot(page);
+        if (before.equals(after)) {
+          return {
+            id: spec.id,
+            pass: false,
+            detail: `typing "${text}" into ${sel} changed nothing on screen \u2014 the typed value must be VISIBLY rendered (a hidden input that swallows typing while painted content stays fixed is a decoy, not a control)`
+          };
+        }
+      } else if ("assertSpyFired" in step) {
+        const fired = await page.evaluate(`(() => (window.__tendrilFired ?? {})[${JSON.stringify(step.assertSpyFired)}] === true)()`);
+        if (fired !== true) {
+          return {
+            id: spec.id,
+            pass: false,
+            detail: `the caller's ${step.assertSpyFired} never fired \u2014 forward the caller's handler to the control (a stripped or overridden handler breaks every controlled consumer silently)`
+          };
+        }
+      } else if ("assertDescribedByResolves" in step) {
+        const [sel, expected] = step.assertDescribedByResolves;
+        const verdict = await page.evaluate(
+          `(() => {
+            const el = document.querySelector('#root ${sel}');
+            if (!el) return 'element missing';
+            const ids = (el.getAttribute('aria-describedby') ?? '').trim().split(/\\s+/).filter(Boolean);
+            if (ids.length === 0) return 'aria-describedby is missing/empty';
+            const targets = ids.map((id) => document.getElementById(id));
+            if (targets.some((t) => t === null)) return 'aria-describedby references an id that does not exist \u2014 a dangling idref is present, not wired';
+            const text = targets.map((t) => (t && t.textContent) || '').join(' ');
+            return text.includes(${JSON.stringify(expected)}) ? true : 'the referenced element(s) do not contain the message the prop supplied';
+          })()`
+        );
+        if (verdict !== true) return { id: spec.id, pass: false, detail: `describedby on ${sel}: ${String(verdict)}` };
       } else if ("assertValue" in step) {
         const [sel, want] = step.assertValue;
         const value = await page.evaluate(`(() => { const el = document.querySelector('#root ${sel}'); return el ? el.value : 'MISSING'; })()`);
@@ -4972,7 +5176,7 @@ async function runSteps(page, spec, renderPose) {
         await page.keyboard.press("Tab");
         await page.waitForTimeout(200);
         const after = await page.screenshot();
-        if (Buffer.compare(before, after) === 0) return { id: spec.id, pass: false, detail: "Tab focus changes nothing (no focus ring)" };
+        if (Buffer.compare(before, after) === 0) return { id: spec.id, pass: false, detail: "Tab focus changes nothing on screen \u2014 no visible focus indicator exists: style the control's :focus-visible state (shared declaration with its forced token) so keyboard focus paints the recorded ring" };
       } else if ("clickOutside" in step) {
         await page.mouse.click(870, 660);
         await page.waitForTimeout(200);
@@ -4985,9 +5189,9 @@ async function runSteps(page, spec, renderPose) {
         if (val !== want) return { id: spec.id, pass: false, detail: `${attr} on ${sel}: got ${String(val)}, want "${want}"` };
       } else if ("assertNotFocusable" in step) {
         const focused = await page.evaluate(
-          `(() => { const el = document.querySelector('#root ${step.assertNotFocusable}'); if (!el) return 'MISSING'; el.focus(); return document.activeElement === el; })()`
+          `(() => { const els = [...document.querySelectorAll('#root ${step.assertNotFocusable}')]; if (els.length === 0) return 'MISSING'; for (const el of els) { el.focus(); if (document.activeElement === el) return true; } return false; })()`
         );
-        if (focused !== false) return { id: spec.id, pass: false, detail: focused === "MISSING" ? "element missing" : "disabled element took focus" };
+        if (focused !== false) return { id: spec.id, pass: false, detail: focused === "MISSING" ? "element missing" : "disabled element took focus \u2014 use the native disabled attribute: pointer-events:none and aria-disabled leave the element focusable (Tab and .focus() still land); only disabled refuses focus" };
       } else if ("reducedMotionNoAnimation" in step) {
         await page.emulateMedia({ reducedMotion: "reduce" });
         await page.waitForTimeout(250);
@@ -5013,7 +5217,11 @@ async function runSteps(page, spec, renderPose) {
           await page.waitForTimeout(500);
           after = await page.screenshot();
           if (Buffer.compare(baseline, after) !== 0)
-            return { id: spec.id, pass: false, detail: "pixels differ after mouse click + mouse-away (ring bound to :focus instead of :focus-visible?)" };
+            return {
+              id: spec.id,
+              pass: false,
+              detail: "pixels differ after mouse click + mouse-away \u2014 something persisted from a pointer click: usually a focus ring bound to bare :focus (bind rings to :focus-visible; a mouse click must not leave one). If clicking THIS pose legitimately commits a state change, the check is aimed at the wrong pose (it must target one where clicking commits nothing) \u2014 report that rather than restyling"
+            };
         }
       } else if ("assertNoReflow" in step) {
         const before = await page.evaluate("document.getElementById('probe').getBoundingClientRect().top");
@@ -5108,7 +5316,12 @@ async function runSteps(page, spec, renderPose) {
         await page.waitForTimeout(200);
         const after = await page.screenshot();
         await page.mouse.move(0, 0);
-        if (Buffer.compare(before, after) === 0) return { id: spec.id, pass: false, detail: `real :hover on ${step.hoverChangesPixels} changes nothing` };
+        if (Buffer.compare(before, after) === 0)
+          return {
+            id: spec.id,
+            pass: false,
+            detail: `real :hover on ${step.hoverChangesPixels} changes nothing \u2014 the hover treatment must ride the REAL pseudo-class in a shared declaration with the forced token (e.g. :is(:hover, [data-tendril-state~="hover"])); a rule on the attribute selector alone never fires for a real pointer`
+          };
       }
     } catch (err) {
       return { id: spec.id, pass: false, detail: `step failed: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}` };
@@ -5119,10 +5332,10 @@ async function runSteps(page, spec, renderPose) {
 function recordingIsDark(task) {
   const rep = task.configs[0]?.rep;
   if (rep === void 0) return false;
-  const f = path17.join(task.set, rep, "get_screenshot.json");
-  if (!existsSync12(f)) return false;
+  const f = path18.join(task.set, rep, "get_screenshot.json");
+  if (!existsSync13(f)) return false;
   try {
-    const env = JSON.parse(readFileSync9(f, "utf8")).content.find((c) => c.type === "image");
+    const env = JSON.parse(readFileSync10(f, "utf8")).content.find((c) => c.type === "image");
     if (env?.data === void 0) return false;
     const png = PNG2.sync.read(Buffer.from(env.data, "base64"));
     let sum = 0;
@@ -5172,6 +5385,10 @@ async function checkPrelude(page, task) {
     push(`touch-action(${sel})`, cs.touchAction === "manipulation", `"${cs.touchAction}" (want manipulation)`);
     push(`user-select(${sel})`, cs.userSelect === "none", `"${cs.userSelect}" (want none)`);
   }
+  for (const sel of task.prelude.touchTargets ?? []) {
+    const ta = await page.evaluate(`(() => { const el = document.querySelector('#root ${sel}'); return el ? getComputedStyle(el).touchAction : null; })()`);
+    push(`touch-action(${sel})`, ta === "manipulation", ta === null ? "element missing" : `"${ta}" (want manipulation)`);
+  }
   for (const sel of task.prelude.textInputs) {
     const us = await page.evaluate(`(() => { const el = document.querySelector('#root ${sel}'); return el ? (getComputedStyle(el).userSelect ?? getComputedStyle(el).webkitUserSelect) : null; })()`);
     push(`input-selectable(${sel})`, us !== null && us !== "none", us === null ? "element missing" : `input user-select "${us}" (must stay selectable)`);
@@ -5200,12 +5417,21 @@ async function checkBehaviors(task, bundleDir, opts = {}) {
   const results = [];
   let deadlined = false;
   try {
-    for (const spec of task.behaviors) {
+    for (const rawSpec of task.behaviors) {
+      const spec = JSON.parse(
+        JSON.stringify(rawSpec).replaceAll(JSON.stringify("__TENDRIL_MINT__"), JSON.stringify(`t-${Math.random().toString(36).slice(2, 10)}`))
+      );
       const cfg = task.configs.find((c) => c.rep === spec.config);
       if (cfg === void 0) {
         results.push({ id: spec.id, pass: false, detail: `unknown config ${spec.config}` });
         continue;
       }
+      const cfgJson = JSON.stringify({
+        component: cfg.component,
+        props: { ...cfg.props, ...spec.props },
+        ...spec.spyProps !== void 0 ? { spyProps: spec.spyProps } : {},
+        ...spec.steps.some((s) => "assertRefReachesControl" in s) ? { refProbe: true } : {}
+      });
       const html = `<!doctype html><html><head><meta charset="utf-8"><style>
 ${getFontFaces()}
 ${css}
@@ -5213,12 +5439,12 @@ ${TRANSITION_INSTANT_CSS}
 body{margin:0;padding:20px}
 #root{position:static}
 #probe{height:24px}
-</style></head><body><div id="root"></div><div id="probe">reflow probe</div><script>window.__cfg=${JSON.stringify({ component: cfg.component, props: { ...cfg.props, ...spec.props }, ...spec.spyProps !== void 0 ? { spyProps: spec.spyProps } : {} })}</script><script>${js}</script></body></html>`;
+</style></head><body><div id="root"></div><div id="probe">reflow probe</div><script>window.__cfg=${cfgJson}</script><script>${js}</script></body></html>`;
       const renderPose = async (rep) => {
         const target = task.configs.find((c) => c.rep === rep);
         if (target === void 0) return { error: `unknown pose ${rep}` };
         const poseHtml = html.replace(
-          `window.__cfg=${JSON.stringify({ component: cfg.component, props: { ...cfg.props, ...spec.props }, ...spec.spyProps !== void 0 ? { spyProps: spec.spyProps } : {} })}`,
+          `window.__cfg=${cfgJson}`,
           `window.__cfg=${JSON.stringify({ component: target.component, props: target.props })}`
         );
         const p = await browser.newPage({ viewport: { width: 900, height: 700 } });
@@ -5646,7 +5872,15 @@ function buildTrustStatement(input) {
   const unrecorded = input.latticeConfigs === null ? null : Math.max(0, input.latticeConfigs - input.scored);
   const interaction = input.interactionChecks === 0 ? "interaction behaviors NONE VERIFIED (0 checks)" : `interaction behaviors ${input.interactionPassed}/${input.interactionChecks}`;
   const prelude = input.preludeChecks === 0 ? "" : `, page hygiene ${input.preludePassed}/${input.preludeChecks}`;
-  return `Verified against recorded truth: ${input.pass}/${input.scored} recorded configs at or above the pass bar (${input.certified} certified), ${interaction}${prelude}.` + (unrecorded === null ? " Coverage denominator UNKNOWN (set predates lattice tracking): completeness is not established." : ` ${unrecorded} lattice configs are unrecorded and UNVERIFIED.`) + ` These numbers are claims: recompute them with \`tendril verify\` \u2014 certification authority lives in the CLI ruler, never in this file.`;
+  const content = (input.contentChecks ?? 0) === 0 ? "" : `, content slots ${input.contentPassed}/${input.contentChecks}`;
+  const parity = (input.parityChecks ?? 0) === 0 ? "" : `, state parity ${input.parityPassed}/${input.parityChecks}`;
+  return `Verified against recorded truth: ${input.pass}/${input.scored} recorded configs at or above the pass bar (${input.certified} certified), ${interaction}${content}${parity}${prelude}.` + // No hardcoded REASON for the unknown denominator: a fresh
+  // selection-scoped set is not "predating lattice tracking" (the
+  // run-21 defect, fixed on the verify channel then and found still
+  // live HERE by the 2026-08-16 sweep) — this artifact cannot see
+  // the manifest, so it states the fact and points at verify, which
+  // knows the reason.
+  (unrecorded === null ? " Coverage denominator UNKNOWN (the set's full variant lattice was not established at plan time \u2014 `tendril verify` states why): completeness is not established." : ` ${unrecorded} lattice configs are unrecorded and UNVERIFIED.`) + ` These numbers are claims: recompute them with \`tendril verify\` \u2014 certification authority lives in the CLI ruler, never in this file.`;
 }
 function cssProvenanceComment(input) {
   const unrecorded = input.latticeConfigs === null ? "; coverage denominator unknown" : `; ${Math.max(0, input.latticeConfigs - input.scored)} lattice configs unverified`;
@@ -5674,7 +5908,12 @@ var init_bundle = __esm({
       name: z9.string(),
       type: z9.string(),
       required: z9.boolean(),
-      default: z9.string().optional()
+      default: z9.string().optional(),
+      /** Cycle D role-named slots ("error": presence drives the error
+       * state; the public default is undefined). Declared so the field
+       * SURVIVES the schema round-trip — zod was silently stripping it
+       * from the public artifact (review). */
+      role: z9.string().optional()
     });
     PropAdapterSchema = z9.record(
       z9.string(),
@@ -5791,8 +6030,53 @@ var init_src4 = __esm({
 });
 
 // packages/verify/src/bundle-quality.ts
-import { readFileSync as readFileSync10, rmSync as rmSync2, writeFileSync as writeFileSync5, existsSync as existsSync13 } from "node:fs";
-import path18 from "node:path";
+import { readFileSync as readFileSync11, rmSync as rmSync2, writeFileSync as writeFileSync5, existsSync as existsSync14 } from "node:fs";
+import path19 from "node:path";
+function expertLensFindings(entryFile, source, contract) {
+  const findings = [];
+  const lineOf = (index) => source.slice(0, index).split("\n").length;
+  const spoof = /__tendril/i.exec(source);
+  if (spoof !== null) {
+    findings.push({
+      kind: "expert-lens",
+      file: entryFile,
+      line: lineOf(spoof.index),
+      message: "the bundle references a Tendril harness internal (__tendril*) \u2014 candidate code must never touch the measurement machinery; treat as a gaming attempt and inspect before trusting any verdict"
+    });
+  }
+  const idx = /\[\s*key\s*:\s*string\s*\]\s*:/.exec(source);
+  if (idx !== null) {
+    findings.push({
+      kind: "expert-lens",
+      file: entryFile,
+      line: lineOf(idx.index),
+      message: "index-signature escape hatch ([key: string]) in the public props \u2014 extend the native control's prop surface (ComponentPropsWithoutRef) instead; the typed extension IS the rest-prop surface"
+    });
+  }
+  if (contract.archetype !== "static") {
+    if (contract.forwardRef && !/\bforwardRef\b/.test(source) && !/\bref\b/.test(source)) {
+      findings.push({
+        kind: "expert-lens",
+        file: entryFile,
+        message: "no ref path to the control (no forwardRef and no ref identifier) \u2014 control archetypes must let a consumer reach the native control (the ref-reaches-control check measures this)"
+      });
+    }
+    for (const v of contract.derivedStateValues) {
+      if ((contract.publicUnionValues ?? []).includes(v)) continue;
+      const m = new RegExp(`\\w+\\?\\s*:[^;\\n]*"${v}"`).exec(source);
+      if (m !== null) {
+        findings.push({
+          kind: "expert-lens",
+          file: entryFile,
+          line: lineOf(m.index),
+          message: `a public prop's type carries the derived-state value "${v}" \u2014 the platform owns that state (focus/value/error semantics); derived states are never caller-set pose props`
+        });
+        break;
+      }
+    }
+  }
+  return findings;
+}
 function definedVars(tokensCss) {
   if (tokensCss === void 0) return void 0;
   const names = /* @__PURE__ */ new Set();
@@ -5801,19 +6085,19 @@ function definedVars(tokensCss) {
 }
 function recordedTokenMapState(setDir, reps) {
   const readMap = (file) => {
-    if (!existsSync13(file)) return void 0;
+    if (!existsSync14(file)) return void 0;
     try {
-      const parsed = JSON.parse(envelopeFirstTextPart(JSON.parse(readFileSync10(file, "utf8"))) || "{}");
+      const parsed = JSON.parse(envelopeFirstTextPart(JSON.parse(readFileSync11(file, "utf8"))) || "{}");
       return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
     } catch {
       return {};
     }
   };
-  const setLevel = readMap(path18.join(setDir, "get_variable_defs.json"));
+  const setLevel = readMap(path19.join(setDir, "get_variable_defs.json"));
   if (setLevel !== void 0) return Object.keys(setLevel).length === 0 ? "empty" : "populated";
   let recorded = false;
   for (const rep of reps) {
-    const m = readMap(path18.join(setDir, rep, "get_variable_defs.json"));
+    const m = readMap(path19.join(setDir, rep, "get_variable_defs.json"));
     if (m === void 0) continue;
     recorded = true;
     if (Object.keys(m).length > 0) return "populated";
@@ -5876,13 +6160,13 @@ function fontStackFindings(sheets, coverage) {
   }
   return findings;
 }
-async function checkBundleQuality(bundleDir, entry, set, fontManifest, motion) {
+async function checkBundleQuality(bundleDir, entry, set, fontManifest, motion, contract) {
   const findings = [];
-  const entryPath = path18.join(bundleDir, entry);
-  const cssPath = path18.join(bundleDir, "styles.css");
-  const tokensPath = path18.join(bundleDir, "tokens.css");
-  const css = existsSync13(cssPath) ? readFileSync10(cssPath, "utf8") : "";
-  const tokensCss = existsSync13(tokensPath) ? readFileSync10(tokensPath, "utf8") : void 0;
+  const entryPath = path19.join(bundleDir, entry);
+  const cssPath = path19.join(bundleDir, "styles.css");
+  const tokensPath = path19.join(bundleDir, "tokens.css");
+  const css = existsSync14(cssPath) ? readFileSync11(cssPath, "utf8") : "";
+  const tokensCss = existsSync14(tokensPath) ? readFileSync11(tokensPath, "utf8") : void 0;
   findings.push(
     ...fontStackFindings(
       [
@@ -5892,18 +6176,22 @@ async function checkBundleQuality(bundleDir, entry, set, fontManifest, motion) {
       injectedFamilyWeights(fontManifest)
     )
   );
-  if (existsSync13(entryPath)) {
+  if (existsSync14(entryPath)) {
     const workDir = newScratchDir("quality");
     try {
-      const tsxPath = path18.join(workDir, entry);
-      writeFileSync5(tsxPath, readFileSync10(entryPath, "utf8"));
+      const tsxPath = path19.join(workDir, entry);
+      writeFileSync5(tsxPath, readFileSync11(entryPath, "utf8"));
       for (const d of runTscStrict([tsxPath]).diagnostics) {
+        if (d.code === 2307 && /['"]\.\/composed\//.test(d.message)) continue;
         findings.push({ kind: "tsc", file: entry, ...d.line === void 0 ? {} : { line: d.line }, message: `TS${d.code}: ${d.message}` });
       }
     } finally {
       rmSync2(workDir, { recursive: true, force: true });
     }
   }
+  if (contract !== void 0 && existsSync14(entryPath)) {
+    findings.push(...expertLensFindings(entry, readFileSync11(entryPath, "utf8"), contract));
+  }
   if (css !== "") {
     const mapState = set === void 0 ? void 0 : recordedTokenMapState(set.dir, set.reps);
     for (const v of (await runTokenLint(css, "styles.css", definedVars(tokensCss), mapState !== void 0 && mapState !== "populated")).violations) {
@@ -6021,8 +6309,8 @@ var init_effect_geometry = __esm({
 });
 
 // packages/verify/src/bundle-score.ts
-import { existsSync as existsSync14, mkdirSync as mkdirSync3, readFileSync as readFileSync11, writeFileSync as writeFileSync6 } from "node:fs";
-import path19 from "node:path";
+import { existsSync as existsSync15, mkdirSync as mkdirSync3, readFileSync as readFileSync12, writeFileSync as writeFileSync6 } from "node:fs";
+import path20 from "node:path";
 import { build as build4 } from "esbuild";
 import { chromium as chromium4 } from "playwright-core";
 function getFontFaces2() {
@@ -6076,7 +6364,7 @@ function chooseSeat(cropAt, ref, padW, padH, backdrop, origin, extents) {
 }
 function metadataRoot(set, rep) {
   try {
-    const text = JSON.parse(readFileSync11(path19.join(set, rep, "get_metadata.json"), "utf8")).content.map((c) => c.text ?? "").join("\n");
+    const text = JSON.parse(readFileSync12(path20.join(set, rep, "get_metadata.json"), "utf8")).content.map((c) => c.text ?? "").join("\n");
     return parseMetadataStructure(text);
   } catch {
     return void 0;
@@ -6131,19 +6419,19 @@ function smallSemanticNodes(set, rep, maxArea = 1024) {
   });
 }
 function repMeta(set, rep) {
-  const text = JSON.parse(readFileSync11(path19.join(set, rep, "get_metadata.json"), "utf8")).content.map((c) => c.text ?? "").join("\n");
+  const text = JSON.parse(readFileSync12(path20.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(readFileSync11(path19.join(set, rep, "get_screenshot.json"), "utf8")).content.find((c) => c.type === "image");
+  const env = JSON.parse(readFileSync12(path20.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 = path19.join(set, rep, "get_design_context.json");
-  if (!existsSync14(file)) return void 0;
+  const file = path20.join(set, rep, "get_design_context.json");
+  if (!existsSync15(file)) return void 0;
   try {
-    const text = JSON.parse(readFileSync11(file, "utf8")).content.map((c) => c.text ?? "").join("\n");
+    const text = JSON.parse(readFileSync12(file, "utf8")).content.map((c) => c.text ?? "").join("\n");
     const extents = shadowExtents(text);
     return extents.top + extents.right + extents.bottom + extents.left > 0 ? extents : void 0;
   } catch {
@@ -6154,13 +6442,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 = path19.join(bundleDir, task.entry);
-  if (!existsSync14(entryTsx)) return CONFIGS2.map((c) => ({ rep: c.rep, similarity: 0, inkRecall: 0, exact: { similarity: 0, inkRecall: 0 }, pass: false, error: `${task.entry} missing` }));
+  const entryTsx = path20.join(bundleDir, task.entry);
+  if (!existsSync15(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 = candidateCss(bundleDir);
   const mountSrc = `
 import { createElement } from "react";
 import { createRoot } from "react-dom/client";
-import * as B from ${JSON.stringify(path19.resolve(entryTsx))};
+import * as B from ${JSON.stringify(path20.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");
@@ -6258,12 +6546,12 @@ body{margin:0;background:rgb(${backdrop.join(",")})}
             return name === void 0 ? c : { ...c, name };
           });
           if (opts.evidenceDir !== void 0) {
-            writeFileSync6(path19.join(opts.evidenceDir, `${cfg.rep}-render.png`), scored);
-            writeFileSync6(path19.join(opts.evidenceDir, `${cfg.rep}-ref.png`), ref);
-            writeFileSync6(path19.join(opts.evidenceDir, `${cfg.rep}-diff.png`), diffPng(scored, ref));
+            writeFileSync6(path20.join(opts.evidenceDir, `${cfg.rep}-render.png`), scored);
+            writeFileSync6(path20.join(opts.evidenceDir, `${cfg.rep}-ref.png`), ref);
+            writeFileSync6(path20.join(opts.evidenceDir, `${cfg.rep}-diff.png`), diffPng(scored, ref));
             for (const [i, c] of absent.slice(0, 3).entries()) {
-              writeFileSync6(path19.join(opts.evidenceDir, `${cfg.rep}-absent-${i}-ref.png`), zoomCrop(ref, c));
-              writeFileSync6(path19.join(opts.evidenceDir, `${cfg.rep}-absent-${i}-render.png`), zoomCrop(scored, c));
+              writeFileSync6(path20.join(opts.evidenceDir, `${cfg.rep}-absent-${i}-ref.png`), zoomCrop(ref, c));
+              writeFileSync6(path20.join(opts.evidenceDir, `${cfg.rep}-absent-${i}-render.png`), zoomCrop(scored, c));
             }
           }
           return {
@@ -6364,7 +6652,7 @@ var init_prelude = __esm({
     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 (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).
+- Interactive controls (buttons, options): touch-action: manipulation and user-select: none. Text inputs stay selectable (never user-select: none on them) \u2014 and never put user-select: none on an ancestor wrapping an editable control either: it inherits into the control; a text-entry component's root gets touch-action: manipulation only.
 - 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.
 - Every animation wrapped in @media (prefers-reduced-motion: no-preference) or disabled under reduce.`;
@@ -6509,8 +6797,8 @@ var init_parity = __esm({
 
 // packages/verify/src/composition.ts
 import { createRequire as createRequire2 } from "node:module";
-import { existsSync as existsSync15 } from "node:fs";
-import path20 from "node:path";
+import { existsSync as existsSync16 } from "node:fs";
+import path21 from "node:path";
 import { build as build6 } from "esbuild";
 import { chromium as chromium7 } from "playwright-core";
 function getFontFaces4() {
@@ -6518,9 +6806,9 @@ function getFontFaces4() {
   return _fontFaces4;
 }
 async function compileInstrumentedMount(task, bundleDir) {
-  const entryTsx = path20.join(bundleDir, task.entry);
-  if (!existsSync15(entryTsx)) return { error: `${task.entry} missing` };
-  const requireFromVerify = createRequire2(path20.join(VERIFY_PKG_DIR, "package.json"));
+  const entryTsx = path21.join(bundleDir, task.entry);
+  if (!existsSync16(entryTsx)) return { error: `${task.entry} missing` };
+  const requireFromVerify = createRequire2(path21.join(VERIFY_PKG_DIR, "package.json"));
   let realJsxPath;
   try {
     realJsxPath = requireFromVerify.resolve("react/jsx-runtime");
@@ -6531,7 +6819,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(path20.resolve(entryTsx))};
+import * as B from ${JSON.stringify(path21.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) {
@@ -6586,7 +6874,7 @@ function expectedParts(task, roles, mainSlug) {
 }
 function interiorRegions(setDir, roles) {
   const mains = roles.main;
-  const withInterior = mains.filter((m) => existsSync15(path20.join(setDir, m, "get_metadata_interior.json")));
+  const withInterior = mains.filter((m) => existsSync16(path21.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" };
   }
@@ -6802,17 +7090,17 @@ export const jsxs = (t, p, k) => real.jsxs(t, inject(t, p), k);
 });
 
 // packages/verify/src/occlusion.ts
-import { existsSync as existsSync16 } from "node:fs";
-import path21 from "node:path";
+import { existsSync as existsSync17 } from "node:fs";
+import path22 from "node:path";
 import { build as build7 } from "esbuild";
 import { chromium as chromium8 } from "playwright-core";
 async function compileTwoUp(task, bundleDir) {
-  const entryTsx = path21.join(bundleDir, task.entry);
-  if (!existsSync16(entryTsx)) return { error: `${task.entry} missing` };
+  const entryTsx = path22.join(bundleDir, task.entry);
+  if (!existsSync17(entryTsx)) return { error: `${task.entry} missing` };
   const src = `
 import { createElement } from "react";
 import { createRoot } from "react-dom/client";
-import * as B from ${JSON.stringify(path21.resolve(entryTsx))};
+import * as B from ${JSON.stringify(path22.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"]) {
@@ -6837,16 +7125,24 @@ for (const id of ["first", "second"]) {
     return { error: `does not compile: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}` };
   }
 }
-function overlayPlan(task) {
-  const openCfg = task.configs.find((c) => Object.entries(c.props).some(([k, v]) => v === true && /^(open|isopen|menuopen|expanded|isexpanded)$/i.test(k)));
-  if (openCfg !== void 0) return { cfg: openCfg, selector: OVERLAY_SELECTOR };
+function overlayPlan(task, authority) {
+  const isOpen = ([k, v]) => v === true && /^(open|isopen|menuopen|expanded|isexpanded)$/i.test(k) || // Authoring's own exclusive-axis shape (`state: "open"`) never
+  // matched the boolean-only rule — even authority-sourced configs
+  // unscheduled the gate (C2's second hole).
+  typeof v === "string" && /^(open|expanded)$/i.test(v);
+  const deciding = authority ?? task.configs;
+  const openDecider = deciding.find((c) => Object.entries(c.props).some(isOpen));
+  if (openDecider !== void 0) {
+    const mounted = task.configs.find((c) => c.rep === openDecider.rep) ?? task.configs.find((c) => Object.entries(c.props).some(isOpen)) ?? openDecider;
+    return { cfg: mounted, selector: OVERLAY_SELECTOR };
+  }
   const pop = task.prelude.popover;
   const first = task.configs[0];
   if (pop !== void 0 && first !== void 0) return { cfg: first, trigger: pop.trigger, selector: pop.selector };
   return void 0;
 }
 async function checkSiblingOcclusion(task, bundleDir, css, opts = {}) {
-  const plan = overlayPlan(task);
+  const plan = overlayPlan(task, opts.authority);
   if (plan === void 0) return [];
   const pop = { selector: plan.selector, trigger: plan.trigger };
   const cfg = plan.cfg;
@@ -6919,10 +7215,10 @@ body{margin:0;padding:16px;display:flex;flex-direction:column;gap:8px;align-item
           };
         })()`);
         if (verdict.kind === "no-menu") {
-          return [{ id: "sibling-overlay-hit-testable", pass: true, detail: `UNAVAILABLE: nothing matched "${pop.selector}" in the open config \u2014 occlusion was not measured` }];
+          return [{ id: "sibling-overlay-hit-testable", pass: true, unmeasured: true, detail: `UNAVAILABLE: nothing matched "${pop.selector}" in the open config \u2014 occlusion was not measured` }];
         }
         if (verdict.kind === "no-overlap") {
-          return [{ id: "sibling-overlay-hit-testable", pass: true, detail: "not applicable: the open overlay does not overlap the next instance" }];
+          return [{ id: "sibling-overlay-hit-testable", pass: true, unmeasured: true, detail: "not applicable: the open overlay does not overlap the next instance" }];
         }
         if (verdict.kind !== "menu") {
           return [
@@ -6996,23 +7292,23 @@ var init_src5 = __esm({
 });
 
 // packages/cli/src/environment.ts
-import { existsSync as existsSync17, readFileSync as readFileSync13 } from "node:fs";
-import path22 from "node:path";
+import { existsSync as existsSync18, readFileSync as readFileSync14 } from "node:fs";
+import path23 from "node:path";
 import { createHash as createHash4 } from "node:crypto";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 function cliVersion() {
   try {
-    return JSON.parse(readFileSync13(path22.join(path22.dirname(fileURLToPath5(import.meta.url)), "..", "package.json"), "utf8")).version ?? "dev";
+    return JSON.parse(readFileSync14(path23.join(path23.dirname(fileURLToPath5(import.meta.url)), "..", "package.json"), "utf8")).version ?? "dev";
   } catch {
     return "dev";
   }
 }
 function environmentStamp(taskFamilies) {
-  const manifestPath2 = path22.join(fontCacheDir(), "manifest.json");
+  const manifestPath2 = path23.join(fontCacheDir(), "manifest.json");
   let fontsHash = null;
-  if (existsSync17(manifestPath2)) {
+  if (existsSync18(manifestPath2)) {
     try {
-      const entries = JSON.parse(readFileSync13(manifestPath2, "utf8"));
+      const entries = JSON.parse(readFileSync14(manifestPath2, "utf8"));
       const scoped = taskFamilies === void 0 || taskFamilies === null ? entries : entries.filter((f) => taskFamilies.some((fam) => fam.toLowerCase() === f.family.toLowerCase()));
       const faces = scoped.map((f) => `${f.family}:${f.weight}:${f.sha256}`).sort();
       fontsHash = faces.length === 0 ? null : createHash4("sha256").update(faces.join("\n")).digest("hex").slice(0, 16);
@@ -7056,8 +7352,8 @@ var init_describe = __esm({
 });
 
 // packages/cli/src/env.ts
-import { existsSync as existsSync18, readFileSync as readFileSync14 } from "node:fs";
-import path23 from "node:path";
+import { existsSync as existsSync19, readFileSync as readFileSync15 } from "node:fs";
+import path24 from "node:path";
 function parseEnv(content) {
   const entries = /* @__PURE__ */ new Map();
   for (const line of content.split("\n")) {
@@ -7069,9 +7365,9 @@ function parseEnv(content) {
 function resolveCredential(name) {
   const fromProcess = process.env[name];
   if (fromProcess) return fromProcess;
-  const envPath = path23.resolve(process.env["INIT_CWD"] ?? process.cwd(), ".env");
-  if (!existsSync18(envPath)) return void 0;
-  return parseEnv(readFileSync14(envPath, "utf8")).get(name);
+  const envPath = path24.resolve(process.env["INIT_CWD"] ?? process.cwd(), ".env");
+  if (!existsSync19(envPath)) return void 0;
+  return parseEnv(readFileSync15(envPath, "utf8")).get(name);
 }
 var init_env = __esm({
   "packages/cli/src/env.ts"() {
@@ -7131,17 +7427,17 @@ var init_output = __esm({
 });
 
 // packages/cli/src/entitlement.ts
-import { chmodSync, existsSync as existsSync19, mkdirSync as mkdirSync4, readFileSync as readFileSync15, writeFileSync as writeFileSync7 } from "node:fs";
+import { chmodSync, existsSync as existsSync20, mkdirSync as mkdirSync4, readFileSync as readFileSync16, writeFileSync as writeFileSync7 } from "node:fs";
 import crypto from "node:crypto";
 import os4 from "node:os";
-import path24 from "node:path";
+import path25 from "node:path";
 function entitlementPath() {
-  return process.env["TENDRIL_ENTITLEMENT_PATH"] ?? path24.join(os4.homedir(), ".tendril", "entitlement.json");
+  return process.env["TENDRIL_ENTITLEMENT_PATH"] ?? path25.join(os4.homedir(), ".tendril", "entitlement.json");
 }
 function readStoredEntitlement(file = entitlementPath()) {
-  if (!existsSync19(file)) return void 0;
+  if (!existsSync20(file)) return void 0;
   try {
-    const parsed = JSON.parse(readFileSync15(file, "utf8"));
+    const parsed = JSON.parse(readFileSync16(file, "utf8"));
     if (typeof parsed.token !== "string" || typeof parsed.lastRefreshAt !== "number") return void 0;
     return { token: parsed.token, lastRefreshAt: parsed.lastRefreshAt };
   } catch {
@@ -7149,7 +7445,7 @@ function readStoredEntitlement(file = entitlementPath()) {
   }
 }
 function writeStoredEntitlement(stored, file = entitlementPath()) {
-  mkdirSync4(path24.dirname(file), { recursive: true });
+  mkdirSync4(path25.dirname(file), { recursive: true });
   writeFileSync7(file, `${JSON.stringify(stored, null, 2)}
 `);
   chmodSync(file, 384);
@@ -7234,9 +7530,9 @@ var init_entitlement = __esm({
 
 // packages/cli/src/commands/doctor.ts
 import { spawnSync } from "node:child_process";
-import { existsSync as existsSync20, readFileSync as readFileSync16, readdirSync as readdirSync6 } from "node:fs";
+import { existsSync as existsSync21, readFileSync as readFileSync17, readdirSync as readdirSync6 } from "node:fs";
 import os5 from "node:os";
-import path25 from "node:path";
+import path26 from "node:path";
 function withDeadline(work, ms) {
   return Promise.race([
     work,
@@ -7296,17 +7592,17 @@ async function runDoctorChecks(options) {
       remediation: "Install Google Chrome (or Chromium), or set CHROME_PATH to a Chromium-family browser binary."
     });
   }
-  const fontManifest = path25.join(fontCacheDir(), "manifest.json");
+  const fontManifest = path26.join(fontCacheDir(), "manifest.json");
   checks.push(
-    existsSync20(fontManifest) ? { name: "font-cache", ok: true, detail: `resolved font cache at ${fontCacheDir()} (${JSON.parse(readFileSync16(fontManifest, "utf8")).length} faces)` } : {
+    existsSync21(fontManifest) ? { name: "font-cache", ok: true, detail: `resolved font cache at ${fontCacheDir()} (${JSON.parse(readFileSync17(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: \`${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 = path25.join(os5.homedir(), ".claude", "plugins", "cache", "tendrilapp", "tendril");
-  if (existsSync20(pluginRoot)) {
+  const pluginRoot = path26.join(os5.homedir(), ".claude", "plugins", "cache", "tendrilapp", "tendril");
+  if (existsSync21(pluginRoot)) {
     try {
       const versions = readdirSync6(pluginRoot).filter((v) => /^\d+\.\d+\.\d+$/.test(v));
       const newest = versions.sort((a, b) => versionIsNewer(a, b) ? 1 : -1)[0];
@@ -8397,12 +8693,12 @@ __export(record_exports, {
   runRecordPlan: () => runRecordPlan,
   runRecordStatus: () => runRecordStatus
 });
-import { existsSync as existsSync22, mkdtempSync as mkdtempSync2, readFileSync as readFileSync18, readdirSync as readdirSync8 } from "node:fs";
+import { existsSync as existsSync23, mkdtempSync as mkdtempSync2, readFileSync as readFileSync19, readdirSync as readdirSync8 } from "node:fs";
 import os6 from "node:os";
-import path28 from "node:path";
+import path29 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));
+  const evident = (s) => stateTokens(s).some((t) => INTERACTION_TREATMENT_VALUES.has(t));
   return reports.some((r) => evident(r.axis) || r.domain.some(evident));
 }
 function interactionDisclosure(component, reports) {
@@ -8422,7 +8718,7 @@ function interactionDisclosure(component, reports) {
   };
 }
 function symbolsFromMetadataEnvelope(file, sourceFrame) {
-  const env = JSON.parse(readFileSync18(file, "utf8"));
+  const env = JSON.parse(readFileSync19(file, "utf8"));
   const text = env.content.map((c) => c.text ?? "").join("\n");
   const symbols = [];
   const walk2 = (node, ancestor) => {
@@ -8480,7 +8776,7 @@ function runRecordPlan(opts) {
   if (rawFile !== void 0) {
     try {
       const envelope = rawEnvelopeFromFile(rawFile, opts.metadataRawPartsFile !== void 0);
-      const tmp = path28.join(mkdtempSync2(path28.join(os6.tmpdir(), "tendril-plan-meta-")), "get_metadata.json");
+      const tmp = path29.join(mkdtempSync2(path29.join(os6.tmpdir(), "tendril-plan-meta-")), "get_metadata.json");
       writeFileSync9(tmp, JSON.stringify(envelope));
       metadataEntries.push({ file: tmp });
     } catch (err) {
@@ -8502,7 +8798,7 @@ function runRecordPlan(opts) {
   let metadataTruncated = false;
   for (const { file, frame } of metadataEntries) {
     try {
-      const parsed = symbolsFromMetadataEnvelope(path28.resolve(file), frame);
+      const parsed = symbolsFromMetadataEnvelope(path29.resolve(file), frame);
       symbols.push(...parsed.symbols);
       if (parsed.truncated) metadataTruncated = true;
     } catch (err) {
@@ -8536,7 +8832,7 @@ function runRecordPlan(opts) {
   if (symbols.length === 0) {
     const leads = metadataEntries.flatMap(({ file }) => {
       try {
-        const env = JSON.parse(readFileSync18(path28.resolve(file), "utf8"));
+        const env = JSON.parse(readFileSync19(path29.resolve(file), "utf8"));
         return instanceLeads(env.content.map((c) => c.text ?? "").join("\n"));
       } catch {
         return [];
@@ -8625,7 +8921,7 @@ function runRecordPlan(opts) {
         // 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 ${quoteArg(path28.join(opts.setDir, "recording-set.json"))}`, `${tendrilCommand(`record plan --set ${quoteArg(opts.setDir)} --component ${quoteArg(manifest.component)}`)} --sample`]
+        userRuns: [`rm ${quoteArg(path29.join(opts.setDir, "recording-set.json"))}`, `${tendrilCommand(`record plan --set ${quoteArg(opts.setDir)} --component ${quoteArg(manifest.component)}`)} --sample`]
       },
       {
         id: "larger-allowance",
@@ -8795,7 +9091,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: ${tendrilCommand(`record ingest --set ${path28.resolve(opts.setDir)} --rep ${payload["slug"]} --tool ${payload["tool"]} --file <envelope.json>`)}
+  \u2192 then: ${tendrilCommand(`record ingest --set ${path29.resolve(opts.setDir)} --rep ${payload["slug"]} --tool ${payload["tool"]} --file <envelope.json>`)}
 `);
   });
 }
@@ -8869,7 +9165,7 @@ async function autoFetchAssets(setDir, rep, envelopeText2) {
   const skipped = [];
   const failed = [];
   for (const { url, name } of assetUrlsFromEnvelopeText(envelopeText2)) {
-    if (existsSync22(path28.join(setDir, rep, name))) {
+    if (existsSync23(path29.join(setDir, rep, name))) {
       skipped.push(name);
       continue;
     }
@@ -8891,16 +9187,16 @@ async function autoFetchAssets(setDir, rep, envelopeText2) {
 }
 function rawEnvelopeFromFile(file, parts) {
   if (parts) {
-    const blocks = JSON.parse(readFileSync18(path28.resolve(file), "utf8"));
+    const blocks = JSON.parse(readFileSync19(path29.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: readFileSync18(path28.resolve(file), "utf8") }] };
+  return { content: [{ type: "text", text: readFileSync19(path29.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(readFileSync18(path28.resolve(opts.file), "utf8"));
+    payload = opts.rawParts === true || opts.raw === true ? rawEnvelopeFromFile(opts.file, opts.rawParts === true) : JSON.parse(readFileSync19(path29.resolve(opts.file), "utf8"));
   } catch (err) {
     fail(opts, ExitCode.InputValidation, {
       error: `cannot read envelope file: ${err instanceof Error ? err.message : String(err)}`,
@@ -8912,7 +9208,7 @@ async function runRecordIngest(opts) {
     fail(opts, ExitCode.InputValidation, {
       error: "--raw is for text tool responses; screenshots are binary",
       code: "envelope-invalid",
-      remediation: `Use \`${tendrilCommand(`record fetch --set ${path28.resolve(opts.setDir)} --rep ${opts.rep} --tool ${opts.tool} --url <image_url>`)}\` instead.`
+      remediation: `Use \`${tendrilCommand(`record fetch --set ${path29.resolve(opts.setDir)} --rep ${opts.rep} --tool ${opts.tool} --url <image_url>`)}\` instead.`
     });
   }
   if (opts.rep === "__set__" && opts.tool === "get_variable_defs") {
@@ -8932,7 +9228,7 @@ async function runRecordIngest(opts) {
         remediation: REINGEST_GUIDANCE
       });
     }
-    writeFileSync9(path28.join(opts.setDir, "get_variable_defs.json"), `${JSON.stringify(payload, null, 1)}
+    writeFileSync9(path29.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");
@@ -8956,7 +9252,7 @@ async function runRecordIngest(opts) {
         remediation: REINGEST_GUIDANCE
       });
     }
-    writeFileSync9(path28.join(opts.setDir, "get_motion_context.json"), `${JSON.stringify(payload, null, 1)}
+    writeFileSync9(path29.join(opts.setDir, "get_motion_context.json"), `${JSON.stringify(payload, null, 1)}
 `);
     emitData(opts, { ingested: "get_motion_context", rep: "__set__", setLevel: true, next: nextPayload(opts.setDir) }, () => {
       process.stdout.write("set-level get_motion_context ingested\n");
@@ -8972,7 +9268,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, then: ${tendrilCommand(`record asset --set ${path28.resolve(opts.setDir)} --rep ${opts.rep} --name ${f.name} --file <downloaded-file>`)}
+        for (const f of assets.failed) process.stdout.write(`  ASSET FAILED ${f.name}: ${f.reason} \u2014 download it, then: ${tendrilCommand(`record asset --set ${path29.resolve(opts.setDir)} --rep ${opts.rep} --name ${f.name} --file <downloaded-file>`)}
 `);
       }
     });
@@ -9045,14 +9341,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, then: ${tendrilCommand(`record asset --set ${path28.resolve(opts.setDir)} --rep ${opts.rep} --name ${f.name} --file <downloaded-file>`)}
+      for (const f of assets.failed) process.stdout.write(`  ASSET FAILED ${f.name}: ${f.reason} \u2014 download it, then: ${tendrilCommand(`record asset --set ${path29.resolve(opts.setDir)} --rep ${opts.rep} --name ${f.name} --file <downloaded-file>`)}
 `);
     }
   });
 }
 function runRecordAsset(opts) {
   if (opts.dir !== void 0) {
-    const dir = path28.resolve(opts.dir);
+    const dir = path29.resolve(opts.dir);
     const names = readdirSync8(dir).filter((f) => /^asset-[\w.-]+\.(svg|png|jpe?g|webp|gif)$/i.test(f));
     if (names.length === 0) {
       fail(opts, ExitCode.InputValidation, {
@@ -9064,7 +9360,7 @@ function runRecordAsset(opts) {
     const ingested = [];
     try {
       for (const name of names) {
-        ingestAsset(opts.setDir, opts.rep, name, readFileSync18(path28.join(dir, name)));
+        ingestAsset(opts.setDir, opts.rep, name, readFileSync19(path29.join(dir, name)));
         ingested.push(name);
       }
     } catch (err) {
@@ -9084,11 +9380,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: tendrilCommand(`record asset --set ${path28.resolve(opts.setDir)} --rep ${opts.rep} --dir <downloads-dir>`)
+      remediation: tendrilCommand(`record asset --set ${path29.resolve(opts.setDir)} --rep ${opts.rep} --dir <downloads-dir>`)
     });
   }
   try {
-    ingestAsset(opts.setDir, opts.rep, opts.name, readFileSync18(path28.resolve(opts.file)));
+    ingestAsset(opts.setDir, opts.rep, opts.name, readFileSync19(path29.resolve(opts.file)));
     emitData(opts, { rep: opts.rep, asset: opts.name }, () => {
       process.stdout.write(`ingested ${opts.rep}/${opts.name}
 `);
@@ -9143,7 +9439,7 @@ function narrowedRoles(derived, override) {
 function rolesFromFile(opts, file, derived) {
   let json;
   try {
-    json = JSON.parse(readFileSync18(path28.resolve(file), "utf8"));
+    json = JSON.parse(readFileSync19(path29.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)}`,
@@ -9181,11 +9477,11 @@ function rolesFromFile(opts, file, derived) {
   };
 }
 function runRecordFinish(opts) {
-  if (!existsSync22(path28.join(opts.setDir, "recording-set.json"))) {
+  if (!existsSync23(path29.join(opts.setDir, "recording-set.json"))) {
     fail(opts, ExitCode.InputValidation, {
       error: `no recording-set.json in ${opts.setDir}`,
       code: "no-recording-set",
-      remediation: `Run \`${tendrilCommand(`record plan --set ${path28.resolve(opts.setDir)} --component <name> --metadata <envelope.json>`)}\` first \u2014 \`record finish\` closes a set the planner opened.`
+      remediation: `Run \`${tendrilCommand(`record plan --set ${path29.resolve(opts.setDir)} --component <name> --metadata <envelope.json>`)}\` first \u2014 \`record finish\` closes a set the planner opened.`
     });
   }
   const { manifest, raw } = readManifestFile(opts.setDir);
@@ -9213,17 +9509,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 \`${tendrilCommand(`record finish --set ${path28.resolve(opts.setDir)} --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 ${path29.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) => existsSync22(path28.join(opts.setDir, rel)));
+  const { issues } = validateRecordingSet(merged, (rel) => existsSync23(path29.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 (\`${tendrilCommand(`record status --set ${path28.resolve(opts.setDir)}`)}\` lists missing envelopes) or the roles graph, then re-run \`record finish\`.`
+      remediation: `Fix the set (\`${tendrilCommand(`record status --set ${path29.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);
@@ -9270,6 +9566,74 @@ var init_record = __esm({
   }
 });
 
+// packages/generate/src/archetype.ts
+function deriveArchetype(signals) {
+  if (signals.textEntry.length > 0) {
+    return {
+      archetype: "text-input",
+      evidence: signals.textEntry,
+      // textarea included: the recording cannot distinguish single-
+      // from multi-line entry, and the stay-selectable/value/focus
+      // contracts are identical for both.
+      nativeControl: ":is(input, textarea)",
+      derivedStates: { ...TEXT_INPUT_DERIVED }
+    };
+  }
+  if (signals.selection) {
+    return {
+      archetype: "selectable-control",
+      evidence: ["selection axis (boolean selected/checked prop)"],
+      // The honest shapes for a selection control (Cycle C F11):
+      // native input (radio/checkbox pattern) or an aria-pressed
+      // button; select for listbox-shaped kits.
+      nativeControl: ":is(input, button, select)",
+      derivedStates: { ...CONTROL_DERIVED }
+    };
+  }
+  const STRONG_ACTION_VALUES = /* @__PURE__ */ new Set(["hover", "hovered", "focus", "focused", "focus-visible", "active", "pressed", "press"]);
+  const kebab5 = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+  const strongEvidence = signals.interactionEvidence.some((e) => {
+    const value = kebab5(e.split("=").slice(1).join("="));
+    return STRONG_ACTION_VALUES.has(value) || value.split("-").some((t) => STRONG_ACTION_VALUES.has(t));
+  });
+  if (signals.forcedStates.length > 0 || strongEvidence) {
+    return {
+      archetype: "action-control",
+      evidence: signals.forcedStates.length > 0 ? signals.forcedStates.map((t) => `forced state "${t}"`) : signals.interactionEvidence,
+      // a[href] included (review): the brief's own root-size text
+      // endorses an <a href> root for link shapes — demanding <button>
+      // would fail the principal-level implementation of a link kit.
+      nativeControl: ":is(button, a[href])",
+      derivedStates: { ...CONTROL_DERIVED }
+    };
+  }
+  return { archetype: "static", evidence: [], nativeControl: "", derivedStates: {} };
+}
+function derivedStateKind(canon, kebabValue) {
+  return canon.derivedStates[kebabValue];
+}
+var TEXT_INPUT_DERIVED, CONTROL_DERIVED;
+var init_archetype = __esm({
+  "packages/generate/src/archetype.ts"() {
+    "use strict";
+    TEXT_INPUT_DERIVED = {
+      focus: "focus",
+      focused: "focus",
+      "focus-visible": "focus",
+      filled: "value",
+      typing: "value",
+      placeholder: "value",
+      error: "error-presence",
+      invalid: "error-presence"
+    };
+    CONTROL_DERIVED = {
+      focus: "focus",
+      focused: "focus",
+      "focus-visible": "focus"
+    };
+  }
+});
+
 // packages/generate/src/engine.ts
 var init_engine = __esm({
   "packages/generate/src/engine.ts"() {
@@ -9457,8 +9821,8 @@ var init_engine_curated = __esm({
 });
 
 // packages/generate/src/loop.ts
-import { existsSync as existsSync23, mkdirSync as mkdirSync6, readFileSync as readFileSync19, renameSync, writeFileSync as writeFileSync10 } from "node:fs";
-import path29 from "node:path";
+import { existsSync as existsSync24, mkdirSync as mkdirSync6, readFileSync as readFileSync20, renameSync, writeFileSync as writeFileSync10 } from "node:fs";
+import path30 from "node:path";
 import { z as z12 } from "zod";
 function objective(scores, behaviors) {
   const vals = scores.map((s) => Math.min(s.similarity, s.inkRecall));
@@ -9470,7 +9834,9 @@ function objective(scores, behaviors) {
 }
 function buildFeedback(scores, behaviors, bar, mode = "fenced") {
   const preludeLines = behaviors.filter((b) => !b.pass && b.id.startsWith("prelude:")).map((b) => `PRELUDE FAIL ${b.id}: ${b.detail ?? "failed"}`);
-  const behLines = behaviors.filter((b) => !b.pass && !b.id.startsWith("prelude:")).map((b) => `BEHAVIOR FAIL ${b.id}: ${b.detail ?? "failed"}`);
+  const unmeasurable = behaviors.filter((b) => !b.pass && !b.id.startsWith("prelude:") && (b.detail?.startsWith("unmeasurable:") ?? false));
+  const unmeasurableLines = unmeasurable.map((b) => `UNMEASURABLE ${b.id}: ${b.detail ?? "failed"}`);
+  const behLines = behaviors.filter((b) => !b.pass && !b.id.startsWith("prelude:") && !unmeasurable.includes(b)).map((b) => `BEHAVIOR FAIL ${b.id}: ${b.detail ?? "failed"}`);
   const lines = scores.map((s) => {
     const base = `${s.pass ? "PASS" : "FAIL"} ${s.rep}: sim=${s.similarity} ink=${s.inkRecall}`;
     const err = s.error !== void 0 ? ` error=${s.error}` : "";
@@ -9484,7 +9850,10 @@ function buildFeedback(scores, behaviors, bar, mode = "fenced") {
 ${lines.join("\n")}${behLines.length > 0 ? `
 
 BEHAVIORAL invariants (machine-verified, GATING \u2014 fix these with real handlers/animation/cursor, do not fake pixels):
-${behLines.join("\n")}` : ""}${preludeLines.length > 0 ? `
+${behLines.join("\n")}` : ""}${unmeasurableLines.length > 0 ? `
+
+UNMEASURABLE checks (still failing, but read the cause BEFORE spending a round: each line says whether the blocker is your render \u2014 fixable, fix the named pose's paint \u2014 or the recording/at-rest motion, which NO component code can fix; in that case REPORT it and do not iterate on it):
+${unmeasurableLines.join("\n")}` : ""}${preludeLines.length > 0 ? `
 
 PRELUDE parity (computed-style checks, GATING \u2014 fix the named CSS property on the named element):
 ${preludeLines.join("\n")}` : ""}${absentLines.length > 0 ? `
@@ -9495,9 +9864,9 @@ ${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 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 (!existsSync23(path29.join(outDir, "run-log.json")) && !existsSync23(path29.join(outDir, "loop-state.json"))) return void 0;
+  if (!existsSync24(path30.join(outDir, "run-log.json")) && !existsSync24(path30.join(outDir, "loop-state.json"))) return void 0;
   let n = 1;
-  while (existsSync23(`${outDir}-prev-${n}`)) n += 1;
+  while (existsSync24(`${outDir}-prev-${n}`)) n += 1;
   renameSync(outDir, `${outDir}-prev-${n}`);
   return `${outDir}-prev-${n}`;
 }
@@ -9506,14 +9875,14 @@ async function runEngineLoop(opts) {
   const plateau = opts.plateau ?? 2;
   const progress = opts.onProgress ?? (() => {
   });
-  const statePath = path29.join(opts.outDir, "loop-state.json");
-  const resuming = opts.resume === true && existsSync23(statePath);
+  const statePath = path30.join(opts.outDir, "loop-state.json");
+  const resuming = opts.resume === true && existsSync24(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 = path29.join(opts.outDir, ".candidate");
+  const scratch = path30.join(opts.outDir, ".candidate");
   let attempts = [];
   let log = [];
   let best;
@@ -9521,7 +9890,7 @@ async function runEngineLoop(opts) {
   let nonAccepted = 0;
   let stopReason = "max-iterations";
   if (resuming) {
-    const restored = LoopStateSchema.parse(JSON.parse(readFileSync19(statePath, "utf8")));
+    const restored = LoopStateSchema.parse(JSON.parse(readFileSync20(statePath, "utf8")));
     attempts = restored.attempts;
     log = restored.iterations;
     spentUsd = restored.spentUsd;
@@ -9541,7 +9910,7 @@ async function runEngineLoop(opts) {
   };
   const writeCandidate = (files) => {
     mkdirSync6(scratch, { recursive: true });
-    for (const [name, content] of Object.entries(files)) writeFileSync10(path29.join(scratch, name), content);
+    for (const [name, content] of Object.entries(files)) writeFileSync10(path30.join(scratch, name), content);
   };
   const scoreCandidate = async (candidate, iter, usd, modelMs) => {
     writeCandidate(candidate.files);
@@ -9599,8 +9968,8 @@ async function runEngineLoop(opts) {
       const usd = candidate.usage?.usd ?? 0;
       spentUsd += usd;
       if (candidate.raw !== void 0) {
-        mkdirSync6(path29.join(opts.outDir, "responses"), { recursive: true });
-        writeFileSync10(path29.join(opts.outDir, "responses", `iter-${iter}.md`), candidate.raw);
+        mkdirSync6(path30.join(opts.outDir, "responses"), { recursive: true });
+        writeFileSync10(path30.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 ?? "?";
@@ -9626,10 +9995,10 @@ async function runEngineLoop(opts) {
       }
     }
   }
-  if (best !== void 0) for (const [name, content] of Object.entries(best.files)) writeFileSync10(path29.join(opts.outDir, name), content);
+  if (best !== void 0) for (const [name, content] of Object.entries(best.files)) writeFileSync10(path30.join(opts.outDir, name), content);
   const final = best !== void 0 ? await opts.score(opts.outDir) : { scores: [], behaviors: [] };
   writeFileSync10(
-    path29.join(opts.outDir, "run-log.json"),
+    path30.join(opts.outDir, "run-log.json"),
     `${JSON.stringify(
       {
         ...opts.meta,
@@ -9696,8 +10065,9 @@ var init_loop2 = __esm({
 });
 
 // packages/generate/src/brief.ts
-import { existsSync as existsSync24, readFileSync as readFileSync20 } from "node:fs";
-import path30 from "node:path";
+import { existsSync as existsSync25, readFileSync as readFileSync21 } from "node:fs";
+import path31 from "node:path";
+import { PNG as PNG3 } from "pngjs";
 function singleAxes2(name) {
   const parsed = parseVariantAxes(name);
   if (parsed === void 0) return void 0;
@@ -9737,13 +10107,50 @@ function authorComponentApi(opts) {
     if (/^(is)?(selected|checked)$/i.test(camel(key))) interactionEvidence.push(`${key} (selection axis)`);
     for (const v of domains.get(key)) {
       const k = kebab3(v);
-      if (INTERACTION_EVIDENCE_VALUES.has(k) || k.split("-").some((t) => INTERACTION_EVIDENCE_VALUES.has(t))) {
+      const engaged = ENGAGED_STATE_VALUES.has(k) && kebab3(key) === "state";
+      const classic = (t) => INTERACTION_EVIDENCE_VALUES.has(t) && !ENGAGED_STATE_VALUES.has(t);
+      if (engaged || classic(k) || k.split("-").some(classic)) {
         interactionEvidence.push(`${key}=${v}`);
       }
     }
   }
+  const TEXT_ENTRY_STATE_VALUES = /* @__PURE__ */ new Set(["typing", "filled", "placeholder"]);
+  const TEXT_ENTRY_AXIS_NAMES = /* @__PURE__ */ new Set(["typing", "text-entered"]);
+  const textEntry = [];
+  for (const key of axisKeys) {
+    const domain = domains.get(key);
+    if (TEXT_ENTRY_AXIS_NAMES.has(kebab3(key)) && domain.every((v) => ["true", "false"].includes(kebab3(v)))) {
+      textEntry.push(`${key} (boolean axis)`);
+    }
+    if (kebab3(key) !== "state") continue;
+    if ((opts.textSlots ?? []).length === 0) continue;
+    for (const v of domain) if (TEXT_ENTRY_STATE_VALUES.has(kebab3(v))) textEntry.push(`${key}=${v}`);
+  }
+  const preForcedStates = axisKeys.filter(isStateAxis).flatMap((key) => domains.get(key).map(kebab3).filter((k) => INTERACTION_STATES.has(k)));
+  const archetype = deriveArchetype({
+    textEntry,
+    selection: interactionEvidence.some((e) => e.endsWith(" (selection axis)")),
+    forcedStates: preForcedStates,
+    interactionEvidence
+  });
+  const stateAxis = axisKeys.find(isStateAxis);
+  const errorReps = new Set(
+    stateAxis === void 0 ? [] : axed.filter((p) => derivedStateKind(archetype, kebab3(p.axes[stateAxis])) === "error-presence").map((p) => p.slug)
+  );
+  const errorSourceSlot = (opts.textSlots ?? []).find((s) => s.visibleIn.length > 0 && s.visibleIn.every((r) => errorReps.has(r)));
+  const errorViaProp = errorSourceSlot !== void 0;
+  const valueReps = new Set(
+    stateAxis === void 0 ? [] : axed.filter((p) => {
+      const k = kebab3(p.axes[stateAxis]);
+      return derivedStateKind(archetype, k) === "value" && k !== "placeholder";
+    }).map((p) => p.slug)
+  );
+  const valueSourceSlot = (opts.textSlots ?? []).find((s) => s !== errorSourceSlot && s.visibleIn.length > 0 && s.visibleIn.every((r) => valueReps.has(r)));
+  const valueViaProp = valueSourceSlot !== void 0;
+  const derivedPoseProps = {};
   const props = [];
   const forcedStates = [];
+  const derivedStates = [];
   const syntheticCombos = [];
   const propNameFor = (axis) => axisPropName(opts.component, axis);
   for (const key of axisKeys) {
@@ -9760,6 +10167,13 @@ function authorComponentApi(opts) {
         } else if (BOOLEAN_STATES.has(k)) {
           props.push({ name: k, kind: "boolean" });
           splitBooleans.push(k);
+        } else if (derivedStateKind(archetype, k) !== void 0) {
+          const kind = derivedStateKind(archetype, k);
+          if (kind === "error-presence" && errorViaProp || kind === "value" && valueViaProp && k !== "placeholder") {
+          } else {
+            if (!forcedStates.includes(k)) forcedStates.push(k);
+            if (!derivedStates.includes(k)) derivedStates.push(k);
+          }
         } else {
           unionValues.push(kebab3(v));
         }
@@ -9777,14 +10191,19 @@ function authorComponentApi(opts) {
       props.push({ name: propNameFor(key), kind: "union", values: ordered.map(kebab3), default: kebab3(def) });
     }
   }
-  const slots = (opts.textSlots ?? []).map((slot) => {
-    let name = slot.prop;
-    if (name !== "children" && (props.some((pr) => pr.name === name) || RESERVED_PROPS.has(name.toLowerCase()))) name = `${name}Text`;
+  const slotRoles = /* @__PURE__ */ new Map();
+  const slots = (opts.textSlots ?? []).filter((slot) => slot !== valueSourceSlot).map((slot) => {
+    let name = slot === errorSourceSlot ? "error" : slot.prop;
+    if (name !== "children" && (props.some((pr) => pr.name === name) || RESERVED_PROPS.has(name.toLowerCase()) || NATIVE_ATTR_COLLISIONS.has(name.toLowerCase()))) name = `${name}Text`;
     let n = 2;
     while (props.some((pr) => pr.name === name)) name = `${slot.prop}Text${n++}`;
+    if (slot === errorSourceSlot) slotRoles.set(name, "error");
     return { ...slot, prop: name };
   });
-  for (const slot of slots) props.push({ name: slot.prop, kind: "string", default: slot.default });
+  for (const slot of slots) {
+    const role = slotRoles.get(slot.prop);
+    props.push({ name: slot.prop, kind: "string", default: slot.default, ...role !== void 0 ? { role } : {} });
+  }
   const configs = [];
   const seenAssignments = /* @__PURE__ */ new Map();
   const componentIdent = pascal(opts.component);
@@ -9796,9 +10215,18 @@ function authorComponentApi(opts) {
       if (v === defaults.get(key)) continue;
       const k = kebab3(v);
       if (isStateAxis(key)) {
-        if (INTERACTION_STATES.has(k)) tokens.push(k);
+        const derived = derivedStateKind(archetype, k);
+        const viaProp = derived === "error-presence" && errorViaProp || derived === "value" && valueViaProp && k !== "placeholder";
+        if (INTERACTION_STATES.has(k) || derived !== void 0 && !viaProp) tokens.push(k);
         else if (BOOLEAN_STATES.has(k)) assignment[k] = true;
-        else assignment[propNameFor(key)] = k;
+        else if (derived === "value" && viaProp) {
+          const text = valueSourceSlot.overrides[p.slug] ?? valueSourceSlot.default;
+          assignment["defaultValue"] = text;
+          derivedPoseProps[k] ??= { defaultValue: text };
+        } else if (derived === "error-presence" && viaProp) {
+          const name = [...slotRoles.entries()].find(([, r]) => r === "error")?.[0];
+          if (name !== void 0) derivedPoseProps[k] ??= { [name]: errorSourceSlot.overrides[p.slug] ?? errorSourceSlot.default };
+        } else if (derived === void 0) assignment[propNameFor(key)] = k;
       } else if (["true", "false"].includes(k)) {
         assignment[propNameFor(key)] = k === "true";
       } else {
@@ -9809,6 +10237,7 @@ function authorComponentApi(opts) {
     for (const slot of slots) {
       const v = slot.overrides[p.slug];
       if (v !== void 0) assignment[slot.prop] = v;
+      else if (slotRoles.get(slot.prop) === "error" && errorReps.has(p.slug)) assignment[slot.prop] = slot.default;
     }
     const canonical = JSON.stringify(Object.fromEntries(Object.entries(assignment).sort(([a], [b]) => a.localeCompare(b))));
     const clash = seenAssignments.get(canonical);
@@ -9827,6 +10256,8 @@ function authorComponentApi(opts) {
     props.push({ name: "onDismiss", kind: "callback", default: opts.dismissible });
   }
   const entry = `${componentIdent}.tsx`;
+  const extendsNative = archetype.archetype === "text-input" ? "input" : archetype.archetype === "selectable-control" ? "input" : archetype.archetype === "action-control" ? "button" : "div";
+  const isControl = archetype.archetype !== "static";
   const apiPin = {
     name: componentIdent,
     props: props.map((pr) => ({
@@ -9834,14 +10265,19 @@ function authorComponentApi(opts) {
       type: pr.kind === "boolean" ? "boolean" : pr.kind === "string" ? "string" : pr.kind === "callback" ? "() => void" : pr.values.map((v) => `"${v}"`).join(" | "),
       required: false,
       // A callback's `default` field carries detection EVIDENCE for the
-      // prop line, not a value — it never enters the pin.
-      ...pr.default !== void 0 && pr.kind !== "callback" ? { default: pr.default } : {}
+      // prop line, not a value — it never enters the pin. An
+      // error-role prop's public default is UNDEFINED (presence
+      // semantics) — the recorded message is prose, never a default.
+      ...pr.default !== void 0 && pr.kind !== "callback" && pr.role !== "error" ? { default: pr.default } : {},
+      ...pr.role !== void 0 ? { role: pr.role } : {}
     })),
     forcedStates,
-    poseCompleteness: { recordedPoses: opts.poses.length, expressible: configs.length }
+    poseCompleteness: { recordedPoses: opts.poses.length, expressible: configs.length },
+    archetype: archetype.archetype,
+    contract: { extendsNative, forwardRef: isControl, restPropsTo: isControl ? "control" : "root" }
   };
   const propLines = props.map(
-    (pr) => pr.kind === "boolean" ? `  ${pr.name}?: boolean;` : pr.kind === "string" ? `  ${pr.name}?: string; // CONTENT \u2014 recorded default ${JSON.stringify(pr.default)}` : pr.kind === "callback" ? `  ${pr.name}?: () => void; // NOTIFICATION \u2014 recorded evidence: ${pr.default ?? "the recorded affordance"}; the component owns its state (it hides/updates itself) and the callback informs, never controls` : `  ${pr.name}?: ${pr.values.map((v) => `"${v}"`).join(" | ")}; // default "${pr.default}"`
+    (pr) => pr.kind === "boolean" ? `  ${pr.name}?: boolean;` : pr.role === "error" ? `  ${pr.name}?: string; // ERROR-AS-PRESENCE \u2014 default undefined (no error); when SET the component enters its error state: render the message, set aria-invalid on the control and aria-describedby pointing at the message element (machine-checked). Recorded message: ${JSON.stringify(pr.default)}` : pr.kind === "string" ? `  ${pr.name}?: string; // CONTENT \u2014 recorded default ${JSON.stringify(pr.default)}` : pr.kind === "callback" ? `  ${pr.name}?: () => void; // NOTIFICATION \u2014 recorded evidence: ${pr.default ?? "the recorded affordance"}; the component owns its state (it hides/updates itself) and the callback informs, never controls` : `  ${pr.name}?: ${pr.values.map((v) => `"${v}"`).join(" | ")}; // default "${pr.default}"`
   );
   const provided = opts.fonts ?? [];
   const recorded = opts.recordedFonts ?? [];
@@ -9853,23 +10289,43 @@ function authorComponentApi(opts) {
   }).filter((f) => f.missing.length > 0);
   const weightsLine = (opts.providedFaces ?? []).length > 0 ? `Weights the harness can actually serve: ${(opts.providedFaces ?? []).map((f) => `'${f.family}' (${[...f.weights].sort((a, b) => a - b).join(", ")})`).join("; ")}. ` + (faceGaps.length > 0 ? `WEIGHT GAP \u2014 ${faceGaps.map((g) => `'${g.family}' is recorded at ${g.missing.join(", ")} which the cache does NOT hold`).join("; ")}. CSS binds the FAMILY before the weight and font-synthesis: none blocks the fall-through, so text at a missing weight renders in a weight this family DOES have, silently and at full score-cost. Do not lead a font stack with a family that cannot serve the weight you are setting; put a family that has it first, or report the gap rather than chasing the difference as geometry. ` : "") : "";
   const fontsLine = weightsLine + (provided.length > 0 ? `Fonts provided by the harness: ${provided.map((f) => `'${f}'`).join(", ")}. ` : "") + (recorded.length > 0 ? `The recording's declared famil${recorded.length === 1 ? "y is" : "ies are"} ${recorded.map((f) => `'${f}'`).join(", ")}${unprovided.length > 0 ? ` \u2014 ${unprovided.map((f) => `'${f}'`).join(", ")} ${unprovided.length === 1 ? "is" : "are"} NOT provided: the mount will substitute a provided face, scoring reflects the recorded one, and the residual glyph delta is not closable from CSS \u2014 do not chase it` : ""}. ` : "");
-  const forcingCanon = forcedStates.length > 0 ? `Interactive states are REAL (:hover, :focus-visible) AND statically forceable via the data-tendril-state attribute (a DOCUMENTED token-list attribute; tokens: ${forcedStates.map((t) => `"${t}"`).join(" | ")}) spread onto the root; forced and real selectors must share ONE declaration block, e.g. :is(:hover, [data-tendril-state~="hover"]) \u2014 match with ~= so compound states ("hover selected") work. ` : "";
-  const systemApi = `Prescribed API (the harness mounts exactly this; deviation scores 0):
-export function ${componentIdent}(props: {
+  const forcingCanon = forcedStates.length > 0 ? `Interactive states are REAL (:hover, :focus-visible) AND statically forceable via the data-tendril-state attribute (a DOCUMENTED token-list attribute; tokens: ${forcedStates.map((t) => `"${t}"`).join(" | ")}) ${isControl ? "which arrives through the rest props and therefore lands on the NATIVE CONTROL \u2014 pair each forced token with its real condition on the control, and use :has() on ancestors where the recorded treatment paints outside it (the pinned Chromium supports :has())" : "spread onto the root"}; forced and real selectors must share ONE declaration block, e.g. :is(:hover, [data-tendril-state~="hover"]) \u2014 match with ~= so compound states ("hover selected") work. ` + // F12 (run-22 cycle): a kit that records "Focus" forces via a
+  // "focus" token, but the prelude binds indicators to
+  // :focus-visible, never bare :focus — left unsaid, the shared-
+  // declaration example above points the generator straight at
+  // the selector the prelude forbids.
+  (forcedStates.includes("focus") ? `The recorded "focus" pose is KEYBOARD-focus treatment: pair its forced token with :focus-visible \u2014 :is(:focus-visible, [data-tendril-state~="focus"]) \u2014 never bare :focus (the prelude binds focus indicators to :focus-visible). ` : "") + // Cycle D (Output doctrine): derived states ride the SAME hook
+  // but their real-use condition is platform state, not a prop —
+  // the brief must name each pairing or the generator reinvents
+  // the pose switchboard to satisfy the configs.
+  (derivedStates.length > 0 ? `DERIVED STATES \u2014 ${derivedStates.map((t) => `"${t}"`).join(", ")} are states the PLATFORM owns; they are NEVER public props (no state/pose props in your API). In real use: focused comes from real focus (:focus-visible on the control or :focus-within on the root); filled/typing come from the control's VALUE (:not(:placeholder-shown), or state your component derives from its own value); placeholder is the empty-value look; error comes from your error/invalid semantics (aria-invalid). The forced token is the harness's STATIC channel for those poses \u2014 share each declaration between the real condition and its token, exactly like the interaction states above. ` : "") : "";
+  const refElement = archetype.archetype === "text-input" ? "HTMLInputElement" : archetype.archetype === "selectable-control" ? "HTMLInputElement" : "HTMLButtonElement";
+  const refElementNote = archetype.archetype === "text-input" ? " /* HTMLTextAreaElement if you build with a textarea */" : archetype.archetype === "selectable-control" ? " /* or HTMLButtonElement/HTMLSelectElement \u2014 match the control you pick */" : " /* HTMLAnchorElement for link shapes */";
+  const signatureBlock = isControl ? `export const ${componentIdent} = forwardRef<${refElement}${refElementNote}, ${componentIdent}Props>(function ${componentIdent}(props, ref) { /* your implementation */ })
+interface ${componentIdent}Props extends ComponentPropsWithoutRef<"${extendsNative}"${archetype.archetype === "text-input" ? ' /* or "textarea" \u2014 whichever native control you honestly build with */' : archetype.archetype === "selectable-control" ? ' /* or "button"/"select" \u2014 whichever native control you honestly build with; the contract binds to the one you pick */' : ' /* or "a" for link shapes */'}> {
 ${propLines.join("\n")}
-  [key: string]: unknown; // MUST spread unknown props (incl. data-*) onto the root element
-})
+}
+CONTRACT (the expert surface, part of the prescription): NO index-signature escape hatch ([key: string]: unknown is FORBIDDEN) \u2014 the native extension IS the rest-prop surface. Every prop not declared above (data-*, aria-*, native event handlers) forwards to the native control element, and the forwarded ref reaches that SAME element (import forwardRef and the ComponentPropsWithoutRef type from react; React-19 ref-as-prop is equally valid \u2014 the check binds ref.current to the control element, not to the mechanism). States the platform owns are DERIVED, never caller-set: no state/pose props beyond the interface above.` : `export function ${componentIdent}(props: ${componentIdent}Props)
+interface ${componentIdent}Props extends ComponentPropsWithoutRef<"div"> {
+${propLines.join("\n")}
+}
+CONTRACT: no index-signature escape hatch \u2014 the native extension is the rest-prop surface; undeclared props (incl. data-*) spread onto the root element.`;
+  const systemApi = `Prescribed API (the harness mounts exactly this; deviation scores 0):
+${signatureBlock}
 
 ${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.
+` : ""}${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.${slots.some((s) => s.richIn.length > 0) ? ` RICH POSES ARE NEVER PROP-FED: poses whose recorded slot content is itself a multi-run rich node do NOT receive the string prop from the harness (a plain string cannot reproduce the recorded formatting) \u2014 when the prop is absent, render THAT pose's recorded rich markup, keyed off the pose's own axis props; a caller-supplied string still renders plainly.` : ""}
+` : ""}${valueViaProp ? `VALUE POSES RIDE THE NATIVE SURFACE: the recorded value text for filled/typing poses mounts through defaultValue on your control (the rest props carry it \u2014 never intercept it into a custom prop). Derive value-state styling from the control's own value (:not(:placeholder-shown), or state you track from the control's change events) \u2014 never from a pose prop and never by branching on the forcing attribute.
 ` : ""}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 CHECKED_STATE_TOKENS = /* @__PURE__ */ new Set(["hover", "focus-visible"]);
+  const exercisedBooleans = props.filter((p) => p.kind === "boolean" && configs.some((c) => c.props[p.name] === true)).map((p) => p.name);
+  const checkedTokens = /* @__PURE__ */ new Set([...forcedStates.filter((t) => CHECKED_STATE_TOKENS.has(t)), ...exercisedBooleans]);
   const unmappedInteractionEvidence = interactionEvidence.filter((e) => {
     const sel = e.endsWith(" (selection axis)");
     const key = sel ? kebab3(e.slice(0, -" (selection axis)".length)) : kebab3(e.split("=").slice(1).join("="));
-    return !mappedTokens.has(key);
+    return !checkedTokens.has(key);
   });
-  return { component: componentIdent, entry, props, forcedStates, interactionEvidence, unmappedInteractionEvidence, syntheticCombos, configs, apiPin, systemApi };
+  return { component: componentIdent, entry, props, forcedStates, interactionEvidence, unmappedInteractionEvidence, satisfiabilityDemoted: [], syntheticCombos, textEntry, archetype, derivedPoseProps, derivedStateTokens: derivedStates, configs, apiPin, systemApi };
 }
 function authorBehaviors(api, extras = {}) {
   const behaviors = [];
@@ -9878,43 +10334,141 @@ function authorBehaviors(api, extras = {}) {
   if (anchor === void 0) return { behaviors, prelude: { controls: [], textInputs: [] }, disclosures };
   const selects = api.props.find((p) => p.kind === "boolean" && /^(selected|checked|isselected|ischecked)$/i.test(p.name));
   const committed = selects === void 0 ? void 0 : api.configs.find((c) => c.props[selects.name] === true && Object.keys(c.props).length === 1);
+  const NATIVE_CONTROL = api.archetype.nativeControl !== "" ? api.archetype.nativeControl : ":is(input, button, select)";
+  const recordedGapBelowFloor = (repA, repB) => {
+    if (repB === void 0 || repB === repA) return void 0;
+    const gap = extras.poseGap?.(repA, repB);
+    return gap !== void 0 && gap < POSE_GAP_FLOOR ? gap : void 0;
+  };
+  const recordedIdentical = (repA, repB) => repB !== void 0 && repB !== repA && extras.posesIdentical?.(repA, repB) === true;
+  const forcedPoseRep = (token) => api.configs.find((c) => {
+    const keys = Object.keys(c.props);
+    return keys.length === 1 && c.props["data-tendril-state"] === token;
+  })?.rep;
+  const demoteEvidence = (matches) => {
+    for (const e of api.interactionEvidence) {
+      if (!matches(e)) continue;
+      if (!api.unmappedInteractionEvidence.includes(e)) api.unmappedInteractionEvidence.push(e);
+      if (!api.satisfiabilityDemoted.includes(e)) api.satisfiabilityDemoted.push(e);
+    }
+  };
+  const demoteTokenToPixelOnly = (token) => {
+    demoteEvidence((e) => kebab3(e.split("=").slice(1).join("=")) === token);
+  };
   if (api.forcedStates.includes("hover")) {
-    behaviors.push({ id: "real-hover-responds", config: anchor.rep, steps: [{ hoverChangesPixels: "> *" }] });
+    if (!recordedIdentical(anchor.rep, forcedPoseRep("hover"))) {
+      behaviors.push({ id: "real-hover-responds", config: anchor.rep, steps: [{ hoverChangesPixels: "> *" }] });
+    } else {
+      demoteTokenToPixelOnly("hover");
+      disclosures.push(
+        `real-hover-responds NOT authored: the recorded hover pose is PIXEL-IDENTICAL to rest \u2014 the recording paints no hover difference at all, and demanding a real-hover pixel change would require invented ink; hover stays forceable and pixel-verified only. If hover should respond, the design needs a distinct hover treatment; re-record and re-author`
+      );
+    }
   }
   if (api.forcedStates.includes("focus-visible")) {
-    behaviors.push({ id: "focus-ring-visible", config: anchor.rep, steps: [{ tabFocusChangesPixels: true }] });
-    behaviors.push({ id: "no-ring-after-mouse-click", config: (committed ?? anchor).rep, steps: [{ mouseClickNoPersistentRing: "> *" }] });
+    if (!recordedIdentical(anchor.rep, forcedPoseRep("focus-visible"))) {
+      behaviors.push({ id: "focus-ring-visible", config: anchor.rep, steps: [{ tabFocusChangesPixels: true }] });
+    } else {
+      demoteTokenToPixelOnly("focus-visible");
+      disclosures.push(
+        `focus-ring-visible NOT authored: the recorded focus pose is PIXEL-IDENTICAL to rest \u2014 the recording paints no focus difference at all, and an invented ring is unrecorded pixels (the prelude keeps the browser's default indicator instead). If keyboard focus should be visible, the design needs a distinct focus treatment; re-record and re-author`
+      );
+    }
+    if (selects === void 0) {
+      behaviors.push({ id: "no-ring-after-mouse-click", config: anchor.rep, steps: [{ mouseClickNoPersistentRing: "> *" }] });
+    } else if (committed !== void 0) {
+      behaviors.push({ id: "no-ring-after-mouse-click", config: committed.rep, steps: [{ mouseClickNoPersistentRing: "> *" }] });
+    } else {
+      disclosures.push(
+        `no-ring-after-mouse-click NOT authored: this selection-bearing component records no already-committed pose to aim the check at, and clicking any other pose legitimately commits a repaint \u2014 the check would fail honest components and pass only statues (it must target a pose where clicking commits nothing)`
+      );
+    }
   }
   const disabledCfg = api.configs.find((c) => c.props["disabled"] === true);
   if (disabledCfg !== void 0) {
-    behaviors.push({ id: "disabled-not-focusable", config: disabledCfg.rep, steps: [{ assertNotFocusable: selects === void 0 ? "> *" : "input" }] });
+    behaviors.push({ id: "disabled-not-focusable", config: disabledCfg.rep, steps: [{ assertNotFocusable: selects === void 0 ? "> *" : NATIVE_CONTROL }] });
   }
   const loadingCfg = api.configs.find((c) => c.props["loading"] === true);
   if (loadingCfg !== void 0) {
-    behaviors.push({ id: "spinner-animates", config: loadingCfg.rep, steps: [{ assertAnimated: true }] });
+    demoteTokenToPixelOnly("loading");
+    disclosures.push(
+      `spinner-animates NOT authored: the recorded loading pose is a still, and recorded motion truth (prototype transitions) cannot prove an in-pose loop \u2014 demanding a running spinner would invent motion the recording never states; the loading pose stays pixel-verified only (motion ships PRESCRIBED, NOT VERIFIED per ADR-016)`
+    );
     behaviors.push({ id: "reduced-motion-respected", config: loadingCfg.rep, steps: [{ reducedMotionNoAnimation: true }] });
   }
   const selectionProp = selects;
   const committedPose = committed;
   if (selectionProp !== void 0) {
-    behaviors.push({ id: "native-control-present", config: anchor.rep, steps: [{ assertVisible: "input" }, { assertFocusable: "input" }] });
+    behaviors.push({ id: "native-control-present", config: anchor.rep, steps: [{ assertFocusable: NATIVE_CONTROL }] });
     behaviors.push({ id: "control-has-pointer-cursor", config: anchor.rep, steps: [{ assertCursor: ["> *", "pointer"] }] });
     if (committedPose !== void 0) {
-      behaviors.push({
-        id: "activation-commits-recorded-state",
-        config: anchor.rep,
-        steps: [{ commitMatchesPose: { activate: "input", pose: committedPose.rep } }]
-      });
+      const flat = recordedGapBelowFloor(anchor.rep, committedPose.rep);
+      if (flat === void 0) {
+        behaviors.push({
+          id: "activation-commits-recorded-state",
+          config: anchor.rep,
+          steps: [{ commitMatchesPose: { activate: NATIVE_CONTROL, pose: committedPose.rep } }]
+        });
+      } else {
+        demoteEvidence((e) => e.endsWith(" (selection axis)") || kebab3(e.split("=").slice(1).join("=")) === kebab3(selectionProp.name));
+        disclosures.push(
+          `activation-commits-recorded-state NOT authored: the recorded committed pose ("${committedPose.rep}") is pixel-indistinguishable from rest in the recording itself (gap ${flat.toFixed(4)}, floor ${POSE_GAP_FLOOR}) \u2014 committing can never be observed through pixels, on any round, from any component code; selection is presence-checked only. If selection should be visible, the design needs a distinct selected treatment; re-record and re-author`
+        );
+      }
     }
   }
   if (api.props.some((p) => p.kind === "callback" && p.name === "onDismiss")) {
     behaviors.push({
       id: "dismiss-notifies-and-commits",
-      config: anchor.rep,
+      // The pose whose recording SHOWS the affordance, when layer
+      // evidence named one — the anchor may not even contain the
+      // layer (run 22's over-constraint).
+      config: extras.dismissTargetRep ?? anchor.rep,
       spyProps: ["onDismiss"],
       steps: [{ assertVisible: "button" }, { assertFocusable: "button" }, { dismissNotifies: { activate: "button", prop: "onDismiss" } }]
     });
   }
+  if (api.archetype.archetype !== "static") {
+    const control = api.archetype.nativeControl;
+    behaviors.push({ id: "ref-reaches-control", config: anchor.rep, steps: [{ assertRefReachesControl: control }] });
+    behaviors.push({
+      id: "rest-props-reach-control",
+      config: anchor.rep,
+      // Minted per run by the checker — a fixed value is hardcodable
+      // with zero collateral (review).
+      props: { "data-tendril-probe": "__TENDRIL_MINT__" },
+      steps: [{ assertAttr: [control, "data-tendril-probe", "__TENDRIL_MINT__"] }]
+    });
+  }
+  const errorProp = api.props.find((p) => p.role === "error");
+  if (errorProp !== void 0 && api.archetype.archetype !== "static") {
+    const errCfg = api.configs.find((c) => typeof c.props[errorProp.name] === "string");
+    if (errCfg !== void 0) {
+      behaviors.push({
+        id: "error-pose-wires-aria",
+        config: errCfg.rep,
+        steps: [
+          { assertAttr: [api.archetype.nativeControl, "aria-invalid", "true"] },
+          // The idref must RESOLVE to an element carrying the message
+          // (review: a dangling aria-describedby is present-not-wired,
+          // the exact distinction the doctrine draws).
+          { assertDescribedByResolves: [api.archetype.nativeControl, String(errCfg.props[errorProp.name])] }
+        ]
+      });
+    }
+  }
+  if (api.archetype.archetype === "text-input") {
+    const control = api.archetype.nativeControl;
+    behaviors.push({ id: "value-entry-works", config: anchor.rep, props: { defaultValue: "" }, steps: [{ typeChangesPixels: [control, "ab"] }, { assertValue: [control, "ab"] }] });
+    behaviors.push({ id: "default-value-reaches-control", config: anchor.rep, props: { defaultValue: "__TENDRIL_MINT__" }, steps: [{ assertValue: [control, "__TENDRIL_MINT__"] }] });
+    behaviors.push({
+      id: "caller-onchange-fires",
+      config: anchor.rep,
+      props: { defaultValue: "" },
+      spyProps: ["onChange"],
+      steps: [{ type: [control, "a"] }, { assertSpyFired: "onChange" }]
+    });
+  }
   for (const sentinel of extras.sentinels ?? []) {
     const marker = `TENDRIL SENTINEL ${sentinel.prop}`;
     behaviors.push({
@@ -9932,31 +10486,114 @@ function authorBehaviors(api, extras = {}) {
   }
   if (api.unmappedInteractionEvidence.length > 0) {
     disclosures.push(
-      `interaction-looking poses PIXEL-VERIFIED ONLY (no operability check runs on them \u2014 the authoring vocabulary could not map them): ${api.unmappedInteractionEvidence.join(", ")}`
+      `interaction-looking poses PIXEL-VERIFIED ONLY (no operability check covers them): ${api.unmappedInteractionEvidence.join(", ")}`
     );
   }
-  return { behaviors, prelude: { controls: interactive ? ["> *"] : [], textInputs: [] }, disclosures };
+  const textEntry = api.textEntry.length > 0;
+  if (textEntry) {
+    disclosures.push(
+      `text-entry archetype (recorded evidence: ${api.textEntry.join(", ")}) \u2014 the root is exempt from the prelude's user-select:none requirement (selection suppression inherits into the control the canon requires to stay selectable); the editable control is checked selectable, and the root keeps its touch-action check`
+    );
+  }
+  return {
+    behaviors,
+    prelude: {
+      controls: interactive && !textEntry ? ["> *"] : [],
+      textInputs: textEntry ? [":is(input, textarea)"] : [],
+      ...interactive && textEntry ? { touchTargets: ["> *"] } : {}
+    },
+    disclosures
+  };
 }
 function envelopeText(file) {
-  return envelopeFirstTextPart(JSON.parse(readFileSync20(file, "utf8")));
+  return envelopeFirstTextPart(JSON.parse(readFileSync21(file, "utf8")));
 }
 function metadataText(file) {
-  return envelopeTextContent(JSON.parse(readFileSync20(file, "utf8")));
+  return envelopeTextContent(JSON.parse(readFileSync21(file, "utf8")));
 }
 function dismissEvidence(setDir, repSlugs) {
   for (const slug of repSlugs) {
-    const f = path30.join(setDir, slug, "get_design_context.json");
-    if (!existsSync24(f)) continue;
+    const f = path31.join(setDir, slug, "get_design_context.json");
+    if (!existsSync25(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]}"`;
-    for (const m of text.matchAll(/data-name="([^"]+)"/g)) {
-      const norm2 = m[1].toLowerCase().replace(/[^a-z0-9]/g, "");
-      if (DISMISS_NAMES.has(norm2)) return `layer ${JSON.stringify(m[1])}`;
+    const propHit = /[{,]\s*(\w*dismiss\w*)\s*=\s*true\b/i.exec(text);
+    if (propHit !== null) return { evidence: `emission prop "${propHit[1]}"`, visibleReps: [] };
+    const typedHit = /\b(\w*dismiss\w*)\??\s*:\s*boolean\b/i.exec(text);
+    if (typedHit !== null) {
+      return {
+        visibleReps: [],
+        demoted: `the kit's API declares a dismiss capability (typed member "${typedHit[1]}") but no recorded pose shows a default-on dismiss affordance \u2014 no onDismiss prop and no dismiss check were authored. If it should ship, record a pose with the affordance enabled and visible.`
+      };
+    }
+    for (const m of text.matchAll(/<[^>]*?data-name="([^"]+)"[^>]*?>/g)) {
+      const norm2 = normalizedLayerName(m[1]);
+      if (!DISMISS_NAMES.has(norm2)) continue;
+      const rawId = /data-node-id="([^"]+)"/.exec(m[0])?.[1];
+      const head = rawId === void 0 ? void 0 : rawId.startsWith("I") ? rawId.slice(1).split(";")[0] : rawId;
+      const byId = head === void 0 ? void 0 : poseVisibility(setDir, repSlugs, { nodeId: head });
+      const vis = byId !== void 0 && byId.presentIn.length > 0 ? byId : poseVisibility(setDir, repSlugs, { name: m[1] });
+      if (invisibleInEveryPose(vis)) {
+        return {
+          visibleReps: [],
+          demoted: `a dismiss affordance (layer ${JSON.stringify(m[1])}) exists in the design but is HIDDEN in every recorded pose \u2014 nothing verified stands behind it, so no onDismiss prop and no dismiss check were authored. If it should ship, add a variant that SHOWS it and re-record.`
+        };
+      }
+      const glyphIsTheComponent = (() => {
+        const slugToCheck = vis.visibleIn[0];
+        if (slugToCheck === void 0) return false;
+        const metaFile = path31.join(setDir, slugToCheck, "get_metadata.json");
+        try {
+          const root = parseMetadataStructure(envelopeTextContent(JSON.parse(readFileSync21(metaFile, "utf8"))));
+          if (root.children.length !== 1) return false;
+          const contains = (n) => normalizedLayerName(n.name) === norm2 || n.children.some(contains);
+          return contains(root.children[0]);
+        } catch {
+          return false;
+        }
+      })();
+      if (glyphIsTheComponent) {
+        return {
+          visibleReps: [],
+          demoted: `an x-shaped layer (${JSON.stringify(m[1])}) is the component's SOLE content \u2014 it reads as the component's own glyph (an icon button), not a dismiss affordance; no onDismiss was authored (the sweep's icon-button finding: a plain Control was ordered to "dismiss itself").`
+        };
+      }
+      return { evidence: `layer ${JSON.stringify(m[1])}`, visibleReps: vis.visibleIn };
     }
   }
   return void 0;
 }
+function recordedReferencePng(setDir, slug) {
+  const f = path31.join(setDir, slug, "get_screenshot.json");
+  if (!existsSync25(f)) return void 0;
+  try {
+    const env = JSON.parse(readFileSync21(f, "utf8")).content.find((c) => c.type === "image");
+    return env?.data === void 0 ? void 0 : Uint8Array.from(Buffer.from(env.data, "base64"));
+  } catch {
+    return void 0;
+  }
+}
+function recordedPoseGap(setDir, repA, repB) {
+  const a = recordedReferencePng(setDir, repA);
+  const b = recordedReferencePng(setDir, repB);
+  if (a === void 0 || b === void 0) return void 0;
+  try {
+    return 1 - compareRenderToReference(a, b).similarity;
+  } catch {
+    return void 0;
+  }
+}
+function recordedPosesIdentical(setDir, repA, repB) {
+  const a = recordedReferencePng(setDir, repA);
+  const b = recordedReferencePng(setDir, repB);
+  if (a === void 0 || b === void 0) return void 0;
+  try {
+    const pa = PNG3.sync.read(Buffer.from(a));
+    const pb = PNG3.sync.read(Buffer.from(b));
+    return pa.width === pb.width && pa.height === pb.height && Buffer.compare(pa.data, pb.data) === 0;
+  } catch {
+    return void 0;
+  }
+}
 function recordedFontNeeds(setDir, opts = {}) {
   const byFamily = /* @__PURE__ */ new Map();
   const unpaired = /* @__PURE__ */ new Set();
@@ -9990,13 +10627,13 @@ function recordedFontNeeds(setDir, opts = {}) {
     }
   };
   const manifest = loadManifest(setDir);
-  const setDefs = path30.join(setDir, "get_variable_defs.json");
-  if (existsSync24(setDefs)) fromDefs(envelopeText(setDefs));
+  const setDefs = path31.join(setDir, "get_variable_defs.json");
+  if (existsSync25(setDefs)) fromDefs(envelopeText(setDefs));
   for (const rep of manifest.reps) {
-    const ctx = path30.join(setDir, rep.slug, "get_design_context.json");
-    if (existsSync24(ctx)) fromEmission(envelopeText(ctx));
-    const defs = path30.join(setDir, rep.slug, "get_variable_defs.json");
-    if (existsSync24(defs)) fromDefs(envelopeText(defs));
+    const ctx = path31.join(setDir, rep.slug, "get_design_context.json");
+    if (existsSync25(ctx)) fromEmission(envelopeText(ctx));
+    const defs = path31.join(setDir, rep.slug, "get_variable_defs.json");
+    if (existsSync25(defs)) fromDefs(envelopeText(defs));
   }
   return [...byFamily.entries()].map(([family, paired]) => {
     const weights = /* @__PURE__ */ new Set([...paired, ...opts.pairedOnly === true ? [] : unpaired]);
@@ -10007,10 +10644,10 @@ 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 = path30.join(setDir, rep, "get_metadata.json");
-    if (!existsSync24(file)) continue;
+    const file = path31.join(setDir, rep, "get_metadata.json");
+    if (!existsSync25(file)) continue;
     try {
-      const text = JSON.parse(readFileSync20(file, "utf8")).content.map((c) => c.text ?? "").join("\n");
+      const text = JSON.parse(readFileSync21(file, "utf8")).content.map((c) => c.text ?? "").join("\n");
       for (const m of text.matchAll(/<text\s[^>]*name="([^"]*)"/g)) {
         const name = decodeXmlEntities(m[1]).replace(/&#x([0-9a-fA-F]+);/g, (_, h) => String.fromCodePoint(parseInt(h, 16))).replace(/&#(\d+);/g, (_, d) => String.fromCodePoint(Number(d)));
         if (PUA.test(name)) glyphs.add(name);
@@ -10036,8 +10673,8 @@ function recordedTextSlots(setDir, repSlugs) {
   const propRep = [];
   const perRep = [];
   for (const slug of repSlugs) {
-    const f = path30.join(setDir, slug, "get_design_context.json");
-    if (!existsSync24(f)) continue;
+    const f = path31.join(setDir, slug, "get_design_context.json");
+    if (!existsSync25(f)) continue;
     const code = envelopeText(f);
     const props = /* @__PURE__ */ new Map();
     for (const m of code.matchAll(/[{,]\s*(\w+)\s*=\s*"((?:[^"\\]|\\.)*)"/g)) {
@@ -10061,15 +10698,21 @@ function recordedTextSlots(setDir, repSlugs) {
     perRep.push({ slug, texts, code });
   }
   const axisValuesBySlug = /* @__PURE__ */ new Map();
+  const valuesByAxis = /* @__PURE__ */ new Map();
   for (const slug of repSlugs) {
-    const metaFile = path30.join(setDir, slug, "get_metadata.json");
-    if (!existsSync24(metaFile)) continue;
+    const metaFile = path31.join(setDir, slug, "get_metadata.json");
+    if (!existsSync25(metaFile)) continue;
     const name = symbolName(metadataText(metaFile));
     if (name === void 0) continue;
     const values = /* @__PURE__ */ new Set();
     for (const part of name.split(",")) {
       const eq = part.indexOf("=");
-      if (eq >= 0) values.add(kebab3(part.slice(eq + 1).trim()));
+      if (eq >= 0) {
+        const axis = kebab3(part.slice(0, eq).trim());
+        const value = kebab3(part.slice(eq + 1).trim());
+        (valuesByAxis.get(axis) ?? valuesByAxis.set(axis, /* @__PURE__ */ new Set()).get(axis)).add(value);
+        values.add(value);
+      }
     }
     axisValuesBySlug.set(slug, values);
   }
@@ -10083,7 +10726,11 @@ function recordedTextSlots(setDir, repSlugs) {
     }
     return seen > 0;
   };
-  const propNames = [...new Set(propRep.flatMap((r) => [...r.props.keys()]))].filter((n) => !isAxisMirror(n));
+  const alnum = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "");
+  const isAxisNamed = (name) => [...valuesByAxis.entries()].some(
+    ([axis, values]) => alnum(axis) === alnum(name) && ![...values].every((v) => v === "true" || v === "false")
+  );
+  const propNames = [...new Set(propRep.flatMap((r) => [...r.props.keys()]))].filter((n) => !isAxisMirror(n) && !isAxisNamed(n));
   if (propNames.length > 0) {
     return propNames.map((name) => {
       const counts = /* @__PURE__ */ new Map();
@@ -10092,18 +10739,24 @@ function recordedTextSlots(setDir, repSlugs) {
         if (v !== void 0) counts.set(v, (counts.get(v) ?? 0) + 1);
       }
       const def = [...counts.entries()].sort((a, b) => b[1] - a[1])[0][0];
+      const visibleIn = [];
+      const richIn = [];
+      for (const r of perRep) {
+        const v = propRep.find((pr) => pr.slug === r.slug)?.props.get(name) ?? def;
+        const norm2 = (s) => s.replace(/\s+/g, " ").trim();
+        const singleRun = r.texts.some((t) => norm2(t).includes(norm2(v)));
+        const assembled = !singleRun && norm2(r.texts.join(" ")).includes(norm2(v));
+        if (singleRun || assembled) visibleIn.push(r.slug);
+        if (assembled) richIn.push(r.slug);
+      }
       const overrides = {};
       for (const r of propRep) {
         const v = r.props.get(name);
-        if (v !== void 0 && v !== def) overrides[r.slug] = v;
+        if (v !== void 0 && v !== def && !richIn.includes(r.slug)) overrides[r.slug] = v;
       }
-      const visibleIn = perRep.filter((r) => {
-        const v = propRep.find((pr) => pr.slug === r.slug)?.props.get(name) ?? def;
-        return r.texts.some((t) => t.includes(v)) || r.texts.join(" ").replace(/\s+/g, " ").includes(v.replace(/\s+/g, " ").trim());
-      }).map((r) => r.slug);
       const refPattern = new RegExp(`\\{\\s*${name}\\s*\\}`);
       const referencedIn = perRep.filter((r) => refPattern.test(r.code)).map((r) => r.slug);
-      return { prop: name, default: def, overrides, varies: Object.keys(overrides).length > 0, visibleIn, referencedIn };
+      return { prop: name, default: def, overrides, varies: Object.keys(overrides).length > 0, visibleIn, referencedIn, richIn };
     });
   }
   if (perRep.length === 0) return [];
@@ -10150,7 +10803,7 @@ function recordedTextSlots(setDir, repSlugs) {
     usedNames.add(prop);
     const overrides = {};
     for (const [slug, v] of sl.values) if (v !== def) overrides[slug] = v;
-    return { prop, default: def, overrides, varies: Object.keys(overrides).length > 0, visibleIn: [...sl.values.keys()], referencedIn: [] };
+    return { prop, default: def, overrides, varies: Object.keys(overrides).length > 0, visibleIn: [...sl.values.keys()], referencedIn: [], richIn: [] };
   });
 }
 function authorTaskFromSet(setDir, opts = {}) {
@@ -10162,8 +10815,8 @@ function authorTaskFromSet(setDir, opts = {}) {
   const poses = [];
   const missing = [];
   for (const rep of manifest.reps) {
-    const metaFile = path30.join(setDir, rep.slug, "get_metadata.json");
-    if (!existsSync24(metaFile)) {
+    const metaFile = path31.join(setDir, rep.slug, "get_metadata.json");
+    if (!existsSync25(metaFile)) {
       missing.push(rep.slug);
       continue;
     }
@@ -10177,8 +10830,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 = path30.join(setDir, "get_metadata.json");
-  const latticeNames = manifest.latticeNames ?? (existsSync24(setMeta) ? [...metadataText(setMeta).matchAll(/name="([^"]*)"/g)].map((m) => decodeXmlEntities(m[1])) : void 0);
+  const setMeta = path31.join(setDir, "get_metadata.json");
+  const latticeNames = manifest.latticeNames ?? (existsSync25(setMeta) ? [...metadataText(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));
@@ -10200,7 +10853,7 @@ function authorTaskFromSet(setDir, opts = {}) {
     ...recordedFonts.length > 0 ? { recordedFonts } : {},
     ...Object.keys(defaults).length > 0 ? { defaults } : {},
     ...textSlots.length > 0 ? { textSlots } : {},
-    ...dismissName !== void 0 ? { dismissible: dismissName } : {}
+    ...dismissName?.evidence !== void 0 ? { dismissible: dismissName.evidence } : {}
   });
   const anchorSlug = api.configs.find((c) => Object.keys(c.props).length === 0)?.rep ?? api.configs[0]?.rep;
   const sentinels = textSlots.filter((slot) => !slot.varies).map((slot) => {
@@ -10224,19 +10877,35 @@ function authorTaskFromSet(setDir, opts = {}) {
     }
     return void 0;
   }).filter((x) => x !== void 0);
-  const { behaviors, prelude, disclosures } = authorBehaviors(api, { ...sentinels.length > 0 ? { sentinels } : {} });
+  const { behaviors, prelude, disclosures } = authorBehaviors(api, {
+    ...sentinels.length > 0 ? { sentinels } : {},
+    ...dismissName !== void 0 && dismissName.visibleReps.length > 0 ? { dismissTargetRep: dismissName.visibleReps[0] } : {},
+    // Author-time satisfiability inputs (run-22 cycle, Cycle C): the
+    // recorded-PNG oracles — every prescribed pose-distance check is
+    // gated on the recording proving it passable, each gate by the
+    // measure its runtime check actually applies.
+    poseGap: (a, b) => recordedPoseGap(setDir, a, b),
+    posesIdentical: (a, b) => recordedPosesIdentical(setDir, a, b)
+  });
+  if (dismissName?.demoted !== void 0) disclosures.push(dismissName.demoted);
   const puaGlyphs = symbolFontGlyphCount(setDir, manifest.reps.map((r) => r.slug));
   if (puaGlyphs > 0) {
     disclosures.push(
       `SYMBOL-FONT ICONS: ${puaGlyphs} distinct recorded icon glyph(s) come from a symbol font (private-use codepoints) \u2014 the recording carries NO vector geometry for them. Reconstruct each mark against the reference pixels with extreme care, compare magnified crops after every score (run 11 shipped a checkmark where the reference was a dot, and a diamond where it was two chevrons \u2014 both scored above bar), and NEVER give two configs sharing the same recorded glyph different shapes`
     );
   }
-  if (dismissName !== void 0) {
-    disclosures.push(`dismiss affordance detected from the recording (${dismissName}) \u2014 onDismiss authored; dismiss-notifies-and-commits enforces the notification contract`);
+  if (dismissName?.evidence !== void 0) {
+    disclosures.push(`dismiss affordance detected from the recording (${dismissName.evidence}) \u2014 onDismiss authored; dismiss-notifies-and-commits enforces the notification contract`);
   }
   for (const combo of api.syntheticCombos) {
     disclosures.push(`API split created a reachable pose with NO recorded truth: ${combo} (the design's exclusive axis cannot express it) \u2014 composed behavior only, disclosed to consumers`);
   }
+  for (const slot of textSlots) {
+    if (slot.richIn.length === 0) continue;
+    disclosures.push(
+      `content prop (recorded ${JSON.stringify(slot.default)}) renders as RICH multi-run text in pose(s) ${slot.richIn.join(", ")} \u2014 those poses never receive the prop through configs (the prescribed contract renders caller strings plainly, which would contradict the recorded formatting on pixels); each renders its recorded rich markup prop-absent and stays pixel-verified that way`
+    );
+  }
   for (const slot of textSlots) {
     if (slot.varies) continue;
     const sentineled = sentinels.some((sn) => api.props.some((pr) => pr.name === sn.prop && pr.default === slot.default));
@@ -10304,12 +10973,13 @@ ${PRELUDE_CONTRACT}
 ${opts.colorScheme === void 0 ? "" : `
 RESOLVED FOR THIS RECORDING: it is ${opts.colorScheme}-mode truth, so pin color-scheme: ${opts.colorScheme} on the root. A conditional rule you have to resolve yourself is a rule you will get wrong \u2014 this is the answer, not the question.`}`;
 }
-var PoseCompletenessError, kebab3, camel, pascal, RESERVED_PROPS, axisPropName, isStateAxis, DISMISS_NAMES, symbolName, STYLE_WEIGHTS2, styleWeight;
+var PoseCompletenessError, kebab3, camel, pascal, RESERVED_PROPS, NATIVE_ATTR_COLLISIONS, axisPropName, isStateAxis, DISMISS_NAMES, symbolName, STYLE_WEIGHTS2, styleWeight;
 var init_brief = __esm({
   "packages/generate/src/brief.ts"() {
     "use strict";
     init_src();
     init_src5();
+    init_archetype();
     PoseCompletenessError = class extends Error {
       inexpressible;
       constructor(inexpressible) {
@@ -10328,9 +10998,10 @@ var init_brief = __esm({
       return c === "" ? c : c[0].toUpperCase() + c.slice(1);
     };
     RESERVED_PROPS = /* @__PURE__ */ new Set(["style", "classname", "children", "key", "ref", "id"]);
+    NATIVE_ATTR_COLLISIONS = /* @__PURE__ */ new Set(["size", "type", "checked", "multiple", "value"]);
     axisPropName = (component, axis) => {
       const name = camel(axis);
-      return RESERVED_PROPS.has(name.toLowerCase()) ? camel(`${component} ${axis}`) : name;
+      return RESERVED_PROPS.has(name.toLowerCase()) || NATIVE_ATTR_COLLISIONS.has(name.toLowerCase()) ? camel(`${component} ${axis}`) : name;
     };
     isStateAxis = (axis) => kebab3(axis) === "state";
     DISMISS_NAMES = /* @__PURE__ */ new Set(["x", "close", "dismiss", "closebutton", "dismissbutton", "xbutton", "iconx", "iconclose", "icondismiss"]);
@@ -10361,10 +11032,10 @@ var init_brief = __esm({
 });
 
 // packages/generate/src/segments.ts
-import { existsSync as existsSync25, readFileSync as readFileSync21, readdirSync as readdirSync9 } from "node:fs";
-import path31 from "node:path";
+import { existsSync as existsSync26, readFileSync as readFileSync22, readdirSync as readdirSync9 } from "node:fs";
+import path32 from "node:path";
 function repText(set, rep, tool) {
-  const env = JSON.parse(readFileSync21(path31.join(set, rep, `${tool}.json`), "utf8"));
+  const env = JSON.parse(readFileSync22(path32.join(set, rep, `${tool}.json`), "utf8"));
   return tool === "get_design_context" ? envelopeFirstTextPart(env) : envelopeTextContent(env);
 }
 function stripFigmaInstructions(emission) {
@@ -10424,20 +11095,20 @@ DROPPED from the map, untrustworthy in the source export \u2014 for these, each
 }
 function buildSegments(task, mode = "fenced") {
   const SET = task.set;
-  let defsRecorded = existsSync25(path31.join(SET, "get_variable_defs.json"));
+  let defsRecorded = existsSync26(path32.join(SET, "get_variable_defs.json"));
   let rawDefs = {};
-  if (existsSync25(path31.join(SET, "get_variable_defs.json"))) {
-    const text = envelopeFirstTextPart(JSON.parse(readFileSync21(path31.join(SET, "get_variable_defs.json"), "utf8"))) || "{}";
+  if (existsSync26(path32.join(SET, "get_variable_defs.json"))) {
+    const text = envelopeFirstTextPart(JSON.parse(readFileSync22(path32.join(SET, "get_variable_defs.json"), "utf8"))) || "{}";
     try {
       rawDefs = JSON.parse(text);
     } catch {
     }
   } else {
     for (const cfg of task.configs) {
-      const f = path31.join(SET, cfg.rep, "get_variable_defs.json");
-      if (!existsSync25(f)) continue;
+      const f = path32.join(SET, cfg.rep, "get_variable_defs.json");
+      if (!existsSync26(f)) continue;
       defsRecorded = true;
-      const text = envelopeFirstTextPart(JSON.parse(readFileSync21(f, "utf8"))) || "{}";
+      const text = envelopeFirstTextPart(JSON.parse(readFileSync22(f, "utf8"))) || "{}";
       try {
         for (const [k, v] of Object.entries(JSON.parse(text))) rawDefs[k] ??= v;
       } catch {
@@ -10445,8 +11116,8 @@ function buildSegments(task, mode = "fenced") {
     }
   }
   const emissionTexts = task.configs.map((cfg) => {
-    const f = path31.join(SET, cfg.rep, "get_design_context.json");
-    return existsSync25(f) ? envelopeFirstTextPart(JSON.parse(readFileSync21(f, "utf8"))) : "";
+    const f = path32.join(SET, cfg.rep, "get_design_context.json");
+    return existsSync26(f) ? envelopeFirstTextPart(JSON.parse(readFileSync22(f, "utf8"))) : "";
   });
   const { map, note } = cleanTokenMap(rawDefs, emissionTexts);
   const defs = JSON.stringify(map, null, 1);
@@ -10463,9 +11134,9 @@ TOKEN MAP NEVER RECORDED: this set holds no get_variable_defs envelope, so wheth
   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 = readdirSync9(path31.join(SET, cfg.rep)).filter((f) => f.startsWith("asset-") && f.endsWith(".svg")).map((f) => `asset ${f}:
+    const assets = readdirSync9(path32.join(SET, cfg.rep)).filter((f) => f.startsWith("asset-") && f.endsWith(".svg")).map((f) => `asset ${f}:
 \`\`\`svg
-${readFileSync21(path31.join(SET, cfg.rep, f), "utf8")}
+${readFileSync22(path32.join(SET, cfg.rep, f), "utf8")}
 \`\`\``).join("\n");
     parts.push(`
 ## Config ${cfg.rep} \u2192 ${cfg.component} ${JSON.stringify(cfg.props)}
@@ -10490,7 +11161,7 @@ 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 ONE candidate directory: \`tendril-out/${path31.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.`);
+Write the COMPLETE files (${task.entry}, styles.css, optional tokens.css) into ONE candidate directory: \`tendril-out/${path32.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");
 }
@@ -10558,8 +11229,8 @@ var init_adapter = __esm({
 
 // packages/generate/src/bundle-emit.ts
 import { createHash as createHash5 } from "node:crypto";
-import { copyFileSync, existsSync as existsSync26, mkdirSync as mkdirSync7, readFileSync as readFileSync22, readdirSync as readdirSync10, rmSync as rmSync3, writeFileSync as writeFileSync11 } from "node:fs";
-import path32 from "node:path";
+import { copyFileSync, existsSync as existsSync27, mkdirSync as mkdirSync7, readFileSync as readFileSync23, readdirSync as readdirSync10, rmSync as rmSync3, writeFileSync as writeFileSync11 } from "node:fs";
+import path33 from "node:path";
 function pinFromConfigs(configs) {
   const domains = /* @__PURE__ */ new Map();
   const kinds = /* @__PURE__ */ new Map();
@@ -10628,9 +11299,9 @@ function fontsCssFor(faces, bundleDir, cacheDir = DEFAULT_FONT_CACHE, substitute
   const notices = [];
   const licenseTexts = /* @__PURE__ */ new Map();
   for (const face of faces) {
-    const src = path32.join(cacheDir, path32.basename(face.file));
-    const target = `./fonts/${path32.basename(face.file)}`;
-    const format = FONT_FORMATS[path32.extname(face.file).toLowerCase()] ?? "truetype";
+    const src = path33.join(cacheDir, path33.basename(face.file));
+    const target = `./fonts/${path33.basename(face.file)}`;
+    const format = FONT_FORMATS[path33.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);
@@ -10668,14 +11339,14 @@ function fontsCssFor(faces, bundleDir, cacheDir = DEFAULT_FONT_CACHE, substitute
           `/* ${decl} */`
         );
       }
-    } else if (existsSync26(src) && createHash5("sha256").update(readFileSync22(src)).digest("hex") === face.sha256) {
-      mkdirSync7(path32.join(bundleDir, "fonts"), { recursive: true });
-      copyFileSync(src, path32.join(bundleDir, "fonts", path32.basename(face.file)));
+    } else if (existsSync27(src) && createHash5("sha256").update(readFileSync23(src)).digest("hex") === face.sha256) {
+      mkdirSync7(path33.join(bundleDir, "fonts"), { recursive: true });
+      copyFileSync(src, path33.join(bundleDir, "fonts", path33.basename(face.file)));
       licenseTexts.set(terms.file, terms.text);
       const upstream = upstreamAttribution(face);
       notices.push(
         "",
-        `${face.family.replace(/[\r\n]+/g, " ")} ${face.weight} \u2014 ./${path32.basename(face.file)}`,
+        `${face.family.replace(/[\r\n]+/g, " ")} ${face.weight} \u2014 ./${path33.basename(face.file)}`,
         `  licence:   ${terms.title} \u2014 full text in ./${terms.file}`,
         `  source:    ${face.source}`,
         `  sha256:    ${face.sha256}`,
@@ -10689,9 +11360,9 @@ function fontsCssFor(faces, bundleDir, cacheDir = DEFAULT_FONT_CACHE, substitute
   }
   if (lines.length === 0) return null;
   if (notices.length > 0) {
-    const fontsDir = path32.join(bundleDir, "fonts");
-    for (const [file, text] of licenseTexts) writeFileSync11(path32.join(fontsDir, file), text);
-    writeFileSync11(path32.join(fontsDir, "NOTICE.txt"), `${[NOTICE_PREAMBLE, ...notices].join("\n")}
+    const fontsDir = path33.join(bundleDir, "fonts");
+    for (const [file, text] of licenseTexts) writeFileSync11(path33.join(fontsDir, file), text);
+    writeFileSync11(path33.join(fontsDir, "NOTICE.txt"), `${[NOTICE_PREAMBLE, ...notices].join("\n")}
 `);
     header.push(
       "/* REDISTRIBUTION: the face files in ./fonts/ are redistributed under the licences",
@@ -10703,10 +11374,10 @@ function fontsCssFor(faces, bundleDir, cacheDir = DEFAULT_FONT_CACHE, substitute
 `;
 }
 function countLatticeSymbols(setDir) {
-  const manifestFile = path32.join(setDir, "recording-set.json");
-  if (existsSync26(manifestFile)) {
+  const manifestFile = path33.join(setDir, "recording-set.json");
+  if (existsSync27(manifestFile)) {
     try {
-      const stored = JSON.parse(readFileSync22(manifestFile, "utf8"));
+      const stored = JSON.parse(readFileSync23(manifestFile, "utf8"));
       if (stored.variantScope !== "component-set") return null;
       const lattice = stored.latticeNames;
       if (lattice !== void 0 && lattice.length > 0) return lattice.length;
@@ -10714,13 +11385,13 @@ function countLatticeSymbols(setDir) {
     }
   }
   const files = [
-    path32.join(setDir, "get_metadata.json"),
-    ...existsSync26(setDir) ? readdirSync10(setDir).filter((f) => /^get_metadata-.*\.json$/.test(f)).map((f) => path32.join(setDir, f)) : []
-  ].filter((f) => existsSync26(f));
+    path33.join(setDir, "get_metadata.json"),
+    ...existsSync27(setDir) ? readdirSync10(setDir).filter((f) => /^get_metadata-.*\.json$/.test(f)).map((f) => path33.join(setDir, f)) : []
+  ].filter((f) => existsSync27(f));
   if (files.length === 0) return null;
   let count = 0;
   for (const f of files) {
-    const text = envelopeTextContent(JSON.parse(readFileSync22(f, "utf8")));
+    const text = envelopeTextContent(JSON.parse(readFileSync23(f, "utf8")));
     count += [...text.matchAll(/name="([^"]*)"/g)].filter((m) => m[1].includes("=")).length;
   }
   return count > 0 ? count : null;
@@ -10728,21 +11399,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 (existsSync26(path32.join(setDir, name))) relPaths.push(name);
+    if (existsSync27(path33.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 (existsSync26(path32.join(setDir, cfg.rep, f))) relPaths.push(`${cfg.rep}/${f}`);
+      if (existsSync27(path33.join(setDir, cfg.rep, f))) relPaths.push(`${cfg.rep}/${f}`);
     }
-    if (existsSync26(path32.join(setDir, cfg.rep))) {
-      for (const asset of readdirSync10(path32.join(setDir, cfg.rep)).filter((f) => f.startsWith("asset-"))) {
+    if (existsSync27(path33.join(setDir, cfg.rep))) {
+      for (const asset of readdirSync10(path33.join(setDir, cfg.rep)).filter((f) => f.startsWith("asset-"))) {
         relPaths.push(`${cfg.rep}/${asset}`);
       }
     }
   }
   return hashRecordingSet(
     relPaths,
-    (p) => new Uint8Array(readFileSync22(path32.join(setDir, p))),
+    (p) => new Uint8Array(readFileSync23(path33.join(setDir, p))),
     (chunks) => {
       const h = createHash5("sha256");
       for (const c of chunks) h.update(c);
@@ -10756,18 +11427,24 @@ function statusOf(s) {
 }
 function emitBundleV1(opts) {
   const substituted = (opts.substitutedFamilies ?? []).length > 0;
+  const parityFailed = new Set(opts.behaviors.filter((b) => b.id.startsWith("parity:") && !b.pass).map((b) => b.id.slice("parity:".length)));
   const statuses = opts.scores.map((s) => {
     const tier = statusOf(s);
-    return { rep: s.rep, similarity: s.similarity, inkRecall: s.inkRecall, ...s.exact !== void 0 ? { exact: s.exact } : {}, status: substituted && tier === "certified" ? "pass" : tier };
+    const demoted = parityFailed.has(s.rep) ? "fail" : substituted && tier === "certified" ? "pass" : tier;
+    return { rep: s.rep, similarity: s.similarity, inkRecall: s.inkRecall, ...s.exact !== void 0 ? { exact: s.exact } : {}, status: demoted };
   });
   const certified = statuses.filter((s) => s.status === "certified").length;
   const pass = statuses.filter((s) => s.status !== "fail").length;
   const lattice = countLatticeSymbols(opts.task.set);
-  const interaction = opts.behaviors.filter((b) => !b.id.startsWith("prelude:") && !b.id.startsWith("parity:") && !b.id.startsWith("composition:"));
+  const interaction = opts.behaviors.filter(
+    (b) => !b.id.startsWith("prelude:") && !b.id.startsWith("parity:") && !b.id.startsWith("composition:") && !b.id.startsWith("content-prop-renders(") && !CONTRACT_CHECK_IDS.has(b.id)
+  );
+  const content = opts.behaviors.filter((b) => b.id.startsWith("content-prop-renders("));
   const prelude = opts.behaviors.filter((b) => b.id.startsWith("prelude:"));
   const parity = opts.behaviors.filter((b) => b.id.startsWith("parity:"));
-  const cssFiles = ["styles.css", "tokens.css"].map((f) => path32.join(opts.bundleDir, f)).filter((f) => existsSync26(f));
-  const families = cssFontFamilies(cssFiles.map((f) => readFileSync22(f, "utf8")).join("\n"));
+  const contract = opts.behaviors.filter((b) => CONTRACT_CHECK_IDS.has(b.id));
+  const cssFiles = ["styles.css", "tokens.css"].map((f) => path33.join(opts.bundleDir, f)).filter((f) => existsSync27(f));
+  const families = cssFontFamilies(cssFiles.map((f) => readFileSync23(f, "utf8")).join("\n"));
   const requiredFonts = requiredFontsManifest(families, opts.fontCacheDir).map((f) => ({
     family: f.family,
     weight: f.weight,
@@ -10796,7 +11473,7 @@ function emitBundleV1(opts) {
         // resolvable via verify's --set override).
         path: (() => {
           const base = process.env["INIT_CWD"] ?? process.cwd();
-          const rel = path32.relative(base, opts.task.set);
+          const rel = path33.relative(base, opts.task.set);
           return rel !== "" && !rel.startsWith("..") ? rel : opts.task.set;
         })(),
         component: opts.componentName,
@@ -10816,25 +11493,29 @@ function emitBundleV1(opts) {
       interactionPassed: interaction.filter((b) => b.pass).length,
       interactionChecks: interaction.length,
       preludePassed: prelude.filter((b) => b.pass).length,
-      preludeChecks: prelude.length
+      preludeChecks: prelude.length,
+      contentPassed: content.filter((b) => b.pass).length,
+      contentChecks: content.length,
+      parityPassed: parity.filter((b) => b.pass).length,
+      parityChecks: parity.length
     })
   };
   const written = [];
-  const manifestPath2 = path32.join(opts.bundleDir, "component.json");
+  const manifestPath2 = path33.join(opts.bundleDir, "component.json");
   writeFileSync11(manifestPath2, `${JSON.stringify(manifest, null, 2)}
 `);
   written.push(manifestPath2);
-  const stylesPath = path32.join(opts.bundleDir, "styles.css");
-  if (existsSync26(stylesPath)) {
+  const stylesPath = path33.join(opts.bundleDir, "styles.css");
+  if (existsSync27(stylesPath)) {
     const comment = cssProvenanceComment({ pass, scored: statuses.length, certified, latticeConfigs: lattice });
-    const current = readFileSync22(stylesPath, "utf8");
+    const current = readFileSync23(stylesPath, "utf8");
     const stripped = current.replace(/^\/\* tendril bundle v\d+ [^]*?\*\/\n/, "");
     writeFileSync11(stylesPath, `${comment}
 ${stripped}`);
     written.push(stylesPath);
   }
-  const fontsCssPath = path32.join(opts.bundleDir, "fonts.css");
-  rmSync3(path32.join(opts.bundleDir, "fonts"), { recursive: true, force: true });
+  const fontsCssPath = path33.join(opts.bundleDir, "fonts.css");
+  rmSync3(path33.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) {
@@ -10842,7 +11523,10 @@ ${stripped}`);
     written.push(fontsCssPath);
   }
   const unrecorded = lattice === null ? null : Math.max(0, lattice - statuses.length);
-  const statusLine = `bundle: ${pass}/${statuses.length} recorded configs \u2265 pass bar (${certified} certified), ` + (interaction.length === 0 ? "interaction behaviors NONE VERIFIED" : `interaction behaviors ${interaction.filter((b) => b.pass).length}/${interaction.length}`) + (parity.length === 0 ? "" : `, state parity ${parity.filter((b) => b.pass).length}/${parity.length}`) + (prelude.length === 0 ? "" : `, page hygiene ${prelude.filter((b) => b.pass).length}/${prelude.length}`) + (unrecorded === null ? "" : `; ${unrecorded} lattice configs UNVERIFIED`) + ` \u2014 claims in component.json, recompute with \`tendril verify\``;
+  const statusLine = `bundle: ${pass}/${statuses.length} recorded configs \u2265 pass bar (${certified} certified), ` + (interaction.length === 0 ? "interaction behaviors NONE VERIFIED" : `interaction behaviors ${interaction.filter((b) => b.pass).length}/${interaction.length}`) + (content.length === 0 ? "" : `, content slots ${content.filter((b) => b.pass).length}/${content.length}`) + (contract.length === 0 ? "" : `, component contract ${contract.filter((b) => b.pass).length}/${contract.length}`) + (parity.length === 0 ? "" : `, state parity ${parity.filter((b) => b.pass).length}/${parity.length}`) + (prelude.length === 0 ? "" : `, page hygiene ${prelude.filter((b) => b.pass).length}/${prelude.length}`) + // Silence at null was readable as complete coverage (the sweep's
+  // M5 tail): the tri-state's worst spelling, in generate's one
+  // non-suppressible line.
+  (unrecorded === null ? "; coverage denominator UNKNOWN" : `; ${unrecorded} lattice configs UNVERIFIED`) + ` \u2014 claims in component.json, recompute with \`tendril verify\``;
   return { manifest, statusLine, written };
 }
 var FONT_FORMATS, BARS, NOTICE_PREAMBLE, OFL_1_1_TEXT, UFL_1_0_TEXT, APACHE_2_0_TEXT, REDISTRIBUTABLE;
@@ -11264,8 +11948,8 @@ DEALINGS IN THE FONT SOFTWARE.
 
 // packages/generate/src/compose-pins.ts
 import { createHash as createHash6 } from "node:crypto";
-import { existsSync as existsSync27, readFileSync as readFileSync23, readdirSync as readdirSync11, realpathSync as realpathSync3, statSync as statSync3 } from "node:fs";
-import path33 from "node:path";
+import { existsSync as existsSync28, readFileSync as readFileSync24, readdirSync as readdirSync11, realpathSync as realpathSync3, statSync as statSync3 } from "node:fs";
+import path34 from "node:path";
 function bundleDirs(roots, depth = 4) {
   const found = [];
   const seen = /* @__PURE__ */ new Set();
@@ -11274,11 +11958,11 @@ function bundleDirs(roots, depth = 4) {
     try {
       key = realpathSync3(dir);
     } catch {
-      key = path33.resolve(dir);
+      key = path34.resolve(dir);
     }
     if (seen.has(key)) return;
     seen.add(key);
-    if (existsSync27(path33.join(dir, "component.json"))) {
+    if (existsSync28(path34.join(dir, "component.json"))) {
       found.push(key);
       return;
     }
@@ -11291,14 +11975,14 @@ function bundleDirs(roots, depth = 4) {
     }
     for (const e of entries) {
       if (e === "node_modules" || e.startsWith(".")) continue;
-      const full = path33.join(dir, e);
+      const full = path34.join(dir, e);
       try {
         if (statSync3(full).isDirectory()) walk2(full, remaining - 1);
       } catch {
       }
     }
   };
-  for (const r of roots) walk2(path33.resolve(r), depth);
+  for (const r of roots) walk2(path34.resolve(r), depth);
   return found;
 }
 function composedPins(hostSet, libraryRoots) {
@@ -11317,7 +12001,7 @@ function composedPins(hostSet, libraryRoots) {
     let pinned = false;
     const failures = [];
     for (const rel of partnerRels) {
-      const partnerSet = path33.resolve(hostSet, rel);
+      const partnerSet = path34.resolve(hostSet, rel);
       let partnerTask;
       let partnerManifest;
       try {
@@ -11346,7 +12030,7 @@ function composedPins(hostSet, libraryRoots) {
       const wantHash = recordingSetHash(partnerSet, partnerTask.configs);
       const matches = candidates.filter((dir) => {
         try {
-          const parsed = readBundleManifest(readFileSync23(path33.join(dir, "component.json"), "utf8"));
+          const parsed = readBundleManifest(readFileSync24(path34.join(dir, "component.json"), "utf8"));
           return parsed.manifest?.provenance.recordingSet.hash === wantHash;
         } catch {
           return false;
@@ -11359,13 +12043,13 @@ function composedPins(hostSet, libraryRoots) {
         continue;
       }
       if (matches.length > 1) {
-        failures.push(`${rel}: ${matches.length} bundles join the same recording hash (${matches.map((m) => path33.basename(m)).join(", ")}) \u2014 ambiguous; remove or point --library away from the duplicates`);
+        failures.push(`${rel}: ${matches.length} bundles join the same recording hash (${matches.map((m) => path34.basename(m)).join(", ")}) \u2014 ambiguous; remove or point --library away from the duplicates`);
         continue;
       }
       const bundleDir = matches[0];
       let manifest;
       try {
-        manifest = readBundleManifest(readFileSync23(path33.join(bundleDir, "component.json"), "utf8")).manifest;
+        manifest = readBundleManifest(readFileSync24(path34.join(bundleDir, "component.json"), "utf8")).manifest;
       } catch {
         manifest = void 0;
       }
@@ -11382,8 +12066,8 @@ function composedPins(hostSet, libraryRoots) {
       const moduleFiles = [];
       let fileIssue;
       for (const name of [manifest.entry, "styles.css", "tokens.css", "fonts.css"]) {
-        const file = path33.join(bundleDir, name);
-        if (!existsSync27(file)) {
+        const file = path34.join(bundleDir, name);
+        if (!existsSync28(file)) {
           if (name === manifest.entry || name === "styles.css") {
             fileIssue = `${rel}: partner bundle is missing ${name}`;
             break;
@@ -11392,7 +12076,7 @@ function composedPins(hostSet, libraryRoots) {
         }
         let bytes;
         try {
-          bytes = readFileSync23(file);
+          bytes = readFileSync24(file);
         } catch {
           fileIssue = `${rel}: partner file ${name} at ${bundleDir} is unreadable`;
           break;
@@ -11463,14 +12147,14 @@ function composedChecks(candidateDir, hostEntry, pins) {
   const checks = [];
   let entrySource = "";
   try {
-    entrySource = readFileSync23(path33.join(candidateDir, hostEntry), "utf8");
+    entrySource = readFileSync24(path34.join(candidateDir, hostEntry), "utf8");
   } catch {
   }
-  const candidateRoot = path33.resolve(candidateDir);
+  const candidateRoot = path34.resolve(candidateDir);
   for (const pin of pins) {
     const dir = composedModuleDir(pin.partnerName);
-    const resolvedDir = path33.resolve(candidateDir, dir);
-    if (!resolvedDir.startsWith(candidateRoot + path33.sep)) {
+    const resolvedDir = path34.resolve(candidateDir, dir);
+    if (!resolvedDir.startsWith(candidateRoot + path34.sep)) {
       checks.push({ id: `composition:${pin.pairKey}:module-verbatim`, pass: false, detail: `pin path ${dir}/ escapes the candidate directory \u2014 refused` });
       checks.push({ id: `composition:${pin.pairKey}:imported`, pass: false, detail: `pin path ${dir}/ escapes the candidate directory \u2014 refused` });
       continue;
@@ -11481,12 +12165,12 @@ function composedChecks(candidateDir, hostEntry, pins) {
         wrong.push(`${f.name} refused (not a plain path segment)`);
         continue;
       }
-      const target = path33.join(candidateDir, dir, f.name);
-      if (!existsSync27(target)) {
+      const target = path34.join(candidateDir, dir, f.name);
+      if (!existsSync28(target)) {
         wrong.push(`${f.name} missing`);
         continue;
       }
-      const sha = createHash6("sha256").update(readFileSync23(target)).digest("hex");
+      const sha = createHash6("sha256").update(readFileSync24(target)).digest("hex");
       if (sha !== f.sha256) wrong.push(`${f.name} differs from the pinned partner bytes`);
     }
     checks.push({
@@ -11512,15 +12196,15 @@ var init_compose_pins = __esm({
     init_src4();
     init_brief();
     init_bundle_emit();
-    composedModuleDir = (partnerName) => path33.posix.join("composed", partnerName);
+    composedModuleDir = (partnerName) => path34.posix.join("composed", partnerName);
     safeSegment = (s) => /^[A-Za-z0-9][A-Za-z0-9._ -]*$/.test(s) && !s.includes("..");
     MAX_PINNED_FILE_BYTES = 1024 * 1024;
   }
 });
 
 // packages/generate/src/motion.ts
-import { existsSync as existsSync28, readFileSync as readFileSync24, readdirSync as readdirSync12, statSync as statSync4 } from "node:fs";
-import path34 from "node:path";
+import { existsSync as existsSync29, readFileSync as readFileSync25, readdirSync as readdirSync12, statSync as statSync4 } from "node:fs";
+import path35 from "node:path";
 function springProgress(u, bounce) {
   const decay = Math.log(100);
   if (bounce <= 0) {
@@ -11550,7 +12234,7 @@ function motionCanonCss() {
     `  --tendril-motion-${tier}-ease: ${springLinearEasing(t.bounce)};`
   ]);
   return [
-    ":root {",
+    ".\xABcomponent-root-class\xBB { /* substitute YOUR root class \u2014 never :root (token names on :root collide across composed bundles) */",
     ...lines,
     "}",
     "@media (prefers-reduced-motion: reduce) {",
@@ -11567,10 +12251,10 @@ function motionCanonCss() {
   ].join("\n");
 }
 function motionTruthFor(setDir) {
-  const file = path34.join(setDir, "get_motion_context.json");
-  if (existsSync28(file) && usableEnvelope(file, "get_motion_context").ok) {
+  const file = path35.join(setDir, "get_motion_context.json");
+  if (existsSync29(file) && usableEnvelope(file, "get_motion_context").ok) {
     try {
-      const text = envelopeTextContent(JSON.parse(readFileSync24(file, "utf8")));
+      const text = envelopeTextContent(JSON.parse(readFileSync25(file, "utf8")));
       return text.trim() === "" ? { state: "recorded-empty" } : { state: "recorded", text };
     } catch {
     }
@@ -11582,21 +12266,21 @@ function motionTruthFor(setDir) {
   }
 }
 function motionDisclosure(bundleDir, setDir) {
-  const sheets = ["styles.css", "tokens.css"].map((f) => path34.join(bundleDir, f));
-  const composedRoot = path34.join(bundleDir, "composed");
+  const sheets = ["styles.css", "tokens.css"].map((f) => path35.join(bundleDir, f));
+  const composedRoot = path35.join(bundleDir, "composed");
   try {
     for (const entry of readdirSync12(composedRoot).sort()) {
-      const dir = path34.join(composedRoot, entry);
+      const dir = path35.join(composedRoot, entry);
       try {
         if (!statSync4(dir).isDirectory()) continue;
       } catch {
         continue;
       }
-      sheets.push(path34.join(dir, "styles.css"), path34.join(dir, "tokens.css"));
+      sheets.push(path35.join(dir, "styles.css"), path35.join(dir, "tokens.css"));
     }
   } catch {
   }
-  const css = sheets.filter((f) => existsSync28(f)).map((f) => readFileSync24(f, "utf8")).join("\n");
+  const css = sheets.filter((f) => existsSync29(f)).map((f) => readFileSync25(f, "utf8")).join("\n");
   if (!MOTION_CSS_PATTERN.test(scannableCss(css))) return { present: false };
   return {
     present: true,
@@ -11615,7 +12299,7 @@ ${truth.text.length > RECORDED_QUOTE_CAP ? `${truth.text.slice(0, RECORDED_QUOTE
 === MOTION (PRESCRIBED, NOT VERIFIED \u2014 ADR-016) ===
 ${truthBlock}
 DOCTRINE (motion is information, not decoration \u2014 apply where a state change benefits from continuity, never decoratively):
-- Copy these tokens VERBATIM into styles.css when you apply ANY motion; no component invents its own duration \u2014 always the token:
+- Copy these tokens into styles.css when you apply ANY motion \u2014 declarations VERBATIM, but substitute your component's root class for \xABcomponent-root-class\xBB (never :root: the token-scope rule applies to motion tokens too); no component invents its own duration \u2014 always the token:
 ${motionCanonCss()}
 - Tier by SIZE of what moves: fast = hover/focus/selection/tooltips; moderate = local panels, indicators, switch thumbs; slow = dialogs and large surfaces.
 - ENTERS use the tier's spring ease (var(--tendril-motion-<tier>-ease)) over var(--tendril-motion-<tier>); EXITS are plain quicker tweens: ease-out over var(--tendril-motion-<tier>-exit) \u2014 a dismissal reads as crisp and final, never the entrance replayed in reverse.
@@ -11647,6 +12331,7 @@ var init_motion = __esm({
 var init_src7 = __esm({
   "packages/generate/src/index.ts"() {
     "use strict";
+    init_archetype();
     init_engine();
     init_engine_curated();
     init_loop2();
@@ -11662,9 +12347,9 @@ var init_src7 = __esm({
 });
 
 // packages/cli/src/font-guidance.ts
-import path35 from "node:path";
+import path36 from "node:path";
 function fontsUnprovenRemediation(setDir) {
-  const set = setDir === void 0 ? void 0 : path35.resolve(setDir);
+  const set = setDir === void 0 ? void 0 : path36.resolve(setDir);
   if (set !== void 0) {
     try {
       const needs = recordedFontNeeds(set);
@@ -11739,8 +12424,8 @@ __export(fonts_exports, {
   runFontsResolveSet: () => runFontsResolveSet,
   runFontsStatus: () => runFontsStatus
 });
-import { existsSync as existsSync29, readFileSync as readFileSync25 } from "node:fs";
-import path36 from "node:path";
+import { existsSync as existsSync30, readFileSync as readFileSync26 } from "node:fs";
+import path37 from "node:path";
 async function runFontsResolve(opts) {
   const result = await resolveFonts(opts.family, opts.weights, opts.cacheDir);
   const queryRefusal = systemFaceRefusal(opts.family.trim());
@@ -11761,7 +12446,7 @@ async function runFontsResolve(opts) {
   }
 }
 async function runFontsResolveSet(opts) {
-  const setDir = path36.resolve(process.env["INIT_CWD"] ?? process.cwd(), opts.set);
+  const setDir = path37.resolve(process.env["INIT_CWD"] ?? process.cwd(), opts.set);
   let needs = [];
   try {
     needs = recordedFontNeeds(setDir);
@@ -11844,16 +12529,16 @@ async function runFontsResolveSet(opts) {
   }
 }
 function runFontsStatus(opts) {
-  const manifestPath2 = path36.join(opts.cacheDir, "manifest.json");
-  if (!existsSync29(manifestPath2)) {
+  const manifestPath2 = path37.join(opts.cacheDir, "manifest.json");
+  if (!existsSync30(manifestPath2)) {
     fail(opts, ExitCode.FontsUnproven, {
       error: `no font cache at ${opts.cacheDir}`,
       code: "fonts-unresolved",
       remediation: `Run \`${tendrilCommand("fonts resolve --set <recording-dir>")}\` (or \`${tendrilCommand('fonts resolve "<Family>" --weights 400 500 600')}\`) first.`
     });
   }
-  const faces = JSON.parse(readFileSync25(manifestPath2, "utf8"));
-  const lockVerdicts = opts.lock !== void 0 ? checkFontLock(path36.resolve(opts.lock), opts.cacheDir) : null;
+  const faces = JSON.parse(readFileSync26(manifestPath2, "utf8"));
+  const lockVerdicts = opts.lock !== void 0 ? checkFontLock(path37.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)
 `);
@@ -11897,13 +12582,13 @@ function familyMismatch(family, declared) {
 }
 function runFontsAdd(opts) {
   if (opts.set !== void 0) {
-    const declared = taskFontFamilies(path36.resolve(opts.set)) ?? [];
+    const declared = taskFontFamilies(path37.resolve(opts.set)) ?? [];
     const mismatch = familyMismatch(opts.family, declared);
     if (mismatch !== void 0) {
       fail(opts, ExitCode.InputValidation, {
         error: `the recording set does not declare a family named "${opts.family}" \u2014 it declares ${declared.map((d) => `"${d}"`).join(", ")}. Adding it under this name would cache a face the mount never matches, and scoring would keep refusing for the family that is still missing.`,
         code: "font-family-not-declared",
-        remediation: mismatch.nearest !== void 0 ? `Did you mean "${mismatch.nearest}"? ${tendrilCommand(`fonts add "${mismatch.nearest}" ${opts.weight} ${opts.file} --set ${path36.resolve(opts.set)}`)}` : `Use one of the declared families exactly as the recording spells it, or drop --set to add a family this set does not declare.`
+        remediation: mismatch.nearest !== void 0 ? `Did you mean "${mismatch.nearest}"? ${tendrilCommand(`fonts add "${mismatch.nearest}" ${opts.weight} ${opts.file} --set ${path37.resolve(opts.set)}`)}` : `Use one of the declared families exactly as the recording spells it, or drop --set to add a family this set does not declare.`
       });
     }
   } else {
@@ -11962,13 +12647,13 @@ cache them: ${tendrilCommand(`fonts add-system ${quoteArg(opts.family)}`)}
 }
 function runFontsAddSystem(opts) {
   if (opts.set !== void 0) {
-    const declared = taskFontFamilies(path36.resolve(opts.set)) ?? [];
+    const declared = taskFontFamilies(path37.resolve(opts.set)) ?? [];
     const mismatch = familyMismatch(opts.family, declared);
     if (mismatch !== void 0) {
       fail(opts, ExitCode.InputValidation, {
         error: `the recording set does not declare a family named "${opts.family}" \u2014 it declares ${declared.map((d) => `"${d}"`).join(", ")}. A face cached under a name the mount never matches leaves scoring refusing for the family that is still missing.`,
         code: "font-family-not-declared",
-        remediation: mismatch.nearest !== void 0 ? `Did you mean "${mismatch.nearest}"? ${tendrilCommand(`fonts add-system ${quoteArg(mismatch.nearest)} --set ${quoteArg(path36.resolve(opts.set))}`)}` : `Use one of the declared families exactly as the recording spells it, or drop --set.`
+        remediation: mismatch.nearest !== void 0 ? `Did you mean "${mismatch.nearest}"? ${tendrilCommand(`fonts add-system ${quoteArg(mismatch.nearest)} --set ${quoteArg(path37.resolve(opts.set))}`)}` : `Use one of the declared families exactly as the recording spells it, or drop --set.`
       });
     }
   } else {
@@ -12038,24 +12723,34 @@ __export(verify_exports, {
   resolveComposition: () => resolveComposition,
   runVerify: () => runVerify
 });
-import { existsSync as existsSync30, readFileSync as readFileSync26 } from "node:fs";
-import path37 from "node:path";
+import { existsSync as existsSync31, readFileSync as readFileSync27 } from "node:fs";
+import path38 from "node:path";
 function interactionCoverage(behaviors) {
   const parity = behaviors.filter((b) => b.id.startsWith("parity:"));
-  const interaction = behaviors.filter((b) => !b.id.startsWith("prelude:") && !b.id.startsWith("parity:") && !b.id.startsWith("composition:"));
+  const content = behaviors.filter((b) => b.id.startsWith("content-prop-renders("));
+  const contract = behaviors.filter((b) => CONTRACT_CHECK_IDS.has(b.id));
+  const interaction = behaviors.filter(
+    (b) => !b.id.startsWith("prelude:") && !b.id.startsWith("parity:") && !b.id.startsWith("composition:") && !b.id.startsWith("content-prop-renders(") && !CONTRACT_CHECK_IDS.has(b.id)
+  );
   return {
     interactionChecks: interaction.length,
     interactionPassed: interaction.filter((b) => b.pass).length,
     preludeChecks: behaviors.filter((b) => b.id.startsWith("prelude:")).length,
+    contentChecks: content.length,
+    contentPassed: content.filter((b) => b.pass).length,
     parityChecks: parity.length,
     parityPassed: parity.filter((b) => b.pass).length,
+    contractChecks: contract.length,
+    contractPassed: contract.filter((b) => b.pass).length,
     // Asymmetric on purpose (review finding F3): a parity PASS never
     // makes operability "verified" (parity is pixel-parity, not
     // someone typing or clicking — the §0j miscount), but a parity
     // FAIL still forbids it — "verified" printed beside a broken hover
     // state is the one word doing too much lifting again, from the
-    // other direction.
-    operability: interaction.length > 0 && interaction.every((b) => b.pass) && parity.every((b) => b.pass) ? "verified" : "unverified"
+    // other direction. Contract checks (Cycle D review) get the SAME
+    // asymmetry: ref identity and attribute probes never mint
+    // "verified", a broken contract still forbids it.
+    operability: interaction.length > 0 && interaction.every((b) => b.pass) && parity.every((b) => b.pass) && contract.every((b) => b.pass) ? "verified" : "unverified"
   };
 }
 function operabilityReport(input) {
@@ -12144,7 +12839,7 @@ function checkSummarySegments(input) {
   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 occ = occlusionReport(input.occlusion);
-  const occlusion = "unavailable" in occ ? `occlusion not applicable (${NO_OVERLAY_DECLARED})` : `occlusion ${tally(input.occlusion)}`;
+  const occlusion = "unavailable" in occ ? `occlusion not applicable (${NO_OVERLAY_DECLARED})` : `occlusion ${occ.passed}/${occ.checks}${(occ.unmeasured ?? 0) > 0 ? ` measured (+${occ.unmeasured} unmeasured)` : ""}`;
   const operability = "short" in input.operability ? `operability UNVERIFIED (${input.operability.short})` : `operability ${input.operability.passed}/${input.operability.checks} interaction`;
   const cross = input.crossComposition === void 0 || input.crossComposition.rows.length === 0 && input.crossComposition.malformed === void 0 ? "" : input.crossComposition.malformed !== void 0 && input.crossComposition.rows.length === 0 ? ` \xB7 cross-composition NOT CHECKED (entries REJECTED)` : (() => {
     const supported = input.crossComposition.rows.filter((r) => r.status === "supported" || r.status === "stale-supported").length;
@@ -12224,7 +12919,9 @@ function occlusionReport(occlusion) {
       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 };
+  const measured = occlusion.filter((o) => o.unmeasured !== true);
+  const unmeasured = occlusion.length - measured.length;
+  return { checks: measured.length, passed: measured.filter((o) => o.pass).length, ...unmeasured > 0 ? { unmeasured } : {} };
 }
 function compositionReport(input) {
   const { availability, regions } = input;
@@ -12245,7 +12942,7 @@ function compositionReport(input) {
 function eyeCheck(bundleDir) {
   return {
     command: tendrilCommand(`inspect "${bundleDir}"`),
-    sheetPath: path37.join(bundleDir, "verify-evidence", "inspect.html"),
+    sheetPath: path38.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."
   };
 }
@@ -12257,7 +12954,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) => path37.resolve(t.set) === path37.resolve(setDir));
+  const registry = Object.values(TASKS).find((t) => path38.resolve(t.set) === path38.resolve(setDir));
   const authored = (() => {
     if (registry !== void 0) return void 0;
     try {
@@ -12291,24 +12988,27 @@ function taskFromManifest(opts, manifest, setDir) {
     // 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 ?? []
+    unmappedInteractionEvidence: authored?.api.unmappedInteractionEvidence ?? [],
+    satisfiabilityDemoted: authored?.api.satisfiabilityDemoted ?? [],
+    ...authored !== void 0 ? { expertContract: { archetype: authored.api.archetype.archetype, forwardRef: authored.api.apiPin.contract.forwardRef, derivedStateValues: authored.api.derivedStateTokens, publicUnionValues: authored.api.props.flatMap((p) => p.values ?? []) } } : {}
   };
 }
 async function runVerify(opts) {
   const callerCwd = process.env["INIT_CWD"] ?? process.cwd();
-  const setOverride = opts.set !== void 0 ? path37.resolve(callerCwd, opts.set) : void 0;
-  opts = { ...opts, bundleDir: path37.resolve(callerCwd, opts.bundleDir), ...setOverride !== void 0 ? { set: setOverride } : {} };
-  if (!existsSync30(opts.bundleDir)) {
+  let recordingSetDrift;
+  const setOverride = opts.set !== void 0 ? path38.resolve(callerCwd, opts.set) : void 0;
+  opts = { ...opts, bundleDir: path38.resolve(callerCwd, opts.bundleDir), ...setOverride !== void 0 ? { set: setOverride } : {} };
+  if (!existsSync31(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 = path37.join(opts.bundleDir, "component.json");
+  const manifestPath2 = path38.join(opts.bundleDir, "component.json");
   let manifest;
-  if (existsSync30(manifestPath2)) {
-    const { manifest: parsed, issues } = readBundleManifest(readFileSync26(manifestPath2, "utf8"));
+  if (existsSync31(manifestPath2)) {
+    const { manifest: parsed, issues } = readBundleManifest(readFileSync27(manifestPath2, "utf8"));
     if (issues.length > 0) {
       fail(opts, ExitCode.InputValidation, {
         error: `bundle manifest rejected at ingest: ${issues.map((i) => i.message).join("; ")}`,
@@ -12322,6 +13022,8 @@ async function runVerify(opts) {
   let unmapped = [];
   let interactionEvidence;
   let unmappedInteractionEvidence = [];
+  let satisfiabilityDemoted = [];
+  let expertContract;
   let authorityConfigs;
   let availability = ROLES_NOT_RESOLVED;
   if (opts.task !== void 0) {
@@ -12336,21 +13038,21 @@ async function runVerify(opts) {
     task = registry;
   } else if (manifest !== void 0) {
     const resolveSetDir = (p) => {
-      if (path37.isAbsolute(p)) return p;
-      const fromRepo = path37.resolve(REPO_ROOT, p);
-      if (existsSync30(fromRepo)) return fromRepo;
-      return path37.resolve(callerCwd, p);
+      if (path38.isAbsolute(p)) return p;
+      const fromRepo = path38.resolve(REPO_ROOT, p);
+      if (existsSync31(fromRepo)) return fromRepo;
+      return path38.resolve(callerCwd, p);
     };
     const setDir = opts.set ?? resolveSetDir(manifest.provenance.recordingSet.path);
-    if (!existsSync30(path37.join(setDir, "recording-set.json")) && !Object.values(TASKS).some((t) => path37.resolve(t.set) === path37.resolve(setDir))) {
+    if (!existsSync31(path38.join(setDir, "recording-set.json")) && !Object.values(TASKS).some((t) => path38.resolve(t.set) === path38.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) => path37.resolve(t.set) === path37.resolve(setDir));
-    if (registry !== void 0 && !existsSync30(path37.join(setDir, "recording-set.json"))) {
+    const registry = Object.values(TASKS).find((t) => path38.resolve(t.set) === path38.resolve(setDir));
+    if (registry !== void 0 && !existsSync31(path38.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));
@@ -12367,6 +13069,8 @@ async function runVerify(opts) {
       authorityConfigs = built.authorityConfigs;
       interactionEvidence = built.interactionEvidence;
       unmappedInteractionEvidence = built.unmappedInteractionEvidence;
+      satisfiabilityDemoted = built.satisfiabilityDemoted;
+      expertContract = built.expertContract;
       for (const s of built.adapterOnly) warn(opts, `prop adapter maps "${s}" which is not in the recording set \u2014 ignored`);
       availability = resolveComposition(loadManifest(setDir).roles);
       if (availability.warn !== void 0) warn(opts, availability.warn);
@@ -12374,11 +13078,12 @@ async function runVerify(opts) {
     const hash = recordingSetHash(setDir, task.configs);
     if (hash !== manifest.provenance.recordingSet.hash) {
       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`);
+      recordingSetDrift = { stamped: manifest.provenance.recordingSet.hash, current: hash };
     }
     for (const name of [manifest.entry, "styles.css", "tokens.css"]) {
-      const p = path37.join(opts.bundleDir, name);
-      if (!existsSync30(p)) continue;
-      const issues = checkBundleSourceFile(name, new Uint8Array(readFileSync26(p)));
+      const p = path38.join(opts.bundleDir, name);
+      if (!existsSync31(p)) continue;
+      const issues = checkBundleSourceFile(name, new Uint8Array(readFileSync27(p)));
       if (issues.length > 0) {
         fail(opts, ExitCode.InputValidation, {
           error: `bundle source rejected at ingest: ${issues.map((i) => i.message).join("; ")}`,
@@ -12416,7 +13121,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) => !existsSync30(path37.join(task.set, c.rep, "get_screenshot.json")) || !existsSync30(path37.join(task.set, c.rep, "get_metadata.json"))
+    (c) => !existsSync31(path38.join(task.set, c.rep, "get_screenshot.json")) || !existsSync31(path38.join(task.set, c.rep, "get_metadata.json"))
   );
   if (missing.length > 0) {
     fail(opts, ExitCode.RecordingIncomplete, {
@@ -12426,13 +13131,18 @@ async function runVerify(opts) {
     });
   }
   const bar = BARS2[opts.bar];
-  const evidenceDir = path37.join(opts.bundleDir, "verify-evidence");
+  const evidenceDir = path38.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) }, void 0, {
-    recordedTruth: motionTruthFor(task.set).state === "recorded"
-  });
-  const bundleCss = ["tokens.css", "styles.css"].map((f) => path37.join(opts.bundleDir, f)).filter((f) => existsSync30(f)).map((f) => readFileSync26(f, "utf8")).join("\n");
-  const occlusion = await checkSiblingOcclusion(task, opts.bundleDir, bundleCss);
+  const quality = await checkBundleQuality(
+    opts.bundleDir,
+    task.entry,
+    { dir: task.set, reps: task.configs.map((c) => c.rep) },
+    void 0,
+    { recordedTruth: motionTruthFor(task.set).state === "recorded" },
+    expertContract
+  );
+  const bundleCss = ["tokens.css", "styles.css"].map((f) => path38.join(opts.bundleDir, f)).filter((f) => existsSync31(f)).map((f) => readFileSync27(f, "utf8")).join("\n");
+  const occlusion = await checkSiblingOcclusion(task, opts.bundleDir, bundleCss, { ...authorityConfigs !== void 0 ? { authority: authorityConfigs } : {} });
   const parity = await checkHoverParity(task, opts.bundleDir, authorityConfigs ?? task.configs);
   const behaviors = [...await checkBehaviors(task, opts.bundleDir), ...parity];
   const structural = roles !== void 0 ? await checkStructuralComposition(task, opts.bundleDir, roles) : [];
@@ -12443,7 +13153,7 @@ async function runVerify(opts) {
     warn(opts, `compositions extension REJECTED (${crossComposition.malformed}) \u2014 the cross-bundle backstop did NOT run over it; repair the manifest entry and re-verify. This is an instrument failure, not a clean bill.`);
   }
   const verifyCallerCwd = process.env["INIT_CWD"] ?? process.cwd();
-  const verifyPins = crossComposition.rows.length > 0 ? composedPins(task.set, [opts.library !== void 0 ? path37.resolve(verifyCallerCwd, opts.library) : verifyCallerCwd]) : { pins: [], issues: [] };
+  const verifyPins = crossComposition.rows.length > 0 ? composedPins(task.set, [opts.library !== void 0 ? path38.resolve(verifyCallerCwd, opts.library) : verifyCallerCwd]) : { pins: [], issues: [] };
   const verifyComposedChecks = composedChecks(opts.bundleDir, task.entry, verifyPins.pins);
   const composedPairs = new Set(
     verifyPins.pins.filter((pin) => verifyComposedChecks.filter((c) => c.id.startsWith(`composition:${pin.pairKey}:`)).every((c) => c.pass)).map((pin) => pin.pairKey)
@@ -12480,7 +13190,8 @@ async function runVerify(opts) {
   const occlusionFailures = occlusion.filter((o) => !o.pass);
   const coverage = interactionCoverage(behaviors);
   const operability = operabilityReport({ behaviors, interactionEvidence });
-  const evidenceUnverified = (interactionEvidence?.length ?? 0) > 0 && coverage.interactionChecks === 0;
+  const ungatedEvidence = (interactionEvidence ?? []).filter((e) => !satisfiabilityDemoted.includes(e));
+  const evidenceUnverified = ungatedEvidence.length > 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;
@@ -12565,6 +13276,8 @@ async function runVerify(opts) {
     // what it is (prescribed) and what it is not (verified), plus
     // which truth the prescription stood on. Never a verdict input.
     motion: motionDisclosure(opts.bundleDir, task.set),
+    ...recordingSetDrift !== void 0 ? { recordingSetDrift } : {},
+    ...substitutedFamilies.length > 0 ? { substitutedFamilies } : {},
     eyeCheck: eyeCheck(opts.bundleDir)
   };
   emitData(opts, report, () => {
@@ -12680,7 +13393,7 @@ ${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) => path37.join(opts.bundleDir, f)).filter((f) => existsSync30(f)).map((f) => readFileSync26(f, "utf8")).join("\n")));
+    const shippedFonts = requiredFontsManifest(cssFontFamilies(["styles.css", "tokens.css"].map((f) => path38.join(opts.bundleDir, f)).filter((f) => existsSync31(f)).map((f) => readFileSync27(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)
 `);
@@ -12771,18 +13484,28 @@ __export(engine_exports, {
   runEngineBrief: () => runEngineBrief,
   runEngineScore: () => runEngineScore
 });
-import { appendFileSync, existsSync as existsSync31, mkdirSync as mkdirSync8, readFileSync as readFileSync27, writeFileSync as writeFileSync12 } from "node:fs";
-import path38 from "node:path";
+import { appendFileSync, existsSync as existsSync32, mkdirSync as mkdirSync8, readFileSync as readFileSync28, writeFileSync as writeFileSync12 } from "node:fs";
+import path39 from "node:path";
 function resolveEngineTask(opts, callerCwd) {
-  const asPath = path38.resolve(callerCwd, opts.taskOrSet);
-  const isSet = existsSync31(path38.join(asPath, "recording-set.json"));
+  const asPath = path39.resolve(callerCwd, opts.taskOrSet);
+  const isSet = existsSync32(path39.join(asPath, "recording-set.json"));
   const registry = TASKS[opts.taskOrSet];
   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: path38.basename(asPath), ref: asPath, disclosures: authored.disclosures, interactionEvidence: authored.api.interactionEvidence, apiPin: { props: authored.api.apiPin.props, forcedStates: authored.api.apiPin.forcedStates } };
+      return {
+        task: authored.task,
+        name: path39.basename(asPath),
+        ref: asPath,
+        disclosures: authored.disclosures,
+        interactionEvidence: authored.api.interactionEvidence,
+        unmappedInteractionEvidence: authored.api.unmappedInteractionEvidence,
+        satisfiabilityDemoted: authored.api.satisfiabilityDemoted,
+        expertContract: { archetype: authored.api.archetype.archetype, forwardRef: authored.api.apiPin.contract.forwardRef, derivedStateValues: authored.api.derivedStateTokens, publicUnionValues: authored.api.props.flatMap((p) => p.values ?? []) },
+        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)}`,
@@ -12809,9 +13532,9 @@ ${disclosures.map((d) => `- ${d}`).join("\n")}` : "";
   const brief = buildBrief(task.systemApi, bar, { colorScheme: recordingIsDark(task) ? "dark" : "light" }) + disclosureBlock + motionBriefSection(task.set);
   const segments = buildSegments(task, "files");
   let notRecorded;
-  const manifestPath2 = path38.join(task.set, "recording-set.json");
-  if (existsSync31(manifestPath2)) {
-    notRecorded = JSON.parse(readFileSync27(manifestPath2, "utf8")).notRecorded;
+  const manifestPath2 = path39.join(task.set, "recording-set.json");
+  if (existsSync32(manifestPath2)) {
+    notRecorded = JSON.parse(readFileSync28(manifestPath2, "utf8")).notRecorded;
   }
   const unverified = notRecorded !== void 0 && notRecorded !== "" ? `
 
@@ -12819,7 +13542,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 (existsSync31(manifestPath2)) {
+  if (existsSync32(manifestPath2)) {
     const missingFams = unprovisionedFamilies(task.set);
     const unprovided = unprovisionedFaces(task.set);
     const weightOnly = missingFams.length === 0;
@@ -12841,7 +13564,7 @@ ${notRecorded}` : "";
       };
     }
   }
-  const pinsResult = composedPins(task.set, [opts.library !== void 0 ? path38.resolve(callerCwd, opts.library) : callerCwd]);
+  const pinsResult = composedPins(task.set, [opts.library !== void 0 ? path39.resolve(callerCwd, opts.library) : callerCwd]);
   const jsxProp = ([k, v]) => typeof v === "string" ? `${k}=${JSON.stringify(v)}` : `${k}={${JSON.stringify(v)}}`;
   const composedBlock = pinsResult.pins.length === 0 && pinsResult.issues.length === 0 ? "" : (pinsResult.pins.length > 0 ? `
 
@@ -12863,9 +13586,9 @@ ${pinsResult.issues.map((i) => `- ${i}`).join("\n")}` : "");
 
 === TASK PAYLOAD (recorded truth, verbatim) ===
 ${segments}`;
-  const payloadFile = path38.resolve(callerCwd, opts.out ?? `tendril-out/${name}-brief.md`);
-  const candidateDirSuggestion = path38.resolve(callerCwd, `tendril-out/${name}-candidate`);
-  mkdirSync8(path38.dirname(payloadFile), { recursive: true });
+  const payloadFile = path39.resolve(callerCwd, opts.out ?? `tendril-out/${name}-brief.md`);
+  const candidateDirSuggestion = path39.resolve(callerCwd, `tendril-out/${name}-candidate`);
+  mkdirSync8(path39.dirname(payloadFile), { recursive: true });
   writeFileSync12(payloadFile, payload);
   emitData(
     opts,
@@ -12912,7 +13635,7 @@ ${segments}`;
         // command must search the same bundle roots the pins came
         // from, or the oracle and the brief describe different worlds.
         `Run \`${tendrilCommand(
-          `engine score ${quoteArg(ref)} ${quoteArg(candidateDirSuggestion)} --bar ${opts.bar} --model ${opts.model ?? "<declared-model>"}${opts.library !== void 0 ? ` --library ${quoteArg(path38.resolve(callerCwd, opts.library))}` : ""} --json`
+          `engine score ${quoteArg(ref)} ${quoteArg(candidateDirSuggestion)} --bar ${opts.bar} --model ${opts.model ?? "<declared-model>"}${opts.library !== void 0 ? ` --library ${quoteArg(path39.resolve(callerCwd, opts.library))}` : ""} --json`
         )}\` \u2014 the CLI is the sole judge, and it refuses to score an undeclared model. If you wrote the bundle elsewhere, pass that directory instead.`,
         "Apply the returned feedback and re-score. Stop when all checks pass. Two consecutive non-improving scores mean INSPECT the verify-evidence diffs before deciding \u2014 stop only when inspection yields no fix hypothesis (a measured run was byte-identical twice, then went 27/27 after reading the diffs).",
         "Never edit recording sets; never claim scores yourself \u2014 only the score command's output counts."
@@ -12927,8 +13650,8 @@ ${segments}`;
   );
 }
 function appendScoreHistory(candidateDir, entry) {
-  const file = path38.join(candidateDir, "score-history.jsonl");
-  const starts = existsSync31(file) ? readFileSync27(file, "utf8").split("\n").filter((l) => l.includes('"event":"round-start"')).length : 0;
+  const file = path39.join(candidateDir, "score-history.jsonl");
+  const starts = existsSync32(file) ? readFileSync28(file, "utf8").split("\n").filter((l) => l.includes('"event":"round-start"')).length : 0;
   const round = entry.event === "round-start" ? starts + 1 : Math.max(1, starts);
   appendFileSync(file, `${JSON.stringify({ at: (/* @__PURE__ */ new Date()).toISOString(), round, ...entry })}
 `);
@@ -12936,9 +13659,9 @@ function appendScoreHistory(candidateDir, entry) {
 async function runEngineScore(opts) {
   requireEntitlement(opts);
   const callerCwd = process.env["INIT_CWD"] ?? process.cwd();
-  const candidateDir = path38.resolve(callerCwd, opts.candidateDir);
-  const { task, name, apiPin, interactionEvidence } = resolveEngineTask(opts, callerCwd);
-  if (!existsSync31(candidateDir)) {
+  const candidateDir = path39.resolve(callerCwd, opts.candidateDir);
+  const { task, name, apiPin, interactionEvidence, unmappedInteractionEvidence: interactionEvidenceUnmapped, satisfiabilityDemoted, expertContract } = resolveEngineTask(opts, callerCwd);
+  if (!existsSync32(candidateDir)) {
     fail(opts, ExitCode.InputValidation, {
       error: `candidate directory not found: ${candidateDir}`,
       code: "candidate-missing",
@@ -12963,10 +13686,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 && existsSync31(path38.join(candidateDir, "component.json"))) {
+  if (opts.rebind !== true && existsSync32(path39.join(candidateDir, "component.json"))) {
     const prior = (() => {
       try {
-        const read = readBundleManifest(readFileSync27(path38.join(candidateDir, "component.json"), "utf8"));
+        const read = readBundleManifest(readFileSync28(path39.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 };
@@ -12988,18 +13711,25 @@ async function runEngineScore(opts) {
     }
   }
   const bar = BARS3[opts.bar];
-  const evidenceDir = path38.join(candidateDir, "verify-evidence");
+  const evidenceDir = path39.join(candidateDir, "verify-evidence");
   const scores = await scoreBundleForTask(task, candidateDir, bar, { evidenceDir, onProgress: emitProgress });
   const parity = await checkHoverParity(task, candidateDir, task.configs);
-  const scorePins = composedPins(task.set, [opts.library !== void 0 ? path38.resolve(callerCwd, opts.library) : callerCwd]);
+  const occlusionRows = await checkSiblingOcclusion(task, candidateDir, candidateCss(candidateDir), { authority: task.configs });
+  const occlusionFailures = occlusionRows.filter((o) => !o.pass);
+  const scorePins = composedPins(task.set, [opts.library !== void 0 ? path39.resolve(callerCwd, opts.library) : callerCwd]);
   const composition = composedChecks(candidateDir, task.entry, scorePins.pins);
   const behaviors = [...await checkBehaviors(task, candidateDir), ...parity, ...composition];
   const parityCoverage = parity.length > 0 ? `${parity.filter((p) => p.pass).length}/${parity.length} hover-forced configs` : "not applicable (no hover-forced configs in this set)";
   const obj = objective(scores, behaviors);
   const total = scores.length + behaviors.length;
-  const quality = await checkBundleQuality(candidateDir, task.entry, { dir: task.set, reps: task.configs.map((c) => c.rep) }, void 0, {
-    recordedTruth: motionTruthFor(task.set).state === "recorded"
-  });
+  const quality = await checkBundleQuality(
+    candidateDir,
+    task.entry,
+    { dir: task.set, reps: task.configs.map((c) => c.rep) },
+    void 0,
+    { recordedTruth: motionTruthFor(task.set).state === "recorded" },
+    expertContract
+  );
   const qualityFeedback = quality.findings.length === 0 && !quality.tokensAbsent ? "" : `
 
 QUALITY (does not affect the bar \u2014 fix alongside the failing configs):
@@ -13008,7 +13738,7 @@ ${[
     ...quality.tokensAbsent ? ["- no design tokens: no tokens.css and no var(--\u2026) reference; every value is hardcoded"] : []
   ].join("\n")}`;
   const absentAtCertBar = opts.bar === "cert" ? scores.filter((sc) => (sc.absentInk?.length ?? 0) > 0).map((sc) => sc.rep) : [];
-  const allPass = obj[0] === total && total > 0 && absentAtCertBar.length === 0;
+  const allPass = obj[0] === total && total > 0 && absentAtCertBar.length === 0 && occlusionFailures.length === 0;
   const certBar = BARS3["cert"];
   const parityDemoted = new Set(parity.filter((p) => !p.pass).map((p) => p.id.replace(/^parity:/, "")));
   const certifiedReps = substitutedFamilies.length > 0 ? [] : scores.filter((sc) => tierOf(sc, certBar) === "certified" && !parityDemoted.has(sc.rep) && (sc.absentInk === void 0 || sc.absentInk.length === 0)).map((sc) => sc.rep);
@@ -13025,11 +13755,14 @@ METRIC DEADBAND (read before iterating on near-misses): the scored similarity/in
   const stampNotice = `
 
 PROVENANCE STAMP: this scoring call itself (the Tendril CLI) just wrote/refreshed a comment on line 1 of styles.css carrying these scores, marked non-authoritative. If your editor or host reports styles.css was modified externally, that modification is this scorer \u2014 expected, not tampering. Keep the comment; it self-invalidates on any edit and \`tendril verify\` recomputes it.`;
+  const occlusionFeedback = occlusionFailures.length > 0 ? `
+
+OCCLUSION FAILURES (these block allPass and verify GATES on them): ${occlusionFailures.map((o) => `${o.id}${o.detail !== void 0 ? ` \u2014 ${o.detail}` : ""}`).join("; ")}` : "";
   const compositionFeedback = scorePins.issues.length > 0 ? `
 
 COMPOSITION PINS (ADR-013): ${scorePins.issues.length} confirmed pair(s) could not be pinned \u2014 verify will disclose each as confirmed-but-not-composed; not fixable by editing the candidate:
 ${scorePins.issues.map((i) => `- ${i}`).join("\n")}` : "";
-  const feedback = buildFeedback(scores, behaviors, bar, "files") + certificationFeedback + compositionFeedback + stampNotice + qualityFeedback;
+  const feedback = buildFeedback(scores, behaviors, bar, "files") + certificationFeedback + compositionFeedback + occlusionFeedback + stampNotice + qualityFeedback;
   const emitted = emitBundleV1({
     bundleDir: candidateDir,
     task,
@@ -13055,7 +13788,7 @@ ${scorePins.issues.map((i) => `- ${i}`).join("\n")}` : "";
   });
   const coverage = interactionCoverage(behaviors);
   const operability = operabilityReport({ behaviors, interactionEvidence });
-  const evidenceUnverified = (interactionEvidence?.length ?? 0) > 0 && coverage.interactionChecks === 0;
+  const evidenceUnverified = (interactionEvidence ?? []).filter((e) => !(satisfiabilityDemoted ?? []).includes(e)).length > 0 && coverage.interactionChecks === 0;
   const scoreMotion = motionDisclosure(candidateDir, task.set);
   emitData(
     opts,
@@ -13103,6 +13836,13 @@ ${scorePins.issues.map((i) => `- ${i}`).join("\n")}` : "";
       // ADR-016 §3: same disclosure as verify — the oracle must say
       // what verify will say about motion too.
       motion: scoreMotion,
+      // Cycle B M3 + M2: occlusion in the oracle's JSON, and the
+      // pixel-only poses on the VERDICT surface (they rode stderr
+      // while verify's report carried them — the run-22 focus channel,
+      // now fixed on the score side too).
+      occlusion: occlusionRows,
+      occlusionCheck: occlusionReport(occlusionRows),
+      ...interactionEvidenceUnmapped !== void 0 && interactionEvidenceUnmapped.length > 0 ? { pixelOnlyInteractionPoses: interactionEvidenceUnmapped } : {},
       allPass,
       environment: { ...environmentStamp(taskFontFamilies(task.set)), ruler: cliVersion() },
       ...lcdTextEnabled() ? { environmentOverrides: ["enable-lcd-text"] } : {},
@@ -13118,9 +13858,15 @@ ${scorePins.issues.map((i) => `- ${i}`).join("\n")}` : "";
       for (const b of behaviors) process.stdout.write(`${b.pass ? "PASS" : "FAIL"} ${b.id}${b.detail !== void 0 ? ` [${b.detail}]` : ""}
 `);
       for (const i of scorePins.issues) process.stdout.write(`PIN ISSUE ${i}
+`);
+      for (const o of occlusionRows) process.stdout.write(`${o.pass ? "PASS" : "FAIL"} ${o.id}${o.detail !== void 0 ? ` [${o.detail}]` : ""}
 `);
       if (scoreMotion.present) process.stdout.write(`MOTION ${scoreMotion.note}
 `);
+      for (const p of interactionEvidenceUnmapped ?? []) {
+        process.stdout.write(`PIXEL-ONLY ${p} \u2014 the recording proves this pose is interactive, but no operability check covers it
+`);
+      }
       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}
 `);
@@ -13134,6 +13880,9 @@ ${obj[0]}/${total} \xB7 certified ${certifiedReps.length}/${total} \xB7 floor=${
       }
     }
   );
+  if (occlusionFailures.length > 0) {
+    warn(opts, `${occlusionFailures.length} occlusion failure(s) block allPass (${occlusionFailures.map((o) => o.id).join(", ")}) \u2014 the OCCLUSION FAILURES feedback block carries each cause`);
+  }
   if (absentAtCertBar.length > 0) {
     warn(opts, `${absentAtCertBar.length} config(s) carry absent-ink clusters (${absentAtCertBar.join(", ")}) \u2014 at --bar cert these fail the run; the MISSING FEATURES block above names each one`);
   }
@@ -13179,11 +13928,11 @@ var codeconnect_exports = {};
 __export(codeconnect_exports, {
   runCodeConnect: () => runCodeConnect
 });
-import { existsSync as existsSync32, readFileSync as readFileSync28, writeFileSync as writeFileSync13 } from "node:fs";
-import path39 from "node:path";
+import { existsSync as existsSync33, readFileSync as readFileSync29, writeFileSync as writeFileSync13 } from "node:fs";
+import path40 from "node:path";
 function runCodeConnect(opts) {
   const callerCwd = process.env["INIT_CWD"] ?? process.cwd();
-  const bundleDir = path39.resolve(callerCwd, opts.bundleDir);
+  const bundleDir = path40.resolve(callerCwd, opts.bundleDir);
   let url;
   try {
     url = new URL(opts.figmaUrl);
@@ -13199,7 +13948,7 @@ function runCodeConnect(opts) {
   }
   let manifest;
   try {
-    const read = readBundleManifest(readFileSync28(path39.join(bundleDir, "component.json"), "utf8"));
+    const read = readBundleManifest(readFileSync29(path40.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) {
@@ -13209,8 +13958,8 @@ function runCodeConnect(opts) {
       remediation: "Point at a bundle produced by the Tendril pipeline (it carries component.json), and verify it first."
     });
   }
-  const setDir = path39.resolve(callerCwd, opts.set ?? manifest.provenance.recordingSet.path);
-  if (!existsSync32(path39.join(setDir, "recording-set.json"))) {
+  const setDir = path40.resolve(callerCwd, opts.set ?? manifest.provenance.recordingSet.path);
+  if (!existsSync33(path40.join(setDir, "recording-set.json"))) {
     fail(opts, ExitCode.InputValidation, {
       error: `recording set not found at ${setDir}`,
       code: "codeconnect-no-set",
@@ -13231,10 +13980,10 @@ function runCodeConnect(opts) {
   const component = api.component;
   const recManifest = loadManifest(setDir);
   const poseNames = recManifest.latticeNames ?? recManifest.reps.map((r) => {
-    const meta = path39.join(setDir, r.slug, "get_metadata.json");
-    if (!existsSync32(meta)) return void 0;
+    const meta = path40.join(setDir, r.slug, "get_metadata.json");
+    if (!existsSync33(meta)) return void 0;
     try {
-      return /name="([^"]*)"/.exec(envelopeTextContent(JSON.parse(readFileSync28(meta, "utf8"))))?.[1];
+      return /name="([^"]*)"/.exec(envelopeTextContent(JSON.parse(readFileSync29(meta, "utf8"))))?.[1];
     } catch {
       return void 0;
     }
@@ -13256,6 +14005,7 @@ function runCodeConnect(opts) {
   }
   const boolProps = api.props.filter((p) => p.kind === "boolean");
   const pixelOnly = [];
+  const derivedTokenFragments = [];
   const axisLines = [];
   const fragmentVars = [];
   for (const [axis, values] of Object.entries(axisDomains)) {
@@ -13270,8 +14020,11 @@ function runCodeConnect(opts) {
         fragment = owner.default === kv ? "" : ` ${owner.name}="${kv}"`;
       } else if (owner?.kind === "boolean") {
         fragment = ["true", "on", "yes"].includes(kv) ? ` ${owner.name}` : "";
+      } else if (api.derivedPoseProps[kv] !== void 0) {
+        fragment = Object.entries(api.derivedPoseProps[kv]).map(([name, v]) => ` ${name}={${JSON.stringify(v)}}`).join("");
       } else if (api.forcedStates.includes(kv)) {
         fragment = ` data-tendril-state="${kv}"`;
+        if (api.derivedStateTokens.includes(kv)) derivedTokenFragments.push(`${axis}=${value}`);
       } else if (boolProps.some((p) => p.name === kv || kebab4(p.name) === kv)) {
         fragment = ` ${boolProps.find((p) => p.name === kv || kebab4(p.name) === kv).name}`;
       } else if (value === axisDefault) {
@@ -13284,7 +14037,10 @@ function runCodeConnect(opts) {
         fail(opts, ExitCode.InputValidation, {
           error: `axis "${axis}" value "${value}" maps to nothing in the authored API \u2014 an unmapped value silently breaks the Dev Mode snippet`,
           code: "codeconnect-unmapped-value",
-          remediation: "Record the missing pose (the full matrix is the default plan) so the authored API covers the full lattice, then re-emit."
+          // Two distinct causes (review: the old text blamed the
+          // recording even when the pose WAS recorded and authoring
+          // simply had no mapping channel — an authoring gap is ours).
+          remediation: "If this pose was never recorded, record it (the full matrix is the default plan) and re-emit. If it IS recorded, the authored API has no mapping channel for it \u2014 an authoring gap, not a recording gap: report it rather than re-recording."
         });
       }
       entries.push(`${q(value)}: ${q(fragment)}`);
@@ -13292,7 +14048,7 @@ function runCodeConnect(opts) {
     axisLines.push(`const ${varName} = instance.getEnum(${q(axis)}, { ${entries.join(", ")} })`);
     fragmentVars.push(varName);
   }
-  const entryRel = path39.relative(callerCwd, path39.join(bundleDir, manifest.entry));
+  const entryRel = path40.relative(callerCwd, path40.join(bundleDir, manifest.entry));
   const trust = manifest.trustStatement.split("\n")[0] ?? "";
   const lines = [
     `// url=${opts.figmaUrl}`,
@@ -13301,6 +14057,9 @@ function runCodeConnect(opts) {
     "// Generated by Tendril. Claims below are the bundle's self-reported verification \u2014 recompute them free and offline with: tendril verify",
     `// ${trust}`,
     ...pixelOnly.length > 0 ? [`// PIXEL-VERIFIED ONLY (no operable mapping): ${pixelOnly.join(", ")}`] : [],
+    ...derivedTokenFragments.length > 0 ? [
+      `// DERIVED STATES (${derivedTokenFragments.join(", ")}): the data-tendril-state fragment forces the pose for preview parity only \u2014 in real use these states derive from focus/value on the control, never from an attribute you set`
+    ] : [],
     `import figma from 'figma'`,
     ``,
     `const instance = figma.selectedInstance`,
@@ -13313,7 +14072,7 @@ function runCodeConnect(opts) {
     `}`,
     ``
   ].join("\n");
-  const outFile = path39.resolve(callerCwd, opts.out ?? path39.join(bundleDir, `${component}.figma.ts`));
+  const outFile = path40.resolve(callerCwd, opts.out ?? path40.join(bundleDir, `${component}.figma.ts`));
   writeFileSync13(outFile, lines);
   emitData(
     opts,
@@ -13353,17 +14112,17 @@ var init_codeconnect = __esm({
 
 // packages/mcp/src/server.ts
 import { createHash as createHash7 } from "node:crypto";
-import { existsSync as existsSync33, mkdtempSync as mkdtempSync3, readFileSync as readFileSync29, readdirSync as readdirSync13, writeFileSync as writeFileSync14 } from "node:fs";
+import { existsSync as existsSync34, mkdtempSync as mkdtempSync3, readFileSync as readFileSync30, readdirSync as readdirSync13, writeFileSync as writeFileSync14 } from "node:fs";
 import os7 from "node:os";
-import path40 from "node:path";
+import path41 from "node:path";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
 import { z as z13 } from "zod";
 function sourceHash() {
-  const dir = path40.dirname(fileURLToPath6(import.meta.url));
+  const dir = path41.dirname(fileURLToPath6(import.meta.url));
   const h = createHash7("sha256");
   for (const f of readdirSync13(dir).filter((n) => n.endsWith(".ts")).sort()) {
     h.update(f);
-    h.update(readFileSync29(path40.join(dir, f)));
+    h.update(readFileSync30(path41.join(dir, f)));
   }
   return h.digest("hex").slice(0, 16);
 }
@@ -13371,10 +14130,10 @@ var REPO_ROOT3, CLI_BIN, BUNDLED_CLI, CLI_SPAWN, str, optStr, TOOLS, BOOT_HASH;
 var init_server = __esm({
   "packages/mcp/src/server.ts"() {
     "use strict";
-    REPO_ROOT3 = path40.resolve(path40.dirname(fileURLToPath6(import.meta.url)), "..", "..", "..");
-    CLI_BIN = path40.join(REPO_ROOT3, "packages", "cli", "src", "bin.ts");
-    BUNDLED_CLI = path40.join(path40.dirname(fileURLToPath6(import.meta.url)), "tendril.js");
-    CLI_SPAWN = existsSync33(BUNDLED_CLI) ? { cmd: process.execPath, prefix: [BUNDLED_CLI] } : { cmd: "npx", prefix: ["tsx", CLI_BIN] };
+    REPO_ROOT3 = path41.resolve(path41.dirname(fileURLToPath6(import.meta.url)), "..", "..", "..");
+    CLI_BIN = path41.join(REPO_ROOT3, "packages", "cli", "src", "bin.ts");
+    BUNDLED_CLI = path41.join(path41.dirname(fileURLToPath6(import.meta.url)), "tendril.js");
+    CLI_SPAWN = existsSync34(BUNDLED_CLI) ? { cmd: process.execPath, prefix: [BUNDLED_CLI] } : { cmd: "npx", prefix: ["tsx", CLI_BIN] };
     str = (d) => z13.string().describe(d);
     optStr = (d) => z13.string().optional().describe(d);
     TOOLS = [
@@ -13405,7 +14164,7 @@ var init_server = __esm({
           const single = i["metadata"];
           const parts = i["metadataParts"];
           if (single !== void 0 || parts !== void 0) {
-            const tmp = path40.join(mkdtempSync3(path40.join(os7.tmpdir(), "tendril-envelope-")), "response.txt");
+            const tmp = path41.join(mkdtempSync3(path41.join(os7.tmpdir(), "tendril-envelope-")), "response.txt");
             if (single !== void 0) {
               writeFileSync14(tmp, single);
               argvOut.push("--metadata-raw-file", tmp);
@@ -13488,7 +14247,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 = path40.join(mkdtempSync3(path40.join(os7.tmpdir(), "tendril-envelope-")), "response.txt");
+            const tmp = path41.join(mkdtempSync3(path41.join(os7.tmpdir(), "tendril-envelope-")), "response.txt");
             if (single !== void 0) {
               writeFileSync14(tmp, single);
               argvOut.push(`--${label}-file`, tmp);
@@ -13536,7 +14295,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 = path40.join(mkdtempSync3(path40.join(os7.tmpdir(), "tendril-envelope-")), "response.txt");
+          const tmp = path41.join(mkdtempSync3(path41.join(os7.tmpdir(), "tendril-envelope-")), "response.txt");
           if (text !== void 0) {
             writeFileSync14(tmp, text);
             return [...base, "--file", tmp, "--raw"];
@@ -13698,13 +14457,13 @@ __export(permissions_exports, {
   runPermissions: () => runPermissions,
   writeSelection: () => writeSelection
 });
-import { existsSync as existsSync34, mkdirSync as mkdirSync9, readFileSync as readFileSync30, writeFileSync as writeFileSync15 } from "node:fs";
+import { existsSync as existsSync35, mkdirSync as mkdirSync9, readFileSync as readFileSync31, writeFileSync as writeFileSync15 } from "node:fs";
 import os8 from "node:os";
-import path41 from "node:path";
+import path42 from "node:path";
 function mergeAllowlist(file, entries, denyEntries = []) {
   let settings = {};
-  if (existsSync34(file) && readFileSync30(file, "utf8").trim() !== "") {
-    settings = JSON.parse(readFileSync30(file, "utf8"));
+  if (existsSync35(file) && readFileSync31(file, "utf8").trim() !== "") {
+    settings = JSON.parse(readFileSync31(file, "utf8"));
     if (settings === null || typeof settings !== "object" || Array.isArray(settings)) throw new Error("settings root is not an object");
   }
   const permissions = settings["permissions"] ??= {};
@@ -13724,7 +14483,7 @@ function mergeAllowlist(file, entries, denyEntries = []) {
   }
   if (added.length > 0 || denyAdded.length > 0) {
     allow.push(...added);
-    mkdirSync9(path41.dirname(file), { recursive: true });
+    mkdirSync9(path42.dirname(file), { recursive: true });
     writeFileSync15(file, `${JSON.stringify(settings, null, 2)}
 `);
   }
@@ -13789,7 +14548,7 @@ async function runPermissions(flags) {
   }
   if (flags.write) {
     const base = process.env["INIT_CWD"] ?? process.cwd();
-    const file = flags.user ? path41.join(os8.homedir(), ".claude", "settings.json") : path41.join(base, ".claude", "settings.local.json");
+    const file = flags.user ? path42.join(os8.homedir(), ".claude", "settings.json") : path42.join(base, ".claude", "settings.local.json");
     const { entries, denyEntries } = writeSelection(result, flags.user === true);
     if (flags.dryRun) {
       emitData(flags, { file, wouldAdd: entries, wouldDeny: denyEntries }, () => {
@@ -13939,8 +14698,8 @@ __export(compose_exports, {
   runCompose: () => runCompose
 });
 import { createHash as createHash8 } from "node:crypto";
-import { existsSync as existsSync35, readFileSync as readFileSync31 } from "node:fs";
-import path42 from "node:path";
+import { existsSync as existsSync36, readFileSync as readFileSync32 } from "node:fs";
+import path43 from "node:path";
 function substitutionPairs(edges, hostSet) {
   const pairs = /* @__PURE__ */ new Map();
   for (const e of edges) {
@@ -13969,7 +14728,7 @@ function runCompose(flags) {
     return;
   }
   const base = process.env["INIT_CWD"] ?? process.cwd();
-  const roots = flags.library !== void 0 && flags.library.length > 0 ? flags.library.map((d) => path42.resolve(base, d)) : [base];
+  const roots = flags.library !== void 0 && flags.library.length > 0 ? flags.library.map((d) => path43.resolve(base, d)) : [base];
   if (flags.set === void 0 && (flags.confirmCompositions === true || flags.decline !== void 0 && flags.decline.length > 0)) {
     fail(flags, ExitCode.InputValidation, {
       error: "--confirm-compositions/--decline require --set <host> \u2014 a decision needs the host set it decides for",
@@ -13978,7 +14737,7 @@ function runCompose(flags) {
     });
   }
   if (flags.set !== void 0) {
-    runComposeConfirm(flags, path42.resolve(base, flags.set), roots);
+    runComposeConfirm(flags, path43.resolve(base, flags.set), roots);
     return;
   }
   const index = buildComposeIndex(roots);
@@ -13996,7 +14755,7 @@ function runCompose(flags) {
     }
     let lastHost = "";
     for (const e of edges) {
-      const host = `${path42.basename(e.hostSet)}`;
+      const host = `${path43.basename(e.hostSet)}`;
       if (host !== lastHost) {
         process.stdout.write(`
 ${host}
@@ -14004,7 +14763,7 @@ ${host}
         lastHost = host;
       }
       const partners = e.partners.map((p) => p.displayName).join(" / ") || "\u2014";
-      const pose = e.pose !== void 0 ? ` pose=${e.pose.variantNodeId} (${e.pose.reps.map((r) => `${path42.basename(r.dir)}:${r.slug}`).join(", ")})` : "";
+      const pose = e.pose !== void 0 ? ` pose=${e.pose.variantNodeId} (${e.pose.reps.map((r) => `${path43.basename(r.dir)}:${r.slug}`).join(", ")})` : "";
       process.stdout.write(`  ${e.kind.toUpperCase().padEnd(12)} ${e.hostRep}/${e.instanceId} "${e.instanceName}" \u2192 ${partners}${pose}
 `);
       for (const d of e.disclosures) process.stdout.write(`    \xB7 ${d}
@@ -14016,14 +14775,14 @@ ${NOTE}
   });
 }
 function runComposeConfirm(flags, hostSet, roots) {
-  if (!existsSync35(path42.join(hostSet, "recording-set.json"))) {
+  if (!existsSync36(path43.join(hostSet, "recording-set.json"))) {
     fail(flags, ExitCode.InputValidation, {
       error: `no recording-set.json in ${hostSet}`,
       code: "no-recording-set",
       remediation: "Point --set at a recorded host set (the directory holding recording-set.json)."
     });
   }
-  const scanRoots = [.../* @__PURE__ */ new Set([...roots, path42.dirname(hostSet)])];
+  const scanRoots = [.../* @__PURE__ */ new Set([...roots, path43.dirname(hostSet)])];
   const index = buildComposeIndex(scanRoots);
   const edges = composeReport(index);
   const pairs = substitutionPairs(edges, hostSet);
@@ -14104,7 +14863,7 @@ PAIR ${p.displayName} [${p.key}]${p.figmaFile !== void 0 ? ` file ${p.figmaFile}
       // full recording-set hash join lands with pin authoring, where
       // task configs exist.)
       manifestSha256: Object.fromEntries(
-        p.partnerDirs.map((d) => [path42.relative(hostSet, d), createHash8("sha256").update(readFileSync31(path42.join(d, "recording-set.json"))).digest("hex")])
+        p.partnerDirs.map((d) => [path43.relative(hostSet, d), createHash8("sha256").update(readFileSync32(path43.join(d, "recording-set.json"))).digest("hex")])
       )
     },
     instances: p.instances,
@@ -14145,7 +14904,7 @@ var init_compose2 = __esm({
       ],
       output: {
         sets: "string[] \u2014 recording sets indexed (--list)",
-        edges: "per-instance edges: kind (substitution | nested | ask | proposal | external), partners, pose (variant node id + per-set rep slugs), disclosures (--list)",
+        edges: "per-instance edges: kind (substitution | nested | ask | proposal | external | hidden \u2014 hidden = invisible in every recorded pose, disclosed and never confirmable), partners, pose (variant node id + per-set rep slugs), disclosures (--list)",
         openPairs: "with --set: undecided id-backed pairs awaiting a human decision",
         standing: "with --set: persisted confirmations/declines (asked once)",
         note: "string \u2014 what this command does NOT do"
@@ -14163,24 +14922,24 @@ __export(inspect_exports, {
   INSPECT_DESCRIPTION: () => INSPECT_DESCRIPTION,
   runInspect: () => runInspect
 });
-import { existsSync as existsSync36, readFileSync as readFileSync32, writeFileSync as writeFileSync16 } from "node:fs";
-import path43 from "node:path";
+import { existsSync as existsSync37, readFileSync as readFileSync33, writeFileSync as writeFileSync16 } from "node:fs";
+import path44 from "node:path";
 async function runInspect(opts) {
   if (opts.describe) {
     printDescription(INSPECT_DESCRIPTION);
     return;
   }
-  const bundleDir = path43.resolve(opts.bundleDir);
-  const evidenceDir = path43.join(bundleDir, "verify-evidence");
-  const manifestPath2 = path43.join(bundleDir, "component.json");
-  if (!existsSync36(evidenceDir) || !existsSync36(manifestPath2)) {
+  const bundleDir = path44.resolve(opts.bundleDir);
+  const evidenceDir = path44.join(bundleDir, "verify-evidence");
+  const manifestPath2 = path44.join(bundleDir, "component.json");
+  if (!existsSync37(evidenceDir) || !existsSync37(manifestPath2)) {
     fail(opts, ExitCode.InputValidation, {
-      error: `nothing to inspect in ${bundleDir} \u2014 ${existsSync36(manifestPath2) ? "no verify-evidence directory" : "no component.json"}`,
+      error: `nothing to inspect in ${bundleDir} \u2014 ${existsSync37(manifestPath2) ? "no verify-evidence directory" : "no component.json"}`,
       code: "no-evidence",
       remediation: `Run \`${tendrilCommand(`verify ${bundleDir}`)}\` first \u2014 inspect reads the ref/render evidence that run writes.`
     });
   }
-  const { manifest } = readBundleManifest(readFileSync32(manifestPath2, "utf8"));
+  const { manifest } = readBundleManifest(readFileSync33(manifestPath2, "utf8"));
   if (manifest === void 0) {
     fail(opts, ExitCode.InputValidation, {
       error: "component.json did not parse as a bundle manifest",
@@ -14188,8 +14947,8 @@ async function runInspect(opts) {
       remediation: "Re-emit the bundle (score/verify rewrite component.json), then re-run inspect."
     });
   }
-  const setDir = path43.resolve(opts.set ?? manifest.provenance.recordingSet.path);
-  const reps = Object.keys(manifest.propAdapter).filter((rep) => existsSync36(path43.join(evidenceDir, `${rep}-ref.png`)) && existsSync36(path43.join(evidenceDir, `${rep}-render.png`)));
+  const setDir = path44.resolve(opts.set ?? manifest.provenance.recordingSet.path);
+  const reps = Object.keys(manifest.propAdapter).filter((rep) => existsSync37(path44.join(evidenceDir, `${rep}-ref.png`)) && existsSync37(path44.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",
@@ -14200,15 +14959,15 @@ async function runInspect(opts) {
   let crops = 0;
   const sections = [];
   for (const rep of reps) {
-    const ref = new Uint8Array(readFileSync32(path43.join(evidenceDir, `${rep}-ref.png`)));
-    const render = new Uint8Array(readFileSync32(path43.join(evidenceDir, `${rep}-render.png`)));
+    const ref = new Uint8Array(readFileSync33(path44.join(evidenceDir, `${rep}-ref.png`)));
+    const render = new Uint8Array(readFileSync33(path44.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(path43.join(evidenceDir, `${rep}-inspect-${i}-ref.png`), zoomCrop(ref, rect));
-        writeFileSync16(path43.join(evidenceDir, `${rep}-inspect-${i}-render.png`), zoomCrop(render, rect));
+        writeFileSync16(path44.join(evidenceDir, `${rep}-inspect-${i}-ref.png`), zoomCrop(ref, rect));
+        writeFileSync16(path44.join(evidenceDir, `${rep}-inspect-${i}-render.png`), zoomCrop(render, rect));
       } catch {
         continue;
       }
@@ -14221,7 +14980,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 = path43.join(evidenceDir, "inspect.html");
+  const sheet = path44.join(evidenceDir, "inspect.html");
   writeFileSync16(
     sheet,
     `<!doctype html><meta charset="utf-8"><title>${esc(manifest.name)} \u2014 tendril inspect</title><style>
@@ -14299,17 +15058,17 @@ __export(generate_recorded_exports, {
   runGenerateRecorded: () => runGenerateRecorded
 });
 import { confirm as confirm3, isCancel as isCancel3 } from "@clack/prompts";
-import { existsSync as existsSync37, readFileSync as readFileSync33 } from "node:fs";
-import path44 from "node:path";
+import { existsSync as existsSync38, readFileSync as readFileSync34 } from "node:fs";
+import path45 from "node:path";
 async function runGenerateRecorded(opts) {
   const callerCwd = process.env["INIT_CWD"] ?? process.cwd();
-  const outDirAbs = path44.resolve(callerCwd, opts.out);
-  const recordedAsPath = path44.resolve(callerCwd, opts.recorded);
+  const outDirAbs = path45.resolve(callerCwd, opts.out);
+  const recordedAsPath = path45.resolve(callerCwd, opts.recorded);
   let task;
   let taskName;
   let authoredApi;
   let composition;
-  const isSet = existsSync37(path44.join(recordedAsPath, "recording-set.json"));
+  const isSet = existsSync38(path45.join(recordedAsPath, "recording-set.json"));
   const registry = TASKS[opts.recorded];
   if (registry !== void 0 && !isSet) {
     task = registry;
@@ -14318,7 +15077,7 @@ async function runGenerateRecorded(opts) {
     try {
       const authored = authorTaskFromSet(recordedAsPath);
       task = authored.task;
-      taskName = path44.basename(recordedAsPath);
+      taskName = path45.basename(recordedAsPath);
       authoredApi = authored.api;
       const roles = RolesSchema.safeParse(loadManifest(recordedAsPath).roles);
       if (roles.success) composition = roles.data;
@@ -14352,7 +15111,7 @@ 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) => !existsSync37(path44.join(task.set, c.rep, "get_screenshot.json")) || !existsSync37(path44.join(task.set, c.rep, "get_metadata.json")) || !existsSync37(path44.join(task.set, c.rep, "get_design_context.json"))
+    (c) => !existsSync38(path45.join(task.set, c.rep, "get_screenshot.json")) || !existsSync38(path45.join(task.set, c.rep, "get_metadata.json")) || !existsSync38(path45.join(task.set, c.rep, "get_design_context.json"))
   );
   if (missing.length > 0) {
     fail(opts, ExitCode.RecordingIncomplete, {
@@ -14422,8 +15181,8 @@ async function runGenerateRecorded(opts) {
 ` : `${line}
 `);
   if (opts.dryRun) {
-    emitData(opts, { dryRun: true, task: taskName, model: modelId, consent, wouldWrite: path44.join(outDirAbs, taskName) }, () => {
-      process.stdout.write(`dry-run: nothing sent, nothing written (would write ${path44.join(outDirAbs, taskName)})
+    emitData(opts, { dryRun: true, task: taskName, model: modelId, consent, wouldWrite: path45.join(outDirAbs, taskName) }, () => {
+      process.stdout.write(`dry-run: nothing sent, nothing written (would write ${path45.join(outDirAbs, taskName)})
 `);
     });
     return;
@@ -14446,10 +15205,10 @@ async function runGenerateRecorded(opts) {
       });
     }
   }
-  const bundleDir = path44.join(outDirAbs, taskName);
-  if (existsSync37(path44.join(bundleDir, "component.json"))) {
+  const bundleDir = path45.join(outDirAbs, taskName);
+  if (existsSync38(path45.join(bundleDir, "component.json"))) {
     try {
-      const prior = readBundleManifest(readFileSync33(path44.join(bundleDir, "component.json"), "utf8")).manifest;
+      const prior = readBundleManifest(readFileSync34(path45.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`,
@@ -14615,7 +15374,7 @@ init_invocation();
 init_output();
 import { intro, isCancel, outro, password } from "@clack/prompts";
 import fs from "node:fs";
-import path26 from "node:path";
+import path27 from "node:path";
 var INIT_DESCRIPTION = {
   name: "init",
   summary: "Configure Figma and OpenRouter credentials in .env (idempotent).",
@@ -14652,7 +15411,7 @@ async function runInit(flags) {
     printDescription(INIT_DESCRIPTION);
     return;
   }
-  const envPath = path26.resolve(process.cwd(), ".env");
+  const envPath = path27.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);
@@ -14673,7 +15432,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 = path26.resolve(process.cwd(), ".gitignore");
+  const gitignorePath = path27.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) {
@@ -14729,14 +15488,14 @@ init_invocation();
 init_output();
 init_entitlement();
 import { confirm as confirm2, isCancel as isCancel2 } from "@clack/prompts";
-import { readFileSync as readFileSync17, readdirSync as readdirSync7, existsSync as existsSync21 } from "node:fs";
+import { readFileSync as readFileSync18, readdirSync as readdirSync7, existsSync as existsSync22 } from "node:fs";
 
 // packages/cli/src/pipeline.ts
 init_src2();
 init_src5();
 init_src4();
 import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync8 } from "node:fs";
-import path27 from "node:path";
+import path28 from "node:path";
 
 // packages/cli/src/assets-module.ts
 init_src();
@@ -15072,7 +15831,7 @@ async function runGenerationPipeline(input) {
   });
   const written = [];
   if (!input.dryRun) {
-    const dir = path27.resolve(input.outDir, semantics.componentName);
+    const dir = path28.resolve(input.outDir, semantics.componentName);
     mkdirSync5(dir, { recursive: true });
     const files = {
       // Bundle-local tokens: THE emission the component's CSS resolves
@@ -15096,13 +15855,13 @@ async function runGenerationPipeline(input) {
 `
     };
     for (const [name, content] of Object.entries(files)) {
-      const filePath = path27.join(dir, name);
+      const filePath = path28.join(dir, name);
       writeFileSync8(filePath, content);
       written.push(filePath);
     }
     for (const artifact of emitTokenArtifacts(input.mapping)) {
-      const filePath = path27.resolve(input.outDir, artifact.path);
-      mkdirSync5(path27.dirname(filePath), { recursive: true });
+      const filePath = path28.resolve(input.outDir, artifact.path);
+      mkdirSync5(path28.dirname(filePath), { recursive: true });
       writeFileSync8(filePath, artifact.content);
       written.push(filePath);
     }
@@ -15161,7 +15920,7 @@ var GENERATE_DESCRIPTION = {
 function resolveProvidedSource(flags, contextFile) {
   let raw;
   try {
-    raw = readFileSync17(contextFile, "utf8");
+    raw = readFileSync18(contextFile, "utf8");
   } catch {
     fail(flags, ExitCode.InputValidation, {
       error: `Cannot read context file "${contextFile}".`,
@@ -15281,11 +16040,11 @@ token mapping (${mapping.flat.length} variables):
   let initialCode;
   let initialSemantics;
   try {
-    if (existsSync21(flags.out)) {
+    if (existsSync22(flags.out)) {
       for (const entry of readdirSync7(flags.out)) {
         const cjPath = `${flags.out}/${entry}/component.json`;
-        if (!existsSync21(cjPath)) continue;
-        const cj = JSON.parse(readFileSync17(cjPath, "utf8"));
+        if (!existsSync22(cjPath)) continue;
+        const cj = JSON.parse(readFileSync18(cjPath, "utf8"));
         if (cj.name !== void 0 && Array.isArray(cj.props)) {
           previousApi = JSON.stringify({
             componentName: cj.name,
@@ -15293,14 +16052,14 @@ token mapping (${mapping.flat.length} variables):
           });
           const tsxPath = `${flags.out}/${entry}/${cj.name}.tsx`;
           const cssPath = `${flags.out}/${entry}/${cj.name}.css`;
-          if (flags.refine && existsSync21(tsxPath) && existsSync21(cssPath)) {
+          if (flags.refine && existsSync22(tsxPath) && existsSync22(cssPath)) {
             initialCode = {
-              tsx: readFileSync17(tsxPath, "utf8"),
-              css: readFileSync17(cssPath, "utf8")
+              tsx: readFileSync18(tsxPath, "utf8"),
+              css: readFileSync18(cssPath, "utf8")
             };
             const semPath = `${flags.out}/${entry}/semantics.json`;
-            if (existsSync21(semPath)) {
-              initialSemantics = JSON.parse(readFileSync17(semPath, "utf8"));
+            if (existsSync22(semPath)) {
+              initialSemantics = JSON.parse(readFileSync18(semPath, "utf8"));
             }
           }
           break;