@datafrog-io/n2n-nexus 0.1.8 → 0.2.1

package/README.md

@@ -1,13 +1,16 @@
 # 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
+
+📖 **Documentation:** [CHANGELOG](CHANGELOG.md) | [TODO](TODO.md) | [中文文档](docs/README_zh.md) | [AI Assistant Guide](docs/ASSISTANT_GUIDE.md)
 
 ## 🏛️ Architecture
 
@@ -30,19 +33,21 @@ Nexus stores all data in the local file system (customizable path), ensuring com
 Nexus_Storage/
 ├── global/
 │   ├── blueprint.md       # Master Strategy
-│   ├── discussion.json    # Chat History
-│   ├── docs_index.json    # Global Docs Metadata
+│   ├── discussion.json    # Global Chat History (fallback)
+│   ├── docs_index.json    # Global Docs Index
 │   └── docs/              # Global Markdown Docs
 │       ├── coding-standards.md
 │       └── deployment-flow.md
 ├── projects/
-│   ├── my-app/
-│   │   ├── manifest.json  # Project Metadata
-│   │   ├── internal_blueprint.md
-│   │   └── assets/        # Binary Assets
-│   └── ...
+│   └── {project-id}/
+│       ├── manifest.json          # Project Metadata
+│       ├── internal_blueprint.md  # Technical Implementation Docs
+│       └── assets/                # Binary Assets (images, PDFs)
+├── meetings/              # Meeting files (JSON fallback mode)
+│   └── {meeting-id}.json
 ├── registry.json          # Global Project Index
-└── archives/              # (Reserved for backups)
+├── archives/              # Reserved for backups
+└── nexus.db               # SQLite Database (meetings, tasks, state)
 ```
 
 **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.
@@ -78,32 +83,55 @@ 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`: **[Incremental]** Returns only unread messages per IDE instance. Server tracks read cursor automatically.
 - `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)
+- `get_global_topology`: **[Progressive]** Default: summary list. With `projectId`: detailed subgraph.
+- `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.
+**Core Resources (Static):**
+- `mcp://nexus/chat/global`: Real-time conversation history.
+- `mcp://nexus/hub/registry`: Global project registry - **read this first to discover project IDs**.
+- `mcp://nexus/docs/global-strategy`: Strategic blueprint.
+- `mcp://nexus/docs/list`: Index of shared documents.
+- `mcp://nexus/meetings/list`: List of active and closed meetings.
+- `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.
+
+**Resource Templates (Use registry to discover IDs):**
+- `mcp://nexus/projects/{projectId}/manifest`: Full metadata for a specific project.
+- `mcp://nexus/projects/{projectId}/internal-docs`: Internal technical docs for a project.
+- `mcp://nexus/docs/{docId}`: Read a specific shared document.
+- `mcp://nexus/meetings/{meetingId}`: Full transcript for a specific meeting.
 
 ## 🚀 Quick Start
 
@@ -172,8 +200,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/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.1",
             ...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 };
