claude-flow-novice 2.18.6 → 2.18.8

package/claude-assets/commands/deprecated/github.md

@@ -1,221 +0,0 @@
----
-description: "GitHub integration for repository management, PR automation, and collaboration"
-argument-hint: "<action> [repository] [options]"
-allowed-tools: ["Bash", "Read", "Write", "Grep", "mcp__claude-flow__github_repo_analyze", "mcp__claude-flow__github_pr_manage", "mcp__claude-flow__github_release_coord", "mcp__claude-flow__github_issue_track", "mcp__claude-flow__github_workflow_auto", "mcp__claude-flow__github_metrics", "mcp__claude-flow__agent_spawn", "mcp__claude-flow__memory_usage"]
----
-
-# GitHub Integration & Automation
-
-Comprehensive GitHub integration for repository management, automated workflows, and team collaboration.
-
-**Action**: $ARGUMENTS
-
-## Available Actions
-
-### Repository Management
-- `analyze <repo>` - Comprehensive repository analysis
-- `metrics <repo>` - Repository health and activity metrics
-- `security-scan <repo>` - Security vulnerability scanning
-- `performance-audit <repo>` - Performance and quality assessment
-
-### Pull Request Management
-- `pr create <title>` - Create PR with AI-generated description
-- `pr review <number>` - Automated code review with suggestions
-- `pr merge <number>` - Smart merge with conflict resolution
-- `pr status` - Show all open PRs with analysis
-
-### Issue Management
-- `issue create <title>` - Create issue with templates
-- `issue triage` - AI-powered issue triage and labeling
-- `issue assign` - Smart assignment based on expertise
-- `issue close <number>` - Close issue with summary
-
-### Release Management
-- `release create <version>` - Create release with changelog
-- `release notes <version>` - Generate release notes
-- `release deploy <version>` - Coordinate deployment
-
-### Workflow Automation
-- `workflow setup` - Configure GitHub Actions workflows
-- `workflow status` - Monitor workflow runs
-- `workflow optimize` - Optimize CI/CD performance
-
-## Key Features
-
-### 🔍 AI-Powered Repository Analysis
-
-#### Code Quality Assessment
-- **Architecture Analysis**: Design patterns, SOLID principles compliance
-- **Code Complexity**: Cyclomatic complexity, maintainability index
-- **Technical Debt**: Identification and prioritization
-- **Documentation Quality**: README, API docs, inline comments
-
-#### Security Analysis
-- **Vulnerability Scanning**: Dependencies, code patterns, configurations
-- **Secret Detection**: API keys, passwords, certificates
-- **Access Control**: Repository permissions and branch protection
-- **Supply Chain**: Dependency risk assessment
-
-#### Performance Metrics
-- **Build Performance**: CI/CD execution times, bottlenecks
-- **Code Performance**: Static analysis, performance patterns
-- **Repository Health**: Commit frequency, contributor activity
-- **Issue Resolution**: Response times, resolution rates
-
-### 🤖 Automated Code Review
-
-#### Intelligent PR Analysis
-- **Change Impact**: Affected components and systems
-- **Risk Assessment**: Breaking changes, security implications
-- **Test Coverage**: Missing tests, coverage impact
-- **Documentation**: Required documentation updates
-
-#### Review Automation
-- **Style Compliance**: Code formatting, naming conventions
-- **Best Practices**: Language-specific recommendations
-- **Performance Impact**: Bundle size, runtime performance
-- **Security Review**: Vulnerability patterns, secure coding
-
-### 📈 Advanced Metrics & Insights
-
-#### Team Productivity
-- **Contributor Analysis**: Activity patterns, expertise areas
-- **Collaboration Metrics**: PR review patterns, response times
-- **Knowledge Sharing**: Documentation contributions, mentoring
-- **Burnout Detection**: Workload analysis, health indicators
-
-#### Project Health
-- **Velocity Tracking**: Feature delivery, sprint performance
-- **Quality Trends**: Bug rates, test coverage over time
-- **Maintenance Load**: Technical debt, refactoring needs
-- **Community Growth**: Star/fork growth, issue engagement
-
-## Usage Examples
-
-### Repository Analysis
-```bash
-# Comprehensive repository analysis
-/github analyze myorg/myrepo
-
-# Output includes:
-# - Code quality score (1-10)
-# - Security vulnerability count
-# - Performance bottlenecks
-# - Improvement recommendations
-# - Contributor activity analysis
-```
-
-### PR Management
-```bash
-# Create PR with AI description
-/github pr create "Add user authentication"
-
-# Automated code review
-/github pr review 123
-
-# Output:
-# - Code quality assessment
-# - Security review
-# - Performance impact
-# - Test coverage analysis
-# - Suggested improvements
-```
-
-### Issue Triage
-```bash
-# AI-powered issue triage
-/github issue triage
-
-# Automatically:
-# - Labels issues by type/priority
-# - Assigns to appropriate team members
-# - Estimates effort/complexity
-# - Suggests related issues
-```
-
-### Release Management
-```bash
-# Create release with changelog
-/github release create v2.1.0
-
-# Automatically:
-# - Generates changelog from commits
-# - Identifies breaking changes
-# - Creates release notes
-# - Tags version and triggers deployment
-```
-
-## Sample Analysis Output
-
-```markdown
-# Repository Analysis: myorg/awesome-project
-
-## 🏆 Overall Health Score: 8.7/10
-
-### 🔍 Code Quality (9.2/10)
-- **Architecture**: Well-structured, follows SOLID principles
-- **Complexity**: Low average complexity (2.3/10)
-- **Documentation**: Comprehensive README, 85% API coverage
-- **Testing**: 94% code coverage, good test quality
-
-### 🛡️ Security (7.8/10)
-- **Vulnerabilities**: 2 medium-risk dependencies
-- **Secrets**: No exposed secrets detected
-- **Permissions**: Appropriate branch protection rules
-- **Recommendations**: Update lodash to v4.17.21
-
-### 🚀 Performance (8.5/10)
-- **Build Time**: 3.2 minutes (good)
-- **Bundle Size**: 245KB (acceptable)
-- **CI Efficiency**: 95% success rate
-- **Bottlenecks**: Database tests could be optimized
-
-### 📈 Team Metrics
-- **Active Contributors**: 12 (last 30 days)
-- **PR Response Time**: 4.2 hours average
-- **Issue Resolution**: 89% within SLA
-- **Knowledge Distribution**: Good (no single points of failure)
-
-## 📝 Recommendations
-1. **Security**: Update 2 vulnerable dependencies
-2. **Performance**: Optimize database test suite
-3. **Process**: Consider automated dependency updates
-4. **Documentation**: Add contribution guidelines
-```
-
-## Workflow Automation
-
-### CI/CD Optimization
-- **Pipeline Analysis**: Identify bottlenecks and optimization opportunities
-- **Parallel Execution**: Suggest parallelization strategies
-- **Caching**: Optimize build caches and artifact storage
-- **Resource Usage**: Monitor and optimize runner usage
-
-### Quality Gates
-- **Automated Testing**: Ensure comprehensive test coverage
-- **Security Scanning**: Integrate security checks into pipelines
-- **Performance Testing**: Monitor performance regressions
-- **Documentation**: Ensure documentation stays up-to-date
-
-## Multi-Repository Management
-
-### Organization Overview
-- **Repository Health Dashboard**: Cross-repo metrics and trends
-- **Dependency Management**: Shared dependency updates
-- **Security Compliance**: Organization-wide security policies
-- **Knowledge Sharing**: Cross-team learning and best practices
-
-### Release Coordination
-- **Multi-Repo Releases**: Coordinate releases across services
-- **Dependency Tracking**: Monitor inter-service dependencies
-- **Rollback Management**: Coordinate rollbacks across systems
-- **Communication**: Automated stakeholder notifications
-
-## Integration with Claude Flow
-
-- **Agent Coordination**: Deploy specialized GitHub agents
-- **Memory Persistence**: Remember repository context across sessions
-- **Learning**: Improve recommendations based on team patterns
-- **Automation**: Custom workflows based on team preferences
-
-Streamline your GitHub workflow with AI-powered automation and insights.

