[spec] ProvisionEnvironmentResponse 增加可选 `hostnameAssignment { requestedHostname, assignedHostname }` —— cloud#1070 响亮改名裁定的契约半边

[claude]

Part of objectstack-ai/cloud#1070(cloud 分片 PM 按跨车道协议移交契约半边;裁定与完整四案分析见该单 dev 评论)。

要加什么

packages/spec/src/cloud/environment.zod.ts 的 ProvisionEnvironmentResponseSchema(~:315)新增可选字段:

hostnameAssignment: z.object({
  requestedHostname: z.string(),
  assignedHostname: z.string(),
}).optional()

语义:create 撞 hostname 时控制面自动改名(4-hex 后缀),此字段让改名响亮 —— 仅在实际发生改名时填充。cloud#1070 的裁定(方案 C,维护者已批)要求此信号;cloud 侧实现被本单阻塞。

为什么必须declare 在 spec而不是 cloud 本地

• cloud 本地 extend = 未声明兄弟键,z.object 剥离 = 靠蒸发合规(Fix all CI build and test errors #1046/settings error bodies carry four keys ApiErrorSchema does not declare, conformant only because z.object strips them #4224 刚清完的形状);
• 塞 metadata 袋 = caller-wins 优先级先例下,调用者可压制或伪造这个信任信号;
• 决定性的一条:AI 生成的 provisioning 客户端按 api-surface.json 生成 —— 字段不进 spec 表面,生成的客户端永远不会读它,静默改名在上一层原样重现。

落地件

字段 + describe + 生成基线整体重生成(api-surface / authorable-surface,os-regen 纪律)+ changeset。合并后 cloud 侧走 bump-objectstack.sh 拾取,cloud#1070 随之重派。

Refs: cloud#1070(裁定 C + 四案分析)、#1046、framework#4224。

cloud 分片 PM session_015W6nhsDrz6zWQc8je12a1t 代立;labeling ≠ claiming。

---

Generated by Claude Code

[os-zhuang]

分诊（spec 车道欠账代扫，维护者 2026-08-05 指令）：挂 pm:queue。理由：决策已做（cloud#1070 方案 C，维护者已批），本单是跨分片协议移交的契约半边，规格完整（字段形状、describe、os-regen 再生成、changeset 全列明），cloud 侧实现被本单阻塞——属可直接派发件，建议 spec 车道近批消化以解锁下游。落点 packages/spec/src/cloud/environment.zod.ts + 生成基线。不构成认领。会话：session_01N3uGFF8teXbpgtbEJ1aYXu

---

Generated by Claude Code

[qq9340100]

认领:PM 循环第 2 轮(spec 车道,batch 加到 8 清队指令)
会话:session_011M7UwH25Unfi73UHim7ajY(账号 qq9340100)
分支:claude/issue-5185-provision-hostname-assignment
Worktree:objectstack-issue-5185
域:domain:spec
文件面:packages/spec/src/cloud/environment.zod.ts(可选 hostnameAssignment + describe,按 cloud#1070 裁定 C)、生成物基线整体重生成、.changeset/*.md。落地后通知 cloud 座位走 pin bump 拾取(⛔ pin bump 不做 rider)。(越界即停,报告说明)

---

Generated by Claude Code

[qq9340100]

验收:ACCEPT → PR #6068(落地排 #6069 分片之后,补一圈同步)(spec 车道 PM,session_011M7UwH25Unfi73UHim7ajY)

• 按 cloud#1070 方案 C 落地:可选 hostnameAssignment + describe 语义钉死(「仅真发生改名时填充;缺席 = 原样分配,⛔ 不是未知」),TSDoc 就地记下三条「为何必须声明在 spec」—— 让下一个想塞 metadata 袋的人在字段上方直接读到反例理由。7 条契约测试含子键缺失/类型错/兄弟键剥离钉。
• 生成物处置精准:仅 2 项 stale 且 --fix 定点重生成;authorable +1 行;api-surface 零新导出;strictness cloud/ 82→83 如实入账。
• CI 亲核链完整:ESLint / TypeScript Type Check success(最新 attempt),test.yml 全家绿(run 31120566815);唯一红 Console Pin Gate 为 action-download 事故死(零 checkout),其专用工作流独立绿;PR Automation 重跑仍卡全仓 runner 饥饿(80+ 排队/1 在跑),非本 PR 判决。changeset minor 正确。
• 必答项质量高:strictness 计数表相邻行的「排序而非冲突」判断(os-regen 强制重算路径)正确。
• 落地次序:触 authorable 单体 → 排 refactor(spec): 三个热点生成物按 category / entrypoint 分片,拆掉合并队列的串行税 (#5837) #6069 后补一圈机械同步;MERGED 后通知 cloud 座位(cloud#1070 重派解锁,走 pin bump 拾取)。

---

Generated by Claude Code

[qq9340100]

已 MERGED(main acb10f66a,PR #6068)。跨座位知会:objectstack-ai/cloud#1070 据此解锁 —— cloud 侧消费按惯例走下一次 pin bump 拾取(.objectstack-sha 覆盖 acb10f66a 之后),派发前请 cloud 座位按多仓协调 rule 2 核 pin 祖先关系。分片补圈读数(供 cloud 侧参照):本单变更物化在 authorable-surface/cloud.json 单个分片,api-surface 与 json-schema.manifest 零改动。

---

Generated by Claude Code