@tendrilapp/cli 0.1.46 → 0.1.48

package/dist/tendril.js

@@ -842,9 +842,12 @@ import { existsSync } from "node:fs";
 import path from "node:path";
 import { z as z4 } from "zod";
 function resolveRepEnvelopePath(setDir, slug, kind) {
-  const mcp = path.join(setDir, slug, kind === "metadata" ? "get_metadata.json" : "get_screenshot.json");
+  return resolveRepEnvelopePathIn(path.join(setDir, slug), kind);
+}
+function resolveRepEnvelopePathIn(repDir, kind) {
+  const mcp = path.join(repDir, kind === "metadata" ? "get_metadata.json" : "get_screenshot.json");
   if (existsSync(mcp)) return mcp;
-  const rest = path.join(setDir, slug, kind === "metadata" ? REST_METADATA_FILE : REST_SCREENSHOT_FILE);
+  const rest = path.join(repDir, kind === "metadata" ? REST_METADATA_FILE : REST_SCREENSHOT_FILE);
   return existsSync(rest) ? rest : mcp;
 }
 function repEnvelopeExists(setDir, slug, kind) {
@@ -1670,7 +1673,7 @@ function effectivelyInvisible(node) {
   return false;
 }
 function repVisibility(setDir, slug) {
-  const file = path3.join(setDir, slug, "get_metadata.json");
+  const file = resolveRepEnvelopePathIn(path3.join(setDir, slug), "metadata");
   if (!existsSync3(file)) return void 0;
   let roots;
   try {
@@ -1721,6 +1724,7 @@ var init_visibility = __esm({
   "packages/figma/src/recording/visibility.ts"() {
     "use strict";
     init_normalize();
+    init_rest_envelopes();
     init_session();
     normalizedLayerName = (name) => name.toLowerCase().replace(/[^a-z0-9]/g, "");
     invisibleInEveryPose = (v) => v.presentIn.length > 0 && v.visibleIn.length === 0;
@@ -1778,7 +1782,7 @@ function buildComposeIndex(roots, depth = 3) {
     for (const rep of manifest.reps) {
       variantNodeIds.add(rep.nodeId);
       repSlugByVariantNode.set(rep.nodeId, rep.slug);
-      const metaFile = path4.join(dir, rep.slug, "get_metadata.json");
+      const metaFile = resolveRepEnvelopePathIn(path4.join(dir, rep.slug), "metadata");
       if (!existsSync4(metaFile)) continue;
       try {
         const text = envelopeTextContent(JSON.parse(readFileSync3(metaFile, "utf8")));
@@ -1838,7 +1842,7 @@ function emissionTails(setDir, repSlug) {
   return byHead;
 }
 function hostInstances(setDir, repSlug) {
-  const metaFile = path4.join(setDir, repSlug, "get_metadata.json");
+  const metaFile = resolveRepEnvelopePathIn(path4.join(setDir, repSlug), "metadata");
   if (!existsSync4(metaFile)) return [];
   try {
     const text = envelopeTextContent(JSON.parse(readFileSync3(metaFile, "utf8")));
@@ -2117,6 +2121,7 @@ var init_compose = __esm({
   "packages/figma/src/recording/compose.ts"() {
     "use strict";
     init_session();
+    init_rest_envelopes();
     init_normalize();
     init_visibility();
     CompositionEntrySchema = z6.object({
@@ -9188,7 +9193,12 @@ function figmaRestCheck() {
     return {
       name: "figma-rest",
       ok: true,
-      detail: `Figma is not connected for REST recording \u2014 large component sets then pay the MCP daily call quota. Run ${tendrilCommand("figma-connect")} and click Allow once (agents: the tendril_figma_connect tool).`
+      // ok stays true — recording works without it — but the field
+      // taught that agents scan flags, not prose: the how-to rides the
+      // remediation channel so a not-connected machine is never a
+      // silently green row (first Windows channel run, 2026-08-26).
+      detail: "Figma is not connected for REST recording on this machine \u2014 large component sets then pay the MCP daily call quota (informational; recording still works)",
+      remediation: `Connect once and the quota problem disappears for pixels+geometry: ${tendrilCommand("figma-connect")}, one Allow click in the browser (agents: tendril_figma_connect, relay the link, then tendril_figma_connect_wait).`
     };
   }
   const daysLeft = Math.floor((Date.parse(tokens.tokenExpiresAt) - Date.now()) / 864e5);
@@ -11626,7 +11636,8 @@ var init_brief = __esm({
 import { existsSync as existsSync29, readFileSync as readFileSync26, readdirSync as readdirSync10 } from "node:fs";
 import path36 from "node:path";
 function repText(set, rep, tool) {
-  const env = JSON.parse(readFileSync26(path36.join(set, rep, `${tool}.json`), "utf8"));
+  const file = tool === "get_metadata" ? resolveRepEnvelopePath(set, rep, "metadata") : tool === "get_screenshot" ? resolveRepEnvelopePath(set, rep, "screenshot") : path36.join(set, rep, `${tool}.json`);
+  const env = JSON.parse(readFileSync26(file, "utf8"));
   return tool === "get_design_context" ? envelopeFirstTextPart(env) : envelopeTextContent(env);
 }
 function refPngDims(set, rep) {
@@ -11786,7 +11797,6 @@ var init_segments = __esm({
   "packages/generate/src/segments.ts"() {
     "use strict";
     init_src();
-    init_src();
     cssIdent = (name) => name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
   }
 });
@@ -14893,7 +14903,10 @@ async function runRecordPlan(opts) {
   const restClause = channeled ? ` REST channel active: ~${restRequests} paced REST request(s) + ${restRepsRemaining} unmetered downloads carry the pixels+geometry \u2014 they spend NO MCP quota.` : "";
   const callSentence = channeled ? `${posesRemaining} pose(s) still need their MCP emission call${setLevelClause} = ${callsNeeded} Figma MCP calls` : posesRemaining === poses ? `${poses} poses \xD7 ${FIGMA_CALLS_PER_REP} calls per pose${setLevelClause} = ${callsNeeded} Figma calls` : `${posesRemaining} poses still to record \xD7 ${FIGMA_CALLS_PER_REP} calls per pose${setLevelClause} = ${callsNeeded} Figma calls (${poses - posesRemaining} of ${poses} already on disk)`;
   const planningSpent = variantScope === "selection" ? poses : 1;
-  const arithmetic = `${callSentence}${channeled ? "." : ` (up to ${posesRemaining * FIGMA_CALLS_PER_REP_WORST + setLevelRemaining} if screenshots or assets need a second fetch).`}${restClause} ALREADY SPENT on planning, and counting against the same allowance: ~${planningSpent} get_metadata call(s)${variantScope === "selection" ? " \u2014 a selection-scoped plan pays one per node handed in, not one for the set" : ""}.`;
+  const connectWouldHelp = channelNote?.reason === "no-credential";
+  const callsIfConnected = posesRemaining + setLevelRemaining + 4;
+  const connectDelta = connectWouldHelp ? ` CONNECT FIGMA AND THIS DROPS TO ~${callsIfConnected}: one Allow click (tendril_figma_connect) puts pixels+geometry on Figma REST \u2014 per-minute paced, no daily cap \u2014 then re-run this exact plan.` : "";
+  const arithmetic = `${callSentence}${channeled ? "." : ` (up to ${posesRemaining * FIGMA_CALLS_PER_REP_WORST + setLevelRemaining} if screenshots or assets need a second fetch).`}${restClause}${connectDelta} ALREADY SPENT on planning, and counting against the same allowance: ~${planningSpent} get_metadata call(s)${variantScope === "selection" ? " \u2014 a selection-scoped plan pays one per node handed in, not one for the set" : ""}.`;
   const multiDay = callsNeeded > MULTI_DAY_CALL_THRESHOLD;
   const feasibilityCheck = {
     arithmetic,
@@ -14906,6 +14919,20 @@ async function runRecordPlan(opts) {
     surface: multiDay ? "This set exceeds every daily allowance we have heard of, so it CANNOT finish in one day. State the verdict to the user in plain numbers BEFORE recording anything and let them choose from `options` \u2014 do not start on the assumption it will fit." : "Say nothing about cost if the division fits inside one day's allowance \u2014 a set that comfortably fits is not worth the user's attention. Surface the verdict and `options` only when it does not fit.",
     verdictTemplate: `${callSentence}. Your <seat> seat on <plan> allows <allowance>/day. This set needs about <days> day(s) at that rate.`,
     options: [
+      // CONNECT FIRST (measured on the first field run of the REST
+      // channel, 2026-08-26): the plan's restChannel note said "not
+      // connected" while these options offered only ways to pay the
+      // full MCP bill — the agent dutifully rendered pace/sample/seat
+      // and never mentioned the one click that removes the problem.
+      // The remedy that dissolves the bill outranks the ones that
+      // ration it, so it is option ONE, present whenever it applies.
+      ...!channeled && connectWouldHelp ? [
+        {
+          id: "connect-figma",
+          decidedBy: "user clicks Allow once in the browser \u2014 and you START it: call tendril_figma_connect, relay the link, tendril_figma_connect_wait",
+          text: `Connect Figma on this machine (read-only, revocable, one Allow click). Pixels+geometry then travel over Figma's REST API \u2014 per-minute paced, NO daily cap \u2014 and this set's MCP bill drops from ${callsNeeded} to ~${callsIfConnected} calls. After the connect completes, RE-RUN THIS EXACT PLAN: the channel is assignable until the first envelope is ingested.`
+        }
+      ] : [],
       {
         id: "pace",
         decidedBy: "user, and you can carry it out",
@@ -14986,11 +15013,15 @@ async function runRecordPlan(opts) {
 `);
           process.stdout.write(`  ask Figma whoami (free \u2014 exempt from tool-call limits) for this seat's daily allowance, divide ${callsNeeded} by it, and say how many DAYS this needs before recording
 `);
-          process.stdout.write(`  (a) pace it across days \u2014 the set persists after every pose, so a rate limit costs waiting, never recorded work
+          if (connectWouldHelp) {
+            process.stdout.write(`  (a) CONNECT FIGMA \u2014 one Allow click (\`${tendrilCommand("figma-connect")}\`) drops this set to ~${callsIfConnected} calls, then re-run this exact plan
+`);
+          }
+          process.stdout.write(`  (${connectWouldHelp ? "b" : "a"}) pace it across days \u2014 the set persists after every pose, so a rate limit costs waiting, never recorded work
 `);
-          process.stdout.write(`  (b) record fewer poses \u2014 YOUR call, not an agent's: delete recording-set.json and re-plan with --sample (buys calls with coverage)
+          process.stdout.write(`  (${connectWouldHelp ? "c" : "b"}) record fewer poses \u2014 YOUR call, not an agent's: delete recording-set.json and re-plan with --sample (buys calls with coverage)
 `);
-          process.stdout.write(`  (c) a seat or plan with a larger daily allowance
+          process.stdout.write(`  (${connectWouldHelp ? "d" : "c"}) a seat or plan with a larger daily allowance
 `);
         } else {
           process.stdout.write(`FEASIBILITY: check ${callsNeeded} against this seat's daily Figma allowance (ask whoami \u2014 it is free) before recording; it only needs raising if it does not fit
@@ -15053,11 +15084,22 @@ async function assignRestChannel(setDir, manifest, resumed) {
     if (anything) return void 0;
   }
   if (current.figmaFile === void 0) {
-    return { active: false, note: "REST channel unavailable: the plan carries no --figma-file key \u2014 pass it (from the design URL) to record pixels+geometry over Figma REST and escape the MCP daily limit" };
+    return {
+      active: false,
+      reason: "no-figma-file",
+      note: "REST channel unavailable: the plan carries no --figma-file key \u2014 pass it (from the design URL) to record pixels+geometry over Figma REST and escape the MCP daily limit"
+    };
   }
   const client = await figmaRestClient();
   if (!client.ok) {
-    return client.kind === "no-credential" ? { active: false, note: client.refusal } : { active: false, note: `REST channel unavailable (${client.kind}): ${client.refusal} \u2014 recording proceeds over MCP` };
+    return client.kind === "no-credential" ? {
+      active: false,
+      reason: "no-credential",
+      // The FIRST FIELD RUN taught this note to instruct, not
+      // mention: the agent rendered the feasibility options and
+      // never offered the connect, because nothing told it to.
+      note: "Figma is not connected on THIS machine, so recording stays on the daily-limited MCP transport. AGENTS: offer the connect NOW, before any recording call \u2014 call tendril_figma_connect, relay the link (the user clicks Allow once), tendril_figma_connect_wait, then RE-RUN THIS EXACT PLAN: the channel stays assignable until the first envelope is ingested, and the bill drops to roughly one call per pose."
+    } : { active: false, reason: client.kind, note: `REST channel unavailable (${client.kind}): ${client.refusal} \u2014 recording proceeds over MCP` };
   }
   const ids = current.reps.map((r) => r.nodeId);
   const docs = {};
@@ -17209,6 +17251,17 @@ function resolveEngineTask(opts, callerCwd) {
   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) {
+    const manifest = loadManifest(asPath);
+    const missing = manifest.reps.filter(
+      (r) => !repEnvelopeExists(asPath, r.slug, "metadata") || !existsSync40(path50.join(asPath, r.slug, "get_design_context.json"))
+    );
+    if (missing.length > 0) {
+      fail(opts, ExitCode.RecordingIncomplete, {
+        error: `recording set ${asPath} is missing envelopes for ${missing.length} rep(s): ${missing.slice(0, 3).map((r) => r.slug).join(", ")}${missing.length > 3 ? ", \u2026" : ""}`,
+        code: "recording-incomplete",
+        remediation: `Resume the recording (\`${tendrilCommand(`record next --set ${asPath}`)}\`) until \`${tendrilCommand(`record status --set ${asPath}`)}\` reports the set complete, then re-run this.`
+      });
+    }
     try {
       const authored = authorTaskFromSet(asPath);
       for (const d of authored.disclosures) warn(opts, d);
@@ -17665,6 +17718,7 @@ var init_engine2 = __esm({
   "packages/cli/src/commands/engine.ts"() {
     "use strict";
     init_src3();
+    init_src();
     init_src7();
     init_src4();
     init_environment();

package/package.json

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