Add per-episode breakdown to guest-star filmography credits

FilmographyCreditOut already aggregated a guest star's episode appearances into one row per series with an episode_count, but never exposed which episodes those were even though the individual episode Credit rows exist in the database. Adds an `episodes` list (season/ episode number, title, air date, sorted chronologically) alongside the existing count -- closes a known limitation tracked in docs/api.md. Co-Authored-By: Claude Sonnet 5 <[email protected]>
2026-09-05 09:19:52 -05:00
parent 20f5e82d1b
commit 606d2532c4
5 changed files with 55 additions and 13 deletions
@@ -145,7 +145,7 @@ network and a production company are both `Company` rows distinguished by
 | Method | Path |
 |---|---|
 | GET | `/api/v1/people/{aurora_id}` |
-| GET | `/api/v1/people/{aurora_id}/credits` (movie and series filmography; guest-star episode credits are aggregated to one row per series with `episode_count`, not one row per episode) |
+| GET | `/api/v1/people/{aurora_id}/credits` (movie and series filmography; guest-star episode credits are aggregated to one row per series rather than one per episode, but carry both `episode_count` and the individual `episodes` breakdown, sorted by season/episode number) |

 ## Collections / Companies

@@ -195,8 +195,3 @@ you want network-level isolation too.
  person's `credits`) still return everything with no pagination at all —
  fine at today's scale, but the natural next thing to revisit if any of
  them grow large.
- `/people/{id}/credits` covers movies and series (episode guest-star
-  credits rolled up per series). It does not yet expose a per-episode
-  breakdown for those guest appearances (just the aggregate
-  `episode_count`) — the individual episode `Credit` rows exist in the
-  database if that's ever needed.