Part of #5613
维护者已裁 #5613 走「C 骨架 + A 语义」;第一阶段 #5697 /PR #5721 已落地(ActionSessionSchema @ packages/spec/src/ui/action-params.zod.ts:206,按现状声明,roles 标 deprecated)。第二阶段(更名 roles → positions)的 spec 半边 依 schema 自己的 docstring 约定(「do NOT add a positions key here ahead of it —— The rename is #5613 phase 2」)必须动 packages/spec,按「shared contract surfaces have one owner」转 spec 座位执行(domain:* 标签待分诊座位补;cli 车道 PM 立单)。
范围(仅 spec 半边)
ActionSessionSchema 增补 positions: z.array(z.string()).optional() 为权威键 (describe 指向 ADR-0090 D3 / ExecutionContext.positions,并沿用现 roles docstring 里「Never gate PRIVILEGE on this array」的告诫);roles 保留为弃用别名对 (弃用窗口内 runtime 双发同值;describe 改写为「deprecated alias of positions,迁移见 ADR-0087 条目,移除走 Unify the developer-facing org identifier: hooks expose session.tenantId while RLS/seed/columns use organizationId (add organizationId as the blessed name) #3280 Remove the deprecated hook/action ctx.session.tenantId alias in the next major (converge on organizationId) #3290 session.tenantId 别名下线的既有先例路径」);ADR-0087 语义迁移条目 :roles → positions(action-body ctx.session 面),写明双发窗口与后续移除条件;生成物整体重生成(os-regen 八路径纪律,spec 车道串行接力照常)。
明确不做(runtime 半边,#5613 本单在 cli 车道)
buildActionSession() 双发改造 + 两句错注释修正 + 翻转 packages/runtime/src/action-session-shape-contract.test.ts 的键集断言 + changeset(major)+ 文档 —— 由 cli 车道在本单落地后执行;#5613 已挂 Blocked-by: 本单。
验收
schema 双键并存且语义标注方向正确(positions 权威、roles 弃用别名),z.infer 类型面允许 runtime 双发不破 tsc;
ADR-0087 条目在;生成物与兄弟单条目断言(spec 接力纪律)通过;
⛔ 不动 packages/runtime 任何文件(flip anchor 由 runtime 半边翻)。
关联:#5613 (裁决锚点 00:55Z 评论 + 解锁 02:42Z 评论)、#5697 /PR #5721 (第一阶段)、ADR-0090 D3、ADR-0087、#3290 (别名下线先例)。
Part of #5613
维护者已裁 #5613 走「C 骨架 + A 语义」;第一阶段 #5697/PR #5721 已落地(
ActionSessionSchema@packages/spec/src/ui/action-params.zod.ts:206,按现状声明,roles标 deprecated)。第二阶段(更名roles → positions)的 spec 半边依 schema 自己的 docstring 约定(「do NOT add apositionskey here ahead of it —— The rename is #5613 phase 2」)必须动packages/spec,按「shared contract surfaces have one owner」转 spec 座位执行(domain:*标签待分诊座位补;cli 车道 PM 立单)。范围(仅 spec 半边)
ActionSessionSchema增补positions: z.array(z.string()).optional()为权威键(describe 指向 ADR-0090 D3 /ExecutionContext.positions,并沿用现rolesdocstring 里「Never gate PRIVILEGE on this array」的告诫);roles保留为弃用别名对(弃用窗口内 runtime 双发同值;describe 改写为「deprecated alias ofpositions,迁移见 ADR-0087 条目,移除走 Unify the developer-facing org identifier: hooks exposesession.tenantIdwhile RLS/seed/columns useorganizationId(addorganizationIdas the blessed name) #3280→Remove the deprecated hook/actionctx.session.tenantIdalias in the next major (converge onorganizationId) #3290session.tenantId别名下线的既有先例路径」);roles → positions(action-body ctx.session 面),写明双发窗口与后续移除条件;明确不做(runtime 半边,#5613 本单在 cli 车道)
buildActionSession()双发改造 + 两句错注释修正 + 翻转packages/runtime/src/action-session-shape-contract.test.ts的键集断言 + changeset(major)+ 文档 —— 由 cli 车道在本单落地后执行;#5613 已挂Blocked-by:本单。验收
positions权威、roles弃用别名),z.infer类型面允许 runtime 双发不破 tsc;packages/runtime任何文件(flip anchor 由 runtime 半边翻)。关联:#5613(裁决锚点 00:55Z 评论 + 解锁 02:42Z 评论)、#5697/PR #5721(第一阶段)、ADR-0090 D3、ADR-0087、#3290(别名下线先例)。