@aayambansal/squint 0.4.7 → 0.5.0

package/README.md

@@ -174,6 +174,12 @@ squint doctor --probe             # run every engine end to end, verify auth act
   flagged from the live page, and on Next 16+ the framework's own `/_next/mcp`
   channel feeds structured errors straight into the fix loop. `/context` itemizes
   the injected-context bill per source, with staleness warnings.
+- **Two more doors in**: `squint mcp` serves the gates as MCP tools (any
+  MCP-speaking agent calls squint's verification directly); `squint ci` runs the
+  whole loop headlessly in a pipeline — JSON report, non-zero exit on hard findings.
+- **The sentinel**: gate evasion (deleted tests, added skips, suppressed
+  diagnostics, weakened checks, locked-path touches) detected deterministically per
+  turn and reported to you — never sent back to the engine that did it.
 - **Detachable sessions**: `squint serve` owns the session on a unix socket;
   `squint attach` joins from any terminal (observer seats for teammates, driver
   seat inherited on detach). Crash-proof, ssh-friendly, no cloud.

package/dist/{App-HWMVSRMF.js → App-MC2XEM7K.js}

@@ -1,23 +1,23 @@
 #!/usr/bin/env node
 import {
   App
-} from "./chunk-M25IQ7C7.js";
+} from "./chunk-EB4OSUB7.js";
 import "./chunk-43NQNIJY.js";
-import "./chunk-7MOKOZOR.js";
+import "./chunk-WASLLXEZ.js";
 import "./chunk-ARDV4XH6.js";
 import "./chunk-AUJJGMZG.js";
 import "./chunk-YHRAOBI2.js";
-import "./chunk-QCHBDP46.js";
-import "./chunk-YGSF2TSO.js";
-import "./chunk-VH7OOFQP.js";
+import "./chunk-2I3YHT6P.js";
+import "./chunk-J7ITMK6X.js";
+import "./chunk-6NPUVPQD.js";
 import "./chunk-K5QJMSJH.js";
 import "./chunk-WAJXATCO.js";
 import "./chunk-62JNF5M2.js";
-import "./chunk-ZSDCMYZR.js";
+import "./chunk-CRDRWTON.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-HC4E42SV.js";
-import "./chunk-IMDRXXFU.js";
-import "./chunk-KVYGPLWW.js";
+import "./chunk-DCFNX2CQ.js";
+import "./chunk-PYC53J7D.js";
+import "./chunk-GV2HAALP.js";
 export {
   App
 };

package/dist/{cdp-PBQKXC6R.js → cdp-WSWOSDEX.js}

@@ -2,12 +2,14 @@
 import {
   cdpCapture,
   hasWebSocket,
+  pixelDiffAttributed,
   pixelDiffPct,
   runFlow
-} from "./chunk-HC4E42SV.js";
+} from "./chunk-DCFNX2CQ.js";
 export {
   cdpCapture,
   hasWebSocket,
+  pixelDiffAttributed,
   pixelDiffPct,
   runFlow
 };

package/dist/{chrome-SBV3H77F.js → chrome-EEXJCG6W.js}

@@ -2,8 +2,8 @@
 import {
   findChrome,
   screenshot
-} from "./chunk-IMDRXXFU.js";
-import "./chunk-KVYGPLWW.js";
+} from "./chunk-PYC53J7D.js";
+import "./chunk-GV2HAALP.js";
 export {
   findChrome,
   screenshot

package/dist/{chunk-QCHBDP46.js → chunk-2I3YHT6P.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   variantsRoot
-} from "./chunk-YGSF2TSO.js";
+} from "./chunk-J7ITMK6X.js";
 import {
   findChrome,
   screenshot
-} from "./chunk-IMDRXXFU.js";
+} from "./chunk-PYC53J7D.js";
 import {
   lineSplitter
-} from "./chunk-KVYGPLWW.js";
+} from "./chunk-GV2HAALP.js";
 
 // src/variants/shots.ts
 import path2 from "path";

package/dist/{flows-6LK7NGWS.js → chunk-4XSHHGA6.js}

@@ -140,8 +140,9 @@ function stepExpression(step) {
       return null;
   }
 }
+
 export {
-  loadFlows,
   parseFlow,
+  loadFlows,
   stepExpression
 };

package/dist/{chunk-VH7OOFQP.js → chunk-6NPUVPQD.js}

@@ -3,7 +3,7 @@ import {
   findEngineBinary,
   lineSplitter,
   truncate
-} from "./chunk-KVYGPLWW.js";
+} from "./chunk-GV2HAALP.js";
 
 // src/runner/run.ts
 import { spawn } from "child_process";
