@claude-flow/cli 3.28.0 → 3.30.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 (465) hide show
  1. package/.claude/agents/analysis/analyze-code-quality.md +178 -178
  2. package/.claude/agents/analysis/code-analyzer.md +209 -209
  3. package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
  4. package/.claude/agents/architecture/arch-system-design.md +156 -156
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
  6. package/.claude/agents/browser/browser-agent.yaml +182 -182
  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/planner.md +374 -374
  15. package/.claude/agents/custom/test-long-runner.md +44 -44
  16. package/.claude/agents/data/data-ml-model.md +444 -444
  17. package/.claude/agents/data/ml/data-ml-model.md +192 -192
  18. package/.claude/agents/development/backend/dev-backend-api.md +141 -141
  19. package/.claude/agents/development/dev-backend-api.md +344 -344
  20. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
  21. package/.claude/agents/devops/ops-cicd-github.md +164 -164
  22. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
  23. package/.claude/agents/documentation/docs-api-openapi.md +354 -354
  24. package/.claude/agents/flow-nexus/app-store.md +87 -87
  25. package/.claude/agents/flow-nexus/authentication.md +68 -68
  26. package/.claude/agents/flow-nexus/challenges.md +80 -80
  27. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  28. package/.claude/agents/flow-nexus/payments.md +82 -82
  29. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  30. package/.claude/agents/flow-nexus/swarm.md +75 -75
  31. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  32. package/.claude/agents/flow-nexus/workflow.md +83 -83
  33. package/.claude/agents/github/code-review-swarm.md +377 -377
  34. package/.claude/agents/github/github-modes.md +172 -172
  35. package/.claude/agents/github/issue-tracker.md +575 -575
  36. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  37. package/.claude/agents/github/pr-manager.md +437 -437
  38. package/.claude/agents/github/project-board-sync.md +508 -508
  39. package/.claude/agents/github/release-manager.md +604 -604
  40. package/.claude/agents/github/release-swarm.md +582 -582
  41. package/.claude/agents/github/repo-architect.md +397 -397
  42. package/.claude/agents/github/swarm-issue.md +572 -572
  43. package/.claude/agents/github/swarm-pr.md +427 -427
  44. package/.claude/agents/github/sync-coordinator.md +451 -451
  45. package/.claude/agents/github/workflow-automation.md +902 -902
  46. package/.claude/agents/goal/agent.md +815 -815
  47. package/.claude/agents/optimization/benchmark-suite.md +664 -664
  48. package/.claude/agents/optimization/load-balancer.md +430 -430
  49. package/.claude/agents/optimization/performance-monitor.md +671 -671
  50. package/.claude/agents/optimization/resource-allocator.md +673 -673
  51. package/.claude/agents/optimization/topology-optimizer.md +807 -807
  52. package/.claude/agents/payments/agentic-payments.md +126 -126
  53. package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
  54. package/.claude/agents/sparc/architecture.md +698 -698
  55. package/.claude/agents/sparc/pseudocode.md +519 -519
  56. package/.claude/agents/sparc/refinement.md +801 -801
  57. package/.claude/agents/sparc/specification.md +477 -477
  58. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
  59. package/.claude/agents/specialized/spec-mobile-react-native.md +226 -226
  60. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  61. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  62. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  63. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  64. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  65. package/.claude/agents/swarm/adaptive-coordinator.md +1126 -1126
  66. package/.claude/agents/swarm/hierarchical-coordinator.md +709 -709
  67. package/.claude/agents/swarm/mesh-coordinator.md +962 -962
  68. package/.claude/agents/templates/automation-smart-agent.md +204 -204
  69. package/.claude/agents/templates/base-template-generator.md +289 -289
  70. package/.claude/agents/templates/coordinator-swarm-init.md +89 -89
  71. package/.claude/agents/templates/github-pr-manager.md +176 -176
  72. package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
  73. package/.claude/agents/templates/memory-coordinator.md +186 -186
  74. package/.claude/agents/templates/orchestrator-task.md +138 -138
  75. package/.claude/agents/templates/performance-analyzer.md +198 -198
  76. package/.claude/agents/templates/sparc-coordinator.md +513 -513
  77. package/.claude/agents/testing/production-validator.md +394 -394
  78. package/.claude/agents/testing/tdd-london-swarm.md +243 -243
  79. package/.claude/agents/v3/aidefence-guardian.md +282 -282
  80. package/.claude/agents/v3/claims-authorizer.md +208 -208
  81. package/.claude/agents/v3/collective-intelligence-coordinator.md +993 -993
  82. package/.claude/agents/v3/ddd-domain-expert.md +220 -220
  83. package/.claude/agents/v3/injection-analyst.md +236 -236
  84. package/.claude/agents/v3/performance-engineer.md +1233 -1233
  85. package/.claude/agents/v3/pii-detector.md +151 -151
  86. package/.claude/agents/v3/reasoningbank-learner.md +213 -213
  87. package/.claude/agents/v3/security-architect-aidefence.md +410 -410
  88. package/.claude/agents/v3/security-architect.md +867 -867
  89. package/.claude/agents/v3/swarm-memory-manager.md +157 -157
  90. package/.claude/agents/v3/v3-integration-architect.md +205 -205
  91. package/.claude/commands/agents/README.md +50 -50
  92. package/.claude/commands/agents/agent-capabilities.md +140 -140
  93. package/.claude/commands/agents/agent-coordination.md +28 -28
  94. package/.claude/commands/agents/agent-spawning.md +28 -28
  95. package/.claude/commands/agents/agent-types.md +216 -216
  96. package/.claude/commands/agents/health.md +139 -139
  97. package/.claude/commands/agents/list.md +100 -100
  98. package/.claude/commands/agents/logs.md +130 -130
  99. package/.claude/commands/agents/metrics.md +122 -122
  100. package/.claude/commands/agents/pool.md +127 -127
  101. package/.claude/commands/agents/spawn.md +140 -140
  102. package/.claude/commands/agents/status.md +115 -115
  103. package/.claude/commands/agents/stop.md +102 -102
  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/github/README.md +11 -11
  129. package/.claude/commands/github/code-review-swarm.md +513 -513
  130. package/.claude/commands/github/code-review.md +25 -25
  131. package/.claude/commands/github/github-modes.md +146 -146
  132. package/.claude/commands/github/github-swarm.md +121 -121
  133. package/.claude/commands/github/issue-tracker.md +291 -291
  134. package/.claude/commands/github/issue-triage.md +25 -25
  135. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  136. package/.claude/commands/github/pr-enhance.md +26 -26
  137. package/.claude/commands/github/pr-manager.md +169 -169
  138. package/.claude/commands/github/project-board-sync.md +470 -470
  139. package/.claude/commands/github/release-manager.md +339 -339
  140. package/.claude/commands/github/release-swarm.md +543 -543
  141. package/.claude/commands/github/repo-analyze.md +25 -25
  142. package/.claude/commands/github/repo-architect.md +366 -366
  143. package/.claude/commands/github/swarm-issue.md +484 -484
  144. package/.claude/commands/github/swarm-pr.md +287 -287
  145. package/.claude/commands/github/sync-coordinator.md +302 -302
  146. package/.claude/commands/github/workflow-automation.md +441 -441
  147. package/.claude/commands/hive-mind/README.md +17 -17
  148. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  149. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  150. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  151. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  152. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  153. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  154. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  155. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  156. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  157. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  158. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  159. package/.claude/commands/hooks/README.md +11 -11
  160. package/.claude/commands/hooks/overview.md +57 -57
  161. package/.claude/commands/hooks/post-edit.md +117 -117
  162. package/.claude/commands/hooks/post-task.md +112 -112
  163. package/.claude/commands/hooks/pre-edit.md +113 -113
  164. package/.claude/commands/hooks/pre-task.md +111 -111
  165. package/.claude/commands/hooks/session-end.md +118 -118
  166. package/.claude/commands/hooks/setup.md +102 -102
  167. package/.claude/commands/memory/README.md +9 -9
  168. package/.claude/commands/memory/memory-persist.md +25 -25
  169. package/.claude/commands/memory/memory-search.md +25 -25
  170. package/.claude/commands/memory/memory-usage.md +25 -25
  171. package/.claude/commands/memory/neural.md +47 -47
  172. package/.claude/commands/monitoring/README.md +9 -9
  173. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  174. package/.claude/commands/monitoring/agents.md +44 -44
  175. package/.claude/commands/monitoring/real-time-view.md +25 -25
  176. package/.claude/commands/monitoring/status.md +46 -46
  177. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  178. package/.claude/commands/optimization/README.md +9 -9
  179. package/.claude/commands/optimization/auto-topology.md +61 -61
  180. package/.claude/commands/optimization/cache-manage.md +25 -25
  181. package/.claude/commands/optimization/parallel-execute.md +25 -25
  182. package/.claude/commands/optimization/parallel-execution.md +49 -49
  183. package/.claude/commands/optimization/topology-optimize.md +25 -25
  184. package/.claude/commands/pair/README.md +260 -260
  185. package/.claude/commands/pair/commands.md +545 -545
  186. package/.claude/commands/pair/config.md +509 -509
  187. package/.claude/commands/pair/examples.md +511 -511
  188. package/.claude/commands/pair/modes.md +347 -347
  189. package/.claude/commands/pair/session.md +406 -406
  190. package/.claude/commands/pair/start.md +208 -208
  191. package/.claude/commands/sparc/analyzer.md +51 -51
  192. package/.claude/commands/sparc/architect.md +53 -53
  193. package/.claude/commands/sparc/ask.md +97 -97
  194. package/.claude/commands/sparc/batch-executor.md +54 -54
  195. package/.claude/commands/sparc/code.md +89 -89
  196. package/.claude/commands/sparc/coder.md +54 -54
  197. package/.claude/commands/sparc/debug.md +83 -83
  198. package/.claude/commands/sparc/debugger.md +54 -54
  199. package/.claude/commands/sparc/designer.md +53 -53
  200. package/.claude/commands/sparc/devops.md +109 -109
  201. package/.claude/commands/sparc/docs-writer.md +80 -80
  202. package/.claude/commands/sparc/documenter.md +54 -54
  203. package/.claude/commands/sparc/innovator.md +54 -54
  204. package/.claude/commands/sparc/integration.md +83 -83
  205. package/.claude/commands/sparc/mcp.md +117 -117
  206. package/.claude/commands/sparc/memory-manager.md +54 -54
  207. package/.claude/commands/sparc/optimizer.md +54 -54
  208. package/.claude/commands/sparc/orchestrator.md +131 -131
  209. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  210. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  211. package/.claude/commands/sparc/researcher.md +54 -54
  212. package/.claude/commands/sparc/reviewer.md +54 -54
  213. package/.claude/commands/sparc/security-review.md +80 -80
  214. package/.claude/commands/sparc/sparc-modes.md +174 -174
  215. package/.claude/commands/sparc/sparc.md +111 -111
  216. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  217. package/.claude/commands/sparc/supabase-admin.md +348 -348
  218. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  219. package/.claude/commands/sparc/tdd.md +54 -54
  220. package/.claude/commands/sparc/tester.md +54 -54
  221. package/.claude/commands/sparc/tutorial.md +79 -79
  222. package/.claude/commands/sparc/workflow-manager.md +54 -54
  223. package/.claude/commands/sparc.md +166 -166
  224. package/.claude/commands/stream-chain/pipeline.md +120 -120
  225. package/.claude/commands/stream-chain/run.md +69 -69
  226. package/.claude/commands/swarm/README.md +15 -15
  227. package/.claude/commands/swarm/analysis.md +95 -95
  228. package/.claude/commands/swarm/development.md +96 -96
  229. package/.claude/commands/swarm/examples.md +168 -168
  230. package/.claude/commands/swarm/maintenance.md +102 -102
  231. package/.claude/commands/swarm/optimization.md +117 -117
  232. package/.claude/commands/swarm/research.md +136 -136
  233. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  234. package/.claude/commands/swarm/swarm-background.md +8 -8
  235. package/.claude/commands/swarm/swarm-init.md +19 -19
  236. package/.claude/commands/swarm/swarm-modes.md +8 -8
  237. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  238. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  239. package/.claude/commands/swarm/swarm-status.md +8 -8
  240. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  241. package/.claude/commands/swarm/swarm.md +87 -87
  242. package/.claude/commands/swarm/testing.md +131 -131
  243. package/.claude/commands/training/README.md +9 -9
  244. package/.claude/commands/training/model-update.md +25 -25
  245. package/.claude/commands/training/neural-patterns.md +107 -107
  246. package/.claude/commands/training/neural-train.md +75 -75
  247. package/.claude/commands/training/pattern-learn.md +25 -25
  248. package/.claude/commands/training/specialization.md +62 -62
  249. package/.claude/commands/truth/start.md +142 -142
  250. package/.claude/commands/verify/check.md +49 -49
  251. package/.claude/commands/verify/start.md +127 -127
  252. package/.claude/commands/workflows/README.md +9 -9
  253. package/.claude/commands/workflows/development.md +77 -77
  254. package/.claude/commands/workflows/research.md +62 -62
  255. package/.claude/commands/workflows/workflow-create.md +25 -25
  256. package/.claude/commands/workflows/workflow-execute.md +25 -25
  257. package/.claude/commands/workflows/workflow-export.md +25 -25
  258. package/.claude/eval/human-relevance-frozen-v1.json +17 -17
  259. package/.claude/evolve-proof/generation-0.json +211 -211
  260. package/.claude/evolve-proof/real-generation-0.json +406 -406
  261. package/.claude/evolve-proof/real-generation-1.json +406 -406
  262. package/.claude/helpers/.helpers-version +1 -1
  263. package/.claude/helpers/README.md +96 -96
  264. package/.claude/helpers/adr-compliance.sh +186 -186
  265. package/.claude/helpers/auto-commit.sh +178 -178
  266. package/.claude/helpers/auto-memory-hook.mjs +430 -430
  267. package/.claude/helpers/checkpoint-manager.sh +251 -251
  268. package/.claude/helpers/daemon-manager.sh +252 -252
  269. package/.claude/helpers/ddd-tracker.sh +144 -144
  270. package/.claude/helpers/github-safe.js +156 -156
  271. package/.claude/helpers/github-setup.sh +45 -45
  272. package/.claude/helpers/guidance-hook.sh +13 -13
  273. package/.claude/helpers/guidance-hooks.sh +102 -102
  274. package/.claude/helpers/health-monitor.sh +108 -108
  275. package/.claude/helpers/helpers.manifest.json +6 -6
  276. package/.claude/helpers/hook-handler.cjs +564 -460
  277. package/.claude/helpers/intelligence.cjs +1058 -1058
  278. package/.claude/helpers/learning-hooks.sh +329 -329
  279. package/.claude/helpers/learning-optimizer.sh +127 -127
  280. package/.claude/helpers/learning-service.mjs +1144 -1144
  281. package/.claude/helpers/memory.js +83 -83
  282. package/.claude/helpers/metrics-db.mjs +503 -503
  283. package/.claude/helpers/pattern-consolidator.sh +86 -86
  284. package/.claude/helpers/perf-worker.sh +160 -160
  285. package/.claude/helpers/post-commit +16 -16
  286. package/.claude/helpers/pre-commit +26 -26
  287. package/.claude/helpers/quick-start.sh +19 -19
  288. package/.claude/helpers/router.js +105 -105
  289. package/.claude/helpers/security-scanner.sh +127 -127
  290. package/.claude/helpers/session.js +157 -157
  291. package/.claude/helpers/setup-mcp.sh +18 -18
  292. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  293. package/.claude/helpers/statusline-hook.sh +21 -21
  294. package/.claude/helpers/statusline.cjs +925 -925
  295. package/.claude/helpers/statusline.js +352 -352
  296. package/.claude/helpers/swarm-comms.sh +353 -353
  297. package/.claude/helpers/swarm-hooks.sh +761 -761
  298. package/.claude/helpers/swarm-monitor.sh +210 -210
  299. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  300. package/.claude/helpers/update-v3-progress.sh +165 -165
  301. package/.claude/helpers/v3-quick-status.sh +57 -57
  302. package/.claude/helpers/v3.sh +110 -110
  303. package/.claude/helpers/validate-v3-config.sh +215 -215
  304. package/.claude/helpers/worker-manager.sh +170 -170
  305. package/.claude/proven-config.json +1 -1
  306. package/.claude/proven-config.manifest.json +37 -37
  307. package/.claude/proven-config.signed.json +41 -41
  308. package/.claude/settings.json +182 -182
  309. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  310. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  311. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  312. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  313. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  314. package/.claude/skills/browser/SKILL.md +204 -204
  315. package/.claude/skills/dual-mode/README.md +71 -71
  316. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  317. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  318. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  319. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  320. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  321. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  322. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  323. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  324. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  325. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  326. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  327. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  328. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  329. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  330. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  331. package/.claude/skills/skill-builder/SKILL.md +910 -910
  332. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  333. package/.claude/skills/stream-chain/SKILL.md +560 -560
  334. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  335. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  336. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  337. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  338. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  339. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  340. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  341. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  342. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  343. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  344. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  345. package/.claude/skills/verification-quality/SKILL.md +691 -691
  346. package/README.md +419 -419
  347. package/bin/cli.js +314 -314
  348. package/bin/mcp-server.js +224 -224
  349. package/bin/preinstall.cjs +2 -2
  350. package/catalog-manifest.json +2 -2
  351. package/dist/src/benchmarks/gaia-critic.js +24 -24
  352. package/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  353. package/dist/src/commands/announcements.d.ts +17 -0
  354. package/dist/src/commands/announcements.js +0 -0
  355. package/dist/src/commands/completions.js +409 -409
  356. package/dist/src/commands/daemon.js +44 -44
  357. package/dist/src/commands/embeddings.js +26 -26
  358. package/dist/src/commands/funnel.d.ts +10 -5
  359. package/dist/src/commands/funnel.js +206 -7
  360. package/dist/src/commands/hive-mind.js +97 -97
  361. package/dist/src/commands/hooks.js +9 -9
  362. package/dist/src/commands/index.js +4 -0
  363. package/dist/src/commands/init.js +94 -38
  364. package/dist/src/commands/memory.js +85 -1
  365. package/dist/src/commands/ruvector/backup.js +23 -23
  366. package/dist/src/commands/ruvector/benchmark.js +31 -31
  367. package/dist/src/commands/ruvector/import.js +14 -14
  368. package/dist/src/commands/ruvector/init.js +115 -115
  369. package/dist/src/commands/ruvector/migrate.js +99 -99
  370. package/dist/src/commands/ruvector/optimize.js +51 -51
  371. package/dist/src/commands/ruvector/setup.js +624 -624
  372. package/dist/src/commands/ruvector/status.js +38 -38
  373. package/dist/src/commands/spinner.d.ts +16 -0
  374. package/dist/src/commands/spinner.js +329 -0
  375. package/dist/src/config/proven-config.js +2 -2
  376. package/dist/src/funnel/consent.js +3 -0
  377. package/dist/src/funnel/disclosure.d.ts +1 -0
  378. package/dist/src/funnel/disclosure.js +12 -0
  379. package/dist/src/funnel/index.d.ts +2 -1
  380. package/dist/src/funnel/index.js +2 -1
  381. package/dist/src/funnel/payout.d.ts +40 -0
  382. package/dist/src/funnel/payout.js +60 -0
  383. package/dist/src/funnel/types.d.ts +13 -1
  384. package/dist/src/init/claudemd-generator.js +231 -231
  385. package/dist/src/init/executor.js +453 -453
  386. package/dist/src/init/helper-refresh.js +17 -0
  387. package/dist/src/init/helper-signing.d.ts +8 -1
  388. package/dist/src/init/helper-signing.js +9 -2
  389. package/dist/src/init/helpers-generator.js +751 -751
  390. package/dist/src/init/statusline-generator.js +955 -949
  391. package/dist/src/mcp-tools/agentdb-tools.js +15 -15
  392. package/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  393. package/dist/src/memory/graph-edge-writer.js +22 -22
  394. package/dist/src/memory/memory-bridge.d.ts +10 -0
  395. package/dist/src/memory/memory-bridge.js +139 -88
  396. package/dist/src/memory/memory-initializer.d.ts +18 -0
  397. package/dist/src/memory/memory-initializer.js +539 -407
  398. package/dist/src/memory/rabitq-index.js +5 -5
  399. package/dist/src/runtime/headless.js +28 -28
  400. package/dist/src/ruvector/flash-attention.d.ts +195 -0
  401. package/dist/src/ruvector/flash-attention.js +643 -0
  402. package/dist/src/ruvector/moe-router.d.ts +206 -0
  403. package/dist/src/ruvector/moe-router.js +626 -0
  404. package/dist/src/services/distill-tuning.js +7 -7
  405. package/dist/src/services/event-stream.d.ts +25 -0
  406. package/dist/src/services/event-stream.js +27 -0
  407. package/dist/src/services/headless-worker-executor.js +84 -84
  408. package/dist/src/services/loop-worker-runner.d.ts +16 -0
  409. package/dist/src/services/loop-worker-runner.js +34 -0
  410. package/dist/src/services/memory-distillation.js +4 -4
  411. package/dist/src/services/runtime-capabilities.d.ts +22 -0
  412. package/dist/src/services/runtime-capabilities.js +45 -0
  413. package/dist/src/transfer/deploy-seraphine.js +23 -23
  414. package/package.json +134 -133
  415. package/plugins/ruflo-metaharness/.claude-plugin/plugin.json +32 -32
  416. package/plugins/ruflo-metaharness/README.md +72 -72
  417. package/plugins/ruflo-metaharness/agents/metaharness-architect.md +58 -58
  418. package/plugins/ruflo-metaharness/commands/ruflo-metaharness.md +48 -48
  419. package/plugins/ruflo-metaharness/scripts/_darwin.mjs +210 -210
  420. package/plugins/ruflo-metaharness/scripts/_harness.mjs +330 -330
  421. package/plugins/ruflo-metaharness/scripts/_invoke.mjs +231 -231
  422. package/plugins/ruflo-metaharness/scripts/_redblue.mjs +143 -143
  423. package/plugins/ruflo-metaharness/scripts/_similarity.mjs +161 -161
  424. package/plugins/ruflo-metaharness/scripts/_spike-similarity.mjs +223 -223
  425. package/plugins/ruflo-metaharness/scripts/audit-list.mjs +158 -158
  426. package/plugins/ruflo-metaharness/scripts/audit-trend.mjs +272 -272
  427. package/plugins/ruflo-metaharness/scripts/bench-parse-mcp-scan.mjs +146 -146
  428. package/plugins/ruflo-metaharness/scripts/bench-recordpair-overhead.mjs +186 -186
  429. package/plugins/ruflo-metaharness/scripts/bench-similarity.mjs +177 -177
  430. package/plugins/ruflo-metaharness/scripts/bench.mjs +95 -95
  431. package/plugins/ruflo-metaharness/scripts/drift-from-history.mjs +363 -363
  432. package/plugins/ruflo-metaharness/scripts/evolve.mjs +404 -404
  433. package/plugins/ruflo-metaharness/scripts/genome.mjs +80 -80
  434. package/plugins/ruflo-metaharness/scripts/gepa.mjs +153 -153
  435. package/plugins/ruflo-metaharness/scripts/learn.mjs +127 -127
  436. package/plugins/ruflo-metaharness/scripts/mcp-scan.mjs +111 -111
  437. package/plugins/ruflo-metaharness/scripts/mint.mjs +126 -126
  438. package/plugins/ruflo-metaharness/scripts/oia-audit.mjs +228 -228
  439. package/plugins/ruflo-metaharness/scripts/redblue.mjs +286 -286
  440. package/plugins/ruflo-metaharness/scripts/router-parallel-analyze.mjs +250 -250
  441. package/plugins/ruflo-metaharness/scripts/score.mjs +92 -92
  442. package/plugins/ruflo-metaharness/scripts/security-bench.mjs +174 -174
  443. package/plugins/ruflo-metaharness/scripts/similarity.mjs +158 -158
  444. package/plugins/ruflo-metaharness/scripts/smoke.sh +2353 -2353
  445. package/plugins/ruflo-metaharness/scripts/test-graceful-degradation.mjs +165 -165
  446. package/plugins/ruflo-metaharness/scripts/test-mcp-tools.mjs +472 -472
  447. package/plugins/ruflo-metaharness/scripts/test-parallel-pipeline.mjs +204 -204
  448. package/plugins/ruflo-metaharness/scripts/test-pipeline-roundtrip.mjs +586 -586
  449. package/plugins/ruflo-metaharness/scripts/test-similarity.mjs +334 -334
  450. package/plugins/ruflo-metaharness/scripts/test-with-openrouter.mjs +229 -229
  451. package/plugins/ruflo-metaharness/scripts/threat-model.mjs +59 -59
  452. package/plugins/ruflo-metaharness/skills/harness-bench/SKILL.md +64 -64
  453. package/plugins/ruflo-metaharness/skills/harness-drift-from-history/SKILL.md +65 -65
  454. package/plugins/ruflo-metaharness/skills/harness-evolve/SKILL.md +131 -131
  455. package/plugins/ruflo-metaharness/skills/harness-genome/SKILL.md +54 -54
  456. package/plugins/ruflo-metaharness/skills/harness-gepa/SKILL.md +65 -65
  457. package/plugins/ruflo-metaharness/skills/harness-learn/SKILL.md +65 -65
  458. package/plugins/ruflo-metaharness/skills/harness-mcp-scan/SKILL.md +49 -49
  459. package/plugins/ruflo-metaharness/skills/harness-mint/SKILL.md +72 -72
  460. package/plugins/ruflo-metaharness/skills/harness-oia-audit/SKILL.md +79 -79
  461. package/plugins/ruflo-metaharness/skills/harness-score/SKILL.md +66 -66
  462. package/plugins/ruflo-metaharness/skills/harness-security-bench/SKILL.md +101 -101
  463. package/plugins/ruflo-metaharness/skills/harness-similarity/SKILL.md +67 -67
  464. package/plugins/ruflo-metaharness/skills/harness-threat-model/SKILL.md +41 -41
  465. package/scripts/postinstall.cjs +153 -153
