@aayambansal/squint 0.4.1 → 0.4.2

package/dist/{cdp-UGLMW5R5.js → cdp-TPP2RGSR.js}

@@ -4,7 +4,7 @@ import {
   hasWebSocket,
   pixelDiffPct,
   runFlow
-} from "./chunk-7YKO5MMN.js";
+} from "./chunk-Y47X4ENN.js";
 export {
   cdpCapture,
   hasWebSocket,

package/dist/{chunk-H5K55LXY.js → chunk-KGZILC3S.js}

@@ -1,25 +1,70 @@
 #!/usr/bin/env node
 
 // src/prompt/skills.ts
-import fs2 from "fs";
-import path2 from "path";
+import fs3 from "fs";
+import path3 from "path";
 
-// src/prompt/registry.ts
+// src/session/designLog.ts
 import fs from "fs";
 import path from "path";
+function logFile(cwd) {
+  return path.join(cwd, ".squint", "design-log.jsonl");
+}
+function appendDecision(cwd, entry) {
+  try {
+    fs.mkdirSync(path.join(cwd, ".squint"), { recursive: true });
+    const record = { ts: (/* @__PURE__ */ new Date()).toISOString(), ...entry };
+    fs.appendFileSync(logFile(cwd), JSON.stringify(record) + "\n");
+  } catch {
+  }
+}
+function loadDecisions(cwd, limit = 8) {
+  try {
+    const lines = fs.readFileSync(logFile(cwd), "utf8").trim().split("\n");
+    const decisions = [];
+    for (const line of lines.slice(-limit * 2)) {
+      try {
+        const parsed = JSON.parse(line);
+        if (typeof parsed?.decision === "string" && typeof parsed?.ts === "string") decisions.push(parsed);
+      } catch {
+      }
+    }
+    return decisions.slice(-limit);
+  } catch {
+    return [];
+  }
+}
+function decisionsSection(cwd) {
+  const decisions = loadDecisions(cwd);
+  if (decisions.length === 0) return "";
+  const lines = decisions.map((d) => {
+    const days = Math.floor((Date.now() - Date.parse(d.ts)) / 864e5);
+    const age = days <= 0 ? "today" : `${days}d ago`;
+    return `- ${d.decision} (${d.source}, ${age}${d.screenshot ? `, evidence: ${d.screenshot}` : ""})`;
+  });
+  return `## Design decisions on record
+
+${lines.join("\n")}
+
+These were decided deliberately. Do not silently undo them; if a task genuinely requires reversing one, say so explicitly first.`;
+}
+
+// src/prompt/registry.ts
+import fs2 from "fs";
+import path2 from "path";
 function loadComponentInventory(cwd) {
   let config;
   try {
-    config = JSON.parse(fs.readFileSync(path.join(cwd, "components.json"), "utf8"));
+    config = JSON.parse(fs2.readFileSync(path2.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);
+  const uiDir = path2.join(cwd, relative);
   let entries;
   try {
-    entries = fs.readdirSync(uiDir);
+    entries = fs2.readdirSync(uiDir);
   } catch {
     return null;
   }
@@ -55,17 +100,17 @@ function parseSkill(name, raw) {
   return { name, triggers, body };
 }
 function loadSkills(cwd) {
-  const dir = path2.join(cwd, ".squint", "skills");
+  const dir = path3.join(cwd, ".squint", "skills");
   let entries;
   try {
-    entries = fs2.readdirSync(dir).filter((f) => f.endsWith(".md"));
+    entries = fs3.readdirSync(dir).filter((f) => f.endsWith(".md"));
   } catch {
     return [];
   }
   const skills = [];
   for (const entry of entries.sort()) {
     try {
-      const skill = parseSkill(entry.replace(/\.md$/, ""), fs2.readFileSync(path2.join(dir, entry), "utf8"));
+      const skill = parseSkill(entry.replace(/\.md$/, ""), fs3.readFileSync(path3.join(dir, entry), "utf8"));
       if (skill) skills.push(skill);
     } catch {
     }
@@ -74,7 +119,7 @@ function loadSkills(cwd) {
 }
 function loadRules(cwd) {
   try {
-    const text = fs2.readFileSync(path2.join(cwd, ".squint", "rules.md"), "utf8").trim();
+    const text = fs3.readFileSync(path3.join(cwd, ".squint", "rules.md"), "utf8").trim();
     return text.length > 0 ? text : null;
   } catch {
     return null;
@@ -86,7 +131,7 @@ function matchSkills(skills, ask) {
 }
 function loadLocks(cwd) {
   try {
-    return fs2.readFileSync(path2.join(cwd, ".squint", "locks"), "utf8").split("\n").map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+    return fs3.readFileSync(path3.join(cwd, ".squint", "locks"), "utf8").split("\n").map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
   } catch {
     return [];
   }
@@ -97,6 +142,8 @@ function enrich(cwd, ask) {
   if (rules) parts.push(`## Project rules (always apply)
 
 ${rules}`);
+  const decisions = decisionsSection(cwd);
+  if (decisions) parts.push(decisions);
   const inventory = loadComponentInventory(cwd);
   if (inventory) parts.push(inventorySection(inventory));
   const locks = loadLocks(cwd);
@@ -124,6 +171,7 @@ ${parts.join("\n\n")}` : "",
 }
 
 export {
+  appendDecision,
   parseSkill,
   loadSkills,
   loadRules,

package/dist/{chunk-SVKV77TO.js → chunk-S3WV5C3X.js}

@@ -26,6 +26,7 @@ var COMMANDS = [
   { name: "copy", group: "session", description: "copy the last reply to the clipboard" },
   { name: "save", group: "session", description: "export the transcript to .squint/transcripts/" },
   { name: "find", args: "<term>", group: "session", description: "search this session and saved transcripts" },
+  { name: "decide", args: "<text>", group: "session", description: "record a design decision; injected into every future ask" },
   { name: "resume", group: "session", description: "pick up the previous session for this repo" },
   { name: "clear", group: "session", description: "new session (transcript, totals, persisted state)" },
   { name: "help", group: "session", description: "list commands" },

package/dist/{chunk-UTBTLCUO.js → chunk-WCLQZFOR.js}

@@ -9,7 +9,7 @@ import {
 import {
   cdpCapture,
   hasWebSocket
-} from "./chunk-7YKO5MMN.js";
+} from "./chunk-Y47X4ENN.js";
 
 // src/preview/preview.ts
 import fs from "fs";
@@ -47,7 +47,7 @@ async function captureViewports(cwd, url) {
   const base = url.replace(/\/+$/, "");
   if (hasWebSocket()) {
     try {
-      const { report, shots: shots2, a11y, slop, narration } = await cdpCapture(chrome, url, dir, VIEWPORTS, 2500, true);
+      const { report, shots: shots2, a11y, slop, narration, phantoms } = 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, narration };
+      return { shots: shots2, errors: errors2, runtime: report, a11y, slop, narration, phantoms };
     } 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-UGLMW5R5.js");
+  const { pixelDiffPct } = await import("./cdp-TPP2RGSR.js");
   return pixelDiffPct(chrome, previous, current);
 }
 function buildRuntimeFixPrompt(report) {
@@ -161,6 +161,16 @@ ${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 phantomSection(phantoms) {
+  if (!phantoms || phantoms.length === 0) return "";
+  return `
+
+## Phantom classes (in the DOM, absent from the CSS)
+
+${phantoms.join("\n")}
+
+Each of these is an element silently unstyled \u2014 usually a misspelled or version-mismatched utility (Tailwind v3 spellings in a v4 project) or a concatenated class the scanner never compiled. Fix the class names or define the styles.`;
+}
 function slopSection(findings) {
   if (!findings || findings.length === 0) return "";
   return `
@@ -171,13 +181,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, narration) {
+function buildReviewPrompt(shots, extra, runtime, a11y, slop, narration, phantoms) {
   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)}${narrationSection(narration)}`;
+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)}${phantomSection(phantoms)}`;
 }
 
 export {

package/dist/{chunk-7YKO5MMN.js → chunk-Y47X4ENN.js}

@@ -329,6 +329,37 @@ var SLOP_AUDIT = `(() => {
   }
   return out.slice(0, 8);
 })()`;
+var PHANTOM_AUDIT = `(() => {
+  const defined = new Set();
+  for (const sheet of document.styleSheets) {
+    let rules; try { rules = sheet.cssRules; } catch { continue; }
+    const walk = (list) => {
+      for (const rule of list) {
+        if (rule.selectorText) {
+          for (const m of rule.selectorText.matchAll(/\\.((?:[\\w-]|\\\\.)+)/g)) {
+            defined.add(m[1].replace(/\\\\(.)/g, '$1'));
+          }
+        }
+        if (rule.cssRules) walk(rule.cssRules);
+      }
+    };
+    walk(rules);
+  }
+  if (defined.size < 10) return []; // no CSSOM visibility \u2014 stay silent
+  const seen = new Map();
+  for (const el of document.querySelectorAll('[class]')) {
+    for (const cls of el.classList) {
+      if (cls.length < 3) continue;
+      if (!defined.has(cls) && !seen.has(cls)) seen.set(cls, el.tagName.toLowerCase());
+    }
+  }
+  const out = [];
+  for (const [cls, tag] of seen) {
+    out.push(cls + ' (on <' + tag + '>)');
+    if (out.length >= 12) break;
+  }
+  return out;
+})()`;
 async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, audit = false) {
   const { child, wsUrl, profileDir } = await launchChrome(chromePath);
   const report = { consoleErrors: [], pageErrors: [], failedRequests: [] };
@@ -337,6 +368,7 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
   let slop = [];
   let perf = {};
   let narration = [];
+  let phantoms = [];
   const requests = /* @__PURE__ */ new Map();
   let connection = null;
   try {
@@ -409,6 +441,15 @@ async function cdpCapture(chromePath, url, outDir, viewports, settleMs = 2500, a
         if (Array.isArray(result?.value)) slop = result.value.map(String);
       } catch {
       }
+      try {
+        const { result } = await connection.send(
+          "Runtime.evaluate",
+          { expression: PHANTOM_AUDIT, returnByValue: true },
+          sessionId
+        );
+        if (Array.isArray(result?.value)) phantoms = result.value.map(String);
+      } catch {
+      }
       try {
         await connection.send("Accessibility.enable", {}, sessionId);
         const { nodes } = await connection.send("Accessibility.getFullAXTree", {}, sessionId);
@@ -473,7 +514,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, narration };
+  return { report, shots, a11y, slop, perf, narration, phantoms };
 }
 
 export {

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   completeCommand
-} from "./chunk-SVKV77TO.js";
+} from "./chunk-S3WV5C3X.js";
 import {
   applySandbox,
   discardSandbox,
@@ -42,7 +42,7 @@ import {
   comparePulse,
   probeRuntime,
   runtimeSummary
-} from "./chunk-UTBTLCUO.js";
+} from "./chunk-WCLQZFOR.js";
 import {
   clearState,
   loadState,
@@ -58,10 +58,11 @@ import {
   detectEngines,
   getEngine
 } from "./chunk-KVYGPLWW.js";
-import "./chunk-7YKO5MMN.js";
+import "./chunk-Y47X4ENN.js";
 import {
+  appendDecision,
   enrich
-} from "./chunk-H5K55LXY.js";
+} from "./chunk-KGZILC3S.js";
 import {
   composePrompt
 } from "./chunk-P3H4N2EN.js";
@@ -238,7 +239,7 @@ function registerEnv(program2) {
       }
     }
     const { findChrome: findChrome2 } = await import("./chrome-SBV3H77F.js");
-    const { hasWebSocket } = await import("./cdp-UGLMW5R5.js");
+    const { hasWebSocket } = await import("./cdp-TPP2RGSR.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")}`
@@ -262,7 +263,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-ODOVNE6E.js");
+    const { loadRules, loadSkills } = await import("./skills-U2J7Z3B2.js");
     const cwd = process.cwd();
     const rules = loadRules(cwd);
     console.log(
@@ -461,7 +462,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-6MML2NEG.js");
+    const { captureViewports: captureViewports2 } = await import("./preview-SKHIXVCE.js");
     const result = await captureViewports2(process.cwd(), url);
     if (!result) {
       console.error(pc4.red("\u2717 no Chrome/Chromium found"));
@@ -823,7 +824,7 @@ ${question}`,
         return;
       }
       await this.runTurn(
-        buildReviewPrompt(result.shots, void 0, result.runtime, result.a11y, result.slop, result.narration),
+        buildReviewPrompt(result.shots, void 0, result.runtime, result.a11y, result.slop, result.narration, result.phantoms),
         `\u{1F441} polish round ${round}/${rounds}`
       );
     }
@@ -1141,7 +1142,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, captureResult.narration),
+                  buildReviewPrompt(captureResult.shots, void 0, captureResult.runtime, captureResult.a11y, captureResult.slop, captureResult.narration, captureResult.phantoms),
                   "\u{1F441} auto-review rendered UI"
                 );
               }
@@ -1189,6 +1190,7 @@ ${errors.slice(-5).join("\n")}`);
     const result = restoreSnapshot(this.opts.cwd, checkpoint.snapshot);
     if (result.restored) {
       const dropped = this.checkpoints.length - index;
+      appendDecision(this.opts.cwd, { decision: `rejected and rolled back: "${checkpoint.label}"`, source: "restore" });
       this.checkpoints = this.checkpoints.slice(0, index);
       this.push(
         "status",
@@ -1280,6 +1282,20 @@ ${errors.slice(-5).join("\n")}`);
         this.push("status", "runtime clean \u2014 no console errors, exceptions, or failed requests");
       }
     }
