@aayambansal/squint 0.2.0 → 0.2.1

package/README.md

@@ -86,10 +86,11 @@ From source: `git clone https://github.com/aayambansal/squint.git && cd squint &
    and catches what the server never prints: blank pages, exceptions, failed requests.
 5. **The agent looks at its work.** `/review` screenshots mobile/tablet/desktop and
    re-prompts the engine to critique what it can see — then fix it.
-6. **Gates keep it honest.** `/check` runs typecheck, lint, test, build — failures come
-   back with orders not to weaken the checks.
-7. **Everything is reversible.** Each ask is snapshotted via git plumbing; `/undo` reverts
-   the whole turn while your own uncommitted work survives.
+6. **Gates keep it honest.** Typecheck + lint run automatically after *every* turn and
+   auto-fix (capped); `/check` adds tests and the build — failures come back with orders
+   not to weaken the checks.
+7. **Everything is reversible.** Every ask records a checkpoint; `/undo` pops the last,
+   `/restore <n>` rewinds files to any earlier point — your own uncommitted work survives.
 8. **Point at things.** Alt+S in the browser, click any element, and a self-locating
    reference lands on your clipboard to paste into squint.
 9. **Explore in parallel.** `squint variants gen 3 "<ask>"` builds the same ask three ways —
@@ -129,11 +130,24 @@ squint config set engine claude
 squint config set models.claude claude-sonnet-5
 squint config set autoDev true    # dev server starts with the TUI
 squint config set autoFix true    # errors auto-route back (max 2 tries)
+squint config set autoCheck false # skip the per-turn typecheck+lint pass
+squint config set theme ocean     # amber · ocean · moss · rose · mono
+squint config set bell false      # no bell on turn completion
 squint doctor                     # engines + Chrome + WebSocket check
 ```
 
-Inside the TUI: `/dev` `/check` `/fix` `/shot` `/review [focus]` `/undo` `/resume`
-`/engine <id>` `/model <name>` `/clear` — `Esc` interrupts, arrows recall history.
+**Inside the TUI:**
+
+- **Modes**: `shift+tab` cycles `safe` (edits auto-approved) → `plan` (read-only
+  investigation) → `yolo` (no friction), mapped to each engine's native permission flags.
+- **Type ahead**: keep typing while the agent works — Enter queues asks that dispatch in
+  order; `/queue clear` drops them. `Esc` interrupts the current turn.
+- **Editing**: a real line editor — arrows move, `alt+←/→` jump words, `ctrl+a/e/k/u/w`,
+  `↑/↓` history. `ctrl+c` twice exits with a session summary.
+- **Commands**: `/dev` `/check` `/fix` `/shot` `/review [focus]` `/undo` `/checkpoints`
+  `/restore <n>` `/mode` `/theme` `/resume` `/engine <id>` `/model <name>` `/clear`.
+- Assistant output renders as markdown; the footer tracks session turns and cost; a bell
+  rings when a turn finishes.
 
 ## Design directions
 

package/dist/{chrome-K4BKFOYS.js → chrome-RD7XQ767.js}

@@ -2,8 +2,8 @@
 import {
   findChrome,
   screenshot
-} from "./chunk-Z46MXU64.js";
-import "./chunk-MCYQXOE7.js";
+} from "./chunk-P3V5CWH5.js";
+import "./chunk-2LRIKWBU.js";
 export {
   findChrome,
   screenshot

package/dist/{chunk-ZJOU46X4.js → chunk-2IW2MMCY.js}

@@ -1,7 +1,17 @@
 #!/usr/bin/env node
+import {
+  variantsRoot
+} from "./chunk-LCS47EAG.js";
+import {
+  findChrome,
+  screenshot
+} from "./chunk-P3V5CWH5.js";
 import {
   lineSplitter
-} from "./chunk-MCYQXOE7.js";
+} from "./chunk-2LRIKWBU.js";
+
+// src/variants/shots.ts
+import path2 from "path";
 
 // src/devserver/devserver.ts
 import { spawn } from "child_process";
@@ -149,8 +159,55 @@ ${errorBlock}
 ${context}`;
 }
 
+// src/variants/shots.ts
+var URL_TIMEOUT_MS = 45e3;
+function waitForUrl(server) {
+  return new Promise((resolve) => {
+    const startedAt = Date.now();
+    const poll = setInterval(() => {
+      if (server.url) {
+        clearInterval(poll);
+        resolve(server.url);
+      } else if (Date.now() - startedAt > URL_TIMEOUT_MS || server.state === "crashed") {
+        clearInterval(poll);
+        resolve(null);
+      }
+    }, 200);
+  });
+}
+async function screenshotVariants(cwd, variants) {
+  const chrome = findChrome();
+  if (!chrome) {
+    return variants.map((v) => ({ familyId: v.family.id, error: "no Chrome found" }));
+  }
+  const shots = [];
+  for (const variant of variants) {
+    const command = detectDevCommand(variant.dir);
+    if (!command) {
+      shots.push({ familyId: variant.family.id, error: "no dev script" });
+      continue;
+    }
+    const server = new DevServer(variant.dir);
+    server.start(command);
+    const url = await waitForUrl(server);
+    if (!url) {
+      server.stop();
+      shots.push({ familyId: variant.family.id, error: "dev server did not announce a URL" });
+      continue;
+    }
+    const outPath = path2.join(variantsRoot(cwd), `${variant.family.id}.png`);
+    const result = await screenshot(chrome, url, outPath, { width: 1440, height: 900 });
+    server.stop();
+    shots.push(
+      result.ok ? { familyId: variant.family.id, path: outPath } : { familyId: variant.family.id, error: result.error }
+    );
+  }
+  return shots;
+}
+
 export {
   detectDevCommand,
   DevServer,
-  buildFixPrompt
+  buildFixPrompt,
+  screenshotVariants
 };

package/dist/{chunk-7XUORM3K.js → chunk-LCS47EAG.js}

@@ -1,14 +1,12 @@
 #!/usr/bin/env node
 import {
   FAMILIES,
+  FIRST_TURN_ADDENDUM,
   renderFamilyBrief
-} from "./chunk-5IR2AZVK.js";
+} from "./chunk-P3H4N2EN.js";
 import {
   runAgent
-} from "./chunk-FPTBBHOH.js";
-import {
-  FIRST_TURN_ADDENDUM
-} from "./chunk-NT2HR4RD.js";
+} from "./chunk-OTG4ZB4R.js";
 
 // src/variants/variants.ts
 import { execFileSync } from "child_process";

package/dist/{chunk-FPTBBHOH.js → chunk-OTG4ZB4R.js}

@@ -3,7 +3,7 @@ import {
   findEngineBinary,
   lineSplitter,
   truncate
-} from "./chunk-MCYQXOE7.js";
+} from "./chunk-2LRIKWBU.js";
 
 // src/runner/run.ts
 import { spawn } from "child_process";

package/dist/{chunk-5IR2AZVK.js → chunk-P3H4N2EN.js}

@@ -1,7 +1,60 @@
 #!/usr/bin/env node
-import {
-  DEFAULT_BRIEF
-} from "./chunk-NT2HR4RD.js";
+
+// src/prompt/brief.ts
+import fs from "fs";
+import path from "path";
+var DEFAULT_BRIEF = `You are acting as a senior product designer and frontend engineer. Treat every change as production work, not a demo.
+
+Direction before code:
+- Commit to one specific visual direction derived from what this product is for, and state it in one sentence before implementing. If the direction could be guessed from the product category alone, sharpen it until it couldn't.
+- Choose a color strategy deliberately: restrained (neutrals + one accent), committed (one dominant color owning 30\u201360% of the surface), or a small palette of 3\u20135 named roles. Never purple/violet gradients unless asked. Body text contrast stays at least 4.5:1 \u2014 no light gray body copy "for elegance".
+- Typography: at most two families, paired on contrast (display serif + geometric sans, or sans + mono). Never Inter/Roboto/Open Sans/system defaults for display type. Pair weight extremes (300 against 700\u2013900); display sizes jump 3x over body, not 1.5x.
+
+Tokens are the system:
+- Define or extend design tokens (CSS variables / theme config) first, then compose the UI from them. Never scatter literal colors or one-off spacing values through components.
+- One spacing rhythm on a 4/8px grid; one type scale with a ratio of at least 1.25 between steps.
+
+Banned tells \u2014 these read instantly as machine-generated:
+- Purple gradient on white; glassmorphism cards; cream/beige page background as a reflex "warmth" move
+- Emoji as icons; identical icon-topped card grids; stat banner rows; numbered 01/02/03 section markers
+- Tiny all-caps tracked eyebrow labels over every section; gradient text; colored left-border strips on cards
+- Centered hero + badge + three feature cards; unmodified component-library defaults
+If someone could look at the result and say "AI made that" without doubt, it has failed.
+
+Craft details:
+- Every interactive element gets hover, focus-visible, and active treatment; keyboard focus stays visible.
+- Anything that loads data gets loading, empty, and error states.
+- Motion: 150\u2013250ms ease-out; one orchestrated entrance with staggered reveals beats scattered micro-interactions; honor prefers-reduced-motion; never leave content invisible until a scroll observer fires.
+- Body line length 65\u201375ch; text-wrap: balance on headings.
+
+Engineering:
+- Follow the repo's existing conventions and extend its patterns; new components in new files, small and focused; semantic HTML.
+- Responsive from 360px up with no horizontal overflow \u2014 check intermediate widths, not just phone and desktop.
+- Let errors surface instead of swallowing them in try/catch; log clearly so failures can be traced.
+- Not done until the app builds cleanly, typechecks, and renders without console errors.`;
+var FIRST_TURN_ADDENDUM = `This is the opening move on this task: establish the design foundation before building. State the visual direction, set up the tokens/theme first, then build components from them. The first render should feel like a designed product, not a scaffold \u2014 impressive on sight.`;
+function loadBrief(cwd) {
+  const custom = path.join(cwd, ".squint", "brief.md");
+  try {
+    const text = fs.readFileSync(custom, "utf8").trim();
+    if (text.length > 0) return text;
+  } catch {
+  }
+  return DEFAULT_BRIEF;
+}
+function composePrompt(ask, opts) {
+  if (opts.noBrief) return ask;
+  const brief = loadBrief(opts.cwd);
+  const firstTurn = opts.firstTurn ?? true;
+  const addendum = firstTurn ? `
+
+${FIRST_TURN_ADDENDUM}` : "";
+  return `${brief}${addendum}
+
+## Task
+
+${ask}`;
+}
 
 // src/prompt/families.ts
 var FAMILIES = [
@@ -121,6 +174,8 @@ ${coreStandards()}`;
 }
 
 export {
+  FIRST_TURN_ADDENDUM,
+  composePrompt,
   FAMILIES,
   getFamily,
   renderFamilyBrief

package/dist/{chunk-Z46MXU64.js → chunk-P3V5CWH5.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   findBinary
-} from "./chunk-MCYQXOE7.js";
+} from "./chunk-2LRIKWBU.js";
 
 // src/preview/chrome.ts
 import { spawn } from "child_process";

package/dist/{chunk-4MMIJXYD.js → chunk-REDPR3KI.js}

@@ -6,7 +6,7 @@ import {
 import {
   findChrome,
   screenshot
-} from "./chunk-Z46MXU64.js";
+} from "./chunk-P3V5CWH5.js";
 
 // src/preview/preview.ts
 import fs2 from "fs";

package/dist/{chunk-W6MYXQIU.js → chunk-VNLM53RJ.js}

