edit | blame | history | raw

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 子任务。