E5 遗漏面:端点 inputMapping / outputMapping 未实现(设计 §3.4 的 api-mapping.ts),E7 翻转前必须补 #5137

事实

#5040 设计总表把 E5 行写成「执行目标 + 映射」,文件面含 api-mapping.ts(新)。但 E5 单(#5092)派发时声明的文件面只有 packages/runtime/src/endpoint-executor.ts + 测试 + changeset,PR #5136 因此只做了目标委派,没有做映射:

• endpoint-executor.ts 把 query / body 原样送进委派调用,endpoint.inputMapping / endpoint.outputMapping 一次都没有被读取。

为什么必须在 E7(#5111)之前补

ApiEndpointSchema 声明了这两个键({source, target, transform?}[]),E7 的 publish 门按设计 §3.4 只拒绝 transform 子键,放行 source/target 形式的映射。如果翻转时 runtime 侧没有实现:

作者写了 inputMapping,publish 通过,端点跑起来,映射什么也不做 —— 「解析通过然后什么也不发生」,正是 #5040 设计开篇要消灭的中间态,也是 ADR-0049 declared≠enforced 的教科书形状。

对 AI 写元数据尤其糟:静默忽略的键不会有任何信号,错误会一直留在应用里。

建议范围(与设计 §3.4 一致,不扩权)

1. 新纯模块 packages/runtime/src/api-mapping.ts:source/target 按点路径 get/set;inputMapping 作用于 {...query, ...body} → 目标入参;outputMapping 作用于目标结果 → 响应体;无 mapping 则原样直通(与今日 /data、/automation 行为一致)。
2. 在 endpoint-executor.ts 的委派前 / 结果映射后各接一处(该文件届时无并行占用)。
3. transform 不实现:全仓无「transformation function name」注册表,按设计 §3.4 由 E7 的 publish 门拒绝(带处方)。runtime 侧遇到带 transform 的条目应给结构化拒绝,不得静默忽略。
4. 测试:点路径读写、缺失源字段的行为、query 与 body 的合并优先级、无 mapping 的直通、带 transform 的拒绝。

关联

• 依赖:PR feat(runtime): 端点执行目标委派 —— endpoint-executor 纯模块(#5040 E5) #5136(E5,endpoint-executor.ts 落地)—— 接线点在该文件里。
• Blocks:E7(#5040 执行器):翻转 —— publish 硬拒收窄为「不支持子集 + 命名空间门」,声明式端点随 v17 放行执行 #5111(E7 翻转)—— 翻转前不补,两个键就会以「声明合法、执行忽略」的形态发出去。
• 出处:17.x 立项:建设声明式 ApiEndpoint 执行器(挂载 + matchEndpoint + authRequired/cacheTtl/inputMapping/outputMapping 逐键接线) #5040 设计 §3.4 与总表 E5 行;E5(#5040 执行器):执行目标委派 —— endpoint target 映射到既有 flow / script / proxy 执行管线 #5092 派发时的文件面收窄。