@dev.fast/whiteboard 0.4.0 → 0.4.1-preview.20261026.138

package/dist/{headless-host-DJhcab6r.js → headless-host-BkJ9OUQY.js}

@@ -1,28 +1,28 @@
-import { b as resolveRepoContext, d as git, r as defaultBranch, w as runVcs } from "./src-X9ZebeOD.js";
+import { b as resolveRepoContext, d as git, r as defaultBranch, w as runVcs } from "./src-DXnn7RrI.js";
 import { c as jsonString, m as isStringValue, n as isJsonObject, p as isObjectValue, u as parseJsonText } from "./src-X9phtB2j.js";
-import { a as sharedReviewId, c as verifyShareRepository, d as validateShareSources, f as StreamLimitError, h as shareIdSchema, l as exportShare, m as parseShareLink, n as ShareClient, p as readBoundedStream, r as SharePreflightError, s as readShareRepository, t as ShareAuthError, u as referenceCommits } from "./client-p9WB8Sj0.js";
-import { d as textualRows, f as invalidateStructuralComparisons, h as readGitHubPullRequests, i as inspectSnapshot, m as diffrMissingError, p as diffrExecutable, r as commandSchema } from "./local-data-DHedfhxw.js";
-import { N as reviewDiffrSummarizerInputSchema, O as ReviewFeedbackContactSchema, P as decodeStructuralDiffEvent, a as parseReviewVerbRequest, c as boardIconKind, i as parseReviewDesktopVerbResult, j as ReviewOnboardingRunRequestSchema, k as ReviewFeedbackSchema, l as boardTitle, m as REVIEW_CLIENT_REMOTE, p as REVIEW_CLIENT_HEADER, y as REVIEW_HOST_HEADER } from "./src-DYHVzX3b.js";
-import { $ as runStoreLogin, M as selectTraceStorage, N as TraceStorageDeniedError, Q as readStoreAuth, X as DEFAULT_STORE_ORIGIN, Z as clearStoreAuth, b as listReviewTraceSessions, j as resolveTraceStorage, k as isTraceStorageConfigured, q as shellQuote, v as traceMachineEnabled, x as loadReviewAgentTrace } from "./src-Z1x4-Qmb.js";
-import { _ as scopedCoverage, h as emptyCoverage, i as anchorSelection, l as resolveDiffSelection, m as coverageSources, n as SelectionUnavailableError, o as comparisonKey, s as formatAnchor, u as selectionKey, v as subtractIntervals, y as unionIntervals } from "./lens-selection-9byzEgvU.js";
-import { D as boardRepositoryId, E as boardLinks, G as selectionReferences, S as anchorPins, X as stepSources, Z as UNCATEGORIZED_LENS_ID, f as sourceBranchName, it as fileLineRangeSchema, j as elements, l as pullRequestKey, p as pullRequestProvider, tt as lensSelections } from "./stored-document-migration-DEt8iwem.js";
+import { _ as readBoundedStream, a as verifyShareRepository, c as exportShare, d as legacyModeSchema, f as lensReport, g as StreamLimitError, h as uncategorizedReport, i as readShareRepository, l as referenceCommits, m as reviewProgress, n as sharedReviewId, o as ShareAuthError, p as progressUpdateSchema, s as ShareClient, u as validateShareSources, v as parseShareLink, y as shareIdSchema } from "./import-Bwvf9Wos.js";
+import { d as invalidateStructuralComparisons, f as diffrExecutable, i as inspectSnapshot, m as readGitHubPullRequests, p as diffrMissingError, r as commandSchema } from "./local-data-BCSeTyic.js";
+import { F as decodeStructuralDiffEvent, N as reviewDiffrSummarizerInputSchema, O as ReviewFeedbackContactSchema, a as parseReviewVerbRequest, c as boardIconKind, i as parseReviewDesktopVerbResult, j as ReviewOnboardingRunRequestSchema, k as ReviewFeedbackSchema, l as boardTitle, m as REVIEW_CLIENT_REMOTE, p as REVIEW_CLIENT_HEADER, y as REVIEW_HOST_HEADER } from "./src-DEOc8bvC.js";
+import { $ as runStoreLogin, M as selectTraceStorage, N as TraceStorageDeniedError, Q as readStoreAuth, X as DEFAULT_STORE_ORIGIN, Z as clearStoreAuth, b as listReviewTraceSessions, j as resolveTraceStorage, k as isTraceStorageConfigured, q as shellQuote, v as traceMachineEnabled, x as loadReviewAgentTrace } from "./src-DjRaCctk.js";
+import { _ as scopedCoverage, s as formatAnchor, u as selectionKey } from "./lens-selection-EuZdag4Q.js";
+import { N as elements, O as boardLinks, Q as stepSources, f as sourceBranchName, k as boardRepositoryId, l as pullRequestKey, p as pullRequestProvider, q as selectionReferences, w as anchorPins } from "./stored-document-migration-CwmTwTb8.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
-import { A as processStartIdentity, L as writePrivateJsonAtomic, N as devReviewHome, h as TraceConfigurationError, i as isS3MockMode, j as withFileLock } from "./s3-config-CjcLyFV5.js";
+import { A as processStartIdentity, L as writePrivateJsonAtomic, N as devReviewHome, h as TraceConfigurationError, i as isS3MockMode, j as withFileLock } from "./s3-config-D7Yt0VhS.js";
 import { t as errorMessage } from "./error-message-OtiDonty.js";