@@ -79,10 +79,11 @@ const PICKER = \`(() => {
   addEventListener('keydown', (e) => {
     if (e.altKey && (e.key === 's' || e.key === 'S' || e.code === 'KeyS')) {
       active = !active;
-      if (!active) { box.style.display = 'none'; tip.style.display = 'none'; }
-      else toast('squint picker on \u2014 click an element (esc to cancel)');
+      if (!active) { window.__squintFinishNote?.(true); window.__squintCompile?.(); box.style.display = 'none'; tip.style.display = 'none'; }
+      else toast('squint picker on \u2014 click elements to pin, alt+enter copies all (esc cancels)');
     } else if (e.key === 'Escape' && active) {
-      active = false; box.style.display = 'none'; tip.style.display = 'none';
+      active = false; window.__squintFinishNote?.(false); window.__squintClearPins?.();
+      box.style.display = 'none'; tip.style.display = 'none';
     }
   });
   addEventListener('mousemove', (e) => {
@@ -97,16 +98,65 @@ const PICKER = \`(() => {
     tip.style.top = Math.max(r.top - 26, 2) + 'px';
     tip.textContent = '<' + s.tag + '> ' + rel(s.file);
   }, true);
+  // Multi-pin annotations: each click drops a numbered pin with a note;
+  // alt+enter (or toggling the picker off) compiles them into one blob.
+  const pins = [];
+  const badges = [];
+  const noteBox = document.createElement('input');
+  noteBox.style.cssText = 'position:fixed;z-index:2147483647;background:#1b1b1b;color:#fff;border:2px solid #e8a33d;border-radius:3px;padding:4px 8px;font:12px ui-monospace,monospace;display:none;width:280px;outline:none;';
+  noteBox.placeholder = 'note for this pin \u2014 enter to keep, esc to drop';
+  document.documentElement.append(noteBox);
+  let pending = null;
+  const addBadge = (el, n) => {
+    const r = el.getBoundingClientRect();
+    const b = document.createElement('div');
+    b.textContent = String(n);
+    b.style.cssText = 'position:fixed;z-index:2147483647;background:#e8a33d;color:#1b1b1b;font:bold 11px ui-monospace,monospace;border-radius:8px;min-width:16px;height:16px;text-align:center;line-height:16px;pointer-events:none;';
+    b.style.left = Math.max(r.left - 6, 2) + 'px';
+    b.style.top = Math.max(r.top - 6, 2) + 'px';
+    document.documentElement.append(b);
+    badges.push(b);
+  };
+  const clearPins = () => { pins.length = 0; badges.forEach((b) => b.remove()); badges.length = 0; };
+  const compile = () => {
+    if (pins.length === 0) return;
+    const blob = pins.length === 1 && !pins[0].note
+      ? pins[0].ref
+      : pins.map((p, i) => (i + 1) + '. ' + p.ref + (p.note ? ' \u2014 ' + p.note : '')).join('\\\\n');
+    window.__squintLastPick = blob;
+    const count = pins.length;
+    clearPins();
+    const done = () => toast('copied ' + count + ' annotation' + (count === 1 ? '' : 's') + ' \u2014 paste into squint');
+    if (navigator.clipboard?.writeText) navigator.clipboard.writeText(blob).then(done, done);
+    else done();
+  };
+  const finishNote = (keep) => {
+    if (!pending) return;
+    if (keep) { pins.push({ ref: pending.ref, note: noteBox.value.trim() }); addBadge(pending.el, pins.length); }
+    pending = null; noteBox.value = ''; noteBox.style.display = 'none';
+  };
+  noteBox.addEventListener('keydown', (e) => {
+    e.stopPropagation();
+    if (e.key === 'Enter') { finishNote(true); if (e.altKey) { compile(); active = false; box.style.display = 'none'; } }
+    else if (e.key === 'Escape') finishNote(false);
+  });
+  window.__squintFinishNote = finishNote;
+  window.__squintCompile = compile;
+  window.__squintClearPins = clearPins;
+  addEventListener('keydown', (e) => {
+    if (active && e.altKey && e.key === 'Enter') { finishNote(true); compile(); active = false; box.style.display = 'none'; tip.style.display = 'none'; }
+  });
   addEventListener('click', (e) => {
-    if (!active) return;
+    if (!active || e.target === noteBox) return;
     e.preventDefault(); e.stopPropagation();
+    finishNote(true);
     const el = find(e.target); if (!el) return;
-    const ref = describe(el);
-    window.__squintLastPick = ref;
-    const done = () => toast('copied \u2014 paste into squint: ' + ref);
-    if (navigator.clipboard?.writeText) navigator.clipboard.writeText(ref).then(done, done);
-    else done();
-    active = false; box.style.display = 'none';
+    pending = { el, ref: describe(el) };
+    const r = el.getBoundingClientRect();
+    noteBox.style.display = 'block';
+    noteBox.style.left = Math.min(r.left, innerWidth - 310) + 'px';
+    noteBox.style.top = Math.min(r.bottom + 4, innerHeight - 34) + 'px';
+    noteBox.focus();
   }, true);
 })();\`
 `;

package/dist/chunk-XZKQZKEE.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+
+// src/prompt/skills.ts
+import fs from "fs";
+import path from "path";
+var FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n?/;
+function parseSkill(name, raw) {
+  const match = FRONTMATTER_RE.exec(raw);
+  if (!match) return null;
+  const body = raw.slice(match[0].length).trim();
+  const triggersLine = /(^|\n)triggers:[ \t]*(.*)/.exec(match[1]);
+  if (!triggersLine) return null;
+  let triggers;
+  const inline = triggersLine[2].trim();
+  if (inline.length > 0) {
+    triggers = inline.split(",").map((t) => t.trim().toLowerCase());
+  } else {
+    triggers = [...match[1].matchAll(/\n\s*-\s+(.+)/g)].map((m) => m[1].trim().toLowerCase());
+  }
+  triggers = triggers.filter((t) => t.length > 0);
+  if (triggers.length === 0 || body.length === 0) return null;
+  return { name, triggers, body };
+}
+function loadSkills(cwd) {
+  const dir = path.join(cwd, ".squint", "skills");
+  let entries;
+  try {
+    entries = fs.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"));
+      if (skill) skills.push(skill);
+    } catch {
+    }
+  }
+  return skills;
+}
+function loadRules(cwd) {
+  try {
+    const text = fs.readFileSync(path.join(cwd, ".squint", "rules.md"), "utf8").trim();
+    return text.length > 0 ? text : null;
+  } catch {
+    return null;
+  }
+}
+function matchSkills(skills, ask) {
+  const haystack = ask.toLowerCase();
+  return skills.filter((skill) => skill.triggers.some((t) => haystack.includes(t)));
+}
+function enrich(cwd, ask) {
+  const parts = [];
+  const rules = loadRules(cwd);
+  if (rules) parts.push(`## Project rules (always apply)
+
+${rules}`);
+  const matched = matchSkills(loadSkills(cwd), ask);
+  for (const skill of matched) {
+    parts.push(`## Project notes: ${skill.name}
+
+${skill.body}`);
+  }
+  return {
+    sections: parts.length > 0 ? `
+
+${parts.join("\n\n")}` : "",
+    matchedSkills: matched.map((s) => s.name)
+  };
+}
+
+export {
+  parseSkill,
+  loadSkills,
+  loadRules,
+  matchSkills,
+  enrich
+};