+    if (result.phantoms && result.phantoms.length > 0) {
+      this.push("error", `phantom classes: ${result.phantoms.length} (in the DOM, absent from CSS)
+${result.phantoms.slice(0, 5).join("\n")}`);
+      this.addProblem(
+        "runtime",
+        `${result.phantoms.length} phantom class(es) \u2014 elements silently unstyled`,
+        `These class tokens appear in the DOM but match no CSS rule, so the elements are silently unstyled. Usually a misspelled or version-mismatched utility (e.g. Tailwind v3 spellings in a v4 project) or a concatenated class the scanner never compiled:
+
+${result.phantoms.join("\n")}
+
+Fix the class names or define the styles, then confirm visually.`
+      );
+      this.push("status", "/fix sends open problems to the engine");
+    }
     if (result.slop && result.slop.length > 0) {
       this.push("status", `distinctiveness: ${result.slop.length} tell(s)
 ${result.slop.join("\n")}`);
@@ -1395,6 +1411,19 @@ They are objective defects, not style preferences.`
         }
         break;
       }
+      case "decide": {
+        if (!arg) {
+          this.push("status", "usage: /decide <the decision> \u2014 recorded in .squint/design-log.jsonl and injected into every future ask");
+          break;
+        }
+        appendDecision(this.opts.cwd, {
+          decision: arg,
+          source: "decide",
+          screenshot: this.lastPulse ? ".squint/preview/pulse.png" : void 0
+        });
+        this.push("status", `decision recorded: ${arg}`);
+        break;
+      }
       case "find": {
         if (!arg) {
           this.push("status", "usage: /find <term> \u2014 searches this session and saved transcripts");
@@ -1491,8 +1520,8 @@ They are objective defects, not style preferences.`
             this.push("error", "no Chrome/Chromium found for flows");
             return;
           }
