[mbeczynski]

Fixes from the 21.10 code review (state 695114c). Each finding was first confirmed in the code.

App

• Stuck race loading: the player's car is exempt from the in-race load hold and is loaded on demand. Before the fix, picking a not-yet-loaded car in the garage, once six other cars were loaded, left the loading screen spinning forever. A failed load now shows a message with "Try again" instead of the placeholder model. The loading screen has a Menu button and a 60 s limit, and its waits end when the screen is left.
• Audio interruptions: when a call, the alarm or Siri interrupts the game, sounds stop, so nothing plays on the stopped engine (it raised an exception) and the race pauses. Media-services reset is handled. Returning from the background resumes the same music track.
• Rewards on the finish line: stars and coins are saved when the player finishes, not when the results appear 3 s later.
• Background during loading: the race is paused once it is revealed.
• Track build error: countdown and engine sound no longer run under the error screen.
• Saves: a campaign save that cannot be read is backed up before a new game overwrites it. An unknown car no longer resets the whole profile.
• Menu frame stats: the per-frame stats (Debug/Family) no longer grow for the whole session.

RaceCore

• Campaign save format: new version field and a tolerant decoder. Missing fields get defaults and unknown upgrades are skipped; the encoded format is unchanged apart from version.
• Collisions:
  • Only the player can cause a takedown. A rival hitting the player, or another rival, exchanges speed instead of boosting the player to 90% of the rival's speed.
  • The restart after a wreck ramps up over 0.3 s instead of jumping to 12 m/s in one step.
  • Walls, canister pickups and near misses use each car's own size.
  • AI and auto-steer steer around wrecked cars ahead.
• Rival stats: based on a fixed template, not on the catalog's starter car.

CI and README

• CI builds the Family and Release configurations.
• README no longer claims that CI runs the UI tests. They need the local models and a GPU-backed simulator, so they run locally.

Tests

• swift test: 79 tests, 0 failures (65 before; the new tests failed on the old code).
• New LoadingUITests: car picked before it loaded, failed car load, backgrounding during loading. The stuck-loading test hangs on the old code (over 100 s) and starts the race in 2.8 s with the fix.
• Full XCUITest on the iPad (A16), iOS 27.0 simulator, from a clean install: 13/13 passed. This covers all 40 tracks, every car to the finish, every car × 3 colours, gameplay and loading. No crash reports.
• Debug, Family and Release builds pass.

Not changed: the store/demo model (a product decision), the memory and rendering items (B11–B14), test isolation (T2).

🤖 Generated with Claude Code