npm - @tendrilapp/cli - Versions diffs - 0.1.20 → 0.1.21 - Mend

@tendrilapp/cli 0.1.20 → 0.1.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/dist/SKILL.md CHANGED Viewed

@@ -39,16 +39,28 @@ user must reload the session to apply; say that out loud. Offer ONCE
 per session; never run it unoffered (it edits the user's settings),
 and if declined, proceed without mentioning it again.
-Long generator/score waits: silence is not a health signal. The scorer
-appends a timestamped line to `<candidateDir>/score-history.jsonl`
-after EVERY completed round — the file APPEARS ONLY AFTER THE FIRST
-score, so its absence early in a run is normal, not frozen. Poll it
-(and the candidate dir's mtimes) about every 30 seconds and relay
-progress to the user ("round 3 scored: 15/21 at floor 0.885"). A
-healthy run can take 30+ minutes; never kill on elapsed time alone —
-count staleness from the LAST CHANGE to either signal, not from run
-start, and when past ~20 minutes of true staleness, ask the user
-before killing.
+Long generator/score waits: silence is not a health signal, and POLL
+cadence is not RELAY cadence (run 13: rounds landed 6–11 minutes apart,
+so a correct 30s poll still left the user in 9-minute silences they
+flagged as unacceptable). Two duties: relay each round's result the
+moment `<candidateDir>/score-history.jsonl` gains a line ("round 3
+scored: 15/21 at floor 0.885"), AND when more than ~60 seconds pass
+with no round, emit a liveness line from the candidate dir's file
+mtimes, which move while the generator is WRITING (thinking pauses are quiet — that is normal, not frozen) ("still
+working — styles.css touched 20s ago"). The history file APPEARS ONLY
+AFTER THE FIRST completed score, so its absence early is normal, not
+frozen. A healthy run can take 30+ minutes; never kill on elapsed time
+alone — count staleness from the LAST CHANGE to any signal, and when
+past ~20 minutes of true staleness, ask the user before killing.
+Before concluding "inherent limitation" on a stuck score: enumerate the
+rendering inputs you have NOT verified — are the declared font faces
+actually resolved (the kit's cached faces and weights vs what the CSS
+asks for), computed styles vs authored styles, and
+platform text antialiasing — and check them first. Run 13's "inherent
+fidelity gap" was a missing font weight one check away; a stop rule is
+for avoiding thrash, never for converting an unverified hypothesis into
+a final answer.
 Batch runs (several components in one session):
 - Cap concurrent recorders at FOUR. All recorders share one Figma

package/dist/tendril.js CHANGED Viewed

@@ -2274,6 +2274,31 @@ var init_report = __esm({
   }
 });
+// packages/verify/src/mount-limits.ts
+function lcdTextDisabled() {
+  return process.env["TENDRIL_DISABLE_LCD_TEXT"] === "1";
+}
+function mountArgs() {
+  return [MEMORY_CAP_ARG, ...lcdTextDisabled() ? ["--disable-lcd-text"] : []];
+}
+function raceMountDeadline(work, deadlineMs, onDeadline) {
+  return Promise.race([
+    work,
+    new Promise((resolve) => {
+      const timer = setTimeout(() => resolve(onDeadline()), deadlineMs);
+      timer.unref();
+    })
+  ]);
+}
+var MEMORY_CAP_ARG, ENGINE_MOUNT_DEADLINE_MS;
+var init_mount_limits = __esm({
+  "packages/verify/src/mount-limits.ts"() {
+    "use strict";
+    MEMORY_CAP_ARG = "--js-flags=--max-old-space-size=512";
+    ENGINE_MOUNT_DEADLINE_MS = 3e4;
+  }
+});
 // packages/verify/src/image-diff.ts
 import { PNG } from "pngjs";
 import pixelmatch from "pixelmatch";
@@ -3030,7 +3055,7 @@ ${input.tokensCss}
 ${input.files.css}
 #root { display: inline-block; }
 </style></head><body><div id="root"></div><script>${js}</script></body></html>`;
-  const browser = await chromium.launch({ executablePath, headless: true });
+  const browser = await chromium.launch({ executablePath, headless: true, args: mountArgs() });
   try {
     const page = await browser.newPage({ viewport: { width: 800, height: 600 } });
     await page.setContent(html, { waitUntil: "load" });
@@ -3268,6 +3293,7 @@ var init_visual_facts = __esm({
   "packages/verify/src/visual-facts.ts"() {
     "use strict";
     init_browser();
+    init_mount_limits();
     init_image_diff();
     RESOLVE_DIR = path7.resolve(path7.dirname(fileURLToPath2(import.meta.url)), "..");
     TOLERANCE_PX = 2;
@@ -3485,25 +3511,6 @@ var init_font_faces = __esm({
   }
 });
-// packages/verify/src/mount-limits.ts
-function raceMountDeadline(work, deadlineMs, onDeadline) {
-  return Promise.race([
-    work,
-    new Promise((resolve) => {
-      const timer = setTimeout(() => resolve(onDeadline()), deadlineMs);
-      timer.unref();
-    })
-  ]);
-}
-var MEMORY_CAP_ARG, ENGINE_MOUNT_DEADLINE_MS;
-var init_mount_limits = __esm({
-  "packages/verify/src/mount-limits.ts"() {
-    "use strict";
-    MEMORY_CAP_ARG = "--js-flags=--max-old-space-size=512";
-    ENGINE_MOUNT_DEADLINE_MS = 3e4;
-  }
-});
 // packages/verify/src/admission.ts
 import { readFileSync as readFileSync5, readdirSync as readdirSync2, existsSync as existsSync7, writeFileSync as writeFileSync4 } from "node:fs";
 import path11 from "node:path";
@@ -4080,7 +4087,7 @@ async function checkBehaviors(task, bundleDir, opts = {}) {
   const js = await compileMount(task, bundleDir);
   if (typeof js !== "string") return task.behaviors.map((b) => ({ id: b.id, pass: false, detail: js.error }));
   const css = ["tokens.css", "styles.css"].map((f) => path13.join(bundleDir, f)).filter((f) => existsSync8(f)).map((f) => readFileSync6(f, "utf8")).join("\n");
-  const server = await chromium3.launchServer({ executablePath: resolveChrome(), headless: true, args: [MEMORY_CAP_ARG] });
+  const server = await chromium3.launchServer({ executablePath: resolveChrome(), headless: true, args: mountArgs() });
   const browser = await chromium3.connect(server.wsEndpoint());
   const results = [];
   let deadlined = false;
@@ -4512,7 +4519,7 @@ if (root && C) createRoot(root).render(createElement(C, cfg.props));
     }
     return detectBackdrop(ref);
   };
-  const server = await chromium4.launchServer({ executablePath: resolveChrome(), headless: true, args: [MEMORY_CAP_ARG] });
+  const server = await chromium4.launchServer({ executablePath: resolveChrome(), headless: true, args: mountArgs() });
   const browser = await chromium4.connect(server.wsEndpoint());
   const scores = [];
   try {
@@ -4705,7 +4712,7 @@ async function checkHoverParity(task, bundleDir, opts = {}) {
   const js = await compileMount(task, bundleDir);
   if (typeof js !== "string") return configs.map((c) => ({ id: `parity:${c.rep}`, pass: false, detail: js.error }));
   const css = ["tokens.css", "styles.css"].map((f) => path16.join(bundleDir, f)).filter((f) => existsSync11(f)).map((f) => readFileSync9(f, "utf8")).join("\n");
-  const server = await chromium6.launchServer({ executablePath: resolveChrome(), headless: true, args: [MEMORY_CAP_ARG] });
+  const server = await chromium6.launchServer({ executablePath: resolveChrome(), headless: true, args: mountArgs() });
   const browser = await chromium6.connect(server.wsEndpoint());
   const results = [];
   try {
@@ -4879,7 +4886,7 @@ async function checkCropComposition(task, bundleDir, regions, opts = {}) {
     return regions.map((r) => ({ id: cropId(r), pass: false, similarity: 0, inkRecall: 0, detail: js.error }));
   }
   const css = ["tokens.css", "styles.css"].map((f) => path17.join(bundleDir, f)).filter((f) => existsSync12(f)).map((f) => readFileSync10(f, "utf8")).join("\n");
-  const server = await chromium7.launchServer({ executablePath: resolveChrome(), headless: true, args: [MEMORY_CAP_ARG] });
+  const server = await chromium7.launchServer({ executablePath: resolveChrome(), headless: true, args: mountArgs() });
   const browser = await chromium7.connect(server.wsEndpoint());
   const PAD = 4;
   try {
@@ -4984,7 +4991,7 @@ async function checkStructuralComposition(task, bundleDir, roles, opts = {}) {
   const js = await compileInstrumentedMount(task, bundleDir);
   if (typeof js !== "string") return [...results, ...mains.map((m) => ({ id: `composition:${m}`, pass: false, detail: js.error }))];
   const css = ["tokens.css", "styles.css"].map((f) => path17.join(bundleDir, f)).filter((f) => existsSync12(f)).map((f) => readFileSync10(f, "utf8")).join("\n");
-  const server = await chromium7.launchServer({ executablePath: resolveChrome(), headless: true, args: [MEMORY_CAP_ARG] });
+  const server = await chromium7.launchServer({ executablePath: resolveChrome(), headless: true, args: mountArgs() });
   const browser = await chromium7.connect(server.wsEndpoint());
   try {
     for (const mainSlug of mains) {
@@ -5124,7 +5131,7 @@ async function checkSiblingOcclusion(task, bundleDir, css, opts = {}) {
   const js = await compileTwoUp(task, bundleDir);
   if (typeof js !== "string") return [{ id: "sibling-overlay-hit-testable", pass: false, detail: js.error }];
   const timeoutMs = opts.mountDeadlineMs ?? ENGINE_MOUNT_DEADLINE_MS;
-  const server = await chromium8.launchServer({ executablePath: resolveChrome(), headless: true, args: [MEMORY_CAP_ARG] });
+  const server = await chromium8.launchServer({ executablePath: resolveChrome(), headless: true, args: mountArgs() });
   const browser = await chromium8.connect(server.wsEndpoint());
   try {
     const work = (async () => {
@@ -5250,6 +5257,7 @@ var init_src4 = __esm({
     init_containment();
     init_tasks();
     init_prelude();
+    init_mount_limits();
     init_font_faces();
     init_font_resolve();
     init_paths();
@@ -5289,7 +5297,9 @@ function environmentStamp(taskFamilies) {
     chrome = resolveChrome();
   } catch {
   }
-  return { chrome, chromeVersion: chrome === "unavailable" ? null : chromeVersion(), fontsManifestSha256: fontsHash };
+  const ver = chrome === "unavailable" ? null : chromeVersion();
+  const lcdOff = lcdTextDisabled() ? " (lcd-text-disabled)" : "";
+  return { chrome, chromeVersion: ver === null ? null : ver + lcdOff, fontsManifestSha256: fontsHash };
 }
 var init_environment = __esm({
   "packages/cli/src/environment.ts"() {
@@ -5532,7 +5542,7 @@ async function runDoctorChecks(options) {
   );
   try {
     const chrome = resolveChrome();
-    checks.push({ name: "browser", ok: true, detail: `${chromeVersion() ?? "version unknown"} at ${chrome}` });
+    checks.push({ name: "browser", ok: true, detail: `${chromeVersion() ?? "version unknown"}${lcdTextDisabled() ? " \u2014 EXPERIMENT override active (lcd-text-disabled): scores not comparable to default runs" : ""} at ${chrome}` });
   } catch (err) {
     checks.push({
       name: "browser",
@@ -8164,7 +8174,7 @@ ${propLines.join("\n")}
 ${syntheticCombos.length > 0 ? `UNRECORDED REACHABLE COMBINATIONS: the design's exclusive axis cannot express ${syntheticCombos.join(", ")} \u2014 the API split makes them reachable with NO recorded truth. Compose them from the recorded per-axis truth (paint variables: one axis sets, the other consumes), never invent a bespoke look, and list them in your report.
 ` : ""}${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. RICH-TEXT DEFAULTS: when the recorded content is a multi-run rich node (mixed weights, an underlined link span) whose concatenation is the prop's default string, a plain-string default would flatten the recorded formatting \u2014 default the parameter to undefined and render the recorded rich markup when the prop is absent; a caller-supplied string then renders plainly. That mirrors the design tool's own emission logic and keeps every recorded pose pixel-exact.
-` : ""}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. FLUIDITY AFFORDANCE (emit it always): every ROOT width declaration rides width: var(--tendril-root-width, <recorded>px) with that pose's recorded width as the fallback \u2014 per-variant root widths reuse the SAME property name with their own recorded fallbacks. With the property unset this is byte-equivalent truth: identical pixels, identical operability measurement (measured: flipping roots to a bare 100% held 20/20 pixels but made a commit check unmeasurable \u2014 the recorded pin carries real signal). A consumer makes an instance fluid by setting --tendril-root-width (e.g. 100%) on a wrapper, no edit to certified CSS. Widths only: recorded heights and internal geometry stay literal \u2014 fixed heights are often genuine design intent.`;
+` : ""}Rules: generated element ids come from React's useId() \u2014 never Math.random() in render/state init (SSR hydration hazard; measured: two same-day bundles disagreed). 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. FLUIDITY AFFORDANCE (emit it always): every ROOT width declaration rides width: var(--tendril-root-width, <recorded>px) with that pose's recorded width as the fallback \u2014 per-variant root widths reuse the SAME property name with their own recorded fallbacks. With the property unset this is byte-equivalent truth: identical pixels, identical operability measurement (measured: flipping roots to a bare 100% held 20/20 pixels but made a commit check unmeasurable \u2014 the recorded pin carries real signal). A consumer makes an instance fluid by setting --tendril-root-width (e.g. 100%) on a wrapper, no edit to certified CSS. Widths only: recorded heights and internal geometry stay literal \u2014 fixed heights are often genuine design intent.`;
   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)");
@@ -9471,6 +9481,9 @@ async function runVerify(opts) {
       remediation: fontsUnprovenRemediation(task.set)
     });
   }
