Skip to content

feat(catalog): support federated Standard Ebooks and Gutenberg book discovery - #47

Merged
ur1el0 merged 8 commits into
mainfrom
feat/federated-book-sources
Nov 16, 2026
Merged

ur1el0 merged 8 commits into
mainfrom
feat/federated-book-sources

Conversation

@ur1el0

@ur1el0 ur1el0 commented Nov 16, 2026 •

Copy link
Copy Markdown
Owner

Summary

  • Propagate non-200 upstream responses from Standard Ebooks search and subject routes as HTTP 502 so clients can distinguish provider outages from empty search matches.
  • Add GET /api/v1/public/standard-ebooks/story for resolving single Standard Ebooks work metadata by slug path.
  • Keep same-title editions from Project Gutenberg and Standard Ebooks distinct in StoryStore and SwiftData persistence by requiring matching sourceProvider and providerId during catalog reconciliation.
  • Surface a dedicated Standard Ebooks collection in LibraryView and display source provider provenance on Explore, Genre Detail, and Author Detail cards while keeping manga disabled on iOS.
  • Add backend HTTP tests and iOS persistence tests covering federated edition identity and partial provider failures.
  • Synchronized documentation, walkthrough gallery, and presentation specifications:
    • Updated docs/simulator_captures/README.md with Standard Ebooks endpoints, independent provider querying, and fault isolation guarantees.
    • Added Journey 5 state diagram and federated provider capabilities to docs/presentation/08_FEATURE_CATALOG_AND_USER_JOURNEYS.md.
    • Incorporated Pillar 6 (Federated Multi-Source Literature & Fault-Isolation Engine) into docs/SYSTEM_DESIGN.md.
    • Documented cross-provider edition disambiguation and updated test counts in docs/ARCHITECTURE.md and root README.md.
    • Updated docs/AGENT_HANDOFF_CONTEXT.md with recent PR Improve Gutenberg discovery and multi-chapter reading #43 and feat/federated-book-sources engineering milestones.

Verification

  • PYTHONPATH=.:backend uv run --with-requirements backend/requirements-test.txt pytest backend -v -k 'not postgres' (133 passed)
  • Verified Markdown syntax and Mermaid diagrams across all updated docs.
  • Confirmed git working tree clean.

@ur1el0
ur1el0 merged commit 7d90493 into main Nov 16, 2026
6 checks passed
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