@pcircle/memesh 2.10.1 → 3.0.0

package/dist/transports/mcp/handlers.js

@@ -0,0 +1,271 @@
+import { z } from 'zod';
+import { remember, recallEnhanced, forget, consolidate, exportMemories, importMemories } from '../../core/operations.js';
+import { KnowledgeGraph } from '../../knowledge-graph.js';
+import { getDatabase } from '../../db.js';
+const RememberSchema = z.object({
+    name: z.string().min(1),
+    type: z.string().min(1),
+    observations: z.array(z.string()).optional(),
+    tags: z.array(z.string()).optional(),
+    relations: z
+        .array(z.object({ to: z.string().min(1), type: z.string().min(1) }))
+        .optional(),
+    namespace: z.enum(['personal', 'team', 'global']).optional(),
+});
+const RecallSchema = z.object({
+    query: z.string().optional(),
+    tag: z.string().optional(),
+    limit: z.number().int().min(1).max(100).optional(),
+    include_archived: z.boolean().optional(),
+    namespace: z.enum(['personal', 'team', 'global']).optional(),
+    cross_project: z.boolean().optional(),
+});
+const ForgetSchema = z.object({
+    name: z.string().min(1),
+    observation: z.string().optional(),
+});
+const ConsolidateSchema = z.object({
+    name: z.string().optional(),
+    tag: z.string().optional(),
+    min_observations: z.number().int().min(1).optional(),
+});
+const ExportSchema = z.object({
+    tag: z.string().optional(),
+    namespace: z.string().optional(),
+    limit: z.number().int().min(1).max(10000).optional(),
+});
+const ExportResultSchema = z.object({
+    version: z.string(),
+    exported_at: z.string(),
+    entity_count: z.number(),
+    entities: z.array(z.object({
+        name: z.string().min(1).max(255),
+        type: z.string().min(1).max(100),
+        namespace: z.string(),
+        observations: z.array(z.string().max(10000)),
+        tags: z.array(z.string().max(255)),
+        relations: z.array(z.object({ to: z.string().min(1).max(255), type: z.string().min(1).max(100) })),
+    })),
+});
+const ImportSchema = z.object({
+    data: ExportResultSchema,
+    namespace: z.string().optional(),
+    merge_strategy: z.enum(['skip', 'overwrite', 'append']),
+});
+export const TOOL_DEFINITIONS = [
+    {
+        name: 'remember',
+        description: 'Store knowledge as an entity with observations, tags, and relations. Use this to remember decisions, patterns, lessons learned, and important context.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    description: 'Unique entity name (e.g., "auth-decision", "jwt-pattern"). Reusing a name appends observations and dedupes tags instead of replacing the entity.',
+                },
+                type: {
+                    type: 'string',
+                    description: 'Entity type (e.g., "decision", "pattern", "lesson", "commit")',
+                },
+                observations: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Key facts or observations about this entity',
+                },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Tags for filtering (e.g., "project:myapp", "type:decision")',
+                },
+                relations: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            to: { type: 'string', description: 'Target entity name' },
+                            type: {
+                                type: 'string',
+                                description: 'Relation type (e.g., "implements", "related-to")',
+                            },
+                        },
+                        required: ['to', 'type'],
+                        additionalProperties: false,
+                    },
+                    description: 'Relations to other entities',
+                },
+                namespace: {
+                    type: 'string',
+                    enum: ['personal', 'team', 'global'],
+                    description: 'Namespace for organizing the entity (default: "personal")',
+                },
+            },
+            required: ['name', 'type'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'recall',
+        description: 'Search and retrieve stored knowledge. Uses full-text search with optional project tag filtering. Call with no query to list recent memories.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query (uses FTS5 full-text search). Leave empty to list recent.',
+                },
+                tag: {
+                    type: 'string',
+                    description: 'Filter by tag (e.g., "project:myapp")',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max results (default: 20, max: 100)',
+                },
+                include_archived: {
+                    type: 'boolean',
+                    description: 'Include archived (forgotten) entities in results. Default: false.',
+                },
+                namespace: {
+                    type: 'string',
+                    enum: ['personal', 'team', 'global'],
+                    description: 'Filter results by namespace. Omit to search all namespaces.',
+                },
+                cross_project: {
+                    type: 'boolean',
+                    description: 'Search across all project tags (ignores tag filter). Default: false.',
+                },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'forget',
+        description: 'Archive an entity (soft-delete) or remove a specific observation. Archived entities are hidden from recall but preserved in the database. To remove just one observation, pass the observation parameter.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Entity name to archive or modify' },
+                observation: {
+                    type: 'string',
+                    description: 'If provided, only this specific observation is removed (entity stays active). If omitted, the entire entity is archived.',
+                },
+            },
+            required: ['name'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'consolidate',
+        description: 'Compress verbose entity observations using an LLM into 2–3 dense sentences that preserve all key facts. Requires Smart Mode (run: memesh setup). Original observations are replaced by the LLM summary.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Specific entity name to consolidate' },
+                tag: { type: 'string', description: 'Consolidate all entities with this tag' },
+                min_observations: {
+                    type: 'number',
+                    description: 'Minimum observations required to trigger consolidation (default: 5)',
+                },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'export',
+        description: 'Export memories as JSON for sharing or backup. Returns a portable snapshot of entities and their observations, tags, and relations.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                tag: { type: 'string', description: 'Export only entities with this tag' },
+                namespace: { type: 'string', description: 'Export only from this namespace (personal, team, global)' },
+                limit: { type: 'number', description: 'Max entities to export (default: 1000)' },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'import',
+        description: 'Import memories from a JSON export snapshot. Supports skip, append, or overwrite strategies for handling existing entities.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                data: { type: 'object', description: 'Export JSON data (from the export tool)' },
+                namespace: { type: 'string', description: 'Override namespace for all imported entities' },
+                merge_strategy: {
+                    type: 'string',
+                    enum: ['skip', 'overwrite', 'append'],
+                    description: 'How to handle existing entities: skip (default) = leave untouched, append = add observations, overwrite = archive existing and recreate',
+                },
+            },
+            required: ['data', 'merge_strategy'],
+            additionalProperties: false,
+        },
+    },
+];
+function ok(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data) }] };
+}
+function fail(message) {
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
+function parseOrFail(schema, args) {
+    const parsed = schema.safeParse(args ?? {});
+    if (!parsed.success) {
+        const message = parsed.error instanceof z.ZodError
+            ? parsed.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ')
+            : String(parsed.error);
+        return { ok: false, result: fail(message) };
+    }
+    return { ok: true, data: parsed.data };
+}
+export async function handleTool(name, args) {
+    try {
+        if (name === 'remember') {
+            const r = parseOrFail(RememberSchema, args);
+            if (!r.ok)
+                return r.result;
+            return ok(remember(r.data));
+        }
+        if (name === 'recall') {
+            const r = parseOrFail(RecallSchema, args);
+            if (!r.ok)
+                return r.result;
+            const entities = await recallEnhanced(r.data);
+            const kg = new KnowledgeGraph(getDatabase());
+            const conflicts = kg.findConflicts(entities.map(e => e.name));
+            if (conflicts.length > 0) {
+                return ok({ entities, conflicts });
+            }
+            return ok(entities);
+        }
+        if (name === 'forget') {
+            const r = parseOrFail(ForgetSchema, args);
+            if (!r.ok)
+                return r.result;
+            return ok(forget(r.data));
+        }
+        if (name === 'consolidate') {
+            const r = parseOrFail(ConsolidateSchema, args);
+            if (!r.ok)
+                return r.result;
+            return ok(await consolidate(r.data));
+        }
+        if (name === 'export') {
+            const r = parseOrFail(ExportSchema, args);
+            if (!r.ok)
+                return r.result;
+            return ok(exportMemories(r.data));
+        }
+        if (name === 'import') {
+            const r = parseOrFail(ImportSchema, args);
+            if (!r.ok)
+                return r.result;
+            return ok(importMemories(r.data));
+        }
+        return fail(`Unknown tool: ${name}`);
+    }
+    catch (err) {
+        return fail(`Tool "${name}" failed: ${err.message}`);
+    }
+}
+//# sourceMappingURL=handlers.js.map

package/dist/transports/mcp/handlers.js.map

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

package/hooks/hooks.json

@@ -11,29 +11,9 @@
         ]
       }
     ],
