edit | blame | history | raw

2026-06-26 M4C-H5 Transport 准备

用户目标

从 02-P/plan-progress.markdown 的 P-20260626-m4c-handshake-coordination 领取 m4c 侧 M4C-H5-05，为 Mindraw 外部 App API transport 做 m4c 侧 client / adapter 准备。

范围边界：不写真实用户原件，不做 App open direct package write，不宣传 .assets 权威化，不领取 PM-H5-GATE / H* / PM-*；真实 transport 不可用时只 against fixture / stub 验证并回写 blocker / No-Go。

已完成事项

  • 新增 m4c transport client / adapter 准备脚本：p.mindrawforcodex/03-O/C3.tools/scripts/m4c-h5-transport-client-adapter.mjs。
  • 准备 discovery、health check、mindraw.app.* method mapping、timeout / retry、错误码映射、stub capability、contract fixture 和 dry-run fallback。
  • 复用 M4C-H5-01/02/03 fixture 与真实用户工作副本，生成 transport contract fixture。
  • 产出 QA 证据：p.mindrawforcodex/02-P/Round05-MCPAlpha/qa/round05-h5-transport-client-adapter.json 与 round05-h5-transport-client-adapter-check.md。
  • 产出联调清单：p.mindrawforcodex/03-O/K2.项目管理/联调QA/2026-06-26-M4C-H5-05TransportClientAdapter.md。
  • 更新根 INDEX.md、m4c INDEX.md、m4c CODEGRAPH.md、C3.tools/README.md。
  • 回写总台账 02-P/plan-progress.markdown：勾选 M4C-H5-05，追加 Progress Log。
  • m4c 03-O 已提交：6dbe08466ce8b9f76795bdf82b1bbb14ab00484d。

QA 结论

  • node --check p.mindrawforcodex/03-O/C3.tools/scripts/m4c-h5-transport-client-adapter.mjs：PASS。
  • node p.mindrawforcodex/03-O/C3.tools/scripts/m4c-h5-transport-client-adapter.mjs contract：PASS / PREPARED。
  • node p.mindrawforcodex/03-O/C3.tools/scripts/m4c-h5-transport-client-adapter.mjs smoke：m4c contract prepared，但正式 H5 retry 仍 NO-GO。
  • fixture 与真实用户工作副本 digest 均未改变，contract validation errors 为 0。
  • git -C p.mindrawforcodex/03-O diff --check 与 diff --cached --check：PASS。
  • codebase-memory-mcp cli index_repository ...：PASS，项目共享图谱已更新。

关键决策

  • m4c 侧不伪造 live transport 成功；默认 capability 文件不存在时输出 M4C-H5-05-BLOCKER-LIVE-TRANSPORT。
  • 不使用 direct package write 替代 loopback JSON-RPC / App API。
  • H5 retry 是否重开仍由 PM 在 Mindraw MD-H5-02 提供真实 callable transport / capability 后决定。

未决问题

  • Mindraw MD-H5-02 尚需提供真实 external App API transport / capability 文件。
  • 真实 transport 的 token 轮换、HTTP 错误、超时重试、权限失败、App 多窗口 / 多进程行为仍待联测。

后续建议

PM 等 MD-H5-02 完成后，再基于本轮 m4c client / adapter 产物决定是否拆 H5 retry smoke；m4c 当前不领取新任务。