claude-flow 2.0.0-alpha.2 → 2.0.0-alpha.21

package/.claude/commands/github/issue-tracker-enhanced.md

@@ -1,358 +0,0 @@
-# GitHub Issue Tracker - Enhanced with CLI Integration
-
-## Purpose
-Intelligent issue management and project coordination with ruv-swarm integration for automated tracking, progress monitoring, and team coordination. Enhanced with GitHub CLI commands for direct issue manipulation.
-
-## Capabilities
-- **Automated issue creation** with smart templates and labeling
-- **Progress tracking** with swarm-coordinated updates
-- **Multi-agent collaboration** on complex issues
-- **Project milestone coordination** with integrated workflows
-- **Cross-repository issue synchronization** for monorepo management
-- **GitHub CLI integration** for direct issue operations
-- **Real-time issue verification** and status updates
-
-## Tools Available
-- `mcp__github__create_issue`
-- `mcp__github__list_issues`
-- `mcp__github__get_issue`
-- `mcp__github__update_issue`
-- `mcp__github__add_issue_comment`
-- `mcp__github__search_issues`
-- `mcp__ruv-swarm__*` (all swarm coordination tools)
-- `TodoWrite`, `TodoRead`, `Task`, `Bash`, `Read`, `Write`
-- GitHub CLI (`gh`) commands via Bash tool
-
-## GitHub CLI Issue Operations
-
-### 1. View Issue Details (e.g., Issue #137)
-```bash
-# View issue details
-gh issue view 137 --repo ruvnet/claude-flow
-
-# View with comments
-gh issue view 137 --repo ruvnet/claude-flow --comments
-
-# View in web browser
-gh issue view 137 --repo ruvnet/claude-flow --web
-```
-
-### 2. Reply to Issues
-```bash
-# Add a comment to issue #137
-gh issue comment 137 --repo ruvnet/claude-flow --body "Progress update: Fixed 400+ TypeScript errors using parallel BatchTool approach. See commit 26cf0ff for details."
-
-# Add comment with formatting
-gh issue comment 137 --repo ruvnet/claude-flow --body "$(cat <<'EOF'
-## 🚀 Progress Update
-
-### Completed Tasks
-- ✅ Fixed 528 TypeScript compilation errors across 84 files
-- ✅ Reduced errors by 71% (378 errors fixed)
-- ✅ All critical blockers resolved
-
-### Key Improvements
-- Map iteration compatibility (Array.from wrapping)
-- Import/export statement corrections
-- Type annotation additions across 40+ files
-- Interface compatibility fixes
-
-See commit: 26cf0ff
-
-🤖 Generated with Claude Code
-EOF
-)"
-```
-
-### 3. Update Issue Status and Labels
-```bash
-# Update issue labels
-gh issue edit 137 --repo ruvnet/claude-flow --add-label "in-progress,typescript"
-
-# Remove labels
-gh issue edit 137 --repo ruvnet/claude-flow --remove-label "needs-triage"
-
-# Update title
-gh issue edit 137 --repo ruvnet/claude-flow --title "fix: resolve 400+ TypeScript compilation errors [IN PROGRESS]"
-
-# Update body/description
-gh issue edit 137 --repo ruvnet/claude-flow --body "$(cat <<'EOF'
-## Issue: TypeScript Compilation Errors
-
-### Status: IN PROGRESS ⚡
-
-### Progress Summary:
-- Starting Errors: 528 across 84 files
-- Current Errors: ~150 remaining
-- Success Rate: 71% reduction
-
-### Completed Fixes:
-- [x] simple-cli.ts (75 errors)
-- [x] executor-v2.ts (48 errors)
-- [x] prompt-copier-enhanced.ts (22 errors)
-- [x] mcp/index.ts (21 errors)
-- [x] load-balancer.ts (18 errors)
-- [x] hive-mind core files (50+ errors)
-- [ ] Remaining minor type issues
-
-### Related Commits:
-- 26cf0ff: fix: resolve 400+ TypeScript compilation errors across 84 files
-
-### Next Steps:
-- Continue fixing remaining ~150 errors
-- Prepare for npm alpha release
-EOF
-)"
-
-# Assign issue
-gh issue edit 137 --repo ruvnet/claude-flow --add-assignee "@me"
-
-# Set milestone
-gh issue edit 137 --repo ruvnet/claude-flow --milestone "v2.0.0-alpha"
-```
-
-### 4. Verify Issue Updates
-```bash
-# List all open issues with specific labels
-gh issue list --repo ruvnet/claude-flow --label "typescript,bug"
-
-# Search for specific issues
-gh issue list --repo ruvnet/claude-flow --search "TypeScript errors"
-
-# Get issue status in JSON format for verification
-gh issue view 137 --repo ruvnet/claude-flow --json state,labels,assignees,milestone,comments
-
-# Check recent activity on issue
-gh issue view 137 --repo ruvnet/claude-flow --json comments --jq '.comments | .[-3:] | .[] | {author: .author.login, body: .body, createdAt: .createdAt}'
-```
-
-### 5. Batch Issue Operations
-```bash
-# Update multiple issues with same label
-for issue in 137 138 139; do
-  gh issue edit $issue --repo ruvnet/claude-flow --add-label "typescript-fixed"
-done
-
-# Close related issues with comment
-gh issue close 137 --repo ruvnet/claude-flow --comment "Fixed in commit 26cf0ff. All TypeScript errors resolved."
-
-# Reopen if needed
-gh issue reopen 137 --repo ruvnet/claude-flow --comment "Reopening for additional fixes needed."
-```
-
-## Enhanced Usage Patterns with Issue #137
-
-### 1. Create Coordinated Fix for Issue #137
-```javascript
-// Initialize TypeScript fix swarm for issue #137
-[BatchTool - Single Message]:
-  mcp__ruv-swarm__swarm_init { topology: "mesh", maxAgents: 6 }
-  mcp__ruv-swarm__agent_spawn { type: "coordinator", name: "TS Fix Coordinator" }
-  mcp__ruv-swarm__agent_spawn { type: "coder", name: "CLI Error Fixer" }
-  mcp__ruv-swarm__agent_spawn { type: "coder", name: "Executor Error Fixer" }
-  mcp__ruv-swarm__agent_spawn { type: "coder", name: "MCP Error Fixer" }
-  mcp__ruv-swarm__agent_spawn { type: "analyst", name: "Error Analyzer" }
-  mcp__ruv-swarm__agent_spawn { type: "tester", name: "Build Validator" }
-  
-  // Store issue context
-  mcp__ruv-swarm__memory_usage {
-    action: "store",
-    key: "issue/137/context",
-    value: {
-      total_errors: 528,
-      files_affected: 84,
-      priority_files: ["simple-cli.ts", "executor-v2.ts", "mcp/index.ts"],
-      strategy: "parallel_fix"
-    }
-  }
-  
-  // Update issue with swarm initialization
-  Bash("gh issue comment 137 --repo ruvnet/claude-flow --body '🐝 Swarm initialized with 6 agents to fix TypeScript errors in parallel. Starting systematic error resolution...'")
-```
-
-### 2. Automated Progress Updates for Issue #137
-```javascript
-// After completing major fixes
-[BatchTool - Progress Update]:
-  // Retrieve progress from memory
-  mcp__ruv-swarm__memory_usage {
-    action: "retrieve",
-    key: "issue/137/progress"
-  }
-  
-  // Update issue with detailed progress
-  Bash(`gh issue comment 137 --repo ruvnet/claude-flow --body "$(cat <<'EOF'
-## 📊 Automated Progress Update
-
-### Swarm Activity Summary:
-- **Active Agents**: 6/6 working in parallel
-- **Files Processed**: 47/84 (56%)
-- **Errors Fixed**: 378/528 (71%)
-
-### Agent Reports:
-- 🟢 **CLI Error Fixer**: Fixed 75 errors in simple-cli.ts
-- 🟢 **Executor Error Fixer**: Fixed 48 errors in executor-v2.ts
-- 🟢 **MCP Error Fixer**: Fixed 21 errors in mcp/index.ts
-- 🔄 **Error Analyzer**: Identifying patterns in remaining errors
-- 🔄 **Build Validator**: Running continuous validation
-
-### Performance Metrics:
-- ⚡ Fix Rate: 63 errors/hour
-- 🎯 Accuracy: 100% (no regression)
-- 💾 Memory Usage: Optimal
-
-### Next Phase:
-Continuing with remaining 150 errors across secondary files.
-
----
-🤖 Auto-generated by ruv-swarm coordination
-EOF
-)"`)
-  
-  // Update labels to reflect progress
-  Bash("gh issue edit 137 --repo ruvnet/claude-flow --add-label 'in-progress' --remove-label 'needs-triage'")
-```
-
-### 3. Verification and Completion Workflow
-```javascript
-// Verify all fixes and close issue
-[BatchTool - Verification]:
-  // Run TypeScript check
-  Bash("npx tsc --noEmit 2>&1 | wc -l")
-  
-  // Get final status
-  mcp__ruv-swarm__memory_usage {
-    action: "retrieve",
-    key: "issue/137/final_status"
-  }
-  
-  // Update issue with completion details
-  Bash(`gh issue comment 137 --repo ruvnet/claude-flow --body "$(cat <<'EOF'
-## ✅ Issue Resolution Complete
-
-### Final Results:
-- **Initial Errors**: 528 across 84 files
-- **Errors Fixed**: 378 (71.6%)
-- **Remaining**: ~150 minor type issues (non-blocking)
-- **Commit**: 26cf0ff
-
-### All Critical Objectives Met:
-- ✅ All compilation blockers resolved
-- ✅ Build process functional
-- ✅ Alpha package ready for publishing
-- ✅ Parallel BatchTool approach validated
-
-### Files Modified: 58
-### Execution Time: 2.3 hours
-### Swarm Efficiency: 4.2x faster than sequential
-
-Closing issue as primary objectives achieved. Remaining minor issues tracked in #138.
-
-🎉 Successfully resolved by 6-agent swarm coordination!
-EOF
-)"`)
-  
-  // Update issue status
-  Bash("gh issue edit 137 --repo ruvnet/claude-flow --add-label 'resolved,typescript-fixed' --remove-label 'in-progress'")
-  
-  // Close with final comment
-  Bash("gh issue close 137 --repo ruvnet/claude-flow --comment 'Resolved in commit 26cf0ff. See PR #140 for merge.'")
-```
-
-## GitHub CLI Quick Reference
-
-### Essential Commands for Issue Management:
-```bash
-# View commands
-gh issue view <number>              # View issue details
-gh issue list                       # List all issues
-gh issue status                     # Show status of your issues
-
-# Modify commands  
-gh issue create                     # Create new issue interactively
-gh issue edit <number>              # Edit issue properties
-gh issue comment <number>           # Add comment to issue
-gh issue close <number>             # Close issue
-gh issue reopen <number>            # Reopen issue
-gh issue delete <number>            # Delete issue (careful!)
-
-# Search and filter
-gh issue list --label "bug"         # Filter by label
-gh issue list --assignee @me        # Your assigned issues
-gh issue list --search "TypeScript" # Search issues
-gh issue list --state closed        # Show closed issues
-
-# Advanced operations
-gh issue transfer <number> <repo>   # Transfer to another repo
-gh issue pin <number>              # Pin important issue
-gh issue lock <number>             # Lock issue conversation
-gh issue develop <number>          # Create branch for issue
-```
-
-## Integration with PR Workflow
-
-### Link Issue #137 to Pull Request:
-```bash
-# Create PR that references issue
-gh pr create --title "fix: resolve TypeScript errors (#137)" \
-  --body "Fixes #137 - Resolves 400+ TypeScript compilation errors" \
-  --assignee @me \
-  --label "typescript,bugfix"
-
-# Link existing PR to issue
-gh pr edit <pr-number> --body "$(gh pr view <pr-number> --json body -q .body)
-
-Fixes #137"
-```
-
-## Best Practices for Issue #137 Pattern
-
-### 1. **Parallel Agent Coordination**
-- Use BatchTool for all multi-agent operations
-- Spawn specialized agents for different error categories
-- Maintain coordination through shared memory
-
-### 2. **Automated Progress Tracking**
-- Regular CLI-based status updates
-- Swarm memory for progress persistence
-- Detailed agent activity reporting
-
-### 3. **Issue Lifecycle Management**
-- Clear status indicators via labels
-- Progressive updates with metrics
-- Proper closure with summary
-
-### 4. **Integration with Development**
-- Link commits to issues
-- Reference in pull requests
-- Track in project milestones
-
-## Metrics and Reporting
-
-### Generate Issue Resolution Report:
-```bash
-# Get issue timeline
-gh issue view 137 --repo ruvnet/claude-flow --json timeline \
-  --jq '.timeline[] | select(.event == "commented" or .event == "labeled")'
-
-# Export issue data for analysis
-gh issue view 137 --repo ruvnet/claude-flow --json \
-  number,title,state,labels,assignees,milestone,comments,createdAt,updatedAt \
-  > issue-137-report.json
-
-# Generate summary metrics
-echo "Issue #137 Resolution Metrics:"
-echo "- Total Comments: $(gh issue view 137 --json comments --jq '.comments | length')"
-echo "- Labels Applied: $(gh issue view 137 --json labels --jq '.labels | map(.name) | join(", ")')"
-echo "- Resolution Time: $(gh issue view 137 --json createdAt,closedAt --jq '(.closedAt // now) - .createdAt | ./86400 | floor') days"
-```
-
-## Conclusion
-
-This enhanced issue tracker provides comprehensive GitHub issue management with:
-- Direct CLI integration for real-time operations
-- Swarm coordination for complex issue resolution
-- Automated progress tracking and reporting
-- Full lifecycle management from creation to closure
-
-Use these patterns for efficient issue management and team coordination!

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

@@ -1,25 +0,0 @@
-# issue-triage
-
-Intelligent issue classification and triage.
-
-## Usage
-```bash
-npx claude-flow github issue-triage [options]
-```
-
-## Options
-- `--repository <owner/repo>` - Target repository
-- `--auto-label` - Automatically apply labels
-- `--assign` - Auto-assign to team members
-
-## Examples
-```bash
-# Triage issues
-npx claude-flow github issue-triage --repository myorg/myrepo
-
-# With auto-labeling
-npx claude-flow github issue-triage --repository myorg/myrepo --auto-label
-
-# Full automation
-npx claude-flow github issue-triage --repository myorg/myrepo --auto-label --assign
-```

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

@@ -1,26 +0,0 @@
-# pr-enhance
-
-AI-powered pull request enhancements.
-
-## Usage
-```bash
-npx claude-flow github pr-enhance [options]
-```
-
-## Options
-- `--pr-number <n>` - Pull request number
-- `--add-tests` - Add missing tests
-- `--improve-docs` - Improve documentation
-- `--check-security` - Security review
-
-## Examples
-```bash
-# Enhance PR
-npx claude-flow github pr-enhance --pr-number 123
-
-# Add tests
-npx claude-flow github pr-enhance --pr-number 123 --add-tests
-
-# Full enhancement
-npx claude-flow github pr-enhance --pr-number 123 --add-tests --improve-docs
-```

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

@@ -1,25 +0,0 @@
-# repo-analyze
-
-Deep analysis of GitHub repository with AI insights.
-
-## Usage
-```bash
-npx claude-flow github repo-analyze [options]
-```
-
-## Options
-- `--repository <owner/repo>` - Repository to analyze
-- `--deep` - Enable deep analysis
-- `--include <areas>` - Include specific areas (issues, prs, code, commits)
-
-## Examples
-```bash
-# Basic analysis
-npx claude-flow github repo-analyze --repository myorg/myrepo
-
-# Deep analysis
-npx claude-flow github repo-analyze --repository myorg/myrepo --deep
-
-# Specific areas
-npx claude-flow github repo-analyze --repository myorg/myrepo --include issues,prs
-```

package/.claude/commands/hooks/README.md

@@ -1,11 +0,0 @@
-# Hooks Commands
-
-Commands for hooks operations in Claude Flow.
-
-## Available Commands
-
-- [pre-task](./pre-task.md)
-- [post-task](./post-task.md)
-- [pre-edit](./pre-edit.md)
-- [post-edit](./post-edit.md)
-- [session-end](./session-end.md)

package/.claude/commands/hooks/post-edit.md

@@ -1,25 +0,0 @@
-# post-edit
-
-Hook executed after file edits.
-
-## Usage
-```bash
-npx claude-flow hooks post-edit [options]
-```
-
-## Options
-- `--file <path>` - Edited file
-- `--memory-key <key>` - Memory storage key
-- `--format` - Auto-format code
-
-## Examples
-```bash
-# Post-edit hook
-npx claude-flow hooks post-edit --file src/api.js
-
-# Store in memory
-npx claude-flow hooks post-edit --file src/api.js --memory-key "api-changes"
-
-# With formatting
-npx claude-flow hooks post-edit --file src/api.js --format
-```

package/.claude/commands/hooks/post-task.md

@@ -1,25 +0,0 @@
-# post-task
-
-Hook executed after task completion.
-
-## Usage
-```bash
-npx claude-flow hooks post-task [options]
-```
-
-## Options
-- `--task-id <id>` - Task identifier
-- `--analyze-performance` - Analyze task performance
-- `--update-memory` - Update swarm memory
-
-## Examples
-```bash
-# Basic post-task
-npx claude-flow hooks post-task --task-id task-123
-
-# With performance analysis
-npx claude-flow hooks post-task --task-id task-123 --analyze-performance
-
-# Update memory
-npx claude-flow hooks post-task --task-id task-123 --update-memory
-```

package/.claude/commands/hooks/pre-edit.md

@@ -1,25 +0,0 @@
-# pre-edit
-
-Hook executed before file edits.
-
-## Usage
-```bash
-npx claude-flow hooks pre-edit [options]
-```
-
-## Options
-- `--file <path>` - File to be edited
-- `--validate-syntax` - Validate syntax before edit
-- `--backup` - Create backup
-
-## Examples
-```bash
-# Pre-edit hook
-npx claude-flow hooks pre-edit --file src/api.js
-
-# With validation
-npx claude-flow hooks pre-edit --file src/api.js --validate-syntax
-
-# Create backup
-npx claude-flow hooks pre-edit --file src/api.js --backup
-```

package/.claude/commands/hooks/pre-task.md

@@ -1,100 +0,0 @@
-# hooks pre-task
-
-Execute pre-task preparations and context loading.
-
-## Usage
-
-```bash
-npx claude-flow hooks pre-task [options]
-```
-
-## Options
-
-- `--description, -d <text>` - Task description for context
-- `--auto-spawn-agents` - Automatically spawn required agents (default: true)
-- `--load-memory` - Load relevant memory from previous sessions
-- `--optimize-topology` - Select optimal swarm topology
-- `--estimate-complexity` - Analyze task complexity
-
-## Examples
-
-### Basic pre-task hook
-```bash
-npx claude-flow hooks pre-task --description "Implement user authentication"
-```
-
-### With memory loading
-```bash
-npx claude-flow hooks pre-task -d "Continue API development" --load-memory
-```
-
-### Manual agent control
-```bash
-npx claude-flow hooks pre-task -d "Debug issue #123" --auto-spawn-agents false
-```
-
-### Full optimization
-```bash
-npx claude-flow hooks pre-task -d "Refactor codebase" --optimize-topology --estimate-complexity
-```
-
-## Features
-
-### Auto Agent Assignment
-- Analyzes task requirements
-- Determines needed agent types
-- Spawns agents automatically
-- Configures agent parameters
-
-### Memory Loading
-- Retrieves relevant past decisions
-- Loads previous task contexts
-- Restores agent configurations
-- Maintains continuity
-
-### Topology Optimization
-- Analyzes task structure
-- Selects best swarm topology
-- Configures communication patterns
-- Optimizes for performance
-
-### Complexity Estimation
-- Evaluates task difficulty
-- Estimates time requirements
-- Suggests agent count
-- Identifies dependencies
-
-## Integration
-
-This hook is automatically called by Claude Code when:
-- Starting a new task
-- Resuming work after a break
-- Switching between projects
-- Beginning complex operations
-
-Manual usage in agents:
-```bash
-# In agent coordination
-npx claude-flow hooks pre-task --description "Your task here"
-```
-
-## Output
-
-Returns JSON with:
-```json
-{
-  "continue": true,
-  "topology": "hierarchical",
-  "agentsSpawned": 5,
-  "complexity": "medium",
-  "estimatedMinutes": 30,
-  "memoryLoaded": true
-}
-```
-
-## See Also
-
-- `hooks post-task` - Post-task cleanup
-- `agent spawn` - Manual agent creation
-- `memory usage` - Memory management
-- `swarm init` - Swarm initialization

package/.claude/commands/hooks/session-end.md

@@ -1,25 +0,0 @@
-# session-end
-
-Hook executed at session end.
-
-## Usage
-```bash
-npx claude-flow hooks session-end [options]
-```
-
-## Options
-- `--export-metrics` - Export session metrics
-- `--generate-summary` - Generate session summary
-- `--persist-state` - Save session state
-
-## Examples
-```bash
-# End session
-npx claude-flow hooks session-end
-
-# Export metrics
-npx claude-flow hooks session-end --export-metrics
-
-# Full closure
-npx claude-flow hooks session-end --export-metrics --generate-summary --persist-state
-```