@datafrog-io/n2n-nexus 0.1.8 → 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,32 +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
 
@@ -172,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

@@ -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** 是一个专为多 AI 助手协同设计的“本地数字化资产中心”。它将高频的**实时会议室**与严谨的**结构化资产库**完美融合，提供 100% 本地化、零外部依赖的项目管理体验。
 
-> **支持的 IDE：** VS Code · Cursor · Windsurf · Zed · JetBrains · Theia · Google Antigravity
+> **支持的 IDE：** Claude Code · Claude Desktop · VS Code · Cursor · Windsurf · Zed · JetBrains · Theia · Google Antigravity
 
 ## 🏛️ 系统架构 (Architecture)
 
@@ -54,31 +55,47 @@ Nexus_Storage/
 - `mcp://nexus/session`: 查看当前身份、角色（Moderator/Regular）及活动项目。
 
 ### B. 项目资产管理 (Project Assets)
-- `sync_project_assets`: **[核心]** 提交完整的项目 Manifest 和内部技术文档。
+- `sync_project_assets`: **[核心/异步]** 提交完整的项目 Manifest 和内部技术文档。返回 `taskId`。
     - **Manifest**: 包含 ID、技术栈、**依赖关系 (Relations)**、仓库地址、本地路径、API Spec 等。
 - `update_project`: 部分更新 Manifest 字段（如仅更新 endpoints 或 description）。
-- `rename_project`: 重命名项目 ID，自动级联更新所有相关项目的依赖引用。
+- `rename_project`: **[异步]** 重命名项目 ID，自动级联更新所有相关项目的依赖引用。返回 `taskId`。
 - `upload_project_asset`: 上传二进制/文本文件（Base64）到项目库。
-- `read_project`: 读取项目的特定数据切片（Summary, Manifest, Docs, API, Relations等）。
+- **读取操作**: 全部转为资源访问模式 (例如：`mcp://nexus/projects/${id}/manifest`)。
 
 ### C. 全局协作 (Global Collaboration)
-- `post_global_discussion`: 发送跨项目广播消息。
-- `update_global_strategy`: 更新核心战略蓝图 (`# Master Plan`)。
-- `get_global_topology`:获取全网项目依赖关系图谱。
-- `sync_global_doc` / `list_global_docs` / `read_global_doc`: 管理全局通用文档。
-
-### D. 管理员 (Moderator Only)
+- `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://chat/global`: 实时对话流历史。
-- `mcp://hub/registry`: 全局项目注册表概览。
-- `mcp://docs/global-strategy`: 战略总领文档。
-- `mcp://nexus/session`: 当前会话状态。
-- `mcp://hub/projects/{id}/manifest`: 特定项目的完整元数据。
-- `mcp://hub/projects/{id}/internal-docs`: 特定项目的内部技术文档。
+- `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`: 特定项目的内部技术文档。
 
 ## 🚀 快速启动
 
@@ -139,5 +156,24 @@ 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.8" }, { 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

@@ -7,15 +7,15 @@ import { UnifiedMeetingStore } from "../storage/store.js";
  */
 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 };
     }
@@ -33,7 +33,7 @@ export async function getResourceContent(uri, currentProject) {
         const storageInfo = await UnifiedMeetingStore.getStorageInfo();
         const status = {
             status: "online",
-            version: "0.1.8",
+            version: "0.2.0",
             ...storageInfo,
             active_meetings_count: state.activeMeetings.length,
             default_meeting: state.defaultMeetingId
@@ -46,22 +46,40 @@ export async function getResourceContent(uri, currentProject) {
             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 };
@@ -77,9 +95,11 @@ 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." },
@@ -92,14 +112,15 @@ 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

@@ -24,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.

package/build/storage/meetings.js

@@ -102,6 +102,7 @@ export class MeetingStore {
                 topic,
                 status: "active",
                 startTime: new Date().toISOString(),
+                initiator,
                 participants: [initiator],
                 messages: [],
                 decisions: []
@@ -152,13 +153,17 @@ export class MeetingStore {
     /**
      * End a meeting (close it)
      */
-    static async endMeeting(meetingId, summary) {
+    static async endMeeting(meetingId, summary, callerId) {
         return this.stateLock.withLock(async () => {
             const meeting = await this.getMeeting(meetingId);
             if (!meeting)
                 throw new Error(`Meeting '${meetingId}' not found.`);
             if (meeting.status !== "active")
                 throw new Error(`Meeting '${meetingId}' is already ${meeting.status}.`);
+            // Permission check: Only initiator can end
+            if (callerId && meeting.initiator && meeting.initiator !== callerId) {
+                throw new Error(`Permission denied: Only initiator (${meeting.initiator}) can end this meeting.`);
+            }
             // Close the meeting
             meeting.status = "closed";
             meeting.endTime = new Date().toISOString();
@@ -182,15 +187,43 @@ export class MeetingStore {
     /**
      * Archive a closed meeting
      */
-    static async archiveMeeting(meetingId) {
+    static async archiveMeeting(meetingId, callerId) {
         const meeting = await this.getMeeting(meetingId);
         if (!meeting)
             throw new Error(`Meeting '${meetingId}' not found.`);
         if (meeting.status === "active")
             throw new Error(`Meeting '${meetingId}' is still active. End it first.`);
+        // Permission check: Only initiator can archive
+        if (callerId && meeting.initiator && meeting.initiator !== callerId) {
+            throw new Error(`Permission denied: Only initiator (${meeting.initiator}) can archive this meeting.`);
+        }
         meeting.status = "archived";
         await fs.writeFile(this.getMeetingPath(meetingId), JSON.stringify(meeting, null, 2), "utf-8");
     }
+    /**
+     * Reopen a closed or archived meeting
+     */
+    static async reopenMeeting(meetingId, _callerId) {
+        return this.stateLock.withLock(async () => {
+            const meeting = await this.getMeeting(meetingId);
+            if (!meeting)
+                throw new Error(`Meeting '${meetingId}' not found.`);
+            if (meeting.status === "active")
+                throw new Error(`Meeting '${meetingId}' is already active.`);
+            // Update status to active
+            meeting.status = "active";
+            meeting.endTime = undefined;
+            await fs.writeFile(this.getMeetingPath(meetingId), JSON.stringify(meeting, null, 2), "utf-8");
+            // Update state
+            const state = await this.loadStateSafe();
+            if (!state.activeMeetings.includes(meetingId)) {
+                state.activeMeetings.push(meetingId);
+            }
+            state.defaultMeetingId = meetingId;
+            await this.saveState(state);
+            return meeting;
+        });
+    }
     /**
      * List all meetings with optional status filter
      */

package/build/storage/sqlite-meeting.js

@@ -39,10 +39,10 @@ export class SqliteMeetingStore {
         const now = new Date().toISOString();
         const participants = JSON.stringify([initiator]);
         const stmt = db.prepare(`
-            INSERT INTO meetings (id, topic, status, participants, created_at)
-            VALUES (?, ?, 'active', ?, ?)
+            INSERT INTO meetings (id, topic, status, initiator, participants, created_at)
+            VALUES (?, ?, 'active', ?, ?, ?)
         `);
-        stmt.run(id, topic, participants, now);
+        stmt.run(id, topic, initiator, participants, now);
         // Update state
         this.updateState("default_meeting", id);
         const activeMeetings = this.getActiveMeetingIds();
@@ -53,6 +53,7 @@ export class SqliteMeetingStore {
             topic,
             status: "active",
             startTime: now,
+            initiator,
             participants: [initiator],
             messages: [],
             decisions: []
@@ -86,6 +87,7 @@ export class SqliteMeetingStore {
             status: meeting.status,
             startTime: meeting.created_at,
             endTime: meeting.closed_at || undefined,
+            initiator: meeting.initiator || "Unknown",
             participants: JSON.parse(meeting.participants),
             messages,
             decisions,
@@ -129,7 +131,7 @@ export class SqliteMeetingStore {
     /**
      * End a meeting
      */
-    static endMeeting(meetingId, summary) {
+    static endMeeting(meetingId, summary, callerId) {
         const db = getDatabase();
         const now = new Date().toISOString();
         // Check meeting exists and is active
@@ -138,6 +140,10 @@ export class SqliteMeetingStore {
             throw new Error(`Meeting '${meetingId}' not found.`);
         if (meeting.status !== "active")
             throw new Error(`Meeting '${meetingId}' is already ${meeting.status}.`);
+        // Permission check: Only initiator can end
+        if (callerId && meeting.initiator && meeting.initiator !== callerId) {
+            throw new Error(`Permission denied: Only initiator (${meeting.initiator}) can end this meeting.`);
+        }
         // Update meeting
         const stmt = db.prepare(`
             UPDATE meetings SET status = 'closed', closed_at = ?, summary = ?
@@ -159,16 +165,42 @@ export class SqliteMeetingStore {
     /**
      * Archive a meeting
      */
-    static archiveMeeting(meetingId) {
+    static archiveMeeting(meetingId, callerId) {
         const db = getDatabase();
         const meeting = this.getMeeting(meetingId);
         if (!meeting)
             throw new Error(`Meeting '${meetingId}' not found.`);
         if (meeting.status === "active")
             throw new Error(`Meeting '${meetingId}' is still active. End it first.`);
+        // Permission check: Only initiator can archive
+        if (callerId && meeting.initiator && meeting.initiator !== callerId) {
+            throw new Error(`Permission denied: Only initiator (${meeting.initiator}) can archive this meeting.`);
+        }
         const stmt = db.prepare("UPDATE meetings SET status = 'archived' WHERE id = ?");
         stmt.run(meetingId);
     }
+    /**
+     * Reopen a closed or archived meeting
+     */
+    static reopenMeeting(meetingId, _callerId) {
+        const db = getDatabase();
+        const meeting = this.getMeeting(meetingId);
+        if (!meeting)
+            throw new Error(`Meeting '${meetingId}' not found.`);
+        if (meeting.status === "active")
+            throw new Error(`Meeting '${meetingId}' is already active.`);
+        // Update status to active
+        const stmt = db.prepare("UPDATE meetings SET status = 'active', closed_at = NULL WHERE id = ?");
+        stmt.run(meetingId);
+        // Update state
+        const activeMeetings = this.getActiveMeetingIds();
+        if (!activeMeetings.includes(meetingId)) {
+            activeMeetings.push(meetingId);
+            this.updateState("active_meetings", JSON.stringify(activeMeetings));
+        }
+        this.updateState("default_meeting", meetingId);
+        return this.getMeeting(meetingId);
+    }
     /**
      * List meetings with optional status filter
      */

package/build/storage/sqlite.js

@@ -1,5 +1,6 @@
 import Database from "better-sqlite3";
 import path from "path";
+import { createRequire } from "module";
 import { CONFIG } from "../config.js";
 let db = null;
 /**
@@ -11,6 +12,7 @@ CREATE TABLE IF NOT EXISTS meetings (
     id TEXT PRIMARY KEY,
     topic TEXT NOT NULL,
     status TEXT CHECK(status IN ('active', 'closed', 'archived')) DEFAULT 'active',
+    initiator TEXT,
     participants TEXT DEFAULT '[]',
     created_at TEXT NOT NULL,
     closed_at TEXT,
@@ -67,6 +69,18 @@ export function initDatabase() {
     db.pragma("journal_mode = WAL");
     // Initialize schema
     db.exec(SCHEMA);
+    // Migration: Add initiator column if it doesn't exist (Upgrade from v0.1.7)
+    try {
+        const columns = db.prepare("PRAGMA table_info(meetings)").all();
+        const hasInitiator = columns.some(c => c.name === "initiator");
+        if (!hasInitiator) {
+            console.error("[Nexus] Migrating database: Adding 'initiator' column to 'meetings' table.");
+            db.exec("ALTER TABLE meetings ADD COLUMN initiator TEXT");
+        }
+    }
+    catch (e) {
+        console.error("[Nexus] Migration check failed:", e);
+    }
     // Initialize default state if not exists
     const stmt = db.prepare("INSERT OR IGNORE INTO meeting_state (key, value) VALUES (?, ?)");
     stmt.run("active_meetings", "[]");
@@ -93,10 +107,8 @@ export function closeDatabase() {
         console.error("[Nexus] SQLite database closed");
     }
 }
-/**
- * Check if SQLite is available
- */
 export function isSqliteAvailable() {
+    const require = createRequire(import.meta.url);
     try {
         // Try to load better-sqlite3
         require("better-sqlite3");