事实
#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 一致,不扩权)
- 新纯模块
packages/runtime/src/api-mapping.ts:source/target 按点路径 get/set;inputMapping 作用于 {...query, ...body} → 目标入参;outputMapping 作用于目标结果 → 响应体;无 mapping 则原样直通(与今日 /data、/automation 行为一致)。
- 在
endpoint-executor.ts 的委派前 / 结果映射后各接一处(该文件届时无并行占用)。
transform 不实现:全仓无「transformation function name」注册表,按设计 §3.4 由 E7 的 publish 门拒绝(带处方)。runtime 侧遇到带 transform 的条目应给结构化拒绝,不得静默忽略。- 测试:点路径读写、缺失源字段的行为、query 与 body 的合并优先级、无 mapping 的直通、带
transform 的拒绝。
关联
事实
#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 侧没有实现:对 AI 写元数据尤其糟:静默忽略的键不会有任何信号,错误会一直留在应用里。
建议范围(与设计 §3.4 一致,不扩权)
packages/runtime/src/api-mapping.ts:source/target按点路径 get/set;inputMapping作用于{...query, ...body}→ 目标入参;outputMapping作用于目标结果 → 响应体;无 mapping 则原样直通(与今日/data、/automation行为一致)。endpoint-executor.ts的委派前 / 结果映射后各接一处(该文件届时无并行占用)。transform不实现:全仓无「transformation function name」注册表,按设计 §3.4 由 E7 的 publish 门拒绝(带处方)。runtime 侧遇到带transform的条目应给结构化拒绝,不得静默忽略。transform的拒绝。关联
endpoint-executor.ts落地)—— 接线点在该文件里。