@claude-flow/cli 3.27.4 → 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 (464) hide show
  1. package/.claude/agents/analysis/analyze-code-quality.md +178 -178
  2. package/.claude/agents/analysis/code-analyzer.md +209 -209
  3. package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
  4. package/.claude/agents/architecture/arch-system-design.md +156 -156
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
  6. package/.claude/agents/browser/browser-agent.yaml +182 -182
  7. package/.claude/agents/consensus/byzantine-coordinator.md +62 -62
  8. package/.claude/agents/consensus/crdt-synchronizer.md +996 -996
  9. package/.claude/agents/consensus/gossip-coordinator.md +62 -62
  10. package/.claude/agents/consensus/performance-benchmarker.md +850 -850
  11. package/.claude/agents/consensus/quorum-manager.md +822 -822
  12. package/.claude/agents/consensus/raft-manager.md +62 -62
  13. package/.claude/agents/consensus/security-manager.md +621 -621
  14. package/.claude/agents/core/planner.md +374 -374
  15. package/.claude/agents/custom/test-long-runner.md +44 -44
  16. package/.claude/agents/data/data-ml-model.md +444 -444
  17. package/.claude/agents/data/ml/data-ml-model.md +192 -192
  18. package/.claude/agents/development/backend/dev-backend-api.md +141 -141
  19. package/.claude/agents/development/dev-backend-api.md +344 -344
  20. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
  21. package/.claude/agents/devops/ops-cicd-github.md +164 -164
  22. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
  23. package/.claude/agents/documentation/docs-api-openapi.md +354 -354
  24. package/.claude/agents/flow-nexus/app-store.md +87 -87
  25. package/.claude/agents/flow-nexus/authentication.md +68 -68
  26. package/.claude/agents/flow-nexus/challenges.md +80 -80
  27. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  28. package/.claude/agents/flow-nexus/payments.md +82 -82
  29. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  30. package/.claude/agents/flow-nexus/swarm.md +75 -75
  31. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  32. package/.claude/agents/flow-nexus/workflow.md +83 -83
  33. package/.claude/agents/github/code-review-swarm.md +377 -377
  34. package/.claude/agents/github/github-modes.md +172 -172
  35. package/.claude/agents/github/issue-tracker.md +575 -575
  36. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  37. package/.claude/agents/github/pr-manager.md +437 -437
  38. package/.claude/agents/github/project-board-sync.md +508 -508
  39. package/.claude/agents/github/release-manager.md +604 -604
  40. package/.claude/agents/github/release-swarm.md +582 -582
  41. package/.claude/agents/github/repo-architect.md +397 -397
  42. package/.claude/agents/github/swarm-issue.md +572 -572
  43. package/.claude/agents/github/swarm-pr.md +427 -427
  44. package/.claude/agents/github/sync-coordinator.md +451 -451
  45. package/.claude/agents/github/workflow-automation.md +902 -902
  46. package/.claude/agents/goal/agent.md +815 -815
  47. package/.claude/agents/optimization/benchmark-suite.md +664 -664
  48. package/.claude/agents/optimization/load-balancer.md +430 -430
  49. package/.claude/agents/optimization/performance-monitor.md +671 -671
  50. package/.claude/agents/optimization/resource-allocator.md +673 -673
  51. package/.claude/agents/optimization/topology-optimizer.md +807 -807
  52. package/.claude/agents/payments/agentic-payments.md +126 -126
  53. package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
  54. package/.claude/agents/sparc/architecture.md +698 -698
  55. package/.claude/agents/sparc/pseudocode.md +519 -519
  56. package/.claude/agents/sparc/refinement.md +801 -801
  57. package/.claude/agents/sparc/specification.md +477 -477
  58. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
  59. package/.claude/agents/specialized/spec-mobile-react-native.md +226 -226
  60. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  61. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  62. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  63. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  64. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  65. package/.claude/agents/swarm/adaptive-coordinator.md +1126 -1126
  66. package/.claude/agents/swarm/hierarchical-coordinator.md +709 -709
  67. package/.claude/agents/swarm/mesh-coordinator.md +962 -962
  68. package/.claude/agents/templates/automation-smart-agent.md +204 -204
  69. package/.claude/agents/templates/base-template-generator.md +289 -289
  70. package/.claude/agents/templates/coordinator-swarm-init.md +89 -89
  71. package/.claude/agents/templates/github-pr-manager.md +176 -176
  72. package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
  73. package/.claude/agents/templates/memory-coordinator.md +186 -186
  74. package/.claude/agents/templates/orchestrator-task.md +138 -138
  75. package/.claude/agents/templates/performance-analyzer.md +198 -198
  76. package/.claude/agents/templates/sparc-coordinator.md +513 -513
  77. package/.claude/agents/testing/production-validator.md +394 -394
  78. package/.claude/agents/testing/tdd-london-swarm.md +243 -243
  79. package/.claude/agents/v3/aidefence-guardian.md +282 -282
  80. package/.claude/agents/v3/claims-authorizer.md +208 -208
  81. package/.claude/agents/v3/collective-intelligence-coordinator.md +993 -993
  82. package/.claude/agents/v3/ddd-domain-expert.md +220 -220
  83. package/.claude/agents/v3/injection-analyst.md +236 -236
  84. package/.claude/agents/v3/performance-engineer.md +1233 -1233
  85. package/.claude/agents/v3/pii-detector.md +151 -151
  86. package/.claude/agents/v3/reasoningbank-learner.md +213 -213
  87. package/.claude/agents/v3/security-architect-aidefence.md +410 -410
  88. package/.claude/agents/v3/security-architect.md +867 -867
  89. package/.claude/agents/v3/swarm-memory-manager.md +157 -157
  90. package/.claude/agents/v3/v3-integration-architect.md +205 -205
  91. package/.claude/commands/agents/README.md +50 -50
  92. package/.claude/commands/agents/agent-capabilities.md +140 -140
  93. package/.claude/commands/agents/agent-coordination.md +28 -28
  94. package/.claude/commands/agents/agent-spawning.md +28 -28
  95. package/.claude/commands/agents/agent-types.md +216 -216
  96. package/.claude/commands/agents/health.md +139 -139
  97. package/.claude/commands/agents/list.md +100 -100
  98. package/.claude/commands/agents/logs.md +130 -130
  99. package/.claude/commands/agents/metrics.md +122 -122
  100. package/.claude/commands/agents/pool.md +127 -127
  101. package/.claude/commands/agents/spawn.md +140 -140
  102. package/.claude/commands/agents/status.md +115 -115
  103. package/.claude/commands/agents/stop.md +102 -102
  104. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  105. package/.claude/commands/analysis/README.md +9 -9
  106. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  107. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  108. package/.claude/commands/analysis/performance-report.md +25 -25
  109. package/.claude/commands/analysis/token-efficiency.md +44 -44
  110. package/.claude/commands/analysis/token-usage.md +25 -25
  111. package/.claude/commands/automation/README.md +9 -9
  112. package/.claude/commands/automation/auto-agent.md +122 -122
  113. package/.claude/commands/automation/self-healing.md +105 -105
  114. package/.claude/commands/automation/session-memory.md +89 -89
  115. package/.claude/commands/automation/smart-agents.md +72 -72
  116. package/.claude/commands/automation/smart-spawn.md +25 -25
  117. package/.claude/commands/automation/workflow-select.md +25 -25
  118. package/.claude/commands/claude-flow-help.md +103 -103
  119. package/.claude/commands/claude-flow-memory.md +107 -107
  120. package/.claude/commands/claude-flow-swarm.md +205 -205
  121. package/.claude/commands/coordination/README.md +9 -9
  122. package/.claude/commands/coordination/agent-spawn.md +25 -25
  123. package/.claude/commands/coordination/init.md +44 -44
  124. package/.claude/commands/coordination/orchestrate.md +43 -43
  125. package/.claude/commands/coordination/spawn.md +45 -45
  126. package/.claude/commands/coordination/swarm-init.md +85 -85
  127. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  128. package/.claude/commands/github/README.md +11 -11
  129. package/.claude/commands/github/code-review-swarm.md +513 -513
  130. package/.claude/commands/github/code-review.md +25 -25
  131. package/.claude/commands/github/github-modes.md +146 -146
  132. package/.claude/commands/github/github-swarm.md +121 -121
  133. package/.claude/commands/github/issue-tracker.md +291 -291
  134. package/.claude/commands/github/issue-triage.md +25 -25
  135. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  136. package/.claude/commands/github/pr-enhance.md +26 -26
  137. package/.claude/commands/github/pr-manager.md +169 -169
  138. package/.claude/commands/github/project-board-sync.md +470 -470
  139. package/.claude/commands/github/release-manager.md +339 -339
  140. package/.claude/commands/github/release-swarm.md +543 -543
  141. package/.claude/commands/github/repo-analyze.md +25 -25
  142. package/.claude/commands/github/repo-architect.md +366 -366
  143. package/.claude/commands/github/swarm-issue.md +484 -484
  144. package/.claude/commands/github/swarm-pr.md +287 -287
  145. package/.claude/commands/github/sync-coordinator.md +302 -302
  146. package/.claude/commands/github/workflow-automation.md +441 -441
  147. package/.claude/commands/hive-mind/README.md +17 -17
  148. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  149. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  150. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  151. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  152. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  153. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  154. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  155. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  156. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  157. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  158. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  159. package/.claude/commands/hooks/README.md +11 -11
  160. package/.claude/commands/hooks/overview.md +57 -57
  161. package/.claude/commands/hooks/post-edit.md +117 -117
  162. package/.claude/commands/hooks/post-task.md +112 -112
  163. package/.claude/commands/hooks/pre-edit.md +113 -113
  164. package/.claude/commands/hooks/pre-task.md +111 -111
  165. package/.claude/commands/hooks/session-end.md +118 -118
  166. package/.claude/commands/hooks/setup.md +102 -102
  167. package/.claude/commands/memory/README.md +9 -9
  168. package/.claude/commands/memory/memory-persist.md +25 -25
  169. package/.claude/commands/memory/memory-search.md +25 -25
  170. package/.claude/commands/memory/memory-usage.md +25 -25
  171. package/.claude/commands/memory/neural.md +47 -47
  172. package/.claude/commands/monitoring/README.md +9 -9
  173. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  174. package/.claude/commands/monitoring/agents.md +44 -44
  175. package/.claude/commands/monitoring/real-time-view.md +25 -25
  176. package/.claude/commands/monitoring/status.md +46 -46
  177. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  178. package/.claude/commands/optimization/README.md +9 -9
  179. package/.claude/commands/optimization/auto-topology.md +61 -61
  180. package/.claude/commands/optimization/cache-manage.md +25 -25
  181. package/.claude/commands/optimization/parallel-execute.md +25 -25
  182. package/.claude/commands/optimization/parallel-execution.md +49 -49
  183. package/.claude/commands/optimization/topology-optimize.md +25 -25
  184. package/.claude/commands/pair/README.md +260 -260
  185. package/.claude/commands/pair/commands.md +545 -545
  186. package/.claude/commands/pair/config.md +509 -509
  187. package/.claude/commands/pair/examples.md +511 -511
  188. package/.claude/commands/pair/modes.md +347 -347
  189. package/.claude/commands/pair/session.md +406 -406
  190. package/.claude/commands/pair/start.md +208 -208
  191. package/.claude/commands/sparc/analyzer.md +51 -51
  192. package/.claude/commands/sparc/architect.md +53 -53
  193. package/.claude/commands/sparc/ask.md +97 -97
  194. package/.claude/commands/sparc/batch-executor.md +54 -54
  195. package/.claude/commands/sparc/code.md +89 -89
  196. package/.claude/commands/sparc/coder.md +54 -54
  197. package/.claude/commands/sparc/debug.md +83 -83
  198. package/.claude/commands/sparc/debugger.md +54 -54
  199. package/.claude/commands/sparc/designer.md +53 -53
  200. package/.claude/commands/sparc/devops.md +109 -109
  201. package/.claude/commands/sparc/docs-writer.md +80 -80
  202. package/.claude/commands/sparc/documenter.md +54 -54
  203. package/.claude/commands/sparc/innovator.md +54 -54
  204. package/.claude/commands/sparc/integration.md +83 -83
  205. package/.claude/commands/sparc/mcp.md +117 -117
  206. package/.claude/commands/sparc/memory-manager.md +54 -54
  207. package/.claude/commands/sparc/optimizer.md +54 -54
  208. package/.claude/commands/sparc/orchestrator.md +131 -131
  209. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  210. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  211. package/.claude/commands/sparc/researcher.md +54 -54
  212. package/.claude/commands/sparc/reviewer.md +54 -54
  213. package/.claude/commands/sparc/security-review.md +80 -80
  214. package/.claude/commands/sparc/sparc-modes.md +174 -174
  215. package/.claude/commands/sparc/sparc.md +111 -111
  216. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  217. package/.claude/commands/sparc/supabase-admin.md +348 -348
  218. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  219. package/.claude/commands/sparc/tdd.md +54 -54
  220. package/.claude/commands/sparc/tester.md +54 -54
  221. package/.claude/commands/sparc/tutorial.md +79 -79
  222. package/.claude/commands/sparc/workflow-manager.md +54 -54
  223. package/.claude/commands/sparc.md +166 -166
  224. package/.claude/commands/stream-chain/pipeline.md +120 -120
  225. package/.claude/commands/stream-chain/run.md +69 -69
  226. package/.claude/commands/swarm/README.md +15 -15
  227. package/.claude/commands/swarm/analysis.md +95 -95
  228. package/.claude/commands/swarm/development.md +96 -96
  229. package/.claude/commands/swarm/examples.md +168 -168
  230. package/.claude/commands/swarm/maintenance.md +102 -102
  231. package/.claude/commands/swarm/optimization.md +117 -117
  232. package/.claude/commands/swarm/research.md +136 -136
  233. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  234. package/.claude/commands/swarm/swarm-background.md +8 -8
  235. package/.claude/commands/swarm/swarm-init.md +19 -19
  236. package/.claude/commands/swarm/swarm-modes.md +8 -8
  237. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  238. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  239. package/.claude/commands/swarm/swarm-status.md +8 -8
  240. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  241. package/.claude/commands/swarm/swarm.md +87 -87
  242. package/.claude/commands/swarm/testing.md +131 -131
  243. package/.claude/commands/training/README.md +9 -9
  244. package/.claude/commands/training/model-update.md +25 -25
  245. package/.claude/commands/training/neural-patterns.md +107 -107
  246. package/.claude/commands/training/neural-train.md +75 -75
  247. package/.claude/commands/training/pattern-learn.md +25 -25
  248. package/.claude/commands/training/specialization.md +62 -62
  249. package/.claude/commands/truth/start.md +142 -142
  250. package/.claude/commands/verify/check.md +49 -49
  251. package/.claude/commands/verify/start.md +127 -127
  252. package/.claude/commands/workflows/README.md +9 -9
  253. package/.claude/commands/workflows/development.md +77 -77
  254. package/.claude/commands/workflows/research.md +62 -62
  255. package/.claude/commands/workflows/workflow-create.md +25 -25
  256. package/.claude/commands/workflows/workflow-execute.md +25 -25
  257. package/.claude/commands/workflows/workflow-export.md +25 -25
  258. package/.claude/eval/human-relevance-frozen-v1.json +17 -17
  259. package/.claude/evolve-proof/generation-0.json +211 -211
  260. package/.claude/evolve-proof/real-generation-0.json +406 -406
  261. package/.claude/evolve-proof/real-generation-1.json +406 -406
  262. package/.claude/helpers/README.md +96 -96
  263. package/.claude/helpers/adr-compliance.sh +186 -186
  264. package/.claude/helpers/auto-commit.sh +178 -178
  265. package/.claude/helpers/auto-memory-hook.mjs +430 -430
  266. package/.claude/helpers/checkpoint-manager.sh +251 -251
  267. package/.claude/helpers/daemon-manager.sh +252 -252
  268. package/.claude/helpers/ddd-tracker.sh +144 -144
  269. package/.claude/helpers/github-safe.js +156 -156
  270. package/.claude/helpers/github-setup.sh +45 -45
  271. package/.claude/helpers/guidance-hook.sh +13 -13
  272. package/.claude/helpers/guidance-hooks.sh +102 -102
  273. package/.claude/helpers/health-monitor.sh +108 -108
  274. package/.claude/helpers/helpers.manifest.json +6 -6
  275. package/.claude/helpers/hook-handler.cjs +460 -460
  276. package/.claude/helpers/intelligence.cjs +1058 -1058
  277. package/.claude/helpers/learning-hooks.sh +329 -329
  278. package/.claude/helpers/learning-optimizer.sh +127 -127
  279. package/.claude/helpers/learning-service.mjs +1144 -1144
  280. package/.claude/helpers/memory.js +83 -83
  281. package/.claude/helpers/metrics-db.mjs +503 -503
  282. package/.claude/helpers/pattern-consolidator.sh +86 -86
  283. package/.claude/helpers/perf-worker.sh +160 -160
  284. package/.claude/helpers/post-commit +16 -16
  285. package/.claude/helpers/pre-commit +26 -26
  286. package/.claude/helpers/quick-start.sh +19 -19
  287. package/.claude/helpers/router.js +105 -105
  288. package/.claude/helpers/security-scanner.sh +127 -127
  289. package/.claude/helpers/session.js +157 -157
  290. package/.claude/helpers/setup-mcp.sh +18 -18
  291. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  292. package/.claude/helpers/statusline-hook.sh +21 -21
  293. package/.claude/helpers/statusline.cjs +925 -925
  294. package/.claude/helpers/statusline.js +352 -352
  295. package/.claude/helpers/swarm-comms.sh +353 -353
  296. package/.claude/helpers/swarm-hooks.sh +761 -761
  297. package/.claude/helpers/swarm-monitor.sh +210 -210
  298. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  299. package/.claude/helpers/update-v3-progress.sh +165 -165
  300. package/.claude/helpers/v3-quick-status.sh +57 -57
  301. package/.claude/helpers/v3.sh +110 -110
  302. package/.claude/helpers/validate-v3-config.sh +215 -215
  303. package/.claude/helpers/worker-manager.sh +170 -170
  304. package/.claude/proven-config.json +1 -1
  305. package/.claude/proven-config.manifest.json +37 -37
  306. package/.claude/proven-config.signed.json +41 -41
  307. package/.claude/settings.json +182 -182
  308. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  309. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  310. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  311. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  312. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  313. package/.claude/skills/browser/SKILL.md +204 -204
  314. package/.claude/skills/dual-mode/README.md +71 -71
  315. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  316. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  317. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  318. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  319. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  320. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  321. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  322. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  323. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  324. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  325. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  326. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  327. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  328. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  329. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  330. package/.claude/skills/skill-builder/SKILL.md +910 -910
  331. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  332. package/.claude/skills/stream-chain/SKILL.md +560 -560
  333. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  334. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  335. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  336. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  337. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  338. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  339. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  340. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  341. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  342. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  343. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  344. package/.claude/skills/verification-quality/SKILL.md +691 -691
  345. package/README.md +419 -419
  346. package/bin/cli.js +314 -314
  347. package/bin/mcp-server.js +224 -224
  348. package/bin/preinstall.cjs +2 -2
  349. package/catalog-manifest.json +2 -2
  350. package/dist/src/benchmarks/gaia-critic.js +24 -24
  351. package/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  352. package/dist/src/commands/completions.js +409 -409
  353. package/dist/src/commands/daemon.d.ts +23 -0
  354. package/dist/src/commands/daemon.js +216 -44
  355. package/dist/src/commands/embeddings.js +26 -26
  356. package/dist/src/commands/funnel.d.ts +2 -0
  357. package/dist/src/commands/funnel.js +110 -2
  358. package/dist/src/commands/hive-mind.js +97 -97
  359. package/dist/src/commands/hooks.js +9 -9
  360. package/dist/src/commands/init.js +94 -38
  361. package/dist/src/commands/memory.js +85 -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.d.ts +1 -0
  372. package/dist/src/funnel/disclosure.js +12 -0
  373. package/dist/src/funnel/index.d.ts +1 -1
  374. package/dist/src/funnel/index.js +1 -1
  375. package/dist/src/init/claudemd-generator.js +231 -231
  376. package/dist/src/init/executor.js +453 -453
  377. package/dist/src/init/helper-signing.d.ts +8 -1
  378. package/dist/src/init/helper-signing.js +9 -2
  379. package/dist/src/init/helpers-generator.js +751 -751
  380. package/dist/src/init/statusline-generator.js +994 -951
  381. package/dist/src/mcp-tools/agentdb-tools.js +15 -15
  382. package/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  383. package/dist/src/memory/graph-edge-writer.js +22 -22
  384. package/dist/src/memory/memory-bridge.d.ts +10 -0
  385. package/dist/src/memory/memory-bridge.js +139 -88
  386. package/dist/src/memory/memory-initializer.d.ts +18 -0
  387. package/dist/src/memory/memory-initializer.js +539 -407
  388. package/dist/src/memory/rabitq-index.js +5 -5
  389. package/dist/src/runtime/headless.js +28 -28
  390. package/dist/src/ruvector/flash-attention.d.ts +195 -0
  391. package/dist/src/ruvector/flash-attention.js +643 -0
  392. package/dist/src/ruvector/moe-router.d.ts +206 -0
  393. package/dist/src/ruvector/moe-router.js +626 -0
  394. package/dist/src/services/distill-tuning.js +7 -7
  395. package/dist/src/services/event-stream.d.ts +25 -0
  396. package/dist/src/services/event-stream.js +27 -0
  397. package/dist/src/services/global-ai-budget.d.ts +25 -0
  398. package/dist/src/services/global-ai-budget.js +56 -0
  399. package/dist/src/services/headless-worker-executor.d.ts +21 -0
  400. package/dist/src/services/headless-worker-executor.js +152 -86
  401. package/dist/src/services/loop-worker-runner.d.ts +16 -0
  402. package/dist/src/services/loop-worker-runner.js +34 -0
  403. package/dist/src/services/memory-distillation.js +4 -4
  404. package/dist/src/services/repo-supervisor.d.ts +70 -0
  405. package/dist/src/services/repo-supervisor.js +228 -0
  406. package/dist/src/services/runtime-capabilities.d.ts +22 -0
  407. package/dist/src/services/runtime-capabilities.js +45 -0
  408. package/dist/src/services/worker-daemon.d.ts +26 -0
  409. package/dist/src/services/worker-daemon.js +95 -5
  410. package/dist/src/services/workspace-lease.d.ts +55 -0
  411. package/dist/src/services/workspace-lease.js +191 -0
  412. package/dist/src/transfer/deploy-seraphine.js +23 -23
  413. package/package.json +134 -133
  414. package/plugins/ruflo-metaharness/.claude-plugin/plugin.json +32 -32
  415. package/plugins/ruflo-metaharness/README.md +72 -72
  416. package/plugins/ruflo-metaharness/agents/metaharness-architect.md +58 -58
  417. package/plugins/ruflo-metaharness/commands/ruflo-metaharness.md +48 -48
  418. package/plugins/ruflo-metaharness/scripts/_darwin.mjs +210 -210
  419. package/plugins/ruflo-metaharness/scripts/_harness.mjs +330 -330
  420. package/plugins/ruflo-metaharness/scripts/_invoke.mjs +231 -231
  421. package/plugins/ruflo-metaharness/scripts/_redblue.mjs +143 -143
  422. package/plugins/ruflo-metaharness/scripts/_similarity.mjs +161 -161
  423. package/plugins/ruflo-metaharness/scripts/_spike-similarity.mjs +223 -223
  424. package/plugins/ruflo-metaharness/scripts/audit-list.mjs +158 -158
  425. package/plugins/ruflo-metaharness/scripts/audit-trend.mjs +272 -272
  426. package/plugins/ruflo-metaharness/scripts/bench-parse-mcp-scan.mjs +146 -146
  427. package/plugins/ruflo-metaharness/scripts/bench-recordpair-overhead.mjs +186 -186
  428. package/plugins/ruflo-metaharness/scripts/bench-similarity.mjs +177 -177
  429. package/plugins/ruflo-metaharness/scripts/bench.mjs +95 -95
  430. package/plugins/ruflo-metaharness/scripts/drift-from-history.mjs +363 -363
  431. package/plugins/ruflo-metaharness/scripts/evolve.mjs +404 -404
  432. package/plugins/ruflo-metaharness/scripts/genome.mjs +80 -80
  433. package/plugins/ruflo-metaharness/scripts/gepa.mjs +153 -153
  434. package/plugins/ruflo-metaharness/scripts/learn.mjs +127 -127
  435. package/plugins/ruflo-metaharness/scripts/mcp-scan.mjs +111 -111
  436. package/plugins/ruflo-metaharness/scripts/mint.mjs +126 -126
  437. package/plugins/ruflo-metaharness/scripts/oia-audit.mjs +228 -228
  438. package/plugins/ruflo-metaharness/scripts/redblue.mjs +286 -286
  439. package/plugins/ruflo-metaharness/scripts/router-parallel-analyze.mjs +250 -250
  440. package/plugins/ruflo-metaharness/scripts/score.mjs +92 -92
  441. package/plugins/ruflo-metaharness/scripts/security-bench.mjs +174 -174
  442. package/plugins/ruflo-metaharness/scripts/similarity.mjs +158 -158
  443. package/plugins/ruflo-metaharness/scripts/smoke.sh +2353 -2353
  444. package/plugins/ruflo-metaharness/scripts/test-graceful-degradation.mjs +165 -165
  445. package/plugins/ruflo-metaharness/scripts/test-mcp-tools.mjs +472 -472
  446. package/plugins/ruflo-metaharness/scripts/test-parallel-pipeline.mjs +204 -204
  447. package/plugins/ruflo-metaharness/scripts/test-pipeline-roundtrip.mjs +586 -586
  448. package/plugins/ruflo-metaharness/scripts/test-similarity.mjs +334 -334
  449. package/plugins/ruflo-metaharness/scripts/test-with-openrouter.mjs +229 -229
  450. package/plugins/ruflo-metaharness/scripts/threat-model.mjs +59 -59
  451. package/plugins/ruflo-metaharness/skills/harness-bench/SKILL.md +64 -64
  452. package/plugins/ruflo-metaharness/skills/harness-drift-from-history/SKILL.md +65 -65
  453. package/plugins/ruflo-metaharness/skills/harness-evolve/SKILL.md +131 -131
  454. package/plugins/ruflo-metaharness/skills/harness-genome/SKILL.md +54 -54
  455. package/plugins/ruflo-metaharness/skills/harness-gepa/SKILL.md +65 -65
  456. package/plugins/ruflo-metaharness/skills/harness-learn/SKILL.md +65 -65
  457. package/plugins/ruflo-metaharness/skills/harness-mcp-scan/SKILL.md +49 -49
  458. package/plugins/ruflo-metaharness/skills/harness-mint/SKILL.md +72 -72
  459. package/plugins/ruflo-metaharness/skills/harness-oia-audit/SKILL.md +79 -79
  460. package/plugins/ruflo-metaharness/skills/harness-score/SKILL.md +66 -66
  461. package/plugins/ruflo-metaharness/skills/harness-security-bench/SKILL.md +101 -101
  462. package/plugins/ruflo-metaharness/skills/harness-similarity/SKILL.md +67 -67
  463. package/plugins/ruflo-metaharness/skills/harness-threat-model/SKILL.md +41 -41
  464. package/scripts/postinstall.cjs +153 -153
@@ -51,103 +51,103 @@ function generateHiveMindPrompt(swarmId, swarmName, objective, workers, workerGr
51
51
  const queenType = flags.queenType || 'strategic';
52
52
  const consensusAlgorithm = flags.consensus || 'byzantine';
53
53
  const topology = flags.topology || 'hierarchical-mesh';
54
- return `🧠 HIVE MIND COLLECTIVE INTELLIGENCE SYSTEM
55
- ═══════════════════════════════════════════════
56
-
57
- You are the Queen coordinator of a Hive Mind swarm with collective intelligence capabilities.
58
-
59
- HIVE MIND CONFIGURATION:
60
- 📌 Swarm ID: ${swarmId}
61
- 📌 Swarm Name: ${swarmName}
62
- 🎯 Objective: ${objective}
63
- 👑 Queen Type: ${queenType}
64
- 🐝 Worker Count: ${workers.length}
65
- 🔗 Topology: ${topology}
66
- 🤝 Consensus Algorithm: ${consensusAlgorithm}
67
- ⏰ Initialized: ${currentTime}
68
-
69
- WORKER DISTRIBUTION:
70
- ${workerTypes.map(type => `• ${type}: ${workerGroups[type].length} agents`).join('\n')}
71
-
72
- 🔧 AVAILABLE MCP TOOLS FOR HIVE MIND COORDINATION:
73
-
74
- 1️⃣ **COLLECTIVE INTELLIGENCE**
75
- mcp__ruflo__hive-mind_consensus - Democratic decision making
76
- mcp__ruflo__hive-mind_memory - Share knowledge across the hive
77
- mcp__ruflo__hive-mind_broadcast - Broadcast to all workers
78
- mcp__ruflo__neural_patterns - Neural pattern recognition
79
-
80
- 2️⃣ **QUEEN COORDINATION**
81
- mcp__ruflo__hive-mind_status - Monitor swarm health
82
- mcp__ruflo__task_create - Create and delegate tasks
83
- mcp__ruflo__coordination_orchestrate - Orchestrate task distribution
84
- mcp__ruflo__agent_spawn - Spawn additional workers
85
-
86
- 3️⃣ **WORKER MANAGEMENT**
87
- mcp__ruflo__agent_list - List all active agents
88
- mcp__ruflo__agent_status - Check agent status
89
- mcp__ruflo__agent_health - Check worker health
90
- mcp__ruflo__hive-mind_join - Add agent to hive
91
- mcp__ruflo__hive-mind_leave - Remove agent from hive
92
-
93
- 4️⃣ **TASK ORCHESTRATION**
94
- mcp__ruflo__task_assign - Assign tasks to workers
95
- mcp__ruflo__task_status - Track task progress
96
- mcp__ruflo__task_complete - Mark tasks complete
97
- mcp__ruflo__workflow_create - Create workflows
98
-
99
- 5️⃣ **MEMORY & LEARNING**
100
- mcp__ruflo__memory_store - Store collective knowledge
101
- mcp__ruflo__memory_retrieve - Access shared memory
102
- mcp__ruflo__memory_search - Search memory patterns
103
- mcp__ruflo__neural_train - Learn from experiences
104
- mcp__ruflo__hooks_intelligence_pattern-store - Store patterns
105
-
106
- 📋 HIVE MIND EXECUTION PROTOCOL:
107
-
108
- 1. **INITIALIZATION PHASE**
109
- - Verify all workers are online and responsive
110
- - Establish communication channels
111
- - Load previous session state if available
112
- - Initialize shared memory space
113
-
114
- 2. **TASK DISTRIBUTION PHASE**
115
- - Analyze the objective and decompose into subtasks
116
- - Assign tasks based on worker specializations
117
- - Set up task dependencies and ordering
118
- - Monitor parallel execution
119
-
120
- 3. **COORDINATION PHASE**
121
- - Use consensus for critical decisions
122
- - Aggregate results from workers
123
- - Resolve conflicts using ${consensusAlgorithm} consensus
124
- - Share learnings across the hive
125
-
126
- 4. **COMPLETION PHASE**
127
- - Verify all subtasks are complete
128
- - Consolidate results
129
- - Store learnings in collective memory
130
- - Report final status
131
-
132
- 🎯 YOUR OBJECTIVE:
133
- ${objective}
134
-
135
- ⚠️ CRITICAL — TOOL PREFERENCE RULES (#1422):
136
- • You MUST use Ruflo MCP tools (mcp__ruflo__*) for ALL orchestration tasks
137
- • Do NOT use Claude native Task/Agent tools for swarm coordination — use mcp__ruflo__agent_spawn, mcp__ruflo__task_assign, etc.
138
- • Native Claude tools (Read, Write, Edit, Bash, Grep, Glob) should ONLY be used for file operations and shell commands
139
- • All agent spawning, task assignment, memory, and coordination MUST go through mcp__ruflo__* tools
140
- • If a Ruflo MCP tool exists for an operation, always prefer it over any native equivalent
141
-
142
- 💡 COORDINATION TIPS:
143
- • Use mcp__ruflo__hive-mind_broadcast for swarm-wide announcements
144
- • Check worker status regularly with mcp__ruflo__hive-mind_status
145
- • Store important decisions in shared memory for persistence
146
- • Use consensus for any decisions affecting multiple workers
147
- • Use mcp__ruflo__task_assign to assign tasks to workers, then mcp__ruflo__task_complete when done
148
-
149
- 🚀 BEGIN HIVE MIND COORDINATION NOW!
150
- Start by checking the current hive status and then proceed with the objective.
54
+ return `🧠 HIVE MIND COLLECTIVE INTELLIGENCE SYSTEM
55
+ ═══════════════════════════════════════════════
56
+
57
+ You are the Queen coordinator of a Hive Mind swarm with collective intelligence capabilities.
58
+
59
+ HIVE MIND CONFIGURATION:
60
+ 📌 Swarm ID: ${swarmId}
61
+ 📌 Swarm Name: ${swarmName}
62
+ 🎯 Objective: ${objective}
63
+ 👑 Queen Type: ${queenType}
64
+ 🐝 Worker Count: ${workers.length}
65
+ 🔗 Topology: ${topology}
66
+ 🤝 Consensus Algorithm: ${consensusAlgorithm}
67
+ ⏰ Initialized: ${currentTime}
68
+
69
+ WORKER DISTRIBUTION:
70
+ ${workerTypes.map(type => `• ${type}: ${workerGroups[type].length} agents`).join('\n')}
71
+
72
+ 🔧 AVAILABLE MCP TOOLS FOR HIVE MIND COORDINATION:
73
+
74
+ 1️⃣ **COLLECTIVE INTELLIGENCE**
75
+ mcp__ruflo__hive-mind_consensus - Democratic decision making
76
+ mcp__ruflo__hive-mind_memory - Share knowledge across the hive
77
+ mcp__ruflo__hive-mind_broadcast - Broadcast to all workers
78
+ mcp__ruflo__neural_patterns - Neural pattern recognition
79
+
80
+ 2️⃣ **QUEEN COORDINATION**
81
+ mcp__ruflo__hive-mind_status - Monitor swarm health
82
+ mcp__ruflo__task_create - Create and delegate tasks
83
+ mcp__ruflo__coordination_orchestrate - Orchestrate task distribution
84
+ mcp__ruflo__agent_spawn - Spawn additional workers
85
+
86
+ 3️⃣ **WORKER MANAGEMENT**
87
+ mcp__ruflo__agent_list - List all active agents
88
+ mcp__ruflo__agent_status - Check agent status
89
+ mcp__ruflo__agent_health - Check worker health
90
+ mcp__ruflo__hive-mind_join - Add agent to hive
91
+ mcp__ruflo__hive-mind_leave - Remove agent from hive
92
+
93
+ 4️⃣ **TASK ORCHESTRATION**
94
+ mcp__ruflo__task_assign - Assign tasks to workers
95
+ mcp__ruflo__task_status - Track task progress
96
+ mcp__ruflo__task_complete - Mark tasks complete
97
+ mcp__ruflo__workflow_create - Create workflows
98
+
99
+ 5️⃣ **MEMORY & LEARNING**
100
+ mcp__ruflo__memory_store - Store collective knowledge
101
+ mcp__ruflo__memory_retrieve - Access shared memory
102
+ mcp__ruflo__memory_search - Search memory patterns
103
+ mcp__ruflo__neural_train - Learn from experiences
104
+ mcp__ruflo__hooks_intelligence_pattern-store - Store patterns
105
+
106
+ 📋 HIVE MIND EXECUTION PROTOCOL:
107
+
108
+ 1. **INITIALIZATION PHASE**
109
+ - Verify all workers are online and responsive
110
+ - Establish communication channels
111
+ - Load previous session state if available
112
+ - Initialize shared memory space
113
+
114
+ 2. **TASK DISTRIBUTION PHASE**
115
+ - Analyze the objective and decompose into subtasks
116
+ - Assign tasks based on worker specializations
117
+ - Set up task dependencies and ordering
118
+ - Monitor parallel execution
119
+
120
+ 3. **COORDINATION PHASE**
121
+ - Use consensus for critical decisions
122
+ - Aggregate results from workers
123
+ - Resolve conflicts using ${consensusAlgorithm} consensus
124
+ - Share learnings across the hive
125
+
126
+ 4. **COMPLETION PHASE**
127
+ - Verify all subtasks are complete
128
+ - Consolidate results
129
+ - Store learnings in collective memory
130
+ - Report final status
131
+
132
+ 🎯 YOUR OBJECTIVE:
133
+ ${objective}
134
+
135
+ ⚠️ CRITICAL — TOOL PREFERENCE RULES (#1422):
136
+ • You MUST use Ruflo MCP tools (mcp__ruflo__*) for ALL orchestration tasks
137
+ • Do NOT use Claude native Task/Agent tools for swarm coordination — use mcp__ruflo__agent_spawn, mcp__ruflo__task_assign, etc.
138
+ • Native Claude tools (Read, Write, Edit, Bash, Grep, Glob) should ONLY be used for file operations and shell commands
139
+ • All agent spawning, task assignment, memory, and coordination MUST go through mcp__ruflo__* tools
140
+ • If a Ruflo MCP tool exists for an operation, always prefer it over any native equivalent
141
+
142
+ 💡 COORDINATION TIPS:
143
+ • Use mcp__ruflo__hive-mind_broadcast for swarm-wide announcements
144
+ • Check worker status regularly with mcp__ruflo__hive-mind_status
145
+ • Store important decisions in shared memory for persistence
146
+ • Use consensus for any decisions affecting multiple workers
147
+ • Use mcp__ruflo__task_assign to assign tasks to workers, then mcp__ruflo__task_complete when done
148
+
149
+ 🚀 BEGIN HIVE MIND COORDINATION NOW!
150
+ Start by checking the current hive status and then proceed with the objective.
151
151
  `;
152
152
  }
153
153
  /**
@@ -3942,15 +3942,15 @@ const tokenOptimizeCommand = {
3942
3942
  const total = stats.cacheHits + stats.cacheMisses;
3943
3943
  const hitRate = total > 0 ? (stats.cacheHits / total * 100).toFixed(1) : '0';
3944
3944
  const savings = (stats.totalTokensSaved / 1000 * 0.01).toFixed(2);
3945
- output.writeln(`## Token Optimization Report
3946
-
3947
- | Metric | Value |
3948
- |--------|-------|
3949
- | Tokens Saved | ${stats.totalTokensSaved.toLocaleString()} |
3950
- | Edits Optimized | ${stats.editsOptimized} |
3951
- | Cache Hit Rate | ${hitRate}% |
3952
- | Memories Retrieved | ${stats.memoriesRetrieved} |
3953
- | Est. Monthly Savings | $${savings} |
3945
+ output.writeln(`## Token Optimization Report
3946
+
3947
+ | Metric | Value |
3948
+ |--------|-------|
3949
+ | Tokens Saved | ${stats.totalTokensSaved.toLocaleString()} |
3950
+ | Edits Optimized | ${stats.editsOptimized} |
3951
+ | Cache Hit Rate | ${hitRate}% |
3952
+ | Memories Retrieved | ${stats.memoriesRetrieved} |
3953
+ | Est. Monthly Savings | $${savings} |
3954
3954
  | Agentic-Flow Active | ${agenticFlowAvailable ? '✓' : '✗'} |`);
3955
3955
  }
3956
3956
  return { success: true, data: { config, stats: { ...stats, agenticFlowAvailable } } };
@@ -8,6 +8,7 @@ import * as fs from 'fs';
8
8
  import * as path from 'path';
9
9
  import { executeInit, executeUpgrade, executeUpgradeWithMissing, DEFAULT_INIT_OPTIONS, MINIMAL_INIT_OPTIONS, FULL_INIT_OPTIONS, } from '../init/index.js';
10
10
  import { ENROLLMENT_SCREEN, recordEnrollmentOutcome, shouldOfferEnrollment, } from '../funnel/enrollment.js';
11
+ import { commandExists } from '../services/harness-hosts.js';
11
12
  /**
12
13
  * ADR-302 post-init capability enrollment. One-time, interactive-TTY-only,
13
14
  * skippable with --no-signup, auto-skipped in CI/automation. Never throws
@@ -42,6 +43,87 @@ async function offerCapabilityEnrollment(ctx) {
42
43
  // Enrollment is optional; init success is never affected.
43
44
  }
44
45
  }
46
+ async function resolveCodexInitializer(cwd) {
47
+ // Use a variable to prevent TypeScript from statically resolving the optional module
48
+ const codexModuleId = '@claude-flow/codex';
49
+ const resolutionStrategies = [
50
+ // Strategy 1: Direct import (works if installed as CLI dependency)
51
+ async () => (await import(codexModuleId)).CodexInitializer,
52
+ // Strategy 2: Project node_modules (works if installed in user's project)
53
+ async () => {
54
+ const projectPath = path.join(cwd, 'node_modules', '@claude-flow', 'codex', 'dist', 'index.js');
55
+ if (fs.existsSync(projectPath)) {
56
+ const mod = await import(`file://${projectPath}`);
57
+ return mod.CodexInitializer;
58
+ }
59
+ throw new Error('Not found in project');
60
+ },
61
+ // Strategy 3: Global node_modules
62
+ async () => {
63
+ const { execSync } = await import('child_process');
64
+ const globalPath = execSync('npm root -g', { encoding: 'utf-8' }).trim();
65
+ const codexPath = path.join(globalPath, '@claude-flow', 'codex', 'dist', 'index.js');
66
+ if (fs.existsSync(codexPath)) {
67
+ const mod = await import(`file://${codexPath}`);
68
+ return mod.CodexInitializer;
69
+ }
70
+ throw new Error('Not found globally');
71
+ },
72
+ ];
73
+ for (const strategy of resolutionStrategies) {
74
+ try {
75
+ const ctor = await strategy();
76
+ if (ctor)
77
+ return ctor;
78
+ }
79
+ catch {
80
+ // Try next strategy
81
+ }
82
+ }
83
+ return undefined;
84
+ }
85
+ // #2666-adjacent — quietly wire up Codex too when a plain `ruflo init` (no
86
+ // --codex/--dual) runs on a machine that also has the OpenAI Codex CLI on
87
+ // PATH: registers its MCP server and installs skills alongside the Claude
88
+ // Code setup that just happened. Best-effort and silent-by-default — must
89
+ // never fail or noisily interrupt a normal init. Opt out with
90
+ // --no-codex-detect. Skipped entirely under --skip-claude (runtime-only
91
+ // init) and scripted `--format json` output.
92
+ async function maybeAutoDetectCodex(ctx, options) {
93
+ try {
94
+ if (ctx.flags['no-codex-detect'] === true)
95
+ return;
96
+ if (ctx.flags.format === 'json')
97
+ return; // scripted output stays pure
98
+ if (!commandExists('codex'))
99
+ return;
100
+ const CodexInitializer = await resolveCodexInitializer(ctx.cwd);
101
+ if (!CodexInitializer) {
102
+ output.writeln();
103
+ output.printInfo('Detected the OpenAI Codex CLI — install @claude-flow/codex to auto-configure its MCP server and skills:');
104
+ output.writeln(output.dim(' npm install @claude-flow/codex && ruflo init --codex'));
105
+ return;
106
+ }
107
+ const initializer = new CodexInitializer();
108
+ const result = await initializer.initialize({
109
+ projectPath: ctx.cwd,
110
+ template: (options.minimal ? 'minimal' : options.full ? 'full' : 'default'),
111
+ force: options.force,
112
+ dual: false, // Claude Code files were already written by the main init flow above
113
+ });
114
+ if (!result.success)
115
+ return; // best-effort — never fail the primary init over this
116
+ output.writeln();
117
+ output.printBox([
118
+ `AGENTS.md: Codex project instructions`,
119
+ `.agents/config.toml: MCP server + skills config`,
120
+ `.agents/skills/: ${result.skillsGenerated.length} skills`,
121
+ ].join('\n'), 'OpenAI Codex detected — configured');
122
+ }
123
+ catch {
124
+ // Codex auto-detect is a bonus, never a requirement — swallow everything.
125
+ }
126
+ }
45
127
  // Codex initialization action
46
128
  async function initCodexAction(ctx, options) {
47
129
  const { force, minimal, full, dualMode } = options;
@@ -53,44 +135,7 @@ async function initCodexAction(ctx, options) {
53
135
  const spinner = output.createSpinner({ text: 'Initializing Codex project...' });
54
136
  spinner.start();
55
137
  try {
56
- let CodexInitializer;
57
- // Try multiple resolution strategies for the @claude-flow/codex package
58
- // Use a variable to prevent TypeScript from statically resolving the optional module
59
- const codexModuleId = '@claude-flow/codex';
60
- const resolutionStrategies = [
61
- // Strategy 1: Direct import (works if installed as CLI dependency)
62
- async () => (await import(codexModuleId)).CodexInitializer,
63
- // Strategy 2: Project node_modules (works if installed in user's project)
64
- async () => {
65
- const projectPath = path.join(ctx.cwd, 'node_modules', '@claude-flow', 'codex', 'dist', 'index.js');
66
- if (fs.existsSync(projectPath)) {
67
- const mod = await import(`file://${projectPath}`);
68
- return mod.CodexInitializer;
69
- }
70
- throw new Error('Not found in project');
71
- },
72
- // Strategy 3: Global node_modules
73
- async () => {
74
- const { execSync } = await import('child_process');
75
- const globalPath = execSync('npm root -g', { encoding: 'utf-8' }).trim();
76
- const codexPath = path.join(globalPath, '@claude-flow', 'codex', 'dist', 'index.js');
77
- if (fs.existsSync(codexPath)) {
78
- const mod = await import(`file://${codexPath}`);
79
- return mod.CodexInitializer;
80
- }
81
- throw new Error('Not found globally');
82
- },
83
- ];
84
- for (const strategy of resolutionStrategies) {
85
- try {
86
- CodexInitializer = await strategy();
87
- if (CodexInitializer)
88
- break;
89
- }
90
- catch {
91
- // Try next strategy
92
- }
93
- }
138
+ const CodexInitializer = await resolveCodexInitializer(ctx.cwd);
94
139
  if (!CodexInitializer) {
95
140
  throw new Error('Cannot find module @claude-flow/codex');
96
141
  }
@@ -357,6 +402,10 @@ const initAction = async (ctx) => {
357
402
  output.printInfo(`Hooks: ${result.summary.hooksEnabled} hook types enabled in settings.json`);
358
403
  output.writeln();
359
404
  }
405
+ // #2666-adjacent — auto-detect + configure OpenAI Codex CLI if present
406
+ if (!skipClaude) {
407
+ await maybeAutoDetectCodex(ctx, { force, minimal, full });
408
+ }
360
409
  // Handle --start-all or --start-daemon
361
410
  const startAll = ctx.flags['start-all'] || ctx.flags.startAll;
362
411
  const startDaemon = ctx.flags['start-daemon'] || ctx.flags.startDaemon || startAll;
@@ -1112,6 +1161,12 @@ export const initCommand = {
1112
1161
  type: 'boolean',
1113
1162
  default: false,
1114
1163
  },
1164
+ {
1165
+ name: 'no-codex-detect',
1166
+ description: 'Skip auto-detecting the OpenAI Codex CLI and configuring its MCP server + skills',
1167
+ type: 'boolean',
1168
+ default: false,
1169
+ },
1115
1170
  {
1116
1171
  name: 'all-agents',
1117
1172
  description: 'Install all agent categories (ADR-128: default is ~24 substrate agents; this restores the full set of ~89)',
@@ -1139,6 +1194,7 @@ export const initCommand = {
1139
1194
  { command: 'claude-flow init --codex', description: 'Initialize for OpenAI Codex (AGENTS.md)' },
1140
1195
  { command: 'claude-flow init --codex --full', description: 'Codex init with all 137+ skills' },
1141
1196
  { command: 'claude-flow init --dual', description: 'Initialize for both Claude Code and Codex' },
1197
+ { command: 'claude-flow init --no-codex-detect', description: 'Skip auto-configuring OpenAI Codex even if it is installed' },
1142
1198
  { command: 'claude-flow init --all-agents', description: 'Install all agent categories (~89 agents; ADR-128 opt-in)' },
1143
1199
  ],
1144
1200
  action: initAction,
@@ -646,6 +646,90 @@ const deleteCommand = {
646
646
  }
647
647
  }
648
648
  };
649
+ // #2666 — Hard, namespace-scoped purge. `delete` above only ever
650
+ // soft-deletes a single key (status='deleted', row stays and still occupies
651
+ // the UNIQUE(namespace, key) slot — #2652). Reconciling an entire namespace
652
+ // after its source-of-truth changed (e.g. a plugin's index after a source
653
+ // file was removed) needs the row to actually be gone, not tombstoned.
654
+ // Irreversible — always requires --namespace explicitly (no default) and
655
+ // either interactive confirmation or --force.
656
+ const purgeCommand = {
657
+ name: 'purge',
658
+ description: 'Permanently delete every entry in a namespace (hard delete — not the soft delete/tombstone that `memory delete` uses)',
659
+ options: [
660
+ {
661
+ name: 'namespace',
662
+ short: 'n',
663
+ description: 'Namespace to purge (required — no default, to avoid an accidental whole-namespace wipe)',
664
+ type: 'string'
665
+ },
666
+ {
667
+ name: 'dry-run',
668
+ short: 'd',
669
+ description: 'Report how many entries would be deleted, without deleting them',
670
+ type: 'boolean',
671
+ default: false
672
+ },
673
+ {
674
+ name: 'force',
675
+ short: 'f',
676
+ description: 'Skip confirmation',
677
+ type: 'boolean',
678
+ default: false
679
+ },
680
+ DB_PATH_OPTION
681
+ ],
682
+ examples: [
683
+ { command: 'claude-flow memory purge --namespace stale-cache --dry-run', description: 'Preview a purge' },
684
+ { command: 'claude-flow memory purge --namespace stale-cache --force', description: 'Purge without confirmation (e.g. in a script)' }
685
+ ],
686
+ action: async (ctx) => {
687
+ const namespace = ctx.flags.namespace;
688
+ const dryRun = ctx.flags.dryRun;
689
+ const force = ctx.flags.force;
690
+ const dbPath = ctx.flags.path;
691
+ if (!namespace) {
692
+ output.printError('Namespace is required. Use: memory purge -n "namespace" [--dry-run | --force]');
693
+ return { success: false, exitCode: 1 };
694
+ }
695
+ try {
696
+ const { listEntries, purgeNamespace, resolveDbPath: _rdbPurge } = await import('../memory/memory-initializer.js');
697
+ const resolvedDbPath = _rdbPurge(dbPath);
698
+ const preview = await listEntries({ namespace, limit: 1, dbPath: resolvedDbPath });
699
+ const previewCount = preview.total ?? preview.entries?.length ?? 0;
700
+ if (dryRun) {
701
+ output.printInfo(`Would permanently delete ${previewCount} entr${previewCount === 1 ? 'y' : 'ies'} from namespace "${namespace}" (dry run — nothing deleted)`);
702
+ return { success: true, data: { namespace, wouldDelete: previewCount } };
703
+ }
704
+ if (!force && ctx.interactive) {
705
+ const confirmed = await confirm({
706
+ message: `Permanently delete ${previewCount} entr${previewCount === 1 ? 'y' : 'ies'} from namespace "${namespace}"? This is a hard delete — not reversible with \`memory delete\`'s soft-undo.`,
707
+ default: false
708
+ });
709
+ if (!confirmed) {
710
+ output.printInfo('Operation cancelled');
711
+ return { success: true };
712
+ }
713
+ }
714
+ else if (!force) {
715
+ output.printError(`Refusing to purge namespace "${namespace}" without --force in non-interactive mode`);
716
+ return { success: false, exitCode: 1 };
717
+ }
718
+ const result = await purgeNamespace({ namespace, dbPath: resolvedDbPath });
719
+ if (!result.success) {
720
+ output.printError(result.error || 'Failed to purge');
721
+ return { success: false, exitCode: 1 };
722
+ }
723
+ output.printSuccess(`Purged ${result.deletedCount} entr${result.deletedCount === 1 ? 'y' : 'ies'} from namespace "${namespace}"`);
724
+ output.printInfo(`Remaining entries (all namespaces): ${result.remainingEntries}`);
725
+ return { success: true, data: result };
726
+ }
727
+ catch (error) {
728
+ output.printError(`Failed to purge: ${error instanceof Error ? error.message : 'Unknown error'}`);
729
+ return { success: false, exitCode: 1 };
730
+ }
731
+ }
732
+ };
649
733
  // Stats command
650
734
  const statsCommand = {
651
735
  name: 'stats',
@@ -1476,7 +1560,7 @@ const initMemoryCommand = {
1476
1560
  export const memoryCommand = {
1477
1561
  name: 'memory',
1478
1562
  description: 'Memory management commands',
1479
- subcommands: [initMemoryCommand, storeCommand, retrieveCommand, searchCommand, listCommand, deleteCommand, statsCommand, configureCommand, cleanupCommand, compressCommand, exportCommand, importCommand, distillCommand, backupCommand],
1563
+ subcommands: [initMemoryCommand, storeCommand, retrieveCommand, searchCommand, listCommand, deleteCommand, purgeCommand, statsCommand, configureCommand, cleanupCommand, compressCommand, exportCommand, importCommand, distillCommand, backupCommand],
1480
1564
  options: [],
1481
1565
  examples: [
1482
1566
  { command: 'claude-flow memory store -k "key" -v "value"', description: 'Store data' },
@@ -182,10 +182,10 @@ const backupSubcommand = {
182
182
  tables = tablesFilter.split(',').map(t => t.trim());
183
183
  }
184
184
  else {
185
- const tablesResult = await client.query(`
186
- SELECT table_name FROM information_schema.tables
187
- WHERE table_schema = $1 AND table_type = 'BASE TABLE'
188
- ORDER BY table_name
185
+ const tablesResult = await client.query(`
186
+ SELECT table_name FROM information_schema.tables
187
+ WHERE table_schema = $1 AND table_type = 'BASE TABLE'
188
+ ORDER BY table_name
189
189
  `, [config.schema]);
190
190
  tables = tablesResult.rows.map(r => r.table_name);
191
191
  }
@@ -209,16 +209,16 @@ const backupSubcommand = {
209
209
  spinner.setText(`Exporting ${tableName}...`);
210
210
  spinner.start();
211
211
  // Get columns
212
- const columnsResult = await client.query(`
213
- SELECT column_name, data_type
214
- FROM information_schema.columns
215
- WHERE table_schema = $1 AND table_name = $2
216
- ORDER BY ordinal_position
212
+ const columnsResult = await client.query(`
213
+ SELECT column_name, data_type
214
+ FROM information_schema.columns
215
+ WHERE table_schema = $1 AND table_name = $2
216
+ ORDER BY ordinal_position
217
217
  `, [config.schema, tableName]);
218
218
  const columns = columnsResult.rows.map(r => r.column_name);
219
219
  // Get data
220
- const dataResult = await client.query(`
221
- SELECT * FROM ${config.schema}.${tableName}
220
+ const dataResult = await client.query(`
221
+ SELECT * FROM ${config.schema}.${tableName}
222
222
  `);
223
223
  backupData.tables.push({
224
224
  name: tableName,
@@ -233,14 +233,14 @@ const backupSubcommand = {
233
233
  if (includeIndexes) {
234
234
  spinner.setText('Exporting index definitions...');
235
235
  spinner.start();
236
- const indexResult = await client.query(`
237
- SELECT pg_get_indexdef(i.oid) as indexdef
238
- FROM pg_index idx
239
- JOIN pg_class i ON i.oid = idx.indexrelid
240
- JOIN pg_class t ON t.oid = idx.indrelid
241
- JOIN pg_namespace n ON n.oid = t.relnamespace
242
- WHERE n.nspname = $1
243
- AND NOT idx.indisprimary
236
+ const indexResult = await client.query(`
237
+ SELECT pg_get_indexdef(i.oid) as indexdef
238
+ FROM pg_index idx
239
+ JOIN pg_class i ON i.oid = idx.indexrelid
240
+ JOIN pg_class t ON t.oid = idx.indrelid
241
+ JOIN pg_namespace n ON n.oid = t.relnamespace
242
+ WHERE n.nspname = $1
243
+ AND NOT idx.indisprimary
244
244
  `, [config.schema]);
245
245
  backupData.indexes = indexResult.rows.map(r => r.indexdef);
246
246
  spinner.succeed(`Exported ${backupData.indexes.length} index definitions`);
@@ -566,10 +566,10 @@ const restoreSubcommand = {
566
566
  return typeof val === 'object' ? JSON.stringify(val) : val;
567
567
  });
568
568
  try {
569
- await client.query(`
570
- INSERT INTO ${config.schema}.${table.name} (${columns.join(', ')})
571
- VALUES (${values.join(', ')})
572
- ON CONFLICT DO NOTHING
569
+ await client.query(`
570
+ INSERT INTO ${config.schema}.${table.name} (${columns.join(', ')})
571
+ VALUES (${values.join(', ')})
572
+ ON CONFLICT DO NOTHING
573
573
  `, params);
574
574
  restoredRows++;
575
575
  }