@aayambansal/squint 0.5.1 → 0.5.2

package/dist/{App-KTNAMHY6.js → App-QTB6FIJM.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   App
-} from "./chunk-2NYNTVMX.js";
-import "./chunk-VJ2QKHYK.js";
-import "./chunk-G5NS2IFQ.js";
+} from "./chunk-LBQDTQ5A.js";
+import "./chunk-3GHZOVAA.js";
+import "./chunk-W5ZGF5JQ.js";
 import "./chunk-UBADCBPT.js";
 import "./chunk-IEQGTVWN.js";
 import "./chunk-AUJJGMZG.js";
@@ -14,9 +14,9 @@ import "./chunk-6NPUVPQD.js";
 import "./chunk-K5QJMSJH.js";
 import "./chunk-WAJXATCO.js";
 import "./chunk-62JNF5M2.js";
-import "./chunk-ERF2SPUW.js";
+import "./chunk-HSQ7XLD2.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-3YCG234A.js";
+import "./chunk-YRANCWY6.js";
 import "./chunk-PYC53J7D.js";
 import "./chunk-GV2HAALP.js";
 export {

package/dist/{cdp-D2F4P7UQ.js → cdp-FKFCV2B5.js}

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

package/dist/{chunk-VJ2QKHYK.js → chunk-3GHZOVAA.js}

@@ -15,7 +15,7 @@ var COMMANDS = [
   { name: "review", args: "[focus]", group: "verify", description: "screenshots + the engine critiques its own rendered work" },
   { name: "polish", args: "[1-5]", group: "verify", description: "unattended rounds of review \u2192 fix (default 2)" },
   { name: "score", group: "verify", description: "deterministic quality snapshot (problems, a11y, tells, runtime, LCP)" },
-  { name: "flows", args: "[name]", group: "verify", description: "replay declared .squint/flows/ journeys headlessly" },
+  { name: "flows", args: "[name]", group: "verify", description: "replay declared journeys; /flows suggest drafts them from live routes" },
   { name: "variants", args: "<2-4> <ask>", group: "explore", description: "parallel design explorations; apply/list/clean" },
   { name: "sandbox", args: "[on|diff|apply|discard]", group: "explore", description: "asks accumulate in a shadow worktree until you apply" },
   { name: "undo", group: "explore", description: "revert the last ask (files only)" },

package/dist/{chunk-4XSHHGA6.js → chunk-DRMVCSUG.js}

@@ -140,9 +140,46 @@ function stepExpression(step) {
       return null;
   }
 }
+async function suggestFlows(cwd, baseUrl, chromePath) {
+  const fs2 = await import("fs");
+  const path2 = await import("path");
+  const { cdpCapture } = await import("./cdp-FKFCV2B5.js");
+  const { loadRoutes } = await import("./preview-XWPCSQFT.js");
+  const dir = path2.join(cwd, ".squint", "flows");
+  fs2.mkdirSync(dir, { recursive: true });
+  const created = [];
+  const skipped = [];
+  for (const route of loadRoutes(cwd)) {
+    const slug = route === "/" ? "home" : route.replace(/^\//, "").replace(/[^a-z0-9]+/gi, "-").toLowerCase();
+    const file = path2.join(dir, `${slug}.flow`);
+    if (fs2.existsSync(file)) {
+      skipped.push(slug);
+      continue;
+    }
+    const url = new URL(route, baseUrl).toString();
+    const shotDir = fs2.mkdtempSync(path2.join((await import("os")).tmpdir(), "squint-suggest-"));
+    let heading = null;
+    try {
+      const capture = await cdpCapture(chromePath, url, shotDir, [], 1200, true);
+      const match = capture.narration.map((n) => /^heading \d: "(.+)"$/.exec(n)).find(Boolean);
+      heading = match?.[1] ?? null;
+    } catch {
+    } finally {
+      fs2.rmSync(shotDir, { recursive: true, force: true });
+    }
+    const lines = [`goto ${route}`];
+    if (heading) lines.push(`expect ${heading}`);
+    lines.push(`shot ${slug}`);
+    fs2.writeFileSync(file, `${lines.join("\n")}
+`);
+    created.push(slug);
+  }
+  return { created, skipped };
+}
 
 export {
   parseFlow,
   loadFlows,
-  stepExpression
+  stepExpression,
+  suggestFlows
 };

package/dist/{chunk-ERF2SPUW.js → chunk-HSQ7XLD2.js}

@@ -5,7 +5,7 @@ import {
 import {
   cdpCapture,
   hasWebSocket
-} from "./chunk-3YCG234A.js";
+} from "./chunk-YRANCWY6.js";
 import {
   findChrome,
   screenshot
@@ -21,7 +21,7 @@ import fs from "fs";
 import path from "path";
 var MAX_CHECKS = 20;
 var MAX_BYTES = 1e4;
-function loadChecks(cwd) {
+function loadChecks(cwd, context = "audit") {
   const dir = path.join(cwd, ".squint", "checks");
   let entries;
   try {
@@ -34,11 +34,12 @@ function loadChecks(cwd) {
     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 });
+      const pragma = /^\s*\/\/\s*squint-trigger:\s*(turn|audit)/.exec(source);
+      checks.push({ name: entry.replace(/\.js$/, ""), source, trigger: pragma?.[1] === "audit" ? "audit" : "turn" });
     } catch {
     }
   }
-  return checks;
+  return context === "audit" ? checks : checks.filter((c) => c.trigger === "turn");
 }
 
 // src/preview/preview.ts
@@ -153,7 +154,7 @@ async function probeRuntime(url, cwd) {
       cwd ? [{ name: "pulse", width: 1280, height: 800 }] : [],
       1500,
       false,
-      cwd ? loadChecks(cwd) : []
+      cwd ? loadChecks(cwd, "turn") : []
     );
     return { report, pulsePath: shots[0]?.path, perf, checkFailures };
   } catch {
@@ -163,13 +164,13 @@ async function probeRuntime(url, cwd) {
 async function comparePulse(previous, current) {
   const chrome = findChrome();
   if (!chrome || !hasWebSocket()) return null;
-  const { pixelDiffPct } = await import("./cdp-D2F4P7UQ.js");
+  const { pixelDiffPct } = await import("./cdp-FKFCV2B5.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-D2F4P7UQ.js");
+  const { pixelDiffAttributed } = await import("./cdp-FKFCV2B5.js");
   return pixelDiffAttributed(chrome, previous, current, url);
 }
 function buildRuntimeFixPrompt(report) {

package/dist/{chunk-2NYNTVMX.js → chunk-LBQDTQ5A.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   completeCommand
-} from "./chunk-VJ2QKHYK.js";
+} from "./chunk-3GHZOVAA.js";
 import {
   Session
-} from "./chunk-G5NS2IFQ.js";
+} from "./chunk-W5ZGF5JQ.js";
 
 // src/tui/App.tsx
 import { Box as Box3, Static, Text as Text3, useApp, useInput } from "ink";

package/dist/{chunk-AMA3F2Y2.js → chunk-NCEEMDD6.js}

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

package/dist/{chunk-G5NS2IFQ.js → chunk-W5ZGF5JQ.js}

@@ -51,7 +51,7 @@ import {
   comparePulseAttributed,
   probeRuntime,
   runtimeSummary
-} from "./chunk-ERF2SPUW.js";
+} from "./chunk-HSQ7XLD2.js";
 import {
   clearState,
   loadState,
@@ -1122,8 +1122,24 @@ every ask now carries it; auto-fix presses to ${MAX_GOAL_FIX_ATTEMPTS} attempts
           this.push("error", "dev server not running \u2014 /dev first");
           break;
         }
+        if (arg.trim() === "suggest") {
+          void (async () => {
+            const chrome = findChrome();
+            if (!chrome) {
+              this.push("error", "no Chrome/Chromium found");
+              return;
+            }
+            const { suggestFlows } = await import("./flows-OAQYGH77.js");
+            this.push("status", "drafting flows from the live routes\u2026");
+            const { created, skipped } = await suggestFlows(this.opts.cwd, this.state.devUrl, chrome);
+            if (created.length > 0) this.push("status", `drafted ${created.length} flow(s): ${created.join(", ")} \u2014 edit .squint/flows/*.flow or ask the engine to deepen them`);
+            if (skipped.length > 0) this.push("status", `kept existing: ${skipped.join(", ")}`);
+            if (created.length === 0 && skipped.length === 0) this.push("status", "no routes to draft from \u2014 add .squint/routes");
+          })();
+          break;
+        }
         void (async () => {
-          const { loadFlows } = await import("./flows-MXJL45HW.js");
+          const { loadFlows } = await import("./flows-OAQYGH77.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");
@@ -1134,8 +1150,8 @@ every ask now carries it; auto-fix presses to ${MAX_GOAL_FIX_ATTEMPTS} attempts
             this.push("error", "no Chrome/Chromium found for flows");
             return;
           }
-          const { runFlow } = await import("./cdp-D2F4P7UQ.js");
-          const { previewDir } = await import("./preview-JN5PTWLX.js");
+          const { runFlow } = await import("./cdp-FKFCV2B5.js");
+          const { previewDir } = await import("./preview-XWPCSQFT.js");
           this.push("status", `replaying ${flows.length} flow(s)\u2026`);
           this.notify({ running: true, runStartedAt: Date.now() });
           const failures = [];
@@ -1459,7 +1475,7 @@ ${sandboxFiles(this.opts.cwd).join("\n")}`);
         this.notify({ items: [], totals: { costUsd: 0, turns: 0 } });
         break;
       case "help": {
-        void import("./commands-WC7V6EAE.js").then(({ commandHelp }) => this.push("status", commandHelp()));
+        void import("./commands-RVCKIMNV.js").then(({ commandHelp }) => this.push("status", commandHelp()));
         break;
       }
       case "quit":

package/dist/{chunk-3YCG234A.js → chunk-YRANCWY6.js}

@@ -179,7 +179,7 @@ var describe = (value) => {
   return String(value);
 };
 async function runFlow(chromePath, baseUrl, flow, outDir) {
-  const { stepExpression } = await import("./flows-MXJL45HW.js");
+  const { stepExpression } = await import("./flows-OAQYGH77.js");
   const { child, wsUrl, profileDir } = await launchChrome(chromePath);
   const shots = [];
   let connection = null;

package/dist/cli.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   App
-} from "./chunk-2NYNTVMX.js";
-import "./chunk-VJ2QKHYK.js";
+} from "./chunk-LBQDTQ5A.js";
+import "./chunk-3GHZOVAA.js";
 import {
   connectDaemon,
   socketPath,
   startDaemon
-} from "./chunk-AMA3F2Y2.js";
-import "./chunk-G5NS2IFQ.js";
+} from "./chunk-NCEEMDD6.js";
+import "./chunk-W5ZGF5JQ.js";
 import "./chunk-UBADCBPT.js";
 import "./chunk-IEQGTVWN.js";
 import "./chunk-AUJJGMZG.js";
@@ -23,9 +23,9 @@ import {
   composePrompt
 } from "./chunk-WAJXATCO.js";
 import "./chunk-62JNF5M2.js";
-import "./chunk-ERF2SPUW.js";
+import "./chunk-HSQ7XLD2.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-3YCG234A.js";
+import "./chunk-YRANCWY6.js";
 import "./chunk-PYC53J7D.js";
 import {
   detectEngines,
@@ -187,18 +187,18 @@ function registerDaemon(program2) {
     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-2WPGU3KQ.js");
+    const { runMcpServer } = await import("./server-AROYCMDF.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-UOV4ZXWU.js");
+        const { RemoteSession } = await import("./remote-QNRB5APU.js");
         const remote = await RemoteSession.connect(cwd);
         const config = loadConfig(defaultPaths(cwd));
         const { render: render2 } = await import("ink");
-        const { App: App2 } = await import("./App-KTNAMHY6.js");
+        const { App: App2 } = await import("./App-QTB6FIJM.js");
         const React = await import("react");
         render2(
           React.createElement(App2, {
@@ -315,7 +315,7 @@ function registerEnv(program2) {
       }
     }
     const { findChrome } = await import("./chrome-EEXJCG6W.js");
-    const { hasWebSocket } = await import("./cdp-D2F4P7UQ.js");
+    const { hasWebSocket } = await import("./cdp-FKFCV2B5.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")}`
@@ -551,7 +551,7 @@ function registerQuality(program2) {
     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-JN5PTWLX.js");
+      const { captureViewports, runtimeSummary, previewDir } = await import("./preview-XWPCSQFT.js");
       const capture = await captureViewports(cwd, opts.url);
       if (!capture) {
         console.log(pc5.red("\u2717 audit: capture failed (Chrome missing or URL unreachable)"));
@@ -583,14 +583,14 @@ function registerQuality(program2) {
           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 { loadFlows } = await import("./flows-OAQYGH77.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-D2F4P7UQ.js");
+          const { runFlow } = await import("./cdp-FKFCV2B5.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}` });
@@ -603,6 +603,11 @@ function registerQuality(program2) {
     }
     report.ok = !failed;
     report.finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+    try {
+      const { writeReceipt } = await import("./receipts-Z55AHONO.js");
+      console.log(pc5.dim(`receipt \u2192 ${writeReceipt(cwd, report)}`));
+    } catch {
+    }
     if (opts.json) {
       const fs2 = await import("fs");
       fs2.writeFileSync(opts.json, JSON.stringify(report, null, 2));
@@ -611,7 +616,7 @@ function registerQuality(program2) {
     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-JN5PTWLX.js");
+    const { captureViewports } = await import("./preview-XWPCSQFT.js");
     const result = await captureViewports(process.cwd(), url);
     if (!result) {
       console.error(pc5.red("\u2717 no Chrome/Chromium found"));
@@ -798,7 +803,7 @@ function registerTui(program2) {
 }
 
 // src/cli.tsx
-var VERSION = true ? "0.5.1" : "0.0.0-dev";
+var VERSION = true ? "0.5.2" : "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/{commands-WC7V6EAE.js → commands-RVCKIMNV.js}

@@ -3,7 +3,7 @@ import {
   COMMANDS,
   commandHelp,
   completeCommand
-} from "./chunk-VJ2QKHYK.js";
+} from "./chunk-3GHZOVAA.js";
 export {
   COMMANDS,
   commandHelp,

package/dist/flows-OAQYGH77.js

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

package/dist/{preview-JN5PTWLX.js → preview-XWPCSQFT.js}

@@ -11,9 +11,9 @@ import {
   probeRuntime,
   routeShotName,
   runtimeSummary
-} from "./chunk-ERF2SPUW.js";
+} from "./chunk-HSQ7XLD2.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-3YCG234A.js";
+import "./chunk-YRANCWY6.js";
 import "./chunk-PYC53J7D.js";
 import "./chunk-GV2HAALP.js";
 export {

package/dist/receipts-Z55AHONO.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+
+// src/quality/receipts.ts
+import { execFileSync } from "child_process";
+import crypto from "crypto";
+import fs from "fs";
+import path from "path";
+function sha256(data) {
+  return crypto.createHash("sha256").update(data).digest("hex");
+}
+function canonical(value) {
+  if (Array.isArray(value)) return `[${value.map(canonical).join(",")}]`;
+  if (value && typeof value === "object") {
+    const entries = Object.entries(value).filter(([, v]) => v !== void 0).sort(([a], [b]) => a < b ? -1 : 1);
+    return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${canonical(v)}`).join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+function buildReceipt(cwd, report) {
+  let gitHead = null;
+  try {
+    gitHead = execFileSync("git", ["rev-parse", "HEAD"], { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
+  } catch {
+  }
+  const screenshots = {};
+  const shots = report.audit?.shots ?? [];
+  for (const shot of shots) {
+    try {
+      screenshots[path.basename(shot)] = sha256(fs.readFileSync(shot));
+    } catch {
+    }
+  }
+  const unsigned = {
+    version: true ? "0.5.2" : "0.0.0-dev",
+    node: process.version,
+    gitHead,
+    report,
+    screenshots
+  };
+  return { ...unsigned, digest: sha256(canonical(unsigned)) };
+}
+function verifyReceipt(receipt) {
+  const { digest, ...unsigned } = receipt;
+  return sha256(canonical(unsigned)) === digest;
+}
+function writeReceipt(cwd, report) {
+  const receipt = buildReceipt(cwd, report);
+  const dir = path.join(cwd, ".squint", "receipts");
+  fs.mkdirSync(dir, { recursive: true });
+  const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  const file = path.join(dir, `${stamp}${receipt.report.ok ? "" : "-failed"}.json`);
+  fs.writeFileSync(file, JSON.stringify(receipt, null, 2));
+  return file;
+}
+export {
+  buildReceipt,
+  canonical,
+  verifyReceipt,
+  writeReceipt
+};

package/dist/{remote-UOV4ZXWU.js → remote-QNRB5APU.js}

@@ -2,8 +2,8 @@
 import {
   connectDaemon,
   socketPath
-} from "./chunk-AMA3F2Y2.js";
-import "./chunk-G5NS2IFQ.js";
+} from "./chunk-NCEEMDD6.js";
+import "./chunk-W5ZGF5JQ.js";
 import "./chunk-UBADCBPT.js";
 import "./chunk-IEQGTVWN.js";
 import "./chunk-AUJJGMZG.js";
@@ -14,9 +14,9 @@ import "./chunk-6NPUVPQD.js";
 import "./chunk-K5QJMSJH.js";
 import "./chunk-WAJXATCO.js";
 import "./chunk-62JNF5M2.js";
-import "./chunk-ERF2SPUW.js";
+import "./chunk-HSQ7XLD2.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-3YCG234A.js";
+import "./chunk-YRANCWY6.js";
 import "./chunk-PYC53J7D.js";
 import "./chunk-GV2HAALP.js";
 

package/dist/{server-2WPGU3KQ.js → server-AROYCMDF.js}

@@ -12,14 +12,14 @@ import {
 } from "./chunk-62JNF5M2.js";
 import {
   loadFlows
-} from "./chunk-4XSHHGA6.js";
+} from "./chunk-DRMVCSUG.js";
 import {
   captureViewports,
   previewDir,
   runtimeSummary
-} from "./chunk-ERF2SPUW.js";
+} from "./chunk-HSQ7XLD2.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-3YCG234A.js";
+import "./chunk-YRANCWY6.js";
 import {
   findChrome
 } from "./chunk-PYC53J7D.js";
@@ -75,7 +75,7 @@ ${list.join("\n")}`);
       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-D2F4P7UQ.js");
+      const { runFlow } = await import("./cdp-FKFCV2B5.js");
       const lines = [];
       for (const flow of flows) {
         const result = await runFlow(chrome, url, flow, previewDir(cwd));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aayambansal/squint",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "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/flows-MXJL45HW.js

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