# 2026-06-26 MDH102 只读 API

## 用户目标

从 `02-P/plan-progress.markdown` 的 `P-20260626-m4c-handshake-coordination` 领取 Mindraw 侧 `MD-H1-02`，完成只读 App state / live frame context API 垂直切片；只包括 state/context 读取、DTO、`workingRevision`、source Frame extractor、read-only facade 和单元 / smoke 证据；不做 lease、写入、mutation 或保存。

## 已完成事项

- 新增 `src/lib/mindrawAppReadApi.ts`：
  - `mindrawGetCapabilities()`
  - `mindrawGetOpenDocumentState()`
  - `mindrawGetLiveFrameContext()`
  - `sha256:` workingRevision
  - source Frame context extractor
  - read-only 错误码
- 新增 `src/lib/mindrawAppReadApi.test.ts`，覆盖 8 个用例。
- 新增 QA 证据：`02-P/qa/mindraw-phase38-readonly-api-check.md`。
- 余力准备 `MD-H1-03` 说明和测试清单：`02-P/功能任务/document-lease-manager-implementation-notes.md`。
- 更新 `CODEGRAPH.md`、`INDEX.md` 和 `02-P/plan-progress.markdown`。

## 关键决策

- 本轮只做前端 read-only facade，不实现 loopback JSON-RPC transport / capability file。
- active dirty document 的 `workingRevision` 使用 live editor snapshot。
- dirty tab 的真实 `diskRevision` 暂不跟踪，返回 `null` 并带 `DISK_REVISION_UNAVAILABLE_FOR_DIRTY_TAB` warning。
- facade 不调用 Tauri `invoke`，不触发保存、写入、lease 或 mutation。

## 验证结果

- `npm run test:run -- src/lib/mindrawAppReadApi.test.ts`：1 个测试文件，8 个用例通过。
- `npm run test:run -- src/lib/mindrawAppReadApi.test.ts src/store/useStore.test.ts src/lib/excalidrawFile.test.ts`：3 个测试文件，47 个用例通过。
- `npm run build`：通过；仅有既有 Vite warning。
- `git diff --check -- ...`：无输出。

## 文件变更

- `src/lib/mindrawAppReadApi.ts`
- `src/lib/mindrawAppReadApi.test.ts`
- `02-P/qa/mindraw-phase38-readonly-api-check.md`
- `02-P/功能任务/document-lease-manager-implementation-notes.md`
- `02-P/plan-progress.markdown`
- `CODEGRAPH.md`
- `INDEX.md`

## 剩余风险

- 还没有进程外可调用 transport / capability file。
- 多窗口、进程外 discovery、真实 m4c 调用尚未验证。
- 非 active tab 当前使用 store content，而不是 active editor snapshot。
- lease / mutation / 保存链路未实现。

## 下一步归属

- `MD-H1-03` 是否派发由 PM 决定。
- m4c 继续保持 dry-run-only adapter。
- `PM-H5-GATE` 仍等待 lease / mutation 和联合 smoke 入口条件。