docs(ledger): 흔들린 시험을 장부에 남기고 시간·순서 단언 규칙을 리뷰 기준에 건다 #40

Open
donghyeon.kang wants to merge 2 commits from claude/w2-be-flaky-ledger into main
2 Commits
Author SHA1 Message Date
DongHyeonka 5f0bf17bd2 docs(ledger): PR 단계 Jetty attempt deadline 시험의 흔들림을 더한다
pr / done (pull_request) Successful in 13m24s
desktop에서 main c7a18ec7의 prCheck를 돌렸을 때(시작 부하 11~15)
JettyAttemptDeadlineTest#aSlowDripExchangeIsAbortedAtTheAttemptDeadline이
1.68초로, 상한 1.5초를 넘어 실패했다. #34가 고친 벽시계 시험 범위 밖에 남은
것이다. 고치는 일은 벽시계 시험을 맡은 쪽에 넘겼다.

검증: python3 -m unittest scripts/tests/test_ledger.py 통과.
2026-11-13 20:42:21 +09:00
DongHyeonka 88d35f7936 docs(ledger): 흔들린 시험을 장부에 남기고 시간·순서 단언 규칙을 리뷰 기준에 건다
pr / done (pull_request) Canceled after 0s
2026-11-12~13 백엔드 runner에서 흔들린 시험은 넷이다. 그런데 기록이 공유
노트와 세션 메시지에 흩어져 있다. 같은 모양(벽시계 상한, 스레드 시작
순서)이 다시 들어와도 리뷰 기준에는 「스레드 없음」 단언만 적혀 있어서
막을 근거가 없다.

- `docs/ledger/flaky-tests.jsonl`: 흔들림 하나가 한 줄이다. 칸과 범주의
  정본은 design-docs `ci/manual.md` 8.5절이다. 첫 네 줄:
  - compose 기동 경쟁(run 100, #13으로 고침)
  - gRPC 서버 deadline(run 221, #34)
  - HTTP client slow drip JDK(run 228, #34)
  - JPA 동시 writer replay 순서(run 260, #39 열림)
  `.gitattributes`에 `merge=union`을 준다. `scripts/tests/test_ledger.py`가
  칸·범주·날짜 형식을 본다.
- review-criteria.md 「타이밍에 기대지 않나」: 벽시계 상한 단언과 스레드
  시작 순서 단언을 더하고, 매뉴얼 8.4절을 가리킨다.
- gates.md 「원래 있던 실패 가리기」: 반복마다 시작 부하를 적게 한다.
  runner 실패면 그 시각에 잠금 아래 돈 desktop 실행도 적는다(runner는
  잠금 밖이다). 흔들림이면 장부에 한 줄을 더하고, 상한을 늘리거나 재시도를
  붙이지 않고 8.4절대로 고친다.

PR #12가 실패했다는 HTTP/2 흔들림은 넣지 않았다. 그 PR의 runner run은
모두 cancelled라 어느 시험인지 특정할 수 없다.

검증: scripts/verify.sh docs(노트북) rc=0. test_ledger의 새 시험이 잘못된
범주를 잡는지 한 줄을 바꿔 실패를 확인하고 되돌렸다.

Refs: design-docs ci/03-time-reduction-plan.md FLAKY-1
2026-11-13 19:46:21 +09:00