d3ro-voice/docs/map/11-gap-backlog.md

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). 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, tests/e2e/red_team_cycle*.spec.ts, apps/web/e2e/red_team_cycle4_web.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.
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/red_team_cycle4_web.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.
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 하나.
GAP-BILL-02	Billing	Payple 정기 갱신이 한 번도 실행되지 않았다. 갱신 cron(payple-renew)이 .github/workflows에만 있었는데 GitHub 원격이 없다. 또 웹 Payple 결제용 NEXT_PUBLIC_PAYPLE_CLIENT_KEY가 어디에도 설정된 적이 없어 웹 Payple 결제 버튼이 꺼져 있다.	.forgejo/workflows/payple-renew.yml, apps/web/src/components/billing/payple-checkout-button.tsx, apps/web/Dockerfile	[!] EXT 2026-09-26: 워크플로는 Forgejo로 이식(dc43884). 남은 일 — Forgejo 시크릿 SUPABASE_URL·CRON_SECRET 등록, Payple 클라이언트 키를 웹 이미지 build arg로 넣어 재빌드, Stripe(USD)·Google Play 가격을 각 콘솔에서 새 가격으로.
GAP-WEB-01	Web	웹앱(apps/web)이 공개되지 않았다(배포 경로가 없었음).	apps/web/Dockerfile, docker-compose.nas.yml, server/cloudflare-site-bridge	[~] 2026-09-26: /app basePath·standalone 이미지·NAS 컨테이너 d3ro_voice_web(3002). 남은 일(EXT) — Cloudflare Tunnel 공개 호스트(예: d3ro-app.chanpaca.net → NAS 3002) 추가 후 브리지 워커 WEB_APP_ORIGIN 설정·배포, Supabase 대시보드 Redirect URLs에 https://d3ro.chanpaca.net/app/** 추가. 그 전까지 /app/*는 사이트 404.
GAP-OPS-01	Ops	NAS 운영 compose가 저장소와 어긋나 있다. 운영본은 JWT 비밀값 기본값 폴백·법률 wwwroot 마운트를 쓰고, .env에 ADMIN_BOOTSTRAP_TOKEN·API_SERVER_URL·SUPABASE_URL·SUPABASE_SERVICE_ROLE_KEY가 없어 저장소 compose(:? 필수)로 바꾸면 api/admin이 기동하지 않는다.	docker-compose.nas.yml, NAS /volume1/docker/d3ro/.env	[ ] 2026-09-26: 운영본에만 있던 d3ro-whisper는 저장소로 합쳤다. 누락 변수를 채운 뒤 저장소 compose로 교체해야 한다.
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	[ ] 2026-09-26 발견.
GAP-TEAM-02	Team	브라우저에서 초대를 수락하는 경로가 없다. 웹 accept-invite 페이지는 발급 링크가 가리키지 않고 로그인 후 토큰을 읽는 곳이 없어 끊겨 있었으므로 삭제했다(사이트 /accept-invite/는 앱 딥링크만).	site/public/accept-invite/, server/supabase/functions/team-accept	[ ] 2026-09-26: 데스크톱 전용 사용자를 위한 웹 수락 흐름이 필요하면 /app 아래에 다시 설계.
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와 별개 선행 차단).
GAP-REL-11	Release	portable 워크플로의 마지막 actions/upload-artifact@v4 단계가 Forgejo 러너에서 GHESNotSupportedError로 실패한다(증거 보존만 실패, 게시는 성공).	.forgejo/workflows/portable.yml	[x] 2026-09-19: v1.3.7 portable 게시는 run#64에서 성공(7z 단일 볼륨 83.7MB + zip 2부, portable-latest/portable.json이 1.3.7 보고). 남은 조치: upload-artifact 단계를 제거하거나 v3/다른 보존 방식으로 바꿔 워크플로를 GREEN으로 만든다.
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 선행 문제와 별개).
GAP-REL-06	Release	서명 인증서가 없어 stable(latest) 채널에 무서명 설치본을 게시했다. electron-updater는 app-update.yml에 publisherName이 없으면 서명 검증을 건너뛰므로 설치는 동작하지만, SmartScreen 평판은 버전마다 0부터 시작한다.	scripts/ci/publish-updater-release.mjs, release/update-policy.json, .forgejo/workflows/release.yml	[!] 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, AppLayout.tsx	Wire verified reportRewardCompletion to LicenseService quota after the direct sponsor endpoint exists.
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	[~] 2026-09-13: canonical EntitlementSnapshot + resolveEntitlement added with tests; desktop tier normalization + isPro fixed. Full adoption tracked as 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, apps/mobile-rn/src/lib/entitlement-context.tsx	Adopt resolveEntitlement in web/mobile; decide whether to retire the .NET user store or keep explicit mapping.
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.	SSOT H-011	Store segment timestamps; wire player seek.
GAP-MTG-02	Meetings	Speaker diarization only partially done on desktop; absent web/mobile.	docs/phases/phase-15.5-speaker-diarization.md, SSOT H-014	Finish desktop pyannote path; expose speaker labels cross-surface.
GAP-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	Decide: add mobile to workspaces, or wire verify:all into CI.
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 (admin job comments)	Re-enable with a protected environment, or document the manual runbook as canonical.
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.json	Switch to tsc -b (or per-project -p) and clear the existing errors in a dedicated workstream; do not treat "typecheck GREEN" as evidence until then.
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	Define a ticket/diagnostics contract or keep stub and mark N/A in catalog.
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. Client registration for those providers still pending (see GAP-PUSH-03).
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	Mobile/web clients register only fcm; no service worker subscription or APNs device token.	apps/mobile-rn/src/features/notifications/*, apps/web	Add web service worker + pushManager.subscribe (store JSON subscription) and iOS APNs token registration.
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/publish-updater-release.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, packages/core/__tests__/keybinding.test.ts, %APPDATA%/d3ro-voice/logs/main.log, %APPDATA%/d3ro-voice/d3ro-voice-config.json	[x] 2026-09-21: 사용자가 Windows 에서 앱을 띄워 검증 완료. 로그(12:53–13:06)에 Migrated 4 legacy shortcut(s) to keyBindings → Loaded 6 key binding(s) from config for 6 action(s) → uiohook started, global keyboard/mouse hook active → key-bindings initialized → Key binding events connected 가 순서대로 남았고 부팅 에러 0건, STT 모델 로딩까지 정상. 키보드·마우스(MB4/MB5) 바인딩을 UI 로 실제 조작해 동작을 확인했고, 같은 세션의 Loaded 7 key binding(s) … for 6 action(s) 가 다중 바인딩이 실동작함을 보인다. 설정 파일 되읽기로 마이그레이션 결과를 확인 — 사용자 커스텀 값이 그대로 보존됐고(dictation code:49,alt / hands-free code:49,alt+shift / command code:165,ctrl / caption code:49,ctrl+alt+shift, 팝업 2종은 신규 기본값), 구 *Shortcut 4개와 displayLabel 은 모두 사라졌다. 남은 것: KeyBindingService 자체의 유닛 테스트는 여전히 없다(실행 검증이 유닛 테스트를 대체하지 않는다). 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/VoiceModeService.ts:1071(_resolveHoldMode), packages/core/src/keybinding.ts:740(액션 정의)	command 전용 동작을 정의하고 _resolveHoldMode 의 예외를 제거하거나, 액션을 카탈로그에서 뺀다.
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 해서 같은 테스트가 빠르게 통과한다. 테스트가 로컬 환경을 격리하지 못한 것이 결함이다.	tests/red/ipc-surfaces.usecase.test.ts(캡션 시작 실패는 success:false 로 나온다), tests/red/silent-errors.usecase.test.ts:48. 키바인딩 개편의 회귀가 아니다 — 2026-09-21 에 HEAD(0ca9e24) 무수정 코드를 같은 환경(venv 연결)에서 돌려 동일하게 재현했다. 같은 날 같은 머신에서도 실행 방식에 따라 결과가 갈렸다: 전체 실행은 3 failed / 1311 passed (1314)(rag.usecase + silent-errors 캡션 + paths.test)이고 ipc-surfaces 캡션 케이스는 통과했는데, 그 파일만 단독 실행하면 같은 케이스가 10초 타임아웃으로 실패한다. 테스트 총수 1314 는 어느 실행에서나 같고, 새로 깨진 테스트는 0건이다.	사이드카 기동을 테스트 경계에서 주입·모킹해 환경 의존을 끊는다. 함께 실패하는 rag.usecase(임베딩 서버 부재)도 같은 성격이다. tests/main/utils/paths.test.ts:78 은 성격이 다르다 — 기대 정규식이 사이드카를 찾을 수 없습니다 인데 실제 메시지는 로컬 음성 엔진이 아직 설치되지 않았습니다… 로 바뀌어 테스트가 문구를 따라가지 못한 것이다.
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, 카탈로그 SHELL-03. 구체 사례 (2026-09-21 실측): popup.error.default 가 en.json·ko.json 에만 있고 나머지 10개 로케일에 없다. 소비처는 WindowManager.ts:59(팝업 문자열 주입, 선재)와 CommandsPage.tsx:198·:201(LLM 수정으로 추가된 파이프라인 벤치 오류 표시) 두 곳이며, 비영어 사용자에게는 오류 메시지가 영어로 폴백된다. 새 갭이 아니라 이 행이 세는 약 1,380개 중 하나다 — 별도 행을 열지 마라.	로케일 간 키 diff 를 내는 커버리지 게이트를 만들어 회귀를 막고, 누락 키를 채운다.
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	세 키를 ko.json 에 추가하고 12개 로케일에 반영한다. 같은 타입체크에 잡히는 LicenseTab.tsx(6건)·LicenseModal.tsx(2건)는 원인이 다르다 — TFunction 을 (k: string) => string 에 넘기는 TS2322 4건과 currentTier 미정의 TS2304 2건으로, 후자는 컴파일이 깨지는 별개 결함이다(GAP-INFRA-04 범위).
GAP-LLM-01	LLM	번역 대상 언어를 사용자가 고를 수 없다. 항상 English 고정이다. AppConfig 에 대상 언어 키가 없고, 기존 두 키 모두 대용할 수 없다 — language 는 UI 로케일이라 'ko' 같은 코드가 프롬프트에 그대로 들어가 문장이 깨지고, sttLanguage 는 입력(원문) 언어라 그 값으로 번역하면 원문이 그대로 나온다. 2026-09-21 LLM 수정(9c2b4d4)은 대상 언어가 호출 프레임 두 단계 밖의 기본값에 의존하던 것을 명시 인자로 바로잡았을 뿐, 선택지를 만들지는 않았다(설정 키 + 설정 UI + i18n 이 필요해 patch 범위 밖으로 뒀다).	apps/desktop/src/main/services/llm-prompts.ts:37(DEFAULT_TARGET_LANGUAGE)·:50(resolveTargetLanguage), packages/core/src/types.ts(AppConfig 에 키 없음), 내장 프리셋 CustomInstructionService.ts:26	AppConfig 에 대상 언어 키를 추가하고, 설정 UI(LLM 탭)에 노출하고, resolveTargetLanguage() 가 설정을 읽게 한다. 언어 목록과 라벨은 i18n 키가 필요하다.
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	사용자가 run-desktop.bat 로 앱을 띄워 (1) 명령 페이지에서 내장 프리셋(번역/요약/전문 리라이트/코드 설명/자유 프롬프트)을 활성화한 뒤 받아쓰기, (2) 명령 팝업에서 선택 후 받아쓰기, (3) 음성 키워드로 명령 호출, (4) 체인 실행, (5) 명령 페이지 파이프라인 벤치를 각각 돌려 지시문 문구가 아니라 처리 결과가 삽입되는지 확인한다. GAP-INFRA-06 의 ABI 전환 스크립트가 생기면 usecase 4종을 함께 돌린다.
GAP-INFRA-06	Dev env	better-sqlite3 네이티브 ABI 가 앱 실행과 로컬 테스트에서 서로 다른 값을 요구한다. Electron 33 은 ABI 130, 호스트 Node 23 은 ABI 131 이라 한쪽에 맞추면 다른 쪽이 깨진다. 2026-09-21 실측: electron-rebuild -f -w better-sqlite3 직후 vitest 가 366 failed / 948 passed 로 무너졌고, 리빌드 전에는 1311 passed 였다. 같은 날 확인한 현재 워크스페이스는 Node ABI 쪽(호스트 node -e "require('better-sqlite3')" 성공)이라 테스트는 돌고 앱 실행에는 재리빌드가 필요하다. 배포 차단 이슈가 아니다 — node_modules/ 는 gitignore(.gitignore:1)이고 패키징 경로는 scripts/ci/verify-native-abi.mjs 가 이미 막는다(GAP-REL-07 [x]). 순수하게 로컬 개발 환경 전환 비용 문제다. 다만 전환 비용으로 끝나지 않는다 — 검증을 가린다. Electron ABI 쪽으로 리빌드된 상태에서는 tests/red/*.usecase.test.ts 가 DB 생성 단계에서 먼저 죽어 그 안의 케이스가 통과도 실패도 하지 않는다. 2026-09-21 LLM 지시문 수정(9c2b4d4)이 그 사례다: 전체 실행이 366 failed / 994 passed (1360) 였고 실패 366건 중 365건이 이 ABI 로 죽은 usecase 파일들인데, 하필 instruction·chain·voice·config usecase 가 그 수정의 직접 영향 범위였다(GAP-LLM-02). 참고로 같은 날 clean tree 베이스라인은 366 failed / 948 passed (1314) 로 실패 수가 동일해 신규 실패는 0건이다.	scripts/ci/verify-native-abi.mjs, scripts/ci/fix-native-abi.mjs, package.json(현재 리빌드용 스크립트 없음), apps/desktop/tests/red/*.usecase.test.ts	두 ABI 를 오가는 npm 스크립트를 둔다(예: rebuild:app = Electron ABI, rebuild:test = Node ABI). 지금은 전환 방법이 문서화도 스크립트화도 되어 있지 않아 매번 수동으로 알아내야 한다.
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), 카탈로그 INPUT-03, 테스트 input-intelligence.test.ts | CJK 연속 구간을 문자 단위로 세는 분기를 추가하거나, 통계 라벨을 "단어" 대신 "어절"로 바꾼다. | | 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-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 상한을 확인한다. |

---

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-002, G-006, G-007, G-008, G-009, G-010, G-011	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-001..O-012	Onboarding branches, permissions, tutorial, a11y, full ko/en
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-015; H-006 [x]	Pagination, filters, detail, meeting timeline, docs, diarization, cross-app
F (feature parity)	F-001..F-010, F-013, F-014; F-011/F-012 [x]	Dashboard, dictionary, 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-022, Q-026; Q-010/Q-011/Q-023/Q-027/Q-028 [~]	Emulator scripts, OAuth E2E, billing E2E, visual/a11y gates, env unification, production AAB

---

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 install/OAuth/purchase evidence	User runs the artifact on device	SSOT EXT-009
EXT-PAY-01	Payple live history + webhook signature verification	Provider contract + signature scheme	SSOT M-027
EXT-STRIPE-01	Production Stripe/Payple cross-verification	Live payment E2E	SSOT M-013
EXT-STT-01	Production provider keys (Groq/OpenAI/Deepgram/Gemini)	Inject provider secrets	apps/api-server/Program.cs env docs

---

4. Documentation & drift watch

ID	Item	Note
DOC-01	CLAUDE.md describes only Phase 1-15.5 desktop; does not mention web/mobile/admin/api-server.	This map supersedes it for IA; consider trimming CLAUDE.md to rules + map pointer.
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.
• 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, but not yet verified in a running app, and the four related usecase test files could not execute (GAP-LLM-02, GAP-INFRA-06). Translate is still hardcoded to English (GAP-LLM-01).
• 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 (legacy migration, 6 actions loaded, keyboard + mouse hook live, multi-binding exercised — GAP-KEY-01 [x]). macOS/Linux mouse behavior is still unconfirmed (GAP-KEY-02) and the service has no unit test of its own.
• Web console: yes, feature-complete for server-shared data; knowledge upload/search and team feed implemented.
• 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 page is a stub.

---

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).
• 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: add a service worker + pushManager.subscribe, store the JSON subscription as the registration id, register provider: 'webpush'. (GAP-PUSH-03)
• iOS: register the APNs device token with provider: 'apns'. (GAP-PUSH-03)
• 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. 알려진 설계 제약 (수용됨 — 결함 아님)

여기 있는 항목은 고쳐야 할 갭이 아니라 대안을 검토한 뒤 의도적으로 유지하기로 한 절충이다. §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 경로를 태워 수집하므로 새 사유가 생기면 자동으로 커버된다.