性质
观察类(finding),不加 pm:queue:影响是一格空的文档单元格,没有运行时后果。单独立卡只为不让它随 #6827 关闭而丢失。
事实
packages/spec/src/kernel/execution-context.zod.ts:356:
preserveAudit: z.boolean().optional(),
语义完整地写在它上方 :326-355 的块注释里(UPDATE 侧白名单、系统列仍剥离、opt-in 且服务端构造),但块注释不进生成器,于是 content/docs/references/kernel/execution-context.mdx:69 的这一行是:
| **preserveAudit** | `boolean` | optional | |
—— 描述列为空。对照同族的 packages/spec/src/data/driver.zod.ts(DriverOptions.preserveAudit 有 .describe()),content/docs/references/data/driver.mdx:99 那一行就有描述。
为什么单独立卡,而不是并入 #6827
#6827(state-machine.mdx 的 create 半边旧说法)在正文里顺带记录了这一处,并把「是否合并处理」交给分诊。分诊评论的裁决是显式拆开:
the optional second half (adding a .describe() to ExecutionContextSchema.preserveAudit) is domain:spec-surface territory (text-only, acceptance byte-identical, triggers a docs regeneration ride) — if pursued, it should go through the spec-surface seat's sweep pipeline rather than riding this docs card; noted here so the split is a decision, not an accident.
PR #6880 按该裁决把它排除在 file surface 之外。#6827 关闭后这条记录就没有落脚点了,所以在这里存档。
修的时候要注意
#6640 的裁决(维护者 2026-08-08)之后,这条 .describe() 正好是写下收窄后契约的地方 —— 措辞应与已合入的两处保持一处口径:
即:豁免仅在 UPDATE 路径成立;INSERT 侧只认 context.isSystem,非 system 的 create 请求 preserveAudit 会被剥离并 WARN。
改动是 text-only、acceptance surface 逐字节不变,但会带动 check:docs 的整体重新生成(content/docs/references/kernel/execution-context.mdx 须随生成器一起更新)。
⛔ 不认领,仅记录。会话:session_01F8q5J1MQyocgtNspb15fSn
性质
观察类(
finding),不加pm:queue:影响是一格空的文档单元格,没有运行时后果。单独立卡只为不让它随 #6827 关闭而丢失。事实
packages/spec/src/kernel/execution-context.zod.ts:356:语义完整地写在它上方
:326-355的块注释里(UPDATE 侧白名单、系统列仍剥离、opt-in 且服务端构造),但块注释不进生成器,于是content/docs/references/kernel/execution-context.mdx:69的这一行是:—— 描述列为空。对照同族的
packages/spec/src/data/driver.zod.ts(DriverOptions.preserveAudit有.describe()),content/docs/references/data/driver.mdx:99那一行就有描述。为什么单独立卡,而不是并入 #6827
#6827(
state-machine.mdx的 create 半边旧说法)在正文里顺带记录了这一处,并把「是否合并处理」交给分诊。分诊评论的裁决是显式拆开:PR #6880 按该裁决把它排除在 file surface 之外。#6827 关闭后这条记录就没有落脚点了,所以在这里存档。
修的时候要注意
#6640 的裁决(维护者 2026-08-08)之后,这条
.describe()正好是写下收窄后契约的地方 —— 措辞应与已合入的两处保持一处口径:packages/spec/src/data/field.zod.ts的FieldSchema.readonly(PR fix(metadata-protocol,spec): preserveAudit is UPDATE-only — narrow the contract and warn loudly on a non-system INSERT (#6640) #6823 已改);content/docs/protocol/objectql/security.mdx:271的 callout(同一 PR)。即:豁免仅在 UPDATE 路径成立;INSERT 侧只认
context.isSystem,非 system 的 create 请求preserveAudit会被剥离并 WARN。改动是 text-only、acceptance surface 逐字节不变,但会带动
check:docs的整体重新生成(content/docs/references/kernel/execution-context.mdx须随生成器一起更新)。⛔ 不认领,仅记录。会话:
session_01F8q5J1MQyocgtNspb15fSn