keepmind 1.0.0

package/openclaw/test-sse-consumer.js

@@ -0,0 +1,98 @@
+
+import claudeMemPlugin from "./dist/index.js";
+
+let registeredService = null;
+const registeredCommands = new Map();
+const eventHandlers = new Map();
+const logs = [];
+
+const mockApi = {
+  id: "claude-mem",
+  name: "Claude-Mem (Persistent Memory)",
+  version: "1.0.0",
+  source: "/test/extensions/claude-mem/dist/index.js",
+  config: {},
+  pluginConfig: {},
+  logger: {
+    info: (message) => { logs.push(message); },
+    warn: (message) => { logs.push(message); },
+    error: (message) => { logs.push(message); },
+    debug: (message) => { logs.push(message); },
+  },
+  registerService: (service) => {
+    registeredService = service;
+  },
+  registerCommand: (command) => {
+    registeredCommands.set(command.name, command);
+  },
+  on: (event, callback) => {
+    if (!eventHandlers.has(event)) {
+      eventHandlers.set(event, []);
+    }
+    eventHandlers.get(event).push(callback);
+  },
+  runtime: {
+    channel: {
+      telegram: { sendMessageTelegram: async () => {} },
+      discord: { sendMessageDiscord: async () => {} },
+      signal: { sendMessageSignal: async () => {} },
+      slack: { sendMessageSlack: async () => {} },
+      whatsapp: { sendMessageWhatsApp: async () => {} },
+      line: { sendMessageLine: async () => {} },
+    },
+  },
+};
+
+claudeMemPlugin(mockApi);
+
+let failures = 0;
+
+if (!registeredService) {
+  console.error("FAIL: No service was registered");
+  failures++;
+} else if (registeredService.id !== "claude-mem-observation-feed") {
+  console.error(
+    `FAIL: Service ID is "${registeredService.id}", expected "claude-mem-observation-feed"`
+  );
+  failures++;
+} else {
+  console.log("OK: Service registered with id 'claude-mem-observation-feed'");
+}
+
+if (!registeredCommands.has("claude-mem-feed")) {
+  console.error("FAIL: No 'claude-mem-feed' command registered");
+  failures++;
+} else {
+  console.log("OK: Command registered with name 'claude-mem-feed'");
+}
+
+if (!registeredCommands.has("claude-mem-status")) {
+  console.error("FAIL: No 'claude-mem-status' command registered");
+  failures++;
+} else {
+  console.log("OK: Command registered with name 'claude-mem-status'");
+}
+
+const expectedEvents = ["before_agent_start", "tool_result_persist", "agent_end", "gateway_start"];
+for (const event of expectedEvents) {
+  if (!eventHandlers.has(event) || eventHandlers.get(event).length === 0) {
+    console.error(`FAIL: No handler registered for '${event}'`);
+    failures++;
+  } else {
+    console.log(`OK: Event handler registered for '${event}'`);
+  }
+}
+
+if (!logs.some((l) => l.includes("plugin loaded"))) {
+  console.error("FAIL: Plugin did not log a load message");
+  failures++;
+} else {
+  console.log("OK: Plugin logged load message");
+}
+
+if (failures > 0) {
+  console.error(`\nFAIL: ${failures} check(s) failed`);
+  process.exit(1);
+} else {
+  console.log("\nPASS: Plugin registers service, commands, and event handlers correctly");
+}

package/openclaw/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "lib": ["ES2022", "DOM"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "allowSyntheticDefaultImports": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}

package/package.json

