feat(v029): NoteRepository.setStatus + listByStatus + restoreNote 재구현

- NoteStatus 타입 추가 ('active'/'completed'/'archived'/'trashed')
- Note interface 에 status / statusChangedAt / moveReason 필드 추가
- setStatus(id, status, reason, now?) — 단일 transaction 으로 status + move_reason +
  status_changed_at + updated_at 갱신. status='trashed' ↔ deleted_at 동기화
  (backward compat). 그 외 status 는 deleted_at NULL.
- listByStatus(status, opts) — status 별 필터 + ORDER BY COALESCE(status_changed_at,
  created_at) DESC. limit cap 200.
- hydrate 에 status / statusChangedAt / moveReason 매핑 추가. 미설정 row 는 'active' fallback.
- restoreNote 재구현 — setStatus('active', null) 로 status + deleted_at 동기화 +
  v0.2.6 #10 round 1 fix (ai_status='failed'/'pending' → pending_jobs 재투입) 보존.
- 기존 테스트 fixture 5건에 새 필드 추가 (NoteCard, store.expired/recall/tagFilter/trash).
- 신규 테스트 11건 (setStatus + listByStatus + restoreNote 회귀).

src/main/repository/NoteRepository.ts

@@ -1,6 +1,6 @@
 import type Database from 'better-sqlite3';
 import { v7 as uuidv7, v4 as uuidv4 } from 'uuid';
-import type { Note, NoteMedia, NoteTag } from '@shared/types';
+import type { Note, NoteMedia, NoteStatus, NoteTag } from '@shared/types';
 import { kstTodayIso } from '../../shared/util/kstDate.js';
 
 export interface CreateNoteInput { rawText: string; }
@@ -410,25 +410,90 @@ export class NoteRepository {
       .run(now, id);
   }
 
+  /**
+   * v0.2.9 Cut B — 노트 status 4분기 전이 (active/completed/archived/trashed).
+   * status + status_changed_at + move_reason + updated_at 갱신 + deleted_at
+   * backward-compat 동기화 (status='trashed' → deleted_at=ts, 그 외 → NULL).
+   *
+   * 단일 transaction. 호출자가 `now` 주입 가능 (테스트성).
+   */
+  setStatus(
+    id: string,
+    status: NoteStatus,
+    reason: string | null,
+    now: Date = new Date()
+  ): void {
+    const tx = this.db.transaction(() => {
+      const ts = now.toISOString();
+      this.db
+        .prepare(
+          `UPDATE notes
+              SET status = ?,
+                  move_reason = ?,
+                  status_changed_at = ?,
+                  updated_at = ?
+            WHERE id = ?`
+        )
+        .run(status, reason, ts, ts, id);
+      // backward compat: deleted_at 컬럼은 m004 이후로도 status='trashed' 와 동기화.
+      if (status === 'trashed') {
+        this.db.prepare(`UPDATE notes SET deleted_at = ? WHERE id = ?`).run(ts, id);
+      } else {
+        this.db.prepare(`UPDATE notes SET deleted_at = NULL WHERE id = ?`).run(id);
+      }
+    });
+    tx();
+  }
+
+  /**
+   * v0.2.9 Cut B — status 별 노트 목록. status_changed_at DESC (최근 전이 우선),
+   * NULL 은 created_at fallback. limit cap 200 (list/listTrashed 와 동일).
+   */
+  listByStatus(status: NoteStatus, opts: { limit?: number } = {}): Note[] {
+    const limit = Math.max(1, Math.min(200, opts.limit ?? 200));
+    const rows = this.db
+      .prepare(
+        `SELECT * FROM notes
+          WHERE status = ?
+          ORDER BY COALESCE(status_changed_at, created_at) DESC, id DESC
+          LIMIT ?`
+      )
+      .all(status, limit) as Record<string, unknown>[];
+    return rows.map((r) => this.hydrate(r));
+  }
+
+  /**
+   * 휴지통에서 active 로 복원. setStatus('active') 로 status + deleted_at 동기화 +
+   * v0.2.6 #10 round 1 fix 보존 (ai_status='failed' / 'pending' 시 pending_jobs 재투입).
+   */
   restoreNote(id: string): void {
     const tx = this.db.transaction(() => {
-      const before = this.db.prepare(`SELECT ai_status FROM notes WHERE id = ?`).get(id) as { ai_status: string } | undefined;
+      const before = this.db
+        .prepare(`SELECT ai_status FROM notes WHERE id = ?`)
+        .get(id) as { ai_status: string } | undefined;
+      // setStatus('active', null) — reason clear + deleted_at NULL + updated_at 갱신.
+      this.setStatus(id, 'active', null);
       const now = new Date().toISOString();
-      this.db.prepare(`UPDATE notes SET deleted_at = NULL, updated_at = ? WHERE id = ?`).run(now, id);
 
       // v0.2.6 #10 — failed 노트 restore 시 pending 으로 reset + pending_jobs 재생성
       if (before?.ai_status === 'failed') {
-        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);
+        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);
       } else if (before?.ai_status === 'pending') {
         // pending 인 채로 trash 됐다면 pending_jobs 도 미정상 상태일 수 있음 — 재생성 (idempotent)
-        this.db.prepare(
-          `INSERT OR IGNORE INTO pending_jobs (note_id, attempts, next_run_at) VALUES (?, 0, ?)`
-        ).run(id, now);
+        this.db
+          .prepare(
+            `INSERT OR IGNORE INTO pending_jobs (note_id, attempts, next_run_at) VALUES (?, 0, ?)`
+          )
+          .run(id, now);
       }
       // done 노트는 재처리 안 함 (이미 결과 있음)
     });
@@ -669,6 +734,9 @@ export class NoteRepository {
       deletedAt: (row.deleted_at as string | null) ?? null,
       lastRecalledAt: (row.last_recalled_at as string | null) ?? null,
       recallDismissedAt: (row.recall_dismissed_at as string | null) ?? null,
+      status: ((row.status as NoteStatus | undefined) ?? 'active'),
+      statusChangedAt: (row.status_changed_at as string | null) ?? null,
+      moveReason: (row.move_reason as string | null) ?? null,
       createdAt: row.created_at as string,
       updatedAt: row.updated_at as string,
       tags: tags as NoteTag[],

src/shared/types.ts

@@ -13,6 +13,9 @@ export interface NoteMedia {
 
 export type AiStatus = 'pending' | 'done' | 'failed';
 
+// v0.2.9 Cut B — 노트 status 4분기 (사용자 액션). m004 마이그레이션 + setStatus.
+export type NoteStatus = 'active' | 'completed' | 'archived' | 'trashed';
+
 export interface NoteTag {
   name: string;
   source: 'ai' | 'user';
@@ -37,6 +40,10 @@ export interface Note {
   deletedAt: string | null;
   lastRecalledAt: string | null;
   recallDismissedAt: string | null;
+  // 신규 v4 (v0.2.9 Cut B):
+  status: NoteStatus;
+  statusChangedAt: string | null;
+  moveReason: string | null;
   createdAt: string;
   updatedAt: string;
   tags: NoteTag[];