@tryarcanist/cli 0.1.131 → 0.1.133

package/README.md

@@ -123,6 +123,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 "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
 arcanist sessions create your-org/your-repo "retry-safe create" --idempotency-key 1f0e6f1a-...
@@ -130,7 +131,9 @@ arcanist sessions create your-org/your-repo "retry-safe create" --idempotency-ke
 
 `--backend` picks the agent runtime backend: `codex` (default) or `claude_code`. `--model` must be valid for the chosen backend — codex runs OpenAI models (`gpt-5.4` default, `gpt-5.5`), `claude_code` runs Anthropic models (`claude-opus-4-8` default, `claude-sonnet-4-6`) — and the CLI rejects a mismatch before any network call. `claude_code` sessions require an Anthropic API key configured in Settings.
 
-`--wait` blocks until the created prompt finishes and exits non-zero if the prompt finishes with `status: failed`, making it suitable for cron or other schedulers that alert on command failure. `--poll-interval <ms>` tunes the completion check frequency.
+`--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. `--poll-interval <ms>` tunes the completion check frequency.
+
+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.
 
 Repeatable `--uploaded-file <path>` flags attach local UTF-8 text files to the prompt. Uploaded file names come from the local basename; directory components are not sent.
 
@@ -140,7 +143,7 @@ Repeatable `--uploaded-file <path>` flags attach local UTF-8 text files to the p
 
 `--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. Team use; not part of the external API surface.
 
-JSON mode returns `{sessionId, sessionUrl?, repoUrl, model?, agentRuntimeBackend?, reasoningEffort?, promptId?}`. `sessionUrl` is emitted only when the server returns it; `agentRuntimeBackend` only when `--backend` is passed.
+JSON mode returns `{sessionId, sessionUrl?, repoUrl, model?, agentRuntimeBackend?, reasoningEffort?, baseBranch?, promptId?}`. `sessionUrl` is emitted only when the server returns it; `agentRuntimeBackend` only when `--backend` is passed.
 
 ### `arcanist sessions send <session-id> [prompt]`
 
@@ -173,6 +176,8 @@ arcanist sessions get abc123
 arcanist sessions get abc123 --json
 ```
 
+Human-readable output includes `PR: <url> (<branch>)` when the session has opened a PR, or `Branch: <branch>` when a produced branch is known but no PR URL is present yet. If publishing is still settling, rerun `sessions get`; JSON mode returns the raw session payload, with result fields at `.session.prUrl`, `.session.publishedBranch`, and `.session.lastBranch`.
+
 ### `arcanist sessions list`
 
 ```bash
@@ -321,6 +326,18 @@ arcanist sessions create your-org/your-repo "verify the new rate limiter is acti
 
 For cron, prefer `ARCANIST_TOKEN` or a logged-in `~/.arcanist/config.json` over passing `--token` on the command line.
 
+To capture the PR URL after a successful run, use `create --wait` for the exit code, then read the session state:
+
+```bash
+SESSION_ID=$(arcanist sessions create your-org/your-repo "fix the flaky test" --wait --json | jq -r .sessionId)
+for _ in {1..20}; do
+  PR_URL=$(arcanist sessions get "$SESSION_ID" --json | jq -r '.session.prUrl // empty')
+  [ -n "$PR_URL" ] && break
+  sleep 5
+done
+[ -n "$PR_URL" ] || { echo "PR URL not ready for $SESSION_ID" >&2; exit 1; }
+```
+
 ## Troubleshooting
 
 - **401 on login verification**: token may be invalid or expired. Regenerate in **Settings > CLI Tokens**.

package/dist/index.js

@@ -1023,22 +1023,6 @@ function noChangeOutcomeCopy(reason) {
   }
 }
 
