Skip to content

Document community characters + recaps - #14

Merged
KodeStar merged 1 commit into
mainfrom
docs/characters-recaps
Jul 12, 2026
Merged

Document community characters + recaps#14
KodeStar merged 1 commit into
mainfrom
docs/characters-recaps

Conversation

@KodeStar

Copy link
Copy Markdown
Owner

Closes the docs DoD lag from audiosilo-server #38 / audiosilo-frontend #58, which shipped the community characters + story so far recap layer end-to-end (the /meta seam) without the docs catch-up.

Changes

  • server/api/reference.md - work.characters / work.recaps added to the GET /libraries/{id}/meta example and documented: the edition-independent position model ({chapter}), the character fields (id/name/aliases/role enum/reveal/description), the recap fields (through/scope/text), and the note that the server passes these straight through from upstream GET /works/{id} but drops the character xref.
  • frontend/state-and-data.md - the Characters + Story so far render in BookMetaSection (closed-by-default accordions, no blur; the unit-tested label helpers).
  • listening/browsing.md (User Guide) - the user-facing Characters and Story so far sections under 'About this book', framed for spoiler-safety and noting they are community-contributed (so a matched book may still lack them).

Verification

  • npm run build green (throws on broken links/anchors/images).
  • Field names, the role enum, and the dropped xref verified against the server internal/meta structs, the frontend types.ts + book-meta.tsx helpers, and the audiosilo-meta schema.
  • Ran /simplify + /code-review on the diff (per the standing pre-merge process); the review caught an over-claim ('mirrored verbatim') that was corrected to reflect the dropped xref.

Closes the docs DoD lag from server #38 / frontend #58, which shipped the
characters + 'story so far' recap layer through the /meta seam without the
docs catch-up:

- server/api/reference.md: work.characters / work.recaps on the /meta
  envelope (position model, character/recap fields, role enum, the xref
  the server drops).
- frontend/state-and-data.md: the Characters + Story so far render in
  BookMetaSection (closed-by-default accordions, tested label helpers).
- listening/browsing.md: the user-facing Characters + Story so far
  sections under 'About this book', framed spoiler-safe.
@KodeStar
KodeStar merged commit 463f386 into main Jul 12, 2026
1 check passed
@KodeStar
KodeStar deleted the docs/characters-recaps branch July 12, 2026 14:26
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