-          const { runFlow } = await import("./cdp-UGLMW5R5.js");
-          const { previewDir } = await import("./preview-6MML2NEG.js");
+          const { runFlow } = await import("./cdp-TPP2RGSR.js");
+          const { previewDir } = await import("./preview-SKHIXVCE.js");
           this.push("status", `replaying ${flows.length} flow(s)\u2026`);
           this.notify({ running: true, runStartedAt: Date.now() });
           const failures = [];
@@ -1630,7 +1659,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, result.narration),
+              buildReviewPrompt(result.shots, arg || void 0, result.runtime, result.a11y, result.slop, result.narration, result.phantoms),
               `\u{1F441} review rendered UI${arg ? ` \xB7 ${arg}` : ""}`
             );
           }
@@ -1709,6 +1738,7 @@ ${sandboxFiles(this.opts.cwd).join("\n")}`);
             discardSandbox(this.opts.cwd);
             this.notify({ sandbox: false });
             this.resetDevServer();
+            appendDecision(this.opts.cwd, { decision: "accepted the sandboxed session onto the real tree", source: "sandbox" });
             this.push("status", "sandbox applied to the real tree \u2014 review with git diff");
           } else {
             this.push("error", applied.detail ?? "apply failed");
@@ -1750,6 +1780,7 @@ ${sandboxFiles(this.opts.cwd).join("\n")}`);
           const applied = applyVariant(this.opts.cwd, id);
           if (applied.ok) {
             cleanVariants(this.opts.cwd);
+            appendDecision(this.opts.cwd, { decision: `chose the ${id} direction over the other variants`, source: "variant" });
             this.push("status", `applied ${id} to the working tree \u2014 review with git diff`);
           } else {
             this.push("error", applied.detail ?? "apply failed");
@@ -1814,7 +1845,7 @@ ${sandboxFiles(this.opts.cwd).join("\n")}`);
         this.notify({ items: [], totals: { costUsd: 0, turns: 0 } });
         break;
       case "help": {
-        void import("./commands-DE5Q7VWY.js").then(({ commandHelp }) => this.push("status", commandHelp()));
+        void import("./commands-B6I6C5LP.js").then(({ commandHelp }) => this.push("status", commandHelp()));
         break;
       }
       case "quit":
@@ -2433,7 +2464,7 @@ function registerTui(program2) {
 }
 
 // src/cli.tsx
-var VERSION = true ? "0.4.1" : "0.0.0-dev";
+var VERSION = true ? "0.4.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-DE5Q7VWY.js → commands-B6I6C5LP.js}

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

package/dist/{preview-6MML2NEG.js → preview-SKHIXVCE.js}

@@ -10,11 +10,11 @@ import {
   probeRuntime,
   routeShotName,
   runtimeSummary
-} from "./chunk-UTBTLCUO.js";
+} from "./chunk-WCLQZFOR.js";
 import "./chunk-O2S6PAJE.js";
 import "./chunk-IMDRXXFU.js";
 import "./chunk-KVYGPLWW.js";
-import "./chunk-7YKO5MMN.js";
+import "./chunk-Y47X4ENN.js";
 export {
   VIEWPORTS,
   buildReviewPrompt,

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

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

package/package.json

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