pipecraft 0.0.0-releaseit

package/tests/fixtures/test-config.json

@@ -0,0 +1,58 @@
+{
+    "ciProvider": "github",
+    "mergeStrategy": "fast-forward",
+    "requireConventionalCommits": true,
+    "initialBranch": "alpha",
+    "finalBranch": "epsilon",
+    "branchFlow": [
+      "alpha",
+      "beta",
+      "gamma",
+      "delta",
+      "epsilon"
+    ],
+    "semver": {
+      "bumpRules": {
+        "feat": "minor",
+        "fix": "patch",
+        "breaking": "major"
+      }
+    },
+    "actions": {
+      "onDevelopMerge": [
+        "runTests",
+        "fastForwardToStaging"
+      ],
+      "onStagingMerge": [
+        "runTests",
+        "calculateVersion",
+        "createOrFastForwardToMain"
+      ]
+    },
+    "domains": {
+      "fake-domain1": {
+        "paths": [
+          "apps/fake-domain1/**"
+        ],
+        "description": "fake-domain1 application changes"
+      },
+      "fake-domain2": {
+        "paths": [
+          "apps/fake-domain2/**"
+        ],
+        "description": "fake-domain2 application changes"
+      },
+      "fake-domain3": {
+        "paths": [
+          "libs/fake-domain3/**"
+        ],
+        "description": "fake-domain3 application changes"
+      },
+      "fake-domain4": {
+        "paths": [
+          ".github/workflows/fake-domain4/**"
+        ],
+        "description": "fake-domain4 application changes"
+      }
+    }
+  }

package/tests/github-live/README.md

