@aayambansal/squint 0.5.0 → 0.5.2

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

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
 import {
   App
-} from "./chunk-EB4OSUB7.js";
-import "./chunk-43NQNIJY.js";
-import "./chunk-WASLLXEZ.js";
-import "./chunk-ARDV4XH6.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";
 import "./chunk-YHRAOBI2.js";
 import "./chunk-2I3YHT6P.js";
@@ -13,9 +14,9 @@ import "./chunk-6NPUVPQD.js";
 import "./chunk-K5QJMSJH.js";
 import "./chunk-WAJXATCO.js";
 import "./chunk-62JNF5M2.js";
-import "./chunk-CRDRWTON.js";
+import "./chunk-HSQ7XLD2.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-DCFNX2CQ.js";
+import "./chunk-YRANCWY6.js";
 import "./chunk-PYC53J7D.js";
 import "./chunk-GV2HAALP.js";
 export {

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

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

package/dist/{chunk-43NQNIJY.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)" },
@@ -27,6 +27,8 @@ var COMMANDS = [
   { name: "save", group: "session", description: "export the transcript to .squint/transcripts/" },
   { name: "find", args: "<term>", group: "session", description: "search this session and saved transcripts" },
   { name: "decide", args: "<text>", group: "session", description: "record a design decision; injected into every future ask" },
+  { name: "goal", args: "[text|off]", group: "build", description: "arm a standing objective; auto-fix presses until checks are clean" },
+  { name: "distill", group: "session", description: "compress the design ledger into rules.md lines and proposed checks" },
   { name: "context", group: "session", description: "what squint injects per ask, token-costed, with staleness warnings" },
   { name: "yes", args: "[note]", group: "build", description: "approve the engine's pending visual-approval request" },
   { name: "no", args: "[note]", group: "build", description: "reject the engine's pending visual-approval request" },

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

@@ -5,7 +5,7 @@ import {
 import {
   cdpCapture,
   hasWebSocket
-} from "./chunk-DCFNX2CQ.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-WSWOSDEX.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-WSWOSDEX.js");
+  const { pixelDiffAttributed } = await import("./cdp-FKFCV2B5.js");
   return pixelDiffAttributed(chrome, previous, current, url);
 }
 function buildRuntimeFixPrompt(report) {

package/dist/chunk-IEQGTVWN.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+// src/session/designLog.ts
+import fs from "fs";
+import path from "path";
+function logFile(cwd) {
+  return path.join(cwd, ".squint", "design-log.jsonl");
+}
+function appendDecision(cwd, entry) {
+  try {
+    fs.mkdirSync(path.join(cwd, ".squint"), { recursive: true });
+    const record = { ts: (/* @__PURE__ */ new Date()).toISOString(), ...entry };
+    fs.appendFileSync(logFile(cwd), JSON.stringify(record) + "\n");
+  } catch {
+  }
+}
+function loadDecisions(cwd, limit = 8) {
+  try {
+    const lines = fs.readFileSync(logFile(cwd), "utf8").trim().split("\n");
+    const decisions = [];
+    for (const line of lines.slice(-limit * 2)) {
+      try {
+        const parsed = JSON.parse(line);
+        if (typeof parsed?.decision === "string" && typeof parsed?.ts === "string") decisions.push(parsed);
+      } catch {
+      }
+    }
+    return decisions.slice(-limit);
+  } catch {
+    return [];
+  }
+}
+function decisionsSection(cwd) {
+  const decisions = loadDecisions(cwd);
+  if (decisions.length === 0) return "";
+  const lines = decisions.map((d) => {
+    const days = Math.floor((Date.now() - Date.parse(d.ts)) / 864e5);
+    const age = days <= 0 ? "today" : `${days}d ago`;
+    return `- ${d.decision} (${d.source}, ${age}${d.screenshot ? `, evidence: ${d.screenshot}` : ""})`;
+  });
+  return `## Design decisions on record
+
+${lines.join("\n")}
+
+These were decided deliberately. Do not silently undo them; if a task genuinely requires reversing one, say so explicitly first.`;
+}
+
+export {
+  appendDecision,
+  loadDecisions,
+  decisionsSection
+};

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

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

package/dist/{chunk-BKOGVFCO.js → chunk-LESZB7DT.js}

@@ -1,13 +1,15 @@
 #!/usr/bin/env node
 import {
-  decisionsSection,
   inventorySection,
   loadComponentInventory,
-  loadDecisions,
   loadLocks,
   loadRules,
   loadSkills
-} from "./chunk-ARDV4XH6.js";
+} from "./chunk-UBADCBPT.js";
+import {
+  decisionsSection,
+  loadDecisions
+} from "./chunk-IEQGTVWN.js";
 import {
   loadBrief
 } from "./chunk-WAJXATCO.js";

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

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

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

@@ -1,70 +1,28 @@
 #!/usr/bin/env node
+import {
+  decisionsSection
+} from "./chunk-IEQGTVWN.js";
 
 // src/prompt/skills.ts
-import fs3 from "fs";
-import path3 from "path";
+import fs2 from "fs";
+import path2 from "path";
 
-// src/session/designLog.ts
+// src/prompt/registry.ts
 import fs from "fs";
 import path from "path";
-function logFile(cwd) {
-  return path.join(cwd, ".squint", "design-log.jsonl");
-}
-function appendDecision(cwd, entry) {
-  try {
-    fs.mkdirSync(path.join(cwd, ".squint"), { recursive: true });
-    const record = { ts: (/* @__PURE__ */ new Date()).toISOString(), ...entry };
-    fs.appendFileSync(logFile(cwd), JSON.stringify(record) + "\n");
-  } catch {
-  }
-}
-function loadDecisions(cwd, limit = 8) {
-  try {
-    const lines = fs.readFileSync(logFile(cwd), "utf8").trim().split("\n");
-    const decisions = [];
-    for (const line of lines.slice(-limit * 2)) {
-      try {
-        const parsed = JSON.parse(line);
-        if (typeof parsed?.decision === "string" && typeof parsed?.ts === "string") decisions.push(parsed);
-      } catch {
-      }
-    }
-    return decisions.slice(-limit);
-  } catch {
-    return [];
-  }
-}
-function decisionsSection(cwd) {
-  const decisions = loadDecisions(cwd);
-  if (decisions.length === 0) return "";
-  const lines = decisions.map((d) => {
-    const days = Math.floor((Date.now() - Date.parse(d.ts)) / 864e5);
-    const age = days <= 0 ? "today" : `${days}d ago`;
-    return `- ${d.decision} (${d.source}, ${age}${d.screenshot ? `, evidence: ${d.screenshot}` : ""})`;
-  });
-  return `## Design decisions on record
-
-${lines.join("\n")}
-
-These were decided deliberately. Do not silently undo them; if a task genuinely requires reversing one, say so explicitly first.`;
-}
-
-// src/prompt/registry.ts
-import fs2 from "fs";
-import path2 from "path";
 function loadComponentInventory(cwd) {
   let config;
   try {
-    config = JSON.parse(fs2.readFileSync(path2.join(cwd, "components.json"), "utf8"));
+    config = JSON.parse(fs.readFileSync(path.join(cwd, "components.json"), "utf8"));
   } catch {
     return null;
   }
   const alias = config.aliases?.ui ?? (config.aliases?.components ? `${config.aliases.components}/ui` : "@/components/ui");
   const relative = alias.replace(/^@\//, "src/").replace(/^~\//, "");
-  const uiDir = path2.join(cwd, relative);
+  const uiDir = path.join(cwd, relative);
   let entries;
   try {
-    entries = fs2.readdirSync(uiDir);
+    entries = fs.readdirSync(uiDir);
   } catch {
     return null;
   }
@@ -100,17 +58,17 @@ function parseSkill(name, raw) {
   return { name, triggers, body };
 }
 function loadSkills(cwd) {
-  const dir = path3.join(cwd, ".squint", "skills");
+  const dir = path2.join(cwd, ".squint", "skills");
   let entries;
   try {
-    entries = fs3.readdirSync(dir).filter((f) => f.endsWith(".md"));
+    entries = fs2.readdirSync(dir).filter((f) => f.endsWith(".md"));
   } catch {
     return [];
   }
   const skills = [];
   for (const entry of entries.sort()) {
     try {
-      const skill = parseSkill(entry.replace(/\.md$/, ""), fs3.readFileSync(path3.join(dir, entry), "utf8"));
+      const skill = parseSkill(entry.replace(/\.md$/, ""), fs2.readFileSync(path2.join(dir, entry), "utf8"));
       if (skill) skills.push(skill);
     } catch {
     }
@@ -119,7 +77,7 @@ function loadSkills(cwd) {
 }
 function loadRules(cwd) {
   try {
-    const text = fs3.readFileSync(path3.join(cwd, ".squint", "rules.md"), "utf8").trim();
+    const text = fs2.readFileSync(path2.join(cwd, ".squint", "rules.md"), "utf8").trim();
     return text.length > 0 ? text : null;
   } catch {
     return null;
@@ -131,7 +89,7 @@ function matchSkills(skills, ask) {
 }
 function loadLocks(cwd) {
   try {
-    return fs3.readFileSync(path3.join(cwd, ".squint", "locks"), "utf8").split("\n").map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+    return fs2.readFileSync(path2.join(cwd, ".squint", "locks"), "utf8").split("\n").map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
   } catch {
     return [];
   }
@@ -180,9 +138,6 @@ ${parts.join("\n\n")}` : "",
 }
 
 export {
-  appendDecision,
-  loadDecisions,
-  decisionsSection,
   loadComponentInventory,
   inventorySection,
   parseSkill,

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

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
 import {
-  appendDecision,
   enrich
-} from "./chunk-ARDV4XH6.js";
+} from "./chunk-UBADCBPT.js";
+import {
+  appendDecision
+} from "./chunk-IEQGTVWN.js";
 import {
   applySandbox,
   discardSandbox,
@@ -49,7 +51,7 @@ import {
   comparePulseAttributed,
   probeRuntime,
   runtimeSummary
-} from "./chunk-CRDRWTON.js";
+} from "./chunk-HSQ7XLD2.js";
 import {
   clearState,
   loadState,
@@ -102,6 +104,7 @@ function prefixed(payload) {
 
 // src/session/engine.ts
 var MAX_AUTO_FIX_ATTEMPTS = 2;
+var MAX_GOAL_FIX_ATTEMPTS = 6;
 var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 var Session = class {
   constructor(opts) {
@@ -153,6 +156,7 @@ var Session = class {
   fixAttempts = 0;
   reviewTipShown = false;
   pendingApproval = null;
+  goal = null;
   lastPulse = null;
   lastPerf = null;
   autoReviewedThisAsk = false;
@@ -210,10 +214,11 @@ var Session = class {
   }
   /** Launch a capped auto-fix turn over all open problems. Returns true if launched. */
   maybeAutoFix() {
-    if (!this.opts.autoFix || this.fixAttempts >= MAX_AUTO_FIX_ATTEMPTS) return false;
+    const cap = this.goal ? MAX_GOAL_FIX_ATTEMPTS : MAX_AUTO_FIX_ATTEMPTS;
+    if (!this.opts.autoFix || this.fixAttempts >= cap) return false;
     if (this.state.problems.length === 0) return false;
     this.fixAttempts += 1;
-    this.push("status", `auto-fix attempt ${this.fixAttempts}/${MAX_AUTO_FIX_ATTEMPTS}`);
+    this.push("status", `auto-fix attempt ${this.fixAttempts}/${cap}${this.goal ? " (goal armed)" : ""}`);
     this.notify({ running: false });
     this.dispatchFix([...this.state.problems]);
     return true;
@@ -510,7 +515,7 @@ ${driftSummary(drift)}`);
         } catch {
         }
         try {
-          const { scanEvasion, sentinelSummary } = await import("./sentinel-42NZRTTS.js");
+          const { scanEvasion, sentinelSummary } = await import("./sentinel-4SKSSCXX.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
@@ -694,6 +699,15 @@ ${probe.checkFailures.slice(0, 5).join("\n")}`);
       this.push("status", `skills: ${enrichment.matchedSkills.join(", ")}`);
     }
     prompt += enrichment.sections;
+    if (this.goal) {
+      prompt += `
+
+## Standing goal (machine-checked)
+
+${this.goal}
+
+squint verifies every turn \u2014 gates, runtime probe, page audits. Do not declare this done while any of its checks fail; squint will keep sending failures back until they are clean.`;
+    }
     await this.runTurn(prompt, ask);
   }
   /** Restore files to the state before checkpoint `index`; drop it and everything after. */
@@ -947,8 +961,45 @@ They are objective defects, not style preferences.`
         }
         break;
       }
+      case "distill": {
+        void (async () => {
+          const { loadDecisions } = await import("./designLog-S67J7SO2.js");
+          const decisions = loadDecisions(this.opts.cwd, 24);
+          if (decisions.length < 3) {
+            this.push("status", `only ${decisions.length} decision(s) on record \u2014 distillation needs a few more (/decide, variants, approvals, rollbacks all feed the ledger)`);
+            return;
+          }
+          const ledger = decisions.map((d) => `- [${d.source}] ${d.decision}`).join("\n");
+          const prompt = `The design ledger below is every decision this project has recorded \u2014 approvals, rejections, chosen variants, rollbacks. Distill the accumulated taste into standing enforcement:
+
+${ledger}
+
+1. Append at most 3 SHORT always-on rules to .squint/rules.md capturing patterns that repeat across decisions (rejections matter most \u2014 "no gradient buttons" beats restating one-off choices). Create the file if missing; never delete existing rules.
+2. Where a decision is mechanically checkable in the DOM, write a persistent check at .squint/checks/<name>.js \u2014 plain JS that evaluates IN THE PAGE to an array of failure strings (empty = pass). At most 2 new checks; skip anything that needs judgment rather than a selector.
+3. Reply with exactly what you wrote and why, briefly.
+
+Do not restyle anything \u2014 this task only writes rules and checks.`;
+          await this.runTurn(prompt, "/distill \u2014 compress the ledger into rules and checks", this.opts.fixModel);
+        })();
+        break;
+      }
+      case "goal": {
+        if (!arg || arg === "show") {
+          this.push("status", this.goal ? `standing goal: ${this.goal}` : "no standing goal \u2014 /goal <objective> arms one; /goal off clears");
+          break;
+        }
+        if (arg === "off") {
+          this.goal = null;
+          this.push("status", "goal cleared \u2014 auto-fix back to the normal cap");
+          break;
+        }
+        this.goal = arg;
+        this.push("status", `goal armed: ${arg}
+every ask now carries it; auto-fix presses to ${MAX_GOAL_FIX_ATTEMPTS} attempts until squint's checks come back clean`);
+        break;
+      }
       case "context": {
-        import("./contextDoctor-3Y36YURE.js").then(({ contextReport, formatContextReport }) => {
+        import("./contextDoctor-LHKGSIEM.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)}`);
@@ -1071,8 +1122,24 @@ They are objective defects, not style preferences.`
           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");
@@ -1083,8 +1150,8 @@ They are objective defects, not style preferences.`
             this.push("error", "no Chrome/Chromium found for flows");
             return;
           }
-          const { runFlow } = await import("./cdp-WSWOSDEX.js");
-          const { previewDir } = await import("./preview-CDEMPHWV.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 = [];
@@ -1408,7 +1475,7 @@ ${sandboxFiles(this.opts.cwd).join("\n")}`);
         this.notify({ items: [], totals: { costUsd: 0, turns: 0 } });
         break;
       case "help": {
-        void import("./commands-BY44HDQ6.js").then(({ commandHelp }) => this.push("status", commandHelp()));
+        void import("./commands-RVCKIMNV.js").then(({ commandHelp }) => this.push("status", commandHelp()));
         break;
       }
       case "quit":

package/dist/{chunk-DCFNX2CQ.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;
@@ -771,6 +771,44 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
       if (checkFailures.length >= 15) break;
     }
     if (audit) {
+      const kbdFindings = [];
+      try {
+        const seen = [];
+        let trapped = null;
+        for (let i = 0; i < 12; i++) {
+          await connection.send("Input.dispatchKeyEvent", { type: "rawKeyDown", key: "Tab", code: "Tab", windowsVirtualKeyCode: 9 }, sessionId);
+          await connection.send("Input.dispatchKeyEvent", { type: "keyUp", key: "Tab", code: "Tab", windowsVirtualKeyCode: 9 }, sessionId);
+          const { result } = await connection.send(
+            "Runtime.evaluate",
+            {
+              expression: `(() => {
+                const el = document.activeElement;
+                if (!el || el === document.body || el === document.documentElement) return null;
+                let label = el.tagName.toLowerCase();
+                if (el.id) label += '#' + el.id;
+                else if (el.classList[0]) label += '.' + el.classList[0];
+                const cs = getComputedStyle(el);
+                const visible = (cs.outlineStyle !== 'none' && parseFloat(cs.outlineWidth) > 0) || cs.boxShadow !== 'none';
+                return { label, visible };
+              })()`,
+              returnByValue: true
+            },
+            sessionId
+          );
+          const stop = result?.value;
+          if (!stop) continue;
+          if (seen.length > 0 && seen[seen.length - 1] === stop.label && seen.filter((s) => s === stop.label).length >= 2) {
+            trapped = stop.label;
+            break;
+          }
+          seen.push(stop.label);
+          if (!stop.visible) kbdFindings.push(`keyboard: focus invisible on <${stop.label}> (tab stop ${seen.length}) \u2014 outline and box-shadow both none`);
+        }
+        if (trapped) kbdFindings.push(`keyboard: focus trapped at <${trapped}> \u2014 Tab cannot leave it`);
+        if (seen.length === 0) kbdFindings.push("keyboard: no tabbable elements \u2014 the page is unreachable without a mouse");
+        await connection.send("Runtime.evaluate", { expression: "document.activeElement && document.activeElement.blur()" }, sessionId).catch(() => null);
+      } catch {
+      }
       try {
         const { result } = await connection.send(
           "Runtime.evaluate",
@@ -778,6 +816,7 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
           sessionId
         );
         if (Array.isArray(result?.value)) a11y = result.value.map(String);
+        a11y.push(...kbdFindings);
       } catch {
       }
       try {

package/dist/cli.js

@@ -1,15 +1,16 @@
 #!/usr/bin/env node
+import {
+  App
+} from "./chunk-LBQDTQ5A.js";
+import "./chunk-3GHZOVAA.js";
 import {
   connectDaemon,
   socketPath,
   startDaemon
-} from "./chunk-YK5DEB7T.js";
-import {
-  App
-} from "./chunk-EB4OSUB7.js";
-import "./chunk-43NQNIJY.js";
-import "./chunk-WASLLXEZ.js";
-import "./chunk-ARDV4XH6.js";
+} from "./chunk-NCEEMDD6.js";
+import "./chunk-W5ZGF5JQ.js";
+import "./chunk-UBADCBPT.js";
+import "./chunk-IEQGTVWN.js";
 import "./chunk-AUJJGMZG.js";
 import "./chunk-YHRAOBI2.js";
 import "./chunk-2I3YHT6P.js";
@@ -22,9 +23,9 @@ import {
   composePrompt
 } from "./chunk-WAJXATCO.js";
 import "./chunk-62JNF5M2.js";
-import "./chunk-CRDRWTON.js";
+import "./chunk-HSQ7XLD2.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-DCFNX2CQ.js";
+import "./chunk-YRANCWY6.js";
 import "./chunk-PYC53J7D.js";
 import {
   detectEngines,
@@ -186,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-ENT2OFNL.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-C4BACCKX.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-MC2XEM7K.js");
+        const { App: App2 } = await import("./App-QTB6FIJM.js");
         const React = await import("react");
         render2(
           React.createElement(App2, {
@@ -314,7 +315,7 @@ function registerEnv(program2) {
       }
     }
     const { findChrome } = await import("./chrome-EEXJCG6W.js");
-    const { hasWebSocket } = await import("./cdp-WSWOSDEX.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")}`
@@ -338,7 +339,7 @@ import pc4 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-POB4ZZY5.js");
+    const { loadRules, loadSkills } = await import("./skills-DQTE5Q77.js");
     const cwd = process.cwd();
     const rules = loadRules(cwd);
     console.log(
@@ -550,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-CDEMPHWV.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)"));
@@ -582,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-WSWOSDEX.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}` });
@@ -602,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));
@@ -610,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-CDEMPHWV.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"));
@@ -797,7 +803,7 @@ function registerTui(program2) {
 }
 
 // src/cli.tsx
-var VERSION = true ? "0.5.0" : "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-BY44HDQ6.js → commands-RVCKIMNV.js}

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

package/dist/{contextDoctor-3Y36YURE.js → contextDoctor-LHKGSIEM.js}

@@ -2,8 +2,9 @@
 import {
   contextReport,
   formatContextReport
-} from "./chunk-BKOGVFCO.js";
-import "./chunk-ARDV4XH6.js";
+} from "./chunk-LESZB7DT.js";
+import "./chunk-UBADCBPT.js";
+import "./chunk-IEQGTVWN.js";
 import "./chunk-WAJXATCO.js";
 export {
   contextReport,

package/dist/designLog-S67J7SO2.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import {
+  appendDecision,
+  decisionsSection,
+  loadDecisions
+} from "./chunk-IEQGTVWN.js";
+export {
+  appendDecision,
+  decisionsSection,
+  loadDecisions
+};

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-CDEMPHWV.js → preview-XWPCSQFT.js}

@@ -11,9 +11,9 @@ import {
   probeRuntime,
   routeShotName,
   runtimeSummary
-} from "./chunk-CRDRWTON.js";
+} from "./chunk-HSQ7XLD2.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-DCFNX2CQ.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-C4BACCKX.js → remote-QNRB5APU.js}

@@ -2,9 +2,10 @@
 import {
   connectDaemon,
   socketPath
-} from "./chunk-YK5DEB7T.js";
-import "./chunk-WASLLXEZ.js";
-import "./chunk-ARDV4XH6.js";
+} from "./chunk-NCEEMDD6.js";
+import "./chunk-W5ZGF5JQ.js";
+import "./chunk-UBADCBPT.js";
+import "./chunk-IEQGTVWN.js";
 import "./chunk-AUJJGMZG.js";
 import "./chunk-YHRAOBI2.js";
 import "./chunk-2I3YHT6P.js";
@@ -13,9 +14,9 @@ import "./chunk-6NPUVPQD.js";
 import "./chunk-K5QJMSJH.js";
 import "./chunk-WAJXATCO.js";
 import "./chunk-62JNF5M2.js";
-import "./chunk-CRDRWTON.js";
+import "./chunk-HSQ7XLD2.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-DCFNX2CQ.js";
+import "./chunk-YRANCWY6.js";
 import "./chunk-PYC53J7D.js";
 import "./chunk-GV2HAALP.js";
 

package/dist/{server-ENT2OFNL.js → server-AROYCMDF.js}

@@ -2,8 +2,9 @@
 import {
   contextReport,
   formatContextReport
-} from "./chunk-BKOGVFCO.js";
-import "./chunk-ARDV4XH6.js";
+} from "./chunk-LESZB7DT.js";
+import "./chunk-UBADCBPT.js";
+import "./chunk-IEQGTVWN.js";
 import "./chunk-WAJXATCO.js";
 import {
   detectGates,
@@ -11,14 +12,14 @@ import {
 } from "./chunk-62JNF5M2.js";
 import {
   loadFlows
-} from "./chunk-4XSHHGA6.js";
+} from "./chunk-DRMVCSUG.js";
 import {
   captureViewports,
   previewDir,
   runtimeSummary
-} from "./chunk-CRDRWTON.js";
+} from "./chunk-HSQ7XLD2.js";
 import "./chunk-7CAGWFAQ.js";
-import "./chunk-DCFNX2CQ.js";
+import "./chunk-YRANCWY6.js";
 import {
   findChrome
 } from "./chunk-PYC53J7D.js";
@@ -74,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-WSWOSDEX.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/dist/{skills-POB4ZZY5.js → skills-DQTE5Q77.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aayambansal/squint",
-  "version": "0.5.0",
+  "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
-};