edit | blame | history | raw

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 不自行新增跨项目任务。