@aayambansal/squint 0.2.6 → 0.2.8

package/dist/cli.js

@@ -1,34 +1,16 @@
 #!/usr/bin/env node
-import {
-  enrich
-} from "./chunk-4LAU5TGK.js";
-import {
-  diffStatSince,
-  isGitRepo,
-  restoreSnapshot,
-  takeSnapshot
-} from "./chunk-YHRAOBI2.js";
 import {
   DevServer,
   buildFixPrompt,
   detectDevCommand,
   screenshotVariants
-} from "./chunk-43L4QXCM.js";
+} from "./chunk-5VKUJPOL.js";
 import {
   applyVariant,
   cleanVariants,
   listVariants,
   runVariants
-} from "./chunk-LVA2OQSR.js";
-import {
-  composePrompt
-} from "./chunk-P3H4N2EN.js";
-import {
-  runAgent
-} from "./chunk-C7WKNJG6.js";
-import {
-  completeCommand
-} from "./chunk-V3M4WQLH.js";
+} from "./chunk-X6MDBKED.js";
 import {
   buildGatePrompt,
   detectFastGates,
@@ -45,8 +27,13 @@ import {
   probeRuntime,
   runtimeSummary,
   saveState
-} from "./chunk-YZEFBPBJ.js";
-import "./chunk-OC6RU6XH.js";
+} from "./chunk-CHZE3UHK.js";
+import {
+  completeCommand
+} from "./chunk-YTO2YRF7.js";
+import {
+  runAgent
+} from "./chunk-C7WKNJG6.js";
 import {
   findChrome
 } from "./chunk-B7LOERSP.js";
@@ -54,10 +41,24 @@ import {
   detectEngines,
   getEngine
 } from "./chunk-BWZFACBT.js";
+import "./chunk-OC6RU6XH.js";
+import {
+  enrich
+} from "./chunk-4LAU5TGK.js";
+import {
+  composePrompt
+} from "./chunk-P3H4N2EN.js";
+import {
+  diffStatSince,
+  isGitRepo,
+  restoreSnapshot,
+  takeSnapshot
+} from "./chunk-YHRAOBI2.js";
 
 // src/cli.tsx
 import { Command } from "commander";
-import { render } from "ink";
+
+// src/cli/configCmd.ts
 import pc from "picocolors";
 
 // src/config/config.ts
@@ -82,6 +83,8 @@ var ConfigSchema = z.object({
   bell: z.boolean().optional(),
   /** Session budget in USD; crossing it warns (never blocks). */
   budgetUsd: z.number().positive().optional(),
+  /** Auto-run /review when the visual pulse shows a big change (default off). */
+  autoReview: z.boolean().optional(),
   /** TUI theme name (amber, ocean, moss, rose, mono). */
   theme: z.string().optional()
 });