@@ -0,0 +1,187 @@
+{
+  "name": "keepmind",
+  "version": "1.0.0",
+  "description": "Memory compression system for Claude Code - persist context across sessions (node-only fork of claude-mem)",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "claude-agent-sdk",
+    "mcp",
+    "plugin",
+    "memory",
+    "compression",
+    "knowledge-graph",
+    "transcript",
+    "typescript",
+    "nodejs"
+  ],
+  "author": "Manuel Staggl",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ManuelStaggl/keepmind.git"
+  },
+  "homepage": "https://github.com/ManuelStaggl/keepmind#readme",
+  "bugs": {
+    "url": "https://github.com/ManuelStaggl/keepmind/issues"
+  },
+  "type": "module",
+  "bin": {
+    "keepmind": "dist/npx-cli/index.js"
+  },
+  "exports": {
+    "./modes/*": "./plugin/modes/*"
+  },
+  "files": [
+    "dist",
+    ".agents/plugins/marketplace.json",
+    ".codex-plugin",
+    "plugin/.claude-plugin",
+    "plugin/.codex-plugin",
+    "plugin/.mcp.json",
+    "plugin/package.json",
+    "plugin/bun.lock",
+    "plugin/hooks",
+    "plugin/modes",
+    "plugin/scripts/*.js",
+    "plugin/scripts/*.cjs",
+    "plugin/skills",
+    "plugin/ui",
+    "openclaw"
+  ],
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "scripts": {
+    "dev": "npm run build-and-sync",
+    "build": "node scripts/sync-plugin-manifests.js && node scripts/build-hooks.js && node scripts/gen-plugin-lockfile.cjs",
+    "build-and-sync": "npm run build && npm run sync-marketplace && node scripts/restart-marketplace-worker.cjs",
+    "sync-marketplace": "node scripts/sync-marketplace.cjs",
+    "sync-marketplace:force": "node scripts/sync-marketplace.cjs --force",
+    "build:binaries": "node scripts/build-worker-binary.js",
+    "build:cli-binary": "esbuild ./src/services/worker-service.ts --bundle --platform=node --format=cjs --minify --external:node:sqlite --banner:js=\"#!/usr/bin/env node\" --outfile=plugin/scripts/keepmind.cjs",
+    "worker:logs": "node scripts/worker-logs.cjs -n 50",
+    "worker:tail": "node scripts/worker-logs.cjs -n 50 --follow",
+    "changelog:generate": "node scripts/generate-changelog.js",
+    "discord:notify": "node scripts/discord-release-notify.js",
+    "worker:start": "node plugin/scripts/worker-service.cjs start",
+    "worker:stop": "node plugin/scripts/worker-service.cjs stop",
+    "worker:restart": "node plugin/scripts/worker-service.cjs restart",
+    "worker:status": "node plugin/scripts/worker-service.cjs status",
+    "bug-report": "npx tsx scripts/bug-report/cli.ts",
+    "cursor:install": "node plugin/scripts/worker-service.cjs cursor install",
+    "cursor:uninstall": "node plugin/scripts/worker-service.cjs cursor uninstall",
+    "cursor:status": "node plugin/scripts/worker-service.cjs cursor status",
+    "cursor:setup": "node plugin/scripts/worker-service.cjs cursor setup",
+    "lint:hook-io": "node scripts/check-hook-io-discipline.cjs",
+    "lint:spawn-env": "node scripts/check-spawn-env-discipline.cjs",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p src/ui/viewer/tsconfig.json",
+    "typecheck:root": "tsc --noEmit",
+    "typecheck:viewer": "tsc --noEmit -p src/ui/viewer/tsconfig.json",
+    "test": "node --import tsx --import ./tests/preload.ts --experimental-test-module-mocks --test \"tests/**/*.test.ts\"",
+    "test:sqlite": "node --import tsx --import ./tests/preload.ts --experimental-test-module-mocks --test \"tests/sqlite/**/*.test.ts\"",
+    "test:agents": "node --import tsx --import ./tests/preload.ts --experimental-test-module-mocks --test \"tests/worker/agents/**/*.test.ts\"",
+    "test:search": "node --import tsx --import ./tests/preload.ts --experimental-test-module-mocks --test \"tests/worker/search/**/*.test.ts\"",
+    "test:context": "node --import tsx --import ./tests/preload.ts --experimental-test-module-mocks --test \"tests/context/**/*.test.ts\"",
+    "test:infra": "node --import tsx --import ./tests/preload.ts --experimental-test-module-mocks --test \"tests/infrastructure/**/*.test.ts\"",
+    "check:postinstall-allowlist": "node scripts/check-postinstall-allowlist.js",
+    "smoke:clean-room": "node scripts/smoke-clean-room.cjs",
+    "prepublishOnly": "npm run build && node scripts/check-postinstall-allowlist.js",
+    "release": "np",
+    "release:patch": "np patch --no-cleanup",
+    "release:minor": "np minor --no-cleanup",
+    "release:major": "np major --no-cleanup"
+  },
+  "np": {
+    "yarn": false,
+    "contents": ".",
+    "testScript": "test",
+    "2fa": false
+  },
+  "dependencies": {
+    "@huggingface/transformers": "^4.2.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "sqlite-vec": "^0.1.9",
+    "zod": "^4.4.3"
+  },
+  "//dependencies-note": "Local-only fork: the cloud/SaaS layer (Postgres + BullMQ + better-auth) and the `claude-mem/sdk` export were removed, so pg/better-auth/@better-auth/api-key/bullmq/ioredis are gone. zod + @modelcontextprotocol/sdk survive the bundler as live `import`/`require` in a shipped artifact (the mcp-server bundles zod). @huggingface/transformers + sqlite-vec power the in-process vector search (Phase 2, replacing the chroma-mcp/uvx subprocess) and are intentionally EXTERNALIZED from the worker bundle — transformers pulls onnxruntime-node (.node) and sqlite-vec loads a per-platform .dll/.so via getLoadablePath(), neither of which can be esbuild-inlined; they resolve from node_modules (and the generated plugin/package.json) at runtime. Everything else (express, react, react-dom, cors, dompurify, handlebars, @clack/prompts, ansi-to-html, glob, picocolors, shell-quote, yaml, zod-to-json-schema, @anthropic-ai/claude-agent-sdk) is esbuild-inlined into the worker/npx bundles, so it is a build-time devDependency.",
+  "overrides": {
+    "tmp": "^0.2.7"
+  },
+  "devDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.172",
+    "@clack/prompts": "^1.3.0",
+    "ansi-to-html": "^0.7.2",
+    "cors": "^2.8.6",
+    "dompurify": "^3.4.9",
+    "express": "^5.2.1",
+    "glob": "^13.0.6",
+    "handlebars": "^4.7.9",
+    "picocolors": "^1.1.1",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "shell-quote": "^1.8.3",
+    "yaml": "^2.8.4",
+    "zod-to-json-schema": "^3.25.2",
+    "@derekstride/tree-sitter-sql": "^0.3.11",
+    "@tree-sitter-grammars/tree-sitter-lua": "^0.4.1",
+    "@tree-sitter-grammars/tree-sitter-markdown": "^0.3.2",
+    "@tree-sitter-grammars/tree-sitter-toml": "^0.7.0",
+    "@tree-sitter-grammars/tree-sitter-yaml": "^0.7.1",
+    "@tree-sitter-grammars/tree-sitter-zig": "^1.1.2",
+    "@types/bun": "^1.3.13",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.9.2",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "esbuild": "^0.28.0",
+    "jimp": "^1.6.1",
+    "np": "^11.2.0",
+    "parse5": "^8.0.1",
+    "postcss": "^8.5.14",
+    "remark-mdx": "^3.1.1",
+    "remark-parse": "^11.0.0",
+    "tree-sitter-bash": "^0.25.1",
+    "tree-sitter-c": "^0.24.1",
+    "tree-sitter-cli": "^0.26.8",
+    "tree-sitter-cpp": "^0.23.4",
+    "tree-sitter-css": "^0.25.0",
+    "tree-sitter-elixir": "^0.3.5",
+    "tree-sitter-go": "^0.25.0",
+    "tree-sitter-haskell": "^0.23.1",
+    "tree-sitter-java": "^0.23.5",
+    "tree-sitter-javascript": "^0.25.0",
+    "tree-sitter-kotlin": "^0.3.8",
+    "tree-sitter-php": "^0.24.2",
+    "tree-sitter-python": "^0.25.0",
+    "tree-sitter-ruby": "^0.23.1",
+    "tree-sitter-rust": "^0.24.0",
+    "tree-sitter-scala": "^0.24.0",
+    "tree-sitter-scss": "^1.0.0",
+    "tree-sitter-swift": "^0.7.1",
+    "tree-sitter-typescript": "^0.23.2",
+    "ts-prune": "^0.10.3",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.1.0"
+  },
+  "optionalDependencies": {
+    "tree-kill": "^1.2.2"
+  },
+  "trustedDependencies": [
+    "esbuild",
+    "tree-sitter-c",
+    "tree-sitter-cli",
+    "tree-sitter-cpp",
+    "tree-sitter-go",
+    "tree-sitter-java",
+    "tree-sitter-javascript",
+    "tree-sitter-python",
+    "tree-sitter-ruby",
+    "tree-sitter-rust",
+    "tree-sitter-typescript"
+  ]
+}

package/plugin/.claude-plugin/plugin.json

@@ -0,0 +1,24 @@
+{
+  "name": "keepmind",
+  "version": "1.0.0",
+  "description": "Memory compression system for Claude Code - persist context across sessions (node-only fork of claude-mem)",
+  "author": {
+    "name": "Manuel Staggl"
+  },
+  "repository": "https://github.com/ManuelStaggl/keepmind",
+  "license": "Apache-2.0",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "claude-agent-sdk",
+    "mcp",
+    "plugin",
+    "memory",
+    "compression",
+    "knowledge-graph",
+    "transcript",
+    "typescript",
+    "nodejs"
+  ],
+  "homepage": "https://github.com/ManuelStaggl/keepmind#readme"
+}

package/plugin/.codex-plugin/plugin.json

@@ -0,0 +1,46 @@
+{
+  "name": "keepmind",
+  "version": "1.0.0",
+  "description": "Memory compression system for Claude Code - persist context across sessions (node-only fork of claude-mem)",
+  "author": {
+    "name": "Manuel Staggl",
+    "url": "https://github.com/ManuelStaggl"
+  },
+  "homepage": "https://github.com/ManuelStaggl/keepmind#readme",
+  "repository": "https://github.com/ManuelStaggl/keepmind",
+  "license": "Apache-2.0",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "claude-agent-sdk",
+    "mcp",
+    "plugin",
+    "memory",
+    "compression",
+    "knowledge-graph",
+    "transcript",
+    "typescript",
+    "nodejs"
+  ],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "hooks": "./hooks/codex-hooks.json",
+  "interface": {
+    "displayName": "keepmind",
+    "shortDescription": "Persistent memory and context compression across coding sessions.",
+    "longDescription": "keepmind captures coding-session activity, compresses it into reusable observations, and injects relevant context back into future Claude Code and Codex-compatible sessions.",
+    "developerName": "Manuel Staggl",
+    "category": "Productivity",
+    "capabilities": [
+      "Interactive",
+      "Write"
+    ],
+    "websiteURL": "https://github.com/ManuelStaggl/keepmind",
+    "defaultPrompt": [
+      "Find what I already learned about this codebase before I start a new task.",
+      "Show recent observations related to the files I am editing right now.",
+      "Summarize the last session and inject the most relevant context into this one."
+    ],
+    "brandColor": "#1F6FEB"
+  }
+}

