Skip to content

Note where the old enhanced query drops references (#760) - #763

Closed
adamjohnwright wants to merge 2 commits into
mainfrom
enhanced-v1-note-2
Closed

adamjohnwright wants to merge 2 commits into
mainfrom
enhanced-v1-note-2

Conversation

@adamjohnwright

Copy link
Copy Markdown
Contributor

This adds comments only, so the new site doesn't copy the fault behind #760. It replaces #761 after that PR's review.

The fault: /ContentService/data/query/enhanced/{id} (v1) is kept byte for byte as Java answers it.

  • An object is written in full only once, and after that as its bare dbId.
  • An event's neighbours come before its own lists: its preceding and following events, and, since graph-core bb5e0ca0 (Aug 2025), its parent pathways.
  • So a reference a neighbour also cites is a bare number in the event's literatureReference.
  • Production's pathway browser drops those numbers, which is literature references missing from live site despite being in curator tool record. #760.

The note goes on the node endpoint and the site's Event model. It says to read an event's lists from /enhanced/v2 through the site's JSOGDeserializer, as the details pages do. v2 also writes each object once, with @id, and points back to it with {"@ref": …}. The deserializer resolves those references, so v2 is safe only through it.

Changed from #761: that PR said v2 writes every object in full, which is wrong; reading v2 raw would lose the same references. It also blamed only the parent pathways.

Two site readers still read v1 lists (the IDG panel's summation, and the entity popup's components). They are issue #762.

No behaviour changes.

Refs #760, #762.

🤖 Generated with Claude Code

adamjohnwright and others added 2 commits October 30, 2026 18:26
/data/query/enhanced keeps Java's answer byte for byte, including a bare
dbId for an object written earlier; since graph-core bb5e0ca0 an event's
parent pathways come first, so references its parent also cites are bare
numbers in its own list. Production's browser loses them (#760). The
endpoint and the event model now say to read an event's lists from
/enhanced/v2, as the details pages do, so the new site does not copy the
fault.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…eferences too

v2 writes each object once as well, with @id, and points back with
@ref; it is safe only through the site's JSOGDeserializer, which the
note now says. Neighbouring events, not only parent pathways, come
before an event's lists in v1. The two v1 readers still at risk are
issue #762.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@adamjohnwright

Copy link
Copy Markdown
Contributor Author

Replaced by the next PR: the difference is includeRef, not the version.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant