@pcircle/memesh 2.9.0 → 2.9.1

package/dist/mcp/ToolDefinitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToolDefinitions.d.ts","sourceRoot":"","sources":["../../src/mcp/ToolDefinitions.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BzB,CAAC;AAKF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IAMF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAKD,wBAAgB,qBAAqB,IAAI,iBAAiB,EAAE,CAmkB3D"}
+{"version":3,"file":"ToolDefinitions.d.ts","sourceRoot":"","sources":["../../src/mcp/ToolDefinitions.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BzB,CAAC;AAKF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IAMF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAKD,wBAAgB,qBAAqB,IAAI,iBAAiB,EAAE,CAud3D"}

package/dist/mcp/ToolDefinitions.js

@@ -371,110 +371,6 @@ tags: ["tech:jwt", "tech:nodejs", "domain:authentication", "security"]`,
             openWorldHint: false,
         },
     };
-    const cloudSyncTool = {
-        name: 'memesh-cloud-sync',
-        description: `☁️ Sync local Knowledge Graph memories with MeMesh Cloud.
-
-**Actions:**
-• {action: "status"}: Compare local vs cloud memory counts
-• {action: "push"}: Push local memories to cloud
-• {action: "pull"}: Pull cloud memories to local
-• {action: "push", dryRun: true}: Preview what would be synced
-
-Requires MEMESH_API_KEY to be configured. Without it, all actions return a setup guide.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                action: {
-                    type: 'string',
-                    enum: ['push', 'pull', 'status'],
-                    description: 'Sync action: push (local→cloud), pull (cloud→local), status (compare)',
-                },
-                query: {
-                    type: 'string',
-                    description: 'Optional search query to filter which memories to sync',
-                },
-                space: {
-                    type: 'string',
-                    description: 'Cloud memory space to sync with (default: "default")',
-                    default: 'default',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max memories per batch (default: 100, max: 500)',
-                    minimum: 1,
-                    maximum: 500,
-                    default: 100,
-                },
-                dryRun: {
-                    type: 'boolean',
-                    description: 'Preview sync without executing (default: false)',
-                    default: false,
-                },
-            },
-            required: ['action'],
-        },
-        outputSchema: OutputSchemas.cloudSync,
-        annotations: {
-            title: 'Cloud Sync',
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: true,
-        },
-    };
-    const agentRegisterTool = {
-        name: 'memesh-agent-register',
-        description: `🤖 Register this agent with MeMesh Cloud for agent-specific capabilities.
-
-**What Registration Provides:**
-• Agent ID for tracking and analytics
-• Access to agent-specific features
-• Message queue for inter-agent communication
-• Heartbeat monitoring and status tracking
-
-**Agent Types (API enum):**
-• "claude" - Claude / Claude Code
-• "chatgpt" - ChatGPT
-• "gemini" - Google Gemini
-• "grok" - xAI Grok
-• "deepseek" - DeepSeek
-• "codex" - OpenAI Codex
-• "cursor" - Cursor IDE
-• "custom" - Other / custom agents
-
-Requires MEMESH_API_KEY to be configured.`,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                agentType: {
-                    type: 'string',
-                    description: 'Type of agent. Valid: "claude", "chatgpt", "gemini", "grok", "deepseek", "codex", "cursor", "custom"',
-                },
-                agentName: {
-                    type: 'string',
-                    description: 'Optional agent name (no spaces — use hyphens, e.g., "my-agent")',
-                },
-                agentVersion: {
-                    type: 'string',
-                    description: 'Optional version string (e.g., "1.0.0")',
-                },
-                capabilities: {
-                    type: 'object',
-                    description: 'Optional capabilities object describing what the agent can do',
-                },
-            },
-            required: ['agentType'],
-        },
-        outputSchema: OutputSchemas.agentRegister,
-        annotations: {
-            title: 'Agent Registration',
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    };
     const generateTestsTool = {
         name: 'memesh-generate-tests',
         aliases: ['generate-tests'],

package/dist/mcp/ToolDefinitions.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pcircle/memesh",
-  "version": "2.9.0",
+  "version": "2.9.1",
   "description": "MeMesh — Persistent memory plugin for Claude Code. Remembers architecture decisions, coding patterns, and project context across sessions.",
   "main": "dist/index.js",
   "type": "module",
@@ -12,6 +12,7 @@
     "scripts/postinstall-new.js",
     "scripts/postinstall-lib.js",
     "scripts/skills/",
+    "scripts/hooks/",
     "plugin.json",
     "mcp.json",
     "README.md",

package/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "PCIRCLE AI"
   },
-  "version": "2.9.0",
+  "version": "2.9.1",
   "homepage": "https://github.com/PCIRCLE-AI/claude-code-buddy",
   "repository": "https://github.com/PCIRCLE-AI/claude-code-buddy",
   "license": "MIT"

