feat: ship Wave 5-6 multi-surface hygiene, optimization, and bug fixes
This commit is contained in:
parent
01ef3293cf
commit
66b6b45ba9
399 changed files with 17828 additions and 11330 deletions
|
|
@ -2,7 +2,11 @@
|
|||
|
||||
> Status: ACTIVE
|
||||
> Last full audit: 2026-09-13
|
||||
> Last update: 2026-11-04 — **테스트 위생 재편.** 버그헌팅 E2E(red-team cycle) 스펙과 중복·죽은 스펙 11개를 삭제하고, 데스크톱 E2E 를 공용 Electron 픽스처 + 5개 보호 여정으로 통합했다. 루트 `tests/e2e` 와 일회성 Playwright 러너 7개도 제거. 새 게이트 `npm run test:hygiene`(+`:test`)를 CI 두 파이프라인에 넣어 `.only`/이유 없는 skip/가짜 단정/머신 경로/`waitForTimeout`/`.e2e.test.ts` 를 막는다. 정본: [`docs/tdd-red/06-repo-application.md`](../tdd-red/06-repo-application.md).
|
||||
> Last update: 2026-11-14 — **전 표면 코드 위생 · 최적화 · 버그 헌팅 완결(Wave 6, WS1–WS4 병렬).** (1) **Desktop Main & Sidecar (`WS1`):** `ipc/renderer-broadcast.ts`(`safeSendToRenderer`/`broadcastToAllWindows`) 9개 파일 단일화, `OnlineLLMService` 스트림 abort/401/예외 래핑, `UnifiedSearchService` FTS5→`LIKE` 런타임 폴백·집계·정렬·인덱스(`started_at`/`created_at`) 보강, `rag/chunk-store.ts` 캐시 무효화·중복 `embedding` JSON 제거·손상 Float32 방어, `disk-wav-audio-sink.ts` uint32 오버플로·헤더 write 실패 fd 정리, `AdMediationEngine`/`AudioCaptureService`/`LocalLLMService`/`WindowManager` 타이머·팝업 레이스 수정, `sidecar/main.py` `UploadFile.close()`·PCM 바이트 경계·`/shutdown` 스레드 join 완료. (2) **Shared Packages & Desktop Renderer (`WS2`):** `@d3ro/i18n` `shared.ts` 및 지연 로드/언마운트 레이스 차단(`25/25`), `@d3ro/core` PII 플레이스홀더·CSV BOM/CR·타임스탬프·검색 경계값(`626/626`), `@d3ro/ui` `wave-math.ts` + 캔버스 `LinearGradient` 캐싱(`7/7`), `@d3ro/ui-native`/`api-client` 경계 가드, 렌더러 `utils/error-message.ts`·훅/컴포넌트 언마운트·타이머 정리 및 Vanilla JS 팝업 6종 `beforeunload`/DOM 안전화 완료. (3) **Mobile RN (`WS3`):** `features/shared/{service-guards,owned-cache-files}.ts`, `features/import/abort-guard.ts`, `lib/locale-speech.ts`(12개 로케일), `features/meetings/meeting-error-message.ts`로 26+ 파일 중복 가드·오류·포맷 통합, `FreeTierBanner` 슬롯 전환 시 높이 고착 수정·내구성 큐 조기 폐기 경합 차단·녹음 리스 누수·언마운트 재생/로케일 레이스 해결(Jest `98 suites / 625 tests PASS`). (4) **Web · Admin · Site · Edge · Worker · .NET (`WS4`):** Edge 20개 엔드포인트 `_shared/json-response.ts`(스트리밍 바이트 상한 포함 `readJsonBody`·`jsonResponse`) 통합 및 `account-delete`/`llm-proxy`/`payple`/`realtime-token` fail-closed 강화(Deno `270/270`), `.NET` `SttProxyService` Base64 상한 + `CancellationToken` 전파(xUnit `32/32`), Cloudflare Worker `resolveBackendTargetUrl` SSRF·타임아웃·`/worker-health` 정보 노출 차단(Deno `9/9`), 웹 `MarkdownPreview` DOM XSS/레이스·`WebPush` 재진입·`team-client` fail-closed(`42/42`), 어드민 `request-security.ts`/`detail-row.tsx`·CSRF/`ADMIN_UUID_PATTERN`/비용 검증, 사이트 `AppLoopDemo`/`rel="noopener noreferrer"` 보강 완료. 상세: [`REFACTOR_WAVE6_REPORT.md`](../REFACTOR_WAVE6_REPORT.md).
|
||||
>
|
||||
> Previous update: 2026-11-13 — **전 표면 성능 최적화 · 코드 위생 완결(Wave 5) · 백로그 일괄 구현 · TDD v2.0 게이트 완성.** (1) **소스·패키징 위생:** 루트 중복 `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 정션 제거, `.NET` `SttController` 무호출 중복 라우트(`GET /providers`, `POST /test`) 삭제. (2) **번들·코드 스플리팅 & 대형 모듈 분리:** `@d3ro/i18n`을 렌더러/웹 동적 로케일 청크(`index.tsx`), 무-React 동기 로더(`@d3ro/i18n/main`), 모바일 지연 엔트리(`index.native.tsx`, Metro `inlineRequires`)로 3분할하고, 데스크톱 `AppLayout.tsx`(7페이지·6모달 `React.lazy`), 모바일 `App.tsx`(`getComponent`), 웹 `MarkdownPreview`(`next/dynamic` + 조건부 `mermaid`) 스플리팅으로 데스크톱 초기 부팅 JS를 `8.79 MB` → `3.62 MB`(`-58.8%`)로 축소했으며, `SettingsModal.tsx`(`951`→`349`줄, 탭 4종 + `settings-model-helpers.ts`)와 `SuggestionService.ts`(`suggestion-policy-helpers.ts`) 순수 모듈 분리를 완료했다. (3) **데스크톱 SQLite · 프로세스 · 오디오 디스크 스트리밍:** SQLite WAL PRAGMA(`synchronous=NORMAL`, `mmap_size=64MB`, `cache_size=-16000`), FTS5 trigram 전문 검색, RAG `embedding_blob`(`Float32Array`) + `WeakMap` 캐시, `PersonalGraphService` 단일 트랜잭션, Windows `koffi` `SendInput` 일원화, 기본 모드 `mousemove`/`wheel` 훅 차단, 백그라운드 팝업 지연 생성, `LocalSTTService` 주 Whisper 모델 유휴/클라우드 언로드, 회의 녹음 PCM 디스크 스트리밍(`DiskWavAudioSink`, 메모리 상주 `O(N)→O(1)`)을 적용했다. (4) **Wave 5 계약·보안 & 기능 백로그 해소:** `@d3ro/core`에 `guards`/`csv`/`format`/`unified-search`/`admin-roles`/`ports` 6개 SSOT 모듈을 추출해 앱 간 중복을 제거하고, 클라우드 LLM·고객지원 `redactPII`/`rehydrateText` 및 녹음 폐기 시 `secureWipeAudioChunks`/`secureZeroBuffer`를 실배선했으며, 고아 키 253개를 정리한 `2,500`키 × 12개 언어를 데스크톱·웹(`LocaleSwitcher`)·모바일(온보딩/설정/계정 + Android `localeFilters` 12개, R8/`shrinkResources`) 전 표면에 노출했다. 또한 `site/` 정적·빌드 CI 게이트(`typecheck:site`/`lint:site`), 웹 `teams` 실 멤버 수 집계(`team-client.ts`), 모바일 `>=600dp` 태블릿/폴더블 반응형 레이아웃(`@d3ro/ui-native/responsive`, 10개 화면 + `FreeTierBanner` `90dp` 슬롯 예약), `meeting_memos.revision` 불변 CAS(마이그레이션 #74 `20261113000001`), 사이드카 `POST /diarize` + 데스크톱·웹·모바일 화자 배지·필터 바(`MTG-08`)를 완성했다. (5) **TDD v2.0 Phase 2~5 자동화 게이트:** `check:i18n`, `check:ds-contract`(`SegmentControl` ARIA `tablist`/`tab` + `@d3ro/ui` 테스트), `test:affected`, `release:installer:smoke`(`verify-desktop-installer-smoke.mjs`: PE64·blockmap·SHA-512·`app-update.yml`·ASAR Pickle·Ed25519 `.sig`)를 `verify:all` 및 `.forgejo/workflows/{ci,release}.yml`에 연결했다. 상세: [`REFACTOR_WAVE5_REPORT.md`](../REFACTOR_WAVE5_REPORT.md).
|
||||
>
|
||||
> Previous update: 2026-11-04 — **테스트 위생 재편.** 버그헌팅 E2E(red-team cycle) 스펙과 중복·죽은 스펙 11개를 삭제하고, 데스크톱 E2E 를 공용 Electron 픽스처 + 5개 보호 여정으로 통합했다. 루트 `tests/e2e` 와 일회성 Playwright 러너 7개도 제거. 새 게이트 `npm run test:hygiene`(+`:test`)를 CI 두 파이프라인에 넣어 `.only`/이유 없는 skip/가짜 단정/머신 경로/`waitForTimeout`/`.e2e.test.ts` 를 막는다. 정본: [`docs/tdd-red/06-repo-application.md`](../tdd-red/06-repo-application.md).
|
||||
>
|
||||
> Previous update: 2026-11-04 — **Wave 4 모노레포 위생 점검.** 사용되지 않는 chart/recharts·feature gate·내부 선언·Turbo/pnpm 잔여를 제거하고, mobile navigation 타입/로깅, push·quota 계약, embedding quota SSOT, updater dialog i18n, CI web build·migration metadata gate, `audio-purge` 함수 설정을 정합화했다. Web Push production call site, 12-locale 표면 노출, meeting memo ABA conflict, audio-purge 배포/pg_cron은 완료로 올리지 않고 `11`에 남겼다. 제품 버전은 1.16.1 그대로이며 커밋·푸시·배포·릴리스는 수행하지 않았다. 상세: [`REFACTOR_WAVE4_REPORT.md`](../REFACTOR_WAVE4_REPORT.md).
|
||||
>
|
||||
|
|
@ -33,7 +37,7 @@
|
|||
> Previous update: 2026-09-22 — **Gemma/Ollama 폭주 방어 계약을 기록했다.** 19:14:12 부팅 워밍업이 `keep_alive: 30m`으로 `gemma4:e4b`를 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/min·5 candidates·128 tokens·한 글자 재생성 정책이 허용한 burst였다. 현재 구현 계약은 부팅 warmup 제거, `keep_alive: 2m`, 제안 600 ms / 최소 5 s 간격 / 기본 6회·hard max 12회 per min / 3 candidates / 64 tokens / 12-char growth / 8 s timeout, 그리고 요청별 취소·상한·종료 정리다. 독립 표적 검증은 6 test files / 69 tests passed / 0 failed, 변경 코드·테스트 ESLint와 `git diff --check`도 exit 0이다. Raw Ollama에서는 cold bounded 요청이 client hard timeout 15.044 s에 취소된 뒤 `/api/ps`가 비었고 `/api/version`은 80 ms에 회복했다. 명시 warmup은 HTTP 200 / 16.639 s, 후속 warm 요청은 body `options.num_predict=1`, `keep_alive='2m'`로 553 ms HTTP 200 / `done:true` / `eval_count:1` / `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·실제 타이핑 증거는 아니므로 상태는 `[~]`로 유지한다 (`11` GAP-LLM-04, GAP-INPUT-06).
|
||||
>
|
||||
> Previous update: 2026-09-21 — **Input intelligence (입력 레메트리 + 다음 문장 제안) 신규**. 데스크톱에 입력 수집기(`InputTelemetryService`), UIA 컨텍스트 브리지(사이드카 `GET /uia/focus`), 제안 서비스(`SuggestionService`), 어렛 커 오버레이, 설정 > 입력 탭(동의·정책·주간 인사이트·개인 문구)을 추가했다. 카탈로그에 `INPUT-01`~`INPUT-08`(전부 데스크톱 `[~]` — 유닛 48건은 GREEN 이지만 **실앱 타이핑 검증 전**), 백로그에 GAP-INPUT-01~05 + GAP-LLM-03, §7 에 CONSTRAINT-INPUT-01(키 내용 미저장 — ActivityWatch 정책 채택)을 기록. 설계 근거는 조사 기반이다: 어렛은 `GetGUIThreadInfo` 가 아니라 UIA `TextPattern.GetSelection`(Chromium 은 `TextPattern2` 미구현), 타이핑 스트는 키코드 복원이 아니라 UIA 스냅샷 diff(한/일 IME 대응), 디바운스/토큰 한도는 인라인 컴플리션 실측값(Continue 350 / Tabby 250 / twinny 300 ms, 출력 64~256 토큰). 의존성: `koffi` 3.3.1(포그라운드 창 FFI), 사이드카 `uiautomation` 2.0.29 + `comtypes`. 데스크톱 유닛 총계 1409(+49), Electron ABI 실행에서 신규 실패 0건. 당시의 24.7초/4.9초 지연 설명과 `keep_alive: 30m`·부팅 워밍업 처방은 **현재 상태가 아닌 과거 가설/완화 이력**이며, 최신 운영 결론은 위 2026-09-22 항목과 `11` GAP-LLM-04를 따른다. 직전: LLM instruction-prompt fix (`9c2b4d4`): the custom-instruction path inserted the instruction's own wording instead of the processed result and had **never worked in any shipped release** (`v0.1.0-alpha`..`v1.4.0`, introduced `fea923d` 2026-04-05, not a regression). `llm-prompts.ts` is now the SSOT for prompt resolution and placeholder substitution, shared by `VoiceModeService` / `ChainService` / `LLM.PROCESS`. AI-04/05/06/07 are demoted to `[~]` on desktop — fixed with unit tests, but **not verified in a running app** and the four related `tests/red/*.usecase.test.ts` could not execute (`better-sqlite3` ABI). New: GAP-LLM-01 (no target-language setting), GAP-LLM-02 (this fix unverified); GAP-INFRA-06 amended (the ABI masks verification, not just dev-env switching cost); GAP-I18N-01 amended (`popup.error.default` missing in 10 locales). Earlier the same day: CAP-16 (desktop key bindings rebuilt on one `@d3ro/core/keybinding` SSOT — multiple bindings per action, mouse buttons, `HOTKEY` → `KEYBINDING` IPC group), verified on Windows by a manual run, so CAP-16 and CAP-02 are `[x]` and GAP-KEY-01 is closed. Still open: GAP-KEY-02/03, GAP-QA-02, GAP-I18N-01/02, GAP-INFRA-06, GAP-LLM-01/02, GAP-INPUT-01~05; `11` §7 holds accepted design constraints (things deliberately kept, not gaps)
|
||||
> Scope: entire monorepo `D:/workspace/D3ROVoice` at product version `1.16.1` (`release/product-version.json`, released 2026-11-04)
|
||||
> Scope: entire monorepo `D:/workspace/D3ROVoice` at product version `1.16.5` (`release/product-version.json`)
|
||||
> Purpose: let any agent (or human) answer two questions in under a minute:
|
||||
> 1. **What infrastructure exists?** (build, CI, services, APIs, data, packages, deploy)
|
||||
> 2. **How far is each feature developed?** (per surface, with file anchors and status)
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
# 02 — Repository & Infrastructure Map
|
||||
|
||||
> Surface: whole repo
|
||||
> Last updated: 2026-11-08 — TDD 2.0 Phase 0-1 gates (test metrics, protected acceptance, quality ratchet) added to CI quality
|
||||
> Last updated: 2026-11-13 — Source/packaging hygiene (`clean:deep`, trimmed `apps/desktop/resources/sox`, macOS-only `@nut-tree-fork` `asarUnpack`, Android R8 + `shrinkResources` + 12-locale `localeFilters`), `@d3ro/i18n` 2,500-key split, `site/` static/build CI gate, and TDD v2.0 Phase 2–5 gates (`check:i18n`, `check:ds-contract`, `test:affected`, `release:installer:smoke`)
|
||||
> Source of truth for: layout, workspaces, build/test commands, CI/CD, Docker, deploy, scripts, resources
|
||||
|
||||
---
|
||||
|
|
@ -29,9 +29,8 @@ D:/workspace/D3ROVoice
|
|||
│ ├── cloudflare-worker/ Edge gateway (wrangler.toml + src/index.ts)
|
||||
│ └── cloudflare-site-bridge/ Site bridge worker: forwards `/app/*` to WEB_APP_ORIGIN, rewrites upstream redirects, else proxies to Pages
|
||||
├── site/ Vite landing site (deployed to Cloudflare Pages; GitHub Pages removed 2026-09-26, Wave 3)
|
||||
├── resources/ icons/ (empty), sox/ (bundled Windows SoX binaries)
|
||||
├── release/ Version identity SSOT + license/evidence public keys
|
||||
├── scripts/ ~145 automation scripts + scripts/ci/ (31) + scripts/lib/
|
||||
├── scripts/ Automation scripts + scripts/ci/ (32, incl. clean-deep.mjs) + scripts/lib/ + scripts/verification/
|
||||
├── docs/ Design, phases, v2/v3 plans, deployment, map/ (this map)
|
||||
├── memory/ Project status, handoffs, archive
|
||||
├── test-results/ Last-run artifacts (root tests/e2e removed 2026-11-04 — orphaned duplicates)
|
||||
|
|
@ -81,28 +80,35 @@ npm run build:all | npm run ci # typecheck + test + desktop/admin/web productio
|
|||
npm run checksum # scripts/ci/generate-checksums.mjs
|
||||
npm run version:check | version:sync
|
||||
npm run release:metadata[:test]
|
||||
npm run release:installer:smoke[:test] # PE64, gzip blockmap, SHA-512, app-update.yml, ASAR Pickle, Ed25519 .sig smoke gate
|
||||
npm run release:forgejo[:check] # canonical Forgejo publisher/feed
|
||||
npm run release:tag # annotated/signed immutable release tag
|
||||
npm run security:secrets[:test] # hardcoded-secret scanner
|
||||
npm run check:desktop-renderer[:test] # built renderer pages reference only assets on disk
|
||||
npm run check:migrations[:test] # Supabase migration filename/order/non-empty metadata checks; no DB replay or remote drift
|
||||
npm run check:migrations[:test] # Supabase migration filename/order/non-empty metadata checks (74 migrations); no DB replay or remote drift
|
||||
npm run check:i18n[:test] # 12-locale 2,500-key parity, placeholder consistency, literal t() existence & orphan budget
|
||||
npm run check:ds-contract[:test] # @d3ro/ui DS exports, theme-token purity, ARIA roles, and contract test coverage
|
||||
npm run rebuild:app # rebuild better-sqlite3 in-place for Electron ABI
|
||||
npm run rebuild:test # rebuild better-sqlite3 in-place for host Node ABI (Vitest)
|
||||
node scripts/ci/verify-native-abi.mjs --self-test # required packaged N-API prebuild missing/present fixture
|
||||
node scripts/ci/sync-i18n-locales.mjs # synchronize 12 locales against ko/en SSOT
|
||||
node scripts/ci/sync-i18n-locales.mjs [--check] # verify/sync 12 locales against ko/en SSOT (zero hardcoded translations)
|
||||
npm run test:e2e:red # content-report red e2e
|
||||
npm run release:mobile:boundary[:test]
|
||||
npm run release:mobile:config[:test]
|
||||
npm run release:mobile:build-config:test
|
||||
npm run release:play:assets[:test]
|
||||
npm run typecheck # all workspaces; web/admin run `next typegen` before `tsc`
|
||||
npm run test # all workspaces
|
||||
npm run typecheck:site # site/ tsc --noEmit (outside npm workspaces)
|
||||
npm run test # all workspaces (desktop, web, api-client, core, i18n, ui)
|
||||
npm run test:affected[:test] # affected test selector over git diff (falls back to full suite on unknown paths)
|
||||
npm run lint # eslint apps/desktop apps/web apps/admin packages
|
||||
npm run lint:site # eslint site/src --max-warnings=0
|
||||
npm run format # prettier
|
||||
npm run typecheck:mobile # apps/mobile-rn tsc (outside npm workspaces)
|
||||
npm run lint:mobile # apps/mobile-rn eslint --max-warnings=0
|
||||
npm run test:mobile # apps/mobile-rn test:ci (jest --runInBand)
|
||||
npm run verify:all # aggregate: workspaces + mobile (typecheck/lint/test)
|
||||
npm run verify:all # aggregate: hygiene + protected-tests + quality + i18n + ds-contract + workspaces + mobile + site
|
||||
npm run clean:deep # remove build outputs, caches, temp browser profiles, dangling symlinks (--dry-run supported)
|
||||
```
|
||||
|
||||
Per-app commands that matter:
|
||||
|
|
@ -155,11 +161,11 @@ See [`03-shared-packages.md`](./03-shared-packages.md). Summary:
|
|||
|
||||
| Package | Provides |
|
||||
|---|---|
|
||||
| `@d3ro/core` | Domain types, `D3ROError`/`ErrorCode`, IPC channel SSOT, key-binding SSOT (`./keybinding`), plan/quota catalog including `knowledge_embedding`, constants, `crypto-license`, `pii-redactor`, `secure-memory`, `supabase-config`, `meeting-markdown`, `markdown-to-docx`; Deno consumes the generated contract checked by `contract:check`; has vitest tests (`packages/core/vitest.config.ts`, `npm run test --workspace=@d3ro/core`) |
|
||||
| `@d3ro/ui` | Theme tokens, CSS vars, MUI DS components (web/desktop) |
|
||||
| `@d3ro/ui-native` | RN design system (MetalCard, PhosphorText, Led, PhysicalButton, WaveBars, …) |
|
||||
| `@d3ro/i18n` | 12 locales / 2,742 parity-checked keys, `I18nProvider`, `t()`, date/number/relative formatters; includes native updater-dialog keys |
|
||||
| `@d3ro/api-client` | Supabase browser/server clients, meetings/history/usage/transcribe wrappers, canonical push-token/provider + push/quota RPC types; has vitest tests |
|
||||
| `@d3ro/core` | Domain types, `D3ROError`/`ErrorCode`, IPC channel SSOT, key-binding SSOT (`./keybinding`), plan/quota catalog including `knowledge_embedding`, constants, `crypto-license`, `pii-redactor`, `secure-memory`, `supabase-config`, `meeting-markdown`, `markdown-to-docx`, plus cross-surface `guards`, `csv`, `format`, `unified-search`, `admin-roles`, speaker diarization helpers (`meeting-transcript`), and deterministic `Clock`/`Random` `ports`; Deno consumes the generated contract checked by `contract:check`; has vitest tests (`packages/core/vitest.config.ts`, 38 files / 618 tests) |
|
||||
| `@d3ro/ui` | Theme tokens, CSS vars, MUI DS components (web/desktop), ARIA-accessible `SegmentControl` (`tablist`/`tab`), and DS contract tests (`packages/ui/__tests__/ds-contract.test.tsx`, guarded by `check:ds-contract`) |
|
||||
| `@d3ro/ui-native` | RN design system (MetalCard, PhosphorText, Led, PhysicalButton, WaveBars, …) + `>=600dp` tablet/foldable responsive primitives (`responsive.tsx`: `resolveResponsiveLayout`, `useResponsiveLayout`, `useContentWidth`, `<ContentColumn>`) |
|
||||
| `@d3ro/i18n` | 12 locales / 2,500 parity-checked keys (253 orphan keys pruned on 2026-11-13), `I18nProvider`, `t()`, date/number/relative formatters; guarded by `check:i18n` and `packages/i18n/__tests__/locale-contract.test.ts` (15 tests) |
|
||||
| `@d3ro/api-client` | Supabase browser/server clients, meetings/history/usage/transcribe wrappers, canonical push-token/provider + push/quota RPC types, `meeting_memos.revision` CAS shape; has vitest tests (4 files / 31 tests) |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -174,7 +180,7 @@ See [`03-shared-packages.md`](./03-shared-packages.md). Summary:
|
|||
Stages `validate → test → build → e2e → package → publish → deploy`. Primary pipeline for desktop Windows/macOS releases (Forgejo Generic Registry is the canonical updater feed; GitLab project 1172 is a legacy mirror) and production mobile releases (`mobile-production-release`, manual/protected). Admin NAS deploy job is intentionally **disabled**. `package-windows`/`package-macos` build the faster-whisper sidecar (`sidecar:setup` → `sidecar:build`) and run `scripts/ci/verify-sidecar-bundle.mjs` before electron-builder, so a release can never ship without the local STT engine. Every pipeline that runs `npm run build --workspace=@d3ro/desktop` (`.forgejo` CI/release/portable) then runs `scripts/ci/verify-desktop-renderer-bundles.mjs`, which fails packaging when a renderer page references an asset the build did not emit (GAP-INFRA-05).
|
||||
|
||||
### Forgejo Actions (`.forgejo/workflows/`)
|
||||
`ci.yml` — CI is now Forgejo-only (`.github/workflows` deleted 2026-09-26, Wave 3, dc43884). Jobs: `quality` (`version:check`, `contract:check`, `release:metadata:test`, migration checker self-test + actual filename/order/non-empty check, secret scan, mobile release/config/build-config self-tests, Play asset contract, lint, typecheck, Vitest), `build-validation` (desktop renderer verification + admin + web production builds), `mobile-quality`, `edge-functions` (Deno), `api-server-tests`. Web/admin typecheck runs Next 16 `typegen` before `tsc`, so a clean checkout generates and checks route/root-param declarations instead of relying on a prior dev/build artifact. The migration checks are file metadata/order gates only; Supabase replay, shadow DB, and remote drift remain separate runtime/integration gates. A separate isolated local run on 2026-11-04 applied all 73 migrations from empty and after reset, then returned an empty `pg-delta --strict-coverage` shadow diff; that runtime gate is not yet part of CI and says nothing about linked remote drift.
|
||||
`ci.yml` — CI is now Forgejo-only (`.github/workflows` deleted 2026-09-26, Wave 3, dc43884). Jobs: `quality` (`version:check`, `contract:check`, `release:metadata:test`, `release:installer:smoke:test`, migration checker self-test + actual 74-migration filename/order/non-empty check, secret scan, mobile release/config/build-config self-tests, Play asset contract, `test:hygiene[:test]`, `check:protected-tests[:test]`, `test:quality[:test]`, `check:i18n[:test]`, `check:ds-contract[:test]`, `test:affected:test`, `lint`, `lint:site`, `typecheck`, `typecheck:site`, Vitest across desktop/web/api-client/core/i18n/ui), `build-validation` (desktop renderer verification + admin + web + `site/` production builds), `mobile-quality`, `edge-functions` (Deno), `api-server-tests`. Web/admin typecheck runs Next 16 `typegen` before `tsc`, so a clean checkout generates and checks route/root-param declarations instead of relying on a prior dev/build artifact. The migration checks are file metadata/order gates only; Supabase replay, shadow DB, and remote drift remain separate runtime/integration gates. A separate isolated local run on 2026-11-04 applied all 73 prior migrations from empty and after reset, then returned an empty `pg-delta --strict-coverage` shadow diff; that runtime gate is not yet part of CI and says nothing about linked remote drift.
|
||||
|
||||
`payple-renew.yml` — daily cron (+ manual dispatch) → `payple-renew` edge function; ported from the never-run `.github/workflows/payple-renew.yml` because the repository has no GitHub remote. Requires Forgejo secrets `SUPABASE_URL`, `CRON_SECRET`. 2026-09-26~10-11 `SUPABASE_URL` 시크릿이 로컬 주소(`127.0.0.1:55321`)라 한 번도 성공하지 못했다(GAP-OPS-03).
|
||||
|
||||
|
|
@ -185,7 +191,7 @@ Stages `validate → test → build → e2e → package → publish → deploy`.
|
|||
`portable.yml` — 태그/수동 실행으로 **서명 없이** portable 채널(95MiB 7z 분할 볼륨 + Scoop 매니페스트 + 설치 스크립트)을 게시한다. `WIN_CSC_*` 불필요, updater feed는 건드리지 않는다.
|
||||
|
||||
`deploy-site.yml` — 유일한 사이트 배포 경로(Linux, Cloudflare Pages). Windows 수동 중복 워크플로(`deploy-site-windows.yml`)는 2026-09-26 삭제됐다(dc43884). build `site`, write release identity, deploy to Cloudflare Pages `d3ro` (`d3ro.pages.dev`), verify live commit/version, app-links, legal URLs. 커스텀 도메인 `d3ro.chanpaca.net` 은 Pages 커스텀 도메인이 DNS CNAME을 요구하므로, DNS를 건드릴 수 없는 동안은 Workers 라우트 브리지 `server/cloudflare-site-bridge/`(`d3ro.chanpaca.net/*` → Pages 프록시, 수동 `npx wrangler deploy`)가 서빙한다. CNAME을 추가한 뒤 브리지를 삭제하면 Pages 커스텀 도메인으로 직접 서빙된다(GAP-REL-09b).
|
||||
`release.yml` — tag-triggered Windows build (signed) + `publish-forgejo-release.mjs` to the canonical Forgejo feed/release hub.
|
||||
`release.yml` — tag-triggered Windows build + `verify-desktop-installer-smoke.mjs` (PE64/blockmap/SHA-512/ASAR/feed smoke gate) + `publish-forgejo-release.mjs` to the canonical Forgejo feed/release hub.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -208,7 +214,7 @@ Public endpoints (production): `https://d3ro.chanpaca.net` — **랜딩/다운
|
|||
## 7. `server/supabase` (backend)
|
||||
|
||||
- `config.toml` — project `d3ro-voice`, ports 55321-55324, DB major 17, Supabase CLI 3.x `[local_smtp]`, auth redirects (localhost, `d3ro.chanpaca.net`, `d3ro-voice://auth-callback`), providers Google/GitHub/Apple. `audio-purge` has an explicit function stanza with gateway JWT verification disabled because its handler verifies the exact pg_cron service credential. An isolated local stack proved missing/non-service key 401, service 200, and pg_cron/Vault/pg_net removal of the queue row, `audio_files` row, and Storage object; deployment and the production schedule remain unverified.
|
||||
- `migrations/` — **73 SQL migrations** (schema, RLS, auth triggers, storage, team invites, knowledge/pgvector, push outbox, Payple billing (legacy Stripe columns/provider values kept for history), admin roles, mobile platform/monetization, atomic command reorder, device revocation, content reporting, audit log, meeting documents, STT quota reservations, ad reward replay protection, team activity feed).
|
||||
- `migrations/` — **74 SQL migrations** (schema, RLS, auth triggers, storage, team invites, knowledge/pgvector, push outbox, Payple billing (legacy Stripe columns/provider values kept for history), admin roles, mobile platform/monetization, atomic command reorder, device revocation, content reporting, audit log, meeting documents, STT quota reservations, ad reward replay protection, team activity feed, cross-device sync parity & tombstones, and immutable `meeting_memos.revision` CAS `20261113000001`).
|
||||
- `functions/` — **24 Deno Edge Functions** (`stt-proxy`, `llm-proxy`, `content-report`, `generate-meeting-document`, `embed-chunks`, `search-knowledge`, `realtime-token`, `team-invite`, `team-accept`, `send-push`, `audio-purge`, `account-delete`, `admin-users`, `admin-subscriptions`, `admin-payments`, `admin-audit-log`, billing `billing-catalog`/`payple-checkout`/`payple-manage`/`payple-renew`/`payple-webhook`, `iap-verify`, `admob-ssv`, `google-play-rtdn`; Stripe functions removed 2026-09-26). Shared contracts in `functions/_shared/` — push transports now include `webpush.ts` (VAPID + RFC 8291) and `apns.ts` (.p8 token) alongside FCM. CI (`edge-functions`) runs `deno check` + `deno test` and also the Cloudflare worker drain test.
|
||||
- `tests/` — integration/E2E for content report, mobile platform/recording/reward-race, payments, mobile release preflight, push, team push security, STT quota.
|
||||
|
||||
|
|
@ -223,7 +229,8 @@ Full detail: [`09-supabase-backend.md`](./09-supabase-backend.md).
|
|||
- **Deploy/release:** `deploy-nas.ps1/.sh`, `nas-control.sh`, `publish-gh.ps1`, `gen-keystore.js` (`deploy-site-to-nas.js` deleted 2026-09-26, Wave 3, cd9d199 — site deploy is Cloudflare Pages only).
|
||||
- **Android artifact verification (2026-11-01):** `verify-android-artifact.mjs` parses both legacy `Signer #1` and Build Tools 37 `V2/V3.x Signer` certificate output. Self-test and the actual universal E2E APK verification pass with Build Tools `37.0.0`.
|
||||
- **GCP/Google OAuth automation + inspection (~70 `*.mjs`):** `auto-configure-oauth`, `automate-google-oauth`, `setup-consent`, `create-*-client`, `check-*`, `inspect-*` — mostly one-off/browser-driven console automation.
|
||||
- **AdMob console automation:** `admob-probe.mjs` (read-only login/app/ad-unit probe), `admob-login.mjs` + `run-admob-login.bat` (one interactive headful Chrome login into a persistent profile), `admob-automate.mjs` (dry-run by default; `--apply` creates/verifies banner+rewarded units and reports Play-store link). Uses `playwright` with `channel: 'chrome'` and the gitignored `.chrome-playwright-profile`.
|
||||
- **AdMob console automation:** `admob-probe.mjs` (read-only login/app/ad-unit probe), `admob-login.mjs` (one interactive headful Chrome login into a persistent profile), `admob-automate.mjs` (dry-run by default; `--apply` creates/verifies banner+rewarded units and reports Play-store link). Uses `playwright` with `channel: 'chrome'` and the gitignored `.chrome-playwright-profile`.
|
||||
- **Clean-up:** `scripts/ci/clean-deep.mjs` (`npm run clean:deep`, `--dry-run`) strips monorepo `out`/`dist`/`.next`/`bin`/`obj`/Android `build`/`.maestro-output`, temp `.chrome-*`/`.playwright-*` profiles, and any dangling `apps/mobile-rn/node_modules/d3ro-voice-monorepo` reparse point. The untracked `scripts/local/` dump directory (109 one-off probe scripts) and 16 unreferenced loose root scripts were deleted on 2026-11-13.
|
||||
- **E2E / verification:** `test-and-capture-all-10-ad-services.js`, `verify-live-production-d3ro.js`. The old ad-hoc `e2e-desktop-*.js` / `real-app-multi-tab-e2e.js` / `run_e2e_*.cjs` runners were deleted 2026-11-04 (machine-specific paths, no references); Playwright specs under `apps/desktop/tests/e2e` are the E2E path.
|
||||
- **Screenshots/captures:** `capture-*.js`.
|
||||
- **Forgejo ops:** `check-forgejo-actions-runs.js`, `capture-forgejo-*.js`.
|
||||
|
|
@ -236,11 +243,11 @@ Full detail: [`09-supabase-backend.md`](./09-supabase-backend.md).
|
|||
|
||||
| File | Purpose |
|
||||
|---|---|
|
||||
| `release/product-version.json` | version `1.16.1`, `androidVersionCode`/`iosBuildNumber` `1160100`, releaseDate `2026-11-04`, desktop license keyId |
|
||||
| `release/product-version.json` | version `1.16.5`, `androidVersionCode`/`iosBuildNumber` `1160500`, desktop license keyId |
|
||||
| `release/android-release-identity.json` | package `com.d3ro.voice`, Play app ID, app-signing SHA-256, upload cert SHA-256, evidence keyId, AdMob unit IDs |
|
||||
| `release/desktop-license-public.pem` | Ed25519 public key for desktop offline licenses |
|
||||
| `release/mobile-release-evidence-public.pem` | Ed25519 public key for mobile release evidence |
|
||||
| `apps/desktop/electron-builder.yml` | appId `com.d3ro.voice`, NSIS x64 (forced code signing), macOS DMG/ZIP arm64, generic Forgejo publish feed, asarUnpack native modules + `@ffmpeg-installer`, extraResources (icons, sounds, sox, **sidecar**, ffmpeg, ollama) |
|
||||
| `apps/desktop/electron-builder.yml` | appId `com.d3ro.voice`, NSIS x64 (forced code signing), macOS DMG/ZIP arm64, generic Forgejo publish feed, asarUnpack native modules (`better-sqlite3`, `uiohook-napi`, `koffi`, `@koromix`, `@ffmpeg-installer`; `@nut-tree-fork` unpacked on macOS only), extraResources (icons, sounds, filtered `sox.exe`+`zlib1.dll`+`LICENSE.GPL.txt`, **sidecar**, ffmpeg, ollama) |
|
||||
| `apps/desktop/src/main/update-feed.ts` | Auto-update feed SSOT (canonical Forgejo + legacy GitLab mirror, channels) |
|
||||
| `release/update-policy.json` | Update policy SSOT (channels, minimum supported version, forced update, delta/full, staged rollout, kill switch) |
|
||||
| `site/src/release.ts` | Download-center desktop release contract (installer filename + release date); version and date are kept on the SSOT by `npm run version:sync` (drifted to 1.2.0 once — GAP-REL-08). `apps/web/src/lib/desktop-release.ts` and the `apps/web` download/releases pages were deleted 2026-09-26 (Wave 3, cd9d199) — `site/` is the only download surface, and `/download`/`/releases` on `apps/web` now redirect to it |
|
||||
|
|
@ -253,18 +260,22 @@ Version sync is enforced by `scripts/ci/sync-version.mjs` and `verify-release-me
|
|||
|
||||
## 10. Resources & tests
|
||||
|
||||
- `resources/sox/` — bundled Windows SoX (`sox.exe` + DLLs) for audio capture.
|
||||
- `apps/desktop/resources/sox/` — canonical bundled Windows SoX (`sox.exe`, `zlib1.dll`, `LICENSE.GPL.txt`; PE-verified, unused `wget.exe`/`pthreadgc2.dll`/PDFs and duplicate root `resources/sox/` removed 2026-11-13) for audio capture.
|
||||
- `resources/ffmpeg/` — optional bundled ffmpeg (CI or manual); `getFfmpegPath()` also resolves the `@ffmpeg-installer/ffmpeg` binary from `app.asar.unpacked`.
|
||||
- `apps/desktop/sidecar-dist/` — PyInstaller sidecar bundle consumed by `extraResources` (gitignored; built by `npm --prefix apps/desktop run sidecar:build`).
|
||||
- `resources/icons/` — empty; electron-builder falls back to `build/icon.ico|png`.
|
||||
- Desktop tests: `apps/desktop/tests/` — `unit/`, `main/`, `red/`, `shared/`, `integration/`, `eval/` run under Vitest; `e2e/` holds Playwright specs plus the shared `e2e/support/electron-app.ts` fixture (per-test temp user-data dir). Artifacts in `apps/desktop/test-results/`.
|
||||
- Test taxonomy + hygiene gate: `docs/tdd-red/06-repo-application.md`. `npm run test:hygiene` (+ `:test`) rejects `.only`, reason-less `.skip()`, trivial assertions, `isVisible()`-gated assertions, machine-specific paths, `waitForTimeout`, and `.e2e.test.ts` names; wired into CI `quality`.
|
||||
- Test-system gates (TDD 2.0 Phase 0-1, 2026-11-08):
|
||||
- `npm run test:metrics` / `test:metrics:write` — suite/file/case/assertion counts plus weak-assertion and ambient-time totals; writes `docs/tdd-red/metrics/<date>.md`. Metric only, never fails.
|
||||
- Test-system gates (TDD 2.0 Phases 0–5, 2026-11-08..13):
|
||||
- `npm run test:metrics` / `test:metrics:write` — suite/file/case/assertion counts across all 10 suites (incl. `@d3ro/i18n` and `@d3ro/ui`) plus weak-assertion and ambient-time totals; writes `docs/tdd-red/metrics/<date>.md`. Metric only, never fails.
|
||||
- `npm run check:protected-tests` (+ `:test`) — `scripts/ci/check-protected-tests.mjs` diffs the six protected acceptance specs (`06 §5`) against a base revision and fails when tests, assertions, or `.only`/`.skip` change without an `allow-protected-change:` commit marker. CI runs it against `HEAD^` (the quality job fetches depth 2).
|
||||
- `npm run test:quality` (+ `:test`, `:update`) — ratchet over `scripts/ci/test-quality-baseline.json`: per-file weak-assertion and ambient-time counts may only go down. `--update` is a reviewed action.
|
||||
- Shared file-detection helpers live in `scripts/ci/lib/test-files.mjs` so all three gates see the same test files.
|
||||
- Mobile tests: `apps/mobile-rn/__tests__/` (57 suites / 353 tests per mobile SSOT), `.maestro/` + `.maestro-output/` E2E evidence. Note: a full parallel Jest run can hit the 5s render timeout on slow machines; re-run the failing spec in isolation before treating it as a regression.
|
||||
- `npm run test:quality` (+ `:test`, `:update`) — ratchet over `scripts/ci/test-quality-baseline.json`: per-file weak-assertion and ambient-time counts may only go down (scans both tracked and untracked working-tree test files). `--update` is a reviewed action.
|
||||
- `npm run check:i18n` (+ `:test`) — `scripts/ci/check-i18n-contract.mjs` verifies 12-locale 2,500-key set equality, non-empty strings, `{{placeholder}}` parity, literal `t('...')` key existence, and unreferenced-key budget (`<=35`).
|
||||
- `npm run check:ds-contract` (+ `:test`) — `scripts/ci/check-ds-contract.mjs` verifies `@d3ro/ui` DS component exports, zero raw hex outside `theme.ts`/`theme-raw.ts`, required ARIA roles (`SegmentControl` `tablist`/`tab`), and DS contract test references.
|
||||
- `npm run test:affected` (+ `:test`) — `scripts/ci/run-affected-tests.mjs` maps git diffs to targeted Vitest/Jest/Deno/.NET test commands and safely falls back to the full suite on unmapped paths (CI continues to run full suites).
|
||||
- `npm run release:installer:smoke` (+ `:test`) — `scripts/ci/verify-desktop-installer-smoke.mjs` validates NSIS `.exe` PE64 headers, gzip `.blockmap` magic, `latest.yml` SHA-512 & byte size, `win-unpacked` `D3RO Voice.exe` PE64, `resources/app-update.yml` feed URL, `resources/app.asar` Chromium Pickle JSON header, and optional Ed25519 `.sig` manifest signature inside `release-desktop.mjs` and `.forgejo/workflows/release.yml`.
|
||||
- Shared file-detection helpers live in `scripts/ci/lib/test-files.mjs` so `test:metrics` and `test:quality` inspect the exact same test files.
|
||||
- Mobile tests: `apps/mobile-rn/__tests__/` (89 suites / 605 tests PASS on 2026-11-13), `.maestro/` + `.maestro-output/` E2E evidence. Note: a full parallel Jest run can hit the 5s render timeout on slow machines; `test:mobile` uses `--runInBand`.
|
||||
- Web tests: `apps/web/tests/` (vitest pure-logic contracts: billing catalog, Web Push client, web STT client — now part of root `npm test`) and `apps/web/e2e/` (playwright: `smoke.spec.ts` owns the unauthenticated surface contract; billing/payple/dashboard/history are fixture-based browser journeys). Web declares its own `@playwright/test` + `vitest` devDeps (2026-11-04) instead of relying on the desktop workspace's hoisted copies.
|
||||
- API tests: `apps/api-server.Tests/` (xUnit).
|
||||
- Root: `test-results/.last-run.json` (no root-level e2e suite).
|
||||
|
|
|
|||
|
|
@ -22,8 +22,13 @@ The canonical place for types and cross-surface logic. Both desktop and web/mobi
|
|||
| Dictation cleaner | `./dictation-cleaner` | **SSOT** for deterministic zero-latency speech disfluency & dictation cleanup (`cleanDictatedText`, added 2026-10-29): strips standalone spoken fillers (`어`, `음`, `그 쓸데없는` while preserving quoted mentions like `어라든가`, `아라든가` and demonstratives), mid-sentence self-corrections (`X 아니 X이 아니라 Y` → `Y`), word stutters (`내가 내가` → `내가`), colloquial suffixes (`예를 들자면은` → `예를 들어`, `보면은` → `보면`), redundant expressions (`쓸데없는 의미없는` → `불필요한`), and clear contextual STT homophones (`스시가 영어로 변경되지` → `PC가 영어로 변경되지`, `그 길을 쓸 이유가` → `그 기능을 쓸 이유가`) while preserving speaker register. |
|
||||
| Personal graph & n-gram | `./personal-graph`, `./personal-ngram` | **SSOT** for relational personalization and n-gram continuation (upgraded 2026-10-28): exact & particle-invariant stemmed continuations (`continuationsFrom`/`stemContinuationsFrom`), IDF-weighted related node scoring (`scoreRelatedNodes`), 2-hop graph path ranking (`rankTwoHopGraphTargets` across `shares_terms→follows` and `follows→follows`), personalized candidate reranking (`scoreCandidatePersonalization`), and frequency-weighted n-gram indexing with Korean stemmed-word bigram fallback (`PersonalNgramModel`). |
|
||||
| Constants | `./constants` | Shared constants |
|
||||
| Guards, CSV & formatters | `./guards`, `./csv`, `./format` | Cross-surface predicate & codec SSOT (2026-11-13, Wave 5 `W5-05`): `isRecord`, `isNonEmptyString`, `isUuid`, `escapeLikePattern`; RFC 4180 `csvCell` / `parseCsvRows`; `formatDurationSec` / `formatDurationMs` / `formatClockTimestampMs` |
|
||||
| Unified search helpers | `./unified-search` | Cross-surface unified search normalization, snippet extraction (`buildSearchSnippet`), and newest-first ranker (`sortUnifiedSearchResults`) shared by desktop `UnifiedSearchService` and mobile `unified-search-service` (2026-11-13, `W5-06`) |
|
||||
| Admin role hierarchy | `./admin-roles` | `ADMIN_ROLE_RANK`, `hasMinimumAdminRole`, `canManageTargetRole` shared across `apps/admin` and Supabase `_shared/admin-auth.ts` via `core-contract.generated.ts` (2026-11-13, `W5-07`) |
|
||||
| Meeting transcript & speakers | `./meeting-transcript` | Timestamped/speaker segment parser & serializer (`toTranscriptSegments`, `parseSegmentText`), `formatPyannoteSpeakerLabel` (`SPEAKER_00` → `화자 1`), `resolveSpeakerColorIndex`, and `extractDistinctSpeakers` (2026-11-13, `GAP-MTG-02`) |
|
||||
| Determinism ports | `./ports` | Injectable `Clock`, `FakeClock` (`createFakeClock`), `Random`, `systemClock`, `systemRandom`, and `createSeededRandom` (Mulberry32) for deterministic tests (2026-11-13, TDD v2.0 Phase 4) |
|
||||
| Crypto license | `./utils/crypto-license` | Ed25519 license sign/verify (used by admin issuer + desktop verifier) |
|
||||
| PII | `pii-redactor`, `secure-memory` | Redaction + secure memory helpers |
|
||||
| PII & ZDR | `pii-redactor`, `secure-memory` | `redactPII`/`redactPIIMessages`/`rehydrateText` (wired into `OnlineLLMService` and `support-handlers`) + `secureZeroBuffer`/`secureWipeAudioChunks` (wired into `VoiceModeService` and `AudioCaptureService`, 2026-11-13 `W5-01`) |
|
||||
| Supabase config | `supabase-config` | Shared Supabase config shape |
|
||||
| Entitlement | `./entitlement` | `EntitlementTier`, `AdminRole`, `EntitlementSnapshot`, `resolveEntitlement`, `normalizeEntitlementTier`/`normalizeAdminRole` — canonical tier/role contract across Supabase, desktop license, and .NET |
|
||||
| Plan catalog | `./plan-catalog` | Tier/price/quota SSOT. `knowledge_embedding` is explicit per tier (Free 5,000/week; Pro 50,000/day; Pro+ 150,000/day; Team 300,000/day; Enterprise unlimited), generated into `server/supabase/functions/_shared/core-contract.generated.ts`, and guarded by `contract:check` |
|
||||
|
|
@ -40,7 +45,7 @@ The canonical place for types and cross-surface logic. Both desktop and web/mobi
|
|||
| `.` | Barrel |
|
||||
| `./theme` | `theme.ts` — `d3roPalette`, `d3roTypo` (13 steps), `d3roShadow` (10), `d3roRadius` (7); 6 themes (dark/Midnight, light, nord, solarized, catppuccin, dracula) + build helpers |
|
||||
| `./theme-vars` | CSS variable map for popups/vanilla surfaces |
|
||||
| `./components/ds` | MUI/Emotion DS components: CrtDisplay, InstrumentPanel, Led, PhysicalButton, MetalCard, PhosphorText (13 variants), MetalDial, ScreenPanel, ButtonGroup, TiltCard, GradientWave, StatRing |
|
||||
| `./components/ds` | MUI/Emotion DS components: CrtDisplay, InstrumentPanel, Led, PhysicalButton, MetalCard, PhosphorText (13 variants), MetalDial, ScreenPanel, SegmentControl (ARIA `tablist`/`tab` + roving `tabIndex` + keyboard `Enter`/`Space`), ButtonGroup, TiltCard, GradientWave, StatRing. Verified by `packages/ui/__tests__/ds-contract.test.tsx` and `npm run check:ds-contract` |
|
||||
|
||||
Peers: React 19, MUI 7, Emotion 11. Depends on `@d3ro/core`.
|
||||
|
||||
|
|
@ -54,6 +59,7 @@ Peers: React 19, MUI 7, Emotion 11. Depends on `@d3ro/core`.
|
|||
|---|
|
||||
| `NativeThemeProvider` / `useNativePalette`; dark/light/get-palette, raw/status, typo/radius/fonts/space/control/weight/motion/numeral tokens. The v4 semantic colors mirror `packages/ui/src/theme-raw.ts`; `d3roNativeControl.h` is the 48dp control floor |
|
||||
| Components: `MetalCard`, `PhosphorText`, `Led`, `PhysicalButton`, `ScreenPanel`, `WaveBars`, `FilterChip` |
|
||||
| Responsive layout (`./responsive`, 2026-11-13 `GAP-UX-08`): `resolveResponsiveLayout` (`>=600dp` tablet/unfolded foldable vs `<600dp` phone, `contentMaxWidth: 880`, `formMaxWidth: 520`, `gridColumns: 2`, `adaptiveBannerHeight: 90`), `useResponsiveLayout`, `useContentWidth`, `<ContentColumn>` |
|
||||
|
||||
Peers: `react`, `react-native`. Consumed by `apps/mobile-rn` via file: workspace dependencies.
|
||||
App-specific `ScreenHeader`, `RecordFab`, and `UnifiedSearchResultRow` stay under `apps/mobile-rn/src/components`; they are not shared package exports.
|
||||
|
|
@ -64,7 +70,8 @@ App-specific `ScreenHeader`, `RecordFab`, and `UnifiedSearchResultRow` stay unde
|
|||
|
||||
| Provides | Notes |
|
||||
|---|---|
|
||||
| 12 locales | `ko` (master), `en`, `ja`, `zh`, `zh-TW`, `es`, `fr`, `de`, `pt`, `ru`, `vi`, `th` in `src/locales/`; 2,742 parity-checked keys, including the 16 native `update.dialog.*` keys |
|
||||
| 12 locales | `ko` (master), `en`, `ja`, `zh`, `zh-TW`, `es`, `fr`, `de`, `pt`, `ru`, `vi`, `th` in `src/locales/`; 2,500 parity-checked keys (253 unreferenced keys pruned on 2026-11-13), guarded by `npm run check:i18n` and `__tests__/locale-contract.test.ts` (15/15 PASS) |
|
||||
| Multi-entry architecture (2026-11-13) | `src/shared.ts` (zero-React/zero-JSON types & `Intl` formatters), `src/index.tsx` (`@d3ro/i18n` — web/desktop renderer entry: `ko`+`en` eager, 10 secondary locales loaded on demand via literal dynamic `import('./locales/<lang>.json')`), `src/main.ts` (`@d3ro/i18n/main` — zero-React Node/Electron main entry reading only the active `locales/<lang>.json` synchronously from disk with per-locale cache), and `src/index.native.tsx` (React Native Metro `.native.tsx` entry supporting all 12 locales with Metro `inlineRequires: true` lazy evaluation on `switch` branch entry) |
|
||||
| Type-safe keys | `TranslationKey` derived from `ko.json` |
|
||||
| React context | `I18nProvider`, `useI18n`, `TFunction` |
|
||||
| Fallback chain | locale → `en` → `ko` → key |
|
||||
|
|
@ -87,7 +94,7 @@ Electron-independent. Rule: no hardcoded Korean/English strings in UI; use `t()`
|
|||
| `transcribe` | STT calls |
|
||||
| `supabase-browser` | Browser client (`getSupabaseBrowserClient`, `isSupabaseConfigured`) |
|
||||
| `supabase-server` | Server client (`createSupabaseServerClient`) |
|
||||
| `types` | Shared DB/domain types — **canonical; do not redefine table types per app**. Includes `PushProvider`, device-bound `PushToken`, `push_tokens` row/insert/update shapes, `register_push_registration`/`unregister_push_registration`, and period-aware `consume_quota` RPC contracts |
|
||||
| `types` | Shared DB/domain types — **canonical; do not redefine table types per app**. Includes `PushProvider`, device-bound `PushToken`, `push_tokens` row/insert/update shapes, `register_push_registration`/`unregister_push_registration`, period-aware `consume_quota` RPC contracts, and immutable `meeting_memos.revision` CAS shape (`20261113000001`) |
|
||||
|
||||
Deps: `@supabase/supabase-js`; optional peer `@supabase/ssr`. The unused `@d3ro/core` dependency was removed in Wave 4. Tests: `__tests__/` (client, transcribe, types) via vitest.
|
||||
|
||||
|
|
@ -113,3 +120,11 @@ Apps depend on packages, never the reverse. Shared package changes ripple to all
|
|||
|
||||
- `apps/mobile-rn` is not an npm workspace member, so root `typecheck`/`test` skip it; use `typecheck:mobile`/`lint:mobile`/`test:mobile` from the repo root.
|
||||
- No versioned publishing of packages (private, source-only); all consumers are in-repo.
|
||||
|
||||
---
|
||||
|
||||
## 8. Wave 6 hardening (2026-11-14)
|
||||
|
||||
- **`@d3ro/core` (Vitest 39 files / 626 tests PASS):** `utils/pii-redactor.ts` hardens placeholder collision avoidance, stateful regex index resets, and length-sorted single-pass `rehydrateText`; `csv.ts` adds UTF-8 BOM and `\r` line-ending escaping; `unified-search.ts`, `utils/meeting-markdown.ts`, and `meeting-transcript.ts` (reusing `formatDurationClockFromMs` and finite date guards) harden boundary inputs (`pii-redactor.test.ts` 5, `shared-utilities.test.ts` 10). Deno-synced contracts (`plan-catalog`, `web-urls`, `guards`, `admin-roles`) untouched (`contract:check` GREEN).
|
||||
- **`@d3ro/i18n` (Vitest 2 files / 25 tests PASS):** extracted `src/shared.ts` (`I18nStorage`, `noopI18nStorage`, `safeLoadStoredLocale`, `safeSaveStoredLocale`, non-finite date guard) shared by `index.tsx` and `index.native.tsx`, with `cancelled`, `userChangedLocaleRef`, and `localeRevisionRef` guards blocking stale async storage loads from overwriting explicit `setLocale()` changes (`__tests__/i18n-provider.test.tsx` 10).
|
||||
- **`@d3ro/ui` & `@d3ro/ui-native` & `@d3ro/api-client`:** `@d3ro/ui` extracted `src/components/ds/wave-math.ts` and cached canvas `LinearGradient` instances in `AudioVisualizerBar.tsx` and `GradientWave.tsx` (`__tests__/wave-visualizer.test.tsx` 3, Vitest 2 files / 7 tests PASS); `@d3ro/ui-native` extracted `resolveContentMaxWidth` (`responsive.tsx`) and guarded non-finite bars (`WaveBars.tsx`); `@d3ro/api-client/src/transcribe.ts` clamped negative latencies (Vitest 4 files / 31 tests PASS).
|
||||
|
|
|
|||
|
|
@ -16,7 +16,7 @@
|
|||
|
||||
**Main entry** `src/main/index.ts`: sets app name/AppUserModelId, disables GPU acceleration, EPIPE/uncaught handlers, registers `d3ro-voice://` deep-link protocol (Supabase OAuth implicit + PKCE), single-instance lock, then `bootstrap()` + `setupLifecycle()`. The explicit manual-QA argument `--preview-update-dialogs` is isolated before protocol registration/bootstrap: it bypasses the single-instance lock, invokes the real update-dialog prompter for four consent/restart variants, touches no feed/download/install/settings state, then quits. This path is unit-tested, but its packaged native dialogs still require an external-terminal visual run.
|
||||
|
||||
**Bootstrap** `src/main/bootstrap.ts`: ordered `BootstrapStep[]` — logger, config, **database (critical)**, license, create-windows (critical), tray, **ipc-handlers (critical)**, custom-instructions, voice-commands, sound-effects, auto-launch, popup-preload, key-bindings, voice-mode, stt-warmup, llm-polling, meeting-summary-wiring, meeting-mode, cloud-sync, auto-update. Wires VoiceMode events to sound + history persistence, and subscribes to `KeyBindingService` `triggered` for the `history-popup` / `command-popup` actions (`bootstrap.ts:159`) — those two were hardcoded accelerators before and are now rebindable like everything else.
|
||||
**Bootstrap** `src/main/bootstrap.ts`: ordered `BootstrapStep[]` — logger, config, **database (critical)**, license, create-windows (critical), tray, **ipc-handlers (critical)**, custom-instructions, voice-commands, sound-effects, auto-launch, popup-preload (no-op at boot since 2026-11-13; popups are created lazily on first demand), key-bindings, voice-mode, stt-warmup (only when `sttProvider === 'local'`), llm-polling, meeting-summary-wiring, meeting-mode, cloud-sync, auto-update. Wires VoiceMode events to sound + history persistence, and subscribes to `KeyBindingService` `triggered` for the `history-popup` / `command-popup` actions (`bootstrap.ts:159`) — those two were hardcoded accelerators before and are now rebindable like everything else. `ConfigEffects` also propagates `inputTelemetryEnabled` / `inputTelemetryPaused` dynamically to `InputTelemetryService.applyConfig`.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -27,11 +27,11 @@ Singleton + `EventEmitter` pattern (`getXService()` accessors).
|
|||
### Core voice pipeline
|
||||
| Service | Purpose |
|
||||
|---|---|
|
||||
| `VoiceModeService` | Orchestrator: 9-state `RecognitionState` + 4-state `AudioState`, dual-condition flush, action queue. Events: session-started/completed/cancelled, transcription-update, audio-level, recognition/audio-state-changed, premium-llm-fallback, error |
|
||||
| `AudioCaptureService` | Mic PCM16 16kHz mono (bundled SoX on Windows, node-record-lpcm16 elsewhere). Spawns hidden (`windowsHide`); a missing SoX fails with the exact fix command |
|
||||
| `LocalSTTService` | faster-whisper Python sidecar manager (state machine, dual-flush, model download/cancel, background warm-up, live partial transcription). Connects over IPv4 loopback (`getSidecarBaseUrl`) and fails fast with an actionable message when the bundled engine or virtualenv is missing |
|
||||
| `VoiceModeService` | Orchestrator: 9-state `RecognitionState` + 4-state `AudioState`, dual-condition flush, action queue, and secure audio buffer zeroing (`secureWipeAudioChunks` / `secureZeroBuffer`) on cancel/cleanup (2026-11-13 `W5-01`). Events: session-started/completed/cancelled, transcription-update, audio-level, recognition/audio-state-changed, premium-llm-fallback, error |
|
||||
| `AudioCaptureService` | Mic PCM16 16kHz mono (bundled SoX on Windows, node-record-lpcm16 elsewhere) with `secureWipeAudioChunks` on stop/dispose. Spawns hidden (`windowsHide`); a missing SoX fails with the exact fix command |
|
||||
| `LocalSTTService` | faster-whisper Python sidecar manager (state machine, dual-flush, model download/cancel, background warm-up, live partial transcription, `sidecarBaseUrl` getter for `POST /diarize`, and **2026-11-13** `releasePrimaryModel()` / 15-min `IDLE_MODEL_UNLOAD_MS` timer via `POST /unload` `{ slot: "primary" }` so switching to cloud STT or going idle frees the 1.6–3.1 GB Whisper model while keeping the sidecar HTTP server alive for `/uia/focus`). Connects over IPv4 loopback (`getSidecarBaseUrl`) and fails fast with an actionable message when the bundled engine or virtualenv is missing |
|
||||
| `KeyBindingService` | uiohook-napi global hooking for **keyboard and mouse**, driven by the `@d3ro/core/keybinding` contract: 6 rebindable actions (dictation, hands-free, command, caption, history-popup, command-popup), several bindings per action, structural reserved-combo checks. Events: `triggered` (in-process payload carries `actionId`, `type` (`pressed`/`released`), `isDoublePress`, `holdMode`, `timestamp`; the renderer-facing `keybinding:triggered` event is the narrower `KeyBindingTriggeredEvent`, `keybinding.ts:1092`), `changed`, `error`. `globalShortcut` is used only to mute the macOS system beep, and only for accelerators it registered itself. Mouse events cannot be suppressed by uiohook, so a bound button also performs its native action |
|
||||
| `TextInsertService` | Clipboard save→set→Ctrl+V→restore via nut-js |
|
||||
| `TextInsertService` | Clipboard save→set→Ctrl+V→restore (`NutKeyboardPort`: uses native `koffi` Win32 `SendInput` via `utils/win32-unicode-input.ts` on Windows without loading `@nut-tree-fork/nut-js`; `nut-js` used on macOS/Linux) |
|
||||
| `SoundEffectService` | Preloaded WAV feedback (start/stop/error/cancel/chime) |
|
||||
|
||||
### STT engine layer (`services/stt/`)
|
||||
|
|
@ -47,21 +47,21 @@ Singleton + `EventEmitter` pattern (`getXService()` accessors).
|
|||
|---|---|
|
||||
| `LocalLLMService` | Ollama REST (models, pull w/ progress, server start, NDJSON streaming). The 2026-09-22 runaway guard gives each request its own `AbortController` (external caller signals are relayed and detached on completion), requires `done` before an NDJSON stream succeeds, and clears incomplete streams. Generation/stream requests are bounded to 2048 tokens / 120 s; chat is bounded to 512 / 60 s. Ollama server spawn and polling are deduplicated, and lifecycle dispose terminates owned work. |
|
||||
| `PremiumLLMService` | Claude via Supabase `llm-proxy`, local fallback |
|
||||
| `OnlineLLMService` | JWT-authenticated .NET backend client |
|
||||
| `OnlineLLMService` | JWT-authenticated .NET backend client; **2026-11-13 (`W5-01`):** applies reversible `redactPII` / `redactPIIMessages` before cloud dispatch and `rehydrateText` on completion (`pii-zdr-wiring.test.ts` 3/3 PASS) |
|
||||
| `llm-prompts.ts` | **SSOT for prompt resolution, placeholder substitution, and argument placement.** `resolveSystemPrompt` (`:118`) maps an `LLMAction` to its base prompt and handles `custom` explicitly instead of dropping silently to `refine`. `renderInstructionPrompt` (`:78`) substitutes `{{text}}` / `{{userPrompt}}` / `{{targetLanguage}}` and **warns by name** for any placeholder left standing rather than letting it reach the model. `buildInstructionInvocation` (`:101`) decides where an instruction goes in `processText(text, action, targetLanguage, customPrompt)`: the instruction becomes the **system prompt** and the transcript the **text**, except for instructions that spell out `{{text}}`, which keep the old meaning for backward compatibility. `resolveTargetLanguage` (`:50`) is the one place translate targets are decided (still `English`, see `11` GAP-LLM-01). **All three LLM entry paths call the same functions** — `VoiceModeService` (`:838`), `ChainService` (`:196`), and the `LLM.PROCESS` IPC handler (`llm-handlers.ts:96`) — so no caller re-implements the rules |
|
||||
|
||||
### Memory & knowledge
|
||||
| Service | Purpose |
|
||||
|---|---|
|
||||
| `HistoryService` | SQLite history CRUD/search/stats |
|
||||
| `UnifiedSearchService` | Read-only SQLite search across history title/content and meeting title/transcript; merges newest-first results without changing either schema |
|
||||
| `UnifiedSearchService` | Read-only SQLite search across history title/content and meeting title/transcript/memos; **2026-11-13:** uses FTS5 `tokenize = 'trigram'` virtual tables (`history_fts`, `meeting_sessions_fts`, `meeting_memos_fts`) for queries of ≥3 characters with automatic trigger sync and `<3`-char `LIKE` fallback |
|
||||
| `DictionaryService` | Custom vocabulary CRUD/search + cloud sync hooks + JSON/CSV import/export (`dictionary:import`/`export`, save/open dialogs) |
|
||||
| `MemoService` | Memo tags over history (`memo_tags`) |
|
||||
| `RAGService` | Local RAG: `nomic-embed-text` embeddings, cosine search over `rag_chunks` |
|
||||
| `RAGService` | Local RAG: `nomic-embed-text` embeddings, cosine search over `rag_chunks` (**2026-11-13:** `SqliteChunkStore` persists binary `Float32Array` `embedding_blob` alongside JSON fallback, caches `StoredChunk[]` in a DB-scoped `WeakMap` for zero-`JSON.parse` queries, and wraps `removeDocument` in a transaction) |
|
||||
| `CustomInstructionService` | User LLM commands (5 built-ins) |
|
||||
| `VoiceCommandService` | Keyword → command rule matching |
|
||||
| `ChainService` | Multi-step LLM pipelines (LLMChain). Each step resolves its instruction through `llm-prompts.ts` (`ChainService.ts:196`); before that, chain steps sent placeholders through unsubstituted |
|
||||
| `ScreenContextService` | Active-window + selected-text context |
|
||||
| `ScreenContextService` | Active-window + selected-text context (on Windows uses `sendWin32CopyChord()` via `koffi` `SendInput` without loading `nut-js`) |
|
||||
|
||||
### Phase 10+ features
|
||||
| Service | Purpose |
|
||||
|
|
@ -78,7 +78,7 @@ Singleton + `EventEmitter` pattern (`getXService()` accessors).
|
|||
### Phase 12–15
|
||||
| Service | Purpose |
|
||||
|---|---|
|
||||
| `MeetingModeService` | Meeting recording and existing-media import: live/file transcript, normalized meeting audio, timestamp memos, doc generation/export, diarization. `meeting/imported-recording.ts` maps file-transcription segments to the canonical meeting transcript. Account revision checks before/after WAV copy and after transcription reject even A→B→A changes; unsuccessful imports remove only their own generated audio. Since 2026-11-05 refined caption lines reach the meeting transcript (`meetingMode:segmentUpdated`) instead of the raw text, and auto-polish receives the learned-vocabulary block |
|
||||
| `MeetingModeService` | Meeting recording and existing-media import: live/file transcript, normalized meeting audio (`meeting/disk-wav-audio-sink.ts` `DiskWavAudioSink` streams PCM16 directly to disk with `O(1)` memory and backpatches the 44-byte RIFF/WAV header on `finalize()`, 2026-11-13 `GAP-PERF-01`), timestamp memos (`meeting_memos.revision` CAS synced), doc generation/export, and speaker diarization (`diarizeSession` calls sidecar `POST /diarize` via `LocalSTTService.sidecarBaseUrl` — pyannote.audio when installed + energy-VAD acoustic turn segmentation — and falls back to LLM speaker estimation while preserving `[화자 N]` markers across `polishTranscript`, `GAP-MTG-02`). `meeting/imported-recording.ts` maps file-transcription segments to the canonical meeting transcript. Account revision checks before/after WAV copy and after transcription reject even A→B→A changes; unsuccessful imports remove only their own generated audio. Since 2026-11-05 refined caption lines reach the meeting transcript (`meetingMode:segmentUpdated`) instead of the raw text, and auto-polish receives the learned-vocabulary block |
|
||||
| `MeetingDocTemplateService` | Meeting-doc templates (built-ins + CRUD) |
|
||||
|
||||
### Input intelligence (2026-09-21; Local Flow Intelligence extension 2026-09-22)
|
||||
|
|
@ -92,7 +92,7 @@ Singleton + `EventEmitter` pattern (`getXService()` accessors).
|
|||
| `utils/win32-foreground.ts` | Foreground window title/pid/exe/bounds and active thread Korean IME state (`isForegroundKoreanIme` via `GetGUIThreadInfo` + `ImmGetDefaultIMEWnd` + `SendMessageTimeoutW(WM_IME_CONTROL)`) via `koffi` FFI into user32/kernel32/imm32 (chosen over `get-windows`, which needs an install script this repo does not run). |
|
||||
| `sidecar/uia_bridge.py` | Windows UIA snapshot (`uiautomation` 2.0.29, comtypes) on a dedicated COM-initialised thread with a 1.5 s budget; never walks the UIA tree (Chrome/VS Code tree walks take 10-30 s). Uses `GetVisibleRanges()` / tail slicing `[-MAX_TEXT_CHARS:]` for large terminal scrollback buffers and `ExpandToEnclosingUnit(..., waitTime=0)` to avoid `uiautomation.py`'s default 500 ms sleep on Windows Terminal. Warm calls measure 0-15 ms. |
|
||||
|
||||
**2026-10-31 구조 경계:** `suggestion/SuggestionModelRequest.ts`가 prefill/지시형 모델 요청 구성, 후보 파싱, 지어낸 사실·문맥 복사 검증을 소유한다. `suggestion/FirstCandidateRunner.ts`는 첫 후보의 최대 2회 요청, 빈 prefill·사실 검증 재시도와 내용을 노출하지 않는 진단 로그를 담당한다. `_handleGenerationFailure`는 오류·시간 초과·빈 후보의 개인 후보 유지 → 로컬 기억 폭백 → 실패 종료 순서를 한 곳에서 보장한다. `_startGenerationSession`은 취소기·세대 토큰·타임아웃을 포함한 `GenerationSession`을 반환하고, `_prepareFirstCandidate`는 기억 수집·오타 교정·모델 요청과 첫 응답을 `FirstCandidatePreparation`으로 반환하며 실패 시에도 폭백용 기억 문맥을 보존한다. `_isGenerationResultCurrent`는 세대 불일치·문맥 경과·접두 변경을 순서대로 검사하고, `_publishFirstCandidate`는 개인 후보 병합·성공 기록·후속 채우기 시작을 담당하고, `_appendFilledCandidate`는 후속 후보의 추가·개인화 재정렬·표시·세션 행 후보 수 갱신을 한 곳에서 처리한다. `SuggestionService`는 입력 정책, 세대/취소, 표시, 수락만 조율한다. 모델 요청과 로컬 기억 게시는 각각 `SuggestionModelRequestInput`·`LocalMemoryPublication` 객체를 사용하며, 동작 변경 없는 순수 리팩토링이다.
|
||||
**2026-10-31..11-13 구조 경계:** `suggestion/SuggestionModelRequest.ts`가 prefill/지시형 모델 요청 구성, 후보 파싱, 지어낸 사실·문맥 복사 검증을 소유한다. `suggestion/FirstCandidateRunner.ts`는 첫 후보의 최대 2회 요청, 빈 prefill·사실 검증 재시도와 내용을 노출하지 않는 진단 로그를 담당한다. `suggestion/suggestion-policy-helpers.ts`(2026-11-13 `W5-11`/`G7`)는 오타 교정 문맥 적용(`applyCorrectionToContext`), 중복 판정(`sameCandidateText`/`isDuplicateCandidateText`), 개인화 후보 재정렬(`rerankFilledCandidates`), 정책 정규화(`normalizeSuggestionPolicyConfig`), 결정 입력 시그니처(`buildDecisionInputSignature`), 터미널 커서 연속성 복원(`resolveTerminalTypingContext`) 등 순수 함수를 소유한다. `_handleGenerationFailure`는 오류·시간 초과·빈 후보의 개인 후보 유지 → 로컬 기억 폴백 → 실패 종료 순서를 한 곳에서 보장한다. `_startGenerationSession`은 취소기·세대 토큰·타임아웃을 포함한 `GenerationSession`을 반환하고, `_prepareFirstCandidate`는 기억 수집·오타 교정·모델 요청과 첫 응답을 `FirstCandidatePreparation`으로 반환하며 실패 시에도 폴백용 기억 문맥을 보존한다. `_isGenerationResultCurrent`는 세대 불일치·문맥 경과·접두 변경을 순서대로 검사하고, `_publishFirstCandidate`는 개인 후보 병합·성공 기록·후속 채우기 시작을 담당하고, `_appendFilledCandidate`는 후속 후보의 추가·개인화 재정렬·표시·세션 행 후보 수 갱신을 한 곳에서 처리한다. `SuggestionService`는 입력 정책, 세대/취소, 표시, 수락만 조율한다. 모델 요청과 로컬 기억 게시는 각각 `SuggestionModelRequestInput`·`LocalMemoryPublication` 객체를 사용하며, 동작 변경 없는 순수 리팩토링이다.
|
||||
|
||||
The existing `input-telemetry-handlers` and `suggestion-handlers` IPC extensions expose the receipt and the flow/suggestion summaries. Receipt reads or deletes report an IPC error when storage access fails; they do not return invented counts or claim a purge succeeded. The receipt is local-only: `input_activity`, `typing_samples`, and `suggestions` retain 30 days; `personal_phrases` has no age-based automatic expiry and is removed by individual deletion, delete-all, or consent withdrawal. Smart Exclusion never records password evidence and recommends only the current app after at least four observations, zero readable results, and a problematic ratio of at least 75%; its one-click action adds an exclusion and never auto-excludes. Shortcut Safety Audit is core `auditKeyBindingMap` applied by the Settings UI; it surfaces invalid/conflict issues while preserving the existing hold/double-press exceptions.
|
||||
|
||||
|
|
@ -114,9 +114,9 @@ The existing `input-telemetry-handlers` and `suggestion-handlers` IPC extensions
|
|||
|---|---|
|
||||
| `AdMediationEngine` | Multi-ad mediation + header bidding |
|
||||
| `AdSettlementService` | Revenue settlement, withholding, payout ledger |
|
||||
| `BaseAdAdapter` / `UnavailableAdAdapter` | Adapter contract + fail-closed base |
|
||||
| `BaseAdAdapter` / `UnavailableAdAdapter` | Adapter contract + fail-closed base + declarative `UNAVAILABLE_AD_NETWORK_SPECS` / `createUnavailableAdAdapters()` registry (2026-11-13: consolidated 9 empty subclass files into one table-driven registry) |
|
||||
| `DirectHouseSponsorAdapter` | **Real configurable adapter**: bids/reports against an operator HTTPS `endpointUrl` (`AdNetworkConfig.endpointUrl`), validates creatives, fail-closed (`adapter_not_configured`) when unconfigured |
|
||||
| 9 placeholder adapters (AppLovin, Carbon, EthicalAds, GoogleAdManager, InMobi, Mintegral, Playwire, PubMatic, Unity) | Extend `UnavailableAdAdapter` — registered, no live bids (`provider_not_integrated`) |
|
||||
| 9 unavailable network specs (AppLovin, Carbon, EthicalAds, GoogleAdManager, InMobi, Mintegral, Playwire, PubMatic, Unity) | Instantiated via `createUnavailableAdAdapters()` — registered, no live bids (`provider_not_integrated`) |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -149,7 +149,7 @@ Registry: `src/main/ipc/index.ts` calls 31 `registerXHandlers()` in fixed order.
|
|||
| `rag-handlers` | RAG |
|
||||
| `stt-handlers` | STT |
|
||||
| `suggestion-handlers` | SUGGESTION + POPUP_SUGGESTION |
|
||||
| `support-handlers` | SUPPORT |
|
||||
| `support-handlers` | SUPPORT (`redactPII(..., 'mask')` applied to diagnostic descriptions and logs before ticket creation, 2026-11-13 `W5-01`) |
|
||||
| `system-handlers` | SYSTEM |
|
||||
| `template-handlers` | DICTATION_TEMPLATE |
|
||||
| `voice-action-handlers` | VOICE_ACTION |
|
||||
|
|
@ -168,7 +168,7 @@ Preload exposes **`window.electronAPI`** with 37 namespaces: `platform, audio, c
|
|||
|
||||
## 4. Windows & popups
|
||||
|
||||
`windows/WindowManager.ts` creates 7 windows: main (borderless, custom TitleBar; macOS `hiddenInset`), recording-tip, result-popup, history-popup, command-popup, caption-overlay, suggestion-overlay. Injects popup theme CSS + i18n strings; 2-phase resize. `windows/TrayManager.ts` — tray icon + menu + double-click show.
|
||||
`windows/WindowManager.ts` manages 7 windows: main (borderless, custom TitleBar; macOS `hiddenInset`) created at boot, and 6 vanilla popups (`recording-tip`, `result-popup`, `history-popup`, `command-popup`, `caption-overlay`, `suggestion-overlay`) created **lazily on first demand** (`peekHistoryPopupWindow` / `peekCommandPopupWindow` inspect existing windows without instantiating hidden Chromium renderers at startup). Injects popup theme CSS + i18n strings via `@d3ro/i18n/main`; 2-phase resize. `windows/TrayManager.ts` — tray icon + menu + double-click show.
|
||||
|
||||
**Popup invariants** (each shipped broken once — do not regress):
|
||||
|
||||
|
|
@ -191,7 +191,7 @@ Vanilla popups (`src/renderer/popups/`):
|
|||
|
||||
## 5. Renderer IA
|
||||
|
||||
Routing is state-based in `renderer/navigation/app-navigation.tsx` (`AppRoute`, params, history/back), no react-router. `Ctrl+K` opens the search route and `Ctrl+1..3` opens Home/Records/Meetings.
|
||||
Routing is state-based in `renderer/navigation/app-navigation.tsx` (`AppRoute`, params, history/back), no react-router. `Ctrl+K` opens the search route and `Ctrl+1..3` opens Home/Records/Meetings. **Since 2026-11-13**, `AppLayout.tsx` keeps `HomePage` eager for instant first paint and code-splits the 7 secondary pages (`UnifiedSearchPage`, `HistoryPage`, `MeetingModePage`, `VoiceConversationPage`, `CommandsPage`, `DictionaryPage`, `KnowledgeBasePage`) plus 6 modals (`SettingsModal`, `OnboardingModal`, `OllamaGuideModal`, `SupportModal`, `LicenseModal`, `RewardedQuotaModal`) via `React.lazy` + conditional mounting, cutting the initial renderer JS chunk from `4,596.8 KB` to `1,591.3 KB` (`-65.4%`).
|
||||
|
||||
| Page | Route | Feature |
|
||||
|---|---|---|
|
||||
|
|
@ -204,7 +204,7 @@ Routing is state-based in `renderer/navigation/app-navigation.tsx` (`AppRoute`,
|
|||
| `KnowledgeBasePage` | knowledge | Local RAG: add/index docs, semantic query, reindex/remove |
|
||||
| `MeetingModePage` | meetings | Meeting studio: live or imported-media transcript with progress/cancel, linked audio, memos, minutes/doc generation/export, diarization |
|
||||
|
||||
Modals/components: `SettingsModal` (tabs General/Audio/STT/LLM/Input/License/Cloud/About), `LicenseModal`, `LicenseTab`, `CloudSyncSection`, `InputInsightsPanel` (consent + suggestion policy + weekly insights + learned phrases), `InputConsentPanel` (receipt + current-app exclusion recommendation), `InputInsightsView` (flow, friction and app-quality summaries), `OnboardingModal`, `UpgradePromptModal`, `ProBadge`, `TemplateSection`, `FileDropZone`, `OllamaGuideModal`, `CodexOAuthGuideModal`, `TitleBar`, `StatusBar`, meeting components (9), voice-conversation, payment (`CheckoutModal`, `checkout-flow.ts`), support (`SupportModal`), ads (`AdBanner`, `RewardedQuotaModal`), shared cards.
|
||||
Modals/components: `SettingsModal` (`349` lines after 2026-11-13 `W5-11`/`G7` extraction into `components/settings/{GeneralSettingsTab,AudioSettingsTab,LlmSettingsTab,AboutSettingsTab,settings-model-helpers}.ts(x)` alongside `SttSettingsTab`, `InputInsightsPanel`, `LicenseTab`, `CloudSyncSection`), `LicenseModal`, `InputConsentPanel` (receipt + current-app exclusion recommendation), `InputInsightsView` (flow, friction and app-quality summaries), `OnboardingModal`, `UpgradePromptModal`, `TemplateSection`, `FileDropZone`, `OllamaGuideModal`, `CodexOAuthGuideModal`, `TitleBar`, meeting components (`TranscriptTab` + `EditableSegment` include color-coded speaker badges and multi-speaker filter chips, 2026-11-13 `GAP-MTG-02`), voice-conversation, support (`SupportModal`), ads (`AdBanner`, `RewardedQuotaModal`), shared cards.
|
||||
|
||||
Key-binding UI lives in `components/keybinding/` (`Keycap`, `KeyBindingPicker`, `KeyBindingField`, `translation-key`), embedded in the Settings **General** tab (`SettingsModal.tsx:239`) — one field per action plus a global on/off switch. The picker offers both key recording and a searchable grouped dropdown (MUI `Autocomplete` over `KEY_CATALOG`, `KeyBindingPicker.tsx:536`). It replaced `HotkeyRecordModal`. `renderer/utils/format-hotkey.ts` is now a 17-line platform adapter only; key names, modifier glyphs, and join rules come from `@d3ro/core/keybinding`.
|
||||
|
||||
|
|
@ -212,7 +212,7 @@ Hooks: `useRealtimeConversation` (OpenAI Realtime WebRTC), `useLicenseState`, `u
|
|||
|
||||
Test-facing surface (stable, Playwright E2E depends on these): `AppSidebar` `nav-*` buttons expose `data-testid="nav-${route}"` + `aria-current="page"`; `SettingsModal` tabs expose `data-testid="settings-tab-${id}"`; onboarding mode cards expose `onboarding-mode-local|online`; `EmptyStateCard` exposes `empty-state-card`. Add a testid before writing an E2E journey; do not select by MUI classes.
|
||||
|
||||
DB schema (`src/main/db/schema.ts`, drizzle SQLite): `history`, `dictionary`, `stats`, `memo_tags`, `daily_usage`, `rag_documents`, `rag_chunks`, `meeting_sessions`, `meeting_memos`, `meeting_documents`, `input_activity` (hour × app counters), `typing_samples`, `personal_phrases`, `suggestions`.
|
||||
DB schema (`src/main/db/schema.ts`, drizzle SQLite): `history`, `dictionary`, `stats`, `memo_tags`, `daily_usage`, `rag_documents`, `rag_chunks` (incl. `embedding_blob` Float32 binary vector), `meeting_sessions`, `meeting_memos` (incl. immutable `revision` CAS counter, 2026-11-13 `GAP-SYNC-08`), `meeting_documents`, `input_activity` (hour × app counters), `typing_samples`, `personal_phrases`, `suggestions`, `phrase_edges`, `sync_outbox`, `sync_state`, plus FTS5 `tokenize = 'trigram'` virtual tables `history_fts`, `meeting_sessions_fts`, and `meeting_memos_fts` (`db/index.ts`: WAL + `synchronous = NORMAL` + `temp_store = MEMORY` + `cache_size = -16000` + `mmap_size = 67108864`). `PersonalGraphService.indexText` and `runMaintenance` execute inside single SQLite transactions, and `InputTelemetryService` only attaches high-frequency `mousemove`/`wheel` hooks and `_flushTimer` when `inputTelemetryEnabled && !inputTelemetryPaused`.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -253,7 +253,7 @@ DB schema (`src/main/db/schema.ts`, drizzle SQLite): `history`, `dictionary`, `s
|
|||
|---|---|
|
||||
| App entry / deep links | `src/main/index.ts` |
|
||||
| Bootstrap order | `src/main/bootstrap.ts` |
|
||||
| IPC registry | `src/main/ipc/index.ts` |
|
||||
| IPC registry | `src/main/ipc/index.ts`, `src/main/ipc/renderer-broadcast.ts` (`safeSendToRenderer`, `broadcastToAllWindows` SSOT across 9 IPC/bootstrap modules) |
|
||||
| IPC channel SSOT | `packages/core/src/ipc-channels.ts` |
|
||||
| Key-binding contract SSOT | `packages/core/src/keybinding.ts` (catalog, actions, validation, conflicts, formatting, parsing) |
|
||||
| Input intelligence domain SSOT | `packages/core/src/input-intelligence.ts` (key classification, typed delta, suggestion policy, overlay anchoring, flow/friction aggregation, phrase decay/ranking, provenance and exclusion recommendation) |
|
||||
|
|
@ -269,7 +269,7 @@ DB schema (`src/main/db/schema.ts`, drizzle SQLite): `history`, `dictionary`, `s
|
|||
| LLM prompt / placeholder SSOT | `src/main/services/llm-prompts.ts` (shared by `VoiceModeService`, `ChainService`, `ipc/llm-handlers.ts`) |
|
||||
| DB schema | `src/main/db/schema.ts` |
|
||||
| Renderer shell / routes | `src/renderer/components/AppLayout.tsx` |
|
||||
| Unified search | `src/main/services/UnifiedSearchService.ts`, `src/main/ipc/unified-search-handlers.ts`, `src/renderer/pages/UnifiedSearchPage.tsx` |
|
||||
| Unified search & hardening anchors | `src/main/services/UnifiedSearchService.ts` (FTS5→`LIKE` fallback + sort indexes), `src/main/ipc/unified-search-handlers.ts`, `src/renderer/pages/UnifiedSearchPage.tsx`, `src/main/services/rag/chunk-store.ts`, `src/main/services/meeting/disk-wav-audio-sink.ts`, `src/renderer/utils/error-message.ts` |
|
||||
| Update feed SSOT | `src/main/update-feed.ts` |
|
||||
| Update policy SSOT | `release/update-policy.json` + `src/main/update-policy.ts` |
|
||||
| Path/loopback resolution | `src/main/utils/paths.ts`, `src/main/utils/loopback.ts` |
|
||||
|
|
@ -278,3 +278,5 @@ DB schema (`src/main/db/schema.ts`, drizzle SQLite): `history`, `dictionary`, `s
|
|||
2026-11-01 verification: source A/B 2/17 before vs 17/17 current; real MP3/M4A conversion 2/2; account-switch regression 3/3 after reproducing all three failures; local packaged STT transcribed the synthetic 8.498 s fixture exactly. Windows 1.16.0 installer, portable and runtime are published; the rebuilt sidecar passed separate-process startup/health and the packaged Windows keyboard N-API binding loaded successfully without starting hooks. Required sidecar minimum 1.16.0 delivers CPU budgeting and terminal UIA changes. [Recovery evidence](../evidence/2026-11-01-completion.md).
|
||||
|
||||
2026-11-02 verification: installed 1.16.0 passed the actual Electron picker→timestamped transcript→local minutes/action-item journey. Native Korean IME passed 7/7 under bounded 100% CPU and 7/7 with a direct 9.389 s `gemma4:e4b` cold-load request overlapping two typing cases. The Latin-layout control exposed next-key/backspace interleaving; source now waits 140 ms at boundaries and batches the current trailing correction region after a 650 ms pause. Full desktop 2,773 tests and production build pass. The fix was published as Windows v1.16.1 on 2026-11-04; the installed-app Latin control still needs a new GUI run. Synthetic WinForms input is not physical-keyboard/Chromium/terminal proof. [Verification evidence](../evidence/2026-11-02-verification.md).
|
||||
|
||||
2026-11-14 verification (Wave 6 WS1/WS2 hygiene, optimization & bug hunt): unified `safeSendToRenderer` and `broadcastToAllWindows` across 9 IPC/bootstrap modules into `src/main/ipc/renderer-broadcast.ts`; wired `OnlineLLMService` stream abort (`_abortController` in `chatStream`), `401` token reset, empty `data.text` guard, and `D3ROError` wrapping; fixed `UnifiedSearchService` `meetingTotal` double-counting, `startedAt`/`createdAt desc` sort order, runtime FTS5-to-`LIKE` fallback (`hasAllFtsTables`), and DB indexes (`idx_meeting_sessions_started_at`, `idx_meeting_memos_created_at`); exported `invalidateEmbeddedChunksCache` across `rag/chunk-store.ts`, `rag/retrieval.ts`, `sync/sync-adapters.ts`, and `db/index.ts`, cleared redundant cached `embedding` JSON strings after `Float32Array` decode, and guarded malformed Float32 buffers; added `MAX_WAV_DATA_BYTES = 0xffffffff - 36` uint32 guard and post-`openSync` fd cleanup in `disk-wav-audio-sink.ts`; closed timer/popup hide-show races across `AdMediationEngine`, `AudioCaptureService`, `LocalLLMService`, `disposeAudioHandlers`, `bootstrap.ts`, and `WindowManager.ts`; hardened `sidecar/main.py` (`UploadFile.close()`, `<2`/odd-byte PCM handling, `_watch_disconnect`, `/shutdown` `_download_thread` join). Renderer added `src/renderer/utils/error-message.ts` (`toErrorMessage`), unified meeting/pull models, guarded non-finite dates (`formatters.ts`, `UnifiedSearchPage.tsx`), cleaned unmount/sequence/timer/listener paths across pages/modals/hooks, and hardened all 6 vanilla JS popups (`beforeunload` listener/timer cleanup, `textContent = ''`, `result-popup` `prepareVersion`/`isVisible`/rAF cancel, `caption-overlay` per-line `fadeTimer`, bounds clamps). `@d3ro/desktop` Vitest **210 files / 2,865 tests PASS**, sidecar Python `unittest` **33/33 PASS**, `npm run build` + `npm run check:desktop-renderer` (`7 page(s)`) PASS; interactive Electron GUI checks remain `[~]`.
|
||||
|
|
|
|||
|
|
@ -44,12 +44,12 @@ Root layout: `ThemeProvider → I18nProvider → AuthProvider`.
|
|||
| `actions/` | `action-runner.tsx` (LLM parse → action: create_meeting/search_knowledge/create_memo/send_team_invite) |
|
||||
| `record/` | `mic-recorder.tsx` (MediaRecorder + level analyser → `transcribeWebAudio`) |
|
||||
| `billing/` | `billing-checkout-options`, `payple-checkout-button`, `payple-client`, `payple-manage-button` |
|
||||
| `meetings/` | `document-editor`, `generate-document-button`, `live-transcript-list` (Realtime), `markdown-preview` (Mermaid), `meeting-audio-player` (signed URL), `memo-form` |
|
||||
| `meetings/` | `document-editor` (`MarkdownPreview` lazy-loaded client-only via `next/dynamic`), `generate-document-button`, `live-transcript-list` (Realtime + color-coded speaker badges & multi-speaker filter chips, 2026-11-13 `GAP-MTG-02`), `markdown-preview` (Mermaid loaded only when `` ```mermaid `` blocks exist; Wave 6 `useId()` + render-seq + `replaceChildren` `<pre>` XSS fix, `isConnected` check, `mermaidReady` reset on error), `meeting-audio-player` (signed URL), `memo-form` |
|
||||
| `chat/` | `chat-panel.tsx` |
|
||||
| `teams/` | `create-team-form`, `invite-member-form`, `activity-feed` (team notes + realtime) |
|
||||
| `teams/` | `create-team-form`, `invite-member-form`, `activity-feed` (team notes + realtime), `team-card-grid` (renders real aggregated `member_count` with localized badge) |
|
||||
| `knowledge/` | `add-knowledge-form` (text or `.txt`/`.md` file, newline-aware chunking, `embed-chunks` on submit), `knowledge-search` (semantic via `search-knowledge`) |
|
||||
| `layout/` | `sidebar.tsx` (nav, theme selector, logout, i18n) + `web-push-control.tsx` (permission/subscription status and explicit opt-in/out switch) |
|
||||
| `providers/` | `auth-provider`, `i18n-provider`, `theme-mode-context`, `theme-provider` |
|
||||
| `layout/` | `sidebar.tsx` (nav, theme selector, logout, i18n) + `locale-switcher.tsx` (12-locale selector across sidebar & login, 2026-11-13 `GAP-I18N-03`) + `web-push-control.tsx` (permission/subscription status and explicit opt-in/out switch; Wave 6 `mountedRef`/`activeUserIdRef`/`activeToggleSeqRef` + `runWebPushToggle` + `withWebPushTimeout` timeout/re-entry guards) |
|
||||
| `providers/` | `auth-provider`, `i18n-provider` (persists locale in `localStorage` `d3ro.web.locale`, auto-detects browser language across all 12 locales, updates `document.documentElement.lang`), `theme-mode-context`, `theme-provider` |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -64,6 +64,7 @@ Root layout: `ThemeProvider → I18nProvider → AuthProvider`.
|
|||
| `history-client.ts` | History list/get/update/delete, revision-safe |
|
||||
| `supabase-browser.ts` | Re-export `@d3ro/api-client/supabase-browser` |
|
||||
| `supabase-server.ts` | Next `cookies()` wrapper |
|
||||
| `team-client.ts` | Aggregates `team_members` rows into `TeamSummary.member_count` (`aggregateTeamsWithMemberCounts`, 2026-11-13; Wave 6 deduplicates `teamIds` and fails closed on `memberCountError`, `@d3ro/web` Vitest 9 files / 42 tests PASS; `dashboard/page.tsx` adds `mountedRef`/`requestSeqRef` stale-response guard) |
|
||||
| `web-device.ts` | Stable browser installation identity + active `platform='web'` device lookup/create/check-in; revoked rows are never resurrected |
|
||||
| `web-push.ts` | Web Push service-worker/VAPID subscribe/unsubscribe helper. Requires a valid active `deviceId`, persists only through register/unregister RPCs, rolls back a failed registration, re-registers an existing browser subscription before reporting it connected, and runs bounded server cleanup independently from local unsubscribe |
|
||||
| `web-push-session.ts` | Production orchestration boundary used by the sidebar and logout: user-gesture permission → device registration → subscription, plus per-user disabled intent, fail-closed reconciliation, and non-blocking logout cleanup |
|
||||
|
|
@ -75,7 +76,7 @@ Root layout: `ThemeProvider → I18nProvider → AuthProvider`.
|
|||
|
||||
Two layers:
|
||||
|
||||
- **Vitest** (`apps/web/tests/`, `npm --prefix apps/web run test`, part of root `npm test`): pure-logic contracts — `billing-catalog`, `web-push` (device/RPC/rollback/reconciliation/logout, 17 cases), `web-stt-client`.
|
||||
- **Vitest** (`apps/web/tests/`, `npm --prefix apps/web run test`, part of root `npm test`): pure-logic & SSR contracts — `billing-catalog`, `web-push` (device/RPC/rollback/reconciliation/logout, 17 cases), `web-stt-client`, `team-client` (3 cases), `locale-switcher` (3 cases), `live-transcript-speakers` (2 cases) — 6 files / 32 tests PASS.
|
||||
- **Playwright** (`apps/web/e2e/`): `smoke.spec.ts` (unauthenticated surface + fail-closed redirects + `/download` handoff), `billing`, `payple-checkout`, `dashboard-dictionary-commands`, `history` (fixture-based browser journeys).
|
||||
|
||||
---
|
||||
|
|
@ -85,9 +86,8 @@ Two layers:
|
|||
- Full App Router console: auth (email + OAuth), record/STT, history (list+detail), commands, actions, meetings (list+detail+docs), knowledge (add+search), teams (list+detail+invite), chat, dictionary, billing, download/releases.
|
||||
- Backed by Supabase tables + Edge Functions (`stt-proxy`, `llm-proxy`, `team-invite`, `team-accept`, `payple-checkout`, `payple-manage`, `search-knowledge`, `generate-meeting-document`).
|
||||
- No literal `TODO`/`FIXME` markers; remaining smaller items (see [`11-gap-backlog.md`](./11-gap-backlog.md) `WEB-*`):
|
||||
- Teams `member_count` is `0` in MVP (separate query needed) — `teams/page.tsx`.
|
||||
- Action runner team-invite uses a manual redirect safety path instead of a live invite (`action-runner.tsx`).
|
||||
- `/download` shows "artifact not yet published" for the current desktop release.
|
||||
- Knowledge file upload, semantic search, dictionary import/export, and the team activity feed are now implemented (`[x]` in the catalog).
|
||||
- `/download` shows "artifact not yet published" when the feed lacks the current version.
|
||||
- Teams `member_count` aggregation (`team-client.ts`), 12-locale `LocaleSwitcher` + `I18nProvider` persistence, speaker badges/filter chips on `LiveTranscriptList`, knowledge file upload, semantic search, dictionary import/export, and the team activity feed are implemented and unit-tested.
|
||||
- **2026-11-04 Wave 4 hygiene:** Removed the unreferenced dashboard trend chart and the web `recharts` dependency. Web Push now has a production sidebar opt-in/out flow, stable web-device registration, device-bound register/unregister RPCs, disabled-intent reconciliation, bounded local/server cleanup, logout-independent sign-out, and a Docker-copied service worker. An isolated local browser run with ephemeral VAPID proved one active web device, one `webpush` token, one pending outbox attempt, a completed drain, and a `delivered` provider result; that result proves provider acceptance, not service-worker/browser receipt. A later production-standalone run built and served successfully but timed out during throwaway login navigation before the dashboard, so production-rendered 1440/390, accessibility-tree, hit-target, permission/subscription, and receipt gates remain open. No production secrets or deployment were changed.
|
||||
- **2026-10-28 designpaca audit (`SHELL-15`):** All 15 routes and shared components aligned with `design.md` v4 ("조용한 계기"): undefined `--d3-text-inverse` replaced with `--d3-accent-ink`, minimum font size raised to `11px` (`0.6875rem`), `uppercase` and positive `letterSpacing` removed from Korean UI copy, raw `monospace` replaced with `var(--d3-font-mono)`, single `component="h1"` hierarchy enforced per route, and native form controls equipped with `:focus-visible` rings and `<label htmlFor>` / `aria-label` attributes.
|
||||
|
|
|
|||
|
|
@ -13,7 +13,7 @@ Root stack (`App.tsx` `RootNavigator`) branches on auth/onboarding:
|
|||
- `recovery` → `UpdatePassword`
|
||||
- `onboarding` → Onboarding + InviteAccept + Login
|
||||
- unauthenticated → Login, SignUp, ForgotPassword, InviteAccept
|
||||
- authenticated → `Main` (`TabNavigator`) + 23 stack screens
|
||||
- authenticated → `Main` (`TabNavigator`) + 23 stack screens (secondary stack screens use React Navigation `getComponent` lazy resolution with Metro `inlineRequires: true`, and `@d3ro/i18n` resolves `index.native.tsx` supporting all 12 locales with Metro `inlineRequires` lazy evaluation)
|
||||
|
||||
Bottom tabs (`TabNavigator.tsx`): **Home / Records / Meetings / More**. `Record` remains a hidden tab route so an active recording stays mounted; it never occupies a visible tab slot. A floating `RecordFab` appears on Home/Records/Meetings (not More/Record) and routes **dictation → Record**, **meeting recording → Meetings + `createRequest`**, **audio import → Record + `importRequest`**. Android back, scrim press, and action selection close its menu; tab back behavior is history-based.
|
||||
Home opens `UnifiedSearch` on the root stack. New and converted v4 flows use the app-level `ScreenHeader` with a 48dp back action; tab roots such as Records and Meetings show a title without a back action. Historical stack screens that were not part of this conversion may still use their own header.
|
||||
|
|
@ -33,7 +33,7 @@ Provider stack: `GestureHandlerRootView → SafeAreaProvider → AuthProvider
|
|||
| `RecordScreen` | Recording + local-whisper/cloud transcription, import audio, share; entered from the hidden Record route/FAB |
|
||||
| `TalkScreen` | Voice/text AI chat: STT, LLM streaming, TTS; opened from More on the root stack |
|
||||
| `HistoryScreen` / `HistoryDetailScreen` | History list/detail: sync, search, filters, audio playback, edit/share/favorite/delete |
|
||||
| `MeetingsScreen` / `MeetingDetailScreen` | Meeting workspaces: create/rename/delete, existing-audio import through the durable meeting queue, transcript, memos, documents/minutes, export, content report |
|
||||
| `MeetingsScreen` / `MeetingDetailScreen` | Meeting workspaces: create/rename/delete, existing-audio import through the durable meeting queue, transcript (with color-coded speaker badges & multi-speaker filter chips, 2026-11-13 `GAP-MTG-02`), memos (immutable `revision` CAS conflict detection, `GAP-SYNC-08`), documents/minutes, export, content report |
|
||||
| `MemosScreen` | Memos: list, tags, search, share |
|
||||
| `TemplatesScreen` | Dictation/meeting document templates CRUD |
|
||||
| `KnowledgeScreen` | Knowledge docs: create/import/index/merge/delete/search |
|
||||
|
|
@ -43,12 +43,12 @@ Provider stack: `GestureHandlerRootView → SafeAreaProvider → AuthProvider
|
|||
| `TeamsScreen` / `TeamDetailScreen` | Teams: create, members, invites, rename, leave, meetings, activity feed/comments |
|
||||
| `DevicesScreen` | Registered devices (phones, web, **desktop apps**), platform label, revoke/remove — revoking a desktop signs it out |
|
||||
| `NotificationsScreen` | Notification list, permission, deep-link nav |
|
||||
| `AccountScreen` | Profile, identities, data export/delete, logout |
|
||||
| `AccountScreen` | Profile (incl. 12-locale selector), identities, data export/delete, logout |
|
||||
| `DataPortabilityScreen` | Export/import archive, dictionary, history, meeting docs |
|
||||
| `AdminScreen` / `AdminUserDetailScreen` | Role-gated admin: users, subscriptions, audit, role/tier edits |
|
||||
| `ProPaywallScreen` | Pro/Pro+ paywall: Play IAP, restore, rewarded ads |
|
||||
| `OnboardingScreen` | First-run audience/theme/locale |
|
||||
| `SettingsScreen` | Preferences, locale/theme, privacy links, logout; opened from More on the root stack |
|
||||
| `OnboardingScreen` | First-run audience/theme/12-locale selector |
|
||||
| `SettingsScreen` | Preferences, 12-locale/theme selector, privacy links, logout; opened from More on the root stack |
|
||||
| `LoginScreen` / `SignUpScreen` / `ForgotPasswordScreen` / `UpdatePasswordScreen` / `InviteAcceptScreen` | Auth flows |
|
||||
|
||||
---
|
||||
|
|
@ -94,7 +94,7 @@ Source of truth for status is `docs/v3/MOBILE_APP_COMPLETION_SSOT.md` sections 0
|
|||
| Auth / account | `[~]` Implemented + Jest GREEN; external OAuth consent→callback and logout/delete/provider device E2E pending |
|
||||
| Onboarding | `[~]` unit coverage and the current `.3` isolated API 34 AVD fresh auth/signup journeys are GREEN; the historical `.2` Fold6 fresh journeys passed, but current `.3` Fold6 first-run failed twice at onboarding visibility. The 2026-11-04 `1.16.1` Fold6 result is a state-preserving upgrade/cold launch, not current physical-device first-run proof |
|
||||
| v4 shell / theme / accessibility | `[x]` shell journey at 320dp dark and 411dp light; `[~]` broader design-system/a11y proof. 2026-11-04 Android automation added current-source physical/AVD install+launch, inspected-route labels/48dp, and AVD font-scale 2.0 + rotation/scroll evidence; manual TalkBack/focus order, the SDK ad WebView, app-wide coverage, and iOS remain |
|
||||
| Large screen (tablet / unfolded foldable) | `[ ]` No adaptation. 2026-11-05 audit at ≈825dp (Fold6 OPENED) shows every screen as a single stretched phone column (no `useWindowDimensions`, breakpoints, or `numColumns`), full-width Edit/Delete/Select buttons, and an adaptive-banner height shift. See `11` GAP-UX-08 and `docs/evidence/2026-11-05-tablet-layout-audit.md` |
|
||||
| Large screen (tablet / unfolded foldable) | `[~]` **2026-11-13 (`GAP-UX-08`) implemented + Jest GREEN:** `@d3ro/ui-native/responsive` (`resolveResponsiveLayout`, `useResponsiveLayout`, `useContentWidth`, `<ContentColumn>`) applies `maxWidth: 880` (`formMaxWidth: 520` on auth/onboarding/record), `>=600dp` 2-column grids on More/Meetings/Commands/Templates, compact inline Edit/Delete/Select action buttons on Dictionary/Templates, and `90dp` adaptive-banner slot reservation (`FreeTierBanner`) across 10 screens (`responsive-layout.test.tsx` 4/4 PASS). Physical Fold6 `open`/`closed` Maestro visual confirmation remains |
|
||||
| Recording / transcription / Talk | `[x]` core path GREEN on API 34 (FGS, recovery, local Whisper, cloud fail-closed, TTS) |
|
||||
| Data portability | `[x]` export/restore + share E2E GREEN |
|
||||
| History / meetings | `[x]` real data + meeting creation contract GREEN; audio timestamp/speaker + cross-app E2E pending |
|
||||
|
|
@ -118,7 +118,7 @@ The v4 shell also removed `DashScreen` and `WorksHubScreen`. Home replaces the d
|
|||
|
||||
## 6. Tests & evidence
|
||||
|
||||
- Jest: `npm --prefix apps/mobile-rn test` — current full tree **87 suites / 599 tests PASS** (2026-11-01). Coverage includes `onboarding-fresh-route.test.tsx`, plus meeting-import creation routing and `record-screen-redteam-r2-27.test.tsx`, which proves `meetingId + importRequest` enters the durable meeting pipeline. The current `.3` Fold6 APK renders the MTG-13 entry/editor; device file selection→transcription→minutes E2E remains NOT_RUN.
|
||||
- Jest: `npm --prefix apps/mobile-rn test` — current full tree **98 suites / 625 tests PASS** (2026-11-14 Wave 6; 2026-11-13 baseline was 89 suites / 605 tests). Coverage includes `onboarding-fresh-route.test.tsx`, `responsive-layout.test.tsx` (4/4), `meeting-detail-speakers.test.tsx` (1/1), `meetings.test.ts` (18/18 incl. `revision` CAS), meeting-import creation routing and `record-screen-redteam-r2-27.test.tsx`, plus 9 Wave 6 regression suites (`durable-queue-early-discard`, `free-tier-banner-resize`, `history-detail-unmount-regression`, `meeting-detail-unmount-regression`, `onboarding-locale-regression`, `record-permission-session-regression`, `service-guards`, `settings-locale-sync-regression`, `talk-locale-recorder-regression`). Wave 6 also consolidated shared guards/cleanup/locale-speech into `features/shared/{service-guards,owned-cache-files}.ts`, `features/import/abort-guard.ts`, `lib/locale-speech.ts`, and `features/meetings/meeting-error-message.ts`, and fixed `FreeTierBanner` slot-change height stickiness (`90dp`->`50dp`), durable queue early-discard `AbortController` registration before `FileSystem.exists`, `RecordScreen` session lease leak, `TalkScreen` 12-locale TTS tags + live greeting sync, and unmount/audio/timer/locale races on `HistoryDetail`/`Settings`/`Onboarding`/`Account`/`MeetingDetail`. The current `.3` Fold6 APK renders the MTG-13 entry/editor; device file selection→transcription→minutes E2E remains NOT_RUN.
|
||||
- Maestro E2E: `apps/mobile-rn/.maestro/` + evidence in `.maestro-output/`.
|
||||
- Current `.3` isolated API 34 AVD: canonical fresh auth **37 s PASS**, signup **50 s PASS**, including persistence after restart. Initial emulator failure was observed with a System UI ANR dialog; it passed after the dialog was dismissed. Both failure and retry are retained under `test-results/recovery-2026-11-01/emulator-*`. The new empty test AVD alone used `clearState`; personal Fold6 data was preserved. This does not resolve the separate Fold6 first-run failures.
|
||||
- Historical `.2` Fold6 physical-device gate (Android 16, `SM-F956N`): fresh auth **60 s PASS**, fresh signup **67 s PASS**, warm/cold invite **31 s PASS**, and small-screen signup **61 s PASS** on 2026-11-01. Fatal/Metro matches 0; evidence is `apps/mobile-rn/.maestro-output/fold6-20261101-fix1/`. Authenticated parity was not run because test credentials are absent.
|
||||
|
|
@ -127,4 +127,4 @@ The v4 shell also removed `DashScreen` and `WorksHubScreen`. Home replaces the d
|
|||
- 2026-11-04 current-source E2E runtime: `1.16.1-e2e.20261104.1` / `2026110401`, SHA-256 `3d2875c74b555dbcd854468e57b9b4b3a8e6c9657f210760cbe24a77ee92cf7c`, verifier PASS, then state-preserving `adb install -r` and cold launch PASS on Fold6 Android 16 and API 34 AVD. Physical Notifications status/privacy/recent cards passed a `clearState:false` Maestro flow without a permission action. UIAutomator and AVD font-scale 2.0/rotation are automated evidence only; manual TalkBack, notification permission transitions/FCM receipt, app-wide a11y, and iOS remain. [Evidence](../evidence/2026-11-04-mobile-runtime-a11y.md).
|
||||
- Committed evidence summary: [`docs/evidence/wave45-mobile-shell-search-2026-09-28.md`](../evidence/wave45-mobile-shell-search-2026-09-28.md).
|
||||
- Android instrumentation: `apps/mobile-rn/android/app/src/androidTest` (CSPRNG + incoming share).
|
||||
- Build verifiers: `scripts/ci/verify-android-artifact.mjs` (legacy + Build Tools 37 signer output), `verify-android-app-links.mjs`, `verify-mobile-build-config.mjs`, `verify-mobile-release-boundary.mjs`.
|
||||
- Build verifiers: `scripts/ci/verify-android-artifact.mjs` (legacy + Build Tools 37 signer output), `verify-android-app-links.mjs`, `verify-mobile-build-config.mjs` (incl. R8 `enableProguardInReleaseBuilds=true`, `shrinkResources`, and 12-locale `localeFilters` release contract), `verify-mobile-release-boundary.mjs`. Circular root dependency `"d3ro-voice-monorepo": "file:../.."` and its NTFS junction were removed on 2026-11-13.
|
||||
|
|
|
|||
|
|
@ -38,8 +38,8 @@
|
|||
|---|---|---|
|
||||
| `POST /transcribe` | any auth | **Always `410 Gone` `stt_edge_gateway_required`** — user transcription is Edge-only |
|
||||
| `POST /internal/transcribe` | anonymous + `X-D3RO-STT-Gateway-Token` | multipart, ≤26MB; requires `D3RO_API_TOKEN`; fixed-time compare; provider orchestration; error map `503/400/502` |
|
||||
| `GET /providers` | ManagerOrAbove | List STT endpoints |
|
||||
| `POST /test?endpointId=` | ManagerOrAbove | Test endpoint |
|
||||
|
||||
*(Legacy duplicate routes `GET /api/stt/providers` and `POST /api/stt/test` were removed on 2026-11-13; back-office STT endpoint CRUD and testing live exclusively under `AdminController` `/api/admin/stt-endpoints`.)*
|
||||
|
||||
### `AdminController` (`/api/admin`, class `ManagerOrAbove`)
|
||||
All mutations flow through `ExecuteAdminMutationAsync` (idempotent + audited).
|
||||
|
|
@ -88,7 +88,7 @@ DTOs (`Dtos/Dtos.cs`): auth, license audit, LLM, admin/model endpoints, STT (tra
|
|||
|
||||
## 5. Tests (`apps/api-server.Tests/`, xUnit)
|
||||
|
||||
`AdminAuthorizationE2ETests`, `AdminOperationServiceTests`, `AuthBootstrapControllerTests`, `AuthSecurityTests`, `SttControllerSecurityTests`, `SttFailClosedTests`, `SttGatewayAuthorizationE2ETests` (26/26 per SSOT).
|
||||
`AdminAuthorizationE2ETests`, `AdminOperationServiceTests`, `AuthBootstrapControllerTests`, `AuthSecurityTests`, `SttControllerSecurityTests`, `SttFailClosedTests`, `SttGatewayAuthorizationE2ETests` (**32/32 PASS** after Wave 6 2026-11-14: enforced `MaxAudioBytes = 26 * 1024 * 1024` / `MaxBase64Length` cap in `SttProxyService.DecodeAudioBase64` before `Convert.FromBase64String`, and propagated `HttpContext.RequestAborted` `CancellationToken` across `SttController`/`LlmController`/`AdminController` → `SttProxyService`/`LlmProxyService` → EF/HTTP/AssemblyAI polling to abort paid failover immediately on client disconnect).
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -89,5 +89,6 @@ Root files: `instrumentation.ts` (startup security validation), `proxy.ts` (edge
|
|||
- `UnavailableAdminPanel` whenever Supabase env absent; writes disabled, no sample metrics.
|
||||
- `/pipelines` and dashboard node/error sections render only measured data.
|
||||
- Deploy: `apps/admin/Dockerfile` → GHCR + NAS compose; the duplicate root `Dockerfile.admin` was deleted 2026-09-26 (Wave 3, cd9d199) since `apps/admin/Dockerfile` is the one actually used. GitLab admin NAS deploy job disabled.
|
||||
- Wave 6 hardening (2026-11-14): extracted `lib/request-security.ts` (`isSameOriginRequest`, `ADMIN_UUID_PATTERN`, byte-bounded JSON body reader) and `components/detail-row.tsx` (`Row` SSOT); hardened `logout` (`sameSite: 'strict'`, CSRF, `no-store`), `license`/`login`/`backend`/`supabase` routes, `users/[id]` & `subscriptions/[id]` (`requireManager()` + UUID `notFound()`), and client unmount/timer/`sttMemo`/non-finite or negative cost guards (`payment-history`, `checksum-copy`, `license-issuer-dialog`, `models/page.tsx`).
|
||||
- **2026-11-04 Wave 4 hygiene:** Removed three unreferenced chart components (`dau-chart`, `feature-usage-chart`, `top-users-chart`) and the admin `recharts` dependency; no active admin route imported them.
|
||||
- **2026-10-28 designpaca audit (`SHELL-15`):** `console-theme.ts` `C.dim` upgraded from `#67789e` to `#7e8eb0` (WCAG AA 4.94:1 on dark card surface), `panelSx`/`innerCoreSx`/`filterBtnSx`/`statusBadgeSx`/`primaryButtonSx` flattened (removed `backdropFilter` blur, decorative gradients, `uppercase`, and positive `letterSpacing`), 1.0:1 foreground/background token collisions (`--d3-status-successBg`, `--d3-status-dangerBg`, `--d3-tag-cyanBg`) fixed across `admin-sidebar.tsx`, `ads`, `releases`, `subscriptions`, `usage`, `users`, and `login`, sub-11px font sizes raised to `11px`, and keyboard navigation (`role="button"`, `tabIndex={0}`) + `aria-label` added to sidebar and dialog controls.
|
||||
|
|
|
|||
|
|
@ -8,18 +8,18 @@
|
|||
## 1. Supabase project (`server/supabase/`)
|
||||
|
||||
- `config.toml` — project_id `d3ro-voice`; local ports API 55321 / DB 55322 / Studio 55323 / local SMTP UI 55324; DB major v17; storage 50 MiB; auth `site_url` localhost:5173, redirects include `https://d3ro.chanpaca.net` and `d3ro-voice://auth-callback`; external providers Google/GitHub/Apple; per-function `verify_jwt` settings; analytics off. The mail section uses the Supabase CLI 3.x `[local_smtp]` name rather than the removed `[inbucket]` alias.
|
||||
- `seed.sql`, `migrations/` (73 source files; last confirmed production state was `20260927000036`), `functions/` (24 source functions; the 23 functions present on 2026-09-27 were redeployed that day), `functions/_shared/`, `tests/`, `deno.json`.
|
||||
- `seed.sql`, `migrations/` (74 source files; last confirmed production state was `20260927000036`, with `20261113000001_meeting_memos_revision_cas.sql` pending production push), `functions/` (24 source functions; the 23 functions present on 2026-09-27 were redeployed that day), `functions/_shared/`, `tests/`, `deno.json`.
|
||||
|
||||
> Note: root `supabase/` contains only empty scaffolding (`.branches/`, `snippets/`). The real project lives under `server/supabase/`.
|
||||
|
||||
### 1.1 Migrations (73) — thematic groups
|
||||
### 1.1 Migrations (74) — thematic groups
|
||||
|
||||
| Theme | Examples |
|
||||
|---|---|
|
||||
| Core schema + RLS + auth triggers | initial tables, profiles, triggers |
|
||||
| Storage buckets | audio, meeting documents, exports |
|
||||
| Teams | team invites, membership, roles, `team_activities` feed (`20260913000033`) |
|
||||
| Cross-device sync | `20260927000036`: preset prompt RPCs `sync_set_builtin_instruction_prompt_v1` / `sync_list_builtin_instructions_v1` + default SSOT `builtin_instruction_default_prompt_v1`. `20260927000035`: knowledge_documents tombstones/cursor/realtime + `pg_cron` job `prune-sync-tombstones` (daily 03:17 UTC). `20260927000034`: `sync_tombstones` (AFTER DELETE triggers on 8 synced tables, owner-read RLS, realtime, `prune_sync_tombstones_v1`), `history.revision` bump on content change, `meeting_memos.updated_at`, `(user_id, updated_at, id)` cursor indexes, client-keyed `sync_upsert/delete_user_template_v1`, realtime for `devices`/`memo_tags`/`custom_instructions`/`user_templates`, and `export_account_portability` projected back onto v1 archive keys |
|
||||
| Cross-device sync | `20261113000001`: immutable `meeting_memos.revision` integer column + BEFORE UPDATE trigger (`bump_meeting_memo_revision`) so A→B→A edits always advance `revision` for CAS conflict detection (`GAP-SYNC-08`). `20260927000036`: preset prompt RPCs `sync_set_builtin_instruction_prompt_v1` / `sync_list_builtin_instructions_v1` + default SSOT `builtin_instruction_default_prompt_v1`. `20260927000035`: knowledge_documents tombstones/cursor/realtime + `pg_cron` job `prune-sync-tombstones` (daily 03:17 UTC). `20260927000034`: `sync_tombstones` (AFTER DELETE triggers on 8 synced tables, owner-read RLS, realtime, `prune_sync_tombstones_v1`), `history.revision` bump on content change, `meeting_memos.updated_at`, `(user_id, updated_at, id)` cursor indexes, client-keyed `sync_upsert/delete_user_template_v1`, realtime for `devices`/`memo_tags`/`custom_instructions`/`user_templates`, and `export_account_portability` projected back onto v1 archive keys |
|
||||
| Knowledge / RAG | `knowledge_documents`, `knowledge_chunks`, pgvector |
|
||||
| Notifications / push | push tokens, durable outbox |
|
||||
| Billing | Payple, subscriptions, payment provider events/operations (`'stripe'` provider values kept only for historical rows) |
|
||||
|
|
@ -102,3 +102,11 @@ Shared TS types for these live in `packages/api-client` (SSOT).
|
|||
- Audio purge source wiring, unit tests, and an isolated local pg_cron/Vault invocation are verified: the fixture queue, `audio_files` row, and Storage object each changed from one to zero and `net._http_response` recorded HTTP 200. Deployment and the production schedule/Vault/object path remain unverified.
|
||||
|
||||
External gates are enumerated in `docs/v3/MOBILE_APP_COMPLETION_SSOT.md` §0/§6 and mirrored in `11-gap-backlog.md` (`EXT-*`, `BE-*`).
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Wave 6 hardening (2026-11-14)
|
||||
|
||||
- **Supabase Edge Functions (`server/supabase/functions`, Deno `270 passed | 0 failed`):** consolidated `jsonResponse`/`json` and streaming byte-bounded `readJsonBody` into `_shared/json-response.ts` across 20 Edge handlers (preserving CORS/`Cache-Control`/header contracts and failing closed with 400/413 on invalid/oversized JSON); hardened `account-delete` (`SAFE_INTERNAL_CODES`), `llm-proxy` (502 + quota refund on invalid provider JSON), `_shared/payple.ts` (`postPaypleJson` with `AbortSignal.timeout`), and `realtime-token/openai-provider.ts` (`AbortSignal.timeout`), backed by `_shared/json-response.test.ts` and tests in `payple`, `realtime-token`, `llm-proxy`, and `stt-proxy`.
|
||||
- **Cloudflare Worker (`server/cloudflare-worker`, Deno `9 passed | 0 failed`):** added `resolveBackendTargetUrl` blocking `//host`/`\host` SSRF, omitted `backendOrigin` from `/worker-health`, stripped `Host`/hop-by-hop headers, set `redirect: 'manual'`, added `AbortSignal.timeout(30_000)`, sanitized 502/504 JSON responses, removed `console.log`, canceled unread `!response.ok` response bodies in `push-drain.ts`, and added 4 regression tests in `src/index.test.ts`.
|
||||
|
|
|
|||
|
|
@ -20,7 +20,7 @@ Status quick-reference: `[x]` done+verified · `[~]` partial/unverified · `[ ]`
|
|||
| CAP-04 | Recording waveform + level meter | [x] | [x] | [x] | [-] | Desktop 9-bar cos distribution; mobile audio level; the recording-tip popup bundle and its on-disk assets are verified by `scripts/ci/verify-desktop-renderer-bundles.mjs` |
|
||||
| CAP-05 | Device/mic selection | [x] | [ ] | [~] | [-] | Desktop config; mobile uses system default |
|
||||
| CAP-06 | System/loopback audio capture | [x] | [-] | [ ] | [-] | Desktop only (caption source); mobile policy-limited |
|
||||
| CAP-07 | Local Whisper STT | [x] | [-] | [x] | [-] | Desktop ships the faster-whisper sidecar (`resources/sidecar`, built by `sidecar:build`, verified by `scripts/ci/verify-sidecar-bundle.mjs`), warms it up at app start, and connects over IPv4 loopback; mobile on-device Whisper (supported devices) **2026-10-30: sidecar/cpu_budget.py applies the same bounded worker policy to primary/auxiliary Whisper models and CPU fallback; budget and constructor regression tests pass. 2026-11-01: rebuilt sidecar startup/health passed and runtime 1.16.0 is published; actual high-load typing remains open (GAP-INPUT-11).** |
|
||||
| CAP-07 | Local Whisper STT | [x] | [-] | [x] | [-] | Desktop ships the faster-whisper sidecar (`resources/sidecar`, built by `sidecar:build`, verified by `scripts/ci/verify-sidecar-bundle.mjs`), warms it up at app start **only when `sttProvider === 'local'`**, unloads the primary Whisper model (`POST /unload` `slot:"primary"`) on cloud-provider switch or after 15 min idle while keeping `/uia/focus` alive, and connects over IPv4 loopback; mobile on-device Whisper (supported devices) **2026-10-30: sidecar/cpu_budget.py applies the same bounded worker policy to primary/auxiliary Whisper models and CPU fallback; budget and constructor regression tests pass. 2026-11-01: rebuilt sidecar startup/health passed and runtime 1.16.0 is published; actual high-load typing remains open (GAP-INPUT-11).** |
|
||||
| CAP-08 | Cloud STT (multi-provider) | [x] | [x] | [x] | [x] | Desktop 6 providers + D3RO Cloud; web/mobile via `stt-proxy`; .NET internal gateway |
|
||||
| CAP-09 | STT auto-fallback + fail-closed | [x] | [x] | [x] | [x] | `STTManager`; SSOT R-021/R-022 GREEN |
|
||||
| CAP-10 | STT model download/management UI | [x] | [-] | [~] | [-] | Desktop model manager + onboarding; mobile bundled model |
|
||||
|
|
@ -68,7 +68,7 @@ Status quick-reference: `[x]` done+verified · `[~]` partial/unverified · `[ ]`
|
|||
| MEM-12 | Voice actions (OS automation) | [x] | [x] | [x] | [x] | Desktop `VoiceActionService`; web `ActionRunner` (simulated); mobile `ActionsScreen` |
|
||||
| MEM-13 | Cross-surface data sync | [~] | [x] | [x] | [x] | **Desktop rewritten 2026-09-27** (`services/sync/SyncEngine.ts`): persistent outbox (offline/restart safe), server-clock keyset cursors per user DB with pagination, pending local edits never overwritten by pull, deletions both ways through `sync_tombstones`, per-row failure isolation, Realtime that actually connects (`ws` transport). Covers history (+title/favorite), dictionary, meetings, meeting memos/documents, memo tags, custom commands, dictation + meeting-doc templates; plus device registration. Evidence: `apps/desktop/tests/main/sync/SyncEngine.test.ts` (20) + `apps/desktop/tests/integration/cross-device-sync.supabase.test.ts` (5, local Supabase stack). `[~]` until migration `20260927000034` is deployed to production and a desktop build is exercised against a phone (GAP-SYNC-05); knowledge/audio/settings still local (GAP-SYNC-06) **2026-09-27 second batch:** knowledge base, recordings (upload + remote playback) and the mobile `user_settings` fields that mean the same thing on both sides (ko/en locale, system/light/dark theme, auto-polish on/off, active user command) now sync too; remote setting changes reach the open window (`app:dataChanged`, `config:changed`). Production DB is at migration `0035` and all Edge Functions are redeployed from the repo |
|
||||
| MEM-14 | Memo tag search | [x] | [ ] | [x] | [x] | |
|
||||
| MEM-15 | Unified record + meeting search | [~] | [ ] | [x] | [-] | Shared `@d3ro/core/types` result contract. **2026-10-30 (`GAP-UX-05`):** Mobile (`unified-search-service.ts`, `UnifiedSearchScreen.tsx`) now supports `AbortSignal`/`AbortController` in-flight cancellation, `transcripts` segment table search (`searchTranscriptSegments`), and bounded payload projection (`boundPayloadText`), verified by `unified-search-service.test.ts` + 320dp dark/411dp light runtime journeys (`[x]`). Desktop (`UnifiedSearchService.ts`) searches `history`, `meetings`, `meetingMemos`, and timed transcript segments (`UnifiedSearchService.test.ts` 12/12 PASS; `[~]` pending Electron `Ctrl+K` manual check). |
|
||||
| MEM-15 | Unified record + meeting search | [~] | [ ] | [x] | [-] | Shared `@d3ro/core/types` result contract. **2026-10-30 (`GAP-UX-05`):** Mobile (`unified-search-service.ts`, `UnifiedSearchScreen.tsx`) now supports `AbortSignal`/`AbortController` in-flight cancellation, `transcripts` segment table search (`searchTranscriptSegments`), and bounded payload projection (`boundPayloadText`), verified by `unified-search-service.test.ts` + 320dp dark/411dp light runtime journeys (`[x]`). Desktop (`UnifiedSearchService.ts`) searches `history`, `meetings`, `meetingMemos`, and timed transcript segments — **upgraded 2026-11-13 with SQLite FTS5 `tokenize = 'trigram'` virtual tables (`history_fts`, `meeting_sessions_fts`, `meeting_memos_fts`) and `<3`-char `LIKE` fallback, and hardened 2026-11-14 (Wave 6 WS1) with `startedAt`/`createdAt desc` sort indexes (`idx_meeting_sessions_started_at`, `idx_meeting_memos_created_at`), `meetingTotal` double-count fix, and `hasAllFtsTables` runtime FTS5→`LIKE` fallback** (`UnifiedSearchService.test.ts` 17/17 + `sqlite-optimizations.test.ts` 4/4 PASS; `[~]` pending Electron `Ctrl+K` manual check). |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -83,7 +83,7 @@ Status quick-reference: `[x]` done+verified · `[~]` partial/unverified · `[ ]`
|
|||
| MTG-05 | Document generation (minutes/report/idea-note/mindmap) | [x] | [x] | [x] | [x] | Edge `generate-meeting-document`; SSOT F-011 GREEN |
|
||||
| MTG-06 | Document edit (Markdown) | [x] | [x] | [x] | [x] | Desktop editor; web `document-editor` |
|
||||
| MTG-07 | Export PDF/DOCX/TXT/Markdown | [x] | [~] | [x] | [x] | Desktop `ExportMenu`; web markdown; mobile print/DOCX chooser (SSOT data portability GREEN) |
|
||||
| MTG-08 | Speaker diarization | [~] | [ ] | [ ] | [ ] | Desktop `phase-15.5` (LLM estimate + pyannote prep); mobile SSOT H-014 pending |
|
||||
| MTG-08 | Speaker diarization | [~] | [x] | [x] | [-] | **2026-11-13 (`GAP-MTG-02`, SSOT `H-014`):** Desktop `sidecar/main.py` `POST /diarize` (pyannote.audio when installed + acoustic energy-VAD turn segmentation fallback) wired via `LocalSTTService.sidecarBaseUrl` into `MeetingModeService._diarizeTranscript` with LLM fallback, `stripInventedMarkers({ allowSpeakerMarkers })`, and `@d3ro/core/meeting-transcript` speaker utilities (`extractTranscriptSpeakers`, `filterTranscriptEntriesBySpeaker`, `formatSpeakerBadgeLabel`). Speaker badges and multi-speaker filter chips shipped and unit-tested across Desktop (`TranscriptTab.tsx` / `EditableSegment.tsx`), Web (`live-transcript-list.tsx`), and Mobile (`MeetingDetailScreen.tsx`, `meetings.test.ts` 18/18 PASS). Desktop remains `[~]` pending a live multi-speaker audio GUI run. |
|
||||
| MTG-09 | Audio seek ↔ transcript timestamp | [x] | [x] | [x] | [-] | **2026-10-30 (`GAP-MTG-01` `[x]`):** Desktop (`TranscriptTab.tsx` / `EditableSegment.tsx`), Web (`meeting-audio-player.tsx` ↔ `live-transcript-list.tsx`), and Mobile (`meetings-service.ts`, `MeetingDetailScreen.tsx`) parse `[MM:SS]` / `timestamp_ms` segments, seek audio on badge tap, and highlight the active transcript segment (`__tests__/meetings.test.ts` PASS). |
|
||||
| MTG-10 | Meeting list search/filter/sort | [~] | [ ] | [~] | [x] | Basic lists; advanced filters pending |
|
||||
| MTG-11 | Meeting AI chat over transcript | [x] | [ ] | [ ] | [x] | Desktop `MeetingChatPanel` + `MEETING_CHAT` |
|
||||
|
|
@ -198,7 +198,7 @@ end-to-end behaviour has **not been verified by typing in a real app** (`11` GAP
|
|||
|---|---|---|---|---|---|---|
|
||||
| SHELL-01 | Settings / preferences | [x] | [~] | [x] | [x] | **2026-09-28 개편:** 데스크톱 설정은 모달이 아니라 메인 창 전체 화면 라우트(`settings`) — 왼쪽 세로 탭 8개 + 본문 `components/settings/SettingsRows`(구획 h3 + 라벨·설명/컨트롤 행). 일반 탭에 키 바인딩 편집기(CAP-16). 이전 기록: Desktop tabbed modal; the General tab hosts the whole key-binding editor (CAP-16: global on/off switch + one `KeyBindingField` per action, grouped voice/window — `SettingsModal.tsx:239`), which is also the first settings entry point the `command` action ever had; web theme/i18n; mobile `SettingsScreen` |
|
||||
| SHELL-02 | Theme system (6 themes) | [x] | [x] | [x] | [-] | `theme.ts` SSOT |
|
||||
| SHELL-03 | i18n (12 locales) | [x] | [~] | [~] | [-] | `@d3ro/i18n`; all 12 catalogs (`ko`, `en`, `ja`, `zh`, `zh-TW`, `es`, `fr`, `de`, `pt`, `ru`, `vi`, `th`) are synchronized to 2,742 keys and guarded by `i18n-locale-parity.test.ts` (15/15 PASS), including the updater dialog keys added on 2026-11-04. Catalog parity is not surface exposure: web has no locale selector and mobile currently exposes ko/en only (`GAP-I18N-03`, SSOT `O-012`), so those surfaces remain `[~]`. |
|
||||
| SHELL-03 | i18n (12 locales) | [x] | [x] | [~] | [-] | `@d3ro/i18n`; all 12 catalogs (`ko`, `en`, `ja`, `zh`, `zh-TW`, `es`, `fr`, `de`, `pt`, `ru`, `vi`, `th`) pruned of 253 dead keys to **2,500 keys × 12 locales** and guarded by `npm run check:i18n` (`scripts/ci/check-i18n-contract.mjs`), `sync-i18n-locales.mjs --check`, `packages/i18n/__tests__/locale-contract.test.ts` (15/15 PASS), and `i18n-locale-parity.test.ts` (15/15 PASS). **2026-11-13 (`GAP-I18N-03`, SSOT `O-012`):** split into dynamic 10-locale web/renderer chunks (`@d3ro/i18n`), zero-React single-locale Node loader (`@d3ro/i18n/main`), and 12-locale Metro `inlineRequires` React Native entry (`index.native.tsx`). Web exposes a 12-locale `LocaleSwitcher` in the app shell with storage persistence (`locale-switcher.test.tsx` 3/3 PASS); Mobile exposes all 12 locales across `OnboardingScreen`, `SettingsScreen`, and `AccountScreen` + Android `localeFilters` for all 12 resource qualifiers (`verify-mobile-build-config.mjs` enforced; `[~]` on mobile pending physical-device non-ko/en visual pass). |
|
||||
| SHELL-04 | Onboarding / first-run | [x] | [ ] | [~] | [-] | Desktop model bootstrap (`onboarding.llmModelSize` aligned to 4.0GB `gemma4:e4b`, `GAP-UX-07` `[x]`); mobile audience/theme/locale. **2026-11-01:** 신규 사용자 목적지를 persistence 전에 준비하도록 수정하고 Fold6에서 `.2` fresh auth/signup/invite/small-screen 4/4 PASS (`fold6-20261101-fix1`); latest `.3` first-run auth and retry fail at onboarding visibility (`fold6-20261101-mtg13`). Exact `.3` APK now passes isolated API 34 emulator fresh auth 37 s / signup 50 s with restart persistence; personal Fold6 data was preserved and its separate failures remain open. |
|
||||
| SHELL-05 | Accessibility / reduced motion | [~] | [~] | [~] | [-] | Desktop reduced-motion honored. Mobile source labels/roles and 48dp tests plus 2026-11-04 inspected-route UIAutomator/font-scale/rotation evidence are partial GREEN; the AdMob SDK descendant exposed one unlabeled clickable WebView. Manual TalkBack/focus order, reduced-motion/app-wide coverage, and iOS remain ([evidence](../evidence/2026-11-04-mobile-runtime-a11y.md)). |
|
||||
| SHELL-06 | System tray / background | [x] | [-] | [-] | [-] | Desktop tray |
|
||||
|
|
@ -206,7 +206,7 @@ end-to-end behaviour has **not been verified by typing in a real app** (`11` GAP
|
|||
| SHELL-08 | Auto-update | [x] | [-] | [!] | [-] | Desktop electron-updater; Forgejo canonical feed; channels + mandatory/major-vs-delta policy (`release/update-policy.json`); mobile store updates **2026-10-24 UI:** updates are now visible in the app, not only through native dialogs. Settings → About opens with an Updates section (`components/settings/UpdateSection.tsx`): status, progress bar, last check, and Check / Download / Restart-to-install buttons. A title-bar chip (`components/shell/UpdateChip.tsx`) appears only while an update is available, downloading or ready, and opens that tab. IPC `appUpdate:getStatus|check|download|install` plus the `appUpdate:statusChanged` event; state comes from `UpdateService.getStatus()`. A skipped version still shows, and downloading it manually clears the skip. Dev and portable builds show "disabled". **2026-11-04:** native consent/restart dialogs resolve `getPopupTranslator()` at each prompt, so a runtime locale change is not cached; ko→en behavior is covered by `update-dialog-i18n.test.ts`. The isolated `--preview-update-dialogs` packaged-QA entry calls the real prompter without updater/feed/install side effects and is covered by entry/prompt tests. The current-source package/ABI passed, but the native dialog appearance and interaction remain an external-desktop gate (`GAP-QA-04`). |
|
||||
| SHELL-09 | Support / diagnostics | [x] | [ ] | [ ] | [x] | Desktop `SupportModal` (`support-handlers.ts` strict-typed, `GAP-REL-15` `[x]`); admin `/support` fail-closed `content_reports` & support console (`GAP-SHELL-01` `[x]`). |
|
||||
| SHELL-10 | Download center / releases | [-] | [x] | [-] | [x] | Web `/download`, admin `/releases`, Forgejo |
|
||||
| SHELL-11 | Landing site / legal pages | [-] | [-] | [-] | [-] | `site/` — the only landing/download/legal/invite/assetlinks surface (Wave 3, 2026-09-26: copies in api-server wwwroot and apps/web removed; 404.html; hero loops a copy of the app recording capsule). Prices/URLs from `packages/core` plan-catalog/web-urls — see `design.md`. **2026-10-28 designpaca audit:** flat header (`Header.tsx` blur removed), WCAG AA contrast verified across all 14 routes (`ko`..`vi`, `privacy`, `terms`, `delete-account`, `accept-invite`), `legal.css` explicit `font-weight: 500/600` (no `>=700` fallback), `accept-invite` polite Korean register (`해요체`) and `--faint`/`--accent` AA contrast. |
|
||||
| SHELL-11 | Landing site / legal pages | [-] | [-] | [-] | [-] | `site/` — the only landing/download/legal/invite/assetlinks surface (Wave 3, 2026-09-26: copies in api-server wwwroot and apps/web removed; 404.html; hero loops a copy of the app recording capsule). Prices/URLs from `packages/core` plan-catalog/web-urls — see `design.md`. **2026-10-28 designpaca audit:** flat header (`Header.tsx` blur removed), WCAG AA contrast verified across all 14 routes (`ko`..`vi`, `privacy`, `terms`, `delete-account`, `accept-invite`), `legal.css` explicit `font-weight: 500/600` (no `>=700` fallback), `accept-invite` polite Korean register (`해요체`) and `--faint`/`--accent` AA contrast. **2026-11-13 (`W5-12`):** `typecheck:site`, `lint:site` (`--max-warnings=0`), and `site` production build wired into root `verify:all` and `.forgejo/workflows/ci.yml`. **2026-11-14 (Wave 6 `WS4`):** `AppLoopDemo.tsx` separates `isHidden`/`isOutOfViewport` with `IntersectionObserver` guard, and `Download.tsx`/`Footer.tsx` upgrade external links to `rel="noopener noreferrer"`. |
|
||||
| SHELL-12 | Notifications (in-app / desktop) | [x] | [ ] | [x] | [x] | Desktop events; mobile push |
|
||||
| SHELL-13 | Desktop/mobile information architecture (2026-09-28) | [x] | [-] | [x] | [-] | 1급 홈·기록·회의 + 2급 도구. Desktop: `renderer/navigation/app-navigation.tsx`, `AppSidebar`, status bar removed. Mobile: visible Home/Records/Meetings/More tabs, hidden Record route, floating three-action Record FAB, More tool/account grouping; full Jest and the canonical 320dp dark/411dp light runtime journeys are GREEN (`11` GAP-UX-04). `DashScreen`/`WorksHubScreen` were removed; WorksHub-only local filter/pinning was intentionally retired while every destination remains in tabs/More and user content is untouched. Decision SSOT: root `design.md`. |
|
||||
| SHELL-14 | Home ("오늘") | [x] | [-] | [x] | [-] | Desktop `pages/HomePage.tsx`: recording key, starts, blockers, summary, recent 6/4, file transcription, bounded usage. Mobile `HomeScreen`: today summary, recent records 5/meetings 3, unified-search and plan entry; canonical 320dp dark and 411dp light runtime journeys GREEN. |
|
||||
|
|
@ -232,7 +232,7 @@ end-to-end behaviour has **not been verified by typing in a real app** (`11` GAP
|
|||
| INFRA-11 | Docker + NAS deploy | [x] | `docker-compose.nas.yml`, `scripts/deploy-nas.*` |
|
||||
| INFRA-12 | Cloudflare edge + tunnel | [x] | `server/cloudflare-worker`, Cloudflare Tunnel `kd-nas` |
|
||||
| INFRA-13 | Site deploy (Cloudflare Pages) | [x] | `.forgejo/workflows/deploy-site.yml`; the unused GitHub Pages workflow was removed in Wave 3 |
|
||||
| INFRA-17 | Test hygiene gate (TDD policy) | [x] | `scripts/ci/check-test-hygiene.mjs` (`npm run test:hygiene` + `:test`), wired into `.forgejo/workflows/ci.yml` quality and `.gitlab-ci.yml` validate. Rules: `.only`, reason-less `.skip()`, trivial assertions, `isVisible()`-gated assertions, machine paths, `waitForTimeout`, `.e2e.test.ts`, `e2e/` 밖의 `*.spec.ts`, assertion-free files. Applied policy + deletion/consolidation log: `docs/tdd-red/06-repo-application.md`. |
|
||||
| INFRA-17 | Test hygiene & TDD v2.0 gates | [x] | `scripts/ci/check-test-hygiene.mjs` (`test:hygiene`), `check-protected-tests.mjs` (`check:protected-tests`), `check-test-quality.mjs` (`test:quality`), `check-i18n-contract.mjs` (`check:i18n`), `check-ds-contract.mjs` (`check:ds-contract`), `run-affected-tests.mjs` (`test:affected`), `verify-desktop-installer-smoke.mjs` (`release:installer:smoke`), and `@d3ro/core/ports` (`Clock`/`Random` deterministic ports) — all equipped with `--self-test` and wired into `verify:all`, `.forgejo/workflows/ci.yml`, `release-desktop.mjs`, and `.forgejo/workflows/release.yml`. Applied policy: `docs/tdd-red/06-repo-application.md`, `07-revamp-plan.md`. |
|
||||
| INFRA-15 | Update & release system | [x] | Canonical Forgejo feed + channels/policy (`release/update-policy.json`, `src/main/update-policy.ts`), canonical publisher `scripts/ci/publish-forgejo-release.mjs`, legacy GitLab mirror; `npm run release:metadata:test`. v1.1.0 was published to Forgejo on 2026-09-15; product version moved to `1.2.0` as a forward-fix with CI-only publication, a same-version re-release guard, and download centers that link the feed instead of repository paths. `1.3.0` (2026-09-18) carries the local-STT fixes; Windows publication still needs the CI signing secrets (`11` GAP-REL-02). |
|
||||
| INFRA-16 | Desktop STT engine packaging | [x] | `apps/desktop/scripts/setup-sidecar.mjs` + `build-sidecar.mjs`, `electron-builder.yml` `extraResources` (`sidecar-dist/sidecar` → `resources/sidecar`, `resources/ffmpeg`), and `scripts/ci/verify-sidecar-bundle.mjs` run in `package-windows`/`package-macos` before electron-builder. Verified on the real bundle: `sidecar.exe` + `_internal` including `faster_whisper/assets/silero_vad_v6.onnx`, plus a packaged-engine transcription round-trip on GPU. |
|
||||
| INFRA-17 | 서명 없는 배포 채널 (portable + Scoop) | [x] | `scripts/ci/build-portable.mjs` (95MiB 7z 분할 볼륨 + Scoop 매니페스트), `scripts/ci/publish-portable-release.mjs`, `scripts/local/install-d3ro-voice.ps1`, `bucket/` 버킷, `.forgejo/workflows/portable.yml`; 7z 분할 볼륨(Scoop, 162MiB) + zip 분할 부품(수동 설치, 243MiB, 7-Zip 불필요); updater feed와 분리. 2026-09-18 `portable-1.3.1` 게시 + 실제 설치 검증. |
|
||||
|
|
|
|||
|
|
@ -39,7 +39,7 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
|
|||
| GAP-CI-04 | CI | Forgejo build validation과 root `build:all`이 web production build를 생략했고, migration checker도 CI quality gate에 연결되지 않았다. | `.forgejo/workflows/ci.yml`, `scripts/ci/build-all.mjs`, `scripts/ci/check-supabase-migrations.mjs` | `[x]` 2026-11-04: web production build를 두 경로에 추가하고 CI quality에서 `check:migrations:test` → `check:migrations`를 실행한다. CI 자체는 73개 파일의 naming/order/metadata 검사다. 같은 날 별도 격리 로컬 스택에서 empty/reset replay 73/73과 `pg-delta --strict-coverage` shadow diff 0을 확인했지만, 이 runtime gate는 아직 CI에 자동화되지 않았고 linked remote drift도 확인하지 않았다. |
|
||||
| GAP-CI-01 | CI | macOS 빌드·서명 러너가 없다. `.github`의 build-mac·release-signing-ca는 실행된 적 없이 삭제됐다. | `.forgejo/workflows/*`, `.gitlab-ci.yml` | `[!]` EXT: Mac 호스트에 Forgejo runner(`macos` 라벨)를 붙이거나 GitLab `package-macos` 사용. 서명된 Android 릴리스는 GitLab `mobile-production-release`가 정본. |
|
||||
| GAP-I18N-02 | Desktop | 녹음 캡슐의 "처리 중..."이 `recording-tip/index.html`에 한국어로 고정돼 앱 언어를 따르지 않는다. | `apps/desktop/src/renderer/popups/recording-tip/*`, `WindowManager.getPopupI18nStrings` | `[x]` 2026-09-28: 캡슐 문구는 main `_i18n`(popup.tip.*)으로, 오류는 `@d3ro/core/voice-error-message` 분류 → 사용자 언어 문구(bootstrap 이 error.code 를 넘기지 않던 버그 포함). 팝업 문서 lang 도 앱 언어. |
|
||||
| GAP-I18N-03 | i18n | 12개 locale catalog의 키 정합성과 실제 제품 표면의 언어 선택 범위가 혼동돼 web/mobile이 12개 언어 완료로 표시됐다. | `packages/i18n/src/locales/*`, `apps/web`, `apps/mobile-rn`, `docs/v3/MOBILE_APP_COMPLETION_SSOT.md` O-012 | `[~]` 2026-11-04: 12개 catalog는 2,742키 parity가 있고 updater dialog도 모두 동기화됐다. 그러나 web에는 locale selector가 없고 mobile은 ko/en 표면만 제공한다. 각 표면의 selector·routing·전체 번역 런타임 검증 후 `SHELL-03` W/M을 `[x]`로 올릴 것. |
|
||||
| GAP-I18N-03 | i18n | 12개 locale catalog의 키 정합성과 실제 제품 표면의 언어 선택 범위가 혼동돼 web/mobile이 12개 언어 완료로 표시됐다. | `packages/i18n/src/{locales/*,index.native.tsx}`, `scripts/ci/check-i18n-contract.mjs`, `apps/web/src/components/layout/locale-switcher.tsx`, `apps/mobile-rn/src/screens/{Onboarding,Settings,Account}Screen.tsx`, `apps/mobile-rn/android/app/build.gradle` | `[~]` **2026-11-13 코드·계약·단위 검증 완료:** 미참조 253개 고아 키를 정리해 **2,500키 × 12로케일** 정합성을 `check:i18n`·`sync-i18n-locales.mjs --check`·`locale-contract.test.ts`(15/15 PASS)로 고정하고, 웹 사이드바/셸에 12개 언어 `LocaleSwitcher`+`I18nProvider` 영속화(`locale-switcher.test.tsx` 3/3 PASS)를, 모바일 `index.native.tsx`(Metro `inlineRequires` 12개 로케일 로더)·온보딩/설정/계정 화면 12개 언어 선택기·Android 12개 `localeFilters`(`verify-mobile-build-config.mjs` 검증)를 모두 구현했다(`SHELL-03` W `[x]`, M은 실기기 비-한/영 로케일 화면 눈 확인 전까지 `[~]`). |
|
||||
| GAP-UX-01 | Desktop | 회의 "내 메모"(상세 탭)는 이 기기 localStorage 에만 저장된다 — 기기 간 동기화되지 않는다. 끝난 회의에는 addMemo 가 거부된다(`MeetingModeService.ts:383`). | `components/meeting/meeting-notepad-storage.ts`, `MeetingModeService`, `MeetingNotesTab.tsx`, `tests/unit/desktop-ux-gaps.test.ts`, `tests/red/meeting.usecase.test.ts` | `[x]` 2026-10-30: `MeetingModeService.addMemo(content, meetingId?)`가 종료된 회의(`meetingId` 또는 `_finalizedSessionId`)에도 메모를 추가·저장하고 `CloudSyncService.pushOne('meeting_memos', memo.id)`로 기기 간 동기화하며, `MeetingNotesTab.tsx`가 `syncNotepadMemo`(`meeting-notepad-storage.ts`)로 내 메모를 동기화한다. 검증: `desktop-ux-gaps.test.ts` 13/13, `meeting.usecase.test.ts` 23/23 통과. |
|
||||
| GAP-UX-02 | Desktop | 기록 조회에 모드·즐겨찾기 조건, 태그+검색 조합이 없어 화면이 불러온 페이지 위에서 거른다(조건이 까다로우면 여러 페이지를 불러와야 보인다). 오프셋 페이지라 사이 삽입·삭제 때 누락·중복 가능. 기록 제목·본문 편집 없음. 마크다운 내보내기는 태그 붙은 기록만·저장 위치 선택 불가. | `HistoryService`, `history-handlers.ts`, `MemoService.exportMarkdown`, `HistoryEntryCard.tsx`, `HistoryPage.tsx`, `tests/unit/records-view.test.ts`, `tests/red/memo.usecase.test.ts` | `[x]` 2026-10-30: `HistoryService.list`/`getAll`에 SQLite 직접 조건(`mode`, `isFavorite`, `tag`, `search`/`query`, `beforeCreatedAt` 커서 페이지네이션)을 추가하고, `HistoryService.update`(`history:update` IPC + `HistoryEntryCard` 인라인 편집 + 동기화 push)와 `MemoService.exportMarkdown`(무태그 기록 포함, 필터 연동, `savePath` 및 저장 대화상자 선택)을 구현했다. 검증: `records-view.test.ts` 21/21, `memo.usecase.test.ts` 15/15 통과. |
|
||||
| GAP-UX-03 | Desktop | 회의 요약 항목 → 전사 구간 근거 링크 없음(요약·전사를 잇는 인용 데이터가 없다). | `MeetingSummaryService`, `MarkdownRenderer.tsx`, `MeetingSummaryTab.tsx`, `MeetingDetailTabs.tsx`, `TranscriptTab.tsx`, `EditableSegment.tsx`, `tests/unit/desktop-ux-gaps.test.ts` | `[x]` 2026-10-30: `MeetingSummaryService`가 요약·결정·액션아이템에 `[MM:SS]` 타임스탬프 근거 인용을 생성·파싱(`parseCitationTimestampMs`, `extractTranscriptCitations`)하고, `MarkdownRenderer`/`MeetingSummaryTab`에서 인용 배지 클릭 시 전사 탭의 해당 `EditableSegment`(`data-timestamp-ms`)로 이동·하이라이트한다. 검증: `desktop-ux-gaps.test.ts` 13/13 통과. |
|
||||
|
|
@ -47,7 +47,7 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
|
|||
| GAP-UX-05 | Desktop+Mobile | 기록+회의 통합 검색. 두 원본은 분리 유지하고 결과만 `source + id`로 상세 화면에 연결한다. | `@d3ro/core/types`, desktop `UnifiedSearchService`/`UnifiedSearchPage`, mobile `features/search`/`UnifiedSearchScreen` | `[~]` 2026-09-28 → **2026-10-30 코드·테스트 보강 완료:** 모바일 `unified-search-service.ts` 및 `UnifiedSearchScreen.tsx`에 `AbortSignal`/`AbortController` 요청 취소, `transcripts` 구간 테이블 검색(`searchTranscriptSegments`), 대용량 원문 상한(`boundPayloadText`)을 추가하고, 데스크톱 `UnifiedSearchService.ts`에도 `meetingMemos` 및 전사 구간 타임스탬프 스니펫 추출·인덱스 정렬을 추가했다(검증: 모바일 `unified-search-service.test.ts` 및 데스크톱 `UnifiedSearchService.test.ts` 12/12 통과). Electron `Ctrl+K` 실앱 수동 검증만 남아 `[~]` 유지. |
|
||||
| GAP-UX-06 | Desktop | main 쪽 정리 필요: `STTManager.ts:53-129` 공급자 설명 한국어 하드코딩·마케팅 문구("100% 완전 오프라인", "Industry Benchmark") — 렌더러는 더 이상 쓰지 않는다 / audio TEST_DEVICE 가 deviceId 무시 / 사전 `incrementUsage` 호출처 없음(사용 횟수 항상 0) / 사전 발음 필드가 인식 힌트·치환에 쓰이지 않음 / 대화 세션 다시 듣기 IPC 없음 / preload `instruction.getAll` 이 `unknown[]` / 지식 추가 실패 판정이 문구 비교. | `STTManager.ts`, `ipc/audio-handlers.ts`, `DictionaryService.ts`, `VoiceModeService.ts`, `VoiceConversationService.ts`, `preload/index.ts`, `ipc/rag-handlers.ts`, `KnowledgeBasePage.tsx` | `[x]` 2026-10-30: 7개 항목 전수 해결 — (1) `STTManager.ts` 중립 기술 설명으로 교체, (2) `audio-handlers.ts` `TEST_DEVICE`가 `deviceId`·`durationMs` 전달, (3) `DictionaryService` 발음 힌트(`getPromptHints`) 및 발음→표제어 치환·`incrementUsage`(`applyDictionaryCorrections`)를 `VoiceModeService._transcribe`에 연결, (4) `voiceConversation:replayMessage` IPC + `VoiceConversationPage` 다시 듣기 버튼 추가, (5) `preload` `instruction.getAll` 타입 `CustomInstruction[]` 지정, (6) `rag-handlers.ts`·`KnowledgeBasePage.tsx` 구조화 에러(`details.cancelled` / `ErrorCode`) 판정으로 전환. 검증: `desktop-ux-gaps.test.ts` 13/13 통과. |
|
||||
| GAP-UX-07 | Desktop | 2026-09-28 개편 문구는 ko·en 만 — 다른 8개 로케일은 en 폴백. 온보딩 Ollama 모델 크기 표기(`onboarding.llmModelSize` 9.6GB)와 안내 모달의 크기가 다르다. | `packages/i18n/src/locales/*`, `OllamaGuideModal.tsx`, `scripts/ci/sync-i18n-locales.mjs`, `tests/main/services/i18n-locale-parity.test.ts` | `[x]` 2026-10-30: `onboarding.llmModelSize`와 `OllamaGuideModal.tsx`의 기본 모델(`gemma4:e4b`) 크기 표기를 `4.0GB`로 통일하고, 12개 로케일 전체를 동기화했다. **2026-11-04:** updater dialog 16키를 추가해 현재 2,742키이며 `i18n-locale-parity.test.ts` 15/15가 이를 고정한다. |
|
||||
| GAP-UX-08 | Mobile | **대화면(태블릿/폴더블 펼침) 레이아웃 대응이 없다.** 825dp 폭에서도 모든 화면이 한 열로 늘어난 휴대폰 레이아웃이고, `useWindowDimensions`/breakpoint/`numColumns` 사용처가 0건이다. More/Meetings/Commands/Templates 는 2열 그리드 후보, Dictionary Edit·Delete 와 Templates Select 는 화면 절반~전체 폭 버튼이 된다. 적응형 배너(`ANCHORED_ADAPTIVE_BANNER`, `minHeight: 50`)는 로드 후 728×90↔468×60 으로 높이가 변해 탭 바가 시프트한다(콘텐츠 가림은 스크롤로 회피 확인). | `apps/mobile-rn/src/navigation/TabNavigator.tsx`, `screens/*`, `packages/ui-native/src/theme.ts`, `docs/evidence/2026-11-05-tablet-layout-audit.md` | `[ ]` 2026-11-05 실기 감사 — **Tab S11 Ultra 1848×2960 @320dpi ≈ 924dp 가로** 및 Fold6 OPENED 825dp. 실측: 온보딩 본문·로그인 폼·Recorder 버튼이 2880px(900dp) full-width, More 라벨↔chevron 800dp, Home/Records 행 40..2920px. 다음 단계: `useContentWidth()`/`ContentColumn` 공용 컬럼 → 탭 화면 7곳 적용 → `≥600dp` 2열 그리드 → full-width 버튼 `maxWidth` 제한 → 배너 slot 높이 예약. 실기기 회귀는 Maestro `open`/`closed` 2회 실행으로. |
|
||||
| GAP-UX-08 | Mobile | **대화면(태블릿/폴더블 펼침) 레이아웃 대응이 없다.** 825dp 폭에서도 모든 화면이 한 열로 늘어난 휴대폰 레이아웃이고, `useWindowDimensions`/breakpoint/`numColumns` 사용처가 0건이다. More/Meetings/Commands/Templates 는 2열 그리드 후보, Dictionary Edit·Delete 와 Templates Select 는 화면 절반~전체 폭 버튼이 된다. 적응형 배너(`ANCHORED_ADAPTIVE_BANNER`, `minHeight: 50`)는 로드 후 728×90↔468×60 으로 높이가 변해 탭 바가 시프트한다(콘텐츠 가림은 스크롤로 회피 확인). | `packages/ui-native/src/responsive.tsx`, `apps/mobile-rn/src/components/ads/FreeTierBanner.tsx`, `apps/mobile-rn/src/screens/*`, `apps/mobile-rn/__tests__/responsive-layout.test.tsx`, `docs/evidence/2026-11-05-tablet-layout-audit.md` | `[~]` **2026-11-13 코드·Jest 구현 완료:** `@d3ro/ui-native/responsive`(`resolveResponsiveLayout`, `useResponsiveLayout`, `useContentWidth`, `ContentColumn`)를 추가해 `>=600dp` 태블릿/폴더블에서 본문 폭 상한(`880dp`, 폼·온보딩 `520dp`), 2열 그리드(`More`/`Meetings`/`Commands`/`Templates`/`Records`), 인라인 액션 버튼 폭 제한(`Dictionary`/`Templates`), `FreeTierBanner` `90dp` 고정 슬롯 예약(레이아웃 시프트 방지)을 10개 주요 화면에 반영했다(`responsive-layout.test.tsx` 4/4 및 전체 모바일 Jest 89 suites / 605 tests PASS). 남은 게이트: 실기기 Fold6/Tab S11 `open`/`closed` Maestro 시각 확인. |
|
||||
| GAP-TEAM-02 | Team | 브라우저에서 초대를 수락하는 경로가 없다. 웹 `accept-invite` 페이지는 발급 링크가 가리키지 않고 로그인 후 토큰을 읽는 곳이 없어 끊겨 있었으므로 삭제했다(사이트 `/accept-invite/`는 앱 딥링크만). | `apps/web/src/app/accept-invite/page.tsx`, `apps/web/src/app/(app)/team/page.tsx`, `site/public/accept-invite/` | `[x]` 2026-10-30: `/app/accept-invite?token=...` 웹 수락 페이지(비로그인 시 `/login?next=/app/accept-invite?token=...` 경유 후 `team-accept` Edge Function 호출 → `/app/team` 이동)와 랜딩 `/accept-invite/`의 `"웹 브라우저에서 수락하기"` 보조 CTA를 구현했다. 검증: `apps/web` typecheck 0 에러. |
|
||||
| GAP-REL-10 | Release | `release-windows`(태그 파이프라인)는 서명 가드에 도달하기 **전에** sidecar 단계에서 죽는다. 이 러너 컨텍스트에서는 `sidecar:setup`이 Python 3.11+를 찾지 못한다(`Python 3.11+ 를 찾을 수 없습니다`) → `sidecar:build` → `verify-sidecar-bundle.mjs` 연쇄 실패(실측: run#65 `v1.3.7`, run#61 `v1.3.6`). 같은 러너의 portable 잡은 `py -3.11 → Python 3.11.9`를 찾아 사이드카 빌드에 성공하므로, 워크플로/컨테이너 간 PATH 차이다. | `.forgejo/workflows/release.yml`, `apps/desktop/scripts/setup-sidecar.mjs` | `[!]` 2026-09-19: 러너에 Python 3.11+(`py` 런처 포함)를 보장하거나 워크플로에 `actions/setup-python` 단계를 추가한다. 그 전까지 서명 게시는 불가능하다(GAP-REL-02와 별개 선행 차단). **2026-10-17 `[x]`**: 런타임이 설치본에서 분리돼 `release.yml` 은 더 이상 사이드카를 빌드하지 않는다(`build-desktop-installer.mjs`). |
|
||||
| GAP-REL-11 | Release | portable 워크플로의 마지막 `actions/upload-artifact@v4` 단계가 Forgejo 러너에서 `GHESNotSupportedError`로 실패한다(증거 보존만 실패, 게시는 성공). | `.forgejo/workflows/portable.yml`, `scripts/ci/verify-release-metadata.mjs` | `[x]` 2026-10-30: `.forgejo/workflows/portable.yml`에서 미지원 `actions/upload-artifact@v4` 단계를 제거하고 `portable.json`·볼륨 SHA-256 요약 출력 단계로 대체했으며, `verify-release-metadata.mjs`에 회귀 방지 검증(`forgejo_portable_unsupported_upload_artifact`)을 추가했다 (`npm run release:metadata:test` 18 cases PASS). |
|
||||
|
|
@ -66,7 +66,7 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
|
|||
| GAP-MEM-01 | Knowledge | Web file upload was deferred and semantic search was mislabeled future. | `apps/web/src/components/knowledge/*` | `[x]` 2026-09-13: `.txt`/`.md` picker, newline-aware chunking, `embed-chunks` on submit, `search-knowledge` confirmed live. |
|
||||
| GAP-MEM-02 | Dictionary | No dictionary import/export on any surface. | catalog MEM-07 | `[x]` 2026-09-13: desktop `dictionary:import/export` (JSON/CSV), web serialize/parse + download/upload, mobile via `data-portability`; 8 new unit tests. |
|
||||
| GAP-MTG-01 | Meetings | Audio seek ↔ transcript timestamp sync missing. | `apps/mobile-rn/src/features/meetings/meetings-service.ts`, `MeetingDetailScreen.tsx`, `apps/web/src/components/meetings/{meeting-audio-player,live-transcript-list}.tsx`, `apps/mobile-rn/__tests__/meetings.test.ts` | `[x]` 2026-10-30: 모바일(`MeetingDetailScreen.tsx`)과 웹(`meeting-audio-player.tsx` ↔ `live-transcript-list.tsx`) 및 데스크톱(`TranscriptTab.tsx` / `EditableSegment.tsx`)에 `[MM:SS]` 구간 타임스탬프 파싱·오디오 시크 이동 및 재생 위치별 활성 전사 세그먼트 하이라이트를 구현했다 (`__tests__/meetings.test.ts` 통과). |
|
||||
| GAP-MTG-02 | Meetings | Speaker diarization only partially done on desktop; absent web/mobile. | `docs/phases/phase-15.5-speaker-diarization.md`, SSOT H-014 | Finish desktop pyannote path; expose speaker labels cross-surface. |
|
||||
| GAP-MTG-02 | Meetings | Speaker diarization only partially done on desktop; absent web/mobile. | `apps/desktop/sidecar/main.py` (`POST /diarize`), `MeetingModeService.ts`, `packages/core/src/meeting-transcript.ts`, `apps/desktop/src/renderer/components/meeting/{TranscriptTab,EditableSegment}.tsx`, `apps/web/src/components/meetings/live-transcript-list.tsx`, `apps/mobile-rn/src/screens/MeetingDetailScreen.tsx` | `[~]` **2026-11-13 전 표면 구현·테스트 완료:** 사이드카 `POST /diarize`(`pyannote.audio` 설치 시 자동 사용 + 무의존 에너지 VAD 화자 교대 분할 폴백, Python 30/30 PASS)를 `LocalSTTService.sidecarBaseUrl`로 `MeetingModeService._diarizeTranscript`(LLM 추정 폴백 및 `stripInventedMarkers({ allowSpeakerMarkers })` 포함)에 연결하고, `@d3ro/core/meeting-transcript` 화자 목록/필터 유틸과 화자 배지·다중 화자 필터 칩을 데스크톱·웹·모바일 상세 화면 전부에 구현했다(코어 13/13, 데스크톱·웹·모바일 테스트 전수 PASS; 실음성 다중 화자 데스크톱 GUI 확인 전까지 `[~]`). |
|
||||
| GAP-MTG-03 | Meetings | Existing recordings could become plain transcription history, but not a meeting with linked audio and minutes. | desktop `MeetingModeService`, `meeting/imported-recording.ts`, `meeting-mode-handlers.ts`; mobile `MeetingsScreen` → `RecordScreen`; MTG-13 | `[~]` 2026-11-02: installed Windows 1.16.0 passed native picker→timestamped transcript→local summary/action item with a real WAV (`2026-11-02-verification.md`). Desktop GUI gate is complete; authenticated Android picker→upload→transcript→minutes on Fold6 remains. |
|
||||
| GAP-MTG-04 | Meetings | Learned typing vocabulary never reached meeting transcription: STT used a hardcoded Korean hint, refine had no glossary, refined lines stopped inside `CaptionService`, and the stored transcript was raw segments. | `packages/core/src/transcript-correction.ts`, `apps/desktop/src/main/services/TranscriptGlossaryService.ts`, `CaptionService.ts`, `meeting/MeetingRecordingSession.ts`, `MeetingModeService.ts`, `FileTranscriptionService.ts`, `VoiceModeService.ts`; MTG-14 | `[~]` 2026-11-05: one glossary SSOT wired into caption, meeting, file transcription and dictation; refined lines now propagate to the meeting transcript and renderer (`meetingMode:segmentUpdated`). **Direct measurement against the real local database** (`users/_local/d3ro.db`: 1,952 learned phrases / 2,522 typing samples / 3 meeting transcripts) exposed that the first cut also rewrote ordinary Korean (286 of 3,005 words: 하면→라면, 이제→이게, 매일→메일, 정보→정도), and v1.16.3 restricts deterministic correction to dictionary pronunciations plus typed Latin identifiers — re-measured **0 of 3,005**. Real-engine check with the local sidecar (`large-v3-turbo`): a Korean TTS fixture containing the user term transcribes as 하람로그에 with no hint and haramlog에 with the learned hint; a dictionary pronunciation entry maps 디에로 → D3RO. Hangul-layout artifacts (dkssudgktpdy) are excluded from the hint. Evidence: `packages/core/__tests__/transcript-correction.test.ts` 16/16, `apps/desktop/tests/main/services/transcript-glossary.test.ts` 10/10, core 589/589, desktop offline suite, workspace typecheck, touched-file ESLint, `test:hygiene`. **Remaining:** a live meeting with real names/jargon by voice, and a packaged-install check of the new IPC event. |
|
||||
| GAP-REL-16 | Release | Forgejo release-page asset attachment for the ~91 MB installer times out through Cloudflare (HTTP 524), although the package registry upload and the signed manifest succeed. | `scripts/ci/publish-forgejo-release.mjs`, `scripts/ci/lib/immutable-package-guard.mjs` | `[~]` 2026-11-06: reproduced on v1.16.2, v1.16.3 and v1.16.4. Each time the registry artifacts, `latest.yml`, `latest.yml.sig` and the public signed-manifest verification completed, so installed apps can update; only the human-facing release page has no attached binaries for those tags. To retry only this step, check out the tag detached (`git checkout v1.16.4`) before `npm run release -- --resume`; the resume path requires HEAD to equal the tag. |
|
||||
|
|
@ -111,7 +111,7 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
|
|||
| GAP-INPUT-04 | Input intelligence | **UIA 브리지가 Windows 전용이다.** `uiautomation` 은 Windows UI Automation 래퍼이므로 macOS 는 AX API, Linux 는 AT-SPI 구현이 따로 필요하다. 그래서 입력 인텔리전스는 카탈로그에서 데스크톱(`D`)만 표기하고 나머지 표면은 `[-]` 다. 또한 Chromium 138 미만 앱은 접근성 트리가 켜져 있으면 입력창 텍스트를 노출하지 않는데, 그 앱들을 `--force-renderer-accessibility` 로 켜도록 강제할 방법이 없다(우리 자신은 `app.setAccessibilitySupportEnabled(true)` 로 처리했다 — `bootstrap.ts`). | `apps/desktop/sidecar/uia_bridge.py`, `apps/desktop/src/main/bootstrap.ts`(`initInputIntelligence`) | macOS AX 경로를 붙일지 결정한다. 붙이지 않으면 카탈로그에서 macOS 를 명시적 N/A 로 유지한다. |
|
||||
| GAP-INPUT-05 | Input intelligence | **수락/닫기 키가 사용자 습관과 충돌할 수 있다.** 기본값을 `Alt+Shift+←/↓/↑` 로 둔 이유는 Tab·Escape·Ctrl+Space 같은 관례 키를 뺏지 않기 위해서다(우리는 키를 삼키지 않으므로 원래 동작이 함께 실행된다). 그 대가는 "Tab 으로 수락" 같은 자연스러운 조작이 아니라는 점이고, 인라인 컴플리션 도구 대부분(Tab)과 다르다. | `packages/core/src/keybinding.ts`(`suggestion-accept`/`next`/`dismiss`), `apps/desktop/src/main/bootstrap.ts`(트리거 구독) | 오버레이가 보일 때만 Tab 을 삼키는 경로(전역 후킹에서 조건부 suppress)를 검토한다. 지금은 불가능하지 않지만 포커스 없는 창에서 키를 가로채는 설계가 필요하다. |
|
||||
| GAP-LLM-03 | LLM | `[x]` **2026-09-22 코드 구현 완료.** 공유 `_abortController`를 요청별 controller로 대체하고 외부 signal을 각 요청에 연결/정리한다. generate/stream은 2048 tokens / 120 s, chat은 512 / 60 s로 제한하며, stream은 `done` frame 없이는 성공 처리하지 않고 불완전 응답을 정리한다. VoiceConversation은 single-flight와 request signal을 통해 local cancel을 실제 chat 취소로 전달한다. | `apps/desktop/src/main/services/LocalLLMService.ts`, `VoiceConversationService.ts` | 독립 표적 검증: 6 test files / 69 tests passed / 0 failed. 변경 코드·테스트 ESLint exit 0, `git diff --check` exit 0. 이는 전체 strict typecheck 또는 GUI 검증이 아니다. 앱 재시작 뒤 동시 제안·음성 요청의 요청별 취소와 `done` 누락 실패 처리는 GAP-LLM-04에서 계속 확인한다. |
|
||||
| GAP-PERF-01 | Memory | `[~]` **2026-10-11 PC 전체 멈춤 = 누수가 아니라 모델 상주 정책.** HEAD 로컬 빌드 실측: 앱 기동 20초 만에 커밋 34.2→52.3 GB, 여유 RAM 7.9 GB→32 MB. 내역은 llama-server(gemma4:e4b) 11.4 GB(`CUDA_Host` pinned 5.9 GB + mmproj 1.1 GB, Ollama 가 Windows CUDA 에서 mmap 을 끈다), Whisper 사이드카(large-v3) 5.8 GB, Electron 8프로세스 약 400 MB(6분간 평탄). 실시간 자막의 보조 모델(large-v3-turbo)은 VRAM 11.8/12 GB 상태에서 로딩에 100.5 s 가 걸려 첫 전사가 타임아웃됐다. 부팅 워밍업·30m 상주는 9/22 에 한 번 제거됐다가 콜드 로딩 UX 때문에 되돌아온 이력이 있다(GAP-LLM-04, GAP-INPUT-06). | `services/llm/model-residency.ts`, `LocalLLMService.ts`, `SuggestionService.ts`, `bootstrap.ts`, `sidecar/main.py`(`/unload`), `LocalSTTService.releaseAuxModel`, `CaptionService.stop`, `VoiceModeService`(`tailAudio`), `VoiceConversationService`(5분 상한), `ipc/audio-handlers.ts`(세대 가드), `CloudSyncService.startRealtime`(단일 실행 + `removeChannel`), `MeetingModeService._saveWav` | 수정 완료(데스크톱 vitest 2545 passed): keep_alive 10m 단일화·부팅 워밍업 제거·종료 시 언로드·자막 종료 시 보조 STT 모델 언로드·부분 전사 끝부분만 복사·음성 대화 듣기 버퍼 5분 상한·마이크 테스트 재진입 고아 방지·Realtime 바인딩 중복 방지·회의 WAV 저장 concat 제거. **남은 일:** (1) 사이드카 재빌드 전까지 설치본 `sidecar.exe` 엔 `/unload` 가 없어 언로드가 HTTP 404 로 조용히 실패한다, (2) 기본 모델을 텍스트 전용 소형 모델로 바꾸거나 제안 전용으로 분리할지 결정(가장 큰 절감, 품질 확인 필요), (3) primary Whisper idle 언로드, (4) 회의 PCM 을 메모리 대신 디스크로 스트리밍(시간당 115 MB 상주), (5) 받아쓰기 녹음 길이 상한(UX 결정 필요), (6) 수정 후 앱 재시작·자막·타이핑 실측. |
|
||||
| GAP-PERF-01 | Memory | `[~]` **2026-10-11 PC 전체 멈춤 = 누수가 아니라 모델 상주 정책.** HEAD 로컬 빌드 실측: 앱 기동 20초 만에 커밋 34.2→52.3 GB, 여유 RAM 7.9 GB→32 MB. 내역은 llama-server(gemma4:e4b) 11.4 GB(`CUDA_Host` pinned 5.9 GB + mmproj 1.1 GB, Ollama 가 Windows CUDA 에서 mmap 을 끈다), Whisper 사이드카(large-v3) 5.8 GB, Electron 8프로세스 약 400 MB(6분간 평탄). 실시간 자막의 보조 모델(large-v3-turbo)은 VRAM 11.8/12 GB 상태에서 로딩에 100.5 s 가 걸려 첫 전사가 타임아웃됐다. 부팅 워밍업·30m 상주는 9/22 에 한 번 제거됐다가 콜드 로딩 UX 때문에 되돌아온 이력이 있다(GAP-LLM-04, GAP-INPUT-06). | `services/llm/model-residency.ts`, `LocalLLMService.ts`, `SuggestionService.ts`, `bootstrap.ts`, `sidecar/main.py`(`/unload`), `LocalSTTService.{releaseAuxModel,releasePrimaryModel}`, `CaptionService.stop`, `VoiceModeService`(`tailAudio`), `VoiceConversationService`(5분 상한), `ipc/audio-handlers.ts`(세대 가드), `CloudSyncService.startRealtime`(단일 실행 + `removeChannel`), `services/meeting/disk-wav-audio-sink.ts` | 수정 완료(데스크톱 vitest 2,825 passed): keep_alive 10m 단일화·부팅 워밍업 제거·종료 시 언로드·자막 종료 시 보조 STT 모델 언로드·부분 전사 끝부분만 복사·음성 대화 듣기 버퍼 5분 상한·마이크 테스트 재진입 고아 방지·Realtime 바인딩 중복 방지·**2026-11-13 추가 해결:** (3) 클라우드 전환·15분 유휴 시 주 Whisper 모델 언로드(`LocalSTTService.releasePrimaryModel`, `slot:"primary"`), (4) 회의 녹음 PCM을 메모리 누적 없이 44바이트 WAV 헤더 스풀로 디스크 직접 스트리밍(`DiskWavAudioSink`, `O(1)` RAM, `disk-wav-audio-sink.test.ts` 3/3 PASS). **남은 일:** (1) 기본 로컬 LLM을 소형 모델로 분리할지 제품/품질 결정, (2) 받아쓰기 녹음 길이 상한 UX 결정, (3) 수정 후 실앱 재시작·장시간 회의 메모리 실측. |
|
||||
| GAP-LLM-04 | LLM | `[~]` **Gemma/Ollama residency·burst·unbounded chat root cause (2026-09-22).** 19:14:12 boot warmup의 `keep_alive: 30m`가 `gemma4:e4b`를 expiry 19:44:12까지 VRAM 3,226,342,521 bytes / context 4096으로 상주시켰다. Windows GPU Engine PID 표본에는 활성 Ollama compute가 없어 무한 추론이 아니라 강제 residency였다. 19:11:17–19:11:58 자동 제안 반복은 기존 900 ms / 12 per min / 5 candidates / 128 tokens / 1-char growth가 허용한 burst였다. 위험 경로는 chat의 무제한 `num_predict`(Ollama 기본 `-1`), timeout·외부 abort 부재, 공유 취소, `done` 없는 EOF 성공, voice cancel 미전파, watchdog의 비취소였다. | `apps/desktop/src/main/services/{LocalLLMService,SuggestionService,VoiceConversationService}.ts`, Ollama `/api/ps` and Windows GPU Engine observations | 구현 계약: boot warmup 제거, suggestion `keep_alive: 2m`; 600 ms debounce / 5 s interval / 6 per min (hard max 12) / 3 candidates / 64 tokens / 12-char growth / 8 s timeout; 요청별 cancellation, bounded requests, done/cleanup, voice single-flight, spawn/poll dedupe와 dispose. Raw Ollama 증거: cold bounded 요청은 client hard timeout 15.044 s에 취소된 뒤 `/api/ps` empty와 `/api/version` 80 ms 회복을 보였고, explicit warmup HTTP 200은 16.639 s, 후속 `num_predict=1` / `keep_alive='2m'` 요청은 553 ms HTTP 200 / `done:true` / `eval_count:1` / `response=OK` / `done_reason:length`였으며 `/api/ps` expiry는 약 119.9 s였다. 이어 19:48:59 +09:00에는 새 generate/unload/kill/retry 없이 충분히 지난 뒤 단일 `/api/ps`가 HTTP 200 / 45.8 ms / `{models:[]}`였고 `/api/version`은 HTTP 200 / 7.3 ms / `0.32.13`이었다. 이는 raw API 수준의 expiry 뒤 unload 확인이다. **남은 조건:** 앱 재시작·GUI·실제 자동제안 타이핑 증거는 아니므로 그 경로에서 rate limit, timeout/cancel, 2분 residency를 확인한다. |
|
||||
| GAP-INPUT-06 | Input intelligence | `[~]` **제안 폭주 상한 및 runtime 확인.** 이전 24.7 s / 4.9 s, boot warmup, `keep_alive: 30m`, 48/96/128 tokens 및 2/5 candidates 기록은 역사적 가설/완화 이력이며 현재 정책이 아니다. 현 정책은 600 ms debounce, 5 s minimum interval, 6 requests/min default (hard max 12), 3 candidates, 64 output tokens, 12-character growth, 8 s timeout, `keep_alive: 2m` 및 boot warmup 제거다. | `apps/desktop/src/main/services/SuggestionService.ts`, `packages/core/src/input-intelligence.ts`, `LocalLLMService.ts` | 표적 자동 검증은 6 files / 69 passed / 0 failed이며 raw Ollama의 15.044 s cold timeout cleanup, 약 119.9 s residency expiry, 그리고 19:48:59 +09:00에 새 generate/unload/kill/retry 없이 확인한 `/api/ps` HTTP 200 / 45.8 ms / `{models:[]}` (`/api/version` HTTP 200 / 7.3 ms / `0.32.13`)도 확인됐다. 전체 strict typecheck는 green이 아니며, 이 raw API unload 증거는 앱 재시작·GUI·실제 자동제안 타이핑 검증이 아니다. 그 경로에서 rate limit, 8 s abort, 3-candidate/64-token 상한을 확인한다. |
|
||||
| GAP-INPUT-08 | Input intelligence | `[x]` **오타 자동 교정(INPUT-19) 일반 앱(8/8) + 터미널·Vim(6/6) 실앱 E2E 검증 및 xterm.js(`Agent Switchboard`) 재교정 루프 수정 완료 (2026-10-27); 문맥 제안(INPUT-20)은 GAP-INPUT-09 에서 추적.** 2026-10-26 에 `packages/core/src/araso-layout.ts` 및 `typo-correction.ts` 로 한영 혼합어(`githubdp`→`github에`, `PDFvkdlf`→`PDF파일`, `ㅖㅇㄹ파일`→`PDF파일`, `Reactzjavhsjsxm`→`React컴포넌트`), 쌍자음 잔여 Shift(`djEJs`→`어떤`, `qkRNjTdj`→`바꿨어`), 한→영 역변환(`ㅎ샤ㅗㅕㅠ에`→`github에`, `ㅑㄹ ㅑ 쇼ㅔㄷ ㅗ디ㅣㅐ 소두 ㅑㅅ 초뭏ㄷㄴ ㅑㅜ 10 ㄴㄷ채ㅜㅇㄴ`→`if I type hello then it changes in 10 seconds`), 문장 문맥 한영 전환(`Stay hungry, stay foolishsms wkqtmdml akfdlek.`), URL/경로 보호를 추가하고, 통계 수집 동의(`inputTelemetryEnabled`) 없이도 기본 기능으로 동작하도록 배선했다. 이어서 실제 Windows 인터랙티브 데스크톱(`WinSta0\Default`)에서 WinForms 테스트 창(`E2ETestBox.exe`)과 실행 중인 `D3RO Voice` 로 실제 `SendInput` 키 입력 E2E 를 수행해 4가지 실환경 결함을 잡고 검증했다: (1) `.bat` 래퍼(`cmd.exe` CUI)로 띄울 때 `uiohook` 이 인터랙티브 키 이벤트를 받지 못하던 문제를 `electron.exe` GUI 직접 실행으로 해결, (2) `_watchRevert` 가 새 문장에서 같은 오타(`ㅗ디ㅣㅐ`)를 다시 쳤을 때 되돌림으로 오인해 `typoIgnoredWords` 에 영구 등록하던 결함을 `prefixBefore`/`windowHandle`/낱자 차단으로 해결, (3) 한글 IME 상태에서 `ㅖㅇㄹ파일`(Shift+PDF + 파일) 입력 시 `PDF파일` 변환 추가, (4) `Ctrl+V` 클립보드 붙여넣기가 Windows `ClipboardSvcGroup`(`WM_CLIPBOARDUPDATE`)의 `OpenClipboard` 잠금과 충돌해 간헐적으로 누락되던 결함을 `SendInput(KEYEVENTF_UNICODE)` 직접 유니코드 타이핑(`apps/desktop/src/main/utils/win32-unicode-input.ts`)으로 해결. **2026-10-27 터미널·Vim·xterm.js 지원 확장 및 라이브 E2E 검증:** (5) Windows Terminal 등 모든 터미널·개발 표면에서 일반 철자/모델 교정만 막고 한영 자판 전환(`layoutOnly: true`)은 허용, (6) `uia_bridge.py` 가 터미널 스크롤백 상단 대신 `GetVisibleRanges()` 하단 뷰포트를 읽고 `ExpandToEnclosingUnit(waitTime=0)` 으로 500ms 지연을 제거, (7) `TerminalKeystrokeTracker` + `extractTerminalActiveContext` + `isForegroundKoreanIme` 로 다중 줄 Vim 버퍼(`-- INSERT --` 상단 줄 편집)·캔버스 터미널(`len=0`)·Vim 노멀 모드 교정 차단·명령줄 모드(`:ㅈㅂ`→`:wq`, `:ㅂ!`→`:q!`)·입력 모드 진입 키(`i/a/o/s`) 분리를 구현, (8) `Agent Switchboard` 등의 xterm.js `<textarea class="xterm-helper-textarea">` 가 Enter/Ctrl+C 전까지 `.value` 를 비우지 않아 `ㅗ디ㅣㅐ재깅 `→`hello재깅 ` 교정 시 400ms 마다 `'h'` 가 누적되던 문제를 `isXtermHelperControl` + `reconcileWithXtermValue` + `재깅`→`world` + 교정 성공 후 `_lastCheckedRegion` 보존 + 프로그램 키 `_lastKeyAt` 미갱신으로 해결, (9) 채팅창 Enter 전송 직후 툴바 문구(`"탭 추가 @ 기호"`)에 제안이 뜨고 `gemma4:e4b` 가 프롬프트 지시문(`"검색어입니다."`, `"키워드 몇 개로만 짧게 이어 쓰세요."`)을 되풀이하던 문제를 `clearedByEnter` 기준선 재설정 + `INSTRUCTION_ECHO_PATTERN` 확장으로 해결. | `apps/desktop/src/main/services/{TypoCorrectionService,TextInsertService,InputTelemetryService}.ts`, `apps/desktop/src/main/utils/{win32-unicode-input,win32-foreground}.ts`, `apps/desktop/sidecar/uia_bridge.py`, `packages/core/src/{araso-layout,typo-correction,terminal-prompt,suggestion-text}.ts` | `[x]` 2026-10-26 일반 앱 GUI E2E(`E2ETestBox.exe`, 8/8 시나리오 전수 통과, 91~509ms) + **2026-10-27 터미널·Vim GUI E2E(`neovide.exe` PID + `D3RO Voice` PID 90844, 6/6 시나리오 전수 통과):** Vim INSERT 모드 `dkssudgktpdy `→`안녕하세요 `(197ms), Vim 명령줄 `:ㅈㅂ`→`:wq`(215ms, `:` 보존), Vim 명령줄 `:ㅂ!`→`:q!`(90ms), 셸 프롬프트 `PS D:\workspace> 퍄ㅡ `→`vim `(106ms), 셸 프롬프트 `PS D:\workspace> ㅎ샤 채ㅜㄴㅅ `→`git const `(170ms), 캔버스 터미널(`UIA len=0`) `<Esc>idkssudgktpdy `→`안녕하세요 `(108ms). 단위 테스트: `packages/core` 3개 파일 82/82 통과(`typo-correction.test.ts` 44/44, `terminal-prompt.test.ts` 12/12, `suggestion-continuation.test.ts` 26/26), 데스크톱 `TypoCorrectionService.test.ts` 22/22 통과. |
|
||||
|
|
@ -126,7 +126,7 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
|
|||
| GAP-SYNC-05 | Sync | **Not yet in production.** Migration `20260927000034` is applied only to the local stack; the rewritten desktop sync ships with the next desktop release. Until the migration is deployed, desktop tombstone pulls and template RPCs fail against production (they are isolated per step, other entities keep syncing). | migration file, `apps/desktop/src/main/services/sync/` | `[~]` 2026-09-27: production `supabase db push` applied `0029`–`0035` (backup dump taken first; see GAP-OPS-01), all 23 Edge Functions redeployed, v1.7.0 published (runtime/portable first, then the updater feed) and installed on the owner PC. **Remaining:** the desktop on that PC is in local mode — one Google sign-in in Settings > Cloud, then edit/delete on the phone and confirm the desktop updates within seconds and appears under Devices. |
|
||||
| GAP-SYNC-06 | Sync | Still desktop-local (not mirrored): knowledge base (desktop local RAG embeddings vs cloud pgvector — different embedding spaces), audio (desktop WAV files vs mobile Storage uploads), `user_settings` (locale, auto-polish, active command), desktop preset-command prompt edits, meeting `transcripts` segments (desktop uses `raw_transcript`, which mobile also fills). | `docs/map/10-feature-catalog.md` MEM-09/MEM-05/SHELL rows | `[x]` 2026-09-27: knowledge docs sync as source text and are re-embedded per surface; recordings upload to the mobile storage contract (≤50 MiB per file, opt-out toggle) and remote recordings play through signed URLs; `user_settings` maps the shared fields. 2026-09-27 (later): the two items first left out are done too — meeting `transcripts` segments are rebuilt from the desktop transcript (the phone renders segments before `edited_transcript`, so desktop edits were invisible there) and preset prompt edits reach the phone through `sync_set_builtin_instruction_prompt_v1` (migration `0036`, production applied; `tests/main/sync/SyncTranscriptsPresets.test.ts` (4) + local-stack integration case "전사 구간·프리셋"). Evidence: `tests/main/sync/SyncExtensions.test.ts` (9) + integration case "지식 문서·설정·녹음" against the local Supabase stack. |
|
||||
| GAP-SYNC-07 | Sync | `sync_tombstones` grows without a schedule. `prune_sync_tombstones_v1(interval)` (service_role) exists; nothing calls it. | migration §1 | `[x]` 2026-09-27: migration `0035` enables `pg_cron` and schedules `prune-sync-tombstones` daily at 03:17 UTC (production `cron.job` active=true). A client whose cursor is older than 180 days must fall back to a full resync. |
|
||||
| GAP-SYNC-08 | Sync | Meeting memo conflict detection compares mutable content plus timestamp/creation fields instead of an immutable revision. An A→B→A edit can return to the same compared values and evade stale-client detection; the shared `MeetingMemo` type has no `updated_at` or revision field. | `packages/api-client/src/types.ts` `MeetingMemo`, `apps/mobile-rn/src/features/meetings/meetings-service.ts` `updateMeetingMemoConflictSafe`/`deleteMeetingMemoConflictSafe` | `[ ]` Add a DB revision (preferred) or reliable `updated_at` CAS contract, regenerate shared types, and prove concurrent update/delete plus A→B→A against a local Supabase stack before changing the completion status. |
|
||||
| GAP-SYNC-08 | Sync | Meeting memo conflict detection compares mutable content plus timestamp/creation fields instead of an immutable revision. An A→B→A edit can return to the same compared values and evade stale-client detection; the shared `MeetingMemo` type has no `updated_at` or revision field. | `server/supabase/migrations/20261113000001_meeting_memos_revision_cas.sql`, `packages/api-client/src/types.ts` `MeetingMemo`, `apps/mobile-rn/src/features/meetings/meetings-service.ts`, `apps/desktop/src/main/{db/schema.ts,services/sync/sync-adapters.ts}` | `[~]` **2026-11-13 마이그레이션·클라이언트·단위 검증 완료:** 74번째 마이그레이션 `20261113000001_meeting_memos_revision_cas.sql`로 `meeting_memos.revision integer not null default 1 check (revision >= 1)` 및 단조 증가 트리거 `bump_meeting_memo_revision`을 추가하고, `@d3ro/api-client`, 모바일 `updateMeetingMemoConflictSafe`/`deleteMeetingMemoConflictSafe`(단조 `revision` 우선 CAS로 `A→B→A` 회피 차단, 구 스키마 폴백 유지), 데스크톱 SQLite `meeting_memos.revision`·`sync-adapters.ts`를 모두 갱신했다(`check:migrations` 74개 GREEN, 모바일 `meetings.test.ts` 18/18·데스크톱 `SyncEngine.test.ts` 20/20 PASS). 남은 단계: 운영 DB `supabase db push` 반영. |
|
||||
|
||||
| GAP-OPS-01 | Ops | **Production Supabase was five migrations behind** (`0029` content reporting, `0030` profile column ACL — users could raise their own `role`/`tier` through PostgREST, `0031` audit-log actor unlink, `0032` meeting-document reporting, `0033` team activity feed) and `content-report` was never deployed, while the map listed those features GREEN from local runs. Most functions still ran the 2026-08-21 build. | `server/supabase/migrations/`, `scripts/ci/check-supabase-migrations.mjs` | `[x]` 2026-09-27: schema+data dump taken, `db push` applied `0029`–`0035`, all functions redeployed (unauthenticated calls return 401, i.e. live and gated); `authenticated` can no longer UPDATE `profiles.tier`; real-account export returns exactly the v1 keys. **2026-11-04 boundary:** file checker는 73개 파일의 self-test/order/name/duplicate/non-empty만 다룬다. 별도 격리 로컬 stack의 empty/reset replay와 `pg-delta` shadow diff는 통과했지만 linked remote migration state/drift는 재검증하지 않았다. |
|
||||
| GAP-STT-01 | Cloud STT | A 5 s phone recording took ~66 s and ended on the phone's tiny local model (2026-09-27). Chain: the gateway's first endpoint (laptop GPU 192.168.0.227) is off (3 s), the NAS CPU Whisper (2 cores, load ~7) needs 30–90 s for 3 s of audio, and `stt-proxy` waited up to 60 s for the gateway. The direct OpenAI fallback **never worked**: the production `OPENAI_API_KEY` secret is not a valid header value (invisible/non-ASCII characters — `TypeError: headers … not a valid ByteString`), and whisper-1 `verbose_json` reports the language by name, which the result contract rejected. The same key backs `embed-chunks`, `search-knowledge` and `realtime-token`. | `server/supabase/functions/{stt-proxy,_shared/stt-contract.ts,_shared/provider-key.ts}` | `[!]` 2026-09-27 code fixed and deployed: gateway wait = 5 s + clip length (max 30 s) when a direct provider exists, provider language names mapped to codes, keys stripped of BOM/zero-width characters (still-invalid keys count as not configured), fail-closed responses list per-provider failures (`attempts`). **External:** re-enter a valid `OPENAI_API_KEY` (or add `GROQ_API_KEY`) in Supabase function secrets, or keep the GPU endpoint online; until then cloud STT runs on the NAS CPU (~30 s for a short clip). |
|
||||
|
|
@ -143,7 +143,7 @@ These are the mobile SSOT rows still `[ ]` / `[~]`. Do not duplicate the full te
|
|||
| O (onboarding/a11y) | O-002..O-007, O-009, O-011; O-001 `[~]`, O-008/O-010/O-012 `[~]` | O-001 2026-11-01: `.2` Fold6 fresh auth/signup/small-screen PASS; latest `.3` fresh-auth/retry FAILED (onboarding visibility), 회귀 테스트 추가(`apps/mobile-rn/.maestro-output/fold6-20261101-fix1/`). 2026-11-04 current-source E2E upgrade/launch, inspected-route UIA labels/48dp, and AVD font-scale 2.0 + rotation/scroll passed. Remaining: permission journeys/tutorial, app-wide theme/a11y, manual TalkBack/focus order and SDK AdMob descendant, iOS, full-app ko/en audit ([evidence](../evidence/2026-11-04-mobile-runtime-a11y.md)) |
|
||||
| D (data/sync/offline) | D-001..D-014 | Schema/RLS, devices, cross-surface read/write, offline queue, conflict policy |
|
||||
| R (record/transcribe) | R-001..R-009, R-011..R-015, R-017..R-020; R-016 `[x]` | Permissions, recorder, FGS, upload queue, job state, sharing |
|
||||
| H (history/meetings) | H-001..H-005, H-007..H-010, H-012..H-015; H-006/H-011/H-016 `[x]` | Pagination, filters, detail, meeting timeline/docs/diarization/cross-app |
|
||||
| H (history/meetings) | H-001..H-005, H-007..H-010, H-012, H-013, H-015; H-014/H-017 `[~]`; H-006/H-011/H-016 `[x]` | Pagination, filters, detail, meeting timeline/docs/speaker filter chips (`H-014` `[~]`)/cross-app |
|
||||
| F (feature parity) | F-003..F-010, F-013, F-014; F-001 `[~]`; F-002/F-011/F-012 `[x]` | Mobile Home dashboard subset, commands/actions/chat/conversation/knowledge |
|
||||
| T (teams/admin/notify) | T-001..T-005, T-009..T-012; T-006..T-008, T-013 `[x]` | Team CRUD/roles, push delivery/deep links, notification settings |
|
||||
| M (monetization) | M-025, M-027; M-013 `[~]` | Play Billing license test, Payple webhook signature |
|
||||
|
|
@ -282,6 +282,30 @@ Evidence: [2026-11-02 verification](../evidence/2026-11-02-verification.md).
|
|||
|
||||
- `[x]` **GAP-QA-04 (신규·해결): 죽은 IPC/TTS 계약이 SSOT에 남아 있었다.** `IPC_CHANNELS.TTS` 블록(9) · WINDOW tip/show 5 · SYSTEM 4 · HISTORY.EXPORT · STATS 2 · RAG.QUERY_RESULT · SUPPORT.GET_TICKETS · POPUP_SUGGESTION.ACCEPTED 등 **20개 채널**과 그에 묶인 타입 27종이 어디에서도 참조되지 않았다. 삭제 + 살아있는 채널의 인라인 페이로드를 코어 타입으로 재배선(`PullModelParams`의 `modelName`→`modelId` 드리프트, `OpenExternalParams`, `RecordingTipState`/`TipStateChangedEvent`, `'done'` 상태 누락). 근거: `docs/REFACTOR_WAVE5_AUDIT.md` W5-02/W5-03. 검증: 모노레포 typecheck/lint/test + 모바일 typecheck/lint/test + contract:check GREEN. 커밋 `f95bc9c`.
|
||||
- `[x]` **GAP-QA-05 (신규·해결): DS 데드 export·중복 hex·미사용 모듈.** `packages/ui`·`ui-native`의 토큰 export 11개(참조 0), `ProBadge.tsx`, `apps/admin/src/lib/supabase-server.ts` 삭제. 파형 컴포넌트의 하드코딩 hex 폴백을 `theme-raw` 값으로 통일. 커밋 `b8b9190`.
|
||||
- `[~]` **GAP-QA-06 (신규·진행): 보호 수용 여정이 CI에서 실행되지 않는다.** Phase 1로 "약화·삭제·skip"은 `npm run check:protected-tests`가 막지만, 데스크톱 E2E 자체는 X 디스플레이가 없어 여전히 릴리스 전 수동이다. 다음 단계: Phase 5 — `release.yml` 태그 잡에 Windows 러너 E2E + 설치 산출물 스모크 추가.
|
||||
- `[x]` **GAP-QA-07 (신규·해결): 테스트 품질 회귀를 막을 게이트가 없었다.** `npm run test:quality`(래칫, 기준선 `scripts/ci/test-quality-baseline.json`: 약한 단정 128 / ambient 시계·난수 203)와 `npm run test:metrics`(지표, `docs/tdd-red/metrics/2026-11-08.md`)를 추가하고 `verify:all`·CI `quality`에 배선. 커밋 `42583cc`·`d3d6f34`.
|
||||
- `[ ]` **잔여(다음 wave):** Wave 5 G3(PII/ZDR 배선 여부 — 프로덕션 호출자 0), G4(`isRecord` 27 · `requireUuid` 14 · `formatDuration` 9 등 앱 간 중복 → `@d3ro/core` 추출), G5(i18n sync 스크립트의 번역값 하드코딩 + 고아 키 798), G6(`site/`가 npm workspace 밖이라 루트 정적 게이트 대상 아님), G7(대형 컴포넌트 순수 이동). TDD Phase 2~5(i18n·DS 계약, 영향 선택 실행, 증분 뮤테이션, 릴리스 E2E).
|
||||
- `[~]` **GAP-QA-06 (신규·진행 → 2026-11-13 CI 스모크 편입):** Phase 1로 "약화·삭제·skip"은 `npm run check:protected-tests`가 막고, **2026-11-13(Phase 5)** `scripts/ci/verify-desktop-installer-smoke.mjs`(`npm run release:installer:smoke[:test]`)를 `release-desktop.mjs`·`.forgejo/workflows/release.yml`에 배선해 설치 산출물(NSIS `.exe`, `.blockmap`, `latest.yml`, Ed25519 `.sig`, `resources/app.asar`, 렌더러 HTML/에셋, 네이티브 ABI) 무결성을 태그 릴리스에서 자동 검증하며 `.forgejo/workflows/ci.yml`에서 `site` 프로덕션 빌드까지 강제한다. Linux CI 러너에는 X/Windows GUI 세션이 없어 대화형 Electron Playwright 수용 여정(`test:acceptance:desktop`)만 로컬/Windows 릴리스 전 실행으로 유지한다.
|
||||
- `[x]` **GAP-QA-07 (신규·해결): 테스트 품질 회귀를 막을 게이트가 없었다.** `npm run test:quality`(래칫, 기준선 `scripts/ci/test-quality-baseline.json`: 약한 단정 128 / ambient 시계·난수 203)와 `npm run test:metrics`(지표, `docs/tdd-red/metrics/2026-11-08.md` → `2026-11-13.md`)를 추가하고 `verify:all`·CI `quality`에 배선. 커밋 `42583cc`·`d3d6f34`.
|
||||
- `[x]` **잔여 Wave 5 G3~G7 + TDD Phase 2~5 해결 (2026-11-13):** 아래 `2026-11-13` 섹션 및 [`docs/REFACTOR_WAVE5_REPORT.md`](../REFACTOR_WAVE5_REPORT.md) 참조.
|
||||
|
||||
## 2026-11-13 — 전 표면 최적화 · 소스 위생 · 잔여 백로그 전수 해소 (Waves 0–12)
|
||||
|
||||
- `[x]` **GAP-PERF-02 (신규·해결): 데스크톱/모바일/웹 초기 번들 비대화 및 `@d3ro/i18n` 12개 로케일 정적 번들링.** `@d3ro/i18n`을 동적 로케일 청크(`index.tsx`), 무-React 동기 로더(`@d3ro/i18n/main`), 모바일 12개국어 Metro `inlineRequires` 엔트리(`index.native.tsx`)로 분리하고, 데스크톱 `AppLayout.tsx`(7페이지·6모달 `React.lazy`), 모바일 `App.tsx`(`getComponent` + Metro `inlineRequires`), 웹 `MarkdownPreview`(`next/dynamic` + 다이어그램 존재 시에만 `mermaid` 로드) 코드 스플리팅을 적용했다. 실측 결과 데스크톱 초기 부팅 JS는 `8.79 MB`(`main 4,191.7 KB` + `renderer 4,596.8 KB`) → `3.63 MB`(`main 2,085.7 KB` + `renderer 1,549.3 KB`, `-58.6%`)로 감소했다.
|
||||
- `[x]` **GAP-PERF-03 (신규·해결): 데스크톱 SQLite 쿼리 병목·부팅 프로세스/훅 오버헤드.** (1) SQLite WAL 성능 PRAGMA(`synchronous=NORMAL`, `mmap_size=64MB`, `cache_size=-16000`) 적용, (2) `UnifiedSearchService` FTS5 trigram 전문 검색(`history_fts`/`meeting_sessions_fts`/`meeting_memos_fts` + 동기화 트리거), (3) `SqliteChunkStore` `Float32Array` 바이너리 `embedding_blob` + DB 스코프 `WeakMap` 캐시(검색 시 `JSON.parse` 0회), (4) `PersonalGraphService` 단일 트랜잭션 일괄 처리, (5) Windows `koffi` `SendInput` 일원화(`NutKeyboardPort`·`ScreenContextService`, Windows `asarUnpack`에서 `@nut-tree-fork` 제외 및 5초 `nut-js` 타이머 제거), (6) `InputTelemetryService` 기본 모드 1,000Hz `mousemove`/`wheel` 훅 차단, (7) 부팅 시 4개 백그라운드 팝업 선생성(`preloadPopupWindows`) 제거 → 지연 생성, (8) `LocalSTTService` 클라우드 전환·15분 유휴 시 주 Whisper 모델 메모리 회수(`POST /unload` `slot:"primary"`, UIA 서버 유지), (9) `DiskWavAudioSink`로 장시간 회의 녹음 PCM 디스크 직접 스트리밍(`O(1)` RAM). 증거: `sqlite-optimizations.test.ts` (4/4), `runtime-hygiene-optimizations.test.ts` (2/2), `disk-wav-audio-sink.test.ts` (3/3).
|
||||
- `[x]` **GAP-HYGIENE-01 (신규·해결): 패키징·의존성·스크립트·레거시 라우트 오염.** 루트 중복 `resources/sox/`(5.21 MB) 및 `apps/desktop/resources/sox/` 불필요 파일 10종 제거 + `electron-builder.yml` 필터 적용, 데스크톱 미구현 광고 어댑터 9종 단일화(`UNAVAILABLE_AD_NETWORK_SPECS`), `scripts/local/` 109개 및 루트 미참조 스크립트 16개 삭제 + `npm run clean:deep`(`scripts/ci/clean-deep.mjs`), `apps/mobile-rn` 루트 순환 의존성(`d3ro-voice-monorepo`)·NTFS 정션 제거, Android 릴리스 R8(`enableProguardInReleaseBuilds=true`) + `shrinkResources` + 12개 로케일 `localeFilters` 적용(`verify-mobile-build-config.mjs` 게이트 고정), `.NET` `SttController` 무호출 중복 라우트(`GET /providers`, `POST /test`) 제거(`.NET` xUnit 28/28 PASS).
|
||||
- `[x]` **Wave 5 G3~G7 + 기능/계약 백로그 전수 구현 (Waves 6–12):**
|
||||
- **G3 (`W5-01`):** `@d3ro/core` `redactPII`/`redactPIIMessages`/`rehydrateText`를 `OnlineLLMService`(클라우드 전송 전 마스킹·응답 복원) 및 `support-handlers.ts`(진단 내보내기 마스킹)에 배선하고, `secureWipeAudioChunks`/`secureZeroBuffer`를 `VoiceModeService`·`AudioCaptureService` 버퍼 해제 경로에 배선(`pii-zdr-wiring.test.ts` 4/4 PASS).
|
||||
- **G4 (`W5-05..07`):** `@d3ro/core`에 `guards.ts`·`csv.ts`·`format.ts`·`unified-search.ts`·`admin-roles.ts`를 추출해 앱/서버 간 중복 헬퍼를 단일 SSOT로 통합(`contract:check` GREEN).
|
||||
- **G5 (`W5-08` + `GAP-I18N-03`):** 미참조 고아 키 253개 정리(`2,753` → `2,500`키 × 12로케일), `sync-i18n-locales.mjs` 하드코딩 번역 제거(`--check` 전용), `check-i18n-contract.mjs`(`check:i18n`) 및 웹 `LocaleSwitcher`·모바일 12개 로케일 선택기 전 표면 연결.
|
||||
- **G6 (`W5-12`) + Web `teams.member_count`:** `.eslintignore`에서 `site/` 제외 해제, `typecheck:site`·`lint:site`·CI `site` 빌드 편입, 웹 `team-client.ts`로 실제 팀원 수 집계 연동(`team-client.test.ts` 3/3 PASS).
|
||||
- **G7 (`W5-11`):** `SettingsModal.tsx`(`951` → `349`줄, `General`/`Audio`/`Llm`/`About` 탭 컴포넌트 및 `settings-model-helpers.ts` 분리) 및 `suggestion-policy-helpers.ts` 순수 모듈 추출.
|
||||
- **TDD v2.0 Phase 2~5:** `locale-contract.test.ts`(15/15), `ds-contract.test.tsx`(4/4) + `check-ds-contract.mjs`(`check:ds-contract`), `run-affected-tests.mjs`(`test:affected`), `@d3ro/core/ports`(`Clock`/`Random`), `verify-desktop-installer-smoke.mjs`(`release:installer:smoke`) 및 `scripts/ci/lib/test-files.mjs` 미추적 신규 테스트 스캔 보강 완료(`docs/tdd-red/metrics/2026-11-13.md`).
|
||||
|
||||
---
|
||||
|
||||
## 2026-11-14 — Wave 6 전 표면 코드 위생 · 최적화 · 버그 헌팅 (WS1–WS4 병렬)
|
||||
|
||||
- `[x]` **Wave 6 (`WS1`–`WS4`) 전 표면 코드 위생 · 리소스 최적화 · 동시성/보안 버그 수정 완료:**
|
||||
- **Desktop Main & Sidecar (`WS1`):** `ipc/renderer-broadcast.ts` 9개 파일 단일화, `OnlineLLMService.chatStream` abort/401/예외 래핑, `UnifiedSearchService` `meetingTotal` 이중 집계·정렬·인덱스·런타임 FTS5→`LIKE` 폴백(`UnifiedSearchService.test.ts` 17/17), `rag/chunk-store.ts` 캐시 무효화·중복 `embedding` JSON 제거·Float32 방어, `disk-wav-audio-sink.ts` uint32 오버플로·헤더 write 실패 fd 정리, 타이머/팝업 레이스 수정, `sidecar/main.py` `UploadFile.close()`·PCM 경계·`/shutdown` 조인(`33/33 PASS`).
|
||||
- **Shared Packages & Desktop Renderer (`WS2`):** `@d3ro/i18n` `shared.ts`·지연 로드/언마운트 레이스 차단(`25/25`), `@d3ro/core` PII 플레이스홀더 충돌/CSV BOM+CR/기간·날짜 가드(`626/626`), `@d3ro/ui` `wave-math.ts` + 캔버스 그라데이션 캐싱(`7/7`), `@d3ro/ui-native`·`api-client` 경계 가드, 렌더러 `utils/error-message.ts`·훅/모달 언마운트 정리 및 팝업 6종 `beforeunload`/DOM 안전화(`@d3ro/desktop` `210 files / 2,865 tests PASS`, `npm run build` + `check:desktop-renderer` GREEN).
|
||||
- **Mobile RN (`WS3`):** `features/shared/{service-guards,owned-cache-files}.ts` 외 3개 SSOT 통합, `FreeTierBanner` 리사이즈 높이 고착·내구성 큐 조기 폐기 경합·녹음 리스 누수·TTS 12로케일·언마운트 재생/로케일 레이스 수정 및 9개 회귀 스위트 추가(`98 suites / 625 tests PASS`).
|
||||
- **Web · Admin · Site · Edge · Worker · .NET (`WS4`):** Edge `_shared/json-response.ts` 20개 엔드포인트 통합 및 fail-closed(`Deno 270/270`), `.NET` `SttProxyService` Base64 26MB 상한 + `CancellationToken` 전파(`xUnit 32/32`), Cloudflare Worker `resolveBackendTargetUrl` SSRF·타임아웃 차단(`Deno 9/9`), 웹 `MarkdownPreview` DOM XSS/레이스·`WebPush` 재진입·`team-client` fail-closed(`42/42`), 어드민 `request-security.ts`/`detail-row.tsx`·CSRF/비용 검증, 사이트 `AppLoopDemo`/`rel="noopener noreferrer"` 보강.
|
||||
- **정량 게이트 및 경계 유지:** `verify:all`, `contract:check`, `check:migrations`(74), `version:check`(1.16.5), `security:secrets`, `test:metrics:write`(`docs/tdd-red/metrics/2026-11-14.md`) GREEN. Electron 실GUI(`Ctrl+K`/오버레이), Fold6/iOS 실기기 Maestro·TalkBack, 외부 자격증명/운영 `db push` `[~]`/`[!]`/`RED` 경계는 변경 없이 유지. 상세: [`docs/REFACTOR_WAVE6_REPORT.md`](../REFACTOR_WAVE6_REPORT.md).
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue