claude-flow-novice 2.0.3 → 2.0.4

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 (272) hide show
  1. package/dist/src/cli/commands/guidance.js +487 -668
  2. package/dist/src/cli/commands/index-validate.js +18 -29
  3. package/dist/src/cli/commands/mcp-troubleshoot.js +230 -282
  4. package/dist/src/cli/commands/neural-goal-init.js +92 -125
  5. package/dist/src/cli/commands/swarm-exec.js +317 -393
  6. package/dist/src/cli/commands/swarm.js +1 -1
  7. package/dist/src/cli/commands/validate-framework.js +983 -1100
  8. package/dist/src/cli/commands/validate.js +144 -223
  9. package/dist/src/cli/simple-commands/__tests__/agent.test.js +265 -277
  10. package/dist/src/cli/simple-commands/__tests__/memory.test.js +6 -7
  11. package/dist/src/cli/simple-commands/__tests__/swarm.test.js +373 -356
  12. package/dist/src/cli/simple-commands/__tests__/task.test.js +6 -7
  13. package/dist/src/cli/simple-commands/agent.js +157 -193
  14. package/dist/src/cli/simple-commands/analysis.js +336 -446
  15. package/dist/src/cli/simple-commands/automation-executor.js +1095 -1339
  16. package/dist/src/cli/simple-commands/automation.js +481 -469
  17. package/dist/src/cli/simple-commands/batch-manager.js +261 -313
  18. package/dist/src/cli/simple-commands/claude-telemetry.js +241 -267
  19. package/dist/src/cli/simple-commands/claude-track.js +68 -90
  20. package/dist/src/cli/simple-commands/concurrent-display.js +266 -320
  21. package/dist/src/cli/simple-commands/config.js +245 -290
  22. package/dist/src/cli/simple-commands/coordination.js +182 -234
  23. package/dist/src/cli/simple-commands/enhanced-ui-views.js +812 -615
  24. package/dist/src/cli/simple-commands/enhanced-webui-complete.js +922 -981
  25. package/dist/src/cli/simple-commands/fix-hook-variables.js +274 -294
  26. package/dist/src/cli/simple-commands/github/gh-coordinator.js +378 -457
  27. package/dist/src/cli/simple-commands/github/github-api.js +535 -574
  28. package/dist/src/cli/simple-commands/github/init.js +276 -303
  29. package/dist/src/cli/simple-commands/github.js +222 -247
  30. package/dist/src/cli/simple-commands/goal.js +51 -63
  31. package/dist/src/cli/simple-commands/hive-mind/auto-save-middleware.js +208 -278
  32. package/dist/src/cli/simple-commands/hive-mind/communication.js +601 -696
  33. package/dist/src/cli/simple-commands/hive-mind/core.js +907 -979
  34. package/dist/src/cli/simple-commands/hive-mind/db-optimizer.js +406 -655
  35. package/dist/src/cli/simple-commands/hive-mind/mcp-wrapper.js +1125 -1245
  36. package/dist/src/cli/simple-commands/hive-mind/memory.js +854 -1090
  37. package/dist/src/cli/simple-commands/hive-mind/performance-optimizer.js +459 -574
  38. package/dist/src/cli/simple-commands/hive-mind/performance-test.js +263 -347
  39. package/dist/src/cli/simple-commands/hive-mind/queen.js +727 -768
  40. package/dist/src/cli/simple-commands/hive-mind/session-manager.js +745 -1049
  41. package/dist/src/cli/simple-commands/hive-mind-optimize.js +227 -283
  42. package/dist/src/cli/simple-commands/hive-mind-wizard.js +174 -217
  43. package/dist/src/cli/simple-commands/hive-mind.js +1842 -2283
  44. package/dist/src/cli/simple-commands/hive.js +90 -79
  45. package/dist/src/cli/simple-commands/hook-safety.js +431 -521
  46. package/dist/src/cli/simple-commands/hooks/session-start-soul.js +203 -254
  47. package/dist/src/cli/simple-commands/hooks.js +1064 -1204
  48. package/dist/src/cli/simple-commands/init/agent-copier.js +294 -319
  49. package/dist/src/cli/simple-commands/init/batch-init.js +496 -562
  50. package/dist/src/cli/simple-commands/init/claude-commands/claude-flow-commands.js +13 -19
  51. package/dist/src/cli/simple-commands/init/claude-commands/optimized-claude-flow-commands.js +13 -19
  52. package/dist/src/cli/simple-commands/init/claude-commands/optimized-slash-commands.js +61 -88
  53. package/dist/src/cli/simple-commands/init/claude-commands/optimized-sparc-commands.js +125 -150
  54. package/dist/src/cli/simple-commands/init/claude-commands/slash-commands.js +42 -49
  55. package/dist/src/cli/simple-commands/init/claude-commands/sparc-commands.js +43 -61
  56. package/dist/src/cli/simple-commands/init/copy-revised-templates.js +141 -147
  57. package/dist/src/cli/simple-commands/init/executable-wrapper.js +31 -44
  58. package/dist/src/cli/simple-commands/init/gitignore-updater.js +64 -90
  59. package/dist/src/cli/simple-commands/init/help.js +104 -107
  60. package/dist/src/cli/simple-commands/init/hive-mind-init.js +509 -528
  61. package/dist/src/cli/simple-commands/init/index.js +1510 -1759
  62. package/dist/src/cli/simple-commands/init/performance-monitor.js +234 -317
  63. package/dist/src/cli/simple-commands/init/rollback/backup-manager.js +441 -504
  64. package/dist/src/cli/simple-commands/init/rollback/index.js +289 -364
  65. package/dist/src/cli/simple-commands/init/rollback/recovery-manager.js +652 -728
  66. package/dist/src/cli/simple-commands/init/rollback/rollback-executor.js +416 -481
  67. package/dist/src/cli/simple-commands/init/rollback/state-tracker.js +369 -448
  68. package/dist/src/cli/simple-commands/init/sparc/roo-readme.js +1 -2
  69. package/dist/src/cli/simple-commands/init/sparc/roomodes-config.js +122 -99
  70. package/dist/src/cli/simple-commands/init/sparc/workflows.js +32 -37
  71. package/dist/src/cli/simple-commands/init/sparc-structure.js +55 -62
  72. package/dist/src/cli/simple-commands/init/template-copier.js +421 -533
  73. package/dist/src/cli/simple-commands/init/templates/coordination-md.js +3 -6
  74. package/dist/src/cli/simple-commands/init/templates/enhanced-templates.js +344 -318
  75. package/dist/src/cli/simple-commands/init/templates/github-safe-enhanced.js +173 -218
  76. package/dist/src/cli/simple-commands/init/templates/github-safe.js +65 -75
  77. package/dist/src/cli/simple-commands/init/templates/memory-bank-md.js +3 -6
  78. package/dist/src/cli/simple-commands/init/templates/readme-files.js +2 -4
  79. package/dist/src/cli/simple-commands/init/templates/safe-hook-patterns.js +187 -230
  80. package/dist/src/cli/simple-commands/init/templates/sparc-modes.js +53 -80
  81. package/dist/src/cli/simple-commands/init/templates/verification-claude-md.js +101 -85
  82. package/dist/src/cli/simple-commands/init/validation/config-validator.js +283 -330
  83. package/dist/src/cli/simple-commands/init/validation/health-checker.js +495 -561
  84. package/dist/src/cli/simple-commands/init/validation/index.js +302 -358
  85. package/dist/src/cli/simple-commands/init/validation/mode-validator.js +308 -359
  86. package/dist/src/cli/simple-commands/init/validation/post-init-validator.js +389 -366
  87. package/dist/src/cli/simple-commands/init/validation/pre-init-validator.js +270 -268
  88. package/dist/src/cli/simple-commands/init/validation/test-runner.js +427 -447
  89. package/dist/src/cli/simple-commands/init.js +1 -2
  90. package/dist/src/cli/simple-commands/mcp-health.js +131 -158
  91. package/dist/src/cli/simple-commands/mcp-integration-layer.js +533 -634
  92. package/dist/src/cli/simple-commands/mcp.js +345 -400
  93. package/dist/src/cli/simple-commands/memory-consolidation.js +426 -537
  94. package/dist/src/cli/simple-commands/memory.js +247 -311
  95. package/dist/src/cli/simple-commands/migrate-hooks.js +39 -46
  96. package/dist/src/cli/simple-commands/monitor.js +294 -363
  97. package/dist/src/cli/simple-commands/neural.js +51 -65
  98. package/dist/src/cli/simple-commands/pair-autofix-only.js +538 -662
  99. package/dist/src/cli/simple-commands/pair-basic.js +528 -656
  100. package/dist/src/cli/simple-commands/pair-old.js +430 -543
  101. package/dist/src/cli/simple-commands/pair-working.js +615 -751
  102. package/dist/src/cli/simple-commands/pair.js +615 -751
  103. package/dist/src/cli/simple-commands/performance-hooks.js +83 -111
  104. package/dist/src/cli/simple-commands/performance-metrics.js +348 -433
  105. package/dist/src/cli/simple-commands/process-ui-enhanced.js +708 -787
  106. package/dist/src/cli/simple-commands/process-ui.js +230 -254
  107. package/dist/src/cli/simple-commands/realtime-update-system.js +525 -611
  108. package/dist/src/cli/simple-commands/sparc/architecture.js +1704 -1530
  109. package/dist/src/cli/simple-commands/sparc/commands.js +438 -516
  110. package/dist/src/cli/simple-commands/sparc/completion.js +1224 -1481
  111. package/dist/src/cli/simple-commands/sparc/coordinator.js +913 -978
  112. package/dist/src/cli/simple-commands/sparc/index.js +241 -298
  113. package/dist/src/cli/simple-commands/sparc/phase-base.js +314 -390
  114. package/dist/src/cli/simple-commands/sparc/pseudocode.js +965 -869
  115. package/dist/src/cli/simple-commands/sparc/refinement.js +980 -1273
  116. package/dist/src/cli/simple-commands/sparc/specification.js +559 -645
  117. package/dist/src/cli/simple-commands/sparc-modes/architect.js +1 -1
  118. package/dist/src/cli/simple-commands/sparc-modes/ask.js +1 -1
  119. package/dist/src/cli/simple-commands/sparc-modes/code.js +1 -1
  120. package/dist/src/cli/simple-commands/sparc-modes/debug.js +1 -1
  121. package/dist/src/cli/simple-commands/sparc-modes/devops.js +1 -1
  122. package/dist/src/cli/simple-commands/sparc-modes/docs-writer.js +1 -1
  123. package/dist/src/cli/simple-commands/sparc-modes/generic.js +1 -1
  124. package/dist/src/cli/simple-commands/sparc-modes/index.js +47 -55
  125. package/dist/src/cli/simple-commands/sparc-modes/integration.js +1 -1
  126. package/dist/src/cli/simple-commands/sparc-modes/mcp.js +1 -1
  127. package/dist/src/cli/simple-commands/sparc-modes/monitoring.js +1 -1
  128. package/dist/src/cli/simple-commands/sparc-modes/optimization.js +1 -1
  129. package/dist/src/cli/simple-commands/sparc-modes/security-review.js +1 -1
  130. package/dist/src/cli/simple-commands/sparc-modes/sparc-orchestrator.js +1 -1
  131. package/dist/src/cli/simple-commands/sparc-modes/spec-pseudocode.js +1 -1
  132. package/dist/src/cli/simple-commands/sparc-modes/supabase-admin.js +1 -1
  133. package/dist/src/cli/simple-commands/sparc-modes/swarm.js +101 -87
  134. package/dist/src/cli/simple-commands/sparc-modes/tdd.js +1 -1
  135. package/dist/src/cli/simple-commands/sparc-modes/tutorial.js +1 -1
  136. package/dist/src/cli/simple-commands/sparc.js +465 -493
  137. package/dist/src/cli/simple-commands/start-ui.js +108 -132
  138. package/dist/src/cli/simple-commands/start-wrapper.js +240 -268
  139. package/dist/src/cli/simple-commands/start.js +1 -1
  140. package/dist/src/cli/simple-commands/status.js +254 -275
  141. package/dist/src/cli/simple-commands/stream-chain-clean.js +128 -171
  142. package/dist/src/cli/simple-commands/stream-chain-fixed.js +61 -82
  143. package/dist/src/cli/simple-commands/stream-chain-real.js +267 -331
  144. package/dist/src/cli/simple-commands/stream-chain-working.js +211 -263
  145. package/dist/src/cli/simple-commands/stream-chain.js +260 -318
  146. package/dist/src/cli/simple-commands/stream-processor.js +290 -315
  147. package/dist/src/cli/simple-commands/swarm-executor.js +189 -222
  148. package/dist/src/cli/simple-commands/swarm-metrics-integration.js +208 -300
  149. package/dist/src/cli/simple-commands/swarm-ui.js +623 -703
  150. package/dist/src/cli/simple-commands/swarm-webui-integration.js +258 -286
  151. package/dist/src/cli/simple-commands/swarm.js +887 -1082
  152. package/dist/src/cli/simple-commands/task.js +161 -206
  153. package/dist/src/cli/simple-commands/timestamp-fix.js +59 -89
  154. package/dist/src/cli/simple-commands/token-tracker.js +258 -316
  155. package/dist/src/cli/simple-commands/tool-execution-framework.js +433 -519
  156. package/dist/src/cli/simple-commands/train-and-stream.js +275 -331
  157. package/dist/src/cli/simple-commands/training-pipeline.js +619 -725
  158. package/dist/src/cli/simple-commands/training.js +170 -227
  159. package/dist/src/cli/simple-commands/verification-hooks.js +261 -284
  160. package/dist/src/cli/simple-commands/verification-integration.js +389 -417
  161. package/dist/src/cli/simple-commands/verification-training-integration.js +486 -606
  162. package/dist/src/cli/simple-commands/verification.js +493 -513
  163. package/dist/src/cli/simple-commands/web-server.js +766 -836
  164. package/dist/src/cli/simple-commands/webui-validator.js +106 -124
  165. package/dist/src/coordination/event-bus/demo-wasm-integration.js +212 -251
  166. package/dist/src/coordination/event-bus/qe-event-bus.js +608 -748
  167. package/dist/src/coordination/event-bus/qe-event-bus.test.js +379 -454
  168. package/dist/src/coordination/iteration-tracker.js +363 -454
  169. package/dist/src/enterprise/analytics-manager.js +1135 -0
  170. package/dist/src/enterprise/audit-manager.js +1115 -0
  171. package/dist/src/enterprise/cloud-manager.js +891 -0
  172. package/dist/src/enterprise/deployment-manager.js +966 -0
  173. package/dist/src/enterprise/index.js +6 -0
  174. package/dist/src/enterprise/project-manager.js +584 -0
  175. package/dist/src/enterprise/security-manager.js +991 -0
  176. package/dist/src/index.js +1 -1
  177. package/dist/src/mcp/DEPRECATED.js +46 -60
  178. package/dist/src/mcp/fixes/mcp-error-fixes.js +115 -134
  179. package/dist/src/mcp/implementations/agent-tracker.js +114 -128
  180. package/dist/src/mcp/implementations/daa-tools.js +292 -350
  181. package/dist/src/mcp/implementations/workflow-tools.js +329 -361
  182. package/dist/src/mcp/mcp-config-manager.js +1183 -1331
  183. package/dist/src/mcp/mcp-server-novice-simplified.js +11 -17
  184. package/dist/src/mcp/mcp-server-novice.js +11 -17
  185. package/dist/src/mcp/mcp-server-sdk.js +11 -17
  186. package/dist/src/mcp/mcp-server.js +1620 -1484
  187. package/dist/src/mcp/ruv-swarm-wrapper.js +209 -239
  188. package/dist/src/memory/advanced-serializer.js +609 -589
  189. package/dist/src/memory/enhanced-examples.js +220 -305
  190. package/dist/src/memory/enhanced-memory.js +295 -336
  191. package/dist/src/memory/enhanced-session-serializer.js +408 -492
  192. package/dist/src/memory/fallback-memory-system.js +900 -1021
  193. package/dist/src/memory/fallback-store.js +93 -131
  194. package/dist/src/memory/high-performance-serialization.js +592 -730
  195. package/dist/src/memory/in-memory-store.js +161 -213
  196. package/dist/src/memory/index.js +123 -157
  197. package/dist/src/memory/lock-free-structures.js +578 -764
  198. package/dist/src/memory/memory-mapped-persistence.js +585 -766
  199. package/dist/src/memory/memory-pressure-manager.js +569 -707
  200. package/dist/src/memory/migration.js +358 -445
  201. package/dist/src/memory/shared-memory.js +641 -768
  202. package/dist/src/memory/sqlite-store.js +245 -325
  203. package/dist/src/memory/sqlite-wrapper.js +122 -151
  204. package/dist/src/memory/swarm-memory.js +470 -603
  205. package/dist/src/memory/test-example.js +126 -134
  206. package/dist/src/memory/ultra-fast-memory-store.js +622 -821
  207. package/dist/src/memory/unified-memory-manager.js +356 -437
  208. package/dist/src/migration/index.js +92 -0
  209. package/dist/src/migration/logger.js +121 -0
  210. package/dist/src/migration/migration-analyzer.js +268 -0
  211. package/dist/src/migration/migration-runner.js +522 -0
  212. package/dist/src/migration/migration-validator.js +285 -0
  213. package/dist/src/migration/progress-reporter.js +150 -0
  214. package/dist/src/migration/rollback-manager.js +321 -0
  215. package/dist/src/migration/tests/migration-system.test.js +7 -0
  216. package/dist/src/migration/types.js +3 -0
  217. package/dist/src/swarm/CodeRefactoringSwarm.js +777 -952
  218. package/dist/src/swarm/__tests__/integration.test.js +227 -0
  219. package/dist/src/swarm/__tests__/prompt-copier.test.js +344 -0
  220. package/dist/src/swarm/advanced-orchestrator.js +1095 -0
  221. package/dist/src/swarm/claude-code-interface.js +961 -0
  222. package/dist/src/swarm/claude-flow-executor.js +229 -0
  223. package/dist/src/swarm/consensus-coordinator.js +475 -0
  224. package/dist/src/swarm/coordinator.js +2993 -0
  225. package/dist/src/swarm/direct-executor.js +1180 -0
  226. package/dist/src/swarm/error-recovery/advanced-error-detection.js +691 -0
  227. package/dist/src/swarm/error-recovery/automated-recovery-workflows.js +998 -0
  228. package/dist/src/swarm/error-recovery/error-recovery-coordinator.js +1197 -0
  229. package/dist/src/swarm/error-recovery/recovery-monitoring.js +772 -0
  230. package/dist/src/swarm/error-recovery/resilience-architecture.js +714 -0
  231. package/dist/src/swarm/error-recovery/self-healing-mechanisms.js +1319 -0
  232. package/dist/src/swarm/error-recovery/test-error-recovery-effectiveness.js +808 -0
  233. package/dist/src/swarm/executor-v2.js +322 -0
  234. package/dist/src/swarm/executor.js +815 -0
  235. package/dist/src/swarm/hive-mind-integration.js +703 -0
  236. package/dist/src/swarm/index.js +41 -0
  237. package/dist/src/swarm/json-output-aggregator.js +267 -0
  238. package/dist/src/swarm/large-scale-coordinator.js +542 -0
  239. package/dist/src/swarm/mcp-integration-wrapper.js +628 -0
  240. package/dist/src/swarm/memory.js +1117 -0
  241. package/dist/src/swarm/optimizations/__tests__/optimization.test.js +348 -0
  242. package/dist/src/swarm/optimizations/async-file-manager.js +285 -0
  243. package/dist/src/swarm/optimizations/circular-buffer.js +162 -0
  244. package/dist/src/swarm/optimizations/connection-pool.js +244 -0
  245. package/dist/src/swarm/optimizations/index.js +28 -0
  246. package/dist/src/swarm/optimizations/optimized-executor.js +320 -0
  247. package/dist/src/swarm/optimizations/ttl-map.js +234 -0
  248. package/dist/src/swarm/prompt-cli.js +200 -0
  249. package/dist/src/swarm/prompt-copier-enhanced.js +202 -0
  250. package/dist/src/swarm/prompt-copier.js +381 -0
  251. package/dist/src/swarm/prompt-manager.js +295 -0
  252. package/dist/src/swarm/prompt-utils.js +310 -0
  253. package/dist/src/swarm/result-aggregator.js +718 -0
  254. package/dist/src/swarm/sparc-executor.js +1568 -0
  255. package/dist/src/swarm/strategies/auto.js +758 -0
  256. package/dist/src/swarm/strategies/base.js +128 -0
  257. package/dist/src/swarm/strategies/research.js +914 -0
  258. package/dist/src/swarm/strategies/strategy-metrics-patch.js +2 -0
  259. package/dist/src/swarm/types.js +52 -0
  260. package/dist/src/swarm/workers/copy-worker.js +56 -0
  261. package/dist/src/utils/__tests__/github-cli-safety-wrapper.test.js +332 -400
  262. package/dist/src/utils/github-cli-safe.js +56 -64
  263. package/dist/src/utils/github-cli-safety-wrapper.js +451 -546
  264. package/dist/src/utils/npx-isolated-cache.js +104 -119
  265. package/dist/src/utils/preference-manager.js +622 -652
  266. package/dist/src/utils/timezone-utils.js +86 -105
  267. package/dist/src/validators/epic-config-schema.js +214 -0
  268. package/dist/src/validators/index.js +10 -0
  269. package/dist/src/validators/swarm-init-validator.js +259 -0
  270. package/dist/src/validators/todowrite-batching-validator.js +215 -0
  271. package/dist/src/validators/todowrite-integration.js +187 -0
  272. package/package.json +2 -2
@@ -1,254 +1,224 @@
1
1
  /**
2
2
  * Wrapper for ruv-swarm MCP server to handle logger issues
3
3
  * This wrapper ensures compatibility and handles known issues in ruv-swarm
4
- */
5
-
6
- import { spawn } from 'child_process';
7
- import { createInterface } from 'readline';
8
-
4
+ */ import { spawn } from "child_process";
5
+ import { createInterface } from "readline";
9
6
  export class RuvSwarmWrapper {
10
- constructor(options = {}) {
11
- this.options = {
12
- silent: options.silent || false,
13
- autoRestart: options.autoRestart !== false,
14
- maxRestarts: options.maxRestarts || 3,
15
- restartDelay: options.restartDelay || 1000,
16
- ...options,
17
- };
18
-
19
- this.process = null;
20
- this.restartCount = 0;
21
- this.isShuttingDown = false;
22
- }
23
-
24
- async start() {
25
- if (this.process) {
26
- throw new Error('RuvSwarm MCP server is already running');
27
- }
28
-
29
- return new Promise((resolve, reject) => {
30
- try {
31
- // Spawn ruv-swarm MCP server
32
- this.process = spawn('npx', ['ruv-swarm', 'mcp', 'start'], {
33
- stdio: ['pipe', 'pipe', 'pipe'],
34
- env: {
35
- ...process.env,
36
- // Ensure stdio mode for MCP
37
- MCP_MODE: 'stdio',
38
- // Set log level to reduce noise
39
- LOG_LEVEL: 'WARN',
40
- },
41
- });
42
-
43
- let initialized = false;
44
- let initTimeout;
45
-
46
- // Handle stdout (JSON-RPC messages)
47
- const rlOut = createInterface({
48
- input: this.process.stdout,
49
- crlfDelay: Infinity,
50
- });
51
-
52
- rlOut.on('line', (line) => {
53
- try {
54
- const message = JSON.parse(line);
55
-
56
- // Check for initialization
57
- if (message.method === 'server.initialized' && !initialized) {
58
- initialized = true;
59
- clearTimeout(initTimeout);
60
- resolve({
61
- process: this.process,
62
- stdout: this.process.stdout,
63
- stdin: this.process.stdin,
64
- });
65
- }
66
-
67
- // Forward JSON-RPC messages
68
- process.stdout.write(line + '\n');
69
- } catch (err) {
70
- // Not JSON, ignore
71
- }
72
- });
73
-
74
- // Handle stderr (logs and errors)
75
- const rlErr = createInterface({
76
- input: this.process.stderr,
77
- crlfDelay: Infinity,
78
- });
79
-
80
- rlErr.on('line', (line) => {
81
- // Parse structured error messages if available
82
- try {
83
- const errorData = JSON.parse(line);
84
- if (errorData.error && errorData.error.code) {
85
- // Handle specific error codes
86
- switch (errorData.error.code) {
87
- case 'LOGGER_METHOD_MISSING':
88
- case 'ERR_LOGGER_MEMORY_USAGE':
89
- // Known issue with logger.logMemoryUsage in ruv-swarm
90
- if (!this.options.silent) {
91
- console.error(
92
- '⚠️ Known ruv-swarm logger issue detected (continuing normally)',
93
- );
94
- }
95
- return;
96
- case 'ERR_INITIALIZATION':
97
- console.error(' RuvSwarm initialization error:', errorData.error.message);
98
- return;
99
- default:
100
- // Unknown error code, log it
101
- if (!this.options.silent) {
102
- console.error(
103
- `RuvSwarm error [${errorData.error.code}]:`,
104
- errorData.error.message,
105
- );
106
- }
107
- }
108
- return;
109
- }
110
- } catch (e) {
111
- // Not JSON, check for known text patterns as fallback
112
- const knownErrorPatterns = [
113
- {
114
- pattern: /logger\.logMemoryUsage is not a function/,
115
- code: 'LOGGER_METHOD_MISSING',
116
- message: 'Known ruv-swarm logger issue detected (continuing normally)',
117
- },
118
- {
119
- pattern: /Cannot find module/,
120
- code: 'MODULE_NOT_FOUND',
121
- message: 'Module not found error',
122
- },
123
- {
124
- pattern: /ECONNREFUSED/,
125
- code: 'CONNECTION_REFUSED',
126
- message: 'Connection refused error',
127
- },
128
- ];
129
-
130
- for (const errorPattern of knownErrorPatterns) {
131
- if (errorPattern.pattern.test(line)) {
132
- if (!this.options.silent || errorPattern.code !== 'LOGGER_METHOD_MISSING') {
133
- console.error(`⚠️ ${errorPattern.message}`);
134
- }
135
- return;
136
- }
7
+ async start() {
8
+ if (this.process) {
9
+ throw new Error('RuvSwarm MCP server is already running');
10
+ }
11
+ return new Promise((resolve, reject)=>{
12
+ try {
13
+ // Spawn ruv-swarm MCP server
14
+ this.process = spawn('npx', [
15
+ 'ruv-swarm',
16
+ 'mcp',
17
+ 'start'
18
+ ], {
19
+ stdio: [
20
+ 'pipe',
21
+ 'pipe',
22
+ 'pipe'
23
+ ],
24
+ env: {
25
+ ...process.env,
26
+ // Ensure stdio mode for MCP
27
+ MCP_MODE: 'stdio',
28
+ // Set log level to reduce noise
29
+ LOG_LEVEL: 'WARN'
30
+ }
31
+ });
32
+ let initialized = false;
33
+ let initTimeout;
34
+ // Handle stdout (JSON-RPC messages)
35
+ const rlOut = createInterface({
36
+ input: this.process.stdout,
37
+ crlfDelay: Infinity
38
+ });
39
+ rlOut.on('line', (line)=>{
40
+ try {
41
+ const message = JSON.parse(line);
42
+ // Check for initialization
43
+ if (message.method === 'server.initialized' && !initialized) {
44
+ initialized = true;
45
+ clearTimeout(initTimeout);
46
+ resolve({
47
+ process: this.process,
48
+ stdout: this.process.stdout,
49
+ stdin: this.process.stdin
50
+ });
51
+ }
52
+ // Forward JSON-RPC messages
53
+ process.stdout.write(line + '\n');
54
+ } catch (err) {
55
+ // Not JSON, ignore
56
+ }
57
+ });
58
+ // Handle stderr (logs and errors)
59
+ const rlErr = createInterface({
60
+ input: this.process.stderr,
61
+ crlfDelay: Infinity
62
+ });
63
+ rlErr.on('line', (line)=>{
64
+ // Parse structured error messages if available
65
+ try {
66
+ const errorData = JSON.parse(line);
67
+ if (errorData.error && errorData.error.code) {
68
+ // Handle specific error codes
69
+ switch(errorData.error.code){
70
+ case 'LOGGER_METHOD_MISSING':
71
+ case 'ERR_LOGGER_MEMORY_USAGE':
72
+ // Known issue with logger.logMemoryUsage in ruv-swarm
73
+ if (!this.options.silent) {
74
+ console.error('⚠️ Known ruv-swarm logger issue detected (continuing normally)');
75
+ }
76
+ return;
77
+ case 'ERR_INITIALIZATION':
78
+ console.error('❌ RuvSwarm initialization error:', errorData.error.message);
79
+ return;
80
+ default:
81
+ // Unknown error code, log it
82
+ if (!this.options.silent) {
83
+ console.error(`RuvSwarm error [${errorData.error.code}]:`, errorData.error.message);
84
+ }
85
+ }
86
+ return;
87
+ }
88
+ } catch (e) {
89
+ // Not JSON, check for known text patterns as fallback
90
+ const knownErrorPatterns = [
91
+ {
92
+ pattern: /logger\.logMemoryUsage is not a function/,
93
+ code: 'LOGGER_METHOD_MISSING',
94
+ message: 'Known ruv-swarm logger issue detected (continuing normally)'
95
+ },
96
+ {
97
+ pattern: /Cannot find module/,
98
+ code: 'MODULE_NOT_FOUND',
99
+ message: 'Module not found error'
100
+ },
101
+ {
102
+ pattern: /ECONNREFUSED/,
103
+ code: 'CONNECTION_REFUSED',
104
+ message: 'Connection refused error'
105
+ }
106
+ ];
107
+ for (const errorPattern of knownErrorPatterns){
108
+ if (errorPattern.pattern.test(line)) {
109
+ if (!this.options.silent || errorPattern.code !== 'LOGGER_METHOD_MISSING') {
110
+ console.error(`⚠️ ${errorPattern.message}`);
111
+ }
112
+ return;
113
+ }
114
+ }
115
+ }
116
+ // Filter out initialization messages if silent
117
+ if (this.options.silent) {
118
+ if (line.includes('✅') || line.includes('🧠') || line.includes('📊')) {
119
+ return;
120
+ }
121
+ }
122
+ // Forward other stderr output
123
+ if (!this.options.silent) {
124
+ process.stderr.write(line + '\n');
125
+ }
126
+ });
127
+ // Handle process errors
128
+ this.process.on('error', (error)=>{
129
+ if (!initialized) {
130
+ clearTimeout(initTimeout);
131
+ reject(new Error(`Failed to start ruv-swarm: ${error.message}`));
132
+ } else {
133
+ console.error('RuvSwarm process error:', error);
134
+ this.handleProcessExit(error.code || 1);
135
+ }
136
+ });
137
+ // Handle process exit
138
+ this.process.on('exit', (code, signal)=>{
139
+ if (!initialized) {
140
+ clearTimeout(initTimeout);
141
+ reject(new Error(`RuvSwarm exited before initialization: code ${code}, signal ${signal}`));
142
+ } else {
143
+ this.handleProcessExit(code || 0);
144
+ }
145
+ });
146
+ // Set initialization timeout
147
+ initTimeout = setTimeout(()=>{
148
+ if (!initialized) {
149
+ this.stop();
150
+ reject(new Error('RuvSwarm initialization timeout'));
151
+ }
152
+ }, 30000); // 30 second timeout
153
+ } catch (error) {
154
+ reject(error);
137
155
  }
138
- }
139
-
140
- // Filter out initialization messages if silent
141
- if (this.options.silent) {
142
- if (line.includes('✅') || line.includes('🧠') || line.includes('📊')) {
143
- return;
144
- }
145
- }
146
-
147
- // Forward other stderr output
148
- if (!this.options.silent) {
149
- process.stderr.write(line + '\n');
150
- }
151
- });
152
-
153
- // Handle process errors
154
- this.process.on('error', (error) => {
155
- if (!initialized) {
156
- clearTimeout(initTimeout);
157
- reject(new Error(`Failed to start ruv-swarm: ${error.message}`));
158
- } else {
159
- console.error('RuvSwarm process error:', error);
160
- this.handleProcessExit(error.code || 1);
161
- }
162
156
  });
163
-
164
- // Handle process exit
165
- this.process.on('exit', (code, signal) => {
166
- if (!initialized) {
167
- clearTimeout(initTimeout);
168
- reject(
169
- new Error(`RuvSwarm exited before initialization: code ${code}, signal ${signal}`),
170
- );
171
- } else {
172
- this.handleProcessExit(code || 0);
173
- }
174
- });
175
-
176
- // Set initialization timeout
177
- initTimeout = setTimeout(() => {
178
- if (!initialized) {
179
- this.stop();
180
- reject(new Error('RuvSwarm initialization timeout'));
181
- }
182
- }, 30000); // 30 second timeout
183
- } catch (error) {
184
- reject(error);
185
- }
186
- });
187
- }
188
-
189
- handleProcessExit(code) {
190
- this.process = null;
191
-
192
- if (this.isShuttingDown) {
193
- return;
194
157
  }
195
-
196
- console.error(`RuvSwarm MCP server exited with code ${code}`);
197
-
198
- // Auto-restart if enabled and under limit
199
- if (this.options.autoRestart && this.restartCount < this.options.maxRestarts) {
200
- this.restartCount++;
201
- console.log(
202
- `Attempting to restart RuvSwarm (attempt ${this.restartCount}/${this.options.maxRestarts})...`,
203
- );
204
-
205
- setTimeout(() => {
206
- this.start().catch((err) => {
207
- console.error('Failed to restart RuvSwarm:', err);
158
+ handleProcessExit(code) {
159
+ this.process = null;
160
+ if (this.isShuttingDown) {
161
+ return;
162
+ }
163
+ console.error(`RuvSwarm MCP server exited with code ${code}`);
164
+ // Auto-restart if enabled and under limit
165
+ if (this.options.autoRestart && this.restartCount < this.options.maxRestarts) {
166
+ this.restartCount++;
167
+ console.log(`Attempting to restart RuvSwarm (attempt ${this.restartCount}/${this.options.maxRestarts})...`);
168
+ setTimeout(()=>{
169
+ this.start().catch((err)=>{
170
+ console.error('Failed to restart RuvSwarm:', err);
171
+ });
172
+ }, this.options.restartDelay);
173
+ }
174
+ }
175
+ async stop() {
176
+ this.isShuttingDown = true;
177
+ if (!this.process) {
178
+ return;
179
+ }
180
+ return new Promise((resolve)=>{
181
+ const killTimeout = setTimeout(()=>{
182
+ console.warn('RuvSwarm did not exit gracefully, forcing kill...');
183
+ this.process.kill('SIGKILL');
184
+ }, 5000);
185
+ this.process.on('exit', ()=>{
186
+ clearTimeout(killTimeout);
187
+ this.process = null;
188
+ resolve();
189
+ });
190
+ // Send graceful shutdown signal
191
+ this.process.kill('SIGTERM');
208
192
  });
209
- }, this.options.restartDelay);
210
193
  }
211
- }
212
-
213
- async stop() {
214
- this.isShuttingDown = true;
215
-
216
- if (!this.process) {
217
- return;
194
+ isRunning() {
195
+ return this.process !== null && !this.process.killed;
218
196
  }
219
-
220
- return new Promise((resolve) => {
221
- const killTimeout = setTimeout(() => {
222
- console.warn('RuvSwarm did not exit gracefully, forcing kill...');
223
- this.process.kill('SIGKILL');
224
- }, 5000);
225
-
226
- this.process.on('exit', () => {
227
- clearTimeout(killTimeout);
197
+ constructor(options = {}){
198
+ this.options = {
199
+ silent: options.silent || false,
200
+ autoRestart: options.autoRestart !== false,
201
+ maxRestarts: options.maxRestarts || 3,
202
+ restartDelay: options.restartDelay || 1000,
203
+ ...options
204
+ };
228
205
  this.process = null;
229
- resolve();
230
- });
231
-
232
- // Send graceful shutdown signal
233
- this.process.kill('SIGTERM');
234
- });
235
- }
236
-
237
- isRunning() {
238
- return this.process !== null && !this.process.killed;
239
- }
206
+ this.restartCount = 0;
207
+ this.isShuttingDown = false;
208
+ }
240
209
  }
241
-
242
210
  // Export a function to start ruv-swarm with error handling
243
211
  export async function startRuvSwarmMCP(options = {}) {
244
- const wrapper = new RuvSwarmWrapper(options);
245
-
246
- try {
247
- const result = await wrapper.start();
248
- console.log('✅ RuvSwarm MCP server started successfully');
249
- return { wrapper, ...result };
250
- } catch (error) {
251
- console.error('❌ Failed to start RuvSwarm MCP server:', error.message);
252
- throw error;
253
- }
212
+ const wrapper = new RuvSwarmWrapper(options);
213
+ try {
214
+ const result = await wrapper.start();
215
+ console.log('✅ RuvSwarm MCP server started successfully');
216
+ return {
217
+ wrapper,
218
+ ...result
219
+ };
220
+ } catch (error) {
221
+ console.error('❌ Failed to start RuvSwarm MCP server:', error.message);
222
+ throw error;
223
+ }
254
224
  }