package/dist/cli.js

@@ -2,14 +2,21 @@
 import {
   DevServer,
   buildFixPrompt,
-  detectDevCommand
-} from "./chunk-ZJOU46X4.js";
+  detectDevCommand,
+  screenshotVariants
+} from "./chunk-2IW2MMCY.js";
 import {
-  runAgent
-} from "./chunk-FPTBBHOH.js";
+  applyVariant,
+  cleanVariants,
+  listVariants,
+  runVariants
+} from "./chunk-LCS47EAG.js";
 import {
   composePrompt
-} from "./chunk-NT2HR4RD.js";
+} from "./chunk-P3H4N2EN.js";
+import {
+  runAgent
+} from "./chunk-OTG4ZB4R.js";
 import {
   buildGatePrompt,
   detectFastGates,
@@ -25,14 +32,20 @@ import {
   probeRuntime,
   runtimeSummary,
   saveState
-} from "./chunk-4MMIJXYD.js";
+} from "./chunk-REDPR3KI.js";
 import "./chunk-VJGE7HSP.js";
-import "./chunk-Z46MXU64.js";
+import {
+  findChrome
+} from "./chunk-P3V5CWH5.js";
 import {
   detectEngines,
   getEngine
-} from "./chunk-MCYQXOE7.js";
+} from "./chunk-2LRIKWBU.js";
 import {
+  enrich
+} from "./chunk-XZKQZKEE.js";
+import {
+  isGitRepo,
   restoreSnapshot,
   takeSnapshot
 } from "./chunk-WTA6YYBY.js";
@@ -457,7 +470,12 @@ ${errors.slice(-5).join("\n")}`);
       if (this.checkpoints.length > 20) this.checkpoints.shift();
     }
     const isFirstTurn = this.sessionId === void 0;
-    const prompt = isFirstTurn ? composePrompt(ask, { cwd: this.opts.cwd, firstTurn: true }) : ask;
+    let prompt = isFirstTurn ? composePrompt(ask, { cwd: this.opts.cwd, firstTurn: true }) : ask;
+    const enrichment = enrich(this.opts.cwd, ask);
+    if (enrichment.matchedSkills.length > 0) {
+      this.push("status", `skills: ${enrichment.matchedSkills.join(", ")}`);
+    }
+    prompt += enrichment.sections;
     await this.runTurn(prompt, ask);
   }
   /** Restore files to the state before checkpoint `index`; drop it and everything after. */
@@ -659,6 +677,75 @@ ${result.a11y.slice(0, 5).join("\n")}`);
         this.push("status", `resumed ${saved.engine} session${saved.lastAsk ? ` \xB7 "${saved.lastAsk}"` : ""}`);
         break;
       }
+      case "variants": {
+        const [sub, ...subRest] = arg.split(/\s+/);
+        if (sub === "apply") {
+          const id = subRest[0];
+          if (!id) {
+            this.push("status", "usage: /variants apply <id>");
+            break;
+          }
+          const applied = applyVariant(this.opts.cwd, id);
+          if (applied.ok) {
+            cleanVariants(this.opts.cwd);
+            this.push("status", `applied ${id} to the working tree \u2014 review with git diff`);
+          } else {
+            this.push("error", applied.detail ?? "apply failed");
+          }
+          break;
+        }
+        if (sub === "clean") {
+          this.push("status", `removed ${cleanVariants(this.opts.cwd)} variant(s)`);
+          break;
+        }
+        if (sub === "list") {
+          const ids = listVariants(this.opts.cwd);
+          this.push("status", ids.length > 0 ? ids.join(" \xB7 ") : "no variants \u2014 /variants <2-4> <ask>");
+          break;
+        }
+        const n = Number.parseInt(sub ?? "", 10);
+        const ask = subRest.join(" ").trim();
+        if (!Number.isInteger(n) || n < 2 || n > 4 || ask.length === 0) {
+          this.push("status", "usage: /variants <2-4> <ask> \xB7 /variants apply <id> \xB7 list \xB7 clean");
+          break;
+        }
+        if (!isGitRepo(this.opts.cwd)) {
+          this.push("error", "variants need a git repo with at least one commit");
+          break;
+        }
+        void (async () => {
+          cleanVariants(this.opts.cwd);
+          this.push("status", `generating ${n} directions in parallel \u2014 this runs ${n} engine sessions`);
+          this.notify({ running: true, runStartedAt: Date.now() });
+          const engine = getEngine(this.state.engineId);
+          const runs = await runVariants(
+            this.opts.cwd,
+            ask,
+            n,
+            engine,
+            this.state.model,
+            (familyId, text) => this.push("status", `[${familyId}] ${text}`)
+          );
+          const succeeded = runs.filter((r) => r.result.ok);
+          if (succeeded.length > 0 && findChrome() && detectDevCommand(this.opts.cwd)) {
+            this.push("status", "capturing one screenshot per variant\u2026");
+            const shots = await screenshotVariants(this.opts.cwd, succeeded.map((r) => r.variant));
+            for (const shot of shots) {
+              this.push(
+                shot.path ? "status" : "error",
+                `[${shot.familyId}] ${shot.path ?? shot.error ?? "screenshot failed"}`
+              );
+            }
+          }
+          this.notify({ running: false });
+          this.push(
+            succeeded.length > 0 ? "status" : "error",
+            `${succeeded.length}/${runs.length} variants ready \u2014 /variants apply <id> keeps one, /variants clean discards`
+          );
+          this.drainQueue();
+        })();
+        break;
+      }
       case "clear":
         this.sessionId = void 0;
         clearState(this.opts.cwd);
