claude-flow 3.25.5 → 3.26.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 (312) hide show
  1. package/.claude/helpers/.helpers-version +1 -1
  2. package/.claude/helpers/helpers.manifest.json +5 -4
  3. package/.claude/helpers/hook-handler.cjs +129 -0
  4. package/.claude/helpers/statusline.cjs +300 -123
  5. package/.claude/proven-config.json +1 -1
  6. package/.claude/security-scans/scan-all-standard.json +321 -0
  7. package/.claude/security-scans/scan-code-deep.json +1209 -0
  8. package/.claude/security-scans/scan-deps-full.json +14 -0
  9. package/package.json +3 -1
  10. package/v3/@claude-flow/cli/catalog-manifest.json +12 -0
  11. package/v3/@claude-flow/cli/dist/src/commands/advisor.d.ts +15 -0
  12. package/v3/@claude-flow/cli/dist/src/commands/advisor.js +94 -0
  13. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +151 -32
  14. package/v3/@claude-flow/cli/dist/src/commands/funnel.d.ts +13 -0
  15. package/v3/@claude-flow/cli/dist/src/commands/funnel.js +103 -0
  16. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +112 -46
  17. package/v3/@claude-flow/cli/dist/src/commands/index.js +10 -0
  18. package/v3/@claude-flow/cli/dist/src/commands/init.js +44 -0
  19. package/v3/@claude-flow/cli/dist/src/commands/proxy.d.ts +21 -0
  20. package/v3/@claude-flow/cli/dist/src/commands/proxy.js +310 -0
  21. package/v3/@claude-flow/cli/dist/src/commands/security.js +29 -0
  22. package/v3/@claude-flow/cli/dist/src/commands/settings.d.ts +19 -0
  23. package/v3/@claude-flow/cli/dist/src/commands/settings.js +180 -0
  24. package/v3/@claude-flow/cli/dist/src/commands/version.d.ts +42 -0
  25. package/v3/@claude-flow/cli/dist/src/commands/version.js +106 -0
  26. package/v3/@claude-flow/cli/dist/src/funnel/advisor-tip.d.ts +58 -0
  27. package/v3/@claude-flow/cli/dist/src/funnel/advisor-tip.js +92 -0
  28. package/v3/@claude-flow/cli/dist/src/funnel/attribution.d.ts +37 -0
  29. package/v3/@claude-flow/cli/dist/src/funnel/attribution.js +101 -0
  30. package/v3/@claude-flow/cli/dist/src/funnel/consent.d.ts +22 -0
  31. package/v3/@claude-flow/cli/dist/src/funnel/consent.js +55 -0
  32. package/v3/@claude-flow/cli/dist/src/funnel/credit-errors.d.ts +31 -0
  33. package/v3/@claude-flow/cli/dist/src/funnel/credit-errors.js +88 -0
  34. package/v3/@claude-flow/cli/dist/src/funnel/credit-notifier.d.ts +44 -0
  35. package/v3/@claude-flow/cli/dist/src/funnel/credit-notifier.js +74 -0
  36. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.d.ts +46 -0
  37. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.js +97 -0
  38. package/v3/@claude-flow/cli/dist/src/funnel/enrollment.d.ts +36 -0
  39. package/v3/@claude-flow/cli/dist/src/funnel/enrollment.js +64 -0
  40. package/v3/@claude-flow/cli/dist/src/funnel/environment.d.ts +17 -0
  41. package/v3/@claude-flow/cli/dist/src/funnel/environment.js +39 -0
  42. package/v3/@claude-flow/cli/dist/src/funnel/event-transport.d.ts +51 -0
  43. package/v3/@claude-flow/cli/dist/src/funnel/event-transport.js +199 -0
  44. package/v3/@claude-flow/cli/dist/src/funnel/events.d.ts +42 -0
  45. package/v3/@claude-flow/cli/dist/src/funnel/events.js +150 -0
  46. package/v3/@claude-flow/cli/dist/src/funnel/index.d.ts +20 -0
  47. package/v3/@claude-flow/cli/dist/src/funnel/index.js +20 -0
  48. package/v3/@claude-flow/cli/dist/src/funnel/insights.d.ts +49 -0
  49. package/v3/@claude-flow/cli/dist/src/funnel/insights.js +120 -0
  50. package/v3/@claude-flow/cli/dist/src/funnel/local-signals.d.ts +15 -0
  51. package/v3/@claude-flow/cli/dist/src/funnel/local-signals.js +68 -0
  52. package/v3/@claude-flow/cli/dist/src/funnel/message-transport.d.ts +51 -0
  53. package/v3/@claude-flow/cli/dist/src/funnel/message-transport.js +149 -0
  54. package/v3/@claude-flow/cli/dist/src/funnel/messages.d.ts +55 -0
  55. package/v3/@claude-flow/cli/dist/src/funnel/messages.js +160 -0
  56. package/v3/@claude-flow/cli/dist/src/funnel/power-saver-notifier.d.ts +44 -0
  57. package/v3/@claude-flow/cli/dist/src/funnel/power-saver-notifier.js +92 -0
  58. package/v3/@claude-flow/cli/dist/src/funnel/precedence.d.ts +16 -0
  59. package/v3/@claude-flow/cli/dist/src/funnel/precedence.js +85 -0
  60. package/v3/@claude-flow/cli/dist/src/funnel/promo.d.ts +41 -0
  61. package/v3/@claude-flow/cli/dist/src/funnel/promo.js +144 -0
  62. package/v3/@claude-flow/cli/dist/src/funnel/rate-limit-notifier.d.ts +55 -0
  63. package/v3/@claude-flow/cli/dist/src/funnel/rate-limit-notifier.js +102 -0
  64. package/v3/@claude-flow/cli/dist/src/funnel/rotation.d.ts +19 -0
  65. package/v3/@claude-flow/cli/dist/src/funnel/rotation.js +70 -0
  66. package/v3/@claude-flow/cli/dist/src/funnel/state.d.ts +13 -0
  67. package/v3/@claude-flow/cli/dist/src/funnel/state.js +52 -0
  68. package/v3/@claude-flow/cli/dist/src/funnel/toggle-cooldown.d.ts +17 -0
  69. package/v3/@claude-flow/cli/dist/src/funnel/toggle-cooldown.js +32 -0
  70. package/v3/@claude-flow/cli/dist/src/funnel/types.d.ts +86 -0
  71. package/v3/@claude-flow/cli/dist/src/funnel/types.js +26 -0
  72. package/v3/@claude-flow/cli/dist/src/init/executor.js +25 -19
  73. package/v3/@claude-flow/cli/dist/src/init/helper-refresh.d.ts +33 -2
  74. package/v3/@claude-flow/cli/dist/src/init/helper-refresh.js +102 -12
  75. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +52 -0
  76. package/v3/@claude-flow/cli/dist/src/init/mcp-generator.js +11 -6
  77. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +282 -116
  78. package/v3/@claude-flow/cli/dist/src/services/daemon-autostart.js +28 -5
  79. package/v3/@claude-flow/cli/dist/src/services/fable-harness.d.ts +39 -0
  80. package/v3/@claude-flow/cli/dist/src/services/fable-harness.js +41 -0
  81. package/v3/@claude-flow/cli/package.json +16 -4
  82. package/v3/README.md +493 -0
  83. package/.claude/coordinator/config.json +0 -24
  84. package/.claude/coordinator/state.json +0 -37
  85. package/.claude/coordinator/tick-log/tick-01.json +0 -17
  86. package/.claude/coordinator/tick-log/tick-02.json +0 -17
  87. package/.claude/coordinator/tick-log/tick-03.json +0 -17
  88. package/.claude/coordinator/tick-log/tick-04.json +0 -14
  89. package/.claude/coordinator/tick-log/tick-05.json +0 -16
  90. package/.claude/settings.local.json +0 -11
  91. package/v3/@claude-flow/cli/dist/src/ruvector/lattice-wasm.d.ts +0 -14
  92. package/v3/@claude-flow/cli/dist/src/ruvector/lattice-wasm.js +0 -144
  93. package/v3/@claude-flow/guidance/dist/adversarial.d.ts +0 -284
  94. package/v3/@claude-flow/guidance/dist/adversarial.js +0 -572
  95. package/v3/@claude-flow/guidance/dist/analyzer.d.ts +0 -530
  96. package/v3/@claude-flow/guidance/dist/analyzer.js +0 -2587
  97. package/v3/@claude-flow/guidance/dist/artifacts.d.ts +0 -283
  98. package/v3/@claude-flow/guidance/dist/artifacts.js +0 -356
  99. package/v3/@claude-flow/guidance/dist/authority.d.ts +0 -290
  100. package/v3/@claude-flow/guidance/dist/authority.js +0 -558
  101. package/v3/@claude-flow/guidance/dist/capabilities.d.ts +0 -209
  102. package/v3/@claude-flow/guidance/dist/capabilities.js +0 -485
  103. package/v3/@claude-flow/guidance/dist/coherence.d.ts +0 -233
  104. package/v3/@claude-flow/guidance/dist/coherence.js +0 -372
  105. package/v3/@claude-flow/guidance/dist/compiler.d.ts +0 -87
  106. package/v3/@claude-flow/guidance/dist/compiler.js +0 -410
  107. package/v3/@claude-flow/guidance/dist/conformance-kit.d.ts +0 -225
  108. package/v3/@claude-flow/guidance/dist/conformance-kit.js +0 -629
  109. package/v3/@claude-flow/guidance/dist/continue-gate.d.ts +0 -214
  110. package/v3/@claude-flow/guidance/dist/continue-gate.js +0 -353
  111. package/v3/@claude-flow/guidance/dist/crypto-utils.d.ts +0 -17
  112. package/v3/@claude-flow/guidance/dist/crypto-utils.js +0 -24
  113. package/v3/@claude-flow/guidance/dist/evolution.d.ts +0 -282
  114. package/v3/@claude-flow/guidance/dist/evolution.js +0 -500
  115. package/v3/@claude-flow/guidance/dist/gates.d.ts +0 -79
  116. package/v3/@claude-flow/guidance/dist/gates.js +0 -302
  117. package/v3/@claude-flow/guidance/dist/gateway.d.ts +0 -206
  118. package/v3/@claude-flow/guidance/dist/gateway.js +0 -452
  119. package/v3/@claude-flow/guidance/dist/generators.d.ts +0 -153
  120. package/v3/@claude-flow/guidance/dist/generators.js +0 -682
  121. package/v3/@claude-flow/guidance/dist/headless.d.ts +0 -177
  122. package/v3/@claude-flow/guidance/dist/headless.js +0 -342
  123. package/v3/@claude-flow/guidance/dist/hooks.d.ts +0 -109
  124. package/v3/@claude-flow/guidance/dist/hooks.js +0 -347
  125. package/v3/@claude-flow/guidance/dist/index.d.ts +0 -205
  126. package/v3/@claude-flow/guidance/dist/index.js +0 -321
  127. package/v3/@claude-flow/guidance/dist/ledger.d.ts +0 -162
  128. package/v3/@claude-flow/guidance/dist/ledger.js +0 -375
  129. package/v3/@claude-flow/guidance/dist/manifest-validator.d.ts +0 -289
  130. package/v3/@claude-flow/guidance/dist/manifest-validator.js +0 -838
  131. package/v3/@claude-flow/guidance/dist/memory-gate.d.ts +0 -222
  132. package/v3/@claude-flow/guidance/dist/memory-gate.js +0 -382
  133. package/v3/@claude-flow/guidance/dist/meta-governance.d.ts +0 -265
  134. package/v3/@claude-flow/guidance/dist/meta-governance.js +0 -348
  135. package/v3/@claude-flow/guidance/dist/optimizer.d.ts +0 -104
  136. package/v3/@claude-flow/guidance/dist/optimizer.js +0 -329
  137. package/v3/@claude-flow/guidance/dist/persistence.d.ts +0 -189
  138. package/v3/@claude-flow/guidance/dist/persistence.js +0 -464
  139. package/v3/@claude-flow/guidance/dist/proof.d.ts +0 -185
  140. package/v3/@claude-flow/guidance/dist/proof.js +0 -238
  141. package/v3/@claude-flow/guidance/dist/retriever.d.ts +0 -172
  142. package/v3/@claude-flow/guidance/dist/retriever.js +0 -596
  143. package/v3/@claude-flow/guidance/dist/ruvbot-integration.d.ts +0 -370
  144. package/v3/@claude-flow/guidance/dist/ruvbot-integration.js +0 -738
  145. package/v3/@claude-flow/guidance/dist/temporal.d.ts +0 -426
  146. package/v3/@claude-flow/guidance/dist/temporal.js +0 -658
  147. package/v3/@claude-flow/guidance/dist/trust.d.ts +0 -283
  148. package/v3/@claude-flow/guidance/dist/trust.js +0 -473
  149. package/v3/@claude-flow/guidance/dist/truth-anchors.d.ts +0 -276
  150. package/v3/@claude-flow/guidance/dist/truth-anchors.js +0 -488
  151. package/v3/@claude-flow/guidance/dist/types.d.ts +0 -378
  152. package/v3/@claude-flow/guidance/dist/types.js +0 -10
  153. package/v3/@claude-flow/guidance/dist/uncertainty.d.ts +0 -372
  154. package/v3/@claude-flow/guidance/dist/uncertainty.js +0 -619
  155. package/v3/@claude-flow/guidance/dist/wasm-kernel.d.ts +0 -48
  156. package/v3/@claude-flow/guidance/dist/wasm-kernel.js +0 -158
  157. package/v3/@claude-flow/shared/dist/core/config/defaults.d.ts +0 -41
  158. package/v3/@claude-flow/shared/dist/core/config/defaults.js +0 -186
  159. package/v3/@claude-flow/shared/dist/core/config/index.d.ts +0 -8
  160. package/v3/@claude-flow/shared/dist/core/config/index.js +0 -12
  161. package/v3/@claude-flow/shared/dist/core/config/loader.d.ts +0 -45
  162. package/v3/@claude-flow/shared/dist/core/config/loader.js +0 -238
  163. package/v3/@claude-flow/shared/dist/core/config/schema.d.ts +0 -1728
  164. package/v3/@claude-flow/shared/dist/core/config/schema.js +0 -160
  165. package/v3/@claude-flow/shared/dist/core/config/validator.d.ts +0 -92
  166. package/v3/@claude-flow/shared/dist/core/config/validator.js +0 -147
  167. package/v3/@claude-flow/shared/dist/core/event-bus.d.ts +0 -31
  168. package/v3/@claude-flow/shared/dist/core/event-bus.js +0 -197
  169. package/v3/@claude-flow/shared/dist/core/index.d.ts +0 -15
  170. package/v3/@claude-flow/shared/dist/core/index.js +0 -19
  171. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +0 -200
  172. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.js +0 -6
  173. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +0 -310
  174. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +0 -7
  175. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +0 -224
  176. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.js +0 -46
  177. package/v3/@claude-flow/shared/dist/core/interfaces/index.d.ts +0 -10
  178. package/v3/@claude-flow/shared/dist/core/interfaces/index.js +0 -15
  179. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +0 -298
  180. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.js +0 -7
  181. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +0 -185
  182. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.js +0 -6
  183. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +0 -35
  184. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +0 -101
  185. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +0 -60
  186. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +0 -166
  187. package/v3/@claude-flow/shared/dist/core/orchestrator/index.d.ts +0 -46
  188. package/v3/@claude-flow/shared/dist/core/orchestrator/index.js +0 -64
  189. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +0 -56
  190. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +0 -195
  191. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +0 -83
  192. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.js +0 -193
  193. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +0 -49
  194. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.js +0 -253
  195. package/v3/@claude-flow/shared/dist/events/domain-events.d.ts +0 -282
  196. package/v3/@claude-flow/shared/dist/events/domain-events.js +0 -165
  197. package/v3/@claude-flow/shared/dist/events/event-store.d.ts +0 -126
  198. package/v3/@claude-flow/shared/dist/events/event-store.js +0 -427
  199. package/v3/@claude-flow/shared/dist/events/event-store.test.d.ts +0 -8
  200. package/v3/@claude-flow/shared/dist/events/event-store.test.js +0 -293
  201. package/v3/@claude-flow/shared/dist/events/example-usage.d.ts +0 -10
  202. package/v3/@claude-flow/shared/dist/events/example-usage.js +0 -193
  203. package/v3/@claude-flow/shared/dist/events/index.d.ts +0 -21
  204. package/v3/@claude-flow/shared/dist/events/index.js +0 -22
  205. package/v3/@claude-flow/shared/dist/events/projections.d.ts +0 -177
  206. package/v3/@claude-flow/shared/dist/events/projections.js +0 -421
  207. package/v3/@claude-flow/shared/dist/events/rvf-event-log.d.ts +0 -82
  208. package/v3/@claude-flow/shared/dist/events/rvf-event-log.js +0 -340
  209. package/v3/@claude-flow/shared/dist/events/state-reconstructor.d.ts +0 -101
  210. package/v3/@claude-flow/shared/dist/events/state-reconstructor.js +0 -263
  211. package/v3/@claude-flow/shared/dist/events.d.ts +0 -80
  212. package/v3/@claude-flow/shared/dist/events.js +0 -249
  213. package/v3/@claude-flow/shared/dist/hooks/example-usage.d.ts +0 -42
  214. package/v3/@claude-flow/shared/dist/hooks/example-usage.js +0 -351
  215. package/v3/@claude-flow/shared/dist/hooks/executor.d.ts +0 -100
  216. package/v3/@claude-flow/shared/dist/hooks/executor.js +0 -267
  217. package/v3/@claude-flow/shared/dist/hooks/hooks.test.d.ts +0 -9
  218. package/v3/@claude-flow/shared/dist/hooks/hooks.test.js +0 -322
  219. package/v3/@claude-flow/shared/dist/hooks/index.d.ts +0 -52
  220. package/v3/@claude-flow/shared/dist/hooks/index.js +0 -51
  221. package/v3/@claude-flow/shared/dist/hooks/registry.d.ts +0 -133
  222. package/v3/@claude-flow/shared/dist/hooks/registry.js +0 -277
  223. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +0 -105
  224. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.js +0 -481
  225. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +0 -144
  226. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.js +0 -328
  227. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +0 -158
  228. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +0 -450
  229. package/v3/@claude-flow/shared/dist/hooks/safety/index.d.ts +0 -17
  230. package/v3/@claude-flow/shared/dist/hooks/safety/index.js +0 -17
  231. package/v3/@claude-flow/shared/dist/hooks/session-hooks.d.ts +0 -234
  232. package/v3/@claude-flow/shared/dist/hooks/session-hooks.js +0 -334
  233. package/v3/@claude-flow/shared/dist/hooks/task-hooks.d.ts +0 -163
  234. package/v3/@claude-flow/shared/dist/hooks/task-hooks.js +0 -326
  235. package/v3/@claude-flow/shared/dist/hooks/types.d.ts +0 -267
  236. package/v3/@claude-flow/shared/dist/hooks/types.js +0 -62
  237. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +0 -9
  238. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.js +0 -93
  239. package/v3/@claude-flow/shared/dist/index.d.ts +0 -20
  240. package/v3/@claude-flow/shared/dist/index.js +0 -50
  241. package/v3/@claude-flow/shared/dist/mcp/connection-pool.d.ts +0 -98
  242. package/v3/@claude-flow/shared/dist/mcp/connection-pool.js +0 -364
  243. package/v3/@claude-flow/shared/dist/mcp/index.d.ts +0 -69
  244. package/v3/@claude-flow/shared/dist/mcp/index.js +0 -84
  245. package/v3/@claude-flow/shared/dist/mcp/server.d.ts +0 -166
  246. package/v3/@claude-flow/shared/dist/mcp/server.js +0 -590
  247. package/v3/@claude-flow/shared/dist/mcp/session-manager.d.ts +0 -136
  248. package/v3/@claude-flow/shared/dist/mcp/session-manager.js +0 -335
  249. package/v3/@claude-flow/shared/dist/mcp/tool-registry.d.ts +0 -178
  250. package/v3/@claude-flow/shared/dist/mcp/tool-registry.js +0 -439
  251. package/v3/@claude-flow/shared/dist/mcp/transport/http.d.ts +0 -104
  252. package/v3/@claude-flow/shared/dist/mcp/transport/http.js +0 -476
  253. package/v3/@claude-flow/shared/dist/mcp/transport/index.d.ts +0 -102
  254. package/v3/@claude-flow/shared/dist/mcp/transport/index.js +0 -238
  255. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +0 -104
  256. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.js +0 -263
  257. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +0 -133
  258. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.js +0 -396
  259. package/v3/@claude-flow/shared/dist/mcp/types.d.ts +0 -436
  260. package/v3/@claude-flow/shared/dist/mcp/types.js +0 -54
  261. package/v3/@claude-flow/shared/dist/plugin-interface.d.ts +0 -544
  262. package/v3/@claude-flow/shared/dist/plugin-interface.js +0 -23
  263. package/v3/@claude-flow/shared/dist/plugin-loader.d.ts +0 -139
  264. package/v3/@claude-flow/shared/dist/plugin-loader.js +0 -434
  265. package/v3/@claude-flow/shared/dist/plugin-registry.d.ts +0 -183
  266. package/v3/@claude-flow/shared/dist/plugin-registry.js +0 -457
  267. package/v3/@claude-flow/shared/dist/plugins/index.d.ts +0 -10
  268. package/v3/@claude-flow/shared/dist/plugins/index.js +0 -10
  269. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +0 -106
  270. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +0 -241
  271. package/v3/@claude-flow/shared/dist/plugins/official/index.d.ts +0 -10
  272. package/v3/@claude-flow/shared/dist/plugins/official/index.js +0 -10
  273. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +0 -121
  274. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +0 -355
  275. package/v3/@claude-flow/shared/dist/plugins/types.d.ts +0 -93
  276. package/v3/@claude-flow/shared/dist/plugins/types.js +0 -9
  277. package/v3/@claude-flow/shared/dist/resilience/bulkhead.d.ts +0 -105
  278. package/v3/@claude-flow/shared/dist/resilience/bulkhead.js +0 -206
  279. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +0 -132
  280. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.js +0 -233
  281. package/v3/@claude-flow/shared/dist/resilience/index.d.ts +0 -19
  282. package/v3/@claude-flow/shared/dist/resilience/index.js +0 -19
  283. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +0 -168
  284. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.js +0 -314
  285. package/v3/@claude-flow/shared/dist/resilience/retry.d.ts +0 -91
  286. package/v3/@claude-flow/shared/dist/resilience/retry.js +0 -159
  287. package/v3/@claude-flow/shared/dist/security/index.d.ts +0 -10
  288. package/v3/@claude-flow/shared/dist/security/index.js +0 -12
  289. package/v3/@claude-flow/shared/dist/security/input-validation.d.ts +0 -73
  290. package/v3/@claude-flow/shared/dist/security/input-validation.js +0 -201
  291. package/v3/@claude-flow/shared/dist/security/secure-random.d.ts +0 -92
  292. package/v3/@claude-flow/shared/dist/security/secure-random.js +0 -142
  293. package/v3/@claude-flow/shared/dist/services/index.d.ts +0 -7
  294. package/v3/@claude-flow/shared/dist/services/index.js +0 -7
  295. package/v3/@claude-flow/shared/dist/services/v3-progress.service.d.ts +0 -124
  296. package/v3/@claude-flow/shared/dist/services/v3-progress.service.js +0 -402
  297. package/v3/@claude-flow/shared/dist/types/agent.types.d.ts +0 -137
  298. package/v3/@claude-flow/shared/dist/types/agent.types.js +0 -6
  299. package/v3/@claude-flow/shared/dist/types/index.d.ts +0 -11
  300. package/v3/@claude-flow/shared/dist/types/index.js +0 -17
  301. package/v3/@claude-flow/shared/dist/types/mcp.types.d.ts +0 -266
  302. package/v3/@claude-flow/shared/dist/types/mcp.types.js +0 -7
  303. package/v3/@claude-flow/shared/dist/types/memory.types.d.ts +0 -236
  304. package/v3/@claude-flow/shared/dist/types/memory.types.js +0 -7
  305. package/v3/@claude-flow/shared/dist/types/swarm.types.d.ts +0 -186
  306. package/v3/@claude-flow/shared/dist/types/swarm.types.js +0 -65
  307. package/v3/@claude-flow/shared/dist/types/task.types.d.ts +0 -178
  308. package/v3/@claude-flow/shared/dist/types/task.types.js +0 -32
  309. package/v3/@claude-flow/shared/dist/types.d.ts +0 -197
  310. package/v3/@claude-flow/shared/dist/types.js +0 -21
  311. package/v3/@claude-flow/shared/dist/utils/secure-logger.d.ts +0 -69
  312. package/v3/@claude-flow/shared/dist/utils/secure-logger.js +0 -208
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@claude-flow/cli",
3
- "version": "3.25.5",
3
+ "version": "3.26.0",
4
4
  "type": "module",
