@aayambansal/squint 0.4.8 → 0.5.0

package/README.md

@@ -174,6 +174,9 @@ 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.

package/dist/{App-766KSGON.js → App-MC2XEM7K.js}

@@ -1,23 +1,23 @@
 #!/usr/bin/env node
 import {
   App
-} from "./chunk-JZMJGLIZ.js";
+} from "./chunk-EB4OSUB7.js";
 import "./chunk-43NQNIJY.js";
-import "./chunk-YGPVP4YB.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-7RFQWOQV.js";
+import "./chunk-CRDRWTON.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-BGBG2MNY.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-2VVQOHWM.js → cdp-WSWOSDEX.js}

@@ -5,7 +5,7 @@ import {
   pixelDiffAttributed,
   pixelDiffPct,
   runFlow
-} from "./chunk-BGBG2MNY.js";
+} from "./chunk-DCFNX2CQ.js";
 export {
   cdpCapture,
   hasWebSocket,

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-7RFQWOQV.js → chunk-CRDRWTON.js}

@@ -5,11 +5,11 @@ import {
 import {
   cdpCapture,
   hasWebSocket
-} from "./chunk-BGBG2MNY.js";
+} from "./chunk-DCFNX2CQ.js";
 import {
   findChrome,
   screenshot
-} from "./chunk-IMDRXXFU.js";
+} from "./chunk-PYC53J7D.js";
 
 // src/preview/preview.ts
 import fs2 from "fs";
@@ -163,13 +163,13 @@ async function probeRuntime(url, cwd) {
 async function comparePulse(previous, current) {
   const chrome = findChrome();
   if (!chrome || !hasWebSocket()) return null;
-  const { pixelDiffPct } = await import("./cdp-2VVQOHWM.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-2VVQOHWM.js");
+  const { pixelDiffAttributed } = await import("./cdp-WSWOSDEX.js");
   return pixelDiffAttributed(chrome, previous, current, url);
 }
 function buildRuntimeFixPrompt(report) {

package/dist/{chunk-BGBG2MNY.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;
@@ -437,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();
@@ -828,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

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

@@ -4,7 +4,7 @@ import {
 } from "./chunk-43NQNIJY.js";
 import {
   Session
-} from "./chunk-YGPVP4YB.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-YGPVP4YB.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";
@@ -49,7 +49,7 @@ import {
   comparePulseAttributed,
   probeRuntime,
   runtimeSummary
-} from "./chunk-7RFQWOQV.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";
@@ -859,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 ");
@@ -948,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)}`);
@@ -1072,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");
@@ -1083,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-2VVQOHWM.js");
-          const { previewDir } = await import("./preview-FBNVDQIV.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 = [];

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   Session
-} from "./chunk-YGPVP4YB.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-ATNTD3V5.js";
+} from "./chunk-YK5DEB7T.js";
 import {
   App
-} from "./chunk-JZMJGLIZ.js";
+} from "./chunk-EB4OSUB7.js";
 import "./chunk-43NQNIJY.js";
-import "./chunk-YGPVP4YB.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-7RFQWOQV.js";
+import "./chunk-CRDRWTON.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-BGBG2MNY.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-OH2P4S2H.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-766KSGON.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-2VVQOHWM.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-FBNVDQIV.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.8" : "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-FBNVDQIV.js → preview-CDEMPHWV.js}

@@ -11,11 +11,11 @@ import {
   probeRuntime,
   routeShotName,
   runtimeSummary
-} from "./chunk-7RFQWOQV.js";
+} from "./chunk-CRDRWTON.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-BGBG2MNY.js";
-import "./chunk-IMDRXXFU.js";
-import "./chunk-KVYGPLWW.js";
+import "./chunk-DCFNX2CQ.js";
+import "./chunk-PYC53J7D.js";
+import "./chunk-GV2HAALP.js";
 export {
   VIEWPORTS,
   buildReviewPrompt,

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-OH2P4S2H.js → remote-C4BACCKX.js}

@@ -2,22 +2,22 @@
 import {
   connectDaemon,
   socketPath
-} from "./chunk-ATNTD3V5.js";
-import "./chunk-YGPVP4YB.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-7RFQWOQV.js";
+import "./chunk-CRDRWTON.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-BGBG2MNY.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.8",
+  "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
-};