Skip to content

v2.9.0: find_related resilience: offset pagination + multi-source provider fallback

Choose a tag to compare

@cyanheads cyanheads released this 09 Jun 07:18
· 19 commits to main since this release
v2.9.0
e8a6bff

find_related resilience: offset pagination + multi-source provider fallback

NCBI eLink is the sole provider for find_related. This release adds provider fallback
(NCBI → Europe PMC → OpenAlex) and offset pagination.

Added:

  • pubmed_find_related: offset parameter (0-based, default 0) for paging past the first
    result window; format() header now emits Returned | Offset parity (#36)
  • pubmed_find_related: multi-source fallback — NCBI eLink (primary) → Europe PMC →
    OpenAlex; first success wins; provenance in enrichment.source (#63)
    • similar: NCBI pubmed_pubmed → OpenAlex related_works
    • cited_by: NCBI citedin → EPMC /citations → OpenAlex cites:
    • references: NCBI refs (PMC-only) → EPMC /references → OpenAlex referenced_works
      (actual coverage replaces notice-only mitigation for non-PMC sources)
  • src/services/openalex/: new OpenAlex API client module (#63)
  • src/services/europe-pmc/: citations() and references() methods added (#63)
  • pubmed_europepmc_search: advisory notice when date sort is requested on PPR-only
    results — EPMC accepts but silently ignores P_PDATE_D for preprints (#67)

31 test files, 844 tests pass; bun run devcheck clean.