moflo 4.9.20 → 4.9.22

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 (240) hide show
  1. package/.claude/agents/analysis/analyze-code-quality.md +0 -121
  2. package/.claude/agents/analysis/code-analyzer.md +5 -26
  3. package/.claude/agents/architecture/system-design/arch-system-design.md +0 -119
  4. package/.claude/agents/base-template-generator.md +0 -1
  5. package/.claude/agents/core/coder.md +0 -22
  6. package/.claude/agents/core/planner.md +0 -16
  7. package/.claude/agents/core/researcher.md +0 -16
  8. package/.claude/agents/core/reviewer.md +0 -17
  9. package/.claude/agents/core/tester.md +0 -19
  10. package/.claude/agents/custom/test-long-runner.md +0 -2
  11. package/.claude/agents/development/dev-backend-api.md +0 -167
  12. package/.claude/agents/development/dev-database.md +43 -0
  13. package/.claude/agents/development/dev-frontend.md +42 -0
  14. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +0 -112
  15. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +0 -111
  16. package/.claude/agents/security/security-auditor.md +45 -0
  17. package/.claude/guidance/shipped/moflo-agent-rules.md +172 -0
  18. package/.claude/guidance/shipped/moflo-claude-swarm-cohesion.md +73 -265
  19. package/.claude/guidance/shipped/moflo-cli-reference.md +6 -6
  20. package/.claude/guidance/shipped/moflo-core-guidance.md +66 -184
  21. package/.claude/guidance/shipped/moflo-cross-platform.md +1 -1
  22. package/.claude/guidance/shipped/moflo-error-handling.md +3 -3
  23. package/.claude/guidance/shipped/moflo-guidance-rules.md +17 -7
  24. package/.claude/guidance/shipped/moflo-memory-strategy.md +76 -182
  25. package/.claude/guidance/shipped/moflo-memorydb-maintenance.md +6 -8
  26. package/.claude/guidance/shipped/moflo-settings-injection.md +7 -9
  27. package/.claude/guidance/shipped/moflo-source-hygiene.md +5 -5
  28. package/.claude/guidance/shipped/moflo-spell-connectors.md +3 -4
  29. package/.claude/guidance/shipped/moflo-spell-custom-steps.md +3 -4
  30. package/.claude/guidance/shipped/moflo-spell-engine.md +40 -162
  31. package/.claude/guidance/shipped/moflo-spell-runner.md +134 -0
  32. package/.claude/guidance/shipped/moflo-spell-sandboxing.md +10 -57
  33. package/.claude/guidance/shipped/moflo-spell-troubleshooting.md +149 -0
  34. package/.claude/guidance/shipped/moflo-subagents.md +43 -114
  35. package/.claude/guidance/shipped/moflo-task-icons.md +4 -4
  36. package/.claude/guidance/shipped/moflo-user-facing-language.md +3 -3
  37. package/.claude/guidance/shipped/moflo-verbose-command-filtering.md +3 -3
  38. package/.claude/guidance/shipped/moflo-yaml-reference.md +4 -5
  39. package/.claude/helpers/gate.cjs +192 -15
  40. package/.claude/helpers/prompt-hook.mjs +4 -38
  41. package/.claude/helpers/simplify-classify.cjs +32 -11
  42. package/.claude/helpers/subagent-bootstrap.json +1 -1
  43. package/.claude/helpers/subagent-start.cjs +1 -1
  44. package/.claude/skills/connector-builder/SKILL.md +42 -429
  45. package/.claude/skills/connector-builder/templates/connector.md +189 -0
  46. package/.claude/skills/connector-builder/templates/step-command.md +176 -0
  47. package/.claude/skills/eldar/SKILL.md +7 -7
  48. package/.claude/skills/fl/SKILL.md +3 -3
  49. package/.claude/skills/fl/execution-modes.md +39 -16
  50. package/.claude/skills/fl/phases.md +3 -3
  51. package/.claude/skills/{simplify → flo-simplify}/SKILL.md +11 -11
  52. package/.claude/skills/guidance/SKILL.md +17 -9
  53. package/.claude/skills/memory-patterns/SKILL.md +1 -1
  54. package/.claude/skills/publish/SKILL.md +121 -36
  55. package/.claude/skills/reset-epic/SKILL.md +2 -2
  56. package/.claude/skills/spell-builder/SKILL.md +39 -226
  57. package/.claude/skills/spell-builder/architecture.md +1 -1
  58. package/.claude/skills/spell-builder/permissions.md +107 -0
  59. package/.claude/skills/spell-builder/preflight.md +101 -0
  60. package/.claude/skills/spell-schedule/SKILL.md +2 -3
  61. package/bin/gate.cjs +192 -15
  62. package/bin/lib/retired-files.mjs +146 -0
  63. package/bin/prompt-hook.mjs +4 -38
  64. package/bin/session-start-launcher.mjs +120 -1
  65. package/bin/setup-project.mjs +63 -69
  66. package/bin/simplify-classify.cjs +32 -11
  67. package/dist/src/cli/appliance/rvfa-builder.js +1 -1
  68. package/dist/src/cli/commands/agent.js +3 -9
  69. package/dist/src/cli/commands/doctor-checks-deep.js +4 -0
  70. package/dist/src/cli/commands/hooks.js +1 -3
  71. package/dist/src/cli/commands/index.js +2 -0
  72. package/dist/src/cli/commands/retire.js +111 -0
  73. package/dist/src/cli/hooks/reasoningbank/index.js +7 -7
  74. package/dist/src/cli/init/claudemd-generator.js +30 -33
  75. package/dist/src/cli/init/executor.js +53 -69
  76. package/dist/src/cli/init/helpers-generator.js +165 -52
  77. package/dist/src/cli/init/moflo-init.js +41 -114
  78. package/dist/src/cli/init/settings-generator.js +44 -14
  79. package/dist/src/cli/mcp-tools/agent-tools.js +9 -27
  80. package/dist/src/cli/mcp-tools/hooks-tools.js +23 -21
  81. package/dist/src/cli/memory/controllers/semantic-router.js +18 -12
  82. package/dist/src/cli/memory/sona-optimizer.js +6 -6
  83. package/dist/src/cli/neural/domain/services/learning-service.js +3 -3
  84. package/dist/src/cli/services/agent-router.js +2 -5
  85. package/dist/src/cli/services/hook-block-hash.js +11 -2
  86. package/dist/src/cli/services/hook-wiring.js +86 -3
  87. package/dist/src/cli/services/subagent-bootstrap.js +1 -1
  88. package/dist/src/cli/shared/events/example-usage.js +6 -6
  89. package/dist/src/cli/shared/hooks/task-hooks.js +8 -8
  90. package/dist/src/cli/version.js +1 -1
  91. package/package.json +3 -2
  92. package/retired-files.json +1989 -0
  93. package/scripts/post-install-bootstrap.mjs +19 -0
  94. package/src/cli/data/model-registry.json +2 -2
  95. package/.claude/agents/consensus/byzantine-coordinator.md +0 -63
  96. package/.claude/agents/consensus/crdt-synchronizer.md +0 -997
  97. package/.claude/agents/consensus/gossip-coordinator.md +0 -63
  98. package/.claude/agents/consensus/performance-benchmarker.md +0 -851
  99. package/.claude/agents/consensus/quorum-manager.md +0 -823
  100. package/.claude/agents/consensus/raft-manager.md +0 -63
  101. package/.claude/agents/consensus/security-manager.md +0 -622
  102. package/.claude/agents/data/ml/data-ml-model.md +0 -193
  103. package/.claude/agents/github/code-review-swarm.md +0 -538
  104. package/.claude/agents/github/github-modes.md +0 -172
  105. package/.claude/agents/github/issue-tracker.md +0 -311
  106. package/.claude/agents/github/multi-repo-swarm.md +0 -551
  107. package/.claude/agents/github/pr-manager.md +0 -183
  108. package/.claude/agents/github/project-board-sync.md +0 -508
  109. package/.claude/agents/github/release-manager.md +0 -360
  110. package/.claude/agents/github/release-swarm.md +0 -580
  111. package/.claude/agents/github/repo-architect.md +0 -391
  112. package/.claude/agents/github/swarm-issue.md +0 -566
  113. package/.claude/agents/github/swarm-pr.md +0 -414
  114. package/.claude/agents/github/sync-coordinator.md +0 -426
  115. package/.claude/agents/github/workflow-automation.md +0 -606
  116. package/.claude/agents/goal/code-goal-planner.md +0 -440
  117. package/.claude/agents/goal/goal-planner.md +0 -168
  118. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +0 -127
  119. package/.claude/agents/hive-mind/queen-coordinator.md +0 -198
  120. package/.claude/agents/hive-mind/scout-explorer.md +0 -233
  121. package/.claude/agents/hive-mind/swarm-memory-manager.md +0 -184
  122. package/.claude/agents/hive-mind/worker-specialist.md +0 -208
  123. package/.claude/agents/neural/safla-neural.md +0 -73
  124. package/.claude/agents/optimization/benchmark-suite.md +0 -665
  125. package/.claude/agents/optimization/load-balancer.md +0 -431
  126. package/.claude/agents/optimization/performance-monitor.md +0 -672
  127. package/.claude/agents/optimization/resource-allocator.md +0 -674
  128. package/.claude/agents/optimization/topology-optimizer.md +0 -808
  129. package/.claude/agents/reasoning/goal-planner.md +0 -67
  130. package/.claude/agents/sona/sona-learning-optimizer.md +0 -74
  131. package/.claude/agents/sparc/architecture.md +0 -472
  132. package/.claude/agents/sparc/pseudocode.md +0 -318
  133. package/.claude/agents/sparc/refinement.md +0 -525
  134. package/.claude/agents/sparc/specification.md +0 -276
  135. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +0 -225
  136. package/.claude/agents/swarm/adaptive-coordinator.md +0 -391
  137. package/.claude/agents/swarm/hierarchical-coordinator.md +0 -321
  138. package/.claude/agents/swarm/mesh-coordinator.md +0 -383
  139. package/.claude/agents/testing/production-validator.md +0 -395
  140. package/.claude/agents/testing/tdd-london-swarm.md +0 -244
  141. package/.claude/agents/v3/adr-architect.md +0 -184
  142. package/.claude/agents/v3/aidefence-guardian.md +0 -277
  143. package/.claude/agents/v3/claims-authorizer.md +0 -208
  144. package/.claude/agents/v3/collective-intelligence-coordinator.md +0 -988
  145. package/.claude/agents/v3/ddd-domain-expert.md +0 -220
  146. package/.claude/agents/v3/injection-analyst.md +0 -232
  147. package/.claude/agents/v3/memory-specialist.md +0 -987
  148. package/.claude/agents/v3/performance-engineer.md +0 -1225
  149. package/.claude/agents/v3/pii-detector.md +0 -146
  150. package/.claude/agents/v3/reasoningbank-learner.md +0 -213
  151. package/.claude/agents/v3/security-architect-aidefence.md +0 -405
  152. package/.claude/agents/v3/security-architect.md +0 -865
  153. package/.claude/agents/v3/security-auditor.md +0 -771
  154. package/.claude/agents/v3/sparc-orchestrator.md +0 -182
  155. package/.claude/agents/v3/swarm-memory-manager.md +0 -142
  156. package/.claude/agents/v3/v3-integration-architect.md +0 -205
  157. package/.claude/commands/claude-flow-help.md +0 -103
  158. package/.claude/commands/claude-flow-memory.md +0 -107
  159. package/.claude/commands/claude-flow-swarm.md +0 -205
  160. package/.claude/commands/github/README.md +0 -11
  161. package/.claude/commands/github/code-review-swarm.md +0 -514
  162. package/.claude/commands/github/code-review.md +0 -25
  163. package/.claude/commands/github/github-modes.md +0 -146
  164. package/.claude/commands/github/github-swarm.md +0 -113
  165. package/.claude/commands/github/issue-tracker.md +0 -284
  166. package/.claude/commands/github/issue-triage.md +0 -25
  167. package/.claude/commands/github/multi-repo-swarm.md +0 -519
  168. package/.claude/commands/github/pr-enhance.md +0 -26
  169. package/.claude/commands/github/pr-manager.md +0 -164
  170. package/.claude/commands/github/project-board-sync.md +0 -471
  171. package/.claude/commands/github/release-manager.md +0 -332
  172. package/.claude/commands/github/release-swarm.md +0 -544
  173. package/.claude/commands/github/repo-analyze.md +0 -25
  174. package/.claude/commands/github/repo-architect.md +0 -361
  175. package/.claude/commands/github/swarm-issue.md +0 -482
  176. package/.claude/commands/github/swarm-pr.md +0 -285
  177. package/.claude/commands/github/sync-coordinator.md +0 -294
  178. package/.claude/commands/github/workflow-automation.md +0 -442
  179. package/.claude/commands/hooks/README.md +0 -11
  180. package/.claude/commands/hooks/overview.md +0 -58
  181. package/.claude/commands/hooks/post-edit.md +0 -117
  182. package/.claude/commands/hooks/post-task.md +0 -112
  183. package/.claude/commands/hooks/pre-edit.md +0 -113
  184. package/.claude/commands/hooks/pre-task.md +0 -111
  185. package/.claude/commands/hooks/session-end.md +0 -118
  186. package/.claude/commands/hooks/setup.md +0 -103
  187. package/.claude/commands/simplify.md +0 -101
  188. package/.claude/commands/sparc/analyzer.md +0 -42
  189. package/.claude/commands/sparc/architect.md +0 -43
  190. package/.claude/commands/sparc/ask.md +0 -86
  191. package/.claude/commands/sparc/batch-executor.md +0 -44
  192. package/.claude/commands/sparc/code.md +0 -78
  193. package/.claude/commands/sparc/coder.md +0 -44
  194. package/.claude/commands/sparc/debug.md +0 -72
  195. package/.claude/commands/sparc/debugger.md +0 -44
  196. package/.claude/commands/sparc/designer.md +0 -43
  197. package/.claude/commands/sparc/devops.md +0 -98
  198. package/.claude/commands/sparc/docs-writer.md +0 -69
  199. package/.claude/commands/sparc/documenter.md +0 -44
  200. package/.claude/commands/sparc/innovator.md +0 -44
  201. package/.claude/commands/sparc/integration.md +0 -72
  202. package/.claude/commands/sparc/mcp.md +0 -106
  203. package/.claude/commands/sparc/memory-manager.md +0 -44
  204. package/.claude/commands/sparc/optimizer.md +0 -44
  205. package/.claude/commands/sparc/orchestrator.md +0 -116
  206. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +0 -72
  207. package/.claude/commands/sparc/refinement-optimization-mode.md +0 -72
  208. package/.claude/commands/sparc/researcher.md +0 -44
  209. package/.claude/commands/sparc/reviewer.md +0 -44
  210. package/.claude/commands/sparc/security-review.md +0 -69
  211. package/.claude/commands/sparc/sparc-modes.md +0 -139
  212. package/.claude/commands/sparc/sparc.md +0 -99
  213. package/.claude/commands/sparc/spec-pseudocode.md +0 -69
  214. package/.claude/commands/sparc/spell-manager.md +0 -44
  215. package/.claude/commands/sparc/supabase-admin.md +0 -337
  216. package/.claude/commands/sparc/swarm-coordinator.md +0 -44
  217. package/.claude/commands/sparc/tdd.md +0 -44
  218. package/.claude/commands/sparc/tester.md +0 -44
  219. package/.claude/commands/sparc/tutorial.md +0 -68
  220. package/.claude/commands/sparc.md +0 -151
  221. package/.claude/guidance/shipped/moflo-session-start.md +0 -154
  222. package/.claude/guidance/shipped/moflo-spell-engine-architecture.md +0 -145
  223. package/.claude/skills/browser/SKILL.md +0 -204
  224. package/.claude/skills/github-code-review/SKILL.md +0 -1140
  225. package/.claude/skills/github-multi-repo/SKILL.md +0 -866
  226. package/.claude/skills/github-project-management/SKILL.md +0 -1272
  227. package/.claude/skills/github-release-management/SKILL.md +0 -1074
  228. package/.claude/skills/github-workflow-automation/SKILL.md +0 -1060
  229. package/.claude/skills/hive-mind-advanced/SKILL.md +0 -712
  230. package/.claude/skills/hooks-automation/SKILL.md +0 -1193
  231. package/.claude/skills/pair-programming/SKILL.md +0 -1202
  232. package/.claude/skills/performance-analysis/SKILL.md +0 -563
  233. package/.claude/skills/skill-builder/SKILL.md +0 -910
  234. package/.claude/skills/sparc-methodology/SKILL.md +0 -904
  235. package/.claude/skills/stream-chain/SKILL.md +0 -563
  236. package/.claude/skills/swarm-advanced/SKILL.md +0 -811
  237. package/.claude/skills/swarm-orchestration/SKILL.md +0 -179
  238. package/.claude/skills/verification-quality/SKILL.md +0 -649
  239. package/.claude/skills/worker-benchmarks/skill.md +0 -135
  240. package/.claude/skills/worker-integration/skill.md +0 -154
@@ -1,544 +0,0 @@
1
- # Release Swarm - Intelligent Release Automation
2
-
3
- ## Overview
4
- Orchestrate complex software releases using AI swarms that handle everything from changelog generation to multi-platform deployment.
5
-
6
- ## Core Features
7
-
8
- ### 1. Release Planning
9
- ```bash
10
- # Plan next release using gh CLI
11
- # Get commit history since last release
12
- LAST_TAG=$(gh release list --limit 1 --json tagName -q '.[0].tagName')
13
- COMMITS=$(gh api repos/:owner/:repo/compare/${LAST_TAG}...HEAD --jq '.commits')
14
-
15
- # Get merged PRs
16
- MERGED_PRS=$(gh pr list --state merged --base main --json number,title,labels,mergedAt \
17
- --jq ".[] | select(.mergedAt > \"$(gh release view $LAST_TAG --json publishedAt -q .publishedAt)\")")
18
-
19
- # Plan release with commit analysis
20
- npx ruv-swarm github release-plan \
21
- --commits "$COMMITS" \
22
- --merged-prs "$MERGED_PRS" \
23
- --analyze-commits \
24
- --suggest-version \
25
- --identify-breaking \
26
- --generate-timeline
27
- ```
28
-
29
- ### 2. Automated Versioning
30
- ```bash
31
- # Smart version bumping
32
- npx ruv-swarm github release-version \
33
- --strategy "semantic" \
34
- --analyze-changes \
35
- --check-breaking \
36
- --update-files
37
- ```
38
-
39
- ### 3. Release Orchestration
40
- ```bash
41
- # Full release automation with gh CLI
42
- # Generate changelog from PRs and commits
43
- CHANGELOG=$(gh api repos/:owner/:repo/compare/${LAST_TAG}...HEAD \
44
- --jq '.commits[].commit.message' | \
45
- npx ruv-swarm github generate-changelog)
46
-
47
- # Create release draft
48
- gh release create v2.0.0 \
49
- --draft \
50
- --title "Release v2.0.0" \
51
- --notes "$CHANGELOG" \
52
- --target main
53
-
54
- # Run release orchestration
55
- npx ruv-swarm github release-create \
56
- --version "2.0.0" \
57
- --changelog "$CHANGELOG" \
58
- --build-artifacts \
59
- --deploy-targets "npm,docker,github"
60
-
61
- # Publish release after validation
62
- gh release edit v2.0.0 --draft=false
63
-
64
- # Create announcement issue
65
- gh issue create \
66
- --title "🎉 Released v2.0.0" \
67
- --body "$CHANGELOG" \
68
- --label "announcement,release"
69
- ```
70
-
71
- ## Release Configuration
72
-
73
- ### Release Config File
74
- ```yaml
75
- # .github/release-swarm.yml
76
- version: 1
77
- release:
78
- versioning:
79
- strategy: semantic
80
- breaking-keywords: ["BREAKING", "!"]
81
-
82
- changelog:
83
- sections:
84
- - title: "🚀 Features"
85
- labels: ["feature", "enhancement"]
86
- - title: "🐛 Bug Fixes"
87
- labels: ["bug", "fix"]
88
- - title: "📚 Documentation"
89
- labels: ["docs", "documentation"]
90
-
91
- artifacts:
92
- - name: npm-package
93
- build: npm run build
94
- publish: npm publish
95
-
96
- - name: docker-image
97
- build: docker build -t app:$VERSION .
98
- publish: docker push app:$VERSION
99
-
100
- - name: binaries
101
- build: ./scripts/build-binaries.sh
102
- upload: github-release
103
-
104
- deployment:
105
- environments:
106
- - name: staging
107
- auto-deploy: true
108
- validation: npm run test:e2e
109
-
110
- - name: production
111
- approval-required: true
112
- rollback-enabled: true
113
-
114
- notifications:
115
- - slack: releases-channel
116
- - email: stakeholders@company.com
117
- - discord: webhook-url
118
- ```
119
-
120
- ## Release Agents
121
-
122
- ### Changelog Agent
123
- ```bash
124
- # Generate intelligent changelog with gh CLI
125
- # Get all merged PRs between versions
126
- PRS=$(gh pr list --state merged --base main --json number,title,labels,author,mergedAt \
127
- --jq ".[] | select(.mergedAt > \"$(gh release view v1.0.0 --json publishedAt -q .publishedAt)\")")
128
-
129
- # Get contributors
130
- CONTRIBUTORS=$(echo "$PRS" | jq -r '[.author.login] | unique | join(", ")')
131
-
132
- # Get commit messages
133
- COMMITS=$(gh api repos/:owner/:repo/compare/v1.0.0...HEAD \
134
- --jq '.commits[].commit.message')
135
-
136
- # Generate categorized changelog
137
- CHANGELOG=$(npx ruv-swarm github changelog \
138
- --prs "$PRS" \
139
- --commits "$COMMITS" \
140
- --contributors "$CONTRIBUTORS" \
141
- --from v1.0.0 \
142
- --to HEAD \
143
- --categorize \
144
- --add-migration-guide)
145
-
146
- # Save changelog
147
- echo "$CHANGELOG" > CHANGELOG.md
148
-
149
- # Create PR with changelog update
150
- gh pr create \
151
- --title "docs: Update changelog for v2.0.0" \
152
- --body "Automated changelog update" \
153
- --base main
154
- ```
155
-
156
- **Capabilities:**
157
- - Semantic commit analysis
158
- - Breaking change detection
159
- - Contributor attribution
160
- - Migration guide generation
161
- - Multi-language support
162
-
163
- ### Version Agent
164
- ```bash
165
- # Determine next version
166
- npx ruv-swarm github version-suggest \
167
- --current v1.2.3 \
168
- --analyze-commits \
169
- --check-compatibility \
170
- --suggest-pre-release
171
- ```
172
-
173
- **Logic:**
174
- - Analyzes commit messages
175
- - Detects breaking changes
176
- - Suggests appropriate bump
177
- - Handles pre-releases
178
- - Validates version constraints
179
-
180
- ### Build Agent
181
- ```bash
182
- # Coordinate multi-platform builds
183
- npx ruv-swarm github release-build \
184
- --platforms "linux,macos,windows" \
185
- --architectures "x64,arm64" \
186
- --parallel \
187
- --optimize-size
188
- ```
189
-
190
- **Features:**
191
- - Cross-platform compilation
192
- - Parallel build execution
193
- - Artifact optimization
194
- - Dependency bundling
195
- - Build caching
196
-
197
- ### Test Agent
198
- ```bash
199
- # Pre-release testing
200
- npx ruv-swarm github release-test \
201
- --suites "unit,integration,e2e,performance" \
202
- --environments "node:16,node:18,node:20" \
203
- --fail-fast false \
204
- --generate-report
205
- ```
206
-
207
- ### Deploy Agent
208
- ```bash
209
- # Multi-target deployment
210
- npx ruv-swarm github release-deploy \
211
- --targets "npm,docker,github,s3" \
212
- --staged-rollout \
213
- --monitor-metrics \
214
- --auto-rollback
215
- ```
216
-
217
- ## Advanced Features
218
-
219
- ### 1. Progressive Deployment
220
- ```yaml
221
- # Staged rollout configuration
222
- deployment:
223
- strategy: progressive
224
- stages:
225
- - name: canary
226
- percentage: 5
227
- duration: 1h
228
- metrics:
229
- - error-rate < 0.1%
230
- - latency-p99 < 200ms
231
-
232
- - name: partial
233
- percentage: 25
234
- duration: 4h
235
- validation: automated-tests
236
-
237
- - name: full
238
- percentage: 100
239
- approval: required
240
- ```
241
-
242
- ### 2. Multi-Repo Releases
243
- ```bash
244
- # Coordinate releases across repos
245
- npx ruv-swarm github multi-release \
246
- --repos "frontend:v2.0.0,backend:v2.1.0,cli:v1.5.0" \
247
- --ensure-compatibility \
248
- --atomic-release \
249
- --synchronized
250
- ```
251
-
252
- ### 3. Hotfix Automation
253
- ```bash
254
- # Emergency hotfix process
255
- npx ruv-swarm github hotfix \
256
- --issue 789 \
257
- --target-version v1.2.4 \
258
- --cherry-pick-commits \
259
- --fast-track-deploy
260
- ```
261
-
262
- ## Release Workflows
263
-
264
- ### Standard Release Flow
265
- ```yaml
266
- # .github/workflows/release.yml
267
- name: Release Workflow
268
- on:
269
- push:
270
- tags: ['v*']
271
-
272
- jobs:
273
- release-swarm:
274
- runs-on: ubuntu-latest
275
- steps:
276
- - uses: actions/checkout@v3
277
- with:
278
- fetch-depth: 0
279
-
280
- - name: Setup GitHub CLI
281
- run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token
282
-
283
- - name: Initialize Release Swarm
284
- run: |
285
- # Get release tag and previous tag
286
- RELEASE_TAG=${{ github.ref_name }}
287
- PREV_TAG=$(gh release list --limit 2 --json tagName -q '.[1].tagName')
288
-
289
- # Get PRs and commits for changelog
290
- PRS=$(gh pr list --state merged --base main --json number,title,labels,author \
291
- --search "merged:>=$(gh release view $PREV_TAG --json publishedAt -q .publishedAt)")
292
-
293
- npx ruv-swarm github release-init \
294
- --tag $RELEASE_TAG \
295
- --previous-tag $PREV_TAG \
296
- --prs "$PRS" \
297
- --spawn-agents "changelog,version,build,test,deploy"
298
-
299
- - name: Generate Release Assets
300
- run: |
301
- # Generate changelog from PR data
302
- CHANGELOG=$(npx ruv-swarm github release-changelog \
303
- --format markdown)
304
-
305
- # Update release notes
306
- gh release edit ${{ github.ref_name }} \
307
- --notes "$CHANGELOG"
308
-
309
- # Generate and upload assets
310
- npx ruv-swarm github release-assets \
311
- --changelog \
312
- --binaries \
313
- --documentation
314
-
315
- - name: Upload Release Assets
316
- run: |
317
- # Upload generated assets to GitHub release
318
- for file in dist/*; do
319
- gh release upload ${{ github.ref_name }} "$file"
320
- done
321
-
322
- - name: Publish Release
323
- run: |
324
- # Publish to package registries
325
- npx ruv-swarm github release-publish \
326
- --platforms all
327
-
328
- # Create announcement issue
329
- gh issue create \
330
- --title "🚀 Released ${{ github.ref_name }}" \
331
- --body "See [release notes](https://github.com/${{ github.repository }}/releases/tag/${{ github.ref_name }})" \
332
- --label "announcement"
333
- ```
334
-
335
- ### Continuous Deployment
336
- ```bash
337
- # Automated deployment pipeline
338
- npx ruv-swarm github cd-pipeline \
339
- --trigger "merge-to-main" \
340
- --auto-version \
341
- --deploy-on-success \
342
- --rollback-on-failure
343
- ```
344
-
345
- ## Release Validation
346
-
347
- ### Pre-Release Checks
348
- ```bash
349
- # Comprehensive validation
350
- npx ruv-swarm github release-validate \
351
- --checks "
352
- version-conflicts,
353
- dependency-compatibility,
354
- api-breaking-changes,
355
- security-vulnerabilities,
356
- performance-regression,
357
- documentation-completeness
358
- " \
359
- --block-on-failure
360
- ```
361
-
362
- ### Compatibility Testing
363
- ```bash
364
- # Test backward compatibility
365
- npx ruv-swarm github compat-test \
366
- --previous-versions "v1.0,v1.1,v1.2" \
367
- --api-contracts \
368
- --data-migrations \
369
- --generate-report
370
- ```
371
-
372
- ### Security Scanning
373
- ```bash
374
- # Security validation
375
- npx ruv-swarm github release-security \
376
- --scan-dependencies \
377
- --check-secrets \
378
- --audit-permissions \
379
- --sign-artifacts
380
- ```
381
-
382
- ## Monitoring & Rollback
383
-
384
- ### Release Monitoring
385
- ```bash
386
- # Monitor release health
387
- npx ruv-swarm github release-monitor \
388
- --version v2.0.0 \
389
- --metrics "error-rate,latency,throughput" \
390
- --alert-thresholds \
391
- --duration 24h
392
- ```
393
-
394
- ### Automated Rollback
395
- ```bash
396
- # Configure auto-rollback
397
- npx ruv-swarm github rollback-config \
398
- --triggers '{
399
- "error-rate": ">5%",
400
- "latency-p99": ">1000ms",
401
- "availability": "<99.9%"
402
- }' \
403
- --grace-period 5m \
404
- --notify-on-rollback
405
- ```
406
-
407
- ### Release Analytics
408
- ```bash
409
- # Analyze release performance
410
- npx ruv-swarm github release-analytics \
411
- --version v2.0.0 \
412
- --compare-with v1.9.0 \
413
- --metrics "adoption,performance,stability" \
414
- --generate-insights
415
- ```
416
-
417
- ## Documentation
418
-
419
- ### Auto-Generated Docs
420
- ```bash
421
- # Update documentation
422
- npx ruv-swarm github release-docs \
423
- --api-changes \
424
- --migration-guide \
425
- --example-updates \
426
- --publish-to "docs-site,wiki"
427
- ```
428
-
429
- ### Release Notes
430
- ```markdown
431
- <!-- Auto-generated release notes template -->
432
- # Release v2.0.0
433
-
434
- ## 🎉 Highlights
435
- - Major feature X with 50% performance improvement
436
- - New API endpoints for feature Y
437
- - Enhanced security with feature Z
438
-
439
- ## 🚀 Features
440
- ### Feature Name (#PR)
441
- Detailed description of the feature...
442
-
443
- ## 🐛 Bug Fixes
444
- ### Fixed issue with... (#PR)
445
- Description of the fix...
446
-
447
- ## 💥 Breaking Changes
448
- ### API endpoint renamed
449
- - Before: `/api/old-endpoint`
450
- - After: `/api/new-endpoint`
451
- - Migration: Update all client calls...
452
-
453
- ## 📈 Performance Improvements
454
- - Reduced memory usage by 30%
455
- - API response time improved by 200ms
456
-
457
- ## 🔒 Security Updates
458
- - Updated dependencies to patch CVE-XXXX
459
- - Enhanced authentication mechanism
460
-
461
- ## 📚 Documentation
462
- - Added examples for new features
463
- - Updated API reference
464
- - New troubleshooting guide
465
-
466
- ## 🙏 Contributors
467
- Thanks to all contributors who made this release possible!
468
- ```
469
-
470
- ## Best Practices
471
-
472
- ### 1. Release Planning
473
- - Regular release cycles
474
- - Feature freeze periods
475
- - Beta testing phases
476
- - Clear communication
477
-
478
- ### 2. Automation
479
- - Comprehensive CI/CD
480
- - Automated testing
481
- - Progressive rollouts
482
- - Monitoring and alerts
483
-
484
- ### 3. Documentation
485
- - Up-to-date changelogs
486
- - Migration guides
487
- - API documentation
488
- - Example updates
489
-
490
- ## Integration Examples
491
-
492
- ### NPM Package Release
493
- ```bash
494
- # NPM package release
495
- npx ruv-swarm github npm-release \
496
- --version patch \
497
- --test-all \
498
- --publish-beta \
499
- --tag-latest-on-success
500
- ```
501
-
502
- ### Docker Image Release
503
- ```bash
504
- # Docker multi-arch release
505
- npx ruv-swarm github docker-release \
506
- --platforms "linux/amd64,linux/arm64" \
507
- --tags "latest,v2.0.0,stable" \
508
- --scan-vulnerabilities \
509
- --push-to "dockerhub,gcr,ecr"
510
- ```
511
-
512
- ### Mobile App Release
513
- ```bash
514
- # Mobile app store release
515
- npx ruv-swarm github mobile-release \
516
- --platforms "ios,android" \
517
- --build-release \
518
- --submit-review \
519
- --staged-rollout
520
- ```
521
-
522
- ## Emergency Procedures
523
-
524
- ### Hotfix Process
525
- ```bash
526
- # Emergency hotfix
527
- npx ruv-swarm github emergency-release \
528
- --severity critical \
529
- --bypass-checks security-only \
530
- --fast-track \
531
- --notify-all
532
- ```
533
-
534
- ### Rollback Procedure
535
- ```bash
536
- # Immediate rollback
537
- npx ruv-swarm github rollback \
538
- --to-version v1.9.9 \
539
- --reason "Critical bug in v2.0.0" \
540
- --preserve-data \
541
- --notify-users
542
- ```
543
-
544
- See also: [workflow-automation.md](./workflow-automation.md), [multi-repo-swarm.md](./multi-repo-swarm.md)
@@ -1,25 +0,0 @@
1
- # repo-analyze
2
-
3
- Deep analysis of GitHub repository with AI insights.
4
-
5
- ## Usage
6
- ```bash
7
- npx claude-flow github repo-analyze [options]
8
- ```
9
-
10
- ## Options
11
- - `--repository <owner/repo>` - Repository to analyze
12
- - `--deep` - Enable deep analysis
13
- - `--include <areas>` - Include specific areas (issues, prs, code, commits)
14
-
15
- ## Examples
16
- ```bash
17
- # Basic analysis
18
- npx claude-flow github repo-analyze --repository myorg/myrepo
19
-
20
- # Deep analysis
21
- npx claude-flow github repo-analyze --repository myorg/myrepo --deep
22
-
23
- # Specific areas
24
- npx claude-flow github repo-analyze --repository myorg/myrepo --include issues,prs
25
- ```