@aayambansal/squint 0.3.1 → 0.3.2

package/README.md

@@ -158,9 +158,15 @@ squint doctor --probe             # run every engine end to end, verify auth act
 - **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.
+- **The harness sees, in your terminal**: on kitty/Ghostty/WezTerm/iTerm2, pulse and
+  capture screenshots render as real pixels inside the transcript. Every clean turn is
+  pixel-compared with the last (drift as a number), load performance is tracked with
+  deltas (`perf: LCP 812ms (+420ms)`), hardcoded colors get pointed at the nearest
+  design token, and the mechanical anti-slop sweep flags generic-AI tells as
+  distinctiveness debt in `/review`.
+- **`/btw <question>`** asks about the codebase read-only without touching the main
+  thread's context. `.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-IH4L2KR6.js → chunk-S2ODU4MN.js}

@@ -13,6 +13,7 @@ var COMMANDS = [
   { name: "fix", args: "[n]", group: "verify", description: "send all open problems to the engine, or just problem n" },
   { name: "shot", args: "[url]", group: "verify", description: "screenshot the app (or any url) at mobile/tablet/desktop" },
   { 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: "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/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   completeCommand
-} from "./chunk-IH4L2KR6.js";
+} from "./chunk-S2ODU4MN.js";
 import {
   applySandbox,
   discardSandbox,
@@ -276,22 +276,22 @@ function registerProject(program2) {
     }
   });
   skillsCommand.command("init").description("Scaffold .squint/rules.md and an example skill").action(async () => {
-    const fs2 = await import("fs");
+    const fs3 = await import("fs");
     const nodePath = await import("path");
     const cwd = process.cwd();
     const skillsDir = nodePath.join(cwd, ".squint", "skills");
-    fs2.mkdirSync(skillsDir, { recursive: true });
+    fs3.mkdirSync(skillsDir, { recursive: true });
     const rules = nodePath.join(cwd, ".squint", "rules.md");
-    if (!fs2.existsSync(rules)) {
-      fs2.writeFileSync(
+    if (!fs3.existsSync(rules)) {
+      fs3.writeFileSync(
         rules,
         "# Project rules\n\nThese ride along on every squint ask. Keep them short \u2014 cut anything that would not cause a mistake if removed.\n"
       );
       console.log(pc3.green("\u2713 .squint/rules.md"));
     }
     const example = nodePath.join(skillsDir, "example.md");
-    if (!fs2.existsSync(example)) {
-      fs2.writeFileSync(
+    if (!fs3.existsSync(example)) {
+      fs3.writeFileSync(
         example,
         "---\ntriggers: example, sample\n---\n\nThis note is injected only when an ask mentions one of the triggers above.\nDocument the parts of this repo an agent would otherwise rediscover every time:\nwhere state lives, which helpers to reuse, what not to touch.\n"
       );
@@ -300,7 +300,7 @@ function registerProject(program2) {
     console.log(pc3.dim("rules are always-on; skills inject when an ask mentions a trigger"));
   });
   program2.command("brief").description("Set a committed design direction for this project (.squint/brief.md)").argument("[family]", "aesthetic family id (omit to list)").option("--force", "overwrite an existing project brief").action(async (familyId, options) => {
-    const fs2 = await import("fs");
+    const fs3 = await import("fs");
     const nodePath = await import("path");
     const { FAMILIES, getFamily, renderFamilyBrief } = await import("./families-2G5SLLY7.js");
     if (!familyId) {
@@ -318,13 +318,13 @@ function registerProject(program2) {
       return;
     }
     const target = nodePath.join(process.cwd(), ".squint", "brief.md");
-    if (fs2.existsSync(target) && !options.force) {
+    if (fs3.existsSync(target) && !options.force) {
       console.error(pc3.red(`\u2717 ${target} exists \u2014 use --force to overwrite`));
       process.exitCode = 1;
       return;
     }
-    fs2.mkdirSync(nodePath.dirname(target), { recursive: true });
-    fs2.writeFileSync(target, renderFamilyBrief(family) + "\n");
+    fs3.mkdirSync(nodePath.dirname(target), { recursive: true });
+    fs3.writeFileSync(target, renderFamilyBrief(family) + "\n");
     console.log(pc3.green(`\u2713 ${family.name} direction written to .squint/brief.md`));
     console.log(pc3.dim("every squint ask in this repo now holds this direction \u2014 edit the file to remix"));
   });
@@ -577,21 +577,21 @@ Next: ${pc6.bold(`${cd}${options.install ? "" : "npm install && "}squint`)}`);
     console.log(pc6.dim("then describe what to build \u2014 /dev starts the preview server"));
   });
   program2.command("tag").description("Add the element picker to this Vite app (Alt+S in the browser \u2192 click \u2192 file:line:col)").action(async () => {
-    const fs2 = await import("fs");
+    const fs3 = await import("fs");
     const nodePath = await import("path");
     const { patchViteConfig, TAGGER_FILENAME, TAGGER_SOURCE } = await import("./source-ZZU245VN.js");
     const cwd = process.cwd();
     const taggerPath = nodePath.join(cwd, TAGGER_FILENAME);
-    fs2.writeFileSync(taggerPath, TAGGER_SOURCE);
+    fs3.writeFileSync(taggerPath, TAGGER_SOURCE);
     console.log(pc6.green(`\u2713 ${TAGGER_FILENAME} written`));
-    const configPath = ["vite.config.ts", "vite.config.js", "vite.config.mjs"].map((name) => nodePath.join(cwd, name)).find((candidate) => fs2.existsSync(candidate));
+    const configPath = ["vite.config.ts", "vite.config.js", "vite.config.mjs"].map((name) => nodePath.join(cwd, name)).find((candidate) => fs3.existsSync(candidate));
     if (!configPath) {
       console.log(pc6.yellow("\u25CB no vite config found \u2014 add the plugin manually:"));
       console.log(pc6.dim(`  import squintTagger from './${TAGGER_FILENAME}'
   plugins: [squintTagger(), \u2026]`));
       return;
     }
-    const source = fs2.readFileSync(configPath, "utf8");
+    const source = fs3.readFileSync(configPath, "utf8");
     const patched = patchViteConfig(source);
     if (patched === "already") {
       console.log(pc6.dim("vite config already wired"));
@@ -600,7 +600,7 @@ Next: ${pc6.bold(`${cd}${options.install ? "" : "npm install && "}squint`)}`);
       console.log(pc6.dim(`  import squintTagger from './${TAGGER_FILENAME}'
   plugins: [squintTagger(), \u2026]`));
     } else {
-      fs2.writeFileSync(configPath, patched);
+      fs3.writeFileSync(configPath, patched);
       console.log(pc6.green(`\u2713 ${nodePath.basename(configPath)} wired`));
     }
     console.log(
@@ -615,11 +615,47 @@ import { render } from "ink";
 // src/tui/App.tsx
 import { Box as Box3, Static, Text as Text3, useApp, useInput } from "ink";
 import { InkPictureProvider } from "ink-picture";
-import path3 from "path";
+import path4 from "path";
 import { useMemo, useRef, useState as useState2, useSyncExternalStore } from "react";
 
 // src/session/engine.ts
+import path3 from "path";
+
+// src/session/hooks.ts
+import { spawn } from "child_process";
+import fs2 from "fs";
 import path2 from "path";
+function runHook(cwd, event, payload) {
+  const script = path2.join(cwd, ".squint", "hooks", event);
+  try {
+    fs2.accessSync(script, fs2.constants.X_OK);
+  } catch {
+    return false;
+  }
+  try {
+    const child = spawn(script, [], {
+      cwd,
+      env: { ...process.env, SQUINT_EVENT: event, ...prefixed(payload) },
+      stdio: "ignore",
+      detached: false
+    });
+    const timer = setTimeout(() => child.kill("SIGKILL"), 1e4);
+    child.on("close", () => clearTimeout(timer));
+    child.on("error", () => clearTimeout(timer));
+    return true;
+  } catch {
+    return false;
+  }
+}
+function prefixed(payload) {
+  const out = {};
+  for (const [key, value] of Object.entries(payload)) {
+    out[`SQUINT_${key.toUpperCase()}`] = value;
+  }
+  return out;
+}
+
+// src/session/engine.ts
 var MAX_AUTO_FIX_ATTEMPTS = 2;
 var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 var Session = class {
@@ -702,6 +738,7 @@ var Session = class {
     this.nextProblemId += 1;
     this.problemPrompts.set(this.nextProblemId, prompt);
     this.notify({ problems: [...kept, { id: this.nextProblemId, source, summary }] });
+    runHook(this.opts.cwd, "on-problem", { source, summary });
   }
   clearProblems(source) {
     const removed = this.state.problems.filter((p) => p.source === source);
@@ -769,6 +806,26 @@ ${question}`,
     this.notify({ running: false });
     this.drainQueue();
   }
+  /**
+   * Unattended polish: n rounds of screenshot-review-fix. Each round is
+   * a full review turn (its own cost); the per-ask auto-fix cap resets
+   * per round so fixes still flow. Fire it and step away.
+   */
+  async polish(rounds) {
+    for (let round = 1; round <= rounds; round++) {
+      this.fixAttempts = 0;
+      const result = await this.capture();
+      if (!result) {
+        this.push("status", `polish stopped at round ${round}: nothing to capture`);
+        return;
+      }
+      await this.runTurn(
+        buildReviewPrompt(result.shots, void 0, result.runtime, result.a11y, result.slop),
+        `\u{1F441} polish round ${round}/${rounds}`
+      );
+    }
+    this.push("status", `polish complete \u2014 ${rounds} round${rounds === 1 ? "" : "s"} of review and fixes`);
+  }
   setMode(mode) {
     this.notify({ mode });
     const hint = mode === "plan" ? "read-only: the engine investigates and proposes, edits nothing" : mode === "yolo" ? "no approval friction \u2014 the engine can do anything" : "edits auto-approved inside the workspace";
@@ -991,6 +1048,11 @@ ${driftSummary(drift)}`);
         } catch {
         }
       }
+      runHook(this.opts.cwd, "on-turn-end", {
+        cost: String(result.costUsd ?? 0),
+        duration_ms: String(result.durationMs ?? 0),
+        stat: stat ?? ""
+      });
       const before = this.state.totals.costUsd;
       this.notify({
         totals: {
@@ -1004,6 +1066,7 @@ ${driftSummary(drift)}`);
           "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`
         );
+        runHook(this.opts.cwd, "on-budget", { total: this.state.totals.costUsd.toFixed(2), budget: budget.toFixed(2) });
       }
       if (this.sessionId) {
         saveState(this.opts.cwd, {
@@ -1177,6 +1240,7 @@ ${errors.slice(-5).join("\n")}`);
       "status",
       pct < 0.5 ? "visual pulse: stable vs last turn" : `visual pulse: ${pct.toFixed(1)}% of the page changed vs last turn`
     );
+    runHook(this.opts.cwd, "on-pulse-diff", { pct: pct.toFixed(1) });
     if (pct >= 0.5) this.push("image", pulsePath);
     return pct;
   }
@@ -1197,7 +1261,7 @@ ${errors.slice(-5).join("\n")}`);
     if (result.shots.length > 0) {
       this.push(
         "status",
-        `captured ${result.shots.map((s) => s.name).join(", ")} \u2192 ${path2.dirname(result.shots[0].path)}`
+        `captured ${result.shots.map((s) => s.name).join(", ")} \u2192 ${path3.dirname(result.shots[0].path)}`
       );
       const desktop = result.shots.find((s) => s.name === "desktop") ?? result.shots[0];
       this.push("image", desktop.path);
@@ -1330,12 +1394,12 @@ They are objective defects, not style preferences.`
       }
       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 fs3 = await import("fs");
+          const path5 = await import("path");
+          const dir = path5.join(this.opts.cwd, ".squint", "transcripts");
+          fs3.mkdirSync(dir, { recursive: true });
           const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
-          const file = path4.join(dir, `${stamp}.md`);
+          const file = path5.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) {
@@ -1358,11 +1422,25 @@ They are objective defects, not style preferences.`
             }
           }
           lines.push("", `> ${this.summary()}`);
-          fs2.writeFileSync(file, lines.join("\n") + "\n");
-          this.push("status", `saved transcript \u2192 ${path4.relative(this.opts.cwd, file)}`);
+          fs3.writeFileSync(file, lines.join("\n") + "\n");
+          this.push("status", `saved transcript \u2192 ${path5.relative(this.opts.cwd, file)}`);
         })();
         break;
       }
+      case "polish": {
+        const rounds = arg ? Number.parseInt(arg, 10) : 2;
+        if (!Number.isInteger(rounds) || rounds < 1 || rounds > 5) {
+          this.push("status", "usage: /polish [1-5] \u2014 rounds of screenshot \u2192 critique \u2192 fix (each costs a turn)");
+          break;
+        }
+        if (!this.state.devUrl) {
+          this.push("error", "dev server not running \u2014 /dev first");
+          break;
+        }
+        this.push("status", `polishing: ${rounds} round${rounds === 1 ? "" : "s"} of review \u2192 fix`);
+        void this.polish(rounds);
+        break;
+      }
       case "btw":
         if (!arg) {
           this.push("status", "usage: /btw <question> \u2014 read-only side question, main thread untouched");
@@ -1376,8 +1454,8 @@ They are objective defects, not style preferences.`
           this.push("status", "nothing to copy yet");
           break;
         }
-        void import("child_process").then(({ spawn }) => {
-          const cmd = process.platform === "darwin" ? spawn("pbcopy") : process.platform === "win32" ? spawn("clip") : spawn("xclip", ["-selection", "clipboard"]);
+        void import("child_process").then(({ spawn: spawn2 }) => {
+          const cmd = process.platform === "darwin" ? spawn2("pbcopy") : process.platform === "win32" ? spawn2("clip") : spawn2("xclip", ["-selection", "clipboard"]);
           cmd.on("error", () => this.push("error", "no clipboard tool found"));
           cmd.on("close", (code) => {
             if (code === 0) this.push("status", `copied last reply (${last.text.length} chars)`);
@@ -1614,7 +1692,7 @@ ${sandboxFiles(this.opts.cwd).join("\n")}`);
         this.notify({ items: [], totals: { costUsd: 0, turns: 0 } });
         break;
       case "help": {
-        void import("./commands-E7JIVJDP.js").then(({ commandHelp }) => this.push("status", commandHelp()));
+        void import("./commands-Y5RUKBPS.js").then(({ commandHelp }) => this.push("status", commandHelp()));
         break;
       }
       case "quit":
@@ -2180,7 +2258,7 @@ function App({
       state.engineId,
       state.model ? ` \xB7 ${state.model}` : "",
       " \xB7 ",
-      path3.basename(cwd),
+      path4.basename(cwd),
       devBadge,
       totalsBadge,
       state.problems.length > 0 && /* @__PURE__ */ jsxs3(Text3, { color: theme2.error, children: [
@@ -2230,7 +2308,7 @@ function registerTui(program2) {
 }
 
 // src/cli.tsx
-var VERSION = true ? "0.3.1" : "0.0.0-dev";
+var VERSION = true ? "0.3.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-E7JIVJDP.js → commands-Y5RUKBPS.js}

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

package/package.json

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