package/scripts/hooks/README.md

@@ -0,0 +1,230 @@
+# MeMesh Hooks for Claude Code
+
+**What are these?** Scripts that run automatically when you use Claude Code. They provide memory management, smart routing, code quality enforcement, and planning assistance.
+
+## What They Do
+
+| When | What Happens |
+|------|--------------|
+| **You open Claude Code** | Reloads CLAUDE.md, shows last session recap (cache-first) |
+| **Before a tool runs** | Smart routing, planning template injection, dry-run gate, code review reminder |
+| **After a tool runs** | Tracks work patterns, file modifications, test executions |
+| **You make a git commit** | Saves commit context to knowledge graph (batched) |
+| **A subagent finishes** | Saves code review results, tracks completion |
+| **You close Claude Code** | Saves session summary + cache for fast next startup |
+
+## Installation
+
+```bash
+# Copy hooks to Claude Code
+cp scripts/hooks/*.js ~/.claude/hooks/
+cp -r scripts/hooks/templates/ ~/.claude/hooks/templates/
+chmod +x ~/.claude/hooks/*.js
+```
+
+**Done!** Restart Claude Code to activate.
+
+---
+
+## Features
+
+### Smart Router (PreToolUse)
+
+Routes subagent tasks to optimal models and controls background execution.
+
+```
+Task(Explore) → model: haiku (fast search)
+Task(Plan)    → inject SDD+BDD planning template
+Task(heavy)   → check for untested code, warn if found
+```
+
+Configuration: `~/.memesh/routing-config.json`
+
+```json
+{
+  "modelRouting": {
+    "rules": [
+      { "subagentType": "Explore", "model": "haiku", "reason": "Fast search" }
+    ]
+  },
+  "backgroundRules": [
+    { "subagentType": "Explore", "forceBackground": false }
+  ],
+  "planningEnforcement": { "enabled": true },
+  "dryRunGate": { "enabled": true },
+  "auditLog": true
+}
+```
+
+Audit log: `~/.memesh/routing-audit.log`
+
+### Planning Enforcement
+
+When a Plan subagent is dispatched, the hook injects a template requiring:
+- System Design Description (SDD)
+- Behavior-Driven Design (BDD) with Gherkin scenarios
+- Edge case handling table
+- Dry-run test plan
+- Risk assessment
+
+The plan is always presented to the user for approval before implementation.
+
+### Dry-Run Gate
+
+Tracks which files were modified (Write/Edit) and which were tested
+(vitest/jest/tsc/node --check). Before heavy Task dispatches, warns if
+modified files haven't been tested yet.
+
+**Advisory only** — never blocks, just informs.
+
+### Pre-Commit Code Review
+
+```
+git commit detected → Code review done? → Yes → Allow
+                                        → No  → Inject reminder
+```
+
+### Auto-Memory (Batched)
+
+```
+Open Claude Code  →  Work normally  →  Git commit  →  Close Claude Code
+      ↓                    ↓                ↓                 ↓
+Cache-first recall   Track patterns   Batch save to KG   Cache + archive
+(0 SQLite spawns)   (async writes)   (2 spawns vs 8)
+```
+
+### What Gets Tracked
+
+| Symbol | Meaning |
+|--------|---------|
+| 📁 | Files you changed |
+| ✅ | Git commits you made |
+| 💡 | Things you learned |
+| ⚠️ | Problems you ran into |
+| 🎯 | Decisions you made |
+| 🔍 | Code review findings |
+
+---
+
+## Troubleshooting
+
+### "Hooks not working"
+
+```bash
+ls ~/.claude/hooks/
+cp scripts/hooks/*.js ~/.claude/hooks/
+```
+
+### "No memory showing"
+
+```bash
+ls ~/.memesh/knowledge-graph.db
+```
+
+### "Routing not applying"
+
+```bash
+# Check config
+cat ~/.memesh/routing-config.json
+
+# Check audit log
+tail -20 ~/.memesh/routing-audit.log
+```
+
+## Limitations
+
+| What | Details |
+|------|---------|
+| **Claude Code only** | Doesn't work in Cursor |
+| **30-day memory** | Old session memories auto-deleted |
+| **Local only** | No sync between computers |
+| **Advisory gates** | Dry-run and review are reminders, not blockers |
+
+---
+
+## Files
+
+```
+scripts/hooks/
+├── session-start.js    ← SessionStart: reload CLAUDE.md, cache-first recall
+├── pre-tool-use.js     ← PreToolUse: handler registry (4 handlers)
+│   ├── codeReviewHandler  — git commit review enforcement
+│   ├── routingHandler     — model/background selection
+│   ├── planningHandler    — SDD+BDD template injection
+│   └── dryRunGateHandler  — untested code warning
+├── post-tool-use.js    ← PostToolUse: patterns, file/test tracking, async writes
+├── post-commit.js      ← PostToolUse: batch save commit to KG
+├── subagent-stop.js    ← SubagentStop: capture code review results
+├── stop.js             ← Stop: batch save, cache, archive, cleanup
+├── hook-utils.js       ← Shared: sqliteBatch, async I/O, constants
+├── templates/
+│   └── planning-template.md  ← SDD+BDD+edge case template
+└── __tests__/
+    ├── hook-test-harness.js  ← Test runner (no Claude Code needed)
+    └── hooks.test.js         ← 15 test cases
+```
+
+### Handler Flow (PreToolUse)
+
+```
+PreToolUse event
+  ↓
+┌──────────────────────┐
+│   Handler Registry    │
+│   ├─ codeReview      │ → additionalContext (review reminder)
+│   ├─ routing         │ → updatedInput (model, background)
+│   ├─ planning        │ → updatedInput.prompt (template)
+│   └─ dryRunGate      │ → additionalContext (untested warning)
+└──────────────────────┘
+  ↓
+┌──────────────────────┐
+│   Response Merger     │
+│   • updatedInput: deep-merge
+│   • additionalContext: concatenate
+│   • permissionDecision: most-restrictive
+└──────────────────────┘
+  ↓
+Single JSON → Claude Code
+```
+
+---
+
+## Testing
+
+```bash
+# Run all 15 tests
+node scripts/hooks/__tests__/hooks.test.js
+
+# Test individual hook with mock input
+node scripts/hooks/__tests__/hook-test-harness.js pre-tool-use.js \
+  '{"tool_name":"Task","tool_input":{"subagent_type":"Plan","prompt":"test"}}'
+
+# Syntax check all hooks
+for f in scripts/hooks/*.js; do node --check "$f" && echo "OK: $f"; done
+```
+
+## Configuration
+
+### Routing Config (`~/.memesh/routing-config.json`)
+
+| Field | Description |
+|-------|-------------|
+| `modelRouting.rules` | Subagent → model mapping |
+| `backgroundRules` | Subagent → force background |
+| `planningEnforcement.enabled` | Inject SDD+BDD template |
+| `dryRunGate.enabled` | Warn on untested code |
+| `auditLog` | Log routing decisions |
+
+### Thresholds (`hook-utils.js`)
+
+```javascript
+THRESHOLDS = {
+  TOKEN_SAVE: 250_000,
+  RETENTION_DAYS: 30,
+  MAX_ARCHIVED_SESSIONS: 30
+}
+```
+
+---
+
+Part of MeMesh project. License: MIT.

