@datafrog-io/n2n-memory 1.0.2 → 1.0.3

package/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+[中文版](./docs/CHANGELOG_zh.md)
+
+---
+
+All notable changes to this project will be documented in this file.
+
+## [1.1.0] - 2024-12-19
+
+### Added
+- Bilingual documentation support: 
+  - Separated `README` into English and Chinese.
+  - All supplemental docs (`API_REFERENCE`, `DESIGN`, `DEVELOPMENT`, `CHANGELOG`) are now bilingual and cross-linked.
+- **Infrastructure Hardening**:
+  - Added `engines` field to `package.json` to enforce Node.js >= 24 and npm >= 11.5.1.
+  - Implemented runtime environment check (Node & npm) during MCP server startup to prevent deployment issues.
+- **Dependency Maintenance**:
+  - Upgraded all dependencies to their latest stable versions (including `sinon`, `typescript`, `eslint`, etc.).
+  - Verified zero vulnerabilities and zero outdated packages.
+- **High-Reliability Architecture**:
+  - Implemented **Dual-Buffer Service**:
+    - **Snapshot Buffer**: In-memory cache for ultra-fast reads.
+    - **Write Queue**: Sequentialized background writes to prevent data corruption.
+  - **Atomic Persistence**: Uses temporary file swaps to ensure JSON integrity during crashes.
+  - **Cross-Process Locking**: Integrated `proper-lockfile` to handle multiple IDE windows accessing the same project.
+  - **AI-Driven Path Pinning**: Updated tool descriptions to guide AI assistants to report project paths at session start.
+  - **Clean Architecture & SDK Modernization**:
+    - Migrated to the latest `@modelcontextprotocol/sdk` high-level `McpServer` API.
+    - Resolved `Server` class deprecation warnings (TS6385).
+    - Decentralized `index.ts` into a maintainable directory structure:
+      - `/core`: Domain logic (MemoryService, MemoryManager).
+      - `/tools`: Tool definitions and Zod schemas.
+      - `/handlers`: Pure request dispatching logic via `registerAll`.
+      - `/utils`: Environment and system utilities.
+    - **Hot/Cold Data Separation (Project Context)**:
+      - Introduced `context.json` to store high-frequency "Hot State" (active tasks, status, next steps).
+      - Isolated memory graph in `memory.json` to preserve architectural "Cold Knowledge".
+      - Implemented independent physical locking (`proper-lockfile`) and memory mutexes for `context.json`.
+      - New tool `n2n_update_context` with mandatory Git-Sync protocol enforcement.
+      - `n2n_read_graph` now performs a "Unified Read" returning both Knowledge Graph and Active Context.
+    - **N2N-SYNC Protocol Enforcement**:
+      - Hardcoded mandatory synchronization constraints into MCP tool metadata.
+      - Every session start (`n2n_read_graph`) now binds the AI to a "Memory Update before Git Commit" policy.
+      - Added `[MANDATORY PROTOCOL]` and `[HARD CONSTRAINT]` tags to write tools to prevent context drift during refactoring.
+    - Improved test coverage and fixed cross-module import paths.
+- Initial `CHANGELOG.md` to track project evolution and technical discoveries.
+
+### Fixed
+- **NPM Publishing Compatibility**: Identified and documented a critical requirement for Trusted Publishing (OIDC).
+  - **Discovery**: NPM CLI version 10.x (shipped with Node.js 22) fails with `404 Not Found` when attempting OIDC-based publishing, even if the configuration is correct.
+  - **Requirement**: Must use **NPM CLI 11.5.1+** or Node.js 24.
+  - **Mitigation**: Added `npm install -g npm@latest` recommendation to CI/CD workflows.
+
+## [1.0.0] - Prior to 2024-12-19
+
+### Added
+- Core MCP functionality for project-local memory isolation.
+- Cognitive persistence at `[Project Root]/.mcp/memory.json`.
+- Tools: `n2n_add_entities`, `n2n_add_observations`, `n2n_create_relations`, `n2n_read_graph`, `n2n_search`.

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 DataFrog IO
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2024 DataFrog IO
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,125 +1,89 @@
-# n2n-memory
-
-[English](#english) | [中文](#中文)
-
----
-
-<a name="english"></a>
-## English
-
-A specialized MCP server designed to solve "memory pollution" during AI-assisted cross-project development. It persists AI's cognitive fragments directly within each project's own directory.
-
-### 🌟 Key Highlights
-- **Project-Level Physical Isolation**: Memory files are stored at `[Project Root]/.mcp/memory.json`.
-- **Git-Friendly**: JSON data is automatically sorted by key to generate clean and readable `git diff`.
-- **Tool Agnostic**: Uses the `.mcp` naming convention, not tied to any specific AI brand or IDE plugin.
-- **Assets for Your Code**: Memory stays with your code; team members can share AI's understanding of the architecture by simply pulling the repository.
-
-### 🚀 Quick Start
-
-#### 1. Installation & Config (IDE / Claude Desktop)
-
-The easiest way to use this is via `npx`:
-
-##### Claude Desktop
-File Path: `%APPDATA%\Claude\claude_desktop_config.json`
-
-```json
-{
-  "mcpServers": {
-    "n2n-memory": {
-      "command": "npx",
-      "args": ["-y", "@datafrog-io/n2n-memory"]
-    }
-  }
-}
-```
-
-##### Cursor / VSCode (MCP Plugin)
-Add in the MCP settings panel:
-- **Name**: `n2n-memory`
-- **Type**: `command`
-- **Command**: `npx -y @datafrog-io/n2n-memory`
-
-#### 2. Usage Guide
-
-This service is path-driven. AI assistants should pay attention to:
-
-1. **Absolute Paths**: When calling any `n2n_*` tool, the absolute path of the current project root (`projectPath`) must be provided.
-2. **Auto Storage**: Memory is automatically saved to `[ProjectPath]/.mcp/memory.json`.
-3. **Collaboration**: It is recommended to commit `.mcp/memory.json` to your Git repository to share the knowledge graph with your team.
-
-##### Available Tools:
-- `n2n_add_entities`: Create new entities.
-- `n2n_add_observations`: Append observations or facts.
-- `n2n_create_relations`: Establish connections between entities.
-- `n2n_read_graph`: Read the entire knowledge graph.
-- `n2n_search`: Search the graph via keywords (names, types, observations).
-
----
-
-<a name="中文"></a>
-## 中文
-
-这是一个专为解决 AI 跨项目开发时“记忆污染”而设计的 MCP 服务。它将 AI 的认知碎片持久化在每个项目自己的目录下。
-
-### 🌟 核心亮点
-- **项目级物理隔离**: 记忆文件存储在 `[项目根目录]/.mcp/memory.json`。
-- **Git 版本可控**: 自动对 JSON 数据进行字典序排序，生成清晰的 `git diff`。
-- **工具中立**: 使用 `.mcp` 命名，不绑定任何特定 AI 品牌或 IDE 插件。
-- **知识资产化**: 记忆随代码走，团队成员拉取仓库即可共享 AI 对架构的理解。
-
-### 🚀 快速配置
-
-#### 1. JSON 配置 (IDE / Claude Desktop)
-
-推荐使用 `npx` 模式直接运行：
-
-##### Claude Desktop
-配置文件路径: `%APPDATA%\Claude\claude_desktop_config.json`
-
-```json
-{
-  "mcpServers": {
-    "n2n-memory": {
-      "command": "npx",
-      "args": ["-y", "@datafrog-io/n2n-memory"]
-    }
-  }
-}
-```
-
-##### Cursor / VSCode (MCP 插件)
-在 MCP 设置面板中添加：
-- **Name**: `n2n-memory`
-- **Type**: `command`
-- **Command**: `npx -y @datafrog-io/n2n-memory`
-
-#### 2. 使用指南 (Usage Guide)
-
-本服务完全由路径驱动，AI 助手在调用工具时需要关注以下几点：
-
-1. **绝对路径**: 调用任何 `n2n_*` 工具时，必须传入当前项目根目录的**绝对路径**（`projectPath`）。
-2. **自动存储**: 记忆将自动保存在 `[项目路径]/.mcp/memory.json`。
-3. **协作共享**: 建议将 `.mcp/memory.json` 提交至 Git 仓库，以便团队成员共享知识图谱。
-
-##### 常用工具示例：
-- `n2n_add_entities`: 创建新实体。
-- `n2n_add_observations`: 追加观测事实。
-- `n2n_create_relations`: 建立实体间联系。
-- `n2n_read_graph`: 读取完整图谱。
-- `n2n_search`: 关键词搜索图谱（支持实体名、类型、观测事实）。
-
----
-
-## 📖 Related Docs | 文档指引
-
-- **[Design Solution | 设计方案](./docs/DESIGN.md)**: Why project-level isolation?
-- **[API Reference | API 参考手册](./docs/API_REFERENCE.md)**: Tool descriptions and schema.
-- **[Development | 开发指南](./docs/DEVELOPMENT.md)**: How to build, test and extend.
-
-## 📄 License | 许可证
-This project is licensed under the [MIT License](./LICENSE). | 本项目采用 [MIT 许可证](./LICENSE)。
-
----
-**N2N Studio [@n2ns](https://github.com/n2ns)**
+# n2n-memory
+
+[![npm version](https://img.shields.io/npm/v/@datafrog-io/n2n-memory)](https://www.npmjs.com/package/@datafrog-io/n2n-memory)
+[![license](https://img.shields.io/github/license/n2ns/n2n-memory)](https://github.com/n2ns/n2n-memory/blob/main/LICENSE)
+[![MCP Protocol](https://img.shields.io/badge/MCP-Protocol-blue)](https://modelcontextprotocol.io)
+[![node version](https://img.shields.io/node/v/@datafrog-io/n2n-memory)](https://nodejs.org)
+[![N2N Studio](https://datafrog.io/badges/n2n-studio.svg)](https://github.com/n2ns)
+[![DataFrog.io](https://datafrog.io/badges/datafrog.svg)](https://datafrog.io)
+
+[中文版](./docs/README_zh.md)
+
+---
+
+> **Context as code. Memory as asset.**
+
+A specialized MCP server designed to solve "memory pollution" during AI-assisted cross-project development. It persists AI's cognitive fragments directly within each project's own directory.
+
+### 🌟 Key Highlights
+- **Project-Level Physical Isolation**: Memory files are stored at `[Project Root]/.mcp/memory.json`.
+- **Git-Friendly**: JSON data is automatically sorted by key to generate clean and readable `git diff`.
+- **Tool Agnostic**: Uses the `.mcp` naming convention, not tied to any specific AI brand or IDE plugin.
+- **Assets for Your Code**: Memory stays with your code; team members can share AI's understanding of the architecture by simply pulling the repository.
+- **Universal Compatibility**: Works with all MCP-enabled models including **Claude 4.5**, **Gemini 3 Pro/Flash**, **GPT-5/5.2**, and **DeepSeek V3.2**.
+- **Privacy-First**: Built with security by design, keeping your data local and isolated.
+
+### 🚀 Quick Start
+
+#### 1. Installation & Config (IDE / Claude Desktop)
+
+The easiest way to use this is via `npx`:
+
+##### Claude Desktop
+File Path: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "n2n-memory": {
+      "command": "npx",
+      "args": ["-y", "@datafrog-io/n2n-memory"]
+    }
+  }
+}
+```
+
+##### Cursor / VSCode (MCP Plugin)
+Add in the MCP settings panel:
+- **Name**: `n2n-memory`
+- **Type**: `command`
+- **Command**: `npx -y @datafrog-io/n2n-memory`
+
+#### 2. Usage Guide
+
+This service is path-driven. AI assistants should pay attention to:
+
+1. **Absolute Paths**: When calling any `n2n_*` tool, the absolute path of the current project root (`projectPath`) must be provided.
+2. **Auto Storage**: Memory is automatically saved to `[ProjectPath]/.mcp/memory.json`.
+3. **Collaboration**: It is recommended to commit `.mcp/memory.json` to your Git repository to share the knowledge graph with your team.
+
+##### Available Tools:
+- `n2n_add_entities`: Create new entities.
+- `n2n_add_observations`: Append observations or facts.
+- `n2n_create_relations`: Establish connections between entities.
+- `n2n_read_graph`: Read project memory and active context (Supports `summaryMode` and `pagination`).
+- `n2n_get_graph_summary`: Quickly fetch a lightweight index of all entities (Supports `pagination`).
+- `n2n_update_context`: Update current task status and next steps.
+- `n2n_search`: Search the graph via keywords (Supports `pagination`).
+- `n2n_open_nodes`: Retrieve specific entities by name.
+
+### 🗺️ Future Roadmap
+- **Semantic Search**: Integration of minimalist Vector Embeddings for fuzzy memory retrieval.
+- **Ontology Enforcement**: Optional schema for relation type consistency.
+- **Time Travel**: Versioned snapshots for memory rollback.
+
+---
+
+## 📖 Related Docs
+
+- **[Design Solution](./docs/DESIGN.md)**: Why project-level isolation?
+- **[API Reference](./docs/API_REFERENCE.md)**: Tool descriptions and schema.
+- **[Development](./docs/DEVELOPMENT.md)**: How to build, test and extend.
+- **[Changelog](./CHANGELOG.md)**: Version history and incident recovery.
+
+## 📄 License
+This project is licensed under the [MIT License](./LICENSE).
+
+---
+
+**N2N Studio** — The AI Innovation Lab of [DataFrog.io](https://datafrog.io).

package/build/core/memory-manager.js

@@ -0,0 +1,141 @@
+import fs from "fs-extra";
+import path from "path";
+import { KnowledgeGraphSchema, ProjectContextSchema } from "../types.js";
+export const MEMORY_FILE_PATH = ".mcp/memory.json";
+export const CONTEXT_FILE_PATH = ".mcp/context.json";
+export class MemoryManager {
+    static async readGraph(projectPath) {
+        const filePath = path.resolve(projectPath, MEMORY_FILE_PATH);
+        try {
+            if (await fs.pathExists(filePath)) {
+                const data = await fs.readJson(filePath);
+                return KnowledgeGraphSchema.parse(data);
+            }
+        }
+        catch (error) {
+            console.error(`[MemoryManager] Read error at ${filePath}:`, error);
+        }
+        return { entities: [], relations: [] };
+    }
+    /**
+     * Writes the graph to disk atomically using a temporary file.
+     * Ensures git-friendly sorting before write.
+     */
+    static async writeGraph(projectPath, graph) {
+        const filePath = path.resolve(projectPath, MEMORY_FILE_PATH);
+        const tempPath = `${filePath}.${Date.now()}.tmp`;
+        const dirPath = path.dirname(filePath);
+        try {
+            // Git-friendly sorting
+            graph.entities.sort((a, b) => a.name.localeCompare(b.name));
+            graph.entities.forEach(entity => {
+                if (entity.observations) {
+                    entity.observations.sort();
+                }
+                else {
+                    entity.observations = [];
+                }
+            });
+            graph.relations.sort((a, b) => {
+                const fromComp = a.from.localeCompare(b.from);
+                if (fromComp !== 0)
+                    return fromComp;
+                const toComp = a.to.localeCompare(b.to);
+                if (toComp !== 0)
+                    return toComp;
+                return a.relationType.localeCompare(b.relationType);
+            });
+            await fs.ensureDir(dirPath);
+            // 1. Write to temporary file
+            await fs.writeJson(tempPath, graph, { spaces: 2 });
+            // 2. Atomic rename
+            await fs.move(tempPath, filePath, { overwrite: true });
+        }
+        catch (error) {
+            // Cleanup temp file if it exists and write failed
+            if (await fs.pathExists(tempPath)) {
+                await fs.remove(tempPath);
+            }
+            throw new Error(`Failed to write memory file at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    static async readContext(projectPath) {
+        const filePath = path.resolve(projectPath, CONTEXT_FILE_PATH);
+        try {
+            if (await fs.pathExists(filePath)) {
+                const data = await fs.readJson(filePath);
+                return ProjectContextSchema.parse(data);
+            }
+        }
+        catch (error) {
+            console.error(`[MemoryManager] Context read error at ${filePath}:`, error);
+        }
+        return { status: "PLANNING", nextSteps: [] };
+    }
+    static async writeContext(projectPath, context) {
+        const filePath = path.resolve(projectPath, CONTEXT_FILE_PATH);
+        const tempPath = `${filePath}.${Date.now()}.tmp`;
+        const dirPath = path.dirname(filePath);
+        try {
+            context.updatedAt = new Date().toISOString();
+            await fs.ensureDir(dirPath);
+            await fs.writeJson(tempPath, context, { spaces: 2 });
+            await fs.move(tempPath, filePath, { overwrite: true });
+        }
+        catch (error) {
+            if (await fs.pathExists(tempPath)) {
+                await fs.remove(tempPath);
+            }
+            throw new Error(`Failed to write context file at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    static async openNodes(projectPath, names) {
+        const graph = await this.readGraph(projectPath);
+        const nameSet = new Set(names);
+        const filteredEntities = graph.entities.filter(e => nameSet.has(e.name));
+        const entityNames = new Set(filteredEntities.map(e => e.name));
+        const filteredRelations = graph.relations.filter(r => entityNames.has(r.from) && entityNames.has(r.to));
+        return {
+            entities: filteredEntities,
+            relations: filteredRelations
+        };
+    }
+    static async exportToMarkdown(projectPath, outputPath) {
+        const graph = await this.readGraph(projectPath);
+        const filePath = path.resolve(projectPath, outputPath || "KNOWLEDGE_GRAPH.md");
+        let md = "# Knowledge Graph\n\n";
+        md += `> Generated from \`${MEMORY_FILE_PATH}\`\n\n`;
+        md += "## Entities\n\n";
+        if (graph.entities.length === 0) {
+            md += "_No entities found._\n\n";
+        }
+        else {
+            for (const entity of graph.entities) {
+                md += `### ${entity.name}\n\n`;
+                md += `- **Type**: \`${entity.entityType}\`\n`;
+                if (entity.observations.length > 0) {
+                    md += `- **Observations**:\n`;
+                    for (const obs of entity.observations) {
+                        md += `  - ${obs}\n`;
+                    }
+                }
+                md += "\n";
+            }
+        }
+        md += "## Relations\n\n";
+        if (graph.relations.length === 0) {
+            md += "_No relations found._\n\n";
+        }
+        else {
+            md += "| From | Relation | To |\n";
+            md += "|------|----------|----|\n";
+            for (const rel of graph.relations) {
+                md += `| ${rel.from} | ${rel.relationType} | ${rel.to} |\n`;
+            }
+            md += "\n";
+        }
+        await fs.writeFile(filePath, md, "utf-8");
+        return filePath;
+    }
+}
+//# sourceMappingURL=memory-manager.js.map

package/build/core/memory-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.js","sourceRoot":"","sources":["../../src/core/memory-manager.ts"],"names":[],"mappings":"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"}