5
5
  "description": "Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
6
6
  "main": "dist/src/index.js",
@@ -81,14 +81,18 @@
81
81
  "scripts/postinstall.cjs",
82
82
  ".claude",
83
83
  "plugins",
84
- "README.md"
84
+ "README.md",
85
+ "catalog-manifest.json"
85
86
  ],
86
87
  "scripts": {
87
88
  "build": "tsc",
88
89
  "test": "vitest run",
89
90
  "test:plugin-store": "npx tsx src/plugins/tests/standalone-test.ts",
90
91
  "test:pattern-store": "npx tsx src/transfer/store/tests/standalone-test.ts",
91
- "postinstall": "node ./scripts/postinstall.cjs"
92
+ "postinstall": "node ./scripts/postinstall.cjs",
93
+ "prepublishOnly": "cp ../../../README.md ./README.md && rm -rf plugins && mkdir -p plugins && cp -r ../../../plugins/ruflo-metaharness plugins/ && node scripts/generate-catalog-manifest.mjs && node scripts/sign-helpers.mjs && node scripts/verify-helpers.mjs",
94
+ "release": "npm version prerelease --preid=alpha && npm run publish:all",
95
+ "publish:all": "./scripts/publish.sh"
92
96
  },
93
97
  "devDependencies": {
94
98
  "typescript": "^5.3.0",
@@ -116,6 +120,14 @@
116
120
  "tag": "latest"
117
121
  },
