@datafrog-io/n2n-nexus 0.1.7 → 0.1.8

package/build/tools/handlers.js

@@ -2,6 +2,7 @@ import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
 import { promises as fs } from "fs";
 import { CONFIG } from "../config.js";
 import { StorageManager } from "../storage/index.js";
+import { UnifiedMeetingStore } from "../storage/store.js";
 /**
  * Validation helper for Project IDs.
  */
@@ -48,10 +49,21 @@ export async function handleToolCall(name, toolArgs, ctx) {
             return handleRenameProject(toolArgs, ctx);
         case "list_projects":
             return handleListProjects();
-        case "delete_project":
+        case "moderator_delete_project":
             return handleRemoveProject(toolArgs, ctx);
         case "moderator_maintenance":
             return handleModeratorMaintenance(toolArgs, ctx);
+        // --- Meeting Tools ---
+        case "start_meeting":
+            return handleStartMeeting(toolArgs, ctx);
+        case "end_meeting":
+            return handleEndMeeting(toolArgs, ctx);
+        case "list_meetings":
+            return handleListMeetings(toolArgs);
+        case "read_meeting":
+            return handleReadMeeting(toolArgs);
+        case "archive_meeting":
+            return handleArchiveMeeting(toolArgs);
         default:
             throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
     }
@@ -186,15 +198,73 @@ async function handleGetTopology() {
 async function handlePostDiscussion(args, ctx) {
     if (!args?.message)
         throw new McpError(ErrorCode.InvalidParams, "Message content cannot be empty.");
-    await StorageManager.addGlobalLog(`${CONFIG.instanceId}@${ctx.currentProject || "Global"}`, args.message, args.category);
-    // Notify chat resource update
-    ctx.notifyResourceUpdate("mcp://chat/global");
-    return { content: [{ type: "text", text: `Message broadcasted to Nexus Room${args.category ? ` [${args.category}]` : ""}.` }] };
+    const from = `${CONFIG.instanceId}@${ctx.currentProject || "Global"}`;
+    const message = {
+        timestamp: new Date().toISOString(),
+        from,
+        text: args.message,
+        category: args.category
+    };
+    // Check for active meeting - auto-route if exists
+    const activeMeeting = await UnifiedMeetingStore.getActiveMeeting();
+    if (activeMeeting) {
+        // Route to active meeting
+        await UnifiedMeetingStore.addMessage(activeMeeting.id, message);
+        ctx.notifyResourceUpdate(`mcp://meetings/${activeMeeting.id}`);
+        ctx.notifyResourceUpdate("mcp://chat/global");
+        return {
+            content: [{
+                    type: "text",
+                    text: `Message posted to active meeting '${activeMeeting.topic}' (${activeMeeting.id})${args.category ? ` [${args.category}]` : ""}.`
+                }]
+        };
+    }
+    else {
+        // Fallback to global discussion (backward compatibility)
+        await StorageManager.addGlobalLog(from, args.message, args.category);
+        ctx.notifyResourceUpdate("mcp://chat/global");
+        return {
+            content: [{
+                    type: "text",
+                    text: `Message broadcasted to Nexus Room (no active meeting)${args.category ? ` [${args.category}]` : ""}.`
+                }]
+        };
+    }
 }
 async function handleReadRecentDiscussion(args) {
     const count = args?.count || 10;
+    // If meetingId specified, read from that meeting
+    if (args?.meetingId) {
+        const messages = await UnifiedMeetingStore.getRecentMessages(count, args.meetingId);
+        return { content: [{ type: "text", text: JSON.stringify(messages, null, 2) }] };
+    }
+    // Check for active meeting first
+    const activeMeeting = await UnifiedMeetingStore.getActiveMeeting();
+    if (activeMeeting) {
+        const messages = await UnifiedMeetingStore.getRecentMessages(count, activeMeeting.id);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        source: "meeting",
+                        meetingId: activeMeeting.id,
+                        topic: activeMeeting.topic,
+                        messages
+                    }, null, 2)
+                }]
+        };
+    }
+    // Fallback to global logs
     const logs = await StorageManager.getRecentLogs(count);
