@dev.fast/whiteboard 0.3.1 → 0.3.3-preview.20261018.123

package/dist/{account-alias-D_mqo_Jk.js → account-alias-xOdmMnDH.js}

@@ -1,10 +1,10 @@
 import { n as isJsonObject } from "./src-X9phtB2j.js";
-import { w as ReviewCliInstallStampSchema } from "./src-DZG1xAqW.js";
+import { w as ReviewCliInstallStampSchema } from "./src-DsM3jO8G.js";
 import { C as disableTraceMachine, E as traceMachineStatus, G as listTraceRepositoryRoots, K as traceRepositoryStatus, Q as removeAgentTraceHook, S as configureTraceMachine, T as traceMachineEnabled, U as disableAllTraceRepositories, W as enableTraceRepository, X as describeTraceHookOwners, Y as AGENT_TRACE_HOOK_AGENTS, Z as installHarnessHooks, dt as StoreClient, n as reviewDesktopStateDir, nt as traceScope, ot as readStoreAuth } from "./review-home-paths-Lc02WFuX.js";
 import { A as withFileLock, F as writeFileAtomicAsync, I as writePrivateJsonAtomic, M as devReviewHome } from "./s3-config-DDWWMh5x.js";
 import { i as readReviewPackageVersion } from "./package-paths-jMg6JxDP.js";
 import { n as isFile, t as isDirectory } from "./fs-utils-BMPLt0cr.js";
-import { s as findExecutable } from "./fuzzy-match-C9olHRCK.js";
+import { s as findExecutable } from "./fuzzy-match-bFX6wm8j.js";
 import { createHash } from "node:crypto";
 import { constants } from "node:fs";
 import { access, chmod, lstat, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";

package/dist/{agent-cli-Cp7ufSvb.js → agent-cli-DT7MdaqL.js}

@@ -1,11 +1,29 @@
 import { n as isJsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
 import { T as traceMachineEnabled } from "./review-home-paths-Lc02WFuX.js";
-import { a as toolResultText, i as connectReviewInstance, s as ReviewApiError } from "./agent-client-DjXQy6CL.js";
+import { a as toolResultText, i as connectReviewInstance, s as ReviewApiError } from "./agent-client-BRBzv3AV.js";
 import { M as devReviewHome } from "./s3-config-DDWWMh5x.js";
-import { b as selectReviewInstance, u as REVIEW_INSTANCE_ENV } from "./server-discovery-DVqrcIDT.js";
-import { n as reviewSessionAgent } from "./review-telemetry-ClhP_5lW.js";
-import { n as REVIEW_VIA_HEADER, t as REVIEW_AGENT_HEADER } from "./request-origin-BSwTNS8K.js";
-import { i as publicTool, n as RECOVERY, r as callPublicTool, t as toolFailure } from "./tool-failure-CVJrfi5s.js";
+import { n as readBuildCommit } from "./package-paths-jMg6JxDP.js";
+import { b as selectReviewInstance, u as REVIEW_INSTANCE_ENV } from "./server-discovery-BVqrE1_-.js";
+import { n as reviewSessionAgent } from "./review-telemetry-BHWJsnoD.js";
+import { n as REVIEW_VIA_HEADER, t as REVIEW_AGENT_HEADER } from "./request-origin-Zcn_CjX4.js";
+import { i as publicTool, n as RECOVERY, r as callPublicTool, t as toolFailure } from "./tool-failure-BFt2xj9i.js";
+import { existsSync } from "node:fs";
+import path from "node:path";
+//#region src/review-api/install-update.ts
+/** Exits once an update replaces this install, or the Windows updater marks it. */
+function exitOnInstallUpdate(stderr) {
+	const commit = readBuildCommit(import.meta.url);
+	if (!commit) return;
+	const marker = path.join(path.dirname(process.execPath), "applying_update");
+	const staleMarker = existsSync(marker);
+	const timer = setInterval(() => {
+		if (!staleMarker && existsSync(marker) || readBuildCommit(import.meta.url) !== commit) {
+			clearInterval(timer);
+			stderr.write("Whiteboard was updated. Restart its MCP server.\n", () => process.exit(75));
+		}
+	}, 1e3).unref();
+}
+//#endregion
 //#region src/review-api/agent-cli.ts
 const reviewAgentCliHelp = "whiteboard api tools  (one line per tool)\nwhiteboard api tools <tool-name>  (its description and input schema)\nwhiteboard api <tool-name> '<json>'\nwhiteboard api <tool-name> -  (read JSON from stdin)\nwhiteboard mcp  (stdio MCP adapter; Whiteboard Desktop or whiteboard server start must be running)\nSelect headless state with DEV_REVIEW_SERVER_DIR or whiteboard --state-dir <path> api/mcp.\n";
 async function runReviewAgentCli(input) {
@@ -20,7 +38,8 @@ async function runReviewAgentCli(input) {
 		if (extra.length || mode === "mcp" && name) throw new Error("Unexpected arguments. Use whiteboard api --help.");
 		const headers = Object.fromEntries([[REVIEW_VIA_HEADER, mode === "mcp" ? "mcp" : "api"], [REVIEW_AGENT_HEADER, reviewSessionAgent(env)]]);
 		if (mode === "mcp") {
-			const { serveReviewMcp } = await import("./mcp-D-7jkRTU.js");
+			const { serveReviewMcp } = await import("./mcp-DpKnnmHH.js");
+			exitOnInstallUpdate(input.stderr);
 			await serveReviewMcp(async (key, agentKind) => {
 				const connected = await connectReviewInstance(key ? {
 					...env,

package/dist/agent-cli-DeCrUC2s.js

@@ -0,0 +1,2 @@
+import { n as runReviewAgentCli } from "./agent-cli-DT7MdaqL.js";
+export { runReviewAgentCli };

package/dist/{agent-client-DjXQy6CL.js → agent-client-BRBzv3AV.js}

@@ -1,7 +1,7 @@
 import { d as isBooleanValue, f as isNumberValue, m as isStringValue, u as parseJsonText } from "./src-X9phtB2j.js";
-import "./src-DZG1xAqW.js";
+import "./src-DsM3jO8G.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
-import { b as selectReviewInstance, c as reviewServerStateDir, d as ReviewInstanceUnavailableError, i as readReviewServerDiscovery, l as serverNotReady, m as healthyReviewInstance, s as reviewServerIsHealthy, y as reviewInstanceUnavailable } from "./server-discovery-DVqrcIDT.js";
+import { b as selectReviewInstance, c as reviewServerStateDir, d as ReviewInstanceUnavailableError, i as readReviewServerDiscovery, l as serverNotReady, m as healthyReviewInstance, s as reviewServerIsHealthy, y as reviewInstanceUnavailable } from "./server-discovery-BVqrE1_-.js";
 //#region ../review-protocol/src/review-api-client.ts
 const defaultRequest = (url, init) => fetch(url, init);
 /** A non-2xx reply; the status tells a caller whether retrying can help. */
@@ -249,7 +249,7 @@ async function connectReviewInstance(env = process.env, headers = {}, options =
 	const selection = await selectReviewInstance({ env });
 	const discovery = healthyReviewInstance(selection);
 	if (!discovery) {
-		const { ensureServerWithoutDesktop } = await import("./background-server-CVL7QpsL.js");
+		const { ensureServerWithoutDesktop } = await import("./background-server-C_REWFkG.js");
 		const server = await ensureServerWithoutDesktop({
 			selection,
 			env,

package/dist/{authoring-tools-ByMdW_S8.js → authoring-tools-DGSEag8y.js}

@@ -1,5 +1,5 @@
-import { c as activityEndSchema, i as commandSchema, l as activityUpdateSchema, n as uploadSchema, s as activityBeginSchema } from "./local-data-DKmj2ygd.js";
-import { S as publishedEditSchema, y as pathTargetSchema } from "./stored-document-migration-DLBhkSfp.js";
+import { c as activityEndSchema, i as commandSchema, l as activityUpdateSchema, n as uploadSchema, s as activityBeginSchema } from "./local-data-DtQTIzHX.js";
+import { S as publishedEditSchema, y as pathTargetSchema } from "./stored-document-migration-CChxtFAy.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
 import { t as findReviewPackageRoot } from "./package-paths-jMg6JxDP.js";
 import { z } from "zod";

package/dist/{background-server-CVL7QpsL.js → background-server-C_REWFkG.js}

@@ -1,2 +1,2 @@
-import { a as headlessServerOwner, c as stopBackgroundServer, i as ensureServerWithoutDesktop, r as ensureBackgroundServer } from "./background-server-ONy-xKJ1.js";
+import { a as headlessServerOwner, c as stopBackgroundServer, i as ensureServerWithoutDesktop, r as ensureBackgroundServer } from "./background-server-WKzI_a98.js";
 export { ensureBackgroundServer, ensureServerWithoutDesktop, headlessServerOwner, stopBackgroundServer };

package/dist/{background-server-ONy-xKJ1.js → background-server-WKzI_a98.js}

@@ -1,8 +1,8 @@
 import "./review-home-paths-Lc02WFuX.js";
 import { D as liveLockOwner, O as processIsAlive } from "./s3-config-DDWWMh5x.js";
 import { t as findReviewPackageRoot } from "./package-paths-jMg6JxDP.js";
-import { a as readReviewServerHealth, c as reviewServerStateDir, i as readReviewServerDiscovery, n as desktopOwnsHome, p as desktopUsesHome, r as headlessServerLockPath } from "./server-discovery-DVqrcIDT.js";
-import { t as desktopApplicationInstalled } from "./review-app-launcher-i1hmxOZA.js";
+import { a as readReviewServerHealth, c as reviewServerStateDir, i as readReviewServerDiscovery, n as desktopOwnsHome, p as desktopUsesHome, r as headlessServerLockPath } from "./server-discovery-BVqrE1_-.js";
+import { t as desktopApplicationInstalled } from "./review-app-launcher-tqSQPlbu.js";
 import { mkdir, open, readFile, realpath, stat } from "node:fs/promises";
 import path from "node:path";
 import { spawn } from "node:child_process";

package/dist/build-info.json

@@ -1 +1 @@
-{"version":"0.3.1","commit":"674dfbb9b0de56eb16c9ac015f2f0b2b3fa01980","dirty":true,"builtAt":"2026-10-16T20:29:45.789Z"}
+{"version":"0.3.3-preview.20261018.123","commit":"5b96280747a70c90fa74e7eb2d71cccf8cf05ad7","dirty":true,"builtAt":"2026-10-18T16:53:01.255Z"}

package/dist/{cli-Cko4zfif.js → cli-BBSDi_dX.js}

@@ -1,4 +1,4 @@
-import { r as connectReviewApi } from "./agent-client-DjXQy6CL.js";
+import { r as connectReviewApi } from "./agent-client-BRBzv3AV.js";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 //#region src/sharing/cli.ts

package/dist/{cli-runner-2sJKjaRX.js → cli-runner-DshTBske.js}

@@ -1,18 +1,18 @@
 import { C as setLocalVcsCommandObserver, E as __toESM, T as __require, w as __commonJSMin } from "./src-BMPuxWv4.js";
 import { c as jsonString, n as isJsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
-import { _ as REVIEW_REMOTE_AGENT_IDS, p as REVIEW_CLI_INSTALL_TARGET_LABELS, v as REVIEW_REMOTE_ATTACH_BEGIN, y as REVIEW_REMOTE_ATTACH_END } from "./src-DZG1xAqW.js";
+import { _ as REVIEW_REMOTE_AGENT_IDS, p as REVIEW_CLI_INSTALL_TARGET_LABELS, v as REVIEW_REMOTE_ATTACH_BEGIN, y as REVIEW_REMOTE_ATTACH_END } from "./src-DsM3jO8G.js";
 import { $ as resolveTraceCommand, A as runTraceDeny, E as traceMachineStatus, F as describeSelection, H as resolveTraceRepositoryTarget, J as HOSTED_CAPTURE_SCOPE_DESCRIPTION, K as traceRepositoryStatus, L as loadS3TraceStorage, M as runTraceSessions, N as runTraceStoreDelete, P as runTraceStoreInfo, T as traceMachineEnabled, V as requireTraceConsent, _ as runTraceRepair, b as runTraceGitHook, c as registerTraceCommands, ct as runStoreLogout, d as runTraceList$1, dt as StoreClient, f as runTracePull$1, ft as withStoreAuthorization, g as runTraceInstallMachine, gt as jsonRequestedInArgv, h as runTraceEnable, ht as humanStream, j as runTraceOnboard, k as runTraceAllow, l as resolveTraceReadStorage, lt as runStoreWhoami, m as runTraceDisable, mt as failWithJsonError, nt as traceScope, ot as readStoreAuth, p as runTraceShow, pt as emitJsonEvent, q as readTraceUserConfig, rt as DEFAULT_STORE_ORIGIN, st as runStoreLogin, tt as traceHomeDir, u as runTraceBlame, ut as StoreApiError, v as runTraceStatus, w as readLegacyCaptureSettings, x as runTraceHook, y as runTraceSync, z as selectTraceStorage } from "./review-home-paths-Lc02WFuX.js";
-import { o as ReviewApiClient, s as ReviewApiError } from "./agent-client-DjXQy6CL.js";
+import { o as ReviewApiClient, s as ReviewApiError } from "./agent-client-BRBzv3AV.js";
 import { t as resolveReviewRoot } from "./runtime-CKiWhGrf.js";
 import { C as s3ProfileSchema, E as writeTraceConfigFile, M as devReviewHome, N as normalizeStoreOrigin, S as readTraceConfigFile, T as sameS3Profile, _ as emptyTraceConfig, c as resolveS3Setup, g as currentStore, h as TraceConfigurationError, i as isS3MockMode, n as clearTraceEnvCache, o as readTraceEnvFile, p as traceSettingsPath, w as s3Store } from "./s3-config-DDWWMh5x.js";
 import { t as errorMessage } from "./error-message-OtiDonty.js";
 import { i as readReviewPackageVersion, r as readBuildInfo, t as findReviewPackageRoot } from "./package-paths-jMg6JxDP.js";
-import { a as readReviewServerHealth, b as selectReviewInstance, c as reviewServerStateDir, d as ReviewInstanceUnavailableError, f as clearDefaultReviewInstance, g as requireHealthyReviewDesktop, h as readDefaultReviewInstance, i as readReviewServerDiscovery, l as serverNotReady, m as healthyReviewInstance, p as desktopUsesHome, t as DESKTOP_TAKEOVER_SIGNAL, u as REVIEW_INSTANCE_ENV, x as writeDefaultReviewInstance, y as reviewInstanceUnavailable } from "./server-discovery-DVqrcIDT.js";
-import { t as ReviewTelemetry } from "./review-telemetry-ClhP_5lW.js";
-import { t as fuzzyRank } from "./fuzzy-match-C9olHRCK.js";
-import { _ as isInstallTarget, a as isOwnedShim, f as windowsInstallerCommand, g as ALL_INSTALL_TARGETS, h as detectConnectAgents, m as connectAgent, o as pathShimPath, p as scanLegacySkills, t as aliasInstallationToAccount, v as connectPrompts } from "./account-alias-D_mqo_Jk.js";
-import { n as focusReviewDesktop, r as runReviewAppLaunch } from "./review-app-launcher-i1hmxOZA.js";
-import { t as reviewAgentCliHelp } from "./agent-cli-Cp7ufSvb.js";
+import { a as readReviewServerHealth, b as selectReviewInstance, c as reviewServerStateDir, d as ReviewInstanceUnavailableError, f as clearDefaultReviewInstance, g as requireHealthyReviewDesktop, h as readDefaultReviewInstance, i as readReviewServerDiscovery, l as serverNotReady, m as healthyReviewInstance, p as desktopUsesHome, t as DESKTOP_TAKEOVER_SIGNAL, u as REVIEW_INSTANCE_ENV, x as writeDefaultReviewInstance, y as reviewInstanceUnavailable } from "./server-discovery-BVqrE1_-.js";
+import { t as ReviewTelemetry } from "./review-telemetry-BHWJsnoD.js";
+import { t as fuzzyRank } from "./fuzzy-match-bFX6wm8j.js";
+import { _ as isInstallTarget, a as isOwnedShim, f as windowsInstallerCommand, g as ALL_INSTALL_TARGETS, h as detectConnectAgents, m as connectAgent, o as pathShimPath, p as scanLegacySkills, t as aliasInstallationToAccount, v as connectPrompts } from "./account-alias-xOdmMnDH.js";
+import { n as focusReviewDesktop, r as runReviewAppLaunch } from "./review-app-launcher-tqSQPlbu.js";
+import { t as reviewAgentCliHelp } from "./agent-cli-DT7MdaqL.js";
 import { existsSync, mkdirSync, renameSync, writeFileSync } from "node:fs";
 import { realpath } from "node:fs/promises";
 import path from "node:path";
@@ -4297,7 +4297,7 @@ async function runReviewCli(input) {
 		if (!Number.isInteger(port) || port < 0 || port > 65535) throw new ReviewCliUsageError("--port must be an integer between 0 and 65535.");
 		const stateDir = reviewServerStateDir(authoringEnv(options.stateDir));
 		if (options.detach) {
-			const { ensureBackgroundServer } = await import("./background-server-CVL7QpsL.js");
+			const { ensureBackgroundServer } = await import("./background-server-C_REWFkG.js");
 			const { discovery, started } = await ensureBackgroundServer({
 				stateDir,
 				env,
@@ -4319,7 +4319,7 @@ async function runReviewCli(input) {
 		process.once("SIGINT", stop);
 		process.once("SIGTERM", stop);
 		process.once(DESKTOP_TAKEOVER_SIGNAL, takeover);
-		const { HeadlessServerBusyError, runHeadlessServer } = await import("./headless-host-DRwHcAuF.js");
+		const { HeadlessServerBusyError, runHeadlessServer } = await import("./headless-host-CzvYpKOX.js");
 		try {
 			await runHeadlessServer({
 				stateDir,
@@ -4356,7 +4356,7 @@ async function runReviewCli(input) {
 	configureJsonOutput(serverCommand.command("stop").description("Stop a background server started by --detach, the CLI, or Desktop").option("--state-dir <path>", "directory selected when starting the server"), "plain").action(async (_options, command) => {
 		const options = command.optsWithGlobals();
 		const stateDir = reviewServerStateDir(authoringEnv(options.stateDir));
-		const { headlessServerOwner, stopBackgroundServer } = await import("./background-server-CVL7QpsL.js");
+		const { headlessServerOwner, stopBackgroundServer } = await import("./background-server-C_REWFkG.js");
 		const owner = await headlessServerOwner(stateDir);
 		const discovery = await readReviewServerDiscovery(stateDir);
 		if (owner === void 0) {
@@ -4384,7 +4384,7 @@ async function runReviewCli(input) {
 		if (!existsSync(path.join(stateDir, "review-api.db"))) throw new Error(`No saved reviews in ${stateDir}, so there is no server id to reset. Check --state-dir.`);
 		const inUse = `A Whiteboard server is using ${stateDir}. Stop it first, then run whiteboard server reset-id again.`;
 		if (await desktopUsesHome(stateDir, env)) return refuse(inUse, options.json);
-		const [{ openReviewProfile }, { withHeadlessServerLock }] = await Promise.all([import("./profile-D1rScZ-E.js"), import("./headless-host-DRwHcAuF.js")]);
+		const [{ openReviewProfile }, { withHeadlessServerLock }] = await Promise.all([import("./profile-Cz7L781D.js"), import("./headless-host-CzvYpKOX.js")]);
 		const reset = await withHeadlessServerLock(await realpath(stateDir), async () => {
 			const local = await openReviewProfile(stateDir, { manageWorkspaces: false });
 			try {
@@ -4406,7 +4406,7 @@ async function runReviewCli(input) {
 	configureJsonOutput(remote.command("attach").description("Start a background server if none is healthy and report how to reach it").option("--state-dir <path>", "directory for saved reviews and server discovery").option("--groups <groups>", "comma-separated optional extension groups the Desktop has enabled, such as go").option("--replace", "stop a running server of another version that the CLI or Desktop started, and start this one"), "plain").action(async (_options, command) => {
 		const options = command.optsWithGlobals();
 		const stateDir = reviewServerStateDir(authoringEnv(options.stateDir));
-		const { remoteAttach } = await import("./remote-attach-DJxW9402.js");
+		const { remoteAttach } = await import("./remote-attach-DCngg8cl.js");
 		let attach;
 		try {
 			attach = await remoteAttach({
@@ -4448,7 +4448,7 @@ async function runReviewCli(input) {
 	configureJsonOutput(remote.command("uninstall").description("Remove what Whiteboard Desktop installed on this host, stopping a server it started").addOption(new Option("--keep-reviews", "leave the saved reviews in place").conflicts("deleteReviews")).addOption(new Option("--delete-reviews", "also delete the saved reviews")).option("--state-dir <path>", "directory for saved reviews and server discovery"), "plain").action(async (_options, command) => {
 		const options = command.optsWithGlobals();
 		const stateDir = reviewServerStateDir(authoringEnv(options.stateDir));
-		const { remoteUninstall } = await import("./remote-uninstall-DYmNOetF.js");
+		const { remoteUninstall } = await import("./remote-uninstall-CcDOcGyi.js");
 		let deleteReviews = options.deleteReviews ? true : options.keepReviews ? false : void 0;
 		if (deleteReviews === void 0 && !options.json && input.stdin?.isTTY) {
 			const prompt = createInterface$1({
@@ -4670,14 +4670,14 @@ async function runReviewCli(input) {
 		command.showHelpAfterError(false).error("Markdown review migration is no longer supported. Ask your agent to migrate your old Whiteboard reviews.");
 	});
 	configureJsonOutput(configureJsonOutput(program.command("share").description("Upload an immutable review snapshot and return its share link"), "plain").option("--review <id>", "review ID").option("--version <number>", "Saved version to share").option("--preview", "Open the share link in Whiteboard Preview by default").option("--request-id <uuid>", "Reuse this ID when retrying the same immutable upload").action(async (options) => {
-		const { runShareCli } = await import("./cli-Cko4zfif.js");
+		const { runShareCli } = await import("./cli-BBSDi_dX.js");
 		state.exitCode = await runShareCli({
 			...input,
 			...options,
 			env: authoringEnv()
 		});
 	}).command("revoke <share-id>").description("Revoke future downloads of a share"), "plain").action(async (shareId, options) => {
-		const { runShareCli } = await import("./cli-Cko4zfif.js");
+		const { runShareCli } = await import("./cli-BBSDi_dX.js");
 		state.exitCode = await runShareCli({
 			...input,
 			...options,
@@ -4758,7 +4758,7 @@ async function runReviewCli(input) {
 		return commands;
 	} });
 	for (const [name, description] of [["api", "Call a JSON review authoring tool on the running server"], ["mcp", "Serve the JSON review authoring tools over stdio MCP"]]) configureOutput(program.command(name).description(description).argument("[args...]", "tool name and JSON input").allowUnknownOption().allowExcessArguments().helpOption(false).passThroughOptions().addHelpText("after", `\n${reviewAgentCliHelp}`), "plain").action(async (args) => {
-		const { runReviewAgentCli } = await import("./agent-cli-2D4icmBR.js");
+		const { runReviewAgentCli } = await import("./agent-cli-DeCrUC2s.js");
 		state.exitCode = await runReviewAgentCli({
 			...input,
 			env: authoringEnv(),

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { a as jsonNumber, c as jsonString, o as jsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
-import "./src-DZG1xAqW.js";
+import "./src-DsM3jO8G.js";
 import { existsSync, readFileSync, readdirSync, realpathSync } from "node:fs";
 import path from "node:path";
 import os from "node:os";
@@ -17,7 +17,7 @@ async function runCli(effectivePath) {
 `);
 		return 1;
 	}
-	const { runReviewCli } = await import("./cli-runner-2sJKjaRX.js");
+	const { runReviewCli } = await import("./cli-runner-DshTBske.js");
 	return runReviewCli({
 		argv,
 		cliPaths: {

package/dist/{client-CLqKkzOc.js → client-BN_FDxFr.js}

@@ -1,7 +1,7 @@
 import { f as gitAt } from "./src-BMPuxWv4.js";
 import { n as isJsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
-import "./src-DZG1xAqW.js";
-import { C as resourceReference, D as sourceReferences, F as lensSchema, H as markdownNodes, I as lensSelections, U as parseMarkdown, Y as sourceAnchors, _ as hasCodeReferences, c as traceSchema, h as elements, k as checkReferences, l as textIncludesQuote, n as migrateStoredDocument, o as normalizedSoftwareElementSchema, p as documentSchema, r as migrateStoredLenses, s as normalizedSoftwareRelationshipSchema, t as liftFileLenses, u as anchorPins, w as resourceReferences, x as pinsSchema } from "./stored-document-migration-DLBhkSfp.js";
+import "./src-DsM3jO8G.js";
+import { C as resourceReference, D as sourceReferences, F as lensSchema, H as markdownNodes, I as lensSelections, U as parseMarkdown, Y as sourceAnchors, _ as hasCodeReferences, c as traceSchema, h as elements, k as checkReferences, l as textIncludesQuote, n as migrateStoredDocument, o as normalizedSoftwareElementSchema, p as documentSchema, r as migrateStoredLenses, s as normalizedSoftwareRelationshipSchema, t as liftFileLenses, u as anchorPins, w as resourceReferences, x as pinsSchema } from "./stored-document-migration-CChxtFAy.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
 import { createHash, randomUUID } from "node:crypto";
 import { z } from "zod";

package/dist/{fuzzy-match-C9olHRCK.js → fuzzy-match-bFX6wm8j.js}

@@ -1,6 +1,6 @@
 import "./review-home-paths-Lc02WFuX.js";
 import { M as devReviewHome } from "./s3-config-DDWWMh5x.js";
-import { n as askAgentIds } from "./thread-state-DZihwhfu.js";
+import { n as askAgentIds } from "./thread-state-5pYr6_zM.js";
 import { createRequire } from "node:module";
 import { constants } from "node:fs";
 import { access, chmod, mkdir, readFile, rename, stat, writeFile } from "node:fs/promises";

package/dist/{headless-host-CnCDrHTx.js → headless-host-CS4Gv0c5.js}

@@ -1,21 +1,21 @@
 import { d as git, r as defaultBranch } from "./src-BMPuxWv4.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 StreamLimitError, f as readBoundedStream, l as exportShare, m as shareIdSchema, n as ShareClient, p as parseShareLink, r as SharePreflightError, s as readShareRepository, t as ShareAuthError, u as validateShareSources } from "./client-CLqKkzOc.js";
-import { a as inspectSnapshot, d as invalidateStructuralComparisons, f as diffrExecutable, i as commandSchema, p as diffrMissingError, r as SCRATCHPAD_ID } from "./local-data-DKmj2ygd.js";
-import { A as reviewDiffrSummarizerInputSchema, D as ReviewOnboardingRunRequestSchema, a as parseReviewVerbRequest, g as REVIEW_HOST_HEADER, i as parseReviewDesktopVerbResult, j as decodeStructuralDiffEvent } from "./src-DZG1xAqW.js";
+import { a as sharedReviewId, c as verifyShareRepository, d as StreamLimitError, f as readBoundedStream, l as exportShare, m as shareIdSchema, n as ShareClient, p as parseShareLink, r as SharePreflightError, s as readShareRepository, t as ShareAuthError, u as validateShareSources } from "./client-BN_FDxFr.js";
+import { a as inspectSnapshot, d as invalidateStructuralComparisons, f as diffrExecutable, i as commandSchema, p as diffrMissingError, r as SCRATCHPAD_ID } from "./local-data-DtQTIzHX.js";
+import { D as ReviewFeedbackSchema, E as ReviewFeedbackContactSchema, M as reviewDiffrSummarizerInputSchema, N as decodeStructuralDiffEvent, a as parseReviewVerbRequest, g as REVIEW_HOST_HEADER, i as parseReviewDesktopVerbResult, k as ReviewOnboardingRunRequestSchema } from "./src-DsM3jO8G.js";
 import { B as TraceStorageDeniedError, D as listReviewTraceSessions, I as isTraceStorageConfigured, O as loadReviewAgentTrace, R as resolveTraceStorage, T as traceMachineEnabled, at as openUrlInBrowser, et as shellQuote, it as clearStoreAuth, ot as readStoreAuth, rt as DEFAULT_STORE_ORIGIN, st as runStoreLogin, z as selectTraceStorage } from "./review-home-paths-Lc02WFuX.js";
-import { E as selectionReferences, G as comparisonKey, I as lensSelections, J as selectionKey, K as formatAnchor, M as UNCATEGORIZED_LENS_ID, Q as emptyCoverage, W as anchorSelection, Z as coverageSources, et as scopedCoverage, h as elements, j as stepSources, nt as unionIntervals, q as resolveDiffSelection, tt as subtractIntervals, u as anchorPins, z as fileLineRangeSchema } from "./stored-document-migration-DLBhkSfp.js";
+import { E as selectionReferences, G as comparisonKey, I as lensSelections, J as selectionKey, K as formatAnchor, M as UNCATEGORIZED_LENS_ID, Q as emptyCoverage, W as anchorSelection, Z as coverageSources, et as scopedCoverage, h as elements, j as stepSources, nt as unionIntervals, q as resolveDiffSelection, tt as subtractIntervals, u as anchorPins, z as fileLineRangeSchema } from "./stored-document-migration-CChxtFAy.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
 import { A as withFileLock, I as writePrivateJsonAtomic, M as devReviewHome, h as TraceConfigurationError, i as isS3MockMode } from "./s3-config-DDWWMh5x.js";
 import { t as errorMessage } from "./error-message-OtiDonty.js";
 import { i as readReviewPackageVersion, n as readBuildCommit, t as findReviewPackageRoot } from "./package-paths-jMg6JxDP.js";
-import { i as readReviewServerDiscovery, n as desktopOwnsHome, o as reviewServerDiscoveryPath, p as desktopUsesHome, r as headlessServerLockPath, t as DESKTOP_TAKEOVER_SIGNAL } from "./server-discovery-DVqrcIDT.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-DZihwhfu.js";
-import { t as openReviewProfile } from "./profile-B58hz5n7.js";
-import { a as REVIEW_APP_SESSION_ID_HEADER, c as sanitizeUiTelemetryEvent, i as BUNDLE_FRAME_PATTERN, l as cleanTelemetryText, r as reviewRequestOrigin, s as isReportableCleanedMessage } from "./request-origin-BSwTNS8K.js";
-import { a as defaultAskPermissions, c as launchAskAgent, i as askAgents, n as askAgentSettings, o as detectAskAgents, r as askAgentTakesMcp, t as fuzzyRank } from "./fuzzy-match-C9olHRCK.js";
-import { a as scratchpadAvailable, c as readQuerySchemas, i as renderInstructions, o as inspectQuerySchema, r as instructionsQuerySchema, s as queryAnchor, t as authoringTools } from "./authoring-tools-ByMdW_S8.js";
-import { a as headlessServerOwner, c as stopBackgroundServer } from "./background-server-ONy-xKJ1.js";
+import { _ as reviewInstanceIdentity, i as readReviewServerDiscovery, n as desktopOwnsHome, o as reviewServerDiscoveryPath, p as desktopUsesHome, r as headlessServerLockPath, t as DESKTOP_TAKEOVER_SIGNAL } from "./server-discovery-BVqrE1_-.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-5pYr6_zM.js";
+import { t as openReviewProfile } from "./profile-DaqmODhc.js";
+import { a as REVIEW_APP_SESSION_ID_HEADER, c as sanitizeUiTelemetryEvent, i as BUNDLE_FRAME_PATTERN, l as cleanTelemetryText, r as reviewRequestOrigin, s as isReportableCleanedMessage } from "./request-origin-Zcn_CjX4.js";
+import { a as defaultAskPermissions, c as launchAskAgent, i as askAgents, n as askAgentSettings, o as detectAskAgents, r as askAgentTakesMcp, t as fuzzyRank } from "./fuzzy-match-bFX6wm8j.js";
+import { a as scratchpadAvailable, c as readQuerySchemas, i as renderInstructions, o as inspectQuerySchema, r as instructionsQuerySchema, s as queryAnchor, t as authoringTools } from "./authoring-tools-DGSEag8y.js";
+import { a as headlessServerOwner, c as stopBackgroundServer } from "./background-server-WKzI_a98.js";
 import crypto$1, { createHash, randomBytes, randomUUID } from "node:crypto";
 import { z } from "zod";
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
@@ -3566,6 +3566,7 @@ function createReviewApi(store, data, open, shared, capabilities = () => ({
 		await ensureScratchpad();
 		return context.json(catalog());
 	});
+	app.get("/feedback-eligibility", (context) => context.json({ eligible: store.feedbackEligible() }));
 	const instructionContext = async () => ({
 		desktopAvailable: Boolean(open),
 		scratchpadEnabled: scratchpadEnabled(),
@@ -4482,6 +4483,51 @@ function watch(lines, subscribe) {
 	} });
 }
 //#endregion
+//#region src/server/feedback.ts
+const FEEDBACK_URL = "https://dev.fast/api/feedback";
+/** Runs behind the local API's auth middleware. No telemetry envelope is sent. */
+function mountFeedback(app) {
+	const localUrl = process.env.DEV_FAST_REVIEW_FEEDBACK_URL;
+	const receiver = localUrl && reviewInstanceIdentity(process.env).channel !== "stable" && [
+		"localhost",
+		"127.0.0.1",
+		"[::1]"
+	].includes(new URL(localUrl).hostname) ? localUrl : FEEDBACK_URL;
+	for (const [path, schema] of [["/feedback", ReviewFeedbackSchema], ["/feedback/contact", ReviewFeedbackContactSchema]]) app.post(path, async (context) => {
+		const input = schema.safeParse(await readBoundedRequestJson(context.req.raw, 65536));
+		if (!input.success) return context.json({
+			ok: false,
+			error: "Invalid feedback."
+		}, 400);
+		const signal = AbortSignal.any([context.req.raw.signal, AbortSignal.timeout(5e3)]);
+		try {
+			const response = await fetch(receiver, {
+				method: "POST",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify(input.data),
+				signal,
+				redirect: "error"
+			});
+			const body = await response.json().catch((error) => {
+				if (signal.aborted || error instanceof TypeError) throw error;
+				return null;
+			});
+			if (!response.ok || body?.ok !== true) return context.json({
+				ok: false,
+				code: "receiver",
+				error: "Feedback could not be saved. Please try again."
+			}, 502);
+			return context.json({ ok: true });
+		} catch {
+			return context.json({
+				ok: false,
+				code: "network",
+				error: "Feedback could not be saved. Please try again."
+			}, 502);
+		}
+	});
+}
+//#endregion
 //#region src/server/review-server-core.ts
 const version = readReviewPackageVersion(import.meta.url);
 const commit = readBuildCommit(import.meta.url);
@@ -4519,6 +4565,7 @@ function createReviewServerApp(input) {
 		await next();
 	});
 	app.get("/control", (context) => openControlEvents(context, input.relay));
+	mountFeedback(app);
 	app.post("/control/result", async (context) => {
 		const accepted = input.relay.acceptResult(await readBoundedRequestJson(context.req.raw));
 		return serverJson(accepted ? 200 : 404, { ok: accepted });

package/dist/{headless-host-DRwHcAuF.js → headless-host-CzvYpKOX.js}

@@ -1,2 +1,2 @@
-import { i as withHeadlessServerLock, n as runHeadlessServer, r as takeOverServerHome, t as HeadlessServerBusyError } from "./headless-host-CnCDrHTx.js";
+import { i as withHeadlessServerLock, n as runHeadlessServer, r as takeOverServerHome, t as HeadlessServerBusyError } from "./headless-host-CS4Gv0c5.js";
 export { HeadlessServerBusyError, runHeadlessServer, takeOverServerHome, withHeadlessServerLock };

package/dist/{local-data-DKmj2ygd.js → local-data-DtQTIzHX.js}

@@ -1,13 +1,13 @@
 import { _ as parseGitRemote, a as diff, b as resolveRepoContextSync, c as diffFileSummariesWorkingTree, d as git, g as listTrackedFilesAtCommit, h as listCommitRange, i as detectLocalVcs, l as diffTrees, m as jjRevisionIsConflicted, n as createBlobBatchReader, p as gitCommonDir, s as diffFileSummariesTrees, t as LocalVcsToolsMissingError, u as diffWorkingTree, v as readFileAtCommit, x as resolveRevision, y as resolveRepoContext } from "./src-BMPuxWv4.js";
 import { c as jsonString, o as jsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
-import { M as structuralChangeCounts, j as decodeStructuralDiffEvent, k as SCRATCHPAD_REVIEW_ID } from "./src-DZG1xAqW.js";
+import { N as decodeStructuralDiffEvent, P as structuralChangeCounts, j as SCRATCHPAD_REVIEW_ID } from "./src-DsM3jO8G.js";
 import { s as safeStorageSegment } from "./review-home-paths-Lc02WFuX.js";
-import { $ as intersectIntervals, A as documentAdvice, B as requireVisibleSource, C as resourceReference, D as sourceReferences, I as lensSelections, L as SourceRangeError, N as applyLensEdit, O as summarizeEdit, P as lensEditSchema, Q as emptyCoverage, R as checkSourcePath, T as reviewTargetSchema, V as sliceSourceRange, X as coverageSchema, Y as sourceAnchors, a as defineSoftwareMap, b as pinnedRepositoryIds, c as traceSchema, d as applyEdit, f as assignFreshIds, g as explicitPins, h as elements, i as SoftwareModelValidationError, k as checkReferences, l as textIncludesQuote, m as editSchema, n as migrateStoredDocument, nt as unionIntervals, p as documentSchema, r as migrateStoredLenses, rt as updateCoverage, t as liftFileLenses, tt as subtractIntervals, u as anchorPins, v as isUnit, w as resourceReferences, x as pinsSchema, z as fileLineRangeSchema } from "./stored-document-migration-DLBhkSfp.js";
+import { $ as intersectIntervals, A as documentAdvice, B as requireVisibleSource, C as resourceReference, D as sourceReferences, I as lensSelections, L as SourceRangeError, N as applyLensEdit, O as summarizeEdit, P as lensEditSchema, Q as emptyCoverage, R as checkSourcePath, T as reviewTargetSchema, V as sliceSourceRange, X as coverageSchema, Y as sourceAnchors, a as defineSoftwareMap, b as pinnedRepositoryIds, c as traceSchema, d as applyEdit, f as assignFreshIds, g as explicitPins, h as elements, i as SoftwareModelValidationError, k as checkReferences, l as textIncludesQuote, m as editSchema, n as migrateStoredDocument, nt as unionIntervals, p as documentSchema, r as migrateStoredLenses, rt as updateCoverage, t as liftFileLenses, tt as subtractIntervals, u as anchorPins, v as isUnit, w as resourceReferences, x as pinsSchema, z as fileLineRangeSchema } from "./stored-document-migration-CChxtFAy.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
 import { A as withFileLock, I as writePrivateJsonAtomic, O as processIsAlive } from "./s3-config-DDWWMh5x.js";
 import { t as errorMessage } from "./error-message-OtiDonty.js";
 import { r as isMissingFileError } from "./fs-utils-BMPLt0cr.js";
-import { a as askHistoryEntrySchema, i as askEntrySchema, o as askOfferSchema, s as askPermissionsSchema } from "./thread-state-DZihwhfu.js";
+import { a as askHistoryEntrySchema, i as askEntrySchema, o as askOfferSchema, s as askPermissionsSchema } from "./thread-state-5pYr6_zM.js";
 import { createRequire } from "node:module";
 import crypto, { createHash, randomUUID } from "node:crypto";
 import { z } from "zod";
@@ -2552,6 +2552,19 @@ var ReviewStore = class {
 			if (!this.has(SCRATCHPAD_ID)) throw error;
 		}
 	}
+	/** Two saved board/day pairs in the last fourteen days. */
+	feedbackEligible(now = Date.now()) {
+		const row = this.db.prepare(`SELECT count(*) AS pairs FROM (
+        SELECT DISTINCT review_id, date(json_extract(snapshot, '$.createdAt')) AS utc_date
+        FROM versions
+        WHERE (version = 0 OR json_type(snapshot, '$.lastEdit') = 'object')
+          AND json_extract(snapshot, '$.kind') IS NOT 'scratchpad'
+          AND json_extract(snapshot, '$.origin.tutorial') IS NOT 1
+          AND julianday(json_extract(snapshot, '$.createdAt')) BETWEEN julianday(?) AND julianday(?)
+        LIMIT 2
+      )`).get((/* @__PURE__ */ new Date(now - 12096e5)).toISOString(), new Date(now).toISOString());
+		return Number(row?.pairs) >= 2;
+	}
 	history(id) {
 		return this.db.prepare("SELECT version,json_extract(snapshot,'$.title') AS title,json_extract(snapshot,'$.createdAt') AS created_at FROM versions WHERE review_id=? ORDER BY version").all(id).map((row) => ({
 			version: Number(row.version),

package/dist/{mcp-D-7jkRTU.js → mcp-DpKnnmHH.js}

@@ -1,7 +1,7 @@
-import { a as toolResultText, s as ReviewApiError } from "./agent-client-DjXQy6CL.js";
+import { a as toolResultText, s as ReviewApiError } from "./agent-client-BRBzv3AV.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
-import { n as REVIEW_STATUS_TOOL, t as authoringTools } from "./authoring-tools-ByMdW_S8.js";
-import { i as publicTool, n as RECOVERY, r as callPublicTool, t as toolFailure } from "./tool-failure-CVJrfi5s.js";
+import { n as REVIEW_STATUS_TOOL, t as authoringTools } from "./authoring-tools-DGSEag8y.js";
+import { i as publicTool, n as RECOVERY, r as callPublicTool, t as toolFailure } from "./tool-failure-BFt2xj9i.js";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";

package/dist/profile-Cz7L781D.js

@@ -0,0 +1,2 @@
+import { t as openReviewProfile } from "./profile-DaqmODhc.js";
+export { openReviewProfile };

package/dist/{profile-B58hz5n7.js → profile-DaqmODhc.js}

@@ -1,4 +1,4 @@
-import { o as initializeReviewStoreSchema, t as openLocalReviewStore } from "./local-data-DKmj2ygd.js";
+import { o as initializeReviewStoreSchema, t as openLocalReviewStore } from "./local-data-DtQTIzHX.js";
 import "./review-home-paths-Lc02WFuX.js";
 import { A as withFileLock } from "./s3-config-DDWWMh5x.js";
 import { access, mkdir } from "node:fs/promises";

package/dist/{remote-attach-DJxW9402.js → remote-attach-DCngg8cl.js}

@@ -1,7 +1,7 @@
 import { i as readReviewPackageVersion } from "./package-paths-jMg6JxDP.js";
-import { a as readReviewServerHealth, l as serverNotReady } from "./server-discovery-DVqrcIDT.js";
-import { c as stopBackgroundServer, o as recordedBackgroundServer, r as ensureBackgroundServer } from "./background-server-ONy-xKJ1.js";
-import { t as ensureRemoteLanguageServer } from "./remote-language-server-CGsCaqro.js";
+import { a as readReviewServerHealth, l as serverNotReady } from "./server-discovery-BVqrE1_-.js";
+import { c as stopBackgroundServer, o as recordedBackgroundServer, r as ensureBackgroundServer } from "./background-server-WKzI_a98.js";
+import { t as ensureRemoteLanguageServer } from "./remote-language-server-UWQgpoh-.js";
 import path from "node:path";
 import { spawn } from "node:child_process";
 import { gt, valid } from "semver";

package/dist/{remote-language-server-CGsCaqro.js → remote-language-server-UWQgpoh-.js}

@@ -1,7 +1,7 @@
 import "./review-home-paths-Lc02WFuX.js";
 import { A as withFileLock, k as processStartIdentity } from "./s3-config-DDWWMh5x.js";
 import { t as findReviewPackageRoot } from "./package-paths-jMg6JxDP.js";
-import { n as cliSpawn, s as spawnDetached } from "./background-server-ONy-xKJ1.js";
+import { n as cliSpawn, s as spawnDetached } from "./background-server-WKzI_a98.js";
 import { r as remoteServerPaths, t as ensureRemoteExtensions } from "./remote-extensions-BCAbQZTv.js";
 import { randomBytes } from "node:crypto";
 import { z } from "zod";

package/dist/{remote-uninstall-DYmNOetF.js → remote-uninstall-CcDOcGyi.js}

@@ -1,9 +1,9 @@
-import { b as REVIEW_REMOTE_INSTALL_LOCK, x as REVIEW_REMOTE_WRAPPER_MARK } from "./src-DZG1xAqW.js";
+import { b as REVIEW_REMOTE_INSTALL_LOCK, x as REVIEW_REMOTE_WRAPPER_MARK } from "./src-DsM3jO8G.js";
 import "./review-home-paths-Lc02WFuX.js";
 import { j as DEV_REVIEW_HOME_ENV } from "./s3-config-DDWWMh5x.js";
-import { c as stopBackgroundServer, o as recordedBackgroundServer } from "./background-server-ONy-xKJ1.js";
+import { c as stopBackgroundServer, o as recordedBackgroundServer } from "./background-server-WKzI_a98.js";
 import { i as whiteboardRemoteHome } from "./remote-extensions-BCAbQZTv.js";
-import { n as remoteLanguageServerGroups, r as stopProcessGroup } from "./remote-language-server-CGsCaqro.js";
+import { n as remoteLanguageServerGroups, r as stopProcessGroup } from "./remote-language-server-UWQgpoh-.js";
 import { existsSync } from "node:fs";
 import { lstat, mkdir, readFile, readdir, rm, stat } from "node:fs/promises";
 import path from "node:path";

package/dist/{request-origin-BSwTNS8K.js → request-origin-Zcn_CjX4.js}

@@ -1,6 +1,6 @@
 import { a as jsonNumber, c as jsonString, i as jsonBoolean, n as isJsonObject } from "./src-X9phtB2j.js";
-import { S as REVIEW_THEME_CHOICES, h as REVIEW_DIFF_LAYOUT_SCOPES, m as REVIEW_DIFF_LAYOUTS } from "./src-DZG1xAqW.js";
-import { n as askAgentIds } from "./thread-state-DZihwhfu.js";
+import { S as REVIEW_THEME_CHOICES, h as REVIEW_DIFF_LAYOUT_SCOPES, m as REVIEW_DIFF_LAYOUTS } from "./src-DsM3jO8G.js";
+import { n as askAgentIds } from "./thread-state-5pYr6_zM.js";
 import { z } from "zod";
 //#region src/telemetry-clean-text.ts
 const USER_DATA_REGEXES = [

package/dist/{review-app-launcher-i1hmxOZA.js → review-app-launcher-tqSQPlbu.js}

@@ -1,5 +1,5 @@
-import { o as parseReviewVerbResponse } from "./src-DZG1xAqW.js";
-import { b as selectReviewInstance, m as healthyReviewInstance, v as reviewInstanceStartHint, y as reviewInstanceUnavailable } from "./server-discovery-DVqrcIDT.js";
+import { o as parseReviewVerbResponse } from "./src-DsM3jO8G.js";
+import { b as selectReviewInstance, m as healthyReviewInstance, v as reviewInstanceStartHint, y as reviewInstanceUnavailable } from "./server-discovery-BVqrE1_-.js";
 import { closeSync, existsSync, fstatSync, mkdtempSync, openSync, readSync } from "node:fs";
 import path from "node:path";
 import { homedir, tmpdir } from "node:os";

package/dist/{review-telemetry-ClhP_5lW.js → review-telemetry-BHWJsnoD.js}

@@ -1,9 +1,9 @@
 import { c as jsonString, l as jsonValueSchema, o as jsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
-import "./src-DZG1xAqW.js";
+import "./src-DsM3jO8G.js";
 import "./review-home-paths-Lc02WFuX.js";
 import { A as withFileLock, M as devReviewHome, O as processIsAlive, P as writeFileAtomic } from "./s3-config-DDWWMh5x.js";
 import { i as readReviewPackageVersion, t as findReviewPackageRoot } from "./package-paths-jMg6JxDP.js";
-import "./request-origin-BSwTNS8K.js";
+import "./request-origin-Zcn_CjX4.js";
 import { createHmac, randomUUID } from "node:crypto";
 import { z } from "zod";
 import { existsSync, readFileSync, rmSync } from "node:fs";

package/dist/server/desktop-host.js

@@ -1,22 +1,22 @@
 #!/usr/bin/env node
 import { S as splitGitPatchFiles, a as diff, o as diffFileSummaries } from "../src-BMPuxWv4.js";
 import { c as jsonString, i as jsonBoolean, n as isJsonObject, p as isObjectValue, s as jsonProperty, u as parseJsonText } from "../src-X9phtB2j.js";
-import { d as StreamLimitError, f as readBoundedStream, i as SharedReviewStore } from "../client-CLqKkzOc.js";
-import { u as pullRequestProvider } from "../local-data-DKmj2ygd.js";
-import { A as reviewDiffrSummarizerInputSchema, E as ReviewGatewayHostSchema, T as ReviewConnectRequestSchema, c as ReviewBugReportMetaV2Schema, d as REVIEW_CLIENT_HEADER, f as REVIEW_CLIENT_REMOTE, g as REVIEW_HOST_HEADER, l as ReviewBugReportRequestSchema, r as parseReviewDesktopVerbFrame, s as parseZod, t as parseReviewCliInstallApplyRequest, u as parseReviewBugReportResponse } from "../src-DZG1xAqW.js";
+import { d as StreamLimitError, f as readBoundedStream, i as SharedReviewStore } from "../client-BN_FDxFr.js";
+import { u as pullRequestProvider } from "../local-data-DtQTIzHX.js";
+import { M as reviewDiffrSummarizerInputSchema, O as ReviewGatewayHostSchema, T as ReviewConnectRequestSchema, c as ReviewBugReportMetaV2Schema, d as REVIEW_CLIENT_HEADER, f as REVIEW_CLIENT_REMOTE, g as REVIEW_HOST_HEADER, l as ReviewBugReportRequestSchema, r as parseReviewDesktopVerbFrame, s as parseZod, t as parseReviewCliInstallApplyRequest, u as parseReviewBugReportResponse } from "../src-DsM3jO8G.js";
 import { i as reviewInstanceDiscoveryPath, o as reviewLegacyDiscoveryPath } from "../review-home-paths-Lc02WFuX.js";
-import { w as resourceReferences } from "../stored-document-migration-DLBhkSfp.js";
+import { w as resourceReferences } from "../stored-document-migration-CChxtFAy.js";
 import { t as ReviewInputError } from "../input-error-OLgB_h31.js";
 import { I as writePrivateJsonAtomic, M as devReviewHome } from "../s3-config-DDWWMh5x.js";
 import { t as errorMessage } from "../error-message-OtiDonty.js";
 import { i as readReviewPackageVersion, t as findReviewPackageRoot } from "../package-paths-jMg6JxDP.js";
-import { _ as reviewInstanceIdentity, u as REVIEW_INSTANCE_ENV } from "../server-discovery-DVqrcIDT.js";
-import { t as openReviewProfile } from "../profile-B58hz5n7.js";
-import { r as reviewTelemetryChannel, t as ReviewTelemetry } from "../review-telemetry-ClhP_5lW.js";
-import { o as REVIEW_TELEMETRY_TABS } from "../request-origin-BSwTNS8K.js";
-import { c as removeLegacyReviewSkills, d as skipCliInstall, h as detectConnectAgents, i as finishCliInstallUpdate, l as resetCliInstall, m as connectAgent, n as applyCliInstall, o as pathShimPath, r as declineCliInstall, s as removeCliInstall, t as aliasInstallationToAccount, u as resolveCliInstallStatus } from "../account-alias-D_mqo_Jk.js";
-import { C as saveDiffrSummarizer, E as cliAskTools, S as readDiffrConfig, T as testDiffrSummarizer, _ as DEFAULT_MAX_REQUEST_BYTES, a as drainServerCrashReport, b as GlobalReviewDesktopVerbRelay, c as answerErrorsAsJson, d as legacyModeSchema, f as captureSanitizedUiTelemetry, g as readBoundedRequestJson, h as createNodeRequestListener, l as createWhiteboardCore, m as recordClientError, o as installProcessErrorTelemetry, p as clientErrorsForSession, r as takeOverServerHome, s as serverCrashReportPath, u as serverJson, v as HttpJsonError, w as setDiffrConfigValue, x as migrateDiffrConfig, y as ReviewServerError } from "../headless-host-CnCDrHTx.js";
-import { c as readQuerySchemas } from "../authoring-tools-ByMdW_S8.js";
+import { _ as reviewInstanceIdentity, u as REVIEW_INSTANCE_ENV } from "../server-discovery-BVqrE1_-.js";
+import { t as openReviewProfile } from "../profile-DaqmODhc.js";
+import { r as reviewTelemetryChannel, t as ReviewTelemetry } from "../review-telemetry-BHWJsnoD.js";
+import { o as REVIEW_TELEMETRY_TABS } from "../request-origin-Zcn_CjX4.js";
+import { c as removeLegacyReviewSkills, d as skipCliInstall, h as detectConnectAgents, i as finishCliInstallUpdate, l as resetCliInstall, m as connectAgent, n as applyCliInstall, o as pathShimPath, r as declineCliInstall, s as removeCliInstall, t as aliasInstallationToAccount, u as resolveCliInstallStatus } from "../account-alias-xOdmMnDH.js";
+import { C as saveDiffrSummarizer, E as cliAskTools, S as readDiffrConfig, T as testDiffrSummarizer, _ as DEFAULT_MAX_REQUEST_BYTES, a as drainServerCrashReport, b as GlobalReviewDesktopVerbRelay, c as answerErrorsAsJson, d as legacyModeSchema, f as captureSanitizedUiTelemetry, g as readBoundedRequestJson, h as createNodeRequestListener, l as createWhiteboardCore, m as recordClientError, o as installProcessErrorTelemetry, p as clientErrorsForSession, r as takeOverServerHome, s as serverCrashReportPath, u as serverJson, v as HttpJsonError, w as setDiffrConfigValue, x as migrateDiffrConfig, y as ReviewServerError } from "../headless-host-CS4Gv0c5.js";
+import { c as readQuerySchemas } from "../authoring-tools-DGSEag8y.js";
 import crypto, { createHash, randomBytes } from "node:crypto";
 import { z } from "zod";
 import fs, { existsSync, readFileSync } from "node:fs";

package/dist/{server-discovery-DVqrcIDT.js → server-discovery-BVqrE1_-.js}

@@ -1,5 +1,5 @@
 import { a as jsonNumber, n as isJsonObject, s as jsonProperty, u as parseJsonText } from "./src-X9phtB2j.js";
-import { n as parseReviewDesktopDiscovery } from "./src-DZG1xAqW.js";
+import { n as parseReviewDesktopDiscovery } from "./src-DsM3jO8G.js";
 import { a as reviewInstancesDir, o as reviewLegacyDiscoveryPath, r as reviewDevInstanceKey, t as reviewDefaultInstancePath } from "./review-home-paths-Lc02WFuX.js";
 import { M as devReviewHome, O as processIsAlive, j as DEV_REVIEW_HOME_ENV } from "./s3-config-DDWWMh5x.js";
 import { z } from "zod";

package/dist/sharing/index.d.ts

@@ -1484,6 +1484,8 @@ declare class ReviewStore {
   /** The one scratchpad, made on first use. A host that loses the race to
    * another on the same home finds it made. */
   ensureScratchpad(): Promise<void>;
+  /** Two saved board/day pairs in the last fourteen days. */
+  feedbackEligible(now?: number): boolean;
   history(id: string): {
     version: number;
     title: string;

package/dist/sharing/index.js

@@ -1,2 +1,2 @@
-import { a as sharedReviewId, c as verifyShareRepository, i as SharedReviewStore, l as exportShare, n as ShareClient, o as validateShareBundle } from "../client-CLqKkzOc.js";
+import { a as sharedReviewId, c as verifyShareRepository, i as SharedReviewStore, l as exportShare, n as ShareClient, o as validateShareBundle } from "../client-BN_FDxFr.js";
 export { ShareClient, SharedReviewStore, exportShare, sharedReviewId, validateShareBundle, verifyShareRepository };

package/dist/{src-DZG1xAqW.js → src-DsM3jO8G.js}

@@ -831,6 +831,66 @@ z.discriminatedUnion("ok", [z.strictObject({
 	toolCalls: z.number(),
 	events: z.array(ReviewAgentTraceEventSchema)
 }), ReviewErrorResponseSchema]);
+const REVIEW_FEEDBACK_CAMPAIGN = "whiteboard-feedback-2026-10";
+/** The host supplies its persistent installation ID, not a form or launch ID. */
+const feedbackId = z.string().min(1).max(128).regex(/^[A-Za-z0-9_-]+$/);
+const feedbackSelections = (values) => z.array(z.enum(values)).max(values.length).refine((items) => new Set(items).size === items.length);
+/** Required survey answers and optional contact are separate submissions. */
+const ReviewFeedbackSchema = z.strictObject({
+	id: feedbackId,
+	campaign: z.literal(REVIEW_FEEDBACK_CAMPAIGN),
+	environment: z.enum([
+		"production",
+		"preview",
+		"development",
+		"test"
+	]).optional(),
+	contexts: feedbackSelections([
+		"work",
+		"personal_projects",
+		"open_source_projects",
+		"other"
+	]).refine((items) => items.length > 0),
+	contextsOther: z.string().trim().max(500).optional(),
+	benefit: z.string().trim().min(1).max(4e3),
+	feature: z.enum([
+		"code_understanding",
+		"planning_editing",
+		"collaboration",
+		"other"
+	]),
+	featureOther: z.string().trim().max(500).optional(),
+	rating: z.number().int().min(1).max(5),
+	roles: feedbackSelections([
+		"developer",
+		"engineering_manager",
+		"founder",
+		"other"
+	]).refine((items) => items.length > 0),
+	rolesOther: z.string().trim().max(500).optional()
+}).superRefine((response, context) => {
+	for (const [selected, other] of [
+		[response.contexts.includes("other"), "contextsOther"],
+		[response.feature === "other", "featureOther"],
+		[response.roles.includes("other"), "rolesOther"]
+	]) if (selected ? !response[other]?.trim() : response[other] !== void 0) context.addIssue({
+		code: "custom",
+		path: [other],
+		message: selected ? "Describe Other." : "Select Other before supplying its text."
+	});
+});
+const ReviewFeedbackContactSchema = z.strictObject({
+	kind: z.literal("contact"),
+	id: feedbackId,
+	campaign: z.literal(REVIEW_FEEDBACK_CAMPAIGN),
+	environment: z.enum([
+		"production",
+		"preview",
+		"development",
+		"test"
+	]).optional(),
+	email: z.email().max(254)
+});
 //#endregion
 //#region ../review-protocol/src/bug-report.ts
 const requiredString = z.string({ error: "must be a string" }).refine((value) => value.trim().length > 0, "must be a string");
@@ -979,4 +1039,4 @@ function formatIssuePath(path) {
 	return output;
 }
 //#endregion
-export { reviewDiffrSummarizerInputSchema as A, ReviewApiSelectionSourceSchema as C, ReviewOnboardingRunRequestSchema as D, ReviewGatewayHostSchema as E, structuralChangeCounts as M, ReviewSelectedDiffSchema as O, REVIEW_THEME_CHOICES as S, ReviewConnectRequestSchema as T, REVIEW_REMOTE_AGENT_IDS as _, parseReviewVerbRequest as a, REVIEW_REMOTE_INSTALL_LOCK as b, ReviewBugReportMetaV2Schema as c, REVIEW_CLIENT_HEADER as d, REVIEW_CLIENT_REMOTE as f, REVIEW_HOST_HEADER as g, REVIEW_DIFF_LAYOUT_SCOPES as h, parseReviewDesktopVerbResult as i, decodeStructuralDiffEvent as j, SCRATCHPAD_REVIEW_ID as k, ReviewBugReportRequestSchema as l, REVIEW_DIFF_LAYOUTS as m, parseReviewDesktopDiscovery as n, parseReviewVerbResponse as o, REVIEW_CLI_INSTALL_TARGET_LABELS as p, parseReviewDesktopVerbFrame as r, parseZod as s, parseReviewCliInstallApplyRequest as t, parseReviewBugReportResponse as u, REVIEW_REMOTE_ATTACH_BEGIN as v, ReviewCliInstallStampSchema as w, REVIEW_REMOTE_WRAPPER_MARK as x, REVIEW_REMOTE_ATTACH_END as y };
+export { ReviewSelectedDiffSchema as A, ReviewApiSelectionSourceSchema as C, ReviewFeedbackSchema as D, ReviewFeedbackContactSchema as E, reviewDiffrSummarizerInputSchema as M, decodeStructuralDiffEvent as N, ReviewGatewayHostSchema as O, structuralChangeCounts as P, REVIEW_THEME_CHOICES as S, ReviewConnectRequestSchema as T, REVIEW_REMOTE_AGENT_IDS as _, parseReviewVerbRequest as a, REVIEW_REMOTE_INSTALL_LOCK as b, ReviewBugReportMetaV2Schema as c, REVIEW_CLIENT_HEADER as d, REVIEW_CLIENT_REMOTE as f, REVIEW_HOST_HEADER as g, REVIEW_DIFF_LAYOUT_SCOPES as h, parseReviewDesktopVerbResult as i, SCRATCHPAD_REVIEW_ID as j, ReviewOnboardingRunRequestSchema as k, ReviewBugReportRequestSchema as l, REVIEW_DIFF_LAYOUTS as m, parseReviewDesktopDiscovery as n, parseReviewVerbResponse as o, REVIEW_CLI_INSTALL_TARGET_LABELS as p, parseReviewDesktopVerbFrame as r, parseZod as s, parseReviewCliInstallApplyRequest as t, parseReviewBugReportResponse as u, REVIEW_REMOTE_ATTACH_BEGIN as v, ReviewCliInstallStampSchema as w, REVIEW_REMOTE_WRAPPER_MARK as x, REVIEW_REMOTE_ATTACH_END as y };

package/dist/{stored-document-migration-DLBhkSfp.js → stored-document-migration-CChxtFAy.js}

@@ -1,5 +1,5 @@
 import { f as isNumberValue, l as jsonValueSchema, m as isStringValue, n as isJsonObject } from "./src-X9phtB2j.js";
-import "./src-DZG1xAqW.js";
+import "./src-DsM3jO8G.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
 import { z } from "zod";
 import { fromMarkdown } from "mdast-util-from-markdown";

package/dist/{thread-state-DZihwhfu.js → thread-state-5pYr6_zM.js}

@@ -1,4 +1,4 @@
-import { C as ReviewApiSelectionSourceSchema, O as ReviewSelectedDiffSchema } from "./src-DZG1xAqW.js";
+import { A as ReviewSelectedDiffSchema, C as ReviewApiSelectionSourceSchema } from "./src-DsM3jO8G.js";
 import { z } from "zod";
 /** A semantic selection, independent of comment/thread creation. */
 const AgentSelectionSchema = z.strictObject({

package/dist/{tool-failure-CVJrfi5s.js → tool-failure-BFt2xj9i.js}

@@ -1,5 +1,5 @@
 import { m as isStringValue, n as isJsonObject } from "./src-X9phtB2j.js";
-import { n as callAuthoringTool, s as ReviewApiError, t as ToolText } from "./agent-client-DjXQy6CL.js";
+import { n as callAuthoringTool, s as ReviewApiError, t as ToolText } from "./agent-client-BRBzv3AV.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
 //#region src/review-api/public-tools.ts
 function publicDescription(text) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dev.fast/whiteboard",
-  "version": "0.3.1",
+  "version": "0.3.3-preview.20261018.123",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -74,11 +74,11 @@
     "tsx": "4.21.0",
     "typescript": "6.0.3",
     "vitest": "4.1.11",
-    "@dev.fast/trace-core": "0.0.0",
+    "@dev.fast/json": "0.0.0",
     "@dev.fast/review-share-protocol": "0.1.2",
-    "@dev.fast/review-protocol": "0.0.0",
+    "@dev.fast/trace-core": "0.0.0",
     "@dev.fast/trace-protocol": "0.5.0",
-    "@dev.fast/json": "0.0.0"
+    "@dev.fast/review-protocol": "0.0.0"
   },
   "engines": {
     "node": ">=24 <25"
@@ -88,7 +88,7 @@
     "repo": "devdotfast/review",
     "docs": "packages/review/instructions/authoring.md"
   },
-  "gitHead": "674dfbb9b0de56eb16c9ac015f2f0b2b3fa01980",
+  "gitHead": "5b96280747a70c90fa74e7eb2d71cccf8cf05ad7",
   "scripts": {
     "prebuild": "pnpm run build:workspace-deps",
     "build": "node --max-old-space-size=8192 node_modules/tsdown/dist/run.mjs",

package/src/review-api/agent-cli.ts

@@ -17,6 +17,7 @@ import {
   toolResultText,
 } from "./agent-client.js";
 import { type ReviewApiClient, ReviewApiError } from "./client.js";
+import { exitOnInstallUpdate } from "./install-update.js";
 import { callPublicTool, publicTool } from "./public-tools.js";
 import { RECOVERY } from "./recovery.js";
 import { REVIEW_AGENT_HEADER, REVIEW_VIA_HEADER } from "./request-origin.js";
@@ -70,6 +71,7 @@ export async function runReviewAgentCli(input: AgentCliInput): Promise<number> {
 
     if (mode === "mcp") {
       const { serveReviewMcp } = await import("./mcp.js");
+      exitOnInstallUpdate(input.stderr);
       await serveReviewMcp(
         async (key, agentKind) => {
           const connected = await connectReviewInstance(

package/src/review-api/http.ts

@@ -317,6 +317,10 @@ export function createReviewApi(
     return context.json(catalog());
   });
 
+  app.get("/feedback-eligibility", (context) =>
+    context.json({ eligible: store.feedbackEligible() }),
+  );
+
   // Server-owned state only: asking the Desktop canvas would let a stalled
   // renderer block tool listing and the first instructions call.
   const instructionContext = async () => ({

package/src/review-api/install-update.ts

@@ -0,0 +1,27 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import type { Writable } from "node:stream";
+
+import { readBuildCommit } from "@review/package-paths.js";
+
+/** Exits once an update replaces this install, or the Windows updater marks it. */
+export function exitOnInstallUpdate(stderr: Writable): void {
+  const commit = readBuildCommit(import.meta.url);
+
+  if (!commit) return;
+
+  const marker = path.join(path.dirname(process.execPath), "applying_update");
+  const staleMarker = existsSync(marker);
+
+  const timer = setInterval(() => {
+    if (
+      (!staleMarker && existsSync(marker)) ||
+      readBuildCommit(import.meta.url) !== commit
+    ) {
+      clearInterval(timer);
+      stderr.write("Whiteboard was updated. Restart its MCP server.\n", () =>
+        process.exit(75),
+      );
+    }
+  }, 1000).unref();
+}

package/src/review-api/store.ts

@@ -1074,6 +1074,26 @@ export class ReviewStore {
       if (!this.has(SCRATCHPAD_ID)) throw error;
     }
   }
+  /** Two saved board/day pairs in the last fourteen days. */
+  feedbackEligible(now = Date.now()): boolean {
+    const row = this.db
+      .prepare(`SELECT count(*) AS pairs FROM (
+        SELECT DISTINCT review_id, date(json_extract(snapshot, '$.createdAt')) AS utc_date
+        FROM versions
+        WHERE (version = 0 OR json_type(snapshot, '$.lastEdit') = 'object')
+          AND json_extract(snapshot, '$.kind') IS NOT 'scratchpad'
+          AND json_extract(snapshot, '$.origin.tutorial') IS NOT 1
+          AND julianday(json_extract(snapshot, '$.createdAt')) BETWEEN julianday(?) AND julianday(?)
+        LIMIT 2
+      )`)
+      .get(
+        new Date(now - 14 * 24 * 60 * 60 * 1000).toISOString(),
+        new Date(now).toISOString(),
+      );
+
+    return Number(row?.pairs) >= 2;
+  }
+
   history(id: string) {
     return this.db
       .prepare(

package/src/server/feedback.ts

@@ -0,0 +1,80 @@
+import {
+  ReviewFeedbackContactSchema,
+  ReviewFeedbackSchema,
+} from "@dev.fast/review-protocol";
+import { reviewInstanceIdentity } from "@review/desktop-discovery";
+import type { Hono } from "hono";
+
+import { type ReviewHonoEnv, readBoundedRequestJson } from "./hono-http";
+
+const FEEDBACK_URL = "https://dev.fast/api/feedback";
+
+/** Runs behind the local API's auth middleware. No telemetry envelope is sent. */
+export function mountFeedback(app: Hono<ReviewHonoEnv>) {
+  // Dev/Preview can exercise the form against a local receiver.
+  const localUrl = process.env.DEV_FAST_REVIEW_FEEDBACK_URL;
+
+  const receiver =
+    localUrl &&
+    reviewInstanceIdentity(process.env).channel !== "stable" &&
+    ["localhost", "127.0.0.1", "[::1]"].includes(new URL(localUrl).hostname)
+      ? localUrl
+      : FEEDBACK_URL;
+
+  for (const [path, schema] of [
+    ["/feedback", ReviewFeedbackSchema],
+    ["/feedback/contact", ReviewFeedbackContactSchema],
+  ] as const) {
+    app.post(path, async (context) => {
+      const input = schema.safeParse(
+        await readBoundedRequestJson(context.req.raw, 65_536),
+      );
+
+      if (!input.success)
+        return context.json({ ok: false, error: "Invalid feedback." }, 400);
+
+      const signal = AbortSignal.any([
+        context.req.raw.signal,
+        AbortSignal.timeout(5_000),
+      ]);
+
+      try {
+        const response = await fetch(receiver, {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify(input.data),
+          signal,
+          redirect: "error",
+        });
+
+        const body = await response.json().catch((error) => {
+          if (signal.aborted || error instanceof TypeError) throw error;
+
+          return null;
+        });
+
+        if (!response.ok || body?.ok !== true) {
+          return context.json(
+            {
+              ok: false,
+              code: "receiver",
+              error: "Feedback could not be saved. Please try again.",
+            },
+            502,
+          );
+        }
+
+        return context.json({ ok: true });
+      } catch {
+        return context.json(
+          {
+            ok: false,
+            code: "network",
+            error: "Feedback could not be saved. Please try again.",
+          },
+          502,
+        );
+      }
+    });
+  }
+}

package/src/server/review-server-core.ts

@@ -30,6 +30,7 @@ import { streamSSE } from "hono/streaming";
 import type { ContentfulStatusCode } from "hono/utils/http-status";
 import { z } from "zod";
 
+import { mountFeedback } from "./feedback";
 import type { ReviewDesktopVerbRelay } from "./global-verb-relay";
 import {
   type ReviewHonoEnv,
@@ -92,6 +93,7 @@ export function createReviewServerApp(input: {
     await next();
   });
   app.get("/control", (context) => openControlEvents(context, input.relay));
+  mountFeedback(app);
   app.post("/control/result", async (context) => {
     const accepted = input.relay.acceptResult(
       await readBoundedRequestJson(context.req.raw),

package/dist/agent-cli-2D4icmBR.js

@@ -1,2 +0,0 @@
-import { n as runReviewAgentCli } from "./agent-cli-Cp7ufSvb.js";
-export { runReviewAgentCli };

package/dist/profile-D1rScZ-E.js

@@ -1,2 +0,0 @@
-import { t as openReviewProfile } from "./profile-B58hz5n7.js";
-export { openReviewProfile };