Files

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-removal PASS(13 testcase 성공)
  • 14-02 CI 계약 기준값 외부화 (D-13) — 완료: config/ci/contract-baseline.json + update:ci-contract-baseline. 샘플 제거 fixture가 CI_CONTRACT_MODE 없이 canonical check: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 — 하한 skew는 사용자 결정(2026-09-28)으로 문서 조건 유지, 상한만 반영
  • 01-07 vault 항목 finally 정리 — 검증 후 보완: 모든 종료 경로 0f35c98
  • 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-error 3개로
  • 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 eb5264c
  • 09-04 BOOT_UNEXPECTED_FAILURE, 원인 보존
  • 09-06 local-draft 도메인 규칙 적용
  • 09-07 · 14-03 기능 추가·제거 경로 (D-10), 문서 현행화 — 완료: F-3 606c191
  • 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 9dc95ca (3엔진 확인)
  • 13-09 engineStrict·saveExact를 pnpm-workspace.yaml로
  • 13-12 SBOM·provenance 증명 범위 표, 배포물 패키지 목록
  • 13-13 provider 없는 구성 문서화, 키 교체 절차
  • 13-14 번들 예산 기준선·여유·조건 문서
  • 13-15 README 설정 절, public/config.json 동기화 — 완료: F-6 063375e, F-5 edf44a2

레인 M — 템플릿 제품성·문서 (14-template-product-docs.md)

  • 14-04 CHANGELOG, README 업데이트 절, 로컬 태그 (D-15) — 완료: F-13 91de7cf, CHANGELOG 66bc083, 로컬 태그 v0.2.0
  • 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 백엔드 멱등 키 계약 확인