@datafrog-io/n2n-nexus 0.1.7 → 0.2.0

package/build/tools/index.js

@@ -1,2 +1,13 @@
-export { TOOL_DEFINITIONS } from "./definitions.js";
+import { TOOL_REGISTRY } from "./schemas.js";
+/**
+ * Dynamically generated Tool Definitions from Zod Schemas.
+ * This ensures Tool Registry and Input Validation are always in sync.
+ * Using native Zod 4 toJSONSchema support.
+ */
+export const TOOL_DEFINITIONS = Object.entries(TOOL_REGISTRY).map(([name, entry]) => ({
+    name,
+    description: entry.description,
+    inputSchema: entry.schema.toJSONSchema()
+}));
 export { handleToolCall } from "./handlers.js";
+export { TOOL_REGISTRY } from "./schemas.js";

package/build/tools/schemas.js

@@ -0,0 +1,275 @@
+import { z } from "zod";
+/**
+ * Project ID validation regex based on Nexus conventions.
+ */
+export const ProjectIdSchema = z.string()
+    .describe("Strict flat identifier. MUST start with a type-prefix followed by an underscore.")
+    .refine(val => {
+    const validPrefixes = ["web_", "api_", "chrome_", "vscode_", "mcp_", "android_", "ios_", "flutter_", "desktop_", "lib_", "bot_", "infra_", "doc_"];
+    return validPrefixes.some(p => val.startsWith(p));
+}, "Project ID must start with a valid prefix (e.g., 'web_', 'api_')")
+    .refine(val => !val.includes("..") && !val.includes("/") && !val.includes("\\"), "Project ID cannot contain '..' or slashes.");
+/**
+ * 1. register_session_context
+ */
+export const RegisterSessionSchema = z.object({
+    projectId: ProjectIdSchema
+});
+/**
+ * 2. sync_project_assets
+ */
+export const SyncProjectAssetsSchema = z.object({
+    manifest: z.object({
+        id: ProjectIdSchema,
+        name: z.string(),
+        description: z.string(),
+        techStack: z.array(z.string()),
+        relations: z.array(z.object({
+            targetId: z.string(),
+            type: z.enum(["dependency", "parent", "child", "related"])
+        })),
+        lastUpdated: z.string().describe("ISO timestamp"),
+        repositoryUrl: z.string(),
+        localPath: z.string().describe("Physical disk path"),
+        endpoints: z.array(z.object({
+            name: z.string(),
+            url: z.string(),
+            description: z.string()
+        })),
+        apiSpec: z.array(z.object({
+            method: z.string(),
+            path: z.string(),
+            summary: z.string()
+        }))
+    }),
+    internalDocs: z.string().describe("Mandatory technical implementation guide (Markdown)")
+});
+/**
+ * Safe file name validation (no path traversal)
+ */
+export const FileNameSchema = z.string()
+    .min(1, "File name cannot be empty")
+    .max(255, "File name too long")
+    .refine(val => !val.includes("/") && !val.includes("\\"), "File name cannot contain slashes")
+    .refine(val => !val.includes(".."), "File name cannot contain '..'")
+    .refine(val => !val.startsWith("."), "File name cannot start with '.'")
+    .describe("Safe file name without path components");
+/**
+ * 3. upload_project_asset
+ */
+export const UploadAssetSchema = z.object({
+    fileName: FileNameSchema,
+    base64Content: z.string()
+});
+/**
+ * 4. get_global_topology (No arguments)
+ */
+export const EmptySchema = z.object({});
+/**
+ * 7. send_message
+ */
+export const SendMessageSchema = z.object({
+    message: z.string().min(1, "Message cannot be empty"),
+    category: z.enum(["MEETING_START", "PROPOSAL", "DECISION", "UPDATE", "CHAT"]).optional()
+});
+/**
+ * 8. read_messages
+ */
+export const ReadMessagesSchema = z.object({
+    count: z.number().int().positive().optional().default(10),
+    meetingId: z.string().optional()
+});
+/**
+ * 9. update_global_strategy
+ */
+export const UpdateStrategySchema = z.object({
+    content: z.string().min(1, "Strategy content cannot be empty")
+});
+/**
+ * 10. sync_global_doc
+ */
+export const SyncGlobalDocSchema = z.object({
+    docId: z.string(),
+    title: z.string(),
+    content: z.string()
+});
+/**
+ * 13. update_project
+ */
+export const UpdateProjectSchema = z.object({
+    projectId: ProjectIdSchema,
+    patch: z.object({}).passthrough().describe("Fields to update (e.g., description, techStack)")
+});
+/**
+ * 14. rename_project
+ */
+export const RenameProjectSchema = z.object({
+    oldId: ProjectIdSchema,
+    newId: ProjectIdSchema
+});
+/**
+ * 15. moderator_maintenance
+ */
+export const ModeratorMaintenanceSchema = z.object({
+    action: z.enum(["prune", "clear"]),
+    count: z.number().int().min(0)
+});
+/**
+ * 16. moderator_delete_project
+ */
+export const ModeratorDeleteSchema = z.object({
+    projectId: ProjectIdSchema
+});
+/**
+ * 17. start_meeting
+ */
+export const StartMeetingSchema = z.object({
+    topic: z.string().min(1, "Topic is required")
+});
+/**
+ * 18. end_meeting
+ */
+export const EndMeetingSchema = z.object({
+    meetingId: z.string().optional(),
+    summary: z.string().optional()
+});
+/**
+ * 21. archive_meeting
+ */
+export const ArchiveMeetingSchema = z.object({
+    meetingId: z.string()
+});
+/**
+ * 22. reopen_meeting
+ */
+export const ReopenMeetingSchema = z.object({
+    meetingId: z.string()
+});
+// ============ Phase 2: Task Management Schemas ============
+/**
+ * 22. create_task
+ */
+export const CreateTaskSchema = z.object({
+    source_meeting_id: z.string().optional().describe("Link task to a meeting for traceability"),
+    metadata: z.object({}).passthrough().optional().describe("Custom task parameters"),
+    ttl: z.number().int().positive().optional().describe("Time-to-live in milliseconds")
+});
+/**
+ * 23. get_task
+ */
+export const GetTaskSchema = z.object({
+    taskId: z.string()
+});
+/**
+ * 24. list_tasks
+ */
+export const ListTasksSchema = z.object({
+    status: z.enum(["pending", "running", "completed", "failed", "cancelled"]).optional(),
+    limit: z.number().int().positive().optional().default(50)
+});
+/**
+ * 25. update_task
+ */
+export const UpdateTaskSchema = z.object({
+    taskId: z.string(),
+    status: z.enum(["pending", "running", "completed", "failed", "cancelled"]).optional(),
+    progress: z.number().min(0).max(1).optional(),
+    result_uri: z.string().optional(),
+    error_message: z.string().optional()
+});
+/**
+ * 26. cancel_task
+ */
+export const CancelTaskSchema = z.object({
+    taskId: z.string()
+});
+/**
+ * Tool Registry with descriptions and schemas
+ */
+export const TOOL_REGISTRY = {
+    register_session_context: {
+        description: "[IDENTITY] Declare the PROJECT identity. Format: [prefix]_[technical-identifier]. (e.g., 'web_datafrog.io', 'mcp_nexus-core').",
+        schema: RegisterSessionSchema
+    },
+    sync_project_assets: {
+        description: "CRITICAL: [PREREQUISITE: register_session_context] Sync full project state. Both manifest and documentation are MANDATORY.",
+        schema: SyncProjectAssetsSchema
+    },
+    upload_project_asset: {
+        description: "Upload a binary file (images, PDFs, etc.) to the current project's asset folder. Requires active session (call register_session_context first). Returns the relative path of the saved file.",
+        schema: UploadAssetSchema
+    },
+    get_global_topology: {
+        description: "Retrieve complete project relationship graph. Returns { nodes: [{ id, name }], edges: [{ from, to, type }] }. Use this to visualize dependencies.",
+        schema: EmptySchema
+    },
+    send_message: {
+        description: "Post a message to the Nexus collaboration space. If an active meeting exists, the message is automatically routed to that meeting. Otherwise, it goes to the global discussion log. Use this for proposals, decisions, or general coordination.",
+        schema: SendMessageSchema
+    },
+    read_messages: {
+        description: "Read recent messages. Automatically reads from the active meeting if one exists, otherwise reads from global logs.",
+        schema: ReadMessagesSchema
+    },
+    update_global_strategy: {
+        description: "Overwrite master strategy. Content is MANDATORY.",
+        schema: UpdateStrategySchema
+    },
+    sync_global_doc: {
+        description: "Create or update a global document. Returns the document ID.",
+        schema: SyncGlobalDocSchema
+    },
+    update_project: {
+        description: "Partially update a project's manifest. Only provided fields will be updated.",
+        schema: UpdateProjectSchema
+    },
+    rename_project: {
+        description: "[ASYNC] Rename a project ID with automatic cascading updates to all relation references. Returns task ID.",
+        schema: RenameProjectSchema
+    },
+    moderator_maintenance: {
+        description: "[ADMIN ONLY] Manage global discussion logs. 'prune' removes the oldest N entries (keeps newest). 'clear' wipes all logs (use count=0). Returns summary of removed entries. Irreversible.",
+        schema: ModeratorMaintenanceSchema
+    },
+    moderator_delete_project: {
+        description: "[ASYNC][ADMIN ONLY] Completely remove a project, its manifest, and all its assets from Nexus Hub. Returns task ID. Irreversible.",
+        schema: ModeratorDeleteSchema
+    },
+    start_meeting: {
+        description: "Start a new meeting session. Creates a dedicated file for the meeting. Returns the meeting ID and details.",
+        schema: StartMeetingSchema
+    },
+    end_meeting: {
+        description: "End an active meeting. Locks the session for further messages. [RESTRICTED: Only moderator can end].",
+        schema: EndMeetingSchema
+    },
+    archive_meeting: {
+        description: "Archive a closed meeting. Archived meetings are read-only and excluded from active queries. [RESTRICTED: Only moderator can archive].",
+        schema: ArchiveMeetingSchema
+    },
+    reopen_meeting: {
+        description: "Reopen a closed or archived meeting. [Open to all participants].",
+        schema: ReopenMeetingSchema
+    },
+    // --- Phase 2: Task Management ---
+    create_task: {
+        description: "[ASYNC] Create a new background task. Returns task ID for polling. Link to meeting for traceability.",
+        schema: CreateTaskSchema
+    },
+    get_task: {
+        description: "[ASYNC] Get the status and progress of a task by ID.",
+        schema: GetTaskSchema
+    },
+    list_tasks: {
+        description: "[ASYNC] List all tasks with optional status filter.",
+        schema: ListTasksSchema
+    },
+    update_task: {
+        description: "[ASYNC][INTERNAL] Update task status, progress, or result. Intended for background workers only - do not call directly from user-facing tools.",
+        schema: UpdateTaskSchema
+    },
+    cancel_task: {
+        description: "[ASYNC] Cancel a pending or running task.",
+        schema: CancelTaskSchema
+    },
+};

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/build/utils/auth.js

