@overdeck/desktop 0.45.10 → 0.45.12

package/server/system-prerequisites-BsI9hxh9.js

@@ -0,0 +1,166 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+//#region ../../lib/system-prerequisites.ts
+/**
+* Host prerequisite detection for the dashboard setup checklist (PAN-774).
+*
+* Overdeck drives host tools — tmux sessions, the Claude Code CLI, git — that
+* no install flavor bundles (the desktop app ships only the dashboard). The
+* checks run from the SERVER process, so what they see on PATH is exactly what
+* spawned agents and conversations will see; a tool missing here is a tool
+* whose spawn will fail. Served by GET /api/prerequisites and rendered by the
+* frontend SetupChecklistBanner.
+*
+* Detection runs `<cmd> <versionArg>` directly (ENOENT = not installed),
+* which both proves the tool is executable and captures its version in one
+* probe. Install hints are copyable commands, not actions — installing system
+* packages needs sudo/user consent, so Overdeck never runs them itself.
+*/
+const execFileAsync = promisify(execFile);
+const PREREQUISITES = [
+	{
+		id: "tmux",
+		name: "tmux",
+		required: true,
+		purpose: "Hosts every agent and conversation terminal session",
+		versionArgs: ["-V"],
+		install: {
+			linux: "sudo apt install tmux",
+			mac: "brew install tmux",
+			win: "Use WSL2 — inside your distro: sudo apt install tmux"
+		}
+	},
+	{
+		id: "git",
+		name: "git",
+		required: true,
+		purpose: "Projects, workspaces, and branch operations",
+		versionArgs: ["--version"],
+		install: {
+			linux: "sudo apt install git",
+			mac: "xcode-select --install",
+			win: "winget install Git.Git"
+		}
+	},
+	{
+		id: "node",
+		name: "Node.js",
+		required: true,
+		purpose: "Runs the Claude Code CLI and the PTY supervisor",
+		versionArgs: ["--version"],
+		install: {
+			linux: "Install Node 22+ from https://nodejs.org (or via nvm)",
+			mac: "brew install node@22",
+			win: "winget install OpenJS.NodeJS.LTS"
+		}
+	},
+	{
+		id: "claude",
+		name: "Claude Code",
+		required: true,
+		purpose: "The default agent harness — conversations and work agents run it",
+		versionArgs: ["--version"],
+		install: {
+			linux: "curl -fsSL https://claude.ai/install.sh | bash",
+			mac: "curl -fsSL https://claude.ai/install.sh | bash",
+			win: "npm install -g @anthropic-ai/claude-code"
+		}
+	},
+	{
+		id: "gh",
+		name: "GitHub CLI",
+		required: false,
+		purpose: "GitHub issue tracking and PR/CI status integration",
+		versionArgs: ["--version"],
+		install: {
+			linux: "sudo apt install gh",
+			mac: "brew install gh",
+			win: "winget install GitHub.cli"
+		}
+	},
+	{
+		id: "bd",
+		name: "beads",
+		required: false,
+		purpose: "Git-backed issue tracking used by the work pipeline",
+		versionArgs: ["--version"],
+		install: {
+			linux: "curl -sSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash",
+			mac: "brew install gastownhall/beads/bd",
+			win: "Use WSL2 — inside your distro, run the beads install script"
+		}
+	},
+	{
+		id: "bun",
+		name: "Bun",
+		required: false,
+		purpose: "Workspace installs for Bun-based projects (bun.lock / package_manager: bun)",
+		versionArgs: ["--version"],
+		install: {
+			linux: "curl -fsSL https://bun.sh/install | bash",
+			mac: "curl -fsSL https://bun.sh/install | bash",
+			win: "powershell -c \"irm bun.sh/install.ps1 | iex\""
+		}
+	},
+	{
+		id: "docker",
+		name: "Docker",
+		required: false,
+		purpose: "Isolated workspace containers and the overdeck.localhost HTTPS proxy (Traefik)",
+		versionArgs: ["--version"],
+		install: {
+			linux: "https://docs.docker.com/engine/install/",
+			mac: "Install Docker Desktop — https://docker.com/products/docker-desktop",
+			win: "Install Docker Desktop — https://docker.com/products/docker-desktop"
+		}
+	},
+	{
+		id: "codex",
+		name: "Codex CLI",
+		required: false,
+		purpose: "OpenAI Codex harness — needed only for GPT-model agents",
+		versionArgs: ["--version"],
+		install: {
+			linux: "npm install -g @openai/codex",
+			mac: "npm install -g @openai/codex",
+			win: "npm install -g @openai/codex"
+		}
+	}
+];
+const defaultProbe = async (cmd, args) => {
+	const { stdout } = await execFileAsync(cmd, args, {
+		encoding: "utf-8",
+		timeout: 1e4
+	});
+	return stdout;
+};
+function firstLine(output) {
+	return output.split("\n")[0]?.trim() || null;
+}
+async function checkSystemPrerequisites(probe = defaultProbe) {
+	const checks = await Promise.all(PREREQUISITES.map(async ({ versionArgs, ...definition }) => {
+		try {
+			const output = await probe(definition.id, versionArgs);
+			return {
+				...definition,
+				found: true,
+				version: firstLine(output)
+			};
+		} catch {
+			return {
+				...definition,
+				found: false,
+				version: null
+			};
+		}
+	}));
+	return {
+		platform: process.platform,
+		allRequiredFound: checks.every((check) => check.found || !check.required),
+		checks
+	};
+}
+//#endregion
+export { checkSystemPrerequisites };
+
+//# sourceMappingURL=system-prerequisites-BsI9hxh9.js.map

package/server/{teardown-workspace-5LCVbjfq.js → teardown-workspace-CWz1pbEK.js}

@@ -1,8 +1,8 @@
-import { Vr as init_paths, yr as AGENTS_DIR } from "./config-yaml-DPAieL_G.js";
-import { L as sessionExists, O as listSessionNames, w as killSession, x as init_tmux } from "./tmux-ePNhMIMU.js";
-import { n as getContainersReferencingWorkspacePath, r as init_workspace_manager } from "./workspace-manager-CEWK-OXd.js";
-import { r as init_devcontainer_renderer, t as DEVCONTAINER_DIRNAME } from "./devcontainer-renderer-DUJYYRQB.js";
-import { i as findWorkspacePath, o as init_archive_planning, r as findAllWorkspacePaths } from "./archive-planning-zTvWWHG_.js";
+import { Vr as init_paths, yr as AGENTS_DIR } from "./config-yaml-ClpGgrf6.js";
+import { L as sessionExists, O as listSessionNames, w as killSession, x as init_tmux } from "./tmux-D57f-XNv.js";
+import { n as getContainersReferencingWorkspacePath, r as init_workspace_manager } from "./workspace-manager-BJhW2sky.js";
+import { r as init_devcontainer_renderer, t as DEVCONTAINER_DIRNAME } from "./devcontainer-renderer-CaYOG9JN.js";
+import { i as findWorkspacePath, o as init_archive_planning, r as findAllWorkspacePaths } from "./archive-planning-oX1pj6nY.js";
 import { a as stepSkipped, i as stepOk, n as init_types, r as stepFailed } from "./types-B5u3NxMl.js";
 import { Effect } from "effect";
 import { existsSync } from "fs";
