@staff0rd/assist 0.486.0 → 0.487.0

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.486.0",
+  version: "0.487.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -6829,7 +6829,6 @@ function consumePause(itemId2) {
 }
 
 // src/commands/backlog/executePhase.ts
-import { randomUUID } from "crypto";
 import chalk44 from "chalk";
 
 // src/shared/awaitClaude.ts
@@ -7000,6 +6999,13 @@ function logHookFired(status3, sessionId, source) {
   );
 }
 
+// src/commands/backlog/assertCodexResumeSupported.ts
+function assertCodexResumeSupported(options2) {
+  if (options2?.resumeSessionId && options2.harness === "codex") {
+    throw new Error("Codex backlog sessions cannot be resumed yet");
+  }
+}
+
 // src/commands/backlog/buildCommentLines.ts
 function buildCommentLines(comments3) {
   if (!comments3?.length) return [];
@@ -7142,6 +7148,101 @@ function buildPhasePrompt(item, phaseNumber, phase) {
   });
 }
 
+// src/shared/harnesses.ts
+import * as os from "os";
+import * as path22 from "path";
+
+// src/shared/checkCliAvailable.ts
+import { execSync as execSync30 } from "child_process";
+function checkCliAvailable(cli) {
+  const binary = cli.split(/\s+/)[0];
+  const opts = {
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "pipe"]
+  };
+  try {
+    execSync30(`command -v ${binary}`, opts);
+    return true;
+  } catch {
+    try {
+      execSync30(`where ${binary}`, opts);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}
+
+// src/shared/harnesses.ts
+var harnesses = {
+  claude: {
+    kind: "claude",
+    command: "claude",
+    homeDir: path22.join(os.homedir(), ".claude"),
+    sync: {
+      agentsFile: "CLAUDE.md",
+      commandDest: (name) => path22.join("commands", `${name}.md`)
+    }
+  },
+  codex: {
+    kind: "codex",
+    command: "codex",
+    homeDir: path22.join(os.homedir(), ".codex"),
+    sync: {
+      agentsFile: "AGENTS.md",
+      commandDest: (name) => path22.join("skills", name, "SKILL.md")
+    }
+  },
+  pi: {
+    kind: "pi",
+    command: "pi",
+    homeDir: path22.join(os.homedir(), ".pi", "agent"),
+    sync: {
+      agentsFile: "AGENTS.md",
+      commandDest: (name) => path22.join("prompts", `${name}.md`)
+    }
+  }
+};
+function isHarnessAvailable(kind) {
+  return checkCliAvailable(harnesses[kind].command);
+}
+
+// src/shared/spawnCodex.ts
+function spawnCodex(prompt, options2 = {}) {
+  const cwd = options2.cwd ?? process.cwd();
+  return spawnInherit(harnesses.codex.command, [
+    "-C",
+    cwd,
+    "--sandbox",
+    options2.sandbox ?? "workspace-write",
+    prompt
+  ]);
+}
+
+// src/shared/spawnPi.ts
+function spawnPi(prompt, options2 = {}) {
+  const cwd = options2.cwd ?? process.cwd();
+  return spawnInherit(harnesses.pi.command, [prompt], { cwd });
+}
+
+// src/shared/spawnHarness.ts
+function spawnHarness(harness, prompt, options2 = {}) {
+  if (harness === "codex") {
+    return spawnCodex(prompt, {
+      cwd: options2.cwd,
+      sandbox: options2.allowEdits === false ? "read-only" : "workspace-write"
+    });
+  }
+  if (harness === "pi") {
+    return spawnPi(prompt, { cwd: options2.cwd });
+  }
+  return spawnClaude(prompt, {
+    allowEdits: options2.allowEdits ?? true,
+    sessionId: options2.sessionId,
+    resumeSessionId: options2.resumeSessionId
+  });
+}
+
 // src/commands/backlog/watchForMarker.ts
 import { existsSync as existsSync24, unwatchFile, watchFile } from "fs";
 
@@ -7150,8 +7251,8 @@ import { existsSync as existsSync23, readFileSync as readFileSync17 } from "fs";
 
 // src/commands/backlog/writeSignal.ts
 import { mkdirSync as mkdirSync8, writeFileSync as writeFileSync18 } from "fs";
-import { homedir as homedir8 } from "os";
-import { dirname as dirname16, join as join20 } from "path";
+import { homedir as homedir9 } from "os";
+import { dirname as dirname16, join as join21 } from "path";
 import chalk41 from "chalk";
 
 // src/commands/backlog/recordSignalOwner.ts
@@ -7162,10 +7263,10 @@ import {
   rmSync,
   writeFileSync as writeFileSync17
 } from "fs";
-import { homedir as homedir7 } from "os";
-import { dirname as dirname15, join as join19 } from "path";
+import { homedir as homedir8 } from "os";
+import { dirname as dirname15, join as join20 } from "path";
 function getOwnerPath(itemId2) {
-  return join19(homedir7(), ".assist", "signals", `owner-${itemId2}.json`);
+  return join20(homedir8(), ".assist", "signals", `owner-${itemId2}.json`);
 }
 function recordSignalOwner(itemId2) {
   const sessionId = process.env.ASSIST_SESSION_ID;
@@ -7195,7 +7296,7 @@ function clearSignalOwner(itemId2) {
 // src/commands/backlog/writeSignal.ts
 function getSignalPath(sessionId = process.env.ASSIST_SESSION_ID) {
   if (!sessionId) return void 0;
-  return join20(homedir8(), ".assist", "signals", `signal-${sessionId}.json`);
+  return join21(homedir9(), ".assist", "signals", `signal-${sessionId}.json`);
 }
 function resolveSignalTarget(event, data) {
   const caller = process.env.ASSIST_SESSION_ID;
@@ -7264,8 +7365,11 @@ function stopWatching() {
 }
 
 // src/commands/backlog/launchPhaseClaude.ts
-async function launchPhaseClaude(prompt, spawnOptions, context) {
-  const { child, done: done2 } = spawnClaude(prompt, spawnOptions);
+async function launchPhaseClaude(prompt, spawnOptions, context, harness = "claude") {
+  const { child, done: done2 } = spawnHarness(harness, prompt, {
+    ...spawnOptions,
+    cwd: process.cwd()
+  });
   watchForMarker(child);
   const exitCode = await awaitClaude(done2, context);
   stopWatching();
@@ -7284,16 +7388,77 @@ function resumeNudge() {
 
 // src/commands/backlog/launchPhaseSession.ts
 function launchPhaseSession(item, phaseNumber, phase, phaseLabel2, claudeSessionId, spawnOptions) {
-  const resumeSessionId = spawnOptions?.resumeSessionId;
+  const harness = spawnOptions?.harness;
+  const { harness: _harness, ...phaseOptions } = spawnOptions ?? {};
+  const resumeSessionId = phaseOptions.resumeSessionId;
   return launchPhaseClaude(
     resumeSessionId ? resumeNudge() : buildPhasePrompt(item, phaseNumber, phase),
-    resumeSessionId ? spawnOptions ?? {} : { ...spawnOptions, sessionId: claudeSessionId },
-    phaseLabel2
+    resumeSessionId ? phaseOptions : { ...phaseOptions, sessionId: claudeSessionId },
+    phaseLabel2,
+    harness
   );
 }
 
+// src/commands/backlog/resolvePhaseResult.ts
+import { existsSync as existsSync25, unlinkSync as unlinkSync4 } from "fs";
+import chalk42 from "chalk";
+
+// src/commands/backlog/handleIncompletePhase.ts
+import enquirer4 from "enquirer";
+async function handleIncompletePhase() {
+  const { action } = await exitOnCancel(
+    enquirer4.prompt({
+      type: "select",
+      name: "action",
+      message: "Phase was not marked complete. What would you like to do?",
+      choices: ["Retry this phase", "Skip to next phase", "Abort"]
+    })
+  );
+  if (action === "Retry this phase") return "retry";
+  if (action === "Skip to next phase") return "skip";
+  return "abort";
+}
+
+// src/commands/backlog/resolvePhaseResult.ts
+function cleanupSignal() {
+  const statusPath = getSignalPath();
+  if (statusPath && existsSync25(statusPath)) {
+    unlinkSync4(statusPath);
+  }
+}
+async function isTerminalStatus(itemId2) {
+  const { orm } = await getReady();
+  const item = await loadItem(orm, itemId2);
+  return item?.status === "done" || item?.status === "wontdo";
+}
+async function resolvePhaseResult(phaseIndex, itemId2) {
+  const signalPath = getSignalPath();
+  if (!signalPath || !existsSync25(signalPath)) {
+    if (await isTerminalStatus(itemId2)) return { kind: "abort" };
+    const action = await handleIncompletePhase();
+    if (action === "abort") return { kind: "abort" };
+    return action === "skip" ? { kind: "skip" } : { kind: "retry" };
+  }
+  const signal = readSignal();
+  cleanupSignal();
+  if (signal?.event === "rewind") {
+    const targetPhase = signal.targetPhase;
+    const targetPhaseNumber = targetPhase + 1;
+    console.log(chalk42.yellow(`
+Rewinding to phase ${targetPhaseNumber}.`));
+    return { kind: "rewind", targetPhase };
+  }
+  const phaseNumber = phaseIndex + 1;
+  console.log(chalk42.green(`
+Phase ${phaseNumber} completed.`));
+  return { kind: "advance" };
+}
+
+// src/commands/backlog/preparePhaseSession.ts
+import { randomUUID } from "crypto";
+
 // src/commands/backlog/persistPhaseSession.ts
-import os from "os";
+import os2 from "os";
 
 // src/shared/db/recordPhaseSession.ts
 import { sql as sql12 } from "drizzle-orm";
@@ -7318,8 +7483,8 @@ async function persistPhaseSession(itemId2, phaseIdx, claudeSessionId) {
       itemId2,
       phaseIdx,
       claudeSessionId,
-      os.hostname(),
-      os.userInfo().username
+      os2.hostname(),
+      os2.userInfo().username
     );
   } catch (error) {
     console.error(
@@ -7348,8 +7513,8 @@ async function persistPhaseSessionId(itemId2, phaseIdx, claudeSessionId) {
 
 // src/shared/emitActivity.ts
 import { mkdirSync as mkdirSync9, readFileSync as readFileSync18, rmSync as rmSync2, writeFileSync as writeFileSync19 } from "fs";
-import { homedir as homedir9 } from "os";
-import { dirname as dirname17, join as join21 } from "path";
+import { homedir as homedir10 } from "os";
+import { dirname as dirname17, join as join22 } from "path";
 import { z as z4 } from "zod";
 var activitySchema = z4.object({
   kind: z4.enum(["command", "backlog"]),
@@ -7364,7 +7529,7 @@ var activitySchema = z4.object({
   startedAt: z4.number()
 });
 function activityPath(sessionId) {
-  return join21(homedir9(), ".assist", "activity", `activity-${sessionId}.json`);
+  return join22(homedir10(), ".assist", "activity", `activity-${sessionId}.json`);
 }
 function emitActivity(activity2) {
   const sessionId = process.env.ASSIST_ACTIVITY_ID;
@@ -7410,75 +7575,20 @@ function reportPhaseActivity(item, phaseNumber, totalPhases, phase, claudeSessio
   });
 }
 
-// src/commands/backlog/resolvePhaseResult.ts
-import { existsSync as existsSync25, unlinkSync as unlinkSync4 } from "fs";
-import chalk42 from "chalk";
-
-// src/commands/backlog/handleIncompletePhase.ts
-import enquirer4 from "enquirer";
-async function handleIncompletePhase() {
-  const { action } = await exitOnCancel(
-    enquirer4.prompt({
-      type: "select",
-      name: "action",
-      message: "Phase was not marked complete. What would you like to do?",
-      choices: ["Retry this phase", "Skip to next phase", "Abort"]
-    })
-  );
-  if (action === "Retry this phase") return "retry";
-  if (action === "Skip to next phase") return "skip";
-  return "abort";
-}
-
-// src/commands/backlog/resolvePhaseResult.ts
-function cleanupSignal() {
-  const statusPath = getSignalPath();
-  if (statusPath && existsSync25(statusPath)) {
-    unlinkSync4(statusPath);
-  }
-}
-async function isTerminalStatus(itemId2) {
-  const { orm } = await getReady();
-  const item = await loadItem(orm, itemId2);
-  return item?.status === "done" || item?.status === "wontdo";
-}
-async function resolvePhaseResult(phaseIndex, itemId2) {
-  const signalPath = getSignalPath();
-  if (!signalPath || !existsSync25(signalPath)) {
-    if (await isTerminalStatus(itemId2)) return { kind: "abort" };
-    const action = await handleIncompletePhase();
-    if (action === "abort") return { kind: "abort" };
-    return action === "skip" ? { kind: "skip" } : { kind: "retry" };
-  }
-  const signal = readSignal();
-  cleanupSignal();
-  if (signal?.event === "rewind") {
-    const targetPhase = signal.targetPhase;
-    const targetPhaseNumber = targetPhase + 1;
-    console.log(chalk42.yellow(`
-Rewinding to phase ${targetPhaseNumber}.`));
-    return { kind: "rewind", targetPhase };
-  }
-  const phaseNumber = phaseIndex + 1;
-  console.log(chalk42.green(`
-Phase ${phaseNumber} completed.`));
-  return { kind: "advance" };
-}
-
 // src/commands/backlog/verifyResumeConversation.ts
 import chalk43 from "chalk";
 
 // src/commands/sessions/shared/findSessionJsonlPath.ts
-import * as path24 from "path";
+import * as path25 from "path";
 
 // src/commands/sessions/shared/discoverSessions.ts
 import * as fs18 from "fs";
-import * as os2 from "os";
-import * as path23 from "path";
+import * as os3 from "os";
+import * as path24 from "path";
 
 // src/commands/sessions/shared/parseSessionFile.ts
 import * as fs17 from "fs";
-import * as path22 from "path";
+import * as path23 from "path";
 
 // src/commands/sessions/shared/deriveHistoryFields.ts
 var KNOWN = [
@@ -7602,10 +7712,10 @@ async function readHeadLines(handle) {
 }
 function deriveProject(cwd, filePath, origin) {
   if (!cwd) return dirNameToProject(filePath);
-  return origin === "windows" ? path22.win32.basename(cwd) : path22.basename(cwd);
+  return origin === "windows" ? path23.win32.basename(cwd) : path23.basename(cwd);
 }
 function dirNameToProject(filePath) {
-  const dirName = path22.basename(path22.dirname(filePath));
+  const dirName = path23.basename(path23.dirname(filePath));
   const parts = dirName.split("--");
   return parts[parts.length - 1].replace(/-/g, "/");
 }
@@ -7613,7 +7723,7 @@ function dirNameToProject(filePath) {
 // src/commands/sessions/shared/discoverSessions.ts
 function sessionRoots() {
   const roots = [
-    { dir: path23.join(os2.homedir(), ".claude", "projects"), origin: "wsl" }
+    { dir: path24.join(os3.homedir(), ".claude", "projects"), origin: "wsl" }
   ];
   const windowsRoot = loadConfig().sessions?.windowsProjectsRoot;
   if (windowsRoot) roots.push({ dir: windowsRoot, origin: "windows" });
@@ -7631,7 +7741,7 @@ async function discoverSessionJsonlPaths() {
       }
       await Promise.all(
         projectDirs.map(async (dirName) => {
-          const dirPath = path23.join(dir, dirName);
+          const dirPath = path24.join(dir, dirName);
           let entries;
           try {
             entries = await fs18.promises.readdir(dirPath);
@@ -7640,7 +7750,7 @@ async function discoverSessionJsonlPaths() {
           }
           for (const file of entries) {
             if (file.endsWith(".jsonl"))
-              results.push({ path: path23.join(dirPath, file), origin });
+              results.push({ path: path24.join(dirPath, file), origin });
           }
         })
       );
@@ -7670,7 +7780,7 @@ async function discoverSessions() {
 async function findSessionJsonlPath(sessionId) {
   const paths = await discoverSessionJsonlPaths();
   const direct = paths.find(
-    (p) => path24.basename(p.path, ".jsonl") === sessionId
+    (p) => path25.basename(p.path, ".jsonl") === sessionId
   );
   if (direct) return direct.path;
   for (const p of paths) {
@@ -7703,6 +7813,21 @@ async function verifyPhaseResume(itemId2, resumeSessionId, phaseLabel2) {
   return true;
 }
 
+// src/commands/backlog/preparePhaseSession.ts
+async function preparePhaseSession(item, phase, phaseIndex, phaseNumber, totalPhases, phaseLabel2, spawnOptions) {
+  const resumeSessionId = spawnOptions?.resumeSessionId;
+  const claudeSessionId = resumeSessionId ?? randomUUID();
+  if (resumeSessionId && !await verifyPhaseResume(item.id, resumeSessionId, phaseLabel2)) {
+    return void 0;
+  }
+  reportPhaseActivity(item, phaseNumber, totalPhases, phase, claudeSessionId);
+  if (!resumeSessionId) {
+    await persistPhaseSessionId(item.id, phaseIndex, claudeSessionId);
+  }
+  await persistPhaseSession(item.id, phaseIndex, claudeSessionId);
+  return { claudeSessionId };
+}
+
 // src/commands/backlog/executePhase.ts
 async function executePhase(item, phaseIndex, phases, spawnOptions, totalPhases = phases.length) {
   const phase = phases[phaseIndex];
@@ -7714,27 +7839,27 @@ async function executePhase(item, phaseIndex, phases, spawnOptions, totalPhases
 `
     )
   );
-  const resumeSessionId = spawnOptions?.resumeSessionId;
-  const claudeSessionId = resumeSessionId ?? randomUUID();
+  assertCodexResumeSupported(spawnOptions);
   process.env.ASSIST_SESSION_ID ??= String(process.pid);
   process.env.ASSIST_BACKLOG_ITEM_ID = String(item.id);
   recordSignalOwner(item.id);
   const phaseLabel2 = `phase ${phaseNumber}/${totalPhases}`;
-  if (resumeSessionId) {
-    if (!await verifyPhaseResume(item.id, resumeSessionId, phaseLabel2))
-      return { kind: "abort" };
-  }
-  reportPhaseActivity(item, phaseNumber, totalPhases, phase, claudeSessionId);
-  if (!resumeSessionId) {
-    await persistPhaseSessionId(item.id, phaseIndex, claudeSessionId);
-  }
-  await persistPhaseSession(item.id, phaseIndex, claudeSessionId);
+  const phaseSession = await preparePhaseSession(
+    item,
+    phase,
+    phaseIndex,
+    phaseNumber,
+    totalPhases,
+    phaseLabel2,
+    spawnOptions
+  );
+  if (!phaseSession) return { kind: "abort" };
   const exitCode = await launchPhaseSession(
     item,
     phaseNumber,
     phase,
     phaseLabel2,
-    claudeSessionId,
+    phaseSession.claudeSessionId,
     spawnOptions
   );
   if (exitCode === CLAUDE_SPAWN_FAILED) return { kind: "abort" };
@@ -8300,7 +8425,7 @@ import chalk61 from "chalk";
 import { WebSocketServer } from "ws";
 
 // src/shared/getInstallDir.ts
-import { execSync as execSync30 } from "child_process";
+import { execSync as execSync31 } from "child_process";
 import { dirname as dirname19, resolve as resolve8 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var __filename2 = fileURLToPath3(import.meta.url);
@@ -8310,7 +8435,7 @@ function getInstallDir() {
 }
 function isGitRepo(dir) {
   try {
-    const result = execSync30("git rev-parse --show-toplevel", {
+    const result = execSync31("git rev-parse --show-toplevel", {
       cwd: dir,
       stdio: "pipe"
     }).toString().trim();
@@ -8327,11 +8452,11 @@ import {
 import chalk57 from "chalk";
 
 // src/lib/openBrowser.ts
-import { execSync as execSync31 } from "child_process";
+import { execSync as execSync32 } from "child_process";
 function tryExec(commands) {
   for (const cmd of commands) {
     try {
-      execSync31(cmd, { stdio: "ignore" });
+      execSync32(cmd, { stdio: "ignore" });
       return true;
     } catch {
     }
@@ -8632,13 +8757,13 @@ function gitCommonDir(cwd) {
 
 // src/shared/loadJson.ts
 import { existsSync as existsSync26, mkdirSync as mkdirSync11, readFileSync as readFileSync19, writeFileSync as writeFileSync20 } from "fs";
-import { homedir as homedir11 } from "os";
-import { join as join23 } from "path";
+import { homedir as homedir12 } from "os";
+import { join as join24 } from "path";
 function getStoreDir() {
-  return join23(homedir11(), ".assist");
+  return join24(homedir12(), ".assist");
 }
 function getStorePath(filename) {
-  return join23(getStoreDir(), filename);
+  return join24(getStoreDir(), filename);
 }
 function loadJson(filename) {
   const path71 = getStorePath(filename);
@@ -8709,10 +8834,10 @@ function hostedGroup(cwd, origin, clone) {
 // src/shared/createBundleHandler.ts
 import { createHash } from "crypto";
 import { readFileSync as readFileSync20, statSync as statSync3 } from "fs";
-import { dirname as dirname20, join as join24 } from "path";
+import { dirname as dirname20, join as join25 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 function createBundleHandler(importMetaUrl, bundlePath, contentType = "application/javascript") {
-  const file = join24(dirname20(fileURLToPath4(importMetaUrl)), bundlePath);
+  const file = join25(dirname20(fileURLToPath4(importMetaUrl)), bundlePath);
   let cache4;
   return (req, res) => {
     const mtimeMs = statSync3(file).mtimeMs;
@@ -8849,12 +8974,12 @@ async function loadItemSummaries(orm, origin) {
 import { existsSync as existsSync27 } from "fs";
 
 // src/commands/backlog/cloneTargetDir.ts
-import { join as join25, resolve as resolve9 } from "path";
+import { join as join26, resolve as resolve9 } from "path";
 function cloneTargetDir(origin, baseDir) {
   if (origin.startsWith("local:")) return null;
   const repoName = origin.split("/").filter(Boolean).pop();
   if (!repoName) return null;
-  return resolve9(join25(baseDir, repoName));
+  return resolve9(join26(baseDir, repoName));
 }
 
 // src/commands/backlog/resolveRepoLocation.ts
@@ -9841,19 +9966,19 @@ function handleServerRuns(req, res) {
 // src/commands/sessions/web/getReviewSynthesis.ts
 import { execFile as execFile4 } from "child_process";
 import { readFileSync as readFileSync21 } from "fs";
-import { homedir as homedir12 } from "os";
-import { basename as basename8, join as join27 } from "path";
+import { homedir as homedir13 } from "os";
+import { basename as basename8, join as join28 } from "path";
 import { promisify as promisify3 } from "util";
 
 // src/commands/sessions/web/findSynthesisForBranch.ts
 import { existsSync as existsSync28, readdirSync as readdirSync2, statSync as statSync4 } from "fs";
-import { basename as basename7, dirname as dirname21, join as join26 } from "path";
+import { basename as basename7, dirname as dirname21, join as join27 } from "path";
 function findSynthesisForBranch(repoReviewsDir, branch2) {
-  const branchKeyPath = join26(repoReviewsDir, `${branch2}-`);
+  const branchKeyPath = join27(repoReviewsDir, `${branch2}-`);
   const parent = dirname21(branchKeyPath);
   const branchPrefix = basename7(branchKeyPath);
   if (!existsSync28(parent)) return null;
-  const synthesisFiles = readdirSync2(parent).filter((name) => name.startsWith(branchPrefix)).map((name) => join26(parent, name, "synthesis.md")).filter((path71) => existsSync28(path71)).map((path71) => ({ path: path71, mtime: statSync4(path71).mtimeMs })).sort((a, b) => b.mtime - a.mtime);
+  const synthesisFiles = readdirSync2(parent).filter((name) => name.startsWith(branchPrefix)).map((name) => join27(parent, name, "synthesis.md")).filter((path71) => existsSync28(path71)).map((path71) => ({ path: path71, mtime: statSync4(path71).mtimeMs })).sort((a, b) => b.mtime - a.mtime);
   return synthesisFiles[0]?.path ?? null;
 }
 
@@ -9870,8 +9995,8 @@ async function resolveSynthesisPath(cwd) {
     runGit(cwd, ["rev-parse", "--show-toplevel"]),
     runGit(cwd, ["rev-parse", "--abbrev-ref", "HEAD"])
   ]);
-  const repoReviewsDir = join27(
-    homedir12(),
+  const repoReviewsDir = join28(
+    homedir13(),
     ".assist",
     "reviews",
     basename8(repoRoot)
@@ -10013,65 +10138,6 @@ async function gitStatus(req, res) {
   }
 }
 
-// src/shared/harnesses.ts
-import * as os3 from "os";
-import * as path25 from "path";
-
-// src/shared/checkCliAvailable.ts
-import { execSync as execSync32 } from "child_process";
-function checkCliAvailable(cli) {
-  const binary = cli.split(/\s+/)[0];
-  const opts = {
-    encoding: "utf8",
-    stdio: ["ignore", "pipe", "pipe"]
-  };
-  try {
-    execSync32(`command -v ${binary}`, opts);
-    return true;
-  } catch {
-    try {
-      execSync32(`where ${binary}`, opts);
-      return true;
-    } catch {
-      return false;
-    }
-  }
-}
-
-// src/shared/harnesses.ts
-var harnesses = {
-  claude: {
-    kind: "claude",
-    command: "claude",
-    homeDir: path25.join(os3.homedir(), ".claude"),
-    sync: {
-      agentsFile: "CLAUDE.md",
-      commandDest: (name) => path25.join("commands", `${name}.md`)
-    }
-  },
-  codex: {
-    kind: "codex",
-    command: "codex",
-    homeDir: path25.join(os3.homedir(), ".codex"),
-    sync: {
-      agentsFile: "AGENTS.md",
-      commandDest: (name) => path25.join("skills", name, "SKILL.md")
-    }
-  },
-  pi: {
-    kind: "pi",
-    command: "pi",
-    homeDir: path25.join(os3.homedir(), ".pi", "agent"),
-    sync: {
-      agentsFile: "AGENTS.md",
-      commandDest: (name) => path25.join("prompts", `${name}.md`)
-    }
-  }
-};
-function isHarnessAvailable(kind) {
-  return checkCliAvailable(harnesses[kind].command);
-}
-
 // src/commands/sessions/web/harnessCapabilities.ts
 function harnessCapabilities(_req, res) {
   const config = loadConfig().harness;
@@ -12989,33 +13055,6 @@ import enquirer7 from "enquirer";
 // src/commands/backlog/launchMode.ts
 import { randomUUID as randomUUID4 } from "crypto";
 
-// src/shared/spawnCodex.ts
-function spawnCodex(prompt, options2 = {}) {
-  const cwd = options2.cwd ?? process.cwd();
-  return spawnInherit(harnesses.codex.command, ["-C", cwd, prompt]);
-}
-
-// src/shared/spawnPi.ts
-function spawnPi(prompt, options2 = {}) {
-  const cwd = options2.cwd ?? process.cwd();
-  return spawnInherit(harnesses.pi.command, [prompt], { cwd });
-}
-
-// src/shared/spawnHarness.ts
-function spawnHarness(harness, prompt, options2 = {}) {
-  if (harness === "codex") {
-    return spawnCodex(prompt, { cwd: options2.cwd });
-  }
-  if (harness === "pi") {
-    return spawnPi(prompt, { cwd: options2.cwd });
-  }
-  return spawnClaude(prompt, {
-    allowEdits: true,
-    sessionId: options2.sessionId,
-    resumeSessionId: options2.resumeSessionId
-  });
-}
-
 // src/commands/backlog/handleLaunchSignal.ts
 import chalk86 from "chalk";
 
@@ -13217,7 +13256,10 @@ function registerRewindCommand(cmd) {
 
 // src/commands/backlog/registerRunCommand.ts
 function registerRunCommand(cmd) {
-  cmd.command("run <id>").description("Run a backlog item's plan phase-by-phase with Claude").option("-w, --write", "Run Claude with auto permission mode (default)").option("--no-write", "Run Claude without auto permission mode").option(
+  cmd.command("run <id>").description("Run a backlog item's plan phase-by-phase").option("-w, --write", "Run the harness with write access (default)").option("--no-write", "Run the harness without write access").option(
+    "--harness <harness>",
+    "Coding harness to launch (claude|codex|pi); defaults to the configured harness.engine"
+  ).option(
     "--resume-session <id>",
     "Resume an interrupted Claude session for the current phase (used by the sessions daemon on restart)"
   ).action(
@@ -13225,6 +13267,7 @@ function registerRunCommand(cmd) {
       if (!opts.resumeSession) pullIfConfigured();
       await run2(id, {
         allowEdits: opts.write !== false,
+        harness: resolveHarness(opts.harness),
         resumeSessionId: opts.resumeSession
       });
     }
@@ -15740,16 +15783,14 @@ function parseInput(raw) {
   }
 }
 function preToolUseOutput(decision) {
-  if (decision.permissionDecision === "allow") {
-    return {
-      hookSpecificOutput: {
-        hookEventName: "PreToolUse",
-        permissionDecision: "allow",
-        permissionDecisionReason: decision.permissionDecisionReason
-      }
-    };
-  }
-  return { decision: "block", reason: decision.permissionDecisionReason };
+  if (decision.permissionDecision === "allow") return void 0;
+  return {
+    hookSpecificOutput: {
+      hookEventName: "PreToolUse",
+      permissionDecision: "deny",
+      permissionDecisionReason: decision.permissionDecisionReason
+    }
+  };
 }
 function permissionRequestOutput(decision) {
   return {
@@ -15768,7 +15809,7 @@ async function codexHook() {
   const decision = decideCommand(input.toolName, input.command);
   if (!decision) return;
   const output = input.event === "PermissionRequest" ? permissionRequestOutput(decision) : preToolUseOutput(decision);
-  console.log(JSON.stringify(output));
+  if (output) console.log(JSON.stringify(output));
 }
 
 // src/commands/registerCodexHook.ts