prreviewbuddy 0.80.3 → 0.81.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.81.0
+
+**Gemini CLI is turned off.** PR Review Buddy no longer runs reviews, updates, Buddy AI answers,
+KISS reviews or repository maps with Gemini CLI. Google has ended Gemini CLI access for individual
+accounts, and current Gemini CLI releases ignore the settings that kept it read-only, so a run could
+no longer be guaranteed to leave your code alone. It is gone from every agent list. Naming it with
+`--agent gemini`, or having it saved as your default, stops before anything starts and says to use
+Claude Code or Codex instead.
+
+Reviews Gemini made are kept as they are, still labelled Gemini CLI. They can't be updated or asked
+about, because both continue with the agent that made the review. To carry one on, analyse it again
+with `--reanalyse --agent claude` or `--agent codex`; the Gemini analysis stays as the one it
+replaced. A Gemini review that was queued or stopped is refused before its checkout is made, without
+a Retry button. If Settings has Gemini CLI saved as the default, it shows that and asks you to
+choose another.
+
+The Gemini provider for Buddy AI in the browser extension is unaffected: it calls Google's API with
+your own key and never runs Gemini CLI.
+
 ## 0.80.3
 
 **Runs name the agent that did the work.** Updating a review, and the checkout Buddy AI answers

package/README.md

@@ -4,7 +4,7 @@
 
 A local review workspace that helps you understand code changes before you approve them.
 
