@tendrilapp/cli 0.1.8 → 0.1.10

package/dist/tendril-mcp.js

@@ -46,6 +46,13 @@ var TOOLS = [
       ...i["componentSet"] !== void 0 ? ["--component-set", i["componentSet"]] : []
     ]
   },
+  {
+    name: "tendril_doctor",
+    annotations: { readOnlyHint: true },
+    description: "Machine readiness + version status in one shot: installed vs latest version (with publish date and update remediation), browser identity, font-cache state, Figma desktop MCP reachability. Use to self-diagnose before recording/scoring, or whenever versions are in question. Exit 1 = something not ready; the report says exactly what and how to fix it.",
+    schema: z.object({}),
+    argv: () => ["doctor"]
+  },
   {
     name: "tendril_record_next",
     annotations: { readOnlyHint: true },

package/dist/tendril.js

@@ -7251,6 +7251,14 @@ function authorComponentApi(opts) {
       props.push({ name: propNameFor(key), kind: "union", values: ordered.map(kebab3), default: kebab3(def) });
     }
   }
+  const slots = (opts.textSlots ?? []).map((slot) => {
+    let name = slot.prop;
+    if (name !== "children" && (props.some((pr) => pr.name === name) || RESERVED_PROPS.has(name.toLowerCase()))) name = `${name}Text`;
+    let n = 2;
+    while (props.some((pr) => pr.name === name)) name = `${slot.prop}Text${n++}`;
+    return { ...slot, prop: name };
+  });
+  for (const slot of slots) props.push({ name: slot.prop, kind: "string", default: slot.default });
   const configs = [];
   const seenAssignments = /* @__PURE__ */ new Map();
   const componentIdent = pascal(opts.component);
@@ -7272,6 +7280,10 @@ function authorComponentApi(opts) {
       }
     }
     if (tokens.length > 0) assignment["data-tendril-state"] = tokens.join(" ");
+    for (const slot of slots) {
+      const v = slot.overrides[p.slug];
+      if (v !== void 0) assignment[slot.prop] = v;
+    }
     const canonical = JSON.stringify(Object.fromEntries(Object.entries(assignment).sort(([a], [b]) => a.localeCompare(b))));
     const clash = seenAssignments.get(canonical);
     if (clash !== void 0) {
@@ -7290,7 +7302,7 @@ function authorComponentApi(opts) {
     name: componentIdent,
     props: props.map((pr) => ({
       name: pr.name,
-      type: pr.kind === "boolean" ? "boolean" : pr.values.map((v) => `"${v}"`).join(" | "),
+      type: pr.kind === "boolean" ? "boolean" : pr.kind === "string" ? "string" : pr.values.map((v) => `"${v}"`).join(" | "),
       required: false,
       ...pr.default !== void 0 ? { default: pr.default } : {}
     })),
@@ -7298,7 +7310,7 @@ function authorComponentApi(opts) {
     poseCompleteness: { recordedPoses: opts.poses.length, expressible: configs.length }
   };
   const propLines = props.map(
-    (pr) => pr.kind === "boolean" ? `  ${pr.name}?: boolean;` : `  ${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.name}?: ${pr.values.map((v) => `"${v}"`).join(" | ")}; // default "${pr.default}"`
   );
   const provided = opts.fonts ?? [];
   const recorded = opts.recordedFonts ?? [];
@@ -7311,7 +7323,8 @@ ${propLines.join("\n")}
   [key: string]: unknown; // MUST spread unknown props (incl. data-*) onto the root element
 })
 
