Merge pull request 'chore(release): v0.2.4 — patch cut (backlog 5건 + dogfood unblock)' (#22 ) from feat/v024-patch-cleanup into main

Reviewed-on: #22
fix(v024): About dialog EOL + .catch (round 1 review)
2026-05-04 15:24:46 +00:00 · 2026-05-05 00:22:00 +09:00 · 2026-05-05 00:15:51 +09:00 · 2026-05-05 00:14:30 +09:00 · 2026-05-05 00:12:56 +09:00 · 2026-05-05 00:11:38 +09:00
28 changed files with 2221 additions and 66 deletions
--- a/docs/superpowers/plans/2026-05-04-v0231-ollama-settings.md
+++ b/docs/superpowers/plans/2026-05-04-v0231-ollama-settings.md
--- a/docs/superpowers/specs/2026-05-04-v0231-ollama-settings-design.md
+++ b/docs/superpowers/specs/2026-05-04-v0231-ollama-settings-design.md
@@ -0,0 +1,334 @@
+# v0.2.3.1 Ollama 설정 In-App UI — Design Spec
+
+> 작성: 2026-05-04 · v0.2.3 dogfood unblock 용 patch cut. 환경변수 의존 제거, 사용자 친화 endpoint/model 변경 path.
+
+## 1. Goal
+
+Inkling 사용자가 트레이 메뉴 / OllamaBanner 에서 Ollama endpoint + model 을 직접 변경 가능하도록. 현재는 `INKLING_OLLAMA_ENDPOINT` env var 만 지원 — Windows 의 dynamic port 점유 (Hyper-V/WSL2 NAT) 같은 환경 이슈에 즉시 대응 못함. patch cut 으로 dogfood unblock 후 1주 soak 진입.
+
+## 2. Decisions (mini-brainstorm 합의)
+
+| # | 질문 | 선택 | 이유 |
+|---|---|---|---|
+| Q1 | Model 설정 포함 여부 | **B** Endpoint + Model 둘 다 | endpoint 만으로는 커버 불충분 (LAN 서버 fallback 시 model 도 다를 수 있음) |
+| Q2 | Model input 형태 | **A** Freetext | "급한" patch cut, healthCheck 가 검증, dropdown 은 v0.2.4 영역 |
+| Q3 | Settings 영속화 | **B** JSON file (`<profileDir>/settings.json`) | migration v4 회피, 항목 2개 라 transaction 불필요, user 직접 편집 가능 |
+
+자명 결정 (질문 없이 패턴 따름):
+- env var precedence: **settings > env > default**
+- in-flight job 처리: **AbortController abort + provider re-create**
+- UI placement: **트레이 메뉴 "Ollama 설정..." + OllamaBanner 의 "설정" 링크**
+- validation: **save 전 healthCheck**
+
+## 3. Architecture & data flow
+
+```
+사용자 액션:
+  1. 트레이 → "Ollama 설정..." 클릭 (또는 OllamaBanner 의 "설정" 링크)
+  2. Settings modal 열림 — endpoint + model 입력란 + "저장" 버튼
+  3. 사용자 endpoint/model 입력 → "저장" 클릭
+
+저장 흐름:
+  ├─ Renderer: inboxApi.saveOllamaSettings({ endpoint, model })
+  ├─ Main IPC: 임시 LocalOllamaProvider 생성 → healthCheck()
+  │   ├─ ok=true → JSON 영속화 + provider/health 교체
+  │   └─ ok=false → 저장 거부 + reason 반환 (modal 안에 inline 에러)
+  ├─ 기존 in-flight AI job 처리:
+  │   └─ AbortController abort → 현재 generate 중단 → unreachable 분류 →
+  │      AiWorker 의 무한 retry 가 새 endpoint 로 재시도 (자동 회복)
+  └─ HealthChecker.recheck() → OllamaBanner 즉시 갱신
+
+부팅 흐름 (precedence: settings > env > default):
+  index.ts:
+    const settings = await settingsSvc.load()   // JSON 또는 빈 객체
+    const endpoint = settings.ollama?.endpoint
+                   ?? process.env.INKLING_OLLAMA_ENDPOINT
+                   ?? 'http://localhost:11434'
+    const model = settings.ollama?.model ?? 'gemma4:e4b'
+```
+
+### 3.1 핵심 invariants
+
+1. **저장 = 검증 통과 전제** — healthCheck ok=false 면 JSON 안 씀. 사용자 잘못된 값 영속화 방지
+2. **Provider mutability via re-create** — `setEndpoint()` 메서드 추가 X. `ProviderHolder` 가 새 인스턴스 보유, listeners 알림. `AbortController` 가 in-flight 중단
+3. **Settings precedence**: settings.json > env var > hardcoded default. UI 가 source of truth
+4. **단일 settings file** — `<profileDir>/settings.json`. atomic write (`writeFile` temp → `rename`). 손상 시 빈 객체 fallback (no app crash)
+5. **HealthChecker rebind** — `ProviderHolder.onReplace` 통해 새 provider 받아 polling endpoint 즉시 갱신
+6. **Backward compat** — settings.json 없는 첫 부팅: env var → default 순. 기존 사용자 영향 0
+7. **Cross-platform 자동** — `app.getPath('userData')` + `node:path.join` + `node:fs/promises` 가 OS 별 경로/separator/UTF-8 자동. 별도 분기 0
+
+## 4. Components
+
+### 4.1 `SettingsService` (신규)
+
+**파일**: `src/main/services/SettingsService.ts`
+
+```typescript
+import { readFile, writeFile, mkdir, rename } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { z } from 'zod';
+
+const OllamaSettingsSchema = z.object({
+  endpoint: z.string().url(),
+  model: z.string().min(1)
+}).strict();
+
+const SettingsSchema = z.object({
+  ollama: OllamaSettingsSchema.optional()
+}).strict();
+
+export type Settings = z.infer<typeof SettingsSchema>;
+export type OllamaSettings = z.infer<typeof OllamaSettingsSchema>;
+
+export class SettingsService {
+  private filePath: string;
+  private cache: Settings | null = null;
+
+  constructor(profileDir: string) {
+    this.filePath = join(profileDir, 'settings.json');
+  }
+
+  async load(): Promise<Settings> {
+    if (this.cache !== null) return this.cache;
+    try {
+      const raw = await readFile(this.filePath, 'utf8');
+      const parsed = JSON.parse(raw);
+      this.cache = SettingsSchema.parse(parsed);
+    } catch {
+      this.cache = {}; // 파일 없음 또는 손상 → 빈 객체 fallback
+    }
+    return this.cache;
+  }
+
+  async setOllama(value: OllamaSettings): Promise<void> {
+    const validated = OllamaSettingsSchema.parse(value);
+    const current = await this.load();
+    const next: Settings = { ...current, ollama: validated };
+    await mkdir(dirname(this.filePath), { recursive: true });
+    const tmpPath = this.filePath + '.tmp';
+    await writeFile(tmpPath, JSON.stringify(next, null, 2), 'utf8');
+    await rename(tmpPath, this.filePath);
+    this.cache = next;
+  }
+}
+```
+
+### 4.2 `ProviderHolder` (신규)
+
+**파일**: `src/main/ai/ProviderHolder.ts`
+
+```typescript
+import type { LocalOllamaProvider } from './LocalOllamaProvider.js';
+
+export class ProviderHolder {
+  private current: LocalOllamaProvider;
+  private listeners: Array<(p: LocalOllamaProvider) => void> = [];
+
+  constructor(initial: LocalOllamaProvider) {
+    this.current = initial;
+  }
+
+  get(): LocalOllamaProvider {
+    return this.current;
+  }
+
+  replace(next: LocalOllamaProvider): void {
+    this.current = next;
+    for (const fn of this.listeners) fn(next);
+  }
+
+  onReplace(fn: (p: LocalOllamaProvider) => void): void {
+    this.listeners.push(fn);
+  }
+}
+```
+
+### 4.3 `LocalOllamaProvider` AbortController + 사용처 변경
+
+**파일**: `src/main/ai/LocalOllamaProvider.ts` (수정)
+
+```typescript
+export class LocalOllamaProvider implements InferenceProvider {
+  private abortController: AbortController | null = null;
+
+  async generate(input: GenerateInput): Promise<AiResponse> {
+    this.abortController = new AbortController();
+    const timer = setTimeout(() => this.abortController?.abort(), this.timeoutMs);
+    try {
+      const res = await request(`${this.endpoint}/api/generate`, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({
+          model: this.model,
+          prompt: buildPrompt(input.text, input.todayKst, input.dueDateCandidates, input.vocab ?? []),
+          format: 'json',
+          stream: false,
+          options: { temperature: this.temperature, num_predict: this.numPredict }
+        }),
+        signal: this.abortController.signal
+      });
+      // ... 기존 응답 처리 ...
+    } finally {
+      clearTimeout(timer);
+      this.abortController = null;
+    }
+  }
+
+  abort(): void {
+    this.abortController?.abort();
+  }
+}
+```
+
+기존 `signal: controller.signal` 부분에서 `controller` 가 method-local 이었음 → `this.abortController` 로 이동 (외부 abort 가능).
+
+### 4.4 `AiWorker` + `HealthChecker` 가 `ProviderHolder` 사용
+
+`AiWorker` constructor: `provider: InferenceProvider` → `private holder: ProviderHolder`
+- `processJob` 내 `this.provider.generate(...)` → `this.holder.get().generate(...)`
+- `provider: this.provider.name` → `provider: this.holder.get().name`
+
+`HealthChecker` 도 동일 패턴 + `onReplace` listener 등록 → 새 provider 즉시 polling.
+
+### 4.5 IPC + Preload + InboxApi types
+
+```typescript
+// src/main/ipc/inboxApi.ts
+ipcMain.handle('inbox:loadOllamaSettings', async () => {
+  const s = await deps.settings.load();
+  return s.ollama ?? null;
+});
+
+ipcMain.handle('inbox:saveOllamaSettings', async (_e, value: { endpoint: string; model: string }) => {
+  // 검증: 새 인스턴스로 healthCheck
+  const trial = new LocalOllamaProvider({ endpoint: value.endpoint, model: value.model });
+  const r = await trial.healthCheck();
+  if (!r.ok) return { ok: false, reason: r.reason };
+  await deps.settings.setOllama(value);
+  // in-flight 중단 후 holder 교체
+  deps.providerHolder.get().abort();
+  deps.providerHolder.replace(trial);
+  await deps.health.recheck();
+  return { ok: true };
+});
+```
+
+```typescript
+// src/preload/index.ts
+loadOllamaSettings: () => ipcRenderer.invoke('inbox:loadOllamaSettings'),
+saveOllamaSettings: (v: { endpoint: string; model: string }) => ipcRenderer.invoke('inbox:saveOllamaSettings', v),
+```
+
+```typescript
+// src/shared/types.ts InboxApi
+loadOllamaSettings(): Promise<{ endpoint: string; model: string } | null>;
+saveOllamaSettings(v: { endpoint: string; model: string }): Promise<{ ok: true } | { ok: false; reason: string }>;
+```
+
+### 4.6 `OllamaSettingsModal` 컴포넌트
+
+**파일**: `src/renderer/inbox/components/OllamaSettingsModal.tsx`
+
+- Props: `open: boolean`, `onClose: () => void`
+- 입력란 2개 (endpoint, model) + "저장" / "취소"
+- 마운트 시 `inboxApi.loadOllamaSettings()` → 초기값 prefill
+- 저장 시 `saveOllamaSettings(...)` → 성공 닫기 + 토스트, 실패 inline 에러
+- React `<dialog>` 또는 portal — 별도 BrowserWindow X (단순함)
+
+### 4.7 OllamaBanner "설정" 링크
+
+기존 `OllamaBanner.tsx` 에 endpoint 변경 링크 추가:
+```typescript
+<button onClick={() => setSettingsOpen(true)}>설정</button>
+```
+modal state 는 App.tsx 가 보유 + OllamaBanner 와 OllamaSettingsModal 둘 다에 넘김.
+
+### 4.8 트레이 메뉴 + IPC 채널
+
+`tray.ts` 의 `createTray` 가 10번째 positional callback 받음 → backlog #4/#26 (TrayCallbacks object refactor) 와 합산 가능. 본 cut 에선 일관성 우선 positional 추가:
+
+```typescript
+{ label: 'Ollama 설정...', click: () => runOpenOllamaSettings() }
+```
+
+`index.ts` 가 `runOpenOllamaSettings = () => mainWindow.webContents.send('inbox:openOllamaSettings')` 푸시. Renderer App.tsx 가 이 channel 구독해 modal 열기.
+
+### 4.9 `index.ts` 부팅 흐름 변경
+
+```typescript
+const settingsSvc = new SettingsService(paths.profileDir);
+const settings = await settingsSvc.load();
+
+const resolvedEndpoint = settings.ollama?.endpoint
+                       ?? process.env.INKLING_OLLAMA_ENDPOINT
+                       ?? 'http://localhost:11434';
+const resolvedModel = settings.ollama?.model ?? 'gemma4:e4b';
+
+logger.info('ai.endpoint', {
+  endpoint: resolvedEndpoint,
+  source: settings.ollama?.endpoint
+    ? 'settings'
+    : (process.env.INKLING_OLLAMA_ENDPOINT ? 'env' : 'default')
+});
+
+const provider = new LocalOllamaProvider({ endpoint: resolvedEndpoint, model: resolvedModel });
+const holder = new ProviderHolder(provider);
+
+const health = new HealthChecker(holder, { ... });
+const aiWorker = new AiWorker(repo, holder, { ... });
+```
+
+## 5. Privacy invariant
+
+- `settings.json` 은 local only, telemetry emit X
+- 잠재적 `ollama_settings_changed` event 추가 시 endpoint URL 노출 → privacy 위반 → **emit 안 함** (본 cut)
+- 향후 v0.2.4 dogfood telemetry 에서 변경 빈도 측정 필요 시 `{ count: number }` payload (URL 자체 X) 형태로 추가
+
+## 6. Tests (≥10개)
+
+### SettingsService.test.ts (신규, 6)
+1. `load()` 파일 없음 → 빈 객체
+2. `load()` 손상 JSON (parse 실패) → 빈 객체 fallback (no throw)
+3. `load()` 캐시 동작 — 두 번째 호출 시 file read 안 함
+4. `setOllama()` zod 검증 실패 (non-URL endpoint) → throw
+5. `setOllama()` 정상 저장 → 디스크 file 존재 + 내용 일치
+6. `setOllama()` atomic write — temp file 남지 않음 (rename 후 cleanup)
+
+### ProviderHolder.test.ts (신규, 2)
+7. `replace()` 시 listener 발화 + `get()` 가 새 인스턴스 반환
+8. listener 여러 개 등록 시 모두 발화
+
+### LocalOllamaProvider.test.ts (확장, 2)
+9. `abort()` 호출 시 in-flight `generate()` rejects (AbortError)
+10. constructor `model` 파라미터 적용 (default `gemma4:e4b` 외 임의 model)
+
+총 신규 단위 **10개**. 기존 403 + 10 = **413**.
+
+(Renderer modal 컴포넌트 단위 테스트 X — Inkling 패턴 따라 store-only. IPC handler 자체도 service-level test 가 logic 보유.)
+
+## 7. Out of scope
+
+- Multi-provider abstraction (OpenAI, Anthropic, etc) — strategy.md local-first 정책 충돌, v0.2.4+
+- Settings UI 안에서 다른 기능 (telemetry retention, vocab top-N 등) — 별 cut
+- Cross-machine settings sync — 단일 머신 dogfood 패턴
+- Model dropdown / 자동 list refresh — Q2=A 결정 (freetext)
+- `ollama pull` 자동 안내 — over-scope
+- Settings export/import / version migration — over-scope
+- Settings 변경 history / undo — over-scope
+- Settings UI 안에 model healthCheck 결과 시각화 (loading spinner 등) — minimal toast 만
+- `ollama_settings_changed` telemetry — privacy invariant 보호 (v0.2.4 검토 시 count-only)
+- Settings 변경 로그 파일 — env-debug 영역, v0.2.4 검토
+
+## 8. Gates (roadmap §3.1)
+
+- typecheck 0
+- 단위 403 → 413 (+10)
+- e2e 1/1 (smoke 회귀 X)
+- backward compat: settings.json 없는 부팅 → env var → default 폴백 정상
+- cross-platform: SettingsService.test 가 `app.getPath` mock 으로 Win/macOS/Linux 시뮬레이션 (별도 case 또는 path matrix)
+
+## 9. Roadmap relation
+
+- v0.2.3 dogfood unblock 패치. 정식 v0.2.3 cut (#1~#7) 와 별개 patch
+- 머지 후 v0.2.3.1 binary 재빌드 + Gitea release (existing `v0.2.3` tag → `v0.2.3.1` 신규 tag, release 별도)
+- ≥1주 dogfood soak 후 telemetry export + 신규 피드백 + v0.2.4 backlog 38건 일괄 triage → v0.2.4 brainstorm
--- a/docs/superpowers/specs/2026-05-05-v024-patch-cleanup-design.md
+++ b/docs/superpowers/specs/2026-05-05-v024-patch-cleanup-design.md
@@ -0,0 +1,54 @@
+# v0.2.4 Patch Cleanup — Design Spec (Brief)
+
+> 작성: 2026-05-05 · 0.2.3.1 semver 위반 (`X.Y.Z.W` 4-part) → 0.2.4 minor bump 이용해 backlog 의 simple cleanup 5건 + 사용자 가치 1건 합쳐서 묶음 cut. v0.2.4 정식 brainstorm 은 v0.2.5 로 이동.
+
+## 1. Goal
+
+PR #21 머지 후 0.2.3.1 binary 빌드 시도가 electron-builder 의 semver validation 으로 실패. 0.2.4 minor bump 으로 우회. 이번 cut 에는 dogfood unblock 외 backlog 의 risk 낮은 cleanup + 사용자 가치 항목 동봉.
+
+## 2. Scope (5 backlog 항목 + version bump)
+
+| backlog # | 항목 | 가치 | 작업량 |
+|---|---|---|---|
+| #1 | `TelemetryService.emit` 의 `now()` 2번 호출 → 1번 추출 | cosmetic (KST midnight straddle 이론) | 1줄 |
+| #2 | `DAY_MS = 24*60*60*1000` magic number → 모듈 상단 상수 | cosmetic | 1줄 |
+| #6 | `media.gc.run()` `.catch` 누락 → backup pattern 통일 | consistency | 1줄 |
+| #13 | NoteCard `mode='trash'` 의 `onDeleted` dead-code prop 제거 | API 청소 | 작음 |
+| #44 | 트레이 메뉴 + Inbox footer 에 "Inkling 0.2.4" 버전 정보 | **사용자 dogfood 가치** | 1 task |
+| - | version bump 0.2.3.1 → 0.2.4 | semver 표준 | trivial |
+
+## 3. Out of scope
+
+- **#45 (자동실행 버그)**: Windows registry 디버깅 필요, simple X. 별도 cut.
+- **#3/#4/#26 (KST 통합 / TrayCallbacks refactor)**: multi-file, 크다. 별도.
+- **#5/#22 (Union 통합 / hydrate cleanup)**: repo-wide.
+- **#39~#43 (PR #21 deferred)**: telemetry masking 등 의미 있는 결정 필요. v0.2.5 brainstorm 영역.
+- 기타 backlog 39건.
+
+## 4. Architecture changes
+
+본 cut 은 의미 있는 architecture 변경 없음. 기존 pattern 강화만:
+- `TelemetryService.emit` 의 atomic timestamp 보장 (now() 1회)
+- 모듈 상단 magic number 상수화 패턴 (다른 파일은 이미 그 패턴, TelemetryService 만 예외)
+- `.catch` consistency (backup.runDaily / telemetry.cleanupOldFiles 와 동일 wrapper)
+- React props 청소 (현재 호출되지 않는 prop 제거)
+- 신규 surface: 트레이 메뉴 "Inkling 정보..." → modal 또는 dialog
+
+## 5. Tests
+
+테스트 추가 없음 (모두 cosmetic / refactor). 기존 단위 413/413 회귀 X 확인만.
+
+#44 의 modal 은 컴포넌트 단위 테스트 X (Inkling 패턴 — store-only).
+
+## 6. Gates
+
+- typecheck 0
+- 단위 413/413 (회귀 X)
+- e2e 1/1
+- backward compat: 기존 사용자 영향 0 (cosmetic + 새 surface)
+
+## 7. Roadmap relation
+
+- 0.2.3 cut 7/7 (PR #13~#19) + 0.2.3.1 patch (PR #21) 누적 후 binary 빌드를 위한 v0.2.4 minor bump
+- v0.2.5 brainstorm 트리거: dogfood ≥1주 soak + telemetry export + backlog 39건 (=45-5-1) + 신규 피드백 일괄 triage
+- backlog 명명 `v024-backlog.md` → 본 cut 후 `v025-backlog.md` 로 rename 검토 (또는 v024-backlog.md 유지하고 내용만 갱신)
--- a/docs/superpowers/v024-backlog.md
+++ b/docs/superpowers/v024-backlog.md
@@ -0,0 +1,162 @@
+# v0.2.4 Backlog
+
+> v0.2.3 cut (7항목 / PR #13~#19) 동안 final reviewer + PR review round 1 에서 발견된 minor / nit 중 의도적으로 deferred 한 항목 누적. v0.2.3 dogfood soak 후 신규 피드백 + 본 리스트 일괄 triage → v0.2.4 cut 결정.
+
+**누적 시작일:** 2026-05-01 (#7 telemetry skeleton 머지 시점)
+**최종 갱신:** 2026-05-05 (v0.2.4 patch cut — backlog 5건 처리)
+**총 항목 수:** 45 (잔여 39 = 45 − [#1 stale + #2/#6/#13/#44/#45 본 cut 처리 5건] 단 #45 는 별도 cut, 아래 표 참조)
+
+## 처리 이력
+
+| 항목 | 상태 | Cut |
+|---|---|---|
+| #1 (`now()` 2번 호출) | 이미 fix (PR #13 round 1 — backlog stale) | - |
+| #2 (`DAY_MS` magic) | ✅ 처리 | v0.2.4 patch (commit `ef5d3da`) |
+| #6 (`media.gc.run()` `.catch`) | ✅ 처리 | v0.2.4 patch (commit `ef5d3da`) |
+| #13 (NoteCard `onDeleted` dead-code) | ✅ 처리 | v0.2.4 patch (commit `c87c248`) |
+| #44 (버전 정보 surface) | ✅ 처리 (트레이 "Inkling 정보..." + native dialog) | v0.2.4 patch (commit `d3dfe1e`) |
+| #45 (자동실행 풀림 버그) | 별도 cut 예정 (Windows registry 디버깅) | TBD |
+
+**잔여 39건.** v0.2.5 brainstorm 시 신규 dogfood 피드백 + 잔여 39건 일괄 triage.
+
+## Defer 사유 카테고리
+
+각 항목은 머지 전 inline fix 보다 v0.2.4 영역으로 미룬 명시적 사유 가짐:
+
+1. **Cross-cutting refactor** — 한 PR 안에서 부분만 고치면 inconsistency. 일괄 cleanup task 영역. (예: KST helper 4 callsite 통합, `createTray` positional callbacks 전체 객체화)
+2. **Data-dependent** — dogfood telemetry 분포 보고 결정해야 의미. (예: top-N 튜닝, recall_shown lifetime dedup 정책)
+3. **Cosmetic / style** — 동작 영향 0, 다른 일괄 cleanup task. (예: `now()` 두 번 호출, `as any[]` 통합)
+
+## How to apply
+
+v0.2.4 brainstorm 시 본 리스트를 1차 backlog 로 사용. 항목별로:
+
+- (a) 그대로 cleanup
+- (b) #4~#6 영향 받아 변형
+- (c) defer-further 결정
+- (d) drop (만에 하나 outdated)
+
+## v0.2.3 #7 Telemetry skeleton 누적 (2026-05-01)
+
+1. **`now()` 두 번 호출** — `TelemetryService.emit` (`src/main/services/TelemetryService.ts:58, :60`) 가 같은 emit 안에서 `this.now()` 두 번. 이론적 midnight straddle 가능 (ts vs filePath 다른 KST 일자), 실제 영향 cosmetic. cleanup: `const nowDate = this.now()` 한 번 추출.
+
+2. **`DAY_MS = 24*60*60*1000` magic number** — `cleanupOldFiles:39` + `readAllRecent:78` (+ `KST_OFFSET_MS` 간접). 모듈 상단에 `const DAY_MS = 24 * 60 * 60 * 1000;` 추출.
+
+3. **KST helper duplication** — `TelemetryService.todayKstIso` + `telemetryStats.kstDate` + `AiWorker.todayKstAsDate`/`todayKstAsIso`. 4번째 caller (예: 회상 schedule, 만료 batching) 등장 시 `src/main/util/kst.ts` 로 통합.
+
+4. **`createTray` positional 폭주** — `tray.ts:51` 가 7 positional callbacks. #1 ollama 회복 / #4 휴지통 비우기 등 트레이 메뉴 추가 시 8+ 도달 → readability threshold 넘김. `TrayCallbacks` object 로 refactor.
+
+5. **`AiFailedReason` union 3 곳 중복** — `'unreachable' | 'schema' | 'timeout' | 'other'` 가 `telemetryEvents.ts:15` (zod), `TelemetryService.ts:21` (EmitInput), `AiWorker.ts:19, :34` (classifier + emitter) 에 분산. `export type AiFailedReason` 하나로 통합. (단 zod enum + TS literal 의 inherent dual-define 은 어쩔 수 없음 — `z.infer` 통해 type 파생만)
+
+6. **`media.gc.run()` 의 `.catch` 누락** — T11 에서 `telemetry.cleanupOldFiles` 의 `.catch` 일관성 처리 시 `media.gc` 도 같은 패턴 (`.catch` 없음) 발견. `backup.runDaily()` 와 컨벤션 통일 위해 `.catch((e) => logger.warn('media.gc.failed', { reason: String(e) }))` 추가.
+
+7. **stats.md 의 reason 분포 미포함** — `telemetryStats.aggregateStats` 가 AI 성공률만 계산, `ai_failed.payload.reason` 의 분포 (unreachable/schema/timeout/other counts) 는 미집계. roadmap §6.2 의 "Ollama unreachable 빈도?" 질문이 부분적으로만 답해짐. v0.2.3 dogfood 후 실제 reason 분포 보고 결정.
+
+## v0.2.3 #4 휴지통 누적 (2026-05-01)
+
+8. **stats.md exhaustiveness check** — `telemetryStats.aggregateStats` 의 7-arm if/else if 가 union 확장 시 silent fall-through. `else { const _: never = ev; }` 추가로 컴파일 단계 가드.
+
+9. **휴지통 회수율 ratio 의미 코멘트** — `restore / trash` 가 event-level ratio (한 노트 trash-restore 반복 시 100% 가능). spec §6.2 의 "회수 도구 동작?" 질문에는 충분, 단 unique-note 회수율로 오해할 여지. 코드 옆 1줄 코멘트.
+
+10. **`restore` 시 AI 결과 보존 + pending_jobs 미재생성** — restore 가 `deleted_at = NULL` 만, pending_jobs 안 재생성. 사용자가 trash 도중 AI fail 한 노트를 restore 시 재처리 경로 부재. v0.2.3 dogfood 에서 빈도 보고 결정 — drop / per-note retry 버튼 / 자동 재처리 중.
+
+11. **`restoreNote(id)` precondition 노출** — store 의 낙관적 갱신이 `trashNotes` 에 노트가 있어야 동작. 명령 팔레트 / 프로그래밍 호출 케이스 시 silently no-op. 현재는 trash view 한정이라 OK. main 이 trash/restore 시 `pushNoteUpdated` 보내도록 변경하면 더 견고.
+
+12. **`inbox:trashCount` cap 200 silent undercount** — UI 만 200 cap, `repo.emptyTrash()` SQL 은 unbounded. 350 노트 trash 시 dialog "200개 영구 삭제" 표시되지만 실제 350 모두 삭제. `repo.countTrashed()` 추가로 둘 다 정확히. **(잠재 UX 버그 — pull-forward 후보)**
+
+13. **NoteCard `mode='trash'` 의 `onDeleted` dead-code** — trash 카드는 `onPermanentDelete`/`onRestore` 만 사용. `onDeleted` prop 은 호출되지 않음 (App.tsx 가 pass-through). API 깔끔히 — `onDeleted?` optional + trash 분기 미전달.
+
+14. **탭 ARIA 패턴** — `aria-pressed` 로 toggle 버튼 표현. canonical 은 `role="tab"` + `aria-selected`. screen reader 동작 OK 지만 a11y audit 시 정정 후보.
+
+15. **`inbox:delete` 채널 rename** — semantic 이 hard → soft 인데 채널 이름 그대로. v0.2.4 에서 `inbox:trash` 로 rename 검토 (기존 호출 0건 보장 후).
+
+16. **per-note 영구 삭제 telemetry 사용량** — v0.2.3 dogfood 에서 `permanent_delete` event 빈도 확인. 거의 0 이면 v0.2.4 에서 per-card "영구 삭제" 버튼 제거 + bulk emptyTrash 만 (UX 단순화). 빈번하면 유지.
+
+## v0.2.3 #5 만료 추천 누적 (2026-05-01)
+
+17. **dialog 버튼 순서 vs spec §5.3** — spec 은 `['취소','옮기기'], default=0`, 구현은 `['옮기기','취소'], defaultId=1, cancelId=1` (`inboxApi.ts:117`). 효과 동일 (default = cancel). v0.2.4 에서 spec 또는 impl 한쪽 통일.
+
+18. **`loadExpired()` 미사용** — `loadInitial`/`refreshMeta` 가 inline fetch, App.tsx 도 호출 안 함 (test 만 exercise). v0.2.4 dogfood 후에도 consumer 미발생 시 제거 검토.
+
+19. **store `KST_OFFSET_MS` inline duplication** — `store.ts:166` 의 `snoozeExpired` 가 inline KST 계산. `@main/util/kstDate.ts` 와 동일 알고리즘이지만 alias 경계 (main vs renderer) 로 import 불가. `src/shared/util/kstDate.ts` 로 lift 검토. (#3, #34 와 합산 가능)
+
+20. **telemetry emit `.catch(() => {})` 가 silent** — `CaptureService.listExpired`/`trashExpiredBatch` 가 그대로. v0.2.4 telemetry 하드닝 시 debug log path (project pattern 통일) 추가 검토.
+
+21. **TelemetryService.test.ts 의 noteId 가드 widening** — `e.kind !== 'empty_trash' && e.kind !== 'expired_banner_shown' && e.kind !== 'expired_batch_trash'` 체인이 #6 추가 시 더 길어짐. `hasNoteId(ev)` type predicate helper 추출 검토.
+
+22. **NoteRepository hydrate 의 `as any[]` 일괄 cleanup** — `findExpiredCandidates` round 1 review 의 nit 가 단독 fix 시 다른 hydrate-using methods 와 inconsistency. `db.prepare().all()` 의 row type 을 `Record<string, unknown>[]` 또는 explicit row interface 로 통일하는 repo-wide refactor.
+
+## v0.2.3 #1 ollama 회복 누적 (2026-05-01)
+
+23. **`createTray` 8 positional callbacks** — #1 cut 에서 8개 도달, v0.2.4 backlog #4 와 정합 (TrayCallbacks object refactor 약속). #2 retry 또는 #6 reminder cut 에서 추가 항목 (예: "재시도 N건") 등장 시 9+ 회피 위해 본격 refactor.
+
+24. **Banner CSS 스타일 inline 중복** — ExpiryBanner (`#fff7e6 / #d99500 / #946100` 황색) / OllamaBanner (동) / FailedBanner (`#fce4e4 / #a33` 적색) / RecallBanner (`#e8f0fe / #4a7ec0` 청색) 모두 색상 hardcode. v0.2.4 에서 CSS variables 또는 banner shared component (`<Banner severity="warning|error|info" />`) 추출 검토.
+
+25. **HealthChecker `inFlight` 가드의 manual emit ordering** — manual emit 이 inFlight 체크 전 발생해 user 가 빠르게 N번 클릭하면 N개 manual telemetry. spec 의도 (1:1 보장) 와 정합이지만, 향후 dedup 정책 (예: 1초 윈도우) 으로 변형 가능성. v0.2.4 dogfood soak 결과로 결정.
+
+## v0.2.3 #2 AI retry 누적 (2026-05-02)
+
+26. **`createTray` 9 positional callbacks** — #2 cut 에서 9개 도달 (refreshTrayFailedCount 포함). #4 `TrayCallbacks` object refactor 가 이제 readability blocker. #3 / #6 cut 어느 쪽이든 추가 callback 더 들어오기 전에 우선 처리.
+
+27. **`refreshTrayFailedCount` exported singleton state** — `tray.ts` 에 `_failedCount` module-scoped state + setter 패턴. 모듈 캡슐화로 작동하지만 multi-window 또는 multi-tray 시 broken. v0.2.4 refactor 시 TrayController class 또는 store-driven 으로 정리.
+
+28. **`AiWorker.unreachableBackoffStep` 단일 카운터 vs job-level** — 모든 job 이 step counter 공유. 1 job timeout → step↑, 다른 job 정상 처리해도 step reset. 현재는 cross-job correlation 없으니 OK 가정 (Ollama daemon 단일이라 모든 job 이 같은 백엔드 의존). multi-provider 가 들어오면 provider-level step 으로 분리 필요.
+
+## v0.2.3 #3 태그 vocab 누적 (2026-05-02)
+
+29. **`getTopUsedTags(20)` magic number** — `AiWorker.processJob:137` 가 `repo.getTopUsedTags(20)` hardcoded. spec §7 Out 에 "top-N 튜닝" 명시. v0.2.4 dogfood telemetry (`tag_vocab_hit/miss` ratio) 보고 `VOCAB_TOP_N` 모듈 상수 추출 + 튜닝 결정.
+
+30. **`getTopUsedTags` LIMIT-then-filter 의미** — SQL 가 limit 만큼 가져온 후 JS regex 가 후처리 → top-20 안에 한글/공백 태그 섞이면 결과 length < limit. dogfood 규모 OK 가정 + 테스트 lock-in (v0.2.3 round 1 m2 fix). v0.2.4 에서 vocab pool 확장 시 SQL `GLOB` 으로 SQL-side 필터 대안 검토 (또는 `LIMIT ?*2` overfetch+slice).
+
+31. **`vocabSet` strict-eq vs DB COLLATE NOCASE 불일치** — `vocabSet = new Set(vocab)` 은 JS 대소문자 strict, `tags.name` 은 COLLATE NOCASE. 현재는 kebab-case 필터로 vocab 이 항상 lowercase + AI prompt 도 lowercase 강제라 충돌 없지만, vocab pool 확장 시 (예: `'Design'` 사용자 직접 추가) `getTagIdByName('Design')` 은 매치하지만 `vocabSet.has('Design')` 은 miss → tagId 없는 hit 가 silently skip. v0.2.4 에서 `vocabSet = new Set(vocab.map(v => v.toLowerCase()))` + `vocabSet.has(tagName.toLowerCase())` 로 normalize 검토.
+
+32. **AiWorker per-tag emit serial await** — `for (const tag of new Set(...))` 안의 `await this.telemetry.emit(...)` 가 직렬. 3 태그 시 file-append 3 round-trip. `Promise.all` 로 병렬화 가능, 단 `ai_succeeded` emit 도 serial 이라 패턴 일관성 우선 skip. v0.2.4 telemetry 하드닝 시 일괄 변경 검토.
+
+33. **`PROMPT_VERSION` telemetry payload 미포함** — v0.2.3 cut 에선 단일 버전 (4) 만 굴러가서 무의미. v0.2.4/v0.2.5 prompt 튜닝 후 어느 버전이 어떤 hit-rate 만든지 추적 시 `tag_vocab_hit/miss` payload 에 `promptVersion` 추가 검토. spec §7 Out 명시.
+
+## v0.2.3 #6 RecallBanner 누적 (2026-05-02)
+
+34. **KST midnight inline calc 4번째 복제** — `store.ts` 의 `snoozeRecall` (#6) + `snoozeExpired` (#5) + `NoteCard.todayKstIso` + 다른 1곳, 그리고 `kstDate.ts` util 도 별도 존재. 4 callsite 모두 동일 알고리즘. v0.2.4 에서 `nextKstMidnightMs()` / `kstTodayIso()` 단일 util 통합 + alias 경계 (main vs renderer) 해결책. backlog #3, #19 와 합산.
+
+35. **`recall_shown` per-banner-lifetime emit 보장** — useState→useRef 로 race 차단했지만 RecallBanner 컴포넌트 unmount/remount 시 reset. 사용자가 페이지 이동 후 돌아오면 같은 노트가 재emit 가능. v0.2.4 dogfood telemetry 에서 동일 noteId 의 `recall_shown` 빈도 보고 결정 (per-noteId 24h dedup 또는 per-noteId 영속 마커).
+
+36. **`emitRecallShown` / `emitRecallSnoozed` 가 fire-and-forget 인데 `ipcMain.handle` 사용** — 더 honest 한 패턴은 `ipcMain.on` (return value 없음). 현재는 다른 IPC 와 패턴 일관성 우선. v0.2.4 IPC 정리 시 `handle` vs `on` 구분 일괄 검토.
+
+37. **NoteCard `id="note-${id}"` load-bearing** — RecallBanner 의 `scrollIntoView` target. 단순 DOM lookup 이라 shadow DOM / portal 미지원. v0.2.4 에서 다른 surface (예: 검색 결과에서 스크롤) 등장 시 ref-forwarding 패턴 검토.
+
+## v0.2.3.1 Ollama Settings 누적 (2026-05-04)
+
+39. **`ollama_unreachable.reason` 에 endpoint URL 노출 (PII 우회)** — `LocalOllamaProvider.healthCheck` 가 catch err 시 `reason: \`unreachable: ${err.message}\`` 로 emit. `err.message` 안에 `http://192.168.x.x:11434/api/tags` 같은 LAN endpoint URL 포함 가능. v0.2.3.1 의 in-app endpoint UI 가 LAN 사용을 흔하게 만들어 PII 우회 노출 경로 확대. v0.2.4 telemetry 하드닝 시: error class only (network/dns/timeout/...) 또는 host 마스킹 (`<host>:11434`) 정책. PR #21 round 1 m2 deferred.
+
+40. **Settings 저장 vs HealthChecker 60s tick race** — `saveOllamaSettings` IPC 가 `health.runOnce()` 호출, 동시에 60s 주기 tick 도 `inFlight` 가드 통해 같이 실행 시도. 정확성 영향 0 (가드로 dedup), 단 modal 닫기 직전 banner flicker 가능. PR #21 round 1 i1 acknowledge only. v0.2.4 dogfood 에서 실제 빈도 확인 후 결정 (visible 빈도 낮으면 무시).
+
+41. **`OllamaSettingsModal` 인라인 스타일** — 60+ 줄 inline style. backlog #24 (banner CSS 추출) 와 합산. v0.2.4 에서 CSS module / theme variables 추출 시 함께.
+
+42. **Modal 의 client-side URL validation 부재** — endpoint freetext 가 잘못된 형식 (예: 빈 문자열, 한글) 일 때 server-side healthCheck 만 검증. zod URL error message 가 opaque ("Invalid url"). v0.2.4 에서 client-side z.string().url() pre-check + 친화적 에러 메시지.
+
+43. **`createTray` 10번째 positional callback** — v0.2.3.1 cut 에서 10개 도달 (`runOpenOllamaSettings` 추가). backlog #4/#26 (TrayCallbacks object refactor) blocker 수준. v0.2.4 첫 cleanup 항목 후보.
+
+## v0.2.3 / v0.2.3.1 dogfood 발견 (2026-05-05)
+
+> 본 cut 들의 머지 후 사용자가 dogfood 중 발견한 항목. PR review deferred 와 달리 raw UX/bug 발견.
+
+44. **버전 및 프로그램 정보 표시 방법 부재** — 현재 사용자가 설치된 Inkling 의 버전 (package.json `0.2.3.1`) 을 UI 에서 확인할 path 없음. 트레이 메뉴 / Inbox 푸터 / 별도 "About Inkling" 모달 어느 surface 에도 정보 없음. 핸드오프 후 다른 머신에서 같은 버전인지 사용자가 직접 검증 불가. v0.2.4 에서 트레이 메뉴 "Inkling 0.2.3.1 정보..." 또는 Inbox 우하단 footer 형태로 추가 검토. 곁들여: 빌드 commit SHA, electron/node 버전, OS, profileDir 경로 등 디버그 정보 노출 (사용자가 issue report 시 첨부 가능).
+
+45. **윈도우 자동 실행 옵션이 재시작 후 풀려있는 버그** — 트레이 메뉴 "윈도우 시작 시 자동 실행" 체크 → 종료 → 재실행 시 체크박스가 풀려서 표시됨. 코드 (`src/main/tray.ts:47-58`) 가 `app.setLoginItemSettings({ openAtLogin, args: ['--hidden'] })` 호출 후 다음 부팅 시 `app.getLoginItemSettings().openAtLogin` 이 false 반환. 추정 원인:
+    - (a) Windows registry 에 쓴 exe path 와 현재 프로세스 path 가 다름 (NSIS 설치 위치 변경 / 버전 업데이트 시 새 디렉터리)
+    - (b) Electron `setLoginItemSettings` Windows 구현 의 path canonicalization 이슈
+    - (c) 우리 `args: ['--hidden']` 와 actual launch 시 args 비교 mismatch
+    - 영향: dogfood UX 핵심 마찰 — autostart 가 핸드오프 시 매번 수동 재설정 필요. 자동 실행 의도 자체가 dogfood "잊지 않고 매일 사용" 목적인데 깨짐.
+    - v0.2.4 에서 우선순위 높음. 진단 절차: (1) `app.getLoginItemSettings({ args: ['--hidden'] })` 형태로 args 전달해 비교 정확도 올리기, (2) registry 직접 inspect (`HKCU\Software\Microsoft\Windows\CurrentVersion\Run\inkling`) 로 path/args 확인, (3) executable path canonicalization (electron 이 short path 변환 적용 여부).
+
+## post-cut next-step (status, not backlog)
+
+38. **v0.2.3 cut 7/7 완료 → binary 빌드 단계** — slice §7 strict-pin patch 증분으로 v0.2.3 binary 빌드 + dogfood 핸드오프. ≥1주 soak 후 telemetry export 분석으로 v0.2.4 brainstorm 트리거. (✓ 2026-05-02 빌드 완료, hotfix #20 + publish:null 포함, release 재생성 완료)
+
+## v0.2.3 cut 후 final reviewer 가 칭찬한 부분
+
+- 2-layer privacy invariant (zod outer + payload `.strict()`) 가 강한 defense
+- KST 처리 일관성 — 4 callsites 동일 패턴
+- backward compat — 기존 13 테스트 (Capture 4 + AiWorker 9) 무수정 통과
+- 신규 dep 0 (zip 회피로 폴더 + 2 file 정책)
+- TelemetryService surface 가 깔끔한 foundation — 다음 항목들이 (a) zod schema 추가, (b) EmitInput arm 추가, (c) emit 호출만 하면 됨
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
  "name": "inkling",
-  "version": "0.2.3",
+  "version": "0.2.4",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "inkling",
-      "version": "0.2.3",
+      "version": "0.2.4",
      "dependencies": {
        "better-sqlite3": "12.9.0",
        "electron-log": "5.2.0",
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "inkling",
-  "version": "0.2.3",
+  "version": "0.2.4",
  "private": true,
  "description": "Inkling — local-first 한 줄 보관 도구",
  "author": "altair823 <dlsrks0734@gmail.com>",
--- a/src/main/ai/AiWorker.ts
+++ b/src/main/ai/AiWorker.ts
@@ -1,6 +1,6 @@
 import type { NoteRepository } from '../repository/NoteRepository.js';
-import type { InferenceProvider } from './InferenceProvider.js';
 import type { Note } from '@shared/types';
+import { ProviderHolder } from './ProviderHolder.js';
 import { parseAllCandidates } from '../services/dueDateParser.js';
 import { ZodError } from 'zod';

@@ -66,7 +66,7 @@ export class AiWorker {

  constructor(
    private repo: NoteRepository,
-    private provider: InferenceProvider,
+    private holder: ProviderHolder,
    opts: AiWorkerOptions = {}
  ) {
    this.backoffsMs = opts.backoffsMs ?? [0, 30_000, 120_000];
@@ -135,7 +135,7 @@ export class AiWorker {
        const todayIso = todayKstAsIso(nowDate);
        const candidates = parseAllCandidates(note.rawText, todayDate);
        const vocab = this.repo.getTopUsedTags(20);
-        const res = await this.provider.generate({
+        const res = await this.holder.get().generate({
          text: note.rawText,
          todayKst: todayIso,
          dueDateCandidates: candidates,
@@ -146,7 +146,7 @@ export class AiWorker {
          title: res.title,
          summary: res.summary,
          tags: res.tags,
-          provider: this.provider.name,
+          provider: this.holder.get().name,
          dueDate: res.dueDate ?? null
        });
        this.unreachableBackoffStep = 0;  // 성공 시 step reset
--- a/src/main/ai/InferenceProvider.ts
+++ b/src/main/ai/InferenceProvider.ts
@@ -14,4 +14,6 @@ export interface InferenceProvider {
  readonly name: string;
  generate(input: GenerateInput): Promise<AiResponse>;
  healthCheck(): Promise<HealthResult>;
+  /** v0.2.3.1 — 외부에서 in-flight generate 강제 중단. ProviderHolder.replace 시 사용. */
+  abort?: () => void;
 }
--- a/src/main/ai/LocalOllamaProvider.ts
+++ b/src/main/ai/LocalOllamaProvider.ts
@@ -2,6 +2,7 @@ import { request } from 'undici';
 import { parseAiResponse, type AiResponse } from './schema.js';
 import { buildPrompt } from './prompt.js';
 import type { GenerateInput, HealthResult, InferenceProvider } from './InferenceProvider.js';
+import { DEFAULT_OLLAMA_ENDPOINT, DEFAULT_OLLAMA_MODEL } from '../../shared/constants.js';

 export interface LocalOllamaOptions {
  endpoint?: string;
@@ -18,10 +19,11 @@ export class LocalOllamaProvider implements InferenceProvider {
  private timeoutMs: number;
  private temperature: number;
  private numPredict: number;
+  private abortController: AbortController | null = null;

  constructor(opts: LocalOllamaOptions = {}) {
-    this.endpoint = opts.endpoint ?? 'http://localhost:11434';
-    this.model = opts.model ?? 'gemma4:e4b';
+    this.endpoint = opts.endpoint ?? DEFAULT_OLLAMA_ENDPOINT;
+    this.model = opts.model ?? DEFAULT_OLLAMA_MODEL;
    this.timeoutMs = opts.timeoutMs ?? 120_000;
    this.temperature = opts.temperature ?? 0.2;
    this.numPredict = opts.numPredict ?? 512;
@@ -29,8 +31,8 @@ export class LocalOllamaProvider implements InferenceProvider {
  }

  async generate(input: GenerateInput): Promise<AiResponse> {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    this.abortController = new AbortController();
+    const timer = setTimeout(() => this.abortController?.abort(), this.timeoutMs);
    try {
      const res = await request(`${this.endpoint}/api/generate`, {
        method: 'POST',
@@ -42,7 +44,7 @@ export class LocalOllamaProvider implements InferenceProvider {
          stream: false,
          options: { temperature: this.temperature, num_predict: this.numPredict }
        }),
-        signal: controller.signal
+        signal: this.abortController.signal
      });
      if (res.statusCode < 200 || res.statusCode >= 300) {
        throw new Error(`ollama http ${res.statusCode}`);
@@ -55,9 +57,15 @@ export class LocalOllamaProvider implements InferenceProvider {
      return parseAiResponse(parsed);
    } finally {
      clearTimeout(timer);
+      this.abortController = null;
    }
  }

+  /** v0.2.3.1 — 외부에서 in-flight generate 강제 중단. ProviderHolder.replace 시 사용. */
+  abort(): void {
+    this.abortController?.abort();
+  }
+
  async healthCheck(): Promise<HealthResult> {
    try {
      const res = await request(`${this.endpoint}/api/tags`, { method: 'GET' });
--- a/src/main/ai/ProviderHolder.ts
+++ b/src/main/ai/ProviderHolder.ts
@@ -0,0 +1,36 @@
+import type { InferenceProvider } from './InferenceProvider.js';
+
+/**
+ * v0.2.3.1 — Mutable provider holder. AiWorker / HealthChecker 가 endpoint 변경 시
+ * 새 LocalOllamaProvider 인스턴스를 받도록 indirection layer.
+ *
+ * 사용 패턴:
+ *   const holder = new ProviderHolder(initialProvider);
+ *   aiWorker = new AiWorker(repo, holder, opts);
+ *   health = new HealthChecker(holder, opts);
+ *
+ *   // 사용자가 Settings 저장 시:
+ *   holder.get().abort?.();       // in-flight 중단 (LocalOllamaProvider 전용)
+ *   holder.replace(newProvider);  // 모든 consumer 가 새 인스턴스 사용
+ */
+export class ProviderHolder {
+  private current: InferenceProvider;
+  private listeners: Array<(p: InferenceProvider) => void> = [];
+
+  constructor(initial: InferenceProvider) {
+    this.current = initial;
+  }
+
+  get(): InferenceProvider {
+    return this.current;
+  }
+
+  replace(next: InferenceProvider): void {
+    this.current = next;
+    for (const fn of this.listeners) fn(next);
+  }
+
+  onReplace(fn: (p: InferenceProvider) => void): void {
+    this.listeners.push(fn);
+  }
+}
--- a/src/main/index.ts
+++ b/src/main/index.ts
@@ -15,6 +15,7 @@ import { HotkeyService } from './services/HotkeyService.js';
 import { IntentService } from './services/IntentService.js';
 import { HealthChecker } from './services/HealthChecker.js';
 import { LocalOllamaProvider } from './ai/LocalOllamaProvider.js';
+import { ProviderHolder } from './ai/ProviderHolder.js';
 import { AiWorker } from './ai/AiWorker.js';
 import { registerCaptureApi } from './ipc/captureApi.js';
 import { registerInboxApi, pushNoteUpdated, pushOllamaStatus } from './ipc/inboxApi.js';
@@ -29,6 +30,8 @@ import { ExportService } from './services/ExportService.js';
 import { ImportService } from './services/ImportService.js';
 import { SyncService } from './services/SyncService.js';
 import { TelemetryService } from './services/TelemetryService.js';
+import { SettingsService } from './services/SettingsService.js';
+import { DEFAULT_OLLAMA_ENDPOINT, DEFAULT_OLLAMA_MODEL } from '../shared/constants.js';

 const HIDDEN_ARG = '--hidden';
 const startedHidden = process.argv.includes(HIDDEN_ARG);
@@ -63,13 +66,25 @@ app.whenReady().then(async () => {
  const continuity = new ContinuityService(db);
  const intent = new IntentService(repo);

-  const resolvedEndpoint = process.env.INKLING_OLLAMA_ENDPOINT ?? 'http://localhost:11434';
+  const settingsSvc = new SettingsService(paths.profileDir);
+  const settings = await settingsSvc.load();
+
+  const resolvedEndpoint = settings.ollama?.endpoint
+                         ?? process.env.INKLING_OLLAMA_ENDPOINT
+                         ?? DEFAULT_OLLAMA_ENDPOINT;
+  const resolvedModel = settings.ollama?.model ?? DEFAULT_OLLAMA_MODEL;
+
  logger.info('ai.endpoint', {
    endpoint: resolvedEndpoint,
-    fromEnv: process.env.INKLING_OLLAMA_ENDPOINT !== undefined
+    model: resolvedModel,
+    source: settings.ollama?.endpoint
+      ? 'settings'
+      : (process.env.INKLING_OLLAMA_ENDPOINT ? 'env' : 'default')
  });
-  const provider = new LocalOllamaProvider({ endpoint: resolvedEndpoint });
-  const health = new HealthChecker(provider, {
+
+  const provider = new LocalOllamaProvider({ endpoint: resolvedEndpoint, model: resolvedModel });
+  const providerHolder = new ProviderHolder(provider);
+  const health = new HealthChecker(providerHolder, {
    onUpdate: (status) => {
      logger.info('ai.health', { ...status } as Record<string, unknown>);
      pushOllamaStatus(getInboxWindow, status);
@@ -87,7 +102,7 @@ app.whenReady().then(async () => {
  });
  health.start();

-  const worker = new AiWorker(repo, provider, {
+  const worker = new AiWorker(repo, providerHolder, {
    onUpdate: (note) => {
      pushNoteUpdated(getInboxWindow, note);
      // F4-C: AI 처리 완료 = 새 캡처가 inbox 에 합류한 시점, tray 도 즉시 갱신.
@@ -114,7 +129,7 @@ app.whenReady().then(async () => {
  registerCaptureApi(capture, getQuickCaptureWindow);
  registerInboxApi({
    repo, continuity, capture, health, intent,
-    getInboxWindow
+    getInboxWindow, settings: settingsSvc, providerHolder
  });

  const hotkeys = new HotkeyService();
@@ -131,7 +146,9 @@ app.whenReady().then(async () => {
  await worker.loadFromDb();

  const gc = new MediaGc(db, store);
-  void gc.run().then((r) => logger.info('media.gc', { ...r } as Record<string, unknown>));
+  void gc.run()
+    .then((r) => logger.info('media.gc', { ...r } as Record<string, unknown>))
+    .catch((e) => logger.warn('media.gc.failed', { reason: String(e) }));

  const exportSvc = new ExportService(repo, store);
  const importSvc = new ImportService(repo, store);
@@ -345,7 +362,11 @@ app.whenReady().then(async () => {
      }
    },
    /* runOllamaRecheck */ () => { void health.runOnce({ manual: true }); },
-    /* runRetryAllFailed */ () => { void capture.retryAllFailed(); }
+    /* runRetryAllFailed */ () => { void capture.retryAllFailed(); },
+    /* runOpenOllamaSettings */ () => {
+      const win = getInboxWindow();
+      if (win) win.webContents.send('inbox:openOllamaSettings');
+    }
  );

  // F4-C 환경 앵커 — tray tooltip + 메뉴 첫 항목을 오늘 KST 캡처 수로 갱신.
--- a/src/main/ipc/inboxApi.ts
+++ b/src/main/ipc/inboxApi.ts
@@ -8,6 +8,9 @@ import type { HealthChecker } from '../services/HealthChecker.js';
 import type { IntentService } from '../services/IntentService.js';
 import type { Note } from '@shared/types';
 import type { HealthResult } from '../ai/InferenceProvider.js';
+import { LocalOllamaProvider } from '../ai/LocalOllamaProvider.js';
+import type { SettingsService } from '../services/SettingsService.js';
+import type { ProviderHolder } from '../ai/ProviderHolder.js';

 export interface InboxIpcDeps {
  repo: NoteRepository;
@@ -16,6 +19,8 @@ export interface InboxIpcDeps {
  health: HealthChecker;
  intent: IntentService;
  getInboxWindow: () => BrowserWindow | null;
+  settings: SettingsService;
+  providerHolder: ProviderHolder;
 }

 export function registerInboxApi(deps: InboxIpcDeps): void {
@@ -142,6 +147,28 @@ export function registerInboxApi(deps: InboxIpcDeps): void {
  ipcMain.handle('inbox:dismissRecall', (_e, id: string) => deps.capture.dismissRecall(id));
  ipcMain.handle('inbox:emitRecallShown', (_e, id: string) => deps.capture.emitRecallShown(id));
  ipcMain.handle('inbox:emitRecallSnoozed', (_e, id: string) => deps.capture.emitRecallSnoozed(id));
+
+  ipcMain.handle('inbox:loadOllamaSettings', async () => {
+    const s = await deps.settings.load();
+    return s.ollama ?? null;
+  });
+
+  ipcMain.handle('inbox:saveOllamaSettings', async (_e, value: { endpoint: string; model: string }) => {
+    // 검증: 새 인스턴스로 healthCheck
+    const trial = new LocalOllamaProvider({ endpoint: value.endpoint, model: value.model });
+    const r = await trial.healthCheck();
+    if (!r.ok) return { ok: false, reason: r.reason ?? 'unknown' };
+    try {
+      await deps.settings.setOllama(value);
+    } catch (e) {
+      return { ok: false, reason: `persist failed: ${(e as Error).message}` };
+    }
+    deps.providerHolder.get().abort?.();
+    deps.providerHolder.replace(trial);
+    // 즉시 health 재확인 → onUpdate callback 통해 OllamaBanner 자동 갱신
+    await deps.health.runOnce();
+    return { ok: true };
+  });
 }

 export function pushNoteUpdated(getWin: () => BrowserWindow | null, note: Note): void {
--- a/src/main/services/HealthChecker.ts
+++ b/src/main/services/HealthChecker.ts
@@ -1,4 +1,5 @@
-import type { InferenceProvider, HealthResult } from '../ai/InferenceProvider.js';
+import type { HealthResult } from '../ai/InferenceProvider.js';
+import { ProviderHolder } from '../ai/ProviderHolder.js';

 export type HealthTelemetryEvent =
  | { kind: 'ollama_unreachable'; reason: string }
@@ -28,7 +29,7 @@ export class HealthChecker {
  private now: () => number;

  constructor(
-    private provider: InferenceProvider,
+    private holder: ProviderHolder,
    private opts: HealthCheckerOptions = {}
  ) {
    this.intervalMs = opts.intervalMs ?? DEFAULT_INTERVAL_MS;
@@ -48,7 +49,7 @@ export class HealthChecker {
  }

  private async doRunOnce(): Promise<HealthResult> {
-    const next = await this.provider.healthCheck();
+    const next = await this.holder.get().healthCheck();
    const prev = this.last;
    const okChanged = prev.ok !== next.ok;
    const reasonChanged = prev.reason !== next.reason;
--- a/src/main/services/SettingsService.ts
+++ b/src/main/services/SettingsService.ts
@@ -0,0 +1,47 @@
+import { readFile, writeFile, mkdir, rename } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { z } from 'zod';
+
+const OllamaSettingsSchema = z.object({
+  endpoint: z.string().url(),
+  model: z.string().min(1)
+}).strict();
+
+const SettingsSchema = z.object({
+  ollama: OllamaSettingsSchema.optional()
+}).strict();
+
+export type Settings = z.infer<typeof SettingsSchema>;
+export type OllamaSettings = z.infer<typeof OllamaSettingsSchema>;
+
+export class SettingsService {
+  private filePath: string;
+  private cache: Settings | null = null;
+
+  constructor(profileDir: string) {
+    this.filePath = join(profileDir, 'settings.json');
+  }
+
+  async load(): Promise<Settings> {
+    if (this.cache !== null) return this.cache;
+    try {
+      const raw = await readFile(this.filePath, 'utf8');
+      const parsed = JSON.parse(raw);
+      this.cache = SettingsSchema.parse(parsed);
+    } catch {
+      this.cache = {};
+    }
+    return this.cache;
+  }
+
+  async setOllama(value: OllamaSettings): Promise<void> {
+    const validated = OllamaSettingsSchema.parse(value);
+    const current = await this.load();
+    const next: Settings = { ...current, ollama: validated };
+    await mkdir(dirname(this.filePath), { recursive: true });
+    const tmpPath = this.filePath + '.tmp';
+    await writeFile(tmpPath, JSON.stringify(next, null, 2), 'utf8');
+    await rename(tmpPath, this.filePath);
+    this.cache = next;
+  }
+}
--- a/src/main/services/TelemetryService.ts
+++ b/src/main/services/TelemetryService.ts
@@ -4,6 +4,7 @@ import { validateEvent, TelemetryEvent } from './telemetryEvents.js';
 import { aggregateStats } from './telemetryStats.js';

 const KST_OFFSET_MS = 9 * 60 * 60 * 1000;
+const DAY_MS = 24 * 60 * 60 * 1000;

 function todayKstIso(now: Date): string {
  const k = new Date(now.getTime() + KST_OFFSET_MS);
@@ -52,7 +53,7 @@ export class TelemetryService {
    } catch {
      return { removed };
    }
-    const cutoff = new Date(this.now().getTime() - this.retentionDays * 24 * 60 * 60 * 1000);
+    const cutoff = new Date(this.now().getTime() - this.retentionDays * DAY_MS);
    const cutoffIso = todayKstIso(cutoff);  // KST 일자 비교
    for (const name of entries) {
      const m = /^events-(\d{4}-\d{2}-\d{2})\.jsonl$/.exec(name);
@@ -94,7 +95,7 @@ export class TelemetryService {
    } catch {
      return events;
    }
-    const cutoffMs = this.now().getTime() - this.retentionDays * 24 * 60 * 60 * 1000;
+    const cutoffMs = this.now().getTime() - this.retentionDays * DAY_MS;
    const cutoffIso = todayKstIso(new Date(cutoffMs));
    // 회차 1 review (PR #13) — 매직 슬라이스 `n.slice(7, 17)` 대신 정규식 capture 그룹으로
    // 일자를 추출. prefix 변경 시 정규식 한 곳만 고치면 됨.
--- a/src/main/tray.ts
+++ b/src/main/tray.ts
@@ -1,6 +1,36 @@
 import electron from 'electron';
 import type { Tray as TrayType, MenuItemConstructorOptions } from 'electron';
-const { app, Tray, Menu, nativeImage } = electron;
+import { platform, release, EOL } from 'node:os';
+const { app, Tray, Menu, nativeImage, dialog, shell, clipboard } = electron;
+
+function showAboutDialog(): void {
+  const version = app.getVersion();
+  const electronVersion = process.versions.electron ?? '?';
+  const nodeVersion = process.versions.node ?? '?';
+  const profileDir = app.getPath('userData');
+  // OS EOL 사용 — 클립보드 → Notepad 등에서 줄바꿈 정상.
+  const detail = [
+    `버전: ${version}`,
+    `Electron: ${electronVersion}`,
+    `Node: ${nodeVersion}`,
+    `OS: ${platform()} ${release()}`,
+    `데이터 위치: ${profileDir}`
+  ].join(EOL);
+  void dialog.showMessageBox({
+    type: 'info',
+    title: 'Inkling 정보',
+    message: `Inkling ${version}`,
+    detail,
+    buttons: ['확인', '데이터 위치 열기', '정보 복사'],
+    defaultId: 0,
+    cancelId: 0
+  }).then((r) => {
+    if (r.response === 1) void shell.openPath(profileDir);
+    if (r.response === 2) clipboard.writeText(`Inkling ${version}${EOL}${detail}`);
+  }).catch(() => {
+    // dialog reject 는 일반 사용에서 발생 X — main process crash 등 예외 케이스 silent.
+  });
+}

 let tray: TrayType | null = null;
 let _showInbox: () => void = () => {};
@@ -15,6 +45,7 @@ let _ollamaOk = true;
 let _todayCount = 0;
 let _runRetryAllFailed: () => void = () => {};
 let _failedCount = 0;
+let _runOpenOllamaSettings: () => void = () => {};

 function buildMenu() {
  const items: MenuItemConstructorOptions[] = [];
@@ -41,6 +72,7 @@ function buildMenu() {
    enabled: _failedCount > 0,
    click: _runRetryAllFailed
  });
+  items.push({ label: 'Ollama 설정...', click: () => _runOpenOllamaSettings() });
  if (app.isPackaged) {
    const { openAtLogin } = app.getLoginItemSettings();
    items.push({
@@ -58,6 +90,7 @@ function buildMenu() {
  } else {
    items.push({ type: 'separator' });
  }
+  items.push({ label: 'Inkling 정보...', click: showAboutDialog });
  items.push({ label: '종료', click: () => { app.isQuitting = true; app.quit(); } });
  return Menu.buildFromTemplate(items);
 }
@@ -71,7 +104,8 @@ export function createTray(
  runSync: () => void,
  runExportTelemetry: () => void,
  runOllamaRecheck: () => void,
-  runRetryAllFailed: () => void
+  runRetryAllFailed: () => void,
+  runOpenOllamaSettings: () => void
 ): TrayType {
  _showInbox = showInbox;
  _showCapture = showCapture;
@@ -82,6 +116,7 @@ export function createTray(
  _runExportTelemetry = runExportTelemetry;
  _runOllamaRecheck = runOllamaRecheck;
  _runRetryAllFailed = runRetryAllFailed;
+  _runOpenOllamaSettings = runOpenOllamaSettings;
  const icon = nativeImage.createEmpty();
  tray = new Tray(icon);
  tray.setToolTip(`Inkling — 오늘 ${_todayCount}`);
--- a/src/preload/index.ts
+++ b/src/preload/index.ts
@@ -44,7 +44,14 @@ const api: InklingApi = {
    markRecallOpened: (id: string) => ipcRenderer.invoke('inbox:markRecallOpened', id),
    dismissRecall: (id: string) => ipcRenderer.invoke('inbox:dismissRecall', id),
    emitRecallShown: (id: string) => ipcRenderer.invoke('inbox:emitRecallShown', id),
-    emitRecallSnoozed: (id: string) => ipcRenderer.invoke('inbox:emitRecallSnoozed', id)
+    emitRecallSnoozed: (id: string) => ipcRenderer.invoke('inbox:emitRecallSnoozed', id),
+    loadOllamaSettings: () => ipcRenderer.invoke('inbox:loadOllamaSettings'),
+    saveOllamaSettings: (v: { endpoint: string; model: string }) => ipcRenderer.invoke('inbox:saveOllamaSettings', v),
+    onOpenOllamaSettings: (cb: () => void) => {
+      const handler = () => cb();
+      ipcRenderer.on('inbox:openOllamaSettings', handler);
+      return () => ipcRenderer.removeListener('inbox:openOllamaSettings', handler);
+    },
  }
 };

--- a/src/renderer/inbox/App.tsx
+++ b/src/renderer/inbox/App.tsx
@@ -12,6 +12,7 @@ import { TagUndoToast } from './components/TagUndoToast.js';
 import { ExpiryBanner } from './components/ExpiryBanner.js';
 import { FailedBanner } from './components/FailedBanner.js';
 import { RecallBanner } from './components/RecallBanner.js';
+import { OllamaSettingsModal } from './components/OllamaSettingsModal.js';

 export function App(): React.ReactElement {
  const {
@@ -21,6 +22,7 @@ export function App(): React.ReactElement {
    toggleShowTrash, restoreNote, permanentDeleteNote, emptyTrash
  } = useInbox();
  const [recoveryDismissed, setRecoveryDismissed] = useState(isRecoveryDismissedToday());
+  const [ollamaSettingsOpen, setOllamaSettingsOpen] = useState(false);

  useEffect(() => {
    void loadInitial();
@@ -31,9 +33,10 @@ export function App(): React.ReactElement {
    const unsubOllama = inboxApi.onOllamaStatus((status) => {
      useInbox.setState({ ollamaStatus: status });
    });
+    const unsubOllamaSettings = inboxApi.onOpenOllamaSettings(() => setOllamaSettingsOpen(true));
    const onFocus = () => { void refreshMeta(); };
    window.addEventListener('focus', onFocus);
-    return () => { unsubNote(); unsubOllama(); window.removeEventListener('focus', onFocus); };
+    return () => { unsubNote(); unsubOllama(); unsubOllamaSettings(); window.removeEventListener('focus', onFocus); };
    // onOllamaStatus 콜백은 useInbox.setState 직접 호출 — store reference 가 안정적이라
    // deps array 에 추가 불필요. mount 시 1회 구독 + unmount 시 해제.
  }, [loadInitial, refreshMeta, upsertNote]);
@@ -79,7 +82,7 @@ export function App(): React.ReactElement {
      <main className="main">
        {!showTrash && (
          <>
-            <OllamaBanner />
+            <OllamaBanner onOpenSettings={() => setOllamaSettingsOpen(true)} />
            <RecoveryToast
              show={showRecovery}
              onDismiss={() => { markRecoveryDismissed(); setRecoveryDismissed(true); }}
@@ -144,7 +147,6 @@ export function App(): React.ReactElement {
              trashNotes.map((n) => (
                <NoteCard
                  key={n.id} note={n} mode="trash"
-                  onDeleted={() => removeNote(n.id)}
                  onUpdated={(u) => upsertNote(u)}
                  onRestore={() => void restoreNote(n.id)}
                  onPermanentDelete={() => void permanentDeleteNote(n.id)}
@@ -155,6 +157,10 @@ export function App(): React.ReactElement {
        )}
      </main>
      <TagUndoToast />
+      <OllamaSettingsModal
+        open={ollamaSettingsOpen}
+        onClose={() => setOllamaSettingsOpen(false)}
+      />
    </>
  );
 }
--- a/src/renderer/inbox/components/NoteCard.tsx
+++ b/src/renderer/inbox/components/NoteCard.tsx
@@ -8,7 +8,7 @@ import { pushTagUndo } from './TagUndoToast.js';

 interface Props {
  note: Note;
-  onDeleted: () => void;
+  onDeleted?: () => void;  // inbox mode 전용 (trash mode 에서 미사용)
  onUpdated: (n: Note) => void;
  mode?: 'inbox' | 'trash';  // default 'inbox'
  onRestore?: () => void;
@@ -119,7 +119,7 @@ export function NoteCard({ note, onDeleted, onUpdated, mode = 'inbox', onRestore
  async function handleDelete() {
    if (!window.confirm('이 기억을 버릴까요? 되돌릴 수 없습니다.')) return;
    await inboxApi.deleteNote(note.id);
-    onDeleted();
+    onDeleted?.();
  }

  async function saveTitle(next: string) {
--- a/src/renderer/inbox/components/OllamaBanner.tsx
+++ b/src/renderer/inbox/components/OllamaBanner.tsx
@@ -1,7 +1,11 @@
 import React from 'react';
 import { useInbox } from '../store.js';

-export function OllamaBanner(): React.ReactElement | null {
+interface OllamaBannerProps {
+  onOpenSettings?: () => void;
+}
+
+export function OllamaBanner({ onOpenSettings }: OllamaBannerProps = {}): React.ReactElement | null {
  const status = useInbox((s) => s.ollamaStatus);
  const recheckOllama = useInbox((s) => s.recheckOllama);
  if (status.ok) return null;
@@ -28,6 +32,19 @@ export function OllamaBanner(): React.ReactElement | null {
        >
          재확인
        </button>
+        {onOpenSettings && (
+          <button
+            onClick={onOpenSettings}
+            style={{
+              background: 'transparent', color: 'inherit',
+              border: '1px solid currentColor', borderRadius: 4,
+              padding: '2px 8px', fontSize: 12, cursor: 'pointer',
+              marginLeft: 6
+            }}
+          >
+            설정
+          </button>
+        )}
      </div>
      {status.reason ? (
        <span style={{ fontSize: 11, opacity: 0.7, marginTop: 4 }}>
--- a/src/renderer/inbox/components/OllamaSettingsModal.tsx
+++ b/src/renderer/inbox/components/OllamaSettingsModal.tsx
@@ -0,0 +1,127 @@
+import React, { useEffect, useState } from 'react';
+import { inboxApi } from '../api.js';
+import { DEFAULT_OLLAMA_ENDPOINT, DEFAULT_OLLAMA_MODEL } from '../../../shared/constants.js';
+
+interface Props {
+  open: boolean;
+  onClose: () => void;
+}
+
+export function OllamaSettingsModal({ open, onClose }: Props): React.ReactElement | null {
+  const [endpoint, setEndpoint] = useState(DEFAULT_OLLAMA_ENDPOINT);
+  const [model, setModel] = useState(DEFAULT_OLLAMA_MODEL);
+  const [error, setError] = useState<string | null>(null);
+  const [saving, setSaving] = useState(false);
+
+  // 마운트/open 시 현재 설정 fetch
+  useEffect(() => {
+    if (!open) return;
+    void inboxApi.loadOllamaSettings().then((s) => {
+      if (s) {
+        setEndpoint(s.endpoint);
+        setModel(s.model);
+      }
+      setError(null);
+    });
+  }, [open]);
+
+  if (!open) return null;
+
+  async function handleSave() {
+    if (saving) return;  // m4 fix: synchronous double-click 가드
+    setSaving(true);
+    setError(null);
+    try {
+      const r = await inboxApi.saveOllamaSettings({ endpoint, model });
+      if (r.ok) {
+        onClose();
+      } else {
+        setError(r.reason);
+      }
+    } catch (e) {
+      setError(String(e));
+    } finally {
+      setSaving(false);
+    }
+  }
+
+  return (
+    <div
+      onKeyDown={(e) => {
+        if (e.key === 'Escape' && !saving) onClose();
+        if (e.key === 'Enter' && !saving) void handleSave();
+      }}
+      tabIndex={-1}
+      style={{
+        position: 'fixed', inset: 0, background: 'rgba(0,0,0,0.4)',
+        display: 'flex', alignItems: 'center', justifyContent: 'center', zIndex: 1000
+      }}
+    >
+      <div style={{
+        background: '#fff', borderRadius: 8, padding: 20, minWidth: 400, maxWidth: 500,
+        boxShadow: '0 4px 16px rgba(0,0,0,0.2)'
+      }}>
+        <h2 style={{ margin: '0 0 12px 0', fontSize: 16 }}>Ollama 설정</h2>
+        <div style={{ marginBottom: 12 }}>
+          <label style={{ display: 'block', fontSize: 12, color: '#666', marginBottom: 4 }}>
+            Endpoint URL
+          </label>
+          <input
+            type="text"
+            value={endpoint}
+            onChange={(e) => setEndpoint(e.target.value)}
+            placeholder="http://localhost:11434"
+            autoFocus
+            style={{ width: '100%', padding: '6px 8px', fontSize: 13, border: '1px solid #ccc', borderRadius: 4 }}
+            disabled={saving}
+          />
+        </div>
+        <div style={{ marginBottom: 12 }}>
+          <label style={{ display: 'block', fontSize: 12, color: '#666', marginBottom: 4 }}>
+            Model
+          </label>
+          <input
+            type="text"
+            value={model}
+            onChange={(e) => setModel(e.target.value)}
+            placeholder="gemma4:e4b"
+            style={{ width: '100%', padding: '6px 8px', fontSize: 13, border: '1px solid #ccc', borderRadius: 4 }}
+            disabled={saving}
+          />
+        </div>
+        {error && (
+          <div style={{
+            background: '#fce4e4', color: '#a33', padding: '6px 10px', borderRadius: 4,
+            fontSize: 12, marginBottom: 12
+          }}>
+            저장 실패: {error}
+          </div>
+        )}
+        <div style={{ display: 'flex', gap: 8, justifyContent: 'flex-end' }}>
+          <button
+            onClick={onClose}
+            disabled={saving}
+            style={{
+              background: 'transparent', color: '#666',
+              border: '1px solid #ccc', borderRadius: 4,
+              padding: '6px 14px', fontSize: 12, cursor: saving ? 'not-allowed' : 'pointer'
+            }}
+          >
+            취소
+          </button>
+          <button
+            onClick={() => void handleSave()}
+            disabled={saving}
+            style={{
+              background: saving ? '#999' : '#0a4b80', color: '#fff',
+              border: 'none', borderRadius: 4,
+              padding: '6px 14px', fontSize: 12, cursor: saving ? 'not-allowed' : 'pointer'
+            }}
+          >
+            {saving ? '검증 중...' : '저장'}
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}
--- a/src/shared/constants.ts
+++ b/src/shared/constants.ts
@@ -0,0 +1,2 @@
+export const DEFAULT_OLLAMA_MODEL = 'gemma4:e4b';
+export const DEFAULT_OLLAMA_ENDPOINT = 'http://localhost:11434';
--- a/src/shared/types.ts
+++ b/src/shared/types.ts
@@ -89,6 +89,9 @@ export interface InboxApi {
  dismissRecall(id: string): Promise<{ note: Note }>;
  emitRecallShown(id: string): Promise<void>;
  emitRecallSnoozed(id: string): Promise<void>;
+  loadOllamaSettings(): Promise<{ endpoint: string; model: string } | null>;
+  saveOllamaSettings(v: { endpoint: string; model: string }): Promise<{ ok: true } | { ok: false; reason: string }>;
+  onOpenOllamaSettings(cb: () => void): () => void;
 }

 export interface InklingApi {
--- a/tests/unit/AiWorker.test.ts
+++ b/tests/unit/AiWorker.test.ts
@@ -6,6 +6,7 @@ import { AiWorker } from '@main/ai/AiWorker.js';
 import type { AiTelemetryEmitter } from '@main/ai/AiWorker.js';
 import type { InferenceProvider } from '@main/ai/InferenceProvider.js';
 import type { AiResponse } from '@main/ai/schema.js';
+import { ProviderHolder } from '@main/ai/ProviderHolder.js';

 type EmittedEvent = { kind: string; payload: unknown };

@@ -33,7 +34,7 @@ describe('AiWorker', () => {
  it('processes a pending job and marks done', async () => {
    const { id } = repo.create({ rawText: 'x' });
    const updates: string[] = [];
-    const w = new AiWorker(repo, makeProvider(), {
+    const w = new AiWorker(repo, new ProviderHolder(makeProvider()), {
      backoffsMs: [0, 0, 0],
      onUpdate: (note) => updates.push(note.aiStatus)
    });
@@ -48,7 +49,7 @@ describe('AiWorker', () => {
    const provider = makeProvider({
      generate: vi.fn(async () => { throw new Error('boom'); })
    });
-    const w = new AiWorker(repo, provider, { backoffsMs: [0, 0, 0] });
+    const w = new AiWorker(repo, new ProviderHolder(provider), { backoffsMs: [0, 0, 0] });
    await w.enqueue(id);
    await w.drain();
    const note = repo.findById(id)!;
@@ -60,7 +61,7 @@ describe('AiWorker', () => {
  it('loadFromDb re-queues all pending', async () => {
    const a = repo.create({ rawText: 'a' }).id;
    const b = repo.create({ rawText: 'b' }).id;
-    const w = new AiWorker(repo, makeProvider(), { backoffsMs: [0, 0, 0] });
+    const w = new AiWorker(repo, new ProviderHolder(makeProvider()), { backoffsMs: [0, 0, 0] });
    await w.loadFromDb();
    await w.drain();
    expect(repo.findById(a)?.aiStatus).toBe('done');
@@ -79,7 +80,7 @@ describe('AiWorker', () => {
        return { title: '제목', summary: 'a\nb\nc', tags: [], dueDate: null };
      })
    });
-    const w = new AiWorker(repo, provider, { backoffsMs: [0, 0, 0] });
+    const w = new AiWorker(repo, new ProviderHolder(provider), { backoffsMs: [0, 0, 0] });
    for (const id of ids) await w.enqueue(id);
    await w.drain();
    expect(max).toBe(1);
@@ -96,7 +97,7 @@ describe('AiWorker', () => {
      }),
      healthCheck: async () => ({ ok: true })
    } as any;
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0],
      now: () => new Date('2026-04-26T00:00:00.000Z')
    });
@@ -118,7 +119,7 @@ describe('AiWorker', () => {
      }),
      healthCheck: async () => ({ ok: true })
    } as any;
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0],
      now: () => new Date('2026-04-26T00:00:00.000Z')
    });
@@ -140,7 +141,7 @@ describe('AiWorker', () => {
      }),
      healthCheck: async () => ({ ok: true })
    } as any;
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0],
      now: () => new Date('2026-04-26T00:00:00.000Z')
    });
@@ -162,7 +163,7 @@ describe('AiWorker', () => {
      },
      healthCheck: async () => ({ ok: true })
    } as any;
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0],
      now: () => new Date('2026-04-26T15:00:00.000Z') // 04-27 00:00 KST
    });
@@ -184,7 +185,7 @@ describe('AiWorker', () => {
      },
      healthCheck: async () => ({ ok: true })
    } as any;
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0],
      now: () => new Date('2026-04-26T00:00:00.000Z')
    });
@@ -216,7 +217,7 @@ describe('AiWorker telemetry emit', () => {

  it('emits ai_succeeded with durationMs/attempts on success', async () => {
    const { id } = repo.create({ rawText: '수요일 회의 메모' });
-    const w = new AiWorker(repo, makeProvider(), {
+    const w = new AiWorker(repo, new ProviderHolder(makeProvider()), {
      backoffsMs: [0, 0, 0],
      telemetry: collectingTelemetry
    });
@@ -236,7 +237,7 @@ describe('AiWorker telemetry emit', () => {
    const provider = makeProvider({
      generate: vi.fn(async () => { throw new Error('fetch failed: ECONNREFUSED 11434'); })
    });
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0, 0, 0],
      unreachableBackoffsMs: [10, 10, 10, 10, 10, 10],
      telemetry: collectingTelemetry
@@ -254,7 +255,7 @@ describe('AiWorker telemetry emit', () => {
    const provider = makeProvider({
      generate: vi.fn(async () => { throw new ZodError([]); })
    });
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0, 0, 0],
      telemetry: collectingTelemetry
    });
@@ -270,7 +271,7 @@ describe('AiWorker telemetry emit', () => {
    const provider = makeProvider({
      generate: vi.fn(async () => { throw new Error('mystery'); })
    });
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0, 0, 0],
      telemetry: collectingTelemetry
    });
@@ -300,7 +301,7 @@ describe('AiWorker — deletedAt guard (v0.2.3 #4)', () => {
    db.prepare(`INSERT INTO pending_jobs (note_id, attempts, next_run_at) VALUES (?, 0, ?)`).run(id, '2026-05-01T12:00:00.000Z');
    const generate = vi.fn();
    const provider = makeProvider({ generate: generate as any });
-    const w = new AiWorker(repo, provider, { backoffsMs: [0, 0, 0] });
+    const w = new AiWorker(repo, new ProviderHolder(provider), { backoffsMs: [0, 0, 0] });
    await w.loadFromDb();
    await w.drain();
    expect(generate).not.toHaveBeenCalled();
@@ -322,7 +323,7 @@ describe('AiWorker — unreachable/timeout infinite retry (v0.2.3 #2)', () => {
    const provider = makeProvider({
      generate: vi.fn(async () => { throw new Error('ECONNREFUSED'); })
    });
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0, 30_000, 120_000],
      unreachableBackoffsMs: [10, 10, 10, 10, 10, 10]
    });
@@ -341,7 +342,7 @@ describe('AiWorker — unreachable/timeout infinite retry (v0.2.3 #2)', () => {
    const provider = makeProvider({
      generate: vi.fn(async () => { throw new Error('Request timeout'); })
    });
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0, 30_000, 120_000],
      unreachableBackoffsMs: [10, 10, 10, 10, 10, 10]
    });
@@ -360,7 +361,7 @@ describe('AiWorker — unreachable/timeout infinite retry (v0.2.3 #2)', () => {
      })
    });
    const events: any[] = [];
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0, 0, 0],
      telemetry: { emit: async (e) => { events.push(e); } }
    });
@@ -379,7 +380,7 @@ describe('AiWorker — unreachable/timeout infinite retry (v0.2.3 #2)', () => {
      generate: vi.fn(async () => { throw new Error('something weird'); })
    });
    const events: any[] = [];
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0, 0, 0],
      telemetry: { emit: async (e) => { events.push(e); } }
    });
@@ -392,7 +393,7 @@ describe('AiWorker — unreachable/timeout infinite retry (v0.2.3 #2)', () => {
  });

  it('unreachable backoff schedule — nextBackoffMs(step) cap at index 5 (15분)', async () => {
-    const w = new AiWorker(repo, makeProvider(), {
+    const w = new AiWorker(repo, new ProviderHolder(makeProvider()), {
      backoffsMs: [0, 30_000, 120_000],
      unreachableBackoffsMs: [30_000, 60_000, 120_000, 240_000, 480_000, 900_000]
    });
@@ -411,7 +412,7 @@ describe('AiWorker — unreachable/timeout infinite retry (v0.2.3 #2)', () => {
        return { title: 't', summary: 's', tags: [], dueDate: null };
      })
    });
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0, 0, 0],
      unreachableBackoffsMs: [10, 10, 10, 10, 10, 10]
    });
@@ -443,7 +444,7 @@ describe('AiWorker — vocab fetch + per-tag hit/miss (v0.2.3 #3 T7)', () => {
    const generateMock = vi.fn(async () => ({
      title: '제목', summary: 'a\nb\nc', tags: ['design'], dueDate: null
    }));
-    const w = new AiWorker(repo, makeProvider({ generate: generateMock }), {
+    const w = new AiWorker(repo, new ProviderHolder(makeProvider({ generate: generateMock })), {
      backoffsMs: [0, 0, 0]
    });
    await w.enqueue(id);
@@ -467,7 +468,7 @@ describe('AiWorker — vocab fetch + per-tag hit/miss (v0.2.3 #3 T7)', () => {
      }))
    });
    const emits: EmittedEvent[] = [];
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0, 0, 0],
      telemetry: {
        emit: vi.fn(async (input) => { emits.push(input); })
@@ -497,7 +498,7 @@ describe('AiWorker — vocab fetch + per-tag hit/miss (v0.2.3 #3 T7)', () => {
      }))
    });
    const emits: EmittedEvent[] = [];
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0, 0, 0],
      telemetry: { emit: vi.fn(async (input) => { emits.push(input); }) }
    });
@@ -522,7 +523,7 @@ describe('AiWorker — vocab fetch + per-tag hit/miss (v0.2.3 #3 T7)', () => {
      }))
    });
    const emits: EmittedEvent[] = [];
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0, 0, 0],
      telemetry: { emit: vi.fn(async (input) => { emits.push(input); }) }
    });
@@ -546,7 +547,7 @@ describe('AiWorker — vocab fetch + per-tag hit/miss (v0.2.3 #3 T7)', () => {
      }))
    });
    const emits: EmittedEvent[] = [];
-    const w = new AiWorker(repo, provider, {
+    const w = new AiWorker(repo, new ProviderHolder(provider), {
      backoffsMs: [0, 0, 0],
      telemetry: { emit: vi.fn(async (input) => { emits.push(input); }) }
    });
--- a/tests/unit/HealthChecker.test.ts
+++ b/tests/unit/HealthChecker.test.ts
@@ -2,6 +2,7 @@ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
 import { HealthChecker, type HealthTelemetryEvent } from '@main/services/HealthChecker.js';
 import type { InferenceProvider, HealthResult, GenerateInput } from '@main/ai/InferenceProvider.js';
 import type { AiResponse } from '@main/ai/schema.js';
+import { ProviderHolder } from '@main/ai/ProviderHolder.js';

 class FakeProvider implements InferenceProvider {
  readonly name = 'fake';
@@ -24,7 +25,7 @@ describe('HealthChecker — start/stop polling', () => {
  it('start() runs runOnce immediately + every intervalMs', async () => {
    const provider = new FakeProvider();
    provider.results = [{ ok: true }, { ok: true }, { ok: true }];
-    const hc = new HealthChecker(provider, { intervalMs: 1000 });
+    const hc = new HealthChecker(new ProviderHolder(provider), { intervalMs: 1000 });
    hc.start();
    await vi.runOnlyPendingTimersAsync();
    await vi.advanceTimersByTimeAsync(1000);
@@ -36,7 +37,7 @@ describe('HealthChecker — start/stop polling', () => {
  it('start() is idempotent — second call does not duplicate timer', async () => {
    const provider = new FakeProvider();
    provider.results = [{ ok: true }];
-    const hc = new HealthChecker(provider, { intervalMs: 1000 });
+    const hc = new HealthChecker(new ProviderHolder(provider), { intervalMs: 1000 });
    hc.start();
    hc.start();
    // 즉시 1회 + 1s 후 1회 = 정확히 2. 두 timer 가 잘못 등록됐으면 4 (각 timer 마다 즉시+1s).
@@ -48,7 +49,7 @@ describe('HealthChecker — start/stop polling', () => {
  it('stop() clears timer (no further runOnce)', async () => {
    const provider = new FakeProvider();
    provider.results = [{ ok: true }, { ok: true }];
-    const hc = new HealthChecker(provider, { intervalMs: 1000 });
+    const hc = new HealthChecker(new ProviderHolder(provider), { intervalMs: 1000 });
    hc.start();
    await vi.runOnlyPendingTimersAsync();
    const before = (provider as any).idx;
@@ -64,7 +65,7 @@ describe('HealthChecker — delta transitions + telemetry', () => {
    provider.results = [{ ok: true }, { ok: false, reason: 'connection refused' }];
    const updates: HealthResult[] = [];
    const events: HealthTelemetryEvent[] = [];
-    const hc = new HealthChecker(provider, {
+    const hc = new HealthChecker(new ProviderHolder(provider), {
      onUpdate: (s) => updates.push(s),
      onTelemetry: (e) => events.push(e)
    });
@@ -79,7 +80,7 @@ describe('HealthChecker — delta transitions + telemetry', () => {
    provider.results = [{ ok: false, reason: 'refused' }, { ok: true }];
    const events: HealthTelemetryEvent[] = [];
    let nowCounter = 0;
-    const hc = new HealthChecker(provider, {
+    const hc = new HealthChecker(new ProviderHolder(provider), {
      onTelemetry: (e) => events.push(e),
      now: () => { nowCounter += 1; return nowCounter * 1000; }
    });
@@ -97,7 +98,7 @@ describe('HealthChecker — delta transitions + telemetry', () => {
    ];
    const updates: HealthResult[] = [];
    const events: HealthTelemetryEvent[] = [];
-    const hc = new HealthChecker(provider, {
+    const hc = new HealthChecker(new ProviderHolder(provider), {
      onUpdate: (s) => updates.push(s),
      onTelemetry: (e) => events.push(e)
    });
@@ -111,7 +112,7 @@ describe('HealthChecker — delta transitions + telemetry', () => {
    const provider = new FakeProvider();
    provider.results = [{ ok: true }];
    const events: HealthTelemetryEvent[] = [];
-    const hc = new HealthChecker(provider, { onTelemetry: (e) => events.push(e) });
+    const hc = new HealthChecker(new ProviderHolder(provider), { onTelemetry: (e) => events.push(e) });
    await hc.runOnce({ manual: true });
    expect(events).toEqual([{ kind: 'ollama_recheck_manual' }]);
  });
--- a/tests/unit/LocalOllamaProvider.test.ts
+++ b/tests/unit/LocalOllamaProvider.test.ts
@@ -89,4 +89,24 @@ describe('LocalOllamaProvider', () => {
    expect(h.ok).toBe(false);
    expect(h.reason).toMatch(/connect|refused|unreachable/i);
  });
+
+  it('abort() cancels in-flight generate (rejects with AbortError)', async () => {
+    mock.get('http://localhost:11434').intercept({
+      path: '/api/generate', method: 'POST'
+    }).reply((async () => {
+      await new Promise<void>((r) => setTimeout(r, 5000)); // long-running
+      return { statusCode: 200, data: '{}' };
+    }) as never);
+    const provider = new LocalOllamaProvider({ timeoutMs: 30_000 });
+    const generatePromise = provider.generate({
+      text: 'x', todayKst: '2026-05-04', dueDateCandidates: []
+    });
+    setTimeout(() => provider.abort(), 50);
+    await expect(generatePromise).rejects.toThrow();
+  });
+
+  it('constructor uses provided model param (not just default)', () => {
+    const provider = new LocalOllamaProvider({ model: 'gemma4:26b' });
+    expect(provider.name).toBe('local-ollama/gemma4:26b');
+  });
 });
--- a/tests/unit/ProviderHolder.test.ts
+++ b/tests/unit/ProviderHolder.test.ts
@@ -0,0 +1,30 @@
+import { describe, it, expect, vi } from 'vitest';
+import { ProviderHolder } from '@main/ai/ProviderHolder.js';
+import { LocalOllamaProvider } from '@main/ai/LocalOllamaProvider.js';
+
+describe('ProviderHolder', () => {
+  it('replace() fires listener and get() returns new instance', () => {
+    const a = new LocalOllamaProvider({ endpoint: 'http://a:11434', model: 'm1' });
+    const b = new LocalOllamaProvider({ endpoint: 'http://b:11434', model: 'm2' });
+    const holder = new ProviderHolder(a);
+    const listener = vi.fn();
+    holder.onReplace(listener);
+    expect(holder.get()).toBe(a);
+    holder.replace(b);
+    expect(holder.get()).toBe(b);
+    expect(listener).toHaveBeenCalledWith(b);
+  });
+
+  it('multiple listeners all fire on replace()', () => {
+    const a = new LocalOllamaProvider({ model: 'm1' });
+    const b = new LocalOllamaProvider({ model: 'm2' });
+    const holder = new ProviderHolder(a);
+    const l1 = vi.fn();
+    const l2 = vi.fn();
+    holder.onReplace(l1);
+    holder.onReplace(l2);
+    holder.replace(b);
+    expect(l1).toHaveBeenCalledWith(b);
+    expect(l2).toHaveBeenCalledWith(b);
+  });
+});
--- a/tests/unit/SettingsService.test.ts
+++ b/tests/unit/SettingsService.test.ts
@@ -0,0 +1,57 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { SettingsService } from '@main/services/SettingsService.js';
+
+describe('SettingsService', () => {
+  let dir: string;
+  let svc: SettingsService;
+
+  beforeEach(() => {
+    dir = mkdtempSync(join(tmpdir(), 'inkling-settings-'));
+    svc = new SettingsService(dir);
+  });
+  afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
+
+  it('load() returns empty object when file does not exist', async () => {
+    const s = await svc.load();
+    expect(s).toEqual({});
+  });
+
+  it('load() returns empty object on corrupted JSON (no throw)', async () => {
+    writeFileSync(join(dir, 'settings.json'), '{ this is not json');
+    const s = await svc.load();
+    expect(s).toEqual({});
+  });
+
+  it('load() caches result — second call does not re-read file', async () => {
+    await svc.setOllama({ endpoint: 'http://localhost:11434', model: 'gemma4:e4b' });
+    const before = await svc.load();
+    // 외부에서 파일 변경
+    writeFileSync(join(dir, 'settings.json'), JSON.stringify({ ollama: { endpoint: 'http://lan:11434', model: 'gemma4:26b' } }));
+    const after = await svc.load();
+    // 캐시 적용 — 파일 변경 무시
+    expect(after).toEqual(before);
+  });
+
+  it('setOllama() throws on non-URL endpoint', async () => {
+    await expect(
+      svc.setOllama({ endpoint: 'not-a-url', model: 'gemma4:e4b' })
+    ).rejects.toThrow();
+  });
+
+  it('setOllama() persists to disk with valid JSON', async () => {
+    await svc.setOllama({ endpoint: 'http://localhost:11435', model: 'gemma4:e4b' });
+    const raw = readFileSync(join(dir, 'settings.json'), 'utf8');
+    const parsed = JSON.parse(raw);
+    expect(parsed.ollama.endpoint).toBe('http://localhost:11435');
+    expect(parsed.ollama.model).toBe('gemma4:e4b');
+  });
+
+  it('setOllama() atomic write — tmp file does not remain', async () => {
+    await svc.setOllama({ endpoint: 'http://localhost:11434', model: 'gemma4:e4b' });
+    expect(existsSync(join(dir, 'settings.json.tmp'))).toBe(false);
+    expect(existsSync(join(dir, 'settings.json'))).toBe(true);
+  });
+});
Author	SHA1	Message	Date
altair823	49c29f34c3	Merge pull request 'chore(release): v0.2.4 — patch cut (backlog 5건 + dogfood unblock)' (#22 ) from feat/v024-patch-cleanup into main Reviewed-on: #22	2026-05-04 15:24:46 +00:00
altair823	d213d45f92	fix(v024): About dialog EOL + .catch (round 1 review) Round 1 review minor + final reviewer minor 일괄: - About dialog detail/clipboard 의 줄바꿈 → os.EOL (Windows Notepad 등에서 줄바꿈 정상) - showMessageBox().then().catch(() => {}) — dialog reject (main crash 예외) silent (tray.ts 가 logger 미import — minimal swallow 패턴 채택) skip: - nit: 트레이 메뉴 ordering ("정보" → "종료" 한 그룹) — 현재 패턴도 흔함, 호불호 영역 - nit: process.versions.electron ?? '?' dead branch — 안전 fallback 유지 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-05 00:22:00 +09:00
altair823	298d1c6182	chore(release): v0.2.4 — patch cut (backlog 5건 처리 + dogfood unblock) PR #21 머지 후 v0.2.3.1 binary 빌드 시도 → electron-builder semver 검증 실패 (4-part X.Y.Z.W 비호환). v0.2.4 minor bump 으로 우회. 본 cut 동봉: - 0.2.3.1 의 in-app Ollama 설정 UI (PR #21 `fee982a`) - backlog #2 (DAY_MS 상수) - backlog #6 (media.gc .catch) - backlog #13 (NoteCard onDeleted optional) - backlog #44 (버전 정보 트레이 메뉴) - backlog #1 stale 표기 (PR #13 시 이미 fix) 게이트: typecheck 0 / 단위 413 / e2e 1 다음: PR + 머지 후 binary 빌드 v0.2.4 + Gitea release v0.2.5 brainstorm 트리거 시 잔여 backlog 39건 일괄 triage Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-05 00:15:51 +09:00
altair823	d3dfe1e4e2	feat(v024): "Inkling 정보..." 트레이 메뉴 + native About dialog (backlog #44 ) dogfood 발견 #44 fix — 사용자가 설치된 버전 확인 path 부재 해소. - 트레이 메뉴 마지막 항목 (종료 직전): "Inkling 정보..." - 클릭 시 native dialog (showMessageBox): - title: Inkling 정보 - message: Inkling {version} - detail: 버전, Electron, Node, OS platform/release, 데이터 위치 - 버튼 3개: 확인 / 데이터 위치 열기 (shell.openPath) / 정보 복사 (clipboard) - 디버그 정보 노출로 사용자가 issue report 시 첨부 가능 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-05 00:14:30 +09:00
altair823	c87c248e89	refactor(v024): NoteCard onDeleted optional + trash mode 미전달 (backlog #13 ) - onDeleted: () => void → onDeleted?: () => void (inbox mode 전용 명시) - handleDelete 내부 onDeleted() → onDeleted?.() - App.tsx 의 trash mode NoteCard 가 onDeleted prop 미전달 (dead-code 제거) - API 시그니처 정리 — trash mode 는 onPermanentDelete/onRestore 만 의미 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-05 00:12:56 +09:00
altair823	ef5d3daf4c	refactor(v024): TelemetryService DAY_MS 상수 + media.gc .catch (backlog #2 #6 ) - #2: 246060*1000 magic number → 모듈 상단 const DAY_MS cleanupOldFiles + readAllRecent 두 callsite 통일 - #6: gc.run() 의 .catch 누락 → backup.runDaily 패턴 통일 실패 시 logger.warn('media.gc.failed', { reason }) Note: backlog #1 (now() 2번 호출) 은 PR #13 round 1 review 시 이미 fix — backlog 항목 stale. v0.2.5 brainstorm 시 backlog 정리. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-05 00:11:38 +09:00
altair823	4bde148cdc	docs(v024): patch cleanup spec — 5 backlog 항목 + version bump 0.2.3.1 semver 위반 → 0.2.4 minor bump 이용해 backlog risk 낮은 cleanup 5건 + dogfood 가치 #44 묶음 cut. v0.2.4 정식 brainstorm 은 v0.2.5 로 이동. In: #1 (now() 2번), #2 (DAY_MS), #6 (media.gc .catch), #13 (NoteCard onDeleted), #44 (버전 정보 surface), version bump Out: #45 (autostart bug — 별도 cut), #3/#4/#5/#22/#26 (큰 refactor), #39~#43 (PR #21 deferred — v0.2.5 brainstorm) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-05 00:09:56 +09:00
altair823	8ba43d939e	docs(backlog): v0.2.3.1 dogfood 발견 +2건 (#44 버전 정보, #45 자동실행 버그) PR #21 머지 후 dogfood 중 사용자 발견: - #44: 버전 / 빌드 정보 표시 surface 부재 (트레이 / Inbox footer / About 모달) - #45: 윈도우 자동 실행 옵션 재시작 후 풀려있는 버그 (tray.ts:47-58, app.setLoginItemSettings + getLoginItemSettings 비대칭) PR review deferred 와 별개의 raw UX/bug 발견. 신설 섹션 "v0.2.3 / v0.2.3.1 dogfood 발견" 으로 분리 — v0.2.4 brainstorm 시 우선순위 결정. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-05 00:02:40 +09:00
altair823	fee982a6e6	Merge pull request 'feat(ollama): v0.2.3.1 — in-app endpoint/model 설정' (#21 ) from feat/v0231-ollama-settings into main Reviewed-on: #21	2026-05-04 15:00:40 +00:00
altair823	d974335ee4	docs(backlog): v0.2.3.1 round 1 review m2/i1 + 신규 항목 5건 추가 PR #21 round 1 review 에서 deferred 항목들 backlog 38 → 43: - #39 (m2): ollama_unreachable.reason 의 endpoint URL PII 우회 노출 - #40 (i1): save vs HealthChecker tick race UX flicker - #41: OllamaSettingsModal 인라인 스타일 (#24 와 합산) - #42: Modal client-side URL validation 부재 - #43: createTray 10번째 positional callback (#4/#26 blocker) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-04 23:54:50 +09:00
altair823	6f95e89456	fix(ollama): PR #21 review round 1 — m1+m3+m4+n1 (v0.2.3.1) - m1 (Minor): saveOllamaSettings IPC가 setOllama throw 시 try/catch → { ok: false, reason: 'persist failed: ...' } 대칭 응답 - m3 (Minor): Modal ESC=close + Enter=save 키 핸들러 + 첫 input autoFocus - m4 (Minor): handleSave 첫 줄 if (saving) return; — sync double-click 가드 - n1 (Nit): 'gemma4:e4b' / 'http://localhost:11434' magic → src/shared/constants.ts 의 DEFAULT_OLLAMA_MODEL / DEFAULT_OLLAMA_ENDPOINT defer to v0.2.4 backlog: - m2: ollama_unreachable.reason 에 endpoint URL 노출 (PII 우회) — telemetry masking 정책 skip: - i1 (race UX): acknowledge only, 정확성 영향 0 - m5 (abort try/catch): 현재 LocalOllamaProvider.abort 는 throw X - m6 (first-boot blocking): 무시 가능 - n2 (offReplace): 현재 listener callsite 0건 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-04 23:53:42 +09:00
altair823	3a2ff1a35c	chore(release): v0.2.3.1 — Ollama 설정 in-app UI (patch cut) dogfood unblock 패치. v0.2.3 의 INKLING_OLLAMA_ENDPOINT env var 의존 → in-app UI (트레이 + 배너) 에서 endpoint + model 변경 가능. 게이트: typecheck 0 / 단위 413 / e2e 1 다음: PR + 머지 후 binary 재빌드 + Gitea release v0.2.3.1 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-04 23:44:45 +09:00
altair823	0c0327ddb6	feat(ollama): 트레이 메뉴 "Ollama 설정..." (v0.2.3.1) - createTray 10번째 positional callback runOpenOllamaSettings - 트레이 → 메뉴 클릭 → main 이 inbox:openOllamaSettings IPC push - renderer App.tsx 가 구독해 modal open backlog #4/#26 (TrayCallbacks object refactor) 와 합산 — v0.2.4 시 일괄 정리 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-04 23:43:00 +09:00
altair823	833a598368	feat(ollama): OllamaSettingsModal + App mount + OllamaBanner 설정 링크 (v0.2.3.1) - OllamaSettingsModal: endpoint + model freetext 입력, 저장 시 healthCheck → 성공 닫기, 실패 inline 에러 - App.tsx: ollamaSettingsOpen state + onOpenOllamaSettings IPC subscribe - OllamaBanner: onOpenSettings prop 추가, 우측 "설정" 버튼 - preload + types: onOpenOllamaSettings listener bridge Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-04 23:40:31 +09:00
altair823	4153284af1	fix(ollama): saveOllamaSettings 가 health.runOnce() 즉시 호출 (T4 review) T4 fallback comment "60s polling cycle" 대신 HealthChecker 의 기존 public method runOnce() 사용. 사용자가 settings 저장하자마자 OllamaBanner 갱신. runOnce 는 이미 inbox:ollamaRecheck IPC 가 사용 중인 패턴. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-04 23:37:57 +09:00
altair823	cee39a90aa	feat(ollama): index 부팅 + IPC + preload + types (v0.2.3.1) - index.ts: SettingsService.load() 후 endpoint/model 결정 (settings > env > default) - IPC: inbox:loadOllamaSettings + inbox:saveOllamaSettings - save: 임시 provider 로 healthCheck 통과 시에만 영속화 + holder.replace - 기존 in-flight generate 는 abort?.() (optional method) - preload + InboxApi shared types Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-04 23:36:46 +09:00
altair823	d1f36250e7	fix(ollama): InferenceProvider — abort?: () => void optional 추가 (T3 review) T3 가 ProviderHolder 를 InferenceProvider 로 추상화. 단 IPC handler 가 holder.get().abort() 호출 예정 — interface 에 method 가 없으면 typecheck 실패. abort 는 in-flight generate 중단용이라 모든 provider 가 지원할 필요는 없음 → optional method 로 추가. caller 는 holder.get().abort?.() 패턴 사용. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-04 23:34:17 +09:00
altair823	9fef2edb6e	feat(ollama): ProviderHolder + AiWorker/HealthChecker refactor (v0.2.3.1) - ProviderHolder: mutable holder + listeners, indirection layer - AiWorker: constructor InferenceProvider → ProviderHolder this.provider.x → this.holder.get().x 전환 - HealthChecker: 동일 패턴 - src/main/index.ts: provider 를 ProviderHolder 로 감싸서 생성 - 기존 AiWorker / HealthChecker 테스트의 constructor 호출에 ProviderHolder wrap - 단위 +2 cases (ProviderHolder) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-04 23:32:20 +09:00
altair823	c77c30be83	feat(ollama): LocalOllamaProvider — abort() + AbortController instance field (v0.2.3.1) - abortController 가 method-local 에서 private instance field 로 이동 - public abort() 메서드 — 외부에서 in-flight generate 강제 중단 - ProviderHolder.replace() 시 호출되어 endpoint 변경 즉시 반영 - 단위 +2 cases (abort cancellation, model 파라미터) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-04 23:26:48 +09:00
altair823	de895b8fec	feat(settings): SettingsService — JSON 영속화 + zod 검증 (v0.2.3.1) - `<profileDir>/settings.json` atomic write (temp + rename) - 손상 JSON / 파일 없음 → 빈 객체 fallback (no throw) - in-memory cache (load 1회 file read) - zod .strict() schema for ollama { endpoint: URL, model: string } - 단위 +6 cases Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-04 23:23:32 +09:00
altair823	71ec79ae19	docs(ollama-settings): v0.2.3.1 plan — 7 tasks TDD + 10 단위 cases T1 SettingsService (JSON 영속화 + zod, +6 cases) T2 LocalOllamaProvider abort + model param (+2 cases) T3 ProviderHolder + AiWorker/HealthChecker refactor (+2 cases) T4 index 부팅 + IPC + preload + types T5 OllamaSettingsModal + App.tsx + OllamaBanner 링크 T6 트레이 메뉴 "Ollama 설정..." T7 Closure (version 0.2.3 → 0.2.3.1 + gates) 총 신규 단위 +10. 단위 403 → 413. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-04 23:21:00 +09:00
altair823	97ca119b55	docs(ollama-settings): v0.2.3.1 spec — in-app endpoint/model 설정 mini-brainstorm 3개 결정: - Q1=B: Endpoint + Model 둘 다 포함 - Q2=A: Freetext input (dropdown 은 v0.2.4 영역) - Q3=B: JSON file (`<profileDir>/settings.json`, migration v4 회피) 자명 결정 (질문 없이 패턴): - precedence: settings > env > default - in-flight: AbortController abort + provider re-create - UI: 트레이 + OllamaBanner 진입점, React modal - validation: save 전 healthCheck Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-04 23:17:23 +09:00
altair823	b259734aa0	docs(backlog): v0.2.4 backlog memory → repo 이동 v0.2.3 cut 7항목 동안 final reviewer + PR review 에서 발견된 minor/nit 중 의도적 deferred 38건 누적. 기존엔 user-level memory 에만 있어 사용자가 직접 보거나 편집 어려움 → repo 안으로 lift. dogfood 1주 soak 동안 user 가 직접 prune / 우선순위 표시 / 새 항목 추가 가능. v0.2.4 brainstorm 진입 시 본 doc 가 1차 backlog reference. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-04 22:18:07 +09:00