Repository navigation
Commit fbaacfe
docs(spec): correct the Virtual ObjectQL retirement wording (context arms, readonly-writes docblock, ledger row) (#27408)
<!-- claude-projects-attribution: {"github_login":"os-support-ai"} -->
_Requested by **Yibo Wang** · [project
thread](https://claude.ai/code/project/chan_01BVUyyPie8gHwoPM18iABwB?thread=cmsg_01BVUyyPie8gHwoPM18iABwB2JfLyoXowwaMTotLmArPu2)_
Fixes #27346
## What changes
The three prose should-fixes from contract review 6485025305 on the
merged #27324 (#27028):
1. `packages/spec/src/contracts/data-engine.ts`, the
`strictReadonlyWrites` docblock: no longer says the option does not
"cross the RPC / Virtual Data Engine boundary" (that boundary is
retired). It now says, as the `WriteObservabilityOptions` docblock
already does, that nothing here can be serialized and none of it is
reachable from a REST/wire body.
2. The D3 reason of `data-engine-rpc-protocol-retired`
(`packages/spec/src/migrations/entries/semantic/18.data-engine-rpc-protocol-retired.ts`):
"every arm admitted a caller-supplied `context`" becomes "every read and
write arm …". The `execute` arm carried an untyped options record and
`vectorFind` had no `context`. The same sentence in the retirement
comment in `packages/spec/src/data/data-engine.zod.ts` gets the same
correction.
3. `docs/audits/2026-07-unknown-key-strictness-ledger.md`, the
`data-engine.zod.ts` row note: records that ten more sites
(`DataEngineRequestSchema` and its nine arms) left with #27028.
The pending `.changeset/27028-data-engine-rpc-protocol-retired.md` is
**not** edited (check-empty-changeset). A new
`.changeset/27346-data-engine-rpc-retirement-wording.md`
(`@objectstack/spec` patch) carries a "Supersedes, in the same release:"
paragraph naming that note's sentence and giving the corrected wording.
Generated outputs the D3 reason feeds are regenerated where they move.
## Why
The released wording overstated the claim (two of the nine arms had no
`context` key) and the docblock pointed at a boundary that no longer
exists in the spec. Prose only: no schema, export or runtime behaviour
changes.
## Verification
Readings are posted on the PR once the local runs finish (spec build,
`check:generated`, spec `test:repo`, spec test under os-verify-lock,
derived gates).
Clause-②: no
Metadata-protocol: none
## Human Minimum
- [x] 1. Schemas start as Zod; `packages/spec` holds no runtime logic.
- [x] 2. Every name I added uses the casing for its kind.
- [x] 3. No formatter ran; `pnpm lint` passes.
- [x] 4. One issue, one branch off an up-to-date `main`, one pull
request.
- [x] 5. A change that publishes carries a changeset, and both
declaration lines are filled in here and in the changeset.
- [x] 6. `packages/spec` touched: its generated artifacts are
regenerated and committed.
- [x] 7. No hand edits to `content/docs/references/`,
`packages/*/CHANGELOG.md` or `content/docs/releases/`.
- [x] 8. Title, body and comments are in English.
- [x] The *Before Submitting* list in CONTRIBUTING.md is done.
---
_Generated by [Claude
Code](https://claude.ai/code/session_01WGufziSEJnb5QGLZRcRJua)_
---------
Co-authored-by: Claude <noreply@anthropic.com>1 parent 86edcaf commit fbaacfe
6 files changed
Lines changed: 19 additions & 8 deletions
File tree
- .changeset
- content/docs/protocol/objectql
- docs/audits
- packages/spec/src
- contracts
- data
- migrations/entries/semantic
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
390 | 390 | | |
391 | 391 | | |
392 | 392 | | |
393 | | - | |
394 | | - | |
| 393 | + | |
| 394 | + | |
395 | 395 | | |
396 | 396 | | |
397 | 397 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
715 | 715 | | |
716 | 716 | | |
717 | 717 | | |
718 | | - | |
| 718 | + | |
719 | 719 | | |
720 | 720 | | |
721 | 721 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
169 | 169 | | |
170 | 170 | | |
171 | 171 | | |
172 | | - | |
173 | | - | |
| 172 | + | |
| 173 | + | |
174 | 174 | | |
175 | 175 | | |
176 | 176 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1343 | 1343 | | |
1344 | 1344 | | |
1345 | 1345 | | |
1346 | | - | |
1347 | | - | |
| 1346 | + | |
| 1347 | + | |
1348 | 1348 | | |
1349 | 1349 | | |
1350 | 1350 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
36 | 36 | | |
37 | 37 | | |
38 | 38 | | |
39 | | - | |
| 39 | + | |
| 40 | + | |
40 | 41 | | |
41 | 42 | | |
42 | 43 | | |
| |||
0 commit comments