@datafrog-io/n2n-nexus 0.1.7 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datafrog-io/n2n-nexus",
-    "version": "0.1.7",
+    "version": "0.2.0",
     "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",
@@ -10,6 +10,8 @@
     "files": [
         "build",
         "README.md",
+        "README_zh.md",
+        "docs",
         "LICENSE"
     ],
     "keywords": [
@@ -43,14 +45,17 @@
         "prepublishOnly": "npm run build"
     },
     "dependencies": {
-        "@modelcontextprotocol/sdk": "1.25.1"
+        "@modelcontextprotocol/sdk": "1.25.1",
+        "better-sqlite3": "^12.5.0",
+        "zod": "^4.3.2"
     },
     "devDependencies": {
-        "@eslint/js": "^9.16.0",
-        "@types/node": "^22.0.0",
-        "eslint": "^9.16.0",
-        "typescript": "^5.7.2",
-        "typescript-eslint": "^8.18.0",
-        "vitest": "^2.1.8"
+        "@eslint/js": "^9.39.2",
+        "@types/better-sqlite3": "^7.6.13",
+        "@types/node": "^25.0.3",
+        "eslint": "^9.39.2",
+        "typescript": "^5.9.3",
+        "typescript-eslint": "^8.51.0",
+        "vitest": "^4.0.16"
     }
-}
+}

package/build/tools/definitions.js

