@imenam/mcp-documentor 1.0.63 → 1.0.64

package/dist/src/index.js

@@ -81,6 +81,9 @@ storageEngine.setHistoryStore(historyStore);
 const syncEngine = new SyncEngine(storageEngine);
 const server = new Server({ name: "mcp-documentor", version: APP_VERSION }, { capabilities: { tools: {} } });
 let guiLauncher;
+let guiStatus = "disabled";
+let guiUrl = null;
+let guiStartWaiter = null;
 const sseControllers = new Set();
 function broadcastToGUI(message) {
     const child = guiLauncher.getProcess();
@@ -95,9 +98,15 @@ function broadcastToGUI(message) {
 }
 function handleIPCMessage(msg) {
     if (msg.type === "ALREADY_RUNNING") {
+        guiStatus = "already_running";
+        guiUrl = msg.data?.url ?? guiUrl;
+        guiStartWaiter?.({ outcome: "already_running", url: msg.data?.url });
         logger.info(`GUI is already running at: ${msg.data?.url || "unknown URL"}.`);
     }
     else if (msg.type === "READY") {
+        guiStatus = "ready";
+        guiUrl = msg.data?.url ?? null;
+        guiStartWaiter?.({ outcome: "ready", url: msg.data?.url });
         logger.info(`GUI is ready! Access it at: ${msg.data.url}`);
     }
     else if (msg.type === "GET_INITIAL_STATE") {
@@ -641,13 +650,70 @@ guiLauncher = new GuiLauncher({
         handleIPCMessage(msg);
     },
 });
+function startGuiWorker() {
+    guiStatus = "starting";
+    const child = guiLauncher.start();
+    child.on("exit", () => {
+        // Un start() ultérieur remplace le process courant : seul l'exit du process
+        // actif change l'état. ALREADY_RUNNING = la GUI vit dans une autre instance,
+        // l'exit du worker est alors attendu.
+        if (guiLauncher.getProcess() === child && guiStatus !== "already_running") {
+            guiStatus = "stopped";
+        }
+    });
+    return child;
+}
 function launchGUI() {
     if (!process.env.PROXY_URL) {
         logger.info('[MASTER] PROXY_URL non défini — GUI désactivée.');
+        guiStatus = "disabled";
         return;
     }
     logger.info("Launching GUI worker...");
-    guiLauncher.start();
+    startGuiWorker();
+}
+async function reconnectGui(args) {
+    getConfig(); // relit le .env au cas où PROXY_URL aurait été ajouté après le démarrage
+    if (!process.env.PROXY_URL) {
+        return {
+            content: [{ type: "text", text: "Error: PROXY_URL is not set — the GUI is disabled. Add PROXY_URL to the .env file, then call reconnect_gui again." }],
+            isError: true,
+        };
+    }
+    const child = guiLauncher.getProcess();
+    const alive = !!child && child.exitCode === null && !child.killed;
+    const force = args?.force === true;
+    if (alive && !force) {
+        if (guiStatus === "starting") {
+            return { content: [{ type: "text", text: "GUI worker is already starting (proxy registration in progress). Wait a few seconds, then call reconnect_gui again if needed." }] };
+        }
+        return { content: [{ type: "text", text: `GUI is already registered with the proxy${guiUrl ? ` at ${guiUrl}` : ""}. Nothing to do (use force=true to restart it anyway).` }] };
+    }
+    logger.info(`[MASTER] reconnect_gui: ${alive ? "restarting (force)" : "relaunching"} GUI worker...`);
+    const result = await new Promise((resolve) => {
+        const newChild = startGuiWorker();
+        const onExit = (code) => { cleanup(); resolve({ outcome: "exited", code }); };
+        const timer = setTimeout(() => { cleanup(); resolve({ outcome: "timeout" }); }, 15000);
+        const cleanup = () => { clearTimeout(timer); newChild.off("exit", onExit); guiStartWaiter = null; };
+        guiStartWaiter = (r) => { cleanup(); resolve(r); };
+        newChild.on("exit", onExit);
+    });
+    if (result.outcome === "ready") {
+        return { content: [{ type: "text", text: `GUI reconnected and registered with the proxy. URL: ${result.url}` }] };
+    }
+    if (result.outcome === "already_running") {
+        return { content: [{ type: "text", text: `GUI is already registered by another MCP instance. URL: ${result.url ?? "unknown"}` }] };
+    }
+    if (result.outcome === "exited") {
+        return {
+            content: [{ type: "text", text: `GUI worker exited before completing registration (code=${result.code}). The proxy server is probably still unreachable at ${process.env.PROXY_URL}. Start the proxy server, then call reconnect_gui again.` }],
+            isError: true,
+        };
+    }
+    return {
+        content: [{ type: "text", text: "GUI worker started but did not confirm proxy registration within 15s. Check the logs (.docs-data/logs), then retry." }],
+        isError: true,
+    };
 }
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     const tools = [
@@ -1083,6 +1149,16 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                 required: ["strategy"],
             },
         },
+        {
+            name: "reconnect_gui",
+            description: "Relaunch the GUI worker and re-register it with the proxy server. Use this when the proxy server was not running when the MCP server started (so the GUI registration failed), to redeploy the GUI without restarting the MCP server. Does nothing if the GUI is already registered, unless force=true.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    force: { type: "boolean", description: "Restart the GUI worker even if it is already running and registered (default: false)" },
+                },
+            },
+        },
     ];
     return {
         tools: isReadOnly() ? tools.filter((t) => !WRITE_TOOLS.has(t.name)) : tools,
@@ -1174,6 +1250,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 return await syncDocs(syncEngine, storageEngine, embeddingEngine, embeddingStore, args);
             case "resolve_sync_conflict":
                 return await resolveSyncConflict(syncEngine, args);
+            case "reconnect_gui":
+                return await reconnectGui(args);
             default:
                 throw new Error(`Tool not found: ${name}`);
         }

package/dist/src/version.d.ts

@@ -1 +1 @@
-export declare const APP_VERSION = "1.0.63";
+export declare const APP_VERSION = "1.0.64";

package/dist/src/version.js

@@ -1,2 +1,2 @@
 // Auto-generated version file - do not edit manually
-export const APP_VERSION = '1.0.63';
+export const APP_VERSION = '1.0.64';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imenam/mcp-documentor",
-  "version": "1.0.63",
+  "version": "1.0.64",
   "main": "dist/src/index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",