@aayambansal/squint 0.2.2 → 0.2.4

package/README.md

@@ -151,9 +151,12 @@ squint doctor --probe             # run every engine end to end, verify auth act
   `/fix <n>` targets one. The footer counts what's open.
 - **Variants without leaving**: `/variants 3 <ask>` runs parallel explorations with
   streaming per-family status; `/variants apply <id>` keeps the winner.
-- **Commands**: `/dev` `/check` `/problems` `/fix [n]` `/shot` `/review [focus]`
-  `/variants` `/undo` `/checkpoints` `/restore <n>` `/mode` `/theme` `/resume`
-  `/engine <id>` `/model <name>` `/clear`.
+- **Commands**: type `/` and matching commands appear with descriptions; tab completes.
+  `/dev` `/check` `/problems` `/fix [n]` `/shot` `/review [focus]` `/variants` `/undo`
+  `/checkpoints` `/restore <n>` `/mode` `/theme` `/copy` `/save` `/resume` `/clear`.
+- **Visual pulse**: every clean turn is screenshotted and pixel-compared with the last —
+  drift shows up as a number, not a surprise. `.squint/locks` lists paths the engine must
+  never touch; `/save` exports the transcript as markdown.
 - Assistant output renders as markdown; the done line measures real work via git
   (`3 files +42 −7`); the footer tracks session turns and cost; a bell rings when a
   turn finishes.

package/dist/{chunk-XZKQZKEE.js → chunk-4LAU5TGK.js}

@@ -51,12 +51,29 @@ function matchSkills(skills, ask) {
   const haystack = ask.toLowerCase();
   return skills.filter((skill) => skill.triggers.some((t) => haystack.includes(t)));
 }
