# REFACTOR WAVE 5 — 감사(AUDIT) 결과와 실행 계획 > 작성: 2026-11-05 · 상태: **감사 완료 / 실행 전** (소스 무변경) > 정책 정본: `docs/REFACTOR_POLICY.md`(DP1~DP11, W3-*, W4-*) 계승. 본 문서는 Wave 5의 **입력**이며, > 실행 후 `docs/REFACTOR_WAVE5_REPORT.md`로 결과를 남긴다. > 하네스: `.claude/skills/refactor-wave/SKILL.md` (R1~R8, P1~P12) --- ## 0. 기준선 (감사 시점에 실제로 돌린 게이트) | 게이트 | 결과 | 비고 | |---|---|---| | `npm run typecheck` (전 워크스페이스) | **GREEN** | desktop/web/admin/packages 전부 | | `npm run lint` | **GREEN** (`--max-warnings=0`) | desktop/web/admin/packages | | `npm run test:hygiene` | **GREEN** (400 test files) | `.only`/무근거 skip/항상참 단정/`waitForTimeout` 없음 | | `npm run contract:check` · `version:check` · `check:design` | **GREEN** | 드리프트 0 | | `any` · `console.log` · `TODO/FIXME` | **0건** | 표면 위생은 이미 포화 | **해석**: 표면 규칙(any/console/토큰/i18n 리터럴)은 Wave 1~4에서 소진됐다. Wave 5의 수확은 **계약 드리프트 · 테스트만 통과하는 코드 · 3회 이상 중복 · 게이트 공백**에 있다. 측정 재현(로컬 스크립트, `scratch/`는 gitignore): ```bash node scratch/dead-exports.mjs # 928 export 중 dead 43 / test-only 12 node scratch/dead-modules.mjs # app 레이어 미import 모듈 8 (엔트리 5 제외 → 2~3 실 후보) node scratch/dupe-audit.mjs # 앱 간 동명 함수 80쌍, 최장 함수(컴포넌트) 목록 node scratch/i18n-audit.mjs # 2753 키 × 12 로케일, 고아 후보 798 ``` --- ## 1. 발견 (판정: DELETE / REWIRE / REFACTOR / KEEP) ### P0 — 사용자 약속·보안 (문서가 주장하는데 코드에 호출자가 없음) | ID | 확신도 | 판정 | 근거 | 왜 지금 | |---|---|---|---|---| | **W5-01** | HIGH | **REWIRE**(불가 시 DELETE+주장 철회) | `packages/core/src/utils/pii-redactor.ts:1-3`("클라우드 전송 전 민감 데이터 자동 마스킹"), `packages/core/src/utils/secure-memory.ts`, 재export `packages/core/src/index.ts:18`. 프로덕션 호출 **0** — 유일 참조는 `apps/desktop/tests/red/pii-redactor.usecase.test.ts` (`grep -rn redactPII apps server` → 0) | 테스트는 "ZDR/마스킹 동작"을 초록으로 증명하는데 실제 전송 경로엔 배선이 없다. **컴플라이언스 주장과 코드가 불일치** | | **W5-02** | HIGH | **DELETE** | `packages/core/src/ipc-channels.ts:60-73`(TTS 채널 9개), `packages/core/src/types.ts:247-292`(TTS 타입 7개). preload에 TTS 네임스페이스 없음, `apps/desktop/src/main/ipc/`에 tts 핸들러 없음. 실제 재생은 `TTSPlaybackService`가 자체 표면으로 처리 | 죽은 IPC 계약이 SSOT에 남아 있으면 "이 채널로 붙이면 된다"는 오해를 만든다 | ### P1 — 계약 드리프트 (타입은 SSOT에 있는데 소비자가 안 씀) | ID | 확신도 | 판정 | 근거 | |---|---|---|---| | **W5-03** | HIGH | 채널 살아있음 → **REWIRE**, 채널 죽음 → **DELETE** | `packages/core/src/types.ts` 데드 27: `TTSSpeakParams`(270), `TTSSpeakResult`(276), `SetTTSVoiceParams`(280), `DownloadVoiceParams`, `TTSStatusChangedEvent`(288), `SpeakingStateChangedEvent`, `PullModelParams`(356), `LLMPullProgressEvent`(370), `HistoryExportParams`(744), `ShowRecordingTipParams`(825), `ShowResultPopupParams`(831), `TipMeasuredParams`(836), `TipStateChangedEvent`, `TipPrepareEvent`, `TipShowEvent`, `ActiveAppInfo`, `ShowNotificationParams`, `OpenExternalParams`, `InsertTextParams`, `InsertTextResult`, `StatsQueryParams`, `DailyStats`, `WeeklyStats`, `RAGChunk`, `MeetingGenerateDocResult`, `DiarizationResult`, `CreateSupportTicketParams` | 실행 규칙(P1 재검증): 각 타입마다 **채널/핸들러가 살아있는지** 먼저 grep한다. - 살아있음 → preload/handler가 코어 타입을 import하도록 **REWIRE**(SSOT 복구). 예: `text:insert`는 서비스 내부 호출로 남아 `InsertTextParams`가 사장 → DELETE. - 죽음 → 타입 삭제. `Statistics`/`RAG`/`support` 계열은 실제 IPC 표면 확인 후 결정. ### P2 — 데드 모듈·토큰 | ID | 확신도 | 판정 | 근거 | |---|---|---|---| | **W5-04** | HIGH | DELETE | `apps/desktop/src/renderer/components/ProBadge.tsx` (65줄, 자기 참조만) · `apps/admin/src/lib/supabase-server.ts` (web 사본과 동일 래퍼, import 0) | | **W5-09** | MED | DS 공개 API 여부 확인 후 DELETE | `packages/ui/src/theme.ts`: `d3roSpace`, `d3roWeight`, `d3roMotion`, `darkTheme`, `lightTheme`, `getModePalette` / `packages/ui-native/src/theme.ts`: `d3roNativeSpace`, `d3roNativeWeight`, `d3roNativeMotion`, `d3roNativeOverlayShadow`, `D3roNativePaletteKey` — 참조 0 | | **W5-10** | MED | REFACTOR | hex 폴백 10건: `packages/ui/src/components/ds/AudioVisualizerBar.tsx:26-33`, `GradientWave.tsx:30-38` — `#60a5fa/#3b82f6/#818cf8/#a78bfa`가 테마 값과 이중 정의(DP1 정신 위반) | `KEEP`(삭제 금지, 사유 명시): `apps/desktop/src/preload/popup.ts`(electron-vite entry) · `apps/*/src/proxy.ts`(Next 미들웨어) · `apps/admin/src/instrumentation.ts` · `*.d.ts` · `packages/core/src/constants.ts:WAVE_BAR`(외부 계약 아님, 화면 고유 수치 P4). ### P3 — 3회 이상 중복 (DP7 위반, 실측) | ID | 확신도 | 판정 | 중복 | |---|---|---|---| | **W5-05** | HIGH | REFACTOR → `packages/core/src/{guards,csv,format}.ts` | `isRecord` **27**정의 · `requireUuid` **14** · `requireUserId` **8** · `formatDuration` **9** · `escapeLikePattern` **3**(`apps/desktop/src/main/db/like-pattern.ts:12`, `apps/web/src/lib/dictionary-client.ts:109`, `apps/mobile-rn/src/features/dictionary/dictionary-service.ts:154` — 셋 다 동일 정규식) · `csvCell` **3** · `parseCsv`/`parseCsvRows`/`serializeDictionary`/`parseDictionaryFile` **3** | | **W5-06** | MED | REFACTOR → `packages/core/src/unified-search.ts` | 통합검색 랭킹·발췌 이중 구현: `apps/desktop/src/main/services/UnifiedSearchService.ts`(264줄) vs `apps/mobile-rn/src/features/search/unified-search-service.ts`(459줄) — `includesQuery`/`recordResult`/`meetingResult`/발췌 생성 동일 규칙, 데이터 접근만 다름 | | **W5-07** | MED | REFACTOR(역할 순서만 core로) | 권한 계층 2벌: `apps/admin/src/lib/admin-guard.ts`(71줄) vs `server/supabase/functions/_shared/admin-auth.ts`(74줄) — manager