prreviewbuddy 0.83.3 → 0.86.1

package/dist/server.js

@@ -1,4 +1,4 @@
-import { $ as MIN_WORKSPACE_PORT, $i as resolveModel, $n as RUN_RECORD_RETENTION_MS, $r as deleteCollection, $t as markRead, A as batchIdentity, Ai as isGradeFor, An as escapeHtml$1, At as loadArchitecture, Bi as WITHHELD_REASON, Bn as readMarker, Br as LIFECYCLES, Bt as ancestorsOf, C as RUN_KINDS, Ci as ANALYSIS_ONLY, Cn as UNESTABLISHED_MOTIVATION, Cr as kissDecisionsOf, Ct as mapRuntimes, D as reportRun, Di as findingAssessment, Dn as renderMarkdown, Dr as loadWorkspace, Dt as formatDuration, E as endRun, Ei as currentGradeIn, En as GITHUB_MARKDOWN, Er as lineagePosition, Et as describeRuntimes, F as activateQueued, Fi as followUpFindingId, Fn as withReviewLock, Ft as storedScopes, G as serverEntryExists, Gi as isCommitReview, Gn as findExistingReview, Gr as lifecycleItemLabel, Gt as subjectOf, Hi as resolveTarget, Hn as requestJobStop, Hr as activityLabel, Ht as writeJsonAtomically, I as compactQueue, Ii as asString, In as MANAGED_ROOT, Ir as summarise, It as trackedFiles, Ji as shortNameOf, Jn as followedBranch, Jr as parseLifecycle, Jt as createPrState, K as spawnServer, Ki as resolveBase, Kn as checkCodeFreshness, Kr as lifecyclePill, Kt as categoryOf, Li as extractJsonText, Ln as createWorktree, Lr as touchWorkspace, Lt as ownersOf, M as parsePullRequestLink, Mi as reassessIn, Mr as previousKissResult, Mt as readArchitecture, N as unsupportedReason, Ni as sourcePhrase, Nn as ReviewBeingDeletedError, Nr as recentWorkspaces, Nt as repositoryKey, O as stopRun, Oi as findingIn, On as CODE_BLOCK_CLASS, Ot as ARCHITECTURE_DIR, P as runBatch, Pi as wasReassessed, Pn as isBusy, Pr as reviewedCommit, Pt as storeArchitecture, Q as MAX_WORKSPACE_PORT, Qi as resolveAgent, Qn as fillFileUrlTemplate, Qr as createWithMembers, Qt as markAllRead, R as settleQueue, Ri as objectWithAnyOf, Rn as holdWorktree, Rr as workspaceRevision, Rt as QUOTE_LIMITS, S as track, Si as withExplanation, Sn as chatConversationSection, Sr as kissDecisionRefusal, St as waitingHistory, T as completeRun, Ti as assessmentLookup, Tn as hasAuthorContent, Tr as lineageKey, Tt as RUNTIME_WORDS, U as readServerRecord, Ui as originRemote, Ur as isLifecycle, Ut as announceJob, V as clearServerRecordOwnedBy, Vi as kissOutcome, Vn as removeWorktree, Vr as activityAttributes, Vt as isArchitectureId, Wi as DetachedHeadError, Wr as lifecycleChip, Wt as branchOf, X as writeServerRecord, Xi as git, Xn as fetchHead, Xr as collectionsStamp, Xt as eventName, Yi as shorthandOf, Yn as reviewedShaOf, Yr as sectionOf, Yt as createPrUpdate, Z as DEFAULT_WORKSPACE_PORT, Zi as refExists, Zn as forgeResolver, Zr as createCollection, Zt as listNotifications, _i as processDiscussion, _n as unforeseenFailure, _r as decideKissRecommendation, _t as telemetryUploadConsent, a as wasBlocked, aa as STORE_ROOT, ai as queueAdd, an as removeNotification, ar as loadJob, at as observeReview, b as startKissJob, bi as explanationOf, bn as agentEnvOf, br as indexKeptIds, c as RefreshUnavailableError, ca as agentFor$1, ci as queueStamp, cn as unreadAround, ct as reanalyseReview, d as mergeUpdateInto, da as isAgentId, di as isIssueOutstanding, dn as existingPaths, dr as phasesFor, ea as agentIdOf, ei as nameProblemText, en as markReadForReview, er as allJobs, et as parseWorkspacePort, fa as parkedReason, fi as isQuestionOutstanding, fn as ASK_REREAD_CEILING_MS, fr as progressSteps, ft as readEvents, g as liveUpdateFor, gi as reviewerDispositions, gn as storedConversation, gt as recordTelemetryUploadConsent, h as UpdateAlreadyRunningError, ha as AgentUnavailableError, hi as resolvedByConversation, hn as saveRefresh, hr as isClaimed, i as liveJobsFor, ii as updateCollections, in as readStateOf, ir as isTerminal, it as failureOf$1, j as extractPullRequestLinks, ji as promptGrade, jn as renderInlineText, jr as presentedKissRunOf, jt as partFiles, k as relativeTime$1, ki as gradeScale, kn as CODE_COPY_CLASS, kr as mutateWorkspace, kt as checkArchitecture, l as cancelUpdate, la as agentIdentityOf, li as readQueue, ln as unreadCount$1, lr as isLiveJob, lt as runJob, m as askCheckout, ma as AgentCancelledError, mi as questionsOutstanding, mn as prepareConversationWithin, n as deleteReview, na as readAgentPreference, ni as renameCollection, nn as pruneNotifications, nr as endedAt, nt as statedWorkspacePort, o as discardJob, oa as AGENT_IDS, oi as queueAddMany, on as retireNotification, or as pruneJobResidue, ot as prepareReview, p as updateReview, pa as runnableAgents, pi as issuesOutstanding, pn as adoptLegacyBaseline, pr as purposeOf, pt as record, q as stopChild, qi as AmbiguousRefError, qn as checkReview, qr as offersLifecycle, qt as createArchitectureNotification, r as lineageIds, ra as writeAgentPreference, ri as setMembership, rn as readNotification, rr as fail$1, rt as writePortPreference, s as FETCH_TIMEOUT_MS, sa as agentById, si as queueRemove, sn as toneOf, sr as saveJob, st as settleReview, t as deleteLineage, ta as clearAgentPreference, ti as readCollections, tn as moveIds, tr as attemptIdOf, tt as resolveWorkspacePort, u as cancellableHere, ua as detectAgents, ui as doneVerb, un as withUsageRecorded, ur as isTerminalJobPhase, v as kissAgentId, vi as recommendationsOf, vn as refreshPrContext, vr as followedRefName, w as beginRun, wi as analysisRefOf, wn as authorPreview, wr as latestKissRun, wt as recordRuntimeBestEffort, x as isDriving, xi as isExplanationAction, xn as EXPLAIN_SIMPLY_PROMPT, xr as indexReviewGroups, xt as feedbackUrl, yi as explanationActionOf, yn as isUnchanged, yr as groupByLineage, yt as BUILD_VERSION, z as readIndexToken, zi as describeAuthorship, zn as isWorktreeHeld, zr as workspaceStamps, zt as REPOSITORY_SCOPE } from "./delete_review-BED4mPxB.js";
+import { $ as MIN_WORKSPACE_PORT, $i as AmbiguousRefError, $n as RUN_RECORD_RETENTION_MS, $r as deleteCollection, $t as markRead, A as batchIdentity, Ai as findingAssessment, An as escapeHtml$1, At as loadArchitecture, Bi as wasReassessed, Bn as readMarker, Br as LIFECYCLES, Bt as ancestorsOf, C as RUN_KINDS, Ci as withExplanation, Cn as UNESTABLISHED_MOTIVATION, Cr as kissDecisionsOf, Ct as mapRuntimes, D as reportRun, Di as assessmentLookup, Dn as renderMarkdown, Dr as loadWorkspace, Dt as formatDuration, E as endRun, Ei as analysisRefOf, En as GITHUB_MARKDOWN, Er as lineagePosition, Et as describeRuntimes, F as activateQueued, Fi as isOffered, Fn as withReviewLock, Ft as storedScopes, G as serverEntryExists, Gi as describeAuthorship, Gn as findExistingReview, Gr as lifecycleItemLabel, Gt as subjectOf, Hi as asString, Hn as requestJobStop, Hr as activityLabel, Ht as writeJsonAtomically, I as compactQueue, Ii as promptGrade, In as MANAGED_ROOT, Ir as summarise, It as trackedFiles, Ji as resolveTarget, Jn as followedBranch, Jr as parseLifecycle, Jt as createPrState, K as spawnServer, Ki as WITHHELD_REASON, Kn as checkCodeFreshness, Kr as lifecyclePill, Kt as categoryOf, Li as reassessIn, Ln as createWorktree, Lr as touchWorkspace, Lt as ownersOf, M as parsePullRequestLink, Mi as findingStatus, Mr as previousKissResult, Mt as readArchitecture, N as unsupportedReason, Ni as gradeScale, Nn as ReviewBeingDeletedError, Nr as recentWorkspaces, Nt as repositoryKey, O as stopRun, Oi as closesFinding, On as CODE_BLOCK_CLASS, Ot as ARCHITECTURE_DIR, P as runBatch, Pi as isGradeFor, Pn as isBusy, Pr as reviewedCommit, Pt as storeArchitecture, Q as MAX_WORKSPACE_PORT, Qi as resolveBase, Qn as fillFileUrlTemplate, Qr as createWithMembers, Qt as markAllRead, R as settleQueue, Ri as sourcePhrase, Rn as holdWorktree, Rr as workspaceRevision, Rt as QUOTE_LIMITS, S as track, Si as isExplanationAction, Sn as chatConversationSection, Sr as kissDecisionRefusal, St as waitingHistory, T as completeRun, Ti as NO_STATUS, Tn as hasAuthorContent, Tr as lineageKey, Tt as RUNTIME_WORDS, U as readServerRecord, Ui as extractJsonText, Ur as isLifecycle, Ut as announceJob, V as clearServerRecordOwnedBy, Vi as followUpFindingId, Vn as removeWorktree, Vr as activityAttributes, Vt as isArchitectureId, Wi as objectWithAnyOf, Wr as lifecycleChip, Wt as branchOf, X as writeServerRecord, Xi as DetachedHeadError, Xn as fetchHead, Xr as collectionsStamp, Xt as eventName, Yi as originRemote, Yn as reviewedShaOf, Yr as sectionOf, Yt as createPrUpdate, Z as DEFAULT_WORKSPACE_PORT, Zi as isCommitReview, Zn as forgeResolver, Zr as createCollection, Zt as listNotifications, _ as runningJobs, _a as isAgentId, _i as verdictClosure, _n as unforeseenFailure, _r as decideKissRecommendation, _t as telemetryUploadConsent, a as wasBlocked, aa as resolveModel, ai as queueAdd, an as removeNotification, ar as loadJob, at as observeReview, b as startKissJob, ba as AgentCancelledError, bi as explanationActionOf, bn as agentEnvOf, br as indexKeptIds, c as RefreshUnavailableError, ca as readAgentPreference, ci as queueStamp, cn as unreadAround, ct as reanalyseReview, d as mergeUpdateInto, da as STORE_ROOT, di as isIssueOutstanding, dn as existingPaths, dr as phasesFor, ea as shortNameOf, ei as nameProblemText, en as markReadForReview, er as allJobs, et as parseWorkspacePort, fa as AGENT_IDS, fi as isQuestionOutstanding, fn as ASK_REREAD_CEILING_MS, fr as progressSteps, ft as readEvents, g as liveUpdateFor, ga as detectAgents, gi as reviewerDispositions, gn as storedConversation, gt as recordTelemetryUploadConsent, h as UpdateAlreadyRunningError, ha as agentIdentityOf, hi as resolvedByConversation, hn as saveRefresh, hr as isClaimed, i as liveJobsFor, ia as resolveAgent, ii as updateCollections, in as readStateOf, ir as isTerminal, it as failureOf$1, j as extractPullRequestLinks, ji as findingIn, jn as renderInlineText, jr as presentedKissRunOf, jt as partFiles, k as relativeTime$1, ki as currentGradeIn, kn as CODE_COPY_CLASS, kr as mutateWorkspace, kt as checkArchitecture, l as cancelUpdate, la as writeAgentPreference, li as readQueue, ln as unreadCount$1, lr as isLiveJob, lt as runJob, m as askCheckout, ma as agentFor$1, mi as questionsOutstanding, mn as prepareConversationWithin, n as deleteReview, na as git, ni as renameCollection, nn as pruneNotifications, nr as endedAt, nt as statedWorkspacePort, o as discardJob, oa as agentIdOf, oi as queueAddMany, on as retireNotification, or as pruneJobResidue, ot as prepareReview, p as updateReview, pa as agentById, pi as issuesOutstanding, pn as adoptLegacyBaseline, pr as purposeOf, pt as record, q as stopChild, qi as kissOutcome, qn as checkReview, qr as offersLifecycle, qt as createArchitectureNotification, r as lineageIds, ra as refExists, ri as setMembership, rn as readNotification, rr as fail$1, rt as writePortPreference, s as FETCH_TIMEOUT_MS, sa as clearAgentPreference, si as queueRemove, sn as toneOf, sr as saveJob, st as settleReview, t as deleteLineage, ta as shorthandOf, ti as readCollections, tn as moveIds, tr as attemptIdOf, tt as resolveWorkspacePort, u as cancellableHere, ui as doneVerb, un as withUsageRecorded, ur as isTerminalJobPhase, v as kissAgentId, va as parkedReason, vi as processDiscussion, vn as refreshPrContext, vr as followedRefName, w as beginRun, wi as ANALYSIS_ONLY, wn as authorPreview, wr as latestKissRun, wt as recordRuntimeBestEffort, x as isDriving, xa as AgentUnavailableError, xi as explanationOf, xn as EXPLAIN_SIMPLY_PROMPT, xr as indexReviewGroups, xt as feedbackUrl, ya as runnableAgents, yi as recommendationsOf, yn as isUnchanged, yr as groupByLineage, yt as BUILD_VERSION, z as readIndexToken, zi as statusLookup, zn as isWorktreeHeld, zr as workspaceStamps, zt as REPOSITORY_SCOPE } from "./delete_review-rwn_-SnJ.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";
@@ -553,6 +553,8 @@ var MESSAGE_ACTIONS_CLASS = "pr-helper-chat-actions";
 var MESSAGE_SOURCE_ATTR = "data-copy-source";
 /** A finding's text for a feedback draft, on its feedback checkbox. Copy's text less the reviewer's own working. */
 var FEEDBACK_SOURCE_ATTR = "data-feedback-source";
