Skip to content

Bridge 2c-2b: document on-demand podcast play - #158

Merged
KodeStar merged 3 commits into
mainfrom
feat/bridge-2c-2b
Oct 22, 2026
Merged

KodeStar merged 3 commits into
mainfrom
feat/bridge-2c-2b

Conversation

@KodeStar

@KodeStar KodeStar commented Oct 22, 2026 •

Copy link
Copy Markdown
Owner

Docs for Bridge Phase 2c-2b, on-demand podcast play. Pairs with KodeStar/audiosilo-bridge#9 and KodeStar/audiosilo#80 (workspace glue, to follow).

User pages:

  • New subsection in admin/podcasts.md: "Playing an episode that isn't downloaded".
  • How retry and cooldown work, and the per-listener limit of 5 open fetches (admins exempt).

Developer pages:

  • The 503 envelope and the fetch Status, the status and Retry routes, and the podcast_fetch capability.
  • Fetch priorities and promotion, and the one-ahead queue prefetch.
  • Claims: the reserved interactive worker, claim_min_priority negotiation, claim reissue, and lease release for an undelivered reply.
  • A handoff for the player phase (2d) with the exact optional types, client and hook shapes, and polling rules. Nothing says the player shows any of this yet.

Removes the stale 404 not_downloaded claims. No UI changed, so no screenshots.

Every claim was checked against the code: server e4768eb, Bridge feat/bridge-2c-2b, and wire-2b.json. One review at high (/simplify and /code-review --fix). npm run build green.

Describe shared fetch/status/Retry, queue prefetch, listener limits and reserved Bridge capacity. Record optional player types, client/hook signatures and polling rules for Phase 2d.
@KodeStar
KodeStar merged commit f41a287 into main Oct 22, 2026
1 check passed
@KodeStar
KodeStar deleted the feat/bridge-2c-2b branch October 22, 2026 15:37
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