@tendrilapp/cli 0.1.17 → 0.1.18

package/dist/SKILL.md

@@ -23,8 +23,11 @@ Non-negotiables (the CLI enforces these; do not fight them):
 ## Recording a new component (needs Figma MCP)
 
 1. Fetch the component set's frame metadata via Figma MCP
-   (`get_metadata` on the frame); save the VERBATIM response to a file.
-2. `tendril_record_plan` with that file → the queue plan. The plan
+   (`get_metadata` on the frame).
+2. `tendril_record_plan` with the response text passed VERBATIM via
+   `metadataParts` (one array entry per response block, in order —
+   single-block responses may use `metadata` instead; nothing is saved
+   to a file, and never hand-join blocks) → the queue plan. The plan
    records the FULL variant matrix — every pose the set defines
    (sampling exists only as a human-run CLI flag; the MCP surface
    cannot sample). CROSS-CHECK `variantsFound` in the plan output
@@ -51,6 +54,9 @@ Non-negotiables (the CLI enforces these; do not fight them):
    every open-source face the recording declares, no questions needed.
    Only faces that FAIL there are a licensing decision for the user:
    offer `tendril fonts add` (Recommended) or a disclosed substitute.
+   A substitute never certifies: scores are capped at pass and a
+   cert-bar run exits fonts-unproven after its report — resolving the
+   real faces is the only path to certification.
 3. Record each planned rep with FOUR tool calls: make the THREE
    Figma MCP calls in protocol order — get_metadata, then
    get_design_context (excludeScreenshot=true), then get_screenshot —

package/dist/tendril-mcp.js