@@ -0,0 +1,250 @@
+# GitHub Actions Live Testing
+
+This directory contains tests for running GitHub Actions workflows on actual GitHub infrastructure.
+
+## 🎯 Purpose
+
+Live GitHub Actions testing allows us to:
+- Test workflows in the real GitHub environment
+- Validate workflow behavior with actual GitHub APIs
+- Test performance under real conditions
+- Debug issues that only occur in the live environment
+- Validate workflow reliability and stability
+
+## 📁 Structure
+
+```
+tests/github-live/
+├── README.md                 # This file
+├── run-live-tests.sh         # Main test runner script
+├── setup-test-env.sh         # Environment setup script
+├── test-workflows.sh         # Individual workflow testing
+├── fixtures/                  # Test data and configurations
+│   ├── test-configs/         # Test configurations
+│   ├── mock-data/            # Mock data for workflows
+│   └── expected-outputs/     # Expected test outputs
+└── helpers/                  # Test helper scripts
+    ├── github-runner.sh      # GitHub Actions execution helper
+    └── workflow-monitor.sh    # Workflow monitoring helper
+```
+
+## 🚀 Quick Start
+
+### Prerequisites
+```bash
+# Install GitHub CLI
+brew install gh  # macOS
+# Or download from: https://cli.github.com/
+
+# Authenticate with GitHub
+gh auth login
+
+# Set up GitHub token
+export GITHUB_TOKEN="your_github_token"
+```
+
+### Running Tests
+```bash
+# Run all live tests
+./tests/github-live/run-live-tests.sh
+
+# Test specific workflow
+./tests/github-live/test-workflows.sh --workflow pipeline.yml
+
+# Run with verbose output
+./tests/github-live/run-live-tests.sh --verbose
+
+# Run with debug mode
+./tests/github-live/run-live-tests.sh --debug
+```
+
+## 🔧 Configuration
+
+### GitHub Authentication
+```bash
+# Set up GitHub token
+export GITHUB_TOKEN="your_github_token"
+
+# Or use GitHub CLI
+gh auth token
+```
+
+### Test Environment
+```bash
+# Set up test environment
+./tests/github-live/setup-test-env.sh
+
+# This creates:
+# - Test repository setup
+# - Workflow trigger configuration
+# - Test data and fixtures
+# - Monitoring setup
+```
+
+## 📋 Test Workflows
+
+### Supported Workflows
+- **pipeline.yml**: Main workflow orchestration
+- **job.changes.yml**: Change detection workflow
+- **job.version.yml**: Version management workflow
+- **job.tag.yml**: Tag creation workflow
+- **job.createpr.yml**: PR creation workflow
+- **job.branch.yml**: Branch management workflow
+- **job.apps.yml**: Application-specific workflows
+
+### Test Scenarios
+1. **Basic Execution**: Test workflow runs without errors
+2. **Environment Variables**: Test with different env vars
+3. **Conditional Logic**: Test workflow conditions and branches
+4. **Job Dependencies**: Test job dependency chains
+5. **Error Handling**: Test failure scenarios
+6. **Performance**: Test execution time and resource usage
+7. **API Limits**: Test GitHub API rate limiting
+8. **Concurrency**: Test parallel workflow execution
+
+## 🧪 Test Examples
+
+### Basic Workflow Test
+```bash
+# Test main pipeline
+./tests/github-live/test-workflows.sh --workflow pipeline.yml
+
+# Test with specific event
+./tests/github-live/test-workflows.sh --workflow pipeline.yml --event push
+
+# Test with environment variables
+./tests/github-live/test-workflows.sh --workflow pipeline.yml --env GITHUB_REF=refs/heads/main
+```
+
+### Advanced Testing
+```bash
+# Test with secrets
+./tests/github-live/test-workflows.sh --workflow pipeline.yml --secrets GITHUB_TOKEN=your_token
+
+# Test with artifacts
+./tests/github-live/test-workflows.sh --workflow pipeline.yml --artifacts
+
+# Test with matrix strategy
+./tests/github-live/test-workflows.sh --workflow pipeline.yml --matrix os:ubuntu-latest,node:18
+```
+
+## 🔍 Debugging
+
+### Common Issues
+1. **Authentication**: Verify GitHub token permissions
+2. **Rate limits**: Check GitHub API rate limits
+3. **Workflow syntax**: Check YAML syntax and GitHub Actions syntax
+4. **Environment variables**: Verify all required env vars are set
+5. **Secrets**: Ensure all required secrets are available
+
+### Debug Commands
+```bash
+# List available workflows
+gh workflow list
+
+# Show workflow details
+gh workflow view pipeline.yml
+
+# Run workflow manually
+gh workflow run pipeline.yml
+
+# Check workflow runs
+gh run list
+
+# View workflow logs
+gh run view <run-id>
+```
+
+## 📊 Test Results
+
+### Output Format
+```
+✅ Workflow: pipeline.yml
+  ✅ Job: changes (2.3s)
+  ✅ Job: versioning (1.8s)
+  ✅ Job: deployments (4.2s)
+  ⚠️  Job: testing (skipped - no changes)
+
+❌ Workflow: job.changes.yml
+  ❌ Job: changes (failed - missing env var)
+  📝 Error: GITHUB_TOKEN not set
+```
+
+### Performance Metrics
+- **Execution Time**: Track workflow execution time
+- **Resource Usage**: Monitor CPU and memory usage
+- **Job Dependencies**: Validate dependency chains
+- **Error Rates**: Track failure rates and patterns
+- **API Usage**: Monitor GitHub API usage
+
+## 🔄 Continuous Integration
+
+### GitHub Actions Integration
+```yaml
+name: Live Tests
+on: [push, pull_request]
+jobs:
+  live-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run Live Tests
+        run: ./tests/github-live/run-live-tests.sh
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+### Local Development
+```bash
+# Watch mode for development
+./tests/github-live/run-live-tests.sh --watch
+
+# Run specific test suite
+./tests/github-live/run-live-tests.sh --suite pipeline
+
+# Run with coverage
+./tests/github-live/run-live-tests.sh --coverage
+```
+
+## 📚 Best Practices
+
+### Test Organization
+1. **Group related tests**: Organize tests by workflow type
+2. **Use fixtures**: Create reusable test data
+3. **Mock external services**: Avoid external dependencies where possible
+4. **Test edge cases**: Include error scenarios and edge cases
+
+### Performance
+1. **Parallel execution**: Run independent tests in parallel
+2. **Resource management**: Monitor GitHub Actions resource usage
+3. **Cleanup**: Clean up test artifacts after runs
+4. **Rate limiting**: Respect GitHub API rate limits
+
+### Maintenance
+1. **Regular updates**: Keep test dependencies updated
+2. **Documentation**: Document test scenarios and expected outcomes
+3. **Monitoring**: Track test performance and reliability
+4. **Feedback**: Collect feedback from test results
+
+## 🆘 Troubleshooting
+
+### Common Problems
+```bash
+# GitHub token issues
+gh auth status
+
+# Workflow syntax errors
+gh workflow view pipeline.yml
+
+# Environment variable issues
+gh workflow run pipeline.yml --env GITHUB_REF=refs/heads/main
+
+# Rate limit issues
+gh api rate_limit
+```
+
+### Getting Help
+- [GitHub CLI Documentation](https://cli.github.com/)
+- [GitHub Actions Documentation](https://docs.github.com/en/actions)
+- [GitHub API Documentation](https://docs.github.com/en/rest)
+- [Project Issues](https://github.com/your-org/pipecraft/issues)

package/tests/github-local/JOB_WORKFLOW_TESTS.md

@@ -0,0 +1,296 @@
+# Job Workflow Testing Guide
+
+This document outlines the testing strategy for each job workflow generated by Pipecraft.
+
+## 📋 Job Workflow Overview
+
+### 1. Changes Workflow (`job.changes.yml`)
+**Purpose**: Detects which domains have changed between branches
+**Key Features**:
+- Uses `dorny/paths-filter@v3` to detect changes
+- Supports multi-branch flow (develop → test → staging → main)
+- Outputs boolean flags for each domain
+- Forces full deployment on main/staging/test branches
+
+**Test Scenarios**:
+- Different branch references (main, develop, staging, test)
+- Path filtering for each domain
+- Branch flow logic validation
+- Output generation for all domains
+
+### 2. Version Workflow (`job.version.yml`)
+**Purpose**: Calculates semantic version based on conventional commits
+**Key Features**:
+- Analyzes commits since last tag
+- Determines version bump type (major/minor/patch)
+- Supports conventional commit format
+- Outputs current, next, and version type
+
+**Test Scenarios**:
+- Different base references (main, develop, staging)
+- Various commit types (feat, fix, breaking)
+- Version calculation logic
+- Output validation
+
+### 3. Tag Workflow (`job.tag.yml`)
+**Purpose**: Creates and pushes Git tags for releases
+**Key Features**:
+- Validates version format (v1.2.3)
+- Checks for existing tags
+- Creates annotated tags with messages
+- Pushes tags to remote repository
+
+**Test Scenarios**:
+- Valid version formats (v1.0.0, v1.2.3, v2.0.0)
+- Invalid version formats
+- Existing tag detection
+- Tag creation and pushing
+
+### 4. CreatePR Workflow (`job.createpr.yml`)
+**Purpose**: Creates pull requests between branches
+**Key Features**:
+- Checks for existing PRs
+- Creates PRs with title, body, and labels
+- Supports different branch combinations
+- Returns PR number and URL
+
+**Test Scenarios**:
+- Different branch combinations (develop→main, feature→develop)
+- PR title and body validation
+- Label assignment
+- Existing PR detection
+
+### 5. Branch Workflow (`job.branch.yml`)
+**Purpose**: Manages branch operations (fast-forward, create, delete)
+**Key Features**:
+- Fast-forward merging
+- Branch creation from source
+- Branch deletion (local and remote)
+- Input validation for each action
+
+**Test Scenarios**:
+- Fast-forward operations
+- Branch creation
+- Branch deletion
+- Input validation
+- Error handling
+
+### 6. Apps Workflow (`job.apps.yml`)
+**Purpose**: Deploys applications to different environments
+**Key Features**:
+- Environment-specific configuration
+- Multi-domain deployment
+- Version management
+- Deployment status tracking
+
+**Test Scenarios**:
+- Different environments (development, staging, production)
+- Various domain combinations
+- Version handling
+- Deployment status validation
+
+## 🧪 Testing Strategy
+
+### Unit Testing
+Each workflow is tested in isolation with:
+- Mock inputs and environment variables
+- Validation of workflow syntax
+- Step-by-step execution verification
+- Output validation
+
+### Integration Testing
+Workflows are tested with:
+- Real GitHub Actions environment simulation
+- Cross-workflow dependencies
+- End-to-end scenarios
+- Error handling and recovery
+
+### End-to-End Testing
+Complete workflows are tested with:
+- Real repository scenarios
+- Multiple workflow combinations
+- Performance testing
+- User experience validation
+
+## 🔧 Test Configuration
+
+### Environment Setup
+```bash
+# Required environment variables
+export GITHUB_ACTIONS=true
+export GITHUB_WORKFLOW=test-workflow
+export GITHUB_RUN_ID=123456789
+export GITHUB_RUN_NUMBER=1
+export GITHUB_ACTOR=test-user
+export GITHUB_REPOSITORY=test-org/test-repo
+export GITHUB_EVENT_NAME=push
+export GITHUB_SHA=abc123def456
+export GITHUB_REF=refs/heads/main
+export GITHUB_HEAD_REF=""
+export GITHUB_BASE_REF=""
+export GITHUB_WORKSPACE=/path/to/project
+export GITHUB_TOKEN=test-token
+```
+
+### Test Data
+```bash
+# Test configurations
+export TEST_DOMAINS="api,web,libs"
+export TEST_BRANCHES="main,develop,staging"
+export TEST_VERSIONS="v1.0.0,v1.2.3,v2.0.0"
+export TEST_ENVIRONMENTS="development,staging,production"
+```
+
+## 📊 Test Results
+
+### Success Criteria
+- ✅ Workflow syntax validation
+- ✅ Step execution without errors
+- ✅ Output generation
+- ✅ Error handling
+- ✅ Performance within limits
+
+### Failure Scenarios
+- ❌ Syntax errors
+- ❌ Missing inputs
+- ❌ Invalid configurations
+- ❌ Timeout errors
+- ❌ Permission issues
+
+## 🚀 Running Tests
+
+### Individual Workflow Tests
+```bash
+# Test specific workflow
+./tests/github-local/test-job-workflows.sh -w job.changes.yml
+
+# Test with verbose output
+./tests/github-local/test-job-workflows.sh -w job.version.yml -v
+
+# Test with debug mode
+./tests/github-local/test-job-workflows.sh -w job.tag.yml -d
+```
+
+### All Workflow Tests
+```bash
+# Test all workflows
+./tests/github-local/test-job-workflows.sh
+
+# Test with verbose output
+./tests/github-local/test-job-workflows.sh -v
+
+# Test with debug mode
+./tests/github-local/test-job-workflows.sh -d
+```
+
+## 🔍 Debugging
+
+### Common Issues
+1. **Workflow syntax errors**: Check YAML formatting
+2. **Missing inputs**: Verify all required inputs are provided
+3. **Permission issues**: Check GitHub token permissions
+4. **Environment variables**: Verify all required env vars are set
+5. **Docker issues**: Ensure Docker is running
+
+### Debug Commands
+```bash
+# List available workflows
+act --list
+
+# Show workflow details
+act -W .github/workflows/job.changes.yml --list
+
+# Run with verbose output
+act -W .github/workflows/job.changes.yml --verbose
+
+# Run with debug output
+act -W .github/workflows/job.changes.yml --debug
+```
+
+## 📈 Performance Testing
+
+### Metrics
+- **Execution time**: Track workflow execution time
+- **Resource usage**: Monitor CPU and memory usage
+- **Step duration**: Measure individual step performance
+- **Error rates**: Track failure rates and patterns
+
+### Benchmarks
+- Changes workflow: < 30 seconds
+- Version workflow: < 20 seconds
+- Tag workflow: < 15 seconds
+- CreatePR workflow: < 25 seconds
+- Branch workflow: < 20 seconds
+- Apps workflow: < 60 seconds
+
+## 🔄 Continuous Integration
+
+### GitHub Actions Integration
+```yaml
+name: Job Workflow Tests
+on: [push, pull_request]
+jobs:
+  test-job-workflows:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install Act
+        run: curl https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash
+      - name: Run Job Workflow Tests
+        run: ./tests/github-local/test-job-workflows.sh
+```
+
+### Local Development
+```bash
+# Watch mode for development
+./tests/github-local/test-job-workflows.sh --watch
+
+# Run specific test suite
+./tests/github-local/test-job-workflows.sh --suite changes
+
+# Run with coverage
+./tests/github-local/test-job-workflows.sh --coverage
+```
+
+## 📚 Best Practices
+
+### Test Organization
+1. **Group related tests**: Organize tests by workflow type
+2. **Use fixtures**: Create reusable test data
+3. **Mock external services**: Avoid external dependencies
+4. **Test edge cases**: Include error scenarios and edge cases
+
+### Performance
+1. **Parallel execution**: Run independent tests in parallel
+2. **Resource management**: Monitor Docker resource usage
+3. **Cleanup**: Clean up test artifacts after runs
+4. **Caching**: Use Docker layer caching for faster builds
+
+### Maintenance
+1. **Regular updates**: Keep Act and test dependencies updated
+2. **Documentation**: Document test scenarios and expected outcomes
+3. **Monitoring**: Track test performance and reliability
+4. **Feedback**: Collect feedback from test results
+
+## 🆘 Troubleshooting
+
+### Common Problems
+```bash
+# Act not found
+export PATH=$PATH:/usr/local/bin
+
+# Docker permission denied
+sudo usermod -aG docker $USER
+
+# Workflow syntax errors
+act -W .github/workflows/job.changes.yml --dry-run --verbose
+
+# Environment variable issues
+act -W .github/workflows/job.changes.yml --env-file .env
+```
+
+### Getting Help
+- [Act Documentation](https://github.com/nektos/act)
+- [GitHub Actions Documentation](https://docs.github.com/en/actions)
+- [Docker Documentation](https://docs.docker.com/)
+- [Project Issues](https://github.com/your-org/pipecraft/issues)