feat: ship Wave 5-6 multi-surface hygiene, optimization, and bug fixes

This commit is contained in:
Yun Chan 2026-11-14 11:51:41 +09:00
parent 01ef3293cf
commit 66b6b45ba9
399 changed files with 17828 additions and 11330 deletions

View file

@ -38,9 +38,9 @@
| 계층 | 도구 | 경로 | 실행 | 게이트 |
|---|---|---|---|---|
| 정적 | tsc strict, eslint, 디자인 토큰 | `apps/*/src`, `packages/*` | `npm run typecheck`, `npm run lint`, `npm run check:design` | CI `quality` |
| 테스트 위생 | node 스크립트 | 위 패턴의 모든 테스트 파일 | `npm run test:hygiene` (+ `:test` 셀프테스트) | CI `quality` |
| 단위 | Vitest | `apps/desktop/tests/{unit,main,shared,renderer}`, `apps/web/tests`, `packages/*/__tests__` | `npm --prefix apps/desktop run test:unit`, `npm --prefix apps/web run test` | CI `test` |
| 정적 | tsc strict, eslint, 디자인 토큰 | `apps/*/src`, `packages/*`, `site/src` | `npm run typecheck`, `npm run typecheck:site`, `npm run lint`, `npm run lint:site`, `npm run check:design` | CI `quality` |
| 테스트 위생·계약 | node 스크립트 | 모든 테스트·로케일·DS 컴포넌트 | `npm run test:hygiene`, `npm run check:protected-tests`, `npm run test:quality`, `npm run check:i18n`, `npm run check:ds-contract` | CI `quality` |
| 단위 | Vitest | `apps/desktop/tests/{unit,main,shared,renderer}`, `apps/web/tests`, `packages/{core,api-client,i18n,ui}/__tests__` | `npm run test` (또는 `npm run test:affected`) | CI `test` |
| 서비스 통합 | Vitest | `apps/desktop/tests/{main,red}` | `npm --prefix apps/desktop run test:service` | CI `test` |
| 계약(E2E-ish, 결정적) | Vitest | `apps/desktop/tests/red/*.test.ts`, `apps/desktop/tests/integration/*.test.ts` | `npm --prefix apps/desktop run test:integration` | CI `test` |
| E2E (데스크톱) | Playwright `_electron` | `apps/desktop/tests/e2e/*.spec.ts` | `npm --prefix apps/desktop run test:e2e` | 로컬/릴리스 전 |
@ -164,12 +164,16 @@ npm run test:e2e --workspace=@d3ro/web
`e2e/` 밖의 `*.spec.ts`, 단정이 한 줄도 없는 테스트 파일.
규칙을 늘릴 때는 `--self-test` 에 unsafe/safe fixture 를 **함께** 추가한다(오탐 방지).
TDD 2.0 에서 추가된 게이트 (2026-11-08, `07-revamp-plan.md` Phase 0–1):
TDD 2.0 에서 추가된 게이트 (2026-11-08 ~ 2026-11-13, `07-revamp-plan.md` Phase 0–5):
| 게이트 | 명령 | 막는 것 |
|---|---|---|
| 보호 수용 무결성 | `npm run check:protected-tests` (`--base <rev>`) | 보호 여정의 테스트·단정 감소, `.only`·`skip` 추가 — `allow-protected-change:` 커밋 마커 없이는 실패 |
| 품질 래칫 | `npm run test:quality` | 파일별 **약한 단정**(`toBeDefined/toBeTruthy/toBeFalsy/toBeNull`)과 **ambient 시계/난수**(`Date.now/Math.random/performance.now`) 증가 |
| 품질 래칫 | `npm run test:quality` | 파일별 **약한 단정**(`toBeDefined/toBeTruthy/toBeFalsy/toBeNull`)과 **ambient 시계/난수**(`Date.now/Math.random/performance.now`) 증가 (미추적 신규 테스트 파일 포함) |
| i18n 계약 | `npm run check:i18n` (`+ :test`) | 12개 로케일 키 집합·`{placeholder}` 불일치, 빈 값, 코드 내 미존재 `t('literal')` 키, 미참조 고아 키 임계치 초과(`<= 35`) |
| DS 계약 | `npm run check:ds-contract` (`+ :test`) | `packages/ui` DS 컴포넌트 barrel export 누락, 대화형 컴포넌트 ARIA/role 계약 누락, `ds-contract.test.tsx` 미참조 |
| 영향 선택 실행 | `npm run test:affected` (`+ :test`) | 변경 파일 기반 워크스페이스/스위트 선택 실행 (매핑 미스 시 전체 스위트 폴백; CI는 항상 전체 실행) |
| 설치본 스모크 | `npm run release:installer:smoke` (`+ :test`) | 릴리스 산출물(`.exe`, `.blockmap`, `latest.yml`, Ed25519 `.sig`, `app.asar`, 렌더러 HTML/에셋, 네이티브 ABI) 누락·불일치 |
| 지표 | `npm run test:metrics[:write]` | 아무것도 막지 않는다. 추세 기록용(`docs/tdd-red/metrics/`) |
세 게이트는 테스트 파일 판정을 `scripts/ci/lib/test-files.mjs` 한 곳에서 공유한다.

