claude-flow

# Release Swarm - Intelligent Release Automation ## Overview Orchestrate complex software releases using AI swarms that handle everything from changelog generation to multi-platform deployment. ## Core Features ### 1. Release Planning ```bash # Plan next release npx ruv-swarm github release-plan \ --analyze-commits \ --suggest-version \ --identify-breaking \ --generate-timeline ``` ### 2. Automated Versioning ```bash # Smart version bumping npx ruv-swarm github release-version \ --strategy "semantic" \ --analyze-changes \ --check-breaking \ --update-files ``` ### 3. Release Orchestration ```bash # Full release automation npx ruv-swarm github release-create \ --version "2.0.0" \ --generate-changelog \ --build-artifacts \ --deploy-targets "npm,docker,github" \ --notify-stakeholders ``` ## Release Configuration ### Release Config File ```yaml # .github/release-swarm.yml version: 1 release: versioning: strategy: semantic breaking-keywords: ["BREAKING", "!"] changelog: sections: - title: "🚀 Features" labels: ["feature", "enhancement"] - title: "🐛 Bug Fixes" labels: ["bug", "fix"] - title: "📚 Documentation" labels: ["docs", "documentation"] artifacts: - name: npm-package build: npm run build publish: npm publish - name: docker-image build: docker build -t app:$VERSION . publish: docker push app:$VERSION - name: binaries build: ./scripts/build-binaries.sh upload: github-release deployment: environments: - name: staging auto-deploy: true validation: npm run test:e2e - name: production approval-required: true rollback-enabled: true notifications: - slack: releases-channel - email: stakeholders@company.com - discord: webhook-url ``` ## Release Agents ### Changelog Agent ```bash # Generate intelligent changelog npx ruv-swarm github changelog \ --from v1.0.0 \ --to HEAD \ --categorize \ --include-contributors \ --add-migration-guide ``` **Capabilities:** - Semantic commit analysis - Breaking change detection - Contributor attribution - Migration guide generation - Multi-language support ### Version Agent ```bash # Determine next version npx ruv-swarm github version-suggest \ --current v1.2.3 \ --analyze-commits \ --check-compatibility \ --suggest-pre-release ``` **Logic:** - Analyzes commit messages - Detects breaking changes - Suggests appropriate bump - Handles pre-releases - Validates version constraints ### Build Agent ```bash # Coordinate multi-platform builds npx ruv-swarm github release-build \ --platforms "linux,macos,windows" \ --architectures "x64,arm64" \ --parallel \ --optimize-size ``` **Features:** - Cross-platform compilation - Parallel build execution - Artifact optimization - Dependency bundling - Build caching ### Test Agent ```bash # Pre-release testing npx ruv-swarm github release-test \ --suites "unit,integration,e2e,performance" \ --environments "node:16,node:18,node:20" \ --fail-fast false \ --generate-report ``` ### Deploy Agent ```bash # Multi-target deployment npx ruv-swarm github release-deploy \ --targets "npm,docker,github,s3" \ --staged-rollout \ --monitor-metrics \ --auto-rollback ``` ## Advanced Features ### 1. Progressive Deployment ```yaml # Staged rollout configuration deployment: strategy: progressive stages: - name: canary percentage: 5 duration: 1h metrics: - error-rate < 0.1% - latency-p99 < 200ms - name: partial percentage: 25 duration: 4h validation: automated-tests - name: full percentage: 100 approval: required ``` ### 2. Multi-Repo Releases ```bash # Coordinate releases across repos npx ruv-swarm github multi-release \ --repos "frontend:v2.0.0,backend:v2.1.0,cli:v1.5.0" \ --ensure-compatibility \ --atomic-release \ --synchronized ``` ### 3. Hotfix Automation ```bash # Emergency hotfix process npx ruv-swarm github hotfix \ --issue 789 \ --target-version v1.2.4 \ --cherry-pick-commits \ --fast-track-deploy ``` ## Release Workflows ### Standard Release Flow ```yaml # .github/workflows/release.yml name: Release Workflow on: push: tags: ['v*'] jobs: release-swarm: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 with: fetch-depth: 0 - name: Initialize Release Swarm run: | npx ruv-swarm github release-init \ --tag ${{ github.ref_name }} \ --spawn-agents "changelog,version,build,test,deploy" - name: Generate Release Assets run: | npx ruv-swarm github release-assets \ --changelog \ --binaries \ --documentation - name: Publish Release run: | npx ruv-swarm github release-publish \ --platforms all \ --notify \ --update-docs ``` ### Continuous Deployment ```bash # Automated deployment pipeline npx ruv-swarm github cd-pipeline \ --trigger "merge-to-main" \ --auto-version \ --deploy-on-success \ --rollback-on-failure ``` ## Release Validation ### Pre-Release Checks ```bash # Comprehensive validation npx ruv-swarm github release-validate \ --checks " version-conflicts, dependency-compatibility, api-breaking-changes, security-vulnerabilities, performance-regression, documentation-completeness " \ --block-on-failure ``` ### Compatibility Testing ```bash # Test backward compatibility npx ruv-swarm github compat-test \ --previous-versions "v1.0,v1.1,v1.2" \ --api-contracts \ --data-migrations \ --generate-report ``` ### Security Scanning ```bash # Security validation npx ruv-swarm github release-security \ --scan-dependencies \ --check-secrets \ --audit-permissions \ --sign-artifacts ``` ## Monitoring & Rollback ### Release Monitoring ```bash # Monitor release health npx ruv-swarm github release-monitor \ --version v2.0.0 \ --metrics "error-rate,latency,throughput" \ --alert-thresholds \ --duration 24h ``` ### Automated Rollback ```bash # Configure auto-rollback npx ruv-swarm github rollback-config \ --triggers '{ "error-rate": ">5%", "latency-p99": ">1000ms", "availability": "<99.9%" }' \ --grace-period 5m \ --notify-on-rollback ``` ### Release Analytics ```bash # Analyze release performance npx ruv-swarm github release-analytics \ --version v2.0.0 \ --compare-with v1.9.0 \ --metrics "adoption,performance,stability" \ --generate-insights ``` ## Documentation ### Auto-Generated Docs ```bash # Update documentation npx ruv-swarm github release-docs \ --api-changes \ --migration-guide \ --example-updates \ --publish-to "docs-site,wiki" ``` ### Release Notes ```markdown  # Release v2.0.0 ## 🎉 Highlights - Major feature X with 50% performance improvement - New API endpoints for feature Y - Enhanced security with feature Z ## 🚀 Features ### Feature Name (#PR) Detailed description of the feature... ## 🐛 Bug Fixes ### Fixed issue with... (#PR) Description of the fix... ## 💥 Breaking Changes ### API endpoint renamed - Before: `/api/old-endpoint` - After: `/api/new-endpoint` - Migration: Update all client calls... ## 📈 Performance Improvements - Reduced memory usage by 30% - API response time improved by 200ms ## 🔒 Security Updates - Updated dependencies to patch CVE-XXXX - Enhanced authentication mechanism ## 📚 Documentation - Added examples for new features - Updated API reference - New troubleshooting guide ## 🙏 Contributors Thanks to all contributors who made this release possible! ``` ## Best Practices ### 1. Release Planning - Regular release cycles - Feature freeze periods - Beta testing phases - Clear communication ### 2. Automation - Comprehensive CI/CD - Automated testing - Progressive rollouts - Monitoring and alerts ### 3. Documentation - Up-to-date changelogs - Migration guides - API documentation - Example updates ## Integration Examples ### NPM Package Release ```bash # NPM package release npx ruv-swarm github npm-release \ --version patch \ --test-all \ --publish-beta \ --tag-latest-on-success ``` ### Docker Image Release ```bash # Docker multi-arch release npx ruv-swarm github docker-release \ --platforms "linux/amd64,linux/arm64" \ --tags "latest,v2.0.0,stable" \ --scan-vulnerabilities \ --push-to "dockerhub,gcr,ecr" ``` ### Mobile App Release ```bash # Mobile app store release npx ruv-swarm github mobile-release \ --platforms "ios,android" \ --build-release \ --submit-review \ --staged-rollout ``` ## Emergency Procedures ### Hotfix Process ```bash # Emergency hotfix npx ruv-swarm github emergency-release \ --severity critical \ --bypass-checks security-only \ --fast-track \ --notify-all ``` ### Rollback Procedure ```bash # Immediate rollback npx ruv-swarm github rollback \ --to-version v1.9.9 \ --reason "Critical bug in v2.0.0" \ --preserve-data \ --notify-users ``` See also: [workflow-automation.md](./workflow-automation.md), [multi-repo-swarm.md](./multi-repo-swarm.md)