moflo 4.0.4 → 4.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (422) hide show
  1. package/.claude/agents/MIGRATION_SUMMARY.md +221 -221
  2. package/.claude/agents/analysis/analyze-code-quality.md +178 -178
  3. package/.claude/agents/analysis/code-analyzer.md +209 -209
  4. package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
  6. package/.claude/agents/base-template-generator.md +42 -42
  7. package/.claude/agents/consensus/byzantine-coordinator.md +62 -62
  8. package/.claude/agents/consensus/crdt-synchronizer.md +996 -996
  9. package/.claude/agents/consensus/gossip-coordinator.md +62 -62
  10. package/.claude/agents/consensus/performance-benchmarker.md +850 -850
  11. package/.claude/agents/consensus/quorum-manager.md +822 -822
  12. package/.claude/agents/consensus/raft-manager.md +62 -62
  13. package/.claude/agents/consensus/security-manager.md +621 -621
  14. package/.claude/agents/core/coder.md +265 -265
  15. package/.claude/agents/core/planner.md +167 -167
  16. package/.claude/agents/core/researcher.md +189 -189
  17. package/.claude/agents/core/reviewer.md +325 -325
  18. package/.claude/agents/core/tester.md +318 -318
  19. package/.claude/agents/custom/test-long-runner.md +44 -44
  20. package/.claude/agents/data/ml/data-ml-model.md +192 -192
  21. package/.claude/agents/development/backend/dev-backend-api.md +141 -141
  22. package/.claude/agents/development/dev-backend-api.md +344 -344
  23. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
  24. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
  25. package/.claude/agents/dual-mode/codex-coordinator.md +224 -224
  26. package/.claude/agents/dual-mode/codex-worker.md +211 -211
  27. package/.claude/agents/dual-mode/dual-orchestrator.md +291 -291
  28. package/.claude/agents/flow-nexus/app-store.md +87 -87
  29. package/.claude/agents/flow-nexus/authentication.md +68 -68
  30. package/.claude/agents/flow-nexus/challenges.md +80 -80
  31. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  32. package/.claude/agents/flow-nexus/payments.md +82 -82
  33. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  34. package/.claude/agents/flow-nexus/swarm.md +75 -75
  35. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  36. package/.claude/agents/flow-nexus/workflow.md +83 -83
  37. package/.claude/agents/github/code-review-swarm.md +537 -537
  38. package/.claude/agents/github/github-modes.md +172 -172
  39. package/.claude/agents/github/issue-tracker.md +318 -318
  40. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  41. package/.claude/agents/github/pr-manager.md +190 -190
  42. package/.claude/agents/github/project-board-sync.md +508 -508
  43. package/.claude/agents/github/release-manager.md +366 -366
  44. package/.claude/agents/github/release-swarm.md +582 -582
  45. package/.claude/agents/github/repo-architect.md +397 -397
  46. package/.claude/agents/github/swarm-issue.md +572 -572
  47. package/.claude/agents/github/swarm-pr.md +427 -427
  48. package/.claude/agents/github/sync-coordinator.md +451 -451
  49. package/.claude/agents/github/workflow-automation.md +634 -634
  50. package/.claude/agents/goal/agent.md +815 -815
  51. package/.claude/agents/goal/code-goal-planner.md +445 -445
  52. package/.claude/agents/goal/goal-planner.md +167 -167
  53. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +129 -129
  54. package/.claude/agents/hive-mind/queen-coordinator.md +202 -202
  55. package/.claude/agents/hive-mind/scout-explorer.md +241 -241
  56. package/.claude/agents/hive-mind/swarm-memory-manager.md +192 -192
  57. package/.claude/agents/hive-mind/worker-specialist.md +216 -216
  58. package/.claude/agents/neural/safla-neural.md +73 -73
  59. package/.claude/agents/optimization/benchmark-suite.md +664 -664
  60. package/.claude/agents/optimization/load-balancer.md +430 -430
  61. package/.claude/agents/optimization/performance-monitor.md +671 -671
  62. package/.claude/agents/optimization/resource-allocator.md +673 -673
  63. package/.claude/agents/optimization/topology-optimizer.md +807 -807
  64. package/.claude/agents/payments/agentic-payments.md +126 -126
  65. package/.claude/agents/reasoning/agent.md +815 -815
  66. package/.claude/agents/reasoning/goal-planner.md +72 -72
  67. package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
  68. package/.claude/agents/sparc/architecture.md +471 -471
  69. package/.claude/agents/sparc/pseudocode.md +317 -317
  70. package/.claude/agents/sparc/refinement.md +524 -524
  71. package/.claude/agents/sparc/specification.md +275 -275
  72. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
  73. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  74. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  75. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  76. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  77. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  78. package/.claude/agents/swarm/adaptive-coordinator.md +395 -395
  79. package/.claude/agents/swarm/hierarchical-coordinator.md +326 -326
  80. package/.claude/agents/swarm/mesh-coordinator.md +391 -391
  81. package/.claude/agents/templates/automation-smart-agent.md +204 -204
  82. package/.claude/agents/templates/coordinator-swarm-init.md +104 -104
  83. package/.claude/agents/templates/github-pr-manager.md +176 -176
  84. package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
  85. package/.claude/agents/templates/memory-coordinator.md +186 -186
  86. package/.claude/agents/templates/migration-plan.md +745 -745
  87. package/.claude/agents/templates/orchestrator-task.md +138 -138
  88. package/.claude/agents/templates/performance-analyzer.md +198 -198
  89. package/.claude/agents/templates/sparc-coordinator.md +182 -182
  90. package/.claude/agents/testing/production-validator.md +394 -394
  91. package/.claude/agents/testing/tdd-london-swarm.md +243 -243
  92. package/.claude/agents/testing/unit/tdd-london-swarm.md +243 -243
  93. package/.claude/agents/testing/validation/production-validator.md +394 -394
  94. package/.claude/agents/v3/v3-integration-architect.md +345 -345
  95. package/.claude/agents/v3/v3-memory-specialist.md +317 -317
  96. package/.claude/agents/v3/v3-performance-engineer.md +396 -396
  97. package/.claude/agents/v3/v3-queen-coordinator.md +97 -97
  98. package/.claude/agents/v3/v3-security-architect.md +173 -173
  99. package/.claude/commands/agents/README.md +10 -10
  100. package/.claude/commands/agents/agent-capabilities.md +21 -21
  101. package/.claude/commands/agents/agent-coordination.md +28 -28
  102. package/.claude/commands/agents/agent-spawning.md +28 -28
  103. package/.claude/commands/agents/agent-types.md +26 -26
  104. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  105. package/.claude/commands/analysis/README.md +9 -9
  106. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  107. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  108. package/.claude/commands/analysis/performance-report.md +25 -25
  109. package/.claude/commands/analysis/token-efficiency.md +44 -44
  110. package/.claude/commands/analysis/token-usage.md +25 -25
  111. package/.claude/commands/automation/README.md +9 -9
  112. package/.claude/commands/automation/auto-agent.md +122 -122
  113. package/.claude/commands/automation/self-healing.md +105 -105
  114. package/.claude/commands/automation/session-memory.md +89 -89
  115. package/.claude/commands/automation/smart-agents.md +72 -72
  116. package/.claude/commands/automation/smart-spawn.md +25 -25
  117. package/.claude/commands/automation/workflow-select.md +25 -25
  118. package/.claude/commands/claude-flow-help.md +103 -103
  119. package/.claude/commands/claude-flow-memory.md +107 -107
  120. package/.claude/commands/claude-flow-swarm.md +205 -205
  121. package/.claude/commands/coordination/README.md +9 -9
  122. package/.claude/commands/coordination/agent-spawn.md +25 -25
  123. package/.claude/commands/coordination/init.md +44 -44
  124. package/.claude/commands/coordination/orchestrate.md +43 -43
  125. package/.claude/commands/coordination/spawn.md +45 -45
  126. package/.claude/commands/coordination/swarm-init.md +85 -85
  127. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  128. package/.claude/commands/flow-nexus/app-store.md +123 -123
  129. package/.claude/commands/flow-nexus/challenges.md +119 -119
  130. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  131. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  132. package/.claude/commands/flow-nexus/payments.md +115 -115
  133. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  134. package/.claude/commands/flow-nexus/swarm.md +86 -86
  135. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  136. package/.claude/commands/flow-nexus/workflow.md +114 -114
  137. package/.claude/commands/github/README.md +11 -11
  138. package/.claude/commands/github/code-review-swarm.md +513 -513
  139. package/.claude/commands/github/code-review.md +25 -25
  140. package/.claude/commands/github/github-modes.md +146 -146
  141. package/.claude/commands/github/github-swarm.md +121 -121
  142. package/.claude/commands/github/issue-tracker.md +291 -291
  143. package/.claude/commands/github/issue-triage.md +25 -25
  144. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  145. package/.claude/commands/github/pr-enhance.md +26 -26
  146. package/.claude/commands/github/pr-manager.md +169 -169
  147. package/.claude/commands/github/project-board-sync.md +470 -470
  148. package/.claude/commands/github/release-manager.md +337 -337
  149. package/.claude/commands/github/release-swarm.md +543 -543
  150. package/.claude/commands/github/repo-analyze.md +25 -25
  151. package/.claude/commands/github/repo-architect.md +366 -366
  152. package/.claude/commands/github/swarm-issue.md +481 -481
  153. package/.claude/commands/github/swarm-pr.md +284 -284
  154. package/.claude/commands/github/sync-coordinator.md +300 -300
  155. package/.claude/commands/github/workflow-automation.md +441 -441
  156. package/.claude/commands/hive-mind/README.md +17 -17
  157. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  158. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  159. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  160. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  161. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  162. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  163. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  164. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  165. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  166. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  167. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  168. package/.claude/commands/hooks/README.md +11 -11
  169. package/.claude/commands/hooks/overview.md +57 -57
  170. package/.claude/commands/hooks/post-edit.md +117 -117
  171. package/.claude/commands/hooks/post-task.md +112 -112
  172. package/.claude/commands/hooks/pre-edit.md +113 -113
  173. package/.claude/commands/hooks/pre-task.md +111 -111
  174. package/.claude/commands/hooks/session-end.md +118 -118
  175. package/.claude/commands/hooks/setup.md +102 -102
  176. package/.claude/commands/memory/README.md +9 -9
  177. package/.claude/commands/memory/memory-persist.md +25 -25
  178. package/.claude/commands/memory/memory-search.md +25 -25
  179. package/.claude/commands/memory/memory-usage.md +25 -25
  180. package/.claude/commands/memory/neural.md +47 -47
  181. package/.claude/commands/monitoring/README.md +9 -9
  182. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  183. package/.claude/commands/monitoring/agents.md +44 -44
  184. package/.claude/commands/monitoring/real-time-view.md +25 -25
  185. package/.claude/commands/monitoring/status.md +46 -46
  186. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  187. package/.claude/commands/optimization/README.md +9 -9
  188. package/.claude/commands/optimization/auto-topology.md +61 -61
  189. package/.claude/commands/optimization/cache-manage.md +25 -25
  190. package/.claude/commands/optimization/parallel-execute.md +25 -25
  191. package/.claude/commands/optimization/parallel-execution.md +49 -49
  192. package/.claude/commands/optimization/topology-optimize.md +25 -25
  193. package/.claude/commands/pair/README.md +260 -260
  194. package/.claude/commands/pair/commands.md +545 -545
  195. package/.claude/commands/pair/config.md +509 -509
  196. package/.claude/commands/pair/examples.md +511 -511
  197. package/.claude/commands/pair/modes.md +347 -347
  198. package/.claude/commands/pair/session.md +406 -406
  199. package/.claude/commands/pair/start.md +208 -208
  200. package/.claude/commands/sparc/analyzer.md +51 -51
  201. package/.claude/commands/sparc/architect.md +53 -53
  202. package/.claude/commands/sparc/ask.md +97 -97
  203. package/.claude/commands/sparc/batch-executor.md +54 -54
  204. package/.claude/commands/sparc/code.md +89 -89
  205. package/.claude/commands/sparc/coder.md +54 -54
  206. package/.claude/commands/sparc/debug.md +83 -83
  207. package/.claude/commands/sparc/debugger.md +54 -54
  208. package/.claude/commands/sparc/designer.md +53 -53
  209. package/.claude/commands/sparc/devops.md +109 -109
  210. package/.claude/commands/sparc/docs-writer.md +80 -80
  211. package/.claude/commands/sparc/documenter.md +54 -54
  212. package/.claude/commands/sparc/innovator.md +54 -54
  213. package/.claude/commands/sparc/integration.md +83 -83
  214. package/.claude/commands/sparc/mcp.md +117 -117
  215. package/.claude/commands/sparc/memory-manager.md +54 -54
  216. package/.claude/commands/sparc/optimizer.md +54 -54
  217. package/.claude/commands/sparc/orchestrator.md +131 -131
  218. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  219. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  220. package/.claude/commands/sparc/researcher.md +54 -54
  221. package/.claude/commands/sparc/reviewer.md +54 -54
  222. package/.claude/commands/sparc/security-review.md +80 -80
  223. package/.claude/commands/sparc/sparc-modes.md +174 -174
  224. package/.claude/commands/sparc/sparc.md +111 -111
  225. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  226. package/.claude/commands/sparc/supabase-admin.md +348 -348
  227. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  228. package/.claude/commands/sparc/tdd.md +54 -54
  229. package/.claude/commands/sparc/tester.md +54 -54
  230. package/.claude/commands/sparc/tutorial.md +79 -79
  231. package/.claude/commands/sparc/workflow-manager.md +54 -54
  232. package/.claude/commands/sparc.md +166 -166
  233. package/.claude/commands/stream-chain/pipeline.md +120 -120
  234. package/.claude/commands/stream-chain/run.md +69 -69
  235. package/.claude/commands/swarm/README.md +15 -15
  236. package/.claude/commands/swarm/analysis.md +95 -95
  237. package/.claude/commands/swarm/development.md +96 -96
  238. package/.claude/commands/swarm/examples.md +168 -168
  239. package/.claude/commands/swarm/maintenance.md +102 -102
  240. package/.claude/commands/swarm/optimization.md +117 -117
  241. package/.claude/commands/swarm/research.md +136 -136
  242. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  243. package/.claude/commands/swarm/swarm-background.md +8 -8
  244. package/.claude/commands/swarm/swarm-init.md +19 -19
  245. package/.claude/commands/swarm/swarm-modes.md +8 -8
  246. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  247. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  248. package/.claude/commands/swarm/swarm-status.md +8 -8
  249. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  250. package/.claude/commands/swarm/swarm.md +27 -27
  251. package/.claude/commands/swarm/testing.md +131 -131
  252. package/.claude/commands/training/README.md +9 -9
  253. package/.claude/commands/training/model-update.md +25 -25
  254. package/.claude/commands/training/neural-patterns.md +73 -73
  255. package/.claude/commands/training/neural-train.md +25 -25
  256. package/.claude/commands/training/pattern-learn.md +25 -25
  257. package/.claude/commands/training/specialization.md +62 -62
  258. package/.claude/commands/truth/start.md +142 -142
  259. package/.claude/commands/verify/check.md +49 -49
  260. package/.claude/commands/verify/start.md +127 -127
  261. package/.claude/commands/workflows/README.md +9 -9
  262. package/.claude/commands/workflows/development.md +77 -77
  263. package/.claude/commands/workflows/research.md +62 -62
  264. package/.claude/commands/workflows/workflow-create.md +25 -25
  265. package/.claude/commands/workflows/workflow-execute.md +25 -25
  266. package/.claude/commands/workflows/workflow-export.md +25 -25
  267. package/.claude/config/v3-dependency-optimization.json +265 -265
  268. package/.claude/config/v3-performance-targets.json +250 -250
  269. package/.claude/helpers/README.md +96 -96
  270. package/.claude/helpers/aggressive-microcompact.mjs +36 -36
  271. package/.claude/helpers/auto-memory-hook.mjs +363 -363
  272. package/.claude/helpers/context-persistence-hook.mjs +1979 -1979
  273. package/.claude/helpers/github-safe.js +106 -106
  274. package/.claude/helpers/learning-service.mjs +1144 -1144
  275. package/.claude/helpers/metrics-db.mjs +488 -488
  276. package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
  277. package/.claude/mcp.json +12 -12
  278. package/.claude/settings.json +2 -2
  279. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  280. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  281. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  282. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  283. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  284. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  285. package/.claude/skills/dual-mode/README.md +71 -71
  286. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  287. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  288. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  289. package/.claude/skills/flow-nexus-neural/SKILL.md +738 -738
  290. package/.claude/skills/flow-nexus-platform/SKILL.md +1157 -1157
  291. package/.claude/skills/flow-nexus-swarm/SKILL.md +610 -610
  292. package/.claude/skills/github-code-review/SKILL.md +1 -1
  293. package/.claude/skills/github-multi-repo/SKILL.md +2 -2
  294. package/.claude/skills/github-project-management/SKILL.md +1 -1
  295. package/.claude/skills/github-release-management/SKILL.md +2 -2
  296. package/.claude/skills/github-workflow-automation/SKILL.md +1 -1
  297. package/.claude/skills/hive-mind-advanced/SKILL.md +4 -4
  298. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  299. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  300. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  301. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  302. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  303. package/.claude/skills/skill-builder/SKILL.md +910 -910
  304. package/.claude/skills/sparc-methodology/SKILL.md +2 -2
  305. package/.claude/skills/stream-chain/SKILL.md +563 -563
  306. package/.claude/skills/swarm-advanced/SKILL.md +4 -4
  307. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  308. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  309. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  310. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  311. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  312. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  313. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  314. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  315. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  316. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  317. package/.claude/skills/verification-quality/SKILL.md +649 -649
  318. package/.claude/skills/worker-benchmarks/skill.md +135 -135
  319. package/.claude/skills/worker-integration/skill.md +154 -154
  320. package/.claude/statusline.mjs +109 -109
  321. package/.claude-plugin/README.md +6 -6
  322. package/.claude-plugin/docs/INSTALLATION.md +4 -4
  323. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +5 -5
  324. package/.claude-plugin/docs/QUICKSTART.md +1 -1
  325. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  326. package/.claude-plugin/hooks/hooks.json +74 -74
  327. package/.claude-plugin/marketplace.json +5 -5
  328. package/.claude-plugin/plugin.json +4 -4
  329. package/README.md +148 -148
  330. package/bin/cli.js +12 -12
  331. package/bin/npx-repair.js +7 -7
  332. package/bin/npx-safe-launch.js +9 -9
  333. package/package.json +115 -114
  334. package/v3/@claude-flow/cli/README.md +5 -5
  335. package/v3/@claude-flow/cli/bin/cli.js +156 -156
  336. package/v3/@claude-flow/cli/bin/mcp-server.js +189 -189
  337. package/v3/@claude-flow/cli/dist/src/commands/analyze.d.ts +1 -1
  338. package/v3/@claude-flow/cli/dist/src/commands/analyze.js +1 -1
  339. package/v3/@claude-flow/cli/dist/src/commands/claims.d.ts +1 -1
  340. package/v3/@claude-flow/cli/dist/src/commands/claims.js +2 -2
  341. package/v3/@claude-flow/cli/dist/src/commands/completions.d.ts +1 -1
  342. package/v3/@claude-flow/cli/dist/src/commands/completions.js +1 -1
  343. package/v3/@claude-flow/cli/dist/src/commands/config.js +36 -2
  344. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +54 -7
  345. package/v3/@claude-flow/cli/dist/src/commands/deployment.d.ts +1 -1
  346. package/v3/@claude-flow/cli/dist/src/commands/deployment.js +2 -2
  347. package/v3/@claude-flow/cli/dist/src/commands/doctor.d.ts +1 -1
  348. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +1 -1
  349. package/v3/@claude-flow/cli/dist/src/commands/embeddings.d.ts +1 -1
  350. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +2 -2
  351. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +90 -90
  352. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +30 -112
  353. package/v3/@claude-flow/cli/dist/src/commands/init.js +6 -1
  354. package/v3/@claude-flow/cli/dist/src/commands/memory.js +30 -30
  355. package/v3/@claude-flow/cli/dist/src/commands/neural.d.ts +1 -1
  356. package/v3/@claude-flow/cli/dist/src/commands/neural.js +2 -2
  357. package/v3/@claude-flow/cli/dist/src/commands/orc.js +1 -0
  358. package/v3/@claude-flow/cli/dist/src/commands/performance.d.ts +1 -1
  359. package/v3/@claude-flow/cli/dist/src/commands/performance.js +2 -2
  360. package/v3/@claude-flow/cli/dist/src/commands/plugins.d.ts +1 -1
  361. package/v3/@claude-flow/cli/dist/src/commands/plugins.js +2 -2
  362. package/v3/@claude-flow/cli/dist/src/commands/providers.d.ts +1 -1
  363. package/v3/@claude-flow/cli/dist/src/commands/providers.js +2 -2
  364. package/v3/@claude-flow/cli/dist/src/commands/route.d.ts +1 -1
  365. package/v3/@claude-flow/cli/dist/src/commands/route.js +1 -1
  366. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  367. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +29 -29
  368. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.d.ts +1 -1
  369. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +1 -1
  370. package/v3/@claude-flow/cli/dist/src/commands/ruvector/index.d.ts +1 -1
  371. package/v3/@claude-flow/cli/dist/src/commands/ruvector/index.js +1 -1
  372. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +113 -113
  373. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +97 -97
  374. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  375. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.d.ts +1 -1
  376. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +2 -2
  377. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +36 -36
  378. package/v3/@claude-flow/cli/dist/src/commands/security.d.ts +1 -1
  379. package/v3/@claude-flow/cli/dist/src/commands/security.js +2 -2
  380. package/v3/@claude-flow/cli/dist/src/config/moflo-config.d.ts +13 -1
  381. package/v3/@claude-flow/cli/dist/src/config/moflo-config.js +93 -41
  382. package/v3/@claude-flow/cli/dist/src/index.d.ts +1 -1
  383. package/v3/@claude-flow/cli/dist/src/index.js +2 -2
  384. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +2 -2
  385. package/v3/@claude-flow/cli/dist/src/init/executor.js +3 -3
  386. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +640 -640
  387. package/v3/@claude-flow/cli/dist/src/init/moflo-init.d.ts +10 -0
  388. package/v3/@claude-flow/cli/dist/src/init/moflo-init.js +101 -20
  389. package/v3/@claude-flow/cli/dist/src/init/settings-generator.js +2 -2
  390. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +783 -783
  391. package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +30 -13
  392. package/v3/@claude-flow/cli/dist/src/mcp-tools/security-tools.d.ts +1 -1
  393. package/v3/@claude-flow/cli/dist/src/mcp-tools/security-tools.js +1 -1
  394. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +61 -61
  395. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +2212 -2263
  396. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  397. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.d.ts +1 -1
  398. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.js +1 -1
  399. package/v3/@claude-flow/cli/dist/src/ruvector/vector-db.d.ts +1 -1
  400. package/v3/@claude-flow/cli/dist/src/ruvector/vector-db.js +1 -1
  401. package/v3/@claude-flow/cli/dist/src/services/agent-router.d.ts +14 -0
  402. package/v3/@claude-flow/cli/dist/src/services/agent-router.js +86 -7
  403. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  404. package/v3/@claude-flow/cli/dist/src/services/index.d.ts +1 -3
  405. package/v3/@claude-flow/cli/dist/src/services/index.js +1 -2
  406. package/v3/@claude-flow/cli/dist/src/services/learning-service.js +54 -54
  407. package/v3/@claude-flow/cli/dist/src/services/ruvector-training.d.ts +1 -1
  408. package/v3/@claude-flow/cli/dist/src/services/ruvector-training.js +1 -1
  409. package/v3/@claude-flow/cli/dist/src/services/worker-daemon.d.ts +24 -3
  410. package/v3/@claude-flow/cli/dist/src/services/worker-daemon.js +123 -12
  411. package/v3/@claude-flow/cli/dist/src/services/workflow-gate.d.ts +1 -0
  412. package/v3/@claude-flow/cli/dist/src/services/workflow-gate.js +20 -5
  413. package/v3/@claude-flow/cli/dist/src/suggest.d.ts +1 -1
  414. package/v3/@claude-flow/cli/dist/src/suggest.js +1 -1
  415. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  416. package/v3/@claude-flow/cli/package.json +6 -6
  417. package/v3/@claude-flow/guidance/README.md +6 -6
  418. package/v3/@claude-flow/guidance/package.json +1 -1
  419. package/v3/@claude-flow/memory/README.md +1 -1
  420. package/v3/@claude-flow/shared/README.md +1 -1
  421. package/v3/@claude-flow/shared/package.json +42 -42
  422. package/v3/README.md +3 -3
