@mongrov/analytics 0.23.2 → 0.24.0

package/dist/sync/sleep-correction/classify.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Sleep correction — Phase 3 and the night window (sleep-correction port).
+ *
+ * VERBATIM port of ziva_app `packages/ux/helpers/sleepCorrectionLayer.ts` v3.1
+ * (`fix/sleepProcessed`, unchanged db0c58a43 → a611cecca): `computeNightEpochs`,
+ * `parseDateStr`, `classifyBlocks` and every constant. Only the formatting
+ * follows this repo's lint; the logic, order of operations and constants are
+ * the validated ones (END within-30 74% → 88% on the QA study set) and must
+ * not be retuned during the port. The parity harness is the check.
+ *
+ * Timestamps are epoch seconds. Row `date`/`start` strings are the Phase 2
+ * output shape, "YYYY.MM.DD HH:MM:SS" in UTC.
+ */
+export declare const HR_MIN = 40;
+export declare const HR_MAX = 120;
+export declare const EXTEND_AFTER = 7200;
+export declare const LONG_GAP_MIN = 600;
+export declare const LONG_GAP_MAX = 28800;
+export declare const LONG_GAP_HR_FRAC = 0.4;
+export declare const STITCH_GAP_SHORT = 120;
+export declare const STITCH_GAP_MED = 300;
+export declare const STITCH_GAP_LONG = 1200;
+export declare const BLOCK_SEP = 1800;
+export declare const BOUT_MAX_LEN = 1;
+export declare const MORNING_TRIM_FLOOR_MIN: number;
+export declare const MORNING_TRIM_CEIL_MIN: number;
+export declare const FETCH_BEFORE = 21600;
+export declare const FETCH_AFTER = 1800;
+export declare const CONF_FIRMWARE = 0.9;
+export declare const CONF_ENVELOPE = 0.5;
+export declare const CONF_GAP = 0.4;
+export declare const CONF_BOUT = 0.7;
+export declare const END_BASE_PCTILE = 0.2;
+export declare const END_WAKE_MARGIN_BPM = 12;
+export declare const END_WAKE_MARGIN_FRAC = 0.18;
+export declare const END_QUIET_STEPS = 80;
+export declare const END_WAKE_STEPS = 150;
+export declare const END_MIN_TRIM = 1800;
+export declare const END_MIN_SLEEP = 7200;
+export declare const END_WAKE_SUSTAIN = 1200;
+export declare const END_GAP_TOL = 900;
+/**
+ * 'YYYY-MM-DD' night → epoch window [18:00 previous local day, 18:00 local).
+ *
+ * `tzOffsetHours` is the offset in force for THIS night. v3.1 fed it one fixed
+ * device offset; the port's caller derives it per night from the user's IANA
+ * zone (spec: per-night IANA offset), so DST nights land correctly.
+ */
+export declare function computeNightEpochs(nightDate: string, tzOffsetHours?: number): {
+    windowStart: number;
+    windowEnd: number;
+};
+/** "YYYY.MM.DD HH:mm:ss" (UTC) → epoch seconds. v3.1 verbatim. */
+export declare function parseDateStr(d: string): number;
+/** A Phase 2 output row. */
+export interface Phase2Row {
+    date: string;
+    quality: number;
+    start: string;
+    unitLength: number;
+    source: string;
+    confidence: number;
+    session_id: number;
+}
+/** A Phase 3 output row — v3.1's `sleep_processed` row shape. */
+export interface ClassifiedRow {
+    date: string;
+    quality: number;
+    start: string;
+    unitLength: number;
+    source: string;
+    confidence: number;
+    block_type: string;
+}
+export interface VitalSample {
+    kind: string;
+    epoch: number;
+    value: number;
+}
+/**
+ * Bout consolidation + block classification (primary / secondary /
+ * microsleep), the synthetic head/tail trims and the Step 5.6 HR + movement
+ * END refinement. v3.1 verbatim — see the file header.
+ */
+export declare function classifyBlocks(rows: Phase2Row[], tzOffsetHours?: number, vitals?: VitalSample[]): ClassifiedRow[];
+//# sourceMappingURL=classify.d.ts.map

package/dist/sync/sleep-correction/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../../src/sync/sleep-correction/classify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,MAAM,KAAK,CAAA;AACxB,eAAO,MAAM,MAAM,MAAM,CAAA;AACzB,eAAO,MAAM,YAAY,OAAO,CAAA;AAChC,eAAO,MAAM,YAAY,MAAM,CAAA;AAC/B,eAAO,MAAM,YAAY,QAAQ,CAAA;AACjC,eAAO,MAAM,gBAAgB,MAAO,CAAA;AACpC,eAAO,MAAM,gBAAgB,MAAM,CAAA;AACnC,eAAO,MAAM,cAAc,MAAM,CAAA;AACjC,eAAO,MAAM,eAAe,OAAO,CAAA;AACnC,eAAO,MAAM,SAAS,OAAO,CAAA;AAC7B,eAAO,MAAM,YAAY,IAAI,CAAA;AAG7B,eAAO,MAAM,sBAAsB,QAAS,CAAA;AAC5C,eAAO,MAAM,qBAAqB,QAAU,CAAA;AAC5C,eAAO,MAAM,YAAY,QAAQ,CAAA;AACjC,eAAO,MAAM,WAAW,OAAO,CAAA;AAC/B,eAAO,MAAM,aAAa,MAAO,CAAA;AACjC,eAAO,MAAM,aAAa,MAAO,CAAA;AACjC,eAAO,MAAM,QAAQ,MAAO,CAAA;AAC5B,eAAO,MAAM,SAAS,MAAO,CAAA;AAG7B,eAAO,MAAM,eAAe,MAAO,CAAA;AACnC,eAAO,MAAM,mBAAmB,KAAK,CAAA;AACrC,eAAO,MAAM,oBAAoB,OAAO,CAAA;AACxC,eAAO,MAAM,eAAe,KAAK,CAAA;AACjC,eAAO,MAAM,cAAc,MAAM,CAAA;AACjC,eAAO,MAAM,YAAY,OAAO,CAAA;AAChC,eAAO,MAAM,aAAa,OAAO,CAAA;AACjC,eAAO,MAAM,gBAAgB,OAAO,CAAA;AACpC,eAAO,MAAM,WAAW,MAAM,CAAA;AAE9B;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAAU,GACxB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAS5C;AAID,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED,4BAA4B;AAC5B,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,EAAE,EACjB,aAAa,GAAE,MAAU,EACzB,MAAM,CAAC,EAAE,WAAW,EAAE,GACrB,aAAa,EAAE,CA8LjB"}

