@tendrilapp/cli 0.1.16 → 0.1.17

package/dist/tendril.js

@@ -1974,8 +1974,9 @@ async function runTokenLint(css, fileLabel = "generated.css", definedVars2) {
     codeFilename: fileLabel,
     config: STYLELINT_CONFIG
   });
+  const mapKnownEmpty = definedVars2 !== void 0 && definedVars2.size === 0;
   const violations = result.results.flatMap(
-    (r) => r.warnings.map((w) => ({
+    (r) => r.warnings.filter((w) => !(mapKnownEmpty && w.rule === "scale-unlimited/declaration-strict-value")).map((w) => ({
       file: fileLabel,
       line: w.line,
       property: w.rule,
@@ -2392,6 +2393,111 @@ function cornersMatchCanvas(ref, canvas) {
     (c) => Math.abs(c[0] - canvas[0]) + Math.abs(c[1] - canvas[1]) + Math.abs(c[2] - canvas[2]) <= INK_DELTA
   );
 }
+function absentInkClusters(render, reference, background = [255, 255, 255]) {
+  const a = PNG.sync.read(Buffer.from(render));
+  const b = PNG.sync.read(Buffer.from(reference));
+  const width = Math.max(a.width, b.width);
+  const height = Math.max(a.height, b.height);
+  const canvasA = onCanvas(a, width, height);
+  const canvasB = onCanvas(b, width, height);
+  const ring = ringModal(canvasB);
+  const backgrounds = channelDistance(ring, background) > INK_DELTA ? [background, ring] : [background];
+  const found = [];
+  for (const bg of backgrounds) {
+    const renderInk = new Uint8Array(width * height);
+    for (let y = 0; y < height; y++) {
+      for (let x = 0; x < width; x++) {
+        if (isInk(canvasA.data, (width * y + x) * 4, bg)) renderInk[width * y + x] = 1;
+      }
+    }
+    const candidate = new Uint8Array(width * height);
+    for (let y = 0; y < height; y++) {
+      for (let x = 0; x < width; x++) {
+        if (!isInk(canvasB.data, (width * y + x) * 4, bg)) continue;
+        let covered = false;
+        scan: for (let dy = -ABSENT_RADIUS; dy <= ABSENT_RADIUS; dy++) {
+          for (let dx = -ABSENT_RADIUS; dx <= ABSENT_RADIUS; dx++) {
+            const nx = x + dx;
+            const ny = y + dy;
+            if (nx < 0 || ny < 0 || nx >= width || ny >= height) continue;
+            if (renderInk[width * ny + nx] === 1) {
+              covered = true;
+              break scan;
+            }
+          }
+        }
+        if (!covered) candidate[width * y + x] = 1;
+      }
+    }
+    const seen = new Uint8Array(width * height);
+    for (let sy = 0; sy < height; sy++) {
+      for (let sx = 0; sx < width; sx++) {
+        const si = width * sy + sx;
+        if (candidate[si] !== 1 || seen[si] === 1) continue;
+        let x0 = sx;
+        let y0 = sy;
+        let x1 = sx;
+        let y1 = sy;
+        let px = 0;
+        const stack = [si];
+        seen[si] = 1;
+        while (stack.length > 0) {
+          const i = stack.pop();
+          const cx = i % width;
+          const cy = (i - cx) / width;
+          px += 1;
+          if (cx < x0) x0 = cx;
+          if (cy < y0) y0 = cy;
+          if (cx > x1) x1 = cx;
+          if (cy > y1) y1 = cy;
+          for (let dy = -1; dy <= 1; dy++) {
+            for (let dx = -1; dx <= 1; dx++) {
+              const nx = cx + dx;
+              const ny = cy + dy;
+              if (nx < 0 || ny < 0 || nx >= width || ny >= height) continue;
+              const ni = width * ny + nx;
+              if (candidate[ni] === 1 && seen[ni] === 0) {
+                seen[ni] = 1;
+                stack.push(ni);
+              }
+            }
+          }
+        }
+        if (px >= ABSENT_MIN_PX) found.push({ x: x0, y: y0, w: x1 - x0 + 1, h: y1 - y0 + 1, px, memberX: sx, memberY: sy });
+      }
+    }
+  }
+  const merged = [];
+  for (const c of found.sort((c1, c2) => c2.px - c1.px)) {
+    const overlaps = merged.some((m) => c.x < m.x + m.w && m.x < c.x + c.w && c.y < m.y + m.h && m.y < c.y + c.h);
+    if (!overlaps) merged.push(c);
+  }
+  return merged;
+}
+function zoomCrop(png, rect, scale = 8, pad = 6) {
+  const src = PNG.sync.read(Buffer.from(png));
+  const x0 = Math.max(0, rect.x - pad);
+  const y0 = Math.max(0, rect.y - pad);
+  const x1 = Math.min(src.width, rect.x + rect.w + pad);
+  const y1 = Math.min(src.height, rect.y + rect.h + pad);
+  const w = Math.max(1, x1 - x0);
+  const h = Math.max(1, y1 - y0);
+  const out = new PNG({ width: w * scale, height: h * scale });
+  for (let y = 0; y < h * scale; y++) {
+    for (let x = 0; x < w * scale; x++) {
+      const sx = x0 + Math.floor(x / scale);
+      const sy = y0 + Math.floor(y / scale);
+      const si = (src.width * sy + sx) * 4;
+      const di = (out.width * y + x) * 4;
+      const alpha = src.data[si + 3] ?? 0;
+      out.data[di] = Math.round(((src.data[si] ?? 0) * alpha + 255 * (255 - alpha)) / 255);
+      out.data[di + 1] = Math.round(((src.data[si + 1] ?? 0) * alpha + 255 * (255 - alpha)) / 255);
+      out.data[di + 2] = Math.round(((src.data[si + 2] ?? 0) * alpha + 255 * (255 - alpha)) / 255);
+      out.data[di + 3] = 255;
+    }
+  }
+  return Uint8Array.from(PNG.sync.write(out));
+}
 function measureCanvasCoupling(ref, renderA, renderB, backdrop, box) {
   const rRaw = PNG.sync.read(Buffer.from(ref));
   const r = onCanvas(rRaw, rRaw.width, rRaw.height);
@@ -2606,11 +2712,13 @@ function cropPng(png, x, y, width, height) {
   }
   return new Uint8Array(PNG.sync.write(out));
 }
-var INK_DELTA;
+var INK_DELTA, ABSENT_RADIUS, ABSENT_MIN_PX;
 var init_image_diff = __esm({
   "packages/verify/src/image-diff.ts"() {
     "use strict";
     INK_DELTA = 30;
+    ABSENT_RADIUS = 3;
+    ABSENT_MIN_PX = 6;
   }
 });
 
@@ -4215,6 +4323,31 @@ function chooseSeat(cropAt, ref, padW, padH, backdrop, origin, extents) {
   }
   return { comparison, seat, scored: cropAt(origin - seat.x, origin - seat.y) };
 }
+function deepestNodeNameAt(set, rep, px, py) {
+  let root;
+  try {
+    const text = JSON.parse(readFileSync8(path15.join(set, rep, "get_metadata.json"), "utf8")).content.map((c) => c.text ?? "").join("\n");
+    root = parseMetadataStructure(text);
+  } catch {
+    return void 0;
+  }
+  let best;
+  const walk2 = (node, ox, oy, isRoot) => {
+    if (node.hidden === true) return;
+    const nx = isRoot ? 0 : ox + (node.x ?? 0);
+    const ny = isRoot ? 0 : oy + (node.y ?? 0);
+    const w = node.width ?? 0;
+    const h = node.height ?? 0;
+    const contains = px >= nx && py >= ny && px < nx + w && py < ny + h;
+    if (contains && !isRoot && node.name !== "") {
+      const area = w * h;
+      if (best === void 0 || area <= best.area) best = { name: `${node.name} (${node.id})`, area };
+    }
+    for (const child of node.children) walk2(child, nx, ny, false);
+  };
+  walk2(root, 0, 0, true);
+  return best?.name;
+}
 function repMeta(set, rep) {
   const text = JSON.parse(readFileSync8(path15.join(set, rep, "get_metadata.json"), "utf8")).content.map((c) => c.text ?? "").join("\n");
   const root = parseMetadataStructure(text);
@@ -4335,10 +4468,18 @@ body{margin:0;background:rgb(${backdrop.join(",")})}
           const slab = realPadBoth && coupling.padCorners.masked >= 8 && coupling.padCorners.opaque / coupling.padCorners.masked >= 0.9;
           const pass = r.similarity >= bar.sim && r.inkRecall >= bar.ink && !slab;
           const region = pass ? void 0 : localizeDifference(scored, ref);
+          const absent = absentInkClusters(scored, ref, backdrop).map((c) => {
+            const name = deepestNodeNameAt(task.set, cfg.rep, c.memberX - seat.x, c.memberY - seat.y);
+            return name === void 0 ? c : { ...c, name };
+          });
           if (opts.evidenceDir !== void 0) {
             writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-render.png`), scored);
             writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-ref.png`), ref);
             writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-diff.png`), diffPng(scored, ref));
+            for (const [i, c] of absent.slice(0, 3).entries()) {
+              writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-absent-${i}-ref.png`), zoomCrop(ref, c));
+              writeFileSync6(path15.join(opts.evidenceDir, `${cfg.rep}-absent-${i}-render.png`), zoomCrop(scored, c));
+            }
           }
           return {
             rep: cfg.rep,
@@ -4349,6 +4490,7 @@ body{margin:0;background:rgb(${backdrop.join(",")})}
             ...slab ? { error: `paints the page canvas to the pad corners (${coupling.padCorners.opaque}/${coupling.padCorners.masked} opaque) \u2014 a square slab carrying the recorded canvas past the frame, wrong on any real page` } : {},
             ...region === void 0 ? {} : { region: { x0: region.x0, y0: region.y0, x1: region.x1, y1: region.y1, density: Math.round(region.density * 100) / 100 } },
             ...seat.x === 0 && seat.y === 0 ? {} : { seat },
+            ...absent.length > 0 ? { absentInk: absent } : {},
             ...coupling.padMasked + coupling.inBoxMasked > 0 ? { canvasCoupling: coupling } : {}
           };
         } finally {
@@ -8052,6 +8194,7 @@ OVERLAYS GO IN THE TOP LAYER, NOT ON A Z-INDEX. The prelude requires isolation:
 
 PAINT & PLATFORM TRAPS (each measured on a paid run; every one passed typecheck, token lint, and all behaviour checks and was caught only by pixels or by use):
 - A composite custom property resolves on the element that DECLARES it. A composite token (e.g. --ring: 0 0 0 var(--w) var(--c)) may only reference variables declared at or above its own declaration site \u2014 declared higher while its parts are set on the component, it is invalid-at-computed-value-time and the property silently computes to nothing (measured: a hover ring vanished; three configs at ~0.78).
+- An <svg> inside an absolutely-positioned glyph layer defaults to display: inline \u2014 it seats on a text baseline, its painted content lands BELOW the box the layout allocated, and an overflow: hidden ancestor clips the displaced ink away entirely. Large glyphs survive; small marks (a 2px dot, a 1.5px stem) vanish while every geometry probe reports the boxes correct (measured: 12/16 configs shipped icons missing their inner marks, certified at ink 0.9995). Set display: block on every glyph svg.
 - Chrome pixel-snaps an <svg> root's paint offset. A fractional inset on an svg element floors to a whole pixel and moves a hairline a full pixel; express fractional placement as transform: scale() about an integer-origin frame (measured: 0.943 \u2192 1.000 on six configs).
 - Pre-composite translucent values over the ACTUAL parent surface, read off the reference pixels \u2014 a control sitting on an elevated surface composites against that surface, not against the page.
 - A native <dialog> carries user-agent padding: 1em. Override every side, or the root grows past its recorded box and every band inside shifts.
@@ -8880,9 +9023,15 @@ async function runVerify(opts) {
   const statuses = [
     ...scores.map((s) => {
       const { exact: _exact, ...reported } = s;
-      const base = { ...reported, status: tierOf(s, BARS2.cert) };
+      let status = tierOf(s, BARS2.cert);
+      const certDemote = [];
+      if (status === "certified" && s.absentInk !== void 0 && s.absentInk.length > 0) {
+        status = "pass";
+        certDemote.push(...s.absentInk.map((c) => `absent ink: ${c.name ?? "unnamed region"} \u2014 ${c.px}px of recorded ink with no render ink within reach (missing or invisible feature)`));
+      }
+      const base = certDemote.length > 0 ? { ...reported, status, demotedBy: certDemote } : { ...reported, status };
       const reasons = demotions.get(s.rep);
-      return reasons === void 0 ? base : { ...base, status: "fail", demotedBy: reasons };
+      return reasons === void 0 ? base : { ...base, status: "fail", demotedBy: [...certDemote.length > 0 ? certDemote : [], ...reasons] };
     }),
     // ADR-010 §2 anti-gaming: recorded configs the adapter does not map
     // are FAILs, never silently absent.
@@ -9084,12 +9233,12 @@ function resolveEngineTask(opts, callerCwd) {
   const asPath = path32.resolve(callerCwd, opts.taskOrSet);
   const isSet = existsSync26(path32.join(asPath, "recording-set.json"));
   const registry = TASKS[opts.taskOrSet];
-  if (registry !== void 0 && !isSet) return { task: registry, name: opts.taskOrSet };
+  if (registry !== void 0 && !isSet) return { task: registry, name: opts.taskOrSet, disclosures: [] };
   if (isSet) {
     try {
       const authored = authorTaskFromSet(asPath);
       for (const d of authored.disclosures) warn(opts, d);
-      return { task: authored.task, name: path32.basename(asPath), apiPin: { props: authored.api.apiPin.props, forcedStates: authored.api.apiPin.forcedStates } };
+      return { task: authored.task, name: path32.basename(asPath), disclosures: authored.disclosures, apiPin: { props: authored.api.apiPin.props, forcedStates: authored.api.apiPin.forcedStates } };
     } catch (err) {
       fail(opts, ExitCode.InputValidation, {
         error: `cannot author a task from ${asPath}: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}`,
@@ -9107,9 +9256,13 @@ function resolveEngineTask(opts, callerCwd) {
 function runEngineBrief(opts) {
   requireEntitlement(opts);
   const callerCwd = process.env["INIT_CWD"] ?? process.cwd();
-  const { task, name } = resolveEngineTask(opts, callerCwd);
+  const { task, name, disclosures } = resolveEngineTask(opts, callerCwd);
   const bar = BARS3[opts.bar];
-  const brief = buildBrief(task.systemApi, bar, { colorScheme: recordingIsDark(task) ? "dark" : "light" });
+  const disclosureBlock = disclosures.length > 0 ? `
+
+=== RECORDED-SET DISCLOSURES (facts about this task's coverage \u2014 read them) ===
+${disclosures.map((d) => `- ${d}`).join("\n")}` : "";
+  const brief = buildBrief(task.systemApi, bar, { colorScheme: recordingIsDark(task) ? "dark" : "light" }) + disclosureBlock;
   const segments = buildSegments(task, "files");
   let notRecorded;
   const manifestPath2 = path32.join(task.set, "recording-set.json");
@@ -9249,9 +9402,14 @@ ${[
   const allPass = obj[0] === total && total > 0;
   const certBar = BARS3["cert"];
   const parityDemoted = new Set(parity.filter((p) => !p.pass).map((p) => p.id.replace(/^parity:/, "")));
-  const certifiedReps = scores.filter((sc) => tierOf(sc, certBar) === "certified" && !parityDemoted.has(sc.rep)).map((sc) => sc.rep);
+  const certifiedReps = scores.filter((sc) => tierOf(sc, certBar) === "certified" && !parityDemoted.has(sc.rep) && (sc.absentInk === void 0 || sc.absentInk.length === 0)).map((sc) => sc.rep);
   const certifiedSet = new Set(certifiedReps);
-  const certificationFeedback = `
+  const absentFindings = scores.flatMap((sc) => (sc.absentInk ?? []).map((c) => `- ${sc.rep}: ${c.name ?? "unnamed region"} \u2014 ${c.px}px of recorded ink with NO render ink within reach at [x ${c.x}-${c.x + c.w}, y ${c.y}-${c.y + c.h}] (missing or invisible feature; magnified crops in the evidence dir; coordinates are reference-space \u2014 subtract the config's seat for box-space). A certified-tier config with such a finding is demoted to pass.`));
+  const absentBlock = absentFindings.length > 0 ? `
+
+MISSING FEATURES (absent-ink clusters \u2014 recorded ink your render leaves nowhere near covered; fix these first, the global numbers cannot see them):
+${absentFindings.join("\n")}` : "";
+  const certificationFeedback = `${absentBlock}
 
 CERTIFICATION: ${certifiedReps.length}/${scores.length} configs at the certification bar (sim \u2265${certBar.sim} AND ink \u2265${certBar.ink}, exact values, after parity demotion \u2014 composition checks at verify can demote further).${certifiedReps.length < scores.length ? ` Below cert: ${scores.filter((sc) => !certifiedSet.has(sc.rep)).map((sc) => sc.rep).join(", ")}.` : ""}
 METRIC DEADBAND (read before iterating on near-misses): the scored similarity/ink deliberately tolerate \xB11px edge shift and antialiased-edge differences \u2014 cross-rasterizer noise absorption. A change entirely inside that band moves these numbers by EXACTLY ZERO (working as designed, not a stuck scorer). The per-config \`exact\` fields in the JSON are tolerance-free and move first: compare exact across rounds to confirm a small fix landed, and stop iterating when only exact moves \u2014 the bar reads the tolerant numbers.`;
@@ -9286,7 +9444,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,
-      certification: { certified: certifiedReps.length, total: scores.length, bar: certBar, note: "tierOf on exact values + parity demotion; verify's composition checks can demote further" }
+      certification: { certified: certifiedReps.length, total: scores.length, bar: certBar, note: "tierOf on exact values + parity and absent-ink demotion; verify's composition checks can demote further" }
     },
     () => {
       for (const s of scores) process.stdout.write(`${s.pass ? certifiedSet.has(s.rep) ? "CERT" : "PASS" : "FAIL"} ${s.rep}: sim=${s.similarity} ink=${s.inkRecall}${s.error !== void 0 ? ` [${s.error}]` : ""}

package/package.json

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