Shelf progress and book metadata #10

Merged

arne merged 12 commits from shelf-progress-and-metadata into main

2026-04-13 10:43:47 +02:00

arne commented

2026-04-13 10:34:29 +02:00

Owner

Summary

Reading progress shown on shelf entries and book page as a hair-thin leaf-green fore-edge rule
New --leaf semantic color token reserved for reading state
New book metadata fields: read_state (unread/reading/read, manual with Kobo auto-promotion at ≥95%), first_published_year, goodreads_url
Shelf now sorts reading-first (by progress desc), then unread, then read

Design spec: docs/superpowers/specs/2026-04-13-shelf-progress-and-metadata-design.md
Implementation plan: docs/superpowers/plans/2026-04-13-shelf-progress-and-metadata.md

Test plan

Verify shelf shows progress rule with correct fill for books with Kobo progress
Verify shelf sort order: reading (by progress desc) → unread → read
Edit form: set read state, first published year, goodreads URL on a book; verify persistence and display
Book page: verify goodreads arrow link opens externally

🤖 Generated with Claude Code

## Summary - Reading progress shown on shelf entries and book page as a hair-thin leaf-green fore-edge rule - New `--leaf` semantic color token reserved for reading state - New book metadata fields: `read_state` (unread/reading/read, manual with Kobo auto-promotion at ≥95%), `first_published_year`, `goodreads_url` - Shelf now sorts reading-first (by progress desc), then unread, then read Design spec: `docs/superpowers/specs/2026-04-13-shelf-progress-and-metadata-design.md` Implementation plan: `docs/superpowers/plans/2026-04-13-shelf-progress-and-metadata.md` ## Test plan - [ ] Verify shelf shows progress rule with correct fill for books with Kobo progress - [ ] Verify shelf sort order: reading (by progress desc) → unread → read - [ ] Edit form: set read state, first published year, goodreads URL on a book; verify persistence and display - [ ] Book page: verify goodreads arrow link opens externally 🤖 Generated with [Claude Code](https://claude.com/claude-code)

arne added 11 commits

2026-04-13 10:34:29 +02:00

Design: shelf progress and book metadata 54039c53bb

Adds a design spec for reading progress on the shelf (fore-edge rule in
new leaf green), and three new book metadata fields: read_state,
first_published_year, goodreads_url.

Includes the shelf-mock.html design preview used during brainstorming.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Plan: shelf progress and book metadata ada0509355

Ten-task TDD plan that implements the design spec from
docs/superpowers/specs/2026-04-13-shelf-progress-and-metadata-design.md.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Add migration for read_state, first_published_year, goodreads_url e8525058aa

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

Thread read_state, first_published_year, goodreads_url through Book reads d342edd521

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

Persist read_state, first_published_year, goodreads_url on metadata update d7678ab3d4

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

Shelf query joins progress, promotes effective state, sorts reading-first a342792d79

Also fix UpsertReadingState to use input values directly when inserting a
new row (isNew guard), so callers need not supply LastModified timestamps.

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

Edit form persists read_state, first_published_year, goodreads_url ededf47750

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

Add --leaf token and .progress component to the design system 235c075bd6

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

Render fore-edge progress rule on shelf entries fee9156b74

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

Book page: progress rule, first-published year, goodreads link 81b8aaf9b7

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

Edit form: read state radio, first-published year, goodreads url ae385ba4ae

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

arne added 1 commit

2026-04-13 10:42:16 +02:00

Auto-promote unread→reading when device reports any progress 7e922c14d7

The previous effective-state logic only promoted to "read" at ≥95%
progress; books with partial Kobo progress stayed "unread" because
that's the stored default, so the shelf rule stayed empty for every
actively-read book. Now a book with stored state "unread" and any
progress > 0 shows as "reading" in the UI.

Also refactored the shelf query to a second CTE so the effective_state
CASE is written once instead of four times.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>