package/plugin/.mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "mcp-search": {
+      "type": "stdio",
+      "command": "node",
+      "args": [
+        "-e",
+        "const f=require('fs'),p=require('path'),o=require('os'),c=require('child_process');const h=o.homedir();const C=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude');const E=process.env.CLAUDE_PLUGIN_ROOT||process.env.PLUGIN_ROOT||'';const d=process.cwd();const L=x=>{try{return f.readdirSync(x).filter(n=>/^\\d/.test(n)).map(n=>p.join(x,n)).filter(z=>{try{return f.statSync(z).isDirectory()}catch{return false}}).sort((a,b)=>f.statSync(b).mtimeMs-f.statSync(a).mtimeMs)}catch{return[]}};const K=[E,p.join(d,\"plugin\"),d,...L(p.join(h,\".codex/plugins/cache/keepmind-local/keepmind\")),...L(p.join(h,\".codex/plugins/cache/keepmind/keepmind\")),...L(p.join(C,\"plugins/cache/keepmind/keepmind\")),p.join(C,\"plugins/marketplaces/keepmind/plugin\")].filter(Boolean);let R=null;for(const k of K){const r=f.existsSync(p.join(k,'plugin','scripts'))?p.join(k,'plugin'):k;if(f.existsSync(p.join(r,'scripts',\"mcp-server.cjs\"))){R=r;break}}if(!R){process.stderr.write(\"keepmind: mcp server not found\\n\");process.exit(1)}const ch=c.spawn(process.execPath,[p.join(R,'scripts',\"mcp-server.cjs\")],{stdio:'inherit'});for(const s of ['SIGTERM','SIGINT','SIGHUP'])process.on(s,()=>{try{ch.kill(s)}catch{}});ch.on('exit',(code,sig)=>{if(sig){process.removeAllListeners(sig);try{process.kill(process.pid,sig)}catch{process.exit(1)}}else process.exit(code==null?0:code)})"
+      ]
+    }
+  }
+}