claude-flow 2.0.0-alpha.61 → 2.0.0-alpha.63

package/.claude/commands/github/pr-manager.md

@@ -105,10 +105,11 @@ mcp__claude-flow__memory_usage {
   mcp__claude-flow__agent_spawn { type: "tester", name: "QA Engineer" }
   mcp__claude-flow__agent_spawn { type: "coordinator", name: "Merge Coordinator" }
   
-  // Create and manage PR
-  mcp__github__create_pull_request { title: "...", head: "...", base: "main" }
-  mcp__github__get_pull_request_files { pull_number: 54 }
-  mcp__github__create_pull_request_review { event: "APPROVE", body: "..." }
+  // Create and manage PR using gh CLI
+  Bash("gh pr create --repo :owner/:repo --title '...' --head '...' --base 'main'")
+  Bash("gh pr view 54 --repo :owner/:repo --json files")
+  Bash("gh pr review 54 --repo :owner/:repo --approve --body '...'")
+  
   
   // Execute tests and validation
   Bash("npm test")

package/.claude/commands/github/project-board-sync.md

@@ -7,11 +7,22 @@ Synchronize AI swarms with GitHub Projects for visual task management, progress
 
 ### 1. Board Initialization
 ```bash
-# Connect swarm to GitHub Project
+# Connect swarm to GitHub Project using gh CLI
+# Get project details
+PROJECT_ID=$(gh project list --owner @me --format json | \
+  jq -r '.projects[] | select(.title == "Development Board") | .id')
+
+# Initialize swarm with project
 npx ruv-swarm github board-init \
-  --project "Development Board" \
+  --project-id "$PROJECT_ID" \
   --sync-mode "bidirectional" \
   --create-views "swarm-status,agent-workload,priority"
+
+# Create project fields for swarm tracking
+gh project field-create $PROJECT_ID --owner @me \
+  --name "Swarm Status" \
+  --data-type "SINGLE_SELECT" \
+  --single-select-options "pending,in_progress,completed"
 ```
 
 ### 2. Task Synchronization
@@ -149,9 +160,18 @@ npx ruv-swarm github board-smart-move \
 
 ### Create Cards from Issues
 ```bash
-# Convert issues to project cards
+# Convert issues to project cards using gh CLI
+# List issues with label
+ISSUES=$(gh issue list --label "enhancement" --json number,title,body)
+
+# Add issues to project
+echo "$ISSUES" | jq -r '.[].number' | while read -r issue; do
+  gh project item-add $PROJECT_ID --owner @me --url "https://github.com/$GITHUB_REPOSITORY/issues/$issue"
+done
+
+# Process with swarm
 npx ruv-swarm github board-import-issues \
-  --label "enhancement" \
+  --issues "$ISSUES" \
   --add-to-column "Backlog" \
   --parse-checklist \
   --assign-agents
@@ -216,8 +236,21 @@ npx ruv-swarm github board-integrate \
 
 ### Board Analytics
 ```bash
-# Generate board analytics
+# Generate board analytics using gh CLI data
+# Fetch project data
+PROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)
+
+# Get issue metrics
+ISSUE_METRICS=$(echo "$PROJECT_DATA" | jq -r '.items[] | select(.content.type == "Issue")' | \
+  while read -r item; do
+    ISSUE_NUM=$(echo "$item" | jq -r '.content.number')
+    gh issue view $ISSUE_NUM --json createdAt,closedAt,labels,assignees
+  done)
+
+# Generate analytics with swarm
 npx ruv-swarm github board-analytics \
+  --project-data "$PROJECT_DATA" \
+  --issue-metrics "$ISSUE_METRICS" \
   --metrics "throughput,cycle-time,wip" \
   --group-by "agent,priority,type" \
   --time-range "30d" \

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

@@ -185,32 +185,32 @@ This release is production-ready with comprehensive validation and testing.
   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
-  mcp__github__create_branch { branch: "release/v1.0.72", from_branch: "main" }
+  // 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
-  mcp__github__push_files {
-    branch: "release/v1.0.72",
-    files: [
-      { path: "claude-code-flow/claude-code-flow/package.json", content: "[updated package.json]" },
-      { path: "ruv-swarm/npm/package.json", content: "[updated package.json]" },
-      { path: "CHANGELOG.md", content: "[release changelog]" },
-      { path: "RELEASE_NOTES.md", content: "[detailed release notes]" }
-    ],
-    message: "release: Prepare v1.0.72 with comprehensive updates"
-  }
+  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
-  mcp__github__create_pull_request {
-    title: "Release v1.0.72: GitHub Integration and Swarm Enhancements",
-    head: "release/v1.0.72",
-    base: "main",
-    body: "[comprehensive release description]"
-  }
+  // 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: [

