@aayambansal/squint 0.3.0 → 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/{cdp-4IZHB3W5.js → cdp-2XAU5MEA.js}

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

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

@@ -5,6 +5,32 @@ import { spawn } from "child_process";
 import fs from "fs";
 import os from "os";
 import path from "path";
+var PERF_PROBE = `(() => {
+  const out = {};
+  const buffered = (type) => {
+    try {
+      const po = new PerformanceObserver(() => {});
+      po.observe({ type, buffered: true });
+      const records = po.takeRecords();
+      po.disconnect();
+      return records;
+    } catch { return []; }
+  };
+  const lcp = buffered('largest-contentful-paint');
+  if (lcp.length > 0) out.lcpMs = Math.round(lcp[lcp.length - 1].startTime);
+  let cls = 0;
+  for (const e of buffered('layout-shift')) { if (!e.hadRecentInput) cls += e.value; }
+  out.cls = Math.round(cls * 1000) / 1000;
+  try {
+    const resources = performance.getEntriesByType('resource');
+    const nav = performance.getEntriesByType('navigation')[0];
+    let bytes = nav ? (nav.transferSize || 0) : 0;
+    for (const r of resources) bytes += r.transferSize || 0;
+    out.transferBytes = bytes;
+    out.requests = resources.length + (nav ? 1 : 0);
+  } catch {}
+  return out;
+})()`;
 var A11Y_AUDIT = `(() => {
   const out = [];
   const name = (el) => (el.getAttribute('aria-label') || el.textContent || el.getAttribute('title') || '').trim();
@@ -251,6 +277,7 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
   const shots = [];
   let a11y = [];
   let slop = [];
+  let perf = {};
   const requests = /* @__PURE__ */ new Map();
   let connection = null;
   try {
@@ -295,6 +322,15 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
       await new Promise((resolve) => setTimeout(resolve, 100));
     }
     await new Promise((resolve) => setTimeout(resolve, settleMs));
+    try {
+      const { result } = await connection.send(
+        "Runtime.evaluate",
+        { expression: PERF_PROBE, returnByValue: true },
+        sessionId
+      );
+      if (result?.value && typeof result.value === "object") perf = result.value;
+    } catch {
+    }
     if (audit) {
       try {
         const { result } = await connection.send(
@@ -337,7 +373,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 };
+  return { report, shots, a11y, slop, perf };
 }
 
 export {

package/dist/{chunk-RQFFAJFE.js → chunk-OTCH66M7.js}

@@ -6,7 +6,7 @@ import {
 import {
   cdpCapture,
   hasWebSocket
-} from "./chunk-QEENJGCL.js";
+} from "./chunk-DAETGO2M.js";
 import {
   ensureSquintIgnore
 } from "./chunk-O2S6PAJE.js";
@@ -118,14 +118,14 @@ async function probeRuntime(url, cwd) {
   if (!chrome || !hasWebSocket()) return null;
   try {
     const dir = cwd ? previewDir(cwd) : os.tmpdir();
-    const { report, shots } = await cdpCapture(
+    const { report, shots, perf } = await cdpCapture(
       chrome,
       url,
       dir,
       cwd ? [{ name: "pulse", width: 1280, height: 800 }] : [],
       1500
     );
-    return { report, pulsePath: shots[0]?.path };
+    return { report, pulsePath: shots[0]?.path, perf };
   } catch {
     return null;
   }
@@ -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-4IZHB3W5.js");
+  const { pixelDiffPct } = await import("./cdp-2XAU5MEA.js");
   return pixelDiffPct(chrome, previous, current);
 }
 function buildRuntimeFixPrompt(report) {

package/dist/{chunk-CFWKEIJJ.js → chunk-S2ODU4MN.js}

@@ -13,12 +13,14 @@ 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)" },
   { name: "checkpoints", group: "explore", description: "list per-ask checkpoints" },
   { name: "restore", args: "<n>", group: "explore", description: "rewind files to before ask n" },
   { name: "theme", args: "[name]", group: "session", description: "switch the TUI theme", viewLevel: true },
+  { name: "btw", args: "<question>", group: "session", description: "read-only side question; the main thread is untouched" },
   { name: "copy", group: "session", description: "copy the last reply to the clipboard" },
   { name: "save", group: "session", description: "export the transcript to .squint/transcripts/" },
   { name: "resume", group: "session", description: "pick up the previous session for this repo" },

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   completeCommand
-} from "./chunk-CFWKEIJJ.js";
+} from "./chunk-S2ODU4MN.js";
 import {
   applySandbox,
   discardSandbox,
@@ -42,7 +42,7 @@ import {
   comparePulse,
   probeRuntime,
   runtimeSummary
-} from "./chunk-RQFFAJFE.js";
+} from "./chunk-OTCH66M7.js";
 import {
   runAgent
 } from "./chunk-VH7OOFQP.js";
@@ -53,7 +53,7 @@ import {
   detectEngines,
   getEngine
 } from "./chunk-KVYGPLWW.js";
-import "./chunk-QEENJGCL.js";
+import "./chunk-DAETGO2M.js";
 import {
   enrich
 } from "./chunk-4LAU5TGK.js";
@@ -236,7 +236,7 @@ function registerEnv(program2) {
       }
     }
     const { findChrome: findChrome2 } = await import("./chrome-SBV3H77F.js");
-    const { hasWebSocket } = await import("./cdp-4IZHB3W5.js");
+    const { hasWebSocket } = await import("./cdp-2XAU5MEA.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")}`
@@ -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-56UCV5A3.js");
+    const { captureViewports: captureViewports2 } = await import("./preview-PS7WJ2KO.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 {
@@ -672,6 +708,7 @@ var Session = class {
   fixAttempts = 0;
   reviewTipShown = false;
   lastPulse = null;
+  lastPerf = null;
   autoReviewedThisAsk = false;
   startedAt = Date.now();
   subscribe(listener) {
@@ -701,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);
@@ -733,6 +771,61 @@ var Session = class {
     this.dispatchFix([...this.state.problems]);
     return true;
   }
+  /**
+   * A side question: read-only, no session resume, so the main thread's
+   * context is untouched (Cursor's /btw). Costs count; loops don't run.
+   */
+  async btw(question) {
+    this.push("user", `\u{1F4AC} btw: ${question}`);
+    this.notify({ running: true, runStartedAt: Date.now() });
+    const engine = getEngine(this.state.engineId);
+    this.abort = new AbortController();
+    const result = await runAgent(
+      engine,
+      {
+        prompt: `Answer this question about the repository. Investigate as needed but make no changes:
+
+${question}`,
+        cwd: this.execCwd(),
+        model: this.state.model,
+        mode: "plan"
+      },
+      this.handleEvent,
+      this.abort.signal
+    );
+    this.abort = null;
+    this.commitLive();
+    this.flushToolCollapse();
+    if (result.ok) {
+      const cost = result.costUsd !== void 0 ? ` \xB7 $${result.costUsd.toFixed(2)}` : "";
+      this.push("status", `btw answered${cost}`);
+      this.notify({
+        totals: { costUsd: this.state.totals.costUsd + (result.costUsd ?? 0), turns: this.state.totals.turns }
+      });
+    }
+    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";
@@ -943,6 +1036,23 @@ 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}`);
+      if (checkpoint) {
+        try {
+          const { driftSummary, loadTokenIndex, scanDrift } = await import("./tokens-XYGRRAXC.js");
+          const index = loadTokenIndex(this.execCwd());
+          const drift = scanDrift(this.execCwd(), checkpoint.snapshot.stashHash ?? "HEAD", index);
+          if (drift.length > 0) {
+            this.push("status", `token drift: ${drift.length} hardcoded color(s)
+${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: {
@@ -956,6 +1066,7 @@ var Session = class {
           "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, {
@@ -1018,6 +1129,7 @@ ${errors.slice(-5).join("\n")}`);
             this.push("status", "/fix sends open problems to the engine \xB7 /problems lists them");
           } else if (probe) {
             this.clearProblems("runtime");
+            this.perfPulse(probe.perf);
             const pct = await this.visualPulse(probe.pulsePath);
             if (this.opts.autoReview && pct !== null && pct >= 10 && !this.autoReviewedThisAsk) {
               this.autoReviewedThisAsk = true;
@@ -1083,6 +1195,25 @@ ${errors.slice(-5).join("\n")}`);
       this.push("error", `restore failed: ${result.detail ?? "unknown error"}`);
     }
   }
+  /** Cross-turn load-performance deltas: the perf twin of the visual pulse. */
+  perfPulse(perf) {
+    if (!perf || perf.lcpMs === void 0 && perf.transferBytes === void 0) return;
+    const previous = this.lastPerf;
+    this.lastPerf = perf;
+    const mb = (bytes) => `${(bytes / 1024 / 1024).toFixed(1)}MB`;
+    const parts = [];
+    if (perf.lcpMs !== void 0) {
+      const delta = previous?.lcpMs !== void 0 && Math.abs(perf.lcpMs - previous.lcpMs) >= 100 ? ` (${perf.lcpMs > previous.lcpMs ? "+" : "\u2212"}${Math.abs(perf.lcpMs - previous.lcpMs)}ms)` : "";
+      parts.push(`LCP ${perf.lcpMs}ms${delta}`);
+    }
+    if (perf.cls !== void 0 && perf.cls > 0.05) parts.push(`CLS ${perf.cls}`);
+    if (perf.transferBytes !== void 0) {
+      const delta = previous?.transferBytes !== void 0 && Math.abs(perf.transferBytes - previous.transferBytes) > 100 * 1024 ? ` (${perf.transferBytes > previous.transferBytes ? "+" : "\u2212"}${mb(Math.abs(perf.transferBytes - previous.transferBytes))})` : "";
+      parts.push(`${mb(perf.transferBytes)}${delta}`);
+    }
+    if (perf.requests !== void 0) parts.push(`${perf.requests} req`);
+    if (parts.length > 0) this.push("status", `perf: ${parts.join(" \xB7 ")}`);
+  }
   /**
    * Cross-turn visual drift check: compare this turn's pulse screenshot
    * with the previous one and report how much of the page changed.
@@ -1109,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;
   }
@@ -1129,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);
@@ -1262,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) {
@@ -1290,19 +1422,40 @@ 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");
+        } else {
+          void this.btw(arg);
+        }
+        break;
       case "copy": {
         const last = this.state.items.findLast((i) => i.role === "assistant");
         if (!last) {
           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)`);
@@ -1539,7 +1692,7 @@ ${sandboxFiles(this.opts.cwd).join("\n")}`);
         this.notify({ items: [], totals: { costUsd: 0, turns: 0 } });
         break;
       case "help": {
-        void import("./commands-QKDWUD4K.js").then(({ commandHelp }) => this.push("status", commandHelp()));
+        void import("./commands-Y5RUKBPS.js").then(({ commandHelp }) => this.push("status", commandHelp()));
         break;
       }
       case "quit":
@@ -2105,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: [
@@ -2155,7 +2308,7 @@ function registerTui(program2) {
 }
 
 // src/cli.tsx
-var VERSION = true ? "0.3.0" : "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-QKDWUD4K.js → commands-Y5RUKBPS.js}

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

package/dist/{preview-56UCV5A3.js → preview-PS7WJ2KO.js}

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

package/dist/tokens-XYGRRAXC.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+
+// src/quality/tokens.ts
+import { execFileSync } from "child_process";
+import fs from "fs";
+import path from "path";
+var HEX_RE = /#([0-9a-fA-F]{6}|[0-9a-fA-F]{3})\b/g;
+var VAR_DEF_RE = /(--[a-zA-Z0-9-_]+)\s*:\s*([^;]+);/g;
+function parseHex(hex) {
+  const raw = hex.replace("#", "");
+  const full = raw.length === 3 ? raw.split("").map((c) => c + c).join("") : raw;
+  if (full.length !== 6) return null;
+  const n = Number.parseInt(full, 16);
+  if (Number.isNaN(n)) return null;
+  return [n >> 16 & 255, n >> 8 & 255, n & 255];
+}
+function loadTokenIndex(cwd) {
+  const colors = /* @__PURE__ */ new Map();
+  const cssFiles = [];
+  const walk = (dir, depth) => {
+    if (depth > 4 || cssFiles.length > 30) return;
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) walk(full, depth + 1);
+      else if (entry.name.endsWith(".css")) cssFiles.push(full);
+    }
+  };
+  walk(path.join(cwd, "src"), 0);
+  walk(cwd, 1);
+  for (const file of cssFiles.slice(0, 30)) {
+    let text;
+    try {
+      text = fs.readFileSync(file, "utf8");
+    } catch {
+      continue;
+    }
+    for (const match of text.matchAll(VAR_DEF_RE)) {
+      const value = match[2].trim();
+      const hex = value.match(/#[0-9a-fA-F]{3,6}\b/)?.[0];
+      const rgbFn = /rgb\(\s*(\d+)[,\s]+(\d+)[,\s]+(\d+)/.exec(value);
+      let rgb = null;
+      if (hex) rgb = parseHex(hex);
+      else if (rgbFn) rgb = [Number(rgbFn[1]), Number(rgbFn[2]), Number(rgbFn[3])];
+      if (rgb) colors.set(match[1], { value, rgb });
+    }
+  }
+  return { colors };
+}
+var distance = (a, b) => Math.sqrt((a[0] - b[0]) ** 2 + (a[1] - b[1]) ** 2 + (a[2] - b[2]) ** 2);
+function scanDrift(cwd, source, index) {
+  if (index.colors.size === 0) return [];
+  let diff;
+  try {
+    diff = execFileSync("git", ["diff", "-U0", source, "--", "*.css", "*.tsx", "*.jsx", "*.ts", "*.html"], {
+      cwd,
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+  } catch {
+    return [];
+  }
+  const findings = [];
+  let currentFile = "";
+  for (const line of diff.split("\n")) {
+    if (line.startsWith("+++ b/")) {
+      currentFile = line.slice(6);
+      continue;
+    }
+    if (!line.startsWith("+") || line.startsWith("+++")) continue;
+    if (/--[a-zA-Z0-9-_]+\s*:/.test(line)) continue;
+    for (const match of line.matchAll(HEX_RE)) {
+      const rgb = parseHex(match[0]);
+      if (!rgb) continue;
+      let best = null;
+      for (const [token, entry] of index.colors) {
+        const d = distance(rgb, entry.rgb);
+        if (!best || d < best.d) best = { token, d };
+      }
+      if (best) {
+        findings.push({ file: currentFile, literal: match[0], token: best.token, distance: Math.round(best.d) });
+      }
+      if (findings.length >= 10) return findings;
+    }
+  }
+  return findings;
+}
+function driftSummary(findings) {
+  return findings.map(
+    (f) => `${f.file}: ${f.literal} \u2192 use var(${f.token})${f.distance === 0 ? " (exact match)" : ` (closest, \u0394${f.distance})`}`
+  ).join("\n");
+}
+export {
+  driftSummary,
+  loadTokenIndex,
+  parseHex,
+  scanDrift
+};

package/package.json

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