Paul approved the seven-operation contract (8 November 2026). This step adds it alongside today's Emby session, which
the app still uses unchanged: nothing calls MediaProvider yet, so no behaviour, stored id, schedule, database or
signing changes.
- MediaProvider.kt: the contract, LibraryId (server's own id, never its address), MediaRef for anything leaving its
library, five ProviderError kinds, PlaybackPlan whose loggable form leaves out credentials, local file ids from a
128-bit SHA-256 prefix.
- MediaProviderContract: twelve shared checks every adapter must pass; a reference provider passes them all, and
ContractCatchesFlawsTest shows each check fails on the flaw it guards against.
- tools/verify.sh: the release gate (build, all tests, lint, contract suite present); .gitea/workflows/ci.yml runs it
on every push where a runner exists.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>