Record where the catalogue lookup ordering now lives
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.
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.
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.
Document the venue catalog QR code Venues gains the Show QR Code option; Privacy states the code is drawn on the device (no upload, no QR web service); UI components and the service inventory cover QrCodeSheet and IQrCodeService. Examples use the 012345 placeholder venue id — no real venue id or scannable code is published.
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.
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.
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.
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).
Correct the version-parsing story after VersionTag moved Clients-Library still named TryParseVersion, the method that used to hang off GitHubReleaseParser. It is now VersionTag.TryParse in GitHub/VersionTag.cs, and internal on purpose — a release tag is a GitHub convention and nothing else in the app produces one. Also spells out why there are two version parsers and why they differ, since "these look the same, merge them" is the obvious next thought: VersionTag (Clients/GitHub, internal) strips a leading v AND a suffix AppVersion (Infrastructure/Logic) strips a suffix, NOT a leading v AppVersion reads ApplicationDisplayVersion, where a suffixed versionName is ordinary on an Android dev build (refusing one silently disables the update check there) but a "v" prefix would be invalid for iOS CFBundleShortVersionString. The two-line overlap stays duplicated because VersionTag is internal to Clients, which sits below Infrastructure — sharing it would invert the layering. Architecture's Logic/ listing gains AppVersion.
VersionTag moved out of Common into the GitHub backend It normalizes GitHub release tags (v0.4.0-beta.1) and nothing else produces one, so it now sits internal beside GitHubReleaseParser. Common is back to one file.
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.
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.
Add the KHost Cue wiki