Skip to content

feat(gate): 커버리지 ratchet 게이트 (AGT-4898) - #916

Open
unohee wants to merge 1 commit into
mainfrom
feat/agt-4898-coverage-ratchet
Open

unohee wants to merge 1 commit into
mainfrom
feat/agt-4898-coverage-ratchet

Conversation

@unohee

@unohee unohee commented Nov 14, 2026

Copy link
Copy Markdown
Collaborator

무엇

  • 새 src/automation/coverageRatchetGate.ts: coverageRatchetHold()가 병합 기준(merge-base) main 커밋의 커버리지를 기준값으로 저장·재사용하고, 변경의 커버리지가 그보다 낮으면(허용 오차 0.01%p) hold를 돌려준다.
    • 기준값 저장소: ~/.openswarm/coverage-baselines.json(OPENSWARM_COVERAGE_BASELINES로 변경 가능), 키는 <origin URL>@<merge-base SHA>. "최신 main" 하나가 아니라서 오래된 main에서 딴 브랜치를 잘못 보류하지 않는다.
    • 결과 세 가지를 구분: base 측정 불가 → skipped(사유 기록), base는 측정되는데 head 측정 불가·측정 예외 → hold(fail-closed), 하락 → hold.
    • 지원 여부는 base 쪽으로 판단한다. 워커가 커버리지 설정을 지우면 게이트가 꺼지는 게 아니라 보류된다.
  • publishOnPark.ts: testRemovalGate와 함께 holdBeforePublication()으로 묶어 lease fence(beforePublish) 전에 실행. 보류 시 operatorPark = { code: 'coverage_dropped' }(testRemovalGate와 같은 NEEDS_HUMAN 경로), skip은 이벤트 로그·콘솔에 남긴다.

아직 동작하지 않는 부분 (중요)

측정은 CoverageProvider seam(setCoverageProvider)이고 기본 provider는 아직 없다. 그래서 이 PR이 머지돼도 실제 저장소는 전부 Coverage ratchet skipped: no coverage provider is configured로 기록되고 보류되지 않는다. 숫자는 하네스가 실행한 것에서 나와야 하고(워커 보고 텍스트를 파싱하는 tester.ts의 coverage는 이 게이트가 막으려는 회피 그 자체라 쓰지 않았다), 신뢰할 수 있는 base/head 실행기는 runVerify뿐인데 그쪽에 커버리지 수치를 싣는 일은 이 이슈보다 크다. 후속 작업으로 provider 구현이 필요하다.

왜

AGT-4190 방어 2번. 테스트를 지우지 않고 약하게 바꾸면 testRemovalGate를 그대로 통과한다.

검증

  • coverageRatchetGate.test.ts 12건: 하락 시 보류, 같거나 오르면 통과, 허용 오차, 기준값 저장·재사용(base 측정 1회), 오래된 merge-base 기준 비교, base 측정 불가 시 skip, head 측정 불가·예외 시 보류, merge-base 없음 skip, provider 미설정 skip, 등록 provider 사용, 파일 저장소 왕복.
  • publishOnPark.test.ts 2건 추가: 하락 시 park·beforePublish/PR 생성 미호출, pass/skip이면 발행.
  • vitest run src/automation 95 파일 1228 테스트 통과, publishOnPark를 쓰는 workerContext·worktreeManager 테스트 65건 통과, tsc --noEmit -p tsconfig.check.json 통과, oxlint 0건.

Linear: AGT-4898

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant