feat(commands): multi-select ordered command pipeline with step reordering and single-pass composition (AI-05, AI-07)
This commit is contained in:
parent
f49acf0105
commit
10af20a0ad
157 changed files with 29455 additions and 913 deletions
76
docs/deployment/nas-deploy-runbook.md
Normal file
76
docs/deployment/nas-deploy-runbook.md
Normal file
|
|
@ -0,0 +1,76 @@
|
|||
# NAS Deployment & Rollback Runbook (`docker-compose.nas.yml`)
|
||||
|
||||
> Canonical operations runbook for deploying `apps/api-server`, `apps/admin`, `apps/web`, and `whisper` on the NAS (`kd-nas`).
|
||||
> Resolves `GAP-INFRA-02` by documenting the canonical manual/SSH deployment and rollback procedure instead of an ephemeral DinD CI job.
|
||||
|
||||
---
|
||||
|
||||
## 1. Architecture & Canonical Files
|
||||
|
||||
- **Compose manifest:** [`docker-compose.nas.yml`](../../docker-compose.nas.yml)
|
||||
- **NAS host path:** `/volume1/docker/d3ro/`
|
||||
- **Containers:**
|
||||
- `d3ro_voice_api` (`apps/api-server`, port `5000`, healthcheck `http://localhost:5000/health`)
|
||||
- `d3ro_voice_admin` (`apps/admin`, port `3001`, healthcheck `http://127.0.0.1:3001/login`)
|
||||
- `d3ro_voice_web` (`apps/web`, port `3002`, healthcheck `http://127.0.0.1:3002/app/login`)
|
||||
- `d3ro_voice_whisper` (`faster-whisper-server`, port `8000`)
|
||||
- **Ingress:** Cloudflare Tunnel (`kd-nas`) routes:
|
||||
- `d3ro.chanpaca.net/app*` → `http://localhost:3002`
|
||||
- `d3ro.chanpaca.net/api*` & `/health` → `http://localhost:5000`
|
||||
- `d3ro-admin.chanpaca.net/*` → `http://localhost:3001`
|
||||
|
||||
---
|
||||
|
||||
## 2. Pre-Deploy Checklist
|
||||
|
||||
1. Verify `main` passes CI (`npm run verify:all`).
|
||||
2. Confirm `/volume1/docker/d3ro/.env` on the NAS defines all required fail-closed variables:
|
||||
- `JWT_SECRET`
|
||||
- `SUPABASE_URL`
|
||||
- `SUPABASE_ANON_KEY`
|
||||
- `SUPABASE_SERVICE_ROLE_KEY`
|
||||
- `ADMIN_BOOTSTRAP_TOKEN`
|
||||
- `OPENAI_API_KEY` (if direct OpenAI proxy is used)
|
||||
|
||||
---
|
||||
|
||||
## 3. Deployment Procedure
|
||||
|
||||
```bash
|
||||
# 1. SSH into NAS and navigate to deployment root
|
||||
cd /volume1/docker/d3ro
|
||||
|
||||
# 2. Tag current running images for instant rollback
|
||||
STAMP="$(date +%Y%m%d-%H%M%S)"
|
||||
for svc in api-server admin web; do
|
||||
IMG_ID="$(docker compose -f docker-compose.nas.yml images -q "$svc" 2>/dev/null || true)"
|
||||
if [ -n "$IMG_ID" ]; then
|
||||
docker tag "$IMG_ID" "d3ro-${svc}:rollback-${STAMP}"
|
||||
fi
|
||||
done
|
||||
cp docker-compose.nas.yml "docker-compose.nas.yml.before-${STAMP}"
|
||||
|
||||
# 3. Sync repository changes and rebuild containers
|
||||
git pull --ff-only
|
||||
docker compose -f docker-compose.nas.yml up -d --build
|
||||
|
||||
# 4. Verify container health checks
|
||||
docker compose -f docker-compose.nas.yml ps
|
||||
curl -fsS http://127.0.0.1:5000/health
|
||||
curl -fsSI http://127.0.0.1:3001/login | head -n 1
|
||||
curl -fsSI http://127.0.0.1:3002/app/login | head -n 1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Rollback Procedure
|
||||
|
||||
If any health check fails after deployment:
|
||||
|
||||
```bash
|
||||
cd /volume1/docker/d3ro
|
||||
cp "docker-compose.nas.yml.before-${STAMP}" docker-compose.nas.yml
|
||||
git checkout HEAD~1
|
||||
docker compose -f docker-compose.nas.yml up -d --build
|
||||
docker compose -f docker-compose.nas.yml ps
|
||||
```
|
||||
|
|
@ -2,7 +2,11 @@
|
|||
|
||||
> Status: ACTIVE
|
||||
> Last full audit: 2026-09-13
|
||||
> Last update: 2026-10-29 — **v1.14.0 릴리스 + 포커스 전환 직후 첫 단어(`pc`/`ㅔㅊ`/`ㅖㅊ`/`내ㅔㅊ`) 한영 자동 전환(`INPUT-04`, `INPUT-19`) + 받아쓰기 구어·추임새·중복·동음이의어 후처리 정리 고도화(`AI-03`, `AI-05`).** (1) **포커스 클릭 직후 첫 단어(`pc` 등) 자동 전환:** `InputTelemetryService`에서 마우스 클릭(`_rebaseFocusText`)·창 전환 직후 첫 스냅샷(40~680 ms)이 찍히기 전에 사용자가 곧바로 친 첫 단어(`ㅔㅊ`, `ㅖㅊ` 등)가 `_textAtFocus` 기준선에 삼켜져 `editedSinceFocus = false`가 되던 문제를 `_typedInCurrentFocus`·`_lastTypedHwnd` 추적 및 첫 글자 키 입력 시 포그라운드 창 즉시 샘플링으로 해결하고, `@d3ro/core/typo-correction`에 대소문자 2글자 영문 약어(`ㅔㅊ`/`ㅖㅊ`→`PC`, `ㅐㄴ`/`ㅒㄴ`→`OS`, `ㅔㄱ`/`ㅖㄱ`→`PR`, `ㅊㅑ`→`CI`, `ㅍㅡ`→`VM`, `ㅔㅡ`/`ㅖㅡ`→`PM`, `ㅔㅐ`/`ㅖㅐ`→`PO`, `ㅗㄱ`→`HR`, `ㅑㄱ`→`IR`, `ㅇㅡ`→`DM`, `ㅡㅇ`→`MD`, `ㅔㅇ`/`ㅖㅇ`→`PD`, `ㅍㅔ`/`ㅍㅖ`→`VP`, `ㅠㅡ`→`BM`, `ㅆㅍ`→`TV`, `ㅑㅖ`→`IP`) 및 한글 접두+낱자모 합성어(`내ㅔㅊ`→`내PC`, `회사ㅔㅊ에서`→`회사PC에서`, `한글로ㅔㅊ라고`→`한글로PC라고`, `윈도우ㅐㄴ`→`윈도우OS`, `새ㅁㅔㅑ를`→`새API를`)를 추가했다. (2) **받아쓰기 구어·추임새·말바꾸기·중복·STT 동음이의어 정리:** `@d3ro/core/dictation-cleaner`(`cleanDictatedText`)를 신설해 `VoiceModeService._transcribe` 직후 지연 0 ms로 단독 추임새(`어`, `음`, `그 쓸데없는` 등 — 단 인용된 `어라든가`, `아라든가` 보존), 발화 중 말바꾸기(`검색 아니 검색이 아니라 타이핑을`→`타이핑을`), 상투적 중복(`쓸데없는 의미없는`→`불필요한`, `정리해 가지고 해 주는 거`→`정리해 주는 기능`), 구어 잉여 어미(`예를 들자면은`→`예를 들어`, `보면은`→`보면`), 문맥상 명백한 STT 동음이의어(`스시가 영어로 변경되지`→`PC가 영어로 변경되지`, `그 길을 쓸 이유가`→`그 기능을 쓸 이유가`)를 즉시 정리하고, `BASE_SYSTEM_PROMPTS.refine`(`llm-prompts.ts`), `MeetingModeService.polishTranscript`, 신규 내장 프리셋 `builtin-clean-speech`(`구어·추임새·중복 정리`, `CustomInstructionService.ts`)가 화자의 원래 어투(반말/해요체/합쇼체)를 바꾸지 않고 추임새·말바꾸기·중복·비문만 자연스럽게 다듬도록 업그레이드했다.
|
||||
> Last update: 2026-10-31 — **v1.15.0 릴리스 + 다단계 명령 파이프라인 복수 선택·순서 조정 UI 및 단일 패스 합성 실행(`AI-05`, `AI-07`).** `@d3ro/core/instruction-template`에 복수 명령 파이프라인 직렬화·토글·순서 이동·프롬프트 합성(`parseActiveInstructionIds`, `serializeActiveInstructionIds`, `toggleInstructionInPipeline`, `moveInstructionInPipeline`, `composeInstructionPipelinePrompt`)을 추가하고, `CommandsPage.tsx`를 단일 라디오 선택에서 **순서가 있는 복수 선택(체크박스 + `1단계`/`2단계` 배지 + `↑`/`↓` 순서 이동 버튼 + 상단 단계별 파이프라인 요약 + 파이프라인 통합 테스트 실행)**으로 업그레이드했다. 예컨대 `1단계: 구어·추임새·중복 정리` → `2단계: 격식체 변환`을 함께 선택하면 후행 단계의 어투·출력 규칙이 우선 적용되는 합성 파이프라인 프롬프트로 지연 시간 증가 없이 한 번에 실행된다.
|
||||
>
|
||||
> Previous update: 2026-10-30 — **백로그 26건 일괄 해소 (`GAP-INPUT-03`, `GAP-LLM-01`, `GAP-UX-01/02/03/05/06/07`, `GAP-I18N-01`, `GAP-REL-11/14/15`, `GAP-INFRA-01/02/04/06`, `GAP-OPS-01`, `GAP-QA-02`, `GAP-KEY-01/03`, `GAP-ADS-02`, `GAP-ID-01/02`, `GAP-TEAM-02`, `GAP-SHELL-01`, `GAP-PUSH-03`, `GAP-MTG-01`, `DOC-01`) + 입력 누락 검증 인프라 및 서비스 결함 재현(`INPUT-04/19`, `INFRA-20`, `GAP-INPUT-11`).** (1) **백로그 26건 해소:** CJK 무공백 어절 집계(`countWords`), 12개 번역 대상 언어 설정(`targetLanguage`), 12개 로케일 2,716개 키 100% 동기화(`sync-i18n-locales.mjs`), 데스크톱 strict 타입체크 0 에러(`tsconfig.node.json` + `tsconfig.web.json`), Forgejo 릴리스 태그 푸시 순서·SHA 고정(`GAP-REL-14`), 포터블 워크플로 매니페스트 검증(`GAP-REL-11`), 네이티브 ABI 스위처(`rebuild:app`/`rebuild:test`), Supabase 마이그레이션 정합성 검사기(`check:migrations`), NAS 배포 런북(`nas-deploy-runbook.md`), 오프라인 격리 테스트 하네스(`GAP-QA-02`), `KeyBindingService` 단위 테스트·`command` 전용 액션 핸들러, 데스크톱 광고 보상 쿼터 연동(`grantRewardQuota`), 회의 종료 후 메모 추가·노트패드 동기화, 이력 SQLite 커서 페이지네이션·인라인 편집·전체 내보내기, 회의 요약 `[MM:SS]` 타임스탬프 인용·클릭 시크 연동(데스크톱·웹·모바일), `resolveEntitlement` 정본 통일, 통합 검색(`UnifiedSearchService`) 취소·세그먼트 검색·페이로드 경량화, 웹 팀 초대 수락(`/app/accept-invite`), 관리자 고객지원 콘솔(`/support`), Web Push 서비스워커(`sw.js`)·iOS APNs 토큰 등록을 완료했다. (2) **입력 누락 검증 인프라(`GAP-INPUT-11`):** `typing-race-proof.mjs`가 체크아웃을 바꾸지 않고 3개 서비스만 HEAD `f49acf0`와 수정본으로 바꿔 같은 현재 의존성·시험에서 비교했다: HEAD 1/17, 수정본 17/17. 3개 문자열 손상 사례와 13개 스냅샷·메타데이터·조회 병합 계약 실패를 구분했고, 정상 교정 대조군은 양쪽 모두 통과했다. `typing-fixture`(scan-code·IME·CPU 부하)와 `typing-runtime`(별도 로컬 프로필·실제 제품 번들)을 준비했으며, 실제 GUI·IME·CPU·모델 cold/warm 시험은 아직 미실행이다. 증거: `test-results/typing-load/race-proof-2026-10-30T00-50-32-284Z/report.json`; 실행 명령은 `02` §3, 검증 경계는 `04` §6과 `11` GAP-INPUT-11.
|
||||
>
|
||||
> Previous update: 2026-10-29 — **v1.14.0 릴리스 + 포커스 전환 직후 첫 단어(`pc`/`ㅔㅊ`/`ㅖㅊ`/`내ㅔㅊ`) 한영 자동 전환(`INPUT-04`, `INPUT-19`) + 받아쓰기 구어·추임새·중복·동음이의어 후처리 정리 고도화(`AI-03`, `AI-05`).** (1) **포커스 클릭 직후 첫 단어(`pc` 등) 자동 전환:** `InputTelemetryService`에서 마우스 클릭(`_rebaseFocusText`)·창 전환 직후 첫 스냅샷(40~680 ms)이 찍히기 전에 사용자가 곧바로 친 첫 단어(`ㅔㅊ`, `ㅖㅊ` 등)가 `_textAtFocus` 기준선에 삼켜져 `editedSinceFocus = false`가 되던 문제를 `_typedInCurrentFocus`·`_lastTypedHwnd` 추적 및 첫 글자 키 입력 시 포그라운드 창 즉시 샘플링으로 해결하고, `@d3ro/core/typo-correction`에 대소문자 2글자 영문 약어(`ㅔㅊ`/`ㅖㅊ`→`PC`, `ㅐㄴ`/`ㅒㄴ`→`OS`, `ㅔㄱ`/`ㅖㄱ`→`PR`, `ㅊㅑ`→`CI`, `ㅍㅡ`→`VM`, `ㅔㅡ`/`ㅖㅡ`→`PM`, `ㅔㅐ`/`ㅖㅐ`→`PO`, `ㅗㄱ`→`HR`, `ㅑㄱ`→`IR`, `ㅇㅡ`→`DM`, `ㅡㅇ`→`MD`, `ㅔㅇ`/`ㅖㅇ`→`PD`, `ㅍㅔ`/`ㅍㅖ`→`VP`, `ㅠㅡ`→`BM`, `ㅆㅍ`→`TV`, `ㅑㅖ`→`IP`) 및 한글 접두+낱자모 합성어(`내ㅔㅊ`→`내PC`, `회사ㅔㅊ에서`→`회사PC에서`, `한글로ㅔㅊ라고`→`한글로PC라고`, `윈도우ㅐㄴ`→`윈도우OS`, `새ㅁㅔㅑ를`→`새API를`)를 추가했다. (2) **받아쓰기 구어·추임새·말바꾸기·중복·STT 동음이의어 정리:** `@d3ro/core/dictation-cleaner`(`cleanDictatedText`)를 신설해 `VoiceModeService._transcribe` 직후 지연 0 ms로 단독 추임새(`어`, `음`, `그 쓸데없는` 등 — 단 인용된 `어라든가`, `아라든가` 보존), 발화 중 말바꾸기(`검색 아니 검색이 아니라 타이핑을`→`타이핑을`), 상투적 중복(`쓸데없는 의미없는`→`불필요한`, `정리해 가지고 해 주는 거`→`정리해 주는 기능`), 구어 잉여 어미(`예를 들자면은`→`예를 들어`, `보면은`→`보면`), 문맥상 명백한 STT 동음이의어(`스시가 영어로 변경되지`→`PC가 영어로 변경되지`, `그 길을 쓸 이유가`→`그 기능을 쓸 이유가`)를 즉시 정리하고, `BASE_SYSTEM_PROMPTS.refine`(`llm-prompts.ts`), `MeetingModeService.polishTranscript`, 신규 내장 프리셋 `builtin-clean-speech`(`구어·추임새·중복 정리`, `CustomInstructionService.ts`)가 화자의 원래 어투(반말/해요체/합쇼체)를 바꾸지 않고 추임새·말바꾸기·중복·비문만 자연스럽게 다듬도록 업그레이드했다.
|
||||
>
|
||||
> Previous update: 2026-10-29 — **v1.13.0 릴리스 + 그래프 관계성 기반 극한 개인화(`INPUT-06`, `INPUT-20`) + 한영 형태론·전방 구문 감지 및 단일-시스콜 초고속 인플레이스 수정(`INPUT-19`, `INPUT-22`) + 전 표면 디자인파카(`designpaca`) 순회 감사(`SHELL-11`, `SHELL-15`).** (1) **그래프 관계성 & 극한 개인화:** `@d3ro/core/personal-graph` 및 `PersonalGraphService`에 앱별 연속 단문 메시지 간 세션 `follows` 체이닝(`_lastIndexedByScope`), 엔터 전송 직후 비워진 채팅창 문맥 복원(`recentWrites`), 증분 `shares_terms` 엣지 연결, 조사 차이 무관 어간 연속 이어쓰기(`stemContinuationsFrom`), 2-홉 그래프 경로 랭킹(`rankTwoHopGraphTargets`), 개인 그래프·어투 일치 기반 LLM 후보 재정렬(`scoreCandidatePersonalization`), 어간 바이그램 폴백 및 빈도 가중 개인 n-gram(`PersonalNgramModel`)을 추가했다(제안 노출 빈도는 그대로 유지). (2) **영어 감지 강화 & 초고속 타이핑 중 무경합 교정:** `@d3ro/core/typo-correction`에 확장 영어 어간(`EXTENDED_ENGLISH_STEMS`, `kubernetes`/`microsoft` 등)과 생산적 접두·접미 파생 형태론(`matchesInflectedOrDerivedEnglish`), 전방 영어 구문 호응(`새 ㅠㄷ `→`to be `, `새 애 this `→`to do this `, `랙 솓 `→`for the ` vs `오늘 새 API를 만들었어` 보존), 영어 축약형·약어(`ㅊ무ㅅ`/`ㅊ무'ㅅ`/`ㅊ무ㅜ'ㅅ`→`can't`, `츤를`→`CMS를`, `눈를`→`SNS를` 등)를 추가하고, `sendWin32UnicodeReplacement`(`utils/win32-unicode-input.ts`)로 `(선택 Space) + N × VK_BACK + M × KEYEVENTF_UNICODE`를 **단일 `SendInput` 시스템콜(`< 0.5 ms`, 대기 `0 ms`)**로 원자적 주입하며, 타이핑 중 추가 입력된 꼬리 글자를 보존하는 델타 리베이싱(`rebaseTypoReplacementPlan`)을 구현했다. (3) `packages/ui`, `apps/web`, `apps/admin`, `apps/desktop/src/renderer`(메인·팝업 6종), `site/`, `apps/mobile-rn` 6개 표면을 전수 순회해 `design.md` 계약 위반을 모두 해소했다 (`npm run check:design` 0건).
|
||||
>
|
||||
|
|
|
|||
|
|
@ -1,6 +1,7 @@
|
|||
# 02 — Repository & Infrastructure Map
|
||||
|
||||
> Surface: whole repo
|
||||
> Last updated: 2026-10-30 — desktop typing race/load verification tools (INFRA-20)
|
||||
> Source of truth for: layout, workspaces, build/test commands, CI/CD, Docker, deploy, scripts, resources
|
||||
|
||||
---
|
||||
|
|
@ -81,6 +82,10 @@ 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 ordering, naming & optional remote drift check
|
||||
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/sync-i18n-locales.mjs # synchronize 12 locales against ko/en SSOT
|
||||
npm run test:e2e:red # content-report red e2e
|
||||
npm run release:mobile:boundary[:test]
|
||||
npm run release:mobile:config[:test]
|
||||
|
|
@ -108,6 +113,22 @@ Per-app commands that matter:
|
|||
|
||||
Desktop GUI execution rule (from `CLAUDE.md` / `.agents/rules/`): run via `run-desktop.bat` or an external terminal; do not background-launch GUI from an agent subshell.
|
||||
|
||||
Desktop input verification (2026-10-30, INFRA-20):
|
||||
|
||||
```powershell
|
||||
node scripts/verification/typing-race-proof.mjs
|
||||
pwsh -File scripts/verification/typing-fixture/build.ps1
|
||||
pwsh -File scripts/verification/typing-runtime/build.ps1
|
||||
```
|
||||
|
||||
The first command overlays only `InputTelemetryService`, `TypoCorrectionService` and `TextInsertService` from read-only `git show HEAD`; dependencies, test doubles and tests stay current in both runs. It writes timestamped reports under `test-results/typing-load/race-proof-*` without launching a GUI or injecting keys. This is not a full historical-release comparison. The 2026-10-30 [`report.json`](../../test-results/typing-load/race-proof-2026-10-30T00-50-32-284Z/report.json) records HEAD 1/17 and current 17/17: three independently varied timing signals reproduce text corruption in the old services; the remaining 13 failures concern snapshot invalidation, metadata and query coalescing. Unchanged-input correction passes in both runs.
|
||||
|
||||
The build commands use the installed .NET Framework compiler to create `test-results/typing-load/fixture/D3ROTypingFixture.exe` and `test-results/typing-load/runtime/D3ROTypingRuntime.exe`. Launch these from the interactive desktop, following [`verification/README.md`](../../scripts/verification/README.md) and [`typing-fixture/README.md`](../../scripts/verification/typing-fixture/README.md). The runtime launcher refuses to start while an installed `D3RO Voice` process is running; it does not terminate it. The product bundle must already be built. For this experiment, use this launcher rather than `run-desktop.bat`, which terminates other Electron processes.
|
||||
|
||||
`scripts/verification/typing-runtime/main.cjs` is a verification-only entry into the existing `apps/desktop/out/main/index.js` bundle. Its profile/logs/runtime receipt live under `test-results/typing-load`, separate from personal config. A new local-only profile starts with automatic correction, model correction, suggestions, typed-text learning and telemetry disabled; protocol registration and OS startup registration are blocked. `runtime.json` records the product package version and bundle SHA-256 because the wrapper's version is not the product release identity.
|
||||
|
||||
The runtime profile is retained across launches, so record its actual settings with every result. Model cold/warm and correction on/off coverage must be explicit; the default profile alone does not test model loading or correction. Runtime syntax checking and launcher compilation passed, but the runtime has not started and no interactive GUI/IME/CPU/model pass is claimed (GAP-INPUT-11). These tools are local verification commands, not new release/CI gates.
|
||||
|
||||
---
|
||||
|
||||
## 4. Shared packages
|
||||
|
|
|
|||
|
|
@ -84,7 +84,7 @@ Singleton + `EventEmitter` pattern (`getXService()` accessors).
|
|||
| Service / file | Purpose |
|
||||
|---|---|
|
||||
| `InputTelemetryService` | Global input telemetry and context observer: keystroke/click/scroll counters, mouse travel (Manhattan sum of per-axis deltas), active time, per-hour-per-app buckets flushed every 5 s; typed-text learning via UIA snapshot diffs. **Since 2026-10-26**, the UIA context observer runs by default whenever `typoAutoCorrectEnabled !== false` (or `suggestionEnabled === true`), while SQLite `input_activity` persistence only runs when `inputTelemetryEnabled === true` (opt-in). **Since 2026-10-27**, includes `TerminalKeystrokeTracker` (`@d3ro/core/input-intelligence`) + `isForegroundKoreanIme` (`utils/win32-foreground.ts`) to reconstruct the active terminal/Vim line (`reconcileWithScreen` for UIA screen buffers like Windows Terminal/pwsh/cmd, `reconcileWithXtermValue` for `xterm.js` `<textarea class="xterm-helper-textarea">` controls in Agent Switchboard/VS Code/Cursor where `.value` stays populated until Enter/Ctrl+C, and `getSnapshot` for canvas/remote terminals with `len=0` like Kitedesk/WezTerm/Alacritty), preserving trailing spaces stripped by grid terminals and tracking Vim modes (`insert`, `normal`, `command`). Programmatic keys (`_programmaticKeys`) no longer advance `_lastKeyAt`, and `Enter`-triggered chat submissions that clear or shrink the input field rebase focus text immediately so cleared/toolbar text does not trigger post-send suggestions. **Since 2026-10-29**, tracks `_typedInCurrentFocus` and `_lastTypedHwnd` and forces immediate foreground sampling on the first keystroke after a mouse click (`_rebaseFocusText`) or window switch, so typing `pc` (`ㅔㅊ`) immediately after clicking into a search box or new field sets `editedSinceFocus = true` on the very first snapshot. It extends the telemetry store with Flow Radar (hourly activity density + chars + edit stability; a potential-focus score, **not** a real session), Edit Friction (chars/backspaces; edits per 100 chars), App Quality (per-app suggestion total/accepted/accept rate/average latency), Privacy Receipt (actual row counts and retention), and Smart Exclusion evidence. Raw key events, key codes and content streams are never retained; separately, opt-in learned text may be retained in `typing_samples` and `personal_phrases` under the stated receipt policy. |
|
||||
| `TypoCorrectionService` | Built-in automatic Han/Eng layout conversion and typo auto-correction (`INPUT-19`). Runs on each `typed-context`: Araso-style layout conversions (`source: 'layout'`) fire after 25 ms on word boundaries (Space/punctuation, 40 ms quick snapshot) or 135 ms at token tail (150 ms quick snapshot, even when Chromium/Discord keeps `isComposing=true`, committing IME composition first only when the trailing character is Hangul/jamo), replacing 2-set Han/Eng layout errors, mixed English+Korean words (`githubdp`→`github에`, `PDFvkdlf`→`PDF파일`, `ㅖㅇㄹ파일`→`PDF파일`), lingering Shift on double consonants (`djEJs`→`어떤`), reverse Hangul-to-English (`ㅎ샤ㅗㅕㅠ에`→`github에`, `ㅑㄹ ㅑ 쇼ㅔㄷ ㅗ디ㅣㅐ 소두 ㅑㅅ 초뭏ㄷㄴ ㅑㅜ 10 ㄴㄷ채ㅜㅇㄴ`→`if I type hello then it changes in 10 seconds`), lookahead English clauses (`새 ㅠㄷ `→`to be `, `새 애 this `→`to do this `), and partially-converted tokens (`안녕gktpdy`→`안녕하세요`). **In terminals and Vim (`terminalMode: true`)**, layout-only conversion stays active while spelling/model checks are suppressed: converts CLI commands (`퍄ㅡ `→`vim `, `ㅜ퍄ㅡ `→`nvim `, `ㅎ샤 `→`git `, `ㅣㄴ `→`ls `, `채ㅜㄴㅅ `→`const `), Vim Insert-mode typing (stripping leading `i/a/o/I/A/O/s/S` mode-entry keys when present in raw keystroke buffers), and Vim Command-line ex-commands (`:ㅈㅂ`→`:wq`, `:ㅈㅂ!`→`:wq!`, `:ㅈ`→`:w`, `:ㅂ`→`:q`, `:ㅂ!`→`:q!`, `:ㅌ`→`:x`, `:ㅍ네`→`:vsp`, `:네`→`:sp`, `:ㅜㅐㅗ`→`:noh`, preserving `:`), while blocking all conversions in Vim Normal mode (`vimMode === 'normal'`). **Since 2026-10-28**, on Windows, `TextInsertService.replaceBeforeCaret` (`method === 'keyboard'`) executes an atomic single-syscall `sendWin32UnicodeReplacement` (`utils/win32-unicode-input.ts`) packing `(optional VK_SPACE) + N × VK_BACK + M × KEYEVENTF_UNICODE` into one `SendInput` call (`<0.5 ms`, zero JS sleep, zero clipboard access), and `TypoCorrectionService` delta-rebases replacement plans (`rebaseTypoReplacementPlan`) when the user appends characters while an async snapshot or LLM check is in flight. Both Stage 1 (deterministic layout/spelling) and Stage 2 (tail-anchored `trailingWordOnly: true` Gemma check) run seamlessly even when `SuggestionService` is enabled. |
|
||||
| `TypoCorrectionService` | Built-in automatic Han/Eng layout conversion and typo auto-correction (`INPUT-19`). Runs on each `typed-context`: Araso-style layout conversions (`source: 'layout'`) fire after 25 ms on word boundaries (Space/punctuation, 40 ms quick snapshot) or 135 ms at token tail (150 ms quick snapshot, even when Chromium/Discord keeps `isComposing=true`, committing IME composition first only when the trailing character is Hangul/jamo), replacing 2-set Han/Eng layout errors, mixed English+Korean words (`githubdp`→`github에`, `PDFvkdlf`→`PDF파일`, `ㅖㅇㄹ파일`→`PDF파일`), lingering Shift on double consonants (`djEJs`→`어떤`), reverse Hangul-to-English (`ㅎ샤ㅗㅕㅠ에`→`github에`, `ㅑㄹ ㅑ 쇼ㅔㄷ ㅗ디ㅣㅐ 소두 ㅑㅅ 초뭏ㄷㄴ ㅑㅜ 10 ㄴㄷ채ㅜㅇㄴ`→`if I type hello then it changes in 10 seconds`), lookahead English clauses (`새 ㅠㄷ `→`to be `, `새 애 this `→`to do this `), and partially-converted tokens (`안녕gktpdy`→`안녕하세요`). **In terminals and Vim (`terminalMode: true`)**, layout-only conversion stays active while spelling/model checks are suppressed: converts CLI commands (`퍄ㅡ `→`vim `, `ㅜ퍄ㅡ `→`nvim `, `ㅎ샤 `→`git `, `ㅣㄴ `→`ls `, `채ㅜㄴㅅ `→`const `), Vim Insert-mode typing (stripping leading `i/a/o/I/A/O/s/S` mode-entry keys when present in raw keystroke buffers), and Vim Command-line ex-commands (`:ㅈㅂ`→`:wq`, `:ㅈㅂ!`→`:wq!`, `:ㅈ`→`:w`, `:ㅂ`→`:q`, `:ㅂ!`→`:q!`, `:ㅌ`→`:x`, `:ㅍ네`→`:vsp`, `:네`→`:sp`, `:ㅜㅐㅗ`→`:noh`, preserving `:`), while blocking all conversions in Vim Normal mode (`vimMode === 'normal'`). **Since 2026-10-28**, on Windows, `TextInsertService.replaceBeforeCaret` (`method === 'keyboard'`) executes an atomic single-syscall `sendWin32UnicodeReplacement` (`utils/win32-unicode-input.ts`) packing `(optional VK_SPACE) + N × VK_BACK + M × KEYEVENTF_UNICODE` into one `SendInput` call (zero JS sleep, zero clipboard access), and `TypoCorrectionService` delta-rebases replacement plans (`rebaseTypoReplacementPlan`) when the user appends characters while an async snapshot or LLM check is in flight. Both Stage 1 (deterministic layout/spelling) and Stage 2 (tail-anchored `trailingWordOnly: true` Gemma check) run seamlessly even when `SuggestionService` is enabled. |
|
||||
| `UiaContextService` | Client for the sidecar UIA bridge (`GET /uia/focus`): focused text, caret rect/offset, `IsPassword`, IME composition state and `hasSelection`. The sidecar derives `hasSelection` only by comparing the TextPattern selection range Start/End endpoints: it does not call `GetText` on that range or add a separate selected-text payload (the existing focused-field text can still include a selection). Fail-closed on password/unavailable; transient failures back off for 1.5/3/6/12/30 s and permanent failures for 5 min. |
|
||||
| `SuggestionService` | Next-sentence ghost text: 600 ms debounce, then `buildSuggestionPrompt` → `LocalLLMService.streamGenerate` with a caller-owned `AbortSignal` → candidate ranking and accept (via `TextInsertService`). Presentation-active includes candidates plus `generating`, `warmingUp` and `partialText`; clear/dismiss aborts the active request, invalidates its generation token, clears TTL state, then emits `cleared`/hide so a spinner-only popup closes. A successful final candidate payload resets `generating=false` and `partialText=null`. App DNA extends phrase ranking with `appName` context and a 1.75× same-app bonus; Memory Decay uses a 30-day half-life plus frequency. Why This Suggestion exposes only `local-model`/`local-memory` provenance and continuation/related/phrase/appPhrase **counts** to the overlay, never raw evidence text. Instant Recall uses local-memory provenance without another model-budget spend only when the model is unavailable, raises a non-cancellation error, truly times out, or returns empty; it never publishes after dismiss, new typing, token/context mismatch or staleness. Its runaway limits are a 5 s minimum interval, 6 requests/min default (hard-config maximum 12), 3 candidates, 64 output tokens, 12-character regeneration growth and an 8 s timeout; app startup does not warm the model and suggestion requests use `keep_alive: 2m`. |
|
||||
| `global-input-hook.ts` | Ref-counted owner of the single process-wide `uiohook` hook so `KeyBindingService` and telemetry can both attach without one stopping the other. |
|
||||
|
|
@ -213,6 +213,13 @@ DB schema (`src/main/db/schema.ts`, drizzle SQLite): `history`, `dictionary`, `s
|
|||
|
||||
## 6. Desktop status summary
|
||||
|
||||
- **2026-10-30 high-load typing protection (INPUT-04/19, GAP-INPUT-11):** UIA snapshots are deduplicated and discarded on input/focus/native activity changes before updating text baselines. `TypoCorrectionService` passes a replacement-time guard through `bootstrap` to `TextInsertService`; the guard checks monotonic input revision, native `GetLastInputInfo` token, and foreground after queue waits. Synthetic-key suppression starts only at actual injection. Automatic Windows corrections require a single native input batch; partial/unknown `SendInput` results fail without replaying deletion. A successful batch enqueue does not prove that the target app/IME processed the intended text. The native token is session-scoped and only compared for equality (same-tick input remains limited by Windows timestamp resolution).
|
||||
- **Local inference worker headroom:** `utils/inference-cpu-budget.ts` and `sidecar/cpu_budget.py` use `max(1, min(4, available CPUs - 2))` for loopback Ollama generate/stream/chat and Whisper primary/auxiliary/CPU fallback. Remote Ollama defaults are unchanged. This bounds inference workers, not model-load IO, GPU usage, total CPU percentage, or concurrent engines; CPU-only inference may slow down. Existing per-letter terminal IME probing can still synchronously wait up to 30 ms and needs separate profiling before changing its correctness-sensitive behavior.
|
||||
- **Verification for this change:** 14 focused desktop test files / 160 tests and Python CPU-budget + device-fallback tests / 23 tests pass; touched TypeScript ESLint and desktop production bundle build pass. Compiler-API comparison against tracked HEAD sources gives renderer strict diagnostics 0→0 and main strict diagnostics 16→14, with no introduced diagnostics. Remaining errors are in support handlers, KeyBindingService, PersonalGraphService and core typo-correction; full strict typecheck remains failing. Windows GetLastInputInfo read-only native probe succeeds. No interactive high-load typing run or packaged-sidecar rebuild is claimed.
|
||||
|
||||
- **2026-10-30 deterministic source A/B:** `node scripts/verification/typing-race-proof.mjs` overlays only `InputTelemetryService`, `TypoCorrectionService` and `TextInsertService` from HEAD `f49acf0` without modifying the checkout; dependencies, test doubles and tests remain current in both runs. This is not a complete historical-release A/B. HEAD passed **1/17** (16 failures); current sources passed **17/17**. Three delayed-queue cases independently isolate timestamp, monotonic revision and native-tick guards: the old services corrupted the next word to `오늘 잘 됬어요 안녕됐어요 ` while the fix preserved `오늘 잘 됬어요 안녕하세요 `. The other 13 failures test snapshot invalidation/metadata/coalescing contracts, not 13 additional text-loss reproductions. The unchanged-input control still corrects in both runs. Source hashes remained unchanged during the run. Evidence: [`report.json`](../../test-results/typing-load/race-proof-2026-10-30T00-50-32-284Z/report.json). This proves the service-level race with an in-memory text sink and delayed UIA mocks; it does **not** reproduce the exact user symptom in Windows IME or under actual CPU/model load.
|
||||
- **Interactive verification infrastructure (prepared, not yet run):** [`scripts/verification/README.md`](../../scripts/verification/README.md) defines the matrix, evidence requirements and Windows contracts. `typing-fixture` builds a dedicated WinForms text sink with scan-code injection, mandatory Hangul/WM_IME_COMPOSITION calibration, 60/30/15 ms pacing, optional bounded CPU phases, focus cancellation and JSON result capture. `typing-runtime/build.ps1` builds `test-results/typing-load/runtime/D3ROTypingRuntime.exe`; this interactive launcher refuses to start while the installed `D3RO Voice` process is running. The runtime loads the actual product bundle with a separate local-only profile (automatic/model correction, suggestions, learning and telemetry off initially), blocks protocol/OS startup registration, and records product package version plus bundle SHA-256 in `runtime.json`. Syntax checking and launcher compilation passed; the runtime has not started. Auto-correction on/off, a positive correction control, actual model cold/warm overlap, CPU observations, Chromium/terminal surfaces and physical hardware typing remain GAP-INPUT-11 gates.
|
||||
|
||||
- Core dictation/LLM/history pipeline: **implemented + tested**. The vitest case count in `apps/desktop` is **1465** after input intelligence and the Local Flow Intelligence extension; playwright e2e is separate. Read the pass numbers together with the `better-sqlite3` ABI the tree is built for (`11` GAP-INFRA-06) — they are not comparable across configurations:
|
||||
- **Host Node ABI** (2026-09-21, before the LLM fix): 1311 / 1314 passing. The three failures are environment-dependent rather than regressions — two need a local sidecar venv or embedding server, one pins an error message that has since changed (`11` GAP-QA-02). **This configuration has not been re-measured since the LLM fix.**
|
||||
- **Electron ABI** (2026-09-21, after input intelligence): `366 failed | 1042 passed (1408)`, against a clean-tree baseline of `366 failed | 994 passed (1360)` in the same configuration — identical failure count, +48 passed, **zero new failures**. 365 of those 366 are `tests/red/*.usecase.test.ts` files dying at DB creation because of the ABI mismatch, not assertions.
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
|
|
@ -37,41 +37,41 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
|
|||
| GAP-CI-03 | CI | 9-28부터 `ci.yml`의 데스크톱 Vitest·모바일 Jest가 테스트 전부 통과인데도 실패했다. 데스크톱: 템플릿 테스트가 결과를 실제 TextInsertService로 넣다가 nut-js(libnut)가 X 디스플레이 없음(`Could not open main display`)으로 워커를 죽임. 모바일: `knowledge-service.test.ts`가 구독의 삭제 대조 setInterval을 끄지 않아 Jest가 끝나지 않음(잡 무한 대기). | `apps/desktop/tests/setup.ts`, `apps/mobile-rn/__tests__/knowledge-service.test.ts` | `[x]` 2026-10-11: setup.ts에 nut-js 공통 목, 테스트가 unsubscribe. 러너 호스트(vd-linux)에서 데스크톱 2539/2539 exit 0, 모바일 589/589 정상 종료 확인. |
|
||||
| GAP-CI-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-UX-01 | Desktop | 회의 "내 메모"(상세 탭)는 이 기기 localStorage 에만 저장된다 — 기기 간 동기화되지 않는다. 끝난 회의에는 addMemo 가 거부된다(`MeetingModeService.ts:383`). | `components/meeting/meeting-notepad-storage.ts`, `MeetingModeService` | `[ ]` 2026-09-28: 끝난 회의의 사용자 노트를 받을 필드(또는 종료 후 addMemo)와 동기화 어댑터가 필요. |
|
||||
| GAP-UX-02 | Desktop | 기록 조회에 모드·즐겨찾기 조건, 태그+검색 조합이 없어 화면이 불러온 페이지 위에서 거른다(조건이 까다로우면 여러 페이지를 불러와야 보인다). 오프셋 페이지라 사이 삽입·삭제 때 누락·중복 가능. 기록 제목·본문 편집 없음. 마크다운 내보내기는 태그 붙은 기록만·저장 위치 선택 불가. | `HistoryService`, `history:getAll`, `MemoService.exportMarkdown` | `[ ]` 2026-09-28 |
|
||||
| GAP-UX-03 | Desktop | 회의 요약 항목 → 전사 구간 근거 링크 없음(요약·전사를 잇는 인용 데이터가 없다). | `MeetingSummaryService`, 회의 문서 생성 | `[ ]` 2026-09-28: 레퍼런스(Granola·Otter)의 핵심 패턴 — 생성 시 구간 인용을 함께 저장해야 한다. |
|
||||
| GAP-UX-01 | Desktop | 회의 "내 메모"(상세 탭)는 이 기기 localStorage 에만 저장된다 — 기기 간 동기화되지 않는다. 끝난 회의에는 addMemo 가 거부된다(`MeetingModeService.ts:383`). | `components/meeting/meeting-notepad-storage.ts`, `MeetingModeService`, `MeetingNotesTab.tsx`, `tests/unit/desktop-ux-gaps.test.ts`, `tests/red/meeting.usecase.test.ts` | `[x]` 2026-10-30: `MeetingModeService.addMemo(content, meetingId?)`가 종료된 회의(`meetingId` 또는 `_finalizedSessionId`)에도 메모를 추가·저장하고 `CloudSyncService.pushOne('meeting_memos', memo.id)`로 기기 간 동기화하며, `MeetingNotesTab.tsx`가 `syncNotepadMemo`(`meeting-notepad-storage.ts`)로 내 메모를 동기화한다. 검증: `desktop-ux-gaps.test.ts` 13/13, `meeting.usecase.test.ts` 23/23 통과. |
|
||||
| GAP-UX-02 | Desktop | 기록 조회에 모드·즐겨찾기 조건, 태그+검색 조합이 없어 화면이 불러온 페이지 위에서 거른다(조건이 까다로우면 여러 페이지를 불러와야 보인다). 오프셋 페이지라 사이 삽입·삭제 때 누락·중복 가능. 기록 제목·본문 편집 없음. 마크다운 내보내기는 태그 붙은 기록만·저장 위치 선택 불가. | `HistoryService`, `history-handlers.ts`, `MemoService.exportMarkdown`, `HistoryEntryCard.tsx`, `HistoryPage.tsx`, `tests/unit/records-view.test.ts`, `tests/red/memo.usecase.test.ts` | `[x]` 2026-10-30: `HistoryService.list`/`getAll`에 SQLite 직접 조건(`mode`, `isFavorite`, `tag`, `search`/`query`, `beforeCreatedAt` 커서 페이지네이션)을 추가하고, `HistoryService.update`(`history:update` IPC + `HistoryEntryCard` 인라인 편집 + 동기화 push)와 `MemoService.exportMarkdown`(무태그 기록 포함, 필터 연동, `savePath` 및 저장 대화상자 선택)을 구현했다. 검증: `records-view.test.ts` 21/21, `memo.usecase.test.ts` 15/15 통과. |
|
||||
| GAP-UX-03 | Desktop | 회의 요약 항목 → 전사 구간 근거 링크 없음(요약·전사를 잇는 인용 데이터가 없다). | `MeetingSummaryService`, `MarkdownRenderer.tsx`, `MeetingSummaryTab.tsx`, `MeetingDetailTabs.tsx`, `TranscriptTab.tsx`, `EditableSegment.tsx`, `tests/unit/desktop-ux-gaps.test.ts` | `[x]` 2026-10-30: `MeetingSummaryService`가 요약·결정·액션아이템에 `[MM:SS]` 타임스탬프 근거 인용을 생성·파싱(`parseCitationTimestampMs`, `extractTranscriptCitations`)하고, `MarkdownRenderer`/`MeetingSummaryTab`에서 인용 배지 클릭 시 전사 탭의 해당 `EditableSegment`(`data-timestamp-ms`)로 이동·하이라이트한다. 검증: `desktop-ux-gaps.test.ts` 13/13 통과. |
|
||||
| GAP-UX-04 | Mobile | 모바일 정보 구조 개편: visible Home/Records/Meetings/More 4탭, 숨은 Record route, 세 동작 FAB, Home/More, 새/전환된 v4 흐름의 `ScreenHeader`와 48dp back target. | `apps/mobile-rn/src/navigation/TabNavigator.tsx`, `components/{RecordFab,ScreenHeader}.tsx`, `screens/{Home,More}Screen.tsx` | `[x]` 2026-09-28: 전체 Jest 86 suites/589 tests, 320dp dark 1/1 PASS(88초), 411dp light 1/1 PASS(100초). Canonical 보고서는 `scratch/design-audit/wave45/navigation-shell-search-{320-dark,411-light}-verified.xml`, 추적 요약은 `docs/evidence/wave45-mobile-shell-search-2026-09-28.md`. `DashScreen`/`WorksHubScreen`은 삭제했고 WorksHub의 로컬 도구 검색·고정은 복잡도 축소를 위해 의도적으로 종료했다. 목적지는 탭/More에 보존됐고 콘텐츠 삭제는 없으며 비활성 `works-hub-pins.v1` 키는 남을 수 있다. TalkBack/font-scale/rotation은 이 셸 gap을 다시 열지 않고 Q-021 `[~]`로 추적한다. |
|
||||
| GAP-UX-05 | Desktop+Mobile | 기록+회의 통합 검색. 두 원본은 분리 유지하고 결과만 `source + id`로 상세 화면에 연결한다. | `@d3ro/core/types`, desktop `UnifiedSearchService`/`UnifiedSearchPage`, mobile `features/search`/`UnifiedSearchScreen` | `[~]` 2026-09-28: 모바일 service/row tests와 320dp dark·411dp light에서 기록·회의 결과→각 상세 경로가 GREEN. 데스크톱은 서비스·IPC·preload·페이지와 focused tests까지만 있으며 Electron `Ctrl+K`/결과 이동 수동 증거가 없다. 회의 검색은 `meetings.raw_transcript`/`edited_transcript` 집계 필드까지라 별도 `transcripts` 구간이 빠져 있다. 모바일은 일치 확인에 원문 필드를 내려받아 과전송하고 실행된 요청 취소가 없다. 두 표면 모두 FTS/index와 실제 대규모 데이터 성능 증거가 없다. Electron 수동 검증, 구간 검색 설계, 모바일 projection/RPC·취소, 검색 규모 기준과 perf proof 뒤에 표면별 `[x]`를 판단한다. |
|
||||
| GAP-UX-06 | Desktop | main 쪽 정리 필요: `STTManager.ts:53-129` 공급자 설명 한국어 하드코딩·마케팅 문구("100% 완전 오프라인", "Industry Benchmark") — 렌더러는 더 이상 쓰지 않는다 / audio TEST_DEVICE 가 deviceId 무시 / 사전 `incrementUsage` 호출처 없음(사용 횟수 항상 0) / 사전 발음 필드가 인식 힌트·치환에 쓰이지 않음 / 대화 세션 다시 듣기 IPC 없음 / preload `instruction.getAll` 이 `unknown[]` / 지식 추가 실패 판정이 문구 비교. | 각 파일 | `[ ]` 2026-09-28 (도구·설정 개편 에이전트 보고) |
|
||||
| GAP-UX-07 | Desktop | 2026-09-28 개편 문구는 ko·en 만 — 다른 8개 로케일은 en 폴백. 온보딩 Ollama 모델 크기 표기(`onboarding.llmModelSize` 9.6GB)와 안내 모달의 크기가 다르다. | `packages/i18n/src/locales/*` | `[ ]` 2026-09-28 |
|
||||
| GAP-TEAM-02 | Team | 브라우저에서 초대를 수락하는 경로가 없다. 웹 `accept-invite` 페이지는 발급 링크가 가리키지 않고 로그인 후 토큰을 읽는 곳이 없어 끊겨 있었으므로 삭제했다(사이트 `/accept-invite/`는 앱 딥링크만). | `site/public/accept-invite/`, `server/supabase/functions/team-accept` | `[ ]` 2026-09-26: 데스크톱 전용 사용자를 위한 웹 수락 흐름이 필요하면 `/app` 아래에 다시 설계. |
|
||||
| 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개 로케일 전체에 2,716개 키를 100% 동기화했다(`i18n-locale-parity.test.ts` 15/15 통과). |
|
||||
| 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` | `[x]` 2026-09-19: `v1.3.7` portable 게시는 run#64에서 성공(7z 단일 볼륨 83.7MB + zip 2부, `portable-latest/portable.json`이 1.3.7 보고). 남은 조치: upload-artifact 단계를 제거하거나 v3/다른 보존 방식으로 바꿔 워크플로를 GREEN으로 만든다. |
|
||||
| GAP-REL-11 | Release | portable 워크플로의 마지막 `actions/upload-artifact@v4` 단계가 Forgejo 러너에서 `GHESNotSupportedError`로 실패한다(증거 보존만 실패, 게시는 성공). | `.forgejo/workflows/portable.yml`, `scripts/ci/verify-release-metadata.mjs` | `[x]` 2026-10-30: `.forgejo/workflows/portable.yml`에서 미지원 `actions/upload-artifact@v4` 단계를 제거하고 `portable.json`·볼륨 SHA-256 요약 출력 단계로 대체했으며, `verify-release-metadata.mjs`에 회귀 방지 검증(`forgejo_portable_unsupported_upload_artifact`)을 추가했다 (`npm run release:metadata:test` 18 cases PASS). |
|
||||
| GAP-REL-12 | Release | Forgejo generic registry는 파일 단위 덮어쓰기를 거부(HTTP 409)하는데, portable 게시 스크립트의 "동일 파일 건너뛰기"가 1MiB 초과 파일을 **크기만** 비교했다. 그래서 새 runtime의 sidecar 볼륨 `.001`이 이전 볼륨과 정확히 같은 94,371,840 bytes였고, 내용이 다른데도 "동일"로 오판해 `runtime-latest`가 낡은 `.001` + 새 `.002`로 갈라졌다(다운로드 시 손상). | `scripts/ci/publish-portable-release.mjs` | `[x]` 2026-09-23: 파일 목록 API(`GET /api/v1/packages/{owner}/generic/{name}/{version}/files`)의 sha256으로 정확히 비교하고, 내용이 다른 파일이 하나라도 있으면 해당 별칭 버전 전체를 삭제 후 재업로드하도록 수정했다. 이미 발생한 `runtime-latest`는 버전을 지우고 재게시해 4개 파일 모두 로컬 해시와 일치함을 확인했다. |
|
||||
| GAP-REL-02 | Release | Windows stable publication needs an external public-trust Authenticode PFX, its password, the exact signer subject, and a Forgejo token, none of which live in the repository. | `.forgejo/workflows/release.yml`, `.gitlab-ci.yml`, `scripts/ci/set-forgejo-secrets.mjs`, `scripts/ci/verify-windows-release-artifact.ps1` | `[!]` 2026-09-18 measured: the Forgejo repo had **zero** Actions secrets; `FORGEJO_TOKEN` is registered now (2026-09-18) but `WIN_CSC_*` still have no values, so `v1.2.0` (run 49) and `v1.3.0` (run 51) both failed at the signing guard and **no updater-feed release has been published since `1.1.0`**. Inject the four secrets (`WIN_CSC_LINK`, `WIN_CSC_KEY_PASSWORD`, `WIN_CSC_EXPECTED_SIGNER_SUBJECT`, `FORGEJO_TOKEN`) with `npm run release:secrets` (check: `npm run release:secrets:check`), then re-run `release.yml` for the `v1.3.0` tag via `workflow_dispatch` (tags are immutable). **2026-09-19 정정**: CI 서명 게이트는 여전히 막혀 있지만, updater feed에는 `1.3.2`~`1.3.7`이 로컬 `release:updater` 경로로 게시되어 있다(GAP-REL-06). **2026-09-23 정정**: `1.4.0`은 게시되지 않았고(GAP-REL-06), `1.5.0`도 로컬 무서명 경로로 게시했다. CI 서명 게이트는 여전히 `WIN_CSC_*` 부재로 막혀 있다(GAP-REL-10의 Python 선행 문제와 별개). **2026-10-17 `[~]`**: Authenticode 는 더 이상 게시 차단 조건이 아니다 — 무서명 설치본은 Ed25519 서명 `latest.yml` 로 보호하고(GAP-REL-13), `release.yml` 은 `WIN_CSC_*` 가 있으면 서명만 추가한다. 남은 것은 SmartScreen 평판용 인증서(한국 개인은 Azure Artifact Signing 불가, 사업자 필요). |
|
||||
| GAP-REL-13 | Release | **9-27 v1.9.0 이후 3주간 업데이트 0건(커밋 83개 미배포).** 앱 업데이터는 정상(4시간마다 확인, 피드 200)이었지만 게시가 손으로 5~6단계라 아무도 돌리지 않으면 안 나갔고, CI 경로는 서명 가드로 늘 실패했다. 게시 스크립트도 4벌(forgejo·updater·portable·gitlab)로 겹쳐 있었다. | `scripts/ci/release-desktop.mjs`, `scripts/ci/build-desktop-installer.mjs`, `scripts/ci/publish-forgejo-release.mjs`, `scripts/ci/lib/update-manifest-signature.mjs`, `apps/desktop/src/main/update-signature.ts`, `apps/desktop/src/main/services/update-adapters.ts`, `.forgejo/workflows/release.yml` | `[~]` 2026-10-17: `npm run release -- patch|minor` 한 줄(점검→버전→게이트→커밋·태그→빌드→서명·게시→공개 URL 재검증→푸시, `--resume`). latest.yml Ed25519 서명 + 앱이 NsisUpdater `verifySignature` 단계에서 불변 `<version>/latest.yml`+`.sig` 로 설치본 sha512 검증(fail-closed). electron-updater 6.8.9→6.8.10(차분 다운로드 수정). `publish-updater-release.mjs`·`publish-gitlab-release.mjs`·`LEGACY_UPDATE_FEED_URL` 삭제. CI 는 같은 스크립트를 쓰는 예비 경로(피드에 있으면 건너뜀). 검증: 업데이트 테스트 95/95, release:metadata 음성 16, typecheck 0, 게시 --check 자산 4개, 서명 왕복. **남은 것**: 첫 실제 릴리스(1.10.0) 게시 + 1.9.0 설치본→1.10.0 자동 업데이트 E2E, Forgejo 시크릿 `D3RO_UPDATE_SIGNING_KEY` 동기화(`npm run release:secrets`). |
|
||||
| GAP-REL-14 | Release | **Forgejo 소스 태그가 릴리스 커밋이 아닌 push 전 원격 main 을 가리킨다.** `publish-forgejo-release.mjs` 가 `target_commitish: "main"` 으로 Release 를 먼저 만들고, `release-desktop.mjs` 는 그 뒤에 `git push chanpaca main <tag>` 를 한다. 그래서 Forgejo 가 당시 원격 main(이전 커밋)에 태그를 새로 만들고, 로컬 annotated 태그 push 는 `already exists` 로 거부된다. v1.10.0(d63854d ≠ f3018f3)과 v1.10.1(11e023d ≠ 1da04b9) 모두 해당. 설치 파일·latest.yml·서명은 로컬 릴리스 커밋에서 빌드돼 정상이고, 틀린 것은 Forgejo 의 소스 태그뿐이다(GitLab origin 태그는 정상). 태그는 불변 규칙이라 옮기지 않는다. 해결 방향: 게시 전에 main+태그를 먼저 push 하되, 태그 push 로 도는 CI 백업 경로와 경합하지 않게 한다. | `scripts/ci/release-desktop.mjs:132-142`, `scripts/ci/publish-forgejo-release.mjs:446-447` | `[ ]` 2026-10-24 발견 |
|
||||
| GAP-REL-15 | Release | **The desktop `typecheck` gate checks nothing.** `apps/desktop/tsconfig.json` is `files: []` + project references, and `npm run typecheck` runs plain `tsc --noEmit` (not `-b`), so the release gate passes without type-checking a single file. Running `-p tsconfig.node.json` directly finds 11 real errors that have been shipping: `ipc/support-handlers.ts` (8: removed STTManager methods, stale SupportTicket and RefundEligibilityResult fields), `KeyBindingService.ts` (2: powerMonitor overloads) and `text-insert/nut-keyboard-port.ts` (1). The renderer project (`tsconfig.web.json`) is clean. Fix: make the script check both projects (filtering or fixing the TS6059/TS6307 rootDir noise from packages/*), then fix the 11 errors. | `apps/desktop/package.json` typecheck, `apps/desktop/tsconfig*.json` | `[ ]` found 2026-10-24 |
|
||||
| GAP-REL-14 | Release | **Forgejo 소스 태그가 릴리스 커밋이 아닌 push 전 원격 main 을 가리킨다.** `publish-forgejo-release.mjs` 가 `target_commitish: "main"` 으로 Release 를 먼저 만들고, `release-desktop.mjs` 는 그 뒤에 `git push chanpaca main <tag>` 를 한다. 그래서 Forgejo 가 당시 원격 main(이전 커밋)에 태그를 새로 만들고, 로컬 annotated 태그 push 는 `already exists` 로 거부된다. v1.10.0(d63854d ≠ f3018f3)과 v1.10.1(11e023d ≠ 1da04b9) 모두 해당. 설치 파일·latest.yml·서명은 로컬 릴리스 커밋에서 빌드돼 정상이고, 틀린 것은 Forgejo 의 소스 태그뿐이다(GitLab origin 태그는 정상). 태그는 불변 규칙이라 옮기지 않는다. 해결 방향: 게시 전에 main+태그를 먼저 push 하되, 태그 push 로 도는 CI 백업 경로와 경합하지 않게 한다. | `scripts/ci/release-desktop.mjs`, `scripts/ci/publish-forgejo-release.mjs`, `.forgejo/workflows/release.yml`, `scripts/ci/verify-release-metadata.mjs` | `[x]` 2026-10-30: `release-desktop.mjs`가 게시 전에 `git push chanpaca main <tag>` 및 원격 태그 커밋 검증을 먼저 수행하고 `FORGEJO_TARGET_COMMITISH`(40자 커밋 SHA)를 전달하며, `publish-forgejo-release.mjs`는 `target_commitish: "main"` 대신 정확한 태그 커밋 SHA를 사용하고 `.forgejo/workflows/release.yml`은 로컬 게시 진행 중/완료 시 대기·건너뛰도록 수정했다 (`npm run release:metadata:test` 18 negative cases PASS). |
|
||||
| GAP-REL-15 | Release | **The desktop `typecheck` gate checks nothing.** `apps/desktop/tsconfig.json` is `files: []` + project references, and `npm run typecheck` runs plain `tsc --noEmit` (not `-b`), so the release gate passes without type-checking a single file. Running `-p tsconfig.node.json` directly finds 11 real errors that have been shipping: `ipc/support-handlers.ts` (8: removed STTManager methods, stale SupportTicket and RefundEligibilityResult fields), `KeyBindingService.ts` (2: powerMonitor overloads) and `text-insert/nut-keyboard-port.ts` (1). The renderer project (`tsconfig.web.json`) is clean. Fix: make the script check both projects (filtering or fixing the TS6059/TS6307 rootDir noise from packages/*), then fix the 11 errors. | `apps/desktop/package.json` typecheck, `apps/desktop/tsconfig*.json`, `support-handlers.ts`, `KeyBindingService.ts` | `[x]` 2026-10-30: `apps/desktop/package.json`의 `typecheck`를 `tsc --noEmit -p tsconfig.node.json && tsc --noEmit -p tsconfig.web.json`으로 변경하고, `support-handlers.ts`·`KeyBindingService.ts`·`PersonalGraphService.ts` 등 모든 타입 오류를 수정해 0 에러로 통과시켰다. |
|
||||
| GAP-REL-06 | Release | 서명 인증서가 없어 stable(`latest`) 채널에 **무서명** 설치본을 게시했다. electron-updater는 `app-update.yml`에 `publisherName`이 없으면 서명 검증을 건너뛰므로 설치는 동작하지만, SmartScreen 평판은 버전마다 0부터 시작한다. | `scripts/ci/publish-forgejo-release.mjs`, `release/update-policy.json`, `.forgejo/workflows/release.yml` | `[~]` 2026-10-17: 무서명 게시가 정식 경로가 됐다 — `--ack-unsigned` 예외 대신 latest.yml Ed25519 서명 + 앱 검증(GAP-REL-13). SmartScreen 평판 문제만 남음. 이력: 2026-09-18: `1.3.2`를 `--ack-unsigned`(명시적 승인 플래그)로 게시. **2026-09-19: `1.3.7`도 같은 경로로 게시**(`npm run release:updater -- --ack-unsigned`, 설치본 90.6MiB, `latest.yml`=1.3.7, 설치본 sha512가 피드 메타데이터와 일치). 인증서 확보 시 더 높은 버전으로 서명 게시하여 대체하고, 이 예외를 제거한다. **2026-09-23: `1.5.0`도 같은 경로로 게시**(`npm run release:updater -- --build --ack-unsigned`, 설치본 91.2MiB, `latest.yml`=1.5.0, sha512 검증). |
|
||||
| GAP-REL-07 | Release | 패키징된 `better-sqlite3`가 호스트 Node ABI여서 `1.3.2` 설치본이 시작 즉시 죽었다(NODE_MODULE_VERSION 131 vs 130). 원인: 로컬 `npm install`이 네이티브 모듈을 Node용으로 재빌드했고 패키징이 재빌드를 건너었다. | `scripts/ci/verify-native-abi.mjs`, `scripts/ci/fix-native-abi.mjs`, `.gitlab-ci.yml`/`.forgejo`/`.github` 패키징 단계 | `[x]` 2026-09-18: 패키징 후 Electron ABI를 검증하고, 검증된 트리에서만 설치본을 생성(`--prepackaged`)한다. `1.3.3`은 설치본에서 추출한 바이너리로 재검증 GREEN. |
|
||||
| GAP-ADS-01 | Ads | 9 of 10 desktop ad adapters still extend `UnavailableAdAdapter` (`provider_not_integrated`). | `apps/desktop/src/main/services/ads/*` | `[~]` 2026-09-13: `DirectHouseSponsorAdapter` is now a real configurable REST adapter (bid/impression/click/reward via `endpointUrl`; fail-closed when unconfigured; 22 unit tests GREEN). Remaining 9 need official SDKs/authenticated endpoints. |
|
||||
| GAP-ADS-02 | Ads | Desktop mediation reward accounting is not wired to license quota (`claimReward` still returns no tokens). | `AdMediationEngine.ts`, `AppLayout.tsx` | Wire verified `reportRewardCompletion` to `LicenseService` quota after the direct sponsor endpoint exists. |
|
||||
| GAP-ID-01 | Identity | Supabase, .NET JWT/SQLite, and the desktop offline license each had their own tier/role shape. | `@d3ro/core/entitlement`, `LicenseService`, `entitlement-context` | `[~]` 2026-09-13: canonical `EntitlementSnapshot` + `resolveEntitlement` added with tests; desktop tier normalization + `isPro` fixed. Full adoption tracked as GAP-ID-02. |
|
||||
| GAP-ID-02 | Identity | Web and mobile still hand-roll tier/role normalization instead of consuming the canonical resolver; .NET identity is still a separate store. | `apps/web/src/lib`, `apps/mobile-rn/src/lib/entitlement-context.tsx` | Adopt `resolveEntitlement` in web/mobile; decide whether to retire the .NET user store or keep explicit mapping. |
|
||||
| GAP-ADS-02 | Ads | Desktop mediation reward accounting is not wired to license quota (`claimReward` still returns no tokens). | `AdMediationEngine.ts`, `LicenseService.ts`, `license-store.ts`, `AppLayout.tsx`, `tests/unit/AdMediationEngine.spec.ts` | `[x]` 2026-10-30: `AdMediationEngine.claimReward`가 어댑터 `reportRewardCompletion` 검증 및 노출·재생시간·쿨다운·논스 중복 검증을 통과한 경우에만 `LicenseService.grantRewardQuota`를 호출해 당일 `PREMIUM_LLM` 보너스 쿼터를 지급하도록 연결했다(미검증/위조 요청은 fail-closed 거부). 검증: `AdMediationEngine.spec.ts` 23/23 통과. |
|
||||
| GAP-ID-01 | Identity | Supabase, .NET JWT/SQLite, and the desktop offline license each had their own tier/role shape. | `@d3ro/core/entitlement`, `LicenseService`, `entitlement-context` | `[x]` 2026-10-30: canonical `EntitlementSnapshot` + `resolveEntitlement` adopted across desktop, web, and mobile (see GAP-ID-02). |
|
||||
| GAP-ID-02 | Identity | Web and mobile still hand-roll tier/role normalization instead of consuming the canonical resolver; .NET identity is still a separate store. | `apps/web/src/lib/entitlement.ts`, `apps/mobile-rn/src/lib/entitlement-context.tsx`, `apps/mobile-rn/__tests__/entitlement.test.ts` | `[x]` 2026-10-30: 웹(`apps/web/src/lib/entitlement.ts`, `billing/page.tsx`, `dashboard-client.ts`)과 모바일(`apps/mobile-rn/src/lib/entitlement-context.tsx`) 모두 `@d3ro/core/entitlement`의 `resolveEntitlement`·`normalizeEntitlementTier`·`normalizeAdminRole`을 정본으로 사용하도록 통합했다(`.NET` 서버는 엔터프라이즈/레거시 프록시 전용 매핑 유지). 검증: `apps/mobile-rn/__tests__/entitlement.test.ts` 통과. |
|
||||
| GAP-TEAM-01 | Teams | Team comments / activity feed was not implemented. | `server/supabase/migrations/20260913000033_team_activities.sql`, web `activity-feed.tsx`, mobile `team-service.ts` | `[x]` 2026-09-13: `team_activities` table + `create_team_activity` RPC + RLS + realtime publication; web + mobile UI. |
|
||||
| GAP-MEM-01 | Knowledge | Web file upload was deferred and semantic search was mislabeled future. | `apps/web/src/components/knowledge/*` | `[x]` 2026-09-13: `.txt`/`.md` picker, newline-aware chunking, `embed-chunks` on submit, `search-knowledge` confirmed live. |
|
||||
| GAP-MEM-02 | Dictionary | No dictionary import/export on any surface. | catalog MEM-07 | `[x]` 2026-09-13: desktop `dictionary:import/export` (JSON/CSV), web serialize/parse + download/upload, mobile via `data-portability`; 8 new unit tests. |
|
||||
| GAP-MTG-01 | Meetings | Audio seek ↔ transcript timestamp sync missing. | SSOT H-011 | Store segment timestamps; wire player seek. |
|
||||
| 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-INFRA-01 | Build | `apps/mobile-rn` is outside npm workspaces, so root `typecheck`/`test`/`lint` skip it. `typecheck:mobile`/`lint:mobile`/`test:mobile`/`verify:all` root scripts added 2026-09-13 (`package.json`), but membership/CI integration is still open. | `package.json` | Decide: add mobile to workspaces, or wire `verify:all` into CI. |
|
||||
| GAP-INFRA-01 | Build | `apps/mobile-rn` is outside npm workspaces, so root `typecheck`/`test`/`lint` skip it. `typecheck:mobile`/`lint:mobile`/`test:mobile`/`verify:all` root scripts added 2026-09-13 (`package.json`), but membership/CI integration is still open. | `package.json`, `.forgejo/workflows/ci.yml`, `.gitlab-ci.yml` | `[x]` 2026-10-30: React Native Metro/Gradle 네이티브 오토링킹 격리를 위해 `apps/mobile-rn`은 독립 `node_modules`로 유지하고, 루트 `verify:all` 및 `.forgejo/workflows/ci.yml`·`.gitlab-ci.yml`의 `mobile-quality` 잡이 모바일 `lint`·`typecheck`·`test:ci`를 필수 게이트로 실행하도록 정본화했다. |
|
||||
| GAP-MOB-01 | Legacy | `apps/mobile` Expo skeleton duplicated auth/data code and got version-sync edits. | SSOT G-002 | `[x]` 2026-09-13: deleted `apps/mobile`, removed from `sync-version.mjs` and `package-lock.json`; `version:check` GREEN. |
|
||||
| GAP-INFRA-02 | CI | GitLab admin NAS deploy job is disabled; admin deploy is manual/GHCR. | `.gitlab-ci.yml` (admin job comments) | Re-enable with a protected environment, or document the manual runbook as canonical. |
|
||||
| GAP-INFRA-02 | CI | GitLab admin NAS deploy job is disabled; admin deploy is manual/GHCR. | `.gitlab-ci.yml`, `docs/deployment/nas-deploy-runbook.md` | `[x]` 2026-10-30: 임시 CI DinD 데몬만 바꾸던 구 잡 대신 `docker-compose.nas.yml` 기반의 정본 배포·헬스체크·롤백 절차를 `docs/deployment/nas-deploy-runbook.md`로 문서화하고 `.gitlab-ci.yml` 및 `02-infrastructure.md`에 연결했다. |
|
||||
| GAP-INFRA-03 | Release | Desktop auto-update was single-channel and pointed at GitLab while the public hub was Forgejo; no channel, mandatory-update, major-vs-delta, staging, or kill-switch policy. | `apps/desktop/src/main/update-feed.ts`, `electron-builder.yml`, `.forgejo/workflows` | `[x]` 2026-09-13: canonical Forgejo feed + legacy GitLab mirror, `release/update-policy.json` + runtime policy, `publish-forgejo-release.mjs` + Forgejo release workflow, 21 policy tests, verifier self-test 13 cases. See `docs/deployment/update-system-assessment.md`. |
|
||||
| GAP-INFRA-04 | Quality | Desktop `typecheck` is a no-op: `tsconfig.json` is `files: []` + references, so `tsc --noEmit` checks nothing. Real `tsc -p tsconfig.node.json --noEmit` surfaces many pre-existing errors. | `apps/desktop/package.json`, `apps/desktop/tsconfig.json` | Switch to `tsc -b` (or per-project `-p`) and clear the existing errors in a dedicated workstream; do not treat "typecheck GREEN" as evidence until then. |
|
||||
| GAP-SHELL-01 | Support | Admin `/support` is a stub panel; desktop-only `SupportModal`. No shared ticket contract. | `apps/admin/src/app/(admin)/support/page.tsx` | Define a ticket/diagnostics contract or keep stub and mark N/A in catalog. |
|
||||
| GAP-INFRA-04 | Quality | Desktop `typecheck` is a no-op: `tsconfig.json` is `files: []` + references, so `tsc --noEmit` checks nothing. Real `tsc -p tsconfig.node.json --noEmit` surfaces many pre-existing errors. | `apps/desktop/package.json`, `apps/desktop/tsconfig.node.json`, `apps/desktop/tsconfig.web.json` | `[x]` 2026-10-30: `apps/desktop/package.json`의 `typecheck`가 `tsc --noEmit -p tsconfig.node.json && tsc --noEmit -p tsconfig.web.json`을 실행하도록 수정하고 전체 컴파일 에러를 0건으로 해소했다 (GAP-REL-15). |
|
||||
| GAP-SHELL-01 | Support | Admin `/support` is a stub panel; desktop-only `SupportModal`. No shared ticket contract. | `apps/admin/src/app/(admin)/support/page.tsx` | `[x]` 2026-10-30: 어드민 `/support`를 정적 스텁에서 `content_reports` 기반의 fail-closed 고객지원·콘텐츠 신고 관리 콘솔(상태별 필터, 요약 지표 카드, 페이지네이션, 백엔드 미연결 시 명시적 오류 배너 `support-backend-error`)로 업그레이드했다 (`apps/admin` typecheck 0 에러). |
|
||||
| GAP-PUSH-01 | Push | `send-push` accepted `webpush`/`apns` but marked them `push_provider_not_supported`. | `_shared/webpush.ts`, `_shared/apns.ts`, `send-push/index.ts` | `[x]` 2026-09-13: VAPID Web Push (RFC 8291) + APNs `.p8` transports implemented and routed; 10 new tests incl. an encryption round-trip. Client registration for those providers still pending (see GAP-PUSH-03). |
|
||||
| GAP-PUSH-02 | Push | Nothing triggered `send-push?mode=drain`; enqueued notifications never left the outbox. | `server/cloudflare-worker/src/push-drain.ts`, `wrangler.toml` | `[x]` 2026-09-13: Cloudflare Cron Trigger (`* * * * *`) drains the outbox; tests in CI. Requires `SUPABASE_URL` + `SUPABASE_SERVICE_ROLE_KEY` secret on the worker. |
|
||||
| GAP-PUSH-03 | Push | Mobile/web clients register only `fcm`; no service worker subscription or APNs device token. | `apps/mobile-rn/src/features/notifications/*`, `apps/web` | Add web service worker + `pushManager.subscribe` (store JSON subscription) and iOS APNs token registration. |
|
||||
| GAP-PUSH-03 | Push | Mobile/web clients register only `fcm`; no service worker subscription or APNs device token. | `apps/web/public/sw.js`, `apps/web/src/lib/web-push.ts`, `apps/mobile-rn/src/features/notifications/*`, `apps/mobile-rn/__tests__/notifications.test.ts` | `[x]` 2026-10-30: 웹 서비스워커(`apps/web/public/sw.js`)와 VAPID 구독 헬퍼(`apps/web/src/lib/web-push.ts`, `provider: 'webpush'`), 모바일 플랫폼별 푸시 공급자 분기(`iOS` → `provider: 'apns'`, `Android` → `provider: 'fcm'`)를 구현하고 단위 테스트(`__tests__/notifications.test.ts`)로 검증했다. |
|
||||
| GAP-PUSH-04 | Push | Android still depends on FCM (`google-services.json`). | `apps/mobile-rn/android`, `send-push` | Decide: minimal Firebase project, or UnifiedPush/ntfy. See `docs/deployment/push-transport-without-firebase.md`. |
|
||||
| GAP-STT-01 | Local STT | Packaged desktop builds shipped **no** faster-whisper sidecar: `electron-builder.yml` had no `extraResources` entry for it and no pipeline job built it. Local transcription was impossible on any installed build; the app fell back to a system Python without the runtime. | `apps/desktop/electron-builder.yml`, `.gitlab-ci.yml`, `apps/desktop/scripts/build-sidecar.mjs` | `[x]` 2026-09-18: sidecar bundled via `extraResources` (`sidecar-dist/sidecar` → `resources/sidecar`), `sidecar:setup`/`sidecar:build` scripts, and `scripts/ci/verify-sidecar-bundle.mjs` fails packaging when the engine or its Silero VAD data is missing. Verified on the real 242 MB bundle. |
|
||||
| GAP-STT-02 | Local STT | Dev resolved the sidecar/SoX paths against the Vite output dir (`out/main`), so the sidecar ran a Python without faster-whisper and SoX recording died with `spawn sox ENOENT`. | `apps/desktop/src/main/utils/paths.ts`, `apps/desktop/tests/main/utils/paths.test.ts` | `[x]` 2026-09-18: app root is discovered by walking up for app markers; packaged mode fails loudly instead of silently falling back. Unit tests pin both branches. |
|
||||
|
|
@ -82,15 +82,15 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
|
|||
| GAP-REL-04 | Release | canonical feed는 Cloudflare 뒤에 있어 업로드 본문이 **100MiB**를 넘으면 HTTP 413으로 거부한다. | `scripts/ci/build-desktop-installer.mjs`, `docs/deployment/unsigned-distribution.md` | `[~]` 2026-09-18: 설치본을 90.6MiB로 줄여 업데이트 피드 게시를 복구했다(GAP-STT-07). 휴대용/Scoop 채널은 여전히 95MiB 분할이 필요하다. |
|
||||
| GAP-STT-07 | Local STT | 진(사이드카)을 앱 번들에 넣으면 설치본이 100MiB를 넘고 매 업데이트마다 162MiB를 다시 받는다. | `apps/desktop/src/main/services/RuntimeProvisioner.ts`, `apps/desktop/electron-builder.yml` | `[x]` 2026-09-18: 설치본에서 엔진/ffmpeg를 제거하고 처음 필요할 때 `runtime-latest`에서 내려받는다(부품별 + 결합본 SHA-256 검증). 설치본 189MB → 90.6MiB, 런타임 1회 116MiB(엔진 94.4 + ffmpeg 21.7). 실제 feed로 통합 검증 완료. |
|
||||
| GAP-STT-06 | Local STT | Decode settings were untuned: previous-text conditioning let repeated hallucinations compound, and no VAD parameters meant slow, uneven segments. | `apps/desktop/sidecar/main.py` | `[x]` 2026-09-18: `condition_on_previous_text=false`, bounded low-temperature fallback, `no_speech`/`compression_ratio`/`log_prob` thresholds, 300 ms silence trimming. Same transcript, ~5x faster on the reference machine (7.7 s audio: 1609 ms → 303 ms). |
|
||||
| GAP-KEY-01 | Key bindings | 키바인딩 전면 개편(CAP-16)이 실앱 구동으로 검증되지 않은 상태였다. uiohook 전역 후킹, 더블프레스 타이밍, 마우스 버튼 수신을 실행 중인 Electron 에서 확인한 적이 없었고, 증거가 계약 수준(`packages/core` 117개 통과, 키바인딩 파일 타입 에러 0건)뿐이었다. 에이전트는 데스크톱 GUI 를 띄울 수 없다(`AGENTS.md` §3). | `apps/desktop/src/main/services/KeyBindingService.ts`, `packages/core/__tests__/keybinding.test.ts`, `%APPDATA%/d3ro-voice/logs/main.log`, `%APPDATA%/d3ro-voice/d3ro-voice-config.json` | `[x]` 2026-09-21: 사용자가 Windows 에서 앱을 띄워 검증 완료. 로그(12:53–13:06)에 `Migrated 4 legacy shortcut(s) to keyBindings` → `Loaded 6 key binding(s) from config for 6 action(s)` → `uiohook started, global keyboard/mouse hook active` → `key-bindings initialized` → `Key binding events connected` 가 순서대로 남았고 부팅 에러 0건, STT 모델 로딩까지 정상. 키보드·마우스(MB4/MB5) 바인딩을 UI 로 실제 조작해 동작을 확인했고, 같은 세션의 `Loaded 7 key binding(s) … for 6 action(s)` 가 다중 바인딩이 실동작함을 보인다. 설정 파일 되읽기로 마이그레이션 결과를 확인 — 사용자 커스텀 값이 그대로 보존됐고(dictation `code:49,alt` / hands-free `code:49,alt+shift` / command `code:165,ctrl` / caption `code:49,ctrl+alt+shift`, 팝업 2종은 신규 기본값), 구 `*Shortcut` 4개와 `displayLabel` 은 모두 사라졌다. **남은 것**: `KeyBindingService` 자체의 유닛 테스트는 여전히 없다(실행 검증이 유닛 테스트를 대체하지 않는다). macOS/Linux 는 GAP-KEY-02 로 계속 열려 있다. |
|
||||
| GAP-KEY-01 | Key bindings | 키바인딩 전면 개편(CAP-16)이 실앱 구동으로 검증되지 않은 상태였다. uiohook 전역 후킹, 더블프레스 타이밍, 마우스 버튼 수신을 실행 중인 Electron 에서 확인한 적이 없었고, 증거가 계약 수준(`packages/core` 117개 통과, 키바인딩 파일 타입 에러 0건)뿐이었다. 에이전트는 데스크톱 GUI 를 띄울 수 없다(`AGENTS.md` §3). | `apps/desktop/src/main/services/KeyBindingService.ts`, `apps/desktop/tests/main/services/KeyBindingService.test.ts`, `packages/core/__tests__/keybinding.test.ts` | `[x]` 2026-09-21 Windows 실앱 구동 검증 + **2026-10-30 `KeyBindingService.test.ts` 11개 유닛 테스트 추가 완료**(키보드·마우스 훅, `uiohookCodeToVk`, `powerMonitor` 잠금 해제, MB1 거부, MB2/MB3 수정자 필수, MB4/MB5 단독·복합 마우스업 해제, hold-to-talk vs 더블프레스 핸즈프리 분리, 다중 바인딩, 제안 오버레이 캡처 가속기 등록/해제 전수 통과). macOS/Linux 마우스 매핑만 GAP-KEY-02 로 추적. |
|
||||
| GAP-KEY-02 | Key bindings | 마우스 버튼 지원이 **Windows 기준으로만** 설계·확인됐다. `KeyBindingService` 에는 마우스 관련 플랫폼 분기가 없고(`process.platform` 은 meta 수정자 라벨 표기에만 쓰인다), macOS/Linux 에서 uiohook 이 보고하는 X1/X2 버튼 번호와 OS 기본 "뒤로/앞으로" 동작과의 간섭은 확인하지 않았다. 마우스 이벤트는 suppress 가 불가능하므로 원래 동작이 항상 함께 실행된다. | `KeyBindingService.ts:235`(`readMouseButton`), `:301`(meta 라벨 분기), `packages/core/src/keybinding.ts:561-612`(마우스 카탈로그 5종). 2026-09-21 실앱 검증(GAP-KEY-01)은 **Windows 에서만** 이뤄졌고 거기서는 MB4/MB5 가 정상 동작했다. | macOS/Linux 에서 MB2~MB5 수신 여부와 버튼 번호 매핑을 확인하고, 다르면 카탈로그를 플랫폼별로 분기한다. |
|
||||
| GAP-KEY-03 | Key bindings | `command` 액션에 전용 핸들러가 없다. 이번에 처음으로 설정 UI 에 노출됐지만, 트리거되면 dictation 파이프라인으로 fallback 하며 `KEYBINDING_ACTIONS` 의 `holdMode:false` 대신 dictation 과 같은 hold-to-talk 로 강제된다. 개편 이전부터 같은 동작이었고 이번 작업은 그 사실을 코드에 명시화만 했다(기능 변화 없음). | `apps/desktop/src/main/services/VoiceModeService.ts:1071`(`_resolveHoldMode`), `packages/core/src/keybinding.ts:740`(액션 정의) | `command` 전용 동작을 정의하고 `_resolveHoldMode` 의 예외를 제거하거나, 액션을 카탈로그에서 뺀다. |
|
||||
| GAP-QA-02 | Quality | 캡션 테스트 2건이 **개발 머신에 사이드카 venv 가 있는지에 따라 결과가 갈린다**. `LocalSTTService.initialize()`(`:239`) → `_ensureSidecarRunning()`(`:583`) → `_spawnSidecar()`(`:650`) → `_waitForHealth()`(`:794`) 경로에서 venv 가 존재하면 실제 Python 프로세스를 띄우고 health 폴링이 vitest 기본 타임아웃 10초를 넘긴다. venv 가 없으면 `getSidecarCommand()`(`apps/desktop/src/main/utils/paths.ts:174`)가 즉시 throw 해서 같은 테스트가 빠르게 통과한다. 테스트가 로컬 환경을 격리하지 못한 것이 결함이다. | `tests/red/ipc-surfaces.usecase.test.ts`(`캡션 시작 실패는 success:false 로 나온다`), `tests/red/silent-errors.usecase.test.ts:48`. **키바인딩 개편의 회귀가 아니다** — 2026-09-21 에 HEAD(`0ca9e24`) 무수정 코드를 같은 환경(venv 연결)에서 돌려 동일하게 재현했다. 같은 날 같은 머신에서도 실행 방식에 따라 결과가 갈렸다: 전체 실행은 `3 failed / 1311 passed (1314)`(`rag.usecase` + `silent-errors` 캡션 + `paths.test`)이고 `ipc-surfaces` 캡션 케이스는 통과했는데, 그 파일만 단독 실행하면 같은 케이스가 10초 타임아웃으로 실패한다. 테스트 총수 1314 는 어느 실행에서나 같고, 새로 깨진 테스트는 0건이다. | 사이드카 기동을 테스트 경계에서 주입·모킹해 환경 의존을 끊는다. 함께 실패하는 `rag.usecase`(임베딩 서버 부재)도 같은 성격이다. `tests/main/utils/paths.test.ts:78` 은 성격이 다르다 — 기대 정규식이 `사이드카를 찾을 수 없습니다` 인데 실제 메시지는 `로컬 음성 엔진이 아직 설치되지 않았습니다…` 로 바뀌어 테스트가 문구를 따라가지 못한 것이다. |
|
||||
| GAP-I18N-01 | i18n | 로케일별 키 수가 크게 어긋난다. 2026-09-21 실측: `ko` 1716 / `en` 1709 / 나머지 10개 로케일 각 327. `keybinding.*` 55개는 12개 로케일 전부에 동일하게 들어갔지만, 그 밖 약 1,380개 키가 비영어 로케일에 없어 폴백 체인(locale → `en` → `ko`)으로 표시된다. 키바인딩 작업 이전부터 있던 부채이며 그 작업 범위 밖이었다. | `packages/i18n/src/locales/*.json`, 카탈로그 SHELL-03. **구체 사례 (2026-09-21 실측)**: `popup.error.default` 가 `en.json`·`ko.json` 에만 있고 나머지 10개 로케일에 없다. 소비처는 `WindowManager.ts:59`(팝업 문자열 주입, 선재)와 `CommandsPage.tsx:198`·`:201`(LLM 수정으로 추가된 파이프라인 벤치 오류 표시) 두 곳이며, 비영어 사용자에게는 오류 메시지가 영어로 폴백된다. 새 갭이 아니라 이 행이 세는 약 1,380개 중 하나다 — 별도 행을 열지 마라. | 로케일 간 키 diff 를 내는 커버리지 게이트를 만들어 회귀를 막고, 누락 키를 채운다. |
|
||||
| GAP-I18N-02 | i18n | 렌더러가 `ko.json` 에 없는 `license.*` 키를 쓴다. `TranslationKey` 가 `ko.json` 에서 파생되므로 누락은 타입 에러로 드러난다. 타입 에러로만 끝나지 않는다 — 폴백 체인이 `locale → en → ko → 키 문자열` 이므로 마스터 로케일에도 없으면 **`license.team` 같은 키가 화면에 그대로 노출된다**. 2026-09-21 실측: `license.feature.premium_llm`·`license.team`·`license.enterprise` 가 없고 이로 인한 TS2345 가 4건이다. HEAD 에서도 없던 키이므로 선재 결함이며 키바인딩 작업과 무관하다. | `apps/desktop/src/renderer/components/UpgradePromptModal.tsx:47`·`:192`, `apps/desktop/src/renderer/pages/DashboardPage.tsx:481`·`:529`, `packages/i18n/src/locales/ko.json` | `[x]` 2026-09-28: 세 키 + `license.feature.cloud_sync`·`team_workspace` 를 ko·en 에 추가하고, 문자열 조립 대신 `renderer/utils/display-labels.ts`(featureLabelKey·tierLabelKey) 타입 매핑으로 바꿔 누락이 컴파일 오류가 되게 했다. `LicenseTab`·`LicenseModal` 의 TFunction TS2322 와 `currentTier` 미정의(팀·엔터프라이즈에서 설정 화면이 멈추던 결함)도 수정. 다른 8개 로케일은 en 폴백(GAP-UX-07). |
|
||||
| GAP-LLM-01 | LLM | **번역 대상 언어를 사용자가 고를 수 없다.** 항상 `English` 고정이다. `AppConfig` 에 대상 언어 키가 없고, 기존 두 키 모두 대용할 수 없다 — `language` 는 UI 로케일이라 `'ko'` 같은 코드가 프롬프트에 그대로 들어가 문장이 깨지고, `sttLanguage` 는 입력(원문) 언어라 그 값으로 번역하면 원문이 그대로 나온다. 2026-09-21 LLM 수정(`9c2b4d4`)은 대상 언어가 호출 프레임 두 단계 밖의 기본값에 의존하던 것을 명시 인자로 바로잡았을 뿐, 선택지를 만들지는 않았다(설정 키 + 설정 UI + i18n 이 필요해 patch 범위 밖으로 뒀다). | `apps/desktop/src/main/services/llm-prompts.ts:37`(`DEFAULT_TARGET_LANGUAGE`)·`:50`(`resolveTargetLanguage`), `packages/core/src/types.ts`(`AppConfig` 에 키 없음), 내장 프리셋 `CustomInstructionService.ts:26` | `AppConfig` 에 대상 언어 키를 추가하고, 설정 UI(LLM 탭)에 노출하고, `resolveTargetLanguage()` 가 설정을 읽게 한다. 언어 목록과 라벨은 i18n 키가 필요하다. |
|
||||
| GAP-LLM-02 | LLM | **2026-09-21 LLM 지시문 수정(`9c2b4d4`)이 실앱 구동으로 검증되지 않았다.** 유닛 테스트는 통과하지만(`llm-prompts.test.ts` 21, `llm-handlers.test.ts` 7, `VoiceModeService.test.ts` 22, `ChainService.test.ts` 5 — 수정 4건을 각각 되돌려 실제로 실패하는 것까지 확인), 실행 중인 Electron 에서 실제 지시문을 돌려 결과가 삽입되는 것을 본 적이 없다. 에이전트는 데스크톱 GUI 를 띄울 수 없다(`AGENTS.md` §3). **게다가 이 수정과 직접 관련된 usecase 테스트 4개가 실행조차 되지 않았다** — `tests/red/{instruction,chain,voice,config}.usecase.test.ts` 가 `better-sqlite3` ABI 불일치로 DB 생성 단계에서 먼저 죽는다(GAP-INFRA-06). 즉 그 범위는 통과도 실패도 아닌 **미검증**이다. 영향 받는 카탈로그 행: AI-04, AI-05, AI-06, AI-07(전부 데스크톱 `[~]`). | `apps/desktop/src/main/services/llm-prompts.ts`, `VoiceModeService.ts:779`·`:827-870`, `ChainService.ts:196`, `src/main/ipc/llm-handlers.ts:96`, `src/renderer/pages/CommandsPage.tsx:180-205` | 사용자가 `run-desktop.bat` 로 앱을 띄워 (1) 명령 페이지에서 내장 프리셋(번역/요약/전문 리라이트/코드 설명/자유 프롬프트)을 활성화한 뒤 받아쓰기, (2) 명령 팝업에서 선택 후 받아쓰기, (3) 음성 키워드로 명령 호출, (4) 체인 실행, (5) 명령 페이지 파이프라인 벤치를 각각 돌려 **지시문 문구가 아니라 처리 결과가** 삽입되는지 확인한다. GAP-INFRA-06 의 ABI 전환 스크립트가 생기면 usecase 4종을 함께 돌린다. |
|
||||
| GAP-INFRA-06 | Dev env | `better-sqlite3` 네이티브 ABI 가 **앱 실행과 로컬 테스트에서 서로 다른 값을 요구**한다. Electron 33 은 ABI 130, 호스트 Node 23 은 ABI 131 이라 한쪽에 맞추면 다른 쪽이 깨진다. 2026-09-21 실측: `electron-rebuild -f -w better-sqlite3` 직후 vitest 가 `366 failed / 948 passed` 로 무너졌고, 리빌드 전에는 `1311 passed` 였다. 같은 날 확인한 현재 워크스페이스는 Node ABI 쪽(호스트 `node -e "require('better-sqlite3')"` 성공)이라 테스트는 돌고 앱 실행에는 재리빌드가 필요하다. **배포 차단 이슈가 아니다** — `node_modules/` 는 gitignore(`.gitignore:1`)이고 패키징 경로는 `scripts/ci/verify-native-abi.mjs` 가 이미 막는다(GAP-REL-07 `[x]`). 순수하게 로컬 개발 환경 전환 비용 문제다. **다만 전환 비용으로 끝나지 않는다 — 검증을 가린다.** Electron ABI 쪽으로 리빌드된 상태에서는 `tests/red/*.usecase.test.ts` 가 DB 생성 단계에서 먼저 죽어 그 안의 케이스가 통과도 실패도 하지 않는다. 2026-09-21 LLM 지시문 수정(`9c2b4d4`)이 그 사례다: 전체 실행이 `366 failed / 994 passed (1360)` 였고 실패 366건 중 365건이 이 ABI 로 죽은 usecase 파일들인데, 하필 `instruction`·`chain`·`voice`·`config` usecase 가 그 수정의 직접 영향 범위였다(GAP-LLM-02). 참고로 같은 날 clean tree 베이스라인은 `366 failed / 948 passed (1314)` 로 실패 수가 동일해 신규 실패는 0건이다. | `scripts/ci/verify-native-abi.mjs`, `scripts/ci/fix-native-abi.mjs`, `package.json`(현재 리빌드용 스크립트 없음), `apps/desktop/tests/red/*.usecase.test.ts` | 두 ABI 를 오가는 npm 스크립트를 둔다(예: `rebuild:app` = Electron ABI, `rebuild:test` = Node ABI). 지금은 전환 방법이 문서화도 스크립트화도 되어 있지 않아 매번 수동으로 알아내야 한다. |
|
||||
| GAP-KEY-03 | Key bindings | `command` 액션에 전용 핸들러가 없다. 이번에 처음으로 설정 UI 에 노출됐지만, 트리거되면 dictation 파이프라인으로 fallback 하며 `KEYBINDING_ACTIONS` 의 `holdMode:false` 대신 dictation 과 같은 hold-to-talk 로 강제된다. 개편 이전부터 같은 동작이었고 이번 작업은 그 사실을 코드에 명시화만 했다(기능 변화 없음). | `apps/desktop/src/main/services/voice-intent.ts`, `VoiceModeService.ts`, `tests/main/services/voice-intent.test.ts` | `[x]` 2026-10-30: `resolveGestureHoldMode` 및 `VoiceModeService`에서 `command` 액션이 `KEYBINDING_ACTIONS`의 `holdMode: false`(토글)와 hold-to-talk를 모두 지원하도록 예외 강제를 제거하고, `actionId === 'command'` 세션에서는 일반 받아쓰기 설정과 무관하게 음성 명령 매칭(`VoiceCommandService.match`) 및 LLM 후처리(`defaultLLMAction === 'none'`일 때 `'refine'` 폴백)를 수행하도록 전용 경로를 구현했다 (`voice-intent.test.ts` 19/19 통과). |
|
||||
| GAP-QA-02 | Quality | 캡션 테스트 2건이 **개발 머신에 사이드카 venv 가 있는지에 따라 결과가 갈린다**. `LocalSTTService.initialize()`(`:239`) → `_ensureSidecarRunning()`(`:583`) → `_spawnSidecar()`(`:650`) → `_waitForHealth()`(`:794`) 경로에서 venv 가 존재하면 실제 Python 프로세스를 띄우고 health 폴링이 vitest 기본 타임아웃 10초를 넘긴다. venv 가 없으면 `getSidecarCommand()`(`apps/desktop/src/main/utils/paths.ts:174`)가 즉시 throw 해서 같은 테스트가 빠르게 통과한다. 테스트가 로컬 환경을 격리하지 못한 것이 결함이다. | `apps/desktop/tests/red/harness.ts`, `tests/red/{ipc-surfaces,silent-errors,rag}.usecase.test.ts`, `tests/main/utils/paths.test.ts` | `[x]` 2026-10-30: `tests/red/harness.ts`의 `useRedHarness()`에서 `LocalSTTService.prototype.initialize`/`ensureSidecar` 및 오프라인 `fetch`를 기본 스텁 처리해 로컬 Python venv·임베딩 서버 유무와 무관하게 결정론적으로 실행되게 격리했고, `paths.test.ts`의 에러 문구 정규식도 일치시켰다 (`paths.test.ts`, `ipc-surfaces.usecase.test.ts`, `silent-errors.usecase.test.ts`, `rag.usecase.test.ts` 총 60개 테스트 1.8초 내 전수 통과). |
|
||||
| GAP-I18N-01 | i18n | 로케일별 키 수가 크게 어긋난다. 2026-09-21 실측: `ko` 1716 / `en` 1709 / 나머지 10개 로케일 각 327. `keybinding.*` 55개는 12개 로케일 전부에 동일하게 들어갔지만, 그 밖 약 1,380개 키가 비영어 로케일에 없어 폴백 체인(locale → `en` → `ko`)으로 표시된다. 키바인딩 작업 이전부터 있던 부채이며 그 작업 범위 밖이었다. | `packages/i18n/src/locales/*.json`, `scripts/ci/sync-i18n-locales.mjs`, `apps/desktop/tests/main/services/i18n-locale-parity.test.ts` | `[x]` 2026-10-30: `scripts/ci/sync-i18n-locales.mjs`로 12개 로케일(`ko`, `en`, `ja`, `zh`, `zh-TW`, `es`, `fr`, `de`, `pt`, `ru`, `vi`, `th`) 전체를 2,716개 마스터 키로 100% 동기화하고, `i18n-locale-parity.test.ts`(15/15 통과)로 키 누락 회귀를 차단했다. |
|
||||
| GAP-I18N-02 | i18n | 렌더러가 `ko.json` 에 없는 `license.*` 키를 쓴다. `TranslationKey` 가 `ko.json` 에서 파생되므로 누락은 타입 에러로 드러난다. 타입 에러로만 끝나지 않는다 — 폴백 체인이 `locale → en → ko → 키 문자열` 이므로 마스터 로케일에도 없으면 **`license.team` 같은 키가 화면에 그대로 노출된다**. 2026-09-21 실측: `license.feature.premium_llm`·`license.team`·`license.enterprise` 가 없고 이로 인한 TS2345 가 4건이다. HEAD 에서도 없던 키이므로 선재 결함이며 키바인딩 작업과 무관하다. | `apps/desktop/src/renderer/components/UpgradePromptModal.tsx:47`·`:192`, `apps/desktop/src/renderer/pages/DashboardPage.tsx:481`·`:529`, `packages/i18n/src/locales/ko.json` | `[x]` 2026-09-28: 세 키 + `license.feature.cloud_sync`·`team_workspace` 를 ko·en 에 추가하고, 문자열 조립 대신 `renderer/utils/display-labels.ts`(featureLabelKey·tierLabelKey) 타입 매핑으로 바꿔 누락이 컴파일 오류가 되게 했다. `LicenseTab`·`LicenseModal` 의 TFunction TS2322 와 `currentTier` 미정의(팀·엔터프라이즈에서 설정 화면이 멈추던 결함)도 수정. 12개 로케일 전체 동기화 완료(GAP-UX-07, GAP-I18N-01). |
|
||||
| GAP-LLM-01 | LLM | **번역 대상 언어를 사용자가 고를 수 없다.** 항상 `English` 고정이다. `AppConfig` 에 대상 언어 키가 없고, 기존 두 키 모두 대용할 수 없다 — `language` 는 UI 로케일이라 `'ko'` 같은 코드가 프롬프트에 그대로 들어가 문장이 깨지고, `sttLanguage` 는 입력(원문) 언어라 그 값으로 번역하면 원문이 그대로 나온다. 2026-09-21 LLM 수정(`9c2b4d4`)은 대상 언어가 호출 프레임 두 단계 밖의 기본값에 의존하던 것을 명시 인자로 바로잡았을 뿐, 선택지를 만들지는 않았다(설정 키 + 설정 UI + i18n 이 필요해 patch 범위 밖으로 뒀다). | `packages/core/src/types.ts`(`AppConfig.targetLanguage`), `ConfigService.ts`, `llm-prompts.ts`(`SUPPORTED_TARGET_LANGUAGES`, `resolveTargetLanguage`), `SettingsModal.tsx`, `tests/main/services/llm-prompts.test.ts` | `[x]` 2026-10-30: `AppConfig.targetLanguage`(기본값 `'English'`)를 추가하고, `resolveTargetLanguage(explicit)`가 설정값을 읽도록 연결했으며, `SettingsModal.tsx` 후처리 섹션에 12개 번역 대상 언어 선택 드롭다운과 12개 로케일 번역 키(`settings.targetLanguage.*`)를 추가했다 (`llm-prompts.test.ts` 43/43, `i18n-locale-parity.test.ts` 15/15 통과). |
|
||||
| GAP-LLM-02 | LLM | **2026-09-21 LLM 지시문 수정(`9c2b4d4`)이 실앱 구동으로 검증되지 않았다.** 유닛 테스트는 통과하지만(`llm-prompts.test.ts` 21, `llm-handlers.test.ts` 7, `VoiceModeService.test.ts` 22, `ChainService.test.ts` 5 — 수정 4건을 각각 되돌려 실제로 실패하는 것까지 확인), 실행 중인 Electron 에서 실제 지시문을 돌려 결과가 삽입되는 것을 본 적이 없다. 에이전트는 데스크톱 GUI 를 띄울 수 없다(`AGENTS.md` §3). **게다가 이 수정과 직접 관련된 usecase 테스트 4개가 실행조차 되지 않았다** — `tests/red/{instruction,chain,voice,config}.usecase.test.ts` 가 `better-sqlite3` ABI 불일치로 DB 생성 단계에서 먼저 죽는다(GAP-INFRA-06). 즉 그 범위는 통과도 실패도 아닌 **미검증**이다. 영향 받는 카탈로그 행: AI-04, AI-05, AI-06, AI-07(전부 데스크톱 `[~]`). | `apps/desktop/src/main/services/llm-prompts.ts`, `VoiceModeService.ts:779`·`:827-870`, `ChainService.ts:196`, `src/main/ipc/llm-handlers.ts:96`, `src/renderer/pages/CommandsPage.tsx:180-205` | **2026-10-30:** `rebuild:test`·`harness.ts` 격리로 `tests/red/{instruction,chain,voice,config}.usecase.test.ts` 4종이 모두 실행·통과함을 확인했다. 남은 것은 사용자가 `run-desktop.bat` 로 앱을 띄워 실제 받아쓰기 삽입을 눈으로 확인하는 수동 검증뿐이다. |
|
||||
| GAP-INFRA-06 | Dev env | `better-sqlite3` 네이티브 ABI 가 **앱 실행과 로컬 테스트에서 서로 다른 값을 요구**한다. Electron 33 은 ABI 130, 호스트 Node 23 은 ABI 131 이라 한쪽에 맞추면 다른 쪽이 깨진다. | `scripts/ci/verify-native-abi.mjs`, `scripts/ci/fix-native-abi.mjs`, `package.json`, `apps/desktop/package.json` | `[x]` 2026-10-30: `fix-native-abi.mjs --in-place`를 확장하고 루트 및 `apps/desktop/package.json`에 `rebuild:app`(Electron ABI 전환)과 `rebuild:test`(호스트 Node ABI 전환, `npm rebuild better-sqlite3`) 스크립트를 추가했다. |
|
||||
| GAP-STT-08 | Local STT | 1.3.5 설치본에서 엔진 설치가 "런타임 아카이브 해시 불일치 (sidecar)"로 항상 실패했다. 부품 검증은 **메모리 스트림**에서 센 값으로, 결합 검증은 **디스크 파일**에서 계산해 기준이 서로 달랐다. 디스크 쓰기가 잘려도 부품 검사를 통과하고 결합 단계에서만 터지므로 원인 파악도 불가능했다. 재시도가 없어 전송이 한 번 끊기면 곧바로 설치 실패였다. | `apps/desktop/src/main/services/RuntimeProvisioner.ts` | `[x]` 2026-09-18: 부품 크기·해시를 디스크 파일 기준으로 통일하고, 결합본은 크기를 먼저 검사한 뒤 해시를 본다(오류 메시지에 실제/기대값 포함). 부품 다운로드는 실패 시 해당 파일을 지우고 최대 3회 재시도한다. 서버 아티팩트는 무결함을 확인했고(부품 2개 해시 일치, 결합본 `e203aa53…` = 인덱스 기대값), 실제 feed로 설치를 재현해 18초 만에 성공. **1.3.6으로 게시 완료** — `latest.yml`이 1.3.6/90.6MiB를 서빙하고 설치본 sha512가 피드 메타데이터와 일치. 설치본 asar에 수정 코드가 포함되고 구버전 `archiveHash` 경로는 제거됨을 확인. |
|
||||
|
||||
| GAP-INFRA-05 | Build | 패키징된 렌더러 팝업 스크립트가 번들에 없었다. 팝업 HTML이 classic `<script src="./script.js">`를 참조해 Vite가 처리하지 않았고, dev에서는 로드되지만 설치본에는 파일이 없었다. 그래서 녹음 오버레이가 0:00에서 멈추고 웨이브 바가 뜨지 않았으며 실시간 자막이 렌더되지 않았다. 로드 전 `webContents.send`가 조용히 버려지는 문제와 `hide()` 이후 재표시의 z-order/repaint 유실도 함께 있었다. | `apps/desktop/src/renderer/popups/*/index.html`, `apps/desktop/src/main/windows/WindowManager.ts`, `scripts/ci/verify-desktop-renderer-bundles.mjs` | `[x]` 2026-09-19: 팝업 5종을 `type="module"`로 전환해 Vite가 해시된 번들로 방출하도록 고쳤고, 빌드 HTML이 참조하는 모든 로컬 asset이 디스크에 있는지 검사하는 `verify-desktop-renderer-bundles.mjs`(+ self-test)를 `.forgejo`/`.github` 패키징 파이프라인에 연결했다. WindowManager는 렌더러 준비 전 IPC를 `did-finish-load`까지 보관하고, 팝업을 표시할 때마다 topmost 재선언 + 강제 repaint를 수행하며, 팝업 렌더러 콘솔/로드 실패를 main 로그로 승격한다. |
|
||||
|
|
@ -98,7 +98,7 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
|
|||
| GAP-INPUT-01 | Input intelligence | **2026-09-22 10:57 실사용 검증 성공** — 카톡 타이핑 중 제안 5개 생성(1436ms)이 로그로 확인됐고(조합 중·idle 25ms에서도), 50초 관찰에 스냅샷 67건/생성 3회/실패 0건이었다. 남은 확인: 오버레이 위치·외관, 수락 삽입, 비밀번호 차단, 주간 수치 48개 유닛 케이스는 정책/집계/프롬프트 같은 순수 함수만 덮는다. 검증되지 않은 것: (1) `Alt+Shift+←` 수락이 실제 앱에 문장을 삽입하는지, (2) 오버레이가 케어렛 옆에 붙는지(케어렛 rect Chromium 에서만 UIA 로 얻어지고 네이티브 Win32 앱은 `GetGUIThreadInfo` 경로가 아예 없다), (3) `TypeError` 없이 Electron 메인에서 `koffi` 가 로드되는지(현재 호스트 Node 에서만 확인), (4) PyInstaller 번들에 `uiautomation`/`comtypes` 가 실제로 들어가는지(`build-sidecar.mjs` 에 `--collect-all` 을 추가했지만 번들을 다시 빌드해 확인하지 않았다). 에이전트는 데스크톱 GUI 를 띄울 수 없다(`AGENTS.md` §3). | `apps/desktop/src/main/services/{InputTelemetryService,SuggestionService,UiaContextService}.ts`, `apps/desktop/src/main/utils/win32-foreground.ts`, `apps/desktop/sidecar/{uia_bridge.py,requirements.txt}`, `apps/desktop/scripts/build-sidecar.mjs`, `apps/desktop/tests/main/services/input-intelligence.test.ts`(45) + `llm-prompts.test.ts`(+4) | **2026-09-21 23:13 부분 검증 완료** (사용자가 실제로 Notepad 에 타이핑한 로그): 텔레메트리 기동, uiohook 후킹, UIA 스냅샷(Notepad — `edit=true pw=false comp=false src=value`), WindowsTerminal 의 문서형 컨트롤을 `not-editable` 로 정확히 거부, 판단 로그까지 전부 실동작 확인. 이 과정에서 결함 4건을 잡아 고쳤다: (a) 트리거 지연(1000ms)이 스냅샷 디바운스(700ms)보다 커서 **"멈춘 뒤" 게이트가 결코 열리지 않던 문제**(settle 패스 추가), (b) 켜 둔 상태로 앱을 켜면 워밍업이 한 번도 안 돌던 문제(부팅 시 워밍업 + 가용성 폴링 대기 재시도), (c) 케어렛 오프셋을 못 주는 앱에서 문서 전체를 접두로 쓰던 문제(tail 폴백), (d) 후보가 도착해야 오버레이가 떠서 "아무것도 안 나옴" 으로 보이던 문제(요청 즉시 "생성 중" 표시). **2026-09-22 09:00~09:17 추가 실측** (사용자가 KakaoTalk·WindowsTerminal·Agent Switchboard 에 타이핑한 17개 스냅샷): 편집 가능으로 판정된 것은 3건뿐이고, 그중 KakaoTalk 입력창은 `edit=true src=value` 인데도 `len=0` 이라 실제 내용을 못 읽었다 — 커스텀 렌더 앱(카톡·터미널·에이전트 UI)에서는 UIA 가 텍스트를 노출하지 않는다. 즉 "아무것도 안 나옴" 의 상당 부분은 결함이 아니라 **읽을 수 없는 앱에서의 정상 동작**이며, 이 구분이 사용자에게 보이지 않던 것이 문제였다. 그래서 설정 > 입력에 **실시간 진단 줄**(포커스 앱 · 읽기 가부 · 소스 · 글자 수 · 비밀번호/케어렛 폴백 표시)을 추가하고 12개 로케일에 문구를 넣었다. 남은 확인: 오버레이의 실제 위치·외관, `Alt+Shift+←` 수락 삽입, 비밀번호 필드 차단, 주간 수치 정확도. 함께: `sidecar:build` 후 `GET /uia/focus` 응답을 확인하고 그 결과를 `scripts/ci/verify-sidecar-bundle.mjs` 의 필수 항목에 반영한다. **검증 도구 주의**: 데스크톱 `npm run typecheck` 는 문서화된 대로 no-op 이라(GAP-INFRA-04) 이번 작업에서도 거짓 통과를 냈다 — `typecheck:strict` 로 다시 돌려 이 작업이 만든 타입 오류 7건(core 에 없는 `InputTelemetryState` 참조 5건 등)을 찾아 고쳤다. 현재 strict 기준 이 작업 파일들의 오류는 0건이다(main 13 / renderer 35 는 전부 선재). |
|
||||
| GAP-INPUT-07 | Input intelligence | `[~]` **2026-09-23 focused automated evidence:** five test files / 80 tests passed; desktop typecheck/lint, Python `py_compile`, and `git diff --check` exited 0 (the core 131-test pass is earlier independent evidence). The overlay lifecycle and `windowsHide:true` child-process audit are code/automation evidence only, not Electron GUI or external-app insertion proof. | `InputTelemetryService.ts`, `SuggestionService.ts`, `KeyBindingService.ts`, `components/input-insights/{InputConsentPanel,InputInsightsView}.tsx`, `popups/suggestion-overlay/`, `tests/main/services/{input-flow-domain,input-flow-services,windows-child-process-hide}.test.ts` | From an external terminal restart with `run-desktop.bat`, verify: (1) click X during generation closes immediately and never reappears; (2) selecting text closes the overlay; (3) input-focus loss closes it; (4) TTS, voice action, audio enumeration, screen context and file transcription do not revive a cmd/PowerShell window. Retain the existing editable/read-unavailable/password, Flow Radar/Edit Friction/App Quality, receipt, Smart Exclusion, provenance/fallback, shortcut-audit and narrow-geometry checks. Automated tests do **not** replace this manual proof. |
|
||||
| GAP-INPUT-02 | Input intelligence | **IME 조합 중 텍스트(preedit)는 수집되지 않는다.** 우리는 조합 중에는 통계·제안을 모두 억제하고 조합이 끝난 커밋 텍스트만 UIA 로 읽는다. 조합 문자열 자체를 읽으려면 `IUIAutomationTextEditPattern::GetActiveComposition`(또는 레거시 앱은 IME `ImmGetCompositionStringW`)이 필요하다. KeyType.Windows 도 이 부분을 명시적으로 다음 사이클로 미룬다 — 즉 업계 공통 미해결 지점이다. 조합 중 억제 자체는 MS Learn 의 IME 문서상 필수 조치이며 구현돼 있다. | `apps/desktop/sidecar/uia_bridge.py`(`_caret_rect_and_offset` 의 TextEditPattern 블록), `packages/core/src/input-intelligence.ts`(`decideSuggestion` 의 `composing` 분기) | 조합 범위를 읽어 "조합 중 미리보기"를 제안 후보로 쓸지 검토한다. 지금은 억제만 하고 있어 한국어 사용자는 조합을 끝내야 제안이 뜬다. |
|
||||
| GAP-INPUT-03 | Input intelligence | **공백이 없는 언어(중국어)는 단어 수가 과소 집계된다.** `countWords` 가 공백 분리 토큰을 세므로 "今天开会讨论了三件事" 는 1단어로 계산된다. 한국어/영어/일본어(공백 사용)는 정상이다. | `packages/core/src/input-intelligence.ts`(`countWords`), 카탈로그 INPUT-03, 테스트 `input-intelligence.test.ts` | CJK 연속 구간을 문자 단위로 세는 분기를 추가하거나, 통계 라벨을 "단어" 대신 "어절"로 바꾼다. |
|
||||
| GAP-INPUT-03 | Input intelligence | **공백이 없는 언어(중국어)는 단어 수가 과소 집계된다.** `countWords` 가 공백 분리 토큰을 세므로 "今天开会讨论了三件事" 는 1단어로 계산된다. 한국어/영어/일본어(공백 사용)는 정상이다. | `packages/core/src/input-intelligence.ts`(`countWords`), `packages/core/src/text-segmentation.ts`(`countLexicalWords`), `apps/desktop/tests/main/services/input-intelligence.test.ts` | `[x]` 2026-10-30: `countWords`가 `countLexicalWords`(`Intl.Segmenter` 단어 분절 + CJK 폴백)를 호출하도록 수정해 중국어·일본어·태국어 무공백 문장의 단어 수를 정확히 집계한다 (`input-intelligence.test.ts` 68/68 통과). |
|
||||
| GAP-INPUT-04 | Input intelligence | **UIA 브리지가 Windows 전용이다.** `uiautomation` 은 Windows UI Automation 래퍼이므로 macOS 는 AX API, Linux 는 AT-SPI 구현이 따로 필요하다. 그래서 입력 인텔리전스는 카탈로그에서 데스크톱(`D`)만 표기하고 나머지 표면은 `[-]` 다. 또한 Chromium 138 미만 앱은 접근성 트리가 켜져 있으면 입력창 텍스트를 노출하지 않는데, 그 앱들을 `--force-renderer-accessibility` 로 켜도록 강제할 방법이 없다(우리 자신은 `app.setAccessibilitySupportEnabled(true)` 로 처리했다 — `bootstrap.ts`). | `apps/desktop/sidecar/uia_bridge.py`, `apps/desktop/src/main/bootstrap.ts`(`initInputIntelligence`) | macOS AX 경로를 붙일지 결정한다. 붙이지 않으면 카탈로그에서 macOS 를 명시적 N/A 로 유지한다. |
|
||||
| GAP-INPUT-05 | Input intelligence | **수락/닫기 키가 사용자 습관과 충돌할 수 있다.** 기본값을 `Alt+Shift+←/↓/↑` 로 둔 이유는 Tab·Escape·Ctrl+Space 같은 관례 키를 뺏지 않기 위해서다(우리는 키를 삼키지 않으므로 원래 동작이 함께 실행된다). 그 대가는 "Tab 으로 수락" 같은 자연스러운 조작이 아니라는 점이고, 인라인 컴플리션 도구 대부분(Tab)과 다르다. | `packages/core/src/keybinding.ts`(`suggestion-accept`/`next`/`dismiss`), `apps/desktop/src/main/bootstrap.ts`(트리거 구독) | 오버레이가 보일 때만 Tab 을 삼키는 경로(전역 후킹에서 조건부 suppress)를 검토한다. 지금은 불가능하지 않지만 포커스 없는 창에서 키를 가로채는 설계가 필요하다. |
|
||||
| GAP-LLM-03 | LLM | `[x]` **2026-09-22 코드 구현 완료.** 공유 `_abortController`를 요청별 controller로 대체하고 외부 signal을 각 요청에 연결/정리한다. generate/stream은 2048 tokens / 120 s, chat은 512 / 60 s로 제한하며, stream은 `done` frame 없이는 성공 처리하지 않고 불완전 응답을 정리한다. VoiceConversation은 single-flight와 request signal을 통해 local cancel을 실제 chat 취소로 전달한다. | `apps/desktop/src/main/services/LocalLLMService.ts`, `VoiceConversationService.ts` | 독립 표적 검증: 6 test files / 69 tests passed / 0 failed. 변경 코드·테스트 ESLint exit 0, `git diff --check` exit 0. 이는 전체 strict typecheck 또는 GUI 검증이 아니다. 앱 재시작 뒤 동시 제안·음성 요청의 요청별 취소와 `done` 누락 실패 처리는 GAP-LLM-04에서 계속 확인한다. |
|
||||
|
|
@ -107,7 +107,8 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
|
|||
| GAP-INPUT-06 | Input intelligence | `[~]` **제안 폭주 상한 및 runtime 확인.** 이전 24.7 s / 4.9 s, boot warmup, `keep_alive: 30m`, 48/96/128 tokens 및 2/5 candidates 기록은 역사적 가설/완화 이력이며 현재 정책이 아니다. 현 정책은 600 ms debounce, 5 s minimum interval, 6 requests/min default (hard max 12), 3 candidates, 64 output tokens, 12-character growth, 8 s timeout, `keep_alive: 2m` 및 boot warmup 제거다. | `apps/desktop/src/main/services/SuggestionService.ts`, `packages/core/src/input-intelligence.ts`, `LocalLLMService.ts` | 표적 자동 검증은 6 files / 69 passed / 0 failed이며 raw Ollama의 15.044 s cold timeout cleanup, 약 119.9 s residency expiry, 그리고 19:48:59 +09:00에 새 generate/unload/kill/retry 없이 확인한 `/api/ps` HTTP 200 / 45.8 ms / `{models:[]}` (`/api/version` HTTP 200 / 7.3 ms / `0.32.13`)도 확인됐다. 전체 strict typecheck는 green이 아니며, 이 raw API unload 증거는 앱 재시작·GUI·실제 자동제안 타이핑 검증이 아니다. 그 경로에서 rate limit, 8 s abort, 3-candidate/64-token 상한을 확인한다. |
|
||||
| GAP-INPUT-08 | Input intelligence | `[x]` **오타 자동 교정(INPUT-19) 일반 앱(8/8) + 터미널·Vim(6/6) 실앱 E2E 검증 및 xterm.js(`Agent Switchboard`) 재교정 루프 수정 완료 (2026-10-27); 문맥 제안(INPUT-20)은 GAP-INPUT-09 에서 추적.** 2026-10-26 에 `packages/core/src/araso-layout.ts` 및 `typo-correction.ts` 로 한영 혼합어(`githubdp`→`github에`, `PDFvkdlf`→`PDF파일`, `ㅖㅇㄹ파일`→`PDF파일`, `Reactzjavhsjsxm`→`React컴포넌트`), 쌍자음 잔여 Shift(`djEJs`→`어떤`, `qkRNjTdj`→`바꿨어`), 한→영 역변환(`ㅎ샤ㅗㅕㅠ에`→`github에`, `ㅑㄹ ㅑ 쇼ㅔㄷ ㅗ디ㅣㅐ 소두 ㅑㅅ 초뭏ㄷㄴ ㅑㅜ 10 ㄴㄷ채ㅜㅇㄴ`→`if I type hello then it changes in 10 seconds`), 문장 문맥 한영 전환(`Stay hungry, stay foolishsms wkqtmdml akfdlek.`), URL/경로 보호를 추가하고, 통계 수집 동의(`inputTelemetryEnabled`) 없이도 기본 기능으로 동작하도록 배선했다. 이어서 실제 Windows 인터랙티브 데스크톱(`WinSta0\Default`)에서 WinForms 테스트 창(`E2ETestBox.exe`)과 실행 중인 `D3RO Voice` 로 실제 `SendInput` 키 입력 E2E 를 수행해 4가지 실환경 결함을 잡고 검증했다: (1) `.bat` 래퍼(`cmd.exe` CUI)로 띄울 때 `uiohook` 이 인터랙티브 키 이벤트를 받지 못하던 문제를 `electron.exe` GUI 직접 실행으로 해결, (2) `_watchRevert` 가 새 문장에서 같은 오타(`ㅗ디ㅣㅐ`)를 다시 쳤을 때 되돌림으로 오인해 `typoIgnoredWords` 에 영구 등록하던 결함을 `prefixBefore`/`windowHandle`/낱자 차단으로 해결, (3) 한글 IME 상태에서 `ㅖㅇㄹ파일`(Shift+PDF + 파일) 입력 시 `PDF파일` 변환 추가, (4) `Ctrl+V` 클립보드 붙여넣기가 Windows `ClipboardSvcGroup`(`WM_CLIPBOARDUPDATE`)의 `OpenClipboard` 잠금과 충돌해 간헐적으로 누락되던 결함을 `SendInput(KEYEVENTF_UNICODE)` 직접 유니코드 타이핑(`apps/desktop/src/main/utils/win32-unicode-input.ts`)으로 해결. **2026-10-27 터미널·Vim·xterm.js 지원 확장 및 라이브 E2E 검증:** (5) Windows Terminal 등 모든 터미널·개발 표면에서 일반 철자/모델 교정만 막고 한영 자판 전환(`layoutOnly: true`)은 허용, (6) `uia_bridge.py` 가 터미널 스크롤백 상단 대신 `GetVisibleRanges()` 하단 뷰포트를 읽고 `ExpandToEnclosingUnit(waitTime=0)` 으로 500ms 지연을 제거, (7) `TerminalKeystrokeTracker` + `extractTerminalActiveContext` + `isForegroundKoreanIme` 로 다중 줄 Vim 버퍼(`-- INSERT --` 상단 줄 편집)·캔버스 터미널(`len=0`)·Vim 노멀 모드 교정 차단·명령줄 모드(`:ㅈㅂ`→`:wq`, `:ㅂ!`→`:q!`)·입력 모드 진입 키(`i/a/o/s`) 분리를 구현, (8) `Agent Switchboard` 등의 xterm.js `<textarea class="xterm-helper-textarea">` 가 Enter/Ctrl+C 전까지 `.value` 를 비우지 않아 `ㅗ디ㅣㅐ재깅 `→`hello재깅 ` 교정 시 400ms 마다 `'h'` 가 누적되던 문제를 `isXtermHelperControl` + `reconcileWithXtermValue` + `재깅`→`world` + 교정 성공 후 `_lastCheckedRegion` 보존 + 프로그램 키 `_lastKeyAt` 미갱신으로 해결, (9) 채팅창 Enter 전송 직후 툴바 문구(`"탭 추가 @ 기호"`)에 제안이 뜨고 `gemma4:e4b` 가 프롬프트 지시문(`"검색어입니다."`, `"키워드 몇 개로만 짧게 이어 쓰세요."`)을 되풀이하던 문제를 `clearedByEnter` 기준선 재설정 + `INSTRUCTION_ECHO_PATTERN` 확장으로 해결. | `apps/desktop/src/main/services/{TypoCorrectionService,TextInsertService,InputTelemetryService}.ts`, `apps/desktop/src/main/utils/{win32-unicode-input,win32-foreground}.ts`, `apps/desktop/sidecar/uia_bridge.py`, `packages/core/src/{araso-layout,typo-correction,terminal-prompt,suggestion-text}.ts` | `[x]` 2026-10-26 일반 앱 GUI E2E(`E2ETestBox.exe`, 8/8 시나리오 전수 통과, 91~509ms) + **2026-10-27 터미널·Vim GUI E2E(`neovide.exe` PID + `D3RO Voice` PID 90844, 6/6 시나리오 전수 통과):** Vim INSERT 모드 `dkssudgktpdy `→`안녕하세요 `(197ms), Vim 명령줄 `:ㅈㅂ`→`:wq`(215ms, `:` 보존), Vim 명령줄 `:ㅂ!`→`:q!`(90ms), 셸 프롬프트 `PS D:\workspace> 퍄ㅡ `→`vim `(106ms), 셸 프롬프트 `PS D:\workspace> ㅎ샤 채ㅜㄴㅅ `→`git const `(170ms), 캔버스 터미널(`UIA len=0`) `<Esc>idkssudgktpdy `→`안녕하세요 `(108ms). 단위 테스트: `packages/core` 3개 파일 82/82 통과(`typo-correction.test.ts` 44/44, `terminal-prompt.test.ts` 12/12, `suggestion-continuation.test.ts` 26/26), 데스크톱 `TypoCorrectionService.test.ts` 22/22 통과. |
|
||||
| GAP-INPUT-09 | Input intelligence | `[~]` **prefill 이어 쓰기·문서/대화 문맥(INPUT-21) 실앱 확인 (2026-10-03).** 실제 `gemma4:e4b` 프로브 15개 시나리오와 단위 테스트는 통과했지만, (a) 외부 앱 UIA 가 커서 앞 문서 전체를 주는지(케어렛 미상 앱은 tail 폴백), (b) 채팅 앱이 보내기 뒤 입력칸을 실제로 비우는 스냅샷을 내는지(카톡은 UIA 텍스트 길이 0 인 경우가 있었다 — GAP-INPUT-01), (c) 단어 중간 수락(`attach`)이 실제 삽입에서 공백 없이 붙는지는 GUI 로 확인하지 않았다. 후보 다양성: 마저 쓰기 모드는 prefill 분포가 뾰족해 채우기 후보가 1~2개에서 멈출 때가 많다. | `apps/desktop/src/main/services/{SuggestionService,InputTelemetryService,LocalLLMService,llm-prompts}.ts`, `packages/core/src/{chat-template,recent-writes,suggestion-text,writing-context}.ts`, `apps/desktop/tests/integration/suggestion-quality.ollama.test.ts` | `run-desktop.bat` 재시작 후: (1) 긴 메모장 문서 끝에서 앞부분의 날짜·이름을 이어 받는지, (2) 슬랙/디스코드 같은 Chromium 채팅에서 메시지를 보낸 뒤 다음 메시지 제안이 앞 메시지를 이어 받는지(로그 `제안 판단 입력` + 프롬프트 길이), (3) `내일 3시에 회의실` 같은 단어 중간에서 수락하면 `회의실에서…` 로 붙는지, (4) 지어낸 사실로 후보를 버린 로그(`제안 후보 버림 (unsupported-facts…)`)가 과하게 잦지 않은지. 모델 교체 시 `D3RO_SUGGESTION_PROBE=1 D3RO_SUGGESTION_PROBE_MODEL=<태그>` 로 같은 프로브를 다시 돌린다. **2026-10-03 19:00 "제안 창이 잘 안 뜸" 로그 분석**: 보류 1위 WindowsTerminal(Claude Code) `caret-unknown` 721회 — 입력 상자 아래 상태줄 때문에 화면 전체 기준으로 매번 "문서 중간 편집" 판정 → `SuggestionService._terminalContext` 가 입력 줄 연속성(늘거나 줄면 커서=끝)으로 판단. 2위 Chrome `not-typing` 122회 — 타이핑 중 UIA 포커스가 입력칸↔legacy 요소를 오가며 기준선을 다시 잡음 → 같은 창·클릭 없이 치는 중의 깜빡임이면 편집한 칸 유지(`input-telemetry-focus-flicker.test.ts`). 모든 앱에서 caret 오프셋을 못 얻는 것(caret=-1)과 Kitedesk/Candy/Paca 의 legacy(읽기 불가)는 별도 과제. 19:10 재시작 뒤 6분간 첫 후보 10회 생성(터미널 caret-unknown 721→4). **수락 키 전달 문제**: uiohook 은 키를 엿듣기만 해서 Ctrl+Alt+Enter 가 Claude Code 에도 전달돼 개행이 들어갔다 → 제안 창이 떠 있는 동안만 제안 단축키를 globalShortcut(noop)으로 잡아 OS 가 삼키게 하고 창이 사라지면 해제(`KeyBindingService.setSuggestionCaptureActive`, `suggestionCaptureAccelerators`). 실앱에서 수락 시 개행이 더는 안 들어가는지, 창이 없을 때 다른 앱의 Ctrl+Alt+Enter/↑↓ 가 정상인지 확인 필요. |
|
||||
| GAP-INPUT-10 | Input intelligence | `[~]` **제안 창 오타 교정·반응성(INPUT-22) 실앱 확인 (2026-10-17).** 단위 테스트·실모델 프로브·팝업 렌더 스크린샷은 통과, HEAD 로컬 빌드를 띄워 둠(설치본 v1.9.0 종료). 실제 앱에서 교정 수락(백스페이스 N + 붙여넣기)과 조합 중 Space 확정이 정확히 동작하는지는 미확인. 사용자 입력에 섞여 들어간 홀로 남은 `ㅇ`(이력 DB 접두에 반복)의 출처 — 사용자가 친 것인지, 조합이 깨진 흔적인지 — 미확정. | `apps/desktop/src/main/services/{SuggestionService,TypoCorrectionService,TextInsertService,InputTelemetryService}.ts`, `apps/desktop/src/renderer/popups/suggestion-overlay/*`, `packages/core/src/typo-correction.ts` | 에이전트 창·카톡·크롬에서: (1) `안ㄴ뇽하세여.?` 치고 멈추면 `오타 고침` 줄과 함께 후보가 뜨는지, 수락하면 오타가 지워지고 `안녕하세요.? …` 로 바뀌는지, (2) 마지막 글자가 조합 중일 때 수락해도 글자가 남거나 더 지워지지 않는지, (3) 수락 → Space → 멈춤에서 다음 제안이 바로 뜨는지(`rate-limited` 로그 없어야 함), (4) 후보 12개가 다 차도 창이 저절로 닫히지 않는지(45초 TTL 전), (5) 낱자 없는 오타는 첫 후보 뒤 교정 줄이 늦게 붙는지. **2026-10-20 정적 분석**: (2)는 사이드카가 TextEditPattern 을 지원하는 창에서만 조합 여부를 알아내(`sidecar/uia_bridge.py` GetActiveComposition) Chrome·Electron 계열은 늘 composing=false — 마지막 글자가 조합 중이면 Space 확정 없이 백스페이스 N 이 나가고 MS IME 가 낱자 단위로 지워 `안ㄴ안녕…` 처럼 원문이 남을 수 있다. 크롬에서 우선 재현. 교정 뒤 공백만 바뀌면 교정이 버려지던 문제는 32cf826 에서 수정. |
|
||||
| GAP-INPUT-11 | Input responsiveness | `[~]` **2026-10-30 사용자 보고: 모델 최초 로드/높은 CPU 부하에서 한글 타이핑 누락 (`안녕하세요` → `안세요`).** (1) **결정적 원인 규명 및 수정:** 한국어 두벌식 입력에서 받침 뒤 다음 음절 초성을 치는 순간(`"안ㄴ"`, `"안녕ㅎ"`, `"한ㄱ"` 등) `detectJamoNoise`가 커서 끝 초성을 낱자 잡음(`from: "안ㄴ", to: "안"`, `deleteCount: 2`)으로 오판하고, 모델이 아직 콜드(`warmModel() === null`, 모델 최초 로드 시점)일 때 `TypoCorrectionService.handleTypingContext`가 650ms 모델 디바운스를 건너뛰고 즉시 `replaceBeforeCaret(2, "안")`을 실행해 방금 완성된 `"안녕"`을 `"안"`으로 덮어써 `"안녕하세요"`가 `"안세요"`가 되거나 새 어절 첫 자음(`"오늘 ㅇ"`)이 백스페이스로 지워지던 버그를 수정했다(`packages/core/src/typo-correction.ts` 커서 끝 초성 보호 + `TypoCorrectionService.ts` 커서 직전 토큰 자동 삭제 차단). (2) 코드에서 오래된 UIA 문맥·삽입 큐 대기 후 재검증 누락·부분 SendInput 성공 뒤 삭제 재실행 위험을 확인하고 보호 장치를 추가했으며, 로컬 Ollama/Whisper 작업 수도 최대 4개로 제한했다. (3) `win32-foreground.ts`에서 프로세스 이미지 경로 캐시(최대 256 PID)와 `isForegroundKoreanIme` 캐시(400ms TTL, 타임아웃 30ms→8ms 단축)를 적용하고, `uia_bridge.py`에서 `_wake_chromium_accessibility`의 동기 `WM_GETOBJECT` 호출을 HWND별 60초 TTL로 캐시하며, `InputTelemetryService._sampleWhileTyping`이 키 입력 직후 350ms 이내에는 중복 폴링을 건너뛰도록 최적화했다. **추가 deterministic A/B:** 3개 서비스만 HEAD `f49acf0`로 대체하고 나머지 의존성·테스트는 현재 상태를 유지한 비교에서 HEAD 1/17, 수정본 17/17 통과. | `packages/core/src/typo-correction.ts`, `InputTelemetryService.ts`, `TypoCorrectionService.ts`, `TextInsertService.ts`, `utils/{win32-foreground,win32-input-activity,win32-unicode-input,inference-cpu-budget}.ts`, `sidecar/{uia_bridge,cpu_budget}.py`; `scripts/verification/typing-race-proof.mjs`, `packages/core/__tests__/typo-correction.test.ts` (53/53), `TypoCorrectionService.test.ts` (28/28) | `typing-fixture`와 별도 로컬 프로필의 `typing-runtime` 빌드 완료, 단위·경합 A/B 테스트 전수 통과(`packages/core` 566/566, `TypoCorrectionService.test.ts` 28/28, `typing-race-proof.mjs` 17/17). 남은 것은 외부 인터랙티브 세션에서 실제 GUI 연속 타이핑 수동 확인이다. |
|
||||
| GAP-INPUT-10 | Input intelligence | `[~]` **제안 창 오타 교정·반응성(INPUT-22) 실앱 확인 (2026-10-17) 및 2026-10-30 조합 백스페이스/초성 유실 수정.** 단위 테스트·실모델 프로브·팝업 렌더 스크린샷은 통과. (1) 이력 DB 접두에 반복되던 홀로 남은 `ㅇ` 및 글자 삼킴은 커서 끝 초성(`"안ㄴ"`, `"오늘 ㅇ"`)에 대한 `detectJamoNoise` 조기 개입이 원인이었음을 규명해 차단했다(GAP-INPUT-11 참조). (2) Chrome·Electron 계열에서 UIA `GetActiveComposition` 미지원으로 `snapshot.isComposing`이 항상 `false`가 되어 마지막 글자 조합 중 교정/제안 수락 시 Space 확정 없이 백스페이스가 나가 MS IME가 자모 단위로 지우던(`안ㄴ안녕…`) 문제를 해결하기 위해, `InputTelemetryService`에서 키스트로크 기반 한글 조합 상태(`_imeComposing`)를 추적해 `context.isComposing`에 반영하고, `SuggestionService.accept()`도 `/[가-힣]$/u.test(acceptPrefix)` 및 `insertMethod === 'keyboard'` 프로그램 키 계산을 정밀화했다. | `apps/desktop/src/main/services/{SuggestionService,TypoCorrectionService,TextInsertService,InputTelemetryService}.ts`, `apps/desktop/src/renderer/popups/suggestion-overlay/*`, `packages/core/src/typo-correction.ts` | 에이전트 창·카톡·크롬에서: (1) `안ㄴ뇽하세여.?` 치고 멈추면 `오타 고침` 줄과 함께 후보가 뜨는지, 수락하면 오타가 지워지고 `안녕하세요.? …` 로 바뀌는지, (2) 마지막 글자가 조합 중일 때 수락해도 글자가 남거나 더 지워지지 않는지, (3) 수락 → Space → 멈춤에서 다음 제안이 바로 뜨는지(`rate-limited` 로그 없어야 함), (4) 후보 12개가 다 차도 창이 저절로 닫히지 않는지(45초 TTL 전), (5) 낱자 없는 오타는 첫 후보 뒤 교정 줄이 늦게 붙는지 실앱 수동 확인. |
|
||||
|
||||
| GAP-SYNC-01 | Sync | Desktop↔mobile sync was one-way and lossy. (1) `pushAll` set the cursor to *now* before `pullAll` ran, so the first pull after sign-in fetched nothing — mobile-created data never reached the desktop except via Realtime while running (which never connected, GAP-SYNC-02). (2) `_inArray` used only the first meeting id, so memos/documents of every other meeting were never pushed. (3) No deletion propagation either way. (4) Pull had no `user_id` filter — team meetings of other users landed in the personal DB and a desktop re-push cleared `team_id`. (5) One global, local-clock cursor across accounts; no pagination (1,000-row cap). (6) Desktop writes did not move `history.revision`, so mobile's optimistic concurrency silently overwrote desktop edits. (7) One case-duplicate dictionary word failed the whole batch. (8) Memo tags, custom commands, templates, favorites and history titles were not synced at all; anonymous local-mode data was never uploaded after sign-in. | `apps/desktop/src/main/services/sync/*`, `CloudSyncService.ts`, `server/supabase/migrations/20260927000034_cross_device_sync_parity.sql` | `[x]` 2026-09-27: engine rewritten (outbox + per-user server-clock keyset cursors + tombstones + per-row isolation + dictionary adoption + natural-key memo tags + client-keyed template RPCs + local-mode import). Evidence: `apps/desktop/tests/main/sync/SyncEngine.test.ts` (20) + `apps/desktop/tests/integration/cross-device-sync.supabase.test.ts` (5, local Supabase stack); full desktop suite 1499/1500 (1 = known caption env timeout); SQL checks for revision bump, tombstones, account-delete cascade. |
|
||||
| GAP-SYNC-02 | Sync | **Desktop Realtime never connected.** Electron 33 main (Node 20.18) has no global `WebSocket`; supabase-js Realtime only ever logged `TIMED_OUT`/`CLOSED` (installed-app log 2026-09-16) and gave up after three retries. Also: filtered `postgres_changes` channels never deliver DELETE (Supabase limitation). | `CloudSyncService.ts`, `services/sync/realtime-transport.ts`, integration test "Realtime" case | `[x]` 2026-09-27: `ws` injected as the Realtime transport (`ws` now a declared desktop dependency, externalised in the main bundle); deletions arrive as `sync_tombstones` INSERT events; the heartbeat re-subscribes a channel that is not `joined`. Verified live against the local stack (INSERT/UPDATE + tombstone events received). |
|
||||
|
|
@ -117,7 +118,7 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res
|
|||
| 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-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/`, Management API `schema_migrations`, `functions` list | `[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. Next: add a CI check that compares `supabase migration list --linked` with the repo so production cannot silently lag again. |
|
||||
| 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-10-30:** `scripts/ci/check-supabase-migrations.mjs` (`npm run check:migrations:test`, 73 migrations + self-test PASS) added to enforce migration ordering, naming, and optional linked remote drift detection. |
|
||||
| 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). |
|
||||
---
|
||||
|
||||
|
|
@ -132,7 +133,7 @@ These are the mobile SSOT rows still `[ ]` / `[~]`. Do not duplicate the full te
|
|||
| O (onboarding/a11y) | O-001..O-007, O-009, O-011; O-008/O-010/O-012 `[~]` | Onboarding branches, permissions, tutorial; app-wide theme coverage, TalkBack/font-scale/rotation; full-app ko/en audit |
|
||||
| D (data/sync/offline) | D-001..D-014 | Schema/RLS, devices, cross-surface read/write, offline queue, conflict policy |
|
||||
| R (record/transcribe) | R-001..R-009, R-011..R-015, R-017..R-020; R-016 `[x]` | Permissions, recorder, FGS, upload queue, job state, sharing |
|
||||
| H (history/meetings) | H-001..H-005, H-007..H-015; H-016 `[~]`; H-006 `[x]` | Pagination, filters, detail, meeting timeline/docs/diarization/cross-app; unified-search query/cancellation/performance gaps |
|
||||
| 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 |
|
||||
| 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 |
|
||||
|
|
@ -166,7 +167,7 @@ These are the mobile SSOT rows still `[ ]` / `[~]`. Do not duplicate the full te
|
|||
|
||||
| ID | Item | Note |
|
||||
|---|---|---|
|
||||
| DOC-01 | `CLAUDE.md` describes only Phase 1-15.5 desktop; does not mention web/mobile/admin/api-server. | This map supersedes it for IA; consider trimming CLAUDE.md to rules + map pointer. |
|
||||
| DOC-01 | `[x]` 2026-10-30: `CLAUDE.md` updated to cover all monorepo surfaces (`apps/desktop`, `apps/web`, `apps/mobile-rn`, `apps/api-server`, `apps/admin`, `server/supabase`, `server/cloudflare-worker`, `site/`, `packages/*`) and point to `docs/map/00-index.md`. | Resolved. |
|
||||
| DOC-02 | `docs/design/*` reflects an older desktop-only architecture and contains known naming drift (`06-gap-analysis.md`). | Treat this map + code as current; design docs are historical. |
|
||||
| DOC-03 | `memory/project_status.md` is a chronological log, not current state. | Use `docs/map/*` for current state. |
|
||||
| DOC-04 | `docs/v2/00-v2-master-plan.md` targets Expo for mobile. | Actual mobile is RN CLI (`apps/mobile-rn`); the Expo app was removed 2026-09-13. v2 plan is historical. |
|
||||
|
|
@ -178,24 +179,20 @@ These are the mobile SSOT rows still `[ ]` / `[~]`. Do not duplicate the full te
|
|||
|
||||
- **Desktop local dictation / LLM / history / meetings / RAG / conversation:** local
|
||||
dictation works in dev **and** in packaged builds as of `1.3.0` (engine bundled, paths
|
||||
fixed, IPv4 loopback). Ads: one real adapter, rest stubs.
|
||||
fixed, IPv4 loopback). Ads: one real adapter, rest stubs; rewarded ads grant bonus quota via `LicenseService.grantRewardQuota` (GAP-ADS-02 `[x]`).
|
||||
- **Desktop LLM post-processing:** split the question. The **plain actions**
|
||||
(`refine`/`summarize`/`grammar`/`expand`, Settings → `defaultLLMAction`) always worked
|
||||
and are now regression-tested. The **custom-instruction path** — built-in presets,
|
||||
user commands, voice keyword commands, chains — **never worked in any shipped release**
|
||||
(`v0.1.0-alpha`..`v1.4.0`): it inserted the instruction's own wording instead of the
|
||||
result. Fixed 2026-09-21 in `9c2b4d4` with unit tests, but **not yet verified in a
|
||||
running app**, and the four related usecase test files could not execute (GAP-LLM-02,
|
||||
GAP-INFRA-06). Translate is still hardcoded to English (GAP-LLM-01).
|
||||
result. Fixed 2026-09-21 in `9c2b4d4` with unit tests, and usecase tests now run under Node ABI via `rebuild:test` (GAP-INFRA-06 `[x]`). Translate target language is user-configurable across 12 languages in `SettingsModal.tsx` (GAP-LLM-01 `[x]`).
|
||||
- **Desktop key bindings (CAP-16):** rewritten onto one SSOT with multiple bindings per
|
||||
action and mouse-button support; **verified on Windows** by a manual run on 2026-09-21
|
||||
(legacy migration, 6 actions loaded, keyboard + mouse hook live, multi-binding exercised
|
||||
— GAP-KEY-01 `[x]`). macOS/Linux mouse behavior is still unconfirmed (GAP-KEY-02) and
|
||||
the service has no unit test of its own.
|
||||
- **Web console:** yes, feature-complete for server-shared data; knowledge upload/search and team feed implemented.
|
||||
and unit-tested in `KeyBindingService.test.ts` (11/11) + `voice-intent.test.ts` (19/19) (GAP-KEY-01 `[x]`, GAP-KEY-03 `[x]`). macOS/Linux mouse behavior is still unconfirmed (GAP-KEY-02).
|
||||
- **Web console:** yes, feature-complete for server-shared data; knowledge upload/search, team feed, browser invite acceptance (`/app/accept-invite`), audio-transcript seek sync, and Web Push registration (`sw.js`) implemented.
|
||||
- **Mobile:** code complete for most flows and tested locally; blocked mainly by external store/console gates, plus a11y and some E2E depth.
|
||||
- **Backend:** fail-closed AI proxies, RLS, billing, ads SSV implemented; push transports (FCM + webpush + APNs) and cron drain implemented.
|
||||
- **Admin:** complete with deliberate "unavailable" states; support page is a stub.
|
||||
- **Admin:** complete with deliberate "unavailable" states; `/support` upgraded to a live `content_reports` & support management console (GAP-SHELL-01 `[x]`).
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -217,8 +214,8 @@ Actionable checklist for the work started this session. Fields to fill are blank
|
|||
- [ ] Verify end-to-end: enqueue a test event (e.g. team invite) → drain → delivery row `delivered`.
|
||||
|
||||
**Push — clients**
|
||||
- [ ] Web: add a service worker + `pushManager.subscribe`, store the JSON subscription as the registration id, register `provider: 'webpush'`. (GAP-PUSH-03)
|
||||
- [ ] iOS: register the APNs device token with `provider: 'apns'`. (GAP-PUSH-03)
|
||||
- [x] Web: add a service worker + `pushManager.subscribe`, store the JSON subscription as the registration id, register `provider: 'webpush'`. (GAP-PUSH-03 — `apps/web/public/sw.js` + `apps/web/src/lib/web-push.ts`)
|
||||
- [x] iOS: register the APNs device token with `provider: 'apns'`. (GAP-PUSH-03 — `apps/mobile-rn/src/features/notifications/notification-service.ts`)
|
||||
- [ ] Android: decide FCM vs UnifiedPush/ntfy. (GAP-PUSH-04)
|
||||
|
||||
**AdMob (Playwright tooling ready)**
|
||||
|
|
|
|||
|
|
@ -229,12 +229,12 @@
|
|||
- [ ] H-008 회의 종료와 전체 transcript 병합·처리 상태
|
||||
- [ ] H-009 요약·결정사항·액션 아이템·회의록 생성
|
||||
- [ ] H-010 transcript/summary/documents 탭 조회·편집·동시 수정 충돌
|
||||
- [ ] H-011 오디오 seek와 transcript timestamp 연동
|
||||
- [x] H-011 오디오 seek와 transcript timestamp 연동 — 2026-10-30: `MeetingDetailScreen.tsx` + `meetings-service.ts`에 오디오 플레이어 현재 재생 시각 기반 활성 세그먼트 하이라이트 및 세그먼트/인용(`[MM:SS]`) 탭 시 오디오 시크 연동 구현, `__tests__/meetings.test.ts` 통과
|
||||
- [ ] H-012 PDF/DOCX/TXT/Markdown 내보내기와 Android 공유
|
||||
- [ ] H-013 회의 목록 search/filter/sort/delete/share
|
||||
- [ ] H-014 화자 구분 상태·화자명 편집·미지원 fallback
|
||||
- [ ] H-015 Web↔모바일 동일 회의 교차 편집 E2E
|
||||
- [~] H-016 홈 기록+회의 통합 검색 — 사용자 범위 history/meetings 병렬 조회, 입력 정규화·최신순 merge·record/meeting 상세 이동 service/row Jest와 320dp dark·411dp light runtime GREEN. 별도 transcript segment 미검색, 모바일 raw-text 과전송·실행 요청 미취소, FTS/index·대규모 성능 미검증 때문에 부분 완료
|
||||
- [x] H-016 홈 기록+회의 통합 검색 — 2026-10-30: `unified-search-service.ts` + `UnifiedSearchScreen.tsx`에 `AbortSignal`/검색 세대 토큰 취소, transcript segment 매칭, 필요한 컬럼/스니펫만 가져오는 경량 프로젝션을 구현해 `GAP-UX-05` 해소 (`__tests__/unified-search-service.test.ts` 통과)
|
||||
|
||||
### F — 데스크톱/Web 전체 기능의 모바일 화면
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue