@dev.fast/whiteboard 0.2.5-preview.20261013.112 → 0.2.5-preview.20261015.115

package/THIRD_PARTY_NOTICES.md

@@ -91,3 +91,32 @@ Direct third-party runtime/UI dependencies currently include:
 - `semver` (`ISC`)
 - `zod` (`MIT`)
 - `zustand` (`MIT`)
+- `yauzl` (`MIT`)
+
+## Bundled VS Code Server
+
+The published package carries `vscode-server/`, staged by
+`apps/review-desktop/scripts/stage-vscode-server.mjs`. It is built from the
+Code OSS fork (`MIT`) and carries the fork's `LICENSE.txt` and
+`ThirdPartyNotices.txt`. It bundles:
+
+- in the server and extension host (`MIT` unless noted): `@vscode/proxy-agent`,
+  `agent-base`, `cookie`, `debug`, `http-proxy-agent`, `https-proxy-agent`,
+  `ip-address`, `minimist`, `ms`, `smart-buffer`, `socks`,
+  `socks-proxy-agent`, `supports-color`, `undici`, `vscode-regexpp` and
+  `tslib` (`0BSD`)
+- in the built-in language extensions (`MIT` unless noted): `@vscode/l10n`,
+  `@vscode/sync-api-client`, `@vscode/sync-api-common`,
+  `@vscode/sync-api-service`, `@vscode/ts-package-manager`, `jsonc-parser`,
+  `request-light`, `semver` (`ISC`), `vscode-css-languageservice`,
+  `vscode-html-languageservice`, `vscode-json-languageservice`,
+  `vscode-languageclient`, `vscode-languageserver`,
+  `vscode-languageserver-textdocument`, `vscode-tas-client` and `vscode-uri`
+- `typescript` (`Apache-2.0`), for the built-in TypeScript extension
+- `@vscode/ripgrep-universal` (`MIT`), whose `rg` binaries are ripgrep
+  (`MIT OR Unlicense`)
+- `@parcel/watcher` and its Linux prebuilds (`MIT`), with `detect-libc`
+  (`Apache-2.0`), `is-glob`, `is-extglob` and `picomatch` (`MIT`)
+
+Curated extensions are not bundled; `whiteboard remote extensions ensure`
+downloads them from Open VSX on the remote.

package/dist/{account-alias-D0hF0sKk.js → account-alias-ChZR3RIU.js}

@@ -1,7 +1,7 @@
-import { h as ReviewCliInstallStampSchema } from "./src-WCbabvdS.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-Y9mYWkCI.js";
-import { A as devReviewHome, N as writeFileAtomicAsync, O as withFileLock, P as writePrivateJsonAtomic } from "./s3-config-CAxhO9u_.js";
-import { i as readReviewPackageVersion } from "./package-paths-B9PDoAl6.js";
+import { w as ReviewCliInstallStampSchema } from "./src-Bgvf1sEN.js";
+import { $ as removeAgentTraceHook, C as disableTraceMachine, E as traceMachineStatus, G as listTraceRepositoryRoots, K as traceRepositoryStatus, Q as installHarnessHooks, S as configureTraceMachine, T as traceMachineEnabled, U as disableAllTraceRepositories, W as enableTraceRepository, Y as AGENT_TRACE_HOOK_AGENTS, Z as describeTraceHookOwners, ft as StoreClient, n as reviewDesktopStateDir, rt as traceScope, st as readStoreAuth } from "./review-home-paths-zwevIq4I.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-BsuI4WUf.js";
 import { n as isFile, t as isDirectory } from "./fs-utils-BMPLt0cr.js";
 import { createHash } from "node:crypto";
 import { constants } from "node:fs";
@@ -75,12 +75,84 @@ function fffSteps(input, target) {
 const CLAUDE_WINDOWS_MCP_ADD = `claude mcp add -s user whiteboard -- ${WINDOWS_MCP_LAUNCH.command} ${WINDOWS_MCP_LAUNCH.args.join(" ")}`;
 /** Copilot CLI loads the Claude plugin, so on Windows it too registers the server directly. */
 const COPILOT_WINDOWS_MCP_ADD = `copilot mcp add whiteboard -- ${WINDOWS_MCP_LAUNCH.command} ${WINDOWS_MCP_LAUNCH.args.join(" ")}`;
+const CONNECT_COMMANDS = {
+	claude: [
+		{ argv: [
+			"claude",
+			"plugin",
+			"marketplace",
+			"add",
+			"devdotfast/whiteboard"
+		] },
+		{ argv: [
+			"claude",
+			"plugin",
+			"install",
+			"whiteboard@devfast",
+			"--scope",
+			"user"
+		] },
+		{
+			argv: [
+				"claude",
+				"mcp",
+				"remove",
+				"-s",
+				"user",
+				"whiteboard"
+			],
+			ifAny: true
+		}
+	],
+	codex: [
+		{ argv: [
+			"codex",
+			"plugin",
+			"marketplace",
+			"add",
+			"devdotfast/whiteboard"
+		] },
+		{ argv: [
+			"codex",
+			"plugin",
+			"add",
+			"whiteboard@devfast"
+		] },
+		{
+			argv: [
+				"codex",
+				"mcp",
+				"remove",
+				"whiteboard"
+			],
+			ifAny: true
+		}
+	],
+	opencode: [{ argv: [
+		"opencode",
+		"mcp",
+		"add",
+		"--global",
+		"whiteboard",
+		"--",
+		REVIEW_MCP_LAUNCH.command,
+		...REVIEW_MCP_LAUNCH.args
+	] }],
+	pi: [{ argv: [
+		"pi",
+		"install",
+		PI_WHITEBOARD_PACKAGE
+	] }]
+};
+function runBlock(commands) {
+	return `Run:\n\n\`\`\`sh\n${commands.map(({ argv, ifAny }) => `${argv.join(" ")}${ifAny ? " # old manual registration, if any" : ""}`).join("\n")}\n\`\`\``;
+}
 function pluginSteps(target, platform) {
 	switch (target) {
 		case "claude":
 			if (platform === "win32") return [`Run:\n\n\`\`\`sh\nclaude plugin uninstall whiteboard@devfast # its launch cannot start on Windows, if installed\nclaude mcp remove -s user whiteboard # old registration, if any\n${CLAUDE_WINDOWS_MCP_ADD}\n\`\`\``];
-			return ["Run:\n\n```sh\nclaude plugin marketplace add devdotfast/whiteboard\nclaude plugin install whiteboard@devfast --scope user\nclaude mcp remove -s user whiteboard # old manual registration, if any\n```"];
-		case "codex": return ["Run:\n\n```sh\ncodex plugin marketplace add devdotfast/whiteboard\ncodex plugin add whiteboard@devfast\ncodex mcp remove whiteboard # old manual registration, if any\n```"];
+			return [runBlock(CONNECT_COMMANDS.claude)];
+		case "codex": return [runBlock(CONNECT_COMMANDS.codex)];
 		case "opencode": {
 			const launch = reviewMcpLaunch(true, platform);
 			const entry = JSON.stringify({ whiteboard: {
@@ -145,6 +217,20 @@ function connectPrompts(input) {
 	};
 }
 //#endregion
+//#region src/install.ts
+const ALL_INSTALL_TARGETS = [
+	"claude",
+	"codex",
+	"cursor",
+	"opencode",
+	"pi",
+	"omp",
+	"copilot"
+];
+function isInstallTarget(value) {
+	return ALL_INSTALL_TARGETS.some((target) => target === value);
+}
+//#endregion
 //#region src/legacy-skills.ts
 const LEGACY_SKILL_NAMES = [
 	"whiteboard",
@@ -316,7 +402,7 @@ async function windowsUserPathContains(directory, key = "HKCU\\Environment") {
 const installErrors = /* @__PURE__ */ new Map();
 const SHIM_MARKER = "Managed by Whiteboard";
 function hasManagedShimMarker(source) {
-	return source.includes(SHIM_MARKER) || source.includes("Managed by Review Desktop") || source.includes("Managed by Whiteboard Desktop");
+	return source.includes(SHIM_MARKER) || source.includes("Managed by Review Desktop") || source.includes("Managed by Whiteboard Desktop") || source.includes("# Written by Whiteboard Desktop, which replaces it with each install.");
 }
 const PROFILE_MARKER = "# Managed by Review Desktop: review command PATH. Do not edit.";
 const PROFILE_BLOCK = `\n${PROFILE_MARKER}\nexport PATH="\$HOME/.local/bin:\$PATH"\n`;
@@ -969,4 +1055,4 @@ async function aliasInstallationToAccount(telemetry, env = process.env, fetchImp
 	} catch {}
 }
 //#endregion
-export { isOwnedShim as a, removeLegacyReviewSkills as c, skipCliInstall as d, windowsInstallerCommand as f, finishCliInstallUpdate as i, resetCliInstall as l, connectPrompts as m, applyCliInstall as n, pathShimPath as o, scanLegacySkills as p, declineCliInstall as r, removeCliInstall as s, aliasInstallationToAccount as t, resolveCliInstallStatus as u };
+export { connectPrompts as _, isOwnedShim as a, removeLegacyReviewSkills as c, skipCliInstall as d, windowsInstallerCommand as f, CONNECT_COMMANDS as g, isInstallTarget as h, finishCliInstallUpdate as i, resetCliInstall as l, ALL_INSTALL_TARGETS as m, applyCliInstall as n, pathShimPath as o, scanLegacySkills as p, declineCliInstall as r, removeCliInstall as s, aliasInstallationToAccount as t, resolveCliInstallStatus as u, reviewMcpLaunch as v, cursorInstallDeeplink as y };

package/dist/{agent-cli-BBPxwUOd.js → agent-cli-CR2PnA9G.js}

@@ -1,11 +1,11 @@
 import { n as isJsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
-import { T as traceMachineEnabled } from "./review-home-paths-Y9mYWkCI.js";
-import { a as toolResultText, i as connectReviewInstance, s as ReviewApiError } from "./agent-client-P3J4y8Zn.js";
-import { A as devReviewHome } from "./s3-config-CAxhO9u_.js";
-import { d as selectReviewInstance, t as REVIEW_INSTANCE_ENV } from "./desktop-discovery-Ba3dD5Cn.js";
-import { n as reviewSessionAgent } from "./review-telemetry-CmM6tCbj.js";
-import { n as REVIEW_VIA_HEADER, t as REVIEW_AGENT_HEADER } from "./request-origin-DA4K1qWY.js";
-import { i as publicTool, n as RECOVERY, r as callPublicTool, t as toolFailure } from "./tool-failure-CJHBCHMh.js";
+import { T as traceMachineEnabled } from "./review-home-paths-zwevIq4I.js";
+import { a as toolResultText, i as connectReviewInstance, s as ReviewApiError } from "./agent-client-DVd-prfp.js";
+import { M as devReviewHome } from "./s3-config-DDWWMh5x.js";
+import { b as selectReviewInstance, u as REVIEW_INSTANCE_ENV } from "./server-discovery-CifQ3yQS.js";
+import { n as reviewSessionAgent } from "./review-telemetry-BqB4CiTD.js";
+import { n as REVIEW_VIA_HEADER, t as REVIEW_AGENT_HEADER } from "./request-origin-DaRIV3cB.js";
+import { i as publicTool, n as RECOVERY, r as callPublicTool, t as toolFailure } from "./tool-failure-BXWzQG8T.js";
 //#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) {
@@ -18,12 +18,9 @@ async function runReviewAgentCli(input) {
 			return 0;
 		}
 		if (extra.length || mode === "mcp" && name) throw new Error("Unexpected arguments. Use whiteboard api --help.");
-		const headers = {
-			[REVIEW_VIA_HEADER]: mode === "mcp" ? "mcp" : "api",
-			[REVIEW_AGENT_HEADER]: reviewSessionAgent(env)
-		};
+		const headers = Object.fromEntries([[REVIEW_VIA_HEADER, mode === "mcp" ? "mcp" : "api"], [REVIEW_AGENT_HEADER, reviewSessionAgent(env)]]);
 		if (mode === "mcp") {
-			const { serveReviewMcp } = await import("./mcp-t7VN9R3k.js");
+			const { serveReviewMcp } = await import("./mcp-DBbDwG4y.js");
 			await serveReviewMcp(async (key, agentKind) => {
 				const connected = await connectReviewInstance(key ? {
 					...env,

package/dist/agent-cli-CRPPmS3l.js

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

package/dist/{agent-client-P3J4y8Zn.js → agent-client-DVd-prfp.js}

@@ -1,8 +1,7 @@
-import { C as ReviewInputError } from "./src-DiHP11l3.js";
 import { d as isBooleanValue, f as isNumberValue, m as isStringValue, u as parseJsonText } from "./src-X9phtB2j.js";
-import "./src-WCbabvdS.js";
-import { d as selectReviewInstance, i as healthyReviewInstance, n as ReviewInstanceUnavailableError, u as reviewInstanceUnavailable } from "./desktop-discovery-Ba3dD5Cn.js";
-import { a as reviewServerIsHealthy, n as readReviewServerDiscovery, o as reviewServerStateDir, s as serverNotReady } from "./server-discovery-ZVi8Ay8J.js";
+import "./src-Bgvf1sEN.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-CifQ3yQS.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. */
@@ -44,8 +43,8 @@ var ReviewApiClient = class {
 			signal
 		})).json();
 	}
-	async *watch(reviewId, signal) {
-		const reader = (await this.response(Array.isArray(reviewId) ? `/watch?subscriptions=${encodeURIComponent(JSON.stringify(reviewId))}` : reviewId === null ? "/watch" : `/${encodeURIComponent(reviewId)}/watch`, { signal })).body.pipeThrough(new TextDecoderStream()).getReader();
+	async *watch(subscriptions, signal) {
+		const reader = (await this.response(`/watch?subscriptions=${encodeURIComponent(JSON.stringify(subscriptions))}`, { signal })).body.pipeThrough(new TextDecoderStream()).getReader();
 		const cancel = () => {
 			reader.cancel().catch(() => {});
 		};
@@ -73,7 +72,7 @@ var ReviewApiClient = class {
 		if (signal.aborted) return;
 		let connections = liveConnections.get(this.request);
 		if (!connections) liveConnections.set(this.request, connections = /* @__PURE__ */ new Map());
-		const key = JSON.stringify([this.connection.serverUrl, this.connection.token]);
+		const key = this.liveKey();
 		let live = connections.get(key);
 		if (!live) {
 			live = new LiveConnection(this, () => connections.delete(key));
@@ -83,6 +82,13 @@ var ReviewApiClient = class {
 		if (mode) subscription.mode = mode;
 		return live.add(subscription, signal, (value) => accept(value), disconnected);
 	}
+	/** Reopen the shared stream now rather than after its backoff. */
+	reconnect() {
+		liveConnections.get(this.request)?.get(this.liveKey())?.reconnect();
+	}
+	liveKey() {
+		return JSON.stringify([this.connection.serverUrl, this.connection.token]);
+	}
 };
 const restartDelayMs = 20;
 const retryDelayMs = 1e3;
@@ -97,6 +103,9 @@ function sleep(ms, signal) {
 		signal.addEventListener("abort", done, { once: true });
 	});
 }
+function concerns(line, subscription) {
+	return line.kind === "list" ? subscription.reviewId === null && (subscription.mode ?? "structural") === line.mode : subscription.reviewId === line.reviewId;
+}
 function report(listener, cause) {
 	if (listener.signal.aborted) return;
 	try {
@@ -165,13 +174,11 @@ var LiveConnection = class {
 		let delay = 1e3;
 		while (!signal.aborted) {
 			try {
-				for await (const results of this.client.watch(listeners.map((item) => item.subscription), signal)) {
+				for await (const line of this.client.watch(listeners.map((item) => item.subscription), signal)) {
 					if (signal.aborted) break;
 					delay = 1e3;
-					listeners.forEach((listener, index) => {
-						const result = results[index];
-						if (result) this.deliver(listener, result);
-					});
+					const result = line.kind === "list" ? { value: line.reviews } : line;
+					for (const listener of listeners) if (concerns(line, listener.subscription)) this.deliver(listener, result);
 				}
 				if (!signal.aborted) disconnected(/* @__PURE__ */ new Error("Connection closed."));
 			} catch (error) {
@@ -195,7 +202,7 @@ var LiveConnection = class {
 			while (listener.queued && !listener.signal.aborted) {
 				const next = listener.queued;
 				listener.queued = void 0;
-				if (next.error) {
+				if ("error" in next) {
 					report(listener, new Error(next.error));
 					continue;
 				}
@@ -222,7 +229,7 @@ const TEXT_TOOLS = /* @__PURE__ */ new Set([
 async function connectReviewApi(env = process.env, headers = {}) {
 	return (await connectReviewInstance(env, headers)).client;
 }
-async function connectReviewInstance(env = process.env, headers = {}) {
+async function connectReviewInstance(env = process.env, headers = {}, options = {}) {
 	const request = (url, init) => {
 		const merged = new Headers(init?.headers);
 		for (const [key, value] of Object.entries(headers)) merged.set(key, value);
@@ -243,6 +250,16 @@ async function connectReviewInstance(env = process.env, headers = {}) {
 	const selection = await selectReviewInstance({ env });
 	const discovery = healthyReviewInstance(selection);
 	if (!discovery) {
+		const { ensureServerWithoutDesktop } = await import("./background-server-D2Rrr_e2.js");
+		const server = await ensureServerWithoutDesktop({
+			selection,
+			env,
+			...options
+		});
+		if (server) return { client: new ReviewApiClient({
+			serverUrl: server.url,
+			token: server.token
+		}, request) };
 		const unavailable = reviewInstanceUnavailable(selection);
 		const message = `${unavailable.message} For headless authoring, select a running server with --state-dir or DEV_REVIEW_SERVER_DIR.`;
 		if (unavailable instanceof ReviewInstanceUnavailableError) throw new ReviewInstanceUnavailableError(message);

package/dist/{authoring-tools-D8WXsm_g.js → authoring-tools-BXKEwhfi.js}

@@ -1,7 +1,7 @@
-import { C as ReviewInputError } from "./src-DiHP11l3.js";
-import { g as activityUpdateSchema, h as activityEndSchema, i as commandSchema, m as activityBeginSchema, n as uploadSchema } from "./local-data-BlERtVm2.js";
-import { x as publishedEditSchema, y as pathTargetSchema } from "./stored-document-migration-u4L_1VZa.js";
-import { t as findReviewPackageRoot } from "./package-paths-B9PDoAl6.js";
+import { _ as activityUpdateSchema, g as activityEndSchema, h as activityBeginSchema, i as commandSchema, n as uploadSchema } from "./local-data-yfLp5PiJ.js";
+import { x as publishedEditSchema, y as pathTargetSchema } from "./stored-document-migration-CFOvjRwW.js";
+import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
+import { t as findReviewPackageRoot } from "./package-paths-BsuI4WUf.js";
 import { z } from "zod";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
@@ -166,7 +166,7 @@ function authoringTools(scratchpadAvailable = false, traceEnabled = false) {
 		kind: true
 	});
 	const descriptions = {
-		create: "Create a review of saved working files, immutable commits or a GitHub PR. Revisions are resolved on acceptance. A worktree target reviews the saved files in its checkout, uncommitted ones included and untracked ones left out (git add -N a new file to include it), against base: the branch to compare against, by default the default branch of the repository. The diff starts at the merge base of base and HEAD, which follows rebases. Omitted commits base means source at head with no diff; supply the parent to review introduced changes. For a GitHub PR, pullRequestUrl alone is enough: target and title become optional, and the host fetches the PR into a registered checkout of its repository and pins the current PR head and GitHub diff base, titled from the PR. When the existing review for that PR is in Trash, creation reports its ID; restore it with review_lifecycle state:\"active\" before continuing. When an active review for that PR exists, it is returned instead, reporting whether its head moved and whether an agent is working on it; update it in place, move its target with review_set_target, or create a separate review with reuseExisting. kind:\"scratchpad\" names the one scratchpad, which the host creates itself. The result carries review, the review as review_list shows it: its target with resolved commits, origin (its PR), repositoryName and repositoryPath, so no follow-up read is needed before diffing. When Desktop is available the review opens there and the result reports opened, softwareMapEnabled and environmentIssues, as review_open does; set open:false to author in the background without taking over Desktop.",
+		create: "Create a review of saved working files, immutable commits or a GitHub PR. Revisions are resolved on acceptance. A worktree target reviews the saved files in its checkout, uncommitted ones included and untracked ones left out (git add -N a new file to include it), against base: the branch to compare against, by default the default branch of the repository. The diff starts at the merge base of base and HEAD, which follows rebases. Omitted commits base means source at head with no diff; supply the parent to review introduced changes. For a branch stacked on another, pass the branch below it as base; Desktop links reviews into a stack through their bases. For a GitHub PR, pullRequestUrl alone is enough: target and title become optional, and the host fetches the PR into a registered checkout of its repository and pins the current PR head and GitHub diff base, titled from the PR. When the existing review for that PR is in Trash, creation reports its ID; restore it with review_lifecycle state:\"active\" before continuing. When an active review for that PR exists, it is returned instead, reporting whether its head moved and whether an agent is working on it; update it in place, move its target with review_set_target, or create a separate review with reuseExisting. kind:\"scratchpad\" names the one scratchpad, which the host creates itself. The result carries review, the review as review_list shows it: its target with resolved commits, origin (its PR), repositoryName and repositoryPath, so no follow-up read is needed before diffing. When Desktop is available the review opens there and the result reports opened, softwareMapEnabled and environmentIssues, as review_open does; set open:false to author in the background without taking over Desktop.",
 		set_target: "Move the review to a new target, such as the commits after a rebase or amend, preserving the document and component IDs. Revisions are resolved on acceptance. Returns warnings for retained source ranges in files the new commits changed, to verify, and resources that no longer match; fix them with review_edit. Earlier versions keep their source. Omitted pullRequestUrl keeps the PR within the same repository; changing repositories clears it. Supply a URL to replace it or null to detach.",
 		edit: [
 			"Edit one document component. content is one component, named by its type; each type's fields are in the Components section of session_get_instructions (authoring or scratchpad).",

package/dist/background-server-Cw7CcfaZ.js

@@ -0,0 +1,156 @@
+import "./review-home-paths-zwevIq4I.js";
+import { D as liveLockOwner, O as processIsAlive } from "./s3-config-DDWWMh5x.js";
+import { t as findReviewPackageRoot } from "./package-paths-BsuI4WUf.js";
+import { a as readReviewServerHealth, c as reviewServerStateDir, i as readReviewServerDiscovery, n as desktopOwnsHome, p as desktopUsesHome, r as headlessServerLockPath } from "./server-discovery-CifQ3yQS.js";
+import { t as desktopApplicationInstalled } from "./review-app-launcher-D7I4DGoH.js";
+import { mkdir, open, readFile, realpath, stat } from "node:fs/promises";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { setTimeout } from "node:timers/promises";
+//#region src/server/background-server.ts
+function backgroundServerLogPath(stateDir) {
+	return path.join(stateDir, "review-server", "server.log");
+}
+async function ensureBackgroundServer(input) {
+	const stateDir = path.resolve(input.stateDir);
+	const running = await healthyDiscovery(stateDir);
+	if (running) return {
+		discovery: running,
+		started: false
+	};
+	if (await desktopUsesHome(stateDir, input.env)) throw new Error(desktopOwnsHome(stateDir));
+	const logPath = backgroundServerLogPath(stateDir);
+	await mkdir(path.dirname(logPath), {
+		recursive: true,
+		mode: 448
+	});
+	const logStart = (await stat(logPath).catch(() => null))?.size ?? 0;
+	const deadline = Date.now() + (input.timeoutMs ?? 15e3);
+	let child = await spawnServer(stateDir, logPath, input);
+	let respawned = false;
+	while (Date.now() < deadline) {
+		const discovery = await healthyDiscovery(stateDir);
+		if (discovery) return {
+			discovery,
+			started: discovery.serverPid === child.pid
+		};
+		if (child.error) throw new Error(`Could not start the Whiteboard server: ${child.error.message}`);
+		if (child.exited && await headlessServerOwner(stateDir) === void 0) {
+			if (respawned) break;
+			respawned = true;
+			child = await spawnServer(stateDir, logPath, input);
+		}
+		await setTimeout(100);
+	}
+	const owner = await headlessServerOwner(stateDir);
+	throw new Error(`The Whiteboard server did not become ready${child.exited ? "" : ` within ${Math.round((input.timeoutMs ?? 15e3) / 1e3)} s; process ${child.pid} is still starting`}.${owner !== void 0 && owner !== child.pid ? ` Process ${owner} holds its state directory without answering; \`whiteboard server stop\` ends it.` : ""} The end of ${logPath}:\n${await logTail(logPath, logStart)}`);
+}
+async function ensureServerWithoutDesktop(input) {
+	const { selection, env } = input;
+	if (selection.source !== "fallback" || selection.instances.length !== 0 || selection.problem || (input.desktopInstalled ?? (() => desktopApplicationInstalled({ env })))()) return void 0;
+	const { discovery } = await ensureBackgroundServer({
+		stateDir: reviewServerStateDir(env),
+		env,
+		cli: input.cli
+	});
+	return discovery;
+}
+async function headlessServerOwner(stateDir) {
+	const resolved = await realpath(stateDir).catch(() => path.resolve(stateDir));
+	return liveLockOwner(headlessServerLockPath(resolved));
+}
+async function recordedBackgroundServer(stateDir) {
+	const discovery = await readReviewServerDiscovery(stateDir).catch(() => null);
+	const health = discovery && await readReviewServerHealth(discovery);
+	return discovery && health?.serverPid === discovery.serverPid ? {
+		discovery,
+		health
+	} : void 0;
+}
+async function stopBackgroundServer(discovery, first = "SIGTERM") {
+	const { serverPid } = discovery;
+	for (const [signal, waitMs] of [[first, 1e4], ["SIGKILL", 2e3]]) {
+		try {
+			process.kill(serverPid, signal);
+		} catch (error) {
+			if (error instanceof Error && "code" in error && error.code === "ESRCH") return;
+			throw error;
+		}
+		for (let waited = 0; waited < waitMs; waited += 100) {
+			if (!processIsAlive(serverPid)) return;
+			await setTimeout(100);
+		}
+	}
+	throw new Error(`The Whiteboard server (process ${serverPid}) did not stop.`);
+}
+async function spawnDetached(input) {
+	const log = await open(input.log, "a", 384);
+	const child = spawn(input.command, input.args, {
+		cwd: input.cwd,
+		detached: true,
+		env: input.env,
+		stdio: [
+			"ignore",
+			log.fd,
+			log.fd
+		]
+	});
+	const state = {
+		pid: child.pid,
+		exited: false
+	};
+	child.once("exit", () => state.exited = true);
+	child.once("error", (error) => {
+		state.exited = true;
+		state.error = error;
+	});
+	child.unref();
+	await log.close();
+	return state;
+}
+function spawnServer(stateDir, logPath, input) {
+	const { command, args, env } = cliSpawn(input.cli, input.env ?? process.env);
+	return spawnDetached({
+		command,
+		args: [
+			...args,
+			"server",
+			"start",
+			"--state-dir",
+			stateDir,
+			"--started-by",
+			input.startedBy ?? "cli",
+			...input.args ?? []
+		],
+		cwd: stateDir,
+		env,
+		log: logPath
+	});
+}
+function cliSpawn(cli, env) {
+	const [command, ...args] = cli ?? currentCli();
+	return {
+		command,
+		args,
+		env: args.at(-1)?.endsWith(".ts") && !env.TSX_TSCONFIG_PATH ? {
+			...env,
+			TSX_TSCONFIG_PATH: path.join(findReviewPackageRoot(import.meta.url), "tsconfig.json")
+		} : env
+	};
+}
+function currentCli() {
+	return [
+		process.execPath,
+		...process.execArgv,
+		path.resolve(process.argv[1])
+	];
+}
+async function healthyDiscovery(stateDir) {
+	const discovery = await readReviewServerDiscovery(stateDir).catch(() => null);
+	return discovery && await readReviewServerHealth(discovery) ? discovery : null;
+}
+async function logTail(logPath, from) {
+	return (await readFile(logPath)).subarray(from).toString("utf8").trimEnd().split("\n").slice(-20).join("\n");
+}
+//#endregion
+export { headlessServerOwner as a, stopBackgroundServer as c, ensureServerWithoutDesktop as i, cliSpawn as n, recordedBackgroundServer as o, ensureBackgroundServer as r, spawnDetached as s, backgroundServerLogPath as t };

package/dist/background-server-D2Rrr_e2.js

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

package/dist/build-info.json

@@ -1 +1 @@
-{"version":"0.2.5-preview.20261013.112","commit":"4e32ec3f86a57d0ed72ae2d23f3f45fcc0cfa1eb","dirty":true,"builtAt":"2026-10-13T06:13:17.195Z"}
+{"version":"0.2.5-preview.20261015.115","commit":"fd78e6a852a7f20798854059c5196c661f0df44f","dirty":true,"builtAt":"2026-10-15T00:45:01.986Z"}

package/dist/{cli-C0ziP6hg.js → cli-CSrz_wGk.js}

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