-    "PreToolUse": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/hooks/pre-tool-use.js"
-          }
-        ]
-      }
-    ],
     "PostToolUse": [
       {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/hooks/post-tool-use.js"
-          }
-        ]
-      },
-      {
-        "matcher": "*",
+        "matcher": "Bash",
         "hooks": [
           {
             "type": "command",
@@ -48,16 +28,20 @@
         "hooks": [
           {
             "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/hooks/stop.js"
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/hooks/session-summary.js",
+            "timeout": 10
           }
         ]
-      },
+      }
+    ],
+    "PreCompact": [
       {
         "matcher": "*",
         "hooks": [
           {
             "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/hooks/subagent-stop.js"
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/hooks/pre-compact.js",
+            "timeout": 10
           }
         ]
       }

package/package.json

@@ -1,129 +1,65 @@
 {
   "name": "@pcircle/memesh",
-  "version": "2.10.1",
-  "description": "MeMesh — Persistent memory plugin for Claude Code. Remembers architecture decisions, coding patterns, and project context across sessions.",
+  "version": "3.0.0",
+  "description": "MeMesh — The lightest universal AI memory layer. One SQLite file, any LLM, zero cloud.",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
-    "memesh": "dist/mcp/server-bootstrap.js"
+    "memesh": "dist/transports/cli/cli.js",
+    "memesh-mcp": "dist/mcp/server.js",
+    "memesh-http": "dist/transports/http/server.js",
+    "memesh-view": "dist/cli/view.js"
   },
   "files": [
     "dist/",
     ".mcp.json",
     "hooks/hooks.json",
-    "scripts/postinstall-new.js",
-    "scripts/postinstall-lib.js",
-    "scripts/health-check.js",
     "scripts/hooks/",
-    "scripts/skills/",
     "plugin.json",
     "README.md",
-    "README.zh-TW.md",
     "LICENSE"
   ],
   "scripts": {
-    "postinstall": "node scripts/postinstall-new.js",
-    "dev": "tsx watch src/index.ts",
-    "build": "tsc && npm run copy:resources && chmod +x dist/mcp/server-bootstrap.js && npm run prepare:plugin",
-    "copy:resources": "mkdir -p dist/mcp/resources && cp -r src/mcp/resources/*.md dist/mcp/resources/",
-    "build:plugin": "npm run build",
-    "prepare:plugin": "node scripts/prepare-plugin.js",
-    "start": "node dist/index.js",
+    "build": "tsc && node scripts/copy-cli-assets.mjs && node scripts/set-executable-bits.mjs",
     "test": "vitest",
-    "test:coverage": "vitest --coverage",
-    "test:e2e": "echo '⚠️  WARNING: Use test:e2e:safe instead to prevent system freeze!' && exit 1",
-    "test:e2e:safe": "./scripts/e2e-resource-monitor.sh vitest run --config vitest.e2e.config.ts",
-    "test:integration": "./scripts/e2e-resource-monitor.sh vitest run --config vitest.config.ts tests/**/*.test.ts",
-    "lint": "eslint src --ext .ts",
-    "format": "prettier --write 'src/**/*.ts'",
+    "test:packaged": "node scripts/smoke-packed-artifact.mjs",
     "typecheck": "tsc --noEmit",
-    "cred": "tsx src/cli/index.ts cred",
-    "mcp": "node dist/mcp/server-bootstrap.js",
-    "docs": "typedoc",
-    "docs:watch": "typedoc --watch",
-    "verify:mcp": "./scripts/verify-mcp-stdio.sh",
-    "test:install": "./scripts/test-installation.sh",
-    "prepublishOnly": "npm run test:install",
-    "processes:list": "./scripts/manage-mcp-processes.sh list",
-    "processes:kill": "./scripts/manage-mcp-processes.sh kill",
-    "processes:restart": "./scripts/manage-mcp-processes.sh restart",
-    "processes:orphaned": "./scripts/manage-mcp-processes.sh orphaned",
-    "processes:config": "./scripts/manage-mcp-processes.sh config",
-    "verify:migration": "tsx scripts/verify-migration.ts",
-    "backfill-embeddings": "tsx scripts/backfill-embeddings.ts"
+    "start": "node dist/mcp/server.js"
+  },
+  "author": "PCIRCLE-AI",
+  "license": "MIT",
+  "homepage": "https://github.com/PCIRCLE-AI/memesh-llm-memory",
+  "bugs": {
+    "url": "https://github.com/PCIRCLE-AI/memesh-llm-memory/issues"
   },
   "keywords": [
-    "claude",
     "claude-code",
-    "claude-code-plugin",
     "mcp",
-    "ai-memory",
-    "knowledge-graph",
-    "persistent-memory"
+    "model-context-protocol",
+    "memory",
+    "sqlite",
+    "knowledge-graph"
   ],
-  "author": "PCIRCLE-AI",
-  "license": "MIT",
-  "homepage": "https://github.com/PCIRCLE-AI/claude-code-buddy",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/PCIRCLE-AI/claude-code-buddy.git"
-  },
-  "bugs": {
-    "url": "https://github.com/PCIRCLE-AI/claude-code-buddy/issues"
+    "url": "git+https://github.com/PCIRCLE-AI/memesh-llm-memory.git"
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.78.0",
-    "@modelcontextprotocol/sdk": "^1.25.3",
-    "@types/fs-extra": "^11.0.4",
-    "@types/inquirer": "^9.0.9",
-    "@xenova/transformers": "^2.17.2",
-    "asciichart": "^1.5.25",
-    "better-sqlite3": "^12.6.2",
-    "boxen": "^8.0.1",
-    "chalk": "^5.6.2",
-    "chokidar": "^5.0.0",
-    "cli-spinners": "^3.4.0",
-    "cli-table3": "^0.6.5",
-    "commander": "^14.0.2",
-    "dotenv": "^17.2.3",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "better-sqlite3": "^12.9.0",
+    "commander": "^14.0.3",
     "express": "^5.2.1",
-    "fs-extra": "^11.3.3",
-    "glob": "^13.0.0",
-    "inquirer": "^13.2.2",
-    "minimatch": "^10.1.1",
-    "onnxruntime-node": "^1.23.2",
-    "ora": "^9.0.0",
-    "sqlite": "^5.1.1",
-    "sqlite-vec": "0.1.3",
-    "uuid": "^13.0.0",
-    "winston": "^3.19.0",
-    "zod": "^4.3.5"
+    "sqlite-vec": "^0.1.9",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@types/asciichart": "^1.5.8",
     "@types/better-sqlite3": "^7.6.13",
     "@types/express": "^5.0.6",
     "@types/node": "^25.0.9",
-    "@types/supertest": "^6.0.3",
-    "@types/uuid": "^11.0.0",
-    "@types/winston": "^2.4.4",
-    "@typescript-eslint/eslint-plugin": "^8.56.1",
-    "@typescript-eslint/parser": "^8.56.1",
-    "@vitest/coverage-v8": "^4.0.17",
-    "ajv": "^8.17.1",
-    "eslint": "^10.0.2",
-    "prettier": "^3.8.0",
-    "supertest": "^7.2.2",
-    "tsx": "^4.19.2",
-    "typedoc": "^0.28.16",
     "typescript": "^5.9.3",
     "vitest": "^4.0.17"
   },
