Music screen action row gains 'smart dj': a menu that builds and plays a mix
from the current track (SIMILAR_TO_TRACK), the hearted favorites, or the most
played tracks via CloudMixService (local-first, cloud-enhanced).
- DoradoMediaNotificationProvider: dedicated public low-importance channel,
compact transport from the session command layout, album art via a caching
session bitmap loader (async re-post), content intent to the app; wired via
setMediaNotificationProvider + CacheBitmapLoader(SimpleBitmapLoader).
- Robolectric provider test builds a real session notification.
- Goldens: the fixed 900ms virtual advance rendered blank frames under load;
replaced with a settle loop (100ms steps until idle) and actual-frame dumps
on mismatch. fan-prediction's device id now derives from AppClock instead of
a random UUID so entry frames are deterministic. Two full executions green
(1,488 tests).
- TapRenderersFactory installs TeeAudioProcessor into the audio sink so
VisualizerBus mirrors rendered PCM into a mono ring buffer (no RECORD_AUDIO
permission; buffers pass through untouched).
- SpectrumBands: log-spaced band mapping, sqrt perceptual scaling, per-frame
peak-hold decay (pure, unit-tested).
- SpectrumVisualizer accepts live levels and falls back to the procedural
animation before the first window; Now Playing polls per frame and resets
the bus on pause.
- Tests include an end-to-end PCM-tap integration test. Suite 1487/1487.
- FadeRamp.kt: pure linear ramp math (window, steps, bounds) with tests.
- PlaybackController: live crossfade setting provider; tail fade-out via the
position ticker, fade-in on AUTO transitions, quick fade for manual skips,
pause resets volume; sleep timer with remaining StateFlow that fades out and
pauses on expiry; countdown surfaced in the Now Playing status OSD.
- Settings ▸ playback: crossfade off/2/4/6/8 s and sleep timer
off/15/30/45/60/90 min (persisted; canon §10 labelled as extensions).
- Canon §10 + roadmap M6/M10 updated.
Scans the external decompiled corpus and reports per-app framework/GL
classification plus the Zune framework families each app uses. Writes a
prose-only summary for dorado-emu docs.
Adds zune-homebrew-pack-v1, zune-Stuff, zune-4.8-beta-2098,
hexic-for-zune-hd and zune-firmware-x-86 to the mirrored categories with
a dedicated --stage intake, and merges per-item results into the shared
_mirror-report.json instead of overwriting prior runs.
- AppClock seam: production reads the system clock; tests freeze it. All
app seeds/time reads route through it, so entry frames are deterministic.
- GoldenCaptureTest now covers every app at device 480x272 and adaptive
landscape (126 goldens) with the clock frozen at 2024-06-15T12:34Z; the
four clock-screen exclusions are gone.
- Checklist regenerated (goldens 126/126, flow crawl 63/63).
- Audit §8 records the Track A hardening results. 1,477/1,477 tests.
- AppTouch.kt: appTap (clickable with null indication: TalkBack click action,
always-latest lambda, no Material ripple), appHold (press/release with an
accessible click), appDescription (screen-reader summaries for boards and
readouts).
- Converted button/row/tab controls across the catalog; positional board
taps and drags stay raw but now carry board state descriptions; 3D hosts
describe mode/score.
- Six entry menus gained verticalScroll because the new semantics exposed
zero-height rows at the adaptive canvas (previously untappable).
- Goldens re-recorded for the six layout-affected screens.
1410/1410 tests; ui_lint clean; LayoutBounds 126/126; flow crawl 63/63.
- CI now runs lintDebug, tools/ui_lint.py and a py_compile check on the
corpus tools after the unit/UI suites.
- tools/emulator_flow_crawl.py drives each app's primary flow (element taps
by text bounds since pointerInput controls lack click semantics), then
backgrounds/relaunches and cold-restarts it, scanning logcat per step.
Baseline: 63/63, 0 crashes (reports/emulator/flows/, git-ignored).
- tools/ui_lint.py + DesignInvariantTest guards: MiniSynth must start,
pointerInput(Unit) must be reviewed, sub-screens must forward onBack, IME
wiring must exist. The synth rule immediately caught ColorSpill,
Supernova and Tiles shipping silent SFX — fixed.
- docs/ui-parity-checklists.md: 63-app coverage (spec/smoke/bounds/golden/
crawl, zero open gaps).
- 1,410/1,410 tests; lint green.
For every app at adaptive portrait and landscape, no clickable semantics
node may sit entirely outside the viewport unless it has a scrollable
ancestor. 126/126 green — the off-screen-control class from the audit is
closed for tappable (clickable-semantics) UI.
- GoldenCaptureTest (ParameterizedRobolectric + native graphics) captures
each app's entry screen at device size 480x272 and compares within a
per-channel tolerance; goldens recorded to app/src/test/goldens (880KB).
- The goldens directory is a declared test input so CI re-runs on change;
-Dgolden.update=true re-records after intentional visuals.
- Harness root tagged for exact-canvas capture.
Verified: corrupted golden fails, restored golden passes.
- BackContractTest proves system back returns from a game sub-screen to its
in-app menu (checkers records, hexic difficulty).
- Fix the class of sub-screens that declared an onBack parameter but never
passed it to DetailScaffold (checkers/chess records+learn, trash throw
about, bowling records, hexic difficulty), so the H-01 contract applies.
1221/1221 tests green.
- fan-prediction: duplicate offline banner removed.
- audiosurf: ride rows 46dp so artist lines are not clipped.
- shuffle by album: transport wraps (FlowRow) so 'shuffle' is readable.
- sudoku/reversi: duplicate in-content headings removed (H-13).
- weather: condition glyph clipped so no stroke bleeds into neighbours.
- DetailScaffold now routes hardware back through its in-app onBack (the
header contract), so sub-screens no longer exit the whole mini-app; the
context menu/prompt intercepts back to dismiss (H-01, H-02/03).
- ContextMenuOverlay anchored bottom-center inside a full-size Box (menus no
longer render over the cropped header); PromptPanel resets per request so
nested prompts no longer inherit the previous text (H-02/03).
- Root imePadding + windowSoftInputMode=adjustResize keep text fields above
the keyboard (H-04).
- Wake shade on ON_STOP instead of ON_PAUSE: permission dialogs and
deep-link relaunches no longer raise the unlock shade (H-07).
- Checkers/Chess/Hexic start MiniSynth so game SFX actually play (H-10).
Full suite 1150/1150 (includes 63-app smoke suite).
Launches every registry app via the debug deep link, screenshots it, and
reports crashes (filtered to the app package) and blank screens. Baseline
run: 63/63 launch, 0 crashes, 0 blanks. Screenshots + JSON land in
git-ignored reports/emulator/.
Every registered mini-app renders through the real host path at device
480x272, adaptive portrait and adaptive landscape with a non-empty
semantics tree and no composition crash. ParameterizedRobolectricTestRunner
keeps Robolectric active per parameter; the harness provides the
MenuController the real root injects. 63/63 green.
- Add ui-test-junit4/ui-test-manifest (test classpath) and enable
unitTests.includeAndroidResources; pin Robolectric sdk=34.
- Debug-only deep link dorado://app/<slug> (release ignores) for automation.
- TestDoradoApp disables the app-level Media3 connect, which cannot bind
under Robolectric; DoradoApp is open with an autoConnectPlayback flag.
- MiniAppTestSupport: real app graph + real host path (MiniAppScreen) inside
DoradoTheme/DeviceCanvas at DEVICE 480x272, PORTRAIT 400x800 and
LANDSCAPE 800x360; MiniAppHarnessTest proves it renders.
- Canon §8 now enumerates all 62 implemented packages by category with the
provenance rule (re-derived behavior, re-authored content).
- README counts and the mini-app section describe the full 62-app matrix,
the engine3d core and the dead-service local UIs.
- Parity roadmap gains §9 (M16 program record: waves, evidence, gates,
known deltas, corpus acquisition results).
- Audit/gaps regenerated: 55 native + 7 dead-service shells, zero unmapped
catalog rows.
- Lint: replace unused BoxWithConstraints scopes with Box (8 apps) and read
the locale from LocalConfiguration in Animalgrams.
Gates: assembleDebug + test 1086/1086 + lintDebug all green.
A resumed mirror was blocked because the pre-flight summed every item,
including the 48 GB already verified on disk. The gate now subtracts present
files and reports total vs still-missing; the full archive (70 items,
51.4 GB) then completed with 0 failures.
Email, Facebook, Twitter, Messenger, Weather, MSN Money, Zune Reader and
Zune Social rebuilt from the decompiled screen inventory as offline local
surfaces (simulated content, clearly labelled): mail chooser/inbox/viewer/
composer with validation, the Facebook pivot shell with composer and
threads, the Twitter timeline/replies/favourites/DM shell with 140-char
compose and @-to-DM retargeting, the Messenger presence/thread/roster hub,
paged city weather with a deterministic forecast model, Money
watchlist/markets/converter/articles, the Reader library/pagination/TOC/
bookmarks with original sample text, and the Social memorial card.
Pure-Kotlin models (EmailModel, FacebookModel, TwitterModel, MessengerModel,
WeatherModel, MoneyModel, ReaderModel) with persistence via appState; 55 new
tests. Registry migrated to the new *App() names. Full suite 1086/1086.
- echoes: deterministic arena with input-path echo replay, 12 original maps,
five modes, power-up table, achievements, lives/invulnerability.
- labyrinth: engine3d tilt-marble with swept physics, 116 seed-generated
mazes across five acts + bonus, checkpoint rewind, par stars.
- audiosurf tilt: AudioFeatures-driven deterministic courses (Normal/Hard/
Visualizer), lane steering, chain/perfect scoring, exact medal fractions.
- lucky lanes bowling: deterministic pin physics, full 10-frame scoring,
Exhibition/Blackjack/Golf, five original lanes and 3D lane rendering.
- pgr ferrari: fixed 30 Hz sim (torque/gears/grip/drag/downforce), three
spline circuits, 4-car AI, full kudos catalogue + combo/stash, 12-event
career and garage economy, engine3d city rendering.
- vans sk8: paraboloid pool physics, swipe trick table, grinds with balance,
combo/multiplier rules, 12 events, 27 achievements, engine3d bowl.
All six registered and catalog-wired; audit regenerated. ~250 new tests;
full suite 1032/1032 green.
- 3d picture puzzle: engine3d OpenGL board with 3x3/4x4 grids, one/two-sided
play (single shared empty slot model), generated 7-category artwork via
PuzzleTextures, ray-picked tiles, flip/hint/timer and per-config best times.
- dr optics: pure-Kotlin 2D optics tracer (mirrors, arcs, polygons, lenses,
Snell + TIR) with 41 authored levels and the 6/16/20/24 unlock ladder.
- finger physics: shared sequential-impulse Physics2d solver (circles + OBBs,
joints, explosions, gravity variants) with 10 modes x 9 authored levels.
- tiki totems: physics block-removal with 13 packs x 8 authored levels.
- fingerpaint: stroke model with undo/redo/eraser/RDP + local pass-and-play
draw-and-guess rounds (original networked play replaced by local mode).
All 5 registered and catalog-wired; audit regenerated. 69 new tests; full
suite 872/872 green (DesignInvariantTest included).
Phase 2 infrastructure for the 3D official titles:
- Math3d: pure-Kotlin Vec3/Mat4 (column-major, inverse/normal matrices),
Camera3d with NDC ray construction, ray/sphere and ray/plane intersection.
- Mesh3d: procedural box/plane/cylinder/quad builders with bounds for picking.
- Scene3d: tagged nodes, materials (flat/textured/unlit/emissive), directional
light, ambient, fog, bounding-sphere picking and ground picking.
- GlSceneView: GLSurfaceView renderer (cached mesh/texture uploads, context-
loss safe) plus a Compose AndroidView host with tap-to-pick; no third-party
dependency, all geometry/textures authored in code.
- Engine3dTest: 11 pure-JVM tests for matrix/ray/pick/mesh invariants.
Full suite 803/803 green.
- hearts: Standard/Wildcard/Turbo modes, shoot-the-moon, passing rotation
(Left/Right/Across/None) with simultaneous passing, first-trick point ban,
Easy/Hard AI, 100-point games, autosave; stall fixes in the trick loop.
- spades: Easy/Hard bidding and play AI, Nil/Blind Nil (+/-100/200), official
bag-out formula, 500/300 targets, round-history scoreboard, deterministic
one-action-per-state loop (fixes the 'ai playing' stall).
- texas hold 'em: new 6-seat PokerTableEngine with layered side pots, six AI
personalities across Easy/Medium/Hard, pot/blind-aware sizing, seven-event
tournament ladder with bankroll gating and hand history; heads-up hand
ranking APIs preserved for LogicTest.
34 new tests; full suite 437/437 green.
Pure move in the same package: solitaire/sudoku/hexic/reversi and
hearts/spades/checkers/chess/poker each get <Game>Engine.kt and <Game>App.kt;
shared card chrome moves to CardViews.kt (EdgeText/rankLabel/suitGlyph/
PlayerHand/PassPicker widened from private to internal). No behavior change;
330/330 tests green.
- alarm: four-page clock/alarm/sleep/settings flow, minute-match firing with
snooze and 30-min bow-out, source fallback to buzzer, sleep timer with
shake-to-reset via rememberTilt(); existing Room alarm list preserved.
- level: all three instruments on one canvas with 90-degree travel clamps,
0.1-degree readouts and peak-hold memory; shared rememberTilt() replaces
the inline sensor, with a graceful no-sensor state.
- metronome: 40-340 BPM dial with drag, tap tempo, 16-cell accent grid,
beat-count handling; synth clicks.
- chord finder: 12 enharmonic roots x 8 qualities with multiple voicings,
fret-window shift, finger-number dots, built-in metronome.
39 new engine tests; full suite 330/330 green.
Pure move: CalculatorApp, NotesApp, StopwatchApp, MetronomeApp, LevelApp,
ChordFinderApp, ShuffleByAlbumApp, MusicQuizApp, AlarmClockApp, CalendarApp
each get their own file in the same package (private helpers travel with
their app). No behavior change; unblocks parallel fidelity work per app
without shared-file conflicts.
Phase 1 completion: every official package now has a synthesized spec with
screens/flow, rules/scoring/AI, controls, content inventory, implementation
plan and an Assembly!Type.Method citation log. 62 specs / ~9,000 lines;
documentation-first gate is closed.
Notable corpus findings recorded in the specs:
- color-spill is blocked upstream: its marketplace package shares a GUID with
Reversi, so the archive payload is Reversi.exe (register notes + spec gap).
- W2 AI tiers, W3 score/simulation constants, W6 30 Hz deterministic
simulation and content inventories are now pinned for implementation.
No Microsoft content is committed; analysis only.
Phase 2 infrastructure for the official-app program:
- Room v6 app_state table (AppStateEntity/Dao/MIGRATION_5_6) behind
AppStateRepository, wired into the graph for save/resume and board snapshots.
- Sfx.kt: deterministic LCG noise, tone/sweep/noise/arpeggio generators, and a
cached 16-cue SfxBank for games (synthesized only; no sampled audio).
- AppSensors.kt: rememberTilt() accelerometer helper (level, tilt calculator,
motion games).
- OfficialCatalog: the seven dead-service mocks now carry installedIds so the
marketplace resolves them.
- Tests: AppStateStoreTest (round-trip + reopen), SfxTest (determinism,
inventory), OfficialAppsTest (register⇔catalog⇔registry⇔spec gate).
186/186 unit tests green (JDK 21).
Phase 1 of the official-app reimplementation program:
- tools/app_mine.py: batch-decompiles the external corpus with ilspycmd,
emits per-app indexes (types/methods/strings/constants/content with PNG
dimensions and XNB headers), generates spec skeletons, and regenerates the
audit matrix + machine-readable gaps register.
- docs/official-apps.json: the 62-package register (slug/title/exe/category/
corpusDir/installedId/status/wave/spec) that drives tooling and tests.
- docs/apps/: a behavioral spec per package (documentation-first gate).
- docs/official-apps-audit.md + official-apps-gaps.json: tracked matrix.
61/62 packages mined (weather is a dead service with no shipped package). No
Microsoft content is committed; counts and synthesized analysis only.
Phase 0 of the official-app reimplementation program:
- zune_archive_mirror.py: staged, resumable, checksum-verified mirror of the
Zune Archive (70 items, 51.4 GB pre-flight) into an external untracked dir,
with a capacity gate, --root override, and per-item manifests.
- zune_app_corpus.py: extracts the 61 decompiled official-app ZIPs and
verifies every file against the published hashes.txt (7843/7844 ok; the
one miss, sudoku Database.xml, is absent upstream).
No Microsoft content is committed; both scripts write to the external corpus
only.
- Add scripts/reconstruct_nk_modules.py to rebuild the kernel-only modules
(zcstfs.dll, keyvault.dll, DwXfer.dll, zcblock.dll, zpartstream.dll) from
NK.bin into the external corpus.
- Update the module inventory and API reference: 114/114 modules, 67,399
functions decompiled, 4,236 exports.
- Correct the ZCP inventory and asset notes: the payload is a ZCSTFS volume
(plaintext for the runtime), and marketplace keys are per-package AES keys
unwrapped from an RSA-2048 blob by a device-provisioned keypack.
Document the follow-up fixes that were listed but not applied in the first
pass, update the deferred register (fling cap, visualizer and eager
device-link items are done), and add close-out on-device evidence.
Radio actions move onto the dial so the station list gets a full-height
region; Device Link becomes a LazyColumn (keyed device/pending items) and
long titles crop at their column instead of overlapping 'copy back'.
- Fling velocity cap scales with the adaptive density multiplier so it no
longer shrinks on scaled layouts (device-mode behavior unchanged).
- Adaptive scale ceiling 2.1 -> 2.6 for tablets/foldables.
- Visualizer reads phase in the draw scope (no per-frame recomposition)
and the 60s loop is seamless (integer harmonics over 2pi).
- Screensaver drift expressed in dp instead of raw px.
Glance 1.2 has no URI-based ImageProvider, so the updater decodes a
128px PNG off-main and the widget renders it beside title/artist/album;
declared size raised to 110dp/2 cells with description and preview image;
removed the dead legacy albumArtUri helper.
John Smith