+  if (lcdTextDisabled()) {
+    warn(opts, "EXPERIMENT override active (TENDRIL_DISABLE_LCD_TEXT=1): text renders greyscale \u2014 scores are NOT comparable to default runs; the environment stamp and report are marked");
+  }
   const substitutedFamilies = unprovisionedFamilies(task.set);
   if (substitutedFamilies.length > 0) {
     warn(opts, `substituted fonts: cache lacks ${substitutedFamilies.map((f) => `"${f}"`).join(", ")} \u2014 scores measure a substitute face and no config can be certified under one (the stamp covers only the provisioned subset); resolve the families to certify`);
@@ -9591,7 +9604,17 @@ async function runVerify(opts) {
     // with zero pixel/behavior/composition failures was only
     // explainable from stderr prose.
     ...certBlockedByAbsentInk.length > 0 ? { certBlockedByAbsentInk } : {},
-    ...weightGaps.length > 0 ? { fontWeightGaps: weightGaps } : {}
+    ...weightGaps.length > 0 ? { fontWeightGaps: weightGaps } : {},
+    ...lcdTextDisabled() ? { environmentOverrides: ["disable-lcd-text"] } : {},
+    // Run 13 finding 1: the eye-check nudge lived only in the human
+    // footer, so MCP-driven agents — the documented path — were never
+    // told the check exists and shipped without ever opening a sheet.
+    // Structured here so every consumer sees it.
+    eyeCheck: {
+      command: `tendril inspect "${opts.bundleDir}"`,
+      sheetPath: path31.join(opts.bundleDir, "verify-evidence", "inspect.html"),
+      note: "magnified recorded-vs-rendered crops of every small node; scores cannot see shape. The command WRITES/refreshes the sheet at sheetPath \u2014 re-run it after every verify; an existing sheet may show stale crops."
+    }
   };
   emitData(opts, report, () => {
     for (const s of statuses) {
@@ -9691,7 +9714,7 @@ ${certified}/${statuses.length} certified \xB7 ${report.coverage.pass}/${statuse
     }
     process.stdout.write(`evidence: ${evidenceDir} (render/ref/diff per config)
 `);
-    process.stdout.write(`eye check: tendril inspect ${opts.bundleDir} \u2014 magnified recorded-vs-rendered crops of every small node; scores cannot see shape
+    process.stdout.write(`eye check: tendril inspect "${opts.bundleDir}" \u2014 magnified recorded-vs-rendered crops of every small node; scores cannot see shape (re-run after every verify)
 `);
   });
   if (opts.bar === "cert" && substitutedFamilies.length > 0) {
@@ -9883,6 +9906,9 @@ async function runEngineScore(opts) {
       remediation: fontsUnprovenRemediation(task.set)
     });
   }
+  if (lcdTextDisabled()) {
+    warn(opts, "EXPERIMENT override active (TENDRIL_DISABLE_LCD_TEXT=1): text renders greyscale \u2014 scores are NOT comparable to default runs; the environment stamp and report are marked");
+  }
   const substitutedFamilies = unprovisionedFamilies(task.set);
   if (substitutedFamilies.length > 0) {
     warn(opts, `substituted fonts: cache lacks ${substitutedFamilies.map((f) => `"${f}"`).join(", ")} \u2014 scores measure a substitute face and no config can be certified under one (the stamp covers only the provisioned subset); resolve the families to certify`);
@@ -9982,6 +10008,7 @@ METRIC DEADBAND (read before iterating on near-misses): the scored similarity/in
       bundleManifest: emitted.written[0],
       note: "styles.css was stamped with the bundle provenance comment on line 1 \u2014 preserve it in any post-score edit",
       allPass,
+      ...lcdTextDisabled() ? { environmentOverrides: ["disable-lcd-text"] } : {},
       // Run 11: generators read allPass:true and reported success on
       // bundles verify then FAILED on the interaction-evidence gate —
       // the oracle must say what verify will say, including this.

package/package.json CHANGED Viewed

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