118
122
  "overrides": {
119
- "protobufjs": ">=7.5.6"
123
+ "protobufjs": ">=7.5.6",
124
+ "js-yaml": ">=4.3.0",
125
+ "express": ">=4.22.2",
126
+ "qs": ">=6.15.2",
127
+ "@opentelemetry/core": ">=2.8.0",
128
+ "@opentelemetry/resources": ">=2.8.0",
129
+ "@opentelemetry/sdk-trace-base": ">=2.8.0",
130
+ "@opentelemetry/sdk-node": ">=0.220.0",
131
+ "agentdb": "$agentdb"
120
132
  }
121
133
  }
package/v3/README.md ADDED
@@ -0,0 +1,493 @@
1
+ # Claude Flow V3
2
+
3
+ > **Modular AI Agent Coordination System** - A complete reimagining of Claude-Flow with 15-agent hierarchical mesh swarm coordination.
4
+
5
+ [![Version](https://img.shields.io/badge/version-3.0.0--alpha.1-blue.svg)](https://github.com/ruvnet/claude-flow)
6
+ [![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-green.svg)](https://nodejs.org/)
7
+ [![TypeScript](https://img.shields.io/badge/TypeScript-5.3+-blue.svg)](https://www.typescriptlang.org/)
8
+ [![License](https://img.shields.io/badge/license-MIT-purple.svg)](../LICENSE)
9
+
10
+ ## Introduction
11
+
12
+ Claude Flow V3 is a next-generation AI agent coordination system built on 10 Architecture Decision Records (ADRs). It provides a modular, security-first, high-performance platform for orchestrating multi-agent swarms with hierarchical mesh topology.
13
+
14
+ V3 represents a complete architectural overhaul:
15
+ - **10x faster testing** with Vitest
16
+ - **150x-12,500x faster search** with HNSW indexing
17
+ - **2.49x-7.47x Flash Attention speedup**
18
+ - **50-75% memory reduction**
19
+
20
+ ## Features
21
+
22
+ ### Core Capabilities
23
+
24
+ - **15-Agent Hierarchical Mesh** - Queen-led coordination with specialized worker agents
25
+ - **Domain-Driven Design** - Clean bounded contexts with separation of concerns
26
+ - **Plugin Architecture** - Microkernel pattern for extensibility
27
+ - **MCP-First API** - Consistent interfaces across all modules
28
+ - **Event Sourcing** - Full audit trail for state changes
29
+ - **Hybrid Memory Backend** - SQLite + AgentDB for optimal performance
30
+
31
+ ### Security
32
+
33
+ - **CVE Remediation** - All known vulnerabilities addressed
34
+ - **Input Validation** - Zod-based schema validation
35
+ - **Secure ID Generation** - Cryptographic random IDs
36
+ - **Path Security** - Traversal protection
37
+ - **SQL Injection Prevention** - Parameterized queries
38
+
39
+ ### Performance
40
+
41
+ | Metric | Target | Achieved |
42
+ |--------|--------|----------|
43
+ | Event Bus (100k events) | <50ms | ~6ms |
44
+ | Map Lookup (100k gets) | <20ms | ~16ms |
45
+ | Array.find vs Map O(1) | N/A | 978x speedup |
46
+ | Flash Attention | 2.49x-7.47x | Validated |
47
+ | AgentDB Search | 150x-12,500x | HNSW indexed |
48
+
49
+ ## Architecture
50
+
51
+ ### Architecture Decision Records (ADRs)
52
+
53
+ | ADR | Decision |
54
+ |-----|----------|
55
+ | ADR-001 | Adopt agentic-flow as core foundation |
56
+ | ADR-002 | Domain-Driven Design structure |
57
+ | ADR-003 | Single coordination engine (UnifiedSwarmCoordinator) |
58
+ | ADR-004 | Plugin-based architecture (microkernel) |
59
+ | ADR-005 | MCP-first API design |
60
+ | ADR-006 | Unified memory service (AgentDB) |
61
+ | ADR-007 | Event sourcing for state changes |
62
+ | ADR-008 | Vitest over Jest (10x faster) |
63
+ | ADR-009 | Hybrid memory backend default |
64
+ | ADR-010 | Remove Deno support (Node.js 20+ only) |
65
+
66
+ ### Module Architecture
67
+
68
+ ```
69
+ ┌─────────────────────────────────────────────────────────────────┐
70
+ │ @claude-flow/v3-monorepo │
71
+ ├─────────────────────────────────────────────────────────────────┤
72
+ │ │
73
+ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
74
+ │ │ security │ │ memory │ │ swarm │ │
75
+ │ │ CVE fixes │ │ AgentDB │ │ 15-agent │ │
76
+ │ │ validation │ │ HNSW │ │ coordination │ │
77
+ │ └──────────────┘ └──────────────┘ └──────────────┘ │
78
+ │ │
79
+ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
80
+ │ │ integration │ │ performance │ │ neural │ │
81
+ │ │ agentic-flow │ │ Flash Attn │ │ SONA │ │
82
+ │ │ bridge │ │ benchmarks │ │ learning │ │
83
+ │ └──────────────┘ └──────────────┘ └──────────────┘ │
84
+ │ │
85
+ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
86
+ │ │ cli │ │ testing │ │ deployment │ │
87
+ │ │ commands │ │ TDD London │ │ release │ │
88
+ │ │ prompts │ │ School │ │ CI/CD │ │
89
+ │ └──────────────┘ └──────────────┘ └──────────────┘ │
90
+ │ │
91
+ │ ┌─────────────────────────────────────────────────────────┐ │
92
+ │ │ shared │ │
93
+ │ │ types • events • core • hooks • resilience • plugins │ │
94
+ │ └─────────────────────────────────────────────────────────┘ │
95
+ │ │
96
+ └─────────────────────────────────────────────────────────────────┘
97
+ ```
98
+
99
+ ## Directory Structure
100
+
101
+ ```
102
+ v3/
103
+ ├── @claude-flow/ # Modular packages
104
+ │ ├── security/ # Security module
105
+ │ │ └── src/
106
+ │ │ ├── index.ts # Password hashing, validators
107
+ │ │ └── ...
108
+ │ │
109
+ │ ├── memory/ # Memory module
110
+ │ │ ├── src/
111
+ │ │ │ ├── agentdb-backend.ts # AgentDB integration
112
+ │ │ │ ├── hnsw-index.ts # HNSW vector indexing
113
+ │ │ │ ├── hybrid-backend.ts # SQLite + AgentDB
114
+ │ │ │ ├── sqlite-backend.ts # SQLite backend
115
+ │ │ │ ├── cache-manager.ts # Caching layer
116
+ │ │ │ └── domain/ # DDD entities
117
+ │ │ ├── benchmarks/ # Performance benchmarks
118
+ │ │ └── examples/ # Usage examples
119
+ │ │
120
+ │ ├── swarm/ # Swarm coordination
121
+ │ │ └── src/
122
+ │ │ ├── unified-coordinator.ts # Main coordinator
123
+ │ │ ├── topology-manager.ts # Topology management
124
+ │ │ ├── consensus/ # Consensus protocols
125
+ │ │ └── domain/ # DDD entities
126
+ │ │
127
+ │ ├── integration/ # agentic-flow integration
128
+ │ │ └── src/
129
+ │ │ ├── agentic-flow-bridge.ts # Core bridge
130
+ │ │ ├── agent-adapter.ts # Agent adaptation
131
+ │ │ └── sona-adapter.ts # SONA learning
132
+ │ │
133
+ │ ├── performance/ # Performance module
134
+ │ │ ├── src/
135
+ │ │ │ └── framework/ # Benchmark framework
136
+ │ │ └── benchmarks/
137
+ │ │ ├── startup/ # Startup benchmarks
138
+ │ │ └── attention/ # Flash Attention
139
+ │ │
140
+ │ ├── neural/ # Neural/SONA module
141
+ │ │ └── src/
142
+ │ │ ├── algorithms/ # Learning algorithms
143
+ │ │ └── modes/ # Neural modes
144
+ │ │
145
+ │ ├── cli/ # CLI module
146
+ │ │ ├── bin/ # Executable
147
+ │ │ └── src/
148
+ │ │ └── commands/ # Command handlers
149
+ │ │
150
+ │ ├── testing/ # Testing framework
151
+ │ │ └── src/
152
+ │ │ ├── fixtures/ # Test fixtures
153
+ │ │ ├── mocks/ # Mock services
154
+ │ │ ├── helpers/ # Test helpers
155
+ │ │ └── regression/ # Regression tests
156
+ │ │
157
+ │ ├── shared/ # Shared utilities
158
+ │ │ └── src/
159
+ │ │ ├── types/ # Shared types
160
+ │ │ ├── events/ # Event system
161
+ │ │ ├── core/ # Core interfaces
162
+ │ │ ├── hooks/ # Hook system
163
+ │ │ ├── resilience/ # Retry, circuit breaker
164
+ │ │ ├── plugins/ # Plugin system
165
+ │ │ └── security/ # Security utilities
166
+ │ │
167
+ │ └── deployment/ # Deployment module
168
+ │ └── src/ # Release management
169
+ │
170
+ ├── mcp/ # MCP Server
171
+ │ ├── server.ts # Main server
172
+ │ ├── tools/ # MCP tools
173
+ │ │ ├── agent-tools.ts
174
+ │ │ ├── swarm-tools.ts
175
+ │ │ ├── memory-tools.ts
176
+ │ │ └── hooks-tools.ts
177
+ │ └── transport/ # Transport layers
178
+ │ ├── stdio.ts
179
+ │ ├── http.ts
180
+ │ └── websocket.ts
181
+ │
182
+ ├── __tests__/ # Integration tests
183
+ │ └── integration/
184
+ │ ├── memory-integration.test.ts
185
+ │ ├── swarm-integration.test.ts
186
+ │ ├── mcp-integration.test.ts
187
+ │ └── workflow-integration.test.ts
188
+ │
189
+ ├── docs/ # Documentation
190
+ │ ├── README.md # Docs overview
191
+ │ ├── guides/ # User guides
192
+ │ └── implementation/ # Implementation details
193
+ │
194
+ ├── helpers/ # Cross-platform helpers
195
+ │ ├── claude-flow-v3.sh # Master helper (Linux/macOS)
196
+ │ ├── claude-flow-v3.ps1 # Master helper (Windows)
197
+ │ └── templates/ # Helper templates
198
+ │
199
+ ├── scripts/ # Utility scripts
200
+ │ └── quick-benchmark.mjs # Quick perf test
201
+ │
202
+ ├── index.ts # Main entry point
203
+ ├── swarm.config.ts # Swarm configuration
204
+ ├── vitest.config.ts # Test configuration
205
+ └── package.json # Monorepo package
206
+ ```
207
+
208
+ ## Modules
209
+
210
+ ### @claude-flow/security
211
+ Security-first implementation with CVE fixes, input validation, and credential management.
212
+
213
+ ```typescript
214
+ import { PasswordHasher, validateInput, sanitizePath } from '@claude-flow/security';
215
+
216
+ const hasher = new PasswordHasher();
217
+ const hash = await hasher.hash('password');
218
+ const valid = await hasher.verify('password', hash);
219
+ ```
220
+
221
+ ### @claude-flow/memory
222
+ Unified memory service with AgentDB, HNSW indexing, and 150x-12,500x faster search.
223
+
224
+ ```typescript
225
+ import { HybridMemoryRepository, HNSWIndex } from '@claude-flow/memory';
226
+
227
+ const memory = new HybridMemoryRepository({
228
+ backend: 'agentdb',
229
+ vectorSearch: true
230
+ });
231
+
232
+ await memory.store({ key: 'knowledge', value: 'context', embedding: [...] });
233
+ const results = await memory.search({ query: 'knowledge', limit: 10 });
234
+ ```
235
+
236
+ ### @claude-flow/swarm
237
+ 15-agent hierarchical mesh coordination with consensus protocols.
238
+
239
+ ```typescript
240
+ import { UnifiedSwarmCoordinator } from '@claude-flow/swarm';
241
+
242
+ const coordinator = new UnifiedSwarmCoordinator({
243
+ topology: 'hierarchical-mesh',
244
+ maxAgents: 15
245
+ });
246
+
247
+ await coordinator.initialize();
248
+ await coordinator.spawnAgent({ type: 'queen-coordinator' });
249
+ ```
250
+
251
+ ### @claude-flow/integration
252
+ Deep integration with agentic-flow@alpha per ADR-001.
253
+
254
+ ```typescript
255
+ import { AgenticFlowBridge } from '@claude-flow/integration';
256
+
257
+ const bridge = new AgenticFlowBridge();
258
+ await bridge.initialize();
259
+ const agent = await bridge.createAgent({ type: 'coder' });
260
+ ```
261
+
262
+ ### @claude-flow/performance
263
+ Benchmarking framework with Flash Attention validation.
264
+
265
+ ```typescript
266
+ import { BenchmarkRunner, formatTime } from '@claude-flow/performance';
267
+
268
+ const runner = new BenchmarkRunner();
269
+ const result = await runner.run('map-lookup', () => map.get(key), {
270
+ iterations: 100000,
271
+ targetTime: 20
272
+ });
273
+ ```
274
+
275
+ ### @claude-flow/neural
276
+ SONA learning integration for self-optimizing agents.
277
+
278
+ ```typescript
279
+ import { SONAAdapter } from '@claude-flow/neural';
280
+
281
+ const sona = new SONAAdapter();
282
+ await sona.train({ patterns: learningData });
283
+ const prediction = await sona.predict(context);
284
+ ```
285
+
286
+ ### @claude-flow/cli
287
+ Modern CLI with interactive prompts and formatted output.
288
+
289
+ ```bash
290
+ npx @claude-flow/cli swarm init --topology hierarchical-mesh
291
+ npx @claude-flow/cli agent spawn --type queen-coordinator
292
+ npx @claude-flow/cli memory search "knowledge"
293
+ ```
294
+
295
+ ### @claude-flow/testing
296
+ TDD London School framework with mocks, fixtures, and regression testing.
297
+
298
+ ```typescript
299
+ import { createMockAgent, createTestFixture } from '@claude-flow/testing';
300
+
301
+ const mockAgent = createMockAgent({ type: 'coder' });
302
+ const fixture = createTestFixture('swarm-coordination');
303
+ ```
304
+
305
+ ### @claude-flow/shared
306
+ Common types, events, utilities, and core interfaces.
307
+
308
+ ```typescript
309
+ import { EventBus, Result, success, failure } from '@claude-flow/shared';
310
+ import type { AgentId, TaskStatus } from '@claude-flow/shared/types';
311
+ ```
312
+
313
+ ### @claude-flow/deployment
314
+ Release management and CI/CD automation.
315
+
316
+ ```typescript
317
+ import { ReleaseManager } from '@claude-flow/deployment';
318
+
319
+ const release = new ReleaseManager();
320
+ await release.prepare({ version: '3.0.0', changelog: '...' });
321
+ ```
322
+
323
+ ## Usage
324
+
325
+ ### Quick Start
326
+
327
+ ```typescript
328
+ import { initializeV3Swarm } from '@claude-flow/v3';
329
+
330
+ // Initialize the swarm
331
+ const swarm = await initializeV3Swarm();
332
+
333
+ // Spawn agents
334
+ await swarm.spawnAllAgents();
335
+
336
+ // Submit a task
337
+ const task = swarm.submitTask({
338
+ type: 'implementation',
339
+ title: 'Implement feature X',
340
+ description: 'Detailed description...',
341
+ domain: 'core',
342
+ phase: 'phase-2-core',
343
+ priority: 'high'
344
+ });
345
+
346
+ // Wait for completion
347
+ const result = await swarm.waitForTask(task.id);
348
+ ```
349
+
350
+ ### Import Specific Modules
351
+
352
+ ```typescript
353
+ // Import everything
354
+ import * as claudeFlow from '@claude-flow/v3';
355
+
356
+ // Or import specific modules for tree-shaking
357
+ import { UnifiedSwarmCoordinator } from '@claude-flow/swarm';
358
+ import { PasswordHasher } from '@claude-flow/security';
359
+ import { HNSWIndex } from '@claude-flow/memory';
360
+ ```
361
+
362
+ ### MCP Server
363
+
364
+ ```typescript
365
+ import { createMCPServer } from '@claude-flow/v3/mcp';
366
+
367
+ const server = createMCPServer({
368
+ transport: 'stdio',
369
+ tools: ['agent', 'swarm', 'memory', 'hooks']
370
+ });
371
+
372
+ await server.start();
373
+ ```
374
+
375
+ ## Helper System
376
+
377
+ Cross-platform automation for V3 development:
378
+
379
+ ```bash
380
+ # Linux/macOS
381
+ ./helpers/claude-flow-v3.sh init
382
+ ./helpers/claude-flow-v3.sh status
383
+ ./helpers/claude-flow-v3.sh update domain 3
384
+
385
+ # Windows (PowerShell)
386
+ .\helpers\claude-flow-v3.ps1 init
387
+ .\helpers\claude-flow-v3.ps1 status
388
+ .\helpers\claude-flow-v3.ps1 update domain 3
389
+ ```
390
+
391
+ Features:
392
+ - **Progress Tracking**: Real-time domain/agent/performance metrics
393
+ - **Checkpointing**: Auto-commit with development milestones
394
+ - **Validation**: Environment and configuration verification
395
+ - **GitHub Integration**: PR management and issue tracking
396
+
397
+ ## Installation
398
+
399
+ ```bash
400
+ # Clone the repository
401
+ git clone https://github.com/ruvnet/claude-flow.git
402
+ cd claude-flow/v3
403
+
404
+ # Install dependencies
405
+ pnpm install
406
+
407
+ # Build all modules
408
+ pnpm build
409
+ ```
410
+
411
+ ## Testing
412
+
413
+ ```bash
414
+ # Run all tests
415
+ pnpm test
416
+
417
+ # Run integration tests
418
+ pnpm test:integration
419
+
420
+ # Run specific module tests
421
+ pnpm test:memory
422
+ pnpm test:swarm
423
+ pnpm test:security
424
+
425
+ # Run benchmarks
426
+ pnpm bench
427
+
428
+ # Quick benchmark (no dependencies)
429
+ node scripts/quick-benchmark.mjs
430
+
431
+ # Coverage report
432
+ pnpm test:coverage
433
+ ```
434
+
435
+ ## Performance Targets
436
+
437
+ | Category | Metric | Target |
438
+ |----------|--------|--------|
439
+ | **Search** | AgentDB HNSW | 150x-12,500x faster |
440
+ | **Attention** | Flash Attention | 2.49x-7.47x speedup |
441
+ | **Memory** | Reduction | 50-75% |
442
+ | **Code** | Total lines | <5,000 |
443
+ | **Startup** | Cold start | <500ms |
444
+ | **Learning** | SONA adaptation | <0.05ms |
445
+
446
+ ## Links
447
+
448
+ ### Documentation
449
+ - [Docs Overview](./docs/README.md)
450
+ - [Implementation Details](./docs/implementation/)
451
+ - [User Guides](./docs/guides/)
452
+ - [Helper System](./helpers/README.md)
453
+
454
+ ### Modules
455
+ - [@claude-flow/security](./@claude-flow/security/)
456
+ - [@claude-flow/memory](./@claude-flow/memory/)
457
+ - [@claude-flow/swarm](./@claude-flow/swarm/)
458
+ - [@claude-flow/integration](./@claude-flow/integration/)
459
+ - [@claude-flow/performance](./@claude-flow/performance/)
460
+ - [@claude-flow/neural](./@claude-flow/neural/)
461
+ - [@claude-flow/cli](./@claude-flow/cli/)
462
+ - [@claude-flow/testing](./@claude-flow/testing/)
463
+ - [@claude-flow/shared](./@claude-flow/shared/)
464
+ - [@claude-flow/deployment](./@claude-flow/deployment/)
465
+
466
+ ### Examples
467
+ - [AgentDB Example](./@claude-flow/memory/examples/agentdb-example.ts)
468
+ - [Cross-Platform Usage](./@claude-flow/memory/examples/cross-platform-usage.ts)
469
+
470
+ ### MCP Tools
471
+ - [Agent Tools](./mcp/tools/agent-tools.ts)
472
+ - [Swarm Tools](./mcp/tools/swarm-tools.ts)
473
+ - [Memory Tools](./mcp/tools/memory-tools.ts)
474
+ - [Hooks Tools](./mcp/tools/hooks-tools.ts)
475
+
476
+ ### External
477
+ - [GitHub Repository](https://github.com/ruvnet/claude-flow)
478
+ - [agentic-flow Integration](https://github.com/ruvnet/agentic-flow)
479
+ - [AgentDB](https://github.com/ruvnet/agentdb)
480
+
481
+ ## Requirements
482
+
483
+ - **Node.js**: >=20.0.0
484
+ - **pnpm**: >=8.0.0
485
+ - **TypeScript**: >=5.3.0
486
+
487
+ ## License
488
+
489
+ MIT License - See [LICENSE](../LICENSE) for details.
490
+
491
+ ---
492
+
493
+ **Built with the SPARC methodology and 15-agent hierarchical mesh coordination.**
@@ -1,24 +0,0 @@
1
- {
2
- "version": "1.0",
3
- "startedAt": "2026-07-08T02:30:00Z",
4
- "policy": "full-autopilot",
5
- "safety": {
6
- "requireCiGreen": true,
7
- "requireNoConflict": true,
8
- "requireIdleHours": 0,
9
- "maxTicks": 30,
10
- "tickIntervalSeconds": 600,
11
- "excludeIfCodeownersBlock": true
12
- },
13
- "targetPRs": [
14
- {"num": 2517, "adr": null, "cluster": "security", "grade": "A", "note": "AgentDB retrieval poisoning 93-100% ASR"},
15
- {"num": 2537, "adr": null, "cluster": "memory", "grade": "B", "note": "AutoMem RL loop — needs ADR renumber (collides w/ #2527 on 167)"},
16
- {"num": 2577, "adr": 176, "cluster": "performance", "grade": "A", "note": "PolyKV shared KV pool 97.7% reduction"},
17
- {"num": 2589, "adr": null, "cluster": "security", "grade": "A", "note": "VMG + RepE IPI — needs ADR renumber (collides w/ #2598 on 178)"},
18
- {"num": 2598, "adr": null, "cluster": "intelligence", "grade": "B", "note": "SkillRL — needs ADR renumber (collides w/ #2589 on 178)"}
19
- ],
20
- "adrCollisions": [
21
- {"conflictingPRs": [2589, 2598], "originalAdr": 178, "resolution": "earlier-wins", "reason": "2589 (dream 2026-07-06) beats 2598 (dream 2026-07-07)"},
22
- {"conflictingPRs": [2527, 2537], "originalAdr": 167, "resolution": "earlier-wins", "reason": "2527 (dream 2026-07-02) beats 2537 (dream 2026-07-03) — but 2527 not in scope so 2537 gets it if 2527 is also renumbered"}
23
- ]
24
- }
@@ -1,37 +0,0 @@
1
- {
2
- "tick": 5,
3
- "terminated": true,
4
- "terminationReason": "main-preexisting-red-cannot-autopilot",
5
- "closed": [],
6
- "merged": [2589],
7
- "blocked": [2517, 2537, 2577, 2598],
8
- "adrAssignments": {
9
- "2517": 180,
10
- "2537": 181,
11
- "2577": 182,
12
- "2598": 183,
13
- "2589": 178
14
- },
15
- "routingWeights": {
16
- "parallel-renumber-adr": -1,
17
- "centralized-adr-pre-assign": 2,
18
- "convert-ready-when-green": 1,
19
- "single-action-per-tick": 1,
20
- "gh-pr-merge-admin-squash": 1,
21
- "rebase-onto-main-when-shared-blocker": 2,
22
- "force-remove-stale-worktree": 1,
23
- "inline-fix-when-workflow-stalls": 1,
24
- "diagnose-main-before-per-pr-fix": 3,
25
- "terminate-loop-when-main-red-and-not-caused-by-scope": 2
26
- },
27
- "cumulativeReward": 14,
28
- "ticksSpent": 5,
29
- "completedAt": "2026-07-08T03:15:00Z",
30
- "achievements": [
31
- "Landed PR #2589 (security VMG+RepE IPI) — first dream merge in weeks",
32
- "Resolved 4 ADR-number collisions (178/180/181/182/183) that had built up across in-flight dreams",
33
- "Rebased 4 stale dream branches onto main to inherit v3.25.3 fixes",
34
- "Learned + persisted routing weights via 5 tick cycles"
35
- ],
36
- "handoff": "Main has 7 preexisting failing checks (Build V3 all platforms, Witness verify all platforms, graph schema smoke ADR-130 P1). All 4 remaining PRs (#2517, #2537, #2577, #2598) are draft=false + mergeable + at latest ADR numbers + rebased to main tip. They will auto-merge via a re-fired coordinator OR via `gh pr merge --admin --squash` once main goes green. Recommendation: file a `fix/main-v3-ci-red` triage issue first, unblock main, then re-fire the coordinator with `/loop 10m` OR merge the 4 PRs manually with --admin since they only add ADR markdown."
37
- }
@@ -1,17 +0,0 @@
1
- {
2
- "tick": 1,
3
- "completedAt": "2026-07-08T02:33:00Z",
4
- "durationSeconds": 141,
5
- "assessed": 5,
6
- "advanced": 5,
7
- "merged": 0,
8
- "renumbered": 4,
9
- "readyForCi": 1,
10
- "totalReward": 5,
11
- "coordinatorMistake": {
12
- "type": "parallel-race-adr-allocation",
13
- "description": "4 independent assessors each picked ADR-180 as next-free. Result: 4 PRs now all claim ADR-180.",
14
- "affectedPRs": [2517, 2537, 2577, 2598]
15
- },
16
- "lessonLearned": "Future ticks: PRE-ASSIGN ADR numbers centrally before fanning out. Never let parallel agents pick numbers independently."
17
- }
@@ -1,17 +0,0 @@
1
- {
2
- "tick": 2,
3
- "completedAt": "2026-07-08T02:36:00Z",
4
- "durationSeconds": 106,
5
- "collisionFixesSucceeded": 3,
6
- "advancesSucceeded": 2,
7
- "mergedThisTick": [2589],
8
- "renumberedThisTick": [
9
- {"pr": 2537, "adr": 181},
10
- {"pr": 2577, "adr": 182},
11
- {"pr": 2598, "adr": 183}
12
- ],
13
- "ciRunningThisTick": [2517],
14
- "totalReward": 5,
15
- "cumulativeReward": 10,
16
- "lesson": "Central pre-assignment resolved the parallel-race collision that tick 1 created. Reward pattern confirms centralized-adr-pre-assign > parallel-renumber-adr."
17
- }
@@ -1,17 +0,0 @@
1
- {
2
- "tick": 3,
3
- "completedAt": "2026-07-08T02:59:00Z",
4
- "durationSeconds": 69,
5
- "assessed": 4,
6
- "advanced": 0,
7
- "merged": 0,
8
- "totalReward": 0,
9
- "cumulativeReward": 10,
10
- "sharedBlocker": {
11
- "type": "old-base-missing-2578-fix",
12
- "description": "All 4 remaining dream branches predate the #2578 phantom-subpath fix that landed in v3.25.3 (PR #2602). Their old midstream-aware-loader.ts still imports from 'agentic-flow/transport/loader' → TS errors on Build V3.",
13
- "affectedPRs": [2517, 2537, 2577, 2598],
14
- "resolution": "rebase all 4 onto latest main; the fix is already there"
15
- },
16
- "lessonLearned": "Old-base branches get free fixes on rebase after main advances. Detect the shared-blocker pattern (same failure mode across N PRs) → try rebase before per-PR fixes."
17
- }
@@ -1,14 +0,0 @@
1
- {
2
- "tick": 4,
3
- "completedAt": "2026-07-08T03:03:00Z",
4
- "durationSeconds": 92,
5
- "rebased": [2517, 2537, 2577, 2598],
6
- "convertedReady": [2537, 2577, 2598],
7
- "coordinatorMistakes": [
8
- {"type": "schema-drift", "description": "3 rebase agents returned prNum=0 instead of the target PR number; downstream Convert-Ready phase failed on nonexistent PR #0"},
9
- {"type": "stale-worktree", "description": "Tick 1's worktree wf_ea2955a6-e74-10 held dream/2026-07-07-intelligence; tick 4's #2598 agent couldn't checkout. Fixed inline with git worktree remove --force + inline rebase."}
10
- ],
11
- "totalReward": 4,
12
- "cumulativeReward": 14,
13
- "lesson": "Workflow agents must inject their prNum into the return payload (prompt-side templating). Force-remove worktrees at end of prior workflow OR clean up before spawning new ones. Sometimes inline main-context work is faster than another workflow round."
14
- }