signalk-wakelogger 0.2.0-beta.5 → 0.2.0-beta.6

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 Updates for boat owners and crew: what's new, what's improved, and anything you need to do.
 
+## [0.2.0-beta.6] - 2026-09-26
+
+### Onboard race planning matches Wake Logger exactly
+
+- The onboard planner now starts the current leg from your boat's actual position, uses the real current in its speed and arrival estimates, and no longer assumes a fixed six-knot midpoint speed. Remaining distance and arrival times reflect where you actually are.
+- Onboard wind is only used for the current leg once a genuine five-minute observation window is ready (30 good samples across at least four minutes, newest within 30 seconds). Until then the downloaded forecast is used, with a clear note.
+- A downloaded course is only used when its course definition matches the Race Pack, so an edited course can't be planned against an old pack. Reversed courses are not planned rather than being calculated the wrong way round.
+- Wake Logger cloud now calculates the remaining race with exactly the same rules as the onboard planner, so the two agree. Raw instrument samples are aggregated with the same method on both sides, and the Live tracking ON and OFF views show the same plan and sail recommendation.
+
+### Reliable Race Pack and race-plan hand-over
+
+- A removed or archived course now clears the onboard Race Pack durably, so a stale copy can't reappear after a restart or reconnect.
+- Onboard race-plan updates are only removed once Wake Logger confirms it stored them; if the confirmation is missed they are sent again after reconnecting or restarting.
+- Onboard race-plan updates now carry the recording session they came from, so Wake Logger links them to the right outing even when they arrive late.
+- Switching Live tracking off sends one final onboard status and then stops transmitting immediately. The final onboard status is kept by the server after the plugin disconnects, and an unexpected connection loss still reports the vessel offline.
+- Added a production-like broker test (`npm run test:broker:dynsec`) that runs against a real Mosquitto dynamic-security broker and the Wake Logger cloud provisioning/framing functions.
+
 ## [0.2.0-beta.5] - 2026-09-16
 
 ### Live tracking when you want it

package/README.md

@@ -55,6 +55,8 @@ Open the **Wake Logger webapp** from Signal K's Web Apps list, using a phone, ta
 
 The onboard map uses the same instrument styling as Wake Logger's live view, adapts to phone and tablet screens, and includes a full-screen view. It shows the complete course, your boat, the next mark and current leg. Distance, bearing, cross-track error, VMG and arrival estimates appear when Signal K can calculate them; unavailable readings are left clearly marked.
 
+Alongside the map, the webapp shows an **onboard race plan**. While **Live tracking** is on, Wake Logger cloud calculates the remaining race: it starts the current leg from your boat's actual position, samples the downloaded forecast at each leg's estimated time, and accounts for current, so the suggested heading, sail plan and arrival estimate keep up with how the race is actually going. When **Live tracking** is off, the vessel performs the same calculation on board from the Race Pack synchronised before departure, so the plan is still available with no internet access. If no Race Pack has synchronised yet, the map and course still work and the plan is clearly marked as unavailable.
+
 Use **Advance point** to move to the next course point, or select a point and choose **Set point** to correct your progress. Progression is manual in this release: it does not automatically judge start-line crossings, mark roundings, gates or finishes.
 
 Your course is also available as a standard Signal K route for other onboard applications. If another app selects a different active route, Wake Logger shows that state. Choose **Activate Wake Logger course** when you want to return to it.

package/dist/config/defaults.d.ts

@@ -15,5 +15,6 @@ export interface PluginConfig {
     maxOutboxMb: number;
     maxOutboxDays: number;
     debugTelemetry: boolean;
+    raceProgressionMode: 'auto' | 'suggest' | 'off';
 }
 export declare function parseConfig(value: object): PluginConfig;

package/dist/config/defaults.js

