Skip to content

Pass per-stem name/description through to the stems payloads#1013

Merged
topkoa merged 1 commit into
mainfrom
feat/stem-name-description-passthrough
Jul 19, 2026
Merged

Pass per-stem name/description through to the stems payloads#1013
topkoa merged 1 commit into
mainfrom
feat/stem-name-description-passthrough

Conversation

@topkoa

@topkoa topkoa commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

Part 1 of 3 for per-stem display metadata (feedpak 1.16.0, spec §5.3 name/description
got-feedBack/feedpak-spec#59): the server currently drops both fields while normalizing
manifest stems, so no client can display them.

What

  • sloppak.load_song stem descriptors keep name/description when the manifest carries
    them (omit-when-absent — no null keys; non-string/blank values dropped).
  • Both payload builders pass them through: WS ready stems list (ws_highway.py) and REST
    /api/song/{f}?stems=1 preload list (song.py). The two stay pinned against each other by
    test_song_info_stems.py, whose mirror is updated and which gains a passthrough test.

Compatibility

Additive. Every consumer reading {id, url, default} is unchanged; stems without the fields
serialize exactly as before.

Follow-ups

  • stems plugin: forward the fields in stems:state / getState()
  • stem_mixer: display name (fallback: built-in label → capitalized id) + description tooltip

Verification

  • pytest tests/test_song_info_stems.py — 6 passed (incl. new passthrough test)
  • Full suite: 2689 passed; 8 failures are pre-existing local-env issues (Windows symlink
    privilege, tailwind runtime config) — identical failures on the unmodified tree.

🤖 Generated with Claude Code

feedpak 1.16.0 (spec §5.3) added two OPTIONAL presentational fields to a
stems[] entry: `name` (display label, Readers fall back to the id) and
`description` (free text). The server dropped both while normalizing
manifest stems, so no client could ever display them.

Pass them through at the one place stem descriptors are built
(sloppak.load_song) and let both payload builders — the WS `ready` stems
list and the REST `/api/song/{f}?stems=1` preload list, which are pinned
against each other by test — carry them forward. Omit-when-absent, so a
stem without the fields does not grow null keys; non-string or blank
values are dropped rather than surfaced.

No behaviour change for existing packs or clients: the fields are
additive and every consumer that reads {id,url,default} keeps working
unchanged. The stems plugin / stem mixer display work lands separately.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Signed-off-by: topkoa <topkoa@gmail.com>
@coderabbitai

coderabbitai Bot commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

@topkoa, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 37 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 41fa5cbb-7ae4-447a-a264-a9523d70ea3c

📥 Commits

Reviewing files that changed from the base of the PR and between 270cb39 and b38c305.

📒 Files selected for processing (4)
  • lib/routers/song.py
  • lib/routers/ws_highway.py
  • lib/sloppak.py
  • tests/test_song_info_stems.py
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/stem-name-description-passthrough

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR preserves and exposes per-stem display metadata (name/description) from feedpak manifests by keeping those fields through sloppak.load_song normalization and passing them through to both the WebSocket ready payload and the REST /api/song/{f}?stems=1 preload payload, with tests pinning REST and WS outputs to the same shape.

Changes:

  • Normalize stems entries in sloppak.load_song to optionally include non-blank string name/description while omitting absent/invalid values.
  • Pass name/description through in both WS (ws_highway.py) and REST (routers/song.py) stem payload builders without adding null keys.
  • Extend stem payload parity tests to cover name/description passthrough and omission behavior.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
tests/test_song_info_stems.py Updates WS-payload mirror and adds a test validating name/description passthrough/omission while keeping REST↔WS parity.
lib/sloppak.py Retains optional per-stem name/description during manifest stem normalization, dropping invalid/blank values.
lib/routers/ws_highway.py Includes optional name/description fields in the WS ready stems payload when present.
lib/routers/song.py Includes optional name/description fields in the REST stem preload payload when present.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@topkoa
topkoa merged commit 35c0d0e into main Jul 19, 2026
7 checks passed
@topkoa
topkoa deleted the feat/stem-name-description-passthrough branch July 19, 2026 15:45
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.

2 participants