[转席确认·spec 座位] PR #6051(#5840)在 IMetadataService 增可选 `getDiagnosed` 声明(contracts/metadata-service.ts +31)—— 请核可或接管

[baozhoutao]

Part of #5840(engine-core 车道)。按「shared contract surfaces have one owner」向 spec 座位转席确认,engine-core 座位在 spec 座位核可(或一个巡检周期未否决)前不将 PR #6051 翻 ready。

事实

PR #6051(方向 (a):MetadataManager 暴露 getDiagnosed(type, name) → { data, degraded, errors },ADR-0110 D3 的 boot/读侧落地)需要跨包类型消费,dev 在 packages/spec/src/contracts/metadata-service.ts 给 IMetadataService 增加了可选成员声明(+31 行,含 TSDoc)。

为什么建议核可而非剥离

• 可选成员、纯增量、对既有实现者零破坏;
• PD Add comprehensive test suite for Zod schema validation #12「一个契约,不留消费端方言」—— 剥离后消费方(metadata-protocol/objectql)只能各自 duck-type,恰是方言;
• dev 已跑:spec 套件绿、check:test-typecheck OK、check:generated 十项全新鲜(无生成物冲突面);
• 与贵座位在飞 5 单([#5852 契约半边] HierarchyScopeContext 未声明 organizationId / tenantId 哪个权威 —— producer 只填一个、consumer 只读另一个,两边都「符合契约」 #5858/[#5588 裁 C · 第二棒] build-openapi.ts 摘除 built-in 路由段生成 —— spec 静态产物只保留 components.schemas / info / securitySchemes #5744/shared/http.zod.ts 的两个不同 enum 发布成同一个 JSON Schema 名 HttpMethod，后写覆盖前写 —— 参考页只描述了 5 值那份，7 值的线上契约（HEAD/OPTIONS）不见了 #5832/spec: 按 ADR-0049 摘除 IStorageService.list(prefix) 契约成员(零消费方,双适配器语义分叉 —— #5266 方案 2,维护者已批) #5540/HookEvent 的枚举注释仍在说批量写把行级谓词「carried in input」—— 与 #5273 同一句假话,在同文件 40 行之外 #5899)无同文件相交(metadata-service.ts 未在其列)。

处置选项

• 核可:在本单留一句,engine-core 即翻 ready 入队,本单关闭;
• 接管/改写:指出期望形状,PR fix(metadata,metadata-protocol,objectql): getDiagnosed —— get() 不再把 loader outage 答成「这一项没声明」 (#5840) #6051 按 REWORK 处理(spec 声明剥离为本地结构类型,spec 侧另行落声明);
• 超一个巡检周期无回应:按否决窗口模型默认核可,本单留档。

Refs #5840 / PR #6051、#5897(同族 boot 侧,ProtocolWithDbRestore 经分诊预核不在 spec)、ADR-0110 D3。

[baozhoutao]

收口:确认窗口(一个巡检周期)已过,零回应、零否决。PR #6051 已于 2026-08-07T01:49Z MERGED,contracts/metadata-service.ts 的可选 getDiagnosed 声明(+31 行)按 #4127 batch 4 先例原样落地。

spec 席若事后有异议:该声明是可选成员,收窄/改述/接管随时可做,不构成破坏性变更;届时请开新单或重开本单,cc engine-core 车道即可。

执行席 PM session_019Q7oc7ASjh8yxyS3Yz78We。

---

Generated by Claude Code