@@ -83,7 +83,7 @@ async function stopTldrDaemonImpl(workspacePath) {
 	const venvPath = join(workspacePath, ".venv");
 	if (!existsSync(venvPath)) return stepSkipped(step, ["No .venv found"]);
 	try {
-		const { getTldrDaemonServiceSync } = await import("./tldr-daemon-CJqGsDFh.js");
+		const { getTldrDaemonServiceSync } = await import("./tldr-daemon-Big5IZ_M.js");
 		await getTldrDaemonServiceSync(workspacePath, venvPath).stop();
 		return stepOk(step, ["Stopped TLDR daemon"]);
 	} catch {
@@ -102,7 +102,7 @@ function stopDocker(workspacePath, issueLower) {
 async function stopDockerImpl(workspacePath, issueLower) {
 	const step = "teardown:docker";
 	try {
-		const { stopWorkspaceDocker } = await import("./workspace-manager-B3PqQQSM.js");
+		const { stopWorkspaceDocker } = await import("./workspace-manager-Cb2a7bg9.js");
 		await Effect.runPromise(stopWorkspaceDocker(workspacePath, issueLower));
 		return stepOk(step, ["Stopped Docker containers"]);
 	} catch {
@@ -496,7 +496,7 @@ function clearShadowState(issueId) {
 async function clearShadowStateImpl(issueId) {
 	const step = "teardown:shadow-state";
 	try {
-		const { removeShadowState } = await import("./shadow-state-BOaq8BrD.js");
+		const { removeShadowState } = await import("./shadow-state-1aS8FijU.js");
 		if (removeShadowState(issueId).success) return stepOk(step, [`Cleared shadow state for ${issueId}`]);
 		return stepSkipped(step, ["No shadow state found"]);
 	} catch {
@@ -546,7 +546,7 @@ function buildPlaceholders(ctx, opts, workspacePath) {
 function removeTunnelConfig(tunnelConfig, placeholders) {
 	return Effect.tryPromise({
 		try: async () => {
-			const { removeTunnelIngress } = await import("./tunnel-AporWhoi.js");
+			const { removeTunnelIngress } = await import("./tunnel-hOBNQbmF.js");
 			return stepOk("teardown:tunnel", (await Effect.runPromise(removeTunnelIngress(tunnelConfig, placeholders))).steps || ["Removed tunnel ingress"]);
 		},
 		catch: (err) => err
@@ -605,7 +605,7 @@ function pruneSpecialistRegistry(issueId) {
 	return Effect.tryPromise({
 		try: async () => {
 			const step = "teardown:specialist-registry";
-			const { pruneSpecialistRegistryEntriesForIssue } = await import("./specialists-F2uMO4QS.js");
+			const { pruneSpecialistRegistryEntriesForIssue } = await import("./specialists-DdvpFNt1.js");
 			const removed = pruneSpecialistRegistryEntriesForIssue(issueId);
 			return removed > 0 ? stepOk(step, [`Pruned ${removed} specialist registry entr${removed === 1 ? "y" : "ies"} for ${issueId}`]) : stepSkipped(step, [`No specialist registry entries for ${issueId}`]);
 		},
@@ -616,7 +616,7 @@ function pruneCheckpointRefs(projectPath, issueLower) {
 	return Effect.tryPromise({
 		try: async () => {
 			const step = "teardown:checkpoint-refs";
-			const { pruneCheckpointRefsForAgents } = await import("./checkpoint-manager-CPw51H2n.js");
+			const { pruneCheckpointRefsForAgents } = await import("./checkpoint-manager-eFgaMMu4.js");
 			const agentIds = [
 				`agent-${issueLower}`,
 				`planning-${issueLower}`,
@@ -630,4 +630,4 @@ function pruneCheckpointRefs(projectPath, issueLower) {
 //#endregion
 export { teardownWorkspace as t };
 
-//# sourceMappingURL=teardown-workspace-5LCVbjfq.js.map
+//# sourceMappingURL=teardown-workspace-CWz1pbEK.js.map

package/server/{test-agent-queue-qfsq6uaC.js → test-agent-queue-TiVXe3ZT.js}

@@ -1,8 +1,8 @@
-import { Gn as resolveProjectFromIssueSync, Nn as init_projects } from "./config-yaml-DPAieL_G.js";
-import { c as init_review_status, y as setReviewStatusSync } from "./review-status-BQjqQXZG.js";
-import { W as spawnRun, t as init_agents } from "./agents-DHvsjsuP.js";
-import { n as shouldSkipDispatchAsMerged, t as init_merge_verification } from "./merge-verification-DA9rvqsE.js";
-import { r as init_test_verdict, t as clearTestVerdictArtifact } from "./test-verdict-D3Il7cBK.js";
+import { Gn as resolveProjectFromIssueSync, Nn as init_projects } from "./config-yaml-ClpGgrf6.js";
+import { c as init_review_status, y as setReviewStatusSync } from "./review-status-gPndPUBc.js";
+import { W as spawnRun, t as init_agents } from "./agents-B5LfpLPv.js";
+import { n as shouldSkipDispatchAsMerged, t as init_merge_verification } from "./merge-verification-BGiuiXAK.js";
+import { r as init_test_verdict, t as clearTestVerdictArtifact } from "./test-verdict-Bm4uv_AA.js";
 import { Data, Effect } from "effect";
 //#region ../../lib/cloister/test-agent-queue.ts
 /**
@@ -163,4 +163,4 @@ const dispatchTestAgentAndNotify = (issueId, workspace, branch, notifyAgent) =>
 //#endregion
 export { buildTestRolePrompt, dispatchTestAgentAndNotify };
 
-//# sourceMappingURL=test-agent-queue-qfsq6uaC.js.map
+//# sourceMappingURL=test-agent-queue-TiVXe3ZT.js.map

package/server/{test-verdict-D3Il7cBK.js → test-verdict-Bm4uv_AA.js}

@@ -1,6 +1,6 @@
 import { n as __esmMin } from "./rolldown-runtime-DNCzzKnI.js";
-import { existsSync, readFileSync, rmSync, statSync } from "node:fs";
 import { join } from "node:path";
+import { existsSync, readFileSync, rmSync, statSync } from "node:fs";
 //#region ../../lib/cloister/test-verdict.ts
 /**
 * Deterministic test-verdict artifact contract (PAN-1681).
@@ -102,4 +102,4 @@ var init_test_verdict = __esmMin((() => {}));
 //#endregion
 export { testVerdictArtifactPath as a, readTestVerdictArtifact as i, decideUnsignaledTestAction as n, init_test_verdict as r, clearTestVerdictArtifact as t };
 
-//# sourceMappingURL=test-verdict-D3Il7cBK.js.map
+//# sourceMappingURL=test-verdict-Bm4uv_AA.js.map

package/server/{test-verdict-BkubHtti.js → test-verdict-CCDd25uN.js}

@@ -1,3 +1,3 @@
-import { i as readTestVerdictArtifact, r as init_test_verdict } from "./test-verdict-D3Il7cBK.js";
+import { i as readTestVerdictArtifact, r as init_test_verdict } from "./test-verdict-Bm4uv_AA.js";
 init_test_verdict();
 export { readTestVerdictArtifact };

package/server/{tldr-daemon-CJqGsDFh.js → tldr-daemon-Big5IZ_M.js}

@@ -1,3 +1,3 @@
-import { n as getTldrDaemonServiceSync, r as init_tldr_daemon } from "./tldr-daemon-CJW_P4On.js";
+import { n as getTldrDaemonServiceSync, r as init_tldr_daemon } from "./tldr-daemon-C_1frSDj.js";
 init_tldr_daemon();
 export { getTldrDaemonServiceSync };

package/server/{tldr-daemon-CJW_P4On.js → tldr-daemon-C_1frSDj.js}

@@ -1,5 +1,5 @@
 import { n as __esmMin } from "./rolldown-runtime-DNCzzKnI.js";
-import { vr as init_errors } from "./config-yaml-DPAieL_G.js";
+import { vr as init_errors } from "./config-yaml-ClpGgrf6.js";
 import "effect";
 import { existsSync, readFileSync, statSync } from "fs";
 import { join } from "path";
@@ -221,4 +221,4 @@ var init_tldr_daemon = __esmMin((() => {
 //#endregion
 export { getTldrDaemonServiceSync as n, init_tldr_daemon as r, TldrDaemonService as t };
 
-//# sourceMappingURL=tldr-daemon-CJW_P4On.js.map
+//# sourceMappingURL=tldr-daemon-C_1frSDj.js.map

package/server/{tmux-ePNhMIMU.js → tmux-D57f-XNv.js}

@@ -1,5 +1,5 @@
 import { n as __esmMin } from "./rolldown-runtime-DNCzzKnI.js";
-import { Br as getOverdeckHome, Vr as init_paths, f as loadConfigSync, hr as TmuxError, t as init_config_yaml, vr as init_errors } from "./config-yaml-DPAieL_G.js";
+import { Br as getOverdeckHome, Vr as init_paths, f as loadConfigSync, hr as TmuxError, t as init_config_yaml, vr as init_errors } from "./config-yaml-ClpGgrf6.js";
 import { Effect } from "effect";
 import { appendFileSync, chmodSync, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "fs";
 import { join } from "path";
@@ -1098,4 +1098,4 @@ var init_tmux = __esmMin((() => {
 //#endregion
 export { listSessionsSync as A, colorFgBgForTheme as B, isPaneDead as C, listPaneValuesSync as D, listPaneValues as E, sendKeysAsync as F, buildChildEnvSync as G, init_ui_theme as H, sendRawKeystroke as I, buildChildEnvWithoutTmuxSync as K, sessionExists as L, resizeWindow as M, sendEscapeKeyAsync as N, listSessionNames as O, sendKeys as P, sessionExistsSync as R, isHarnessProcessAlive as S, killSessionSync as T, setUiTheme as U, getUiThemeSync as V, BLANKED_PROVIDER_ENV as W, getTmuxBaseArgs as _, capturePaneSync as a, getWindowDimensions as b, ensureManagedTmuxContextOnce as c, exactPaneTarget as d, exactSession as f, getManagedTmuxSocketName as g, getManagedTmuxConfigPath as h, capturePane as i, paneTreeHasHarnessProcess as j, listSessions as k, ensureOverdeckTmuxServerAsync as l, getAgentSessions as m, buildTmuxArgs as n, createSession as o, findManagedServerPidSync as p, init_child_env as q, buildTmuxCommandString as r, createSessionSync as s, MessageDeliveryFailed as t, ensureOverdeckTmuxServerSync as u, getTmuxCommand as v, killSession as w, init_tmux as x, getTmuxConfigMode as y, setOption as z };
 
-//# sourceMappingURL=tmux-ePNhMIMU.js.map
+//# sourceMappingURL=tmux-D57f-XNv.js.map

package/server/{tmux-CeDD14p1.js → tmux-DClqWwb8.js}

@@ -1,3 +1,3 @@
-import { C as isPaneDead, L as sessionExists, O as listSessionNames, w as killSession, x as init_tmux } from "./tmux-ePNhMIMU.js";
+import { C as isPaneDead, L as sessionExists, O as listSessionNames, w as killSession, x as init_tmux } from "./tmux-D57f-XNv.js";
 init_tmux();
 export { isPaneDead, killSession, listSessionNames, sessionExists };

package/server/{tracker-config-Drt_tx4D.js → tracker-config-B_Ubts1Z.js}

@@ -1,3 +1,3 @@
-import { a as init_tracker_config, i as initTrackerConfigCache, n as getLinearApiKey, o as validateRallyConfig, r as getRallyConfig, t as getGitHubConfig } from "./tracker-config-C3hiPVAM.js";
+import { a as init_tracker_config, i as initTrackerConfigCache, n as getLinearApiKey, o as validateRallyConfig, r as getRallyConfig, t as getGitHubConfig } from "./tracker-config-BmdJU_w6.js";
 init_tracker_config();
 export { getGitHubConfig, getLinearApiKey, getRallyConfig, initTrackerConfigCache, validateRallyConfig };

package/server/{tracker-config-C3hiPVAM.js → tracker-config-BmdJU_w6.js}

@@ -1,5 +1,5 @@
 import { n as __esmMin } from "./rolldown-runtime-DNCzzKnI.js";
-import { Nn as init_projects, f as loadConfigSync, t as init_config_yaml, wn as getIssuePrefix, zn as loadProjectsConfigSync } from "./config-yaml-DPAieL_G.js";
+import { Nn as init_projects, f as loadConfigSync, t as init_config_yaml, wn as getIssuePrefix, zn as loadProjectsConfigSync } from "./config-yaml-ClpGgrf6.js";
 import { existsSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
@@ -142,4 +142,4 @@ var init_tracker_config = __esmMin((() => {
 //#endregion
 export { init_tracker_config as a, initTrackerConfigCache as i, getLinearApiKey as n, validateRallyConfig as o, getRallyConfig as r, getGitHubConfig as t };
 
-//# sourceMappingURL=tracker-config-C3hiPVAM.js.map
+//# sourceMappingURL=tracker-config-BmdJU_w6.js.map

package/server/{tracker-utils-D6B8scEw.js → tracker-utils-Bg-Sevcv.js}

@@ -1,3 +1,3 @@
-import { i as resolveGitHubIssueSync, n as init_tracker_utils } from "./tracker-utils-bpWs7Xyx.js";
+import { i as resolveGitHubIssueSync, n as init_tracker_utils } from "./tracker-utils-CWFt6jjV.js";
 init_tracker_utils();
 export { resolveGitHubIssueSync };

package/server/{tracker-utils-bpWs7Xyx.js → tracker-utils-CWFt6jjV.js}

@@ -1,5 +1,5 @@
 import { n as __esmMin } from "./rolldown-runtime-DNCzzKnI.js";
-import { $n as extractPrefixSync, Nn as init_projects, Qn as extractNumberSync, er as init_issue_id, nr as parseIssueIdSync, vr as init_errors, wn as getIssuePrefix, zn as loadProjectsConfigSync } from "./config-yaml-DPAieL_G.js";
+import { $n as extractPrefixSync, Nn as init_projects, Qn as extractNumberSync, er as init_issue_id, nr as parseIssueIdSync, vr as init_errors, wn as getIssuePrefix, zn as loadProjectsConfigSync } from "./config-yaml-ClpGgrf6.js";
 import "effect";
 import { existsSync, readFileSync } from "fs";
 import { join } from "path";
@@ -120,4 +120,4 @@ var init_tracker_utils = __esmMin((() => {
 //#endregion
 export { resolveTrackerTypeSync as a, resolveGitHubIssueSync as i, init_tracker_utils as n, parseGitHubReposSync as r, extractIssuePrefix as t };
 
-//# sourceMappingURL=tracker-utils-bpWs7Xyx.js.map
+//# sourceMappingURL=tracker-utils-CWFt6jjV.js.map

package/server/{tunnel-3Ve8BS4H.js → tunnel-UBf2vyAL.js}

@@ -1,5 +1,5 @@
 import { n as __esmMin } from "./rolldown-runtime-DNCzzKnI.js";
-import { gr as TrackerError, vr as init_errors } from "./config-yaml-DPAieL_G.js";
+import { gr as TrackerError, vr as init_errors } from "./config-yaml-ClpGgrf6.js";
 import { n as init_workspace_config, r as replacePlaceholdersSync } from "./workspace-config-DA8U97k9.js";
 import { Effect } from "effect";
 import { readFileSync } from "fs";
@@ -217,4 +217,4 @@ var init_tunnel = __esmMin((() => {
 //#endregion
 export { init_tunnel as n, removeTunnelIngress as r, addTunnelIngress as t };
 
-//# sourceMappingURL=tunnel-3Ve8BS4H.js.map
+//# sourceMappingURL=tunnel-UBf2vyAL.js.map

package/server/{tunnel-AporWhoi.js → tunnel-hOBNQbmF.js}

@@ -1,3 +1,3 @@
-import { n as init_tunnel, r as removeTunnelIngress } from "./tunnel-3Ve8BS4H.js";
+import { n as init_tunnel, r as removeTunnelIngress } from "./tunnel-UBf2vyAL.js";
 init_tunnel();
 export { removeTunnelIngress };

package/server/{uat-train-C3hWXtip.js → uat-train-DGkIkLxu.js}

@@ -1,2 +1,2 @@
-import { a as postUatGenerationStackPayload, c as startUatTrainReconciler, i as postUatGenerationPromotePayload, l as stopUatTrainReconciler, n as getUatCandidatePayload, o as resolveUatProjectRoot, r as getUatGenerationsPayload, s as runUatTrainReconcile, t as canStartUatTrainReconciler } from "./uat-train-CtNGgXxj.js";
+import { a as postUatGenerationStackPayload, c as startUatTrainReconciler, i as postUatGenerationPromotePayload, l as stopUatTrainReconciler, n as getUatCandidatePayload, o as resolveUatProjectRoot, r as getUatGenerationsPayload, s as runUatTrainReconcile, t as canStartUatTrainReconciler } from "./uat-train-qNanv5hN.js";
 export { canStartUatTrainReconciler, getUatCandidatePayload, getUatGenerationsPayload, postUatGenerationPromotePayload, postUatGenerationStackPayload, resolveUatProjectRoot, runUatTrainReconcile, startUatTrainReconciler, stopUatTrainReconciler };