project-graph-mcp 2.4.0 → 2.4.2

package/README.md

@@ -10,7 +10,7 @@
 
 ![Compact mode — same file, 14 lines total, ↓40% tokens. Agents read and edit this directly.](https://raw.githubusercontent.com/rnd-pro/project-graph-mcp/main/docs/img/explorer-compact.jpg)
 
-Includes a built-in [Web Dashboard](#web-dashboard) (`npx project-graph-mcp serve`) to visualize token metrics and compact ⇄ raw code in real-time.
+The web dashboard has moved to [**mcp-agent-portal**](https://github.com/rnd-pro/mcp-agent-portal) — a unified MCP aggregator that includes project-graph-mcp as a child server with full visual UI.
 
 > [!TIP]
 > **18 MCP tools, zero config.** Add one line to your MCP config and the server downloads itself on the next IDE restart.
@@ -240,18 +240,13 @@ db({ action: "dead_tables", path: "src/" })
 
 ### Web Dashboard
 
-Every project-graph-mcp instance includes a built-in web UI at `http://localhost:{port}/`:
+> [!NOTE]
+> The web dashboard has moved to [**mcp-agent-portal**](https://github.com/rnd-pro/mcp-agent-portal). Install it with `npx mcp-agent-portal` to get the full visual UI: file tree, code viewer, dependency graph, live monitoring, and marketplace.
 
-- **Multi-project dashboard** — overview of all registered projects with token metrics
-- **File tree** — navigate project structure
-- **Code viewer** — compact/raw toggle with syntax highlighting and per-file compression stats
-- **Dependency graph** — visual dependency exploration
-- **Health panel** — analysis results
-- **Live monitor** — real-time agent activity via WebSocket
-
-
-
-With the optional gateway, all projects are accessible under `http://project-graph.local/{project-name}/`.
+```bash
+# Legacy serve command auto-redirects to mcp-agent-portal:
+npx project-graph-mcp serve .
+```
 
 ### Compression Metrics
 
@@ -364,18 +359,29 @@ npx project-graph-mcp help                # All commands
 
 ## MCP Ecosystem
 
-Best used together with [**agent-pool-mcp**](https://www.npmjs.com/package/agent-pool-mcp) — multi-agent task delegation via [Gemini CLI](https://github.com/google-gemini/gemini-cli):
+Best used as part of [**mcp-agent-portal**](https://github.com/rnd-pro/mcp-agent-portal) — a unified MCP aggregator that combines all RND-PRO servers behind a single config entry:
+
+```json
+{
+  "mcpServers": {
+    "agent-portal": {
+      "command": "npx",
+      "args": ["-y", "mcp-agent-portal"]
+    }
+  }
+}
+```
+
+> [!TIP]
+> One entry replaces separate configs for project-graph-mcp, agent-pool-mcp, and any other child servers.
 
-| Layer | project-graph-mcp | agent-pool-mcp |
-|-------|-------------------|----------------|
-| **Primary IDE agent** | Navigates codebase, runs analysis | Delegates tasks, consults peer |
-| **Gemini CLI workers** | Available as MCP tool inside workers | Executes delegated tasks |
+Also works standalone or alongside [**agent-pool-mcp**](https://www.npmjs.com/package/agent-pool-mcp) — multi-agent task delegation:
 
 ```bash
 # Generate configs with correct paths for both servers:
 npx -y project-graph-mcp config
 npx -y agent-pool-mcp config
-# Merge both outputs into your IDE's MCP config file.
+# Or use mcp-agent-portal which bundles both.
 ```
 
 > [!IMPORTANT]
@@ -391,6 +397,7 @@ npx -y agent-pool-mcp config
 - [ROADMAP.md](docs/ROADMAP.md) — Feature roadmap and backlog
 
 ## Related Projects
+- [mcp-agent-portal](https://github.com/rnd-pro/mcp-agent-portal) — Unified MCP aggregator + web dashboard + AI agent runtime
 - [agent-pool-mcp](https://github.com/rnd-pro/agent-pool-mcp) — Multi-agent orchestration via Gemini CLI
 - [Symbiote.js](https://github.com/symbiotejs/symbiote.js) — Isomorphic Reactive Web Components framework
 - [JSDA-Kit](https://github.com/rnd-pro/jsda-kit) — SSG/SSR toolkit for modern web applications

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-graph-mcp",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "type": "module",
   "description": "MCP server for AI agents — project graph, code quality analysis, visual web explorer. JS, TS, Python, Go.",
   "main": "src/network/server.js",

package/src/network/server.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // @ctx server.ctx
-import e from"node:path";import t from"node:fs";let _v="0.0.0";try{const _d=e.dirname(new URL(import.meta.url).pathname);_v=JSON.parse(t.readFileSync(e.join(_d,"..","..","package.json"),"utf8")).version}catch{}if(process.argv[1]&&(process.argv[1].endsWith("server.js")||process.argv[1].endsWith("project-graph-mcp"))){const[,,o,...r]=process.argv;if("serve"===o){const t=r[0]||".";console.log("\n  [redirect] UI has moved to 'agent-portal'.");console.log("  Running: npx agent-portal\n");const{spawn:s}=await import("child_process");s("npx",["agent-portal"],{stdio:"inherit",cwd:e.resolve(t)})}else if(o){const{runCLI:e}=await import("../cli/cli.js");e(o,r)}else if(process.env.PROJECT_GRAPH_BACKEND){const{startStdioServer:e}=await import("../mcp/mcp-server.js");console.error("Starting Project Graph MCP (stdio, direct)..."),e()}else{const{setRoots:e,getWorkspaceRoot:o}=await import("../core/workspace.js"),{ensureBackend:r,startStdioProxy:s}=await import("./backend-lifecycle.js"),{createInterface:i}=await import("node:readline"),n=t.createWriteStream("/tmp/pg-init-debug.log",{flags:"a"});n.write(`\n=== NEW SESSION ${(new Date).toISOString()} ===\n`);
+import e from"node:path";import t from"node:fs";let _v="0.0.0";try{const _d=e.dirname(new URL(import.meta.url).pathname);_v=JSON.parse(t.readFileSync(e.join(_d,"..","..","package.json"),"utf8")).version}catch{}if(process.argv[1]&&(process.argv[1].endsWith("server.js")||process.argv[1].endsWith("project-graph-mcp"))){const[,,o,...r]=process.argv;if("serve"===o){const t=r[0]||".";console.log("\n  [redirect] UI has moved to 'mcp-agent-portal'.");console.log("  Running: npx mcp-agent-portal\n");const{spawn:s}=await import("child_process");s("npx",["mcp-agent-portal"],{stdio:"inherit",cwd:e.resolve(t)})}else if(o){const{runCLI:e}=await import("../cli/cli.js");e(o,r)}else if(process.env.PROJECT_GRAPH_BACKEND){const{startStdioServer:e}=await import("../mcp/mcp-server.js");console.error("Starting Project Graph MCP (stdio, direct)..."),e()}else{const{setRoots:e,getWorkspaceRoot:o}=await import("../core/workspace.js"),{ensureBackend:r,startStdioProxy:s}=await import("./backend-lifecycle.js"),{createInterface:i}=await import("node:readline"),n=t.createWriteStream("/tmp/pg-init-debug.log",{flags:"a"});n.write(`\n=== NEW SESSION ${(new Date).toISOString()} ===\n`);
 const c=i({input:process.stdin,terminal:!1}),a=[];
 let l=!1,p=null,d=null;
 const startProxy=async e=>{if(!l){l=!0,c.removeAllListeners("line"),c.close(),n.write(`RESOLVED: ${e}\n`),n.end();try{const t=await r(e);console.error(`[project-graph] Connected to backend on port ${t} (project: ${e})`),s(t,a)}catch(e){console.error(`[project-graph] Singleton failed (${e.message}), falling back to direct stdio`);const{startStdioServer:t}=await import("../mcp/mcp-server.js");t(a)}}};c.on("line",t=>{try{const r=JSON.parse(t);if(n.write(`IN: ${r.method||`response:${r.id}`}\n`),"initialize"===r.method){d=r.id,r.params?.roots?.length>0&&(e(r.params.roots),n.write("ROOTS from initialize.params\n"));