package/.claude/commands/github/release-swarm.md

@@ -7,8 +7,19 @@ Orchestrate complex software releases using AI swarms that handle everything fro
 
 ### 1. Release Planning
 ```bash
-# Plan next release
+# 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 \
@@ -27,13 +38,34 @@ npx ruv-swarm github release-version \
 
 ### 3. Release Orchestration
 ```bash
-# Full release automation
+# 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" \
-  --generate-changelog \
+  --changelog "$CHANGELOG" \
   --build-artifacts \
-  --deploy-targets "npm,docker,github" \
-  --notify-stakeholders
+  --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
@@ -89,13 +121,36 @@ release:
 
 ### Changelog Agent
 ```bash
-# Generate intelligent changelog
-npx ruv-swarm github changelog \
+# 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 \
-  --include-contributors \
-  --add-migration-guide
+  --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:**
@@ -222,25 +277,59 @@ jobs:
         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 ${{ github.ref_name }} \
+            --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 \
-            --notify \
-            --update-docs
+            --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

package/.claude/commands/github/repo-architect.md

@@ -182,12 +182,12 @@ jobs:
   Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/package.json")
   Read("/workspaces/ruv-FANN/ruv-swarm/npm/package.json")
   
-  // Search for architectural patterns
-  mcp__github__search_repositories {
-    query: "language:javascript template architecture",
-    sort: "stars",
-    order: "desc"
-  }
+  // Search for architectural patterns using gh CLI
+  ARCH_PATTERNS=$(Bash(`gh search repos "language:javascript template architecture" \
+    --limit 10 \
+    --json fullName,description,stargazersCount \
+    --sort stars \
+    --order desc`))
   
   // Create optimized structure files
   mcp__github__push_files {

package/.claude/commands/github/swarm-issue.md

@@ -7,15 +7,26 @@ Transform GitHub Issues into intelligent swarm tasks, enabling automatic task de
 
 ### 1. Issue-to-Swarm Conversion
 ```bash
+# Create swarm from issue using gh CLI
+# Get issue details
+ISSUE_DATA=$(gh issue view 456 --json title,body,labels,assignees,comments)
+
 # Create swarm from issue
 npx ruv-swarm github issue-to-swarm 456 \
+  --issue-data "$ISSUE_DATA" \
   --auto-decompose \
   --assign-agents
 
 # Batch process multiple issues
+ISSUES=$(gh issue list --label "swarm-ready" --json number,title,body,labels)
 npx ruv-swarm github issues-batch \
-  --label "swarm-ready" \
+  --issues "$ISSUES" \
   --parallel
+
+# Update issues with swarm status
+echo "$ISSUES" | jq -r '.[].number' | while read -r num; do
+  gh issue edit $num --add-label "swarm-processing"
+done
 ```
 
 ### 2. Issue Comment Commands
@@ -99,29 +110,106 @@ npx ruv-swarm github issue-analyze 456 \
 
 ### Initialize from Issue
 ```bash
