moflo 4.0.2 → 4.0.3

package/package.json

@@ -1,110 +1,114 @@
-{
-  "name": "moflo",
-  "version": "4.0.2",
-  "description": "MoFlo — AI agent orchestration for Claude Code. Forked from ruflo/claude-flow with patches applied to source, plus feature-level orchestration.",
-  "main": "dist/index.js",
-  "type": "module",
-  "bin": {
-    "moflo": "./bin/cli.js",
-    "moflo-setup": "./bin/setup-project.mjs",
-    "claude-flow": "./bin/cli.js"
-  },
-  "homepage": "https://github.com/eric-cielo/moflo#readme",
-  "bugs": {
-    "url": "https://github.com/eric-cielo/moflo/issues"
-  },
-  "files": [
-    "bin/**",
-    "v3/@claude-flow/cli/bin/**",
-    "v3/@claude-flow/cli/dist/**/*.js",
-    "v3/@claude-flow/cli/dist/**/*.d.ts",
-    "!v3/@claude-flow/cli/dist/**/*.map",
-    "v3/@claude-flow/cli/package.json",
-    "v3/@claude-flow/shared/dist/**/*.js",
-    "v3/@claude-flow/shared/dist/**/*.d.ts",
-    "!v3/@claude-flow/shared/dist/**/*.map",
-    "v3/@claude-flow/shared/package.json",
-    "v3/@claude-flow/guidance/dist/**/*.js",
-    "v3/@claude-flow/guidance/dist/**/*.d.ts",
-    "!v3/@claude-flow/guidance/dist/**/*.map",
-    "v3/@claude-flow/guidance/package.json",
-    ".claude-plugin/**",
-    ".claude/**",
-    "!.claude/**/*.db",
-    "!.claude/**/*.map",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "dev": "tsx watch src/index.ts",
-    "build": "tsc",
-    "build:ts": "cd v3/@claude-flow/cli && npm run build || true",
-    "test": "vitest",
-    "test:ui": "vitest --ui",
-    "test:security": "vitest run v3/__tests__/security/",
-    "lint": "cd v3/@claude-flow/cli && npm run lint || true",
-    "security:audit": "npm audit --audit-level high",
-    "security:fix": "npm audit fix",
-    "security:test": "npm run test:security",
-    "v3:domains": "npm run build:domains",
-    "v3:swarm": "npm run start:swarm",
-    "v3:security": "npm run security:audit && npm run security:test"
-  },
-  "dependencies": {
-    "semver": "^7.6.0",
-    "zod": "^3.22.4"
-  },
-  "optionalDependencies": {
-    "@claude-flow/codex": "^3.0.0-alpha.8",
-    "@claude-flow/plugin-gastown-bridge": "^0.1.3",
-    "@ruvector/attention": "^0.1.3",
-    "@ruvector/core": "^0.1.30",
-    "@ruvector/router": "^0.1.27",
-    "@ruvector/router-linux-x64-gnu": "^0.1.27",
-    "@ruvector/sona": "^0.1.5",
-    "agentdb": "^3.0.0-alpha.9",
-    "agentic-flow": "^2.0.7"
-  },
-  "overrides": {
-    "hono": ">=4.11.4"
-  },
-  "devDependencies": {
-    "@openai/codex": "^0.98.0",
-    "@types/bcrypt": "^5.0.2",
-    "@types/node": "^20.0.0",
-    "eslint": "^8.0.0",
-    "tsx": "^4.21.0",
-    "typescript": "^5.0.0",
-    "vitest": "^1.0.0"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/eric-cielo/moflo.git"
-  },
-  "keywords": [
-    "moflo",
-    "claude",
-    "claude-code",
-    "anthropic",
-    "ai-agents",
-    "agent-orchestration",
-    "mcp",
-    "model-context-protocol",
-    "cli",
-    "developer-tools",
-    "workflow",
-    "orchestration"
-  ],
-  "author": {
-    "name": "Eric Cielo",
-    "url": "https://github.com/eric-cielo"
-  },
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public",
-    "tag": "latest"
-  }
-}
+{
+  "name": "moflo",
+  "version": "4.0.3",
+  "description": "MoFlo — AI agent orchestration for Claude Code. Forked from ruflo/claude-flow with patches applied to source, plus feature-level orchestration.",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "moflo": "bin/cli.js",
+    "moflo-setup": "bin/setup-project.mjs",
+    "claude-flow": "bin/cli.js"
+  },
+  "homepage": "https://github.com/eric-cielo/moflo#readme",
+  "bugs": {
+    "url": "https://github.com/eric-cielo/moflo/issues"
+  },
+  "files": [
+    "bin/**",
+    "v3/@claude-flow/cli/bin/**",
+    "v3/@claude-flow/cli/dist/**/*.js",
+    "v3/@claude-flow/cli/dist/**/*.d.ts",
+    "!v3/@claude-flow/cli/dist/**/*.map",
+    "v3/@claude-flow/cli/package.json",
+    "v3/@claude-flow/shared/dist/**/*.js",
+    "v3/@claude-flow/shared/dist/**/*.d.ts",
+    "!v3/@claude-flow/shared/dist/**/*.map",
+    "v3/@claude-flow/shared/package.json",
+    "v3/@claude-flow/guidance/dist/**/*.js",
+    "v3/@claude-flow/guidance/dist/**/*.d.ts",
+    "!v3/@claude-flow/guidance/dist/**/*.map",
+    "v3/@claude-flow/guidance/package.json",
+    "v3/@claude-flow/memory/dist/**/*.js",
+    "v3/@claude-flow/memory/dist/**/*.d.ts",
+    "!v3/@claude-flow/memory/dist/**/*.map",
+    "v3/@claude-flow/memory/package.json",
+    ".claude-plugin/**",
+    ".claude/**",
+    "!.claude/**/*.db",
+    "!.claude/**/*.map",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "build:ts": "cd v3/@claude-flow/cli && npm run build || true",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:security": "vitest run v3/__tests__/security/",
+    "lint": "cd v3/@claude-flow/cli && npm run lint || true",
+    "security:audit": "npm audit --audit-level high",
+    "security:fix": "npm audit fix",
+    "security:test": "npm run test:security",
+    "v3:domains": "npm run build:domains",
+    "v3:swarm": "npm run start:swarm",
+    "v3:security": "npm run security:audit && npm run security:test"
+  },
+  "dependencies": {
+    "semver": "^7.6.0",
+    "zod": "^3.22.4"
+  },
+  "optionalDependencies": {
+    "@claude-flow/codex": "^3.0.0-alpha.8",
+    "@claude-flow/plugin-gastown-bridge": "^0.1.3",
+    "@ruvector/attention": "^0.1.3",
+    "@ruvector/core": "^0.1.30",
+    "@ruvector/router": "^0.1.27",
+    "@ruvector/router-linux-x64-gnu": "^0.1.27",
+    "@ruvector/sona": "^0.1.5",
+    "agentdb": "^3.0.0-alpha.9",
+    "agentic-flow": "^2.0.7"
+  },
+  "overrides": {
+    "hono": ">=4.11.4"
+  },
+  "devDependencies": {
+    "@openai/codex": "^0.98.0",
+    "@types/bcrypt": "^5.0.2",
+    "@types/node": "^20.0.0",
+    "eslint": "^8.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eric-cielo/moflo.git"
+  },
+  "keywords": [
+    "moflo",
+    "claude",
+    "claude-code",
+    "anthropic",
+    "ai-agents",
+    "agent-orchestration",
+    "mcp",
+    "model-context-protocol",
+    "cli",
+    "developer-tools",
+    "workflow",
+    "orchestration"
+  ],
+  "author": {
+    "name": "Eric Cielo",
+    "url": "https://github.com/eric-cielo"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  }
+}

