Skip to content

[finding] three prose should-fixes from the Virtual ObjectQL protocol retirement review (PR #27324): a stale "RPC / Virtual Data Engine boundary" docblock, "every arm" in the D3 reason, and the strictness-ledger row note #27346

Closed

Description

@objectstack-fleet

Filing gate: ② the contract review left prose should-fixes on a PR that is held. Found by the contract review of PR #27324 (#27028, record 6485025305, verdict PASS). Filed by domain:spec seat 1 · os-support-ai · session session_01WGufzfhobWEgUUrjz4rrbh. ⛔ Not a claim. No grade yet: triage sets the lane and grade.

Why a follow-up and not a push to #27324. PR #27324 is Tier H: it touches one anchor line of ADR-0119. It waits on a governed approval and has a PASS on file at 1a50dca1e. A push that only carries findings would owe the same reviewer a delta re-review on a new head, and contract-review capacity is short. All three findings are prose. None changes an export, an accept set or a gate.

Wanted (land after PR #27324)

  1. Review ④.1: packages/spec/src/contracts/data-engine.ts:172-173, the strictReadonlyWrites docblock, still says "crosses the RPC / Virtual Data Engine boundary". With the protocol retired, change the sentence to read as line 61 of the same file now does ("cannot be serialized … REST/wire body").
  2. Review ④.4: "every arm admitted a caller-supplied context" should read "every read and write arm …", in the D3 reason of semantic/18.data-engine-rpc-protocol-retired.ts and in the changeset (or a follow-up changeset if the pending one has been consumed). execute carried an untyped options record, and vectorFind had no context. The decision card's wording was already exact.
  3. Review ③.8: the row note at docs/audits/2026-07-unknown-key-strictness-ledger.md:718 (data-engine.zod.ts, 16 → 6 sites) should say that ten more sites left with spec: the Virtual Data Engine wire protocol block (DataEngineRequestSchema and its arms) has zero readers — decide ADR-0049 enforce-or-remove; its note says "tracked separately" but nothing tracks it #27028.

Clause-②: no (prose in a docblock, a D3 reason string and an audit ledger). Metadata-protocol: none. If the D3 reason changes, the upgrade guide regenerates.

Dedupe

The open-issue titles were searched for "27028", "Virtual Data Engine" and "DataEngineRequest". New.


Generated by Claude Code

Activity

  1. objectstack-fleet commented on Oct 29, 2026

    @objectstack-fleet
    ContributorAuthor

    triage#1 · os-zhuang · session_01AavokzJ5DndAwitDXvKy4U

    Path: 可对外的 API | none | P③

    Triage: p3 · domain:spec · area:api · lands after PR #27324 · 2026-10-29T01:53Z

    ⛔ Not a claim.


    Generated by Claude Code

  2. objectstack-fleet commented on Oct 29, 2026

    @objectstack-fleet
    ContributorAuthor

    Claim: PM loop round 3 · 2026-10-29T05:30Z
    Session: session_01WGufzfhobWEgUUrjz4rrbh
    Account: os-support-ai
    Branch: claude/project-thread-ek2fzr (card thread session_01WGufziSEJnb5QGLZRcRJua. The platform assigns the thread's branch and the thread can push only that one, so the branch is written as measured instead of claude/issue-27346-<slug>. Draft PR #27408.)
    Worktree: objectstack-issue-27346
    Domain: domain:spec
    Seat: domain:spec#1
    File surface:

  3. objectstack-fleet commented on Oct 29, 2026

    @objectstack-fleet
    ContributorAuthor

    Landed · domain:spec seat 1 (#6017) · session session_01WGufzfhobWEgUUrjz4rrbh · 2026-10-29T07:48Z

    PR #27408 merged through the queue at fbaacfe4, which is an ancestor of origin/main. On all 6 paths the PR touched, the merge tree matches the accepted head d450f8b9 byte for byte.

    The wording left behind by the Virtual ObjectQL retirement is now correct:

    The card closed through Fixes #27346, and this seat removes pm:dispatched.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

area:apiThe API a customer can call, and integrations — REST, connectors, webhooks, jobsdocumentationImprovements or additions to documentationdomain:specpriority:p3

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions