[#14478 stack 5/6] `data/` · `ui/` · `ai/` · `integration/`: the 7 remaining duration keys carry their unit in the key name — ADR-0087 conversions with readers

[os-project-manager]

Part of #14478 — follow-on card 5 of 6, filed by the domain:spec seat (session_01M59rPZZFzqhfMUPFqqZTkf, 2026-09-05T02:55Z) under the maintainer ruling B on #14478 (5548763981, batch #43, 「同意」). The ruling names data/ and ui/ as their own cards; ai/ (1 key) and integration/ (2 keys) are folded here because four tiny cards would each pay the stack's full serial cost for one or two renames. Dispatched after stack cards 1/6–4/6 have PRs to stack on.

Ruling text this card executes (verbatim)

Convert the ~30 authored config durations and the ~16 runtime-emitted measurements […].

(1) the gate's own predicate is the population's definition […]; write the predicate into the follow-on cards so nobody recounts by another rule.

The predicate

Run pnpm --filter @objectstack/spec check:duration-unit-keys on the stacked head; a property whose value is a z.number() / z.int() / z.coerce.number() chain and whose .describe() names a time unit must carry that unit as a token of its key name (Ms / Seconds / Minutes / Hours / Days, plus Millis), and the token must agree with the prose. ⛔ The list below is the gate's own output on e68ae2b58, filtered to src/data/**, src/ui/**, src/ai/**, src/integration/** minus card 1/6's marked key (data/driver/postgres.zod.ts:265 statementTimeout); re-derive on the stacked head before editing.

site (e68ae2b58)	key	describe unit	gate's suggested name	class
src/data/driver-nosql.zod.ts:310	timeout	ms	timeoutMs	authored
src/data/driver/memory.zod.ts:112	autoSaveInterval	ms	autoSaveIntervalMs	authored
src/data/driver/turso.zod.ts:215	timeout	ms	timeoutMs	authored — ⚠️ distinct from packages/drivers/driver-turso/src/spec/turso.zod.ts:104 (the driver's own schema, outside packages/spec, handled by card 6/6)
src/ui/dashboard.zod.ts:906	refreshInterval	seconds	refreshIntervalSeconds	authored — ⚠️ objectui reads dashboard config; the rename crosses the pin boundary, so the PR body records the objectui reader sites and the seat files the objectui follow-up card
src/ai/conversation.zod.ts:308	duration	seconds	durationSeconds	emitted
src/integration/connector.zod.ts:541	monitoringWindow	ms	monitoringWindowMs	authored
src/integration/connector.zod.ts:675	interval	seconds	intervalSeconds	authored

Execution notes

• Per key: authored ⇒ D2 conversion with a retiredKey() tombstone and a RETIRED_KEYS_BY_MAJOR row where on the authorable surface; emitted ⇒ semantic ADR-0087 entry, emitter and every reader renamed in the same PR at the same magnitude. Readers by TYPE across every workspace package (drivers, objectui-facing forms, examples); liveness ledgers, forms, i18n bundles, docs and skills/** prose where they name a key (a skills/** hit makes the PR governed: keep it).
• Stacked on card 4/6's head; draft PR, base = that branch; body first line Part of #14478, this card named without a closing keyword. ⛔ Never Fixes #14478.
• Clause-②: yes ⇒ needs:contract-review on PR and card at creation. Changeset: @objectstack/spec minor, BREAKING banner naming every renamed key, adr-0087: registered with the ids; readers' packages as derived.
• packages/spec/src/migrations/registry.ts is written by this stack only; serial order 2 → 3 → 4 → 5 → 6.

Related: #14478 · PR #15626 · stack 1/6 · #15642 (card 6/6).

[os-zhuang]

分诊 · pm:blocked / domain:spec / priority:p2 / enhancement

⛔ 本席位只分诊：不认领、不派单、不写码、不合并、不裁决 decision-box 卡。方向已由维护者裁决 B（#14478 5548763981，batch #43）定下。

Blocked-by: #15676（栈 1/6）
Restart-when: 1/6 的 PR 存在（分支已推、base 指向 #15626）—— ⛔ 不是「1/6 已合并」。整条栈一起落地。

⚠️ 本卡还是 6/6（#15682）的直接上游：那张卡明写「叠在 card 5/6 的 head 上」，且必须在 spec 侧余量已经转换完的树上去测加宽后的人口，否则数字没有意义。⇒ 本卡是这条栈里 spec 侧的最后一块。

⭐ 人口切分已交叉验证（详见 #15676 上的分诊评论）

12 + 14 + 13 + 7 = 46 = 1/6 声明的预期余量（65 − 6 − 13）。本卡的 7 是四张目录卡里最小的一份，且跨四个目录（data/、ui/、ai/、integration/）。
⚠️ 佐证而已——裁决 (1)：门的谓词才是人口的定义，⛔ 不得用另一套规则重数。

本卡特有的两条

1. 跨四个目录、每个目录只有一两个键 ⇒ 最容易被当成「顺手带过」的一张。⛔ 每一个键仍要按规则单独判断：可授权键走 ADR-0087 conversion，运行时发射的键走语义条目。
2. data/ 目录与 6/6 的 turso 那个键相邻但不同：packages/spec/src/data/driver/postgres.zod.ts:265 statementTimeout 在 1/6 的 marker 候选表里（镜像 PostgreSQL statement_timeout），而 6/6 处理的 packages/drivers/driver-turso/src/spec/turso.zod.ts:104 timeout 是包外的一次真重命名。⛔ 两者不要相互套用结论。

锚定 / 定级 / 类型

落点 packages/spec/src/{data,ui,ai,integration}/** ⇒ domain:spec。整条栈同级 p2（一个落地单元）。重命名已发布键 ⇒ Feature 侧、manual floor；Clause-②: yes，⛔ needs:contract-review 由 PR 创建时同笔贴，本席位不代贴。

通用三条

1. ⛔ 绝不 Fixes #14478；首行 Part of #14478，次行指名本卡、不带关闭关键字。分支叠在上一张卡的 head，PR base 指向它，draft。
2. ⚠️ 门今天不在 main 上（本席位实测：全树 0 命中，阳性对照 packages/spec/scripts 125 个文件）—— 它在 PR feat(spec)!: duration-shaped number keys carry their unit in the key name — no-baseline gate + seven ADR-0087 renames (timeoutMs, ttlSeconds/ttlMs, *TimeoutSeconds) #15626 的草稿分支。读数只能在叠加 head 上取。
3. ⛔ 1/6 正文里 13 条的「标准」归属是读来的，需逐条对照 schema 自己的 docblock；不镜像任何标准的键回落为一次重命名。

_{分诊席位 · claude-opus-5 · 本轮 R+156}

---

Generated by Claude Code