@@ -21,7 +21,7 @@ function runAgent(engine, opts, onEvent, signal) {
     let stderrTail = "";
     const child = spawn(binaryPath, engine.buildArgs(opts), {
       cwd: opts.cwd,
-      env: process.env,
+      env: { ...process.env, ...engine.env },
       stdio: ["ignore", "pipe", "pipe"]
     });
     const emit = (event) => {

package/dist/{contextDoctor-A26C2ZDN.js → chunk-BKOGVFCO.js}

@@ -68,6 +68,7 @@ function formatContextReport(report) {
   }
   return out.join("\n");
 }
+
 export {
   contextReport,
   formatContextReport

package/dist/{chunk-ZSDCMYZR.js → chunk-CRDRWTON.js}

@@ -5,11 +5,11 @@ import {
 import {
   cdpCapture,
   hasWebSocket
-} from "./chunk-HC4E42SV.js";
+} from "./chunk-DCFNX2CQ.js";
 import {
   findChrome,
   screenshot
-} from "./chunk-IMDRXXFU.js";
+} from "./chunk-PYC53J7D.js";
 
 // src/preview/preview.ts
 import fs2 from "fs";
@@ -75,7 +75,7 @@ async function captureViewports(cwd, url) {
   if (hasWebSocket()) {
     try {
       const checks = loadChecks(cwd);
-      const { report, shots: shots2, a11y, slop, narration, phantoms, viewTransitions, components, checkFailures, webmcp } = await cdpCapture(chrome, url, dir, VIEWPORTS, 2500, true, checks);
+      const { report, shots: shots2, a11y, slop, narration, phantoms, viewTransitions, components, checkFailures, webmcp, jank } = await cdpCapture(chrome, url, dir, VIEWPORTS, 2500, true, checks);
       const errors2 = [];
       for (const route of routes.slice(1)) {
         try {
@@ -90,7 +90,7 @@ async function captureViewports(cwd, url) {
           errors2.push(`${route}: capture failed`);
         }
       }
-      return { shots: shots2, errors: errors2, runtime: report, a11y, slop, narration, phantoms, viewTransitions, components, checkFailures, webmcp };
+      return { shots: shots2, errors: errors2, runtime: report, a11y, slop, narration, phantoms, viewTransitions, components, checkFailures, webmcp, jank };
     } catch {
     }
   }
@@ -163,9 +163,15 @@ async function probeRuntime(url, cwd) {
 async function comparePulse(previous, current) {
   const chrome = findChrome();
   if (!chrome || !hasWebSocket()) return null;
-  const { pixelDiffPct } = await import("./cdp-PBQKXC6R.js");
+  const { pixelDiffPct } = await import("./cdp-WSWOSDEX.js");
   return pixelDiffPct(chrome, previous, current);
 }
+async function comparePulseAttributed(previous, current, url) {
+  const chrome = findChrome();
+  if (!chrome || !hasWebSocket()) return null;
+  const { pixelDiffAttributed } = await import("./cdp-WSWOSDEX.js");
+  return pixelDiffAttributed(chrome, previous, current, url);
+}
 function buildRuntimeFixPrompt(report) {
   return `The running app has runtime problems.${runtimeSection(report)}
 
@@ -191,6 +197,16 @@ ${narration.join("\n")}
 
 Judge this narration as an experience: does the reading order make sense? do names actually describe their targets? is anything announced as "(no accessible name)"? Fix real incoherence \u2014 this is how non-visual users meet the page.`;
 }
+function jankSection(jank) {
+  if (!jank || jank.length === 0) return "";
+  return `
+
+## Jank attribution (main-thread frames \u226550ms)
+
+${jank.join("\n")}
+
+Each line names the function behind a long animation frame observed during load and a scripted scroll. Fix the work (memoize, virtualize, move off the main thread) \u2014 do not remove the animation.`;
+}
 function webmcpSection(webmcp) {
   if (!webmcp || webmcp.length === 0) return "";
   return `
@@ -241,13 +257,13 @@ ${findings.join("\n")}
 
 These patterns make the page read as template output. Rework them within the committed design direction \u2014 this is style debt, not a defect list.`;
 }
-function buildReviewPrompt(shots, extra, runtime, a11y, slop, narration, phantoms, viewTransitions, components, webmcp) {
+function buildReviewPrompt(shots, extra, runtime, a11y, slop, narration, phantoms, viewTransitions, components, webmcp, jank) {
   const list = shots.map((s) => `- ${s.name}: ${s.path}`).join("\n");
   return `Screenshots of the running app were just captured:
 
 ${list}
 
-Read each screenshot and review the rendered UI against the design standards you were given. Check: visual hierarchy and spacing rhythm, typography, color and contrast, alignment, empty-looking or broken regions, and whether the mobile capture shows horizontal overflow or cramped layout. List the concrete issues you can SEE (not hypothetical ones), ranked by visual impact${extra ? `, with special attention to: ${extra}` : ""}. Then fix them and verify the app still builds.${runtimeSection(runtime)}${a11ySection(a11y)}${slopSection(slop)}${narrationSection(narration)}${phantomSection(phantoms)}${vtSection(viewTransitions)}${componentSection(components)}${webmcpSection(webmcp)}`;
+Read each screenshot and review the rendered UI against the design standards you were given. Check: visual hierarchy and spacing rhythm, typography, color and contrast, alignment, empty-looking or broken regions, and whether the mobile capture shows horizontal overflow or cramped layout. List the concrete issues you can SEE (not hypothetical ones), ranked by visual impact${extra ? `, with special attention to: ${extra}` : ""}. Then fix them and verify the app still builds.${runtimeSection(runtime)}${a11ySection(a11y)}${slopSection(slop)}${narrationSection(narration)}${phantomSection(phantoms)}${vtSection(viewTransitions)}${componentSection(components)}${webmcpSection(webmcp)}${jankSection(jank)}`;
 }
 
 export {
@@ -259,6 +275,7 @@ export {
   runtimeSummary,
   probeRuntime,
   comparePulse,
+  comparePulseAttributed,
   buildRuntimeFixPrompt,
   buildReviewPrompt
 };

package/dist/{chunk-HC4E42SV.js → chunk-DCFNX2CQ.js}

@@ -179,7 +179,7 @@ var describe = (value) => {
   return String(value);
 };
 async function runFlow(chromePath, baseUrl, flow, outDir) {
-  const { stepExpression } = await import("./flows-6LK7NGWS.js");
+  const { stepExpression } = await import("./flows-MXJL45HW.js");
   const { child, wsUrl, profileDir } = await launchChrome(chromePath);
   const shots = [];
   let connection = null;
@@ -189,6 +189,7 @@ async function runFlow(chromePath, baseUrl, flow, outDir) {
     const { sessionId } = await connection.send("Target.attachToTarget", { targetId, flatten: true });
     await connection.send("Page.enable", {}, sessionId);
     await connection.send("Page.addScriptToEvaluateOnNewDocument", { source: WEBMCP_SHIM }, sessionId).catch(() => null);
+    await connection.send("Page.addScriptToEvaluateOnNewDocument", { source: LOAF_SHIM }, sessionId).catch(() => null);
     await connection.send(
       "Emulation.setDeviceMetricsOverride",
       { width: 1280, height: 800, deviceScaleFactor: 1, mobile: false },
@@ -237,6 +238,145 @@ async function runFlow(chromePath, baseUrl, flow, outDir) {
     setTimeout(() => fs.rmSync(profileDir, { recursive: true, force: true }), 500).unref?.();
   }
 }
+async function pixelDiffAttributed(chromePath, pngA, pngB, url) {
+  const { child, wsUrl, profileDir } = await launchChrome(chromePath);
+  let connection = null;
+  try {
+    connection = await CdpConnection.connect(wsUrl, 1e4);
+    const { targetId } = await connection.send("Target.createTarget", { url: "about:blank" });
+    const { sessionId } = await connection.send("Target.attachToTarget", { targetId, flatten: true });
+    await connection.send("Runtime.enable", {}, sessionId);
+    const expression = `(async () => {
+      const load = (src) => new Promise((resolve, reject) => {
+        const img = new Image();
+        img.onload = () => resolve(img);
+        img.onerror = () => reject(new Error('decode'));
+        img.src = src;
+      });
+      const a = await load('data:image/png;base64,${pngA.toString("base64")}');
+      const b = await load('data:image/png;base64,${pngB.toString("base64")}');
+      const w = Math.min(a.width, b.width), h = Math.min(a.height, b.height);
+      if (w === 0 || h === 0) return null;
+      const draw = (img) => {
+        const c = document.createElement('canvas');
+        c.width = w; c.height = h;
+        const ctx = c.getContext('2d');
+        ctx.drawImage(img, 0, 0);
+        return ctx.getImageData(0, 0, w, h).data;
+      };
+      const da = draw(a), db = draw(b);
+      const CELL = 32;
+      const gw = Math.ceil(w / CELL), gh = Math.ceil(h / CELL);
+      const marked = new Uint8Array(gw * gh);
+      let differ = 0, total = 0;
+      for (let y = 0; y < h; y += 2) {
+        for (let x = 0; x < w; x += 2) {
+          total++;
+          const i = (y * w + x) * 4;
+          if (Math.abs(da[i] - db[i]) > 8 || Math.abs(da[i + 1] - db[i + 1]) > 8 || Math.abs(da[i + 2] - db[i + 2]) > 8) {
+            differ++;
+            marked[Math.floor(y / CELL) * gw + Math.floor(x / CELL)] = 1;
+          }
+        }
+      }
+      // Flood-fill marked cells into region bounding boxes.
+      const seen = new Uint8Array(gw * gh);
+      const regions = [];
+      for (let cy = 0; cy < gh; cy++) {
+        for (let cx = 0; cx < gw; cx++) {
+          const start = cy * gw + cx;
+          if (!marked[start] || seen[start]) continue;
+          let minX = cx, maxX = cx, minY = cy, maxY = cy, cells = 0;
+          const stack = [start];
+          seen[start] = 1;
+          while (stack.length) {
+            const cell = stack.pop();
+            const x = cell % gw, y = Math.floor(cell / gw);
+            cells++;
+            if (x < minX) minX = x; if (x > maxX) maxX = x;
+            if (y < minY) minY = y; if (y > maxY) maxY = y;
+            for (const [dx, dy] of [[1,0],[-1,0],[0,1],[0,-1]]) {
+              const nx = x + dx, ny = y + dy;
+              if (nx < 0 || ny < 0 || nx >= gw || ny >= gh) continue;
+              const n = ny * gw + nx;
+              if (marked[n] && !seen[n]) { seen[n] = 1; stack.push(n); }
+            }
+          }
+          regions.push({
+            x: minX * CELL, y: minY * CELL,
+            w: Math.min(w, (maxX + 1) * CELL) - minX * CELL,
+            h: Math.min(h, (maxY + 1) * CELL) - minY * CELL,
+            cells,
+          });
+        }
+      }
+      regions.sort((p, q) => q.cells - p.cells);
+      const sizePenalty = (a.width !== b.width || a.height !== b.height) ? 1 : 0;
+      return { pct: Math.min(100, (differ / total) * 100 + sizePenalty), regions: regions.slice(0, 5), w, h };
+    })()`;
+    const { result } = await connection.send(
+      "Runtime.evaluate",
+      { expression, awaitPromise: true, returnByValue: true },
+      sessionId
+    );
+    const value = result?.value;
+    if (!value || typeof value.pct !== "number") return null;
+    if (!url || value.regions.length === 0 || value.pct < 0.5) return { pct: value.pct, sentences: [] };
+    let sentences = [];
+    try {
+      const page = await connection.send("Target.createTarget", { url: "about:blank" });
+      const attach = await connection.send("Target.attachToTarget", { targetId: page.targetId, flatten: true });
+      const pageSession = attach.sessionId;
+      await connection.send("Runtime.enable", {}, pageSession);
+      await connection.send("Page.enable", {}, pageSession);
+      await connection.send(
+        "Emulation.setDeviceMetricsOverride",
+        { width: value.w, height: value.h, deviceScaleFactor: 1, mobile: false },
+        pageSession
+      );
+      await connection.send("Page.navigate", { url }, pageSession);
+      await new Promise((resolve) => setTimeout(resolve, 1200));
+      const hitTest = `((regions) => regions.map((r) => {
+        const el = document.elementsFromPoint(r.x + r.w / 2, r.y + r.h / 2)
+          .find((e) => e !== document.documentElement && e !== document.body);
+        const where = r.w + '\xD7' + r.h + ' region @ (' + r.x + ',' + r.y + ')';
+        if (!el) return where + ' changed';
+        let label = el.tagName.toLowerCase();
+        if (el.id) label += '#' + el.id;
+        else if (el.classList[0]) label += '.' + el.classList[0];
+        const key = Object.keys(el).find((k) => k.startsWith('__reactFiber$'));
+        let chain = '';
+        if (key) {
+          let fiber = el[key];
+          const names = [];
+          let hops = 0;
+          while (fiber && hops < 50 && names.length < 2) {
+            const t = fiber.type;
+            const n = typeof t === 'function' ? (t.displayName || t.name || '') : '';
+            if (n && !names.includes(n)) names.push(n);
+            fiber = fiber.return; hops++;
+          }
+          chain = names.join(' < ');
+        }
+        return '<' + label + '>' + (chain ? ' (' + chain + ')' : '') + ': ' + where + ' changed';
+      }))(${JSON.stringify(value.regions)})`;
+      const hit = await connection.send(
+        "Runtime.evaluate",
+        { expression: hitTest, returnByValue: true },
+        pageSession
+      );
+      if (Array.isArray(hit.result?.value)) sentences = hit.result.value.map(String);
+    } catch {
+    }
+    return { pct: value.pct, sentences };
+  } catch {
+    return null;
+  } finally {
+    connection?.close();
+    child.kill("SIGKILL");
+    setTimeout(() => fs.rmSync(profileDir, { recursive: true, force: true }), 500).unref?.();
+  }
+}
 async function pixelDiffPct(chromePath, pngA, pngB) {
   const { child, wsUrl, profileDir } = await launchChrome(chromePath);
   let connection = null;
@@ -297,6 +437,42 @@ var SLOP_AUDIT = `(() => {
       break;
     }
   }
+  // APCA (the contrast model that graduated in DevTools 149): body text
+  // under |Lc| 60 reads as fog even when it squeaks past WCAG AA.
+  const chan = (v) => Math.pow(v / 255, 2.4);
+  const lum = (rgb) => {
+    const m = rgb.match(/rgba?\\(([\\d.]+)[,\\s]+([\\d.]+)[,\\s]+([\\d.]+)/);
+    if (!m) return null;
+    return 0.2126729 * chan(+m[1]) + 0.7151522 * chan(+m[2]) + 0.0721750 * chan(+m[3]);
+  };
+  const apca = (txt, bg) => {
+    let yt = lum(txt), yb = lum(bg);
+    if (yt === null || yb === null) return null;
+    const clamp = (y) => (y < 0.022 ? y + Math.pow(0.022 - y, 1.414) : y);
+    yt = clamp(yt); yb = clamp(yb);
+    const c = yb > yt ? (Math.pow(yb, 0.56) - Math.pow(yt, 0.57)) * 1.14 : (Math.pow(yb, 0.65) - Math.pow(yt, 0.62)) * 1.14;
+    return Math.abs(c) < 0.1 ? 0 : Math.round((Math.abs(c) - 0.027) * 100);
+  };
+  let apcaFlagged = 0;
+  for (const p of document.querySelectorAll('p, li, td, span')) {
+    if (apcaFlagged >= 2) break;
+    const text = (p.textContent || '').trim();
+    if (text.length < 40) continue;
+    const cs = getComputedStyle(p);
+    if (parseFloat(cs.fontSize) >= 24) continue;
+    let bgEl = p, bg = 'rgba(0, 0, 0, 0)';
+    while (bgEl) {
+      const b = getComputedStyle(bgEl).backgroundColor;
+      if (b && !b.includes('0, 0, 0, 0')) { bg = b; break; }
+      bgEl = bgEl.parentElement;
+    }
+    if (bg.includes('0, 0, 0, 0')) bg = 'rgb(255, 255, 255)';
+    const lc = apca(cs.color, bg);
+    if (lc !== null && lc > 0 && lc < 60) {
+      out.push('low APCA contrast: Lc ' + lc + ' on <' + p.tagName.toLowerCase() + '> body text ("' + text.slice(0, 40) + '\u2026") \u2014 fog, not elegance');
+      apcaFlagged++;
+    }
+  }
   const vw = innerWidth, vh = innerHeight;
   for (const el of document.querySelectorAll('*')) {
     const r = el.getBoundingClientRect();
@@ -457,6 +633,40 @@ var WEBMCP_SHIM = `(() => {
   wrap(document.modelContext || (document.modelContext = {}));
   wrap(navigator.modelContext || (navigator.modelContext = {}));
 })()`;
+var LOAF_SHIM = `(() => {
+  window.__squintLoaf = [];
+  try {
+    new PerformanceObserver((list) => {
+      for (const e of list.getEntries()) {
+        if (e.duration < 50) continue;
+        const s = (e.scripts && e.scripts[0]) || {};
+        window.__squintLoaf.push({
+          duration: Math.round(e.duration),
+          fn: s.sourceFunctionName || '',
+          url: (s.sourceURL || s.name || '').split('/').pop() || '',
+          invoker: s.invoker || '',
+        });
+      }
+    }).observe({ type: 'long-animation-frame', buffered: true });
+  } catch {}
+})()`;
+var SCRIPTED_SCROLL = `(async () => {
+  const half = Math.max(0, (document.body.scrollHeight - innerHeight) / 2);
+  window.scrollTo({ top: half, behavior: 'smooth' });
+  await new Promise((r) => setTimeout(r, 400));
+  window.scrollTo({ top: 0, behavior: 'smooth' });
+  await new Promise((r) => setTimeout(r, 300));
+  const seen = new Map();
+  for (const e of window.__squintLoaf || []) {
+    const key = e.fn + '@' + e.url + '@' + e.invoker;
+    const prev = seen.get(key);
+    if (!prev || e.duration > prev.duration) seen.set(key, e);
+  }
+  return [...seen.values()]
+    .sort((a, b) => b.duration - a.duration)
+    .slice(0, 6)
+    .map((e) => e.duration + 'ms frame \u2014 ' + (e.fn || e.invoker || 'script') + (e.url ? ' @ ' + e.url : ''));
+})()`;
 async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, audit = false, checks = []) {
   const { child, wsUrl, profileDir } = await launchChrome(chromePath);
   const report = { consoleErrors: [], pageErrors: [], failedRequests: [] };
@@ -470,6 +680,7 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
   let components = [];
   const checkFailures = [];
   let webmcp = [];
+  let jank = [];
   const requests = /* @__PURE__ */ new Map();
   let connection = null;
   try {
@@ -509,6 +720,7 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
     await connection.send("Network.enable", {}, sessionId);
     await connection.send("Page.enable", {}, sessionId);
     await connection.send("Page.addScriptToEvaluateOnNewDocument", { source: WEBMCP_SHIM }, sessionId).catch(() => null);
+    await connection.send("Page.addScriptToEvaluateOnNewDocument", { source: LOAF_SHIM }, sessionId).catch(() => null);
     await connection.send("Page.navigate", { url }, sessionId);
     const deadline = Date.now() + 12e3;
     while (!loaded && Date.now() < deadline) {
@@ -524,6 +736,15 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
       if (result?.value && typeof result.value === "object") perf = result.value;
     } catch {
     }
+    try {
+      const { result } = await connection.send(
+        "Runtime.evaluate",
+        { expression: SCRIPTED_SCROLL, returnByValue: true, awaitPromise: true },
+        sessionId
+      );
+      if (Array.isArray(result?.value)) jank = result.value.map(String);
+    } catch {
+    }
     try {
       const { result } = await connection.send(
         "Runtime.evaluate",
@@ -643,7 +864,10 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
         {
           width: viewport.width,
           height: viewport.height,
-          deviceScaleFactor: 1,
+          // 2x for review shots: sub-pixel border/kerning slop is
+          // invisible at 1x. The pulse stays 1x — its diff math and
+          // hit-testing assume CSS pixels.
+          deviceScaleFactor: viewport.name === "pulse" ? 1 : 2,
           mobile: viewport.width < 500
         },
         sessionId
@@ -659,12 +883,13 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
     child.kill("SIGKILL");
     setTimeout(() => fs.rmSync(profileDir, { recursive: true, force: true }), 500).unref?.();
   }
-  return { report, shots, a11y, slop, perf, narration, phantoms, viewTransitions, components, checkFailures, webmcp };
+  return { report, shots, a11y, slop, perf, narration, phantoms, viewTransitions, components, checkFailures, webmcp, jank };
 }
 
 export {
   hasWebSocket,
   runFlow,
+  pixelDiffAttributed,
   pixelDiffPct,
   cdpCapture
 };

package/dist/{chunk-M25IQ7C7.js → chunk-EB4OSUB7.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-43NQNIJY.js";
 import {
   Session
-} from "./chunk-7MOKOZOR.js";
+} from "./chunk-WASLLXEZ.js";
 
 // src/tui/App.tsx
 import { Box as Box3, Static, Text as Text3, useApp, useInput } from "ink";

package/dist/{chunk-KVYGPLWW.js → chunk-GV2HAALP.js}

@@ -148,6 +148,10 @@ var claude = {
   binary: "claude",
   install: "npm install -g @anthropic-ai/claude-code",
   supportsResume: true,
+  // 2.1.211+: subagent output joins stream-json. The env-var form is a
+  // no-op on older CLIs, unlike the flag, so the loops see spawned work
+  // wherever it's supported.
+  env: { CLAUDE_CODE_FORWARD_SUBAGENT_TEXT: "1" },
   buildArgs(opts) {
     const permissionMode = opts.mode === "plan" ? "plan" : opts.mode === "yolo" ? "bypassPermissions" : "acceptEdits";
     const args = [

package/dist/{chunk-YGSF2TSO.js → chunk-J7ITMK6X.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runAgent
-} from "./chunk-VH7OOFQP.js";
+} from "./chunk-6NPUVPQD.js";
 import {
   FAMILIES,
   renderFamilyBrief

package/dist/{chunk-IMDRXXFU.js → chunk-PYC53J7D.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   findBinary
-} from "./chunk-KVYGPLWW.js";
+} from "./chunk-GV2HAALP.js";
 
 // src/preview/chrome.ts
 import { spawn } from "child_process";

package/dist/{chunk-7MOKOZOR.js → chunk-WASLLXEZ.js}

@@ -23,16 +23,16 @@ import {
   buildFixPrompt,
   detectDevCommand,
   screenshotVariants
-} from "./chunk-QCHBDP46.js";
+} from "./chunk-2I3YHT6P.js";
 import {
   applyVariant,
   cleanVariants,
   listVariants,
   runVariants
-} from "./chunk-YGSF2TSO.js";
+} from "./chunk-J7ITMK6X.js";
 import {
   runAgent
-} from "./chunk-VH7OOFQP.js";
+} from "./chunk-6NPUVPQD.js";
 import {
   composePrompt
 } from "./chunk-WAJXATCO.js";
@@ -46,10 +46,10 @@ import {
   buildReviewPrompt,
   buildRuntimeFixPrompt,
   captureViewports,
-  comparePulse,
+  comparePulseAttributed,
   probeRuntime,
   runtimeSummary
-} from "./chunk-ZSDCMYZR.js";
+} from "./chunk-CRDRWTON.js";
 import {
   clearState,
   loadState,
@@ -57,10 +57,10 @@ import {
 } from "./chunk-7CAGWFAQ.js";
 import {
   findChrome
-} from "./chunk-IMDRXXFU.js";
+} from "./chunk-PYC53J7D.js";
 import {
   getEngine
-} from "./chunk-KVYGPLWW.js";
+} from "./chunk-GV2HAALP.js";
 
 // src/session/engine.ts
 import fs2 from "fs";
@@ -267,7 +267,7 @@ ${question}`,
         return;
       }
       await this.runTurn(
-        buildReviewPrompt(result.shots, void 0, result.runtime, result.a11y, result.slop, result.narration, result.phantoms, result.viewTransitions, result.components, result.webmcp),
+        buildReviewPrompt(result.shots, void 0, result.runtime, result.a11y, result.slop, result.narration, result.phantoms, result.viewTransitions, result.components, result.webmcp, result.jank),
         `\u{1F441} polish round ${round}/${rounds}`
       );
     }
@@ -509,6 +509,17 @@ ${driftSummary(drift)}`);
           }
         } catch {
         }
+        try {
+          const { scanEvasion, sentinelSummary } = await import("./sentinel-42NZRTTS.js");
+          const evasions = scanEvasion(this.execCwd(), checkpoint.snapshot.stashHash ?? "HEAD");
+          if (evasions.length > 0) {
+            this.push("error", `\u26A0 sentinel: ${evasions.length} gate-evasion pattern(s) this turn
+${sentinelSummary(evasions)}
+Review before trusting green \u2014 /undo rolls the turn back.`);
+            runHook(this.opts.cwd, "on-sentinel", { count: String(evasions.length), summary: sentinelSummary(evasions) });
+          }
+        } catch {
+        }
         try {
           const { rulePackSummary, scanRulePacks } = await import("./rulepacks-JOA675OJ.js");
           const findings = scanRulePacks(this.execCwd(), checkpoint.snapshot.stashHash ?? "HEAD");
@@ -647,7 +658,7 @@ ${probe.checkFailures.slice(0, 5).join("\n")}`);
               const captureResult = await this.capture();
               if (captureResult) {
                 await this.runTurn(
-                  buildReviewPrompt(captureResult.shots, void 0, captureResult.runtime, captureResult.a11y, captureResult.slop, captureResult.narration, captureResult.phantoms, captureResult.viewTransitions, captureResult.components, captureResult.webmcp),
+                  buildReviewPrompt(captureResult.shots, void 0, captureResult.runtime, captureResult.a11y, captureResult.slop, captureResult.narration, captureResult.phantoms, captureResult.viewTransitions, captureResult.components, captureResult.webmcp, captureResult.jank),
                   "\u{1F441} auto-review rendered UI"
                 );
               }
@@ -744,11 +755,13 @@ ${probe.checkFailures.slice(0, 5).join("\n")}`);
       this.push("image", pulsePath);
       return null;
     }
-    const pct = await comparePulse(previous, current);
-    if (pct === null) return null;
+    const diff = await comparePulseAttributed(previous, current, this.state.devUrl ?? void 0);
+    if (diff === null) return null;
+    const pct = diff.pct;
     this.push(
       "status",
-      pct < 0.5 ? "visual pulse: stable vs last turn" : `visual pulse: ${pct.toFixed(1)}% of the page changed vs last turn`
+      pct < 0.5 ? "visual pulse: stable vs last turn" : `visual pulse: ${pct.toFixed(1)}% of the page changed vs last turn${diff.sentences.length > 0 ? `
+${diff.sentences.map((s) => `  ${s}`).join("\n")}` : ""}`
     );
     runHook(this.opts.cwd, "on-pulse-diff", { pct: pct.toFixed(1) });
     if (pct >= 0.5) this.push("image", pulsePath);
@@ -846,7 +859,7 @@ They are objective defects, not style preferences.`
     const arg = rest.join(" ").trim();
     switch (name) {
       case "engines": {
-        void import("./registry-MIJ6LSAY.js").then(({ detectEngines }) => {
+        void import("./registry-JBP7J3JB.js").then(({ detectEngines }) => {
           const lines = detectEngines().map(({ engine, path: binaryPath }) => {
             const mark = binaryPath ? "\u2713" : "\u2717";
             const traits = [engine.createParser ? "stream" : "text", engine.supportsResume ? "resume" : null].filter(Boolean).join(" \xB7 ");
@@ -935,7 +948,7 @@ They are objective defects, not style preferences.`
         break;
       }
       case "context": {
-        import("./contextDoctor-A26C2ZDN.js").then(({ contextReport, formatContextReport }) => {
+        import("./contextDoctor-3Y36YURE.js").then(({ contextReport, formatContextReport }) => {
           this.push("status", formatContextReport(contextReport(this.execCwd())));
         }).catch((error) => {
           this.push("status", `context report failed: ${error instanceof Error ? error.message : String(error)}`);
@@ -1059,7 +1072,7 @@ They are objective defects, not style preferences.`
           break;
         }
         void (async () => {
-          const { loadFlows } = await import("./flows-6LK7NGWS.js");
+          const { loadFlows } = await import("./flows-MXJL45HW.js");
           const flows = loadFlows(this.opts.cwd);
           if (flows.length === 0) {
             this.push("status", "no flows \u2014 add .squint/flows/<name>.flow (goto/click/fill/press/expect/shot lines), or ask the engine to write one");
@@ -1070,8 +1083,8 @@ They are objective defects, not style preferences.`
             this.push("error", "no Chrome/Chromium found for flows");
             return;
           }
-          const { runFlow } = await import("./cdp-PBQKXC6R.js");
-          const { previewDir } = await import("./preview-WT34NVCH.js");
+          const { runFlow } = await import("./cdp-WSWOSDEX.js");
+          const { previewDir } = await import("./preview-CDEMPHWV.js");
           this.push("status", `replaying ${flows.length} flow(s)\u2026`);
           this.notify({ running: true, runStartedAt: Date.now() });
           const failures = [];
@@ -1209,7 +1222,7 @@ They are objective defects, not style preferences.`
           const result = await this.capture();
           if (result) {
             await this.runTurn(
-              buildReviewPrompt(result.shots, arg || void 0, result.runtime, result.a11y, result.slop, result.narration, result.phantoms, result.viewTransitions, result.components, result.webmcp),
+              buildReviewPrompt(result.shots, arg || void 0, result.runtime, result.a11y, result.slop, result.narration, result.phantoms, result.viewTransitions, result.components, result.webmcp, result.jank),
               `\u{1F441} review rendered UI${arg ? ` \xB7 ${arg}` : ""}`
             );
           }

package/dist/{chunk-NX7XQY2X.js → chunk-YK5DEB7T.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   Session
-} from "./chunk-7MOKOZOR.js";
+} from "./chunk-WASLLXEZ.js";
 
 // src/daemon/client.ts
 import net from "net";

package/dist/cli.js

@@ -3,33 +3,33 @@ import {
   connectDaemon,
   socketPath,
   startDaemon
-} from "./chunk-NX7XQY2X.js";
+} from "./chunk-YK5DEB7T.js";
 import {
   App
-} from "./chunk-M25IQ7C7.js";
+} from "./chunk-EB4OSUB7.js";
 import "./chunk-43NQNIJY.js";
-import "./chunk-7MOKOZOR.js";
+import "./chunk-WASLLXEZ.js";
 import "./chunk-ARDV4XH6.js";
 import "./chunk-AUJJGMZG.js";
 import "./chunk-YHRAOBI2.js";
-import "./chunk-QCHBDP46.js";
-import "./chunk-YGSF2TSO.js";
+import "./chunk-2I3YHT6P.js";
+import "./chunk-J7ITMK6X.js";
 import {
   runAgent
-} from "./chunk-VH7OOFQP.js";
+} from "./chunk-6NPUVPQD.js";
 import "./chunk-K5QJMSJH.js";
 import {
   composePrompt
 } from "./chunk-WAJXATCO.js";
 import "./chunk-62JNF5M2.js";
-import "./chunk-ZSDCMYZR.js";
+import "./chunk-CRDRWTON.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-HC4E42SV.js";
-import "./chunk-IMDRXXFU.js";
+import "./chunk-DCFNX2CQ.js";
+import "./chunk-PYC53J7D.js";
 import {
   detectEngines,
   getEngine
-} from "./chunk-KVYGPLWW.js";
+} from "./chunk-GV2HAALP.js";
 
 // src/cli.tsx
 import { Command } from "commander";
@@ -185,15 +185,19 @@ function registerDaemon(program2) {
     process.on("SIGINT", stop);
     process.on("SIGTERM", stop);
   });
+  program2.command("mcp").description("serve the gates as MCP tools over stdio (check, shot, flows, context)").action(async () => {
+    const { runMcpServer } = await import("./server-ENT2OFNL.js");
+    runMcpServer(process.cwd());
+  });
   program2.command("attach").description("attach this terminal to a running squint daemon (full TUI; --plain for line mode)").option("--plain", "line-mode attach instead of the full TUI").action(async (opts) => {
     const cwd = process.cwd();
     if (!opts.plain) {
       try {
-        const { RemoteSession } = await import("./remote-6O6FPTUF.js");
+        const { RemoteSession } = await import("./remote-C4BACCKX.js");
         const remote = await RemoteSession.connect(cwd);
         const config = loadConfig(defaultPaths(cwd));
         const { render: render2 } = await import("ink");
-        const { App: App2 } = await import("./App-HWMVSRMF.js");
+        const { App: App2 } = await import("./App-MC2XEM7K.js");
         const React = await import("react");
         render2(
           React.createElement(App2, {
@@ -287,7 +291,7 @@ function registerEnv(program2) {
       console.log(`${status} ${engine.name}${binaryPath ? "" : pc3.dim(` \u2014 install: ${engine.install}`)}`);
     }
     if (options.probe) {
-      const { runAgent: runAgent2 } = await import("./run-NDSNTVYP.js");
+      const { runAgent: runAgent2 } = await import("./run-GDDIYEBP.js");
       console.log(pc3.dim("\nprobing engines with a one-word prompt (verifies auth end to end)\u2026"));
       for (const { engine, path: binaryPath } of detected) {
         if (!binaryPath) continue;
@@ -309,8 +313,8 @@ function registerEnv(program2) {
         );
       }
     }
-    const { findChrome } = await import("./chrome-SBV3H77F.js");
-    const { hasWebSocket } = await import("./cdp-PBQKXC6R.js");
+    const { findChrome } = await import("./chrome-EEXJCG6W.js");
+    const { hasWebSocket } = await import("./cdp-WSWOSDEX.js");
     const chrome = findChrome();
     console.log(
       chrome ? `${pc3.green("\u2713")} Chrome ${pc3.dim(chrome)}` : `${pc3.yellow("\u25CB")} Chrome ${pc3.dim("\u2014 screenshots and runtime probing disabled")}`
@@ -451,7 +455,7 @@ function registerProject(program2) {
         process.exitCode = 1;
         return;
       }
-      const { runVariants, cleanVariants } = await import("./variants-3IEP7DFY.js");
+      const { runVariants, cleanVariants } = await import("./variants-VURXVIQO.js");
       const config = loadConfig(defaultPaths(cwd));
       const engineId = resolveEngineId(config, options.engine);
       const engine = getEngine(engineId);
@@ -469,7 +473,7 @@ function registerProject(program2) {
       );
       const succeeded = runs.filter((r) => r.result.ok);
       if (options.shots && succeeded.length > 0) {
-        const { screenshotVariants } = await import("./shots-OKWOYF7F.js");
+        const { screenshotVariants } = await import("./shots-6DRTXFDI.js");
         console.log(pc4.dim("capturing screenshots\u2026"));
         const shots = await screenshotVariants(cwd, succeeded.map((r) => r.variant));
         for (const shot of shots) {
@@ -484,7 +488,7 @@ ${succeeded.length}/${runs.length} variants ready in .squint/variants/ \u2014 `
     }
   );
   variantsCommand.command("list").description("List generated variants").action(async () => {
-    const { listVariants } = await import("./variants-3IEP7DFY.js");
+    const { listVariants } = await import("./variants-VURXVIQO.js");
     const ids = listVariants(process.cwd());
     if (ids.length === 0) {
       console.log(pc4.dim('no variants \u2014 squint variants gen <n> "<ask>"'));
@@ -493,7 +497,7 @@ ${succeeded.length}/${runs.length} variants ready in .squint/variants/ \u2014 `
     for (const id of ids) console.log(id);
   });
   variantsCommand.command("apply").description("Apply one variant\u2019s changes to the main tree and discard the rest").argument("<id>", "family id of the winning variant").action(async (id) => {
-    const { applyVariant, cleanVariants } = await import("./variants-3IEP7DFY.js");
+    const { applyVariant, cleanVariants } = await import("./variants-VURXVIQO.js");
     const cwd = process.cwd();
     const result = applyVariant(cwd, id);
     if (!result.ok) {
@@ -505,7 +509,7 @@ ${succeeded.length}/${runs.length} variants ready in .squint/variants/ \u2014 `
     console.log(pc4.green(`\u2713 applied ${id} to the working tree`) + pc4.dim(" \u2014 review with git diff"));
   });
   variantsCommand.command("clean").description("Discard all variants").action(async () => {
-    const { cleanVariants } = await import("./variants-3IEP7DFY.js");
+    const { cleanVariants } = await import("./variants-VURXVIQO.js");
     const count = cleanVariants(process.cwd());
     console.log(pc4.dim(`removed ${count} variant(s)`));
   });
@@ -532,8 +536,81 @@ function registerQuality(program2) {
     });
     if (results.some((r) => !r.ok)) process.exitCode = 1;
   });
+  program2.command("ci").description("One-shot verification for pipelines: gates (+ audits and flows with --url), JSON report, non-zero exit on failure").option("--url <url>", "also audit a running app URL (runtime, a11y, phantoms, jank) and replay flows").option("--json <path>", "write the machine-readable report here").action(async (opts) => {
+    const cwd = process.cwd();
+    const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const report = { startedAt, cwd };
+    let failed = false;
+    const { detectGates, runGates } = await import("./gates-ZC67NMW3.js");
+    const gates = detectGates(cwd);
+    const gateResults = await runGates(cwd, gates, (result) => {
+      console.log(`${result.ok ? pc5.green("\u2713") : pc5.red("\u2717")} ${result.gate.id} ${pc5.dim(`${(result.durationMs / 1e3).toFixed(1)}s`)}`);
+      if (!result.ok) console.log(pc5.dim(result.outputTail.split("\n").slice(-12).join("\n")));
+    });
+    report.gates = gateResults.map((r) => ({ id: r.gate.id, ok: r.ok, durationMs: r.durationMs, outputTail: r.ok ? void 0 : r.outputTail }));
+    if (gateResults.some((r) => !r.ok)) failed = true;
+    if (opts.url) {
+      const { captureViewports, runtimeSummary, previewDir } = await import("./preview-CDEMPHWV.js");
+      const capture = await captureViewports(cwd, opts.url);
+      if (!capture) {
+        console.log(pc5.red("\u2717 audit: capture failed (Chrome missing or URL unreachable)"));
+        report.audit = { ok: false };
+        failed = true;
+      } else {
+        const runtime = capture.runtime ? runtimeSummary(capture.runtime) : null;
+        const hard = {
+          runtime,
+          phantoms: capture.phantoms ?? [],
+          viewTransitions: (capture.viewTransitions ?? []).filter((v) => v.startsWith("duplicate")),
+          checkFailures: capture.checkFailures ?? []
+        };
+        const advisories = {
+          a11y: capture.a11y ?? [],
+          slop: capture.slop ?? [],
+          jank: capture.jank ?? []
+        };
+        const hardCount = (runtime ? 1 : 0) + hard.phantoms.length + hard.viewTransitions.length + hard.checkFailures.length;
+        report.audit = { ok: hardCount === 0, hard, advisories, shots: capture.shots.map((s) => s.path) };
+        if (hardCount > 0) {
+          failed = true;
+          console.log(pc5.red(`\u2717 audit: ${hardCount} hard finding(s)`));
+          for (const [k, v] of Object.entries(hard)) {
+            if (Array.isArray(v) && v.length > 0) console.log(pc5.dim(`  ${k}: ${v.join(" \xB7 ")}`));
+            else if (typeof v === "string" && v) console.log(pc5.dim(`  ${k}: ${v}`));
+          }
+        } else {
+          console.log(`${pc5.green("\u2713")} audit ${pc5.dim(`(${advisories.a11y.length} a11y, ${advisories.slop.length} slop, ${advisories.jank.length} jank advisories)`)}`);
+        }
+      }
+      const { loadFlows } = await import("./flows-MXJL45HW.js");
+      const flows = loadFlows(cwd);
+      if (flows.length > 0) {
+        const { findChrome } = await import("./chrome-EEXJCG6W.js");
+        const chrome = findChrome();
+        const flowReport = [];
+        if (chrome) {
+          const { runFlow } = await import("./cdp-WSWOSDEX.js");
+          for (const flow of flows) {
+            const result = await runFlow(chrome, opts.url, flow, previewDir(cwd));
+            flowReport.push({ name: flow.name, ok: result.ok, detail: result.ok ? void 0 : `step ${result.failedStep}: ${result.detail}` });
+            console.log(result.ok ? `${pc5.green("\u2713")} flow ${flow.name}` : pc5.red(`\u2717 flow ${flow.name} \u2014 step ${result.failedStep}: ${result.detail}`));
+            if (!result.ok) failed = true;
+          }
+        }
+        report.flows = flowReport;
+      }
+    }
+    report.ok = !failed;
+    report.finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+    if (opts.json) {
+      const fs2 = await import("fs");
+      fs2.writeFileSync(opts.json, JSON.stringify(report, null, 2));
+      console.log(pc5.dim(`report \u2192 ${opts.json}`));
+    }
+    if (failed) process.exitCode = 1;
+  });
   program2.command("shot").description("Screenshot a running app at mobile/tablet/desktop viewports (+ .squint/routes)").argument("<url>", "URL of the running app (e.g. http://localhost:5173)").action(async (url) => {
-    const { captureViewports } = await import("./preview-WT34NVCH.js");
+    const { captureViewports } = await import("./preview-CDEMPHWV.js");
     const result = await captureViewports(process.cwd(), url);
     if (!result) {
       console.error(pc5.red("\u2717 no Chrome/Chromium found"));
@@ -720,7 +797,7 @@ function registerTui(program2) {
 }
 
 // src/cli.tsx
-var VERSION = true ? "0.4.7" : "0.0.0-dev";
+var VERSION = true ? "0.5.0" : "0.0.0-dev";
 var program = new Command();
 program.name("squint").description("Lovable for your terminal \u2014 a frontend harness on top of Claude Code, Codex, and friends.").version(VERSION);
 registerRun(program);

package/dist/contextDoctor-3Y36YURE.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import {
+  contextReport,
+  formatContextReport
+} from "./chunk-BKOGVFCO.js";
+import "./chunk-ARDV4XH6.js";
+import "./chunk-WAJXATCO.js";
+export {
+  contextReport,
+  formatContextReport
+};

package/dist/flows-MXJL45HW.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import {
+  loadFlows,
+  parseFlow,
+  stepExpression
+} from "./chunk-4XSHHGA6.js";
+export {
+  loadFlows,
+  parseFlow,
+  stepExpression
+};

package/dist/{preview-WT34NVCH.js → preview-CDEMPHWV.js}

@@ -5,22 +5,24 @@ import {
   buildRuntimeFixPrompt,
   captureViewports,
   comparePulse,
+  comparePulseAttributed,
   loadRoutes,
   previewDir,
   probeRuntime,
   routeShotName,
   runtimeSummary
-} from "./chunk-ZSDCMYZR.js";
+} from "./chunk-CRDRWTON.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-HC4E42SV.js";
-import "./chunk-IMDRXXFU.js";
-import "./chunk-KVYGPLWW.js";
+import "./chunk-DCFNX2CQ.js";
+import "./chunk-PYC53J7D.js";
+import "./chunk-GV2HAALP.js";
 export {
   VIEWPORTS,
   buildReviewPrompt,
   buildRuntimeFixPrompt,
   captureViewports,
   comparePulse,
+  comparePulseAttributed,
   loadRoutes,
   previewDir,
   probeRuntime,

package/dist/{registry-MIJ6LSAY.js → registry-JBP7J3JB.js}

@@ -5,7 +5,7 @@ import {
   findBinary,
   findEngineBinary,
   getEngine
-} from "./chunk-KVYGPLWW.js";
+} from "./chunk-GV2HAALP.js";
 export {
   detectEngines,
   engines,

package/dist/{remote-6O6FPTUF.js → remote-C4BACCKX.js}

@@ -2,22 +2,22 @@
 import {
   connectDaemon,
   socketPath
-} from "./chunk-NX7XQY2X.js";
-import "./chunk-7MOKOZOR.js";
+} from "./chunk-YK5DEB7T.js";
+import "./chunk-WASLLXEZ.js";
 import "./chunk-ARDV4XH6.js";
 import "./chunk-AUJJGMZG.js";
 import "./chunk-YHRAOBI2.js";
-import "./chunk-QCHBDP46.js";
-import "./chunk-YGSF2TSO.js";
-import "./chunk-VH7OOFQP.js";
+import "./chunk-2I3YHT6P.js";
+import "./chunk-J7ITMK6X.js";
+import "./chunk-6NPUVPQD.js";
 import "./chunk-K5QJMSJH.js";
 import "./chunk-WAJXATCO.js";
 import "./chunk-62JNF5M2.js";
-import "./chunk-ZSDCMYZR.js";
+import "./chunk-CRDRWTON.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-HC4E42SV.js";
-import "./chunk-IMDRXXFU.js";
-import "./chunk-KVYGPLWW.js";
+import "./chunk-DCFNX2CQ.js";
+import "./chunk-PYC53J7D.js";
+import "./chunk-GV2HAALP.js";
 
 // src/daemon/remote.ts
 var noteId = 0;

package/dist/{run-NDSNTVYP.js → run-GDDIYEBP.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   runAgent
-} from "./chunk-VH7OOFQP.js";
-import "./chunk-KVYGPLWW.js";
+} from "./chunk-6NPUVPQD.js";
+import "./chunk-GV2HAALP.js";
 export {
   runAgent
 };

package/dist/server-ENT2OFNL.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+import {
+  contextReport,
+  formatContextReport
+} from "./chunk-BKOGVFCO.js";
+import "./chunk-ARDV4XH6.js";
+import "./chunk-WAJXATCO.js";
+import {
+  detectGates,
+  runGates
+} from "./chunk-62JNF5M2.js";
+import {
+  loadFlows
+} from "./chunk-4XSHHGA6.js";
+import {
+  captureViewports,
+  previewDir,
+  runtimeSummary
+} from "./chunk-CRDRWTON.js";
+import "./chunk-7CAGWFAQ.js";
+import "./chunk-DCFNX2CQ.js";
+import {
+  findChrome
+} from "./chunk-PYC53J7D.js";
+import "./chunk-GV2HAALP.js";
+
+// src/mcp/server.ts
+import readline from "readline";
+var TOOLS = [
+  {
+    name: "squint_check",
+    description: "Run the repo quality gates (typecheck, lint, format, test, build as detected). Returns each gate with pass/fail and failure output.",
+    inputSchema: { type: "object", properties: {} },
+    async run(_args, cwd) {
+      const gates = detectGates(cwd);
+      if (gates.length === 0) return "no gates detected (no package.json scripts or known tools)";
+      const results = await runGates(cwd, gates);
+      return results.map((r) => `${r.ok ? "\u2713" : "\u2717"} ${r.gate.display}${r.ok ? "" : `
+${r.outputTail.slice(-1500)}`}`).join("\n");
+    }
+  },
+  {
+    name: "squint_shot",
+    description: "Screenshot and audit a running app URL headlessly: runtime errors, accessibility sweep, anti-slop tells, phantom classes, view-transition breakage, jank attribution, screen-reader narration. Returns findings; screenshots land in .squint/preview/.",
+    inputSchema: { type: "object", properties: { url: { type: "string" } }, required: ["url"] },
+    async run(args, cwd) {
+      const url = String(args.url ?? "");
+      const result = await captureViewports(cwd, url);
+      if (!result) return "capture failed \u2014 is Chrome installed and the URL reachable?";
+      const sections = [`shots: ${result.shots.map((s) => s.path).join(", ")}`];
+      const runtime = result.runtime ? runtimeSummary(result.runtime) : null;
+      if (runtime) sections.push(`runtime: ${runtime}`);
+      for (const [label, list] of [
+        ["a11y", result.a11y],
+        ["slop", result.slop],
+        ["phantom classes", result.phantoms],
+        ["view transitions", result.viewTransitions],
+        ["jank", result.jank],
+        ["components", result.components]
+      ]) {
+        if (list && list.length > 0) sections.push(`${label}:
+${list.join("\n")}`);
+      }
+      return sections.join("\n\n");
+    }
+  },
+  {
+    name: "squint_flows",
+    description: "Replay the repo's declared user journeys (.squint/flows/*.flow) headlessly against a URL. Returns pass/fail per flow with the failing step.",
+    inputSchema: { type: "object", properties: { url: { type: "string" } }, required: ["url"] },
+    async run(args, cwd) {
+      const url = String(args.url ?? "");
+      const flows = loadFlows(cwd);
+      if (flows.length === 0) return "no flows declared \u2014 add .squint/flows/<name>.flow";
+      const chrome = findChrome();
+      if (!chrome) return "no Chrome/Chromium found";
+      const { runFlow } = await import("./cdp-WSWOSDEX.js");
+      const lines = [];
+      for (const flow of flows) {
+        const result = await runFlow(chrome, url, flow, previewDir(cwd));
+        lines.push(
+          result.ok ? `\u2713 ${flow.name} (${flow.steps.length} steps)` : `\u2717 ${flow.name} at step ${result.failedStep}: ${result.detail}`
+        );
+      }
+      return lines.join("\n");
+    }
+  },
+  {
+    name: "squint_context",
+    description: "Itemize what squint injects into engine asks \u2014 token cost per source with staleness warnings (stale locks, generic skill triggers, oversized always-on context).",
+    inputSchema: { type: "object", properties: {} },
+    async run(_args, cwd) {
+      return formatContextReport(contextReport(cwd));
+    }
+  }
+];
+function runMcpServer(cwd, input = process.stdin, output = process.stdout) {
+  const write = (msg) => output.write(`${JSON.stringify(msg)}
+`);
+  const rl = readline.createInterface({ input });
+  rl.on("line", (line) => {
+    if (!line.trim()) return;
+    let req;
+    try {
+      req = JSON.parse(line);
+    } catch {
+      return;
+    }
+    void handle(req, cwd, write);
+  });
+}
+async function handle(req, cwd, write) {
+  const reply = (result) => {
+    if (req.id !== void 0) write({ jsonrpc: "2.0", id: req.id, result });
+  };
+  const fail = (code, message) => {
+    if (req.id !== void 0) write({ jsonrpc: "2.0", id: req.id, error: { code, message } });
+  };
+  switch (req.method) {
+    case "initialize":
+      reply({
+        protocolVersion: "2025-06-18",
+        capabilities: { tools: {} },
+        serverInfo: { name: "squint", version: "0" }
+      });
+      return;
+    case "notifications/initialized":
+    case "ping":
+      if (req.method === "ping") reply({});
+      return;
+    case "tools/list":
+      reply({ tools: TOOLS.map(({ name, description, inputSchema }) => ({ name, description, inputSchema })) });
+      return;
+    case "tools/call": {
+      const name = String(req.params?.name ?? "");
+      const tool = TOOLS.find((t) => t.name === name);
+      if (!tool) return fail(-32602, `unknown tool: ${name}`);
+      try {
+        const text = await tool.run(req.params?.arguments ?? {}, cwd);
+        reply({ content: [{ type: "text", text }] });
+      } catch (error) {
+        reply({
+          content: [{ type: "text", text: `tool failed: ${error instanceof Error ? error.message : String(error)}` }],
+          isError: true
+        });
+      }
+      return;
+    }
+    default:
+      fail(-32601, `method not found: ${req.method}`);
+  }
+}
+export {
+  runMcpServer
+};

package/dist/shots-6DRTXFDI.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import {
+  screenshotVariants
+} from "./chunk-2I3YHT6P.js";
+import "./chunk-J7ITMK6X.js";
+import "./chunk-6NPUVPQD.js";
+import "./chunk-K5QJMSJH.js";
+import "./chunk-WAJXATCO.js";
+import "./chunk-PYC53J7D.js";
+import "./chunk-GV2HAALP.js";
+export {
+  screenshotVariants
+};

package/dist/{variants-3IEP7DFY.js → variants-VURXVIQO.js}

@@ -9,11 +9,11 @@ import {
   runVariants,
   variantPrompt,
   variantsRoot
-} from "./chunk-YGSF2TSO.js";
-import "./chunk-VH7OOFQP.js";
+} from "./chunk-J7ITMK6X.js";
+import "./chunk-6NPUVPQD.js";
 import "./chunk-K5QJMSJH.js";
 import "./chunk-WAJXATCO.js";
-import "./chunk-KVYGPLWW.js";
+import "./chunk-GV2HAALP.js";
 export {
   MAX_VARIANTS,
   applyVariant,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aayambansal/squint",
-  "version": "0.4.7",
+  "version": "0.5.0",
   "description": "Lovable for your terminal \u2014 a frontend harness on top of Claude Code, Codex, and other coding agents.",
   "type": "module",
   "license": "MIT",

package/dist/shots-OKWOYF7F.js

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-import {
-  screenshotVariants
-} from "./chunk-QCHBDP46.js";
-import "./chunk-YGSF2TSO.js";
-import "./chunk-VH7OOFQP.js";
-import "./chunk-K5QJMSJH.js";
-import "./chunk-WAJXATCO.js";
-import "./chunk-IMDRXXFU.js";
-import "./chunk-KVYGPLWW.js";
-export {
-  screenshotVariants
-};