@tryarcanist/cli 0.1.181 → 0.1.183

package/README.md

@@ -150,6 +150,7 @@ printf "add tests" | arcanist sessions create your-org/your-repo --prompt-stdin
 arcanist sessions create your-org/your-repo - --model gpt-5.5
 arcanist sessions create your-org/your-repo "port to claude" --backend claude_code --model claude-opus-4-8
 arcanist sessions create your-org/your-repo "refactor auth" --reasoning-effort xhigh
+arcanist sessions create your-org/your-repo "verify this automatically" --auto-verify
 arcanist sessions create your-org/your-repo "fix release branch" --base-branch release/2026-06
 arcanist sessions create your-org/your-repo "review the trace" --uploaded-file trace.txt
 arcanist sessions create your-org/your-repo "verify the deployed change" --cold
@@ -160,6 +161,8 @@ arcanist sessions create your-org/your-repo "retry-safe create" --idempotency-ke
 
 `--wait` blocks until the created prompt finishes, prints the resulting PR/branch line in human-readable mode when it is already available, and exits non-zero if the prompt finishes with `status: failed`, making it suitable for cron or other schedulers that alert on command failure. JSON mode waits quietly and prints the create payload after the prompt completes successfully. `--poll-interval <ms>` tunes the completion check frequency.
 
+Use `--auto-verify` to opt the created session into automatic QA verification after PR creation. Auto verification is default-off at session create unless another surface explicitly enables it.
+
 Use `--base-branch <branch>` to target a non-default base branch. The CLI only validates that the branch value is non-empty; branch existence is checked later by the session runtime.
 
 Use `--start-branch <branch>` to resume an existing branch with its history instead of forking a fresh branch off base; the control plane verifies the branch exists on the remote and fails closed if it does not.
@@ -175,7 +178,7 @@ The CLI derives separate session and prompt idempotency keys from the provided v
 
 `--onboarding` creates an onboarding session: the agent authors the repo's `.arcanist.json`, `.arcanist/` runtime files, `ARCANIST.md`, and conditionally `.arcanist/sandbox.yaml` + `.arcanist/sandbox.layer.Dockerfile` (when the base sandbox lacks a needed toolchain), proves what it can inside its sandbox, and opens the setup PR ready for review. The onboarding behavior is driven by the bridge's canonical onboarding playbook, not the prompt, so `--onboarding` needs no prompt: `arcanist sessions create <repo> --onboarding --wait`. Any prompt supplied alongside `--onboarding` is ignored. Team use; not part of the external API surface.
 
-JSON mode returns `{sessionId, sessionUrl?, repoUrl, model?, agentRuntimeBackend?, reasoningEffort?, baseBranch?, startBranch?, continuePrUrl?, continueMode?, onboarding?, promptId?}`. `sessionUrl` is emitted only when the server returns it; `agentRuntimeBackend` only when `--backend` is passed. With `--wait`, JSON mode also includes best-effort result fields when available: `prUrl?`, `publishedBranch?`, and `lastBranch?`.
+JSON mode returns `{sessionId, sessionUrl?, repoUrl, model?, agentRuntimeBackend?, reasoningEffort?, autoVerify?, baseBranch?, startBranch?, continuePrUrl?, continueMode?, onboarding?, promptId?}`. `sessionUrl` is emitted only when the server returns it; `agentRuntimeBackend` only when `--backend` is passed. With `--wait`, JSON mode also includes best-effort result fields when available: `prUrl?`, `publishedBranch?`, and `lastBranch?`.
 
 ### `arcanist sessions qa <pr-url>`
 

package/dist/index.js

