78 lines
2.8 KiB
Markdown
78 lines
2.8 KiB
Markdown
# YellowJacket — Consolidation Milestone State
|
|
|
|
## Project Reference
|
|
|
|
**Core value:** The music player works reliably and feels solid — every interaction is correct, responsive, and trustworthy.
|
|
**Current focus:** Roadmap created, awaiting Phase 1 planning.
|
|
**Milestone:** Consolidation (correctness, performance, code quality, UX polish, test coverage)
|
|
|
|
## Current Position
|
|
|
|
**Phase:** — (not started)
|
|
**Plan:** — (not started)
|
|
**Status:** Roadmap complete, ready for phase planning
|
|
|
|
```
|
|
Phase Progress: [........] 0/8 phases complete
|
|
```
|
|
|
|
## Performance Metrics
|
|
|
|
| Metric | Value |
|
|
|--------|-------|
|
|
| Phases complete | 0/8 |
|
|
| Plans complete | 0/? |
|
|
| Requirements delivered | 0/26 |
|
|
| Tests added | 0 |
|
|
| Bugs fixed | 0 |
|
|
|
|
## Accumulated Context
|
|
|
|
### Key Decisions
|
|
|
|
| Decision | Rationale | Phase |
|
|
|----------|-----------|-------|
|
|
| Fix races before tests | Can't run `-race`-clean tests with active data races | Phase 1 → 3 |
|
|
| PRAGMAs with test infra | NewTestDB must mirror production DB setup; PRAGMAs change production NewDB | Phase 3 |
|
|
| Tests before refactoring | Research unanimously recommends characterization tests as safety net | Phase 4-5 → 6-7 |
|
|
| SQL consolidation after DB tests | FTS5 search tests verify VIEW doesn't change ranking | Phase 5 → 6 |
|
|
| Frontend last | Backend API should be stable before frontend adapts | Phase 8 |
|
|
|
|
### TODOs
|
|
|
|
- [ ] Plan Phase 1 (next step)
|
|
- [ ] Validate sqlc + SQLite VIEW + FTS5 compatibility during Phase 6 planning (research flag)
|
|
- [ ] Design queue test architecture during Phase 4 planning (research flag)
|
|
- [ ] Determine library scan test fixture strategy during Phase 5 planning (research flag)
|
|
- [ ] Measure startup time with large library before Phase 7 lazy loading work
|
|
|
|
### Blockers
|
|
|
|
None currently.
|
|
|
|
### Warnings
|
|
|
|
- Player lock ordering (`p.mu` before `speaker.Lock()`, goroutine dispatch in beep callback) — do NOT refactor lock-sensitive paths; extract pure logic only
|
|
- modernc.org/libc version must match exactly when updating modernc.org/sqlite
|
|
- `@lit-labs/signals` is experimental (v0.2.0) — not blocking but noted
|
|
|
|
## Session Continuity
|
|
|
|
### Last Session
|
|
|
|
**Date:** 2026-02-27
|
|
**What happened:** Project initialized — codebase analysis, research, requirements definition, roadmap creation
|
|
**Where we stopped:** Roadmap created with 8 phases covering 26 requirements
|
|
**Next action:** `/gsd-plan-phase 1` to create execution plan for Concurrency Race Fixes
|
|
|
|
### Context for Next Session
|
|
|
|
- All 26 v1 requirements mapped across 8 phases
|
|
- Dependency chain: correctness → test infra → tests → SQL/perf optimization → frontend
|
|
- Phase 1 is 4 requirements (CORR-01 to CORR-04), all mechanical mutex additions
|
|
- Research says Phase 1 fixes are "textbook race, LOW effort" — standard patterns, skip research-phase
|
|
|
|
---
|
|
*State initialized: 2026-02-27*
|
|
*Last updated: 2026-02-27*
|