# 2026-06-26 MD-H5-01 联合 Smoke

## 用户目标

从 `02-P/plan-progress.markdown` 的 `P-20260626-m4c-handshake-coordination` 领取 Mindraw 侧 `MD-H5-01`，执行 H5 正式联合 smoke 的 Mindraw 侧验证。范围限定为 QA / smoke / blocker / Go-No-Go 回写，不新增 API 面、不实现 loopback transport、不启动 H8 / 发布、不领取 `PM-*` 或 `H*`，也不绕过 App 直接写包。

## 已完成事项

- 读取全局和项目规则、`INDEX.md`、`CODEGRAPH.md`、`02-P/plan-progress.markdown`，确认 `MD-H5-01` 已由 PM 派发给 Mindraw。
- 复核 m4c `M4C-H5-01/02/03` fixture、真实用户工作副本、read-state harness、mutation harness。
- 复跑 Mindraw `MD-H1-05` App write API smoke。
- 复跑 m4c H5 read-state / mutation harness 的 `contract` 和 `smoke`。
- 运行 Mindraw doctor `--system-handlers`。
- 用 `rg` 确认 Mindraw 主源码未暴露进程外 `mindraw.app.*` transport。
- 新增 Mindraw 侧 QA 报告 `02-P/qa/mindraw-h5-joint-smoke-mindraw-side-check.md`。
- 更新 `02-P/plan-progress.markdown`：勾选 `MD-H5-01`，追加 Progress Log，并回写 `NO-GO` / blocker。
- 更新 `INDEX.md`：登记新增 QA 报告。

## 关键结论

Mindraw 内部 App write path PASS，m4c dry-run harness PASS，但 `PM-H5-GATE` 正式联合 smoke 建议 `NO-GO`。

Blocker：`BLOCKER-MD-H5-01-TRANSPORT`。缺少 Mindraw App 对外 `mindraw.app.get_open_document_state` / `mindraw.app.get_live_frame_context` / `mindraw.app.acquire_write_lease` / `mindraw.app.commit_write_result` / `mindraw.app.release_write_lease` 的 loopback JSON-RPC、Tauri command、local socket、custom scheme callback 或等价 transport。当前 m4c 只能生成 contract fixture / dry-run stub，无法执行正式 App-mediated write。

## 验证命令

- `npm run test:run -- src/lib/mindrawAppWriteApi.smoke.test.ts`：6 个用例 PASS。
- `node p.mindrawforcodex/03-O/C3.tools/scripts/m4c-h5-readstate-harness.mjs contract`：PASS。
- `node p.mindrawforcodex/03-O/C3.tools/scripts/m4c-h5-mutation-harness.mjs contract`：PASS。
- `node p.mindrawforcodex/03-O/C3.tools/scripts/m4c-h5-readstate-harness.mjs smoke`：PASS。
- `node p.mindrawforcodex/03-O/C3.tools/scripts/m4c-h5-mutation-harness.mjs smoke`：PASS。
- `npm run doctor:mindraw -- --system-handlers`：`status=warn`，handler 均 pass，唯一 warning 为 `MINDRAW_BUILD_UNKNOWN`，`capabilities.appWriteLease=not-yet-phase3.8`。
- `rg -n 'mindraw\.app\.|acquire_write_lease|commit_write_result|release_write_lease|loopback|JSON-RPC|appWriteLease|documentLease' src src-tauri scripts package.json p.mindrawforcodex/03-O/C3.tools/scripts/m4c-h5-*.mjs`：确认主源码没有进程外 `mindraw.app.*` transport。
- `git diff --check -- 02-P/qa/mindraw-h5-joint-smoke-mindraw-side-check.md 02-P/plan-progress.markdown INDEX.md`：无输出。

## 文件变更

- `02-P/qa/mindraw-h5-joint-smoke-mindraw-side-check.md`
- `02-P/plan-progress.markdown`
- `INDEX.md`

复跑 m4c harness 更新了 `p.mindrawforcodex/02-P/Round05-MCPAlpha/qa/round05-h5-readstate-harness.json` 和 `p.mindrawforcodex/02-P/Round05-MCPAlpha/qa/round05-h5-mutation-harness.json`；该目录按项目规则不纳入 Mindraw 主项目 Git 边界。

## 未决问题

- m4c 侧 `M4C-H5-04` 结果待回写。
- `PM-H5-GATE` 需由 PM 收敛双方证据后判定。
- 多窗口 / 多进程 lease 互斥仍未验证。
- H8 / 发布不得启动。

## 后续建议

PM 如果接受 blocker，应拆出明确 Mindraw transport 任务；Mindraw worker 不自行新增跨项目任务。