kami
bec77f4297
The reprocess_artists case was 208 of index.ts's 515 lines — 40% of the file and most of what this PR changed in it, buried inside a switch. index.ts is now 313 lines and reads as what it is: wiring, the job switch, cron registration, shutdown. The move also collapses a real duplication. The artist merge and the normalized_name dedup pass ran the same five statements in the same order against different id pairs, so the withTransaction change had to be made twice, identically. Both now call one mergeArtistInto(client, keepId, loserId), which takes a Queryable so the caller owns the transaction, and the ON DELETE CASCADE hazard is documented once instead of twice. Verified as behaviour-preserving: the statement sequence diffs identical against the previous commit, and workers typecheck is clean. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
muzick
A high-performance, distributed music orchestration and recommendation platform.
Overview
muzick is designed to manage a local music library while providing an "infinite vibe" listening experience. It bridges the gap between a local filesystem and advanced discovery engines through a tiered recommendation architecture.
Tech Stack
Frontend
- Framework: React
- Routing: TanStack Router
- Data Fetching: TanStack Query (with Look-ahead Buffering)
- State Management: Zustand (for Session/Vibe state)
- Styling: CSS Variables (Customizable Themes)
Backend
- Runtime: Node.js / TypeScript
- Framework: Fastify
- Task Queue: BullMQ (via Redis)
- Search: Typesense
Infrastructure & Data
- Database: PostgreSQL (Source of truth for metadata, relationships, and session state)
- Cache/Queue: Redis
- Audio Analysis: Essentia (via Worker processes)
- External Metadata: MusicBrainz, Discogs, LRCLib, Cover Art Archive
Core Concepts
- The Rolling Vibe: A continuous, evolving stream of music that uses a "Rolling Window" of tracks. It interleaves owned library tracks with high-probability "probation" tracks (external discoveries).
- The Dislike Lifecycle: A multi-stage state machine that protects users from accidental deletions while ensuring the library stays clean.
- Tiered Similarity: Instant metadata-based matches, followed by deep audio-feature similarity.
Getting Started
Prerequisites
- Docker & Docker Compose
Running Locally
docker-compose up -d