@@ -22,7 +22,8 @@ function parseConfig(value) {
         samplePeriodMs: boundedNumber(input.samplePeriodMs, exports.DEFAULTS.samplePeriodMs, 250, 60_000),
         maxOutboxMb: boundedNumber(input.maxOutboxMb, 250, 10, 4096),
         maxOutboxDays: boundedNumber(input.maxOutboxDays, 7, 1, 30),
-        debugTelemetry: input.debugTelemetry === true
+        debugTelemetry: input.debugTelemetry === true,
+        raceProgressionMode: input.raceProgressionMode === 'suggest' || input.raceProgressionMode === 'off' ? input.raceProgressionMode : 'auto'
     };
 }
 function boundedNumber(value, fallback, min, max) {

package/dist/config/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":";;;AAoBA,kCAcC;AAlCY,QAAA,QAAQ,GAAG;IACtB,aAAa,EAAE,gDAAgD;IAC/D,cAAc,EAAE,IAAI;IACpB,SAAS,EAAE,EAAE;IACb,eAAe,EAAE,EAAE,GAAG,IAAI;IAC1B,cAAc,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;IACjC,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IACvC,YAAY,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;CACrB,CAAA;AAYV,SAAgB,WAAW,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,KAAgC,CAAA;IAC9C,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,UAAU,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW;QAC1E,WAAW,EAAE,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;QACrH,aAAa,EACX,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;YAChF,CAAC,CAAC,KAAK,CAAC,aAAa;YACrB,CAAC,CAAC,gBAAQ,CAAC,aAAa;QAC5B,cAAc,EAAE,aAAa,CAAC,KAAK,CAAC,cAAc,EAAE,gBAAQ,CAAC,cAAc,EAAE,GAAG,EAAE,MAAM,CAAC;QACzF,WAAW,EAAE,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC;QAC5D,aAAa,EAAE,aAAa,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3D,cAAc,EAAE,KAAK,CAAC,cAAc,KAAK,IAAI;KAC9C,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,QAAgB,EAAE,GAAW,EAAE,GAAW;IAC/E,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;AAC/G,CAAC"}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":";;;AAqBA,kCAeC;AApCY,QAAA,QAAQ,GAAG;IACtB,aAAa,EAAE,gDAAgD;IAC/D,cAAc,EAAE,IAAI;IACpB,SAAS,EAAE,EAAE;IACb,eAAe,EAAE,EAAE,GAAG,IAAI;IAC1B,cAAc,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;IACjC,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IACvC,YAAY,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;CACrB,CAAA;AAaV,SAAgB,WAAW,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,KAAgC,CAAA;IAC9C,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,UAAU,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW;QAC1E,WAAW,EAAE,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;QACrH,aAAa,EACX,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;YAChF,CAAC,CAAC,KAAK,CAAC,aAAa;YACrB,CAAC,CAAC,gBAAQ,CAAC,aAAa;QAC5B,cAAc,EAAE,aAAa,CAAC,KAAK,CAAC,cAAc,EAAE,gBAAQ,CAAC,cAAc,EAAE,GAAG,EAAE,MAAM,CAAC;QACzF,WAAW,EAAE,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC;QAC5D,aAAa,EAAE,aAAa,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3D,cAAc,EAAE,KAAK,CAAC,cAAc,KAAK,IAAI;QAC7C,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,KAAK,SAAS,IAAI,KAAK,CAAC,mBAAmB,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM;KACzI,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,QAAgB,EAAE,GAAW,EAAE,GAAW;IAC/E,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;AAC/G,CAAC"}

package/dist/config/schema.d.ts

@@ -47,5 +47,13 @@ export declare const configSchema: {
             readonly title: "Enable telemetry debug logging";
             readonly default: false;
         };
+        readonly raceProgressionMode: {
+            readonly type: "string";
+            readonly title: "Mark detection mode";
+            readonly enum: readonly ["auto", "suggest", "off"];
+            readonly enumNames: readonly ["Automatic", "Suggest", "Off"];
+            readonly default: "auto";
+            readonly description: "Automatic advances the active course point when the onboard app detects a rounding, start or finish; it also records evidence for Wake Logger. Suggest asks the crew first. Off records evidence only.";
+        };
     };
 };

package/dist/config/schema.js

@@ -49,6 +49,14 @@ exports.configSchema = {
             type: 'boolean',
             title: 'Enable telemetry debug logging',
             default: false
+        },
+        raceProgressionMode: {
+            type: 'string',
+            title: 'Mark detection mode',
+            enum: ['auto', 'suggest', 'off'],
+            enumNames: ['Automatic', 'Suggest', 'Off'],
+            default: 'auto',
+            description: 'Automatic advances the active course point when the onboard app detects a rounding, start or finish; it also records evidence for Wake Logger. Suggest asks the crew first. Off records evidence only.'
         }
     }
 };

