#!/usr/bin/env node /** * Auto Memory Bridge Hook (ADR-048/049) * * Wires AutoMemoryBridge + LearningBridge + MemoryGraph into Claude Code * session lifecycle. Called by settings.json SessionStart/SessionEnd hooks. * * Usage: * node auto-memory-hook.mjs import # SessionStart: import auto memory files into backend * node auto-memory-hook.mjs sync # SessionEnd: sync insights back to MEMORY.md * node auto-memory-hook.mjs status # Show bridge status */ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs'; import { join, dirname } from 'path'; import { fileURLToPath } from 'url'; const __filename = fileURLToPath(import.meta.url); const __dirname = dirname(__filename); const PROJECT_ROOT = join(__dirname, '../..'); const DATA_DIR = join(PROJECT_ROOT, '.claude-flow', 'data'); const STORE_PATH = join(DATA_DIR, 'auto-memory-store.json'); // Colors const GREEN = '\x1b[0;32m'; const CYAN = '\x1b[0;36m'; const DIM = '\x1b[2m'; const RESET = '\x1b[0m'; const log = (msg) => console.log(`${CYAN}[AutoMemory] ${msg}${RESET}`); const success = (msg) => console.log(`${GREEN}[AutoMemory] ✓ ${msg}${RESET}`); const dim = (msg) => console.log(` ${DIM}${msg}${RESET}`); // Ensure data dir if (!existsSync(DATA_DIR)) mkdirSync(DATA_DIR, { recursive: true }); // ============================================================================ // Simple JSON File Backend (implements IMemoryBackend interface) // ============================================================================ class JsonFileBackend { constructor(filePath) { this.filePath = filePath; this.entries = new Map(); } async initialize() { if (existsSync(this.filePath)) { try { const data = JSON.parse(readFileSync(this.filePath, 'utf-8')); if (Array.isArray(data)) { for (const entry of data) this.entries.set(entry.id, entry); } } catch { /* start fresh */ } } } async shutdown() { this._persist(); } async store(entry) { this.entries.set(entry.id, entry); this._persist(); } async get(id) { return this.entries.get(id) ?? null; } async getByKey(key, ns) { for (const e of this.entries.values()) { if (e.key === key && (!ns || e.namespace === ns)) return e; } return null; } async update(id, updates) { const e = this.entries.get(id); if (!e) return null; if (updates.metadata) Object.assign(e.metadata, updates.metadata); if (updates.content !== undefined) e.content = updates.content; if (updates.tags) e.tags = updates.tags; e.updatedAt = Date.now(); this._persist(); return e; } async delete(id) { return this.entries.delete(id); } async query(opts) { let results = [...this.entries.values()]; if (opts?.namespace) results = results.filter(e => e.namespace === opts.namespace); if (opts?.type) results = results.filter(e => e.type === opts.type); if (opts?.limit) results = results.slice(0, opts.limit); return results; } async search() { return []; } // No vector search in JSON backend async bulkInsert(entries) { for (const e of entries) this.entries.set(e.id, e); this._persist(); } async bulkDelete(ids) { let n = 0; for (const id of ids) { if (this.entries.delete(id)) n++; } this._persist(); return n; } async count() { return this.entries.size; } async listNamespaces() { const ns = new Set(); for (const e of this.entries.values()) ns.add(e.namespace || 'default'); return [...ns]; } async clearNamespace(ns) { let n = 0; for (const [id, e] of this.entries) { if (e.namespace === ns) { this.entries.delete(id); n++; } } this._persist(); return n; } async getStats() { return { totalEntries: this.entries.size, entriesByNamespace: {}, entriesByType: { semantic: 0, episodic: 0, procedural: 0, working: 0, cache: 0 }, memoryUsage: 0, avgQueryTime: 0, avgSearchTime: 0, }; } async healthCheck() { return { status: 'healthy', components: { storage: { status: 'healthy', latency: 0 }, index: { status: 'healthy', latency: 0 }, cache: { status: 'healthy', latency: 0 }, }, timestamp: Date.now(), issues: [], recommendations: [], }; } _persist() { try { writeFileSync(this.filePath, JSON.stringify([...this.entries.values()], null, 2), 'utf-8'); } catch { /* best effort */ } } } // ============================================================================ // Resolve memory package path (local dev or npm installed) // ============================================================================ async function loadMemoryPackage() { // Strategy 1: Local dev (built dist) const localDist = join(PROJECT_ROOT, 'v3/@claude-flow/memory/dist/index.js'); if (existsSync(localDist)) { try { return await import(`file://${localDist}`); } catch { /* fall through */ } } // Strategy 2: npm installed @claude-flow/memory try { return await import('@claude-flow/memory'); } catch { /* fall through */ } // Strategy 3: Installed via @claude-flow/cli which includes memory const cliMemory = join(PROJECT_ROOT, 'node_modules/@claude-flow/memory/dist/index.js'); if (existsSync(cliMemory)) { try { return await import(`file://${cliMemory}`); } catch { /* fall through */ } } return null; } // ============================================================================ // Read config from .claude-flow/config.yaml // ============================================================================ function readConfig() { const configPath = join(PROJECT_ROOT, '.claude-flow', 'config.yaml'); const defaults = { learningBridge: { enabled: true, sonaMode: 'balanced', confidenceDecayRate: 0.005, accessBoostAmount: 0.03, consolidationThreshold: 10 }, memoryGraph: { enabled: true, pageRankDamping: 0.85, maxNodes: 5000, similarityThreshold: 0.8 }, agentScopes: { enabled: true, defaultScope: 'project' }, }; if (!existsSync(configPath)) return defaults; try { const yaml = readFileSync(configPath, 'utf-8'); // Simple YAML parser for the memory section const getBool = (key) => { const match = yaml.match(new RegExp(`${key}:\\s*(true|false)`, 'i')); return match ? match[1] === 'true' : undefined; }; const lbEnabled = getBool('learningBridge[\\s\\S]*?enabled'); if (lbEnabled !== undefined) defaults.learningBridge.enabled = lbEnabled; const mgEnabled = getBool('memoryGraph[\\s\\S]*?enabled'); if (mgEnabled !== undefined) defaults.memoryGraph.enabled = mgEnabled; const asEnabled = getBool('agentScopes[\\s\\S]*?enabled'); if (asEnabled !== undefined) defaults.agentScopes.enabled = asEnabled; return defaults; } catch { return defaults; } } // ============================================================================ // Commands // ============================================================================ async function doImport() { log('Importing auto memory files into bridge...'); const memPkg = await loadMemoryPackage(); if (!memPkg || !memPkg.AutoMemoryBridge) { dim('Memory package not available — skipping auto memory import'); return; } const config = readConfig(); const backend = new JsonFileBackend(STORE_PATH); await backend.initialize(); const bridgeConfig = { workingDir: PROJECT_ROOT, syncMode: 'on-session-end', }; // Wire learning if enabled and available if (config.learningBridge.enabled && memPkg.LearningBridge) { bridgeConfig.learning = { sonaMode: config.learningBridge.sonaMode, confidenceDecayRate: config.learningBridge.confidenceDecayRate, accessBoostAmount: config.learningBridge.accessBoostAmount, consolidationThreshold: config.learningBridge.consolidationThreshold, }; } // Wire graph if enabled and available if (config.memoryGraph.enabled && memPkg.MemoryGraph) { bridgeConfig.graph = { pageRankDamping: config.memoryGraph.pageRankDamping, maxNodes: config.memoryGraph.maxNodes, similarityThreshold: config.memoryGraph.similarityThreshold, }; } const bridge = new memPkg.AutoMemoryBridge(backend, bridgeConfig); try { const result = await bridge.importFromAutoMemory(); success(`Imported ${result.imported} entries (${result.skipped} skipped)`); dim(`├─ Backend entries: ${await backend.count()}`); dim(`├─ Learning: ${config.learningBridge.enabled ? 'active' : 'disabled'}`); dim(`├─ Graph: ${config.memoryGraph.enabled ? 'active' : 'disabled'}`); dim(`└─ Agent scopes: ${config.agentScopes.enabled ? 'active' : 'disabled'}`); } catch (err) { dim(`Import failed (non-critical): ${err.message}`); } await backend.shutdown(); } async function doSync() { log('Syncing insights to auto memory files...'); const memPkg = await loadMemoryPackage(); if (!memPkg || !memPkg.AutoMemoryBridge) { dim('Memory package not available — skipping sync'); return; } const config = readConfig(); const backend = new JsonFileBackend(STORE_PATH); await backend.initialize(); const entryCount = await backend.count(); if (entryCount === 0) { dim('No entries to sync'); await backend.shutdown(); return; } const bridgeConfig = { workingDir: PROJECT_ROOT, syncMode: 'on-session-end', }; if (config.learningBridge.enabled && memPkg.LearningBridge) { bridgeConfig.learning = { sonaMode: config.learningBridge.sonaMode, confidenceDecayRate: config.learningBridge.confidenceDecayRate, consolidationThreshold: config.learningBridge.consolidationThreshold, }; } if (config.memoryGraph.enabled && memPkg.MemoryGraph) { bridgeConfig.graph = { pageRankDamping: config.memoryGraph.pageRankDamping, maxNodes: config.memoryGraph.maxNodes, }; } const bridge = new memPkg.AutoMemoryBridge(backend, bridgeConfig); try { const syncResult = await bridge.syncToAutoMemory(); success(`Synced ${syncResult.synced} entries to auto memory`); dim(`├─ Categories updated: ${syncResult.categories?.join(', ') || 'none'}`); dim(`└─ Backend entries: ${entryCount}`); // Curate MEMORY.md index with graph-aware ordering await bridge.curateIndex(); success('Curated MEMORY.md index'); } catch (err) { dim(`Sync failed (non-critical): ${err.message}`); } if (bridge.destroy) bridge.destroy(); await backend.shutdown(); } async function doStatus() { const memPkg = await loadMemoryPackage(); const config = readConfig(); console.log('\n=== Auto Memory Bridge Status ===\n'); console.log(` Package: ${memPkg ? '✅ Available' : '❌ Not found'}`); console.log(` Store: ${existsSync(STORE_PATH) ? '✅ ' + STORE_PATH : '⏸ Not initialized'}`); console.log(` LearningBridge: ${config.learningBridge.enabled ? '✅ Enabled' : '⏸ Disabled'}`); console.log(` MemoryGraph: ${config.memoryGraph.enabled ? '✅ Enabled' : '⏸ Disabled'}`); console.log(` AgentScopes: ${config.agentScopes.enabled ? '✅ Enabled' : '⏸ Disabled'}`); if (existsSync(STORE_PATH)) { try { const data = JSON.parse(readFileSync(STORE_PATH, 'utf-8')); console.log(` Entries: ${Array.isArray(data) ? data.length : 0}`); } catch { /* ignore */ } } console.log(''); } // ============================================================================ // Main // ============================================================================ const command = process.argv[2] || 'status'; try { switch (command) { case 'import': await doImport(); break; case 'sync': await doSync(); break; case 'status': await doStatus(); break; default: console.log('Usage: auto-memory-hook.mjs '); process.exit(1); } } catch (err) { // Hooks must never crash Claude Code - fail silently dim(`Error (non-critical): ${err.message}`); }