View file

@ -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` 지표 반영)

View file

@ -0,0 +1,72 @@
# 테스트 체계 지표 — 2026-11-13
> `node scripts/ci/test-metrics.mjs --write` 로 생성된다. 손으로 고치지 않는다.
> 정책: `docs/tdd-red/07-revamp-plan.md` §3-2 (지표는 게이트가 아니다)
## 합계
| 항목 | 값 |
|---|---|
| 테스트 파일 | 422 |
| 테스트 케이스 | 3558 |
| 단정(expect/assert) | 9224 |
| 약한 단정 (toBeDefined/toBeTruthy/toBeFalsy/toBeNull) | 128 |
| 시간·난수 직접 호출 (ambient) | 203 |
| skip/todo | 3 |
| i18n 로케일 파일 | 12 |
| i18n 키 (ko 기준) | 2500 |
## 스위트별
| 스위트 | 파일 | 케이스 | 단정 | 약한 단정 | ambient |
|---|---:|---:|---:|---:|---:|
| 데스크톱 (Vitest) | 218 | 2100 | 5264 | 88 | 164 |
| packages/core (Vitest) | 38 | 560 | 1294 | 14 | 3 |
| packages/i18n (Vitest) | 1 | 4 | 13 | 0 | 0 |
| packages/ui (Vitest) | 1 | 4 | 19 | 0 | 0 |
| packages/api-client (Vitest) | 4 | 31 | 47 | 3 | 0 |
| 웹 (Vitest + Playwright) | 11 | 54 | 229 | 9 | 5 |
| 모바일 (Jest) | 97 | 515 | 1632 | 14 | 24 |
| Supabase Edge (Deno) | 44 | 263 | 637 | 0 | 7 |
| Cloudflare Worker (Deno) | 1 | 5 | 22 | 0 | 0 |
| API 서버 (xUnit) | 7 | 22 | 67 | 0 | 0 |
## 약한 단정 상위 파일
| 파일 | 개수 |
|---|---:|
| `packages/core/__tests__/keybinding.test.ts` | 10 |
| `apps/mobile-rn/__tests__/auth-privacy-boundary.test.tsx` | 9 |
| `apps/desktop/tests/main/services/input-telemetry-stale-snapshot.test.ts` | 8 |
| `apps/web/e2e/dashboard-dictionary-commands.spec.ts` | 7 |
| `apps/desktop/tests/unit/stt-model-download-redteam-r3-24.test.ts` | 6 |
| `apps/desktop/tests/main/sync/cloud-credentials-redteam-r3-1.test.ts` | 5 |
| `apps/desktop/tests/red/history.usecase.test.ts` | 5 |
| `apps/desktop/tests/red/ads/ads-mediation.test.ts` | 4 |
| `apps/desktop/tests/main/services/CustomInstructionService.test.ts` | 3 |
| `apps/desktop/tests/unit/AdMediationEngine.test.ts` | 3 |
| `packages/core/__tests__/typo-correction.test.ts` | 3 |
| `apps/desktop/tests/main/services/DictionaryService.test.ts` | 2 |
| `apps/desktop/tests/main/services/HistoryService.test.ts` | 2 |
| `apps/desktop/tests/main/services/KeyBindingService.test.ts` | 2 |
| `apps/desktop/tests/main/services/i18n-locale-parity.test.ts` | 2 |
## ambient 시간·난수 상위 파일
| 파일 | 개수 |
|---|---:|
| `apps/desktop/tests/main/services/suggestion-redteam-r1-1.test.ts` | 11 |
| `apps/desktop/tests/integration/cross-device-sync.supabase.test.ts` | 10 |
| `apps/desktop/tests/main/sync/SyncEngine.test.ts` | 10 |
| `apps/desktop/tests/red/crypto-license.usecase.test.ts` | 8 |
| `server/supabase/functions/_shared/admob-ssv.test.ts` | 7 |
| `apps/desktop/tests/main/services/input-flow-services.test.ts` | 6 |
| `apps/desktop/tests/main/services/modifier-state.test.ts` | 6 |
| `apps/desktop/tests/main/services/suggestion-redteam-r2-3.test.ts` | 6 |
| `apps/desktop/tests/main/services/suggestion-redteam-r3-1.test.ts` | 6 |
| `apps/desktop/tests/red/meeting-recording-redteam-r2-1.test.ts` | 6 |
| `apps/mobile-rn/__tests__/templates-memos.local.integration.mjs` | 6 |
| `apps/desktop/tests/main/services/input-telemetry-focus-flicker.test.ts` | 5 |
| `apps/mobile-rn/__tests__/admin-mobile.local.e2e.mjs` | 5 |
| `apps/desktop/tests/eval/suggestion-replay.eval.test.ts` | 4 |
| `apps/desktop/tests/main/services/KeyBindingService.test.ts` | 4 |

View file

@ -0,0 +1,72 @@
# 테스트 체계 지표 — 2026-11-14
> `node scripts/ci/test-metrics.mjs --write` 로 생성된다. 손으로 고치지 않는다.
> 정책: `docs/tdd-red/07-revamp-plan.md` §3-2 (지표는 게이트가 아니다)
## 합계
| 항목 | 값 |
|---|---|
| 테스트 파일 | 445 |
| 테스트 케이스 | 3655 |
| 단정(expect/assert) | 9549 |
| 약한 단정 (toBeDefined/toBeTruthy/toBeFalsy/toBeNull) | 128 |
| 시간·난수 직접 호출 (ambient) | 203 |
| skip/todo | 3 |
| i18n 로케일 파일 | 12 |
| i18n 키 (ko 기준) | 2500 |
## 스위트별
| 스위트 | 파일 | 케이스 | 단정 | 약한 단정 | ambient |
|---|---:|---:|---:|---:|---:|
| 데스크톱 (Vitest) | 224 | 2135 | 5397 | 88 | 164 |
| packages/core (Vitest) | 39 | 568 | 1325 | 14 | 3 |
| packages/i18n (Vitest) | 2 | 10 | 31 | 0 | 0 |
| packages/ui (Vitest) | 2 | 7 | 30 | 0 | 0 |
| packages/api-client (Vitest) | 4 | 31 | 47 | 3 | 0 |
| 웹 (Vitest + Playwright) | 14 | 64 | 250 | 9 | 5 |
| 모바일 (Jest) | 106 | 535 | 1720 | 14 | 24 |
| Supabase Edge (Deno) | 45 | 270 | 647 | 0 | 7 |
| Cloudflare Worker (Deno) | 2 | 9 | 26 | 0 | 0 |
| API 서버 (xUnit) | 7 | 26 | 76 | 0 | 0 |
## 약한 단정 상위 파일
| 파일 | 개수 |
|---|---:|
| `packages/core/__tests__/keybinding.test.ts` | 10 |
| `apps/mobile-rn/__tests__/auth-privacy-boundary.test.tsx` | 9 |
| `apps/desktop/tests/main/services/input-telemetry-stale-snapshot.test.ts` | 8 |
| `apps/web/e2e/dashboard-dictionary-commands.spec.ts` | 7 |
| `apps/desktop/tests/unit/stt-model-download-redteam-r3-24.test.ts` | 6 |
| `apps/desktop/tests/main/sync/cloud-credentials-redteam-r3-1.test.ts` | 5 |
| `apps/desktop/tests/red/history.usecase.test.ts` | 5 |
| `apps/desktop/tests/red/ads/ads-mediation.test.ts` | 4 |
| `apps/desktop/tests/main/services/CustomInstructionService.test.ts` | 3 |
| `apps/desktop/tests/unit/AdMediationEngine.test.ts` | 3 |
| `packages/core/__tests__/typo-correction.test.ts` | 3 |
| `apps/desktop/tests/main/services/DictionaryService.test.ts` | 2 |
| `apps/desktop/tests/main/services/HistoryService.test.ts` | 2 |
| `apps/desktop/tests/main/services/KeyBindingService.test.ts` | 2 |
| `apps/desktop/tests/main/services/i18n-locale-parity.test.ts` | 2 |
## ambient 시간·난수 상위 파일
| 파일 | 개수 |
|---|---:|
| `apps/desktop/tests/main/services/suggestion-redteam-r1-1.test.ts` | 11 |
| `apps/desktop/tests/integration/cross-device-sync.supabase.test.ts` | 10 |
| `apps/desktop/tests/main/sync/SyncEngine.test.ts` | 10 |
| `apps/desktop/tests/red/crypto-license.usecase.test.ts` | 8 |
| `server/supabase/functions/_shared/admob-ssv.test.ts` | 7 |
| `apps/desktop/tests/main/services/input-flow-services.test.ts` | 6 |
| `apps/desktop/tests/main/services/modifier-state.test.ts` | 6 |
| `apps/desktop/tests/main/services/suggestion-redteam-r2-3.test.ts` | 6 |
| `apps/desktop/tests/main/services/suggestion-redteam-r3-1.test.ts` | 6 |
| `apps/desktop/tests/red/meeting-recording-redteam-r2-1.test.ts` | 6 |
| `apps/mobile-rn/__tests__/templates-memos.local.integration.mjs` | 6 |
| `apps/desktop/tests/main/services/input-telemetry-focus-flicker.test.ts` | 5 |
| `apps/mobile-rn/__tests__/admin-mobile.local.e2e.mjs` | 5 |
| `apps/desktop/tests/eval/suggestion-replay.eval.test.ts` | 4 |
| `apps/desktop/tests/main/services/KeyBindingService.test.ts` | 4 |