@nk070281sjv/cli 2.3.6 → 2.3.8

package/dist/index.js

@@ -30779,7 +30779,7 @@ ${hint}
 }
 
 // src/lib/version.ts
-var CLI_VERSION = true ? "2.3.6" : createRequire(import.meta.url)("../../package.json").version;
+var CLI_VERSION = true ? "2.3.8" : createRequire(import.meta.url)("../../package.json").version;
 
 // src/lib/deps.ts
 init_src();
@@ -31821,9 +31821,9 @@ var NodeFsHandler = class {
     if (this.fsw.closed) {
       return;
     }
-    const dirname12 = sysPath.dirname(file);
+    const dirname13 = sysPath.dirname(file);
     const basename9 = sysPath.basename(file);
-    const parent = this.fsw._getWatchedDir(dirname12);
+    const parent = this.fsw._getWatchedDir(dirname13);
     let prevStats = stats;
     if (parent.has(basename9))
       return;
@@ -31850,7 +31850,7 @@ var NodeFsHandler = class {
             prevStats = newStats2;
           }
         } catch (error) {
-          this.fsw._remove(dirname12, basename9);
+          this.fsw._remove(dirname13, basename9);
         }
       } else if (parent.has(basename9)) {
         const at = newStats.atimeMs;
@@ -37218,7 +37218,15 @@ var teamCommand = new Command("team").description("Resolve and persist team comp
 // src/commands/review.ts
 init_src();
 import { join as join28 } from "node:path";
-import { existsSync as existsSync23, readFileSync as readFileSync17 } from "node:fs";
+import {
+  closeSync,
+  existsSync as existsSync23,
+  mkdirSync as mkdirSync8,
+  openSync,
+  readdirSync as readdirSync9,
+  readFileSync as readFileSync17,
+  writeFileSync as writeFileSync9
+} from "node:fs";
 init_db();
 
 // ../shared/config/src/pipeline-config.ts
@@ -37409,6 +37417,11 @@ async function writeRoundArtifact(roundDir, relativePath, content) {
 import { mkdir as mkdir2, readFile, writeFile as writeFile2 } from "node:fs/promises";
 import { existsSync as existsSync21 } from "node:fs";
 import { dirname as dirname10, join as join25 } from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+var execFileAsync = promisify(execFile);
+var GIT_SNAPSHOT_LIMIT = 2e4;
+var REVIEW_SNAPSHOT_EXCLUDES = [".ocr", ".opencode"];
 async function prepareReviewContext(input) {
   const roundDir = join25(input.sessionDir, "rounds", `round-${input.round}`);
   await mkdir2(roundDir, { recursive: true });
@@ -37425,6 +37438,7 @@ async function prepareReviewContext(input) {
     "# Review Context\n\nNo shared review context has been recorded yet.\n"
   );
   const reviewBriefPath = join25(roundDir, "review-brief.md");
+  const gitSnapshot = input.cwd ? await collectGitSnapshot(input.cwd) : void 0;
   await writeFile2(
     reviewBriefPath,
     [
@@ -37434,6 +37448,37 @@ async function prepareReviewContext(input) {
       `Round: ${input.round}`,
       `Discovered standards: ${discoveredStandardsPath}`,
       `Shared context: ${contextPath}`,
+      ...input.cwd ? [`Repository root: ${input.cwd}`] : [],
+      "",
+      "## Scope",
+      "",
+      "Review the current working tree changes. Focus on changed files and the unchanged code needed to validate those changes.",
+      "Ignore local AI tooling/config churn under `.ocr/` and `.opencode/` unless the user explicitly asks to review OCR/OpenCode setup changes.",
+      "",
+      ...gitSnapshot ? [
+        "## Git Status",
+        "",
+        fenced("text", gitSnapshot.status || "No working tree changes reported."),
+        "",
+        "## Changed Files",
+        "",
+        fenced("text", gitSnapshot.changedFiles || "No changed files reported."),
+        "",
+        "## Diff Stat",
+        "",
+        fenced("text", gitSnapshot.diffStat || "No diff stat available."),
+        ""
+      ] : [
+        "## Git Snapshot",
+        "",
+        "No repository snapshot was captured by the CLI.",
+        ""
+      ],
+      "## Reviewer Guidance",
+      "",
+      "- Read this brief first, then inspect relevant changed files and surrounding code as needed.",
+      "- Prefer targeted `git diff -- <path>` and file reads over broad repository scans.",
+      "- Report only findings supported by code evidence and concrete file references.",
       ""
     ].join("\n"),
     "utf-8"
@@ -37478,6 +37523,67 @@ async function prepareReviewContext(input) {
     requirementsExpected: Boolean(requirementsPath)
   };
 }
+async function collectGitSnapshot(cwd) {
+  const [status, cachedFiles, worktreeFiles, diffStat] = await Promise.all([
+    runGit(cwd, ["status", "--short"]),
+    runGit(cwd, ["diff", "--cached", "--name-only", "--", ...gitReviewPathspec()]),
+    runGit(cwd, ["diff", "--name-only", "HEAD", "--", ...gitReviewPathspec()]),
+    runGit(cwd, ["diff", "--stat", "HEAD", "--", ...gitReviewPathspec()])
+  ]);
+  return {
+    status: filterIgnoredStatusLines(status),
+    changedFiles: filterIgnoredPaths(uniqueLines(`${cachedFiles}
+${worktreeFiles}`)),
+    diffStat
+  };
+}
+function gitReviewPathspec() {
+  return [".", ...REVIEW_SNAPSHOT_EXCLUDES.map((path2) => `:(exclude)${path2}`)];
+}
+async function runGit(cwd, args) {
+  try {
+    const { stdout, stderr } = await execFileAsync("git", args, {
+      cwd,
+      maxBuffer: GIT_SNAPSHOT_LIMIT * 2
+    });
+    return truncate(`${stdout}${stderr ? `
+${stderr}` : ""}`.trim());
+  } catch (error) {
+    if (error && typeof error === "object" && "stdout" in error && typeof error.stdout === "string") {
+      return truncate(error.stdout.trim());
+    }
+    return "";
+  }
+}
+function uniqueLines(value) {
+  const lines = value.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+  return [...new Set(lines)].join("\n");
+}
+function filterIgnoredStatusLines(value) {
+  return value.split(/\r?\n/).filter((line) => {
+    const pathPart = line.slice(3).trim();
+    return !isIgnoredReviewPath(pathPart);
+  }).join("\n");
+}
+function filterIgnoredPaths(value) {
+  return value.split(/\r?\n/).filter((line) => !isIgnoredReviewPath(line.trim())).join("\n");
+}
+function isIgnoredReviewPath(path2) {
+  const normalized = path2.replace(/^"|"$/g, "");
+  return REVIEW_SNAPSHOT_EXCLUDES.some(
+    (ignored) => normalized === ignored || normalized.startsWith(`${ignored}/`)
+  );
+}
+function truncate(value) {
+  if (value.length <= GIT_SNAPSHOT_LIMIT) return value;
+  return `${value.slice(0, GIT_SNAPSHOT_LIMIT)}
+[truncated by OCR CLI]`;
+}
+function fenced(language, value) {
+  return `\`\`\`${language}
+${value}
+\`\`\``;
+}
 async function ensureMarkdownFile(path2, fallbackContent) {
   if (existsSync21(path2)) {
     await readFile(path2, "utf-8");
@@ -37554,7 +37660,7 @@ var OpenCodeProcessRunner = class {
   constructor(options = {}) {
     this.spawn = options.spawn ?? spawnBinary;
     this.promptArgvLimit = options.promptArgvLimit ?? DEFAULT_PROMPT_ARGV_LIMIT;
-    this.serveReadyTimeoutMs = options.serveReadyTimeoutMs ?? 15e3;
+    this.serveReadyTimeoutMs = options.serveReadyTimeoutMs ?? 12e4;
     this.pure = options.pure ?? true;
   }
   async run(request, signal) {
@@ -37764,7 +37870,7 @@ function isRecord(value) {
 
 // src/lib/agent-orchestrator/prompt-writer.ts
 import { mkdir as mkdir3, writeFile as writeFile3 } from "node:fs/promises";
-import { join as join26, relative as relative3 } from "node:path";
+import { dirname as dirname11, join as join26, relative as relative3 } from "node:path";
 async function writePromptSnapshots(input) {
   const promptsDir = join26(input.context.roundDir, "prompts");
   const reviewsDir = join26(input.context.roundDir, "reviews");
@@ -37833,6 +37939,7 @@ function reviewerPrompt(context, reviewer, promptPath, reviewPath) {
     "Phase: reviews",
     "",
     "Input files to read before reviewing:",
+    `- ${reviewerPersonaPath(context, reviewer)}`,
     `- ${context.discoveredStandardsPath}`,
     `- ${context.contextPath}`,
     `- ${context.reviewBriefPath}`,
@@ -37846,8 +37953,14 @@ function reviewerPrompt(context, reviewer, promptPath, reviewPath) {
     `  - ${relative3(context.roundDir, context.discoveredStandardsPath)}`,
     `  - ${relative3(context.roundDir, context.contextPath)}`,
     `  - ${relative3(context.roundDir, context.reviewBriefPath)}`,
+    `  - ${relative3(context.roundDir, reviewerPersonaPath(context, reviewer))}`,
     ...context.requirementsPath ? [`  - ${relative3(context.roundDir, context.requirementsPath)}`] : [],
     "",
+    "Review focus:",
+    "- Apply the reviewer persona file as your primary review lens.",
+    "- Use the review brief as the source of truth for changed files and scope.",
+    "- Inspect surrounding source code only when needed to validate a finding.",
+    "",
     "Output contract:",
     `- Return review markdown through stdout for ${reviewPath}.`,
     "- Do not write files directly.",
@@ -37862,6 +37975,10 @@ function reviewerPrompt(context, reviewer, promptPath, reviewPath) {
     ""
   ].join("\n");
 }
+function reviewerPersonaPath(context, reviewer) {
+  const ocrDir = dirname11(dirname11(context.sessionDir));
+  return join26(ocrDir, "skills", "references", "reviewers", `${reviewer.persona}.md`);
+}
 function pipelinePrompt(context, stage, agent, promptPath, artifactPath) {
   return [
     `# Pipeline Agent: ${stage}`,
@@ -37938,6 +38055,18 @@ async function runReviewerPhase(input) {
     };
   });
   const requests = reviewerRequests.map((item) => item.request);
+  const running = new Set(requests.map((request) => request.id));
+  const completed = /* @__PURE__ */ new Set();
+  const progressTimer = setInterval(() => {
+    emit({
+      event: "reviews:progress",
+      phase: "reviews",
+      completed: completed.size,
+      total: requests.length,
+      running: [...running].sort()
+    });
+  }, 15e3);
+  progressTimer.unref?.();
   const promises = reviewerRequests.map(async ({ reviewer, request }) => {
     const agentSessionId = await journal.startInstance({
       workflowId: input.context.sessionId,
@@ -37959,6 +38088,8 @@ async function runReviewerPhase(input) {
     });
     const result = await input.runner.run(request, controller.signal);
     const logPaths = await writeProcessLogs(input.context.roundDir, request, result);
+    running.delete(request.id);
+    completed.add(request.id);
     emit({
       event: "agent:complete",
       phase: "reviews",
@@ -37977,15 +38108,19 @@ async function runReviewerPhase(input) {
     return result;
   });
   const results = [];
-  await Promise.all(
-    promises.map(async (promise) => {
-      const result = await promise;
-      results.push(result);
-      if (result.exitCode !== 0) {
-        controller.abort();
-      }
-    })
-  );
+  try {
+    await Promise.all(
+      promises.map(async (promise) => {
+        const result = await promise;
+        results.push(result);
+        if (result.exitCode !== 0) {
+          controller.abort();
+        }
+      })
+    );
+  } finally {
+    clearInterval(progressTimer);
+  }
   const failed = results.find((result) => result.exitCode !== 0);
   if (failed) {
     const failedRequest = requests.find((request) => request.id === failed.id);
@@ -38052,7 +38187,8 @@ async function runOpenCodeProcessAgentReview(input) {
       sessionId: input.sessionId,
       sessionDir: input.sessionDir,
       round: input.round,
-      requirements: input.requirements
+      requirements: input.requirements,
+      cwd: input.cwd
     });
     const snapshot = await writePromptSnapshots({
       context,
@@ -38065,7 +38201,12 @@ async function runOpenCodeProcessAgentReview(input) {
       round: input.round,
       reviewers: snapshot.resolvedTeam.reviewers.length
     });
-    emit({ event: "reviews:start", session_id: input.sessionId, round: input.round });
+    emit({
+      event: "reviews:start",
+      session_id: input.sessionId,
+      round: input.round,
+      reviewers: snapshot.resolvedTeam.reviewers.length
+    });
     const reviewerResult = await runReviewerPhase({
       context,
       resolvedTeam: snapshot.resolvedTeam,
@@ -38159,7 +38300,21 @@ async function runPipelineStages(input) {
       prompt_path: request.promptPath,
       meta_log: startLogPaths.meta
     });
-    const result = await input.runner.run(request, new AbortController().signal);
+    const progressTimer = setInterval(() => {
+      emit({
+        event: "agent:progress",
+        phase: stage,
+        id: request.id,
+        status: "running"
+      });
+    }, 15e3);
+    progressTimer.unref?.();
+    let result;
+    try {
+      result = await input.runner.run(request, new AbortController().signal);
+    } finally {
+      clearInterval(progressTimer);
+    }
     const logPaths = await writeProcessLogs(input.context.roundDir, request, result);
     emit({
       event: "agent:complete",
@@ -38254,6 +38409,9 @@ async function writeProcessLogs(roundDir, request, result) {
   const stdoutPath = `${prefix}.stdout.ndjson`;
   const stderrPath = `${prefix}.stderr.log`;
   const metaPath = `${prefix}.meta.json`;
+  const absoluteMetaPath = join27(roundDir, metaPath);
+  const startedAt = readStartedAt(absoluteMetaPath) ?? (/* @__PURE__ */ new Date()).toISOString();
+  const completedAt = (/* @__PURE__ */ new Date()).toISOString();
   await writeRoundArtifact(roundDir, stdoutPath, result.stdout);
   await writeRoundArtifact(roundDir, stderrPath, result.stderr);
   await writeRoundArtifact(
@@ -38267,7 +38425,9 @@ async function writeProcessLogs(roundDir, request, result) {
         model: request.model,
         prompt_path: request.promptPath,
         status: "completed",
-        completed_at: (/* @__PURE__ */ new Date()).toISOString(),
+        started_at: startedAt,
+        completed_at: completedAt,
+        duration_ms: Math.max(0, Date.parse(completedAt) - Date.parse(startedAt)),
         exit_code: result.exitCode,
         output_text_bytes: Buffer.byteLength(processOutput(result), "utf-8"),
         stdout_bytes: Buffer.byteLength(result.stdout, "utf-8"),
@@ -38280,6 +38440,16 @@ async function writeProcessLogs(roundDir, request, result) {
   );
   return { stdout: stdoutPath, stderr: stderrPath, meta: metaPath };
 }
+function readStartedAt(path2) {
+  if (!existsSync22(path2)) return void 0;
+  try {
+    const parsed = JSON.parse(readFileSync16(path2, "utf-8"));
+    if (!isRecord2(parsed)) return void 0;
+    return typeof parsed.started_at === "string" ? parsed.started_at : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function processOutput(result) {
   return result.outputText ?? result.stdout;
 }
@@ -38418,12 +38588,15 @@ function newSessionId() {
   const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   return `${date}-opencode-process-review-${Date.now()}`;
 }
-var runAgentsSubcommand = new Command("run-agents").description("Run OCR review through OpenCode process agents").argument("[target]", "Target path for fresh dashboard mode", ".").option("--session-id <workflow-session-id>", "Prepared workflow session id").option("--round <n>", "Prepared round number", (value) => Number.parseInt(value, 10)).option("--fresh", "Create a fresh workflow session before running process agents").option("--requirements <text-or-path>", "Inline requirements text or path to a requirements file").option("--team <json>", "JSON ReviewerInstance[] override for this run").action(
+var runAgentsSubcommand = new Command("run-agents").description("Run OCR review through OpenCode process agents").argument("[target]", "Target path for fresh dashboard mode", ".").option("--session-id <workflow-session-id>", "Prepared workflow session id").option("--round <n>", "Prepared round number", (value) => Number.parseInt(value, 10)).option("--fresh", "Create a fresh workflow session before running process agents").option("--requirements <text-or-path>", "Inline requirements text or path to a requirements file").option("--team <json>", "JSON ReviewerInstance[] override for this run").option("--foreground", "Run in the current process instead of detaching a background worker").addOption(new Option("--worker", "Internal detached worker mode").hideHelp()).action(
   async (target, options) => {
     const targetDir = process.cwd();
     requireOcrSetup(targetDir);
     const ocrDir = join28(targetDir, ".ocr");
     const db = await ensureDatabase(ocrDir);
+    let sessionDirForMeta;
+    let roundForMeta;
+    const modeForMeta = options.worker ? "worker" : options.foreground ? "foreground" : "detached";
     try {
       let sessionId = options.sessionId;
       let round = options.round;
@@ -38454,6 +38627,33 @@ var runAgentsSubcommand = new Command("run-agents").description("Run OCR review
         round = round ?? session.current_round;
         sessionDir = session.session_dir;
       }
+      sessionDirForMeta = sessionDir;
+      roundForMeta = round;
+      if (!options.foreground && !options.worker) {
+        const spawned = spawnDetachedRunAgents({
+          targetDir,
+          target,
+          sessionId,
+          sessionDir,
+          round,
+          requirements: options.requirements,
+          team: options.team
+        });
+        console.log(`OCR review started in background.`);
+        console.log(`Session: ${sessionId}`);
+        console.log(`Round: ${round}`);
+        console.log(`PID: ${spawned.pid}`);
+        console.log(`Progress: ocr review watch --session-id ${sessionId}`);
+        console.log(`Status: ocr review status --session-id ${sessionId}`);
+        console.log(`Artifacts: ${sessionDir}`);
+        return;
+      }
+      writeRunMeta(sessionDir, round, {
+        status: "running",
+        mode: options.worker ? "worker" : "foreground",
+        pid: process.pid,
+        started_at: (/* @__PURE__ */ new Date()).toISOString()
+      });
       const { team } = loadTeamConfig(ocrDir);
       const override = options.team ? parseTeamOverride(options.team) : void 0;
       const reviewers = resolveTeamComposition(team, override);
@@ -38467,18 +38667,226 @@ var runAgentsSubcommand = new Command("run-agents").description("Run OCR review
         pipelineAgents,
         requirements: readRequirements(options.requirements),
         journal: new PersistenceAgentLifecycleJournal(ocrDir),
-        emit: (event) => console.log(JSON.stringify(event))
+        emit: (event) => {
+          console.log(JSON.stringify(event));
+          renderRunAgentsProgress(event);
+        }
       });
       if (!result.ok) {
+        writeRunMeta(sessionDir, round, {
+          status: "failed",
+          mode: options.worker ? "worker" : "foreground",
+          pid: process.pid,
+          completed_at: (/* @__PURE__ */ new Date()).toISOString(),
+          errors: result.errors
+        });
         for (const error of result.errors) console.error(source_default.red(error));
         process.exit(1);
       }
+      writeRunMeta(sessionDir, round, {
+        status: "completed",
+        mode: options.worker ? "worker" : "foreground",
+        pid: process.pid,
+        completed_at: (/* @__PURE__ */ new Date()).toISOString()
+      });
       console.log(JSON.stringify({ event: "review:complete", session_id: sessionId, round }));
     } catch (error) {
+      if (sessionDirForMeta && roundForMeta) {
+        writeRunMeta(sessionDirForMeta, roundForMeta, {
+          status: "failed",
+          mode: modeForMeta,
+          pid: process.pid,
+          completed_at: (/* @__PURE__ */ new Date()).toISOString(),
+          errors: [error instanceof Error ? error.message : "Failed to run OpenCode process-agent review"]
+        });
+      }
       fail3(error instanceof Error ? error.message : "Failed to run OpenCode process-agent review");
     }
   }
 );
+var statusSubcommand2 = new Command("status").description("Show process-agent review status").requiredOption("--session-id <workflow-session-id>", "Workflow session id").option("--round <n>", "Round number", (value) => Number.parseInt(value, 10)).action(async (options) => {
+  const targetDir = process.cwd();
+  requireOcrSetup(targetDir);
+  const ocrDir = join28(targetDir, ".ocr");
+  const db = await ensureDatabase(ocrDir);
+  const session = getSession(db, options.sessionId);
+  if (!session) fail3(`Workflow session not found: ${options.sessionId}`);
+  renderReviewStatus(session.session_dir, options.round ?? session.current_round);
+});
+var watchSubcommand = new Command("watch").description("Watch process-agent review progress").requiredOption("--session-id <workflow-session-id>", "Workflow session id").option("--round <n>", "Round number", (value) => Number.parseInt(value, 10)).option("--interval <seconds>", "Refresh interval", (value) => Number.parseInt(value, 10), 2).action(async (options) => {
+  const targetDir = process.cwd();
+  requireOcrSetup(targetDir);
+  const ocrDir = join28(targetDir, ".ocr");
+  const db = await ensureDatabase(ocrDir);
+  const session = getSession(db, options.sessionId);
+  if (!session) fail3(`Workflow session not found: ${options.sessionId}`);
+  const round = options.round ?? session.current_round;
+  renderReviewStatus(session.session_dir, round);
+  setInterval(() => {
+    process.stdout.write("\x1Bc");
+    renderReviewStatus(session.session_dir, round);
+  }, Math.max(1, options.interval) * 1e3);
+});
+function spawnDetachedRunAgents(input) {
+  const roundDir = join28(input.sessionDir, "rounds", `round-${input.round}`);
+  mkdirSync8(join28(roundDir, "process-logs"), { recursive: true });
+  const stdoutPath = join28(roundDir, "process-logs", "run-agents-worker.stdout.log");
+  const stderrPath = join28(roundDir, "process-logs", "run-agents-worker.stderr.log");
+  const outFd = openSync(stdoutPath, "a");
+  const errFd = openSync(stderrPath, "a");
+  const entrypoint = process.argv[1];
+  if (!entrypoint) fail3("Cannot locate OCR CLI entrypoint for background worker.");
+  const args = [
+    entrypoint,
+    "review",
+    "run-agents",
+    input.target,
+    "--session-id",
+    input.sessionId,
+    "--round",
+    String(input.round),
+    "--worker",
+    "--foreground",
+    ...input.requirements ? ["--requirements", input.requirements] : [],
+    ...input.team ? ["--team", input.team] : []
+  ];
+  const child = spawnBinary(process.execPath, args, {
+    cwd: input.targetDir,
+    detached: true,
+    stdio: ["ignore", outFd, errFd]
+  });
+  child.unref();
+  closeSync(outFd);
+  closeSync(errFd);
+  writeRunMeta(input.sessionDir, input.round, {
+    status: "spawned",
+    mode: "detached",
+    pid: child.pid,
+    started_at: (/* @__PURE__ */ new Date()).toISOString(),
+    stdout_log: stdoutPath,
+    stderr_log: stderrPath
+  });
+  return { pid: child.pid };
+}
+function writeRunMeta(sessionDir, round, patch) {
+  const roundDir = join28(sessionDir, "rounds", `round-${round}`);
+  mkdirSync8(roundDir, { recursive: true });
+  const path2 = join28(roundDir, "run-meta.json");
+  let current = { schema_version: 1 };
+  if (existsSync23(path2)) {
+    try {
+      const parsed = JSON.parse(readFileSync17(path2, "utf-8"));
+      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        current = parsed;
+      }
+    } catch {
+      current = { schema_version: 1 };
+    }
+  }
+  writeFileSync9(path2, JSON.stringify({ ...current, ...patch }, null, 2), "utf-8");
+}
+function renderReviewStatus(sessionDir, round) {
+  const roundDir = join28(sessionDir, "rounds", `round-${round}`);
+  const processLogsDir = join28(roundDir, "process-logs");
+  const runMeta = readJson(join28(roundDir, "run-meta.json"));
+  console.log(source_default.bold(`OCR review status: ${sessionDir}`));
+  console.log(`Round: ${round}`);
+  if (runMeta) {
+    const pid = typeof runMeta.pid === "number" ? runMeta.pid : void 0;
+    console.log(
+      `Runner: ${String(runMeta.status ?? "unknown")}${pid ? ` pid=${pid} live=${isPidLive(pid) ? "yes" : "no"}` : ""}`
+    );
+  }
+  const metas = existsSync23(processLogsDir) ? readdirMetaFiles(processLogsDir).map((path2) => readJson(path2)).filter(isRecord3) : [];
+  const reviewers = metas.filter((meta) => meta.phase === "reviews");
+  const completedReviewers = reviewers.filter((meta) => meta.status === "completed");
+  const runningReviewers = reviewers.filter((meta) => meta.status === "running");
+  console.log(`Reviews: ${completedReviewers.length}/${reviewers.length || "?"} complete`);
+  if (runningReviewers.length > 0) {
+    console.log(`Running reviewers: ${runningReviewers.map((meta) => meta.id).join(", ")}`);
+  }
+  for (const phase of ["aggregation", "validation", "synthesis"]) {
+    const meta = metas.find((item) => item.id === phase);
+    console.log(`Pipeline ${phase}: ${String(meta?.status ?? "pending")}`);
+  }
+  if (existsSync23(join28(roundDir, "final.md"))) {
+    console.log(source_default.green(`Final: ${join28(roundDir, "final.md")}`));
+  }
+}
+function readdirMetaFiles(dir) {
+  return existsSync23(dir) ? Array.from(new Set(readdirSync9(dir))).filter((name) => name.endsWith(".meta.json")).sort().map((name) => join28(dir, name)) : [];
+}
+function readJson(path2) {
+  if (!existsSync23(path2)) return void 0;
+  try {
+    const parsed = JSON.parse(readFileSync17(path2, "utf-8"));
+    return isRecord3(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function isPidLive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function renderRunAgentsProgress(event) {
+  const name = typeof event.event === "string" ? event.event : "";
+  if (name === "reviews:start") {
+    console.error(
+      source_default.cyan(
+        `OCR reviewers started: ${String(event.reviewers ?? "?")} agents running in parallel.`
+      )
+    );
+    return;
+  }
+  if (name === "agent:start") {
+    console.error(
+      source_default.dim(
+        `OCR agent started: ${String(event.id ?? "?")} (${String(event.phase ?? "?")}, ${String(event.model ?? "?")})`
+      )
+    );
+    return;
+  }
+  if (name === "reviews:progress") {
+    const running = Array.isArray(event.running) ? event.running.join(", ") : "?";
+    console.error(
+      source_default.cyan(
+        `OCR reviews progress: ${String(event.completed ?? "?")}/${String(event.total ?? "?")} complete; running: ${running || "none"}`
+      )
+    );
+    return;
+  }
+  if (name === "agent:complete") {
+    console.error(
+      source_default.green(
+        `OCR agent completed: ${String(event.id ?? "?")} exit=${String(event.exit_code ?? "?")}`
+      )
+    );
+    return;
+  }
+  if (name === "agent:progress") {
+    console.error(
+      source_default.cyan(
+        `OCR agent still running: ${String(event.id ?? "?")} (${String(event.phase ?? "?")})`
+      )
+    );
+    return;
+  }
+  if (name === "pipeline:start") {
+    console.error(source_default.cyan("OCR pipeline started: aggregation -> validation -> synthesis."));
+    return;
+  }
+  if (name === "pipeline:complete") {
+    console.error(source_default.green("OCR pipeline complete."));
+  }
+}
 var CONTROL_PROMPT = "Resume this OCR review: run `ocr state status --json` and act on `next_action`, continuing forward from `current_phase` without redoing completed phases.";
 var reviewCommand = new Command("review").description("Run or resume an OCR review").option("--resume <workflow-id>", "Resume a prior review by its workflow session id").action(async (options) => {
   if (!options.resume) {
@@ -38599,6 +39007,8 @@ var reviewCommand = new Command("review").description("Run or resume an OCR revi
   });
 });
 reviewCommand.addCommand(runAgentsSubcommand);
+reviewCommand.addCommand(statusSubcommand2);
+reviewCommand.addCommand(watchSubcommand);
 
 // src/commands/update.ts
 import { existsSync as existsSync24 } from "node:fs";
@@ -38760,12 +39170,12 @@ var updateCommand = new Command("update").description("Update OCR assets after p
 
 // src/commands/dashboard.ts
 import { existsSync as existsSync25 } from "node:fs";
-import { join as join30, dirname as dirname11 } from "node:path";
+import { join as join30, dirname as dirname12 } from "node:path";
 import { fileURLToPath } from "node:url";
 init_src();
 init_db();
 var __filename = fileURLToPath(import.meta.url);
-var __dirname = dirname11(__filename);
+var __dirname = dirname12(__filename);
 function resolveServerPath() {
   return join30(__dirname, "dashboard", "server.js");
 }
@@ -39285,7 +39695,7 @@ var pruneBackupsSubcommand = new Command("prune-backups").description("Delete ol
 var dbCommand = new Command("db").description("Inspect and maintain the OCR SQLite database").addCommand(doctorSubcommand).addCommand(vacuumSubcommand).addCommand(pruneSubcommand).addCommand(pruneBackupsSubcommand);
 
 // src/commands/reviewers.ts
-import { writeFileSync as writeFileSync9, renameSync as renameSync2 } from "node:fs";
+import { writeFileSync as writeFileSync10, renameSync as renameSync2 } from "node:fs";
 import { join as join33 } from "node:path";
 init_src();
 async function readStdin3() {
@@ -39394,7 +39804,7 @@ var syncSubcommand2 = new Command("sync").description("Sync reviewers-meta.json
       }
       const metaPath = join33(ocrDir, "reviewers-meta.json");
       const tmpPath = metaPath + ".tmp";
-      writeFileSync9(tmpPath, JSON.stringify(meta, null, 2) + "\n");
+      writeFileSync10(tmpPath, JSON.stringify(meta, null, 2) + "\n");
       renameSync2(tmpPath, metaPath);
       const tierCounts = meta.reviewers.reduce(
         (acc, r) => {
@@ -39424,7 +39834,7 @@ var syncSubcommand2 = new Command("sync").description("Sync reviewers-meta.json
     const meta = validateReviewersMeta(parsed);
     const metaPath = join33(ocrDir, "reviewers-meta.json");
     const tmpPath = metaPath + ".tmp";
-    writeFileSync9(tmpPath, JSON.stringify(meta, null, 2) + "\n");
+    writeFileSync10(tmpPath, JSON.stringify(meta, null, 2) + "\n");
     renameSync2(tmpPath, metaPath);
     const tierCounts = meta.reviewers.reduce(
       (acc, r) => {
@@ -39499,7 +39909,7 @@ var hostCommand = new Command("host").description("Inspect host (AI CLI) capabil
 // src/lib/update-check.ts
 import { homedir } from "node:os";
 import { join as join34 } from "node:path";
-import { readFileSync as readFileSync19, writeFileSync as writeFileSync10, mkdirSync as mkdirSync8 } from "node:fs";
+import { readFileSync as readFileSync19, writeFileSync as writeFileSync11, mkdirSync as mkdirSync9 } from "node:fs";
 var PACKAGE_NAME = "@open-code-review/cli";
 var REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
 var CACHE_DIR2 = join34(homedir(), ".ocr");
@@ -39515,8 +39925,8 @@ function readCache(cacheFile) {
 }
 function writeCache(cacheFile, cache2) {
   try {
-    mkdirSync8(join34(cacheFile, ".."), { recursive: true });
-    writeFileSync10(cacheFile, JSON.stringify(cache2));
+    mkdirSync9(join34(cacheFile, ".."), { recursive: true });
+    writeFileSync11(cacheFile, JSON.stringify(cache2));
   } catch {
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nk070281sjv/cli",
-  "version": "2.3.6",
+  "version": "2.3.8",
   "description": "CLI for Open Code Review - Multi-environment setup and progress tracking",
   "type": "module",
   "bin": {
@@ -37,7 +37,7 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^7.2.0",
-    "@nk070281sjv/agents": "2.3.6",
+    "@nk070281sjv/agents": "2.3.8",
     "chalk": "^5.4.1",
     "chokidar": "^4.0.3",
     "commander": "^13.0.0",