CI Fix — Auto-remediate CI Failures

Context dynamique

• Branch courante: !git branch --show-current
• Checks PR en cours: !gh pr checks 2>/dev/null | head -20
• Workflows recents: !gh run list --limit 5 --json name,status,conclusion,headBranch --template '{{range .}}{{.name}} | {{.status}} | {{.conclusion}} | {{.headBranch}}{{"\n"}}{{end}}' 2>/dev/null

Instructions

Auto-fix CI failure for: $ARGUMENTS

Step 1: Identify failing checks

If PR number:

gh pr checks $ARGUMENTS
gh run list --branch $(gh pr view $ARGUMENTS --json headRefName -q .headRefName) --limit 3

If workflow run URL or ID:

gh run view $ARGUMENTS --log-failed

Step 2: Read error logs

# Get the failed run ID, then read logs
gh run view <run-id> --log-failed 2>&1 | head -200

Step 3: Classify — auto-fixable or manual?

Auto-fixable (proceed to Step 4):

NOT auto-fixable (report and STOP):

If the failure is NOT auto-fixable, report what you found and stop. Do NOT attempt manual fixes.

Step 4: Apply fix

Run the appropriate fix command from the table above. Then verify locally:

Python:

cd <component> && ruff check . && black --check .

TypeScript:

cd <component> && npm run lint && npm run format:check

Rust:

cd stoa-gateway && cargo fmt --check && RUSTFLAGS=-Dwarnings cargo clippy --all-targets --all-features -- -D warnings

Step 5: Commit and push

GUARDRAILS (mandatory checks before any git operation):

# Verify we are NOT on main
BRANCH=$(git branch --show-current)
if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "master" ]; then
  echo "ABORT: Cannot push CI fixes to main. Checkout the feature branch first."
  exit 1
fi

Then commit and push:

git add <only-fixed-files>
git commit -m "fix(ci): auto-fix <check-name> lint/format issues"
git push

Step 6: Report

## CI Fix: [check-name] on [branch]

### Fixed
- **Check**: [failing check name]
- **Error**: [error summary]
- **Fix**: [command run]
- **Files**: [list of modified files]

### Verification
- Local check: PASS/FAIL
- Pushed to: [branch]

### Not Fixed (if any)
- [check]: [reason — requires manual intervention]

Append metrics entry:

Append to ~/.claude/projects/.../memory/metrics.log:
YYYY-MM-DDTHH:MM | CI-FIX | task=<current-task> check=<check-name> auto_fixed=true|false

Rules

• NEVER fix logic errors, test failures, or security issues — only format/lint/type
• NEVER push to main — always verify branch name first
• NEVER use --force push
• NEVER use --no-verify on commits
• NEVER modify test expectations to make them pass
• If the fix changes behavior (not just formatting), STOP and report
• If unsure whether a fix is safe, STOP and report
• Always verify the fix locally before pushing