-# Create swarm with full issue context
+# Create swarm with full issue context using gh CLI
+# Get complete issue data
+ISSUE=$(gh issue view 456 --json title,body,labels,assignees,comments,projectItems)
+
+# Get referenced issues and PRs
+REFERENCES=$(gh issue view 456 --json body --jq '.body' | \
+  grep -oE '#[0-9]+' | while read -r ref; do
+    NUM=${ref#\#}
+    gh issue view $NUM --json number,title,state 2>/dev/null || \
+    gh pr view $NUM --json number,title,state 2>/dev/null
+  done | jq -s '.')
+
+# Initialize swarm
 npx ruv-swarm github issue-init 456 \
+  --issue-data "$ISSUE" \
+  --references "$REFERENCES" \
   --load-comments \
   --analyze-references \
   --auto-topology
+
+# Add swarm initialization comment
+gh issue comment 456 --body "🐝 Swarm initialized for this issue"
 ```
 
 ### Task Decomposition
 ```bash
-# Break down issue into subtasks
-npx ruv-swarm github issue-decompose 456 \
+# Break down issue into subtasks with gh CLI
+# Get issue body
+ISSUE_BODY=$(gh issue view 456 --json body --jq '.body')
+
+# Decompose into subtasks
+SUBTASKS=$(npx ruv-swarm github issue-decompose 456 \
+  --body "$ISSUE_BODY" \
   --max-subtasks 10 \
-  --create-checklist \
-  --assign-priorities
+  --assign-priorities)
+
+# Update issue with checklist
+CHECKLIST=$(echo "$SUBTASKS" | jq -r '.tasks[] | "- [ ] " + .description')
+UPDATED_BODY="$ISSUE_BODY
+
+## Subtasks
+$CHECKLIST"
+
+gh issue edit 456 --body "$UPDATED_BODY"
+
+# Create linked issues for major subtasks
+echo "$SUBTASKS" | jq -r '.tasks[] | select(.priority == "high")' | while read -r task; do
+  TITLE=$(echo "$task" | jq -r '.title')
+  BODY=$(echo "$task" | jq -r '.description')
+  
+  gh issue create \
+    --title "$TITLE" \
+    --body "$BODY
+
+Parent issue: #456" \
+    --label "subtask"
+done
 ```
 
 ### Progress Tracking
 ```bash
-# Update issue with swarm progress
-npx ruv-swarm github issue-progress 456 \
-  --update-checklist \
-  --post-summary \
-  --eta
+# Update issue with swarm progress using gh CLI
+# Get current issue state
+CURRENT=$(gh issue view 456 --json body,labels)
+
+# Get swarm progress
+PROGRESS=$(npx ruv-swarm github issue-progress 456)
+
+# Update checklist in issue body
+UPDATED_BODY=$(echo "$CURRENT" | jq -r '.body' | \
+  npx ruv-swarm github update-checklist --progress "$PROGRESS")
+
+# Edit issue with updated body
+gh issue edit 456 --body "$UPDATED_BODY"
+
+# Post progress summary as comment
+SUMMARY=$(echo "$PROGRESS" | jq -r '
+"## 📊 Progress Update
+
+**Completion**: \(.completion)%
+**ETA**: \(.eta)
+
+### Completed Tasks
+\(.completed | map("- ✅ " + .) | join("\n"))
+
+### In Progress
+\(.in_progress | map("- 🔄 " + .) | join("\n"))
+
+### Remaining
+\(.remaining | map("- ⏳ " + .) | join("\n"))
+
+---
+🤖 Automated update by swarm agent"')
+
+gh issue comment 456 --body "$SUMMARY"
+
+# Update labels based on progress
+if [[ $(echo "$PROGRESS" | jq -r '.completion') -eq 100 ]]; then
+  gh issue edit 456 --add-label "ready-for-review" --remove-label "in-progress"
+fi
 ```
 
 ## Advanced Features
@@ -224,12 +312,46 @@ npx ruv-swarm github debt-swarm 456 \
 
 ### Auto-Close Stale Issues
 ```bash
-# Process stale issues with swarm
-npx ruv-swarm github stale-issues \
-  --days 30 \
-  --analyze-each \
-  --suggest-action \
-  --auto-close-if "no-activity"
+# Process stale issues with swarm using gh CLI
+# Find stale issues
+STALE_DATE=$(date -d '30 days ago' --iso-8601)
+STALE_ISSUES=$(gh issue list --state open --json number,title,updatedAt,labels \
+  --jq ".[] | select(.updatedAt < \"$STALE_DATE\")")
+
+# Analyze each stale issue
+echo "$STALE_ISSUES" | jq -r '.number' | while read -r num; do
+  # Get full issue context
+  ISSUE=$(gh issue view $num --json title,body,comments,labels)
+  
+  # Analyze with swarm
+  ACTION=$(npx ruv-swarm github analyze-stale \
+    --issue "$ISSUE" \
+    --suggest-action)
+  
+  case "$ACTION" in
+    "close")
+      # Add stale label and warning comment
+      gh issue comment $num --body "This issue has been inactive for 30 days and will be closed in 7 days if there's no further activity."
+      gh issue edit $num --add-label "stale"
+      ;;
+    "keep")
+      # Remove stale label if present
+      gh issue edit $num --remove-label "stale" 2>/dev/null || true
+      ;;
+    "needs-info")
+      # Request more information
+      gh issue comment $num --body "This issue needs more information. Please provide additional context or it may be closed as stale."
+      gh issue edit $num --add-label "needs-info"
+      ;;
+  esac
+done
+
+# Close issues that have been stale for 37+ days
+gh issue list --label stale --state open --json number,updatedAt \
+  --jq ".[] | select(.updatedAt < \"$(date -d '37 days ago' --iso-8601)\") | .number" | \
+  while read -r num; do
+    gh issue close $num --comment "Closing due to inactivity. Feel free to reopen if this is still relevant."
+  done
 ```
 
 ### Issue Triage

package/.claude/commands/github/swarm-pr.md

@@ -7,11 +7,15 @@ Create and manage AI swarms directly from GitHub Pull Requests, enabling seamles
 
 ### 1. PR-Based Swarm Creation
 ```bash
