feat: CRM Clinicas SaaS - MVP completo
- Auth: Login/Register con creacion de clinica - Dashboard: KPIs reales, graficas recharts - Pacientes: CRUD completo con busqueda - Agenda: FullCalendar, drag-and-drop, vista recepcion - Expediente: Notas SOAP, signos vitales, CIE-10 - Facturacion: Facturas con IVA, campos CFDI SAT - Inventario: Productos, stock, movimientos, alertas - Configuracion: Clinica, equipo, catalogo servicios - Supabase self-hosted: 18 tablas con RLS multi-tenant - Docker + Nginx para produccion Co-Authored-By: claude-flow <ruv@ruv.net>
This commit is contained in:
Consultoria AS
544
.claude/commands/github/release-swarm.md
Normal file
544
.claude/commands/github/release-swarm.md
Normal file
@@ -0,0 +1,544 @@
|
||||
# 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 using gh CLI
|
||||
# Get commit history since last release
|
||||
LAST_TAG=$(gh release list --limit 1 --json tagName -q '.[0].tagName')
|
||||
COMMITS=$(gh api repos/:owner/:repo/compare/${LAST_TAG}...HEAD --jq '.commits')
|
||||
|
||||
# Get merged PRs
|
||||
MERGED_PRS=$(gh pr list --state merged --base main --json number,title,labels,mergedAt \
|
||||
--jq ".[] | select(.mergedAt > \"$(gh release view $LAST_TAG --json publishedAt -q .publishedAt)\")")
|
||||
|
||||
# Plan release with commit analysis
|
||||
npx ruv-swarm github release-plan \
|
||||
--commits "$COMMITS" \
|
||||
--merged-prs "$MERGED_PRS" \
|
||||
--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 with gh CLI
|
||||
# Generate changelog from PRs and commits
|
||||
CHANGELOG=$(gh api repos/:owner/:repo/compare/${LAST_TAG}...HEAD \
|
||||
--jq '.commits[].commit.message' | \
|
||||
npx ruv-swarm github generate-changelog)
|
||||
|
||||
# Create release draft
|
||||
gh release create v2.0.0 \
|
||||
--draft \
|
||||
--title "Release v2.0.0" \
|
||||
--notes "$CHANGELOG" \
|
||||
--target main
|
||||
|
||||
# Run release orchestration
|
||||
npx ruv-swarm github release-create \
|
||||
--version "2.0.0" \
|
||||
--changelog "$CHANGELOG" \
|
||||
--build-artifacts \
|
||||
--deploy-targets "npm,docker,github"
|
||||
|
||||
# Publish release after validation
|
||||
gh release edit v2.0.0 --draft=false
|
||||
|
||||
# Create announcement issue
|
||||
gh issue create \
|
||||
--title "🎉 Released v2.0.0" \
|
||||
--body "$CHANGELOG" \
|
||||
--label "announcement,release"
|
||||
```
|
||||
|
||||
## 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 with gh CLI
|
||||
# Get all merged PRs between versions
|
||||
PRS=$(gh pr list --state merged --base main --json number,title,labels,author,mergedAt \
|
||||
--jq ".[] | select(.mergedAt > \"$(gh release view v1.0.0 --json publishedAt -q .publishedAt)\")")
|
||||
|
||||
# Get contributors
|
||||
CONTRIBUTORS=$(echo "$PRS" | jq -r '[.author.login] | unique | join(", ")')
|
||||
|
||||
# Get commit messages
|
||||
COMMITS=$(gh api repos/:owner/:repo/compare/v1.0.0...HEAD \
|
||||
--jq '.commits[].commit.message')
|
||||
|
||||
# Generate categorized changelog
|
||||
CHANGELOG=$(npx ruv-swarm github changelog \
|
||||
--prs "$PRS" \
|
||||
--commits "$COMMITS" \
|
||||
--contributors "$CONTRIBUTORS" \
|
||||
--from v1.0.0 \
|
||||
--to HEAD \
|
||||
--categorize \
|
||||
--add-migration-guide)
|
||||
|
||||
# Save changelog
|
||||
echo "$CHANGELOG" > CHANGELOG.md
|
||||
|
||||
# Create PR with changelog update
|
||||
gh pr create \
|
||||
--title "docs: Update changelog for v2.0.0" \
|
||||
--body "Automated changelog update" \
|
||||
--base main
|
||||
```
|
||||
|
||||
**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: Setup GitHub CLI
|
||||
run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token
|
||||
|
||||
- name: Initialize Release Swarm
|
||||
run: |
|
||||
# Get release tag and previous tag
|
||||
RELEASE_TAG=${{ github.ref_name }}
|
||||
PREV_TAG=$(gh release list --limit 2 --json tagName -q '.[1].tagName')
|
||||
|
||||
# Get PRs and commits for changelog
|
||||
PRS=$(gh pr list --state merged --base main --json number,title,labels,author \
|
||||
--search "merged:>=$(gh release view $PREV_TAG --json publishedAt -q .publishedAt)")
|
||||
|
||||
npx ruv-swarm github release-init \
|
||||
--tag $RELEASE_TAG \
|
||||
--previous-tag $PREV_TAG \
|
||||
--prs "$PRS" \
|
||||
--spawn-agents "changelog,version,build,test,deploy"
|
||||
|
||||
- name: Generate Release Assets
|
||||
run: |
|
||||
# Generate changelog from PR data
|
||||
CHANGELOG=$(npx ruv-swarm github release-changelog \
|
||||
--format markdown)
|
||||
|
||||
# Update release notes
|
||||
gh release edit ${{ github.ref_name }} \
|
||||
--notes "$CHANGELOG"
|
||||
|
||||
# Generate and upload assets
|
||||
npx ruv-swarm github release-assets \
|
||||
--changelog \
|
||||
--binaries \
|
||||
--documentation
|
||||
|
||||
- name: Upload Release Assets
|
||||
run: |
|
||||
# Upload generated assets to GitHub release
|
||||
for file in dist/*; do
|
||||
gh release upload ${{ github.ref_name }} "$file"
|
||||
done
|
||||
|
||||
- name: Publish Release
|
||||
run: |
|
||||
# Publish to package registries
|
||||
npx ruv-swarm github release-publish \
|
||||
--platforms all
|
||||
|
||||
# Create announcement issue
|
||||
gh issue create \
|
||||
--title "🚀 Released ${{ github.ref_name }}" \
|
||||
--body "See [release notes](https://github.com/${{ github.repository }}/releases/tag/${{ github.ref_name }})" \
|
||||
--label "announcement"
|
||||
```
|
||||
|
||||
### 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
|
||||
<!-- Auto-generated release notes template -->
|
||||
# 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)
|
||||
Reference in New Issue
Block a user