@mongrov/analytics 0.5.0 → 0.7.0

package/dist/tools/authorize.js

@@ -3,10 +3,20 @@
  *
  * `familyScopeAuthorize` — grants access iff `args.userId` is either
  * the requester themselves or another member of the requester's
- * family. When `config.familyMembersProvider` is supplied (the
- * factory path since T-11), membership resolves via that provider;
- * otherwise the legacy SQL path against a `family_member` table is
- * used (kept for standalone hook usage and backwards compat).
+ * family.
+ *
+ * Membership always resolves through the engine's configured
+ * `FamilyMembersProvider` (principle 39 — "Rules engine and AI tools
+ * share the same source of truth"): an explicitly-passed
+ * `config.familyMembersProvider` wins, otherwise `analytics
+ * .getFamilyMembers()` delegates to the one wired at `createAnalytics`.
+ *
+ * There is deliberately no SQL fallback. The spec's illustrative
+ * `SELECT 1 FROM family_member ...` referenced a table that no DDL in
+ * this package ever creates, so that path could only ever throw and
+ * fail closed — silently denying every cross-member query on any
+ * install that didn't pass a provider. Membership lives in the RxDB
+ * Family doc, not in DuckDB.
  *
  * Both hooks fail closed on any error — provider throws, engine
  * throws, missing/malformed args — return `false` rather than
@@ -21,22 +31,14 @@ export function familyScopeAuthorize(analytics, config = {}) {
         if (targetUserId === ctx.requesterUserId) {
             return true;
         }
-        if (config.familyMembersProvider) {
-            try {
-                const members = await config.familyMembersProvider({
+        try {
+            const members = config.familyMembersProvider
+                ? await config.familyMembersProvider({
                     brand: ctx.brand,
                     familyId: ctx.familyId,
-                });
-                return members.includes(targetUserId);
-            }
-            catch {
-                return false;
-            }
-        }
-        try {
-            const rows = await analytics.execute('SELECT 1 AS one FROM family_member '
-                + 'WHERE family_id = $familyId AND user_id = $userId LIMIT 1', { familyId: ctx.familyId, userId: targetUserId });
-            return rows.length > 0;
+                })
+                : await analytics.getFamilyMembers();
+            return members.includes(targetUserId);
         }
         catch {
             return false;
@@ -44,14 +46,11 @@ export function familyScopeAuthorize(analytics, config = {}) {
     };
 }
 /**
- * `orgScopeAuthorize` — parity with family scope but against an
- * `org_member` table. Orgs are not first-class in v0.1.0; the ctx
- * `familyId` is treated as the org id until org membership is wired
- * through `RequestContext`.
- *
- * When `familyMembersProvider` is supplied, the same provider is
- * consulted (v0.1.0 shim — a dedicated `orgMembersProvider` will
- * split out once orgs land).
+ * `orgScopeAuthorize` — parity with family scope. Orgs are not
+ * first-class in v0.1.0; the ctx `familyId` is treated as the org id
+ * until org membership is wired through `RequestContext`, and the same
+ * membership provider is consulted (v0.1.0 shim — a dedicated
+ * `orgMembersProvider` splits out once orgs land).
  */
 export function orgScopeAuthorize(analytics, config = {}) {
     return async (_toolName, args, ctx) => {
@@ -62,22 +61,14 @@ export function orgScopeAuthorize(analytics, config = {}) {
         if (targetUserId === ctx.requesterUserId) {
             return true;
         }
-        if (config.familyMembersProvider) {
-            try {
-                const members = await config.familyMembersProvider({
+        try {
+            const members = config.familyMembersProvider
+                ? await config.familyMembersProvider({
                     brand: ctx.brand,
                     familyId: ctx.familyId,
-                });
-                return members.includes(targetUserId);
-            }
-            catch {
-                return false;
-            }
-        }
-        try {
-            const rows = await analytics.execute('SELECT 1 AS one FROM org_member '
-                + 'WHERE org_id = $orgId AND user_id = $userId LIMIT 1', { orgId: ctx.familyId, userId: targetUserId });
-            return rows.length > 0;
+                })
+                : await analytics.getFamilyMembers();
+            return members.includes(targetUserId);
         }
         catch {
             return false;

package/dist/tools/authorize.js.map

@@ -1 +1 @@
-{"version":3,"file":"authorize.js","sourceRoot":"","sources":["../../src/tools/authorize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,MAAM,UAAU,oBAAoB,CAClC,SAA0B,EAC1B,SAA0B,EAAE;IAE5B,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAA;QAChC,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,YAAY,KAAK,GAAG,CAAC,eAAe,EAAE,CAAC;YACzC,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC;oBACjD,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;iBACvB,CAAC,CAAA;gBACF,OAAO,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;YACvC,CAAC;YACD,MAAM,CAAC;gBACL,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAClC,qCAAqC;kBACnC,2DAA2D,EAC7D,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CACjD,CAAA;YACD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;QACxB,CAAC;QACD,MAAM,CAAC;YACL,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAA0B,EAC1B,SAA0B,EAAE;IAE5B,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAA;QAChC,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,YAAY,KAAK,GAAG,CAAC,eAAe,EAAE,CAAC;YACzC,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC;oBACjD,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;iBACvB,CAAC,CAAA;gBACF,OAAO,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;YACvC,CAAC;YACD,MAAM,CAAC;gBACL,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAClC,kCAAkC;kBAChC,qDAAqD,EACvD,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAC9C,CAAA;YACD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;QACxB,CAAC;QACD,MAAM,CAAC;YACL,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"authorize.js","sourceRoot":"","sources":["../../src/tools/authorize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAaH,MAAM,UAAU,oBAAoB,CAClC,SAA0B,EAC1B,SAA0B,EAAE;IAE5B,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAA;QAChC,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,YAAY,KAAK,GAAG,CAAC,eAAe,EAAE,CAAC;YACzC,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,qBAAqB;gBAC1C,CAAC,CAAC,MAAM,MAAM,CAAC,qBAAqB,CAAC;oBACjC,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;iBACvB,CAAC;gBACJ,CAAC,CAAC,MAAM,SAAS,CAAC,gBAAgB,EAAE,CAAA;YACtC,OAAO,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;QACvC,CAAC;QACD,MAAM,CAAC;YACL,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAA0B,EAC1B,SAA0B,EAAE;IAE5B,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAA;QAChC,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,YAAY,KAAK,GAAG,CAAC,eAAe,EAAE,CAAC;YACzC,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,qBAAqB;gBAC1C,CAAC,CAAC,MAAM,MAAM,CAAC,qBAAqB,CAAC;oBACjC,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;iBACvB,CAAC;gBACJ,CAAC,CAAC,MAAM,SAAS,CAAC,gBAAgB,EAAE,CAAA;YACtC,OAAO,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;QACvC,CAAC;QACD,MAAM,CAAC;YACL,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/tools/factory.d.ts

@@ -23,6 +23,7 @@ import { type GetActivityTotalInput } from './impls/activity';
 import { type DetectAnomalyInput } from './impls/anomaly';
 import { type CompareTrendInput } from './impls/compare';
 import { type GetHRVInput } from './impls/hrv';
+import { type GetSpO2Input } from './impls/spo2';
 import { type GetInsightsInput } from './impls/insights';
 import { type GetSleepSummaryInput } from './impls/sleep';
 export interface AnalyticsToolMap {
@@ -31,6 +32,7 @@ export interface AnalyticsToolMap {
     getActivityTotal: ReturnType<typeof makeTool<GetActivityTotalInput>>;
     compareTrend: ReturnType<typeof makeTool<CompareTrendInput>>;
     detectAnomaly: ReturnType<typeof makeTool<DetectAnomalyInput>>;
+    getSpO2: ReturnType<typeof makeTool<GetSpO2Input>>;
     getInsights: ReturnType<typeof makeTool<GetInsightsInput>>;
 }
 export interface AnalyticsToolsHandle {

package/dist/tools/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/tools/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EAEX,WAAW,EACZ,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEjC,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AACzE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAA;AAoBtB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAA;IAChD,eAAe,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAA;IAClE,gBAAgB,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAA;IACpE,YAAY,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAC5D,aAAa,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAA;IAC9D,WAAW,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAA;CAC3D;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,gBAAgB,CAAA;IACvB,UAAU,EAAE,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;IAC7C,WAAW,EAAE,WAAW,CAAA;IACxB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,GAC3B,oBAAoB,CAiGtB"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/tools/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EAEX,WAAW,EACZ,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEjC,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AACzE,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAC7E,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAA;AAuBtB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAA;IAChD,eAAe,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAA;IAClE,gBAAgB,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAA;IACpE,YAAY,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAC5D,aAAa,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAA;IAC9D,OAAO,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAA;IAClD,WAAW,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAA;CAC3D;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,gBAAgB,CAAA;IACvB,UAAU,EAAE,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;IAC7C,WAAW,EAAE,WAAW,CAAA;IACxB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,GAC3B,oBAAoB,CAwGtB"}

package/dist/tools/factory.js

@@ -26,6 +26,7 @@ import { getActivityTotal, getActivityTotalInputSchema, } from './impls/activity
 import { detectAnomaly, detectAnomalyInputSchema, } from './impls/anomaly';
 import { compareTrend, compareTrendInputSchema, } from './impls/compare';
 import { getHRV, getHRVInputSchema } from './impls/hrv';
+import { getSpO2, getSpO2InputSchema } from './impls/spo2';
 import { getInsights, getInsightsInputSchema, } from './impls/insights';
 import { getSleepSummary, getSleepSummaryInputSchema, } from './impls/sleep';
 const DESCRIPTIONS = {
@@ -42,8 +43,11 @@ const DESCRIPTIONS = {
         + 'in a user\'s metric over the last lookbackDays. Args: userId, metric '
         + '(hrv_ms|sleep_total_minutes|activity_steps), lookbackDays (7..90), '
         + 'stddevThreshold (1..4, default 2).',
+    getSpO2: 'Return nightly blood-oxygen averages during sleep for a user, '
+        + 'with how many brief low moments occurred each night and how it '
+        + 'compares to their usual range. Args: userId, days (1..90).',
     getInsights: 'Return recent AI-generated insights for a user. Args: userId, '
-        + 'days (1..30, default 7), optional severity (info|warn|critical).',
+        + 'days (1..30, default 7), optional severity (info|warn|urgent).',
 };
 export function createAnalyticsTools(config) {
     const budget = {
@@ -80,6 +84,13 @@ export function createAnalyticsTools(config) {
         clock: config.clock,
     };
     const tools = {
+        getSpO2: makeTool({
+            ...shared,
+            name: 'getSpO2',
+            description: DESCRIPTIONS.getSpO2,
+            inputSchema: getSpO2InputSchema,
+            impl: getSpO2,
+        }),
         getHRV: makeTool({
             ...shared,
             name: 'getHRV',

package/dist/tools/factory.js.map

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

package/dist/tools/formatters/copy-guidelines.d.ts

@@ -0,0 +1,57 @@
+/**
+ * User-language guardrails for tool output (Sprint 5 §5 / T-29, Ziva #2,
+ * principle 37).
+ *
+ * Tool output goes into an LLM's context, and the LLM will parrot whatever
+ * register it finds there. If a formatter says "2 desaturation events", the
+ * assistant tells the user they had two desaturation events — which is
+ * clinical language Ziva is not licensed to speak and the user did not ask
+ * for. The fix is upstream of the model: never put the word in the context.
+ *
+ * This is a runtime guard, not a lint rule, because the failure mode is a
+ * formatter interpolating a value into a template that happens to read
+ * clinically. `assertNoBanTerms` runs on every formatter's return path and
+ * throws — a tool call that fails loudly is recoverable; one that quietly
+ * teaches the model to talk like a doctor is not.
+ */
+/**
+ * Vocabulary that must never reach the model.
+ *
+ * Matching is prefix-based on word boundaries, so listing `desaturation`
+ * also catches `desaturations` and `desaturating`. Inflections are still
+ * listed explicitly where they read differently, for documentation value.
+ */
+export declare const BANNED_MEDICAL_VOCABULARY: readonly ["desaturation", "desaturated", "desaturating", "hypoxia", "hypoxic", "hypoxemia", "apnea", "apneic", "arrhythmia", "arrhythmic", "bradycardia", "tachycardia", "ischemia", "ischemic"];
+export type BannedTerm = (typeof BANNED_MEDICAL_VOCABULARY)[number];
+/**
+ * What to write instead. Keys are the clinical phrasing a formatter author
+ * might reach for; values are the register Ziva actually speaks.
+ *
+ * Ordered longest-first at use time so multi-word phrases win over their
+ * constituent words.
+ */
+export declare const PREFERRED_LANGUAGE: Record<string, string>;
+/** Thrown when a formatter emits banned vocabulary. */
+export declare class FormatterCopyError extends Error {
+    readonly formatterName: string;
+    readonly found: string[];
+    constructor(formatterName: string, found: string[]);
+}
+/** Every banned term present in `text`, in list order. Empty when clean. */
+export declare function findBanTerms(text: string): string[];
+/**
+ * Guardrail called from every formatter's return path.
+ *
+ * @throws `FormatterCopyError` when any banned term appears.
+ */
+export declare function assertNoBanTerms(text: string, formatterName: string): void;
+/**
+ * Best-effort rewrite of clinical phrasing into Ziva's register.
+ *
+ * A convenience for formatter authors, NOT a substitute for the guard —
+ * it only knows the phrases in `PREFERRED_LANGUAGE`, so
+ * `assertNoBanTerms` still runs afterwards and still throws on anything
+ * it missed.
+ */
+export declare function applyPreferredLanguage(text: string): string;
+//# sourceMappingURL=copy-guidelines.d.ts.map

package/dist/tools/formatters/copy-guidelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-guidelines.d.ts","sourceRoot":"","sources":["../../../src/tools/formatters/copy-guidelines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,kMAe5B,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAYrD,CAAA;AAED,uDAAuD;AACvD,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAA;gBAEZ,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;CAUnD;AAWD,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAK1E;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY3D"}

package/dist/tools/formatters/copy-guidelines.js

@@ -0,0 +1,110 @@
+/**
+ * User-language guardrails for tool output (Sprint 5 §5 / T-29, Ziva #2,
+ * principle 37).
+ *
+ * Tool output goes into an LLM's context, and the LLM will parrot whatever
+ * register it finds there. If a formatter says "2 desaturation events", the
+ * assistant tells the user they had two desaturation events — which is
+ * clinical language Ziva is not licensed to speak and the user did not ask
+ * for. The fix is upstream of the model: never put the word in the context.
+ *
+ * This is a runtime guard, not a lint rule, because the failure mode is a
+ * formatter interpolating a value into a template that happens to read
+ * clinically. `assertNoBanTerms` runs on every formatter's return path and
+ * throws — a tool call that fails loudly is recoverable; one that quietly
+ * teaches the model to talk like a doctor is not.
+ */
+/**
+ * Vocabulary that must never reach the model.
+ *
+ * Matching is prefix-based on word boundaries, so listing `desaturation`
+ * also catches `desaturations` and `desaturating`. Inflections are still
+ * listed explicitly where they read differently, for documentation value.
+ */
+export const BANNED_MEDICAL_VOCABULARY = [
+    'desaturation',
+    'desaturated',
+    'desaturating',
+    'hypoxia',
+    'hypoxic',
+    'hypoxemia',
+    'apnea',
+    'apneic',
+    'arrhythmia',
+    'arrhythmic',
+    'bradycardia',
+    'tachycardia',
+    'ischemia',
+    'ischemic',
+];
+/**
+ * What to write instead. Keys are the clinical phrasing a formatter author
+ * might reach for; values are the register Ziva actually speaks.
+ *
+ * Ordered longest-first at use time so multi-word phrases win over their
+ * constituent words.
+ */
+export const PREFERRED_LANGUAGE = {
+    'oxygen desaturation': 'oxygen dip',
+    'desaturation event': 'brief low moment',
+    'desaturation events': 'brief low moments',
+    'desaturations': 'brief low moments',
+    'desaturation': 'brief low moment',
+    'hypoxemia': 'low oxygen',
+    'hypoxia': 'low oxygen',
+    'apnea': 'pauses in breathing',
+    'bradycardia': 'slow heart rate',
+    'tachycardia': 'fast heart rate',
+    'arrhythmia': 'irregular heartbeat',
+};
+/** Thrown when a formatter emits banned vocabulary. */
+export class FormatterCopyError extends Error {
+    constructor(formatterName, found) {
+        super(`Formatter '${formatterName}' emitted banned medical vocabulary: `
+            + `${found.join(', ')}. Use PREFERRED_LANGUAGE or rewrite — this text `
+            + `goes into an LLM's context and the model will repeat it.`);
+        this.name = 'FormatterCopyError';
+        this.formatterName = formatterName;
+        this.found = found;
+    }
+}
+/**
+ * Compiled matchers. Leading `\b` only: a trailing boundary would let
+ * `desaturations` slip past a `desaturation` entry, and over-blocking is
+ * the right bias for a guardrail on health copy.
+ */
+const MATCHERS = BANNED_MEDICAL_VOCABULARY.map(term => ({ term, re: new RegExp(`\\b${term}`, 'iu') }));
+/** Every banned term present in `text`, in list order. Empty when clean. */
+export function findBanTerms(text) {
+    return MATCHERS.filter(m => m.re.test(text)).map(m => m.term);
+}
+/**
+ * Guardrail called from every formatter's return path.
+ *
+ * @throws `FormatterCopyError` when any banned term appears.
+ */
+export function assertNoBanTerms(text, formatterName) {
+    const found = findBanTerms(text);
+    if (found.length > 0) {
+        throw new FormatterCopyError(formatterName, found);
+    }
+}
+/**
+ * Best-effort rewrite of clinical phrasing into Ziva's register.
+ *
+ * A convenience for formatter authors, NOT a substitute for the guard —
+ * it only knows the phrases in `PREFERRED_LANGUAGE`, so
+ * `assertNoBanTerms` still runs afterwards and still throws on anything
+ * it missed.
+ */
+export function applyPreferredLanguage(text) {
+    // Longest first, so 'oxygen desaturation' is replaced before
+    // 'desaturation' can consume half of it.
+    const phrases = Object.keys(PREFERRED_LANGUAGE).sort((a, b) => b.length - a.length);
+    let out = text;
+    for (const phrase of phrases) {
+        out = out.replace(new RegExp(`\\b${phrase}\\b`, 'giu'), PREFERRED_LANGUAGE[phrase]);
+    }
+    return out;
+}
+//# sourceMappingURL=copy-guidelines.js.map

package/dist/tools/formatters/copy-guidelines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-guidelines.js","sourceRoot":"","sources":["../../../src/tools/formatters/copy-guidelines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,cAAc;IACd,aAAa;IACb,cAAc;IACd,SAAS;IACT,SAAS;IACT,WAAW;IACX,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,aAAa;IACb,UAAU;IACV,UAAU;CACF,CAAA;AAIV;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,qBAAqB,EAAE,YAAY;IACnC,oBAAoB,EAAE,kBAAkB;IACxC,qBAAqB,EAAE,mBAAmB;IAC1C,eAAe,EAAE,mBAAmB;IACpC,cAAc,EAAE,kBAAkB;IAClC,WAAW,EAAE,YAAY;IACzB,SAAS,EAAE,YAAY;IACvB,OAAO,EAAE,qBAAqB;IAC9B,aAAa,EAAE,iBAAiB;IAChC,aAAa,EAAE,iBAAiB;IAChC,YAAY,EAAE,qBAAqB;CACpC,CAAA;AAED,uDAAuD;AACvD,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAI3C,YAAY,aAAqB,EAAE,KAAe;QAChD,KAAK,CACH,cAAc,aAAa,uCAAuC;cAChE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,kDAAkD;cACrE,0DAA0D,CAC7D,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;QAChC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,QAAQ,GAAmC,yBAAyB,CAAC,GAAG,CAC5E,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CACvD,CAAA;AAED,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,aAAqB;IAClE,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IAChC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,kBAAkB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;IACpD,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,6DAA6D;IAC7D,yCAAyC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAA;IACnF,IAAI,GAAG,GAAG,IAAI,CAAA;IACd,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,GAAG,GAAG,GAAG,CAAC,OAAO,CACf,IAAI,MAAM,CAAC,MAAM,MAAM,KAAK,EAAE,KAAK,CAAC,EACpC,kBAAkB,CAAC,MAAM,CAAC,CAC3B,CAAA;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/tools/formatters/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Formatter surface for `@mongrov/analytics/tools`.
+ *
+ * Two concerns, kept separate:
+ *
+ * - `text.ts` — mechanical string/number helpers (byte counts, deltas).
+ * - `copy-guidelines.ts` — the user-language guardrail (principle 37).
+ *   Every formatter calls `assertNoBanTerms` on its return path.
+ *
+ * Re-exported here so call sites keep importing from `'../formatters'`.
+ */
+export { deltaPct, formatBytes, popStddev } from './text';
+export { applyPreferredLanguage, assertNoBanTerms, BANNED_MEDICAL_VOCABULARY, type BannedTerm, findBanTerms, FormatterCopyError, PREFERRED_LANGUAGE, } from './copy-guidelines';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/formatters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/formatters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACzD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,yBAAyB,EACzB,KAAK,UAAU,EACf,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAA"}

package/dist/tools/formatters/index.js

@@ -0,0 +1,14 @@
+/**
+ * Formatter surface for `@mongrov/analytics/tools`.
+ *
+ * Two concerns, kept separate:
+ *
+ * - `text.ts` — mechanical string/number helpers (byte counts, deltas).
+ * - `copy-guidelines.ts` — the user-language guardrail (principle 37).
+ *   Every formatter calls `assertNoBanTerms` on its return path.
+ *
+ * Re-exported here so call sites keep importing from `'../formatters'`.
+ */
+export { deltaPct, formatBytes, popStddev } from './text';
+export { applyPreferredLanguage, assertNoBanTerms, BANNED_MEDICAL_VOCABULARY, findBanTerms, FormatterCopyError, PREFERRED_LANGUAGE, } from './copy-guidelines';
+//# sourceMappingURL=index.js.map

package/dist/tools/formatters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/formatters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACzD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,yBAAyB,EAEzB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAA"}

package/dist/tools/formatters/spo2.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `getSpO2` formatter (Sprint 5 T-31, Ziva #2).
+ *
+ * The reference implementation for principle 37. The underlying data has a
+ * field counting readings below 90% during sleep; the clinical word for
+ * that is on the banned list, so this formatter has to say what happened
+ * without reaching for it:
+ *
+ *   "A couple of brief low moments during sleep."
+ *
+ * not
+ *
+ *   "2 desaturation events. minSpo2=87."
+ *
+ * The second version is not just colder — it is the version the assistant
+ * repeats back to the user, which is how clinical vocabulary leaks into a
+ * consumer wellness product.
+ */
+import type { SpO2BaselineRow, SpO2NightRow } from '../impls/spo2';
+export declare function formatSpO2(nights: readonly SpO2NightRow[], baseline: SpO2BaselineRow | null, days: number): string;
+//# sourceMappingURL=spo2.d.ts.map

package/dist/tools/formatters/spo2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spo2.d.ts","sourceRoot":"","sources":["../../../src/tools/formatters/spo2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAmClE,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,QAAQ,EAAE,eAAe,GAAG,IAAI,EAChC,IAAI,EAAE,MAAM,GACX,MAAM,CAqCR"}

package/dist/tools/formatters/spo2.js

@@ -0,0 +1,79 @@
+/**
+ * `getSpO2` formatter (Sprint 5 T-31, Ziva #2).
+ *
+ * The reference implementation for principle 37. The underlying data has a
+ * field counting readings below 90% during sleep; the clinical word for
+ * that is on the banned list, so this formatter has to say what happened
+ * without reaching for it:
+ *
+ *   "A couple of brief low moments during sleep."
+ *
+ * not
+ *
+ *   "2 desaturation events. minSpo2=87."
+ *
+ * The second version is not just colder — it is the version the assistant
+ * repeats back to the user, which is how clinical vocabulary leaks into a
+ * consumer wellness product.
+ */
+import { assertNoBanTerms } from './copy-guidelines';
+const FORMATTER_NAME = 'getSpO2';
+/**
+ * Small counts read better as words, and vague is honest here — the exact
+ * count of dips is not a number the user should be doing arithmetic on.
+ */
+function describeLowMoments(count) {
+    if (count === 0)
+        return 'No brief low moments';
+    if (count === 1)
+        return 'One brief low moment';
+    if (count === 2)
+        return 'A couple of brief low moments';
+    if (count <= 5)
+        return 'A few brief low moments';
+    return 'Several brief low moments';
+}
+/** "in your usual range" needs a usual range to compare against. */
+function describeRange(avg, baseline) {
+    if (!baseline) {
+        // Below 20 days of data. Saying nothing is better than implying a
+        // reference range we do not have.
+        return 'Still learning your usual range.';
+    }
+    const lo = Math.round(baseline.p10);
+    const hi = Math.round(baseline.p50 + (baseline.p50 - baseline.p10));
+    const within = avg >= baseline.p10;
+    return within
+        ? `Overall in your usual range (typically ${lo}–${hi}%).`
+        : `A little below your usual range (typically ${lo}–${hi}%).`;
+}
+export function formatSpO2(nights, baseline, days) {
+    if (nights.length === 0) {
+        const empty = days === 1
+            ? 'No sleep readings for last night yet.'
+            : `No sleep readings in the last ${days} days yet.`;
+        assertNoBanTerms(empty, FORMATTER_NAME);
+        return empty;
+    }
+    const latest = nights[nights.length - 1];
+    const lines = [];
+    if (nights.length === 1) {
+        lines.push('Last night:');
+    }
+    else {
+        lines.push(`Last ${nights.length} nights:`);
+    }
+    lines.push(`  Average oxygen: ${Math.round(latest.avg_spo2)}%. `
+        + `${describeLowMoments(latest.low_moment_count)} during sleep.`);
+    if (nights.length > 1) {
+        const avgAll = nights.reduce((a, n) => a + n.avg_spo2, 0) / nights.length;
+        lines.push(`  Across those nights: ${Math.round(avgAll)}% on average.`);
+    }
+    lines.push(`  ${describeRange(latest.avg_spo2, baseline)}`);
+    const text = lines.join('\n');
+    // Runtime guard, not just a test: a future edit that interpolates a
+    // clinical phrase fails the tool call rather than teaching the model.
+    assertNoBanTerms(text, FORMATTER_NAME);
+    return text;
+}
+//# sourceMappingURL=spo2.js.map

package/dist/tools/formatters/spo2.js.map

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

package/dist/tools/{formatters.d.ts → formatters/text.d.ts}

@@ -14,4 +14,4 @@ export declare function formatBytes(s: string): number;
 export declare function deltaPct(current: number, prior: number): string;
 /** Population stddev; returns 0 when the sample is empty. */
 export declare function popStddev(values: number[]): number;
-//# sourceMappingURL=formatters.d.ts.map
+//# sourceMappingURL=text.d.ts.map

package/dist/tools/formatters/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/tools/formatters/text.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAMlD"}

package/dist/tools/{formatters.js → formatters/text.js}

@@ -27,4 +27,4 @@ export function popStddev(values) {
     const variance = values.reduce((a, v) => a + (v - mean) ** 2, 0) / values.length;
     return Math.sqrt(variance);
 }
-//# sourceMappingURL=formatters.js.map
+//# sourceMappingURL=text.js.map

package/dist/tools/formatters/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/tools/formatters/text.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAA;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,KAAa;IACrD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC7B,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAA;IAC7C,OAAO,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;AACnD,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,SAAS,CAAC,MAAgB;IACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAA;IAC9D,MAAM,QAAQ,GACV,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAA;IACnE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;AAC5B,CAAC"}

package/dist/tools/impls/activity.d.ts

@@ -4,11 +4,11 @@ export declare const getActivityTotalInputSchema: z.ZodObject<{
     userId: z.ZodString;
     days: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    days: number;
     userId: string;
-}, {
     days: number;
+}, {
     userId: string;
+    days: number;
 }>;
 export type GetActivityTotalInput = z.infer<typeof getActivityTotalInputSchema>;
 export declare const getActivityTotal: ToolImpl<GetActivityTotalInput>;

package/dist/tools/impls/activity.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { formatBytes } from '../formatters';
+import { assertNoBanTerms, formatBytes } from '../formatters';
 export const getActivityTotalInputSchema = z.object({
     userId: z.string(),
     days: z.number().int().min(1).max(90),
@@ -12,14 +12,14 @@ export const getActivityTotal = async (input, ctx) => {
         days: input.days,
     };
     const steps = await ctx.analytics.execute(`SELECT date_trunc('day', ts)::VARCHAR AS day, SUM(steps)::INTEGER AS steps
-     FROM activity
+     FROM v_activity
      WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
        AND ts >= now() - INTERVAL ($days) DAY
      GROUP BY 1 ORDER BY 1`, params);
     const buckets = await ctx.analytics.execute(`SELECT date_trunc('day', ts)::VARCHAR AS day,
             SUM(calories)::DOUBLE AS calories,
             SUM(distance_km)::DOUBLE AS distance_km
-     FROM activity_bucket
+     FROM v_activity_bucket
      WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
        AND ts >= now() - INTERVAL ($days) DAY
      GROUP BY 1 ORDER BY 1`, params);
@@ -56,6 +56,10 @@ export const getActivityTotal = async (input, ctx) => {
     return finalize(text, orderedDays.length);
 };
 function finalize(text, rowCount) {
+    // principle 37 — every formatter's return path is guarded, not
+    // just the SpO2 one. Tool text lands in an LLM's context, and the
+    // model repeats whatever register it finds there.
+    assertNoBanTerms(text, 'getActivityTotal');
     return { text, rowCount, bytes: formatBytes(text) };
 }
 //# sourceMappingURL=activity.js.map

package/dist/tools/impls/activity.js.map

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

package/dist/tools/impls/anomaly.d.ts

@@ -6,13 +6,13 @@ export declare const detectAnomalyInputSchema: z.ZodObject<{
     lookbackDays: z.ZodNumber;
     stddevThreshold: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    metric: "hrv_ms" | "activity_steps" | "sleep_total_minutes";
     userId: string;
+    metric: "hrv_ms" | "activity_steps" | "sleep_total_minutes";
     lookbackDays: number;
     stddevThreshold: number;
 }, {
-    metric: "hrv_ms" | "activity_steps" | "sleep_total_minutes";
     userId: string;
+    metric: "hrv_ms" | "activity_steps" | "sleep_total_minutes";
     lookbackDays: number;
     stddevThreshold?: number | undefined;
 }>;