@@ -71,36 +89,31 @@ export async function getResourceContent(uri, currentProject) {
 }
 /**
  * Returns the list of available resources for MCP ListResourcesRequestSchema
+ *
+ * OPTIMIZATION: No longer lists individual projects dynamically.
+ * Uses resourceTemplates instead - AI should query registry first.
  */
 export async function listResources() {
     const registry = await StorageManager.listRegistry();
-    const projectIds = Object.keys(registry.projects);
+    const projectCount = Object.keys(registry.projects).length;
     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/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 = {
-                    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}`
-                };
-            })
+            // Core resources (static, always available)
+            { uri: "mcp://nexus/chat/global", name: "Global Chat", description: "Real-time discussion stream." },
+            { uri: "mcp://nexus/hub/registry", name: "Project Registry", description: `Index of ${projectCount} registered projects. Read this first to discover project IDs.` },
+            { uri: "mcp://nexus/docs/list", name: "Docs Index", description: "List of shared cross-project documents." },
+            { uri: "mcp://nexus/docs/global-strategy", name: "Strategy Blueprint", description: "Top-level coordination document." },
+            { uri: "mcp://nexus/meetings/list", name: "Meetings List", description: "Active and closed meetings." },
+            { uri: "mcp://nexus/session", name: "Session Info", description: "Your identity and role." },
+            { uri: "mcp://nexus/status", name: "System Status", description: "Storage mode and active meeting count." },
+            { uri: "mcp://nexus/active-meeting", name: "Active Meeting", description: "Current default meeting transcript." }
         ],
         resourceTemplates: [
-            { uriTemplate: "mcp://hub/projects/{projectId}/internal-docs", name: "Internal Project Docs", description: "Markdown-based detailed implementation plans." },
-            { uriTemplate: "mcp://nexus/meetings/{meetingId}", name: "Meeting Insights", description: "Full transcript and decisions for a specific meeting." }
+            // Project resources - use registry to discover IDs first
+            { uriTemplate: "mcp://nexus/projects/{projectId}/manifest", name: "Project Manifest", description: "Metadata for a specific project. Get projectId from registry." },
+            { uriTemplate: "mcp://nexus/projects/{projectId}/internal-docs", name: "Project Docs", description: "Internal implementation guide for a project." },
+            { uriTemplate: "mcp://nexus/docs/{docId}", name: "Global Doc", description: "Read a specific shared document." },
+            { uriTemplate: "mcp://nexus/meetings/{meetingId}", name: "Meeting Details", description: "Full transcript 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.
@@ -96,21 +104,76 @@ export class StorageManager {
         await fs.writeFile(path.join(assetDir, fileName), content);
         return path.join("projects", id, "assets", fileName);
     }
-    static async calculateTopology() {
+    /**
+     * Calculate project dependency topology.
+     *
+     * Context7-style progressive loading:
+     * - Default: Returns summary (project list + stats) - lightweight
+     * - With projectId: Returns detailed subgraph for that project
+     */
+    static async calculateTopology(projectId) {
         const registry = await this.listRegistry();
         const projectIds = Object.keys(registry.projects);
-        const nodes = [];
-        const edges = [];
+        // Collect manifests
+        const manifests = new Map();
+        let totalEdges = 0;
         for (const id of projectIds) {
             const manifest = await this.getProjectManifest(id);
-            if (!manifest)
-                continue;
-            nodes.push({ id, name: manifest.name, type: "project" });
-            (manifest.relations || []).forEach(rel => {
-                edges.push({ from: id, to: rel.targetId, type: rel.type });
+            if (manifest) {
+                manifests.set(id, manifest);
+                totalEdges += (manifest.relations || []).length;
+            }
+        }
+        // === FOCUSED MODE: Return detailed subgraph ===
+        if (projectId) {
+            const targetManifest = manifests.get(projectId);
+            if (!targetManifest) {
+                return { mode: "focused", projectId, error: "Project not found", nodes: [], edges: [] };
+            }
+            const nodes = [];
+            const edges = [];
+            // Add target node
+            nodes.push({ id: projectId, name: targetManifest.name });
+            // Outgoing relations
+            const connectedIds = new Set();
+            (targetManifest.relations || []).forEach(rel => {
+                edges.push({ from: projectId, to: rel.targetId, type: rel.type });
+                connectedIds.add(rel.targetId);
             });
+            // Incoming relations
+            for (const [id, manifest] of manifests) {
+                if (id === projectId)
+                    continue;
+                (manifest.relations || []).forEach(rel => {
+                    if (rel.targetId === projectId) {
+                        edges.push({ from: id, to: projectId, type: rel.type });
+                        connectedIds.add(id);
+                    }
+                });
+            }
+            // Add connected nodes
+            for (const id of connectedIds) {
+                const m = manifests.get(id);
+                if (m)
+                    nodes.push({ id, name: m.name });
+            }
+            return { mode: "focused", projectId, nodes, edges };
         }
-        return { nodes, edges };
+        // === LIST MODE: Return lightweight summary ===
+        const projects = Array.from(manifests.entries()).map(([id, m]) => ({
+            id,
+            name: m.name,
+            relationsCount: (m.relations || []).length
+        }));
+        return {
+            mode: "list",
+            summary: {
+                totalProjects: projects.length,
+                totalEdges,
+                hint: "Call with projectId to get detailed subgraph"
+            },
+            projects
+        };
     }
     // --- Discussion & Log Management ---
     /**

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
      */