@aayambansal/squint 0.3.1 → 0.3.3

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/{cdp-2XAU5MEA.js → cdp-UOIP4ZQZ.js}

@@ -3,7 +3,7 @@ import {
   cdpCapture,
   hasWebSocket,
   pixelDiffPct
-} from "./chunk-DAETGO2M.js";
+} from "./chunk-XOVOQJFL.js";
 export {
   cdpCapture,
   hasWebSocket,

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

@@ -1,8 +1,41 @@
 #!/usr/bin/env node
 
 // src/prompt/skills.ts
+import fs2 from "fs";
+import path2 from "path";
+
+// src/prompt/registry.ts
 import fs from "fs";
 import path from "path";
+function loadComponentInventory(cwd) {
+  let config;
+  try {
+    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 = path.join(cwd, relative);
+  let entries;
+  try {
+    entries = fs.readdirSync(uiDir);
+  } catch {
+    return null;
+  }
+  const components = entries.filter((f) => /\.(tsx|jsx|vue|svelte)$/.test(f)).map((f) => f.replace(/\.[^.]+$/, "")).sort();
+  if (components.length === 0) return null;
+  return { components, uiDir: relative };
+}
+function inventorySection(inventory) {
+  return `## Installed UI components (${inventory.uiDir})
+
+${inventory.components.join(" \xB7 ")}
+
+Compose from these before writing new primitives. More are one command away: \`npx shadcn@latest add <name>\`. Never invent props for these components \u2014 read the file when unsure.`;
+}
+
+// src/prompt/skills.ts
 var FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n?/;
 function parseSkill(name, raw) {
   const match = FRONTMATTER_RE.exec(raw);
@@ -22,17 +55,17 @@ function parseSkill(name, raw) {
   return { name, triggers, body };
 }
 function loadSkills(cwd) {
-  const dir = path.join(cwd, ".squint", "skills");
+  const dir = path2.join(cwd, ".squint", "skills");
   let entries;
   try {
-    entries = fs.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$/, ""), fs.readFileSync(path.join(dir, entry), "utf8"));
+      const skill = parseSkill(entry.replace(/\.md$/, ""), fs2.readFileSync(path2.join(dir, entry), "utf8"));
       if (skill) skills.push(skill);
     } catch {
     }
@@ -41,7 +74,7 @@ function loadSkills(cwd) {
 }
 function loadRules(cwd) {
   try {
-    const text = fs.readFileSync(path.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;
@@ -53,7 +86,7 @@ function matchSkills(skills, ask) {
 }
 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("#"));
+    return fs2.readFileSync(path2.join(cwd, ".squint", "locks"), "utf8").split("\n").map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
   } catch {
     return [];
   }
@@ -64,6 +97,8 @@ function enrich(cwd, ask) {
   if (rules) parts.push(`## Project rules (always apply)
 
 ${rules}`);
+  const inventory = loadComponentInventory(cwd);
+  if (inventory) parts.push(inventorySection(inventory));
   const locks = loadLocks(cwd);
   if (locks.length > 0) {
     parts.push(

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/{chunk-OTCH66M7.js → chunk-SXF7CVRW.js}

@@ -6,7 +6,7 @@ import {
 import {
   cdpCapture,
   hasWebSocket
-} from "./chunk-DAETGO2M.js";
+} from "./chunk-XOVOQJFL.js";
 import {
   ensureSquintIgnore
 } from "./chunk-O2S6PAJE.js";
@@ -47,7 +47,7 @@ async function captureViewports(cwd, url) {
   const base = url.replace(/\/+$/, "");
   if (hasWebSocket()) {
     try {
-      const { report, shots: shots2, a11y, slop } = await cdpCapture(chrome, url, dir, VIEWPORTS, 2500, true);
+      const { report, shots: shots2, a11y, slop, narration } = await cdpCapture(chrome, url, dir, VIEWPORTS, 2500, true);
       const errors2 = [];
       for (const route of routes.slice(1)) {
         try {
@@ -62,7 +62,7 @@ async function captureViewports(cwd, url) {
           errors2.push(`${route}: capture failed`);
         }
       }
-      return { shots: shots2, errors: errors2, runtime: report, a11y, slop };
+      return { shots: shots2, errors: errors2, runtime: report, a11y, slop, narration };
     } catch {
     }
   }
@@ -133,7 +133,7 @@ async function probeRuntime(url, cwd) {
 async function comparePulse(previous, current) {
   const chrome = findChrome();
   if (!chrome || !hasWebSocket()) return null;
-  const { pixelDiffPct } = await import("./cdp-2XAU5MEA.js");
+  const { pixelDiffPct } = await import("./cdp-UOIP4ZQZ.js");
   return pixelDiffPct(chrome, previous, current);
 }
 function buildRuntimeFixPrompt(report) {
@@ -151,6 +151,16 @@ ${findings.join("\n")}
 
 Fix these as part of the pass \u2014 they are objective defects, not style preferences.`;
 }
+function narrationSection(narration) {
+  if (!narration || narration.length === 0) return "";
+  return `
+
+## What a screen reader would say (accessibility tree, in order)
+
+${narration.join("\n")}
+
+Judge this narration as an experience: does the reading order make sense? do names actually describe their targets? is anything announced as "(no accessible name)"? Fix real incoherence \u2014 this is how non-visual users meet the page.`;
+}
 function slopSection(findings) {
   if (!findings || findings.length === 0) return "";
   return `
@@ -161,13 +171,13 @@ ${findings.join("\n")}
 
 These patterns make the page read as template output. Rework them within the committed design direction \u2014 this is style debt, not a defect list.`;
 }
-function buildReviewPrompt(shots, extra, runtime, a11y, slop) {
+function buildReviewPrompt(shots, extra, runtime, a11y, slop, narration) {
   const list = shots.map((s) => `- ${s.name}: ${s.path}`).join("\n");
   return `Screenshots of the running app were just captured:
 
 ${list}
 
-Read each screenshot and review the rendered UI against the design standards you were given. Check: visual hierarchy and spacing rhythm, typography, color and contrast, alignment, empty-looking or broken regions, and whether the mobile capture shows horizontal overflow or cramped layout. List the concrete issues you can SEE (not hypothetical ones), ranked by visual impact${extra ? `, with special attention to: ${extra}` : ""}. Then fix them and verify the app still builds.${runtimeSection(runtime)}${a11ySection(a11y)}${slopSection(slop)}`;
+Read each screenshot and review the rendered UI against the design standards you were given. Check: visual hierarchy and spacing rhythm, typography, color and contrast, alignment, empty-looking or broken regions, and whether the mobile capture shows horizontal overflow or cramped layout. List the concrete issues you can SEE (not hypothetical ones), ranked by visual impact${extra ? `, with special attention to: ${extra}` : ""}. Then fix them and verify the app still builds.${runtimeSection(runtime)}${a11ySection(a11y)}${slopSection(slop)}${narrationSection(narration)}`;
 }
 
 export {

package/dist/{chunk-DAETGO2M.js → chunk-XOVOQJFL.js}

@@ -278,6 +278,7 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
   let a11y = [];
   let slop = [];
   let perf = {};
+  let narration = [];
   const requests = /* @__PURE__ */ new Map();
   let connection = null;
   try {
@@ -350,6 +351,47 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
         if (Array.isArray(result?.value)) slop = result.value.map(String);
       } catch {
       }
+      try {
+        await connection.send("Accessibility.enable", {}, sessionId);
+        const { nodes } = await connection.send("Accessibility.getFullAXTree", {}, sessionId);
+        const interesting = /* @__PURE__ */ new Set([
+          "heading",
+          "link",
+          "button",
+          "textbox",
+          "checkbox",
+          "radio",
+          "combobox",
+          "listbox",
+          "img",
+          "image",
+          "navigation",
+          "main",
+          "banner",
+          "contentinfo",
+          "form",
+          "search",
+          "tab",
+          "menuitem",
+          "switch",
+          "slider",
+          "alert",
+          "dialog",
+          "list"
+        ]);
+        if (Array.isArray(nodes)) {
+          for (const node of nodes) {
+            if (node.ignored) continue;
+            const role = node.role?.value;
+            if (!role || !interesting.has(role)) continue;
+            const name = (node.name?.value ?? "").toString().trim().replace(/\s+/g, " ").slice(0, 80);
+            const level = node.properties?.find((p) => p.name === "level")?.value?.value;
+            narration.push(`${role}${level ? ` ${level}` : ""}${name ? `: "${name}"` : " (no accessible name)"}`);
+            if (narration.length >= 80) break;
+          }
+        }
+      } catch {
+      }
     }
     for (const viewport of viewports) {
       await connection.send(
@@ -373,7 +415,7 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
     child.kill("SIGKILL");
     setTimeout(() => fs.rmSync(profileDir, { recursive: true, force: true }), 500).unref?.();
   }
-  return { report, shots, a11y, slop, perf };
+  return { report, shots, a11y, slop, perf, narration };
 }
 
 export {

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,
@@ -42,7 +42,7 @@ import {
   comparePulse,
   probeRuntime,
   runtimeSummary
-} from "./chunk-OTCH66M7.js";
+} from "./chunk-SXF7CVRW.js";
 import {
   runAgent
 } from "./chunk-VH7OOFQP.js";
@@ -53,10 +53,10 @@ import {
   detectEngines,
   getEngine
 } from "./chunk-KVYGPLWW.js";
-import "./chunk-DAETGO2M.js";
+import "./chunk-XOVOQJFL.js";
 import {
   enrich
-} from "./chunk-4LAU5TGK.js";
+} from "./chunk-H5K55LXY.js";
 import {
   composePrompt
 } from "./chunk-P3H4N2EN.js";
@@ -236,7 +236,7 @@ function registerEnv(program2) {
       }
     }
     const { findChrome: findChrome2 } = await import("./chrome-SBV3H77F.js");
-    const { hasWebSocket } = await import("./cdp-2XAU5MEA.js");
+    const { hasWebSocket } = await import("./cdp-UOIP4ZQZ.js");
     const chrome = findChrome2();
     console.log(
       chrome ? `${pc2.green("\u2713")} Chrome ${pc2.dim(chrome)}` : `${pc2.yellow("\u25CB")} Chrome ${pc2.dim("\u2014 screenshots and runtime probing disabled")}`
@@ -260,7 +260,7 @@ import pc3 from "picocolors";
 function registerProject(program2) {
   const skillsCommand = program2.command("skills").description("Project knowledge injected into asks (.squint/rules.md + .squint/skills/)");
   skillsCommand.command("list").description("Show always-on rules and trigger-matched skills").action(async () => {
-    const { loadRules, loadSkills } = await import("./skills-DNBHZAAU.js");
+    const { loadRules, loadSkills } = await import("./skills-ODOVNE6E.js");
     const cwd = process.cwd();
     const rules = loadRules(cwd);
     console.log(
@@ -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"));
   });
@@ -459,7 +459,7 @@ function registerQuality(program2) {
     if (results.some((r) => !r.ok)) process.exitCode = 1;
   });
   program2.command("shot").description("Screenshot a running app at mobile/tablet/desktop viewports (+ .squint/routes)").argument("<url>", "URL of the running app (e.g. http://localhost:5173)").action(async (url) => {
-    const { captureViewports: captureViewports2 } = await import("./preview-PS7WJ2KO.js");
+    const { captureViewports: captureViewports2 } = await import("./preview-S6FOTRRR.js");
     const result = await captureViewports2(process.cwd(), url);
     if (!result) {
       console.error(pc4.red("\u2717 no Chrome/Chromium found"));
@@ -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, result.narration),
+        `\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, {
@@ -1075,7 +1138,7 @@ ${errors.slice(-5).join("\n")}`);
               const captureResult = await this.capture();
               if (captureResult) {
                 await this.runTurn(
-                  buildReviewPrompt(captureResult.shots, void 0, captureResult.runtime, captureResult.a11y, captureResult.slop),
+                  buildReviewPrompt(captureResult.shots, void 0, captureResult.runtime, captureResult.a11y, captureResult.slop, captureResult.narration),
                   "\u{1F441} auto-review rendered UI"
                 );
               }
@@ -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)`);
@@ -1430,7 +1508,7 @@ They are objective defects, not style preferences.`
           const result = await this.capture();
           if (result) {
             await this.runTurn(
-              buildReviewPrompt(result.shots, arg || void 0, result.runtime, result.a11y, result.slop),
+              buildReviewPrompt(result.shots, arg || void 0, result.runtime, result.a11y, result.slop, result.narration),
               `\u{1F441} review rendered UI${arg ? ` \xB7 ${arg}` : ""}`
             );
           }
@@ -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.3" : "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/dist/{preview-PS7WJ2KO.js → preview-S6FOTRRR.js}

@@ -10,10 +10,10 @@ import {
   probeRuntime,
   routeShotName,
   runtimeSummary
-} from "./chunk-OTCH66M7.js";
+} from "./chunk-SXF7CVRW.js";
 import "./chunk-IMDRXXFU.js";
 import "./chunk-KVYGPLWW.js";
-import "./chunk-DAETGO2M.js";
+import "./chunk-XOVOQJFL.js";
 import "./chunk-O2S6PAJE.js";
 export {
   VIEWPORTS,

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

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

package/package.json

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