Skip to content

Correct a claim I made three times today: 009 has not landed - #253

Merged
adamjohnwright merged 2 commits into
mainfrom
fix/correct-collection-routing-claim
Sep 18, 2026
Merged

adamjohnwright merged 2 commits into
mainfrom
fix/correct-collection-routing-claim

Conversation

@adamjohnwright

Copy link
Copy Markdown
Contributor

Documentation only. I marked spec 010's T021 done, wrote in the contract that collection routing "already did most of the work on retrieval", and told Adam it was the main reason first-token fell from ~36s to 9.6s.

All three are wrong.

What actually landed

Source routing. resolve_active_sources sends a question to the Reactome bundle, the user guide, or a live lookup. That is real and it works.

Spec 009 is collection routing — choosing among the five collections inside the Reactome bundle — and it is not implemented:

spec 009 asks for actual state
collections field on QueryIntent absent — only source exists
resolve_collections(selected, available) does not exist
filter collection_retrievers by selection retrieve_documents loops over all five

I conflated the two because both narrow retrieval and both get called "routing". The check that caught it is the one I eventually ran: grepping for the function the spec names, rather than for a concept.

The latency explanation is now honestly incomplete

Rather than substituting a new confident explanation for the wrong one:

  • source routing accounts for the fast user-guide answers (3.3s to first token)
  • two-round preprocessing accounts for about 2.5s (Run react-to-me preprocessing in two rounds, and correct the latency record #238)
  • preprocessing was 5.1s before that change, never the ~16s recorded
  • the rest is unexplained, and the likeliest reading is that the old figures came from one question and were never representative

That is recorded in the contract too, since the website team was told the stronger version.

Consequence

T021 is open again, and spec 009's task list — which showed 24 open items I had assumed were stale bookkeeping — is accurate as it stands. Collection routing remains real, unstarted work, and it is still the lever the latency analysis points at.

🤖 Generated with Claude Code

adamjohnwright and others added 2 commits September 18, 2026 18:41
I marked spec 010's T021 done, wrote in the contract that collection routing
"already did most of the work on retrieval", and told Adam it was the main reason
first-token fell from ~36s to 9.6s. All three are wrong.

What landed is *source* routing: `resolve_active_sources` sends a question to the
Reactome bundle, the user guide, or a live lookup. Spec 009 is *collection*
routing -- choosing among the five collections inside the Reactome bundle -- and
it is not implemented. `QueryIntent` has no `collections` field,
`resolve_collections` does not exist, and `retrieve_documents` still loops over
every collection it has.

I conflated the two because both narrow retrieval and both were described to me
as routing. The check that would have caught it is the one I eventually ran:
grepping for the function the spec names rather than for a concept.

The honest position on the latency improvement is now recorded as partly
unexplained. Source routing accounts for the fast user-guide answers, two-round
preprocessing for about 2.5s, and the rest may be that the old figures came from
one question and were never representative. Substituting a new confident
explanation for the wrong one would repeat the mistake.

T021 is open again, and spec 009's task list is accurate as it stands.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@adamjohnwright
adamjohnwright merged commit 904d07a into main Sep 18, 2026
10 checks passed
@adamjohnwright
adamjohnwright deleted the fix/correct-collection-routing-claim branch September 18, 2026 18:50
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