2026-06-26 MDH101 生产设计

用户目标

进入 goal 模式，从 02-P/plan-progress.markdown 的 P-20260626-m4c-handshake-coordination 领取 Mindraw 侧 MD-H1-01，完成 Phase 3.8 External Write API / Document Lease production design；不启动真实写回实现；把 MD-H1-02 到 MD-H1-05 拆成可实现的 API / lease / mutation / QA 子任务；完成后回写总台账 Progress Log。

已完成事项

• 创建 goal 并按 PM 台账规则只领取 MD-H1-01。
• 新增 production design：02-P/功能任务/document-lease-app-write-api-production-design.md。
• 新增审阅 / QA planning 证据：02-P/qa/mindraw-phase38-production-design-review.md。
• 更新 INDEX.md，登记新增 design 和 QA 证据。
• 更新 02-P/plan-progress.markdown：
• H1 状态更新为 Done for MD-H1-01; follow-up cards decomposed。
• MD-H1-01 标记完成。
• MD-H1-02 到 MD-H1-05 保持待实现，并写入拆分摘要。
• Progress Log 追加任务 ID、产物路径、验证/审阅证据、剩余风险和下一步归属。

关键决策

• External write 采用 App-mediated write：Mindraw App 打开同包时，外部工具不得 direct package write。
• API 方法名固定为 mindraw.app.*，内部 facade / Tauri command candidate 使用 snake_case。
• 第一版只允许 createAiResultFrame，不暴露任意 JSON patch、任意文件写入或完整 scene 覆盖。
• commit 必须绑定 workingRevision、短 lease、writePlanId 和 source Frame。
• 保存失败返回 SAVE_FAILED 并保留 dirty。

验证结果

• node 02-P/Round01-mindraw-defstart/spikes/002-document-lease-app-write-api/validate-document-lease.mjs：PASS。
• rg -n 'mindraw\.app\.get_open_document_state|MD-H1-02|MD-H1-03|MD-H1-04|MD-H1-05|SAVE_FAILED' 02-P/功能任务/document-lease-app-write-api-production-design.md：命中关键项。
• git diff --check -- 02-P/功能任务/document-lease-app-write-api-production-design.md 02-P/qa/mindraw-phase38-production-design-review.md 02-P/plan-progress.markdown INDEX.md：无输出。
• rg -n '[[:blank:]]+$' 02-P/功能任务/document-lease-app-write-api-production-design.md 02-P/qa/mindraw-phase38-production-design-review.md：无输出。

剩余风险

• 生产 App API 尚未实现。
• loopback capability、runtime token 和 m4c discovery 尚未联调。
• 真实 editor bridge、多 tab、非 active tab 策略尚未实现。
• createAiResultFrame 真实 layout 和保存失败 UI 尚未验证。
• 联合 smoke 和 PM-H5 Gate 尚未开启。

下一步归属

• MD-H1-02 是否派发由 PM 决定；Mindraw worker 不自动开工实现。
• m4c 侧按总台账继续处理 M4C-*。
• PM-H5-GATE 等 Mindraw 和 m4c 入口条件齐备后由 PM 拆分。

备注

工作区中存在并行 m4c 台账 / 索引变更和若干未跟踪目录，本轮未回退这些内容。