@@ -25,26 +25,44 @@ var optStr = (d) => z.string().optional().describe(d);
 var TOOLS = [
   {
     name: "tendril_record_plan",
-    description: "ENTRY POINT for implementing/building a React component from a Figma design or figma.com URL \u2014 start the Tendril pipeline here (after loading the tendril skill, if installed). Plans a recording session: computes the rep queue (anchor + one-factor + conflict crosses) from verbatim get_metadata envelope file(s) and persists the set manifest. Resumes if the set already exists. The output may carry USER QUESTIONS \u2014 defaultsToConfirm (which pose is the component's default) or a multiple-component-sets error (which set to record): render them to a present user and apply the answers via `defaults` / `componentSet`; non-interactive runs follow each question's stated fallback. Recording cost is stated in figmaCallEstimate, never asked about \u2014 proceed with what the user provided.",
+    description: "ENTRY POINT for implementing/building a React component from a Figma design or figma.com URL \u2014 start the Tendril pipeline here (after loading the tendril skill, if installed). Plans a recording session: computes the rep queue (anchor + one-factor + conflict crosses) from the verbatim get_metadata response (pass its blocks via metadataParts \u2014 no file to write) and persists the set manifest. Resumes if the set already exists. The output may carry USER QUESTIONS \u2014 defaultsToConfirm (which pose is the component's default) or a multiple-component-sets error (which set to record): render them to a present user and apply the answers via `defaults` / `componentSet`; non-interactive runs follow each question's stated fallback. Recording cost is stated in figmaCallEstimate, never asked about \u2014 proceed with what the user provided.",
     schema: z.object({
       setDir: str("recording set directory to create/resume"),
       component: str("component/system name"),
-      metadataFiles: z.array(z.string()).describe('verbatim get_metadata envelope file paths \u2014 the tool response saved AS-IS, JSON shape {"content":[{"type":"text","text":"<frame \u2026>"}]}; raw copied text is rejected. Optionally <file>@<frameId>'),
+      // Parts array FIRST, same reason as ingest_rep: real responses
+      // are usually multi-block, and the file param made plan the ONE
+      // remaining hand-built-envelope entry point (run 10: the agent
+      // wrote the file twice — once as text, once as JSON envelope).
+      metadataParts: z.array(z.string()).optional().describe("the frame-level get_metadata response blocks, every block in order, each verbatim \u2014 never hand-join or save them yourself; this is the NORMAL param"),
+      metadata: optStr("ONLY when get_metadata genuinely returned one single block: its text verbatim (otherwise use metadataParts)"),
+      metadataFiles: z.array(z.string()).optional().describe('saved verbatim get_metadata envelope file paths \u2014 JSON shape {"content":[{"type":"text","text":"<frame \u2026>"}]}; optionally <file>@<frameId>. Prefer metadataParts: no file to write'),
       defaults: z.array(z.string()).optional().describe(`axis defaults as "Axis=Value" (from the user's defaultsToConfirm answers; may re-plan a set with nothing recorded yet)`),
       componentSet: optStr("record only this component set (the user's pick from a multiple-component-sets error)")
     }),
-    argv: (i) => [
-      "record",
-      "plan",
-      "--set",
-      i["setDir"],
-      "--component",
-      i["component"],
-      "--metadata",
-      ...i["metadataFiles"],
-      ...i["defaults"] !== void 0 ? ["--default", ...i["defaults"]] : [],
-      ...i["componentSet"] !== void 0 ? ["--component-set", i["componentSet"]] : []
-    ]
+    // Texts ride temp files, never argv: Windows caps a command line at
+    // ~32 KB and metadata envelopes can exceed it.
+    argv: (i) => {
+      const argvOut = ["record", "plan", "--set", i["setDir"], "--component", i["component"]];
+      if (i["metadata"] !== void 0 && i["metadataParts"] !== void 0) throw new Error("pass at most one of `metadata` and `metadataParts`");
+      const files = i["metadataFiles"];
+      if (files !== void 0 && files.length > 0) argvOut.push("--metadata", ...files);
+      const single = i["metadata"];
+      const parts = i["metadataParts"];
+      if (single !== void 0 || parts !== void 0) {
+        const tmp = path.join(mkdtempSync(path.join(os.tmpdir(), "tendril-envelope-")), "response.txt");
+        if (single !== void 0) {
+          writeFileSync(tmp, single);
+          argvOut.push("--metadata-raw-file", tmp);
+        } else {
+          if (parts.length === 0) throw new Error("`metadataParts` must be a non-empty array of block texts");
+          writeFileSync(tmp, JSON.stringify(parts));
+          argvOut.push("--metadata-raw-parts-file", tmp);
+        }
+      }
+      if (argvOut.length === 6) throw new Error("nothing to plan from \u2014 pass metadataParts (normal), metadata (single-block), or metadataFiles");
+      argvOut.push(...i["defaults"] !== void 0 ? ["--default", ...i["defaults"]] : [], ...i["componentSet"] !== void 0 ? ["--component-set", i["componentSet"]] : []);
+      return argvOut;
+    }
   },
   {
     name: "tendril_doctor",
@@ -81,7 +99,7 @@ var TOOLS = [
       // multi-block (run 6: 49/49 reps — metadata 2 blocks, design
       // context 5-6), so the arrays are the norm and the single-string
       // params the rare case, not the reverse.
-      metadataParts: z.array(z.string()).optional().describe("get_metadata response blocks, every block in order, each verbatim \u2014 never hand-join blocks yourself. Real responses are almost always multi-block; this is the NORMAL param."),
+      metadataParts: z.array(z.string()).optional().describe("get_metadata response blocks, every block in order, each verbatim \u2014 never hand-join blocks yourself. Multi-block responses are common (run 6: 49/49 reps); a single block wrapped in a one-element array is equally fine."),
       contextParts: z.array(z.string()).optional().describe("get_design_context response blocks, every block in order, each verbatim \u2014 the NORMAL param (real responses arrive as 5-6 blocks)"),
       screenshotUrl: optStr("image_url from the get_screenshot response, verbatim \u2014 the CLI downloads it; the bytes never pass through your context"),
       metadata: optStr("ONLY when get_metadata genuinely returned one single block: its text verbatim (otherwise use metadataParts)"),
@@ -379,7 +397,7 @@ var IMPLEMENT_PROMPT = {
   build: (figmaUrl) => [
     `Implement the Figma component at ${figmaUrl} as a pixel-verified React component using the Tendril pipeline.`,
     "- If the tendril skill (or plugin) is installed, load it and follow it.",
-    "- Otherwise: start at tendril_record_plan; while recording, make exactly the Figma call each tendril_record_next step names (get_metadata comes before any get_design_context) and save responses verbatim; then tendril_engine_brief, implement the candidate, and tendril_engine_score until the bar passes; finish with tendril_verify.",
+    "- Otherwise: start at tendril_record_plan; while recording, make exactly the Figma call each tendril_record_next step names (get_metadata comes before any get_design_context) and pass every response VERBATIM to the ingest tools (no files to save \u2014 the parts params take the response blocks directly); then tendril_engine_brief, implement the candidate, and tendril_engine_score until the bar passes; finish with tendril_verify.",
     "- Verdicts come only from Tendril's scores \u2014 never claim or estimate fidelity numbers yourself."
   ].join("\n")
 };