d3ro-voice/docs/map/11-gap-backlog.md
Yun Chan 876e72ea2f
Some checks failed
ci / 정본·보안·린트·타입·테스트 (push) Failing after 18s
ci / 워크스페이스 빌드 검증 (push) Has been skipped
ci / 모바일 린트·타입·Jest (push) Successful in 45s
ci / Supabase Edge Functions + Cloudflare Worker (push) Successful in 22s
ci / .NET API 서버 테스트 (push) Successful in 11s
deploy-site / deploy (push) Successful in 44s
docs(wave7): record peer-swarm bug fixes, metrics, and map sync
2026-11-14 15:41:48 +09:00

322 lines
139 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 11 — Gap & Backlog Register
> The maintained list of what is **under-developed, deferred, or externally blocked**.
> Status: living document. Every feature change updates this file (see [`12-update-protocol.md`](./12-update-protocol.md)).
> External items are marked `EXT`; they block "done" but must not block code, tests, or local fixtures.
Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` resolved (keep for one cycle, then prune).
---
## 0. How to read this
- An item here is **not** a failure. It is a known state with an owner and a next step.
- When you close an item, flip it to `[x]`, add the date + evidence path, and also update `10-feature-catalog.md`.
- Grandfathered detail lives in `docs/v3/MOBILE_APP_COMPLETION_SSOT.md`; this file is the cross-surface roll-up. When the two disagree, the SSOT wins for mobile and must be reconciled here.
- **Not everything imperfect is a gap.** Trade-offs that were reviewed and deliberately kept live in §7 as constraints, not in §1. Check §7 before opening a row for one.
---
## 1. High impact — real capability gaps (no external blocker)
| ID | Area | Gap | Evidence | Suggested next step |
|---|---|---|---|---|
| GAP-QA-01 | Quality | Extreme Red Team: headful end-to-end bug hunting across real desktop Electron, Web Next.js, and CI pipelines. | `red_team_log.md`, `apps/desktop/tests/e2e`, `apps/web/e2e/smoke.spec.ts` | `[x]` 2026-09-15: 18 scenarios executed, 14 defects caught and 100% resolved (infinite chunking loop DEF-008, IPC signature mismatch DEF-004, markdown editor typing rollback DEF-006, Web RSC Link serialization DEF-012, secret scanner lookahead DEF-013, etc.). All 18 scenarios GREEN with zero regressions. **2026-11-04 rework:** the red-team cycle specs were one-off bug hunts (machine screenshot paths, fixed sleeps, conditional assertions) and were replaced by 5 behavior-scoped protected journeys + a shared Electron fixture; 4 stale/duplicate feature specs, the orphaned root `tests/e2e`, and 7 ad-hoc Playwright runner scripts were deleted. Duplicates merged. New `npm run test:hygiene` gate blocks the patterns that made them meaningless. Log: `docs/tdd-red/06-repo-application.md`. |
| GAP-REL-01 | Release | Official release publication to Forgejo and active public download center deployment. | `scripts/ci/publish-forgejo-release.mjs`, `apps/web/src/app/download/page.tsx`, `site/src/sections/Download.tsx`, `apps/web/e2e/smoke.spec.ts` | `[~]` 2026-09-15: v1.1.0 release assets (`D3RO-Voice-Setup-1.1.0-x64.exe`, `.blockmap`, `latest.yml`, `update-policy.json`) published to canonical Forgejo registry and release hub. 2026-09-16: the published 1.1.0 installer carries no Authenticode signature, so it does not satisfy the release policy; product version moved to `1.2.0` and publication must come from CI with the signing gate GREEN. Download centers in `apps/web` (`/download`) and `site` (`#download`) link the canonical Forgejo feed. 2026-09-19: `1.3.7` (overlay fix) is published to the canonical updater feed (`latest.yml` = 1.3.7, 90.6MiB); the CI signing gate that blocks tag-driven publication is still unresolved, so this went out through the local updater path (GAP-REL-06). 2026-09-23: `1.5.0` published the same way (updater feed `latest.yml` = 1.5.0, installer 91.2MiB / 95,612,108 bytes, sha512 matches the local build and the feed serves it anonymously); the runtime and portable channels were republished first. **2026-11-14 (`v1.17.1`):** Desktop `1.17.1` (`6c6875b`, `D3RO-Voice-Setup-1.17.1-x64.exe` `95,294,301` bytes + Ed25519 signed `latest.yml`/`.sig`), `runtime-1.17.1`/`runtime-latest`, `portable-1.17.1`/`portable-latest`, 및 Landing `site/` (`https://d3ro.chanpaca.net/release-identity.json` = `1.17.1`/`6c6875b`)가 프로덕션에 게시됐다(단 Authenticode SmartScreen 평판 `GAP-REL-02`/`06` 및 Release #339 ~91MB 첨부 `GAP-REL-16` 예외는 유지). |
| GAP-REL-08 | Release | 다운로드 센터가 **존재하지 않는 설치 파일**을 가리켰다. `apps/web/src/lib/desktop-release.ts`와 `site/src/release.ts`의 `DESKTOP_VERSION`이 `1.2.0`에 멈춰 있어 설치 URL이 `D3RO-Voice-Setup-1.2.0-x64.exe`였고, 그 경로는 피드에서 404다(실측: 1.2.0=404, 1.3.7=206). `version:sync`가 이 두 표면을 덮지 않아 계속 어긋났다. | `scripts/ci/sync-version.mjs`, `apps/web/src/lib/desktop-release.ts`, `site/src/release.ts` | `[x]` 2026-09-19: 두 다운로드 계약 파일을 `sync-version.mjs` 대상에 추가해 버전·릴리스일이 SSOT에서 자동 반영되도록 하고, 현재 값(1.3.7 / 2026-09-19)으로 정정했다. `version:check`·typecheck·site 빌드 GREEN. |
| GAP-REL-09 | Release | 랜딩 사이트가 **재배포되지 않는다**. `deploy` 워크플로가 main push마다 실패한다. 실측 원인(run#66 로그): `site/src/sections/Hero.tsx`가 타이머 ref를 `NodeJS.Timeout`으로 타이핑해 `@types/node` 네임스페이스가 필요했고, 배포 잡은 `npm ci --prefix site`만 하므로 조상 `node_modules`의 hoisted 타입이 없어 `tsc -b`가 `TS2503: Cannot find namespace 'NodeJS'`로 실패한다. 그래서 `https://d3ro.chanpaca.net/release-identity.json`이 404다(공개 버전 검증 불가). | `.forgejo/workflows/deploy-site.yml`, `site/src/sections/Hero.tsx` | `[x]` 2026-09-19: ref를 `ReturnType<typeof setTimeout>`으로 바꿔 hoisted 타입 의존을 제거했다(격리 `--typeRoots`로 CI 조건 재현 → 수정 전 TS2503, 수정 후 clean). 같은 수정을 push하자 `deploy` run#67이 사이트 빌드를 통과해 `dist/`를 만들었고, 실패는 다음 단계(Cloudflare)로 이동했다. |
| GAP-REL-09b | Release | `d3ro.chanpaca.net`이 404였던 직접 원인: 이 Cloudflare 계정에 Pages 프로젝트 `d3ro`/`d3ro-voice`가 **존재하지 않아** 커스텀 도메인 바인딩이 없었다(빈 본문 404, `cf-ray`만 반환). Pages 커스텀 도메인은 존 DNS CNAME(`d3ro → d3ro.pages.dev`)을 요구하는데 기존 `d3ro` 레코드가 남아 있어 `CNAME record not set`으로 pending에 머물렀고, 로컬 wrangler 자격증명에는 DNS 스코프가 없다(403 Authentication error). `deploy-site.yml`은 `CF_API_TOKEN` 시크릿이 없어 마지막 게시 단계에서도 `exit 1`이다. | `server/cloudflare-site-bridge/`, `.forgejo/workflows/deploy-site.yml`, `docs/map/02-infrastructure.md` | `[x]` 2026-09-19: Pages 프로젝트 `d3ro` 생성 + `site/dist` production 배포(`d3ro.pages.dev` 200, `release-identity.json` = commit `2407f5a` / 1.3.7) + 커스텀 도메인 연결. DNS 없이 도메인을 살리기 위해 Workers 라우트 브리지(`server/cloudflare-site-bridge`, `d3ro.chanpaca.net/*` → Pages 프록시, `npx wrangler deploy`)를 배포 → 라이브 확인: `/`·`/privacy/`·`/terms/`·`/delete-account/` 200, 라이브 번들이 설치 파일명을 `1.3.7`로 계산, `/download.html` → `/#download`. 남은 정리 2건: (1) 대시보드에 CNAME을 추가한 뒤 브리지 워커 삭제, (2) CI 자동 게시를 위해 `CF_API_TOKEN`(Pages/Workers Edit) + `CF_ACCOUNT_ID`=`8e83cc130e7329c160cf2b88d6b4c20a`를 Forgejo 시크릿에 등록. **2026-09-23:** CI `deploy`(deploy-site.yml)는 `CF_API_TOKEN` 부재로 run#71까지 여전히 실패한다. 로컬 인증 wrangler(pages:write)로 `npm run build --prefix site` → release-identity 작성 → `npx wrangler pages deploy site/dist --project-name d3ro --branch main`을 수동 배포했고, 라이브 `https://d3ro.chanpaca.net/release-identity.json`이 commit `5c11ee2` / version `1.5.0`을, 라이브 번들이 설치 파일명 `D3RO-Voice-Setup-1.5.0-x64.exe`를 보고한다. 자동 게시에는 여전히 시크릿 등록이 필요하다. |
| GAP-BILL-01 | Billing | 사이트 가격과 서버 청구 금액·결제 진입 URL이 제각각이었다. | `packages/core/src/plan-catalog.ts`, `packages/core/src/web-urls.ts`, `scripts/ci/sync-core-contract.mjs` | `[x]` 2026-09-26 (Wave 3, 88f24d8·b6fe588): 가격·쿼터·공개 URL 정본을 core 두 파일로 합치고 Deno는 생성 사본(`contract:check`). Payple 함수 4종+billing-catalog 운영 재배포(payple-* v9, billing-catalog v5) → 신규·갱신 모두 ₩2,900/₩8,900. 결제 진입은 `/app/billing` 하나. **2026-11-04:** `knowledge_embedding` 쿼터도 `PLAN_QUOTA`에 편입하고 `embedding-quota.ts`가 생성 계약을 소비하도록 중복 상수를 제거했다. |
| GAP-BILL-02 | Billing | **Payple 정기 갱신이 한 번도 실행되지 않았다.** 갱신 cron(`payple-renew`)이 `.github/workflows`에만 있었는데 GitHub 원격이 없다. 웹 Payple 결제용 `NEXT_PUBLIC_PAYPLE_CLIENT_KEY`는 설정된 적이 없다. | `.forgejo/workflows/payple-renew.yml`, `apps/web/src/components/billing/payple-checkout-button.tsx`, `apps/web/Dockerfile` | `[~]` 2026-09-26: 워크플로 Forgejo 이식(dc43884), `CRON_SECRET` 새로 발급해 Supabase 함수 시크릿·Forgejo 시크릿에 등록, Forgejo `SUPABASE_URL` 등록 — main에 push되면 스케줄이 등록된다. **백로그(사용자 결정, 2026-09-27):** 아직 Payple 계약·계정이 없다. 웹 Payple 클라이언트 키(`NEXT_PUBLIC_PAYPLE_CLIENT_KEY`)는 계약 후 `.env`에 넣고 웹 이미지를 다시 빌드한다. 그 전까지 웹 결제 버튼은 꺼진 상태로 둔다. Stripe는 쓰지 않고(2026-09-26 저장소에서 제거, GAP-BILL-03), Google Play 가격은 스토어가 정본이라 사이트에 표시하지 않는다. |
| GAP-BILL-03 | Billing | **Stripe 결제 제거 — 운영 잔여물 정리.** 사용자 결정(2026-09-26)으로 저장소에서 Stripe 코드·설정·테스트를 모두 지웠다(함수 3종, 웹 checkout/portal 버튼, `billing-catalog`의 Stripe 가격 조회, 데스크톱 `CheckoutModal`·`payment:*` IPC, `billingUrl()`의 `success`/`canceled` 복귀 쿼리). 배포된 Supabase 함수와 시크릿은 아직 운영에 남아 있다. 과거 `provider='stripe'` 행·`stripe_*` 컬럼·마이그레이션은 이력 호환으로 유지한다. | `server/supabase/config.toml`, `server/supabase/functions/billing-catalog/index.ts`, `apps/web/src/lib/billing-catalog.ts` | `[ ]` 운영: `supabase functions delete stripe-checkout`·`stripe-portal`·`stripe-webhook`, 시크릿 `STRIPE_SECRET_KEY`·`STRIPE_WEBHOOK_SECRET`·`STRIPE_PRICE_PRO`·`STRIPE_PRICE_PRO_PLUS`·`STRIPE_PRICE_TEAM` unset, Stripe 대시보드 웹훅 엔드포인트 비활성화. `billing-catalog` 재배포는 웹앱 배포보다 먼저(웹 파서가 Stripe 가격을 거부). |
| GAP-WEB-01 | Web | 웹앱(`apps/web`)이 공개되지 않았다(배포 경로가 없었음). | `apps/web/Dockerfile`, `docker-compose.nas.yml`, `server/cloudflare-site-bridge` | `[x]` 2026-09-26: `/app` basePath·NAS `d3ro_voice_web`(3002). 터널 `kd-nas` ingress에 `d3ro.chanpaca.net` path `^/app` → NAS 3002를 추가하고 브리지 워커가 `/app`·`/api`·`/health`를 도메인 원본(터널)으로 흘린다(4aadee8). Supabase `site_url`을 `https://d3ro.chanpaca.net/app`으로(기존 localhost:3000), 허용 목록에 `/app/**` 추가. 라이브 `/app/login` 200. 같은 수정으로 9/19부터 끊겨 있던 API(`/api`, 관리자 로그인·stt-proxy)도 복구. |
| GAP-OPS-01 | Ops | NAS 운영 compose가 저장소와 어긋나 있었다(JWT 기본값 폴백, 법률 wwwroot 마운트, 필수 변수 4개 누락). | `docker-compose.nas.yml`, NAS `/volume1/docker/d3ro/.env` | `[x]` 2026-09-26: NAS `.env`에 `SUPABASE_URL`·`SUPABASE_SERVICE_ROLE_KEY`(운영 service_role)·`ADMIN_BOOTSTRAP_TOKEN`(신규)·`API_SERVER_URL` 추가, 저장소 compose로 교체 후 `docker compose up -d`. 4개 컨테이너 정상, 백업 `*.before-wave3-20260926`. |
| GAP-OPS-02 | Ops | 관리자 주소가 두 개였다(`admin.chanpaca.net`, `d3ro-admin.chanpaca.net`). `admin.d3ro.chanpaca.net`은 2단계 서브도메인이라 고급 인증서(ACM, 월 $10)가 필요하다. | Cloudflare 터널 kd-nas ingress, chanpaca.net DNS | `[x]` 2026-09-26: 사용자 결정 — 관리자 주소는 `d3ro-admin.chanpaca.net` 하나(chanpaca.net에 다른 서비스가 많다). `admin.chanpaca.net` 터널 규칙·DNS 삭제로 이름을 풀었다. ACM은 지금 구독하지 않는다. 참고: `*.kite`·`*.voice` 고급 인증서는 ACM이 꺼져 2026-11-02 만료 후 갱신되지 않는다(다른 프로젝트). |
| GAP-OPS-03 | Ops | **`payple-renew` 크론이 등록 이후 한 번도 성공하지 못했다.** Forgejo 시크릿 `SUPABASE_URL`이 로컬 Supabase 주소(`127.0.0.1:55321`)로 등록돼 매일 `curl: (7) Failed to connect`. Payple 계약 전이라 청구 대상 구독은 없다(GAP-BILL-02). | `.forgejo/workflows/payple-renew.yml`, `scripts/ci/set-forgejo-secrets.mjs` | `[~]` 2026-10-11: 시크릿을 `.env` 운영 값으로 교체, 스크립트를 `.env` 정본 동기화 + 로컬 주소 거부로 확장. 남은 확인: 다음 정기 실행(10:00 KST)이 HTTP 200인지(수동 dispatch는 실결제 경로라 보류). |
| GAP-OPS-04 | Ops | `audio-purge`가 pg_cron의 service credential을 handler 안에서 검증하는 구조인데 `config.toml`에 함수 stanza가 없어 기본 gateway JWT 검증이 먼저 요청을 거부할 수 있었다. | `server/supabase/config.toml`, `server/supabase/functions/audio-purge/{index,handler}.ts`, migration `20260929000004_audio_retention_on_delete.sql` | `[~]` 2026-11-04: `[functions.audio-purge] verify_jwt = false`를 명시하고 격리 로컬 Supabase에서 실제 경로를 검증했다. 키 없음/유효한 non-service 키는 401, service 키는 200이었고 direct drain과 `pg_cron` → Vault → `pg_net` → Edge → Storage 경로 모두 `claimed=1`, `removed=1`, `failed=0`, `completed=1`; queue/`audio_files`/`storage.objects`는 `1|1|1`→`0|0|0`이었다. **2026-11-14 운영 반영:** `audio-purge` 포함 24개 Edge Function을 운영(`verify_jwt = false` `config.toml` 반영)에 재배포했으며 무인증 호출이 HTTP `401`로 거부됨을 확인했다. **남은 경계:** 운영 DB의 실제 `pg_cron`/Vault/실객체 스케줄 실행은 별도 실데이터 검증이 필요하다. |
| GAP-CI-02 | CI | `linux-builder` 러너가 노트북 한 대(`kd-desktop`)뿐이라 노트북이 꺼지면 CI·크론이 통째로 멈춘다(2026-09-29~10-09, run #128~#137 Canceled). | `.forgejo/workflows/*.yml` (`runs-on: linux-builder`) | `[ ]` 후보: 상시 켜진 NAS 러너에 `linux-builder`(또는 크론 전용) 라벨 추가, 최소한 `payple-renew`는 NAS로. |
| GAP-CI-03 | CI | 9-28부터 `ci.yml`의 데스크톱 Vitest·모바일 Jest가 테스트 전부 통과인데도 실패했다. 데스크톱: 템플릿 테스트가 결과를 실제 TextInsertService로 넣다가 nut-js(libnut)가 X 디스플레이 없음(`Could not open main display`)으로 워커를 죽임. 모바일: `knowledge-service.test.ts`가 구독의 삭제 대조 setInterval을 끄지 않아 Jest가 끝나지 않음(잡 무한 대기). | `apps/desktop/tests/setup.ts`, `apps/mobile-rn/__tests__/knowledge-service.test.ts` | `[x]` 2026-10-11: setup.ts에 nut-js 공통 목, 테스트가 unsubscribe. 러너 호스트(vd-linux)에서 데스크톱 2539/2539 exit 0, 모바일 589/589 정상 종료 확인. |
| 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/*,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 통과. |
| GAP-UX-04 | Mobile | 모바일 정보 구조 개편: visible Home/Records/Meetings/More 4탭, 숨은 Record route, 세 동작 FAB, Home/More, 새/전환된 v4 흐름의 `ScreenHeader`와 48dp back target. | `apps/mobile-rn/src/navigation/TabNavigator.tsx`, `components/{RecordFab,ScreenHeader}.tsx`, `screens/{Home,More}Screen.tsx` | `[x]` 2026-09-28: 전체 Jest 86 suites/589 tests, 320dp dark 1/1 PASS(88초), 411dp light 1/1 PASS(100초). Canonical 보고서는 `scratch/design-audit/wave45/navigation-shell-search-{320-dark,411-light}-verified.xml`, 추적 요약은 `docs/evidence/wave45-mobile-shell-search-2026-09-28.md`. `DashScreen`/`WorksHubScreen`은 삭제했고 WorksHub의 로컬 도구 검색·고정은 복잡도 축소를 위해 의도적으로 종료했다. 목적지는 탭/More에 보존됐고 콘텐츠 삭제는 없으며 비활성 `works-hub-pins.v1` 키는 남을 수 있다. TalkBack/font-scale/rotation은 이 셸 gap을 다시 열지 않고 Q-021 `[~]`로 추적한다. |
| 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 으로 높이가 변해 탭 바가 시프트한다(콘텐츠 가림은 스크롤로 회피 확인). | `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). |
| GAP-REL-12 | Release | Forgejo generic registry는 파일 단위 덮어쓰기를 거부(HTTP 409)하는데, portable 게시 스크립트의 "동일 파일 건너뛰기"가 1MiB 초과 파일을 **크기만** 비교했다. 그래서 새 runtime의 sidecar 볼륨 `.001`이 이전 볼륨과 정확히 같은 94,371,840 bytes였고, 내용이 다른데도 "동일"로 오판해 `runtime-latest`가 낡은 `.001` + 새 `.002`로 갈라졌다(다운로드 시 손상). | `scripts/ci/publish-portable-release.mjs` | `[x]` 2026-09-23: 파일 목록 API(`GET /api/v1/packages/{owner}/generic/{name}/{version}/files`)의 sha256으로 정확히 비교하고, 내용이 다른 파일이 하나라도 있으면 해당 별칭 버전 전체를 삭제 후 재업로드하도록 수정했다. 이미 발생한 `runtime-latest`는 버전을 지우고 재게시해 4개 파일 모두 로컬 해시와 일치함을 확인했다. |
| GAP-REL-02 | Release | Windows stable publication needs an external public-trust Authenticode PFX, its password, the exact signer subject, and a Forgejo token, none of which live in the repository. | `.forgejo/workflows/release.yml`, `.gitlab-ci.yml`, `scripts/ci/set-forgejo-secrets.mjs`, `scripts/ci/verify-windows-release-artifact.ps1` | `[!]` 2026-09-18 measured: the Forgejo repo had **zero** Actions secrets; `FORGEJO_TOKEN` is registered now (2026-09-18) but `WIN_CSC_*` still have no values, so `v1.2.0` (run 49) and `v1.3.0` (run 51) both failed at the signing guard and **no updater-feed release has been published since `1.1.0`**. Inject the four secrets (`WIN_CSC_LINK`, `WIN_CSC_KEY_PASSWORD`, `WIN_CSC_EXPECTED_SIGNER_SUBJECT`, `FORGEJO_TOKEN`) with `npm run release:secrets` (check: `npm run release:secrets:check`), then re-run `release.yml` for the `v1.3.0` tag via `workflow_dispatch` (tags are immutable). **2026-09-19 정정**: CI 서명 게이트는 여전히 막혀 있지만, updater feed에는 `1.3.2`~`1.3.7`이 로컬 `release:updater` 경로로 게시되어 있다(GAP-REL-06). **2026-09-23 정정**: `1.4.0`은 게시되지 않았고(GAP-REL-06), `1.5.0`도 로컬 무서명 경로로 게시했다. CI 서명 게이트는 여전히 `WIN_CSC_*` 부재로 막혀 있다(GAP-REL-10의 Python 선행 문제와 별개). **2026-10-17 `[~]`**: Authenticode 는 더 이상 게시 차단 조건이 아니다 — 무서명 설치본은 Ed25519 서명 `latest.yml` 로 보호하고(GAP-REL-13), `release.yml` 은 `WIN_CSC_*` 가 있으면 서명만 추가한다. 남은 것은 SmartScreen 평판용 인증서(한국 개인은 Azure Artifact Signing 불가, 사업자 필요). |
| GAP-REL-13 | Release | **9-27 v1.9.0 이후 3주간 업데이트 0건(커밋 83개 미배포).** 앱 업데이터는 정상(4시간마다 확인, 피드 200)이었지만 게시가 손으로 5~6단계라 아무도 돌리지 않으면 안 나갔고, CI 경로는 서명 가드로 늘 실패했다. 게시 스크립트도 4벌(forgejo·updater·portable·gitlab)로 겹쳐 있었다. | `scripts/ci/release-desktop.mjs`, `scripts/ci/build-desktop-installer.mjs`, `scripts/ci/publish-forgejo-release.mjs`, `scripts/ci/lib/update-manifest-signature.mjs`, `apps/desktop/src/main/update-signature.ts`, `apps/desktop/src/main/services/update-adapters.ts`, `.forgejo/workflows/release.yml` | `[~]` 2026-10-17: `npm run release -- patch|minor` 한 줄(점검→버전→게이트→커밋·태그→빌드→서명·게시→공개 URL 재검증→푸시, `--resume`). latest.yml Ed25519 서명 + 앱이 NsisUpdater `verifySignature` 단계에서 불변 `<version>/latest.yml`+`.sig` 로 설치본 sha512 검증(fail-closed). electron-updater 6.8.9→6.8.10(차분 다운로드 수정). `publish-updater-release.mjs`·`publish-gitlab-release.mjs`·`LEGACY_UPDATE_FEED_URL` 삭제. CI 는 같은 스크립트를 쓰는 예비 경로(피드에 있으면 건너뜀). 검증: 업데이트 테스트 95/95, release:metadata 음성 16, typecheck 0, 게시 --check 자산 4개, 서명 왕복. **남은 것**: 첫 실제 릴리스(1.10.0) 게시 + 1.9.0 설치본→1.10.0 자동 업데이트 E2E, Forgejo 시크릿 `D3RO_UPDATE_SIGNING_KEY` 동기화(`npm run release:secrets`). |
| GAP-REL-14 | Release | **Forgejo 소스 태그가 릴리스 커밋이 아닌 push 전 원격 main 을 가리킨다.** `publish-forgejo-release.mjs` 가 `target_commitish: "main"` 으로 Release 를 먼저 만들고, `release-desktop.mjs` 는 그 뒤에 `git push chanpaca main <tag>` 를 한다. 그래서 Forgejo 가 당시 원격 main(이전 커밋)에 태그를 새로 만들고, 로컬 annotated 태그 push 는 `already exists` 로 거부된다. v1.10.0(d63854d ≠ f3018f3)과 v1.10.1(11e023d ≠ 1da04b9) 모두 해당. 설치 파일·latest.yml·서명은 로컬 릴리스 커밋에서 빌드돼 정상이고, 틀린 것은 Forgejo 의 소스 태그뿐이다(GitLab origin 태그는 정상). 태그는 불변 규칙이라 옮기지 않는다. 해결 방향: 게시 전에 main+태그를 먼저 push 하되, 태그 push 로 도는 CI 백업 경로와 경합하지 않게 한다. | `scripts/ci/release-desktop.mjs`, `scripts/ci/publish-forgejo-release.mjs`, `.forgejo/workflows/release.yml`, `scripts/ci/verify-release-metadata.mjs` | `[x]` 2026-10-30: `release-desktop.mjs`가 게시 전에 `git push chanpaca main <tag>` 및 원격 태그 커밋 검증을 먼저 수행하고 `FORGEJO_TARGET_COMMITISH`(40자 커밋 SHA)를 전달하며, `publish-forgejo-release.mjs`는 `target_commitish: "main"` 대신 정확한 태그 커밋 SHA를 사용하고 `.forgejo/workflows/release.yml`은 로컬 게시 진행 중/완료 시 대기·건너뛰도록 수정했다 (`npm run release:metadata:test` 18 negative cases PASS). |
| GAP-REL-15 | Release | **The desktop `typecheck` gate checks nothing.** `apps/desktop/tsconfig.json` is `files: []` + project references, and `npm run typecheck` runs plain `tsc --noEmit` (not `-b`), so the release gate passes without type-checking a single file. Running `-p tsconfig.node.json` directly finds 11 real errors that have been shipping: `ipc/support-handlers.ts` (8: removed STTManager methods, stale SupportTicket and RefundEligibilityResult fields), `KeyBindingService.ts` (2: powerMonitor overloads) and `text-insert/nut-keyboard-port.ts` (1). The renderer project (`tsconfig.web.json`) is clean. Fix: make the script check both projects (filtering or fixing the TS6059/TS6307 rootDir noise from packages/*), then fix the 11 errors. | `apps/desktop/package.json` typecheck, `apps/desktop/tsconfig*.json`, `support-handlers.ts`, `KeyBindingService.ts` | `[x]` 2026-10-30: `apps/desktop/package.json`의 `typecheck`를 `tsc --noEmit -p tsconfig.node.json && tsc --noEmit -p tsconfig.web.json`으로 변경하고, `support-handlers.ts`·`KeyBindingService.ts`·`PersonalGraphService.ts` 등 모든 타입 오류를 수정해 0 에러로 통과시켰다. |
| GAP-REL-06 | Release | 서명 인증서가 없어 stable(`latest`) 채널에 **무서명** 설치본을 게시했다. electron-updater는 `app-update.yml`에 `publisherName`이 없으면 서명 검증을 건너뛰므로 설치는 동작하지만, SmartScreen 평판은 버전마다 0부터 시작한다. | `scripts/ci/publish-forgejo-release.mjs`, `release/update-policy.json`, `.forgejo/workflows/release.yml` | `[~]` 2026-10-17: 무서명 게시가 정식 경로가 됐다 — `--ack-unsigned` 예외 대신 latest.yml Ed25519 서명 + 앱 검증(GAP-REL-13). SmartScreen 평판 문제만 남음. 이력: 2026-09-18: `1.3.2`를 `--ack-unsigned`(명시적 승인 플래그)로 게시. **2026-09-19: `1.3.7`도 같은 경로로 게시**(`npm run release:updater -- --ack-unsigned`, 설치본 90.6MiB, `latest.yml`=1.3.7, 설치본 sha512가 피드 메타데이터와 일치). 인증서 확보 시 더 높은 버전으로 서명 게시하여 대체하고, 이 예외를 제거한다. **2026-09-23: `1.5.0`도 같은 경로로 게시**(`npm run release:updater -- --build --ack-unsigned`, 설치본 91.2MiB, `latest.yml`=1.5.0, sha512 검증). |
| GAP-REL-07 | Release | 패키징된 `better-sqlite3`가 호스트 Node ABI여서 `1.3.2` 설치본이 시작 즉시 죽었다(NODE_MODULE_VERSION 131 vs 130). 원인: 로컬 `npm install`이 네이티브 모듈을 Node용으로 재빌드했고 패키징이 재빌드를 건너었다. | `scripts/ci/verify-native-abi.mjs`, `scripts/ci/fix-native-abi.mjs`, `.gitlab-ci.yml`/`.forgejo`/`.github` 패키징 단계 | `[x]` 2026-09-18: 패키징 후 Electron ABI를 검증하고, 검증된 트리에서만 설치본을 생성(`--prepackaged`)한다. `1.3.3`은 설치본에서 추출한 바이너리로 재검증 GREEN. |
| GAP-ADS-01 | Ads | 9 of 10 desktop ad adapters still extend `UnavailableAdAdapter` (`provider_not_integrated`). | `apps/desktop/src/main/services/ads/*` | `[~]` 2026-09-13: `DirectHouseSponsorAdapter` is now a real configurable REST adapter (bid/impression/click/reward via `endpointUrl`; fail-closed when unconfigured; 22 unit tests GREEN). Remaining 9 need official SDKs/authenticated endpoints. |
| GAP-ADS-02 | Ads | Desktop mediation reward accounting is not wired to license quota (`claimReward` still returns no tokens). | `AdMediationEngine.ts`, `LicenseService.ts`, `license-store.ts`, `AppLayout.tsx`, `tests/unit/AdMediationEngine.test.ts` | `[x]` 2026-10-30: `AdMediationEngine.claimReward`가 어댑터 `reportRewardCompletion` 검증 및 노출·재생시간·쿨다운·논스 중복 검증을 통과한 경우에만 `LicenseService.grantRewardQuota`를 호출해 당일 `PREMIUM_LLM` 보너스 쿼터를 지급하도록 연결했다(미검증/위조 요청은 fail-closed 거부). 검증: `AdMediationEngine.test.ts` 23/23 통과. |
| GAP-ID-01 | Identity | Supabase, .NET JWT/SQLite, and the desktop offline license each had their own tier/role shape. | `@d3ro/core/entitlement`, `LicenseService`, `entitlement-context` | `[x]` 2026-10-30: canonical `EntitlementSnapshot` + `resolveEntitlement` adopted across desktop, web, and mobile (see GAP-ID-02). |
| GAP-ID-02 | Identity | Web and mobile still hand-roll tier/role normalization instead of consuming the canonical resolver; .NET identity is still a separate store. | `apps/web/src/lib/entitlement.ts`, `apps/mobile-rn/src/lib/entitlement-context.tsx`, `apps/mobile-rn/__tests__/entitlement.test.ts` | `[x]` 2026-10-30: 웹(`apps/web/src/lib/entitlement.ts`, `billing/page.tsx`, `dashboard-client.ts`)과 모바일(`apps/mobile-rn/src/lib/entitlement-context.tsx`) 모두 `@d3ro/core/entitlement`의 `resolveEntitlement`·`normalizeEntitlementTier`·`normalizeAdminRole`을 정본으로 사용하도록 통합했다(`.NET` 서버는 엔터프라이즈/레거시 프록시 전용 매핑 유지). 검증: `apps/mobile-rn/__tests__/entitlement.test.ts` 통과. |
| GAP-TEAM-01 | Teams | Team comments / activity feed was not implemented. | `server/supabase/migrations/20260913000033_team_activities.sql`, web `activity-feed.tsx`, mobile `team-service.ts` | `[x]` 2026-09-13: `team_activities` table + `create_team_activity` RPC + RLS + realtime publication; web + mobile UI. |
| 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. | `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. **2026-11-14 (`v1.17.1`):** `v1.17.1` (`6c6875b`) also reproduced `write ECONNRESET` at Human Release #339 asset attachment due to Cloudflare ~91 MB proxy limit, while Forgejo generic registry (`1.17.1/latest.yml`, `.sig`, `latest/latest.yml`, `runtime-1.17.1`, `portable-1.17.1`) and public signed-manifest verification completed with HTTP `200`, so installed apps can auto-update cleanly. To retry only this step locally without Cloudflare proxy timeout or check detached tag: check out `v1.17.1` before `npm run release -- --resume`. |
| GAP-INFRA-01 | Build | `apps/mobile-rn` is outside npm workspaces, so root `typecheck`/`test`/`lint` skip it. `typecheck:mobile`/`lint:mobile`/`test:mobile`/`verify:all` root scripts added 2026-09-13 (`package.json`), but membership/CI integration is still open. | `package.json`, `.forgejo/workflows/ci.yml`, `.gitlab-ci.yml` | `[x]` 2026-10-30: React Native Metro/Gradle 네이티브 오토링킹 격리를 위해 `apps/mobile-rn`은 독립 `node_modules`로 유지하고, 루트 `verify:all` 및 `.forgejo/workflows/ci.yml`·`.gitlab-ci.yml`의 `mobile-quality` 잡이 모바일 `lint`·`typecheck`·`test:ci`를 필수 게이트로 실행하도록 정본화했다. **2026-11-04:** root `test:mobile`도 watch-capable 기본 Jest가 아니라 mobile `test:ci`(`jest --runInBand`)를 호출하도록 고정했다. |
| GAP-MOB-01 | Legacy | `apps/mobile` Expo skeleton duplicated auth/data code and got version-sync edits. | SSOT G-002 | `[x]` 2026-09-13: deleted `apps/mobile`, removed from `sync-version.mjs` and `package-lock.json`; `version:check` GREEN. |
| GAP-INFRA-02 | CI | GitLab admin NAS deploy job is disabled; admin deploy is manual/GHCR. | `.gitlab-ci.yml`, `docs/deployment/nas-deploy-runbook.md` | `[x]` 2026-10-30: 임시 CI DinD 데몬만 바꾸던 구 잡 대신 `docker-compose.nas.yml` 기반의 정본 배포·헬스체크·롤백 절차를 `docs/deployment/nas-deploy-runbook.md`로 문서화하고 `.gitlab-ci.yml` 및 `02-infrastructure.md`에 연결했다. |
| GAP-INFRA-03 | Release | Desktop auto-update was single-channel and pointed at GitLab while the public hub was Forgejo; no channel, mandatory-update, major-vs-delta, staging, or kill-switch policy. | `apps/desktop/src/main/update-feed.ts`, `electron-builder.yml`, `.forgejo/workflows` | `[x]` 2026-09-13: canonical Forgejo feed + legacy GitLab mirror, `release/update-policy.json` + runtime policy, `publish-forgejo-release.mjs` + Forgejo release workflow, 21 policy tests, verifier self-test 13 cases. See `docs/deployment/update-system-assessment.md`. |
| GAP-INFRA-04 | Quality | Desktop `typecheck` is a no-op: `tsconfig.json` is `files: []` + references, so `tsc --noEmit` checks nothing. Real `tsc -p tsconfig.node.json --noEmit` surfaces many pre-existing errors. | `apps/desktop/package.json`, `apps/desktop/tsconfig.node.json`, `apps/desktop/tsconfig.web.json` | `[x]` 2026-10-30: `apps/desktop/package.json`의 `typecheck`가 `tsc --noEmit -p tsconfig.node.json && tsc --noEmit -p tsconfig.web.json`을 실행하도록 수정하고 전체 컴파일 에러를 0건으로 해소했다 (GAP-REL-15). |
| GAP-SHELL-01 | Support | Admin `/support` is a stub panel; desktop-only `SupportModal`. No shared ticket contract. | `apps/admin/src/app/(admin)/support/page.tsx` | `[x]` 2026-10-30: 어드민 `/support`를 정적 스텁에서 `content_reports` 기반의 fail-closed 고객지원·콘텐츠 신고 관리 콘솔(상태별 필터, 요약 지표 카드, 페이지네이션, 백엔드 미연결 시 명시적 오류 배너 `support-backend-error`)로 업그레이드했다 (`apps/admin` typecheck 0 에러). |
| GAP-PUSH-01 | Push | `send-push` accepted `webpush`/`apns` but marked them `push_provider_not_supported`. | `_shared/webpush.ts`, `_shared/apns.ts`, `send-push/index.ts` | `[x]` 2026-09-13: VAPID Web Push (RFC 8291) + APNs `.p8` transports implemented and routed; 10 new tests incl. an encryption round-trip. Web/iOS client registration code now exists (see GAP-PUSH-03); provider secrets, deployed cron execution, and live delivery remain separate runtime gates. |
| GAP-PUSH-02 | Push | Nothing triggered `send-push?mode=drain`; enqueued notifications never left the outbox. | `server/cloudflare-worker/src/push-drain.ts`, `wrangler.toml` | `[x]` 2026-09-13: Cloudflare Cron Trigger (`* * * * *`) drains the outbox; tests in CI. Requires `SUPABASE_URL` + `SUPABASE_SERVICE_ROLE_KEY` secret on the worker. |
| GAP-PUSH-03 | Push | Web/iOS provider-specific registration paths were missing; web additionally needed a production call site that actually subscribes the signed-in device. | `apps/web/public/sw.js`, `apps/web/src/lib/{web-device,web-push,web-push-session}.ts`, `apps/web/src/components/layout/web-push-control.tsx`, `apps/web/e2e/web-push.spec.ts`, `packages/api-client/src/types.ts`, `apps/mobile-rn/src/features/notifications/*`, `apps/mobile-rn/__tests__/notifications.test.ts` | `[~]` 2026-11-04: web sidebar opt-in/out uses explicit user-gesture permission, a stable active `platform='web'` device, device-bound RPCs, rollback, disabled-intent reconciliation, bounded parallel local/server cleanup, and logout-independent sign-out; 17 Playwright contract tests cover these boundaries. An ephemeral isolated local run proved device/token/outbox/drain and a provider-accepted `delivered` row, but did not observe the service-worker notification. A production-standalone rerun built/served, then timed out during throwaway login navigation before dashboard render. Mobile APNs/FCM branching is unit-tested. Still open: matching production VAPID configuration, authenticated production permission/subscription and 1440/390/a11y render proof, deployed scheduled drain, and real Web Push/APNs receipt. |
| GAP-PUSH-04 | Push | Android still depends on FCM (`google-services.json`). | `apps/mobile-rn/android`, `send-push` | Decide: minimal Firebase project, or UnifiedPush/ntfy. See `docs/deployment/push-transport-without-firebase.md`. |
| GAP-STT-01 | Local STT | Packaged desktop builds shipped **no** faster-whisper sidecar: `electron-builder.yml` had no `extraResources` entry for it and no pipeline job built it. Local transcription was impossible on any installed build; the app fell back to a system Python without the runtime. | `apps/desktop/electron-builder.yml`, `.gitlab-ci.yml`, `apps/desktop/scripts/build-sidecar.mjs` | `[x]` 2026-09-18: sidecar bundled via `extraResources` (`sidecar-dist/sidecar` → `resources/sidecar`), `sidecar:setup`/`sidecar:build` scripts, and `scripts/ci/verify-sidecar-bundle.mjs` fails packaging when the engine or its Silero VAD data is missing. Verified on the real 242 MB bundle. |
| GAP-STT-02 | Local STT | Dev resolved the sidecar/SoX paths against the Vite output dir (`out/main`), so the sidecar ran a Python without faster-whisper and SoX recording died with `spawn sox ENOENT`. | `apps/desktop/src/main/utils/paths.ts`, `apps/desktop/tests/main/utils/paths.test.ts` | `[x]` 2026-09-18: app root is discovered by walking up for app markers; packaged mode fails loudly instead of silently falling back. Unit tests pin both branches. |
| GAP-STT-03 | Local engines | On hosts where `localhost` resolves only to IPv6, every local engine call (STT sidecar and Ollama) was refused. Audio capture and local LLM appeared dead. | `apps/desktop/src/main/utils/loopback.ts`, `LocalSTTService`, `LocalLLMService`, `RAGService`, `OnlineLLMService`, `STTManager` | `[x]` 2026-09-18: loopback normalization to `127.0.0.1` for all local engine URLs; defaults updated; 9 unit tests. Verified against the live sidecar and Ollama on a host with an IPv6-only `localhost`. |
| GAP-STT-04 | Local STT | Live partial transcript (`CAP-03`, `voice:partialTranscript`) was marked done but had **no producer**: the channel, popup UI, and preload existed, nothing ever emitted. | `apps/desktop/src/main/services/VoiceModeService.ts`, `LocalSTTService.transcribePartial`, `STTManager.transcribePartial` | `[x]` 2026-09-18: 1.5 s cadence over a 7.5 s trailing window, greedy decode, drained before the final transcription; never inserted. |
| GAP-STT-05 | Local STT | The bundled sidecar lacked faster-whisper's Silero VAD data, so `vad_filter=true` transcription would have failed at runtime even with the engine bundled. | `apps/desktop/scripts/build-sidecar.mjs`, `scripts/ci/verify-sidecar-bundle.mjs` | `[x]` 2026-09-18: `--collect-all faster_whisper` plus a packaging-time presence check for `assets/silero_vad_v6.onnx`. |
| GAP-REL-03 | Release | 서명이 없어 설치할 수 있는 경로가 없다(인증서 발급 전 공백). | `.forgejo/workflows/portable.yml`, `scripts/ci/build-portable.mjs`, `scripts/local/install-d3ro-voice.ps1`, `bucket/d3ro-voice.json` | `[x]` 2026-09-18: 서명 없는 portable 채널 구현 — 95MiB 7z 분할 볼륨(688MB → 162MiB) + Scoop 버킷 + 수동 설치 스크립트를 Forgejo에 게시. 실제 설치 스크립트 end-to-end 검증(볼륨 다운로드 → SHA-256 → 결합 → 해제 → 엔진 포함 확인). updater feed는 건드리지 않음. **2026-09-19: `1.3.7`이 CI portable run#64에서 `portable-latest`에 게시됨**(7z 단일 볼륨 83.7MB + zip 2부, `portable.json`=1.3.7) — 즉 portable 경로는 CI만으로 동작하고, 실패한 것은 마지막 증거 업로드 단계다(GAP-REL-11). |
| GAP-REL-04 | Release | canonical feed는 Cloudflare 뒤에 있어 업로드 본문이 **100MiB**를 넘으면 HTTP 413으로 거부한다. | `scripts/ci/build-desktop-installer.mjs`, `docs/deployment/unsigned-distribution.md` | `[~]` 2026-09-18: 설치본을 90.6MiB로 줄여 업데이트 피드 게시를 복구했다(GAP-STT-07). 휴대용/Scoop 채널은 여전히 95MiB 분할이 필요하다. |
| GAP-STT-07 | Local STT | 진(사이드카)을 앱 번들에 넣으면 설치본이 100MiB를 넘고 매 업데이트마다 162MiB를 다시 받는다. | `apps/desktop/src/main/services/RuntimeProvisioner.ts`, `apps/desktop/electron-builder.yml` | `[x]` 2026-09-18: 설치본에서 엔진/ffmpeg를 제거하고 처음 필요할 때 `runtime-latest`에서 내려받는다(부품별 + 결합본 SHA-256 검증). 설치본 189MB → 90.6MiB, 런타임 1회 116MiB(엔진 94.4 + ffmpeg 21.7). 실제 feed로 통합 검증 완료. |
| GAP-STT-06 | Local STT | Decode settings were untuned: previous-text conditioning let repeated hallucinations compound, and no VAD parameters meant slow, uneven segments. | `apps/desktop/sidecar/main.py` | `[x]` 2026-09-18: `condition_on_previous_text=false`, bounded low-temperature fallback, `no_speech`/`compression_ratio`/`log_prob` thresholds, 300 ms silence trimming. Same transcript, ~5x faster on the reference machine (7.7 s audio: 1609 ms → 303 ms). |
| GAP-KEY-01 | Key bindings | 키바인딩 전면 개편(CAP-16)이 실앱 구동으로 검증되지 않은 상태였다. uiohook 전역 후킹, 더블프레스 타이밍, 마우스 버튼 수신을 실행 중인 Electron 에서 확인한 적이 없었고, 증거가 계약 수준(`packages/core` 117개 통과, 키바인딩 파일 타입 에러 0건)뿐이었다. 에이전트는 데스크톱 GUI 를 띄울 수 없다(`AGENTS.md` §3). | `apps/desktop/src/main/services/KeyBindingService.ts`, `apps/desktop/tests/main/services/KeyBindingService.test.ts`, `packages/core/__tests__/keybinding.test.ts` | `[x]` 2026-09-21 Windows 실앱 구동 검증 + **2026-10-30 `KeyBindingService.test.ts` 11개 유닛 테스트 추가 완료**(키보드·마우스 훅, `uiohookCodeToVk`, `powerMonitor` 잠금 해제, MB1 거부, MB2/MB3 수정자 필수, MB4/MB5 단독·복합 마우스업 해제, hold-to-talk vs 더블프레스 핸즈프리 분리, 다중 바인딩, 제안 오버레이 캡처 가속기 등록/해제 전수 통과). macOS/Linux 마우스 매핑만 GAP-KEY-02 로 추적. |
| GAP-KEY-02 | Key bindings | 마우스 버튼 지원이 **Windows 기준으로만** 설계·확인됐다. `KeyBindingService` 에는 마우스 관련 플랫폼 분기가 없고(`process.platform` 은 meta 수정자 라벨 표기에만 쓰인다), macOS/Linux 에서 uiohook 이 보고하는 X1/X2 버튼 번호와 OS 기본 "뒤로/앞으로" 동작과의 간섭은 확인하지 않았다. 마우스 이벤트는 suppress 가 불가능하므로 원래 동작이 항상 함께 실행된다. | `KeyBindingService.ts:235`(`readMouseButton`), `:301`(meta 라벨 분기), `packages/core/src/keybinding.ts:561-612`(마우스 카탈로그 5종). 2026-09-21 실앱 검증(GAP-KEY-01)은 **Windows 에서만** 이뤄졌고 거기서는 MB4/MB5 가 정상 동작했다. | macOS/Linux 에서 MB2~MB5 수신 여부와 버튼 번호 매핑을 확인하고, 다르면 카탈로그를 플랫폼별로 분기한다. |
| GAP-KEY-03 | Key bindings | `command` 액션에 전용 핸들러가 없다. 이번에 처음으로 설정 UI 에 노출됐지만, 트리거되면 dictation 파이프라인으로 fallback 하며 `KEYBINDING_ACTIONS` 의 `holdMode:false` 대신 dictation 과 같은 hold-to-talk 로 강제된다. 개편 이전부터 같은 동작이었고 이번 작업은 그 사실을 코드에 명시화만 했다(기능 변화 없음). | `apps/desktop/src/main/services/voice-intent.ts`, `VoiceModeService.ts`, `tests/main/services/voice-intent.test.ts` | `[x]` 2026-10-30: `resolveGestureHoldMode` 및 `VoiceModeService`에서 `command` 액션이 `KEYBINDING_ACTIONS`의 `holdMode: false`(토글)와 hold-to-talk를 모두 지원하도록 예외 강제를 제거하고, `actionId === 'command'` 세션에서는 일반 받아쓰기 설정과 무관하게 음성 명령 매칭(`VoiceCommandService.match`) 및 LLM 후처리(`defaultLLMAction === 'none'`일 때 `'refine'` 폴백)를 수행하도록 전용 경로를 구현했다 (`voice-intent.test.ts` 19/19 통과). |
| GAP-QA-02 | Quality | 캡션 테스트 2건이 **개발 머신에 사이드카 venv 가 있는지에 따라 결과가 갈린다**. `LocalSTTService.initialize()`(`:239`) → `_ensureSidecarRunning()`(`:583`) → `_spawnSidecar()`(`:650`) → `_waitForHealth()`(`:794`) 경로에서 venv 가 존재하면 실제 Python 프로세스를 띄우고 health 폴링이 vitest 기본 타임아웃 10초를 넘긴다. venv 가 없으면 `getSidecarCommand()`(`apps/desktop/src/main/utils/paths.ts:174`)가 즉시 throw 해서 같은 테스트가 빠르게 통과한다. 테스트가 로컬 환경을 격리하지 못한 것이 결함이다. | `apps/desktop/tests/red/harness.ts`, `tests/red/{ipc-surfaces,silent-errors,rag}.usecase.test.ts`, `tests/main/utils/paths.test.ts` | `[x]` 2026-10-30: `tests/red/harness.ts`의 `useRedHarness()`에서 `LocalSTTService.prototype.initialize`/`ensureSidecar` 및 오프라인 `fetch`를 기본 스텁 처리해 로컬 Python venv·임베딩 서버 유무와 무관하게 결정론적으로 실행되게 격리했고, `paths.test.ts`의 에러 문구 정규식도 일치시켰다 (`paths.test.ts`, `ipc-surfaces.usecase.test.ts`, `silent-errors.usecase.test.ts`, `rag.usecase.test.ts` 총 60개 테스트 1.8초 내 전수 통과). |
| GAP-QA-03 | Quality | 데스크톱 `test`와 `test:unit`이 같은 전체 Vitest 를 실행하고, STT export 모의 누락·Electron 모의 중복·오래된 built-in/UIA 기대값으로 35개가 상시 실패해 전체 테스트가 게이트 역할을 하지 못했다. | `apps/desktop/vitest.config.ts`, `apps/desktop/package.json`, `tests/red/{voice,conversation}.usecase.test.ts`, `tests/main/windows/popup-redteam-r2-3.test.ts`, `tests/main/services/input-telemetry-stale-snapshot.test.ts`, `tests/main/sync/sync-redteam-r1-0.test.ts` | `[x]` 2026-10-31: STT 부분 모의가 실제 export 를 보존하고, 팝업 복구 테스트를 기존 팝업 하네스로 통합했으며, built-in 6개와 합성 유니코드 키 무시 계약을 기대값에 반영했다. 하나의 Vitest 설정에 `unit`/`service`/`integration`/`eval`/`all` mode 를 두고 기본 `test`는 오프라인 `unit`+`service`만 실행한다. 검증: `test:unit` 286, `test:service` 2478, 기본 `test` 2764 전부 통과; `test:all` 2788 통과·10개 환경 의존 테스트 skip·0 실패; typecheck·변경 파일 ESLint·build·`git diff --check` 통과. 외부 Ollama/Supabase 실행은 환경 변수가 없어 미검증이다. |
| GAP-QA-04 | Desktop QA | updater의 native consent/restart dialogs는 로케일·분기 자동화만 있고 packaged GUI 외형/상호작용 증거가 없었다. | `apps/desktop/src/main/update-dialog-preview.ts`, `src/main/index.ts`, `tests/main/{update-dialog-preview,index-update-dialog-preview}.test.ts` | `[~]` 2026-11-04: 명시적 `--preview-update-dialogs` 실행은 protocol/single-instance/bootstrap/updater/feed/download/install/settings 경로를 건너뛰고 실제 prompter의 네 다이얼로그만 순서대로 띄운 뒤 종료한다. current-source package와 native ABI, entry/prompt tests는 통과했다. 남은 게이트는 interactive desktop의 external terminal에서 packaged executable을 이 인자로 실행해 네 다이얼로그의 문구·버튼·required/optional 동작을 눈으로 확인하는 것이다. |
| GAP-I18N-01 | i18n | 로케일별 키 수가 크게 어긋난다. 2026-09-21 실측: `ko` 1716 / `en` 1709 / 나머지 10개 로케일 각 327. `keybinding.*` 55개는 12개 로케일 전부에 동일하게 들어갔지만, 그 밖 약 1,380개 키가 비영어 로케일에 없어 폴백 체인(locale → `en` → `ko`)으로 표시된다. 키바인딩 작업 이전부터 있던 부채이며 그 작업 범위 밖이었다. | `packages/i18n/src/locales/*.json`, `scripts/ci/sync-i18n-locales.mjs`, `apps/desktop/tests/main/services/i18n-locale-parity.test.ts` | `[x]` 2026-10-30: `scripts/ci/sync-i18n-locales.mjs`로 12개 로케일(`ko`, `en`, `ja`, `zh`, `zh-TW`, `es`, `fr`, `de`, `pt`, `ru`, `vi`, `th`) 전체를 동기화하고 키 누락 회귀를 차단했다. **2026-11-04:** updater dialog 16키 추가 후 2,742개 마스터 키, `i18n-locale-parity.test.ts` 15/15 통과. 표면별 언어 노출은 별도 `GAP-I18N-03`으로 추적한다. |
| GAP-I18N-02 | i18n | 렌더러가 `ko.json` 에 없는 `license.*` 키를 쓴다. `TranslationKey` 가 `ko.json` 에서 파생되므로 누락은 타입 에러로 드러난다. 타입 에러로만 끝나지 않는다 — 폴백 체인이 `locale → en → ko → 키 문자열` 이므로 마스터 로케일에도 없으면 **`license.team` 같은 키가 화면에 그대로 노출된다**. 2026-09-21 실측: `license.feature.premium_llm`·`license.team`·`license.enterprise` 가 없고 이로 인한 TS2345 가 4건이다. HEAD 에서도 없던 키이므로 선재 결함이며 키바인딩 작업과 무관하다. | `apps/desktop/src/renderer/components/UpgradePromptModal.tsx:47`·`:192`, `apps/desktop/src/renderer/pages/DashboardPage.tsx:481`·`:529`, `packages/i18n/src/locales/ko.json` | `[x]` 2026-09-28: 세 키 + `license.feature.cloud_sync`·`team_workspace` 를 ko·en 에 추가하고, 문자열 조립 대신 `renderer/utils/display-labels.ts`(featureLabelKey·tierLabelKey) 타입 매핑으로 바꿔 누락이 컴파일 오류가 되게 했다. `LicenseTab`·`LicenseModal` 의 TFunction TS2322 와 `currentTier` 미정의(팀·엔터프라이즈에서 설정 화면이 멈추던 결함)도 수정. 12개 로케일 전체 동기화 완료(GAP-UX-07, GAP-I18N-01). |
| GAP-LLM-01 | LLM | **번역 대상 언어를 사용자가 고를 수 없다.** 항상 `English` 고정이다. `AppConfig` 에 대상 언어 키가 없고, 기존 두 키 모두 대용할 수 없다 — `language` 는 UI 로케일이라 `'ko'` 같은 코드가 프롬프트에 그대로 들어가 문장이 깨지고, `sttLanguage` 는 입력(원문) 언어라 그 값으로 번역하면 원문이 그대로 나온다. 2026-09-21 LLM 수정(`9c2b4d4`)은 대상 언어가 호출 프레임 두 단계 밖의 기본값에 의존하던 것을 명시 인자로 바로잡았을 뿐, 선택지를 만들지는 않았다(설정 키 + 설정 UI + i18n 이 필요해 patch 범위 밖으로 뒀다). | `packages/core/src/types.ts`(`AppConfig.targetLanguage`), `ConfigService.ts`, `llm-prompts.ts`(`SUPPORTED_TARGET_LANGUAGES`, `resolveTargetLanguage`), `SettingsModal.tsx`, `tests/main/services/llm-prompts.test.ts` | `[x]` 2026-10-30: `AppConfig.targetLanguage`(기본값 `'English'`)를 추가하고, `resolveTargetLanguage(explicit)`가 설정값을 읽도록 연결했으며, `SettingsModal.tsx` 후처리 섹션에 12개 번역 대상 언어 선택 드롭다운과 12개 로케일 번역 키(`settings.targetLanguage.*`)를 추가했다 (`llm-prompts.test.ts` 43/43, `i18n-locale-parity.test.ts` 15/15 통과). |
| GAP-LLM-02 | LLM | **2026-09-21 LLM 지시문 수정(`9c2b4d4`)이 실앱 구동으로 검증되지 않았다.** 유닛 테스트는 통과하지만(`llm-prompts.test.ts` 21, `llm-handlers.test.ts` 7, `VoiceModeService.test.ts` 22, `ChainService.test.ts` 5 — 수정 4건을 각각 되돌려 실제로 실패하는 것까지 확인), 실행 중인 Electron 에서 실제 지시문을 돌려 결과가 삽입되는 것을 본 적이 없다. 에이전트는 데스크톱 GUI 를 띄울 수 없다(`AGENTS.md` §3). **게다가 이 수정과 직접 관련된 usecase 테스트 4개가 실행조차 되지 않았다** — `tests/red/{instruction,chain,voice,config}.usecase.test.ts` 가 `better-sqlite3` ABI 불일치로 DB 생성 단계에서 먼저 죽는다(GAP-INFRA-06). 즉 그 범위는 통과도 실패도 아닌 **미검증**이다. 영향 받는 카탈로그 행: AI-04, AI-05, AI-06, AI-07(전부 데스크톱 `[~]`). | `apps/desktop/src/main/services/llm-prompts.ts`, `VoiceModeService.ts:779`·`:827-870`, `ChainService.ts:196`, `src/main/ipc/llm-handlers.ts:96`, `src/renderer/pages/CommandsPage.tsx:180-205` | **2026-10-30:** `rebuild:test`·`harness.ts` 격리로 `tests/red/{instruction,chain,voice,config}.usecase.test.ts` 4종이 모두 실행·통과함을 확인했다. 남은 것은 사용자가 `run-desktop.bat` 로 앱을 띄워 실제 받아쓰기 삽입을 눈으로 확인하는 수동 검증뿐이다. |
| GAP-INFRA-06 | Dev env | `better-sqlite3` 네이티브 ABI 가 **앱 실행과 로컬 테스트에서 서로 다른 값을 요구**한다. Electron 33 은 ABI 130, 호스트 Node 23 은 ABI 131 이라 한쪽에 맞추면 다른 쪽이 깨진다. | `scripts/ci/verify-native-abi.mjs`, `scripts/ci/fix-native-abi.mjs`, `package.json`, `apps/desktop/package.json` | `[x]` 2026-10-30: `fix-native-abi.mjs --in-place`를 확장하고 루트 및 `apps/desktop/package.json`에 `rebuild:app`(Electron ABI 전환)과 `rebuild:test`(호스트 Node ABI 전환, `npm rebuild better-sqlite3`) 스크립트를 추가했다. |
| GAP-STT-08 | Local STT | 1.3.5 설치본에서 엔진 설치가 "런타임 아카이브 해시 불일치 (sidecar)"로 항상 실패했다. 부품 검증은 **메모리 스트림**에서 센 값으로, 결합 검증은 **디스크 파일**에서 계산해 기준이 서로 달랐다. 디스크 쓰기가 잘려도 부품 검사를 통과하고 결합 단계에서만 터지므로 원인 파악도 불가능했다. 재시도가 없어 전송이 한 번 끊기면 곧바로 설치 실패였다. | `apps/desktop/src/main/services/RuntimeProvisioner.ts` | `[x]` 2026-09-18: 부품 크기·해시를 디스크 파일 기준으로 통일하고, 결합본은 크기를 먼저 검사한 뒤 해시를 본다(오류 메시지에 실제/기대값 포함). 부품 다운로드는 실패 시 해당 파일을 지우고 최대 3회 재시도한다. 서버 아티팩트는 무결함을 확인했고(부품 2개 해시 일치, 결합본 `e203aa53…` = 인덱스 기대값), 실제 feed로 설치를 재현해 18초 만에 성공. **1.3.6으로 게시 완료** — `latest.yml`이 1.3.6/90.6MiB를 서빙하고 설치본 sha512가 피드 메타데이터와 일치. 설치본 asar에 수정 코드가 포함되고 구버전 `archiveHash` 경로는 제거됨을 확인. |
| GAP-INFRA-05 | Build | 패키징된 렌더러 팝업 스크립트가 번들에 없었다. 팝업 HTML이 classic `<script src="./script.js">`를 참조해 Vite가 처리하지 않았고, dev에서는 로드되지만 설치본에는 파일이 없었다. 그래서 녹음 오버레이가 0:00에서 멈추고 웨이브 바가 뜨지 않았으며 실시간 자막이 렌더되지 않았다. 로드 전 `webContents.send`가 조용히 버려지는 문제와 `hide()` 이후 재표시의 z-order/repaint 유실도 함께 있었다. | `apps/desktop/src/renderer/popups/*/index.html`, `apps/desktop/src/main/windows/WindowManager.ts`, `scripts/ci/verify-desktop-renderer-bundles.mjs` | `[x]` 2026-09-19: 팝업 5종을 `type="module"`로 전환해 Vite가 해시된 번들로 방출하도록 고쳤고, 빌드 HTML이 참조하는 모든 로컬 asset이 디스크에 있는지 검사하는 `verify-desktop-renderer-bundles.mjs`(+ self-test)를 `.forgejo`/`.github` 패키징 파이프라인에 연결했다. WindowManager는 렌더러 준비 전 IPC를 `did-finish-load`까지 보관하고, 팝업을 표시할 때마다 topmost 재선언 + 강제 repaint를 수행하며, 팝업 렌더러 콘솔/로드 실패를 main 로그로 승격한다. |
| GAP-INPUT-01 | Input intelligence | **2026-09-22 10:57 실사용 검증 성공** — 카톡 타이핑 중 제안 5개 생성(1436ms)이 로그로 확인됐고(조합 중·idle 25ms에서도), 50초 관찰에 스냅샷 67건/생성 3회/실패 0건이었다. 남은 확인: 오버레이 위치·외관, 수락 삽입, 비밀번호 차단, 주간 수치 48개 유닛 케이스는 정책/집계/프롬프트 같은 순수 함수만 덮는다. 검증되지 않은 것: (1) `Alt+Shift+←` 수락이 실제 앱에 문장을 삽입하는지, (2) 오버레이가 케어렛 옆에 붙는지(케어렛 rect Chromium 에서만 UIA 로 얻어지고 네이티브 Win32 앱은 `GetGUIThreadInfo` 경로가 아예 없다), (3) `TypeError` 없이 Electron 메인에서 `koffi` 가 로드되는지(현재 호스트 Node 에서만 확인), (4) PyInstaller 번들에 `uiautomation`/`comtypes` 가 실제로 들어가는지(`build-sidecar.mjs` 에 `--collect-all` 을 추가했지만 번들을 다시 빌드해 확인하지 않았다). 에이전트는 데스크톱 GUI 를 띄울 수 없다(`AGENTS.md` §3). | `apps/desktop/src/main/services/{InputTelemetryService,SuggestionService,UiaContextService}.ts`, `apps/desktop/src/main/utils/win32-foreground.ts`, `apps/desktop/sidecar/{uia_bridge.py,requirements.txt}`, `apps/desktop/scripts/build-sidecar.mjs`, `apps/desktop/tests/main/services/input-intelligence.test.ts`(45) + `llm-prompts.test.ts`(+4) | **2026-09-21 23:13 부분 검증 완료** (사용자가 실제로 Notepad 에 타이핑한 로그): 텔레메트리 기동, uiohook 후킹, UIA 스냅샷(Notepad — `edit=true pw=false comp=false src=value`), WindowsTerminal 의 문서형 컨트롤을 `not-editable` 로 정확히 거부, 판단 로그까지 전부 실동작 확인. 이 과정에서 결함 4건을 잡아 고쳤다: (a) 트리거 지연(1000ms)이 스냅샷 디바운스(700ms)보다 커서 **"멈춘 뒤" 게이트가 결코 열리지 않던 문제**(settle 패스 추가), (b) 켜 둔 상태로 앱을 켜면 워밍업이 한 번도 안 돌던 문제(부팅 시 워밍업 + 가용성 폴링 대기 재시도), (c) 케어렛 오프셋을 못 주는 앱에서 문서 전체를 접두로 쓰던 문제(tail 폴백), (d) 후보가 도착해야 오버레이가 떠서 "아무것도 안 나옴" 으로 보이던 문제(요청 즉시 "생성 중" 표시). **2026-09-22 09:00~09:17 추가 실측** (사용자가 KakaoTalk·WindowsTerminal·Agent Switchboard 에 타이핑한 17개 스냅샷): 편집 가능으로 판정된 것은 3건뿐이고, 그중 KakaoTalk 입력창은 `edit=true src=value` 인데도 `len=0` 이라 실제 내용을 못 읽었다 — 커스텀 렌더 앱(카톡·터미널·에이전트 UI)에서는 UIA 가 텍스트를 노출하지 않는다. 즉 "아무것도 안 나옴" 의 상당 부분은 결함이 아니라 **읽을 수 없는 앱에서의 정상 동작**이며, 이 구분이 사용자에게 보이지 않던 것이 문제였다. 그래서 설정 > 입력에 **실시간 진단 줄**(포커스 앱 · 읽기 가부 · 소스 · 글자 수 · 비밀번호/케어렛 폴백 표시)을 추가하고 12개 로케일에 문구를 넣었다. 남은 확인: 오버레이의 실제 위치·외관, `Alt+Shift+←` 수락 삽입, 비밀번호 필드 차단, 주간 수치 정확도. 함께: `sidecar:build` 후 `GET /uia/focus` 응답을 확인하고 그 결과를 `scripts/ci/verify-sidecar-bundle.mjs` 의 필수 항목에 반영한다. **검증 도구 주의**: 데스크톱 `npm run typecheck` 는 문서화된 대로 no-op 이라(GAP-INFRA-04) 이번 작업에서도 거짓 통과를 냈다 — `typecheck:strict` 로 다시 돌려 이 작업이 만든 타입 오류 7건(core 에 없는 `InputTelemetryState` 참조 5건 등)을 찾아 고쳤다. 현재 strict 기준 이 작업 파일들의 오류는 0건이다(main 13 / renderer 35 는 전부 선재). |
| GAP-INPUT-07 | Input intelligence | `[~]` **2026-09-23 focused automated evidence:** five test files / 80 tests passed; desktop typecheck/lint, Python `py_compile`, and `git diff --check` exited 0 (the core 131-test pass is earlier independent evidence). The overlay lifecycle and `windowsHide:true` child-process audit are code/automation evidence only, not Electron GUI or external-app insertion proof. | `InputTelemetryService.ts`, `SuggestionService.ts`, `KeyBindingService.ts`, `components/input-insights/{InputConsentPanel,InputInsightsView}.tsx`, `popups/suggestion-overlay/`, `tests/main/services/{input-flow-domain,input-flow-services,windows-child-process-hide}.test.ts` | From an external terminal restart with `run-desktop.bat`, verify: (1) click X during generation closes immediately and never reappears; (2) selecting text closes the overlay; (3) input-focus loss closes it; (4) TTS, voice action, audio enumeration, screen context and file transcription do not revive a cmd/PowerShell window. Retain the existing editable/read-unavailable/password, Flow Radar/Edit Friction/App Quality, receipt, Smart Exclusion, provenance/fallback, shortcut-audit and narrow-geometry checks. Automated tests do **not** replace this manual proof. |
| GAP-INPUT-02 | Input intelligence | **IME 조합 중 텍스트(preedit)는 수집되지 않는다.** 우리는 조합 중에는 통계·제안을 모두 억제하고 조합이 끝난 커밋 텍스트만 UIA 로 읽는다. 조합 문자열 자체를 읽으려면 `IUIAutomationTextEditPattern::GetActiveComposition`(또는 레거시 앱은 IME `ImmGetCompositionStringW`)이 필요하다. KeyType.Windows 도 이 부분을 명시적으로 다음 사이클로 미룬다 — 즉 업계 공통 미해결 지점이다. 조합 중 억제 자체는 MS Learn 의 IME 문서상 필수 조치이며 구현돼 있다. | `apps/desktop/sidecar/uia_bridge.py`(`_caret_rect_and_offset` 의 TextEditPattern 블록), `packages/core/src/input-intelligence.ts`(`decideSuggestion` 의 `composing` 분기) | 조합 범위를 읽어 "조합 중 미리보기"를 제안 후보로 쓸지 검토한다. 지금은 억제만 하고 있어 한국어 사용자는 조합을 끝내야 제안이 뜬다. |
| GAP-INPUT-03 | Input intelligence | **공백이 없는 언어(중국어)는 단어 수가 과소 집계된다.** `countWords` 가 공백 분리 토큰을 세므로 "今天开会讨论了三件事" 는 1단어로 계산된다. 한국어/영어/일본어(공백 사용)는 정상이다. | `packages/core/src/input-intelligence.ts`(`countWords`), `packages/core/src/text-segmentation.ts`(`countLexicalWords`), `apps/desktop/tests/main/services/input-intelligence.test.ts` | `[x]` 2026-10-30: `countWords`가 `countLexicalWords`(`Intl.Segmenter` 단어 분절 + CJK 폴백)를 호출하도록 수정해 중국어·일본어·태국어 무공백 문장의 단어 수를 정확히 집계한다 (`input-intelligence.test.ts` 68/68 통과). |
| 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,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 통과. |
| GAP-INPUT-09 | Input intelligence | `[~]` **prefill 이어 쓰기·문서/대화 문맥(INPUT-21) 실앱 확인 (2026-10-03).** 실제 `gemma4:e4b` 프로브 15개 시나리오와 단위 테스트는 통과했지만, (a) 외부 앱 UIA 가 커서 앞 문서 전체를 주는지(케어렛 미상 앱은 tail 폴백), (b) 채팅 앱이 보내기 뒤 입력칸을 실제로 비우는 스냅샷을 내는지(카톡은 UIA 텍스트 길이 0 인 경우가 있었다 — GAP-INPUT-01), (c) 단어 중간 수락(`attach`)이 실제 삽입에서 공백 없이 붙는지는 GUI 로 확인하지 않았다. 후보 다양성: 마저 쓰기 모드는 prefill 분포가 뾰족해 채우기 후보가 1~2개에서 멈출 때가 많다. | `apps/desktop/src/main/services/{SuggestionService,InputTelemetryService,LocalLLMService,llm-prompts}.ts`, `packages/core/src/{chat-template,recent-writes,suggestion-text,writing-context}.ts`, `apps/desktop/tests/integration/suggestion-quality.ollama.test.ts` | `run-desktop.bat` 재시작 후: (1) 긴 메모장 문서 끝에서 앞부분의 날짜·이름을 이어 받는지, (2) 슬랙/디스코드 같은 Chromium 채팅에서 메시지를 보낸 뒤 다음 메시지 제안이 앞 메시지를 이어 받는지(로그 `제안 판단 입력` + 프롬프트 길이), (3) `내일 3시에 회의실` 같은 단어 중간에서 수락하면 `회의실에서…` 로 붙는지, (4) 지어낸 사실로 후보를 버린 로그(`제안 후보 버림 (unsupported-facts…)`)가 과하게 잦지 않은지. 모델 교체 시 `D3RO_SUGGESTION_PROBE=1 D3RO_SUGGESTION_PROBE_MODEL=<태그>` 로 같은 프로브를 다시 돌린다. **2026-10-03 19:00 "제안 창이 잘 안 뜸" 로그 분석**: 보류 1위 WindowsTerminal(Claude Code) `caret-unknown` 721회 — 입력 상자 아래 상태줄 때문에 화면 전체 기준으로 매번 "문서 중간 편집" 판정 → `SuggestionService._terminalContext` 가 입력 줄 연속성(늘거나 줄면 커서=끝)으로 판단. 2위 Chrome `not-typing` 122회 — 타이핑 중 UIA 포커스가 입력칸↔legacy 요소를 오가며 기준선을 다시 잡음 → 같은 창·클릭 없이 치는 중의 깜빡임이면 편집한 칸 유지(`input-telemetry-focus-flicker.test.ts`). 모든 앱에서 caret 오프셋을 못 얻는 것(caret=-1)과 Kitedesk/Candy/Paca 의 legacy(읽기 불가)는 별도 과제. 19:10 재시작 뒤 6분간 첫 후보 10회 생성(터미널 caret-unknown 721→4). **수락 키 전달 문제**: uiohook 은 키를 엿듣기만 해서 Ctrl+Alt+Enter 가 Claude Code 에도 전달돼 개행이 들어갔다 → 제안 창이 떠 있는 동안만 제안 단축키를 globalShortcut(noop)으로 잡아 OS 가 삼키게 하고 창이 사라지면 해제(`KeyBindingService.setSuggestionCaptureActive`, `suggestionCaptureAccelerators`). 실앱에서 수락 시 개행이 더는 안 들어가는지, 창이 없을 때 다른 앱의 Ctrl+Alt+Enter/↑↓ 가 정상인지 확인 필요. |
| GAP-INPUT-11 | Input responsiveness | `[~]` **2026-10-30..31 사용자 보고: 모델 최초 로드/높은 CPU 부하 및 터미널(`Agent Switchboard.exe` `xterm.js` 등) 환경에서 한글 타이핑 누락 (`안녕하세요` → `안세요`, 터미널 1글자씩 씹힘) 및 `Ctrl+Alt+Enter` 수락·최적화(`v1.15.2`).** (1) **결정적 원인 규명 및 수정:** 한국어 두벌식 입력에서 받침 뒤 다음 음절 초성을 치는 순간(`"안ㄴ"`, `"안녕ㅎ"`, `"한ㄱ"` 등) `detectJamoNoise`가 커서 끝 초성을 낱자 잡음(`from: "안ㄴ", to: "안"`, `deleteCount: 2`)으로 오판하고, 모델이 아직 콜드(`warmModel() === null`, 모델 최초 로드 시점)일 때 `TypoCorrectionService.handleTypingContext`가 650ms 모델 디바운스를 건너뛰고 즉시 `replaceBeforeCaret(2, "안")`을 실행해 방금 완성된 `"안녕"`을 `"안"`으로 덮어써 `"안녕하세요"`가 `"안세요"`가 되거나 새 어절 첫 자음(`"오늘 ㅇ"`)이 백스페이스로 지워지던 버그를 수정했다(`packages/core/src/typo-correction.ts` 커서 끝 초성 보호 + `TypoCorrectionService.ts` 커서 직전 토큰 자동 삭제 차단). (2) 코드에서 오래된 UIA 문맥·삽입 큐 대기 후 재검증 누락·부분 SendInput 성공 뒤 삭제 재실행 위험을 확인하고 보호 장치를 추가했으며, 로컬 Ollama/Whisper 작업 수도 최대 4개로 제한했다. (3) **2026-10-31 터미널·`xterm.js` 1글자씩 씹힘(`03:04:11~03:04:48` 실로그 규명) 수정 (`v1.15.1`):** 터미널에서 `TextInsertService`가 키를 한 번도 보내지 않았는데도 한글이 1글자씩 씹히던 직접 원인이 ① `InputTelemetryService._handleKeyDown`에서 터미널일 때만 매 키다운마다 호출하던 크로스-프로세스 `isForegroundKoreanIme`(`SendMessageTimeoutW(WM_IME_CONTROL)`)와 ② 40ms 경계 스냅샷·800ms 폴링마다 `uia_bridge.py`가 `xterm-helper-textarea`에 대해 호출하던 `GetTopLevelControl()`·`TextPattern.GetSelection()`·`ExpandToEnclosingUnit(Character)`·`TextEditPattern.GetActiveComposition()`(Chromium 렌더러 스레드 최대 1,500ms 블로킹 및 `comp=True` 고착)이었음을 확인하고, 키다운 중 `WM_IME_CONTROL` 호출 제거(유휴 스냅샷 1회 동기화 `syncKoreanIme`), `uia_bridge.py` `xterm-helper-textarea` 고속 경로(`TextPattern` 생략) 및 `_WAKE_TTL_SECONDS` 86,400초 연장, 일반 한글 단어 공백 직후 40ms 스냅샷·680ms 중복 타이머·800ms 터미널 폴링 억제, 터미널 내 공백 전 완성형 한글 음절(`[가-힣]$`) 교정 억제를 적용했다. (4) **2026-10-31 실로그(`04:03:07~04:17:12`) 추가 규명 및 `Ctrl+Alt+Enter`·최적화 (`v1.15.2`):** ① `classifyKeyStroke`가 수정자 플래그를 수정자 VK 코드보다 먼저 검사해 `Ctrl`/`Alt` 단독 눌림·키 반복이 `'shortcut'`(`key=shortcut+C+A`)으로 분류되어 `TerminalKeystrokeTracker` 버퍼를 초기화하고 `Enter` 입력 전 제안 창을 닫던 버그 수정, ② `ChordStateMachine.keyUp`이 공유 수정자(`Ctrl`/`RightAlt`) 해제 시 첫 바인딩(`command`)만 해제하고 중단해 `suggestion-accept`(`Ctrl+Alt+Enter`)가 `_isDown`에 고착되던 버그 수정, ③ `KeyBindingService`에 `UiohookKey.NumpadEnter` 매핑 및 OS `globalShortcut` 캡처 25ms 폴백 트리거 추가, ④ `"생성 중..."` 또는 첫 후보 스트리밍 중 `Ctrl+Alt+Enter` 입력 시 첫 후보 완성(최대 2.5s) 즉시 수락(`_waitForFirstCandidate`), ⑤ 터미널(`terminalMode` / `isTerminalApp`) 제안 수락 시 `Ctrl+V` 클립보드 복원 경합 대신 `insertMethod = 'keyboard'`(`KEYEVENTF_UNICODE`) 직접 주입 및 `applyProgrammaticReplacement` 동기화, ⑥ 비타이핑 키·짧은 입력에서 780ms 중복 `_settleTimer` 취소 및 `TypoCorrectionService.propose`의 기검사 구간(`_isRegionChecked`) 중복 336토큰 LLM 호출 차단. **추가 deterministic A/B:** 3개 서비스만 HEAD `f49acf0`로 대체하고 나머지 의존성·테스트는 현재 상태를 유지한 비교에서 HEAD 1/17, 수정본 17/17 통과. | `packages/core/src/{input-intelligence,typo-correction,terminal-prompt,keybinding-runtime}.ts`, `InputTelemetryService.ts`, `KeyBindingService.ts`, `SuggestionService.ts`, `TypoCorrectionService.ts`, `TextInsertService.ts`, `utils/{win32-foreground,win32-input-activity,win32-unicode-input,inference-cpu-budget}.ts`, `sidecar/{uia_bridge,cpu_budget}.py`; `scripts/verification/typing-race-proof.mjs`, `packages/core/__tests__/{typo-correction,terminal-prompt,keybinding-runtime}.test.ts` (96/96), `TypoCorrectionService.test.ts` (29/29), `KeyBindingService.test.ts` (12/12), `suggestion-accept-hold.test.ts` (4/4), `suggestion-typo-correction.test.ts` (8/8), `input-intelligence.test.ts` (68/68) | `typing-fixture`와 별도 로컬 프로필의 `typing-runtime` 빌드 완료, 단위·경합 A/B 테스트 전수 통과(`packages/core` 96/96, `TypoCorrectionService.test.ts` 29/29, `KeyBindingService.test.ts` 12/12, `suggestion-accept-hold.test.ts` 4/4, `suggestion-typo-correction.test.ts` 8/8, `input-intelligence.test.ts` 68/68, `typing-race-proof.mjs` 17/17). 2026-11-02: 설치본 1.16.0의 네이티브 한글 IME는 100% CPU와 `gemma4:e4b` 콜드 로딩(9.389초, 두 입력 사례와 실제 겹침)에서 각각 7/7 정확히 통과했다. 한영 자판 교정 대조군은 1/7만 통과하며 다음 키가 백스페이스 배치에 섞이는 결함을 재현했다. 소스는 경계 스냅샷 140ms 대기 + 650ms 유휴 시 현재 교정 영역 일괄 교정으로 수정하고 전체 데스크톱 2,773개 테스트·빌드를 통과했다. 2026-11-04: 수정본을 Windows v1.16.1로 빌드·서명·게시하고 공개 피드와 설치 파일 HTTP 200을 확인했다. **남은 것:** 1.16.1 설치 후 같은 Latin 대조군 재실행, 물리 키보드·Chromium/terminal 확인. 상세: `2026-11-02-verification.md`. |
| GAP-INPUT-10 | Input intelligence | `[~]` **제안 창 오타 교정·반응성(INPUT-22) 실앱 확인 (2026-10-17) 및 2026-10-30 조합 백스페이스/초성 유실 수정.** 단위 테스트·실모델 프로브·팝업 렌더 스크린샷은 통과. (1) 이력 DB 접두에 반복되던 홀로 남은 `ㅇ` 및 글자 삼킴은 커서 끝 초성(`"안ㄴ"`, `"오늘 ㅇ"`)에 대한 `detectJamoNoise` 조기 개입이 원인이었음을 규명해 차단했다(GAP-INPUT-11 참조). (2) Chrome·Electron 계열에서 UIA `GetActiveComposition` 미지원으로 `snapshot.isComposing`이 항상 `false`가 되어 마지막 글자 조합 중 교정/제안 수락 시 Space 확정 없이 백스페이스가 나가 MS IME가 자모 단위로 지우던(`안ㄴ안녕…`) 문제를 해결하기 위해, `InputTelemetryService`에서 키스트로크 기반 한글 조합 상태(`_imeComposing`)를 추적해 `context.isComposing`에 반영하고, `SuggestionService.accept()`도 `/[가-힣]$/u.test(acceptPrefix)` 및 `insertMethod === 'keyboard'` 프로그램 키 계산을 정밀화했다. | `apps/desktop/src/main/services/{SuggestionService,TypoCorrectionService,TextInsertService,InputTelemetryService}.ts`, `apps/desktop/src/renderer/popups/suggestion-overlay/*`, `packages/core/src/typo-correction.ts` | 에이전트 창·카톡·크롬에서: (1) `안ㄴ뇽하세여.?` 치고 멈추면 `오타 고침` 줄과 함께 후보가 뜨는지, 수락하면 오타가 지워지고 `안녕하세요.? …` 로 바뀌는지, (2) 마지막 글자가 조합 중일 때 수락해도 글자가 남거나 더 지워지지 않는지, (3) 수락 → Space → 멈춤에서 다음 제안이 바로 뜨는지(`rate-limited` 로그 없어야 함), (4) 후보 12개가 다 차도 창이 저절로 닫히지 않는지(45초 TTL 전), (5) 낱자 없는 오타는 첫 후보 뒤 교정 줄이 늦게 붙는지 실앱 수동 확인. |
| GAP-SYNC-01 | Sync | Desktop↔mobile sync was one-way and lossy. (1) `pushAll` set the cursor to *now* before `pullAll` ran, so the first pull after sign-in fetched nothing — mobile-created data never reached the desktop except via Realtime while running (which never connected, GAP-SYNC-02). (2) `_inArray` used only the first meeting id, so memos/documents of every other meeting were never pushed. (3) No deletion propagation either way. (4) Pull had no `user_id` filter — team meetings of other users landed in the personal DB and a desktop re-push cleared `team_id`. (5) One global, local-clock cursor across accounts; no pagination (1,000-row cap). (6) Desktop writes did not move `history.revision`, so mobile's optimistic concurrency silently overwrote desktop edits. (7) One case-duplicate dictionary word failed the whole batch. (8) Memo tags, custom commands, templates, favorites and history titles were not synced at all; anonymous local-mode data was never uploaded after sign-in. | `apps/desktop/src/main/services/sync/*`, `CloudSyncService.ts`, `server/supabase/migrations/20260927000034_cross_device_sync_parity.sql` | `[x]` 2026-09-27: engine rewritten (outbox + per-user server-clock keyset cursors + tombstones + per-row isolation + dictionary adoption + natural-key memo tags + client-keyed template RPCs + local-mode import). Evidence: `apps/desktop/tests/main/sync/SyncEngine.test.ts` (20) + `apps/desktop/tests/integration/cross-device-sync.supabase.test.ts` (5, local Supabase stack); full desktop suite 1499/1500 (1 = known caption env timeout); SQL checks for revision bump, tombstones, account-delete cascade. |
| GAP-SYNC-02 | Sync | **Desktop Realtime never connected.** Electron 33 main (Node 20.18) has no global `WebSocket`; supabase-js Realtime only ever logged `TIMED_OUT`/`CLOSED` (installed-app log 2026-09-16) and gave up after three retries. Also: filtered `postgres_changes` channels never deliver DELETE (Supabase limitation). | `CloudSyncService.ts`, `services/sync/realtime-transport.ts`, integration test "Realtime" case | `[x]` 2026-09-27: `ws` injected as the Realtime transport (`ws` now a declared desktop dependency, externalised in the main bundle); deletions arrive as `sync_tombstones` INSERT events; the heartbeat re-subscribes a channel that is not `joined`. Verified live against the local stack (INSERT/UPDATE + tombstone events received). |
| GAP-SYNC-03 | Portability | Mobile/cloud data export failed for any account with meetings or generated documents: `export_account_portability` used `to_jsonb(row)` while the v1 archive contract (server restore + mobile `exactKeys`) is a frozen key set, and later migrations added columns. | `server/supabase/migrations/20260927000034_cross_device_sync_parity.sql` §7 | `[x]` 2026-09-27: export projects each dataset onto its v1 keys; integration test asserts the memo/meeting key sets. |
| GAP-SYNC-04 | Mobile devices | Mobile `normalizeRegisteredDevice` rejected every platform except `android`/`ios`, so the first desktop/web device on an account would have made the whole Devices screen fail to load. | `apps/mobile-rn/src/features/devices/device-service.ts`, `screens/DevicesScreen.tsx` | `[x]` 2026-09-27: accepts the server platform list (`android/ios/web/windows/macos`), card shows the platform; `__tests__/devices.test.ts` 3/3, full mobile Jest 372/372. |
| 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. | `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}` | `[x]` **2026-11-13 마이그레이션·클라이언트·단위 검증 완료 → 2026-11-14 운영 DB 반영:** 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). **2026-11-14:** 운영 Supabase `supabase db push --remote`로 21개 보류 마이그레이션(`20260927000037`~`20261113000001`)을 반영하고 `supabase migration list --remote`에서 전체 74개 로컬=원격 일치를 확인했으며 데스크톱 `v1.17.1`도 함께 게시했다. |
| 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). |
---
## 2. Mobile checklist roll-up (from `MOBILE_APP_COMPLETION_SSOT.md` §4)
These are the mobile SSOT rows still `[ ]` / `[~]`. Do not duplicate the full text here; open the SSOT for detail.
| Group | Open rows | Theme |
|---|---|---|
| G (governance) | G-008..G-011; G-006/G-007 `[~]` | 2026-11-04 route/push contract typing and Talk logger improved; remaining type/error/identity consolidation, legacy bundle separation, credential rotation |
| A (auth/account) | A-001..A-013, A-018; A-014..A-017 `[~]` | Session restore, signup, deep links, OAuth, profile, provider E2E |
| 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-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 |
| Q (quality/release) | Q-012..Q-014, Q-019, Q-020, Q-022, Q-026; Q-010/Q-011/Q-021/Q-023/Q-027/Q-028 `[~]` | Current-source Fold6/API 34 state-preserving install, cold launch, Notifications cards, and bounded crash/UIA/font-scale/rotation automation are GREEN. Remaining: OAuth/billing/full journey; manual TalkBack and permission/FCM transitions, app-wide visual coverage, iOS, env unification, production AAB ([evidence](../evidence/2026-11-04-mobile-runtime-a11y.md)) |
---
## 3. External blockers (`EXT`) — require action outside the repo
| ID | Blocker | What is needed | Where tracked |
|---|---|---|---|
| EXT-FIREBASE-01 | No production Firebase project | Android FCM only; web/iOS can avoid Firebase (see push transport doc). Create project + Android app + Play fingerprint + FCM, or adopt UnifiedPush for Android. | SSOT EXT-011, `docs/deployment/push-transport-without-firebase.md` |
| EXT-ADMOB-01 | AdMob `검토 필요` / `광고 게재 제한` / store not linked / payment profile incomplete | Complete console review + store link + payment profile. Playwright tooling ready: `scripts/admob-login.mjs` (one interactive login on a visible desktop) then `scripts/admob-automate.mjs --apply` creates/verifies units and reports store link. Neither persisted profile is signed in yet. | SSOT §0, EXT-006 |
| EXT-PLAY-01 | Play Billing license tester + test payment method | Configure license testers | SSOT EXT-004 |
| EXT-PLAY-02 | Play product/offer/base-plan + tracks | Create Pro/Pro+ products and tracks | SSOT EXT-003 |
| EXT-PLAY-03 | Production AAB + CI secret injection + recovery backups | Inject Firebase/AdMob/signing/evidence CI secrets | SSOT EXT-008 |
| EXT-PLAY-04 | Closed test 0/12 members, 14 days; production access disabled | Run closed test, request production | SSOT EXT-010 |
| EXT-OAUTH-01 | GitHub/Apple provider secrets; real mobile Google consent→callback | Configure providers, verify consent | SSOT EXT-001 |
| EXT-APPSIGN-01 | Live App Links still old certificate | Deploy updated `assetlinks.json`, re-verify live | SSOT App Links row |
| EXT-PHYS-01 | Physical Fold6 share/OAuth/purchase and production-artifact evidence | Current-source E2E upgrade install/cold launch passed on 2026-11-04 without clearing data. Run real file share, OAuth, purchase/restore, and later the signed production artifact on device | SSOT EXT-009; [2026-11-04 evidence](../evidence/2026-11-04-mobile-runtime-a11y.md) |
| EXT-PAY-01 | Payple live history + webhook signature verification | Provider contract + signature scheme | SSOT M-027 |
| EXT-STRIPE-01 | ~~Production Stripe/Payple cross-verification~~ | **삭제됨 2026-09-26** — Stripe 제거. Payple 라이브 검증은 EXT-PAY-01 | SSOT M-013 |
| EXT-STT-01 | Production provider keys (Groq/OpenAI/Deepgram/Gemini) | Inject provider secrets | `apps/api-server/Program.cs` env docs |
| EXT-PROMO-01 | GeekNews Show GN 게시 대기 — 가입(2026-10-21, `yunchanpaca`) 후 7일 동안 글 등록 불가 | **2026-10-28 이후** 초안 그대로 게시(사용자 승인 완료). 등록 시 Cloudflare 확인 체크는 사용자가 직접. 게시 전 데모 GIF(15초) 있으면 첨부 | `docs/marketing/geeknews-draft.md`, `docs/marketing/launch-kit.md` |
| EXT-PROMO-02 | Google 색인 확인 — `/` 마지막 크롤링이 2026-08-31 404였고 재방문 없음 | 2026-10-21 `/`·`/en/` 색인 생성 요청 완료. 며칠 뒤 Search Console '페이지' 보고서 확인, 미색인이면 나머지 언어 URL도 요청. 네이버 서치어드바이저·Bing 등록은 미착수 | `docs/marketing/launch-kit.md` §2 |
| EXT-PROMO-03 | 코드 서명 인증서 구매 — 무서명 설치본은 SmartScreen 경고로 홍보 유입 이탈 위험(사용자 구매 의사 2026-10-20) | Authenticode(OV/EV) 인증서 구매 후 서명 게시로 GAP-REL-06 해소 | GAP-REL-06 |
---
## 4. Documentation & drift watch
| ID | Item | Note |
|---|---|---|
| DOC-01 | `[x]` 2026-10-30: `CLAUDE.md` updated to cover all monorepo surfaces (`apps/desktop`, `apps/web`, `apps/mobile-rn`, `apps/api-server`, `apps/admin`, `server/supabase`, `server/cloudflare-worker`, `site/`, `packages/*`) and point to `docs/map/00-index.md`. | Resolved. |
| DOC-02 | `docs/design/*` reflects an older desktop-only architecture and contains known naming drift (`06-gap-analysis.md`). | Treat this map + code as current; design docs are historical. |
| DOC-03 | `memory/project_status.md` is a chronological log, not current state. | Use `docs/map/*` for current state. |
| DOC-04 | `docs/v2/00-v2-master-plan.md` targets Expo for mobile. | Actual mobile is RN CLI (`apps/mobile-rn`); the Expo app was removed 2026-09-13. v2 plan is historical. |
| DOC-05 | This map itself must be regenerated after large refactors. | See update protocol. |
---
## 5. Quick "is X done?" lookup
- **Desktop local dictation / LLM / history / meetings / RAG / conversation:** local
dictation works in dev **and** in packaged builds as of `1.3.0` (engine bundled, paths
fixed, IPv4 loopback). Ads: one real adapter, rest stubs; rewarded ads grant bonus quota via `LicenseService.grantRewardQuota` (GAP-ADS-02 `[x]`).
- **Desktop LLM post-processing:** split the question. The **plain actions**
(`refine`/`summarize`/`grammar`/`expand`, Settings → `defaultLLMAction`) always worked
and are now regression-tested. The **custom-instruction path** — built-in presets,
user commands, voice keyword commands, chains — **never worked in any shipped release**
(`v0.1.0-alpha`..`v1.4.0`): it inserted the instruction's own wording instead of the
result. Fixed 2026-09-21 in `9c2b4d4` with unit tests, and usecase tests now run under Node ABI via `rebuild:test` (GAP-INFRA-06 `[x]`). Translate target language is user-configurable across 12 languages in `SettingsModal.tsx` (GAP-LLM-01 `[x]`).
- **Desktop key bindings (CAP-16):** rewritten onto one SSOT with multiple bindings per
action and mouse-button support; **verified on Windows** by a manual run on 2026-09-21
and unit-tested in `KeyBindingService.test.ts` (11/11) + `voice-intent.test.ts` (19/19) (GAP-KEY-01 `[x]`, GAP-KEY-03 `[x]`). macOS/Linux mouse behavior is still unconfirmed (GAP-KEY-02).
- **Web console:** server-shared data flows include knowledge upload/search, team feed, browser invite acceptance (`/app/accept-invite`), and audio-transcript seek sync. Web Push has a production sidebar call site, stable web-device binding, register/unregister cleanup, and a packaged service worker, but remains partial until matching VAPID/provider configuration and real-browser delivery evidence (`GAP-PUSH-03`).
- **Mobile:** code complete for most flows and tested locally; blocked mainly by external store/console gates, plus a11y and some E2E depth.
- **Backend:** fail-closed AI proxies, RLS, billing, ads SSV implemented; push transports (FCM + webpush + APNs) and cron drain implemented.
- **Admin:** complete with deliberate "unavailable" states; `/support` upgraded to a live `content_reports` & support management console (GAP-SHELL-01 `[x]`).
---
## 6. Immediate TODO — push transports, drain, AdMob (2026-09-13)
Actionable checklist for the work started this session. Fields to fill are blank in
`.env` (git-ignored) and mirrored in `.env.example`.
**Push — server (code done, config pending)**
- [ ] Set Supabase Edge secrets for the transports you deploy: `WEBPUSH_VAPID_PUBLIC_KEY`, `WEBPUSH_VAPID_PRIVATE_KEY`, `WEBPUSH_SUBJECT` (web); `APNS_KEY_ID`, `APNS_TEAM_ID`, `APNS_PRIVATE_KEY`, `APNS_TOPIC`, `APNS_ENVIRONMENT` (iOS); `FCM_SERVICE_ACCOUNT_JSON`, `FCM_PROJECT_ID` (Android). Bake the same public VAPID value into the web image as `NEXT_PUBLIC_VAPID_PUBLIC_KEY`; never expose the private key as `NEXT_PUBLIC_*`.
- [ ] Deploy the updated `send-push` (`supabase functions deploy send-push`).
- [ ] Generate a VAPID keypair (P-256) and store the private/public pair; subject must be `mailto:` or `https:`.
- [ ] Create the APNs `.p8` key in the Apple Developer portal and record Key ID + Team ID.
**Push — Cloudflare cron drain**
- [ ] Set worker vars: `SUPABASE_URL` (`wrangler secret`/`[vars]`) and batch limit.
- [ ] Set worker secret: `wrangler secret put SUPABASE_SERVICE_ROLE_KEY`.
- [ ] `wrangler deploy` from `server/cloudflare-worker` and confirm the `scheduled` runs (Cloudflare dashboard → Cron Triggers).
- [ ] Verify end-to-end: enqueue a test event (e.g. team invite) → drain → delivery row `delivered`.
**Push — clients**
- [~] Web: production sidebar opt-in/out uses the packaged service worker, a stable active web device, `pushManager.subscribe`, device-bound RPCs, disabled-intent reconciliation, bounded local/server cleanup, and non-blocking logout. Isolated local provider acceptance is proven; production authenticated permission/subscription, rendered desktop/mobile accessibility/hit-target evidence, scheduled drain, and browser receipt remain open. (GAP-PUSH-03 — `apps/web/public/sw.js`, `apps/web/src/lib/{web-device,web-push,web-push-session}.ts`, `apps/web/src/components/layout/web-push-control.tsx`)
- [x] iOS: register the APNs device token with `provider: 'apns'`. (GAP-PUSH-03 — `apps/mobile-rn/src/features/notifications/notification-service.ts`)
- [ ] Android: decide FCM vs UnifiedPush/ntfy. (GAP-PUSH-04)
**AdMob (Playwright tooling ready)**
- [ ] Run `run-admob-login.bat` (or `node scripts/admob-login.mjs`) once on a visible desktop to persist the Google session.
- [ ] Run `node scripts/admob-automate.mjs --apply` to create/verify the banner + rewarded units and report the Play-store link.
- [ ] Complete AdMob console gates externally: review, serving limits, store link, payment profile. (EXT-ADMOB-01)
**Docs**
- [ ] Keep `docs/deployment/push-transport-without-firebase.md` and this file in sync when transports or clients change.
---
## 7. 알려진 설계 제약 (수용됨 — 결함 아님)
### 7.x 기기 간 동기화 (2026-09-27 수용)
- **충돌 규칙은 "마지막 쓰기 우선 + 로컬 미전송 보호"다.** 데스크톱은 아직 올리지 않은 로컬 변경이 있는 행을 pull이 덮지 않고, 올릴 때는 서버 행을 통째로 덮는다. 모바일은 `revision`으로 충돌을 감지한다(데스크톱 쓰기도 이제 revision을 올린다). 필드 단위 병합은 하지 않는다.
- **원격 삭제가 로컬 미전송 수정보다 우선한다.** 다른 기기에서 지운 행은 데스크톱에서 편집 중이었어도 지워진다.
- **업그레이드 후 첫 동기화는 예전 삭제를 되살릴 수 있다.** 이 버전 이전에는 삭제 기록이 없었으므로, 데스크톱에만 남아 있던 행(모바일에서 지웠지만 데스크톱이 몰랐던 행)은 첫 대조에서 서버로 다시 올라간다. 데이터 유실보다 되살림을 택했다.
- **데스크톱 사용 횟수(`dictionary.usage_count`)는 자주 바뀌어 매번 올리지 않는다.** 단어를 추가·수정할 때 함께 올라간다.
- **회의 전사 구간은 데스크톱 전사에서 다시 만든다.** 폰은 구간이 있으면 구간을 그리므로, 데스크톱 전사가 바뀔 때마다 구간을 통째로 맞춘다(시각 표기가 없는 줄은 앞 줄의 시각을 잇는다). 폰은 전사를 고치지 않으므로 서버→데스크톱 방향은 `raw_transcript`로 충분하다.
- **프리셋 명령은 짝이 있는 4개만 맞춘다.** 폰은 프리셋 행을 직접 고칠 수 없고(RLS) 데스크톱에서 고친 프롬프트만 전용 RPC로 올린다. 번역의 `{{targetLanguage}}`는 English로 바꿔 올린다(양쪽 모두 영어 번역). `자유 프롬프트`는 폰에 대응이 없어 로컬이다.
- **설정은 뜻이 같은 것만 맞춘다.** 언어는 모바일이 지원하는 ko/en, 테마는 시스템/라이트/다크만(데스크톱 전용 테마는 로컬), 자동 다듬기는 켬/끔, 활성 명령은 양쪽에 있는 사용자 명령일 때만. 서버에 설정 행이 이미 있으면 첫 동기화에서 서버 값이 이긴다.
- **지식 문서는 원문만 옮긴다.** 기기마다 임베딩 모델·차원이 달라(데스크톱 768, 서버 1536) 벡터는 각자 만든다. 다른 기기에서 온 문서에는 원본 파일이 없다.
여기 있는 항목은 고쳐야 할 갭이 아니라 **대안을 검토한 뒤 의도적으로 유지하기로 한 절충**이다.
§1 에 갭으로 재등록하지 마라.
| ID | 제약 | 왜 이대로 두는가 | 완화 장치 |
|---|---|---|---|
| CONSTRAINT-INPUT-01 | 입력 레메트리는 **키 내용을 저장하지 않는다.** 카운터(키 입력·클릭·스크롤)와 마우스 이동 거리, 그리고 **사용자가 명시적으로 동의한 경우에만** 읽은 텍스트(학습 DB)만 남긴다. 키코드→문자 복원은 시도하지 않는다. | ActivityWatch `aw-watcher-input` 이 같은 이유로 같은 선택을 한다 — 전역 키 내용 수집은 보안·프라이버시 파급이 크고, 신뢰를 잃으면 기능 자체가 사라진다(README 원문: "This does not track which keys you press … This is not a keylogger, and never will be"). 게다가 키코드 복원은 한/일 IME 에서 원리적으로 불가능하다(조합 결과가 텍스트다). | 수집은 옵트인(`inputTelemetryEnabled`/`inputLearnTypedText` 기본 false), 비밀번호 필드는 `IsPassword` 로 fail-closed 차단, 앱별 제외, 30일 보존 후 자동 삭제, "수집된 데이터 삭제" 버튼(동의 철회 시 즉시 삭제 + 학습 플래그 해제), 전송 없음(로컬 SQLite 전용). |
| CONSTRAINT-I18N-01 | `packages/core/src/keybinding.ts` 는 i18n 키를 평범한 `string` 으로 노출한다. 렌더러가 `asTranslationKey()`(`apps/desktop/src/renderer/components/keybinding/translation-key.ts:7`)로 경계에서 캐스팅하므로, 존재하지 않는 키를 넘겨도 컴파일러가 잡지 못한다. | core 가 로케일 패키지에 의존하지 않게 하려는 의도적 설계다. 검토한 대안 둘 다 성립하지 않는다 — (A) 키 필드를 리터럴 유니온으로 좁히는 방식은 `KEY_CATALOG` 가 `letterEntries()` 같은 함수 생성부를 포함해 불가능하고, (B) core 가 `@d3ro/i18n` 의 타입 가드를 쓰는 방식은 의존 방향을 core → i18n 으로 역전시켜 `03-shared-packages.md` §6 의 전제를 깬다. 2026-09-21 결정: 현행 유지. | `packages/core/__tests__/keybinding-i18n.test.ts` (14 케이스). core 가 참조하는 키가 12개 로케일 전부에 있는지, 값이 빈 문자열이 아닌지, core 가 렌더러 전용 `keybinding.ui.*` 를 참조하지 않는지 검사한다. 거부 사유 키는 하드코딩 목록이 아니라 실제 `validateBinding` 경로를 태워 수집하므로 새 사유가 생기면 자동으로 커버된다. |
## 2026-11-01 recovery gates
- `[x]` Meeting import account isolation: before-copy, after-copy and A→B→A all reproduced unwanted persistence, then passed after revision guards; generated audio removed on rejection. Test: `meeting-import.usecase.test.ts`.
- `[~]` GAP-INPUT-11: current deterministic A/B 17/17 (pre-fix 2/17), Python 27/27 and rebuilt engine startup/health pass. Windows installer/runtime/portable 1.16.0 are published, replacing runtime feed 1.10.0 and delivering CPU/UIA fixes. Windows native helper is unavailable, so actual high-load typing/model-load overlap remains open.
- `[~]` GAP-MTG-03: real ffmpeg MP3/M4A 2/2 and Fold6 `.3` entry/editor rendering pass. Desktop file picker→minutes and mobile file→transcript→minutes remain unverified; no paid inference was run.
- `[!]` Mobile production release: `release:mobile:config` fails `firebase_expected_project_id_missing`, also with root `.env`. No production APK/AAB/Play publication. Latest `.3` now passes isolated API 34 emulator fresh auth/signup (37 s / 50 s). Fold6 failures and historical `.2` PASS remain separate. Next: configured production credentials, Fold6 first-run recovery and authenticated file-to-minutes checks without resetting personal data.
- `[x]` 2026-11-01 deployment recovery: runtime-first publication, immutable artifact checkpoint and idempotent resume implemented; 44 publication/checkpoint tests pass. Windows v1.16.0 is tagged and published; canonical Forgejo and GitLab mirror received the release commit. No tags were moved or deleted. Evidence below.
- `[~]` Historical remote `origin/seoro/project-overview-report` (`9cd965d`, 2026-04-13) remains unmerged: its titlebar/scrollbar/cloud settings changes are superseded by the September shell and current i18n. It is not today's work; preserve the branch rather than reverting current shell behavior.
Evidence and inventory: [2026-11-01 completion](../evidence/2026-11-01-completion.md).
## 2026-11-02 Windows verification gates
- `[x]` Desktop MTG-13 GUI: installed 1.16.0 native file picker→timestamped transcript→local summary/action item passed with the real WAV fixture. No cloud/paid inference or personal-data reset. Android file-to-minutes remains under GAP-MTG-03.
- `[~]` GAP-INPUT-11: native Korean IME passed 7/7 under bounded 100% CPU and 7/7 with direct `gemma4:e4b` cold-load overlap. Latin-layout correction failed 1/7 and exposed next-key/backspace interleaving; source fix and desktop 2,773 tests/build pass, but updated-app GUI and physical/Chromium/terminal proof remain.
- `[x]` Model-test cleanup: `/api/ps` was empty before and was restored to empty after the explicit unload. The direct Ollama load test is not product-warmup evidence.
Evidence: [2026-11-02 verification](../evidence/2026-11-02-verification.md).
## 2026-11-08 — Wave 5 계약 정리 + TDD 2.0 Phase 0·1
- `[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 (신규·진행 → 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).
---
## 2026-11-14 — Wave 7 다중 세션 피어 스웜 코드 위생 · 최적화 · 버그 헌팅 (`2a009e4..cc3f746`, post-`v1.17.1`)
- `[x]` **Wave 7 6-세션 네이티브 스웜(`monitor`, `input-core`, `desktop-shell`, `mobile-app`, `cloud-surfaces`, `verifier`) 통합 및 검증 완료:**
- **Input Core (`2a009e4`):** 문장부호 직후 무공백 영타 오타(`?` / 한글 말줄임표) 누락 4중 원인 수정(`TYPO_SETTLE_DELAY_MS` 700ms, `diffInsertionSpan()`, `trailingWordOnly` 32자·영구 잠금 해제, `isUrlOrPathRun()` URL/코드 보존 + 한글 말줄임표 허용, `PersonalNgramModel.next()` 중복 복사 제거; `typo-live-punctuation.test.ts` 추가).
- **Desktop Shell (`fc5d453`, `3f9e412`):** `WindowManager` 팝업 숨김 타이머/커서 초기화, `CaptionService` 보조모델/중복 stop/epoch 리셋, `VoiceModeService`/`LlmGateway`/`LocalLLMService` signal 전파 및 `/api/pull` dispose `D3ROError(LLM_ERROR)` 래핑, `LocalSTTService` 모델 다운로드 dispose `D3ROError(STTModelDownloadCancelled)` 래핑, `VoiceConversationService`/`AudioCaptureService`/`caption-handlers.ts` fail-closed 정리(`@d3ro/desktop` Vitest **212 files / 2,890 tests PASS**, Python sidecar `33/33 PASS`, `electron-vite build` + `check:desktop-renderer` **7 page(s)** PASS).
- **Mobile RN (`bd3c1a9`, `cc3f746`):** 레코더 claim/generation/pollTimer, 내구성 큐 `finishCleanupItem(item)`(파일 선삭제+60초 실패 재시도) 및 `suspendedUsers`/`discardedItems`, `chat`/`admin`/`device`/`llm-stream` abort/세대 헤더 가드, 4개 컨텍스트 및 7개 화면 `scopeGenerationRef`+`try/catch/finally` 적용 + 신규 스위트 5종(**103 suites / 651 tests PASS**).
- **Cloud Surfaces (`c68e81e`, `4bf0f0d`):** Cloudflare Worker `BACKEND_ORIGIN` `https://d3ro.chanpaca.net`·`origin-policy.ts`·`push-drain.ts`(`Deno 15/15`), `cloudflare-site-bridge` loop/path 가드(`Deno 5/5`), `.NET` `EndpointUrlPolicy.cs`+`"UpstreamNoRedirect"`(`xUnit 55/55`), Edge `stt-proxy` 413 선차단·`embed-chunks` 환불 경계·`_shared/quota.ts` fail-closed(`Deno 273/273`), Web `edge-fetch.ts`·`safeReturnPath`·`sw.js`·OAuth callback·`chat-panel`/`auth-provider`/`mic-recorder`(`10 files / 52 tests PASS`), Admin `admin-url-safety.ts`·`proxy.ts`·Vitest 도입(`1 file / 6 tests PASS`).
- **유지된 경계 (`[~]` / `[!]` / `RED`):** Wave 7 코드는 `v1.17.1` 운영 배포(`6c6875b`) 이후 `main`에 통합되었으므로 실운영 바이너리·컨테이너 및 라이브 Worker(`fe6d9532-...`, 대시보드 `BACKEND_ORIGIN = http://192.168.0.39:5050` 잔존 -> `1003`/`403`)에는 아직 미반영. Electron 실GUI(`GAP-INPUT-08/09/10/11`), Fold6/iOS 실기기/TalkBack, `EXT-*` 스토어 게이트는 변동 없이 유지. 상세: [`docs/REFACTOR_WAVE7_REPORT.md`](../REFACTOR_WAVE7_REPORT.md).