claude-flow 3.28.0 → 3.29.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 (679) hide show
  1. package/.claude/agents/MIGRATION_SUMMARY.md +221 -221
  2. package/.claude/agents/analysis/analyze-code-quality.md +57 -57
  3. package/.claude/agents/analysis/code-analyzer.md +188 -188
  4. package/.claude/agents/analysis/code-review/analyze-code-quality.md +57 -57
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +35 -35
  6. package/.claude/agents/base-template-generator.md +41 -41
  7. package/.claude/agents/consensus/byzantine-coordinator.md +42 -42
  8. package/.claude/agents/consensus/crdt-synchronizer.md +976 -976
  9. package/.claude/agents/consensus/gossip-coordinator.md +42 -42
  10. package/.claude/agents/consensus/performance-benchmarker.md +830 -830
  11. package/.claude/agents/consensus/quorum-manager.md +802 -802
  12. package/.claude/agents/consensus/raft-manager.md +42 -42
  13. package/.claude/agents/consensus/security-manager.md +601 -601
  14. package/.claude/agents/core/coder.md +254 -254
  15. package/.claude/agents/core/planner.md +151 -151
  16. package/.claude/agents/core/researcher.md +173 -173
  17. package/.claude/agents/core/reviewer.md +308 -308
  18. package/.claude/agents/core/tester.md +299 -299
  19. package/.claude/agents/custom/test-long-runner.md +43 -43
  20. package/.claude/agents/data/ml/data-ml-model.md +75 -75
  21. package/.claude/agents/database-specialist.md +9 -9
  22. package/.claude/agents/development/backend/dev-backend-api.md +28 -28
  23. package/.claude/agents/development/dev-backend-api.md +177 -177
  24. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +51 -51
  25. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +62 -62
  26. package/.claude/agents/dual-mode/codex-coordinator.md +206 -206
  27. package/.claude/agents/dual-mode/codex-worker.md +190 -190
  28. package/.claude/agents/dual-mode/dual-orchestrator.md +253 -253
  29. package/.claude/agents/flow-nexus/app-store.md +87 -87
  30. package/.claude/agents/flow-nexus/authentication.md +68 -68
  31. package/.claude/agents/flow-nexus/challenges.md +80 -80
  32. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  33. package/.claude/agents/flow-nexus/payments.md +82 -82
  34. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  35. package/.claude/agents/flow-nexus/swarm.md +75 -75
  36. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  37. package/.claude/agents/flow-nexus/workflow.md +83 -83
  38. package/.claude/agents/github/code-review-swarm.md +520 -520
  39. package/.claude/agents/github/github-modes.md +153 -153
  40. package/.claude/agents/github/issue-tracker.md +298 -298
  41. package/.claude/agents/github/multi-repo-swarm.md +524 -524
  42. package/.claude/agents/github/pr-manager.md +162 -162
  43. package/.claude/agents/github/project-board-sync.md +477 -477
  44. package/.claude/agents/github/release-manager.md +337 -337
  45. package/.claude/agents/github/release-swarm.md +550 -550
  46. package/.claude/agents/github/repo-architect.md +364 -364
  47. package/.claude/agents/github/swarm-issue.md +550 -550
  48. package/.claude/agents/github/swarm-pr.md +401 -401
  49. package/.claude/agents/github/sync-coordinator.md +424 -424
  50. package/.claude/agents/github/workflow-automation.md +604 -604
  51. package/.claude/agents/goal/agent.md +816 -816
  52. package/.claude/agents/goal/code-goal-planner.md +444 -444
  53. package/.claude/agents/goal/goal-planner.md +167 -167
  54. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +128 -128
  55. package/.claude/agents/hive-mind/queen-coordinator.md +201 -201
  56. package/.claude/agents/hive-mind/scout-explorer.md +240 -240
  57. package/.claude/agents/hive-mind/swarm-memory-manager.md +191 -191
  58. package/.claude/agents/hive-mind/worker-specialist.md +215 -215
  59. package/.claude/agents/neural/safla-neural.md +73 -73
  60. package/.claude/agents/optimization/benchmark-suite.md +662 -662
  61. package/.claude/agents/optimization/load-balancer.md +428 -428
  62. package/.claude/agents/optimization/performance-monitor.md +669 -669
  63. package/.claude/agents/optimization/resource-allocator.md +671 -671
  64. package/.claude/agents/optimization/topology-optimizer.md +805 -805
  65. package/.claude/agents/payments/agentic-payments.md +126 -126
  66. package/.claude/agents/project-coordinator.md +8 -8
  67. package/.claude/agents/python-specialist.md +9 -9
  68. package/.claude/agents/reasoning/agent.md +816 -816
  69. package/.claude/agents/reasoning/goal-planner.md +72 -72
  70. package/.claude/agents/security-auditor.md +9 -9
  71. package/.claude/agents/sona/sona-learning-optimizer.md +65 -65
  72. package/.claude/agents/sparc/architecture.md +452 -452
  73. package/.claude/agents/sparc/pseudocode.md +298 -298
  74. package/.claude/agents/sparc/refinement.md +503 -503
  75. package/.claude/agents/sparc/specification.md +257 -257
  76. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +87 -87
  77. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  78. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  79. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  80. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  81. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  82. package/.claude/agents/swarm/adaptive-coordinator.md +363 -363
  83. package/.claude/agents/swarm/hierarchical-coordinator.md +299 -299
  84. package/.claude/agents/swarm/mesh-coordinator.md +362 -362
  85. package/.claude/agents/templates/automation-smart-agent.md +184 -184
  86. package/.claude/agents/templates/coordinator-swarm-init.md +82 -82
  87. package/.claude/agents/templates/github-pr-manager.md +154 -154
  88. package/.claude/agents/templates/implementer-sparc-coder.md +242 -242
  89. package/.claude/agents/templates/memory-coordinator.md +162 -162
  90. package/.claude/agents/templates/migration-plan.md +723 -723
  91. package/.claude/agents/templates/orchestrator-task.md +119 -119
  92. package/.claude/agents/templates/performance-analyzer.md +178 -178
  93. package/.claude/agents/templates/sparc-coordinator.md +162 -162
  94. package/.claude/agents/testing/production-validator.md +372 -372
  95. package/.claude/agents/testing/tdd-london-swarm.md +221 -221
  96. package/.claude/agents/testing/unit/tdd-london-swarm.md +221 -221
  97. package/.claude/agents/testing/validation/production-validator.md +372 -372
  98. package/.claude/agents/typescript-specialist.md +9 -9
  99. package/.claude/agents/v3/database-specialist.md +9 -9
  100. package/.claude/agents/v3/project-coordinator.md +8 -8
  101. package/.claude/agents/v3/python-specialist.md +9 -9
  102. package/.claude/agents/v3/test-architect.md +9 -9
  103. package/.claude/agents/v3/typescript-specialist.md +9 -9
  104. package/.claude/agents/v3/v3-integration-architect.md +311 -311
  105. package/.claude/agents/v3/v3-memory-specialist.md +280 -280
  106. package/.claude/agents/v3/v3-performance-engineer.md +362 -362
  107. package/.claude/agents/v3/v3-queen-coordinator.md +62 -62
  108. package/.claude/agents/v3/v3-security-architect.md +139 -139
  109. package/.claude/checkpoints/1767754460.json +8 -8
  110. package/.claude/commands/agents/README.md +10 -10
  111. package/.claude/commands/agents/agent-capabilities.md +21 -21
  112. package/.claude/commands/agents/agent-coordination.md +28 -28
  113. package/.claude/commands/agents/agent-spawning.md +28 -28
  114. package/.claude/commands/agents/agent-types.md +26 -26
  115. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  116. package/.claude/commands/analysis/README.md +9 -9
  117. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  118. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  119. package/.claude/commands/analysis/performance-report.md +25 -25
  120. package/.claude/commands/analysis/token-efficiency.md +44 -44
  121. package/.claude/commands/analysis/token-usage.md +25 -25
  122. package/.claude/commands/automation/README.md +9 -9
  123. package/.claude/commands/automation/auto-agent.md +122 -122
  124. package/.claude/commands/automation/self-healing.md +105 -105
  125. package/.claude/commands/automation/session-memory.md +89 -89
  126. package/.claude/commands/automation/smart-agents.md +72 -72
  127. package/.claude/commands/automation/smart-spawn.md +25 -25
  128. package/.claude/commands/automation/workflow-select.md +25 -25
  129. package/.claude/commands/claude-flow-help.md +103 -103
  130. package/.claude/commands/claude-flow-memory.md +107 -107
  131. package/.claude/commands/claude-flow-swarm.md +205 -205
  132. package/.claude/commands/coordination/README.md +9 -9
  133. package/.claude/commands/coordination/agent-spawn.md +25 -25
  134. package/.claude/commands/coordination/init.md +44 -44
  135. package/.claude/commands/coordination/orchestrate.md +43 -43
  136. package/.claude/commands/coordination/spawn.md +45 -45
  137. package/.claude/commands/coordination/swarm-init.md +85 -85
  138. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  139. package/.claude/commands/flow-nexus/app-store.md +123 -123
  140. package/.claude/commands/flow-nexus/challenges.md +119 -119
  141. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  142. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  143. package/.claude/commands/flow-nexus/payments.md +115 -115
  144. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  145. package/.claude/commands/flow-nexus/swarm.md +86 -86
  146. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  147. package/.claude/commands/flow-nexus/workflow.md +114 -114
  148. package/.claude/commands/github/README.md +11 -11
  149. package/.claude/commands/github/code-review-swarm.md +513 -513
  150. package/.claude/commands/github/code-review.md +25 -25
  151. package/.claude/commands/github/github-modes.md +146 -146
  152. package/.claude/commands/github/github-swarm.md +121 -121
  153. package/.claude/commands/github/issue-tracker.md +291 -291
  154. package/.claude/commands/github/issue-triage.md +25 -25
  155. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  156. package/.claude/commands/github/pr-enhance.md +26 -26
  157. package/.claude/commands/github/pr-manager.md +169 -169
  158. package/.claude/commands/github/project-board-sync.md +470 -470
  159. package/.claude/commands/github/release-manager.md +337 -337
  160. package/.claude/commands/github/release-swarm.md +543 -543
  161. package/.claude/commands/github/repo-analyze.md +25 -25
  162. package/.claude/commands/github/repo-architect.md +366 -366
  163. package/.claude/commands/github/swarm-issue.md +481 -481
  164. package/.claude/commands/github/swarm-pr.md +284 -284
  165. package/.claude/commands/github/sync-coordinator.md +300 -300
  166. package/.claude/commands/github/workflow-automation.md +441 -441
  167. package/.claude/commands/hive-mind/README.md +17 -17
  168. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  169. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  170. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  171. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  172. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  173. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  174. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  175. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  176. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  177. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  178. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  179. package/.claude/commands/hooks/README.md +11 -11
  180. package/.claude/commands/hooks/overview.md +57 -57
  181. package/.claude/commands/hooks/post-edit.md +117 -117
  182. package/.claude/commands/hooks/post-task.md +112 -112
  183. package/.claude/commands/hooks/pre-edit.md +113 -113
  184. package/.claude/commands/hooks/pre-task.md +111 -111
  185. package/.claude/commands/hooks/session-end.md +118 -118
  186. package/.claude/commands/hooks/setup.md +102 -102
  187. package/.claude/commands/memory/README.md +9 -9
  188. package/.claude/commands/memory/memory-persist.md +25 -25
  189. package/.claude/commands/memory/memory-search.md +25 -25
  190. package/.claude/commands/memory/memory-usage.md +25 -25
  191. package/.claude/commands/memory/neural.md +47 -47
  192. package/.claude/commands/monitoring/README.md +9 -9
  193. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  194. package/.claude/commands/monitoring/agents.md +44 -44
  195. package/.claude/commands/monitoring/real-time-view.md +25 -25
  196. package/.claude/commands/monitoring/status.md +46 -46
  197. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  198. package/.claude/commands/optimization/README.md +9 -9
  199. package/.claude/commands/optimization/auto-topology.md +61 -61
  200. package/.claude/commands/optimization/cache-manage.md +25 -25
  201. package/.claude/commands/optimization/parallel-execute.md +25 -25
  202. package/.claude/commands/optimization/parallel-execution.md +49 -49
  203. package/.claude/commands/optimization/topology-optimize.md +25 -25
  204. package/.claude/commands/pair/README.md +260 -260
  205. package/.claude/commands/pair/commands.md +545 -545
  206. package/.claude/commands/pair/config.md +509 -509
  207. package/.claude/commands/pair/examples.md +511 -511
  208. package/.claude/commands/pair/modes.md +347 -347
  209. package/.claude/commands/pair/session.md +406 -406
  210. package/.claude/commands/pair/start.md +208 -208
  211. package/.claude/commands/sparc/analyzer.md +51 -51
  212. package/.claude/commands/sparc/architect.md +53 -53
  213. package/.claude/commands/sparc/ask.md +97 -97
  214. package/.claude/commands/sparc/batch-executor.md +54 -54
  215. package/.claude/commands/sparc/code.md +89 -89
  216. package/.claude/commands/sparc/coder.md +54 -54
  217. package/.claude/commands/sparc/debug.md +83 -83
  218. package/.claude/commands/sparc/debugger.md +54 -54
  219. package/.claude/commands/sparc/designer.md +53 -53
  220. package/.claude/commands/sparc/devops.md +109 -109
  221. package/.claude/commands/sparc/docs-writer.md +80 -80
  222. package/.claude/commands/sparc/documenter.md +54 -54
  223. package/.claude/commands/sparc/innovator.md +54 -54
  224. package/.claude/commands/sparc/integration.md +83 -83
  225. package/.claude/commands/sparc/mcp.md +117 -117
  226. package/.claude/commands/sparc/memory-manager.md +54 -54
  227. package/.claude/commands/sparc/optimizer.md +54 -54
  228. package/.claude/commands/sparc/orchestrator.md +131 -131
  229. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  230. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  231. package/.claude/commands/sparc/researcher.md +54 -54
  232. package/.claude/commands/sparc/reviewer.md +54 -54
  233. package/.claude/commands/sparc/security-review.md +80 -80
  234. package/.claude/commands/sparc/sparc-modes.md +174 -174
  235. package/.claude/commands/sparc/sparc.md +111 -111
  236. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  237. package/.claude/commands/sparc/supabase-admin.md +348 -348
  238. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  239. package/.claude/commands/sparc/tdd.md +54 -54
  240. package/.claude/commands/sparc/tester.md +54 -54
  241. package/.claude/commands/sparc/tutorial.md +79 -79
  242. package/.claude/commands/sparc/workflow-manager.md +54 -54
  243. package/.claude/commands/sparc.md +166 -166
  244. package/.claude/commands/stream-chain/pipeline.md +120 -120
  245. package/.claude/commands/stream-chain/run.md +69 -69
  246. package/.claude/commands/swarm/README.md +15 -15
  247. package/.claude/commands/swarm/analysis.md +95 -95
  248. package/.claude/commands/swarm/development.md +96 -96
  249. package/.claude/commands/swarm/examples.md +168 -168
  250. package/.claude/commands/swarm/maintenance.md +102 -102
  251. package/.claude/commands/swarm/optimization.md +117 -117
  252. package/.claude/commands/swarm/research.md +136 -136
  253. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  254. package/.claude/commands/swarm/swarm-background.md +8 -8
  255. package/.claude/commands/swarm/swarm-init.md +19 -19
  256. package/.claude/commands/swarm/swarm-modes.md +8 -8
  257. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  258. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  259. package/.claude/commands/swarm/swarm-status.md +8 -8
  260. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  261. package/.claude/commands/swarm/swarm.md +27 -27
  262. package/.claude/commands/swarm/testing.md +131 -131
  263. package/.claude/commands/training/README.md +9 -9
  264. package/.claude/commands/training/model-update.md +25 -25
  265. package/.claude/commands/training/neural-patterns.md +73 -73
  266. package/.claude/commands/training/neural-train.md +25 -25
  267. package/.claude/commands/training/pattern-learn.md +25 -25
  268. package/.claude/commands/training/specialization.md +62 -62
  269. package/.claude/commands/truth/start.md +142 -142
  270. package/.claude/commands/verify/check.md +49 -49
  271. package/.claude/commands/verify/start.md +127 -127
  272. package/.claude/commands/workflows/README.md +9 -9
  273. package/.claude/commands/workflows/development.md +77 -77
  274. package/.claude/commands/workflows/research.md +62 -62
  275. package/.claude/commands/workflows/workflow-create.md +25 -25
  276. package/.claude/commands/workflows/workflow-execute.md +25 -25
  277. package/.claude/commands/workflows/workflow-export.md +25 -25
  278. package/.claude/config/v3-dependency-optimization.json +265 -265
  279. package/.claude/config/v3-performance-targets.json +250 -250
  280. package/.claude/helpers/.helpers-version +1 -1
  281. package/.claude/helpers/README.md +96 -96
  282. package/.claude/helpers/adr-compliance.sh +186 -186
  283. package/.claude/helpers/aggressive-microcompact.mjs +36 -36
  284. package/.claude/helpers/auto-commit.sh +178 -178
  285. package/.claude/helpers/auto-memory-hook.mjs +430 -430
  286. package/.claude/helpers/checkpoint-manager.sh +251 -251
  287. package/.claude/helpers/context-persistence-hook.mjs +2001 -2001
  288. package/.claude/helpers/daemon-manager.sh +252 -252
  289. package/.claude/helpers/ddd-tracker.sh +144 -144
  290. package/.claude/helpers/github-safe.js +156 -156
  291. package/.claude/helpers/github-setup.sh +45 -45
  292. package/.claude/helpers/guidance-hook.sh +13 -13
  293. package/.claude/helpers/guidance-hooks.sh +102 -102
  294. package/.claude/helpers/health-monitor.sh +108 -108
  295. package/.claude/helpers/helpers.manifest.json +6 -5
  296. package/.claude/helpers/hook-handler.cjs +460 -460
  297. package/.claude/helpers/intelligence.cjs +1058 -1058
  298. package/.claude/helpers/learning-hooks.sh +329 -329
  299. package/.claude/helpers/learning-optimizer.sh +127 -127
  300. package/.claude/helpers/learning-service.mjs +1144 -1144
  301. package/.claude/helpers/memory.cjs +84 -84
  302. package/.claude/helpers/metrics-db.mjs +503 -503
  303. package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
  304. package/.claude/helpers/pattern-consolidator.sh +86 -86
  305. package/.claude/helpers/perf-worker.sh +160 -160
  306. package/.claude/helpers/quick-start.sh +19 -19
  307. package/.claude/helpers/router.cjs +62 -62
  308. package/.claude/helpers/security-scanner.sh +127 -127
  309. package/.claude/helpers/session.cjs +125 -125
  310. package/.claude/helpers/setup-mcp.sh +18 -18
  311. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  312. package/.claude/helpers/statusline.cjs +925 -925
  313. package/.claude/helpers/swarm-comms.sh +353 -353
  314. package/.claude/helpers/swarm-hooks.sh +761 -761
  315. package/.claude/helpers/swarm-monitor.sh +210 -210
  316. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  317. package/.claude/helpers/update-v3-progress.sh +165 -165
  318. package/.claude/helpers/v3-quick-status.sh +57 -57
  319. package/.claude/helpers/v3.sh +110 -110
  320. package/.claude/helpers/validate-v3-config.sh +215 -215
  321. package/.claude/helpers/worker-manager.sh +170 -170
  322. package/.claude/mcp.json +12 -12
  323. package/.claude/proven-config.json +1 -1
  324. package/.claude/settings.json +285 -285
  325. package/.claude/settings.json.bak +526 -526
  326. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  327. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  328. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  329. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  330. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  331. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  332. package/.claude/skills/browser/SKILL.md +204 -204
  333. package/.claude/skills/dual-mode/README.md +71 -71
  334. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  335. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  336. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  337. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  338. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  339. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  340. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  341. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  342. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  343. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  344. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  345. package/.claude/skills/hive-mind-advanced/SKILL.md +709 -709
  346. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  347. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  348. package/.claude/skills/performance-analysis/SKILL.md +560 -560
  349. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  350. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  351. package/.claude/skills/skill-builder/SKILL.md +910 -910
  352. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  353. package/.claude/skills/stream-chain/SKILL.md +560 -560
  354. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  355. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  356. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  357. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  358. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  359. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  360. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  361. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  362. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  363. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  364. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  365. package/.claude/skills/verification-quality/SKILL.md +691 -691
  366. package/.claude/skills/worker-benchmarks/SKILL.md +129 -129
  367. package/.claude/skills/worker-integration/SKILL.md +147 -147
  368. package/.claude/statusline-command.sh +176 -176
  369. package/.claude/statusline.mjs +109 -109
  370. package/.claude/statusline.sh +431 -431
  371. package/.claude/workflows/full-system-test.js +65 -65
  372. package/.claude/workflows/intelligence-system-hardening.js +120 -120
  373. package/.claude/workflows/plugin-contract-audit.js +91 -91
  374. package/.claude-plugin/README.md +720 -720
  375. package/.claude-plugin/docs/INSTALLATION.md +261 -261
  376. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +361 -361
  377. package/.claude-plugin/docs/QUICKSTART.md +361 -361
  378. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  379. package/.claude-plugin/hooks/hooks.json +77 -77
  380. package/.claude-plugin/marketplace.json +185 -185
  381. package/.claude-plugin/plugin.json +71 -71
  382. package/.claude-plugin/scripts/install.sh +234 -234
  383. package/.claude-plugin/scripts/ruflo-hook.cjs +166 -166
  384. package/.claude-plugin/scripts/ruflo-hook.sh +37 -37
  385. package/.claude-plugin/scripts/uninstall.sh +36 -36
  386. package/.claude-plugin/scripts/verify.sh +108 -108
  387. package/LICENSE +21 -21
  388. package/README.md +419 -419
  389. package/bin/cli.js +11 -11
  390. package/bin/npx-repair.js +7 -7
  391. package/bin/npx-safe-launch.js +9 -9
  392. package/package.json +185 -185
  393. package/v3/@claude-flow/cli/README.md +419 -419
  394. package/v3/@claude-flow/cli/bin/cli.js +314 -314
  395. package/v3/@claude-flow/cli/bin/mcp-server.js +224 -224
  396. package/v3/@claude-flow/cli/bin/preinstall.cjs +2 -2
  397. package/v3/@claude-flow/cli/catalog-manifest.json +2 -2
  398. package/v3/@claude-flow/cli/dist/src/benchmarks/gaia-critic.js +24 -24
  399. package/v3/@claude-flow/cli/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  400. package/v3/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  401. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +44 -44
  402. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +26 -26
  403. package/v3/@claude-flow/cli/dist/src/commands/funnel.d.ts +2 -0
  404. package/v3/@claude-flow/cli/dist/src/commands/funnel.js +110 -2
  405. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +97 -97
  406. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  407. package/v3/@claude-flow/cli/dist/src/commands/init.js +94 -38
  408. package/v3/@claude-flow/cli/dist/src/commands/memory.js +85 -1
  409. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  410. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +31 -31
  411. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  412. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +115 -115
  413. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +99 -99
  414. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  415. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  416. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +38 -38
  417. package/v3/@claude-flow/cli/dist/src/config/proven-config.js +2 -2
  418. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.d.ts +1 -0
  419. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.js +12 -0
  420. package/v3/@claude-flow/cli/dist/src/funnel/index.d.ts +1 -1
  421. package/v3/@claude-flow/cli/dist/src/funnel/index.js +1 -1
  422. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +231 -231
  423. package/v3/@claude-flow/cli/dist/src/init/executor.js +453 -453
  424. package/v3/@claude-flow/cli/dist/src/init/helper-signing.d.ts +8 -1
  425. package/v3/@claude-flow/cli/dist/src/init/helper-signing.js +9 -2
  426. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +751 -751
  427. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +949 -949
  428. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +15 -15
  429. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  430. package/v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.js +22 -22
  431. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.d.ts +10 -0
  432. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +139 -88
  433. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.d.ts +18 -0
  434. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +539 -407
  435. package/v3/@claude-flow/cli/dist/src/memory/rabitq-index.js +5 -5
  436. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  437. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.d.ts +195 -0
  438. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.js +643 -0
  439. package/v3/@claude-flow/cli/dist/src/ruvector/moe-router.d.ts +206 -0
  440. package/v3/@claude-flow/cli/dist/src/ruvector/moe-router.js +626 -0
  441. package/v3/@claude-flow/cli/dist/src/services/distill-tuning.js +7 -7
  442. package/v3/@claude-flow/cli/dist/src/services/event-stream.d.ts +25 -0
  443. package/v3/@claude-flow/cli/dist/src/services/event-stream.js +27 -0
  444. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  445. package/v3/@claude-flow/cli/dist/src/services/loop-worker-runner.d.ts +16 -0
  446. package/v3/@claude-flow/cli/dist/src/services/loop-worker-runner.js +34 -0
  447. package/v3/@claude-flow/cli/dist/src/services/memory-distillation.js +4 -4
  448. package/v3/@claude-flow/cli/dist/src/services/runtime-capabilities.d.ts +22 -0
  449. package/v3/@claude-flow/cli/dist/src/services/runtime-capabilities.js +45 -0
  450. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  451. package/v3/@claude-flow/cli/package.json +134 -133
  452. package/v3/@claude-flow/guidance/README.md +1195 -1195
  453. package/v3/@claude-flow/guidance/dist/adversarial.d.ts +284 -0
  454. package/v3/@claude-flow/guidance/dist/adversarial.js +572 -0
  455. package/v3/@claude-flow/guidance/dist/analyzer.d.ts +530 -0
  456. package/v3/@claude-flow/guidance/dist/analyzer.js +2587 -0
  457. package/v3/@claude-flow/guidance/dist/artifacts.d.ts +283 -0
  458. package/v3/@claude-flow/guidance/dist/artifacts.js +356 -0
  459. package/v3/@claude-flow/guidance/dist/authority.d.ts +290 -0
  460. package/v3/@claude-flow/guidance/dist/authority.js +558 -0
  461. package/v3/@claude-flow/guidance/dist/capabilities.d.ts +209 -0
  462. package/v3/@claude-flow/guidance/dist/capabilities.js +485 -0
  463. package/v3/@claude-flow/guidance/dist/coherence.d.ts +233 -0
  464. package/v3/@claude-flow/guidance/dist/coherence.js +372 -0
  465. package/v3/@claude-flow/guidance/dist/compiler.d.ts +87 -0
  466. package/v3/@claude-flow/guidance/dist/compiler.js +410 -0
  467. package/v3/@claude-flow/guidance/dist/conformance-kit.d.ts +225 -0
  468. package/v3/@claude-flow/guidance/dist/conformance-kit.js +629 -0
  469. package/v3/@claude-flow/guidance/dist/continue-gate.d.ts +214 -0
  470. package/v3/@claude-flow/guidance/dist/continue-gate.js +353 -0
  471. package/v3/@claude-flow/guidance/dist/crypto-utils.d.ts +17 -0
  472. package/v3/@claude-flow/guidance/dist/crypto-utils.js +24 -0
  473. package/v3/@claude-flow/guidance/dist/evolution.d.ts +282 -0
  474. package/v3/@claude-flow/guidance/dist/evolution.js +500 -0
  475. package/v3/@claude-flow/guidance/dist/gates.d.ts +79 -0
  476. package/v3/@claude-flow/guidance/dist/gates.js +302 -0
  477. package/v3/@claude-flow/guidance/dist/gateway.d.ts +206 -0
  478. package/v3/@claude-flow/guidance/dist/gateway.js +452 -0
  479. package/v3/@claude-flow/guidance/dist/generators.d.ts +153 -0
  480. package/v3/@claude-flow/guidance/dist/generators.js +682 -0
  481. package/v3/@claude-flow/guidance/dist/headless.d.ts +177 -0
  482. package/v3/@claude-flow/guidance/dist/headless.js +342 -0
  483. package/v3/@claude-flow/guidance/dist/hooks.d.ts +109 -0
  484. package/v3/@claude-flow/guidance/dist/hooks.js +347 -0
  485. package/v3/@claude-flow/guidance/dist/index.d.ts +205 -0
  486. package/v3/@claude-flow/guidance/dist/index.js +321 -0
  487. package/v3/@claude-flow/guidance/dist/ledger.d.ts +162 -0
  488. package/v3/@claude-flow/guidance/dist/ledger.js +375 -0
  489. package/v3/@claude-flow/guidance/dist/manifest-validator.d.ts +289 -0
  490. package/v3/@claude-flow/guidance/dist/manifest-validator.js +838 -0
  491. package/v3/@claude-flow/guidance/dist/memory-gate.d.ts +222 -0
  492. package/v3/@claude-flow/guidance/dist/memory-gate.js +382 -0
  493. package/v3/@claude-flow/guidance/dist/meta-governance.d.ts +265 -0
  494. package/v3/@claude-flow/guidance/dist/meta-governance.js +348 -0
  495. package/v3/@claude-flow/guidance/dist/optimizer.d.ts +104 -0
  496. package/v3/@claude-flow/guidance/dist/optimizer.js +329 -0
  497. package/v3/@claude-flow/guidance/dist/persistence.d.ts +189 -0
  498. package/v3/@claude-flow/guidance/dist/persistence.js +464 -0
  499. package/v3/@claude-flow/guidance/dist/proof.d.ts +185 -0
  500. package/v3/@claude-flow/guidance/dist/proof.js +238 -0
  501. package/v3/@claude-flow/guidance/dist/retriever.d.ts +172 -0
  502. package/v3/@claude-flow/guidance/dist/retriever.js +596 -0
  503. package/v3/@claude-flow/guidance/dist/ruvbot-integration.d.ts +370 -0
  504. package/v3/@claude-flow/guidance/dist/ruvbot-integration.js +738 -0
  505. package/v3/@claude-flow/guidance/dist/temporal.d.ts +426 -0
  506. package/v3/@claude-flow/guidance/dist/temporal.js +658 -0
  507. package/v3/@claude-flow/guidance/dist/trust.d.ts +283 -0
  508. package/v3/@claude-flow/guidance/dist/trust.js +473 -0
  509. package/v3/@claude-flow/guidance/dist/truth-anchors.d.ts +276 -0
  510. package/v3/@claude-flow/guidance/dist/truth-anchors.js +488 -0
  511. package/v3/@claude-flow/guidance/dist/types.d.ts +378 -0
  512. package/v3/@claude-flow/guidance/dist/types.js +10 -0
  513. package/v3/@claude-flow/guidance/dist/uncertainty.d.ts +372 -0
  514. package/v3/@claude-flow/guidance/dist/uncertainty.js +619 -0
  515. package/v3/@claude-flow/guidance/dist/wasm-kernel.d.ts +48 -0
  516. package/v3/@claude-flow/guidance/dist/wasm-kernel.js +158 -0
  517. package/v3/@claude-flow/guidance/package.json +198 -198
  518. package/v3/@claude-flow/shared/README.md +323 -323
  519. package/v3/@claude-flow/shared/dist/core/config/defaults.d.ts +41 -0
  520. package/v3/@claude-flow/shared/dist/core/config/defaults.js +186 -0
  521. package/v3/@claude-flow/shared/dist/core/config/index.d.ts +8 -0
  522. package/v3/@claude-flow/shared/dist/core/config/index.js +12 -0
  523. package/v3/@claude-flow/shared/dist/core/config/loader.d.ts +45 -0
  524. package/v3/@claude-flow/shared/dist/core/config/loader.js +238 -0
  525. package/v3/@claude-flow/shared/dist/core/config/schema.d.ts +1728 -0
  526. package/v3/@claude-flow/shared/dist/core/config/schema.js +160 -0
  527. package/v3/@claude-flow/shared/dist/core/config/validator.d.ts +92 -0
  528. package/v3/@claude-flow/shared/dist/core/config/validator.js +147 -0
  529. package/v3/@claude-flow/shared/dist/core/event-bus.d.ts +31 -0
  530. package/v3/@claude-flow/shared/dist/core/event-bus.js +197 -0
  531. package/v3/@claude-flow/shared/dist/core/index.d.ts +15 -0
  532. package/v3/@claude-flow/shared/dist/core/index.js +19 -0
  533. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +200 -0
  534. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.js +6 -0
  535. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +310 -0
  536. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +7 -0
  537. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +224 -0
  538. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.js +46 -0
  539. package/v3/@claude-flow/shared/dist/core/interfaces/index.d.ts +10 -0
  540. package/v3/@claude-flow/shared/dist/core/interfaces/index.js +15 -0
  541. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +298 -0
  542. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.js +7 -0
  543. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +185 -0
  544. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.js +6 -0
  545. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +35 -0
  546. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +101 -0
  547. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +60 -0
  548. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +166 -0
  549. package/v3/@claude-flow/shared/dist/core/orchestrator/index.d.ts +46 -0
  550. package/v3/@claude-flow/shared/dist/core/orchestrator/index.js +64 -0
  551. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +56 -0
  552. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +195 -0
  553. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +83 -0
  554. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.js +193 -0
  555. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +49 -0
  556. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.js +253 -0
  557. package/v3/@claude-flow/shared/dist/events/domain-events.d.ts +282 -0
  558. package/v3/@claude-flow/shared/dist/events/domain-events.js +165 -0
  559. package/v3/@claude-flow/shared/dist/events/event-store.d.ts +126 -0
  560. package/v3/@claude-flow/shared/dist/events/event-store.js +427 -0
  561. package/v3/@claude-flow/shared/dist/events/event-store.test.d.ts +8 -0
  562. package/v3/@claude-flow/shared/dist/events/event-store.test.js +293 -0
  563. package/v3/@claude-flow/shared/dist/events/example-usage.d.ts +10 -0
  564. package/v3/@claude-flow/shared/dist/events/example-usage.js +193 -0
  565. package/v3/@claude-flow/shared/dist/events/index.d.ts +21 -0
  566. package/v3/@claude-flow/shared/dist/events/index.js +22 -0
  567. package/v3/@claude-flow/shared/dist/events/projections.d.ts +177 -0
  568. package/v3/@claude-flow/shared/dist/events/projections.js +421 -0
  569. package/v3/@claude-flow/shared/dist/events/rvf-event-log.d.ts +82 -0
  570. package/v3/@claude-flow/shared/dist/events/rvf-event-log.js +340 -0
  571. package/v3/@claude-flow/shared/dist/events/state-reconstructor.d.ts +101 -0
  572. package/v3/@claude-flow/shared/dist/events/state-reconstructor.js +263 -0
  573. package/v3/@claude-flow/shared/dist/events.d.ts +80 -0
  574. package/v3/@claude-flow/shared/dist/events.js +249 -0
  575. package/v3/@claude-flow/shared/dist/hooks/example-usage.d.ts +42 -0
  576. package/v3/@claude-flow/shared/dist/hooks/example-usage.js +351 -0
  577. package/v3/@claude-flow/shared/dist/hooks/executor.d.ts +100 -0
  578. package/v3/@claude-flow/shared/dist/hooks/executor.js +267 -0
  579. package/v3/@claude-flow/shared/dist/hooks/hooks.test.d.ts +9 -0
  580. package/v3/@claude-flow/shared/dist/hooks/hooks.test.js +322 -0
  581. package/v3/@claude-flow/shared/dist/hooks/index.d.ts +52 -0
  582. package/v3/@claude-flow/shared/dist/hooks/index.js +51 -0
  583. package/v3/@claude-flow/shared/dist/hooks/registry.d.ts +133 -0
  584. package/v3/@claude-flow/shared/dist/hooks/registry.js +277 -0
  585. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +105 -0
  586. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.js +481 -0
  587. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +144 -0
  588. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.js +328 -0
  589. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +158 -0
  590. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +450 -0
  591. package/v3/@claude-flow/shared/dist/hooks/safety/index.d.ts +17 -0
  592. package/v3/@claude-flow/shared/dist/hooks/safety/index.js +17 -0
  593. package/v3/@claude-flow/shared/dist/hooks/session-hooks.d.ts +234 -0
  594. package/v3/@claude-flow/shared/dist/hooks/session-hooks.js +334 -0
  595. package/v3/@claude-flow/shared/dist/hooks/task-hooks.d.ts +163 -0
  596. package/v3/@claude-flow/shared/dist/hooks/task-hooks.js +326 -0
  597. package/v3/@claude-flow/shared/dist/hooks/types.d.ts +267 -0
  598. package/v3/@claude-flow/shared/dist/hooks/types.js +62 -0
  599. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +9 -0
  600. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.js +93 -0
  601. package/v3/@claude-flow/shared/dist/index.d.ts +20 -0
  602. package/v3/@claude-flow/shared/dist/index.js +50 -0
  603. package/v3/@claude-flow/shared/dist/mcp/connection-pool.d.ts +98 -0
  604. package/v3/@claude-flow/shared/dist/mcp/connection-pool.js +364 -0
  605. package/v3/@claude-flow/shared/dist/mcp/index.d.ts +69 -0
  606. package/v3/@claude-flow/shared/dist/mcp/index.js +84 -0
  607. package/v3/@claude-flow/shared/dist/mcp/server.d.ts +166 -0
  608. package/v3/@claude-flow/shared/dist/mcp/server.js +590 -0
  609. package/v3/@claude-flow/shared/dist/mcp/session-manager.d.ts +136 -0
  610. package/v3/@claude-flow/shared/dist/mcp/session-manager.js +335 -0
  611. package/v3/@claude-flow/shared/dist/mcp/tool-registry.d.ts +178 -0
  612. package/v3/@claude-flow/shared/dist/mcp/tool-registry.js +439 -0
  613. package/v3/@claude-flow/shared/dist/mcp/transport/http.d.ts +104 -0
  614. package/v3/@claude-flow/shared/dist/mcp/transport/http.js +476 -0
  615. package/v3/@claude-flow/shared/dist/mcp/transport/index.d.ts +102 -0
  616. package/v3/@claude-flow/shared/dist/mcp/transport/index.js +238 -0
  617. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +104 -0
  618. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.js +263 -0
  619. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +133 -0
  620. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.js +396 -0
  621. package/v3/@claude-flow/shared/dist/mcp/types.d.ts +436 -0
  622. package/v3/@claude-flow/shared/dist/mcp/types.js +54 -0
  623. package/v3/@claude-flow/shared/dist/plugin-interface.d.ts +544 -0
  624. package/v3/@claude-flow/shared/dist/plugin-interface.js +23 -0
  625. package/v3/@claude-flow/shared/dist/plugin-loader.d.ts +139 -0
  626. package/v3/@claude-flow/shared/dist/plugin-loader.js +434 -0
  627. package/v3/@claude-flow/shared/dist/plugin-registry.d.ts +183 -0
  628. package/v3/@claude-flow/shared/dist/plugin-registry.js +457 -0
  629. package/v3/@claude-flow/shared/dist/plugins/index.d.ts +10 -0
  630. package/v3/@claude-flow/shared/dist/plugins/index.js +10 -0
  631. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +106 -0
  632. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +241 -0
  633. package/v3/@claude-flow/shared/dist/plugins/official/index.d.ts +10 -0
  634. package/v3/@claude-flow/shared/dist/plugins/official/index.js +10 -0
  635. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +121 -0
  636. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +355 -0
  637. package/v3/@claude-flow/shared/dist/plugins/types.d.ts +93 -0
  638. package/v3/@claude-flow/shared/dist/plugins/types.js +9 -0
  639. package/v3/@claude-flow/shared/dist/resilience/bulkhead.d.ts +105 -0
  640. package/v3/@claude-flow/shared/dist/resilience/bulkhead.js +206 -0
  641. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +132 -0
  642. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.js +233 -0
  643. package/v3/@claude-flow/shared/dist/resilience/index.d.ts +19 -0
  644. package/v3/@claude-flow/shared/dist/resilience/index.js +19 -0
  645. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +168 -0
  646. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.js +314 -0
  647. package/v3/@claude-flow/shared/dist/resilience/retry.d.ts +91 -0
  648. package/v3/@claude-flow/shared/dist/resilience/retry.js +159 -0
  649. package/v3/@claude-flow/shared/dist/security/index.d.ts +10 -0
  650. package/v3/@claude-flow/shared/dist/security/index.js +12 -0
  651. package/v3/@claude-flow/shared/dist/security/input-validation.d.ts +73 -0
  652. package/v3/@claude-flow/shared/dist/security/input-validation.js +201 -0
  653. package/v3/@claude-flow/shared/dist/security/secure-random.d.ts +92 -0
  654. package/v3/@claude-flow/shared/dist/security/secure-random.js +142 -0
  655. package/v3/@claude-flow/shared/dist/services/index.d.ts +7 -0
  656. package/v3/@claude-flow/shared/dist/services/index.js +7 -0
  657. package/v3/@claude-flow/shared/dist/services/v3-progress.service.d.ts +124 -0
  658. package/v3/@claude-flow/shared/dist/services/v3-progress.service.js +402 -0
  659. package/v3/@claude-flow/shared/dist/types/agent.types.d.ts +137 -0
  660. package/v3/@claude-flow/shared/dist/types/agent.types.js +6 -0
  661. package/v3/@claude-flow/shared/dist/types/index.d.ts +11 -0
  662. package/v3/@claude-flow/shared/dist/types/index.js +17 -0
  663. package/v3/@claude-flow/shared/dist/types/mcp.types.d.ts +266 -0
  664. package/v3/@claude-flow/shared/dist/types/mcp.types.js +7 -0
  665. package/v3/@claude-flow/shared/dist/types/memory.types.d.ts +236 -0
  666. package/v3/@claude-flow/shared/dist/types/memory.types.js +7 -0
  667. package/v3/@claude-flow/shared/dist/types/swarm.types.d.ts +186 -0
  668. package/v3/@claude-flow/shared/dist/types/swarm.types.js +65 -0
  669. package/v3/@claude-flow/shared/dist/types/task.types.d.ts +178 -0
  670. package/v3/@claude-flow/shared/dist/types/task.types.js +32 -0
  671. package/v3/@claude-flow/shared/dist/types.d.ts +197 -0
  672. package/v3/@claude-flow/shared/dist/types.js +21 -0
  673. package/v3/@claude-flow/shared/dist/utils/secure-logger.d.ts +69 -0
  674. package/v3/@claude-flow/shared/dist/utils/secure-logger.js +208 -0
  675. package/v3/@claude-flow/shared/package.json +43 -43
  676. package/v3/README.md +493 -493
  677. package/.claude/security-scans/scan-all-standard.json +0 -321
  678. package/.claude/security-scans/scan-code-deep.json +0 -1209
  679. package/.claude/security-scans/scan-deps-full.json +0 -14
