CI fast-pass가 순수 review 문서 PR에서 base CI 진행 중이면 full CI로 fallback함

[jangster77]

증상

PR #1578은 mydocs/pr/archives/**와 mydocs/orders/*.md만 변경한 review 문서 전용 후속 PR이다. 그러나 PR 생성 시점에 base devel의 post-merge Build & Test가 아직 진행 중이어서 CI preflight가 fast-pass하지 못하고 Build & Test full job을 실행했다.

재현 증거

• PR: docs: planet6897 PR 시리즈 처리 보고서 추가 #1578
• 변경 파일:
  • mydocs/pr/archives/pr_1541_1571_planet6897_series_report.md
  • mydocs/orders/20260627.md
• Render Diff preflight: all-review-docs-no-render-impact로 fast-pass
• CI preflight: base SHA의 Build & Test 완료 여부에 의존하여 base CI 진행 중이면 full CI fallback
• 결과: 문서 전용 PR에서 Build & Test가 20분 26초 실행됨

기대 동작

• PR 전체가 허용된 review 문서 경로(mydocs/pr/**, mydocs/orders/*.md)만 변경하면 base CI 완료 시점과 무관하게 heavy CI/CodeQL job은 skip되어야 한다.
• 코드 변경 뒤에 review 문서 커밋만 trailing으로 붙은 경우에는 기존처럼 마지막 코드 변경 SHA의 green check를 확인해야 한다.
• 코드, 테스트, workflow, 샘플, baseline, golden 변경이 포함되면 기존 full CI를 실행해야 한다.

해결 방향

1. ci.yml의 all-review-docs-only 경로에서 base Build & Test 조회를 생략하고 fast-pass한다.
2. codeql.yml의 all-review-docs-only 경로도 base CodeQL matrix 조회를 생략하고 fast-pass한다.
3. trailing review-doc commit이 있는 mixed PR은 기존 candidate SHA check 검증을 유지한다.
4. actionlint와 workflow diff 검증으로 문법을 확인한다.

참고

• 선행 이슈: 외부 contributor PR 리뷰 문서 전용 커밋의 heavy CI fast-pass gate 도입 검토 #1547, CI fast-pass preflight가 review 문서 전용 PR에서 paths-ignore로 실행되지 않음 #1574
• 발견 PR: docs: planet6897 PR 시리즈 처리 보고서 추가 #1578

[jangster77]

PR #1580 머지로 ci.yml/codeql.yml의 순수 review 문서 PR fast-pass 조건을 보강했고, 후속 문서 전용 PR #1581에서 동작을 확인했습니다.

검증 결과:

• task 1579: review 문서 PR fast-pass 보강 #1580 remote CI 통과: Build & Test / CodeQL / Render Diff 모두 green
• docs: review 문서 fast-pass 검증 기록 추가 #1581 review 문서 전용 PR: CI preflight, CodeQL preflight, Render Diff preflight pass
• docs: review 문서 fast-pass 검증 기록 추가 #1581 heavy jobs: Build & Test, Analyze, Canvas visual diff 모두 skipped

따라서 mydocs/pr/**와 mydocs/orders/*.md만 변경하는 review 문서 전용 PR은 base CI 진행 여부와 무관하게 heavy CI 없이 merge 가능한 상태로 확인했습니다.