@treeport/treeport 0.5.0 → 0.7.0

package/dist/{update-BW-a6Bd-.js → update-UYS2lMdD.js}

@@ -1,402 +1,12 @@
+import { Ct as projectsResponseSchema, U as decodeUnknownOrNull, ct as healthResponseSchema } from "./dist-BsLn2Gbc.js";
 import fs from "node:fs/promises";
 import path from "node:path";
-import { z } from "zod";
 import { spawn } from "node:child_process";
 import crypto from "node:crypto";
 import fsSync, { constants } from "node:fs";
 import os from "node:os";
+import { z } from "zod";
 import { fileURLToPath, pathToFileURL } from "node:url";
-//#region ../../packages/shared/dist/terminal-protocol.js
-const SOCKET_IO_PATH = "/api/socket.io/";
-const TERMINAL_CONTROLLER_GRACE_MS = 1e4;
-const TERMINAL_OUTPUT_HIGH_WATERMARK = 256 * 1024;
-const TERMINAL_OUTPUT_LOW_WATERMARK = 64 * 1024;
-const TERMINAL_OUTPUT_STALL_TIMEOUT_MS = 3e4;
-const TERMINAL_MAX_CLIENT_MESSAGE_BYTES = 128 * 1024;
-const TERMINAL_MAX_INPUT_BYTES = 64 * 1024;
-const TERMINAL_SCROLL_EXIT_SEQUENCE = "\x1B[9000~";
-const TERMINAL_SELECTION_START_SEQUENCE = "\x1B[9001~";
-const TERMINAL_SELECTION_STOP_SEQUENCE = "\x1B[9002~";
-const TERMINAL_SELECTION_CLEAR_SEQUENCE = "\x1B[9003~";
-const TERMINAL_SELECTION_RESTORE_SEQUENCE = "\x1B[9004~";
-z.unknown();
-const terminalId = z.string().min(1).max(128);
-const clientId = z.string().min(1).max(128);
-const streamId = z.string().min(1).max(128);
-const generation = z.number().int().nonnegative();
-const dimensions = {
-	cols: z.number().int().min(2).max(1e3),
-	rows: z.number().int().min(2).max(500)
-};
-const terminalSizeSchema = z.strictObject(dimensions);
-const terminalProgressSchema = z.strictObject({
-	state: z.enum([
-		"normal",
-		"error",
-		"indeterminate",
-		"paused"
-	]),
-	value: z.number().int().min(0).max(100).nullable()
-});
-const terminalProgramSchema = z.enum([
-	"pi",
-	"claude",
-	"codex"
-]);
-const terminalRuntimeMetadataSchema = z.strictObject({
-	terminalId: z.string().min(1),
-	title: z.string().max(256).nullable(),
-	program: terminalProgramSchema.nullable().default(null),
-	hasForegroundProcess: z.boolean().nullable().optional(),
-	progress: terminalProgressSchema.nullable(),
-	progressStartedAt: z.string().datetime().nullable().default(null),
-	progressClearedAt: z.string().datetime().nullable().default(null),
-	bell: z.strictObject({
-		sequence: z.number().int().positive(),
-		at: z.string().datetime(),
-		unread: z.boolean()
-	}).nullable().default(null)
-});
-const terminalBellAcknowledgementSchema = z.strictObject({ sequence: z.number().int().positive() });
-function parseTerminalProgress(data) {
-	const [command, rawState, rawValue, ...extra] = data.split(";");
-	if (command !== "4" || extra.length > 0 || !/^[0-4]$/.test(rawState ?? "")) return;
-	const state = Number(rawState);
-	if (state === 0) return null;
-	if (rawValue !== void 0 && rawValue !== "" && !/^\d{1,3}$/.test(rawValue)) return;
-	const value = rawValue === void 0 || rawValue === "" ? null : Number(rawValue);
-	if (value !== null && value > 100) return;
-	return {
-		state: [
-			void 0,
-			"normal",
-			"error",
-			"indeterminate",
-			"paused"
-		][state],
-		value
-	};
-}
-const terminalAuthSchema = z.strictObject({
-	terminalId,
-	clientId,
-	...dimensions
-});
-const terminalInputSchema = z.strictObject({
-	generation,
-	data: z.string().max(TERMINAL_MAX_INPUT_BYTES)
-});
-const terminalBinarySchema = z.strictObject({
-	generation,
-	data: z.string().max(TERMINAL_MAX_INPUT_BYTES)
-});
-const terminalResizeSchema = z.strictObject({
-	generation,
-	...dimensions
-});
-const terminalTakeControlSchema = z.strictObject({
-	generation,
-	...dimensions
-});
-const terminalLegacyTakeControlSchema = z.strictObject({ generation });
-const terminalOutputAckSchema = z.strictObject({
-	streamId,
-	sequence: z.number().int().nonnegative()
-});
-const terminalReadyBase = {
-	connectionId: z.string().min(1).max(128),
-	streamId,
-	generation,
-	controller: z.boolean(),
-	reset: z.literal("full")
-};
-const terminalLegacyReadySchema = z.strictObject(terminalReadyBase);
-const terminalReadyV2Schema = z.strictObject({
-	...terminalReadyBase,
-	...dimensions,
-	revision: z.number().int().positive()
-});
-z.union([terminalLegacyReadySchema, terminalReadyV2Schema]);
-z.strictObject({
-	...dimensions,
-	revision: z.number().int().positive()
-});
-z.strictObject({
-	streamId,
-	sequence: z.number().int().positive(),
-	data: z.string()
-});
-z.strictObject({ title: z.string().max(256) });
-z.strictObject({ progress: terminalProgressSchema.nullable() });
-z.strictObject({ viewing: z.boolean() });
-z.strictObject({
-	generation,
-	controller: z.boolean()
-});
-z.strictObject({ exitCode: z.number().int().nullable() });
-z.strictObject({
-	code: z.string().min(1).max(80),
-	message: z.string().min(1).max(1e3),
-	retryable: z.boolean()
-});
-function parseTerminalAuth(value) {
-	const parsed = terminalAuthSchema.safeParse(value);
-	return parsed.success ? parsed.data : null;
-}
-//#endregion
-//#region ../../packages/shared/dist/socket-protocol.js
-const identifierSchema = z.string().min(1).max(128);
-const eventEnvelope = (type, data) => z.strictObject({
-	id: identifierSchema,
-	type: z.literal(type),
-	at: z.string().datetime(),
-	data
-});
-const projectEventDataSchema = z.strictObject({
-	projectId: identifierSchema,
-	worktreeId: z.null()
-});
-const worktreeEventDataSchema = z.strictObject({ worktreeId: identifierSchema });
-const projectWorktreeEventDataSchema = z.strictObject({
-	projectId: identifierSchema,
-	worktreeId: identifierSchema
-});
-const operationEventDataSchema = z.strictObject({
-	operationId: identifierSchema,
-	worktreeId: identifierSchema
-});
-const productEventSchema = z.discriminatedUnion("type", [
-	eventEnvelope("project.created", projectEventDataSchema),
-	eventEnvelope("project.updated", projectEventDataSchema),
-	eventEnvelope("project.removed", projectEventDataSchema),
-	eventEnvelope("worktree.created", projectWorktreeEventDataSchema),
-	eventEnvelope("worktree.updated", worktreeEventDataSchema),
-	eventEnvelope("worktree.removed", projectWorktreeEventDataSchema),
-	eventEnvelope("create.started", z.strictObject({
-		projectId: identifierSchema,
-		operationId: identifierSchema,
-		worktreeId: z.null()
-	})),
-	eventEnvelope("create.completed", z.strictObject({
-		projectId: identifierSchema,
-		operationId: identifierSchema,
-		worktreeId: identifierSchema
-	})),
-	eventEnvelope("create.failed", z.strictObject({
-		projectId: identifierSchema,
-		operationId: identifierSchema,
-		worktreeId: z.null()
-	})),
-	eventEnvelope("terminal.created", z.strictObject({
-		projectId: identifierSchema.optional(),
-		worktreeId: identifierSchema,
-		terminalId: identifierSchema
-	})),
-	eventEnvelope("terminal.updated", z.strictObject({
-		worktreeId: identifierSchema,
-		terminalId: identifierSchema
-	})),
-	eventEnvelope("terminal.removed", z.strictObject({
-		worktreeId: identifierSchema,
-		terminalId: identifierSchema
-	})),
-	eventEnvelope("terminal.metadata", terminalRuntimeMetadataSchema.extend({ worktreeId: z.null() })),
-	eventEnvelope("terminal.controller_changed", z.strictObject({
-		terminalId: identifierSchema,
-		controlled: z.boolean(),
-		worktreeId: z.null()
-	})),
-	eventEnvelope("panel.created", z.strictObject({
-		worktreeId: identifierSchema,
-		panelId: identifierSchema
-	})),
-	eventEnvelope("panel.updated", z.strictObject({
-		worktreeId: identifierSchema,
-		panelId: identifierSchema
-	})),
-	eventEnvelope("panel.open_requested", z.strictObject({
-		worktreeId: identifierSchema,
-		panelId: identifierSchema,
-		sourceTerminalId: identifierSchema.nullable()
-	})),
-	eventEnvelope("panel.removed", z.strictObject({
-		worktreeId: identifierSchema,
-		panelId: identifierSchema
-	})),
-	eventEnvelope("workspace.open_requested", z.strictObject({
-		worktreeId: identifierSchema,
-		sourceTerminalId: identifierSchema
-	})),
-	eventEnvelope("remove.started", operationEventDataSchema.extend({ kind: z.literal("remove") })),
-	eventEnvelope("remove.completed", operationEventDataSchema),
-	eventEnvelope("remove.failed", operationEventDataSchema.extend({ error: z.string() }))
-]);
-const webPanelSnapshotSchema = z.strictObject({
-	id: z.string().min(1),
-	kind: z.literal("web"),
-	worktreeId: z.string().min(1),
-	definitionId: z.string().min(1),
-	title: z.string().min(1),
-	launch: z.strictObject({
-		input: z.record(z.string(), z.json()).nullable(),
-		cwd: z.string().nullable()
-	}),
-	sandbox: z.strictObject({ allowSameOrigin: z.boolean() }),
-	createdAt: z.string(),
-	updatedAt: z.string()
-});
-const eventsSnapshotSchema = z.strictObject({
-	at: z.string().datetime(),
-	terminalMetadata: z.array(terminalRuntimeMetadataSchema),
-	webPanels: z.array(webPanelSnapshotSchema)
-});
-z.unknown();
-function parseEventsSnapshot(value) {
-	const parsed = eventsSnapshotSchema.safeParse(value);
-	return parsed.success ? parsed.data : null;
-}
-function parseProductEvent(value) {
-	const parsed = productEventSchema.safeParse(value);
-	return parsed.success ? parsed.data : null;
-}
-//#endregion
-//#region ../../packages/shared/dist/index.js
-const TERMINAL_MAX_UPLOAD_BYTES = 50 * 1024 * 1024;
-const TERMINAL_EXECUTABLE_MAX_LENGTH = 4096;
-const TERMINAL_ARGUMENT_MAX_LENGTH = 4096;
-const TERMINAL_CAPTURE_MAX_LINES = 5e3;
-const WEB_PANEL_INPUT_MAX_BYTES = 64 * 1024;
-function formatCommandLine(argv) {
-	return argv.map((value) => {
-		if (value === "") return "\"\"";
-		if (!/[\s"'\\]/.test(value)) return value;
-		return `"${value.replace(/["\\]/g, "\\$&")}"`;
-	}).join(" ");
-}
-const PROJECT_COLORS = [
-	"rose",
-	"orange",
-	"amber",
-	"emerald",
-	"cyan",
-	"blue",
-	"violet",
-	"pink"
-];
-const browseDirectoryQuerySchema = z.object({
-	input: z.string().trim().min(1).max(4096),
-	hidden: z.enum(["true", "false"]).optional().default("false").transform((value) => value === "true")
-});
-const terminalCaptureQuerySchema = z.object({ lines: z.coerce.number().int().min(1).max(TERMINAL_CAPTURE_MAX_LINES).optional().default(200) });
-const registerProjectSchema = z.object({
-	path: z.string().trim().min(1),
-	name: z.string().trim().min(1).max(120).optional()
-});
-const updateProjectSchema = z.object({ color: z.enum(PROJECT_COLORS).nullable() });
-const terminalNameSchema = z.string().trim().min(1).max(120);
-const terminalArgvSchema = z.array(z.string()).min(1).max(128);
-const terminalPresetArgumentSchema = z.string().max(TERMINAL_ARGUMENT_MAX_LENGTH);
-const terminalPresetFields = {
-	name: terminalNameSchema,
-	executable: z.string().min(1).max(TERMINAL_EXECUTABLE_MAX_LENGTH).refine((value) => value.trim().length > 0, { message: "Executable cannot be blank" }),
-	args: z.array(terminalPresetArgumentSchema).max(127),
-	closeOnSuccess: z.boolean().default(false)
-};
-const repositoryTerminalPresetSchema = z.strictObject(terminalPresetFields);
-const repositoryTerminalPresetIdSchema = z.string().regex(/^[a-z0-9][a-z0-9._-]{0,119}$/, { message: "Preset IDs must contain only lowercase letters, numbers, dots, underscores, and hyphens" });
-const repositoryTerminalPresetsFileSchema = z.strictObject({
-	version: z.literal(1),
-	presets: z.record(repositoryTerminalPresetIdSchema, z.unknown())
-});
-const terminalPresetRevisionSchema = z.string().min(1).max(64);
-const initialTerminalSchema = z.object({
-	name: terminalNameSchema,
-	argv: terminalArgvSchema.optional(),
-	returnToShell: z.boolean().optional(),
-	initialSize: terminalSizeSchema.optional()
-});
-const createWorktreeSchema = z.object({
-	name: z.string().trim().min(1).max(120),
-	base: z.enum(["default", "current"]).default("default"),
-	sourceWorktreeId: z.string().min(1).optional(),
-	initialTerminal: initialTerminalSchema.optional()
-}).superRefine((value, context) => {
-	if (value.base === "current" && !value.sourceWorktreeId) context.addIssue({
-		code: "custom",
-		path: ["sourceWorktreeId"],
-		message: "A source tree is required when starting from current"
-	});
-});
-const terminalCwdSchema = z.string().min(1).max(4096).refine((value) => value.trim().length > 0 && !value.includes("\0"), { message: "Working directory cannot be blank or contain NUL" });
-const terminalEnvironmentKeySchema = z.string().min(1).max(256).refine((value) => !value.includes("=") && !value.includes("\0"), { message: "Environment keys cannot contain equals or NUL" });
-const terminalShellCommandSchema = z.string().min(1).max(TERMINAL_ARGUMENT_MAX_LENGTH).refine((value) => value.trim().length > 0 && !value.includes("\0"), { message: "Shell command cannot be blank or contain NUL" });
-const terminalEnvironmentSchema = z.record(terminalEnvironmentKeySchema, z.string().max(TERMINAL_ARGUMENT_MAX_LENGTH).refine((value) => !value.includes("\0"), { message: "Environment values cannot contain NUL" })).refine((value) => Object.keys(value).length <= 128, { message: "Environment cannot contain more than 128 variables" });
-const createTerminalSchema = z.object({
-	name: terminalNameSchema,
-	argv: terminalArgvSchema.optional(),
-	shellCommand: terminalShellCommandSchema.optional(),
-	cwd: terminalCwdSchema.optional(),
-	env: terminalEnvironmentSchema.optional(),
-	returnToShell: z.boolean().optional(),
-	closeOnSuccess: z.boolean().optional(),
-	initialSize: terminalSizeSchema.optional()
-}).refine((value) => !(value.argv && value.shellCommand), { message: "A terminal cannot have both argv and a shell command" }).refine((value) => !(value.returnToShell && value.closeOnSuccess), { message: "A terminal cannot return to a shell and close on success" });
-const updateTerminalSchema = z.object({ name: terminalNameSchema });
-const webPanelInputSchema = z.record(z.string(), z.json());
-const createWebPanelSchema = z.object({
-	definitionId: z.string().min(1).max(256),
-	input: webPanelInputSchema.nullable().optional(),
-	launchCwd: z.string().max(4096).nullable().optional()
-});
-const openWebPanelSchema = createWebPanelSchema.extend({
-	newInstance: z.boolean().optional(),
-	sourceTerminalId: z.string().min(1).max(128).nullable().optional()
-});
-const requestWorkspaceOpenSchema = z.object({ sourceTerminalId: z.string().min(1).max(128) });
-const webPanelStorageKeySchema = z.string().min(1).max(128);
-const getWebPanelStorageSchema = z.object({ key: webPanelStorageKeySchema });
-const setWebPanelStorageSchema = z.object({
-	key: webPanelStorageKeySchema,
-	value: z.json()
-});
-const deleteWebPanelStorageSchema = z.object({ key: webPanelStorageKeySchema });
-const createTerminalPresetSchema = z.object(terminalPresetFields);
-const updateTerminalPresetSchema = z.object({
-	...terminalPresetFields,
-	closeOnSuccess: z.boolean().optional(),
-	expectedUpdatedAt: terminalPresetRevisionSchema
-});
-const deleteTerminalPresetSchema = z.object({ expectedUpdatedAt: terminalPresetRevisionSchema });
-const packageProjectQuerySchema = z.object({ path: z.string().trim().min(1).max(4096) });
-const packageInstallSchema = z.object({
-	source: z.string().trim().min(1).max(4096),
-	projectId: z.string().min(1).optional()
-});
-const packageRemoveSchema = z.object({
-	source: z.string().trim().min(1).max(4096),
-	projectId: z.string().min(1).optional()
-});
-const packageUpdateSchema = z.object({ source: z.string().trim().min(1).max(4096).optional() });
-const packageReloadSchema = z.object({ projectId: z.string().min(1).optional() });
-const removeWorktreeSchema = z.object({
-	confirmationToken: z.string().length(64),
-	confirmDestructive: z.boolean()
-});
-z.object({
-	project: z.string().min(1),
-	worktreeName: z.string().trim().min(1).max(120),
-	name: terminalNameSchema,
-	argv: terminalArgvSchema.optional(),
-	base: z.enum(["default", "current"]).default("default"),
-	sourceWorktreeId: z.string().min(1).optional()
-}).superRefine((value, context) => {
-	if (value.base === "current" && !value.sourceWorktreeId) context.addIssue({
-		code: "custom",
-		path: ["sourceWorktreeId"],
-		message: "A source tree is required when starting from current"
-	});
-});
-//#endregion
 //#region src/duration.ts
 const DURATION_UNITS = /* @__PURE__ */ new Map([
 	["ms", 1],
@@ -477,21 +87,6 @@ const daemonRecordSchema = z.strictObject({
 		"external"
 	])
 });
-const healthRecordSchema = z.strictObject({
-	ok: z.literal(true),
-	version: z.string(),
-	protocolVersion: z.number(),
-	hostname: z.string().optional(),
-	pid: z.number(),
-	instanceId: z.string().nullable(),
-	installationMethod: z.string(),
-	daemonLifecycle: z.enum([
-		"treeport",
-		"service",
-		"external"
-	]),
-	url: z.string()
-});
 async function preferences(env = process.env) {
 	return await readJson$1(localPaths(env).preferencesPath, preferencesSchema) ?? {};
 }
@@ -542,15 +137,18 @@ async function daemonHealth(apiUrl, timeoutMs = 1500) {
 	const signal = AbortSignal.timeout(timeoutMs);
 	return fetch(`${apiUrl}/api/health`, { signal }).then(async (response) => {
 		if (!response.ok) return null;
-		const result = healthRecordSchema.safeParse(await response.json());
-		return result.success ? result.data : null;
+		return decodeUnknownOrNull(healthResponseSchema, await response.json());
 	}).catch(() => null);
 }
 function matchesOwnership(state, observed) {
 	return observed.pid === state.pid && observed.instanceId === state.instanceId && path.resolve(state.dataDir) === localPaths().dataDir;
 }
 async function readState() {
-	return readJson$1(localPaths().statePath, daemonRecordSchema);
+	const paths = localPaths();
+	return await fs.readFile(paths.lockPath, "utf8").then((value) => daemonRecordSchema.parse(JSON.parse(value))).catch((error) => {
+		if (error.code === "ENOENT") return null;
+		throw new Error(`Cannot verify daemon ownership at ${paths.lockPath}. Inspect the daemon log before starting or stopping Treeport.`, { cause: error });
+	}) ?? readJson$1(paths.statePath, daemonRecordSchema);
 }
 async function removeStaleState(state) {
 	const paths = localPaths();
@@ -764,11 +362,7 @@ async function disableTailscaleRemote() {
 }
 async function runDoctor() {
 	const paths = localPaths();
-	const gitPath = process.env.TREEPORT_GIT_PATH?.trim() || "git";
-	const tmuxPath = process.env.TREEPORT_TMUX_PATH?.trim() || "tmux";
-	const [git, tmux] = await Promise.all([executableCheck(gitPath, ["--version"]), executableCheck(tmuxPath, ["-V"])]);
-	const tmuxMatch = /tmux\s+(\d+)\.(\d+)/i.exec(tmux.detail);
-	const tmuxSupported = Boolean(tmux.ok && tmuxMatch && (Number(tmuxMatch[1]) > 3 || Number(tmuxMatch[1]) === 3 && Number(tmuxMatch[2]) >= 2));
+	const git = await executableCheck(process.env.TREEPORT_GIT_PATH?.trim() || "git", ["--version"]);
 	const checkDirectory = (directoryPath) => fs.mkdir(directoryPath, {
 		recursive: true,
 		mode: 448
@@ -790,11 +384,6 @@ async function runDoctor() {
 			name: "Git",
 			...git
 		},
-		{
-			name: "tmux",
-			ok: tmuxSupported,
-			detail: tmuxSupported ? tmux.detail : `${tmux.detail}. Treeport requires tmux 3.2 or newer.`
-		},
 		{
 			name: "Data directory",
 			...dataDirectory
@@ -1274,7 +863,6 @@ function createServiceEnvironment(input) {
 		TREEPORT_CACHE_DIR: cacheDirectory(input.user.homedir, env),
 		TREEPORT_DATABASE_PATH: env.TREEPORT_DATABASE_PATH?.trim() || path.join(input.paths.dataDir, "treeport.db"),
 		TREEPORT_SHELL: env.TREEPORT_SHELL?.trim() || env.SHELL?.trim() || "/bin/sh",
-		TREEPORT_TMUX_PATH: env.TREEPORT_TMUX_PATH?.trim() || "tmux",
 		TREEPORT_GIT_PATH: env.TREEPORT_GIT_PATH?.trim() || "git",
 		TREEPORT_GH_PATH: env.TREEPORT_GH_PATH?.trim() || "gh",
 		TREEPORT_DAEMON_LIFECYCLE: "service",
@@ -2238,16 +1826,18 @@ async function createUpdateStartupReporter(config) {
 	const paths = updatePaths(config.dataDir);
 	const pending = await fs.readFile(paths.pending, "utf8").then((value) => pendingSchema.safeParse(JSON.parse(value))).then((result) => result.success ? result.data : null).catch(() => null);
 	const active = pending && pending.targetVersion === config.appVersion ? pending : null;
+	const previous = await readUpdateStartupReport(config.dataDir);
+	const previousState = active && previous?.operationId === active.operationId && previous.targetVersion === active.targetVersion ? previous.migrationState : "unknown";
 	const report = active ? {
 		schemaVersion: 1,
 		operationId: active.operationId,
 		targetVersion: active.targetVersion,
 		instanceId: config.instanceId ?? null,
-		migrationState: "not_started",
+		migrationState: previousState,
 		ready: false,
 		error: null,
 		logPath: path.join(config.dataDir, "logs", "daemon.log"),
-		snapshotPaths: [],
+		snapshotPaths: previous?.operationId === active.operationId && previous.targetVersion === active.targetVersion ? previous.snapshotPaths : [],
 		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
 	} : null;
 	const save = async () => {
@@ -2259,14 +1849,20 @@ async function createUpdateStartupReporter(config) {
 	return {
 		async databaseOpening() {
 			if (report) {
-				report.migrationState = "unknown";
+				report.migrationState = previousState === "advanced" ? "advanced" : "unknown";
+				await save();
+			}
+		},
+		async snapshotCreated(snapshotPath) {
+			if (report) {
+				report.snapshotPaths = [.../* @__PURE__ */ new Set([...report.snapshotPaths, snapshotPath])];
 				await save();
 			}
 		},
 		async databaseOpened(input) {
 			if (report) {
-				report.migrationState = input.migrationState;
-				report.snapshotPaths = input.snapshotPaths;
+				report.migrationState = previousState === "advanced" || input.migrationState === "advanced" ? "advanced" : previousState === "unknown" ? "unknown" : "unchanged";
+				report.snapshotPaths = [.../* @__PURE__ */ new Set([...report.snapshotPaths, ...input.snapshotPaths])];
 				await save();
 			}
 		},
@@ -2378,6 +1974,15 @@ const packedReleaseSchema = z.tuple([z.looseObject({
 	filename: z.string().min(1),
 	integrity: z.string().min(1)
 })]);
+function formatLocalUpdateError(message, details = {}) {
+	return [...new Set([
+		message,
+		details.cause,
+		details.recovery,
+		details.logPath ? `Daemon log: ${details.logPath}` : null,
+		...(details.snapshotPaths ?? []).map((snapshot) => `Pre-migration snapshot: ${snapshot}`)
+	].filter(Boolean))].join("\n");
+}
 var LocalUpdateError = class extends Error {
 	code;
 	details;
@@ -2498,10 +2103,24 @@ async function replaceSymlink(linkPath, target) {
 	await fs.rename(temporaryPath, linkPath);
 }
 async function terminalIds(apiUrl) {
-	const result = await fetch(`${apiUrl}/api/projects`).then(async (response) => response.ok ? response.json() : null).catch(() => null);
-	const parsed = z.looseObject({ projects: z.array(z.looseObject({ worktrees: z.array(z.looseObject({ terminals: z.array(z.looseObject({ id: z.string() })) })) })) }).safeParse(result);
-	if (!parsed.success) throw new Error("Treeport could not read the terminal inventory.");
-	return parsed.data.projects.flatMap((project) => project.worktrees).flatMap((worktree) => worktree.terminals).map((terminal) => terminal.id).sort();
+	const parsed = decodeUnknownOrNull(projectsResponseSchema, await fetch(`${apiUrl}/api/projects`).then(async (response) => response.ok ? response.json() : null).catch(() => null));
+	if (!parsed) throw new Error("Treeport could not read the terminal inventory.");
+	return parsed.projects.flatMap((project) => project.worktrees).flatMap((worktree) => worktree.terminals).map((terminal) => terminal.id).sort();
+}
+function updateMigrationState(operation, report) {
+	if (operation.migrationState === "advanced") return "advanced";
+	if (report?.operationId === operation.operationId && report.targetVersion === operation.toVersion) return report.migrationState;
+	return ["stop", "activate"].includes(operation.phase) && operation.migrationState === "not_started" ? "not_started" : "unknown";
+}
+async function stopUpdateDaemon(lifecycle) {
+	if (lifecycle === "service") {
+		if ((await serviceStop()).administratorCommand) throw new LocalUpdateError("UPDATE_SERVICE_ADMINISTRATOR_ACTION_REQUIRED", "The service requires administrator action and was not stopped.", { phase: "stop" });
+		const deadline = Date.now() + 7e3;
+		while ((await daemonStatus()).state) {
+			if (Date.now() >= deadline) throw new Error("Treeport could not verify that the service daemon stopped. Inspect the daemon log before changing the installed version.");
+			await new Promise((resolve) => setTimeout(resolve, 100));
+		}
+	} else await daemonDown();
 }
 async function startThroughStableEntrypoint(entrypoint, environment) {
 	const result = await runCommand(entrypoint, ["start", "--json"], environment);
@@ -2673,6 +2292,7 @@ async function runLocalUpdate(options = {}) {
 		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
 	};
 	let recoveryOperation = null;
+	let recoveryReport = null;
 	const save = async (phase) => {
 		operation = {
 			...operation,
@@ -2692,12 +2312,17 @@ async function runLocalUpdate(options = {}) {
 			activeTarget: installation.managed ? await fs.realpath(installation.currentLink).catch(() => installation.prefix) : installation.prefix
 		};
 		if (staleOperation && staleOperation.daemonWasRunning && DESTRUCTIVE_PHASES.has(staleOperation.phase) && !(await daemonStatus()).running) {
+			await stopUpdateDaemon(staleOperation.daemonLifecycle);
 			const staleReport = await readUpdateStartupReport(paths.dataDir);
-			if (Boolean(staleReport?.operationId === staleOperation.operationId && ["advanced", "unknown"].includes(staleReport.migrationState))) {
+			staleOperation.migrationState = updateMigrationState(staleOperation, staleReport);
+			if (["advanced", "unknown"].includes(staleOperation.migrationState)) {
+				recoveryReport = staleReport?.operationId === staleOperation.operationId && staleReport.targetVersion === staleOperation.toVersion ? staleReport : null;
 				if (staleOperation.previousTarget && operation.activeTarget === staleOperation.previousTarget) throw new LocalUpdateError("UPDATE_RECOVERY_REQUIRED", "The older Treeport version is active after a database migration may have started. Treeport will not start it.", {
 					phase: "recovery_required",
 					operationId: staleOperation.operationId,
-					migrationState: staleReport?.migrationState ?? "unknown",
+					migrationState: staleOperation.migrationState,
+					logPath: recoveryReport?.logPath ?? paths.logPath,
+					snapshotPaths: recoveryReport?.snapshotPaths ?? [],
 					recovery: "Install the same or a newer Treeport release and inspect the daemon log."
 				});
 				recoveryOperation = staleOperation;
@@ -2779,6 +2404,8 @@ async function runLocalUpdate(options = {}) {
 			phase: "recovery_required",
 			operationId: recoveryOperation.operationId,
 			migrationState: recoveryOperation.migrationState,
+			logPath: recoveryReport?.logPath ?? paths.logPath,
+			snapshotPaths: recoveryReport?.snapshotPaths ?? [],
 			recovery: "Install the next Treeport release when it is available and run `treeport update` again."
 		});
 		if (comparison === 0) {
@@ -2920,6 +2547,7 @@ async function runLocalUpdate(options = {}) {
 			phase: "verify",
 			operationId
 		});
+		operation.migrationState = recoveryOperation?.migrationState ?? "not_started";
 		operation.daemonWasRunning = daemonBefore.running && daemonBefore.verified || recoveryOperation !== null;
 		operation.daemonLifecycle = recoveryOperation ? recoveryOperation.daemonLifecycle : operation.daemonWasRunning ? daemonBefore.health?.daemonLifecycle === "service" ? "service" : "treeport" : installedService ? "service" : "treeport";
 		operation.serviceMode = recoveryOperation?.serviceMode ?? serviceBefore?.mode ?? null;
@@ -2930,12 +2558,7 @@ async function runLocalUpdate(options = {}) {
 		});
 		await save("stop");
 		progress("Stopping the Treeport daemon and preserving terminals…");
-		if (operation.daemonWasRunning) if (operation.daemonLifecycle === "service") {
-			if ((await serviceStop()).administratorCommand) throw new LocalUpdateError("UPDATE_SERVICE_ADMINISTRATOR_ACTION_REQUIRED", "The service requires administrator action and was not stopped.", {
-				phase: "stop",
-				operationId
-			});
-		} else await daemonDown();
+		if (operation.daemonWasRunning) await stopUpdateDaemon(operation.daemonLifecycle);
 		await save("activate");
 		progress(`Activating Treeport ${release.version}…`);
 		await fs.rm(targetPath, {
@@ -2966,7 +2589,19 @@ async function runLocalUpdate(options = {}) {
 				targetVersion: release.version,
 				createdAt: (/* @__PURE__ */ new Date()).toISOString()
 			});
-			await fs.rm(path.join(updateDirectory, "startup-report.json"), { force: true });
+			await writeJson(path.join(updateDirectory, "startup-report.json"), {
+				schemaVersion: 1,
+				operationId,
+				targetVersion: release.version,
+				instanceId: null,
+				migrationState: operation.migrationState,
+				ready: false,
+				error: null,
+				logPath: paths.logPath,
+				snapshotPaths: recoveryReport?.snapshotPaths ?? [],
+				updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+			});
+			operation.migrationState = operation.migrationState === "advanced" ? "advanced" : "unknown";
 			await save("restart");
 			progress(`Restarting the ${operation.daemonLifecycle === "service" ? "Treeport service" : "Treeport daemon"}…`);
 			await startThroughStableEntrypoint(installation.entrypoint, environment);
@@ -2979,7 +2614,7 @@ async function runLocalUpdate(options = {}) {
 				daemonAfter = await daemonStatus();
 				report = await readUpdateStartupReport(paths.dataDir);
 			}
-			operation.migrationState = report?.operationId === operationId ? report.migrationState : "unknown";
+			operation.migrationState = updateMigrationState(operation, report);
 			if (!daemonAfter.running || !daemonAfter.verified || daemonAfter.health?.version !== release.version || daemonAfter.health.daemonLifecycle !== operation.daemonLifecycle || path.resolve(daemonAfter.state.dataDir) !== paths.dataDir || report?.operationId !== operationId || !report.ready) throw new LocalUpdateError("UPDATE_HEALTH_VERIFICATION_FAILED", `Treeport ${release.version} did not pass startup verification.`, {
 				phase: "health_check",
 				operationId
@@ -3042,13 +2677,14 @@ async function runLocalUpdate(options = {}) {
 				toVersion: operation.toVersion
 			});
 		}
-		const startupReport = await readUpdateStartupReport(paths.dataDir);
-		if (startupReport?.operationId === operationId) operation.migrationState = startupReport.migrationState;
-		if (!["not_started", "unchanged"].includes(operation.migrationState)) {
-			const serviceStopError = operation.daemonLifecycle === "service" ? await serviceStop().then(() => null, (cause) => cause instanceof Error ? cause.message : String(cause)) : null;
-			operation.recoveryAction = serviceStopError ? `Keep the new version installed. Stop the service, then inspect the daemon log. Service stop failed: ${serviceStopError}` : "Keep the new version installed. Inspect the daemon log and repair with the same or a newer Treeport release.";
+		const stopError = operation.daemonWasRunning ? await stopUpdateDaemon(operation.daemonLifecycle).then(() => null, (cause) => cause instanceof Error ? cause.message : String(cause)) : null;
+		const observedReport = await readUpdateStartupReport(paths.dataDir);
+		const startupReport = observedReport?.operationId === operationId && observedReport.targetVersion === operation.toVersion ? observedReport : null;
+		operation.migrationState = updateMigrationState(operation, startupReport);
+		if (!(!stopError && ["not_started", "unchanged"].includes(operation.migrationState))) {
+			operation.recoveryAction = stopError ? `Keep the new version installed. Stop the daemon, then inspect the daemon log. Stop failed: ${stopError}` : "Keep the new version installed. Inspect the daemon log and repair with the same or a newer Treeport release.";
 			await save("recovery_required");
-			throw new LocalUpdateError("UPDATE_RECOVERY_REQUIRED", "The updated daemon did not become healthy after database migration began. Treeport did not start the older daemon.", {
+			throw new LocalUpdateError("UPDATE_RECOVERY_REQUIRED", "Treeport could not prove that rollback is safe. Treeport did not start the older daemon.", {
 				operationId,
 				phase: failedPhase,
 				fromVersion: operation.fromVersion,
@@ -3059,6 +2695,7 @@ async function runLocalUpdate(options = {}) {
 					safe: false,
 					succeeded: false
 				},
+				cause: startupReport?.error ?? (error instanceof Error ? error.message : String(error)),
 				logPath: startupReport?.logPath ?? paths.logPath,
 				snapshotPaths: startupReport?.snapshotPaths ?? [],
 				recovery: operation.recoveryAction
@@ -3087,6 +2724,8 @@ async function runLocalUpdate(options = {}) {
 				succeeded: rollbackError === null
 			},
 			cause: error instanceof Error ? error.message : String(error),
+			logPath: startupReport?.logPath ?? paths.logPath,
+			snapshotPaths: startupReport?.snapshotPaths ?? [],
 			recovery: operation.recoveryAction
 		});
 	} finally {
@@ -3104,4 +2743,4 @@ async function runLocalUpdate(options = {}) {
 	}
 }
 //#endregion
-export { repositoryTerminalPresetSchema as $, treeportVersion as A, terminalSizeSchema as At, createWorktreeSchema as B, disableTailscaleRemote as C, parseTerminalProgress as Ct, resolvePackagePath as D, terminalLegacyTakeControlSchema as Dt, resolveLocalApiUrl as E, terminalInputSchema as Et, WEB_PANEL_INPUT_MAX_BYTES as F, openWebPanelSchema as G, deleteWebPanelStorageSchema as H, browseDirectoryQuerySchema as I, packageReloadSchema as J, packageInstallSchema as K, createTerminalPresetSchema as L, parseDurationMs as M, TERMINAL_CAPTURE_MAX_LINES as N, runDoctor as O, terminalOutputAckSchema as Ot, TERMINAL_MAX_UPLOAD_BYTES as P, removeWorktreeSchema as Q, createTerminalSchema as R, daemonUp as S, parseTerminalAuth as St, readDaemonLogs as T, terminalBinarySchema as Tt, formatCommandLine as U, deleteTerminalPresetSchema as V, getWebPanelStorageSchema as W, packageUpdateSchema as X, packageRemoveSchema as Y, registerProjectSchema as Z, serviceStatus as _, TERMINAL_SCROLL_EXIT_SEQUENCE as _t, readLocalUpdateProgress as a, updateTerminalPresetSchema as at, daemonHealth as b, TERMINAL_SELECTION_START_SEQUENCE as bt, createUpdateStartupReporter as c, parseEventsSnapshot as ct, serviceDisable as d, TERMINAL_CONTROLLER_GRACE_MS as dt, repositoryTerminalPresetsFileSchema as et, serviceDoctorCheck as f, TERMINAL_MAX_CLIENT_MESSAGE_BYTES as ft, serviceStart as g, TERMINAL_OUTPUT_STALL_TIMEOUT_MS as gt, serviceRun as h, TERMINAL_OUTPUT_LOW_WATERMARK as ht, isCanonicalTreeportVersion as i, updateProjectSchema as it, assertLoopbackHost as j, terminalTakeControlSchema as jt, tailscaleRemoteStatus as k, terminalResizeSchema as kt, readServiceLogs as l, parseProductEvent as lt, serviceInstalled as m, TERMINAL_OUTPUT_HIGH_WATERMARK as mt, compareTreeportVersions as n, setWebPanelStorageSchema as nt, resolveLatestTreeportRelease as o, updateTerminalSchema as ot, serviceEnable as p, TERMINAL_MAX_INPUT_BYTES as pt, packageProjectQuerySchema as q, inspectLocalUpdateInstallation as r, terminalCaptureQuerySchema as rt, runLocalUpdate as s, webPanelInputSchema as st, LocalUpdateError as t, requestWorkspaceOpenSchema as tt, serviceApply as u, SOCKET_IO_PATH as ut, serviceStop as v, TERMINAL_SELECTION_CLEAR_SEQUENCE as vt, enableTailscaleRemote as w, terminalBellAcknowledgementSchema as wt, daemonStatus as x, TERMINAL_SELECTION_STOP_SEQUENCE as xt, daemonDown as y, TERMINAL_SELECTION_RESTORE_SEQUENCE as yt, createWebPanelSchema as z };
+export { tailscaleRemoteStatus as A, daemonUp as C, resolveLocalApiUrl as D, readDaemonLogs as E, assertLoopbackHost as M, parseDurationMs as N, resolvePackagePath as O, daemonStatus as S, enableTailscaleRemote as T, serviceStart as _, isCanonicalTreeportVersion as a, daemonDown as b, runLocalUpdate as c, serviceApply as d, serviceDisable as f, serviceRun as g, serviceInstalled as h, inspectLocalUpdateInstallation as i, treeportVersion as j, runDoctor as k, createUpdateStartupReporter as l, serviceEnable as m, compareTreeportVersions as n, readLocalUpdateProgress as o, serviceDoctorCheck as p, formatLocalUpdateError as r, resolveLatestTreeportRelease as s, LocalUpdateError as t, readServiceLogs as u, serviceStatus as v, disableTailscaleRemote as w, daemonHealth as x, serviceStop as y };