docs(wave7): record peer-swarm bug fixes, metrics, and map sync
Some checks failed
ci / 정본·보안·린트·타입·테스트 (push) Failing after 18s
ci / 워크스페이스 빌드 검증 (push) Has been skipped
ci / 모바일 린트·타입·Jest (push) Successful in 45s
ci / Supabase Edge Functions + Cloudflare Worker (push) Successful in 22s
ci / .NET API 서버 테스트 (push) Successful in 11s
deploy-site / deploy (push) Successful in 44s
Some checks failed
ci / 정본·보안·린트·타입·테스트 (push) Failing after 18s
ci / 워크스페이스 빌드 검증 (push) Has been skipped
ci / 모바일 린트·타입·Jest (push) Successful in 45s
ci / Supabase Edge Functions + Cloudflare Worker (push) Successful in 22s
ci / .NET API 서버 테스트 (push) Successful in 11s
deploy-site / deploy (push) Successful in 44s
This commit is contained in:
parent
cc3f7460be
commit
876e72ea2f
15 changed files with 173 additions and 21 deletions
|
|
@ -1,6 +1,6 @@
|
|||
# D3RO-VOICE 리팩토링 정책 (SSOT)
|
||||
|
||||
> 마지막 갱신: 2026-11-14 — Wave 6 전 표면 코드 위생 · 최적화 · 버그 헌팅 정책 보완
|
||||
> 마지막 갱신: 2026-11-14 — Wave 7 6-세션 네이티브 피어 스웜(`swarm`) 정책 및 검증 기준 보완
|
||||
> 적용 범위: `apps/*` + `packages/*` + `server/*` + `site/` + 빌드·배포 스크립트 (기능 변경은 별도 요청)
|
||||
|
||||
## 0. 전제: 기존 3계층 규칙 SSOT와의 관계
|
||||
|
|
@ -162,3 +162,9 @@ DRY 원칙 보강: Deno처럼 정본을 직접 import할 수 없는 런타임은
|
|||
- 파일 소유 경계가 겹치지 않는 4개 워크스트림(`WS1` desktop main/sidecar, `WS2` shared packages + desktop renderer/popups, `WS3` mobile-rn, `WS4` web/admin/site/Edge/Cloudflare/.NET)을 병렬 실행한다.
|
||||
- 중복 제거(SSOT 통합)와 리소스/메모리 최적화 및 동시성/보안 버그 수정을 함께 수행하되, Deno 계약(`contract:check`), API/IPC 시그니처, 도메인 오류 클래스·코드, fail-closed 동작, 보호 테스트, 런타임 `[~]`/`[!]` 상태 경계를 보존한다.
|
||||
- 통합 후 `npm run verify:all`, `contract:check`, `check:migrations`, `version:check`, `security:secrets`, `dotnet test`, sidecar Python `unittest`, Edge + Worker Deno 테스트, `npm run build` + `check:desktop-renderer`, `test:metrics:write` 및 `docs/REFACTOR_WAVE6_REPORT.md` · `docs/map/*` 갱신을 완료한다.
|
||||
|
||||
## Wave 7 (2026-11-14) — 6-세션 네이티브 피어 스웜 (monitor · input-core · desktop-shell · mobile-app · cloud-surfaces · verifier)
|
||||
|
||||
- Antigravity 네이티브 `swarm` (`share` 워크트리)으로 4개 구현 워커(`input-core`, `desktop-shell`, `mobile-app`, `cloud-surfaces`), 모니터링 워커(`monitor`), 전담 피어 리뷰어(`verifier`)를 구성하고 `@mention`/`#seq` 보드 프로토콜로 교차 검증한다.
|
||||
- `@verifier`가 보고한 결함은 각 워커가 동일 워크스페이스에서 델타 커밋으로 보완하고 재검증(`@coordinator [all-verified]`)을 통과한 커밋만 `main`에 체리픽한 뒤 워커를 종료한다(Windows에서 `swarm kill`로 `.bin` 또는 nested `node_modules` 심이 유실된 경우 통합 검증 전 `npm install --prefer-offline` / `npm --prefix apps/mobile-rn ci --prefer-offline` 및 `better_sqlite3.node` ABI 확인을 수행한다).
|
||||
- Batch 1(정적 게이트·`dotnet test`·Python `unittest`·Edge/Worker/Site Bridge Deno) + Batch 2(전 워크스페이스 `typecheck`/`lint`/`test`, `test:mobile`, `npm run build` + `check:desktop-renderer`, `test:metrics:write`) 통과 후 `docs/REFACTOR_WAVE7_REPORT.md`, `docs/map/*`, `docs/v3/MOBILE_APP_COMPLETION_SSOT.md`, `.claude/skills/refactor-wave/SKILL.md`를 동일 커밋으로 동기화한다(운영 배포 시점 이후 `main` 통합분과 라이브 배포 상태를 구분 표기).
|
||||
|
|
|
|||
110
docs/REFACTOR_WAVE7_REPORT.md
Normal file
110
docs/REFACTOR_WAVE7_REPORT.md
Normal file
|
|
@ -0,0 +1,110 @@
|
|||
# D3RO Voice — Wave 7 다중 세션 피어 스웜 코드 위생 · 최적화 · 버그 헌팅 보고서
|
||||
|
||||
> 일시: 2026-11-14
|
||||
> 대상 브랜치: `main` (기준 커밋 `a37dd63` -> 통합 커밋 `cc3f746`, 7 commits / 98 files `+7,170 / -597`)
|
||||
> 실행 토폴로지: Antigravity 네이티브 `swarm` 6개 세션 (`monitor`, `input-core`, `desktop-shell`, `mobile-app`, `cloud-surfaces`, `verifier`) + `@mention`/`#seq` 피어 리뷰 보드(`Run /swarm board (default shortcut alt+s) to open the live board.`)
|
||||
> 정책 SSOT: `docs/REFACTOR_POLICY.md`, `.claude/skills/refactor-wave/SKILL.md`
|
||||
|
||||
---
|
||||
|
||||
## 1. 운영 배포 경계와 Wave 7 범위
|
||||
|
||||
1. **운영 `v1.17.1` 기준선 (`6c6875b`, 태그 `v1.17.1`)**: 데스크톱(Forgejo `1.17.1/latest.yml`·`.sig`, `runtime-1.17.1`, `portable-1.17.1` HTTP `200`; Human Release #339 ~91MB 바이너리 첨부만 `GAP-REL-16` 예외), Supabase 운영 DB(74개 마이그레이션 동기화)·Edge Functions 24종, 랜딩 사이트(`site/` -> Cloudflare Pages `d3ro`, `https://d3ro.chanpaca.net/release-identity.json`), Cloudflare Worker(`d3ro-voice-api` `--keep-vars`, Version ID `fe6d9532-0052-48f5-b62c-45c86f6aaaa5`), NAS Docker 스택(`api-server` `:5050/health` `200`, `admin` `:3001` / `d3ro-admin.chanpaca.net/login` `200`, `web` `:3002/app/login` / `d3ro.chanpaca.net/app/login` `200`) 배포 완료 후 `a37dd63`에 기록됨.
|
||||
2. **Wave 7 반영 범위 (`2a009e4..cc3f746`)**: Wave 7 커밋은 **`v1.17.1` 배포 이후**에 `main`으로 통합·검증되었다. 따라서 Wave 7 수정사항은 현재 **`main` 통합 및 모노레포 전 게이트 검증 완료** 상태이며, `v1.17.1` 기배포 바이너리·컨테이너에는 포함되어 있지 않다(차기 릴리스 `v1.17.2` / `v1.18.0` 및 재배포 반영 대상).
|
||||
3. **Cloudflare Worker 운영 환경변수 경계**: Wave 7(`c68e81e`)이 `server/cloudflare-worker/wrangler.toml`의 `BACKEND_ORIGIN` 기본값을 `https://d3ro.chanpaca.net`으로 수정했으나, `v1.17.1` 배포 당시 `--keep-vars`로 유지된 라이브 Worker `d3ro-voice-api`(`fe6d9532-0052-48f5-b62c-45c86f6aaaa5`)에는 기존 대시보드 변수(`BACKEND_ORIGIN = "http://192.168.0.39:5050"`)가 남아 있어 라이브 `/health`는 Cloudflare Error `1003` (`HTTP 403`) 상태다.
|
||||
|
||||
---
|
||||
|
||||
## 2. 피어 리뷰(`@verifier`) 바운스 및 해소 이력
|
||||
|
||||
1. **#10 `desktop-shell` 바운스 -> `3f9e412` 해소 (`4 files, +103/-3`)**:
|
||||
- 문제: `LocalLLMService` `/api/pull` 중단 및 `LocalSTTService` 모델 다운로드 `dispose()` 중단 시 raw abort 오류가 `D3ROError`로 래핑되지 않아 계약과 불일치.
|
||||
- 수정: `LocalLLMService.ts`는 `D3ROError(ErrorCode.LLM_ERROR)`로, `LocalSTTService.ts`는 `D3ROError(ErrorCode.STTModelDownloadCancelled)`로 래핑하고 관련 단위 테스트 보강.
|
||||
2. **#11 `mobile-app` 바운스 -> `cc3f746` 해소 (`5 files, +376/-45`)**:
|
||||
- 문제: `durable-processing-queue.ts` cleanup 경로에서 큐 항목 제거와 오디오 파일 삭제 순서·실패 재시도 보장이 미흡했고, 다중 화면에서 계정 전환 후 `busy`/`running` 상태가 섞일 여지가 남아 있었음.
|
||||
- 수정: `finishCleanupItem(item)`으로 오디오 파일 먼저 삭제 후 큐 항목 제거(삭제 실패 시 60초 재시도 예약), 화면(`Commands`, `HistoryDetail`, `Home`, `Knowledge`, `Meetings`, `Record`, `Teams`)에 `scopeGenerationRef`와 `try/catch/finally` 가드 통일.
|
||||
3. **#17 `cloud-surfaces` 바운스 -> `4bf0f0d` 해소 (`7 files, +363/-106`)**:
|
||||
- 문제: `apps/web/src/components/chat/chat-panel.tsx` `executeChatSendTurn`과 `action-runner.tsx`, `payple-manage-button.tsx`, `generate-document-button.tsx`, `invite-member-form.tsx`에서 `createTimedAbortSignal` 타임아웃이 삼켜지거나 await 이후 언마운트(`shouldExitAfterAwait`) 판정이 일관되지 않았음.
|
||||
- 수정: `edge-fetch.ts` 계약 기준으로 타임아웃·abort·언마운트 가드를 전파하고 `security-and-lifecycle.test.ts` 회귀 보강.
|
||||
4. **최종 승인**: `@verifier` 재검증 후 `#21` `@coordinator [all-verified]` 수신 -> 전 커밋 `main` 체리픽(`0` 충돌) 및 커밋 메시지 위생 검증(`Co-Authored-By`/AI 문구 0건) 후 워커 종료(`#22`).
|
||||
|
||||
---
|
||||
|
||||
## 3. 워크스트림별 수정 내역
|
||||
|
||||
### 3.1 `input-core` (`2a009e4`, `8 files, +640/-53`) — 문장부호 직후 무공백 영타 오타 라이브 트리거 복구
|
||||
|
||||
실사용 중 보고된 `상황 잘 지켜보는중?dbrlgkrhdlTwlsdksgwl?`(기대 변환: `유기하고있진않지`)와 같은 **문장부호(`?`) 직후 공백 없이 이어진 영타·말줄임표 오타**가 라이브 파이프라인에서 누락되던 4가지 원인을 동시에 수정했다:
|
||||
|
||||
| 계층 | 파일 | 수정 내용 |
|
||||
|---|---|---|
|
||||
| Telemetry | `apps/desktop/src/main/services/InputTelemetryService.ts` | `TYPO_SETTLE_DELAY_MS` (`700ms`) / `_typoSettleTimer` 추가로 제안 기능 비활성·지연·접두사 임계치 미달 구간에서도 `>=650ms` settle 스냅샷 보장; `diffInsertionSpan()`으로 문장부호(`?`) 트리밍을 걸친 `_expectedInserts` 계산 정확화; 만료된 `_programmaticKeys` 정리 및 `_learnFlushTimer.unref()` |
|
||||
| Typo Service | `apps/desktop/src/main/services/TypoCorrectionService.ts` | 문장부호 경계 정규식(`~…?!。`) 확장; `trailingWordOnly` 패스에서 경계로 닫힌 단일 토큰을 최대 `MAX_INPLACE_DELETE_CHARS` (32)자까지 허용하고 `_markRegionChecked()` 영구 잠금 차단 |
|
||||
| Core Rules | `packages/core/src/araso-layout.ts`, `typo-correction.ts`, `personal-ngram.ts` | `isUrlOrPathRun()`으로 `domain.tld?` / `file.ext?`는 보호하되 한글+말줄임표(`[가-힣ㄱ-ㆎ][!?~]*\.{2,}$`) 변환 허용(`...props` 유지); `WORD_BOUNDARY_AFTER_RE` 정리; `PersonalNgramModel.next()` 불필요한 `Map` 복사 제거 |
|
||||
| Regression Tests | `apps/desktop/tests/main/services/typo-live-punctuation.test.ts`, `TypoCorrectionService.test.ts`, `packages/core/__tests__/typo-correction.test.ts` | 문장부호 뒤 한/영 무공백 전환, URL/코드 접두사 비변환, 재입력·트림 복원 회귀 테스트 추가 |
|
||||
|
||||
### 3.2 `desktop-shell` (`fc5d453` 19 files + `3f9e412` 4 files) — 메인 서비스 취소 · 해제 · 레이스 하드닝
|
||||
|
||||
- `apps/desktop/src/main/windows/WindowManager.ts`: `hideResultPopup()`에서 `pendingResultShow` 타이머를 취소하고 `lastResultCursor = null`로 초기화(`popup-hide-show-race.test.ts`).
|
||||
- `apps/desktop/src/main/services/CaptionService.ts`: `ensureAuxModel` 성공 뒤 `_captionModelId`를 기록하고 이전 `loadedAuxModelId`를 해제, `_stopPromise`로 동시 `stop()`/`dispose()` 중복 실행 차단, 호출 단위 `AbortController` + `_refineEpoch`/`_refineRunId` 리셋(`caption-lifecycle-refine.test.ts`, `caption-aux-release.test.ts`).
|
||||
- `apps/desktop/src/main/services/VoiceModeService.ts`, `llm/LlmGateway.ts`, `LocalLLMService.ts`: `run.controller.signal`을 `LocalLLMService.processText`까지 전파, `/api/pull` `AbortController` 등록 및 `dispose()` 시 리더·요청 중단 후 `D3ROError(ErrorCode.LLM_ERROR)` 래핑, dispose 이후 폴링 가용성 복원 차단(`local-llm-service.test.ts`, `llm-limits-routing-redteam-r2-1.test.ts`, `VoiceModeService.test.ts`).
|
||||
- `apps/desktop/src/main/services/{VoiceConversationService,AudioCaptureService,LocalSTTService}.ts` & `ipc/caption-handlers.ts`: abort 시 `_responseAbortController` 정리, stale 마이크 시작 catch 가드, SoX `'stopping'` 재개 확인 및 `start()` 실패 `_cleanup()`, `dispose()` 시 STT 모델 다운로드 fetch/sleep 중단 + `D3ROError(ErrorCode.STTModelDownloadCancelled)` 래핑, `desktopCapturer.getSources` fail-closed `callback({})`(`VoiceConversationService.test.ts`, `audio-capture-redteam-r2-7.test.ts`, `stt-sidecar-redteam-r2-6.test.ts`, `ipc-redteam-r3-1.test.ts`).
|
||||
|
||||
### 3.3 `mobile-app` (`bd3c1a9` 25 files + `cc3f746` 5 files) — 레코더 · 내구성 큐 · 컨텍스트 · 화면 비동기 가드
|
||||
|
||||
- 레코더 (`src/lib/audio-recorder.ts`, `src/lib/recorder/{nitro-backend,android-foreground-backend}.ts`): `pendingClaim` + `finally` 해제, `startGeneration`/`sessionGeneration` 세대 가드, `pollTimer` 누수 방지(`recorder-lifecycle-races.test.ts`).
|
||||
- 큐·히스토리 (`src/features/recording/durable-processing-queue.ts`, `src/features/history/use-history-sync.ts`): `running`/`cleanup` 가드, `suspendedUsers` 재시도 차단, `discardedItems` 재검사, `finishCleanupItem(item)`(오디오 파일 선삭제 -> 큐 항목 제거, 삭제 실패 시 60초 재시도), request-id/scope 가드(`queue-and-history-races.test.ts`).
|
||||
- 서비스·컨텍스트·화면: `chat-service.ts`, `admin-service.ts`, `device-service.ts`, `llm-stream-service.ts`, 4개 컨텍스트(`mobile-ads`, `billing`, `device`, `entitlement`), 7개 화면(`Commands`, `HistoryDetail`, `Home`, `Knowledge`, `Meetings`, `Record`, `Teams`)에 pre-abort 가드, 세대 헤더 불일치 시 `response.body` 취소, 계정 전환 상태 초기화 및 `scopeGenerationRef` + `try/catch/finally` 적용(`abort-and-stream-guards.test.ts`, `context-lifecycle-guards.test.tsx`, `screen-async-lifecycle.test.tsx`).
|
||||
|
||||
### 3.4 `cloud-surfaces` (`c68e81e` 46 files + `4bf0f0d` 7 files) — 엣지 게이트웨이 · .NET SSRF · Supabase · Web/Admin 보안
|
||||
|
||||
- **Cloudflare Worker & Site Bridge (`server/cloudflare-worker`, `server/cloudflare-site-bridge`)**: `wrangler.toml` `BACKEND_ORIGIN`을 `https://d3ro.chanpaca.net`으로 교정, `origin-policy.ts`로 비-HTTPS·사설 IP·내부 호스트·프록시 루프(`508`/`503`) 차단, `204`/`205`/`304` null-body 처리, `push-drain.ts` origin 검증; `cloudflare-site-bridge` `508` 루프 가드·경로 스머글링 `400`·`deno.json` 추가.
|
||||
- **.NET API (`apps/api-server`, `apps/api-server.Tests`)**: `EndpointUrlPolicy.cs` SSRF 검증, `"UpstreamNoRedirect"` 명명 `HttpClient`(`AllowAutoRedirect = false`), query language parameter 인코딩, `EndpointSecurityAndSttProxyTests.cs` 추가.
|
||||
- **Supabase Edge Functions (`server/supabase/functions`)**: `stt-proxy/handler.ts` `Content-Length` 초과 선차단(`413`), `embed-chunks/handler.ts` 업스트림 프로바이더 오류 시에만 할당량 환불, `_shared/quota.ts` `PGRST116` 외 DB 오류 fail-closed 예외 전파.
|
||||
- **Web & Admin (`apps/web`, `apps/admin`)**: `safeReturnPath` / `public/sw.js` / `admin-url-safety.ts`로 `//evil`·백슬래시·제어문자 오픈 리다이렉트 차단, OAuth callback 오류 메시지 누출 제거, `apps/admin/src/proxy.ts` `isStaticAssetPath` 정밀화; `apps/web/src/lib/edge-fetch.ts` (`resolveSupabaseFunctionUrl`, `createTimedAbortSignal`, `shouldExitAfterAwait`)를 `chat-panel`, `action-runner`, `payple-*`, `generate-document-button`, `invite-member-form`, `document-editor`, `history` 페이지들에 적용하고 `auth-provider` `bindAuthSession` / `mic-recorder` `acquireGuardedMediaStream` 보강 (`apps/web/tests/security-and-lifecycle.test.ts`, `apps/admin/tests/admin-security.test.ts` + Vitest 구성).
|
||||
|
||||
---
|
||||
|
||||
## 4. 통합 `main` (`cc3f746`) 전체 검증 결과
|
||||
|
||||
### 4.1 Batch 1 (정적 · 계약 · 백엔드 · 사이드카, `task-587`, exit `0`)
|
||||
|
||||
| 게이트 / 스위트 | 결과 |
|
||||
|---|---|
|
||||
| `version:check` | `1.17.1` (`1170100/1170100`) PASS |
|
||||
| `contract:check` / `check:migrations` | PASS / `74` files 일치 |
|
||||
| `security:secrets` / `check:protected-tests` | `0` issues / `0` protected modifications (`HEAD` & `a37dd63`) |
|
||||
| `test:hygiene` / `test:quality` | `448 test files` PASS / `468 test files`, `0` regression |
|
||||
| `check:i18n` / `check:ds-contract` / `check:design` | `2500 keys × 12 locales` / `13 components` / `0` violations |
|
||||
| `dotnet test` (`apps/api-server.Tests`) | **55 passed, 0 failed** |
|
||||
| Sidecar Python `unittest` | **33 tests in 2.169s, OK** |
|
||||
| Supabase Edge (`deno check` + `deno test`) | **273 passed \| 0 failed** |
|
||||
| Cloudflare Worker (`deno check` + `deno test`) | **15 passed \| 0 failed** |
|
||||
| Cloudflare Site Bridge (`deno check` + `deno test`) | **5 passed \| 0 failed** |
|
||||
|
||||
### 4.2 Batch 2 (모노레포 TS · ESLint · Vitest · Jest · 빌드 · 지표, `task-654`, exit `0`)
|
||||
|
||||
> **환경 복구 메모**: Windows 환경에서 `swarm kill`로 `share` 워크트리가 삭제되며 루트 `.bin`·`apps/{admin,web}/node_modules` 일부와 `apps/mobile-rn/node_modules/@babel/plugin-transform-runtime` 등이 손상되어, 게이트 실행 전 `npm install --prefer-offline` + `npm --prefix apps/mobile-rn ci --prefer-offline`으로 복구하고 `better_sqlite3.node` (`sqlite_abi=node_ok`)를 확인했다.
|
||||
|
||||
| 게이트 / 워크스페이스 | 결과 |
|
||||
|---|---|
|
||||
| `typecheck` / `typecheck:mobile` / `typecheck:site` | PASS |
|
||||
| `lint` / `lint:mobile` / `lint:site` (`--max-warnings=0`) | PASS |
|
||||
| `@d3ro/desktop` (Vitest) | **212 files / 2,890 tests PASS** |
|
||||
| `@d3ro/web` (Vitest) | **10 files / 52 tests PASS** |
|
||||
| `@d3ro/admin` (Vitest) | **1 file / 6 tests PASS** |
|
||||
| `@d3ro/api-client` (Vitest) | **4 files / 31 tests PASS** |
|
||||
| `@d3ro/core` (Vitest) | **39 files / 629 tests PASS** |
|
||||
| `@d3ro/i18n` (Vitest) | **2 files / 25 tests PASS** |
|
||||
| `@d3ro/ui` (Vitest) | **2 files / 7 tests PASS** |
|
||||
| `test:mobile` (`@d3ro/mobile-rn` Jest `--runInBand`) | **103 suites / 651 tests PASS** (`24.945 s`) |
|
||||
| `npm run build` + `check:desktop-renderer` | `electron-vite build` + **7 page(s)** PASS |
|
||||
| `npm run test:metrics:write` (`docs/tdd-red/metrics/2026-11-14.md`) | **454 files / 3,738 cases / weak 128 / ambient 203 / skip/todo 3 / 12 locales / 2,500 keys** |
|
||||
|
||||
---
|
||||
|
||||
## 5. 유지된 비코드 / 런타임 / 외부 경계 (`[~]` · `[!]` · `RED`)
|
||||
|
||||
- **Desktop runtime (`[~]`)**: `InputTelemetryService` / `TypoCorrectionService` / `CaptionService` / `LocalLLMService` / `LocalSTTService` / `WindowManager` 수정은 단위·서비스 테스트 및 렌더러 번들 게이트까지 검증되었으며, 실제 Windows GUI(예: `상황 잘 지켜보는중?dbrlgkrhdlTwlsdksgwl?` 라이브 타이핑, 오버레이 표시/해제)는 `GAP-INPUT-08/09/10/11` 외부-터미널 `run-desktop.bat` 실행 대상으로 남는다.
|
||||
- **Mobile runtime & Play Store (`[~]` / `[!]` / `RED`)**: Fold6/iOS 실기기 수동 TalkBack·초회 진입·FCM 수신·AdMob 운영 광고·Play Billing·Play 비공개 테스트(`EXT-*`)는 외부 게이트(`RED`)로 유지한다.
|
||||
- **Cloudflare Worker live env (`[~]`)**: `wrangler.toml` `BACKEND_ORIGIN` 수정분을 실운영 `d3ro-voice-api`에 반영하려면 대시보드 변수 덮어쓰기 또는 재배포가 필요하다.
|
||||
|
|
@ -2,9 +2,11 @@
|
|||
|
||||
> Status: ACTIVE
|
||||
> Last full audit: 2026-09-13
|
||||
> Last update: 2026-11-14 — **전 표면 프로덕션 `v1.17.1` 배포 완결.** 데스크톱(`v1.17.1`, 커밋 `6c6875b`, 서명 매니페스트 `1.17.1/latest.yml`·`.sig` 및 `latest/latest.yml`, 런타임 `runtime-1.17.1`/`runtime-latest`, 포터블 `portable-1.17.1`/`portable-latest` 모두 Forgejo HTTP `200`, 태그 `v1.17.1` canonical/mirror 푸시; Human Release #339 ~91MB 바이너리 첨부만 Cloudflare HTTP 524/`ECONNRESET` `GAP-REL-16` 예외), Supabase 운영 DB(`db push --remote`, 전체 74개 마이그레이션 일치) 및 Edge Functions 24종(`--import-map deno.json --use-api`) 재배포, 랜딩 사이트(`site/` → Cloudflare Pages `d3ro`, `https://d3ro.chanpaca.net/release-identity.json` = `1.17.1`/`6c6875b` & `assetlinks.json` 검증 GREEN), Cloudflare Worker(`d3ro-voice-api` `--keep-vars`, Version ID `fe6d9532-0052-48f5-b62c-45c86f6aaaa5`), NAS Docker 스택(`d3ro_voice_api` `v1.17.1` `/health` `200`, `d3ro_voice_admin` `:3001`/`d3ro-admin.chanpaca.net/login` `200`, `d3ro_voice_web` `:3002/app/login`·`d3ro.chanpaca.net/app/login` `200`) 반영 완료.
|
||||
> Last update: 2026-11-14 — **Wave 7 6-세션 네이티브 피어 스웜(`2a009e4..cc3f746`, [`REFACTOR_WAVE7_REPORT.md`](../REFACTOR_WAVE7_REPORT.md)) 통합 및 모노레포 전 게이트 검증 완료 (post-`v1.17.1`).** `input-core`·`desktop-shell`·`mobile-app`·`cloud-surfaces`·`verifier`·`monitor` 피어 리뷰(`@mention`/`#seq`)를 거쳐 문장부호 직후 무공백 오타 라이브 트리거·서비스 취소/해제·모바일 내구성 큐/화면 가드·Cloudflare/Edge/.NET/Web/Admin 보안 수정을 `main`에 통합하고 Batch 1(`dotnet test 55/55`, sidecar `33/33`, Edge `273/273`, Worker `15/15`, Site Bridge `5/5`, 정적 게이트) + Batch 2(Vitest `270 files / 3,640 tests`, Jest `103 suites / 651 tests`, `typecheck`·`lint`·`build`·`check:desktop-renderer`·`test:metrics:write` `454 files / 3,738 cases`) 통과(운영 `v1.17.1` 재배포·실기기/GUI `[~]`/`[!]`/`RED` 경계 유지).
|
||||
>
|
||||
> Previous update: 2026-11-14 — **전 표면 코드 위생 · 최적화 · 버그 헌팅 완결(Wave 6, WS1–WS4 병렬).** (1) **Desktop Main & Sidecar (`WS1`):** `ipc/renderer-broadcast.ts`(`safeSendToRenderer`/`broadcastToAllWindows`) 9개 파일 단일화, `OnlineLLMService` 스트림 abort/401/예외 래핑, `UnifiedSearchService` FTS5→`LIKE` 런타임 폴백·집계·정렬·인덱스(`started_at`/`created_at`) 보강, `rag/chunk-store.ts` 캐시 무효화·중복 `embedding` JSON 제거·손상 Float32 방어, `disk-wav-audio-sink.ts` uint32 오버플로·헤더 write 실패 fd 정리, `AdMediationEngine`/`AudioCaptureService`/`LocalLLMService`/`WindowManager` 타이머·팝업 레이스 수정, `sidecar/main.py` `UploadFile.close()`·PCM 바이트 경계·`/shutdown` 스레드 join 완료. (2) **Shared Packages & Desktop Renderer (`WS2`):** `@d3ro/i18n` `shared.ts` 및 지연 로드/언마운트 레이스 차단(`25/25`), `@d3ro/core` PII 플레이스홀더·CSV BOM/CR·타임스탬프·검색 경계값(`626/626`), `@d3ro/ui` `wave-math.ts` + 캔버스 `LinearGradient` 캐싱(`7/7`), `@d3ro/ui-native`/`api-client` 경계 가드, 렌더러 `utils/error-message.ts`·훅/컴포넌트 언마운트·타이머 정리 및 Vanilla JS 팝업 6종 `beforeunload`/DOM 안전화 완료. (3) **Mobile RN (`WS3`):** `features/shared/{service-guards,owned-cache-files}.ts`, `features/import/abort-guard.ts`, `lib/locale-speech.ts`(12개 로케일), `features/meetings/meeting-error-message.ts`로 26+ 파일 중복 가드·오류·포맷 통합, `FreeTierBanner` 슬롯 전환 시 높이 고착 수정·내구성 큐 조기 폐기 경합 차단·녹음 리스 누수·언마운트 재생/로케일 레이스 해결(Jest `98 suites / 625 tests PASS`). (4) **Web · Admin · Site · Edge · Worker · .NET (`WS4`):** Edge 20개 엔드포인트 `_shared/json-response.ts`(스트리밍 바이트 상한 포함 `readJsonBody`·`jsonResponse`) 통합 및 `account-delete`/`llm-proxy`/`payple`/`realtime-token` fail-closed 강화(Deno `270/270`), `.NET` `SttProxyService` Base64 상한 + `CancellationToken` 전파(xUnit `32/32`), Cloudflare Worker `resolveBackendTargetUrl` SSRF·타임아웃·`/worker-health` 정보 노출 차단(Deno `9/9`), 웹 `MarkdownPreview` DOM XSS/레이스·`WebPush` 재진입·`team-client` fail-closed(`42/42`), 어드민 `request-security.ts`/`detail-row.tsx`·CSRF/`ADMIN_UUID_PATTERN`/비용 검증, 사이트 `AppLoopDemo`/`rel="noopener noreferrer"` 보강 완료. 상세: [`REFACTOR_WAVE6_REPORT.md`](../REFACTOR_WAVE6_REPORT.md).
|
||||
> Previous update: 2026-11-14 — **전 표면 프로덕션 `v1.17.1` 배포 완결.** 데스크톱(`v1.17.1`, 커밋 `6c6875b`, 서명 매니페스트 `1.17.1/latest.yml`·`.sig` 및 `latest/latest.yml`, 런타임 `runtime-1.17.1`/`runtime-latest`, 포터블 `portable-1.17.1`/`portable-latest` 모두 Forgejo HTTP `200`, 태그 `v1.17.1` canonical/mirror 푸시; Human Release #339 ~91MB 바이너리 첨부만 Cloudflare HTTP 524/`ECONNRESET` `GAP-REL-16` 예외), Supabase 운영 DB(`db push --remote`, 전체 74개 마이그레이션 일치) 및 Edge Functions 24종(`--import-map deno.json --use-api`) 재배포, 랜딩 사이트(`site/` → Cloudflare Pages `d3ro`, `https://d3ro.chanpaca.net/release-identity.json` = `1.17.1`/`6c6875b` & `assetlinks.json` 검증 GREEN), Cloudflare Worker(`d3ro-voice-api` `--keep-vars`, Version ID `fe6d9532-0052-48f5-b62c-45c86f6aaaa5`), NAS Docker 스택(`d3ro_voice_api` `v1.17.1` `/health` `200`, `d3ro_voice_admin` `:3001`/`d3ro-admin.chanpaca.net/login` `200`, `d3ro_voice_web` `:3002/app/login`·`d3ro.chanpaca.net/app/login` `200`) 반영 완료.
|
||||
>
|
||||
> Earlier update: 2026-11-14 — **전 표면 코드 위생 · 최적화 · 버그 헌팅 완결(Wave 6, `66b6b45`, WS1–WS4 병렬).** (1) **Desktop Main & Sidecar (`WS1`):** `ipc/renderer-broadcast.ts`(`safeSendToRenderer`/`broadcastToAllWindows`) 9개 파일 단일화, `OnlineLLMService` 스트림 abort/401/예외 래핑, `UnifiedSearchService` FTS5→`LIKE` 런타임 폴백·집계·정렬·인덱스(`started_at`/`created_at`) 보강, `rag/chunk-store.ts` 캐시 무효화·중복 `embedding` JSON 제거·손상 Float32 방어, `disk-wav-audio-sink.ts` uint32 오버플로·헤더 write 실패 fd 정리, `AdMediationEngine`/`AudioCaptureService`/`LocalLLMService`/`WindowManager` 타이머·팝업 레이스 수정, `sidecar/main.py` `UploadFile.close()`·PCM 바이트 경계·`/shutdown` 스레드 join 완료. (2) **Shared Packages & Desktop Renderer (`WS2`):** `@d3ro/i18n` `shared.ts` 및 지연 로드/언마운트 레이스 차단(`25/25`), `@d3ro/core` PII 플레이스홀더·CSV BOM/CR·타임스탬프·검색 경계값(`626/626`), `@d3ro/ui` `wave-math.ts` + 캔버스 `LinearGradient` 캐싱(`7/7`), `@d3ro/ui-native`/`api-client` 경계 가드, 렌더러 `utils/error-message.ts`·훅/컴포넌트 언마운트·타이머 정리 및 Vanilla JS 팝업 6종 `beforeunload`/DOM 안전화 완료. (3) **Mobile RN (`WS3`):** `features/shared/{service-guards,owned-cache-files}.ts`, `features/import/abort-guard.ts`, `lib/locale-speech.ts`(12개 로케일), `features/meetings/meeting-error-message.ts`로 26+ 파일 중복 가드·오류·포맷 통합, `FreeTierBanner` 슬롯 전환 시 높이 고착 수정·내구성 큐 조기 폐기 경합 차단·녹음 리스 누수·언마운트 재생/로케일 레이스 해결(Jest `98 suites / 625 tests PASS`). (4) **Web · Admin · Site · Edge · Worker · .NET (`WS4`):** Edge 20개 엔드포인트 `_shared/json-response.ts`(스트리밍 바이트 상한 포함 `readJsonBody`·`jsonResponse`) 통합 및 `account-delete`/`llm-proxy`/`payple`/`realtime-token` fail-closed 강화(Deno `270/270`), `.NET` `SttProxyService` Base64 상한 + `CancellationToken` 전파(xUnit `32/32`), Cloudflare Worker `resolveBackendTargetUrl` SSRF·타임아웃·`/worker-health` 정보 노출 차단(Deno `9/9`), 웹 `MarkdownPreview` DOM XSS/레이스·`WebPush` 재진입·`team-client` fail-closed(`42/42`), 어드민 `request-security.ts`/`detail-row.tsx`·CSRF/`ADMIN_UUID_PATTERN`/비용 검증, 사이트 `AppLoopDemo`/`rel="noopener noreferrer"` 보강 완료. 상세: [`REFACTOR_WAVE6_REPORT.md`](../REFACTOR_WAVE6_REPORT.md).
|
||||
>
|
||||
> Previous update: 2026-11-13 — **전 표면 성능 최적화 · 코드 위생 완결(Wave 5) · 백로그 일괄 구현 · TDD v2.0 게이트 완성.** (1) **소스·패키징 위생:** 루트 중복 `resources/sox/`(5.21 MB) 및 `apps/desktop/resources/sox/` 불필요 바이너리 10종 제거 + `electron-builder.yml` 필터 적용, 데스크톱 미구현 광고 어댑터 9종 단일화(`UNAVAILABLE_AD_NETWORK_SPECS`), `scripts/local/` 109개 및 미참조 루트 스크립트 16개 삭제 + `npm run clean:deep`(`scripts/ci/clean-deep.mjs`), `apps/mobile-rn` 루트 순환 의존성(`d3ro-voice-monorepo`)·NTFS 정션 제거, `.NET` `SttController` 무호출 중복 라우트(`GET /providers`, `POST /test`) 삭제. (2) **번들·코드 스플리팅 & 대형 모듈 분리:** `@d3ro/i18n`을 렌더러/웹 동적 로케일 청크(`index.tsx`), 무-React 동기 로더(`@d3ro/i18n/main`), 모바일 지연 엔트리(`index.native.tsx`, Metro `inlineRequires`)로 3분할하고, 데스크톱 `AppLayout.tsx`(7페이지·6모달 `React.lazy`), 모바일 `App.tsx`(`getComponent`), 웹 `MarkdownPreview`(`next/dynamic` + 조건부 `mermaid`) 스플리팅으로 데스크톱 초기 부팅 JS를 `8.79 MB` → `3.62 MB`(`-58.8%`)로 축소했으며, `SettingsModal.tsx`(`951`→`349`줄, 탭 4종 + `settings-model-helpers.ts`)와 `SuggestionService.ts`(`suggestion-policy-helpers.ts`) 순수 모듈 분리를 완료했다. (3) **데스크톱 SQLite · 프로세스 · 오디오 디스크 스트리밍:** SQLite WAL PRAGMA(`synchronous=NORMAL`, `mmap_size=64MB`, `cache_size=-16000`), FTS5 trigram 전문 검색, RAG `embedding_blob`(`Float32Array`) + `WeakMap` 캐시, `PersonalGraphService` 단일 트랜잭션, Windows `koffi` `SendInput` 일원화, 기본 모드 `mousemove`/`wheel` 훅 차단, 백그라운드 팝업 지연 생성, `LocalSTTService` 주 Whisper 모델 유휴/클라우드 언로드, 회의 녹음 PCM 디스크 스트리밍(`DiskWavAudioSink`, 메모리 상주 `O(N)→O(1)`)을 적용했다. (4) **Wave 5 계약·보안 & 기능 백로그 해소:** `@d3ro/core`에 `guards`/`csv`/`format`/`unified-search`/`admin-roles`/`ports` 6개 SSOT 모듈을 추출해 앱 간 중복을 제거하고, 클라우드 LLM·고객지원 `redactPII`/`rehydrateText` 및 녹음 폐기 시 `secureWipeAudioChunks`/`secureZeroBuffer`를 실배선했으며, 고아 키 253개를 정리한 `2,500`키 × 12개 언어를 데스크톱·웹(`LocaleSwitcher`)·모바일(온보딩/설정/계정 + Android `localeFilters` 12개, R8/`shrinkResources`) 전 표면에 노출했다. 또한 `site/` 정적·빌드 CI 게이트(`typecheck:site`/`lint:site`), 웹 `teams` 실 멤버 수 집계(`team-client.ts`), 모바일 `>=600dp` 태블릿/폴더블 반응형 레이아웃(`@d3ro/ui-native/responsive`, 10개 화면 + `FreeTierBanner` `90dp` 슬롯 예약), `meeting_memos.revision` 불변 CAS(마이그레이션 #74 `20261113000001`), 사이드카 `POST /diarize` + 데스크톱·웹·모바일 화자 배지·필터 바(`MTG-08`)를 완성했다. (5) **TDD v2.0 Phase 2~5 자동화 게이트:** `check:i18n`, `check:ds-contract`(`SegmentControl` ARIA `tablist`/`tab` + `@d3ro/ui` 테스트), `test:affected`, `release:installer:smoke`(`verify-desktop-installer-smoke.mjs`: PE64·blockmap·SHA-512·`app-update.yml`·ASAR Pickle·Ed25519 `.sig`)를 `verify:all` 및 `.forgejo/workflows/{ci,release}.yml`에 연결했다. 상세: [`REFACTOR_WAVE5_REPORT.md`](../REFACTOR_WAVE5_REPORT.md).
|
||||
>
|
||||
|
|
|
|||
|
|
@ -128,3 +128,9 @@ Apps depend on packages, never the reverse. Shared package changes ripple to all
|
|||
- **`@d3ro/core` (Vitest 39 files / 626 tests PASS):** `utils/pii-redactor.ts` hardens placeholder collision avoidance, stateful regex index resets, and length-sorted single-pass `rehydrateText`; `csv.ts` adds UTF-8 BOM and `\r` line-ending escaping; `unified-search.ts`, `utils/meeting-markdown.ts`, and `meeting-transcript.ts` (reusing `formatDurationClockFromMs` and finite date guards) harden boundary inputs (`pii-redactor.test.ts` 5, `shared-utilities.test.ts` 10). Deno-synced contracts (`plan-catalog`, `web-urls`, `guards`, `admin-roles`) untouched (`contract:check` GREEN).
|
||||
- **`@d3ro/i18n` (Vitest 2 files / 25 tests PASS):** extracted `src/shared.ts` (`I18nStorage`, `noopI18nStorage`, `safeLoadStoredLocale`, `safeSaveStoredLocale`, non-finite date guard) shared by `index.tsx` and `index.native.tsx`, with `cancelled`, `userChangedLocaleRef`, and `localeRevisionRef` guards blocking stale async storage loads from overwriting explicit `setLocale()` changes (`__tests__/i18n-provider.test.tsx` 10).
|
||||
- **`@d3ro/ui` & `@d3ro/ui-native` & `@d3ro/api-client`:** `@d3ro/ui` extracted `src/components/ds/wave-math.ts` and cached canvas `LinearGradient` instances in `AudioVisualizerBar.tsx` and `GradientWave.tsx` (`__tests__/wave-visualizer.test.tsx` 3, Vitest 2 files / 7 tests PASS); `@d3ro/ui-native` extracted `resolveContentMaxWidth` (`responsive.tsx`) and guarded non-finite bars (`WaveBars.tsx`); `@d3ro/api-client/src/transcribe.ts` clamped negative latencies (Vitest 4 files / 31 tests PASS).
|
||||
|
||||
---
|
||||
|
||||
## 9. Wave 7 hardening (2026-11-14, `2a009e4`, post-`v1.17.1`)
|
||||
|
||||
- **`@d3ro/core` (Vitest 39 files / 629 tests PASS):** `araso-layout.ts` and `typo-correction.ts` refine `isUrlOrPathRun()` so `domain.tld?` / `file.ext?` URLs remain untouched while Hangul ellipsis tokens (`[가-힣ㄱ-ㆎ][!?~]*\.{2,}$`) convert without affecting `...props` (`WORD_BOUNDARY_AFTER_RE` aligned, `__tests__/typo-correction.test.ts` +3); `personal-ngram.ts` removes a redundant intermediate `Map` allocation in `PersonalNgramModel.next()`. Other shared packages hold green on integrated `main` (`@d3ro/i18n` 2/25, `@d3ro/ui` 2/7, `@d3ro/api-client` 4/31 PASS).
|
||||
|
|
|
|||
|
|
@ -280,3 +280,5 @@ DB schema (`src/main/db/schema.ts`, drizzle SQLite): `history`, `dictionary`, `s
|
|||
2026-11-02 verification: installed 1.16.0 passed the actual Electron picker→timestamped transcript→local minutes/action-item journey. Native Korean IME passed 7/7 under bounded 100% CPU and 7/7 with a direct 9.389 s `gemma4:e4b` cold-load request overlapping two typing cases. The Latin-layout control exposed next-key/backspace interleaving; source now waits 140 ms at boundaries and batches the current trailing correction region after a 650 ms pause. Full desktop 2,773 tests and production build pass. The fix was published as Windows v1.16.1 on 2026-11-04; the installed-app Latin control still needs a new GUI run. Synthetic WinForms input is not physical-keyboard/Chromium/terminal proof. [Verification evidence](../evidence/2026-11-02-verification.md).
|
||||
|
||||
2026-11-14 verification (Wave 6 WS1/WS2 hygiene, optimization & bug hunt): unified `safeSendToRenderer` and `broadcastToAllWindows` across 9 IPC/bootstrap modules into `src/main/ipc/renderer-broadcast.ts`; wired `OnlineLLMService` stream abort (`_abortController` in `chatStream`), `401` token reset, empty `data.text` guard, and `D3ROError` wrapping; fixed `UnifiedSearchService` `meetingTotal` double-counting, `startedAt`/`createdAt desc` sort order, runtime FTS5-to-`LIKE` fallback (`hasAllFtsTables`), and DB indexes (`idx_meeting_sessions_started_at`, `idx_meeting_memos_created_at`); exported `invalidateEmbeddedChunksCache` across `rag/chunk-store.ts`, `rag/retrieval.ts`, `sync/sync-adapters.ts`, and `db/index.ts`, cleared redundant cached `embedding` JSON strings after `Float32Array` decode, and guarded malformed Float32 buffers; added `MAX_WAV_DATA_BYTES = 0xffffffff - 36` uint32 guard and post-`openSync` fd cleanup in `disk-wav-audio-sink.ts`; closed timer/popup hide-show races across `AdMediationEngine`, `AudioCaptureService`, `LocalLLMService`, `disposeAudioHandlers`, `bootstrap.ts`, and `WindowManager.ts`; hardened `sidecar/main.py` (`UploadFile.close()`, `<2`/odd-byte PCM handling, `_watch_disconnect`, `/shutdown` `_download_thread` join). Renderer added `src/renderer/utils/error-message.ts` (`toErrorMessage`), unified meeting/pull models, guarded non-finite dates (`formatters.ts`, `UnifiedSearchPage.tsx`), cleaned unmount/sequence/timer/listener paths across pages/modals/hooks, and hardened all 6 vanilla JS popups (`beforeunload` listener/timer cleanup, `textContent = ''`, `result-popup` `prepareVersion`/`isVisible`/rAF cancel, `caption-overlay` per-line `fadeTimer`, bounds clamps). `@d3ro/desktop` Vitest **210 files / 2,865 tests PASS**, sidecar Python `unittest` **33/33 PASS**, `npm run build` + `npm run check:desktop-renderer` (`7 page(s)`) PASS; interactive Electron GUI checks remain `[~]`.
|
||||
|
||||
2026-11-14 verification (Wave 7 peer swarm `input-core` + `desktop-shell`, commits `2a009e4` / `fc5d453` / `3f9e412` on `main`, post-`v1.17.1`): `InputTelemetryService.ts` adds `TYPO_SETTLE_DELAY_MS` (700 ms) / `_typoSettleTimer`, `diffInsertionSpan()` for `_expectedInserts` across punctuation trimming, expired `_programmaticKeys` cleanup, and `_learnFlushTimer.unref()`; `TypoCorrectionService.ts` expands punctuation boundaries (`~…?!。`), allows boundary-terminated tokens up to `MAX_INPLACE_DELETE_CHARS` (32) in `trailingWordOnly`, and skips permanent `_markRegionChecked()` lockout on `trailingWordOnly` passes (`typo-live-punctuation.test.ts`, `TypoCorrectionService.test.ts`). Main services harden popup/lifecycle/abort paths: `WindowManager.hideResultPopup()` cancels `pendingResultShow` and resets `lastResultCursor = null` (`popup-hide-show-race.test.ts`); `CaptionService.ts` records `_captionModelId` after `ensureAuxModel`, releases stale `loadedAuxModelId`, deduplicates concurrent `stop()`/`dispose()` via `_stopPromise`, and resets per-call `AbortController` + `_refineEpoch`/`_refineRunId` (`caption-lifecycle-refine.test.ts`); `VoiceModeService.ts` / `LlmGateway.ts` / `LocalLLMService.ts` propagate `run.controller.signal`, track `/api/pull` abort controllers, prevent polling from restoring availability post-dispose, and wrap dispose aborts into `D3ROError(ErrorCode.LLM_ERROR)`; `VoiceConversationService.ts` / `AudioCaptureService.ts` / `LocalSTTService.ts` / `caption-handlers.ts` clear `_responseAbortController`, fix `'stopping'` SoX resume & `start()` `_cleanup()`, wrap STT download dispose aborts into `D3ROError(ErrorCode.STTModelDownloadCancelled)`, and fail closed with `callback({})` in `desktopCapturer.getSources`. `@d3ro/desktop` Vitest **212 files / 2,890 tests PASS**, sidecar Python `unittest` **33/33 PASS**, `npm run build` + `npm run check:desktop-renderer` (`7 page(s)`) PASS; interactive Electron GUI verification (`GAP-INPUT-08/09/10/11`) remains `[~]`.
|
||||
|
|
|
|||
|
|
@ -61,6 +61,7 @@ Root layout: `ThemeProvider → I18nProvider → AuthProvider`.
|
|||
| `command-client.ts` | Custom instruction client (types, error codes, execute) |
|
||||
| `dashboard-client.ts` | Dashboard snapshot loader |
|
||||
| `dictionary-client.ts` | Dictionary CRUD/pagination/search + `serializeDictionary` / `parseDictionaryFile` / `importDictionaryFile` (JSON/CSV) |
|
||||
| `edge-fetch.ts` | Shared Edge invoke URL builder (`resolveSupabaseFunctionUrl`), bounded timeout signal (`createTimedAbortSignal`), and unmount check (`shouldExitAfterAwait`) (Wave 7 `2026-11-14`) |
|
||||
| `history-client.ts` | History list/get/update/delete, revision-safe |
|
||||
| `supabase-browser.ts` | Re-export `@d3ro/api-client/supabase-browser` |
|
||||
| `supabase-server.ts` | Next `cookies()` wrapper |
|
||||
|
|
@ -76,7 +77,7 @@ Root layout: `ThemeProvider → I18nProvider → AuthProvider`.
|
|||
|
||||
Two layers:
|
||||
|
||||
- **Vitest** (`apps/web/tests/`, `npm --prefix apps/web run test`, part of root `npm test`): pure-logic & SSR contracts — `billing-catalog`, `web-push` (device/RPC/rollback/reconciliation/logout, 17 cases), `web-stt-client`, `team-client` (3 cases), `locale-switcher` (3 cases), `live-transcript-speakers` (2 cases) — 6 files / 32 tests PASS.
|
||||
- **Vitest** (`apps/web/tests/`, `npm --prefix apps/web run test`, part of root `npm test`): pure-logic & SSR contracts — `billing-catalog`, `web-push` (device/RPC/rollback/reconciliation/logout, 17 cases), `web-stt-client`, `team-client` (3 cases), `locale-switcher` (3 cases), `live-transcript-speakers` (2 cases), `security-and-lifecycle` (Wave 7) — **10 files / 52 tests PASS**.
|
||||
- **Playwright** (`apps/web/e2e/`): `smoke.spec.ts` (unauthenticated surface + fail-closed redirects + `/download` handoff), `billing`, `payple-checkout`, `dashboard-dictionary-commands`, `history` (fixture-based browser journeys).
|
||||
|
||||
---
|
||||
|
|
@ -91,3 +92,4 @@ Two layers:
|
|||
- Teams `member_count` aggregation (`team-client.ts`), 12-locale `LocaleSwitcher` + `I18nProvider` persistence, speaker badges/filter chips on `LiveTranscriptList`, knowledge file upload, semantic search, dictionary import/export, and the team activity feed are implemented and unit-tested.
|
||||
- **2026-11-04 Wave 4 hygiene:** Removed the unreferenced dashboard trend chart and the web `recharts` dependency. Web Push now has a production sidebar opt-in/out flow, stable web-device registration, device-bound register/unregister RPCs, disabled-intent reconciliation, bounded local/server cleanup, logout-independent sign-out, and a Docker-copied service worker. An isolated local browser run with ephemeral VAPID proved one active web device, one `webpush` token, one pending outbox attempt, a completed drain, and a `delivered` provider result; that result proves provider acceptance, not service-worker/browser receipt. A later production-standalone run built and served successfully but timed out during throwaway login navigation before the dashboard, so production-rendered 1440/390, accessibility-tree, hit-target, permission/subscription, and receipt gates remain open. No production secrets or deployment were changed.
|
||||
- **2026-10-28 designpaca audit (`SHELL-15`):** All 15 routes and shared components aligned with `design.md` v4 ("조용한 계기"): undefined `--d3-text-inverse` replaced with `--d3-accent-ink`, minimum font size raised to `11px` (`0.6875rem`), `uppercase` and positive `letterSpacing` removed from Korean UI copy, raw `monospace` replaced with `var(--d3-font-mono)`, single `component="h1"` hierarchy enforced per route, and native form controls equipped with `:focus-visible` rings and `<label htmlFor>` / `aria-label` attributes.
|
||||
- **2026-11-14 Wave 7 hardening (`c68e81e`, `4bf0f0d`, post-`v1.17.1`):** closed `/app//evil`, backslash, and control-char open redirects in `web-app-url.ts` (`safeReturnPath`) and `public/sw.js`; scrubbed OAuth callback error leakage (`auth/callback/route.ts`); centralized Edge invocation & bounded abort/unmount checks in `src/lib/edge-fetch.ts` across `chat-panel.tsx` (`executeChatSendTurn`), `action-runner.tsx`, `payple-checkout-button.tsx`, `payple-manage-button.tsx`, `generate-document-button.tsx`, `document-editor.tsx`, `invite-member-form.tsx`, and `(app)/history` routes; hardened `auth-provider.tsx` (`bindAuthSession`) and `mic-recorder.tsx` (`acquireGuardedMediaStream`). Added `tests/security-and-lifecycle.test.ts` (`@d3ro/web` Vitest **10 files / 52 tests PASS**).
|
||||
|
|
|
|||
|
|
@ -118,7 +118,7 @@ The v4 shell also removed `DashScreen` and `WorksHubScreen`. Home replaces the d
|
|||
|
||||
## 6. Tests & evidence
|
||||
|
||||
- Jest: `npm --prefix apps/mobile-rn test` — current full tree **98 suites / 625 tests PASS** (2026-11-14 Wave 6; 2026-11-13 baseline was 89 suites / 605 tests). Coverage includes `onboarding-fresh-route.test.tsx`, `responsive-layout.test.tsx` (4/4), `meeting-detail-speakers.test.tsx` (1/1), `meetings.test.ts` (18/18 incl. `revision` CAS), meeting-import creation routing and `record-screen-redteam-r2-27.test.tsx`, plus 9 Wave 6 regression suites (`durable-queue-early-discard`, `free-tier-banner-resize`, `history-detail-unmount-regression`, `meeting-detail-unmount-regression`, `onboarding-locale-regression`, `record-permission-session-regression`, `service-guards`, `settings-locale-sync-regression`, `talk-locale-recorder-regression`). Wave 6 also consolidated shared guards/cleanup/locale-speech into `features/shared/{service-guards,owned-cache-files}.ts`, `features/import/abort-guard.ts`, `lib/locale-speech.ts`, and `features/meetings/meeting-error-message.ts`, and fixed `FreeTierBanner` slot-change height stickiness (`90dp`->`50dp`), durable queue early-discard `AbortController` registration before `FileSystem.exists`, `RecordScreen` session lease leak, `TalkScreen` 12-locale TTS tags + live greeting sync, and unmount/audio/timer/locale races on `HistoryDetail`/`Settings`/`Onboarding`/`Account`/`MeetingDetail`. The current `.3` Fold6 APK renders the MTG-13 entry/editor; device file selection→transcription→minutes E2E remains NOT_RUN.
|
||||
- Jest: `npm --prefix apps/mobile-rn test` — current full tree **103 suites / 651 tests PASS** (2026-11-14 Wave 7 `bd3c1a9` / `cc3f746`, post-`v1.17.1`; Wave 6 baseline was 98 suites / 625 tests). Wave 6 added `features/shared/{service-guards,owned-cache-files}.ts`, `features/import/abort-guard.ts`, `lib/locale-speech.ts`, `features/meetings/meeting-error-message.ts`, and 9 regression suites. Wave 7 added 5 async lifecycle regression suites (`abort-and-stream-guards`, `context-lifecycle-guards`, `queue-and-history-races`, `recorder-lifecycle-races`, `screen-async-lifecycle`), hardened recorder claim/generation/poll-timer cleanup (`audio-recorder.ts`, `recorder/{nitro,android-foreground}-backend.ts`), fixed `durable-processing-queue.ts` `finishCleanupItem(item)` audio-first deletion with 60 s retry on failure plus `suspendedUsers`/`discardedItems` checks and `use-history-sync.ts` guards, added pre-abort/generation-header cancellation in `chat-service`/`admin-service`/`device-service`/`llm-stream-service`, and isolated user-switch `scopeGenerationRef` + `try/catch/finally` busy guards across 4 contexts (`mobile-ads`, `billing`, `device`, `entitlement`) and 7 screens (`Commands`, `HistoryDetail`, `Home`, `Knowledge`, `Meetings`, `Record`, `Teams`). The current `.3` Fold6 APK renders the MTG-13 entry/editor; device file selection→transcription→minutes E2E and external Play/Firebase/AdMob gates remain open.
|
||||
- Maestro E2E: `apps/mobile-rn/.maestro/` + evidence in `.maestro-output/`.
|
||||
- Current `.3` isolated API 34 AVD: canonical fresh auth **37 s PASS**, signup **50 s PASS**, including persistence after restart. Initial emulator failure was observed with a System UI ANR dialog; it passed after the dialog was dismissed. Both failure and retry are retained under `test-results/recovery-2026-11-01/emulator-*`. The new empty test AVD alone used `clearState`; personal Fold6 data was preserved. This does not resolve the separate Fold6 first-run failures.
|
||||
- Historical `.2` Fold6 physical-device gate (Android 16, `SM-F956N`): fresh auth **60 s PASS**, fresh signup **67 s PASS**, warm/cold invite **31 s PASS**, and small-screen signup **61 s PASS** on 2026-11-01. Fatal/Metro matches 0; evidence is `apps/mobile-rn/.maestro-output/fold6-20261101-fix1/`. Authenticated parity was not run because test credentials are absent.
|
||||
|
|
|
|||
|
|
@ -65,6 +65,7 @@ All mutations flow through `ExecuteAdminMutationAsync` (idempotent + audited).
|
|||
| `AuthService` | Register (one-time SuperAdmin bootstrap only, `PasswordHasher<User>`, serialized), login (timing-safe dummy verify, inactive rejection, rehash), JWT gen (8h, claims id/email/role) |
|
||||
| `LlmProxyService` | Resolve endpoint by model → fallback → Mock echo; OpenAI-style POST; parse content+usage; token cost → `ApiUsageLog`; errors → `ServerErrorLog` + fallback text |
|
||||
| `SttProxyService` (~1182 lines) | Provider adapters (groq/openai/custom, deepgram, google, assemblyai, azure, local-sidecar), candidate resolution + fallback, content-type/duration detection, `SttUsageLog` cost, synthetic-tone endpoint test, CRUD with exclusive default, usage report |
|
||||
| `EndpointUrlPolicy` | Upstream LLM/STT endpoint SSRF validation (`Services/EndpointUrlPolicy.cs`) paired with named `"UpstreamNoRedirect"` `HttpClient` (`AllowAutoRedirect = false`) (Wave 7) |
|
||||
| `AdminOperationService` | Validates actor/idempotency key/memo, SHA-256 request hash, `Serializable` transaction, idempotent replay, before/after audit entry |
|
||||
|
||||
---
|
||||
|
|
@ -88,7 +89,7 @@ DTOs (`Dtos/Dtos.cs`): auth, license audit, LLM, admin/model endpoints, STT (tra
|
|||
|
||||
## 5. Tests (`apps/api-server.Tests/`, xUnit)
|
||||
|
||||
`AdminAuthorizationE2ETests`, `AdminOperationServiceTests`, `AuthBootstrapControllerTests`, `AuthSecurityTests`, `SttControllerSecurityTests`, `SttFailClosedTests`, `SttGatewayAuthorizationE2ETests` (**32/32 PASS** after Wave 6 2026-11-14: enforced `MaxAudioBytes = 26 * 1024 * 1024` / `MaxBase64Length` cap in `SttProxyService.DecodeAudioBase64` before `Convert.FromBase64String`, and propagated `HttpContext.RequestAborted` `CancellationToken` across `SttController`/`LlmController`/`AdminController` → `SttProxyService`/`LlmProxyService` → EF/HTTP/AssemblyAI polling to abort paid failover immediately on client disconnect).
|
||||
`AdminAuthorizationE2ETests`, `AdminOperationServiceTests`, `AuthBootstrapControllerTests`, `AuthSecurityTests`, `EndpointSecurityAndSttProxyTests`, `SttControllerSecurityTests`, `SttFailClosedTests`, `SttGatewayAuthorizationE2ETests` (**55 passed, 0 failed** after Wave 7 `c68e81e` 2026-11-14, post-`v1.17.1`; Wave 6 enforced `MaxAudioBytes = 26 * 1024 * 1024` / `MaxBase64Length` cap in `SttProxyService.DecodeAudioBase64` before `Convert.FromBase64String` and propagated `HttpContext.RequestAborted` `CancellationToken`, and Wave 7 added `Services/EndpointUrlPolicy.cs` SSRF validation, named `"UpstreamNoRedirect"` `HttpClient` with `AllowAutoRedirect = false`, and query parameter URL encoding across `AdminController`, `SttController`, `LlmProxyService`, and `SttProxyService`).
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -53,6 +53,7 @@
|
|||
| File | Purpose |
|
||||
|---|---|
|
||||
| `admin-session.ts` | Session types, secret validation (≥32 bytes), strict cookie parse, `adminCookieSecure()` escape hatch |
|
||||
| `admin-url-safety.ts` | Return/redirect path normalization rejecting `//evil`, backslashes, and control chars (Wave 7) |
|
||||
| `security.ts` | server-only HMAC-SHA256 sign/verify, in-memory rate limit/lockout, runtime security validation |
|
||||
| `admin-guard.ts` | RSC guards `requireManager`/`requireAdmin`/`requireSuperAdmin`, role helpers |
|
||||
| `edge-session.ts` | Edge-runtime HMAC verify via WebCrypto (used by `proxy.ts`) |
|
||||
|
|
@ -90,5 +91,6 @@ Root files: `instrumentation.ts` (startup security validation), `proxy.ts` (edge
|
|||
- `/pipelines` and dashboard node/error sections render only measured data.
|
||||
- Deploy: `apps/admin/Dockerfile` → GHCR + NAS compose; the duplicate root `Dockerfile.admin` was deleted 2026-09-26 (Wave 3, cd9d199) since `apps/admin/Dockerfile` is the one actually used. GitLab admin NAS deploy job disabled.
|
||||
- Wave 6 hardening (2026-11-14): extracted `lib/request-security.ts` (`isSameOriginRequest`, `ADMIN_UUID_PATTERN`, byte-bounded JSON body reader) and `components/detail-row.tsx` (`Row` SSOT); hardened `logout` (`sameSite: 'strict'`, CSRF, `no-store`), `license`/`login`/`backend`/`supabase` routes, `users/[id]` & `subscriptions/[id]` (`requireManager()` + UUID `notFound()`), and client unmount/timer/`sttMemo`/non-finite or negative cost guards (`payment-history`, `checksum-copy`, `license-issuer-dialog`, `models/page.tsx`).
|
||||
- Wave 7 hardening (2026-11-14, `c68e81e`, post-`v1.17.1`): added `lib/admin-url-safety.ts` + open-redirect hardening on `/auth/callback` and `/login` (scrubbing OAuth error leakage), replaced `pathname.includes('.')` bypass in `proxy.ts` with `isStaticAssetPath`, hardened `subscription-form.tsx`, and added Vitest harness (`apps/admin/vitest.config.ts`, `tests/admin-security.test.ts` — **1 file / 6 tests PASS**).
|
||||
- **2026-11-04 Wave 4 hygiene:** Removed three unreferenced chart components (`dau-chart`, `feature-usage-chart`, `top-users-chart`) and the admin `recharts` dependency; no active admin route imported them.
|
||||
- **2026-10-28 designpaca audit (`SHELL-15`):** `console-theme.ts` `C.dim` upgraded from `#67789e` to `#7e8eb0` (WCAG AA 4.94:1 on dark card surface), `panelSx`/`innerCoreSx`/`filterBtnSx`/`statusBadgeSx`/`primaryButtonSx` flattened (removed `backdropFilter` blur, decorative gradients, `uppercase`, and positive `letterSpacing`), 1.0:1 foreground/background token collisions (`--d3-status-successBg`, `--d3-status-dangerBg`, `--d3-tag-cyanBg`) fixed across `admin-sidebar.tsx`, `ads`, `releases`, `subscriptions`, `usage`, `users`, and `login`, sub-11px font sizes raised to `11px`, and keyboard navigation (`role="button"`, `tabIndex={0}`) + `aria-label` added to sidebar and dialog controls.
|
||||
|
|
|
|||
|
|
@ -65,8 +65,9 @@ Integration/E2E: content-report red e2e, content-reporting (ps1/sql), mobile pla
|
|||
|
||||
## 2. Cloudflare worker (`server/cloudflare-worker/`)
|
||||
|
||||
- `wrangler.toml` — worker `d3ro-voice-api`, compat 2024-04-01, `BACKEND_ORIGIN=http://192.168.0.39:5050`, optional custom domain route (commented).
|
||||
- `src/index.ts` — CORS preflight, `/worker-health`, forwards to backend origin with `X-Forwarded-*` / `X-D3RO-Edge-Proxy` headers.
|
||||
- `wrangler.toml` — worker `d3ro-voice-api`, compat 2024-04-01, `BACKEND_ORIGIN="https://d3ro.chanpaca.net"` in source (Wave 7 `c68e81e`; note live Worker `fe6d9532-0052-48f5-b62c-45c86f6aaaa5` still retains pre-Wave-7 dashboard var `http://192.168.0.39:5050` from `--keep-vars`), optional custom domain route (commented).
|
||||
- `src/index.ts`, `src/origin-policy.ts`, `src/push-drain.ts` — CORS preflight, `/worker-health`, origin policy + loop guard (`508`/`503`), null-body status handling (`204`/`205`/`304`), forwards to backend origin with `X-Forwarded-*` / `X-D3RO-Edge-Proxy` headers.
|
||||
- `server/cloudflare-site-bridge/` — Pages/Worker bridge hardened in Wave 7 with `508` loop guard, path smuggling `400`, and `deno.json` (`src/index.test.ts` 5/5 PASS).
|
||||
|
||||
Cloudflare Tunnel `kd-nas` maps public hostnames to NAS services.
|
||||
|
||||
|
|
@ -110,3 +111,10 @@ External gates are enumerated in `docs/v3/MOBILE_APP_COMPLETION_SSOT.md` §0/§6
|
|||
|
||||
- **Supabase Edge Functions (`server/supabase/functions`, Deno `270 passed | 0 failed`):** consolidated `jsonResponse`/`json` and streaming byte-bounded `readJsonBody` into `_shared/json-response.ts` across 20 Edge handlers (preserving CORS/`Cache-Control`/header contracts and failing closed with 400/413 on invalid/oversized JSON); hardened `account-delete` (`SAFE_INTERNAL_CODES`), `llm-proxy` (502 + quota refund on invalid provider JSON), `_shared/payple.ts` (`postPaypleJson` with `AbortSignal.timeout`), and `realtime-token/openai-provider.ts` (`AbortSignal.timeout`), backed by `_shared/json-response.test.ts` and tests in `payple`, `realtime-token`, `llm-proxy`, and `stt-proxy`.
|
||||
- **Cloudflare Worker (`server/cloudflare-worker`, Deno `9 passed | 0 failed`):** added `resolveBackendTargetUrl` blocking `//host`/`\host` SSRF, omitted `backendOrigin` from `/worker-health`, stripped `Host`/hop-by-hop headers, set `redirect: 'manual'`, added `AbortSignal.timeout(30_000)`, sanitized 502/504 JSON responses, removed `console.log`, canceled unread `!response.ok` response bodies in `push-drain.ts`, and added 4 regression tests in `src/index.test.ts`.
|
||||
|
||||
---
|
||||
|
||||
## Wave 7 hardening (2026-11-14, `c68e81e`, post-`v1.17.1`)
|
||||
|
||||
- **Supabase Edge Functions (`server/supabase/functions`, Deno `273 passed | 0 failed`):** `stt-proxy/handler.ts` rejects requests whose `Content-Length` exceeds the cap with `413` before buffering; `embed-chunks/handler.ts` refunds quota only on upstream provider failures; `_shared/quota.ts` fails closed by rethrowing DB errors other than `PGRST116` (`stt-proxy/handler.test.ts`, `embed-chunks/handler.test.ts`, `_shared/quota.test.ts`).
|
||||
- **Cloudflare Worker & Site Bridge (`server/cloudflare-worker`, Deno `15 passed | 0 failed`; `server/cloudflare-site-bridge`, Deno `5 passed | 0 failed`):** updated `wrangler.toml` default `BACKEND_ORIGIN` to `https://d3ro.chanpaca.net` (fixing the HTTP `403` error `1003` root cause in source; live Worker `fe6d9532-...` still holds the pre-Wave-7 dashboard var until redeployed without `--keep-vars` or updated), added `origin-policy.ts` rejecting non-HTTPS/private-IP/internal origins and proxy loops (`508`/`503`), handled null-body statuses (`204`/`205`/`304`), and applied origin validation to `push-drain.ts`; hardened `cloudflare-site-bridge` with `508` loop guard and path-smuggling `400` (`deno.json`, `src/index.test.ts`).
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
|
|
@ -309,3 +309,14 @@ Evidence: [2026-11-02 verification](../evidence/2026-11-02-verification.md).
|
|||
- **Mobile RN (`WS3`):** `features/shared/{service-guards,owned-cache-files}.ts` 외 3개 SSOT 통합, `FreeTierBanner` 리사이즈 높이 고착·내구성 큐 조기 폐기 경합·녹음 리스 누수·TTS 12로케일·언마운트 재생/로케일 레이스 수정 및 9개 회귀 스위트 추가(`98 suites / 625 tests PASS`).
|
||||
- **Web · Admin · Site · Edge · Worker · .NET (`WS4`):** Edge `_shared/json-response.ts` 20개 엔드포인트 통합 및 fail-closed(`Deno 270/270`), `.NET` `SttProxyService` Base64 26MB 상한 + `CancellationToken` 전파(`xUnit 32/32`), Cloudflare Worker `resolveBackendTargetUrl` SSRF·타임아웃 차단(`Deno 9/9`), 웹 `MarkdownPreview` DOM XSS/레이스·`WebPush` 재진입·`team-client` fail-closed(`42/42`), 어드민 `request-security.ts`/`detail-row.tsx`·CSRF/비용 검증, 사이트 `AppLoopDemo`/`rel="noopener noreferrer"` 보강.
|
||||
- **정량 게이트 및 경계 유지:** `verify:all`, `contract:check`, `check:migrations`(74), `version:check`(1.16.5), `security:secrets`, `test:metrics:write`(`docs/tdd-red/metrics/2026-11-14.md`) GREEN. Electron 실GUI(`Ctrl+K`/오버레이), Fold6/iOS 실기기 Maestro·TalkBack, 외부 자격증명/운영 `db push` `[~]`/`[!]`/`RED` 경계는 변경 없이 유지. 상세: [`docs/REFACTOR_WAVE6_REPORT.md`](../REFACTOR_WAVE6_REPORT.md).
|
||||
|
||||
---
|
||||
|
||||
## 2026-11-14 — Wave 7 다중 세션 피어 스웜 코드 위생 · 최적화 · 버그 헌팅 (`2a009e4..cc3f746`, post-`v1.17.1`)
|
||||
|
||||
- `[x]` **Wave 7 6-세션 네이티브 스웜(`monitor`, `input-core`, `desktop-shell`, `mobile-app`, `cloud-surfaces`, `verifier`) 통합 및 검증 완료:**
|
||||
- **Input Core (`2a009e4`):** 문장부호 직후 무공백 영타 오타(`?` / 한글 말줄임표) 누락 4중 원인 수정(`TYPO_SETTLE_DELAY_MS` 700ms, `diffInsertionSpan()`, `trailingWordOnly` 32자·영구 잠금 해제, `isUrlOrPathRun()` URL/코드 보존 + 한글 말줄임표 허용, `PersonalNgramModel.next()` 중복 복사 제거; `typo-live-punctuation.test.ts` 추가).
|
||||
- **Desktop Shell (`fc5d453`, `3f9e412`):** `WindowManager` 팝업 숨김 타이머/커서 초기화, `CaptionService` 보조모델/중복 stop/epoch 리셋, `VoiceModeService`/`LlmGateway`/`LocalLLMService` signal 전파 및 `/api/pull` dispose `D3ROError(LLM_ERROR)` 래핑, `LocalSTTService` 모델 다운로드 dispose `D3ROError(STTModelDownloadCancelled)` 래핑, `VoiceConversationService`/`AudioCaptureService`/`caption-handlers.ts` fail-closed 정리(`@d3ro/desktop` Vitest **212 files / 2,890 tests PASS**, Python sidecar `33/33 PASS`, `electron-vite build` + `check:desktop-renderer` **7 page(s)** PASS).
|
||||
- **Mobile RN (`bd3c1a9`, `cc3f746`):** 레코더 claim/generation/pollTimer, 내구성 큐 `finishCleanupItem(item)`(파일 선삭제+60초 실패 재시도) 및 `suspendedUsers`/`discardedItems`, `chat`/`admin`/`device`/`llm-stream` abort/세대 헤더 가드, 4개 컨텍스트 및 7개 화면 `scopeGenerationRef`+`try/catch/finally` 적용 + 신규 스위트 5종(**103 suites / 651 tests PASS**).
|
||||
- **Cloud Surfaces (`c68e81e`, `4bf0f0d`):** Cloudflare Worker `BACKEND_ORIGIN` `https://d3ro.chanpaca.net`·`origin-policy.ts`·`push-drain.ts`(`Deno 15/15`), `cloudflare-site-bridge` loop/path 가드(`Deno 5/5`), `.NET` `EndpointUrlPolicy.cs`+`"UpstreamNoRedirect"`(`xUnit 55/55`), Edge `stt-proxy` 413 선차단·`embed-chunks` 환불 경계·`_shared/quota.ts` fail-closed(`Deno 273/273`), Web `edge-fetch.ts`·`safeReturnPath`·`sw.js`·OAuth callback·`chat-panel`/`auth-provider`/`mic-recorder`(`10 files / 52 tests PASS`), Admin `admin-url-safety.ts`·`proxy.ts`·Vitest 도입(`1 file / 6 tests PASS`).
|
||||
- **유지된 경계 (`[~]` / `[!]` / `RED`):** Wave 7 코드는 `v1.17.1` 운영 배포(`6c6875b`) 이후 `main`에 통합되었으므로 실운영 바이너리·컨테이너 및 라이브 Worker(`fe6d9532-...`, 대시보드 `BACKEND_ORIGIN = http://192.168.0.39:5050` 잔존 -> `1003`/`403`)에는 아직 미반영. Electron 실GUI(`GAP-INPUT-08/09/10/11`), Fold6/iOS 실기기/TalkBack, `EXT-*` 스토어 게이트는 변동 없이 유지. 상세: [`docs/REFACTOR_WAVE7_REPORT.md`](../REFACTOR_WAVE7_REPORT.md).
|
||||
|
|
|
|||
|
|
@ -7,9 +7,9 @@
|
|||
|
||||
| 항목 | 값 |
|
||||
|---|---|
|
||||
| 테스트 파일 | 445 |
|
||||
| 테스트 케이스 | 3655 |
|
||||
| 단정(expect/assert) | 9549 |
|
||||
| 테스트 파일 | 454 |
|
||||
| 테스트 케이스 | 3738 |
|
||||
| 단정(expect/assert) | 9828 |
|
||||
| 약한 단정 (toBeDefined/toBeTruthy/toBeFalsy/toBeNull) | 128 |
|
||||
| 시간·난수 직접 호출 (ambient) | 203 |
|
||||
| skip/todo | 3 |
|
||||
|
|
@ -20,16 +20,16 @@
|
|||
|
||||
| 스위트 | 파일 | 케이스 | 단정 | 약한 단정 | ambient |
|
||||
|---|---:|---:|---:|---:|---:|
|
||||
| 데스크톱 (Vitest) | 224 | 2135 | 5397 | 88 | 164 |
|
||||
| packages/core (Vitest) | 39 | 568 | 1325 | 14 | 3 |
|
||||
| 데스크톱 (Vitest) | 226 | 2160 | 5487 | 88 | 164 |
|
||||
| packages/core (Vitest) | 39 | 571 | 1335 | 14 | 3 |
|
||||
| packages/i18n (Vitest) | 2 | 10 | 31 | 0 | 0 |
|
||||
| packages/ui (Vitest) | 2 | 7 | 30 | 0 | 0 |
|
||||
| packages/api-client (Vitest) | 4 | 31 | 47 | 3 | 0 |
|
||||
| 웹 (Vitest + Playwright) | 14 | 64 | 250 | 9 | 5 |
|
||||
| 모바일 (Jest) | 106 | 535 | 1720 | 14 | 24 |
|
||||
| Supabase Edge (Deno) | 45 | 270 | 647 | 0 | 7 |
|
||||
| Cloudflare Worker (Deno) | 2 | 9 | 26 | 0 | 0 |
|
||||
| API 서버 (xUnit) | 7 | 26 | 76 | 0 | 0 |
|
||||
| 웹 (Vitest + Playwright) | 15 | 74 | 306 | 9 | 5 |
|
||||
| 모바일 (Jest) | 111 | 561 | 1814 | 14 | 24 |
|
||||
| Supabase Edge (Deno) | 45 | 273 | 654 | 0 | 7 |
|
||||
| Cloudflare Worker (Deno) | 2 | 15 | 34 | 0 | 0 |
|
||||
| API 서버 (xUnit) | 8 | 36 | 90 | 0 | 0 |
|
||||
|
||||
## 약한 단정 상위 파일
|
||||
|
||||
|
|
|
|||
|
|
@ -369,7 +369,8 @@
|
|||
| Mobile lint | `npm --prefix apps/mobile-rn run lint` | GREEN, warning/error 0 (`--max-warnings=0`) | `apps/mobile-rn/.eslintrc.js`, `package.json` | 2026-08-21 |
|
||||
| Mobile typecheck | `npm --prefix apps/mobile-rn run typecheck` | GREEN | `apps/mobile-rn/tsconfig.json` | 2026-08-21 |
|
||||
| Historical mobile unit | `npm --prefix apps/mobile-rn test` | 당시 전체 통합 tree 57 suites / 353 tests GREEN; 현재 tree 수치가 아님 | `apps/mobile-rn/__tests__` | 2026-08-24 |
|
||||
| Current mobile unit | `npm --prefix apps/mobile-rn test` | 전체 tree **98 suites / 625 tests PASS** (2026-11-14 Wave 6; 2026-11-13 89/605 대비 +9 suites / +20 tests). 온보딩 목적지 순서, H-017 회의 생성→녹음 파일 import→durable meeting pipeline, 12개 로케일 전환(`mobile-i18n-locales.test.tsx`), `>=600dp` 태블릿 반응형(`responsive-layout.test.tsx`), `meeting_memos.revision` CAS 및 화자 필터(`meetings.test.ts` 18/18), Wave 6 SSOT 가드·언마운트/큐/배너 회귀를 고정하고 lint/typecheck도 GREEN | `apps/mobile-rn/__tests__/{onboarding-fresh-route,meeting-creation-screen,record-screen-redteam-r2-27,mobile-i18n-locales,responsive-layout,meetings,service-guards,free-tier-banner-resize,durable-queue-early-discard,record-permission-session-regression,talk-locale-recorder-regression,history-detail-unmount-regression,meeting-detail-unmount-regression,settings-locale-sync-regression,onboarding-locale-regression}.test.ts(x)` | 2026-11-14 |
|
||||
| Current mobile unit | `npm --prefix apps/mobile-rn test` | 전체 tree **103 suites / 651 tests PASS** (2026-11-14 Wave 7 `bd3c1a9`/`cc3f746`, post-`v1.17.1`; Wave 6 98/625 대비 +5 suites / +26 tests). 온보딩 목적지 순서, H-017 회의 생성→녹음 파일 import→durable meeting pipeline, 12개 로케일 전환(`mobile-i18n-locales.test.tsx`), `>=600dp` 태블릿 반응형(`responsive-layout.test.tsx`), `meeting_memos.revision` CAS 및 화자 필터(`meetings.test.ts` 18/18), Wave 6 SSOT 가드·언마운트/큐/배너 회귀 및 Wave 7 레코더/큐/스트림/컨텍스트/화면 비동기 수명주기 가드 5개 스위트를 고정하고 lint/typecheck도 GREEN | `apps/mobile-rn/__tests__/{onboarding-fresh-route,meeting-creation-screen,record-screen-redteam-r2-27,mobile-i18n-locales,responsive-layout,meetings,service-guards,free-tier-banner-resize,durable-queue-early-discard,record-permission-session-regression,talk-locale-recorder-regression,history-detail-unmount-regression,meeting-detail-unmount-regression,settings-locale-sync-regression,onboarding-locale-regression,abort-and-stream-guards,context-lifecycle-guards,queue-and-history-races,recorder-lifecycle-races,screen-async-lifecycle}.test.ts(x)` | 2026-11-14 |
|
||||
| 2026-11-14 Wave 7 async lifecycle hardening | `typecheck:mobile`, `lint:mobile`, `test:mobile`, `test:hygiene`, `test:quality` | `audio-recorder.ts`·`recorder/{nitro,android-foreground}-backend.ts` `pendingClaim`/generation/`pollTimer` 정리, `durable-processing-queue.ts` `finishCleanupItem(item)`(오디오 선삭제 + 실패 시 60초 재시도) 및 `suspendedUsers`/`discardedItems` 가드, `use-history-sync.ts` 요청/스코프 가드, `chat`/`admin`/`device`/`llm-stream` pre-abort 및 세대 헤더 취소, 4개 컨텍스트(`mobile-ads`/`billing`/`device`/`entitlement`)·7개 화면(`Commands`/`HistoryDetail`/`Home`/`Knowledge`/`Meetings`/`Record`/`Teams`) 계정 전환 `scopeGenerationRef`+`try/catch/finally` 가드 및 5개 회귀 스위트 추가(**103 suites / 651 tests PASS**; 실기기/first-run/production 경계는 미검증 유지) | `apps/mobile-rn/src/lib/{audio-recorder,billing-context,device-context,entitlement-context,mobile-ads-context}.ts(x)`, `apps/mobile-rn/src/features/recording/durable-processing-queue.ts`, `apps/mobile-rn/src/features/history/use-history-sync.ts`, `apps/mobile-rn/src/screens/{Commands,HistoryDetail,Home,Knowledge,Meetings,Record,Teams}Screen.tsx` | 2026-11-14 |
|
||||
| 2026-11-14 Wave 6 hygiene, SSOT & lifecycle fixes | `typecheck:mobile`, `lint:mobile`, `test:mobile`, `test:hygiene`, `test:quality`, `check:design` | `features/shared/{service-guards,owned-cache-files}.ts`, `features/import/abort-guard.ts`, `lib/locale-speech.ts`(12개 로케일), `features/meetings/meeting-error-message.ts`로 26+ 파일 중복 가드·오류·시간 포맷 통합, `FreeTierBanner` 슬롯 전환 시 높이 고착(`90dp`->`50dp`)·`durable-processing-queue` 조기 폐기 경합·`RecordScreen` 리스 누수·`TalkScreen` TTS 로케일·언마운트/로케일 레이스 수정 및 9개 회귀 스위트 추가(**98 suites / 625 tests PASS**; 실기기/first-run/production 경계는 미검증 유지) | `apps/mobile-rn/src/features/shared/{service-guards,owned-cache-files}.ts`, `apps/mobile-rn/src/features/import/abort-guard.ts`, `apps/mobile-rn/src/lib/locale-speech.ts`, `apps/mobile-rn/src/features/meetings/meeting-error-message.ts`, `apps/mobile-rn/src/components/FreeTierBanner.tsx`, `apps/mobile-rn/src/features/import/durable-processing-queue.ts` | 2026-11-14 |
|
||||
| 2026-11-13 bundle, R8, 12-locale & tablet hygiene | `typecheck:mobile`, `lint:mobile`, `test:mobile`, `release:mobile:build-config:test` | 루트 순환 의존성(`d3ro-voice-monorepo`)·NTFS 정션 제거, `App.tsx` `getComponent` + Metro `inlineRequires`, `@d3ro/i18n` `index.native.tsx` 12개 로케일 + 온보딩/설정/계정 선택기, `@d3ro/ui-native/responsive` 10개 화면 대화면 대응, Android R8(`enableProguardInReleaseBuilds=true`) + `shrinkResources` + 12개 로케일 `localeFilters` 및 `proguard-rules.pro` 반영; 당시 모든 모바일 소스 게이트 및 **89 suites / 605 tests GREEN** (실제 release APK/AAB 및 Fold6 `open`/`closed` 실기기 눈 확인은 대기) | `apps/mobile-rn/{App.tsx,metro.config.js,package.json}`, `apps/mobile-rn/android/app/{build.gradle,proguard-rules.pro}`, `packages/i18n/src/index.native.tsx`, `packages/ui-native/src/responsive.tsx`, `scripts/ci/verify-mobile-build-config.mjs` | 2026-11-13 |
|
||||
| Current local runtime APK | metadata + SHA-256 + installed identity + Build Tools 37 verifier | `.3` / `2026110103`, 147158575 B, SHA-256 `937d2a0b3fb6b810516f07e91dd97ffe99d34c5885a72f21805a51e8a408027f`; local E2E artifact, production 아님. import entry/editor 실기 표시 확인; 저장·전사·회의록은 미검증 | `test-results/recovery-2026-11-01/android-artifact.json`, `mobile-import.xml`, `mobile-import.png` | 2026-11-01 |
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue