agent-bober 0.17.0 → 0.18.0

package/dist/medical/whoop/whoop-sync.js

@@ -0,0 +1,97 @@
+// ── Mapping table ────────────────────────────────────────────────────
+// Per-collection: WHOOP score-field name -> fixed (metric, unit). Unmapped fields are SKIPPED.
+const WHOOP_FIELD_MAP = {
+    recovery: {
+        recovery_score: { metric: "whoop_recovery_score", unit: "%" },
+        resting_heart_rate: { metric: "whoop_resting_heart_rate", unit: "bpm" },
+        hrv_rmssd_milli: { metric: "whoop_hrv", unit: "ms" },
+        spo2_percentage: { metric: "whoop_spo2", unit: "%" },
+        skin_temp_celsius: { metric: "whoop_skin_temp", unit: "degC" },
+    },
+    sleep: {
+        sleep_performance_percentage: { metric: "whoop_sleep_performance", unit: "%" },
+        total_in_bed_time_milli: { metric: "whoop_sleep_in_bed", unit: "ms" },
+        respiratory_rate: { metric: "whoop_respiratory_rate", unit: "rpm" },
+    },
+    cycle: {
+        strain: { metric: "whoop_strain", unit: "score" },
+        average_heart_rate: { metric: "whoop_avg_heart_rate", unit: "bpm" },
+        kilojoule: { metric: "whoop_kilojoule", unit: "kJ" },
+    },
+    workout: {
+        strain: { metric: "whoop_workout_strain", unit: "score" },
+        average_heart_rate: { metric: "whoop_workout_avg_hr", unit: "bpm" },
+        kilojoule: { metric: "whoop_workout_kilojoule", unit: "kJ" },
+    },
+};
+const COLLECTIONS = ["recovery", "sleep", "cycle", "workout"];
+// ── Record mapping ───────────────────────────────────────────────────
+/**
+ * Map a list of WhoopRecords from one collection into HealthObservations.
+ * Only fields present in WHOOP_FIELD_MAP are emitted — unmapped fields are skipped.
+ * id is left UNSET so the store derives the content-derived SHA-256 dedup key.
+ */
+function mapWhoopRecords(collection, records) {
+    const table = WHOOP_FIELD_MAP[collection];
+    const out = [];
+    for (const rec of records) {
+        for (const [field, value] of Object.entries(rec.metrics)) {
+            const mapped = table[field];
+            if (!mapped)
+                continue; // unmapped fields skipped, never guessed
+            out.push({
+                // id left UNSET — store derives content-derived SHA-256 (do NOT use rec.id)
+                metric: mapped.metric,
+                value,
+                unit: mapped.unit,
+                tStart: rec.tStartIso,
+                tEnd: rec.tEndIso,
+                source: "whoop",
+            });
+        }
+    }
+    return out;
+}
+// ── WhoopSyncAdapter ─────────────────────────────────────────────────
+/**
+ * Adapts WhoopClient pagination into the ObservationSink interface (ADR-1).
+ *
+ * NOT an IngestionAdapter — its entry point is sync(window, sink), not ingest(filePath, sink).
+ * All HTTP is confined to WhoopClient (injected dependency).
+ *
+ * On any fetchPage throw, the error PROPAGATES (fail-closed).
+ * Prior batches are already committed via per-batch better-sqlite3 transactions (ADR-4).
+ * A failed sync is recovered by re-running — idempotent dedup via INSERT OR IGNORE.
+ */
+export class WhoopSyncAdapter {
+    client;
+    source = "whoop";
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Sync all four WHOOP collections over the given window into the sink.
+     * Pages each collection following nextCursor until the last page (undefined cursor).
+     * Returns IngestionResult { recordsParsed, newRows }.
+     */
+    async sync(window, sink) {
+        let recordsParsed = 0;
+        for (const collection of COLLECTIONS) {
+            let cursor;
+            do {
+                // Any throw PROPAGATES — fail-closed; committed batches already persisted (ADR-4)
+                const page = await this.client.fetchPage(collection, window, cursor);
+                const obs = mapWhoopRecords(collection, page.records);
+                recordsParsed += obs.length; // counts mapped observations only (not raw records)
+                if (obs.length > 0) {
+                    await sink.writeBatch(obs, []); // per-batch txn commits here; await = backpressure
+                }
+                cursor = page.nextCursor;
+            } while (cursor !== undefined);
+        }
+        // Read newRows off the sink (mirrors apple-health.ts:115-117); writeBatch returns void.
+        const newRows = "newRows" in sink ? sink.newRows : 0;
+        return { recordsParsed, newRows };
+    }
+}
+//# sourceMappingURL=whoop-sync.js.map

package/dist/medical/whoop/whoop-sync.js.map

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

package/dist/medical/whoop/whoop-token.d.ts

