codeloop-mcp-server 0.1.39 → 0.1.41

package/dist/tools/apply_update.js

@@ -0,0 +1,146 @@
+/**
+ * codeloop_apply_update — let the agent apply an in-session CodeLoop
+ * update without the user having to manually restart their IDE.
+ *
+ * How it actually works
+ * ---------------------
+ * The MCP server is spawned by Cursor / Claude Code via the
+ * `npx -y codeloop-mcp-server@latest` line in `mcp.json`. That npx
+ * spec re-resolves the `@latest` dist-tag every time the server
+ * starts, so a fresh spawn always pulls the latest published version.
+ *
+ * If we cleanly `process.exit(0)` the running server, the IDE's MCP
+ * client treats it as a normal disconnect and respawns the server on
+ * the next tool call. That respawn fetches the new version from npm
+ * automatically. End result: the running chat picks up the new
+ * CodeLoop version on its next tool call — no IDE restart required.
+ *
+ * This tool packages that flow into one deterministic call:
+ *   1. Returns a short, agent-runnable list of terminal commands the
+ *      agent should run in the user's terminal (so the user sees the
+ *      version bump happen with full transparency, and so the npx
+ *      tarball is warm for the next spawn).
+ *   2. Schedules a graceful `process.exit(0)` ~2 seconds after the
+ *      response is flushed. The delay gives the JSON-RPC channel
+ *      time to deliver the response cleanly before the disconnect.
+ *   3. Tells the agent exactly what to say to the user.
+ *
+ * Safety / fallbacks
+ * ------------------
+ * - `auto_respawn=false` (or `CODELOOP_DISABLE_AUTO_RESPAWN=1`)
+ *   suppresses the self-exit. The tool still returns the command
+ *   list and tells the agent to ask the user to restart manually.
+ *   Useful for environments where the MCP client does NOT respawn
+ *   exited servers (we have not seen this in the wild for Cursor /
+ *   Claude Code, but we keep the escape hatch).
+ * - The actual `process.exit` call is injected so tests can spy on
+ *   it without killing the test runner.
+ */
+import { z } from "zod";
+import { getUpdateInfo, } from "../auth/update_check.js";
+/** Injected so tests can stub it out instead of killing vitest. */
+let exitFn = (code) => process.exit(code);
+/** Test hook — production code does not call this. */
+export function _setExitForTests(fn) {
+    exitFn = fn;
+}
+/** Test hook — restore the real `process.exit`. */
+export function _resetExitForTests() {
+    exitFn = (code) => process.exit(code);
+}
+export const applyUpdateInputSchema = {
+    project_dir: z
+        .string()
+        .optional()
+        .describe("Workspace root. Optional; falls back to the MCP server's auto-discovered project root if omitted."),
+    workspace_root: z
+        .string()
+        .optional()
+        .describe("[Alias for project_dir] Same semantics; accepted because many agents reach for this conventional name."),
+    auto_respawn: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("When true (default), schedules the MCP server to exit gracefully ~2s after returning so Cursor / Claude Code respawns it with the latest version. Set to false to ONLY return the commands without triggering a respawn — useful when you want the user to confirm before the update lands."),
+};
+function buildPreWarmCommands() {
+    return [
+        {
+            cmd: "npx -y codeloop-mcp-server@latest --version",
+            purpose: "Pre-fetch the latest MCP server tarball into the npx cache so the upcoming respawn is instant.",
+        },
+        {
+            cmd: "npx -y codeloop@latest --version",
+            purpose: "Pre-fetch the latest CLI tarball so the user's next `npx codeloop ...` command runs without a 'need to install' prompt.",
+        },
+    ];
+}
+/**
+ * Pure implementation. Exported for tests to call without going
+ * through MCP. Production registration in index.ts wires this up via
+ * server.tool().
+ */
+export function applyUpdate(params) {
+    const info = getUpdateInfo();
+    const wantsRespawn = params.auto_respawn !== false;
+    const respawnDisabledByEnv = process.env.CODELOOP_DISABLE_AUTO_RESPAWN === "1";
+    if (!info || !info.is_outdated) {
+        return {
+            status: "up_to_date",
+            current: info?.current ?? null,
+            latest: info?.latest ?? null,
+            is_critical: false,
+            critical_reasons: [],
+            commands_to_run: [],
+            auto_respawn_scheduled: false,
+            respawn_eta_ms: null,
+            instructions: [
+                "No action needed — CodeLoop is already running the latest published version.",
+            ],
+            user_message: info && info.current
+                ? `CodeLoop is already on the latest version (${info.current}). Nothing to update.`
+                : "CodeLoop appears to be up to date. (Background update check has not completed yet — try again in a few seconds if you expected an update.)",
+        };
+    }
+    const commands = buildPreWarmCommands();
+    let respawnScheduled = false;
+    if (wantsRespawn && !respawnDisabledByEnv) {
+        respawnScheduled = true;
+        // Delay the exit so the JSON-RPC response is flushed to the
+        // MCP client BEFORE the stdio channel drops. 2s is comfortable
+        // for slow disks / busy event loops. We unref so the timer
+        // doesn't itself keep the process alive past the exit.
+        const timer = setTimeout(() => {
+            // stderr is safe (MCP uses stdout for JSON-RPC).
+            console.error(`[CodeLoop] Exiting to allow IDE to respawn with codeloop-mcp-server@${info.latest} (was ${info.current}).`);
+            exitFn(0);
+        }, 2_000);
+        if (typeof timer.unref === "function")
+            timer.unref();
+    }
+    const instructions = [
+        "Run each entry in `commands_to_run` in the user's terminal — in order — so the user sees the version bump happen with full transparency. The agent's Shell tool is the correct channel for this.",
+    ];
+    if (respawnScheduled) {
+        instructions.push("In ~2 seconds the MCP server will exit cleanly. Cursor / Claude Code will respawn it automatically on the next CodeLoop tool call, and the respawn pulls the latest version via `npx -y codeloop-mcp-server@latest`.", "The respawn is silent — you do NOT need to ask the user to restart Cursor / Claude Code. Just continue with the next CodeLoop tool call when ready; it will be served by the new version.", `Tell the user: "CodeLoop is updating in the background — your next CodeLoop call will run on v${info.latest}." Do not ask for permission to continue.`);
+    }
+    else {
+        instructions.push("Auto-respawn is disabled (either via the auto_respawn=false parameter or the CODELOOP_DISABLE_AUTO_RESPAWN=1 env var).", "After the commands finish, ask the user to restart Cursor / Claude Code to pick up the new MCP server version.");
+    }
+    const userMessageBody = info.is_critical
+        ? `CodeLoop has a CRITICAL update available (current ${info.current} → latest ${info.latest}). Reasons: ${info.critical_reasons.join("; ")}.`
+        : `CodeLoop has an update available (current ${info.current} → latest ${info.latest}).`;
+    return {
+        status: respawnScheduled ? "update_applying" : "update_skipped",
+        current: info.current,
+        latest: info.latest,
+        is_critical: info.is_critical,
+        critical_reasons: info.critical_reasons,
+        commands_to_run: commands,
+        auto_respawn_scheduled: respawnScheduled,
+        respawn_eta_ms: respawnScheduled ? 2_000 : null,
+        instructions,
+        user_message: userMessageBody,
+    };
+}
+//# sourceMappingURL=apply_update.js.map

package/dist/tools/apply_update.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeloop-mcp-server",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "description": "CodeLoop MCP server - verification, self-repair, and recommendation layer for AI coding agents",
   "type": "module",
   "main": "./dist/index.js",