@locusai/cli 0.21.17 → 0.22.0

package/bin/locus.js

@@ -3628,13 +3628,25 @@ class InputHandler {
   prompt;
   getHistory;
   onTab;
+  activeInsertText = null;
+  activeRender = null;
   locked = false;
   lastInterruptTime = 0;
+  pendingInsert = null;
   constructor(options) {
     this.prompt = options.prompt;
     this.getHistory = options.getHistory ?? (() => []);
     this.onTab = options.onTab;
   }
+  insertTextFromExternal(text) {
+    if (this.activeInsertText && this.activeRender) {
+      this.activeInsertText(text);
+      this.activeRender();
+    }
+  }
+  setInitialBuffer(text) {
+    this.pendingInsert = text;
+  }
   setPrompt(prompt) {
     this.prompt = prompt;
   }
@@ -3671,6 +3683,8 @@ class InputHandler {
         if (resolved)
           return;
         resolved = true;
+        this.activeInsertText = null;
+        this.activeRender = null;
         stdin.removeListener("data", onData);
         if (stdin.isTTY) {
           out.write(DISABLE_BRACKETED_PASTE + DISABLE_KITTY_KEYBOARD);
@@ -4138,6 +4152,12 @@ ${dim2("Press Ctrl+C again to exit")}\r
       if (stdin.isTTY) {
         out.write(ENABLE_BRACKETED_PASTE + ENABLE_KITTY_KEYBOARD);
       }
+      this.activeInsertText = insertText;
+      this.activeRender = render;
+      if (this.pendingInsert) {
+        insertText(this.pendingInsert);
+        this.pendingInsert = null;
+      }
       render();
     });
   }
