@tendrilapp/cli 0.1.15 → 0.1.16

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

@@ -2332,6 +2332,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) {
@@ -7616,8 +7633,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 +7643,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 +7724,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 +7842,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 +7885,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 +7934,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 +7975,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 +8008,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`
@@ -8378,7 +8421,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);
@@ -9864,7 +9907,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.16",
   "description": "Figma design systems → verified React components. CLI ruler + MCP server.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",