package/dist/config/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":";;;AAAa,QAAA,YAAY,GAAG;IAC1B,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,aAAa;YACpB,IAAI,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;YACjC,SAAS,EAAE,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;YACjD,OAAO,EAAE,WAAW;YACpB,WAAW,EAAE,qIAAqI;SACnJ;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,0BAA0B;YACjC,WAAW,EAAE,qFAAqF;SACnG;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,iBAAiB;YACxB,OAAO,EAAE,gDAAgD;YACzD,OAAO,EAAE,WAAW;SACrB;QACD,cAAc,EAAE;YACd,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,gCAAgC;YACvC,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI;SACd;QACD,WAAW,EAAE;YACX,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,iCAAiC;YACxC,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,GAAG;SACb;QACD,aAAa,EAAE;YACb,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,kCAAkC;YACzC,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,CAAC;SACX;QACD,cAAc,EAAE;YACd,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,gCAAgC;YACvC,OAAO,EAAE,KAAK;SACf;KACF;CACO,CAAA"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":";;;AAAa,QAAA,YAAY,GAAG;IAC1B,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,aAAa;YACpB,IAAI,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;YACjC,SAAS,EAAE,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;YACjD,OAAO,EAAE,WAAW;YACpB,WAAW,EAAE,qIAAqI;SACnJ;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,0BAA0B;YACjC,WAAW,EAAE,qFAAqF;SACnG;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,iBAAiB;YACxB,OAAO,EAAE,gDAAgD;YACzD,OAAO,EAAE,WAAW;SACrB;QACD,cAAc,EAAE;YACd,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,gCAAgC;YACvC,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI;SACd;QACD,WAAW,EAAE;YACX,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,iCAAiC;YACxC,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,GAAG;SACb;QACD,aAAa,EAAE;YACb,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,kCAAkC;YACzC,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,CAAC;SACX;QACD,cAAc,EAAE;YACd,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,gCAAgC;YACvC,OAAO,EAAE,KAAK;SACf;QACD,mBAAmB,EAAE;YACnB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,qBAAqB;YAC5B,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC;YAChC,SAAS,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC;YAC1C,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,wMAAwM;SACtN;KACF;CACO,CAAA"}

package/dist/courses/protocol.d.ts

@@ -11,6 +11,7 @@ export interface ActiveCourseDocument {
     revision: number;
     courseId: string;
     racePlanId?: number;
+    courseDefinitionDigest?: string;
     name: string;
     updatedAt: string;
     start: CoursePoint;

package/dist/courses/protocol.js

@@ -41,13 +41,18 @@ function parseCourse(payload) {
     if (doc.activeWaypointIndex !== undefined && (!Number.isSafeInteger(doc.activeWaypointIndex)
         || doc.activeWaypointIndex < 0 || doc.activeWaypointIndex >= points.length))
         throw new CourseError('course_invalid_point_index');
+    if (doc.courseDefinitionDigest !== undefined && !isDigest(doc.courseDefinitionDigest))
+        throw new CourseError('course_invalid_digest');
     return {
         v: 1, action: 'activate', revision: doc.revision, courseId: doc.courseId, name: doc.name, updatedAt: doc.updatedAt,
         start: point(doc.start), marks: doc.marks.map(point), finish: point(doc.finish),
         ...(Number.isSafeInteger(doc.racePlanId) ? { racePlanId: doc.racePlanId } : {}),
+        ...(isDigest(doc.courseDefinitionDigest) ? { courseDefinitionDigest: doc.courseDefinitionDigest.toLowerCase() } : {}),
         ...(doc.activeWaypointIndex !== undefined ? { activeWaypointIndex: doc.activeWaypointIndex } : {})
     };
 }
+const COURSE_DIGEST = /^[0-9a-fA-F]{64}$/;
+function isDigest(value) { return typeof value === 'string' && COURSE_DIGEST.test(value); }
 function point(value) { return { id: value.id, name: value.name, latitude: value.latitude, longitude: value.longitude, ...(value.notes !== undefined ? { notes: value.notes } : {}) }; }
 function validText(value, maximum) { return typeof value === 'string' && value.trim().length > 0 && value.length <= maximum; }
 function validPoint(value) {

package/dist/courses/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/courses/protocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/courses/protocol.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -7,6 +7,13 @@ const node_path_1 = __importDefault(require("node:path"));
 const course_store_1 = require("./courses/course-store");
 const protocol_1 = require("./courses/protocol");
 const native_course_1 = require("./courses/native-course");
+const progression_service_1 = require("./race/progression-service");
+const progression_store_1 = require("./race/progression-store");
+const observations_1 = require("./race/observations");
+const race_pack_store_1 = require("./race/race-pack-store");
+const race_pack_protocol_1 = require("./race/race-pack-protocol");
+const onboard_store_1 = require("./race/onboard-store");
+const onboard_service_1 = require("./race/onboard-service");
 const history_1 = require("./tracking/history");
 const schema_1 = require("./config/schema");
 const defaults_1 = require("./config/defaults");
@@ -32,6 +39,13 @@ const constructor = (app) => {
     let queueStatsAt;
     let transport;
     let courses;
+    let progression;
+    let racePacks;
+    let racePackReceiver;
+    let observations;
+    let onboardSnapshots;
+    let onboard;
+    let onboardCourse = null;
     let courseInitializationError;
     let courseFailureAcknowledgement;
     let tripState;
@@ -65,7 +79,7 @@ const constructor = (app) => {
             pairingAbortController?.abort();
             associationAbortController?.abort();
             // Stop all transmission immediately when a saved configuration restarts us.
-            const stopping = transport?.stop(false);
+            const stopping = transport?.stop({ publishOffline: false, force: true });
             const previous = initialization;
             const thisGeneration = ++generation;
             initialization = (async () => {
@@ -142,10 +156,11 @@ const constructor = (app) => {
                     await persistTrackingMode(mode, revision, thisGeneration);
                     if (revision === trackingRevision && generation === thisGeneration) {
                         activeUploadMode = mode;
+                        await onboard?.setAuthority(mode);
                         if (mode === 'automatic' && !wasAutomatic) {
                             if (outbox)
                                 await updateHistory(await outbox.stats(), true);
-                            await transport?.stop(false);
+                            await transport?.stop({ publishOffline: false, force: true });
                             connectTransport?.();
                         }
                         await updateStatus();
@@ -181,6 +196,7 @@ const constructor = (app) => {
                     if (!courses)
                         throw new protocol_1.CourseError('no_selected_course');
                     await courses.activate();
+                    await syncProgressionCourse();
                     void transport?.publishCourseAcknowledgement().catch((error) => app.error(`Course acknowledgement deferred: ${safeError(error)}`));
                     response.status(200).json({ ...await courses.status(), uploadMode: activeUploadMode, connectionState });
                 }
@@ -207,6 +223,87 @@ const constructor = (app) => {
                         next(error);
                 }
             });
+            readRouter.get?.('/progression', async (_request, response, next) => {
+                try {
+                    response.status(200).json(progression?.status() ?? { mode: null, revision: 0, activeIndex: 0, pending: null, lastDetection: null });
+                }
+                catch (error) {
+                    next(error);
+                }
+            });
+            writeRouter.post('/progression/mode', async (request, response, next) => {
+                const mode = request.body?.mode;
+                if (mode !== 'auto' && mode !== 'suggest' && mode !== 'off') {
+                    response.status(400).json({ error: 'invalid_progression_mode' });
+                    return;
+                }
+                if (!progression) {
+                    response.status(409).json({ error: 'progression_unavailable' });
+                    return;
+                }
+                try {
+                    await progression.setMode(mode);
+                    response.status(200).json(progression.status());
+                }
+                catch (error) {
+                    next(error);
+                }
+            });
+            writeRouter.post('/progression/resolve', async (request, response, next) => {
+                const body = request.body;
+                if ((body?.resolution !== 'accepted' && body?.resolution !== 'dismissed') || !Number.isSafeInteger(body?.pointIndex)) {
+                    response.status(400).json({ error: 'invalid_resolution' });
+                    return;
+                }
+                if (!progression) {
+                    response.status(409).json({ error: 'progression_unavailable' });
+                    return;
+                }
+                try {
+                    const resolved = await progression.resolve(body.resolution, body.pointIndex);
+                    if (resolved)
+                        response.status(200).json(progression.status());
+                    else
+                        response.status(409).json({ error: 'no_pending_detection', ...progression.status() });
+                }
+                catch (error) {
+                    next(error);
+                }
+            });
+            readRouter.get?.('/race-plan', async (_request, response, next) => {
+                try {
+                    const status = onboard?.status();
+                    response.status(200).json({
+                        ...(status ?? { calculationAuthority: activeUploadMode === 'local_only' ? 'onboard' : 'cloud', lastLocalCalculationAt: null, reason: 'onboard_unavailable' }),
+                        uploadMode: activeUploadMode,
+                        connectionState,
+                        latestSnapshot: onboardSnapshots?.latest() ?? null
+                    });
+                }
+                catch (error) {
+                    next(error);
+                }
+            });
+            writeRouter.post('/race-plan/recalculate', async (_request, response, next) => {
+                try {
+                    if (!onboard) {
+                        response.status(409).json({ error: 'onboard_unavailable' });
+                        return;
+                    }
+                    // Explicit recalculation respects the product authority rule: while
+                    // Live tracking is automatic the cloud is authoritative and an
+                    // onboard recalculation must not run, even if MQTT is offline.
+                    if (activeUploadMode !== 'local_only') {
+                        response.status(409).json({ error: 'cloud_authority', uploadMode: activeUploadMode, ...onboard.status() });
+                        return;
+                    }
+                    const snapshot = await onboard.refresh(true);
+                    response.status(200).json({ calculated: !!snapshot, snapshot, status: onboard.status() });
+                }
+                catch (error) {
+                    next(error);
+                }
+            });
             // Registered directly: unpairing keeps Signal K's admin-only default.
             pluginRouter.post('/forget-credentials', async (_request, response, next) => {
                 try {
@@ -242,6 +339,11 @@ const constructor = (app) => {
                 '/course': { get: { summary: 'Read cached and native course state', responses: { '200': { description: 'Course state' } } } },
                 '/course/map-readiness': { post: { summary: 'Report locally verified chart readiness for a course revision', responses: { '200': { description: 'Readiness saved' }, '409': { description: 'Invalid or stale revision' } } } },
                 '/course/activate': { post: { summary: 'Explicitly activate the selected cached course', responses: { '200': { description: 'Course active' }, '409': { description: 'No selected course or native course unavailable' } } } },
+                '/progression': { get: { summary: 'Read mark detection mode, active point and any pending detection', responses: { '200': { description: 'Progression status' } } } },
+                '/progression/mode': { post: { summary: 'Change mark detection between automatic, suggest and off', responses: { '200': { description: 'Mode saved' }, '400': { description: 'Invalid mode' }, '409': { description: 'Progression unavailable' } } } },
+                '/progression/resolve': { post: { summary: 'Resolve a pending detection as accepted or dismissed for its point index', responses: { '200': { description: 'Resolution recorded' }, '400': { description: 'Invalid resolution' }, '409': { description: 'No matching pending detection' } } } },
+                '/race-plan': { get: { summary: 'Read onboard Race Plan calculation authority, Race Pack state and the latest onboard snapshot', responses: { '200': { description: 'Onboard race plan state' } } } },
+                '/race-plan/recalculate': { post: { summary: 'Request an explicit onboard Race Plan recalculation (local-only authority only)', responses: { '200': { description: 'Recalculation attempted' }, '409': { description: 'Onboard planner unavailable or cloud is authoritative' } } } },
                 '/forget-credentials': {
                     post: {
                         summary: 'Forget Wake Logger credentials while preserving all device outboxes',
@@ -251,6 +353,90 @@ const constructor = (app) => {
             }
         })
     };
+    async function syncProgressionCourse() {
+        if (!courses) {
+            progression?.updateCourse(null);
+            onboardCourse = null;
+            return;
+        }
+        try {
+            const status = await courses.status();
+            progression?.updateCourse({
+                revision: status.cachedCourse?.revision ?? 0,
+                points: status.routePoints ?? [],
+                reverse: status.native?.course?.activeRoute?.reverse === true,
+                activeIndex: status.native?.course?.activeRoute?.pointIndex ?? 0,
+                matches: status.native?.activeMatchesDesired === true
+            });
+            const points = status.routePoints ?? [];
+            onboardCourse = status.native?.activeMatchesDesired === true && status.cachedCourse?.courseId && points.length >= 2
+                ? {
+                    courseId: status.cachedCourse.courseId,
+                    racePlanId: status.cachedCourse.racePlanId ?? null,
+                    courseDefinitionDigest: status.cachedCourse.courseDefinitionDigest ?? null,
+                    activeIndex: status.native?.course?.activeRoute?.pointIndex ?? 0,
+                    totalPoints: points.length,
+                    reverse: status.native?.course?.activeRoute?.reverse === true
+                }
+                : null;
+        }
+        catch {
+            progression?.updateCourse(null);
+            onboardCourse = null;
+        }
+    }
+    function racingUnderway() {
+        if (onboardCourse && onboardCourse.activeIndex > 0 && onboardCourse.activeIndex < onboardCourse.totalPoints)
+            return true;
+        return tripState?.currentState().state === 'MOVING';
+    }
+    async function flushProgressionEvidence() {
+        if (!progression || !transport)
+            return;
+        const pending = progression.pendingEvents();
+        if (!pending.length)
+            return;
+        const published = [];
+        for (const event of pending) {
+            try {
+                if (!await transport.publishEvidence(event))
+                    break;
+            }
+            catch {
+                break;
+            }
+            published.push(event.sequence);
+        }
+        if (published.length)
+            await progression.markPublished(published);
+    }
+    // Onboard snapshots are historical evidence: they only leave the vessel once
+    // Live tracking is restored. A snapshot stays durable until Wake Logger
+    // application-ACKs it; published-but-unacknowledged snapshots are retried.
+    async function flushOnboardSnapshots() {
+        if (!onboardSnapshots || !transport || activeUploadMode !== 'automatic')
+            return;
+        const queue = [...onboardSnapshots.pending(), ...onboardSnapshots.unacknowledged()].slice(0, 5);
+        if (!queue.length)
+            return;
+        const published = [];
+        for (const event of queue) {
+            try {
+                if (!await transport.publishRacePlanSnapshot(event.snapshot))
+                    break;
+            }
+            catch {
+                break;
+            }
+            published.push(event.sequence);
+        }
+        if (published.length)
+            await onboardSnapshots.markPublished(published);
+    }
+    function publishOnboardSnapshot(_snapshot) {
+        if (activeUploadMode === 'automatic')
+            void flushOnboardSnapshots();
+    }
     async function cleanupResources() {
         stopSubscription?.();
         stopSubscription = undefined;
@@ -267,6 +453,17 @@ const constructor = (app) => {
         currentSampler = undefined;
         connectTransport = undefined;
         await sampleOperation;
+        await progression?.close();
+        progression = undefined;
+        onboard?.close();
+        onboard = undefined;
+        await onboardSnapshots?.close();
+        onboardSnapshots = undefined;
+        await racePacks?.close();
+        racePacks = undefined;
+        racePackReceiver = undefined;
+        observations = undefined;
+        onboardCourse = null;
         await courses?.close();
         courses = undefined;
         courseInitializationError = undefined;
@@ -362,6 +559,43 @@ const constructor = (app) => {
             courseInitializationError = safeError(error);
             app.error(`Wake Logger course cache unavailable; telemetry recording continues: ${courseInitializationError}`);
         }
+        const progressionStore = new progression_store_1.RaceProgressionStore(node_path_1.default.join(dataDirectory, 'race-progression', credentials.deviceId, 'state.json'));
+        try {
+            await progressionStore.open();
+            progression = new progression_service_1.RaceProgressionService({ store: progressionStore, defaultMode: config.raceProgressionMode });
+        }
+        catch (error) {
+            progression = undefined;
+            app.error(`Wake Logger mark detection unavailable: ${safeError(error)}`);
+        }
+        await syncProgressionCourse();
+        observations = new observations_1.ObservationCollector();
+        const packs = new race_pack_store_1.RacePackStore(node_path_1.default.join(dataDirectory, 'race-packs', credentials.deviceId));
+        try {
+            await packs.open();
+        }
+        catch (error) {
+            app.error(`Wake Logger race pack store unavailable: ${safeError(error)}`);
+        }
+        racePacks = packs;
+        racePackReceiver = new race_pack_protocol_1.RacePackReceiver({ store: packs });
+        const snapshotStore = new onboard_store_1.OnboardSnapshotStore(node_path_1.default.join(dataDirectory, 'onboard-plans', credentials.deviceId, 'state.json'));
+        try {
+            await snapshotStore.open();
+        }
+        catch (error) {
+            app.error(`Wake Logger onboard plan history unavailable: ${safeError(error)}`);
+        }
+        onboardSnapshots = snapshotStore;
+        onboard = new onboard_service_1.OnboardRaceService({
+            packs,
+            snapshots: snapshotStore,
+            observations,
+            course: () => onboardCourse,
+            racing: racingUnderway,
+            trackingSessionId: () => tripState?.currentState().trackingSessionId ?? null,
+            onCalculated: publishOnboardSnapshot
+        });
         const normaliser = new normaliser_1.TelemetryNormaliser();
         const tripFile = node_path_1.default.join(dataDirectory, 'trip-state.json');
         const trip = new recording_store_1.RecordingStore(node_path_1.default.join(dataDirectory, 'recordings', credentials.deviceId, 'state.json'));
@@ -412,8 +646,11 @@ const constructor = (app) => {
                         void confirmAssociation(credentials, thisGeneration);
                 },
                 onCourse: async (payload) => {
-                    if (courses)
-                        return courses.receive(payload);
+                    if (courses) {
+                        const acknowledgement = await courses.receive(payload);
+                        await syncProgressionCourse();
+                        return acknowledgement;
+                    }
                     let revision = 0;
                     try {
                         revision = (0, protocol_1.parseCourse)(payload).revision;
@@ -423,10 +660,16 @@ const constructor = (app) => {
                     return courseFailureAcknowledgement;
                 },
                 getCourseAcknowledgement: () => courses?.acknowledgement() ?? courseFailureAcknowledgement,
+                onRacePackManifest: async (payload) => racePackReceiver?.acceptManifest(payload) ?? null,
+                onRacePackChunk: async (payload, topicIndex) => racePackReceiver?.acceptChunk(payload, topicIndex) ?? null,
+                getRacePackAck: () => racePackReceiver?.currentAck() ?? null,
                 onRecordingAcks: async (acks) => {
                     sampleOperation = sampleOperation.then(() => trip.acknowledge(acks));
                     await sampleOperation;
                 },
+                onRacePlanSnapshotAcks: async (ids) => {
+                    await onboardSnapshots?.acknowledge(ids);
+                },
                 onMode: (mode) => { if (transport === instance)
                     sampler.updateMode(activeUploadMode === 'local_only' ? 'NORMAL' : mode); },
                 onProfile: async (replacement) => {
@@ -443,7 +686,15 @@ const constructor = (app) => {
         if (activeUploadMode === 'local_only') {
             transport = new mqtt_client_1.WakeLoggerTransport(credentials, selected.store, { profile, onState: () => undefined });
         }
-        stopSubscription = (0, subscriber_1.subscribeToTelemetry)(app, (delta) => normaliser.ingest(delta));
+        stopSubscription = (0, subscriber_1.subscribeToTelemetry)(app, (delta) => {
+            normaliser.ingest(delta);
+            observations?.ingest(delta);
+            if (!progression)
+                return;
+            const fix = normaliser.latestFix();
+            if (fix)
+                progression.fix({ at: Date.now(), ...fix });
+        });
         const sample = async () => {
             if (generation !== thisGeneration)
                 return;
@@ -475,11 +726,12 @@ const constructor = (app) => {
             }, sampler.samplePeriodMs());
         };
         scheduleSample();
-        statusTimer = setInterval(() => void updateStatus(), 10_000);
+        statusTimer = setInterval(() => { void syncProgressionCourse(); void onboard?.refresh(false); void updateStatus(); }, 10_000);
         if (activeUploadMode === 'automatic')
             connectTransport();
         else
             connectionState = 'recording_locally';
+        await onboard?.setAuthority(activeUploadMode);
         await updateStatus();
     }
     async function updateStatus(detail, beginHistory = false) {
@@ -514,6 +766,8 @@ const constructor = (app) => {
             profileRevision: activeProfile?.revision,
             ...transport?.transportMetrics()
         });
+        void flushProgressionEvidence();
+        void flushOnboardSnapshots();
         if (connectionState === 'device_revoked') {
             app.setPluginStatus(`Wake Logger: Device revoked — enter a new pairing code; ${queue}${dropped}${sequence}`);
             return;
@@ -550,9 +804,17 @@ const constructor = (app) => {
         activeUploadMode = 'local_only';
         pairingAbortController?.abort();
         associationAbortController?.abort();
-        const stopping = transport?.stop(false);
+        // Send one bounded retained final status before shutting transmission down.
+        // Its failure cannot prevent the fail-closed local-only transition.
+        const stopping = (async () => {
+            await transport?.publishFinalLocalOnlyStatus().catch(() => undefined);
+            // Graceful end: a DISCONNECT suppresses the retained Last Will so it cannot
+            // overwrite the retained local_only status after the plugin is gone.
+            await transport?.stop({ publishOffline: false, force: false });
+        })();
         currentSampler?.updateMode('NORMAL');
         connectionState = 'recording_locally';
+        void onboard?.setAuthority('local_only');
         return stopping;
     }
     async function persistTrackingMode(mode, revision, thisGeneration) {