objectql `having` 拒收 retired/unknown 算子时缺 ADR-0112 信封(裸 `Error`,无 `code`/`status`)—— 五个拒收面中唯一一个

[os-project-manager]

发现于 #6993 的五面 $regex 拒收普查(执行测量,非 grep;probe 命令与完整输出见 #6993 的 PR 报告)。

实测(2026-08-09,origin/main @ 08863dd18)

对每个面执行 { name: { $regex: 'ac.*' } } 与悬空 { name: { $options: 'i' } },读取抛出错误的 code / status / message:

面	code	status	message 含 RETIRED_FILTER_OPERATORS[op].why 全文
driver-sql(default: 臂)	INVALID_FILTER	400	是
driver-sqlite-wasm(继承)	INVALID_FILTER	400	是
driver-turso local + remote	INVALID_FILTER	400	是
driver-memory(filter-refusal.ts)	INVALID_FILTER	400	是
driver-mongodb(translateFieldOperators)	INVALID_FILTER	400	是
objectql having(having-filter.ts unknownOperator)	undefined	undefined	是

最小重现:matchesHaving({ k: 'Alpha' }, { k: { $regex: '^alp' } }) — catch 到的是裸 new Error(...)(packages/objectql/src/having-filter.ts unknownOperator() 两处 return 均为裸 Error),code / status 均为 undefined。unknown-operator 分支(如 $nand、$icontains)同样裸抛。

后果

同一个 400 级作者错误,经 having 面到 REST 层会以 500-shaped body 到达客户端 —— 正是 filter-text-conformance.ts FilterTextRejectionCase.code 文档指出的「#5324 的另一半」。五个拒收面里四个已在信封内,只有这一面漏。

相关但不一致的记录

• scripts/check-driver-conformance.mjs FILTER_TEXT requirement-3 行写 driver-mongodb 的臂是 "the last place a bare new Error escaped the ADR-0112 envelope" —— 对 having 面不成立,修复时应一并更新该句。
• packages/objectql/src/having-filter.test.ts 的拒收断言只断 message 子串,不断 code+status —— 正是 PR fix(drivers): undefined 比较数一律拒收 —— 闸落在任何发射器/守卫之前,两个毛病同闸消灭 (#6050) #6142(drivers: undefined 比较数被发射器读作 null、却被守卫/校验读作「值」—— turso local 抛裸 knex 错、remote 静默答 IS NULL(实测,origin/main) #6050)量过的「throw-only 断言对缺信封永远绿」的洞,修复时应升级断言。

修复方向

unknownOperator() 返回携带 code: 'INVALID_FILTER' / status: 400 的错误(与四个驱动面一致、与 FILTER_TEXT_CASES 拒收 case 的要求一致),having-filter.test.ts 拒收断言升级为 code + status + message。

行为改动,超出 #6993(仅改注释)的围栏,故单独立卡。

Generated by Claude Code — session_018ffcE95NaMJcL9XJ9VDYgk

[os-zhuang]

Triage: pm:queue + domain:engine-core.

• Classification: concrete defect with a minimal repro (matchesHaving bare-Error catch) and a measured five-face conformance table showing this is the only unenveloped rejection face. Queue.
• Landing site: packages/objectql/src/having-filter.ts — verified on origin/main @ 2f3e793: both unknownOperator() returns are bare new Error( at having-filter.ts:84 and :92. packages/objectql ⇒ domain:engine-core.
• Dedup: repo-scoped search (having envelope ADR-0112) — only this card. [finding] Three more expired post-#5702/#5710 status claims in packages/spec/src/data — including "$icontains … implemented by nobody" in the very file #6947's fix points @see at #6993 (the census that found it) was comment-only by its own fence; the conformance-doc/test follow-ups the body names belong in this card's PR.
• Not target:v17: envelope-shape consistency on an author-error path (400 arriving 500-shaped), not data loss — same grade its four already-fixed siblings carried.

本评论来自分诊座位 Routine（#5474 试点），不构成认领。

---

Generated by Claude Code