[17.x] 批量写按行语义实现:hook 按行触发 + record-change trigger 按行绑定 previous/record(#4800/#4862 拍板 A)

[claude]

维护者 2026-08-04 拍板(见 #4800 / #4862 裁定评论):批量写上 after 型 hook 与 record-change flow trigger 按行求值、按行触发是平台契约。本单是 17.x 的实现单,一次设计覆盖两面:

• hook:一次批量写触发 N 次(需定 ctx.result 形状:整批 vs 单行)、匹配行集一次性读取(复用 validation 侧 Validation rules, requiredWhen and option visibleWhen are silently skipped on multi-row updates (options.multi) #3106 的逐行取数形状);
• flow trigger(record-change flow trigger 在 predicate 批量写上:previous 不绑定、record 只是裸 payload —— 官方文档与 showcase 正在教的 transition 起始条件在批量写上不成立 #4862 的全部事实照单):previous 按行绑定、record 为该行实际状态而非裸 payload;
• showcase 受影响的 10 条 transition flow 作端到端验证面;
• 性能护栏:行集读取一次完成,求值批内复用;
• 文档与 formula skill 的 transition 写法口径随之收口。

Blocked-by: #5037(rc 止血单)
Blocked-by: #4800(ADR 补遗随止血单落地)

关联:#4862(trigger 侧事实与影响面)、#3106(validation 先例)、#4775/#4861(fail-loud 先例)。

---

Generated by Claude Code

[os-zhuang]

认领:PM 循环第 1 轮(维护者本日加急,p0)
会话:session_01Pbu27iNUfQCHeuS551Rqo7
分支:claude/issue-5038-bulk-write-per-row-semantics
Worktree:objectstack-issue-5038
域:domain:engine + domain:services(跨域单一认领,文件面全列)
文件面:packages/objectql/src/engine.ts(批量分支)、packages/objectql/src/hook-wrappers.ts、packages/services/service-automation/src/engine.ts / plugin.ts(record-change trigger 绑定)、examples/app-showcase/src/automation/flows/**(端到端验证面)、content/docs/data-modeling/formulas.mdx + skills/objectstack-formula/SKILL.md(口径收口,跨入 devx 文档面,已声明)、测试 + changeset(越界即停,报告说明)

Blocked-by 核验(对 GitHub 实况):#5037 已关(completed),止血 + ADR 补遗随 PR #5057 落 main(commit 4335497);#4800 的阻塞语义(ADR 补遗随止血单落地)已实质满足,该卡保持开启为设计孵化点,由本单交付后关闭。⚠️ 与 #4619(engine.ts transaction 段)同文件,后者已退回下轮串行。

---

Generated by Claude Code