Four test files create mkdtemp directories and never remove them; about 640MB and 12k directories had piled up in /tmp on the laptop. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
13 KiB
13 KiB
Tasks: 성숙도 리뷰(2026-09-25) 전 항목 반영
작업 ID는 리뷰의 발견 ID다. 문제 설명·근거·검증 방법은 docs/reviews/2026-09-25-maturity-review/<영역 문서>의 같은 ID 항목을 본다. 결정은 SPEC.md "결정" 표(D-x), 실행 방식은 tasks/plan.md를 따른다.
모든 작업에 공통인 검증
- RED: 재현 테스트가 수정 전에 실패한다(문서만 바꾸는 작업은 제외)
- GREEN: 해당 테스트 파일 통과 —
node scripts/run-vitest.ts run <test file> - 게이트 통과 —
corepack pnpm check:architecture && corepack pnpm check:types && corepack pnpm lint && corepack pnpm test:unit && corepack pnpm test:component && corepack pnpm test:integration && corepack pnpm test:contract && corepack pnpm test:runtime-schema - adapter 파일을 추가·이동했으면
docs/reviews/adapters/INVENTORY.md갱신 +corepack pnpm check:adapter-inventory - 커밋 1개. 메시지에 발견 ID. 그 작업의 파일만 스테이징
Phase 0 — 게이트·CI 기반 (순차, 레인 Z)
- 10-01 새 clone에서
test:unit통과 — 완료:removal-fixture.test.ts가 임시 폴더의 가짜 증거로 검사. 새 worktree에서test:unit통과 - 00-01 fixture가 공유
node_modules의 pnpm 상태 파일을 덮어쓰지 않음 — 완료: 통합 테스트 전후 원본 상태 파일 해시 동일 - 14-01 샘플 제거 게이트 복구 — 완료: 플랫폼 테스트 6개가 샘플 대신 테스트 전용 기능·platform route 사용.
test:sample-removalPASS(13 testcase 성공) - 14-02 CI 계약 기준값 외부화 (D-13) — 완료:
config/ci/contract-baseline.json+update:ci-contract-baseline. 샘플 제거 fixture가CI_CONTRACT_MODE없이 canonicalcheck:ci·check:registries통과 - 12-02 · 13-01 workflow가 job의 모든 gate 실행 — 완료: workflow에
ci:gate -- FE-GATE-027. 계약 검사가 run step 누락 변형을 거부.APP_PROFILE≠RELEASE_TARGET이면 실패. 변수 문서화 - 12-01 (repo 쪽, D-17) — 완료: push 트리거에
main. README에 CI 상태와 머지 전 로컬 명령 - 12-04 · 09-11 CI 밖 테스트·검사 연결 — 완료:
tests/architecture·release·scripts·features최상위·scale/browser-soak.contract·scripts/verify-extreme-scale과check:adapter-inventory, image fixture가 게이트에 연결. 고아 테스트를 잡는 계약 검사와 음성 fixture
Checkpoint 0
- 공통 게이트 +
check:ci+test:sample-removal+build통과
레인 A — browser-transfer (01-adapters-browser-transfer.md)
- 01-01 PUT 401/403·만료 → capability 재발급 재시도
- 01-04 같은 idempotency key 재사용 테스트 3개 — 완료: 변이 M1·M6·M7 검출
- 01-02 완료·결과 불명 업로드 보고 — 완료: complete 성공 뒤 정리 실패도 성공 반환,
abort()ALREADY_COMPLETED에 resourceId - 01-03 크기·진행 기반 전송 제한 — 완료: 1Mbit/s 모의에서 5MiB part 성공, 멈춘 연결은 idle 제한 안에 끊김
- 01-05 recovery → 행동 1:1 — 완료: ABORT_PENDING과 CAS 충돌 실패값 구분, port 주석 표
- 01-06
maxClockSkewMs - 01-07 vault 항목
finally정리 - 01-08 재개 시 정책 재검사 제거
- 01-09 part 수 상한 × 전송 상한 교차 검사
- 01-10
UPLOAD_PART관측 1건 + 시도 수 bucket - 01-11 image probe 동시 상한·재사용
레인 B — browser-files / cache (02-adapters-browser-files-cache.md)
- 02-01 preview 직후 abort → ABORTED, lease 증가 없음
- 02-02 Cache Storage 익명 요청 규칙 테스트
- 02-03 로그아웃 시 runtime dispose 문서·recipe
- 02-04 lease 한도 초과 retryable
- 02-05
inspect()실제 보장 - 02-06 취소와 handoff 성공 관측 구분
- 02-07 조회당
keys()1번·복사 2번 이하 - 02-08 가려진 규칙 5개 단독 테스트 — 완료: 변이 5개 검출
- 02-09 cross-tab 설계 문서 현행화
레인 C — HTTP·서버 상태·인증·텔레메트리 (03-adapters-http-state.md)
- 03-01 · 08-03 결과 불명 쓰기의 같은 키 재전송 (D-1) — 완료: 504 뒤 재전송의
Idempotency-Key동일, 근거 없는 "변경되지 않음" 확정 경로 없음 - 03-02 401/403/429 분류 (D-2)
- 08-01 폼 저장 실패 상태 분리 (D-2) — 완료: 401·403·429가 서로 다른 문구·행동, "입력 내용을 확인해 주세요" 제목 없음
- 03-03 correlation id →
requestId, 요청 식별자 헤더 - 03-04 V3 422 필드 오류가 폼까지
- 03-05 텔레메트리 keepalive 64KiB 분할
- 10-03 KEYED·retryBudget 2 실행기 테스트 — 완료: 변이 M1b 검출
- 13-11 텔레메트리 envelope에
build_id·release_id - 03-06 전송별 재시도·타임아웃 규칙 표
- 03-07 전송 0회 미인증은 telemetry 0건
- 03-08 HTTP 복구 runbook 현행화
레인 D — realtime (04-adapters-realtime.md)
- 04-01 모든 세션 종료 경로에서 예산 초기화, offline 동안 예산 정지
- 04-02 SSE Retry-After bridge
- 04-03 미등록 이벤트 타입 → freshness UNKNOWN, 별도 사유
- 04-04 닫기 책임 주석(또는 구독)
- 04-05 큰 chunk 분할
- 04-06 SSE idle timeout 테스트 — 완료: 변이 M7 검출
- 04-07 reconnect·poll 관측 hook
- 04-08 VD-28·설계 5.3 현행화
레인 E — 저장소·kernel (05-adapters-storage-kernel.md)
- 05-01 OPFS reconcile vs 진행 중 put (D-3) — 완료: 공유 root 2런타임에서 put 성공이면 open 성공, reconcile은 행 건너뜀
- 05-02 빈 receipt = 없음, reconcile 루프 계속 → GC 도달
- 05-08 메모리 IndexedDB 대역 fidelity(DB 이름 분리·트랜잭션 직렬화·비활성 요청 예외 또는 헤더 명시)
- 05-03 손상 governance에서도 LOGOUT/ACCOUNT_DELETION 삭제
- 05-04 OPFS purge 뒤 partition 파일 0개
- 05-05 sweep·prune이 손상 행 건너뜀
- 05-06 future schema → INCOMPATIBLE/ONLINE_ONLY
- 05-07 멈춘 put idle timeout으로 lock 해제
- 05-09 OPFS runbook 현행화, 죽은
EFFECT_UNKNOWN분기 정리 - 05-10 objectId 문법 policy 연동,
stableJson한 벌 - 05-11 IndexedDB 예외 매핑 한 벌, OPFS→indexeddb import 0
- 05-12 binding 검증을 kernel 트랜잭션으로
- 05-13 admission 중 versionchange 처리
- 05-14 GC 유예 기준(또는 계약 주석)
레인 F — Service Worker / Web Push (06-adapters-service-worker-push.md)
- 06-01 알림 클릭
"data" in— 완료: prototype accessor fake로 클릭 테스트 통과 - 06-02 두 탭 push 경쟁 (D-4)
- 06-04 kill switch 분기 테스트 — 완료: 변이 검출
- 06-03 SW 비상 경로·운영 문서 (D-5)
- 06-05 SW 관측 조립
- 06-06 계정 전환 시 push fence 넘기기
- 06-07 drain 시간 초과를
CLIENT_DRAIN_TIMEOUT으로 - 06-08 fallback을 빌드 자산 경로로 한정
- 06-09 거절 클릭 fallback이 base path 사용
- 06-10 SW 빌드가 프로필 설정 사용(또는 불일치 실패)
레인 G — contracts (07-contracts.md)
- 07-02 · 13-10 호환성 규칙·분류기·FE-GATE-014 (D-6)
- 07-03 V2/V3 일치 테스트 (D-7)
- 07-04 읽지 않는 registry 필드 연결 또는 삭제 — 완료: 변이 M1 검출
- 07-05 diagnostics fixture를
@ts-expect-error3개로 - 07-06
invokeValidator입력 검사 - 07-07
@deprecated와 제거 조건
레인 H — presentation (08-presentation.md)
- 07-01 · 08-02 오류 종류 38개 문구 + 누락 검출 테스트
- 08-04 샘플 문구 catalog화 +
check:i18n범위 확대 - 08-05 · 11-02 a11y·visual이 실제 화면을 검사(heading 대기, 보호 라우트는 로그인 후, 상태별)
- 08-07 실패 화면 지원 참조·다음 행동
- 08-08 스크롤 복원·해시 이동
- 08-09 실패 시 결과 수 status 숨김
- 08-10 언어 전환 시 폼 오류 재번역
- 08-11 상태 화면 한 벌로
- 08-12 Pagination 수정키 클릭 허용
- 08-13 상세 경로와 정적 경로 충돌 제거
레인 I — 애플리케이션 코어·조립·빌드 입력 (09-app-core.md)
- 09-01 기능 2개 이상 설치 타입 — 완료: 모양이 다른 두 기능 설치 typecheck fixture가 게이트에서 통과
- 09-05
needs검사 + IndexedDB capability 조립 예시 - 00-02 local-draft가 제거 대상 런타임을 직접 import하지 않음 — 완료: 제거 검증 4개 PASS (Phase 0에서 새로 발견)
- 09-02
VITE_PRODUCT_FEATURES를 생성기에서 (D-9) - 13-06
VITE_*개별 참조 + 전체 객체 참조 lint 금지 + 허용 목록 밖 변수 build 실패 - 13-07 하위 경로 배포 URL
- 09-03 모듈 평가 실패도 부트 오류 화면 — 남음: F-2(레인 J)
- 09-04
BOOT_UNEXPECTED_FAILURE, 원인 보존 - 09-06 local-draft 도메인 규칙 적용
- 09-07 · 14-03 기능 추가·제거 경로 (D-10), 문서 현행화 — 남음: F-3(lane/G에 커밋, 통합 전)
- 14-08 제거 스크립트 실패 보고·임시 폴더
- 09-08 local-draft ABA 방지
- 09-09 모르는 override 키 진단
- 09-10 부트 실패 다시 시도 버튼
- 09-12 local-draft fixture 복사본 제거
레인 J — 테스트 체계 (10-tests-fast-layers.md, 11-tests-browser-release-scale.md)
- 10-02 reference-page 첫 대기 안정화 — 완료: 부하 조건 20회 실패 0
- 10-04 커버리지 정책·문서 일치, live 재시도 모듈 포함
- 10-05 파일 하나 실행 문서, vitest
include - 10-06 전역
afterEach실제 타이머 복원 - 10-07 테스트 문서 현행화
- 11-04 실제 모양 기능 규모 측정 (D-18)
- 11-05 SW 없는 구 탭 청크 복구 e2e
- 11-06 reference E2E 데이터 단언 + 저장 성공·재시도
- 11-07 성능 측정 반복·중앙값·strictPort
- 11-08 모든 Playwright 설정
forbidOnly, quarantine 만료 검사 - 00-03 테스트가 만든 임시 폴더를 지우지 않음(새 발견, 2026-09-26) — 완료:
repository-file-inventory,service-worker-web-push-remediation,removal-fixture,scripts/generate-product-feature-index테스트가 mkdtemp 폴더를 afterEach/finally에서 지운다.test:unit전후/tmp항목 수가 같다
레인 K — CI·가드레일·릴리스 (12-guardrails-ci.md, 13-build-release-supply-chain.md)
config/ci/gates.json과 생성 workflow는 이 레인과 Phase 0만 바꾼다.
- 08-06 수동 a11y 게이트를 release 단계로 (D-8)
- 11-01 · 13-03 drill 판정 정직화 (D-14) — 완료: JS 자산 없는 dist에서 FE-RB-002·005 실패, provider 없으면 UNVERIFIED, 016/025 중복 정리
- 11-03 CPU 무관 scale tier를 PR 게이트에
- 12-03 재수출 경유 경계 우회 차단
- 12-10 · 12-08 정규식 import 규칙 → 그래프 규칙 (D-12)
- 12-05 dependency-cruiser 실행 제거·문서 정정 (D-11)
- 12-06
import.meta.glob거부 - 12-07 예외 범위 축소·이유·담당
- 12-09 레이어 규칙 기준 파일 하나
- 12-11 위반 메시지에 이유·해결 방향
- 13-02 dist 공개 파일 권한
- 13-04
verify:promotion보관 모드 - 13-05 hosting 헤더 fixture 모드는 UNVERIFIED, live는 배포 후 (D-14)
- 13-08 운영 CSP 아래 e2e smoke — 남음: F-7(lane/G wip)
- 13-09
engineStrict·saveExact를pnpm-workspace.yaml로 - 13-12 SBOM·provenance 증명 범위 표, 배포물 패키지 목록
- 13-13 provider 없는 구성 문서화, 키 교체 절차
- 13-14 번들 예산 기준선·여유·조건 문서
- 13-15 README 설정 절,
public/config.json동기화 — 남음: F-6(lane/G에 커밋, 통합 전). F-5는 레인 M에서 완료
레인 M — 템플릿 제품성·문서 (14-template-product-docs.md)
- 14-04 CHANGELOG, README 업데이트 절, 로컬 태그 (D-15) — 남음: F-13(버전·태그, 마지막 작업)
- 14-05
docs/README.md색인 (D-16) - 14-06 README 지원 범위 표·상태 어휘 대응표
통합 후 (순차, 레인 Z)
- 12-12
noUnusedLocals(D-19) - 14-07 문서 수치·목록 현행화(게이트 수는 레인 K 결과 기준)
- 리뷰 README 발견 색인의 상태를 "해결 · <커밋>"으로 갱신
Checkpoint 최종
- 공통 게이트 +
check:ci+check:adapter-inventory+verify:documentation+test:sample-removal+build - 새 worktree(깨끗한 체크아웃)에서 공통 게이트 통과
- 발견 138건 모두 체크
사용자 몫 (SPEC "범위 밖")
- U-1 Gitea Actions 활성화·runner·required check
- U-2 수동 접근성 검토 10건
- U-3 태그 push
- U-4 작성자 외 기능 추가 기록, staging 공급망 smoke
- U-5 백엔드 멱등 키 계약 확인