@@ -0,0 +1,11 @@
+import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
+import { CONFIG } from "../config.js";
+/**
+ * Validates moderator permissions for admin tools.
+ * @throws McpError if current session is not in Moderator mode.
+ */
+export function checkModeratorPermission(toolName) {
+    if (!CONFIG.isModerator) {
+        throw new McpError(ErrorCode.InvalidRequest, `Forbidden: ${toolName} requires Moderator rights.`);
+    }
+}

package/build/utils/error.js

@@ -0,0 +1,15 @@
+/**
+ * Error utility functions for path sanitization and reporting.
+ */
+/**
+ * Strips internal file paths from error messages to prevent sensitive path exposure.
+ */
+export function sanitizeErrorMessage(msg) {
+    // Mask Windows paths (e.g. C:\Users\...)
+    let sanitized = msg.replace(/[A-Za-z]:\\[^\s:]+/g, "[internal-path]");
+    // Mask Unix paths (e.g. /home/user/...)
+    sanitized = sanitized.replace(/\/[^\s:]+\/[^\s:]*/g, "[internal-path]");
+    // Mask relative parent paths
+    sanitized = sanitized.replace(/\.\.[\\/][^\s]*/g, "[internal-path]");
+    return sanitized;
+}

package/docs/ASSISTANT_GUIDE.md

