docs: hand off the maturity review fixes to another machine
tasks/handoff.md records merged and pending lanes, the remaining tasks and follow-ups, and the integration procedure. tasks/lanes/ carries the lane brief and a machine-independent worktree setup script. todo.md marks the tasks already merged into this branch. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
d2c197d82b
commit
54ba358892
@@ -0,0 +1,91 @@
|
||||
# 인계: 성숙도 리뷰(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. 브랜치 상태
|
||||
|
||||
```text
|
||||
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 → 레인 끝 게이트 |
|
||||
|
||||
후속 작업(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`로 실패
|
||||
- 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. 이 브랜치와 레인 브랜치를 받는다.
|
||||
```bash
|
||||
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한다.
|
||||
```bash
|
||||
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 자체의 레인 끝 게이트는 통과).
|
||||
@@ -0,0 +1,80 @@
|
||||
# 구현 레인 공통 지시서 (모든 레인 에이전트가 먼저 읽는다)
|
||||
|
||||
원본 repo: 이 저장소를 clone한 경로(아래 `$REPO`)
|
||||
통합 브랜치: `fix/maturity-review-2026-09-25`
|
||||
너의 작업 디렉터리(worktree)와 브랜치는 프롬프트에 적혀 있다. **그 디렉터리 밖의 파일은 읽기만 한다.** 원본 repo의 워킹트리와 다른 레인 worktree는 절대 수정하지 않는다.
|
||||
|
||||
## 1. 먼저 읽을 것 (worktree 안의 파일)
|
||||
|
||||
1. `SPEC.md` — 공통 완료 기준, 결정 표 D-1~D-19, 범위 밖 항목
|
||||
2. `tasks/plan.md` — 레인 구조, 파일 소유 표
|
||||
3. `tasks/todo.md` — 너의 레인 섹션(작업 목록과 순서)
|
||||
4. `CLAUDE.md` — repo 전제(템플릿, 배럴이 공개 경계, kernel 예외)
|
||||
5. `docs/reviews/2026-09-25-maturity-review/<영역 문서>` — 네 작업 ID 항목 전부. 근거·발생 조건·최소 개선 방향·완료 기준·검증 방법이 여기 있다.
|
||||
|
||||
**완료 기준의 기준은 리뷰 항목의 "완료 기준" 칸이다.** SPEC 결정 표가 다르게 정했으면 결정 표를 따른다.
|
||||
|
||||
## 2. 작업 하나의 순서
|
||||
|
||||
todo 순서대로 하나씩 한다.
|
||||
|
||||
1. 리뷰 항목과 관련 코드를 읽는다. 근거 줄 번호는 리뷰 당시(`4626b73`) 기준이다. 코드가 바뀌었을 수 있으니 직접 확인한다.
|
||||
2. **RED:** 문제를 재현하는 테스트를 먼저 쓰고, 실패하는 것을 확인한다. 문서만 바꾸는 작업은 이 단계가 없다. 변이 생존이 문제였던 작업은 리뷰에 적힌 변이를 넣었을 때 새 테스트가 실패하는지도 확인한다.
|
||||
3. **GREEN:** 가장 작은 변경으로 통과시킨다. 주변 코드를 정리하지 않는다. 필요 없는 추상화를 만들지 않는다.
|
||||
4. **게이트:** 아래를 모두 통과시킨다.
|
||||
```
|
||||
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`도 돌린다.
|
||||
5. **커밋:** 그 작업이 바꾼 파일만 `git add <경로>`로 스테이징한다(`git add -A` 금지). 메시지 형식은 기존 이력과 같다.
|
||||
```
|
||||
fix(<area>): <무엇을 고쳤나, 영어 소문자 시작> (<발견 ID>)
|
||||
|
||||
<왜, 1~3줄>
|
||||
|
||||
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
||||
```
|
||||
종류는 `fix`, `test`, `docs`, `perf`, `refactor`, `build`, `ci` 중 맞는 것을 쓴다.
|
||||
6. `tasks/todo.md`는 **고치지 않는다.** 체크는 오케스트레이터가 통합 때 한다.
|
||||
|
||||
## 3. 규칙
|
||||
|
||||
- **파일 소유:** `tasks/plan.md` 표에서 다른 레인이 소유한 파일은 바꾸지 않는다. 꼭 바꿔야 하면 바꾸지 말고 보고에 "다른 레인 요청"으로 적는다. `config/ci/gates.json`과 `.gitea/workflows/quality-gates.yml`은 레인 Z(Phase 0)와 K만 바꾼다.
|
||||
- **범위:** 결정 표 밖의 설계 판단이 필요하면(공개 포트를 깨야 함, 리뷰 방향이 코드와 맞지 않음 등) 그 작업은 멈추고 "막힘"으로 보고한다. 그다음 독립적인 작업은 계속한다.
|
||||
- **무관한 테스트 실패:** 다른 레인이 병렬로 돌아 호스트 부하가 높다. 네 변경과 무관해 보이는 실패가 나면 그 파일만 단독으로 다시 돌린다. 단독으로 통과하면 "부하 flaky"로 보고에 적고 진행한다. 단독으로도 실패하면 원인을 찾는다.
|
||||
- **실행:** `corepack pnpm <script>`는 worktree 안에서 돌린다. 설치 명령(`pnpm install`, `pnpm add`)은 절대 실행하지 않는다. 새 의존성은 추가하지 않는다. 필요하면 "막힘"으로 보고한다.
|
||||
- **git:** push 금지. `git config` 변경 금지. 다른 브랜치를 checkout하지 않는다. rebase·reset·stash도 하지 않는다. 네 브랜치에 커밋만 쌓는다.
|
||||
- **Playwright:** 리뷰가 브라우저 검증을 요구한 작업만 spec 하나를 추가하고 그 spec만 돌린다. 브라우저 설치 명령은 실행하지 않는다.
|
||||
- **코드 스타일:** 주변 코드의 주석 밀도, 이름, 관용구를 따른다. 코드 주석은 영어로 쓴다(기존 코드와 같게).
|
||||
- **문서:** 문서는 한국어 평범한 문장으로 쓴다. 기존 문서가 영어면 영어로 쓴다. 주장마다 코드 위치를 붙인다.
|
||||
|
||||
## 4. 레인 끝
|
||||
|
||||
모든 작업을 끝낸 뒤 다음을 한 번 돌린다.
|
||||
|
||||
```
|
||||
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 && corepack pnpm check:ci && corepack pnpm check:adapter-inventory && corepack pnpm verify:documentation && corepack pnpm build
|
||||
```
|
||||
|
||||
`corepack pnpm test:sample-removal`은 시간이 들지만 레인 끝에 한 번 돌린다.
|
||||
|
||||
## 5. 오케스트레이터에게 돌려줄 최종 메시지 (50줄 이하)
|
||||
|
||||
```
|
||||
레인: <X> · 브랜치: lane/<X> · 커밋 <N>개
|
||||
작업:
|
||||
- <ID> | 완료/막힘/부분 | <커밋 short sha> | <추가·바꾼 테스트 파일> | <한 줄 요약>
|
||||
막힘·부분: <ID와 이유, 필요한 결정>
|
||||
다른 레인 요청: <파일과 바꿀 내용>
|
||||
부하 flaky: <테스트 파일>
|
||||
레인 끝 게이트: <명령별 결과>
|
||||
```
|
||||
|
||||
## 6. 2차 레인 추가 규칙 (1차 통합 뒤, 기준 커밋 4d17259)
|
||||
|
||||
- **레시피 번들 예산:** `corepack pnpm build` 뒤 `corepack pnpm check:optional-recipes`를 돌린다. 네 수정으로 `config/recipes/frontend-capability-recipes.json`의 `bundleBudgetGzipBytes`를 넘으면 예산을 **고치지 말고** 측정값(`artifacts/quality/optional-recipes.json`)을 보고에 적는다. 오케스트레이터가 통합 때 "측정값을 100바이트 단위로 올림" 규칙으로 한 번에 올린다. 현재 여유: realtime 39,903/40,000, service-worker-pwa 9,623/10,000, file-transfer 55,517/55,600, offline-indexeddb 36,822/36,900.
|
||||
- **초기 JS 예산:** `check:bundle`이 초과하면 역시 고치지 말고 보고한다(현재 약 196.5KB/204.8KB).
|
||||
- **`config/ci/gates.json`:** 2차 레인은 필요할 때만 바꾼다. 바꾸면 `CI_CONTRACT_BASELINE_OWNER=<담당> CI_CONTRACT_BASELINE_REASON=<이유·ID> corepack pnpm update:ci-contract-baseline` → `corepack pnpm generate:ci-workflow` → `tests/unit/ci-workflow-generation.test.ts` 개수 갱신 → `check:ci`. 여러 레인이 바꾸면 오케스트레이터가 통합 때 기준선을 다시 만든다.
|
||||
- **Playwright 포트:** 여러 레인이 동시에 브라우저 테스트를 돌린다. 프롬프트에 적힌 네 포트를 쓰는 임시 설정 파일을 `.tmp/`에 만들어(커밋하지 않음) 그 설정으로 spec을 돌린다. 기존 설정 파일을 복사해 `webServer.port`/`url`/`baseURL`만 바꾸면 된다.
|
||||
- **1차 레인이 바꾼 것:** 결과 불명 쓰기의 같은 키 재전송(C), 폼 실패 상태(C), `needs` 검사와 기능 선택 생성기(I), 부트 오류 경로 `boot.tsx`·`boot-messages.ts`(I, `BootErrorShell`은 i18n catalog를 import하면 안 된다), 그래프 규칙과 위반 메시지(K), drill·hosting 판정 UNVERIFIED(K). 이 위에서 작업한다.
|
||||
- **레인 끝 게이트**에 `corepack pnpm check:optional-recipes`(build 뒤)를 더한다.
|
||||
Executable
+42
@@ -0,0 +1,42 @@
|
||||
#!/usr/bin/env bash
|
||||
# Usage: tasks/lanes/setup-lane.sh <LANE> [base-ref]
|
||||
# LANE lane letter (B, D, ...) -> worktree $LANES_DIR/<LANE>/wt on branch lane/<LANE>
|
||||
# INT* names make a detached worktree for integration checks
|
||||
# base-ref defaults to fix/maturity-review-2026-09-25; an existing lane/<LANE>
|
||||
# branch is checked out as is instead of created
|
||||
# LANES_DIR defaults to <repo>/../<repo-name>-lanes.
|
||||
# node_modules is a real directory of per-entry symlinks into the repo's own
|
||||
# node_modules; pnpm's state files are copied and retargeted so `corepack pnpm`
|
||||
# in the worktree does not start an install through the shared packages.
|
||||
set -euo pipefail
|
||||
LANE="$1"
|
||||
BASE="${2:-fix/maturity-review-2026-09-25}"
|
||||
R="$(git -C "$(dirname "$0")" rev-parse --show-toplevel)"
|
||||
LANES_DIR="${LANES_DIR:-$(dirname "$R")/$(basename "$R")-lanes}"
|
||||
W="$LANES_DIR/$LANE/wt"
|
||||
mkdir -p "$(dirname "$W")"
|
||||
if [[ "$LANE" == INT* ]]; then
|
||||
git -C "$R" worktree add --detach "$W" "$BASE"
|
||||
elif git -C "$R" show-ref --verify --quiet "refs/heads/lane/$LANE"; then
|
||||
git -C "$R" worktree add "$W" "lane/$LANE"
|
||||
else
|
||||
git -C "$R" worktree add -b "lane/$LANE" "$W" "$BASE"
|
||||
fi
|
||||
mkdir "$W/node_modules"
|
||||
for e in $(ls -A "$R/node_modules"); do
|
||||
case "$e" in
|
||||
.pnpm-workspace-state-v1.json|.modules.yaml|.package-map.json) cp "$R/node_modules/$e" "$W/node_modules/$e" ;;
|
||||
.vite) ;;
|
||||
*) ln -s "$R/node_modules/$e" "$W/node_modules/$e" ;;
|
||||
esac
|
||||
done
|
||||
node -e '
|
||||
const fs = require("fs");
|
||||
const f = process.argv[1] + "/node_modules/.pnpm-workspace-state-v1.json";
|
||||
const s = JSON.parse(fs.readFileSync(f, "utf8"));
|
||||
const v = Object.values(s.projects)[0];
|
||||
s.projects = { [process.argv[1]]: v };
|
||||
s.lastValidatedTimestamp = Date.now();
|
||||
fs.writeFileSync(f, JSON.stringify(s, null, 2));
|
||||
' "$W"
|
||||
echo "$W"
|
||||
+81
-80
@@ -14,32 +14,32 @@
|
||||
|
||||
## 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
|
||||
- [x] 10-01 새 clone에서 `test:unit` 통과 — 완료: `removal-fixture.test.ts`가 임시 폴더의 가짜 증거로 검사. 새 worktree에서 `test:unit` 통과
|
||||
- [x] 00-01 fixture가 공유 `node_modules`의 pnpm 상태 파일을 덮어쓰지 않음 — 완료: 통합 테스트 전후 원본 상태 파일 해시 동일
|
||||
- [x] 14-01 샘플 제거 게이트 복구 — 완료: 플랫폼 테스트 6개가 샘플 대신 테스트 전용 기능·platform route 사용. `test:sample-removal` PASS(13 testcase 성공)
|
||||
- [x] 14-02 CI 계약 기준값 외부화 (D-13) — 완료: `config/ci/contract-baseline.json` + `update:ci-contract-baseline`. 샘플 제거 fixture가 `CI_CONTRACT_MODE` 없이 canonical `check:ci`·`check:registries` 통과
|
||||
- [x] 12-02 · 13-01 workflow가 job의 모든 gate 실행 — 완료: workflow에 `ci:gate -- FE-GATE-027`. 계약 검사가 run step 누락 변형을 거부. `APP_PROFILE`≠`RELEASE_TARGET`이면 실패. 변수 문서화
|
||||
- [x] 12-01 (repo 쪽, D-17) — 완료: push 트리거에 `main`. README에 CI 상태와 머지 전 로컬 명령
|
||||
- [x] 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` 통과
|
||||
- [x] 공통 게이트 + `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 동시 상한·재사용
|
||||
- [x] 01-01 PUT 401/403·만료 → capability 재발급 재시도
|
||||
- [x] 01-04 같은 idempotency key 재사용 테스트 3개 — 완료: 변이 M1·M6·M7 검출
|
||||
- [x] 01-02 완료·결과 불명 업로드 보고 — 완료: complete 성공 뒤 정리 실패도 성공 반환, `abort()` ALREADY_COMPLETED에 resourceId
|
||||
- [x] 01-03 크기·진행 기반 전송 제한 — 완료: 1Mbit/s 모의에서 5MiB part 성공, 멈춘 연결은 idle 제한 안에 끊김
|
||||
- [x] 01-05 recovery → 행동 1:1 — 완료: ABORT_PENDING과 CAS 충돌 실패값 구분, port 주석 표
|
||||
- [x] 01-06 `maxClockSkewMs`
|
||||
- [x] 01-07 vault 항목 `finally` 정리
|
||||
- [x] 01-08 재개 시 정책 재검사 제거
|
||||
- [x] 01-09 part 수 상한 × 전송 상한 교차 검사
|
||||
- [x] 01-10 `UPLOAD_PART` 관측 1건 + 시도 수 bucket
|
||||
- [x] 01-11 image probe 동시 상한·재사용
|
||||
|
||||
## 레인 B — browser-files / cache (`02-adapters-browser-files-cache.md`)
|
||||
|
||||
@@ -55,17 +55,17 @@
|
||||
|
||||
## 레인 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 현행화
|
||||
- [x] 03-01 · 08-03 결과 불명 쓰기의 같은 키 재전송 (D-1) — 완료: 504 뒤 재전송의 `Idempotency-Key` 동일, 근거 없는 "변경되지 않음" 확정 경로 없음
|
||||
- [x] 03-02 401/403/429 분류 (D-2)
|
||||
- [x] 08-01 폼 저장 실패 상태 분리 (D-2) — 완료: 401·403·429가 서로 다른 문구·행동, "입력 내용을 확인해 주세요" 제목 없음
|
||||
- [x] 03-03 correlation id → `requestId`, 요청 식별자 헤더
|
||||
- [x] 03-04 V3 422 필드 오류가 폼까지
|
||||
- [x] 03-05 텔레메트리 keepalive 64KiB 분할
|
||||
- [x] 10-03 KEYED·retryBudget 2 실행기 테스트 — 완료: 변이 M1b 검출
|
||||
- [x] 13-11 텔레메트리 envelope에 `build_id`·`release_id`
|
||||
- [x] 03-06 전송별 재시도·타임아웃 규칙 표
|
||||
- [x] 03-07 전송 0회 미인증은 telemetry 0건
|
||||
- [x] 03-08 HTTP 복구 runbook 현행화
|
||||
|
||||
## 레인 D — realtime (`04-adapters-realtime.md`)
|
||||
|
||||
@@ -80,20 +80,20 @@
|
||||
|
||||
## 레인 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 유예 기준(또는 계약 주석)
|
||||
- [x] 05-01 OPFS reconcile vs 진행 중 put (D-3) — 완료: 공유 root 2런타임에서 put 성공이면 open 성공, reconcile은 행 건너뜀
|
||||
- [x] 05-02 빈 receipt = 없음, reconcile 루프 계속 → GC 도달
|
||||
- [x] 05-08 메모리 IndexedDB 대역 fidelity(DB 이름 분리·트랜잭션 직렬화·비활성 요청 예외 또는 헤더 명시)
|
||||
- [x] 05-03 손상 governance에서도 LOGOUT/ACCOUNT_DELETION 삭제
|
||||
- [x] 05-04 OPFS purge 뒤 partition 파일 0개
|
||||
- [x] 05-05 sweep·prune이 손상 행 건너뜀
|
||||
- [x] 05-06 future schema → INCOMPATIBLE/ONLINE_ONLY
|
||||
- [x] 05-07 멈춘 put idle timeout으로 lock 해제
|
||||
- [x] 05-09 OPFS runbook 현행화, 죽은 `EFFECT_UNKNOWN` 분기 정리
|
||||
- [x] 05-10 objectId 문법 policy 연동, `stableJson` 한 벌
|
||||
- [x] 05-11 IndexedDB 예외 매핑 한 벌, OPFS→indexeddb import 0
|
||||
- [x] 05-12 binding 검증을 kernel 트랜잭션으로
|
||||
- [x] 05-13 admission 중 versionchange 처리
|
||||
- [x] 05-14 GC 유예 기준(또는 계약 주석)
|
||||
|
||||
## 레인 F — Service Worker / Web Push (`06-adapters-service-worker-push.md`)
|
||||
|
||||
@@ -132,20 +132,21 @@
|
||||
|
||||
## 레인 I — 애플리케이션 코어·조립·빌드 입력 (`09-app-core.md`)
|
||||
|
||||
- [ ] 09-01 기능 2개 이상 설치 타입 — 완료: 모양이 다른 두 기능 설치 typecheck fixture가 게이트에서 통과
|
||||
- [ ] 09-05 `needs` 검사 + IndexedDB capability 조립 예시
|
||||
- [ ] 09-02 `VITE_PRODUCT_FEATURES`를 생성기에서 (D-9)
|
||||
- [ ] 13-06 `VITE_*` 개별 참조 + 전체 객체 참조 lint 금지 + 허용 목록 밖 변수 build 실패
|
||||
- [ ] 13-07 하위 경로 배포 URL
|
||||
- [ ] 09-03 모듈 평가 실패도 부트 오류 화면
|
||||
- [ ] 09-04 `BOOT_UNEXPECTED_FAILURE`, 원인 보존
|
||||
- [ ] 09-06 local-draft 도메인 규칙 적용
|
||||
- [ ] 09-07 · 14-03 기능 추가·제거 경로 (D-10), 문서 현행화
|
||||
- [ ] 14-08 제거 스크립트 실패 보고·임시 폴더
|
||||
- [ ] 09-08 local-draft ABA 방지
|
||||
- [ ] 09-09 모르는 override 키 진단
|
||||
- [ ] 09-10 부트 실패 다시 시도 버튼
|
||||
- [ ] 09-12 local-draft fixture 복사본 제거
|
||||
- [x] 09-01 기능 2개 이상 설치 타입 — 완료: 모양이 다른 두 기능 설치 typecheck fixture가 게이트에서 통과
|
||||
- [x] 09-05 `needs` 검사 + IndexedDB capability 조립 예시
|
||||
- [x] 00-02 local-draft가 제거 대상 런타임을 직접 import하지 않음 — 완료: 제거 검증 4개 PASS (Phase 0에서 새로 발견)
|
||||
- [x] 09-02 `VITE_PRODUCT_FEATURES`를 생성기에서 (D-9)
|
||||
- [x] 13-06 `VITE_*` 개별 참조 + 전체 객체 참조 lint 금지 + 허용 목록 밖 변수 build 실패
|
||||
- [x] 13-07 하위 경로 배포 URL
|
||||
- [ ] 09-03 모듈 평가 실패도 부트 오류 화면 — 남음: F-2(레인 J)
|
||||
- [x] 09-04 `BOOT_UNEXPECTED_FAILURE`, 원인 보존
|
||||
- [x] 09-06 local-draft 도메인 규칙 적용
|
||||
- [ ] 09-07 · 14-03 기능 추가·제거 경로 (D-10), 문서 현행화 — 남음: F-3(lane/G에 커밋, 통합 전)
|
||||
- [x] 14-08 제거 스크립트 실패 보고·임시 폴더
|
||||
- [x] 09-08 local-draft ABA 방지
|
||||
- [x] 09-09 모르는 override 키 진단
|
||||
- [x] 09-10 부트 실패 다시 시도 버튼
|
||||
- [x] 09-12 local-draft fixture 복사본 제거
|
||||
|
||||
## 레인 J — 테스트 체계 (`10-tests-fast-layers.md`, `11-tests-browser-release-scale.md`)
|
||||
|
||||
@@ -164,31 +165,31 @@
|
||||
|
||||
`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
|
||||
- [ ] 13-09 `engineStrict`·`saveExact`를 `pnpm-workspace.yaml`로
|
||||
- [ ] 13-12 SBOM·provenance 증명 범위 표, 배포물 패키지 목록
|
||||
- [ ] 13-13 provider 없는 구성 문서화, 키 교체 절차
|
||||
- [ ] 13-14 번들 예산 기준선·여유·조건 문서
|
||||
- [ ] 13-15 README 설정 절, `public/config.json` 동기화
|
||||
- [x] 08-06 수동 a11y 게이트를 release 단계로 (D-8)
|
||||
- [x] 11-01 · 13-03 drill 판정 정직화 (D-14) — 완료: JS 자산 없는 dist에서 FE-RB-002·005 실패, provider 없으면 UNVERIFIED, 016/025 중복 정리
|
||||
- [x] 11-03 CPU 무관 scale tier를 PR 게이트에
|
||||
- [x] 12-03 재수출 경유 경계 우회 차단
|
||||
- [x] 12-10 · 12-08 정규식 import 규칙 → 그래프 규칙 (D-12)
|
||||
- [x] 12-05 dependency-cruiser 실행 제거·문서 정정 (D-11)
|
||||
- [x] 12-06 `import.meta.glob` 거부
|
||||
- [x] 12-07 예외 범위 축소·이유·담당
|
||||
- [x] 12-09 레이어 규칙 기준 파일 하나
|
||||
- [x] 12-11 위반 메시지에 이유·해결 방향
|
||||
- [x] 13-02 dist 공개 파일 권한
|
||||
- [x] 13-04 `verify:promotion` 보관 모드
|
||||
- [x] 13-05 hosting 헤더 fixture 모드는 UNVERIFIED, live는 배포 후 (D-14)
|
||||
- [ ] 13-08 운영 CSP 아래 e2e smoke — 남음: F-7(lane/G wip)
|
||||
- [x] 13-09 `engineStrict`·`saveExact`를 `pnpm-workspace.yaml`로
|
||||
- [x] 13-12 SBOM·provenance 증명 범위 표, 배포물 패키지 목록
|
||||
- [x] 13-13 provider 없는 구성 문서화, 키 교체 절차
|
||||
- [x] 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)
|
||||
- [ ] 14-05 `docs/README.md` 색인 (D-16)
|
||||
- [ ] 14-06 README 지원 범위 표·상태 어휘 대응표
|
||||
- [ ] 14-04 CHANGELOG, README 업데이트 절, 로컬 태그 (D-15) — 남음: F-13(버전·태그, 마지막 작업)
|
||||
- [x] 14-05 `docs/README.md` 색인 (D-16)
|
||||
- [x] 14-06 README 지원 범위 표·상태 어휘 대응표
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user