Files
clean-architecture-frontend…/tasks/handoff.md
T
DongHyeonkaandClaude Opus 5.5 79de978833 docs: record leaked test temp dirs as follow-up 00-03
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>
2026-09-26 01:15:27 +09:00

7.8 KiB

인계: 성숙도 리뷰(2026-09-25) 수정 작업

2026-09-26 01:10, 노트북 부하 때문에 세션을 멈추고 desktop으로 옮긴다. 이 문서만 읽고 이어서 진행할 수 있게 적었다.

  • 요구사항: SPEC.md (결정 D-1~D-19)
  • 실행 방식: tasks/plan.md
  • 작업 목록: tasks/todo.md (통합이 끝난 항목만 [x])
  • 레인 지시서: tasks/lanes/LANE-BRIEF.md (6절이 2차 레인 추가 규칙)
  • worktree 준비: tasks/lanes/setup-lane.sh <레인>

1. 브랜치 상태

main (4626b73, 그대로)
 └─ fix/maturity-review-2026-09-25   통합 브랜치. Phase 0 + 레인 A·C·E·I·K·M 병합 완료, 게이트 통과
      └─ 4d17259 (1차 레인 통합 시점)
           ├─ lane/B  완료. 레인 끝 게이트 미실행
           ├─ lane/D  완료. 레인 끝 게이트 일부만 실행(sample-removal 재실행 중 중단)
           ├─ lane/F  06-10·F-8 진행 중 (wip 커밋)
           ├─ lane/G  F-7 진행 중 (wip 커밋)
           ├─ lane/H  08-10 진행 중 (wip 커밋)
           └─ lane/J  11-06·11-04 진행 중 (wip 커밋)

wip(...) 커밋은 멈춘 시점의 작업 중 변경이다. 그 레인을 이어서 할 때 git reset --soft HEAD~1로 풀고, 작업을 끝낸 뒤 정상 커밋으로 만든다.

2. 레인별로 남은 일

레인 커밋된 작업 남은 작업
B 02-01~02-09, F-1 레인 끝 게이트(지시서 4절·6절)
D 04-01~04-08 레인 끝 게이트(지시서 4절·6절). realtime 레시피 예산 여유가 97바이트였으니 check:optional-recipes 측정값 확인
F 06-01~06-09 06-10·F-8(wip) → 레인 끝 게이트
G 07-02·13-10, 07-03~07-07, F-6, F-3 F-7(wip) → 레인 끝 게이트
H 07-01·08-02, 08-04, 08-05·11-02, 08-07, 08-08, 08-09 08-10(wip), 08-11, 08-12, 08-13, F-10 → 레인 끝 게이트
J 10-02, 10-04~10-07, 11-08 11-04·11-06(wip), 11-05, 11-07, F-2, F-4, F-12, 00-03 → 레인 끝 게이트

후속 작업(F-x) 내용:

  • F-2: 모듈 평가 단계에서 실패한 빌드를 Playwright로 열어 BootErrorShell을 확인하는 spec (09-03의 남은 부분)
  • F-4: 22:39에 어떤 fixture의 pnpm 실행이 공유 node_modules/.pnpm/lock.yaml과 .bin을 다시 썼다. 내용은 pnpm-lock.yaml과 같았다. 원인을 찾고 막는다(임시 폴더의 가짜 node_modules로 실험)
  • F-7: 운영 CSP(unsafe-eval 없음) 아래에서 zod가 첫 schema를 만들 때 eval 가능 여부를 시험해 위반을 낸다. 모든 schema 생성 전에 z.config({ jitless: true })를 적용하고, tests/e2e/production-csp.spec.ts의 init script 없이 위반 0건(3엔진)
  • F-8: vite.service-worker.config.ts가 production SW build에서도 public/config.json을 읽는다(06-10과 함께 닫음)
  • F-10: 폼의 unavailable 계열 실패가 아직 ErrorSummary "입력 내용을 확인해 주세요" 제목 아래 나온다(08-01의 남은 부분)
  • F-12: tests/system/ci-runner/ci-evidence-freshness.test.ts가 임시 root에 node_modules·lockfile이 없어 pnpm이 설치를 시작하고 ERR_PNPM_IGNORED_BUILDS로 실패
  • 00-03(새 발견, 레인 J): 테스트 4개가 mkdtemp 폴더를 지우지 않는다. 노트북 /tmp에 약 640MB·1만 2천 개가 쌓였다(repository-inventory-* 9,460개, sw-assets-* 2,195개, inventory-outside-* 430개, release-evidence-* 212개, generator-* 196개). 대상: tests/unit/repository-file-inventory.test.ts, tests/unit/service-worker-web-push-remediation.test.ts, tests/unit/removal-fixture.test.ts, tests/scripts/generate-product-feature-index.test.ts
  • F-11(사용자 몫): SBOM이 번들에 들어가는 scheduler@0.27.0을 development로 분류. 의존성 기준선 재승인이 필요하다
  • F-13(마지막에): 태그 v0.2.0을 만들 때 package.json version과 public/release-manifest.json, config/security/dependency-baseline.json, 테스트 3개(tests/component/runtime-application.test.tsx, tests/features/reference-feature/reference-production-vertical.test.tsx, reference-runtime-composition.test.ts)를 함께 올린다. CHANGELOG의 "진행 중" 절도 정리한다

