@mongrov/analytics 0.6.0 → 0.7.0

package/dist/rules/schema.d.ts

@@ -19,6 +19,19 @@ export declare const COMPARES: readonly ["less_than", "greater_than", "equals",
 export type Compare = (typeof COMPARES)[number];
 export declare const SEVERITIES: readonly ["info", "warn", "critical"];
 export type Severity = (typeof SEVERITIES)[number];
+/**
+ * Physiological context the rule restricts its samples to (Sprint 5 §4).
+ *
+ * - `any`     — every sample in the window
+ * - `asleep`  — samples falling inside a `v_sleep_session` interval
+ * - `resting` — samples in a minute with zero steps
+ *
+ * Context is a JOIN, not a post-filter: "SpO₂ during sleep" means the
+ * aggregate is computed over sleep samples only, not computed over
+ * everything and then labelled.
+ */
+export declare const CONTEXTS: readonly ["any", "asleep", "resting"];
+export type RuleContext = (typeof CONTEXTS)[number];
 export declare const TargetSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     type: z.ZodLiteral<"absolute">;
     value: z.ZodNumber;
@@ -64,6 +77,23 @@ export declare const TargetSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
     type: "range";
     min: number;
     max: number;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"user_setting">;
+    /** KVStore key suffix, e.g. `user:spo2SafeLevel`. See the namespace registry. */
+    key: z.ZodString;
+    /** Used when the user has never set the value. */
+    defaultValue: z.ZodNumber;
+    compare: z.ZodDefault<z.ZodEnum<["as_configured"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "user_setting";
+    key: string;
+    defaultValue: number;
+    compare: "as_configured";
+}, {
+    type: "user_setting";
+    key: string;
+    defaultValue: number;
+    compare?: "as_configured" | undefined;
 }>]>;
 export type Target = z.infer<typeof TargetSchema>;
 export declare const ThrottleSchema: z.ZodDefault<z.ZodObject<{
@@ -86,6 +116,16 @@ export declare const RuleSchema: z.ZodObject<{
     window: z.ZodEnum<["1h", "6h", "24h", "3d", "7d", "30d"]>;
     aggregation: z.ZodDefault<z.ZodEnum<["avg", "min", "max", "sum", "last", "count"]>>;
     compare: z.ZodEnum<["less_than", "greater_than", "equals", "not_equals", "between"]>;
+    /** Restrict samples to a physiological context. Default `any`. */
+    context: z.ZodDefault<z.ZodEnum<["any", "asleep", "resting"]>>;
+    /**
+     * Require `n` ADJACENT breaching samples before the rule fires.
+     *
+     * Omitted or `1` means "any breach in the window", which the aggregate
+     * path already expresses (e.g. `aggregation: 'min'` + `less_than`).
+     * `>= 2` switches the compiler to run-length detection.
+     */
+    consecutive: z.ZodOptional<z.ZodNumber>;
     target: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         type: z.ZodLiteral<"absolute">;
         value: z.ZodNumber;
@@ -131,6 +171,23 @@ export declare const RuleSchema: z.ZodObject<{
         type: "range";
         min: number;
         max: number;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"user_setting">;
+        /** KVStore key suffix, e.g. `user:spo2SafeLevel`. See the namespace registry. */
+        key: z.ZodString;
+        /** Used when the user has never set the value. */
+        defaultValue: z.ZodNumber;
+        compare: z.ZodDefault<z.ZodEnum<["as_configured"]>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "user_setting";
+        key: string;
+        defaultValue: number;
+        compare: "as_configured";
+    }, {
+        type: "user_setting";
+        key: string;
+        defaultValue: number;
+        compare?: "as_configured" | undefined;
     }>]>;
     severity: z.ZodEnum<["info", "warn", "critical"]>;
     throttle: z.ZodDefault<z.ZodObject<{
@@ -167,12 +224,18 @@ export declare const RuleSchema: z.ZodObject<{
         type: "range";
         min: number;
         max: number;
+    } | {
+        type: "user_setting";
+        key: string;
+        defaultValue: number;
+        compare: "as_configured";
     };
+    context: "any" | "asleep" | "resting";
     name: string;
     metric: "spo2" | "device_battery" | "hrv_ms" | "stress" | "systolic_bp" | "diastolic_bp" | "vascular_aging" | "hr_bpm" | "temp_c" | "activity_steps" | "calories" | "distance_km" | "sleep_total_minutes" | "sleep_score";
-    window: "1h" | "6h" | "24h" | "3d" | "7d" | "30d";
-    aggregation: "avg" | "min" | "max" | "sum" | "last" | "count";
     compare: "less_than" | "greater_than" | "equals" | "not_equals" | "between";
+    window: "1h" | "6h" | "24h" | "3d" | "7d" | "30d";
+    aggregation: "avg" | "sum" | "min" | "max" | "last" | "count";
     severity: "info" | "warn" | "critical";
     throttle: {
         minGapMinutes: number;
@@ -180,6 +243,7 @@ export declare const RuleSchema: z.ZodObject<{
     };
     description?: string | undefined;
     brand?: string | undefined;
+    consecutive?: number | undefined;
     rawSql?: string | undefined;
     rawSqlParams?: string[] | undefined;
     exposureOverride?: boolean | undefined;
@@ -200,15 +264,22 @@ export declare const RuleSchema: z.ZodObject<{
         type: "range";
         min: number;
         max: number;
+    } | {
+        type: "user_setting";
+        key: string;
+        defaultValue: number;
+        compare?: "as_configured" | undefined;
     };
     name: string;
     metric: "spo2" | "device_battery" | "hrv_ms" | "stress" | "systolic_bp" | "diastolic_bp" | "vascular_aging" | "hr_bpm" | "temp_c" | "activity_steps" | "calories" | "distance_km" | "sleep_total_minutes" | "sleep_score";
-    window: "1h" | "6h" | "24h" | "3d" | "7d" | "30d";
     compare: "less_than" | "greater_than" | "equals" | "not_equals" | "between";
+    window: "1h" | "6h" | "24h" | "3d" | "7d" | "30d";
     severity: "info" | "warn" | "critical";
     description?: string | undefined;
+    context?: "any" | "asleep" | "resting" | undefined;
     brand?: string | undefined;
-    aggregation?: "avg" | "min" | "max" | "sum" | "last" | "count" | undefined;
+    aggregation?: "avg" | "sum" | "min" | "max" | "last" | "count" | undefined;
+    consecutive?: number | undefined;
     throttle?: {
         minGapMinutes?: number | undefined;
         maxPerDay?: number | undefined;

package/dist/rules/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/rules/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,+DAA+D;AAC/D,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAID,eAAO,MAAM,OAAO,iDAAkD,CAAA;AACtE,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7C,eAAO,MAAM,YAAY,wDAAyD,CAAA;AAClF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvD,eAAO,MAAM,QAAQ,2EAMX,CAAA;AACV,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/C,eAAO,MAAM,UAAU,uCAAwC,CAAA;AAC/D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAyBlD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAKvB,CAAA;AACF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEjD,eAAO,MAAM,cAAc;;;;;;;;;GAKb,CAAA;AAEd,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAcrB;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAA;AAEF,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/rules/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,+DAA+D;AAC/D,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAID,eAAO,MAAM,OAAO,iDAAkD,CAAA;AACtE,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7C,eAAO,MAAM,YAAY,wDAAyD,CAAA;AAClF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvD,eAAO,MAAM,QAAQ,2EAMX,CAAA;AACV,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/C,eAAO,MAAM,UAAU,uCAAwC,CAAA;AAC/D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAElD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,uCAAwC,CAAA;AAC7D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AA+CnD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAPvB,iFAAiF;;IAEjF,kDAAkD;;;;;;;;;;;;;IAWlD,CAAA;AACF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEjD,eAAO,MAAM,cAAc;;;;;;;;;GAKb,CAAA;AAEd,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,eAAO,MAAM,UAAU;;;;;;;;;IASrB,kEAAkE;;IAElE;;;;;;OAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA1CH,iFAAiF;;QAEjF,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+ClD;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAA;AAEF,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA"}

package/dist/rules/schema.js

@@ -26,6 +26,18 @@ export const COMPARES = [
     'between',
 ];
 export const SEVERITIES = ['info', 'warn', 'critical'];
+/**
+ * Physiological context the rule restricts its samples to (Sprint 5 §4).
+ *
+ * - `any`     — every sample in the window
+ * - `asleep`  — samples falling inside a `v_sleep_session` interval
+ * - `resting` — samples in a minute with zero steps
+ *
+ * Context is a JOIN, not a post-filter: "SpO₂ during sleep" means the
+ * aggregate is computed over sleep samples only, not computed over
+ * everything and then labelled.
+ */
+export const CONTEXTS = ['any', 'asleep', 'resting'];
 const TargetAbsolute = z.object({
     type: z.literal('absolute'),
     value: z.number(),
@@ -45,11 +57,33 @@ const TargetRange = z.object({
     min: z.number(),
     max: z.number(),
 });
+/**
+ * v0.2.0 (Sprint 5 §4, Ziva #1) — threshold read from KVStore at eval time
+ * rather than baked into the rule.
+ *
+ * This is what makes the ⚙ sheet's promise real: the user drags a safe
+ * level, the mutation writes `user:spo2SafeLevel`, and the SAME shipped
+ * rule re-evaluates against the new number on the next batch. No recompile,
+ * no per-user rule rows.
+ *
+ * `compare` is a single-member enum rather than omitted: the comparison is
+ * fixed by the rule's own `compare` field, and a second knob here would let
+ * an author write a rule whose two comparison directions disagree.
+ */
+const TargetUserSetting = z.object({
+    type: z.literal('user_setting'),
+    /** KVStore key suffix, e.g. `user:spo2SafeLevel`. See the namespace registry. */
+    key: z.string().min(1),
+    /** Used when the user has never set the value. */
+    defaultValue: z.number(),
+    compare: z.enum(['as_configured']).default('as_configured'),
+});
 export const TargetSchema = z.discriminatedUnion('type', [
     TargetAbsolute,
     TargetBaselinePercent,
     TargetBaselineStddev,
     TargetRange,
+    TargetUserSetting,
 ]);
 export const ThrottleSchema = z
     .object({
@@ -66,6 +100,16 @@ export const RuleSchema = z.object({
     window: z.enum(WINDOWS),
     aggregation: z.enum(AGGREGATIONS).default('avg'),
     compare: z.enum(COMPARES),
+    /** Restrict samples to a physiological context. Default `any`. */
+    context: z.enum(CONTEXTS).default('any'),
+    /**
+     * Require `n` ADJACENT breaching samples before the rule fires.
+     *
+     * Omitted or `1` means "any breach in the window", which the aggregate
+     * path already expresses (e.g. `aggregation: 'min'` + `less_than`).
+     * `>= 2` switches the compiler to run-length detection.
+     */
+    consecutive: z.number().int().min(1).optional(),
     target: TargetSchema,
     severity: z.enum(SEVERITIES),
     throttle: ThrottleSchema,

package/dist/rules/schema.js.map

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

package/dist/rules/types.d.ts

@@ -5,7 +5,7 @@
  * consumers don't need to pull the Zod schema module unless they
  * validate rules themselves.
  */
-import type { AnalyticsEngine, FamilyMembersProvider, KVStore, Unsubscribe } from '../core/types';
+import type { AnalyticsEngine, EventBus, FamilyMembersProvider, KVStore, Unsubscribe } from '../core/types';
 import type { MetricId } from '../core/metric_metadata';
 import type { TableName } from '../core/schemas';
 import type { Rule } from './schema';
@@ -35,6 +35,14 @@ export interface CompiledRule {
     /** Statically-known params. Runtime binds `$userId`/`$brand`/`$familyId` on top. */
     params: Record<string, string | number>;
     description: string;
+    /**
+     * KVStore key the evaluator reads to bind `$userSettingValue`
+     * (Sprint 5 T-19/T-23). Present only for `target.type: 'user_setting'`.
+     * Full key is `analytics:{userId}:{userSettingKey}`.
+     */
+    userSettingKey?: string;
+    /** Fallback threshold when the user has never set the value. */
+    userSettingDefault?: number;
 }
 /** Structured violation delivered to `on('violation', handler)` subscribers. */
 export interface RuleViolation {
@@ -66,6 +74,13 @@ export interface RulesEngineConfig {
     brand: string;
     /** Family id for `onSchedule` — v0.1.0 single-user apps pass the userId. */
     familyId: string;
+    /**
+     * Optional app event bus (structural type from core — no runtime dep on
+     * @mongrov/data-access). When set, the evaluator emits
+     * `threshold:violation` + `insight:insert` after persisting a violation
+     * to the `insight` table (principle 35 fire-and-forget).
+     */
+    eventBus?: EventBus;
     logger?: RulesLogger;
     clock?: Clock;
 }

package/dist/rules/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rules/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,OAAO,EACP,WAAW,EACZ,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,YAAY,EAAE,WAAW,EAAE,CAAA;AAE3B,2DAA2D;AAC3D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAA;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,cAAc,EAAE,SAAS,EAAE,CAAA;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,QAAQ,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;IACvC,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,IAAI,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAC7D;AAED,8DAA8D;AAC9D,MAAM,MAAM,KAAK,GAAG,MAAM,IAAI,CAAA;AAE9B,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,eAAe,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,qBAAqB,EAAE,qBAAqB,CAAA;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,wEAAwE;IACxE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,IAAI,IAAI,IAAI,EAAE,CAAA;IACd,SAAS,IAAI,IAAI,EAAE,CAAA;IACnB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;IAC9D,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;IAC7C,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,GAAG,WAAW,CAAA;IACxE;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,WAAW,CAAA;IACpD;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rules/types.ts"],"names":[],"mappings":"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"}

package/dist/rules/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/rules/validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAE,KAAK,IAAI,EAAuB,KAAK,MAAM,EAAW,MAAM,UAAU,CAAA;AA4B/E;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,CAS5D;AAgBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAwBnE;AAED,8EAA8E;AAC9E,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAOpE"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/rules/validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAE,KAAK,IAAI,EAAuB,KAAK,MAAM,EAAW,MAAM,UAAU,CAAA;AA4B/E;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,CAS5D;AAgBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CA2BnE;AAiED,8EAA8E;AAC9E,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAOpE"}

package/dist/rules/validator.js

@@ -65,6 +65,8 @@ function samplingLabel(metric) {
  * When rawSql is present with `exposureOverride: true`, emits a warn via `logger`.
  */
 export function validateRule(rule, logger) {
+    validateConsecutive(rule);
+    validateContext(rule);
     const allowed = allowedWindowsFor(rule.metric);
     if (!allowed.includes(rule.window)) {
         throw new RuleValidationError(`Rule ${rule.id}: metric ${rule.metric} sampled ${samplingLabel(rule.metric)}. `
@@ -84,6 +86,60 @@ export function validateRule(rule, logger) {
         }
     }
 }
+/**
+ * T-21 — `consecutive x effective_sampling_minutes` must fit the window.
+ *
+ * A rule asking for 3 consecutive HRV samples (60-min cadence) inside a 1h
+ * window is unsatisfiable: the window holds at most one sample, so the
+ * rule can never fire and the author gets silence instead of an error.
+ *
+ * `effective` sampling comes from `device_config.interval_minutes` at eval
+ * time when a row exists (principle 22); at register time only the
+ * `metric_metadata` fallback is known, so this check uses the fallback and
+ * is deliberately permissive — a denser real device only makes a rule MORE
+ * satisfiable, never less.
+ */
+function validateConsecutive(rule) {
+    const n = rule.consecutive;
+    if (n === undefined || n <= 1)
+        return;
+    // Baseline targets resolve per-window, not per-sample; the compiler has
+    // no correct query shape for the combination.
+    if (rule.target.type === 'baseline_percent' || rule.target.type === 'baseline_stddev') {
+        throw new RuleValidationError(`Rule ${rule.id}: consecutive is not supported with target.type `
+            + `'${rule.target.type}' — baseline targets resolve per-window, not `
+            + `per-sample. Use absolute or user_setting, or drop consecutive.`);
+    }
+    const cadence = METRIC_METADATA[rule.metric].sampling_minutes;
+    if (cadence === 'per_session') {
+        // One value per night; "consecutive samples" means consecutive nights,
+        // which the window already bounds.
+        return;
+    }
+    const needed = n * cadence;
+    const available = WINDOW_MINUTES[rule.window];
+    if (needed > available) {
+        throw new RuleValidationError(`Rule ${rule.id}: consecutive ${n} x ${cadence}min sampling needs `
+            + `${needed}min but window ${rule.window} is only ${available}min. `
+            + `The rule could never fire. Widen the window or lower consecutive.`);
+    }
+}
+/**
+ * T-21 — context compatibility.
+ *
+ * `context: 'asleep'` JOINs `v_sleep_session` on the metric's `ts`, so a
+ * metric whose own time axis IS the sleep session (sleep_total_minutes)
+ * would self-join meaninglessly.
+ */
+function validateContext(rule) {
+    if (rule.context === 'any')
+        return;
+    const table = METRIC_METADATA[rule.metric].table;
+    if (table === 'sleep_session') {
+        throw new RuleValidationError(`Rule ${rule.id}: context '${rule.context}' is redundant for metric `
+            + `${rule.metric} — it is already a per-session measure. Use context 'any'.`);
+    }
+}
 /** Scan a rawSql body for whole-word references to collected-only columns. */
 export function referencedCollectedOnlyColumns(sql) {
     const hits = new Set();

package/dist/rules/validator.js.map

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

package/dist/sync/baseline-compute.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Day-first baseline compute (Sprint 5 §7 / T-13 / T-14, principle 27).
+ *
+ * Populates `user_baseline`, the shared "usual range" that rules, AI tools,
+ * and screens all read. One row per (brand, family, user, metric, window).
+ *
+ * ## Why day-first
+ *
+ * The naive implementation quantiles raw readings. That is wrong, and
+ * wrong in a way that looks plausible: SpO₂ sampled every 30 minutes dips
+ * during deep sleep on most nights, so a raw p10 across 30 days reports the
+ * *dip* (~87%) as the bottom of the user's usual range. It isn't — it's a
+ * normal nightly event that happens every day. The user's day-to-day
+ * variation is much narrower.
+ *
+ * So: collapse each local day to ONE value, then quantile across days. A
+ * fixture of `95, 95, 87, 95, 95` repeated for 30 days gives p10 ≈ 92.6
+ * day-first versus 87 raw — and 92.6 is the honest answer.
+ *
+ * This is also why `sample_count` counts DAYS. Fifteen days of 30-minute
+ * sampling is 720 readings but still only 15 days of evidence, and must not
+ * populate a baseline.
+ */
+import { type BaselineWindowDays, type MetricId } from '../core/metric_metadata';
+import type { AnalyticsEngine, EventBus } from '../core/types';
+import type { SchedulerLogger } from './scheduler';
+export interface BaselineComputeContext {
+    brand: string;
+    familyId: string;
+    userId: string;
+    /** IANA zone. Day boundaries are local, so this decides the buckets. */
+    userTimezone: string;
+}
+export interface BaselineComputeConfig {
+    analytics: AnalyticsEngine;
+    eventBus?: EventBus;
+    logger?: SchedulerLogger;
+    /** Override for tests. Defaults to every metric declaring an aggregate. */
+    metrics?: readonly MetricId[];
+    /** Override for tests. Defaults to 7 / 30 / 90. */
+    windows?: readonly BaselineWindowDays[];
+}
+export interface BaselineComputeResult {
+    computed: number;
+    skipped: number;
+    failed: number;
+}
+/**
+ * Build the day-first aggregate SQL for one (metric, window).
+ *
+ * Exported for snapshot tests — the shape of this query IS the correctness
+ * property, so it is worth asserting directly rather than only through
+ * results.
+ */
+export declare function buildBaselineSql(metric: MetricId, windowDays: BaselineWindowDays): string;
+export interface BaselineComputer {
+    /** Compute one (metric, window). Returns true when a row was written. */
+    computeOne(metric: MetricId, windowDays: BaselineWindowDays, ctx: BaselineComputeContext): Promise<boolean>;
+    /** Compute every configured metric x window for one user. */
+    computeAll(ctx: BaselineComputeContext): Promise<BaselineComputeResult>;
+}
+export declare function createBaselineComputer(config: BaselineComputeConfig): BaselineComputer;
+//# sourceMappingURL=baseline-compute.d.ts.map

package/dist/sync/baseline-compute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline-compute.d.ts","sourceRoot":"","sources":["../../src/sync/baseline-compute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAIL,KAAK,kBAAkB,EAGvB,KAAK,QAAQ,EACd,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAclD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,eAAe,CAAA;IAC1B,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,MAAM,CAAC,EAAE,eAAe,CAAA;IACxB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC7B,mDAAmD;IACnD,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;CACxC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,QAAQ,EAChB,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAoDR;AA4CD,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,UAAU,CACR,MAAM,EAAE,QAAQ,EAChB,UAAU,EAAE,kBAAkB,EAC9B,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAAA;IACnB,6DAA6D;IAC7D,UAAU,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;CACxE;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,qBAAqB,GAC5B,gBAAgB,CAmGlB"}

package/dist/sync/baseline-compute.js

@@ -0,0 +1,211 @@
+/**
+ * Day-first baseline compute (Sprint 5 §7 / T-13 / T-14, principle 27).
+ *
+ * Populates `user_baseline`, the shared "usual range" that rules, AI tools,
+ * and screens all read. One row per (brand, family, user, metric, window).
+ *
+ * ## Why day-first
+ *
+ * The naive implementation quantiles raw readings. That is wrong, and
+ * wrong in a way that looks plausible: SpO₂ sampled every 30 minutes dips
+ * during deep sleep on most nights, so a raw p10 across 30 days reports the
+ * *dip* (~87%) as the bottom of the user's usual range. It isn't — it's a
+ * normal nightly event that happens every day. The user's day-to-day
+ * variation is much narrower.
+ *
+ * So: collapse each local day to ONE value, then quantile across days. A
+ * fixture of `95, 95, 87, 95, 95` repeated for 30 days gives p10 ≈ 92.6
+ * day-first versus 87 raw — and 92.6 is the honest answer.
+ *
+ * This is also why `sample_count` counts DAYS. Fifteen days of 30-minute
+ * sampling is 720 readings but still only 15 days of evidence, and must not
+ * populate a baseline.
+ */
+import { baselineAggregateFor, BASELINE_MIN_DAYS, BASELINE_WINDOW_DAYS, getBaselineMetricIds, METRIC_METADATA, } from '../core/metric_metadata';
+/**
+ * Build the day-first aggregate SQL for one (metric, window).
+ *
+ * Exported for snapshot tests — the shape of this query IS the correctness
+ * property, so it is worth asserting directly rather than only through
+ * results.
+ */
+export function buildBaselineSql(metric, windowDays) {
+    const meta = METRIC_METADATA[metric];
+    const aggregate = baselineAggregateFor(metric);
+    const column = meta.column;
+    const view = `v_${meta.table}`;
+    // DuckDB cannot bind a parameter inside an INTERVAL literal, but it can
+    // multiply a static unit interval by a bound integer. Same trick the
+    // rules compiler uses.
+    const windowBind = `(INTERVAL 1 DAY) * $windowDays`;
+    let dailySelect;
+    let tsColumn;
+    if (aggregate === 'session') {
+        // Sleep is already attributed to a local night by the mapper's 6pm-6pm
+        // rule, so `night_of` is a better day key than re-deriving one from a
+        // timestamp — it is DST-correct by construction.
+        //
+        // NOTE: this groups, where the Sprint 5 design sketch skipped the
+        // GROUP BY for session metrics. Skipping it makes `count(*)` count
+        // SESSIONS, so a user with two sessions a night would satisfy the
+        // 20-day minimum after 10 nights — contradicting T-14. Summing per
+        // night also gives the right daily value: total sleep that night.
+        dailySelect = `night_of AS day, sum(${column}) AS daily_value`;
+        tsColumn = 'ts_start';
+        return `
+      WITH daily_values AS (
+        SELECT ${dailySelect}
+        FROM ${view}
+        WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+          AND ${tsColumn} > now() - ${windowBind}
+        GROUP BY night_of
+      )
+      ${quantileSelect()}
+    `.trim();
+    }
+    const fn = aggregate === 'sum' ? 'sum' : 'avg';
+    tsColumn = 'ts';
+    dailySelect
+        = `date_trunc('day', timezone($tz, ${tsColumn})) AS day, ${fn}(${column}) AS daily_value`;
+    return `
+    WITH daily_values AS (
+      SELECT ${dailySelect}
+      FROM ${view}
+      WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+        AND ${tsColumn} > now() - ${windowBind}
+      GROUP BY day
+    )
+    ${quantileSelect()}
+  `.trim();
+}
+/**
+ * The quantile pass, identical across aggregate types.
+ *
+ * `HAVING count(*) >= n` rather than `HAVING sample_count >= n`: the alias
+ * is not guaranteed visible in HAVING across DuckDB versions, and getting
+ * this wrong would silently write under-evidenced baselines.
+ */
+function quantileSelect() {
+    return `SELECT
+      quantile_cont(daily_value, 0.05) AS p05,
+      quantile_cont(daily_value, 0.10) AS p10,
+      quantile_cont(daily_value, 0.50) AS p50,
+      quantile_cont(daily_value, 0.90) AS p90,
+      quantile_cont(daily_value, 0.95) AS p95,
+      avg(daily_value) AS mean,
+      stddev_samp(daily_value) AS stddev,
+      count(*) AS sample_count
+    FROM daily_values
+    HAVING count(*) >= ${BASELINE_MIN_DAYS}`;
+}
+/** UPSERT — recompute replaces the previous row for the same key. */
+const UPSERT_SQL = `
+INSERT INTO user_baseline (
+  brand, family_id, user_id, metric, window_days,
+  p05, p10, p50, p90, p95, mean, stddev, sample_count, computed_at
+) VALUES (
+  $brand, $familyId, $userId, $metric, $windowDays,
+  $p05, $p10, $p50, $p90, $p95, $mean, $stddev, $sampleCount, now()
+)
+ON CONFLICT (brand, family_id, user_id, metric, window_days) DO UPDATE SET
+  p05 = excluded.p05,
+  p10 = excluded.p10,
+  p50 = excluded.p50,
+  p90 = excluded.p90,
+  p95 = excluded.p95,
+  mean = excluded.mean,
+  stddev = excluded.stddev,
+  sample_count = excluded.sample_count,
+  computed_at = excluded.computed_at
+`.trim();
+export function createBaselineComputer(config) {
+    const { analytics, eventBus, logger } = config;
+    const metrics = config.metrics ?? getBaselineMetricIds();
+    const windows = config.windows ?? BASELINE_WINDOW_DAYS;
+    async function computeOne(metric, windowDays, ctx) {
+        const sql = buildBaselineSql(metric, windowDays);
+        const rows = await analytics.execute(sql, {
+            userId: ctx.userId,
+            brand: ctx.brand,
+            familyId: ctx.familyId,
+            tz: ctx.userTimezone,
+            windowDays,
+        });
+        // HAVING filtered it out — fewer than BASELINE_MIN_DAYS distinct days.
+        // Not an error: a new user simply has no baseline yet, and consumers
+        // render "still learning" rather than a wrong range.
+        const row = rows[0];
+        if (!row || row.sample_count === null || row.sample_count < BASELINE_MIN_DAYS) {
+            logger?.debug('baseline: insufficient days, row not written', {
+                metric,
+                windowDays,
+                userId: ctx.userId,
+                sampleCount: row?.sample_count ?? 0,
+                required: BASELINE_MIN_DAYS,
+            });
+            return false;
+        }
+        await analytics.execute(UPSERT_SQL, {
+            brand: ctx.brand,
+            familyId: ctx.familyId,
+            userId: ctx.userId,
+            metric,
+            windowDays,
+            p05: row.p05,
+            p10: row.p10,
+            p50: row.p50,
+            p90: row.p90,
+            p95: row.p95,
+            mean: row.mean,
+            stddev: row.stddev,
+            sampleCount: row.sample_count,
+        });
+        // Registry queries (`spo2.compareBaseline`, `spo2.baselineMaturity`)
+        // invalidate on this.
+        eventBus?.emit('user_baseline:updated', {
+            userId: ctx.userId,
+            metric,
+            windowDays,
+            sampleCount: row.sample_count,
+            computedAt: new Date().toISOString(),
+        });
+        return true;
+    }
+    return {
+        computeOne,
+        async computeAll(ctx) {
+            let computed = 0;
+            let skipped = 0;
+            let failed = 0;
+            for (const metric of metrics) {
+                for (const windowDays of windows) {
+                    try {
+                        const written = await computeOne(metric, windowDays, ctx);
+                        if (written)
+                            computed += 1;
+                        else
+                            skipped += 1;
+                    }
+                    catch (err) {
+                        // One metric's failure must not abort the other twenty.
+                        failed += 1;
+                        logger?.warn('baseline: compute failed', {
+                            metric,
+                            windowDays,
+                            userId: ctx.userId,
+                            err: err instanceof Error ? err.message : String(err),
+                        });
+                    }
+                }
+            }
+            logger?.debug('baseline: compute cycle complete', {
+                userId: ctx.userId,
+                computed,
+                skipped,
+                failed,
+            });
+            return { computed, skipped, failed };
+        },
+    };
+}
+//# sourceMappingURL=baseline-compute.js.map