package/dist/sync/sleep-correction/classify.js

@@ -0,0 +1,247 @@
+/**
+ * Sleep correction — Phase 3 and the night window (sleep-correction port).
+ *
+ * VERBATIM port of ziva_app `packages/ux/helpers/sleepCorrectionLayer.ts` v3.1
+ * (`fix/sleepProcessed`, unchanged db0c58a43 → a611cecca): `computeNightEpochs`,
+ * `parseDateStr`, `classifyBlocks` and every constant. Only the formatting
+ * follows this repo's lint; the logic, order of operations and constants are
+ * the validated ones (END within-30 74% → 88% on the QA study set) and must
+ * not be retuned during the port. The parity harness is the check.
+ *
+ * Timestamps are epoch seconds. Row `date`/`start` strings are the Phase 2
+ * output shape, "YYYY.MM.DD HH:MM:SS" in UTC.
+ */
+export const HR_MIN = 40;
+export const HR_MAX = 120;
+export const EXTEND_AFTER = 7200; // max seconds to extend past firmware end
+export const LONG_GAP_MIN = 600;
+export const LONG_GAP_MAX = 28800;
+export const LONG_GAP_HR_FRAC = 0.40;
+export const STITCH_GAP_SHORT = 120;
+export const STITCH_GAP_MED = 300;
+export const STITCH_GAP_LONG = 1200;
+export const BLOCK_SEP = 1800;
+export const BOUT_MAX_LEN = 1;
+// Morning over-extension guard (Step 5.5): only trim when the primary END lands
+// in this late-morning band.
+export const MORNING_TRIM_FLOOR_MIN = 7 * 60; // 07:00 local
+export const MORNING_TRIM_CEIL_MIN = 14 * 60; // 14:00 local
+export const FETCH_BEFORE = 21600; // 6h before window, so envelope HR context spans pre-sleep
+export const FETCH_AFTER = 1800;
+export const CONF_FIRMWARE = 0.90;
+export const CONF_ENVELOPE = 0.50;
+export const CONF_GAP = 0.40;
+export const CONF_BOUT = 0.70;
+// HR + movement END refinement (Step 5.6).
+export const END_BASE_PCTILE = 0.20; // personal sleep-HR baseline = 20th pct of in-block HR
+export const END_WAKE_MARGIN_BPM = 12; // wake threshold = baseline + max(this, frac*baseline)
+export const END_WAKE_MARGIN_FRAC = 0.18;
+export const END_QUIET_STEPS = 80; // steps within ±10min for a sample to still count "asleep"
+export const END_WAKE_STEPS = 150; // steps after the cut required to confirm wake (movement)
+export const END_MIN_TRIM = 1800; // 30min — only correct clear over-extensions
+export const END_MIN_SLEEP = 7200; // 2h — never collapse the primary block below this
+export const END_WAKE_SUSTAIN = 1200; // 20min — the awake run after the cut must persist
+export const END_GAP_TOL = 900; // 15min — tolerance for step/HR sample proximity
+/**
+ * 'YYYY-MM-DD' night → epoch window [18:00 previous local day, 18:00 local).
+ *
+ * `tzOffsetHours` is the offset in force for THIS night. v3.1 fed it one fixed
+ * device offset; the port's caller derives it per night from the user's IANA
+ * zone (spec: per-night IANA offset), so DST nights land correctly.
+ */
+export function computeNightEpochs(nightDate, tzOffsetHours = 0) {
+    const [year, month, day] = nightDate.split('-').map(Number);
+    const nightMidnightUtc = Date.UTC(year, month - 1, day) / 1000;
+    const priorMidnightUtc = nightMidnightUtc - 86400;
+    const tzOffsetSec = Math.round(tzOffsetHours * 3600);
+    return {
+        windowStart: priorMidnightUtc + 18 * 3600 - tzOffsetSec,
+        windowEnd: nightMidnightUtc + 18 * 3600 - tzOffsetSec,
+    };
+}
+const DOT_RE = /\./g;
+/** "YYYY.MM.DD HH:mm:ss" (UTC) → epoch seconds. v3.1 verbatim. */
+export function parseDateStr(d) {
+    if (!d)
+        return 0;
+    // "2026.04.18 16:52:01" → "2026-04-18T16:52:01Z"
+    const iso = `${d.replace(DOT_RE, (_m, offset) => offset < 10 ? '-' : '.').replace(' ', 'T')}Z`;
+    return Math.floor(new Date(iso).getTime() / 1000);
+}
+/**
+ * Bout consolidation + block classification (primary / secondary /
+ * microsleep), the synthetic head/tail trims and the Step 5.6 HR + movement
+ * END refinement. v3.1 verbatim — see the file header.
+ */
+export function classifyBlocks(rows, tzOffsetHours = 0, vitals) {
+    if (!rows || rows.length === 0)
+        return [];
+    const tzOffsetSec = Math.round(tzOffsetHours * 3600);
+    const localHour = (epoch) => new Date((epoch + tzOffsetSec) * 1000).getUTCHours();
+    // Step 1: Assign bout IDs (consecutive same-quality runs)
+    const withBouts = rows.map((row, i) => {
+        const prev = rows[i - 1];
+        const isBoutStart = !prev
+            || row.quality !== prev.quality
+            || parseDateStr(row.date) - parseDateStr(prev.date) > 65
+            || row.quality === 5
+            || (prev && prev.quality === 5);
+        return { ...row, is_bout_start: isBoutStart ? 1 : 0 };
+    });
+    let boutId = 0;
+    const withBoutIds = withBouts.map((row) => {
+        if (row.is_bout_start)
+            boutId++;
+        return { ...row, bout_id: boutId };
+    });
+    // Step 2: Consolidate short deep bouts → light (never REM)
+    const boutLengths = {};
+    const boutQualities = {};
+    for (const row of withBoutIds) {
+        boutLengths[row.bout_id] = (boutLengths[row.bout_id] || 0) + 1;
+        boutQualities[row.bout_id] = row.quality;
+    }
+    const consolidated = withBoutIds.map((row) => {
+        const len = boutLengths[row.bout_id];
+        const qual = boutQualities[row.bout_id];
+        const prevBoutQual = boutQualities[row.bout_id - 1];
+        const nextBoutQual = boutQualities[row.bout_id + 1];
+        // Only consolidate deep sleep (1) micro-fragments — never REM (3).
+        const isMergeable = qual === 1
+            && len <= BOUT_MAX_LEN
+            && (prevBoutQual === 2 || nextBoutQual === 2);
+        return {
+            ...row,
+            quality: isMergeable ? 2 : row.quality,
+            source: isMergeable ? 'bout_consolidated' : row.source,
+            confidence: isMergeable ? CONF_BOUT : row.confidence,
+        };
+    });
+    // Step 3: Assign block IDs (gaps > BLOCK_SEP = new block)
+    let blockId = 0;
+    const withBlocks = consolidated.map((row, i) => {
+        const prev = consolidated[i - 1];
+        if (!prev || parseDateStr(row.date) - parseDateStr(prev.date) > BLOCK_SEP)
+            blockId++;
+        return { ...row, block_id: blockId };
+    });
+    // Step 4: Find primary block (most sleep minutes during NIGHT hours)
+    const blockSleepMins = {};
+    const blockNightMins = {};
+    const blockFwMins = {};
+    const sessionSizes = {};
+    const sessionFwMins = {};
+    for (const row of withBlocks) {
+        if ([1, 2, 3].includes(row.quality)) {
+            blockSleepMins[row.block_id] = (blockSleepMins[row.block_id] || 0) + 1;
+            // Core-night window (20:00–10:00 local) only, so a spurious daytime
+            // firmware block can't be picked as the primary sleep.
+            const h = localHour(parseDateStr(row.date));
+            if (h >= 20 || h < 10)
+                blockNightMins[row.block_id] = (blockNightMins[row.block_id] || 0) + 1;
+        }
+        if (row.source === 'firmware') {
+            blockFwMins[row.block_id] = (blockFwMins[row.block_id] || 0) + 1;
+            sessionFwMins[row.session_id] = (sessionFwMins[row.session_id] || 0) + 1;
+        }
+        sessionSizes[row.session_id] = (sessionSizes[row.session_id] || 0) + 1;
+    }
+    // Prefer the block with the most night-hour sleep; fall back to total sleep
+    // minutes when no block has any (e.g. shift workers).
+    const primaryScore = Object.keys(blockNightMins).length ? blockNightMins : blockSleepMins;
+    const primaryBlockId = Object.entries(primaryScore)
+        .sort(([idA, a], [idB, b]) => b - a || Number(idA) - Number(idB))[0]?.[0];
+    const isFwBacked = (s) => s === 'firmware' || s === 'bout_consolidated';
+    const primaryIndices = () => {
+        const primIdx = [];
+        withBlocks.forEach((row, i) => {
+            if (String(row.block_id) === primaryBlockId)
+                primIdx.push(i);
+        });
+        return primIdx;
+    };
+    // Step 5.5: Trailing-synthetic-tail trim (morning over-extension guard).
+    const trimmedIdx = new Set();
+    if (primaryBlockId != null && (blockFwMins[Number(primaryBlockId)] || 0) > 0) {
+        const primIdx = primaryIndices();
+        const lastIdx = primIdx[primIdx.length - 1];
+        const endLocalMin = ((((parseDateStr(withBlocks[lastIdx].date) + tzOffsetSec) % 86400) + 86400) % 86400) / 60;
+        if (endLocalMin >= MORNING_TRIM_FLOOR_MIN && endLocalMin < MORNING_TRIM_CEIL_MIN) {
+            for (let p = primIdx.length - 1; p >= 0; p--) {
+                if (isFwBacked(withBlocks[primIdx[p]].source))
+                    break;
+                trimmedIdx.add(primIdx[p]);
+            }
+        }
+    }
+    // Step 5.5b: Leading-synthetic-head trim (evening onset guard).
+    if (primaryBlockId != null && (blockFwMins[Number(primaryBlockId)] || 0) > 0) {
+        const primIdx = primaryIndices();
+        for (let p = 0; p < primIdx.length; p++) {
+            if (isFwBacked(withBlocks[primIdx[p]].source))
+                break;
+            trimmedIdx.add(primIdx[p]);
+        }
+    }
+    // Step 5.6: HR + movement END refinement.
+    if (vitals && vitals.length && primaryBlockId != null) {
+        const hr = vitals
+            .filter(v => v.kind === 'hr' && Number.isFinite(v.value) && v.value > 0)
+            .map(v => ({ e: Number(v.epoch), v: Number(v.value) }))
+            .sort((a, b) => a.e - b.e);
+        const steps = vitals
+            .filter(v => v.kind === 'step' && Number.isFinite(v.value))
+            .map(v => ({ e: Number(v.epoch), v: Number(v.value) }))
+            .sort((a, b) => a.e - b.e);
+        const stepsIn = (a, b) => {
+            let s = 0;
+            for (const x of steps) {
+                if (x.e > a && x.e <= b)
+                    s += x.v;
+            }
+            return s;
+        };
+        const primIdx = primaryIndices();
+        const procStart = parseDateStr(withBlocks[primIdx[0]].date);
+        const procEnd = parseDateStr(withBlocks[primIdx[primIdx.length - 1]].date);
+        const inBlock = hr.filter(h => h.e >= procStart && h.e <= procEnd).map(h => h.v).sort((a, b) => a - b);
+        if (inBlock.length >= 4) {
+            const base = inBlock[Math.min(inBlock.length - 1, Math.floor(END_BASE_PCTILE * inBlock.length))];
+            const thr = base + Math.max(END_WAKE_MARGIN_BPM, END_WAKE_MARGIN_FRAC * base);
+            // "Asleep" only if HR is at sleep level AND steps are quiet around it.
+            const asleepAt = (h) => h.v <= thr && stepsIn(h.e - END_GAP_TOL + 300, h.e + END_GAP_TOL - 300) <= END_QUIET_STEPS;
+            const tail = hr.filter(h => h.e >= procStart && h.e <= procEnd + END_GAP_TOL);
+            let wakeAt = procEnd;
+            for (let i = tail.length - 1; i >= 0; i--) {
+                if (asleepAt(tail[i])) {
+                    wakeAt = tail[i].e;
+                    break;
+                }
+            }
+            const runLen = procEnd - wakeAt;
+            const stepsAfter = stepsIn(wakeAt, procEnd + END_GAP_TOL);
+            if (wakeAt < procEnd
+                && runLen >= END_WAKE_SUSTAIN
+                && stepsAfter >= END_WAKE_STEPS
+                && runLen >= END_MIN_TRIM
+                && (wakeAt - procStart) >= END_MIN_SLEEP) {
+                for (const i of primIdx) {
+                    if (parseDateStr(withBlocks[i].date) > wakeAt)
+                        trimmedIdx.add(i);
+                }
+            }
+        }
+    }
+    // Step 5: Assign block_type
+    return withBlocks.map(({ is_bout_start: _b, bout_id: _bo, block_id, session_id, ...row }, i) => ({
+        ...row,
+        block_type: sessionSizes[session_id] < 30 && !sessionFwMins[session_id]
+            ? 'microsleep'
+            : (blockFwMins[block_id] || 0) === 0 && (blockSleepMins[block_id] || 0) < 30
+                ? 'microsleep'
+                : String(block_id) === primaryBlockId
+                    ? (trimmedIdx.has(i) ? 'secondary' : 'primary')
+                    : 'secondary',
+    }));
+}
+//# sourceMappingURL=classify.js.map

