Part of #5712(维护者 2026-08-06 裁读法 1;裁决评论预授权本拆分:「若需要 spec 新增带格式校验的 specifier,按 contract-first 拆分转 spec 座位,services 侧跟进」)。spec 半边先行(contract-first),services 半边(#5712)Blocked-by 本单。
为什么现行 spec 表达不了裁决
#5712 的 dev 实测(2026-08-06,报告存档于该单):
SettingsManifestSchema 的 SpecifierSchema 值约束位只有 options / pattern / min / max / minLength / maxLength;夹带 format 键被 Zod 直接剥掉(parse 后 undefined);pattern 只能约束形状,拦不住形状合法的垃圾值(Mars/Olympus 会被放行)——违反「垃圾值响亮拒收」;options 补全路线同样违反裁决:见下面的实测陷阱。
于是「options 表 = UI 便利列表,执行边界 = 标准域」这句裁决在 manifest 里没有任何声明位。
提案(#5712 dev 的方案 C,services 座位推荐,枚举词表由 spec 座位定夺)
SpecifierSchema 新增可选键 valueDomain,闭合枚举,例如:
valueDomain?: 'iana_time_zone' | 'iso_4217_currency' | 'iso_3166_alpha2' | 'bcp47_locale'
语义:声明存在时,该标准域是执行边界,options 退化为 UI 便利列表(下拉建议,不再穷尽拒绝);未声明时一切照旧(#5131 的 options 穷尽语义对注册表背书类的表保持不变,如 sms/mail 的 provider)。校验的执行仍在 service-settings(spec 只声明,不执行)—— spec 侧交付物按本车道纪律:schema + authorable-surface 基线 + pin + 文档。
⚠️ 实现陷阱(已实测,直接决定域校验的正确定义)
- 时区域 ⛔ 不可用
Intl.supportedValuesOf('timeZone') 当词表:Node 22(仓基线)上它只有 418 项 CLDR 规范名子集,缺 UTC(该 specifier 自己的 default!)、缺 Asia/Kolkata(在库策展值!)、缺 Europe/Kyiv / Asia/Ho_Chi_Minh / US/Eastern / GMT 等。「合法 IANA 时区」的正确定义是 Intl.DateTimeFormat 探针 —— 仓内已有两处先例采用它:resolve-authz-context.ts:449 的 isValidTimeZone、localization.manifest.test.ts:33。
- 币种域可用
Intl.supportedValuesOf('currency'):实测 162 项,CHF 在、XYZ 不在、9 个在库策展值全在(缺 VED 与金属/基金码,可接受或另断)。
真实拉动(创业聚焦轴,实测非断言)
同一个 localization.manifest 里就有三个键需要它:timezone、currency、default_country(第三例:现用 ^[A-Za-z]{2}$ pattern,ZZ 照收 —— 同一个洞)。本 issue 源头是真实 env 配置路径(#5204)。
相邻但不并入
#5932(min/max/minLength/maxLength 在写入路径全空转)是同一 validatePatch 的另一族缺陷,已单独立案待分诊,⛔ 不作本单 rider。
来源座位:services(会话 session_015a5qkLzpGXhLL2F5gvJ7dD);domain:spec 标签待分诊座位补。维护者否决窗口:若坚持零 spec 改动,#5712 上有 dev 给出的最小一致态备选(A 仅 currency + timezone 改 description),在该单评论重裁即可。
Part of #5712(维护者 2026-08-06 裁读法 1;裁决评论预授权本拆分:「若需要 spec 新增带格式校验的 specifier,按 contract-first 拆分转 spec 座位,services 侧跟进」)。spec 半边先行(contract-first),services 半边(#5712)Blocked-by 本单。
为什么现行 spec 表达不了裁决
#5712 的 dev 实测(2026-08-06,报告存档于该单):
SettingsManifestSchema的 SpecifierSchema 值约束位只有options/pattern/min/max/minLength/maxLength;夹带format键被 Zod 直接剥掉(parse 后undefined);pattern只能约束形状,拦不住形状合法的垃圾值(Mars/Olympus会被放行)——违反「垃圾值响亮拒收」;options补全路线同样违反裁决:见下面的实测陷阱。于是「options 表 = UI 便利列表,执行边界 = 标准域」这句裁决在 manifest 里没有任何声明位。
提案(#5712 dev 的方案 C,services 座位推荐,枚举词表由 spec 座位定夺)
SpecifierSchema 新增可选键
valueDomain,闭合枚举,例如:语义:声明存在时,该标准域是执行边界,
options退化为 UI 便利列表(下拉建议,不再穷尽拒绝);未声明时一切照旧(#5131 的 options 穷尽语义对注册表背书类的表保持不变,如 sms/mail 的 provider)。校验的执行仍在 service-settings(spec 只声明,不执行)—— spec 侧交付物按本车道纪律:schema + authorable-surface 基线 + pin + 文档。Intl.supportedValuesOf('timeZone')当词表:Node 22(仓基线)上它只有 418 项 CLDR 规范名子集,缺UTC(该 specifier 自己的 default!)、缺Asia/Kolkata(在库策展值!)、缺Europe/Kyiv/Asia/Ho_Chi_Minh/US/Eastern/GMT等。「合法 IANA 时区」的正确定义是Intl.DateTimeFormat探针 —— 仓内已有两处先例采用它:resolve-authz-context.ts:449的isValidTimeZone、localization.manifest.test.ts:33。Intl.supportedValuesOf('currency'):实测 162 项,CHF 在、XYZ 不在、9 个在库策展值全在(缺 VED 与金属/基金码,可接受或另断)。真实拉动(创业聚焦轴,实测非断言)
同一个 localization.manifest 里就有三个键需要它:
timezone、currency、default_country(第三例:现用^[A-Za-z]{2}$pattern,ZZ照收 —— 同一个洞)。本 issue 源头是真实 env 配置路径(#5204)。相邻但不并入
#5932(min/max/minLength/maxLength 在写入路径全空转)是同一 validatePatch 的另一族缺陷,已单独立案待分诊,⛔ 不作本单 rider。
来源座位:services(会话
session_015a5qkLzpGXhLL2F5gvJ7dD);domain:spec标签待分诊座位补。维护者否决窗口:若坚持零 spec 改动,#5712 上有 dev 给出的最小一致态备选(A 仅 currency + timezone 改 description),在该单评论重裁即可。