prreviewbuddy 0.82.4 → 0.85.0

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 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, _ as runningJobs, _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 { 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";
@@ -803,7 +803,10 @@ var PATHS = {
 	closed: "<circle cx=\"12\" cy=\"12\" r=\"9\"/><path d=\"m5.6 5.6 12.8 12.8\"/>",
 	reopened: "<circle cx=\"12\" cy=\"12\" r=\"9\"/><circle cx=\"12\" cy=\"12\" r=\"2\"/>",
 	warning: "<path d=\"M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0z\"/><path d=\"M12 9v4M12 17h.01\"/>",
-	forward: "<path d=\"M5 12h14\"/><path d=\"m12 5 7 7-7 7\"/>"
+	forward: "<path d=\"M5 12h14\"/><path d=\"m12 5 7 7-7 7\"/>",
+	plus: "<path d=\"M12 5v14M5 12h14\"/>",
+	"sidebar-collapse": "<rect x=\"3\" y=\"4\" width=\"18\" height=\"16\" rx=\"2\"/><path d=\"M9 4v16\"/><path d=\"m16 9-3 3 3 3\"/>",
+	"sidebar-expand": "<rect x=\"3\" y=\"4\" width=\"18\" height=\"16\" rx=\"2\"/><path d=\"M9 4v16\"/><path d=\"m13 9 3 3-3 3\"/>"
 };
 /** The icon slot for one rail row. Hidden from assistive technology: the label beside it says it. */
 function railIcon(icon) {
@@ -863,6 +866,18 @@ function serverStatusLabel(status) {
 	return "Workspace server running";
 }
 //#endregion
+//#region ../../packages/review-harness/src/workspace/sidebar_state.ts
+/**
+* What the sidebar's own toggle, at its foot, will do when pressed, which is what it is called.
+* Only Expanded and Compact: while the sidebar is hidden that toggle is not drawn, and the strip's
+* restore control, which only ever says Show sidebar, stands in for it.
+*/
+function sidebarToggleLabel(sidebar) {
+	return sidebar?.compact ? "Expand sidebar" : "Collapse sidebar";
+}
+/** The strip's restore control, drawn only while the sidebar is hidden. */
+var SHOW_SIDEBAR = "Show sidebar";
+//#endregion
 //#region ../../packages/review-harness/src/workspace/workspace_nav.ts
 /**
 * The workspace's own places, and the one model every page draws them from.
@@ -905,6 +920,13 @@ var WORKSPACE_PLACES = [
 	}
 ];
 /**
+* The sidebar's state, on `<html>` beside the theme, so the page is drawn that way from its first
+* paint. The stylesheet reads it; `client/sidebar.ts` changes it.
+*/
+function sidebarAttributes(sidebar) {
+	return `${sidebar?.compact ? " data-sidebar-compact" : ""}${sidebar?.hidden ? " data-sidebar-hidden" : ""}`;
+}
+/**
 * The count beside Notifications. Always rendered, hidden at zero, so the page can reveal it when
 * `/revision` or Mark all read reports a new number. See `client/unread_counts.ts`.
 */
@@ -934,7 +956,8 @@ function renderGlobalBar(options) {
 	const live = options.live ?? true;
 	return `<header class="prb-strip">
   <span class="prb-wordmark"><b>pr</b>review<b>buddy</b></span>
-  ${live ? renderHeaderNav(options) : ""}
+  ${live ? renderSidebarRestore() : ""}
+  ${live ? renderNewReview() : ""}
   ${live ? renderHistoryControls() : ""}
   ${live ? renderStripReviews(options) : ""}
   ${live ? renderStripRuns(options) : ""}
@@ -980,6 +1003,37 @@ function renderNotificationsBell(options) {
   </a>`;
 }
 /**
+* Show sidebar: the way back from Hidden, and drawn only then (see `shell.css`). Among the strip's
+* controls rather than beside the wordmark, so it reads as a control and not as part of the brand.
+* Named in words and in the strip's own tooltip, never a `title`.
+*/
+function renderSidebarRestore() {
+	return `<button type="button" class="prb-strip-action prb-sidebar-restore" data-sidebar-toggle="strip" aria-label="${SHOW_SIDEBAR}" data-tip="${SHOW_SIDEBAR}">${iconSvg("sidebar-expand")}</button>`;
+}
+/**
+* The sidebar's own toggle, the last row of its foot: Expanded and Compact, back and forth.
+*
+* In the same place in both, so it never moves under the pointer that pressed it. Hidden is not a
+* third press: it is its own act (⌘K H), and the strip's Show sidebar brings it back at the width it
+* had. The row's words say what pressing it will do, and in Compact they are its tooltip, as every
+* row's are. Both drawings are rendered and the stylesheet shows the one for the state, so nothing
+* needs repainting but the words. `client/sidebar.ts` keeps those true.
+*/
+function renderSidebarToggle(sidebar) {
+	return `<button type="button" class="prb-rail-item prb-rail-link prb-sidebar-toggle" data-sidebar-toggle="rail" aria-expanded="${!sidebar?.compact}">
+      <span class="prb-rail-icon" aria-hidden="true"><span class="prb-sidebar-collapse-icon">${iconSvg("sidebar-collapse")}</span><span class="prb-sidebar-expand-icon">${iconSvg("sidebar-expand")}</span></span>
+      <span class="prb-rail-label"><span class="prb-rail-title">${sidebarToggleLabel(sidebar)}</span></span>
+    </button>`;
+}
+/**
+* New review, in the strip: the square stand-in for the rail's labelled button, shown only while
+* the rail is hidden (a narrow window, a review's focus mode). See `renderNewReviewButton`, and
+* `shell.css` for the one rule that decides which of the two is showing.
+*/
+function renderNewReview() {
+	return `<button type="button" class="prb-strip-action prb-strip-new-review" aria-label="New review" data-new-review="strip">${iconSvg("plus")}</button>`;
+}
+/**
 * Back and Forward through this tab's workspace history, ahead of the places.
 *
 * Workspace-wide, so here in the strip rather than in a review's own bar: they move between views,
@@ -1058,9 +1112,20 @@ function renderServerStatus() {
     <span class="prb-visually-hidden" data-server-status-label>${escapeHtml$1(serverStatusLabel("running"))}</span>
   </span>`;
 }
-/** The workspace rows, for a rail group. */
+/**
+* New review, at the head of the workspace rows: starting a review is the product's primary action,
+* so it is a labelled button rather than an icon to interpret, set apart from the places below it.
+*
+* What it does is wired by the command layer (`client/command_layer.ts`), which runs the very
+* command ⌘P runs, so the two cannot open different things. The shortcut beside the label is
+* painted there too, because only the browser knows the platform.
+*/
+function renderNewReviewButton() {
+	return `<div class="prb-rail-new"><button type="button" class="prb-new-review" data-new-review="rail">${iconSvg("plus")}<span class="prb-new-review-label">New review</span><kbd class="prb-new-review-key" data-new-review-key aria-hidden="true"></kbd></button></div>`;
+}
+/** New review, then the workspace rows, for a rail group. */
 function renderWorkspaceNav(options) {
-	return WORKSPACE_PLACES.map((item) => `<a class="prb-rail-item prb-rail-link" href="${item.href}"${item.place === options.current ? " aria-current=\"true\"" : ""}>
+	return renderNewReviewButton() + WORKSPACE_PLACES.map((item) => `<a class="prb-rail-item prb-rail-link" href="${item.href}"${item.place === options.current ? " aria-current=\"true\"" : ""}>
       ${railIcon(item.icon)}
       <span class="prb-rail-label"><span class="prb-rail-title">${escapeHtml$1(item.label)}</span></span>
       ${item.place === "notifications" ? unreadCount(options.unread, "rail") : ""}
@@ -1097,20 +1162,9 @@ function renderSendFeedback() {
 function renderWorkspaceRail(options) {
 	return `<nav class="prb-rail" aria-label="Workspace">
   <div class="prb-rail-group">${renderWorkspaceNav(options)}</div>
-  <div class="prb-rail-group prb-rail-foot">${renderSendFeedback()}</div>
+  <div class="prb-rail-group prb-rail-foot">${renderSendFeedback()}${renderSidebarToggle(options.sidebar)}</div>
 </nav>`;
 }
-/**
-* What the rail carries that the strip does not, shown only while a narrow window hides the rail.
-*
-* Which is now the feedback form alone. Every workspace place is an icon in this same strip at
-* every width, so a text link beside one of them would be the same destination twice; before the
-* Reviews icon existed this is where Reviews had to go, and the filter that put it here is gone
-* with the reason for it.
-*/
-function renderHeaderNav(_options) {
-	return `<nav class="prb-header-nav" aria-label="Workspace"><a class="prb-feedback" href="${escapeHtml$1(feedbackUrl())}" target="_blank" rel="noopener noreferrer"><span class="prb-feedback-icon" aria-hidden="true">${iconSvg("feedback")}</span><span class="prb-feedback-label">Send feedback</span></a></nav>`;
-}
 //#endregion
 //#region ../../packages/review-harness/src/domain/utils/file_path.ts
 /**
@@ -2508,11 +2562,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>
@@ -2521,7 +2575,7 @@ 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")}
@@ -2644,7 +2698,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>
@@ -3501,6 +3555,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",
@@ -6088,7 +6178,7 @@ function renderWorkspace(view) {
 	*/
 	const freshness = result ? view.freshness : void 0;
 	return `<!doctype html>
-<html lang="en"${themeAttribute(view.theme)}>
+<html lang="en"${themeAttribute(view.theme)}${sidebarAttributes(view.sidebar)}>
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -6097,7 +6187,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),
@@ -6635,6 +6730,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${[
@@ -6681,6 +6777,7 @@ function renderRailFoot(view) {
 	return `<div class="prb-rail-group prb-rail-foot">
     ${view.token ? renderWorkspaceNav({ unread: view.unreadNotifications ?? 0 }) : ""}
     ${renderSendFeedback()}
+    ${view.token ? renderSidebarToggle(view.sidebar) : ""}
   </div>`;
 }
 /**
@@ -9676,7 +9773,7 @@ function renderReviewsPage(view) {
 	const storedReviews = view.groups.reduce((total, group) => total + group.history.length, 0);
 	const renderSectionAt = (section) => renderSection(section, sections[section], (groups) => renderCards(groups, "home", (group) => collectedHome.has(group)), sectionOpen(section, view.sectionsCollapsed), sections[section].filter((group) => !inProgressOnly.has(group.latest.id) && !collectedHome.has(group)).length);
 	return `<!doctype html>
-<html lang="en"${themeAttribute(view.theme)}>
+<html lang="en"${themeAttribute(view.theme)}${sidebarAttributes(view.sidebar)}>
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -9699,7 +9796,8 @@ ${renderContextBar("Reviews", ordered.length === 0 ? "" : renderControls$1(queue
 <div class="prb-shell">
 ${renderWorkspaceRail({
 		current: "reviews",
-		unread: view.unreadNotifications ?? 0
+		unread: view.unreadNotifications ?? 0,
+		sidebar: view.sidebar
 	})}
 <main class="prb-index">
   ${ordered.length === 0 ? "" : `<div class="prb-index-summary">
@@ -10617,7 +10715,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 } = 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)) } : {},
@@ -10626,7 +10724,9 @@ function readPreferences() {
 			...isTheme(theme) ? { theme } : {},
 			...readReviewSections(reviewSections),
 			...readRunsSections(runsSections),
-			...readLayout(reviewLayout)
+			...readLayout(reviewLayout),
+			...readSidebar(sidebar),
+			...isGuidedTourState(guidedTour) ? { guidedTour } : {}
 		};
 	} catch {
 		return {};
@@ -10659,6 +10759,50 @@ function writeReviewLayout(patch) {
 		writeFileSync(PREFERENCES_PATH, `${JSON.stringify(next, null, 2)}\n`);
 	} catch {}
 }
+/** Only the two booleans, and only when one is set; an empty object is no preference. */
+function readSidebar(value) {
+	if (!value || typeof value !== "object") return {};
+	const { compact, hidden } = value;
+	const sidebar = {
+		...typeof compact === "boolean" ? { compact } : {},
+		...typeof hidden === "boolean" ? { hidden } : {}
+	};
+	return Object.keys(sidebar).length === 0 ? {} : { sidebar };
+}
+/** The sidebar fields a request may set: a boolean or nothing, each. */
+function readSidebarPatch(value) {
+	const { sidebar } = readSidebar(value);
+	return sidebar ?? null;
+}
+/** Remember a change to the sidebar, merged into what is stored. Read-modify-write, like every other field here. */
+function writeSidebar(patch) {
+	try {
+		mkdirSync(STORE_ROOT, { recursive: true });
+		const current = readPreferences();
+		writeFileSync(PREFERENCES_PATH, `${JSON.stringify({
+			...current,
+			sidebar: {
+				...current.sidebar,
+				...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 {
@@ -10879,7 +11023,7 @@ function renderSettingsPage(view) {
 	const { settings } = view;
 	const address = `http://localhost:${settings.port.configured}`;
 	return `<!doctype html>
-<html lang="en"${themeAttribute(settings.theme)}>
+<html lang="en"${themeAttribute(settings.theme)}${sidebarAttributes(view.sidebar)}>
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -10898,7 +11042,8 @@ ${renderContextBar("Settings", renderBack())}
 <div class="prb-shell">
 ${renderWorkspaceRail({
 		current: "settings",
-		unread: view.unreadNotifications ?? 0
+		unread: view.unreadNotifications ?? 0,
+		sidebar: view.sidebar
 	})}
 <main class="prb-index prb-settings">
   <div class="prb-page-panel">
@@ -11387,6 +11532,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",
@@ -11399,8 +11568,10 @@ var TOPICS = [
       <li><code>prreviewbuddy review --pr &lt;url&gt;</code> for a pull request</li>
       <li><code>prreviewbuddy open</code> to list the reviews you have and open this workspace</li>
     </ul>
-    <p>Or press <kbd class="prb-kbd">⌘P</kbd> (<kbd class="prb-kbd">Ctrl+P</kbd> elsewhere) to add a
-    review from here. The panel follows the reviews it started while it stays open, and closing it
+    <p>Or click <b>New review</b> at the top of the sidebar, or press <kbd class="prb-kbd">⌘P</kbd>
+    (<kbd class="prb-kbd">Ctrl+P</kbd> on other platforms), to start a review from anywhere in the
+    workspace. With the sidebar collapsed, New review is the <b>+</b> at its top, and with the
+    sidebar hidden, the <b>+</b> in the top toolbar. The panel follows the reviews it started while it stays open, and closing it
     stops nothing. <code>prreviewbuddy help</code> lists every command, and
     <code>prreviewbuddy review --help</code> every option a review takes.</p>
     <p>There is no account and no API key. PR Review Buddy uses the coding agent installed on your
@@ -11498,18 +11669,13 @@ feature:                   E</pre>
 	{
 		id: "collections",
 		title: "Collections",
-		body: `<p>A collection groups reviews that belong together, such as the pull requests of one
-    refactor or one release. It says what belongs together; whether each review still needs your
-    attention is still Active, Waiting or Done, so adding or removing a review never changes its
-    state.</p>
-    <p>Make one with New collection on the Reviews page, or from Manage collections in a card's menu.
-    To add several reviews at once, choose Select, tick them, and choose Manage collections. A review
-    can be in more than one collection. Ticking a collection adds every selected review to it and
-    leaves their other collections alone.</p>
-    <p>Each collection lists its reviews that are not Done. Marking one Done moves it under Show
-    completed, in every collection it is in, and Move to active brings it back. A review in a
-    collection is listed there rather than under Active, Waiting or Done. A pinned review stays under
-    Pinned. The Collections filter shows chosen collections, or Uncollected for reviews in none.</p>
+		body: `<p>Collections help you organise related reviews, such as a refactor, release or feature.</p>
+    <p>Create a collection from the Reviews page, then add reviews individually or select several and
+    use <b>Manage collections</b>. A review can belong to multiple collections.</p>
+    <p>Collections show reviews that still need attention. When you mark a review <b>Done</b>, it moves
+    under <b>Show completed</b> within its collection, without losing its membership.</p>
+    <p>You can collapse collections to stay focused, and expand them when you're ready to continue.
+    Removing a review from all collections returns it to the normal review sections.</p>
     <p>Reviews in a collection are kept for ninety days, like pinned and Done reviews, counted from
     when you last opened or marked them. Adding one to a collection doesn't restart that count.
     Deleting a collection keeps its reviews.</p>`
@@ -11591,7 +11757,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>
@@ -11599,7 +11785,7 @@ function renderContents() {
 }
 function renderHelpPage(view) {
 	return `<!doctype html>
-<html lang="en"${themeAttribute(view.theme)}>
+<html lang="en"${themeAttribute(view.theme)}${sidebarAttributes(view.sidebar)}>
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -11618,16 +11804,20 @@ ${renderContextBar("Help", "")}
 <div class="prb-shell">
 ${renderWorkspaceRail({
 		current: "help",
-		unread: view.unreadNotifications ?? 0
+		unread: view.unreadNotifications ?? 0,
+		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>
@@ -11640,7 +11830,7 @@ ${renderWorkspaceRail({
 function renderNotificationsPage(view) {
 	const unread = view.notifications.filter((notification) => notification.readAt === void 0).length;
 	return `<!doctype html>
-<html lang="en"${themeAttribute(view.theme)}>
+<html lang="en"${themeAttribute(view.theme)}${sidebarAttributes(view.sidebar)}>
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -11659,7 +11849,8 @@ ${renderContextBar("Activity", view.notifications.length === 0 ? "" : renderRead
 <div class="prb-shell">
 ${renderWorkspaceRail({
 		current: "notifications",
-		unread: view.unreadNotifications ?? 0
+		unread: view.unreadNotifications ?? 0,
+		sidebar: view.sidebar
 	})}
 <main class="prb-index prb-notifications-page">
   ${view.notifications.length === 0 ? `<p class="prb-index-empty" data-notifications-empty>Nothing yet. When a review finishes or fails, or a branch or pull request moves, it appears here.</p>` : `<ol class="prb-notifications" data-notifications>
@@ -13044,7 +13235,7 @@ function renderRunsPage(view) {
 	const nothing = inProgress.length === 0 && recent.length === 0;
 	const notResponding = recent.some((entry) => entry.status === "not-responding");
 	return `<!doctype html>
-<html lang="en"${themeAttribute(view.theme)}>
+<html lang="en"${themeAttribute(view.theme)}${sidebarAttributes(view.sidebar)}>
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -13063,7 +13254,8 @@ ${renderContextBar("Runs", nothing ? "" : renderControls(notResponding))}
 <div class="prb-shell">
 ${renderWorkspaceRail({
 		current: "runs",
-		unread: view.unreadNotifications ?? 0
+		unread: view.unreadNotifications ?? 0,
+		sidebar: view.sidebar
 	})}
 <main class="prb-index prb-runs">
   <p class="prb-runs-lede">Monitor review executions and recent activity.</p>
@@ -14994,11 +15186,13 @@ 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);
 	if (url.pathname === "/pin") return handlePin(req, res, options.indexToken);
 	if (url.pathname === "/sections") return handleSections(req, res, options.indexToken);
+	if (url.pathname === "/sidebar") return handleSidebar(req, res, options.indexToken);
 	if (url.pathname === "/queue") return handleQueue(req, res, options.indexToken);
 	if (url.pathname === "/collections") return handleCollections(req, res, options.indexToken);
 	if (url.pathname === "/collections/members") return handleCollectionMembers(req, res, options.indexToken);
@@ -15148,6 +15342,7 @@ function indexView() {
 		unreadNotifications: unreadCount$1(),
 		driving: isDriving(),
 		theme: readPreferences().theme,
+		sidebar: readPreferences().sidebar,
 		sectionsCollapsed: readPreferences().reviewSections
 	};
 }
@@ -15238,7 +15433,8 @@ async function handleSettings(req, res, params, indexToken) {
 	sendHtml(res, 200, renderSettingsPage({
 		settings: readSettings(),
 		unreadNotifications: unreadCount$1(),
-		driving: isDriving()
+		driving: isDriving(),
+		sidebar: readPreferences().sidebar
 	}), indexCookieHeader(indexToken));
 }
 /**
@@ -15250,10 +15446,31 @@ function handleHelp(req, res, params, indexToken) {
 	sendHtml(res, 200, renderHelpPage({
 		unreadNotifications: unreadCount$1(),
 		driving: isDriving(),
-		theme: readPreferences().theme
+		theme: readPreferences().theme,
+		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
@@ -15365,7 +15582,8 @@ async function handleNotifications(req, res, params, indexToken) {
 		gone: new Set(notifications.filter((entry) => !loadWorkspace(entry.reviewId)).map((entry) => entry.id)),
 		unreadNotifications: unreadCount$1(),
 		driving: isDriving(),
-		theme: readPreferences().theme
+		theme: readPreferences().theme,
+		sidebar: readPreferences().sidebar
 	}), indexCookieHeader(indexToken));
 }
 /**
@@ -15386,6 +15604,7 @@ function handleRuns(req, res, params, indexToken) {
 		unreadNotifications: unreadCount$1(),
 		driving: isDriving(),
 		theme: preferences.theme,
+		sidebar: preferences.sidebar,
 		sectionsCollapsed: preferences.runsSections
 	}), indexCookieHeader(indexToken));
 }
@@ -15799,6 +16018,18 @@ async function handleRunsSections(req, res, indexToken) {
 	writeRunsSectionCollapsed(body.section, body.collapsed);
 	send(res, 200, { ok: true });
 }
+/**
+* The sidebar, from a workspace page that is not a review, with the same credential as `/sections`.
+* A review page sends the same field to its own `/prefs`, since it may hold no index cookie.
+*/
+async function handleSidebar(req, res, indexToken) {
+	if (req.method !== "POST") return send(res, 405, { error: "Use POST." });
+	if (!indexToken || !secretMatches(indexToken, indexCookie(req))) return send(res, 403, { error: "Not authorised." });
+	const sidebar = readSidebarPatch((await readJson(req))?.sidebar);
+	if (!sidebar) return send(res, 400, { error: "Not a sidebar setting." });
+	writeSidebar(sidebar);
+	send(res, 200, { ok: true });
+}
 async function handleSections(req, res, indexToken) {
 	if (req.method !== "POST") return send(res, 405, { error: "Use POST." });
 	if (!indexToken || !secretMatches(indexToken, indexCookie(req))) return send(res, 403, { error: "Not authorised." });
@@ -16205,9 +16436,12 @@ async function sendWorkspacePage(res, workspace) {
 		repoPath: workspace.repoPath,
 		askWidth: readPreferences().askWidth,
 		theme: readPreferences().theme,
+		sidebar: readPreferences().sidebar,
 		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,
@@ -17008,9 +17242,12 @@ async function handlePrefs(req, res) {
 	if (typeof askWidth === "number") writeAskWidth(askWidth);
 	else if (askWidth === null) clearAskWidth();
 	if (typeof body?.promptsCollapsed === "boolean") writePromptsCollapsed(body.promptsCollapsed);
+	const sidebar = readSidebarPatch(body?.sidebar);
+	if (sidebar) writeSidebar(sidebar);
 	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 });
 }