@tendrilapp/cli 0.1.15 → 0.1.17

package/dist/SKILL.md

@@ -164,11 +164,24 @@ Non-negotiables (the CLI enforces these; do not fight them):
 6. Tell the user roughly what a run costs them: organism-scale
    components have measured 0.3–0.7M tokens of their plan.
 
-Delegated generation is SLOW BY NATURE — measured runs take 3–16
-minutes, and the one fully successful generator run did not write its
-first file until 14m24s. Do not treat silence as failure. Tell the
-user up front that a generator agent typically runs 5–15 minutes, and
-poll the candidate directory rather than guessing.
+Delegated generation is SLOW BY NATURE — measured runs span 3–23
+minutes (run 8: two healthy runs at ~23m each). Do not treat silence
+as failure. Tell the user up front that a generator agent typically
+runs 10–25 minutes, and poll the candidate directory rather than
+guessing.
+
+ESCALATION (when the balanced model plateaus below the bar): ask the
+user before spending the premium tier; point the second generator at
+the SAME candidate directory (never a fresh start — the work is
+sunk); hand it a calibration table of failing vs passing configs and
+the exact fields; never pass rebind. TRAP (measured, run 8): the
+nearest PASSING config is not a safe regression tripwire — it may
+carry the same defect and pass by luck (one config passed its bar by
+0.00089 while carrying the identical corner defect as the three
+failures). An edit whose exact fields do not move across a round did
+NOTHING: revert it before the next round — bundles must never
+accumulate unsupported edits a later reader mistakes for recorded
+truth.
 
 Stop a generator agent only on evidence of the real failure mode:
 reasoning runaway, where a turn ends on max_tokens having emitted a

package/dist/tendril-mcp.js

@@ -368,7 +368,7 @@ var UPDATE_PROMPT = {
     "1. The MCP server updates ITSELF automatically at session start (npx @latest) \u2014 nothing to do for the pipeline.",
     "2. If a global CLI is installed: `npm install -g @tendrilapp/cli@latest`.",
     "3. If tendril_doctor reported the SERVER version stale this session: `npm cache clean --force`, then the user restarts the session so npx re-resolves @latest.",
-    "4. The optional plugin is a thin shim (triggers, agents, commands) that rarely changes \u2014 usually nothing to do. When a plugin update IS announced (third-party marketplaces do not reliably auto-update): terminal Claude Code \u2014 `claude plugin marketplace update tendrilapp` FIRST (the update command compares against a cached clone and can falsely report already-latest), then `claude plugin update tendril`, then /reload-plugins; VS Code extension \u2014 the /plugins panel has no update button: uninstall tendril, reinstall from the marketplace, reopen the chat panel; Claude Desktop \u2014 no plugin management: quit and relaunch. Every critical surface already updated in step 1 regardless.",
+    "4. The optional plugin is a thin shim (triggers, agents, commands) that rarely changes \u2014 usually nothing to do. When a plugin update IS announced (third-party marketplaces do not reliably auto-update): terminal Claude Code \u2014 `claude plugin marketplace update tendrilapp` FIRST (the update command compares against a cached clone and can falsely report already-latest), then `claude plugin update tendril`, then /reload-plugins; VS Code extension \u2014 the /plugins panel has no update button: Marketplaces tab \u2192 REFRESH tendrilapp FIRST (a stale marketplace clone makes reinstall reinstall the old version \u2014 measured), then Plugins tab \u2192 uninstall tendril, reinstall, reopen the chat panel; if the refresh doesn't take, remove and re-add the marketplace. Claude Desktop \u2014 no plugin management: quit and relaunch. Every critical surface already updated in step 1 regardless.",
     "5. Confirm by running tendril_doctor and reporting its version line. Never claim success without that confirmation."
   ].join("\n")
 };

package/dist/tendril.js

@@ -1974,8 +1974,9 @@ async function runTokenLint(css, fileLabel = "generated.css", definedVars2) {
     codeFilename: fileLabel,
     config: STYLELINT_CONFIG
   });