@@ -0,0 +1,56 @@
+# Nexus 助手协作指令 (v0.2.0)
+
+你现在是 **n2ns Nexus** 协作网络的一员。该系统集成了实时通信、结构化资产管理以及 **异步任务流 (Task Primitives)**，所有操作均落地在本地文件系统。
+
+## 🚦 核心原则：资源读取，工具写入
+为了优化 Token 消耗，Nexus 将**只读信息**暴露为资源 (Resources)，将**执行操作**保留为工具 (Tools)。
+
+### 1. 状态发现 (Reading via Resources)
+在任何任务开始前，你**必须**了解环境状态。直接读取对应的 URI 即可，无需消耗工具调用额度：
+- **查看身份**：`mcp://nexus/session`（你的 ID 和活跃项目）。
+- **系统状态**：`mcp://nexus/status`（版本、存储模式、活跃会议数）。
+- **项目目录**：`mcp://nexus/hub/registry`（公司目前有哪些其他项目）。
+- **会议目录**：`mcp://nexus/meetings/list`（哪些会议正在进行或已结束）。
+- **任务列表**：`mcp://nexus/tasks/list` (TODO: 资源映射中) 或使用 `list_tasks`。
+- **全局文档列表**：`mcp://nexus/docs/list`（有哪些通用规范）。
+
+### 2. 深度查阅 (Deep Reading)
+- **查阅项目**: `mcp://nexus/projects/{id}/manifest` (API 定义/技术栈) 或 `mcp://nexus/projects/{id}/internal-docs` (详细实现文档)。
+- **查阅文档**: `mcp://nexus/docs/{id}`。
+- **查阅会议**: `mcp://nexus/active-meeting` (当前活跃会议全案) 或 `mcp://nexus/meetings/{id}` (指定会议)。
+- **查阅讨论**: `mcp://nexus/chat/global` (全局实时消息流)。
+
+### 3. 项目管理 (Writing via Tools)
+当你需要**改变**状态时，调用工具：
+- **声明位置**: `register_session_context(projectId)`。解锁项目写权限。
+- **资产同步**: `sync_project_assets`。
+- **项目维护**: `update_project` 或 `rename_project` (自动处理所有依赖引用)。
+- **素材上传**: `upload_project_asset` (架构图转 Base64)。
+
+### 4. 异步任务流 (Tasks - Phase 2)
+对于耗时较长或可能超时的操作（如大规模同步、重构），你**必须**使用任务原语：
+- **创建任务**: `create_task(source_meeting_id?, metadata?)`。返回 `taskId`。
+- **状态轮询**: `get_task(taskId)`。通过 `progress` (0.0-1.0) 了解任务进度。
+- **任务列表**: `list_tasks(status?)`。
+- **取消任务**: `cancel_task(taskId)`。
+
+### 5. 即时沟通 (Collaboration via Tools)
+- **发送消息**: `send_message(message, category?)`。
+- **获取上下文**: `read_messages`。虽然已有资源，但当你需要带参数（如 `count`）获取特定数量的历史记录时，此工具更合适。
+- **更新战略**: `update_global_strategy`（修改全球蓝图）。
+- **文档维护**: `sync_global_doc` (创建/更新通用知识库)。
+
+### 6. 战术会议 (Tactical Meetings)
+1. **发起**: `start_meeting(topic)`。
+2. **参与**: 发送 category 为 `DECISION` 的消息作为共识。
+3. **结束**: `end_meeting(summary?)`。锁定历史。
+4. **归档**: `archive_meeting(meetingId)`。
+
+---
+
+## 🛡️ 角色说明
+- **Regular**: 拥有注册、同步、讨论和维护文档的完整权限。
+- **Moderator**: 额外拥有清理记录（`moderator_maintenance`）及物理删除（`moderator_delete_project`）的权限。
+
+## ❌ 退出机制
+本系统是对本地磁盘的原子写入。请确保同步时提供清晰的 `internalDocs`，以便其他 Assistant 能够无缝接手。

