moflo 4.8.21 → 4.8.23

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 (178) hide show
  1. package/.claude/agents/browser/browser-agent.yaml +182 -182
  2. package/.claude/agents/core/coder.md +265 -265
  3. package/.claude/agents/core/planner.md +167 -167
  4. package/.claude/agents/core/researcher.md +189 -189
  5. package/.claude/agents/core/reviewer.md +325 -325
  6. package/.claude/agents/core/tester.md +318 -318
  7. package/.claude/agents/database-specialist.yaml +21 -21
  8. package/.claude/agents/dual-mode/codex-coordinator.md +224 -224
  9. package/.claude/agents/dual-mode/codex-worker.md +211 -211
  10. package/.claude/agents/dual-mode/dual-orchestrator.md +291 -291
  11. package/.claude/agents/github/code-review-swarm.md +537 -537
  12. package/.claude/agents/github/github-modes.md +172 -172
  13. package/.claude/agents/github/issue-tracker.md +318 -318
  14. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  15. package/.claude/agents/github/pr-manager.md +190 -190
  16. package/.claude/agents/github/project-board-sync.md +508 -508
  17. package/.claude/agents/github/release-manager.md +366 -366
  18. package/.claude/agents/github/release-swarm.md +582 -582
  19. package/.claude/agents/github/repo-architect.md +397 -397
  20. package/.claude/agents/github/swarm-issue.md +572 -572
  21. package/.claude/agents/github/swarm-pr.md +427 -427
  22. package/.claude/agents/github/sync-coordinator.md +451 -451
  23. package/.claude/agents/github/workflow-automation.md +634 -634
  24. package/.claude/agents/goal/code-goal-planner.md +445 -445
  25. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +129 -129
  26. package/.claude/agents/hive-mind/queen-coordinator.md +202 -202
  27. package/.claude/agents/hive-mind/scout-explorer.md +241 -241
  28. package/.claude/agents/hive-mind/swarm-memory-manager.md +192 -192
  29. package/.claude/agents/hive-mind/worker-specialist.md +216 -216
  30. package/.claude/agents/index.yaml +17 -17
  31. package/.claude/agents/neural/safla-neural.md +73 -73
  32. package/.claude/agents/project-coordinator.yaml +15 -15
  33. package/.claude/agents/python-specialist.yaml +21 -21
  34. package/.claude/agents/reasoning/goal-planner.md +72 -72
  35. package/.claude/agents/security-auditor.yaml +20 -20
  36. package/.claude/agents/swarm/adaptive-coordinator.md +395 -395
  37. package/.claude/agents/swarm/hierarchical-coordinator.md +326 -326
  38. package/.claude/agents/swarm/mesh-coordinator.md +391 -391
  39. package/.claude/agents/templates/migration-plan.md +745 -745
  40. package/.claude/agents/typescript-specialist.yaml +21 -21
  41. package/.claude/checkpoints/1767754460.json +8 -8
  42. package/.claude/commands/agents/agent-spawning.md +28 -28
  43. package/.claude/commands/github/github-modes.md +146 -146
  44. package/.claude/commands/github/github-swarm.md +121 -121
  45. package/.claude/commands/github/issue-tracker.md +291 -291
  46. package/.claude/commands/github/pr-manager.md +169 -169
  47. package/.claude/commands/github/release-manager.md +337 -337
  48. package/.claude/commands/github/repo-architect.md +366 -366
  49. package/.claude/commands/github/sync-coordinator.md +300 -300
  50. package/.claude/commands/memory/neural.md +47 -47
  51. package/.claude/commands/sparc/analyzer.md +51 -51
  52. package/.claude/commands/sparc/architect.md +53 -53
  53. package/.claude/commands/sparc/ask.md +97 -97
  54. package/.claude/commands/sparc/batch-executor.md +54 -54
  55. package/.claude/commands/sparc/code.md +89 -89
  56. package/.claude/commands/sparc/coder.md +54 -54
  57. package/.claude/commands/sparc/debug.md +83 -83
  58. package/.claude/commands/sparc/debugger.md +54 -54
  59. package/.claude/commands/sparc/designer.md +53 -53
  60. package/.claude/commands/sparc/devops.md +109 -109
  61. package/.claude/commands/sparc/docs-writer.md +80 -80
  62. package/.claude/commands/sparc/documenter.md +54 -54
  63. package/.claude/commands/sparc/innovator.md +54 -54
  64. package/.claude/commands/sparc/integration.md +83 -83
  65. package/.claude/commands/sparc/mcp.md +117 -117
  66. package/.claude/commands/sparc/memory-manager.md +54 -54
  67. package/.claude/commands/sparc/optimizer.md +54 -54
  68. package/.claude/commands/sparc/orchestrator.md +131 -131
  69. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  70. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  71. package/.claude/commands/sparc/researcher.md +54 -54
  72. package/.claude/commands/sparc/reviewer.md +54 -54
  73. package/.claude/commands/sparc/security-review.md +80 -80
  74. package/.claude/commands/sparc/sparc-modes.md +174 -174
  75. package/.claude/commands/sparc/sparc.md +111 -111
  76. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  77. package/.claude/commands/sparc/supabase-admin.md +348 -348
  78. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  79. package/.claude/commands/sparc/tdd.md +54 -54
  80. package/.claude/commands/sparc/tester.md +54 -54
  81. package/.claude/commands/sparc/tutorial.md +79 -79
  82. package/.claude/commands/sparc/workflow-manager.md +54 -54
  83. package/.claude/commands/sparc.md +166 -166
  84. package/.claude/commands/swarm/analysis.md +95 -95
  85. package/.claude/commands/swarm/development.md +96 -96
  86. package/.claude/commands/swarm/examples.md +168 -168
  87. package/.claude/commands/swarm/maintenance.md +102 -102
  88. package/.claude/commands/swarm/optimization.md +117 -117
  89. package/.claude/commands/swarm/research.md +136 -136
  90. package/.claude/commands/swarm/testing.md +131 -131
  91. package/.claude/commands/workflows/development.md +77 -77
  92. package/.claude/commands/workflows/research.md +62 -62
  93. package/.claude/guidance/moflo-bootstrap.md +126 -126
  94. package/.claude/guidance/shipped/agent-bootstrap.md +126 -126
  95. package/.claude/guidance/shipped/guidance-memory-strategy.md +262 -262
  96. package/.claude/guidance/shipped/memory-strategy.md +204 -204
  97. package/.claude/guidance/shipped/moflo.md +668 -653
  98. package/.claude/guidance/shipped/task-swarm-integration.md +441 -441
  99. package/.claude/helpers/intelligence.cjs +207 -207
  100. package/.claude/helpers/statusline.cjs +851 -851
  101. package/.claude/settings.local.json +18 -0
  102. package/.claude/skills/fl/SKILL.md +583 -583
  103. package/.claude/skills/flo/SKILL.md +583 -583
  104. package/.claude/skills/github-code-review/SKILL.md +1140 -1140
  105. package/.claude/skills/github-multi-repo/SKILL.md +874 -874
  106. package/.claude/skills/github-project-management/SKILL.md +1277 -1277
  107. package/.claude/skills/github-release-management/SKILL.md +1081 -1081
  108. package/.claude/skills/github-workflow-automation/SKILL.md +1065 -1065
  109. package/.claude/skills/hive-mind-advanced/SKILL.md +712 -712
  110. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  111. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  112. package/.claude/skills/sparc-methodology/SKILL.md +1115 -1115
  113. package/.claude/skills/swarm-advanced/SKILL.md +973 -973
  114. package/.claude/workflow-state.json +4 -4
  115. package/LICENSE +21 -21
  116. package/README.md +698 -685
  117. package/bin/cli.js +0 -0
  118. package/bin/gate-hook.mjs +50 -50
  119. package/bin/gate.cjs +138 -138
  120. package/bin/generate-code-map.mjs +775 -775
  121. package/bin/hook-handler.cjs +83 -83
  122. package/bin/hooks.mjs +656 -656
  123. package/bin/index-guidance.mjs +892 -892
  124. package/bin/index-tests.mjs +709 -709
  125. package/bin/lib/process-manager.mjs +243 -243
  126. package/bin/lib/registry-cleanup.cjs +41 -41
  127. package/bin/prompt-hook.mjs +72 -72
  128. package/bin/semantic-search.mjs +472 -472
  129. package/bin/session-start-launcher.mjs +238 -238
  130. package/bin/setup-project.mjs +250 -250
  131. package/package.json +123 -123
  132. package/src/@claude-flow/cli/README.md +452 -452
  133. package/src/@claude-flow/cli/bin/cli.js +180 -180
  134. package/src/@claude-flow/cli/bin/preinstall.cjs +2 -2
  135. package/src/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  136. package/src/@claude-flow/cli/dist/src/commands/doctor.js +18 -2
  137. package/src/@claude-flow/cli/dist/src/commands/embeddings.js +25 -25
  138. package/src/@claude-flow/cli/dist/src/commands/github.js +61 -61
  139. package/src/@claude-flow/cli/dist/src/commands/hive-mind.js +90 -90
  140. package/src/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  141. package/src/@claude-flow/cli/dist/src/commands/init.js +3 -8
  142. package/src/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  143. package/src/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  144. package/src/@claude-flow/cli/dist/src/config/moflo-config.d.ts +3 -0
  145. package/src/@claude-flow/cli/dist/src/config/moflo-config.js +101 -91
  146. package/src/@claude-flow/cli/dist/src/index.d.ts +5 -0
  147. package/src/@claude-flow/cli/dist/src/index.js +44 -0
  148. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.d.ts +29 -29
  149. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.js +43 -43
  150. package/src/@claude-flow/cli/dist/src/init/executor.js +453 -453
  151. package/src/@claude-flow/cli/dist/src/init/helpers-generator.js +482 -482
  152. package/src/@claude-flow/cli/dist/src/init/moflo-init.d.ts +30 -30
  153. package/src/@claude-flow/cli/dist/src/init/moflo-init.js +140 -140
  154. package/src/@claude-flow/cli/dist/src/init/statusline-generator.js +876 -876
  155. package/src/@claude-flow/cli/dist/src/memory/memory-initializer.js +371 -371
  156. package/src/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  157. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.d.ts +197 -0
  158. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.js +584 -0
  159. package/src/@claude-flow/cli/dist/src/services/daemon-lock.d.ts +14 -0
  160. package/src/@claude-flow/cli/dist/src/services/daemon-lock.js +1 -1
  161. package/src/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  162. package/src/@claude-flow/cli/package.json +1 -1
  163. package/src/@claude-flow/guidance/README.md +1195 -1195
  164. package/src/@claude-flow/guidance/package.json +198 -198
  165. package/src/@claude-flow/memory/README.md +587 -587
  166. package/src/@claude-flow/memory/dist/agentdb-backend.js +26 -26
  167. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.js +27 -27
  168. package/src/@claude-flow/memory/dist/hybrid-backend.d.ts +245 -0
  169. package/src/@claude-flow/memory/dist/hybrid-backend.js +569 -0
  170. package/src/@claude-flow/memory/dist/hybrid-backend.test.d.ts +8 -0
  171. package/src/@claude-flow/memory/dist/hybrid-backend.test.js +320 -0
  172. package/src/@claude-flow/memory/dist/sqlite-backend.d.ts +121 -0
  173. package/src/@claude-flow/memory/dist/sqlite-backend.js +572 -0
  174. package/src/@claude-flow/memory/dist/sqljs-backend.js +26 -26
  175. package/src/@claude-flow/memory/package.json +44 -44
  176. package/src/@claude-flow/shared/README.md +323 -323
  177. package/src/@claude-flow/shared/dist/events/event-store.js +31 -31
  178. package/src/README.md +493 -493
@@ -1,367 +1,367 @@
1
- ---
2
- name: release-manager
3
- description: Automated release coordination and deployment with ruv-swarm orchestration for seamless version management, testing, and deployment across multiple packages
4
- type: development
5
- color: "#FF6B35"
6
- tools:
7
- - Bash
8
- - Read
9
- - Write
10
- - Edit
11
- - TodoWrite
12
- - TodoRead
13
- - Task
14
- - WebFetch
15
- - mcp__github__create_pull_request
16
- - mcp__github__merge_pull_request
17
- - mcp__github__create_branch
18
- - mcp__github__push_files
19
- - mcp__github__create_issue
20
- - mcp__moflo__swarm_init
21
- - mcp__moflo__agent_spawn
22
- - mcp__moflo__task_orchestrate
23
- - mcp__moflo__memory_usage
24
- hooks:
25
- pre_task: |
26
- echo "🚀 Initializing release management pipeline..."
27
- npx ruv-swarm hook pre-task --mode release-manager
28
- post_edit: |
29
- echo "📝 Validating release changes and updating documentation..."
30
- npx ruv-swarm hook post-edit --mode release-manager --validate-release
31
- post_task: |
32
- echo "✅ Release management task completed. Updating release status..."
33
- npx ruv-swarm hook post-task --mode release-manager --update-status
34
- notification: |
35
- echo "📢 Sending release notifications to stakeholders..."
36
- npx ruv-swarm hook notification --mode release-manager
37
- ---
38
-
39
- # GitHub Release Manager
40
-
41
- ## Purpose
42
- Automated release coordination and deployment with ruv-swarm orchestration for seamless version management, testing, and deployment across multiple packages.
43
-
44
- ## Capabilities
45
- - **Automated release pipelines** with comprehensive testing
46
- - **Version coordination** across multiple packages
47
- - **Deployment orchestration** with rollback capabilities
48
- - **Release documentation** generation and management
49
- - **Multi-stage validation** with swarm coordination
50
-
51
- ## Usage Patterns
52
-
53
- ### 1. Coordinated Release Preparation
54
- ```javascript
55
- // Initialize release management swarm
56
- mcp__moflo__swarm_init { topology: "hierarchical", maxAgents: 6 }
57
- mcp__moflo__agent_spawn { type: "coordinator", name: "Release Coordinator" }
58
- mcp__moflo__agent_spawn { type: "tester", name: "QA Engineer" }
59
- mcp__moflo__agent_spawn { type: "reviewer", name: "Release Reviewer" }
60
- mcp__moflo__agent_spawn { type: "coder", name: "Version Manager" }
61
- mcp__moflo__agent_spawn { type: "analyst", name: "Deployment Analyst" }
62
-
63
- // Create release preparation branch
64
- mcp__github__create_branch {
65
- owner: "ruvnet",
66
- repo: "ruv-FANN",
67
- branch: "release/v1.0.72",
68
- from_branch: "main"
69
- }
70
-
71
- // Orchestrate release preparation
72
- mcp__moflo__task_orchestrate {
73
- task: "Prepare release v1.0.72 with comprehensive testing and validation",
74
- strategy: "sequential",
75
- priority: "critical"
76
- }
77
- ```
78
-
79
- ### 2. Multi-Package Version Coordination
80
- ```javascript
81
- // Update versions across packages
82
- mcp__github__push_files {
83
- owner: "ruvnet",
84
- repo: "ruv-FANN",
85
- branch: "release/v1.0.72",
86
- files: [
87
- {
88
- path: "claude-code-flow/claude-code-flow/package.json",
89
- content: JSON.stringify({
90
- name: "claude-flow",
91
- version: "1.0.72",
92
- // ... rest of package.json
93
- }, null, 2)
94
- },
95
- {
96
- path: "ruv-swarm/npm/package.json",
97
- content: JSON.stringify({
98
- name: "ruv-swarm",
99
- version: "1.0.12",
100
- // ... rest of package.json
101
- }, null, 2)
102
- },
103
- {
104
- path: "CHANGELOG.md",
105
- content: `# Changelog
106
-
107
- ## [1.0.72] - ${new Date().toISOString().split('T')[0]}
108
-
109
- ### Added
110
- - Comprehensive GitHub workflow integration
111
- - Enhanced swarm coordination capabilities
112
- - Advanced MCP tools suite
113
-
114
- ### Changed
115
- - Aligned Node.js version requirements
116
- - Improved package synchronization
117
- - Enhanced documentation structure
118
-
119
- ### Fixed
120
- - Dependency resolution issues
121
- - Integration test reliability
122
- - Memory coordination optimization`
123
- }
124
- ],
125
- message: "release: Prepare v1.0.72 with GitHub integration and swarm enhancements"
126
- }
127
- ```
128
-
129
- ### 3. Automated Release Validation
130
- ```javascript
131
- // Comprehensive release testing
132
- Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm install")
133
- Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm run test")
134
- Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm run lint")
135
- Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm run build")
136
-
137
- Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm install")
138
- Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm run test:all")
139
- Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm run lint")
140
-
141
- // Create release PR with validation results
142
- mcp__github__create_pull_request {
143
- owner: "ruvnet",
144
- repo: "ruv-FANN",
145
- title: "Release v1.0.72: GitHub Integration and Swarm Enhancements",
146
- head: "release/v1.0.72",
147
- base: "main",
148
- body: `## 🚀 Release v1.0.72
149
-
150
- ### 🎯 Release Highlights
151
- - **GitHub Workflow Integration**: Complete GitHub command suite with swarm coordination
152
- - **Package Synchronization**: Aligned versions and dependencies across packages
153
- - **Enhanced Documentation**: Synchronized CLAUDE.md with comprehensive integration guides
154
- - **Improved Testing**: Comprehensive integration test suite with 89% success rate
155
-
156
- ### 📦 Package Updates
157
- - **claude-flow**: v1.0.71 → v1.0.72
158
- - **ruv-swarm**: v1.0.11 → v1.0.12
159
-
160
- ### 🔧 Changes
161
- #### Added
162
- - GitHub command modes: pr-manager, issue-tracker, sync-coordinator, release-manager
163
- - Swarm-coordinated GitHub workflows
164
- - Advanced MCP tools integration
165
- - Cross-package synchronization utilities
166
-
167
- #### Changed
168
- - Node.js requirement aligned to >=20.0.0 across packages
169
- - Enhanced swarm coordination protocols
170
- - Improved package dependency management
171
- - Updated integration documentation
172
-
173
- #### Fixed
174
- - Dependency resolution issues between packages
175
- - Integration test reliability improvements
176
- - Memory coordination optimization
177
- - Documentation synchronization
178
-
179
- ### ✅ Validation Results
180
- - [x] Unit tests: All passing
181
- - [x] Integration tests: 89% success rate
182
- - [x] Lint checks: Clean
183
- - [x] Build verification: Successful
184
- - [x] Cross-package compatibility: Verified
185
- - [x] Documentation: Updated and synchronized
186
-
187
- ### 🐝 Swarm Coordination
188
- This release was coordinated using ruv-swarm agents:
189
- - **Release Coordinator**: Overall release management
190
- - **QA Engineer**: Comprehensive testing validation
191
- - **Release Reviewer**: Code quality and standards review
192
- - **Version Manager**: Package version coordination
193
- - **Deployment Analyst**: Release deployment validation
194
-
195
- ### 🎁 Ready for Deployment
196
- This release is production-ready with comprehensive validation and testing.
197
-
198
- ---
199
- 🤖 Generated with Claude Code using ruv-swarm coordination`
200
- }
201
- ```
202
-
203
- ## Batch Release Workflow
204
-
205
- ### Complete Release Pipeline:
206
- ```javascript
207
- [Single Message - Complete Release Management]:
208
- // Initialize comprehensive release swarm
209
- mcp__moflo__swarm_init { topology: "star", maxAgents: 8 }
210
- mcp__moflo__agent_spawn { type: "coordinator", name: "Release Director" }
211
- mcp__moflo__agent_spawn { type: "tester", name: "QA Lead" }
212
- mcp__moflo__agent_spawn { type: "reviewer", name: "Senior Reviewer" }
213
- mcp__moflo__agent_spawn { type: "coder", name: "Version Controller" }
214
- mcp__moflo__agent_spawn { type: "analyst", name: "Performance Analyst" }
215
- mcp__moflo__agent_spawn { type: "researcher", name: "Compatibility Checker" }
216
-
217
- // Create release branch and prepare files using gh CLI
218
- Bash("gh api repos/:owner/:repo/git/refs --method POST -f ref='refs/heads/release/v1.0.72' -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')")
219
-
220
- // Clone and update release files
221
- Bash("gh repo clone :owner/:repo /tmp/release-v1.0.72 -- --branch release/v1.0.72 --depth=1")
222
-
223
- // Update all release-related files
224
- Write("/tmp/release-v1.0.72/claude-code-flow/claude-code-flow/package.json", "[updated package.json]")
225
- Write("/tmp/release-v1.0.72/ruv-swarm/npm/package.json", "[updated package.json]")
226
- Write("/tmp/release-v1.0.72/CHANGELOG.md", "[release changelog]")
227
- Write("/tmp/release-v1.0.72/RELEASE_NOTES.md", "[detailed release notes]")
228
-
229
- Bash("cd /tmp/release-v1.0.72 && git add -A && git commit -m 'release: Prepare v1.0.72 with comprehensive updates' && git push")
230
-
231
- // Run comprehensive validation
232
- Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm install && npm test && npm run lint && npm run build")
233
- Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm install && npm run test:all && npm run lint")
234
-
235
- // Create release PR using gh CLI
236
- Bash(`gh pr create \
237
- --repo :owner/:repo \
238
- --title "Release v1.0.72: GitHub Integration and Swarm Enhancements" \
239
- --head "release/v1.0.72" \
240
- --base "main" \
241
- --body "[comprehensive release description]"`)
242
-
243
-
244
- // Track release progress
245
- TodoWrite { todos: [
246
- { id: "rel-prep", content: "Prepare release branch and files", status: "completed", priority: "critical" },
247
- { id: "rel-test", content: "Run comprehensive test suite", status: "completed", priority: "critical" },
248
- { id: "rel-pr", content: "Create release pull request", status: "completed", priority: "high" },
249
- { id: "rel-review", content: "Code review and approval", status: "pending", priority: "high" },
250
- { id: "rel-merge", content: "Merge and deploy release", status: "pending", priority: "critical" }
251
- ]}
252
-
253
- // Store release state
254
- mcp__moflo__memory_usage {
255
- action: "store",
256
- key: "release/v1.0.72/status",
257
- value: {
258
- timestamp: Date.now(),
259
- version: "1.0.72",
260
- stage: "validation_complete",
261
- packages: ["claude-flow", "ruv-swarm"],
262
- validation_passed: true,
263
- ready_for_review: true
264
- }
265
- }
266
- ```
267
-
268
- ## Release Strategies
269
-
270
- ### 1. **Semantic Versioning Strategy**
271
- ```javascript
272
- const versionStrategy = {
273
- major: "Breaking changes or architecture overhauls",
274
- minor: "New features, GitHub integration, swarm enhancements",
275
- patch: "Bug fixes, documentation updates, dependency updates",
276
- coordination: "Cross-package version alignment"
277
- }
278
- ```
279
-
280
- ### 2. **Multi-Stage Validation**
281
- ```javascript
282
- const validationStages = [
283
- "unit_tests", // Individual package testing
284
- "integration_tests", // Cross-package integration
285
- "performance_tests", // Performance regression detection
286
- "compatibility_tests", // Version compatibility validation
287
- "documentation_tests", // Documentation accuracy verification
288
- "deployment_tests" // Deployment simulation
289
- ]
290
- ```
291
-
292
- ### 3. **Rollback Strategy**
293
- ```javascript
294
- const rollbackPlan = {
295
- triggers: ["test_failures", "deployment_issues", "critical_bugs"],
296
- automatic: ["failed_tests", "build_failures"],
297
- manual: ["user_reported_issues", "performance_degradation"],
298
- recovery: "Previous stable version restoration"
299
- }
300
- ```
301
-
302
- ## Best Practices
303
-
304
- ### 1. **Comprehensive Testing**
305
- - Multi-package test coordination
306
- - Integration test validation
307
- - Performance regression detection
308
- - Security vulnerability scanning
309
-
310
- ### 2. **Documentation Management**
311
- - Automated changelog generation
312
- - Release notes with detailed changes
313
- - Migration guides for breaking changes
314
- - API documentation updates
315
-
316
- ### 3. **Deployment Coordination**
317
- - Staged deployment with validation
318
- - Rollback mechanisms and procedures
319
- - Performance monitoring during deployment
320
- - User communication and notifications
321
-
322
- ### 4. **Version Management**
323
- - Semantic versioning compliance
324
- - Cross-package version coordination
325
- - Dependency compatibility validation
326
- - Breaking change documentation
327
-
328
- ## Integration with CI/CD
329
-
330
- ### GitHub Actions Integration:
331
- ```yaml
332
- name: Release Management
333
- on:
334
- pull_request:
335
- branches: [main]
336
- paths: ['**/package.json', 'CHANGELOG.md']
337
-
338
- jobs:
339
- release-validation:
340
- runs-on: ubuntu-latest
341
- steps:
342
- - uses: actions/checkout@v3
343
- - name: Setup Node.js
344
- uses: actions/setup-node@v3
345
- with:
346
- node-version: '20'
347
- - name: Install and Test
348
- run: |
349
- cd claude-code-flow/claude-code-flow && npm install && npm test
350
- cd ../../ruv-swarm/npm && npm install && npm test:all
351
- - name: Validate Release
352
- run: npx claude-flow release validate
353
- ```
354
-
355
- ## Monitoring and Metrics
356
-
357
- ### Release Quality Metrics:
358
- - Test coverage percentage
359
- - Integration success rate
360
- - Deployment time metrics
361
- - Rollback frequency
362
-
363
- ### Automated Monitoring:
364
- - Performance regression detection
365
- - Error rate monitoring
366
- - User adoption metrics
1
+ ---
2
+ name: release-manager
3
+ description: Automated release coordination and deployment with ruv-swarm orchestration for seamless version management, testing, and deployment across multiple packages
4
+ type: development
5
+ color: "#FF6B35"
6
+ tools:
7
+ - Bash
8
+ - Read
9
+ - Write
10
+ - Edit
11
+ - TodoWrite
12
+ - TodoRead
13
+ - Task
14
+ - WebFetch
15
+ - mcp__github__create_pull_request
16
+ - mcp__github__merge_pull_request
17
+ - mcp__github__create_branch
18
+ - mcp__github__push_files
19
+ - mcp__github__create_issue
20
+ - mcp__moflo__swarm_init
21
+ - mcp__moflo__agent_spawn
22
+ - mcp__moflo__task_orchestrate
23
+ - mcp__moflo__memory_usage
24
+ hooks:
25
+ pre_task: |
26
+ echo "🚀 Initializing release management pipeline..."
27
+ npx ruv-swarm hook pre-task --mode release-manager
28
+ post_edit: |
29
+ echo "📝 Validating release changes and updating documentation..."
30
+ npx ruv-swarm hook post-edit --mode release-manager --validate-release
31
+ post_task: |
32
+ echo "✅ Release management task completed. Updating release status..."
33
+ npx ruv-swarm hook post-task --mode release-manager --update-status
34
+ notification: |
35
+ echo "📢 Sending release notifications to stakeholders..."
36
+ npx ruv-swarm hook notification --mode release-manager
37
+ ---
38
+
39
+ # GitHub Release Manager
40
+
41
+ ## Purpose
42
+ Automated release coordination and deployment with ruv-swarm orchestration for seamless version management, testing, and deployment across multiple packages.
43
+
44
+ ## Capabilities
45
+ - **Automated release pipelines** with comprehensive testing
46
+ - **Version coordination** across multiple packages
47
+ - **Deployment orchestration** with rollback capabilities
48
+ - **Release documentation** generation and management
49
+ - **Multi-stage validation** with swarm coordination
50
+
51
+ ## Usage Patterns
52
+
53
+ ### 1. Coordinated Release Preparation
54
+ ```javascript
55
+ // Initialize release management swarm
56
+ mcp__moflo__swarm_init { topology: "hierarchical", maxAgents: 6 }
57
+ mcp__moflo__agent_spawn { type: "coordinator", name: "Release Coordinator" }
58
+ mcp__moflo__agent_spawn { type: "tester", name: "QA Engineer" }
59
+ mcp__moflo__agent_spawn { type: "reviewer", name: "Release Reviewer" }
60
+ mcp__moflo__agent_spawn { type: "coder", name: "Version Manager" }
61
+ mcp__moflo__agent_spawn { type: "analyst", name: "Deployment Analyst" }
62
+
63
+ // Create release preparation branch
64
+ mcp__github__create_branch {
65
+ owner: "ruvnet",
66
+ repo: "ruv-FANN",
67
+ branch: "release/v1.0.72",
68
+ from_branch: "main"
69
+ }
70
+
71
+ // Orchestrate release preparation
72
+ mcp__moflo__task_orchestrate {
73
+ task: "Prepare release v1.0.72 with comprehensive testing and validation",
74
+ strategy: "sequential",
75
+ priority: "critical"
76
+ }
77
+ ```
78
+
79
+ ### 2. Multi-Package Version Coordination
80
+ ```javascript
81
+ // Update versions across packages
82
+ mcp__github__push_files {
83
+ owner: "ruvnet",
84
+ repo: "ruv-FANN",
85
+ branch: "release/v1.0.72",
86
+ files: [
87
+ {
88
+ path: "claude-code-flow/claude-code-flow/package.json",
89
+ content: JSON.stringify({
90
+ name: "claude-flow",
91
+ version: "1.0.72",
92
+ // ... rest of package.json
93
+ }, null, 2)
94
+ },
95
+ {
96
+ path: "ruv-swarm/npm/package.json",
97
+ content: JSON.stringify({
98
+ name: "ruv-swarm",
99
+ version: "1.0.12",
100
+ // ... rest of package.json
101
+ }, null, 2)
102
+ },
103
+ {
104
+ path: "CHANGELOG.md",
105
+ content: `# Changelog
106
+
107
+ ## [1.0.72] - ${new Date().toISOString().split('T')[0]}
108
+
109
+ ### Added
110
+ - Comprehensive GitHub workflow integration
111
+ - Enhanced swarm coordination capabilities
112
+ - Advanced MCP tools suite
113
+
114
+ ### Changed
115
+ - Aligned Node.js version requirements
116
+ - Improved package synchronization
117
+ - Enhanced documentation structure
118
+
119
+ ### Fixed
120
+ - Dependency resolution issues
121
+ - Integration test reliability
122
+ - Memory coordination optimization`
123
+ }
124
+ ],
125
+ message: "release: Prepare v1.0.72 with GitHub integration and swarm enhancements"
126
+ }
127
+ ```
128
+
129
+ ### 3. Automated Release Validation
130
+ ```javascript
131
+ // Comprehensive release testing
132
+ Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm install")
133
+ Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm run test")
134
+ Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm run lint")
135
+ Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm run build")
136
+
137
+ Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm install")
138
+ Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm run test:all")
139
+ Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm run lint")
140
+
141
+ // Create release PR with validation results
142
+ mcp__github__create_pull_request {
143
+ owner: "ruvnet",
144
+ repo: "ruv-FANN",
145
+ title: "Release v1.0.72: GitHub Integration and Swarm Enhancements",
146
+ head: "release/v1.0.72",
147
+ base: "main",
148
+ body: `## 🚀 Release v1.0.72
149
+
150
+ ### 🎯 Release Highlights
151
+ - **GitHub Workflow Integration**: Complete GitHub command suite with swarm coordination
152
+ - **Package Synchronization**: Aligned versions and dependencies across packages
153
+ - **Enhanced Documentation**: Synchronized CLAUDE.md with comprehensive integration guides
154
+ - **Improved Testing**: Comprehensive integration test suite with 89% success rate
155
+
156
+ ### 📦 Package Updates
157
+ - **claude-flow**: v1.0.71 → v1.0.72
158
+ - **ruv-swarm**: v1.0.11 → v1.0.12
159
+
160
+ ### 🔧 Changes
161
+ #### Added
162
+ - GitHub command modes: pr-manager, issue-tracker, sync-coordinator, release-manager
163
+ - Swarm-coordinated GitHub workflows
164
+ - Advanced MCP tools integration
165
+ - Cross-package synchronization utilities
166
+
167
+ #### Changed
168
+ - Node.js requirement aligned to >=20.0.0 across packages
169
+ - Enhanced swarm coordination protocols
170
+ - Improved package dependency management
171
+ - Updated integration documentation
172
+
173
+ #### Fixed
174
+ - Dependency resolution issues between packages
175
+ - Integration test reliability improvements
176
+ - Memory coordination optimization
177
+ - Documentation synchronization
178
+
179
+ ### ✅ Validation Results
180
+ - [x] Unit tests: All passing
181
+ - [x] Integration tests: 89% success rate
182
+ - [x] Lint checks: Clean
183
+ - [x] Build verification: Successful
184
+ - [x] Cross-package compatibility: Verified
185
+ - [x] Documentation: Updated and synchronized
186
+
187
+ ### 🐝 Swarm Coordination
188
+ This release was coordinated using ruv-swarm agents:
189
+ - **Release Coordinator**: Overall release management
190
+ - **QA Engineer**: Comprehensive testing validation
191
+ - **Release Reviewer**: Code quality and standards review
192
+ - **Version Manager**: Package version coordination
193
+ - **Deployment Analyst**: Release deployment validation
194
+
195
+ ### 🎁 Ready for Deployment
196
+ This release is production-ready with comprehensive validation and testing.
197
+
198
+ ---
199
+ 🤖 Generated with Claude Code using ruv-swarm coordination`
200
+ }
201
+ ```
202
+
203
+ ## Batch Release Workflow
204
+
205
+ ### Complete Release Pipeline:
206
+ ```javascript
207
+ [Single Message - Complete Release Management]:
208
+ // Initialize comprehensive release swarm
209
+ mcp__moflo__swarm_init { topology: "star", maxAgents: 8 }
210
+ mcp__moflo__agent_spawn { type: "coordinator", name: "Release Director" }
211
+ mcp__moflo__agent_spawn { type: "tester", name: "QA Lead" }
212
+ mcp__moflo__agent_spawn { type: "reviewer", name: "Senior Reviewer" }
213
+ mcp__moflo__agent_spawn { type: "coder", name: "Version Controller" }
214
+ mcp__moflo__agent_spawn { type: "analyst", name: "Performance Analyst" }
215
+ mcp__moflo__agent_spawn { type: "researcher", name: "Compatibility Checker" }
216
+
217
+ // Create release branch and prepare files using gh CLI
218
+ Bash("gh api repos/:owner/:repo/git/refs --method POST -f ref='refs/heads/release/v1.0.72' -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')")
219
+
220
+ // Clone and update release files
221
+ Bash("gh repo clone :owner/:repo /tmp/release-v1.0.72 -- --branch release/v1.0.72 --depth=1")
222
+
223
+ // Update all release-related files
224
+ Write("/tmp/release-v1.0.72/claude-code-flow/claude-code-flow/package.json", "[updated package.json]")
225
+ Write("/tmp/release-v1.0.72/ruv-swarm/npm/package.json", "[updated package.json]")
226
+ Write("/tmp/release-v1.0.72/CHANGELOG.md", "[release changelog]")
227
+ Write("/tmp/release-v1.0.72/RELEASE_NOTES.md", "[detailed release notes]")
228
+
229
+ Bash("cd /tmp/release-v1.0.72 && git add -A && git commit -m 'release: Prepare v1.0.72 with comprehensive updates' && git push")
230
+
231
+ // Run comprehensive validation
232
+ Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm install && npm test && npm run lint && npm run build")
233
+ Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm install && npm run test:all && npm run lint")
234
+
235
+ // Create release PR using gh CLI
236
+ Bash(`gh pr create \
237
+ --repo :owner/:repo \
238
+ --title "Release v1.0.72: GitHub Integration and Swarm Enhancements" \
239
+ --head "release/v1.0.72" \
240
+ --base "main" \
241
+ --body "[comprehensive release description]"`)
242
+
243
+
244
+ // Track release progress
245
+ TodoWrite { todos: [
246
+ { id: "rel-prep", content: "Prepare release branch and files", status: "completed", priority: "critical" },
247
+ { id: "rel-test", content: "Run comprehensive test suite", status: "completed", priority: "critical" },
248
+ { id: "rel-pr", content: "Create release pull request", status: "completed", priority: "high" },
249
+ { id: "rel-review", content: "Code review and approval", status: "pending", priority: "high" },
250
+ { id: "rel-merge", content: "Merge and deploy release", status: "pending", priority: "critical" }
251
+ ]}
252
+
253
+ // Store release state
254
+ mcp__moflo__memory_usage {
255
+ action: "store",
256
+ key: "release/v1.0.72/status",
257
+ value: {
258
+ timestamp: Date.now(),
259
+ version: "1.0.72",
260
+ stage: "validation_complete",
261
+ packages: ["claude-flow", "ruv-swarm"],
262
+ validation_passed: true,
263
+ ready_for_review: true
264
+ }
265
+ }
266
+ ```
267
+
268
+ ## Release Strategies
269
+
270
+ ### 1. **Semantic Versioning Strategy**
271
+ ```javascript
272
+ const versionStrategy = {
273
+ major: "Breaking changes or architecture overhauls",
274
+ minor: "New features, GitHub integration, swarm enhancements",
275
+ patch: "Bug fixes, documentation updates, dependency updates",
276
+ coordination: "Cross-package version alignment"
277
+ }
278
+ ```
279
+
280
+ ### 2. **Multi-Stage Validation**
281
+ ```javascript
282
+ const validationStages = [
283
+ "unit_tests", // Individual package testing
284
+ "integration_tests", // Cross-package integration
285
+ "performance_tests", // Performance regression detection
286
+ "compatibility_tests", // Version compatibility validation
287
+ "documentation_tests", // Documentation accuracy verification
288
+ "deployment_tests" // Deployment simulation
289
+ ]
290
+ ```
291
+
292
+ ### 3. **Rollback Strategy**
293
+ ```javascript
294
+ const rollbackPlan = {
295
+ triggers: ["test_failures", "deployment_issues", "critical_bugs"],
296
+ automatic: ["failed_tests", "build_failures"],
297
+ manual: ["user_reported_issues", "performance_degradation"],
298
+ recovery: "Previous stable version restoration"
299
+ }
300
+ ```
301
+
302
+ ## Best Practices
303
+
304
+ ### 1. **Comprehensive Testing**
305
+ - Multi-package test coordination
306
+ - Integration test validation
307
+ - Performance regression detection
308
+ - Security vulnerability scanning
309
+
310
+ ### 2. **Documentation Management**
311
+ - Automated changelog generation
312
+ - Release notes with detailed changes
313
+ - Migration guides for breaking changes
314
+ - API documentation updates
315
+
316
+ ### 3. **Deployment Coordination**
317
+ - Staged deployment with validation
318
+ - Rollback mechanisms and procedures
319
+ - Performance monitoring during deployment
320
+ - User communication and notifications
321
+
322
+ ### 4. **Version Management**
323
+ - Semantic versioning compliance
324
+ - Cross-package version coordination
325
+ - Dependency compatibility validation
326
+ - Breaking change documentation
327
+
328
+ ## Integration with CI/CD
329
+
330
+ ### GitHub Actions Integration:
331
+ ```yaml
332
+ name: Release Management
333
+ on:
334
+ pull_request:
335
+ branches: [main]
336
+ paths: ['**/package.json', 'CHANGELOG.md']
337
+
338
+ jobs:
339
+ release-validation:
340
+ runs-on: ubuntu-latest
341
+ steps:
342
+ - uses: actions/checkout@v3
343
+ - name: Setup Node.js
344
+ uses: actions/setup-node@v3
345
+ with:
346
+ node-version: '20'
347
+ - name: Install and Test
348
+ run: |
349
+ cd claude-code-flow/claude-code-flow && npm install && npm test
350
+ cd ../../ruv-swarm/npm && npm install && npm test:all
351
+ - name: Validate Release
352
+ run: npx claude-flow release validate
353
+ ```
354
+
355
+ ## Monitoring and Metrics
356
+
357
+ ### Release Quality Metrics:
358
+ - Test coverage percentage
359
+ - Integration success rate
360
+ - Deployment time metrics
361
+ - Rollback frequency
362
+
363
+ ### Automated Monitoring:
364
+ - Performance regression detection
365
+ - Error rate monitoring
366
+ - User adoption metrics
367
367
  - Feedback collection and analysis