-Have Claude Code, Codex or Gemini CLI analyse a branch or pull request, then explore what it
+Have Claude Code or Codex analyse a branch or pull request, then explore what it
 found, the evidence behind it and your own follow-up questions in your browser.
 
 ![A review in the workspace: why the change was made, what it changes, its risk and progress, a suggested review path, and Buddy AI beside it](https://prreviewbuddy.com/npm/workspace.png)
@@ -69,9 +69,8 @@ being reviewed, so your working tree is never touched and you can carry on worki
 ## Local by design
 
 PR Review Buddy uses a coding agent already installed on your machine, and that agent's existing
-authentication: [Claude Code](https://claude.com/claude-code),
-[Codex CLI](https://developers.openai.com/codex/cli) or
-[Gemini CLI](https://github.com/google-gemini/gemini-cli). There is no PR Review Buddy account and no
+authentication: [Claude Code](https://claude.com/claude-code) or
+[Codex CLI](https://developers.openai.com/codex/cli). There is no PR Review Buddy account and no
 model API key.
 
 Your code goes to the agent you chose, exactly as if you had run it yourself. It does not pass

package/dist/{delete_review-CYiIfV5A.js → delete_review-CFVFygqb.js}

@@ -1274,22 +1274,115 @@ var AGENTS = {
 	[GEMINI_AGENT_ID]: geminiAgent,
 	[CODEX_AGENT_ID]: codexAgent
 };
+/**
+* Adapters this build ships and will not run, each with the sentence a person is shown instead.
+*
+* A parked id is still known: reviews it made keep their name and their history, telemetry still
+* recognises it, and a job queued under it is refused by name rather than treated as an agent this
+* build has never heard of. What it loses is everything that would start it. `agentById` throws
+* before an adapter is handed out, so no run site can reach one, and every list a person chooses
+* from is built from `AGENT_IDS`, which leaves it out.
+*
+* Gemini CLI, since 0.81.0. Its read-only boundary is not applied on current releases (the system
+* settings file that carried it is skipped unless root owns it), and Google has ended Gemini CLI
+* for individual accounts. `index.test.ts` holds a tripwire against unparking it before the adapter
+* enforces its boundary again.
+*/
+var PARKED = { [GEMINI_AGENT_ID]: "Gemini CLI is turned off in this version of PR Review Buddy. Google has ended Gemini CLI access for individual accounts, and its read-only mode can't be guaranteed on current versions." };
 var DEFAULT_AGENT_ID = CLAUDE_AGENT_ID;
 /**
 * Every agent this build can run, for a surface that has to say which ones those are.
 *
 * Derived from the registry rather than written out, so a second adapter appears in the sentence a
-* user reads by being registered, and nobody has to remember a list in another package.
+* user reads by being registered, and nobody has to remember a list in another package. Parked
+* adapters are left out, which is how they leave every picker, listing and help sentence at once.
+*/
+var AGENT_IDS = Object.keys(AGENTS).filter((id) => !(id in PARKED));
+/**
+* Whether a string names an agent this build ships, answered by the registry rather than a list.
+*
+* True for a parked agent too. This answers "do we know this id", which is what a stored review, a
+* job record and telemetry need; "can it run" is `AGENT_IDS` and `agentById`.
 */
-var AGENT_IDS = Object.keys(AGENTS);
-/** Whether a string names an agent this build ships, answered by the registry rather than a list. */
 function isAgentId(value) {
 	return value !== void 0 && value in AGENTS;
 }
+/**
+* Why this agent will not run in this build, or undefined when nothing stops it here.
+*
+* For a surface that has to tell a person something more useful than "unknown agent" when they
+* name one that is parked.
+*/
+function parkedReason(id) {
+	if (id === void 0 || !Object.hasOwn(PARKED, id)) return void 0;
+	return `${PARKED[id]} Use ${runnableAgents().names} instead.`;
+}
+/**
+* The agents that can run, as a person reads them ("Claude Code or Codex") and as `--agent` takes
+* them ("`--agent claude` or `--agent codex`"), for a refusal that has to say what to do instead.
+*
+* Built from `AGENT_IDS` so no module outside this folder spells an agent out, and so the advice
+* stays true when an adapter is parked or added.
+*/
+function runnableAgents() {
+	const ids = [...AGENT_IDS].sort();
+	return {
+		names: orList(ids.map((id) => AGENTS[id].displayName)),
+		flags: orList(ids.map((id) => `\`--agent ${id}\``))
+	};
+}
+function orList(items) {
+	if (items.length <= 1) return items[0] ?? "";
+	return `${items.slice(0, -1).join(", ")} or ${items[items.length - 1]}`;
+}
+/**
+* A run was asked of a parked agent. An `AgentUnavailableError`, so every caller that already
+* answers "you have not got this agent" answers this with the parked sentence instead.
+*/
+var AgentParkedError = class extends AgentUnavailableError {
+	agentId;
+	constructor(agentId, reason) {
+		super(reason);
+		this.agentId = agentId;
+	}
+};
+/**
+* Who an agent is, without the means to run it. For a parked agent, which `agentById` refuses, when
+* a surface has to name it: a refusal that says "Gemini CLI" rather than "gemini".
+*/
+function agentIdentityOf(id) {
+	const { displayName, provider, modelSelectionHelp, setupNotes } = AGENTS[id];
+	return {
+		id,
+		displayName,
+		provider,
+		...modelSelectionHelp ? { modelSelectionHelp } : {},
+		...setupNotes ? { setupNotes } : {}
+	};
+}
+/**
+* The environment a review made by this agent is pinned to, captured now.
+*
+* Works for a parked agent, because capturing starts nothing: it reads variables. A review made by
+* one still has a forge to watch and a conversation to re-read, under the account that made it, and
+* an agent run started from what this returns is refused at `agentFor` like any other.
+*/
+function captureEnvFor(id, source) {
+	return AGENTS[id].captureEnv(source);
+}
 function defaultAgent() {
 	return agentById(DEFAULT_AGENT_ID);
 }
+/**
+* The adapter for this id, and the one way any run reaches one.
+*
+* A parked id throws here rather than handing out something that refuses later. Several callers
+* write before they run (a new job, a retired analysis, a KISS run), so a refusal at `run()` would
+* already have replaced what the reviewer was reading with a failure.
+*/
 function agentById(id) {
+	const reason = parkedReason(id);
+	if (reason) throw new AgentParkedError(id, reason);
 	const agent = AGENTS[id];
 	if (!agent) throw new AgentUnavailableError(`This review was made with an agent called "${id}", which this version does not know how to run.`);
 	return agent;
@@ -1346,7 +1439,7 @@ function captureEnv(source) {
 * against fakes that fail in ways no installed binary would.
 */
 async function detectAgents() {
-	return detectAgents$1(Object.values(AGENTS));
+	return detectAgents$1(AGENT_IDS.map((id) => AGENTS[id]));
 }
 //#endregion
 //#region ../../packages/review-harness/src/workspace/store_root.ts
@@ -1724,7 +1817,7 @@ function countDiscussion(context) {
 async function resolveAgent(request) {
 	if (request.flag) return named(request.flag, "flag");
 	const fromReview = request.review ? agentIdOf(request.review.session) : null;
-	if (fromReview && AGENT_IDS.includes(fromReview)) return named(fromReview, "review");
+	if (fromReview && isAgentId(fromReview)) return named(fromReview, "review");
 	const preferred = readAgentPreference();
 	if (preferred) return named(preferred, "preference");
 	const installed = (await detectAgents()).filter((agent) => agent.state === "installed");
@@ -1736,6 +1829,13 @@ async function resolveAgent(request) {
 	};
 }
 async function named(id, because) {
+	const parked = parkedReason(id);
+	if (parked && isAgentId(id)) return {
+		kind: "unavailable",
+		agent: agentIdentityOf(id),
+		reason: parked,
+		parked: true
+	};
 	if (!AGENT_IDS.includes(id)) return {
 		kind: "unknown-id",
 		id
@@ -7177,7 +7277,7 @@ function advance(job, phase, progress) {
 		...phase === "done" ? { finishedAt: Date.now() } : {}
 	};
 }
-function fail(job, message, kind, detail) {
+function fail(job, message, kind, detail, parked) {
 	return {
 		...job,
 		phase: "failed",
@@ -7185,7 +7285,8 @@ function fail(job, message, kind, detail) {
 			phase: job.phase,
 			message,
 			...detail && detail !== message ? { detail } : {},
-			...kind ? { kind } : {}
+			...kind ? { kind } : {},
+			...parked ? { parked } : {}
 		},
 		updatedAt: Date.now(),
 		finishedAt: Date.now()
@@ -7212,11 +7313,11 @@ function fail(job, message, kind, detail) {
 * last thing the agent said survives being failed. Only a driver whose own claim has gone is
 * refused, so a job nobody holds -- a crashed driver's, a resumed run's -- is still failable.
 */
-function recordFailure(job, message, driver, kind, detail) {
+function recordFailure(job, message, driver, kind, detail, parked) {
 	const current = loadJob(job.id) ?? job;
 	const claim = liveClaim(job.id);
 	if (claim && claim.holder !== driver) return current;
-	const failed = fail(current, message, kind, detail);
+	const failed = fail(current, message, kind, detail, parked);
 	saveJob(failed);
 	return failed;
 }
@@ -12970,7 +13071,7 @@ function agentEnvOf(workspace) {
 	const job = workspace.jobId ? loadJob(workspace.jobId) : null;
 	if (job?.env) return job.env;
 	const id = agentIdOf(workspace.session);
-	return (AGENT_IDS.includes(id) ? agentById(id) : defaultAgent()).captureEnv();
+	return isAgentId(id) ? captureEnvFor(id) : defaultAgent().captureEnv();
 }
 //#endregion
 //#region ../../packages/review-harness/src/domain/discussion/discussion_attribution.ts
@@ -16370,6 +16471,8 @@ async function drive(jobId, workspaceId, runners, driver, signal, source) {
 	saveJob(job);
 	try {
 		signal?.throwIfAborted();
+		const parked = parkedReason(job.env.agentId);
+		if (parked) throw new AgentParkedError(job.env.agentId, parked);
 		if (needs(from, "preparing")) {
 			job = update(job, "preparing", "Preparing an isolated checkout");
 			const path = await createWorktree({
@@ -16494,7 +16597,7 @@ async function drive(jobId, workspaceId, runners, driver, signal, source) {
 		}
 		const kind = error instanceof GuideRejected || error instanceof KissRejected ? "agent_output_invalid" : error instanceof AgentRunError ? error.kind : void 0;
 		const raw = message(error);
-		job = recordFailure(job, explain(job, raw), driver, kind, raw);
+		job = recordFailure(job, explain(job, raw), driver, kind, raw, error instanceof AgentParkedError ? true : void 0);
 		if (job.reviewType === "kiss") failCurrentKissRun(workspaceId, job, job.failure?.message ?? raw, kind, error instanceof KissRejected ? error.answer : void 0);
 		finished(job, workspaceId, startedAt, false, now);
 		announceJob(job);
@@ -17885,7 +17988,7 @@ async function recordKissRun(input) {
 	if (!workspace) throw new Error("No such review.");
 	const sha = reviewedCommit(workspace);
 	if (!sha) throw new Error("This review does not record which commit it describes, so KISS cannot run on it.");
-	const agent = input.agentId ? agentById(input.agentId) : workspace.jobId ? agentById(agentIdOf(workspace.session)) : defaultAgent();
+	const agent = agentById(kissAgentId(workspace, input.agentId));
 	const sameAgent = !workspace.jobId || agent.id === agentIdOf(workspace.session);
 	const requestedModel = input.requestedModel ?? (sameAgent ? resolveModel({ review: workspace }) : null);
 	const started = await withReviewLock(workspace.id, () => {
@@ -17937,6 +18040,16 @@ async function recordKissRun(input) {
 function startKissJob(input, runners = {}) {
 	return track(recordKissRun(input).then((job) => runJob(job.workspaceId, runners, "kiss")));
 }
+/**
+* Which agent a KISS run of this review runs with: the one named, else the standard review's own,
+* else the default when there has been no standard review.
+*
+* Its own function so the page can refuse a run before answering. The route starts the run and
+* replies without waiting for it, so a refusal thrown inside the run never reached the page.
+*/
+function kissAgentId(workspace, agentId) {
+	return agentId ?? (workspace.jobId ? agentIdOf(workspace.session) : DEFAULT_AGENT_ID);
+}
 //#endregion
 //#region ../../packages/review-harness/src/domain/ai_review/reconciliation.ts
 /**
@@ -18829,6 +18942,17 @@ var RefreshUnavailableError = class extends Error {};
 var FETCH_TIMEOUT_MS = 6e4;
 /** Said wherever an update is asked of a commit review. One sentence, so both surfaces agree. */
 var COMMIT_REVIEW_CANNOT_UPDATE = "This review is of one commit, and a commit cannot move, so there is nothing to bring it up to date with. To analyse the same commit again, reanalyse it instead.";
+/**
+* Why this review cannot be updated in this build, when the agent it would continue with is parked.
+*
+* Read from `agentEnvOf`, which is what the update's job would be pinned to, so this refuses
+* exactly the updates that would otherwise be refused at the run.
+*/
+function parkedUpdateRefusal(workspace) {
+	const reason = parkedReason(agentEnvOf(workspace).agentId);
+	if (!reason) return null;
+	return `${reason} An update continues with the agent that made this review, so this one can't be brought up to date. To carry on with another agent, analyse it again with ${runnableAgents().names}.`;
+}
 /** The installed agent's own answer, through the `agentFor` this module imports. */
 var installedAgentVersion = (env) => agentVersionOf(agentFor(env), env);
 /** What the notice says after a cancel, and what the terminal would print if it could cancel. */
@@ -18864,6 +18988,8 @@ async function updateReview(workspace, runners = {}) {
 	const startedAt = now();
 	const reviewedSha = workspace.session.metadata?.commitSha || null;
 	if (workspace.changeSet.targetType === "commit") return refuse(reviewedSha, false, COMMIT_REVIEW_CANNOT_UPDATE);
+	const parked = parkedUpdateRefusal(workspace);
+	if (parked) return refuse(reviewedSha, false, parked);
 	const held = await claimCheckoutJob(workspace, reviewedSha ?? "", {
 		purpose: "update",
 		...runners.source ? { source: runners.source } : {},
@@ -19753,4 +19879,4 @@ function lineageIds(id) {
 	return [.../* @__PURE__ */ new Set([id, ...lineage.map((review) => review.id)])];
 }
 //#endregion
-export { resolveWorkspacePort as $, AgentUnavailableError as $i, attemptIdOf as $n, isIssueOutstanding as $r, moveIds as $t, parsePullRequestLink as A, resolveTarget as Ai, modelHelpLines as An, recentWorkspaces as Ar, readArchitecture as At, ensureServer as B, resolveAgent as Bi, requestJobStop as Bn, isLifecycle as Br, writeJsonAtomically as Bt, completeRun as C, followUpFindingId as Ci, hasAuthorContent as Cn, lineagePosition as Cr, RUNTIME_WORDS as Ct, relativeTime as D, describeAuthorship as Di, CODE_COPY_CLASS as Dn, positionInLineage as Dr, checkArchitecture as Dt, stopRun as E, objectWithAnyOf as Ei, CODE_BLOCK_CLASS as En, mutateWorkspace as Er, ARCHITECTURE_DIR as Et, queueForReview as F, AmbiguousRefError as Fi, createWorktree as Fn, workspaceRevision as Fr, ownersOf as Ft, stopChild as G, CONFIG_PATH as Gi, checkReview as Gn, parseLifecycle as Gr, createArchitectureNotification as Gt, reviewsUrl as H, clearAgentPreference as Hi, describeSubject as Hn, lifecycleItemLabel as Hr, branchOf as Ht, settleQueue as I, shortNameOf as Ii, holdWorktree as In, workspaceStamps as Ir, QUOTE_LIMITS as It, writeServerRecord as J, agentById as Ji, fetchHead as Jn, queueAddMany as Jr, eventName as Jt, stopServer as K, STORE_ROOT as Ki, followedBranch as Kn, sectionOf as Kr, createPrState as Kt, readIndexToken as L, shorthandOf as Li, isWorktreeHeld as Ln, LIFECYCLES as Lr, REPOSITORY_SCOPE as Lt, runBatch as M, DetachedHeadError as Mi, isBusy as Mn, reviewedRepositories as Mr, storeArchitecture as Mt, activateQueued as N, isCommitReview as Ni, withReviewLock as Nn, summarise as Nr, storedScopes as Nt, batchIdentity as O, WITHHELD_REASON as Oi, escapeHtml as On, presentedKissRunOf as Or, loadArchitecture as Ot, compactQueue as P, resolveBase as Pi, MANAGED_ROOT as Pn, touchWorkspace as Pr, trackedFiles as Pt, parseWorkspacePort as Q, AgentCancelledError as Qi, allJobs as Qn, doneVerb as Qr, markReadForReview as Qt, bootstrapUrl as R, git as Ri, readMarker as Rn, activityAttributes as Rr, ancestorsOf as Rt, beginRun as S, wasReassessed as Si, authorPreview as Sn, latestKissRun as Sr, recordRuntimeBestEffort as St, reportRun as T, extractJsonText as Ti, renderMarkdown as Tn, matchingWorkspaceIds as Tr, formatDuration as Tt, serverEntryExists as U, readAgentPreference as Ui, findExistingReview as Un, lifecyclePill as Ur, subjectOf as Ut, readServerRecord as V, resolveModel as Vi, describeMovement as Vn, lifecycleChip as Vr, announceJob as Vt, spawnServer as W, writeAgentPreference as Wi, checkCodeFreshness as Wn, offersLifecycle as Wr, categoryOf as Wt, MAX_WORKSPACE_PORT as X, detectAgents as Xi, fillFileUrlTemplate as Xn, queueStamp as Xr, markAllRead as Xt, DEFAULT_WORKSPACE_PORT as Y, agentFor as Yi, forgeResolver as Yn, queueRemove as Yr, listNotifications as Yt, MIN_WORKSPACE_PORT as Z, isAgentId as Zi, RUN_RECORD_RETENTION_MS as Zn, readQueue as Zr, markRead as Zt, recordKissRun as _, gradeScale as _i, isUnchanged as _n, groupByLineage as _r, BUILD_VERSION as _t, wasBlocked as a, processDiscussion as ai, toneOf as an, saveJob as ar, settleReview as at, track as b, reassessIn as bi, chatConversationSection as bn, kissDecisionRefusal as br, waitingHistory as bt, RefreshUnavailableError as c, explanationOf as ci, withUsageRecorded as cn, isTerminalJobPhase as cr, startJob as ct, mergeUpdateInto as d, ANALYSIS_ONLY as di, adoptLegacyBaseline as dn, purposeOf as dr, record as dt, isQuestionOutstanding as ei, pruneNotifications as en, endedAt as er, statedWorkspacePort as et, updateReview as f, analysisRefOf as fi, prepareConversationWithin as fn, clearClaim as fr, stamp as ft, runningJobs as g, findingIn as gi, refreshPrContext as gn, followedRefName as gr, telemetryUploadEnabled as gt, liveUpdateFor as h, findingAssessment as hi, unforeseenFailure as hn, decideKissRecommendation as hr, telemetryUploadConsent as ht, liveJobsFor as i, reviewerDispositions as ii, retireNotification as in, pruneJobResidue as ir, prepareReview as it, unsupportedReason as j, originRemote as ji, ReviewBeingDeletedError as jn, reviewedCommit as jr, repositoryKey as jt, extractPullRequestLinks as k, kissOutcome as ki, renderInlineText as kn, previousKissResult as kr, partFiles as kt, cancelUpdate as l, isExplanationAction as li, existingPaths as ln, phasesFor as lr, append as lt, UpdateAlreadyRunningError as m, currentGradeIn as mi, storedConversation as mn, CLAIM_LEASE_MS as mr, recordTelemetryUploadConsent as mt, deleteReview as n, questionsOutstanding as ni, readStateOf as nn, isTerminal as nr, failureOf as nt, discardJob as o, recommendationsOf as oi, unreadAround as on, PHASES as or, reanalyseReview as ot, askCheckout as p, assessmentLookup as pi, saveRefresh as pn, isClaimed as pr, deliver as pt, workspaceUrl as q, AGENT_IDS as qi, reviewedShaOf as qn, queueAdd as qr, createPrUpdate as qt, lineageIds as r, resolvedByConversation as ri, removeNotification as rn, loadJob as rr, observeReview as rt, FETCH_TIMEOUT_MS as s, explanationActionOf as si, unreadCount as sn, isLiveJob as sr, runJob as st, deleteLineage as t, issuesOutstanding as ti, readNotification as tn, fail as tr, writePortPreference as tt, cancellableHere as u, withExplanation as ui, ASK_REREAD_CEILING_MS as un, progressSteps as ur, readEvents as ut, startKissJob as v, isGradeFor as vi, agentEnvOf as vn, indexKeptIds as vr, PACKAGE_NAME as vt, endRun as w, asString$1 as wi, GITHUB_MARKDOWN as wn, loadWorkspace as wr, describeRuntimes as wt, RUN_KINDS as x, sourcePhrase as xi, UNESTABLISHED_MOTIVATION as xn, kissDecisionsOf as xr, mapRuntimes as xt, isDriving as y, promptGrade as yi, EXPLAIN_SIMPLY_PROMPT as yn, indexReviewGroups as yr, feedbackUrl as yt, clearServerRecordOwnedBy as z, refExists as zi, removeWorktree as zn, activityLabel as zr, isArchitectureId as zt };
+export { MIN_WORKSPACE_PORT as $, agentIdentityOf as $i, RUN_RECORD_RETENTION_MS as $n, readQueue as $r, markRead as $t, batchIdentity as A, WITHHELD_REASON as Ai, escapeHtml as An, presentedKissRunOf as Ar, loadArchitecture as At, bootstrapUrl as B, git as Bi, readMarker as Bn, activityAttributes as Br, ancestorsOf as Bt, RUN_KINDS as C, sourcePhrase as Ci, UNESTABLISHED_MOTIVATION as Cn, kissDecisionsOf as Cr, mapRuntimes as Ct, reportRun as D, extractJsonText as Di, renderMarkdown as Dn, matchingWorkspaceIds as Dr, formatDuration as Dt, endRun as E, asString$1 as Ei, GITHUB_MARKDOWN as En, loadWorkspace as Er, describeRuntimes as Et, activateQueued as F, isCommitReview as Fi, withReviewLock as Fn, summarise as Fr, storedScopes as Ft, serverEntryExists as G, clearAgentPreference as Gi, findExistingReview as Gn, lifecyclePill as Gr, subjectOf as Gt, ensureServer as H, resolveAgent as Hi, requestJobStop as Hn, isLifecycle as Hr, writeJsonAtomically as Ht, compactQueue as I, resolveBase as Ii, MANAGED_ROOT as In, touchWorkspace as Ir, trackedFiles as It, stopServer as J, CONFIG_PATH as Ji, followedBranch as Jn, sectionOf as Jr, createPrState as Jt, spawnServer as K, readAgentPreference as Ki, checkCodeFreshness as Kn, offersLifecycle as Kr, categoryOf as Kt, queueForReview as L, AmbiguousRefError as Li, createWorktree as Ln, workspaceRevision as Lr, ownersOf as Lt, parsePullRequestLink as M, resolveTarget as Mi, modelHelpLines as Mn, recentWorkspaces as Mr, readArchitecture as Mt, unsupportedReason as N, originRemote as Ni, ReviewBeingDeletedError as Nn, reviewedCommit as Nr, repositoryKey as Nt, stopRun as O, objectWithAnyOf as Oi, CODE_BLOCK_CLASS as On, mutateWorkspace as Or, ARCHITECTURE_DIR as Ot, runBatch as P, DetachedHeadError as Pi, isBusy as Pn, reviewedRepositories as Pr, storeArchitecture as Pt, MAX_WORKSPACE_PORT as Q, agentFor as Qi, fillFileUrlTemplate as Qn, queueStamp as Qr, markAllRead as Qt, settleQueue as R, shortNameOf as Ri, holdWorktree as Rn, workspaceStamps as Rr, QUOTE_LIMITS as Rt, track as S, reassessIn as Si, chatConversationSection as Sn, kissDecisionRefusal as Sr, waitingHistory as St, completeRun as T, followUpFindingId as Ti, hasAuthorContent as Tn, lineagePosition as Tr, RUNTIME_WORDS as Tt, readServerRecord as U, resolveModel as Ui, describeMovement as Un, lifecycleChip as Ur, announceJob as Ut, clearServerRecordOwnedBy as V, refExists as Vi, removeWorktree as Vn, activityLabel as Vr, isArchitectureId as Vt, reviewsUrl as W, agentIdOf as Wi, describeSubject as Wn, lifecycleItemLabel as Wr, branchOf as Wt, writeServerRecord as X, AGENT_IDS as Xi, fetchHead as Xn, queueAddMany as Xr, eventName as Xt, workspaceUrl as Y, STORE_ROOT as Yi, reviewedShaOf as Yn, queueAdd as Yr, createPrUpdate as Yt, DEFAULT_WORKSPACE_PORT as Z, agentById as Zi, forgeResolver as Zn, queueRemove as Zr, listNotifications as Zt, runningJobs as _, findingAssessment as _i, unforeseenFailure as _n, decideKissRecommendation as _r, telemetryUploadConsent as _t, wasBlocked as a, AgentUnavailableError as aa, resolvedByConversation as ai, removeNotification as an, loadJob as ar, observeReview as at, startKissJob as b, isGradeFor as bi, agentEnvOf as bn, indexKeptIds as br, PACKAGE_NAME as bt, RefreshUnavailableError as c, recommendationsOf as ci, unreadAround as cn, PHASES as cr, reanalyseReview as ct, mergeUpdateInto as d, isExplanationAction as di, existingPaths as dn, phasesFor as dr, append as dt, detectAgents as ea, doneVerb as ei, markReadForReview as en, allJobs as er, parseWorkspacePort as et, parkedUpdateRefusal as f, withExplanation as fi, ASK_REREAD_CEILING_MS as fn, progressSteps as fr, readEvents as ft, liveUpdateFor as g, currentGradeIn as gi, storedConversation as gn, CLAIM_LEASE_MS as gr, recordTelemetryUploadConsent as gt, UpdateAlreadyRunningError as h, assessmentLookup as hi, saveRefresh as hn, isClaimed as hr, deliver as ht, liveJobsFor as i, AgentCancelledError as ia, questionsOutstanding as ii, readStateOf as in, isTerminal as ir, failureOf as it, extractPullRequestLinks as j, kissOutcome as ji, renderInlineText as jn, previousKissResult as jr, partFiles as jt, relativeTime as k, describeAuthorship as ki, CODE_COPY_CLASS as kn, positionInLineage as kr, checkArchitecture as kt, cancelUpdate as l, explanationActionOf as li, unreadCount as ln, isLiveJob as lr, runJob as lt, askCheckout as m, analysisRefOf as mi, prepareConversationWithin as mn, clearClaim as mr, stamp as mt, deleteReview as n, parkedReason as na, isQuestionOutstanding as ni, pruneNotifications as nn, endedAt as nr, statedWorkspacePort as nt, discardJob as o, reviewerDispositions as oi, retireNotification as on, pruneJobResidue as or, prepareReview as ot, updateReview as p, ANALYSIS_ONLY as pi, adoptLegacyBaseline as pn, purposeOf as pr, record as pt, stopChild as q, writeAgentPreference as qi, checkReview as qn, parseLifecycle as qr, createArchitectureNotification as qt, lineageIds as r, runnableAgents as ra, issuesOutstanding as ri, readNotification as rn, fail as rr, writePortPreference as rt, FETCH_TIMEOUT_MS as s, processDiscussion as si, toneOf as sn, saveJob as sr, settleReview as st, deleteLineage as t, isAgentId as ta, isIssueOutstanding as ti, moveIds as tn, attemptIdOf as tr, resolveWorkspacePort as tt, cancellableHere as u, explanationOf as ui, withUsageRecorded as un, isTerminalJobPhase as ur, startJob as ut, kissAgentId as v, findingIn as vi, refreshPrContext as vn, followedRefName as vr, telemetryUploadEnabled as vt, beginRun as w, wasReassessed as wi, authorPreview as wn, latestKissRun as wr, recordRuntimeBestEffort as wt, isDriving as x, promptGrade as xi, EXPLAIN_SIMPLY_PROMPT as xn, indexReviewGroups as xr, feedbackUrl as xt, recordKissRun as y, gradeScale as yi, isUnchanged as yn, groupByLineage as yr, BUILD_VERSION as yt, readIndexToken as z, shorthandOf as zi, isWorktreeHeld as zn, LIFECYCLES as zr, REPOSITORY_SCOPE as zt };

package/dist/main.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { Ai as resolveTarget, An as modelHelpLines, Ar as recentWorkspaces, B as ensureServer, Bi as resolveAgent, D as relativeTime, Dr as positionInLineage, Er as mutateWorkspace, F as queueForReview, Gi as CONFIG_PATH, H as reviewsUrl, Hn as describeSubject, Ji as agentById, K as stopServer, Ki as STORE_ROOT, L as readIndexToken, M as runBatch, Mr as reviewedRepositories, Nr as summarise, O as batchIdentity, Oi as WITHHELD_REASON, Pn as MANAGED_ROOT, Q as parseWorkspacePort, Qn as allJobs, R as bootstrapUrl, Ri as git, Rn as readMarker, Tr as matchingWorkspaceIds, Ui as readAgentPreference, Un as findExistingReview, Vi as resolveModel, Vn as describeMovement, Wi as writeAgentPreference, X as MAX_WORKSPACE_PORT, Xi as detectAgents, Y as DEFAULT_WORKSPACE_PORT, Yn as forgeResolver, Z as MIN_WORKSPACE_PORT, _ as recordKissRun, _t as BUILD_VERSION, a as wasBlocked, at as settleReview, ct as startJob, d as mergeUpdateInto, dr as purposeOf, dt as record$1, et as statedWorkspacePort, f as updateReview, fr as clearClaim, ft as stamp, g as runningJobs, gr as followedRefName, gt as telemetryUploadEnabled, h as liveUpdateFor, ht as telemetryUploadConsent, i as liveJobsFor, it as prepareReview, ki as kissOutcome, lt as append, m as UpdateAlreadyRunningError, mt as recordTelemetryUploadConsent, n as deleteReview$1, or as PHASES, ot as reanalyseReview, pt as deliver, q as workspaceUrl, qi as AGENT_IDS, rr as loadJob, tt as writePortPreference, ur as progressSteps, vt as PACKAGE_NAME, wr as loadWorkspace, zn as removeWorktree } from "./delete_review-CYiIfV5A.js";
+import { $ as MIN_WORKSPACE_PORT, A as batchIdentity, Ai as WITHHELD_REASON, B as bootstrapUrl, Bi as git, Bn as readMarker, Dr as matchingWorkspaceIds, Er as loadWorkspace, Fr as summarise, Gn as findExistingReview, H as ensureServer, Hi as resolveAgent, In as MANAGED_ROOT, J as stopServer, Ji as CONFIG_PATH, Ki as readAgentPreference, L as queueForReview, Mi as resolveTarget, Mn as modelHelpLines, Mr as recentWorkspaces, Or as mutateWorkspace, P as runBatch, Pr as reviewedRepositories, Q as MAX_WORKSPACE_PORT, Ui as resolveModel, Un as describeMovement, Vn as removeWorktree, W as reviewsUrl, Wn as describeSubject, Xi as AGENT_IDS, Y as workspaceUrl, Yi as STORE_ROOT, Z as DEFAULT_WORKSPACE_PORT, Zi as agentById, Zn as forgeResolver, _ as runningJobs, _t as telemetryUploadConsent, a as wasBlocked, ar as loadJob, bt as PACKAGE_NAME, cr as PHASES, ct as reanalyseReview, d as mergeUpdateInto, dt as append, ea as detectAgents, er as allJobs, et as parseWorkspacePort, f as parkedUpdateRefusal, fr as progressSteps, g as liveUpdateFor, gt as recordTelemetryUploadConsent, h as UpdateAlreadyRunningError, ht as deliver, i as liveJobsFor, ji as kissOutcome, k as relativeTime, kr as positionInLineage, mr as clearClaim, mt as stamp, n as deleteReview$1, na as parkedReason, nt as statedWorkspacePort, ot as prepareReview, p as updateReview, pr as purposeOf, pt as record$1, qi as writeAgentPreference, ra as runnableAgents, rt as writePortPreference, st as settleReview, ut as startJob, vr as followedRefName, vt as telemetryUploadEnabled, y as recordKissRun, yt as BUILD_VERSION, z as readIndexToken } from "./delete_review-CFVFygqb.js";
 import { basename, dirname, join, resolve } from "node:path";
 import { spawn } from "node:child_process";
 import { existsSync, mkdirSync, readdirSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
@@ -1150,6 +1150,11 @@ function unknownSettingValue(key, value, known) {
 */
 function unresolvedAgent(resolution) {
 	if (resolution.kind === "unknown-id") return unknownAgent(resolution.id, AGENT_IDS);
+	if (resolution.kind === "unavailable" && resolution.parked) return [
+		resolution.reason,
+		"",
+		`Nothing was started. Name another agent with ${runnableAgents().flags}, or change the default with \`prreviewbuddy config set agent <agent>\`.`
+	].join("\n");
 	if (resolution.kind === "unavailable") return `${resolution.agent?.displayName} cannot be run here. ${resolution.reason}`;
 	if (resolution.kind === "none") return [
 		"No coding agent was found, so there is nothing to review with.",
@@ -2380,6 +2385,11 @@ async function operate(command, workspace) {
 		err(commitReviewCannotUpdate(workspace.changeSet.data.pullRequest.head.sha));
 		return 1;
 	}
+	const parked = command.operation === "update" ? parkedUpdateRefusal(workspace) : null;
+	if (parked) {
+		err(parked);
+		return 1;
+	}
 	enqueue(command, workspace.id);
 	if (command.operation === "reanalyse") {
 		const agent = await chooseFor(command, workspace);
@@ -2718,6 +2728,11 @@ async function agents(command) {
 		out(agentList(detected, preferred));
 		return 0;
 	}
+	const parked = parkedReason(command.id);
+	if (parked) {
+		err(parked);
+		return 1;
+	}
 	if (!AGENT_IDS.includes(command.id)) {
 		err(unknownAgent(command.id, AGENT_IDS));
 		return 1;
@@ -2802,6 +2817,11 @@ function agent(command) {
 		return 0;
 	}
 	const id = command.value;
+	const parked = parkedReason(id);
+	if (parked) {
+		err(parked);
+		return 1;
+	}
 	if (!AGENT_IDS.includes(id)) {
 		err(unknownAgent(id, AGENT_IDS));
 		return 1;

package/dist/server.js

@@ -1,4 +1,4 @@
-import { $ as resolveWorkspacePort, $i as AgentUnavailableError, $n as attemptIdOf, $r as isIssueOutstanding, $t as moveIds, A as parsePullRequestLink, Ai as resolveTarget, Ar as recentWorkspaces, At as readArchitecture, Bi as resolveAgent, Bn as requestJobStop, Br as isLifecycle, Bt as writeJsonAtomically, C as completeRun, Ci as followUpFindingId, Cn as hasAuthorContent, Cr as lineagePosition, Ct as RUNTIME_WORDS, D as relativeTime$1, Di as describeAuthorship, Dn as CODE_COPY_CLASS, Dt as checkArchitecture, E as stopRun, Ei as objectWithAnyOf, En as CODE_BLOCK_CLASS, Er as mutateWorkspace, Et as ARCHITECTURE_DIR, Fi as AmbiguousRefError, Fn as createWorktree, Fr as workspaceRevision, Ft as ownersOf, G as stopChild, Gn as checkReview, Gr as parseLifecycle, Gt as createArchitectureNotification, Hi as clearAgentPreference, Hr as lifecycleItemLabel, Ht as branchOf, I as settleQueue, Ii as shortNameOf, In as holdWorktree, Ir as workspaceStamps, It as QUOTE_LIMITS, J as writeServerRecord, Ji as agentById, Jn as fetchHead, Jr as queueAddMany, Jt as eventName, Ki as STORE_ROOT, Kn as followedBranch, Kr as sectionOf, Kt as createPrState, L as readIndexToken, Li as shorthandOf, Ln as isWorktreeHeld, Lr as LIFECYCLES, Lt as REPOSITORY_SCOPE, M as runBatch, Mi as DetachedHeadError, Mn as isBusy, Mt as storeArchitecture, N as activateQueued, Ni as isCommitReview, Nn as withReviewLock, Nt as storedScopes, O as batchIdentity, Oi as WITHHELD_REASON, On as escapeHtml$1, Or as presentedKissRunOf, Ot as loadArchitecture, P as compactQueue, Pi as resolveBase, Pn as MANAGED_ROOT, Pr as touchWorkspace, Pt as trackedFiles, Q as parseWorkspacePort, Qi as AgentCancelledError, Qn as allJobs, Qr as doneVerb, Qt as markReadForReview, Ri as git, Rn as readMarker, Rr as activityAttributes, Rt as ancestorsOf, S as beginRun, Si as wasReassessed, Sn as authorPreview, Sr as latestKissRun, St as recordRuntimeBestEffort, T as reportRun, Ti as extractJsonText, Tn as renderMarkdown, Tt as formatDuration, U as serverEntryExists, Ui as readAgentPreference, Un as findExistingReview, Ur as lifecyclePill, Ut as subjectOf, V as readServerRecord, Vi as resolveModel, Vr as lifecycleChip, Vt as announceJob, W as spawnServer, Wi as writeAgentPreference, Wn as checkCodeFreshness, Wr as offersLifecycle, Wt as categoryOf, X as MAX_WORKSPACE_PORT, Xi as detectAgents, Xn as fillFileUrlTemplate, Xr as queueStamp, Xt as markAllRead, Y as DEFAULT_WORKSPACE_PORT, Yi as agentFor$1, Yn as forgeResolver, Yr as queueRemove, Yt as listNotifications, Z as MIN_WORKSPACE_PORT, Zi as isAgentId, Zn as RUN_RECORD_RETENTION_MS, Zr as readQueue, Zt as markRead, _i as gradeScale, _n as isUnchanged, _r as groupByLineage, _t as BUILD_VERSION, a as wasBlocked, ai as processDiscussion, an as toneOf, ar as saveJob, at as settleReview, b as track, bi as reassessIn, bn as chatConversationSection, br as kissDecisionRefusal, bt as waitingHistory, c as RefreshUnavailableError, ci as explanationOf, cn as withUsageRecorded, cr as isTerminalJobPhase, d as mergeUpdateInto, di as ANALYSIS_ONLY, dn as adoptLegacyBaseline, dr as purposeOf, dt as record, ei as isQuestionOutstanding, en as pruneNotifications, er as endedAt, et as statedWorkspacePort, f as updateReview, fi as analysisRefOf, fn as prepareConversationWithin, gi as findingIn, gn as refreshPrContext, gr as followedRefName, h as liveUpdateFor, hi as findingAssessment, hn as unforeseenFailure, hr as decideKissRecommendation, ht as telemetryUploadConsent, i as liveJobsFor, ii as reviewerDispositions, in as retireNotification, ir as pruneJobResidue, it as prepareReview, j as unsupportedReason, ji as originRemote, jn as ReviewBeingDeletedError, jr as reviewedCommit, jt as repositoryKey, k as extractPullRequestLinks, ki as kissOutcome, kn as renderInlineText, kr as previousKissResult, kt as partFiles, l as cancelUpdate, li as isExplanationAction, ln as existingPaths, lr as phasesFor, m as UpdateAlreadyRunningError, mi as currentGradeIn, mn as storedConversation, mt as recordTelemetryUploadConsent, n as deleteReview, ni as questionsOutstanding, nn as readStateOf, nr as isTerminal, nt as failureOf$1, o as discardJob, oi as recommendationsOf, on as unreadAround, ot as reanalyseReview, p as askCheckout, pi as assessmentLookup, pn as saveRefresh, pr as isClaimed, qi as AGENT_IDS, qn as reviewedShaOf, qr as queueAdd, qt as createPrUpdate, r as lineageIds, ri as resolvedByConversation, rn as removeNotification, rr as loadJob, rt as observeReview, s as FETCH_TIMEOUT_MS, si as explanationActionOf, sn as unreadCount$1, sr as isLiveJob, st as runJob, t as deleteLineage, ti as issuesOutstanding, tn as readNotification, tr as fail$1, tt as writePortPreference, u as cancellableHere, ui as withExplanation, un as ASK_REREAD_CEILING_MS, ur as progressSteps, ut as readEvents, v as startKissJob, vi as isGradeFor, vn as agentEnvOf, vr as indexKeptIds, w as endRun, wi as asString, wn as GITHUB_MARKDOWN, wr as loadWorkspace, wt as describeRuntimes, x as RUN_KINDS, xi as sourcePhrase, xn as UNESTABLISHED_MOTIVATION, xr as kissDecisionsOf, xt as mapRuntimes, y as isDriving, yi as promptGrade, yn as EXPLAIN_SIMPLY_PROMPT, yr as indexReviewGroups, yt as feedbackUrl, z as clearServerRecordOwnedBy, zi as refExists, zn as removeWorktree, zr as activityLabel, zt as isArchitectureId } from "./delete_review-CYiIfV5A.js";
+import { $ as MIN_WORKSPACE_PORT, $i as agentIdentityOf, $n as RUN_RECORD_RETENTION_MS, $r as readQueue, $t as markRead, A as batchIdentity, Ai as WITHHELD_REASON, An as escapeHtml$1, Ar as presentedKissRunOf, At as loadArchitecture, Bi as git, Bn as readMarker, Br as activityAttributes, Bt as ancestorsOf, C as RUN_KINDS, Ci as sourcePhrase, Cn as UNESTABLISHED_MOTIVATION, Cr as kissDecisionsOf, Ct as mapRuntimes, D as reportRun, Di as extractJsonText, Dn as renderMarkdown, Dt as formatDuration, E as endRun, Ei as asString, En as GITHUB_MARKDOWN, Er as loadWorkspace, Et as describeRuntimes, F as activateQueued, Fi as isCommitReview, Fn as withReviewLock, Ft as storedScopes, G as serverEntryExists, Gi as clearAgentPreference, Gn as findExistingReview, Gr as lifecyclePill, Gt as subjectOf, Hi as resolveAgent, Hn as requestJobStop, Hr as isLifecycle, Ht as writeJsonAtomically, I as compactQueue, Ii as resolveBase, In as MANAGED_ROOT, Ir as touchWorkspace, It as trackedFiles, Jn as followedBranch, Jr as sectionOf, Jt as createPrState, K as spawnServer, Ki as readAgentPreference, Kn as checkCodeFreshness, Kr as offersLifecycle, Kt as categoryOf, Li as AmbiguousRefError, Ln as createWorktree, Lr as workspaceRevision, Lt as ownersOf, M as parsePullRequestLink, Mi as resolveTarget, Mr as recentWorkspaces, Mt as readArchitecture, N as unsupportedReason, Ni as originRemote, Nn as ReviewBeingDeletedError, Nr as reviewedCommit, Nt as repositoryKey, O as stopRun, Oi as objectWithAnyOf, On as CODE_BLOCK_CLASS, Or as mutateWorkspace, Ot as ARCHITECTURE_DIR, P as runBatch, Pi as DetachedHeadError, Pn as isBusy, Pt as storeArchitecture, Q as MAX_WORKSPACE_PORT, Qi as agentFor$1, Qn as fillFileUrlTemplate, Qr as queueStamp, Qt as markAllRead, R as settleQueue, Ri as shortNameOf, Rn as holdWorktree, Rr as workspaceStamps, Rt as QUOTE_LIMITS, S as track, Si as reassessIn, Sn as chatConversationSection, Sr as kissDecisionRefusal, St as waitingHistory, T as completeRun, Ti as followUpFindingId, Tn as hasAuthorContent, Tr as lineagePosition, Tt as RUNTIME_WORDS, U as readServerRecord, Ui as resolveModel, Ur as lifecycleChip, Ut as announceJob, V as clearServerRecordOwnedBy, Vi as refExists, Vn as removeWorktree, Vr as activityLabel, Vt as isArchitectureId, Wi as agentIdOf, Wr as lifecycleItemLabel, Wt as branchOf, X as writeServerRecord, Xi as AGENT_IDS, Xn as fetchHead, Xr as queueAddMany, Xt as eventName, Yi as STORE_ROOT, Yn as reviewedShaOf, Yr as queueAdd, Yt as createPrUpdate, Z as DEFAULT_WORKSPACE_PORT, Zi as agentById, Zn as forgeResolver, Zr as queueRemove, Zt as listNotifications, _i as findingAssessment, _n as unforeseenFailure, _r as decideKissRecommendation, _t as telemetryUploadConsent, a as wasBlocked, aa as AgentUnavailableError, ai as resolvedByConversation, an as removeNotification, ar as loadJob, at as observeReview, b as startKissJob, bi as isGradeFor, bn as agentEnvOf, br as indexKeptIds, c as RefreshUnavailableError, ci as recommendationsOf, cn as unreadAround, ct as reanalyseReview, d as mergeUpdateInto, di as isExplanationAction, dn as existingPaths, dr as phasesFor, ea as detectAgents, ei as doneVerb, en as markReadForReview, er as allJobs, et as parseWorkspacePort, fi as withExplanation, fn as ASK_REREAD_CEILING_MS, fr as progressSteps, ft as readEvents, g as liveUpdateFor, gi as currentGradeIn, gn as storedConversation, gt as recordTelemetryUploadConsent, h as UpdateAlreadyRunningError, hi as assessmentLookup, hn as saveRefresh, hr as isClaimed, i as liveJobsFor, ia as AgentCancelledError, ii as questionsOutstanding, in as readStateOf, ir as isTerminal, it as failureOf$1, j as extractPullRequestLinks, ji as kissOutcome, jn as renderInlineText, jr as previousKissResult, jt as partFiles, k as relativeTime$1, ki as describeAuthorship, kn as CODE_COPY_CLASS, kt as checkArchitecture, l as cancelUpdate, li as explanationActionOf, ln as unreadCount$1, lr as isLiveJob, lt as runJob, m as askCheckout, mi as analysisRefOf, mn as prepareConversationWithin, n as deleteReview, na as parkedReason, ni as isQuestionOutstanding, nn as pruneNotifications, nr as endedAt, nt as statedWorkspacePort, o as discardJob, oi as reviewerDispositions, on as retireNotification, or as pruneJobResidue, ot as prepareReview, p as updateReview, pi as ANALYSIS_ONLY, pn as adoptLegacyBaseline, pr as purposeOf, pt as record, q as stopChild, qi as writeAgentPreference, qn as checkReview, qr as parseLifecycle, qt as createArchitectureNotification, r as lineageIds, ra as runnableAgents, ri as issuesOutstanding, rn as readNotification, rr as fail$1, rt as writePortPreference, s as FETCH_TIMEOUT_MS, si as processDiscussion, sn as toneOf, sr as saveJob, st as settleReview, t as deleteLineage, ta as isAgentId, ti as isIssueOutstanding, tn as moveIds, tr as attemptIdOf, tt as resolveWorkspacePort, u as cancellableHere, ui as explanationOf, un as withUsageRecorded, ur as isTerminalJobPhase, v as kissAgentId, vi as findingIn, vn as refreshPrContext, vr as followedRefName, w as beginRun, wi as wasReassessed, wn as authorPreview, wr as latestKissRun, wt as recordRuntimeBestEffort, x as isDriving, xi as promptGrade, xn as EXPLAIN_SIMPLY_PROMPT, xr as indexReviewGroups, xt as feedbackUrl, yi as gradeScale, yn as isUnchanged, yr as groupByLineage, yt as BUILD_VERSION, z as readIndexToken, zi as shorthandOf, zn as isWorktreeHeld, zr as LIFECYCLES, zt as REPOSITORY_SCOPE } from "./delete_review-CFVFygqb.js";
 import { basename, isAbsolute, join, relative, resolve } from "node:path";
 import { execFile } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
@@ -4228,7 +4228,7 @@ function renderFailureBody(job, options = {}) {
 	if (job.failure.stopped) return `<p>${options.lead === false ? "" : "<strong>Review stopped.</strong> "}Nothing went wrong, and what it had finished is kept.</p>
   <button type="button" class="prb-job-retry" data-job-retry>Carry on</button>
   <p class="prb-job-note">It picks up from the ${escapeHtml$1(noun)}, not from the start.</p>`;
-	const next = job.failure.kind === "agent_authentication_failed" ? `<p class="prb-job-note">Signing that agent in is what changes this. Once it is signed in, update the review.</p>` : `<button type="button" class="prb-job-retry" data-job-retry>Retry</button>
+	const next = job.failure.parked ? "" : job.failure.kind === "agent_authentication_failed" ? `<p class="prb-job-note">Signing that agent in is what changes this. Once it is signed in, update the review.</p>` : `<button type="button" class="prb-job-retry" data-job-retry>Retry</button>
   <p class="prb-job-note">Retry picks up from the ${escapeHtml$1(noun)}, not from the start.</p>`;
 	return `<p>${options.lead === false ? "" : "<strong>Review paused.</strong> "}${escapeHtml$1(job.failure.message)}</p>
   ${next}`;
@@ -7701,6 +7701,8 @@ function startArchitectureRun(workspace, scope, deps = {}) {
 	const now = deps.now ?? Date.now;
 	const startedAt = now();
 	const env = agentEnvOf(workspace);
+	const parked = parkedReason(env.agentId);
+	if (parked) return { refused: parked };
 	const agent = agentFor$1(env);
 	const requestedModel = resolveModel({ review: { session: workspace.session } }) ?? void 0;
 	const record = {
@@ -10489,6 +10491,7 @@ function readSettings() {
 		},
 		agent: readAgentPreference(),
 		agents: AGENT_IDS,
+		agentParked: parkedReason(readAgentPreference() ?? void 0) ?? null,
 		usageCounts: telemetryUploadConsent(),
 		theme: readPreferences().theme ?? "system"
 	};
@@ -10513,6 +10516,11 @@ function saveSettings(change, minPort, maxPort) {
 			error: `\`${change.port}\` is not a port PR Review Buddy can use. Choose one between ${minPort} and ${maxPort}.`
 		};
 	}
+	const parked = change.agent ? parkedReason(change.agent) : void 0;
+	if (parked) return {
+		settings: readSettings(),
+		error: parked
+	};
 	if (change.agent !== void 0 && change.agent !== "" && !AGENT_IDS.includes(change.agent)) return {
 		settings: readSettings(),
 		error: `There is no agent called \`${change.agent}\`.`
@@ -10668,11 +10676,15 @@ function renderReviewsSection(settings) {
     <h2>Reviews</h2>
     <label class="prb-field prb-settings-field">
       <span>Default coding agent</span>
-      <select data-settings-agent aria-describedby="prb-agent-help">${[`<option value=""${settings.agent ? "" : " selected"}>Ask each time</option>`, ...settings.agents.map((id) => `<option value="${escapeHtml$1(id)}"${settings.agent === id ? " selected" : ""}>${escapeHtml$1(id)}</option>`)].join("")}</select>
+      <select data-settings-agent aria-describedby="prb-agent-help">${[
+		`<option value=""${settings.agent ? "" : " selected"}>Ask each time</option>`,
+		...settings.agents.map((id) => `<option value="${escapeHtml$1(id)}"${settings.agent === id ? " selected" : ""}>${escapeHtml$1(id)}</option>`),
+		...settings.agentParked && settings.agent ? [`<option value="${escapeHtml$1(settings.agent)}" selected disabled>${escapeHtml$1(settings.agent)} (turned off)</option>`] : []
+	].join("")}</select>
     </label>
     <p class="prb-settings-help" id="prb-agent-help">Used when a review does not name one. PR Review
     Buddy uses an agent already installed on this machine and its existing sign-in, so this changes
-    which one runs and never asks you for a credential.</p>
+    which one runs and never asks you for a credential.</p>${settings.agentParked ? `\n    <p class="prb-settings-help" role="alert">${escapeHtml$1(settings.agentParked)} Choose another default, or Ask each time.</p>` : ""}
   </section>`;
 }
 /**
@@ -11602,11 +11614,7 @@ function modelHelpOf(agentId) {
 	}
 }
 function agentNameOf(agentId) {
-	try {
-		return agentById(agentId).displayName;
-	} catch {
-		return agentId;
-	}
+	return isAgentId(agentId) ? agentIdentityOf(agentId).displayName : agentId;
 }
 var refuse = (status, error, extra = {}) => ({
 	status,
@@ -12793,7 +12801,7 @@ function reviewHref(review) {
 }
 /** The agent's name, only where the record names one this build knows. */
 function agentName(agentId) {
-	return agentId && isAgentId(agentId) ? agentById(agentId).displayName : void 0;
+	return agentId && isAgentId(agentId) ? agentIdentityOf(agentId).displayName : void 0;
 }
 /** Who asked and who ran it, each only when known. Two facts, never one guessed from the other. */
 function provenance(source, agentId) {
@@ -15996,6 +16004,8 @@ async function handleReanalyse(req, res, workspace) {
 	if (req.method !== "POST") return send(res, 405, { error: "Analysing a review again needs a POST." });
 	const current = workspace.jobId ? loadJob(workspace.jobId) : null;
 	if (current && (!isTerminal(current) || isClaimed(current.id))) return send(res, 409, { error: "This review is still being made. Wait for it to finish before analysing it again." });
+	const parked = parkedReason(agentIdOf(workspace.session));
+	if (parked) return send(res, 409, { error: `${parked} To analyse this review again with another agent, run \`prreviewbuddy review --review ${workspace.id} --reanalyse\` with ${runnableAgents().flags}.` });
 	await new Promise((resolve) => {
 		const run = reanalyseReview(workspace.id, void 0, () => {
 			send(res, 200, { ok: true });
@@ -16036,6 +16046,8 @@ async function handleKiss(req, res, workspace) {
 	if (!audience) return send(res, 400, { error: "A KISS review is written either for the person who wrote the code or for somebody reviewing it. Choose which before running it." });
 	const current = latestKissRun(workspace);
 	if (current && current.status === "generating" && isClaimed(current.jobId)) return send(res, 409, { error: "A KISS review of this change is already running." });
+	const parked = parkedReason(kissAgentId(workspace));
+	if (parked) return send(res, 409, { error: `${parked} A KISS review started here uses the agent this review was made with. To run one with another agent, start it from the terminal with \`--lens kiss\` and ${runnableAgents().flags}.` });
 	startKissJob({
 		workspaceId: workspace.id,
 		audience,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "prreviewbuddy",
-  "version": "0.80.3",
-  "description": "Understand code changes before you approve them. Local branch and pull request reviews with Claude Code, Codex or Gemini CLI.",
+  "version": "0.81.0",
+  "description": "Understand code changes before you approve them. Local branch and pull request reviews with Claude Code or Codex.",
   "license": "UNLICENSED",
   "homepage": "https://prreviewbuddy.com",
   "type": "module",
@@ -24,8 +24,6 @@
     "claude",
     "claude-code",
     "codex",
-    "gemini",
-    "gemini-cli",
     "ai"
   ],
   "engines": {