package/docs/CHANGELOG.md

@@ -0,0 +1,170 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [v0.2.0] - 2025-12-31
+
+### 🚀 Task Primitive System (Phase 2 & 3)
+- **Async Deepening**: Critical blocking operations (`rename_project`, `moderator_delete_project`) migrated to the Task primitive with background cascading updates.
+- **Traceability**: All tasks now support `source_meeting_id` to link execution back to meeting decisions.
+- **Progressive UI**: Added `progress` tracking (0.0-1.0) and `result_uri` for structured task output.
+- **Lifecycle Tools**: Added `create_task`, `get_task`, `list_tasks`, `update_task`, and `cancel_task`.
+
+### 🛡️ Type Safety & Security
+- **Defense-in-Depth**: Implemented secondary permission gates inside `handleRemoveProject` and `handleModeratorMaintenance` for maximum project isolation.
+- **Meeting Hardening**: `end_meeting` and `archive_meeting` are now strictly **Moderator-only**.
+- **Zod integration**: All tool definitions migrated to strictly-typed Zod schemas with regex path-traversal protection.
+- **Infrastructure**: Modernized toolchain to **TypeScript 5.9.3**, **Vitest 4.0.16**, and **ESLint 9.39.2**.
+
+### ✂️ Code Diet (Architectural Cleanliness)
+- **The Great Purge**: Removed 6 redundant tools (`list_projects`, `read_project`, `list_global_docs`, `read_global_doc`, `list_meetings`, `read_meeting`) in favor of Resource URIs.
+- **Native Zod 4 Schemas**: Removed `zod-to-json-schema` dependency; now using native Zod 4 `toJSONSchema()` generation.
+
+## [v0.1.9] - 2025-12-30
+
+### 🛡️ Collaboration & Security
+- **Initiator-only Permissions**: Implemented restricted access for `end_meeting` and `archive_meeting`.
+- **Session Presence Awareness**: Automated `[ONLINE/OFFLINE]` status messages in global logs.
+- **Clean Tool Naming**: Finalized transition to `send_message` and `read_messages`.
+
+### 🌐 Resource Namespacing (MCP 2025 Standard)
+- **Unified Authority**: All core resource URIs migrated to `mcp://nexus/`.
+- **New Resources**: Added `mcp://nexus/status` and `mcp://nexus/active-meeting`.
+
+## [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.