# 2026-06-30 MEXP08B m4c 收口

## 用户目标

以 `Coder@m4c` 身份领取统一台账 `P-20260630-mexp08b-external-model-writeback` 的 `M4C-MEXP08B-01`，完成 m4c 侧外部模型 PNG 结果包 / writeback runner：消费已确认的 `frame-only` context 与 MEXP08A 已验收 PNG，生成 sanitized writeback request/package；Mindraw capability 可用时只能通过 Mindraw App API / lease 发起写回，不得 direct-write `.mindraw` 或手写 `.assets`。

## 已完成事项

- 新增 m4c runner：`p.mindrawforcodex/03-O/C3.tools/scripts/m4c-external-image-writeback-runner.mjs`。
- runner 支持 `build`、`run`、`smoke`、`help`：
  - `build` 生成 `m4c.externalImageResultWriteback.v1` sanitized package。
  - `run` 读取当前 Mindraw runtime capability、检查 health/capabilities，并仅在图片 result writeback capability 存在时走 App API。
  - `smoke` 生成过程 QA JSON / check Markdown 与正式 QA checklist。
- 生成过程证据：
  - `p.mindrawforcodex/02-P/MEXP08B-ExternalModelWriteback/qa/m4c-mexp08b-01-sanitized-writeback-package.json`
  - `p.mindrawforcodex/02-P/MEXP08B-ExternalModelWriteback/qa/m4c-mexp08b-01-external-image-writeback-runner.json`
  - `p.mindrawforcodex/02-P/MEXP08B-ExternalModelWriteback/qa/m4c-mexp08b-01-external-image-writeback-runner-check.md`
- 生成正式 QA 记录：
  - `p.mindrawforcodex/03-O/K2.项目管理/联调QA/2026-06-30-M4C-MEXP08B-01ExternalImageWriteback.md`
- 同步 m4c 索引 / 工程地图：
  - `p.mindrawforcodex/03-O/C3.tools/README.md`
  - `p.mindrawforcodex/03-O/C1.source/CODEGRAPH.md`
  - `p.mindrawforcodex/03-O/K2.项目管理/README.md`
  - `p.mindrawforcodex/INDEX.md`
- 回写统一台账：
  - `02-P/plan-progress.markdown` 中 `M4C-MEXP08B-01` 标记为完成，但结论为 `PREPARED_BLOCKED_BY_MD_MEXP08B_01_IMAGE_WRITEBACK_API`。

## 关键决策

- m4c 只产出 sanitized package 和 App API 调用路径，不在 capability 不足时绕过 Mindraw。
- 当前 live Mindraw capability 只有既有 `createAiResultFrame` / lease / live context 能力，未声明 `externalImageResultFrame.write` 或等价图片 result 写回能力。
- 因此 m4c 返回精确 blocker：`MINDRAW_IMAGE_RESULT_WRITEBACK_UNAVAILABLE`，下一步归属 `MD-MEXP08B-01`。

## QA 结论

- `node --check p.mindrawforcodex/03-O/C3.tools/scripts/m4c-external-image-writeback-runner.mjs`：PASS。
- `node p.mindrawforcodex/03-O/C3.tools/scripts/m4c-external-image-writeback-runner.mjs help`：PASS。
- `node p.mindrawforcodex/03-O/C3.tools/scripts/m4c-external-image-writeback-runner.mjs smoke`：PASS，结论为预期 blocker `MINDRAW_IMAGE_RESULT_WRITEBACK_UNAVAILABLE`。
- package 断言：`readScope=frame-only`、`outsideTextIncluded=false`、`fallbackToDocumentRead=false`、`documentReadFallbackAllowed=false`、不包含图片 bytes、本机输入路径、runtime endpoint 或 token。
- 泄漏扫描：过程 QA / 正式 QA 中未发现 bearer token、runtime endpoint、capability path、private key、API key、`.p12`、图片 base64 或 PNG bytes。
- `git -C p.mindrawforcodex/03-O diff --check`：PASS。

## Git 证据

- m4c `03-O` commit：`54f3f1e5cb613b4741cb8227d2e14c7614983d57`。
- commit message：`feat: add MEXP08B external image writeback runner`。
- commit 后 m4c `03-O` 工作区 clean。

## 未决问题

- Mindraw 侧 `MD-MEXP08B-01` 仍需补外部 PNG result Frame 写回 capability / controlled mutation，并解决图片传输与 `.assets` 权威写入。
- `PM-MEXP08B-GATE` 仍需等待 Mindraw 侧完成后再执行，不能因 m4c package builder 完成而提前 Gate。

## 后续建议

- `MD-MEXP08B-01` 完成后，PM 可要求 m4c 复跑同一 runner；若 capability 增加 `externalImageResultFrame.write` 或等价能力，m4c 才能进入 App API 写回路径。
- 复跑时继续使用现有 sanitized package / QA 路径，避免重新引入 direct package write 或 `.assets` 手写路径。