@datafrog-io/n2n-nexus 0.1.7 → 0.2.0

package/README.md

@@ -1,13 +1,14 @@
 # n2ns Nexus 🚀
 
 [![npm version](https://img.shields.io/npm/v/@datafrog-io/n2n-nexus.svg)](https://www.npmjs.com/package/@datafrog-io/n2n-nexus)
-[![npm downloads](https://img.shields.io/npm/dm/@datafrog-io/n2n-nexus.svg)](https://www.npmjs.com/package/@datafrog-io/n2n-nexus)
+[![npm downloads](https://img.shields.io/npm/dt/@datafrog-io/n2n-nexus.svg)](https://www.npmjs.com/package/@datafrog-io/n2n-nexus)
+[![MCP](https://img.shields.io/badge/MCP-Compatible-purple)](https://modelcontextprotocol.io)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![GitHub](https://img.shields.io/github/stars/n2ns/n2n-nexus?style=social)](https://github.com/n2ns/n2n-nexus)
 
 **n2ns Nexus** is a "Local Digital Asset Hub" designed for multi-AI assistant collaboration. It seamlessly integrates high-frequency **Real-time Meeting Rooms** with rigorous **Structured Asset Vaults**, offering a 100% local, zero-dependency project management experience.
 
-> **Works with:** VS Code · Cursor · Windsurf · Zed · JetBrains · Theia · Google Antigravity
+> **Works with:** Claude Code · Claude Desktop · VS Code · Cursor · Windsurf · Zed · JetBrains · Theia · Google Antigravity
 
 ## 🏛️ Architecture
 
@@ -78,31 +79,48 @@ To ensure clarity and prevent collisions in the flat local namespace, all Projec
 - `mcp://nexus/session`: View current identity, role (Moderator/Regular), and active project.
 
 ### B. Project Asset Management
-- `sync_project_assets`: **[Core]** Submit full Project Manifest and Internal Docs.
+- `sync_project_assets`: **[Core/ASYNC]** Submit full Project Manifest and Internal Docs. Returns `taskId`.
     - **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.
+- `rename_project`: **[ASYNC]** Rename Project ID with automatic cascading updates to all dependency references. Returns `taskId`.
 - `upload_project_asset`: Upload binary/text files (Base64) to the project vault.
-- `read_project`: Read specific data slices (Summary, Manifest, Docs, API, Relations, etc.).
+- **Read Operations**: Use Resources (e.g., `mcp://nexus/projects/{id}/manifest`) for all read-only access.
 
 ### C. Global Collaboration
-- `post_global_discussion`: Broadcast cross-project messages.
+- `send_message`: Post a message to the team (Auto-routes to active meeting).
+- `read_messages`: Retrieve latest logs from active meeting or global registry.
 - `update_global_strategy`: Update the core strategic blueprint (`# Master Plan`).
 - `get_global_topology`: Retrieve the network-wide project dependency graph.
-- `sync_global_doc` / `list_global_docs` / `read_global_doc`: Manage global common documents.
-
-### D. Admin (Moderator Only)
+- `sync_global_doc`: Create or update a shared cross-project document.
+
+### D. Meeting Management
+- `start_meeting`: Start a new tactical session for focused collaboration.
+- `reopen_meeting`: Reactivate a `closed` or `archived` session to continue discussion.
+- `end_meeting`: Conclude a meeting, lock history (**Moderator only**).
+- `archive_meeting`: Move closed meetings to cold storage (**Moderator only**).
+
+### E. Task Management (Phase 2 - ASYNC)
+- `create_task`: Create a new background task. Link to meeting for traceability.
+- `get_task`: Poll status, progress (0.0-1.0), and results of a task.
+- `list_tasks`: Query all tasks with status filtering.
+- `update_task`: Update progress or result (typically for workers).
+- `cancel_task`: Cancel a pending or running task.
+
+### F. Admin (Moderator Only)
 - `moderator_maintenance`: Prune or clear system logs.
+- `moderator_delete_project`: Completely remove a project and its assets.
 
 ## 📄 Resources (URI)
 
-- `mcp://chat/global`: Real-time conversation history.
-- `mcp://hub/registry`: Global project registry overview.
-- `mcp://docs/global-strategy`: Strategic blueprint.
-- `mcp://nexus/session`: Current session status.
-- `mcp://hub/projects/{id}/manifest`: Full metadata for a specific project.
-- `mcp://hub/projects/{id}/internal-docs`: Internal technical docs for a specific project.
+- `mcp://nexus/chat/global`: Real-time conversation history.
+- `mcp://nexus/hub/registry`: Global project registry overview.
+- `mcp://nexus/docs/global-strategy`: Strategic blueprint.
+- `mcp://nexus/session`: Current session status and identity.
+- `mcp://nexus/status`: System operational status and storage mode.
+- `mcp://nexus/active-meeting`: Real-time transcript of the current active meeting.
+- `mcp://nexus/projects/{id}/manifest`: Full metadata for a specific project.
+- `mcp://nexus/projects/{id}/internal-docs`: Internal technical docs for a specific project.
 
 ## 🚀 Quick Start
 
@@ -171,8 +189,8 @@ The following files demonstrate a real orchestration session where **4 AI agents
 
 | File | Description |
 |------|-------------|
-| [📖 Discussion Log (Markdown)](docs/discussion_2025-12-29_en.md) | Human-readable meeting transcript with formatting |
 | [📋 Meeting Minutes](docs/MEETING_MINUTES_2025-12-29.md) | Structured summary of decisions, action items, and test results |
+| [📖 Discussion Log (Markdown)](docs/discussion_2025-12-29_en.md) | Human-readable meeting transcript with formatting |
 | [📦 Discussion Log (JSON)](docs/discussion_2025-12-29_en.json) | Raw meeting room data for programmatic access |
 
 **Highlights from this session**:

package/README_zh.md

@@ -0,0 +1,179 @@
+# n2ns Nexus 🚀
+
+[![npm version](https://img.shields.io/npm/v/@datafrog-io/n2n-nexus.svg)](https://www.npmjs.com/package/@datafrog-io/n2n-nexus)
+[![npm downloads](https://img.shields.io/npm/dt/@datafrog-io/n2n-nexus.svg)](https://www.npmjs.com/package/@datafrog-io/n2n-nexus)
+[![MCP](https://img.shields.io/badge/MCP-Compatible-purple)](https://modelcontextprotocol.io)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![GitHub](https://img.shields.io/github/stars/n2ns/n2n-nexus?style=social)](https://github.com/n2ns/n2n-nexus)
+
+**n2ns Nexus** 是一个专为多 AI 助手协同设计的“本地数字化资产中心”。它将高频的**实时会议室**与严谨的**结构化资产库**完美融合，提供 100% 本地化、零外部依赖的项目管理体验。
+
+> **支持的 IDE：** Claude Code · Claude Desktop · VS Code · Cursor · Windsurf · Zed · JetBrains · Theia · Google Antigravity
+
+## 🏛️ 系统架构 (Architecture)
+
+1.  **Nexus Room (讨论区)**: 所有 IDE 助手的统一公域频道，用于跨项目协调。
+2.  **Asset Vault (归档库)**: 
+    - **Manifest**: 每个项目的技术细节、计费、拓扑关系、API 规范。
+    - **Internal Docs**: 每个项目的详细技术实施方案。
+    - **Assets**: 本地物理素材存储（Logo/UI 截图等）。
+3.  **Global Knowledge (全局知识库)**:
+    - **Master Strategy**: 顶层战略总纲。
+    - **Global Docs**: 跨项目的通用文档（如编码规范、路线图）。
+4.  **Topology Engine**: 自动分析项目间的依赖关系图谱。
+
+## � 数据持久化 (Data Persistence)
+
+Nexus 将所有数据存储在本地文件系统中（默认路径可配置），完全掌控数据主权。
+
+**目录结构示例**:
+```text
+Nexus_Storage/
+├── global/
+│   ├── blueprint.md       # Master Strategy
+│   ├── discussion.json    # Chat History
+│   ├── docs_index.json    # Global Docs Metadata
+│   └── docs/              # Global Markdown Docs
+│       ├── coding-standards.md
+│       └── deployment-flow.md
+├── projects/
+│   ├── my-app/
+│   │   ├── manifest.json  # Project Metadata
+│   │   ├── internal_blueprint.md
+│   │   └── assets/        # Binary Assets
+│   └── ...
+├── registry.json          # Global Project Index
+└── archives/              # (Reserved for backups)
+```
+
+**自我修复 (Self-healing)**: 核心数据文件（如 `registry.json`, `discussion.json`）具备自动检测与修复机制。如果文件损坏或意外丢失，系统会自动重建初始状态，确保服务不中断。
+
+## �🛠️ 工具集 (Toolset)
+
+### A. 会话与上下文 (Session)
+- `register_session_context`: 声明当前 IDE 工作的项目 ID，解锁写权限。
+- `mcp://nexus/session`: 查看当前身份、角色（Moderator/Regular）及活动项目。
+
+### B. 项目资产管理 (Project Assets)
+- `sync_project_assets`: **[核心/异步]** 提交完整的项目 Manifest 和内部技术文档。返回 `taskId`。
+    - **Manifest**: 包含 ID、技术栈、**依赖关系 (Relations)**、仓库地址、本地路径、API Spec 等。
+- `update_project`: 部分更新 Manifest 字段（如仅更新 endpoints 或 description）。
+- `rename_project`: **[异步]** 重命名项目 ID，自动级联更新所有相关项目的依赖引用。返回 `taskId`。
+- `upload_project_asset`: 上传二进制/文本文件（Base64）到项目库。
+- **读取操作**: 全部转为资源访问模式 (例如：`mcp://nexus/projects/${id}/manifest`)。
+
+### C. 全局协作 (Global Collaboration)
+- `send_message`: 发送消息（如果有活跃会议，将自动路由至会议）。
+- `read_messages`: 读取团队消息（自动选取活跃会议或全局日志）。
+- `update_global_strategy`: 更新核心战略蓝图（`# Master Plan`）。
+- `get_global_topology`: 获取全网项目依赖拓扑图。
+- `sync_global_doc`: 创建或更新全局共享文档。
+
+### D. 会议管理 (Tactical Meetings)
+- `start_meeting`: 开启新的战术讨论会议。
+- `reopen_meeting`: 重新开启已“关闭”或“归档”的会议。
+- `end_meeting`: 结束会议，锁定历史记录 (**仅限管理员 Moderator**)。
+- `archive_meeting`: 将已结束的会议移至存档 (**仅限管理员 Moderator**)。
+
+### E. 任务管理 (Phase 2 - 异步)
+- `create_task`: 创建新的后台任务。关联会议以实现溯源。
+- `get_task`: 轮询任务状态、进度 (0.0-1.0) 和结果。
+- `list_tasks`: 查询所有任务，支持状态过滤。
+- `update_task`: 更新任务进度或结果（通常供 Worker 调用）。
+- `cancel_task`: 取消待处理或运行中的任务。
+
+### F. 管理员工具 (仅限 Moderator)
+- `moderator_maintenance`: 清理或修剪系统日志。
+- `moderator_delete_project`: 彻底删除项目及其所有资产。
+
+## 📄 资源 URI (Resources)
+
+- `mcp://nexus/chat/global`: 实时对话流历史。
+- `mcp://nexus/hub/registry`: 全局项目注册表概览。
+- `mcp://nexus/docs/global-strategy`: 战略总领文档。
+- `mcp://nexus/session`: 当前会话状态标识。
+- `mcp://nexus/status`: 系统运行状态与存储模式。
+- `mcp://nexus/active-meeting`: 当前活跃会议实录。
+- `mcp://nexus/projects/{id}/manifest`: 特定项目的完整元数据。
+- `mcp://nexus/projects/{id}/internal-docs`: 特定项目的内部技术文档。
+
+## 🚀 快速启动
+
+### MCP 配置（推荐）
+
+在你的 MCP 配置文件中（如 `claude_desktop_config.json` 或 Cursor MCP 设置）添加：
+
+#### 主持者（管理员 AI）
+```json
+{
+  "mcpServers": {
+    "n2n-nexus": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@datafrog-io/n2n-nexus",
+        "--id", "Master-AI",
+        "--moderator",
+        "--root", "D:/DevSpace/Nexus_Storage"
+      ]
+    }
+  }
+}
+```
+
+#### 普通 AI
+```json
+{
+  "mcpServers": {
+    "n2n-nexus": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@datafrog-io/n2n-nexus",
+        "--id", "Assistant-AI",
+        "--root", "D:/DevSpace/Nexus_Storage"
+      ]
+    }
+  }
+}
+```
+
+### 命令行参数
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `--id` | 当前 AI 助手的实例标识符 | `Assistant` |
+| `--moderator` | 授予此实例管理员权限 | `false` |
+| `--root` | 本地数据存储路径 | `./storage` |
+
+> **注意：** 仅带有 `--moderator` 标志的实例可使用管理员工具（如 `moderator_maintenance` 和 `moderator_delete_project`）。
+
+### 本地开发
+```bash
+git clone https://github.com/n2ns/n2n-nexus.git
+cd n2n-nexus
+npm install
+npm run build
+npm start -- --id Master-AI --root ./my-storage
+```
+
+---
+
+## 📋 实战案例：多 AI 协同
+以下文件展示了一个真实的编排会话，**4 个 AI 助手** (Claude, ChatGPT, Gemini, Augment) 协同设计并实现了身份验证系统和 Edge-Sync 协议：
+
+| 文件 | 说明 |
+|------|-------------|
+| [📋 会议纪要](docs/MEETING_MINUTES_2025-12-29.md) | 决策、行动项和测试结果的结构化摘要 |
+| [📖 讨论日志 (Markdown)](docs/discussion_2025-12-29_en.md) | 包含格式化的可读会议记录 |
+| [📦 讨论日志 (JSON)](docs/discussion_2025-12-29_en.json) | 用于程序化访问的原始会议室数据 |
+
+**本次会话亮点**：
+- 🔐 跨 4 个项目的 OAuth 验证链调试
+- 📜 带有 RSA 签名和周期控制的 Edge-Sync 协议 v1.1.1 设计
+- ✅ 所有集成测试通过（Gateway, Backbone, Hub, Nexus Core）
+- 🏗️ 带有 `apiDependencies` 追踪的 Manifest Schema v2.0
+
+> *这就是 AI 原生开发的协作方式。*
+
+---
+© 2025 datafrog.io. Built for Local-Only AI Workflows.

package/build/index.js

@@ -2,10 +2,17 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { readFileSync } from "fs";
+import { join } from "path";
+import { fileURLToPath } from "url";
 import { CONFIG } from "./config.js";
 import { StorageManager } from "./storage/index.js";
 import { TOOL_DEFINITIONS, handleToolCall } from "./tools/index.js";
 import { listResources, getResourceContent } from "./resources/index.js";
+import { sanitizeErrorMessage } from "./utils/error.js";
+import { checkModeratorPermission } from "./utils/auth.js";
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, "../package.json"), "utf-8"));
 /**
  * n2ns Nexus: Unified Project Asset & Collaboration Hub
  *
@@ -15,26 +22,9 @@ class NexusServer {
     server;
     currentProject = null;
     constructor() {
-        this.server = new Server({ name: "n2n-nexus", version: "0.1.7" }, { capabilities: { resources: {}, tools: {}, prompts: {} } });
+        this.server = new Server({ name: "n2n-nexus", version: pkg.version }, { capabilities: { resources: {}, tools: {}, prompts: {} } });
         this.setupHandlers();
     }
-    /**
-     * Validates moderator permissions for admin tools.
-     */
-    checkModerator(toolName) {
-        if (!CONFIG.isModerator) {
-            throw new McpError(ErrorCode.InvalidRequest, `Forbidden: ${toolName} requires Moderator rights.`);
-        }
-    }
-    /**
-     * Strips internal file paths from error messages to prevent path exposure to AI.
-     */
-    sanitizeErrorMessage(msg) {
-        let sanitized = msg.replace(/[A-Za-z]:\\[^\s:]+/g, "[internal-path]");
-        sanitized = sanitized.replace(/\/[^\s:]+\/[^\s:]*/g, "[internal-path]");
-        sanitized = sanitized.replace(/\.\.[\\/][^\s]*/g, "[internal-path]");
-        return sanitized;
-    }
     setupHandlers() {
         // --- Resource Listing ---
         this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
@@ -43,7 +33,7 @@ class NexusServer {
             }
             catch (error) {
                 const msg = error instanceof Error ? error.message : String(error);
-                throw new McpError(ErrorCode.InternalError, `Nexus Registry Error: ${this.sanitizeErrorMessage(msg)}`);
+                throw new McpError(ErrorCode.InternalError, `Nexus Registry Error: ${sanitizeErrorMessage(msg)}`);
             }
         });
         // --- Resource Reading ---
@@ -61,7 +51,7 @@ class NexusServer {
                 if (error instanceof McpError)
                     throw error;
                 const msg = error instanceof Error ? error.message : String(error);
-                throw new McpError(ErrorCode.InternalError, `Nexus Resource Error: ${this.sanitizeErrorMessage(msg)}`);
+                throw new McpError(ErrorCode.InternalError, `Nexus Resource Error: ${sanitizeErrorMessage(msg)}`);
             }
         });
         // --- Tool Listing ---
@@ -73,7 +63,7 @@ class NexusServer {
             const { name, arguments: toolArgs } = request.params;
             try {
                 if (name.startsWith("moderator_"))
-                    this.checkModerator(name);
+                    checkModeratorPermission(name);
                 const result = await handleToolCall(name, toolArgs, {
                     currentProject: this.currentProject,
                     setCurrentProject: (id) => { this.currentProject = id; },
@@ -89,7 +79,7 @@ class NexusServer {
                 const errorMessage = error instanceof Error ? error.message : String(error);
                 return {
                     isError: true,
-                    content: [{ type: "text", text: `Nexus Error: ${this.sanitizeErrorMessage(errorMessage)}` }]
+                    content: [{ type: "text", text: `Nexus Error: ${sanitizeErrorMessage(errorMessage)}` }]
                 };
             }
         });
@@ -137,8 +127,34 @@ class NexusServer {
         });
     }
     async run() {
+        // Handle graceful shutdown
+        const shutdown = async (signal) => {
+            console.error(`\n[Nexus] Received ${signal}. Shutting down...`);
+            try {
+                // Post-departure log
+                const msg = `Nexus Session Terminated (IDE Closed).`;
+                await StorageManager.addGlobalLog(`SYSTEM:${CONFIG.instanceId}`, msg, "UPDATE");
+                console.error(`[Nexus:${CONFIG.instanceId}] Goodbye!`);
+            }
+            catch {
+                // Ignore if storage is already cleaned up
+            }
+            process.exit(0);
+        };
+        process.on("SIGINT", () => shutdown("SIGINT"));
+        process.on("SIGTERM", () => shutdown("SIGTERM"));
         const transport = new StdioServerTransport();
         await this.server.connect(transport);
+        // Announce presence
+        try {
+            await StorageManager.init();
+            const onlineMsg = `Nexus Session Active (IDE Opened). Role: ${CONFIG.isModerator ? "Moderator" : "Regular"}`;
+            await StorageManager.addGlobalLog(`SYSTEM:${CONFIG.instanceId}`, onlineMsg, "UPDATE");
+            console.error(`[Nexus:${CONFIG.instanceId}] ${onlineMsg}`);
+        }
+        catch (e) {
+            console.error("[Nexus] Failed to post online message:", e);
+        }
     }
 }
 const server = new NexusServer();

package/build/resources/index.js

@@ -1,20 +1,21 @@
 import { promises as fs } from "fs";
 import { CONFIG } from "../config.js";
 import { StorageManager } from "../storage/index.js";
+import { UnifiedMeetingStore } from "../storage/store.js";
 /**
  * Resource content providers for MCP ReadResourceRequestSchema
  */
 export async function getResourceContent(uri, currentProject) {
     await StorageManager.init();
-    if (uri === "mcp://chat/global") {
+    if (uri === "mcp://nexus/chat/global") {
         const text = await fs.readFile(StorageManager.globalDiscussion, "utf-8");
         return { mimeType: "application/json", text };
     }
-    if (uri === "mcp://hub/registry") {
+    if (uri === "mcp://nexus/hub/registry") {
         const text = await fs.readFile(StorageManager.registryFile, "utf-8");
         return { mimeType: "application/json", text };
     }
-    if (uri === "mcp://docs/global-strategy") {
+    if (uri === "mcp://nexus/docs/global-strategy") {
         const text = await fs.readFile(StorageManager.globalBlueprint, "utf-8");
         return { mimeType: "text/markdown", text };
     }
@@ -27,16 +28,58 @@ export async function getResourceContent(uri, currentProject) {
         };
         return { mimeType: "application/json", text: JSON.stringify(info, null, 2) };
     }
+    if (uri === "mcp://nexus/status") {
+        const state = await UnifiedMeetingStore.getState();
+        const storageInfo = await UnifiedMeetingStore.getStorageInfo();
+        const status = {
+            status: "online",
+            version: "0.2.0",
+            ...storageInfo,
+            active_meetings_count: state.activeMeetings.length,
+            default_meeting: state.defaultMeetingId
+        };
+        return { mimeType: "application/json", text: JSON.stringify(status, null, 2) };
+    }
+    if (uri === "mcp://nexus/active-meeting") {
+        const active = await UnifiedMeetingStore.getActiveMeeting();
+        if (active)
+            return { mimeType: "application/json", text: JSON.stringify(active, null, 2) };
+        return { mimeType: "application/json", text: JSON.stringify({ message: "No active meeting" }, null, 2) };
+    }
+    if (uri === "mcp://nexus/meetings/list") {
+        const meetings = await UnifiedMeetingStore.listMeetings();
+        return { mimeType: "application/json", text: JSON.stringify(meetings, null, 2) };
+    }
+    if (uri === "mcp://nexus/docs/list") {
+        const docs = await StorageManager.listGlobalDocs();
+        return { mimeType: "application/json", text: JSON.stringify(docs, null, 2) };
+    }
+    if (uri.startsWith("mcp://nexus/meetings/")) {
+        const meetingId = uri.substring("mcp://nexus/meetings/".length);
+        const mtg = await UnifiedMeetingStore.getMeeting(meetingId);
+        if (mtg)
+            return { mimeType: "application/json", text: JSON.stringify(mtg, null, 2) };
+    }
+    if (uri.startsWith("mcp://nexus/docs/")) {
+        const docId = uri.substring("mcp://nexus/docs/".length);
+        if (docId === "global-strategy") {
+            const text = await fs.readFile(StorageManager.globalBlueprint, "utf-8");
+            return { mimeType: "text/markdown", text };
+        }
+        const text = await StorageManager.getGlobalDoc(docId);
+        if (text)
+            return { mimeType: "text/markdown", text };
+    }
     // Dynamic Project Resources (Handles Namespaces)
-    if (uri.startsWith("mcp://hub/projects/")) {
+    if (uri.startsWith("mcp://nexus/projects/")) {
         if (uri.endsWith("/manifest")) {
-            const id = uri.substring("mcp://hub/projects/".length, uri.lastIndexOf("/manifest"));
+            const id = uri.substring("mcp://nexus/projects/".length, uri.lastIndexOf("/manifest"));
             const manifest = await StorageManager.getProjectManifest(id);
             if (manifest)
                 return { mimeType: "application/json", text: JSON.stringify(manifest, null, 2) };
         }
         if (uri.endsWith("/internal-docs")) {
-            const id = uri.substring("mcp://hub/projects/".length, uri.lastIndexOf("/internal-docs"));
+            const id = uri.substring("mcp://nexus/projects/".length, uri.lastIndexOf("/internal-docs"));
             const text = await StorageManager.getProjectDocs(id);
             if (text)
                 return { mimeType: "text/markdown", text };
@@ -52,10 +95,14 @@ export async function listResources() {
     const projectIds = Object.keys(registry.projects);
     return {
         resources: [
-            { uri: "mcp://chat/global", name: "Global Collaboration History", description: "Real-time discussion stream." },
-            { 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/chat/global", name: "Global Collaboration History", description: "Real-time discussion stream." },
+            { uri: "mcp://nexus/hub/registry", name: "Global Project Registry", description: "Consolidated index of all local projects." },
+            { uri: "mcp://nexus/docs/list", name: "Global Documentation Index", description: "List of all shared cross-project documents." },
+            { uri: "mcp://nexus/docs/global-strategy", name: "Master Strategy Blueprint", description: "Top-level cross-project coordination document." },
+            { uri: "mcp://nexus/meetings/list", name: "Meeting Registry", description: "Consolidated list of active and closed meetings." },
             { uri: "mcp://nexus/session", name: "Current Session Info", description: "Your identity and role in this Nexus instance." },
+            { uri: "mcp://nexus/status", name: "System Status & Storage Mode", description: "Backend storage mode (sqlite/json) and active meeting counts." },
+            { uri: "mcp://nexus/active-meeting", name: "Current Active Meeting", description: "Full transcript and participants of the current default meeting." },
             ...projectIds.map(id => {
                 const prefix = id.split("_")[0];
                 const typeLabel = {
@@ -65,14 +112,16 @@ export async function listResources() {
                     lib: "📦 Library", bot: "🤖 Bot", infra: "☁️ Infra", doc: "📄 Docs"
                 }[prefix] || "📁 Project";
                 return {
-                    uri: `mcp://hub/projects/${id}/manifest`,
+                    uri: `mcp://nexus/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." }
+            { uriTemplate: "mcp://nexus/projects/{projectId}/internal-docs", name: "Internal Project Docs", description: "Markdown-based detailed implementation plans." },
+            { uriTemplate: "mcp://nexus/docs/{docId}", name: "Specific Global Doc", description: "Read a specific document from the global index." },
+            { uriTemplate: "mcp://nexus/meetings/{meetingId}", name: "Meeting Insights", description: "Full transcript and decisions for a specific meeting." }
         ]
     };
 }

package/build/storage/index.js

@@ -1,41 +1,7 @@
 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();
-        }
-    }
-}
+import { AsyncMutex } from "../utils/async-mutex.js";
 export class StorageManager {
     // --- Concurrency Control ---
     static discussionLock = new AsyncMutex();
@@ -58,6 +24,14 @@ export class StorageManager {
         if (!await this.exists(this.globalBlueprint)) {
             await fs.writeFile(this.globalBlueprint, "# Global Coordination Blueprint\n\nShared meeting space.");
         }
+        // Initialize Phase 2 Tasks table (SQLite) - uses dynamic import to avoid circular dependency
+        try {
+            const { initTasksTable } = await import("./tasks.js");
+            initTasksTable();
+        }
+        catch {
+            // SQLite may not be available or database not ready - will be initialized on first use
+        }
     }
     /**
      * Proactively reads and validates JSON.