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

@ -39,7 +39,7 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
| GAP-CI-04 | CI | Forgejo build validation과 root `build:all`이 web production build를 생략했고, migration checker도 CI quality gate에 연결되지 않았다. | `.forgejo/workflows/ci.yml`, `scripts/ci/build-all.mjs`, `scripts/ci/check-supabase-migrations.mjs` | `[x]` 2026-11-04: web production build를 두 경로에 추가하고 CI quality에서 `check:migrations:test` → `check:migrations`를 실행한다. CI 자체는 73개 파일의 naming/order/metadata 검사다. 같은 날 별도 격리 로컬 스택에서 empty/reset replay 73/73과 `pg-delta --strict-coverage` shadow diff 0을 확인했지만, 이 runtime gate는 아직 CI에 자동화되지 않았고 linked remote drift도 확인하지 않았다. |
| GAP-CI-01 | CI | macOS 빌드·서명 러너가 없다. `.github`의 build-mac·release-signing-ca는 실행된 적 없이 삭제됐다. | `.forgejo/workflows/*`, `.gitlab-ci.yml` | `[!]` EXT: Mac 호스트에 Forgejo runner(`macos` 라벨)를 붙이거나 GitLab `package-macos` 사용. 서명된 Android 릴리스는 GitLab `mobile-production-release`가 정본. |
| GAP-I18N-02 | Desktop | 녹음 캡슐의 "처리 중..."이 `recording-tip/index.html`에 한국어로 고정돼 앱 언어를 따르지 않는다. | `apps/desktop/src/renderer/popups/recording-tip/*`, `WindowManager.getPopupI18nStrings` | `[x]` 2026-09-28: 캡슐 문구는 main `_i18n`(popup.tip.*)으로, 오류는 `@d3ro/core/voice-error-message` 분류 → 사용자 언어 문구(bootstrap 이 error.code 를 넘기지 않던 버그 포함). 팝업 문서 lang 도 앱 언어. |
| GAP-I18N-03 | i18n | 12개 locale catalog의 키 정합성과 실제 제품 표면의 언어 선택 범위가 혼동돼 web/mobile이 12개 언어 완료로 표시됐다. | `packages/i18n/src/locales/*`, `apps/web`, `apps/mobile-rn`, `docs/v3/MOBILE_APP_COMPLETION_SSOT.md` O-012 | `[~]` 2026-11-04: 12개 catalog는 2,742키 parity가 있고 updater dialog도 모두 동기화됐다. 그러나 web에는 locale selector가 없고 mobile은 ko/en 표면만 제공한다. 각 표면의 selector·routing·전체 번역 런타임 검증 후 `SHELL-03` W/M을 `[x]`로 올릴 것. |
| GAP-I18N-03 | i18n | 12개 locale catalog의 키 정합성과 실제 제품 표면의 언어 선택 범위가 혼동돼 web/mobile이 12개 언어 완료로 표시됐다. | `packages/i18n/src/{locales/*,index.native.tsx}`, `scripts/ci/check-i18n-contract.mjs`, `apps/web/src/components/layout/locale-switcher.tsx`, `apps/mobile-rn/src/screens/{Onboarding,Settings,Account}Screen.tsx`, `apps/mobile-rn/android/app/build.gradle` | `[~]` **2026-11-13 코드·계약·단위 검증 완료:** 미참조 253개 고아 키를 정리해 **2,500키 × 12로케일** 정합성을 `check:i18n`·`sync-i18n-locales.mjs --check`·`locale-contract.test.ts`(15/15 PASS)로 고정하고, 웹 사이드바/셸에 12개 언어 `LocaleSwitcher`+`I18nProvider` 영속화(`locale-switcher.test.tsx` 3/3 PASS)를, 모바일 `index.native.tsx`(Metro `inlineRequires` 12개 로케일 로더)·온보딩/설정/계정 화면 12개 언어 선택기·Android 12개 `localeFilters`(`verify-mobile-build-config.mjs` 검증)를 모두 구현했다(`SHELL-03` W `[x]`, M은 실기기 비-한/영 로케일 화면 눈 확인 전까지 `[~]`). |
| GAP-UX-01 | Desktop | 회의 "내 메모"(상세 탭)는 이 기기 localStorage 에만 저장된다 — 기기 간 동기화되지 않는다. 끝난 회의에는 addMemo 가 거부된다(`MeetingModeService.ts:383`). | `components/meeting/meeting-notepad-storage.ts`, `MeetingModeService`, `MeetingNotesTab.tsx`, `tests/unit/desktop-ux-gaps.test.ts`, `tests/red/meeting.usecase.test.ts` | `[x]` 2026-10-30: `MeetingModeService.addMemo(content, meetingId?)`가 종료된 회의(`meetingId` 또는 `_finalizedSessionId`)에도 메모를 추가·저장하고 `CloudSyncService.pushOne('meeting_memos', memo.id)`로 기기 간 동기화하며, `MeetingNotesTab.tsx`가 `syncNotepadMemo`(`meeting-notepad-storage.ts`)로 내 메모를 동기화한다. 검증: `desktop-ux-gaps.test.ts` 13/13, `meeting.usecase.test.ts` 23/23 통과. |
| GAP-UX-02 | Desktop | 기록 조회에 모드·즐겨찾기 조건, 태그+검색 조합이 없어 화면이 불러온 페이지 위에서 거른다(조건이 까다로우면 여러 페이지를 불러와야 보인다). 오프셋 페이지라 사이 삽입·삭제 때 누락·중복 가능. 기록 제목·본문 편집 없음. 마크다운 내보내기는 태그 붙은 기록만·저장 위치 선택 불가. | `HistoryService`, `history-handlers.ts`, `MemoService.exportMarkdown`, `HistoryEntryCard.tsx`, `HistoryPage.tsx`, `tests/unit/records-view.test.ts`, `tests/red/memo.usecase.test.ts` | `[x]` 2026-10-30: `HistoryService.list`/`getAll`에 SQLite 직접 조건(`mode`, `isFavorite`, `tag`, `search`/`query`, `beforeCreatedAt` 커서 페이지네이션)을 추가하고, `HistoryService.update`(`history:update` IPC + `HistoryEntryCard` 인라인 편집 + 동기화 push)와 `MemoService.exportMarkdown`(무태그 기록 포함, 필터 연동, `savePath` 및 저장 대화상자 선택)을 구현했다. 검증: `records-view.test.ts` 21/21, `memo.usecase.test.ts` 15/15 통과. |
| GAP-UX-03 | Desktop | 회의 요약 항목 → 전사 구간 근거 링크 없음(요약·전사를 잇는 인용 데이터가 없다). | `MeetingSummaryService`, `MarkdownRenderer.tsx`, `MeetingSummaryTab.tsx`, `MeetingDetailTabs.tsx`, `TranscriptTab.tsx`, `EditableSegment.tsx`, `tests/unit/desktop-ux-gaps.test.ts` | `[x]` 2026-10-30: `MeetingSummaryService`가 요약·결정·액션아이템에 `[MM:SS]` 타임스탬프 근거 인용을 생성·파싱(`parseCitationTimestampMs`, `extractTranscriptCitations`)하고, `MarkdownRenderer`/`MeetingSummaryTab`에서 인용 배지 클릭 시 전사 탭의 해당 `EditableSegment`(`data-timestamp-ms`)로 이동·하이라이트한다. 검증: `desktop-ux-gaps.test.ts` 13/13 통과. |
@ -47,7 +47,7 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
| GAP-UX-05 | Desktop+Mobile | 기록+회의 통합 검색. 두 원본은 분리 유지하고 결과만 `source + id`로 상세 화면에 연결한다. | `@d3ro/core/types`, desktop `UnifiedSearchService`/`UnifiedSearchPage`, mobile `features/search`/`UnifiedSearchScreen` | `[~]` 2026-09-28 → **2026-10-30 코드·테스트 보강 완료:** 모바일 `unified-search-service.ts` 및 `UnifiedSearchScreen.tsx`에 `AbortSignal`/`AbortController` 요청 취소, `transcripts` 구간 테이블 검색(`searchTranscriptSegments`), 대용량 원문 상한(`boundPayloadText`)을 추가하고, 데스크톱 `UnifiedSearchService.ts`에도 `meetingMemos` 및 전사 구간 타임스탬프 스니펫 추출·인덱스 정렬을 추가했다(검증: 모바일 `unified-search-service.test.ts` 및 데스크톱 `UnifiedSearchService.test.ts` 12/12 통과). Electron `Ctrl+K` 실앱 수동 검증만 남아 `[~]` 유지. |
| GAP-UX-06 | Desktop | main 쪽 정리 필요: `STTManager.ts:53-129` 공급자 설명 한국어 하드코딩·마케팅 문구("100% 완전 오프라인", "Industry Benchmark") — 렌더러는 더 이상 쓰지 않는다 / audio TEST_DEVICE 가 deviceId 무시 / 사전 `incrementUsage` 호출처 없음(사용 횟수 항상 0) / 사전 발음 필드가 인식 힌트·치환에 쓰이지 않음 / 대화 세션 다시 듣기 IPC 없음 / preload `instruction.getAll` 이 `unknown[]` / 지식 추가 실패 판정이 문구 비교. | `STTManager.ts`, `ipc/audio-handlers.ts`, `DictionaryService.ts`, `VoiceModeService.ts`, `VoiceConversationService.ts`, `preload/index.ts`, `ipc/rag-handlers.ts`, `KnowledgeBasePage.tsx` | `[x]` 2026-10-30: 7개 항목 전수 해결 — (1) `STTManager.ts` 중립 기술 설명으로 교체, (2) `audio-handlers.ts` `TEST_DEVICE`가 `deviceId`·`durationMs` 전달, (3) `DictionaryService` 발음 힌트(`getPromptHints`) 및 발음→표제어 치환·`incrementUsage`(`applyDictionaryCorrections`)를 `VoiceModeService._transcribe`에 연결, (4) `voiceConversation:replayMessage` IPC + `VoiceConversationPage` 다시 듣기 버튼 추가, (5) `preload` `instruction.getAll` 타입 `CustomInstruction[]` 지정, (6) `rag-handlers.ts`·`KnowledgeBasePage.tsx` 구조화 에러(`details.cancelled` / `ErrorCode`) 판정으로 전환. 검증: `desktop-ux-gaps.test.ts` 13/13 통과. |
| GAP-UX-07 | Desktop | 2026-09-28 개편 문구는 ko·en 만 — 다른 8개 로케일은 en 폴백. 온보딩 Ollama 모델 크기 표기(`onboarding.llmModelSize` 9.6GB)와 안내 모달의 크기가 다르다. | `packages/i18n/src/locales/*`, `OllamaGuideModal.tsx`, `scripts/ci/sync-i18n-locales.mjs`, `tests/main/services/i18n-locale-parity.test.ts` | `[x]` 2026-10-30: `onboarding.llmModelSize`와 `OllamaGuideModal.tsx`의 기본 모델(`gemma4:e4b`) 크기 표기를 `4.0GB`로 통일하고, 12개 로케일 전체를 동기화했다. **2026-11-04:** updater dialog 16키를 추가해 현재 2,742키이며 `i18n-locale-parity.test.ts` 15/15가 이를 고정한다. |
| GAP-UX-08 | Mobile | **대화면(태블릿/폴더블 펼침) 레이아웃 대응이 없다.** 825dp 폭에서도 모든 화면이 한 열로 늘어난 휴대폰 레이아웃이고, `useWindowDimensions`/breakpoint/`numColumns` 사용처가 0건이다. More/Meetings/Commands/Templates 는 2열 그리드 후보, Dictionary Edit·Delete 와 Templates Select 는 화면 절반~전체 폭 버튼이 된다. 적응형 배너(`ANCHORED_ADAPTIVE_BANNER`, `minHeight: 50`)는 로드 후 728×90↔468×60 으로 높이가 변해 탭 바가 시프트한다(콘텐츠 가림은 스크롤로 회피 확인). | `apps/mobile-rn/src/navigation/TabNavigator.tsx`, `screens/*`, `packages/ui-native/src/theme.ts`, `docs/evidence/2026-11-05-tablet-layout-audit.md` | `[ ]` 2026-11-05 실기 감사 — **Tab S11 Ultra 1848×2960 @320dpi ≈ 924dp 가로** 및 Fold6 OPENED 825dp. 실측: 온보딩 본문·로그인 폼·Recorder 버튼이 2880px(900dp) full-width, More 라벨↔chevron 800dp, Home/Records 행 40..2920px. 다음 단계: `useContentWidth()`/`ContentColumn` 공용 컬럼 → 탭 화면 7곳 적용 → `≥600dp` 2열 그리드 → full-width 버튼 `maxWidth` 제한 → 배너 slot 높이 예약. 실기기 회귀는 Maestro `open`/`closed` 2회 실행으로. |
| GAP-UX-08 | Mobile | **대화면(태블릿/폴더블 펼침) 레이아웃 대응이 없다.** 825dp 폭에서도 모든 화면이 한 열로 늘어난 휴대폰 레이아웃이고, `useWindowDimensions`/breakpoint/`numColumns` 사용처가 0건이다. More/Meetings/Commands/Templates 는 2열 그리드 후보, Dictionary Edit·Delete 와 Templates Select 는 화면 절반~전체 폭 버튼이 된다. 적응형 배너(`ANCHORED_ADAPTIVE_BANNER`, `minHeight: 50`)는 로드 후 728×90↔468×60 으로 높이가 변해 탭 바가 시프트한다(콘텐츠 가림은 스크롤로 회피 확인). | `packages/ui-native/src/responsive.tsx`, `apps/mobile-rn/src/components/ads/FreeTierBanner.tsx`, `apps/mobile-rn/src/screens/*`, `apps/mobile-rn/__tests__/responsive-layout.test.tsx`, `docs/evidence/2026-11-05-tablet-layout-audit.md` | `[~]` **2026-11-13 코드·Jest 구현 완료:** `@d3ro/ui-native/responsive`(`resolveResponsiveLayout`, `useResponsiveLayout`, `useContentWidth`, `ContentColumn`)를 추가해 `>=600dp` 태블릿/폴더블에서 본문 폭 상한(`880dp`, 폼·온보딩 `520dp`), 2열 그리드(`More`/`Meetings`/`Commands`/`Templates`/`Records`), 인라인 액션 버튼 폭 제한(`Dictionary`/`Templates`), `FreeTierBanner` `90dp` 고정 슬롯 예약(레이아웃 시프트 방지)을 10개 주요 화면에 반영했다(`responsive-layout.test.tsx` 4/4 및 전체 모바일 Jest 89 suites / 605 tests PASS). 남은 게이트: 실기기 Fold6/Tab S11 `open`/`closed` Maestro 시각 확인. |
| GAP-TEAM-02 | Team | 브라우저에서 초대를 수락하는 경로가 없다. 웹 `accept-invite` 페이지는 발급 링크가 가리키지 않고 로그인 후 토큰을 읽는 곳이 없어 끊겨 있었으므로 삭제했다(사이트 `/accept-invite/`는 앱 딥링크만). | `apps/web/src/app/accept-invite/page.tsx`, `apps/web/src/app/(app)/team/page.tsx`, `site/public/accept-invite/` | `[x]` 2026-10-30: `/app/accept-invite?token=...` 웹 수락 페이지(비로그인 시 `/login?next=/app/accept-invite?token=...` 경유 후 `team-accept` Edge Function 호출 → `/app/team` 이동)와 랜딩 `/accept-invite/`의 `"웹 브라우저에서 수락하기"` 보조 CTA를 구현했다. 검증: `apps/web` typecheck 0 에러. |
| GAP-REL-10 | Release | `release-windows`(태그 파이프라인)는 서명 가드에 도달하기 **전에** sidecar 단계에서 죽는다. 이 러너 컨텍스트에서는 `sidecar:setup`이 Python 3.11+를 찾지 못한다(`Python 3.11+ 를 찾을 수 없습니다`) → `sidecar:build` → `verify-sidecar-bundle.mjs` 연쇄 실패(실측: run#65 `v1.3.7`, run#61 `v1.3.6`). 같은 러너의 portable 잡은 `py -3.11 → Python 3.11.9`를 찾아 사이드카 빌드에 성공하므로, 워크플로/컨테이너 간 PATH 차이다. | `.forgejo/workflows/release.yml`, `apps/desktop/scripts/setup-sidecar.mjs` | `[!]` 2026-09-19: 러너에 Python 3.11+(`py` 런처 포함)를 보장하거나 워크플로에 `actions/setup-python` 단계를 추가한다. 그 전까지 서명 게시는 불가능하다(GAP-REL-02와 별개 선행 차단). **2026-10-17 `[x]`**: 런타임이 설치본에서 분리돼 `release.yml` 은 더 이상 사이드카를 빌드하지 않는다(`build-desktop-installer.mjs`). |
| GAP-REL-11 | Release | portable 워크플로의 마지막 `actions/upload-artifact@v4` 단계가 Forgejo 러너에서 `GHESNotSupportedError`로 실패한다(증거 보존만 실패, 게시는 성공). | `.forgejo/workflows/portable.yml`, `scripts/ci/verify-release-metadata.mjs` | `[x]` 2026-10-30: `.forgejo/workflows/portable.yml`에서 미지원 `actions/upload-artifact@v4` 단계를 제거하고 `portable.json`·볼륨 SHA-256 요약 출력 단계로 대체했으며, `verify-release-metadata.mjs`에 회귀 방지 검증(`forgejo_portable_unsupported_upload_artifact`)을 추가했다 (`npm run release:metadata:test` 18 cases PASS). |
@ -66,7 +66,7 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
| GAP-MEM-01 | Knowledge | Web file upload was deferred and semantic search was mislabeled future. | `apps/web/src/components/knowledge/*` | `[x]` 2026-09-13: `.txt`/`.md` picker, newline-aware chunking, `embed-chunks` on submit, `search-knowledge` confirmed live. |
| GAP-MEM-02 | Dictionary | No dictionary import/export on any surface. | catalog MEM-07 | `[x]` 2026-09-13: desktop `dictionary:import/export` (JSON/CSV), web serialize/parse + download/upload, mobile via `data-portability`; 8 new unit tests. |
| GAP-MTG-01 | Meetings | Audio seek ↔ transcript timestamp sync missing. | `apps/mobile-rn/src/features/meetings/meetings-service.ts`, `MeetingDetailScreen.tsx`, `apps/web/src/components/meetings/{meeting-audio-player,live-transcript-list}.tsx`, `apps/mobile-rn/__tests__/meetings.test.ts` | `[x]` 2026-10-30: 모바일(`MeetingDetailScreen.tsx`)과 웹(`meeting-audio-player.tsx` ↔ `live-transcript-list.tsx`) 및 데스크톱(`TranscriptTab.tsx` / `EditableSegment.tsx`)에 `[MM:SS]` 구간 타임스탬프 파싱·오디오 시크 이동 및 재생 위치별 활성 전사 세그먼트 하이라이트를 구현했다 (`__tests__/meetings.test.ts` 통과). |
| GAP-MTG-02 | Meetings | Speaker diarization only partially done on desktop; absent web/mobile. | `docs/phases/phase-15.5-speaker-diarization.md`, SSOT H-014 | Finish desktop pyannote path; expose speaker labels cross-surface. |
| GAP-MTG-02 | Meetings | Speaker diarization only partially done on desktop; absent web/mobile. | `apps/desktop/sidecar/main.py` (`POST /diarize`), `MeetingModeService.ts`, `packages/core/src/meeting-transcript.ts`, `apps/desktop/src/renderer/components/meeting/{TranscriptTab,EditableSegment}.tsx`, `apps/web/src/components/meetings/live-transcript-list.tsx`, `apps/mobile-rn/src/screens/MeetingDetailScreen.tsx` | `[~]` **2026-11-13 전 표면 구현·테스트 완료:** 사이드카 `POST /diarize`(`pyannote.audio` 설치 시 자동 사용 + 무의존 에너지 VAD 화자 교대 분할 폴백, Python 30/30 PASS)를 `LocalSTTService.sidecarBaseUrl`로 `MeetingModeService._diarizeTranscript`(LLM 추정 폴백 및 `stripInventedMarkers({ allowSpeakerMarkers })` 포함)에 연결하고, `@d3ro/core/meeting-transcript` 화자 목록/필터 유틸과 화자 배지·다중 화자 필터 칩을 데스크톱·웹·모바일 상세 화면 전부에 구현했다(코어 13/13, 데스크톱·웹·모바일 테스트 전수 PASS; 실음성 다중 화자 데스크톱 GUI 확인 전까지 `[~]`). |
| GAP-MTG-03 | Meetings | Existing recordings could become plain transcription history, but not a meeting with linked audio and minutes. | desktop `MeetingModeService`, `meeting/imported-recording.ts`, `meeting-mode-handlers.ts`; mobile `MeetingsScreen` → `RecordScreen`; MTG-13 | `[~]` 2026-11-02: installed Windows 1.16.0 passed native picker→timestamped transcript→local summary/action item with a real WAV (`2026-11-02-verification.md`). Desktop GUI gate is complete; authenticated Android picker→upload→transcript→minutes on Fold6 remains. |
| GAP-MTG-04 | Meetings | Learned typing vocabulary never reached meeting transcription: STT used a hardcoded Korean hint, refine had no glossary, refined lines stopped inside `CaptionService`, and the stored transcript was raw segments. | `packages/core/src/transcript-correction.ts`, `apps/desktop/src/main/services/TranscriptGlossaryService.ts`, `CaptionService.ts`, `meeting/MeetingRecordingSession.ts`, `MeetingModeService.ts`, `FileTranscriptionService.ts`, `VoiceModeService.ts`; MTG-14 | `[~]` 2026-11-05: one glossary SSOT wired into caption, meeting, file transcription and dictation; refined lines now propagate to the meeting transcript and renderer (`meetingMode:segmentUpdated`). **Direct measurement against the real local database** (`users/_local/d3ro.db`: 1,952 learned phrases / 2,522 typing samples / 3 meeting transcripts) exposed that the first cut also rewrote ordinary Korean (286 of 3,005 words: 하면→라면, 이제→이게, 매일→메일, 정보→정도), and v1.16.3 restricts deterministic correction to dictionary pronunciations plus typed Latin identifiers — re-measured **0 of 3,005**. Real-engine check with the local sidecar (`large-v3-turbo`): a Korean TTS fixture containing the user term transcribes as 하람로그에 with no hint and haramlog에 with the learned hint; a dictionary pronunciation entry maps 디에로 → D3RO. Hangul-layout artifacts (dkssudgktpdy) are excluded from the hint. Evidence: `packages/core/__tests__/transcript-correction.test.ts` 16/16, `apps/desktop/tests/main/services/transcript-glossary.test.ts` 10/10, core 589/589, desktop offline suite, workspace typecheck, touched-file ESLint, `test:hygiene`. **Remaining:** a live meeting with real names/jargon by voice, and a packaged-install check of the new IPC event. |
| GAP-REL-16 | Release | Forgejo release-page asset attachment for the ~91 MB installer times out through Cloudflare (HTTP 524), although the package registry upload and the signed manifest succeed. | `scripts/ci/publish-forgejo-release.mjs`, `scripts/ci/lib/immutable-package-guard.mjs` | `[~]` 2026-11-06: reproduced on v1.16.2, v1.16.3 and v1.16.4. Each time the registry artifacts, `latest.yml`, `latest.yml.sig` and the public signed-manifest verification completed, so installed apps can update; only the human-facing release page has no attached binaries for those tags. To retry only this step, check out the tag detached (`git checkout v1.16.4`) before `npm run release -- --resume`; the resume path requires HEAD to equal the tag. |
@ -111,7 +111,7 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
| GAP-INPUT-04 | Input intelligence | **UIA 브리지가 Windows 전용이다.** `uiautomation` 은 Windows UI Automation 래퍼이므로 macOS 는 AX API, Linux 는 AT-SPI 구현이 따로 필요하다. 그래서 입력 인텔리전스는 카탈로그에서 데스크톱(`D`)만 표기하고 나머지 표면은 `[-]` 다. 또한 Chromium 138 미만 앱은 접근성 트리가 켜져 있으면 입력창 텍스트를 노출하지 않는데, 그 앱들을 `--force-renderer-accessibility` 로 켜도록 강제할 방법이 없다(우리 자신은 `app.setAccessibilitySupportEnabled(true)` 로 처리했다 — `bootstrap.ts`). | `apps/desktop/sidecar/uia_bridge.py`, `apps/desktop/src/main/bootstrap.ts`(`initInputIntelligence`) | macOS AX 경로를 붙일지 결정한다. 붙이지 않으면 카탈로그에서 macOS 를 명시적 N/A 로 유지한다. |
| GAP-INPUT-05 | Input intelligence | **수락/닫기 키가 사용자 습관과 충돌할 수 있다.** 기본값을 `Alt+Shift+←/↓/↑` 로 둔 이유는 Tab·Escape·Ctrl+Space 같은 관례 키를 뺏지 않기 위해서다(우리는 키를 삼키지 않으므로 원래 동작이 함께 실행된다). 그 대가는 "Tab 으로 수락" 같은 자연스러운 조작이 아니라는 점이고, 인라인 컴플리션 도구 대부분(Tab)과 다르다. | `packages/core/src/keybinding.ts`(`suggestion-accept`/`next`/`dismiss`), `apps/desktop/src/main/bootstrap.ts`(트리거 구독) | 오버레이가 보일 때만 Tab 을 삼키는 경로(전역 후킹에서 조건부 suppress)를 검토한다. 지금은 불가능하지 않지만 포커스 없는 창에서 키를 가로채는 설계가 필요하다. |
| GAP-LLM-03 | LLM | `[x]` **2026-09-22 코드 구현 완료.** 공유 `_abortController`를 요청별 controller로 대체하고 외부 signal을 각 요청에 연결/정리한다. generate/stream은 2048 tokens / 120 s, chat은 512 / 60 s로 제한하며, stream은 `done` frame 없이는 성공 처리하지 않고 불완전 응답을 정리한다. VoiceConversation은 single-flight와 request signal을 통해 local cancel을 실제 chat 취소로 전달한다. | `apps/desktop/src/main/services/LocalLLMService.ts`, `VoiceConversationService.ts` | 독립 표적 검증: 6 test files / 69 tests passed / 0 failed. 변경 코드·테스트 ESLint exit 0, `git diff --check` exit 0. 이는 전체 strict typecheck 또는 GUI 검증이 아니다. 앱 재시작 뒤 동시 제안·음성 요청의 요청별 취소와 `done` 누락 실패 처리는 GAP-LLM-04에서 계속 확인한다. |
| GAP-PERF-01 | Memory | `[~]` **2026-10-11 PC 전체 멈춤 = 누수가 아니라 모델 상주 정책.** HEAD 로컬 빌드 실측: 앱 기동 20초 만에 커밋 34.2→52.3 GB, 여유 RAM 7.9 GB→32 MB. 내역은 llama-server(gemma4:e4b) 11.4 GB(`CUDA_Host` pinned 5.9 GB + mmproj 1.1 GB, Ollama 가 Windows CUDA 에서 mmap 을 끈다), Whisper 사이드카(large-v3) 5.8 GB, Electron 8프로세스 약 400 MB(6분간 평탄). 실시간 자막의 보조 모델(large-v3-turbo)은 VRAM 11.8/12 GB 상태에서 로딩에 100.5 s 가 걸려 첫 전사가 타임아웃됐다. 부팅 워밍업·30m 상주는 9/22 에 한 번 제거됐다가 콜드 로딩 UX 때문에 되돌아온 이력이 있다(GAP-LLM-04, GAP-INPUT-06). | `services/llm/model-residency.ts`, `LocalLLMService.ts`, `SuggestionService.ts`, `bootstrap.ts`, `sidecar/main.py`(`/unload`), `LocalSTTService.releaseAuxModel`, `CaptionService.stop`, `VoiceModeService`(`tailAudio`), `VoiceConversationService`(5분 상한), `ipc/audio-handlers.ts`(세대 가드), `CloudSyncService.startRealtime`(단일 실행 + `removeChannel`), `MeetingModeService._saveWav` | 수정 완료(데스크톱 vitest 2545 passed): keep_alive 10m 단일화·부팅 워밍업 제거·종료 시 언로드·자막 종료 시 보조 STT 모델 언로드·부분 전사 끝부분만 복사·음성 대화 듣기 버퍼 5분 상한·마이크 테스트 재진입 고아 방지·Realtime 바인딩 중복 방지·회의 WAV 저장 concat 제거. **남은 일:** (1) 사이드카 재빌드 전까지 설치본 `sidecar.exe` 엔 `/unload` 가 없어 언로드가 HTTP 404 로 조용히 실패한다, (2) 기본 모델을 텍스트 전용 소형 모델로 바꾸거나 제안 전용으로 분리할지 결정(가장 큰 절감, 품질 확인 필요), (3) primary Whisper idle 언로드, (4) 회의 PCM 을 메모리 대신 디스크로 스트리밍(시간당 115 MB 상주), (5) 받아쓰기 녹음 길이 상한(UX 결정 필요), (6) 수정 후 앱 재시작·자막·타이핑 실측. |
| GAP-PERF-01 | Memory | `[~]` **2026-10-11 PC 전체 멈춤 = 누수가 아니라 모델 상주 정책.** HEAD 로컬 빌드 실측: 앱 기동 20초 만에 커밋 34.2→52.3 GB, 여유 RAM 7.9 GB→32 MB. 내역은 llama-server(gemma4:e4b) 11.4 GB(`CUDA_Host` pinned 5.9 GB + mmproj 1.1 GB, Ollama 가 Windows CUDA 에서 mmap 을 끈다), Whisper 사이드카(large-v3) 5.8 GB, Electron 8프로세스 약 400 MB(6분간 평탄). 실시간 자막의 보조 모델(large-v3-turbo)은 VRAM 11.8/12 GB 상태에서 로딩에 100.5 s 가 걸려 첫 전사가 타임아웃됐다. 부팅 워밍업·30m 상주는 9/22 에 한 번 제거됐다가 콜드 로딩 UX 때문에 되돌아온 이력이 있다(GAP-LLM-04, GAP-INPUT-06). | `services/llm/model-residency.ts`, `LocalLLMService.ts`, `SuggestionService.ts`, `bootstrap.ts`, `sidecar/main.py`(`/unload`), `LocalSTTService.{releaseAuxModel,releasePrimaryModel}`, `CaptionService.stop`, `VoiceModeService`(`tailAudio`), `VoiceConversationService`(5분 상한), `ipc/audio-handlers.ts`(세대 가드), `CloudSyncService.startRealtime`(단일 실행 + `removeChannel`), `services/meeting/disk-wav-audio-sink.ts` | 수정 완료(데스크톱 vitest 2,825 passed): keep_alive 10m 단일화·부팅 워밍업 제거·종료 시 언로드·자막 종료 시 보조 STT 모델 언로드·부분 전사 끝부분만 복사·음성 대화 듣기 버퍼 5분 상한·마이크 테스트 재진입 고아 방지·Realtime 바인딩 중복 방지·**2026-11-13 추가 해결:** (3) 클라우드 전환·15분 유휴 시 주 Whisper 모델 언로드(`LocalSTTService.releasePrimaryModel`, `slot:"primary"`), (4) 회의 녹음 PCM을 메모리 누적 없이 44바이트 WAV 헤더 스풀로 디스크 직접 스트리밍(`DiskWavAudioSink`, `O(1)` RAM, `disk-wav-audio-sink.test.ts` 3/3 PASS). **남은 일:** (1) 기본 로컬 LLM을 소형 모델로 분리할지 제품/품질 결정, (2) 받아쓰기 녹음 길이 상한 UX 결정, (3) 수정 후 실앱 재시작·장시간 회의 메모리 실측. |
| GAP-LLM-04 | LLM | `[~]` **Gemma/Ollama residency·burst·unbounded chat root cause (2026-09-22).** 19:14:12 boot warmup의 `keep_alive: 30m`가 `gemma4:e4b`를 expiry 19:44:12까지 VRAM 3,226,342,521 bytes / context 4096으로 상주시켰다. Windows GPU Engine PID 표본에는 활성 Ollama compute가 없어 무한 추론이 아니라 강제 residency였다. 19:11:17–19:11:58 자동 제안 반복은 기존 900 ms / 12 per min / 5 candidates / 128 tokens / 1-char growth가 허용한 burst였다. 위험 경로는 chat의 무제한 `num_predict`(Ollama 기본 `-1`), timeout·외부 abort 부재, 공유 취소, `done` 없는 EOF 성공, voice cancel 미전파, watchdog의 비취소였다. | `apps/desktop/src/main/services/{LocalLLMService,SuggestionService,VoiceConversationService}.ts`, Ollama `/api/ps` and Windows GPU Engine observations | 구현 계약: boot warmup 제거, suggestion `keep_alive: 2m`; 600 ms debounce / 5 s interval / 6 per min (hard max 12) / 3 candidates / 64 tokens / 12-char growth / 8 s timeout; 요청별 cancellation, bounded requests, done/cleanup, voice single-flight, spawn/poll dedupe와 dispose. Raw Ollama 증거: cold bounded 요청은 client hard timeout 15.044 s에 취소된 뒤 `/api/ps` empty와 `/api/version` 80 ms 회복을 보였고, explicit warmup HTTP 200은 16.639 s, 후속 `num_predict=1` / `keep_alive='2m'` 요청은 553 ms HTTP 200 / `done:true` / `eval_count:1` / `response=OK` / `done_reason:length`였으며 `/api/ps` expiry는 약 119.9 s였다. 이어 19:48:59 +09:00에는 새 generate/unload/kill/retry 없이 충분히 지난 뒤 단일 `/api/ps`가 HTTP 200 / 45.8 ms / `{models:[]}`였고 `/api/version`은 HTTP 200 / 7.3 ms / `0.32.13`이었다. 이는 raw API 수준의 expiry 뒤 unload 확인이다. **남은 조건:** 앱 재시작·GUI·실제 자동제안 타이핑 증거는 아니므로 그 경로에서 rate limit, timeout/cancel, 2분 residency를 확인한다. |
| GAP-INPUT-06 | Input intelligence | `[~]` **제안 폭주 상한 및 runtime 확인.** 이전 24.7 s / 4.9 s, boot warmup, `keep_alive: 30m`, 48/96/128 tokens 및 2/5 candidates 기록은 역사적 가설/완화 이력이며 현재 정책이 아니다. 현 정책은 600 ms debounce, 5 s minimum interval, 6 requests/min default (hard max 12), 3 candidates, 64 output tokens, 12-character growth, 8 s timeout, `keep_alive: 2m` 및 boot warmup 제거다. | `apps/desktop/src/main/services/SuggestionService.ts`, `packages/core/src/input-intelligence.ts`, `LocalLLMService.ts` | 표적 자동 검증은 6 files / 69 passed / 0 failed이며 raw Ollama의 15.044 s cold timeout cleanup, 약 119.9 s residency expiry, 그리고 19:48:59 +09:00에 새 generate/unload/kill/retry 없이 확인한 `/api/ps` HTTP 200 / 45.8 ms / `{models:[]}` (`/api/version` HTTP 200 / 7.3 ms / `0.32.13`)도 확인됐다. 전체 strict typecheck는 green이 아니며, 이 raw API unload 증거는 앱 재시작·GUI·실제 자동제안 타이핑 검증이 아니다. 그 경로에서 rate limit, 8 s abort, 3-candidate/64-token 상한을 확인한다. |
| GAP-INPUT-08 | Input intelligence | `[x]` **오타 자동 교정(INPUT-19) 일반 앱(8/8) + 터미널·Vim(6/6) 실앱 E2E 검증 및 xterm.js(`Agent Switchboard`) 재교정 루프 수정 완료 (2026-10-27); 문맥 제안(INPUT-20)은 GAP-INPUT-09 에서 추적.** 2026-10-26 에 `packages/core/src/araso-layout.ts` 및 `typo-correction.ts` 로 한영 혼합어(`githubdp`→`github에`, `PDFvkdlf`→`PDF파일`, `ㅖㅇㄹ파일`→`PDF파일`, `Reactzjavhsjsxm`→`React컴포넌트`), 쌍자음 잔여 Shift(`djEJs`→`어떤`, `qkRNjTdj`→`바꿨어`), 한→영 역변환(`ㅎ샤ㅗㅕㅠ에`→`github에`, `ㅑㄹ ㅑ 쇼ㅔㄷ ㅗ디ㅣㅐ 소두 ㅑㅅ 초뭏ㄷㄴ ㅑㅜ 10 ㄴㄷ채ㅜㅇㄴ`→`if I type hello then it changes in 10 seconds`), 문장 문맥 한영 전환(`Stay hungry, stay foolishsms wkqtmdml akfdlek.`), URL/경로 보호를 추가하고, 통계 수집 동의(`inputTelemetryEnabled`) 없이도 기본 기능으로 동작하도록 배선했다. 이어서 실제 Windows 인터랙티브 데스크톱(`WinSta0\Default`)에서 WinForms 테스트 창(`E2ETestBox.exe`)과 실행 중인 `D3RO Voice` 로 실제 `SendInput` 키 입력 E2E 를 수행해 4가지 실환경 결함을 잡고 검증했다: (1) `.bat` 래퍼(`cmd.exe` CUI)로 띄울 때 `uiohook` 이 인터랙티브 키 이벤트를 받지 못하던 문제를 `electron.exe` GUI 직접 실행으로 해결, (2) `_watchRevert` 가 새 문장에서 같은 오타(`ㅗ디ㅣㅐ`)를 다시 쳤을 때 되돌림으로 오인해 `typoIgnoredWords` 에 영구 등록하던 결함을 `prefixBefore`/`windowHandle`/낱자 차단으로 해결, (3) 한글 IME 상태에서 `ㅖㅇㄹ파일`(Shift+PDF + 파일) 입력 시 `PDF파일` 변환 추가, (4) `Ctrl+V` 클립보드 붙여넣기가 Windows `ClipboardSvcGroup`(`WM_CLIPBOARDUPDATE`)의 `OpenClipboard` 잠금과 충돌해 간헐적으로 누락되던 결함을 `SendInput(KEYEVENTF_UNICODE)` 직접 유니코드 타이핑(`apps/desktop/src/main/utils/win32-unicode-input.ts`)으로 해결. **2026-10-27 터미널·Vim·xterm.js 지원 확장 및 라이브 E2E 검증:** (5) Windows Terminal 등 모든 터미널·개발 표면에서 일반 철자/모델 교정만 막고 한영 자판 전환(`layoutOnly: true`)은 허용, (6) `uia_bridge.py` 가 터미널 스크롤백 상단 대신 `GetVisibleRanges()` 하단 뷰포트를 읽고 `ExpandToEnclosingUnit(waitTime=0)` 으로 500ms 지연을 제거, (7) `TerminalKeystrokeTracker` + `extractTerminalActiveContext` + `isForegroundKoreanIme` 로 다중 줄 Vim 버퍼(`-- INSERT --` 상단 줄 편집)·캔버스 터미널(`len=0`)·Vim 노멀 모드 교정 차단·명령줄 모드(`:ㅈㅂ`→`:wq`, `:ㅂ!`→`:q!`)·입력 모드 진입 키(`i/a/o/s`) 분리를 구현, (8) `Agent Switchboard` 등의 xterm.js `<textarea class="xterm-helper-textarea">` 가 Enter/Ctrl+C 전까지 `.value` 를 비우지 않아 `ㅗ디ㅣㅐ재깅 `→`hello재깅 ` 교정 시 400ms 마다 `'h'` 가 누적되던 문제를 `isXtermHelperControl` + `reconcileWithXtermValue` + `재깅`→`world` + 교정 성공 후 `_lastCheckedRegion` 보존 + 프로그램 키 `_lastKeyAt` 미갱신으로 해결, (9) 채팅창 Enter 전송 직후 툴바 문구(`"탭 추가 @ 기호"`)에 제안이 뜨고 `gemma4:e4b` 가 프롬프트 지시문(`"검색어입니다."`, `"키워드 몇 개로만 짧게 이어 쓰세요."`)을 되풀이하던 문제를 `clearedByEnter` 기준선 재설정 + `INSTRUCTION_ECHO_PATTERN` 확장으로 해결. | `apps/desktop/src/main/services/{TypoCorrectionService,TextInsertService,InputTelemetryService}.ts`, `apps/desktop/src/main/utils/{win32-unicode-input,win32-foreground}.ts`, `apps/desktop/sidecar/uia_bridge.py`, `packages/core/src/{araso-layout,typo-correction,terminal-prompt,suggestion-text}.ts` | `[x]` 2026-10-26 일반 앱 GUI E2E(`E2ETestBox.exe`, 8/8 시나리오 전수 통과, 91~509ms) + **2026-10-27 터미널·Vim GUI E2E(`neovide.exe` PID + `D3RO Voice` PID 90844, 6/6 시나리오 전수 통과):** Vim INSERT 모드 `dkssudgktpdy `→`안녕하세요 `(197ms), Vim 명령줄 `:ㅈㅂ`→`:wq`(215ms, `:` 보존), Vim 명령줄 `:ㅂ!`→`:q!`(90ms), 셸 프롬프트 `PS D:\workspace> 퍄ㅡ `→`vim `(106ms), 셸 프롬프트 `PS D:\workspace> ㅎ샤 채ㅜㄴㅅ `→`git const `(170ms), 캔버스 터미널(`UIA len=0`) `<Esc>idkssudgktpdy `→`안녕하세요 `(108ms). 단위 테스트: `packages/core` 3개 파일 82/82 통과(`typo-correction.test.ts` 44/44, `terminal-prompt.test.ts` 12/12, `suggestion-continuation.test.ts` 26/26), 데스크톱 `TypoCorrectionService.test.ts` 22/22 통과. |
@ -126,7 +126,7 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
| GAP-SYNC-05 | Sync | **Not yet in production.** Migration `20260927000034` is applied only to the local stack; the rewritten desktop sync ships with the next desktop release. Until the migration is deployed, desktop tombstone pulls and template RPCs fail against production (they are isolated per step, other entities keep syncing). | migration file, `apps/desktop/src/main/services/sync/` | `[~]` 2026-09-27: production `supabase db push` applied `0029`–`0035` (backup dump taken first; see GAP-OPS-01), all 23 Edge Functions redeployed, v1.7.0 published (runtime/portable first, then the updater feed) and installed on the owner PC. **Remaining:** the desktop on that PC is in local mode — one Google sign-in in Settings > Cloud, then edit/delete on the phone and confirm the desktop updates within seconds and appears under Devices. |
| GAP-SYNC-06 | Sync | Still desktop-local (not mirrored): knowledge base (desktop local RAG embeddings vs cloud pgvector — different embedding spaces), audio (desktop WAV files vs mobile Storage uploads), `user_settings` (locale, auto-polish, active command), desktop preset-command prompt edits, meeting `transcripts` segments (desktop uses `raw_transcript`, which mobile also fills). | `docs/map/10-feature-catalog.md` MEM-09/MEM-05/SHELL rows | `[x]` 2026-09-27: knowledge docs sync as source text and are re-embedded per surface; recordings upload to the mobile storage contract (≤50 MiB per file, opt-out toggle) and remote recordings play through signed URLs; `user_settings` maps the shared fields. 2026-09-27 (later): the two items first left out are done too — meeting `transcripts` segments are rebuilt from the desktop transcript (the phone renders segments before `edited_transcript`, so desktop edits were invisible there) and preset prompt edits reach the phone through `sync_set_builtin_instruction_prompt_v1` (migration `0036`, production applied; `tests/main/sync/SyncTranscriptsPresets.test.ts` (4) + local-stack integration case "전사 구간·프리셋"). Evidence: `tests/main/sync/SyncExtensions.test.ts` (9) + integration case "지식 문서·설정·녹음" against the local Supabase stack. |
| GAP-SYNC-07 | Sync | `sync_tombstones` grows without a schedule. `prune_sync_tombstones_v1(interval)` (service_role) exists; nothing calls it. | migration §1 | `[x]` 2026-09-27: migration `0035` enables `pg_cron` and schedules `prune-sync-tombstones` daily at 03:17 UTC (production `cron.job` active=true). A client whose cursor is older than 180 days must fall back to a full resync. |
| GAP-SYNC-08 | Sync | Meeting memo conflict detection compares mutable content plus timestamp/creation fields instead of an immutable revision. An A→B→A edit can return to the same compared values and evade stale-client detection; the shared `MeetingMemo` type has no `updated_at` or revision field. | `packages/api-client/src/types.ts` `MeetingMemo`, `apps/mobile-rn/src/features/meetings/meetings-service.ts` `updateMeetingMemoConflictSafe`/`deleteMeetingMemoConflictSafe` | `[ ]` Add a DB revision (preferred) or reliable `updated_at` CAS contract, regenerate shared types, and prove concurrent update/delete plus A→B→A against a local Supabase stack before changing the completion status. |
| GAP-SYNC-08 | Sync | Meeting memo conflict detection compares mutable content plus timestamp/creation fields instead of an immutable revision. An A→B→A edit can return to the same compared values and evade stale-client detection; the shared `MeetingMemo` type has no `updated_at` or revision field. | `server/supabase/migrations/20261113000001_meeting_memos_revision_cas.sql`, `packages/api-client/src/types.ts` `MeetingMemo`, `apps/mobile-rn/src/features/meetings/meetings-service.ts`, `apps/desktop/src/main/{db/schema.ts,services/sync/sync-adapters.ts}` | `[~]` **2026-11-13 마이그레이션·클라이언트·단위 검증 완료:** 74번째 마이그레이션 `20261113000001_meeting_memos_revision_cas.sql`로 `meeting_memos.revision integer not null default 1 check (revision >= 1)` 및 단조 증가 트리거 `bump_meeting_memo_revision`을 추가하고, `@d3ro/api-client`, 모바일 `updateMeetingMemoConflictSafe`/`deleteMeetingMemoConflictSafe`(단조 `revision` 우선 CAS로 `A→B→A` 회피 차단, 구 스키마 폴백 유지), 데스크톱 SQLite `meeting_memos.revision`·`sync-adapters.ts`를 모두 갱신했다(`check:migrations` 74개 GREEN, 모바일 `meetings.test.ts` 18/18·데스크톱 `SyncEngine.test.ts` 20/20 PASS). 남은 단계: 운영 DB `supabase db push` 반영. |
| GAP-OPS-01 | Ops | **Production Supabase was five migrations behind** (`0029` content reporting, `0030` profile column ACL — users could raise their own `role`/`tier` through PostgREST, `0031` audit-log actor unlink, `0032` meeting-document reporting, `0033` team activity feed) and `content-report` was never deployed, while the map listed those features GREEN from local runs. Most functions still ran the 2026-08-21 build. | `server/supabase/migrations/`, `scripts/ci/check-supabase-migrations.mjs` | `[x]` 2026-09-27: schema+data dump taken, `db push` applied `0029`–`0035`, all functions redeployed (unauthenticated calls return 401, i.e. live and gated); `authenticated` can no longer UPDATE `profiles.tier`; real-account export returns exactly the v1 keys. **2026-11-04 boundary:** file checker는 73개 파일의 self-test/order/name/duplicate/non-empty만 다룬다. 별도 격리 로컬 stack의 empty/reset replay와 `pg-delta` shadow diff는 통과했지만 linked remote migration state/drift는 재검증하지 않았다. |
| GAP-STT-01 | Cloud STT | A 5 s phone recording took ~66 s and ended on the phone's tiny local model (2026-09-27). Chain: the gateway's first endpoint (laptop GPU 192.168.0.227) is off (3 s), the NAS CPU Whisper (2 cores, load ~7) needs 30–90 s for 3 s of audio, and `stt-proxy` waited up to 60 s for the gateway. The direct OpenAI fallback **never worked**: the production `OPENAI_API_KEY` secret is not a valid header value (invisible/non-ASCII characters — `TypeError: headers … not a valid ByteString`), and whisper-1 `verbose_json` reports the language by name, which the result contract rejected. The same key backs `embed-chunks`, `search-knowledge` and `realtime-token`. | `server/supabase/functions/{stt-proxy,_shared/stt-contract.ts,_shared/provider-key.ts}` | `[!]` 2026-09-27 code fixed and deployed: gateway wait = 5 s + clip length (max 30 s) when a direct provider exists, provider language names mapped to codes, keys stripped of BOM/zero-width characters (still-invalid keys count as not configured), fail-closed responses list per-provider failures (`attempts`). **External:** re-enter a valid `OPENAI_API_KEY` (or add `GROQ_API_KEY`) in Supabase function secrets, or keep the GPU endpoint online; until then cloud STT runs on the NAS CPU (~30 s for a short clip). |
@ -143,7 +143,7 @@ These are the mobile SSOT rows still `[ ]` / `[~]`. Do not duplicate the full te
| O (onboarding/a11y) | O-002..O-007, O-009, O-011; O-001 `[~]`, O-008/O-010/O-012 `[~]` | O-001 2026-11-01: `.2` Fold6 fresh auth/signup/small-screen PASS; latest `.3` fresh-auth/retry FAILED (onboarding visibility), 회귀 테스트 추가(`apps/mobile-rn/.maestro-output/fold6-20261101-fix1/`). 2026-11-04 current-source E2E upgrade/launch, inspected-route UIA labels/48dp, and AVD font-scale 2.0 + rotation/scroll passed. Remaining: permission journeys/tutorial, app-wide theme/a11y, manual TalkBack/focus order and SDK AdMob descendant, iOS, full-app ko/en audit ([evidence](../evidence/2026-11-04-mobile-runtime-a11y.md)) |
| D (data/sync/offline) | D-001..D-014 | Schema/RLS, devices, cross-surface read/write, offline queue, conflict policy |
| R (record/transcribe) | R-001..R-009, R-011..R-015, R-017..R-020; R-016 `[x]` | Permissions, recorder, FGS, upload queue, job state, sharing |
| H (history/meetings) | H-001..H-005, H-007..H-010, H-012..H-015; H-006/H-011/H-016 `[x]` | Pagination, filters, detail, meeting timeline/docs/diarization/cross-app |
| H (history/meetings) | H-001..H-005, H-007..H-010, H-012, H-013, H-015; H-014/H-017 `[~]`; H-006/H-011/H-016 `[x]` | Pagination, filters, detail, meeting timeline/docs/speaker filter chips (`H-014` `[~]`)/cross-app |
| F (feature parity) | F-003..F-010, F-013, F-014; F-001 `[~]`; F-002/F-011/F-012 `[x]` | Mobile Home dashboard subset, commands/actions/chat/conversation/knowledge |
| T (teams/admin/notify) | T-001..T-005, T-009..T-012; T-006..T-008, T-013 `[x]` | Team CRUD/roles, push delivery/deep links, notification settings |
| M (monetization) | M-025, M-027; M-013 `[~]` | Play Billing license test, Payple webhook signature |
@ -282,6 +282,30 @@ Evidence: [2026-11-02 verification](../evidence/2026-11-02-verification.md).
- `[x]` **GAP-QA-04 (신규·해결): 죽은 IPC/TTS 계약이 SSOT에 남아 있었다.** `IPC_CHANNELS.TTS` 블록(9) · WINDOW tip/show 5 · SYSTEM 4 · HISTORY.EXPORT · STATS 2 · RAG.QUERY_RESULT · SUPPORT.GET_TICKETS · POPUP_SUGGESTION.ACCEPTED 등 **20개 채널**과 그에 묶인 타입 27종이 어디에서도 참조되지 않았다. 삭제 + 살아있는 채널의 인라인 페이로드를 코어 타입으로 재배선(`PullModelParams`의 `modelName`→`modelId` 드리프트, `OpenExternalParams`, `RecordingTipState`/`TipStateChangedEvent`, `'done'` 상태 누락). 근거: `docs/REFACTOR_WAVE5_AUDIT.md` W5-02/W5-03. 검증: 모노레포 typecheck/lint/test + 모바일 typecheck/lint/test + contract:check GREEN. 커밋 `f95bc9c`.
- `[x]` **GAP-QA-05 (신규·해결): DS 데드 export·중복 hex·미사용 모듈.** `packages/ui`·`ui-native`의 토큰 export 11개(참조 0), `ProBadge.tsx`, `apps/admin/src/lib/supabase-server.ts` 삭제. 파형 컴포넌트의 하드코딩 hex 폴백을 `theme-raw` 값으로 통일. 커밋 `b8b9190`.
- `[~]` **GAP-QA-06 (신규·진행): 보호 수용 여정이 CI에서 실행되지 않는다.** Phase 1로 "약화·삭제·skip"은 `npm run check:protected-tests`가 막지만, 데스크톱 E2E 자체는 X 디스플레이가 없어 여전히 릴리스 전 수동이다. 다음 단계: Phase 5 — `release.yml` 태그 잡에 Windows 러너 E2E + 설치 산출물 스모크 추가.
- `[x]` **GAP-QA-07 (신규·해결): 테스트 품질 회귀를 막을 게이트가 없었다.** `npm run test:quality`(래칫, 기준선 `scripts/ci/test-quality-baseline.json`: 약한 단정 128 / ambient 시계·난수 203)와 `npm run test:metrics`(지표, `docs/tdd-red/metrics/2026-11-08.md`)를 추가하고 `verify:all`·CI `quality`에 배선. 커밋 `42583cc`·`d3d6f34`.
- `[ ]` **잔여(다음 wave):** Wave 5 G3(PII/ZDR 배선 여부 — 프로덕션 호출자 0), G4(`isRecord` 27 · `requireUuid` 14 · `formatDuration` 9 등 앱 간 중복 → `@d3ro/core` 추출), G5(i18n sync 스크립트의 번역값 하드코딩 + 고아 키 798), G6(`site/`가 npm workspace 밖이라 루트 정적 게이트 대상 아님), G7(대형 컴포넌트 순수 이동). TDD Phase 2~5(i18n·DS 계약, 영향 선택 실행, 증분 뮤테이션, 릴리스 E2E).
- `[~]` **GAP-QA-06 (신규·진행 → 2026-11-13 CI 스모크 편입):** Phase 1로 "약화·삭제·skip"은 `npm run check:protected-tests`가 막고, **2026-11-13(Phase 5)** `scripts/ci/verify-desktop-installer-smoke.mjs`(`npm run release:installer:smoke[:test]`)를 `release-desktop.mjs`·`.forgejo/workflows/release.yml`에 배선해 설치 산출물(NSIS `.exe`, `.blockmap`, `latest.yml`, Ed25519 `.sig`, `resources/app.asar`, 렌더러 HTML/에셋, 네이티브 ABI) 무결성을 태그 릴리스에서 자동 검증하며 `.forgejo/workflows/ci.yml`에서 `site` 프로덕션 빌드까지 강제한다. Linux CI 러너에는 X/Windows GUI 세션이 없어 대화형 Electron Playwright 수용 여정(`test:acceptance:desktop`)만 로컬/Windows 릴리스 전 실행으로 유지한다.
- `[x]` **GAP-QA-07 (신규·해결): 테스트 품질 회귀를 막을 게이트가 없었다.** `npm run test:quality`(래칫, 기준선 `scripts/ci/test-quality-baseline.json`: 약한 단정 128 / ambient 시계·난수 203)와 `npm run test:metrics`(지표, `docs/tdd-red/metrics/2026-11-08.md` → `2026-11-13.md`)를 추가하고 `verify:all`·CI `quality`에 배선. 커밋 `42583cc`·`d3d6f34`.
- `[x]` **잔여 Wave 5 G3~G7 + TDD Phase 2~5 해결 (2026-11-13):** 아래 `2026-11-13` 섹션 및 [`docs/REFACTOR_WAVE5_REPORT.md`](../REFACTOR_WAVE5_REPORT.md) 참조.
## 2026-11-13 — 전 표면 최적화 · 소스 위생 · 잔여 백로그 전수 해소 (Waves 0–12)
- `[x]` **GAP-PERF-02 (신규·해결): 데스크톱/모바일/웹 초기 번들 비대화 및 `@d3ro/i18n` 12개 로케일 정적 번들링.** `@d3ro/i18n`을 동적 로케일 청크(`index.tsx`), 무-React 동기 로더(`@d3ro/i18n/main`), 모바일 12개국어 Metro `inlineRequires` 엔트리(`index.native.tsx`)로 분리하고, 데스크톱 `AppLayout.tsx`(7페이지·6모달 `React.lazy`), 모바일 `App.tsx`(`getComponent` + Metro `inlineRequires`), 웹 `MarkdownPreview`(`next/dynamic` + 다이어그램 존재 시에만 `mermaid` 로드) 코드 스플리팅을 적용했다. 실측 결과 데스크톱 초기 부팅 JS는 `8.79 MB`(`main 4,191.7 KB` + `renderer 4,596.8 KB`) → `3.63 MB`(`main 2,085.7 KB` + `renderer 1,549.3 KB`, `-58.6%`)로 감소했다.
- `[x]` **GAP-PERF-03 (신규·해결): 데스크톱 SQLite 쿼리 병목·부팅 프로세스/훅 오버헤드.** (1) SQLite WAL 성능 PRAGMA(`synchronous=NORMAL`, `mmap_size=64MB`, `cache_size=-16000`) 적용, (2) `UnifiedSearchService` FTS5 trigram 전문 검색(`history_fts`/`meeting_sessions_fts`/`meeting_memos_fts` + 동기화 트리거), (3) `SqliteChunkStore` `Float32Array` 바이너리 `embedding_blob` + DB 스코프 `WeakMap` 캐시(검색 시 `JSON.parse` 0회), (4) `PersonalGraphService` 단일 트랜잭션 일괄 처리, (5) Windows `koffi` `SendInput` 일원화(`NutKeyboardPort`·`ScreenContextService`, Windows `asarUnpack`에서 `@nut-tree-fork` 제외 및 5초 `nut-js` 타이머 제거), (6) `InputTelemetryService` 기본 모드 1,000Hz `mousemove`/`wheel` 훅 차단, (7) 부팅 시 4개 백그라운드 팝업 선생성(`preloadPopupWindows`) 제거 → 지연 생성, (8) `LocalSTTService` 클라우드 전환·15분 유휴 시 주 Whisper 모델 메모리 회수(`POST /unload` `slot:"primary"`, UIA 서버 유지), (9) `DiskWavAudioSink`로 장시간 회의 녹음 PCM 디스크 직접 스트리밍(`O(1)` RAM). 증거: `sqlite-optimizations.test.ts` (4/4), `runtime-hygiene-optimizations.test.ts` (2/2), `disk-wav-audio-sink.test.ts` (3/3).
- `[x]` **GAP-HYGIENE-01 (신규·해결): 패키징·의존성·스크립트·레거시 라우트 오염.** 루트 중복 `resources/sox/`(5.21 MB) 및 `apps/desktop/resources/sox/` 불필요 파일 10종 제거 + `electron-builder.yml` 필터 적용, 데스크톱 미구현 광고 어댑터 9종 단일화(`UNAVAILABLE_AD_NETWORK_SPECS`), `scripts/local/` 109개 및 루트 미참조 스크립트 16개 삭제 + `npm run clean:deep`(`scripts/ci/clean-deep.mjs`), `apps/mobile-rn` 루트 순환 의존성(`d3ro-voice-monorepo`)·NTFS 정션 제거, Android 릴리스 R8(`enableProguardInReleaseBuilds=true`) + `shrinkResources` + 12개 로케일 `localeFilters` 적용(`verify-mobile-build-config.mjs` 게이트 고정), `.NET` `SttController` 무호출 중복 라우트(`GET /providers`, `POST /test`) 제거(`.NET` xUnit 28/28 PASS).
- `[x]` **Wave 5 G3~G7 + 기능/계약 백로그 전수 구현 (Waves 6–12):**
- **G3 (`W5-01`):** `@d3ro/core` `redactPII`/`redactPIIMessages`/`rehydrateText`를 `OnlineLLMService`(클라우드 전송 전 마스킹·응답 복원) 및 `support-handlers.ts`(진단 내보내기 마스킹)에 배선하고, `secureWipeAudioChunks`/`secureZeroBuffer`를 `VoiceModeService`·`AudioCaptureService` 버퍼 해제 경로에 배선(`pii-zdr-wiring.test.ts` 4/4 PASS).
- **G4 (`W5-05..07`):** `@d3ro/core`에 `guards.ts`·`csv.ts`·`format.ts`·`unified-search.ts`·`admin-roles.ts`를 추출해 앱/서버 간 중복 헬퍼를 단일 SSOT로 통합(`contract:check` GREEN).
- **G5 (`W5-08` + `GAP-I18N-03`):** 미참조 고아 키 253개 정리(`2,753` → `2,500`키 × 12로케일), `sync-i18n-locales.mjs` 하드코딩 번역 제거(`--check` 전용), `check-i18n-contract.mjs`(`check:i18n`) 및 웹 `LocaleSwitcher`·모바일 12개 로케일 선택기 전 표면 연결.
- **G6 (`W5-12`) + Web `teams.member_count`:** `.eslintignore`에서 `site/` 제외 해제, `typecheck:site`·`lint:site`·CI `site` 빌드 편입, 웹 `team-client.ts`로 실제 팀원 수 집계 연동(`team-client.test.ts` 3/3 PASS).
- **G7 (`W5-11`):** `SettingsModal.tsx`(`951` → `349`줄, `General`/`Audio`/`Llm`/`About` 탭 컴포넌트 및 `settings-model-helpers.ts` 분리) 및 `suggestion-policy-helpers.ts` 순수 모듈 추출.
- **TDD v2.0 Phase 2~5:** `locale-contract.test.ts`(15/15), `ds-contract.test.tsx`(4/4) + `check-ds-contract.mjs`(`check:ds-contract`), `run-affected-tests.mjs`(`test:affected`), `@d3ro/core/ports`(`Clock`/`Random`), `verify-desktop-installer-smoke.mjs`(`release:installer:smoke`) 및 `scripts/ci/lib/test-files.mjs` 미추적 신규 테스트 스캔 보강 완료(`docs/tdd-red/metrics/2026-11-13.md`).
---
## 2026-11-14 — Wave 6 전 표면 코드 위생 · 최적화 · 버그 헌팅 (WS1–WS4 병렬)
- `[x]` **Wave 6 (`WS1`–`WS4`) 전 표면 코드 위생 · 리소스 최적화 · 동시성/보안 버그 수정 완료:**
- **Desktop Main & Sidecar (`WS1`):** `ipc/renderer-broadcast.ts` 9개 파일 단일화, `OnlineLLMService.chatStream` abort/401/예외 래핑, `UnifiedSearchService` `meetingTotal` 이중 집계·정렬·인덱스·런타임 FTS5→`LIKE` 폴백(`UnifiedSearchService.test.ts` 17/17), `rag/chunk-store.ts` 캐시 무효화·중복 `embedding` JSON 제거·Float32 방어, `disk-wav-audio-sink.ts` uint32 오버플로·헤더 write 실패 fd 정리, 타이머/팝업 레이스 수정, `sidecar/main.py` `UploadFile.close()`·PCM 경계·`/shutdown` 조인(`33/33 PASS`).
- **Shared Packages & Desktop Renderer (`WS2`):** `@d3ro/i18n` `shared.ts`·지연 로드/언마운트 레이스 차단(`25/25`), `@d3ro/core` PII 플레이스홀더 충돌/CSV BOM+CR/기간·날짜 가드(`626/626`), `@d3ro/ui` `wave-math.ts` + 캔버스 그라데이션 캐싱(`7/7`), `@d3ro/ui-native`·`api-client` 경계 가드, 렌더러 `utils/error-message.ts`·훅/모달 언마운트 정리 및 팝업 6종 `beforeunload`/DOM 안전화(`@d3ro/desktop` `210 files / 2,865 tests PASS`, `npm run build` + `check:desktop-renderer` GREEN).
- **Mobile RN (`WS3`):** `features/shared/{service-guards,owned-cache-files}.ts` 외 3개 SSOT 통합, `FreeTierBanner` 리사이즈 높이 고착·내구성 큐 조기 폐기 경합·녹음 리스 누수·TTS 12로케일·언마운트 재생/로케일 레이스 수정 및 9개 회귀 스위트 추가(`98 suites / 625 tests PASS`).
- **Web · Admin · Site · Edge · Worker · .NET (`WS4`):** Edge `_shared/json-response.ts` 20개 엔드포인트 통합 및 fail-closed(`Deno 270/270`), `.NET` `SttProxyService` Base64 26MB 상한 + `CancellationToken` 전파(`xUnit 32/32`), Cloudflare Worker `resolveBackendTargetUrl` SSRF·타임아웃 차단(`Deno 9/9`), 웹 `MarkdownPreview` DOM XSS/레이스·`WebPush` 재진입·`team-client` fail-closed(`42/42`), 어드민 `request-security.ts`/`detail-row.tsx`·CSRF/비용 검증, 사이트 `AppLoopDemo`/`rel="noopener noreferrer"` 보강.
- **정량 게이트 및 경계 유지:** `verify:all`, `contract:check`, `check:migrations`(74), `version:check`(1.16.5), `security:secrets`, `test:metrics:write`(`docs/tdd-red/metrics/2026-11-14.md`) GREEN. Electron 실GUI(`Ctrl+K`/오버레이), Fold6/iOS 실기기 Maestro·TalkBack, 외부 자격증명/운영 `db push` `[~]`/`[!]`/`RED` 경계는 변경 없이 유지. 상세: [`docs/REFACTOR_WAVE6_REPORT.md`](../REFACTOR_WAVE6_REPORT.md).