+  const mapKnownEmpty = definedVars2 !== void 0 && definedVars2.size === 0;
   const violations = result.results.flatMap(
-    (r) => r.warnings.map((w) => ({
+    (r) => r.warnings.filter((w) => !(mapKnownEmpty && w.rule === "scale-unlimited/declaration-strict-value")).map((w) => ({
       file: fileLabel,
       line: w.line,
       property: w.rule,
@@ -2332,6 +2333,23 @@ function detectBackdrop(png, opts = {}) {
   const { modal, consensus } = ringConsensus(png);
   if (consensus < 0.9) return [255, 255, 255];
   if (Math.min(...modal) < 200 && opts.trustDark !== true) return [255, 255, 255];
+  const decoded = PNG.sync.read(Buffer.from(png));
+  if (decoded.width >= 4 && decoded.height >= 4) {
+    const blocks = cornerBlocks(decoded, 2);
+    const first = blocks[0];
+    const cornersAgree = blocks.every((c) => Math.abs(c[0] - first[0]) + Math.abs(c[1] - first[1]) + Math.abs(c[2] - first[2]) <= INK_DELTA);
+    const cornersDisagreeWithRing = Math.abs(first[0] - modal[0]) + Math.abs(first[1] - modal[1]) + Math.abs(first[2] - modal[2]) > INK_DELTA;
+    if (cornersAgree && cornersDisagreeWithRing) {
+      const extremes = cornerBlocks(decoded, 1);
+      const value = [
+        Math.round(extremes.reduce((a, c) => a + c[0], 0) / 4),
+        Math.round(extremes.reduce((a, c) => a + c[1], 0) / 4),
+        Math.round(extremes.reduce((a, c) => a + c[2], 0) / 4)
+      ];
+      if (Math.min(...value) < 200 && opts.trustDark !== true) return [255, 255, 255];
+      return value;
+    }
+  }
   return modal;
 }
 function pngDimensions(png) {
@@ -2375,6 +2393,111 @@ function cornersMatchCanvas(ref, canvas) {
     (c) => Math.abs(c[0] - canvas[0]) + Math.abs(c[1] - canvas[1]) + Math.abs(c[2] - canvas[2]) <= INK_DELTA
   );
 }
+function absentInkClusters(render, reference, background = [255, 255, 255]) {
+  const a = PNG.sync.read(Buffer.from(render));
+  const b = PNG.sync.read(Buffer.from(reference));
+  const width = Math.max(a.width, b.width);
+  const height = Math.max(a.height, b.height);
+  const canvasA = onCanvas(a, width, height);
+  const canvasB = onCanvas(b, width, height);
+  const ring = ringModal(canvasB);
+  const backgrounds = channelDistance(ring, background) > INK_DELTA ? [background, ring] : [background];
+  const found = [];
+  for (const bg of backgrounds) {
+    const renderInk = new Uint8Array(width * height);
+    for (let y = 0; y < height; y++) {
+      for (let x = 0; x < width; x++) {
+        if (isInk(canvasA.data, (width * y + x) * 4, bg)) renderInk[width * y + x] = 1;
+      }
+    }
+    const candidate = new Uint8Array(width * height);
+    for (let y = 0; y < height; y++) {
+      for (let x = 0; x < width; x++) {
+        if (!isInk(canvasB.data, (width * y + x) * 4, bg)) continue;
+        let covered = false;
+        scan: for (let dy = -ABSENT_RADIUS; dy <= ABSENT_RADIUS; dy++) {
+          for (let dx = -ABSENT_RADIUS; dx <= ABSENT_RADIUS; dx++) {
+            const nx = x + dx;
+            const ny = y + dy;
+            if (nx < 0 || ny < 0 || nx >= width || ny >= height) continue;
+            if (renderInk[width * ny + nx] === 1) {
+              covered = true;
+              break scan;
+            }
+          }
+        }
+        if (!covered) candidate[width * y + x] = 1;
+      }
+    }
+    const seen = new Uint8Array(width * height);
+    for (let sy = 0; sy < height; sy++) {
+      for (let sx = 0; sx < width; sx++) {
+        const si = width * sy + sx;
+        if (candidate[si] !== 1 || seen[si] === 1) continue;
+        let x0 = sx;
+        let y0 = sy;
+        let x1 = sx;
+        let y1 = sy;
+        let px = 0;
+        const stack = [si];
+        seen[si] = 1;
+        while (stack.length > 0) {
+          const i = stack.pop();
+          const cx = i % width;
+          const cy = (i - cx) / width;
+          px += 1;
+          if (cx < x0) x0 = cx;
+          if (cy < y0) y0 = cy;
+          if (cx > x1) x1 = cx;
+          if (cy > y1) y1 = cy;
+          for (let dy = -1; dy <= 1; dy++) {
+            for (let dx = -1; dx <= 1; dx++) {
+              const nx = cx + dx;
+              const ny = cy + dy;
+              if (nx < 0 || ny < 0 || nx >= width || ny >= height) continue;
+              const ni = width * ny + nx;
+              if (candidate[ni] === 1 && seen[ni] === 0) {
+                seen[ni] = 1;
+                stack.push(ni);
+              }
+            }
+          }
+        }
+        if (px >= ABSENT_MIN_PX) found.push({ x: x0, y: y0, w: x1 - x0 + 1, h: y1 - y0 + 1, px, memberX: sx, memberY: sy });
+      }
+    }
+  }
+  const merged = [];
+  for (const c of found.sort((c1, c2) => c2.px - c1.px)) {
+    const overlaps = merged.some((m) => c.x < m.x + m.w && m.x < c.x + c.w && c.y < m.y + m.h && m.y < c.y + c.h);
+    if (!overlaps) merged.push(c);
+  }
+  return merged;
+}
+function zoomCrop(png, rect, scale = 8, pad = 6) {
+  const src = PNG.sync.read(Buffer.from(png));
+  const x0 = Math.max(0, rect.x - pad);
+  const y0 = Math.max(0, rect.y - pad);
+  const x1 = Math.min(src.width, rect.x + rect.w + pad);
+  const y1 = Math.min(src.height, rect.y + rect.h + pad);
+  const w = Math.max(1, x1 - x0);
+  const h = Math.max(1, y1 - y0);
+  const out = new PNG({ width: w * scale, height: h * scale });
+  for (let y = 0; y < h * scale; y++) {
+    for (let x = 0; x < w * scale; x++) {
+      const sx = x0 + Math.floor(x / scale);
+      const sy = y0 + Math.floor(y / scale);
+      const si = (src.width * sy + sx) * 4;
+      const di = (out.width * y + x) * 4;
+      const alpha = src.data[si + 3] ?? 0;
+      out.data[di] = Math.round(((src.data[si] ?? 0) * alpha + 255 * (255 - alpha)) / 255);
+      out.data[di + 1] = Math.round(((src.data[si + 1] ?? 0) * alpha + 255 * (255 - alpha)) / 255);
+      out.data[di + 2] = Math.round(((src.data[si + 2] ?? 0) * alpha + 255 * (255 - alpha)) / 255);
+      out.data[di + 3] = 255;
+    }
+  }
+  return Uint8Array.from(PNG.sync.write(out));
+}
 function measureCanvasCoupling(ref, renderA, renderB, backdrop, box) {
   const rRaw = PNG.sync.read(Buffer.from(ref));
   const r = onCanvas(rRaw, rRaw.width, rRaw.height);
@@ -2589,11 +2712,13 @@ function cropPng(png, x, y, width, height) {
   }
   return new Uint8Array(PNG.sync.write(out));
 }
-var INK_DELTA;
+var INK_DELTA, ABSENT_RADIUS, ABSENT_MIN_PX;
 var init_image_diff = __esm({
   "packages/verify/src/image-diff.ts"() {
     "use strict";
     INK_DELTA = 30;
+    ABSENT_RADIUS = 3;
+    ABSENT_MIN_PX = 6;
   }
 });
 
@@ -4198,6 +4323,31 @@ function chooseSeat(cropAt, ref, padW, padH, backdrop, origin, extents) {
   }
   return { comparison, seat, scored: cropAt(origin - seat.x, origin - seat.y) };
 }
+function deepestNodeNameAt(set, rep, px, py) {
+  let root;
+  try {
+    const text = JSON.parse(readFileSync8(path15.join(set, rep, "get_metadata.json"), "utf8")).content.map((c) => c.text ?? "").join("\n");
+    root = parseMetadataStructure(text);
+  } catch {
+    return void 0;
+  }
+  let best;
+  const walk2 = (node, ox, oy, isRoot) => {
+    if (node.hidden === true) return;
+    const nx = isRoot ? 0 : ox + (node.x ?? 0);
+    const ny = isRoot ? 0 : oy + (node.y ?? 0);
+    const w = node.width ?? 0;
+    const h = node.height ?? 0;
+    const contains = px >= nx && py >= ny && px < nx + w && py < ny + h;
+    if (contains && !isRoot && node.name !== "") {
+      const area = w * h;
+      if (best === void 0 || area <= best.area) best = { name: `${node.name} (${node.id})`, area };
+    }
+    for (const child of node.children) walk2(child, nx, ny, false);
+  };
+  walk2(root, 0, 0, true);
+  return best?.name;
+}
 function repMeta(set, rep) {
   const text = JSON.parse(readFileSync8(path15.join(set, rep, "get_metadata.json"), "utf8")).content.map((c) => c.text ?? "").join("\n");
   const root = parseMetadataStructure(text);
@@ -4318,10 +4468,18 @@ body{margin:0;background:rgb(${backdrop.join(",")})}
           const slab = realPadBoth && coupling.padCorners.masked >= 8 && coupling.padCorners.opaque / coupling.padCorners.masked >= 0.9;
           const pass = r.similarity >= bar.sim && r.inkRecall >= bar.ink && !slab;
           const region = pass ? void 0 : localizeDifference(scored, ref);
+          const absent = absentInkClusters(scored, ref, backdrop).map((c) => {
+            const name = deepestNodeNameAt(task.set, cfg.rep, c.memberX - seat.x, c.memberY - seat.y);
+            return name === void 0 ? c : { ...c, name };
+          });
           if (opts.evidenceDir !== void 0) {
             writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-render.png`), scored);
             writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-ref.png`), ref);
             writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-diff.png`), diffPng(scored, ref));
+            for (const [i, c] of absent.slice(0, 3).entries()) {
+              writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-absent-${i}-ref.png`), zoomCrop(ref, c));
+              writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-absent-${i}-render.png`), zoomCrop(scored, c));
+            }
           }
           return {
             rep: cfg.rep,
@@ -4332,6 +4490,7 @@ body{margin:0;background:rgb(${backdrop.join(",")})}
             ...slab ? { error: `paints the page canvas to the pad corners (${coupling.padCorners.opaque}/${coupling.padCorners.masked} opaque) \u2014 a square slab carrying the recorded canvas past the frame, wrong on any real page` } : {},
             ...region === void 0 ? {} : { region: { x0: region.x0, y0: region.y0, x1: region.x1, y1: region.y1, density: Math.round(region.density * 100) / 100 } },
             ...seat.x === 0 && seat.y === 0 ? {} : { seat },
+            ...absent.length > 0 ? { absentInk: absent } : {},
             ...coupling.padMasked + coupling.inBoxMasked > 0 ? { canvasCoupling: coupling } : {}
           };
         } finally {
@@ -7616,8 +7775,8 @@ function authorComponentApi(opts) {
     configs.push({ rep: p.slug, component: componentIdent, props: {} });
   }
   if (inexpressible.length > 0) throw new PoseCompletenessError(inexpressible);
-  if (opts.dismissible === true) {
-    props.push({ name: "onDismiss", kind: "callback" });
+  if (opts.dismissible !== void 0) {
+    props.push({ name: "onDismiss", kind: "callback", default: opts.dismissible });
   }
   const entry = `${componentIdent}.tsx`;
   const apiPin = {
@@ -7626,13 +7785,15 @@ function authorComponentApi(opts) {
       name: pr.name,
       type: pr.kind === "boolean" ? "boolean" : pr.kind === "string" ? "string" : pr.kind === "callback" ? "() => void" : pr.values.map((v) => `"${v}"`).join(" | "),
       required: false,
-      ...pr.default !== void 0 ? { default: pr.default } : {}
+      // 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 } : {}
     })),
     forcedStates,
     poseCompleteness: { recordedPoses: opts.poses.length, expressible: configs.length }
   };
   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 fires on 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.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 ?? [];
@@ -7705,7 +7866,7 @@ function authorBehaviors(api, extras = {}) {
     behaviors.push({
       id: `content-prop-renders(${sentinel.prop})`,
       config: sentinel.config,
-      props: { [sentinel.prop]: marker },
+      props: { ...sentinel.props ?? {}, [sentinel.prop]: marker },
       steps: [{ assertTextVisible: marker }]
     });
   }
@@ -7823,7 +7984,7 @@ function recordedTextSlots(setDir, repSlugs) {
       if (t === "" || !/[A-Za-z0-9]/.test(t)) continue;
       texts.push(t);
     }
-    perRep.push({ slug, texts });
+    perRep.push({ slug, texts, code });
   }
   const axisValuesBySlug = /* @__PURE__ */ new Map();
   for (const slug of repSlugs) {
@@ -7866,7 +8027,9 @@ function recordedTextSlots(setDir, repSlugs) {
         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);
-      return { prop: name, default: def, overrides, varies: Object.keys(overrides).length > 0, visibleIn };
+      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 };
     });
   }
   if (perRep.length === 0) return [];
@@ -7913,7 +8076,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()] };
+    return { prop, default: def, overrides, varies: Object.keys(overrides).length > 0, visibleIn: [...sl.values.keys()], referencedIn: [] };
   });
 }
 function authorTaskFromSet(setDir, opts = {}) {
@@ -7954,12 +8117,29 @@ function authorTaskFromSet(setDir, opts = {}) {
     ...recordedFonts.length > 0 ? { recordedFonts } : {},
     ...Object.keys(defaults).length > 0 ? { defaults } : {},
     ...textSlots.length > 0 ? { textSlots } : {},
-    ...dismissName !== void 0 ? { dismissible: true } : {}
+    ...dismissName !== void 0 ? { dismissible: dismissName } : {}
   });
   const anchorSlug = api.configs.find((c) => Object.keys(c.props).length === 0)?.rep ?? api.configs[0]?.rep;
-  const sentinels = textSlots.filter((slot) => !slot.varies && slot.visibleIn.length > 0).map((slot) => {
+  const sentinels = textSlots.filter((slot) => !slot.varies).map((slot) => {
     const authored = api.props.find((pr) => pr.kind === "string" && pr.default === slot.default);
-    return authored === void 0 ? void 0 : { prop: authored.name, config: anchorSlug !== void 0 && slot.visibleIn.includes(anchorSlug) ? anchorSlug : slot.visibleIn[0] };
+    if (authored === void 0) return void 0;
+    if (slot.visibleIn.length > 0) {
+      const entry = {
+        prop: authored.name,
+        config: anchorSlug !== void 0 && slot.visibleIn.includes(anchorSlug) ? anchorSlug : slot.visibleIn[0]
+      };
+      return entry;
+    }
+    if (slot.referencedIn.length > 0) {
+      const toggle = api.props.find(
+        (pr) => pr.kind === "boolean" && authored.name.toLowerCase().startsWith(pr.name.toLowerCase()) && authored.name.length > pr.name.length
+      );
+      if (toggle !== void 0 && anchorSlug !== void 0) {
+        const entry = { prop: authored.name, config: anchorSlug, props: { [toggle.name]: true } };
+        return entry;
+      }
+    }
+    return void 0;
   }).filter((x) => x !== void 0);
   const { behaviors, prelude, disclosures } = authorBehaviors(api, { ...sentinels.length > 0 ? { sentinels } : {} });
   if (dismissName !== void 0) {
@@ -7970,10 +8150,15 @@ function authorTaskFromSet(setDir, opts = {}) {
   }
   for (const slot of textSlots) {
     if (slot.varies) continue;
-    if (slot.visibleIn.length > 0) {
+    const sentineled = sentinels.some((sn) => api.props.some((pr) => pr.name === sn.prop && pr.default === slot.default));
+    if (sentineled) {
       disclosures.push(
         `constant content prop (recorded ${JSON.stringify(slot.default)}) is sentinel-checked: a behavior mounts it with a sentinel string and asserts it renders \u2014 hardcoding the recorded literal fails that check`
       );
+    } else if (slot.referencedIn.length > 0) {
+      disclosures.push(
+        `content prop (recorded ${JSON.stringify(slot.default)}) is rendered by REFERENCE in the emission but has no visibility evidence and no boolean toggle to reveal it \u2014 sentinel skipped (it could fail honest components whose pose hides the node); wire the prop anyway`
+      );
     } else {
       disclosures.push(
         `content prop from recorded text is UNEXERCISED AND UNRENDERED: NO recorded pose visibly renders ${JSON.stringify(slot.default)} (hidden node) \u2014 prescribed for completeness; wire it behind its visibility toggle; no sentinel can honestly run`
@@ -8009,6 +8194,7 @@ OVERLAYS GO IN THE TOP LAYER, NOT ON A Z-INDEX. The prelude requires isolation:
 
 PAINT & PLATFORM TRAPS (each measured on a paid run; every one passed typecheck, token lint, and all behaviour checks and was caught only by pixels or by use):
 - A composite custom property resolves on the element that DECLARES it. A composite token (e.g. --ring: 0 0 0 var(--w) var(--c)) may only reference variables declared at or above its own declaration site \u2014 declared higher while its parts are set on the component, it is invalid-at-computed-value-time and the property silently computes to nothing (measured: a hover ring vanished; three configs at ~0.78).
+- An <svg> inside an absolutely-positioned glyph layer defaults to display: inline \u2014 it seats on a text baseline, its painted content lands BELOW the box the layout allocated, and an overflow: hidden ancestor clips the displaced ink away entirely. Large glyphs survive; small marks (a 2px dot, a 1.5px stem) vanish while every geometry probe reports the boxes correct (measured: 12/16 configs shipped icons missing their inner marks, certified at ink 0.9995). Set display: block on every glyph svg.
 - Chrome pixel-snaps an <svg> root's paint offset. A fractional inset on an svg element floors to a whole pixel and moves a hairline a full pixel; express fractional placement as transform: scale() about an integer-origin frame (measured: 0.943 \u2192 1.000 on six configs).
 - Pre-composite translucent values over the ACTUAL parent surface, read off the reference pixels \u2014 a control sitting on an elevated surface composites against that surface, not against the page.
 - A native <dialog> carries user-agent padding: 1em. Override every side, or the root grows past its recorded box and every band inside shifts.
@@ -8378,7 +8564,7 @@ function statusOf(s) {
   return tierOf(s, BARS.cert);
 }
 function emitBundleV1(opts) {
-  const statuses = opts.scores.map((s) => ({ rep: s.rep, similarity: s.similarity, inkRecall: s.inkRecall, status: statusOf(s) }));
+  const statuses = opts.scores.map((s) => ({ rep: s.rep, similarity: s.similarity, inkRecall: s.inkRecall, ...s.exact !== void 0 ? { exact: s.exact } : {}, status: statusOf(s) }));
   const certified = statuses.filter((s) => s.status === "certified").length;
   const pass = statuses.filter((s) => s.status !== "fail").length;
   const lattice = countLatticeSymbols(opts.task.set);
@@ -8837,9 +9023,15 @@ async function runVerify(opts) {
   const statuses = [
     ...scores.map((s) => {
       const { exact: _exact, ...reported } = s;
-      const base = { ...reported, status: tierOf(s, BARS2.cert) };
+      let status = tierOf(s, BARS2.cert);
+      const certDemote = [];
+      if (status === "certified" && s.absentInk !== void 0 && s.absentInk.length > 0) {
+        status = "pass";
+        certDemote.push(...s.absentInk.map((c) => `absent ink: ${c.name ?? "unnamed region"} \u2014 ${c.px}px of recorded ink with no render ink within reach (missing or invisible feature)`));
+      }
+      const base = certDemote.length > 0 ? { ...reported, status, demotedBy: certDemote } : { ...reported, status };
       const reasons = demotions.get(s.rep);
-      return reasons === void 0 ? base : { ...base, status: "fail", demotedBy: reasons };
+      return reasons === void 0 ? base : { ...base, status: "fail", demotedBy: [...certDemote.length > 0 ? certDemote : [], ...reasons] };
     }),
     // ADR-010 §2 anti-gaming: recorded configs the adapter does not map
     // are FAILs, never silently absent.
@@ -9041,12 +9233,12 @@ function resolveEngineTask(opts, callerCwd) {
   const asPath = path32.resolve(callerCwd, opts.taskOrSet);
   const isSet = existsSync26(path32.join(asPath, "recording-set.json"));
   const registry = TASKS[opts.taskOrSet];
-  if (registry !== void 0 && !isSet) return { task: registry, name: opts.taskOrSet };
+  if (registry !== void 0 && !isSet) return { task: registry, name: opts.taskOrSet, disclosures: [] };
   if (isSet) {
     try {
       const authored = authorTaskFromSet(asPath);
       for (const d of authored.disclosures) warn(opts, d);
-      return { task: authored.task, name: path32.basename(asPath), apiPin: { props: authored.api.apiPin.props, forcedStates: authored.api.apiPin.forcedStates } };
+      return { task: authored.task, name: path32.basename(asPath), disclosures: authored.disclosures, 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)}`,
@@ -9064,9 +9256,13 @@ function resolveEngineTask(opts, callerCwd) {
 function runEngineBrief(opts) {
   requireEntitlement(opts);
   const callerCwd = process.env["INIT_CWD"] ?? process.cwd();
-  const { task, name } = resolveEngineTask(opts, callerCwd);
+  const { task, name, disclosures } = resolveEngineTask(opts, callerCwd);
   const bar = BARS3[opts.bar];
-  const brief = buildBrief(task.systemApi, bar, { colorScheme: recordingIsDark(task) ? "dark" : "light" });
+  const disclosureBlock = disclosures.length > 0 ? `
+
+=== RECORDED-SET DISCLOSURES (facts about this task's coverage \u2014 read them) ===
+${disclosures.map((d) => `- ${d}`).join("\n")}` : "";
+  const brief = buildBrief(task.systemApi, bar, { colorScheme: recordingIsDark(task) ? "dark" : "light" }) + disclosureBlock;
   const segments = buildSegments(task, "files");
   let notRecorded;
   const manifestPath2 = path32.join(task.set, "recording-set.json");
@@ -9206,9 +9402,14 @@ ${[
   const allPass = obj[0] === total && total > 0;
   const certBar = BARS3["cert"];
   const parityDemoted = new Set(parity.filter((p) => !p.pass).map((p) => p.id.replace(/^parity:/, "")));
-  const certifiedReps = scores.filter((sc) => tierOf(sc, certBar) === "certified" && !parityDemoted.has(sc.rep)).map((sc) => sc.rep);
+  const certifiedReps = scores.filter((sc) => tierOf(sc, certBar) === "certified" && !parityDemoted.has(sc.rep) && (sc.absentInk === void 0 || sc.absentInk.length === 0)).map((sc) => sc.rep);
   const certifiedSet = new Set(certifiedReps);
-  const certificationFeedback = `
+  const absentFindings = scores.flatMap((sc) => (sc.absentInk ?? []).map((c) => `- ${sc.rep}: ${c.name ?? "unnamed region"} \u2014 ${c.px}px of recorded ink with NO render ink within reach at [x ${c.x}-${c.x + c.w}, y ${c.y}-${c.y + c.h}] (missing or invisible feature; magnified crops in the evidence dir; coordinates are reference-space \u2014 subtract the config's seat for box-space). A certified-tier config with such a finding is demoted to pass.`));
+  const absentBlock = absentFindings.length > 0 ? `
+
+MISSING FEATURES (absent-ink clusters \u2014 recorded ink your render leaves nowhere near covered; fix these first, the global numbers cannot see them):
+${absentFindings.join("\n")}` : "";
+  const certificationFeedback = `${absentBlock}
 
 CERTIFICATION: ${certifiedReps.length}/${scores.length} configs at the certification bar (sim \u2265${certBar.sim} AND ink \u2265${certBar.ink}, exact values, after parity demotion \u2014 composition checks at verify can demote further).${certifiedReps.length < scores.length ? ` Below cert: ${scores.filter((sc) => !certifiedSet.has(sc.rep)).map((sc) => sc.rep).join(", ")}.` : ""}
 METRIC DEADBAND (read before iterating on near-misses): the scored similarity/ink deliberately tolerate \xB11px edge shift and antialiased-edge differences \u2014 cross-rasterizer noise absorption. A change entirely inside that band moves these numbers by EXACTLY ZERO (working as designed, not a stuck scorer). The per-config \`exact\` fields in the JSON are tolerance-free and move first: compare exact across rounds to confirm a small fix landed, and stop iterating when only exact moves \u2014 the bar reads the tolerant numbers.`;
@@ -9243,7 +9444,7 @@ METRIC DEADBAND (read before iterating on near-misses): the scored similarity/in
       bundleManifest: emitted.written[0],
       note: "styles.css was stamped with the bundle provenance comment on line 1 \u2014 preserve it in any post-score edit",
       allPass,
-      certification: { certified: certifiedReps.length, total: scores.length, bar: certBar, note: "tierOf on exact values + parity demotion; verify's composition checks can demote further" }
+      certification: { certified: certifiedReps.length, total: scores.length, bar: certBar, note: "tierOf on exact values + parity and absent-ink demotion; verify's composition checks can demote further" }
     },
     () => {
       for (const s of scores) process.stdout.write(`${s.pass ? certifiedSet.has(s.rep) ? "CERT" : "PASS" : "FAIL"} ${s.rep}: sim=${s.similarity} ink=${s.inkRecall}${s.error !== void 0 ? ` [${s.error}]` : ""}
@@ -9864,7 +10065,7 @@ async function runDoctorChecks(options) {
             name: "plugin-skew",
             ok: false,
             detail: `Claude Code plugin cache holds v${newest} while this CLI is ${cliVersion()} \u2014 the plugin's skill/agents are STALE and will silently shadow current doctrine`,
-            remediation: "Update the plugin: terminal Claude Code \u2014 `claude plugin marketplace update tendrilapp` then `claude plugin update tendril`; VS Code extension \u2014 /plugins panel: uninstall tendril, reinstall, reopen the chat panel."
+            remediation: "Update the plugin \u2014 REFRESH THE MARKETPLACE FIRST (its local clone goes stale and a reinstall faithfully reinstalls the old version): terminal Claude Code \u2014 `claude plugin marketplace update tendrilapp` then `claude plugin update tendril`; VS Code extension \u2014 /plugins panel \u2192 Marketplaces tab \u2192 refresh tendrilapp, THEN Plugins tab \u2192 uninstall + reinstall tendril, reopen the chat panel. If the refresh doesn't take, remove the tendrilapp marketplace entirely and re-add TendrilApp/claude-plugin (a fresh clone cannot be stale)."
           } : { name: "plugin-skew", ok: true, detail: `Claude Code plugin v${newest} matches this CLI` }
         );
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tendrilapp/cli",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Figma design systems → verified React components. CLI ruler + MCP server.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",