ci: GitHub 인프라 장애·stale submission 브랜치 재발 방지

[orientpine]

배경

PR #193(issue #192 'hwp/hwpx 에디터')의 CI가 실패해 머지가 차단됐던 사건에서 두 개의 독립된 실패 원인을 발견했다. 첫 번째는 GitHub 인프라 일시 장애(HTTP 500), 두 번째는 그 와중에 노출된 process-submission.yml의 stale 브랜치 재사용 버그다.

변경 내용

1. process-submission.yml 강화 — non-fast-forward 방지

Create PR with new submission 스텝에서 git push origin "$BRANCH"만 했던 것을 다음으로 교체:

• 같은 브랜치에 열린 PR이 있으면 브랜치를 건드리지 않고 --force-with-lease로 새 commit을 덮어쓴다 (기존 PR이 update 됨).
• 열린 PR이 없는데 stale 원격 브랜치만 남아있으면 먼저 삭제 후 push.
• git fetch origin "$BRANCH" || true로 --force-with-lease 비교 기준을 확보.
• PR 생성은 open PR이 없을 때만 (있으면 재사용 메시지 출력).

2. ci-auto-rerun.yml 신규 — infra-transient 자동 재실행

• Trigger: workflow_run on CI completed
• Condition: conclusion == 'failure' && run_attempt < 3 (loop 차단)
• 실패 로그(`gh run view --log-failed`)에서 infra-transient 시그니처(HTTP 5xx, ETIMEDOUT, ENOTFOUND, RPC failed 등)가 매칭될 때만 `gh run rerun --failed`
• 결정적 실패(테스트/빌드 오류)는 자동 재실행하지 않음 — 같은 결과를 반복할 뿐이라 리소스 낭비

로컬에서 4개 골든 로그 샘플로 단위 검증 완료:

• 실제 24846153285의 infra 로그 → MATCH ✅
• Jest 테스트 실패 로그 → NO_MATCH ✅
• TypeScript compile 오류 로그 → NO_MATCH ✅
• Connect Timeout 로그 → MATCH ✅

3. docs/troubleshooting/rss-submission-ci-failure.md 신규

증상·원인·해결·예방 조치를 모두 기록.

검증

bun run validate                          → ✅ 465 files
bun run validate:docs                     → ✅ 72 files
bun run validate:docs -- --check-coverage → ✅ pass
bun run build                             → ✅ 967 pages
bun run test                              → ✅ 375 tests

즉시 효과

• PR Submission from issue #192 #193 자체는 `gh run rerun 24846153285 --failed`로 이미 복구되어 머지 가능 상태.
• 본 PR이 머지된 이후의 CI 실패는 인프라 장애일 경우 자동 재실행됨.
• 같은 issue를 재처리해도 stale 브랜치 때문에 fail 하지 않음.

비범위

• ci.yml 자체는 수정하지 않음 (nick-fields/retry로 step-level wrap은 효과 적음 — 장애가 checkout 단계라).
• process-submission.yml의 `Auto-merge if editor` 스텝은 그대로 유지 (`--delete-branch` 추가는 별도 개선 기회).

Closes-related: PR #193 (이미 단순 rerun으로 복구)