-  "overrides": {
-    "hono": "4.11.10"
-  },
   "engines": {
-    "node": ">=20.0.0",
-    "npm": ">=9.0.0"
+    "node": ">=20.0.0"
   }
 }

package/plugin.json

@@ -1,15 +1,12 @@
 {
   "name": "memesh",
-  "description": "MeMesh Plugin — Persistent memory plugin for Claude Code. Remembers architecture decisions, coding patterns, and project context across sessions.",
-  "author": {
-    "name": "PCIRCLE AI"
-  },
-  "version": "2.10.1",
-  "homepage": "https://github.com/PCIRCLE-AI/claude-code-buddy",
-  "repository": "https://github.com/PCIRCLE-AI/claude-code-buddy",
+  "description": "MeMesh — The lightest universal AI memory layer. One SQLite file, any LLM, zero cloud.",
+  "author": { "name": "PCIRCLE AI" },
+  "version": "3.0.0",
+  "homepage": "https://github.com/PCIRCLE-AI/memesh-llm-memory",
+  "repository": "https://github.com/PCIRCLE-AI/memesh-llm-memory",
   "license": "MIT",
-  "keywords": ["claude-code", "mcp", "knowledge-graph", "ai-memory", "persistent-memory"],
+  "keywords": ["claude-code", "mcp", "knowledge-graph", "ai-memory"],
   "mcpServers": "./.mcp.json",
-  "hooks": "./hooks/hooks.json",
-  "skills": "./skills/"
+  "hooks": "./hooks/hooks.json"
 }