cicd-diagnostics

Diagnoses DotCMS CI/CD failures in GitHub Actions runs, PRs, merge queues, and nightly builds. Identifies root causes via log analysis, test pattern comparison, and failure pattern recognition.

• Diagnoses CI/CD failures in DotCMS GitHub Actions workflows
• Analyzes test failures, merge queue issues, and PR build outcomes
• Compares test results across PR, merge queue, and nightly runs
• Identifies flaky tests and infrastructure issues

• CRITICAL - All scripts run from repository root, never use cd
• CRITICAL - Python 3.8+ required; parameter order is strict
• CRITICAL - RUN_ID always first, WORKSPACE always second in fetch-*.py
• Use decision tree to guide investigation flow
• Prioritize external issues before code changes
• Compare PR and merge queue test results for discrepancies
• Form hypotheses and validate with evidence
• Always check for known issues and duplicates

1. 1.Identify what failed and gather evidence from logs
2. 2.Run fetch-*.py scripts with correct parameter order: <RUN_ID> <WORKSPACE>
3. 3.Use decision tree to determine failure type and next step
4. 4.Check for external service issues first using external_issues.py
5. 5.Compare PR and merge queue results for test filtering discrepancies
6. 6.Present conclusions with confidence level and recommendations