@@ -7508,13 +7528,13 @@ function getSlashCommands() {
   return [
     {
       name: "/help",
-      aliases: ["/h", "/?"],
+      aliases: ["/h"],
       description: "Show available commands",
       handler: cmdHelp
     },
     {
       name: "/clear",
-      aliases: ["/cls"],
+      aliases: [],
       description: "Clear screen",
       handler: cmdClear
     },
@@ -7550,7 +7570,7 @@ function getSlashCommands() {
     },
     {
       name: "/undo",
-      aliases: ["/u"],
+      aliases: [],
       description: "Undo last AI change",
       handler: cmdUndo
     },
@@ -7562,10 +7582,16 @@ function getSlashCommands() {
     },
     {
       name: "/verbose",
-      aliases: ["/v"],
+      aliases: [],
       description: "Toggle verbose mode (show agent stderr streams)",
       handler: cmdVerbose
     },
+    {
+      name: "/voice",
+      aliases: ["/v"],
+      description: "Start voice recording (press Enter to stop)",
+      handler: cmdVoice
+    },
     {
       name: "/exit",
       aliases: ["/quit", "/q"],
@@ -7764,6 +7790,14 @@ function cmdVerbose(_args, ctx) {
   process.stderr.write(`${isOn ? green("✓") : dim2("○")} Verbose mode ${isOn ? bold2("on") : "off"} — agent streams ${isOn ? "visible" : "hidden"}.
 `);
 }
+function cmdVoice(_args, ctx) {
+  if (ctx.onVoiceToggle) {
+    ctx.onVoiceToggle();
+  } else {
+    process.stderr.write(`${red2("✗")} Voice input not available in this session.
+`);
+  }
+}
 function cmdExit(_args, ctx) {
   ctx.onExit();
 }
@@ -8110,8 +8144,544 @@ var init_session_manager = __esm(() => {
   SESSION_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1000;
 });
 
+// src/repl/voice.ts
+import { execSync as execSync9, spawn as spawn6 } from "node:child_process";
+import { existsSync as existsSync17, mkdirSync as mkdirSync12, unlinkSync as unlinkSync4 } from "node:fs";
+import { cpus, homedir as homedir4, platform, tmpdir as tmpdir4 } from "node:os";
+import { join as join17 } from "node:path";
+function getWhisperModelPath() {
+  return join17(WHISPER_MODELS_DIR, `ggml-${WHISPER_MODEL}.bin`);
+}
+function commandExists(cmd) {
+  try {
+    const which = platform() === "win32" ? "where" : "which";
+    execSync9(`${which} ${cmd}`, { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function findWhisperBinary() {
+  const candidates = ["whisper-cli", "whisper-cpp", "whisper", "main"];
+  for (const name of candidates) {
+    if (commandExists(name))
+      return name;
+  }
+  for (const name of candidates) {
+    const fullPath = join17(LOCUS_BIN_DIR, name);
+    if (existsSync17(fullPath))
+      return fullPath;
+  }
+  if (platform() === "darwin") {
+    const brewDirs = ["/opt/homebrew/bin", "/usr/local/bin"];
+    for (const dir of brewDirs) {
+      for (const name of candidates) {
+        const fullPath = join17(dir, name);
+        if (existsSync17(fullPath))
+          return fullPath;
+      }
+    }
+  }
+  return null;
+}
+function findSoxRecBinary() {
+  if (commandExists("rec"))
+    return "rec";
+  if (commandExists("sox"))
+    return "sox";
+  if (platform() === "darwin") {
+    const brewDirs = ["/opt/homebrew/bin", "/usr/local/bin"];
+    for (const dir of brewDirs) {
+      const recPath = join17(dir, "rec");
+      if (existsSync17(recPath))
+        return recPath;
+      const soxPath = join17(dir, "sox");
+      if (existsSync17(soxPath))
+        return soxPath;
+    }
+  }
+  return null;
+}
+function checkDependencies() {
+  const soxBinary = findSoxRecBinary();
+  const whisperBinary = findWhisperBinary();
+  const modelDownloaded = existsSync17(getWhisperModelPath());
+  return {
+    sox: soxBinary !== null,
+    whisper: whisperBinary !== null,
+    whisperBinary,
+    soxBinary,
+    modelDownloaded
+  };
+}
+function printDependencyHelp(deps) {
+  const out = process.stderr;
+  out.write(`
+${bold2("Voice Input Setup")}
+
+`);
+  if (!deps.sox) {
+    out.write(`  ${red2("✗")} ${bold2("sox")} — audio recording
+`);
+    if (platform() === "darwin") {
+      out.write(`    Install: ${cyan2("brew install sox")}
+`);
+    } else {
+      out.write(`    Install: ${cyan2("sudo apt install sox")} or ${cyan2("sudo dnf install sox")}
+`);
+    }
+  } else {
+    out.write(`  ${green("✓")} ${bold2("sox")} — audio recording ${dim2(`(${deps.soxBinary})`)}
+`);
+  }
+  if (!deps.whisper) {
+    out.write(`  ${red2("✗")} ${bold2("whisper.cpp")} — speech-to-text
+`);
+    if (platform() === "darwin") {
+      out.write(`    Install: ${cyan2("brew install whisper-cpp")}
+`);
+    } else {
+      out.write(`    Install: Build from source — ${cyan2("https://github.com/ggerganov/whisper.cpp")}
+`);
+    }
+  } else {
+    out.write(`  ${green("✓")} ${bold2("whisper.cpp")} — speech-to-text ${dim2(`(${deps.whisperBinary})`)}
+`);
+  }
+  if (deps.whisper && !deps.modelDownloaded) {
+    out.write(`  ${yellow2("!")} Model ${bold2(WHISPER_MODEL)} not downloaded yet — will download on first use (~150MB)
+`);
+    out.write(`    Path: ${dim2(getWhisperModelPath())}
+`);
+  } else if (deps.whisper && deps.modelDownloaded) {
+    out.write(`  ${green("✓")} Model ${bold2(WHISPER_MODEL)} ${dim2("ready")}
+`);
+  }
+  out.write(`
+`);
+  if (!deps.sox || !deps.whisper) {
+    out.write(`  ${dim2("Install the missing dependencies above, then try again.")}
+
+`);
+  }
+}
+function detectPackageManager() {
+  if (platform() === "darwin") {
+    return commandExists("brew") ? "brew" : null;
+  }
+  if (commandExists("apt-get"))
+    return "apt";
+  if (commandExists("dnf"))
+    return "dnf";
+  if (commandExists("pacman"))
+    return "pacman";
+  return null;
+}
+function installSox(pm) {
+  try {
+    switch (pm) {
+      case "brew":
+        execSync9("brew install sox", { stdio: "inherit", timeout: 300000 });
+        break;
+      case "apt":
+        execSync9("sudo apt-get install -y sox", {
+          stdio: "inherit",
+          timeout: 300000
+        });
+        break;
+      case "dnf":
+        execSync9("sudo dnf install -y sox", {
+          stdio: "inherit",
+          timeout: 300000
+        });
+        break;
+      case "pacman":
+        execSync9("sudo pacman -S --noconfirm sox", {
+          stdio: "inherit",
+          timeout: 300000
+        });
+        break;
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+function installWhisperCpp(pm) {
+  if (pm === "brew") {
+    try {
+      execSync9("brew install whisper-cpp", {
+        stdio: "inherit",
+        timeout: 300000
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  return buildWhisperFromSource(pm);
+}
+function ensureBuildDeps(pm) {
+  const hasCmake = commandExists("cmake");
+  const hasCxx = commandExists("g++") || commandExists("c++");
+  const hasGit = commandExists("git");
+  if (hasCmake && hasCxx && hasGit)
+    return true;
+  process.stderr.write(`  ${dim2("Installing build tools...")}
+`);
+  try {
+    switch (pm) {
+      case "apt":
+        execSync9("sudo apt-get install -y cmake g++ make git", {
+          stdio: "inherit",
+          timeout: 300000
+        });
+        break;
+      case "dnf":
+        execSync9("sudo dnf install -y cmake gcc-c++ make git", {
+          stdio: "inherit",
+          timeout: 300000
+        });
+        break;
+      case "pacman":
+        execSync9("sudo pacman -S --noconfirm cmake gcc make git", {
+          stdio: "inherit",
+          timeout: 300000
+        });
+        break;
+      default:
+        return false;
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+function buildWhisperFromSource(pm) {
+  const out = process.stderr;
+  const buildDir = join17(tmpdir4(), `locus-whisper-build-${process.pid}`);
+  if (!ensureBuildDeps(pm)) {
+    out.write(`  ${red2("✗")} Could not install build tools (cmake, g++, git).
+`);
+    return false;
+  }
+  try {
+    mkdirSync12(buildDir, { recursive: true });
+    mkdirSync12(LOCUS_BIN_DIR, { recursive: true });
+    out.write(`  ${dim2("Cloning whisper.cpp...")}
+`);
+    execSync9(`git clone --depth 1 https://github.com/ggerganov/whisper.cpp.git "${join17(buildDir, "whisper.cpp")}"`, { stdio: ["pipe", "pipe", "pipe"], timeout: 120000 });
+    const srcDir = join17(buildDir, "whisper.cpp");
+    const numCpus = cpus().length || 2;
+    out.write(`  ${dim2("Building whisper.cpp (this may take a few minutes)...")}
+`);
+    execSync9("cmake -B build -DCMAKE_BUILD_TYPE=Release", {
+      cwd: srcDir,
+      stdio: ["pipe", "pipe", "pipe"],
+      timeout: 120000
+    });
+    execSync9(`cmake --build build --config Release -j${numCpus}`, {
+      cwd: srcDir,
+      stdio: ["pipe", "pipe", "pipe"],
+      timeout: 600000
+    });
+    const destPath = join17(LOCUS_BIN_DIR, "whisper-cli");
+    const binaryCandidates = [
+      join17(srcDir, "build", "bin", "whisper-cli"),
+      join17(srcDir, "build", "bin", "main")
+    ];
+    for (const candidate of binaryCandidates) {
+      if (existsSync17(candidate)) {
+        execSync9(`cp "${candidate}" "${destPath}" && chmod +x "${destPath}"`, {
+          stdio: "pipe"
+        });
+        return true;
+      }
+    }
+    out.write(`  ${red2("✗")} Build completed but whisper-cli binary not found.
+`);
+    return false;
+  } catch (e) {
+    out.write(`  ${red2("✗")} Build failed: ${e instanceof Error ? e.message : String(e)}
+`);
+    return false;
+  } finally {
+    try {
+      execSync9(`rm -rf "${buildDir}"`, { stdio: "pipe" });
+    } catch {}
+  }
+}
+function autoInstallDependencies(deps) {
+  if (platform() === "win32") {
+    process.stderr.write(`
+${red2("✗")} Voice input is not supported on Windows.
+
+`);
+    return false;
+  }
+  const pm = detectPackageManager();
+  if (!pm) {
+    process.stderr.write(`
+${red2("✗")} No supported package manager found.
+`);
+    if (platform() === "darwin") {
+      process.stderr.write(`  Install Homebrew first: ${cyan2("https://brew.sh")}
+`);
+    }
+    process.stderr.write(`
+`);
+    return false;
+  }
+  const out = process.stderr;
+  out.write(`
+${bold2("Installing voice dependencies...")}
+
+`);
+  if (!deps.sox) {
+    out.write(`  ${dim2("Installing")} ${bold2("sox")} ${dim2("(audio recording)...")}
+`);
+    if (!installSox(pm)) {
+      out.write(`  ${red2("✗")} Failed to install sox.
+
+`);
+      return false;
+    }
+    out.write(`  ${green("✓")} sox installed
+
+`);
+  }
+  if (!deps.whisper) {
+    out.write(`  ${dim2("Installing")} ${bold2("whisper.cpp")} ${dim2("(speech-to-text)...")}
+`);
+    if (!installWhisperCpp(pm)) {
+      out.write(`  ${red2("✗")} Failed to install whisper.cpp.
+
+`);
+      return false;
+    }
+    out.write(`  ${green("✓")} whisper.cpp installed
+
+`);
+  }
+  out.write(`${green("✓")} Voice dependencies ready.
+
+`);
+  return true;
+}
+function downloadModel() {
+  const modelPath = getWhisperModelPath();
+  if (existsSync17(modelPath))
+    return true;
+  mkdirSync12(WHISPER_MODELS_DIR, { recursive: true });
+  const url = `https://huggingface.co/ggerganov/whisper.cpp/resolve/main/${WHISPER_MODEL === "base.en" ? "ggml-base.en.bin" : `ggml-${WHISPER_MODEL}.bin`}`;
+  process.stderr.write(`${dim2("Downloading whisper model")} ${bold2(WHISPER_MODEL)} ${dim2("(~150MB)...")}
+`);
+  try {
+    if (commandExists("curl")) {
+      execSync9(`curl -L -o "${modelPath}" "${url}"`, {
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 300000
+      });
+    } else if (commandExists("wget")) {
+      execSync9(`wget -O "${modelPath}" "${url}"`, {
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 300000
+      });
+    } else {
+      process.stderr.write(`${red2("✗")} Neither curl nor wget found. Download the model manually:
+`);
+      process.stderr.write(`    ${cyan2(url)}
+`);
+      process.stderr.write(`    Save to: ${dim2(modelPath)}
+`);
+      return false;
+    }
+    process.stderr.write(`${green("✓")} Model downloaded to ${dim2(modelPath)}
+`);
+    return true;
+  } catch (e) {
+    process.stderr.write(`${red2("✗")} Failed to download model: ${e instanceof Error ? e.message : String(e)}
+`);
+    try {
+      unlinkSync4(modelPath);
+    } catch {}
+    return false;
+  }
+}
+
+class VoiceController {
+  state = "idle";
+  recordProcess = null;
+  tempFile;
+  deps;
+  onStateChange;
+  constructor(options) {
+    this.onStateChange = options.onStateChange;
+    this.tempFile = join17(tmpdir4(), `locus-voice-${process.pid}.wav`);
+    this.deps = checkDependencies();
+  }
+  getState() {
+    return this.state;
+  }
+  startRecording() {
+    if (this.state !== "idle")
+      return false;
+    this.deps = checkDependencies();
+    if (!this.deps.sox || !this.deps.whisper) {
+      if (!autoInstallDependencies(this.deps)) {
+        return false;
+      }
+      this.deps = checkDependencies();
+      if (!this.deps.sox || !this.deps.whisper) {
+        printDependencyHelp(this.deps);
+        return false;
+      }
+    }
+    if (!this.deps.modelDownloaded) {
+      if (!downloadModel()) {
+        return false;
+      }
+      this.deps.modelDownloaded = true;
+    }
+    const args = this.buildRecordArgs();
+    if (!args)
+      return false;
+    const binary = this.deps.soxBinary;
+    if (!binary) {
+      process.stderr.write(`${red2("✗")} sox binary not found. Please install sox and try again.
+`);
+      return false;
+    }
+    const spawnArgs = binary === "rec" ? args : ["-d", ...args];
+    this.recordProcess = spawn6(binary, spawnArgs, {
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    this.recordProcess.on("error", (err) => {
+      process.stderr.write(`\r
+${red2("✗")} Recording failed: ${err.message}\r
+`);
+      this.setState("idle");
+    });
+    this.setState("recording");
+    return true;
+  }
+  buildRecordArgs() {
+    return [
+      "-r",
+      "16000",
+      "-c",
+      "1",
+      "-b",
+      "16",
+      this.tempFile
+    ];
+  }
+  async stopAndTranscribe() {
+    if (!this.recordProcess) {
+      this.setState("idle");
+      return null;
+    }
+    this.recordProcess.kill("SIGTERM");
+    this.recordProcess = null;
+    this.setState("idle");
+    await sleep2(200);
+    if (!existsSync17(this.tempFile)) {
+      return null;
+    }
+    try {
+      const text = await this.transcribe();
+      return text || null;
+    } catch (e) {
+      process.stderr.write(`${red2("✗")} Transcription failed: ${e instanceof Error ? e.message : String(e)}
+`);
+      return null;
+    } finally {
+      try {
+        unlinkSync4(this.tempFile);
+      } catch {}
+    }
+  }
+  transcribe() {
+    return new Promise((resolve2, reject) => {
+      const binary = this.deps.whisperBinary;
+      if (!binary) {
+        process.stderr.write(`${red2("✗")} whisper.cpp binary not found. Please install whisper.cpp and try again.
+`);
+        reject(new Error("whisper.cpp binary not found. Please install whisper.cpp and try again."));
+        return;
+      }
+      const modelPath = getWhisperModelPath();
+      const args = [
+        "-m",
+        modelPath,
+        "-f",
+        this.tempFile,
+        "--no-timestamps",
+        "--language",
+        WHISPER_MODEL.endsWith(".en") ? "en" : "auto"
+      ];
+      const proc = spawn6(binary, args, {
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      let stdout = "";
+      let stderr = "";
+      proc.stdout?.on("data", (data) => {
+        stdout += data.toString();
+      });
+      proc.stderr?.on("data", (data) => {
+        stderr += data.toString();
+      });
+      proc.on("error", (err) => {
+        reject(new Error(`whisper.cpp failed to start: ${err.message}`));
+      });
+      proc.on("close", (code) => {
+        if (code !== 0) {
+          reject(new Error(`whisper.cpp exited with code ${code}: ${stderr.trim()}`));
+          return;
+        }
+        const text = stdout.split(`
+`).map((line) => line.replace(/^\[.*?\]\s*/, "").trim()).filter((line) => line.length > 0).join(" ").trim();
+        resolve2(text);
+      });
+    });
+  }
+  cancel() {
+    if (this.recordProcess) {
+      this.recordProcess.kill("SIGKILL");
+      this.recordProcess = null;
+    }
+    try {
+      unlinkSync4(this.tempFile);
+    } catch {}
+    this.setState("idle");
+  }
+  setState(state) {
+    this.state = state;
+    this.onStateChange(state);
+  }
+}
+function voiceStatusIndicator(state) {
+  switch (state) {
+    case "recording":
+      return `${red2(bold2("[REC]"))} `;
+    case "transcribing":
+      return ` ${yellow2("[...]")} `;
+    default:
+      return "";
+  }
+}
+function sleep2(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
+}
+var WHISPER_MODEL = "base.en", WHISPER_MODELS_DIR, LOCUS_BIN_DIR;
+var init_voice = __esm(() => {
+  init_terminal();
+  WHISPER_MODELS_DIR = join17(homedir4(), ".locus", "whisper-models");
+  LOCUS_BIN_DIR = join17(homedir4(), ".locus", "bin");
+});
+
 // src/repl/repl.ts
-import { execSync as execSync9 } from "node:child_process";
+import { execSync as execSync10 } from "node:child_process";
 async function startRepl(options) {
   const { projectRoot, config } = options;
   const sessionManager = new SessionManager(projectRoot);
@@ -8129,7 +8699,7 @@ async function startRepl(options) {
   } else {
     let branch = "main";
     try {
-      branch = execSync9("git rev-parse --abbrev-ref HEAD", {
+      branch = execSync10("git rev-parse --abbrev-ref HEAD", {
         cwd: projectRoot,
         encoding: "utf-8",
         stdio: ["pipe", "pipe", "pipe"]
@@ -8195,8 +8765,15 @@ async function runInteractiveRepl(session, sessionManager, options) {
     new SlashCommandCompletion(getAllCommandNames()),
     new FilePathCompletion(projectRoot)
   ]);
+  const basePrompt = `${cyan2("locus")} ${dim2(">")} `;
+  const voice = new VoiceController({
+    onStateChange: (state) => {
+      const indicator = voiceStatusIndicator(state);
+      input.setPrompt(indicator ? `${indicator}${basePrompt}` : basePrompt);
+    }
+  });
   const input = new InputHandler({
-    prompt: `${cyan2("locus")} ${dim2(">")} `,
+    prompt: basePrompt,
     getHistory: () => history.getEntries(),
     onTab: (text) => completion.complete(text)
   });
@@ -8249,12 +8826,33 @@ async function runInteractiveRepl(session, sessionManager, options) {
     onVerboseToggle: () => {
       verbose = !verbose;
     },
-    getVerbose: () => verbose
+    getVerbose: () => verbose,
+    onVoiceToggle: () => {
+      if (voice.getState() !== "idle")
+        return;
+      const started = voice.startRecording();
+      if (started) {
+        process.stderr.write(`${dim2("Recording... press")} ${bold2("Enter")} ${dim2("to stop")}
+`);
+      }
+    }
   };
   while (!shouldExit) {
     const result = await input.readline();
     switch (result.type) {
       case "submit": {
+        if (voice.getState() === "recording") {
+          process.stderr.write(`${dim2("Transcribing...")}
+`);
+          const transcribed = await voice.stopAndTranscribe();
+          if (transcribed) {
+            input.setInitialBuffer(transcribed);
+          } else {
+            process.stderr.write(`${yellow2("!")} No speech detected.
+`);
+          }
+          continue;
+        }
         const text = result.text.trim();
         if (!text)
           continue;
@@ -8305,6 +8903,7 @@ ${red2("✗")} ${msg}
         break;
     }
   }
+  voice.cancel();
   const shouldPersistOnExit = session.messages.length > 0 || sessionManager.isPersisted(session);
   if (shouldPersistOnExit) {
     sessionManager.save(session);
@@ -8370,7 +8969,7 @@ function printWelcome(session) {
   }
   process.stderr.write(`
 `);
-  process.stderr.write(`  ${dim2("Type /help for commands, Shift+Enter for newline, Ctrl+C twice to exit")}
+  process.stderr.write(`  ${dim2("Type /help for commands, Shift+Enter for newline, /v for voice input")}
 `);
   process.stderr.write(`
 `);
@@ -8390,6 +8989,7 @@ var init_repl = __esm(() => {
   init_input_history();
   init_model_config();
   init_session_manager();
+  init_voice();
   LOCUS_LOGO = [
     "      ▄█                 ",
     "  ▄▄████▄▄▄▄             ",
@@ -8587,11 +9187,11 @@ var init_exec = __esm(() => {
 });
 
 // src/core/submodule.ts
-import { execSync as execSync10 } from "node:child_process";
-import { existsSync as existsSync17 } from "node:fs";
-import { join as join17 } from "node:path";
+import { execSync as execSync11 } from "node:child_process";
+import { existsSync as existsSync18 } from "node:fs";
+import { join as join18 } from "node:path";
 function git2(args, cwd) {
-  return execSync10(`git ${args}`, {
+  return execSync11(`git ${args}`, {
     cwd,
     encoding: "utf-8",
     stdio: ["pipe", "pipe", "pipe"]
@@ -8605,7 +9205,7 @@ function gitSafe(args, cwd) {
   }
 }
 function hasSubmodules(cwd) {
-  return existsSync17(join17(cwd, ".gitmodules"));
+  return existsSync18(join18(cwd, ".gitmodules"));
 }
 function listSubmodules(cwd) {
   if (!hasSubmodules(cwd))
@@ -8625,7 +9225,7 @@ function listSubmodules(cwd) {
         continue;
       submodules.push({
         path,
-        absolutePath: join17(cwd, path),
+        absolutePath: join18(cwd, path),
         dirty
       });
     }
@@ -8638,7 +9238,7 @@ function getDirtySubmodules(cwd) {
   const submodules = listSubmodules(cwd);
   const dirty = [];
   for (const sub of submodules) {
-    if (!existsSync17(sub.absolutePath))
+    if (!existsSync18(sub.absolutePath))
       continue;
     const status = gitSafe("status --porcelain", sub.absolutePath);
     if (status && status.trim().length > 0) {
@@ -8659,7 +9259,7 @@ function commitDirtySubmodules(cwd, issueNumber, issueTitle) {
       const message = `chore: complete #${issueNumber} - ${issueTitle}
 
 Co-Authored-By: LocusAgent <agent@locusai.team>`;
-      execSync10("git commit -F -", {
+      execSync11("git commit -F -", {
         input: message,
         cwd: sub.absolutePath,
         encoding: "utf-8",
@@ -8725,7 +9325,7 @@ function pushSubmoduleBranches(cwd) {
   const log = getLogger();
   const submodules = listSubmodules(cwd);
   for (const sub of submodules) {
-    if (!existsSync17(sub.absolutePath))
+    if (!existsSync18(sub.absolutePath))
       continue;
     const branch = gitSafe("rev-parse --abbrev-ref HEAD", sub.absolutePath)?.trim();
     if (!branch || branch === "HEAD")
@@ -8746,7 +9346,7 @@ var init_submodule = __esm(() => {
 });
 
 // src/core/agent.ts
-import { execSync as execSync11 } from "node:child_process";
+import { execSync as execSync12 } from "node:child_process";
 async function executeIssue(projectRoot, options) {
   const log = getLogger();
   const timer = createTimer();
@@ -8775,7 +9375,7 @@ ${cyan2("●")} ${bold2(`#${issueNumber}`)} ${issue.title}
   }
   let issueComments = [];
   try {
-    const commentsRaw = execSync11(`gh issue view ${issueNumber} --json comments --jq '.comments[].body'`, { cwd: projectRoot, encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+    const commentsRaw = execSync12(`gh issue view ${issueNumber} --json comments --jq '.comments[].body'`, { cwd: projectRoot, encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
     if (commentsRaw) {
       issueComments = commentsRaw.split(`
 `).filter(Boolean);
@@ -8939,12 +9539,12 @@ ${aiResult.success ? green("✓") : red2("✗")} Iteration ${aiResult.success ?
 }
 async function createIssuePR(projectRoot, config, issue) {
   try {
-    const currentBranch = execSync11("git rev-parse --abbrev-ref HEAD", {
+    const currentBranch = execSync12("git rev-parse --abbrev-ref HEAD", {
       cwd: projectRoot,
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     }).trim();
-    const diff = execSync11(`git diff origin/${config.agent.baseBranch}..HEAD --stat`, {
+    const diff = execSync12(`git diff origin/${config.agent.baseBranch}..HEAD --stat`, {
       cwd: projectRoot,
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
@@ -8954,7 +9554,7 @@ async function createIssuePR(projectRoot, config, issue) {
       return;
     }
     pushSubmoduleBranches(projectRoot);
-    execSync11(`git push -u origin ${currentBranch}`, {
+    execSync12(`git push -u origin ${currentBranch}`, {
       cwd: projectRoot,
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
@@ -9009,9 +9609,9 @@ var init_agent = __esm(() => {
 });
 
 // src/core/conflict.ts
-import { execSync as execSync12 } from "node:child_process";
+import { execSync as execSync13 } from "node:child_process";
 function git3(args, cwd) {
-  return execSync12(`git ${args}`, {
+  return execSync13(`git ${args}`, {
     cwd,
     encoding: "utf-8",
     stdio: ["pipe", "pipe", "pipe"]
@@ -9140,19 +9740,19 @@ var init_conflict = __esm(() => {
 
 // src/core/run-state.ts
 import {
-  existsSync as existsSync18,
-  mkdirSync as mkdirSync12,
+  existsSync as existsSync19,
+  mkdirSync as mkdirSync13,
   readFileSync as readFileSync12,
-  unlinkSync as unlinkSync4,
+  unlinkSync as unlinkSync5,
   writeFileSync as writeFileSync8
 } from "node:fs";
-import { dirname as dirname6, join as join18 } from "node:path";
+import { dirname as dirname6, join as join19 } from "node:path";
 function getRunStatePath(projectRoot) {
-  return join18(projectRoot, ".locus", "run-state.json");
+  return join19(projectRoot, ".locus", "run-state.json");
 }
 function loadRunState(projectRoot) {
   const path = getRunStatePath(projectRoot);
-  if (!existsSync18(path))
+  if (!existsSync19(path))
     return null;
   try {
     return JSON.parse(readFileSync12(path, "utf-8"));
@@ -9164,16 +9764,16 @@ function loadRunState(projectRoot) {
 function saveRunState(projectRoot, state) {
   const path = getRunStatePath(projectRoot);
   const dir = dirname6(path);
-  if (!existsSync18(dir)) {
-    mkdirSync12(dir, { recursive: true });
+  if (!existsSync19(dir)) {
+    mkdirSync13(dir, { recursive: true });
   }
   writeFileSync8(path, `${JSON.stringify(state, null, 2)}
 `, "utf-8");
 }
 function clearRunState(projectRoot) {
   const path = getRunStatePath(projectRoot);
-  if (existsSync18(path)) {
-    unlinkSync4(path);
+  if (existsSync19(path)) {
+    unlinkSync5(path);
   }
 }
 function createSprintRunState(sprint, branch, issues) {
@@ -9312,11 +9912,11 @@ var init_shutdown = __esm(() => {
 });
 
 // src/core/worktree.ts
-import { execSync as execSync13 } from "node:child_process";
-import { existsSync as existsSync19, readdirSync as readdirSync7, realpathSync, statSync as statSync4 } from "node:fs";
-import { join as join19 } from "node:path";
+import { execSync as execSync14 } from "node:child_process";
+import { existsSync as existsSync20, readdirSync as readdirSync7, realpathSync, statSync as statSync4 } from "node:fs";
+import { join as join20 } from "node:path";
 function git4(args, cwd) {
-  return execSync13(`git ${args}`, {
+  return execSync14(`git ${args}`, {
     cwd,
     encoding: "utf-8",
     stdio: ["pipe", "pipe", "pipe"]
@@ -9330,10 +9930,10 @@ function gitSafe3(args, cwd) {
   }
 }
 function getWorktreeDir(projectRoot) {
-  return join19(projectRoot, ".locus", "worktrees");
+  return join20(projectRoot, ".locus", "worktrees");
 }
 function getWorktreePath(projectRoot, issueNumber) {
-  return join19(getWorktreeDir(projectRoot), `issue-${issueNumber}`);
+  return join20(getWorktreeDir(projectRoot), `issue-${issueNumber}`);
 }
 function generateBranchName(issueNumber) {
   const randomSuffix = Math.random().toString(36).slice(2, 8);
@@ -9341,7 +9941,7 @@ function generateBranchName(issueNumber) {
 }
 function getWorktreeBranch(worktreePath) {
   try {
-    return execSync13("git branch --show-current", {
+    return execSync14("git branch --show-current", {
       cwd: worktreePath,
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
@@ -9353,7 +9953,7 @@ function getWorktreeBranch(worktreePath) {
 function createWorktree(projectRoot, issueNumber, baseBranch) {
   const log = getLogger();
   const worktreePath = getWorktreePath(projectRoot, issueNumber);
-  if (existsSync19(worktreePath)) {
+  if (existsSync20(worktreePath)) {
     log.verbose(`Worktree already exists for issue #${issueNumber}`);
     const existingBranch = getWorktreeBranch(worktreePath) ?? `locus/issue-${issueNumber}`;
     return {
@@ -9381,7 +9981,7 @@ function createWorktree(projectRoot, issueNumber, baseBranch) {
 function removeWorktree(projectRoot, issueNumber) {
   const log = getLogger();
   const worktreePath = getWorktreePath(projectRoot, issueNumber);
-  if (!existsSync19(worktreePath)) {
+  if (!existsSync20(worktreePath)) {
     log.verbose(`Worktree for issue #${issueNumber} does not exist`);
     return;
   }
@@ -9400,7 +10000,7 @@ function removeWorktree(projectRoot, issueNumber) {
 function listWorktrees(projectRoot) {
   const log = getLogger();
   const worktreeDir = getWorktreeDir(projectRoot);
-  if (!existsSync19(worktreeDir)) {
+  if (!existsSync20(worktreeDir)) {
     return [];
   }
   const entries = readdirSync7(worktreeDir).filter((entry) => entry.startsWith("issue-"));
@@ -9420,7 +10020,7 @@ function listWorktrees(projectRoot) {
     if (!match)
       continue;
     const issueNumber = Number.parseInt(match[1], 10);
-    const path = join19(worktreeDir, entry);
+    const path = join20(worktreeDir, entry);
     const branch = getWorktreeBranch(path) ?? `locus/issue-${issueNumber}`;
     let resolvedPath;
     try {
@@ -9468,7 +10068,7 @@ var exports_run = {};
 __export(exports_run, {
   runCommand: () => runCommand
 });
-import { execSync as execSync14 } from "node:child_process";
+import { execSync as execSync15 } from "node:child_process";
 function resolveExecutionContext(config, modelOverride) {
   const model = modelOverride ?? config.ai.model;
   const provider = inferProviderFromModel(model) ?? config.ai.provider;
@@ -9628,7 +10228,7 @@ ${yellow2("⚠")} A sprint run is already in progress.
   }
   if (!flags.dryRun) {
     try {
-      execSync14(`git checkout -B ${branchName}`, {
+      execSync15(`git checkout -B ${branchName}`, {
         cwd: projectRoot,
         encoding: "utf-8",
         stdio: ["pipe", "pipe", "pipe"]
@@ -9678,7 +10278,7 @@ ${red2("✗")} Auto-rebase failed. Resolve manually.
     let sprintContext;
     if (i > 0 && !flags.dryRun) {
       try {
-        sprintContext = execSync14(`git diff origin/${config.agent.baseBranch}..HEAD`, {
+        sprintContext = execSync15(`git diff origin/${config.agent.baseBranch}..HEAD`, {
           cwd: projectRoot,
           encoding: "utf-8",
           stdio: ["pipe", "pipe", "pipe"]
@@ -9743,7 +10343,7 @@ ${bold2("Summary:")}
     const prNumber = await createSprintPR(projectRoot, config, sprintName, branchName, completedTasks);
     if (prNumber !== undefined) {
       try {
-        execSync14(`git checkout ${config.agent.baseBranch}`, {
+        execSync15(`git checkout ${config.agent.baseBranch}`, {
           cwd: projectRoot,
           encoding: "utf-8",
           stdio: ["pipe", "pipe", "pipe"]
@@ -9788,7 +10388,7 @@ ${bold2("Running issue")} ${cyan2(`#${issueNumber}`)} ${dim2(`(branch: ${branchN
 `);
   if (!flags.dryRun) {
     try {
-      execSync14(`git checkout -B ${branchName} ${config.agent.baseBranch}`, {
+      execSync15(`git checkout -B ${branchName} ${config.agent.baseBranch}`, {
         cwd: projectRoot,
         encoding: "utf-8",
         stdio: ["pipe", "pipe", "pipe"]
@@ -9813,7 +10413,7 @@ ${bold2("Running issue")} ${cyan2(`#${issueNumber}`)} ${dim2(`(branch: ${branchN
   if (!flags.dryRun) {
     if (result.success) {
       try {
-        execSync14(`git checkout ${config.agent.baseBranch}`, {
+        execSync15(`git checkout ${config.agent.baseBranch}`, {
           cwd: projectRoot,
           encoding: "utf-8",
           stdio: ["pipe", "pipe", "pipe"]
@@ -9950,13 +10550,13 @@ ${bold2("Resuming")} ${state.type} run ${dim2(state.runId)}
 `);
   if (state.type === "sprint" && state.branch) {
     try {
-      const currentBranch = execSync14("git rev-parse --abbrev-ref HEAD", {
+      const currentBranch = execSync15("git rev-parse --abbrev-ref HEAD", {
         cwd: projectRoot,
         encoding: "utf-8",
         stdio: ["pipe", "pipe", "pipe"]
       }).trim();
       if (currentBranch !== state.branch) {
-        execSync14(`git checkout ${state.branch}`, {
+        execSync15(`git checkout ${state.branch}`, {
           cwd: projectRoot,
           encoding: "utf-8",
           stdio: ["pipe", "pipe", "pipe"]
@@ -10023,7 +10623,7 @@ ${bold2("Resume complete:")} ${green(`✓ ${finalStats.done}`)} ${finalStats.fai
     const prNumber = await createSprintPR(projectRoot, config, state.sprint, state.branch, completedTasks);
     if (prNumber !== undefined) {
       try {
-        execSync14(`git checkout ${config.agent.baseBranch}`, {
+        execSync15(`git checkout ${config.agent.baseBranch}`, {
           cwd: projectRoot,
           encoding: "utf-8",
           stdio: ["pipe", "pipe", "pipe"]
@@ -10059,14 +10659,14 @@ function ensureTaskCommit(projectRoot, issueNumber, issueTitle) {
       process.stderr.write(`  ${dim2(`Committed submodule changes: ${committedSubmodules.join(", ")}`)}
 `);
     }
-    const status = execSync14("git status --porcelain", {
+    const status = execSync15("git status --porcelain", {
       cwd: projectRoot,
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     }).trim();
     if (!status)
       return;
-    execSync14("git add -A", {
+    execSync15("git add -A", {
       cwd: projectRoot,
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
@@ -10074,7 +10674,7 @@ function ensureTaskCommit(projectRoot, issueNumber, issueTitle) {
     const message = `chore: complete #${issueNumber} - ${issueTitle}
 
 Co-Authored-By: LocusAgent <agent@locusai.team>`;
-    execSync14(`git commit -F -`, {
+    execSync15(`git commit -F -`, {
       input: message,
       cwd: projectRoot,
       encoding: "utf-8",
@@ -10088,7 +10688,7 @@ async function createSprintPR(projectRoot, config, sprintName, branchName, tasks
   if (!config.agent.autoPR)
     return;
   try {
-    const diff = execSync14(`git diff origin/${config.agent.baseBranch}..HEAD --stat`, {
+    const diff = execSync15(`git diff origin/${config.agent.baseBranch}..HEAD --stat`, {
       cwd: projectRoot,
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
@@ -10099,7 +10699,7 @@ async function createSprintPR(projectRoot, config, sprintName, branchName, tasks
       return;
     }
     pushSubmoduleBranches(projectRoot);
-    execSync14(`git push -u origin ${branchName}`, {
+    execSync15(`git push -u origin ${branchName}`, {
       cwd: projectRoot,
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
@@ -10257,13 +10857,13 @@ __export(exports_plan, {
   parsePlanArgs: () => parsePlanArgs
 });
 import {
-  existsSync as existsSync20,
-  mkdirSync as mkdirSync13,
+  existsSync as existsSync21,
+  mkdirSync as mkdirSync14,
   readdirSync as readdirSync8,
   readFileSync as readFileSync13,
   writeFileSync as writeFileSync9
 } from "node:fs";
-import { join as join20 } from "node:path";
+import { join as join21 } from "node:path";
 function printHelp() {
   process.stderr.write(`
 ${bold2("locus plan")} — AI-powered sprint planning
@@ -10294,12 +10894,12 @@ function normalizeSprintName(name) {
   return name.trim().toLowerCase();
 }
 function getPlansDir(projectRoot) {
-  return join20(projectRoot, ".locus", "plans");
+  return join21(projectRoot, ".locus", "plans");
 }
 function ensurePlansDir(projectRoot) {
   const dir = getPlansDir(projectRoot);
-  if (!existsSync20(dir)) {
-    mkdirSync13(dir, { recursive: true });
+  if (!existsSync21(dir)) {
+    mkdirSync14(dir, { recursive: true });
   }
   return dir;
 }
@@ -10308,14 +10908,14 @@ function generateId() {
 }
 function loadPlanFile(projectRoot, id) {
   const dir = getPlansDir(projectRoot);
-  if (!existsSync20(dir))
+  if (!existsSync21(dir))
     return null;
   const files = readdirSync8(dir).filter((f) => f.endsWith(".json"));
   const match = files.find((f) => f.startsWith(id));
   if (!match)
     return null;
   try {
-    const content = readFileSync13(join20(dir, match), "utf-8");
+    const content = readFileSync13(join21(dir, match), "utf-8");
     return JSON.parse(content);
   } catch {
     return null;
@@ -10361,7 +10961,7 @@ async function planCommand(projectRoot, args, flags = {}) {
 }
 function handleListPlans(projectRoot) {
   const dir = getPlansDir(projectRoot);
-  if (!existsSync20(dir)) {
+  if (!existsSync21(dir)) {
     process.stderr.write(`${dim2("No saved plans yet.")}
 `);
     return;
@@ -10379,7 +10979,7 @@ ${bold2("Saved Plans:")}
   for (const file of files) {
     const id = file.replace(".json", "");
     try {
-      const content = readFileSync13(join20(dir, file), "utf-8");
+      const content = readFileSync13(join21(dir, file), "utf-8");
       const plan = JSON.parse(content);
       const date = plan.createdAt ? plan.createdAt.slice(0, 10) : "";
       const issueCount = Array.isArray(plan.issues) ? plan.issues.length : 0;
@@ -10490,7 +11090,7 @@ ${bold2("Approving plan:")}
 async function handleAIPlan(projectRoot, config, directive, sprintName, flags) {
   const id = generateId();
   const plansDir = ensurePlansDir(projectRoot);
-  const planPath = join20(plansDir, `${id}.json`);
+  const planPath = join21(plansDir, `${id}.json`);
   const planPathRelative = `.locus/plans/${id}.json`;
   const displayDirective = directive;
   process.stderr.write(`
@@ -10532,7 +11132,7 @@ ${red2("✗")} Planning failed: ${aiResult.error}
 `);
     return;
   }
-  if (!existsSync20(planPath)) {
+  if (!existsSync21(planPath)) {
     process.stderr.write(`
 ${yellow2("⚠")} Plan file was not created at ${bold2(planPathRelative)}.
 `);
@@ -10713,15 +11313,15 @@ ${directive}${sprintName ? `
 
 **Sprint:** ${sprintName}` : ""}
 </directive>`);
-  const locusPath = join20(projectRoot, ".locus", "LOCUS.md");
-  if (existsSync20(locusPath)) {
+  const locusPath = join21(projectRoot, ".locus", "LOCUS.md");
+  if (existsSync21(locusPath)) {
     const content = readFileSync13(locusPath, "utf-8");
     parts.push(`<project-context>
 ${content.slice(0, 3000)}
 </project-context>`);
   }
-  const learningsPath = join20(projectRoot, ".locus", "LEARNINGS.md");
-  if (existsSync20(learningsPath)) {
+  const learningsPath = join21(projectRoot, ".locus", "LEARNINGS.md");
+  if (existsSync21(learningsPath)) {
     const content = readFileSync13(learningsPath, "utf-8");
     parts.push(`<past-learnings>
 ${content.slice(0, 2000)}
@@ -10901,9 +11501,9 @@ var exports_review = {};
 __export(exports_review, {
   reviewCommand: () => reviewCommand
 });
-import { execFileSync as execFileSync2, execSync as execSync15 } from "node:child_process";
-import { existsSync as existsSync21, readFileSync as readFileSync14 } from "node:fs";
-import { join as join21 } from "node:path";
+import { execFileSync as execFileSync2, execSync as execSync16 } from "node:child_process";
+import { existsSync as existsSync22, readFileSync as readFileSync14 } from "node:fs";
+import { join as join22 } from "node:path";
 function printHelp2() {
   process.stderr.write(`
 ${bold2("locus review")} — AI-powered code review
@@ -10987,7 +11587,7 @@ ${bold2("Review complete:")} ${green(`✓ ${reviewed}`)}${failed > 0 ? ` ${red2(
 async function reviewSinglePR(projectRoot, config, prNumber, focus, flags) {
   let prInfo;
   try {
-    const result = execSync15(`gh pr view ${prNumber} --json number,title,body,state,headRefName,baseRefName,labels,url,createdAt`, { cwd: projectRoot, encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+    const result = execSync16(`gh pr view ${prNumber} --json number,title,body,state,headRefName,baseRefName,labels,url,createdAt`, { cwd: projectRoot, encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
     const raw = JSON.parse(result);
     prInfo = {
       number: raw.number,
@@ -11071,8 +11671,8 @@ function buildReviewPrompt(projectRoot, config, pr, diff, focus) {
   parts.push(`<role>
 You are an expert code reviewer for the ${config.github.owner}/${config.github.repo} repository.
 </role>`);
-  const locusPath = join21(projectRoot, ".locus", "LOCUS.md");
-  if (existsSync21(locusPath)) {
+  const locusPath = join22(projectRoot, ".locus", "LOCUS.md");
+  if (existsSync22(locusPath)) {
     const content = readFileSync14(locusPath, "utf-8");
     parts.push(`<project-context>
 ${content.slice(0, 2000)}
@@ -11134,7 +11734,7 @@ var exports_iterate = {};
 __export(exports_iterate, {
   iterateCommand: () => iterateCommand
 });
-import { execSync as execSync16 } from "node:child_process";
+import { execSync as execSync17 } from "node:child_process";
 function printHelp3() {
   process.stderr.write(`
 ${bold2("locus iterate")} — Re-execute tasks with PR feedback
@@ -11352,12 +11952,12 @@ ${bold2("Summary:")} ${green(`✓ ${succeeded}`)}${failed > 0 ? ` ${red2(`✗ ${
 }
 function findPRForIssue(projectRoot, issueNumber) {
   try {
-    const result = execSync16(`gh pr list --search "Closes #${issueNumber}" --json number --state open`, { cwd: projectRoot, encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+    const result = execSync17(`gh pr list --search "Closes #${issueNumber}" --json number --state open`, { cwd: projectRoot, encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
     const parsed = JSON.parse(result);
     if (parsed.length > 0) {
       return parsed[0].number;
     }
-    const branchResult = execSync16(`gh pr list --head "locus/issue-${issueNumber}" --json number --state open`, { cwd: projectRoot, encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+    const branchResult = execSync17(`gh pr list --head "locus/issue-${issueNumber}" --json number --state open`, { cwd: projectRoot, encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
     const branchParsed = JSON.parse(branchResult);
     if (branchParsed.length > 0) {
       return branchParsed[0].number;
@@ -11393,14 +11993,14 @@ __export(exports_discuss, {
   discussCommand: () => discussCommand
 });
 import {
-  existsSync as existsSync22,
-  mkdirSync as mkdirSync14,
+  existsSync as existsSync23,
+  mkdirSync as mkdirSync15,
   readdirSync as readdirSync9,
   readFileSync as readFileSync15,
-  unlinkSync as unlinkSync5,
+  unlinkSync as unlinkSync6,
   writeFileSync as writeFileSync10
 } from "node:fs";
-import { join as join22 } from "node:path";
+import { join as join23 } from "node:path";
 function printHelp4() {
   process.stderr.write(`
 ${bold2("locus discuss")} — AI-powered architectural discussions
@@ -11422,12 +12022,12 @@ ${bold2("Examples:")}
 `);
 }
 function getDiscussionsDir(projectRoot) {
-  return join22(projectRoot, ".locus", "discussions");
+  return join23(projectRoot, ".locus", "discussions");
 }
 function ensureDiscussionsDir(projectRoot) {
   const dir = getDiscussionsDir(projectRoot);
-  if (!existsSync22(dir)) {
-    mkdirSync14(dir, { recursive: true });
+  if (!existsSync23(dir)) {
+    mkdirSync15(dir, { recursive: true });
   }
   return dir;
 }
@@ -11461,7 +12061,7 @@ async function discussCommand(projectRoot, args, flags = {}) {
 }
 function listDiscussions(projectRoot) {
   const dir = getDiscussionsDir(projectRoot);
-  if (!existsSync22(dir)) {
+  if (!existsSync23(dir)) {
     process.stderr.write(`${dim2("No discussions yet.")}
 `);
     return;
@@ -11478,7 +12078,7 @@ ${bold2("Discussions:")}
 `);
   for (const file of files) {
     const id = file.replace(".md", "");
-    const content = readFileSync15(join22(dir, file), "utf-8");
+    const content = readFileSync15(join23(dir, file), "utf-8");
     const titleMatch = content.match(/^#\s+(.+)/m);
     const title = titleMatch ? titleMatch[1] : id;
     const dateMatch = content.match(/\*\*Date:\*\*\s*(.+)/);
@@ -11496,7 +12096,7 @@ function showDiscussion(projectRoot, id) {
     return;
   }
   const dir = getDiscussionsDir(projectRoot);
-  if (!existsSync22(dir)) {
+  if (!existsSync23(dir)) {
     process.stderr.write(`${red2("✗")} No discussions found.
 `);
     return;
@@ -11508,7 +12108,7 @@ function showDiscussion(projectRoot, id) {
 `);
     return;
   }
-  const content = readFileSync15(join22(dir, match), "utf-8");
+  const content = readFileSync15(join23(dir, match), "utf-8");
   process.stdout.write(`${content}
 `);
 }
@@ -11519,7 +12119,7 @@ function deleteDiscussion(projectRoot, id) {
     return;
   }
   const dir = getDiscussionsDir(projectRoot);
-  if (!existsSync22(dir)) {
+  if (!existsSync23(dir)) {
     process.stderr.write(`${red2("✗")} No discussions found.
 `);
     return;
@@ -11531,7 +12131,7 @@ function deleteDiscussion(projectRoot, id) {
 `);
     return;
   }
-  unlinkSync5(join22(dir, match));
+  unlinkSync6(join23(dir, match));
   process.stderr.write(`${green("✓")} Deleted discussion: ${match.replace(".md", "")}
 `);
 }
@@ -11544,7 +12144,7 @@ async function convertDiscussionToPlan(projectRoot, id) {
     return;
   }
   const dir = getDiscussionsDir(projectRoot);
-  if (!existsSync22(dir)) {
+  if (!existsSync23(dir)) {
     process.stderr.write(`${red2("✗")} No discussions found.
 `);
     return;
@@ -11556,7 +12156,7 @@ async function convertDiscussionToPlan(projectRoot, id) {
 `);
     return;
   }
-  const content = readFileSync15(join22(dir, match), "utf-8");
+  const content = readFileSync15(join23(dir, match), "utf-8");
   const titleMatch = content.match(/^#\s+(.+)/m);
   const discussionTitle = titleMatch ? titleMatch[1].trim() : id;
   await planCommand(projectRoot, [
@@ -11681,7 +12281,7 @@ ${turn.content}`;
     ...conversation.length > 1 ? [`---`, ``, `## Discussion Transcript`, ``, transcript, ``] : []
   ].join(`
 `);
-  writeFileSync10(join22(dir, `${id}.md`), markdown, "utf-8");
+  writeFileSync10(join23(dir, `${id}.md`), markdown, "utf-8");
   process.stderr.write(`
 ${green("✓")} Discussion saved: ${cyan2(id)} ${dim2(`(${timer.formatted()})`)}
 `);
@@ -11696,15 +12296,15 @@ function buildDiscussionPrompt(projectRoot, config, topic, conversation, forceFi
   parts.push(`<role>
 You are a senior software architect and consultant for the ${config.github.owner}/${config.github.repo} project.
 </role>`);
-  const locusPath = join22(projectRoot, ".locus", "LOCUS.md");
-  if (existsSync22(locusPath)) {
+  const locusPath = join23(projectRoot, ".locus", "LOCUS.md");
+  if (existsSync23(locusPath)) {
     const content = readFileSync15(locusPath, "utf-8");
     parts.push(`<project-context>
 ${content.slice(0, 3000)}
 </project-context>`);
   }
-  const learningsPath = join22(projectRoot, ".locus", "LEARNINGS.md");
-  if (existsSync22(learningsPath)) {
+  const learningsPath = join23(projectRoot, ".locus", "LEARNINGS.md");
+  if (existsSync23(learningsPath)) {
     const content = readFileSync15(learningsPath, "utf-8");
     parts.push(`<past-learnings>
 ${content.slice(0, 2000)}
@@ -11776,8 +12376,8 @@ __export(exports_artifacts, {
   formatDate: () => formatDate2,
   artifactsCommand: () => artifactsCommand
 });
-import { existsSync as existsSync23, readdirSync as readdirSync10, readFileSync as readFileSync16, statSync as statSync5 } from "node:fs";
-import { join as join23 } from "node:path";
+import { existsSync as existsSync24, readdirSync as readdirSync10, readFileSync as readFileSync16, statSync as statSync5 } from "node:fs";
+import { join as join24 } from "node:path";
 function printHelp5() {
   process.stderr.write(`
 ${bold2("locus artifacts")} — View and manage AI-generated artifacts
@@ -11797,14 +12397,14 @@ ${dim2("Artifact names support partial matching.")}
 `);
 }
 function getArtifactsDir(projectRoot) {
-  return join23(projectRoot, ".locus", "artifacts");
+  return join24(projectRoot, ".locus", "artifacts");
 }
 function listArtifacts(projectRoot) {
   const dir = getArtifactsDir(projectRoot);
-  if (!existsSync23(dir))
+  if (!existsSync24(dir))
     return [];
   return readdirSync10(dir).filter((f) => f.endsWith(".md")).map((fileName) => {
-    const filePath = join23(dir, fileName);
+    const filePath = join24(dir, fileName);
     const stat = statSync5(filePath);
     return {
       name: fileName.replace(/\.md$/, ""),
@@ -11817,8 +12417,8 @@ function listArtifacts(projectRoot) {
 function readArtifact(projectRoot, name) {
   const dir = getArtifactsDir(projectRoot);
   const fileName = name.endsWith(".md") ? name : `${name}.md`;
-  const filePath = join23(dir, fileName);
-  if (!existsSync23(filePath))
+  const filePath = join24(dir, fileName);
+  if (!existsSync24(filePath))
     return null;
   const stat = statSync5(filePath);
   return {
@@ -11987,10 +12587,10 @@ __export(exports_sandbox2, {
   parseSandboxLogsArgs: () => parseSandboxLogsArgs,
   parseSandboxInstallArgs: () => parseSandboxInstallArgs
 });
-import { execSync as execSync17, spawn as spawn6 } from "node:child_process";
+import { execSync as execSync18, spawn as spawn7 } from "node:child_process";
 import { createHash } from "node:crypto";
-import { existsSync as existsSync24, readFileSync as readFileSync17 } from "node:fs";
-import { basename as basename4, join as join24 } from "node:path";
+import { existsSync as existsSync25, readFileSync as readFileSync17 } from "node:fs";
+import { basename as basename4, join as join25 } from "node:path";
 import { createInterface as createInterface3 } from "node:readline";
 function printSandboxHelp() {
   process.stderr.write(`
@@ -12155,7 +12755,7 @@ async function handleAgentLogin(projectRoot, agent) {
   process.stderr.write(`${dim2("Login and then exit when ready.")}
 
 `);
-  const child = spawn6("docker", ["sandbox", "exec", "-it", "-w", projectRoot, sandboxName, agent], {
+  const child = spawn7("docker", ["sandbox", "exec", "-it", "-w", projectRoot, sandboxName, agent], {
     stdio: "inherit"
   });
   await new Promise((resolve2) => {
@@ -12199,7 +12799,7 @@ function handleRemove(projectRoot) {
     process.stderr.write(`Removing sandbox ${bold2(sandboxName)}...
 `);
     try {
-      execSync17(`docker sandbox rm ${sandboxName}`, {
+      execSync18(`docker sandbox rm ${sandboxName}`, {
         encoding: "utf-8",
         stdio: ["pipe", "pipe", "pipe"],
         timeout: 15000
@@ -12446,9 +13046,9 @@ async function handleLogs(projectRoot, args) {
   dockerArgs.push(sandboxName);
   await runInteractiveCommand("docker", dockerArgs);
 }
-function detectPackageManager(projectRoot) {
+function detectPackageManager2(projectRoot) {
   try {
-    const raw = readFileSync17(join24(projectRoot, "package.json"), "utf-8");
+    const raw = readFileSync17(join25(projectRoot, "package.json"), "utf-8");
     const pkgJson = JSON.parse(raw);
     if (typeof pkgJson.packageManager === "string") {
       const name = pkgJson.packageManager.split("@")[0];
@@ -12457,13 +13057,13 @@ function detectPackageManager(projectRoot) {
       }
     }
   } catch {}
-  if (existsSync24(join24(projectRoot, "bun.lock")) || existsSync24(join24(projectRoot, "bun.lockb"))) {
+  if (existsSync25(join25(projectRoot, "bun.lock")) || existsSync25(join25(projectRoot, "bun.lockb"))) {
     return "bun";
   }
-  if (existsSync24(join24(projectRoot, "yarn.lock"))) {
+  if (existsSync25(join25(projectRoot, "yarn.lock"))) {
     return "yarn";
   }
-  if (existsSync24(join24(projectRoot, "pnpm-lock.yaml"))) {
+  if (existsSync25(join25(projectRoot, "pnpm-lock.yaml"))) {
     return "pnpm";
   }
   return "npm";
@@ -12484,7 +13084,7 @@ async function runSandboxSetup(sandboxName, projectRoot) {
   const ecosystem = detectProjectEcosystem(projectRoot);
   const isJS = isJavaScriptEcosystem(ecosystem);
   if (isJS) {
-    const pm = detectPackageManager(projectRoot);
+    const pm = detectPackageManager2(projectRoot);
     if (pm !== "npm") {
       await ensurePackageManagerInSandbox(sandboxName, pm);
     }
@@ -12512,8 +13112,8 @@ Installing dependencies (${bold2(installCmd.join(" "))}) in sandbox ${dim2(sandb
 ${dim2(`Detected ${ecosystem} project — skipping JS package install.`)}
 `);
   }
-  const setupScript = join24(projectRoot, ".locus", "sandbox-setup.sh");
-  if (existsSync24(setupScript)) {
+  const setupScript = join25(projectRoot, ".locus", "sandbox-setup.sh");
+  if (existsSync25(setupScript)) {
     process.stderr.write(`Running ${bold2(".locus/sandbox-setup.sh")} in sandbox ${dim2(sandboxName)}...
 `);
     const hookOk = await runInteractiveCommand("docker", [
@@ -12594,14 +13194,14 @@ function getActiveProviderSandbox(projectRoot, provider) {
 }
 function runInteractiveCommand(command, args) {
   return new Promise((resolve2) => {
-    const child = spawn6(command, args, { stdio: "inherit" });
+    const child = spawn7(command, args, { stdio: "inherit" });
     child.on("close", (code) => resolve2(code === 0));
     child.on("error", () => resolve2(false));
   });
 }
 async function createProviderSandbox(provider, sandboxName, projectRoot) {
   try {
-    execSync17(`docker sandbox create --name ${sandboxName} claude ${projectRoot}`, {
+    execSync18(`docker sandbox create --name ${sandboxName} claude ${projectRoot}`, {
       stdio: ["pipe", "pipe", "pipe"],
       timeout: 120000
     });
@@ -12622,7 +13222,7 @@ async function createProviderSandbox(provider, sandboxName, projectRoot) {
 }
 async function ensurePackageManagerInSandbox(sandboxName, pm) {
   try {
-    execSync17(`docker sandbox exec ${sandboxName} which ${pm}`, {
+    execSync18(`docker sandbox exec ${sandboxName} which ${pm}`, {
       stdio: ["pipe", "pipe", "pipe"],
       timeout: 5000
     });
@@ -12631,7 +13231,7 @@ async function ensurePackageManagerInSandbox(sandboxName, pm) {
     process.stderr.write(`Installing ${bold2(pm)} in sandbox...
 `);
     try {
-      execSync17(`docker sandbox exec ${sandboxName} npm install -g ${npmPkg}`, {
+      execSync18(`docker sandbox exec ${sandboxName} npm install -g ${npmPkg}`, {
         stdio: "inherit",
         timeout: 120000
       });
@@ -12643,7 +13243,7 @@ async function ensurePackageManagerInSandbox(sandboxName, pm) {
 }
 async function ensureCodexInSandbox(sandboxName) {
   try {
-    execSync17(`docker sandbox exec ${sandboxName} which codex`, {
+    execSync18(`docker sandbox exec ${sandboxName} which codex`, {
       stdio: ["pipe", "pipe", "pipe"],
       timeout: 5000
     });
@@ -12651,7 +13251,7 @@ async function ensureCodexInSandbox(sandboxName) {
     process.stderr.write(`Installing codex in sandbox...
 `);
     try {
-      execSync17(`docker sandbox exec ${sandboxName} npm install -g @openai/codex`, { stdio: "inherit", timeout: 120000 });
+      execSync18(`docker sandbox exec ${sandboxName} npm install -g @openai/codex`, { stdio: "inherit", timeout: 120000 });
     } catch {
       process.stderr.write(`${red2("✗")} Failed to install codex in sandbox.
 `);
@@ -12660,7 +13260,7 @@ async function ensureCodexInSandbox(sandboxName) {
 }
 function isSandboxAlive(name) {
   try {
-    const output = execSync17("docker sandbox ls", {
+    const output = execSync18("docker sandbox ls", {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"],
       timeout: 5000
@@ -12686,13 +13286,13 @@ init_context();
 init_logger();
 init_rate_limiter();
 init_terminal();
-import { existsSync as existsSync25, readFileSync as readFileSync18 } from "node:fs";
-import { join as join25 } from "node:path";
+import { existsSync as existsSync26, readFileSync as readFileSync18 } from "node:fs";
+import { join as join26 } from "node:path";
 import { fileURLToPath } from "node:url";
 function getCliVersion() {
   const fallbackVersion = "0.0.0";
-  const packageJsonPath = join25(fileURLToPath(new URL(".", import.meta.url)), "..", "package.json");
-  if (!existsSync25(packageJsonPath)) {
+  const packageJsonPath = join26(fileURLToPath(new URL(".", import.meta.url)), "..", "package.json");
+  if (!existsSync26(packageJsonPath)) {
     return fallbackVersion;
   }
   try {
@@ -12957,7 +13557,7 @@ async function main() {
     try {
       const root = getGitRoot(cwd);
       if (isInitialized(root)) {
-        logDir = join25(root, ".locus", "logs");
+        logDir = join26(root, ".locus", "logs");
         getRateLimiter(root);
       }
     } catch {}