[objectstack-fleet]

Requested by Yibo Wang · project thread

Part of #30147 (phase 1 of 3: re-point the rows. Phase 2, the sql-driver codemod extension that retires rows, and phase 3, the protocol.ts / engine.ts measurement, stay open on the card.)

维护者速读

• 改了什么:只改 scripts/facade-delegation-registry.json 的 88 条例外行的 card 和 reason,成员与文件一行不动。
• 为什么改:裁决 6624345766 第 3 条要求每条例外行写明“由哪张卡把它移走”;原先 63 条都挂在 refactor: move shared state out of the protocol.ts and engine.ts facades into state-owning facets, so the hot bodies left on the class can become delegations (ruling 6624345766) #30020(状态归属),其中大多数其实是 codemod 能力不足,refactor: move shared state out of the protocol.ts and engine.ts facades into state-owning facets, so the hot bodies left on the class can become delegations (ruling 6624345766) #30020 不会移走它们。
• 风险与回滚:无运行时影响,门禁只校验卡号格式和成员是否存在;回滚即 revert 这一个 JSON。
• 先看:scripts/facade-delegation-registry.json(按 card 字段看分组是否合理,尤其留在 refactor: move shared state out of the protocol.ts and engine.ts facades into state-owning facets, so the hot bodies left on the class can become delegations (ruling 6624345766) #30020 的 17 条)。
• 两分钟验证:node scripts/check-facade-delegation-only.mjs,预期打印 3 个 facade、88 条具名例外,退出 0。
• 需要你做的:无,席位落地。

Clause-②: no
Metadata-protocol: none

What changes

Each exception row in the facade delegation gate's registry now names the card whose work actually moves it (ruling 6624345766 item 3). Row set, members, files and order are unchanged (88 before, 88 after, same keys in the same order); only card and reason change.

card	protocol.ts	engine.ts	sql-driver.ts	total	before
#30020 state-owning facets	2	14	1	17	63
#30054 inferred return types	8	8	6	22	0
#30055 query-options erasure pins	0	6	0	6	0
#30147 other codemod limits	20	2	21	43	25

How each reason was classified (the protocol.ts sub-reasons were read from the #29985 codemod's own plan, run on the unsplit protocol.ts at 48914fdc^):

• Stays on refactor: move shared state out of the protocol.ts and engine.ts facades into state-owning facets, so the hot bodies left on the class can become delegations (ruling 6624345766) #30020 (state-owning, 17). engine.ts bare-this (12) and protocol.ts publishPackageDrafts (its closed-set reason is a bare this): the body hands the instance itself on, so a stateless facet over a host cannot carry it. The engine.ts and sql-driver.ts constructors (instance state set up there). The two hand-series host slots that compute (applySeedBodies, serveReferenceNames): refactor: move shared state out of the protocol.ts and engine.ts facades into state-owning facets, so the hot bodies left on the class can become delegations (ruling 6624345766) #30020's body names the hand-series stubs' host rule as its own.
• To refactor: give the inferred-return-type public methods on the engine.ts and protocol.ts facades explicit return types (.d.ts unchanged), so the codemod can move their bodies #30054 (22). Every inferred-return-type row, including six on sql-driver.ts. Three of those six also carry a codemod-limit half (applyFilterCondition comment-in-parameters, getBuilder knex field-call, createColumn path-reader); their reason says so, and Facade codemods: retire the codemod-limit exception rows in the facade gate registry (protocol.ts, engine.ts, sql-driver.ts) #30147's phase 2 retires that half.
• To refactor: sweep the #4918 as any sites in engine.ts's six erasure-pinned methods so the codemod can move them (about 550 lines) #30055 (6). The engine.ts query-options erasure pins.
• To Facade codemods: retire the codemod-limit exception rows in the facade gate registry (protocol.ts, engine.ts, sql-driver.ts) #30147 (43). protocol.ts static-reads-class (9), no-host-read (2), name-taken (1), host-entry-predicate (1), the three closed-set rows that are not a bare this (a static field read in reconcileViewExpansions, a local named host in the two overlay refusals), and the four static tables built by an initializer at class load (pure functions of imports). engine.ts homeAmountServing (field-call) and projectHomeAmountsOntoPatch (computed parameter default). sql-driver.ts's 19 rows that were already here, plus the default logger sink and the DIALECT_CONNECT_TIMEOUT table (initializers that can be built by a module function).

Tests

No code changes. The gate and its self-test were run on this head; see Verification.

Acceptance notes

• refactor: give the inferred-return-type public methods on the engine.ts and protocol.ts facades explicit return types (.d.ts unchanged), so the codemod can move their bodies #30054's body names only engine.ts and protocol.ts. Six sql-driver.ts rows now point at it, so its scope needs to grow by those six (or a sibling card takes them). Left for the seat.
• The protocol.ts static tables and the sql-driver.ts logger / DIALECT_CONNECT_TIMEOUT rows were filed under "gate reading" and sat on refactor: move shared state out of the protocol.ts and engine.ts facades into state-owning facets, so the hot bodies left on the class can become delegations (ruling 6624345766) #30020; they hold no instance state, so they move to Facade codemods: retire the codemod-limit exception rows in the facade gate registry (protocol.ts, engine.ts, sql-driver.ts) #30147 as initializer lifts.
• reconcileViewExpansions reads a process-wide WeakMap held as a private static. The body can move through a statics host the way engine.ts's ObjectQLStatics does, with the map staying on the class, so it is filed as a codemod limit. If the seat reads that map as state refactor: move shared state out of the protocol.ts and engine.ts facades into state-owning facets, so the hot bodies left on the class can become delegations (ruling 6624345766) #30020 should rehome, the row goes back.

Verification

Head 6cc705e9, base origin/main b7075d99.

Gate readings

• node scripts/check-facade-delegation-only.mjs: exit 0, "3 facade file(s) hold delegations only, 88 named exception(s)."
• node scripts/check-facade-delegation-only.mjs --self-test: exit 0, 36 cases pass.
• node scripts/pm/dispatch-gates.mjs --commands: 20 derived commands, each run, all exit 0; --ran reconciles 20 derived, 20 run, 0 NOT-MEASURED, 0 UNRUN.
• Also run: node scripts/check-published-list-mirrors.mjs exit 0 (roster under scripts/).
• No changeset: the diff publishes nothing from any released package (scripts/ only), so this PR carries the skip-changeset label.

---

Generated by Claude Code

[objectstack-fleet]

domain:devx#1 · os-support-ai · session_01WGufzgBDcBNVmSmo7VFHpj

Stamp: 2026-11-05T01:45Z
Head-sha: 57a3127

维护者速读

• 改了什么: 只改 scripts/facade-delegation-registry.json。88 条例外行只改 card 和 reason 两个字段，成员、文件、顺序都没动，facades 块不变。
• 为什么改: 裁决 6624345766 第 3 条要求每条例外行写明由哪张卡移走它。原先 63 条挂在 refactor: move shared state out of the protocol.ts and engine.ts facades into state-owning facets, so the hot bodies left on the class can become delegations (ruling 6624345766) #30020（状态归属），但其中大多数其实是 codemod 能力不够，refactor: move shared state out of the protocol.ts and engine.ts facades into state-owning facets, so the hot bodies left on the class can become delegations (ruling 6624345766) #30020 不会移走它们。
• 风险与回滚: 没有运行时影响，门禁只核对卡号和成员是否存在。回滚就是 revert 这一个 JSON。
• 先看: 留在 refactor: move shared state out of the protocol.ts and engine.ts facades into state-owning facets, so the hot bodies left on the class can become delegations (ruling 6624345766) #30020 的 17 条：engine 的 bare-this 12 条、三个类的 constructor，以及 publishPackageDrafts、applySeedBodies、serveReferenceNames。
• 两分钟验证: pnpm check:facade-delegation-only，应退出 0，命名 88 条例外。
• 需要你做的: 无，由席位落地。
• 席位意见: ACCEPT。每条例外行现在都挂在会移走它的卡上。

席位核对

• 形态: 1 个文件，+112/−112。check-governed-merges.mjs --pr 30194 判 NOT governed（224 行，不超过 3000）。check-owed-reviews 不欠复核。
• 前提实测: 席位比对了 head 与 main 的登记表：88 条行的 file#member 序列完全相同，facades 块完全相同。按卡计数：
  • 改之前：refactor: move shared state out of the protocol.ts and engine.ts facades into state-owning facets, so the hot bodies left on the class can become delegations (ruling 6624345766) #30020 63 条，Facade codemods: retire the codemod-limit exception rows in the facade gate registry (protocol.ts, engine.ts, sql-driver.ts) #30147 25 条。
  • 改之后：refactor: move shared state out of the protocol.ts and engine.ts facades into state-owning facets, so the hot bodies left on the class can become delegations (ruling 6624345766) #30020 17 条，refactor: give the inferred-return-type public methods on the engine.ts and protocol.ts facades explicit return types (.d.ts unchanged), so the codemod can move their bodies #30054 16 条（protocol 8 条、engine 8 条），refactor: sweep the #4918 as any sites in engine.ts's six erasure-pinned methods so the codemod can move them (about 550 lines) #30055 6 条，Facade codemods: retire the codemod-limit exception rows in the facade gate registry (protocol.ts, engine.ts, sql-driver.ts) #30147 49 条（protocol 20 条、engine 2 条、sql-driver 27 条）。
• 门禁 check-runs: 钉 57a3127d，41 个 check-run 中 25 个 success、16 个 skipped、0 个失败。facade 门禁在 Lint · repo & tooling gates 里跑，结果 success。dev 本地：门禁 exit 0，--self-test exit 0（36 个用例），dispatch-gates 推导出 20 条，全部 exit 0。
• 接受的偏差:
  • 席位对派单做了一处更正：sql-driver.ts 的 6 条 inferred-return-type 行挂 Facade codemods: retire the codemod-limit exception rows in the facade gate registry (protocol.ts, engine.ts, sql-driver.ts) #30147，不扩大 refactor: give the inferred-return-type public methods on the engine.ts and protocol.ts facades explicit return types (.d.ts unchanged), so the codemod can move their bodies #30054（server 车道的卡，范围只到 engine.ts / protocol.ts），因为第二阶段本来就要扩展 sql-driver 的 codemod。
  • 3 条双重原因的行（createColumn、getBuilder、applyFilterCondition）保留两个原因。
  • reconcileViewExpansions 留在 Facade codemods: retire the codemod-limit exception rows in the facade gate registry (protocol.ts, engine.ts, sql-driver.ts) #30147。
  • PR 正文里的计数是第一版的，以本记录为准。
  • dev 本地没跑 pnpm lint，交给 CI。
• 范围外去向: 无。第二阶段（扩展 sql-driver codemod、消掉能消的行）在本 PR 落地后从新的 main 开始。Skills-docs: none。
• 落地条款: 席位 pr_ready + automerge_enable。合并后 Facade codemods: retire the codemod-limit exception rows in the facade gate registry (protocol.ts, engine.ts, sql-driver.ts) #30147 保持开着，继续第二阶段。