Skip to content

History / Data Storage

Revisions

  • Record where the catalogue lookup ordering now lives

    @riddlemd riddlemd committed Aug 19, 2026
  • Drop the migration documentation 0.15.0 carries no upgrade path from older builds, so the Migrations section and the legacy file/field references go with the code.

    @riddlemd riddlemd committed Jul 29, 2026
  • One Services folder in Infrastructure Logic/ and Search/ marked the static helpers apart from the injected ones; every implementation is injected now, so the split described nothing.

    @riddlemd riddlemd committed Jul 28, 2026
  • Describe the six-project layout and the DI conventions The MAUI head is src/KHost.Mobile and KHost.Mobile.UI is a Razor class library without the workload, so every documented build command that named the UI project pointed at something that cannot produce an app. Records the Project.cs DI extension per project, internal implementations behind public interfaces, and the services that replaced the Infrastructure statics.

    @riddlemd riddlemd committed Jul 28, 2026
  • Point every path at the new src/ and tests/ layout The seven projects moved under src/ (shipping) and tests/ (xUnit), so every quoted file path and build/test command shifts accordingly. Architecture gains the layout block. The GitHub releases API URL is not a project path and is unchanged.

    @riddlemd riddlemd committed Jul 28, 2026
  • Strip the conversational register from every page Doc-archaeology, coaching asides ('the bar is', 'worth knowing', 'deliberately/on purpose'), and just/simply filler are gone; pages state what is, not how it got that way. Facts, commands, quoted on-screen labels and the operational gotcha rationale are unchanged.

    @riddlemd riddlemd committed Jul 27, 2026
  • Correct audit-found drift across the contributor and user pages Contributor pages had fossilized pre-split content: stale KHost.Mobile/KHost.Mobile.csproj names, serializer contexts and LoggingHttpMessageHandler pointed at the UI project instead of Infrastructure, a store example predating the JsonFileStore<T> base, the wrong namespace in the folder=namespace example, a nonexistent DeezerCoverArtException, and a Compile-link claim about the test projects that had it backwards. Architecture also gains the deliberate ISongListStore double-registration callout and the missing Logic/ helpers. User pages: My Songs is not the first tab, the Surprise reroll is a single best-effort retry rather than a guarantee, and the Undo window setting now also covers the performance-history undo (wired in app commit 888b3e9).

    @riddlemd riddlemd committed Jul 27, 2026
  • Cover the album-art atomic write and device etiquette Two things landed in the repo after the last wiki sync. Data storage — AlbumArtCache now writes covers through AtomicFile like the JSON stores, and the reason is sharper there: "is it cached?" is File.Exists, so a write torn by an app kill would leave a truncated image counting as a cache hit forever, with nothing ever re-checking it. A failed atomic write leaves no target file, so the next request re-fetches. Building and testing — added the rule that a physical device is someone's actual phone: read from it, drive the app on it, change nothing else. Specifically, never `adb shell monkey` to launch or foreground the app; it looks like a launcher but is a random input fuzzer whose event mix can flip the device's auto-rotate setting. Use foreground() from device/khdrive.mjs, which runs am start. User-facing pages untouched — neither change is visible on screen.

    @riddlemd riddlemd committed Jul 27, 2026
  • Update the contributor pages for the layered project split The repo went from two projects to seven; these pages still described the old two-project shape, the pre-split client folders, and the hand-rolled store pattern. Architecture "The two projects" -> the seven, with the reference column and the layering rules (namespace names its assembly; the Maui prefix is a claim). Logging is no longer "MAUI head only". IVenueLocator's impl is VenueLocator, not MauiVenueLocator. Data-Storage The store skeleton now derives from JsonFileStore<TItem,TCache> instead of hand-rolling gate/cache/load/save, with a table of the three optional overrides and a note that the per-singer write rule is enforced by the base rather than remembered. Conventions Same for the "local store" skeleton. Clients-Library Contracts moved to Abstractions/Clients/; this library is vendor folders only (Enrichment/ -> Apple/, and the JSON helpers moved to Common). Building-and-Testing The test projects reference projects now; the ~56 linked <Compile Include> items are gone. Every `KHost.Mobile*/…` path named across these pages was checked against the repo; seven no longer resolved and were corrected. The user-facing pages are untouched: this refactor changed structure only, no on-screen behaviour, and those pages must be verified against the running app rather than the source.

    @riddlemd riddlemd committed Jul 27, 2026
  • Drop the Roadmap page and the future-server framing The planned online slice was documented in enough detail to read as imminent — it isn't built and isn't close, so it was setting an expectation the app doesn't meet. The page is gone along with every inbound link (Home, sidebar, Architecture, Clients library, Privacy). The remaining hedges went with it: Privacy's "Looking ahead" section, Getting started's "can't (yet) put you in a live queue", and the "today"/"planned but not built" qualifiers throughout now read as plain present tense. The app is local — that's the whole story, not an interim state. Also fixes a garbled sentence in Clients library that the sweep exposed, where a Roadmap cross-reference had been spliced mid-clause.

    @riddlemd riddlemd committed Jul 27, 2026
  • Add the KHost Cue wiki

    @riddlemd riddlemd committed Jul 27, 2026