package/dist/sync/sleep-correction/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../../src/sync/sleep-correction/classify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,CAAA;AACxB,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;AACzB,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAA,CAAC,0CAA0C;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAA;AAC/B,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAA;AACjC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAA;AACpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAA;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAA;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAA;AACnC,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAA;AAC7B,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAA;AAC7B,gFAAgF;AAChF,6BAA6B;AAC7B,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,CAAA,CAAC,cAAc;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,GAAG,EAAE,CAAA,CAAC,cAAc;AAC3D,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAA,CAAC,2DAA2D;AAC7F,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAA;AAC/B,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAA;AACjC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAA;AACjC,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAA;AAC5B,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAA;AAE7B,2CAA2C;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAA,CAAC,uDAAuD;AAC3F,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAA,CAAC,uDAAuD;AAC7F,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAA;AACxC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAA,CAAC,2DAA2D;AAC7F,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAA,CAAC,0DAA0D;AAC5F,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAA,CAAC,6CAA6C;AAC9E,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAA,CAAC,mDAAmD;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAA,CAAC,mDAAmD;AACxF,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAA,CAAC,iDAAiD;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAiB,EACjB,gBAAwB,CAAC;IAEzB,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAC3D,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;IAC9D,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,KAAK,CAAA;IACjD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IACpD,OAAO;QACL,WAAW,EAAE,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,WAAW;QACvD,SAAS,EAAE,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,WAAW;KACtD,CAAA;AACH,CAAC;AAED,MAAM,MAAM,GAAG,KAAK,CAAA;AAEpB,kEAAkE;AAClE,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,IAAI,CAAC,CAAC;QACJ,OAAO,CAAC,CAAA;IACV,iDAAiD;IACjD,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAA;IAC9F,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;AACnD,CAAC;AA8BD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAiB,EACjB,gBAAwB,CAAC,EACzB,MAAsB;IAEtB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAC5B,OAAO,EAAE,CAAA;IACX,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IACpD,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;IAEzF,0DAA0D;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACxB,MAAM,WAAW,GAAG,CAAC,IAAI;eACpB,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO;eAC5B,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;eACrD,GAAG,CAAC,OAAO,KAAK,CAAC;eACjB,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC,CAAA;QACjC,OAAO,EAAE,GAAG,GAAG,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,MAAM,WAAW,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACxC,IAAI,GAAG,CAAC,aAAa;YACnB,MAAM,EAAE,CAAA;QACV,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,2DAA2D;IAC3D,MAAM,WAAW,GAA2B,EAAE,CAAA;IAC9C,MAAM,aAAa,GAA2B,EAAE,CAAA;IAChD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;QAC9D,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,OAAO,CAAA;IAC1C,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC3C,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACpC,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACvC,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA;QACnD,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA;QACnD,mEAAmE;QACnE,MAAM,WAAW,GAAG,IAAI,KAAK,CAAC;eACzB,GAAG,IAAI,YAAY;eACnB,CAAC,YAAY,KAAK,CAAC,IAAI,YAAY,KAAK,CAAC,CAAC,CAAA;QAE/C,OAAO;YACL,GAAG,GAAG;YACN,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO;YACtC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM;YACtD,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU;SACrD,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,0DAA0D;IAC1D,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QAChC,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS;YACvE,OAAO,EAAE,CAAA;QACX,OAAO,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,qEAAqE;IACrE,MAAM,cAAc,GAA2B,EAAE,CAAA;IACjD,MAAM,cAAc,GAA2B,EAAE,CAAA;IACjD,MAAM,WAAW,GAA2B,EAAE,CAAA;IAC9C,MAAM,YAAY,GAA2B,EAAE,CAAA;IAC/C,MAAM,aAAa,GAA2B,EAAE,CAAA;IAEhD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;YACtE,oEAAoE;YACpE,uDAAuD;YACvD,MAAM,CAAC,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;YAC3C,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;gBACnB,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;QAC1E,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC9B,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;YAChE,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;QAC1E,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;IACxE,CAAC;IAED,4EAA4E;IAC5E,sDAAsD;IACtD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAA;IACzF,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;SAChD,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAE3E,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,mBAAmB,CAAA;IAC/E,MAAM,cAAc,GAAG,GAAa,EAAE;QACpC,MAAM,OAAO,GAAa,EAAE,CAAA;QAC5B,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YAC5B,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,cAAc;gBACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,CAAC,CAAC,CAAA;QACF,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IAED,yEAAyE;IACzE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAA;IACpC,IAAI,cAAc,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7E,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;QAChC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC3C,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,CAAA;QAC7G,IAAI,WAAW,IAAI,sBAAsB,IAAI,WAAW,GAAG,qBAAqB,EAAE,CAAC;YACjF,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7C,IAAI,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;oBAC3C,MAAK;gBACP,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,IAAI,cAAc,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7E,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,IAAI,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC3C,MAAK;YACP,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;QACtD,MAAM,EAAE,GAAG,MAAM;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;aACvE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;aACtD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,KAAK,GAAG,MAAM;aACjB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;aAC1D,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;aACtD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE;YACvC,IAAI,CAAC,GAAG,CAAC,CAAA;YACT,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;oBACrB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACZ,CAAC;YACD,OAAO,CAAC,CAAA;QACV,CAAC,CAAA;QAED,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;QAChC,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAC3D,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAE1E,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACtG,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;YAChG,MAAM,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,oBAAoB,GAAG,IAAI,CAAC,CAAA;YAC7E,uEAAuE;YACvE,MAAM,QAAQ,GAAG,CAAC,CAA2B,EAAE,EAAE,CAC/C,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,GAAG,CAAC,IAAI,eAAe,CAAA;YAE5F,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,WAAW,CAAC,CAAA;YAC7E,IAAI,MAAM,GAAG,OAAO,CAAA;YACpB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1C,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtB,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;oBAClB,MAAK;gBACP,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;YAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC,CAAA;YACzD,IAAI,MAAM,GAAG,OAAO;mBACf,MAAM,IAAI,gBAAgB;mBAC1B,UAAU,IAAI,cAAc;mBAC5B,MAAM,IAAI,YAAY;mBACtB,CAAC,MAAM,GAAG,SAAS,CAAC,IAAI,aAAa,EAAE,CAAC;gBAC3C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;oBACxB,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM;wBAC3C,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;gBACrB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/F,GAAG,GAAG;QACN,UAAU,EACR,YAAY,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC;YACzD,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE;gBACxE,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,cAAc;oBACnC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC/C,CAAC,CAAC,WAAW;KACxB,CAAC,CAAC,CAAA;AACL,CAAC"}

package/dist/sync/sleep-correction/correct.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Sleep correction — orchestration (v3.1's AppContextProvider loop, per night).
+ *
+ * Engine-agnostic: anything with `execute(sql)` returning rows. The relation
+ * names select where the raw firmware shapes come from — staging views over
+ * the warehouse in production, capture tables in the parity harness.
+ *
+ * NOT wired into sync yet (sleep-correction tasks §3): nothing calls this on
+ * a device, so the mapper path is unchanged until that lands.
+ */
+import type { ClassifiedRow, VitalSample } from './classify';
+import type { SleepRelations } from './sql';
+export interface SqlRunner {
+    execute: (sql: string) => Promise<unknown[]>;
+}
+/** v3.1 fallbacks when a scalar cannot be computed (AppContextProvider). */
+export declare const TIER_FALLBACK = 5;
+export declare const P90_FALLBACK = 120;
+export declare const P75_FALLBACK = 80;
+export declare function detectHrTier(db: SqlRunner, r?: SleepRelations): Promise<number>;
+export declare function globalBaselines(db: SqlRunner, cutoffEpoch: number, r?: SleepRelations): Promise<{
+    p75: number;
+    p90: number;
+}>;
+export interface CorrectNightInput {
+    windowStart: number;
+    windowEnd: number;
+    hrIntervalMin: number;
+    p75: number;
+    p90: number;
+    /** Offset in force for this night (the caller derives it from the IANA zone). */
+    tzOffsetHours: number;
+    relations?: SleepRelations;
+}
+export type CorrectNightResult = {
+    status: 'no_firmware_sleep';
+} | {
+    status: 'no_phase2_rows';
+} | {
+    status: 'ok';
+    rows: ClassifiedRow[];
+    vitals: VitalSample[];
+};
+/** One night: guard → Phase 2 (SQL) → morning vitals → Phase 3 (JS). */
+export declare function correctNight(db: SqlRunner, input: CorrectNightInput): Promise<CorrectNightResult>;
+//# sourceMappingURL=correct.d.ts.map

package/dist/sync/sleep-correction/correct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correct.d.ts","sourceRoot":"","sources":["../../../src/sync/sleep-correction/correct.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAa,WAAW,EAAE,MAAM,YAAY,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAW3C,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;CAC7C;AAcD,4EAA4E;AAC5E,eAAO,MAAM,aAAa,IAAI,CAAA;AAC9B,eAAO,MAAM,YAAY,MAAM,CAAA;AAC/B,eAAO,MAAM,YAAY,KAAK,CAAA;AAE9B,wBAAsB,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,GAAE,cAAkC,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxG;AAED,wBAAsB,eAAe,CACnC,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,CAAC,GAAE,cAAkC,GACpC,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAMvC;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,iFAAiF;IACjF,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,cAAc,CAAA;CAC3B;AAED,MAAM,MAAM,kBAAkB,GACxB;IAAE,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAC5B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,aAAa,EAAE,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAAA;AAEpE,wEAAwE;AACxE,wBAAsB,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4BvG"}

package/dist/sync/sleep-correction/correct.js

@@ -0,0 +1,60 @@
+/**
+ * Sleep correction — orchestration (v3.1's AppContextProvider loop, per night).
+ *
+ * Engine-agnostic: anything with `execute(sql)` returning rows. The relation
+ * names select where the raw firmware shapes come from — staging views over
+ * the warehouse in production, capture tables in the parity harness.
+ *
+ * NOT wired into sync yet (sleep-correction tasks §3): nothing calls this on
+ * a device, so the mapper path is unchanged until that lands.
+ */
+import { classifyBlocks } from './classify';
+import { correctNightSql, DEFAULT_RELATIONS, detectHrTierSql, globalBaselinesSql, hasSleepDataSql, morningVitalsSql, } from './sql';
+/** DuckDB hands BIGINT/HUGEINT back as bigint; every consumer here wants number. */
+function toNum(v) {
+    if (v == null)
+        return null;
+    if (typeof v === 'bigint')
+        return Number(v);
+    const n = Number(v);
+    return Number.isFinite(n) ? n : null;
+}
+/** v3.1 fallbacks when a scalar cannot be computed (AppContextProvider). */
+export const TIER_FALLBACK = 5;
+export const P90_FALLBACK = 120;
+export const P75_FALLBACK = 80;
+export async function detectHrTier(db, r = DEFAULT_RELATIONS) {
+    const [row] = (await db.execute(detectHrTierSql(r)));
+    return toNum(row?.hr_interval_minutes) || TIER_FALLBACK;
+}
+export async function globalBaselines(db, cutoffEpoch, r = DEFAULT_RELATIONS) {
+    const [row] = (await db.execute(globalBaselinesSql(cutoffEpoch, r)));
+    return {
+        p90: toNum(row?.p90_global) ?? P90_FALLBACK,
+        p75: toNum(row?.p75_global) ?? P75_FALLBACK,
+    };
+}
+/** One night: guard → Phase 2 (SQL) → morning vitals → Phase 3 (JS). */
+export async function correctNight(db, input) {
+    const r = input.relations ?? DEFAULT_RELATIONS;
+    const { windowStart, windowEnd } = input;
+    const [guard] = (await db.execute(hasSleepDataSql(windowStart, windowEnd, r)));
+    if (!toNum(guard?.has_data))
+        return { status: 'no_firmware_sleep' };
+    const phase2 = (await db.execute(correctNightSql(windowStart, windowEnd, input.hrIntervalMin, input.p75, input.p90, r)));
+    if (!phase2.length)
+        return { status: 'no_phase2_rows' };
+    const rows = phase2.map(p => ({
+        date: String(p.date),
+        quality: toNum(p.quality) ?? 0,
+        start: String(p.start),
+        unitLength: 1,
+        source: String(p.source),
+        confidence: toNum(p.confidence) ?? 0,
+        session_id: toNum(p.session_id) ?? 0,
+    }));
+    const vitals = (await db.execute(morningVitalsSql(windowStart, windowEnd, r)))
+        .map(v => ({ kind: String(v.kind), epoch: toNum(v.epoch) ?? 0, value: toNum(v.value) ?? Number.NaN }));
+    return { status: 'ok', rows: classifyBlocks(rows, input.tzOffsetHours, vitals), vitals };
+}
+//# sourceMappingURL=correct.js.map

package/dist/sync/sleep-correction/correct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correct.js","sourceRoot":"","sources":["../../../src/sync/sleep-correction/correct.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GACjB,MAAM,OAAO,CAAA;AAQd,oFAAoF;AACpF,SAAS,KAAK,CAAC,CAAU;IACvB,IAAI,CAAC,IAAI,IAAI;QACX,OAAO,IAAI,CAAA;IACb,IAAI,OAAO,CAAC,KAAK,QAAQ;QACvB,OAAO,MAAM,CAAC,CAAC,CAAC,CAAA;IAClB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IACnB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACtC,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAA;AAC9B,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAA;AAC/B,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAA;AAE9B,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAa,EAAE,IAAoB,iBAAiB;IACrF,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAU,CAAA;IAC7D,OAAO,KAAK,CAAC,GAAG,EAAE,mBAAmB,CAAC,IAAI,aAAa,CAAA;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,EAAa,EACb,WAAmB,EACnB,IAAoB,iBAAiB;IAErC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAU,CAAA;IAC7E,OAAO;QACL,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,YAAY;QAC3C,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,YAAY;KAC5C,CAAA;AACH,CAAC;AAkBD,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAa,EAAE,KAAwB;IACxE,MAAM,CAAC,GAAG,KAAK,CAAC,SAAS,IAAI,iBAAiB,CAAA;IAC9C,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,KAAK,CAAA;IAExC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAU,CAAA;IACvF,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC;QACzB,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAA;IAExC,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAC9B,eAAe,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CACtF,CAAU,CAAA;IACX,IAAI,CAAC,MAAM,CAAC,MAAM;QAChB,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA;IAErC,MAAM,IAAI,GAAgB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACpB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QACtB,UAAU,EAAE,CAAC;QACb,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QACxB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QACpC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;KACrC,CAAC,CAAC,CAAA;IAEH,MAAM,MAAM,GAAmB,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAW;SACrG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;IAExG,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;AAC1F,CAAC"}

package/dist/sync/sleep-correction/index.d.ts

@@ -0,0 +1,8 @@
+export { type ClassifiedRow, classifyBlocks, computeNightEpochs, parseDateStr, type Phase2Row, type VitalSample, } from './classify';
+export { correctNight, type CorrectNightInput, type CorrectNightResult, detectHrTier, globalBaselines, type SqlRunner, } from './correct';
+export { nightOffsetHours, nightWindow } from './night';
+export { type CorrectSleepInput, correctSleepNights, type CorrectSleepResult, type NightOutcome, nightsForEpochs, } from './orchestrate';
+export { computeSettleMin, recoveredMinutes } from './settle';
+export { correctNightSql, DEFAULT_RELATIONS, detectHrTierSql, globalBaselinesSql, hasSleepDataSql, morningVitalsSql, type SleepRelations, } from './sql';
+export { type StagingScope, stagingViewsSql } from './staging';
+//# sourceMappingURL=index.d.ts.map

package/dist/sync/sleep-correction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sync/sleep-correction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,YAAY,EACZ,eAAe,EACf,KAAK,SAAS,GACf,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACvD,OAAO,EACL,KAAK,iBAAiB,EACtB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC7D,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,KAAK,cAAc,GACpB,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,KAAK,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA"}

package/dist/sync/sleep-correction/index.js

@@ -0,0 +1,8 @@
+export { classifyBlocks, computeNightEpochs, parseDateStr, } from './classify';
+export { correctNight, detectHrTier, globalBaselines, } from './correct';
+export { nightOffsetHours, nightWindow } from './night';
+export { correctSleepNights, nightsForEpochs, } from './orchestrate';
+export { computeSettleMin, recoveredMinutes } from './settle';
+export { correctNightSql, DEFAULT_RELATIONS, detectHrTierSql, globalBaselinesSql, hasSleepDataSql, morningVitalsSql, } from './sql';
+export { stagingViewsSql } from './staging';
+//# sourceMappingURL=index.js.map

package/dist/sync/sleep-correction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sync/sleep-correction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACd,kBAAkB,EAClB,YAAY,GAGb,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,YAAY,EAGZ,YAAY,EACZ,eAAe,GAEhB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACvD,OAAO,EAEL,kBAAkB,EAGlB,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC7D,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GAEjB,MAAM,OAAO,CAAA;AACd,OAAO,EAAqB,eAAe,EAAE,MAAM,WAAW,CAAA"}

package/dist/sync/sleep-correction/night.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Per-night offsets from the user's IANA zone (principle 24).
+ *
+ * v3.1 passed one fixed device offset (`getTzOffsetHours()`) for every night,
+ * so on the nights either side of a DST change the 18:00→18:00 window sat an
+ * hour off. The port asks the zone what offset is in force at the START of
+ * each night's window — 18:00 local on the previous day — and hands that to
+ * the v3.1 arithmetic unchanged.
+ *
+ * Offsets are read for INSTANTS via `formatInTimeZone(…, 'xxx')`. Not
+ * date-fns-tz's `getTimezoneOffset(zone, date)`: that reads the Date's fields
+ * as a wall-clock time in the zone, so `2026-03-08T02:00Z` (Mar 7 18:00 PST)
+ * comes back as −7 — 02:00 is the spring-forward wall time. Measured; the
+ * spring-forward test pins it.
+ */
+/** UTC offset (ms) in force at the instant `epochMs` in `timeZone`. */
+export declare function offsetAtInstantMs(timeZone: string, epochMs: number): number;
+/** UTC offset (hours) in force at 18:00 local on the day before `nightIso`. */
+export declare function nightOffsetHours(nightIso: string, timeZone: string): number;
+/** The night's epoch window plus the offset it was computed with. */
+export declare function nightWindow(nightIso: string, timeZone: string): {
+    windowStart: number;
+    windowEnd: number;
+    tzOffsetHours: number;
+};
+//# sourceMappingURL=night.d.ts.map

package/dist/sync/sleep-correction/night.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"night.d.ts","sourceRoot":"","sources":["../../../src/sync/sleep-correction/night.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAa3E;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO3E;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAGnE"}

package/dist/sync/sleep-correction/night.js

@@ -0,0 +1,48 @@
+/**
+ * Per-night offsets from the user's IANA zone (principle 24).
+ *
+ * v3.1 passed one fixed device offset (`getTzOffsetHours()`) for every night,
+ * so on the nights either side of a DST change the 18:00→18:00 window sat an
+ * hour off. The port asks the zone what offset is in force at the START of
+ * each night's window — 18:00 local on the previous day — and hands that to
+ * the v3.1 arithmetic unchanged.
+ *
+ * Offsets are read for INSTANTS via `formatInTimeZone(…, 'xxx')`. Not
+ * date-fns-tz's `getTimezoneOffset(zone, date)`: that reads the Date's fields
+ * as a wall-clock time in the zone, so `2026-03-08T02:00Z` (Mar 7 18:00 PST)
+ * comes back as −7 — 02:00 is the spring-forward wall time. Measured; the
+ * spring-forward test pins it.
+ */
+import { formatInTimeZone } from 'date-fns-tz';
+import { computeNightEpochs } from './classify';
+const OFFSET_RE = /^([+-])(\d{2}):(\d{2})$/;
+/** UTC offset (ms) in force at the instant `epochMs` in `timeZone`. */
+export function offsetAtInstantMs(timeZone, epochMs) {
+    let text;
+    try {
+        text = formatInTimeZone(new Date(epochMs), timeZone, 'xxx');
+    }
+    catch {
+        throw new Error(`sleep-correction: unknown time zone ${JSON.stringify(timeZone)}`);
+    }
+    const m = OFFSET_RE.exec(text);
+    if (!m)
+        throw new Error(`sleep-correction: unreadable offset ${JSON.stringify(text)} for ${timeZone}`);
+    const ms = (Number(m[2]) * 60 + Number(m[3])) * 60000;
+    return m[1] === '-' ? -ms : ms;
+}
+/** UTC offset (hours) in force at 18:00 local on the day before `nightIso`. */
+export function nightOffsetHours(nightIso, timeZone) {
+    const [y, m, d] = nightIso.split('-').map(Number);
+    // Local 18:00 as if it were UTC; one correction by the offset near that
+    // instant lands on the true local 18:00, and the offset there is the answer.
+    const wall = Date.UTC(y, m - 1, d - 1, 18);
+    const guess = offsetAtInstantMs(timeZone, wall);
+    return offsetAtInstantMs(timeZone, wall - guess) / 3600000;
+}
+/** The night's epoch window plus the offset it was computed with. */
+export function nightWindow(nightIso, timeZone) {
+    const tzOffsetHours = nightOffsetHours(nightIso, timeZone);
+    return { ...computeNightEpochs(nightIso, tzOffsetHours), tzOffsetHours };
+}
+//# sourceMappingURL=night.js.map

package/dist/sync/sleep-correction/night.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"night.js","sourceRoot":"","sources":["../../../src/sync/sleep-correction/night.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,SAAS,GAAG,yBAAyB,CAAA;AAE3C,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,OAAe;IACjE,IAAI,IAAY,CAAA;IAChB,IAAI,CAAC;QACH,IAAI,GAAG,gBAAgB,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;IAC7D,CAAC;IACD,MAAM,CAAC;QACL,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IACpF,CAAC;IACD,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,CAAC;QACJ,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,QAAQ,EAAE,CAAC,CAAA;IAChG,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAM,CAAA;IACtD,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AAChC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,QAAgB;IACjE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACjD,wEAAwE;IACxE,6EAA6E;IAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAA;IAC1C,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAC/C,OAAO,iBAAiB,CAAC,QAAQ,EAAE,IAAI,GAAG,KAAK,CAAC,GAAG,OAAS,CAAA;AAC9D,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,QAAgB;IAEhB,MAAM,aAAa,GAAG,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC1D,OAAO,EAAE,GAAG,kBAAkB,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;AAC1E,CAAC"}

package/dist/sync/sleep-correction/orchestrate.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Correct every night a sync touched — v3.1's post-sync loop, per night.
+ *
+ * As v3.1: the HR tier and sleeping-HR percentiles are computed once per run,
+ * then each night gets its window, Phase 2 + 3, and the port's two scalars.
+ * Unlike v3.1, each night's window uses the offset its own zone had at its
+ * 18:00 (see `night.ts`), not one fixed device offset.
+ *
+ * A night that throws is reported `failed` and the rest continue — the spec's
+ * containment rule: a failed night keeps whatever rows it already had; it
+ * never blocks the batch. Writing the results (night-scoped replace) is the
+ * caller's job (sleep-correction tasks §3).
+ */
+import type { ClassifiedRow } from './classify';
+import type { SqlRunner } from './correct';
+import type { SleepRelations } from './sql';
+export interface CorrectSleepInput {
+    /** 'YYYY-MM-DD' nights (6pm → 6pm), e.g. from `nightsForEpochs`. */
+    nights: string[];
+    /** The user's IANA zone. */
+    timeZone: string;
+    /** Baseline lookback start (epoch seconds) — production: now − 30 d. */
+    cutoffEpoch: number;
+    relations?: SleepRelations;
+}
+export interface NightOutcome {
+    night: string;
+    windowStart: number;
+    windowEnd: number;
+    tzOffsetHours: number;
+    status: 'ok' | 'no_firmware_sleep' | 'no_phase2_rows' | 'failed';
+    rows?: ClassifiedRow[];
+    settleMin?: number | null;
+    recoveredMin?: number;
+    error?: string;
+}
+export interface CorrectSleepResult {
+    hrIntervalMin: number;
+    p75: number;
+    p90: number;
+    nights: NightOutcome[];
+}
+export declare function correctSleepNights(db: SqlRunner, input: CorrectSleepInput): Promise<CorrectSleepResult>;
+/**
+ * The nights (6pm → 6pm local) that a set of instants falls in — which nights
+ * a sync batch touched. Same attribution as v3.1's harness `nightOf`: shift to
+ * local time, add 6 h so 18:00 lands on midnight, take the date.
+ */
+export declare function nightsForEpochs(epochs: Iterable<number>, timeZone: string): string[];
+//# sourceMappingURL=orchestrate.d.ts.map