Skip to content

History / Building and Testing

Revisions

  • Record where the catalogue lookup ordering now lives

    @riddlemd riddlemd committed Aug 19, 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
  • Note the README grid's dark-mode and violet requirement The active singer's colour re-tints the whole chrome, so whoever is active when you attach decides the accent in every shot — a teal or amber singer gives a grid that doesn't match the app's branding, and a set shot across two singers won't match itself. shoot_docs.mjs now refuses to run unless the device is in dark mode on the brand violet.

    @riddlemd riddlemd committed Jul 27, 2026
  • Make Building & testing the single command reference The build and deploy commands existed in three places — AGENTS.md, DEVELOPMENT.md and here — so this page is now the complete one and the repo's two point at it. It wasn't a superset before: the wireless-adb port rotating every session and the emulator's Fast Deployment shipping assemblies but not wwwroot (stale APK plus fresh assemblies kills the Blazor circuit) were only ever written down in DEVELOPMENT.md. Both are here now, with the scratch-folder cleanup script, why the test projects need no MAUI workload, and the Matching/ test files in the coverage list.

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

    @riddlemd riddlemd committed Jul 27, 2026