-    return { content: [{ type: "text", text: JSON.stringify(logs, null, 2) }] };
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    source: "global",
+                    messages: logs
+                }, null, 2)
+            }]
+    };
 }
 async function handleUpdateStrategy(args, _ctx) {
     if (!args?.content)
@@ -264,3 +334,80 @@ async function handleModeratorMaintenance(args, ctx) {
         }
     }
 }
+// --- Meeting Handlers ---
+async function handleStartMeeting(args, ctx) {
+    if (!args?.topic)
+        throw new McpError(ErrorCode.InvalidParams, "Topic is required to start a meeting.");
+    const initiator = ctx.currentProject ? `${CONFIG.instanceId}@${ctx.currentProject}` : `${CONFIG.instanceId}@Global`;
+    const meeting = await UnifiedMeetingStore.startMeeting(args.topic, initiator);
+    // Notify updates
+    ctx.notifyResourceUpdate("mcp://nexus/status");
+    ctx.notifyResourceUpdate("mcp://chat/global");
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    message: `Meeting started (Topic: '${args.topic}').`,
+                    meetingId: meeting.id,
+                    topic: args.topic,
+                    status: meeting.status,
+                    startTime: meeting.startTime
+                }, null, 2)
+            }]
+    };
+}
+async function handleEndMeeting(args, ctx) {
+    let targetId = args.meetingId;
+    if (!targetId) {
+        const active = await UnifiedMeetingStore.getActiveMeeting();
+        if (!active)
+            throw new McpError(ErrorCode.InvalidRequest, "No active meeting found to end. Please specify meetingId.");
+        targetId = active.id;
+    }
+    const { meeting, suggestedSyncTargets } = await UnifiedMeetingStore.endMeeting(targetId, args.summary);
+    ctx.notifyResourceUpdate("mcp://nexus/status");
+    ctx.notifyResourceUpdate("mcp://chat/global");
+    const suggestionText = suggestedSyncTargets.length > 0
+        ? `\nSuggested sync targets: ${suggestedSyncTargets.join(", ")}`
+        : "";
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    message: `Meeting '${meeting.topic}' closed.`,
+                    meetingId: meeting.id,
+                    topic: meeting.topic,
+                    status: meeting.status,
+                    decisionsCount: meeting.decisions.length,
+                    suggestedSyncTargets
+                }, null, 2)
+            }]
+    };
+}
+async function handleListMeetings(args) {
+    const meetings = await UnifiedMeetingStore.listMeetings(args.status);
+    return { content: [{ type: "text", text: JSON.stringify(meetings, null, 2) }] };
+}
+async function handleReadMeeting(args) {
+    if (!args.meetingId)
+        throw new McpError(ErrorCode.InvalidParams, "meetingId is required.");
+    const meeting = await UnifiedMeetingStore.getMeeting(args.meetingId);
+    if (!meeting)
+        throw new McpError(ErrorCode.InvalidRequest, `Meeting '${args.meetingId}' not found.`);
+    return { content: [{ type: "text", text: JSON.stringify(meeting, null, 2) }] };
+}
+async function handleArchiveMeeting(args) {
+    if (!args.meetingId)
+        throw new McpError(ErrorCode.InvalidParams, "meetingId is required.");
+    await UnifiedMeetingStore.archiveMeeting(args.meetingId);
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    message: `Meeting '${args.meetingId}' archived.`,
+                    meetingId: args.meetingId,
+                    status: "archived"
+                }, null, 2)
+            }]
+    };
+}

package/build/utils/async-mutex.js

@@ -0,0 +1,36 @@
+/**
+ * Simple mutex lock for preventing concurrent file writes.
+ * Ensures that only one write operation can happen at a time.
+ */
+export 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();
+            if (next)
+                next();
+        }
+        else {
+            this.locked = false;
+        }
+    }
+    async withLock(fn) {
+        await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+}

package/docs/ASSISTANT_GUIDE.md

@@ -0,0 +1,66 @@
+# Nexus 助手协作指令
+
+你现在是 **n2ns Nexus** 协作网络的一员。该系统集成了实时通信与结构化资产管理，所有操作均落地在本地文件系统。
+
+## 🚦 你的标准动作集
+
+### 1. 启动即签到与角色发现
+在任何任务开始前，你**必须**了解自己的身份：
+- **查看身份与状态**：读取 `mcp://nexus/session` 查看个人标识，读取 `mcp://nexus/status` 查看系统版本、存储模式（SQLite/JSON）及活跃会议数。
+- **声明位置**：调用 `register_session_context(projectId)`。这会让 Nexus 知道你现在负责哪个项目，并解锁该项目的写权限。
+
+### 2. 信息归档与项目管理 (Project Hub)
+当你完成架构设计或技术选型后，请同步资产：
+
+*   **全量同步 (初始化/重构)**:
+    *   `sync_project_assets`：**强制要求**包含完整的 `manifest` 对象和 `internalDocs`。
+    *   务必准确填写 `relations`（依赖关系），这决定了全局拓扑图的形态。
+
+*   **增量维护 (日常开发)**:
+    *   `update_project`: 当只修改个别字段（如新增 API 端点、更新技术栈列表）时使用。不要每次都全量覆盖。
+    *   `rename_project`: 如果项目 ID 需要变更，**必须**使用此工具，系统会自动更新所有依赖该项目的 Manifest 引用，保持拓扑完整性。
+
+*   **素材上传**:
+    *   `upload_project_asset`: 将 UI 稿、架构图等转为 Base64 上传。
+
+### 3. 全局知识库 (Global Knowledge)
+除了项目私有文档，我们维护一套跨项目的通用知识库：
+- `list_global_docs`: 查找现有的通用规范（如“Coding Standards”, “Deployment Flow”）。
+- `read_global_doc`: 读取具体内容。
+- `sync_global_doc`: 创建或更新全局文档。适用于提炼通用的最佳实践。
+
+### 4. 即时同步 (Communication)
+- `post_global_discussion`：任何跨项目的冲突或依赖，必须在全局频道通报。
+- `update_global_strategy`：在达成共识后，更新最高层级的战略蓝图 (`Master Plan`)。
+
+### 5. 会议管理 (Meeting Management) 🆕
+当需要结构化的跨 Agent 讨论时，使用会议功能：
+
+*   **发起会议**:
+    *   `start_meeting(topic)`: 创建独立的会议文件，返回 `meetingId`。所有后续消息将自动路由到此会议。
+
+*   **参与讨论**:
+    *   `post_global_discussion`: 消息会自动关联到当前活跃会议（无需手动指定 `meetingId`）。
+
+*   **结束会议**:
+    *   `end_meeting(meetingId?, summary?)`: 锁定会议，禁止后续写入。返回 `suggestedSyncTargets`（基于参与者推断的项目列表）。
+
+*   **查阅历史**:
+    *   `list_meetings(status?)`: 查看 `active`、`closed` 或 `archived` 状态的会议列表。
+    *   **快速查阅**：直接读取 `mcp://nexus/active-meeting` 资源，获取当前默认活跃会议的完整 transcript。
+    *   `read_meeting(meetingId)`: 读取指定会议内容，包括 `messages` 和 `decisions`。
+
+*   **归档**:
+    *   `archive_meeting(meetingId)`: 将已关闭的会议归档，仅供只读查阅。
+
+### 6. 视角切换 (Discovery)
+- 读取 `mcp://hub/registry`：了解公司目前有哪些其他项目。
+- 调用 `get_global_topology`：可视化项目间的依赖关系，避免重复造轮子。
+- 调用 `read_project`：查阅其他项目的 API 定义 (`include: "api"`) 或技术文档 (`include: "docs"`)，以便对接。
+
+## 🛡️ 角色说明
+- **Regular**: 拥有注册、同步资产、讨论和更新各类文档的完整权限。
+- **Moderator**: 额外拥有清理历史记录（`moderator_maintenance`）及物理删除项目资产（`moderator_delete_project`）的权限。启动时需添加 `--moderator` 参数。
+
+## ❌ 退出机制
+本系统不依赖 GitHub，你的所有 `sync` 操作都是对本地磁盘的原子写入。请确保在同步时提供清晰的 `internalDocs`。