@@ -126,7 +129,7 @@ function setConfigValue(file, key, value) {
   let next;
   if (key === "engine" || key === "theme") {
     next = { ...current, [key]: value };
-  } else if (key === "autoDev" || key === "autoFix" || key === "autoProbe" || key === "autoCheck" || key === "bell") {
+  } else if (key === "autoDev" || key === "autoFix" || key === "autoProbe" || key === "autoCheck" || key === "autoReview" || key === "bell") {
     if (value !== "true" && value !== "false") {
       throw new Error(`"${key}" must be true or false`);
     }
@@ -143,7 +146,7 @@ function setConfigValue(file, key, value) {
     next = { ...current, models: { ...current.models, [engineId]: value } };
   } else {
     throw new Error(
-      `Unknown config key "${key}". Supported: engine, theme, autoDev, autoFix, autoProbe, autoCheck, bell, budgetUsd, models.<engineId>`
+      `Unknown config key "${key}". Supported: engine, theme, autoDev, autoFix, autoProbe, autoCheck, autoReview, bell, budgetUsd, models.<engineId>`
     );
   }
   fs.mkdirSync(path.dirname(file), { recursive: true });
@@ -151,13 +154,513 @@ function setConfigValue(file, key, value) {
   return next;
 }
 
+// src/cli/configCmd.ts
+function registerConfig(program2) {
+  const configCommand = program2.command("config").description("Read or change squint configuration");
+  configCommand.command("get").description("Print the resolved configuration").action(() => {
+    const paths = defaultPaths(process.cwd());
+    console.log(JSON.stringify(loadConfig(paths), null, 2));
+  });
+  configCommand.command("set").description("Set a value (see docs/configuration.md for every key)").argument("<key>").argument("<value>").option("--project", "write to this project (.squint/config.json) instead of global").action((key, value, options) => {
+    const paths = defaultPaths(process.cwd());
+    const file = options.project ? paths.projectFile : paths.globalFile;
+    setConfigValue(file, key, value);
+    console.log(pc.green(`\u2713 ${key} = ${value}`) + pc.dim(` (${file})`));
+  });
+  configCommand.command("path").description("Show config file locations").action(() => {
+    const paths = defaultPaths(process.cwd());
+    console.log(`global   ${paths.globalFile}`);
+    console.log(`project  ${paths.projectFile}`);
+  });
+}
+
+// src/cli/env.ts
+import pc2 from "picocolors";
+function registerEnv(program2) {
+  program2.command("engines").description("List engines: installed, streaming, session resume").action(() => {
+    console.log(pc2.dim("   id         name           stream  resume  where"));
+    for (const { engine, path: binaryPath } of detectEngines()) {
+      const status = binaryPath ? pc2.green("\u2713") : pc2.red("\u2717");
+      const stream = engine.createParser ? pc2.green("yes") : pc2.dim("text");
+      const resume = engine.supportsResume ? pc2.green("yes") : pc2.dim("no");
+      const location = binaryPath ?? pc2.dim(`not found \u2014 ${engine.install}`);
+      console.log(
+        `${status} ${engine.id.padEnd(10)} ${engine.name.padEnd(14)} ${stream.padEnd(15)} ${resume.padEnd(14)} ${location}`
+      );
+    }
+    console.log(pc2.dim("\nplan/safe/yolo modes map onto every engine \xB7 squint doctor --probe verifies auth"));
+  });
+  program2.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) >= 22;
+    console.log(
+      `${nodeOk ? pc2.green("\u2713") : pc2.red("\u2717")} node ${process.versions.node}${nodeOk ? "" : " (need >= 22)"}`
+    );
+    const detected = detectEngines();
+    for (const { engine, path: binaryPath } of detected) {
+      const status = binaryPath ? pc2.green("\u2713") : pc2.yellow("\u25CB");
+      console.log(`${status} ${engine.name}${binaryPath ? "" : pc2.dim(` \u2014 install: ${engine.install}`)}`);
+    }
+    if (options.probe) {
+      const { runAgent: runAgent2 } = await import("./run-S772BPMZ.js");
+      console.log(pc2.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 ? `${pc2.green("\u2713")} ${engine.id.padEnd(10)} responded in ${secs}s` : `${pc2.red("\u2717")} ${engine.id.padEnd(10)} ${pc2.dim(detail.slice(0, 110))}`
+        );
+      }
+    }
+    const { findChrome: findChrome2 } = await import("./chrome-NVU47PLK.js");
+    const { hasWebSocket } = await import("./cdp-SFWNP7OA.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")}`
+    );
+    console.log(
+      hasWebSocket() ? `${pc2.green("\u2713")} WebSocket ${pc2.dim("runtime console/network capture available")}` : `${pc2.yellow("\u25CB")} WebSocket ${pc2.dim("\u2014 node 22+ enables runtime capture; screenshots still work")}`
+    );
+    const available = detected.filter((d) => d.path !== null);
+    if (available.length === 0) {
+      console.log(pc2.red("\nNo engines found. Install at least one to use squint."));
+      process.exitCode = 1;
+    } else {
+      console.log(pc2.dim(`
+${available.length} engine(s) ready.`));
+    }
+  });
+}
+
+// src/cli/project.ts
+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-DNBHZAAU.js");
+    const cwd = process.cwd();
+    const rules = loadRules(cwd);
+    console.log(
+      rules ? `${pc3.green("\u2713")} rules.md ${pc3.dim(`(${rules.split("\n").length} lines, always on)`)}` : pc3.dim("\u25CB no .squint/rules.md")
+    );
+    const skills = loadSkills(cwd);
+    if (skills.length === 0) {
+      console.log(pc3.dim("\u25CB no skills \u2014 squint skills init writes an example"));
+      return;
+    }
+    for (const skill of skills) {
+      console.log(`${pc3.green("\u2713")} ${skill.name.padEnd(20)} ${pc3.dim(`triggers: ${skill.triggers.join(", ")}`)}`);
+    }
+  });
+  skillsCommand.command("init").description("Scaffold .squint/rules.md and an example skill").action(async () => {
+    const fs3 = await import("fs");
+    const nodePath = await import("path");
+    const cwd = process.cwd();
+    const skillsDir = nodePath.join(cwd, ".squint", "skills");
+    fs3.mkdirSync(skillsDir, { recursive: true });
+    const rules = nodePath.join(cwd, ".squint", "rules.md");
+    if (!fs3.existsSync(rules)) {
+      fs3.writeFileSync(
+        rules,
+        "# Project rules\n\nThese ride along on every squint ask. Keep them short \u2014 cut anything that would not cause a mistake if removed.\n"
+      );
+      console.log(pc3.green("\u2713 .squint/rules.md"));
+    }
+    const example = nodePath.join(skillsDir, "example.md");
+    if (!fs3.existsSync(example)) {
+      fs3.writeFileSync(
+        example,
+        "---\ntriggers: example, sample\n---\n\nThis note is injected only when an ask mentions one of the triggers above.\nDocument the parts of this repo an agent would otherwise rediscover every time:\nwhere state lives, which helpers to reuse, what not to touch.\n"
+      );
+      console.log(pc3.green("\u2713 .squint/skills/example.md"));
+    }
+    console.log(pc3.dim("rules are always-on; skills inject when an ask mentions a trigger"));
+  });
+  program2.command("brief").description("Set a committed design direction for this project (.squint/brief.md)").argument("[family]", "aesthetic family id (omit to list)").option("--force", "overwrite an existing project brief").action(async (familyId, options) => {
+    const fs3 = await import("fs");
+    const nodePath = await import("path");
+    const { FAMILIES, getFamily, renderFamilyBrief } = await import("./families-2G5SLLY7.js");
+    if (!familyId) {
+      console.log(pc3.bold("Aesthetic families") + pc3.dim(" \u2014 squint brief <id>\n"));
+      for (const family2 of FAMILIES) {
+        console.log(`${pc3.green(family2.id.padEnd(18))} ${family2.name.padEnd(22)} ${pc3.dim(family2.summary)}`);
+      }
+      console.log(pc3.dim("\nThe brief wraps every ask; edit .squint/brief.md to remix."));
+      return;
+    }
+    const family = getFamily(familyId);
+    if (!family) {
+      console.error(pc3.red(`\u2717 unknown family "${familyId}" \u2014 run squint brief to list`));
+      process.exitCode = 1;
+      return;
+    }
+    const target = nodePath.join(process.cwd(), ".squint", "brief.md");
+    if (fs3.existsSync(target) && !options.force) {
+      console.error(pc3.red(`\u2717 ${target} exists \u2014 use --force to overwrite`));
+      process.exitCode = 1;
+      return;
+    }
+    fs3.mkdirSync(nodePath.dirname(target), { recursive: true });
+    fs3.writeFileSync(target, renderFamilyBrief(family) + "\n");
+    console.log(pc3.green(`\u2713 ${family.name} direction written to .squint/brief.md`));
+    console.log(pc3.dim("every squint ask in this repo now holds this direction \u2014 edit the file to remix"));
+  });
+  const variantsCommand = program2.command("variants").description("Parallel design explorations \u2014 one aesthetic family each, pick with your eyes");
+  variantsCommand.command("gen").description("Generate n variants of one ask in parallel (n engine runs \u2014 n\xD7 cost)").argument("<n>", "how many variants (max 4)").argument("<prompt...>", "what to build").option("-e, --engine <id>", "engine to use").option("-m, --model <name>", "model override").option("--no-shots", "skip the screenshot pass").action(
+    async (nRaw, promptWords, options) => {
+      const cwd = process.cwd();
+      const n = Number.parseInt(nRaw, 10);
+      if (!Number.isInteger(n) || n < 2 || n > 4) {
+        console.error(pc3.red("\u2717 n must be 2\u20134"));
+        process.exitCode = 1;
+        return;
+      }
+      const { isGitRepo: isGitRepo2 } = await import("./snapshot-H6VYFHLN.js");
+      if (!isGitRepo2(cwd)) {
+        console.error(pc3.red("\u2717 variants need a git repo with at least one commit"));
+        process.exitCode = 1;
+        return;
+      }
+      const { runVariants: runVariants2, cleanVariants: cleanVariants2 } = await import("./variants-UULPQ7Q5.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(" ");
+      cleanVariants2(cwd);
+      console.log(pc3.dim(`generating ${n} directions in parallel via ${engine.id} \u2014 this runs ${n} engine sessions`));
+      const runs = await runVariants2(
+        cwd,
+        ask,
+        n,
+        engine,
+        model,
+        (familyId, text) => console.log(`${pc3.cyan(familyId.padEnd(18))} ${pc3.dim(text)}`)
+      );
+      const succeeded = runs.filter((r) => r.result.ok);
+      if (options.shots && succeeded.length > 0) {
+        const { screenshotVariants: screenshotVariants2 } = await import("./shots-FVG4CDVK.js");
+        console.log(pc3.dim("capturing screenshots\u2026"));
+        const shots = await screenshotVariants2(cwd, succeeded.map((r) => r.variant));
+        for (const shot of shots) {
+          console.log(`${pc3.green("\u2713")} ${shot.familyId.padEnd(18)} ${shot.path ?? pc3.dim(shot.error ?? "")}`);
+        }
+      }
+      console.log(
+        `
+${succeeded.length}/${runs.length} variants ready in .squint/variants/ \u2014 ` + pc3.bold("squint variants apply <id>") + pc3.dim(" applies the winner, squint variants clean discards all")
+      );
+      if (succeeded.length === 0) process.exitCode = 1;
+    }
+  );
+  variantsCommand.command("list").description("List generated variants").action(async () => {
+    const { listVariants: listVariants2 } = await import("./variants-UULPQ7Q5.js");
+    const ids = listVariants2(process.cwd());
+    if (ids.length === 0) {
+      console.log(pc3.dim('no variants \u2014 squint variants gen <n> "<ask>"'));
+      return;
+    }
+    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: applyVariant2, cleanVariants: cleanVariants2 } = await import("./variants-UULPQ7Q5.js");
+    const cwd = process.cwd();
+    const result = applyVariant2(cwd, id);
+    if (!result.ok) {
+      console.error(pc3.red(`\u2717 ${result.detail}`));
+      process.exitCode = 1;
+      return;
+    }
+    cleanVariants2(cwd);
+    console.log(pc3.green(`\u2713 applied ${id} to the working tree`) + pc3.dim(" \u2014 review with git diff"));
+  });
+  variantsCommand.command("clean").description("Discard all variants").action(async () => {
+    const { cleanVariants: cleanVariants2 } = await import("./variants-UULPQ7Q5.js");
+    const count = cleanVariants2(process.cwd());
+    console.log(pc3.dim(`removed ${count} variant(s)`));
+  });
+}
+
+// src/cli/quality.ts
+import pc4 from "picocolors";
+function registerQuality(program2) {
+  program2.command("check").description("Run this project\u2019s quality gates (typecheck, lint, format, test, build)").action(async () => {
+    const { detectGates: detectGates2, runGates: runGates2 } = await import("./gates-ZC67NMW3.js");
+    const cwd = process.cwd();
+    const gates = detectGates2(cwd);
+    if (gates.length === 0) {
+      console.log(pc4.dim("no gates detected (no package.json scripts, tsconfig, or eslint config)"));
+      return;
+    }
+    console.log(pc4.dim(`running ${gates.map((g) => g.id).join(" \u2192 ")}`));
+    const results = await runGates2(cwd, gates, (result) => {
+      const mark = result.ok ? pc4.green("\u2713") : pc4.red("\u2717");
+      console.log(
+        `${mark} ${result.gate.id.padEnd(10)} ${pc4.dim(`${(result.durationMs / 1e3).toFixed(1)}s \xB7 ${result.gate.display}`)}`
+      );
+      if (!result.ok) console.log(pc4.dim(result.outputTail.split("\n").slice(-12).join("\n")));
+    });
+    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-XGASKUXR.js");
+    const result = await captureViewports2(process.cwd(), url);
+    if (!result) {
+      console.error(pc4.red("\u2717 no Chrome/Chromium found"));
+      process.exitCode = 1;
+      return;
+    }
+    for (const shot of result.shots) console.log(`${pc4.green("\u2713")} ${shot.name.padEnd(8)} ${shot.path}`);
+    for (const error of result.errors) console.error(pc4.red(`\u2717 ${error}`));
+    if (result.shots.length === 0) process.exitCode = 1;
+  });
+}
+
+// src/cli/run.ts
+import pc5 from "picocolors";
+function createPrinter() {
+  let streaming = false;
+  return (event) => {
+    switch (event.type) {
+      case "status":
+        console.log(pc5.dim(`\xB7 ${event.text}`));
+        break;
+      case "delta":
+        streaming = true;
+        process.stdout.write(event.text);
+        break;
+      case "text":
+        if (event.streamed && streaming) {
+          process.stdout.write("\n");
+        } else {
+          console.log(event.text);
+        }
+        streaming = false;
+        break;
+      case "thinking":
+        console.log(pc5.dim(pc5.italic(event.text)));
+        break;
+      case "tool":
+        if (streaming) {
+          process.stdout.write("\n");
+          streaming = false;
+        }
+        console.log(pc5.cyan(`\u2699 ${event.name}${event.detail ? ` \xB7 ${event.detail}` : ""}`));
+        break;
+      case "error":
+        console.error(pc5.red(`\u2717 ${event.text}`));
+        break;
+      case "result":
+      case "raw":
+        break;
+    }
+  };
+}
+function registerRun(program2) {
+  program2.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 (see squint engines)").option("-m, --model <name>", "model override for the engine").option("--mode <mode>", "plan (read-only) \xB7 safe (default) \xB7 yolo (no friction)").option("--no-brief", "send the prompt without the squint design brief").option("--json", "emit normalized agent events as ndjson").action(
+    async (promptWords, options) => {
+      const cwd = process.cwd();
+      if (options.mode && !["plan", "safe", "yolo"].includes(options.mode)) {
+        console.error(pc5.red("\u2717 --mode must be plan, safe, or yolo"));
+        process.exitCode = 1;
+        return;
+      }
+      const mode = options.mode;
+      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(" ");
+      const prompt = composePrompt(ask, { cwd, noBrief: !options.brief });
+      const onEvent = options.json ? (event) => {
+        if (event.type !== "delta") console.log(JSON.stringify(event));
+      } : createPrinter();
+      if (!options.json)
+        console.log(
+          pc5.dim(`squint \xB7 ${engine.id}${model ? ` \xB7 ${model}` : ""}${mode && mode !== "safe" ? ` \xB7 ${mode}` : ""}`)
+        );
+      const result = await runAgent(engine, { prompt, cwd, model, mode }, onEvent);
+      if (options.json) {
+        console.log(JSON.stringify({ type: "summary", ...result }));
+      } else if (result.ok) {
+        const cost = result.costUsd !== void 0 ? ` \xB7 $${result.costUsd.toFixed(2)}` : "";
+        const secs = result.durationMs !== void 0 ? ` \xB7 ${(result.durationMs / 1e3).toFixed(0)}s` : "";
+        console.log(pc5.green(`\u2713 done${secs}${cost}`));
+      }
+      if (!result.ok) process.exitCode = 1;
+    }
+  );
+}
+
+// src/cli/scaffold.ts
+import pc6 from "picocolors";
+function registerScaffold(program2) {
+  program2.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-LSYB32NS.js");
+    let result;
+    try {
+      result = writeTemplate(dir, { force: options.force });
+    } catch (err) {
+      console.error(pc6.red(`\u2717 ${err instanceof Error ? err.message : String(err)}`));
+      process.exitCode = 1;
+      return;
+    }
+    console.log(pc6.green(`\u2713 scaffolded ${result.files.length} files in ${result.dir}`));
+    if (options.install) {
+      console.log(pc6.dim("installing dependencies\u2026"));
+      const ok = await installDependencies(result.dir);
+      if (!ok) {
+        console.error(pc6.red("\u2717 npm install failed \u2014 run it manually"));
+        process.exitCode = 1;
+        return;
+      }
+    }
+    const cd = result.dir === "." ? "" : `cd ${result.dir} && `;
+    console.log(`
+Next: ${pc6.bold(`${cd}${options.install ? "" : "npm install && "}squint`)}`);
+    console.log(pc6.dim("then describe what to build \u2014 /dev starts the preview server"));
+  });
+  program2.command("tag").description("Add the element picker to this Vite app (Alt+S in the browser \u2192 click \u2192 file:line:col)").action(async () => {
+    const fs3 = await import("fs");
+    const nodePath = await import("path");
+    const { patchViteConfig, TAGGER_FILENAME, TAGGER_SOURCE } = await import("./source-ZZU245VN.js");
+    const cwd = process.cwd();
+    const taggerPath = nodePath.join(cwd, TAGGER_FILENAME);
+    fs3.writeFileSync(taggerPath, TAGGER_SOURCE);
+    console.log(pc6.green(`\u2713 ${TAGGER_FILENAME} written`));
+    const configPath = ["vite.config.ts", "vite.config.js", "vite.config.mjs"].map((name) => nodePath.join(cwd, name)).find((candidate) => fs3.existsSync(candidate));
+    if (!configPath) {
+      console.log(pc6.yellow("\u25CB no vite config found \u2014 add the plugin manually:"));
+      console.log(pc6.dim(`  import squintTagger from './${TAGGER_FILENAME}'
+  plugins: [squintTagger(), \u2026]`));
+      return;
+    }
+    const source = fs3.readFileSync(configPath, "utf8");
+    const patched = patchViteConfig(source);
+    if (patched === "already") {
+      console.log(pc6.dim("vite config already wired"));
+    } else if (patched === null) {
+      console.log(pc6.yellow(`\u25CB could not patch ${nodePath.basename(configPath)} automatically \u2014 add:`));
+      console.log(pc6.dim(`  import squintTagger from './${TAGGER_FILENAME}'
+  plugins: [squintTagger(), \u2026]`));
+    } else {
+      fs3.writeFileSync(configPath, patched);
+      console.log(pc6.green(`\u2713 ${nodePath.basename(configPath)} wired`));
+    }
+    console.log(
+      pc6.dim("\nin the running app: Alt+S \u2192 click elements to pin, alt+enter copies all \u2014 paste into squint")
+    );
+  });
+}
+
+// src/cli/tui.tsx
+import { render } from "ink";
+
 // src/tui/App.tsx
 import { Box as Box2, Static, Text as Text3, useApp, useInput } from "ink";
-import path3 from "path";
+import path4 from "path";
 import { useMemo, useRef, useState as useState2, useSyncExternalStore } from "react";
 
 // src/session/engine.ts
+import path3 from "path";
+
+// src/vcs/sandbox.ts
+import { execFileSync } from "child_process";
+import fs2 from "fs";
 import path2 from "path";
+function git(cwd, args) {
+  return execFileSync("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
+}
+function sandboxDir(cwd) {
+  return path2.join(cwd, ".squint", "sandbox");
+}
+function sandboxExists(cwd) {
+  return fs2.existsSync(path2.join(sandboxDir(cwd), ".git"));
+}
+function openSandbox(cwd) {
+  const dir = sandboxDir(cwd);
+  if (sandboxExists(cwd)) return { dir, reused: true };
+  fs2.rmSync(dir, { recursive: true, force: true });
+  fs2.mkdirSync(path2.dirname(dir), { recursive: true });
+  git(cwd, ["worktree", "add", "--force", "--detach", dir, "HEAD"]);
+  const mainModules = path2.join(cwd, "node_modules");
+  const sandboxModules = path2.join(dir, "node_modules");
+  if (fs2.existsSync(mainModules) && !fs2.existsSync(sandboxModules)) {
+    fs2.symlinkSync(mainModules, sandboxModules, "dir");
+  }
+  return { dir, reused: false };
+}
+function sandboxDiffStat(cwd) {
+  if (!sandboxExists(cwd)) return null;
+  const dir = sandboxDir(cwd);
+  try {
+    git(dir, ["add", "-A"]);
+    const stat = git(dir, ["diff", "--cached", "--shortstat", "HEAD"]);
+    return stat.length > 0 ? stat : null;
+  } catch {
+    return null;
+  }
+}
+function sandboxFiles(cwd) {
+  if (!sandboxExists(cwd)) return [];
+  const dir = sandboxDir(cwd);
+  try {
+    git(dir, ["add", "-A"]);
+    const out = git(dir, ["diff", "--cached", "--name-status", "HEAD"]);
+    return out.length > 0 ? out.split("\n") : [];
+  } catch {
+    return [];
+  }
+}
+function applySandbox(cwd) {
+  if (!sandboxExists(cwd)) return { ok: false, detail: "no sandbox open" };
+  const dir = sandboxDir(cwd);
+  try {
+    git(dir, ["add", "-A"]);
+    const patch = git(dir, ["diff", "--binary", "--cached", "HEAD"]);
+    if (patch.length === 0) return { ok: false, detail: "sandbox has no changes" };
+    const patchFile = path2.join(cwd, ".squint", "sandbox.patch");
+    fs2.writeFileSync(patchFile, patch + "\n");
+    git(cwd, ["apply", "--whitespace=nowarn", patchFile]);
+    fs2.rmSync(patchFile, { force: true });
+    return { ok: true };
+  } catch (err) {
+    return { ok: false, detail: err instanceof Error ? err.message.split("\n")[0] : String(err) };
+  }
+}
+function discardSandbox(cwd) {
+  if (!sandboxExists(cwd)) return false;
+  const dir = sandboxDir(cwd);
+  try {
+    const link = path2.join(dir, "node_modules");
+    if (fs2.existsSync(link) && fs2.lstatSync(link).isSymbolicLink()) fs2.rmSync(link);
+  } catch {
+  }
+  try {
+    git(cwd, ["worktree", "remove", "--force", dir]);
+  } catch {
+    fs2.rmSync(dir, { recursive: true, force: true });
+  }
+  try {
+    git(cwd, ["worktree", "prune"]);
+  } catch {
+  }
+  return true;
+}
+
+// src/session/engine.ts
 var MAX_AUTO_FIX_ATTEMPTS = 2;
 var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 var Session = class {
@@ -175,7 +678,8 @@ var Session = class {
       totals: { costUsd: 0, turns: 0 },
       queue: [],
       mode: "safe",
-      problems: []
+      problems: [],
+      sandbox: false
     };
     if (opts.autoDev && detectDevCommand(opts.cwd)) {
       this.devServer().start();
@@ -209,6 +713,7 @@ var Session = class {
   fixAttempts = 0;
   reviewTipShown = false;
   lastPulse = null;
+  autoReviewedThisAsk = false;
   startedAt = Date.now();
   subscribe(listener) {
     this.listeners.add(listener);
@@ -344,15 +849,33 @@ var Session = class {
       this.push("assistant", text);
     }
   }
+  /** Where engines run and servers start: the sandbox worktree when on. */
+  execCwd() {
+    return this.state.sandbox ? sandboxDir(this.opts.cwd) : this.opts.cwd;
+  }
   devServer() {
     if (!this.dev) {
-      this.dev = new DevServer(this.opts.cwd, {
+      this.dev = new DevServer(this.execCwd(), {
         onStateChange: (devState) => this.notify({ devState }),
         onUrl: (url) => this.notify({ devUrl: url })
       });
     }
     return this.dev;
   }
+  /** Rebind the dev server after the execution tree changes. */
+  resetDevServer() {
+    const wasRunning = this.dev && this.dev.state !== "stopped";
+    this.dev?.stop();
+    this.dev = null;
+    this.notify({ devUrl: null, devState: "stopped" });
+    if (wasRunning) {
+      const command = detectDevCommand(this.execCwd());
+      if (command) {
+        this.devServer().start(command);
+        this.push("status", `dev server restarting in ${this.state.sandbox ? "the sandbox" : "the real tree"}`);
+      }
+    }
+  }
   turnEdits = 0;
   turnTools = 0;
   toolStreak = 0;
@@ -431,7 +954,7 @@ var Session = class {
       engine,
       {
         prompt,
-        cwd: this.opts.cwd,
+        cwd: this.execCwd(),
         model: this.state.model,
         mode: this.state.mode,
         sessionId: engine.supportsResume ? this.sessionId : void 0
@@ -474,9 +997,9 @@ var Session = class {
       }
     }
     if (result.ok && this.opts.autoCheck !== false) {
-      const fastGates = detectFastGates(this.opts.cwd);
+      const fastGates = detectFastGates(this.execCwd());
       if (fastGates.length > 0) {
-        const gateResults = await runGates(this.opts.cwd, fastGates);
+        const gateResults = await runGates(this.execCwd(), fastGates);
         const failures = gateResults.filter((r) => !r.ok);
         if (failures.length > 0) {
           this.addProblem(
@@ -523,7 +1046,20 @@ ${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");
-            await this.visualPulse(probe.pulsePath);
+            const pct = await this.visualPulse(probe.pulsePath);
+            if (this.opts.autoReview && pct !== null && pct >= 10 && !this.autoReviewedThisAsk) {
+              this.autoReviewedThisAsk = true;
+              this.push("status", `auto-review: the page changed ${pct.toFixed(0)}% \u2014 capturing for self-critique`);
+              this.notify({ running: false });
+              const captureResult = await this.capture();
+              if (captureResult) {
+                await this.runTurn(
+                  buildReviewPrompt(captureResult.shots, void 0, captureResult.runtime, captureResult.a11y),
+                  "\u{1F441} auto-review rendered UI"
+                );
+              }
+              return;
+            }
           }
         }
         if (!this.reviewTipShown && this.state.devUrl) {
@@ -537,7 +1073,8 @@ ${errors.slice(-5).join("\n")}`);
   }
   async submit(ask) {
     this.fixAttempts = 0;
-    const snapshot = takeSnapshot(this.opts.cwd);
+    this.autoReviewedThisAsk = false;
+    const snapshot = this.state.sandbox ? null : takeSnapshot(this.opts.cwd);
     if (snapshot) {
       this.checkpoints.push({
         snapshot,
@@ -580,25 +1117,26 @@ ${errors.slice(-5).join("\n")}`);
    * Informational — changes are usually intended; surprises shouldn't be.
    */
   async visualPulse(pulsePath) {
-    if (!pulsePath) return;
+    if (!pulsePath) return null;
     let current;
     try {
       current = (await import("fs")).readFileSync(pulsePath);
     } catch {
-      return;
+      return null;
     }
     const previous = this.lastPulse;
     this.lastPulse = current;
     if (!previous) {
       this.push("status", "visual pulse: baseline captured");
-      return;
+      return null;
     }
     const pct = await comparePulse(previous, current);
-    if (pct === null) return;
+    if (pct === null) return null;
     this.push(
       "status",
       pct < 0.5 ? "visual pulse: stable vs last turn" : `visual pulse: ${pct.toFixed(1)}% of the page changed vs last turn`
     );
+    return pct;
   }
   /** Screenshot the running app (and watch its runtime where CDP is available). */
   async capture() {
@@ -616,7 +1154,7 @@ ${errors.slice(-5).join("\n")}`);
     if (result.shots.length > 0) {
       this.push(
         "status",
-        `captured ${result.shots.map((s) => s.name).join(", ")} \u2192 ${path2.dirname(result.shots[0].path)}`
+        `captured ${result.shots.map((s) => s.name).join(", ")} \u2192 ${path3.dirname(result.shots[0].path)}`
       );
     }
     if (result.runtime) {
@@ -691,6 +1229,23 @@ They are objective defects, not style preferences.`
         break;
       case "dev": {
         const dev = this.devServer();
+        if (arg === "logs") {
+          const tail = dev.tail(15);
+          this.push("status", tail.length > 0 ? tail.join("\n") : "no dev server output captured yet");
+          break;
+        }
+        if (arg === "restart") {
+          if (dev.state !== "stopped") dev.stop();
+          this.notify({ devUrl: null });
+          const devCommand = detectDevCommand(this.opts.cwd);
+          if (!devCommand) {
+            this.push("error", "no dev/start script found in package.json");
+          } else {
+            dev.start(devCommand);
+            this.push("status", `dev server restarting \xB7 ${devCommand.display}`);
+          }
+          break;
+        }
         if (dev.state === "stopped" || dev.state === "crashed") {
           const devCommand = detectDevCommand(this.opts.cwd);
           if (!devCommand) {
@@ -726,12 +1281,12 @@ They are objective defects, not style preferences.`
       }
       case "save": {
         void (async () => {
-          const fs2 = await import("fs");
-          const path4 = await import("path");
-          const dir = path4.join(this.opts.cwd, ".squint", "transcripts");
-          fs2.mkdirSync(dir, { recursive: true });
+          const fs3 = await import("fs");
+          const path5 = await import("path");
+          const dir = path5.join(this.opts.cwd, ".squint", "transcripts");
+          fs3.mkdirSync(dir, { recursive: true });
           const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
-          const file = path4.join(dir, `${stamp}.md`);
+          const file = path5.join(dir, `${stamp}.md`);
           const lines = [`# squint session \u2014 ${(/* @__PURE__ */ new Date()).toISOString().slice(0, 16)}`, ""];
           for (const item of this.state.items) {
             switch (item.role) {
@@ -751,8 +1306,8 @@ They are objective defects, not style preferences.`
             }
           }
           lines.push("", `> ${this.summary()}`);
-          fs2.writeFileSync(file, lines.join("\n") + "\n");
-          this.push("status", `saved transcript \u2192 ${path4.relative(this.opts.cwd, file)}`);
+          fs3.writeFileSync(file, lines.join("\n") + "\n");
+          this.push("status", `saved transcript \u2192 ${path5.relative(this.opts.cwd, file)}`);
         })();
         break;
       }
@@ -870,6 +1425,57 @@ They are objective defects, not style preferences.`
         this.push("status", `resumed ${saved.engine} session${saved.lastAsk ? ` \xB7 "${saved.lastAsk}"` : ""}`);
         break;
       }
+      case "sandbox": {
+        if (this.state.running) {
+          this.push("status", "wait for the current turn before changing sandbox state");
+          break;
+        }
+        if (arg === "diff") {
+          const stat = sandboxDiffStat(this.opts.cwd);
+          if (!stat) {
+            this.push("status", sandboxExists(this.opts.cwd) ? "sandbox is clean" : "no sandbox open \u2014 /sandbox on");
+          } else {
+            this.push("status", `${stat}
+${sandboxFiles(this.opts.cwd).join("\n")}`);
+          }
+          break;
+        }
+        if (arg === "apply") {
+          const applied = applySandbox(this.opts.cwd);
+          if (applied.ok) {
+            discardSandbox(this.opts.cwd);
+            this.notify({ sandbox: false });
+            this.resetDevServer();
+            this.push("status", "sandbox applied to the real tree \u2014 review with git diff");
+          } else {
+            this.push("error", applied.detail ?? "apply failed");
+          }
+          break;
+        }
+        if (arg === "discard" || arg === "off") {
+          const had = discardSandbox(this.opts.cwd);
+          this.notify({ sandbox: false });
+          this.resetDevServer();
+          this.push("status", had ? "sandbox discarded \u2014 the real tree was never touched" : "no sandbox open");
+          break;
+        }
+        if (arg === "on" || arg === "") {
+          if (!isGitRepo(this.opts.cwd)) {
+            this.push("error", "sandbox needs a git repo with at least one commit");
+            break;
+          }
+          const { reused } = openSandbox(this.opts.cwd);
+          this.notify({ sandbox: true });
+          this.resetDevServer();
+          this.push(
+            "status",
+            `${reused ? "rejoined the open sandbox" : "sandbox opened"} \u2014 asks now accumulate in a shadow worktree; /sandbox diff \xB7 apply \xB7 discard`
+          );
+          break;
+        }
+        this.push("status", "usage: /sandbox [on] \xB7 diff \xB7 apply \xB7 discard");
+        break;
+      }
       case "variants": {
         const [sub, ...subRest] = arg.split(/\s+/);
         if (sub === "apply") {
@@ -945,7 +1551,7 @@ They are objective defects, not style preferences.`
         this.notify({ items: [], totals: { costUsd: 0, turns: 0 } });
         break;
       case "help": {
-        void import("./commands-7DTZB4JE.js").then(({ commandHelp }) => this.push("status", commandHelp()));
+        void import("./commands-N33DKZKC.js").then(({ commandHelp }) => this.push("status", commandHelp()));
         break;
       }
       case "quit":
@@ -1287,6 +1893,7 @@ function App({
   autoFix,
   autoProbe,
   autoCheck,
+  autoReview,
   bell,
   budgetUsd,
   initialTheme
@@ -1304,6 +1911,7 @@ function App({
       autoFix,
       autoProbe,
       autoCheck,
+      autoReview,
       budgetUsd,
       // Delay lets the goodbye summary land in the Static scrollback.
       onQuit: () => setTimeout(() => exit(), 60)
@@ -1473,11 +2081,12 @@ function App({
           ]
         }
       ),
+      state.sandbox && /* @__PURE__ */ jsx3(Text3, { color: theme2.accent, bold: true, children: " [sandbox]" }),
       " ",
       state.engineId,
       state.model ? ` \xB7 ${state.model}` : "",
       " \xB7 ",
-      path3.basename(cwd),
+      path4.basename(cwd),
       devBadge,
       totalsBadge,
       state.problems.length > 0 && /* @__PURE__ */ jsxs3(Text3, { color: theme2.error, children: [
@@ -1492,409 +2101,49 @@ function App({
   ] }) });
 }
 
-// src/cli.tsx
+// src/cli/tui.tsx
 import { jsx as jsx4 } from "react/jsx-runtime";
-var VERSION = "0.2.6";
-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 (see squint engines)").option("-m, --model <name>", "model override for the engine").option("--mode <mode>", "plan (read-only) \xB7 safe (default) \xB7 yolo (no friction)").option("--no-brief", "send the prompt without the squint design brief").option("--json", "emit normalized agent events as ndjson").action(
-  async (promptWords, options) => {
+function registerTui(program2) {
+  program2.action(async () => {
     const cwd = process.cwd();
-    if (options.mode && !["plan", "safe", "yolo"].includes(options.mode)) {
-      console.error(pc.red("\u2717 --mode must be plan, safe, or yolo"));
-      process.exitCode = 1;
-      return;
-    }
-    const mode = options.mode;
     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(" ");
-    const prompt = composePrompt(ask, { cwd, noBrief: !options.brief });
-    const onEvent = options.json ? (event) => {
-      if (event.type !== "delta") console.log(JSON.stringify(event));
-    } : createPrinter();
-    if (!options.json)
-      console.log(pc.dim(`squint \xB7 ${engine.id}${model ? ` \xB7 ${model}` : ""}${mode && mode !== "safe" ? ` \xB7 ${mode}` : ""}`));
-    const result = await runAgent(engine, { prompt, cwd, model, mode }, onEvent);
-    if (options.json) {
-      console.log(JSON.stringify({ type: "summary", ...result }));
-    } else if (result.ok) {
-      const cost = result.costUsd !== void 0 ? ` \xB7 $${result.costUsd.toFixed(2)}` : "";
-      const secs = result.durationMs !== void 0 ? ` \xB7 ${(result.durationMs / 1e3).toFixed(0)}s` : "";
-      console.log(pc.green(`\u2713 done${secs}${cost}`));
-    }
-    if (!result.ok) process.exitCode = 1;
-  }
-);
-program.command("engines").description("List engines: installed, streaming, session resume").action(() => {
-  console.log(pc.dim("   id         name           stream  resume  where"));
-  for (const { engine, path: binaryPath } of detectEngines()) {
-    const status = binaryPath ? pc.green("\u2713") : pc.red("\u2717");
-    const stream = engine.createParser ? pc.green("yes") : pc.dim("text");
-    const resume = engine.supportsResume ? pc.green("yes") : pc.dim("no");
-    const location = binaryPath ?? pc.dim(`not found \u2014 ${engine.install}`);
-    console.log(
-      `${status} ${engine.id.padEnd(10)} ${engine.name.padEnd(14)} ${stream.padEnd(15)} ${resume.padEnd(14)} ${location}`
-    );
-  }
-  console.log(pc.dim("\nplan/safe/yolo modes map onto every engine \xB7 squint doctor --probe verifies auth"));
-});
-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) >= 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}`)}`);
-  }
-  if (options.probe) {
-    const { runAgent: runAgent2 } = await import("./run-S772BPMZ.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 engineId = resolveEngineId(config);
+    const model = resolveModel(config, engineId);
+    let theme2 = config.theme;
+    if (!theme2 && !process.env.NO_COLOR) {
+      const { detectBackground } = await import("./background-J7OQTYEC.js");
+      if (await detectBackground() === "light") theme2 = "light";
     }
-  }
-  const { findChrome: findChrome2 } = await import("./chrome-NVU47PLK.js");
-  const { hasWebSocket } = await import("./cdp-SFWNP7OA.js");
-  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")}`
-  );
-  console.log(
-    hasWebSocket() ? `${pc.green("\u2713")} WebSocket ${pc.dim("runtime console/network capture available")}` : `${pc.yellow("\u25CB")} WebSocket ${pc.dim("\u2014 node 22+ enables runtime capture; screenshots still work")}`
-  );
-  const available = detected.filter((d) => d.path !== null);
-  if (available.length === 0) {
-    console.log(pc.red("\nNo engines found. Install at least one to use squint."));
-    process.exitCode = 1;
-  } else {
-    console.log(pc.dim(`
-${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-LSYB32NS.js");
-  let result;
-  try {
-    result = writeTemplate(dir, { force: options.force });
-  } catch (err) {
-    console.error(pc.red(`\u2717 ${err instanceof Error ? err.message : String(err)}`));
-    process.exitCode = 1;
-    return;
-  }
-  console.log(pc.green(`\u2713 scaffolded ${result.files.length} files in ${result.dir}`));
-  if (options.install) {
-    console.log(pc.dim("installing dependencies\u2026"));
-    const ok = await installDependencies(result.dir);
-    if (!ok) {
-      console.error(pc.red("\u2717 npm install failed \u2014 run it manually"));
-      process.exitCode = 1;
-      return;
-    }
-  }
-  const cd = result.dir === "." ? "" : `cd ${result.dir} && `;
-  console.log(`
-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-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"));
-  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-ZZU245VN.js");
-  const cwd = process.cwd();
-  const taggerPath = nodePath.join(cwd, TAGGER_FILENAME);
-  fs2.writeFileSync(taggerPath, TAGGER_SOURCE);
-  console.log(pc.green(`\u2713 ${TAGGER_FILENAME} written`));
-  const configPath = ["vite.config.ts", "vite.config.js", "vite.config.mjs"].map((name) => nodePath.join(cwd, name)).find((candidate) => fs2.existsSync(candidate));
-  if (!configPath) {
-    console.log(pc.yellow("\u25CB no vite config found \u2014 add the plugin manually:"));
-    console.log(pc.dim(`  import squintTagger from './${TAGGER_FILENAME}'
-  plugins: [squintTagger(), \u2026]`));
-    return;
-  }
-  const source = fs2.readFileSync(configPath, "utf8");
-  const patched = patchViteConfig(source);
-  if (patched === "already") {
-    console.log(pc.dim("vite config already wired"));
-  } else if (patched === null) {
-    console.log(pc.yellow(`\u25CB could not patch ${nodePath.basename(configPath)} automatically \u2014 add:`));
-    console.log(pc.dim(`  import squintTagger from './${TAGGER_FILENAME}'
-  plugins: [squintTagger(), \u2026]`));
-  } else {
-    fs2.writeFileSync(configPath, patched);
-    console.log(pc.green(`\u2713 ${nodePath.basename(configPath)} wired`));
-  }
-  console.log(pc.dim("\nin the running app: Alt+S \u2192 click an element \u2192 paste the copied file:line:col into squint"));
-});
-var variantsCommand = program.command("variants").description("Parallel design explorations \u2014 one aesthetic family each, pick with your eyes");
-variantsCommand.command("gen").description("Generate n variants of one ask in parallel (n engine runs \u2014 n\xD7 cost)").argument("<n>", "how many variants (max 4)").argument("<prompt...>", "what to build").option("-e, --engine <id>", "engine to use").option("-m, --model <name>", "model override").option("--no-shots", "skip the screenshot pass").action(
-  async (nRaw, promptWords, options) => {
-    const cwd = process.cwd();
-    const n = Number.parseInt(nRaw, 10);
-    if (!Number.isInteger(n) || n < 2 || n > 4) {
-      console.error(pc.red("\u2717 n must be 2\u20134"));
-      process.exitCode = 1;
-      return;
-    }
-    const { isGitRepo: isGitRepo2 } = await import("./snapshot-H6VYFHLN.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: runVariants2, cleanVariants: cleanVariants2 } = await import("./variants-2IM274AL.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(" ");
-    cleanVariants2(cwd);
-    console.log(pc.dim(`generating ${n} directions in parallel via ${engine.id} \u2014 this runs ${n} engine sessions`));
-    const runs = await runVariants2(
-      cwd,
-      ask,
-      n,
-      engine,
-      model,
-      (familyId, text) => console.log(`${pc.cyan(familyId.padEnd(18))} ${pc.dim(text)}`)
-    );
-    const succeeded = runs.filter((r) => r.result.ok);
-    if (options.shots && succeeded.length > 0) {
-      const { screenshotVariants: screenshotVariants2 } = await import("./shots-J7JG2FC4.js");
-      console.log(pc.dim("capturing screenshots\u2026"));
-      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 ?? "")}`);
-      }
-    }
-    console.log(
-      `
-${succeeded.length}/${runs.length} variants ready in .squint/variants/ \u2014 ` + pc.bold("squint variants apply <id>") + pc.dim(" applies the winner, squint variants clean discards all")
+    render(
+      /* @__PURE__ */ jsx4(
+        App,
+        {
+          cwd,
+          initialEngine: engineId,
+          initialModel: model,
+          autoDev: config.autoDev,
+          autoFix: config.autoFix,
+          autoProbe: config.autoProbe,
+          autoCheck: config.autoCheck,
+          autoReview: config.autoReview,
+          bell: config.bell,
+          budgetUsd: config.budgetUsd,
+          initialTheme: theme2
+        }
+      )
     );
-    if (succeeded.length === 0) process.exitCode = 1;
-  }
-);
-variantsCommand.command("list").description("List generated variants").action(async () => {
-  const { listVariants: listVariants2 } = await import("./variants-2IM274AL.js");
-  const ids = listVariants2(process.cwd());
-  if (ids.length === 0) {
-    console.log(pc.dim('no variants \u2014 squint variants gen <n> "<ask>"'));
-    return;
-  }
-  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: applyVariant2, cleanVariants: cleanVariants2 } = await import("./variants-2IM274AL.js");
-  const cwd = process.cwd();
-  const result = applyVariant2(cwd, id);
-  if (!result.ok) {
-    console.error(pc.red(`\u2717 ${result.detail}`));
-    process.exitCode = 1;
-    return;
-  }
-  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: cleanVariants2 } = await import("./variants-2IM274AL.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-2G5SLLY7.js");
-  if (!familyId) {
-    console.log(pc.bold("Aesthetic families") + pc.dim(" \u2014 squint brief <id>\n"));
-    for (const family2 of FAMILIES) {
-      console.log(`${pc.green(family2.id.padEnd(18))} ${family2.name.padEnd(22)} ${pc.dim(family2.summary)}`);
-    }
-    console.log(pc.dim("\nThe brief wraps every ask; edit .squint/brief.md to remix."));
-    return;
-  }
-  const family = getFamily(familyId);
-  if (!family) {
-    console.error(pc.red(`\u2717 unknown family "${familyId}" \u2014 run squint brief to list`));
-    process.exitCode = 1;
-    return;
-  }
-  const target = nodePath.join(process.cwd(), ".squint", "brief.md");
-  if (fs2.existsSync(target) && !options.force) {
-    console.error(pc.red(`\u2717 ${target} exists \u2014 use --force to overwrite`));
-    process.exitCode = 1;
-    return;
-  }
-  fs2.mkdirSync(nodePath.dirname(target), { recursive: true });
-  fs2.writeFileSync(target, renderFamilyBrief(family) + "\n");
-  console.log(pc.green(`\u2713 ${family.name} direction written to .squint/brief.md`));
-  console.log(pc.dim("every squint ask in this repo now holds this direction \u2014 edit the file to remix"));
-});
-program.command("check").description("Run this project\u2019s quality gates (typecheck, lint, test, build)").action(async () => {
-  const { detectGates: detectGates2, runGates: runGates2 } = await import("./gates-ZC67NMW3.js");
-  const cwd = process.cwd();
-  const gates = detectGates2(cwd);
-  if (gates.length === 0) {
-    console.log(pc.dim("no gates detected (no package.json scripts, tsconfig, or eslint config)"));
-    return;
-  }
-  console.log(pc.dim(`running ${gates.map((g) => g.id).join(" \u2192 ")}`));
-  const results = await runGates2(cwd, gates, (result) => {
-    const mark = result.ok ? pc.green("\u2713") : pc.red("\u2717");
-    console.log(`${mark} ${result.gate.id.padEnd(10)} ${pc.dim(`${(result.durationMs / 1e3).toFixed(1)}s \xB7 ${result.gate.display}`)}`);
-    if (!result.ok) console.log(pc.dim(result.outputTail.split("\n").slice(-12).join("\n")));
   });
-  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-UCH7H5R5.js");
-  const result = await captureViewports2(process.cwd(), url);
-  if (!result) {
-    console.error(pc.red("\u2717 no Chrome/Chromium found"));
-    process.exitCode = 1;
-    return;
-  }
-  for (const shot of result.shots) console.log(`${pc.green("\u2713")} ${shot.name.padEnd(8)} ${shot.path}`);
-  for (const error of result.errors) console.error(pc.red(`\u2717 ${error}`));
-  if (result.shots.length === 0) process.exitCode = 1;
-});
-var configCommand = program.command("config").description("Read or change squint configuration");
-configCommand.command("get").description("Print the resolved configuration").action(() => {
-  const paths = defaultPaths(process.cwd());
-  console.log(JSON.stringify(loadConfig(paths), null, 2));
-});
-configCommand.command("set").description("Set a value (keys: engine, models.<engineId>)").argument("<key>").argument("<value>").option("--project", "write to this project (.squint/config.json) instead of global").action((key, value, options) => {
-  const paths = defaultPaths(process.cwd());
-  const file = options.project ? paths.projectFile : paths.globalFile;
-  setConfigValue(file, key, value);
-  console.log(pc.green(`\u2713 ${key} = ${value}`) + pc.dim(` (${file})`));
-});
-configCommand.command("path").description("Show config file locations").action(() => {
-  const paths = defaultPaths(process.cwd());
-  console.log(`global   ${paths.globalFile}`);
-  console.log(`project  ${paths.projectFile}`);
-});
-program.action(async () => {
-  const cwd = process.cwd();
-  const config = loadConfig(defaultPaths(cwd));
-  const engineId = resolveEngineId(config);
-  const model = resolveModel(config, engineId);
-  let theme2 = config.theme;
-  if (!theme2 && !process.env.NO_COLOR) {
-    const { detectBackground } = await import("./background-J7OQTYEC.js");
-    if (await detectBackground() === "light") theme2 = "light";
-  }
-  render(
-    /* @__PURE__ */ jsx4(
-      App,
-      {
-        cwd,
-        initialEngine: engineId,
-        initialModel: model,
-        autoDev: config.autoDev,
-        autoFix: config.autoFix,
-        autoProbe: config.autoProbe,
-        autoCheck: config.autoCheck,
-        bell: config.bell,
-        budgetUsd: config.budgetUsd,
-        initialTheme: theme2
-      }
-    )
-  );
-});
-function createPrinter() {
-  let streaming = false;
-  return (event) => {
-    switch (event.type) {
-      case "status":
-        console.log(pc.dim(`\xB7 ${event.text}`));
-        break;
-      case "delta":
-        streaming = true;
-        process.stdout.write(event.text);
-        break;
-      case "text":
-        if (event.streamed && streaming) {
-          process.stdout.write("\n");
-        } else {
-          console.log(event.text);
-        }
-        streaming = false;
-        break;
-      case "thinking":
-        console.log(pc.dim(pc.italic(event.text)));
-        break;
-      case "tool":
-        if (streaming) {
-          process.stdout.write("\n");
-          streaming = false;
-        }
-        console.log(pc.cyan(`\u2699 ${event.name}${event.detail ? ` \xB7 ${event.detail}` : ""}`));
-        break;
-      case "error":
-        console.error(pc.red(`\u2717 ${event.text}`));
-        break;
-      case "result":
-      case "raw":
-        break;
-    }
-  };
 }
+
+// src/cli.tsx
+var VERSION = "0.2.8";
+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);
+registerEnv(program);
+registerScaffold(program);
+registerProject(program);
+registerQuality(program);
+registerConfig(program);
+registerTui(program);
 program.parseAsync(process.argv);