docs(ledger): 흔들린 시험 기록을 두고 시간·순서 단언 규칙을 가리킨다 #50

Merged
donghyeon.kang merged 4 commits from donghyeon.kang/docs/flaky-ledger AGit into main 2026-11-13 15:27:29 +00:00
Owner

무엇을, 왜

흔들린 시험을 적는 곳이 없다. 2026-11-12~13에 프론트 흔들림이 여러 건 나왔고, 재실행으로 통과시킨 것은 세션 노트에만 남았다. 같은 모양(첫 렌더 5초 창, 잠금 순서 가정, 벽시계 비율)이 다시 들어와도 리뷰 기준에 막을 줄이 없다. 계획 FLAKY-1(design-docs ci/03-time-reduction-plan.md)의 프론트 몫이다.

고친 것

  • docs/ledger/flaky-tests.jsonl: 흔들림 하나마다 JSON 한 줄. 칸은 design-docs ci/manual.md 8.5절. 지금까지 10줄이다.
    • Firefox 프로필 디스크 대기(자원·IO): e2e 4건, browser-capabilities 3건 → 프론트 #47
    • 공유 fixture build 잠금 순서(동시성·순서) → 프론트 #46
    • WebKit platform-overview.spec.ts:48(시간 가정, 원인 조사 전)
    • 증가율 측정 extreme-scale-registry.test.ts:144(시간 가정, 그룹 B 제보, 아직 안 고침)
  • docs/ledger/README.md 「흔들림 기록」 칸 표, .gitattributes merge=union, README 지워도 되는 파일 표, docs/README.md 지도.
  • docs/work/reference/testing.md 5절 조사 절차 6번(기록).
  • 리뷰 기준 2절 「헷갈리는 경우」: PR·main 단계 시험의 벽시계 상한·시작 순서 단언은 구조적 위험(design-docs ci/manual.md 8.4절). gates.md 3절이 둘을 가리킨다.
  • CHANGELOG 미출시 절 한 줄.

버린 대안

  • scripts/verify.sh docs가 이 파일의 칸·범주를 검사하게 하기: FLAKY-1 범위 밖이라 뒤로 미뤘다.

위험·영향

  • 문서만 바뀐다. 시험·게이트 동작은 그대로다.
  • WebKit platform-overview:48은 원인 조사 전이고, 범주는 5초 창에서 실패한 모양으로만 적었다.

검증

  • scripts/verify.sh docs(노트북) OK.
  • desktop verify:documentation, changelog-review-ids·deletable-history-documents 시험, hooks 시험(python3 -m unittest discover -s scripts/tests) 통과.
  • 장부 10줄이 모두 JSON으로 읽힌다.

리뷰어가 볼 곳

  • docs/ledger/flaky-tests.jsonl의 범주와 판정 문구
  • 리뷰 기준 2절에 더한 줄