package/docs/CHANGELOG.md

@@ -0,0 +1,141 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [v0.1.8] - 2025-12-30
+
+### 🎯 Meeting Architecture (Phase 1 & 2)
+- **Hybrid Storage Backend**: Automatic selection between **SQLite** (preferred) and **JSON Fallback**.
+- **SQLite Engine**: Powered by `better-sqlite3` with **WAL mode** for high-concurrency and multi-process safety.
+- **New Lifecycle Entity**: `MeetingSession` replaces monolithic chat logs with discrete sessions.
+- **Lifecycle Tools**:
+  - `start_meeting(topic)`: Creates dedicated session with unique ID and random entropy.
+  - `end_meeting(meetingId?, summary?)`: Closes meeting, collects decisions.
+  - `archive_meeting(meetingId)`: Moves sessions to historical archives.
+  - `list_meetings(status?)`: Filtered discovery of sessions.
+  - `read_meeting(meetingId)`: Detailed retrieval of history, participants, and decisions.
+
+### 🏗️ API & Storage Improvements
+- **Structured JSON Responses**: Meeting tools now return machine-readable JSON for better agent integration.
+- **Smart Auto-Routing**: Global discussion messages are automatically routed to active meetings.
+- **ID Generation**: Robust slug generation with Base64 fallback for non-ASCII topics (Chinese/Unicode).
+- **Concurrency Control**: Shared `AsyncMutex` utility and native SQLite locking.
+- **Status Reporting**: `mcp://nexus/status` now reports `storage_mode` and `is_degraded` flags.
+
+### 🧪 Quality Assurance
+- **Comprehensive Test Suite**: Added 24+ integration and stress tests (100% Green).
+- **Concurrency Stress Tests**: Validated data integrity under rapid message bursts.
+- **Fallback Verification**: Confirmed system stability when native modules are unavailable.
+
+### 🛡️ Security
+- **Hardened Project Deletion**: Renamed `delete_project` to `moderator_delete_project` and enforced explicit moderator validation to prevent unauthorized project destruction.
+- **Path Sanitization**: Enhanced error handling to strip absolute local file paths from MCP error messages.
+
+### 📄 Resources & Documentation
+- **New Resource**: Added `mcp://nexus/active-meeting` for instant access to the current meeting transcript and decisions.
+- **Improved Tooling UX**: Documented return value structures and administrative requirements in tool definitions.
+- **Manuals**: Updated `ASSISTANT_GUIDE.md` and both README versions with new admin tool documentation and Phase 2 best practices.
+
+## [v0.1.7] - 2025-12-30
+
+### ⚙️ CLI Simplification
+- **Moderator flag**: Replaced `--moderator-id <id>` with simple `--moderator` boolean flag.
+  - Moderator: `--id Master-AI --moderator`
+  - Regular AI: `--id Assistant-AI` (no extra flag needed)
+
+### ✅ Tests
+- Added session resource tests for role verification (Moderator/Regular).
+- All 17 unit tests passing.
+
+## [v0.1.6] - 2025-12-29
+
+### 🔒 Concurrency Safety
+- **AsyncMutex Lock**: Implemented mutex-based concurrency control to prevent race conditions during simultaneous file writes.
+- Protected write operations:
+  - Discussion: `addGlobalLog()`, `pruneGlobalLogs()`, `clearGlobalLogs()`
+  - Registry: `saveProjectManifest()`, `renameProject()`, `deleteProject()`
+
+### 📦 Schema v2.0
+- **Manifest Schema Enhancements**: Added new optional fields for enterprise coordination:
+  - `apiDependencies`: Map of projectId to version constraint (e.g., `">=v2.1"`)
+  - `gatewayCompatibility`: Gateway version compatibility string
+  - `api_versions`: Feature-level API versions
+  - `feature_tier`: Capability tier declaration (`"free"` | `"pro"` | `"enterprise"`)
+
+## [v0.1.5] - 2025-12-29
+
+### 🚀 Major Features
+- **Project ID Naming Convention**: Enforced `[prefix]_[technical-name]` standard with 13 type prefixes (web_, api_, chrome_, vscode_, mcp_, android_, ios_, flutter_, desktop_, lib_, bot_, infra_, doc_).
+- **MCP Prompts Capability**: Added `init_project_nexus` prompt for guiding AI through proper project registration workflow.
+- **delete_project Tool**: New admin tool for complete project removal (manifest, assets, registry entry).
+
+### 🔒 Guardrails
+- Added `validateProjectId()` with runtime regex validation in `handleRegisterSession`, `handleSyncProjectAssets`, and `handleRenameProject`.
+- Projects with invalid ID formats are now rejected at the API level.
+
+### ✨ Enhancements
+- Resource names now display project type icons (e.g., "🌐 Website: web_example.com").
+- Handler unit tests expanded to cover delete, rename, and validation scenarios.
+
+### 📄 Documentation
+- Added "Project ID Conventions" section to README.md.
+- Updated tool descriptions with Prefix Dictionary guidance.
+
+## [v0.1.4] - 2025-12-29
+
+### 🐛 Bug Fix
+- Added shebang (`#!/usr/bin/env node`) to fix npx execution on Windows.
+
+## [v0.1.3] - 2025-12-29
+
+### 🔧 CI/CD
+- Switched to npm Trusted Publishing (OIDC) - no more NPM_TOKEN needed.
+- Upgraded to Node.js 22 for npm 11.5.1+ support.
+- Added `--provenance` flag for supply chain security.
+
+## [v0.1.2] - 2025-12-29
+
+### 🔧 Refactoring
+- Modularized codebase into `tools/`, `resources/`, and `storage/` modules.
+- Reduced `index.ts` from 535 to 115 lines.
+- Moved tests from `src/__tests__/` to top-level `tests/` directory.
+
+### 📦 CI/CD
+- Changed GitHub Actions trigger from `release` to tag push (`v*`).
+
+### 📄 Documentation
+- Added npm downloads badge.
+- Fixed repository URLs to `n2n-nexus`.
+
+## [v0.1.1] - 2025-12-29
+
+### 📦 npm Release
+- Published to npm as `@datafrog-io/n2n-nexus`.
+- Updated README with `npx` configuration for easy MCP integration.
+- Added CLI arguments documentation table.
+
+## [v0.1.0] - 2025-12-29
+
+### 🚀 Major Features
+- **Project Asset Hub**: Centralized storage for Project Manifests, Internal Docs, and Assets (Images/Files).
+- **Communication Channels**:
+    - `mcp://chat/global`: Real-time inter-agent messaging stream.
+    - `post_global_discussion`: Broadcast tool for coordination.
+- **Topology Engine**:
+    - `get_global_topology`: Auto-generates dependency graphs based on manifest `relations`.
+- **Global Knowledge Base**:
+    - New `docs/` directory structure for shared standards.
+    - Tools: `sync_global_doc`, `read_global_doc`, `list_global_docs`.
+- **Self-Healing Storage**:
+    - Automatic repair of corrupted JSON registries or logs.
+    - Safe-defaults for missing configurations.
+
+### 🛠️ Tooling
+- Added `update_project` for partial manifest patches.
+- Added `rename_project` with auto-cascading reference updates across all projects.
+- Added `register_session_context` for IDE session binding.
+- Added `moderator_maintenance` for log pruning.
+
+### 📚 Documentation
+- Updated `README.md` with complete architecture diagrams and data persistence details.
+- Added `ASSISTANT_GUIDE.md` for AI-to-AI operational protocols.

