Changelog

All notable changes to AIREloom are documented here. Format follows Keep a Changelog; versions follow Semantic Versioning.

[0.5.2] - 2026-09-08

Scholix compatibility and metadata fidelity release.

Scholix V1 and V2 endpoint helpers for link providers, publisher directories, data sources, links, and KPI data.
V2 Scholix filters for link providers and source/target PID types.

Research product keywords and descriptions now preserve the API's structured values.
Scholix subType and identifier fields accept the casing used by both API generations.
Person batch lookups support both id and originalId identifiers.

Dependency alignment release; no API changes.

Widened the bibliofabric dependency to >=0.5.1,<0.6.0, picking up bibliofabric 0.5.x: pluggable paging strategies (page/offset with None-able parameter names), resumable cursor iteration (cursor= + on_page checkpoints), explicit per-record parse-failure modes (on_error="skip"/"raise" with a failures collector), bounded concurrent page fetches (concurrency=N), and opt-in proactive rate pacing from X-RateLimit-* headers (rate_limit_pacing=True).
Verified live against the OpenAIRE Graph v3 API: research-product search/get with raw-vs-parsed field comparison, 3-page cursor iteration with on_page checkpointing and no duplicate ids, and project search.

Stable promotion of the v3 line: identical feature set and breaking changes as 0.5.0a1 (see Migration to v3), plus the additions below.

ProjectLinkPid model for PID entries inside V3 Project.links[] items (value/type/typeLabel)
Organization.fundings[].jurisdiction tolerates null payloads (coerced to an empty model instead of failing validation)
Documented live quirks: research-products pageSize > 100 returns HTTP 400 in page and cursor modes; unsorted-page ordering/membership instability; Scholix requires bare pids

projects_by_organization(search_on="name") uses full-text search — organization names rarely appear in project text fields, so search_on="openaire_id" is recommended for identifier lookups

AIREloom now targets the OpenAIRE Graph API v3 (v1/v2 deprecated by OpenAIRE). This is a breaking release; see Migration to v3.

V3 Graph API support: single base URL https://api.openaire.eu/graph/v3 for all entities (kebab-case paths)
41 new filter parameters across Research Products (+20), Projects (+13), Data Sources (+8)
logicalOperator accepts AND/OR/NOT on all Graph filter models
Typed response fields: eoscIfGuidelines, publiclyFunded, isGreen, isInDiamondJournal, openAccessRoute, conferencePlace/conferenceDate, organizational fundings/collectedFrom/originalIds, project funding/links, data source eoscdatasourcetype/jurisdiction/odlanguages/links, Subject.provenance
Auto-quoting of filter values containing spaces/operators/parentheses (GraphV3FilterSerializationMixin)
popularity sort field for Research Products
Migration guide (docs/migration-to-v3.md)

BREAKING: filter renames — authorOrcid→authorId, bestOpenAccessRightLabel→accessRightLabel, sdg→sdgLabel
BREAKING: sdg: list[str] → sdgLabel: str (use inline OR for multiple)
BREAKING: Projects date filters (fromStartDate/toStartDate/fromEndDate/toEndDate) are now str (accept bare years like "2022")
BREAKING: Links endpoint is 0-indexed (first page page=0); page size silently capped at 99 by the server (library clamps + warns)
Data source accessRights/uploadRights/databaseAccessRestriction relaxed from Literal to str per v3 spec

BREAKING: grantID filter (Projects) — dropped by v3
Persons startDate/endDate sort fields — rejected by v3 validation
Per-entity v1/v2 base URL routing (_base_url_override on Graph resource clients)