@neurodock/cli 0.4.3 → 0.6.0

package/dist/commands/install-hooks.js

@@ -0,0 +1,356 @@
+/**
+ * `neurodock install-hooks` — wire NeuroDock's proactive guardrails into
+ * Claude Code's hook system.
+ *
+ * What this does (idempotent):
+ *
+ *   1. Copies the bundled `proactive_guardrail.py` script to
+ *      `~/.neurodock/hooks/proactive_guardrail.py` (creating dirs as needed).
+ *   2. Merges four hook entries (SessionStart / PreToolUse / PostToolUse /
+ *      Stop) into `~/.claude/settings.json`, preserving any existing hooks
+ *      from other tools and skipping if NeuroDock entries are already
+ *      present.
+ *   3. Optionally runs the script's `self-test` to verify Python is on
+ *      PATH and the heuristics fire.
+ *
+ * Why a CLI command and not just docs:
+ *
+ *   The setup is fiddly enough that asking users to hand-edit JSON to
+ *   wire four hooks is the kind of friction that defeats the whole
+ *   proactive-guardrails purpose. The user types one command.
+ *
+ * Opt-out:
+ *
+ *   `neurodock install-hooks --uninstall` removes the hook entries
+ *   (leaves the script in place — re-enabling is just a re-run).
+ *   Environment variable `NEURODOCK_GUARDRAILS=off` disables the hook
+ *   without touching settings.json.
+ */
+import { mkdirSync, readFileSync, writeFileSync, existsSync, copyFileSync, } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+import { spawnSync } from "node:child_process";
+const HOOK_EVENTS = [
+    "SessionStart",
+    "PreToolUse",
+    "PostToolUse",
+    "Stop",
+];
+const SUBCOMMAND_FOR_EVENT = {
+    SessionStart: "session-start",
+    PreToolUse: "pre-tool",
+    PostToolUse: "post-tool",
+    Stop: "stop",
+};
+const NEURODOCK_MARKER = "neurodock-proactive-guardrail";
+export async function runInstallHooks(options) {
+    const messages = [];
+    const hookDir = join(homedir(), ".neurodock", "hooks");
+    const targetScript = join(hookDir, "proactive_guardrail.py");
+    const settingsPath = join(homedir(), ".claude", "settings.json");
+    if (options.uninstall) {
+        return uninstallHooks(settingsPath, options.dryRun);
+    }
+    // 1. Copy the bundled script(s).
+    const sourceScript = resolveBundledScript("proactive_guardrail.py");
+    if (sourceScript === null) {
+        return {
+            messages: [
+                "[install-hooks] could not locate the bundled proactive_guardrail.py.",
+                "  This is a packaging bug — the script should ship with @neurodock/cli.",
+            ],
+            exitCode: 1,
+        };
+    }
+    const daemonSource = resolveBundledScript("neurodock_daemon.py");
+    const daemonTarget = join(hookDir, "neurodock_daemon.py");
+    if (options.dryRun) {
+        messages.push(`[install-hooks] would copy ${sourceScript} -> ${targetScript}`);
+        if (daemonSource !== null) {
+            messages.push(`[install-hooks] would copy ${daemonSource} -> ${daemonTarget}`);
+        }
+    }
+    else {
+        mkdirSync(hookDir, { recursive: true });
+        copyFileSync(sourceScript, targetScript);
+        messages.push(`[install-hooks] copied script -> ${targetScript}`);
+        if (daemonSource !== null) {
+            copyFileSync(daemonSource, daemonTarget);
+            messages.push(`[install-hooks] copied daemon -> ${daemonTarget}`);
+        }
+    }
+    // 2. Merge hook entries into settings.json.
+    const command = buildHookCommand(targetScript);
+    // Always echo the exact command string we're about to write. The
+    // Windows-path-escape bug (0.0.x ~/.neurodock/hooks/... mangled by
+    // bash) was a silent foot-gun precisely because the install summary
+    // didn't show it. Now it does, and a quick scan tells you whether
+    // forward slashes survived.
+    messages.push(`[install-hooks] hook command: ${command} <subcommand>`);
+    const merged = mergeSettings(settingsPath, command);
+    if (merged.changed) {
+        if (options.dryRun) {
+            messages.push("[install-hooks] would update ~/.claude/settings.json:");
+            for (const line of merged.diff)
+                messages.push(`  ${line}`);
+        }
+        else {
+            mkdirSync(dirname(settingsPath), { recursive: true });
+            writeFileSync(settingsPath, merged.json + "\n", "utf8");
+            messages.push("[install-hooks] updated ~/.claude/settings.json");
+            for (const line of merged.diff)
+                messages.push(`  ${line}`);
+        }
+    }
+    else {
+        messages.push("[install-hooks] settings.json already wired — no change needed.");
+    }
+    // 3. Optionally self-test.
+    if (options.selfTest && !options.dryRun) {
+        const selfTest = runSelfTest(targetScript);
+        messages.push(`[install-hooks] self-test: ${selfTest.summary}`);
+        if (selfTest.exitCode !== 0) {
+            return { messages, exitCode: 1 };
+        }
+        if (daemonSource !== null) {
+            const daemonSelfTest = runSelfTest(daemonTarget);
+            messages.push(`[install-hooks] daemon self-test: ${daemonSelfTest.summary}`);
+        }
+    }
+    // 4. Optionally wire the daemon at user-login autostart.
+    if (options.installDaemon === true && !options.dryRun) {
+        if (daemonSource === null) {
+            messages.push("[install-hooks] daemon script not bundled — skipping autostart.");
+        }
+        else {
+            const result = spawnSync("python", [daemonTarget, "install"], {
+                stdio: ["ignore", "pipe", "pipe"],
+                encoding: "utf8",
+            });
+            if (result.error) {
+                messages.push(`[install-hooks] daemon autostart skipped — python not on PATH (${result.error.message}).`);
+            }
+            else if (result.status !== 0) {
+                messages.push(`[install-hooks] daemon autostart failed: ${result.stderr.trim()}`);
+            }
+            else {
+                messages.push(`[install-hooks] daemon autostart: ${result.stdout.trim()}`);
+            }
+        }
+    }
+    else if (options.installDaemon === true && options.dryRun) {
+        messages.push("[install-hooks] would register daemon autostart (HKCU Run / LaunchAgent / systemd --user)");
+    }
+    messages.push("");
+    messages.push("Done. Open a new Claude Code session to activate the hooks.");
+    messages.push("Opt out anytime by setting NEURODOCK_GUARDRAILS=off in your environment,");
+    messages.push("or run: neurodock install-hooks --uninstall");
+    return { messages, exitCode: 0 };
+}
+function uninstallHooks(settingsPath, dryRun) {
+    const messages = [];
+    // 0.0.23: also try to remove the daemon autostart entry. Best-effort
+    // — if the daemon was never installed, the uninstall is a no-op.
+    if (!dryRun) {
+        const daemonTarget = join(homedir(), ".neurodock", "hooks", "neurodock_daemon.py");
+        if (existsSync(daemonTarget)) {
+            const result = spawnSync("python", [daemonTarget, "uninstall"], {
+                stdio: ["ignore", "pipe", "pipe"],
+                encoding: "utf8",
+            });
+            if (!result.error && result.status === 0) {
+                messages.push("[install-hooks] removed daemon autostart entry");
+            }
+        }
+    }
+    else {
+        messages.push("[install-hooks] would also remove daemon autostart entry");
+    }
+    if (!existsSync(settingsPath)) {
+        return {
+            messages: [
+                ...messages,
+                "[install-hooks] no ~/.claude/settings.json to clean — nothing to do.",
+            ],
+            exitCode: 0,
+        };
+    }
+    const raw = readFileSync(settingsPath, "utf8");
+    const settings = parseSettings(raw);
+    const hooks = isObject(settings.hooks) ? { ...settings.hooks } : {};
+    let removedAny = false;
+    for (const event of HOOK_EVENTS) {
+        const entries = hooks[event];
+        if (!Array.isArray(entries))
+            continue;
+        const filtered = entries.filter((entry) => !isNeurodockHookEntry(entry));
+        if (filtered.length !== entries.length) {
+            removedAny = true;
+            if (filtered.length === 0) {
+                delete hooks[event];
+            }
+            else {
+                hooks[event] = filtered;
+            }
+        }
+    }
+    if (!removedAny) {
+        return {
+            messages: [
+                "[install-hooks] no NeuroDock hook entries found — nothing to do.",
+            ],
+            exitCode: 0,
+        };
+    }
+    const next = { ...settings, hooks };
+    // Drop empty hooks object so we don't leave dead structure behind.
+    if (Object.keys(hooks).length === 0)
+        delete next["hooks"];
+    const formatted = JSON.stringify(next, null, 2);
+    if (dryRun) {
+        messages.push("[install-hooks] would remove NeuroDock entries from ~/.claude/settings.json");
+    }
+    else {
+        writeFileSync(settingsPath, formatted + "\n", "utf8");
+        messages.push("[install-hooks] removed NeuroDock entries from ~/.claude/settings.json");
+    }
+    messages.push("Hook script left at ~/.neurodock/hooks/ — delete manually if you want it gone.");
+    return { messages, exitCode: 0 };
+}
+function mergeSettings(settingsPath, command) {
+    let raw = "{}";
+    if (existsSync(settingsPath)) {
+        try {
+            raw = readFileSync(settingsPath, "utf8");
+        }
+        catch {
+            raw = "{}";
+        }
+    }
+    const settings = parseSettings(raw);
+    const hooks = isObject(settings.hooks) ? { ...settings.hooks } : {};
+    const diff = [];
+    let changed = false;
+    for (const event of HOOK_EVENTS) {
+        const existing = Array.isArray(hooks[event]) ? [...hooks[event]] : [];
+        if (existing.some(isNeurodockHookEntry))
+            continue;
+        const newEntry = buildHookEntry(event, command);
+        existing.push(newEntry);
+        hooks[event] = existing;
+        diff.push(`+ ${event} -> ${SUBCOMMAND_FOR_EVENT[event]}`);
+        changed = true;
+    }
+    if (!changed) {
+        return { changed: false, json: raw, diff: [] };
+    }
+    const next = { ...settings, hooks };
+    return {
+        changed: true,
+        json: JSON.stringify(next, null, 2),
+        diff,
+    };
+}
+function buildHookEntry(event, command) {
+    const subcommand = SUBCOMMAND_FOR_EVENT[event];
+    return {
+        // Claude Code reads this as a "matcher group". An empty matcher
+        // applies to all events of this type, which is what we want — the
+        // proactive guardrail evaluates on every event and decides whether
+        // to fire based on its own state.
+        matcher: "",
+        hooks: [
+            {
+                type: "command",
+                command: `${command} ${subcommand}`,
+                // Tag the entry so neurodock install-hooks can find and remove
+                // it later without scanning the entire command string.
+                description: NEURODOCK_MARKER,
+            },
+        ],
+    };
+}
+function buildHookCommand(scriptPath) {
+    // Always normalise to forward slashes. Python accepts them on Windows,
+    // and bash-style shells (Git Bash / MinGW — what Claude Code uses on
+    // Windows) strip backslashes from unquoted Windows paths, mangling
+    // the path passed to python. Quoting alone isn't enough because the
+    // JSON-decoded value goes through one more shell pass that strips
+    // escape sequences like `\U`, `\h`. Forward slashes side-step it.
+    const normalised = scriptPath.replace(/\\/g, "/");
+    const quoted = `"${normalised}"`;
+    return `python ${quoted}`;
+}
+function isNeurodockHookEntry(entry) {
+    if (!isObject(entry))
+        return false;
+    const hooks = entry.hooks;
+    if (!Array.isArray(hooks))
+        return false;
+    return hooks.some((h) => {
+        if (!isObject(h))
+            return false;
+        const command = h.command;
+        if (typeof command === "string" &&
+            command.includes("proactive_guardrail.py")) {
+            return true;
+        }
+        const description = h.description;
+        return typeof description === "string" && description === NEURODOCK_MARKER;
+    });
+}
+function parseSettings(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        return isObject(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+// ─────────────────────────────────────────────────────────────────────
+// Locate the bundled script in dev (monorepo) and prod (npm install)
+// ─────────────────────────────────────────────────────────────────────
+function resolveBundledScript(filename) {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        // Built: dist/commands/install-hooks.js -> ../assets/hooks/...
+        resolve(here, "..", "assets", "hooks", filename),
+        // Monorepo source: src/commands/install-hooks.ts -> ../assets/hooks/...
+        resolve(here, "..", "..", "src", "assets", "hooks", filename),
+        // node_modules install
+        resolve(here, "..", "..", "node_modules", "@neurodock", "cli", "dist", "assets", "hooks", filename),
+    ];
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    return null;
+}
+function runSelfTest(scriptPath) {
+    const result = spawnSync("python", [scriptPath, "self-test"], {
+        stdio: ["ignore", "pipe", "pipe"],
+        encoding: "utf8",
+    });
+    if (result.error) {
+        return {
+            summary: `python not on PATH (${result.error.message}). Install Python 3.11+ and re-run.`,
+            exitCode: 1,
+        };
+    }
+    if (result.status !== 0) {
+        return {
+            summary: `self-test failed (exit ${result.status}): ${result.stderr.trim()}`,
+            exitCode: result.status ?? 1,
+        };
+    }
+    return {
+        summary: result.stdout.trim() || "passed",
+        exitCode: 0,
+    };
+}
+//# sourceMappingURL=install-hooks.js.map

package/dist/commands/install-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-hooks.js","sourceRoot":"","sources":["../../src/commands/install-hooks.ts"],"names":[],"mappings":"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"}

package/dist/commands/sync.d.ts

@@ -0,0 +1,24 @@
+import type { ClientId } from "../types.js";
+import { readEnv } from "../lib/env.js";
+export interface SyncOptions {
+    readonly client: ClientId | "all";
+    readonly dryRun: boolean;
+}
+export interface SyncClientDiff {
+    readonly client: ClientId;
+    readonly path: string;
+    readonly action: "updated" | "no-change" | "skip" | "not-wired";
+    readonly updatedKeys: ReadonlyArray<string>;
+    readonly preservedKeys: ReadonlyArray<string>;
+    readonly reason?: string;
+}
+export interface SyncRunResult {
+    readonly clients: ReadonlyArray<SyncClientDiff>;
+    readonly applied: boolean;
+    readonly messages: ReadonlyArray<string>;
+}
+export interface SyncDependencies {
+    readonly envOverrides?: Parameters<typeof readEnv>[0];
+}
+export declare function runSync(options: SyncOptions, deps?: SyncDependencies): Promise<SyncRunResult>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAMxC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CACvD;AAID,wBAAsB,OAAO,CAC3B,OAAO,EAAE,WAAW,EACpB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,aAAa,CAAC,CA6DxB"}

package/dist/commands/sync.js

@@ -0,0 +1,179 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { readEnv } from "../lib/env.js";
+import { detectClients } from "../lib/paths.js";
+import { adapterFor } from "../clients/index.js";
+import { parseJsonSafely } from "../lib/json-patch.js";
+import { buildMcpServers, detectRepoRoot } from "../lib/mcp-entries.js";
+const NEURODOCK_PREFIX = "neurodock-";
+export async function runSync(options, deps = {}) {
+    const env = readEnv(deps.envOverrides ?? {});
+    const messages = [];
+    const detections = detectClients(env);
+    const targets = pickTargets(detections, options.client).filter((t) => t.exists);
+    if (targets.length === 0) {
+        messages.push("No client configs found to update.");
+        if (options.client !== "all") {
+            messages.push(`Looked for ${options.client} but no existing config was found.`);
+        }
+        return { clients: [], applied: false, messages };
+    }
+    const repoRoot = detectRepoRoot(env);
+    const desiredServers = buildMcpServers({
+        ...(repoRoot !== undefined ? { repoRoot } : {}),
+    });
+    const diffs = [];
+    for (const target of targets) {
+        diffs.push(diffClient(target, desiredServers));
+    }
+    if (options.dryRun) {
+        return {
+            clients: diffs,
+            applied: false,
+            messages: [
+                "Dry run. No changes written.",
+                ...messages,
+                ...formatDiffs(diffs),
+            ],
+        };
+    }
+    for (const d of diffs) {
+        if (d.action === "updated") {
+            applyDiff(d, desiredServers);
+            messages.push(`Updated ${d.client} at ${d.path}: ${d.updatedKeys.join(", ")}.`);
+        }
+        else if (d.action === "no-change") {
+            messages.push(`${d.client} at ${d.path} already up to date.`);
+        }
+        else if (d.action === "not-wired") {
+            messages.push(`${d.client} at ${d.path} has no NeuroDock servers wired. Run 'neurodock init' first.`);
+        }
+        else if (d.action === "skip") {
+            messages.push(`Skipped ${d.client} at ${d.path}: ${d.reason ?? "unable to parse"}.`);
+        }
+    }
+    return { clients: diffs, applied: true, messages };
+}
+function pickTargets(detections, client) {
+    if (client === "all")
+        return detections;
+    return detections.filter((d) => d.id === client);
+}
+function diffClient(target, desired) {
+    const raw = readFileSync(target.path, "utf8");
+    const parsed = parseJsonSafely(raw);
+    if (!parsed.ok) {
+        return {
+            client: target.id,
+            path: target.path,
+            action: "skip",
+            updatedKeys: [],
+            preservedKeys: [],
+            reason: `existing config is not valid JSON: ${parsed.error}`,
+        };
+    }
+    const existing = (parsed.value ?? {});
+    const existingServers = existing.mcpServers ?? {};
+    const allKeys = Object.keys(existingServers);
+    const neurodockKeys = allKeys.filter((k) => k.startsWith(NEURODOCK_PREFIX));
+    const preservedKeys = allKeys.filter((k) => !k.startsWith(NEURODOCK_PREFIX));
+    if (neurodockKeys.length === 0) {
+        return {
+            client: target.id,
+            path: target.path,
+            action: "not-wired",
+            updatedKeys: [],
+            preservedKeys,
+        };
+    }
+    const updatedKeys = [];
+    for (const key of neurodockKeys) {
+        const desiredEntry = desired[key];
+        if (desiredEntry === undefined)
+            continue;
+        if (!entriesEqual(existingServers[key], desiredEntry)) {
+            updatedKeys.push(key);
+        }
+    }
+    if (updatedKeys.length === 0) {
+        return {
+            client: target.id,
+            path: target.path,
+            action: "no-change",
+            updatedKeys: [],
+            preservedKeys,
+        };
+    }
+    return {
+        client: target.id,
+        path: target.path,
+        action: "updated",
+        updatedKeys,
+        preservedKeys,
+    };
+}
+function applyDiff(diff, desired) {
+    const adapter = adapterFor(diff.client);
+    const raw = readFileSync(diff.path, "utf8");
+    const parsed = parseJsonSafely(raw);
+    if (!parsed.ok)
+        return;
+    const existing = (parsed.value ?? {});
+    const existingServers = existing.mcpServers ?? {};
+    const nextServers = { ...existingServers };
+    for (const key of diff.updatedKeys) {
+        const next = desired[key];
+        if (next !== undefined)
+            nextServers[key] = next;
+    }
+    const shaped = adapter.shapeConfig(existing, nextServers);
+    mkdirSync(dirname(diff.path), { recursive: true });
+    writeFileSync(diff.path, `${JSON.stringify(shaped, null, 2)}\n`, "utf8");
+}
+function entriesEqual(a, b) {
+    if (a === undefined)
+        return false;
+    if (a.command !== b.command)
+        return false;
+    if (a.cwd !== b.cwd)
+        return false;
+    const aArgs = a.args ?? [];
+    const bArgs = b.args ?? [];
+    if (aArgs.length !== bArgs.length)
+        return false;
+    for (let i = 0; i < aArgs.length; i += 1) {
+        if (aArgs[i] !== bArgs[i])
+            return false;
+    }
+    return envEqual(a.env, b.env);
+}
+function envEqual(a, b) {
+    if (a === b)
+        return true;
+    const ka = a ? Object.keys(a).sort() : [];
+    const kb = b ? Object.keys(b).sort() : [];
+    if (ka.length !== kb.length)
+        return false;
+    for (let i = 0; i < ka.length; i += 1) {
+        const key = ka[i];
+        if (key !== kb[i])
+            return false;
+        if (key !== undefined && a?.[key] !== b?.[key])
+            return false;
+    }
+    return true;
+}
+function formatDiffs(diffs) {
+    const out = [];
+    for (const d of diffs) {
+        out.push(`Client ${d.client} (${d.action}): ${d.path}`);
+        for (const k of d.updatedKeys)
+            out.push(`  ~ mcpServers.${k}`);
+        for (const k of d.preservedKeys)
+            out.push(`  = mcpServers.${k} (preserved)`);
+        if (d.reason)
+            out.push(`  reason: ${d.reason}`);
+    }
+    return out;
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

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

package/dist/commands/update.d.ts

@@ -1,24 +1,15 @@
-import type { ClientId } from "../types.js";
-import { readEnv } from "../lib/env.js";
-export interface UpdateOptions {
-    readonly client: ClientId | "all";
-    readonly dryRun: boolean;
-}
-export interface UpdateClientDiff {
-    readonly client: ClientId;
-    readonly path: string;
-    readonly action: "updated" | "no-change" | "skip" | "not-wired";
-    readonly updatedKeys: ReadonlyArray<string>;
-    readonly preservedKeys: ReadonlyArray<string>;
-    readonly reason?: string;
-}
-export interface UpdateRunResult {
-    readonly clients: ReadonlyArray<UpdateClientDiff>;
-    readonly applied: boolean;
-    readonly messages: ReadonlyArray<string>;
-}
-export interface UpdateDependencies {
-    readonly envOverrides?: Parameters<typeof readEnv>[0];
-}
+import { type InstallAllOptions, type InstallAllDependencies, type InstallAllResult } from "./install-all.js";
+export type UpdateOptions = InstallAllOptions;
+export type UpdateDependencies = InstallAllDependencies;
+export type UpdateRunResult = InstallAllResult;
+/**
+ * `neurodock update` upgrades all NeuroDock MCP servers (pip/uv install
+ * --upgrade) and refreshes wired client configs. It is the same code
+ * path as `neurodock install-all` — re-running install IS the update
+ * mechanism. The dedicated verb exists because users look for it.
+ *
+ * The previous behavior of `update` (re-shape client configs only,
+ * without upgrading packages) moved to `neurodock sync` in 0.5.0.
+ */
 export declare function runUpdate(options: UpdateOptions, deps?: UpdateDependencies): Promise<UpdateRunResult>;
 //# sourceMappingURL=update.d.ts.map

package/dist/commands/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAMxC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CACvD;AAID,wBAAsB,SAAS,CAC7B,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,eAAe,CAAC,CA6D1B"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAC9C,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAE/C;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAE1B"}