Skip to content

Compatibility with Familiar: the two recordings endpoints it calls - #62

Open
jeffcrouse wants to merge 1 commit into
mainfrom
familiar-calls-recordings
Open

jeffcrouse wants to merge 1 commit into
mainfrom
familiar-calls-recordings

Conversation

@jeffcrouse

Copy link
Copy Markdown
Member

CLAUDE.md only. The "Compatibility with Familiar" list is what protects an endpoint, and it was two behind:

  • POST /v1/recordings/claims — Familiar's ADR-0115 backfill has called it since 2026-09-14 (that's where the 89.6% named rows came from).
  • GET /v1/recordings/{mbid}?type=musicbrainz_recording&pipeline_version=… — Familiar's ADR-0119 (merged and deployed 2026-09-16, ADR-0119: the corpus is asked by recording before it is asked by hash (accepted, built) familiar#320) asks the recording first and the hash only on a 404, per ADR-0019 point 3, and now sends recording_mbid on POST /v1/embeddings. The fields it reads off a recording row are named, so a change to RecordingEmbedding gets checked against them.

Verified against the sibling checkout's community_cache.py rather than from memory — nine request sites, all now listed.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Tmmn6LQjCyksB1jfaAqnhn

The list is what protects an endpoint, and it was two behind: Familiar's
ADR-0115 backfill has called POST /v1/recordings/claims since 2026-09-14,
and its ADR-0119 (2026-09-16) asks GET /v1/recordings/{mbid} before the
hash, per ADR-0019 point 3, and sends recording_mbid on contribute. The
fields it reads off a recording row are named so a change to
RecordingEmbedding is checked against them. Verified against the sibling
checkout's community_cache.py: nine request sites.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Tmmn6LQjCyksB1jfaAqnhn
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