@claude-flow/cli 3.10.36 → 3.10.38

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 (511) 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/helpers/README.md +96 -96
  259. package/.claude/helpers/adr-compliance.sh +186 -186
  260. package/.claude/helpers/auto-commit.sh +178 -178
  261. package/.claude/helpers/auto-memory-hook.mjs +368 -368
  262. package/.claude/helpers/checkpoint-manager.sh +251 -251
  263. package/.claude/helpers/daemon-manager.sh +252 -252
  264. package/.claude/helpers/ddd-tracker.sh +144 -144
  265. package/.claude/helpers/github-safe.js +156 -156
  266. package/.claude/helpers/github-setup.sh +45 -45
  267. package/.claude/helpers/guidance-hook.sh +13 -13
  268. package/.claude/helpers/guidance-hooks.sh +102 -102
  269. package/.claude/helpers/health-monitor.sh +108 -108
  270. package/.claude/helpers/hook-handler.cjs +286 -286
  271. package/.claude/helpers/intelligence.cjs +1031 -1031
  272. package/.claude/helpers/learning-hooks.sh +329 -329
  273. package/.claude/helpers/learning-optimizer.sh +127 -127
  274. package/.claude/helpers/learning-service.mjs +1144 -1144
  275. package/.claude/helpers/memory.js +83 -83
  276. package/.claude/helpers/metrics-db.mjs +488 -488
  277. package/.claude/helpers/pattern-consolidator.sh +86 -86
  278. package/.claude/helpers/perf-worker.sh +160 -160
  279. package/.claude/helpers/post-commit +16 -16
  280. package/.claude/helpers/pre-commit +26 -26
  281. package/.claude/helpers/quick-start.sh +19 -19
  282. package/.claude/helpers/router.js +105 -105
  283. package/.claude/helpers/security-scanner.sh +127 -127
  284. package/.claude/helpers/session.js +135 -135
  285. package/.claude/helpers/setup-mcp.sh +18 -18
  286. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  287. package/.claude/helpers/statusline-hook.sh +21 -21
  288. package/.claude/helpers/statusline.cjs +604 -604
  289. package/.claude/helpers/statusline.js +352 -352
  290. package/.claude/helpers/swarm-comms.sh +353 -353
  291. package/.claude/helpers/swarm-hooks.sh +761 -761
  292. package/.claude/helpers/swarm-monitor.sh +210 -210
  293. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  294. package/.claude/helpers/update-v3-progress.sh +165 -165
  295. package/.claude/helpers/v3-quick-status.sh +57 -57
  296. package/.claude/helpers/v3.sh +110 -110
  297. package/.claude/helpers/validate-v3-config.sh +215 -215
  298. package/.claude/helpers/worker-manager.sh +170 -170
  299. package/.claude/settings.json +182 -182
  300. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  301. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  302. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  303. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  304. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  305. package/.claude/skills/browser/SKILL.md +204 -204
  306. package/.claude/skills/dual-mode/README.md +71 -71
  307. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  308. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  309. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  310. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  311. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  312. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  313. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  314. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  315. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  316. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  317. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  318. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  319. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  320. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  321. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  322. package/.claude/skills/skill-builder/SKILL.md +910 -910
  323. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  324. package/.claude/skills/stream-chain/SKILL.md +560 -560
  325. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  326. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  327. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  328. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  329. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  330. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  331. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  332. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  333. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  334. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  335. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  336. package/.claude/skills/verification-quality/SKILL.md +691 -691
  337. package/README.md +416 -416
  338. package/bin/cli.js +314 -314
  339. package/bin/mcp-server.js +224 -224
  340. package/bin/preinstall.cjs +2 -2
  341. package/dist/src/benchmarks/gaia-critic.js +24 -24
  342. package/dist/src/commands/completions.js +409 -409
  343. package/dist/src/commands/daemon.js +44 -44
  344. package/dist/src/commands/embeddings.js +29 -29
  345. package/dist/src/commands/embeddings.js.map +1 -1
  346. package/dist/src/commands/hive-mind.js +97 -97
  347. package/dist/src/commands/hooks.js +9 -9
  348. package/dist/src/commands/ruvector/backup.js +23 -23
  349. package/dist/src/commands/ruvector/benchmark.js +31 -31
  350. package/dist/src/commands/ruvector/import.js +14 -14
  351. package/dist/src/commands/ruvector/init.js +115 -115
  352. package/dist/src/commands/ruvector/migrate.js +99 -99
  353. package/dist/src/commands/ruvector/optimize.js +51 -51
  354. package/dist/src/commands/ruvector/setup.js +624 -624
  355. package/dist/src/commands/ruvector/status.js +38 -38
  356. package/dist/src/init/claudemd-generator.js +227 -227
  357. package/dist/src/init/executor.js +453 -453
  358. package/dist/src/init/helpers-generator.js +727 -727
  359. package/dist/src/init/statusline-generator.js +570 -570
  360. package/dist/src/mcp-tools/agentdb-tools.js +15 -15
  361. package/dist/src/memory/graph-edge-writer.js +18 -18
  362. package/dist/src/memory/memory-bridge.js +84 -84
  363. package/dist/src/memory/memory-initializer.js +393 -393
  364. package/dist/src/memory/rabitq-index.js +5 -5
  365. package/dist/src/runtime/headless.js +28 -28
  366. package/dist/src/ruvector/flash-attention.d.ts +195 -0
  367. package/dist/src/ruvector/flash-attention.d.ts.map +1 -0
  368. package/dist/src/ruvector/flash-attention.js +643 -0
  369. package/dist/src/ruvector/flash-attention.js.map +1 -0
  370. package/dist/src/ruvector/moe-router.d.ts +206 -0
  371. package/dist/src/ruvector/moe-router.d.ts.map +1 -0
  372. package/dist/src/ruvector/moe-router.js +626 -0
  373. package/dist/src/ruvector/moe-router.js.map +1 -0
  374. package/dist/src/services/event-stream.d.ts +25 -0
  375. package/dist/src/services/event-stream.js +27 -0
  376. package/dist/src/services/headless-worker-executor.js +84 -84
  377. package/dist/src/services/loop-worker-runner.d.ts +16 -0
  378. package/dist/src/services/loop-worker-runner.js +34 -0
  379. package/dist/src/services/runtime-capabilities.d.ts +22 -0
  380. package/dist/src/services/runtime-capabilities.js +45 -0
  381. package/dist/src/transfer/deploy-seraphine.js +23 -23
  382. package/dist/tsconfig.tsbuildinfo +1 -1
  383. package/package.json +134 -134
  384. package/scripts/beir-bootstrap-significance.mjs +162 -162
  385. package/scripts/bench-rvagent.mjs +312 -312
  386. package/scripts/benchmark-codemods.mjs +127 -127
  387. package/scripts/benchmark-cross-repo.mjs +206 -206
  388. package/scripts/benchmark-pretrained-retrieval.mjs +305 -305
  389. package/scripts/benchmark-self-learning.mjs +241 -241
  390. package/scripts/benchmark-trajectory-mrr.mjs +191 -191
  391. package/scripts/deploy-ipfs-node.sh +153 -153
  392. package/scripts/grid-search-retrieval.mjs +216 -216
  393. package/scripts/postinstall.cjs +153 -153
  394. package/scripts/pretrain-from-github.mjs +358 -358
  395. package/scripts/publish-registry.ts +345 -345
  396. package/scripts/publish.sh +57 -57
  397. package/scripts/run-beir-bge.mjs +324 -336
  398. package/scripts/run-beir-hybrid.mjs +261 -263
  399. package/scripts/run-beir-lucene-bm25.mjs +154 -154
  400. package/scripts/run-beir-nfcorpus.mjs +231 -231
  401. package/scripts/run-beir-rrf-ablation.mjs +221 -221
  402. package/scripts/setup-ipfs-registry.md +366 -366
  403. package/dist/src/benchmarks/capability-tasks.d.ts +0 -126
  404. package/dist/src/benchmarks/capability-tasks.d.ts.map +0 -1
  405. package/dist/src/benchmarks/capability-tasks.js +0 -147
  406. package/dist/src/benchmarks/capability-tasks.js.map +0 -1
  407. package/dist/src/benchmarks/gaia-agent-contrastive.d.ts +0 -53
  408. package/dist/src/benchmarks/gaia-agent-contrastive.d.ts.map +0 -1
  409. package/dist/src/benchmarks/gaia-agent-contrastive.js +0 -177
  410. package/dist/src/benchmarks/gaia-agent-contrastive.js.map +0 -1
  411. package/dist/src/benchmarks/gaia-agent-gemini.d.ts +0 -51
  412. package/dist/src/benchmarks/gaia-agent-gemini.d.ts.map +0 -1
  413. package/dist/src/benchmarks/gaia-agent-gemini.js +0 -352
  414. package/dist/src/benchmarks/gaia-agent-gemini.js.map +0 -1
  415. package/dist/src/benchmarks/gaia-claude-p.d.ts +0 -105
  416. package/dist/src/benchmarks/gaia-claude-p.d.ts.map +0 -1
  417. package/dist/src/benchmarks/gaia-claude-p.js +0 -269
  418. package/dist/src/benchmarks/gaia-claude-p.js.map +0 -1
  419. package/dist/src/benchmarks/gaia-claude-p.smoke.d.ts +0 -20
  420. package/dist/src/benchmarks/gaia-claude-p.smoke.d.ts.map +0 -1
  421. package/dist/src/benchmarks/gaia-claude-p.smoke.js +0 -168
  422. package/dist/src/benchmarks/gaia-claude-p.smoke.js.map +0 -1
  423. package/dist/src/benchmarks/gaia-codeagent-runner.py +0 -556
  424. package/dist/src/benchmarks/gaia-codeagent.d.ts +0 -129
  425. package/dist/src/benchmarks/gaia-codeagent.d.ts.map +0 -1
  426. package/dist/src/benchmarks/gaia-codeagent.js +0 -590
  427. package/dist/src/benchmarks/gaia-codeagent.js.map +0 -1
  428. package/dist/src/benchmarks/gaia-codeagent.smoke.d.ts +0 -33
  429. package/dist/src/benchmarks/gaia-codeagent.smoke.d.ts.map +0 -1
  430. package/dist/src/benchmarks/gaia-codeagent.smoke.js +0 -241
  431. package/dist/src/benchmarks/gaia-codeagent.smoke.js.map +0 -1
  432. package/dist/src/benchmarks/gaia-dag-pilot.d.ts +0 -22
  433. package/dist/src/benchmarks/gaia-dag-pilot.d.ts.map +0 -1
  434. package/dist/src/benchmarks/gaia-dag-pilot.js +0 -158
  435. package/dist/src/benchmarks/gaia-dag-pilot.js.map +0 -1
  436. package/dist/src/benchmarks/gaia-dag.d.ts +0 -110
  437. package/dist/src/benchmarks/gaia-dag.d.ts.map +0 -1
  438. package/dist/src/benchmarks/gaia-dag.js +0 -658
  439. package/dist/src/benchmarks/gaia-dag.js.map +0 -1
  440. package/dist/src/benchmarks/gaia-dag.smoke.d.ts +0 -21
  441. package/dist/src/benchmarks/gaia-dag.smoke.d.ts.map +0 -1
  442. package/dist/src/benchmarks/gaia-dag.smoke.js +0 -290
  443. package/dist/src/benchmarks/gaia-dag.smoke.js.map +0 -1
  444. package/dist/src/benchmarks/gaia-ensemble-pilot.d.ts +0 -17
  445. package/dist/src/benchmarks/gaia-ensemble-pilot.d.ts.map +0 -1
  446. package/dist/src/benchmarks/gaia-ensemble-pilot.js +0 -106
  447. package/dist/src/benchmarks/gaia-ensemble-pilot.js.map +0 -1
  448. package/dist/src/benchmarks/gaia-ensemble.d.ts +0 -103
  449. package/dist/src/benchmarks/gaia-ensemble.d.ts.map +0 -1
  450. package/dist/src/benchmarks/gaia-ensemble.js +0 -462
  451. package/dist/src/benchmarks/gaia-ensemble.js.map +0 -1
  452. package/dist/src/benchmarks/gaia-gemini-pilot.d.ts +0 -17
  453. package/dist/src/benchmarks/gaia-gemini-pilot.d.ts.map +0 -1
  454. package/dist/src/benchmarks/gaia-gemini-pilot.js +0 -168
  455. package/dist/src/benchmarks/gaia-gemini-pilot.js.map +0 -1
  456. package/dist/src/benchmarks/gaia-mode-router.d.ts +0 -67
  457. package/dist/src/benchmarks/gaia-mode-router.d.ts.map +0 -1
  458. package/dist/src/benchmarks/gaia-mode-router.js +0 -126
  459. package/dist/src/benchmarks/gaia-mode-router.js.map +0 -1
  460. package/dist/src/benchmarks/gaia-mode-router.smoke.d.ts +0 -15
  461. package/dist/src/benchmarks/gaia-mode-router.smoke.d.ts.map +0 -1
  462. package/dist/src/benchmarks/gaia-mode-router.smoke.js +0 -131
  463. package/dist/src/benchmarks/gaia-mode-router.smoke.js.map +0 -1
  464. package/dist/src/benchmarks/gaia-tools/grounded_query.smoke.d.ts +0 -24
  465. package/dist/src/benchmarks/gaia-tools/grounded_query.smoke.d.ts.map +0 -1
  466. package/dist/src/benchmarks/gaia-tools/grounded_query.smoke.js +0 -276
  467. package/dist/src/benchmarks/gaia-tools/grounded_query.smoke.js.map +0 -1
  468. package/dist/src/benchmarks/gaia-tools/image_describe.d.ts +0 -45
  469. package/dist/src/benchmarks/gaia-tools/image_describe.d.ts.map +0 -1
  470. package/dist/src/benchmarks/gaia-tools/image_describe.js +0 -222
  471. package/dist/src/benchmarks/gaia-tools/image_describe.js.map +0 -1
  472. package/dist/src/benchmarks/gaia-tools/image_describe.smoke.d.ts +0 -24
  473. package/dist/src/benchmarks/gaia-tools/image_describe.smoke.d.ts.map +0 -1
  474. package/dist/src/benchmarks/gaia-tools/image_describe.smoke.js +0 -169
  475. package/dist/src/benchmarks/gaia-tools/image_describe.smoke.js.map +0 -1
  476. package/dist/src/benchmarks/gaia-tools/pdf_read.d.ts +0 -27
  477. package/dist/src/benchmarks/gaia-tools/pdf_read.d.ts.map +0 -1
  478. package/dist/src/benchmarks/gaia-tools/pdf_read.js +0 -226
  479. package/dist/src/benchmarks/gaia-tools/pdf_read.js.map +0 -1
  480. package/dist/src/benchmarks/gaia-tools/python_exec.d.ts +0 -31
  481. package/dist/src/benchmarks/gaia-tools/python_exec.d.ts.map +0 -1
  482. package/dist/src/benchmarks/gaia-tools/python_exec.js +0 -94
  483. package/dist/src/benchmarks/gaia-tools/python_exec.js.map +0 -1
  484. package/dist/src/benchmarks/gaia-tools/python_exec.smoke.d.ts +0 -13
  485. package/dist/src/benchmarks/gaia-tools/python_exec.smoke.d.ts.map +0 -1
  486. package/dist/src/benchmarks/gaia-tools/python_exec.smoke.js +0 -98
  487. package/dist/src/benchmarks/gaia-tools/python_exec.smoke.js.map +0 -1
  488. package/dist/src/benchmarks/gaia-tools/visit_webpage.d.ts +0 -52
  489. package/dist/src/benchmarks/gaia-tools/visit_webpage.d.ts.map +0 -1
  490. package/dist/src/benchmarks/gaia-tools/visit_webpage.js +0 -304
  491. package/dist/src/benchmarks/gaia-tools/visit_webpage.js.map +0 -1
  492. package/dist/src/benchmarks/gaia-tools/web_browse.d.ts +0 -61
  493. package/dist/src/benchmarks/gaia-tools/web_browse.d.ts.map +0 -1
  494. package/dist/src/benchmarks/gaia-tools/web_browse.js +0 -217
  495. package/dist/src/benchmarks/gaia-tools/web_browse.js.map +0 -1
  496. package/dist/src/benchmarks/gaia-tools/web_browse.smoke.d.ts +0 -26
  497. package/dist/src/benchmarks/gaia-tools/web_browse.smoke.d.ts.map +0 -1
  498. package/dist/src/benchmarks/gaia-tools/web_browse.smoke.js +0 -152
  499. package/dist/src/benchmarks/gaia-tools/web_browse.smoke.js.map +0 -1
  500. package/dist/src/benchmarks/gaia-tools/web_search.smoke.d.ts +0 -24
  501. package/dist/src/benchmarks/gaia-tools/web_search.smoke.d.ts.map +0 -1
  502. package/dist/src/benchmarks/gaia-tools/web_search.smoke.js +0 -311
  503. package/dist/src/benchmarks/gaia-tools/web_search.smoke.js.map +0 -1
  504. package/dist/src/benchmarks/gaia-visit-webpage.smoke.d.ts +0 -25
  505. package/dist/src/benchmarks/gaia-visit-webpage.smoke.d.ts.map +0 -1
  506. package/dist/src/benchmarks/gaia-visit-webpage.smoke.js +0 -304
  507. package/dist/src/benchmarks/gaia-visit-webpage.smoke.js.map +0 -1
  508. package/dist/src/commands/performance-capability.d.ts +0 -30
  509. package/dist/src/commands/performance-capability.d.ts.map +0 -1
  510. package/dist/src/commands/performance-capability.js +0 -349
  511. package/dist/src/commands/performance-capability.js.map +0 -1
