feat: complete phone onboarding and provision the demo ride

.gitignore

@@ -73,6 +73,7 @@ user_config.json
 !specs/vectors/*.gpx
 # ...and the iOS companion's bundled GPX import fixture (three OBCKit tests load it).
 !companion-ios/Packages/OBCKit/Sources/OBCMock/Fixtures/sample-import.gpx
+!companion-ios/Packages/OBCKit/Sources/OBCFormats/Resources/grimsel-pass.gpx
 # ...and the captured route-import provider exports, the canonical copy of the same bytes.
 !fixtures/sources/route-import/*.gpx
 !fixtures/sources/kandel-ride/*.gpx

builder/app/dev-harness/ride-library.ts

@@ -62,6 +62,7 @@ function loopRide(
     const distanceM = Math.round(radiusDeg * 111_000 * 2 * Math.PI * 1.2);
     return {
         version: 6,
+        isDemo: false,
         effortLimits: { maxHrBpm: null, ftpW: null },
         name,
         startTime,

builder/app/dev-harness/simulated-device.svelte.ts

@@ -284,6 +284,7 @@ function syntheticRide(name: string, startTime: number, points: number, sensors:
     }
     return {
         version: 6,
+        isDemo: false,
         effortLimits: { maxHrBpm: null, ftpW: null },
         name,
         startTime,

builder/app/src/lib/device/library.test.ts

@@ -84,6 +84,7 @@ function rideObject(name: string, startTime: number, points = 24): RideObject {
     }
     return {
         version: 6,
+        isDemo: false,
         effortLimits: { maxHrBpm: null, ftpW: null },
         name,
         startTime,

builder/app/src/lib/device/rides.test.ts

@@ -95,6 +95,7 @@ function rideFromTrackLog(log: Uint8Array, name: string, startTime: number): Rid
     }
     return {
         version: 6,
+        isDemo: false,
         effortLimits: { maxHrBpm: null, ftpW: null },
         name,
         startTime,
@@ -132,6 +133,7 @@ function longRide(points: number): RideObject {
     }
     return {
         version: 6,
+        isDemo: false,
         effortLimits: { maxHrBpm: null, ftpW: null },
         name: "Long Way Round",
         startTime: 1_783_598_400,
@@ -231,6 +233,7 @@ describe("the ride object", () => {
         const ride = decodeRideObject(bytes);
         expect(ride).toMatchObject({
             version: 6,
+            isDemo: true,
             name: "Sensor Ride",
             startTime: 1_751_460_000,
             distanceM: 12_345,
@@ -262,6 +265,17 @@ describe("the ride object", () => {
         expect(encodeRideObject(ride)).toEqual(bytes);
     });
 
+    it("keeps ordinary rides unmarked and rejects reserved footer flags", () => {
+        const bytes = encodeRideObject(longRide(1));
+        const flags = bytes.length - 154 + 33;
+        expect(bytes[flags]).toBe(0);
+        expect(decodeRideObject(bytes).isDemo).toBe(false);
+        for (const reserved of [2, 0x80, 0xff]) {
+            bytes[flags] = reserved;
+            expect(() => decodeRideObject(bytes)).toThrow("non-canonical summary footer");
+        }
+    });
+
     it("keeps a zero elevation as the device's 'no barometer yet' value", () => {
         const ride: RideObject = {
             ...longRide(1),

builder/app/src/lib/usb/objects.ts

@@ -75,6 +75,8 @@ export interface RideEffortLimits {
 /** A downloaded v6 ride: the recorded sample bytes followed by one fixed summary footer. */
 export interface RideObject {
     version: 6;
+    /** Synthetic onboarding ride; preserved with the recorded payload. */
+    isDemo: boolean;
     name: string;
     startTime: number;
     distanceM: number;
@@ -110,7 +112,8 @@ export function decodeRideObject(data: Uint8Array): RideObject {
     const version = data[footer + 4];
     if (version !== 6) throw new ObjectDecodeError(`ride object version ${version}; this client decodes 6.`);
     const limits = footer + RIDE_LIMITS_AT;
-    if (view.getUint16(footer + 6, true) !== RIDE_FOOTER_LEN || data[footer + 33] !== 0 || data[limits + 1] !== 0) {
+    const flags = data[footer + 33];
+    if (view.getUint16(footer + 6, true) !== RIDE_FOOTER_LEN || (flags & ~1) !== 0 || data[limits + 1] !== 0) {
         throw new ObjectDecodeError("ride object has a non-canonical summary footer.");
     }
     const name = footerName(data, footer + RIDE_NAME_AT, data[footer + 5]);
@@ -149,6 +152,7 @@ export function decodeRideObject(data: Uint8Array): RideObject {
 
     return {
         version: 6,
+        isDemo: (flags & 1) !== 0,
         points,
         name,
         startTime: view.getUint32(footer + 8, true),
@@ -210,6 +214,7 @@ export function encodeRideObject(r: RideObject): Uint8Array {
     out[footer + 30] = r.avgHr ?? NO_U8;
     out[footer + 31] = r.maxHr ?? NO_U8;
     out[footer + 32] = r.avgCadence ?? NO_U8;
+    out[footer + 33] = r.isDemo ? 1 : 0;
     view.setUint16(footer + 34, r.avgPower ?? NO_U16, true);
     view.setUint16(footer + 36, r.maxPower ?? NO_U16, true);
     view.setUint32(footer + 38, r.energyKj ?? NO_U32, true);

companion-ios/OBCCompanion/OBCCompanion.entitlements

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>com.apple.developer.associated-domains</key>
+	<array>
+		<string>applinks:openbikecomputer.com</string>
+	</array>
+</dict>
+</plist>

companion-ios/OBCCompanion/OBCCompanionApp.swift

@@ -67,6 +67,8 @@ struct OBCCompanionApp: App {
             RootView(
                 transport: Self.makeTransport(),
                 bondStore: Self.makeBondStore(),
+                onboarding: Self.makeOnboardingProgress(),
+                updateChecker: Self.makeSetupUpdateChecker(),
                 library: Self.makeLibraryStore(),
                 photoLibrary: Self.makePhotoLibrary(),
                 lastBikeType: Self.makeLastBikeTypeStore(),
@@ -257,6 +259,20 @@ struct OBCCompanionApp: App {
         return PathMonitorReachability()
     }
 
+    static func makeOnboardingProgress() -> OnboardingProgress {
+        #if DEBUG
+        if mockControl != nil { return OnboardingProgress() }
+        #endif
+        return OnboardingProgress(defaults: .standard)
+    }
+
+    static func makeSetupUpdateChecker() -> UpdateChecker? {
+        #if DEBUG
+        if let mockControl { return OnboardingFixtures.updateChecker(for: mockControl.scenario) }
+        #endif
+        return UpdateChecker()
+    }
+
     /// The bond record behind the launch branch. Mock runs read it from the scenario, so the dev
     /// panel can replay first-run pairing; the real path persists it in `UserDefaults`.
     static func makeBondStore() -> any BondStore {