[objectstack-fleet]

Requested by Bill · project thread

Fixes #30367
Refs #30053

Clause-②: no
Metadata-protocol: none

维护者速读

• 改了什么：packages/spec/liveness/query.json 里 searchFields 一行的证据第一段从 engine.ts#expandSearchOnAst 改指 engine-find.ts#expandSearchOnAst，note 补一句为什么改；加一个 @objectstack/spec patch changeset（liveness 目录随包发布）。
• 为什么改：refactor(objectql): move 36 hand-series private docblocks out of engine.ts with the codemod's third pass (slice 1 of 2) #30341（refactor: move the private docblocks of the hand-series stubs into their hand modules — about 1,900 lines off engine.ts (86 stubs) and about 4,000 off protocol.ts (157 stubs) #30053 第一片）把 engine.ts 里最后一处提到 searchFields 的私有 docblock 搬进了手写模块，check:liveness 要求被引文件提到键名，于是 main 红了（Spec Liveness Check 不是必需检查，所以 refactor(objectql): move 36 hand-series private docblocks out of engine.ts with the codemod's third pass (slice 1 of 2) #30341 照样合并了；Lint UI 会跑它）。函数体从 codemod 拆分起就在 engine-find.ts，那里提到 searchFields。没有在 engine.ts 里硬加一处提及。
• 风险与回滚：只改台账证据文本，无运行时改动；回滚就是 revert。
• 两分钟验证：pnpm --filter @objectstack/spec check:liveness，退出码 0。

What changes

• packages/spec/liveness/query.json, row query.searchFields: the evidence's first leg cites packages/objectql/src/engine-find.ts#expandSearchOnAst (was engine.ts#expandSearchOnAst). The note gains one sentence dated 2026-11-05 on why. The other two legs are unchanged.
• .changeset/30053-liveness-search-fields-repoint.md: patch on @objectstack/spec, because liveness/ ships in the package's files.

Why

