@datafrog-io/n2n-nexus 0.1.7 → 0.1.8

package/README.md

@@ -94,6 +94,7 @@ To ensure clarity and prevent collisions in the flat local namespace, all Projec
 
 ### D. Admin (Moderator Only)
 - `moderator_maintenance`: Prune or clear system logs.
+- `moderator_delete_project`: Completely remove a project and its assets.
 
 ## 📄 Resources (URI)
 

package/README_zh.md

@@ -0,0 +1,143 @@
+# 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)
+[![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
+
+## 🏛️ 系统架构 (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 和内部技术文档。
+    - **Manifest**: 包含 ID、技术栈、**依赖关系 (Relations)**、仓库地址、本地路径、API Spec 等。
+- `update_project`: 部分更新 Manifest 字段（如仅更新 endpoints 或 description）。
+- `rename_project`: 重命名项目 ID，自动级联更新所有相关项目的依赖引用。
+- `upload_project_asset`: 上传二进制/文本文件（Base64）到项目库。
+- `read_project`: 读取项目的特定数据切片（Summary, Manifest, Docs, API, Relations等）。
+
+### 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)
+- `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 配置（推荐）
+
+在你的 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
+```
+
+---
+© 2025 datafrog.io. Built for Local-Only AI Workflows.

package/build/index.js

@@ -15,7 +15,7 @@ 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: "0.1.8" }, { capabilities: { resources: {}, tools: {}, prompts: {} } });
         this.setupHandlers();
     }
     /**

package/build/resources/index.js

@@ -1,6 +1,7 @@
 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
  */