-// ../../shared/session/transient-disconnect.ts
-var TRANSIENT_DISCONNECT_VISIBILITY_MS = 15e3;
-function nextDisconnectMask(mask, previous, current, now) {
-  if (!current || current.sandboxSubstate !== "reconnecting") return null;
-  if (mask) return mask;
-  if (!previous || previous.sandboxSubstate === "reconnecting") return null;
-  return { since: now, heldPhase: previous.phase, heldSubstate: previous.sandboxSubstate ?? "none" };
-}
-function isDisconnectMaskActive(mask, now) {
-  return mask !== null && now - mask.since < TRANSIENT_DISCONNECT_VISIBILITY_MS;
-}
-function applyDisconnectMask(view, mask, now) {
-  if (!isDisconnectMaskActive(mask, now)) return view;
-  return { ...view, phase: mask.heldPhase, sandboxSubstate: mask.heldSubstate };
-}
-
 // ../../shared/transcript/malformed-search.ts
 var MALFORMED_SEARCH_BLOCKED_TRANSCRIPT_PREFIX = "Arcanist blocked this malformed search command before execution.";
 var BASH_UNMATCHED_QUOTE_EOF_RE = /\/bin\/bash:\s+-c:\s+line\s+\d+:\s+unexpected EOF while looking for matching [`'"][`'"]?/i;
@@ -2063,6 +2047,23 @@ ${event.answer ? `**Answer:** ${event.answer}
 function formatNumber(value) {
   return value.toLocaleString();
 }
+function stringField(value) {
+  return typeof value === "string" && value.trim() ? value : null;
+}
+function formatSessionResult(session) {
+  const prUrl = stringField(session.prUrl);
+  const publishedBranch = stringField(session.publishedBranch);
+  const lastBranch = stringField(session.lastBranch);
+  const baseBranch = stringField(session.baseBranch);
+  const branch = publishedBranch ?? (lastBranch && lastBranch !== baseBranch ? lastBranch : null);
+  if (prUrl) {
+    return `PR: ${prUrl}${branch ? ` (${branch})` : ""}`;
+  }
+  if (branch) {
+    return `Branch: ${branch}`;
+  }
+  return null;
+}
 function latestCompletedPromptResult(prompts) {
   for (let i = prompts.length - 1; i >= 0; i--) {
     if (prompts[i].status === "completed") return prompts[i].result;
@@ -2314,6 +2315,22 @@ function renderWatchEvent(event, state) {
   }
 }
 
+// ../../shared/session/transient-disconnect.ts
+var TRANSIENT_DISCONNECT_VISIBILITY_MS = 15e3;
+function nextDisconnectMask(mask, previous, current, now) {
+  if (!current || current.sandboxSubstate !== "reconnecting") return null;
+  if (mask) return mask;
+  if (!previous || previous.sandboxSubstate === "reconnecting") return null;
+  return { since: now, heldPhase: previous.phase, heldSubstate: previous.sandboxSubstate ?? "none" };
+}
+function isDisconnectMaskActive(mask, now) {
+  return mask !== null && now - mask.since < TRANSIENT_DISCONNECT_VISIBILITY_MS;
+}
+function applyDisconnectMask(view, mask, now) {
+  if (!isDisconnectMaskActive(mask, now)) return view;
+  return { ...view, phase: mask.heldPhase, sandboxSubstate: mask.heldSubstate };
+}
+
 // src/commands/watch.ts
 function parsePollInterval(raw) {
   if (!raw) return DEFAULT_WATCH_POLL_INTERVAL_MS;
@@ -2571,6 +2588,10 @@ async function createCommand(repoUrl, promptArg, options, command) {
   if (repoError) {
     throw new CliError("user", repoError);
   }
+  const baseBranch = options.baseBranch?.trim();
+  if (options.baseBranch !== void 0 && !baseBranch) {
+    throw new CliError("user", "--base-branch must not be empty.");
+  }
   const uploadedFiles = await resolveUploadedFileOptions(options.uploadedFile);
   const idempotencyKey = options.idempotencyKey ?? randomIdempotencyKey();
   const sessionIdempotencyKey = `${idempotencyKey}:session`;
@@ -2579,6 +2600,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 (baseBranch) body.baseBranch = baseBranch;
   if (options.cold) body.cold = true;
   if (options.onboarding) body.onboarding = true;
   const sessionData = await apiFetch(config, "/api/sessions", {
@@ -2616,6 +2638,15 @@ async function createCommand(repoUrl, promptArg, options, command) {
       if (sessionData.sessionUrl) console.log(`URL: ${sessionData.sessionUrl}`);
     }
     await waitForCreatedPrompt(sessionId, promptId, sessionData.sessionUrl, waitPollIntervalMs, runtime, command);
+    if (!isJson(command, options)) {
+      try {
+        const sessionPayload = await apiFetch(config, `/api/sessions/${sessionId}`);
+        const sessionState = sessionPayload.session && typeof sessionPayload.session === "object" ? sessionPayload.session : sessionPayload;
+        const resultLine = formatSessionResult(sessionState);
+        if (resultLine) console.log(resultLine);
+      } catch {
+      }
+    }
   }
   if (isJson(command, options)) {
     const output = { sessionId };
@@ -2624,6 +2655,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 (baseBranch) output.baseBranch = baseBranch;
     if (options.onboarding) output.onboarding = true;
     if (promptId) output.promptId = promptId;
     writeJson(output);
@@ -3840,6 +3872,8 @@ async function getSessionCommand(sessionId, options, command) {
   console.log(`Status: ${String(session.phase ?? session.status ?? "unknown")}`);
   if (session.repoUrl) console.log(`Repo: ${String(session.repoUrl)}`);
   if (session.title) console.log(`Title: ${String(session.title)}`);
+  const resultLine = formatSessionResult(session);
+  if (resultLine) console.log(resultLine);
 }
 async function sessionEventsCommand(sessionId, options, command) {
   const afterSequence = resolveSequenceOption(options.afterSequence, options.after, "--after-sequence", "--after");
@@ -4146,7 +4180,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) or claude_code").option("--reasoning-effort <effort>", "Reasoning effort to use for models that support it").option("--prompt-stdin", "Read prompt from stdin").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) or claude_code").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("--prompt-stdin", "Read prompt from stdin").option(
     "--uploaded-file <path>",
     "Attach a local text file to the prompt as uploadedFiles; repeat for multiple files",
     collectUploadedFileOption

package/package.json

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