SYNC_ARCHITECTURE.md 的 L3 Connector 示例不可编译,且写的是 schema 会**拒收**的键名(sourceField / targetField / transform.type: 'custom' / webhook retryPolicy) #5515

分诊结论

分类:pm:queue
领域:domain:spec

核对结果(对照 origin/main,均已复核):

• packages/spec/src/shared/mapping.zod.ts 的 FieldMappingSchema(基,ConnectorFieldMappingSchema 在 connector.zod.ts extend 它)只声明 source/target,没有 sourceField/targetField;FieldMappingTransformSchema 是判别联合,type 只接受 constant | cast | lookup | javascript | map,没有 custom。
• connector.zod.ts 的 WebhookConfigSchema(WebhookSchema.extend({ events, signatureAlgorithm }))链上确实没有 retryPolicy 键。
• export type Connector = z.infer<...> / ConnectorInput = z.input<...> 属实,裸名是 parsed 形状,故文档里 syncConfig.schedule 的裸 cron 字符串编译不过。
• packages/spec/docs/SYNC_ARCHITECTURE.md 在 origin/main 上 L3 sapConnector 示例(205–262 行)原样带着 sourceField/targetField/type: 'custom'/retryPolicy 四处问题,前提未过期,缺陷仍然存在。

去重:全组织搜索未发现同主题的重复 issue 或在飞 PR。唯一相关的开放 PR #5514(修 #4963)同样改了本文件,但 diff 核实过只动了 L2 ETLPipeline 段落,完全没碰 L3 Connector 段,不构成冲突或阻塞。

理由:前三条(sourceField/targetField→source/target、transform.type 去掉 'custom'、去掉 webhooks[].retryPolicy)是定位明确、可独立执行的纯文档修正,不依赖任何未决裁定。第四条(裸名 Connector vs ConnectorInput 的 house convention 选择)issue 本身已言明"改注解或改约定都能解"、可独立于前三条推进,不构成阻塞前三条排队的理由,后续 PR 里按 #4963 已确立的分析路数处理即可,不必上升为 needs-user-decision。落地文件锚点:packages/spec/docs/SYNC_ARCHITECTURE.md(主要改动)与 packages/spec/src/integration/connector.zod.ts/packages/spec/src/shared/mapping.zod.ts(比对依据),均属于 packages/spec,对应 domain:spec。

本评论来自分诊座位 Routine(#5474 试点),不构成认领。

Generated by Claude Code

PM 认领(spec 车道 PM,session_018fxLGQdatPbBUvCgiVxg6D,2026-08-05)

• 分支:claude/issue-5515-sync-arch-l3-sap
• 工作树:../objectstack-5515-sync-arch-l3(基于最新 origin/main)
• 域:domain:spec
• 文件面:packages/spec/docs/SYNC_ARCHITECTURE.md(主改动)+ L3 段编译门(etl-author-shape.test.ts 扩展或旁立 connector-author-shape.test.ts);比对依据 integration/connector.zod.ts、shared/mapping.zod.ts(只读)
• 范围裁定:前三条键名修正 + 第四条按改示例注解为 input 形状解(connector.zod.ts 20 个 z.infer 裸名别名的约定翻转是独立 appetite,本单不动);fix(spec): automation/etl.zod.ts 的九个别名回到 X / XParsed house convention (#4963) #5514 已合并,块数钉子(6)如变动须在 PR 里显式说明
• 与在飞 [spec] 退役 HookContext session.roles —— #4839 双删后零消费方零生产方(ADR-0049) #5050、docs-gen: .describe() 里的 {{var}} 在生成的参考文档里被转义成 ` {{var} + 游离的 }`(main 上现存 3 处) #5452 及同批 ChartDrillDownSchema.target 少一个成员:objectui 的 ObjectChart 现在兑现 'navigate',而 #5022 定型的联合按「chart 不读它」把它排除了 #5435、44 个 strictUnknownKeyError 直接调用点的别名表在 #5013 闸门覆盖之外(实测干净,但无人看守) #5483 文件面互不相交
• 派发:os-dev(opus)。若本评论之前存在不同 session 的认领,以先者为准、本认领作废。

Generated by Claude Code

验收通过(spec 车道 PM,session_018fxLGQdatPbBUvCgiVxg6D,2026-08-05)—— PR #5603。

• 四处修正落地:source/target 规范拼写、transform 取 javascript 成员(裸串为 ExpressionInput 简写)、retryPolicy 删除 + [P2] Aspirational-config disposition: reconcile-or-prune the still-dead props from the 2026-06 liveness audit (Theme / Translation / Job / Webhook) #3494 墓碑注释(并区分下方 retryConfig)、注解改 ConnectorInput(含 Migration Guide 两处草图,避免同篇教两种注解)。
• 新编译门 integration/connector-author-shape.test.ts 为 etl-author-shape.test.ts 兄弟门:先证红复现 issue 四条诊断逐字一致,反向验证四探针具名变红 + 规范对照组绿;运行期措辞三键各钉(key 判决 / 静默剥离 / value 判决)。块数钉子 6 不变。
• 前提细节更正有价值:sourceField 在 connector 面是静默丢弃(curated alias registry 属 ./data 的 ImportFieldMappingSchema,非 ConnectorFieldMappingSchema),比 issue 描述的拒收更难自查——已按事实钉进门里。
• 范围外发现三单已立:integration/connector.zod.ts 的 20 个裸名别名仍是 z.infer,与 #4963 确立的 X / XParsed house convention 相反(作者写的是 ConnectorInput) #5551(20 个裸名别名翻转,Blocked-by 本单)、shared/mapping.zod.ts 的 javascript 变换 describe 推荐 dialect="js",而 ExpressionDialect 只有 cel/cron/template —— 照着写会被拒 #5552(dialect="js" 已退役却在 describe 里推荐)、SYNC_ARCHITECTURE.md 的 L3 段仍在三处宣传 Rate Limiting,而 connector.rateLimitConfig 及其整个形状已在 #4911 退役 #5554(L3 散文仍宣传已退役的 Rate Limiting)。
• tests/docs-only,skip-changeset 已打并生效。

落地暂缓:ESLint job 因 #5604(main 侧 engine-double-contract 断裂,与本单无关)全仓红,修复落地后本 PR 合 main 重跑 → ready → auto-merge。

Generated by Claude Code