@@ -1,442 +1,442 @@
1
- ---
2
- name: "V3 DDD Architecture"
3
- description: "Domain-Driven Design architecture for claude-flow v3. Implements modular, bounded context architecture with clean separation of concerns and microkernel pattern."
4
- ---
5
-
6
- # V3 DDD Architecture
7
-
8
- ## What This Skill Does
9
-
10
- Designs and implements Domain-Driven Design (DDD) architecture for claude-flow v3, decomposing god objects into bounded contexts, implementing clean architecture patterns, and enabling modular, testable code structure.
11
-
12
- ## Quick Start
13
-
14
- ```bash
15
- # Initialize DDD architecture analysis
16
- Task("Architecture analysis", "Analyze current architecture and design DDD boundaries", "core-architect")
17
-
18
- # Domain modeling (parallel)
19
- Task("Domain decomposition", "Break down orchestrator god object into domains", "core-architect")
20
- Task("Context mapping", "Map bounded contexts and relationships", "core-architect")
21
- Task("Interface design", "Design clean domain interfaces", "core-architect")
22
- ```
23
-
24
- ## DDD Implementation Strategy
25
-
26
- ### Current Architecture Analysis
27
- ```
28
- ├── PROBLEMATIC: core/orchestrator.ts (1,440 lines - GOD OBJECT)
29
- │ ├── Task management responsibilities
30
- │ ├── Session management responsibilities
31
- │ ├── Health monitoring responsibilities
32
- │ ├── Lifecycle management responsibilities
33
- │ └── Event coordination responsibilities
34
-
35
- └── TARGET: Modular DDD Architecture
36
- ├── core/domains/
37
- │ ├── task-management/
38
- │ ├── session-management/
39
- │ ├── health-monitoring/
40
- │ ├── lifecycle-management/
41
- │ └── event-coordination/
42
- └── core/shared/
43
- ├── interfaces/
44
- ├── value-objects/
45
- └── domain-events/
46
- ```
47
-
48
- ### Domain Boundaries
49
-
50
- #### 1. Task Management Domain
51
- ```typescript
52
- // core/domains/task-management/
53
- interface TaskManagementDomain {
54
- // Entities
55
- Task: TaskEntity;
56
- TaskQueue: TaskQueueEntity;
57
-
58
- // Value Objects
59
- TaskId: TaskIdVO;
60
- TaskStatus: TaskStatusVO;
61
- Priority: PriorityVO;
62
-
63
- // Services
64
- TaskScheduler: TaskSchedulingService;
65
- TaskValidator: TaskValidationService;
66
-
67
- // Repository
68
- TaskRepository: ITaskRepository;
69
- }
70
- ```
71
-
72
- #### 2. Session Management Domain
73
- ```typescript
74
- // core/domains/session-management/
75
- interface SessionManagementDomain {
76
- // Entities
77
- Session: SessionEntity;
78
- SessionState: SessionStateEntity;
79
-
80
- // Value Objects
81
- SessionId: SessionIdVO;
82
- SessionStatus: SessionStatusVO;
83
-
84
- // Services
85
- SessionLifecycle: SessionLifecycleService;
86
- SessionPersistence: SessionPersistenceService;
87
-
88
- // Repository
89
- SessionRepository: ISessionRepository;
90
- }
91
- ```
92
-
93
- #### 3. Health Monitoring Domain
94
- ```typescript
95
- // core/domains/health-monitoring/
96
- interface HealthMonitoringDomain {
97
- // Entities
98
- HealthCheck: HealthCheckEntity;
99
- Metric: MetricEntity;
100
-
101
- // Value Objects
102
- HealthStatus: HealthStatusVO;
103
- Threshold: ThresholdVO;
104
-
105
- // Services
106
- HealthCollector: HealthCollectionService;
107
- AlertManager: AlertManagementService;
108
-
109
- // Repository
110
- MetricsRepository: IMetricsRepository;
111
- }
112
- ```
113
-
114
- ## Microkernel Architecture Pattern
115
-
116
- ### Core Kernel
117
- ```typescript
118
- // core/kernel/claude-flow-kernel.ts
119
- export class ClaudeFlowKernel {
120
- private domains: Map<string, Domain> = new Map();
121
- private eventBus: DomainEventBus;
122
- private dependencyContainer: Container;
123
-
124
- async initialize(): Promise<void> {
125
- // Load core domains
126
- await this.loadDomain('task-management', new TaskManagementDomain());
127
- await this.loadDomain('session-management', new SessionManagementDomain());
128
- await this.loadDomain('health-monitoring', new HealthMonitoringDomain());
129
-
130
- // Wire up domain events
131
- this.setupDomainEventHandlers();
132
- }
133
-
134
- async loadDomain(name: string, domain: Domain): Promise<void> {
135
- await domain.initialize(this.dependencyContainer);
136
- this.domains.set(name, domain);
137
- }
138
-
139
- getDomain<T extends Domain>(name: string): T {
140
- const domain = this.domains.get(name);
141
- if (!domain) {
142
- throw new DomainNotLoadedError(name);
143
- }
144
- return domain as T;
145
- }
146
- }
147
- ```
148
-
149
- ### Plugin Architecture
150
- ```typescript
151
- // core/plugins/
152
- interface DomainPlugin {
153
- name: string;
154
- version: string;
155
- dependencies: string[];
156
-
157
- initialize(kernel: ClaudeFlowKernel): Promise<void>;
158
- shutdown(): Promise<void>;
159
- }
160
-
161
- // Example: Swarm Coordination Plugin
162
- export class SwarmCoordinationPlugin implements DomainPlugin {
163
- name = 'swarm-coordination';
164
- version = '3.0.0';
165
- dependencies = ['task-management', 'session-management'];
166
-
167
- async initialize(kernel: ClaudeFlowKernel): Promise<void> {
168
- const taskDomain = kernel.getDomain<TaskManagementDomain>('task-management');
169
- const sessionDomain = kernel.getDomain<SessionManagementDomain>('session-management');
170
-
171
- // Register swarm coordination services
172
- this.swarmCoordinator = new UnifiedSwarmCoordinator(taskDomain, sessionDomain);
173
- kernel.registerService('swarm-coordinator', this.swarmCoordinator);
174
- }
175
- }
176
- ```
177
-
178
- ## Domain Events & Integration
179
-
180
- ### Event-Driven Communication
181
- ```typescript
182
- // core/shared/domain-events/
183
- abstract class DomainEvent {
184
- public readonly eventId: string;
185
- public readonly aggregateId: string;
186
- public readonly occurredOn: Date;
187
- public readonly eventVersion: number;
188
-
189
- constructor(aggregateId: string) {
190
- this.eventId = crypto.randomUUID();
191
- this.aggregateId = aggregateId;
192
- this.occurredOn = new Date();
193
- this.eventVersion = 1;
194
- }
195
- }
196
-
197
- // Task domain events
198
- export class TaskAssignedEvent extends DomainEvent {
199
- constructor(
200
- taskId: string,
201
- public readonly agentId: string,
202
- public readonly priority: Priority
203
- ) {
204
- super(taskId);
205
- }
206
- }
207
-
208
- export class TaskCompletedEvent extends DomainEvent {
209
- constructor(
210
- taskId: string,
211
- public readonly result: TaskResult,
212
- public readonly duration: number
213
- ) {
214
- super(taskId);
215
- }
216
- }
217
-
218
- // Event handlers
219
- @EventHandler(TaskCompletedEvent)
220
- export class TaskCompletedHandler {
221
- constructor(
222
- private metricsRepository: IMetricsRepository,
223
- private sessionService: SessionLifecycleService
224
- ) {}
225
-
226
- async handle(event: TaskCompletedEvent): Promise<void> {
227
- // Update metrics
228
- await this.metricsRepository.recordTaskCompletion(
229
- event.aggregateId,
230
- event.duration
231
- );
232
-
233
- // Update session state
234
- await this.sessionService.markTaskCompleted(
235
- event.aggregateId,
236
- event.result
237
- );
238
- }
239
- }
240
- ```
241
-
242
- ## Clean Architecture Layers
243
-
244
- ```typescript
245
- // Architecture layers
246
- ┌─────────────────────────────────────────┐
247
- │ Presentation │ ← CLI, API, UI
248
- ├─────────────────────────────────────────┤
249
- │ Application │ ← Use Cases, Commands
250
- ├─────────────────────────────────────────┤
251
- │ Domain │ ← Entities, Services, Events
252
- ├─────────────────────────────────────────┤
253
- │ Infrastructure │ ← DB, MCP, External APIs
254
- └─────────────────────────────────────────┘
255
-
256
- // Dependency direction: Outside → Inside
257
- // Domain layer has NO external dependencies
258
- ```
259
-
260
- ### Application Layer (Use Cases)
261
- ```typescript
262
- // core/application/use-cases/
263
- export class AssignTaskUseCase {
264
- constructor(
265
- private taskRepository: ITaskRepository,
266
- private agentRepository: IAgentRepository,
267
- private eventBus: DomainEventBus
268
- ) {}
269
-
270
- async execute(command: AssignTaskCommand): Promise<TaskResult> {
271
- // 1. Validate command
272
- await this.validateCommand(command);
273
-
274
- // 2. Load aggregates
275
- const task = await this.taskRepository.findById(command.taskId);
276
- const agent = await this.agentRepository.findById(command.agentId);
277
-
278
- // 3. Business logic (in domain)
279
- task.assignTo(agent);
280
-
281
- // 4. Persist changes
282
- await this.taskRepository.save(task);
283
-
284
- // 5. Publish domain events
285
- task.getUncommittedEvents().forEach(event =>
286
- this.eventBus.publish(event)
287
- );
288
-
289
- // 6. Return result
290
- return TaskResult.success(task);
291
- }
292
- }
293
- ```
294
-
295
- ## Module Configuration
296
-
297
- ### Bounded Context Modules
298
- ```typescript
299
- // core/domains/task-management/module.ts
300
- export const taskManagementModule = {
301
- name: 'task-management',
302
-
303
- entities: [
304
- TaskEntity,
305
- TaskQueueEntity
306
- ],
307
-
308
- valueObjects: [
309
- TaskIdVO,
310
- TaskStatusVO,
311
- PriorityVO
312
- ],
313
-
314
- services: [
315
- TaskSchedulingService,
316
- TaskValidationService
317
- ],
318
-
319
- repositories: [
320
- { provide: ITaskRepository, useClass: SqliteTaskRepository }
321
- ],
322
-
323
- eventHandlers: [
324
- TaskAssignedHandler,
325
- TaskCompletedHandler
326
- ]
327
- };
328
- ```
329
-
330
- ## Migration Strategy
331
-
332
- ### Phase 1: Extract Domain Services
333
- ```typescript
334
- // Extract services from orchestrator.ts
335
- const extractionPlan = {
336
- week1: [
337
- 'TaskManager → task-management domain',
338
- 'SessionManager → session-management domain'
339
- ],
340
- week2: [
341
- 'HealthMonitor → health-monitoring domain',
342
- 'LifecycleManager → lifecycle-management domain'
343
- ],
344
- week3: [
345
- 'EventCoordinator → event-coordination domain',
346
- 'Wire up domain events'
347
- ]
348
- };
349
- ```
350
-
351
- ### Phase 2: Implement Clean Interfaces
352
- ```typescript
353
- // Clean separation with dependency injection
354
- export class TaskController {
355
- constructor(
356
- @Inject('AssignTaskUseCase') private assignTask: AssignTaskUseCase,
357
- @Inject('CompleteTaskUseCase') private completeTask: CompleteTaskUseCase
358
- ) {}
359
-
360
- async assign(request: AssignTaskRequest): Promise<TaskResponse> {
361
- const command = AssignTaskCommand.fromRequest(request);
362
- const result = await this.assignTask.execute(command);
363
- return TaskResponse.fromResult(result);
364
- }
365
- }
366
- ```
367
-
368
- ### Phase 3: Plugin System
369
- ```typescript
370
- // Enable plugin-based extensions
371
- const pluginSystem = {
372
- core: ['task-management', 'session-management', 'health-monitoring'],
373
- optional: ['swarm-coordination', 'learning-integration', 'performance-monitoring']
374
- };
375
- ```
376
-
377
- ## Testing Strategy
378
-
379
- ### Domain Testing (London School TDD)
380
- ```typescript
381
- // Pure domain logic testing
382
- describe('Task Entity', () => {
383
- let task: TaskEntity;
384
- let mockAgent: jest.Mocked<AgentEntity>;
385
-
386
- beforeEach(() => {
387
- task = new TaskEntity(TaskId.create(), 'Test task');
388
- mockAgent = createMock<AgentEntity>();
389
- });
390
-
391
- it('should assign to agent when valid', () => {
392
- mockAgent.canAcceptTask.mockReturnValue(true);
393
-
394
- task.assignTo(mockAgent);
395
-
396
- expect(task.assignedAgent).toBe(mockAgent);
397
- expect(task.status.value).toBe('assigned');
398
- });
399
-
400
- it('should emit TaskAssignedEvent when assigned', () => {
401
- mockAgent.canAcceptTask.mockReturnValue(true);
402
-
403
- task.assignTo(mockAgent);
404
-
405
- const events = task.getUncommittedEvents();
406
- expect(events).toHaveLength(1);
407
- expect(events[0]).toBeInstanceOf(TaskAssignedEvent);
408
- });
409
- });
410
- ```
411
-
412
- ## Success Metrics
413
-
414
- - [ ] **God Object Elimination**: orchestrator.ts (1,440 lines) → 5 focused domains (<300 lines each)
415
- - [ ] **Bounded Context Isolation**: 100% domain independence
416
- - [ ] **Plugin Architecture**: Core + optional modules loading
417
- - [ ] **Clean Architecture**: Dependency inversion maintained
418
- - [ ] **Event-Driven Communication**: Loose coupling between domains
419
- - [ ] **Test Coverage**: >90% domain logic coverage
420
-
421
- ## Related V3 Skills
422
-
423
- - `v3-core-implementation` - Implementation of DDD domains
424
- - `v3-memory-unification` - AgentDB integration within bounded contexts
425
- - `v3-swarm-coordination` - Swarm coordination as domain plugin
426
- - `v3-performance-optimization` - Performance optimization across domains
427
-
428
- ## Usage Examples
429
-
430
- ### Complete Domain Extraction
431
- ```bash
432
- # Full DDD architecture implementation
433
- Task("DDD architecture implementation",
434
- "Extract orchestrator into DDD domains with clean architecture",
435
- "core-architect")
436
- ```
437
-
438
- ### Plugin Development
439
- ```bash
440
- # Create domain plugin
441
- npm run create:plugin -- --name swarm-coordination --template domain
1
+ ---
2
+ name: "V3 DDD Architecture"
3
+ description: "Domain-Driven Design architecture for claude-flow v3. Implements modular, bounded context architecture with clean separation of concerns and microkernel pattern."
4
+ ---
5
+
6
+ # V3 DDD Architecture
7
+
8
+ ## What This Skill Does
9
+
10
+ Designs and implements Domain-Driven Design (DDD) architecture for claude-flow v3, decomposing god objects into bounded contexts, implementing clean architecture patterns, and enabling modular, testable code structure.
11
+
12
+ ## Quick Start
13
+
14
+ ```bash
15
+ # Initialize DDD architecture analysis
16
+ Task("Architecture analysis", "Analyze current architecture and design DDD boundaries", "core-architect")
17
+
18
+ # Domain modeling (parallel)
19
+ Task("Domain decomposition", "Break down orchestrator god object into domains", "core-architect")
20
+ Task("Context mapping", "Map bounded contexts and relationships", "core-architect")
21
+ Task("Interface design", "Design clean domain interfaces", "core-architect")
22
+ ```
23
+
24
+ ## DDD Implementation Strategy
25
+
26
+ ### Current Architecture Analysis
27
+ ```
28
+ ├── PROBLEMATIC: core/orchestrator.ts (1,440 lines - GOD OBJECT)
29
+ │ ├── Task management responsibilities
30
+ │ ├── Session management responsibilities
31
+ │ ├── Health monitoring responsibilities
32
+ │ ├── Lifecycle management responsibilities
33
+ │ └── Event coordination responsibilities
34
+
35
+ └── TARGET: Modular DDD Architecture
36
+ ├── core/domains/
37
+ │ ├── task-management/
38
+ │ ├── session-management/
39
+ │ ├── health-monitoring/
40
+ │ ├── lifecycle-management/
41
+ │ └── event-coordination/
42
+ └── core/shared/
43
+ ├── interfaces/
44
+ ├── value-objects/
45
+ └── domain-events/
46
+ ```
47
+
48
+ ### Domain Boundaries
49
+
50
+ #### 1. Task Management Domain
51
+ ```typescript
52
+ // core/domains/task-management/
53
+ interface TaskManagementDomain {
54
+ // Entities
55
+ Task: TaskEntity;
56
+ TaskQueue: TaskQueueEntity;
57
+
58
+ // Value Objects
59
+ TaskId: TaskIdVO;
60
+ TaskStatus: TaskStatusVO;
61
+ Priority: PriorityVO;
62
+
63
+ // Services
64
+ TaskScheduler: TaskSchedulingService;
65
+ TaskValidator: TaskValidationService;
66
+
67
+ // Repository
68
+ TaskRepository: ITaskRepository;
69
+ }
70
+ ```
71
+
72
+ #### 2. Session Management Domain
73
+ ```typescript
74
+ // core/domains/session-management/
75
+ interface SessionManagementDomain {
76
+ // Entities
77
+ Session: SessionEntity;
78
+ SessionState: SessionStateEntity;
79
+
80
+ // Value Objects
81
+ SessionId: SessionIdVO;
82
+ SessionStatus: SessionStatusVO;
83
+
84
+ // Services
85
+ SessionLifecycle: SessionLifecycleService;
86
+ SessionPersistence: SessionPersistenceService;
87
+
88
+ // Repository
89
+ SessionRepository: ISessionRepository;
90
+ }
91
+ ```
92
+
93
+ #### 3. Health Monitoring Domain
94
+ ```typescript
95
+ // core/domains/health-monitoring/
96
+ interface HealthMonitoringDomain {
97
+ // Entities
98
+ HealthCheck: HealthCheckEntity;
99
+ Metric: MetricEntity;
100
+
101
+ // Value Objects
102
+ HealthStatus: HealthStatusVO;
103
+ Threshold: ThresholdVO;
104
+
105
+ // Services
106
+ HealthCollector: HealthCollectionService;
107
+ AlertManager: AlertManagementService;
108
+
109
+ // Repository
110
+ MetricsRepository: IMetricsRepository;
111
+ }
112
+ ```
113
+
114
+ ## Microkernel Architecture Pattern
115
+
116
+ ### Core Kernel
117
+ ```typescript
118
+ // core/kernel/claude-flow-kernel.ts
119
+ export class ClaudeFlowKernel {
120
+ private domains: Map<string, Domain> = new Map();
121
+ private eventBus: DomainEventBus;
122
+ private dependencyContainer: Container;
123
+
124
+ async initialize(): Promise<void> {
125
+ // Load core domains
126
+ await this.loadDomain('task-management', new TaskManagementDomain());
127
+ await this.loadDomain('session-management', new SessionManagementDomain());
128
+ await this.loadDomain('health-monitoring', new HealthMonitoringDomain());
129
+
130
+ // Wire up domain events
131
+ this.setupDomainEventHandlers();
132
+ }
133
+
134
+ async loadDomain(name: string, domain: Domain): Promise<void> {
135
+ await domain.initialize(this.dependencyContainer);
136
+ this.domains.set(name, domain);
137
+ }
138
+
139
+ getDomain<T extends Domain>(name: string): T {
140
+ const domain = this.domains.get(name);
141
+ if (!domain) {
142
+ throw new DomainNotLoadedError(name);
143
+ }
144
+ return domain as T;
145
+ }
146
+ }
147
+ ```
148
+
149
+ ### Plugin Architecture
150
+ ```typescript
151
+ // core/plugins/
152
+ interface DomainPlugin {
153
+ name: string;
154
+ version: string;
155
+ dependencies: string[];
156
+
157
+ initialize(kernel: ClaudeFlowKernel): Promise<void>;
158
+ shutdown(): Promise<void>;
159
+ }
160
+
161
+ // Example: Swarm Coordination Plugin
162
+ export class SwarmCoordinationPlugin implements DomainPlugin {
163
+ name = 'swarm-coordination';
164
+ version = '3.0.0';
165
+ dependencies = ['task-management', 'session-management'];
166
+
167
+ async initialize(kernel: ClaudeFlowKernel): Promise<void> {
168
+ const taskDomain = kernel.getDomain<TaskManagementDomain>('task-management');
169
+ const sessionDomain = kernel.getDomain<SessionManagementDomain>('session-management');
170
+
171
+ // Register swarm coordination services
172
+ this.swarmCoordinator = new UnifiedSwarmCoordinator(taskDomain, sessionDomain);
173
+ kernel.registerService('swarm-coordinator', this.swarmCoordinator);
174
+ }
175
+ }
176
+ ```
177
+
178
+ ## Domain Events & Integration
179
+
180
+ ### Event-Driven Communication
181
+ ```typescript
182
+ // core/shared/domain-events/
183
+ abstract class DomainEvent {
184
+ public readonly eventId: string;
185
+ public readonly aggregateId: string;
186
+ public readonly occurredOn: Date;
187
+ public readonly eventVersion: number;
188
+
189
+ constructor(aggregateId: string) {
190
+ this.eventId = crypto.randomUUID();
191
+ this.aggregateId = aggregateId;
192
+ this.occurredOn = new Date();
193
+ this.eventVersion = 1;
194
+ }
195
+ }
196
+
197
+ // Task domain events
198
+ export class TaskAssignedEvent extends DomainEvent {
199
+ constructor(
200
+ taskId: string,
201
+ public readonly agentId: string,
202
+ public readonly priority: Priority
203
+ ) {
204
+ super(taskId);
205
+ }
206
+ }
207
+
208
+ export class TaskCompletedEvent extends DomainEvent {
209
+ constructor(
210
+ taskId: string,
211
+ public readonly result: TaskResult,
212
+ public readonly duration: number
213
+ ) {
214
+ super(taskId);
215
+ }
216
+ }
217
+
218
+ // Event handlers
219
+ @EventHandler(TaskCompletedEvent)
220
+ export class TaskCompletedHandler {
221
+ constructor(
222
+ private metricsRepository: IMetricsRepository,
223
+ private sessionService: SessionLifecycleService
224
+ ) {}
225
+
226
+ async handle(event: TaskCompletedEvent): Promise<void> {
227
+ // Update metrics
228
+ await this.metricsRepository.recordTaskCompletion(
229
+ event.aggregateId,
230
+ event.duration
231
+ );
232
+
233
+ // Update session state
234
+ await this.sessionService.markTaskCompleted(
235
+ event.aggregateId,
236
+ event.result
237
+ );
238
+ }
239
+ }
240
+ ```
241
+
242
+ ## Clean Architecture Layers
243
+
244
+ ```typescript
245
+ // Architecture layers
246
+ ┌─────────────────────────────────────────┐
247
+ │ Presentation │ ← CLI, API, UI
248
+ ├─────────────────────────────────────────┤
249
+ │ Application │ ← Use Cases, Commands
250
+ ├─────────────────────────────────────────┤
251
+ │ Domain │ ← Entities, Services, Events
252
+ ├─────────────────────────────────────────┤
253
+ │ Infrastructure │ ← DB, MCP, External APIs
254
+ └─────────────────────────────────────────┘
255
+
256
+ // Dependency direction: Outside → Inside
257
+ // Domain layer has NO external dependencies
258
+ ```
259
+
260
+ ### Application Layer (Use Cases)
261
+ ```typescript
262
+ // core/application/use-cases/
263
+ export class AssignTaskUseCase {
264
+ constructor(
265
+ private taskRepository: ITaskRepository,
266
+ private agentRepository: IAgentRepository,
267
+ private eventBus: DomainEventBus
268
+ ) {}
269
+
270
+ async execute(command: AssignTaskCommand): Promise<TaskResult> {
271
+ // 1. Validate command
272
+ await this.validateCommand(command);
273
+
274
+ // 2. Load aggregates
275
+ const task = await this.taskRepository.findById(command.taskId);
276
+ const agent = await this.agentRepository.findById(command.agentId);
277
+
278
+ // 3. Business logic (in domain)
279
+ task.assignTo(agent);
280
+
281
+ // 4. Persist changes
282
+ await this.taskRepository.save(task);
283
+
284
+ // 5. Publish domain events
285
+ task.getUncommittedEvents().forEach(event =>
286
+ this.eventBus.publish(event)
287
+ );
288
+
289
+ // 6. Return result
290
+ return TaskResult.success(task);
291
+ }
292
+ }
293
+ ```
294
+
295
+ ## Module Configuration
296
+
297
+ ### Bounded Context Modules
298
+ ```typescript
299
+ // core/domains/task-management/module.ts
300
+ export const taskManagementModule = {
301
+ name: 'task-management',
302
+
303
+ entities: [
304
+ TaskEntity,
305
+ TaskQueueEntity
306
+ ],
307
+
308
+ valueObjects: [
309
+ TaskIdVO,
310
+ TaskStatusVO,
311
+ PriorityVO
312
+ ],
313
+
314
+ services: [
315
+ TaskSchedulingService,
316
+ TaskValidationService
317
+ ],
318
+
319
+ repositories: [
320
+ { provide: ITaskRepository, useClass: SqliteTaskRepository }
321
+ ],
322
+
323
+ eventHandlers: [
324
+ TaskAssignedHandler,
325
+ TaskCompletedHandler
326
+ ]
327
+ };
328
+ ```
329
+
330
+ ## Migration Strategy
331
+
332
+ ### Phase 1: Extract Domain Services
333
+ ```typescript
334
+ // Extract services from orchestrator.ts
335
+ const extractionPlan = {
336
+ week1: [
337
+ 'TaskManager → task-management domain',
338
+ 'SessionManager → session-management domain'
339
+ ],
340
+ week2: [
341
+ 'HealthMonitor → health-monitoring domain',
342
+ 'LifecycleManager → lifecycle-management domain'
343
+ ],
344
+ week3: [
345
+ 'EventCoordinator → event-coordination domain',
346
+ 'Wire up domain events'
347
+ ]
348
+ };
349
+ ```
350
+
351
+ ### Phase 2: Implement Clean Interfaces
352
+ ```typescript
353
+ // Clean separation with dependency injection
354
+ export class TaskController {
355
+ constructor(
356
+ @Inject('AssignTaskUseCase') private assignTask: AssignTaskUseCase,
357
+ @Inject('CompleteTaskUseCase') private completeTask: CompleteTaskUseCase
358
+ ) {}
359
+
360
+ async assign(request: AssignTaskRequest): Promise<TaskResponse> {
361
+ const command = AssignTaskCommand.fromRequest(request);
362
+ const result = await this.assignTask.execute(command);
363
+ return TaskResponse.fromResult(result);
364
+ }
365
+ }
366
+ ```
367
+
368
+ ### Phase 3: Plugin System
369
+ ```typescript
370
+ // Enable plugin-based extensions
371
+ const pluginSystem = {
372
+ core: ['task-management', 'session-management', 'health-monitoring'],
373
+ optional: ['swarm-coordination', 'learning-integration', 'performance-monitoring']
374
+ };
375
+ ```
376
+
377
+ ## Testing Strategy
378
+
379
+ ### Domain Testing (London School TDD)
380
+ ```typescript
381
+ // Pure domain logic testing
382
+ describe('Task Entity', () => {
383
+ let task: TaskEntity;
384
+ let mockAgent: jest.Mocked<AgentEntity>;
385
+
386
+ beforeEach(() => {
387
+ task = new TaskEntity(TaskId.create(), 'Test task');
388
+ mockAgent = createMock<AgentEntity>();
389
+ });
390
+
391
+ it('should assign to agent when valid', () => {
392
+ mockAgent.canAcceptTask.mockReturnValue(true);
393
+
394
+ task.assignTo(mockAgent);
395
+
396
+ expect(task.assignedAgent).toBe(mockAgent);
397
+ expect(task.status.value).toBe('assigned');
398
+ });
399
+
400
+ it('should emit TaskAssignedEvent when assigned', () => {
401
+ mockAgent.canAcceptTask.mockReturnValue(true);
402
+
403
+ task.assignTo(mockAgent);
404
+
405
+ const events = task.getUncommittedEvents();
406
+ expect(events).toHaveLength(1);
407
+ expect(events[0]).toBeInstanceOf(TaskAssignedEvent);
408
+ });
409
+ });
410
+ ```
411
+
412
+ ## Success Metrics
413
+
414
+ - [ ] **God Object Elimination**: orchestrator.ts (1,440 lines) → 5 focused domains (<300 lines each)
415
+ - [ ] **Bounded Context Isolation**: 100% domain independence
416
+ - [ ] **Plugin Architecture**: Core + optional modules loading
417
+ - [ ] **Clean Architecture**: Dependency inversion maintained
418
+ - [ ] **Event-Driven Communication**: Loose coupling between domains
419
+ - [ ] **Test Coverage**: >90% domain logic coverage
420
+
421
+ ## Related V3 Skills
422
+
423
+ - `v3-core-implementation` - Implementation of DDD domains
424
+ - `v3-memory-unification` - AgentDB integration within bounded contexts
425
+ - `v3-swarm-coordination` - Swarm coordination as domain plugin
426
+ - `v3-performance-optimization` - Performance optimization across domains
427
+
428
+ ## Usage Examples
429
+
430
+ ### Complete Domain Extraction
431
+ ```bash
432
+ # Full DDD architecture implementation
433
+ Task("DDD architecture implementation",
434
+ "Extract orchestrator into DDD domains with clean architecture",
435
+ "core-architect")
436
+ ```
437
+
438
+ ### Plugin Development
439
+ ```bash
440
+ # Create domain plugin
441
+ npm run create:plugin -- --name swarm-coordination --template domain
442
442
  ```