@@ -0,0 +1,44 @@
+/** Persisted token bundle at .bober/medical/whoop-token.json. */
+export interface WhoopTokens {
+    accessToken: string;
+    refreshToken: string;
+    expiresAtIso: string;
+}
+/**
+ * Manages WHOOP OAuth credentials and the 0600 refresh-token sidecar.
+ *
+ * clientCredentials() reads WHOOP_CLIENT_ID/WHOOP_CLIENT_SECRET from process.env —
+ * mirroring src/providers/factory.ts:96-136 for the clear-throw pattern.
+ *
+ * readRefreshToken() / writeTokens() persist {accessToken, refreshToken, expiresAtIso}
+ * at .bober/medical/whoop-token.json with mode 0600 — mirroring src/medical/consent.ts.
+ *
+ * NO network imports in this file (ADR-2); all HTTP lives in whoop-client.ts.
+ *
+ * bober: env-var creds + file sidecar; swap for OS keychain if per-user isolation
+ *        is needed across multiple OS accounts (ADR-2 deferred).
+ */
+export declare class WhoopTokenStore {
+    private readonly projectRoot;
+    constructor(projectRoot: string);
+    private path;
+    /**
+     * Reads WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET from process.env.
+     * Throws clearly naming both env vars when either is unset.
+     */
+    clientCredentials(): {
+        clientId: string;
+        clientSecret: string;
+    };
+    /**
+     * Returns the stored refresh token, or undefined when the sidecar is absent or corrupt.
+     * Fail-closed: any read/parse error => undefined (not yet authorised).
+     */
+    readRefreshToken(): Promise<string | undefined>;
+    /**
+     * Persist token bundle at .bober/medical/whoop-token.json with mode 0600.
+     * Directory is created if absent (mirrors consent.ts:75-81).
+     */
+    writeTokens(tokens: WhoopTokens): Promise<void>;
+}
+//# sourceMappingURL=whoop-token.d.ts.map

package/dist/medical/whoop/whoop-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoop-token.d.ts","sourceRoot":"","sources":["../../../src/medical/whoop/whoop-token.ts"],"names":[],"mappings":"AAOA,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAID;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,MAAM;IAIhD,OAAO,CAAC,IAAI;IAMZ;;;OAGG;IACH,iBAAiB,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;IAc/D;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAWrD;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAQtD"}

package/dist/medical/whoop/whoop-token.js

@@ -0,0 +1,66 @@
+/** WhoopTokenStore — WHOOP OAuth creds (env) + 0600 refresh-token sidecar. NO network (ADR-2). */
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { ensureDir } from "../../utils/fs.js";
+// ── WhoopTokenStore ──────────────────────────────────────────────────
+/**
+ * Manages WHOOP OAuth credentials and the 0600 refresh-token sidecar.
+ *
+ * clientCredentials() reads WHOOP_CLIENT_ID/WHOOP_CLIENT_SECRET from process.env —
+ * mirroring src/providers/factory.ts:96-136 for the clear-throw pattern.
+ *
+ * readRefreshToken() / writeTokens() persist {accessToken, refreshToken, expiresAtIso}
+ * at .bober/medical/whoop-token.json with mode 0600 — mirroring src/medical/consent.ts.
+ *
+ * NO network imports in this file (ADR-2); all HTTP lives in whoop-client.ts.
+ *
+ * bober: env-var creds + file sidecar; swap for OS keychain if per-user isolation
+ *        is needed across multiple OS accounts (ADR-2 deferred).
+ */
+export class WhoopTokenStore {
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    // ── Path ──────────────────────────────────────────────────────────
+    path() {
+        return join(this.projectRoot, ".bober", "medical", "whoop-token.json");
+    }
+    // ── Credentials ───────────────────────────────────────────────────
+    /**
+     * Reads WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET from process.env.
+     * Throws clearly naming both env vars when either is unset.
+     */
+    clientCredentials() {
+        const clientId = process.env["WHOOP_CLIENT_ID"];
+        const clientSecret = process.env["WHOOP_CLIENT_SECRET"];
+        if (!clientId || !clientSecret) {
+            throw new Error("WHOOP credentials missing — set WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET " +
+                "environment variables and try again.");
+        }
+        return { clientId, clientSecret };
+    }
+    // ── Token sidecar ─────────────────────────────────────────────────
+    /**
+     * Returns the stored refresh token, or undefined when the sidecar is absent or corrupt.
+     * Fail-closed: any read/parse error => undefined (not yet authorised).
+     */
+    async readRefreshToken() {
+        try {
+            const data = JSON.parse(await readFile(this.path(), "utf-8"));
+            return typeof data.refreshToken === "string" ? data.refreshToken : undefined;
+        }
+        catch {
+            return undefined; // absent or corrupt => not yet authorised
+        }
+    }
+    /**
+     * Persist token bundle at .bober/medical/whoop-token.json with mode 0600.
+     * Directory is created if absent (mirrors consent.ts:75-81).
+     */
+    async writeTokens(tokens) {
+        await ensureDir(join(this.projectRoot, ".bober", "medical"));
+        await writeFile(this.path(), JSON.stringify(tokens, null, 2) + "\n", { encoding: "utf-8", mode: 0o600 });
+    }
+}
+//# sourceMappingURL=whoop-token.js.map

package/dist/medical/whoop/whoop-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoop-token.js","sourceRoot":"","sources":["../../../src/medical/whoop/whoop-token.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAW9C,wEAAwE;AAExE;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,WAAmB;QAAnB,gBAAW,GAAX,WAAW,CAAQ;IAAG,CAAC;IAEpD,qEAAqE;IAE7D,IAAI;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;IACzE,CAAC;IAED,qEAAqE;IAErE;;;OAGG;IACH,iBAAiB;QACf,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,0EAA0E;gBACxE,sCAAsC,CACzC,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IACpC,CAAC;IAED,qEAAqE;IAErE;;;OAGG;IACH,KAAK,CAAC,gBAAgB;QACpB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CACrB,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CACb,CAAC;YAC1B,OAAO,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC,CAAC,0CAA0C;QAC9D,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,MAAmB;QACnC,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;QAC7D,MAAM,SAAS,CACb,IAAI,CAAC,IAAI,EAAE,EACX,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EACtC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CACnC,CAAC;IACJ,CAAC;CACF"}