@datafrog-io/n2n-memory 1.0.0 → 1.0.3

package/build/index.js

@@ -1,248 +1,40 @@
 #!/usr/bin/env node
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
-import { z } from "zod";
-import { MemoryManager } from "./memory-manager.js";
-import { EntitySchema, RelationSchema } from "./types.js";
-// Input Schemas for validation
-const AddEntitiesSchema = z.object({
-    projectPath: z.string(),
-    entities: z.array(EntitySchema),
-});
-const AddObservationsSchema = z.object({
-    projectPath: z.string(),
-    observations: z.array(z.object({
-        entityName: z.string(),
-        contents: z.array(z.string()),
-    })),
-});
-const CreateRelationsSchema = z.object({
-    projectPath: z.string(),
-    relations: z.array(RelationSchema),
-});
-const ReadGraphSchema = z.object({
-    projectPath: z.string(),
-});
-const SearchSchema = z.object({
-    projectPath: z.string(),
-    query: z.string().describe("Search keywords for entities, types, or observations"),
-});
-export const server = new Server({
+import { createRequire } from "module";
+import { registerAll } from "./handlers/mcp-handlers.js";
+import { checkEnvironment } from "./utils/env.js";
+import { MemoryService } from "./core/memory-service.js";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+/**
+ * N2N Memory MCP Server
+ * Version is automatically read from package.json to ensure consistency.
+ */
+export const server = new McpServer({
     name: "n2n-memory",
-    version: "1.0.0",
-}, {
-    capabilities: {
-        tools: {},
-        resources: {},
-    },
-});
-// --- Handler Logic Extensions (Exported for Testing) ---
-export const Handlers = {
-    async listTools() {
-        return {
-            tools: [
-                {
-                    name: "n2n_add_entities",
-                    description: "Add new entities (concepts, components, nodes) to the project-local knowledge graph. Use this when you discover a new significant part of the project architecture or a core concept.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            projectPath: { type: "string", description: "Absolute path to the project root" },
-                            entities: {
-                                type: "array",
-                                items: {
-                                    type: "object",
-                                    properties: {
-                                        name: { type: "string", description: "Unique name of the entity" },
-                                        entityType: { type: "string", description: "Category of the entity (e.g., CLASS, FUNCTION, MODULE, UI_COMPONENT)" },
-                                        observations: { type: "array", items: { type: "string" }, description: "Initial facts or documentation fragments about this entity" },
-                                    },
-                                    required: ["name", "entityType", "observations"],
-                                },
-                            },
-                        },
-                        required: ["projectPath", "entities"],
-                    },
-                },
-                {
-                    name: "n2n_add_observations",
-                    description: "Append new facts or discovery details to existing entities. Use this as you explore the code and learn more about how specific parts work.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            projectPath: { type: "string", description: "Absolute path to the project root" },
-                            observations: {
-                                type: "array",
-                                items: {
-                                    type: "object",
-                                    properties: {
-                                        entityName: { type: "string", description: "The name of the existing entity to update" },
-                                        contents: { type: "array", items: { type: "string" }, description: "New specific facts or insights to add" },
-                                    },
-                                    required: ["entityName", "contents"],
-                                },
-                            },
-                        },
-                        required: ["projectPath", "observations"],
-                    },
-                },
-                {
-                    name: "n2n_create_relations",
-                    description: "Define relationships between existing entities. Use this to map out dependencies, implementation details, or data flows (e.g., 'AuthService' IMPLEMENTS 'IAuth').",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            projectPath: { type: "string", description: "Absolute path to the project root" },
-                            relations: {
-                                type: "array",
-                                items: {
-                                    type: "object",
-                                    properties: {
-                                        from: { type: "string", description: "Source entity name" },
-                                        to: { type: "string", description: "Target entity name" },
-                                        relationType: { type: "string", description: "The nature of the link (e.g., CALLS, EXTENDS, USES, CONTAINS)" },
-                                    },
-                                    required: ["from", "to", "relationType"],
-                                },
-                            },
-                        },
-                        required: ["projectPath", "relations"],
-                    },
-                },
-                {
-                    name: "n2n_read_graph",
-                    description: "Fetch the entire knowledge graph for the current project. Use this to get an overview of the system architecture and previously stored context.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            projectPath: { type: "string", description: "Absolute path to the project root" },
-                        },
-                        required: ["projectPath"],
-                    },
-                },
-                {
-                    name: "n2n_search",
-                    description: "Search for specific entities, relations, or observations within the project knowledge graph using keywords. Useful for large projects where the full graph is too big to browse.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            projectPath: { type: "string", description: "Absolute path to the project root" },
-                            query: { type: "string", description: "Keywords to search for in names, types, and observations" },
-                        },
-                        required: ["projectPath", "query"],
-                    },
-                },
-            ],
-        };
-    },
-    async callTool(name, args) {
-        try {
-            switch (name) {
-                case "n2n_add_entities": {
-                    const parsed = AddEntitiesSchema.parse(args);
-                    await MemoryManager.addEntities(parsed.projectPath, parsed.entities);
-                    return { content: [{ type: "text", text: `Success: Added ${parsed.entities.length} entities.` }] };
-                }
-                case "n2n_add_observations": {
-                    const parsed = AddObservationsSchema.parse(args);
-                    const addedCount = await MemoryManager.addObservations(parsed.projectPath, parsed.observations);
-                    return { content: [{ type: "text", text: `Success: Added ${addedCount} observation fragments.` }] };
-                }
-                case "n2n_create_relations": {
-                    const parsed = CreateRelationsSchema.parse(args);
-                    await MemoryManager.createRelations(parsed.projectPath, parsed.relations);
-                    return { content: [{ type: "text", text: `Success: Created ${parsed.relations.length} relations.` }] };
-                }
-                case "n2n_read_graph": {
-                    const parsed = ReadGraphSchema.parse(args);
-                    const graph = await MemoryManager.readGraph(parsed.projectPath);
-                    return { content: [{ type: "text", text: JSON.stringify(graph, null, 2) }] };
-                }
-                case "n2n_search": {
-                    const parsed = SearchSchema.parse(args);
-                    const result = await MemoryManager.search(parsed.projectPath, parsed.query);
-                    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-                }
-                default:
-                    throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
-            }
-        }
-        catch (error) {
-            if (error instanceof z.ZodError) {
-                return {
-                    content: [{
-                            type: "text",
-                            text: `Validation Error: ${error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join(', ')}`
-                        }],
-                    isError: true,
-                };
-            }
-            return {
-                content: [{ type: "text", text: `Execution Error: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true,
-            };
-        }
-    },
-    async listResources() {
-        return {
-            resources: [
-                {
-                    uri: "mcp://memory/graph",
-                    name: "Project Knowledge Graph",
-                    description: "The complete knowledge graph stored in .mcp/memory.json",
-                    mimeType: "application/json",
-                }
-            ]
-        };
-    },
-    async readResource(uriString) {
-        const uri = new URL(uriString);
-        if (uri.protocol !== "mcp:" || uri.host !== "memory") {
-            throw new McpError(ErrorCode.InvalidRequest, `Unknown resource URI: ${uriString}`);
-        }
-        const projectPath = uri.searchParams.get("path");
-        if (!projectPath) {
-            throw new McpError(ErrorCode.InvalidParams, "projectPath query parameter 'path' is required");
-        }
-        try {
-            const graph = await MemoryManager.readGraph(projectPath);
-            return {
-                contents: [
-                    {
-                        uri: uriString,
-                        mimeType: "application/json",
-                        text: JSON.stringify(graph, null, 2),
-                    }
-                ]
-            };
-        }
-        catch (error) {
-            throw new McpError(ErrorCode.InternalError, `Failed to read memory: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-};
-// --- Resources ---
-server.setRequestHandler(ListResourcesRequestSchema, async () => {
-    return Handlers.listResources();
-});
-server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-    return Handlers.readResource(request.params.uri);
-});
-// --- Tools ---
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return Handlers.listTools();
-});
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    return Handlers.callTool(request.params.name, request.params.arguments);
+    version: pkg.version,
 });
+// Register all tools and resources defined in handlers
+registerAll(server);
 async function main() {
+    checkEnvironment();
     const transport = new StdioServerTransport();
+    // Graceful shutdown handlers
+    const shutdown = async () => {
+        console.error("\n[System] Shutdown signal received...");
+        await MemoryService.getInstance().shutdown();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    // Use the internal server instance for connection
     await server.connect(transport);
-    console.error("N2N Memory MCP server running on stdio");
+    console.error(`N2N Memory MCP server v${pkg.version} running on stdio`);
 }
-main().catch((error) => {
+main().catch(async (error) => {
     console.error("Fatal Server Error:", error);
+    await MemoryService.getInstance().shutdown();
     process.exit(1);
 });
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAChC,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,GAAG,CAAC,OAAO;CACvB,CAAC,CAAC;AAEH,uDAAuD;AACvD,WAAW,CAAC,MAAM,CAAC,CAAC;AAEpB,KAAK,UAAU,IAAI;IACf,gBAAgB,EAAE,CAAC;IACnB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACxD,MAAM,aAAa,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhC,kDAAkD;IAClD,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,0BAA0B,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAC5E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;IACzB,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,aAAa,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/build/tools/definitions.js

@@ -0,0 +1,67 @@
+/**
+ * Metadata definitions for all MCP tools.
+ * Includes detailed descriptions and [MANDATORY PROTOCOLS].
+ */
+export const TOOL_DEFINITIONS = [
+    {
+        name: "n2n_add_entities",
+        description: "[MANDATORY PROTOCOL] Record new entities. [INIT HANDSHAKE] If this is a new project, you must first call this to get the 'detectedRoot', then call again with 'confirmNewProjectRoot'. [SYNC RULE] Call BEFORE every 'git commit'.",
+        inputSchema: { type: "object" } // Schema is managed via Zod in registerAll
+    },
+    {
+        name: "n2n_add_observations",
+        description: "[MANDATORY PROTOCOL] Append learnings. [INIT HANDSHAKE] Required for new projects. [SYNC RULE] Call BEFORE every 'git commit'.",
+        inputSchema: { type: "object" }
+    },
+    {
+        name: "n2n_create_relations",
+        description: "[RECOMMENDED PROTOCOL] Map connections. [INIT HANDSHAKE] Required for new projects. [SYNC RULE] Call BEFORE every 'git commit'.",
+        inputSchema: { type: "object" }
+    },
+    {
+        name: "n2n_read_graph",
+        description: "[START HERE] Read project memory and active context. [INIT HANDSHAKE] For new projects, provide 'confirmNewProjectRoot' matching the server's detection. [N2N-SYNC] Respect the 'Update before Commit' policy. Set 'summaryMode' to true for a lightweight index.",
+        inputSchema: { type: "object" }
+    },
+    {
+        name: "n2n_get_graph_summary",
+        description: "Quickly fetch a list of all entity names and types plus a count of relations. Use this to get a 'map' of the project without consuming massive tokens.",
+        inputSchema: { type: "object" }
+    },
+    {
+        name: "n2n_update_context",
+        description: "[MANDATORY PROTOCOL] Update task status and next steps. [INIT HANDSHAKE] Required for new projects. [SYNC RULE] MUST call BEFORE every 'git commit'.",
+        inputSchema: { type: "object" }
+    },
+    {
+        name: "n2n_search",
+        description: "Search project memory by keyword. Helpful for locating specific context in large graphs.",
+        inputSchema: { type: "object" }
+    },
+    {
+        name: "n2n_delete_entities",
+        description: "Remove outdated entities and their relations.",
+        inputSchema: { type: "object" }
+    },
+    {
+        name: "n2n_delete_observations",
+        description: "Remove specific outdated observations.",
+        inputSchema: { type: "object" }
+    },
+    {
+        name: "n2n_delete_relations",
+        description: "Remove outdated relations.",
+        inputSchema: { type: "object" }
+    },
+    {
+        name: "n2n_open_nodes",
+        description: "Retrieve specific entities by name. Efficient alternative to full graph read.",
+        inputSchema: { type: "object" }
+    },
+    {
+        name: "n2n_export_markdown",
+        description: "Export knowledge graph to Markdown for documentation or review.",
+        inputSchema: { type: "object" }
+    }
+];
+//# sourceMappingURL=definitions.js.map

package/build/tools/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B;QACI,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,oOAAoO;QACjP,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,2CAA2C;KAC9E;IACD;QACI,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,gIAAgI;QAC7I,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;IACD;QACI,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,iIAAiI;QAC9I,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;IACD;QACI,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,mQAAmQ;QAChR,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;IACD;QACI,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,wJAAwJ;QACrK,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;IACD;QACI,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,sJAAsJ;QACnK,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;IACD;QACI,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,0FAA0F;QACvG,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;IACD;QACI,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,+CAA+C;QAC5D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;IACD;QACI,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,wCAAwC;QACrD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;IACD;QACI,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,4BAA4B;QACzC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;IACD;QACI,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,+EAA+E;QAC5F,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;IACD;QACI,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;CACJ,CAAC"}

package/build/tools/schemas.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+const BaseSchema = {
+    projectPath: z.string().describe("The absolute path to the project or any subdirectory within the project."),
+    confirmNewProjectRoot: z.string().optional().describe("MUST be provided ONLY when initializing a new project. Set this to the 'detectedRoot' path returned by the server's confirmation request."),
+};
+export const EntitySchema = z.object({
+    name: z.string().describe("Unique name of the entity"),
+    entityType: z.string().describe("Category of the entity (e.g., CLASS, FUNCTION, MODULE)"),
+    observations: z.array(z.string()).describe("List of facts or discoveries about this entity"),
+});
+export const RelationSchema = z.object({
+    from: z.string().describe("Source entity name"),
+    to: z.string().describe("Target entity name"),
+    relationType: z.string().describe("Nature of the link (e.g., CALLS, EXTENDS, USES)"),
+});
+export const AddEntitiesSchema = z.object({
+    ...BaseSchema,
+    entities: z.array(EntitySchema),
+});
+export const AddObservationsSchema = z.object({
+    ...BaseSchema,
+    observations: z.array(z.object({
+        entityName: z.string(),
+        contents: z.array(z.string()),
+    })),
+});
+export const CreateRelationsSchema = z.object({
+    ...BaseSchema,
+    relations: z.array(RelationSchema),
+});
+export const ReadGraphSchema = z.object({
+    ...BaseSchema,
+    summaryMode: z.boolean().optional().describe("If true, returns only entity names and types without detailed observations to save tokens."),
+    limit: z.number().int().positive().optional().describe("Maximum number of entities to return."),
+    offset: z.number().int().nonnegative().optional().describe("Number of entities to skip."),
+});
+export const GetGraphSummarySchema = z.object({
+    ...BaseSchema,
+    limit: z.number().int().positive().optional().describe("Maximum number of entities to return."),
+    offset: z.number().int().nonnegative().optional().describe("Number of entities to skip."),
+});
+export const SearchSchema = z.object({
+    ...BaseSchema,
+    query: z.string().describe("Search keywords for entities, types, or observations"),
+    limit: z.number().int().positive().optional().describe("Maximum number of entities to return."),
+    offset: z.number().int().nonnegative().optional().describe("Number of entities to skip."),
+});
+export const DeleteEntitiesSchema = z.object({
+    ...BaseSchema,
+    entityNames: z.array(z.string()).describe("Names of entities to delete"),
+});
+export const DeleteObservationsSchema = z.object({
+    ...BaseSchema,
+    deletions: z.array(z.object({
+        entityName: z.string(),
+        observations: z.array(z.string()),
+    })),
+});
+export const DeleteRelationsSchema = z.object({
+    ...BaseSchema,
+    relations: z.array(RelationSchema),
+});
+export const OpenNodesSchema = z.object({
+    ...BaseSchema,
+    names: z.array(z.string()).describe("Names of entities to retrieve"),
+});
+export const ExportMarkdownSchema = z.object({
+    ...BaseSchema,
+    outputPath: z.string().optional().describe("Output file path relative to project root, defaults to KNOWLEDGE_GRAPH.md"),
+});
+export const UpdateContextSchema = z.object({
+    ...BaseSchema,
+    activeTask: z.string().optional().describe("Current task being performed"),
+    status: z.enum(["IN_PROGRESS", "COMPLETED", "BLOCKED", "PLANNING"]).optional().describe("Current project status"),
+    reason: z.string().optional().describe("Reason for current status (especially if BLOCKED)"),
+    nextSteps: z.array(z.string()).optional().describe("Planned subsequent actions"),
+    lastCommit: z.string().optional().describe("Hash or message of the last relevant git commit"),
+});
+//# sourceMappingURL=schemas.js.map

package/build/tools/schemas.js.map

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

package/build/types.js

@@ -13,4 +13,12 @@ export const KnowledgeGraphSchema = z.object({
     entities: z.array(EntitySchema).default([]),
     relations: z.array(RelationSchema).default([]),
 });
+export const ProjectContextSchema = z.object({
+    activeTask: z.string().optional().describe("Current task being performed"),
+    status: z.enum(["IN_PROGRESS", "COMPLETED", "BLOCKED", "PLANNING"]).default("PLANNING"),
+    reason: z.string().optional().describe("Reason for current status (especially if BLOCKED)"),
+    nextSteps: z.array(z.string()).default([]).describe("Planned subsequent actions"),
+    lastCommit: z.string().optional().describe("Hash or message of the last relevant git commit"),
+    updatedAt: z.string().optional().describe("ISO timestamp of the last context update")
+});
 //# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACtD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAChF,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CACjG,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACtD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACpD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;CAC9F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACjD,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACtD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAChF,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CACjG,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACtD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACpD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;CAC9F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACjD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC1E,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IACvF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IAC3F,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACjF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IAC7F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CACxF,CAAC,CAAC"}

package/build/utils/env.js

@@ -0,0 +1,27 @@
+import { execSync } from "child_process";
+export function checkEnvironment() {
+    const minNodeMajor = 24;
+    const minNpmVersion = "11.5.1";
+    // 1. Check Node.js Version
+    const nodeVersion = process.version;
+    const nodeMajor = parseInt(nodeVersion.slice(1).split('.')[0], 10);
+    if (nodeMajor < minNodeMajor) {
+        console.error(`[Warning] Node.js version ${nodeVersion} detected. Node.js >= v${minNodeMajor}.0.0 is recommended for full feature support (e.g. OIDC publishing).`);
+    }
+    // 2. Check NPM Version (Dev/CI diagnostic)
+    try {
+        const npmVersion = execSync("npm -v", { encoding: "utf-8" }).trim();
+        const [major, minor, patch] = npmVersion.split('.').map(Number);
+        const [targetMajor, targetMinor, targetPatch] = minNpmVersion.split('.').map(Number);
+        const isLower = major < targetMajor ||
+            (major === targetMajor && minor < targetMinor) ||
+            (major === targetMajor && minor === targetMinor && patch < targetPatch);
+        if (isLower) {
+            console.error(`[Warning] npm version ${npmVersion} detected. npm >= ${minNpmVersion} is required for Trusted Publishing (OIDC).`);
+        }
+    }
+    catch (e) {
+        // Silently ignore if npm is not in PATH at runtime
+    }
+}
+//# sourceMappingURL=env.js.map

package/build/utils/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,UAAU,gBAAgB;IAC5B,MAAM,YAAY,GAAG,EAAE,CAAC;IACxB,MAAM,aAAa,GAAG,QAAQ,CAAC;IAE/B,2BAA2B;IAC3B,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IACpC,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnE,IAAI,SAAS,GAAG,YAAY,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,6BAA6B,WAAW,0BAA0B,YAAY,sEAAsE,CAAC,CAAC;IACxK,CAAC;IAED,2CAA2C;IAC3C,IAAI,CAAC;QACD,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAErF,MAAM,OAAO,GAAG,KAAK,GAAG,WAAW;YAC/B,CAAC,KAAK,KAAK,WAAW,IAAI,KAAK,GAAG,WAAW,CAAC;YAC9C,CAAC,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,GAAG,WAAW,CAAC,CAAC;QAE5E,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,yBAAyB,UAAU,qBAAqB,aAAa,6CAA6C,CAAC,CAAC;QACtI,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,mDAAmD;IACvD,CAAC;AACL,CAAC"}

package/build/utils/path-utils.js

@@ -0,0 +1,62 @@
+import path from "path";
+import fs from "fs-extra";
+/**
+ * Common markers that define a project root.
+ */
+const ROOT_MARKERS = [
+    ".git",
+    ".mcp",
+    "package.json",
+    "go.mod",
+    "Cargo.toml",
+    "requirements.txt",
+    "pom.xml",
+    "composer.json",
+    "README.md",
+    ".vscode",
+    "tsconfig.json",
+    ".gitignore"
+];
+// Cache to store resolved roots to avoid redundant I/O (StartPath -> RootPath)
+const rootCache = new Map();
+/**
+ * Recursively finds the project root.
+ * NOTE: For N2N-Memory, we now strictly only check the provided path or its immediate markers
+ * to ensure that memory is only initialized at true project roots (IDE roots).
+ * @param startPath The path to start searching from.
+ */
+export async function findProjectRoot(startPath) {
+    const absoluteStart = path.resolve(startPath);
+    let current = absoluteStart;
+    const foundMarkers = [];
+    let hasMcp = false;
+    // Check current directory for markers
+    for (const marker of ROOT_MARKERS) {
+        const markerPath = path.join(current, marker);
+        if (await fs.pathExists(markerPath)) {
+            foundMarkers.push(marker);
+            if (marker === ".mcp")
+                hasMcp = true;
+        }
+    }
+    if (foundMarkers.length > 0) {
+        return { rootPath: current, hasMcp, markersFound: foundMarkers };
+    }
+    throw new Error(`Directory Not Recognized as a Project Root: No project markers (.git, package.json, README.md, etc.) found in "${absoluteStart}". ` +
+        `N2N-Memory strictly requires you to open the IDE at the project root or use a workspace top-level directory. ` +
+        `Memory initialization is refused for generic or sub-directories to prevent context pollution.`);
+}
+/**
+ * Basic absolute path validation.
+ */
+export function validateAbsolutePath(projectPath) {
+    if (!projectPath)
+        throw new Error("Project path is required.");
+    const resolved = path.resolve(projectPath);
+    if (!path.isAbsolute(resolved))
+        throw new Error(`Path must be absolute: ${projectPath}`);
+    if (resolved.includes('\0'))
+        throw new Error("Invalid path detected.");
+    return resolved;
+}
+//# sourceMappingURL=path-utils.js.map

package/build/utils/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,UAAU,CAAC;AAE1B;;GAEG;AACH,MAAM,YAAY,GAAG;IACjB,MAAM;IACN,MAAM;IACN,cAAc;IACd,QAAQ;IACR,YAAY;IACZ,kBAAkB;IAClB,SAAS;IACT,eAAe;IACf,WAAW;IACX,SAAS;IACT,eAAe;IACf,YAAY;CACf,CAAC;AAEF,+EAA+E;AAC/E,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;AAW5C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB;IACnD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,OAAO,GAAG,aAAa,CAAC;IAE5B,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,sCAAsC;IACtC,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,MAAM,KAAK,MAAM;gBAAE,MAAM,GAAG,IAAI,CAAC;QACzC,CAAC;IACL,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;IACrE,CAAC;IAED,MAAM,IAAI,KAAK,CACX,kHAAkH,aAAa,KAAK;QACpI,+GAA+G;QAC/G,+FAA+F,CAClG,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACpD,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,WAAW,EAAE,CAAC,CAAC;IACzF,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACvE,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "@datafrog-io/n2n-memory",
-  "version": "1.0.0",
-  "description": "",
+  "version": "1.0.3",
+  "description": "Project-local knowledge-graph memory MCP server for AI context isolation.",
   "main": "build/index.js",
   "bin": {
     "n2n-memory": "build/index.js"
   },
+  "repository": "n2ns/n2n-memory",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "type": "module",
   "scripts": {
     "build": "tsc",
@@ -14,12 +19,25 @@
     "test": "mocha --node-option import=tsx src/test/**/*.test.ts",
     "lint": "eslint src/**/*.ts"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
+  "keywords": [
+    "mcp",
+    "memory",
+    "context",
+    "ai",
+    "knowledge-graph"
+  ],
+  "author": "DataFrog IO",
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.0.0",
+    "npm": ">=11.5.1"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.1",
+    "@types/proper-lockfile": "^4.1.4",
+    "async-mutex": "^0.5.0",
     "fs-extra": "^11.3.3",
+    "proper-lockfile": "^4.1.2",
     "zod": "^4.2.1"
   },
   "devDependencies": {
@@ -33,10 +51,10 @@
     "chai": "^6.2.1",
     "eslint": "^9.39.2",
     "mocha": "^11.7.5",
-    "sinon": "^21.0.0",
+    "sinon": "^21.0.1",
     "ts-node": "^10.9.2",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.50.0"
   }
-}
+}