fix(docs): code analysis engine

changes:
  - file: ci_runner.py
    area: core
    added: [main, TestResult, run_tests, run_loop, check_strategy_completion, BugReport, +7 more]
  - file: auto_loop.py
    area: cli
    added: [ci_status, auto_loop, get_backend]

stats:
  lines: "+4390/-21 (net +4369)"
  files: 30
  complexity: "Large structural change (normalized)"

Author: tom-sapletta-com

.github/workflows/ci-auto-loop.yml

@@ -0,0 +1,163 @@
+name: CI/CD with Auto Bug-Fix Loop
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+env:
+  PYTHON_VERSION: "3.11"
+
+jobs:
+  ci-loop:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      issues: write
+      pull-requests: write
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Full history for better analysis
+      
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+      
+      - name: Cache pip
+        uses: actions/cache@v3
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements*.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+      
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install strategy-pm[github] pytest pytest-cov
+          pip install llx  # Install llx for AI analysis
+      
+      - name: Install Ollama (for local LLM)
+        if: env.AUTO_FIX == 'true'
+        run: |
+          curl -fsSL https://ollama.ai/install.sh | sh
+          ollama serve &
+          sleep 5
+          ollama pull qwen2.5:3b
+      
+      - name: Run CI Auto-Loop
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_REPO: ${{ github.repository }}
+          AUTO_FIX: ${{ vars.AUTO_FIX || 'false' }}
+        run: |
+          strategy-pm auto loop \
+            --strategy ./strategy.yaml \
+            --project . \
+            --backend github \
+            --max-iterations 5 \
+            --auto-fix ${{ env.AUTO_FIX }} \
+            --output ci-results.json
+      
+      - name: Comment PR with results
+        if: github.event_name == 'pull_request'
+        uses: actions/github-script@v6
+        with:
+          script: |
+            const fs = require('fs');
+            
+            if (fs.existsSync('ci-results.json')) {
+              const results = JSON.parse(fs.readFileSync('ci-results.json', 'utf8'));
+              
+              const comment = `
+              ## 🤖 CI/CD Auto-Loop Results
+              
+              **Status**: ${results.success ? '✅ Success' : '❌ Failed'}
+              **Iterations**: ${results.total_iterations}
+              **Tickets Created**: ${results.tickets_created.length}
+              
+              ${results.tickets_created.length > 0 ? `
+              ### 📫 Created Tickets
+              ${results.tickets_created.map(url => `- [Ticket](${url})`).join('\n')}
+              ` : ''}
+              
+              ${!results.success ? `
+              ### ❌ Issues
+              Final status: ${results.final_status}
+              ` : ''}
+              
+              ---
+              *Generated by SprintStrat CI/CD*
+              `;
+              
+              github.rest.issues.createComment({
+                issue_number: context.issue.number,
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                body: comment
+              });
+            }
+      
+      - name: Update strategy if needed
+        if: failure() && env.UPDATE_STRATEGY == 'true'
+        run: |
+          # Generate updated strategy based on failures
+          llx chat --model balanced \
+            --prompt "Update strategy.yaml based on recent test failures and CI results" \
+            --output strategy-updated.yaml
+          
+          # Create PR for strategy update
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git checkout -b strategy-update-${{ github.run_number }}
+          git add strategy-updated.yaml
+          git commit -m "ci: Update strategy based on CI results"
+          git push origin strategy-update-${{ github.run_number }}
+          gh pr create --title "Auto-update strategy" --body "Strategy updated based on CI results"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v3
+        if: always()
+        with:
+          name: ci-results
+          path: |
+            ci-results.json
+            test-results.xml
+            coverage.json
+            htmlcov/
+      
+      - name: Coverage badge
+        uses: tj-actions/coverage-badge-py@v2
+        if: github.ref == 'refs/heads/main'
+        with:
+          output: coverage.svg
+      
+      - name: Deploy coverage reports
+        if: github.ref == 'refs/heads/main'
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./htmlcov
+          destination_dir: coverage
+
+  notify:
+    runs-on: ubuntu-latest
+    needs: ci-loop
+    if: always()
+    
+    steps:
+      - name: Notify Slack
+        if: env.SLACK_WEBHOOK_URL != ''
+        run: |
+          curl -X POST -H 'Content-type: application/json' \
+            --data '{"text":"CI/CD ${{ needs.ci-loop.result }}: ${{ github.repository }} - ${{ github.sha }}"}' \
+            ${{ env.SLACK_WEBHOOK_URL }}
+        env:
+          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}

.gitlab-ci.yml