package/scripts/hooks/__tests__/hook-test-harness.js

@@ -0,0 +1,218 @@
+#!/usr/bin/env node
+
+/**
+ * Hook Test Harness — Simulates Claude Code hook execution.
+ *
+ * Pipes mock stdin JSON to a hook script and validates the output.
+ * Does NOT require Claude Code runtime.
+ *
+ * Usage:
+ *   node hook-test-harness.js <hook-script> <mock-stdin-json>
+ *   node hook-test-harness.js ../pre-tool-use.js '{"tool_name":"Bash","tool_input":{"command":"git commit -m test"}}'
+ *
+ * Or programmatically:
+ *   import { runHook, assertJSON, assertContains } from './hook-test-harness.js';
+ */
+
+import { execFile } from 'child_process';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// ============================================================================
+// Core Test Functions
+// ============================================================================
+
+/**
+ * Run a hook script with mock stdin and capture output.
+ *
+ * @param {string} hookPath - Path to hook script (relative to hooks/ dir or absolute)
+ * @param {Object|string} stdinData - JSON data to pipe as stdin
+ * @param {Object} options - Options
+ * @param {number} options.timeout - Timeout in ms (default: 10000)
+ * @param {Object} options.env - Additional environment variables
+ * @returns {Promise<{ stdout: string, stderr: string, exitCode: number, parsed: Object|null }>}
+ */
+export function runHook(hookPath, stdinData, options = {}) {
+  const { timeout = 10000, env = {} } = options;
+
+  // Resolve hook path relative to hooks directory
+  const resolvedPath = path.isAbsolute(hookPath)
+    ? hookPath
+    : path.resolve(__dirname, '..', hookPath);
+
+  const stdinStr = typeof stdinData === 'string'
+    ? stdinData
+    : JSON.stringify(stdinData);
+
+  return new Promise((resolve) => {
+    const child = execFile('node', [resolvedPath], {
+      encoding: 'utf-8',
+      timeout,
+      env: { ...process.env, ...env },
+    }, (error, stdout, stderr) => {
+      let parsed = null;
+      try {
+        if (stdout.trim()) {
+          parsed = JSON.parse(stdout.trim());
+        }
+      } catch {
+        // Not JSON output — that's fine for some hooks
+      }
+
+      resolve({
+        stdout: stdout || '',
+        stderr: stderr || '',
+        exitCode: error ? (error.code || 1) : 0,
+        parsed,
+      });
+    });
+
+    // Pipe stdin
+    if (child.stdin) {
+      child.stdin.write(stdinStr);
+      child.stdin.end();
+    }
+  });
+}
+
+// ============================================================================
+// Assertion Helpers
+// ============================================================================
+
+/**
+ * Assert that the hook output is valid JSON with expected structure.
+ * @param {Object} result - Result from runHook()
+ * @param {string} hookEventName - Expected hookEventName
+ * @returns {boolean}
+ */
+export function assertHookResponse(result, hookEventName) {
+  if (!result.parsed) {
+    console.error(`  FAIL: No JSON output`);
+    return false;
+  }
+
+  const output = result.parsed.hookSpecificOutput;
+  if (!output) {
+    console.error(`  FAIL: Missing hookSpecificOutput`);
+    return false;
+  }
+
+  if (output.hookEventName !== hookEventName) {
+    console.error(`  FAIL: hookEventName is "${output.hookEventName}", expected "${hookEventName}"`);
+    return false;
+  }
+
+  return true;
+}
+
+/**
+ * Assert that stdout contains a substring.
+ * @param {Object} result - Result from runHook()
+ * @param {string} substring - Expected substring
+ * @returns {boolean}
+ */
+export function assertContains(result, substring) {
+  const fullOutput = result.stdout + result.stderr;
+  if (!fullOutput.includes(substring)) {
+    console.error(`  FAIL: Output does not contain "${substring}"`);
+    return false;
+  }
+  return true;
+}
+
+/**
+ * Assert hook exited silently (no stdout, exit 0).
+ * @param {Object} result - Result from runHook()
+ * @returns {boolean}
+ */
+export function assertSilent(result) {
+  if (result.stdout.trim() !== '') {
+    console.error(`  FAIL: Expected silent exit, got stdout: ${result.stdout.substring(0, 100)}`);
+    return false;
+  }
+  return true;
+}
+
+// ============================================================================
+// Test Runner
+// ============================================================================
+
+/**
+ * Simple test runner for hook tests.
+ * @param {string} suiteName - Test suite name
+ * @param {Array<{name: string, fn: Function}>} tests - Test cases
+ */
+export async function runTests(suiteName, tests) {
+  console.log(`\n  ${suiteName}`);
+  console.log('  ' + '─'.repeat(50));
+
+  let passed = 0;
+  let failed = 0;
+
+  for (const test of tests) {
+    try {
+      const result = await test.fn();
+      if (result !== false) {
+        console.log(`  ✅ ${test.name}`);
+        passed++;
+      } else {
+        console.log(`  ❌ ${test.name}`);
+        failed++;
+      }
+    } catch (error) {
+      console.log(`  ❌ ${test.name}`);
+      console.error(`     Error: ${error.message}`);
+      failed++;
+    }
+  }
+
+  console.log('  ' + '─'.repeat(50));
+  console.log(`  Results: ${passed} passed, ${failed} failed\n`);
+
+  return { passed, failed };
+}
+
+// ============================================================================
+// CLI Mode
+// ============================================================================
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length < 2) {
+    console.log('Usage: node hook-test-harness.js <hook-script> <mock-stdin-json>');
+    console.log('');
+    console.log('Examples:');
+    console.log('  node hook-test-harness.js pre-tool-use.js \'{"tool_name":"Bash","tool_input":{"command":"git commit -m test"}}\'');
+    console.log('  node hook-test-harness.js post-tool-use.js \'{"tool_name":"Read","tool_input":{"file_path":"/tmp/test.js"}}\'');
+    process.exit(0);
+  }
+
+  const [hookScript, stdinJSON] = args;
+
+  console.log(`\nRunning: ${hookScript}`);
+  console.log(`Stdin: ${stdinJSON.substring(0, 100)}...`);
+  console.log('');
+
+  const result = await runHook(hookScript, stdinJSON);
+
+  console.log(`Exit code: ${result.exitCode}`);
+  if (result.stdout.trim()) {
+    console.log(`Stdout: ${result.stdout.trim()}`);
+  }
+  if (result.stderr.trim()) {
+    console.log(`Stderr: ${result.stderr.trim()}`);
+  }
+  if (result.parsed) {
+    console.log(`Parsed JSON:`);
+    console.log(JSON.stringify(result.parsed, null, 2));
+  }
+}
+
+// Run CLI mode if invoked directly
+if (process.argv[1] && process.argv[1].includes('hook-test-harness')) {
+  main().catch(console.error);
+}