-import { i as readReviewPackageVersion, n as readBuildCommit, t as findReviewPackageRoot } from "./package-paths-BeYHYjeR.js";
-import "./review-home-paths-CG-sb9Cw.js";
-import { _ as reviewInstanceIdentity, n as desktopOwnsHome, o as reviewServerDiscoveryPath, p as desktopUsesHome, r as headlessServerLockPath, t as DESKTOP_TAKEOVER_SIGNAL } from "./server-discovery-DKLIOgg3.js";
-import { c as askPicksSchema, d as selectionMarkdown, l as askQuestionSchema, n as askAgentIds, r as askChoiceKinds, s as askPermissionsSchema, t as applyAskChange, u as AgentSelectionSchema } from "./thread-state-CO97FUqK.js";
-import { t as openReviewProfile } from "./profile-D9wdlPgw.js";
-import { c as REVIEW_APP_SESSION_ID_HEADER, d as sanitizeUiTelemetryEvent, f as cleanTelemetryText, o as reviewRequestOrigin, r as REVIEW_PERSON_HEADER, s as BUNDLE_FRAME_PATTERN, t as ASK_THREAD_ENV, u as isReportableCleanedMessage } from "./request-origin-CNSLVn7x.js";
-import { a as defaultAskPermissions, i as askAgents, l as launchAskAgent, n as askAgentSettings, o as detectAskAgents, r as askAgentTakesMcp, t as fuzzyRank } from "./fuzzy-match-CfSxqzBF.js";
-import { a as inspectQuerySchema, i as renderInstructions, o as queryAnchor, r as instructionsQuerySchema, s as readQuerySchemas, t as authoringTools } from "./authoring-tools-D8EkIDjm.js";
-import { a as headlessServerOwner, c as stopBackgroundServer, o as recordedBackgroundServer } from "./background-server-DHWHzpo5.js";
+import { i as readReviewPackageVersion, n as readBuildCommit, t as findReviewPackageRoot } from "./package-paths-Bg731FHS.js";
+import "./review-home-paths-DcB4xLD-.js";
+import { _ as reviewInstanceIdentity, n as desktopOwnsHome, o as reviewServerDiscoveryPath, p as desktopUsesHome, r as headlessServerLockPath, t as DESKTOP_TAKEOVER_SIGNAL } from "./server-discovery-aHK_1r3U.js";
+import { c as askPicksSchema, d as selectionMarkdown, l as askQuestionSchema, n as askAgentIds, r as askChoiceKinds, s as askPermissionsSchema, t as applyAskChange, u as AgentSelectionSchema } from "./thread-state-CbLB0jUA.js";
+import { t as openReviewProfile } from "./profile-xzrUFgbT.js";
+import { c as REVIEW_APP_SESSION_ID_HEADER, d as sanitizeUiTelemetryEvent, f as cleanTelemetryText, o as reviewRequestOrigin, r as REVIEW_PERSON_HEADER, s as BUNDLE_FRAME_PATTERN, t as ASK_THREAD_ENV, u as isReportableCleanedMessage } from "./request-origin-CargJFvH.js";
+import { a as defaultAskPermissions, i as askAgents, l as launchAskAgent, n as askAgentSettings, o as detectAskAgents, r as askAgentTakesMcp, t as fuzzyRank } from "./fuzzy-match-l3mJZ1Ge.js";
+import { a as inspectQuerySchema, i as renderInstructions, o as queryAnchor, r as instructionsQuerySchema, s as readQuerySchemas, t as authoringTools } from "./authoring-tools-bm39DRoV.js";
+import { a as headlessServerOwner, c as stopBackgroundServer, o as recordedBackgroundServer } from "./background-server-B--5p72o.js";
 import crypto$1, { createHash, randomBytes, randomUUID } from "node:crypto";
 import { z } from "zod";
+import path, { join } from "node:path";
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { mkdir, mkdtemp, readFile, realpath, rm, stat, writeFile } from "node:fs/promises";
-import path, { join, posix } from "node:path";
 import { Writable } from "node:stream";
 import os, { tmpdir } from "node:os";
 import { execFile, spawn } from "node:child_process";
@@ -2200,244 +2200,6 @@ async function captureSanitizedUiTelemetry(telemetry, request, name, properties,
 	}
 }
 //#endregion
-//#region src/review-api/file-lenses.ts
-/** Subtract authored coverage, independently of viewed state. */
-function uncategorizedSources(files, sources) {
-	return files.flatMap((file) => {
-		const covered = scopedCoverage(file, sources);
-		return coverageSources(file, {
-			base: subtractIntervals(file.changed.base, covered.base),
-			head: subtractIntervals(file.changed.head, covered.head)
-		});
-	});
-}
-/** Resolve all targets into one union; a whole-file range subsumes narrower ranges. */
-function resolveFileLens(lens, files, fileSources, resolve) {
-	const targets = lens.targets;
-	const selected = targets.flatMap((target) => target.kind === "ranges" ? target.sources.flatMap((source) => resolve(anchorSelection(source))) : files.filter((file) => matchesFileLens(target.patterns, file)).flatMap((file) => fileSources.get(file.path) ?? []));
-	const groups = /* @__PURE__ */ new Map();
-	for (const source of selected) {
-		const key = JSON.stringify([source.side, source.file]);
-		const group = groups.get(key) ?? [];
-		group.push(source);
-		groups.set(key, group);
-	}
-	const sources = [...groups.values()].flatMap((group) => unionIntervals(group.map((source) => [source.fromLine - 1, source.toLine])).map(([start, end]) => ({
-		...group[0],
-		fromLine: start + 1,
-		toLine: end
-	})));
-	return {
-		sources,
-		fileCount: new Set(sources.map((source) => files.find((file) => source.file === (source.side === "base" ? file.previousPath ?? file.path : file.path))?.path ?? source.file)).size,
-		wholeFiles: targets.every((target) => target.kind === "files")
-	};
-}
-/** Evaluate authored patterns against the changed-file list, never the filesystem. */
-function matchesFileLens(patterns, file) {
-	return patterns.some((pattern) => {
-		const normalized = pattern.startsWith("./") ? pattern.slice(2) : pattern;
-		return [file.path, file.previousPath].some((path) => path !== void 0 && (path === normalized || posix.matchesGlob(path, normalized)));
-	});
-}
-//#endregion
-//#region src/review-api/review-progress.ts
-/** Older clients still send `mode`. */
-const legacyModeSchema = z.unknown().optional();
-const progressUpdateSchema = z.strictObject({
-	mode: legacyModeSchema,
-	version: z.number().int().nonnegative(),
-	files: z.array(z.strictObject({
-		path: z.string(),
-		fingerprint: z.string().min(1),
-		sources: z.array(fileLineRangeSchema)
-	})).max(1e4),
-	viewed: z.boolean()
-});
-/** Coverage survives new pins only when both complete file contents are unchanged. */
-async function reviewProgress(store, data, snapshot, signal = new AbortController().signal, partial) {
-	const marks = snapshot.shared ? /* @__PURE__ */ new Map() : store.viewedCoverage(snapshot.reviewId);
-	const pins = snapshot.pins ? (await data.resolveSource(snapshot)).pins : void 0;
-	const comparison = pins ? partial ?? await data.coverage(snapshot.reviewId, pins) : {
-		counted: true,
-		files: [],
-		fileSources: /* @__PURE__ */ new Map(),
-		alignments: /* @__PURE__ */ new Map()
-	};
-	const counting = !comparison.counted;
-	signal.throwIfAborted();
-	const documentKey = JSON.stringify(pins);
-	const comparisons = /* @__PURE__ */ new Map();
-	/** The comparison a reference's own pins name, shared across references. */
-	const ownComparison = (own) => {
-		const key = JSON.stringify(own);
-		let loading = comparisons.get(key);
-		if (loading) return loading;
-		if (partial) {
-			const state = data.coverageSnapshot(snapshot.reviewId, own);
-			if (state.pending) return state.comparison.counted ? Promise.resolve(state.comparison) : void 0;
-		}
-		loading = data.coverage(snapshot.reviewId, own);
-		comparisons.set(key, loading);
-		return loading;
-	};
-	const withViewed = (file) => ({
-		...file,
-		viewed: marks.get(file.path)?.fingerprint === file.fingerprint ? marks.get(file.path).coverage : emptyCoverage()
-	});
-	const files = comparison.files.map(withViewed);
-	const referenceFiles = {};
-	const fileSources = new Map(comparison.fileSources);
-	const alignments = new Map(comparison.alignments);
-	const resolvedSelections = {};
-	const unavailableSelections = {};
-	const pendingSources = /* @__PURE__ */ new Set();
-	const resolve = async (source) => {
-		const key = selectionKey(source);
-		if (resolvedSelections[key]) return resolvedSelections[key];
-		const sourcePins = anchorPins(source, pins);
-		const own = JSON.stringify(sourcePins) !== documentKey;
-		let ownFiles = files;
-		let ownAlignments = alignments;
-		if (own) {
-			const loading = ownComparison(sourcePins);
-			if (!loading) {
-				pendingSources.add(key);
-				return [];
-			}
-			const loaded = await loading;
-			ownFiles = loaded.files;
-			ownAlignments = loaded.alignments;
-		}
-		const file = ownFiles.find((file) => source.file === file.path || source.file === file.previousPath);
-		if (own) {
-			const group = referenceFiles[comparisonKey(sourcePins)] ??= {};
-			if (file) group[file.path] ??= withViewed(file);
-		}
-		let rows = file && ownAlignments.get(file.path);
-		if (!file && counting && !own) {
-			pendingSources.add(key);
-			return [];
-		}
-		if (!file) {
-			const [base, head] = await Promise.all(["base", "head"].map((side) => data.file(sourcePins, side, source.file).then((value) => value.text, (error) => {
-				if (error instanceof ReviewInputError && error.status === 404) return null;
-				throw error;
-			})));
-			if (base === null && head === null) throw new SelectionUnavailableError("missing_file", "File is unavailable at these pins.");
-			if (base !== null && head !== null && base !== head) throw new SelectionUnavailableError("no_alignment", "Changed context file has no alignment.");
-			rows = textualRows(source.file, "", base?.split("\n").length ?? 0, head?.split("\n").length ?? 0);
-		}
-		if (!rows) throw new SelectionUnavailableError("no_alignment", "File has no text alignment.");
-		const result = resolveDiffSelection(source, rows, file ?? { path: source.file });
-		resolvedSelections[key] = result;
-		return result;
-	};
-	const resolveAvailable = async (source) => {
-		try {
-			return await resolve(source);
-		} catch (error) {
-			unavailableSelections[selectionKey(source)] = error instanceof SelectionUnavailableError ? error.reason : "other";
-			return [];
-		}
-	};
-	const lenses = await Promise.all((snapshot.lenses ?? []).map(async (authored) => {
-		const lens = {
-			id: authored.id,
-			title: authored.title
-		};
-		try {
-			await Promise.all(lensSelections([authored]).map(({ source }) => resolveAvailable(source)));
-			const resolved = resolveFileLens(authored, files, fileSources, (source) => resolvedSelections[selectionKey(source)] ?? []);
-			return {
-				...lens,
-				...resolved,
-				pending: counting,
-				unavailable: counting || resolved.fileCount ? void 0 : "No files match these targets"
-			};
-		} catch {
-			return {
-				...lens,
-				sources: [],
-				unavailable: "Source links need updating at these pins"
-			};
-		}
-	}));
-	await Promise.all(selectionReferences(snapshot.document, {
-		tolerant: true,
-		repositoryId: boardRepositoryId(snapshot)
-	}).map(async ({ source }) => {
-		try {
-			await resolveAvailable(source);
-		} catch {}
-	}));
-	const uncategorized = counting ? [] : uncategorizedSources(files, lenses.filter((lens) => !lens.unavailable).flatMap((lens) => lens.sources));
-	lenses.push({
-		id: UNCATEGORIZED_LENS_ID,
-		title: "Uncategorized changes",
-		sources: uncategorized,
-		wholeFiles: false,
-		fileCount: new Set(uncategorized.map((source) => files.find((file) => source.file === (source.side === "base" ? file.previousPath ?? file.path : file.path))?.path ?? source.file)).size,
-		pending: counting,
-		unavailable: counting || uncategorized.length ? void 0 : "All changed lines are covered by lenses"
-	});
-	const progress = {
-		complete: !counting && !pendingSources.size,
-		files,
-		referenceFiles,
-		lenses,
-		resolvedSelections,
-		unavailableSelections
-	};
-	const untrackedFiles = pins ? await data.untrackedFiles(pins) : void 0;
-	if (untrackedFiles) progress.untrackedFiles = untrackedFiles;
-	return progress;
-}
-/** The most files an uncategorized report names; the rest are counted. */
-const REPORT_FILES = 50;
-/** What a lens author still has to place: the changed lines no lens selects,
-* grouped by file. */
-function uncategorizedReport(progress) {
-	const sources = progress.lenses.find((lens) => lens.id === "automatic-uncategorized")?.sources ?? [];
-	const byPath = /* @__PURE__ */ new Map();
-	for (const source of sources) {
-		const path = progress.files.find((file) => source.file === (source.side === "base" ? file.previousPath ?? file.path : file.path))?.path ?? source.file;
-		const entry = byPath.get(path) ?? {
-			path,
-			lines: 0,
-			ranges: []
-		};
-		entry.lines += source.toLine - source.fromLine + 1;
-		entry.ranges.push({
-			side: source.side,
-			fromLine: source.fromLine,
-			toLine: source.toLine
-		});
-		byPath.set(path, entry);
-	}
-	const files = [...byPath.values()];
-	const report = {
-		lines: files.reduce((total, file) => total + file.lines, 0),
-		files: files.slice(0, REPORT_FILES)
-	};
-	if (files.length > REPORT_FILES) report.moreFiles = files.length - REPORT_FILES;
-	return report;
-}
-/** Each lens as authored, with what it resolves to, for a lens author. */
-function lensReport(lenses, progress) {
-	return {
-		lenses: lenses.map((lens) => {
-			const resolved = progress.lenses.find((item) => item.id === lens.id);
-			return {
-				...lens,
-				fileCount: resolved?.fileCount ?? 0,
-				...resolved?.unavailable && { unavailable: resolved.unavailable }
-			};
-		}),
-		uncategorized: uncategorizedReport(progress)
-	};
-}
-//#endregion
 //#region src/ask/checkout-files.ts
 /** The checkout's files relative to its root: tracked ones, and new ones git
 * does not ignore. None where git cannot list them. */
@@ -2883,7 +2645,7 @@ function mountSharingHost(app, store, data, shared, options = {}) {
 		const parsed = parseShareLink(url);
 		const account = await readStoreAuth();
 		if (parsed.origin !== DEFAULT_STORE_ORIGIN && parsed.origin !== account?.origin) throw new ReviewInputError("This share uses an untrusted service. Sign in to that service before opening its links.", 400);
-		const id = sharedReviewId(parsed.origin, parsed.shareId);
+		const id = sharedReviewId(parsed.origin, parsed.capability);
 		if (!imports.has(id)) {
 			shared.setStatus(id, "downloading");
 			const job = (async () => {
@@ -2891,8 +2653,8 @@ function mountSharingHost(app, store, data, shared, options = {}) {
 					await shared.prepare(id);
 					return;
 				}
-				const bundle = await new ShareClient(parsed.origin).download(parsed.shareId, parsed.capability);
-				await shared.import(parsed.origin, parsed.shareId, bundle);
+				const { bundle, attribution } = await new ShareClient(parsed.origin).download(parsed.capability);
+				await shared.import(parsed.origin, parsed.capability, bundle, attribution);
 			})().catch((error) => {
 				shared.setStatus(id, "error", error instanceof ReviewInputError ? error.message : "This share is unavailable, revoked, or needs a newer Whiteboard version.");
 			}).finally(() => imports.delete(id));
@@ -2919,9 +2681,13 @@ function mountSharingPublisher(app, store, data, options = {}) {
 		const repositoryId = snapshot.pins?.repositoryId ?? snapshot.target?.repositoryId;
 		const root = repositoryId ? store.repositoryPath(repositoryId) : void 0;
 		const readRepository = options.readRepository ?? readShareRepository;
-		const repository = !root ? void 0 : snapshot.pins ? await readRepository(root) : await (async () => {
+		const commits = referenceCommits(snapshot);
+		const repository = (async () => {
+			if (!root) return void 0;
 			try {
-				return await readRepository(root);
+				const repository = await readRepository(root);
+				if (snapshot.pins || commits.length) await verifyRepository(root, snapshot.pins, commits);
+				return repository;
 			} catch {
 				return;
 			}
@@ -2930,19 +2696,12 @@ function mountSharingPublisher(app, store, data, options = {}) {
 			store,
 			data,
 			reviewId: input.reviewId,
-			version: snapshot.version,
-			repository
+			version: snapshot.version
 		});
-		const commits = referenceCommits(snapshot);
-		const verification = root && (snapshot.pins || commits.length) && repository ? verifyRepository(root, snapshot.pins, commits).then(() => ({ ok: true }), (error) => ({
-			ok: false,
-			error
-		})) : Promise.resolve({ ok: true });
+		const verified = await repository;
+		if (verified) bundle.repository = verified;
 		try {
-			const result = await new ShareClient(account.origin, account.token, options.fetch).create(bundle, input.requestId ?? randomUUID(), async () => {
-				const result = await verification;
-				if (!result.ok) throw result.error;
-			});
+			const result = await new ShareClient(account.origin, account.token, options.fetch).create(bundle, input.requestId ?? randomUUID());
 			const url = new URL(result.url);
 			if (process.env.DEV_FAST_REVIEW_APP_URL_PROTOCOL === "dev-fast-review-preview") url.searchParams.set("app", "preview");
 			options.onPublished?.({
@@ -2955,7 +2714,7 @@ function mountSharingPublisher(app, store, data, options = {}) {
 				version: snapshot.version
 			});
 		} catch (error) {
-			if (error instanceof SharePreflightError) return context.json({ error: error.message }, 422);
+			if (error instanceof ReviewInputError) throw error;
 			if (error instanceof ShareAuthError) {
 				if (process.env.DEV_REVIEW_SHARE_TOKEN === void 0) await clearStoreAuth();
 				throw new ReviewInputError("Your sign-in has expired. Sign in again to share.", 401);
@@ -2984,17 +2743,21 @@ var SharedReviewData = class {
 		this.store = store;
 	}
 	map(id, resourceId) {
-		const map = this.store.get(id).presentation.maps[resourceId];
-		if (!map) throw new ReviewInputError("Map is not included in this share.", 404);
-		return map;
+		const { maps } = this.store.get(id);
+		if (!Object.hasOwn(maps, resourceId)) throw new ReviewInputError("Map is not included in this share.", 404);
+		return maps[resourceId];
 	}
 	async resource(id, resourceId) {
-		const resource = this.store.get(id).manifest.resources.find((item) => item.id === resourceId);
-		if (!resource) throw new ReviewInputError("Resource is not included in this share.", 404);
-		return {
-			data: await this.store.readObject(id, resource.object),
-			mimeType: resource.mimeType
+		const { bundle } = this.store.get(id);
+		if (Object.hasOwn(bundle.images, resourceId)) return {
+			data: Buffer.from(bundle.images[resourceId].png, "base64"),
+			mimeType: "image/png"
+		};
+		if (Object.hasOwn(bundle.traces, resourceId)) return {
+			data: Buffer.from(JSON.stringify(bundle.traces[resourceId])),
+			mimeType: "application/json"
 		};
+		throw new ReviewInputError("Resource is not included in this share.", 404);
 	}
 };
 //#endregion
@@ -3136,6 +2899,14 @@ function documentText(snapshot, targetId, full = false, relations) {
 				}
 				for (const edge of element.edges) detail(`[${edge.id}] ${edge.from} → ${edge.to}${edge.label ? `: ${edge.label}` : ""}`);
 				break;
+			case "animation":
+				for (const [index, frame] of element.frames.entries()) detail(`Frame ${index + 1} [${frame.key}]: ${frame.title}${frame.caption ? ` — ${frame.caption}` : ""}`);
+				for (const [name, anchor] of Object.entries(element.code)) detail(`Code ${name}: ${anchor}`);
+				if (detailed) code(depth + 1, {
+					language: "html",
+					text: element.html
+				});
+				break;
 			case "software_map": detail(`Map: ${element.mapVersionId}${element.focusElementId ? `, focus: ${element.focusElementId}` : ""}`);
 		}
 	};
@@ -3272,24 +3043,53 @@ async function modified(file) {
 		return 0;
 	}
 }
+/** The folder holding a bare clone's `.git` file, as in `project/.bare`;
+* else the clone itself. */
+async function bareRoot(bare) {
+	const parent = path.dirname(bare);
+	try {
+		const gitdir = /^gitdir:\s*(.+)$/m.exec(await readFile(path.join(parent, ".git"), "utf8"))?.[1];
+		if (gitdir && path.resolve(parent, gitdir.trim()) === bare) return parent;
+	} catch {}
+	return bare;
+}
+/** A folder's project: its main checkout, its bare clone, or itself. */
+async function projectOf(folder, run) {
+	const git = (args, cwd = folder) => run("git", args, cwd).then((output) => output.trim());
+	const common = path.resolve(folder, await git([
+		"rev-parse",
+		"--path-format=absolute",
+		"--git-common-dir"
+	]));
+	if (path.basename(common) === ".git") return {
+		root: path.dirname(common),
+		common,
+		bare: false
+	};
+	if (await git(["rev-parse", "--is-bare-repository"], common) === "true") return {
+		root: await bareRoot(common),
+		common,
+		bare: true
+	};
+	return {
+		root: await git(["rev-parse", "--show-toplevel"]),
+		common,
+		bare: false
+	};
+}
 /** The repository a folder belongs to, and when it last saw Git activity.
 * Worktrees resolve to their main checkout, which lists them as targets. */
 async function repositoryOf(folder, run) {
 	try {
 		if (!(await stat(folder)).isDirectory()) return void 0;
-		const common = path.resolve(folder, (await run("git", [
-			"rev-parse",
-			"--path-format=absolute",
-			"--git-common-dir"
-		], folder)).trim());
-		if (path.basename(common) !== ".git") return void 0;
+		const { root, common } = await projectOf(folder, run);
 		const activity = await Promise.all([
 			"index",
 			"FETCH_HEAD",
 			path.join("logs", "HEAD")
 		].map((file) => modified(path.join(common, file))));
 		return {
-			root: path.dirname(common),
+			root,
 			active: Math.max(...activity)
 		};
 	} catch {
@@ -3322,9 +3122,24 @@ function parseWorktrees(output) {
 	for (const line of output.split("\n")) if (line.startsWith("worktree ")) {
 		current = { path: line.slice(9) };
 		worktrees.push(current);
-	} else if (current && line.startsWith("branch ")) current.branch = line.slice(7).replace(/^refs\/heads\//, "");
+	} else if (!current) continue;
+	else if (line.startsWith("branch ")) current.branch = line.slice(7).replace(/^refs\/heads\//, "");
+	else if (line === "bare") current.bare = true;
+	else if (line.startsWith("prunable")) current.prunable = true;
 	return worktrees;
 }
+const drawable = (worktree) => !worktree.bare && !worktree.prunable && !worktree.path.split(/[\\/]/).includes("dev-fast") && !isInside(TEMPORARY_ROOTS, worktree.path);
+/** In a bare clone, a pull request is drawn from the worktree on its branch. */
+async function checkoutOf(project, branch, run) {
+	const worktrees = parseWorktrees(await run("git", [
+		"worktree",
+		"list",
+		"--porcelain"
+	], project).catch(() => ""));
+	if (!worktrees[0]?.bare) return project;
+	const usable = worktrees.filter(drawable);
+	return (usable.find((tree) => tree.branch === branch) ?? usable[0])?.path;
+}
 const pullRequestsSchema = z.array(z.object({
 	number: z.number().int().positive(),
 	title: z.string().min(1),
@@ -3387,13 +3202,17 @@ async function pullRequests(root, run) {
 * worktrees, and its open pull requests, most recently touched first. */
 async function onboardingTargets(directory, run = runCommand) {
 	let root;
+	let bare = false;
 	try {
 		root = (await run("git", ["rev-parse", "--show-toplevel"], directory)).trim();
 	} catch {
-		throw new ReviewInputError("Choose a folder inside a Git repository.", 400);
+		const project = await projectOf(directory, run).catch(() => void 0);
+		if (!project?.bare) throw new ReviewInputError("Choose a folder inside a Git repository.", 400);
+		root = project.root;
+		bare = true;
 	}
 	const [branch, worktreeList, base, prs, times] = await Promise.all([
-		run("git", ["branch", "--show-current"], root).then((output) => output.trim(), () => ""),
+		bare ? "" : run("git", ["branch", "--show-current"], root).then((output) => output.trim(), () => ""),
 		run("git", [
 			"worktree",
 			"list",
@@ -3407,7 +3226,7 @@ async function onboardingTargets(directory, run = runCommand) {
 		target,
 		at: times.get(target.branch) ?? 0
 	});
-	const worktrees = parseWorktrees(worktreeList).filter((worktree) => worktree.branch && path.resolve(worktree.path) !== path.resolve(root) && !worktree.path.split(/[\\/]/).includes("dev-fast") && !isInside(TEMPORARY_ROOTS, worktree.path)).map((worktree) => local({
+	const worktrees = parseWorktrees(worktreeList).filter((worktree) => worktree.branch && path.resolve(worktree.path) !== path.resolve(root) && drawable(worktree)).map((worktree) => local({
 		kind: "worktree",
 		path: worktree.path,
 		branch: worktree.branch ?? ""
@@ -3450,7 +3269,8 @@ function registerOnboardingRoutes(app, store, ask, host, run = runCommand) {
 		if (!parsed.success) throw new ReviewInputError("Invalid run.", 400);
 		const input = parsed.data;
 		const { target } = input;
-		const cwd = target.kind === "pr" ? input.projectPath : target.path;
+		const cwd = target.kind === "pr" ? await checkoutOf(input.projectPath, target.branch, run) : target.path;
+		if (!cwd) throw new ReviewInputError("This bare clone has no worktrees. Add one with git worktree add.", 400);
 		let head;
 		try {
 			head = (await run("git", ["rev-parse", "HEAD"], cwd)).trim();
@@ -3638,7 +3458,7 @@ const remoteCaller = (context) => context.req.header(REVIEW_CLIENT_HEADER) === R
 function createReviewApi(store, data, open, shared, capabilities = () => ({
 	desktopAvailable: Boolean(open),
 	softwareMapEnabled: false
-}), traceEnabled = async () => false, status = () => ({}), hooks = {}, ask) {
+}), traceEnabled = async () => false, status = () => ({}), hooks = {}, ask, animationsEnabled = () => false) {
 	const app = new Hono();
 	app.onError((error, context) => {
 		if (error instanceof HttpJsonError) return context.json({ error: error.message }, error.statusCode);
@@ -3729,10 +3549,13 @@ function createReviewApi(store, data, open, shared, capabilities = () => ({
 	};
 	app.get("/", (context) => context.json(catalog()));
 	app.get("/feedback-eligibility", (context) => context.json({ eligible: store.feedbackEligible() }));
-	const instructionContext = async () => ({ traceEnabled: await traceEnabled() });
+	const instructionContext = async () => ({
+		traceEnabled: await traceEnabled(),
+		animationsEnabled: animationsEnabled()
+	});
 	app.get("/authoring", async (context) => {
 		const instructions = await instructionContext();
-		return context.json(authoringTools(instructions.traceEnabled));
+		return context.json(authoringTools(instructions.traceEnabled, instructions.animationsEnabled));
 	});
 	app.get("/instructions", async (context) => {
 		const { topic } = instructionsQuerySchema.parse(context.req.query());
@@ -3786,7 +3609,10 @@ function createReviewApi(store, data, open, shared, capabilities = () => ({
 		...status(),
 		desktopAvailable: (await capabilities()).desktopAvailable
 	}));
-	app.get("/capabilities", async (context) => context.json(await capabilities()));
+	app.get("/capabilities", async (context) => context.json({
+		...await capabilities(),
+		animationsEnabled: animationsEnabled()
+	}));
 	app.get("/:id/activity", (context) => {
 		const id = context.req.param("id");
 		readReview(id);
@@ -4721,6 +4547,12 @@ function createReviewApi(store, data, open, shared, capabilities = () => ({
 		const register = async (path) => data ? data.register(path) : store.registerRepository(path);
 		const request = withBoardRepository(await locateRepositories(await pullRequestTargets(body, register, (id) => store.read(id)), register), (id) => store.has(id) ? store.read(id) : void 0);
 		const input = commandSchema.parse(request);
+		if (!animationsEnabled() && input.operation.type === "edit") {
+			const { edit, reviewId } = input.operation;
+			const incoming = "content" in edit ? elements([edit.content]) : [];
+			const target = "targetId" in edit ? elements(readReview(reviewId).document).find((element) => element.id === edit.targetId) : void 0;
+			if (incoming.some((element) => element.type === "animation") || target?.type === "animation") throw new ReviewInputError("Animation authoring is disabled. Enable Animations in Settings under Experimental Features to edit animations. Existing animations can still be viewed.", 409);
+		}
 		const command = sharedCommandSchema.safeParse(input);
 		if (command.success && command.data.operation.reviewId?.startsWith("shared-")) {
 			const parsed = commandSchema.parse(input);
@@ -5096,7 +4928,7 @@ function createWhiteboardCore(input) {
 	const api = createReviewApi(store, data, callbacks.open, shared, callbacks.capabilities, () => traceMachineEnabled(), input.status, input.hooks, askThreads && {
 		threads: askThreads,
 		agents: async () => detectAskAgents(await ask?.env)
-	});
+	}, input.animations);
 	if (!shared) mountSharingPublisher(api, store, data);
 	return {
 		app,
@@ -5431,4 +5263,4 @@ async function serve(input) {
 	}
 }
 //#endregion
-export { saveDiffrSummarizer as C, cliAskTools as E, readDiffrConfig as S, testDiffrSummarizer as T, DEFAULT_MAX_REQUEST_BYTES as _, drainServerCrashReport as a, GlobalReviewDesktopVerbRelay as b, answerErrorsAsJson as c, legacyModeSchema as d, captureSanitizedUiTelemetry as f, readBoundedRequestJson as g, createNodeRequestListener as h, withHeadlessServerLock as i, createWhiteboardCore as l, recordClientError as m, runHeadlessServer as n, installProcessErrorTelemetry as o, clientErrorsForSession as p, takeOverServerHome as r, serverCrashReportPath as s, HeadlessServerBusyError as t, serverJson as u, HttpJsonError as v, setDiffrConfigValue as w, migrateDiffrConfig as x, ReviewServerError as y };
+export { setDiffrConfigValue as C, saveDiffrSummarizer as S, cliAskTools as T, HttpJsonError as _, drainServerCrashReport as a, migrateDiffrConfig as b, answerErrorsAsJson as c, captureSanitizedUiTelemetry as d, clientErrorsForSession as f, DEFAULT_MAX_REQUEST_BYTES as g, readBoundedRequestJson as h, withHeadlessServerLock as i, createWhiteboardCore as l, createNodeRequestListener as m, runHeadlessServer as n, installProcessErrorTelemetry as o, recordClientError as p, takeOverServerHome as r, serverCrashReportPath as s, HeadlessServerBusyError as t, serverJson as u, ReviewServerError as v, testDiffrSummarizer as w, readDiffrConfig as x, GlobalReviewDesktopVerbRelay as y };