# 2026-06-27 MD-H6-01 AssetStore 契约

## 用户目标

以 Coder@mindraw 身份领取统一台账 `P-20260626-m4c-handshake-coordination` 中的 `MD-H6-01`，为 Phase 4 AssetStore / `.assets` 权威化写 Mindraw 侧独立契约。范围限定为契约与证据，不做 H8 发布，不改 m4c `03-O`，不混入 H5 hardening，不开放任意 JSON patch，不绕过 App 写包。

## 已完成事项

- 重新读取 `/Users/ar/.codex/AGENTS.md`、项目 `AGENTS.md`、`INDEX.md`、`CODEGRAPH.md` 和统一台账中 H6 / `MD-H6-01` / `PM-H6-ASSETSTORE-CONTRACT-GATE` 最新状态。
- 读取现有 `.mindraw` ADR、manifest schema、兼容矩阵、Phase 2 QA 和当前读写实现事实，确认当前 `files.dataURL` 仍是运行时和导出安全底座。
- 新增 Mindraw 侧 Phase 4 AssetStore / `.assets` 权威契约草案。
- 新增契约自查报告。
- 同步 `INDEX.md`、`CODEGRAPH.md` 和 `02-P/plan-progress.markdown`。
- `MD-H6-01` 已在统一台账标记完成。

## 关键决策

- Phase 4 第一批建议使用 `assetStore.authority=dual` 过渡，再进入 `asset-store`。
- 第一批建议固定 `inlineCache=required`：`.assets` 可以成为权威，但 `drawing.excalidraw.files[fileId].dataURL` 继续作为 Excalidraw runtime 和导出兼容缓存。
- m4c 不得直接创建、删除、移动 `.assets` blob，也不得直接编辑 `manifest.assets[]`；外部写入必须通过 Mindraw App API、lease、`workingRevision` 和受控 DTO。
- H7 仍保持 blocked，直到 `MD-H6-01`、`M4C-H6-01` 和 `PM-H6-ASSETSTORE-CONTRACT-GATE` 收敛。

## 文件变更

- 新增 `02-P/功能任务/phase4-assetstore-authority-contract.md`
- 新增 `02-P/qa/mindraw-phase4-assetstore-contract-review.md`
- 更新 `INDEX.md`
- 更新 `CODEGRAPH.md`
- 更新 `02-P/plan-progress.markdown`
- 新增本会话记录 `.codex-sessionhistory/2026-06-27-MDH601AssetStore.md`

## 验证 / 自查

- `rg -n "assetStore|assetId|sha256|register|repair|export|inlineCache|arbitraryJsonPatch|M4C|H7|PM-H6" 02-P/功能任务/phase4-assetstore-authority-contract.md`
- `git diff --check`

结果：关键项均命中，`git diff --check` 无输出。

## 剩余风险

- 本轮只是 Mindraw 侧契约草案，不是生产实现。
- `inlineCache=required` 是 Mindraw 侧建议，需要 PM gate 结合 m4c 需求冻结。
- `M4C-H6-01` 尚需 m4c 侧回写 consumer 需求和兼容矩阵。
- `PM-H6-ASSETSTORE-CONTRACT-GATE` 尚未收敛，不能宣布 Phase 4 或 H8 Go。

## 后续建议

- 等 m4c 完成 `M4C-H6-01` 后，由 PM 收敛 `PM-H6-ASSETSTORE-CONTRACT-GATE`。
- 若 PM 冻结契约，后续应拆 Mindraw 侧 `MD-H6-*` 实现任务，包括 fixtures、schema validator、register/read/repair/export API 和真实包 QA。