@tendrilapp/cli 0.1.5 → 0.1.6

package/dist/tendril-mcp.js

@@ -66,7 +66,7 @@ var TOOLS = [
   },
   {
     name: "tendril_record_ingest",
-    description: "Ingest a VERBATIM Figma tool-response for a planned rep. PREFER `text`: paste the tool response text exactly as received \u2014 no file to write, no wrapper to build; the CLI constructs the envelope from the same bytes. The response includes `next` (the following instruction \u2014 no separate record_next call) and, for get_design_context, `assets`: the emission's SVG/PNG assets are AUTO-FETCHED server-side; only listed failures need manual record_fetch/record_asset handling.",
+    description: "Ingest a VERBATIM Figma tool-response for a planned rep. PREFER `text` (single block) or `texts` (response split into multiple output blocks \u2014 pass each block verbatim, in order; NEVER hand-join them): no file to write, no wrapper to build; the CLI constructs the envelope from the same bytes. The response includes `next` (the following instruction \u2014 no separate record_next call) and, for get_design_context, `assets`: the emission's SVG/PNG assets are AUTO-FETCHED server-side; only listed failures need manual record_fetch/record_asset handling.",
     schema: z.object({
       setDir: str("recording set directory"),
       rep: str("planned rep slug, or __set__ for the set-level get_variable_defs"),
@@ -76,22 +76,26 @@ var TOOLS = [
       // exit 0). The sink in session.ts now contains the path too — this
       // is the second layer, and it makes the tool self-documenting.
       tool: z.enum(["get_design_context", "get_metadata", "get_screenshot", "get_variable_defs", "get_metadata_interior"]),
-      text: optStr("the tool response text VERBATIM \u2014 exactly as returned, unmodified (preferred; text tools only \u2014 screenshots go through record_fetch)"),
-      file: optStr("path to a saved envelope JSON (alternative to text)")
+      text: optStr("the tool response text VERBATIM \u2014 exactly as returned, unmodified (single-block responses; text tools only \u2014 screenshots go through record_fetch)"),
+      texts: z.array(z.string()).optional().describe("when the response arrived as MULTIPLE output blocks: every block, in order, each verbatim \u2014 never hand-join blocks yourself"),
+      file: optStr("path to a saved envelope JSON (alternative to text/texts)")
     }),
     // The text rides a temp file, never argv: Windows caps a command
     // line at ~32 KB and design-context envelopes routinely exceed it.
     argv: (i) => {
       const base = ["record", "ingest", "--set", i["setDir"], "--rep", i["rep"], "--tool", i["tool"]];
       const text = i["text"];
+      const texts = i["texts"];
       const file = i["file"];
-      if (text === void 0 === (file === void 0)) throw new Error("pass exactly one of `text` (the verbatim response text) or `file` (a saved envelope)");
+      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 = path.join(mkdtempSync(path.join(os.tmpdir(), "tendril-envelope-")), "response.txt");
       if (text !== void 0) {
-        const tmp = path.join(mkdtempSync(path.join(os.tmpdir(), "tendril-envelope-")), "response.txt");
         writeFileSync(tmp, text);
         return [...base, "--file", tmp, "--raw"];
       }
-      return [...base, "--file", file];
+      writeFileSync(tmp, JSON.stringify(texts));
+      return [...base, "--file", tmp, "--raw-parts"];
     }
   },
   {

package/dist/tendril.js

@@ -1008,6 +1008,14 @@ function ingestEnvelope(setDir, slug, tool, payload) {
 `);
   return { overwrote };
 }
+function envelopeTextContent(env) {
+  const parts = env?.content ?? [];
+  return parts.map((c) => c.text ?? "").filter((t) => t !== "").join("\n");
+}
+function envelopeFirstTextPart(env) {
+  const parts = env?.content ?? [];
+  return parts.find((c) => typeof c.text === "string" && c.text !== "")?.text ?? "";
+}
 function assetUrlsFromEnvelopeText(text) {
   const byUrl = /* @__PURE__ */ new Map();
   for (const m of text.matchAll(/const\s+\w+\s*=\s*"(https?:\/\/[^"]+\/assets?\/([a-z0-9-]+)\.(svg|png))"/gi)) {
@@ -4309,7 +4317,7 @@ var init_prelude = __esm({
 - Component root: -webkit-font-smoothing: antialiased and -moz-osx-font-smoothing: grayscale (recorded rasterization); font-synthesis: none (a missing font weight must fall back visibly, never fake-bold); color-scheme MATCHING YOUR RECORDING (light for a light capture, dark for a dark one) and direction: ltr \u2014 pin them, so the render cannot follow the viewer OS preference and drift from the capture it is graded against; isolation: isolate (own stacking context; overlay z-indexes never fight the host).
 - Interactive controls (buttons, options): touch-action: manipulation and user-select: none. Text inputs stay selectable (never user-select: none on them).
 - Scrollable popovers/menus: overscroll-behavior: contain.
-- Focus rings on :focus-visible, never bare :focus (keyboard shows the ring; mouse click must not leave one).
+- 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 focus indicator (leave outline in place on :focus-visible) and state the gap in your report. Text inputs match :focus-visible even on mouse click BY SPEC \u2014 that is platform-correct accessibility, never a bug to suppress with JS modality tracking.
 - Every animation wrapped in @media (prefers-reduced-motion: no-preference) or disabled under reduce.`;
   }
 });
