pyqual.yaml

pipeline:
  name: quality-loop-with-llx

  # Quality gates — pipeline iterates until ALL pass
  metrics:
    cc_max: 15           # cyclomatic complexity per function
    vallm_pass_min: 85   # vallm validation pass rate (%) — realistic for current codebase
    coverage_min: 55     # test coverage (%) — realistic for current codebase
    completion_rate_min: 75  # percentage of passed gates required for closure — realistic threshold
    # Security gates (uncomment to enable):
    # vuln_high_max: 0     # pip-audit high severity CVEs
    # bandit_high_max: 0   # bandit high severity issues
    # secrets_found_max: 0 # trufflehog/gitleaks secrets

  # Pipeline stages — use 'tool:' for built-in presets or 'run:' for custom
  stages:
    # Verify/install all tool dependencies before pipeline starts
    - name: setup
      run: |
        set -e
        echo "=== pyqual dependency check ==="
        # Python tools (pip)
        for pkg in code2llm vallm prefact llx pytest-cov goal; do
          if python -m pip show "$pkg" >/dev/null 2>&1; then
            echo "  ✓ $pkg"
          else
            echo "  ✗ $pkg — installing…"
            pip install -q "$pkg" || echo "  ⚠ $pkg install failed (optional)"
          fi
        done
        # Node tools (claude)
        if command -v claude >/dev/null 2>&1; then
          echo "  ✓ claude $(claude --version 2>/dev/null)"
        else
          echo "  ✗ claude — installing…"
          npm install -g --prefix="$HOME/.local" @anthropic-ai/claude-code 2>/dev/null \
            && echo "  ✓ claude installed" \
            || echo "  ⚠ claude install failed (fix stage will use llx fallback)"
        fi
        # Claude Code auth can be either:
        # - local OAuth session via `claude auth login`
        # - ANTHROPIC_API_KEY in CI/GitHub Actions
        # We only verify the CLI is available here.
        echo "=== setup done ==="
      when: first_iteration
      timeout: 300

    - name: setup_tasks
      run: |
        planfile sync github
        planfile sync markdown
      when: first_iteration
      optional: true

    # - name: analyze
    #   tool: code2llm
    #   when: first_iteration

    # - name: validate
    #   run: vallm batch pyqual tests --recursive --format toon --output ./project
    #   when: always

    # Security scans (uncomment to enable):
    # - name: audit
    #   tool: pip-audit
    #   optional: true
    # - name: bandit
    #   tool: bandit
    #   optional: true

    - name: test
      tool: pytest
      optional: true

    - name: prefact
      tool: prefact
      optional: true
      when: metrics_fail
      timeout: 900

    # Custom fix - uses explicit LLM_MODEL (openrouter/openai/gpt-5-mini)
    - name: fix
      run: |
        export PATH="$HOME/.local/bin:$PATH"
        echo "Using model: ${LLM_MODEL:-openrouter/openai/gpt-5-mini}"
        python3 pyqual/custom_fix.py 2>&1 | tee .pyqual/fix_output.log
      when: metrics_fail
      timeout: 1800

    - name: verify
      run: vallm batch pyqual tests --recursive --format toon --output ./project
      optional: true
      when: after_fix
      timeout: 300

    # Generate metrics report (YAML) and update README.md badges
    - name: report
      tool: report
      when: always
      optional: true

    # Continuous improvement: process TODO.md items when all gates pass
    # Uses parallel execution with multiple tools (Claude Code + llx)
    - name: todo_fix
      run: python3 -m pyqual.run_parallel_fix
      when: metrics_pass
      optional: true
      timeout: 1800

    # Simple git push (goal push had "Argument list too long" issue with many files)
    - name: push
      run: |
        if [ -n "$(git status --porcelain)" ]; then
          git add -A
          git commit -m "chore: pyqual auto-commit [skip ci]" 2>/dev/null || true
          git push origin HEAD
        else
          echo "No changes to push"
        fi
      when: after_fix
      optional: true
      timeout: 120

    - name: publish
      run: make publish
      when: after_fix
      optional: true
      timeout: 300

    - name: close_tasks
      run: |
        export PYTHONPATH=$PYTHONPATH:.
        python3 pyqual/auto_closer.py
        planfile sync all
      when: after_fix
      optional: true

    # Generate comprehensive markdown report with Mermaid diagram and ASCII flow
    - name: markdown_report
      run: python3 -m pyqual.report_generator
      when: always
      optional: true
      timeout: 30

  # Loop behavior
  loop:
    max_iterations: 3
    on_fail: report      # report | create_ticket | block

  # Environment (optional)
  env:
    LLM_MODEL: openrouter/openai/gpt-5-mini
    LLX_DEFAULT_TIER: balanced
    LLX_VERBOSE: true