package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js

@@ -17,7 +17,35 @@
  * @module v3/cli/memory-bridge
  */
 import * as path from 'path';
+import * as fs from 'fs';
 import * as crypto from 'crypto';
+import { createRequire } from 'module';
+import { pathToFileURL } from 'url';
+// Project root resolution — handles npx running from node_modules/moflo
+let _projectRoot;
+function getProjectRoot() {
+    if (_projectRoot)
+        return _projectRoot;
+    if (process.env.CLAUDE_PROJECT_DIR) {
+        _projectRoot = process.env.CLAUDE_PROJECT_DIR;
+        return _projectRoot;
+    }
+    let dir = process.cwd();
+    const root = path.parse(dir).root;
+    while (dir !== root) {
+        if (fs.existsSync(path.join(dir, '.swarm', 'memory.db'))) {
+            _projectRoot = dir;
+            return _projectRoot;
+        }
+        if (fs.existsSync(path.join(dir, 'CLAUDE.md')) && fs.existsSync(path.join(dir, 'package.json'))) {
+            _projectRoot = dir;
+            return _projectRoot;
+        }
+        dir = path.dirname(dir);
+    }
+    _projectRoot = process.cwd();
+    return _projectRoot;
+}
 // ===== Lazy singleton =====
 let registryPromise = null;
 let registryInstance = null;
@@ -28,15 +56,15 @@ let bridgeAvailable = null;
  * or the special ':memory:' path.
  */
 function getDbPath(customPath) {
-    const swarmDir = path.resolve(process.cwd(), '.swarm');
+    const projectRoot = getProjectRoot();
+    const swarmDir = path.resolve(projectRoot, '.swarm');
     if (!customPath)
         return path.join(swarmDir, 'memory.db');
     if (customPath === ':memory:')
         return ':memory:';
     const resolved = path.resolve(customPath);
-    // Ensure the path doesn't escape the working directory
-    const cwd = process.cwd();
-    if (!resolved.startsWith(cwd)) {
+    // Ensure the path doesn't escape the project directory
+    if (!resolved.startsWith(projectRoot)) {
         return path.join(swarmDir, 'memory.db'); // fallback to safe default
     }
     return resolved;
@@ -48,8 +76,10 @@ function generateId(prefix) {
     return `${prefix}_${Date.now()}_${crypto.randomBytes(8).toString('hex')}`;
 }
 /**
- * Lazily initialize the ControllerRegistry singleton.
- * Returns null if @claude-flow/memory is not available.
+ * Lazily initialize the ControllerRegistry singleton via @claude-flow/memory.
+ * Falls back to direct agentdb import if @claude-flow/memory is unavailable.
+ * The registry exposes .get(name), .getAgentDB(), .listControllers(), and .initialize()
+ * to maintain compatibility with all bridge consumers.
  */
 async function getRegistry(dbPath) {
     if (bridgeAvailable === false)
@@ -59,8 +89,75 @@ async function getRegistry(dbPath) {
     if (!registryPromise) {
         registryPromise = (async () => {
             try {
-                const { ControllerRegistry } = await import('@claude-flow/memory');
-                const registry = new ControllerRegistry();
+                // Try @claude-flow/memory ControllerRegistry first (bundled in moflo)
+                let memoryModule = null;
+                const memoryRelPath = '../../../../memory/dist/index.js';
+                try {
+                    memoryModule = await import(memoryRelPath);
+                }
+                catch {
+                    try {
+                        const req = createRequire(path.join(getProjectRoot(), 'package.json'));
+                        const resolved = req.resolve('@claude-flow/memory');
+                        memoryModule = await import(pathToFileURL(resolved).href);
+                    }
+                    catch {
+                        // @claude-flow/memory not available
+                    }
+                }
+                // If @claude-flow/memory has ControllerRegistry, use it directly
+                if (memoryModule?.ControllerRegistry) {
+                    const { ControllerRegistry } = memoryModule;
+                    const registry = new ControllerRegistry();
+                    // Suppress noisy console.log during init
+                    const origLog = console.log;
+                    console.log = (...args) => {
+                        const msg = String(args[0] ?? '');
+                        if (msg.includes('Transformers.js') ||
+                            msg.includes('better-sqlite3') ||
+                            msg.includes('[AgentDB]') ||
+                            msg.includes('[HNSWLibBackend]') ||
+                            msg.includes('RuVector graph'))
+                            return;
+                        origLog.apply(console, args);
+                    };
+                    try {
+                        await registry.initialize({
+                            dbPath: dbPath || getDbPath(),
+                            dimension: 384,
+                        });
+                    }
+                    finally {
+                        console.log = origLog;
+                    }
+                    registryInstance = registry;
+                    return registry;
+                }
+                // Fallback: direct agentdb import with manual adapter
+                let agentdbModule = null;
+                try {
+                    agentdbModule = await import('agentdb');
+                }
+                catch {
+                    try {
+                        const req = createRequire(path.join(getProjectRoot(), 'package.json'));
+                        const resolved = req.resolve('agentdb');
+                        agentdbModule = await import(pathToFileURL(resolved).href);
+                    }
+                    catch {
+                        // Not available
+                    }
+                }
+                if (!agentdbModule) {
+                    bridgeAvailable = false;
+                    registryPromise = null;
+                    return null;
+                }
+                const { AgentDB } = agentdbModule;
+                const agentdb = new AgentDB({
+                    dbPath: dbPath || getDbPath(),
+                    dimension: 384,
+                });
                 // Suppress noisy console.log during init
                 const origLog = console.log;
                 console.log = (...args) => {
@@ -74,22 +171,38 @@ async function getRegistry(dbPath) {
                     origLog.apply(console, args);
                 };
                 try {
-                    await registry.initialize({
-                        dbPath: dbPath || getDbPath(),
-                        dimension: 384,
-                        controllers: {
-                            reasoningBank: true,
-                            learningBridge: false,
-                            tieredCache: true,
-                            hierarchicalMemory: true,
-                            memoryConsolidation: true,
-                            memoryGraph: true, // issue #1214: enable MemoryGraph for graph-aware ranking
-                        },
-                    });
+                    await agentdb.initialize();
                 }
                 finally {
                     console.log = origLog;
                 }
+                // Build a registry-compatible adapter over AgentDB
+                const registry = {
+                    _agentdb: agentdb,
+                    get(name) {
+                        try {
+                            return agentdb.getController(name);
+                        }
+                        catch {
+                            return null;
+                        }
+                    },
+                    getAgentDB() {
+                        return agentdb;
+                    },
+                    listControllers() {
+                        return [
+                            'reflexion', 'skills', 'reasoningBank',
+                            'causalGraph', 'causalRecall', 'learningSystem',
+                            'explainableRecall', 'nightlyLearner',
+                            'graphTransformer', 'mutationGuard',
+                            'attestationLog', 'vectorBackend'
+                        ].filter(name => {
+                            try { return agentdb.getController(name) != null; }
+                            catch { return false; }
+                        });
+                    },
+                };
                 registryInstance = registry;
                 bridgeAvailable = true;
                 return registry;
@@ -239,25 +352,25 @@ function getDb(registry) {
     const db = agentdb.database;
     // Ensure memory_entries table exists (idempotent)
     try {
-        db.exec(`CREATE TABLE IF NOT EXISTS memory_entries (
-      id TEXT PRIMARY KEY,
-      key TEXT NOT NULL,
-      namespace TEXT DEFAULT 'default',
-      content TEXT NOT NULL,
-      type TEXT DEFAULT 'semantic',
-      embedding TEXT,
-      embedding_model TEXT DEFAULT 'local',
-      embedding_dimensions INTEGER,
-      tags TEXT,
-      metadata TEXT,
-      owner_id TEXT,
-      created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),
-      updated_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),
-      expires_at INTEGER,
-      last_accessed_at INTEGER,
-      access_count INTEGER DEFAULT 0,
-      status TEXT DEFAULT 'active',
-      UNIQUE(namespace, key)
+        db.exec(`CREATE TABLE IF NOT EXISTS memory_entries (
+      id TEXT PRIMARY KEY,
+      key TEXT NOT NULL,
+      namespace TEXT DEFAULT 'default',
+      content TEXT NOT NULL,
+      type TEXT DEFAULT 'semantic',
+      embedding TEXT,
+      embedding_model TEXT DEFAULT 'local',
+      embedding_dimensions INTEGER,
+      tags TEXT,
+      metadata TEXT,
+      owner_id TEXT,
+      created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),
+      updated_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),
+      expires_at INTEGER,
+      last_accessed_at INTEGER,
+      access_count INTEGER DEFAULT 0,
+      status TEXT DEFAULT 'active',
+      UNIQUE(namespace, key)
     )`);
         // Ensure indexes
         db.exec(`CREATE INDEX IF NOT EXISTS idx_bridge_ns ON memory_entries(namespace)`);
@@ -313,15 +426,15 @@ export async function bridgeStoreEntry(options) {
         }
         // better-sqlite3 uses synchronous .run() with positional params
         const insertSql = options.upsert
-            ? `INSERT OR REPLACE INTO memory_entries (
-          id, key, namespace, content, type,
-          embedding, embedding_dimensions, embedding_model,
-          tags, metadata, created_at, updated_at, expires_at, status
+            ? `INSERT OR REPLACE INTO memory_entries (
+          id, key, namespace, content, type,
+          embedding, embedding_dimensions, embedding_model,
+          tags, metadata, created_at, updated_at, expires_at, status
         ) VALUES (?, ?, ?, ?, 'semantic', ?, ?, ?, ?, ?, ?, ?, ?, 'active')`
-            : `INSERT INTO memory_entries (
-          id, key, namespace, content, type,
-          embedding, embedding_dimensions, embedding_model,
-          tags, metadata, created_at, updated_at, expires_at, status
+            : `INSERT INTO memory_entries (
+          id, key, namespace, content, type,
+          embedding, embedding_dimensions, embedding_model,
+          tags, metadata, created_at, updated_at, expires_at, status
         ) VALUES (?, ?, ?, ?, 'semantic', ?, ?, ?, ?, ?, ?, ?, ?, 'active')`;
         const stmt = ctx.db.prepare(insertSql);
         stmt.run(id, key, namespace, value, embeddingJson, dimensions || null, model, tags.length > 0 ? JSON.stringify(tags) : null, '{}', now, now, ttl ? now + (ttl * 1000) : null);
@@ -378,11 +491,11 @@ export async function bridgeSearchEntries(options) {
             : '';
         let rows;
         try {
-            const stmt = ctx.db.prepare(`
-        SELECT id, key, namespace, content, embedding
-        FROM memory_entries
-        WHERE status = 'active' ${nsFilter}
-        LIMIT 1000
+            const stmt = ctx.db.prepare(`
+        SELECT id, key, namespace, content, embedding
+        FROM memory_entries
+        WHERE status = 'active' ${nsFilter}
+        LIMIT 1000
       `);
             rows = namespace !== 'all' ? stmt.all(namespace) : stmt.all();
         }
@@ -472,12 +585,12 @@ export async function bridgeListEntries(options) {
         // List
         const entries = [];
         try {
-            const stmt = ctx.db.prepare(`
-        SELECT id, key, namespace, content, embedding, access_count, created_at, updated_at
-        FROM memory_entries
-        WHERE status = 'active' ${nsFilter}
-        ORDER BY updated_at DESC
-        LIMIT ? OFFSET ?
+            const stmt = ctx.db.prepare(`
+        SELECT id, key, namespace, content, embedding, access_count, created_at, updated_at
+        FROM memory_entries
+        WHERE status = 'active' ${nsFilter}
+        ORDER BY updated_at DESC
+        LIMIT ? OFFSET ?
       `);
             const rows = stmt.all(...nsParams, limit, offset);
             for (const row of rows) {
@@ -540,11 +653,11 @@ export async function bridgeGetEntry(options) {
         }
         let row;
         try {
-            const stmt = ctx.db.prepare(`
-        SELECT id, key, namespace, content, embedding, access_count, created_at, updated_at, tags
-        FROM memory_entries
-        WHERE status = 'active' AND key = ? AND namespace = ?
-        LIMIT 1
+            const stmt = ctx.db.prepare(`
+        SELECT id, key, namespace, content, embedding, access_count, created_at, updated_at, tags
+        FROM memory_entries
+        WHERE status = 'active' AND key = ? AND namespace = ?
+        LIMIT 1
       `);
             row = stmt.get(key, namespace);
         }
@@ -608,10 +721,10 @@ export async function bridgeDeleteEntry(options) {
         // Soft delete using parameterized query
         let changes = 0;
         try {
-            const result = ctx.db.prepare(`
-        UPDATE memory_entries
-        SET status = 'deleted', updated_at = ?
-        WHERE key = ? AND namespace = ? AND status = 'active'
+            const result = ctx.db.prepare(`
+        UPDATE memory_entries
+        SET status = 'deleted', updated_at = ?
+        WHERE key = ? AND namespace = ? AND status = 'active'
       `).run(Date.now(), key, namespace);
             changes = result?.changes ?? 0;
         }
@@ -756,11 +869,11 @@ export async function bridgeSearchHNSW(queryEmbedding, options, dbPath) {
             : '';
         let rows;
         try {
-            const stmt = ctx.db.prepare(`
-        SELECT id, key, namespace, content, embedding
-        FROM memory_entries
-        WHERE status = 'active' AND embedding IS NOT NULL ${nsFilter}
-        LIMIT 10000
+            const stmt = ctx.db.prepare(`
+        SELECT id, key, namespace, content, embedding
+        FROM memory_entries
+        WHERE status = 'active' AND embedding IS NOT NULL ${nsFilter}
+        LIMIT 10000
       `);
             rows = nsFilter
                 ? stmt.all(options.namespace)
@@ -812,12 +925,12 @@ export async function bridgeAddToHNSW(id, embedding, entry, dbPath) {
     try {
         const now = Date.now();
         const embeddingJson = JSON.stringify(embedding);
-        ctx.db.prepare(`
-      INSERT OR REPLACE INTO memory_entries (
-        id, key, namespace, content, type,
-        embedding, embedding_dimensions, embedding_model,
-        created_at, updated_at, status
-      ) VALUES (?, ?, ?, ?, 'semantic', ?, ?, 'Xenova/all-MiniLM-L6-v2', ?, ?, 'active')
+        ctx.db.prepare(`
+      INSERT OR REPLACE INTO memory_entries (
+        id, key, namespace, content, type,
+        embedding, embedding_dimensions, embedding_model,
+        created_at, updated_at, status
+      ) VALUES (?, ?, ?, ?, 'semantic', ?, ?, 'Xenova/all-MiniLM-L6-v2', ?, ?, 'active')
     `).run(id, entry.key, entry.namespace, entry.content, embeddingJson, embedding.length, now, now);
         return true;
     }
@@ -1085,9 +1198,9 @@ export async function bridgeRecordCausalEdge(options) {
         const ctx = getDb(registry);
         if (ctx) {
             try {
-                ctx.db.prepare(`
-          INSERT OR REPLACE INTO memory_entries (id, key, namespace, content, type, created_at, updated_at, status)
-          VALUES (?, ?, 'causal-edges', ?, 'procedural', ?, ?, 'active')
+                ctx.db.prepare(`
+          INSERT OR REPLACE INTO memory_entries (id, key, namespace, content, type, created_at, updated_at, status)
+          VALUES (?, ?, 'causal-edges', ?, 'procedural', ?, ?, 'active')
         `).run(generateId('edge'), `${options.sourceId}→${options.targetId}`, JSON.stringify(options), Date.now(), Date.now());
                 return { success: true, controller: 'bridge-fallback' };
             }