# 2026-06-26 MD-H1-05 真实 App QA

## 用户目标

从 `02-P/plan-progress.markdown` 的 `P-20260626-m4c-handshake-coordination` 领取 Mindraw 侧 `MD-H1-05`，补真实 App QA，覆盖 App open clean / dirty、用户编辑后 revision mismatch、lease timeout、save failed、result Frame 用户可见、source Frame 不被覆盖等场景；产出 QA 证据并回写总台账。范围限定为 QA / smoke / failure 验证，不启动 `PM-H5-GATE`，不新增跨项目任务。

## 已完成事项

- 新增 `src/lib/mindrawAppWriteApi.smoke.test.ts`，覆盖 App closed、App open clean、App open dirty、lease 后用户编辑 revision mismatch、lease timeout、save failed、result Frame 用户可见、source preservation。
- 新增 QA 报告 `02-P/qa/mindraw-phase38-app-write-api-check.md`，结论为 `PASS FOR MD-H1-05 REAL APP WRITE API SMOKE`。
- 更新 `02-P/plan-progress.markdown`：勾选 `MD-H1-05`，更新 H3 状态，追加 Progress Log，明确下一步归属 PM，`PM-H5-GATE` 未启动。
- 更新 `CODEGRAPH.md`：登记 `mindrawAppWriteApi.smoke.test.ts` 和 Phase 3.8 App write API QA 证据。
- 更新 `INDEX.md`：登记新增 QA 报告和 smoke 测试入口。

## 验证证据

- `npm run test:run -- src/lib/mindrawAppWriteApi.smoke.test.ts`：1 个测试文件、6 个用例 PASS。
- `npm run test:run -- src/lib/mindrawAppWriteApi.smoke.test.ts src/lib/mindrawAppWriteMutation.test.ts src/lib/mindrawAppWriteLease.test.ts src/lib/mindrawAppReadApi.test.ts src/store/useStore.test.ts src/lib/excalidrawFile.test.ts`：6 个测试文件、70 个用例 PASS。
- `npm run build`：PASS；仍有既有字体路径和 chunk size warning。
- `git diff --check -- src/lib/mindrawAppWriteApi.smoke.test.ts 02-P/qa/mindraw-phase38-app-write-api-check.md CODEGRAPH.md INDEX.md 02-P/plan-progress.markdown`：无输出。

## 关键决策

- `MD-H1-05` 只证明当前前端生产 facade、active editor bridge、store/saveTab 和 `save_mindraw_package` 路径的 App 使用节奏，不把它包装成正式 packaged GUI / m4c 联合 smoke。
- `WORKING_REVISION_MISMATCH` 在本轮 smoke 中由 lease guard 更早返回，符合 `MD-H1-03/04` 的设计边界。
- `PM-H5-GATE` 仍由 PM 调度台处理，Mindraw worker 不直接领取 `PM-*`、`H*` 或新增 `MD-H5-*`。

## 文件变更

- `src/lib/mindrawAppWriteApi.smoke.test.ts`
- `02-P/qa/mindraw-phase38-app-write-api-check.md`
- `02-P/plan-progress.markdown`
- `CODEGRAPH.md`
- `INDEX.md`

## 未决问题

- 尚无 loopback JSON-RPC / Tauri command transport。
- 多窗口 / 多进程 lease 互斥未实现。
- 保存失败 UI 仍沿用现有 `saveTab()` alert。
- result layout 未做碰撞避让。
- 正式 m4c 联合 smoke 尚未启动。

## 后续建议

由 PM 收敛 Mindraw `MD-H1-05` 与 m4c `M4C-H5-03` 证据后，决定是否拆 `PM-H5-GATE` 下的正式联合 smoke 子任务。