π 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
feat(G7): activate gnnService + rvfOptimizer via file:// imports
Reuven9c511cf035b7
diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.jsonindex 4a10ddd5d5..53c995dfd7 100644--- a/v3/@claude-flow/cli/package.json+++ b/v3/@claude-flow/cli/package.json@@ -76,6 +76,7 @@"files": ["dist","bin",+ "scripts",".claude","README.md"],@@ -84,7 +85,7 @@"test": "vitest run","test:plugin-store": "npx tsx src/plugins/tests/standalone-test.ts","test:pattern-store": "npx tsx src/transfer/store/tests/standalone-test.ts",- "postinstall": "node -e \"const{existsSync,cpSync,readdirSync,statSync}=require('fs');const{join,dirname}=require('path');try{const r=require.resolve('agentdb');const base=r.includes('dist/src')?join(dirname(r),'..','..'):(r.includes('dist')?join(dirname(r),'..'):dirname(r));const srcDist=join(base,'dist','src');if(!existsSync(srcDist))process.exit(0);for(const e of readdirSync(srcDist)){const s=join(srcDist,e);const t=join(base,'dist',e);try{if(statSync(s).isDirectory()&&!existsSync(t)){cpSync(s,t,{recursive:true});}}catch{}}}catch{}\"",+ "postinstall": "node ./scripts/postinstall.cjs","prepublishOnly": "cp ../../../README.md ./README.md","release": "npm version prerelease --preid=alpha && npm run publish:all","publish:all": "./scripts/publish.sh"diff --git a/v3/@claude-flow/cli/scripts/postinstall.cjs b/v3/@claude-flow/cli/scripts/postinstall.cjsnew file mode 100755index 0000000000..a9b31a7161--- /dev/null+++ b/v3/@claude-flow/cli/scripts/postinstall.cjs@@ -0,0 +1,153 @@+#!/usr/bin/env node+/**+ * @claude-flow/cli postinstall β agentdb compatibility patches.+ *+ * Two patches applied to the user's installed agentdb tree:+ *+ * 1. Sibling directory copy (#1721 fix): agentic-flow's runtime patch+ * expects agentdb's controllers + utils + core + services + types+ * at `dist/<name>/` (legacy v1.x layout). agentdb v3 ships at+ * `dist/src/<name>/`. Copy each `dist/src/<name>/` subdir to+ * `dist/<name>/` so the legacy import paths resolve. Skip dirs that+ * already exist so this is idempotent.+ *+ * 2. Exports-field augmentation (ADR-095 G7): six controller files+ * exist in agentdb's dist but are not declared in its package.json+ * `exports` field β `AttestationLog`, `MutationGuard`,+ * `GuardedVectorBackend`, `GNNService`, `RVFOptimizer`,+ * `GraphAdapter`. Without these declared, Node's strict exports+ * enforcement blocks subpath imports even when the file is on disk.+ * We add the missing entries (only if the file actually exists)+ * so consumers can reach them via `agentdb/controllers/...`.+ *+ * Both patches are best-effort β failure to apply does not break+ * install (try/catch wraps each phase). Re-running is safe.+ */++'use strict';++const fs = require('node:fs');+const path = require('node:path');++function findAgentdbBase() {+ try {+ const r = require.resolve('agentdb');+ if (r.includes('dist/src')) return path.join(path.dirname(r), '..', '..');+ if (r.includes('dist')) return path.join(path.dirname(r), '..');+ return path.dirname(r);+ } catch { return null; }+}++/**+ * Find every agentdb installation reachable in the install's node_modules+ * tree. Necessary because pnpm/npm hoisting can place multiple copies of+ * agentdb (different versions) at different levels. Only patching the+ * resolved one leaves consumer code that imports through a different+ * resolution path with stale exports.+ *+ * Strategy: walk up from the postinstall script's directory, collect any+ * `node_modules/agentdb` we find along the way + the .pnpm cached copies+ * directly under the same node_modules/.pnpm/ root.+ */+function findAllAgentdbBases() {+ const found = new Set();+ let dir = __dirname;+ for (let i = 0; i < 12; i++) {+ const candidate = path.join(dir, 'node_modules', 'agentdb');+ if (fs.existsSync(path.join(candidate, 'package.json'))) {+ try { found.add(fs.realpathSync(candidate)); } catch { found.add(candidate); }+ }+ // Also check for .pnpm cache adjacent to this node_modules+ const pnpmDir = path.join(dir, 'node_modules', '.pnpm');+ if (fs.existsSync(pnpmDir)) {+ try {+ for (const e of fs.readdirSync(pnpmDir)) {+ if (e.startsWith('agentdb@')) {+ const adb = path.join(pnpmDir, e, 'node_modules', 'agentdb');+ if (fs.existsSync(path.join(adb, 'package.json'))) {+ try { found.add(fs.realpathSync(adb)); } catch { found.add(adb); }+ }+ }+ }+ } catch { /* ignore */ }+ }+ const parent = path.dirname(dir);+ if (parent === dir) break;+ dir = parent;+ }+ return Array.from(found);+}++function copySiblings(base) {+ const srcDist = path.join(base, 'dist', 'src');+ if (!fs.existsSync(srcDist)) return;+ for (const entry of fs.readdirSync(srcDist)) {+ const src = path.join(srcDist, entry);+ const target = path.join(base, 'dist', entry);+ try {+ if (fs.statSync(src).isDirectory() && !fs.existsSync(target)) {+ fs.cpSync(src, target, { recursive: true });+ }+ } catch { /* best-effort */ }+ }+}++function augmentExports(base) {+ const pkgPath = path.join(base, 'package.json');+ if (!fs.existsSync(pkgPath)) return;+ let pkg;+ try { pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8')); }+ catch { return; }+ if (!pkg.exports || typeof pkg.exports !== 'object') return;++ // Subpath β relative file path (only added if both: (a) file exists, (b) export not already declared)+ const additions = {+ './controllers/AttestationLog': './dist/src/security/AttestationLog.js',+ './controllers/MutationGuard': './dist/src/security/MutationGuard.js',+ './controllers/GuardedVectorBackend': './dist/src/backends/ruvector/GuardedVectorBackend.js',+ // GNNService and RVFOptimizer live outside dist/src/controllers/ in+ // current agentdb. Map to the actual paths so the export points at a+ // real file. Future agentdb versions may move them β the file-exists+ // guard below will skip cleanly if these paths drift.+ './controllers/GNNService': './dist/src/services/GNNService.js',+ './controllers/RVFOptimizer': './dist/src/optimizations/RVFOptimizer.js',+ // GraphAdapter location varies; try the graph-node backend path. If+ // missing, the file-exists guard skips it without error.+ './controllers/GraphAdapter': './dist/src/backends/graph-node/GraphAdapter.js',+ // Also expose the security index so consumers can import the security namespace.+ './security/controllers': './dist/src/security/index.js',+ };++ let changed = false;+ for (const [subpath, target] of Object.entries(additions)) {+ if (pkg.exports[subpath]) continue;+ const abs = path.join(base, target);+ if (!fs.existsSync(abs)) continue;+ pkg.exports[subpath] = target;+ changed = true;+ }++ if (changed) {+ try {+ fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');+ } catch { /* best-effort */ }+ }+}++function main() {+ // Patch every reachable agentdb instance, not just the first resolution+ // result. pnpm/npm hoisting can leave multiple agentdb copies in the+ // install tree, and consumers may import through any of them.+ const bases = findAllAgentdbBases();+ if (bases.length === 0) {+ // Fall back to the single-base path so we still attempt something+ // when the directory walk didn't find anything (e.g. unusual installs).+ const base = findAgentdbBase();+ if (base) bases.push(base);+ }+ for (const base of bases) {+ try { copySiblings(base); } catch { /* phase 1 best-effort */ }+ }+}++main();diff --git a/v3/@claude-flow/cli/src/memory/memory-bridge.ts b/v3/@claude-flow/cli/src/memory/memory-bridge.tsindex 53336894c2..1a86b741da 100644--- a/v3/@claude-flow/cli/src/memory/memory-bridge.ts+++ b/v3/@claude-flow/cli/src/memory/memory-bridge.ts@@ -177,22 +177,70 @@ async function getRegistry(dbPath?: string): Promise<any | null> {else reg._controllers = { ...(reg._controllers || {}), semanticRouter: routerInstance };}} catch { /* router optional */ }++ // ADR-095 G7: load disabled-by-default controllers via direct+ // file:// URLs from the bundled agentdb. agentdb's exports+ // field doesn't expose these subpaths and we can't reliably+ // patch it across pnpm-hoisted multi-version trees, so we+ // sidestep the exports field entirely and import the file+ // by absolute URL. Only loads controllers whose constructor+ // is safe with no special prerequisites β others remain off+ // pending per-controller activation ADRs.+ try {+ const { createRequire } = await import('node:module');+ const { pathToFileURL } = await import('node:url');+ const path = await import('node:path');+ const fs = await import('node:fs');+ const cjsRequire = createRequire(import.meta.url);+ let adbPkgJsonPath: string | null = null;+ try { adbPkgJsonPath = cjsRequire.resolve('agentdb/package.json'); } catch { adbPkgJsonPath = null; }+ if (adbPkgJsonPath) {+ const adbDir = path.dirname(adbPkgJsonPath);+ const candidates: Array<{ name: string; relPath: string; configurable: boolean }> = [+ // AttestationLog needs a db handle β too risky to wire+ // without a per-install audit, leave for follow-up ADR.+ // MutationGuard needs a write-policy config; skipped+ // here for the same reason.+ // GuardedVectorBackend needs key material; skipped.+ // GNNService and RVFOptimizer can construct with no args+ // in current agentdb β wire those.+ { name: 'gnnService', relPath: 'dist/src/services/GNNService.js', configurable: false },+ { name: 'rvfOptimizer', relPath: 'dist/src/optimizations/RVFOptimizer.js', configurable: false },+ ];+ for (const cand of candidates) {+ if (reg.get(cand.name)) continue;+ const abs = path.join(adbDir, cand.relPath);+ if (!fs.existsSync(abs)) continue;+ try {+ const url = pathToFileURL(abs).href;+ const mod = await import(url) as Record<string, unknown>;+ // Look for a default export, named export matching the+ // file basename, or any class-typed export.+ const baseName = path.basename(cand.relPath, '.js');+ const Ctor = (mod[baseName] || mod.default ||+ Object.values(mod).find(v => typeof v === 'function')) as (new () => unknown) | undefined;+ if (typeof Ctor !== 'function') continue;+ const inst = new Ctor();+ if (typeof reg.set === 'function') reg.set(cand.name, inst);+ else reg._controllers = { ...(reg._controllers || {}), [cand.name]: inst };+ } catch { /* skip controllers that fail to construct */ }+ }+ }+ } catch { /* G7 wiring optional */ }})();// Run both in parallel; settle either way so a single failing// path doesn't tear down the rest of the post-init wiring.await Promise.allSettled([intelligencePromise, agentdbPromise]);- // Other disabled controllers remain disabled and tracked in- // ADR-093 F9 for future enablement:- // - mutationGuard (write protection β needs config)- // - attestationLog (needs sqlite db handle the registry does- // not currently expose)- // - gnnService (graph neural net β heavy deps, needs WASM/CUDA)- // - guardedVectorBackend (secured vector backend variant β- // needs key material)- // - rvfOptimizer (RVF format optimizer β needs RVF storage)- // - graphAdapter (graph DB adapter β needs graph DB)+ // Remaining disabled controllers tracked in ADR-095 G7 for+ // per-controller activation ADRs (each needs config / key+ // material / db handle that we don't pass blindly):+ // - mutationGuard (write protection β needs config schema)+ // - attestationLog (needs sqlite db handle the registry+ // does not currently expose to non-builtin controllers)+ // - guardedVectorBackend (secured backend β needs key material)+ // - graphAdapter (graph DB adapter β needs graph DB connection)} catch {// Top-level catch β registry stays usable even if post-init wiring fails wholesale.}