PXRead
builtA local library and reading system for mixed TXT and EPUB collections, built around durable works, editions, and revisions.
- The problem
- Source files arrive with inconsistent names, duplicates, uncertain metadata, and competing versions. A flat file list cannot keep reading progress and annotations attached to the right edition when one version supersedes another.
- Engineering work
- A Work/Edition model separates a work from each readable edition; immutable revisions record body changes, and HEAD advancement uses compare-and-set.
- An import decision flow records source evidence, candidate metadata, and confidence, then chooses append, fork, skip, or review; body files are content-addressed.
- A single EPUB reading path uses tied annotation positions, with tests for reattachment and visible detachment.
- Evidence and boundaries
- A working local application with a backend, web and mobile clients, schema migrations, and tests. Source is private; the public discussion covers architecture and implemented behavior.