@claude-flow/cli 3.32.9 → 3.32.11

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 (447) hide show
  1. package/.claude/.proven-config-version +1 -0
  2. package/.claude/agents/analysis/analyze-code-quality.md +178 -178
  3. package/.claude/agents/analysis/code-analyzer.md +209 -209
  4. package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
  5. package/.claude/agents/architecture/arch-system-design.md +156 -156
  6. package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
  7. package/.claude/agents/browser/browser-agent.yaml +182 -182
  8. package/.claude/agents/consensus/byzantine-coordinator.md +62 -62
  9. package/.claude/agents/consensus/crdt-synchronizer.md +996 -996
  10. package/.claude/agents/consensus/gossip-coordinator.md +62 -62
  11. package/.claude/agents/consensus/performance-benchmarker.md +850 -850
  12. package/.claude/agents/consensus/quorum-manager.md +822 -822
  13. package/.claude/agents/consensus/raft-manager.md +62 -62
  14. package/.claude/agents/consensus/security-manager.md +621 -621
  15. package/.claude/agents/core/planner.md +374 -374
  16. package/.claude/agents/custom/test-long-runner.md +44 -44
  17. package/.claude/agents/data/data-ml-model.md +444 -444
  18. package/.claude/agents/data/ml/data-ml-model.md +192 -192
  19. package/.claude/agents/development/backend/dev-backend-api.md +141 -141
  20. package/.claude/agents/development/dev-backend-api.md +344 -344
  21. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
  22. package/.claude/agents/devops/ops-cicd-github.md +164 -164
  23. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
  24. package/.claude/agents/documentation/docs-api-openapi.md +354 -354
  25. package/.claude/agents/flow-nexus/app-store.md +87 -87
  26. package/.claude/agents/flow-nexus/authentication.md +68 -68
  27. package/.claude/agents/flow-nexus/challenges.md +80 -80
  28. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  29. package/.claude/agents/flow-nexus/payments.md +82 -82
  30. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  31. package/.claude/agents/flow-nexus/swarm.md +75 -75
  32. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  33. package/.claude/agents/flow-nexus/workflow.md +83 -83
  34. package/.claude/agents/github/code-review-swarm.md +377 -377
  35. package/.claude/agents/github/github-modes.md +172 -172
  36. package/.claude/agents/github/issue-tracker.md +575 -575
  37. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  38. package/.claude/agents/github/pr-manager.md +437 -437
  39. package/.claude/agents/github/project-board-sync.md +508 -508
  40. package/.claude/agents/github/release-manager.md +604 -604
  41. package/.claude/agents/github/release-swarm.md +582 -582
  42. package/.claude/agents/github/repo-architect.md +397 -397
  43. package/.claude/agents/github/swarm-issue.md +572 -572
  44. package/.claude/agents/github/swarm-pr.md +427 -427
  45. package/.claude/agents/github/sync-coordinator.md +451 -451
  46. package/.claude/agents/github/workflow-automation.md +902 -902
  47. package/.claude/agents/goal/agent.md +815 -815
  48. package/.claude/agents/optimization/benchmark-suite.md +664 -664
  49. package/.claude/agents/optimization/load-balancer.md +430 -430
  50. package/.claude/agents/optimization/performance-monitor.md +671 -671
  51. package/.claude/agents/optimization/resource-allocator.md +673 -673
  52. package/.claude/agents/optimization/topology-optimizer.md +807 -807
  53. package/.claude/agents/payments/agentic-payments.md +126 -126
  54. package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
  55. package/.claude/agents/sparc/architecture.md +698 -698
  56. package/.claude/agents/sparc/pseudocode.md +519 -519
  57. package/.claude/agents/sparc/refinement.md +801 -801
  58. package/.claude/agents/sparc/specification.md +477 -477
  59. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
  60. package/.claude/agents/specialized/spec-mobile-react-native.md +226 -226
  61. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  62. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  63. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  64. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  65. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  66. package/.claude/agents/swarm/adaptive-coordinator.md +1126 -1126
  67. package/.claude/agents/swarm/hierarchical-coordinator.md +709 -709
  68. package/.claude/agents/swarm/mesh-coordinator.md +962 -962
  69. package/.claude/agents/templates/automation-smart-agent.md +204 -204
  70. package/.claude/agents/templates/base-template-generator.md +289 -289
  71. package/.claude/agents/templates/coordinator-swarm-init.md +89 -89
  72. package/.claude/agents/templates/github-pr-manager.md +176 -176
  73. package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
  74. package/.claude/agents/templates/memory-coordinator.md +186 -186
  75. package/.claude/agents/templates/orchestrator-task.md +138 -138
  76. package/.claude/agents/templates/performance-analyzer.md +198 -198
  77. package/.claude/agents/templates/sparc-coordinator.md +513 -513
  78. package/.claude/agents/testing/production-validator.md +394 -394
  79. package/.claude/agents/testing/tdd-london-swarm.md +243 -243
  80. package/.claude/agents/v3/aidefence-guardian.md +282 -282
  81. package/.claude/agents/v3/claims-authorizer.md +208 -208
  82. package/.claude/agents/v3/collective-intelligence-coordinator.md +993 -993
  83. package/.claude/agents/v3/ddd-domain-expert.md +220 -220
  84. package/.claude/agents/v3/injection-analyst.md +236 -236
  85. package/.claude/agents/v3/performance-engineer.md +1233 -1233
  86. package/.claude/agents/v3/pii-detector.md +151 -151
  87. package/.claude/agents/v3/reasoningbank-learner.md +213 -213
  88. package/.claude/agents/v3/security-architect-aidefence.md +410 -410
  89. package/.claude/agents/v3/security-architect.md +867 -867
  90. package/.claude/agents/v3/swarm-memory-manager.md +157 -157
  91. package/.claude/agents/v3/v3-integration-architect.md +205 -205
  92. package/.claude/commands/agents/README.md +50 -50
  93. package/.claude/commands/agents/agent-capabilities.md +140 -140
  94. package/.claude/commands/agents/agent-coordination.md +28 -28
  95. package/.claude/commands/agents/agent-spawning.md +28 -28
  96. package/.claude/commands/agents/agent-types.md +216 -216
  97. package/.claude/commands/agents/health.md +139 -139
  98. package/.claude/commands/agents/list.md +100 -100
  99. package/.claude/commands/agents/logs.md +130 -130
  100. package/.claude/commands/agents/metrics.md +122 -122
  101. package/.claude/commands/agents/pool.md +127 -127
  102. package/.claude/commands/agents/spawn.md +140 -140
  103. package/.claude/commands/agents/status.md +115 -115
  104. package/.claude/commands/agents/stop.md +102 -102
  105. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  106. package/.claude/commands/analysis/README.md +9 -9
  107. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  108. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  109. package/.claude/commands/analysis/performance-report.md +25 -25
  110. package/.claude/commands/analysis/token-efficiency.md +44 -44
  111. package/.claude/commands/analysis/token-usage.md +25 -25
  112. package/.claude/commands/automation/README.md +9 -9
  113. package/.claude/commands/automation/auto-agent.md +122 -122
  114. package/.claude/commands/automation/self-healing.md +105 -105
  115. package/.claude/commands/automation/session-memory.md +89 -89
  116. package/.claude/commands/automation/smart-agents.md +72 -72
  117. package/.claude/commands/automation/smart-spawn.md +25 -25
  118. package/.claude/commands/automation/workflow-select.md +25 -25
  119. package/.claude/commands/claude-flow-help.md +103 -103
  120. package/.claude/commands/claude-flow-memory.md +107 -107
  121. package/.claude/commands/claude-flow-swarm.md +205 -205
  122. package/.claude/commands/coordination/README.md +9 -9
  123. package/.claude/commands/coordination/agent-spawn.md +25 -25
  124. package/.claude/commands/coordination/init.md +44 -44
  125. package/.claude/commands/coordination/orchestrate.md +43 -43
  126. package/.claude/commands/coordination/spawn.md +45 -45
  127. package/.claude/commands/coordination/swarm-init.md +85 -85
  128. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  129. package/.claude/commands/github/README.md +11 -11
  130. package/.claude/commands/github/code-review-swarm.md +513 -513
  131. package/.claude/commands/github/code-review.md +25 -25
  132. package/.claude/commands/github/github-modes.md +146 -146
  133. package/.claude/commands/github/github-swarm.md +121 -121
  134. package/.claude/commands/github/issue-tracker.md +291 -291
  135. package/.claude/commands/github/issue-triage.md +25 -25
  136. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  137. package/.claude/commands/github/pr-enhance.md +26 -26
  138. package/.claude/commands/github/pr-manager.md +169 -169
  139. package/.claude/commands/github/project-board-sync.md +470 -470
  140. package/.claude/commands/github/release-manager.md +339 -339
  141. package/.claude/commands/github/release-swarm.md +543 -543
  142. package/.claude/commands/github/repo-analyze.md +25 -25
  143. package/.claude/commands/github/repo-architect.md +366 -366
  144. package/.claude/commands/github/swarm-issue.md +484 -484
  145. package/.claude/commands/github/swarm-pr.md +287 -287
  146. package/.claude/commands/github/sync-coordinator.md +302 -302
  147. package/.claude/commands/github/workflow-automation.md +441 -441
  148. package/.claude/commands/hive-mind/README.md +17 -17
  149. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  150. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  151. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  152. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  153. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  154. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  155. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  156. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  157. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  158. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  159. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  160. package/.claude/commands/hooks/README.md +11 -11
  161. package/.claude/commands/hooks/overview.md +57 -57
  162. package/.claude/commands/hooks/post-edit.md +117 -117
  163. package/.claude/commands/hooks/post-task.md +112 -112
  164. package/.claude/commands/hooks/pre-edit.md +113 -113
  165. package/.claude/commands/hooks/pre-task.md +111 -111
  166. package/.claude/commands/hooks/session-end.md +118 -118
  167. package/.claude/commands/hooks/setup.md +102 -102
  168. package/.claude/commands/memory/README.md +9 -9
  169. package/.claude/commands/memory/memory-persist.md +25 -25
  170. package/.claude/commands/memory/memory-search.md +25 -25
  171. package/.claude/commands/memory/memory-usage.md +25 -25
  172. package/.claude/commands/memory/neural.md +47 -47
  173. package/.claude/commands/monitoring/README.md +9 -9
  174. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  175. package/.claude/commands/monitoring/agents.md +44 -44
  176. package/.claude/commands/monitoring/real-time-view.md +25 -25
  177. package/.claude/commands/monitoring/status.md +46 -46
  178. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  179. package/.claude/commands/optimization/README.md +9 -9
  180. package/.claude/commands/optimization/auto-topology.md +61 -61
  181. package/.claude/commands/optimization/cache-manage.md +25 -25
  182. package/.claude/commands/optimization/parallel-execute.md +25 -25
  183. package/.claude/commands/optimization/parallel-execution.md +49 -49
  184. package/.claude/commands/optimization/topology-optimize.md +25 -25
  185. package/.claude/commands/pair/README.md +260 -260
  186. package/.claude/commands/pair/commands.md +545 -545
  187. package/.claude/commands/pair/config.md +509 -509
  188. package/.claude/commands/pair/examples.md +511 -511
  189. package/.claude/commands/pair/modes.md +347 -347
  190. package/.claude/commands/pair/session.md +406 -406
  191. package/.claude/commands/pair/start.md +208 -208
  192. package/.claude/commands/sparc/analyzer.md +51 -51
  193. package/.claude/commands/sparc/architect.md +53 -53
  194. package/.claude/commands/sparc/ask.md +97 -97
  195. package/.claude/commands/sparc/batch-executor.md +54 -54
  196. package/.claude/commands/sparc/code.md +89 -89
  197. package/.claude/commands/sparc/coder.md +54 -54
  198. package/.claude/commands/sparc/debug.md +83 -83
  199. package/.claude/commands/sparc/debugger.md +54 -54
  200. package/.claude/commands/sparc/designer.md +53 -53
  201. package/.claude/commands/sparc/devops.md +109 -109
  202. package/.claude/commands/sparc/docs-writer.md +80 -80
  203. package/.claude/commands/sparc/documenter.md +54 -54
  204. package/.claude/commands/sparc/innovator.md +54 -54
  205. package/.claude/commands/sparc/integration.md +83 -83
  206. package/.claude/commands/sparc/mcp.md +117 -117
  207. package/.claude/commands/sparc/memory-manager.md +54 -54
  208. package/.claude/commands/sparc/optimizer.md +54 -54
  209. package/.claude/commands/sparc/orchestrator.md +131 -131
  210. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  211. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  212. package/.claude/commands/sparc/researcher.md +54 -54
  213. package/.claude/commands/sparc/reviewer.md +54 -54
  214. package/.claude/commands/sparc/security-review.md +80 -80
  215. package/.claude/commands/sparc/sparc-modes.md +174 -174
  216. package/.claude/commands/sparc/sparc.md +111 -111
  217. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  218. package/.claude/commands/sparc/supabase-admin.md +348 -348
  219. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  220. package/.claude/commands/sparc/tdd.md +54 -54
  221. package/.claude/commands/sparc/tester.md +54 -54
  222. package/.claude/commands/sparc/tutorial.md +79 -79
  223. package/.claude/commands/sparc/workflow-manager.md +54 -54
  224. package/.claude/commands/sparc.md +166 -166
  225. package/.claude/commands/stream-chain/pipeline.md +120 -120
  226. package/.claude/commands/stream-chain/run.md +69 -69
  227. package/.claude/commands/swarm/README.md +15 -15
  228. package/.claude/commands/swarm/analysis.md +95 -95
  229. package/.claude/commands/swarm/development.md +96 -96
  230. package/.claude/commands/swarm/examples.md +168 -168
  231. package/.claude/commands/swarm/maintenance.md +102 -102
  232. package/.claude/commands/swarm/optimization.md +117 -117
  233. package/.claude/commands/swarm/research.md +136 -136
  234. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  235. package/.claude/commands/swarm/swarm-background.md +8 -8
  236. package/.claude/commands/swarm/swarm-init.md +19 -19
  237. package/.claude/commands/swarm/swarm-modes.md +8 -8
  238. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  239. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  240. package/.claude/commands/swarm/swarm-status.md +8 -8
  241. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  242. package/.claude/commands/swarm/swarm.md +87 -87
  243. package/.claude/commands/swarm/testing.md +131 -131
  244. package/.claude/commands/training/README.md +9 -9
  245. package/.claude/commands/training/model-update.md +25 -25
  246. package/.claude/commands/training/neural-patterns.md +107 -107
  247. package/.claude/commands/training/neural-train.md +75 -75
  248. package/.claude/commands/training/pattern-learn.md +25 -25
  249. package/.claude/commands/training/specialization.md +62 -62
  250. package/.claude/commands/truth/start.md +142 -142
  251. package/.claude/commands/verify/check.md +49 -49
  252. package/.claude/commands/verify/start.md +127 -127
  253. package/.claude/commands/workflows/README.md +9 -9
  254. package/.claude/commands/workflows/development.md +77 -77
  255. package/.claude/commands/workflows/research.md +62 -62
  256. package/.claude/commands/workflows/workflow-create.md +25 -25
  257. package/.claude/commands/workflows/workflow-execute.md +25 -25
  258. package/.claude/commands/workflows/workflow-export.md +25 -25
  259. package/.claude/eval/human-relevance-frozen-v1.json +17 -17
  260. package/.claude/evolve-proof/generation-0.json +211 -211
  261. package/.claude/evolve-proof/real-generation-0.json +406 -406
  262. package/.claude/evolve-proof/real-generation-1.json +406 -406
  263. package/.claude/helpers/.helpers-version +1 -1
  264. package/.claude/helpers/README.md +96 -96
  265. package/.claude/helpers/adr-compliance.sh +186 -186
  266. package/.claude/helpers/auto-commit.sh +178 -178
  267. package/.claude/helpers/auto-memory-hook.mjs +0 -0
  268. package/.claude/helpers/checkpoint-manager.sh +251 -251
  269. package/.claude/helpers/daemon-manager.sh +252 -252
  270. package/.claude/helpers/ddd-tracker.sh +144 -144
  271. package/.claude/helpers/github-safe.js +156 -156
  272. package/.claude/helpers/github-setup.sh +45 -45
  273. package/.claude/helpers/guidance-hook.sh +13 -13
  274. package/.claude/helpers/guidance-hooks.sh +102 -102
  275. package/.claude/helpers/health-monitor.sh +108 -108
  276. package/.claude/helpers/helpers.manifest.json +2 -2
  277. package/.claude/helpers/hook-handler.cjs +0 -0
  278. package/.claude/helpers/intelligence.cjs +0 -0
  279. package/.claude/helpers/learning-hooks.sh +329 -329
  280. package/.claude/helpers/learning-optimizer.sh +127 -127
  281. package/.claude/helpers/learning-service.mjs +1144 -1144
  282. package/.claude/helpers/memory.js +83 -83
  283. package/.claude/helpers/metrics-db.mjs +503 -503
  284. package/.claude/helpers/pattern-consolidator.sh +86 -86
  285. package/.claude/helpers/perf-worker.sh +160 -160
  286. package/.claude/helpers/post-commit +16 -16
  287. package/.claude/helpers/pre-commit +26 -26
  288. package/.claude/helpers/quick-start.sh +19 -19
  289. package/.claude/helpers/router.js +105 -105
  290. package/.claude/helpers/security-scanner.sh +127 -127
  291. package/.claude/helpers/session.js +157 -157
  292. package/.claude/helpers/setup-mcp.sh +18 -18
  293. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  294. package/.claude/helpers/statusline-hook.sh +21 -21
  295. package/.claude/helpers/statusline.cjs +0 -0
  296. package/.claude/helpers/statusline.js +340 -340
  297. package/.claude/helpers/swarm-comms.sh +353 -353
  298. package/.claude/helpers/swarm-hooks.sh +761 -761
  299. package/.claude/helpers/swarm-monitor.sh +210 -210
  300. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  301. package/.claude/helpers/update-v3-progress.sh +165 -165
  302. package/.claude/helpers/v3-quick-status.sh +57 -57
  303. package/.claude/helpers/v3.sh +110 -110
  304. package/.claude/helpers/validate-v3-config.sh +215 -215
  305. package/.claude/helpers/worker-manager.sh +170 -170
  306. package/.claude/proven-config.json +42 -0
  307. package/.claude/proven-config.manifest.json +37 -37
  308. package/.claude/proven-config.signed.json +41 -41
  309. package/.claude/settings.json +182 -182
  310. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  311. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  312. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  313. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  314. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  315. package/.claude/skills/browser/SKILL.md +204 -204
  316. package/.claude/skills/dual-mode/README.md +71 -71
  317. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  318. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  319. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  320. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  321. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  322. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  323. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  324. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  325. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  326. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  327. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  328. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  329. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  330. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  331. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  332. package/.claude/skills/skill-builder/SKILL.md +910 -910
  333. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  334. package/.claude/skills/stream-chain/SKILL.md +560 -560
  335. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  336. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  337. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  338. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  339. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  340. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  341. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  342. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  343. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  344. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  345. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  346. package/.claude/skills/verification-quality/SKILL.md +691 -691
  347. package/README.md +419 -419
  348. package/bin/cli.js +314 -314
  349. package/bin/mcp-server.js +224 -224
  350. package/bin/preinstall.cjs +2 -2
  351. package/catalog-manifest.json +2 -2
  352. package/dist/src/autopilot-state.js +24 -7
  353. package/dist/src/benchmarks/gaia-critic.js +24 -24
  354. package/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  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/hive-mind.js +97 -97
  359. package/dist/src/commands/hooks.js +31 -10
  360. package/dist/src/commands/init.js +202 -34
  361. package/dist/src/commands/memory.js +12 -1
  362. package/dist/src/commands/ruvector/backup.js +23 -23
  363. package/dist/src/commands/ruvector/benchmark.js +31 -31
  364. package/dist/src/commands/ruvector/import.js +14 -14
  365. package/dist/src/commands/ruvector/init.js +115 -115
  366. package/dist/src/commands/ruvector/migrate.js +99 -99
  367. package/dist/src/commands/ruvector/optimize.js +51 -51
  368. package/dist/src/commands/ruvector/setup.js +624 -624
  369. package/dist/src/commands/ruvector/status.js +38 -38
  370. package/dist/src/config/proven-config.js +2 -2
  371. package/dist/src/funnel/disclosure.js +13 -2
  372. package/dist/src/funnel/messages.d.ts +12 -10
  373. package/dist/src/funnel/messages.js +83 -11
  374. package/dist/src/init/claudemd-generator.js +231 -231
  375. package/dist/src/init/executor.js +453 -453
  376. package/dist/src/init/helper-signing.js +2 -2
  377. package/dist/src/init/helpers-generator.js +751 -751
  378. package/dist/src/init/statusline-generator.js +24 -24
  379. package/dist/src/mcp-tools/agentdb-tools.js +15 -15
  380. package/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  381. package/dist/src/mcp-tools/browser-tools.js +8 -0
  382. package/dist/src/mcp-tools/hooks-tools.js +21 -0
  383. package/dist/src/mcp-tools/memory-tools.js +4 -3
  384. package/dist/src/memory/graph-edge-writer.js +22 -22
  385. package/dist/src/memory/memory-bridge.js +248 -158
  386. package/dist/src/memory/memory-initializer.js +407 -407
  387. package/dist/src/memory/rabitq-index.js +5 -5
  388. package/dist/src/parser.js +25 -9
  389. package/dist/src/proxy/verify.js +2 -2
  390. package/dist/src/runtime/headless.js +28 -28
  391. package/dist/src/services/distill-tuning.js +7 -7
  392. package/dist/src/services/headless-worker-executor.js +84 -84
  393. package/dist/src/services/memory-distillation.js +4 -4
  394. package/dist/src/services/worker-daemon.js +7 -4
  395. package/dist/src/transfer/deploy-seraphine.js +23 -23
  396. package/package.json +137 -137
  397. package/plugins/ruflo-metaharness/.claude-plugin/plugin.json +32 -32
  398. package/plugins/ruflo-metaharness/README.md +72 -72
  399. package/plugins/ruflo-metaharness/agents/metaharness-architect.md +58 -58
  400. package/plugins/ruflo-metaharness/commands/ruflo-metaharness.md +48 -48
  401. package/plugins/ruflo-metaharness/scripts/_darwin.mjs +210 -210
  402. package/plugins/ruflo-metaharness/scripts/_harness.mjs +330 -330
  403. package/plugins/ruflo-metaharness/scripts/_invoke.mjs +231 -231
  404. package/plugins/ruflo-metaharness/scripts/_redblue.mjs +143 -143
  405. package/plugins/ruflo-metaharness/scripts/_similarity.mjs +161 -161
  406. package/plugins/ruflo-metaharness/scripts/_spike-similarity.mjs +223 -223
  407. package/plugins/ruflo-metaharness/scripts/audit-list.mjs +158 -158
  408. package/plugins/ruflo-metaharness/scripts/audit-trend.mjs +272 -272
  409. package/plugins/ruflo-metaharness/scripts/bench-parse-mcp-scan.mjs +146 -146
  410. package/plugins/ruflo-metaharness/scripts/bench-recordpair-overhead.mjs +186 -186
  411. package/plugins/ruflo-metaharness/scripts/bench-similarity.mjs +177 -177
  412. package/plugins/ruflo-metaharness/scripts/bench.mjs +95 -95
  413. package/plugins/ruflo-metaharness/scripts/drift-from-history.mjs +363 -363
  414. package/plugins/ruflo-metaharness/scripts/evolve.mjs +404 -404
  415. package/plugins/ruflo-metaharness/scripts/genome.mjs +80 -80
  416. package/plugins/ruflo-metaharness/scripts/gepa.mjs +153 -153
  417. package/plugins/ruflo-metaharness/scripts/learn.mjs +127 -127
  418. package/plugins/ruflo-metaharness/scripts/mcp-scan.mjs +111 -111
  419. package/plugins/ruflo-metaharness/scripts/mint.mjs +126 -126
  420. package/plugins/ruflo-metaharness/scripts/oia-audit.mjs +228 -228
  421. package/plugins/ruflo-metaharness/scripts/redblue.mjs +286 -286
  422. package/plugins/ruflo-metaharness/scripts/router-parallel-analyze.mjs +250 -250
  423. package/plugins/ruflo-metaharness/scripts/score.mjs +92 -92
  424. package/plugins/ruflo-metaharness/scripts/security-bench.mjs +174 -174
  425. package/plugins/ruflo-metaharness/scripts/similarity.mjs +158 -158
  426. package/plugins/ruflo-metaharness/scripts/smoke.sh +2356 -2356
  427. package/plugins/ruflo-metaharness/scripts/test-graceful-degradation.mjs +165 -165
  428. package/plugins/ruflo-metaharness/scripts/test-mcp-tools.mjs +472 -472
  429. package/plugins/ruflo-metaharness/scripts/test-parallel-pipeline.mjs +204 -204
  430. package/plugins/ruflo-metaharness/scripts/test-pipeline-roundtrip.mjs +586 -586
  431. package/plugins/ruflo-metaharness/scripts/test-similarity.mjs +334 -334
  432. package/plugins/ruflo-metaharness/scripts/test-with-openrouter.mjs +229 -229
  433. package/plugins/ruflo-metaharness/scripts/threat-model.mjs +59 -59
  434. package/plugins/ruflo-metaharness/skills/harness-bench/SKILL.md +64 -64
  435. package/plugins/ruflo-metaharness/skills/harness-drift-from-history/SKILL.md +65 -65
  436. package/plugins/ruflo-metaharness/skills/harness-evolve/SKILL.md +131 -131
  437. package/plugins/ruflo-metaharness/skills/harness-genome/SKILL.md +54 -54
  438. package/plugins/ruflo-metaharness/skills/harness-gepa/SKILL.md +65 -65
  439. package/plugins/ruflo-metaharness/skills/harness-learn/SKILL.md +65 -65
  440. package/plugins/ruflo-metaharness/skills/harness-mcp-scan/SKILL.md +49 -49
  441. package/plugins/ruflo-metaharness/skills/harness-mint/SKILL.md +72 -72
  442. package/plugins/ruflo-metaharness/skills/harness-oia-audit/SKILL.md +79 -79
  443. package/plugins/ruflo-metaharness/skills/harness-score/SKILL.md +66 -66
  444. package/plugins/ruflo-metaharness/skills/harness-security-bench/SKILL.md +101 -101
  445. package/plugins/ruflo-metaharness/skills/harness-similarity/SKILL.md +67 -67
  446. package/plugins/ruflo-metaharness/skills/harness-threat-model/SKILL.md +41 -41
  447. 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
  ```