feat(my-deepagent): v0.3 PR #1 — interactive session persistence + LangGraph saver wiring

v0.3의 토대. REPL/GUI 둘 다 장기 대화를 영속해서 `mydeepagent --session <id>`
또는 `GET /api/sessions/{id}`로 어디서든 이어 진행 가능. Claude Code의
`claude --resume` 등가 능력.

Data model
- `persistence/models.py`:
  - 신규 `MessageRow` 테이블 — (session_id, seq) UNIQUE, role/content/
    tool_calls/token_count/is_summary/archived/ts. LangGraph checkpoint =
    source of truth, 이 테이블은 GUI/CLI 빠른 조회 mirror. divergence
    rebuild 매커니즘 없음 (단순성 우선).
  - `InteractiveSessionRow` 컬럼 8개 추가:
      total_input_tokens, total_output_tokens (PR #2 tiktoken으로 정밀화 예정),
      model, project_key (sha256(realpath(repo_path))[:16]),
      title (첫 user msg 50자), plan_mode (PR #5), parent_session_id (PR #6),
      depth (PR #6 sub-agent depth ≤ 3).
- `alembic/versions/684e70f4536a_*.py` (신규):
  - `op.batch_alter_table` 사용 — SQLite ALTER constraint 미지원 우회. Postgres는
    native DDL.
  - 자동생성이 제안한 LangGraph 테이블 (`checkpoints` 등) drop 라인은 의도적으로
    제거 (langgraph-checkpoint-postgres가 자체 관리).
  - server_default 박아서 기존 row 안전.

CLI
- `cli/interactive.py`:
  - REPL 진입 시 `get_checkpointer_ctx(config.database_url)` 컨텍스트 열고
    REPL 전체 동안 유지. `build_agent(..., checkpointer=saver)`로 deepagents에
    LangGraph saver wire. v0.2 PR #10의 CostMiddleware / AuditToolMiddleware
    보존.
  - `_invoke_and_stream`이 ainvoke 전후 명시적 MessageRow insert
    (user → ainvoke → assistant). last_message_at + total_*_tokens 누적 +
    첫 user msg로 title 자동 setter.
  - `InteractiveSession.thread_suffix` 도입. /model / /agent / /clear 호출
    시 suffix bump → LangGraph thread_id = `{session_id}:{suffix}` 로 새
    deepagents 컨텍스트 시작 (compaction과 같은 패턴, PR #2 재사용).
  - 신규 `--session <id|prefix>` 옵션: 기존 row 로드 (ended이면 거부) 또는
    신규 row insert (AgentPersonaRow upsert + project_key 박음).
  - `/clear` 슬래시 갱신: messages.archived=True + 새 thread 시작. 세션 자체
    는 살아있음 — `sessions show <id> --all`로 조회 가능.
- `cli/sessions.py` (신규): `mydeepagent sessions list/show/resume/end`.
  show <id> [--all]이 archived 메시지까지. 6+ char prefix + 중복 시 명시
  에러.
- `cli/main.py`: --session 옵션 + sessions 서브명령 + interactive_command
  시그니처 확장.

HTTP API
- `api/models.py`: SessionSummary / MessageInfo / SessionDetail /
  CreateSessionRequest / PostMessageRequest / SessionAck DTO 신규 (모두
  extra="forbid").
- `api/routes/sessions.py` (신규):
    GET  /api/sessions?limit=&state=
    GET  /api/sessions/{id}?all=true     (마지막 200 메시지)
    POST /api/sessions                    (persona_name, model_override, repo_path)
    POST /api/sessions/{id}/messages      (사용자 메시지 append, 동기 persist;
                                            PR #7 GUI에서 background ainvoke 추가)
    GET  /api/sessions/{id}/stream        (SSE — 0.5s polling, last-event-id 헤더
                                            + ?last_seq 둘 다 지원)
    POST /api/sessions/{id}/end
- `api/app.py`: sessions 라우터 마운트.

Tests
- `tests/integration/test_session_persist.py` (5 시나리오):
    1. create + post → row + 메시지 + title + token 누적 영속
    2. list가 신규 3 세션 모두 포함
    3. prefix resolution + 404
    4. end 후 메시지 거부 (409)
    5. ?all=true가 archived 메시지 surfacing

Gates
- ruff check + ruff format + mypy --strict: PASS (124 source files)
- pytest non-E2E: 608 PASS (25.86 s) — v0.2 PR #3 후 603에서 +5 신규
- pytest E2E real OpenRouter on Postgres: PASS 82.07 s (베이스라인 60–122s
  범위 내; DR-3 +20% 임계점 통과)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

my-deepagent/CHANGELOG.md

@@ -2,6 +2,69 @@
 
 ## [Unreleased]
 
+### Added
+- **v0.3 PR #1 — interactive session persistence + LangGraph saver wiring**.
+  v0.3의 토대.  REPL/GUI 모두 장기 대화 영속 가능하도록 데이터 모델·CLI·HTTP
+  API를 함께 도입.  Claude Code의 `claude --resume` 등가.
+  - `persistence/models.py`:
+    - 신규 `MessageRow` 테이블 — `(session_id, seq)` UNIQUE, role/content/
+      tool_calls/token_count/is_summary/archived/ts.  LangGraph checkpoint가
+      source of truth이고 이 테이블은 GUI/CLI 빠른 조회 mirror (divergence
+      rebuild 가정 없음).
+    - `InteractiveSessionRow`에 컬럼 8개 추가: `total_input_tokens`,
+      `total_output_tokens`, `model`, `project_key`, `title`, `plan_mode`
+      (PR #5용), `parent_session_id` + `depth` (PR #6용, self FK CASCADE).
+  - `alembic/versions/684e70f4536a_v0_3_pr_1_session_messages_8_columns.py`
+    (신규): `op.batch_alter_table` 사용 — SQLite ALTER constraint 미지원을
+    우회.  자동생성이 제안한 LangGraph 자체 테이블 (`checkpoints` /
+    `checkpoint_writes` / `checkpoint_blobs` / `checkpoint_migrations`)
+    drop 라인은 의도적으로 제거 (langgraph-checkpoint-postgres가 자체 관리).
+    `server_default` 박아서 기존 row가 NULL/0/false로 안전하게 채워짐.
+  - `cli/interactive.py`:
+    - REPL 진입 시 `get_checkpointer_ctx(config.database_url)` 컨텍스트 열고
+      REPL 전체 수명 동안 유지.  `build_agent(..., checkpointer=saver)`로
+      deepagents에 LangGraph saver wire.  v0.2 PR #10에서 추가됐던
+      `CostMiddleware` / `AuditToolMiddleware` 보존.
+    - `_invoke_and_stream`이 ainvoke 전후로 `MessageRow` 명시적 insert
+      (`role=user` → ainvoke → `role=assistant`).  `last_message_at` +
+      `total_*_tokens` 누적 + 첫 user 메시지로 `title` 자동 setter (50자
+      truncate).
+    - `InteractiveSession` 클래스에 `thread_suffix` 도입.  `/model` / `/agent`
+      / `/clear` 호출 시 suffix bump → LangGraph thread_id = `{session_id}:{suffix}`
+      로 새 deepagents 컨텍스트 시작 (compaction과 같은 패턴, PR #2에서 재사용
+      예정).
+    - 신규 `--session <id|prefix>` 옵션 처리: 기존 row 로드 (`state == "ended"`이면
+      거부) 또는 신규 row insert (`AgentPersonaRow` upsert + `project_key` =
+      `sha256(realpath(repo_path))[:16]`).
+    - `/clear` 슬래시 갱신: 현재 세션의 모든 `MessageRow.archived=True` + 새
+      thread 시작.  세션 자체는 살아있음 (`sessions show <id> --all`로 조회
+      가능).
+  - `cli/sessions.py` (신규): `mydeepagent sessions list/show/resume/end`.
+    `show <id> [--all]`이 archived 메시지까지 표시.  6+ char prefix 매칭 +
+    중복 시 명시적 에러.
+  - `cli/main.py`: `--session` 옵션 + `sessions` 서브명령 + `interactive_command`
+    시그니처 확장.
+  - `api/models.py`: `SessionSummary` / `MessageInfo` / `SessionDetail` /
+    `CreateSessionRequest` / `PostMessageRequest` / `SessionAck` DTO 신규
+    (모두 `extra="forbid"`).
+  - `api/routes/sessions.py` (신규):
+    - `GET /api/sessions?limit=&state=` — list
+    - `GET /api/sessions/{id}?all=true` — detail + 마지막 200 메시지
+    - `POST /api/sessions` — 신규 세션 생성 (persona_name / model_override /
+      repo_path)
+    - `POST /api/sessions/{id}/messages` — 사용자 메시지 append (v0.3 PR #1
+      범위에선 동기 persist만; PR #7 Web GUI에서 background ainvoke 추가
+      예정)
+    - `GET /api/sessions/{id}/stream` — SSE.  0.5s polling, `last-event-id`
+      헤더 + `?last_seq=` 둘 다 지원.  종결 시 `event: done` 보내고 close.
+    - `POST /api/sessions/{id}/end` — 세션 종결 마킹.
+  - `api/app.py`: sessions 라우터 마운트 (`/api/sessions`).
+  - `tests/integration/test_session_persist.py` (신규, 5 케이스): create +
+    post + persist / list 멤버십 / prefix resolution + 404 / end 후 메시지
+    거부 / archived 메시지 ?all=true로 surfacing.
+  - 회귀: ruff/mypy --strict / pytest 608 PASS / E2E real OpenRouter on
+    Postgres 82.07s (베이스라인 60–122s 범위 내).
+
 ### Fixed
 - **bugfix(engine): two production bugs surfaced by manual Web-GUI verification
   (`mydeepagent serve` + real OpenRouter run via /api/runs)**.