package/claude-assets/commands/deprecated/hello-world-tests.md

@@ -1,381 +0,0 @@
----
-description: "Run comprehensive hello-world test suite validating agent tooling, mesh coordination, review handoff, and SQLite storage"
-argument-hint: "[--layer=0|1|2|3|all] [--skip-validation]"
-allowed-tools: ["Bash", "Read", "TodoWrite", "Write"]
----
-
-# Hello World Tests - CFN Coordination Validation
-
-Run comprehensive 4-layer test suite validating core CFN coordination capabilities.
-
-**Test Scope**: $ARGUMENTS
-
-## Test Layers
-
-### Layer 0: Agent Tool Validation
-- ✅ **15 agent types** (coder, architect, tester, analyst, reviewer, backend-dev, code-analyzer, code-quality-validator, security-specialist, devops-engineer, api-docs, mobile-dev, base-template-generator, perf-analyzer, pseudocode)
-- ✅ **7 tools per agent** (Read, Write, Edit, Bash, Grep, Glob, TodoWrite)
-- ✅ **Success criteria**: All agents spawn, ≥5/7 tools working, 6 critical tools at 100%
-
-### Layer 1: Mesh Coordination
-- ✅ **2 peer coordinators** managing 35 combos each
-- ✅ **70 Hello World files** (7 languages × 10 translations)
-- ✅ **Redis pub/sub coordination** with claim negotiation
-- ✅ **SQLite persistence** for agent state and coordination history
-- ✅ **Success criteria**: 72 agents, 70 unique files, 0 conflicts, balanced distribution
-
-### Layer 2: Review Coordination
-- ✅ **Dynamic reviewer pool** (3-10 reviewers)
-- ✅ **Queue-driven spawning/despawning**
-- ✅ **Review handoff from implementers to reviewers**
-- ✅ **Success criteria**: All 70 files reviewed, queue depth ≤15, dynamic scaling observed
-
-### Layer 3: Error Handling
-- ✅ **50% error injection** with 4 error types
-- ✅ **Fresh agent spawning for retries**
-- ✅ **Exponential backoff** (100ms, 200ms, 400ms)
-- ✅ **Success criteria**: 50% initial failures, ≤10 retries per file, 100% final pass rate
-
-## Command Options
-
-```bash
-# Run all layers sequentially (default)
-/hello-world-tests
-
-# Run specific layer
-/hello-world-tests --layer=0    # Agent tooling only
-/hello-world-tests --layer=1    # Mesh coordination only
-/hello-world-tests --layer=2    # Review coordination only
-/hello-world-tests --layer=3    # Error handling only
-
-# Run multiple layers
-/hello-world-tests --layer=0,1  # Tooling + mesh
-
-# Skip validation (run tests without checking results)
-/hello-world-tests --skip-validation
-```
-
-## Execution Strategy
-
-You MUST execute the tests using the following autonomous workflow:
-
-### 1. Initialize Test Environment
-
-```bash
-# Verify Redis is running
-redis-cli ping  # Must return "PONG"
-
-# Create output directories
-mkdir -p test-results/layer0-tool-validation
-mkdir -p test-results/hello-world
-
-# Initialize SQLite database for coordination
-node tests/hello-world/lib/init-sqlite.js
-```
-
-### 2. Execute Test Layers Sequentially
-
-Parse the `--layer` argument to determine which layers to run:
-
-**Layer 0: Agent Tool Validation**
-```bash
-node tests/hello-world/layer0-tool-validation.js 2>&1 | tee test-results/layer0-output.log
-```
-- **Validates**: Agent tooling works (15 agents × 7 tools)
-- **Reports to**: `test-results/layer0-tool-validation/layer0-results.json`
-- **Must pass before**: Layer 1 mesh coordination
-
-**Layer 1: Mesh Coordination**
-```bash
-node tests/hello-world/layer1-mesh-coordination.js 2>&1 | tee test-results/layer1-output.log
-```
-- **Validates**: Peer-to-peer claim negotiation, SQLite state persistence
-- **Reports to**: `test-results/hello-world/layer1-results.json`
-- **Must pass before**: Layer 2 review coordination
-
-**Layer 2: Review Coordination** (if implemented)
-```bash
-node tests/hello-world/layer2-review-coordination.js 2>&1 | tee test-results/layer2-output.log
-```
-- **Validates**: Dynamic reviewer pool, review handoff
-- **Reports to**: `test-results/hello-world/layer2-results.json`
-- **Must pass before**: Layer 3 error handling
-
-**Layer 3: Error Handling** (if implemented)
-```bash
-node tests/hello-world/layer3-error-retry.js 2>&1 | tee test-results/layer3-output.log
-```
-- **Validates**: Error injection, retry coordination, SQLite retry history
-- **Reports to**: `test-results/hello-world/layer3-results.json`
-
-### 3. Validate Results (unless --skip-validation)
-
-After each layer completes, validate success criteria:
-
-```javascript
-const layerResults = JSON.parse(fs.readFileSync('test-results/layer0-tool-validation/layer0-results.json'));
-
-// Layer 0 validation
-if (!layerResults.summary.layerPassed) {
-  console.error('❌ Layer 0 FAILED:', layerResults.summary);
-  process.exit(1);
-}
-
-// Layer 1 validation
-if (!layer1Results.successCriteria.allMet) {
-  console.error('❌ Layer 1 FAILED:', layer1Results.successCriteria);
-  process.exit(1);
-}
-
-// Continue for Layer 2, 3...
-```
-
-### 4. Generate Combined Report
-
-After all layers complete:
-
-```javascript
-{
-  "testSuite": "Hello World CFN Coordination Tests",
-  "timestamp": "2025-10-13T18:45:00Z",
-  "layers": [
-    {
-      "layer": 0,
-      "name": "Agent Tool Validation",
-      "status": "PASSED",
-      "duration": "10.3 minutes",
-      "agents": 15,
-      "toolsValidated": 7,
-      "reportPath": "test-results/layer0-tool-validation/layer0-results.json"
-    },
-    {
-      "layer": 1,
-      "name": "Mesh Coordination",
-      "status": "PASSED",
-      "duration": "15.2 minutes",
-      "agents": 72,
-      "filesCreated": 70,
-      "conflicts": 0,
-      "sqliteWrites": 145,
-      "reportPath": "test-results/hello-world/layer1-results.json"
-    },
-    {
-      "layer": 2,
-      "name": "Review Coordination",
-      "status": "PASSED",
-      "duration": "12.1 minutes",
-      "reviewers": 7,
-      "reviewsCompleted": 70,
-      "reportPath": "test-results/hello-world/layer2-results.json"
-    },
-    {
-      "layer": 3,
-      "name": "Error Handling",
-      "status": "PASSED",
-      "duration": "18.4 minutes",
-      "initialFailures": 35,
-      "retries": 52,
-      "finalPassRate": "100%",
-      "reportPath": "test-results/hello-world/layer3-results.json"
-    }
-  ],
-  "summary": {
-    "totalDuration": "56.0 minutes",
-    "totalAgents": 170,
-    "totalLayers": 4,
-    "layersPassed": 4,
-    "layersFailed": 0,
-    "overallStatus": "✅ ALL TESTS PASSED"
-  },
-  "sqliteValidation": {
-    "databasePath": "./swarm-memory.db",
-    "totalWrites": 312,
-    "totalReads": 847,
-    "aclViolations": 0,
-    "encryptionVerified": true,
-    "performanceMs": {
-      "avgWrite": 45,
-      "avgRead": 12
-    }
-  }
-}
-```
-
-Save to: `test-results/hello-world/combined-report.json`
-
-### 5. SQLite Validation Requirements
-
-**Critical**: Each layer MUST validate SQLite storage is working:
-
-**Layer 0**: No SQLite validation (tooling-only)
-
-**Layer 1**: Validate SQLite coordinator state persistence
-```javascript
-// Store coordinator claims
-await memory.memoryAdapter.set(
-  `coordination:coordinator:${coordinatorId}:claimed`,
-  claimedCombos,
-  { agentId: coordinatorId, aclLevel: 2 } // Team level
-);
-
-// Verify storage worked
-const stored = await memory.memoryAdapter.get(
-  `coordination:coordinator:${coordinatorId}:claimed`,
-  { agentId: coordinatorId }
-);
-
-console.log(`✅ SQLite validation: ${stored.length} claims persisted`);
-```
-
-**Layer 2**: Validate SQLite review queue persistence
-```javascript
-// Store review assignments
-await memory.memoryAdapter.set(
-  `review:assignments:${reviewerId}`,
-  assignedFiles,
-  { agentId: reviewerId, aclLevel: 2 }
-);
-
-// Verify ACL enforcement
-try {
-  await memory.memoryAdapter.get(
-    `review:assignments:${reviewerId}`,
-    { agentId: 'wrong-agent' } // Should fail
-  );
-  throw new Error('ACL violation: unauthorized access succeeded');
-} catch (e) {
-  console.log('✅ SQLite ACL working: unauthorized access blocked');
-}
-```
-
-**Layer 3**: Validate SQLite retry history
-```javascript
-// Store retry attempts with encryption
-await memory.memoryAdapter.set(
-  `retry:history:${combo}`,
-  { attempts: retries, errors: errorLog },
-  { agentId: coordinatorId, aclLevel: 1, encrypted: true } // Private, encrypted
-);
-
-// Verify encryption
-const encrypted = await memory.memoryAdapter.getRaw(`retry:history:${combo}`);
-if (!encrypted.includes('encrypted:')) {
-  throw new Error('SQLite encryption failed');
-}
-
-console.log('✅ SQLite encryption verified');
-```
-
-## Final Report
-
-Print comprehensive summary:
-
-```
-══════════════════════════════════════════════════════════════════════
-HELLO WORLD CFN COORDINATION TEST SUITE - COMPLETE
-══════════════════════════════════════════════════════════════════════
-
-📊 Overall Results:
-  Total Duration: 56.0 minutes
-  Total Agents: 170
-  Layers Passed: 4/4
-  Overall Status: ✅ ALL TESTS PASSED
-
-🔧 Layer 0: Agent Tool Validation
-  Status: ✅ PASSED
-  Agents: 15
-  Tools Validated: 7
-  Success Rate: 100%
-
-🤝 Layer 1: Mesh Coordination
-  Status: ✅ PASSED
-  Coordinators: 2
-  Files Created: 70
-  Conflicts: 0
-  SQLite Writes: 145
-
-👥 Layer 2: Review Coordination
-  Status: ✅ PASSED
-  Reviewers: 7
-  Reviews Completed: 70
-  Queue Depth Max: 12
-
-🔄 Layer 3: Error Handling
-  Status: ✅ PASSED
-  Initial Failures: 35 (50%)
-  Retries: 52
-  Final Pass Rate: 100%
-
-💾 SQLite Validation:
-  Total Writes: 312
-  Total Reads: 847
-  ACL Violations: 0
-  Encryption: ✅ Verified
-  Avg Write: 45ms
-  Avg Read: 12ms
-
-📄 Detailed Reports:
-  - test-results/layer0-tool-validation/layer0-results.json
-  - test-results/hello-world/layer1-results.json
-  - test-results/hello-world/layer2-results.json
-  - test-results/hello-world/layer3-results.json
-  - test-results/hello-world/combined-report.json
-
-══════════════════════════════════════════════════════════════════════
-✅ CFN COORDINATION VALIDATION COMPLETE
-══════════════════════════════════════════════════════════════════════
-```
-
-## Error Handling
-
-If any layer fails:
-
-1. **Stop execution** (don't proceed to next layer)
-2. **Print failure details** from JSON report
-3. **Save partial combined report** with failed layer marked
-4. **Exit with code 1**
-
-Example failure output:
-```
-❌ Layer 1 FAILED: Mesh Coordination
-
-Failure Reason: Conflict resolution failed
-  Expected: 0 conflicts
-  Actual: 3 conflicts
-  Details: Coordinators coord-a and coord-b claimed same combo 3 times
-
-📄 Full Report: test-results/hello-world/layer1-results.json
-
-⚠️  Cannot proceed to Layer 2 until Layer 1 passes.
-```
-
-## TodoWrite Tracking
-
-Use TodoWrite to track test progress:
-
-```javascript
-[
-  { "content": "Initialize test environment (Redis, SQLite, dirs)", "status": "in_progress" },
-  { "content": "Run Layer 0: Agent Tool Validation", "status": "pending" },
-  { "content": "Validate Layer 0 results", "status": "pending" },
-  { "content": "Run Layer 1: Mesh Coordination", "status": "pending" },
-  { "content": "Validate Layer 1 results + SQLite", "status": "pending" },
-  { "content": "Run Layer 2: Review Coordination", "status": "pending" },
-  { "content": "Validate Layer 2 results + SQLite ACL", "status": "pending" },
-  { "content": "Run Layer 3: Error Handling", "status": "pending" },
-  { "content": "Validate Layer 3 results + SQLite encryption", "status": "pending" },
-  { "content": "Generate combined report", "status": "pending" },
-  { "content": "Print final summary", "status": "pending" }
-]
-```
-
-Update status as each layer completes.
-
-## References
-
-- **Test Suite**: `tests/hello-world/README.md`
-- **Architecture**: `tests/hello-world/ARCHITECTURE.md`
-- **Layer 0 Test**: `tests/hello-world/layer0-tool-validation.js`
-- **Layer 1 Test**: `tests/hello-world/layer1-mesh-coordination.js`
-- **SQLite Memory**: `src/sqlite/MemoryStoreAdapter.cjs`
-- **CFN Loop Guide**: `docs/cfn-loop/CFN_LOOP_COMPLETE_GUIDE.md`