+/** The finding's readable reference (`I3`), beside its feedback text, where the host draws references. */
+var FEEDBACK_REF_ATTR = "data-feedback-ref";
 var STATES$1 = {
 	idle: {
 		icon: "<path d=\"M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z\"></path><path d=\"M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z\"></path>",
@@ -705,8 +707,8 @@ function renderFeedbackSelectButton() {
 * to the review rather than to a pane, so leaving Issues does not take the tray with it, and its
 * counts are the way back to each pane.
 */
-function renderFeedbackTray() {
-	return `<div class="prb-selection-tray" data-feedback-tray role="region" aria-label="Chosen for feedback" hidden>
+function renderFeedbackTray(reviewTag) {
+	return `<div class="prb-selection-tray" data-feedback-tray role="region" aria-label="Chosen for feedback"${reviewTag ? ` data-review-tag="${escapeHtml$1(reviewTag)}"` : ""} hidden>
   <p class="prb-selection-count" aria-live="polite">
     <span data-feedback-total>${escapeHtml$1(feedbackSelectionLabel(0, 0))}</span>${renderGoto("issues")}${renderGoto("questions")}
   </p>
@@ -1300,6 +1302,63 @@ function renderFindingExplanation(explanation, options = {}) {
       </details>`;
 }
 //#endregion
+//#region ../../packages/review-harness/src/domain/ai_review/finding_ref.ts
+var PREFIX = {
+	issue: "I",
+	question: "Q"
+};
+function findingRef(kind, index) {
+	return `${PREFIX[kind]}${index + 1}`;
+}
+/** Every finding's reference by its id, for a renderer that meets the findings out of order. */
+function findingRefs(result) {
+	const refs = /* @__PURE__ */ new Map();
+	result.issues.forEach((issue, index) => refs.set(`issue:${issue.id}`, findingRef("issue", index)));
+	result.questions.forEach((question, index) => refs.set(`question:${question.id}`, findingRef("question", index)));
+	return refs;
+}
+/** The reference of one finding, or undefined when the analysis does not hold it. */
+function refOf(refs, kind, id) {
+	return refs.get(`${kind}:${id}`);
+}
+/**
+* The finding a reference names, or null. Only the exact form (`I3`, `q2` is accepted as `Q2`):
+* a reference out of range names nothing rather than the nearest finding.
+*/
+function findingAtRef(result, ref) {
+	const match = /^([IQ])([1-9]\d*)$/i.exec(ref.trim());
+	if (!match) return null;
+	const index = Number(match[2]) - 1;
+	if (match[1].toUpperCase() === "I") {
+		const finding = result.issues[index];
+		return finding === void 0 ? null : {
+			kind: "issue",
+			index,
+			finding
+		};
+	}
+	const finding = result.questions[index];
+	return finding === void 0 ? null : {
+		kind: "question",
+		index,
+		finding
+	};
+}
+/**
+* The review a set of references belongs to: `PRB-` and the first eight characters of the analysis's
+* session id. An update keeps the session, and so its references; a fresh analysis or a reanalysis
+* starts a new session and numbers its findings again, so its tag differs. A feedback draft carries
+* it, and Reconcile reads it back, so a reply to an older draft is never read against findings that
+* a later analysis happens to number the same way.
+*/
+function reviewTag(sessionId) {
+	return `PRB-${sessionId.replace(/[^a-z0-9]/gi, "").slice(0, 8).toLowerCase()}`;
+}
+/** Every review tag in a text, as `reviewTag` writes them. */
+function reviewTagsIn(text) {
+	return [...new Set([...text.matchAll(/\bPRB-([a-z0-9]{8})\b/gi)].map((match) => `PRB-${match[1].toLowerCase()}`))];
+}
+//#endregion
 //#region ../../packages/review-harness/src/domain/ui/components/pill_tooltips.ts
 /**
 * What every pill in the sidebar actually means, in one place.
@@ -2050,7 +2109,8 @@ function renderReassessmentLine(kind, assessment, now) {
 /** Who is suggesting it, by the proposal's source. */
 function proposer(source) {
 	switch (source.kind) {
-		case "buddy": return "Buddy AI";
+		case "buddy":
+		case "buddy-conversation": return "Buddy AI";
 		case "investigation": return "The repository investigation";
 		case "update": return "The update";
 		case "reviewer": return "The review";
@@ -2089,9 +2149,92 @@ function renderWaitingSuggestions(count) {
 	if (count === 0) return "";
 	return `<span class="pr-helper-closed-findings-waiting" data-closed-findings-waiting> ${count === 1 ? "1 suggestion waiting" : `${count} suggestions waiting`}</span>`;
 }
+/** A verdict as a card names it. */
+function verdictLabel$1(verdict) {
+	switch (verdict) {
+		case "resolved": return "Resolved";
+		case "needs-investigation": return "Needs investigation";
+		case "open": return "Open again";
+		case "answered": return "Answered";
+		case "partially-answered": return "Partly answered";
+		case "unanswered": return "Unanswered again";
+	}
+}
+/**
+* The words the evidence rests on, as the reviewer pasted them. Quoted, never paraphrased: they are
+* someone else's claim, and the card shows the claim rather than vouching for it.
+*/
+function renderQuotes(quotes) {
+	if (!quotes?.length) return "";
+	return quotes.map((quote) => `<blockquote class="pr-helper-reassessment-quote">${renderInlineText(quote.text)}</blockquote>`).join("");
+}
+/** What a resolution rests on, said before the places that show it. Nothing on any other verdict. */
+function renderBasis(basis) {
+	if (!basis) return "";
+	return `<p class="pr-helper-reassessment-basis" data-reassessment-basis="${basis}">${escapeHtml$1(basis === "code" ? "Buddy AI read this in the code at the reviewed commit. Check it before accepting:" : "Buddy AI read the reply as showing an assumption the issue made is false.")}</p>`;
+}
+function renderAnswer(answer) {
+	return answer ? `<p class="pr-helper-reassessment-answer">${renderInlineText(answer)}</p>` : "";
+}
+function renderStatusStep(step, now) {
+	return `<li class="pr-helper-reassessment-step">
+        <span class="pr-helper-reassessment-step-move">${step.from ? `${escapeHtml$1(verdictLabel$1(step.from))} → ` : ""}<span class="pr-helper-reassessment-to">${escapeHtml$1(verdictLabel$1(step.to))}</span></span>
+        <span class="pr-helper-reassessment-step-source">${escapeHtml$1(capitalise(sourcePhrase(step.source)))} · ${escapeHtml$1(formatRelativeTime(step.at, now))}</span>
+        ${step.reason ? `<p class="pr-helper-reassessment-reason">${renderInlineText(step.reason)}</p>` : ""}
+        ${renderAnswer(step.answer)}
+        ${renderQuotes(step.quotes)}
+        ${renderBasis(step.basis)}
+        ${renderEvidence$1(step.evidence)}
+      </li>`;
+}
+/**
+* The status the reviewer accepted from later evidence, and History behind it. Says whether the
+* finding is still open, because an accepted status is not a closed one: a partial answer and an
+* issue that needs investigating stay in the work.
+*/
+function renderStatusLine(status, now) {
+	const current = status.current;
+	if (!current) return "";
+	const last = status.history[status.history.length - 1];
+	const open = closesFinding(current) ? "" : " Still open.";
+	return `<div class="pr-helper-reassessment pr-helper-finding-verdict" data-finding-verdict="${escapeHtml$1(current)}">
+      <p class="pr-helper-reassessment-line"><span class="pr-helper-reassessment-to">${escapeHtml$1(verdictLabel$1(current))}</span> <span class="pr-helper-reassessment-source">· Accepted ${escapeHtml$1(sourcePhrase(last.source))}.${open}</span></p>
+      ${renderAnswer(last.answer)}
+      <details class="pr-helper-reassessment-history">
+        <summary class="pr-helper-reassessment-history-summary">Status history</summary>
+        <ol class="pr-helper-reassessment-steps">${status.history.map((step) => renderStatusStep(step, now)).join("")}</ol>
+      </details>
+    </div>`;
+}
+/**
+* A status waiting on the reviewer. The same answers as a grade's, under the same attribute, so a
+* host's Accept and Keep need no second wiring: Accept applies exactly this verdict, Keep declines it.
+* A proposal that would take back an accepted closure says so first.
+*/
+function renderStatusProposal(status, options) {
+	const proposal = status.pending;
+	if (!proposal) return "";
+	const actions = options.editable ? `<div class="pr-helper-reassessment-actions">
+        <button type="button" class="pr-helper-reassessment-accept" data-reassessment-decide="accepted">Accept</button>
+        <button type="button" class="pr-helper-reassessment-keep" data-reassessment-decide="declined">Keep as it is</button>
+        ${options.askMore ? "<button type=\"button\" class=\"pr-helper-reassessment-more\" data-reassessment-ask-more>Ask more →</button>" : ""}
+      </div>` : "";
+	const contradiction = proposal.contradicts && proposal.from ? `<p class="pr-helper-reassessment-contradicts" data-reassessment-contradicts>This would take back “${escapeHtml$1(verdictLabel$1(proposal.from))}”, which you accepted earlier.</p>` : "";
+	return `<div class="pr-helper-reassessment-proposal" data-reassessment-proposal="${escapeHtml$1(proposal.id)}" data-status-proposal="${escapeHtml$1(proposal.to)}">
+      <p class="pr-helper-reassessment-proposal-title">${escapeHtml$1(proposer(proposal.source))} suggests: ${escapeHtml$1(verdictLabel$1(proposal.to))}</p>
+      ${contradiction}
+      ${renderAnswer(proposal.answer)}
+      ${proposal.reason ? `<p class="pr-helper-reassessment-reason">${renderInlineText(proposal.reason)}</p>` : ""}
+      ${renderQuotes(proposal.quotes)}
+      ${renderBasis(proposal.basis)}
+      ${renderEvidence$1(proposal.evidence)}
+      ${actions}
+    </div>`;
+}
 /** The line, its History and any proposal, in the region a host replaces after a write. */
-function renderAssessmentRegion(kind, assessment, options = {}) {
-	return `<div class="pr-helper-reassessment-region" data-assessment-region>${renderReassessmentLine(kind, assessment, options.now ?? Date.now())}${renderProposal(assessment, options)}</div>`;
+function renderAssessmentRegion(kind, assessment, options = {}, status) {
+	const now = options.now ?? Date.now();
+	return `<div class="pr-helper-reassessment-region" data-assessment-region>${status ? `${renderStatusLine(status, now)}${renderStatusProposal(status, options)}` : ""}${renderReassessmentLine(kind, assessment, now)}${renderProposal(assessment, options)}</div>`;
 }
 //#endregion
 //#region ../../packages/review-harness/src/domain/ui/components/review_tabs.ts
@@ -2534,7 +2677,7 @@ function possibleReason(summary, hasDescription) {
 */
 function renderUnclearMotive(motivation, session, questions) {
 	const intent = questions.find((q) => q.category === "intent");
-	const answered = intent ? !isQuestionOutstanding(intent, new Set(session.answeredQuestionIds ?? [])) : false;
+	const answered = intent ? !isQuestionOutstanding(intent, new Set(session.answeredQuestionIds ?? []), verdictClosure(session).question) : false;
 	const hide = (yes) => yes ? " hidden" : "";
 	return `
     <section class="pr-helper-why pr-helper-why-unclear" aria-labelledby="pr-helper-why-heading"${intent ? ` data-intent-question="${escapeHtml$1(intent.id)}"` : ""}>
@@ -2562,11 +2705,11 @@ function renderOverviewTab(session, iconUrl = "", options) {
 	return `
     ${options?.authorContext ? renderAuthorContext(session, options.descriptionLink) : renderDescriptionLink(session, options?.descriptionLink)}
     ${renderWhyThisChange(result.motivation, session, result.questions, options)}
-    <section class="pr-helper-whats-changing" aria-labelledby="pr-helper-whats-changing-heading">
+    <section class="pr-helper-whats-changing" data-tour="whats-changing" aria-labelledby="pr-helper-whats-changing-heading">
       <h4 class="pr-helper-overview-heading" id="pr-helper-whats-changing-heading">What's changing</h4>
       <div class="pr-helper-review-summary pr-helper-markdown">${renderMarkdown(result.summary)}</div>
     </section>
-    <div class="pr-helper-risk-headline">
+    <div class="pr-helper-risk-headline" data-tour="risk">
       <div class="pr-helper-risk-headline-top">
         <span class="pr-helper-risk-dot pr-helper-risk-dot-${result.overallRisk}"></span>
         <span class="pr-helper-risk-headline-label">${escapeHtml$1(titleCase(result.overallRisk))} Risk</span>
@@ -2575,10 +2718,10 @@ function renderOverviewTab(session, iconUrl = "", options) {
       ${renderProvisionalReason(session)}
       ${result.recommendation ? `<div class="pr-helper-risk-headline-takeaway pr-helper-markdown">${renderMarkdown(result.recommendation)}</div>` : ""}
     </div>
-    <div class="pr-helper-overview-stats">
+    <div class="pr-helper-overview-stats" data-tour="stats">
       ${renderOverviewStat(metrics.sections, "Themes", "guide")}
       ${renderIssuesStat(issuesOutstanding(result.issues, reviewerDispositions(session)))}
-      ${renderRemainingStat(questionsOutstanding(result.questions, new Set(session.answeredQuestionIds ?? [])), "Questions", "questions", "answered")}
+      ${renderRemainingStat(questionsOutstanding(result.questions, new Set(session.answeredQuestionIds ?? []), verdictClosure(session).question), "Questions", "questions", "answered")}
       ${renderCoverageStat(session, metrics.files)}
     </div>
     ${renderSuggestedPath(result.sections, "Suggested review path")}
@@ -2621,13 +2764,13 @@ function discussionDetails(session) {
 	if (reviewThreads > 0) {
 		const outdated = stats.outdatedThreads ?? 0;
 		const state = stats.unresolvedThreads > 0 ? `${stats.unresolvedThreads} unresolved${outdated > 0 ? `, ${outdated} on outdated lines` : ""}` : "all resolved";
-		parts.push(`${reviewThreads} ${plural$2(reviewThreads, "review thread")} (${state})`);
+		parts.push(`${reviewThreads} ${plural$3(reviewThreads, "review thread")} (${state})`);
 	}
-	if (conversation > 0) parts.push(`${conversation} ${plural$2(conversation, "conversation comment")}`);
-	if (decisions > 0) parts.push(`${decisions} ${plural$2(decisions, "review decision")}`);
+	if (conversation > 0) parts.push(`${conversation} ${plural$3(conversation, "conversation comment")}`);
+	if (decisions > 0) parts.push(`${decisions} ${plural$3(decisions, "review decision")}`);
 	return parts;
 }
-function plural$2(count, word) {
+function plural$3(count, word) {
 	return count === 1 ? word : `${word}s`;
 }
 function renderExistingDiscussion(ref) {
@@ -2698,7 +2841,7 @@ function renderSuggestedPath(sections, heading) {
 	if (sections.length === 0) return "";
 	const items = sections.map((s) => `<li>${escapeHtml$1(s.title)}</li>`).join("");
 	return `
-    <div class="pr-helper-suggested-path">
+    <div class="pr-helper-suggested-path" data-tour="suggested-path">
       <h4 class="pr-helper-suggested-path-title">${escapeHtml$1(heading)}</h4>
       <ol class="pr-helper-suggested-path-list">${items}</ol>
       <p class="pr-helper-suggested-path-time">Estimated review time ≈${estimateTotalMinutes(sections)} minutes</p>
@@ -3068,8 +3211,11 @@ function renderIssuesTab(session, investigatingId, options) {
 	const dismissals = new Map((session.dismissedIssues ?? []).map((entry) => [entry.id, entry]));
 	const dispositions = reviewerDispositions(session);
 	const assess = assessmentLookup(session);
+	const statusOf = statusLookup(session);
 	const grading = gradeOptions(options, now);
+	const refs = options?.findingRefs ? findingRefs(result) : null;
 	const card = (issue) => {
+		const ref = refs ? refOf(refs, "issue", issue.id) : void 0;
 		const isDismissed = dispositions.isDismissed(issue);
 		const stale = dispositions.isStale(issue);
 		const assessment = assess("issue", issue);
@@ -3077,7 +3223,8 @@ function renderIssuesTab(session, investigatingId, options) {
     <div class="pr-helper-issue-card ${cardGradeClass("issue", assessment.current)}${issue.reconciliationStatus ? ` pr-helper-issue-${issue.reconciliationStatus}` : ""}${issue.investigationImpact ? ` pr-helper-issue-investigation-${issue.investigationImpact}` : ""}${isDismissed && !stale ? " pr-helper-issue-card-dismissed" : ""}" data-finding-card="${escapeHtml$1(issue.id)}">
       <div class="pr-helper-issue-header">
         <div class="pr-helper-issue-title-row">
-          ${options?.feedbackSelect ? renderFeedbackPick("issue", issue.title, issueFeedbackMarkdown(issue)) : ""}
+          ${options?.feedbackSelect ? renderFeedbackPick("issue", issue.title, issueFeedbackMarkdown(issue), ref) : ""}
+          ${renderFindingRef(ref)}
           <p class="pr-helper-issue-title">${renderInlineText(issue.title)}</p>
           ${renderFindingCopySource(issueMarkdown(issue, assessment), "issue")}
           ${options?.askBuddy ? renderAskBuddyMenu("issue") : ""}
@@ -3092,7 +3239,7 @@ function renderIssuesTab(session, investigatingId, options) {
         </div>
       </div>
       ${renderStaleDismissal(stale)}
-      ${renderAssessmentRegion("issue", assessment, grading)}
+      ${renderAssessmentRegion("issue", assessment, grading, statusOf("issue", issue.id))}
       <p class="pr-helper-issue-desc">${renderInlineText(issue.description)}</p>${renderCardExplanation(explanationOf(session, "issue", issue.id), options)}
       ${renderReconciliationNote(issue.reconciliationNote)}
       ${renderStatusHistory(issue.statusHistory, now)}
@@ -3103,7 +3250,7 @@ function renderIssuesTab(session, investigatingId, options) {
       ${renderInvestigationProvenance("issue", issue.id, records, now)}
       <div class="pr-helper-issue-actions">
         ${renderInvestigationActions("issue", issue.id, records, investigatingId)}
-        ${renderDismissToggle(issue, isDismissed, stale, dismissals.get(issue.id))}
+        ${renderDismissToggle(issue, isDismissed, stale, dismissals.get(issue.id), dispositions.isClosedByVerdict(issue))}
       </div>
     </div>
   `;
@@ -3113,7 +3260,7 @@ function renderIssuesTab(session, investigatingId, options) {
 	const open = result.issues.filter((issue) => isIssueOutstanding(issue, dispositions)).map(card).join("");
 	const closedIssues = result.issues.filter((issue) => !isIssueOutstanding(issue, dispositions));
 	const closed = closedIssues.map(card).join("");
-	return `<div class="pr-helper-findings-progress" role="status">${findingsProgressBody(counts.total, counts.open, doneVerb(counts))}</div>${open}${renderClosedFindings(closedFindingsSummary(counts), closed, "issues", counts.open === 0, closedIssues.filter((issue) => assess("issue", issue).pending).length)}`;
+	return `<div class="pr-helper-findings-progress" role="status">${findingsProgressBody(counts.total, counts.open, doneVerb(counts))}</div>${open}${renderClosedFindings(closedFindingsSummary(counts), closed, "issues", counts.open === 0, closedIssues.filter((issue) => assess("issue", issue).pending || statusOf("issue", issue.id).pending).length)}`;
 }
 /**
 * What to call the closed pile, by what is actually in it.
@@ -3130,7 +3277,9 @@ function closedFindingsSummary(counts) {
 		if (byConversation === counts.done) return `Resolved by the conversation (${counts.done})`;
 		return `Resolved (${counts.done})`;
 	}
-	if (byCommits === 0) return `Dismissed by you (${counts.done})`;
+	const byVerdict = counts.byVerdict ?? 0;
+	if (byCommits === 0 && byVerdict === 0) return `Dismissed by you (${counts.done})`;
+	if (byCommits === 0 && byVerdict === counts.done) return `Accepted as resolved (${counts.done})`;
 	return `Dealt with (${counts.done})`;
 }
 /**
@@ -3169,11 +3318,11 @@ function renderStaleDismissal(stale) {
 * toggle is. A reviewer agreeing with a fix changes no count, and a control that vanishes on some
 * cards is harder to explain than one that occasionally changes nothing.
 */
-function renderDismissToggle(issue, isDismissed, stale, dismissal) {
+function renderDismissToggle(issue, isDismissed, stale, dismissal, closedByVerdict = false) {
 	const label = stale ? "Dismiss again" : isDismissed ? "Reopen" : "Dismiss";
 	const settled = issue.reconciliationStatus === "resolved";
 	const settledBy = settled ? ` data-settled-by="${resolvedByConversation(issue) ? "conversation" : "code"}"` : "";
-	return `<button type="button" class="pr-helper-issue-dismiss-toggle" data-issue-dismissed="${escapeHtml$1(issue.id)}" data-dismissed="${isDismissed}"${stale ? " data-stale=\"true\"" : ""}${dismissal ? ` data-dismissed-in="${escapeHtml$1(dismissal.sessionId)}"` : ""}${settled ? ` data-settled="true"${settledBy}` : ""}>${label}</button>`;
+	return `<button type="button" class="pr-helper-issue-dismiss-toggle" data-issue-dismissed="${escapeHtml$1(issue.id)}" data-dismissed="${isDismissed}"${stale ? " data-stale=\"true\"" : ""}${dismissal ? ` data-dismissed-in="${escapeHtml$1(dismissal.sessionId)}"` : ""}${settled ? ` data-settled="true"${settledBy}` : ""}${closedByVerdict ? " data-verdict-closed=\"true\"" : ""}>${label}</button>`;
 }
 /**
 * The group an Intent question lives in, keyed like a theme's so the workspace client finds its
@@ -3185,19 +3334,21 @@ var INTENT_QUESTION_GROUP = "prb-intent";
 function questionHome(q) {
 	return q.category === "intent" ? INTENT_QUESTION_GROUP : q.sectionId;
 }
-function renderQuestionCard(q, sections, answered, records, now = Date.now(), investigatingId, options, explanation, assessment = ANALYSIS_ONLY("question", q)) {
+function renderQuestionCard(q, sections, answered, records, now = Date.now(), investigatingId, options, explanation, assessment = ANALYSIS_ONLY("question", q), ref, status = NO_STATUS("question", q.id)) {
 	const grading = gradeOptions(options, now);
 	const importanceBadge = renderGradeControl("question", assessment, grading);
 	const jumpLink = renderQuestionJump(q.file, options);
 	const settled = q.reconciliationStatus === "answered";
-	const answerToggle = `<button type="button" class="pr-helper-question-answer-toggle" data-question-answered="${escapeHtml$1(q.id)}" data-answered="${answered}"${settled ? " data-settled=\"true\"" : ""}>${answered ? "Mark as unanswered" : "Mark answered"}</button>`;
+	const verdictClosed = closesFinding(status.current);
+	const answerToggle = `<button type="button" class="pr-helper-question-answer-toggle" data-question-answered="${escapeHtml$1(q.id)}" data-answered="${answered}"${settled ? " data-settled=\"true\"" : ""}${verdictClosed ? " data-verdict-closed=\"true\"" : ""}>${answered ? "Mark as unanswered" : "Mark answered"}</button>`;
 	const investigationAnswer = q.investigationAnswer?.trim() ? `<h5>Answer from investigation</h5><p class="pr-helper-issue-desc pr-helper-investigation-answer">${renderInlineText(q.investigationAnswer)}</p>` : "";
 	const reconciliationAnswer = q.reconciliationAnswer?.trim() ? `<h5>${escapeHtml$1(reconciledAnswerHeading(q.reconciledAgainst))}</h5><p class="pr-helper-issue-desc pr-helper-investigation-answer">${renderInlineText(q.reconciliationAnswer)}</p>` : "";
 	return `
     <div class="pr-helper-question-card${answered ? " pr-helper-question-card-answered" : ""}${q.investigationImpact ? ` pr-helper-issue-investigation-${q.investigationImpact}` : ""}" data-finding-card="${escapeHtml$1(q.id)}"${questionHome(q) ? ` data-section-id="${escapeHtml$1(questionHome(q))}"` : ""}>
       <div class="pr-helper-issue-header">
         <div class="pr-helper-issue-title-row">
-          ${options?.feedbackSelect ? renderFeedbackPick("question", q.question, questionFeedbackMarkdown(q)) : ""}
+          ${options?.feedbackSelect ? renderFeedbackPick("question", q.question, questionFeedbackMarkdown(q), ref) : ""}
+          ${renderFindingRef(ref)}
           <p class="pr-helper-issue-title">${renderInlineText(q.question)}</p>
           ${renderFindingCopySource(questionMarkdown(q, assessment), "question")}
           ${options?.askBuddy ? renderAskBuddyMenu("question") : ""}
@@ -3214,7 +3365,7 @@ function renderQuestionCard(q, sections, answered, records, now = Date.now(), in
           ${importanceBadge}
         </div>
       </div>
-      ${renderAssessmentRegion("question", assessment, grading)}
+      ${renderAssessmentRegion("question", assessment, grading, status)}
       ${q.whyThisMatters ? `<h5>Why this matters</h5><p class="pr-helper-issue-desc">${renderInlineText(q.whyThisMatters)}</p>` : ""}${renderCardExplanation(explanation, options)}
       ${reconciliationAnswer}
       ${renderReconciliationNote(q.reconciliationNote)}
@@ -3245,8 +3396,8 @@ function renderQuestionCard(q, sections, answered, records, now = Date.now(), in
 function questionsProgressBody(total, outstanding) {
 	return outstanding === 0 ? `<span class="pr-helper-questions-progress-check" aria-hidden="true">✓</span><span class="pr-helper-questions-progress-count">All ${total} questions answered</span>` : `<span class="pr-helper-questions-progress-count">${outstanding} of ${total} unanswered</span>`;
 }
-function renderQuestionsProgress(questions, answered) {
-	const counts = questionsOutstanding(questions, answered);
+function renderQuestionsProgress(questions, answered, closedByVerdict) {
+	const counts = questionsOutstanding(questions, answered, closedByVerdict);
 	if (counts.total < 2) return "";
 	return `<div class="pr-helper-questions-progress" role="status">${questionsProgressBody(counts.total, counts.open)}</div>`;
 }
@@ -3261,8 +3412,13 @@ function renderQuestionsProgress(questions, answered) {
 * It carries the text the card gives a feedback draft, which is narrower than its Copy: see
 * finding_copy.ts.
 */
-function renderFeedbackPick(kind, title, feedback) {
-	return `<input type="checkbox" class="pr-helper-feedback-pick" data-feedback-pick="${kind}" ${FEEDBACK_SOURCE_ATTR}="${escapeHtml$1(feedback)}" autocomplete="off" aria-label="${escapeHtml$1(`Include in feedback: ${title.trim()}`)}">`;
+function renderFeedbackPick(kind, title, feedback, ref) {
+	const refAttr = ref ? ` ${FEEDBACK_REF_ATTR}="${ref}"` : "";
+	return `<input type="checkbox" class="pr-helper-feedback-pick" data-feedback-pick="${kind}" ${FEEDBACK_SOURCE_ATTR}="${escapeHtml$1(feedback)}"${refAttr} autocomplete="off" aria-label="${escapeHtml$1(`Include in feedback: ${title.trim()}`)}">`;
+}
+/** The card's readable reference, ahead of its title. Drawn only where the host asked for references. */
+function renderFindingRef(ref) {
+	return ref ? `<span class="pr-helper-finding-ref" data-finding-ref="${ref}">${ref}</span>` : "";
 }
 function renderQuestionJump(file, options) {
 	if (!file || options?.suppressFileJump) return "";
@@ -3279,14 +3435,17 @@ function renderQuestionsTab(session, investigatingId, options) {
 	if (result.questions.length === 0) return emptyState("No open questions.");
 	const sections = buildSectionLookup(result);
 	const answered = new Set(session.answeredQuestionIds ?? []);
-	const progress = renderQuestionsProgress(result.questions, answered);
+	const progress = renderQuestionsProgress(result.questions, answered, verdictClosure(session).question);
 	const records = session.investigations;
 	const now = Date.now();
 	const assess = assessmentLookup(session);
-	const card = (q) => renderQuestionCard(q, sections, answered.has(q.id), records, now, investigatingId, options, explanationOf(session, "question", q.id), assess("question", q));
-	const open = result.questions.filter((q) => isQuestionOutstanding(q, answered));
-	const settled = result.questions.filter((q) => !isQuestionOutstanding(q, answered));
-	const closed = settled.length === 0 ? "" : renderClosedFindings(`Answered (${settled.length})`, settled.map(card).join(""), "questions", open.length === 0, settled.filter((q) => assess("question", q).pending).length);
+	const statusOf = statusLookup(session);
+	const closedByVerdict = verdictClosure(session).question;
+	const refs = options?.findingRefs ? findingRefs(result) : null;
+	const card = (q) => renderQuestionCard(q, sections, answered.has(q.id), records, now, investigatingId, options, explanationOf(session, "question", q.id), assess("question", q), refs ? refOf(refs, "question", q.id) : void 0, statusOf("question", q.id));
+	const open = result.questions.filter((q) => isQuestionOutstanding(q, answered, closedByVerdict));
+	const settled = result.questions.filter((q) => !isQuestionOutstanding(q, answered, closedByVerdict));
+	const closed = settled.length === 0 ? "" : renderClosedFindings(`Answered (${settled.length})`, settled.map(card).join(""), "questions", open.length === 0, settled.filter((q) => assess("question", q).pending || statusOf("question", q.id).pending).length);
 	const intent = open.filter((q) => q.category === "intent");
 	const intentHtml = result.questions.some((q) => q.category === "intent") ? `
       <div class="pr-helper-question-group" data-question-group="${INTENT_QUESTION_GROUP}"${intent.length ? "" : " hidden"}>
@@ -3474,6 +3633,41 @@ function renderThemePicker(sections, selectedId) {
 	return `<div class="prb-guide-picker">${sections.map((section, index) => `<a class="prb-guide-pick" href="${escapeHtml$1(hashForSection(section.id))}" data-goto-section="${escapeHtml$1(section.id)}" data-theme-index="${index}" data-recommended-start="${section.recommendedStartingPoint}" aria-current="${section.id === selectedId}"><span class="prb-guide-pick-order">${index + 1}</span>${escapeHtml$1(section.title)}</a>`).join("")}</div>`;
 }
 //#endregion
+//#region ../../packages/review-harness/src/domain/ui/components/turn_actions.ts
+/**
+* What a finished Buddy AI turn offers under its answer, drawn the same by the page and by the client
+* on a live answer, so a reload never changes it.
+*
+* Every completed turn offers Reconcile with findings. Always, rather than when a turn looks like an
+* author's reply: whether a turn bears on the findings is the judgement the reconcile itself makes,
+* and a control that appears only sometimes is one a reviewer cannot count on. A reconcile turn
+* offers Accept all instead, while any suggestion it made is still waiting.
+*/
+/**
+* The supporting sentence, said beside the action. It names the scope, because the action reads only
+* the message of the turn it sits under: a reply split across several messages is reconciled one
+* message at a time (the route takes several turns; choosing them on the page is not built yet).
+*/
+var RECONCILE_HELP = "Reassesses existing issues and questions using only your message in this turn.";
+function renderTurnActions(turn, waiting = []) {
+	if (turn.reconciles) return renderAcceptAll(waiting);
+	return `<div class="prb-turn-actions" data-turn-actions="${turn.askedAt}">
+      <button type="button" class="prb-turn-reconcile" data-reconcile-turn="${turn.askedAt}">Reconcile with findings</button>
+      <span class="prb-turn-help">${escapeHtml$1(RECONCILE_HELP)}</span>
+    </div>`;
+}
+/**
+* Accept every suggestion a reconcile made that is still waiting, each on its own card exactly as its
+* own Accept would. Nothing when none waits.
+*/
+function renderAcceptAll(waiting) {
+	if (!waiting.length) return "";
+	const label = waiting.length === 1 ? "Accept the suggestion" : `Accept all ${waiting.length} suggestions`;
+	return `<div class="prb-turn-actions">
+      <button type="button" class="prb-turn-accept-all" data-reconcile-accept-all="${escapeHtml$1(waiting.join(" "))}">${escapeHtml$1(label)}</button>
+    </div>`;
+}
+//#endregion
 //#region ../../packages/review-harness/src/workspace/diagram_view.ts
 /**
 * The diagrams a review holds, drawn as cards in one scrolling pane.
@@ -3555,6 +3749,42 @@ function renderDrawnFrom(diagram, reviewedSha) {
 	return `<p class="prb-diagram-stale">Drawn from <code>${escapeHtml$1(diagram.commitSha.slice(0, 7))}</code>, before this review was brought up to date. Regenerate to draw it from the commit the review now describes.</p>`;
 }
 //#endregion
+//#region ../../packages/review-harness/src/workspace/guided_tour.ts
+function isGuidedTourState(value) {
+	return value === "completed" || value === "dismissed";
+}
+/**
+* Whether a review page opens the tour by itself: a live page (one with a server behind it) over a
+* standard result that no update is replacing, for a reviewer who has not already finished or
+* skipped it. Running reviews never qualify, so the tour cannot interrupt one.
+*/
+function offersGuidedTour(page) {
+	return page.live && page.hasResult && !page.updating && page.state === void 0;
+}
+/** The hash Replay opens a review at. Not a place the page knows, so the page drops it once read. */
+var TOUR_REPLAY_HASH = "#tour";
+/**
+* Whether the tour can be shown on a review: its analysis finished, and nothing is analysing or
+* updating it now. Whether the reviewer has marked it Reviewed has nothing to do with it.
+*/
+function tourEligible(review, busy) {
+	return review.hasStandardReview && !busy.has(review.id);
+}
+/**
+* The review Replay from Help opens: the one last opened, when the tour can be shown on it, and
+* otherwise the newest it can be shown on. Never a busy review, so none is chosen only when no
+* review qualifies. Replay from a review's own menu does not ask: it uses the review on screen.
+*/
+function chooseTourReview(reviews, busy) {
+	const last = reviews.filter((review) => review.lastViewedAt !== void 0).reduce((best, review) => !best || review.lastViewedAt > best.lastViewedAt ? review : best, null);
+	if (last && tourEligible(last, busy)) return last;
+	return reviews.filter((review) => tourEligible(review, busy)).reduce((best, review) => !best || review.createdAt > best.createdAt ? review : best, null);
+}
+function tourUnavailable(reviews, busy) {
+	if (chooseTourReview(reviews, busy)) return null;
+	return reviews.some((review) => review.hasStandardReview) ? "busy" : "none";
+}
+//#endregion
 //#region ../../packages/review-harness/src/domain/change_map/types.ts
 var MAP_ROLES = [
 	"intent",
@@ -5546,7 +5776,7 @@ function updateFacts(outcome) {
 		counts.affected ? `${counts.affected} to look at again` : "",
 		counts.questionsAnswered ? `${plural(counts.questionsAnswered, "question", "questions")} answered` : ""
 	].filter(Boolean);
-	const grades = counts.gradeChanges ? [`${plural(counts.gradeChanges, "grade change", "grade changes")} suggested`] : [];
+	const grades = [...counts.gradeChanges ? [`${plural(counts.gradeChanges, "grade change", "grade changes")} suggested`] : [], ...counts.decisionsChallenged ? [`${plural(counts.decisionsChallenged, "accepted answer", "accepted answers")} put back to you`] : []];
 	const basis = outcome.reassessed;
 	return [...basis && !basis.code ? [escapeHtml$1("Reassessed against the conversation")] : [`<code>${escapeHtml$1(outcome.toSha.slice(0, 7))}</code>`, ...basis?.discussion ? [escapeHtml$1("with the conversation")] : []], ...[...changes.length ? changes : ["No change to the findings"], ...grades].map(escapeHtml$1)];
 }
@@ -6151,7 +6381,12 @@ function renderWorkspace(view) {
 <link rel="stylesheet" href="/assets/sidebar.css">
 <link rel="stylesheet" href="/assets/shell.css">
 </head>
-<body data-api-base="${escapeHtml$1(view.apiBase)}"${view.token ? ` data-token="${escapeHtml$1(view.token)}" data-notifications-since="${Date.now()}"` : ""}${view.editor ? ` data-editor-label="${escapeHtml$1(view.editor.label)}" data-editor-template="${escapeHtml$1(view.editor.template)}"` : ""}${view.repoPath ? ` data-repo-path="${escapeHtml$1(view.repoPath)}"` : ""}${view.revision === void 0 ? "" : ` data-workspace-revision="${escapeHtml$1(String(view.revision))}"`} data-session-id="${escapeHtml$1(view.session.id)}" data-explain-prompt="${escapeHtml$1(EXPLAIN_SIMPLY_PROMPT)}" data-way-back="${escapeHtml$1(wayBackSentence())}" data-default-view="${session.result ? "overview" : showsProgress(view) ? "progress" : "kiss"}">
+<body data-api-base="${escapeHtml$1(view.apiBase)}"${view.token ? ` data-token="${escapeHtml$1(view.token)}" data-notifications-since="${Date.now()}"` : ""}${view.editor ? ` data-editor-label="${escapeHtml$1(view.editor.label)}" data-editor-template="${escapeHtml$1(view.editor.template)}"` : ""}${view.repoPath ? ` data-repo-path="${escapeHtml$1(view.repoPath)}"` : ""}${view.revision === void 0 ? "" : ` data-workspace-revision="${escapeHtml$1(String(view.revision))}"`} data-session-id="${escapeHtml$1(view.session.id)}" data-explain-prompt="${escapeHtml$1(EXPLAIN_SIMPLY_PROMPT)}" data-way-back="${escapeHtml$1(wayBackSentence())}" data-default-view="${session.result ? "overview" : showsProgress(view) ? "progress" : "kiss"}"${offersGuidedTour({
+		live: view.token !== void 0,
+		hasResult: Boolean(session.result),
+		updating: updating(view),
+		state: view.guidedTour
+	}) ? " data-guided-tour=\"offer\"" : ""}${view.tourBusy ? " data-tour-busy" : ""}>
 ${renderGlobalBar({
 		unread: view.unreadNotifications ?? 0,
 		live: Boolean(view.token),
@@ -6230,7 +6465,7 @@ function renderReviewBody(view, sections) {
   ${renderRail(view, sections, updating(view))}
   <main class="prb-doc">
     ${updating(view) ? renderUpdatingDoc(view) : renderReviewDoc(view, sections)}
-    ${offersFeedback(view) ? renderFeedbackTray() : ""}
+    ${offersFeedback(view) ? renderFeedbackTray(reviewTag(view.session.id)) : ""}
   </main>
   ${result ? renderAsk(view, sections, updating(view)) : ""}
   ${result ? renderAskTab() : ""}
@@ -6405,7 +6640,8 @@ function renderStandardViews(view, sections) {
         ${renderIssuesTab(session, null, {
 		askBuddy: true,
 		feedbackSelect: true,
-		reassess: true
+		reassess: true,
+		findingRefs: true
 	})}
       </section>
       <section class="prb-view" data-view="questions" hidden>
@@ -6414,7 +6650,8 @@ function renderStandardViews(view, sections) {
 		suppressFileJump: true,
 		askBuddy: true,
 		feedbackSelect: true,
-		reassess: true
+		reassess: true,
+		findingRefs: true
 	})}
       </section>
       <section class="prb-view" data-view="prcontext" hidden>
@@ -6689,6 +6926,7 @@ function renderIdMenu(view, freshness) {
 		branchItems ? `<button type="button" class="prb-menu-item" data-queue-action="${view.queued ? "remove" : "add"}">${queueItemLabel(view.queued === true)}</button>` : "",
 		canWrite ? `<button type="button" class="prb-menu-item" data-pin-toggle aria-pressed="${view.pinned === true}">${pinItemLabel(view.pinned === true)}</button>` : "",
 		`<button type="button" class="prb-menu-item" data-copy-id="${safe}">Copy review ID</button>`,
+		canWrite && view.session.result ? "<button type=\"button\" class=\"prb-menu-item\" data-tour-replay>Replay guided tour</button>" : "",
 		canWrite ? `<button type="button" class="prb-menu-item prb-menu-item-danger" data-delete="${safe}">Delete review</button>` : ""
 	].filter(Boolean);
 	return `<div class="prb-menu" data-menu data-review-menu${[
@@ -6798,7 +7036,7 @@ function renderRail(view, sections, stale = false) {
     </div>
     ${railLink("map", "diagrams", "Diagrams", diagramsBadge(diagramCount(view)), void 0, "diagram architecture")}
     ${railLink("issues", "issues", "Issues", findingsBadge(issuesOutstanding(issues, dispositions)), void 0, void 0, true)}
-    ${railLink("questions", "questions", "Questions", remainingBadge(questionsOutstanding(questions, answered), "question", "answered"), void 0, void 0, true)}
+    ${railLink("questions", "questions", "Questions", remainingBadge(questionsOutstanding(questions, answered, verdictClosure(view.session).question), "question", "answered"), void 0, void 0, true)}
     ${railLink("files", "files", "Files", totalBadge(view.changeSet.data.files.length, "files"))}
     ${view.prContext ? railLink("prcontext", "prcontext", "PR context", totalBadge(view.prContext.processed.stats.totalThreads, "PR comment threads")) : railLink("prcontext", "prcontext", "PR context", null, "No pull request was connected to this review")}`
 	}) : "";
@@ -6960,7 +7198,7 @@ function totalBadge(count, noun) {
 * with all of them", and a tick would claim the second on a review that earned the first.
 */
 /** "1 issue", "2 issues". Shared so a row's words and its badge cannot drift apart. */
-function plural$1(n, noun) {
+function plural$2(n, noun) {
 	return `${n} ${noun}${n === 1 ? "" : "s"}`;
 }
 function remainingBadge(counts, noun, verb) {
@@ -6970,16 +7208,16 @@ function remainingBadge(counts, noun, verb) {
 	};
 	if (counts.open === 0) return {
 		text: "✓",
-		label: `All ${plural$1(counts.total, noun)} ${verb}`,
+		label: `All ${plural$2(counts.total, noun)} ${verb}`,
 		done: true
 	};
 	if (counts.done === 0) return {
 		text: String(counts.open),
-		label: plural$1(counts.total, noun)
+		label: plural$2(counts.total, noun)
 	};
 	return {
 		text: String(counts.open),
-		label: `${counts.open} of ${plural$1(counts.total, noun)} left, ${counts.done} ${verb}`
+		label: `${counts.open} of ${plural$2(counts.total, noun)} left, ${counts.done} ${verb}`
 	};
 }
 /**
@@ -7003,9 +7241,9 @@ function findingsBadge(counts) {
 */
 function themeFindingsNote(counts) {
 	if (counts.total === 0) return null;
-	if (counts.open === 0) return `all ${plural$1(counts.total, "issue")} ${doneVerb(counts)}`;
-	if (counts.done === 0) return plural$1(counts.open, "issue");
-	return `${counts.open} of ${plural$1(counts.total, "issue")} left`;
+	if (counts.open === 0) return `all ${plural$2(counts.total, "issue")} ${doneVerb(counts)}`;
+	if (counts.done === 0) return plural$2(counts.open, "issue");
+	return `${counts.open} of ${plural$2(counts.total, "issue")} left`;
 }
 /**
 * `aria-label` rather than `title`: the same sentence, without a native tooltip sitting on top of
@@ -7297,7 +7535,8 @@ function renderAsk(view, sections, paused = false) {
   ${paused ? "" : renderPromptBank(view.prompts ?? [], view.promptsCollapsed === true)}
   <div class="prb-ask-log" data-ask-log>
     ${transcript.length > 0 || pending ? transcript.map((exchange) => `<div class="prb-msg prb-msg-user">${escapeHtml$1(exchange.question)}</div>
-      <div class="prb-msg prb-msg-assistant prb-md">${renderMarkdown(exchange.answer)}${renderMessageCopySource(exchange.answer)}</div>`).join("") + pendingTurn : `<div class="prb-ask-empty"${paused ? " inert" : ""}>
+      <div class="prb-msg prb-msg-assistant prb-md">${renderMarkdown(exchange.answer)}${renderMessageCopySource(exchange.answer)}</div>
+      ${paused ? "" : renderTurnActions(exchange, waitingProposals(view.session, exchange.reconciles?.proposals))}`).join("") + pendingTurn : `<div class="prb-ask-empty"${paused ? " inert" : ""}>
       <p>Ask about this change. Answers come only from the review, the diff and the repository on disk.</p>
       ${suggestions.map((text) => `<button type="button" class="prb-suggestion" data-suggestion>${escapeHtml$1(text)}</button>`).join("")}
     </div>`}
@@ -7319,6 +7558,12 @@ function renderAsk(view, sections, paused = false) {
 * The list is always present, even when empty: an empty bank with an Add button explains what
 * the feature is, where a hidden one leaves it undiscoverable until someone reads a changelog.
 */
+/** Of the suggestions a reconcile made, the ones still waiting on the reviewer on this analysis. */
+function waitingProposals(session, ids) {
+	if (!ids?.length) return [];
+	const wanted = new Set(ids);
+	return (session.findingReassessments ?? []).filter((entry) => wanted.has(entry.id) && isOffered(session, entry)).map((entry) => entry.id);
+}
 function renderPromptBank(prompts, collapsed = false) {
 	return `<div class="prb-bank" data-prompt-bank data-prompts="${escapeHtml$1(JSON.stringify(prompts))}"${collapsed ? " data-collapsed" : ""}>
     <div class="prb-bank-head">
@@ -8216,7 +8461,7 @@ function readPrStates() {
 		if (parsed.version !== VERSION$2) return {};
 		const entries = parsed.entries;
 		if (!entries || typeof entries !== "object" || Array.isArray(entries)) return {};
-		return normalise$1(entries);
+		return normalise$2(entries);
 	} catch {
 		return {};
 	}
@@ -8241,7 +8486,7 @@ function prunePrStates(states, referenced) {
 * state with no time or a time with no state says nothing, and an unknown state must not be read
 * as one this build knows.
 */
-function normalise$1(entries) {
+function normalise$2(entries) {
 	const states = {};
 	for (const [key, value] of Object.entries(entries)) {
 		if (!value || typeof value !== "object" || Array.isArray(value)) continue;
@@ -8356,7 +8601,7 @@ function readWatchDocument() {
 		if (!entries || typeof entries !== "object" || Array.isArray(entries)) return null;
 		return {
 			version,
-			entries: normalise(entries)
+			entries: normalise$1(entries)
 		};
 	} catch {
 		return null;
@@ -8369,7 +8614,7 @@ function readWatch() {
 		if (parsed.version !== VERSION) return {};
 		const entries = parsed.entries;
 		if (!entries || typeof entries !== "object" || Array.isArray(entries)) return {};
-		return normalise(entries);
+		return normalise$1(entries);
 	} catch {
 		return {};
 	}
@@ -8410,7 +8655,7 @@ function pruneWatch(watched) {
 * `notifiedSha` that survived as a number would compare unequal to every real sha and announce on
 * every cycle for ever.
 */
-function normalise(entries) {
+function normalise$1(entries) {
 	const state = {};
 	for (const [id, value] of Object.entries(entries)) {
 		if (!value || typeof value !== "object" || Array.isArray(value)) continue;
@@ -10673,7 +10918,7 @@ function readPreferences() {
 	try {
 		const parsed = JSON.parse(readFileSync(PREFERENCES_PATH, "utf8"));
 		if (!parsed || typeof parsed !== "object") return {};
-		const { askWidth, dismissedNotices, promptsCollapsed, changeMapRegister, theme, reviewSections, runsSections, reviewLayout, sidebar } = parsed;
+		const { askWidth, dismissedNotices, promptsCollapsed, changeMapRegister, theme, reviewSections, runsSections, reviewLayout, sidebar, guidedTour } = parsed;
 		return {
 			...typeof askWidth === "number" && Number.isFinite(askWidth) ? { askWidth: clampAskWidth(askWidth) } : {},
 			...Array.isArray(dismissedNotices) ? { dismissedNotices: dismissedNotices.filter((key) => typeof key === "string" && NOTICE_KEY.test(key)) } : {},
@@ -10683,7 +10928,8 @@ function readPreferences() {
 			...readReviewSections(reviewSections),
 			...readRunsSections(runsSections),
 			...readLayout(reviewLayout),
-			...readSidebar(sidebar)
+			...readSidebar(sidebar),
+			...isGuidedTourState(guidedTour) ? { guidedTour } : {}
 		};
 	} catch {
 		return {};
@@ -10745,6 +10991,21 @@ function writeSidebar(patch) {
 		}, null, 2)}\n`);
 	} catch {}
 }
+/**
+* Remember how the guided tour was first answered. The first answer stands: a replay from Help, or
+* a second window finishing a tour another already skipped, is not a new answer to the offer.
+*/
+function writeGuidedTour(state) {
+	try {
+		const current = readPreferences();
+		if (current.guidedTour) return;
+		mkdirSync(STORE_ROOT, { recursive: true });
+		writeFileSync(PREFERENCES_PATH, `${JSON.stringify({
+			...current,
+			guidedTour: state
+		}, null, 2)}\n`);
+	} catch {}
+}
 /** Remember whether "Your prompts" is folded. Read-modify-write, like every other field here. */
 function writePromptsCollapsed(collapsed) {
 	try {
@@ -11143,7 +11404,7 @@ function renderPrivacySection(settings) {
 * A record with no facts -- every one written before 0.74.0 -- gets no line, and its row looks as
 * it always did.
 */
-var plural = (count, one, many = `${one}s`) => `${count} ${count === 1 ? one : many}`;
+var plural$1 = (count, one, many = `${one}s`) => `${count} ${count === 1 ? one : many}`;
 function shortSha(sha) {
 	return sha.slice(0, 7);
 }
@@ -11155,15 +11416,15 @@ function headMoveLine(notification, facts) {
 	const where = notification.source === "branch" ? "locally" : "on the pull request";
 	const parts = [`${step(facts.fromSha, notification.headSha)} ${where}`];
 	if (facts.rewritten) parts.push("branch rewritten since the review");
-	else if (typeof facts.behind === "number" && facts.behind > 0) parts.push(`review ${plural(facts.behind, "commit")} behind`);
+	else if (typeof facts.behind === "number" && facts.behind > 0) parts.push(`review ${plural$1(facts.behind, "commit")} behind`);
 	else parts.push("review behind");
 	return parts.join(" · ");
 }
 /** The card's own words for what is left (`whatIsLeft`), so a row and a card never disagree in vocabulary. */
 function reviewLine(facts) {
 	const parts = [];
-	if (facts.openIssues > 0) parts.push(plural(facts.openIssues, "issue"));
-	if (facts.unansweredQuestions > 0) parts.push(plural(facts.unansweredQuestions, "unanswered question"));
+	if (facts.openIssues > 0) parts.push(plural$1(facts.openIssues, "issue"));
+	if (facts.unansweredQuestions > 0) parts.push(plural$1(facts.unansweredQuestions, "unanswered question"));
 	if (parts.length === 0) parts.push("Nothing flagged");
 	if (facts.risk) parts.push(`${facts.risk} risk`);
 	return parts.join(" · ");
@@ -11186,8 +11447,8 @@ function updateLine(facts) {
 	const delta = updateDelta(facts);
 	parts.push(...delta.length > 0 ? delta : ["findings unchanged"]);
 	if (facts.stillOpen > 0) parts.push(`${facts.stillOpen} still open`);
-	if (facts.questionsAnswered > 0) parts.push(`${plural(facts.questionsAnswered, "question")} answered`);
-	if (facts.unansweredQuestions > 0) parts.push(plural(facts.unansweredQuestions, "unanswered question"));
+	if (facts.questionsAnswered > 0) parts.push(`${plural$1(facts.questionsAnswered, "question")} answered`);
+	if (facts.unansweredQuestions > 0) parts.push(plural$1(facts.unansweredQuestions, "unanswered question"));
 	if (facts.fetchFailed) parts.push("remote not reached");
 	else if (facts.upToDate) parts.push("up to date");
 	return parts.join(" · ");
@@ -11223,7 +11484,7 @@ function toastFact(notification) {
 		return delta.length > 0 ? delta.slice(0, 2).join(", ") : "findings unchanged";
 	}
 	const facts = notification.facts;
-	return facts.openIssues > 0 ? plural(facts.openIssues, "issue") : facts.unansweredQuestions > 0 ? void 0 : "nothing flagged";
+	return facts.openIssues > 0 ? plural$1(facts.openIssues, "issue") : facts.unansweredQuestions > 0 ? void 0 : "nothing flagged";
 }
 /**
 * A toast's whole line: what happened, to what, and at most one fact.
@@ -11474,6 +11735,30 @@ var AGENT_PRODUCTS = ((names) => names.length <= 1 ? names[0] ?? "" : `${names.s
 * says what to type and points here for what it means. The diagrams are text on purpose.
 */
 var TOPICS = [
+	{
+		id: "welcome",
+		title: "Welcome",
+		heading: `<p class="prb-help-eyebrow">Welcome to PR Review Buddy</p>
+    <h2 class="prb-help-headline">Understand before you approve.</h2>`,
+		body: `<p>Code review isn't just about finding bugs. It's about understanding what changed, why it
+    changed, and whether those changes make sense.</p>
+    <p>AI can generate code faster than ever. But someone still needs to understand it, challenge its
+    assumptions, and take responsibility for approving it.</p>
+    <p>That's why we built PR Review Buddy.</p>
+    <p>PR Review Buddy helps you make sense of changes before you approve them. It brings together
+    code, context, conversations and AI-assisted analysis so you can focus on what matters: making
+    informed engineering decisions.</p>
+    <p>The goal isn't to replace the reviewer. It's to make the reviewer better informed.</p>
+    <h3 class="prb-help-eyebrow">Our principles</h3>
+    <dl class="prb-help-principles">
+      <div><dt>Understanding over automation</dt>
+      <dd>AI should help you reason about changes, not make decisions on your behalf.</dd></div>
+      <div><dt>Evidence over assertions</dt>
+      <dd>Findings should be grounded in the code and context, so you can investigate and challenge them.</dd></div>
+      <div><dt>You remain in control</dt>
+      <dd>Choose your AI agent, explore the analysis, and make the final judgement yourself.</dd></div>
+    </dl>`
+	},
 	{
 		id: "getting-started",
 		title: "Getting started",
@@ -11570,6 +11855,26 @@ feature:                   E</pre>
       <li><b>Delete</b> removes a review and the checkouts it was made in. See
       <a href="#reviews-and-ids">Reviews and review IDs</a>.</li>
     </ul>`
+	},
+	{
+		id: "author-replies",
+		title: "Asking the author",
+		body: `<p>Every issue and question has a reference, such as <b>I3</b> or <b>Q2</b>, shown on its
+    card. <b>Prepare feedback</b> on Issues or Questions turns the ones you choose into a draft to send
+    the author, each led by its reference, so the author can answer “Q2: …”.</p>
+    <p>When the reply comes back, paste it into Buddy AI as one message and press <b>Reconcile with
+    findings</b> under it. Only that message is read. Buddy AI reads it against the review and
+    suggests what it settles: a question answered or partly answered, an issue resolved, or one that
+    needs investigating. Each suggestion appears on its card with the words it rests on, and nothing
+    changes until you accept it.</p>
+    <p>The draft ends with the review it came from. A reply naming a different review, such as one
+    analysed afresh since, is not reconciled, because its references number different findings.</p>
+    <p>Buddy AI is asked to read the code before suggesting an issue is resolved, and to cite the lines
+    that show it. The review checks that the cited files exist, not that the code fixes anything, so
+    read the cited lines before you accept. A fix the author has not pushed, or has only promised, is
+    never suggested as resolved. A partly answered question and an issue that needs investigating stay
+    open. If a later reply or new commits contradict an answer you accepted, you are asked again
+    rather than the answer being undone.</p>`
 	},
 	{
 		id: "reviews-and-ids",
@@ -11675,7 +11980,27 @@ feature:                   E</pre>
     <div data-shortcut-table></div>`
 	}
 ];
-/** Every topic by name at the top, so one in the middle is found by reading a list, not a page. */
+/**
+* Every topic by name beside the topics, so one in the middle is found by reading a list, not a
+* page. First in the document so a keyboard or a screen reader reaches it before the prose; the
+* stylesheet places it. `help_index.ts` marks the topic being read.
+*/
+/**
+* Where the tour lives once it has been seen. `/tour` picks the review when Replay is pressed (see
+* `chooseTourReview`); with none to pick, Help says why rather than offering a button that would
+* open a review the tour cannot start on.
+*/
+function renderTourAction(tour, failed) {
+	const lead = failed ? "<strong>The guided tour couldn't start.</strong> " : "";
+	const role = failed ? " role=\"status\"" : "";
+	if (tour === "available") return `<p class="prb-help-tour">The guided tour walks through a completed review, one part at a time,
+    starting with the one you opened last. A review's &#8943; menu replays it on that review.</p>
+    <p><a class="prb-help-tour-action" href="/tour">Replay guided tour</a></p>`;
+	if (tour === "busy") return `<p class="prb-help-tour"${role}>${lead}The guided tour walks through a completed review, and every
+    one you have is being analysed or updated right now. Replay it from here once that finishes.</p>`;
+	return `<p class="prb-help-tour"${role}>${lead}The guided tour walks through a completed review, and there
+    isn't one yet. Start a review from <a href="/">Reviews</a>, then replay the tour from here once it has finished.</p>`;
+}
 function renderContents() {
 	return `<nav class="prb-help-contents" aria-label="Help topics">
     <ul>${TOPICS.map((topic) => `<li><a href="#${topic.id}">${escapeHtml$1(topic.title)}</a></li>`).join("")}</ul>
@@ -11706,13 +12031,16 @@ ${renderWorkspaceRail({
 		sidebar: view.sidebar
 	})}
 <main class="prb-index prb-help">
-  <div class="prb-page-panel">
+  <div class="prb-help-layout">
   ${renderContents()}
+  <div class="prb-page-panel">
   ${TOPICS.map((topic) => `<section class="prb-help-topic" id="${topic.id}">
-    <h2>${escapeHtml$1(topic.title)}</h2>
+    ${topic.heading ?? `<h2>${escapeHtml$1(topic.title)}</h2>`}
     ${topic.body}
+    ${topic.id === "welcome" ? renderTourAction(view.tour, view.tourFailed === true) : ""}
   </section>`).join("")}
   </div>
+  </div>
   <p class="prb-help-version">PR Review Buddy v${escapeHtml$1(BUILD_VERSION)}</p>
 </main>
 </div>
@@ -13664,6 +13992,7 @@ function gradeFragments$1(session, kind, id) {
 	const finding = findingIn(session, kind, id);
 	if (!finding) return null;
 	const assessment = findingAssessment(session.findingReassessments, kind, finding, analysisRefOf(session));
+	const status = findingStatus(session.findingReassessments, kind, id, analysisRefOf(session));
 	const options = {
 		editable: true,
 		askMore: true
@@ -13674,8 +14003,9 @@ function gradeFragments$1(session, kind, id) {
 		current: assessment.current,
 		cardClass: cardGradeClass(kind, assessment.current),
 		grade: renderGradeControl(kind, assessment, options),
-		region: renderAssessmentRegion(kind, assessment, options),
-		copy: kind === "issue" ? issueMarkdown(finding, assessment) : questionMarkdown(finding, assessment)
+		region: renderAssessmentRegion(kind, assessment, options, status),
+		copy: kind === "issue" ? issueMarkdown(finding, assessment) : questionMarkdown(finding, assessment),
+		verdictClosed: closesFinding(status.current)
 	};
 }
 /** The finding a request is about: named outright, or through the proposal it decides. */
@@ -13757,7 +14087,7 @@ function applyReassessmentRequest(workspaceId, value, now = Date.now) {
 //#endregion
 //#region ../../packages/review-harness/src/domain/ai_review/reassess_prompt.ts
 /** More than any real answer cites; a list longer than this is padding, not evidence. */
-var MAX_EVIDENCE = 10;
+var MAX_EVIDENCE$1 = 10;
 function scaleText(kind) {
 	return gradeScale(kind).map((grade) => `"${grade}"`).join(" | ");
 }
@@ -13809,7 +14139,7 @@ function buildReassessInstructions(input) {
 	];
 }
 var REASSESS_ANSWER = objectWithAnyOf("verdict", "reason");
-function readEvidence(value) {
+function readEvidence$1(value) {
 	if (!Array.isArray(value)) return [];
 	const out = [];
 	for (const item of value) {
@@ -13821,7 +14151,7 @@ function readEvidence(value) {
 			file,
 			line
 		});
-		if (out.length === MAX_EVIDENCE) break;
+		if (out.length === MAX_EVIDENCE$1) break;
 	}
 	return out;
 }
@@ -13842,7 +14172,7 @@ function parseReassessAnswer(raw, kind, current) {
 	const obj = parsed;
 	const reason = typeof obj.reason === "string" ? obj.reason.trim() : "";
 	if (!reason) return null;
-	const evidence = readEvidence(obj.evidence);
+	const evidence = readEvidence$1(obj.evidence);
 	if (obj.verdict === "keep") return {
 		verdict: "keep",
 		reason,
@@ -13925,6 +14255,267 @@ function reassessTurnText(target, turn, outcome) {
 	const move = `**Suggests ${from} → ${answer.to}.** ${answer.reason}`;
 	return outcome === "stale" ? `${move}\n\n*The grade changed while this was being answered, so the suggestion was not kept. Reassess again to judge it as it stands.*` : `${move}\n\n*Accept or keep it on the card.*`;
 }
+/** More than any finding a real reply rests on; past this it is padding. */
+var MAX_QUOTES = 4;
+var MAX_EVIDENCE = 10;
+/** The turns, labelled in the order the reviewer wrote them. */
+function labelTurns(turns) {
+	return [...turns].sort((a, b) => a.askedAt - b.askedAt).map((turn, index) => ({
+		label: `A${index + 1}`,
+		askedAt: turn.askedAt,
+		text: turn.question
+	}));
+}
+function issueLine(issue, index, assess, status) {
+	const where = issue.file ? ` [${issue.file}${issue.line ? `:${issue.line}` : ""}]` : "";
+	const severity = ` [severity: ${promptGrade(assess("issue", issue))}]`;
+	return `${findingRef("issue", index)}.${severity}${where}${priorStatus(issue.reconciliationStatus === "resolved" ? "resolved by the code" : void 0)}${acceptedLine(status("issue", issue.id))} ${issue.title.trim()}\n   ${issue.description.trim().replace(/\n/g, "\n   ")}`;
+}
+function questionLine(question, index, assess, status, ticked) {
+	const importance = assess("question", question).current ? ` [importance: ${promptGrade(assess("question", question))}]` : "";
+	const where = question.file ? ` [${question.file}]` : "";
+	const why = question.whyThisMatters?.trim() ? `\n   ${question.whyThisMatters.trim()}` : "";
+	const prior = question.reconciliationStatus === "answered" ? "answered by the code" : ticked ? "marked answered by the reviewer" : void 0;
+	return `${findingRef("question", index)}.${importance}${where}${priorStatus(prior)}${acceptedLine(status("question", question.id))} ${question.question.trim()}${why}`;
+}
+function priorStatus(text) {
+	return text ? ` [${text}]` : "";
+}
+/**
+* The verdict the reviewer accepted earlier, said as their decision and not as a fact, with what it
+* rested on, so evidence that contradicts it is recognised as a contradiction.
+*/
+function acceptedLine(status) {
+	if (!status.current) return "";
+	const last = status.history[status.history.length - 1];
+	return ` [the reviewer accepted "${status.current}" ${sourcePhrase(last.source)}${last.reason ? `: ${last.reason}` : ""}]`;
+}
+var SHAPE = `{
+  "findings": [
+    {
+      "ref": string,
+      "status": "answered" | "partially-answered" | "still-open" | "resolved" | "needs-investigation",
+      "reason": string,
+      "answer"?: string,
+      "basis"?: "premise" | "code",
+      "evidence"?: [{ "file": string, "line"?: number }],
+      "quotes": [{ "turn": string, "text": string }],
+      "severity"?: ${gradeScale("issue").map((grade) => `"${grade}"`).join(" | ")},
+      "importance"?: ${gradeScale("question").map((grade) => `"${grade}"`).join(" | ")},
+      "gradeReason"?: string
+    }
+  ],
+  "unmatched": [{ "turn": string, "text": string, "candidates": string[], "why": string }]
+}`;
+/** The block a reconcile turn adds to Buddy AI's prompt: the turns, the findings, the rules and the shape. */
+function buildReplyReconciliationInstructions(input) {
+	const { result, assess, status } = input;
+	const issues = result.issues.length ? result.issues.map((issue, index) => issueLine(issue, index, assess, status)).join("\n") : "(The review raised no issues.)";
+	const questions = result.questions.length ? result.questions.map((question, index) => questionLine(question, index, assess, status, input.answeredQuestionIds.has(question.id))).join("\n") : "(The review raised no questions.)";
+	return [
+		"---",
+		"RECONCILE WITH FINDINGS",
+		"The reviewer has asked you to read the turns below, which they wrote in this conversation, as evidence about the review's existing issues and questions. Most often they are an author's replies to feedback the reviewer sent, pasted in. Nothing you return changes a finding: each judgement becomes a suggestion the reviewer accepts or rejects on its own.",
+		"",
+		"THE TURNS (the reviewer's own messages, labelled; Buddy AI's answers are not evidence):",
+		...input.turns.map((turn) => `[${turn.label}]\n${turn.text.trim()}`),
+		"",
+		input.review.named ? `The turns name this review (${input.review.tag}), so the references in them are this review's.` : `The turns do not name this review (${input.review.tag}). A reference in them may come from a draft of an earlier analysis whose findings were numbered differently: use a reference only where what the passage says matches that finding, and otherwise treat the passage as unmatched.`,
+		"",
+		"THE FINDINGS, by the reference the review's cards and its feedback drafts use:",
+		"Issues:",
+		issues,
+		"Questions:",
+		questions,
+		"",
+		"RULES",
+		"- Match a passage to a finding by its reference where it names one (\"Q2:\", \"I3.\"), and otherwise only by what it unmistakably addresses. Never match a passage in order to produce a judgement. Where a passage could be about more than one finding, or you cannot tell which it answers, put it in \"unmatched\" with its candidate references and leave those findings out. The turns need not follow the order of the findings, one passage may address several findings, and one finding may be addressed across several turns.",
+		"- Include only the findings the turns address. Leave every other finding out: an omitted finding is one the turns do not bear on, not one that is still open.",
+		"- A question is \"answered\" only when the turns answer its substance. A reply that acknowledges it, defers it, restates it or answers a different question does not answer it. Where they answer part of it, use \"partially-answered\" and say in \"answer\" what they establish and what is still missing. Where they address it without answering it, use \"still-open\". For \"answered\" and \"partially-answered\", put the answer itself in \"answer\", in a sentence or two.",
+		"- What an author says about an issue is one of three things, and they are judged differently:",
+		"  1. The concern never held: an assumption the issue made is false (the code concerned is unreachable, is being removed, or a requirement it assumed does not exist). That may be \"resolved\" with \"basis\": \"premise\". Check the claim against the code wherever the code can settle it, and where the code contradicts it, it is not resolved.",
+		"  2. It is already implemented: the code at the reviewed commit is said to handle it. That may be \"resolved\" with \"basis\": \"code\" only after you have opened that code and read it, and only when it addresses this concern, not merely when the file exists or touches the same area. List in \"evidence\" each place, with its line, where the code does so. A file name on its own is not evidence, and neither is code that exists but does not address the concern.",
+		"  3. It is fixed somewhere you cannot read, or will be: fixed locally, in another branch, in a commit not yet pushed, or planned. That is a claim about code, not evidence, and never \"resolved\". Use \"needs-investigation\" where the claim deserves checking once the code exists, otherwise \"still-open\". Agreeing that it is a problem, with a plan to fix it later, is \"still-open\".",
+		"- \"needs-investigation\": the turns raise something that bears on the issue and that only further reading or a further question can settle. Say what in \"reason\".",
+		"- Treat what the author asserts as context, not proof. Where you can check a claim in the repository, check it before relying on it.",
+		"- A verdict the reviewer accepted earlier is marked on its finding. It was their decision, not a fact. Where the turns contradict it, report the finding as \"still-open\", with the contradiction in \"reason\", so it is put to them.",
+		"- Every judgement must quote, in \"quotes\", the exact words from the turns it rests on, copied character for character (a sentence or two each), with the turn's label. A judgement whose words cannot be found in the turn it names is discarded.",
+		`- "severity" on an issue or "importance" on a question is optional: only where the turns change how much the finding matters, never the grade it already has, and always with "gradeReason".`,
+		"- In \"reason\" and \"answer\", name the author by role (\"the author confirms the job is retired\"), and write no references or labels: the reviewer reads those sentences beside the finding.",
+		"",
+		"Respond with a single JSON object (no markdown, no surrounding text) matching exactly this shape:",
+		SHAPE,
+		"\"status\" on a question (a Q reference) is \"answered\", \"partially-answered\" or \"still-open\"; on an issue (an I reference) it is \"resolved\", \"needs-investigation\" or \"still-open\". \"basis\" and \"evidence\" go only with \"resolved\". \"severity\" goes only on an issue and \"importance\" only on a question.",
+		"Empty arrays are valid and far better than judgements the turns do not support."
+	];
+}
+var QUESTION_STATUSES = [
+	"answered",
+	"partially-answered",
+	"still-open"
+];
+var ISSUE_STATUSES = [
+	"resolved",
+	"needs-investigation",
+	"still-open"
+];
+var ANSWER = objectWithAnyOf("findings", "unmatched");
+/** Whitespace and quote marks as a model may retype them: two texts are the same words if these agree. */
+function normalise(text) {
+	return text.replace(/[‘’]/g, "'").replace(/[“”]/g, "\"").replace(/\s+/g, " ").trim();
+}
+/** The quotes found, word for word, in the turns they name. Nothing else is kept. */
+function verifiedQuotes(value, turns) {
+	if (!Array.isArray(value)) return [];
+	const byLabel = new Map(turns.map((turn) => [turn.label.toUpperCase(), turn]));
+	const kept = [];
+	for (const item of value) {
+		const quote = item;
+		if (typeof quote?.turn !== "string" || typeof quote.text !== "string") continue;
+		const turn = byLabel.get(quote.turn.trim().replace(/^\[|\]$/g, "").toUpperCase());
+		const text = normalise(quote.text);
+		if (!turn || !text || text.length > 600) continue;
+		if (!normalise(turn.text).includes(text)) continue;
+		if (kept.some((existing) => existing.askedAt === turn.askedAt && existing.text === text)) continue;
+		kept.push({
+			askedAt: turn.askedAt,
+			text
+		});
+		if (kept.length === MAX_QUOTES) break;
+	}
+	return kept;
+}
+function readEvidence(value) {
+	if (!Array.isArray(value)) return [];
+	return value.flatMap((item) => {
+		const place = item;
+		if (typeof place?.file !== "string" || !place.file.trim()) return [];
+		const line = typeof place.line === "number" && Number.isInteger(place.line) && place.line > 0 ? place.line : void 0;
+		return [{
+			file: place.file.trim(),
+			...line ? { line } : {}
+		}];
+	}).slice(0, MAX_EVIDENCE);
+}
+function text(value) {
+	return typeof value === "string" ? value.trim() : "";
+}
+/**
+* The answer, read strictly. Null when it is not an answer at all; otherwise every judgement that
+* names a finding the review holds, with a status on that finding's scale, a reason, and at least one
+* quote found in the turns. A judgement missing any of those is counted and dropped, never repaired.
+*/
+function parseReplyReconciliation(raw, result, turns) {
+	let parsed;
+	try {
+		parsed = JSON.parse(extractJsonText(raw, ANSWER));
+	} catch {
+		return null;
+	}
+	if (!ANSWER(parsed)) return null;
+	const obj = parsed;
+	const discarded = {
+		unknownRef: 0,
+		unquoted: 0
+	};
+	const judgements = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const item of Array.isArray(obj.findings) ? obj.findings : []) {
+		const entry = item;
+		const at = typeof entry?.ref === "string" ? findingAtRef(result, entry.ref) : null;
+		if (!at) {
+			discarded.unknownRef += 1;
+			continue;
+		}
+		const allowed = at.kind === "issue" ? ISSUE_STATUSES : QUESTION_STATUSES;
+		const status = entry.status;
+		const reason = text(entry.reason);
+		if (typeof status !== "string" || !allowed.includes(status) || !reason) {
+			discarded.unknownRef += 1;
+			continue;
+		}
+		const quotes = verifiedQuotes(entry.quotes, turns);
+		if (!quotes.length) {
+			discarded.unquoted += 1;
+			continue;
+		}
+		const key = `${at.kind}:${at.index}`;
+		if (seen.has(key)) continue;
+		seen.add(key);
+		const answer = text(entry.answer);
+		const basis = entry.basis === "premise" || entry.basis === "code" ? entry.basis : void 0;
+		const gradeTo = at.kind === "issue" ? entry.severity : entry.importance;
+		const gradeReason = text(entry.gradeReason);
+		judgements.push({
+			kind: at.kind,
+			index: at.index,
+			findingId: at.finding.id,
+			ref: findingRef(at.kind, at.index),
+			status,
+			reason,
+			...answer ? { answer } : {},
+			...basis ? { basis } : {},
+			evidence: readEvidence(entry.evidence),
+			quotes,
+			...isGradeFor(at.kind, gradeTo) && gradeReason ? { grade: {
+				to: gradeTo,
+				reason: gradeReason
+			} } : {}
+		});
+	}
+	return {
+		judgements,
+		unmatched: (Array.isArray(obj.unmatched) ? obj.unmatched : []).flatMap((item) => {
+			const passage = item;
+			const words = text(passage?.text);
+			if (!words) return [];
+			const candidates = (Array.isArray(passage.candidates) ? passage.candidates : []).filter((ref) => typeof ref === "string" && findingAtRef(result, ref) !== null).map((ref) => ref.trim().toUpperCase());
+			return [{
+				text: words.slice(0, 600),
+				candidates,
+				why: text(passage.why)
+			}];
+		}),
+		discarded
+	};
+}
+/** Said beside a resolution the harness could not let stand as one. */
+var UNSUPPORTED_RESOLUTION = "Treated as needing investigation: the reply was read as resolving it, but cited no line of the reviewed code that shows it.";
+/**
+* A resolution, checked against what it says it rests on, as far as the harness can check it.
+*
+* `premise` stands as the model judged it. `code` stands only with at least one cited place, with a
+* line, in a file that exists at the reviewed commit (`existing` is the set of paths found there).
+* Anything else is downgraded to "needs investigation", with the reason saying so.
+*
+* This is citation validation, not verification: a file that exists does not show that the code in it
+* fixes anything. Whether it does is the model's reading, which the prompt requires it to make by
+* opening the code, and the reviewer's to confirm before accepting. The card says as much.
+*/
+function groundResolution(judgement, existing) {
+	if (judgement.kind !== "issue" || judgement.status !== "resolved") return judgement;
+	const evidence = judgement.evidence.filter((place) => existing.has(place.file));
+	if (judgement.basis === "premise") return {
+		...judgement,
+		evidence
+	};
+	if (judgement.basis === "code" && evidence.some((place) => place.line !== void 0)) return {
+		...judgement,
+		evidence
+	};
+	return {
+		...judgement,
+		status: "needs-investigation",
+		evidence,
+		reason: `${judgement.reason} ${UNSUPPORTED_RESOLUTION}`
+	};
+}
+/** A proposal a judgement becomes on the status axis, or null when it is not one. */
+function verdictFor(judgement, current) {
+	if (judgement.status !== "still-open") return judgement.status;
+	if (!closesFinding(current)) return null;
+	return judgement.kind === "issue" ? "open" : "unanswered";
+}
 //#endregion
 //#region ../../packages/review-harness/src/workspace/ask.ts
 /** Long enough for a real look at the repository; short enough that a hang is not forever. */
@@ -14039,6 +14630,7 @@ function buildPrompt$2(workspace, question, sectionId, cwd, context = {}) {
 		"REVIEW GUIDE (JSON):",
 		JSON.stringify(workspace.session.result),
 		...reassessedGrades(workspace),
+		...acceptedStatuses(workspace),
 		"---",
 		"DIFF:",
 		workspace.diff,
@@ -14056,6 +14648,7 @@ function buildPrompt$2(workspace, question, sectionId, cwd, context = {}) {
 		...continuingFrom(workspace, context.continuing),
 		...explainingFinding(workspace, context.explaining),
 		...reassessingFinding(workspace, context.reassessing),
+		...reconcilingTurns(workspace, context.reconciling),
 		"---",
 		`QUESTION: ${question}`
 	].join("\n");
@@ -14119,6 +14712,33 @@ function reassessedGrades(workspace) {
 	];
 }
 /**
+* The statuses the reviewer has accepted from later evidence, such as an author's reply. Listed only
+* when there are some, as the reviewer's decisions rather than facts, so a turn neither re-asks a
+* question they have accepted an answer to nor treats that answer as beyond question.
+*/
+function acceptedStatuses(workspace) {
+	const result = workspace.session.result;
+	if (!result) return [];
+	const status = statusLookup(workspace.session);
+	const lines = [...result.issues.map((issue) => ({
+		name: `ISSUE "${issue.title.trim()}"`,
+		status: status("issue", issue.id)
+	})), ...result.questions.map((q) => ({
+		name: `QUESTION "${q.question.trim()}"`,
+		status: status("question", q.id)
+	}))].flatMap(({ name, status: s }) => {
+		if (!s.current) return [];
+		const last = s.history[s.history.length - 1];
+		return [`- ${name}: accepted as ${s.current}${last.reason ? ` (${last.reason})` : ""}${last.answer ? `. Answer: ${last.answer}` : ""}`];
+	});
+	if (!lines.length) return [];
+	return [
+		"---",
+		"STATUSES THE REVIEWER HAS ACCEPTED FROM LATER EVIDENCE (their decisions, which later evidence may still contradict):",
+		...lines
+	];
+}
+/**
 * Reassess on a finding: everything the judgement needs, and the exact shape of the answer. The
 * thread the analysis tied the finding to goes in when it resolves in the conversation this review
 * holds; when it does not, the turn goes ahead without it.
@@ -14138,12 +14758,290 @@ function reassessingFinding(workspace, reassessing) {
 		...thread ? { thread } : {}
 	});
 }
+/**
+* Reconcile with findings: the chosen turns, every finding by its reference with the grade and any
+* verdict the review holds now, the evidence rules and the exact shape of the answer.
+*/
+function reconcilingTurns(workspace, reconciling) {
+	const result = workspace.session.result;
+	if (!reconciling || !result) return [];
+	return buildReplyReconciliationInstructions({
+		result,
+		assess: assessmentLookup(workspace.session),
+		status: statusLookup(workspace.session),
+		answeredQuestionIds: new Set(workspace.session.answeredQuestionIds ?? []),
+		turns: reconciling.turns,
+		review: reconciling.review
+	});
+}
 /** `THE ISSUE "<title>"` or `THE QUESTION "<question>"`, or just the kind when the finding is gone. */
 function findingName(workspace, finding) {
 	const result = workspace.session.result;
 	const title = finding.kind === "issue" ? result?.issues.find((issue) => issue.id === finding.id)?.title : result?.questions.find((question) => question.id === finding.id)?.question;
 	return `THE ${finding.kind.toUpperCase()}${title ? ` "${title.trim()}"` : ""}`;
 }
+var TURNS_REFUSED = {
+	none: "Choose at least one turn of this conversation to reconcile with the findings.",
+	unknown: "This conversation has no such turn to reconcile.",
+	"too-many": `Reconcile reads at most 10 turns at once. Choose fewer.`,
+	"too-long": "Those turns are too long to read in one reconcile. Choose fewer, or paste the reply in parts."
+};
+/**
+* The turns a request names, from the transcript as stored. Only the reviewer's own turns with words
+* in them: a reconcile turn is not evidence, and neither is anything Buddy AI wrote.
+*/
+function reconcileTurnsOf(transcript, value) {
+	const asked = value?.exchanges;
+	if (!Array.isArray(asked) || asked.length === 0) return {
+		ok: false,
+		refusal: "none"
+	};
+	const wanted = [...new Set(asked)];
+	if (wanted.length > 10) return {
+		ok: false,
+		refusal: "too-many"
+	};
+	const turns = [];
+	for (const askedAt of wanted) {
+		const turn = typeof askedAt === "number" ? transcript.find((exchange) => exchange.askedAt === askedAt) : void 0;
+		if (!turn || turn.reconciles || !turn.question.trim()) return {
+			ok: false,
+			refusal: "unknown"
+		};
+		turns.push(turn);
+	}
+	if (turns.reduce((total, turn) => total + turn.question.length, 0) > 4e4) return {
+		ok: false,
+		refusal: "too-long"
+	};
+	return {
+		ok: true,
+		turns
+	};
+}
+function reviewIdentityOf(turns, sessionId) {
+	const tag = reviewTag(sessionId);
+	const named = [...new Set(turns.flatMap((turn) => reviewTagsIn(turn.question)))];
+	if (!named.length) return {
+		kind: "unnamed",
+		tag
+	};
+	if (named.some((other) => other !== tag)) return {
+		kind: "other",
+		tag,
+		named
+	};
+	return {
+		kind: "named",
+		tag
+	};
+}
+/** Why a reply naming another review is refused, in the words the page shows. */
+function otherReviewRefusal(identity) {
+	return `This reply names review ${identity.named.filter((named) => named !== identity.tag).join(" and ")}, but these findings are numbered for review ${identity.tag}. A fresh analysis numbers its findings again, so its references cannot be read against these ones. Nothing was reconciled. Prepare feedback again from this review, or reconcile the reply on the review it names.`;
+}
+/**
+* The answer, with every resolution checked against what it rests on (`groundResolution`). A check
+* that fails keeps no code evidence rather than unchecked evidence, so a code-based resolution then
+* falls to "needs investigation".
+*/
+async function readReconcileTurn(raw, result, turns, where, check = existingPaths) {
+	const reading = parseReplyReconciliation(raw, result, turns);
+	if (!reading) return {
+		reading: null,
+		raw
+	};
+	const cited = [...new Set(reading.judgements.flatMap((judgement) => judgement.status === "resolved" ? judgement.evidence.map((place) => place.file) : []))];
+	let existing = /* @__PURE__ */ new Set();
+	if (cited.length) try {
+		existing = await check(where.repoPath, cited, where.commitSha);
+	} catch {
+		existing = /* @__PURE__ */ new Set();
+	}
+	return {
+		reading: {
+			...reading,
+			judgements: reading.judgements.map((judgement) => groundResolution(judgement, existing))
+		},
+		raw
+	};
+}
+function sameSuggestion(entry, axis, to) {
+	return entry.axis === "status" === (axis === "status") && entry.to === to;
+}
+/** The exchanges a buddy-conversation entry read, or none for any other source. */
+function exchangesOf(source) {
+	return source.kind === "buddy-conversation" ? source.exchanges : [];
+}
+/**
+* Whether this suggestion is already on the ledger for this finding, in a way that means it should
+* not be written again: offered on the card now (`isOffered`, the projection's own answer), or
+* declined by the reviewer on evidence that covered every turn this one read. A proposal still marked
+* proposed but outdated or overtaken is offered by no card, so it holds nothing back. A decline on
+* less evidence does not either: later turns are new evidence.
+*/
+function heldBack(session, kind, findingId, axis, to, exchanges) {
+	for (const entry of session.findingReassessments ?? []) {
+		if (entry.kind !== kind || entry.findingId !== findingId || !sameSuggestion(entry, axis, to)) continue;
+		if (isOffered(session, entry)) return {
+			kind: "waiting",
+			entry
+		};
+		if (entry.state === "declined") {
+			const read = new Set(exchangesOf(entry.source));
+			if (exchanges.every((askedAt) => read.has(askedAt))) return { kind: "declined-before" };
+		}
+	}
+	return null;
+}
+/**
+* Writes each judgement's proposals onto the session, checked against it as it is now. Run inside
+* the store write on the fresh copy, so a finding the reviewer decided while Buddy AI was reading is
+* written against what they decided, or not at all.
+*/
+function keepReconcileTurn(session, read, exchanges, askedAt) {
+	const outcome = { judgements: [] };
+	if (!read.reading) return outcome;
+	const source = {
+		kind: "buddy-conversation",
+		exchanges: [...exchanges].sort((a, b) => a - b)
+	};
+	const analysis = analysisRefOf(session);
+	for (const judgement of read.reading.judgements) {
+		const finding = findingIn(session, judgement.kind, judgement.findingId);
+		if (!finding) {
+			outcome.judgements.push({
+				judgement,
+				status: { kind: "stale" },
+				grade: null
+			});
+			continue;
+		}
+		const current = findingStatus(session.findingReassessments, judgement.kind, judgement.findingId, analysis).current;
+		const to = verdictFor(judgement, current);
+		let status;
+		if (!to) status = { kind: "still-open" };
+		else {
+			const held = heldBack(session, judgement.kind, judgement.findingId, "status", to, source.exchanges);
+			if (held) status = held;
+			else {
+				const write = reassessIn(session, {
+					op: "propose-status",
+					kind: judgement.kind,
+					findingId: judgement.findingId,
+					from: current,
+					to,
+					reason: judgement.reason,
+					...judgement.answer ? { answer: judgement.answer } : {},
+					...judgement.basis && to === "resolved" ? { basis: judgement.basis } : {},
+					...judgement.evidence.length ? { evidence: judgement.evidence } : {},
+					quotes: judgement.quotes,
+					source
+				}, askedAt);
+				status = write.ok ? {
+					kind: "proposed",
+					entry: write.entry
+				} : { kind: "stale" };
+			}
+		}
+		let grade = null;
+		if (judgement.grade) {
+			const from = findingAssessment(session.findingReassessments, judgement.kind, finding, analysis).current;
+			grade = heldBack(session, judgement.kind, judgement.findingId, "grade", judgement.grade.to, source.exchanges);
+			if (!grade) {
+				const write = reassessIn(session, {
+					op: "propose",
+					kind: judgement.kind,
+					findingId: judgement.findingId,
+					from,
+					to: judgement.grade.to,
+					reason: judgement.grade.reason,
+					source
+				}, askedAt);
+				grade = write.ok ? {
+					kind: "proposed",
+					entry: write.entry
+				} : write.refusal === "unchanged" ? null : { kind: "stale" };
+			}
+		}
+		outcome.judgements.push({
+			judgement,
+			status,
+			grade
+		});
+	}
+	return outcome;
+}
+/** The ids of every proposal the turn wrote, for the transcript and for Accept all. */
+function proposedIds(outcome) {
+	return outcome.judgements.flatMap(({ status, grade }) => [status, grade].flatMap((result) => result && result.kind === "proposed" ? [result.entry.id] : []));
+}
+/** One judgement's line, as the conversation says it: always a suggestion, never a change made. */
+function statusPhrase(judgement, status) {
+	const to = status.kind === "proposed" || status.kind === "waiting" ? status.entry.to : null;
+	switch (status.kind) {
+		case "still-open": return "still open after this reply";
+		case "declined-before": return "not suggested again: you kept it as it was on the same evidence";
+		case "stale": return "not suggested: it changed while this was being read";
+		case "waiting":
+		case "proposed": {
+			const phrase = to === "answered" ? "may be answered" : to === "partially-answered" ? "may be partly answered" : to === "resolved" ? "may be resolved" : to === "needs-investigation" ? "needs further investigation" : to === "unanswered" ? "may no longer be answered: this reply contradicts what you accepted" : to === "open" ? "may no longer be resolved: this reply contradicts what you accepted" : null;
+			if (!phrase) return null;
+			return status.kind === "waiting" ? `${phrase} (already waiting on the card)` : phrase;
+		}
+	}
+}
+function plural(n, noun) {
+	return `${n} ${noun}${n === 1 ? "" : "s"}`;
+}
+/** "3 questions may be answered · 1 issue may be resolved · 1 needs further investigation". */
+function headline(outcome) {
+	const count = (kind, to) => outcome.judgements.filter(({ judgement, status }) => judgement.kind === kind && status.kind === "proposed" && status.entry.to === to).length;
+	return [
+		[count("question", "answered"), (n) => `${plural(n, "question")} may be answered`],
+		[count("question", "partially-answered"), (n) => `${plural(n, "question")} may be partly answered`],
+		[count("issue", "resolved"), (n) => `${plural(n, "issue")} may be resolved`],
+		[count("issue", "needs-investigation"), (n) => `${n} ${n === 1 ? "needs" : "need"} further investigation`],
+		[outcome.judgements.filter(({ status }) => status.kind === "proposed" && (status.entry.to === "open" || status.entry.to === "unanswered")).length, (n) => `${n} earlier ${n === 1 ? "decision" : "decisions"} contradicted`],
+		[outcome.judgements.filter(({ grade }) => grade?.kind === "proposed").length, (n) => `${plural(n, "grade change")} suggested`]
+	].flatMap(([n, say]) => n > 0 ? [say(n)] : []).join(" · ");
+}
+/**
+* What the conversation shows for the turn: the suggestions, finding by finding, and nothing that
+* reads as a change made. Never the JSON. Findings the reply did not address are not mentioned,
+* because they were not judged.
+*/
+function reconcileTurnText(read, outcome, identity) {
+	if (!read.reading) return `${read.raw.trim()}\n\n*This answer was not in the form suggestions need, so nothing was suggested and no finding changed.*`;
+	const lines = outcome.judgements.flatMap(({ judgement, status, grade }) => {
+		const said = [];
+		const phrase = statusPhrase(judgement, status);
+		if (phrase) said.push(phrase);
+		if (grade?.kind === "proposed" || grade?.kind === "waiting") said.push(`its ${judgement.kind === "issue" ? "severity" : "importance"} may change to ${grade.entry.to}`);
+		return said.length ? [`- **${judgement.ref}** ${said.join("; ")}. ${judgement.reason}`] : [];
+	});
+	const unmatched = read.reading.unmatched.map((passage) => `- Could not tell which finding this answers${passage.candidates.length ? ` (${passage.candidates.join(" or ")})` : ""}, so none was changed: “${passage.text}”${passage.why ? ` ${passage.why}` : ""}`);
+	const dropped = read.reading.discarded.unquoted + read.reading.discarded.unknownRef;
+	const droppedLine = dropped ? [`*${dropped === 1 ? "One judgement was" : `${dropped} judgements were`} left out: ${dropped === 1 ? "it" : "each"} named no finding in this review, or quoted words that are not in the turns.*`] : [];
+	const top = headline(outcome);
+	const unnamedLine = identity?.kind === "unnamed" ? [`*This reply does not name review ${identity.tag}, so any I or Q reference in it was trusted only where what it says matches that finding.*`] : [];
+	if (!lines.length && !unmatched.length) return [
+		"**Reconciled with findings.** Nothing in these turns bears on the review’s issues or questions, so nothing is suggested.",
+		...unnamedLine,
+		...droppedLine
+	].join("\n\n");
+	return [
+		`**Reconciled with findings.**${top ? ` ${top}.` : ""}`,
+		"These are suggestions. Nothing changes until you accept one on its card.",
+		[...lines, ...unmatched].join("\n"),
+		...unnamedLine,
+		...droppedLine
+	].join("\n\n");
+}
+/** The turns as the prompt labels them. */
+function evidenceTurns(turns) {
+	return labelTurns(turns);
+}
 //#endregion
 //#region ../../packages/review-harness/src/workspace/diagram.ts
 /** The same budget a question gets. Drawing is reading, and reading is what takes the time. */
@@ -15081,6 +15979,7 @@ async function handle(req, res, options) {
 	if (url.pathname === "/runs/remove") return void handleRunRemoval(req, res, options.indexToken);
 	if (url.pathname === "/runs/sections") return void handleRunsSections(req, res, options.indexToken);
 	if (url.pathname === "/help") return void handleHelp(req, res, url.searchParams, options.indexToken);
+	if (url.pathname === "/tour") return void handleTour(req, res, url.searchParams, options.indexToken);
 	if (url.pathname === "/notifications/open") return handleNotificationOpen(req, res, url.searchParams, options.indexToken);
 	if (url.pathname === "/notifications/recent") return handleRecentNotifications(req, res, url.searchParams, options.indexToken);
 	if (url.pathname === "/notifications/live") return handleLiveNotifications(req, res, url.searchParams, options.indexToken);
@@ -15341,10 +16240,30 @@ function handleHelp(req, res, params, indexToken) {
 		unreadNotifications: unreadCount$1(),
 		driving: isDriving(),
 		theme: readPreferences().theme,
-		sidebar: readPreferences().sidebar
+		sidebar: readPreferences().sidebar,
+		tour: tourUnavailable(recentWorkspaces(Number.MAX_SAFE_INTEGER), busyReviewIds()) ?? "available",
+		tourFailed: params.get("tour") === "unavailable"
 	}), indexCookieHeader(indexToken));
 }
 /**
+* Reviews something is analysing or updating right now. The guided tour is not shown on these: what
+* it would point at is about to be replaced. An assistant answering, or a diagram being drawn, is
+* not one of these: the review under it stays as it is.
+*/
+function busyReviewIds() {
+	return new Set(runningJobs().map((running) => running.job).filter((job) => purposeOf(job) !== "ask").map((job) => job.workspaceId));
+}
+/**
+* Replay guided tour, from Help. Chosen when it is pressed rather than when Help was drawn, so a
+* review that started updating in between is not opened to a tour that cannot start. With nothing to
+* open, back to Help's Welcome, which says why.
+*/
+function handleTour(req, res, params, indexToken) {
+	if (!indexAuthorised(req, params, indexToken)) return refuseIndex(req, res);
+	const review = chooseTourReview(recentWorkspaces(Number.MAX_SAFE_INTEGER), busyReviewIds());
+	redirect(res, review ? `/r/${encodeURIComponent(review.id)}?t=${encodeURIComponent(review.token)}${TOUR_REPLAY_HASH}` : "/help?tour=unavailable#welcome");
+}
+/**
 * Whether the caller is a browser navigating, rather than something reading the API.
 *
 * `Accept` is the only signal available and browsers are consistent about it: a navigation asks
@@ -16314,6 +17233,8 @@ async function sendWorkspacePage(res, workspace) {
 		dismissedNotices: readPreferences().dismissedNotices,
 		promptsCollapsed: readPreferences().promptsCollapsed === true,
 		reviewLayout: readPreferences().reviewLayout ?? {},
+		guidedTour: readPreferences().guidedTour,
+		tourBusy: busyReviewIds().has(workspace.id),
 		changeMapRegister: readPreferences().changeMapRegister ?? "simple",
 		architecture: await architecturePane(workspace),
 		transcript: workspace.transcript,
@@ -16725,6 +17646,22 @@ async function handleAsk(req, res, workspace) {
 		...reassessed,
 		from: currentGradeIn(workspace.session, reassessed.kind, reassessed.id) ?? null
 	} : null;
+	let reconcileTurns = null;
+	let reconcileIdentity = null;
+	if (body?.reconciles !== void 0 && !explains && !reassessed) {
+		if (!workspace.session.result) return send(res, 409, { error: "This review has no findings to reconcile with yet." });
+		const chosen = reconcileTurnsOf(workspace.transcript, body.reconciles);
+		if (!chosen.ok) return send(res, 400, {
+			error: TURNS_REFUSED[chosen.refusal],
+			refusal: chosen.refusal
+		});
+		reconcileIdentity = reviewIdentityOf(chosen.turns, workspace.session.id);
+		if (reconcileIdentity.kind === "other") return send(res, 409, {
+			error: otherReviewRefusal(reconcileIdentity),
+			refusal: "other-review"
+		});
+		reconcileTurns = evidenceTurns(chosen.turns);
+	}
 	if (liveUpdateFor(workspace.id)) return send(res, 409, {
 		error: "This review is being updated. Ask again when the new review is ready.",
 		updating: true
@@ -16765,6 +17702,13 @@ async function handleAsk(req, res, workspace) {
 				...explains ? { explaining: explains } : {},
 				...continuing ? { continuing } : {},
 				...reassessed ? { reassessing: reassessed } : {},
+				...reconcileTurns && reconcileIdentity ? { reconciling: {
+					turns: reconcileTurns,
+					review: {
+						tag: reconcileIdentity.tag,
+						named: reconcileIdentity.kind === "named"
+					}
+				} } : {},
 				conversation: prepared
 			});
 		} catch (error) {
@@ -16787,21 +17731,39 @@ async function handleAsk(req, res, workspace) {
 			commitSha: workspace.session.metadata.commitSha
 		}) : null;
 		let reassessOutcome = null;
+		const reconcileRead = reconcileTurns && workspace.session.result ? await readReconcileTurn(answer, workspace.session.result, reconcileTurns, {
+			repoPath: workspace.repoPath,
+			commitSha: workspace.session.metadata.commitSha
+		}) : null;
+		let reconcileOutcome = null;
+		let keptAt = 0;
 		let explanation;
 		let shown = answer;
 		const saved = mutateWorkspace(workspace.id, (fresh) => {
 			const askedAt = Date.now();
 			const kept = explains && findingNamed(fresh.session, explains) && answer.trim() ? explains : null;
+			keptAt = askedAt;
 			if (turn && reassessing) {
 				reassessOutcome = keepReassessTurn(fresh.session, reassessing, turn, askedAt);
 				shown = reassessTurnText(reassessing, turn, reassessOutcome);
 			}
+			let reconciles;
+			if (reconcileRead && reconcileTurns) {
+				const exchanges = reconcileTurns.map((evidence) => evidence.askedAt);
+				reconcileOutcome = keepReconcileTurn(fresh.session, reconcileRead, exchanges, askedAt);
+				shown = reconcileTurnText(reconcileRead, reconcileOutcome, reconcileIdentity ?? void 0);
+				reconciles = {
+					exchanges,
+					proposals: proposedIds(reconcileOutcome)
+				};
+			}
 			fresh.transcript.push({
 				question,
 				answer: shown,
 				sectionId,
 				askedAt,
-				...kept ? { explains: kept } : {}
+				...kept ? { explains: kept } : {},
+				...reconciles ? { reconciles } : {}
 			});
 			if (kept) {
 				explanation = {
@@ -16817,13 +17779,23 @@ async function handleAsk(req, res, workspace) {
 			outcome: reassessOutcome,
 			...card ? { card } : {}
 		} } : {};
-		sendIfOpen(res, 200, explanation ? {
-			answer: shown,
-			explanation,
-			...reassessment
-		} : {
+		const reconciliation = reconcileOutcome && saved ? { reconciliation: {
+			proposals: proposedIds(reconcileOutcome),
+			cards: reconcileOutcome.judgements.flatMap(({ judgement }) => {
+				const parts = gradeFragments(saved, judgement.kind, judgement.findingId);
+				return parts ? [parts] : [];
+			})
+		} } : {};
+		const turnRef = saved ? {
+			askedAt: keptAt,
+			...reconcileOutcome ? { reconcileTurn: true } : {}
+		} : {};
+		sendIfOpen(res, 200, {
 			answer: shown,
-			...reassessment
+			...explanation ? { explanation } : {},
+			...reassessment,
+			...reconciliation,
+			...turnRef
 		});
 	} finally {
 		endRun(run);
@@ -17119,6 +18091,7 @@ async function handlePrefs(req, res) {
 	const layout = readReviewLayoutPatch(body?.reviewLayout);
 	if (layout) writeReviewLayout(layout);
 	if (body?.changeMapRegister === "simple" || body?.changeMapRegister === "technical") writeChangeMapRegister(body.changeMapRegister);
+	if (isGuidedTourState(body?.guidedTour)) writeGuidedTour(body.guidedTour);
 	if (typeof body?.dismissNotice === "string" && !dismissNotice(body.dismissNotice)) return send(res, 400, { error: "Not a notice this page can dismiss." });
 	send(res, 200, { ok: true });
 }
@@ -17233,7 +18206,8 @@ var ASK_SOURCES = [
 	"free_text",
 	"explain_simply",
 	"selection",
-	"finding"
+	"finding",
+	"reconcile"
 ];
 function askSource(value) {
 	return ASK_SOURCES.includes(value) ? value : "free_text";