Sleevesight

Sleevesight MVP plan

Date: 2026-10-13
Scope: closing Phase 0; Phase 0.5, Pipeline CLI; Phase 1, Android MVP; Phase 1.5, Play release
Tracking: #31

The work to the MVP and its release, as issues and their dependencies. What each piece is and why is in design.md and architecture.md; the issues point to the sections. Each dependency is also a native blocked by link on its issue, except the two dotted ones around #9: #46 did not adopt MusicBrainz tags (D12, 2026-10-15), so #9 does not block #58.

Dependencies

An arrow points from an issue to the issues it unblocks. The dotted arrows were conditional: #46 decided whether #9 was needed, and #9 would block #58 only if it was. It was not (D12): the tags are not adopted to fill Last.fm’s gaps, and their use as labels when Last.fm is off is decided in Phase 2.

flowchart TD
  subgraph P0["Phase 0. Platform spike"]
    i30["#30 Remove the probe"]
  end

  subgraph P05["Phase 0.5. Pipeline CLI"]
    i32["#32 Fixtures"]
    i33["#33 Domain model, normalizer"]
    i34["#34 Evidence model"]
    i35["#35 :net HTTP client"]
    i36["#36 MusicBrainz resolution"]
    i37["#37 Wikidata identity check"]
    i38["#38 Wikipedia adapter"]
    i39["#39 Last.fm adapter, genres"]
    i40["#40 Web search provider (D11)"]
    i41["#41 Caches in :store"]
    i42["#42 Prompts, grounding check"]
    i43["#43 Anthropic provider"]
    i44["#44 Orchestration"]
    i45["#45 :cli"]
    i46["#46 Phase 0.5 gate"]
    i9["#9 MusicBrainz tag licence"]
  end

  subgraph P1["Phase 1. Android MVP"]
    i47["#47 App skeleton"]
    i48["#48 Session layer"]
    i49["#49 History, track changes (D15)"]
    i50["#50 Settings, secrets"]
    i51["#51 Pipeline on the phone"]
    i52["#52 Home screen"]
    i53["#53 Auto-write, skip detection (D5)"]
    i20["#20 Prepare the next track (D13)"]
    i54["#54 Diagnostics screen"]
    i29["#29 Restricted settings"]
    i55["#55 Phase 1 exit"]
  end

  subgraph P15["Phase 1.5. Play release"]
    i56["#56 Release workflow"]
    i57["#57 Store listing, privacy policy"]
    i58["#58 Play review"]
  end

  i32 --> i33 --> i34
  i34 --> i36
  i35 --> i36
  i36 --> i37 --> i38
  i34 --> i39
  i35 --> i39
  i34 --> i40
  i35 --> i40
  i34 --> i41
  i34 --> i42
  i35 --> i43
  i42 --> i43
  i38 --> i44
  i39 --> i44
  i40 --> i44
  i41 --> i44
  i43 --> i44
  i44 --> i45 --> i46
  i46 -.-> i9
  i9 -.->|"only if the tags were adopted: not (D12)"| i58
  i46 --> i55

  i30 --> i47
  i47 --> i48
  i47 --> i50
  i33 --> i48
  i33 --> i50
  i47 --> i29
  i48 --> i49
  i41 --> i49
  i48 --> i51
  i50 --> i51
  i44 --> i51
  i51 --> i52
  i51 --> i54
  i49 --> i53
  i51 --> i53
  i53 --> i20
  i52 --> i55
  i54 --> i55
  i20 --> i55
  i29 --> i55

  i47 --> i56
  i52 --> i57
  i55 --> i58
  i56 --> i58
  i57 --> i58

Work

Phase 0. Platform spike

Issue Work Blocked by
#30 Remove :spike, its CI step and its references; the restricted-settings measurement moved to #29  

Phase 0.5. Pipeline CLI

Issue Work Blocked by
#32 Fixtures: the simulator’s playlist, facts and albums data in fixtures/below-soundtrack/  
#33 :core domain model, Settings, normalizer port; Multiplatform-readiness rules on #32
#34 Evidence lines, ids, fingerprint; SourceAdapter #33
#35 :net: rate limits, typed errors, redacting logger, Secret  
#36 MusicBrainz client; recording, first release, artists, covers #34, #35
#37 Wikidata client; the Wikipedia identity check #36
#38 Wikipedia adapter: lead sentences, verbatim, attributed (D1) #37
#39 Last.fm adapter; genre vocabulary; MusicBrainz tags for evaluation only #34, #35
#40 Choose the web search provider (D11); its adapter #34, #35
#41 :store: retrieval, artist-resolution and synthesis caches #34
#42 Prompt builders; grounding check #34
#43 :ai: Anthropic provider #35, #42
#44 Pipeline orchestration (D4); PipelineEvents #38, #39, #40, #41, #43
#45 :cli: coverage report, insights, HTTP recordings #44
#46 The gate: thresholds tuned, MusicBrainz tags judged (D12), coverage reviewed #45
#9 Licence of MusicBrainz tags; needed before #58 only if #46 adopted them, which it did not (D12) #46 decided it is not needed for the MVP

Phase 1. Android MVP

Issue Work Blocked by
#47 :app skeleton; first-run screen; notification access; checkManifest and the debug APK back in CI #30
#48 Session layer: NowPlaying, track identity, queue, art #47, #33
#49 Session history; track-change records (D15) #48, #41
#50 Settings (DataStore) and secrets (Keystore): the AI key and the sources’ keys (Last.fm, web search); settings screen #47, #33
#51 The pipeline on the phone, with the keys wired into the adapters; visible-only lookups (D6); Write on tap #48, #50, #44
#52 Home screen; every empty and error state #51
#53 Write insights automatically; skip detection and Crossfade (D5) #49, #51
#20 Prepare the next track (D13) #53
#54 Diagnostics screen #51
#29 Restricted settings, on a device without Advanced Protection #47
#55 Exit: a listening session on a real phone against Spotify #52, #54, #20, #29, #46

Phase 1.5. Play release

Issue Work Blocked by
#56 Release workflow: a signed app bundle, the key in a protected environment; R8 and its keep rules #47
#57 Store listing and its graphics, launcher icon, privacy policy, data safety form #52
#58 Play’s requirements for notification access and its target API level; testing track; review #55, #56, #57

Pending decisions

Decision Needed by Options, and the recommendation
Release-date semantics #52 The recording’s first release, the release being played, or both. Recommendation: the first release as “Released”, the played release in its source line when it differs
Players that send only a title #52 How much of the home screen to hide when resolution is mostly none. Recommendation: decide from what #46 and #55 show, and hide nothing in the meantime
AI providers in the MVP #50 Anthropic only, as the phase mapping has it, with the others in Phase 3; or one more in Phase 1. Recommendation: Anthropic only; AiProvider keeps the rest cheap
Web search provider (D11) #40 Decided by that spike
MusicBrainz tags as the labels when Last.fm is off (D12) #95 Decided with the genre labels in Phase 2, after MetaBrainz answers the inquiry; licence findings in #9. Not adopted to fill Last.fm’s gaps (2026-10-15)
The name #57 The spoken-aloud test on “Sleevesight” before the store listing fixes it
Play developer account #58 Personal or organisation; the testing a new account must do before production depends on the type

Considerations

During implementation

After implementation

This site is open source. Improve this page.