## 무엇을, 왜 흔들린 시험을 적는 곳이 없다. 2026-11-12~13에 프론트 흔들림이 여러 건 나왔고, 재실행으로 통과시킨 것은 세션 노트에만 남았다. 같은 모양(첫 렌더 5초 창, 잠금 순서 가정, 벽시계 비율)이 다시 들어와도 리뷰 기준에 막을 줄이 없다. 계획 FLAKY-1(design-docs `ci/03-time-reduction-plan.md`)의 프론트 몫이다. ## 고친 것 - `docs/ledger/flaky-tests.jsonl`: 흔들림 하나마다 JSON 한 줄. 칸은 design-docs `ci/manual.md` 8.5절. 지금까지 10줄이다. - Firefox 프로필 디스크 대기(자원·IO): e2e 4건, browser-capabilities 3건 → 프론트 #47 - 공유 fixture build 잠금 순서(동시성·순서) → 프론트 #46 - WebKit `platform-overview.spec.ts:48`(시간 가정, 원인 조사 전) - 증가율 측정 `extreme-scale-registry.test.ts:144`(시간 가정, 그룹 B 제보, 아직 안 고침) - `docs/ledger/README.md` 「흔들림 기록」 칸 표, `.gitattributes` `merge=union`, README 지워도 되는 파일 표, `docs/README.md` 지도. - `docs/work/reference/testing.md` 5절 조사 절차 6번(기록). - 리뷰 기준 2절 「헷갈리는 경우」: PR·main 단계 시험의 벽시계 상한·시작 순서 단언은 구조적 위험(design-docs `ci/manual.md` 8.4절). `gates.md` 3절이 둘을 가리킨다. - CHANGELOG 미출시 절 한 줄. ## 버린 대안 - `scripts/verify.sh docs`가 이 파일의 칸·범주를 검사하게 하기: FLAKY-1 범위 밖이라 뒤로 미뤘다. ## 위험·영향 - 문서만 바뀐다. 시험·게이트 동작은 그대로다. - WebKit `platform-overview:48`은 원인 조사 전이고, 범주는 5초 창에서 실패한 모양으로만 적었다. ## 검증 - `scripts/verify.sh docs`(노트북) OK. - desktop `verify:documentation`, `changelog-review-ids`·`deletable-history-documents` 시험, hooks 시험(`python3 -m unittest discover -s scripts/tests`) 통과. - 장부 10줄이 모두 JSON으로 읽힌다. ## 리뷰어가 볼 곳 - `docs/ledger/flaky-tests.jsonl`의 범주와 판정 문구 - 리뷰 기준 2절에 더한 줄
donghyeon.kang added 4 commits 2026-11-13 12:35:18 +00:00
흔들린 시험을 적는 곳이 없다. 2026-11-12~13 이틀에 프론트 흔들림이
여섯 건이었다. 재실행으로 통과시킨 것은 세션 노트에만 남았다. 같은
모양(첫 렌더 5초 창, 잠금 순서 가정)이 다시 들어와도 리뷰 기준에 막을
줄이 없다.

docs/ledger/flaky-tests.jsonl을 두고 여섯 건을 첫 줄들로 넣는다. 칸은
design-docs ci/manual.md 8.5절이다(date·test·category·first_run·verdict·
quarantined_until·fixed_by). 여기에 대응하는 표를 docs/ledger/README.md
「흔들림 기록」에 둔다. 이 파일도 estimates.jsonl처럼 더하기만 하고
.gitattributes merge=union으로 합친다. README 지워도 되는 파일 표와
docs/README.md 지도에 넣었다. testing.md 5절 조사 절차에 6번(기록)을
더했다. 리뷰 기준 2절 「헷갈리는 경우」에 벽시계 상한·시작 순서 단언을
구조적 위험으로 적고, gates.md 3절에서 둘을 가리킨다(ci/manual.md 8.4절).

버린 대안: scripts/verify.sh docs가 이 파일의 칸과 범주까지 검사하게
하는 안. 이번 범위(계획 FLAKY-1) 밖이라 뒤로 미뤘다. 지금은 손으로
맞춘다.

위험·한계: platform-overview.spec.ts:48(WebKit)은 원인 조사 전이다.
범주는 5초 창에서 실패한 꼴만 보고 fixed-time으로 적었다.

검증: scripts/verify.sh docs(노트북) OK, desktop verify:documentation.
fe9990b4가 더한 docs/ledger/flaky-tests.jsonl을 복사한 프로젝트가 받는 법(줄을 비움, merge=union)을 적는다.

검증: scripts/verify.sh docs, desktop verify:documentation·changelog-review-ids·deletable-history-documents 시험.
그룹 B의 desktop merge에서 FE-GATE-020 기능 제거 드릴 사본의 test:coverage가 extreme-scale-registry.test.ts:144의 증가율 판정으로 실패했다(exponent 1.53, load 17.9). 범주는 시간 가정: 작은 쪽 2 ms를 벽시계 두 점의 비율로 잰다. 고치기(연산 수 세기 또는 반복 표본)는 아직이다.

검증: 줄이 JSON으로 읽힘(7줄).
docs(ledger): Firefox IndexedDB·OPFS 시험의 디스크 대기 timeout을 흔들림 기록에 더한다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m6s
frontend-quality-gates / merge / tests (pull_request) Successful in 14m27s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m37s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
24474035cb
#47이 없는 트리의 desktop merge(148e68f4)에서 Firefox browser-capabilities 시험 셋(opfs-runtime는 두 경우)이 30초 timeout으로 실패했다. 같은 게이트가 #47 트리에서는 통과했다. 범주는 자원·IO다.

검증: 줄이 JSON으로 읽힘(10줄).
donghyeon.kang merged commit 32d7b06e0a into main 2026-11-13 15:27:29 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-frontend-template#50