@nk070281sjv/cli 2.3.16 → 2.3.18

package/README.md

@@ -83,6 +83,12 @@ as a Ukrainian human-readable copy; translation failure is logged without
 invalidating the completed English review.
 If any configured reviewer or pipeline model is missing or any process fails,
 the round stops instead of continuing with a partial team or fabricated output.
+For normal OpenCode use, run `ocr review run-agents --fresh` without
+`--background`; the command keeps the shell call active, prints progress, and
+returns only when the review is completed or failed.
+If a parent tool regains control while the review is still running, use
+`ocr review wait --session-id <id>` to block until completion instead of
+returning a mid-run summary.
 
 ## Commands
 
@@ -167,6 +173,7 @@ by the dashboard or installed `/ocr-review` command, not typed by hand.
 ```bash
 ocr review run-agents --session-id <session-id> --round <n>
 ocr review run-agents [target] --fresh --requirements <text-or-path> --team <json>
+ocr review wait --session-id <session-id>
 ```
 
 This path owns process spawning and artifact writing. Agents return stdout and

package/dist/index.js

@@ -30779,7 +30779,7 @@ ${hint}
 }
 
 // src/lib/version.ts
-var CLI_VERSION = true ? "2.3.16" : createRequire(import.meta.url)("../../package.json").version;
+var CLI_VERSION = true ? "2.3.18" : createRequire(import.meta.url)("../../package.json").version;
 
 // src/lib/deps.ts
 init_src();
@@ -39038,7 +39038,7 @@ 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").option("--foreground", "Run in the current process instead of detaching a background worker").option("--background", "Start the background worker and return; intended for external polling").addOption(new Option("--worker", "Internal detached worker mode").hideHelp()).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").option("--background", "Detach and return immediately; not for normal OpenCode UI progress").addOption(new Option("--worker", "Internal detached worker mode").hideHelp()).action(
   async (target, options) => {
     const targetDir = process.cwd();
     requireOcrSetup(targetDir);
@@ -39067,7 +39067,7 @@ var runAgentsSubcommand = new Command("run-agents").description("Run OCR review
           throw new Error(
             [
               "run-agents requires either --fresh or --session-id.",
-              "Start a new OpenCode process-agent review with: ocr review run-agents --fresh --background",
+              "Start a new OpenCode process-agent review with: ocr review run-agents --fresh",
               "Resume a prepared workflow round with: ocr review run-agents --session-id <id> --round <n>"
             ].join("\n")
           );
@@ -39097,6 +39097,7 @@ var runAgentsSubcommand = new Command("run-agents").description("Run OCR review
         console.log(`Status: ocr review status --session-id ${sessionId}`);
         console.log(`Artifacts: ${sessionDir}`);
         if (options.background) {
+          console.log("Detached mode: this command is returning now. OpenCode UI will not show live progress unless the parent keeps polling status.");
           return;
         }
         console.log("Monitoring background review until it finishes. If OpenCode stops waiting, the background review continues.");
@@ -39183,6 +39184,16 @@ var watchSubcommand = new Command("watch").description("Watch process-agent revi
     renderReviewStatus(session.session_dir, round);
   }, Math.max(1, options.interval) * 1e3);
 });
+var waitSubcommand = new Command("wait").description("Block until a process-agent review completes or fails").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}`);
+  const exitCode = await waitForDetachedRun(session.session_dir, options.round ?? session.current_round);
+  process.exit(exitCode);
+});
 function spawnDetachedRunAgents(input) {
   const roundDir = join28(input.sessionDir, "rounds", `round-${input.round}`);
   mkdirSync8(join28(roundDir, "process-logs"), { recursive: true });
@@ -39540,6 +39551,7 @@ var reviewCommand = new Command("review").description("Run or resume an OCR revi
 reviewCommand.addCommand(runAgentsSubcommand);
 reviewCommand.addCommand(statusSubcommand2);
 reviewCommand.addCommand(watchSubcommand);
+reviewCommand.addCommand(waitSubcommand);
 
 // src/commands/update.ts
 import { existsSync as existsSync24 } from "node:fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nk070281sjv/cli",
-  "version": "2.3.16",
+  "version": "2.3.18",
   "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.16",
+    "@nk070281sjv/agents": "2.3.18",
     "chalk": "^5.4.1",
     "chokidar": "^4.0.3",
     "commander": "^13.0.0",