@elizaos/plugin-health 2.0.0-beta.1

package/dist/index.js

@@ -0,0 +1,62 @@
+import { logger } from "@elizaos/core";
+import {
+  HEALTH_ANCHORS,
+  HEALTH_BUS_FAMILIES,
+  HEALTH_CONNECTOR_KINDS,
+  registerHealthAnchors,
+  registerHealthBusFamilies,
+  registerHealthConnectors
+} from "./connectors/index.js";
+import { registerCircadianInsightContract } from "./contracts/circadian.js";
+import { createDefaultCircadianInsightContract } from "./contracts/circadian-default.js";
+import {
+  HEALTH_DEFAULT_PACKS,
+  registerHealthDefaultPacks
+} from "./default-packs/index.js";
+export * from "./actions/index.js";
+export * from "./anchors/index.js";
+export * from "./connectors/index.js";
+export * from "./contracts/circadian.js";
+export * from "./contracts/circadian-default.js";
+export * from "./contracts/health.js";
+export * from "./default-packs/index.js";
+export * from "./health-bridge/index.js";
+export * from "./screen-time/index.js";
+export * from "./sleep/index.js";
+export * from "./util/index.js";
+const HEALTH_PLUGIN_NAME = "plugin-health";
+const healthPlugin = {
+  name: HEALTH_PLUGIN_NAME,
+  description: "Health, sleep, circadian and screen-time domain plugin \u2014 extracted from app-lifeops in Wave-1 (W1-B).",
+  services: [],
+  actions: [],
+  providers: [],
+  tests: [],
+  init: async (_config, runtime) => {
+    logger.info(
+      {
+        src: "plugin:health",
+        connectors: HEALTH_CONNECTOR_KINDS,
+        anchors: HEALTH_ANCHORS,
+        busFamilies: HEALTH_BUS_FAMILIES,
+        defaultPacks: HEALTH_DEFAULT_PACKS.map((p) => p.key)
+      },
+      "Initializing plugin-health (Wave-1 W1-B)"
+    );
+    registerHealthConnectors(runtime);
+    registerHealthAnchors(runtime);
+    registerHealthBusFamilies(runtime);
+    registerHealthDefaultPacks(runtime);
+    registerCircadianInsightContract(
+      runtime,
+      createDefaultCircadianInsightContract()
+    );
+  }
+};
+var index_default = healthPlugin;
+export {
+  HEALTH_PLUGIN_NAME,
+  index_default as default,
+  healthPlugin
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @elizaos/plugin-health — Wave-1 (W1-B) extraction.\n *\n * Owns the sleep / circadian / health-metric / screen-time domain previously\n * intermingled with `app-lifeops`. LifeOps consumes plugin-health through:\n *\n *   - `ConnectorRegistry` contributions (apple_health, google_fit, strava,\n *     fitbit, withings, oura)\n *   - `ActivitySignalBus` publications (`health.sleep.detected`,\n *     `health.wake.observed`, `health.wake.confirmed`,\n *     `health.bedtime.imminent`, `health.regularity.changed`,\n *     `health.workout.completed`, …)\n *   - `AnchorRegistry` contributions (`wake.observed`, `wake.confirmed`,\n *     `bedtime.target`, `nap.start`)\n *   - Default-pack `ScheduledTask` records (bedtime / wake-up / sleep-recap)\n *\n * See `eliza/plugins/app-lifeops/docs/audit/IMPLEMENTATION_PLAN.md` §3.2 and\n * `wave1-interfaces.md` §5 for the canonical scope.\n */\n\nimport type { IAgentRuntime, Plugin } from \"@elizaos/core\";\nimport { logger } from \"@elizaos/core\";\nimport {\n  HEALTH_ANCHORS,\n  HEALTH_BUS_FAMILIES,\n  HEALTH_CONNECTOR_KINDS,\n  registerHealthAnchors,\n  registerHealthBusFamilies,\n  registerHealthConnectors,\n} from \"./connectors/index.js\";\nimport { registerCircadianInsightContract } from \"./contracts/circadian.js\";\nimport { createDefaultCircadianInsightContract } from \"./contracts/circadian-default.js\";\nimport {\n  HEALTH_DEFAULT_PACKS,\n  registerHealthDefaultPacks,\n} from \"./default-packs/index.js\";\n\n// Public surface — consumers (app-lifeops + future plugins) import the\n// helpers they need by name from `@elizaos/plugin-health`.\n\nexport * from \"./actions/index.js\";\nexport * from \"./anchors/index.js\";\nexport * from \"./connectors/index.js\";\nexport * from \"./contracts/circadian.js\";\nexport * from \"./contracts/circadian-default.js\";\nexport * from \"./contracts/health.js\";\nexport * from \"./default-packs/index.js\";\nexport * from \"./health-bridge/index.js\";\nexport * from \"./screen-time/index.js\";\nexport * from \"./sleep/index.js\";\nexport * from \"./util/index.js\";\n\nexport const HEALTH_PLUGIN_NAME = \"plugin-health\";\n\n/**\n * elizaOS plugin entry. Registers connector / anchor / bus-family / default-pack\n * contributions when the W1-A and W1-F runtime registries are available; logs\n * a one-line skip reason when they are not (Wave-1 soft dependency posture\n * per `IMPLEMENTATION_PLAN.md` §3.2).\n */\nexport const healthPlugin: Plugin = {\n  name: HEALTH_PLUGIN_NAME,\n  description:\n    \"Health, sleep, circadian and screen-time domain plugin — extracted from app-lifeops in Wave-1 (W1-B).\",\n  services: [],\n  actions: [],\n  providers: [],\n  tests: [],\n  init: async (\n    _config: Record<string, string>,\n    runtime: IAgentRuntime,\n  ): Promise<void> => {\n    logger.info(\n      {\n        src: \"plugin:health\",\n        connectors: HEALTH_CONNECTOR_KINDS,\n        anchors: HEALTH_ANCHORS,\n        busFamilies: HEALTH_BUS_FAMILIES,\n        defaultPacks: HEALTH_DEFAULT_PACKS.map((p) => p.key),\n      },\n      \"Initializing plugin-health (Wave-1 W1-B)\",\n    );\n    registerHealthConnectors(runtime);\n    registerHealthAnchors(runtime);\n    registerHealthBusFamilies(runtime);\n    registerHealthDefaultPacks(runtime);\n    // W3-C drift D-4: register the CircadianInsightContract so consumers\n    // (SCHEDULE, SCHEDULED_TASK, future planner reads) read through a\n    // typed runtime seam instead of reaching into plugin-health internals.\n    registerCircadianInsightContract(\n      runtime,\n      createDefaultCircadianInsightContract(),\n    );\n  },\n};\n\nexport default healthPlugin;\n// `./<name>.js` (without /index) is a TypeScript-only directory-shorthand\n// that Bun's runtime ESM resolver does not honor. The `./sleep`,\n// `./health-bridge`, `./screen-time`, and `./actions` are all directories\n// that already have proper `./<name>/index.js` re-exports above (lines\n// 39, 44-46) so these duplicate flat-file forms only break runtime\n// imports without adding anything.\n"],"mappings":"AAqBA,SAAS,cAAc;AACvB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,wCAAwC;AACjD,SAAS,6CAA6C;AACtD;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAKP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEP,MAAM,qBAAqB;AAQ3B,MAAM,eAAuB;AAAA,EAClC,MAAM;AAAA,EACN,aACE;AAAA,EACF,UAAU,CAAC;AAAA,EACX,SAAS,CAAC;AAAA,EACV,WAAW,CAAC;AAAA,EACZ,OAAO,CAAC;AAAA,EACR,MAAM,OACJ,SACA,YACkB;AAClB,WAAO;AAAA,MACL;AAAA,QACE,KAAK;AAAA,QACL,YAAY;AAAA,QACZ,SAAS;AAAA,QACT,aAAa;AAAA,QACb,cAAc,qBAAqB,IAAI,CAAC,MAAM,EAAE,GAAG;AAAA,MACrD;AAAA,MACA;AAAA,IACF;AACA,6BAAyB,OAAO;AAChC,0BAAsB,OAAO;AAC7B,8BAA0B,OAAO;AACjC,+BAA2B,OAAO;AAIlC;AAAA,MACE;AAAA,MACA,sCAAsC;AAAA,IACxC;AAAA,EACF;AACF;AAEA,IAAO,gBAAQ;","names":[]}