@@ -1,358 +1,358 @@
1
- #!/usr/bin/env node
2
- // pretrain-from-github.mjs — pretrain ruflo's self-learning system from its
3
- // own GitHub history (commits + issues). Each commit/issue becomes one
4
- // trajectory through the SONA + EWC++ pipeline; Structured Distillation
5
- // (ADR-076) compresses each into the 4-field schema before embedding.
6
- //
7
- // What this proves:
8
- // - globalStats.{trajectoriesRecorded, patternsLearned, signalsProcessed}
9
- // all move from a measured before to a measured after.
10
- // - neural_patterns.patternCount grows.
11
- // - memory-bridge entries grow.
12
- // - The unified-stats aggregator's consistency block stays clean.
13
- // - Every item gets a learningPath of 'trajectory-pipeline' (not 'recorded-only').
14
- //
15
- // Usage:
16
- // node scripts/pretrain-from-github.mjs # 50 commits + 30 issues
17
- // COMMITS=200 ISSUES=100 node scripts/pretrain-from-github.mjs
18
- // SOURCE=git node scripts/pretrain-from-github.mjs # git only, skip gh
19
- // BENCH_JSON=1 node scripts/pretrain-from-github.mjs # machine-readable
20
- // BENCH_NO_WRITE=1 node scripts/pretrain-from-github.mjs # don't write a run JSON
21
- //
22
- // Repro from a fresh checkout:
23
- // git clone https://github.com/ruvnet/ruflo && cd ruflo
24
- // npm install && ( cd v3/@claude-flow/cli && npx tsc -b )
25
- // node v3/@claude-flow/cli/scripts/pretrain-from-github.mjs
26
-
27
- import { execSync } from 'node:child_process';
28
- import { writeFileSync, mkdirSync } from 'node:fs';
29
- import { fileURLToPath } from 'node:url';
30
- import { dirname, join, resolve } from 'node:path';
31
- import { performance } from 'node:perf_hooks';
32
-
33
- const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
34
- const CLI_ROOT = resolve(SCRIPT_DIR, '..');
35
- const RUFLO_ROOT = resolve(SCRIPT_DIR, '../../../..');
36
- const RUNS_DIR = join(RUFLO_ROOT, 'docs', 'benchmarks', 'runs');
37
-
38
- // ADR-084 cross-repo support — REPO_ROOT and GH_REPO env-overridable so the
39
- // same script can pretrain on agentdb / agentic-flow / any other repo for
40
- // generalisation testing. Defaults preserve ruflo behaviour.
41
- const REPO_ROOT = process.env.REPO_ROOT ? resolve(process.env.REPO_ROOT) : RUFLO_ROOT;
42
- const GH_REPO = process.env.GH_REPO || 'ruvnet/ruflo';
43
-
44
- const COMMITS = Number(process.env.COMMITS) || 50;
45
- const ISSUES = Number(process.env.ISSUES) || 30;
46
- const SOURCE = process.env.SOURCE || 'all'; // 'all' | 'git' | 'issues'
47
-
48
- // ---------------------------------------------------------------------------
49
- // Harvesters
50
- // ---------------------------------------------------------------------------
51
-
52
- // ADR-078 outcome signal — classify each commit by whether it was reverted,
53
- // hotfix-followed, or stuck. Operates on the harvested-commits window plus a
54
- // wider lookahead window for revert/hotfix detection.
55
- //
56
- // Verdicts emitted:
57
- // success — landed cleanly, no later commit reverted or fixed it
58
- // reverted — a later commit subject starts with `Revert "<this subject>"`
59
- // hotfixed — a later commit (within HOTFIX_WINDOW_COMMITS) shares >=50%
60
- // of the same touched files AND subject contains fix|hotfix|patch
61
- //
62
- // The "later" direction is git-log order (newest first → we look at older
63
- // indices in the lookahead, which are NEWER commits chronologically).
64
- const HOTFIX_WINDOW_COMMITS = Number(process.env.HOTFIX_WINDOW_COMMITS) || 20;
65
- const HOTFIX_FILE_OVERLAP = Number(process.env.HOTFIX_FILE_OVERLAP) || 0.5;
66
- const HOTFIX_KEYWORDS = /\b(fix|hotfix|patch|revert|bugfix|fixup)\b/i;
67
-
68
- function harvestCommits(n) {
69
- if (SOURCE === 'issues') return [];
70
- const fmt = '%H%x00%s%x00%b%x01';
71
- // Pull a wider window so we have lookahead for revert/hotfix detection
72
- // without changing the trained set size n.
73
- const lookahead = HOTFIX_WINDOW_COMMITS;
74
- const raw = execSync(
75
- `git log --pretty=format:'${fmt}' -n ${n + lookahead} 2>/dev/null`,
76
- { cwd: REPO_ROOT, encoding: 'utf-8', maxBuffer: 64 * 1024 * 1024 },
77
- );
78
-
79
- // Parse all blocks (window + lookahead).
80
- const all = [];
81
- for (const block of raw.split('\x01')) {
82
- if (!block.trim()) continue;
83
- const [sha, subject, body] = block.split('\x00');
84
- if (!sha || !subject) continue;
85
- all.push({ sha, subject: subject.trim(), body: (body || '').trim() });
86
- }
87
-
88
- // For each commit in the trained slice, get its touched files.
89
- const filesCache = new Map();
90
- const filesOf = (sha) => {
91
- if (filesCache.has(sha)) return filesCache.get(sha);
92
- try {
93
- const out = execSync(
94
- `git show --pretty=format: --name-only ${sha} 2>/dev/null`,
95
- { cwd: REPO_ROOT, encoding: 'utf-8', maxBuffer: 8 * 1024 * 1024 },
96
- ).trim().split('\n').filter(Boolean);
97
- filesCache.set(sha, new Set(out));
98
- return filesCache.get(sha);
99
- } catch {
100
- filesCache.set(sha, new Set());
101
- return filesCache.get(sha);
102
- }
103
- };
104
-
105
- // Build a revert-target map: any commit whose subject starts with
106
- // `Revert "<X>"` flags X as reverted.
107
- const revertedSubjects = new Set();
108
- for (const c of all) {
109
- const m = c.subject.match(/^Revert\s+"(.+?)"/);
110
- if (m) revertedSubjects.add(m[1].trim());
111
- }
112
-
113
- const trained = all.slice(0, n);
114
- const entries = [];
115
- for (let i = 0; i < trained.length; i++) {
116
- const c = trained[i];
117
- const myFiles = filesOf(c.sha);
118
-
119
- let verdict = 'success';
120
- let outcomeNote = null;
121
-
122
- // Reverted? Check if any later (lower-index = newer) commit reverted us.
123
- if (revertedSubjects.has(c.subject)) {
124
- verdict = 'reverted';
125
- outcomeNote = 'subject reverted by a later commit';
126
- } else {
127
- // Hotfixed? A later commit within HOTFIX_WINDOW_COMMITS shares files
128
- // AND has fix/hotfix in its subject.
129
- const start = Math.max(0, i - HOTFIX_WINDOW_COMMITS);
130
- for (let j = start; j < i; j++) {
131
- const later = trained[j];
132
- if (!HOTFIX_KEYWORDS.test(later.subject)) continue;
133
- const laterFiles = filesOf(later.sha);
134
- if (laterFiles.size === 0 || myFiles.size === 0) continue;
135
- let overlap = 0;
136
- for (const f of laterFiles) if (myFiles.has(f)) overlap++;
137
- // Use min() so a small targeted fix on a big change still triggers
138
- // (semantic: "≥half of the smaller commit's files overlap").
139
- const overlapFrac = overlap / Math.min(laterFiles.size, myFiles.size);
140
- if (overlapFrac >= HOTFIX_FILE_OVERLAP) {
141
- verdict = 'hotfixed';
142
- outcomeNote = `${(overlapFrac * 100).toFixed(0)}% file overlap with later fix ${later.sha.slice(0, 8)}`;
143
- break;
144
- }
145
- }
146
- }
147
-
148
- entries.push({
149
- source: 'commit',
150
- id: `commit-${c.sha.slice(0, 12)}`,
151
- subject: c.subject,
152
- body: c.body,
153
- verdict,
154
- outcomeNote,
155
- content: `${c.subject}\n\n${c.body}`.slice(0, 8192),
156
- });
157
- }
158
- return entries;
159
- }
160
-
161
- function harvestIssues(n) {
162
- if (SOURCE === 'git') return [];
163
- try {
164
- const raw = execSync(
165
- `gh issue list --repo ${GH_REPO} --state all --limit ${n} --json number,title,body,state,closedAt 2>/dev/null`,
166
- { cwd: REPO_ROOT, encoding: 'utf-8', maxBuffer: 64 * 1024 * 1024 },
167
- );
168
- const items = JSON.parse(raw);
169
- return items.map((i) => ({
170
- source: 'issue',
171
- id: `issue-${i.number}`,
172
- subject: i.title,
173
- body: (i.body || '').slice(0, 8192),
174
- // closed = success outcome; open = partial (in-progress).
175
- verdict: i.state === 'CLOSED' ? 'success' : 'partial',
176
- content: `${i.title}\n\n${(i.body || '').slice(0, 8192)}`,
177
- }));
178
- } catch (err) {
179
- console.error(`gh issue harvest skipped (${err.message?.slice(0, 60)}). Set SOURCE=git to silence.`);
180
- return [];
181
- }
182
- }
183
-
184
- // ---------------------------------------------------------------------------
185
- // Main
186
- // ---------------------------------------------------------------------------
187
-
188
- async function main() {
189
- const intel = await import(join(CLI_ROOT, 'dist/src/memory/intelligence.js'));
190
- const neural = await import(join(CLI_ROOT, 'dist/src/mcp-tools/neural-tools.js'));
191
- const { distillAndSerialise } = await import(join(CLI_ROOT, 'dist/src/memory/structured-distill.js'));
192
-
193
- // §1 — record the baseline (no clear; we want to learn ON TOP of whatever
194
- // history the user already has).
195
- const unified0 = await intel.getUnifiedLearningStats();
196
- const before = {
197
- trajectoriesRecorded: unified0.global.trajectoriesRecorded,
198
- patternsLearned: unified0.global.patternsLearned,
199
- signalsProcessed: unified0.global.signalsProcessed,
200
- neuralPatternCount: unified0.neuralPatterns.patternCount,
201
- memoryBridgeTotal: unified0.memoryBridge.totalEntries,
202
- };
203
-
204
- // §2 — harvest
205
- const tHarvest0 = performance.now();
206
- const commits = harvestCommits(COMMITS);
207
- const issues = harvestIssues(ISSUES);
208
- const items = [...commits, ...issues];
209
- const harvestMs = performance.now() - tHarvest0;
210
-
211
- if (!process.env.BENCH_JSON) {
212
- console.log(`# Pretrain from ruflo GitHub history`);
213
- console.log(`Harvested: ${commits.length} commits + ${issues.length} issues = ${items.length} trajectories (${harvestMs.toFixed(0)} ms)`);
214
- }
215
-
216
- // §3 — feed each item through the trajectory pipeline. The harvester
217
- // emits one of: success | partial | reverted | hotfixed. We map this to
218
- // the trajectory pipeline's binary verdict {success, partial} since the
219
- // pipeline doesn't accept arbitrary strings — but we preserve the original
220
- // outcome in metadata + the summary's verdictMix so the signal isn't lost.
221
- const verdictToPipeline = (v) => {
222
- if (v === 'success') return 'success';
223
- if (v === 'partial') return 'partial';
224
- if (v === 'reverted') return 'partial'; // a revert is the strongest "this was wrong" signal we have
225
- if (v === 'hotfixed') return 'partial'; // a same-files fix-followup is "needs adjustment"
226
- return 'success';
227
- };
228
- const verdictMix = { success: 0, partial: 0, reverted: 0, hotfixed: 0 };
229
- const tFeed0 = performance.now();
230
- let trained = 0;
231
- let failed = 0;
232
- const failures = [];
233
- for (const item of items) {
234
- try {
235
- const distilled = distillAndSerialise(item.content);
236
- verdictMix[item.verdict] = (verdictMix[item.verdict] ?? 0) + 1;
237
- await intel.recordTrajectory(
238
- [{
239
- type: 'result',
240
- content: distilled,
241
- metadata: {
242
- source: item.source,
243
- id: item.id,
244
- subject: item.subject.slice(0, 200),
245
- outcomeVerdict: item.verdict,
246
- outcomeNote: item.outcomeNote ?? null,
247
- },
248
- timestamp: Date.now(),
249
- }],
250
- verdictToPipeline(item.verdict),
251
- );
252
- trained++;
253
- } catch (err) {
254
- failed++;
255
- if (failures.length < 5) failures.push({ id: item.id, error: String(err.message).slice(0, 120) });
256
- }
257
- }
258
- const feedMs = performance.now() - tFeed0;
259
- intel.flushIntelligenceStats();
260
-
261
- // §4 — also seed the neural store directly from the same items so
262
- // `neural_patterns list` reflects them (closes the "globalStats moved but
263
- // neural_patterns didn't" consistency note from ADR-075).
264
- const tSeed0 = performance.now();
265
- const neuralItems = items.map((item) => ({
266
- name: item.subject.slice(0, 200),
267
- type: item.source === 'commit' ? 'history-commit' : 'history-issue',
268
- content: distillAndSerialise(item.content),
269
- metadata: { source: item.source, id: item.id, verdict: item.verdict },
270
- }));
271
- const seedResult = await neural.storeNeuralPatterns(neuralItems);
272
- const seedMs = performance.now() - tSeed0;
273
-
274
- // §5 — read the after-counters via the unified aggregator (this is what
275
- // hooks_intelligence_unified-stats would return for a live caller).
276
- const unified1 = await intel.getUnifiedLearningStats();
277
- const after = {
278
- trajectoriesRecorded: unified1.global.trajectoriesRecorded,
279
- patternsLearned: unified1.global.patternsLearned,
280
- signalsProcessed: unified1.global.signalsProcessed,
281
- neuralPatternCount: unified1.neuralPatterns.patternCount,
282
- memoryBridgeTotal: unified1.memoryBridge.totalEntries,
283
- };
284
-
285
- const deltas = Object.fromEntries(
286
- Object.keys(after).map((k) => [k, after[k] - before[k]]),
287
- );
288
-
289
- const summary = {
290
- runAt: new Date().toISOString(),
291
- benchmark: 'pretrain-from-github',
292
- source: SOURCE,
293
- config: { COMMITS, ISSUES },
294
- harvest: {
295
- commits: commits.length,
296
- issues: issues.length,
297
- total: items.length,
298
- harvestMs: Number(harvestMs.toFixed(2)),
299
- },
300
- feed: {
301
- trained,
302
- failed,
303
- avgLatencyMs: items.length > 0 ? Number((feedMs / items.length).toFixed(2)) : 0,
304
- totalMs: Number(feedMs.toFixed(2)),
305
- sampleFailures: failures,
306
- verdictMix, // ADR-078 outcome signal — counts per harvested verdict
307
- },
308
- seedNeuralStore: {
309
- stored: seedResult.stored,
310
- total: seedResult.total,
311
- seedMs: Number(seedMs.toFixed(2)),
312
- },
313
- before,
314
- after,
315
- deltas,
316
- consistency: unified1.consistency,
317
- passed:
318
- trained === items.length &&
319
- deltas.trajectoriesRecorded >= items.length &&
320
- deltas.neuralPatternCount >= items.length,
321
- };
322
-
323
- if (process.env.BENCH_JSON) {
324
- console.log(JSON.stringify(summary, null, 2));
325
- } else {
326
- console.log('');
327
- console.log('| Counter | Before | After | Δ |');
328
- console.log('|---|---:|---:|---:|');
329
- for (const k of Object.keys(after)) {
330
- console.log(`| ${k} | ${before[k]} | ${after[k]} | +${deltas[k]} |`);
331
- }
332
- console.log('');
333
- console.log(`Trained via trajectory pipeline: ${trained}/${items.length}`);
334
- console.log(`Failed: ${failed}`);
335
- console.log(`Avg latency per trajectory: ${summary.feed.avgLatencyMs} ms`);
336
- console.log(`Neural store seeded: ${seedResult.stored}/${seedResult.total}`);
337
- console.log(`Verdict mix: success=${verdictMix.success} partial=${verdictMix.partial} reverted=${verdictMix.reverted} hotfixed=${verdictMix.hotfixed}`);
338
- console.log(`Overall: ${summary.passed ? '✅ PASSED' : '⚠️ partial'}`);
339
- if (unified1.consistency.notes.length > 0) {
340
- console.log(`\nConsistency notes:`);
341
- for (const n of unified1.consistency.notes) console.log(` • ${n}`);
342
- }
343
- }
344
-
345
- if (!process.env.BENCH_NO_WRITE) {
346
- mkdirSync(RUNS_DIR, { recursive: true });
347
- const stamp = summary.runAt.replace(/[:.]/g, '-');
348
- writeFileSync(join(RUNS_DIR, `pretrain-from-github-${stamp}.json`), JSON.stringify(summary, null, 2));
349
- writeFileSync(join(RUNS_DIR, 'pretrain-from-github-latest.json'), JSON.stringify(summary, null, 2));
350
- if (!process.env.BENCH_JSON) console.log(`\nWrote ${join(RUNS_DIR, `pretrain-from-github-${stamp}.json`)}`);
351
- }
352
-
353
- // ONNX runtime keeps a worker thread alive — force exit so this can be used
354
- // as a CI step or chained with other scripts.
355
- process.exit(summary.passed ? 0 : 1);
356
- }
357
-
358
- main().catch((err) => { console.error(err); process.exit(1); });
1
+ #!/usr/bin/env node
2
+ // pretrain-from-github.mjs — pretrain ruflo's self-learning system from its
3
+ // own GitHub history (commits + issues). Each commit/issue becomes one
4
+ // trajectory through the SONA + EWC++ pipeline; Structured Distillation
5
+ // (ADR-076) compresses each into the 4-field schema before embedding.
6
+ //
7
+ // What this proves:
8
+ // - globalStats.{trajectoriesRecorded, patternsLearned, signalsProcessed}
9
+ // all move from a measured before to a measured after.
10
+ // - neural_patterns.patternCount grows.
11
+ // - memory-bridge entries grow.
12
+ // - The unified-stats aggregator's consistency block stays clean.
13
+ // - Every item gets a learningPath of 'trajectory-pipeline' (not 'recorded-only').
14
+ //
15
+ // Usage:
16
+ // node scripts/pretrain-from-github.mjs # 50 commits + 30 issues
17
+ // COMMITS=200 ISSUES=100 node scripts/pretrain-from-github.mjs
18
+ // SOURCE=git node scripts/pretrain-from-github.mjs # git only, skip gh
19
+ // BENCH_JSON=1 node scripts/pretrain-from-github.mjs # machine-readable
20
+ // BENCH_NO_WRITE=1 node scripts/pretrain-from-github.mjs # don't write a run JSON
21
+ //
22
+ // Repro from a fresh checkout:
23
+ // git clone https://github.com/ruvnet/ruflo && cd ruflo
24
+ // npm install && ( cd v3/@claude-flow/cli && npx tsc -b )
25
+ // node v3/@claude-flow/cli/scripts/pretrain-from-github.mjs
26
+
27
+ import { execSync } from 'node:child_process';
28
+ import { writeFileSync, mkdirSync } from 'node:fs';
29
+ import { fileURLToPath } from 'node:url';
30
+ import { dirname, join, resolve } from 'node:path';
31
+ import { performance } from 'node:perf_hooks';
32
+
33
+ const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
34
+ const CLI_ROOT = resolve(SCRIPT_DIR, '..');
35
+ const RUFLO_ROOT = resolve(SCRIPT_DIR, '../../../..');
36
+ const RUNS_DIR = join(RUFLO_ROOT, 'docs', 'benchmarks', 'runs');
37
+
38
+ // ADR-084 cross-repo support — REPO_ROOT and GH_REPO env-overridable so the
39
+ // same script can pretrain on agentdb / agentic-flow / any other repo for
40
+ // generalisation testing. Defaults preserve ruflo behaviour.
41
+ const REPO_ROOT = process.env.REPO_ROOT ? resolve(process.env.REPO_ROOT) : RUFLO_ROOT;
42
+ const GH_REPO = process.env.GH_REPO || 'ruvnet/ruflo';
43
+
44
+ const COMMITS = Number(process.env.COMMITS) || 50;
45
+ const ISSUES = Number(process.env.ISSUES) || 30;
46
+ const SOURCE = process.env.SOURCE || 'all'; // 'all' | 'git' | 'issues'
47
+
48
+ // ---------------------------------------------------------------------------
49
+ // Harvesters
50
+ // ---------------------------------------------------------------------------
51
+
52
+ // ADR-078 outcome signal — classify each commit by whether it was reverted,
53
+ // hotfix-followed, or stuck. Operates on the harvested-commits window plus a
54
+ // wider lookahead window for revert/hotfix detection.
55
+ //
56
+ // Verdicts emitted:
57
+ // success — landed cleanly, no later commit reverted or fixed it
58
+ // reverted — a later commit subject starts with `Revert "<this subject>"`
59
+ // hotfixed — a later commit (within HOTFIX_WINDOW_COMMITS) shares >=50%
60
+ // of the same touched files AND subject contains fix|hotfix|patch
61
+ //
62
+ // The "later" direction is git-log order (newest first → we look at older
63
+ // indices in the lookahead, which are NEWER commits chronologically).
64
+ const HOTFIX_WINDOW_COMMITS = Number(process.env.HOTFIX_WINDOW_COMMITS) || 20;
65
+ const HOTFIX_FILE_OVERLAP = Number(process.env.HOTFIX_FILE_OVERLAP) || 0.5;
66
+ const HOTFIX_KEYWORDS = /\b(fix|hotfix|patch|revert|bugfix|fixup)\b/i;
67
+
68
+ function harvestCommits(n) {
69
+ if (SOURCE === 'issues') return [];
70
+ const fmt = '%H%x00%s%x00%b%x01';
71
+ // Pull a wider window so we have lookahead for revert/hotfix detection
72
+ // without changing the trained set size n.
73
+ const lookahead = HOTFIX_WINDOW_COMMITS;
74
+ const raw = execSync(
75
+ `git log --pretty=format:'${fmt}' -n ${n + lookahead} 2>/dev/null`,
76
+ { cwd: REPO_ROOT, encoding: 'utf-8', maxBuffer: 64 * 1024 * 1024 },
77
+ );
78
+
79
+ // Parse all blocks (window + lookahead).
80
+ const all = [];
81
+ for (const block of raw.split('\x01')) {
82
+ if (!block.trim()) continue;
83
+ const [sha, subject, body] = block.split('\x00');
84
+ if (!sha || !subject) continue;
85
+ all.push({ sha, subject: subject.trim(), body: (body || '').trim() });
86
+ }
87
+
88
+ // For each commit in the trained slice, get its touched files.
89
+ const filesCache = new Map();
90
+ const filesOf = (sha) => {
91
+ if (filesCache.has(sha)) return filesCache.get(sha);
92
+ try {
93
+ const out = execSync(
94
+ `git show --pretty=format: --name-only ${sha} 2>/dev/null`,
95
+ { cwd: REPO_ROOT, encoding: 'utf-8', maxBuffer: 8 * 1024 * 1024 },
96
+ ).trim().split('\n').filter(Boolean);
97
+ filesCache.set(sha, new Set(out));
98
+ return filesCache.get(sha);
99
+ } catch {
100
+ filesCache.set(sha, new Set());
101
+ return filesCache.get(sha);
102
+ }
103
+ };
104
+
105
+ // Build a revert-target map: any commit whose subject starts with
106
+ // `Revert "<X>"` flags X as reverted.
107
+ const revertedSubjects = new Set();
108
+ for (const c of all) {
109
+ const m = c.subject.match(/^Revert\s+"(.+?)"/);
110
+ if (m) revertedSubjects.add(m[1].trim());
111
+ }
112
+
113
+ const trained = all.slice(0, n);
114
+ const entries = [];
115
+ for (let i = 0; i < trained.length; i++) {
116
+ const c = trained[i];
117
+ const myFiles = filesOf(c.sha);
118
+
119
+ let verdict = 'success';
120
+ let outcomeNote = null;
121
+
122
+ // Reverted? Check if any later (lower-index = newer) commit reverted us.
123
+ if (revertedSubjects.has(c.subject)) {
124
+ verdict = 'reverted';
125
+ outcomeNote = 'subject reverted by a later commit';
126
+ } else {
127
+ // Hotfixed? A later commit within HOTFIX_WINDOW_COMMITS shares files
128
+ // AND has fix/hotfix in its subject.
129
+ const start = Math.max(0, i - HOTFIX_WINDOW_COMMITS);
130
+ for (let j = start; j < i; j++) {
131
+ const later = trained[j];
132
+ if (!HOTFIX_KEYWORDS.test(later.subject)) continue;
133
+ const laterFiles = filesOf(later.sha);
134
+ if (laterFiles.size === 0 || myFiles.size === 0) continue;
135
+ let overlap = 0;
136
+ for (const f of laterFiles) if (myFiles.has(f)) overlap++;
137
+ // Use min() so a small targeted fix on a big change still triggers
138
+ // (semantic: "≥half of the smaller commit's files overlap").
139
+ const overlapFrac = overlap / Math.min(laterFiles.size, myFiles.size);
140
+ if (overlapFrac >= HOTFIX_FILE_OVERLAP) {
141
+ verdict = 'hotfixed';
142
+ outcomeNote = `${(overlapFrac * 100).toFixed(0)}% file overlap with later fix ${later.sha.slice(0, 8)}`;
143
+ break;
144
+ }
145
+ }
146
+ }
147
+
148
+ entries.push({
149
+ source: 'commit',
150
+ id: `commit-${c.sha.slice(0, 12)}`,
151
+ subject: c.subject,
152
+ body: c.body,
153
+ verdict,
154
+ outcomeNote,
155
+ content: `${c.subject}\n\n${c.body}`.slice(0, 8192),
156
+ });
157
+ }
158
+ return entries;
159
+ }
160
+
161
+ function harvestIssues(n) {
162
+ if (SOURCE === 'git') return [];
163
+ try {
164
+ const raw = execSync(
165
+ `gh issue list --repo ${GH_REPO} --state all --limit ${n} --json number,title,body,state,closedAt 2>/dev/null`,
166
+ { cwd: REPO_ROOT, encoding: 'utf-8', maxBuffer: 64 * 1024 * 1024 },
167
+ );
168
+ const items = JSON.parse(raw);
169
+ return items.map((i) => ({
170
+ source: 'issue',
171
+ id: `issue-${i.number}`,
172
+ subject: i.title,
173
+ body: (i.body || '').slice(0, 8192),
174
+ // closed = success outcome; open = partial (in-progress).
175
+ verdict: i.state === 'CLOSED' ? 'success' : 'partial',
176
+ content: `${i.title}\n\n${(i.body || '').slice(0, 8192)}`,
177
+ }));
178
+ } catch (err) {
179
+ console.error(`gh issue harvest skipped (${err.message?.slice(0, 60)}). Set SOURCE=git to silence.`);
180
+ return [];
181
+ }
182
+ }
183
+
184
+ // ---------------------------------------------------------------------------
185
+ // Main
186
+ // ---------------------------------------------------------------------------
187
+
188
+ async function main() {
189
+ const intel = await import(join(CLI_ROOT, 'dist/src/memory/intelligence.js'));
190
+ const neural = await import(join(CLI_ROOT, 'dist/src/mcp-tools/neural-tools.js'));
191
+ const { distillAndSerialise } = await import(join(CLI_ROOT, 'dist/src/memory/structured-distill.js'));
192
+
193
+ // §1 — record the baseline (no clear; we want to learn ON TOP of whatever
194
+ // history the user already has).
195
+ const unified0 = await intel.getUnifiedLearningStats();
196
+ const before = {
197
+ trajectoriesRecorded: unified0.global.trajectoriesRecorded,
198
+ patternsLearned: unified0.global.patternsLearned,
199
+ signalsProcessed: unified0.global.signalsProcessed,
200
+ neuralPatternCount: unified0.neuralPatterns.patternCount,
201
+ memoryBridgeTotal: unified0.memoryBridge.totalEntries,
202
+ };
203
+
204
+ // §2 — harvest
205
+ const tHarvest0 = performance.now();
206
+ const commits = harvestCommits(COMMITS);
207
+ const issues = harvestIssues(ISSUES);
208
+ const items = [...commits, ...issues];
209
+ const harvestMs = performance.now() - tHarvest0;
210
+
211
+ if (!process.env.BENCH_JSON) {
212
+ console.log(`# Pretrain from ruflo GitHub history`);
213
+ console.log(`Harvested: ${commits.length} commits + ${issues.length} issues = ${items.length} trajectories (${harvestMs.toFixed(0)} ms)`);
214
+ }
215
+
216
+ // §3 — feed each item through the trajectory pipeline. The harvester
217
+ // emits one of: success | partial | reverted | hotfixed. We map this to
218
+ // the trajectory pipeline's binary verdict {success, partial} since the
219
+ // pipeline doesn't accept arbitrary strings — but we preserve the original
220
+ // outcome in metadata + the summary's verdictMix so the signal isn't lost.
221
+ const verdictToPipeline = (v) => {
222
+ if (v === 'success') return 'success';
223
+ if (v === 'partial') return 'partial';
224
+ if (v === 'reverted') return 'partial'; // a revert is the strongest "this was wrong" signal we have
225
+ if (v === 'hotfixed') return 'partial'; // a same-files fix-followup is "needs adjustment"
226
+ return 'success';
227
+ };
228
+ const verdictMix = { success: 0, partial: 0, reverted: 0, hotfixed: 0 };
229
+ const tFeed0 = performance.now();
230
+ let trained = 0;
231
+ let failed = 0;
232
+ const failures = [];
233
+ for (const item of items) {
234
+ try {
235
+ const distilled = distillAndSerialise(item.content);
236
+ verdictMix[item.verdict] = (verdictMix[item.verdict] ?? 0) + 1;
237
+ await intel.recordTrajectory(
238
+ [{
239
+ type: 'result',
240
+ content: distilled,
241
+ metadata: {
242
+ source: item.source,
243
+ id: item.id,
244
+ subject: item.subject.slice(0, 200),
245
+ outcomeVerdict: item.verdict,
246
+ outcomeNote: item.outcomeNote ?? null,
247
+ },
248
+ timestamp: Date.now(),
249
+ }],
250
+ verdictToPipeline(item.verdict),
251
+ );
252
+ trained++;
253
+ } catch (err) {
254
+ failed++;
255
+ if (failures.length < 5) failures.push({ id: item.id, error: String(err.message).slice(0, 120) });
256
+ }
257
+ }
258
+ const feedMs = performance.now() - tFeed0;
259
+ intel.flushIntelligenceStats();
260
+
261
+ // §4 — also seed the neural store directly from the same items so
262
+ // `neural_patterns list` reflects them (closes the "globalStats moved but
263
+ // neural_patterns didn't" consistency note from ADR-075).
264
+ const tSeed0 = performance.now();
265
+ const neuralItems = items.map((item) => ({
266
+ name: item.subject.slice(0, 200),
267
+ type: item.source === 'commit' ? 'history-commit' : 'history-issue',
268
+ content: distillAndSerialise(item.content),
269
+ metadata: { source: item.source, id: item.id, verdict: item.verdict },
270
+ }));
271
+ const seedResult = await neural.storeNeuralPatterns(neuralItems);
272
+ const seedMs = performance.now() - tSeed0;
273
+
274
+ // §5 — read the after-counters via the unified aggregator (this is what
275
+ // hooks_intelligence_unified-stats would return for a live caller).
276
+ const unified1 = await intel.getUnifiedLearningStats();
277
+ const after = {
278
+ trajectoriesRecorded: unified1.global.trajectoriesRecorded,
279
+ patternsLearned: unified1.global.patternsLearned,
280
+ signalsProcessed: unified1.global.signalsProcessed,
281
+ neuralPatternCount: unified1.neuralPatterns.patternCount,
282
+ memoryBridgeTotal: unified1.memoryBridge.totalEntries,
283
+ };
284
+
285
+ const deltas = Object.fromEntries(
286
+ Object.keys(after).map((k) => [k, after[k] - before[k]]),
287
+ );
288
+
289
+ const summary = {
290
+ runAt: new Date().toISOString(),
291
+ benchmark: 'pretrain-from-github',
292
+ source: SOURCE,
293
+ config: { COMMITS, ISSUES },
294
+ harvest: {
295
+ commits: commits.length,
296
+ issues: issues.length,
297
+ total: items.length,
298
+ harvestMs: Number(harvestMs.toFixed(2)),
299
+ },
300
+ feed: {
301
+ trained,
302
+ failed,
303
+ avgLatencyMs: items.length > 0 ? Number((feedMs / items.length).toFixed(2)) : 0,
304
+ totalMs: Number(feedMs.toFixed(2)),
305
+ sampleFailures: failures,
306
+ verdictMix, // ADR-078 outcome signal — counts per harvested verdict
307
+ },
308
+ seedNeuralStore: {
309
+ stored: seedResult.stored,
310
+ total: seedResult.total,
311
+ seedMs: Number(seedMs.toFixed(2)),
312
+ },
313
+ before,
314
+ after,
315
+ deltas,
316
+ consistency: unified1.consistency,
317
+ passed:
318
+ trained === items.length &&
319
+ deltas.trajectoriesRecorded >= items.length &&
320
+ deltas.neuralPatternCount >= items.length,
321
+ };
322
+
323
+ if (process.env.BENCH_JSON) {
324
+ console.log(JSON.stringify(summary, null, 2));
325
+ } else {
326
+ console.log('');
327
+ console.log('| Counter | Before | After | Δ |');
328
+ console.log('|---|---:|---:|---:|');
329
+ for (const k of Object.keys(after)) {
330
+ console.log(`| ${k} | ${before[k]} | ${after[k]} | +${deltas[k]} |`);
331
+ }
332
+ console.log('');
333
+ console.log(`Trained via trajectory pipeline: ${trained}/${items.length}`);
334
+ console.log(`Failed: ${failed}`);
335
+ console.log(`Avg latency per trajectory: ${summary.feed.avgLatencyMs} ms`);
336
+ console.log(`Neural store seeded: ${seedResult.stored}/${seedResult.total}`);
337
+ console.log(`Verdict mix: success=${verdictMix.success} partial=${verdictMix.partial} reverted=${verdictMix.reverted} hotfixed=${verdictMix.hotfixed}`);
338
+ console.log(`Overall: ${summary.passed ? '✅ PASSED' : '⚠️ partial'}`);
339
+ if (unified1.consistency.notes.length > 0) {
340
+ console.log(`\nConsistency notes:`);
341
+ for (const n of unified1.consistency.notes) console.log(` • ${n}`);
342
+ }
343
+ }
344
+
345
+ if (!process.env.BENCH_NO_WRITE) {
346
+ mkdirSync(RUNS_DIR, { recursive: true });
347
+ const stamp = summary.runAt.replace(/[:.]/g, '-');
348
+ writeFileSync(join(RUNS_DIR, `pretrain-from-github-${stamp}.json`), JSON.stringify(summary, null, 2));
349
+ writeFileSync(join(RUNS_DIR, 'pretrain-from-github-latest.json'), JSON.stringify(summary, null, 2));
350
+ if (!process.env.BENCH_JSON) console.log(`\nWrote ${join(RUNS_DIR, `pretrain-from-github-${stamp}.json`)}`);
351
+ }
352
+
353
+ // ONNX runtime keeps a worker thread alive — force exit so this can be used
354
+ // as a CI step or chained with other scripts.
355
+ process.exit(summary.passed ? 0 : 1);
356
+ }
357
+
358
+ main().catch((err) => { console.error(err); process.exit(1); });