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>
7.8 KiB
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.jsonversion과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에서 이어가는 순서
- 이 브랜치와 레인 브랜치를 받는다.
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 - 통합 브랜치에서 게이트를 한 번 돌려 기준선을 확인한다(
tasks/todo.md"공통 검증" 명령). - 레인 worktree를 만든다. 레인 브랜치가 이미 있으면 그대로 checkout한다.
tasks/lanes/setup-lane.sh F - 레인을 이어서 진행한다. 서브에이전트를 쓰면
tasks/lanes/LANE-BRIEF.md를 먼저 읽게 한다. Playwright 포트는 레인마다 다르게 쓴다(B 4275, D 4276, F 4277, G 4278, H 4279, J 4280). - 레인을 하나씩 통합한다(4절).
- 통합이 끝나면 5절의 마지막 작업을 한다.
4. 통합 절차 (1차 레인 때 쓴 방식)
- 통합 브랜치에서
git merge --no-ff lane/<X>. - 게이트를 main 워킹트리가 아니라 분리 worktree에서 돌린다(
tasks/lanes/setup-lane.sh INT<n> fix/maturity-review-2026-09-25). 병렬 레인이 공유node_modules를 쓰는 동안 main에서 pnpm 설치가 돌면 안 되기 때문이다. - 게이트: 공통 게이트 +
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). - 레시피 번들 예산(
config/recipes/frontend-capability-recipes.json의bundleBudgetGzipBytes)은 크기 래칫이다. 초과하면 측정값(artifacts/quality/optional-recipes.json)을 100바이트 단위로 올린 값으로 고치고, 늘어난 이유(발견 ID)를 커밋에 적는다. 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.- abort 래칫(
scripts/check-adapter-inventory.ts의HAND_ROLLED_ABORT_CEILING, 현재 13)은 실측이 내려가면 같이 내린다. 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 자체의 레인 끝 게이트는 통과).