@pcircle/memesh 2.11.0 → 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

@@ -21,6 +21,30 @@
           }
         ]
       }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/hooks/session-summary.js",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/hooks/pre-compact.js",
+            "timeout": 10
+          }
+        ]
+      }
     ]
   }
 }

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@pcircle/memesh",
-  "version": "2.11.0",
-  "description": "MeMesh — Minimal persistent memory plugin for Claude Code.",
+  "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.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": [
@@ -18,25 +20,41 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsc && chmod +x dist/mcp/server.js && chmod +x dist/cli/view.js && chmod +x scripts/hooks/*.js",
+    "build": "tsc && node scripts/copy-cli-assets.mjs && node scripts/set-executable-bits.mjs",
     "test": "vitest",
+    "test:packaged": "node scripts/smoke-packed-artifact.mjs",
     "typecheck": "tsc --noEmit",
     "start": "node dist/mcp/server.js"
   },
   "author": "PCIRCLE-AI",
   "license": "MIT",
-  "homepage": "https://github.com/PCIRCLE-AI/claude-code-buddy",
+  "homepage": "https://github.com/PCIRCLE-AI/memesh-llm-memory",
+  "bugs": {
+    "url": "https://github.com/PCIRCLE-AI/memesh-llm-memory/issues"
+  },
+  "keywords": [
+    "claude-code",
+    "mcp",
+    "model-context-protocol",
+    "memory",
+    "sqlite",
+    "knowledge-graph"
+  ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/PCIRCLE-AI/claude-code-buddy.git"
+    "url": "git+https://github.com/PCIRCLE-AI/memesh-llm-memory.git"
   },
   "dependencies": {
-    "better-sqlite3": "^12.6.2",
-    "@modelcontextprotocol/sdk": "^1.25.3",
-    "zod": "^4.3.5"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "better-sqlite3": "^12.9.0",
+    "commander": "^14.0.3",
+    "express": "^5.2.1",
+    "sqlite-vec": "^0.1.9",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
+    "@types/express": "^5.0.6",
     "@types/node": "^25.0.9",
     "typescript": "^5.9.3",
     "vitest": "^4.0.17"

package/plugin.json

@@ -1,10 +1,10 @@
 {
   "name": "memesh",
-  "description": "MeMesh — Minimal persistent memory plugin for Claude Code.",
+  "description": "MeMesh — The lightest universal AI memory layer. One SQLite file, any LLM, zero cloud.",
   "author": { "name": "PCIRCLE AI" },
-  "version": "2.11.0",
-  "homepage": "https://github.com/PCIRCLE-AI/claude-code-buddy",
-  "repository": "https://github.com/PCIRCLE-AI/claude-code-buddy",
+  "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"],
   "mcpServers": "./.mcp.json",

package/scripts/hooks/post-commit.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 import { createRequire } from 'module';
+import { execFileSync } from 'child_process';
 import { homedir } from 'os';
 import { join, basename } from 'path';
 import { existsSync, mkdirSync } from 'fs';
@@ -45,6 +46,13 @@ CREATE TABLE IF NOT EXISTS tags (
 
 CREATE INDEX IF NOT EXISTS idx_tags_entity ON tags(entity_id);
 CREATE INDEX IF NOT EXISTS idx_tags_tag ON tags(tag);
+DELETE FROM tags
+WHERE id NOT IN (
+  SELECT MIN(id)
+  FROM tags
+  GROUP BY entity_id, tag
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_tags_entity_tag_unique ON tags(entity_id, tag);
 CREATE INDEX IF NOT EXISTS idx_observations_entity ON observations(entity_id);
 CREATE INDEX IF NOT EXISTS idx_relations_from ON relations(from_entity_id);
 CREATE INDEX IF NOT EXISTS idx_relations_to ON relations(to_entity_id);
@@ -73,6 +81,9 @@ process.stdin.on('end', () => {
     const commitMatch = toolOutput.match(/\[[\w/.-]+ ([a-f0-9]{7,})\] (.+)/);
     if (!commitMatch) return exit0();
 
+    const branchMatch = commitMatch[0].match(/^\[([^\s]+)\s/);
+    const branch = branchMatch ? branchMatch[1] : 'unknown';
+
     const commitHash = commitMatch[1];
     const commitMsg = commitMatch[2];
     const projectName = basename(data.cwd || process.cwd());
@@ -106,15 +117,32 @@ process.stdin.on('end', () => {
           : db.prepare('SELECT content FROM observations WHERE entity_id = ?').all(entity.id);
         const prevObsText = isNew ? undefined : prevObs.map(o => o.content).join(' ');
 
-        // Add observation
+        // Add observations
         db.prepare('INSERT INTO observations (entity_id, content) VALUES (?, ?)').run(entity.id, commitMsg);
+        db.prepare('INSERT INTO observations (entity_id, content) VALUES (?, ?)').run(entity.id, `Branch: ${branch}`);
+
+        // Add richer diff stats as an observation (backward compatible — failures are silently ignored)
+        try {
+          const stat = execFileSync('git', ['show', '--stat', '--format=', commitHash], {
+            cwd: data.cwd || process.cwd(),
+            encoding: 'utf8',
+            timeout: 5000,
+          }).trim();
+          if (stat) {
+            // Last non-empty line is the summary, e.g. "3 files changed, 45 insertions(+), 12 deletions(-)"
+            const statLines = stat.split('\n').filter(l => l.trim());
+            const summary = statLines[statLines.length - 1]?.trim() || '';
+            if (summary) {
+              db.prepare('INSERT INTO observations (entity_id, content) VALUES (?, ?)').run(entity.id, `Diff stats: ${summary}`);
+            }
+          }
+        } catch {
+          // git show failed — no diff stats recorded, existing behavior unchanged
+        }
 
-        // Add project tag (check first since no unique constraint)
+        // Add project tag
         const projectTag = `project:${projectName}`;
-        const existingTag = db.prepare('SELECT id FROM tags WHERE entity_id = ? AND tag = ?').get(entity.id, projectTag);
-        if (!existingTag) {
-          db.prepare('INSERT INTO tags (entity_id, tag) VALUES (?, ?)').run(entity.id, projectTag);
-        }
+        db.prepare('INSERT OR IGNORE INTO tags (entity_id, tag) VALUES (?, ?)').run(entity.id, projectTag);
 
         // Update FTS index — delete old entry first if entity existed
         if (prevObsText !== undefined) {
@@ -132,6 +160,7 @@ process.stdin.on('end', () => {
     // Never crash Claude Code — but leave a trace for debugging
     try { process.stderr.write(`[memesh post-commit] ${err?.message || err}\n`); } catch {}
   }
+  console.log(JSON.stringify({ suppressOutput: true }));
   exit0();
 });