package/docs/CHANGELOG_zh.md

@@ -0,0 +1,141 @@
+# 更新日志
+
+本项目的所有重要变更都将记录在此文件中。
+
+## [v0.1.8] - 2025-12-30
+
+### 🎯 会议架构 (Phase 1 & 2)
+- **混合存储后端**: 自动选择 **SQLite** (优先) 或 **JSON Fallback**。
+- **SQLite 引擎**: 基于 `better-sqlite3` 并启用 **WAL 模式**，支持高并发和多进程安全访问。
+- **新生命周期实体**: `MeetingSession` 取代单体日志，实现结构化会议管理。
+- **生命周期工具**:
+  - `start_meeting(topic)`: 创建独立会议，具备防碰撞 ID 生成逻辑。
+  - `end_meeting(meetingId?, summary?)`: 关闭会议并自动汇总决策。
+  - `archive_meeting(meetingId)`: 将关闭的会议移至历史存档数据层。
+  - `list_meetings(status?)`: 按状态筛选浏览会议。
+  - `read_meeting(meetingId)`: 详细读取历史记录、参会者和决策。
+
+### 🏗️ API 与存储优化
+- **结构化 JSON 响应**: 会议工具现在返回机器可读的 JSON，方便 Agent 集成。
+- **智能自动路由**: 全局讨论消息将自动路由至当前活跃的会议。
+- **ID 生成增强**: 为非 ASCII 主题 (如中文) 增加 Base64 回退和随机后缀，确保 ID 唯一性。
+- **并发控制**: 提取通用的 `AsyncMutex` 工具类，优化 SQLite 原生锁支持。
+- **状态报告**: `mcp://nexus/status` 现在报告 `storage_mode` 和 `is_degraded` (降级) 标志。
+
+### 🧪 质量保障
+- **全方位测试套件**: 新增 24+ 项集成与压力测试 (100% 通过)。
+- **并发压力测试**: 验证在高频消息并发情况下的数据完整性。
+- **回退验证**: 确认系统在缺失原生模块时能稳定回退至 JSON 模式。
+
+### 🛡️ 安全与权限 (Security)
+- **工具权限加固**: 将 `delete_project` 重命名为 `moderator_delete_project`，并强制执行管理员身份验证，防止未授权删除项目。
+- **错误信息脱敏**: 进一步优化了错误处理器，确保不向 AI 暴露本地绝对路径。
+
+### 📄 资源与文档 (Resources & Docs)
+- **新资源接口**: 增加了 `mcp://nexus/active-meeting` 资源，支持一键读取当前会议的完整 transcript 和决策。
+- **README 补全**: 在中英文文档中同步更新了管理工具 (`Admin`) 章节，增加了新增工具的用法说明。
+- **开发指南**: 更新了 `ASSISTANT_GUIDE.md`，提供了会议管理和同步的最佳实践。
+
+## [v0.1.7] - 2025-12-30
+
+### ⚙️ CLI 简化
+- **Moderator 标志**: 将 `--moderator-id <id>` 替换为简单的 `--moderator` 布尔标志。
+  - 主持者: `--id Master-AI --moderator`
+  - 普通 AI: `--id Assistant-AI` (无需额外参数)
+
+### ✅ 测试
+- 新增 session 资源角色验证测试 (Moderator/Regular)。
+- 全部 17 个单元测试通过。
+
+## [v0.1.6] - 2025-12-29
+
+### 🔒 并发安全
+- **AsyncMutex 互斥锁**: 实现基于互斥锁的并发控制，防止多 AI 同时写入时的竞态条件。
+- 受保护的写入操作：
+  - Discussion 文件: `addGlobalLog()`, `pruneGlobalLogs()`, `clearGlobalLogs()`
+  - Registry 文件: `saveProjectManifest()`, `renameProject()`, `deleteProject()`
+
+### 📦 Schema v2.0
+- **Manifest Schema 增强**: 新增可选字段，支持企业级协同：
+  - `apiDependencies`: 项目依赖版本映射 (如 `">=v2.1"`)
+  - `gatewayCompatibility`: 网关版本兼容性字符串
+  - `api_versions`: 功能级 API 版本
+  - `feature_tier`: 能力等级声明 (`"free"` | `"pro"` | `"enterprise"`)
+
+## [v0.1.5] - 2025-12-29
+
+### 🚀 主要功能
+- **项目 ID 命名规范**: 强制执行 `[prefix]_[technical-name]` 格式，共 13 种类型前缀 (web_, api_, chrome_, vscode_, mcp_, android_, ios_, flutter_, desktop_, lib_, bot_, infra_, doc_)。
+- **MCP Prompts 能力**: 新增 `init_project_nexus` Prompt，引导 AI 完成规范化项目注册流程。
+- **delete_project 工具**: 新增管理员工具，用于完全删除项目（包括清单、资产、注册表条目）。
+
+### 🔒 防护栏 (Guardrails)
+- 新增 `validateProjectId()` 函数，在 `handleRegisterSession`、`handleSyncProjectAssets`、`handleRenameProject` 中进行运行时正则校验。
+- 非法 ID 格式的项目将在 API 层被拒绝。
+
+### ✨ 增强
+- 资源名称现在显示项目类型图标（如 "🌐 Website: web_example.com"）。
+- Handler 单元测试扩展，覆盖删除、重命名和校验场景。
+
+### 📄 文档
+- 在 README.md 中新增 "Project ID Conventions" 章节。
+- 更新工具描述，加入前缀字典 (Prefix Dictionary) 指引。
+
+## [v0.1.4] - 2025-12-29
+
+### 🐛 Bug 修复
+- 添加 shebang (`#!/usr/bin/env node`) 以修复 Windows 上 npx 执行问题。
+
+## [v0.1.3] - 2025-12-29
+
+### 🔧 CI/CD
+- 切换至 npm Trusted Publishing (OIDC) - 无需 NPM_TOKEN。
+- 升级至 Node.js 22 以支持 npm 11.5.1+。
+- 添加 `--provenance` 标志以增强供应链安全。
+
+## [v0.1.2] - 2025-12-29
+
+### 🔧 重构
+- 代码模块化：拆分为 `tools/`、`resources/`、`storage/` 模块。
+- `index.ts` 从 535 行精简至 115 行。
+- 测试文件从 `src/__tests__/` 移至顶层 `tests/` 目录。
+
+### 📦 CI/CD
+- GitHub Actions 触发方式从 `release` 改为 tag 推送 (`v*`)。
+
+### 📄 文档
+- 新增 npm 下载量徽章。
+- 修复仓库 URL 为 `n2n-nexus`。
+
+## [v0.1.1] - 2025-12-29
+
+### 📦 npm 发布
+- 发布到 npm：`@datafrog-io/n2n-nexus`。
+- 更新 README，添加 `npx` 配置方式以便快速集成 MCP。
+- 新增 CLI 命令行参数说明表格。
+
+## [v0.1.0] - 2025-12-29
+
+### 🚀 主要功能
+- **项目资产中心 (Project Asset Hub)**: 集中存储项目清单 (Manifest)、内部文档 (Internal Docs) 和资产 (图片/文件)。
+- **通信频道 (Communication Channels)**:
+    - `mcp://chat/global`: 实时跨 Agent 消息流。
+    - `post_global_discussion`: 用于协调的广播工具。
+- **拓扑引擎 (Topology Engine)**:
+    - `get_global_topology`: 基于 Manifest 中的 `relations` 自动生成依赖关系图。
+- **全局知识库 (Global Knowledge Base)**:
+    - 新增 `docs/` 目录结构，用于存储共享标准。
+    - 工具: `sync_global_doc`, `read_global_doc`, `list_global_docs`.
+- **自我修复存储 (Self-Healing Storage)**:
+    - 自动修复损坏的 JSON 注册表或日志文件。
+    - 缺失配置时的安全默认值。
+
+### 🛠️ 工具集更新
+- 新增 `update_project`: 支持 Manifest 局部字段更新。
+- 新增 `rename_project`: 支持项目重命名，并自动级联更新所有引用。
+- 新增 `register_session_context`: 用于 IDE 会话绑定。
+- 新增 `moderator_maintenance`: 用于日志修剪。
+
+### 📚 文档
+- 更新 `README.md`: 补充了完整的架构图和数据持久化细节。
+- 新增 `ASSISTANT_GUIDE.md`: AI 对 AI 的操作协议指南。