Skip to content

v1.4.0 — progressive analysis: mode=summary|full + deferral

Latest

Choose a tag to compare

@manfredas370 manfredas370 released this 14 Jul 11:18

Stage 2 of the API-efficiency work: /api/analyze becomes progressive so clients can render the viewed pressing instantly and pay for the album survey only on real intent.

  • mode=summary — ≤1 cold Discogs call: the viewed pressing's verdict + dossier; collection/wantlist aggregates consulted read-only (cold aggregates → null personalization, never a crawl); no survey. Live-measured: 0.82s cold, upstreamCalls: 1; warm repeats 0 calls
  • mode=full (default — existing clients and MCP untouched) — the survey's candidate budget adapts to the remaining rate budget (16 normally, 6 when constrained); when even a reduced survey can't start safely the endpoint answers 202 {status:"deferred", retryAfter} immediately instead of grinding into a guaranteed 429
  • meta on every analysislevel, cacheStatus, personalization, candidatesScored/Target, and upstreamCalls: real per-analysis Discogs-cost telemetry from here on

97 tests green. Deployed to the hosted instance. Pairs with ext-v0.4.0.

Full Changelog: v1.3.2...v1.4.0