@@ -1212,6 +1212,9 @@ var TERMINAL_FOR_FALLBACK_POLLING_PHASES = new Set(
 var CHILD_SLOT_RELEASE_PHASES = new Set(
   TERMINAL_PHASES_ARRAY.filter((phase) => phase !== "stopped")
 );
+var ARCHIVABLE_STALE_TERMINAL_PHASES_ARRAY = TERMINAL_PHASES_ARRAY.filter(
+  (phase) => phase !== "archived" && phase !== "blocked" && phase !== "stopped"
+);
 function isTerminalPhase(phase, _sessionKind) {
   return TERMINAL_PHASES.has(phase);
 }
@@ -3084,6 +3087,7 @@ async function createCommand(repoUrl, promptArg, options, command) {
   if (options.model) body.model = options.model;
   if (options.backend) body.agentRuntimeBackend = agentRuntimeBackend;
   if (options.reasoningEffort) body.reasoningEffort = options.reasoningEffort;
+  if (options.autoVerify) body.autoVerify = true;
   const promptPreview = buildSessionCreatePromptPreview(prompt);
   if (promptPreview) body.prompt = promptPreview;
   if (baseBranch) body.baseBranch = baseBranch;
@@ -3156,6 +3160,7 @@ async function createCommand(repoUrl, promptArg, options, command) {
     if (options.model) output.model = options.model;
     if (options.backend) output.agentRuntimeBackend = agentRuntimeBackend;
     if (options.reasoningEffort) output.reasoningEffort = options.reasoningEffort;
+    if (options.autoVerify) output.autoVerify = true;
     if (baseBranch) output.baseBranch = baseBranch;
     if (startBranch) output.startBranch = startBranch;
     if (continuePr) output.continuePrUrl = continuePr;
@@ -4349,22 +4354,43 @@ function buildLogsPath(businessId, buildId, options = {}) {
     buildId
   )}/logs${suffix}`;
 }
+async function fetchAndEmitBuildLogs(config, businessId, buildId, options) {
+  const logs = await apiFetch(
+    config,
+    buildLogsPath(businessId, buildId, { afterSequence: options.afterSequence, limit: options.limit })
+  );
+  if (logs.logs.length === 0) return { afterSequence: options.afterSequence, count: 0 };
+  if (options.json) writeJson({ type: "logs", logs: logs.logs });
+  else printLogs(logs.logs);
+  return { afterSequence: logs.logs[logs.logs.length - 1].sequence, count: logs.logs.length };
+}
+async function drainTerminalBuildLogs(config, businessId, buildId, options) {
+  let afterSequence = options.afterSequence;
+  for (; ; ) {
+    const result = await fetchAndEmitBuildLogs(config, businessId, buildId, {
+      afterSequence,
+      limit: 500,
+      json: options.json
+    });
+    afterSequence = result.afterSequence;
+    if (result.count === 0) return;
+  }
+}
 async function waitForBuild(config, businessId, buildId, options) {
   let afterSequence;
   for (; ; ) {
     if (options.follow) {
-      const logs = await apiFetch(config, buildLogsPath(businessId, buildId, { afterSequence }));
-      if (logs.logs.length > 0) {
-        if (options.json) writeJson({ type: "logs", logs: logs.logs });
-        else printLogs(logs.logs);
-        afterSequence = logs.logs[logs.logs.length - 1].sequence;
-      }
+      const result = await fetchAndEmitBuildLogs(config, businessId, buildId, { afterSequence, json: options.json });
+      afterSequence = result.afterSequence;
     }
     const status = await apiFetch(
       config,
       `/api/businesses/${encodeURIComponent(businessId)}/sandbox-layer/build-requests/${encodeURIComponent(buildId)}`
     );
     if (TERMINAL_BUILD_STATUSES.has(status.buildRequest.status)) {
+      if (options.follow) {
+        await drainTerminalBuildLogs(config, businessId, buildId, { afterSequence, json: options.json });
+      }
       return status.buildRequest;
     }
     await sleep(options.pollIntervalMs);
@@ -5119,7 +5145,7 @@ program.hook("preAction", (_thisCommand, actionCommand) => {
   applyColorEnvironment(getRuntimeOptions(actionCommand));
 });
 function addCreateOptions(cmd) {
-  return cmd.argument("<repo-url>", "Repository URL").argument("[prompt]", "Prompt to send, or '-' to read stdin").option("--model <model>", "Model to use").option("--backend <backend>", "Agent runtime backend: codex (default), claude_code, or opencode").option("--reasoning-effort <effort>", "Reasoning effort to use for models that support it").option("--base-branch <branch>", "Base branch to create the session against (defaults to the repo default branch)").option(
+  return cmd.argument("<repo-url>", "Repository URL").argument("[prompt]", "Prompt to send, or '-' to read stdin").option("--model <model>", "Model to use").option("--backend <backend>", "Agent runtime backend: codex (default), claude_code, or opencode").option("--reasoning-effort <effort>", "Reasoning effort to use for models that support it").option("--auto-verify", "Opt this session into automatic QA verification after PR creation").option("--base-branch <branch>", "Base branch to create the session against (defaults to the repo default branch)").option(
     "--start-branch <branch>",
     "Resume an existing branch with its history instead of forking a new one off base"
   ).option("--continue-pr <url>", "Continue from an existing same-repo pull request").option("--continue-mode <mode>", "Continuation mode: auto (default), update-pr, or new-pr").option("--prompt-stdin", "Read prompt from stdin").option(
@@ -5142,7 +5168,7 @@ Examples:
   arcanist sessions create https://github.com/org/repo - --json | jq -r .sessionId | xargs -I{} arcanist sessions events {} --follow --json
 
 JSON:
-JSON mode returns {sessionId, sessionUrl?, repoUrl, model?, agentRuntimeBackend?, reasoningEffort?, baseBranch?, startBranch?, continuePrUrl?, continueMode?, onboarding?, promptId?}
+JSON mode returns {sessionId, sessionUrl?, repoUrl, model?, agentRuntimeBackend?, reasoningEffort?, autoVerify?, baseBranch?, startBranch?, continuePrUrl?, continueMode?, onboarding?, promptId?}
 --wait --json also includes best-effort result fields when available: prUrl?, publishedBranch?, lastBranch?
   Follow async progress with: arcanist sessions events <session-id> --follow --json
 `

package/package.json

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