π The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
Checkpoint: File edits
rUv26acfb8bd6f5
diff --git a/.claude/helpers/auto-memory-hook.mjs b/.claude/helpers/auto-memory-hook.mjsnew file mode 100644index 0000000000..6a42157b1f--- /dev/null+++ b/.claude/helpers/auto-memory-hook.mjs@@ -0,0 +1,350 @@+#!/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.written} entries to auto memory`);+ dim(`ββ Topic files updated: ${syncResult.topicFilesUpdated ?? 0}`);+ 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 <import|sync|status>');+ process.exit(1);+ }+} catch (err) {+ // Hooks must never crash Claude Code - fail silently+ dim(`Error (non-critical): ${err.message}`);+}diff --git a/agents/architect.yaml b/agents/architect.yamlindex e7be30bdac..cd2577702f 100644--- a/agents/architect.yaml+++ b/agents/architect.yaml@@ -8,4 +8,4 @@ capabilities:optimizations:- context-caching- memory-persistence-createdAt: "2026-02-08T17:04:43.423Z"+createdAt: "2026-02-08T17:12:36.017Z"diff --git a/agents/coder.yaml b/agents/coder.yamlindex 24535cb177..1e2908793a 100644--- a/agents/coder.yaml+++ b/agents/coder.yaml@@ -8,4 +8,4 @@ capabilities:optimizations:- flash-attention- token-reduction-createdAt: "2026-02-08T17:04:43.423Z"+createdAt: "2026-02-08T17:12:36.017Z"diff --git a/agents/reviewer.yaml b/agents/reviewer.yamlindex 534dbfcac9..7cae493ea6 100644--- a/agents/reviewer.yaml+++ b/agents/reviewer.yaml@@ -7,4 +7,4 @@ capabilities:- best-practicesoptimizations:- incremental-analysis-createdAt: "2026-02-08T17:04:43.423Z"+createdAt: "2026-02-08T17:12:36.018Z"diff --git a/agents/security-architect.yaml b/agents/security-architect.yamlindex 2bd2181280..8a148b7e4e 100644--- a/agents/security-architect.yaml+++ b/agents/security-architect.yaml@@ -7,4 +7,4 @@ capabilities:- security-reviewoptimizations:- pattern-matching-createdAt: "2026-02-08T17:04:43.423Z"+createdAt: "2026-02-08T17:12:36.018Z"diff --git a/agents/tester.yaml b/agents/tester.yamlindex cd74f1055b..b18a575762 100644--- a/agents/tester.yaml+++ b/agents/tester.yaml@@ -7,4 +7,4 @@ capabilities:- coverageoptimizations:- parallel-execution-createdAt: "2026-02-08T17:04:43.423Z"+createdAt: "2026-02-08T17:12:36.017Z"