@aayambansal/squint 0.2.2 → 0.2.3

package/README.md

@@ -151,9 +151,12 @@ squint doctor --probe             # run every engine end to end, verify auth act
   `/fix <n>` targets one. The footer counts what's open.
 - **Variants without leaving**: `/variants 3 <ask>` runs parallel explorations with
   streaming per-family status; `/variants apply <id>` keeps the winner.
-- **Commands**: `/dev` `/check` `/problems` `/fix [n]` `/shot` `/review [focus]`
-  `/variants` `/undo` `/checkpoints` `/restore <n>` `/mode` `/theme` `/resume`
-  `/engine <id>` `/model <name>` `/clear`.
+- **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.
 - 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/{chunk-XZKQZKEE.js → chunk-4LAU5TGK.js}

@@ -51,12 +51,29 @@ function matchSkills(skills, ask) {
   const haystack = ask.toLowerCase();
   return skills.filter((skill) => skill.triggers.some((t) => haystack.includes(t)));
 }
+function loadLocks(cwd) {
+  try {
+    return fs.readFileSync(path.join(cwd, ".squint", "locks"), "utf8").split("\n").map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+  } catch {
+    return [];
+  }
+}
 function enrich(cwd, ask) {
   const parts = [];
   const rules = loadRules(cwd);
   if (rules) parts.push(`## Project rules (always apply)
 
 ${rules}`);
+  const locks = loadLocks(cwd);
+  if (locks.length > 0) {
+    parts.push(
+      `## Locked files (hard constraint)
+
+Never modify these paths, no matter what the task seems to need:
+${locks.map((l) => `- ${l}`).join("\n")}
+If the task appears to require changing them, stop and explain instead.`
+    );
+  }
   const matched = matchSkills(loadSkills(cwd), ask);
   for (const skill of matched) {
     parts.push(`## Project notes: ${skill.name}
@@ -76,5 +93,6 @@ export {
   loadSkills,
   loadRules,
   matchSkills,
+  loadLocks,
   enrich
 };

package/dist/chunk-EECGXFRX.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+// src/session/commands.ts
+var COMMANDS = [
+  { name: "dev", description: "start/stop the project dev server" },
+  { name: "check", description: "run all quality gates (typecheck, lint, test, build)" },
+  { name: "problems", description: "list open findings from gates, dev server, runtime, a11y" },
+  { name: "fix", args: "[n]", description: "send all open problems to the engine, or just problem n" },
+  { name: "shot", description: "screenshot the app at mobile/tablet/desktop" },
+  { name: "review", args: "[focus]", description: "screenshots + the engine critiques its own rendered work" },
+  { name: "variants", args: "<2-4> <ask>", description: "parallel design explorations; apply/list/clean" },
+  { name: "undo", description: "revert the last ask (files only)" },
+  { name: "checkpoints", description: "list per-ask checkpoints" },
+  { name: "restore", args: "<n>", description: "rewind files to before ask n" },
+  { name: "mode", args: "plan|safe|yolo", description: "how much the engine may do (shift+tab cycles)" },
+  { name: "engine", args: "<id>", description: "switch backend (new session)" },
+  { name: "model", args: "[name]", description: "model override for the engine" },
+  { name: "theme", args: "[name]", description: "switch the TUI theme", viewLevel: true },
+  { name: "copy", description: "copy the last reply to the clipboard" },
+  { name: "save", description: "export the transcript to .squint/transcripts/" },
+  { name: "queue", args: "clear", description: "drop queued asks" },
+  { name: "resume", description: "pick up the previous session for this repo" },
+  { name: "clear", description: "new session (transcript, totals, persisted state)" },
+  { name: "help", description: "list commands" },
+  { name: "quit", description: "exit with a session summary" }
+];
+function completeCommand(partial) {
+  const query = partial.toLowerCase();
+  return COMMANDS.filter((c) => c.name.startsWith(query));
+}
+function commandHelp() {
+  return COMMANDS.map((c) => `/${c.name}${c.args ? ` ${c.args}` : ""} \u2014 ${c.description}`).join("\n");
+}
+
+export {
+  COMMANDS,
+  completeCommand,
+  commandHelp
+};

package/dist/{chunk-73ULM6HF.js → chunk-SU6YRRMF.js}

@@ -16,7 +16,7 @@ import path2 from "path";
 // src/state/state.ts
 import fs from "fs";
 import path from "path";
-var IGNORED = ["preview/", "state.json", "variants/"];
+var IGNORED = ["preview/", "state.json", "variants/", "transcripts/"];
 function ensureSquintIgnore(cwd) {
   const dir = path.join(cwd, ".squint");
   fs.mkdirSync(dir, { recursive: true });

package/dist/cli.js

@@ -1,4 +1,10 @@
 #!/usr/bin/env node
+import {
+  diffStatSince,
+  isGitRepo,
+  restoreSnapshot,
+  takeSnapshot
+} from "./chunk-YHRAOBI2.js";
 import {
   DevServer,
   buildFixPrompt,
@@ -17,6 +23,9 @@ import {
 import {
   runAgent
 } from "./chunk-OTG4ZB4R.js";
+import {
+  completeCommand
+} from "./chunk-EECGXFRX.js";
 import {
   buildGatePrompt,
   detectFastGates,
@@ -33,7 +42,7 @@ import {
   probeRuntime,
   runtimeSummary,
   saveState
-} from "./chunk-73ULM6HF.js";
+} from "./chunk-SU6YRRMF.js";
 import "./chunk-OC6RU6XH.js";
 import {
   findChrome
@@ -44,13 +53,7 @@ import {
 } from "./chunk-2LRIKWBU.js";
 import {
   enrich
-} from "./chunk-XZKQZKEE.js";
-import {
-  diffStatSince,
-  isGitRepo,
-  restoreSnapshot,
-  takeSnapshot
-} from "./chunk-YHRAOBI2.js";
+} from "./chunk-4LAU5TGK.js";
 
 // src/cli.tsx
 import { Command } from "commander";
@@ -669,6 +672,38 @@ They are objective defects, not style preferences.`
         }
         break;
       }
+      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 stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
+          const file = path4.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) {
+              case "user":
+                lines.push(`## \u276F ${item.text}`, "");
+                break;
+              case "assistant":
+                lines.push(item.text, "");
+                break;
+              case "tool":
+                lines.push(`- \u2699 ${item.text}`);
+                break;
+              case "thinking":
+                break;
+              default:
+                lines.push(`> ${item.role === "error" ? "\u2717 " : ""}${item.text.split("\n").join("\n> ")}`);
+            }
+          }
+          lines.push("", `> ${this.summary()}`);
+          fs2.writeFileSync(file, lines.join("\n") + "\n");
+          this.push("status", `saved transcript \u2192 ${path4.relative(this.opts.cwd, file)}`);
+        })();
+        break;
+      }
       case "copy": {
         const last = this.state.items.findLast((i) => i.role === "assistant");
         if (!last) {
@@ -857,12 +892,10 @@ They are objective defects, not style preferences.`
         clearState(this.opts.cwd);
         this.notify({ items: [], totals: { costUsd: 0, turns: 0 } });
         break;
-      case "help":
-        this.push(
-          "status",
-          "/engine <id> \xB7 /model <name> \xB7 /mode plan|safe|yolo \xB7 /dev \xB7 /check (gates) \xB7 /problems \xB7 /fix [n] \xB7 /shot \xB7 /review [focus] \xB7 /variants <2-4> <ask> \xB7 /undo \xB7 /checkpoints \xB7 /restore <n> \xB7 /copy (last reply) \xB7 /resume \xB7 /clear \xB7 /quit"
-        );
+      case "help": {
+        void import("./commands-6XDXUVO6.js").then(({ commandHelp }) => this.push("status", commandHelp()));
         break;
+      }
       case "quit":
       case "exit":
         this.push("status", this.summary());
@@ -1248,6 +1281,13 @@ function App({
       session.cycleMode();
       return;
     }
+    if (key.tab && line.text.startsWith("/") && !line.text.includes(" ")) {
+      const matches = completeCommand(line.text.slice(1));
+      if (matches.length > 0) {
+        setLine(fromText(`/${matches[0].name}${matches[0].args ? " " : ""}`));
+      }
+      return;
+    }
     if (key.return) {
       const value = line.text.trim();
       setLine(emptyLine);
@@ -1341,6 +1381,16 @@ function App({
       "\u22EF queued: ",
       queued
     ] }) }, index)),
+    line.text.startsWith("/") && !line.text.includes(" ") && /* @__PURE__ */ jsx3(Box2, { flexDirection: "column", children: completeCommand(line.text.slice(1)).slice(0, 5).map((command, index) => /* @__PURE__ */ jsxs3(Text3, { color: index === 0 ? theme2.accent : theme2.dim, children: [
+      "/",
+      command.name,
+      command.args ? ` ${command.args}` : "",
+      " ",
+      /* @__PURE__ */ jsxs3(Text3, { color: theme2.dim, children: [
+        "\u2014 ",
+        command.description
+      ] })
+    ] }, command.name)) }),
     /* @__PURE__ */ jsx3(Box2, { marginTop: state.running ? 0 : 1, children: /* @__PURE__ */ jsxs3(Text3, { children: [
       /* @__PURE__ */ jsx3(Text3, { color: theme2.accent, children: "\u276F " }),
       line.text.slice(0, line.cursor),
@@ -1381,7 +1431,7 @@ function App({
 
 // src/cli.tsx
 import { jsx as jsx4 } from "react/jsx-runtime";
-var VERSION = "0.2.2";
+var VERSION = "0.2.3";
 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(
@@ -1492,7 +1542,7 @@ Next: ${pc.bold(`${cd}${options.install ? "" : "npm install && "}squint`)}`);
 });
 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 { loadRules, loadSkills } = await import("./skills-DNBHZAAU.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"));
@@ -1678,7 +1728,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-JJJLDF7H.js");
+  const { captureViewports: captureViewports2 } = await import("./preview-UX4VS4SX.js");
   const result = await captureViewports2(process.cwd(), url);
   if (!result) {
     console.error(pc.red("\u2717 no Chrome/Chromium found"));

package/dist/commands-6XDXUVO6.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import {
+  COMMANDS,
+  commandHelp,
+  completeCommand
+} from "./chunk-EECGXFRX.js";
+export {
+  COMMANDS,
+  commandHelp,
+  completeCommand
+};

package/dist/{preview-JJJLDF7H.js → preview-UX4VS4SX.js}

@@ -8,7 +8,7 @@ import {
   previewDir,
   probeRuntime,
   runtimeSummary
-} from "./chunk-73ULM6HF.js";
+} from "./chunk-SU6YRRMF.js";
 import "./chunk-OC6RU6XH.js";
 import "./chunk-P3V5CWH5.js";
 import "./chunk-2LRIKWBU.js";

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

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

package/package.json

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