@@ -1,503 +1,503 @@
1
- #!/usr/bin/env node
2
- /**
3
- * RuFlo V3 - Metrics Database Manager
4
- * Uses sql.js for cross-platform SQLite storage
5
- * Single .db file with multiple tables
6
- */
7
-
8
- import initSqlJs from 'sql.js';
9
- import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, statSync, openSync, writeSync, fsyncSync, closeSync, renameSync, rmSync } from 'fs';
10
- import { dirname, join, basename } from 'path';
11
- import { fileURLToPath } from 'url';
12
- import { execSync } from 'child_process';
13
-
14
- const __dirname = dirname(fileURLToPath(import.meta.url));
15
- const PROJECT_ROOT = join(__dirname, '../..');
16
- const V3_DIR = join(PROJECT_ROOT, 'v3');
17
- const DB_PATH = join(PROJECT_ROOT, '.claude-flow', 'metrics.db');
18
-
19
- // Ensure directory exists
20
- const dbDir = dirname(DB_PATH);
21
- if (!existsSync(dbDir)) {
22
- mkdirSync(dbDir, { recursive: true });
23
- }
24
-
25
- let SQL;
26
- let db;
27
-
28
- /**
29
- * Initialize sql.js and create/load database
30
- */
31
- async function initDatabase() {
32
- SQL = await initSqlJs();
33
-
34
- // Load existing database or create new one
35
- if (existsSync(DB_PATH)) {
36
- const buffer = readFileSync(DB_PATH);
37
- db = new SQL.Database(buffer);
38
- } else {
39
- db = new SQL.Database();
40
- }
41
-
42
- // Create tables if they don't exist
43
- db.run(`
44
- CREATE TABLE IF NOT EXISTS v3_progress (
45
- id INTEGER PRIMARY KEY,
46
- domains_completed INTEGER DEFAULT 0,
47
- domains_total INTEGER DEFAULT 5,
48
- ddd_progress INTEGER DEFAULT 0,
49
- total_modules INTEGER DEFAULT 0,
50
- total_files INTEGER DEFAULT 0,
51
- total_lines INTEGER DEFAULT 0,
52
- last_updated TEXT
53
- );
54
-
55
- CREATE TABLE IF NOT EXISTS security_audit (
56
- id INTEGER PRIMARY KEY,
57
- status TEXT DEFAULT 'PENDING',
58
- cves_fixed INTEGER DEFAULT 0,
59
- total_cves INTEGER DEFAULT 3,
60
- last_audit TEXT
61
- );
62
-
63
- CREATE TABLE IF NOT EXISTS swarm_activity (
64
- id INTEGER PRIMARY KEY,
65
- agentic_flow_processes INTEGER DEFAULT 0,
66
- mcp_server_processes INTEGER DEFAULT 0,
67
- estimated_agents INTEGER DEFAULT 0,
68
- swarm_active INTEGER DEFAULT 0,
69
- coordination_active INTEGER DEFAULT 0,
70
- last_updated TEXT
71
- );
72
-
73
- CREATE TABLE IF NOT EXISTS performance_metrics (
74
- id INTEGER PRIMARY KEY,
75
- flash_attention_speedup TEXT DEFAULT '1.0x',
76
- memory_reduction TEXT DEFAULT '0%',
77
- search_improvement TEXT DEFAULT '1x',
78
- last_updated TEXT
79
- );
80
-
81
- CREATE TABLE IF NOT EXISTS module_status (
82
- name TEXT PRIMARY KEY,
83
- files INTEGER DEFAULT 0,
84
- lines INTEGER DEFAULT 0,
85
- progress INTEGER DEFAULT 0,
86
- has_src INTEGER DEFAULT 0,
87
- has_tests INTEGER DEFAULT 0,
88
- last_updated TEXT
89
- );
90
-
91
- CREATE TABLE IF NOT EXISTS cve_status (
92
- id TEXT PRIMARY KEY,
93
- description TEXT,
94
- severity TEXT DEFAULT 'critical',
95
- status TEXT DEFAULT 'pending',
96
- fixed_by TEXT,
97
- last_updated TEXT
98
- );
99
- `);
100
-
101
- // Initialize rows if empty
102
- const progressCheck = db.exec("SELECT COUNT(*) FROM v3_progress");
103
- if (progressCheck[0]?.values[0][0] === 0) {
104
- db.run("INSERT INTO v3_progress (id) VALUES (1)");
105
- }
106
-
107
- const securityCheck = db.exec("SELECT COUNT(*) FROM security_audit");
108
- if (securityCheck[0]?.values[0][0] === 0) {
109
- db.run("INSERT INTO security_audit (id) VALUES (1)");
110
- }
111
-
112
- const swarmCheck = db.exec("SELECT COUNT(*) FROM swarm_activity");
113
- if (swarmCheck[0]?.values[0][0] === 0) {
114
- db.run("INSERT INTO swarm_activity (id) VALUES (1)");
115
- }
116
-
117
- const perfCheck = db.exec("SELECT COUNT(*) FROM performance_metrics");
118
- if (perfCheck[0]?.values[0][0] === 0) {
119
- db.run("INSERT INTO performance_metrics (id) VALUES (1)");
120
- }
121
-
122
- // Initialize CVE records
123
- const cveCheck = db.exec("SELECT COUNT(*) FROM cve_status");
124
- if (cveCheck[0]?.values[0][0] === 0) {
125
- db.run(`INSERT INTO cve_status (id, description, fixed_by) VALUES
126
- ('CVE-1', 'Input validation bypass', 'input-validator.ts'),
127
- ('CVE-2', 'Path traversal vulnerability', 'path-validator.ts'),
128
- ('CVE-3', 'Command injection vulnerability', 'safe-executor.ts')
129
- `);
130
- }
131
-
132
- persist();
133
- }
134
-
135
- /**
136
- * Persist database to disk
137
- */
138
- function persist() {
139
- const data = db.export();
140
- const buffer = Buffer.from(data);
141
- // Atomic write (issue #2584): temp → fsync → rename so a kill/OOM mid-flush
142
- // or a concurrent writer can't leave a torn, malformed metrics.db image.
143
- const tmp = `${DB_PATH}.tmp-${process.pid}-${Date.now().toString(36)}`;
144
- let fd;
145
- try {
146
- fd = openSync(tmp, 'wx');
147
- if (buffer.length > 0) writeSync(fd, buffer, 0, buffer.length, 0);
148
- fsyncSync(fd);
149
- closeSync(fd);
150
- fd = undefined;
151
- renameSync(tmp, DB_PATH);
152
- } catch (e) {
153
- if (fd !== undefined) { try { closeSync(fd); } catch { /* */ } }
154
- try { rmSync(tmp, { force: true }); } catch { /* */ }
155
- throw e;
156
- }
157
- }
158
-
159
- /**
160
- * Count files and lines in a directory
161
- */
162
- function countFilesAndLines(dir, ext = '.ts') {
163
- let files = 0;
164
- let lines = 0;
165
-
166
- function walk(currentDir) {
167
- if (!existsSync(currentDir)) return;
168
-
169
- try {
170
- const entries = readdirSync(currentDir, { withFileTypes: true });
171
- for (const entry of entries) {
172
- const fullPath = join(currentDir, entry.name);
173
- if (entry.isDirectory() && !entry.name.includes('node_modules')) {
174
- walk(fullPath);
175
- } else if (entry.isFile() && entry.name.endsWith(ext)) {
176
- files++;
177
- try {
178
- const content = readFileSync(fullPath, 'utf-8');
179
- lines += content.split('\n').length;
180
- } catch (e) {}
181
- }
182
- }
183
- } catch (e) {}
184
- }
185
-
186
- walk(dir);
187
- return { files, lines };
188
- }
189
-
190
- /**
191
- * Calculate module progress
192
- * Utility/service packages (cli, hooks, mcp, etc.) are considered complete (100%)
193
- * as their services ARE the application layer (DDD by design)
194
- */
195
- const UTILITY_PACKAGES = new Set([
196
- 'cli', 'hooks', 'mcp', 'shared', 'testing', 'agents', 'integration',
197
- 'embeddings', 'deployment', 'performance', 'plugins', 'providers'
198
- ]);
199
-
200
- function calculateModuleProgress(moduleDir) {
201
- if (!existsSync(moduleDir)) return 0;
202
-
203
- const moduleName = basename(moduleDir);
204
-
205
- // Utility packages are 100% complete by design
206
- if (UTILITY_PACKAGES.has(moduleName)) {
207
- return 100;
208
- }
209
-
210
- let progress = 0;
211
-
212
- // Check for DDD structure
213
- if (existsSync(join(moduleDir, 'src/domain'))) progress += 30;
214
- if (existsSync(join(moduleDir, 'src/application'))) progress += 30;
215
- if (existsSync(join(moduleDir, 'src'))) progress += 10;
216
- if (existsSync(join(moduleDir, 'src/index.ts')) || existsSync(join(moduleDir, 'index.ts'))) progress += 10;
217
- if (existsSync(join(moduleDir, '__tests__')) || existsSync(join(moduleDir, 'tests'))) progress += 10;
218
- if (existsSync(join(moduleDir, 'package.json'))) progress += 10;
219
-
220
- return Math.min(progress, 100);
221
- }
222
-
223
- /**
224
- * Check security file status
225
- */
226
- function checkSecurityFile(filename, minLines = 100) {
227
- const filePath = join(V3_DIR, '@claude-flow/security/src', filename);
228
- if (!existsSync(filePath)) return false;
229
-
230
- try {
231
- const content = readFileSync(filePath, 'utf-8');
232
- return content.split('\n').length > minLines;
233
- } catch (e) {
234
- return false;
235
- }
236
- }
237
-
238
- /**
239
- * Count active processes
240
- */
241
- function countProcesses() {
242
- try {
243
- const ps = execSync('ps aux 2>/dev/null || echo ""', { encoding: 'utf-8' });
244
-
245
- const agenticFlow = (ps.match(/agentic-flow/g) || []).length;
246
- const mcp = (ps.match(/mcp.*start/g) || []).length;
247
- const agents = (ps.match(/agent|swarm|coordinator/g) || []).length;
248
-
249
- return {
250
- agenticFlow: Math.max(0, agenticFlow - 1), // Exclude grep itself
251
- mcp,
252
- agents: Math.max(0, agents - 1)
253
- };
254
- } catch (e) {
255
- return { agenticFlow: 0, mcp: 0, agents: 0 };
256
- }
257
- }
258
-
259
- /**
260
- * Sync all metrics from actual implementation
261
- */
262
- async function syncMetrics() {
263
- const now = new Date().toISOString();
264
-
265
- // Count V3 modules
266
- const modulesDir = join(V3_DIR, '@claude-flow');
267
- let modules = [];
268
- let totalProgress = 0;
269
-
270
- if (existsSync(modulesDir)) {
271
- const entries = readdirSync(modulesDir, { withFileTypes: true });
272
- for (const entry of entries) {
273
- // Skip hidden directories (like .agentic-flow, .claude-flow)
274
- if (entry.isDirectory() && !entry.name.startsWith('.')) {
275
- const moduleDir = join(modulesDir, entry.name);
276
- const { files, lines } = countFilesAndLines(moduleDir);
277
- const progress = calculateModuleProgress(moduleDir);
278
-
279
- modules.push({ name: entry.name, files, lines, progress });
280
- totalProgress += progress;
281
-
282
- // Update module_status table
283
- db.run(`
284
- INSERT OR REPLACE INTO module_status (name, files, lines, progress, has_src, has_tests, last_updated)
285
- VALUES (?, ?, ?, ?, ?, ?, ?)
286
- `, [
287
- entry.name,
288
- files,
289
- lines,
290
- progress,
291
- existsSync(join(moduleDir, 'src')) ? 1 : 0,
292
- existsSync(join(moduleDir, '__tests__')) ? 1 : 0,
293
- now
294
- ]);
295
- }
296
- }
297
- }
298
-
299
- const avgProgress = modules.length > 0 ? Math.round(totalProgress / modules.length) : 0;
300
- const totalStats = countFilesAndLines(V3_DIR);
301
-
302
- // Count completed domains (mapped to modules)
303
- const domainModules = ['swarm', 'memory', 'performance', 'cli', 'integration'];
304
- const domainsCompleted = domainModules.filter(m =>
305
- modules.some(mod => mod.name === m && mod.progress >= 50)
306
- ).length;
307
-
308
- // Update v3_progress
309
- db.run(`
310
- UPDATE v3_progress SET
311
- domains_completed = ?,
312
- ddd_progress = ?,
313
- total_modules = ?,
314
- total_files = ?,
315
- total_lines = ?,
316
- last_updated = ?
317
- WHERE id = 1
318
- `, [domainsCompleted, avgProgress, modules.length, totalStats.files, totalStats.lines, now]);
319
-
320
- // Check security CVEs
321
- const cve1Fixed = checkSecurityFile('input-validator.ts');
322
- const cve2Fixed = checkSecurityFile('path-validator.ts');
323
- const cve3Fixed = checkSecurityFile('safe-executor.ts');
324
- const cvesFixed = [cve1Fixed, cve2Fixed, cve3Fixed].filter(Boolean).length;
325
-
326
- let securityStatus = 'PENDING';
327
- if (cvesFixed === 3) securityStatus = 'CLEAN';
328
- else if (cvesFixed > 0) securityStatus = 'IN_PROGRESS';
329
-
330
- db.run(`
331
- UPDATE security_audit SET
332
- status = ?,
333
- cves_fixed = ?,
334
- last_audit = ?
335
- WHERE id = 1
336
- `, [securityStatus, cvesFixed, now]);
337
-
338
- // Update individual CVE status
339
- db.run("UPDATE cve_status SET status = ?, last_updated = ? WHERE id = 'CVE-1'", [cve1Fixed ? 'fixed' : 'pending', now]);
340
- db.run("UPDATE cve_status SET status = ?, last_updated = ? WHERE id = 'CVE-2'", [cve2Fixed ? 'fixed' : 'pending', now]);
341
- db.run("UPDATE cve_status SET status = ?, last_updated = ? WHERE id = 'CVE-3'", [cve3Fixed ? 'fixed' : 'pending', now]);
342
-
343
- // Update swarm activity
344
- const processes = countProcesses();
345
- db.run(`
346
- UPDATE swarm_activity SET
347
- agentic_flow_processes = ?,
348
- mcp_server_processes = ?,
349
- estimated_agents = ?,
350
- swarm_active = ?,
351
- coordination_active = ?,
352
- last_updated = ?
353
- WHERE id = 1
354
- `, [
355
- processes.agenticFlow,
356
- processes.mcp,
357
- processes.agents,
358
- processes.agents > 0 ? 1 : 0,
359
- processes.agenticFlow > 0 ? 1 : 0,
360
- now
361
- ]);
362
-
363
- persist();
364
-
365
- return {
366
- modules: modules.length,
367
- domains: domainsCompleted,
368
- dddProgress: avgProgress,
369
- cvesFixed,
370
- securityStatus,
371
- files: totalStats.files,
372
- lines: totalStats.lines
373
- };
374
- }
375
-
376
- /**
377
- * Get current metrics as JSON (for statusline compatibility)
378
- */
379
- function getMetricsJSON() {
380
- const progress = db.exec("SELECT * FROM v3_progress WHERE id = 1")[0];
381
- const security = db.exec("SELECT * FROM security_audit WHERE id = 1")[0];
382
- const swarm = db.exec("SELECT * FROM swarm_activity WHERE id = 1")[0];
383
- const perf = db.exec("SELECT * FROM performance_metrics WHERE id = 1")[0];
384
-
385
- // Map column names to values
386
- const mapRow = (result) => {
387
- if (!result) return {};
388
- const cols = result.columns;
389
- const vals = result.values[0];
390
- return Object.fromEntries(cols.map((c, i) => [c, vals[i]]));
391
- };
392
-
393
- return {
394
- v3Progress: mapRow(progress),
395
- securityAudit: mapRow(security),
396
- swarmActivity: mapRow(swarm),
397
- performanceMetrics: mapRow(perf)
398
- };
399
- }
400
-
401
- /**
402
- * Export metrics to JSON files for backward compatibility
403
- */
404
- function exportToJSON() {
405
- const metrics = getMetricsJSON();
406
- const metricsDir = join(PROJECT_ROOT, '.claude-flow/metrics');
407
- const securityDir = join(PROJECT_ROOT, '.claude-flow/security');
408
-
409
- if (!existsSync(metricsDir)) mkdirSync(metricsDir, { recursive: true });
410
- if (!existsSync(securityDir)) mkdirSync(securityDir, { recursive: true });
411
-
412
- // v3-progress.json
413
- writeFileSync(join(metricsDir, 'v3-progress.json'), JSON.stringify({
414
- domains: {
415
- completed: metrics.v3Progress.domains_completed,
416
- total: metrics.v3Progress.domains_total
417
- },
418
- ddd: {
419
- progress: metrics.v3Progress.ddd_progress,
420
- modules: metrics.v3Progress.total_modules,
421
- totalFiles: metrics.v3Progress.total_files,
422
- totalLines: metrics.v3Progress.total_lines
423
- },
424
- swarm: {
425
- activeAgents: metrics.swarmActivity.estimated_agents,
426
- totalAgents: 15
427
- },
428
- lastUpdated: metrics.v3Progress.last_updated,
429
- source: 'metrics.db'
430
- }, null, 2));
431
-
432
- // security/audit-status.json
433
- writeFileSync(join(securityDir, 'audit-status.json'), JSON.stringify({
434
- status: metrics.securityAudit.status,
435
- cvesFixed: metrics.securityAudit.cves_fixed,
436
- totalCves: metrics.securityAudit.total_cves,
437
- lastAudit: metrics.securityAudit.last_audit,
438
- source: 'metrics.db'
439
- }, null, 2));
440
-
441
- // swarm-activity.json
442
- writeFileSync(join(metricsDir, 'swarm-activity.json'), JSON.stringify({
443
- timestamp: metrics.swarmActivity.last_updated,
444
- processes: {
445
- agentic_flow: metrics.swarmActivity.agentic_flow_processes,
446
- mcp_server: metrics.swarmActivity.mcp_server_processes,
447
- estimated_agents: metrics.swarmActivity.estimated_agents
448
- },
449
- swarm: {
450
- active: metrics.swarmActivity.swarm_active === 1,
451
- agent_count: metrics.swarmActivity.estimated_agents,
452
- coordination_active: metrics.swarmActivity.coordination_active === 1
453
- },
454
- source: 'metrics.db'
455
- }, null, 2));
456
- }
457
-
458
- /**
459
- * Main entry point
460
- */
461
- async function main() {
462
- const command = process.argv[2] || 'sync';
463
-
464
- await initDatabase();
465
-
466
- switch (command) {
467
- case 'sync':
468
- const result = await syncMetrics();
469
- exportToJSON();
470
- console.log(JSON.stringify(result));
471
- break;
472
-
473
- case 'export':
474
- exportToJSON();
475
- console.log('Exported to JSON files');
476
- break;
477
-
478
- case 'status':
479
- const metrics = getMetricsJSON();
480
- console.log(JSON.stringify(metrics, null, 2));
481
- break;
482
-
483
- case 'daemon':
484
- const interval = parseInt(process.argv[3]) || 30;
485
- console.log(`Starting metrics daemon (interval: ${interval}s)`);
486
-
487
- // Initial sync
488
- await syncMetrics();
489
- exportToJSON();
490
-
491
- // Continuous sync
492
- setInterval(async () => {
493
- await syncMetrics();
494
- exportToJSON();
495
- }, interval * 1000);
496
- break;
497
-
498
- default:
499
- console.log('Usage: metrics-db.mjs [sync|export|status|daemon [interval]]');
500
- }
501
- }
502
-
503
- main().catch(console.error);
1
+ #!/usr/bin/env node
2
+ /**
3
+ * RuFlo V3 - Metrics Database Manager
4
+ * Uses sql.js for cross-platform SQLite storage
5
+ * Single .db file with multiple tables
6
+ */
7
+
8
+ import initSqlJs from 'sql.js';
9
+ import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, statSync, openSync, writeSync, fsyncSync, closeSync, renameSync, rmSync } from 'fs';
10
+ import { dirname, join, basename } from 'path';
11
+ import { fileURLToPath } from 'url';
12
+ import { execSync } from 'child_process';
13
+
14
+ const __dirname = dirname(fileURLToPath(import.meta.url));
15
+ const PROJECT_ROOT = join(__dirname, '../..');
16
+ const V3_DIR = join(PROJECT_ROOT, 'v3');
17
+ const DB_PATH = join(PROJECT_ROOT, '.claude-flow', 'metrics.db');
18
+
19
+ // Ensure directory exists
20
+ const dbDir = dirname(DB_PATH);
21
+ if (!existsSync(dbDir)) {
22
+ mkdirSync(dbDir, { recursive: true });
23
+ }
24
+
25
+ let SQL;
26
+ let db;
27
+
28
+ /**
29
+ * Initialize sql.js and create/load database
30
+ */
31
+ async function initDatabase() {
32
+ SQL = await initSqlJs();
33
+
34
+ // Load existing database or create new one
35
+ if (existsSync(DB_PATH)) {
36
+ const buffer = readFileSync(DB_PATH);
37
+ db = new SQL.Database(buffer);
38
+ } else {
39
+ db = new SQL.Database();
40
+ }
41
+
42
+ // Create tables if they don't exist
43
+ db.run(`
44
+ CREATE TABLE IF NOT EXISTS v3_progress (
45
+ id INTEGER PRIMARY KEY,
46
+ domains_completed INTEGER DEFAULT 0,
47
+ domains_total INTEGER DEFAULT 5,
48
+ ddd_progress INTEGER DEFAULT 0,
49
+ total_modules INTEGER DEFAULT 0,
50
+ total_files INTEGER DEFAULT 0,
51
+ total_lines INTEGER DEFAULT 0,
52
+ last_updated TEXT
53
+ );
54
+
55
+ CREATE TABLE IF NOT EXISTS security_audit (
56
+ id INTEGER PRIMARY KEY,
57
+ status TEXT DEFAULT 'PENDING',
58
+ cves_fixed INTEGER DEFAULT 0,
59
+ total_cves INTEGER DEFAULT 3,
60
+ last_audit TEXT
61
+ );
62
+
63
+ CREATE TABLE IF NOT EXISTS swarm_activity (
64
+ id INTEGER PRIMARY KEY,
65
+ agentic_flow_processes INTEGER DEFAULT 0,
66
+ mcp_server_processes INTEGER DEFAULT 0,
67
+ estimated_agents INTEGER DEFAULT 0,
68
+ swarm_active INTEGER DEFAULT 0,
69
+ coordination_active INTEGER DEFAULT 0,
70
+ last_updated TEXT
71
+ );
72
+
73
+ CREATE TABLE IF NOT EXISTS performance_metrics (
74
+ id INTEGER PRIMARY KEY,
75
+ flash_attention_speedup TEXT DEFAULT '1.0x',
76
+ memory_reduction TEXT DEFAULT '0%',
77
+ search_improvement TEXT DEFAULT '1x',
78
+ last_updated TEXT
79
+ );
80
+
81
+ CREATE TABLE IF NOT EXISTS module_status (
82
+ name TEXT PRIMARY KEY,
83
+ files INTEGER DEFAULT 0,
84
+ lines INTEGER DEFAULT 0,
85
+ progress INTEGER DEFAULT 0,
86
+ has_src INTEGER DEFAULT 0,
87
+ has_tests INTEGER DEFAULT 0,
88
+ last_updated TEXT
89
+ );
90
+
91
+ CREATE TABLE IF NOT EXISTS cve_status (
92
+ id TEXT PRIMARY KEY,
93
+ description TEXT,
94
+ severity TEXT DEFAULT 'critical',
95
+ status TEXT DEFAULT 'pending',
96
+ fixed_by TEXT,
97
+ last_updated TEXT
98
+ );
99
+ `);
100
+
101
+ // Initialize rows if empty
102
+ const progressCheck = db.exec("SELECT COUNT(*) FROM v3_progress");
103
+ if (progressCheck[0]?.values[0][0] === 0) {
104
+ db.run("INSERT INTO v3_progress (id) VALUES (1)");
105
+ }
106
+
107
+ const securityCheck = db.exec("SELECT COUNT(*) FROM security_audit");
108
+ if (securityCheck[0]?.values[0][0] === 0) {
109
+ db.run("INSERT INTO security_audit (id) VALUES (1)");
110
+ }
111
+
112
+ const swarmCheck = db.exec("SELECT COUNT(*) FROM swarm_activity");
113
+ if (swarmCheck[0]?.values[0][0] === 0) {
114
+ db.run("INSERT INTO swarm_activity (id) VALUES (1)");
115
+ }
116
+
117
+ const perfCheck = db.exec("SELECT COUNT(*) FROM performance_metrics");
118
+ if (perfCheck[0]?.values[0][0] === 0) {
119
+ db.run("INSERT INTO performance_metrics (id) VALUES (1)");
120
+ }
121
+
122
+ // Initialize CVE records
123
+ const cveCheck = db.exec("SELECT COUNT(*) FROM cve_status");
124
+ if (cveCheck[0]?.values[0][0] === 0) {
125
+ db.run(`INSERT INTO cve_status (id, description, fixed_by) VALUES
126
+ ('CVE-1', 'Input validation bypass', 'input-validator.ts'),
127
+ ('CVE-2', 'Path traversal vulnerability', 'path-validator.ts'),
128
+ ('CVE-3', 'Command injection vulnerability', 'safe-executor.ts')
129
+ `);
130
+ }
131
+
132
+ persist();
133
+ }
134
+
135
+ /**
136
+ * Persist database to disk
137
+ */
138
+ function persist() {
139
+ const data = db.export();
140
+ const buffer = Buffer.from(data);
141
+ // Atomic write (issue #2584): temp → fsync → rename so a kill/OOM mid-flush
142
+ // or a concurrent writer can't leave a torn, malformed metrics.db image.
143
+ const tmp = `${DB_PATH}.tmp-${process.pid}-${Date.now().toString(36)}`;
144
+ let fd;
145
+ try {
146
+ fd = openSync(tmp, 'wx');
147
+ if (buffer.length > 0) writeSync(fd, buffer, 0, buffer.length, 0);
148
+ fsyncSync(fd);
149
+ closeSync(fd);
150
+ fd = undefined;
151
+ renameSync(tmp, DB_PATH);
152
+ } catch (e) {
153
+ if (fd !== undefined) { try { closeSync(fd); } catch { /* */ } }
154
+ try { rmSync(tmp, { force: true }); } catch { /* */ }
155
+ throw e;
156
+ }
157
+ }
158
+
159
+ /**
160
+ * Count files and lines in a directory
161
+ */
162
+ function countFilesAndLines(dir, ext = '.ts') {
163
+ let files = 0;
164
+ let lines = 0;
165
+
166
+ function walk(currentDir) {
167
+ if (!existsSync(currentDir)) return;
168
+
169
+ try {
170
+ const entries = readdirSync(currentDir, { withFileTypes: true });
171
+ for (const entry of entries) {
172
+ const fullPath = join(currentDir, entry.name);
173
+ if (entry.isDirectory() && !entry.name.includes('node_modules')) {
174
+ walk(fullPath);
175
+ } else if (entry.isFile() && entry.name.endsWith(ext)) {
176
+ files++;
177
+ try {
178
+ const content = readFileSync(fullPath, 'utf-8');
179
+ lines += content.split('\n').length;
180
+ } catch (e) {}
181
+ }
182
+ }
183
+ } catch (e) {}
184
+ }
185
+
186
+ walk(dir);
187
+ return { files, lines };
188
+ }
189
+
190
+ /**
191
+ * Calculate module progress
192
+ * Utility/service packages (cli, hooks, mcp, etc.) are considered complete (100%)
193
+ * as their services ARE the application layer (DDD by design)
194
+ */
195
+ const UTILITY_PACKAGES = new Set([
196
+ 'cli', 'hooks', 'mcp', 'shared', 'testing', 'agents', 'integration',
197
+ 'embeddings', 'deployment', 'performance', 'plugins', 'providers'
198
+ ]);
199
+
200
+ function calculateModuleProgress(moduleDir) {
201
+ if (!existsSync(moduleDir)) return 0;
202
+
203
+ const moduleName = basename(moduleDir);
204
+
205
+ // Utility packages are 100% complete by design
206
+ if (UTILITY_PACKAGES.has(moduleName)) {
207
+ return 100;
208
+ }
209
+
210
+ let progress = 0;
211
+
212
+ // Check for DDD structure
213
+ if (existsSync(join(moduleDir, 'src/domain'))) progress += 30;
214
+ if (existsSync(join(moduleDir, 'src/application'))) progress += 30;
215
+ if (existsSync(join(moduleDir, 'src'))) progress += 10;
216
+ if (existsSync(join(moduleDir, 'src/index.ts')) || existsSync(join(moduleDir, 'index.ts'))) progress += 10;
217
+ if (existsSync(join(moduleDir, '__tests__')) || existsSync(join(moduleDir, 'tests'))) progress += 10;
218
+ if (existsSync(join(moduleDir, 'package.json'))) progress += 10;
219
+
220
+ return Math.min(progress, 100);
221
+ }
222
+
223
+ /**
224
+ * Check security file status
225
+ */
226
+ function checkSecurityFile(filename, minLines = 100) {
227
+ const filePath = join(V3_DIR, '@claude-flow/security/src', filename);
228
+ if (!existsSync(filePath)) return false;
229
+
230
+ try {
231
+ const content = readFileSync(filePath, 'utf-8');
232
+ return content.split('\n').length > minLines;
233
+ } catch (e) {
234
+ return false;
235
+ }
236
+ }
237
+
238
+ /**
239
+ * Count active processes
240
+ */
241
+ function countProcesses() {
242
+ try {
243
+ const ps = execSync('ps aux 2>/dev/null || echo ""', { encoding: 'utf-8' });
244
+
245
+ const agenticFlow = (ps.match(/agentic-flow/g) || []).length;
246
+ const mcp = (ps.match(/mcp.*start/g) || []).length;
247
+ const agents = (ps.match(/agent|swarm|coordinator/g) || []).length;
248
+
249
+ return {
250
+ agenticFlow: Math.max(0, agenticFlow - 1), // Exclude grep itself
251
+ mcp,
252
+ agents: Math.max(0, agents - 1)
253
+ };
254
+ } catch (e) {
255
+ return { agenticFlow: 0, mcp: 0, agents: 0 };
256
+ }
257
+ }
258
+
259
+ /**
260
+ * Sync all metrics from actual implementation
261
+ */
262
+ async function syncMetrics() {
263
+ const now = new Date().toISOString();
264
+
265
+ // Count V3 modules
266
+ const modulesDir = join(V3_DIR, '@claude-flow');
267
+ let modules = [];
268
+ let totalProgress = 0;
269
+
270
+ if (existsSync(modulesDir)) {
271
+ const entries = readdirSync(modulesDir, { withFileTypes: true });
272
+ for (const entry of entries) {
273
+ // Skip hidden directories (like .agentic-flow, .claude-flow)
274
+ if (entry.isDirectory() && !entry.name.startsWith('.')) {
275
+ const moduleDir = join(modulesDir, entry.name);
276
+ const { files, lines } = countFilesAndLines(moduleDir);
277
+ const progress = calculateModuleProgress(moduleDir);
278
+
279
+ modules.push({ name: entry.name, files, lines, progress });
280
+ totalProgress += progress;
281
+
282
+ // Update module_status table
283
+ db.run(`
284
+ INSERT OR REPLACE INTO module_status (name, files, lines, progress, has_src, has_tests, last_updated)
285
+ VALUES (?, ?, ?, ?, ?, ?, ?)
286
+ `, [
287
+ entry.name,
288
+ files,
289
+ lines,
290
+ progress,
291
+ existsSync(join(moduleDir, 'src')) ? 1 : 0,
292
+ existsSync(join(moduleDir, '__tests__')) ? 1 : 0,
293
+ now
294
+ ]);
295
+ }
296
+ }
297
+ }
298
+
299
+ const avgProgress = modules.length > 0 ? Math.round(totalProgress / modules.length) : 0;
300
+ const totalStats = countFilesAndLines(V3_DIR);
301
+
302
+ // Count completed domains (mapped to modules)
303
+ const domainModules = ['swarm', 'memory', 'performance', 'cli', 'integration'];
304
+ const domainsCompleted = domainModules.filter(m =>
305
+ modules.some(mod => mod.name === m && mod.progress >= 50)
306
+ ).length;
307
+
308
+ // Update v3_progress
309
+ db.run(`
310
+ UPDATE v3_progress SET
311
+ domains_completed = ?,
312
+ ddd_progress = ?,
313
+ total_modules = ?,
314
+ total_files = ?,
315
+ total_lines = ?,
316
+ last_updated = ?
317
+ WHERE id = 1
318
+ `, [domainsCompleted, avgProgress, modules.length, totalStats.files, totalStats.lines, now]);
319
+
320
+ // Check security CVEs
321
+ const cve1Fixed = checkSecurityFile('input-validator.ts');
322
+ const cve2Fixed = checkSecurityFile('path-validator.ts');
323
+ const cve3Fixed = checkSecurityFile('safe-executor.ts');
324
+ const cvesFixed = [cve1Fixed, cve2Fixed, cve3Fixed].filter(Boolean).length;
325
+
326
+ let securityStatus = 'PENDING';
327
+ if (cvesFixed === 3) securityStatus = 'CLEAN';
328
+ else if (cvesFixed > 0) securityStatus = 'IN_PROGRESS';
329
+
330
+ db.run(`
331
+ UPDATE security_audit SET
332
+ status = ?,
333
+ cves_fixed = ?,
334
+ last_audit = ?
335
+ WHERE id = 1
336
+ `, [securityStatus, cvesFixed, now]);
337
+
338
+ // Update individual CVE status
339
+ db.run("UPDATE cve_status SET status = ?, last_updated = ? WHERE id = 'CVE-1'", [cve1Fixed ? 'fixed' : 'pending', now]);
340
+ db.run("UPDATE cve_status SET status = ?, last_updated = ? WHERE id = 'CVE-2'", [cve2Fixed ? 'fixed' : 'pending', now]);
341
+ db.run("UPDATE cve_status SET status = ?, last_updated = ? WHERE id = 'CVE-3'", [cve3Fixed ? 'fixed' : 'pending', now]);
342
+
343
+ // Update swarm activity
344
+ const processes = countProcesses();
345
+ db.run(`
346
+ UPDATE swarm_activity SET
347
+ agentic_flow_processes = ?,
348
+ mcp_server_processes = ?,
349
+ estimated_agents = ?,
350
+ swarm_active = ?,
351
+ coordination_active = ?,
352
+ last_updated = ?
353
+ WHERE id = 1
354
+ `, [
355
+ processes.agenticFlow,
356
+ processes.mcp,
357
+ processes.agents,
358
+ processes.agents > 0 ? 1 : 0,
359
+ processes.agenticFlow > 0 ? 1 : 0,
360
+ now
361
+ ]);
362
+
363
+ persist();
364
+
365
+ return {
366
+ modules: modules.length,
367
+ domains: domainsCompleted,
368
+ dddProgress: avgProgress,
369
+ cvesFixed,
370
+ securityStatus,
371
+ files: totalStats.files,
372
+ lines: totalStats.lines
373
+ };
374
+ }
375
+
376
+ /**
377
+ * Get current metrics as JSON (for statusline compatibility)
378
+ */
379
+ function getMetricsJSON() {
380
+ const progress = db.exec("SELECT * FROM v3_progress WHERE id = 1")[0];
381
+ const security = db.exec("SELECT * FROM security_audit WHERE id = 1")[0];
382
+ const swarm = db.exec("SELECT * FROM swarm_activity WHERE id = 1")[0];
383
+ const perf = db.exec("SELECT * FROM performance_metrics WHERE id = 1")[0];
384
+
385
+ // Map column names to values
386
+ const mapRow = (result) => {
387
+ if (!result) return {};
388
+ const cols = result.columns;
389
+ const vals = result.values[0];
390
+ return Object.fromEntries(cols.map((c, i) => [c, vals[i]]));
391
+ };
392
+
393
+ return {
394
+ v3Progress: mapRow(progress),
395
+ securityAudit: mapRow(security),
396
+ swarmActivity: mapRow(swarm),
397
+ performanceMetrics: mapRow(perf)
398
+ };
399
+ }
400
+
401
+ /**
402
+ * Export metrics to JSON files for backward compatibility
403
+ */
404
+ function exportToJSON() {
405
+ const metrics = getMetricsJSON();
406
+ const metricsDir = join(PROJECT_ROOT, '.claude-flow/metrics');
407
+ const securityDir = join(PROJECT_ROOT, '.claude-flow/security');
408
+
409
+ if (!existsSync(metricsDir)) mkdirSync(metricsDir, { recursive: true });
410
+ if (!existsSync(securityDir)) mkdirSync(securityDir, { recursive: true });
411
+
412
+ // v3-progress.json
413
+ writeFileSync(join(metricsDir, 'v3-progress.json'), JSON.stringify({
414
+ domains: {
415
+ completed: metrics.v3Progress.domains_completed,
416
+ total: metrics.v3Progress.domains_total
417
+ },
418
+ ddd: {
419
+ progress: metrics.v3Progress.ddd_progress,
420
+ modules: metrics.v3Progress.total_modules,
421
+ totalFiles: metrics.v3Progress.total_files,
422
+ totalLines: metrics.v3Progress.total_lines
423
+ },
424
+ swarm: {
425
+ activeAgents: metrics.swarmActivity.estimated_agents,
426
+ totalAgents: 15
427
+ },
428
+ lastUpdated: metrics.v3Progress.last_updated,
429
+ source: 'metrics.db'
430
+ }, null, 2));
431
+
432
+ // security/audit-status.json
433
+ writeFileSync(join(securityDir, 'audit-status.json'), JSON.stringify({
434
+ status: metrics.securityAudit.status,
435
+ cvesFixed: metrics.securityAudit.cves_fixed,
436
+ totalCves: metrics.securityAudit.total_cves,
437
+ lastAudit: metrics.securityAudit.last_audit,
438
+ source: 'metrics.db'
439
+ }, null, 2));
440
+
441
+ // swarm-activity.json
442
+ writeFileSync(join(metricsDir, 'swarm-activity.json'), JSON.stringify({
443
+ timestamp: metrics.swarmActivity.last_updated,
444
+ processes: {
445
+ agentic_flow: metrics.swarmActivity.agentic_flow_processes,
446
+ mcp_server: metrics.swarmActivity.mcp_server_processes,
447
+ estimated_agents: metrics.swarmActivity.estimated_agents
448
+ },
449
+ swarm: {
450
+ active: metrics.swarmActivity.swarm_active === 1,
451
+ agent_count: metrics.swarmActivity.estimated_agents,
452
+ coordination_active: metrics.swarmActivity.coordination_active === 1
453
+ },
454
+ source: 'metrics.db'
455
+ }, null, 2));
456
+ }
457
+
458
+ /**
459
+ * Main entry point
460
+ */
461
+ async function main() {
462
+ const command = process.argv[2] || 'sync';
463
+
464
+ await initDatabase();
465
+
466
+ switch (command) {
467
+ case 'sync':
468
+ const result = await syncMetrics();
469
+ exportToJSON();
470
+ console.log(JSON.stringify(result));
471
+ break;
472
+
473
+ case 'export':
474
+ exportToJSON();
475
+ console.log('Exported to JSON files');
476
+ break;
477
+
478
+ case 'status':
479
+ const metrics = getMetricsJSON();
480
+ console.log(JSON.stringify(metrics, null, 2));
481
+ break;
482
+
483
+ case 'daemon':
484
+ const interval = parseInt(process.argv[3]) || 30;
485
+ console.log(`Starting metrics daemon (interval: ${interval}s)`);
486
+
487
+ // Initial sync
488
+ await syncMetrics();
489
+ exportToJSON();
490
+
491
+ // Continuous sync
492
+ setInterval(async () => {
493
+ await syncMetrics();
494
+ exportToJSON();
495
+ }, interval * 1000);
496
+ break;
497
+
498
+ default:
499
+ console.log('Usage: metrics-db.mjs [sync|export|status|daemon [interval]]');
500
+ }
501
+ }
502
+
503
+ main().catch(console.error);