package/dist/screen-time/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Screen-time domain entry point.
+ *
+ * Wave-1 (W1-B) note: the bulk of the screen-time aggregation lives in
+ * `app-lifeops/src/lifeops/service-mixin-screentime.ts`. That mixin
+ * pre-dates the plugin-health extraction and is deeply coupled to the
+ * `LifeOpsServiceBase` repository / activity-profile reporting layer
+ * (`getActivityReportBetween`, `isSystemInactivityApp`, etc.). Moving it
+ * physically to plugin-health would require either dragging the entire
+ * activity-profile module or introducing a circular package dependency
+ * (plugin-health → app-lifeops). Wave-2 (W2-D: Signal-bus + anchors +
+ * identity-observation cleanup) is the right home for that decoupling.
+ *
+ * For now, plugin-health publishes the `LifeOpsScreenTimeSummaryPayload`
+ * contract (re-exported from `../contracts/health.ts`); app-lifeops
+ * continues to host the aggregator and emits payloads on the W2-D bus once
+ * it lands.
+ *
+ * No runtime exports here — the type re-export carries the canonical
+ * contract surface.
+ */
+export type { LifeOpsScreenTimePerAppUsage, LifeOpsScreenTimeSummaryPayload, } from "../contracts/health.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/screen-time/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/screen-time/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,YAAY,EACV,4BAA4B,EAC5B,+BAA+B,GAChC,MAAM,wBAAwB,CAAC"}

package/dist/screen-time/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/dist/screen-time/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/sleep/awake-probability.d.ts

@@ -0,0 +1,11 @@
+import type { LifeOpsActivitySignal, LifeOpsAwakeProbability, LifeOpsScheduleRegularity, LifeOpsSleepCycle } from "../contracts/health.js";
+import type { LifeOpsActivityWindow } from "./sleep-cycle.js";
+export declare function computeAwakeProbability(args: {
+    nowMs: number;
+    timezone: string;
+    signals: readonly LifeOpsActivitySignal[];
+    windows: readonly LifeOpsActivityWindow[];
+    sleepCycle: Pick<LifeOpsSleepCycle, "isProbablySleeping" | "sleepConfidence" | "currentSleepStartedAt" | "lastSleepEndedAt" | "sleepStatus" | "evidence">;
+    regularity: LifeOpsScheduleRegularity;
+}): LifeOpsAwakeProbability;
+//# sourceMappingURL=awake-probability.d.ts.map

