docs(kernel): re-quote QueryOptionsV2's JSDoc after #7003's convergence edit

[os-project-manager]

Fixes #7002

缺陷

PR #7003（#6795）修改了 packages/client/src/index.ts 里 QueryOptionsV2 的 JSDoc：它不再自称
"the recommended interface for data.find() queries"（这与 find() 自身的
@deprecated 标签自相矛盾），新文案是：

This is the vocabulary data.find() still accepts — find itself carries
@deprecated; new code should call data.query() instead.

content/docs/kernel/runtime-services/data-service.mdx 在两处逐字引用了旧句子并注明出处
（"Canonical source"）：

• ### Two list entries, one preference 小节（原第 60 行）
• ### \find` options: canonical and legacy` 小节（原第 101 行）

#7003 落地后，这两处引用不再与源文件逐字一致 —— 与 #6925（searchable-fields 提示语）是同一类缺陷，只是换了一对文件。

修复

• 两处引用都改为当前 main 上 packages/client/src/index.ts 的实际 JSDoc 文本
  （the vocabulary \data.find()` still accepts`），已用脚本做字节级比对（见下）。
• 两处引用周围的行文本身也在用自己的话暗示"推荐"（names ... for callers that stay on it /
  declares which of the two to write），一并改写为中性描述，避免"引用改对了、结论仍旧过时"的
  半修复。第二处结尾的 "so the recommendation is the SDK's own" 保持不动 —— 它指向的是
  QueryOptions 自身未变的 @deprecated 标签里 "Prefer QueryAST fields directly" 的指示，
  这个建议依然成立。
• packages/client 本身未做任何改动（源文件在 fix(client): QueryOptionsV2 no longer calls itself the recommended interface for deprecated data.find() #7003 合并后已经是正确的）。

排查范围

• 全仓库 grep content/docs/** 与 skills/** 中 "recommended interface" / QueryOptionsV2：
  只有这一个文件的两处命中，未发现其他同类过期引用。
• .changeset/query-options-v2-not-a-recommendation.md（fix(client): QueryOptionsV2 no longer calls itself the recommended interface for deprecated data.find() #7003 自带的 changeset）里也出现了旧句子，
  但那是对"修了什么"的过去式历史记录（changelog），本身仍然正确，不属于本 issue 范围，未改动。

验证

文档类改动本仓库没有测试断言，按要求做字节级比对而非人工目测（脚本见 PR 描述末尾），并跑了仓库的文档
门禁：

$ pnpm check:doc-authoring
✓ check-doc-authoring self-test: ... all hold.
✓ doc authoring guard: 374 files clean — no bare metadata literals.

$ pnpm check:docs-audit-scope
✓ affected-docs self-test: 56 cases pass.
✓ check-audit-scope self-test: 22 cases pass.
✓ docs-accuracy-audit scope is in sync with content/docs/: 179 hand-written doc(s).
✓ release-owned pages are in scope and read-only: 9 page(s) under content/docs/releases/ review-only.

$ node scripts/check-nul-bytes.mjs
check-nul-bytes: OK (scanned 6517 tracked text file(s); ... no raw ASCII control bytes).

check-links（lychee）是本仓库对 content/docs/** 的 advisory 链接门禁；本次改动未触碰任何链接语法（仅改了两句引用文字），容器内没有 lychee 二进制可本地跑，留给 CI 的 advisory 通道。

边界

• 未改动 packages/client、docs/adr/**、content/docs/releases/**。
• content/docs/** 是 domain-boundary-contested 路径（域标签词表有两个未入表条目:domain:spec-tooling(在用,文件面与 devx 完全重叠)与 domain:ui(一例,与 repo:objectui 重复) #5469，尚无定论），本 PR 的 diff 刻意收得很紧
  ——只改了两处引用文本 + 其直接上下文的措辞，没有触及页面结构、标题或其余段落。
• 与并行开发的 @objectstack/verify's bootStack ignores an app's isDefault permission set, while the CLI honours it — after #5491 a dogfood app cannot test its own declared baseline #7001（packages/verify 的 bootStack / fallbackPermissionSet 缺陷）完全没有交集，
  已核对过其 issue 内容，两者路径不重叠。

变更集

纯文档改动，不影响任何运行时行为，判定为 skip-changeset（会在 PR 上手动打标签，并在打标签后回读确认）。

---

Byte-comparison script used (scratchpad, not committed):

// verify-quotes.mjs — asserts each doc fragment is an exact substring of the
// normalized QueryOptionsV2 JSDoc on this branch, and that the stale sentence
// is gone from both the doc and the source.

Output: ALL CHECKS PASSED.

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectstack	Ignored		Aug 9, 2026 1:02pm