-Rules: plain CSS in styles.css (tokens.css optional, loaded first) \u2014 no Tailwind, no imports beyond react/react-dom, and NEVER import the stylesheet from the entry module: the harness injects tokens.css and styles.css itself, and an entry that imports CSS does not compile here (measured cost: one full round, every config 0). The component renders the RECORDED content as its defaults \u2014 reproduce it from the emissions. ${forcingCanon}${fontsLine}The host sizes nothing: the component is its natural recorded size.`;
+${slots.length > 0 ? `CONTENT PROPS: every string prop defaults to its RECORDED text \u2014 render the PROP, never a hardcoded literal. Configs pass per-pose recorded strings wherever the recording varies, and pixels enforce them: a hardcoded string fails those configs. Content presence (a heading that only exists in some poses) follows the AXIS props; the string prop only supplies the text.
+` : ""}Rules: plain CSS in styles.css (tokens.css optional, loaded first) \u2014 no Tailwind, no imports beyond react/react-dom, and NEVER import the stylesheet from the entry module: the harness injects tokens.css and styles.css itself, and an entry that imports CSS does not compile here (measured cost: one full round, every config 0). The component renders the RECORDED content as its defaults \u2014 reproduce it from the emissions. ${forcingCanon}${fontsLine}The host sizes nothing: the component is its natural recorded size.`;
   const mappedTokens = /* @__PURE__ */ new Set([...forcedStates, ...props.filter((p) => p.kind === "boolean").map((p) => p.name)]);
   const unmappedInteractionEvidence = interactionEvidence.filter((e) => {
     const sel = e.endsWith(" (selection axis)");
@@ -7421,6 +7434,67 @@ function recordedFontNeeds(setDir) {
 function recordedFontFamilies(setDir) {
   return recordedFontNeeds(setDir).map((n) => n.family);
 }
+function recordedTextSlots(setDir, repSlugs) {
+  const perRep = [];
+  for (const slug of repSlugs) {
+    const f = path26.join(setDir, slug, "get_design_context.json");
+    if (!existsSync20(f)) continue;
+    const code = envelopeText(f);
+    const texts = [];
+    for (const m of code.matchAll(/>([^<>{}]+)</g)) {
+      const t = decodeXmlEntities(m[1]).trim();
+      if (t === "" || !/[A-Za-z0-9]/.test(t)) continue;
+      texts.push(t);
+    }
+    perRep.push({ slug, texts });
+  }
+  if (perRep.length === 0) return [];
+  const slots = [];
+  for (const rep of perRep) {
+    const used = /* @__PURE__ */ new Set();
+    const unmatched = [];
+    for (const t of rep.texts) {
+      const i = slots.findIndex((sl, idx) => !used.has(idx) && [...sl.values.values()].includes(t));
+      if (i >= 0) {
+        used.add(i);
+        slots[i].values.set(rep.slug, t);
+      } else {
+        unmatched.push(t);
+      }
+    }
+    for (const t of unmatched) {
+      const i = slots.findIndex((_, idx) => !used.has(idx) && !slots[idx].values.has(rep.slug));
+      if (i >= 0) {
+        used.add(i);
+        slots[i].values.set(rep.slug, t);
+      } else {
+        const sl = { values: /* @__PURE__ */ new Map() };
+        sl.values.set(rep.slug, t);
+        slots.push(sl);
+        used.add(slots.length - 1);
+      }
+    }
+  }
+  const usedNames = /* @__PURE__ */ new Set();
+  return slots.map((sl, idx) => {
+    const counts = /* @__PURE__ */ new Map();
+    for (const v of sl.values.values()) counts.set(v, (counts.get(v) ?? 0) + 1);
+    const def = [...counts.entries()].sort((a, b) => b[1] - a[1])[0][0];
+    let prop;
+    if (slots.length === 1) {
+      prop = "children";
+    } else {
+      const word = /[A-Za-z][A-Za-z0-9]*/.exec(def)?.[0]?.toLowerCase();
+      prop = word !== void 0 && word.length >= 2 ? word : `text${idx + 1}`;
+      let n = 2;
+      while (usedNames.has(prop)) prop = `${prop}${n++}`;
+    }
+    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 };
+  });
+}
 function authorTaskFromSet(setDir, opts = {}) {
   if (opts.fonts === void 0) {
     const resolved = resolvedFontFamilies().map((f) => f.family);
@@ -7449,15 +7523,24 @@ function authorTaskFromSet(setDir, opts = {}) {
   const latticeNames = manifest.latticeNames ?? (existsSync20(setMeta) ? [...envelopeText(setMeta).matchAll(/name="([^"]*)"/g)].map((m) => decodeXmlEntities(m[1])) : void 0);
   const defaults = { ...manifest.defaults ?? {}, ...opts.defaults ?? {} };
   const recordedFonts = recordedFontFamilies(setDir);
+  const textSlots = recordedTextSlots(setDir, manifest.reps.map((r) => r.slug));
   const api = authorComponentApi({
     component: manifest.component,
     poses,
     ...latticeNames !== void 0 ? { latticeNames } : {},
     ...opts.fonts !== void 0 ? { fonts: opts.fonts } : {},
     ...recordedFonts.length > 0 ? { recordedFonts } : {},
-    ...Object.keys(defaults).length > 0 ? { defaults } : {}
+    ...Object.keys(defaults).length > 0 ? { defaults } : {},
+    ...textSlots.length > 0 ? { textSlots } : {}
   });
   const { behaviors, prelude, disclosures } = authorBehaviors(api);
+  for (const slot of textSlots) {
+    if (!slot.varies) {
+      disclosures.push(
+        `content prop from recorded text is UNEXERCISED: the recording shows one constant string (${JSON.stringify(slot.default)}) for it, so no config pixel-verifies that the prop reaches the render \u2014 wire it anyway; a sentinel check is future work`
+      );
+    }
+  }
   if (manifest.notRecorded !== void 0) disclosures.push(`not recorded (from the completeness manifest): ${manifest.notRecorded}`);
   const task = {
     set: setDir,
@@ -9322,15 +9405,51 @@ async function runDoctorChecks(options) {
   });
   return { ok: checks.filter((c) => c.name !== "figma-pat" && c.name !== "openrouter-key").every((c) => c.ok), checks };
 }
+function versionIsNewer(a, b) {
+  const pa = a.split(".").map(Number);
+  const pb = b.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((pb[i] ?? 0) > (pa[i] ?? 0)) return true;
+    if ((pb[i] ?? 0) < (pa[i] ?? 0)) return false;
+  }
+  return false;
+}
+async function latestVersionInfo() {
+  try {
+    const ctl = new AbortController();
+    const timer = setTimeout(() => ctl.abort(), 2500);
+    const res = await fetch("https://registry.npmjs.org/@tendrilapp%2fcli", { signal: ctl.signal });
+    clearTimeout(timer);
+    if (!res.ok) return null;
+    const doc = await res.json();
+    const latest = doc["dist-tags"]?.latest;
+    if (latest === void 0) return null;
+    const stamp = doc.time?.[latest];
+    return { latest, ...stamp !== void 0 ? { publishedAt: stamp.slice(0, 10) } : {} };
+  } catch {
+    return null;
+  }
+}
 async function runDoctor(flags) {
   if (flags.describe) {
     printDescription(DOCTOR_DESCRIPTION);
     return;
   }
-  const report = await runDoctorChecks({ ...flags.mcpUrl ? { mcpUrl: flags.mcpUrl } : {} });
-  emitData(flags, { version: cliVersion(), ...report }, () => {
-    process.stdout.write(`tendril ${cliVersion()}
+  const [report, latest] = await Promise.all([runDoctorChecks({ ...flags.mcpUrl ? { mcpUrl: flags.mcpUrl } : {} }), latestVersionInfo()]);
+  emitData(flags, { version: cliVersion(), ...latest !== null ? { latest: latest.latest, latestPublishedAt: latest.publishedAt ?? null, updateAvailable: versionIsNewer(cliVersion(), latest.latest) } : {}, ...report }, () => {
+    const version = cliVersion();
+    if (latest === null) {
+      process.stdout.write(`tendril ${version} (latest: unreachable)
 `);
+    } else if (!versionIsNewer(version, latest.latest)) {
+      process.stdout.write(`tendril ${version} (${latest.latest === version ? "latest" : `ahead of registry ${latest.latest}`}${latest.publishedAt !== void 0 ? `, published ${latest.publishedAt}` : ""})
+`);
+    } else {
+      process.stdout.write(`tendril ${version} \u2014 UPDATE AVAILABLE: ${latest.latest}${latest.publishedAt !== void 0 ? ` (published ${latest.publishedAt})` : ""}
+`);
+      process.stdout.write(`    \u2192 npm install -g @tendrilapp/cli@latest (plugin MCP users update automatically at next session; a stale npx cache clears with npm cache clean --force)
+`);
+    }
     for (const check of report.checks) {
       process.stdout.write(`${check.ok ? "\u2713" : "\u2717"} ${check.name}: ${check.detail}
 `);

package/package.json

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