@datafrog-io/n2n-nexus 0.1.4 → 0.1.6

package/README.md

@@ -45,6 +45,30 @@ Nexus_Storage/
 
 **Self-healing**: Core data files (e.g., `registry.json`, `discussion.json`) include automatic detection and repair mechanisms. If files are corrupted or missing, the system automatically rebuilds the initial state to ensure uninterrupted service.
 
+**Concurrency Safety (v0.1.6+)**: All write operations to shared files (`discussion.json`, `registry.json`) are protected by an `AsyncMutex` lock, preventing race conditions when multiple AI agents communicate simultaneously.
+
+## 🏷️ Project ID Conventions (Naming Standard)
+
+To ensure clarity and prevent collisions in the flat local namespace, all Project IDs MUST follow the **Prefix Dictionary** format: `[prefix]_[project-name]`.
+
+| Prefix | Category | Example |
+| :--- | :--- | :--- |
+| `web_` | Websites, landing pages, domain-based projects | `web_datafrog.io` |
+| `api_` | Backend services, REST/gRPC APIs | `api_user-auth` |
+| `chrome_` | Chrome extensions | `chrome_evisa-helper` |
+| `vscode_` | VSCode extensions | `vscode_super-theme` |
+| `mcp_` | MCP Servers and MCP-related tools | `mcp_github-repo` |
+| `android_` | Native Android projects (Kotlin/Java) | `android_client-app` |
+| `ios_` | Native iOS projects (Swift/ObjC) | `ios_client-app` |
+| `flutter_` | **Mobile Cross-platform Special Case** | `flutter_unified-app` |
+| `desktop_` | General desktop apps (Tauri, Electron, etc.) | `desktop_main-hub` |
+| `lib_` | Shared libraries, SDKs, NPM/Python packages | `lib_crypto-core` |
+| `bot_` | Bots (Discord, Slack, DingTalk, etc.) | `bot_auto-moderator` |
+| `infra_` | Infrastructure as Code, CI/CD, DevOps scripts | `infra_k8s-config` |
+| `doc_` | Pure technical handbooks, strategies, roadmaps | `doc_coding-guide` |
+
+---
+
 ## 🛠️ Toolset
 
 ### A. Session & Context
@@ -54,6 +78,7 @@ Nexus_Storage/
 ### B. Project Asset Management
 - `sync_project_assets`: **[Core]** Submit full Project Manifest and Internal Docs.
     - **Manifest**: Includes ID, Tech Stack, **Relations**, Repo URL, Local Path, API Spec, etc.
+    - **Schema v2.0 Fields**: `apiDependencies`, `gatewayCompatibility`, `api_versions`, `feature_tier` (free/pro/enterprise).
 - `update_project`: Partially update Manifest fields (e.g., endpoints or description only).
 - `rename_project`: Rename Project ID with automatic cascading updates to all dependency references.
 - `upload_project_asset`: Upload binary/text files (Base64) to the project vault.

package/build/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
 import { CONFIG } from "./config.js";
 import { StorageManager } from "./storage/index.js";
 import { TOOL_DEFINITIONS, handleToolCall } from "./tools/index.js";