+function loadLocks(cwd) {
+  try {
+    return fs.readFileSync(path.join(cwd, ".squint", "locks"), "utf8").split("\n").map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+  } catch {
+    return [];
+  }
+}
 function enrich(cwd, ask) {
   const parts = [];
   const rules = loadRules(cwd);
   if (rules) parts.push(`## Project rules (always apply)
 
 ${rules}`);
+  const locks = loadLocks(cwd);
+  if (locks.length > 0) {
+    parts.push(
+      `## Locked files (hard constraint)
+
+Never modify these paths, no matter what the task seems to need:
+${locks.map((l) => `- ${l}`).join("\n")}
+If the task appears to require changing them, stop and explain instead.`
+    );
+  }
   const matched = matchSkills(loadSkills(cwd), ask);
   for (const skill of matched) {
     parts.push(`## Project notes: ${skill.name}
@@ -76,5 +93,6 @@ export {
   loadSkills,
   loadRules,
   matchSkills,
+  loadLocks,
   enrich
 };

package/dist/{chunk-73ULM6HF.js → chunk-CIQ3OUAF.js}

@@ -16,7 +16,7 @@ import path2 from "path";
 // src/state/state.ts
 import fs from "fs";
 import path from "path";
-var IGNORED = ["preview/", "state.json", "variants/"];
+var IGNORED = ["preview/", "state.json", "variants/", "transcripts/"];
 function ensureSquintIgnore(cwd) {
   const dir = path.join(cwd, ".squint");
   fs.mkdirSync(dir, { recursive: true });
@@ -62,6 +62,19 @@ var VIEWPORTS = [
   { name: "tablet", width: 768, height: 1024 },
   { name: "desktop", width: 1440, height: 900 }
 ];
+function loadRoutes(cwd) {
+  let lines = [];
+  try {
+    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 !== "/")];
+  return routes.slice(0, 6).map((r) => r.startsWith("/") ? r : `/${r}`);
+}
+function routeShotName(route) {
+  const clean = route.replace(/^\/+|\/+$/g, "").replace(/[^a-zA-Z0-9]+/g, "-");
+  return clean.length > 0 ? clean : "root";
+}
 function previewDir(cwd) {
   const dir = path2.join(cwd, ".squint", "preview");
   fs2.mkdirSync(dir, { recursive: true });
@@ -72,10 +85,26 @@ async function captureViewports(cwd, url) {
   const chrome = findChrome();
   if (!chrome) return null;
   const dir = previewDir(cwd);
+  const routes = loadRoutes(cwd);
+  const base = url.replace(/\/+$/, "");
   if (hasWebSocket()) {
     try {
       const { report, shots: shots2, a11y } = await cdpCapture(chrome, url, dir, VIEWPORTS, 2500, true);
-      return { shots: shots2, errors: [], runtime: report, a11y };
+      const errors2 = [];
+      for (const route of routes.slice(1)) {
+        try {
+          const routeCapture = await cdpCapture(chrome, `${base}${route}`, dir, [
+            { name: routeShotName(route), width: 1440, height: 900 }
+          ]);
+          shots2.push(...routeCapture.shots);
+          for (const err of routeCapture.report.pageErrors.slice(0, 3)) {
+            errors2.push(`${route}: ${err.split("\n")[0]}`);
+          }
+        } catch {
+          errors2.push(`${route}: capture failed`);
+        }
+      }
+      return { shots: shots2, errors: errors2, runtime: report, a11y };
     } catch {
     }
   }
@@ -178,6 +207,8 @@ export {
   saveState,
   clearState,
   VIEWPORTS,
+  loadRoutes,
+  routeShotName,
   previewDir,
   captureViewports,
   runtimeSummary,

package/dist/chunk-EECGXFRX.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+// src/session/commands.ts
+var COMMANDS = [
+  { name: "dev", description: "start/stop the project dev server" },
+  { name: "check", description: "run all quality gates (typecheck, lint, test, build)" },
+  { name: "problems", description: "list open findings from gates, dev server, runtime, a11y" },
+  { name: "fix", args: "[n]", description: "send all open problems to the engine, or just problem n" },
+  { name: "shot", description: "screenshot the app at mobile/tablet/desktop" },
+  { name: "review", args: "[focus]", description: "screenshots + the engine critiques its own rendered work" },
+  { name: "variants", args: "<2-4> <ask>", description: "parallel design explorations; apply/list/clean" },
+  { name: "undo", description: "revert the last ask (files only)" },
+  { name: "checkpoints", description: "list per-ask checkpoints" },
+  { name: "restore", args: "<n>", description: "rewind files to before ask n" },
+  { name: "mode", args: "plan|safe|yolo", description: "how much the engine may do (shift+tab cycles)" },
+  { name: "engine", args: "<id>", description: "switch backend (new session)" },
+  { name: "model", args: "[name]", description: "model override for the engine" },
+  { name: "theme", args: "[name]", description: "switch the TUI theme", viewLevel: true },
+  { name: "copy", description: "copy the last reply to the clipboard" },
+  { name: "save", description: "export the transcript to .squint/transcripts/" },
+  { name: "queue", args: "clear", description: "drop queued asks" },
+  { name: "resume", description: "pick up the previous session for this repo" },
+  { name: "clear", description: "new session (transcript, totals, persisted state)" },
+  { name: "help", description: "list commands" },
+  { name: "quit", description: "exit with a session summary" }
+];
+function completeCommand(partial) {
+  const query = partial.toLowerCase();
+  return COMMANDS.filter((c) => c.name.startsWith(query));
+}
+function commandHelp() {
+  return COMMANDS.map((c) => `/${c.name}${c.args ? ` ${c.args}` : ""} \u2014 ${c.description}`).join("\n");
+}
+
+export {
+  COMMANDS,
+  completeCommand,
+  commandHelp
+};

package/dist/cli.js

@@ -1,4 +1,10 @@
 #!/usr/bin/env node
+import {
+  diffStatSince,
+  isGitRepo,
+  restoreSnapshot,
+  takeSnapshot
+} from "./chunk-YHRAOBI2.js";
 import {
   DevServer,
   buildFixPrompt,
@@ -17,6 +23,9 @@ import {
 import {
   runAgent
 } from "./chunk-OTG4ZB4R.js";
+import {
+  completeCommand
+} from "./chunk-EECGXFRX.js";
 import {
   buildGatePrompt,
   detectFastGates,
@@ -33,7 +42,7 @@ import {
   probeRuntime,
   runtimeSummary,
   saveState
-} from "./chunk-73ULM6HF.js";
+} from "./chunk-CIQ3OUAF.js";
 import "./chunk-OC6RU6XH.js";
 import {
   findChrome
@@ -44,13 +53,7 @@ import {
 } from "./chunk-2LRIKWBU.js";
 import {
   enrich
-} from "./chunk-XZKQZKEE.js";
-import {
-  diffStatSince,
-  isGitRepo,
-  restoreSnapshot,
-  takeSnapshot
-} from "./chunk-YHRAOBI2.js";
+} from "./chunk-4LAU5TGK.js";
 
 // src/cli.tsx
 import { Command } from "commander";
@@ -77,6 +80,8 @@ var ConfigSchema = z.object({
   autoCheck: z.boolean().optional(),
   /** Terminal bell when a turn finishes (default on). */
   bell: z.boolean().optional(),
+  /** Session budget in USD; crossing it warns (never blocks). */
+  budgetUsd: z.number().positive().optional(),
   /** TUI theme name (amber, ocean, moss, rose, mono). */
   theme: z.string().optional()
 });
@@ -126,13 +131,19 @@ function setConfigValue(file, key, value) {
       throw new Error(`"${key}" must be true or false`);
     }
     next = { ...current, [key]: value === "true" };
+  } else if (key === "budgetUsd") {
+    const budget = Number.parseFloat(value);
+    if (!Number.isFinite(budget) || budget <= 0) {
+      throw new Error('"budgetUsd" must be a positive number');
+    }
+    next = { ...current, budgetUsd: budget };
   } else if (key.startsWith("models.")) {
     const engineId = key.slice("models.".length);
     if (!engineId) throw new Error("Usage: squint config set models.<engineId> <model>");
     next = { ...current, models: { ...current.models, [engineId]: value } };
   } else {
     throw new Error(
-      `Unknown config key "${key}". Supported: engine, theme, autoDev, autoFix, autoProbe, autoCheck, bell, models.<engineId>`
+      `Unknown config key "${key}". Supported: engine, theme, autoDev, autoFix, autoProbe, autoCheck, bell, budgetUsd, models.<engineId>`
     );
   }
   fs.mkdirSync(path.dirname(file), { recursive: true });
@@ -344,16 +355,32 @@ var Session = class {
   }
   turnEdits = 0;
   turnTools = 0;
+  toolStreak = 0;
+  collapsedTools = 0;
+  /**
+   * Long tool cascades collapse: the first three of a consecutive burst
+   * render, the rest fold into one "+N more" line pushed when the burst
+   * ends — append-only, so the Static transcript stays valid.
+   */
+  flushToolCollapse() {
+    if (this.collapsedTools > 0) {
+      this.push("tool", `+${this.collapsedTools} more tool call${this.collapsedTools === 1 ? "" : "s"}`);
+      this.collapsedTools = 0;
+    }
+    this.toolStreak = 0;
+  }
   handleEvent = (event) => {
     switch (event.type) {
       case "status":
         this.commitLive();
+        this.flushToolCollapse();
         this.push("status", event.text);
         break;
       case "delta":
         this.setLive(this.live + event.text);
         break;
       case "text":
+        this.flushToolCollapse();
         if (event.streamed) {
           this.live = "";
           this.state = { ...this.state, liveText: "" };
@@ -364,17 +391,24 @@ var Session = class {
         break;
       case "thinking":
         this.commitLive();
+        this.flushToolCollapse();
         this.push("thinking", event.text);
         break;
       case "tool": {
         this.commitLive();
         this.turnTools += 1;
+        this.toolStreak += 1;
         if (/edit|write|patch|apply/i.test(event.name)) this.turnEdits += 1;
-        this.push("tool", event.detail ? `${event.name} \xB7 ${event.detail}` : event.name);
+        if (this.toolStreak <= 3) {
+          this.push("tool", event.detail ? `${event.name} \xB7 ${event.detail}` : event.name);
+        } else {
+          this.collapsedTools += 1;
+        }
         break;
       }
       case "error":
         this.commitLive();
+        this.flushToolCollapse();
         this.push("error", event.text);
         break;
       case "result":
@@ -407,6 +441,7 @@ var Session = class {
     );
     this.abort = null;
     this.commitLive();
+    this.flushToolCollapse();
     if (result.ok) {
       const cost = result.costUsd !== void 0 ? ` \xB7 $${result.costUsd.toFixed(2)}` : "";
       const secs = result.durationMs !== void 0 ? ` \xB7 ${(result.durationMs / 1e3).toFixed(0)}s` : "";
@@ -414,12 +449,20 @@ var Session = class {
       const stat = checkpoint ? diffStatSince(this.opts.cwd, checkpoint.snapshot) : null;
       const work = stat ? ` \xB7 ${stat}` : this.turnEdits > 0 ? ` \xB7 ${this.turnEdits} edit${this.turnEdits === 1 ? "" : "s"}` : this.turnTools > 0 ? ` \xB7 ${this.turnTools} tool call${this.turnTools === 1 ? "" : "s"}` : "";
       this.push("status", `done${secs}${cost}${work}`);
+      const before = this.state.totals.costUsd;
       this.notify({
         totals: {
-          costUsd: this.state.totals.costUsd + (result.costUsd ?? 0),
+          costUsd: before + (result.costUsd ?? 0),
           turns: this.state.totals.turns + 1
         }
       });
+      const budget = this.opts.budgetUsd;
+      if (budget && before < budget && this.state.totals.costUsd >= budget) {
+        this.push(
+          "error",
+          `session cost $${this.state.totals.costUsd.toFixed(2)} crossed your $${budget.toFixed(2)} budget \u2014 squint keeps working, this is just the flag you asked for`
+        );
+      }
       if (this.sessionId) {
         saveState(this.opts.cwd, {
           engine: this.state.engineId,
@@ -669,6 +712,38 @@ They are objective defects, not style preferences.`
         }
         break;
       }
+      case "save": {
+        void (async () => {
+          const fs2 = await import("fs");
+          const path4 = await import("path");
+          const dir = path4.join(this.opts.cwd, ".squint", "transcripts");
+          fs2.mkdirSync(dir, { recursive: true });
+          const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
+          const file = path4.join(dir, `${stamp}.md`);
+          const lines = [`# squint session \u2014 ${(/* @__PURE__ */ new Date()).toISOString().slice(0, 16)}`, ""];
+          for (const item of this.state.items) {
+            switch (item.role) {
+              case "user":
+                lines.push(`## \u276F ${item.text}`, "");
+                break;
+              case "assistant":
+                lines.push(item.text, "");
+                break;
+              case "tool":
+                lines.push(`- \u2699 ${item.text}`);
+                break;
+              case "thinking":
+                break;
+              default:
+                lines.push(`> ${item.role === "error" ? "\u2717 " : ""}${item.text.split("\n").join("\n> ")}`);
+            }
+          }
+          lines.push("", `> ${this.summary()}`);
+          fs2.writeFileSync(file, lines.join("\n") + "\n");
+          this.push("status", `saved transcript \u2192 ${path4.relative(this.opts.cwd, file)}`);
+        })();
+        break;
+      }
       case "copy": {
         const last = this.state.items.findLast((i) => i.role === "assistant");
         if (!last) {
@@ -857,12 +932,10 @@ They are objective defects, not style preferences.`
         clearState(this.opts.cwd);
         this.notify({ items: [], totals: { costUsd: 0, turns: 0 } });
         break;
-      case "help":
-        this.push(
-          "status",
-          "/engine <id> \xB7 /model <name> \xB7 /mode plan|safe|yolo \xB7 /dev \xB7 /check (gates) \xB7 /problems \xB7 /fix [n] \xB7 /shot \xB7 /review [focus] \xB7 /variants <2-4> <ask> \xB7 /undo \xB7 /checkpoints \xB7 /restore <n> \xB7 /copy (last reply) \xB7 /resume \xB7 /clear \xB7 /quit"
-        );
+      case "help": {
+        void import("./commands-6XDXUVO6.js").then(({ commandHelp }) => this.push("status", commandHelp()));
         break;
+      }
       case "quit":
       case "exit":
         this.push("status", this.summary());
@@ -1194,6 +1267,7 @@ function App({
   autoProbe,
   autoCheck,
   bell,
+  budgetUsd,
   initialTheme
 }) {
   const { exit } = useApp();
@@ -1209,6 +1283,7 @@ function App({
       autoFix,
       autoProbe,
       autoCheck,
+      budgetUsd,
       // Delay lets the goodbye summary land in the Static scrollback.
       onQuit: () => setTimeout(() => exit(), 60)
     });
@@ -1248,6 +1323,13 @@ function App({
       session.cycleMode();
       return;
     }
+    if (key.tab && line.text.startsWith("/") && !line.text.includes(" ")) {
+      const matches = completeCommand(line.text.slice(1));
+      if (matches.length > 0) {
+        setLine(fromText(`/${matches[0].name}${matches[0].args ? " " : ""}`));
+      }
+      return;
+    }
     if (key.return) {
       const value = line.text.trim();
       setLine(emptyLine);
@@ -1341,6 +1423,16 @@ function App({
       "\u22EF queued: ",
       queued
     ] }) }, index)),
+    line.text.startsWith("/") && !line.text.includes(" ") && /* @__PURE__ */ jsx3(Box2, { flexDirection: "column", children: completeCommand(line.text.slice(1)).slice(0, 5).map((command, index) => /* @__PURE__ */ jsxs3(Text3, { color: index === 0 ? theme2.accent : theme2.dim, children: [
+      "/",
+      command.name,
+      command.args ? ` ${command.args}` : "",
+      " ",
+      /* @__PURE__ */ jsxs3(Text3, { color: theme2.dim, children: [
+        "\u2014 ",
+        command.description
+      ] })
+    ] }, command.name)) }),
     /* @__PURE__ */ jsx3(Box2, { marginTop: state.running ? 0 : 1, children: /* @__PURE__ */ jsxs3(Text3, { children: [
       /* @__PURE__ */ jsx3(Text3, { color: theme2.accent, children: "\u276F " }),
       line.text.slice(0, line.cursor),
@@ -1381,7 +1473,7 @@ function App({
 
 // src/cli.tsx
 import { jsx as jsx4 } from "react/jsx-runtime";
-var VERSION = "0.2.2";
+var VERSION = "0.2.4";
 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);
 program.command("run").description("Run one prompt headlessly and stream the result").argument("<prompt...>", "what to build or change").option("-e, --engine <id>", "engine to use (claude, codex, gemini, opencode)").option("-m, --model <name>", "model override for the engine").option("--no-brief", "send the prompt without the squint design brief").option("--json", "emit normalized agent events as ndjson").action(
@@ -1492,7 +1584,7 @@ Next: ${pc.bold(`${cd}${options.install ? "" : "npm install && "}squint`)}`);
 });
 var skillsCommand = program.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-UGHU22BS.js");
