@aayambansal/squint 0.3.0 → 0.3.1

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-CFWKEIJJ.js → chunk-IH4L2KR6.js}

@@ -19,6 +19,7 @@ var COMMANDS = [
   { 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/{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/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   completeCommand
-} from "./chunk-CFWKEIJJ.js";
+} from "./chunk-IH4L2KR6.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")}`
@@ -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"));
@@ -672,6 +672,7 @@ var Session = class {
   fixAttempts = 0;
   reviewTipShown = false;
   lastPulse = null;
+  lastPerf = null;
   autoReviewedThisAsk = false;
   startedAt = Date.now();
   subscribe(listener) {
@@ -733,6 +734,41 @@ 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();
+  }
   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 +979,18 @@ 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 {
+        }
+      }
       const before = this.state.totals.costUsd;
       this.notify({
         totals: {
@@ -1018,6 +1066,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 +1132,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.
@@ -1295,6 +1363,13 @@ They are objective defects, not style preferences.`
         })();
         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) {
@@ -1539,7 +1614,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-E7JIVJDP.js").then(({ commandHelp }) => this.push("status", commandHelp()));
         break;
       }
       case "quit":
@@ -2155,7 +2230,7 @@ function registerTui(program2) {
 }
 
 // src/cli.tsx
-var VERSION = true ? "0.3.0" : "0.0.0-dev";
+var VERSION = true ? "0.3.1" : "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-E7JIVJDP.js}

@@ -3,7 +3,7 @@ import {
   COMMANDS,
   commandHelp,
   completeCommand
-} from "./chunk-CFWKEIJJ.js";
+} from "./chunk-IH4L2KR6.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.1",
   "description": "Lovable for your terminal — a frontend harness on top of Claude Code, Codex, and other coding agents.",
   "type": "module",
   "license": "MIT",