@@ -667,7 +754,7 @@ ${result.a11y.slice(0, 5).join("\n")}`);
       case "help":
         this.push(
           "status",
-          "/engine <id> \xB7 /model <name> \xB7 /dev (start/stop server) \xB7 /check (quality gates) \xB7 /fix (send failures) \xB7 /shot (screenshots) \xB7 /review [focus] (visual self-critique) \xB7 /undo (revert last ask) \xB7 /checkpoints \xB7 /restore <n> \xB7 /resume (last session) \xB7 /clear (new session) \xB7 /quit"
+          "/engine <id> \xB7 /model <name> \xB7 /mode plan|safe|yolo \xB7 /dev \xB7 /check (gates) \xB7 /fix \xB7 /shot \xB7 /review [focus] \xB7 /variants <2-4> <ask> \xB7 /undo \xB7 /checkpoints \xB7 /restore <n> \xB7 /resume \xB7 /clear \xB7 /quit"
         );
         break;
       case "quit":
@@ -1176,7 +1263,7 @@ function App({
 
 // src/cli.tsx
 import { jsx as jsx4 } from "react/jsx-runtime";
-var VERSION = "0.2.0";
+var VERSION = "0.2.1";
 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);
 program.command("run").description("Run one prompt headlessly and stream the result").argument("<prompt...>", "what to build or change").option("-e, --engine <id>", "engine to use (claude, codex, gemini, opencode)").option("-m, --model <name>", "model override for the engine").option("--no-brief", "send the prompt without the squint design brief").option("--json", "emit normalized agent events as ndjson").action(
@@ -1210,18 +1297,41 @@ program.command("engines").description("List engines and whether they are instal
     console.log(`${status} ${engine.id.padEnd(10)} ${engine.name.padEnd(14)} ${location}`);
   }
 });
-program.command("doctor").description("Check squint prerequisites and engine availability").action(async () => {
+program.command("doctor").description("Check squint prerequisites and engine availability").option("--probe", "run each detected engine with a one-word prompt to verify auth works").action(async (options) => {
   const [major] = process.versions.node.split(".");
-  const nodeOk = Number(major) >= 20;
-  console.log(`${nodeOk ? pc.green("\u2713") : pc.red("\u2717")} node ${process.versions.node}${nodeOk ? "" : " (need >= 20)"}`);
+  const nodeOk = Number(major) >= 22;
+  console.log(`${nodeOk ? pc.green("\u2713") : pc.red("\u2717")} node ${process.versions.node}${nodeOk ? "" : " (need >= 22)"}`);
   const detected = detectEngines();
   for (const { engine, path: binaryPath } of detected) {
     const status = binaryPath ? pc.green("\u2713") : pc.yellow("\u25CB");
     console.log(`${status} ${engine.name}${binaryPath ? "" : pc.dim(` \u2014 install: ${engine.install}`)}`);
   }
-  const { findChrome } = await import("./chrome-K4BKFOYS.js");
+  if (options.probe) {
+    const { runAgent: runAgent2 } = await import("./run-XHLCTF6V.js");
+    console.log(pc.dim("\nprobing engines with a one-word prompt (verifies auth end to end)\u2026"));
+    for (const { engine, path: binaryPath } of detected) {
+      if (!binaryPath) continue;
+      const startedAt = Date.now();
+      const abort = new AbortController();
+      const timer = setTimeout(() => abort.abort(), 9e4);
+      const result = await runAgent2(
+        engine,
+        { prompt: "Reply with exactly: ok", cwd: process.cwd() },
+        () => {
+        },
+        abort.signal
+      );
+      clearTimeout(timer);
+      const secs = ((Date.now() - startedAt) / 1e3).toFixed(1);
+      const detail = (result.error ?? "failed").split("\n").filter((l) => l.trim()).at(-1) ?? "failed";
+      console.log(
+        result.ok ? `${pc.green("\u2713")} ${engine.id.padEnd(10)} responded in ${secs}s` : `${pc.red("\u2717")} ${engine.id.padEnd(10)} ${pc.dim(detail.slice(0, 110))}`
+      );
+    }
+  }
+  const { findChrome: findChrome2 } = await import("./chrome-RD7XQ767.js");
   const { hasWebSocket } = await import("./cdp-RTWPFIX5.js");
-  const chrome = findChrome();
+  const chrome = findChrome2();
   console.log(
     chrome ? `${pc.green("\u2713")} Chrome ${pc.dim(chrome)}` : `${pc.yellow("\u25CB")} Chrome ${pc.dim("\u2014 screenshots and runtime probing disabled")}`
   );
@@ -1238,7 +1348,7 @@ ${available.length} engine(s) ready.`));
   }
 });
 program.command("init").description("Scaffold a new Vite + React + TS + Tailwind app with token-first CSS").argument("[dir]", "target directory", ".").option("--force", "write into a non-empty directory").option("--no-install", "skip npm install").action(async (dir, options) => {
-  const { installDependencies, writeTemplate } = await import("./init-7AYGAKOS.js");
+  const { installDependencies, writeTemplate } = await import("./init-LSYB32NS.js");
   let result;
   try {
     result = writeTemplate(dir, { force: options.force });
@@ -1262,10 +1372,49 @@ program.command("init").description("Scaffold a new Vite + React + TS + Tailwind
 Next: ${pc.bold(`${cd}${options.install ? "" : "npm install && "}squint`)}`);
   console.log(pc.dim("then describe what to build \u2014 /dev starts the preview server"));
 });
+var skillsCommand = program.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-UGHU22BS.js");
+  const cwd = process.cwd();
+  const rules = loadRules(cwd);
+  console.log(rules ? `${pc.green("\u2713")} rules.md ${pc.dim(`(${rules.split("\n").length} lines, always on)`)}` : pc.dim("\u25CB no .squint/rules.md"));
+  const skills = loadSkills(cwd);
+  if (skills.length === 0) {
+    console.log(pc.dim("\u25CB no skills \u2014 squint skills init writes an example"));
+    return;
+  }
+  for (const skill of skills) {
+    console.log(`${pc.green("\u2713")} ${skill.name.padEnd(20)} ${pc.dim(`triggers: ${skill.triggers.join(", ")}`)}`);
+  }
+});
+skillsCommand.command("init").description("Scaffold .squint/rules.md and an example skill").action(async () => {
+  const fs2 = await import("fs");
+  const nodePath = await import("path");
+  const cwd = process.cwd();
+  const skillsDir = nodePath.join(cwd, ".squint", "skills");
+  fs2.mkdirSync(skillsDir, { recursive: true });
+  const rules = nodePath.join(cwd, ".squint", "rules.md");
+  if (!fs2.existsSync(rules)) {
+    fs2.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(pc.green("\u2713 .squint/rules.md"));
+  }
+  const example = nodePath.join(skillsDir, "example.md");
+  if (!fs2.existsSync(example)) {
+    fs2.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"
+    );
+    console.log(pc.green("\u2713 .squint/skills/example.md"));
+  }
+  console.log(pc.dim("rules are always-on; skills inject when an ask mentions a trigger"));
+});
 program.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 nodePath = await import("path");
-  const { patchViteConfig, TAGGER_FILENAME, TAGGER_SOURCE } = await import("./source-MEXHWVP4.js");
+  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);
@@ -1301,21 +1450,21 @@ variantsCommand.command("gen").description("Generate n variants of one ask in pa
       process.exitCode = 1;
       return;
     }
-    const { isGitRepo } = await import("./snapshot-KKUY5RR6.js");
-    if (!isGitRepo(cwd)) {
+    const { isGitRepo: isGitRepo2 } = await import("./snapshot-KKUY5RR6.js");
+    if (!isGitRepo2(cwd)) {
       console.error(pc.red("\u2717 variants need a git repo with at least one commit"));
       process.exitCode = 1;
       return;
     }
-    const { runVariants, cleanVariants } = await import("./variants-4NCQXTP7.js");
+    const { runVariants: runVariants2, cleanVariants: cleanVariants2 } = await import("./variants-7A7723L7.js");
     const config = loadConfig(defaultPaths(cwd));
     const engineId = resolveEngineId(config, options.engine);
     const engine = getEngine(engineId);
     const model = resolveModel(config, engineId, options.model);
     const ask = promptWords.join(" ");
-    cleanVariants(cwd);
+    cleanVariants2(cwd);
     console.log(pc.dim(`generating ${n} directions in parallel via ${engine.id} \u2014 this runs ${n} engine sessions`));
-    const runs = await runVariants(
+    const runs = await runVariants2(
       cwd,
       ask,
       n,
@@ -1325,9 +1474,9 @@ variantsCommand.command("gen").description("Generate n variants of one ask in pa
     );
     const succeeded = runs.filter((r) => r.result.ok);
     if (options.shots && succeeded.length > 0) {
-      const { screenshotVariants } = await import("./shots-VJBLDMF3.js");
+      const { screenshotVariants: screenshotVariants2 } = await import("./shots-LRYYMTPK.js");
       console.log(pc.dim("capturing screenshots\u2026"));
-      const shots = await screenshotVariants(cwd, succeeded.map((r) => r.variant));
+      const shots = await screenshotVariants2(cwd, succeeded.map((r) => r.variant));
       for (const shot of shots) {
         console.log(`${pc.green("\u2713")} ${shot.familyId.padEnd(18)} ${shot.path ?? pc.dim(shot.error ?? "")}`);
       }
@@ -1340,8 +1489,8 @@ ${succeeded.length}/${runs.length} variants ready in .squint/variants/ \u2014 `
   }
 );
 variantsCommand.command("list").description("List generated variants").action(async () => {
-  const { listVariants } = await import("./variants-4NCQXTP7.js");
-  const ids = listVariants(process.cwd());
+  const { listVariants: listVariants2 } = await import("./variants-7A7723L7.js");
+  const ids = listVariants2(process.cwd());
   if (ids.length === 0) {
     console.log(pc.dim('no variants \u2014 squint variants gen <n> "<ask>"'));
     return;
@@ -1349,26 +1498,26 @@ variantsCommand.command("list").description("List generated variants").action(as
   for (const id of ids) console.log(id);
 });
 variantsCommand.command("apply").description("Apply one variant\u2019s changes to the main tree and discard the rest").argument("<id>", "family id of the winning variant").action(async (id) => {
-  const { applyVariant, cleanVariants } = await import("./variants-4NCQXTP7.js");
+  const { applyVariant: applyVariant2, cleanVariants: cleanVariants2 } = await import("./variants-7A7723L7.js");
   const cwd = process.cwd();
-  const result = applyVariant(cwd, id);
+  const result = applyVariant2(cwd, id);
   if (!result.ok) {
     console.error(pc.red(`\u2717 ${result.detail}`));
     process.exitCode = 1;
     return;
   }
-  cleanVariants(cwd);
+  cleanVariants2(cwd);
   console.log(pc.green(`\u2713 applied ${id} to the working tree`) + pc.dim(" \u2014 review with git diff"));
 });
 variantsCommand.command("clean").description("Discard all variants").action(async () => {
-  const { cleanVariants } = await import("./variants-4NCQXTP7.js");
-  const count = cleanVariants(process.cwd());
+  const { cleanVariants: cleanVariants2 } = await import("./variants-7A7723L7.js");
+  const count = cleanVariants2(process.cwd());
   console.log(pc.dim(`removed ${count} variant(s)`));
 });
 program.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 nodePath = await import("path");
-  const { FAMILIES, getFamily, renderFamilyBrief } = await import("./families-RVP5BWQD.js");
+  const { FAMILIES, getFamily, renderFamilyBrief } = await import("./families-2G5SLLY7.js");
   if (!familyId) {
     console.log(pc.bold("Aesthetic families") + pc.dim(" \u2014 squint brief <id>\n"));
     for (const family2 of FAMILIES) {
@@ -1411,7 +1560,7 @@ program.command("check").description("Run this project\u2019s quality gates (typ
   if (results.some((r) => !r.ok)) process.exitCode = 1;
 });
 program.command("shot").description("Screenshot a running app at mobile/tablet/desktop viewports").argument("<url>", "URL of the running app (e.g. http://localhost:5173)").action(async (url) => {
-  const { captureViewports: captureViewports2 } = await import("./preview-LTWJK3LF.js");
+  const { captureViewports: captureViewports2 } = await import("./preview-XQ7EOHV4.js");
   const result = await captureViewports2(process.cwd(), url);
   if (!result) {
     console.error(pc.red("\u2717 no Chrome/Chromium found"));

package/dist/{families-RVP5BWQD.js → families-2G5SLLY7.js}

@@ -3,8 +3,7 @@ import {
   FAMILIES,
   getFamily,
   renderFamilyBrief
-} from "./chunk-5IR2AZVK.js";
-import "./chunk-NT2HR4RD.js";
+} from "./chunk-P3H4N2EN.js";
 export {
   FAMILIES,
   getFamily,

package/dist/{init-7AYGAKOS.js → init-LSYB32NS.js}

@@ -2,7 +2,7 @@
 import {
   TAGGER_FILENAME,
   TAGGER_SOURCE
-} from "./chunk-W6MYXQIU.js";
+} from "./chunk-VNLM53RJ.js";
 
 // src/scaffold/init.ts
 import { spawn } from "child_process";

package/dist/{preview-LTWJK3LF.js → preview-XQ7EOHV4.js}

@@ -7,10 +7,10 @@ import {
   previewDir,
   probeRuntime,
   runtimeSummary
-} from "./chunk-4MMIJXYD.js";
+} from "./chunk-REDPR3KI.js";
 import "./chunk-VJGE7HSP.js";
-import "./chunk-Z46MXU64.js";
-import "./chunk-MCYQXOE7.js";
+import "./chunk-P3V5CWH5.js";
+import "./chunk-2LRIKWBU.js";
 export {
   VIEWPORTS,
   buildReviewPrompt,

package/dist/run-XHLCTF6V.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import {
+  runAgent
+} from "./chunk-OTG4ZB4R.js";
+import "./chunk-2LRIKWBU.js";
+export {
+  runAgent
+};

package/dist/shots-LRYYMTPK.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import {
+  screenshotVariants
+} from "./chunk-2IW2MMCY.js";
+import "./chunk-LCS47EAG.js";
+import "./chunk-P3H4N2EN.js";
+import "./chunk-OTG4ZB4R.js";
+import "./chunk-P3V5CWH5.js";
+import "./chunk-2LRIKWBU.js";
+export {
+  screenshotVariants
+};

package/dist/skills-UGHU22BS.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import {
+  enrich,
+  loadRules,
+  loadSkills,
+  matchSkills,
+  parseSkill
+} from "./chunk-XZKQZKEE.js";
+export {
+  enrich,
+  loadRules,
+  loadSkills,
+  matchSkills,
+  parseSkill
+};

package/dist/{source-MEXHWVP4.js → source-ZZU245VN.js}

@@ -3,7 +3,7 @@ import {
   TAGGER_FILENAME,
   TAGGER_SOURCE,
   patchViteConfig
-} from "./chunk-W6MYXQIU.js";
+} from "./chunk-VNLM53RJ.js";
 export {
   TAGGER_FILENAME,
   TAGGER_SOURCE,

package/dist/{variants-4NCQXTP7.js → variants-7A7723L7.js}

@@ -9,11 +9,10 @@ import {
   runVariants,
   variantPrompt,
   variantsRoot
-} from "./chunk-7XUORM3K.js";
-import "./chunk-5IR2AZVK.js";
-import "./chunk-FPTBBHOH.js";
-import "./chunk-NT2HR4RD.js";
-import "./chunk-MCYQXOE7.js";
+} from "./chunk-LCS47EAG.js";
+import "./chunk-P3H4N2EN.js";
+import "./chunk-OTG4ZB4R.js";
+import "./chunk-2LRIKWBU.js";
 export {
   MAX_VARIANTS,
   applyVariant,

package/package.json

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

package/dist/chunk-NT2HR4RD.js

@@ -1,63 +0,0 @@
-#!/usr/bin/env node
-
-// src/prompt/brief.ts
-import fs from "fs";
-import path from "path";
-var DEFAULT_BRIEF = `You are acting as a senior product designer and frontend engineer. Treat every change as production work, not a demo.
-
-Direction before code:
-- Commit to one specific visual direction derived from what this product is for, and state it in one sentence before implementing. If the direction could be guessed from the product category alone, sharpen it until it couldn't.
-- Choose a color strategy deliberately: restrained (neutrals + one accent), committed (one dominant color owning 30\u201360% of the surface), or a small palette of 3\u20135 named roles. Never purple/violet gradients unless asked. Body text contrast stays at least 4.5:1 \u2014 no light gray body copy "for elegance".
-- Typography: at most two families, paired on contrast (display serif + geometric sans, or sans + mono). Never Inter/Roboto/Open Sans/system defaults for display type. Pair weight extremes (300 against 700\u2013900); display sizes jump 3x over body, not 1.5x.
-
-Tokens are the system:
-- Define or extend design tokens (CSS variables / theme config) first, then compose the UI from them. Never scatter literal colors or one-off spacing values through components.
-- One spacing rhythm on a 4/8px grid; one type scale with a ratio of at least 1.25 between steps.
-
-Banned tells \u2014 these read instantly as machine-generated:
-- Purple gradient on white; glassmorphism cards; cream/beige page background as a reflex "warmth" move
-- Emoji as icons; identical icon-topped card grids; stat banner rows; numbered 01/02/03 section markers
-- Tiny all-caps tracked eyebrow labels over every section; gradient text; colored left-border strips on cards
-- Centered hero + badge + three feature cards; unmodified component-library defaults
-If someone could look at the result and say "AI made that" without doubt, it has failed.
-
-Craft details:
-- Every interactive element gets hover, focus-visible, and active treatment; keyboard focus stays visible.
-- Anything that loads data gets loading, empty, and error states.
-- Motion: 150\u2013250ms ease-out; one orchestrated entrance with staggered reveals beats scattered micro-interactions; honor prefers-reduced-motion; never leave content invisible until a scroll observer fires.
-- Body line length 65\u201375ch; text-wrap: balance on headings.
-
-Engineering:
-- Follow the repo's existing conventions and extend its patterns; new components in new files, small and focused; semantic HTML.
-- Responsive from 360px up with no horizontal overflow \u2014 check intermediate widths, not just phone and desktop.
-- Let errors surface instead of swallowing them in try/catch; log clearly so failures can be traced.
-- Not done until the app builds cleanly, typechecks, and renders without console errors.`;
-var FIRST_TURN_ADDENDUM = `This is the opening move on this task: establish the design foundation before building. State the visual direction, set up the tokens/theme first, then build components from them. The first render should feel like a designed product, not a scaffold \u2014 impressive on sight.`;
-function loadBrief(cwd) {
-  const custom = path.join(cwd, ".squint", "brief.md");
-  try {
-    const text = fs.readFileSync(custom, "utf8").trim();
-    if (text.length > 0) return text;
-  } catch {
-  }
-  return DEFAULT_BRIEF;
-}
-function composePrompt(ask, opts) {
-  if (opts.noBrief) return ask;
-  const brief = loadBrief(opts.cwd);
-  const firstTurn = opts.firstTurn ?? true;
-  const addendum = firstTurn ? `
-
-${FIRST_TURN_ADDENDUM}` : "";
-  return `${brief}${addendum}
-
-## Task
-
-${ask}`;
-}
-
-export {
-  DEFAULT_BRIEF,
-  FIRST_TURN_ADDENDUM,
-  composePrompt
-};

package/dist/shots-VJBLDMF3.js

@@ -1,66 +0,0 @@
-#!/usr/bin/env node
-import {
-  variantsRoot
-} from "./chunk-7XUORM3K.js";
-import "./chunk-5IR2AZVK.js";
-import {
-  DevServer,
-  detectDevCommand
-} from "./chunk-ZJOU46X4.js";
-import "./chunk-FPTBBHOH.js";
-import "./chunk-NT2HR4RD.js";
-import {
-  findChrome,
-  screenshot
-} from "./chunk-Z46MXU64.js";
-import "./chunk-MCYQXOE7.js";
-
-// src/variants/shots.ts
-import path from "path";
-var URL_TIMEOUT_MS = 45e3;
-function waitForUrl(server) {
-  return new Promise((resolve) => {
-    const startedAt = Date.now();
-    const poll = setInterval(() => {
-      if (server.url) {
-        clearInterval(poll);
-        resolve(server.url);
-      } else if (Date.now() - startedAt > URL_TIMEOUT_MS || server.state === "crashed") {
-        clearInterval(poll);
-        resolve(null);
-      }
-    }, 200);
-  });
-}
-async function screenshotVariants(cwd, variants) {
-  const chrome = findChrome();
-  if (!chrome) {
-    return variants.map((v) => ({ familyId: v.family.id, error: "no Chrome found" }));
-  }
-  const shots = [];
-  for (const variant of variants) {
-    const command = detectDevCommand(variant.dir);
-    if (!command) {
-      shots.push({ familyId: variant.family.id, error: "no dev script" });
-      continue;
-    }
-    const server = new DevServer(variant.dir);
-    server.start(command);
-    const url = await waitForUrl(server);
-    if (!url) {
-      server.stop();
-      shots.push({ familyId: variant.family.id, error: "dev server did not announce a URL" });
-      continue;
-    }
-    const outPath = path.join(variantsRoot(cwd), `${variant.family.id}.png`);
-    const result = await screenshot(chrome, url, outPath, { width: 1440, height: 900 });
-    server.stop();
-    shots.push(
-      result.ok ? { familyId: variant.family.id, path: outPath } : { familyId: variant.family.id, error: result.error }
-    );
-  }
-  return shots;
-}
-export {
-  screenshotVariants
-};

package/dist/{chunk-MCYQXOE7.js → chunk-2LRIKWBU.js}

@@ -1,23 +1,5 @@
 #!/usr/bin/env node
 
-// src/engines/registry.ts
-import fs from "fs";
-import path from "path";
-
-// src/engines/aider.ts
-var aider = {
-  id: "aider",
-  name: "Aider",
-  binary: "aider",
-  install: "python -m pip install aider-install && aider-install",
-  supportsResume: false,
-  buildArgs(opts) {
-    const args = ["--message", opts.prompt, "--yes-always", "--no-auto-commits"];
-    if (opts.model) args.push("--model", opts.model);
-    return args;
-  }
-};
-
 // src/util/stream.ts
 function lineSplitter(onLine) {
   let buffer = "";
@@ -42,6 +24,24 @@ function truncate(text, max) {
   return text.slice(0, max - 1) + "\u2026";
 }
 
+// src/engines/registry.ts
+import fs from "fs";
+import path from "path";
+
+// src/engines/aider.ts
+var aider = {
+  id: "aider",
+  name: "Aider",
+  binary: "aider",
+  install: "python -m pip install aider-install && aider-install",
+  supportsResume: false,
+  buildArgs(opts) {
+    const args = ["--message", opts.prompt, "--yes-always", "--no-auto-commits"];
+    if (opts.model) args.push("--model", opts.model);
+    return args;
+  }
+};
+
 // src/engines/claudeProtocol.ts
 function createClaudeStreamParser(readyLabel) {
   let sawTextDelta = false;