devglow-mcp 1.0.1 → 1.0.4

package/build/deeplink.js

@@ -24,12 +24,14 @@ export async function startProject(id) {
 export async function stopProject(id) {
     await openDeepLink(buildUrl("stop", { id }));
 }
-export async function runProcess(name, path, command, port, source) {
+export async function runProcess(name, path, command, port, source, description) {
     const params = { name, path, command };
     if (port !== undefined)
         params.port = String(port);
     if (source)
         params.source = source;
+    if (description)
+        params.description = description;
     await openDeepLink(buildUrl("run", params));
 }
 export async function stopProcess(name) {
@@ -38,3 +40,9 @@ export async function stopProcess(name) {
 export async function exportLogs(id) {
     await openDeepLink(buildUrl("export-logs", { id }));
 }
+export async function updateProject(id, description) {
+    const params = { id };
+    if (description !== undefined)
+        params.description = description;
+    await openDeepLink(buildUrl("update-project", params));
+}

package/build/index.js

@@ -11,9 +11,12 @@ import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
 import { z } from "zod";
 import { loadProjects, loadAiProcesses, loadStatuses, loadExportedLogs, } from "./storage.js";
-import { startProject, stopProject, runProcess, stopProcess, exportLogs, } from "./deeplink.js";
+import { startProject, stopProject, runProcess, stopProcess, exportLogs, updateProject, } from "./deeplink.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+// --- Orphan process prevention constants ---
+const IDLE_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
+const IDLE_CHECK_INTERVAL_MS = 60 * 1000; // Check every 1 minute
 // --- Server factory ---
 // Each transport connection gets its own McpServer instance
 function createMcpServer() {
@@ -195,21 +198,47 @@ function createMcpServer() {
         title: "Run a new AI process",
         description: "Create and start a new temporary process. Shows in DevGlow's AI Processes section. User can later [keep] or [dismiss] it.",
         inputSchema: {
-            name: z.string().describe("Display name for the process"),
+            name: z.string().describe("Display name for the process. Do NOT include port number in the name — use the port parameter instead."),
             path: z.string().describe("Working directory (supports ~/)"),
             command: z.string().describe("Shell command to execute"),
             port: z
                 .number()
                 .optional()
                 .describe("Port number the process will listen on. Check package.json scripts or config files for --port flags. Important for DevGlow to show the correct port badge."),
+            description: z
+                .string()
+                .max(280)
+                .optional()
+                .describe("Short summary of what the app does (max 280 chars). Helps the user remember the project later. Write 1-2 plain sentences from the user's perspective."),
         },
-    }, async ({ name, path, command, port }) => {
+    }, async ({ name, path, command, port, description }) => {
         // Auto-detect port from command if not explicitly provided
         const resolvedPort = port ?? detectPortFromCommand(command);
-        await runProcess(name, path, command, resolvedPort, "claude");
+        await runProcess(name, path, command, resolvedPort, "claude", description);
         // Brief wait for DevGlow to register the process
         await new Promise((resolve) => setTimeout(resolve, 300));
-        const text = `AI process "${name}" started.\nCommand: ${command}\nPath: ${path}${resolvedPort ? `\nPort: ${resolvedPort}` : ""}`;
+        const text = `AI process "${name}" started.\nCommand: ${command}\nPath: ${path}${resolvedPort ? `\nPort: ${resolvedPort}` : ""}${description ? `\nDescription: ${description}` : ""}`;
+        return { content: [{ type: "text", text }] };
+    });
+    // ── Tool: update_project ──
+    server.registerTool("update_project", {
+        title: "Update a project's metadata",
+        description: "Update an existing DevGlow project's metadata (currently only description). Use this to fill in or refresh a project's description after registering it.",
+        inputSchema: {
+            id: z
+                .string()
+                .describe("Project id (call list_projects first to get the id)"),
+            description: z
+                .string()
+                .max(280)
+                .describe("Short summary of what the app does (max 280 chars). Pass an empty string to clear the existing description."),
+        },
+    }, async ({ id, description }) => {
+        await updateProject(id, description);
+        await new Promise((resolve) => setTimeout(resolve, 200));
+        const text = description
+            ? `Project ${id} description updated.`
+            : `Project ${id} description cleared.`;
         return { content: [{ type: "text", text }] };
     });
     // ── Tool: stop_process ──
@@ -383,6 +412,39 @@ async function main() {
         const transport = new StdioServerTransport();
         await mcpServer.connect(transport);
         console.error("devglow MCP server running on stdio");
+        // --- Orphan process prevention (stdio mode) ---
+        // When Claude Code exits abnormally, the npx → npm → node chain
+        // may not propagate stdin pipe close properly, leaving this process orphaned.
+        let lastActivityTime = Date.now();
+        let exiting = false;
+        let idleTimer;
+        function gracefulExit(reason) {
+            if (exiting)
+                return;
+            exiting = true;
+            console.error(`devglow-mcp: ${reason}, shutting down`);
+            clearInterval(idleTimer);
+            try {
+                mcpServer.close();
+            }
+            catch { }
+            process.exit(0);
+        }
+        // Track incoming messages for idle detection
+        process.stdin.on("data", () => {
+            lastActivityTime = Date.now();
+        });
+        // 1st defense: detect stdin pipe close (parent process gone)
+        process.stdin.resume();
+        process.stdin.on("end", () => gracefulExit("stdin ended"));
+        process.stdin.on("close", () => gracefulExit("stdin closed"));
+        // 2nd defense: idle timeout (no messages for 30 min)
+        idleTimer = setInterval(() => {
+            if (Date.now() - lastActivityTime >= IDLE_TIMEOUT_MS) {
+                gracefulExit(`idle timeout (${IDLE_TIMEOUT_MS / 60_000}m)`);
+            }
+        }, IDLE_CHECK_INTERVAL_MS);
+        idleTimer.unref();
     }
 }
 const MAX_BODY_SIZE = 1024 * 1024; // 1MB

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devglow-mcp",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "description": "MCP server for DevGlow — manage local dev processes through AI agents",
   "type": "module",
   "bin": {