Skip to content

v0.5.1 — outstanding-roadmap sweep

Choose a tag to compare

View all tags
@milnet01 milnet01 released this 30 Apr 16:25
· 62 commits to main since this release
v0.5.1
b8e9a00

Same-day follow-up to v0.5.0 (Phase 4: Export & Approval) closing every actionable 📋 item still surviving in ROADMAP.md.

This is also the first true tagged release since v0.4.2 — v0.5.0 (Phase 4 ship) shipped as a feat: commit without a release tag, so v0.5.1 bundles Phase 4 + the sweep.

Phase 4 (v0.5.0) recap

M3U + symlink folder per album, hard-lock approval state, PDF + HTML report generation via WeasyPrint. Specs: 02 / 08 / 09 / 10 / 11. Convergence trace: 4-round pre-implementation spec sweep (39 → 17 → 3 → 0 actionable findings) + 3-round post-implementation /audit + /indie-review (40 → 3 → 0 findings) + full-codebase audit (ruff / bandit / semgrep / gitleaks all clean).

v0.5.1 sweep — 8 items

Audit tooling

  • pyrightconfig.json at repo root pointing pyright at .venv (recovers the 4 mutagen unresolved-import diagnostics on every /audit run).
  • .gitleaks.toml with extends.useDefault = true + path-regexp allowlist for .venv/, __pycache__/, gitignored data dirs (Tracks/, Albums/, .album-builder/).

Code

  • ACCENT_ROLE = Qt.ItemDataRole.UserRole + 2 extracted as module-level constant in library_pane.py — closes the v0.2.1 Tier 2 L6-M2 deferral; mirrors MISSING_ROLE / TITLE_ROLE in album_order_pane.py.
  • _write_settings(data) helper in persistence/settings.py stamps SETTINGS_SCHEMA_VERSION = 1 at every write site so a hand-rolled settings.json lacking schema_version self-heals on next save (closes the final piece of Theme B recurrence; +4 regression tests).

Docs

  • README §Status promoted from v0.2.0 to v0.5.0 prose.
  • README §System dependencies adds WeasyPrint runtime-library install commands (Pango / Cairo / GDK-PixBuf) for openSUSE + Debian/Ubuntu.
  • ROADMAP cross-cutting summary 📋 → ✅ flips for Themes A-H (2026-04-28 indie-review) and Themes B/F/I/J/K/L recurrence (2026-04-30 indie-review), each citing the per-item Tier fix that actually closed it.
  • Phase 4 prep round-1/2/3 section headers flipped 📝 → ✅ to match round-4's already-✅ marker.

Verification

  • 467 → 471 passing tests (+4 schema_version regression tests in tests/persistence/test_settings.py).
  • Ruff clean.
  • 11 skipped (audio integration gates).

Outstanding

Two genuine 📋 deferrals remain in the roadmap, both intentional:

  • DebouncedWriter._timers unbounded growth — bounded by album count today; revisit when high-cardinality keys land.
  • Stale-segment recovery TOCTOU — microsecond race window during owner shutdown; accepted as v1 design.

The §Future / deferred section lists 7 explicit non-v1 features (group-by-artist tabs, tap-along LRC editor, multi-project, album cover compositing, bulk pre-alignment scheduler, light-theme support, recursive subfolder scanning).

Phases 1–4 are feature-complete and hardened.

Assets 2
Loading