package/dist/sleep/awake-probability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"awake-probability.d.ts","sourceRoot":"","sources":["../../src/sleep/awake-probability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAoB9D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1C,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1C,UAAU,EAAE,IAAI,CACd,iBAAiB,EACf,oBAAoB,GACpB,iBAAiB,GACjB,uBAAuB,GACvB,kBAAkB,GAClB,aAAa,GACb,UAAU,CACb,CAAC;IACF,UAAU,EAAE,yBAAyB,CAAC;CACvC,GAAG,uBAAuB,CA6L1B"}

package/dist/sleep/awake-probability.js

@@ -0,0 +1,163 @@
+import { getZonedDateParts } from "../util/time.js";
+import { parseIsoMs } from "../util/time-util.js";
+import { resolveActivitySignalReliability } from "./source-reliability.js";
+function clamp(value, min, max) {
+  return Math.min(max, Math.max(min, value));
+}
+function round(value) {
+  return Math.round(clamp(value, 0, 1) * 100) / 100;
+}
+function logistic(value) {
+  return 1 / (1 + Math.exp(-value));
+}
+function localHour(nowMs, timezone) {
+  const parts = getZonedDateParts(new Date(nowMs), timezone);
+  return parts.hour + parts.minute / 60;
+}
+function computeAwakeProbability(args) {
+  const contributors = [];
+  let llr = 0;
+  const latestSignal = [...args.signals].map((signal) => ({
+    signal,
+    observedAtMs: parseIsoMs(signal.observedAt)
+  })).filter(
+    (candidate) => candidate.observedAtMs !== null
+  ).sort((left, right) => right.observedAtMs - left.observedAtMs)[0];
+  const hasConcurrentOwnerInteraction = args.signals.some((signal) => {
+    const observedAt = parseIsoMs(signal.observedAt);
+    if (observedAt === null) return false;
+    if (args.nowMs - observedAt > 5 * 6e4) return false;
+    if (signal.source === "desktop_interaction") return true;
+    if (signal.source === "mobile_device" && signal.state === "active") {
+      return true;
+    }
+    if (signal.source === "app_lifecycle" && signal.platform === "manual_override") {
+      return true;
+    }
+    if (typeof signal.idleTimeSeconds === "number" && signal.idleTimeSeconds <= 60) {
+      return true;
+    }
+    return false;
+  });
+  if (latestSignal) {
+    const ageMs = args.nowMs - latestSignal.observedAtMs;
+    const state = latestSignal.signal.state;
+    const reliability = resolveActivitySignalReliability(
+      latestSignal.signal.source,
+      latestSignal.signal.platform
+    );
+    let scale = clamp(reliability, 0, 1);
+    const isSharedDeviceRisk = latestSignal.signal.source === "app_lifecycle" && latestSignal.signal.platform !== "manual_override" && state === "active";
+    if (isSharedDeviceRisk && !hasConcurrentOwnerInteraction) {
+      scale *= 0.25;
+    }
+    let baseWeight = 0;
+    if (state === "active" && ageMs <= 5 * 6e4) {
+      baseWeight = 2.4;
+    } else if (state === "active" && ageMs <= 15 * 6e4) {
+      baseWeight = 1.4;
+    } else if ((state === "idle" || state === "locked" || state === "sleeping") && ageMs <= 90 * 6e4) {
+      baseWeight = state === "sleeping" ? -2.2 : state === "locked" ? -1.2 : -0.8;
+    }
+    if (baseWeight !== 0) {
+      const scaledWeight = baseWeight * scale;
+      contributors.push({
+        source: latestSignal.signal.source,
+        logLikelihoodRatio: scaledWeight
+      });
+      llr += scaledWeight;
+    }
+  }
+  const currentSleepStartMs = parseIsoMs(args.sleepCycle.currentSleepStartedAt);
+  if (args.sleepCycle.sleepStatus === "sleeping_now" && currentSleepStartMs !== null && args.nowMs >= currentSleepStartMs) {
+    const strongestEvidence = [...args.sleepCycle.evidence].sort(
+      (left, right) => right.confidence - left.confidence
+    )[0]?.source ?? "activity_gap";
+    const sleepWeight = -2.8 * clamp(args.sleepCycle.sleepConfidence, 0.3, 1);
+    contributors.push({
+      source: strongestEvidence,
+      logLikelihoodRatio: sleepWeight
+    });
+    llr += sleepWeight;
+  }
+  const wakeAtMs = parseIsoMs(args.sleepCycle.lastSleepEndedAt);
+  if (wakeAtMs !== null) {
+    const minutesSinceWake = (args.nowMs - wakeAtMs) / 6e4;
+    if (minutesSinceWake >= 0 && minutesSinceWake <= 120) {
+      contributors.push({
+        source: "health",
+        logLikelihoodRatio: 1.6
+      });
+      llr += 1.6;
+    }
+  }
+  const latestWindowEndMs = args.windows.length > 0 ? args.windows[args.windows.length - 1]?.endMs ?? null : null;
+  if (latestWindowEndMs !== null) {
+    const gapMinutes = Math.max(
+      0,
+      Math.round((args.nowMs - latestWindowEndMs) / 6e4)
+    );
+    if (gapMinutes >= 180) {
+      const sleepGapWeight = -clamp(gapMinutes / 240, 0.8, 1.8);
+      contributors.push({
+        source: "activity_gap",
+        logLikelihoodRatio: sleepGapWeight
+      });
+      llr += sleepGapWeight;
+    } else if (gapMinutes <= 15) {
+      contributors.push({
+        source: "activity_gap",
+        logLikelihoodRatio: 0.8
+      });
+      llr += 0.8;
+    }
+  }
+  if (args.regularity.regularityClass === "regular" || args.regularity.regularityClass === "very_regular") {
+    const hour = localHour(args.nowMs, args.timezone);
+    const sleepWindowWeight = hour >= 22 || hour < 6 ? -0.9 : hour >= 6 && hour < 10 ? 0.5 : 0.1;
+    const scaledWeight = sleepWindowWeight * clamp(args.regularity.sri / 100, 0.4, 1);
+    contributors.push({
+      source: "prior",
+      logLikelihoodRatio: scaledWeight
+    });
+    llr += scaledWeight;
+  }
+  const signalCoverage = clamp(args.signals.length / 12, 0, 1);
+  const windowCoverage = args.windows.length > 0 ? 1 : 0;
+  let evidenceCoverage = clamp(
+    signalCoverage * 0.7 + windowCoverage * 0.2 + Math.min(contributors.length, 4) * 0.1,
+    0.15,
+    1
+  );
+  if (args.sleepCycle.sleepStatus === "sleeping_now") {
+    evidenceCoverage = Math.max(evidenceCoverage, 0.9);
+  } else if (wakeAtMs !== null && args.nowMs - wakeAtMs <= 2 * 60 * 60 * 1e3) {
+    evidenceCoverage = Math.max(evidenceCoverage, 0.75);
+  }
+  const pKnown = round(evidenceCoverage);
+  const awakeKnown = logistic(llr);
+  const pAwake = round(awakeKnown * pKnown);
+  const pAsleep = round((1 - awakeKnown) * pKnown);
+  const pUnknown = round(clamp(1 - pKnown, 0, 1));
+  const total = pAwake + pAsleep + pUnknown;
+  if (total <= 0) {
+    return {
+      pAwake: 0,
+      pAsleep: 0,
+      pUnknown: 1,
+      contributingSources: [],
+      computedAt: new Date(args.nowMs).toISOString()
+    };
+  }
+  return {
+    pAwake: round(pAwake / total),
+    pAsleep: round(pAsleep / total),
+    pUnknown: round(pUnknown / total),
+    contributingSources: contributors,
+    computedAt: new Date(args.nowMs).toISOString()
+  };
+}
+export {
+  computeAwakeProbability
+};
+//# sourceMappingURL=awake-probability.js.map

