npm - claude-flow-novice - Versions diffs - 2.10.5 → 2.10.7 - Mend

claude-flow-novice 2.10.5 → 2.10.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (694) hide show

package/claude-assets/commands/cfn/github-commit.md ADDED Viewed

@@ -0,0 +1,289 @@
+---
+description: "Analyze staged changes, commit, push, and monitor CI/CD pipeline status"
+argument-hint: "[--chat|--full]"
+allowed-tools: ["Bash", "Read", "Grep", "Glob", "BashOutput", "TodoWrite"]
+---
+# GitHub Commit - Automated Git Workflow with CI/CD Monitoring
+Analyze staged changes, create commits, push to remote, and monitor CI/CD pipeline execution.
+🚨 **AUTOMATED GIT WORKFLOW WITH CI/CD MONITORING**
+**Options**: $ARGUMENTS
+## Command Modes
+```bash
+/github-commit              # Analyze all staged changes in repository
+/github-commit --chat       # Only analyze changes made in current chat session
+/github-commit --full       # Full repository analysis with detailed metrics
+```
+## Execution Pattern
+### Step 1: Analyze Changes
+```bash
+# Determine scope based on flags
+if [[ "$ARGUMENTS" == *"--chat"* ]]; then
+  # Get files modified in current session
+  git diff --name-only HEAD
+else
+  # Get all staged changes
+  git status --porcelain
+  git diff --staged
+fi
+```
+### Step 2: Generate Commit Message
+```bash
+# Analyze changes and draft commit message
+git diff --staged --stat
+git log -3 --oneline  # Match repository commit style
+# Generate commit message following conventional commits:
+# - feat: New feature
+# - fix: Bug fix
+# - refactor: Code refactoring
+# - docs: Documentation updates
+# - test: Test additions/modifications
+# - chore: Maintenance tasks
+```
+### Step 3: Create Commit
+```bash
+git add <relevant-files>
+git commit -m "$(cat <<'EOF'
+<type>(<scope>): <subject>
+<body - explain WHY not WHAT>
+EOF
+)"
+```
+### Step 4: Push to Remote
+```bash
+# Get current branch
+BRANCH=$(git rev-parse --abbrev-ref HEAD)
+# Push with upstream tracking
+git push -u origin "$BRANCH"
+```
+### Step 5: Monitor CI/CD Pipeline
+```bash
+# Wait for CI/CD to start (5 second delay)
+sleep 5
+# Monitor GitHub Actions workflow status
+gh run list --branch "$BRANCH" --limit 1 --json status,conclusion,name,databaseId
+# Poll every 10 seconds until completion
+while true; do
+  STATUS=$(gh run view --json status,conclusion -q '.status,.conclusion')
+  if [[ "$STATUS" == *"completed"* ]]; then
+    # Check if successful or failed
+    if [[ "$STATUS" == *"success"* ]]; then
+      echo "✅ CI/CD Pipeline PASSED"
+      break
+    else
+      echo "❌ CI/CD Pipeline FAILED"
+      gh run view --log-failed
+      exit 1
+    fi
+  fi
+  sleep 10
+done
+```
+## Flags
+### --chat (Session Scope)
+**Purpose**: Only commit changes made during current chat session
+**Implementation**:
+```bash
+# Get session start time (approximate)
+SESSION_START=$(date -d "30 minutes ago" +%s)
+# Find files modified after session start
+git diff --name-only HEAD | while read file; do
+  FILE_MTIME=$(stat -c %Y "$file")
+  if [ "$FILE_MTIME" -gt "$SESSION_START" ]; then
+    echo "$file"
+  fi
+done
+```
+### --full (Comprehensive Analysis)
+**Purpose**: Full repository analysis with metrics
+**Implementation**:
+```bash
+# Generate comprehensive change analysis
+echo "## Change Summary"
+git diff --staged --stat
+git diff --staged --shortstat
+echo "## File Changes"
+git diff --staged --name-status
+echo "## Impact Analysis"
+# Count lines added/removed by file type
+git diff --staged --numstat | awk '
+  {
+    files++
+    add += $1
+    del += $2
+    if ($3 ~ /\.ts$|\.tsx$/) ts++
+    if ($3 ~ /\.js$|\.jsx$/) js++
+    if ($3 ~ /\.md$/) docs++
+  }
+  END {
+    print "Files modified: " files
+    print "Lines added: " add
+    print "Lines removed: " del
+    print "TypeScript files: " ts
+    print "JavaScript files: " js
+    print "Documentation: " docs
+  }
+'
+```
+## CI/CD Monitoring
+### Supported Platforms
+- **GitHub Actions** (via `gh` CLI)
+- **GitLab CI** (via `glab` CLI)
+- **CircleCI** (via API)
+- **Jenkins** (via API)
+### Failure Handling
+```bash
+# On CI/CD failure
+if [[ "$CI_STATUS" == "failure" ]]; then
+  echo "❌ Pipeline failed. Retrieving logs..."
+  # Get failed job logs
+  gh run view --log-failed
+  # Offer rollback option
+  echo ""
+  echo "Options:"
+  echo "1. Fix locally and push again"
+  echo "2. Revert commit: git revert HEAD && git push"
+  echo "3. Force fix: git commit --amend && git push --force-with-lease"
+fi
+```
+## Output Format
+```
+Analyzing staged changes...
+Files to commit (--chat scope):
+  M src/cfn-loop/crash-detector.ts
+  M src/cli/commands/recovery-resume.ts
+  A tests/cfn-loop/crash-detection.test.ts
+Commit message:
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+feat(cfn-loop): Add crash detection and recovery
+Implement crash detection system with automatic
+recovery and resume capabilities for interrupted
+CFN Loop executions.
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Creating commit...
+✅ Commit created: abc1234
+Pushing to origin/main...
+✅ Push successful
+Monitoring CI/CD pipeline...
+⏳ GitHub Actions workflow starting...
+⏳ Running tests (1/3 jobs complete)...
+⏳ Running build (2/3 jobs complete)...
+⏳ Running deploy (3/3 jobs complete)...
+✅ CI/CD Pipeline PASSED (2m 34s)
+All checks passed. Changes successfully deployed.
+```
+## Safety Features
+### Pre-Commit Validation
+```bash
+# Run pre-commit hooks if configured
+if [ -f .git/hooks/pre-commit ]; then
+  .git/hooks/pre-commit
+fi
+# Validate no secrets in staged files
+git diff --staged | grep -i -E "(api[_-]?key|password|secret|token)" && {
+  echo "⚠️  Warning: Potential secrets detected in staged changes"
+  echo "Please review before committing"
+  exit 1
+}
+```
+### Branch Protection
+```bash
+# Never force push to protected branches
+PROTECTED_BRANCHES=("main" "master" "production")
+if [[ " ${PROTECTED_BRANCHES[@]} " =~ " ${BRANCH} " ]]; then
+  echo "⚠️  Warning: Pushing to protected branch '$BRANCH'"
+  echo "Force push disabled for safety"
+  git push origin "$BRANCH"  # No --force
+fi
+```
+## Integration with Other Commands
+- **Pre-commit**: Runs `/hooks post-edit` validation
+- **Post-push**: Triggers `/github workflow status` monitoring
+- **On failure**: Suggests `/github pr create` for review before merge
+- **Documentation**: Auto-triggers `/cfn-loop-document` on epic completion
+## Example Workflows
+### Daily Development
+```bash
+# Make changes throughout the day
+# Ready to commit
+/github-commit --chat
+# Output: Commits only files modified in current session
+```
+### Feature Completion
+```bash
+# Completed feature implementation
+/github-commit --full
+# Output: Full analysis with metrics, CI/CD monitoring
+```
+### Hotfix Deployment
+```bash
+# Critical bug fix
+/github-commit
+# Monitors CI/CD closely
+# On success: Auto-deploys to production
+# On failure: Immediately shows logs and rollback options
+```

package/claude-assets/commands/cfn/github.md ADDED Viewed

@@ -0,0 +1,221 @@
+---
+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.