chore(release): v0.3.10 — macOS fullscreen QuickCapture fix

macOS fullscreen Space 위에 QuickCapture 띄우기. 이전엔 핫키 누를 때 강제 Space 전환. quickCaptureWindow.ts darwin 분기 추가: - type: 'panel' (fullscreen floating) - setAlwaysOnTop(true, 'screen-saver') (가장 높은 level) - setVisibleOnAllWorkspaces(true, visibleOnFullScreen: true) Windows / Linux 동작 변경 없음. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
chore(release): v0.3.9 — AI 흐름 unblock UI + FTS5 escape
2026-05-12 13:22:12 +09:00 · 2026-05-11 17:43:46 +09:00 · 2026-05-11 16:50:10 +09:00 · 2026-05-11 16:25:38 +09:00 · 2026-05-11 11:16:14 +09:00
24 changed files with 967 additions and 230 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,128 @@
 본 파일은 Inkling 의 버전별 사용자 영향 변경 사항을 기록한다.
 형식은 [Keep a Changelog](https://keepachangelog.com/) 를 느슨하게 따른다.

+## [0.3.10] — 2026-05-12
+
+macOS fullscreen 환경에서 QuickCapture 핫키 (Cmd+Shift+J) 가 작동하지만 강제로 홈 데스크탑으로 Space 전환 후 표시되던 버그 fix.
+
+### 수정
+
+- **macOS fullscreen Space 위에 QuickCapture 표시 (P1).** 기본 BrowserWindow 는 첫 생성된 Space (홈 데스크탑) 에만 표시 → 사용자가 다른 앱 fullscreen 중에 핫키 누르면 macOS 가 강제로 Space 전환 → 사용자 흐름 단절. `quickCaptureWindow.ts` 에 darwin 분기 추가:
+  - `type: 'panel'` — fullscreen Space 위에 floating 가능한 macOS native panel
+  - `setAlwaysOnTop(true, 'screen-saver')` — fullscreen app 위에 띄울 수 있는 가장 높은 level
+  - `setVisibleOnAllWorkspaces(true, { visibleOnFullScreen: true })` — 현재 Space (fullscreen 포함) 에 함께 표시, Space 전환 차단
+
+Windows / Linux 동작은 변경 없음 (darwin 분기만).
+
+### 게이트
+
+- 단위 750 PASS (변경 없음 — main window 코드는 단위 테스트 대상 아님)
+- typecheck 0 errors (src)
+- 신규 npm dependency 0
+- macOS 사용자 수동 검증 완료
+
+### 업그레이드
+
+v0.3.9 인스톨러 위에 v0.3.10 인스톨러를 같은 위치에 실행하면 in-place 업그레이드. 데이터/마이그레이션 변경 없음.
+
+## [0.3.9] — 2026-05-11
+
+v0.3.8 audit 의 미수정 edge case 3건 완료. AI 처리 흐름의 사용자 unblock path + FTS5 query 안전성.
+
+### 수정
+
+- **`ai_status='pending'` 노트 cancel UI 부재 (P1).** Ollama 끊김 / 무한 pending 상태에서 사용자가 빠져나오는 path 가 없었음. NoteCard 의 pending 표시 옆에 "건너뛰기" 버튼 추가 → `inboxApi.cancelPending(id)` → `repo.cancelPending`: `ai_status='disabled'` + `pending_jobs` DELETE. raw_text 는 보존. pushNoteUpdated emit 으로 renderer 자동 sync.
+- **`ai_status='failed'` 노트 per-note 재시도 UI 부재 (P2).** 이전엔 FailedBanner 의 일괄 재시도만 가능. NoteCard 의 failed 표시 옆에 "재시도" 버튼 추가 → `inboxApi.retryOneFailed(id)` → `repo.retryOneFailed`: failed → pending + `pending_jobs` INSERT + worker enqueue. pushNoteUpdated emit.
+- **FTS5 query escape 불완전 (P2).** `sanitizeFtsQuery` 의 special chars regex 가 `["*():]` 만 처리 → backtick/dash/caret 미escape 로 일부 입력이 FTS5 parser throw 야기. `["*():`^\-]` 로 확장. 한국어 사용자가 의도 없이 입력할 가능성 높은 punctuation 까지 안전 처리.
+
+### 미수정 (의도)
+
+- **동시 편집 race (P2).** EditableField 가 이미 `editing=true` 중 value prop 변경을 무시하는 guard 보유. 사용자 입력은 보존됨 (last-write-wins). 추가 코드 불필요.
+
+### 게이트
+
+- 단위 745 → **750 PASS** (+5: repo retryOneFailed 2 + cancelPending 2 + FTS sanitize 1)
+- typecheck 0 errors (src)
+- 신규 npm dependency 0
+
+### 업그레이드
+
+v0.3.8 인스톨러 위에 v0.3.9 인스톨러를 같은 위치에 실행하면 in-place 업그레이드. 데이터/마이그레이션 변경 없음.
+
+## [0.3.8] — 2026-05-11
+
+전수 audit 후 발견된 사용자 상호작용 hole 8건 일괄 hotfix. 핵심은 (1) push-based status 동기화 root fix, (2) modal Escape affordance 통일, (3) IPC 실패 resilience.
+
+### 수정
+
+- **`inbox:set-status` IPC 가 `pushNoteUpdated` emit 안 함 (root fix).** 이전엔 setStatus 후 counts/list/search 가 모두 stale → 호출처마다 `refreshMeta()` 명시 호출이 필요했음 (v0.3.5 워크어라운드). 이제 IPC 핸들러가 `repo.findById()` 후 `pushNoteUpdated` 호출. renderer 의 `onNoteUpdated` 콜백 1개 path 로 모든 status 전이가 일관 갱신.
+- **`upsertNote` 가 current view 무시 → 잘못된 status 노트 잔류.** 이전엔 trashed 외 모든 status 를 `notes` 에 누적 → 사용자가 inbox 에서 완료로 옮긴 노트가 list 에 잔류. v0.3.8 부터 `viewStatus` (inbox→active, completed→completed, archived→archived) 와 매칭되는 status 만 유지. `searchResults` 도 동일 패턴.
+- **`upsertNote` 의 trash 판정을 `deletedAt` → `status='trashed'` 로 전환.** m004 이후 status 가 single source of truth, deletedAt 은 backward-compat mirror. sync conflict 후 두 컬럼 불일치 가능성 대비.
+- **`restoreNote` 가 status 도 'active' 로 갱신.** 이전엔 `deletedAt: null` 만 clear → upsertNote 가 status='trashed' 그대로 라 여전히 trashNotes 에 잔류.
+- **OnboardingWizard close path 부재.** IPC 실패 시 무한 wizard 잠금 → `try/catch + setBusy/error state + "지금 건너뛰기" 버튼 + Escape` 추가. 첫 launch 사용자 막힘 회피.
+- **Modal Escape key dismiss 통일.** `MoveStatusModal` / `RevisionHistoryModal` / `ConflictModal` / `SyncHelpModal` / `OnboardingWizard` 모두 `keydown` listener 추가. MoveStatusModal 은 overlay 클릭 close 도 추가 (다른 modal 들은 이미 외부 클릭 지원).
+- **`store.ts` async 함수 error-resilient.** `loadInitial` / `loadByView` / `searchNotes` / `loadReview` / `refreshMeta` 가 IPC throw 시 try/catch 로 감싸 무한 loading / stale data 회피. loadInitial 은 catch 시 `loading: false`, loadByView 는 빈 list, searchNotes 는 빈 결과, loadReview 는 빈 aggregate 로 graceful fallback.
+
+### 갱신
+
+- **NoteCard 의 명시적 `refreshMeta` 호출 보존** — onNoteUpdated path 가 이미 refreshMeta 호출하므로 redundant 지만 backup 으로 유지 (2번 fetch 만 발생, 무해).
+
+### 게이트
+
+- 단위 739 → **745 PASS** (+6: view-aware upsertNote 3 + setStatus push emit 1 + Modal Escape 1 + Modal overlay 클릭 1)
+- typecheck 0 errors (src)
+- 신규 npm dependency 0
+
+### 업그레이드
+
+v0.3.7 인스톨러 위에 v0.3.8 인스톨러를 같은 위치에 실행하면 in-place 업그레이드. 데이터/마이그레이션 변경 없음.
+
+### 미수정 (낮은 우선순위 / 별도 작업)
+
+- ai_status='pending' 노트 cancel UI (P1, 별도 spec 필요)
+- ai_status='failed' 노트 per-note 재시도 UI (P2)
+- FTS5 query escape (P2, 확인 필요)
+- 동시 편집 race condition (P2)
+
+## [0.3.7] — 2026-05-11
+
+`MoveStatusModal` 의 button hardcode 로 인해 완료/보관/휴지통 노트가 inbox 로 돌아올 수 없던 버그 fix. v0.2.9 Cut B 부터 존재한 잠재 결함 (dropdown 의 `possibleTargets` 필터가 modal 까지 흐르지 못함).
+
+### 수정
+
+- **완료/보관/휴지통 노트의 Inbox 복원 path 부재.** `MoveStatusModal` 이 `완료/보관/휴지통` 3 button hardcode 라 currentStatus 외 3 status 만 동적으로 노출해야 한다는 의도가 누락. `currentStatus: NoteStatus` prop 추가 + 4 status 중 current 제외 동적 render. NoteCard 가 `local.status` 전달.
+- **status label 일관성** — `statusLabel('active')` 가 '활성' 이었으나 헤더 탭 표기는 'Inbox'. modal button + AI 추천 텍스트 양쪽 모두 'Inbox' 로 통일.
+
+### 게이트
+
+- 단위 736 → **739 PASS** (+3: completed/archived/trashed currentStatus button list 검증)
+- typecheck 0 errors (src)
+- 신규 npm dependency 0
+
+### 업그레이드
+
+v0.3.6 인스톨러 위에 v0.3.7 인스톨러를 같은 위치에 실행하면 in-place 업그레이드. 데이터/마이그레이션 변경 없음.
+
+## [0.3.6] — 2026-05-11
+
+v0.3.5 의 이동 dropdown 단순화가 사용자 의도와 어긋난 점 정정. 이동 modal (사유 + AI 자동 분류 + 수동 status 선택) 은 보존해야 하는 핵심 UX 였음.
+
+### 수정
+
+- **이동 dropdown → 단일 "이동" 버튼 + `MoveStatusModal` 복원.** v0.3.5 에서 dropdown 항목 클릭 = 즉시 setStatus 로 단순화한 path 를 되돌림. 사용자 의도는 dropdown 의 목적지 중복 (modal 도 목적지 묻기) 제거였지, modal 자체 제거가 아니었음. 단일 "이동" 버튼 → modal → 사유 입력 + AI 자동 분류 + 수동 status 선택 path 로 통일.
+- **`MoveStatusModal.tsx` + 테스트 6 case 복원** — v0.3.5 에서 dead code 로 판단해 삭제했으나 다시 mount 됨. statusLabel 헬퍼 위치는 modal 내부로 회귀 (orphan `statusLabel.ts` 제거).
+- **이동 후 `refreshMeta()` 호출 유지** — v0.3.5 D1 fix (setStatus IPC 가 pushNoteUpdated emit 안 함 → 헤더 탭 count stale) 는 modal `onMoved` callback path 에서도 동일하게 트리거.
+
+### 게이트
+
+- 단위 734 → **736 PASS** (NoteCard 이동 case 3 → 2 + MoveStatusModal 6 복원)
+- typecheck 0 errors (src)
+- 신규 npm dependency 0
+
+### 업그레이드
+
+v0.3.5 인스톨러 위에 v0.3.6 인스톨러를 같은 위치에 실행하면 in-place 업그레이드. 데이터/마이그레이션 변경 없음.
+
 ## [0.3.5] — 2026-05-11

 v0.3.4 까지 누적된 dogfood UX 결함 7건 hotfix. 사용자가 막혔던 inbox/회고/이동 3건 + 그 부류의 동반 갭 4건. 데이터/마이그레이션 변경 없음 (스키마 v8 그대로).
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
  "name": "inkling",
-  "version": "0.3.5",
+  "version": "0.3.10",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "inkling",
-      "version": "0.3.5",
+      "version": "0.3.10",
      "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.3.5",
+  "version": "0.3.10",
  "private": true,
  "description": "Inkling — local-first 한 줄 보관 도구",
  "author": "altair823 <dlsrks0734@gmail.com>",
--- a/src/main/ipc/inboxApi.ts
+++ b/src/main/ipc/inboxApi.ts
@@ -150,6 +150,25 @@ export function registerInboxApi(deps: InboxIpcDeps): void {
  ipcMain.handle('inbox:retryAllFailed', async () => deps.capture.retryAllFailed());
  ipcMain.handle('inbox:failedCount', () => deps.repo.countFailed());

+  // v0.3.9 — per-note retry/cancel. failed/pending 사용자 막힘 해소 path.
+  // status 변경 후 pushNoteUpdated 로 renderer counts/list 자동 sync.
+  ipcMain.handle('inbox:retry-one-failed', async (_e, id: string) => {
+    const r = await deps.capture.retryOneFailed(id);
+    if (r.ok) {
+      const updated = deps.repo.findById(id);
+      if (updated !== null) pushNoteUpdated(deps.getInboxWindow, updated);
+    }
+    return r;
+  });
+  ipcMain.handle('inbox:cancel-pending', (_e, id: string) => {
+    const r = deps.capture.cancelPending(id);
+    if (r.ok) {
+      const updated = deps.repo.findById(id);
+      if (updated !== null) pushNoteUpdated(deps.getInboxWindow, updated);
+    }
+    return r;
+  });
+
  ipcMain.handle('inbox:listRecallCandidate', () => deps.capture.listRecallCandidate());
  ipcMain.handle('inbox:markRecallOpened', (_e, id: string) => deps.capture.markRecallOpened(id));
  ipcMain.handle('inbox:dismissRecall', (_e, id: string) => deps.capture.dismissRecall(id));
@@ -198,6 +217,9 @@ export function registerInboxApi(deps: InboxIpcDeps): void {
  // v0.2.9 Cut B Task 8 — status 4분기 직접 전이 (사유 포함).
  // Modal 의 "완료/보관/휴지통" 버튼 path. backward compat 동기화는
  // NoteRepository.setStatus 내부에서 처리 (deleted_at sync).
+  // v0.3.8 — setStatus 도 pushNoteUpdated emit. 이전엔 emit 안 해서 renderer 의 store
+  // (counts/search/list) 가 stale 되어 NoteCard 호출처마다 명시적 refreshMeta 호출이
+  // 필요했음. push 화 시 onNoteUpdated 콜백 1개 path 로 일관 갱신.
  ipcMain.handle(
    'inbox:set-status',
    async (_e, id: string, status: NoteStatus, reason: string | null) => {
@@ -206,6 +228,8 @@ export function registerInboxApi(deps: InboxIpcDeps): void {
        return { ok: false as const, reason: 'invalid status' as const };
      }
      deps.repo.setStatus(id, status, reason);
+      const updated = deps.repo.findById(id);
+      if (updated !== null) pushNoteUpdated(deps.getInboxWindow, updated);
      return { ok: true as const };
    }
  );
--- a/src/main/repository/NoteRepository.ts
+++ b/src/main/repository/NoteRepository.ts
@@ -248,6 +248,47 @@ export class NoteRepository {
    return { ids };
  }

+  /**
+   * v0.3.9 — 단일 failed 노트 재시도. retryAllFailed 의 per-row 로직 동일.
+   * NoteCard 의 per-note "재시도" 버튼 path. failed 가 아닌 status 면 no-op.
+   */
+  retryOneFailed(id: string, now: string): { ok: boolean } {
+    const row = this.db
+      .prepare(`SELECT ai_status FROM notes WHERE id=? AND deleted_at IS NULL`)
+      .get(id) as { ai_status: string } | undefined;
+    if (!row || row.ai_status !== 'failed') return { ok: false };
+    const tx = this.db.transaction(() => {
+      this.db
+        .prepare(`UPDATE notes SET ai_status='pending', ai_error=NULL, updated_at=? WHERE id=?`)
+        .run(now, id);
+      this.db
+        .prepare(`INSERT OR IGNORE INTO pending_jobs (note_id, attempts, next_run_at) VALUES (?, 0, ?)`)
+        .run(id, now);
+    });
+    tx();
+    return { ok: true };
+  }
+
+  /**
+   * v0.3.9 — pending 노트의 AI 처리 cancel. ai_status='disabled' 로 전환 + pending_jobs 삭제.
+   * raw_text 는 보존. 사용자가 무한 pending (Ollama 끊김 등) 에서 빠져나오는 path.
+   * pending 외 status 면 no-op.
+   */
+  cancelPending(id: string, now: string): { ok: boolean } {
+    const row = this.db
+      .prepare(`SELECT ai_status FROM notes WHERE id=? AND deleted_at IS NULL`)
+      .get(id) as { ai_status: string } | undefined;
+    if (!row || row.ai_status !== 'pending') return { ok: false };
+    const tx = this.db.transaction(() => {
+      this.db
+        .prepare(`UPDATE notes SET ai_status='disabled', ai_error=NULL, updated_at=? WHERE id=?`)
+        .run(now, id);
+      this.db.prepare(`DELETE FROM pending_jobs WHERE note_id=?`).run(id);
+    });
+    tx();
+    return { ok: true };
+  }
+
  /**
   * v0.2.9 Cut B Task 16 — 모든 ai_status='disabled' 노트를 'pending' 으로 reset 하고
   * pending_jobs 재투입. 사용자가 settings.ai_enabled OFF→ON 전환 후 "지금 모두 처리"
--- a/src/main/repository/ftsHelpers.ts
+++ b/src/main/repository/ftsHelpers.ts
@@ -4,11 +4,14 @@

 import { KST_OFFSET_MS } from '../../shared/util/kstDate.js';

-const FTS5_SPECIAL_CHARS_RE = /["*():]/g;
+// FTS5 special chars: " * ( ) : 외에도 - (NOT 연산자), ^ (column prefix), ` (escape),
+// AND/OR/NOT keyword 도 query parser 가 special 처리. v0.3.9 — backtick/dash/caret 추가.
+// 한국어 사용자가 의도 없이 입력할 가능성 가장 높은 punctuation 까지 sanitize.
+const FTS5_SPECIAL_CHARS_RE = /["*():`^\-]/g;
 const WS_COLLAPSE_RE = /\s+/g;

 /**
- * FTS5 MATCH 쿼리에 안전한 형태로 변환. " * ( ) : 제거 + 공백 정리.
+ * FTS5 MATCH 쿼리에 안전한 형태로 변환. special chars 공백 치환 + 공백 정리.
 * 다중 토큰은 그대로 두어 FTS5 implicit AND 활용.
 */
 export function sanitizeFtsQuery(input: string): string {
--- a/src/main/services/CaptureService.ts
+++ b/src/main/services/CaptureService.ts
@@ -207,6 +207,24 @@ export class CaptureService {
    return { count: ids.length };
  }

+  /**
+   * v0.3.9 — 단일 failed 노트 재시도. NoteCard 의 per-note "재시도" 버튼 path.
+   * repo.retryOneFailed 후 worker.enqueue 재투입.
+   */
+  async retryOneFailed(id: string): Promise<{ ok: boolean }> {
+    const r = this.repo.retryOneFailed(id, new Date().toISOString());
+    if (r.ok) await this.deps.enqueue(id);
+    return r;
+  }
+
+  /**
+   * v0.3.9 — pending 노트 cancel. ai_status='disabled' + pending_jobs 삭제.
+   * 사용자가 무한 pending (Ollama 끊김 등) 에서 빠져나오는 path.
+   */
+  cancelPending(id: string): { ok: boolean } {
+    return this.repo.cancelPending(id, new Date().toISOString());
+  }
+
  /** v0.2.3 #6 — 회상 후보 1건 fetch. */
  async listRecallCandidate(): Promise<Note | null> {
    return this.repo.findRecallCandidate();
--- a/src/main/windows/quickCaptureWindow.ts
+++ b/src/main/windows/quickCaptureWindow.ts
@@ -16,16 +16,29 @@ export function createQuickCaptureWindow(): BrowserWindowType {
  const x = Math.round((primary.workArea.width - W) / 2 + primary.workArea.x);
  const y = Math.round((primary.workArea.height - H) / 3 + primary.workArea.y);

+  // v0.3.10 — macOS fullscreen Space 위에 quick capture 띄우기.
+  // 기본 BrowserWindow 는 첫 생성된 Space (홈 데스크탑) 에만 표시되므로
+  // 사용자가 다른 앱 fullscreen 중일 때 macOS 가 강제 Space 전환 → 사용자 경험 깨짐.
+  // 'panel' 타입 + 'screen-saver' level + visibleOnFullScreen 조합으로 현재 Space 위에 overlay.
+  const isMac = process.platform === 'darwin';
  win = new BrowserWindow({
    width: W, height: H, x, y,
    frame: false, show: false, alwaysOnTop: true,
    skipTaskbar: true, resizable: false,
+    ...(isMac ? { type: 'panel' as const } : {}),
    webPreferences: {
      preload: join(__dirname, '../preload/index.js'),
      contextIsolation: true, nodeIntegration: false, sandbox: false
    }
  });

+  if (isMac) {
+    // 'screen-saver' level — fullscreen app 위에 띄울 수 있는 가장 높은 level.
+    // visibleOnFullScreen: true — 현재 fullscreen Space 에 함께 표시 (Space 전환 안 함).
+    win.setAlwaysOnTop(true, 'screen-saver');
+    win.setVisibleOnAllWorkspaces(true, { visibleOnFullScreen: true });
+  }
+
  if (process.env.ELECTRON_RENDERER_URL) {
    win.loadURL(`${process.env.ELECTRON_RENDERER_URL}/quickcapture/index.html`);
  } else {
--- a/src/preload/index.ts
+++ b/src/preload/index.ts
@@ -40,6 +40,8 @@ const api: InklingApi = {
    },
    retryAllFailed: () => ipcRenderer.invoke('inbox:retryAllFailed'),
    getFailedCount: () => ipcRenderer.invoke('inbox:failedCount'),
+    retryOneFailed: (id: string) => ipcRenderer.invoke('inbox:retry-one-failed', id),
+    cancelPending: (id: string) => ipcRenderer.invoke('inbox:cancel-pending', id),
    listRecallCandidate: () => ipcRenderer.invoke('inbox:listRecallCandidate'),
    markRecallOpened: (id: string) => ipcRenderer.invoke('inbox:markRecallOpened', id),
    dismissRecall: (id: string) => ipcRenderer.invoke('inbox:dismissRecall', id),
--- a/src/renderer/inbox/components/ConflictModal.tsx
+++ b/src/renderer/inbox/components/ConflictModal.tsx
@@ -38,6 +38,15 @@ export function ConflictModal({ onClose, onResolved, onOpenHelp }: Props): React
    return () => { cancelled = true; };
  }, []);

+  // Escape key 로 닫기.
+  useEffect(() => {
+    function onKey(e: KeyboardEvent) {
+      if (e.key === 'Escape') onClose();
+    }
+    document.addEventListener('keydown', onKey);
+    return () => document.removeEventListener('keydown', onKey);
+  }, [onClose]);
+
  async function onChoose(path: string, choice: 'local' | 'remote') {
    setBusy(path);
    setError(null);
--- a/src/renderer/inbox/components/MoveStatusModal.tsx
+++ b/src/renderer/inbox/components/MoveStatusModal.tsx
@@ -0,0 +1,171 @@
+import React, { useEffect, useState } from 'react';
+import { inboxApi } from '../api.js';
+import type { NoteStatus } from '@shared/types';
+
+interface Props {
+  noteId: string;
+  rawText: string;
+  summary: string;
+  /** 현재 노트 status. 이 값을 제외한 나머지 status 가 이동 버튼으로 노출. */
+  currentStatus: NoteStatus;
+  onClose: () => void;
+  onMoved: (status: NoteStatus, reason: string | null) => void;
+}
+
+/**
+ * 메모 이동 Modal.
+ *
+ * 사유 입력 + AI 자동 분류 + 수동 status 선택. 버튼은 currentStatus 를 제외한
+ * 나머지 status 만 노출 (v0.3.6 까지는 완료/보관/휴지통 hardcode 라 완료/보관 노트가
+ * inbox 로 못 돌아오던 버그를 v0.3.7 에서 정정).
+ */
+const ALL_STATUSES: readonly NoteStatus[] = ['active', 'completed', 'archived', 'trashed'];
+
+export function MoveStatusModal({
+  noteId,
+  currentStatus,
+  onClose,
+  onMoved
+}: Props): React.ReactElement {
+  const [reason, setReason] = useState('');
+  const [recommendation, setRecommendation] = useState<{
+    status: NoteStatus;
+    rationale: string;
+  } | null>(null);
+  const [classifying, setClassifying] = useState(false);
+
+  // Escape key 로 modal 닫기. mount 동안만 listener 활성.
+  useEffect(() => {
+    function onKey(e: KeyboardEvent) {
+      if (e.key === 'Escape') onClose();
+    }
+    document.addEventListener('keydown', onKey);
+    return () => document.removeEventListener('keydown', onKey);
+  }, [onClose]);
+
+  async function move(status: NoteStatus): Promise<void> {
+    const trimmedReason = reason.trim() === '' ? null : reason.trim();
+    await inboxApi.setStatus(noteId, status, trimmedReason);
+    onMoved(status, trimmedReason);
+  }
+
+  async function classify(): Promise<void> {
+    setClassifying(true);
+    setRecommendation(null);
+    try {
+      const r = await inboxApi.classifyStatus(noteId, reason);
+      setRecommendation({ status: r.recommended, rationale: r.rationale });
+    } finally {
+      setClassifying(false);
+    }
+  }
+
+  return (
+    <div
+      role="dialog"
+      aria-label="이동"
+      onClick={onClose}
+      style={{
+        position: 'fixed',
+        top: 0,
+        left: 0,
+        right: 0,
+        bottom: 0,
+        background: 'rgba(0,0,0,0.4)',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        zIndex: 100
+      }}
+    >
+      <div
+        onClick={(e) => e.stopPropagation()}
+        style={{
+          background: '#fff',
+          padding: 16,
+          borderRadius: 8,
+          minWidth: 400,
+          maxWidth: 520
+        }}
+      >
+        <h2 style={{ fontSize: 16, margin: '0 0 12px' }}>메모 이동</h2>
+        <textarea
+          value={reason}
+          onChange={(e) => setReason(e.target.value)}
+          placeholder="이동 사유 (선택사항)"
+          rows={2}
+          style={{ width: '100%', padding: 6, fontSize: 13, boxSizing: 'border-box' }}
+        />
+        <div
+          style={{
+            display: 'flex',
+            gap: 8,
+            marginTop: 8,
+            flexWrap: 'wrap',
+            alignItems: 'center'
+          }}
+        >
+          <button onClick={() => void classify()} disabled={classifying}>
+            {classifying ? '분류 중...' : 'AI 자동 분류'}
+          </button>
+          {ALL_STATUSES.filter((s) => s !== currentStatus).map((s) => (
+            <button key={s} onClick={() => void move(s)}>
+              {statusLabel(s)}
+            </button>
+          ))}
+          <button onClick={onClose} style={{ marginLeft: 'auto' }}>
+            취소
+          </button>
+        </div>
+        {recommendation !== null && (
+          <div
+            style={{
+              marginTop: 12,
+              padding: 8,
+              background: '#f0f8ff',
+              borderRadius: 4,
+              fontSize: 12
+            }}
+          >
+            <div>
+              AI 추천: <strong>{statusLabel(recommendation.status)}</strong>
+            </div>
+            <div style={{ marginTop: 4 }}>이유: {recommendation.rationale}</div>
+            <div style={{ marginTop: 8 }}>
+              <button onClick={() => void move(recommendation.status)}>
+                확정 ({statusLabel(recommendation.status)})
+              </button>
+            </div>
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}
+
+export function statusLabel(s: NoteStatus): string {
+  switch (s) {
+    case 'active':
+      // 헤더 탭 표기 ('Inbox') 와 일치. UI 전반에서 active = Inbox 동의어.
+      return 'Inbox';
+    case 'completed':
+      return '완료';
+    case 'archived':
+      return '보관';
+    case 'trashed':
+      return '휴지통';
+  }
+}
+
+/**
+ * status 의 한글 라벨에 적절한 조사를 붙여 반환. 받침 있으면 "으로", 없으면 "로".
+ * 예: '완료로' / '보관으로' / '휴지통으로' / '활성으로'.
+ */
+export function statusLabelWithParticle(s: NoteStatus): string {
+  const label = statusLabel(s);
+  const last = label.charCodeAt(label.length - 1);
+  // 한글 syllable block 외 → "로" default
+  if (last < 0xAC00 || last > 0xD7A3) return `${label}로`;
+  const jongseong = (last - 0xAC00) % 28;
+  return jongseong === 0 ? `${label}로` : `${label}으로`;
+}
--- a/src/renderer/inbox/components/NoteCard.tsx
+++ b/src/renderer/inbox/components/NoteCard.tsx
@@ -1,12 +1,12 @@
-import React, { useEffect, useRef, useState } from 'react';
-import type { Note, NoteStatus } from '@shared/types';
+import React, { useState } from 'react';
+import type { Note } from '@shared/types';
 import { KST_OFFSET_MS } from '@shared/util/kstDate.js';
 import { inboxApi } from '../api.js';
 import { useInbox } from '../store.js';
 import { EditableField } from './EditableField.js';
 import { IntentBanner } from './IntentBanner.js';
 import { pushTagUndo } from './TagUndoToast.js';
-import { statusLabelWithParticle } from './statusLabel.js';
+import { MoveStatusModal } from './MoveStatusModal.js';
 import { RevisionHistoryModal } from './RevisionHistoryModal.js';

 interface Props {
@@ -116,38 +116,14 @@ export function NoteCard({ note, onDeleted, onUpdated, mode = 'inbox', onRestore
  const [local, setLocal] = useState(note);
  const isAiDisabled = local.aiStatus === 'disabled';
  const fallbackTitle = local.rawText.split('\n')[0]?.slice(0, 60) || '(빈 메모)';
-  // v0.2.9 Cut B Task 6 — 이동 메뉴 dropdown. dropdown 항목 클릭 = 해당 status 로 즉시 이동.
-  const [menuOpen, setMenuOpen] = useState(false);
-  const menuRef = useRef<HTMLDivElement | null>(null);
+  // 이동 modal 열림 여부. 클릭 시 MoveStatusModal 에서 사유 + AI 분류 + 수동 분류 선택.
+  const [moveOpen, setMoveOpen] = useState(false);
  const [editingRaw, setEditingRaw] = useState(false);
  const [draftRaw, setDraftRaw] = useState('');
  const [showRevisions, setShowRevisions] = useState(false);

-  const possibleTargets: NoteStatus[] = (
-    ['active', 'completed', 'archived', 'trashed'] as NoteStatus[]
-  ).filter((s) => s !== local.status);
-
  React.useEffect(() => { setLocal(note); }, [note]);

-  // 이동 dropdown 외부 클릭 / Escape 로 닫기. menuOpen=true 일 때만 listener 활성.
-  useEffect(() => {
-    if (!menuOpen) return;
-    function onMouseDown(e: MouseEvent) {
-      if (menuRef.current && !menuRef.current.contains(e.target as Node)) {
-        setMenuOpen(false);
-      }
-    }
-    function onKey(e: KeyboardEvent) {
-      if (e.key === 'Escape') setMenuOpen(false);
-    }
-    document.addEventListener('mousedown', onMouseDown);
-    document.addEventListener('keydown', onKey);
-    return () => {
-      document.removeEventListener('mousedown', onMouseDown);
-      document.removeEventListener('keydown', onKey);
-    };
-  }, [menuOpen]);
-
  const formatted = new Date(note.createdAt).toLocaleString('ko-KR');

  async function saveTitle(next: string) {
@@ -239,13 +215,44 @@ export function NoteCard({ note, onDeleted, onUpdated, mode = 'inbox', onRestore
      )}

      {local.aiStatus === 'pending' && (
-        <div style={{ fontSize: 16, fontWeight: 600, color: '#666', marginTop: 4 }}>
-          Inkling이 정리하는 중…
+        <div style={{ marginTop: 4, display: 'flex', alignItems: 'center', gap: 8 }}>
+          <div style={{ fontSize: 16, fontWeight: 600, color: '#666' }}>
+            Inkling이 정리하는 중…
+          </div>
+          {/* v0.3.9 — pending cancel UI. Ollama 끊김 / 무한 pending 시 사용자 unblock path. */}
+          <button
+            onClick={async () => {
+              await inboxApi.cancelPending(local.id);
+              // push 기반 — onNoteUpdated 가 store 자동 갱신.
+            }}
+            style={{
+              background: 'none', border: '1px solid #ccc', color: '#666',
+              cursor: 'pointer', fontSize: 11, padding: '2px 8px', borderRadius: 4
+            }}
+            title="AI 자동 처리를 건너뛰고 원문만 보관"
+          >
+            건너뛰기
+          </button>
        </div>
      )}
      {local.aiStatus === 'failed' && (
-        <div title={local.aiError ?? ''} style={{ fontSize: 16, fontWeight: 600, color: '#a55', marginTop: 4 }}>
-          정리 보류 — 원문은 안전합니다
+        <div style={{ marginTop: 4, display: 'flex', alignItems: 'center', gap: 8 }}>
+          <div title={local.aiError ?? ''} style={{ fontSize: 16, fontWeight: 600, color: '#a55' }}>
+            정리 보류 — 원문은 안전합니다
+          </div>
+          {/* v0.3.9 — per-note 재시도 UI. FailedBanner 의 일괄 재시도와 별개. */}
+          <button
+            onClick={async () => {
+              await inboxApi.retryOneFailed(local.id);
+            }}
+            style={{
+              background: 'none', border: '1px solid #a55', color: '#a55',
+              cursor: 'pointer', fontSize: 11, padding: '2px 8px', borderRadius: 4
+            }}
+            title="이 노트만 AI 처리 재시도"
+          >
+            재시도
+          </button>
        </div>
      )}
      {/* v0.2.9 Cut B Task 13 — ai_status='disabled': raw_text 첫 줄 fallback title.
@@ -443,71 +450,23 @@ export function NoteCard({ note, onDeleted, onUpdated, mode = 'inbox', onRestore
            alignItems: 'center'
          }}
        >
-          {/* v0.2.9 Cut B Task 6 — 모든 view 공통 "이동 ▾" dropdown.
-              현재 status 와 다른 3개 목적지만 표시. */}
-          <div ref={menuRef} style={{ position: 'relative' }}>
-            <button
-              onClick={() => setMenuOpen((o) => !o)}
-              aria-label="이동"
-              style={{
-                background: 'none',
-                border: '1px solid #ccc',
-                color: '#444',
-                cursor: 'pointer',
-                fontSize: 12,
-                padding: '4px 10px',
-                borderRadius: 4
-              }}
-            >
-              이동 ▾
-            </button>
-            {menuOpen && (
-              <div
-                style={{
-                  position: 'absolute',
-                  right: 0,
-                  top: '100%',
-                  marginTop: 2,
-                  background: '#fff',
-                  border: '1px solid #ccc',
-                  borderRadius: 4,
-                  padding: 4,
-                  zIndex: 10,
-                  minWidth: 140,
-                  boxShadow: '0 2px 6px rgba(0,0,0,0.08)'
-                }}
-              >
-                {possibleTargets.map((t) => (
-                  <button
-                    key={t}
-                    onClick={async () => {
-                      setMenuOpen(false);
-                      await inboxApi.setStatus(local.id, t, null);
-                      const updated = { ...local, status: t, moveReason: null };
-                      setLocal(updated);
-                      onUpdated(updated);
-                      if (t !== local.status) onDeleted?.();
-                      // setStatus IPC 는 pushNoteUpdated emit 안 함 → 헤더 탭 counts 가 stale.
-                      // refreshMeta 로 server-authoritative counts 재로드.
-                      void useInbox.getState().refreshMeta();
-                    }}
-                    style={{
-                      display: 'block',
-                      width: '100%',
-                      textAlign: 'left',
-                      background: 'none',
-                      border: 'none',
-                      padding: '6px 8px',
-                      fontSize: 12,
-                      cursor: 'pointer'
-                    }}
-                  >
-                    {statusLabelWithParticle(t)} 이동
-                  </button>
-                ))}
-              </div>
-            )}
-          </div>
+          {/* 이동 버튼 — 클릭 시 MoveStatusModal 진입.
+              사유 입력 + AI 자동 분류 + 수동 status 선택 한 곳에서 처리. */}
+          <button
+            onClick={() => setMoveOpen(true)}
+            aria-label="이동"
+            style={{
+              background: 'none',
+              border: '1px solid #ccc',
+              color: '#444',
+              cursor: 'pointer',
+              fontSize: 12,
+              padding: '4px 10px',
+              borderRadius: 4
+            }}
+          >
+            이동
+          </button>

          {/* trash mode 만 영구 삭제 + 복구 보존 (휴지통 단독 액션). */}
          {isTrash && (
@@ -535,6 +494,26 @@ export function NoteCard({ note, onDeleted, onUpdated, mode = 'inbox', onRestore
        </div>
      </div>

+      {moveOpen && (
+        <MoveStatusModal
+          noteId={local.id}
+          rawText={local.rawText}
+          summary={local.aiSummary ?? ''}
+          currentStatus={local.status}
+          onClose={() => setMoveOpen(false)}
+          onMoved={(newStatus, reason) => {
+            const updated = { ...local, status: newStatus, moveReason: reason };
+            setLocal(updated);
+            onUpdated(updated);
+            // inbox/완료/보관/휴지통 view 의 list 가 status 별로 필터되므로 status 변경 시 onDeleted 호출.
+            if (newStatus !== local.status) onDeleted?.();
+            // setStatus IPC 는 pushNoteUpdated emit 안 함 → 헤더 탭 counts 가 stale.
+            // refreshMeta 로 server-authoritative counts 재로드.
+            void useInbox.getState().refreshMeta();
+            setMoveOpen(false);
+          }}
+        />
+      )}
      {showRevisions && (
        <RevisionHistoryModal
          noteId={local.id}
--- a/src/renderer/inbox/components/OnboardingWizard.tsx
+++ b/src/renderer/inbox/components/OnboardingWizard.tsx
@@ -1,4 +1,4 @@
-import React from 'react';
+import React, { useEffect, useState } from 'react';
 import { inboxApi } from '../api.js';

 /**
@@ -10,12 +10,42 @@ import { inboxApi } from '../api.js';
 * 가 SettingsPage 에서 추후 선택 가능.
 */
 export function OnboardingWizard({ onClose }: { onClose: () => void }): React.ReactElement {
+  const [busy, setBusy] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
  async function choose(aiEnabled: boolean | null): Promise<void> {
-    if (aiEnabled !== null) await inboxApi.setAiEnabled(aiEnabled);
-    await inboxApi.setOnboardingCompleted(true);
+    setBusy(true);
+    setError(null);
+    try {
+      if (aiEnabled !== null) await inboxApi.setAiEnabled(aiEnabled);
+      await inboxApi.setOnboardingCompleted(true);
+      onClose();
+    } catch (e) {
+      // IPC 실패 (예: settings 저장 throw) 시 modal stuck 방지. 사용자에게 메시지 표시 +
+      // "지금 건너뛰기" 로 fallback 길 제공. choose() 가 throw 하지 않고 무한 wizard 잠금
+      // 회피.
+      setError((e as Error).message);
+    } finally {
+      setBusy(false);
+    }
+  }
+
+  function skip(): void {
+    // IPC 자체가 실패하는 상태 → ai_enabled 변경/onboarding flag 저장 모두 포기하고 wizard 만 닫기.
+    // 다음 launch 에 다시 wizard 가 뜸 (onboarding_completed=false 상태). 그래도 사용자가
+    // 진입 자체는 가능.
    onClose();
  }

+  // Escape key 로 wizard 종료 (skip 동일 — onboarding flag 미저장).
+  useEffect(() => {
+    function onKey(e: KeyboardEvent) {
+      if (e.key === 'Escape') skip();
+    }
+    document.addEventListener('keydown', onKey);
+    return () => document.removeEventListener('keydown', onKey);
+  }, []);
+
  return (
    <div role="dialog" aria-label="시작 안내" style={{
      position: 'fixed', top: 0, left: 0, right: 0, bottom: 0,
@@ -32,10 +62,16 @@ export function OnboardingWizard({ onClose }: { onClose: () => void }): React.Re
          <a href="https://ollama.com/download" target="_blank" rel="noopener noreferrer">ollama.com/download</a>
        </p>
        <div style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
-          <button onClick={() => choose(true)}>AI 자동 처리 사용 (Ollama 필요)</button>
-          <button onClick={() => choose(false)}>원문만 저장 (AI 처리 안 함)</button>
-          <button onClick={() => choose(null)} style={{ marginTop: 4 }}>나중에 설정</button>
+          <button onClick={() => choose(true)} disabled={busy}>AI 자동 처리 사용 (Ollama 필요)</button>
+          <button onClick={() => choose(false)} disabled={busy}>원문만 저장 (AI 처리 안 함)</button>
+          <button onClick={() => choose(null)} disabled={busy} style={{ marginTop: 4 }}>나중에 설정</button>
        </div>
+        {error !== null && (
+          <div style={{ marginTop: 12, padding: 8, background: '#fdecea', color: '#a3261c', fontSize: 12, borderRadius: 4 }}>
+            <div>설정 저장 실패: {error}</div>
+            <button onClick={skip} style={{ marginTop: 8 }}>지금 건너뛰기</button>
+          </div>
+        )}
      </div>
    </div>
  );
--- a/src/renderer/inbox/components/RevisionHistoryModal.tsx
+++ b/src/renderer/inbox/components/RevisionHistoryModal.tsx
@@ -37,6 +37,15 @@ export function RevisionHistoryModal({ noteId, onClose, onRestored }: Props): Re
  const [loading, setLoading] = useState(true);
  const [error, setError] = useState<string | null>(null);

+  // Escape key 로 닫기.
+  useEffect(() => {
+    function onKey(e: KeyboardEvent) {
+      if (e.key === 'Escape') onClose();
+    }
+    document.addEventListener('keydown', onKey);
+    return () => document.removeEventListener('keydown', onKey);
+  }, [onClose]);
+
  useEffect(() => {
    let cancelled = false;
    void (async () => {
--- a/src/renderer/inbox/components/SyncHelpModal.tsx
+++ b/src/renderer/inbox/components/SyncHelpModal.tsx
@@ -36,6 +36,15 @@ export function SyncHelpModal({ onClose, initialAnchor }: Props): React.ReactEle
    if (el) el.scrollIntoView({ behavior: 'auto', block: 'start' });
  }, [initialAnchor]);

+  // Escape key 로 닫기.
+  useEffect(() => {
+    function onKey(e: KeyboardEvent) {
+      if (e.key === 'Escape') onClose();
+    }
+    document.addEventListener('keydown', onKey);
+    return () => document.removeEventListener('keydown', onKey);
+  }, [onClose]);
+
  return (
    <div style={overlayStyle} onClick={onClose}>
      <div ref={bodyRef} style={modalStyle} onClick={(e) => e.stopPropagation()}>
--- a/src/renderer/inbox/components/statusLabel.ts
+++ b/src/renderer/inbox/components/statusLabel.ts
@@ -1,26 +0,0 @@
-import type { NoteStatus } from '@shared/types';
-
-export function statusLabel(s: NoteStatus): string {
-  switch (s) {
-    case 'active':
-      return '활성';
-    case 'completed':
-      return '완료';
-    case 'archived':
-      return '보관';
-    case 'trashed':
-      return '휴지통';
-  }
-}
-
-/**
- * status 의 한글 라벨에 적절한 조사를 붙여 반환. 받침 있으면 "으로", 없으면 "로".
- * 예: '완료로' / '보관으로' / '휴지통으로' / '활성으로'.
- */
-export function statusLabelWithParticle(s: NoteStatus): string {
-  const label = statusLabel(s);
-  const last = label.charCodeAt(label.length - 1);
-  if (last < 0xAC00 || last > 0xD7A3) return `${label}로`;
-  const jongseong = (last - 0xAC00) % 28;
-  return jongseong === 0 ? `${label}로` : `${label}으로`;
-}
--- a/src/renderer/inbox/store.ts
+++ b/src/renderer/inbox/store.ts
@@ -102,68 +102,117 @@ export const useInbox = create<InboxState>((set, get) => ({
  searchResults: null,
  reviewData: null,
  async loadInitial() {
+    // v0.3.8 — IPC 실패 시 loading=true 영구 stuck 방지. catch 로 reset.
    set({ loading: true });
-    const [notes, continuity, pendingCount, ollamaStatus, todayCount, trashCount, expiredCandidates, failedCount, recallCandidate, counts, settings] = await Promise.all([
-      // inbox 탭은 status='active' 만 표시 — loadByView('inbox') 와 동일 path 로 일관성 확보.
-      // listNotes 는 deleted_at IS NULL 만 필터 (= active+completed+archived 혼재) 이라 부정확.
-      inboxApi.listByStatus('active', { limit: 50 }),
-      inboxApi.getContinuity(),
-      inboxApi.getPendingCount(),
-      inboxApi.getOllamaStatus(),
-      inboxApi.getTodayCount(),
-      inboxApi.getTrashCount(),
-      inboxApi.listExpired(),
-      inboxApi.getFailedCount(),
-      inboxApi.listRecallCandidate(),
-      inboxApi.countsByStatus(),
-      inboxApi.getSettings()
-    ]);
-    set({ notes, continuity, pendingCount, ollamaStatus, todayCount, trashCount, expiredCandidates, failedCount, recallCandidate, counts, ai_enabled: settings.ai_enabled ?? true, loading: false });
+    try {
+      const [notes, continuity, pendingCount, ollamaStatus, todayCount, trashCount, expiredCandidates, failedCount, recallCandidate, counts, settings] = await Promise.all([
+        // inbox 탭은 status='active' 만 표시 — loadByView('inbox') 와 동일 path 로 일관성 확보.
+        // listNotes 는 deleted_at IS NULL 만 필터 (= active+completed+archived 혼재) 이라 부정확.
+        inboxApi.listByStatus('active', { limit: 50 }),
+        inboxApi.getContinuity(),
+        inboxApi.getPendingCount(),
+        inboxApi.getOllamaStatus(),
+        inboxApi.getTodayCount(),
+        inboxApi.getTrashCount(),
+        inboxApi.listExpired(),
+        inboxApi.getFailedCount(),
+        inboxApi.listRecallCandidate(),
+        inboxApi.countsByStatus(),
+        inboxApi.getSettings()
+      ]);
+      set({ notes, continuity, pendingCount, ollamaStatus, todayCount, trashCount, expiredCandidates, failedCount, recallCandidate, counts, ai_enabled: settings.ai_enabled ?? true, loading: false });
+    } catch (e) {
+      // 첫 launch 의 IPC 실패 (DB migration 실패 / main process 비정상) 시 무한 loading 회피.
+      // 빈 데이터로 진입하면 사용자가 캡처 시도 → 실제 fail 이 표면화 → 재시도 가능.
+      console.error('[inbox] loadInitial failed', e);
+      set({ loading: false });
+    }
  },
  async refreshMeta() {
-    const [continuity, pendingCount, ollamaStatus, todayCount, trashCount, expiredCandidates, failedCount, recallCandidate, counts, settings] = await Promise.all([
-      inboxApi.getContinuity(),
-      inboxApi.getPendingCount(),
-      inboxApi.getOllamaStatus(),
-      inboxApi.getTodayCount(),
-      inboxApi.getTrashCount(),
-      inboxApi.listExpired(),
-      inboxApi.getFailedCount(),
-      inboxApi.listRecallCandidate(),
-      inboxApi.countsByStatus(),
-      inboxApi.getSettings()
-    ]);
-    set({ continuity, pendingCount, ollamaStatus, todayCount, trashCount, expiredCandidates, failedCount, recallCandidate, counts, ai_enabled: settings.ai_enabled ?? true });
+    try {
+      const [continuity, pendingCount, ollamaStatus, todayCount, trashCount, expiredCandidates, failedCount, recallCandidate, counts, settings] = await Promise.all([
+        inboxApi.getContinuity(),
+        inboxApi.getPendingCount(),
+        inboxApi.getOllamaStatus(),
+        inboxApi.getTodayCount(),
+        inboxApi.getTrashCount(),
+        inboxApi.listExpired(),
+        inboxApi.getFailedCount(),
+        inboxApi.listRecallCandidate(),
+        inboxApi.countsByStatus(),
+        inboxApi.getSettings()
+      ]);
+      set({ continuity, pendingCount, ollamaStatus, todayCount, trashCount, expiredCandidates, failedCount, recallCandidate, counts, ai_enabled: settings.ai_enabled ?? true });
+    } catch (e) {
+      // refreshMeta 는 background poll/event 에서 자주 호출 → fail 무시 (다음 호출에 회복).
+      console.error('[inbox] refreshMeta failed', e);
+    }
  },
  upsertNote(note) {
-    // trashCount 는 server-authoritative. trashNotes 가 cache-loaded (showTrash=true) 일
-    // 때만 trashCount 를 local recompute. 그 외엔 server 값 (refreshMeta) 보존.
-    const showTrash = get().showTrash;
-    if (note.deletedAt !== null) {
-      // trash 노트: notes 에서 제거 + trashNotes 에 upsert
-      const cleanNotes = get().notes.filter((n) => n.id !== note.id);
-      const ti = get().trashNotes.findIndex((n) => n.id === note.id);
-      const nextTrash = get().trashNotes.slice();
-      if (ti >= 0) nextTrash[ti] = note;
+    // v0.3.8 — status 가 current view 와 매칭될 때만 notes 에 유지. 그 외엔 제거.
+    // 이전 구현은 trashed 외 모든 status 를 notes 에 누적 → 사용자가 inbox view 에서
+    // 완료/보관 으로 옮긴 노트가 list 에 잔류하는 버그. push-based (setStatus 도 emit) 로
+    // 모든 status 전이가 upsertNote 를 거치므로 view-aware filter 가 필수.
+    //
+    // trashCount/trashNotes 는 server-authoritative. trashNotes 가 cache-loaded
+    // (view='trash') 일 때만 trashCount 를 local recompute. 그 외엔 server 값
+    // (refreshMeta) 보존. searchResults 도 별도로 갱신 (status 변경 시 list 에서 제거).
+    const state = get();
+    const view = state.view;
+    const showTrash = state.showTrash;
+    const viewStatus: 'active' | 'completed' | 'archived' | 'trashed' | null =
+      view === 'inbox' ? 'active' :
+      view === 'completed' ? 'completed' :
+      view === 'archived' ? 'archived' :
+      view === 'trash' ? 'trashed' : null;
+
+    // trashNotes — note.status='trashed' 면 upsert, 아니면 제거.
+    const cleanTrash = state.trashNotes.filter((n) => n.id !== note.id);
+    let nextTrash = cleanTrash;
+    if (note.status === 'trashed') {
+      const ti = state.trashNotes.findIndex((n) => n.id === note.id);
+      nextTrash = cleanTrash.slice();
+      if (ti >= 0) nextTrash.splice(ti, 0, note);
      else nextTrash.unshift(note);
-      set({
-        notes: cleanNotes,
-        trashNotes: nextTrash,
-        ...(showTrash ? { trashCount: nextTrash.length } : {})
-      });
-    } else {
-      // active 노트: trashNotes 에서 제거 + notes 에 upsert (restore 케이스 포함)
-      const cleanTrash = get().trashNotes.filter((n) => n.id !== note.id);
-      const i = get().notes.findIndex((n) => n.id === note.id);
-      const nextNotes = get().notes.slice();
-      if (i >= 0) nextNotes[i] = note;
-      else nextNotes.unshift(note);
-      set({
-        notes: nextNotes,
-        trashNotes: cleanTrash,
-        ...(showTrash ? { trashCount: cleanTrash.length } : {})
-      });
    }
+
+    // notes — current view 의 status 와 매칭되는 경우만 유지/upsert.
+    // viewStatus=null (review/settings/검색) 이면 notes 직접 렌더 안 함 → 갱신 skip.
+    const cleanNotes = state.notes.filter((n) => n.id !== note.id);
+    let nextNotes = state.notes;
+    if (viewStatus !== null) {
+      if (note.status === viewStatus) {
+        const i = state.notes.findIndex((n) => n.id === note.id);
+        nextNotes = cleanNotes.slice();
+        if (i >= 0) nextNotes.splice(i, 0, note);
+        else nextNotes.unshift(note);
+      } else {
+        nextNotes = cleanNotes;
+      }
+    }
+
+    // searchResults — null 아니면 동일 패턴으로 갱신 (status 가 current search status 와
+    // 안 맞으면 제거, 맞으면 upsert).
+    let nextSearch = state.searchResults;
+    if (state.searchResults !== null) {
+      const cleanSearch = state.searchResults.filter((n) => n.id !== note.id);
+      if (viewStatus === null || note.status === viewStatus) {
+        // search 가 active 한 view 가 review/settings 면 status filter 없음 → 모두 keep.
+        const i = state.searchResults.findIndex((n) => n.id === note.id);
+        nextSearch = cleanSearch.slice();
+        if (i >= 0) nextSearch.splice(i, 0, note);
+        else nextSearch.unshift(note);
+      } else {
+        nextSearch = cleanSearch;
+      }
+    }
+
+    set({
+      notes: nextNotes,
+      trashNotes: nextTrash,
+      searchResults: nextSearch,
+      ...(showTrash ? { trashCount: nextTrash.length } : {})
+    });
  },
  removeNote(id) {
    const cleanNotes = get().notes.filter((n) => n.id !== id);
@@ -204,13 +253,21 @@ export const useInbox = create<InboxState>((set, get) => ({
    if (view === 'review-monthly') void get().loadReview('monthly');
  },
  async loadByView(view) {
+    // v0.3.8 — IPC 실패 시 stale 한 이전 view 의 notes 가 계속 노출되는 사고 방지.
+    // fail 시 빈 배열로 reset 해서 사용자에게 "비어있음" 으로 표시 (혼동 < stale).
    const status =
      view === 'trash' ? 'trashed' : view === 'inbox' ? 'active' : view;
-    const notes = await inboxApi.listByStatus(status, { limit: 200 });
-    if (view === 'trash') {
-      set({ trashNotes: notes, trashCount: notes.length });
-    } else {
-      set({ notes });
+    try {
+      const notes = await inboxApi.listByStatus(status, { limit: 200 });
+      if (view === 'trash') {
+        set({ trashNotes: notes, trashCount: notes.length });
+      } else {
+        set({ notes });
+      }
+    } catch (e) {
+      console.error('[inbox] loadByView failed', view, e);
+      if (view === 'trash') set({ trashNotes: [] });
+      else set({ notes: [] });
    }
  },
  async toggleShowTrash() {
@@ -225,11 +282,12 @@ export const useInbox = create<InboxState>((set, get) => ({
  async restoreNote(id) {
    await inboxApi.restoreNote(id);
    // 낙관적 갱신: main 은 trash/restore 시 pushNoteUpdated 를 보내지 않음
-    // (현재 AiWorker.onUpdate 만 push). 자가 반영이 primary 메커니즘.
+    // (현재 AiWorker.onUpdate + setStatus 만 push). 자가 반영이 primary 메커니즘.
    // 전제: 호출 시점에 trashNotes 에 노트가 존재 (T14 trash view 한정 호출).
+    // v0.3.8 — status 도 'active' 로 함께 갱신. upsertNote 가 status='trashed' 만 trash 로 라우팅.
    const note = get().trashNotes.find((n) => n.id === id);
    if (note) {
-      get().upsertNote({ ...note, deletedAt: null });
+      get().upsertNote({ ...note, deletedAt: null, status: 'active' });
    }
  },
  async permanentDeleteNote(id) {
@@ -306,14 +364,27 @@ export const useInbox = create<InboxState>((set, get) => ({
    const status = view === 'completed' || view === 'archived' || view === 'trash'
      ? (view === 'trash' ? 'trashed' : view)
      : view === 'inbox' ? 'active' : undefined;
-    const r = await inboxApi.search(q, status ? { status } : {});
-    set({ searchResults: r });
+    try {
+      const r = await inboxApi.search(q, status ? { status } : {});
+      set({ searchResults: r });
+    } catch (e) {
+      // FTS5 query parse error (special char 미escape) / IPC fail → 빈 결과로.
+      console.error('[inbox] searchNotes failed', e);
+      set({ searchResults: [] });
+    }
  },
  clearSearch() {
    set({ searchQuery: '', searchResults: null });
  },
  async loadReview(period) {
-    const data = await inboxApi.reviewAggregate(period);
-    set({ reviewData: data });
+    try {
+      const data = await inboxApi.reviewAggregate(period);
+      set({ reviewData: data });
+    } catch (e) {
+      // review IPC fail 시 reviewData=null → ReviewView 의 "불러오는 중…" 영구 표시 회피.
+      // 빈 aggregate 로 set 해서 사용자에게 "0건" 표기.
+      console.error('[inbox] loadReview failed', period, e);
+      set({ reviewData: { totalCount: 0, tagCounts: [], dueProgress: { total: 0, passed: 0, pending: 0 }, recentNotes: [] } });
+    }
  }
 }));
--- a/src/shared/types.ts
+++ b/src/shared/types.ts
@@ -149,6 +149,9 @@ export interface InboxApi {
  onOllamaStatus(cb: (status: { ok: boolean; reason?: string }) => void): () => void;
  retryAllFailed(): Promise<{ count: number }>;
  getFailedCount(): Promise<number>;
+  // v0.3.9 — per-note retry/cancel. failed/pending 노트의 사용자 unblock path.
+  retryOneFailed(id: string): Promise<{ ok: boolean }>;
+  cancelPending(id: string): Promise<{ ok: boolean }>;
  listRecallCandidate(): Promise<Note | null>;
  markRecallOpened(id: string): Promise<{ note: Note }>;
  dismissRecall(id: string): Promise<{ note: Note }>;
--- a/tests/unit/MoveStatusModal.test.tsx
+++ b/tests/unit/MoveStatusModal.test.tsx
@@ -0,0 +1,191 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import '@testing-library/jest-dom/vitest';
+import { render, screen, fireEvent, cleanup, waitFor } from '@testing-library/react';
+
+const { mockSetStatus, mockClassify } = vi.hoisted(() => ({
+  mockSetStatus: vi.fn(async () => ({ ok: true as const })),
+  mockClassify: vi.fn(async () => ({
+    recommended: 'completed' as const,
+    rationale: '결재 끝'
+  }))
+}));
+
+vi.mock('../../src/renderer/inbox/api.js', () => ({
+  inboxApi: {
+    setStatus: mockSetStatus,
+    classifyStatus: mockClassify
+  }
+}));
+
+import { MoveStatusModal } from '../../src/renderer/inbox/components/MoveStatusModal';
+
+describe('MoveStatusModal', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    cleanup();
+  });
+
+  it('renders reason textarea + 4 buttons + AI classify button', () => {
+    render(
+      <MoveStatusModal
+        noteId="n1"
+        rawText="t"
+        summary=""
+        currentStatus="active"
+        onClose={vi.fn()}
+        onMoved={vi.fn()}
+      />
+    );
+    expect(screen.getByRole('textbox')).toBeInTheDocument();
+    expect(screen.getByRole('button', { name: '완료' })).toBeInTheDocument();
+    expect(screen.getByRole('button', { name: '보관' })).toBeInTheDocument();
+    expect(screen.getByRole('button', { name: '휴지통' })).toBeInTheDocument();
+    expect(screen.getByRole('button', { name: /AI 자동 분류/ })).toBeInTheDocument();
+  });
+
+  it('clicking 완료 calls setStatus with reason', async () => {
+    const onMoved = vi.fn();
+    render(
+      <MoveStatusModal
+        noteId="n1"
+        rawText="t"
+        summary=""
+        currentStatus="active"
+        onClose={vi.fn()}
+        onMoved={onMoved}
+      />
+    );
+    fireEvent.change(screen.getByRole('textbox'), { target: { value: '결재 끝' } });
+    fireEvent.click(screen.getByRole('button', { name: '완료' }));
+    await waitFor(() => {
+      expect(mockSetStatus).toHaveBeenCalledWith('n1', 'completed', '결재 끝');
+      expect(onMoved).toHaveBeenCalledWith('completed', '결재 끝');
+    });
+  });
+
+  it('AI 자동 분류 → recommendation 표시 + 확정 → setStatus', async () => {
+    const onMoved = vi.fn();
+    render(
+      <MoveStatusModal
+        noteId="n1"
+        rawText="t"
+        summary=""
+        currentStatus="active"
+        onClose={vi.fn()}
+        onMoved={onMoved}
+      />
+    );
+    fireEvent.change(screen.getByRole('textbox'), { target: { value: '결재 끝' } });
+    fireEvent.click(screen.getByRole('button', { name: /AI 자동 분류/ }));
+    await screen.findByText(/AI 추천/);
+    expect(screen.getByText(/이유: 결재 끝/)).toBeInTheDocument();
+    fireEvent.click(screen.getByRole('button', { name: /확정/ }));
+    await waitFor(() => expect(onMoved).toHaveBeenCalledWith('completed', '결재 끝'));
+  });
+
+  it('currentStatus=completed → Inbox/보관/휴지통 노출, 완료 미노출', () => {
+    render(
+      <MoveStatusModal
+        noteId="n1"
+        rawText="t"
+        summary=""
+        currentStatus="completed"
+        onClose={vi.fn()}
+        onMoved={vi.fn()}
+      />
+    );
+    expect(screen.getByRole('button', { name: 'Inbox' })).toBeInTheDocument();
+    expect(screen.getByRole('button', { name: '보관' })).toBeInTheDocument();
+    expect(screen.getByRole('button', { name: '휴지통' })).toBeInTheDocument();
+    expect(screen.queryByRole('button', { name: '완료' })).toBeNull();
+  });
+
+  it('currentStatus=archived → Inbox 버튼 클릭 시 setStatus("active") 호출', async () => {
+    const onMoved = vi.fn();
+    render(
+      <MoveStatusModal
+        noteId="n1"
+        rawText="t"
+        summary=""
+        currentStatus="archived"
+        onClose={vi.fn()}
+        onMoved={onMoved}
+      />
+    );
+    fireEvent.click(screen.getByRole('button', { name: 'Inbox' }));
+    await waitFor(() => {
+      expect(mockSetStatus).toHaveBeenCalledWith('n1', 'active', null);
+      expect(onMoved).toHaveBeenCalledWith('active', null);
+    });
+  });
+
+  it('currentStatus=trashed → Inbox/완료/보관 노출, 휴지통 미노출', () => {
+    render(
+      <MoveStatusModal
+        noteId="n1"
+        rawText="t"
+        summary=""
+        currentStatus="trashed"
+        onClose={vi.fn()}
+        onMoved={vi.fn()}
+      />
+    );
+    expect(screen.getByRole('button', { name: 'Inbox' })).toBeInTheDocument();
+    expect(screen.getByRole('button', { name: '완료' })).toBeInTheDocument();
+    expect(screen.getByRole('button', { name: '보관' })).toBeInTheDocument();
+    expect(screen.queryByRole('button', { name: '휴지통' })).toBeNull();
+  });
+
+  it('Escape key → onClose 호출', () => {
+    const onClose = vi.fn();
+    render(
+      <MoveStatusModal
+        noteId="n1"
+        rawText="t"
+        summary=""
+        currentStatus="active"
+        onClose={onClose}
+        onMoved={vi.fn()}
+      />
+    );
+    fireEvent.keyDown(document, { key: 'Escape' });
+    expect(onClose).toHaveBeenCalled();
+  });
+
+  it('overlay 클릭 → onClose, modal body 클릭 → 무반응', () => {
+    const onClose = vi.fn();
+    render(
+      <MoveStatusModal
+        noteId="n1"
+        rawText="t"
+        summary=""
+        currentStatus="active"
+        onClose={onClose}
+        onMoved={vi.fn()}
+      />
+    );
+    // body 클릭 (textarea) → onClose 호출 안 됨
+    fireEvent.click(screen.getByRole('textbox'));
+    expect(onClose).not.toHaveBeenCalled();
+    // overlay (dialog) 클릭 → onClose
+    fireEvent.click(screen.getByRole('dialog', { name: '이동' }));
+    expect(onClose).toHaveBeenCalled();
+  });
+
+  it('빈 사유 → null reason 전달', async () => {
+    const onMoved = vi.fn();
+    render(
+      <MoveStatusModal
+        noteId="n1"
+        rawText="t"
+        summary=""
+        currentStatus="active"
+        onClose={vi.fn()}
+        onMoved={onMoved}
+      />
+    );
+    fireEvent.click(screen.getByRole('button', { name: '보관' }));
+    await waitFor(() => expect(mockSetStatus).toHaveBeenCalledWith('n1', 'archived', null));
+  });
+});
--- a/tests/unit/NoteCard.test.tsx
+++ b/tests/unit/NoteCard.test.tsx
@@ -128,23 +128,19 @@ describe('NoteCard — ai_status=disabled fallback (v0.2.9 Cut B Task 13)', () =
  });
 });

-describe('NoteCard — 이동 메뉴 (v0.2.9 Cut B Task 6)', () => {
+describe('NoteCard — 이동 버튼', () => {
  beforeEach(() => {
    vi.clearAllMocks();
    cleanup();
  });

-  it('이동 ▾ 클릭 → 현재 status 외 3개 목적지 메뉴 표시', () => {
-    // baseNote.status = 'active' → 완료/보관/휴지통 만 표시
+  it('이동 클릭 → MoveStatusModal 열림', () => {
    render(<NoteCard note={baseNote} onUpdated={() => {}} mode="inbox" />);
    fireEvent.click(screen.getByRole('button', { name: '이동' }));
-    expect(screen.getByRole('button', { name: '완료로 이동' })).toBeInTheDocument();
-    expect(screen.getByRole('button', { name: '보관으로 이동' })).toBeInTheDocument();
-    expect(screen.getByRole('button', { name: '휴지통으로 이동' })).toBeInTheDocument();
-    expect(screen.queryByRole('button', { name: '활성으로 이동' })).toBeNull();
+    expect(screen.getByRole('dialog', { name: '이동' })).toBeInTheDocument();
  });

-  it('메뉴 항목 클릭 → 즉시 setStatus 호출 (modal 없음)', async () => {
+  it('Modal 내부 "완료" 버튼 → setStatus 호출 + onUpdated + onDeleted + refreshMeta', async () => {
    const onUpdated = vi.fn();
    const onDeleted = vi.fn();
    render(
@@ -156,33 +152,13 @@ describe('NoteCard — 이동 메뉴 (v0.2.9 Cut B Task 6)', () => {
      />
    );
    fireEvent.click(screen.getByRole('button', { name: '이동' }));
-    fireEvent.click(screen.getByRole('button', { name: '완료로 이동' }));
+    fireEvent.click(screen.getByRole('button', { name: '완료' }));
    await waitFor(() => {
      expect(mockSetStatus).toHaveBeenCalledWith('n1', 'completed', null);
      expect(onUpdated).toHaveBeenCalled();
-      // status 변경 → 현재 view (inbox) 에서 제거되어야 함.
      expect(onDeleted).toHaveBeenCalled();
-      // 헤더 탭 count 동기화.
      expect(mockRefreshMeta).toHaveBeenCalled();
    });
-    // modal 미존재 검증.
-    expect(screen.queryByRole('dialog', { name: '이동' })).toBeNull();
-  });
-
-  it('이동 메뉴 외부 클릭 시 dropdown 닫힘', () => {
-    render(<NoteCard note={baseNote} onUpdated={() => {}} mode="inbox" />);
-    fireEvent.click(screen.getByRole('button', { name: '이동' }));
-    expect(screen.getByRole('button', { name: '완료로 이동' })).toBeInTheDocument();
-    fireEvent.mouseDown(document.body);
-    expect(screen.queryByRole('button', { name: '완료로 이동' })).toBeNull();
-  });
-
-  it('이동 메뉴 열린 상태에서 Escape → dropdown 닫힘', () => {
-    render(<NoteCard note={baseNote} onUpdated={() => {}} mode="inbox" />);
-    fireEvent.click(screen.getByRole('button', { name: '이동' }));
-    expect(screen.getByRole('button', { name: '완료로 이동' })).toBeInTheDocument();
-    fireEvent.keyDown(document, { key: 'Escape' });
-    expect(screen.queryByRole('button', { name: '완료로 이동' })).toBeNull();
  });
 });

--- a/tests/unit/NoteRepository.test.ts
+++ b/tests/unit/NoteRepository.test.ts
@@ -770,6 +770,41 @@ describe('NoteRepository — failed retry helpers', () => {
    expect(jobs[0]!.nextRunAt).toBe('2026-04-30T00:00:00.000Z');
  });

+  it('v0.3.9 — retryOneFailed: failed → pending + pending_jobs INSERT', () => {
+    const a = makeFailed('a');
+    const b = makeFailed('b');
+    const r = repo.retryOneFailed(a, '2026-05-01T12:00:00.000Z');
+    expect(r).toEqual({ ok: true });
+    expect(repo.findById(a)!.aiStatus).toBe('pending');
+    expect(repo.findById(a)!.aiError).toBeNull();
+    expect(repo.findById(b)!.aiStatus).toBe('failed'); // 다른 노트 영향 없음
+    const jobs = repo.getAllPendingJobs();
+    expect(jobs.find((j) => j.noteId === a)).toBeDefined();
+  });
+
+  it('v0.3.9 — retryOneFailed: non-failed status 면 no-op', () => {
+    const { id } = repo.create({ rawText: 'pending note' });
+    const r = repo.retryOneFailed(id, '2026-05-01T12:00:00.000Z');
+    expect(r).toEqual({ ok: false });
+  });
+
+  it('v0.3.9 — cancelPending: pending → disabled + pending_jobs DELETE', () => {
+    const { id } = repo.create({ rawText: 'x' }); // ai_status=pending
+    expect(repo.findById(id)!.aiStatus).toBe('pending');
+    const r = repo.cancelPending(id, '2026-05-01T12:00:00.000Z');
+    expect(r).toEqual({ ok: true });
+    expect(repo.findById(id)!.aiStatus).toBe('disabled');
+    const jobs = repo.getAllPendingJobs().filter((j) => j.noteId === id);
+    expect(jobs).toHaveLength(0);
+  });
+
+  it('v0.3.9 — cancelPending: non-pending status 면 no-op', () => {
+    const id = makeFailed('a');
+    const r = repo.cancelPending(id, '2026-05-01T12:00:00.000Z');
+    expect(r).toEqual({ ok: false });
+    expect(repo.findById(id)!.aiStatus).toBe('failed'); // 변경 없음
+  });
+
  it('setNextRunAt — attempts 변경 없이 next_run_at + last_error 갱신', () => {
    const { id } = repo.create({ rawText: 'x' });
    repo.incrementJobAttempt(id, '2026-05-01T11:00:00.000Z', 'first error');
--- a/tests/unit/ftsHelpers.test.ts
+++ b/tests/unit/ftsHelpers.test.ts
@@ -15,6 +15,12 @@ describe('sanitizeFtsQuery', () => {
  it('returns empty string for whitespace-only', () => {
    expect(sanitizeFtsQuery('   ')).toBe('');
  });
+  it('v0.3.9 — dash/caret/backtick 추가 sanitize', () => {
+    expect(sanitizeFtsQuery('key-value')).toBe('key value');
+    expect(sanitizeFtsQuery('^prefix')).toBe('prefix');
+    expect(sanitizeFtsQuery('back`tick')).toBe('back tick');
+    expect(sanitizeFtsQuery('-NOT')).toBe('NOT');
+  });
 });

 describe('computeCutoff', () => {
--- a/tests/unit/inboxApi-setStatus.test.ts
+++ b/tests/unit/inboxApi-setStatus.test.ts
@@ -83,6 +83,20 @@ describe('inbox:set-status IPC', () => {
    expect(r.reason).toBe('invalid status');
    expect(mockSetStatus).not.toHaveBeenCalled();
  });
+
+  it('emits note:updated to renderer after setStatus (v0.3.8 push-based)', async () => {
+    const send = vi.fn();
+    const win = { webContents: { send }, isDestroyed: () => false } as never;
+    const deps = makeDeps();
+    deps.getInboxWindow = () => win;
+    const updatedNote = { id: 'n1', status: 'completed' };
+    mockFindById.mockReturnValue(updatedNote);
+    registerInboxApi(deps);
+    const handler = handlers['inbox:set-status'];
+    if (handler === undefined) throw new Error('handler not registered');
+    await handler(null, 'n1', 'completed', null);
+    expect(send).toHaveBeenCalledWith('note:updated', updatedNote);
+  });
 });

 describe('ai:classify-status IPC', () => {
--- a/tests/unit/store.trash.test.ts
+++ b/tests/unit/store.trash.test.ts
@@ -95,6 +95,37 @@ describe('useInbox — trash state (v0.2.3 #4)', () => {
    expect(useInbox.getState().notes).toHaveLength(1);
  });

+  it('view-aware upsertNote — inbox view 에서 status=completed 노트 push → notes 에서 제거', async () => {
+    const { useInbox } = await import('../../src/renderer/inbox/store.js');
+    // view='inbox' (default), active 노트 upsert
+    useInbox.getState().upsertNote(noteStub('a'));
+    expect(useInbox.getState().notes).toHaveLength(1);
+    // 같은 노트가 completed 로 status 변경 → 현재 view 와 안 맞으므로 notes 에서 제거
+    const completed: Note = { ...noteStub('a'), status: 'completed' };
+    useInbox.getState().upsertNote(completed);
+    expect(useInbox.getState().notes).toHaveLength(0);
+  });
+
+  it('view-aware upsertNote — completed view 에서 active 노트 push → notes 에 추가 안 됨', async () => {
+    const { useInbox } = await import('../../src/renderer/inbox/store.js');
+    useInbox.setState({ view: 'completed' });
+    useInbox.getState().upsertNote(noteStub('a')); // status='active'
+    expect(useInbox.getState().notes).toHaveLength(0);
+    // completed status 면 추가
+    const completed: Note = { ...noteStub('a'), status: 'completed' };
+    useInbox.getState().upsertNote(completed);
+    expect(useInbox.getState().notes).toHaveLength(1);
+  });
+
+  it('view-aware upsertNote — searchResults 가 있을 때 status mismatch → searchResults 에서 제거', async () => {
+    const { useInbox } = await import('../../src/renderer/inbox/store.js');
+    // 이전 test 가 view='completed' 로 설정한 채 끝났을 수 있어 명시적 초기화.
+    useInbox.setState({ view: 'inbox', searchResults: [noteStub('a')] });
+    const completed: Note = { ...noteStub('a'), status: 'completed' };
+    useInbox.getState().upsertNote(completed);
+    expect(useInbox.getState().searchResults).toHaveLength(0);
+  });
+
  it('emptyTrash with cancelled confirm leaves trashNotes intact', async () => {
    mockApi.emptyTrash.mockResolvedValueOnce({ confirmed: false, count: 0 });
    const { useInbox } = await import('../../src/renderer/inbox/store.js');
Author	SHA1	Message	Date
th-kim0823	f676c1638e	chore(release): v0.3.10 — macOS fullscreen QuickCapture fix macOS fullscreen Space 위에 QuickCapture 띄우기. 이전엔 핫키 누를 때 강제 Space 전환. quickCaptureWindow.ts darwin 분기 추가: - type: 'panel' (fullscreen floating) - setAlwaysOnTop(true, 'screen-saver') (가장 높은 level) - setVisibleOnAllWorkspaces(true, visibleOnFullScreen: true) Windows / Linux 동작 변경 없음. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-12 13:22:12 +09:00
th-kim0823	2e69f598bc	chore(release): v0.3.9 — AI 흐름 unblock UI + FTS5 escape audit edge case 3건: - pending 노트 "건너뛰기" 버튼 (cancelPending: pending → disabled + jobs DELETE) - failed 노트 per-note "재시도" 버튼 (retryOneFailed: failed → pending + enqueue) - FTS5 sanitize regex 확장 (backtick/dash/caret 추가) 동시 편집 race 는 EditableField guard 가 이미 처리 (수정 불필요). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-11 17:43:46 +09:00
th-kim0823	014c06e1f0	chore(release): v0.3.8 — UX hole 일괄 hotfix 8건 전수 audit 후 핵심 root fix 3 + edge cases 5: ROOT - inbox:set-status IPC 가 pushNoteUpdated emit (이전엔 stale → 호출처별 refreshMeta 필요) - upsertNote 가 current view status 인식 (이전엔 잘못된 status 노트 잔류) - store async 함수 try/catch (이전엔 IPC fail 시 무한 loading) EDGE - restoreNote 가 status='active' 도 갱신 - upsertNote trash 판정 deletedAt → status='trashed' - Modal Escape dismiss 통일 (5개 modal) - OnboardingWizard IPC fail fallback (try/catch + skip) - MoveStatusModal overlay 클릭 close Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-11 16:50:10 +09:00
th-kim0823	4216d42d7c	chore(release): v0.3.7 — 이동 modal currentStatus 필터 (Inbox 복원 path) MoveStatusModal 이 완료/보관/휴지통 3 button hardcode 라 완료/보관/휴지통 노트가 inbox 로 돌아오는 path 가 없던 버그 fix. currentStatus prop 으로 4 status 중 current 제외 동적 render. '활성' label 도 헤더 탭과 일치하도록 'Inbox' 로 통일. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-11 16:25:38 +09:00
th-kim0823	e2058cfdbe	chore(release): v0.3.6 — 이동 modal 복원 (v0.3.5 의도 정정) v0.3.5 의 이동 dropdown 단순화가 사용자 의도와 어긋남. 사용자는 dropdown 의 목적지 중복 (modal 도 목적지 묻기) 만 거슬렸지, 사유 입력 + AI 자동 분류 + 수동 status 선택을 한 곳에서 처리하는 modal 은 보존해야 하는 핵심 UX 였음. 단일 "이동" 버튼 → MoveStatusModal path 로 정정. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-11 11:16:14 +09:00