@@ -1,446 +1,446 @@
1
- ---
2
- name: "ReasoningBank with AgentDB"
3
- description: "Implement ReasoningBank adaptive learning with AgentDB's 150x faster vector database. Includes trajectory tracking, verdict judgment, memory distillation, and pattern recognition. Use when building self-learning agents, optimizing decision-making, or implementing experience replay systems."
4
- ---
5
-
6
- # ReasoningBank with AgentDB
7
-
8
- ## What This Skill Does
9
-
10
- Provides ReasoningBank adaptive learning patterns using AgentDB's high-performance backend (150x-12,500x faster). Enables agents to learn from experiences, judge outcomes, distill memories, and improve decision-making over time with 100% backward compatibility.
11
-
12
- **Performance**: 150x faster pattern retrieval, 500x faster batch operations, <1ms memory access.
13
-
14
- ## Prerequisites
15
-
16
- - Node.js 18+
17
- - AgentDB v1.0.7+ (via agentic-flow)
18
- - Understanding of reinforcement learning concepts (optional)
19
-
20
- ---
21
-
22
- ## Quick Start with CLI
23
-
24
- ### Initialize ReasoningBank Database
25
-
26
- ```bash
27
- # Initialize AgentDB for ReasoningBank
28
- npx agentdb@latest init ./.agentdb/reasoningbank.db --dimension 1536
29
-
30
- # Start MCP server for Claude Code integration
31
- npx agentdb@latest mcp
32
- claude mcp add agentdb npx agentdb@latest mcp
33
- ```
34
-
35
- ### Migrate from Legacy ReasoningBank
36
-
37
- ```bash
38
- # Automatic migration with validation
39
- npx agentdb@latest migrate --source .swarm/memory.db
40
-
41
- # Verify migration
42
- npx agentdb@latest stats ./.agentdb/reasoningbank.db
43
- ```
44
-
45
- ---
46
-
47
- ## Quick Start with API
48
-
49
- ```typescript
50
- import { createAgentDBAdapter, computeEmbedding } from 'agentic-flow/reasoningbank';
51
-
52
- // Initialize ReasoningBank with AgentDB
53
- const rb = await createAgentDBAdapter({
54
- dbPath: '.agentdb/reasoningbank.db',
55
- enableLearning: true, // Enable learning plugins
56
- enableReasoning: true, // Enable reasoning agents
57
- cacheSize: 1000, // 1000 pattern cache
58
- });
59
-
60
- // Store successful experience
61
- const query = "How to optimize database queries?";
62
- const embedding = await computeEmbedding(query);
63
-
64
- await rb.insertPattern({
65
- id: '',
66
- type: 'experience',
67
- domain: 'database-optimization',
68
- pattern_data: JSON.stringify({
69
- embedding,
70
- pattern: {
71
- query,
72
- approach: 'indexing + query optimization',
73
- outcome: 'success',
74
- metrics: { latency_reduction: 0.85 }
75
- }
76
- }),
77
- confidence: 0.95,
78
- usage_count: 1,
79
- success_count: 1,
80
- created_at: Date.now(),
81
- last_used: Date.now(),
82
- });
83
-
84
- // Retrieve similar experiences with reasoning
85
- const result = await rb.retrieveWithReasoning(embedding, {
86
- domain: 'database-optimization',
87
- k: 5,
88
- useMMR: true, // Diverse results
89
- synthesizeContext: true, // Rich context synthesis
90
- });
91
-
92
- console.log('Memories:', result.memories);
93
- console.log('Context:', result.context);
94
- console.log('Patterns:', result.patterns);
95
- ```
96
-
97
- ---
98
-
99
- ## Core ReasoningBank Concepts
100
-
101
- ### 1. Trajectory Tracking
102
-
103
- Track agent execution paths and outcomes:
104
-
105
- ```typescript
106
- // Record trajectory (sequence of actions)
107
- const trajectory = {
108
- task: 'optimize-api-endpoint',
109
- steps: [
110
- { action: 'analyze-bottleneck', result: 'found N+1 query' },
111
- { action: 'add-eager-loading', result: 'reduced queries' },
112
- { action: 'add-caching', result: 'improved latency' }
113
- ],
114
- outcome: 'success',
115
- metrics: { latency_before: 2500, latency_after: 150 }
116
- };
117
-
118
- const embedding = await computeEmbedding(JSON.stringify(trajectory));
119
-
120
- await rb.insertPattern({
121
- id: '',
122
- type: 'trajectory',
123
- domain: 'api-optimization',
124
- pattern_data: JSON.stringify({ embedding, pattern: trajectory }),
125
- confidence: 0.9,
126
- usage_count: 1,
127
- success_count: 1,
128
- created_at: Date.now(),
129
- last_used: Date.now(),
130
- });
131
- ```
132
-
133
- ### 2. Verdict Judgment
134
-
135
- Judge whether a trajectory was successful:
136
-
137
- ```typescript
138
- // Retrieve similar past trajectories
139
- const similar = await rb.retrieveWithReasoning(queryEmbedding, {
140
- domain: 'api-optimization',
141
- k: 10,
142
- });
143
-
144
- // Judge based on similarity to successful patterns
145
- const verdict = similar.memories.filter(m =>
146
- m.pattern.outcome === 'success' &&
147
- m.similarity > 0.8
148
- ).length > 5 ? 'likely_success' : 'needs_review';
149
-
150
- console.log('Verdict:', verdict);
151
- console.log('Confidence:', similar.memories[0]?.similarity || 0);
152
- ```
153
-
154
- ### 3. Memory Distillation
155
-
156
- Consolidate similar experiences into patterns:
157
-
158
- ```typescript
159
- // Get all experiences in domain
160
- const experiences = await rb.retrieveWithReasoning(embedding, {
161
- domain: 'api-optimization',
162
- k: 100,
163
- optimizeMemory: true, // Automatic consolidation
164
- });
165
-
166
- // Distill into high-level pattern
167
- const distilledPattern = {
168
- domain: 'api-optimization',
169
- pattern: 'For N+1 queries: add eager loading, then cache',
170
- success_rate: 0.92,
171
- sample_size: experiences.memories.length,
172
- confidence: 0.95
173
- };
174
-
175
- await rb.insertPattern({
176
- id: '',
177
- type: 'distilled-pattern',
178
- domain: 'api-optimization',
179
- pattern_data: JSON.stringify({
180
- embedding: await computeEmbedding(JSON.stringify(distilledPattern)),
181
- pattern: distilledPattern
182
- }),
183
- confidence: 0.95,
184
- usage_count: 0,
185
- success_count: 0,
186
- created_at: Date.now(),
187
- last_used: Date.now(),
188
- });
189
- ```
190
-
191
- ---
192
-
193
- ## Integration with Reasoning Agents
194
-
195
- AgentDB provides 4 reasoning modules that enhance ReasoningBank:
196
-
197
- ### 1. PatternMatcher
198
-
199
- Find similar successful patterns:
200
-
201
- ```typescript
202
- const result = await rb.retrieveWithReasoning(queryEmbedding, {
203
- domain: 'problem-solving',
204
- k: 10,
205
- useMMR: true, // Maximal Marginal Relevance for diversity
206
- });
207
-
208
- // PatternMatcher returns diverse, relevant memories
209
- result.memories.forEach(mem => {
210
- console.log(`Pattern: ${mem.pattern.approach}`);
211
- console.log(`Similarity: ${mem.similarity}`);
212
- console.log(`Success Rate: ${mem.success_count / mem.usage_count}`);
213
- });
214
- ```
215
-
216
- ### 2. ContextSynthesizer
217
-
218
- Generate rich context from multiple memories:
219
-
220
- ```typescript
221
- const result = await rb.retrieveWithReasoning(queryEmbedding, {
222
- domain: 'code-optimization',
223
- synthesizeContext: true, // Enable context synthesis
224
- k: 5,
225
- });
226
-
227
- // ContextSynthesizer creates coherent narrative
228
- console.log('Synthesized Context:', result.context);
229
- // "Based on 5 similar optimizations, the most effective approach
230
- // involves profiling, identifying bottlenecks, and applying targeted
231
- // improvements. Success rate: 87%"
232
- ```
233
-
234
- ### 3. MemoryOptimizer
235
-
236
- Automatically consolidate and prune:
237
-
238
- ```typescript
239
- const result = await rb.retrieveWithReasoning(queryEmbedding, {
240
- domain: 'testing',
241
- optimizeMemory: true, // Enable automatic optimization
242
- });
243
-
244
- // MemoryOptimizer consolidates similar patterns and prunes low-quality
245
- console.log('Optimizations:', result.optimizations);
246
- // { consolidated: 15, pruned: 3, improved_quality: 0.12 }
247
- ```
248
-
249
- ### 4. ExperienceCurator
250
-
251
- Filter by quality and relevance:
252
-
253
- ```typescript
254
- const result = await rb.retrieveWithReasoning(queryEmbedding, {
255
- domain: 'debugging',
256
- k: 20,
257
- minConfidence: 0.8, // Only high-confidence experiences
258
- });
259
-
260
- // ExperienceCurator returns only quality experiences
261
- result.memories.forEach(mem => {
262
- console.log(`Confidence: ${mem.confidence}`);
263
- console.log(`Success Rate: ${mem.success_count / mem.usage_count}`);
264
- });
265
- ```
266
-
267
- ---
268
-
269
- ## Legacy API Compatibility
270
-
271
- AgentDB maintains 100% backward compatibility with legacy ReasoningBank:
272
-
273
- ```typescript
274
- import {
275
- retrieveMemories,
276
- judgeTrajectory,
277
- distillMemories
278
- } from 'agentic-flow/reasoningbank';
279
-
280
- // Legacy API works unchanged (uses AgentDB backend automatically)
281
- const memories = await retrieveMemories(query, {
282
- domain: 'code-generation',
283
- agent: 'coder'
284
- });
285
-
286
- const verdict = await judgeTrajectory(trajectory, query);
287
-
288
- const newMemories = await distillMemories(
289
- trajectory,
290
- verdict,
291
- query,
292
- { domain: 'code-generation' }
293
- );
294
- ```
295
-
296
- ---
297
-
298
- ## Performance Characteristics
299
-
300
- - **Pattern Search**: 150x faster (100µs vs 15ms)
301
- - **Memory Retrieval**: <1ms (with cache)
302
- - **Batch Insert**: 500x faster (2ms vs 1s for 100 patterns)
303
- - **Trajectory Judgment**: <5ms (including retrieval + analysis)
304
- - **Memory Distillation**: <50ms (consolidate 100 patterns)
305
-
306
- ---
307
-
308
- ## Advanced Patterns
309
-
310
- ### Hierarchical Memory
311
-
312
- Organize memories by abstraction level:
313
-
314
- ```typescript
315
- // Low-level: Specific implementation
316
- await rb.insertPattern({
317
- type: 'concrete',
318
- domain: 'debugging/null-pointer',
319
- pattern_data: JSON.stringify({
320
- embedding,
321
- pattern: { bug: 'NPE in UserService.getUser()', fix: 'Add null check' }
322
- }),
323
- confidence: 0.9,
324
- // ...
325
- });
326
-
327
- // Mid-level: Pattern across similar cases
328
- await rb.insertPattern({
329
- type: 'pattern',
330
- domain: 'debugging',
331
- pattern_data: JSON.stringify({
332
- embedding,
333
- pattern: { category: 'null-pointer', approach: 'defensive-checks' }
334
- }),
335
- confidence: 0.85,
336
- // ...
337
- });
338
-
339
- // High-level: General principle
340
- await rb.insertPattern({
341
- type: 'principle',
342
- domain: 'software-engineering',
343
- pattern_data: JSON.stringify({
344
- embedding,
345
- pattern: { principle: 'fail-fast with clear errors' }
346
- }),
347
- confidence: 0.95,
348
- // ...
349
- });
350
- ```
351
-
352
- ### Multi-Domain Learning
353
-
354
- Transfer learning across domains:
355
-
356
- ```typescript
357
- // Learn from backend optimization
358
- const backendExperience = await rb.retrieveWithReasoning(embedding, {
359
- domain: 'backend-optimization',
360
- k: 10,
361
- });
362
-
363
- // Apply to frontend optimization
364
- const transferredKnowledge = backendExperience.memories.map(mem => ({
365
- ...mem,
366
- domain: 'frontend-optimization',
367
- adapted: true,
368
- }));
369
- ```
370
-
371
- ---
372
-
373
- ## CLI Operations
374
-
375
- ### Database Management
376
-
377
- ```bash
378
- # Export trajectories and patterns
379
- npx agentdb@latest export ./.agentdb/reasoningbank.db ./backup.json
380
-
381
- # Import experiences
382
- npx agentdb@latest import ./experiences.json
383
-
384
- # Get statistics
385
- npx agentdb@latest stats ./.agentdb/reasoningbank.db
386
- # Shows: total patterns, domains, confidence distribution
387
- ```
388
-
389
- ### Migration
390
-
391
- ```bash
392
- # Migrate from legacy ReasoningBank
393
- npx agentdb@latest migrate --source .swarm/memory.db --target .agentdb/reasoningbank.db
394
-
395
- # Validate migration
396
- npx agentdb@latest stats .agentdb/reasoningbank.db
397
- ```
398
-
399
- ---
400
-
401
- ## Troubleshooting
402
-
403
- ### Issue: Migration fails
404
- ```bash
405
- # Check source database exists
406
- ls -la .swarm/memory.db
407
-
408
- # Run with verbose logging
409
- DEBUG=agentdb:* npx agentdb@latest migrate --source .swarm/memory.db
410
- ```
411
-
412
- ### Issue: Low confidence scores
413
- ```typescript
414
- // Enable context synthesis for better quality
415
- const result = await rb.retrieveWithReasoning(embedding, {
416
- synthesizeContext: true,
417
- useMMR: true,
418
- k: 10,
419
- });
420
- ```
421
-
422
- ### Issue: Memory growing too large
423
- ```typescript
424
- // Enable automatic optimization
425
- const result = await rb.retrieveWithReasoning(embedding, {
426
- optimizeMemory: true, // Consolidates similar patterns
427
- });
428
-
429
- // Or manually optimize
430
- await rb.optimize();
431
- ```
432
-
433
- ---
434
-
435
- ## Learn More
436
-
437
- - **AgentDB Integration**: node_modules/agentic-flow/docs/AGENTDB_INTEGRATION.md
438
- - **GitHub**: https://github.com/ruvnet/agentic-flow/tree/main/packages/agentdb
439
- - **MCP Integration**: `npx agentdb@latest mcp`
440
- - **Website**: https://agentdb.ruv.io
441
-
442
- ---
443
-
444
- **Category**: Machine Learning / Reinforcement Learning
445
- **Difficulty**: Intermediate
446
- **Estimated Time**: 20-30 minutes
1
+ ---
2
+ name: "ReasoningBank with AgentDB"
3
+ description: "Implement ReasoningBank adaptive learning with AgentDB's 150x faster vector database. Includes trajectory tracking, verdict judgment, memory distillation, and pattern recognition. Use when building self-learning agents, optimizing decision-making, or implementing experience replay systems."
4
+ ---
5
+
6
+ # ReasoningBank with AgentDB
7
+
8
+ ## What This Skill Does
9
+
10
+ Provides ReasoningBank adaptive learning patterns using AgentDB's high-performance backend (150x-12,500x faster). Enables agents to learn from experiences, judge outcomes, distill memories, and improve decision-making over time with 100% backward compatibility.
11
+
12
+ **Performance**: 150x faster pattern retrieval, 500x faster batch operations, <1ms memory access.
13
+
14
+ ## Prerequisites
15
+
16
+ - Node.js 18+
17
+ - AgentDB v1.0.7+ (via agentic-flow)
18
+ - Understanding of reinforcement learning concepts (optional)
19
+
20
+ ---
21
+
22
+ ## Quick Start with CLI
23
+
24
+ ### Initialize ReasoningBank Database
25
+
26
+ ```bash
27
+ # Initialize AgentDB for ReasoningBank
28
+ npx agentdb@latest init ./.agentdb/reasoningbank.db --dimension 1536
29
+
30
+ # Start MCP server for Claude Code integration
31
+ npx agentdb@latest mcp
32
+ claude mcp add agentdb npx agentdb@latest mcp
33
+ ```
34
+
35
+ ### Migrate from Legacy ReasoningBank
36
+
37
+ ```bash
38
+ # Automatic migration with validation
39
+ npx agentdb@latest migrate --source .swarm/memory.db
40
+
41
+ # Verify migration
42
+ npx agentdb@latest stats ./.agentdb/reasoningbank.db
43
+ ```
44
+
45
+ ---
46
+
47
+ ## Quick Start with API
48
+
49
+ ```typescript
50
+ import { createAgentDBAdapter, computeEmbedding } from 'agentic-flow/reasoningbank';
51
+
52
+ // Initialize ReasoningBank with AgentDB
53
+ const rb = await createAgentDBAdapter({
54
+ dbPath: '.agentdb/reasoningbank.db',
55
+ enableLearning: true, // Enable learning plugins
56
+ enableReasoning: true, // Enable reasoning agents
57
+ cacheSize: 1000, // 1000 pattern cache
58
+ });
59
+
60
+ // Store successful experience
61
+ const query = "How to optimize database queries?";
62
+ const embedding = await computeEmbedding(query);
63
+
64
+ await rb.insertPattern({
65
+ id: '',
66
+ type: 'experience',
67
+ domain: 'database-optimization',
68
+ pattern_data: JSON.stringify({
69
+ embedding,
70
+ pattern: {
71
+ query,
72
+ approach: 'indexing + query optimization',
73
+ outcome: 'success',
74
+ metrics: { latency_reduction: 0.85 }
75
+ }
76
+ }),
77
+ confidence: 0.95,
78
+ usage_count: 1,
79
+ success_count: 1,
80
+ created_at: Date.now(),
81
+ last_used: Date.now(),
82
+ });
83
+
84
+ // Retrieve similar experiences with reasoning
85
+ const result = await rb.retrieveWithReasoning(embedding, {
86
+ domain: 'database-optimization',
87
+ k: 5,
88
+ useMMR: true, // Diverse results
89
+ synthesizeContext: true, // Rich context synthesis
90
+ });
91
+
92
+ console.log('Memories:', result.memories);
93
+ console.log('Context:', result.context);
94
+ console.log('Patterns:', result.patterns);
95
+ ```
96
+
97
+ ---
98
+
99
+ ## Core ReasoningBank Concepts
100
+
101
+ ### 1. Trajectory Tracking
102
+
103
+ Track agent execution paths and outcomes:
104
+
105
+ ```typescript
106
+ // Record trajectory (sequence of actions)
107
+ const trajectory = {
108
+ task: 'optimize-api-endpoint',
109
+ steps: [
110
+ { action: 'analyze-bottleneck', result: 'found N+1 query' },
111
+ { action: 'add-eager-loading', result: 'reduced queries' },
112
+ { action: 'add-caching', result: 'improved latency' }
113
+ ],
114
+ outcome: 'success',
115
+ metrics: { latency_before: 2500, latency_after: 150 }
116
+ };
117
+
118
+ const embedding = await computeEmbedding(JSON.stringify(trajectory));
119
+
120
+ await rb.insertPattern({
121
+ id: '',
122
+ type: 'trajectory',
123
+ domain: 'api-optimization',
124
+ pattern_data: JSON.stringify({ embedding, pattern: trajectory }),
125
+ confidence: 0.9,
126
+ usage_count: 1,
127
+ success_count: 1,
128
+ created_at: Date.now(),
129
+ last_used: Date.now(),
130
+ });
131
+ ```
132
+
133
+ ### 2. Verdict Judgment
134
+
135
+ Judge whether a trajectory was successful:
136
+
137
+ ```typescript
138
+ // Retrieve similar past trajectories
139
+ const similar = await rb.retrieveWithReasoning(queryEmbedding, {
140
+ domain: 'api-optimization',
141
+ k: 10,
142
+ });
143
+
144
+ // Judge based on similarity to successful patterns
145
+ const verdict = similar.memories.filter(m =>
146
+ m.pattern.outcome === 'success' &&
147
+ m.similarity > 0.8
148
+ ).length > 5 ? 'likely_success' : 'needs_review';
149
+
150
+ console.log('Verdict:', verdict);
151
+ console.log('Confidence:', similar.memories[0]?.similarity || 0);
152
+ ```
153
+
154
+ ### 3. Memory Distillation
155
+
156
+ Consolidate similar experiences into patterns:
157
+
158
+ ```typescript
159
+ // Get all experiences in domain
160
+ const experiences = await rb.retrieveWithReasoning(embedding, {
161
+ domain: 'api-optimization',
162
+ k: 100,
163
+ optimizeMemory: true, // Automatic consolidation
164
+ });
165
+
166
+ // Distill into high-level pattern
167
+ const distilledPattern = {
168
+ domain: 'api-optimization',
169
+ pattern: 'For N+1 queries: add eager loading, then cache',
170
+ success_rate: 0.92,
171
+ sample_size: experiences.memories.length,
172
+ confidence: 0.95
173
+ };
174
+
175
+ await rb.insertPattern({
176
+ id: '',
177
+ type: 'distilled-pattern',
178
+ domain: 'api-optimization',
179
+ pattern_data: JSON.stringify({
180
+ embedding: await computeEmbedding(JSON.stringify(distilledPattern)),
181
+ pattern: distilledPattern
182
+ }),
183
+ confidence: 0.95,
184
+ usage_count: 0,
185
+ success_count: 0,
186
+ created_at: Date.now(),
187
+ last_used: Date.now(),
188
+ });
189
+ ```
190
+
191
+ ---
192
+
193
+ ## Integration with Reasoning Agents
194
+
195
+ AgentDB provides 4 reasoning modules that enhance ReasoningBank:
196
+
197
+ ### 1. PatternMatcher
198
+
199
+ Find similar successful patterns:
200
+
201
+ ```typescript
202
+ const result = await rb.retrieveWithReasoning(queryEmbedding, {
203
+ domain: 'problem-solving',
204
+ k: 10,
205
+ useMMR: true, // Maximal Marginal Relevance for diversity
206
+ });
207
+
208
+ // PatternMatcher returns diverse, relevant memories
209
+ result.memories.forEach(mem => {
210
+ console.log(`Pattern: ${mem.pattern.approach}`);
211
+ console.log(`Similarity: ${mem.similarity}`);
212
+ console.log(`Success Rate: ${mem.success_count / mem.usage_count}`);
213
+ });
214
+ ```
215
+
216
+ ### 2. ContextSynthesizer
217
+
218
+ Generate rich context from multiple memories:
219
+
220
+ ```typescript
221
+ const result = await rb.retrieveWithReasoning(queryEmbedding, {
222
+ domain: 'code-optimization',
223
+ synthesizeContext: true, // Enable context synthesis
224
+ k: 5,
225
+ });
226
+
227
+ // ContextSynthesizer creates coherent narrative
228
+ console.log('Synthesized Context:', result.context);
229
+ // "Based on 5 similar optimizations, the most effective approach
230
+ // involves profiling, identifying bottlenecks, and applying targeted
231
+ // improvements. Success rate: 87%"
232
+ ```
233
+
234
+ ### 3. MemoryOptimizer
235
+
236
+ Automatically consolidate and prune:
237
+
238
+ ```typescript
239
+ const result = await rb.retrieveWithReasoning(queryEmbedding, {
240
+ domain: 'testing',
241
+ optimizeMemory: true, // Enable automatic optimization
242
+ });
243
+
244
+ // MemoryOptimizer consolidates similar patterns and prunes low-quality
245
+ console.log('Optimizations:', result.optimizations);
246
+ // { consolidated: 15, pruned: 3, improved_quality: 0.12 }
247
+ ```
248
+
249
+ ### 4. ExperienceCurator
250
+
251
+ Filter by quality and relevance:
252
+
253
+ ```typescript
254
+ const result = await rb.retrieveWithReasoning(queryEmbedding, {
255
+ domain: 'debugging',
256
+ k: 20,
257
+ minConfidence: 0.8, // Only high-confidence experiences
258
+ });
259
+
260
+ // ExperienceCurator returns only quality experiences
261
+ result.memories.forEach(mem => {
262
+ console.log(`Confidence: ${mem.confidence}`);
263
+ console.log(`Success Rate: ${mem.success_count / mem.usage_count}`);
264
+ });
265
+ ```
266
+
267
+ ---
268
+
269
+ ## Legacy API Compatibility
270
+
271
+ AgentDB maintains 100% backward compatibility with legacy ReasoningBank:
272
+
273
+ ```typescript
274
+ import {
275
+ retrieveMemories,
276
+ judgeTrajectory,
277
+ distillMemories
278
+ } from 'agentic-flow/reasoningbank';
279
+
280
+ // Legacy API works unchanged (uses AgentDB backend automatically)
281
+ const memories = await retrieveMemories(query, {
282
+ domain: 'code-generation',
283
+ agent: 'coder'
284
+ });
285
+
286
+ const verdict = await judgeTrajectory(trajectory, query);
287
+
288
+ const newMemories = await distillMemories(
289
+ trajectory,
290
+ verdict,
291
+ query,
292
+ { domain: 'code-generation' }
293
+ );
294
+ ```
295
+
296
+ ---
297
+
298
+ ## Performance Characteristics
299
+
300
+ - **Pattern Search**: 150x faster (100µs vs 15ms)
301
+ - **Memory Retrieval**: <1ms (with cache)
302
+ - **Batch Insert**: 500x faster (2ms vs 1s for 100 patterns)
303
+ - **Trajectory Judgment**: <5ms (including retrieval + analysis)
304
+ - **Memory Distillation**: <50ms (consolidate 100 patterns)
305
+
306
+ ---
307
+
308
+ ## Advanced Patterns
309
+
310
+ ### Hierarchical Memory
311
+
312
+ Organize memories by abstraction level:
313
+
314
+ ```typescript
315
+ // Low-level: Specific implementation
316
+ await rb.insertPattern({
317
+ type: 'concrete',
318
+ domain: 'debugging/null-pointer',
319
+ pattern_data: JSON.stringify({
320
+ embedding,
321
+ pattern: { bug: 'NPE in UserService.getUser()', fix: 'Add null check' }
322
+ }),
323
+ confidence: 0.9,
324
+ // ...
325
+ });
326
+
327
+ // Mid-level: Pattern across similar cases
328
+ await rb.insertPattern({
329
+ type: 'pattern',
330
+ domain: 'debugging',
331
+ pattern_data: JSON.stringify({
332
+ embedding,
333
+ pattern: { category: 'null-pointer', approach: 'defensive-checks' }
334
+ }),
335
+ confidence: 0.85,
336
+ // ...
337
+ });
338
+
339
+ // High-level: General principle
340
+ await rb.insertPattern({
341
+ type: 'principle',
342
+ domain: 'software-engineering',
343
+ pattern_data: JSON.stringify({
344
+ embedding,
345
+ pattern: { principle: 'fail-fast with clear errors' }
346
+ }),
347
+ confidence: 0.95,
348
+ // ...
349
+ });
350
+ ```
351
+
352
+ ### Multi-Domain Learning
353
+
354
+ Transfer learning across domains:
355
+
356
+ ```typescript
357
+ // Learn from backend optimization
358
+ const backendExperience = await rb.retrieveWithReasoning(embedding, {
359
+ domain: 'backend-optimization',
360
+ k: 10,
361
+ });
362
+
363
+ // Apply to frontend optimization
364
+ const transferredKnowledge = backendExperience.memories.map(mem => ({
365
+ ...mem,
366
+ domain: 'frontend-optimization',
367
+ adapted: true,
368
+ }));
369
+ ```
370
+
371
+ ---
372
+
373
+ ## CLI Operations
374
+
375
+ ### Database Management
376
+
377
+ ```bash
378
+ # Export trajectories and patterns
379
+ npx agentdb@latest export ./.agentdb/reasoningbank.db ./backup.json
380
+
381
+ # Import experiences
382
+ npx agentdb@latest import ./experiences.json
383
+
384
+ # Get statistics
385
+ npx agentdb@latest stats ./.agentdb/reasoningbank.db
386
+ # Shows: total patterns, domains, confidence distribution
387
+ ```
388
+
389
+ ### Migration
390
+
391
+ ```bash
392
+ # Migrate from legacy ReasoningBank
393
+ npx agentdb@latest migrate --source .swarm/memory.db --target .agentdb/reasoningbank.db
394
+
395
+ # Validate migration
396
+ npx agentdb@latest stats .agentdb/reasoningbank.db
397
+ ```
398
+
399
+ ---
400
+
401
+ ## Troubleshooting
402
+
403
+ ### Issue: Migration fails
404
+ ```bash
405
+ # Check source database exists
406
+ ls -la .swarm/memory.db
407
+
408
+ # Run with verbose logging
409
+ DEBUG=agentdb:* npx agentdb@latest migrate --source .swarm/memory.db
410
+ ```
411
+
412
+ ### Issue: Low confidence scores
413
+ ```typescript
414
+ // Enable context synthesis for better quality
415
+ const result = await rb.retrieveWithReasoning(embedding, {
416
+ synthesizeContext: true,
417
+ useMMR: true,
418
+ k: 10,
419
+ });
420
+ ```
421
+
422
+ ### Issue: Memory growing too large
423
+ ```typescript
424
+ // Enable automatic optimization
425
+ const result = await rb.retrieveWithReasoning(embedding, {
426
+ optimizeMemory: true, // Consolidates similar patterns
427
+ });
428
+
429
+ // Or manually optimize
430
+ await rb.optimize();
431
+ ```
432
+
433
+ ---
434
+
435
+ ## Learn More
436
+
437
+ - **AgentDB Integration**: node_modules/agentic-flow/docs/AGENTDB_INTEGRATION.md
438
+ - **GitHub**: https://github.com/ruvnet/agentic-flow/tree/main/packages/agentdb
439
+ - **MCP Integration**: `npx agentdb@latest mcp`
440
+ - **Website**: https://agentdb.ruv.io
441
+
442
+ ---
443
+
444
+ **Category**: Machine Learning / Reinforcement Learning
445
+ **Difficulty**: Intermediate
446
+ **Estimated Time**: 20-30 minutes