+  const { loadRules, loadSkills } = await import("./skills-DNBHZAAU.js");
   const cwd = process.cwd();
   const rules = loadRules(cwd);
   console.log(rules ? `${pc.green("\u2713")} rules.md ${pc.dim(`(${rules.split("\n").length} lines, always on)`)}` : pc.dim("\u25CB no .squint/rules.md"));
@@ -1678,7 +1770,7 @@ program.command("check").description("Run this project\u2019s quality gates (typ
   if (results.some((r) => !r.ok)) process.exitCode = 1;
 });
 program.command("shot").description("Screenshot a running app at mobile/tablet/desktop viewports").argument("<url>", "URL of the running app (e.g. http://localhost:5173)").action(async (url) => {
-  const { captureViewports: captureViewports2 } = await import("./preview-JJJLDF7H.js");
+  const { captureViewports: captureViewports2 } = await import("./preview-LZDH65ID.js");
   const result = await captureViewports2(process.cwd(), url);
   if (!result) {
     console.error(pc.red("\u2717 no Chrome/Chromium found"));
@@ -1722,6 +1814,7 @@ program.action(() => {
         autoProbe: config.autoProbe,
         autoCheck: config.autoCheck,
         bell: config.bell,
+        budgetUsd: config.budgetUsd,
         initialTheme: config.theme
       }
     )

package/dist/commands-6XDXUVO6.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import {
+  COMMANDS,
+  commandHelp,
+  completeCommand
+} from "./chunk-EECGXFRX.js";
+export {
+  COMMANDS,
+  commandHelp,
+  completeCommand
+};

package/dist/{preview-JJJLDF7H.js → preview-LZDH65ID.js}

@@ -5,10 +5,12 @@ import {
   buildRuntimeFixPrompt,
   captureViewports,
   comparePulse,
+  loadRoutes,
   previewDir,
   probeRuntime,
+  routeShotName,
   runtimeSummary
-} from "./chunk-73ULM6HF.js";
+} from "./chunk-CIQ3OUAF.js";
 import "./chunk-OC6RU6XH.js";
 import "./chunk-P3V5CWH5.js";
 import "./chunk-2LRIKWBU.js";
@@ -18,7 +20,9 @@ export {
   buildRuntimeFixPrompt,
   captureViewports,
   comparePulse,
+  loadRoutes,
   previewDir,
   probeRuntime,
+  routeShotName,
   runtimeSummary
 };

package/dist/{skills-UGHU22BS.js → skills-DNBHZAAU.js}

@@ -1,13 +1,15 @@
 #!/usr/bin/env node
 import {
   enrich,
+  loadLocks,
   loadRules,
   loadSkills,
   matchSkills,
   parseSkill
-} from "./chunk-XZKQZKEE.js";
+} from "./chunk-4LAU5TGK.js";
 export {
   enrich,
+  loadLocks,
   loadRules,
   loadSkills,
   matchSkills,

package/package.json

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