@tryarcanist/cli 0.1.214 → 0.1.216

package/dist/index.js

@@ -582,9 +582,10 @@ function assertArcanistSessionMutationAllowed(subcommand) {
       }
     );
   }
+  const commandName = subcommand === "review" ? "review" : `sessions ${subcommand}`;
   throw new CliError(
     "user",
-    `\`arcanist sessions ${subcommand}\` is disabled inside ${role} sessions because nested Arcanist sessions are not observable to read-only agents.`,
+    `\`arcanist ${commandName}\` is disabled inside ${role} sessions because nested Arcanist work is not observable to read-only agents.`,
     {
       hint: "Use direct local/sandbox evidence instead, or report a verification gap rather than spawning another Arcanist session."
     }
@@ -4674,6 +4675,54 @@ function parseRespondConflict(err) {
   }
 }
 
+// src/commands/review.ts
+var PR_REVIEW_POLL_INTERVAL_MS = 1e4;
+var PR_REVIEW_WAIT_TIMEOUT_MS = 30 * 60 * 1e3;
+async function reviewCommand(prUrl, options = {}, command) {
+  assertArcanistSessionMutationAllowed("review");
+  const { config } = resolveBusinessContext(command, options);
+  const trigger = await apiFetch(config, "/api/pr-reviews", {
+    method: "POST",
+    body: JSON.stringify({ prUrl, ...options.focus ? { focus: options.focus } : {} })
+  });
+  if (!options.wait || trigger.cached) {
+    emit(command, options, trigger, (payload) => {
+      if (payload.cached) console.log(`Zeus review already completed: ${payload.verdict ?? "unknown"}.`);
+      else console.log(`Started Zeus review${payload.sessionId ? ` (${payload.sessionId})` : ""}.`);
+    });
+    return;
+  }
+  const result = await waitForReview(config, prUrl, trigger.sessionId ?? null);
+  emit(command, options, result, (payload) => {
+    console.log(`Zeus review: ${sanitizeTerminalText(payload.verdict)}. ${payload.findings.length} finding(s).`);
+    for (const finding of payload.findings) {
+      console.log(
+        `${sanitizeTerminalText(finding.severity)} ${sanitizeTerminalText(finding.file)}:${finding.line} - ${sanitizeTerminalText(finding.title)}`
+      );
+    }
+  });
+}
+function sanitizeTerminalText(value) {
+  return value.replace(/\u001b\][^\u0007]*(?:\u0007|\u001b\\)/g, "").replace(/\u001b\[[0-?]*[ -/]*[@-~]/g, "").replace(/[\u0000-\u001f\u007f]/g, "");
+}
+async function waitForReview(config, prUrl, sessionId) {
+  const deadline = Date.now() + PR_REVIEW_WAIT_TIMEOUT_MS;
+  while (Date.now() < deadline) {
+    const status = await apiFetch(
+      config,
+      `/api/pr-reviews/status?prUrl=${encodeURIComponent(prUrl)}`
+    );
+    if (status.status === "completed") {
+      if (sessionId && status.sessionId !== sessionId) {
+        throw new CliError("conflict", "PR review completed for a different attempt; retry the command.");
+      }
+      return { ...status, sessionId: status.sessionId ?? sessionId };
+    }
+    await new Promise((resolve2) => setTimeout(resolve2, PR_REVIEW_POLL_INTERVAL_MS));
+  }
+  throw new CliError("server", "Timed out waiting for Zeus review results.");
+}
+
 // src/commands/sandbox.ts
 import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
 import { dirname as dirname2 } from "path";
@@ -6308,6 +6357,16 @@ cursor.command("use <state>").description("Turn using your saved Cursor subscrip
 cursor.command("status").description("Show whether your workspace is eligible and whether a Cursor subscription auth is saved").action((options, command) => agentSubscriptionStatusCommand(CURSOR_SUBSCRIPTION_CLI_CONFIG, options, command));
 cursor.command("logout").description("Deactivate the selector and remove the stored Cursor subscription auth for your user").action((options, command) => agentSubscriptionLogoutCommand(CURSOR_SUBSCRIPTION_CLI_CONFIG, options, command));
 var sessions = program.command("sessions").description("Session commands");
+program.command("review <pr-url>").description("Run a Zeus review for a GitHub pull request").option("--focus <text>", "Focus the review on a specific concern").option("--wait", "Wait for the review and print its verdict and findings").addHelpText(
+  "after",
+  `
+Examples:
+  arcanist review https://github.com/org/repo/pull/123 --wait --json
+  arcanist review https://github.com/org/repo/pull/123 --focus "Check auth" --wait
+
+Zeus review is currently available to Arcanist members only.
+`
+).action((prUrl, options, command) => reviewCommand(prUrl, options, command));
 addCreateOptions(sessions.command("create").description("Create a session and send a prompt")).action(
   (repoUrl, prompt, options, command) => createCommand(repoUrl, prompt, options, command)
 );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryarcanist/cli",
-  "version": "0.1.214",
+  "version": "0.1.216",
   "description": "CLI for Arcanist — create and manage coding agent sessions",
   "type": "module",
   "bin": {