@datafrog-io/n2n-nexus 0.1.6 → 0.1.7

package/README.md

@@ -7,6 +7,8 @@
 
 **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
+
 ## 🏛️ Architecture
 
 1.  **Nexus Room (Discussion)**: Unified public channel for all IDE assistants to coordinate across projects.
@@ -45,7 +47,7 @@ Nexus_Storage/
 
 **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.
 
-**Concurrency Safety (v0.1.6+)**: All write operations to shared files (`discussion.json`, `registry.json`) are protected by an `AsyncMutex` lock, preventing race conditions when multiple AI agents communicate simultaneously.
+**Concurrency Safety**: All write operations to shared files (`discussion.json`, `registry.json`) are protected by an `AsyncMutex` lock, preventing race conditions when multiple AI agents communicate simultaneously.
 
 ## 🏷️ Project ID Conventions (Naming Standard)
 
@@ -105,8 +107,10 @@ To ensure clarity and prevent collisions in the flat local namespace, all Projec
 ## 🚀 Quick Start
 
 ### MCP Configuration (Recommended)
+
 Add to your MCP config file (e.g., `claude_desktop_config.json` or Cursor MCP settings):
 
+#### Moderator (Admin AI)
 ```json
 {
   "mcpServers": {
@@ -116,7 +120,24 @@ Add to your MCP config file (e.g., `claude_desktop_config.json` or Cursor MCP se
         "-y",
         "@datafrog-io/n2n-nexus",
         "--id", "Master-AI",
-        "--moderator-id", "Master-AI",
+        "--moderator",
+        "--root", "D:/DevSpace/Nexus_Storage"
+      ]
+    }
+  }
+}
+```
+
+#### Regular AI
+```json
+{
+  "mcpServers": {
+    "n2n-nexus": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@datafrog-io/n2n-nexus",
+        "--id", "Assistant-AI",
         "--root", "D:/DevSpace/Nexus_Storage"
       ]
     }
@@ -128,9 +149,11 @@ Add to your MCP config file (e.g., `claude_desktop_config.json` or Cursor MCP se
 | Argument | Description | Default |
 |----------|-------------|---------|
 | `--id` | Instance identifier for this AI agent | `Assistant` |
-| `--moderator-id` | ID of the moderator (has admin rights) | *(none)* |
+| `--moderator` | Grant admin privileges to this instance | `false` |
 | `--root` | Local storage path for all Nexus data | `./storage` |
 
+> **Note:** Only instances with `--moderator` flag can use admin tools (e.g., `moderator_maintenance`).
+
 ### Local Development
 ```bash
 git clone https://github.com/n2ns/n2n-nexus.git
@@ -141,4 +164,24 @@ npm start -- --id Master-AI --root ./my-storage
 ```
 
 ---
-© 2025 Antigravity Dev Team. Built for Local-Only AI Workflows.
+
+## 📋 Real-World Example: Multi-AI Collaboration
+
+The following files demonstrate a real orchestration session where **4 AI agents** (Claude, ChatGPT, Gemini, Augment) collaborated to design and implement an authentication system and Edge-Sync Protocol:
+
+| 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 (JSON)](docs/discussion_2025-12-29_en.json) | Raw meeting room data for programmatic access |
+
+**Highlights from this session**:
+- 🔐 OAuth authentication chain debugging across 4 projects
+- 📜 Edge-Sync Protocol v1.1.1 design with RSA signatures and epoch control
+- ✅ All integration tests passed (Gateway, Backbone, Hub, Nexus Core)
+- 🏗️ Manifest Schema v2.0 with `apiDependencies` tracking
+
+> *This is what AI-native development looks like.*
+
+---
+© 2025 datafrog.io. Built for Local-Only AI Workflows.

package/build/config.js

@@ -6,8 +6,9 @@ const getArg = (k) => {
     const i = args.indexOf(k);
     return i !== -1 && args[i + 1] ? args[i + 1] : "";
 };
+const hasFlag = (k) => args.includes(k);
 export const CONFIG = {
     instanceId: getArg("--id") || "Assistant",
-    moderatorId: getArg("--moderator-id"),
+    isModerator: hasFlag("--moderator"),
     rootStorage: path.resolve(getArg("--root") || path.join(__dirname, "../storage"))
 };

package/build/index.js

@@ -15,14 +15,14 @@ class NexusServer {
     server;
     currentProject = null;
     constructor() {
-        this.server = new Server({ name: "n2n-nexus", version: "0.1.5" }, { capabilities: { resources: {}, tools: {}, prompts: {} } });
+        this.server = new Server({ name: "n2n-nexus", version: "0.1.7" }, { capabilities: { resources: {}, tools: {}, prompts: {} } });
         this.setupHandlers();
     }
     /**
      * Validates moderator permissions for admin tools.
      */
     checkModerator(toolName) {
-        if (CONFIG.moderatorId && CONFIG.instanceId !== CONFIG.moderatorId) {
+        if (!CONFIG.isModerator) {
             throw new McpError(ErrorCode.InvalidRequest, `Forbidden: ${toolName} requires Moderator rights.`);
         }
     }

package/build/resources/index.js

@@ -19,11 +19,10 @@ export async function getResourceContent(uri, currentProject) {
         return { mimeType: "text/markdown", text };
     }
     if (uri === "mcp://nexus/session") {
-        const isModerator = CONFIG.moderatorId ? CONFIG.instanceId === CONFIG.moderatorId : false;
         const info = {
             yourId: CONFIG.instanceId,
-            role: isModerator ? "Moderator" : "Regular",
-            isModerator: isModerator,
+            role: CONFIG.isModerator ? "Moderator" : "Regular",
+            isModerator: CONFIG.isModerator,
             activeProject: currentProject || "None"
         };
         return { mimeType: "application/json", text: JSON.stringify(info, null, 2) };

package/build/tools/handlers.js

@@ -74,7 +74,8 @@ async function handleSyncProjectAssets(args, ctx) {
     const m = args.manifest;
     const requiredFields = ["id", "name", "description", "techStack", "relations", "lastUpdated", "repositoryUrl", "localPath", "endpoints", "apiSpec"];
     for (const field of requiredFields) {
-        if (m[field] === undefined || m[field] === null) {
+        const value = m[field];
+        if (value === undefined || value === null) {
             throw new McpError(ErrorCode.InvalidParams, `Project manifest incomplete. Missing field: ${field}`);
         }
     }
@@ -195,7 +196,7 @@ async function handleReadRecentDiscussion(args) {
     const logs = await StorageManager.getRecentLogs(count);
     return { content: [{ type: "text", text: JSON.stringify(logs, null, 2) }] };
 }
-async function handleUpdateStrategy(args, ctx) {
+async function handleUpdateStrategy(args, _ctx) {
     if (!args?.content)
         throw new McpError(ErrorCode.InvalidParams, "Strategy content cannot be empty.");
     await fs.writeFile(StorageManager.globalBlueprint, args.content);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datafrog-io/n2n-nexus",
-    "version": "0.1.6",
+    "version": "0.1.7",
     "description": "Unified Project Asset & Collaboration Hub (MCP Server) designed for AI agent coordination, featuring structured metadata, real-time messaging, and dependency topology.",
     "main": "build/index.js",
     "type": "module",
@@ -21,7 +21,7 @@
         "local-first",
         "collaboration"
     ],
-    "author": "Antigravity Dev Team",
+    "author": "datafrog.io",
     "license": "Apache-2.0",
     "repository": {
         "type": "git",