@@ -6498,7 +6506,13 @@ async function autoFetchAssets(setDir, rep, envelopeText2) {
 async function runRecordIngest(opts) {
   let payload;
   try {
-    payload = opts.raw === true ? { content: [{ type: "text", text: readFileSync15(path24.resolve(opts.file), "utf8") }] } : JSON.parse(readFileSync15(path24.resolve(opts.file), "utf8"));
+    if (opts.rawParts === true) {
+      const parts = JSON.parse(readFileSync15(path24.resolve(opts.file), "utf8"));
+      if (!Array.isArray(parts) || parts.length === 0 || parts.some((p) => typeof p !== "string")) throw new Error("--raw-parts file must be a non-empty JSON array of strings");
+      payload = { content: parts.map((text) => ({ type: "text", text })) };
+    } else {
+      payload = opts.raw === true ? { content: [{ type: "text", text: readFileSync15(path24.resolve(opts.file), "utf8") }] } : JSON.parse(readFileSync15(path24.resolve(opts.file), "utf8"));
+    }
   } catch (err) {
     fail(opts, ExitCode.InputValidation, {
       error: `cannot read envelope file: ${err instanceof Error ? err.message : String(err)}`,
@@ -6506,7 +6520,7 @@ async function runRecordIngest(opts) {
       remediation: "Pass the tool response saved verbatim: as JSON, or as raw text with --raw."
     });
   }
-  if (opts.raw === true && opts.tool === "get_screenshot") {
+  if ((opts.raw === true || opts.rawParts === true) && opts.tool === "get_screenshot") {
     fail(opts, ExitCode.InputValidation, {
       error: "--raw is for text tool responses; screenshots are binary",
       code: "envelope-invalid",
@@ -7276,7 +7290,7 @@ function authorBehaviors(api) {
   return { behaviors, prelude: { controls: interactive ? ["> *"] : [], textInputs: [] }, disclosures };
 }
 function envelopeText(file) {
-  return JSON.parse(readFileSync17(file, "utf8")).content[0]?.text ?? "";
+  return envelopeFirstTextPart(JSON.parse(readFileSync17(file, "utf8")));
 }
 function recordedFontNeeds(setDir) {
   const byFamily = /* @__PURE__ */ new Map();
@@ -7467,7 +7481,8 @@ var init_brief = __esm({
 import { existsSync as existsSync21, readFileSync as readFileSync18, readdirSync as readdirSync5 } from "node:fs";
 import path27 from "node:path";
 function repText(set, rep, tool) {
-  return JSON.parse(readFileSync18(path27.join(set, rep, `${tool}.json`), "utf8")).content[0]?.text ?? "";
+  const env = JSON.parse(readFileSync18(path27.join(set, rep, `${tool}.json`), "utf8"));
+  return tool === "get_design_context" ? envelopeFirstTextPart(env) : envelopeTextContent(env);
 }
 function stripFigmaInstructions(emission) {
   const STYLE_FACTS = "These styles are contained in the design:";
@@ -7528,7 +7543,7 @@ function buildSegments(task, mode = "fenced") {
   const SET = task.set;
   let rawDefs = {};
   if (existsSync21(path27.join(SET, "get_variable_defs.json"))) {
-    const text = JSON.parse(readFileSync18(path27.join(SET, "get_variable_defs.json"), "utf8")).content[0]?.text ?? "{}";
+    const text = envelopeFirstTextPart(JSON.parse(readFileSync18(path27.join(SET, "get_variable_defs.json"), "utf8"))) || "{}";
     try {
       rawDefs = JSON.parse(text);
     } catch {
@@ -7537,7 +7552,7 @@ function buildSegments(task, mode = "fenced") {
     for (const cfg of task.configs) {
       const f = path27.join(SET, cfg.rep, "get_variable_defs.json");
       if (!existsSync21(f)) continue;
-      const text = JSON.parse(readFileSync18(f, "utf8")).content[0]?.text ?? "{}";
+      const text = envelopeFirstTextPart(JSON.parse(readFileSync18(f, "utf8"))) || "{}";
       try {
         for (const [k, v] of Object.entries(JSON.parse(text))) rawDefs[k] ??= v;
       } catch {
@@ -7546,7 +7561,7 @@ function buildSegments(task, mode = "fenced") {
   }
   const emissionTexts = task.configs.map((cfg) => {
     const f = path27.join(SET, cfg.rep, "get_design_context.json");
-    return existsSync21(f) ? JSON.parse(readFileSync18(f, "utf8")).content[0]?.text ?? "" : "";
+    return existsSync21(f) ? envelopeFirstTextPart(JSON.parse(readFileSync18(f, "utf8"))) : "";
   });
   const { map, note } = cleanTokenMap(rawDefs, emissionTexts);
   const defs = JSON.stringify(map, null, 1);
@@ -7596,6 +7611,7 @@ var cssIdent;
 var init_segments = __esm({
   "packages/generate/src/segments.ts"() {
     "use strict";
+    init_src();
     cssIdent = (name) => name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
   }
 });
@@ -7720,7 +7736,7 @@ function countLatticeSymbols(setDir) {
   if (files.length === 0) return null;
   let count = 0;
   for (const f of files) {
-    const text = JSON.parse(readFileSync19(f, "utf8")).content[0]?.text ?? "";
+    const text = envelopeTextContent(JSON.parse(readFileSync19(f, "utf8")));
     count += [...text.matchAll(/name="([^"]*)"/g)].filter((m) => m[1].includes("=")).length;
   }
   return count > 0 ? count : null;
@@ -7836,6 +7852,7 @@ var init_bundle_emit = __esm({
   "packages/generate/src/bundle-emit.ts"() {
     "use strict";
     init_src6();
+    init_src();
     init_src4();
     BARS = {
       pass: { sim: 0.95, ink: 0.95 },
@@ -8449,7 +8466,7 @@ ${segments}`;
       ...notRecorded !== void 0 && notRecorded !== "" ? { notRecorded } : {},
       ...fontProvisioning !== void 0 ? { fontProvisioning } : {},
       modelSelection: {
-        instruction: "The model declaration is MECHANICAL: `engine score` refuses to run without --model. When a user is present, ask BEFORE reading the payload, using the template below verbatim where your host renders option dialogs. The audience is non-technical: plain cost/quality language, no model knowledge assumed. In a non-interactive session pick the balanced tier, state the reason in your report, and declare it \u2014 a silent default is not possible.",
+        instruction: "The model declaration is MECHANICAL: `engine score` refuses to run without --model. ONLY ask when the answer can take effect \u2014 i.e. you can delegate implementation to an agent running the chosen model; if you cannot delegate in this session, skip the question, build as yourself, and declare your own model honestly (a question whose answer changes nothing wastes the user's trust \u2014 measured, second Windows run). When you do ask: BEFORE reading the payload, using the template below verbatim where your host renders option dialogs. The audience is non-technical: plain cost/quality language, no model knowledge assumed. In a non-interactive session pick the balanced tier, state the reason in your report, and declare it \u2014 a silent default is not possible.",
         questionTemplate: {
           prompt: "Which model should build this component? Every choice is scored by the same independent measurement \u2014 a cheaper model may need more attempts, but it can never ship a lower-quality certified result.",
           options: [
@@ -9859,11 +9876,11 @@ function buildProgram() {
     const { runRecordNext: runRecordNext2 } = await Promise.resolve().then(() => (init_record(), record_exports));
     runRecordNext2({ ...flags, setDir: cmd.opts()["set"] });
   });
-  record.command("ingest").requiredOption("--set <dir>", "recording set directory").requiredOption("--rep <slug>", "planned rep slug").requiredOption("--tool <tool>", "get_design_context | get_metadata | get_screenshot | get_variable_defs").requiredOption("--file <file>", "verbatim envelope JSON (or raw response text with --raw)").option("--raw", "the file holds the tool response TEXT verbatim; the CLI builds the envelope").action(async (_o, cmd) => {
+  record.command("ingest").requiredOption("--set <dir>", "recording set directory").requiredOption("--rep <slug>", "planned rep slug").requiredOption("--tool <tool>", "get_design_context | get_metadata | get_screenshot | get_variable_defs").requiredOption("--file <file>", "verbatim envelope JSON (or raw response text with --raw)").option("--raw", "the file holds the tool response TEXT verbatim; the CLI builds the envelope").option("--raw-parts", "the file holds a JSON array of response block texts (multi-block transport); each becomes a content part verbatim").action(async (_o, cmd) => {
     const flags = globalFlags(cmd.parent.parent);
     const local = cmd.opts();
     const { runRecordIngest: runRecordIngest2 } = await Promise.resolve().then(() => (init_record(), record_exports));
-    await runRecordIngest2({ ...flags, setDir: local["set"], rep: local["rep"], tool: local["tool"], file: local["file"], raw: local["raw"] });
+    await runRecordIngest2({ ...flags, setDir: local["set"], rep: local["rep"], tool: local["tool"], file: local["file"], raw: local["raw"], rawParts: local["rawParts"] });
   });
   record.command("fetch").description("Download a Figma asset URL straight to disk and ingest it \u2014 no shell, no model in the byte path.").requiredOption("--set <dir>", "recording set directory").requiredOption("--rep <slug>", "planned rep slug").requiredOption("--tool <tool>", "get_screenshot").requiredOption("--url <url>", "image_url from the Figma tool response, verbatim").action(async (_o, cmd) => {
     const flags = globalFlags(cmd.parent.parent);

package/package.json

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