@@ -15,7 +15,7 @@ class NexusServer {
     server;
     currentProject = null;
     constructor() {
-        this.server = new Server({ name: "n2n-nexus", version: "0.1.4" }, { capabilities: { resources: {}, tools: {} } });
+        this.server = new Server({ name: "n2n-nexus", version: "0.1.5" }, { capabilities: { resources: {}, tools: {}, prompts: {} } });
         this.setupHandlers();
     }
     /**
@@ -76,7 +76,10 @@ class NexusServer {
                     this.checkModerator(name);
                 const result = await handleToolCall(name, toolArgs, {
                     currentProject: this.currentProject,
-                    setCurrentProject: (id) => { this.currentProject = id; }
+                    setCurrentProject: (id) => { this.currentProject = id; },
+                    notifyResourceUpdate: (uri) => {
+                        this.server.sendResourceUpdated({ uri });
+                    }
                 });
                 return result;
             }
@@ -90,6 +93,48 @@ class NexusServer {
                 };
             }
         });
+        // --- Prompt Listing ---
+        this.server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+            prompts: [
+                {
+                    name: "init_project_nexus",
+                    description: "Step-by-step guide for registering a new project with proper ID naming conventions.",
+                    arguments: [
+                        { name: "projectType", description: "Type: web, api, chrome, vscode, mcp, android, ios, flutter, desktop, lib, bot, infra, doc", required: true },
+                        { name: "technicalName", description: "Domain (e.g., example.com) or repo slug (e.g., my-library)", required: true }
+                    ]
+                }
+            ]
+        }));
+        // --- Prompt Retrieval ---
+        this.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            if (name === "init_project_nexus") {
+                const projectType = args?.projectType || "[TYPE]";
+                const technicalName = args?.technicalName || "[NAME]";
+                const projectId = `${projectType}_${technicalName}`;
+                return {
+                    description: "Initialize a new Nexus project",
+                    messages: [
+                        {
+                            role: "user",
+                            content: {
+                                type: "text",
+                                text: `I want to register a new project in Nexus.\n\n**Project Type:** ${projectType}\n**Technical Name:** ${technicalName}`
+                            }
+                        },
+                        {
+                            role: "assistant",
+                            content: {
+                                type: "text",
+                                text: `## Project ID Convention\n\nBased on your input, the correct Project ID is:\n\n\`\`\`\n${projectId}\n\`\`\`\n\n### Prefix Dictionary\n| Prefix | Use Case |\n|--------|----------|\n| web_ | Websites/Domains |\n| api_ | Backend Services |\n| chrome_ | Chrome Extensions |\n| vscode_ | VSCode Extensions |\n| mcp_ | MCP Servers |\n| android_ | Native Android |\n| ios_ | Native iOS |\n| flutter_ | Cross-platform Mobile |\n| desktop_ | Desktop Apps |\n| lib_ | Libraries/SDKs |\n| bot_ | Bots |\n| infra_ | Infrastructure as Code |\n| doc_ | Technical Docs |\n\n### Next Steps\n1. Call \`register_session_context\` with projectId: \`${projectId}\`\n2. Call \`sync_project_assets\` with your manifest and internal docs.`
+                            }
+                        }
+                    ]
+                };
+            }
+            throw new McpError(ErrorCode.InvalidRequest, `Unknown prompt: ${name}`);
+        });
     }
     async run() {
         const transport = new StdioServerTransport();

package/build/resources/index.js

@@ -57,11 +57,20 @@ export async function listResources() {
             { uri: "mcp://hub/registry", name: "Global Project Registry", description: "Consolidated index of all local projects." },
             { uri: "mcp://docs/global-strategy", name: "Master Strategy Blueprint", description: "Top-level cross-project coordination." },
             { uri: "mcp://nexus/session", name: "Current Session Info", description: "Your identity and role in this Nexus instance." },
-            ...projectIds.map(id => ({
-                uri: `mcp://hub/projects/${id}/manifest`,
-                name: `Manifest: ${id}`,
-                description: `Structured metadata (Tech stack, relations) for ${id}`
-            }))
+            ...projectIds.map(id => {
+                const prefix = id.split("_")[0];
+                const typeLabel = {
+                    web: "🌐 Website", api: "⚙️ API", chrome: "🧩 Chrome Ext",
+                    vscode: "💻 VSCode Ext", mcp: "🔌 MCP Server", android: "📱 Android",
+                    ios: "🍎 iOS", flutter: "📲 Flutter", desktop: "🖥️ Desktop",
+                    lib: "📦 Library", bot: "🤖 Bot", infra: "☁️ Infra", doc: "📄 Docs"
+                }[prefix] || "📁 Project";
+                return {
+                    uri: `mcp://hub/projects/${id}/manifest`,
+                    name: `${typeLabel}: ${id}`,
+                    description: `Structured metadata (Tech stack, relations) for ${id}`
+                };
+            })
         ],
         resourceTemplates: [
             { uriTemplate: "mcp://hub/projects/{projectId}/internal-docs", name: "Internal Project Docs", description: "Markdown-based detailed implementation plans." }

package/build/storage/index.js

@@ -1,7 +1,45 @@
 import { promises as fs } from "fs";
 import path from "path";
 import { CONFIG } from "../config.js";
+/**
+ * Simple mutex lock for preventing concurrent file writes.
+ * Ensures that only one write operation can happen at a time.
+ */
+class AsyncMutex {
+    locked = false;
+    queue = [];
+    async acquire() {
+        if (!this.locked) {
+            this.locked = true;
+            return;
+        }
+        return new Promise((resolve) => {
+            this.queue.push(resolve);
+        });
+    }
+    release() {
+        if (this.queue.length > 0) {
+            const next = this.queue.shift();
+            next?.();
+        }
+        else {
+            this.locked = false;
+        }
+    }
+    async withLock(fn) {
+        await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+}
 export class StorageManager {
+    // --- Concurrency Control ---
+    static discussionLock = new AsyncMutex();
+    static registryLock = new AsyncMutex();
     // --- Path Definitions ---
     static get globalDir() { return path.join(CONFIG.rootStorage, "global"); }
     static get globalBlueprint() { return path.join(this.globalDir, "blueprint.md"); }
@@ -62,6 +100,10 @@ export class StorageManager {
             return null;
         return JSON.parse(await fs.readFile(p, "utf-8"));
     }
+    /**
+     * Save a project manifest and update the global registry.
+     * Uses mutex lock to prevent concurrent registry write conflicts.
+     */
     static async saveProjectManifest(manifest) {
         const id = manifest.id;
         if (!id)
@@ -69,14 +111,16 @@ export class StorageManager {
         const projectDir = path.join(this.projectsRoot, id);
         await fs.mkdir(projectDir, { recursive: true });
         await fs.writeFile(path.join(projectDir, "manifest.json"), JSON.stringify(manifest, null, 2));
-        // Update global registry
-        const registry = await this.listRegistry();
-        registry.projects[id] = {
-            name: manifest.name,
-            summary: manifest.description,
-            lastActive: new Date().toISOString()
-        };
-        await fs.writeFile(this.registryFile, JSON.stringify(registry, null, 2));
+        // Update global registry with lock
+        await this.registryLock.withLock(async () => {
+            const registry = await this.listRegistry();
+            registry.projects[id] = {
+                name: manifest.name,
+                summary: manifest.description,
+                lastActive: new Date().toISOString()
+            };
+            await fs.writeFile(this.registryFile, JSON.stringify(registry, null, 2));
+        });
     }
     static async saveAsset(id, fileName, content) {
         if (!id || !fileName)
@@ -103,10 +147,25 @@ export class StorageManager {
         return { nodes, edges };
     }
     // --- Discussion & Log Management ---
-    static async addGlobalLog(from, text) {
+    /**
+     * Add a message to the global discussion log.
+     * Uses mutex lock to prevent concurrent write conflicts.
+     */
+    static async addGlobalLog(from, text, category) {
+        await this.discussionLock.withLock(async () => {
+            const logs = await this.loadJsonSafe(this.globalDiscussion, []);
+            logs.push({
+                timestamp: new Date().toISOString(),
+                from,
+                text,
+                category
+            });
+            await fs.writeFile(this.globalDiscussion, JSON.stringify(logs, null, 2));
+        });
+    }
+    static async getRecentLogs(count = 10) {
         const logs = await this.loadJsonSafe(this.globalDiscussion, []);
-        logs.push({ timestamp: new Date().toISOString(), from, text });
-        await fs.writeFile(this.globalDiscussion, JSON.stringify(logs, null, 2));
+        return logs.slice(-count);
     }
     static async getProjectDocs(id) {
         if (!id)
@@ -124,12 +183,24 @@ export class StorageManager {
     static async listRegistry() {
         return this.loadJsonSafe(this.registryFile, { projects: {} });
     }
+    /**
+     * Prune global logs, keeping only messages after the specified count.
+     * Uses mutex lock to prevent concurrent write conflicts.
+     */
     static async pruneGlobalLogs(count) {
-        const logs = await this.loadJsonSafe(this.globalDiscussion, []);
-        await fs.writeFile(this.globalDiscussion, JSON.stringify(logs.slice(count), null, 2));
+        await this.discussionLock.withLock(async () => {
+            const logs = await this.loadJsonSafe(this.globalDiscussion, []);
+            await fs.writeFile(this.globalDiscussion, JSON.stringify(logs.slice(count), null, 2));
+        });
     }
+    /**
+     * Clear all global logs.
+     * Uses mutex lock to prevent concurrent write conflicts.
+     */
     static async clearGlobalLogs() {
-        await fs.writeFile(this.globalDiscussion, "[]");
+        await this.discussionLock.withLock(async () => {
+            await fs.writeFile(this.globalDiscussion, "[]");
+        });
     }
     // --- Global Document Management ---
     static get globalDocsDir() { return path.join(this.globalDir, "docs"); }
@@ -219,34 +290,56 @@ export class StorageManager {
             manifest.id = newId;
             await fs.writeFile(manifestPath, JSON.stringify(manifest, null, 2), "utf-8");
         }
-        // 3. Update registry
-        const registry = await this.listRegistry();
-        if (registry.projects[oldId]) {
-            registry.projects[newId] = registry.projects[oldId];
-            delete registry.projects[oldId];
-            await fs.writeFile(this.registryFile, JSON.stringify(registry, null, 2), "utf-8");
-        }
-        // 4. Cascade: Update relations in ALL other projects
+        // 3. Update registry with lock and cascade updates
         let updatedCount = 0;
-        const projectIds = Object.keys(registry.projects);
-        for (const id of projectIds) {
-            if (id === newId)
-                continue; // Skip the renamed project itself
-            const otherManifest = await this.getProjectManifest(id);
-            if (!otherManifest || !otherManifest.relations)
-                continue;
-            let changed = false;
-            for (const rel of otherManifest.relations) {
-                if (rel.targetId === oldId) {
-                    rel.targetId = newId;
-                    changed = true;
+        await this.registryLock.withLock(async () => {
+            const registry = await this.listRegistry();
+            if (registry.projects[oldId]) {
+                registry.projects[newId] = registry.projects[oldId];
+                delete registry.projects[oldId];
+                await fs.writeFile(this.registryFile, JSON.stringify(registry, null, 2), "utf-8");
+            }
+            // 4. Cascade: Update relations in ALL other projects
+            const projectIds = Object.keys(registry.projects);
+            for (const id of projectIds) {
+                if (id === newId)
+                    continue; // Skip the renamed project itself
+                const otherManifest = await this.getProjectManifest(id);
+                if (!otherManifest || !otherManifest.relations)
+                    continue;
+                let changed = false;
+                for (const rel of otherManifest.relations) {
+                    if (rel.targetId === oldId) {
+                        rel.targetId = newId;
+                        changed = true;
+                    }
+                }
+                if (changed) {
+                    // Note: saveProjectManifest will try to acquire registryLock again,
+                    // but since we're already holding it, we write directly here
+                    const projectDir = path.join(this.projectsRoot, id);
+                    await fs.writeFile(path.join(projectDir, "manifest.json"), JSON.stringify(otherManifest, null, 2));
+                    updatedCount++;
                 }
             }
-            if (changed) {
-                await this.saveProjectManifest(otherManifest);
-                updatedCount++;
+        });
+        return updatedCount;
+    }
+    /**
+     * Delete a project from the registry and disk.
+     * Uses mutex lock to prevent concurrent registry write conflicts.
+     */
+    static async deleteProject(id) {
+        await this.registryLock.withLock(async () => {
+            const registry = await this.listRegistry();
+            if (registry.projects[id]) {
+                delete registry.projects[id];
+                await fs.writeFile(this.registryFile, JSON.stringify(registry, null, 2), "utf-8");
             }
+        });
+        const projectDir = path.join(this.projectsRoot, id);
+        if (await this.exists(projectDir)) {
+            await fs.rm(projectDir, { recursive: true, force: true });
         }
-        return updatedCount;
     }
 }

package/build/tools/definitions.js

@@ -4,12 +4,21 @@
 export const TOOL_DEFINITIONS = [
     {
         name: "register_session_context",
-        description: "Declare the project you are currently working on in this IDE session.",
-        inputSchema: { type: "object", properties: { projectId: { type: "string" } }, required: ["projectId"] }
+        description: "[IDENTITY] Declare the PROJECT identity. Format: [prefix]_[technical-identifier]. (e.g., 'web_datafrog.io', 'mcp_nexus-core').",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectId: {
+                    type: "string",
+                    description: "Strict flat identifier. MUST start with a type-prefix (web_, api_, chrome_, vscode_, mcp_, android_, ios_, flutter_, desktop_, lib_, bot_, infra_, doc_) followed by an underscore and a technical name (Domain for websites, Repo name/Slug for code). Use kebab-case. No hierarchy dots except in domains."
+                }
+            },
+            required: ["projectId"]
+        }
     },
     {
         name: "sync_project_assets",
-        description: "CRITICAL: Sync full project state. Both manifest and documentation are MANDATORY.",
+        description: "CRITICAL: [PREREQUISITE: register_session_context] Sync full project state. Both manifest and documentation are MANDATORY.",
         inputSchema: {
             type: "object",
             properties: {
@@ -17,7 +26,7 @@ export const TOOL_DEFINITIONS = [
                     type: "object",
                     description: "Full ProjectManifest metadata.",
                     properties: {
-                        id: { type: "string" },
+                        id: { type: "string", description: "Project ID. MUST follow '[prefix]_[technical-name]' format and match active session." },
                         name: { type: "string" },
                         description: { type: "string" },
                         techStack: { type: "array", items: { type: "string" } },
@@ -26,13 +35,13 @@ export const TOOL_DEFINITIONS = [
                             items: {
                                 type: "object",
                                 properties: {
-                                    targetId: { type: "string" },
+                                    targetId: { type: "string", description: "ID of the target project (e.g., 'acme.auth-service')." },
                                     type: { type: "string", enum: ["dependency", "parent", "child", "related"] }
                                 },
                                 required: ["targetId", "type"]
                             }
                         },
-                        lastUpdated: { type: "string", description: "ISO timestamp." },
+                        lastUpdated: { type: "string", description: "ISO timestamp (e.g., 2025-12-29T...)." },
                         repositoryUrl: { type: "string", description: "GitHub repository URL." },
                         endpoints: {
                             type: "array",
@@ -81,7 +90,12 @@ export const TOOL_DEFINITIONS = [
     },
     {
         name: "get_global_topology",
-        description: "Retrieve complete project relationship graph.",
+        description: "Retrieve complete project relationship graph. Use this to understand current IDs and their connections.",
+        inputSchema: { type: "object", properties: {} }
+    },
+    {
+        name: "list_projects",
+        description: "List all existing projects registered in the Nexus Hub. Use this to find correct IDs before performing project-specific operations.",
         inputSchema: { type: "object", properties: {} }
     },
     {
@@ -90,7 +104,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: "object",
             properties: {
-                projectId: { type: "string", description: "Project identifier (e.g., 'n2ns.com.backend')" },
+                projectId: { type: "string", description: "Project ID (e.g., 'web_datafrog.io', 'mcp_nexus-hub')." },
                 include: {
                     type: "string",
                     enum: ["manifest", "docs", "repo", "endpoints", "api", "relations", "summary", "all"],
@@ -102,8 +116,29 @@ export const TOOL_DEFINITIONS = [
     },
     {
         name: "post_global_discussion",
-        description: "Broadcast a message. Content is MANDATORY.",
-        inputSchema: { type: "object", properties: { message: { type: "string" } }, required: ["message"] }
+        description: "Join the 'Nexus Meeting Room' to collaborate with other AI agents. Use this for initiating meetings, making cross-project proposals, or announcing key decisions. Every message is shared across all assistants in real-time.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                message: { type: "string", description: "The core content of your speech, proposal, or announcement." },
+                category: {
+                    type: "string",
+                    enum: ["MEETING_START", "PROPOSAL", "DECISION", "UPDATE", "CHAT"],
+                    description: "The nature of this message. Use MEETING_START to call for a synchronous discussion."
+                }
+            },
+            required: ["message"]
+        }
+    },
+    {
+        name: "read_recent_discussion",
+        description: "Quickly 'listen' to the last few messages in the Nexus Room to catch up on the context of the current meeting or collaboration.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                count: { type: "number", description: "Number of recent messages to retrieve (defaults to 10).", default: 10 }
+            }
+        }
     },
     {
         name: "update_global_strategy",
@@ -145,7 +180,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: "object",
             properties: {
-                projectId: { type: "string", description: "Project ID to update" },
+                projectId: { type: "string", description: "Project ID to update (e.g., 'web_datafrog.io')." },
                 patch: {
                     type: "object",
                     description: "Fields to update (e.g., description, techStack, endpoints, apiSpec, relations)",
@@ -161,8 +196,8 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: "object",
             properties: {
-                oldId: { type: "string", description: "Current project ID" },
-                newId: { type: "string", description: "New project ID" }
+                oldId: { type: "string", description: "Current project ID (e.g., 'web_oldname.com')." },
+                newId: { type: "string", description: "New project ID following the '[prefix]_[name]' standard." }
             },
             required: ["oldId", "newId"]
         }
@@ -178,5 +213,16 @@ export const TOOL_DEFINITIONS = [
             },
             required: ["action", "count"]
         }
+    },
+    {
+        name: "delete_project",
+        description: "[ADMIN ONLY] Completely remove a project, its manifest, and all its assets from Nexus.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectId: { type: "string", description: "The ID of the project to destroy." }
+            },
+            required: ["projectId"]
+        }
     }
 ];

package/build/tools/handlers.js

@@ -2,6 +2,18 @@ import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
 import { promises as fs } from "fs";
 import { CONFIG } from "../config.js";
 import { StorageManager } from "../storage/index.js";
+/**
+ * Validation helper for Project IDs.
+ */
+function validateProjectId(id) {
+    if (!id)
+        throw new McpError(ErrorCode.InvalidParams, "Project ID cannot be empty.");
+    const validPrefixes = ["web_", "api_", "chrome_", "vscode_", "mcp_", "android_", "ios_", "flutter_", "desktop_", "lib_", "bot_", "infra_", "doc_"];
+    const hasPrefix = validPrefixes.some(p => id.startsWith(p));
+    if (!hasPrefix || id.includes("..") || id.startsWith("/") || id.endsWith("/")) {
+        throw new McpError(ErrorCode.InvalidParams, "Project ID must follow the standard '[prefix]_[technical-name]' format and cannot contain '..' or slashes.");
+    }
+}
 /**
  * Handles all tool executions
  */
@@ -20,8 +32,10 @@ export async function handleToolCall(name, toolArgs, ctx) {
             return handleReadProject(toolArgs);
         case "post_global_discussion":
             return handlePostDiscussion(toolArgs, ctx);
+        case "read_recent_discussion":
+            return handleReadRecentDiscussion(toolArgs);
         case "update_global_strategy":
-            return handleUpdateStrategy(toolArgs);
+            return handleUpdateStrategy(toolArgs, ctx);
         case "sync_global_doc":
             return handleSyncGlobalDoc(toolArgs);
         case "list_global_docs":
@@ -31,9 +45,13 @@ export async function handleToolCall(name, toolArgs, ctx) {
         case "update_project":
             return handleUpdateProject(toolArgs);
         case "rename_project":
-            return handleRenameProject(toolArgs);
+            return handleRenameProject(toolArgs, ctx);
+        case "list_projects":
+            return handleListProjects();
+        case "delete_project":
+            return handleRemoveProject(toolArgs, ctx);
         case "moderator_maintenance":
-            return handleModeratorMaintenance(toolArgs);
+            return handleModeratorMaintenance(toolArgs, ctx);
         default:
             throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
     }
@@ -42,6 +60,7 @@ export async function handleToolCall(name, toolArgs, ctx) {
 function handleRegisterSession(args, ctx) {
     if (!args?.projectId)
         throw new McpError(ErrorCode.InvalidParams, "Missing required parameter: projectId");
+    validateProjectId(args.projectId);
     ctx.setCurrentProject(args.projectId);
     return { content: [{ type: "text", text: `Active Nexus Context: ${args.projectId}` }] };
 }
@@ -53,18 +72,24 @@ async function handleSyncProjectAssets(args, ctx) {
         throw new McpError(ErrorCode.InvalidParams, "Both 'manifest' and 'internalDocs' are mandatory.");
     }
     const m = args.manifest;
-    if (!m.id || !m.name || !m.description || !m.techStack || !m.relations || !m.lastUpdated || !m.repositoryUrl || !m.localPath || !m.endpoints || !m.apiSpec) {
-        throw new McpError(ErrorCode.InvalidParams, "Project manifest incomplete. Required: id, name, description, techStack, relations, lastUpdated, repositoryUrl, localPath, endpoints, apiSpec.");
-    }
-    if (m.id.includes("..") || m.id.startsWith("/") || m.id.endsWith("/")) {
-        throw new McpError(ErrorCode.InvalidParams, "Project ID cannot contain '..' or start/end with '/'. Use '/' for namespacing (e.g., 'parent/child').");
+    const requiredFields = ["id", "name", "description", "techStack", "relations", "lastUpdated", "repositoryUrl", "localPath", "endpoints", "apiSpec"];
+    for (const field of requiredFields) {
+        if (m[field] === undefined || m[field] === null) {
+            throw new McpError(ErrorCode.InvalidParams, `Project manifest incomplete. Missing field: ${field}`);
+        }
     }
+    validateProjectId(m.id);
     if (!await StorageManager.exists(m.localPath)) {
         throw new McpError(ErrorCode.InvalidParams, `localPath does not exist: '${m.localPath}'. Please provide a valid directory path.`);
     }
     await StorageManager.saveProjectManifest(m);
     await StorageManager.saveProjectDocs(ctx.currentProject, args.internalDocs);
     await StorageManager.addGlobalLog("SYSTEM", `[${CONFIG.instanceId}@${ctx.currentProject}] Asset Sync: Full sync of manifest and docs.`);
+    // Notify updates
+    ctx.notifyResourceUpdate(`mcp://hub/projects/${m.id}/manifest`);
+    ctx.notifyResourceUpdate(`mcp://hub/projects/${m.id}/internal-docs`);
+    ctx.notifyResourceUpdate("mcp://hub/registry");
+    ctx.notifyResourceUpdate("mcp://chat/global");
     return { content: [{ type: "text", text: "Project assets synchronized (Manifest + Docs)." }] };
 }
 async function handleUploadAsset(args, ctx) {
@@ -140,14 +165,16 @@ async function handleUpdateProject(args) {
     const changedFields = Object.keys(args.patch).join(", ");
     return { content: [{ type: "text", text: `Project '${args.projectId}' updated. Changed fields: ${changedFields}.` }] };
 }
-async function handleRenameProject(args) {
+async function handleRenameProject(args, ctx) {
     if (!args?.oldId || !args?.newId) {
         throw new McpError(ErrorCode.InvalidParams, "Both 'oldId' and 'newId' are required.");
     }
-    if (args.newId.includes("..") || args.newId.startsWith("/") || args.newId.endsWith("/")) {
-        throw new McpError(ErrorCode.InvalidParams, "New ID cannot contain '..' or start/end with '/'.");
-    }
+    validateProjectId(args.newId);
     const updatedCount = await StorageManager.renameProject(args.oldId, args.newId);
+    // Notify all affected project resources and registry
+    ctx.notifyResourceUpdate("mcp://hub/registry");
+    ctx.notifyResourceUpdate(`mcp://hub/projects/${args.newId}/manifest`);
+    ctx.notifyResourceUpdate("mcp://get_global_topology"); // Topology changed
     return { content: [{ type: "text", text: `Project renamed: '${args.oldId}' → '${args.newId}'. Cascading updates: ${updatedCount} project(s).` }] };
 }
 // --- Global Handlers ---
@@ -158,16 +185,32 @@ async function handleGetTopology() {
 async function handlePostDiscussion(args, ctx) {
     if (!args?.message)
         throw new McpError(ErrorCode.InvalidParams, "Message content cannot be empty.");
-    await StorageManager.addGlobalLog(`${CONFIG.instanceId}@${ctx.currentProject || "Global"}`, args.message);
-    return { content: [{ type: "text", text: "Message broadcasted." }] };
+    await StorageManager.addGlobalLog(`${CONFIG.instanceId}@${ctx.currentProject || "Global"}`, args.message, args.category);
+    // Notify chat resource update
+    ctx.notifyResourceUpdate("mcp://chat/global");
+    return { content: [{ type: "text", text: `Message broadcasted to Nexus Room${args.category ? ` [${args.category}]` : ""}.` }] };
+}
+async function handleReadRecentDiscussion(args) {
+    const count = args?.count || 10;
+    const logs = await StorageManager.getRecentLogs(count);
+    return { content: [{ type: "text", text: JSON.stringify(logs, null, 2) }] };
 }
-async function handleUpdateStrategy(args) {
+async function handleUpdateStrategy(args, ctx) {
     if (!args?.content)
         throw new McpError(ErrorCode.InvalidParams, "Strategy content cannot be empty.");
     await fs.writeFile(StorageManager.globalBlueprint, args.content);
     await StorageManager.addGlobalLog("SYSTEM", `[${CONFIG.instanceId}] Updated Coordination Strategy.`);
+    // Notify strategy update
     return { content: [{ type: "text", text: "Strategy updated." }] };
 }
+async function handleRemoveProject(args, ctx) {
+    if (!args?.projectId)
+        throw new McpError(ErrorCode.InvalidParams, "projectId is required.");
+    await StorageManager.deleteProject(args.projectId);
+    ctx.notifyResourceUpdate("mcp://hub/registry");
+    ctx.notifyResourceUpdate("mcp://get_global_topology");
+    return { content: [{ type: "text", text: `Project '${args.projectId}' removed from Nexus.` }] };
+}
 async function handleSyncGlobalDoc(args) {
     if (!args?.docId || !args?.title || !args?.content) {
         throw new McpError(ErrorCode.InvalidParams, "All fields required: docId, title, content.");
@@ -189,17 +232,30 @@ async function handleReadGlobalDoc(args) {
     return { content: [{ type: "text", text: content }] };
 }
 // --- Admin Handlers ---
-async function handleModeratorMaintenance(args) {
+async function handleListProjects() {
+    const registry = await StorageManager.listRegistry();
+    const projects = Object.entries(registry.projects).map(([id, p]) => ({
+        id,
+        name: p.name,
+        summary: p.summary,
+        lastActive: p.lastActive
+    }));
+    return { content: [{ type: "text", text: JSON.stringify(projects, null, 2) }] };
+}
+// --- Admin Handlers ---
+async function handleModeratorMaintenance(args, ctx) {
     if (!args.action || args.count === undefined) {
         throw new McpError(ErrorCode.InvalidParams, "Both 'action' and 'count' are mandatory for maintenance.");
     }
     if (args.action === "clear") {
         await StorageManager.clearGlobalLogs();
+        ctx.notifyResourceUpdate("mcp://chat/global");
         return { content: [{ type: "text", text: "History wiped." }] };
     }
     else {
         try {
             await StorageManager.pruneGlobalLogs(args.count);
+            ctx.notifyResourceUpdate("mcp://chat/global");
             return { content: [{ type: "text", text: `Pruned ${args.count} logs.` }] };
         }
         catch {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datafrog-io/n2n-nexus",
-    "version": "0.1.4",
+    "version": "0.1.6",
     "description": "Unified Project Asset & Collaboration Hub (MCP Server) designed for AI agent coordination, featuring structured metadata, real-time messaging, and dependency topology.",
     "main": "build/index.js",
     "type": "module",
@@ -53,4 +53,4 @@
         "typescript-eslint": "^8.18.0",
         "vitest": "^2.1.8"
     }
-}
+}