[#14478 stack 6/6] widen `check:duration-unit-keys` from `packages/spec/src/**` to every workspace package's zod schemas (folds #15642) and convert the one turso offender it finds

[os-project-manager]

Part of #14478 — follow-on card 6 of 6, filed by the domain:spec seat (session_01M59rPZZFzqhfMUPFqqZTkf, 2026-09-05T02:55Z) under the maintainer ruling B on #14478 (5548763981, batch #43, 「同意」). Folds #15642 (the gate's declared population is packages/spec/src/** only) into the stack, as the ruling directs; that card closes with this one's PR. Dispatched last, after stack cards 1/6–5/6 have PRs to stack on (the widened population must be measured against a tree where the spec-side remainder is already converted, or the count is meaningless).

Ruling text this card executes (verbatim)

The gate's population widens to every workspace package's zod schemas (#15642).

#15642 (population limited to packages/spec/src) is folded into the same plan: the gate's SRC_ROOT widens to every workspace package's zod schemas, with the one turso offender converted.

What this card changes

1. packages/spec/scripts/check-duration-unit-keys.ts: the declared population (SRC_ROOT / ROOT_DIR_WATCH_HINTS, held by the script's self-test) widens from packages/spec/src/** to every workspace package's zod schema sources — the walk must EXCLUDE node_modules (measured trap on finding: check:duration-unit-keys scans packages/spec/src/** only — the same offender shape exists in workspace packages the gate never reads #15642: --root pointed at a package root walked node_modules and reported "7151 offenders in 150098 source files", a reading about dependencies), dist/, and test files; the self-test pins the exclusion. Wiring in lint.yml stays as it is (last step of Lint & Repo Gates).
2. The offender(s) the widened walk finds outside packages/spec: measured on finding: check:duration-unit-keys scans packages/spec/src/** only — the same offender shape exists in workspace packages the gate never reads #15642 as one — packages/drivers/driver-turso/src/spec/turso.zod.ts:104, a published connection-config timeout described in ms ⇒ timeoutMs with the driver's own ADR-0087 route (that package publishes; @objectstack/driver-turso minor with a BREAKING banner). Any further offender the widened gate reports is converted in the same PR or, if it belongs to an exemption class, marked per card 1/6's convention — ⛔ no exception list, no baseline.
3. #15642 is closed by this PR (Fixes #15642 on its own line; Part of #14478 stays first).

The predicate (unchanged; only the population moves)

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; { value, unit } pairs, duration literals, calendar positions and rates are outside the population; keys marked externalVocabulary and values that are the shared EpochMs schema (card 1/6) are exempt by declaration.

Execution notes

• Stacked on card 5/6's head; draft PR, base = that branch; body first line Part of #14478, then Fixes #15642. ⛔ Never Fixes #14478.
• Clause-②: yes (a published driver key renames) ⇒ needs:contract-review on PR and card at creation. Changesets: @objectstack/driver-turso minor + BREAKING; @objectstack/spec patch for the gate script only if it ships (derive from check:published-files).
• The stacked head with this card is the one the ruling names: "the set lands together when check:duration-unit-keys is green on the stacked head" — this PR's CI must show the gate green on the whole stack.

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

[os-zhuang]

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

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

Blocked-by: #15680（栈 5/6）
Restart-when: 5/6 的 PR 存在且其 head 上 spec 侧余量已转换 —— 本卡自陈理由充分：加宽后的人口必须在 spec 侧已经转换完的树上测，否则那个计数没有意义。⛔ 不是「5/6 已合并」；整条栈一起落地（裁决：the set lands together when check:duration-unit-keys is green on the stacked head）。

⭐ 本卡是整条栈的收口，这一点值得写明

裁决点名的那个 head 就是带上本卡的叠加 head：本 PR 的 CI 必须显示门在整条栈上为绿。⇒ 本卡不是「最后一个小尾巴」，它是那条「全绿才落地」判据的承载者。

复核（origin/main = 95d5cbb）

• 被折叠的 finding: check:duration-unit-keys scans packages/spec/src/** only — the same offender shape exists in workspace packages the gate never reads #15642 的那条事实成立：packages/drivers/driver-turso/src/spec/turso.zod.ts:104 — timeout: z.number().int().min(0).optional().describe('Operation timeout in milliseconds'), ⇒ 单位只在 describe 散文里，键名裸露。这是 spec 之外唯一已测出的 offender。
• ⚠️ 门今天不在 main 上：本席位实测全树 duration-unit-keys 0 命中、package.json 无该脚本注册，阳性对照为 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 的草稿分支 ⇒ 本卡正文里 SRC_ROOT / ROOT_DIR_WATCH_HINTS 的位置，⛔ 在 main 上验不了。

⛔ 本卡最危险的一条：node_modules

卡片已把它写成硬约束，本席位加重并给出实测数字（来自 #15642）：把 --root 指向包根而非该包的 src，走查会连 node_modules 一起走，返回

7151 offender(s) … in 150098 source file(s)

⇒ 那是一份关于本仓依赖的读数，不是关于本仓的。 加宽后的 walk 必须排除 node_modules、dist/ 与测试文件，并由自测钉住这条排除（卡片已要求）。

⚠️ 一条同族的方法提醒（本席位本轮亲自摔过）：pathspec 写成 packages/*/src 在某些 grep 场景会静默返回零、连阳性对照一起归零 ⇒ 无论用哪种写法迭代 packages/*/src 与 packages/*/*/src，都必须带一个已知会开火的对照，否则「加宽后只找到 1 个 offender」可能是仪器没开火而不是真的干净。

锚定 / 定级 / 类型

主落点是 packages/spec/scripts/check-duration-unit-keys.ts（门的人口与自测）⇒ domain:spec（车道表：packages/spec/scripts/** 与围着 spec 契约转的工具链）。
⚠️ 本卡另有一个包外落点：packages/drivers/driver-turso（domain:engine 车道的 driver-*）。⛔ 本席位不拆卡——那是一行键名加它自己的 changeset，且裁决明确要求它与门的加宽在同一个 PR里（否则加宽后的门会在本 PR 上就报红）。⇒ 按「不可切分」处理，归 domain:spec 席执行，driver-turso 的改动在本卡授权范围内。

整条栈同级 p2（一个落地单元）。重命名已发布的驱动键 ⇒ Feature 侧、manual floor；卡片自陈 Clause-②: yes，⛔ needs:contract-review 由 PR 创建时同笔贴到 PR 与卡，本席位不代贴。

通用与本卡特有的四条

1. PR 正文首行 Part of #14478，其后 Fixes #15642 单独一行。⛔ 绝不 Fixes #14478。
2. 分支叠在 5/6 的 head，PR base 指向它，draft。
3. ⛔ 无例外清单、无 baseline。 加宽后的门若报出更多 offender，要么在本 PR 内转换，要么按 1/6 的约定标记为豁免类。⛔ 不许开豁免名单，也⛔ 不许落一个 baseline 文件把它们冻起来。
4. changeset：@objectstack/driver-turso minor + BREAKING banner；@objectstack/spec 仅在门脚本随包发布时打 patch（由 check:published-files 推导，⛔ 不要凭印象打）。

被折叠的那张卡

#15642 已由本席位标为 pm:blocked 并在其上写明：预期终局是被本卡的 PR 自动关闭，⛔ 不需要独立派发。

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

---

Generated by Claude Code