From ebd13911861b98ea9004579874eff1f44f8f4de6 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 9 Aug 2026 13:01:39 +0000 Subject: [PATCH] docs(kernel): re-quote QueryOptionsV2's JSDoc after #7003's convergence edit MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fixes #7002 PR #7003 (#6795) reworded QueryOptionsV2's JSDoc in packages/client/src/index.ts: it no longer calls itself "the recommended interface for `data.find()` queries" — that self-description was a contradiction with `find()`'s own `@deprecated` tag. The new sentence reads "This is the vocabulary `data.find()` still accepts" and is explicitly not a recommendation. content/docs/kernel/runtime-services/data-service.mdx quoted the old sentence verbatim, attributed to that source, in two spots. Both are re-quoted from the current main JSDoc text, and in both spots the surrounding prose that editorialized on the old "recommended" framing is corrected alongside the quote — a corrected quote under an unfixed claim would still be a half-fix. No other content/docs/** or skills/** location quotes the stale sentence (grepped repo-wide). .changeset/query-options-v2-not-a-recommendation.md also contains the phrase, but only as a past-tense description of what #7003 fixed — that's a legitimate changelog record, not a stale live quote, and is left untouched. Claude-Session: https://claude.ai/code/session_01F8q5J1MQyocgtNspb15fSn Co-authored-by: Claude --- content/docs/kernel/runtime-services/data-service.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/kernel/runtime-services/data-service.mdx b/content/docs/kernel/runtime-services/data-service.mdx index 6e235acb8f..6fdff27be2 100644 --- a/content/docs/kernel/runtime-services/data-service.mdx +++ b/content/docs/kernel/runtime-services/data-service.mdx @@ -57,7 +57,7 @@ deprecate the legacy-parameter query entries, promote `data.query(AST)`). Deprecated means "prefer `query`", not "scheduled for removal in this version": `find` remains fully functional, keeps both of its option vocabularies (see [below](#find-options-canonical-and-legacy)), and the Canonical source still -names `QueryOptionsV2` *"the recommended interface for `data.find()` queries"* +describes `QueryOptionsV2` as *"the vocabulary `data.find()` still accepts"* for callers that stay on it. The capability line between the two entries is real, though. `find` rides GET query parameters, so it has no spelling for a `search` term or for nested `expand` detail — it refuses a nested expand with an @@ -98,7 +98,7 @@ key for key. A managed runtime binds `services.data` to this same shape. The signature above accepts `QueryOptions | QueryOptionsV2`, and the Canonical source declares which of the two to write. `QueryOptionsV2` is *"canonical query options using -Spec protocol field names … the recommended interface for `data.find()` queries"*, while +Spec protocol field names … the vocabulary `data.find()` still accepts"*, while `QueryOptions` carries an `@deprecated` tag in the same file describing *"legacy parameter names … that require translation to QueryAST"*, with the instruction to *"prefer QueryAST fields directly"*. Both interfaces are declared in `packages/client/src/index.ts`, so the