check:liveness requires every cited file to name the property it is evidence for. On main f672e0dc it fails: query/searchFields → packages/objectql/src/engine.ts. The first slice of the hand-series docblock move (#30341) moved the private docblock that named $searchFields out of engine.ts, and nothing else there names the key. The hand-off the row describes has lived in engine-find.ts (FindFacet.expandSearchOnAst) since the engine.ts codemod split, and that file names searchFields.

Verification

• Reproduced first: pnpm --filter @objectstack/spec check:liveness on the refactor(objectql): move 36 hand-series private docblocks out of engine.ts with the codemod's third pass (slice 1 of 2) #30341 head exits 1 with exactly that one citation.
• On this head: exit 0, 0 failures. That run covers every ledger (field.json included): no other row cites a file that no longer names its key.
• The diff against main is these 2 files (+13 / −2). The branch is the designated thread branch, which carried refactor(objectql): move 36 hand-series private docblocks out of engine.ts with the codemod's third pass (slice 1 of 2) #30341; main is merged in, so no earlier commit's content is in the diff.
• Gates: dispatch-gates --commands derives 55 for this diff; 43 had run when this PR opened, all exit 0. The rest go to the seat with the hand-back.

Human Minimum

• 1. Schemas start as Zod; packages/spec holds no runtime logic. (a ledger row only)
• 2. Every name I added uses the casing for its kind.
• 3. No formatter ran.
• 4. One issue, one branch off an up-to-date main, one pull request. (the designated thread branch with main merged in)
• 5. A change that publishes carries a changeset, and both declaration lines are filled in here and in the changeset.
• 6. packages/spec touched: its generated artifacts are regenerated and committed. (a liveness row; nothing generated reads it)
• 7. No hand edits to content/docs/references/, packages/*/CHANGELOG.md or content/docs/releases/.
• 8. Title, body and comments are in English.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Utp6CYHBS7P5hkUQrNHkHZ

[github-actions]

📓 Docs Drift Check

⚠️ 1 changed file(s) yielded no anchor (packages/spec/liveness/query.json), so the pages documenting them are NOT COVERED by this run — this is not a clean bill of health for those files. Nothing else in this diff resolved to a documentable surface (no symbol, route or SDK anchor derived from 1 changed package(s)).

What this run could not see

• 1 changed file(s) yielded no anchor (packages/spec/liveness/query.json) — pages documenting those are invisible to this run
• a page that states a rule by its inputs shares no identifier with the emitter that implements the rule, so an emitter-only diff cannot list it — not on this run and not on any run. Measured on fix(driver-sql): emit varchar(maxLength) for a text field a declared index keys on #11430: content/docs/protocol/objectql/types.mdx documents the text-family column mapping by the ObjectQL type names it maps FROM (text / textarea / html) while the diff changed createColumn; it went unlisted, and it was the page that diff falsified, in four places. No shared token exists to detect this on, so a rule your change carries has to be re-read by hand in the pages that restate it.
• a key NAME is not a key, so the hand re-read the line above prescribes can land on the wrong schema. The same spelling is authorable on one governed type and a [REMOVED] tombstone on another for each of active, aria, joins, objects, template, tools and version (censused on [finding] tools is a key on BOTH AgentSchema (tombstoned, dead) and SkillSchema (live, cloud-attested), so a name-based search attributes skill examples to the agent key — it produced a false stop-the-line alarm on PR #19059 #19093 over the liveness ledger's governed types, top-level keys); nothing in a search result distinguishes the two, so a grep hit on a LIVE example reads as evidence about the DEAD key. Measured on fix(spec): the agent.tools liveness row says dead — it claimed live on a key the schema tombstoned #19059: content/docs/ai/agents.mdx was reported as contradicting the agent.tools tombstone over its tools: example at :161, which is inside the defineSkill({ block opened at :155 — the page was already correct. Settle ownership by PARSING the value against both schemas, never by the name: that literal PASSES SkillSchema, and as an AgentSchema it FAILS at tools with the tombstone prescription. ⛔ These names are not the whole class — a key retired through a .strict() guidance map leaves no tombstone in the walked shape and none of them here (tool.category, live as AIToolDefinition.category).

Coarse fallback — 170 page(s) merely mention a changed package (the pre-#9192 predicate, kept for the deliberately-wide backstop): node scripts/docs-audit/affected-docs.mjs --json fdad1786e892270ac3fcc161b3fd4d57c9c47748 → packageMentionDocs.

[objectstack-fleet]

domain:server#3 · os-bill · session_01Utp6CbPxYq1wQmUNWvMZkC

Guard note · 2026-11-05T08:13Z

• PR-body guards (run 41992496777) failed check:closing-target-claim: main red: spec check:liveness — query/searchFields cites engine.ts, which no longer mentions searchFields after #30341 #30367 is the main-red anchor card the seat filed minutes before this PR opened, and it carried no Claim: yet. Not a defect of this PR's diff or body.
• Fixed at the source: the seat posted the claim on main red: spec check:liveness — query/searchFields cites engine.ts, which no longer mentions searchFields after #30341 #30367 naming claude/project-thread-7wiz8y (comment 6653087744). Re-running the failed job once to read the guard against it.

[objectstack-fleet]

domain:server#3 · os-bill · session_01Utp6CbPxYq1wQmUNWvMZkC

席位核对

ACCEPT · head a53e8a8eb1c58168109d9afb16ba0ca4f2ef8ca9 · main-red card #30367 (claim 6653087744), Refs #30053 · 2026-11-05T08:47Z

• Shape: draft PR to main, author objectstack-fleet[bot] (relay), attribution block then Fixes #30367 and Refs #30053. 2 files, +13 −2 against main. check-governed-merges.mjs --pr 30368: NOT governed, 15 changed lines ⇒ ordinary queue landing. Head is the dev's fix 078b4d5c plus a seat-relayed pr_update_branch merge of main (to re-read PR-body guards after the claim was posted, note 6653099160).
• Declarations: Clause-②: no, Metadata-protocol: none; changeset @objectstack/spec patch (liveness/ ships in the package's files). Neither widening nor narrowing ⇒ the seat's own review of record.
• Seat review: the query.searchFields row's first evidence leg moves from engine.ts#expandSearchOnAst to engine-find.ts#expandSearchOnAst, where the body lives and which names searchFields; the claim text, the second leg (search-filter.ts#resolveSearchFields) and the proofs are unchanged; the note gains a dated REPOINTED line. Dev reproduced check:liveness exit 1 on refactor(objectql): move 36 hand-series private docblocks out of engine.ts with the codemod's third pass (slice 1 of 2) #30341's head (this row only) and exit 0 on the fix, over every ledger (no other row cites a file that lost its key).
• Gates (check-runs on this head): 64 runs, 55 success, 9 skipped, 0 failed; Test Core (incl. spec check-liveness.test.ts), Lint & Repo Gates, Lint UI, PR-body guards green. Dev's derived gates 55/55 exit 0 at 078b4d5c.
• Landing: ready + auto-merge by the seat. This clears the main-red; refactor: move the private docblocks of the hand-series stubs into their hand modules — about 1,900 lines off engine.ts (86 stubs) and about 4,000 off protocol.ts (157 stubs) #30053 slice 2 opens after it.