@@ -1,228 +0,0 @@
-/**
- * Tool definitions for MCP ListToolsRequestSchema
- */
-export const TOOL_DEFINITIONS = [
-    {
-        name: "register_session_context",
-        description: "[IDENTITY] Declare the PROJECT identity. Format: [prefix]_[technical-identifier]. (e.g., 'web_datafrog.io', 'mcp_nexus-core').",
-        inputSchema: {
-            type: "object",
-            properties: {
-                projectId: {
-                    type: "string",
-                    description: "Strict flat identifier. MUST start with a type-prefix (web_, api_, chrome_, vscode_, mcp_, android_, ios_, flutter_, desktop_, lib_, bot_, infra_, doc_) followed by an underscore and a technical name (Domain for websites, Repo name/Slug for code). Use kebab-case. No hierarchy dots except in domains."
-                }
-            },
-            required: ["projectId"]
-        }
-    },
-    {
-        name: "sync_project_assets",
-        description: "CRITICAL: [PREREQUISITE: register_session_context] Sync full project state. Both manifest and documentation are MANDATORY.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                manifest: {
-                    type: "object",
-                    description: "Full ProjectManifest metadata.",
-                    properties: {
-                        id: { type: "string", description: "Project ID. MUST follow '[prefix]_[technical-name]' format and match active session." },
-                        name: { type: "string" },
-                        description: { type: "string" },
-                        techStack: { type: "array", items: { type: "string" } },
-                        relations: {
-                            type: "array",
-                            items: {
-                                type: "object",
-                                properties: {
-                                    targetId: { type: "string", description: "ID of the target project (e.g., 'acme.auth-service')." },
-                                    type: { type: "string", enum: ["dependency", "parent", "child", "related"] }
-                                },
-                                required: ["targetId", "type"]
-                            }
-                        },
-                        lastUpdated: { type: "string", description: "ISO timestamp (e.g., 2025-12-29T...)." },
-                        repositoryUrl: { type: "string", description: "GitHub repository URL." },
-                        endpoints: {
-                            type: "array",
-                            items: {
-                                type: "object",
-                                properties: {
-                                    name: { type: "string" },
-                                    url: { type: "string" },
-                                    description: { type: "string" }
-                                },
-                                required: ["name", "url", "description"]
-                            }
-                        },
-                        localPath: { type: "string", description: "Physical disk path of the project." },
-                        apiSpec: {
-                            type: "array",
-                            items: {
-                                type: "object",
-                                properties: {
-                                    method: { type: "string" },
-                                    path: { type: "string" },
-                                    summary: { type: "string" }
-                                },
-                                required: ["method", "path", "summary"]
-                            }
-                        }
-                    },
-                    required: ["id", "name", "description", "techStack", "relations", "lastUpdated", "repositoryUrl", "localPath", "endpoints", "apiSpec"]
-                },
-                internalDocs: { type: "string", description: "Mandatory technical implementation guide (Markdown)." }
-            },
-            required: ["manifest", "internalDocs"]
-        }
-    },
-    {
-        name: "upload_project_asset",
-        description: "Upload a file. Both fileName and base64Content are MANDATORY.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                fileName: { type: "string" },
-                base64Content: { type: "string" }
-            },
-            required: ["fileName", "base64Content"]
-        }
-    },
-    {
-        name: "get_global_topology",
-        description: "Retrieve complete project relationship graph. Use this to understand current IDs and their connections.",
-        inputSchema: { type: "object", properties: {} }
-    },
-    {
-        name: "list_projects",
-        description: "List all existing projects registered in the Nexus Hub. Use this to find correct IDs before performing project-specific operations.",
-        inputSchema: { type: "object", properties: {} }
-    },
-    {
-        name: "read_project",
-        description: "Read project data by ID. Returns specific data slices without exposing internal paths.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                projectId: { type: "string", description: "Project ID (e.g., 'web_datafrog.io', 'mcp_nexus-hub')." },
-                include: {
-                    type: "string",
-                    enum: ["manifest", "docs", "repo", "endpoints", "api", "relations", "summary", "all"],
-                    description: "Data slice: manifest, docs, repo (git URL), endpoints, api (spec), relations, summary (brief), or all."
-                }
-            },
-            required: ["projectId"]
-        }
-    },
-    {
-        name: "post_global_discussion",
-        description: "Join the 'Nexus Meeting Room' to collaborate with other AI agents. Use this for initiating meetings, making cross-project proposals, or announcing key decisions. Every message is shared across all assistants in real-time.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                message: { type: "string", description: "The core content of your speech, proposal, or announcement." },
-                category: {
-                    type: "string",
-                    enum: ["MEETING_START", "PROPOSAL", "DECISION", "UPDATE", "CHAT"],
-                    description: "The nature of this message. Use MEETING_START to call for a synchronous discussion."
-                }
-            },
-            required: ["message"]
-        }
-    },
-    {
-        name: "read_recent_discussion",
-        description: "Quickly 'listen' to the last few messages in the Nexus Room to catch up on the context of the current meeting or collaboration.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                count: { type: "number", description: "Number of recent messages to retrieve (defaults to 10).", default: 10 }
-            }
-        }
-    },
-    {
-        name: "update_global_strategy",
-        description: "Overwrite master strategy. Content is MANDATORY.",
-        inputSchema: { type: "object", properties: { content: { type: "string" } }, required: ["content"] }
-    },
-    {
-        name: "sync_global_doc",
-        description: "Create or update a global document. Returns the document ID.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                docId: { type: "string", description: "Unique document identifier (e.g., 'roadmap-2025', 'coding-standards')" },
-                title: { type: "string", description: "Human-readable document title" },
-                content: { type: "string", description: "Markdown content of the document" }
-            },
-            required: ["docId", "title", "content"]
-        }
-    },
-    {
-        name: "list_global_docs",
-        description: "List all global documents with their metadata (title, lastUpdated, updatedBy).",
-        inputSchema: { type: "object", properties: {} }
-    },
-    {
-        name: "read_global_doc",
-        description: "Read the content of a specific global document.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                docId: { type: "string", description: "Document identifier" }
-            },
-            required: ["docId"]
-        }
-    },
-    {
-        name: "update_project",
-        description: "Partially update a project's manifest. Only provided fields will be updated.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                projectId: { type: "string", description: "Project ID to update (e.g., 'web_datafrog.io')." },
-                patch: {
-                    type: "object",
-                    description: "Fields to update (e.g., description, techStack, endpoints, apiSpec, relations)",
-                    additionalProperties: true
-                }
-            },
-            required: ["projectId", "patch"]
-        }
-    },
-    {
-        name: "rename_project",
-        description: "Rename a project ID with automatic cascading updates to all relation references.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                oldId: { type: "string", description: "Current project ID (e.g., 'web_oldname.com')." },
-                newId: { type: "string", description: "New project ID following the '[prefix]_[name]' standard." }
-            },
-            required: ["oldId", "newId"]
-        }
-    },
-    {
-        name: "moderator_maintenance",
-        description: "[ADMIN ONLY] Prune or clear logs. Both action and count are MANDATORY.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                action: { type: "string", enum: ["prune", "clear"] },
-                count: { type: "number", description: "Number of items (use 0 for 'clear')." }
-            },
-            required: ["action", "count"]
-        }
-    },
-    {
-        name: "delete_project",
-        description: "[ADMIN ONLY] Completely remove a project, its manifest, and all its assets from Nexus.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                projectId: { type: "string", description: "The ID of the project to destroy." }
-            },
-            required: ["projectId"]
-        }
-    }
-];