Skip to content

History / Conventions

Revisions

  • Correct the profile-import and code-behind rules for 0.15.0 Add as a new singer always adds now, so the page's claim that re-importing your own backup updates that singer instead of duplicating them was wrong. The two contributor pages still described single-file components with an @code block, which is now a rule violation, and the Async suffix has a reflection test behind it. Note the in-app route to the privacy policy, new in this release.

    @riddlemd riddlemd committed Aug 20, 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
  • 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
  • Logging in Clients is absent, not forbidden Reword the Architecture, Conventions and Clients-Library notes to state where logging currently lives rather than prohibiting it from the Clients library; drop it from the library-contract bullet.

    @riddlemd riddlemd committed Jul 27, 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
  • 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
  • Add the KHost Cue wiki

    @riddlemd riddlemd committed Jul 27, 2026