proton-mail-bridge-client 2.3.2 → 2.4.0

package/dist/scripts/check-claude-desktop.d.ts

@@ -14,4 +14,22 @@ export declare function getClaudeDesktopInstallStatus(options?: {
     configPath?: string;
     serverName?: string;
 }): Promise<ClaudeDesktopInstallStatus>;
+export interface ClaudeDesktopHealth {
+    status: ClaudeDesktopInstallStatus;
+    ok: boolean;
+    problems: string[];
+    warnings: string[];
+    runtimeVersion?: string;
+    sourceVersion?: string;
+}
+/**
+ * Presence checks are not enough: a bumped Node, a half-installed runtime or a broken dist all
+ * leave the files in place while Claude Desktop cannot start the server. Run what Claude Desktop
+ * will run, with the configured command.
+ */
+export declare function checkClaudeDesktopInstall(options?: {
+    configPath?: string;
+    serverName?: string;
+    sourceVersion?: string;
+}): Promise<ClaudeDesktopHealth>;
 //# sourceMappingURL=check-claude-desktop.d.ts.map

package/dist/scripts/check-claude-desktop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-claude-desktop.d.ts","sourceRoot":"","sources":["../../src/scripts/check-claude-desktop.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,wBAAwB,EAAE,OAAO,CAAC;IAClC,YAAY,EAAE,OAAO,CAAC;CACvB;AA6DD,wBAAsB,6BAA6B,CAAC,OAAO,GAAE;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CA0C3C"}
+{"version":3,"file":"check-claude-desktop.d.ts","sourceRoot":"","sources":["../../src/scripts/check-claude-desktop.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,wBAAwB,EAAE,OAAO,CAAC;IAClC,YAAY,EAAE,OAAO,CAAC;CACvB;AA6DD,wBAAsB,6BAA6B,CAAC,OAAO,GAAE;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAyC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,0BAA0B,CAAC;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAWD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACjF,OAAO,CAAC,mBAAmB,CAAC,CAwD9B"}

package/dist/scripts/check-claude-desktop.js

@@ -1,8 +1,11 @@
 import { constants as fsConstants } from "node:fs";
+import { execFile } from "node:child_process";
 import { access, readFile } from "node:fs/promises";
-import { resolve } from "node:path";
+import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { resolveClaudeDesktopConfigPath, } from "./install-claude-desktop.js";
+import { promisify } from "node:util";
+import { nodeCommandWarnings, parseClaudeDesktopConfig, resolveClaudeDesktopConfigPath, verifyRuntime, } from "./install-claude-desktop.js";
+const execFileAsync = promisify(execFile);
 const DEFAULT_SERVER_NAME = "proton-mail-bridge";
 function parseCliArgs(argv) {
     const options = {};
@@ -62,8 +65,7 @@ export async function getClaudeDesktopInstallStatus(options = {}) {
     let configExists = false;
     let parsed = {};
     try {
-        const raw = await readFile(configPath, "utf8");
-        parsed = JSON.parse(raw);
+        parsed = parseClaudeDesktopConfig(await readFile(configPath, "utf8"), configPath);
         configExists = true;
     }
     catch (error) {
@@ -93,40 +95,99 @@ export async function getClaudeDesktopInstallStatus(options = {}) {
         hasEnvConfig: Boolean(entry?.env && typeof entry.env === "object" && !Array.isArray(entry.env)),
     };
 }
-function renderStatus(status) {
+async function readVersion(packageJsonPath) {
+    try {
+        const version = JSON.parse(await readFile(packageJsonPath, "utf8")).version;
+        return typeof version === "string" ? version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Presence checks are not enough: a bumped Node, a half-installed runtime or a broken dist all
+ * leave the files in place while Claude Desktop cannot start the server. Run what Claude Desktop
+ * will run, with the configured command.
+ */
+export async function checkClaudeDesktopInstall(options = {}) {
+    const status = await getClaudeDesktopInstallStatus(options);
+    const problems = [];
+    const warnings = [];
+    const health = { status, ok: false, problems, warnings };
     if (!status.configExists) {
-        return [
-            "Claude Desktop config not found.",
-            `Expected config path: ${status.configPath}`,
-            "Run npm run setup:claude-desktop to install Proton Mail Bridge Client for Claude Desktop.",
-        ].join("\n");
+        problems.push(`Claude Desktop config not found at ${status.configPath}. Run npm run setup:claude-desktop.`);
+        return health;
     }
     if (!status.installed) {
-        return [
-            "Proton Mail Bridge Client is not currently registered in Claude Desktop.",
-            `Config path: ${status.configPath}`,
-            `Expected server key: ${status.serverName}`,
-            "Run npm run setup:claude-desktop to add it.",
-        ].join("\n");
-    }
-    return [
-        "Claude Desktop install looks present.",
-        `Config path: ${status.configPath}`,
-        `Server key: ${status.serverName}`,
-        `Runtime dir: ${status.runtimeDir || "unknown"}`,
-        `Runtime entry exists: ${status.runtimeEntryExists ? "yes" : "no"}`,
-        `Runtime dependencies exist: ${status.runtimeNodeModulesExists ? "yes" : "no"}`,
-        `Env config present: ${status.hasEnvConfig ? "yes" : "no"}`,
-    ].join("\n");
+        problems.push(`"${status.serverName}" is not registered in ${status.configPath}. Run npm run setup:claude-desktop.`);
+        return health;
+    }
+    const { runtimeDir, entryCommand } = status;
+    if (!runtimeDir)
+        problems.push("The config entry has no cwd (runtime directory).");
+    if (!status.runtimeEntryExists)
+        problems.push("Runtime entry (args[0], dist/index.js) does not exist.");
+    if (!status.runtimeNodeModulesExists)
+        problems.push("Runtime dependencies (node_modules) are missing.");
+    if (!entryCommand)
+        problems.push("The config entry has no command.");
+    let commandRuns = false;
+    if (entryCommand) {
+        try {
+            await execFileAsync(entryCommand, ["--version"], { timeout: 10_000 });
+            commandRuns = true;
+        }
+        catch (error) {
+            problems.push(`Configured command "${entryCommand}" does not run (${error instanceof Error ? error.message.split("\n")[0] : String(error)}). Re-run npm run setup:claude-desktop.`);
+        }
+        warnings.push(...nodeCommandWarnings(entryCommand));
+    }
+    if (runtimeDir) {
+        health.runtimeVersion = await readVersion(join(runtimeDir, "package.json"));
+        health.sourceVersion =
+            options.sourceVersion ?? (await readVersion(resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "package.json")));
+        if (!health.runtimeVersion) {
+            problems.push(`Runtime package.json is missing or unreadable in ${runtimeDir}.`);
+        }
+        else if (health.sourceVersion && health.runtimeVersion !== health.sourceVersion) {
+            problems.push(`Runtime is version ${health.runtimeVersion} but this package is ${health.sourceVersion}. Re-run npm run setup:claude-desktop to update it.`);
+        }
+        if (commandRuns && health.runtimeVersion && status.runtimeEntryExists && status.runtimeNodeModulesExists) {
+            try {
+                await verifyRuntime(runtimeDir, entryCommand, health.runtimeVersion);
+            }
+            catch (error) {
+                problems.push(error instanceof Error ? error.message : String(error));
+            }
+        }
+    }
+    health.ok = problems.length === 0;
+    return health;
+}
+function renderHealth(health) {
+    const { status } = health;
+    const lines = health.ok
+        ? ["Claude Desktop install is healthy (command runs, better-sqlite3 loads, dist imports)."]
+        : ["Claude Desktop install has problems:", ...health.problems.map((problem) => `  - ${problem}`)];
+    if (health.warnings.length > 0)
+        lines.push(...health.warnings.map((warning) => `Warning: ${warning}`));
+    if (status.installed) {
+        lines.push(`Config path: ${status.configPath}`, `Server key: ${status.serverName}`, `Runtime dir: ${status.runtimeDir || "unknown"}`, `Runtime version: ${health.runtimeVersion ?? "unknown"}${health.sourceVersion ? ` (package ${health.sourceVersion})` : ""}`, `Env config present: ${status.hasEnvConfig ? "yes" : "no"}`);
+    }
+    return lines.join("\n");
 }
 async function main() {
     const options = parseCliArgs(process.argv.slice(2));
-    const status = await getClaudeDesktopInstallStatus(options);
+    const health = await checkClaudeDesktopInstall(options);
     if (options.json) {
-        process.stdout.write(`${JSON.stringify(status, null, 2)}\n`);
-        return;
+        process.stdout.write(`${JSON.stringify(health, null, 2)}\n`);
+    }
+    else {
+        process.stdout.write(`${renderHealth(health)}\n`);
+    }
+    if (!health.ok) {
+        process.exitCode = 1;
     }
-    process.stdout.write(`${renderStatus(status)}\n`);
 }
 const isDirectExecution = process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url);
 if (isDirectExecution) {

package/dist/scripts/check-claude-desktop.js.map

@@ -1 +1 @@
-{"version":3,"file":"check-claude-desktop.js","sourceRoot":"","sources":["../../src/scripts/check-claude-desktop.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"check-claude-desktop.js","sourceRoot":"","sources":["../../src/scripts/check-claude-desktop.ts"],"names":[],"mappings":"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"}

package/dist/scripts/install-claude-desktop.d.ts

@@ -13,22 +13,33 @@ export interface InstallOptions {
     includeEnv?: boolean;
     env?: Record<string, string>;
     useRepoRuntime?: boolean;
+    /** Test seams for the staged install; the defaults are the real implementations. */
+    installDependencies?: (stagingDir: string, hasLockfile: boolean) => Promise<void>;
+    afterInstall?: (stagingDir: string) => Promise<void>;
+    rename?: (from: string, to: string) => Promise<void>;
+    verifyRuntime?: (dir: string, nodeCommand: string, expectedVersion: string) => Promise<void>;
 }
 export declare function resolveClaudeDesktopConfigPath(explicitPath?: string): string;
 export declare function resolveClaudeDesktopRuntimeDir(explicitPath?: string): string;
 export declare function collectInstallEnv(sourceEnv?: NodeJS.ProcessEnv): Record<string, string>;
 export declare function resolveStableNodeCommand(execPath: string, realpath?: (path: string) => string): string;
+/** A version-pinned nvm path stops existing after `nvm uninstall`; the config would silently break. */
+export declare function nodeCommandWarnings(command: string): string[];
 export declare function buildClaudeDesktopServerConfig(options?: InstallOptions): {
     serverName: string;
     serverConfig: ClaudeDesktopServerConfig;
 };
 export declare function buildRuntimeInstallArgs(hasLockfile: boolean): string[];
+export declare function verifyRuntime(dir: string, nodeCommand: string, expectedVersion: string): Promise<void>;
 export declare function prepareClaudeDesktopRuntime(options?: InstallOptions): Promise<{
     runtimeDir: string;
     sourceCwd: string;
     usedRepoRuntime: boolean;
 }>;
 export declare function mergeClaudeDesktopConfig(existing: Record<string, unknown>, serverName: string, serverConfig: ClaudeDesktopServerConfig): Record<string, unknown>;
+export declare function parseClaudeDesktopConfig(raw: string, configPath: string): Record<string, unknown>;
+/** Copy of an env map that is safe to print: secret values hidden, key names kept. */
+export declare function redactEnv(env: Record<string, string>): Record<string, string>;
 export declare function installClaudeDesktopConfig(options?: InstallOptions): Promise<{
     configPath: string;
     backupPath?: string;
@@ -37,5 +48,6 @@ export declare function installClaudeDesktopConfig(options?: InstallOptions): Pr
     runtimeDir: string;
     sourceCwd: string;
     usedRepoRuntime: boolean;
+    warnings: string[];
 }>;
 //# sourceMappingURL=install-claude-desktop.d.ts.map

package/dist/scripts/install-claude-desktop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-claude-desktop.d.ts","sourceRoot":"","sources":["../../src/scripts/install-claude-desktop.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAoFD,wBAAgB,8BAA8B,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB5E;AAED,wBAAgB,8BAA8B,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB5E;AAED,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMpG;AAsBD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAqC,GAChE,MAAM,CAgBR;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,cAAmB,GAC3B;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,yBAAyB,CAAA;CAAE,CAiBjE;AAeD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,EAAE,CAMtE;AAqBD,wBAAsB,2BAA2B,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC;IACvF,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC,CAiCD;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,yBAAyB,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsCzB;AAsCD,wBAAsB,0BAA0B,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC;IACtF,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,yBAAyB,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC,CA0BD"}
+{"version":3,"file":"install-claude-desktop.d.ts","sourceRoot":"","sources":["../../src/scripts/install-claude-desktop.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oFAAoF;IACpF,mBAAmB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9F;AAoFD,wBAAgB,8BAA8B,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB5E;AAED,wBAAgB,8BAA8B,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB5E;AAED,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUpG;AAsBD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAqC,GAChE,MAAM,CAqBR;AAED,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAO7D;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,cAAmB,GAC3B;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,yBAAyB,CAAA;CAAE,CAiBjE;AAeD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,EAAE,CAMtE;AAoCD,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ5G;AAKD,wBAAsB,2BAA2B,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC;IACvF,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC,CA4ED;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,yBAAyB,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+BzB;AAUD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAejG;AAsFD,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO7E;AAED,wBAAsB,0BAA0B,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC;IACtF,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,yBAAyB,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC,CAwCD"}

package/dist/scripts/install-claude-desktop.js

@@ -1,8 +1,8 @@
 import { execFile } from "node:child_process";
 import { constants as fsConstants, realpathSync } from "node:fs";
-import { access, chmod, copyFile, cp, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { access, chmod, copyFile, cp, mkdir, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
+import { basename, dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { promisify } from "node:util";
 const DEFAULT_SERVER_NAME = "proton-mail-bridge";
@@ -116,7 +116,10 @@ export function resolveClaudeDesktopRuntimeDir(explicitPath) {
     }
 }
 export function collectInstallEnv(sourceEnv = process.env) {
-    return Object.fromEntries(Object.entries(sourceEnv).filter(([key, value]) => Boolean(value) && (key.startsWith("PROTONMAIL_") || key === "DEBUG")));
+    return Object.fromEntries(Object.entries(sourceEnv).filter(([key, value]) => Boolean(value) &&
+        (key.startsWith("PROTONMAIL_") || key === "DEBUG") &&
+        // The installer's own override; the server never reads it.
+        key !== "PROTONMAIL_CLAUDE_RUNTIME_DIR"));
 }
 // Homebrew's `node` formula installs into a version-pinned Cellar directory
 // (e.g. /opt/homebrew/Cellar/node/25.8.0/bin/node) and symlinks a stable
@@ -139,11 +142,15 @@ export function collectInstallEnv(sourceEnv = process.env) {
 // either already version-managed a different way or we can't safely assume
 // a stable alternative exists.
 export function resolveStableNodeCommand(execPath, realpath = (path) => realpathSync(path)) {
-    const cellarMatch = execPath.match(/^(.*)\/Cellar\/node\/[^/]+\/bin\/node$/);
+    // `node` -> <prefix>/bin/node; versioned formulae (`node@22`) keep their stable
+    // link under <prefix>/opt/node@22/bin/node (there is no <prefix>/bin/node for them).
+    const cellarMatch = execPath.match(/^(.*)\/Cellar\/(node(?:@\d+)?)\/[^/]+\/bin\/node$/);
     if (!cellarMatch) {
         return execPath;
     }
-    const stableCandidate = join(cellarMatch[1], "bin", "node");
+    const stableCandidate = cellarMatch[2] === "node"
+        ? join(cellarMatch[1], "bin", "node")
+        : join(cellarMatch[1], "opt", cellarMatch[2], "bin", "node");
     try {
         if (realpath(stableCandidate) === execPath) {
             return stableCandidate;
@@ -154,6 +161,15 @@ export function resolveStableNodeCommand(execPath, realpath = (path) => realpath
     }
     return execPath;
 }
+/** A version-pinned nvm path stops existing after `nvm uninstall`; the config would silently break. */
+export function nodeCommandWarnings(command) {
+    if (/[\\/]\.nvm[\\/]versions[\\/]node[\\/]v[^\\/]+[\\/]bin[\\/]node$/.test(command)) {
+        return [
+            `The configured Node (${command}) is a version-pinned nvm path. It disappears after "nvm uninstall"/"nvm install" of another version and Claude Desktop would then fail to start the server. Install Node via Homebrew or pass --command with a stable path.`,
+        ];
+    }
+    return [];
+}
 export function buildClaudeDesktopServerConfig(options = {}) {
     const cwd = resolve(options.runtimeDir || options.cwd || resolveSourceRepoRoot());
     const command = options.command || resolveStableNodeCommand(process.execPath);
@@ -206,6 +222,31 @@ async function installRuntimeDependencies(runtimeDir, hasLockfile) {
         ...shellOpts,
     });
 }
+// Runs in the runtime dir with the node Claude Desktop will use. Exits non-zero (stderr says why)
+// unless the native module works, the version matches and both entry points import.
+const VERIFY_SCRIPT = [
+    'const { createRequire } = require("node:module");',
+    'const path = require("node:path");',
+    'const req = createRequire(path.join(process.cwd(), "package.json"));',
+    'const Database = req("better-sqlite3");',
+    'const db = new Database(":memory:");',
+    'db.prepare("select 1").get();',
+    "db.close();",
+    'const version = req("./package.json").version;',
+    'if (version !== process.argv[1]) throw new Error("runtime package.json is " + version + ", expected " + process.argv[1]);',
+    'Promise.all([import("./dist/index.js"), import("./dist/lib.js")]).then(() => process.exit(0), (error) => { console.error(error && error.stack || String(error)); process.exit(1); });',
+].join("\n");
+export async function verifyRuntime(dir, nodeCommand, expectedVersion) {
+    try {
+        await execFileAsync(nodeCommand, ["-e", VERIFY_SCRIPT, expectedVersion], { cwd: dir, timeout: 60_000 });
+    }
+    catch (error) {
+        const detail = error.stderr?.trim() || (error instanceof Error ? error.message : String(error));
+        throw new Error(`Runtime verification failed in ${dir}: ${detail}`);
+    }
+}
+// Entries the installer owns inside the runtime dir; anything else is the user's and is carried over.
+const MANAGED_RUNTIME_ENTRIES = new Set(["dist", "node_modules", "package.json", "package-lock.json"]);
 export async function prepareClaudeDesktopRuntime(options = {}) {
     const sourceCwd = resolveSourceRepoRoot(options.cwd);
     const runtimeDir = options.useRepoRuntime ? sourceCwd : resolveClaudeDesktopRuntimeDir(options.runtimeDir);
@@ -216,20 +257,56 @@ export async function prepareClaudeDesktopRuntime(options = {}) {
             usedRepoRuntime: true,
         };
     }
-    await mkdir(runtimeDir, { recursive: true });
-    await rm(join(runtimeDir, "dist"), { recursive: true, force: true });
-    await cp(join(sourceCwd, "dist"), join(runtimeDir, "dist"), { recursive: true, force: true });
-    await copyFile(join(sourceCwd, "package.json"), join(runtimeDir, "package.json"));
-    // Only present when installing from a git checkout; published tarballs never contain it.
-    const lockfilePath = join(sourceCwd, "package-lock.json");
-    const hasLockfile = await pathExists(lockfilePath);
-    if (hasLockfile) {
-        await copyFile(lockfilePath, join(runtimeDir, "package-lock.json"));
+    // Build and verify a complete runtime next to the live one, then swap by rename. The live
+    // runtime is never touched until the replacement is known to work, and the old one is kept
+    // as <runtimeDir>.previous (release 2.2.0 broke a machine by deleting dist and running
+    // `npm ci` in place).
+    const stagingDir = `${runtimeDir}.staging-${process.pid}`;
+    const previousDir = `${runtimeDir}.previous`;
+    const nodeCommand = options.command || resolveStableNodeCommand(process.execPath);
+    const verify = options.verifyRuntime ?? verifyRuntime;
+    const move = options.rename ?? rename;
+    const install = options.installDependencies ?? installRuntimeDependencies;
+    const { version } = JSON.parse(await readFile(join(sourceCwd, "package.json"), "utf8"));
+    await rm(stagingDir, { recursive: true, force: true });
+    await mkdir(dirname(runtimeDir), { recursive: true });
+    await mkdir(stagingDir);
+    try {
+        await cp(join(sourceCwd, "dist"), join(stagingDir, "dist"), { recursive: true });
+        await copyFile(join(sourceCwd, "package.json"), join(stagingDir, "package.json"));
+        // Only present when installing from a git checkout; published tarballs never contain it.
+        const hasLockfile = await pathExists(join(sourceCwd, "package-lock.json"));
+        if (hasLockfile) {
+            await copyFile(join(sourceCwd, "package-lock.json"), join(stagingDir, "package-lock.json"));
+        }
+        await install(stagingDir, hasLockfile);
+        await options.afterInstall?.(stagingDir);
+        await verify(stagingDir, nodeCommand, version);
+        const hadPrevious = await pathExists(runtimeDir);
+        if (hadPrevious) {
+            for (const entry of await readdir(runtimeDir)) {
+                if (!MANAGED_RUNTIME_ENTRIES.has(entry)) {
+                    await cp(join(runtimeDir, entry), join(stagingDir, entry), { recursive: true });
+                }
+            }
+            await rm(previousDir, { recursive: true, force: true });
+            await move(runtimeDir, previousDir);
+        }
+        try {
+            await move(stagingDir, runtimeDir);
+            await verify(runtimeDir, nodeCommand, version);
+        }
+        catch (error) {
+            await rm(runtimeDir, { recursive: true, force: true });
+            if (hadPrevious) {
+                await move(previousDir, runtimeDir);
+            }
+            throw new Error(`${error instanceof Error ? error.message : String(error)}\n${hadPrevious ? "The previous runtime was restored." : "Nothing was installed."}`);
+        }
     }
-    else {
-        await rm(join(runtimeDir, "package-lock.json"), { force: true });
+    finally {
+        await rm(stagingDir, { recursive: true, force: true });
     }
-    await installRuntimeDependencies(runtimeDir, hasLockfile);
     return {
         runtimeDir,
         sourceCwd,
@@ -240,45 +317,57 @@ export function mergeClaudeDesktopConfig(existing, serverName, serverConfig) {
     const existingServers = existing.mcpServers && typeof existing.mcpServers === "object" && !Array.isArray(existing.mcpServers)
         ? existing.mcpServers
         : {};
-    // collectInstallEnv() only sees PROTONMAIL_*/DEBUG vars exported in the
-    // shell that's running this installer right now — it has no way to see
-    // credentials that were hand-added straight into the config (e.g. because
-    // Claude Desktop itself, not this shell, is what had them set). A plain
-    // re-run of `npm run install:claude-desktop` from a shell without those
-    // vars exported used to silently wipe a working env block, since this
-    // function replaced the whole server entry outright. Reproduced live:
-    // install ran with none of PROTONMAIL_* exported, and the previously-
-    // working server lost its login and failed with "Missing required
-    // environment variables" until the config was hand-repaired from the
-    // installer's own pre-write backup. If this run has nothing new to
-    // contribute, keep whatever was already configured instead of dropping it.
+    // collectInstallEnv() only sees PROTONMAIL_*/DEBUG vars exported in the shell running this
+    // installer; it cannot see keys that were hand-added to the config (accounts, signature, ...).
+    // Replacing the env wholesale dropped them: with only PROTONMAIL_PASSWORD exported, the
+    // existing PROTONMAIL_ACCOUNTS_JSON vanished. Merge instead, new values winning per key.
     const existingServerConfig = existingServers[serverName];
     const existingEnv = existingServerConfig &&
         typeof existingServerConfig === "object" &&
         !Array.isArray(existingServerConfig) &&
+        existingServerConfig.env &&
         typeof existingServerConfig.env === "object"
-        ? (existingServerConfig.env ?? undefined)
+        ? (existingServerConfig.env)
         : undefined;
-    const env = serverConfig.env && Object.keys(serverConfig.env).length > 0 ? serverConfig.env : existingEnv;
+    const env = { ...existingEnv, ...serverConfig.env };
     return {
         ...existing,
         mcpServers: {
             ...existingServers,
             [serverName]: {
                 ...serverConfig,
-                ...(env && Object.keys(env).length > 0 ? { env } : {}),
+                ...(Object.keys(env).length > 0 ? { env } : {}),
             },
         },
     };
 }
+function lineOf(raw, message) {
+    const line = message.match(/\(line (\d+)/)?.[1];
+    if (line)
+        return line;
+    const position = message.match(/position (\d+)/)?.[1];
+    if (position)
+        return String(raw.slice(0, Number(position)).split("\n").length);
+    return "unknown";
+}
+export function parseClaudeDesktopConfig(raw, configPath) {
+    const text = raw.charCodeAt(0) === 0xfeff ? raw.slice(1) : raw;
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`${basename(configPath)} is not valid JSON at line ${lineOf(text, message)}: ${message} — Claude Desktop does not accept comments or trailing commas. The file was not changed.`);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`Claude Desktop config at ${configPath} must contain a JSON object.`);
+    }
+    return parsed;
+}
 async function readExistingConfig(configPath) {
     try {
-        const raw = await readFile(configPath, "utf8");
-        const parsed = JSON.parse(raw);
-        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-            throw new Error(`Claude Desktop config at ${configPath} must contain a JSON object.`);
-        }
-        return parsed;
+        return parseClaudeDesktopConfig(await readFile(configPath, "utf8"), configPath);
     }
     catch (error) {
         if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
@@ -287,6 +376,38 @@ async function readExistingConfig(configPath) {
         throw error;
     }
 }
+// Fail before the runtime is replaced, not after: a read-only config used to surface only at
+// the final write, with the new runtime already in place and a stray backup left behind.
+async function assertConfigWritable(configPath) {
+    try {
+        await access(configPath, fsConstants.W_OK);
+        return;
+    }
+    catch (error) {
+        if (!(error && typeof error === "object" && "code" in error && error.code === "ENOENT")) {
+            throw new Error(`Claude Desktop config ${configPath} is not writable: ${error.message}`);
+        }
+    }
+    // Not there yet: the first existing ancestor must be writable.
+    let dir = dirname(configPath);
+    while (!(await pathExists(dir)) && dirname(dir) !== dir)
+        dir = dirname(dir);
+    try {
+        await access(dir, fsConstants.W_OK);
+    }
+    catch (error) {
+        throw new Error(`Cannot create ${configPath}: ${error.message}`);
+    }
+}
+const MAX_CONFIG_BACKUPS = 5;
+async function pruneConfigBackups(configPath) {
+    const prefix = `${basename(configPath)}.bak-`;
+    // The names embed an ISO timestamp, so lexical order is chronological.
+    const backups = (await readdir(dirname(configPath))).filter((name) => name.startsWith(prefix)).sort();
+    for (const name of backups.slice(0, Math.max(0, backups.length - MAX_CONFIG_BACKUPS))) {
+        await rm(join(dirname(configPath), name), { force: true });
+    }
+}
 async function backupConfigIfPresent(configPath) {
     try {
         await access(configPath, fsConstants.F_OK);
@@ -298,6 +419,7 @@ async function backupConfigIfPresent(configPath) {
         // codebase that persists secrets (audit log, draft store, delivery queue).
         await copyFile(configPath, backupPath);
         await chmod(backupPath, 0o600);
+        await pruneConfigBackups(configPath);
         return backupPath;
     }
     catch (error) {
@@ -307,21 +429,56 @@ async function backupConfigIfPresent(configPath) {
         throw error;
     }
 }
+const SECRET_KEY = /password|secret|token/i;
+const REDACTED = "[redacted]";
+function redactAccountsJson(value) {
+    try {
+        const parsed = JSON.parse(value);
+        const scrub = (node) => Array.isArray(node)
+            ? node.map(scrub)
+            : node && typeof node === "object"
+                ? Object.fromEntries(Object.entries(node).map(([key, inner]) => [key, SECRET_KEY.test(key) ? REDACTED : scrub(inner)]))
+                : node;
+        return JSON.stringify(scrub(parsed));
+    }
+    catch {
+        return REDACTED;
+    }
+}
+/** Copy of an env map that is safe to print: secret values hidden, key names kept. */
+export function redactEnv(env) {
+    return Object.fromEntries(Object.entries(env).map(([key, value]) => [
+        key,
+        key === "PROTONMAIL_ACCOUNTS_JSON" ? redactAccountsJson(value) : SECRET_KEY.test(key) ? REDACTED : value,
+    ]));
+}
 export async function installClaudeDesktopConfig(options = {}) {
     const configPath = resolveClaudeDesktopConfigPath(options.configPath);
-    const existing = await readExistingConfig(configPath);
+    // Validate first (bad JSON, read-only) so nothing has been replaced when we refuse.
+    await readExistingConfig(configPath);
+    await assertConfigWritable(configPath);
     const runtime = await prepareClaudeDesktopRuntime(options);
     const { serverName, serverConfig } = buildClaudeDesktopServerConfig({
         ...options,
         runtimeDir: runtime.runtimeDir,
     });
+    // Read again now: Claude Desktop or the user may have edited the file while the runtime installed.
+    const existing = await readExistingConfig(configPath);
     const merged = mergeClaudeDesktopConfig(existing, serverName, serverConfig);
     await mkdir(dirname(configPath), { recursive: true, mode: 0o700 });
     const backupPath = await backupConfigIfPresent(configPath);
+    // Temp file in the same directory + rename, so a crash never leaves a half-written config.
     // See backupConfigIfPresent's comment: this file holds live Bridge credentials.
-    await writeFile(configPath, `${JSON.stringify(merged, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
-    // writeFile's mode only applies to a newly created file; tighten an existing one too.
-    await chmod(configPath, 0o600);
+    const tempPath = `${configPath}.tmp-${process.pid}`;
+    try {
+        await writeFile(tempPath, `${JSON.stringify(merged, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
+        await chmod(tempPath, 0o600);
+        await rename(tempPath, configPath);
+    }
+    catch (error) {
+        await rm(tempPath, { force: true });
+        throw error;
+    }
     return {
         configPath,
         backupPath,
@@ -330,12 +487,23 @@ export async function installClaudeDesktopConfig(options = {}) {
         runtimeDir: runtime.runtimeDir,
         sourceCwd: runtime.sourceCwd,
         usedRepoRuntime: runtime.usedRepoRuntime,
+        warnings: nodeCommandWarnings(serverConfig.command),
     };
 }
 async function main() {
     const options = parseCliArgs(process.argv.slice(2));
     const result = await installClaudeDesktopConfig(options);
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    const printable = {
+        ...result,
+        serverConfig: {
+            ...result.serverConfig,
+            ...(result.serverConfig.env ? { env: redactEnv(result.serverConfig.env) } : {}),
+        },
+    };
+    process.stdout.write(`${JSON.stringify(printable, null, 2)}\n`);
+    for (const warning of result.warnings) {
+        process.stderr.write(`Warning: ${warning}\n`);
+    }
 }
 const isDirectExecution = process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url);
 if (isDirectExecution) {