feat: implement 1B domain entities/repos + 1H library API routes

1B — domain layer:
- New entities: Album, Playlist, Like, PlayHistoryEntry
- Track entity extended with album_id, genre, year fields
- New protocols: AlbumRepository, PlaylistRepository, LikeRepository, HistoryRepository
- ArtistRepository / TrackRepository protocols extended (list, count, update, get_many, etc.)
- New repos: SqlAlchemyAlbum/Playlist/Like/HistoryRepository
- Artist and track repos updated to match extended protocols

1H — library API:
- Pagination: PagedResponse[T] generic, offset-based, limit default 50 max 200
- Schemas: TrackOut, AlbumOut, ArtistOut, PlaylistOut/Create/Update,
  LikeEvent/State, HistoryIn/Out, LibrarySearchResponse
- GET/PATCH/DELETE /tracks with filters, sort, pagination
- GET /albums, /albums/{id}, /albums/{id}/tracks
- GET /artists, /artists/{id}, /artists/{id}/albums, /artists/{id}/tracks
- GET /search/library (ILIKE across tracks/albums/artists)
- Full /playlists CRUD + track add/remove (append-only version bump)
- POST /likes (append-only event log), GET /likes, GET /likes/state
- POST /history (scrobble), GET /history
- deps.py: TrackRepoDep, ArtistRepoDep, AlbumRepoDep, PlaylistRepoDep,
  LikeRepoDep, HistoryRepoDep

ruff ✅  mypy ✅  pytest 45/45 ✅

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

app/api/schemas/album.py

@@ -0,0 +1,16 @@
+"""Album request/response schemas."""
+
+import datetime as dt
+import uuid
+
+from pydantic import BaseModel
+
+
+class AlbumOut(BaseModel):
+    id: uuid.UUID
+    title: str
+    artist_id: uuid.UUID
+    artist_name: str
+    year: int | None
+    track_count: int
+    created_at: dt.datetime

app/api/schemas/artist.py

@@ -0,0 +1,14 @@
+"""Artist request/response schemas."""
+
+import datetime as dt
+import uuid
+
+from pydantic import BaseModel
+
+
+class ArtistOut(BaseModel):
+    id: uuid.UUID
+    name: str
+    album_count: int
+    track_count: int
+    created_at: dt.datetime

app/api/schemas/history.py

@@ -0,0 +1,21 @@
+"""Play history request/response schemas."""
+
+import datetime as dt
+import uuid
+
+from pydantic import BaseModel
+
+
+class HistoryIn(BaseModel):
+    track_id: uuid.UUID
+    played_at: dt.datetime
+    play_duration_seconds: int | None = None
+    completed: bool = False
+
+
+class HistoryOut(BaseModel):
+    id: uuid.UUID
+    track_id: uuid.UUID
+    played_at: dt.datetime
+    play_duration_seconds: int | None
+    completed: bool

app/api/schemas/like.py

@@ -0,0 +1,18 @@
+"""Like request/response schemas."""
+
+import datetime as dt
+import uuid
+from typing import Literal
+
+from pydantic import BaseModel
+
+
+class LikeEvent(BaseModel):
+    track_id: uuid.UUID
+    value: Literal["like", "dislike", "neutral"]
+
+
+class LikeState(BaseModel):
+    track_id: uuid.UUID
+    value: str
+    updated_at: dt.datetime

app/api/schemas/pagination.py

@@ -0,0 +1,10 @@
+"""Shared pagination envelope for all paged list responses."""
+
+from pydantic import BaseModel
+
+
+class PagedResponse[T](BaseModel):
+    items: list[T]
+    total: int
+    limit: int
+    offset: int

app/api/schemas/playlist.py

@@ -0,0 +1,31 @@
+"""Playlist request/response schemas."""
+
+import datetime as dt
+import uuid
+
+from pydantic import BaseModel
+
+
+class PlaylistOut(BaseModel):
+    id: uuid.UUID
+    name: str
+    description: str | None
+    owner_id: uuid.UUID
+    version: int
+    track_count: int
+    created_at: dt.datetime
+
+
+class PlaylistCreate(BaseModel):
+    name: str
+    description: str | None = None
+
+
+class PlaylistUpdate(BaseModel):
+    name: str | None = None
+    description: str | None = None
+
+
+class PlaylistAddTrack(BaseModel):
+    track_id: uuid.UUID
+    position: float | None = None

app/api/schemas/search.py

@@ -0,0 +1,13 @@
+"""Search response schemas."""
+
+from pydantic import BaseModel
+
+from app.api.schemas.album import AlbumOut
+from app.api.schemas.artist import ArtistOut
+from app.api.schemas.track import TrackOut
+
+
+class LibrarySearchResponse(BaseModel):
+    tracks: list[TrackOut]
+    albums: list[AlbumOut]
+    artists: list[ArtistOut]

app/api/schemas/track.py

@@ -0,0 +1,27 @@
+"""Track request/response schemas."""
+
+import datetime as dt
+import uuid
+
+from pydantic import BaseModel
+
+
+class TrackOut(BaseModel):
+    id: uuid.UUID
+    title: str
+    artist_id: uuid.UUID
+    artist_name: str
+    album_id: uuid.UUID | None
+    album_title: str | None
+    duration_seconds: int | None
+    file_format: str
+    file_size: int
+    metadata_status: str
+    source: str
+    created_at: dt.datetime
+
+
+class TrackUpdate(BaseModel):
+    title: str | None = None
+    genre: str | None = None
+    year: int | None = None