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,7 +1,6 @@
1
1
  // roo-readme.js - README for .roo directory
2
-
3
2
  export function createRooReadme() {
4
- return `# .roo Directory - SPARC Development Environment
3
+ return `# .roo Directory - SPARC Development Environment
5
4
 
6
5
  This directory contains the SPARC (Specification, Pseudocode, Architecture, Refinement, Completion) development environment configuration and templates.
7
6
 
@@ -1,102 +1,125 @@
1
1
  // roomodes-config.js - Basic .roomodes configuration
2
-
3
2
  export function createBasicRoomodesConfig() {
4
- return JSON.stringify(
5
- {
6
- customModes: [
7
- {
8
- slug: 'architect',
9
- name: '🏗️ Architect',
10
- roleDefinition:
11
- 'You design scalable, secure, and modular architectures based on functional specs and user needs. You define responsibilities across services, APIs, and components.',
12
- customInstructions:
13
- 'Create architecture mermaid diagrams, data flows, and integration points. Ensure no part of the design includes secrets or hardcoded env values. Emphasize modular boundaries and maintain extensibility.',
14
- groups: ['read', 'edit'],
15
- source: 'project',
16
- },
17
- {
18
- slug: 'code',
19
- name: '🧠 Auto-Coder',
20
- roleDefinition:
21
- 'You write clean, efficient, modular code based on pseudocode and architecture. You use configuration for environments and break large components into maintainable files.',
22
- customInstructions:
23
- 'Write modular code using clean architecture principles. Never hardcode secrets or environment values. Split code into files < 500 lines. Use config files or environment abstractions. Use `new_task` for subtasks and finish with `attempt_completion`.',
24
- groups: ['read', 'edit', 'browser', 'mcp', 'command'],
25
- source: 'project',
26
- },
27
- {
28
- slug: 'tdd',
29
- name: '🧪 Tester (TDD)',
30
- roleDefinition:
31
- 'You implement Test-Driven Development (TDD, London School), writing tests first and refactoring after minimal implementation passes.',
32
- customInstructions:
33
- 'Write failing tests first. Implement only enough code to pass. Refactor after green. Ensure tests do not hardcode secrets. Keep files < 500 lines.',
34
- groups: ['read', 'edit', 'browser', 'mcp', 'command'],
35
- source: 'project',
36
- },
37
- {
38
- slug: 'spec-pseudocode',
39
- name: '📋 Specification Writer',
40
- roleDefinition:
41
- 'You capture full project context—functional requirements, edge cases, constraints—and translate that into modular pseudocode with TDD anchors.',
42
- customInstructions:
43
- 'Write pseudocode as a series of md files with phase_number_name.md and flow logic that includes clear structure for future coding and testing. Split complex logic across modules.',
44
- groups: ['read', 'edit'],
45
- source: 'project',
46
- },
47
- {
48
- slug: 'integration',
49
- name: '🔗 System Integrator',
50
- roleDefinition:
51
- 'You merge the outputs of all modes into a working, tested, production-ready system. You ensure consistency, cohesion, and modularity.',
52
- customInstructions:
53
- 'Verify interface compatibility, shared modules, and env config standards. Split integration logic across domains as needed. Use `new_task` for preflight testing.',
54
- groups: ['read', 'edit', 'browser', 'mcp', 'command'],
55
- source: 'project',
56
- },
57
- {
58
- slug: 'debug',
59
- name: '🪲 Debugger',
60
- roleDefinition:
61
- 'You troubleshoot runtime bugs, logic errors, or integration failures by tracing, inspecting, and analyzing behavior.',
62
- customInstructions:
63
- 'Use logs, traces, and stack analysis to isolate bugs. Avoid changing env configuration directly. Keep fixes modular.',
64
- groups: ['read', 'edit', 'browser', 'mcp', 'command'],
65
- source: 'project',
66
- },
67
- {
68
- slug: 'security-review',
69
- name: '🛡️ Security Reviewer',
70
- roleDefinition:
71
- 'You perform static and dynamic audits to ensure secure code practices. You flag secrets, poor modular boundaries, and oversized files.',
72
- customInstructions:
73
- 'Scan for exposed secrets, env leaks, and monoliths. Recommend mitigations or refactors to reduce risk. Flag files > 500 lines or direct environment coupling.',
74
- groups: ['read', 'edit'],
75
- source: 'project',
76
- },
77
- {
78
- slug: 'docs-writer',
79
- name: '📚 Documentation Writer',
80
- roleDefinition:
81
- 'You write concise, clear, and modular Markdown documentation that explains usage, integration, setup, and configuration.',
82
- customInstructions:
83
- 'Only work in .md files. Use sections, examples, and headings. Keep each file under 500 lines. Do not leak env values.',
84
- groups: ['read', ['edit', { fileRegex: '\\.md$', description: 'Markdown files only' }]],
85
- source: 'project',
86
- },
87
- {
88
- slug: 'swarm',
89
- name: '🐝 Swarm Coordinator',
90
- roleDefinition:
91
- 'You are the swarm coordination specialist, orchestrating multiple AI agents to handle complex, long-running tasks that would be difficult or impossible for a single agent due to scope, complexity, or timeout constraints.',
92
- customInstructions:
93
- 'Coordinate advanced multi-agent swarms with timeout-free execution capabilities. Analyze task complexity, select optimal strategies, configure coordination modes, manage background execution, and ensure quality standards across all agent outputs.',
94
- groups: ['read', 'edit', 'command'],
95
- source: 'project',
96
- },
97
- ],
98
- },
99
- null,
100
- 2,
101
- );
3
+ return JSON.stringify({
4
+ customModes: [
5
+ {
6
+ slug: 'architect',
7
+ name: '🏗️ Architect',
8
+ roleDefinition: 'You design scalable, secure, and modular architectures based on functional specs and user needs. You define responsibilities across services, APIs, and components.',
9
+ customInstructions: 'Create architecture mermaid diagrams, data flows, and integration points. Ensure no part of the design includes secrets or hardcoded env values. Emphasize modular boundaries and maintain extensibility.',
10
+ groups: [
11
+ 'read',
12
+ 'edit'
13
+ ],
14
+ source: 'project'
15
+ },
16
+ {
17
+ slug: 'code',
18
+ name: '🧠 Auto-Coder',
19
+ roleDefinition: 'You write clean, efficient, modular code based on pseudocode and architecture. You use configuration for environments and break large components into maintainable files.',
20
+ customInstructions: 'Write modular code using clean architecture principles. Never hardcode secrets or environment values. Split code into files < 500 lines. Use config files or environment abstractions. Use `new_task` for subtasks and finish with `attempt_completion`.',
21
+ groups: [
22
+ 'read',
23
+ 'edit',
24
+ 'browser',
25
+ 'mcp',
26
+ 'command'
27
+ ],
28
+ source: 'project'
29
+ },
30
+ {
31
+ slug: 'tdd',
32
+ name: '🧪 Tester (TDD)',
33
+ roleDefinition: 'You implement Test-Driven Development (TDD, London School), writing tests first and refactoring after minimal implementation passes.',
34
+ customInstructions: 'Write failing tests first. Implement only enough code to pass. Refactor after green. Ensure tests do not hardcode secrets. Keep files < 500 lines.',
35
+ groups: [
36
+ 'read',
37
+ 'edit',
38
+ 'browser',
39
+ 'mcp',
40
+ 'command'
41
+ ],
42
+ source: 'project'
43
+ },
44
+ {
45
+ slug: 'spec-pseudocode',
46
+ name: '📋 Specification Writer',
47
+ roleDefinition: 'You capture full project context—functional requirements, edge cases, constraints—and translate that into modular pseudocode with TDD anchors.',
48
+ customInstructions: 'Write pseudocode as a series of md files with phase_number_name.md and flow logic that includes clear structure for future coding and testing. Split complex logic across modules.',
49
+ groups: [
50
+ 'read',
51
+ 'edit'
52
+ ],
53
+ source: 'project'
54
+ },
55
+ {
56
+ slug: 'integration',
57
+ name: '🔗 System Integrator',
58
+ roleDefinition: 'You merge the outputs of all modes into a working, tested, production-ready system. You ensure consistency, cohesion, and modularity.',
59
+ customInstructions: 'Verify interface compatibility, shared modules, and env config standards. Split integration logic across domains as needed. Use `new_task` for preflight testing.',
60
+ groups: [
61
+ 'read',
62
+ 'edit',
63
+ 'browser',
64
+ 'mcp',
65
+ 'command'
66
+ ],
67
+ source: 'project'
68
+ },
69
+ {
70
+ slug: 'debug',
71
+ name: '🪲 Debugger',
72
+ roleDefinition: 'You troubleshoot runtime bugs, logic errors, or integration failures by tracing, inspecting, and analyzing behavior.',
73
+ customInstructions: 'Use logs, traces, and stack analysis to isolate bugs. Avoid changing env configuration directly. Keep fixes modular.',
74
+ groups: [
75
+ 'read',
76
+ 'edit',
77
+ 'browser',
78
+ 'mcp',
79
+ 'command'
80
+ ],
81
+ source: 'project'
82
+ },
83
+ {
84
+ slug: 'security-review',
85
+ name: '🛡️ Security Reviewer',
86
+ roleDefinition: 'You perform static and dynamic audits to ensure secure code practices. You flag secrets, poor modular boundaries, and oversized files.',
87
+ customInstructions: 'Scan for exposed secrets, env leaks, and monoliths. Recommend mitigations or refactors to reduce risk. Flag files > 500 lines or direct environment coupling.',
88
+ groups: [
89
+ 'read',
90
+ 'edit'
91
+ ],
92
+ source: 'project'
93
+ },
94
+ {
95
+ slug: 'docs-writer',
96
+ name: '📚 Documentation Writer',
97
+ roleDefinition: 'You write concise, clear, and modular Markdown documentation that explains usage, integration, setup, and configuration.',
98
+ customInstructions: 'Only work in .md files. Use sections, examples, and headings. Keep each file under 500 lines. Do not leak env values.',
99
+ groups: [
100
+ 'read',
101
+ [
102
+ 'edit',
103
+ {
104
+ fileRegex: '\\.md$',
105
+ description: 'Markdown files only'
106
+ }
107
+ ]
108
+ ],
109
+ source: 'project'
110
+ },
111
+ {
112
+ slug: 'swarm',
113
+ name: '🐝 Swarm Coordinator',
114
+ roleDefinition: 'You are the swarm coordination specialist, orchestrating multiple AI agents to handle complex, long-running tasks that would be difficult or impossible for a single agent due to scope, complexity, or timeout constraints.',
115
+ customInstructions: 'Coordinate advanced multi-agent swarms with timeout-free execution capabilities. Analyze task complexity, select optimal strategies, configure coordination modes, manage background execution, and ensure quality standards across all agent outputs.',
116
+ groups: [
117
+ 'read',
118
+ 'edit',
119
+ 'command'
120
+ ],
121
+ source: 'project'
122
+ }
123
+ ]
124
+ }, null, 2);
102
125
  }
@@ -1,40 +1,35 @@
1
1
  // workflows.js - SPARC workflow templates
2
-
3
2
  export function createBasicSparcWorkflow() {
4
- return JSON.stringify(
5
- {
6
- name: 'Basic TDD Workflow',
7
- description: 'A simple SPARC-based TDD workflow for development',
8
- sequential: true,
9
- steps: [
10
- {
11
- mode: 'spec-pseudocode',
12
- description: 'Create detailed specifications and pseudocode',
13
- phase: 'specification',
14
- },
15
- {
16
- mode: 'tdd',
17
- description: 'Write failing tests (Red phase)',
18
- phase: 'red',
19
- },
20
- {
21
- mode: 'code',
22
- description: 'Implement minimal code to pass tests (Green phase)',
23
- phase: 'green',
24
- },
25
- {
26
- mode: 'tdd',
27
- description: 'Refactor and optimize (Refactor phase)',
28
- phase: 'refactor',
29
- },
30
- {
31
- mode: 'integration',
32
- description: 'Integrate and verify complete solution',
33
- phase: 'integration',
34
- },
35
- ],
36
- },
37
- null,
38
- 2,
39
- );
3
+ return JSON.stringify({
4
+ name: 'Basic TDD Workflow',
5
+ description: 'A simple SPARC-based TDD workflow for development',
6
+ sequential: true,
7
+ steps: [
8
+ {
9
+ mode: 'spec-pseudocode',
10
+ description: 'Create detailed specifications and pseudocode',
11
+ phase: 'specification'
12
+ },
13
+ {
14
+ mode: 'tdd',
15
+ description: 'Write failing tests (Red phase)',
16
+ phase: 'red'
17
+ },
18
+ {
19
+ mode: 'code',
20
+ description: 'Implement minimal code to pass tests (Green phase)',
21
+ phase: 'green'
22
+ },
23
+ {
24
+ mode: 'tdd',
25
+ description: 'Refactor and optimize (Refactor phase)',
26
+ phase: 'refactor'
27
+ },
28
+ {
29
+ mode: 'integration',
30
+ description: 'Integrate and verify complete solution',
31
+ phase: 'integration'
32
+ }
33
+ ]
34
+ }, null, 2);
40
35
  }
@@ -1,68 +1,61 @@
1
1
  // sparc-structure.js - Create SPARC development structure
2
-
3
- import { createBasicRoomodesConfig } from './sparc/roomodes-config.js';
4
- import { errors } from '../../node-compat.js';
5
- import { promises as fs } from 'fs';
6
- import { createBasicSparcWorkflow } from './sparc/workflows.js';
7
- import { createRooReadme } from './sparc/roo-readme.js';
8
- import { createClaudeSlashCommands } from './claude-commands/slash-commands.js';
9
- import { cwd } from '../../node-compat.js';
10
- import process from 'process';
11
-
2
+ import { createBasicRoomodesConfig } from "./sparc/roomodes-config.js";
3
+ import { errors } from "../../node-compat.js";
4
+ import { promises as fs } from "fs";
5
+ import { createBasicSparcWorkflow } from "./sparc/workflows.js";
6
+ import { createRooReadme } from "./sparc/roo-readme.js";
7
+ import { createClaudeSlashCommands } from "./claude-commands/slash-commands.js";
8
+ import { cwd } from "../../node-compat.js";
9
+ import process from "process";
12
10
  // Helper function to create SPARC structure manually
13
11
  export async function createSparcStructureManually() {
14
- try {
15
- // Ensure we're in the working directory
16
- const workingDir = process.env.PWD || cwd();
17
-
18
- // Create .roo directory structure in working directory (legacy support)
19
- const rooDirectories = [
20
- `${workingDir}/.roo`,
21
- `${workingDir}/.roo/templates`,
22
- `${workingDir}/.roo/workflows`,
23
- `${workingDir}/.roo/modes`,
24
- `${workingDir}/.roo/configs`,
25
- ];
26
-
27
- for (const dir of rooDirectories) {
28
- try {
29
- await fs.mkdir(dir, { recursive: true });
30
- console.log(` ✓ Created ${dir}/`);
31
- } catch (err) {
32
- if (!(err instanceof errors.AlreadyExists)) {
33
- throw err;
34
- }
35
- }
36
- }
37
-
38
- // Create .roomodes file (copy from existing if available, or create basic version)
39
- let roomodesContent;
40
12
  try {
41
- // Check if .roomodes already exists and read it
42
- roomodesContent = await fs.readFile(`${workingDir}/.roomodes`, 'utf8');
43
- console.log(' ✓ Using existing .roomodes configuration');
44
- } catch {
45
- // Create basic .roomodes configuration
46
- roomodesContent = createBasicRoomodesConfig();
47
- await fs.writeFile(`${workingDir}/.roomodes`, roomodesContent, 'utf8');
48
- console.log(' ✓ Created .roomodes configuration');
13
+ // Ensure we're in the working directory
14
+ const workingDir = process.env.PWD || cwd();
15
+ // Create .roo directory structure in working directory (legacy support)
16
+ const rooDirectories = [
17
+ `${workingDir}/.roo`,
18
+ `${workingDir}/.roo/templates`,
19
+ `${workingDir}/.roo/workflows`,
20
+ `${workingDir}/.roo/modes`,
21
+ `${workingDir}/.roo/configs`
22
+ ];
23
+ for (const dir of rooDirectories){
24
+ try {
25
+ await fs.mkdir(dir, {
26
+ recursive: true
27
+ });
28
+ console.log(` ✓ Created ${dir}/`);
29
+ } catch (err) {
30
+ if (!(err instanceof errors.AlreadyExists)) {
31
+ throw err;
32
+ }
33
+ }
34
+ }
35
+ // Create .roomodes file (copy from existing if available, or create basic version)
36
+ let roomodesContent;
37
+ try {
38
+ // Check if .roomodes already exists and read it
39
+ roomodesContent = await fs.readFile(`${workingDir}/.roomodes`, 'utf8');
40
+ console.log(' ✓ Using existing .roomodes configuration');
41
+ } catch {
42
+ // Create basic .roomodes configuration
43
+ roomodesContent = createBasicRoomodesConfig();
44
+ await fs.writeFile(`${workingDir}/.roomodes`, roomodesContent, 'utf8');
45
+ console.log(' ✓ Created .roomodes configuration');
46
+ }
47
+ // Create basic workflow templates
48
+ const basicWorkflow = createBasicSparcWorkflow();
49
+ await fs.writeFile(`${workingDir}/.roo/workflows/basic-tdd.json`, basicWorkflow, 'utf8');
50
+ console.log(' ✓ Created .roo/workflows/basic-tdd.json');
51
+ // Create README for .roo directory
52
+ const rooReadme = createRooReadme();
53
+ await fs.writeFile(`${workingDir}/.roo/README.md`, rooReadme, 'utf8');
54
+ console.log(' ✓ Created .roo/README.md');
55
+ // Create Claude Code slash commands for SPARC modes
56
+ await createClaudeSlashCommands(workingDir);
57
+ console.log(' ✅ Basic SPARC structure created successfully');
58
+ } catch (err) {
59
+ console.log(` ❌ Failed to create SPARC structure: ${err.message}`);
49
60
  }
50
-
51
- // Create basic workflow templates
52
- const basicWorkflow = createBasicSparcWorkflow();
53
- await fs.writeFile(`${workingDir}/.roo/workflows/basic-tdd.json`, basicWorkflow, 'utf8');
54
- console.log(' ✓ Created .roo/workflows/basic-tdd.json');
55
-
56
- // Create README for .roo directory
57
- const rooReadme = createRooReadme();
58
- await fs.writeFile(`${workingDir}/.roo/README.md`, rooReadme, 'utf8');
59
- console.log(' ✓ Created .roo/README.md');
60
-
61
- // Create Claude Code slash commands for SPARC modes
62
- await createClaudeSlashCommands(workingDir);
63
-
64
- console.log(' ✅ Basic SPARC structure created successfully');
65
- } catch (err) {
66
- console.log(` ❌ Failed to create SPARC structure: ${err.message}`);
67
- }
68
61
  }