@@ -0,0 +1,234 @@
+# GitLab CI/CD with Auto Bug-Fix Loop
+stages:
+  - test
+  - analyze
+  - ticket
+  - fix
+  - review
+
+variables:
+  PYTHON_VERSION: "3.11"
+  AUTO_FIX: "false"  # Set to "true" to enable auto-fix
+
+# Cache pip dependencies
+cache:
+  paths:
+    - .cache/pip
+    - .venv/
+
+before_script:
+  - python -m venv .venv
+  - source .venv/bin/activate
+  - pip install --upgrade pip
+  - pip install strategy-pm[jira] pytest pytest-cov
+  - pip install llx
+
+# Test stage
+run_tests:
+  stage: test
+  script:
+    - echo "🧪 Running tests..."
+    - pytest --cov=src --cov-report=json --cov-report=html --junit-xml=test-results.xml -v
+  artifacts:
+    reports:
+      junit: test-results.xml
+    paths:
+      - coverage.json
+      - htmlcov/
+    expire_in: 1 week
+  coverage: '/TOTAL.+?(\d+\%)$/'
+  only:
+    - main
+    - develop
+    - merge_requests
+
+# Code analysis stage
+code_analysis:
+  stage: analyze
+  script:
+    - echo "🔍 Running code analysis..."
+    # Run llx analysis
+    - llx analyze --run --json > llx-analysis.json || true
+    # Run vallm if available
+    - vallm validate --json > vallm-report.json || true
+  artifacts:
+    paths:
+      - llx-analysis.json
+      - vallm-report.json
+    expire_in: 1 week
+  only:
+    - main
+    - develop
+    - merge_requests
+  allow_failure: true
+
+# Ticket creation stage
+create_tickets:
+  stage: ticket
+  script:
+    - echo "🎫 Creating tickets for failures..."
+    - |
+      if [ ! -f coverage.json ] || [ "$(jq '.totals.percent_covered' coverage.json)" -lt 80 ]; then
+        echo "Coverage below threshold, creating tickets..."
+        strategy-pm auto loop \
+          --strategy ./strategy.yaml \
+          --project . \
+          --backend jira \
+          --max-iterations 1 \
+          --output ci-results.json
+      else
+        echo "Tests passed, no tickets needed"
+      fi
+  artifacts:
+    paths:
+      - ci-results.json
+    expire_in: 1 week
+  dependencies:
+    - run_tests
+    - code_analysis
+  only:
+    - main
+    - develop
+
+# Auto-fix stage (optional)
+auto_fix:
+  stage: fix
+  script:
+    - echo "🔧 Attempting auto-fix..."
+    - strategy-pm auto loop \
+        --strategy ./strategy.yaml \
+        --project . \
+        --backend jira \
+        --max-iterations 3 \
+        --auto-fix \
+        --output fix-results.json
+  artifacts:
+    paths:
+      - fix-results.json
+    expire_in: 1 week
+  dependencies:
+    - create_tickets
+  only:
+    - main
+    - develop
+  when: manual
+  allow_failure: true
+
+# Strategy review
+review_strategy:
+  stage: review
+  script:
+    - echo "📊 Reviewing strategy..."
+    - |
+      # Check if strategy is complete
+      strategy-pm strategy review \
+        --strategy ./strategy.yaml \
+        --project . \
+        --backend jira \
+        --output review-results.json
+      
+      # Update Jira with status
+      python - <<'EOF'
+import os
+import json
+from strategy.integrations.jira import JiraBackend
+
+if os.path.exists('review-results.json'):
+    with open('review-results.json') as f:
+        results = json.load(f)
+    
+    jira = JiraBackend(
+        base_url=os.environ['JIRA_URL'],
+        email=os.environ['JIRA_EMAIL'],
+        token=os.environ['JIRA_TOKEN'],
+        project=os.environ['JIRA_PROJECT']
+    )
+    
+    # Find or create sprint ticket
+    summary = f"Sprint Review - {os.environ['CI_COMMIT_REF_NAME']}"
+    description = f"""
+    Pipeline: {os.environ['CI_PIPELINE_URL']}
+    Commit: {os.environ['CI_COMMIT_SHA']}
+    
+    Results:
+    - Status: {results.get('summary', {}).get('status', 'Unknown')}
+    - Completed: {results.get('summary', {}).get('completed', 0)}
+    - In Progress: {results.get('summary', {}).get('in_progress', 0)}
+    - Blocked: {results.get('summary', {}).get('blocked', 0)}
+    """
+    
+    # Update or create ticket
+    tickets = jira.search_tickets(f"summary~'{summary}'")
+    if tickets:
+        jira.update_ticket(tickets[0].id, description=description)
+    else:
+        jira.create_ticket(title=summary, description=description, labels=["sprint-review"])
+EOF
+  artifacts:
+    paths:
+      - review-results.json
+    expire_in: 1 week
+  dependencies:
+    - auto_fix
+    - create_tickets
+  only:
+    - main
+    - develop
+
+# Notify on failure
+notify_failure:
+  stage: review
+  script:
+    - echo "📧 Sending failure notification..."
+    - |
+      if [ -f ci-results.json ]; then
+        # Send Slack notification
+        curl -X POST -H 'Content-type: application/json' \
+          --data "{
+            \"text\": \"❌ Pipeline failed on $CI_PROJECT_NAME\nBranch: $CI_COMMIT_REF_NAME\nPipeline: $CI_PIPELINE_URL\"
+          }" \
+          $SLACK_WEBHOOK_URL || true
+        
+        # Send email notification
+        python - <<'EOF'
+import smtplib
+import os
+from email.mime.text import MIMEText
+
+if os.environ.get('SMTP_HOST'):
+    msg = MIMEText(f"""
+    Pipeline failed on {os.environ['CI_PROJECT_NAME']}
+    
+    Branch: {os.environ['CI_COMMIT_REF_NAME']}
+    Commit: {os.environ['CI_COMMIT_SHA']}
+    Pipeline: {os.environ['CI_PIPELINE_URL']}
+    
+    Check the logs for details.
+    """)
+    
+    msg['Subject'] = f"CI/CD Failure: {os.environ['CI_PROJECT_NAME']}"
+    msg['From'] = os.environ['SMTP_FROM']
+    msg['To'] = os.environ['SMTP_TO']
+    
+    server = smtplib.SMTP(os.environ['SMTP_HOST'])
+    server.send_message(msg)
+    server.quit()
+EOF
+      fi
+  when: on_failure
+  only:
+    - main
+    - develop
+
+# Deploy on success
+deploy:
+  stage: review
+  script:
+    - echo "🚀 Deploying..."
+    # Add your deployment commands here
+  when: on_success
+  only:
+    - main
+  environment:
+    name: production
+    url: https://your-app.com