package/dist/sleep/awake-probability.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sleep/awake-probability.ts"],"sourcesContent":["import type {\n  LifeOpsActivitySignal,\n  LifeOpsAwakeProbability,\n  LifeOpsScheduleRegularity,\n  LifeOpsSleepCycle,\n} from \"../contracts/health.js\";\nimport { getZonedDateParts } from \"../util/time.js\";\nimport { parseIsoMs } from \"../util/time-util.js\";\nimport type { LifeOpsActivityWindow } from \"./sleep-cycle.js\";\nimport { resolveActivitySignalReliability } from \"./source-reliability.js\";\n\nfunction clamp(value: number, min: number, max: number): number {\n  return Math.min(max, Math.max(min, value));\n}\n\nfunction round(value: number): number {\n  return Math.round(clamp(value, 0, 1) * 100) / 100;\n}\n\nfunction logistic(value: number): number {\n  return 1 / (1 + Math.exp(-value));\n}\n\nfunction localHour(nowMs: number, timezone: string): number {\n  const parts = getZonedDateParts(new Date(nowMs), timezone);\n  return parts.hour + parts.minute / 60;\n}\n\nexport function computeAwakeProbability(args: {\n  nowMs: number;\n  timezone: string;\n  signals: readonly LifeOpsActivitySignal[];\n  windows: readonly LifeOpsActivityWindow[];\n  sleepCycle: Pick<\n    LifeOpsSleepCycle,\n    | \"isProbablySleeping\"\n    | \"sleepConfidence\"\n    | \"currentSleepStartedAt\"\n    | \"lastSleepEndedAt\"\n    | \"sleepStatus\"\n    | \"evidence\"\n  >;\n  regularity: LifeOpsScheduleRegularity;\n}): LifeOpsAwakeProbability {\n  const contributors: LifeOpsAwakeProbability[\"contributingSources\"] = [];\n  let llr = 0;\n\n  const latestSignal = [...args.signals]\n    .map((signal) => ({\n      signal,\n      observedAtMs: parseIsoMs(signal.observedAt),\n    }))\n    .filter(\n      (\n        candidate,\n      ): candidate is { signal: LifeOpsActivitySignal; observedAtMs: number } =>\n        candidate.observedAtMs !== null,\n    )\n    .sort((left, right) => right.observedAtMs - left.observedAtMs)[0];\n\n  const hasConcurrentOwnerInteraction = args.signals.some((signal) => {\n    const observedAt = parseIsoMs(signal.observedAt);\n    if (observedAt === null) return false;\n    if (args.nowMs - observedAt > 5 * 60_000) return false;\n    if (signal.source === \"desktop_interaction\") return true;\n    if (signal.source === \"mobile_device\" && signal.state === \"active\") {\n      return true;\n    }\n    if (\n      signal.source === \"app_lifecycle\" &&\n      signal.platform === \"manual_override\"\n    ) {\n      return true;\n    }\n    if (\n      typeof signal.idleTimeSeconds === \"number\" &&\n      signal.idleTimeSeconds <= 60\n    ) {\n      return true;\n    }\n    return false;\n  });\n\n  if (latestSignal) {\n    const ageMs = args.nowMs - latestSignal.observedAtMs;\n    const state = latestSignal.signal.state;\n    const reliability = resolveActivitySignalReliability(\n      latestSignal.signal.source,\n      latestSignal.signal.platform,\n    );\n    let scale = clamp(reliability, 0, 1);\n    const isSharedDeviceRisk =\n      latestSignal.signal.source === \"app_lifecycle\" &&\n      latestSignal.signal.platform !== \"manual_override\" &&\n      state === \"active\";\n    if (isSharedDeviceRisk && !hasConcurrentOwnerInteraction) {\n      scale *= 0.25;\n    }\n    let baseWeight = 0;\n    if (state === \"active\" && ageMs <= 5 * 60_000) {\n      baseWeight = 2.4;\n    } else if (state === \"active\" && ageMs <= 15 * 60_000) {\n      baseWeight = 1.4;\n    } else if (\n      (state === \"idle\" || state === \"locked\" || state === \"sleeping\") &&\n      ageMs <= 90 * 60_000\n    ) {\n      baseWeight =\n        state === \"sleeping\" ? -2.2 : state === \"locked\" ? -1.2 : -0.8;\n    }\n    if (baseWeight !== 0) {\n      const scaledWeight = baseWeight * scale;\n      contributors.push({\n        source: latestSignal.signal.source,\n        logLikelihoodRatio: scaledWeight,\n      });\n      llr += scaledWeight;\n    }\n  }\n\n  const currentSleepStartMs = parseIsoMs(args.sleepCycle.currentSleepStartedAt);\n  if (\n    args.sleepCycle.sleepStatus === \"sleeping_now\" &&\n    currentSleepStartMs !== null &&\n    args.nowMs >= currentSleepStartMs\n  ) {\n    const strongestEvidence =\n      [...args.sleepCycle.evidence].sort(\n        (left, right) => right.confidence - left.confidence,\n      )[0]?.source ?? \"activity_gap\";\n    const sleepWeight = -2.8 * clamp(args.sleepCycle.sleepConfidence, 0.3, 1);\n    contributors.push({\n      source: strongestEvidence,\n      logLikelihoodRatio: sleepWeight,\n    });\n    llr += sleepWeight;\n  }\n\n  const wakeAtMs = parseIsoMs(args.sleepCycle.lastSleepEndedAt);\n  if (wakeAtMs !== null) {\n    const minutesSinceWake = (args.nowMs - wakeAtMs) / 60_000;\n    if (minutesSinceWake >= 0 && minutesSinceWake <= 120) {\n      contributors.push({\n        source: \"health\",\n        logLikelihoodRatio: 1.6,\n      });\n      llr += 1.6;\n    }\n  }\n\n  const latestWindowEndMs =\n    args.windows.length > 0\n      ? (args.windows[args.windows.length - 1]?.endMs ?? null)\n      : null;\n  if (latestWindowEndMs !== null) {\n    const gapMinutes = Math.max(\n      0,\n      Math.round((args.nowMs - latestWindowEndMs) / 60_000),\n    );\n    if (gapMinutes >= 180) {\n      const sleepGapWeight = -clamp(gapMinutes / 240, 0.8, 1.8);\n      contributors.push({\n        source: \"activity_gap\",\n        logLikelihoodRatio: sleepGapWeight,\n      });\n      llr += sleepGapWeight;\n    } else if (gapMinutes <= 15) {\n      contributors.push({\n        source: \"activity_gap\",\n        logLikelihoodRatio: 0.8,\n      });\n      llr += 0.8;\n    }\n  }\n\n  if (\n    args.regularity.regularityClass === \"regular\" ||\n    args.regularity.regularityClass === \"very_regular\"\n  ) {\n    const hour = localHour(args.nowMs, args.timezone);\n    const sleepWindowWeight =\n      hour >= 22 || hour < 6 ? -0.9 : hour >= 6 && hour < 10 ? 0.5 : 0.1;\n    const scaledWeight =\n      sleepWindowWeight * clamp(args.regularity.sri / 100, 0.4, 1);\n    contributors.push({\n      source: \"prior\",\n      logLikelihoodRatio: scaledWeight,\n    });\n    llr += scaledWeight;\n  }\n\n  const signalCoverage = clamp(args.signals.length / 12, 0, 1);\n  const windowCoverage = args.windows.length > 0 ? 1 : 0;\n  let evidenceCoverage = clamp(\n    signalCoverage * 0.7 +\n      windowCoverage * 0.2 +\n      Math.min(contributors.length, 4) * 0.1,\n    0.15,\n    1,\n  );\n  if (args.sleepCycle.sleepStatus === \"sleeping_now\") {\n    evidenceCoverage = Math.max(evidenceCoverage, 0.9);\n  } else if (\n    wakeAtMs !== null &&\n    args.nowMs - wakeAtMs <= 2 * 60 * 60 * 1_000\n  ) {\n    evidenceCoverage = Math.max(evidenceCoverage, 0.75);\n  }\n  const pKnown = round(evidenceCoverage);\n  const awakeKnown = logistic(llr);\n  const pAwake = round(awakeKnown * pKnown);\n  const pAsleep = round((1 - awakeKnown) * pKnown);\n  const pUnknown = round(clamp(1 - pKnown, 0, 1));\n  const total = pAwake + pAsleep + pUnknown;\n\n  if (total <= 0) {\n    return {\n      pAwake: 0,\n      pAsleep: 0,\n      pUnknown: 1,\n      contributingSources: [],\n      computedAt: new Date(args.nowMs).toISOString(),\n    };\n  }\n\n  return {\n    pAwake: round(pAwake / total),\n    pAsleep: round(pAsleep / total),\n    pUnknown: round(pUnknown / total),\n    contributingSources: contributors,\n    computedAt: new Date(args.nowMs).toISOString(),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/sleep/circadian-rules.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Named-rules evidence scorer for the circadian state machine.
+ *
+ * Rules are declared as a flat table so each rule is trivial to audit and
+ * easy to extend. Every rule is a pure predicate over the scorer inputs
+ * that may return one `CircadianRuleFiring` (or `null` when the rule
+ * doesn't apply this tick). The runner accumulates firings into a per-state
+ * totals map that the state machine layer then ranks.
+ *
+ * Weights, thresholds, and stability windows are the canonical ones from
+ * `docs/sleep-wake-spec.md` §3. Anything tunable lives at the top of this
+ * file so spec and code never drift.
+ */
+import type { LifeOpsActivitySignal, LifeOpsCircadianRuleFiring, LifeOpsCircadianState, LifeOpsPersonalBaseline, LifeOpsRegularityClass } from "../contracts/health.js";
+import type { LifeOpsActivityWindow } from "./sleep-cycle.js";
+export declare const MIN_STABILITY_WINDOW_MS: number;
+export declare const WAKE_CONFIRM_WINDOW_MS: number;
+export declare const SLEEP_ONSET_WINDOW_MS: number;
+export type CircadianRuleFiring = LifeOpsCircadianRuleFiring;
+export interface CircadianScorerResult {
+    firings: CircadianRuleFiring[];
+    totals: Record<LifeOpsCircadianState, number>;
+}
+interface ScorerInputs {
+    nowMs: number;
+    timezone: string;
+    signals: readonly LifeOpsActivitySignal[];
+    windows: readonly LifeOpsActivityWindow[];
+    baseline: LifeOpsPersonalBaseline | null;
+    regularityClass: LifeOpsRegularityClass;
+    hasCurrentSleepEpisode: boolean;
+    currentSleepStartedAtMs: number | null;
+    lastSleepEndedAtMs: number | null;
+    currentEpisodeLikelyNap: boolean;
+}
+/**
+ * Evaluate every rule in the table and aggregate firings by state.
+ *
+ * Pure; no I/O. The state machine layer is responsible for picking the
+ * top bucket, applying stability-window hysteresis, and translating the
+ * result into a calibrated confidence.
+ */
+export declare function scoreCircadianRules(inputs: ScorerInputs): CircadianScorerResult;
+export {};
+//# sourceMappingURL=circadian-rules.d.ts.map

package/dist/sleep/circadian-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circadian-rules.d.ts","sourceRoot":"","sources":["../../src/sleep/circadian-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,uBAAuB,QAAa,CAAC;AAClD,eAAO,MAAM,sBAAsB,QAAc,CAAC;AAClD,eAAO,MAAM,qBAAqB,QAAc,CAAC;AAIjD,MAAM,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;CAC/C;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1C,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1C,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACzC,eAAe,EAAE,sBAAsB,CAAC;IACxC,sBAAsB,EAAE,OAAO,CAAC;IAChC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,uBAAuB,EAAE,OAAO,CAAC;CAClC;AA4SD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,GACnB,qBAAqB,CAUvB"}

package/dist/sleep/circadian-rules.js

@@ -0,0 +1,258 @@
+import { getZonedDateParts } from "../util/time.js";
+import { parseIsoMs } from "../util/time-util.js";
+const MIN_STABILITY_WINDOW_MS = 5 * 6e4;
+const WAKE_CONFIRM_WINDOW_MS = 10 * 6e4;
+const SLEEP_ONSET_WINDOW_MS = 20 * 6e4;
+const AWAKE_EVIDENCE_MAX_AGE_MS = 20 * 6e4;
+const NAP_MAX_DURATION_MS = 4 * 60 * 6e4;
+function localHour(nowMs, timezone) {
+  const parts = getZonedDateParts(new Date(nowMs), timezone);
+  return parts.hour + parts.minute / 60;
+}
+function isOvernight(nowMs, timezone) {
+  const hour = localHour(nowMs, timezone);
+  return hour >= 22 || hour < 6;
+}
+function signalAge(signal, nowMs) {
+  const observedAt = parseIsoMs(signal.observedAt);
+  return observedAt === null ? null : nowMs - observedAt;
+}
+function findSignal(inputs, predicate) {
+  for (const signal of inputs.signals) {
+    if (!predicate(signal)) continue;
+    const ageMs = signalAge(signal, inputs.nowMs);
+    if (ageMs === null) continue;
+    return { signal, ageMs };
+  }
+  return null;
+}
+const RULES = [
+  // manual.override — user attestation, 4h TTL.
+  function manualOverride(inputs) {
+    const hit = findSignal(
+      inputs,
+      (s) => s.platform === "manual_override" && s.metadata.userAttested === true
+    );
+    if (!hit || hit.ageMs > 4 * 60 * 6e4) return null;
+    const kind = String(hit.signal.metadata.manualOverrideKind ?? "");
+    return {
+      name: "manual.override",
+      contributes: kind === "going_to_bed" ? "sleeping" : "awake",
+      weight: 1,
+      observedAt: hit.signal.observedAt,
+      reason: `user attested ${kind}`
+    };
+  },
+  // healthkit.isSleepingNow — any fresh sleep sample.
+  function healthkitSleep(inputs) {
+    const hit = findSignal(
+      inputs,
+      (s) => s.source === "mobile_health" && s.health?.sleep.isSleeping === true
+    );
+    if (!hit || hit.ageMs > 2 * 60 * 6e4) return null;
+    return {
+      name: "healthkit.isSleepingNow",
+      contributes: "sleeping",
+      weight: 0.95,
+      observedAt: hit.signal.observedAt,
+      reason: "HealthKit reports isSleeping=true"
+    };
+  },
+  // hid.idleGt20m — HID idle past the awake-evidence timeout.
+  function hidIdle(inputs) {
+    const hit = findSignal(
+      inputs,
+      (s) => s.source === "desktop_interaction" && typeof s.idleTimeSeconds === "number" && s.idleTimeSeconds >= 20 * 60
+    );
+    if (!hit || hit.ageMs > AWAKE_EVIDENCE_MAX_AGE_MS) return null;
+    return {
+      name: "hid.idleGt20m",
+      contributes: isOvernight(inputs.nowMs, inputs.timezone) ? "sleeping" : "winding_down",
+      weight: 0.8,
+      observedAt: hit.signal.observedAt,
+      reason: `HID idle >=20 min (${hit.signal.idleTimeSeconds}s)`
+    };
+  },
+  // desktop.lockedGt30m — session lock sustained past 30 min.
+  function desktopLocked(inputs) {
+    const hit = findSignal(
+      inputs,
+      (s) => s.source === "desktop_power" && s.state === "locked"
+    );
+    if (!hit || hit.ageMs < 30 * 6e4) return null;
+    return {
+      name: "desktop.lockedGt30m",
+      contributes: isOvernight(inputs.nowMs, inputs.timezone) ? "sleeping" : "winding_down",
+      weight: 0.85,
+      observedAt: hit.signal.observedAt,
+      reason: "session locked >=30 min"
+    };
+  },
+  // desktop.wakeNotification — recent system wake event.
+  function desktopWake(inputs) {
+    const hit = findSignal(
+      inputs,
+      (s) => s.source === "desktop_power" && (s.state === "active" || s.metadata.event === "didWake" || s.metadata.event === "screensDidWake")
+    );
+    if (!hit || hit.ageMs > WAKE_CONFIRM_WINDOW_MS) return null;
+    return {
+      name: "desktop.wakeNotification",
+      contributes: "waking",
+      weight: 0.92,
+      observedAt: hit.signal.observedAt,
+      reason: "recent NSWorkspace wake notification"
+    };
+  },
+  // message.outboundRecent — outbound owner message in the last 10 minutes.
+  function messageOutbound(inputs) {
+    const hit = findSignal(
+      inputs,
+      (s) => s.source === "imessage_outbound" || s.source === "connector_activity" && (s.metadata.eventType === "MESSAGE_RECEIVED" || s.metadata.direction === "outbound_by_owner")
+    );
+    if (!hit || hit.ageMs > 10 * 6e4) return null;
+    return {
+      name: "message.outboundRecent",
+      contributes: "awake",
+      weight: 0.88,
+      observedAt: hit.signal.observedAt,
+      reason: "outbound message within 10 min"
+    };
+  },
+  // continuity.iphoneDisconnected — paired iPhone absent overnight.
+  function continuityIPhone(inputs) {
+    if (!isOvernight(inputs.nowMs, inputs.timezone)) return null;
+    const hit = findSignal(
+      inputs,
+      (s) => s.source === "mobile_device" && typeof s.platform === "string" && s.platform.startsWith("macos_continuity") && s.state !== "active"
+    );
+    if (!hit || hit.ageMs > 60 * 6e4) return null;
+    return {
+      name: "continuity.iphoneDisconnected",
+      contributes: "sleeping",
+      weight: 0.5,
+      observedAt: hit.signal.observedAt,
+      reason: "paired iPhone disconnected overnight"
+    };
+  },
+  // gap.noSignalsGt2hOvernight — no activity windows for 2h+ at night.
+  function activityGap(inputs) {
+    const latestWindow = inputs.windows[inputs.windows.length - 1];
+    if (!latestWindow) return null;
+    const gapMs = inputs.nowMs - latestWindow.endMs;
+    if (gapMs < 2 * 60 * 6e4) return null;
+    const hour = localHour(inputs.nowMs, inputs.timezone);
+    if (!(hour >= 22 || hour < 10)) return null;
+    return {
+      name: "gap.noSignalsGt2hOvernight",
+      contributes: "sleeping",
+      weight: Math.min(0.9, 0.3 + gapMs / (8 * 60 * 6e4)),
+      observedAt: new Date(latestWindow.endMs).toISOString(),
+      reason: `no activity for ${Math.round(gapMs / 6e4)} min overnight`
+    };
+  },
+  // baseline.currentHourLikely[Asleep|Awake] — personal bedtime prior.
+  function baselinePrior(inputs) {
+    if (!inputs.baseline) return null;
+    if (inputs.regularityClass !== "regular" && inputs.regularityClass !== "very_regular") {
+      return null;
+    }
+    const hour = localHour(inputs.nowMs, inputs.timezone);
+    const { medianBedtimeLocalHour: bedtime, medianWakeLocalHour: wake } = inputs.baseline;
+    const normalized = hour < 12 ? hour + 24 : hour;
+    if (normalized >= bedtime || normalized < wake + 12) {
+      return {
+        name: "baseline.currentHourLikelyAsleep",
+        contributes: "sleeping",
+        weight: 0.35,
+        observedAt: new Date(inputs.nowMs).toISOString(),
+        reason: `within baseline bedtime window (${bedtime.toFixed(1)}h-${wake.toFixed(1)}h)`
+      };
+    }
+    if (normalized >= wake && normalized < wake + 4) {
+      return {
+        name: "baseline.currentHourLikelyAwake",
+        contributes: "awake",
+        weight: 0.3,
+        observedAt: new Date(inputs.nowMs).toISOString(),
+        reason: "within baseline morning window"
+      };
+    }
+    return null;
+  },
+  // active.signalRecent — generic active presence within 5 min.
+  function activeSignalRecent(inputs) {
+    const latest = [...inputs.signals].map((signal) => {
+      const ageMs = signalAge(signal, inputs.nowMs);
+      return ageMs === null ? null : { signal, ageMs };
+    }).filter(
+      (candidate) => candidate !== null
+    ).sort((left, right) => left.ageMs - right.ageMs)[0];
+    if (!latest) return null;
+    if (latest.signal.state !== "active" || latest.ageMs > 5 * 6e4) {
+      return null;
+    }
+    return {
+      name: "active.signalRecent",
+      contributes: "awake",
+      weight: 0.7,
+      observedAt: latest.signal.observedAt,
+      reason: "active signal within 5 min"
+    };
+  },
+  // episode.(sleep|nap)InProgress — current sleep episode.
+  function currentEpisode(inputs) {
+    if (!inputs.hasCurrentSleepEpisode || inputs.currentSleepStartedAtMs === null) {
+      return null;
+    }
+    const duration = inputs.nowMs - inputs.currentSleepStartedAtMs;
+    const isNap = inputs.currentEpisodeLikelyNap && duration < NAP_MAX_DURATION_MS;
+    return {
+      name: isNap ? "episode.napInProgress" : "episode.sleepInProgress",
+      contributes: isNap ? "napping" : "sleeping",
+      weight: 0.85,
+      observedAt: new Date(inputs.currentSleepStartedAtMs).toISOString(),
+      reason: isNap ? "nap episode in progress" : "sleep episode in progress"
+    };
+  },
+  // episode.justWoke — wake anchor inside the confirm window.
+  function justWoke(inputs) {
+    if (inputs.lastSleepEndedAtMs === null) return null;
+    const age = inputs.nowMs - inputs.lastSleepEndedAtMs;
+    if (age < 0 || age > WAKE_CONFIRM_WINDOW_MS) return null;
+    return {
+      name: "episode.justWoke",
+      contributes: "waking",
+      weight: 0.7,
+      observedAt: new Date(inputs.lastSleepEndedAtMs).toISOString(),
+      reason: "wake anchor within stability window"
+    };
+  }
+];
+function emptyTotals() {
+  return {
+    awake: 0,
+    winding_down: 0,
+    sleeping: 0,
+    waking: 0,
+    napping: 0,
+    unclear: 0
+  };
+}
+function scoreCircadianRules(inputs) {
+  const firings = [];
+  const totals = emptyTotals();
+  for (const rule of RULES) {
+    const firing = rule(inputs);
+    if (!firing) continue;
+    firings.push(firing);
+    totals[firing.contributes] += firing.weight;
+  }
+  return { firings, totals };
+}
+export {
+  MIN_STABILITY_WINDOW_MS,
+  SLEEP_ONSET_WINDOW_MS,
+  WAKE_CONFIRM_WINDOW_MS,
+  scoreCircadianRules
+};
+//# sourceMappingURL=circadian-rules.js.map