3. desktop에서 이어가는 순서

  1. 이 브랜치와 레인 브랜치를 받는다.
    git fetch origin
    git switch fix/maturity-review-2026-09-25
    for L in B D F G H J; do git branch --track lane/$L origin/lane/$L; done
    corepack pnpm install --frozen-lockfile
    
  2. 통합 브랜치에서 게이트를 한 번 돌려 기준선을 확인한다(tasks/todo.md "공통 검증" 명령).
  3. 레인 worktree를 만든다. 레인 브랜치가 이미 있으면 그대로 checkout한다.
    tasks/lanes/setup-lane.sh F
    
  4. 레인을 이어서 진행한다. 서브에이전트를 쓰면 tasks/lanes/LANE-BRIEF.md를 먼저 읽게 한다. Playwright 포트는 레인마다 다르게 쓴다(B 4275, D 4276, F 4277, G 4278, H 4279, J 4280).
  5. 레인을 하나씩 통합한다(4절).
  6. 통합이 끝나면 5절의 마지막 작업을 한다.

4. 통합 절차 (1차 레인 때 쓴 방식)

  1. 통합 브랜치에서 git merge --no-ff lane/<X>.
  2. 게이트를 main 워킹트리가 아니라 분리 worktree에서 돌린다(tasks/lanes/setup-lane.sh INT<n> fix/maturity-review-2026-09-25). 병렬 레인이 공유 node_modules를 쓰는 동안 main에서 pnpm 설치가 돌면 안 되기 때문이다.
  3. 게이트: 공통 게이트 + check:ci + check:adapter-inventory + verify:documentation + build + check:optional-recipes + 제거 검증 4개(test:sample-removal, test:optional-recipe-removal, test:browser-file-storage-removal, test:realtime-removal).
  4. 레시피 번들 예산(config/recipes/frontend-capability-recipes.json의 bundleBudgetGzipBytes)은 크기 래칫이다. 초과하면 측정값(artifacts/quality/optional-recipes.json)을 100바이트 단위로 올린 값으로 고치고, 늘어난 이유(발견 ID)를 커밋에 적는다.
  5. config/ci/gates.json이 두 레인에서 충돌하면 병합한 뒤 CI_CONTRACT_BASELINE_OWNER=… CI_CONTRACT_BASELINE_REASON=… corepack pnpm update:ci-contract-baseline → corepack pnpm generate:ci-workflow → tests/unit/ci-workflow-generation.test.ts 개수 갱신 → check:ci.
  6. abort 래칫(scripts/check-adapter-inventory.ts의 HAND_ROLLED_ABORT_CEILING, 현재 13)은 실측이 내려가면 같이 내린다.
  7. todo.md에서 병합한 레인의 항목을 [x]로 바꾼다.

5. 마지막 작업

  • 12-12: tsconfig.base.json에 noUnusedLocals 켜고 나온 건 정리 (D-19)
  • 14-07: 문서의 수치·목록 정정. 게이트 수는 레인 K 기준 27개(016 폐기, 028 추가). 레인 J가 게이트를 바꿨으면 다시 센다
  • F-13: 버전 올리기와 로컬 태그 v0.2.0(push는 사용자, U-3)
  • 리뷰 README(docs/reviews/2026-09-25-maturity-review/README.md) 발견 색인의 비고를 "해결 · <커밋>"으로 갱신
  • CHANGELOG "진행 중" 절 정리
  • 최종 체크포인트: tasks/plan.md "Checkpoint 최종"과 새 worktree(깨끗한 체크아웃)에서의 공통 게이트
  • 사용자 몫(U-1~U-5, F-11)은 SPEC.md "범위 밖"과 todo.md 끝에 있다

6. 알아 둘 것

  • 부하 flaky: tests/integration/provider-guardian-transaction.test.ts가 부하가 높을 때 시간 초과로 실패한다. 단독 실행은 통과한다.
  • test:system의 tests/system/ci-runner/ci-artifact-contract.test.ts는 단독 실행에서도 10초 시간 초과가 났다(레인 C 보고). 공통 게이트 밖이다.
  • 1차 레인 통합 후(4d17259) 공통 게이트, check:ci, check:adapter-inventory, verify:documentation, check:registries, check:diagnostics, check:i18n, build, check:optional-recipes, 제거 검증 4개가 모두 통과했다. 레인 M 병합(d2c197d) 뒤에는 전체 게이트를 다시 돌리지 않았다(레인 M 자체의 레인 끝 게이트는 통과).