@@ -27,6 +28,30 @@ 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.1.8",
+            ...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.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) };
+    }
     // Dynamic Project Resources (Handles Namespaces)
     if (uri.startsWith("mcp://hub/projects/")) {
         if (uri.endsWith("/manifest")) {
@@ -56,6 +81,8 @@ 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." },
+            { 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 = {
@@ -72,7 +99,8 @@ export async function listResources() {
             })
         ],
         resourceTemplates: [
-            { uriTemplate: "mcp://hub/projects/{projectId}/internal-docs", name: "Internal Project Docs", description: "Markdown-based detailed implementation plans." }
+            { 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." }
         ]
     };
 }

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();

package/build/storage/meetings.js

@@ -0,0 +1,242 @@
+import { promises as fs } from "fs";
+import path from "path";
+import { CONFIG } from "../config.js";
+import { AsyncMutex } from "../utils/async-mutex.js";
+/**
+ * MeetingStore - Handles all meeting-related storage operations
+ */
+export class MeetingStore {
+    static meetingLock = new AsyncMutex();
+    static stateLock = new AsyncMutex();
+    // --- Path Definitions ---
+    static get meetingsDir() { return path.join(CONFIG.rootStorage, "meetings"); }
+    static get stateFile() { return path.join(CONFIG.rootStorage, "global", "meeting_state.json"); }
+    /**
+     * Initialize meeting storage directories
+     */
+    static async init() {
+        await fs.mkdir(this.meetingsDir, { recursive: true });
+        await this.loadStateSafe();
+    }
+    /**
+     * Check if a path exists
+     */
+    static async exists(p) {
+        try {
+            await fs.access(p);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Load meeting state with self-healing
+     */
+    static async loadStateSafe() {
+        const defaultState = { activeMeetings: [], defaultMeetingId: null };
+        try {
+            if (!await this.exists(this.stateFile)) {
+                await fs.writeFile(this.stateFile, JSON.stringify(defaultState, null, 2), "utf-8");
+                return defaultState;
+            }
+            const content = await fs.readFile(this.stateFile, "utf-8");
+            const cleanContent = content.replace(/^\uFEFF/, '').trim();
+            if (!cleanContent)
+                throw new Error("Empty file");
+            return JSON.parse(cleanContent);
+        }
+        catch (e) {
+            console.warn(`[MeetingStore] Repairing corrupted state file. Error: ${e.message}`);
+            await fs.writeFile(this.stateFile, JSON.stringify(defaultState, null, 2), "utf-8");
+            return defaultState;
+        }
+    }
+    /**
+     * Get current meeting state
+     */
+    static async getState() {
+        return this.loadStateSafe();
+    }
+    /**
+     * Save meeting state
+     */
+    static async saveState(state) {
+        await fs.writeFile(this.stateFile, JSON.stringify(state, null, 2), "utf-8");
+    }
+    /**
+     * Generate a unique meeting ID
+     */
+    static generateMeetingId(topic) {
+        const now = new Date();
+        const timestamp = now.toISOString().replace(/[-:T]/g, '').substring(0, 14);
+        // Create slug from topic, fallback to base64 hash for non-ASCII
+        let slug = topic
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-|-$/g, '')
+            .substring(0, 30);
+        // If slug is empty (e.g., Chinese topic), use base64 of topic
+        if (!slug) {
+            slug = Buffer.from(topic).toString('base64').replace(/[^a-zA-Z0-9]/g, '').substring(0, 8).toLowerCase();
+        }
+        // Add random suffix for uniqueness (prevents collision in same second)
+        const suffix = Math.random().toString(36).substring(2, 6);
+        return `${timestamp}-${slug || 'meeting'}-${suffix}`;
+    }
+    /**
+     * Get the file path for a meeting
+     */
+    static getMeetingPath(id) {
+        return path.join(this.meetingsDir, `${id}.json`);
+    }
+    /**
+     * Start a new meeting
+     */
+    static async startMeeting(topic, initiator) {
+        await this.init();
+        return this.stateLock.withLock(async () => {
+            const id = this.generateMeetingId(topic);
+            const meeting = {
+                id,
+                topic,
+                status: "active",
+                startTime: new Date().toISOString(),
+                participants: [initiator],
+                messages: [],
+                decisions: []
+            };
+            // Save meeting file
+            await fs.writeFile(this.getMeetingPath(id), JSON.stringify(meeting, null, 2), "utf-8");
+            // Update state
+            const state = await this.loadStateSafe();
+            state.activeMeetings.push(id);
+            state.defaultMeetingId = id;
+            await this.saveState(state);
+            return meeting;
+        });
+    }
+    /**
+     * Get a meeting by ID
+     */
+    static async getMeeting(id) {
+        const meetingPath = this.getMeetingPath(id);
+        if (!await this.exists(meetingPath))
+            return null;
+        const content = await fs.readFile(meetingPath, "utf-8");
+        return JSON.parse(content);
+    }
+    /**
+     * Add a message to a meeting
+     */
+    static async addMessage(meetingId, message) {
+        await this.meetingLock.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 ${meeting.status}, cannot add messages.`);
+            // Add message
+            meeting.messages.push(message);
+            // Track participant
+            if (!meeting.participants.includes(message.from)) {
+                meeting.participants.push(message.from);
+            }
+            // Extract decisions
+            if (message.category === "DECISION") {
+                meeting.decisions.push(message.text);
+            }
+            await fs.writeFile(this.getMeetingPath(meetingId), JSON.stringify(meeting, null, 2), "utf-8");
+        });
+    }
+    /**
+     * End a meeting (close it)
+     */
+    static async endMeeting(meetingId, summary) {
+        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}.`);
+            // Close the meeting
+            meeting.status = "closed";
+            meeting.endTime = new Date().toISOString();
+            if (summary)
+                meeting.summary = summary;
+            await fs.writeFile(this.getMeetingPath(meetingId), JSON.stringify(meeting, null, 2), "utf-8");
+            // Update state - remove from active meetings
+            const state = await this.loadStateSafe();
+            state.activeMeetings = state.activeMeetings.filter(id => id !== meetingId);
+            state.defaultMeetingId = state.activeMeetings.length > 0
+                ? state.activeMeetings[state.activeMeetings.length - 1]
+                : null;
+            await this.saveState(state);
+            // Suggest sync targets based on participants (extract project IDs)
+            const suggestedSyncTargets = meeting.participants
+                .map(p => p.split('@')[1])
+                .filter((v, i, a) => v && v !== "Global" && a.indexOf(v) === i);
+            return { meeting, suggestedSyncTargets };
+        });
+    }
+    /**
+     * Archive a closed meeting
+     */
+    static async archiveMeeting(meetingId) {
+        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.`);
+        meeting.status = "archived";
+        await fs.writeFile(this.getMeetingPath(meetingId), JSON.stringify(meeting, null, 2), "utf-8");
+    }
+    /**
+     * List all meetings with optional status filter
+     */
+    static async listMeetings(status) {
+        await this.init();
+        const files = await fs.readdir(this.meetingsDir);
+        const meetings = [];
+        for (const file of files) {
+            if (!file.endsWith('.json'))
+                continue;
+            const id = file.replace('.json', '');
+            const meeting = await this.getMeeting(id);
+            if (!meeting)
+                continue;
+            if (status && meeting.status !== status)
+                continue;
+            meetings.push({
+                id: meeting.id,
+                topic: meeting.topic,
+                status: meeting.status,
+                startTime: meeting.startTime,
+                participantCount: meeting.participants.length
+            });
+        }
+        // Sort by startTime descending
+        return meetings.sort((a, b) => new Date(b.startTime).getTime() - new Date(a.startTime).getTime());
+    }
+    /**
+     * Get the current active meeting (for auto-routing)
+     */
+    static async getActiveMeeting() {
+        const state = await this.getState();
+        if (!state.defaultMeetingId)
+            return null;
+        return this.getMeeting(state.defaultMeetingId);
+    }
+    /**
+     * Get recent messages from the active meeting
+     */
+    static async getRecentMessages(count = 10, meetingId) {
+        const targetId = meetingId || (await this.getState()).defaultMeetingId;
+        if (!targetId)
+            return [];
+        const meeting = await this.getMeeting(targetId);
+        if (!meeting)
+            return [];
+        return meeting.messages.slice(-count);
+    }
+}