agentic-flow 1.9.0 → 1.9.1

package/agentic-flow/.claude/commands/github/release-manager.md

@@ -1,338 +0,0 @@
-# GitHub Release Manager
-
-## Purpose
-Automated release coordination and deployment with ruv-swarm orchestration for seamless version management, testing, and deployment across multiple packages.
-
-## Capabilities
-- **Automated release pipelines** with comprehensive testing
-- **Version coordination** across multiple packages
-- **Deployment orchestration** with rollback capabilities  
-- **Release documentation** generation and management
-- **Multi-stage validation** with swarm coordination
-
-## Tools Available
-- `mcp__github__create_pull_request`
-- `mcp__github__merge_pull_request`
-- `mcp__github__create_branch`
-- `mcp__github__push_files`
-- `mcp__github__create_issue`
-- `mcp__claude-flow__*` (all swarm coordination tools)
-- `TodoWrite`, `TodoRead`, `Task`, `Bash`, `Read`, `Write`, `Edit`
-
-## Usage Patterns
-
-### 1. Coordinated Release Preparation
-```javascript
-// Initialize release management swarm
-mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 6 }
-mcp__claude-flow__agent_spawn { type: "coordinator", name: "Release Coordinator" }
-mcp__claude-flow__agent_spawn { type: "tester", name: "QA Engineer" }
-mcp__claude-flow__agent_spawn { type: "reviewer", name: "Release Reviewer" }
-mcp__claude-flow__agent_spawn { type: "coder", name: "Version Manager" }
-mcp__claude-flow__agent_spawn { type: "analyst", name: "Deployment Analyst" }
-
-// Create release preparation branch
-mcp__github__create_branch {
-  owner: "ruvnet",
-  repo: "ruv-FANN",
-  branch: "release/v1.0.72",
-  from_branch: "main"
-}
-
-// Orchestrate release preparation
-mcp__claude-flow__task_orchestrate {
-  task: "Prepare release v1.0.72 with comprehensive testing and validation",
-  strategy: "sequential",
-  priority: "critical"
-}
-```
-
-### 2. Multi-Package Version Coordination
-```javascript
-// Update versions across packages
-mcp__github__push_files {
-  owner: "ruvnet",
-  repo: "ruv-FANN", 
-  branch: "release/v1.0.72",
-  files: [
-    {
-      path: "claude-code-flow/claude-code-flow/package.json",
-      content: JSON.stringify({
-        name: "claude-flow",
-        version: "1.0.72",
-        // ... rest of package.json
-      }, null, 2)
-    },
-    {
-      path: "ruv-swarm/npm/package.json", 
-      content: JSON.stringify({
-        name: "ruv-swarm",
-        version: "1.0.12",
-        // ... rest of package.json
-      }, null, 2)
-    },
-    {
-      path: "CHANGELOG.md",
-      content: `# Changelog
-
-## [1.0.72] - ${new Date().toISOString().split('T')[0]}
-
-### Added
-- Comprehensive GitHub workflow integration
-- Enhanced swarm coordination capabilities
-- Advanced MCP tools suite
-
-### Changed  
-- Aligned Node.js version requirements
-- Improved package synchronization
-- Enhanced documentation structure
-
-### Fixed
-- Dependency resolution issues
-- Integration test reliability
-- Memory coordination optimization`
-    }
-  ],
-  message: "release: Prepare v1.0.72 with GitHub integration and swarm enhancements"
-}
-```
-
-### 3. Automated Release Validation
-```javascript
-// Comprehensive release testing
-Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm install")
-Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm run test")
-Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm run lint")
-Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm run build")
-
-Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm install")
-Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm run test:all")
-Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm run lint")
-
-// Create release PR with validation results
-mcp__github__create_pull_request {
-  owner: "ruvnet",
-  repo: "ruv-FANN",
-  title: "Release v1.0.72: GitHub Integration and Swarm Enhancements",
-  head: "release/v1.0.72", 
-  base: "main",
-  body: `## 🚀 Release v1.0.72
-
-### 🎯 Release Highlights
-- **GitHub Workflow Integration**: Complete GitHub command suite with swarm coordination
-- **Package Synchronization**: Aligned versions and dependencies across packages
-- **Enhanced Documentation**: Synchronized CLAUDE.md with comprehensive integration guides
-- **Improved Testing**: Comprehensive integration test suite with 89% success rate
-
-### 📦 Package Updates
-- **claude-flow**: v1.0.71 → v1.0.72
-- **ruv-swarm**: v1.0.11 → v1.0.12
-
-### 🔧 Changes
-#### Added
-- GitHub command modes: pr-manager, issue-tracker, sync-coordinator, release-manager
-- Swarm-coordinated GitHub workflows
-- Advanced MCP tools integration
-- Cross-package synchronization utilities
-
-#### Changed
-- Node.js requirement aligned to >=20.0.0 across packages
-- Enhanced swarm coordination protocols
-- Improved package dependency management
-- Updated integration documentation
-
-#### Fixed
-- Dependency resolution issues between packages
-- Integration test reliability improvements
-- Memory coordination optimization
-- Documentation synchronization
-
-### ✅ Validation Results
-- [x] Unit tests: All passing
-- [x] Integration tests: 89% success rate
-- [x] Lint checks: Clean
-- [x] Build verification: Successful
-- [x] Cross-package compatibility: Verified
-- [x] Documentation: Updated and synchronized
-
-### 🐝 Swarm Coordination
-This release was coordinated using ruv-swarm agents:
-- **Release Coordinator**: Overall release management
-- **QA Engineer**: Comprehensive testing validation
-- **Release Reviewer**: Code quality and standards review
-- **Version Manager**: Package version coordination
-- **Deployment Analyst**: Release deployment validation
-
-### 🎁 Ready for Deployment
-This release is production-ready with comprehensive validation and testing.
-
----
-🤖 Generated with Claude Code using ruv-swarm coordination`
-}
-```
-
-## Batch Release Workflow
-
-### Complete Release Pipeline:
-```javascript
-[Single Message - Complete Release Management]:
-  // Initialize comprehensive release swarm
-  mcp__claude-flow__swarm_init { topology: "star", maxAgents: 8 }
-  mcp__claude-flow__agent_spawn { type: "coordinator", name: "Release Director" }
-  mcp__claude-flow__agent_spawn { type: "tester", name: "QA Lead" }
-  mcp__claude-flow__agent_spawn { type: "reviewer", name: "Senior Reviewer" }
-  mcp__claude-flow__agent_spawn { type: "coder", name: "Version Controller" }
-  mcp__claude-flow__agent_spawn { type: "analyst", name: "Performance Analyst" }
-  mcp__claude-flow__agent_spawn { type: "researcher", name: "Compatibility Checker" }
-  
-  // Create release branch and prepare files using gh CLI
-  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')")
-  
-  // Clone and update release files
-  Bash("gh repo clone :owner/:repo /tmp/release-v1.0.72 -- --branch release/v1.0.72 --depth=1")
-  
-  // Update all release-related files
-  Write("/tmp/release-v1.0.72/claude-code-flow/claude-code-flow/package.json", "[updated package.json]")
-  Write("/tmp/release-v1.0.72/ruv-swarm/npm/package.json", "[updated package.json]")
-  Write("/tmp/release-v1.0.72/CHANGELOG.md", "[release changelog]")
-  Write("/tmp/release-v1.0.72/RELEASE_NOTES.md", "[detailed release notes]")
-  
-  Bash("cd /tmp/release-v1.0.72 && git add -A && git commit -m 'release: Prepare v1.0.72 with comprehensive updates' && git push")
-  
-  // Run comprehensive validation
-  Bash("cd /workspaces/ruv-FANN/claude-code-flow/claude-code-flow && npm install && npm test && npm run lint && npm run build")
-  Bash("cd /workspaces/ruv-FANN/ruv-swarm/npm && npm install && npm run test:all && npm run lint")
-  
-  // Create release PR using gh CLI
-  Bash(`gh pr create \
-    --repo :owner/:repo \
-    --title "Release v1.0.72: GitHub Integration and Swarm Enhancements" \
-    --head "release/v1.0.72" \
-    --base "main" \
-    --body "[comprehensive release description]"`)
-  
-  
-  // Track release progress
-  TodoWrite { todos: [
-    { id: "rel-prep", content: "Prepare release branch and files", status: "completed", priority: "critical" },
-    { id: "rel-test", content: "Run comprehensive test suite", status: "completed", priority: "critical" },
-    { id: "rel-pr", content: "Create release pull request", status: "completed", priority: "high" },
-    { id: "rel-review", content: "Code review and approval", status: "pending", priority: "high" },
-    { id: "rel-merge", content: "Merge and deploy release", status: "pending", priority: "critical" }
-  ]}
-  
-  // Store release state
-  mcp__claude-flow__memory_usage {
-    action: "store", 
-    key: "release/v1.0.72/status",
-    value: {
-      timestamp: Date.now(),
-      version: "1.0.72",
-      stage: "validation_complete",
-      packages: ["claude-flow", "ruv-swarm"],
-      validation_passed: true,
-      ready_for_review: true
-    }
-  }
-```
-
-## Release Strategies
-
-### 1. **Semantic Versioning Strategy**
-```javascript
-const versionStrategy = {
-  major: "Breaking changes or architecture overhauls",
-  minor: "New features, GitHub integration, swarm enhancements", 
-  patch: "Bug fixes, documentation updates, dependency updates",
-  coordination: "Cross-package version alignment"
-}
-```
-
-### 2. **Multi-Stage Validation**
-```javascript
-const validationStages = [
-  "unit_tests",           // Individual package testing
-  "integration_tests",    // Cross-package integration
-  "performance_tests",    // Performance regression detection
-  "compatibility_tests",  // Version compatibility validation
-  "documentation_tests",  // Documentation accuracy verification
-  "deployment_tests"      // Deployment simulation
-]
-```
-
-### 3. **Rollback Strategy**
-```javascript
-const rollbackPlan = {
-  triggers: ["test_failures", "deployment_issues", "critical_bugs"],
-  automatic: ["failed_tests", "build_failures"],
-  manual: ["user_reported_issues", "performance_degradation"],
-  recovery: "Previous stable version restoration"
-}
-```
-
-## Best Practices
-
-### 1. **Comprehensive Testing**
-- Multi-package test coordination
-- Integration test validation
-- Performance regression detection
-- Security vulnerability scanning
-
-### 2. **Documentation Management**
-- Automated changelog generation
-- Release notes with detailed changes
-- Migration guides for breaking changes
-- API documentation updates
-
-### 3. **Deployment Coordination**
-- Staged deployment with validation
-- Rollback mechanisms and procedures
-- Performance monitoring during deployment
-- User communication and notifications
-
-### 4. **Version Management**
-- Semantic versioning compliance
-- Cross-package version coordination
-- Dependency compatibility validation
-- Breaking change documentation
-
-## Integration with CI/CD
-
-### GitHub Actions Integration:
-```yaml
-name: Release Management
-on:
-  pull_request:
-    branches: [main]
-    paths: ['**/package.json', 'CHANGELOG.md']
-
-jobs:
-  release-validation:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - name: Setup Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: '20'
-      - name: Install and Test
-        run: |
-          cd claude-code-flow/claude-code-flow && npm install && npm test
-          cd ../../ruv-swarm/npm && npm install && npm test:all
-      - name: Validate Release
-        run: npx claude-flow release validate
-```
-
-## Monitoring and Metrics
-
-### Release Quality Metrics:
-- Test coverage percentage
-- Integration success rate
-- Deployment time metrics
-- Rollback frequency
-
-### Automated Monitoring:
-- Performance regression detection
-- Error rate monitoring
-- User adoption metrics
-- Feedback collection and analysis