@aayambansal/squint 0.4.5 → 0.4.6

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.
+- **Persistent checks**: assertions the engine verifies once persist as
+  `.squint/checks/*.js` and replay against the live page every turn — one-off
+  verifications compound into repo-versioned regression checks.
 - **Visual approval**: engines ask before contested changes — the request renders
   with its screenshot, `/yes` / `/no` answer it, the ledger remembers.
 - **The design ledger**: `/decide` (plus chosen variants, rollbacks, accepted

package/dist/{cdp-Q4H6ZHPT.js → cdp-OYRHOPVP.js}

@@ -4,7 +4,7 @@ import {
   hasWebSocket,
   pixelDiffPct,
   runFlow
-} from "./chunk-RQHOE5MV.js";
+} from "./chunk-X2RZJT4L.js";
 export {
   cdpCapture,
   hasWebSocket,

package/dist/{chunk-ZLEP2TWF.js → chunk-ARDV4XH6.js}

@@ -159,7 +159,11 @@ If the task appears to require changing them, stop and explain instead.`
   parts.push(
     `## Requesting visual approval
 
-For a visual decision you should not make alone (a redesign direction, removing something deliberate, reversing a design decision on record): write .squint/approval-request.json containing {"summary": "<one line>", "screenshot": "<path, optional>"} and end your turn immediately without making the change. The user's verdict arrives as the next message.`
+For a visual decision you should not make alone (a redesign direction, removing something deliberate, reversing a design decision on record): write .squint/approval-request.json containing {"summary": "<one line>", "screenshot": "<path, optional>"} and end your turn immediately without making the change. The user's verdict arrives as the next message.
+
+## Persistent checks
+
+When you verify something about the page that should stay true (an element exists, a state renders, a metric holds), persist it as .squint/checks/<name>.js \u2014 plain JS that evaluates IN THE PAGE to an array of failure strings (empty array = pass). squint replays every check against the live page after each turn.`
   );
   const matched = matchSkills(loadSkills(cwd), ask);
   for (const skill of matched) {

package/dist/{chunk-CV5WVKHU.js → chunk-D7Q3M6PA.js}

@@ -9,12 +9,39 @@ import {
 import {
   cdpCapture,
   hasWebSocket
-} from "./chunk-RQHOE5MV.js";
+} from "./chunk-X2RZJT4L.js";
 
 // src/preview/preview.ts
-import fs from "fs";
+import fs2 from "fs";
 import os from "os";
+import path2 from "path";
+
+// src/preview/checks.ts
+import fs from "fs";
 import path from "path";
+var MAX_CHECKS = 20;
+var MAX_BYTES = 1e4;
+function loadChecks(cwd) {
+  const dir = path.join(cwd, ".squint", "checks");
+  let entries;
+  try {
+    entries = fs.readdirSync(dir).filter((f) => f.endsWith(".js"));
+  } catch {
+    return [];
+  }
+  const checks = [];
+  for (const entry of entries.sort().slice(0, MAX_CHECKS)) {
+    try {
+      const source = fs.readFileSync(path.join(dir, entry), "utf8");
+      if (source.trim().length === 0 || Buffer.byteLength(source) > MAX_BYTES) continue;
+      checks.push({ name: entry.replace(/\.js$/, ""), source });
+    } catch {
+    }
+  }
+  return checks;
+}
+
+// src/preview/preview.ts
 var VIEWPORTS = [
   { name: "mobile", width: 390, height: 844 },
   { name: "tablet", width: 768, height: 1024 },
@@ -23,7 +50,7 @@ var VIEWPORTS = [
 function loadRoutes(cwd) {
   let lines = [];
   try {
-    lines = fs.readFileSync(path.join(cwd, ".squint", "routes"), "utf8").split("\n").map((l) => l.trim()).filter((l) => l.length > 0 && !l.startsWith("#"));
+    lines = fs2.readFileSync(path2.join(cwd, ".squint", "routes"), "utf8").split("\n").map((l) => l.trim()).filter((l) => l.length > 0 && !l.startsWith("#"));
   } catch {
   }
   const routes = ["/", ...lines.filter((l) => l !== "/")];
@@ -34,8 +61,8 @@ function routeShotName(route) {
   return clean.length > 0 ? clean : "root";
 }
 function previewDir(cwd) {
-  const dir = path.join(cwd, ".squint", "preview");
-  fs.mkdirSync(dir, { recursive: true });
+  const dir = path2.join(cwd, ".squint", "preview");
+  fs2.mkdirSync(dir, { recursive: true });
   ensureSquintIgnore(cwd);
   return dir;
 }
@@ -47,7 +74,8 @@ async function captureViewports(cwd, url) {
   const base = url.replace(/\/+$/, "");
   if (hasWebSocket()) {
     try {
-      const { report, shots: shots2, a11y, slop, narration, phantoms, viewTransitions, components } = await cdpCapture(chrome, url, dir, VIEWPORTS, 2500, true);
+      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 errors2 = [];
       for (const route of routes.slice(1)) {
         try {
@@ -62,14 +90,14 @@ async function captureViewports(cwd, url) {
           errors2.push(`${route}: capture failed`);
         }
       }
-      return { shots: shots2, errors: errors2, runtime: report, a11y, slop, narration, phantoms, viewTransitions, components };
+      return { shots: shots2, errors: errors2, runtime: report, a11y, slop, narration, phantoms, viewTransitions, components, checkFailures, webmcp };
     } catch {
     }
   }
   const shots = [];
   const errors = [];
   for (const viewport of VIEWPORTS) {
-    const outPath = path.join(dir, `${viewport.name}.png`);
+    const outPath = path2.join(dir, `${viewport.name}.png`);
     const result = await screenshot(chrome, url, outPath, {
       width: viewport.width,
       height: viewport.height
@@ -118,14 +146,16 @@ async function probeRuntime(url, cwd) {
   if (!chrome || !hasWebSocket()) return null;
   try {
     const dir = cwd ? previewDir(cwd) : os.tmpdir();
-    const { report, shots, perf } = await cdpCapture(
+    const { report, shots, perf, checkFailures } = await cdpCapture(
       chrome,
       url,
       dir,
       cwd ? [{ name: "pulse", width: 1280, height: 800 }] : [],
-      1500
+      1500,
+      false,
+      cwd ? loadChecks(cwd) : []
     );
-    return { report, pulsePath: shots[0]?.path, perf };
+    return { report, pulsePath: shots[0]?.path, perf, checkFailures };
   } catch {
     return null;
   }
@@ -133,7 +163,7 @@ async function probeRuntime(url, cwd) {
 async function comparePulse(previous, current) {
   const chrome = findChrome();
   if (!chrome || !hasWebSocket()) return null;
-  const { pixelDiffPct } = await import("./cdp-Q4H6ZHPT.js");
+  const { pixelDiffPct } = await import("./cdp-OYRHOPVP.js");
   return pixelDiffPct(chrome, previous, current);
 }
 function buildRuntimeFixPrompt(report) {
@@ -161,6 +191,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 webmcpSection(webmcp) {
+  if (!webmcp || webmcp.length === 0) return "";
+  return `
+
+## Page-declared WebMCP tools
+
+${webmcp.join("\n")}
+
+The page registers these for agents via navigator.modelContext \u2014 keep them working, and prefer extending them over inventing parallel affordances.`;
+}
 function componentSection(components) {
   if (!components || components.length === 0) return "";
   return `
@@ -201,13 +241,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) {
+function buildReviewPrompt(shots, extra, runtime, a11y, slop, narration, phantoms, viewTransitions, components, webmcp) {
   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)}`;
+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)}`;
 }
 
 export {

package/dist/{chunk-RQHOE5MV.js → chunk-X2RZJT4L.js}

@@ -188,6 +188,7 @@ async function runFlow(chromePath, baseUrl, flow, outDir) {
     const { targetId } = await connection.send("Target.createTarget", { url: "about:blank" });
     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(
       "Emulation.setDeviceMetricsOverride",
       { width: 1280, height: 800, deviceScaleFactor: 1, mobile: false },
@@ -437,7 +438,20 @@ var FIBER_AUDIT = `(() => {
   }
   return out;
 })()`;
-async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, audit = false) {
+var WEBMCP_SHIM = `(() => {
+  window.__squintWebMcp = [];
+  const record = (tools) => {
+    for (const t of tools || []) {
+      if (t && t.name) window.__squintWebMcp.push(t.name + (t.description ? ' \u2014 ' + t.description : ''));
+    }
+  };
+  const target = navigator.modelContext || (navigator.modelContext = {});
+  const provide = target.provideContext && target.provideContext.bind(target);
+  target.provideContext = (params) => { record(params && params.tools); return provide ? provide(params) : undefined; };
+  const register = target.registerTool && target.registerTool.bind(target);
+  target.registerTool = (tool) => { record([tool]); return register ? register(tool) : undefined; };
+})()`;
+async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, audit = false, checks = []) {
   const { child, wsUrl, profileDir } = await launchChrome(chromePath);
   const report = { consoleErrors: [], pageErrors: [], failedRequests: [] };
   const shots = [];
@@ -448,6 +462,8 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
   let phantoms = [];
   let viewTransitions = [];
   let components = [];
+  const checkFailures = [];
+  let webmcp = [];
   const requests = /* @__PURE__ */ new Map();
   let connection = null;
   try {
@@ -486,6 +502,7 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
     await connection.send("Runtime.enable", {}, sessionId);
     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.navigate", { url }, sessionId);
     const deadline = Date.now() + 12e3;
     while (!loaded && Date.now() < deadline) {
@@ -501,6 +518,31 @@ 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: "window.__squintWebMcp || []", returnByValue: true },
+        sessionId
+      );
+      if (Array.isArray(result?.value)) webmcp = result.value.map(String).slice(0, 12);
+    } catch {
+    }
+    for (const check of checks) {
+      try {
+        const { result, exceptionDetails } = await connection.send(
+          "Runtime.evaluate",
+          { expression: check.source, returnByValue: true, timeout: 2e3 },
+          sessionId
+        );
+        if (exceptionDetails) {
+          checkFailures.push(`${check.name}: threw ${exceptionDetails.exception?.description?.split("\n")[0] ?? exceptionDetails.text ?? "an error"}`);
+        } else if (Array.isArray(result?.value)) {
+          for (const finding of result.value.slice(0, 5)) checkFailures.push(`${check.name}: ${String(finding)}`);
+        }
+      } catch {
+      }
+      if (checkFailures.length >= 15) break;
+    }
     if (audit) {
       try {
         const { result } = await connection.send(
@@ -611,7 +653,7 @@ 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 };
+  return { report, shots, a11y, slop, perf, narration, phantoms, viewTransitions, components, checkFailures, webmcp };
 }
 
 export {

package/dist/cli.js

@@ -42,7 +42,7 @@ import {
   comparePulse,
   probeRuntime,
   runtimeSummary
-} from "./chunk-CV5WVKHU.js";
+} from "./chunk-D7Q3M6PA.js";
 import {
   clearState,
   loadState,
@@ -58,11 +58,11 @@ import {
   detectEngines,
   getEngine
 } from "./chunk-KVYGPLWW.js";
-import "./chunk-RQHOE5MV.js";
+import "./chunk-X2RZJT4L.js";
 import {
   appendDecision,
   enrich
-} from "./chunk-ZLEP2TWF.js";
+} from "./chunk-ARDV4XH6.js";
 import "./chunk-K5QJMSJH.js";
 import {
   composePrompt
@@ -240,7 +240,7 @@ function registerEnv(program2) {
       }
     }
     const { findChrome: findChrome2 } = await import("./chrome-SBV3H77F.js");
-    const { hasWebSocket } = await import("./cdp-Q4H6ZHPT.js");
+    const { hasWebSocket } = await import("./cdp-OYRHOPVP.js");
     const chrome = findChrome2();
     console.log(
       chrome ? `${pc2.green("\u2713")} Chrome ${pc2.dim(chrome)}` : `${pc2.yellow("\u25CB")} Chrome ${pc2.dim("\u2014 screenshots and runtime probing disabled")}`
@@ -264,7 +264,7 @@ import pc3 from "picocolors";
 function registerProject(program2) {
   const skillsCommand = program2.command("skills").description("Project knowledge injected into asks (.squint/rules.md + .squint/skills/)");
   skillsCommand.command("list").description("Show always-on rules and trigger-matched skills").action(async () => {
-    const { loadRules, loadSkills } = await import("./skills-6NZP67QT.js");
+    const { loadRules, loadSkills } = await import("./skills-POB4ZZY5.js");
     const cwd = process.cwd();
     const rules = loadRules(cwd);
     console.log(
@@ -463,7 +463,7 @@ function registerQuality(program2) {
     if (results.some((r) => !r.ok)) 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: captureViewports2 } = await import("./preview-ZUCVWGZG.js");
+    const { captureViewports: captureViewports2 } = await import("./preview-XREFPMHX.js");
     const result = await captureViewports2(process.cwd(), url);
     if (!result) {
       console.error(pc4.red("\u2717 no Chrome/Chromium found"));
@@ -827,7 +827,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),
+        buildReviewPrompt(result.shots, void 0, result.runtime, result.a11y, result.slop, result.narration, result.phantoms, result.viewTransitions, result.components, result.webmcp),
         `\u{1F441} polish round ${round}/${rounds}`
       );
     }
@@ -1175,6 +1175,21 @@ ${errors.slice(-5).join("\n")}`);
         this.clearProblems("dev");
         if (this.opts.autoProbe !== false && this.state.devUrl) {
           const probe = await probeRuntime(this.state.devUrl, this.opts.cwd);
+          if (probe?.checkFailures && probe.checkFailures.length > 0) {
+            this.addProblem(
+              "check",
+              `${probe.checkFailures.length} persistent check failure(s)`,
+              `Repo checks in .squint/checks/ failed against the live page. Each line is <check>: <failure>:
+
+${probe.checkFailures.join("\n")}
+
+Fix the page (or, only if the assertion itself is genuinely outdated, update that check file and say so).`
+            );
+            this.push("error", `checks: ${probe.checkFailures.length} failure(s)
+${probe.checkFailures.slice(0, 5).join("\n")}`);
+          } else {
+            this.clearProblems("check");
+          }
           const summary = probe ? runtimeSummary(probe.report) : null;
           if (probe && summary) {
             this.addProblem("runtime", summary, buildRuntimeFixPrompt(probe.report));
@@ -1192,7 +1207,7 @@ ${errors.slice(-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),
+                  buildReviewPrompt(captureResult.shots, void 0, captureResult.runtime, captureResult.a11y, captureResult.slop, captureResult.narration, captureResult.phantoms, captureResult.viewTransitions, captureResult.components, captureResult.webmcp),
                   "\u{1F441} auto-review rendered UI"
                 );
               }
@@ -1480,7 +1495,7 @@ They are objective defects, not style preferences.`
         break;
       }
       case "context": {
-        import("./contextDoctor-U3YTDFVG.js").then(({ contextReport, formatContextReport }) => {
+        import("./contextDoctor-A26C2ZDN.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)}`);
@@ -1615,8 +1630,8 @@ They are objective defects, not style preferences.`
             this.push("error", "no Chrome/Chromium found for flows");
             return;
           }
-          const { runFlow } = await import("./cdp-Q4H6ZHPT.js");
-          const { previewDir } = await import("./preview-ZUCVWGZG.js");
+          const { runFlow } = await import("./cdp-OYRHOPVP.js");
+          const { previewDir } = await import("./preview-XREFPMHX.js");
           this.push("status", `replaying ${flows.length} flow(s)\u2026`);
           this.notify({ running: true, runStartedAt: Date.now() });
           const failures = [];
@@ -1754,7 +1769,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),
+              buildReviewPrompt(result.shots, arg || void 0, result.runtime, result.a11y, result.slop, result.narration, result.phantoms, result.viewTransitions, result.components, result.webmcp),
               `\u{1F441} review rendered UI${arg ? ` \xB7 ${arg}` : ""}`
             );
           }
@@ -2559,7 +2574,7 @@ function registerTui(program2) {
 }
 
 // src/cli.tsx
-var VERSION = true ? "0.4.5" : "0.0.0-dev";
+var VERSION = true ? "0.4.6" : "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-U3YTDFVG.js → contextDoctor-A26C2ZDN.js}

@@ -7,7 +7,7 @@ import {
   loadLocks,
   loadRules,
   loadSkills
-} from "./chunk-ZLEP2TWF.js";
+} from "./chunk-ARDV4XH6.js";
 import {
   loadBrief
 } from "./chunk-WAJXATCO.js";

package/dist/{preview-ZUCVWGZG.js → preview-XREFPMHX.js}

@@ -10,11 +10,11 @@ import {
   probeRuntime,
   routeShotName,
   runtimeSummary
-} from "./chunk-CV5WVKHU.js";
+} from "./chunk-D7Q3M6PA.js";
 import "./chunk-O2S6PAJE.js";
 import "./chunk-IMDRXXFU.js";
 import "./chunk-KVYGPLWW.js";
-import "./chunk-RQHOE5MV.js";
+import "./chunk-X2RZJT4L.js";
 export {
   VIEWPORTS,
   buildReviewPrompt,

package/dist/{skills-6NZP67QT.js → skills-POB4ZZY5.js}

@@ -6,7 +6,7 @@ import {
   loadSkills,
   matchSkills,
   parseSkill
-} from "./chunk-ZLEP2TWF.js";
+} from "./chunk-ARDV4XH6.js";
 export {
   enrich,
   loadLocks,

package/package.json

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