-# Create swarm from PR description
-gh pr view 123 --json body | npx ruv-swarm swarm create-from-pr
+# Create swarm from PR description using gh CLI
+gh pr view 123 --json body,title,labels,files | npx ruv-swarm swarm create-from-pr
 
 # Auto-spawn agents based on PR labels
 gh pr view 123 --json labels | npx ruv-swarm swarm auto-spawn
+
+# Create swarm with PR context
+gh pr view 123 --json body,labels,author,assignees | \
+  npx ruv-swarm swarm init --from-pr-data
 ```
 
 ### 2. PR Comment Commands
@@ -79,27 +83,48 @@ npx ruv-swarm github pr-topology --pr 123
 
 ### Initialize from PR
 ```bash
-# Create swarm with PR context
+# Create swarm with PR context using gh CLI
+PR_DIFF=$(gh pr diff 123)
+PR_INFO=$(gh pr view 123 --json title,body,labels,files,reviews)
+
 npx ruv-swarm github pr-init 123 \
   --auto-agents \
-  --load-diff \
+  --pr-data "$PR_INFO" \
+  --diff "$PR_DIFF" \
   --analyze-impact
 ```
 
 ### Progress Updates
 ```bash
-# Post swarm progress to PR
-npx ruv-swarm github pr-update 123 \
-  --comment "🐝 Swarm Progress: 75% complete" \
-  --details
+# Post swarm progress to PR using gh CLI
+PROGRESS=$(npx ruv-swarm github pr-progress 123 --format markdown)
+
+gh pr comment 123 --body "$PROGRESS"
+
+# Update PR labels based on progress
+if [[ $(echo "$PROGRESS" | grep -o '[0-9]\+%' | sed 's/%//') -gt 90 ]]; then
+  gh pr edit 123 --add-label "ready-for-review"
+fi
 ```
 
 ### Code Review Integration
 ```bash
-# Create review agents
-npx ruv-swarm github pr-review 123 \
+# Create review agents with gh CLI integration
+PR_FILES=$(gh pr view 123 --json files --jq '.files[].path')
+
+# Run swarm review
+REVIEW_RESULTS=$(npx ruv-swarm github pr-review 123 \
   --agents "security,performance,style" \
-  --post-comments
+  --files "$PR_FILES")
+
+# Post review comments using gh CLI
+echo "$REVIEW_RESULTS" | jq -r '.comments[]' | while read -r comment; do
+  FILE=$(echo "$comment" | jq -r '.file')
+  LINE=$(echo "$comment" | jq -r '.line')
+  BODY=$(echo "$comment" | jq -r '.body')
+  
+  gh pr review 123 --comment --body "$BODY"
+done
 ```
 
 ## Advanced Features
@@ -157,10 +182,19 @@ required_status_checks:
 
 ### 3. PR Merge Automation
 ```bash
-# Auto-merge when swarm completes
-npx ruv-swarm github pr-automerge 123 \
-  --when "all-tasks-complete" \
-  --require-reviews 2
+# Auto-merge when swarm completes using gh CLI
+# Check swarm completion status
+SWARM_STATUS=$(npx ruv-swarm github pr-status 123)
+
+if [[ "$SWARM_STATUS" == "complete" ]]; then
+  # Check review requirements
+  REVIEWS=$(gh pr view 123 --json reviews --jq '.reviews | length')
+  
+  if [[ $REVIEWS -ge 2 ]]; then
+    # Enable auto-merge
+    gh pr merge 123 --auto --squash
+  fi
+fi
 ```
 
 ## Webhook Integration