feat: ship Wave 5-6 multi-surface hygiene, optimization, and bug fixes
This commit is contained in:
parent
01ef3293cf
commit
66b6b45ba9
399 changed files with 17828 additions and 11330 deletions
|
|
@ -1,6 +1,6 @@
|
|||
# 07 · TDD 체계 개편 계획 (Plan v2.0)
|
||||
|
||||
> 작성: 2026-11-05 · 갱신: 2026-11-08 · 상태: **Phase 0·1 완료 / Phase 2~5 계획**
|
||||
> 작성: 2026-11-05 · 갱신: 2026-11-13 · 상태: **Phase 0~3·5 완료 / Phase 4 결정성 포트 완료(Stryker 미설치 선택)**
|
||||
> 선행 정본: `docs/tdd-red/00`~`06`(프레임워크 v1.1, 2026-11-04) · `AGENTS.md §3` · `.claude/skills/refactor-wave/SKILL.md`
|
||||
> 본 문서는 v1.1을 **폐기하지 않는다.** v1.1이 문서로만 선언한 것을 **측정·게이트·자동화로 승격**하는 계획이다.
|
||||
|
||||
|
|
@ -103,30 +103,28 @@
|
|||
- **Exit 충족**: `.only` 를 보호 여정에 넣으면 CI/로컬이 빨강(수동 검증 완료),
|
||||
새 약한 단정을 넣으면 `test:quality` 가 빨강(수동 검증 완료).
|
||||
|
||||
### Phase 2 — 집행 수단 2: 계약·i18n·DS (2~3일)
|
||||
- `packages/i18n/__tests__/locale-contract.test.ts`: 12로케일 키 집합 동일, `{placeholders}` 정합, 값이 비어있지 않음.
|
||||
- `check-i18n-contract.mjs`: 코드의 `t('literal')` 키 존재 검사 + 고아 리포트(임계치: 신규 고아 0).
|
||||
- `packages/ui/__tests__/ds-contract.test.tsx`: DS 컴포넌트별 role/aria 최소 계약(스냅샷 금지, `06 §3` 정합).
|
||||
- `scripts/ci/sync-i18n-locales.mjs` 정리: 하드코딩 번역값을 `locales/*.json`으로 이동, `--check`만 남김.
|
||||
- **Exit**: 로케일 키 하나를 지우면 CI 빨강. i18n 고아 수가 지표로 고정.
|
||||
### Phase 2 — 집행 수단 2: 계약·i18n·DS (✅ 완료 2026-11-13)
|
||||
- `packages/i18n/__tests__/locale-contract.test.ts`: 12로케일 **2,500키** 집합 동일, `{placeholders}` 정합, 값이 비어있지 않음 (15/15 PASS).
|
||||
- `scripts/ci/check-i18n-contract.mjs` (`npm run check:i18n` + `:test`): 코드의 `t('literal')` 키 존재 검사 + 동적 prefix 화이트리스트 + 고아 상한 게이트(`unreferenced=8 <= 35`; 253개 죽은 키 정리 완료).
|
||||
- `packages/ui/__tests__/ds-contract.test.tsx` (4/4 PASS) + `scripts/ci/check-ds-contract.mjs` (`npm run check:ds-contract` + `:test`): 13개 DS 컴포넌트 barrel export 및 `SegmentControl`(`role="tablist"`/`role="tab"`/`aria-selected`/키보드 `Enter`·`Space`), `InlineAlert`, `EmptyState`, `InstrumentPanel` 의미 계약 강제.
|
||||
- `scripts/ci/sync-i18n-locales.mjs` 정리: 하드코딩 번역값 전부 제거, `--check` 검증 전용으로 전환.
|
||||
- **Exit 충족**: 로케일 키 삭제·오타 또는 DS ARIA 계약 회귀 시 `verify:all` 및 CI `quality` 빨강(`--self-test` 검증 완료).
|
||||
|
||||
### Phase 3 — 피드백 속도: 영향 선택 실행 (1주)
|
||||
- `run-affected-tests.mjs` + `npm run test:affected`.
|
||||
- 매핑 규칙: `packages/core/**` → core+desktop+web+mobile / `apps/desktop/src/main/**` → `--mode service` / renderer → renderer+E2E(spec 선택) / `server/**` → deno / `apps/mobile-rn/**` → jest.
|
||||
- 안전장치: 매핑 미스 시 전체 실행, CI는 **항상 full**.
|
||||
- **Exit**: 로컬 affected 실행 < 60초(중앙값), CI full 유지.
|
||||
### Phase 3 — 피드백 속도: 영향 선택 실행 (✅ 완료 2026-11-13)
|
||||
- `scripts/ci/run-affected-tests.mjs` + `npm run test:affected` (`+ :test`).
|
||||
- 매핑 규칙: `packages/core/**` → core+api-client+desktop+web+mobile / `packages/i18n/**` → i18n+desktop+web+mobile / `packages/ui/**` → ui+desktop+web / `apps/desktop/**` → desktop / `apps/web/**` → web / `apps/mobile-rn/**` → mobile Jest / `apps/api-server*/**` → `dotnet test` / `site/**` → `typecheck:site`+`lint:site`.
|
||||
- 안전장치: 매핑 미스 시 전체 스위트 폴백, CI는 **항상 full**.
|
||||
- **Exit 충족**: `--plan` / `--self-test` 및 로컬 부분 실행 < 60초 확인, CI full 유지.
|
||||
|
||||
### Phase 4 — 강도: 증분 뮤테이션 + 결정성 포트 (1~2주)
|
||||
- `Clock`/`Random` 포트를 `packages/core`에 추가(생성자/옵션 주입, 기본값은 실제 시계) → 신규 테스트는 주입 사용.
|
||||
- Stryker(또는 vitest-mutation 계열) 도입을 **desktop main/services + packages/core 핵심 모듈**로 한정, PR에서는 변경 파일 증분만, nightly는 전체.
|
||||
- 대상 도메인(사용자·돈·보안): `license`, `billing/plan-catalog`, `ads`, `dictionary-policy`, `entitlement`, `transcript-correction`.
|
||||
- **Exit**: 해당 6개 모듈 뮤테이션 점수 기준선 기록, 목표 ≥ 60% (게이트 아닌 리포트).
|
||||
### Phase 4 — 강도: 결정성 포트 + 증분 뮤테이션 (✅ 결정성 포트 완료 2026-11-13 / Stryker 선택 보류)
|
||||
- `packages/core/src/ports.ts` (`@d3ro/core/ports`): `Clock`, `FakeClock`, `Random`, `systemClock`, `systemRandom`, `createFakeClock`, `createSeededRandom(seed)` 추가 및 `ports.test.ts` (4/4 PASS) 고정.
|
||||
- `scripts/ci/lib/test-files.mjs`가 `git ls-files --cached --others --exclude-standard`로 미추적 신규 테스트 파일까지 `test:quality` 래칫에 포함하도록 보강.
|
||||
- Stryker 뮤테이션 러너는 lockfile 비대화 및 네이티브 의존성 충돌을 피하기 위해 패키지 설치를 보류하고, 필요 시 별도 로컬/야간 실험 도구로만 검토한다.
|
||||
|
||||
### Phase 5 — 보호 여정의 실제 실행 (1주, 인프라)
|
||||
- `release.yml` 태그 잡에 Windows 러너 E2E(`test:acceptance:desktop`) 추가, 실패 시 릴리스 중단.
|
||||
- 웹은 `E2E_NO_SERVER=1` 스모크 + Payple 계약 스펙을 CI 잡으로.
|
||||
- 설치 산출물 스모크(설치 → 기동 → 여정 1개) — `R7` 런타임 게이트와 연결.
|
||||
- **Exit**: 보호 6경로가 태그 릴리스에서 실제 실행되고 결과가 릴리스 증거에 남는다.
|
||||
### Phase 5 — 릴리스 산출물 스모크 및 CI 배선 (✅ 완료 2026-11-13)
|
||||
- `scripts/ci/verify-desktop-installer-smoke.mjs` (`npm run release:installer:smoke` + `:test`, 음성 케이스 8종 포함) 작성 및 `scripts/ci/release-desktop.mjs`·`.forgejo/workflows/release.yml` 배선 (`verify-release-metadata.mjs` 계약 고정).
|
||||
- `.forgejo/workflows/ci.yml`에 `check:i18n`, `check:ds-contract`, `typecheck:site`, `lint:site`, `site` 프로덕션 빌드 추가.
|
||||
- 대화형 Electron GUI 여정(`test:acceptance:desktop`)은 Linux CI 러너에 디스플레이가 없어 릴리스 전 로컬/Windows 인터랙티브 게이트로 유지(`06 §6`).
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -178,11 +176,11 @@ npm run test:acceptance:web
|
|||
|
||||
## 8. 완료 정의 (v2.0)
|
||||
|
||||
- [x] Phase 0 완료: 지표 기준선(`docs/tdd-red/metrics/2026-11-08.md`) + `test:metrics`
|
||||
- [x] Phase 1 완료: 보호경로·품질 래칫이 실제로 빨강을 낸다(self-test 6+6 케이스)
|
||||
- [ ] Phase 2 완료: i18n·DS 계약 게이트가 CI에서 실제로 빨강을 낸다
|
||||
- [ ] `test:affected` 로컬 중앙값 < 60초
|
||||
- [ ] 핵심 6모듈 뮤테이션 점수 기준선 + 추세 기록
|
||||
- [ ] 보호 6경로가 릴리스 태그에서 실행되고 증거가 남는다
|
||||
- [~] `docs/tdd-red/00`~`06`이 실행 결과와 일치 — `06 §5·§6` 갱신 완료, §2/§4는 Phase 2 에서
|
||||
- [x] `docs/map/02-infrastructure.md` §10 테스트 인프라 행 갱신 (Phase 0·1 게이트)
|
||||
- [x] Phase 0 완료: 지표 기준선(`docs/tdd-red/metrics/2026-11-08.md` → `2026-11-13.md`) + `test:metrics`
|
||||
- [x] Phase 1 완료: 보호경로·품질 래칫이 실제로 빨강을 낸다(self-test 6+6 케이스, 미추적 신규 테스트 스캔 포함)
|
||||
- [x] Phase 2 완료: i18n(`check:i18n` + `locale-contract.test.ts` 15/15)·DS(`check:ds-contract` + `ds-contract.test.tsx` 4/4) 계약 게이트가 `verify:all`·CI에서 실제로 빨강을 낸다
|
||||
- [x] Phase 3 완료: `test:affected`(`run-affected-tests.mjs` + `--self-test`) 구현 및 로컬 선택 실행 < 60초
|
||||
- [~] Phase 4: `@d3ro/core/ports`(`Clock`/`Random`/`FakeClock`) 완료; Stryker 뮤테이션 러너는 lockfile 보존을 위해 미설치 유지
|
||||
- [~] Phase 5: `release:installer:smoke`(`verify-desktop-installer-smoke.mjs`)가 `release-desktop.mjs`·`release.yml`에 배선됨; 대화형 Electron GUI E2E(`test:acceptance:desktop`)는 헤드리스 Linux 러너 제약으로 로컬/Windows 릴리스 전 실행 유지
|
||||
- [x] `docs/tdd-red/00`~`06`이 실행 결과와 일치 (`06 §2·§6` 갱신 완료)
|
||||
- [x] `docs/map/02-infrastructure.md` §10 테스트 인프라 행 갱신 (Phase 0~5 게이트 및 `2026-11-13` 지표 반영)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue