fix(service-settings): remove step 0.1 from ai.temperature — the window is the true domain (#6550)

[os-project-manager]

Closes #6550

变更内容

维护者裁定(2026-08-08,issue 内评论):从 ai.manifest 的 temperature specifier 移除 step: 0.1,保留 min: 0 / max: 2。temperature 的真实值域在 [0, 2] 上连续,而 #6199 使声明的 step 在两扇门(保存门 + env 门)都成为绑定的值约束后,0.1 网格会拒绝合法值(0.15)——正是 #5712 裁定刚在 timezone/currency 上纠正过的「声明窄于真实值域」形态。slider 的步进手感是 UI 层展示关注点,不是契约拒绝。

1. ai.manifest.ts(唯一生产改动,一行 + 注释):temperature 删除 step: 0.1;min/max 保留——窗口就是真实值域,绑定得诚实。
2. ai.manifest.test.ts 新增 ai.manifest temperature declares step: 0.1 — now that the grid binds (#6199), decide whether the declaration itself is product-correct #6550 块(5 条):声明钉死(无 step、过 spec parse round-trip);写入门收 0.15(裁定的复现)与 0.7;窗口仍绑定(2.5 → max_value、-0.5 → min_value,constraint { min: 0, max: 2 },词汇不变);env 门 OS_AI_TEMPERATURE=0.15 赢得级联并锁键;越窗 env 值仍被大声忽略。
3. settings-service.test.ts:settings 的 step 是同族第五个声明但不执行的值约束键 —— 先要一个「它算不算值约束」的判断 #6199 机器测试的 fixture 重指(见下)。

偏离派发卡的说明(fixture 重指落在 settings-service.test.ts)

派发卡写明「不要动 settings-service.test.ts」,同时又要求「若 #6199 网格测试以 ai.manifest 的 temperature 为 fixture,重指到合成的 step 声明 specifier,不得削弱机器覆盖」。两条在本卡上冲突:#6199 的 5 条真实清单测试恰好住在该文件(保存门 1 条 + env 门 4 条),移除 step 后必红。按具体指令压倒一般指令处理,并把冲突面压到最小:

• 编辑严格限于 settings 的 step 是同族第五个声明但不执行的值约束键 —— 先要一个「它算不算值约束」的判断 #6199 两个 describe 块(约 1390–1737 行),与队列中 PR fix(service-settings): company.country adopts the iso_3166_alpha2 value domain (#6579) #6594 的改动区(import 行 + 文件尾部追加)零重叠,git 可干净合并;
• env 门 4 条全部重指到合成 gridenv manifest(保留裁定时 ai.temperature 的原形状 min 0, max 2, step 0.1,env 名 OS_GRIDENV_TEMPERATURE),断言逐条不变——机器覆盖零削弱;
• 保存门那条真实清单钉死(0.15 被拒)随声明一起移动:其后继(0.15 被收)在 ai.manifest.test.ts,原位留注释指路。settings 的 step 是同族第五个声明但不执行的值约束键 —— 先要一个「它算不算值约束」的判断 #6199 网格机器本身未动,仍绑定任何声明 step 的键。

反向验证(先定方向再跑)

预测:把 step: 0.1 放回清单后,恰好 3 条新测试变红(声明钉死、写入门收 0.15、env 门 0.15 生效),越窗两条保持绿(窗口先于网格裁决),重指后的 #6199 合成测试全绿(与清单解耦正是重指的目的)。实测完全一致:3 红 / 319 绿,复原后 16 文件 / 322 测试全绿。

验证

• pnpm --filter @objectstack/service-settings test:16 文件 / 322 测试全过(新增 5 条,移走 1 条真实清单钉死);
• 触碰文件 eslint 干净(exit 0);
• 包内 tsc --noEmit 错误数 13,与 DEBT 账本持平(未新增);
• node scripts/check-nul-bytes.mjs OK;
• changeset:@objectstack/service-settings patch(用户可见的校验放宽)。

其余 step 声明者(按卡要求核查,均未触碰)

• settings-manifest 域(settings 的 step 是同族第五个声明但不执行的值约束键 —— 先要一个「它算不算值约束」的判断 #6199 机器的辖面):ai.manifest.ts 原 189 行是唯一生产声明;其余全是合成测试 fixture(settings-service.test.ts 网格块、envelope.conformance.test.ts 的 stepped 命名空间)。
• 其它 schema 族(不同校验器,The data-field step (slider) is the settings step's unenforced twin — record-validator.ts reads min/max and never step #6514 的孪生领地,不归本卡):packages/spec/src/studio/flow-builder.zod.ts:274(画布 zoom)、packages/spec/src/data/field.test.ts:690(数据字段 step,The data-field step (slider) is the settings step's unenforced twin — record-validator.ts reads min/max and never step #6514)、packages/spec/src/ui/bulk-action.test.ts:63、packages/drivers/driver-sql/src/sql-driver-numeric-fidelity.test.ts:46。
• 备注:settings-service.ts:170 的注释仍以「ai.temperature declares step: 0.1」作历史例证——该文件 settings env 门不执行 pattern:写入门拒的形状非法值,OS_* 覆盖照收——#5204 不对称的最后一族 #6580 的开发者在编辑,按卡未触碰;注释系动机说明而非断言,留待后续顺手更新。

🤖 Generated with Claude Code

https://claude.ai/code/session_01USNUyHEr7uaU6MoEWXitei

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectstack	Ignored		Aug 8, 2026 7:39am

[github-actions]

📓 Docs Drift Check

This PR changes 1 package(s): @objectstack/service-settings.

7 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:

• content/docs/kernel/runtime-services/audit-service.mdx (via packages/services/service-settings)
• content/docs/kernel/runtime-services/index.mdx (via packages/services/service-settings)
• content/docs/kernel/runtime-services/settings-service.mdx (via packages/services/service-settings)
• content/docs/plugins/packages.mdx (via @objectstack/service-settings)
• content/docs/protocol/kernel/config-resolution.mdx (via @objectstack/service-settings)
• content/docs/releases/implementation-status.mdx (via @objectstack/service-settings)
• content/docs/releases/v9.mdx (via @objectstack/service-settings)

Advisory only. To re-verify, run the docs-accuracy-audit workflow scoped to these files:
node scripts/docs-audit/affected-docs.mjs origin/main → pass the list as args.docs.