agent-bober 0.17.1 → 0.19.0

package/dist/medical/lab-pdf-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lab-pdf-parser.d.ts","sourceRoot":"","sources":["../../src/medical/lab-pdf-parser.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAI7E,MAAM,WAAW,eAAe;IAC9B,yGAAyG;IACzG,MAAM,EAAE,SAAS,CAAC;IAClB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AA8BD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,eAAe,CAAC,CAsB1B"}

package/dist/medical/lab-pdf-parser.js

@@ -0,0 +1,57 @@
+/** parseLabPdf — native-text lab PDF -> Zod-validated ParsedLabReport via injectable LLMClient. */
+import { Buffer } from "node:buffer";
+import { ParsedLabReportSchema } from "./lab-types.js";
+// -- Response schema (hand-written JsonSchemaObject literal) ----------
+const LAB_REPORT_JSON_SCHEMA = {
+    type: "object",
+    properties: {
+        panel: { type: "string" },
+        collectedAtIso: { type: "string" },
+        markers: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    name: { type: "string" },
+                    value: { type: "number" },
+                    unit: { type: "string" },
+                    referenceLow: { type: "number" },
+                    referenceHigh: { type: "number" },
+                    critical: { type: "boolean" },
+                },
+                required: ["name", "value", "unit"],
+            },
+        },
+    },
+    required: ["panel", "collectedAtIso", "markers"],
+};
+// -- parseLabPdf ------------------------------------------------------
+/**
+ * Base64-encodes `pdfBytes`, sends it as an Anthropic document content block
+ * via an injectable `LLMClient` with schema-constrained output, and returns a
+ * Zod-validated `ParsedLabReport`. Throws a `ZodError` on malformed model output
+ * — never returns an unvalidated object.
+ *
+ * @param pdfBytes  Raw bytes of a native-text PDF lab report.
+ * @param deps      Injectable `{ client, model }` seam for testing and egress gating.
+ */
+export async function parseLabPdf(pdfBytes, deps) {
+    const base64 = Buffer.from(pdfBytes).toString("base64");
+    const response = await deps.client.chat({
+        model: deps.model,
+        system: "You are a medical data extraction assistant. Extract structured lab results from the provided PDF document. Return ONLY a JSON object matching the requested schema — no prose, no markdown.",
+        messages: [
+            {
+                role: "user",
+                content: "Extract all lab markers from the attached PDF. Return a JSON object with panel name, ISO collection date, and a markers array (name, numeric value, unit, optional referenceLow/referenceHigh/critical).",
+            },
+        ],
+        documents: [{ base64, mediaType: "application/pdf" }],
+        responseSchema: LAB_REPORT_JSON_SCHEMA,
+    });
+    // With responseSchema set, the adapter guarantees response.text holds the JSON document.
+    const parsed = JSON.parse(response.text);
+    // Throws ZodError on malformed output — never coerce (sc-1-4).
+    return ParsedLabReportSchema.parse(parsed);
+}
+//# sourceMappingURL=lab-pdf-parser.js.map

package/dist/medical/lab-pdf-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lab-pdf-parser.js","sourceRoot":"","sources":["../../src/medical/lab-pdf-parser.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,qBAAqB,EAAwB,MAAM,gBAAgB,CAAC;AAW7E,wEAAwE;AAExE,MAAM,sBAAsB,GAAqB;IAC/C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAClC,OAAO,EAAE;YACP,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAChC,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACjC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;iBAC9B;gBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;aACpC;SACF;KACF;IACD,QAAQ,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,CAAC;CACjD,CAAC;AAEF,wEAAwE;AAExE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAoB,EACpB,IAAqB;IAErB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAExD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QACtC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EACJ,8LAA8L;QAChM,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EACL,0MAA0M;aAC7M;SACF;QACD,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;QACrD,cAAc,EAAE,sBAAsB;KACvC,CAAC,CAAC;IAEH,yFAAyF;IACzF,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClD,+DAA+D;IAC/D,OAAO,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC"}

package/dist/medical/lab-reindex.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Lab-note reindexer — globs lab vault notes and upserts each result into HealthDataStore.
+ *
+ * Pure file + SQLite. NO network. NO LLM. NO Date.now().
+ *
+ * Architecture: vault is canonical; SQLite store is a derived, rebuildable index.
+ * Dedup runs at ingest time via the deterministic labResultId (INSERT OR IGNORE).
+ * Re-running over unchanged notes returns 0 new rows (idempotent).
+ */
+import type { HealthDataStore } from "./health-store.js";
+/**
+ * Glob all markdown notes under `<vaultDir>/labs/`, parse each note's YAML frontmatter,
+ * map the fields to a LabResult, and upsert into the store.
+ *
+ * Returns the total count of NEW rows inserted (sum of upsertLabResult return values).
+ * Duplicate notes produce 0 new rows — dedup is automatic via the deterministic
+ * labResultId (biomarker|collectedAtIso|value) under INSERT OR IGNORE.
+ *
+ * @param vaultDir  Root of the vault directory tree (contains the `labs/` subdirectory).
+ * @param store     An open HealthDataStore instance to upsert into.
+ * @returns         Number of genuinely new rows inserted in this run.
+ */
+export declare function reindexLabNotes(vaultDir: string, store: HealthDataStore): Promise<number>;
+//# sourceMappingURL=lab-reindex.d.ts.map

package/dist/medical/lab-reindex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lab-reindex.d.ts","sourceRoot":"","sources":["../../src/medical/lab-reindex.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/dist/medical/lab-reindex.js

@@ -0,0 +1,45 @@
+/**
+ * Lab-note reindexer — globs lab vault notes and upserts each result into HealthDataStore.
+ *
+ * Pure file + SQLite. NO network. NO LLM. NO Date.now().
+ *
+ * Architecture: vault is canonical; SQLite store is a derived, rebuildable index.
+ * Dedup runs at ingest time via the deterministic labResultId (INSERT OR IGNORE).
+ * Re-running over unchanged notes returns 0 new rows (idempotent).
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { glob } from "glob";
+import { parseLabNote } from "./lab-note.js";
+/**
+ * Glob all markdown notes under `<vaultDir>/labs/`, parse each note's YAML frontmatter,
+ * map the fields to a LabResult, and upsert into the store.
+ *
+ * Returns the total count of NEW rows inserted (sum of upsertLabResult return values).
+ * Duplicate notes produce 0 new rows — dedup is automatic via the deterministic
+ * labResultId (biomarker|collectedAtIso|value) under INSERT OR IGNORE.
+ *
+ * @param vaultDir  Root of the vault directory tree (contains the `labs/` subdirectory).
+ * @param store     An open HealthDataStore instance to upsert into.
+ * @returns         Number of genuinely new rows inserted in this run.
+ */
+export async function reindexLabNotes(vaultDir, store) {
+    const labsDir = join(vaultDir, "labs");
+    const paths = await glob("**/*.md", { cwd: labsDir, absolute: true, nodir: true });
+    let newRows = 0;
+    for (const notePath of paths) {
+        const raw = await readFile(notePath, "utf-8");
+        const fm = parseLabNote(raw);
+        const result = {
+            biomarker: fm.marker,
+            value: fm.value,
+            unit: fm.unit,
+            collectedAtIso: fm.date,
+            referenceLow: fm.ref_low,
+            referenceHigh: fm.ref_high,
+        };
+        newRows += store.upsertLabResult(result);
+    }
+    return newRows;
+}
+//# sourceMappingURL=lab-reindex.js.map

package/dist/medical/lab-reindex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lab-reindex.js","sourceRoot":"","sources":["../../src/medical/lab-reindex.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,KAAsB;IAEtB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnF,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAE7B,MAAM,MAAM,GAAc;YACxB,SAAS,EAAE,EAAE,CAAC,MAAM;YACpB,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,cAAc,EAAE,EAAE,CAAC,IAAI;YACvB,YAAY,EAAE,EAAE,CAAC,OAAO;YACxB,aAAa,EAAE,EAAE,CAAC,QAAQ;SAC3B,CAAC;QAEF,OAAO,IAAI,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/medical/lab-types.d.ts

@@ -0,0 +1,75 @@
+/** Zod schemas for parsed lab reports (medical-ingest Sprint 1). */
+import { z } from "zod";
+export declare const ParsedLabMarkerSchema: z.ZodObject<{
+    name: z.ZodString;
+    value: z.ZodNumber;
+    unit: z.ZodString;
+    referenceLow: z.ZodOptional<z.ZodNumber>;
+    referenceHigh: z.ZodOptional<z.ZodNumber>;
+    critical: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    value: number;
+    unit: string;
+    referenceLow?: number | undefined;
+    referenceHigh?: number | undefined;
+    critical?: boolean | undefined;
+}, {
+    name: string;
+    value: number;
+    unit: string;
+    referenceLow?: number | undefined;
+    referenceHigh?: number | undefined;
+    critical?: boolean | undefined;
+}>;
+export declare const ParsedLabReportSchema: z.ZodObject<{
+    panel: z.ZodString;
+    collectedAtIso: z.ZodString;
+    markers: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodNumber;
+        unit: z.ZodString;
+        referenceLow: z.ZodOptional<z.ZodNumber>;
+        referenceHigh: z.ZodOptional<z.ZodNumber>;
+        critical: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        value: number;
+        unit: string;
+        referenceLow?: number | undefined;
+        referenceHigh?: number | undefined;
+        critical?: boolean | undefined;
+    }, {
+        name: string;
+        value: number;
+        unit: string;
+        referenceLow?: number | undefined;
+        referenceHigh?: number | undefined;
+        critical?: boolean | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    panel: string;
+    collectedAtIso: string;
+    markers: {
+        name: string;
+        value: number;
+        unit: string;
+        referenceLow?: number | undefined;
+        referenceHigh?: number | undefined;
+        critical?: boolean | undefined;
+    }[];
+}, {
+    panel: string;
+    collectedAtIso: string;
+    markers: {
+        name: string;
+        value: number;
+        unit: string;
+        referenceLow?: number | undefined;
+        referenceHigh?: number | undefined;
+        critical?: boolean | undefined;
+    }[];
+}>;
+export type ParsedLabMarker = z.infer<typeof ParsedLabMarkerSchema>;
+export type ParsedLabReport = z.infer<typeof ParsedLabReportSchema>;
+//# sourceMappingURL=lab-types.d.ts.map

package/dist/medical/lab-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lab-types.d.ts","sourceRoot":"","sources":["../../src/medical/lab-types.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;EAOhC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIhC,CAAC;AAIH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/medical/lab-types.js

@@ -0,0 +1,17 @@
+/** Zod schemas for parsed lab reports (medical-ingest Sprint 1). */
+import { z } from "zod";
+// -- Schemas ----------------------------------------------------------
+export const ParsedLabMarkerSchema = z.object({
+    name: z.string(),
+    value: z.number(),
+    unit: z.string(),
+    referenceLow: z.number().optional(),
+    referenceHigh: z.number().optional(),
+    critical: z.boolean().optional(),
+});
+export const ParsedLabReportSchema = z.object({
+    panel: z.string(),
+    collectedAtIso: z.string(),
+    markers: z.array(ParsedLabMarkerSchema),
+});
+//# sourceMappingURL=lab-types.js.map

package/dist/medical/lab-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lab-types.js","sourceRoot":"","sources":["../../src/medical/lab-types.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wEAAwE;AAExE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;CACxC,CAAC,CAAC"}

package/dist/medical/numerics.d.ts

@@ -0,0 +1,66 @@
+/**
+ * NumericsQueryLayer — deterministic closed-whitelist numeric primitives (Phase 6, Sprint 4).
+ *
+ * ADR-3: The LLM NEVER performs arithmetic. All numeric computations are pure TypeScript
+ * over a CLOSED whitelist: mean | min | max | latest | delta | slope | percentile | zscore.
+ * Adding a computation requires extending NumericPrimitive (a code review event), not a
+ * model decision. `sampleCount: 0` signals upstream abstention.
+ *
+ * NO async. NO fs. NO network. NO LLM import. NO dynamic execution. NO subprocess.
+ * Identical input => identical output.
+ *
+ * Primitive formulas documented below (also satisfies contract assumptions line 75):
+ *
+ * mean        — sum(values) / n
+ * min         — Math.min(...values)
+ * max         — Math.max(...values)
+ * latest      — value at the maximum t_start (last element of ASC-ordered array)
+ * delta       — latest − earliest = values[n-1] − values[0]
+ * slope       — least-squares slope over (t, value) where t = Date.parse(r.tStart) epoch-ms.
+ *               formula: (n·Σ(t·v) − Σt·Σv) / (n·Σ(t²) − (Σt)²)
+ *               degenerate: denominator === 0 (all same timestamp) → value: null, sampleCount: n
+ * percentile  — linear interpolation between closest ranks (sorted ascending):
+ *               rank = (p/100) · (n−1); lo = floor(rank); hi = ceil(rank);
+ *               result = v[lo] + (rank − lo) · (v[hi] − v[lo])
+ *               (for p50, [10,20,30,40] → rank=1.5 → 20 + 0.5·10 = 25)
+ * zscore      — (latest − mean) / populationStddev
+ *               populationStddev = sqrt(Σ(v − mean)² / n)
+ *               sampleCount < 2 → abstain (stddev undefined for n=1, zero for n=0)
+ *               ([10,20,30,40]: mean=25, popStd=√125≈11.1803, z=(40-25)/11.1803≈1.3416)
+ */
+import type { HealthDataStore } from "./health-store.js";
+import type { NumericPrimitive, NumericResult, MetricWindow, LabTrend } from "./types.js";
+/**
+ * Provides deterministic, LLM-free numeric aggregations over HealthDataStore.
+ *
+ * All methods are SYNCHRONOUS. No async, no fs, no network, no LLM import.
+ * The LLM never performs arithmetic — this layer does.
+ */
+export declare class NumericsQueryLayer {
+    private readonly store;
+    constructor(store: HealthDataStore);
+    /**
+     * Compute a numeric primitive over the observations in the given time window.
+     *
+     * Abstain conditions (return { value: null, sampleCount: 0 } without throwing):
+     *   - Empty window (no rows in the time range) — sc-4-6
+     *   - Heterogeneous units across rows — sc-4-7 (cross-unit refusal)
+     *
+     * Partial abstain (value: null, sampleCount: n):
+     *   - zscore with sampleCount < 2 (stddev undefined)
+     *   - slope with degenerate denominator (all same timestamp)
+     *
+     * @param window   — metric + ISO-8601 time range
+     * @param primitive — one of the 8 whitelisted NumericPrimitive values
+     * @param percentile — percentile p ∈ [0,100], used only for "percentile" primitive (default 50)
+     */
+    getMetric(window: MetricWindow, primitive: NumericPrimitive, percentile?: number): NumericResult;
+    /**
+     * Build a LabTrend summary for a biomarker series.
+     *
+     * Abstains (latestValue: null, slope: null) when sampleCount === 0 (sc-4-6).
+     * slope is null when sampleCount < 2 (not enough data for least-squares).
+     */
+    getLabTrend(biomarker: string): LabTrend;
+}
+//# sourceMappingURL=numerics.d.ts.map

package/dist/medical/numerics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numerics.d.ts","sourceRoot":"","sources":["../../src/medical/numerics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,QAAQ,EAGT,MAAM,YAAY,CAAC;AAsHpB;;;;;GAKG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAEnD;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,UAAU,SAAK,GAAG,aAAa;IAwB5F;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ;CAuCzC"}

package/dist/medical/numerics.js

@@ -0,0 +1,216 @@
+/**
+ * NumericsQueryLayer — deterministic closed-whitelist numeric primitives (Phase 6, Sprint 4).
+ *
+ * ADR-3: The LLM NEVER performs arithmetic. All numeric computations are pure TypeScript
+ * over a CLOSED whitelist: mean | min | max | latest | delta | slope | percentile | zscore.
+ * Adding a computation requires extending NumericPrimitive (a code review event), not a
+ * model decision. `sampleCount: 0` signals upstream abstention.
+ *
+ * NO async. NO fs. NO network. NO LLM import. NO dynamic execution. NO subprocess.
+ * Identical input => identical output.
+ *
+ * Primitive formulas documented below (also satisfies contract assumptions line 75):
+ *
+ * mean        — sum(values) / n
+ * min         — Math.min(...values)
+ * max         — Math.max(...values)
+ * latest      — value at the maximum t_start (last element of ASC-ordered array)
+ * delta       — latest − earliest = values[n-1] − values[0]
+ * slope       — least-squares slope over (t, value) where t = Date.parse(r.tStart) epoch-ms.
+ *               formula: (n·Σ(t·v) − Σt·Σv) / (n·Σ(t²) − (Σt)²)
+ *               degenerate: denominator === 0 (all same timestamp) → value: null, sampleCount: n
+ * percentile  — linear interpolation between closest ranks (sorted ascending):
+ *               rank = (p/100) · (n−1); lo = floor(rank); hi = ceil(rank);
+ *               result = v[lo] + (rank − lo) · (v[hi] − v[lo])
+ *               (for p50, [10,20,30,40] → rank=1.5 → 20 + 0.5·10 = 25)
+ * zscore      — (latest − mean) / populationStddev
+ *               populationStddev = sqrt(Σ(v − mean)² / n)
+ *               sampleCount < 2 → abstain (stddev undefined for n=1, zero for n=0)
+ *               ([10,20,30,40]: mean=25, popStd=√125≈11.1803, z=(40-25)/11.1803≈1.3416)
+ */
+// ── Internal computation helpers ──────────────────────────────────────
+/**
+ * Compute the least-squares slope over (epoch-ms timestamp, value) pairs.
+ * Returns null when the denominator is zero (all observations at the same timestamp).
+ */
+function leastSquaresSlope(rows) {
+    const n = rows.length;
+    const ts = rows.map((r) => Date.parse(r.tStart));
+    const vs = rows.map((r) => r.value);
+    let sumT = 0;
+    let sumV = 0;
+    let sumTV = 0;
+    let sumT2 = 0;
+    for (let i = 0; i < n; i++) {
+        sumT += ts[i];
+        sumV += vs[i];
+        sumTV += ts[i] * vs[i];
+        sumT2 += ts[i] * ts[i];
+    }
+    const denom = n * sumT2 - sumT * sumT;
+    if (denom === 0)
+        return null; // all same timestamp — slope undefined
+    return (n * sumTV - sumT * sumV) / denom;
+}
+/**
+ * Linear interpolation percentile on the sorted-ascending values.
+ * rank = (p/100) · (n−1); result = v[lo] + (rank − lo) · (v[hi] − v[lo]).
+ * p must be in [0, 100].
+ */
+function linearPercentile(sortedValues, p) {
+    const n = sortedValues.length;
+    if (n === 1)
+        return sortedValues[0];
+    const rank = (p / 100) * (n - 1);
+    const lo = Math.floor(rank);
+    const hi = Math.ceil(rank);
+    if (lo === hi)
+        return sortedValues[lo];
+    return sortedValues[lo] + (rank - lo) * (sortedValues[hi] - sortedValues[lo]);
+}
+/**
+ * Population standard deviation: sqrt(Σ(v − mean)² / n).
+ */
+function populationStddev(values, mean) {
+    const variance = values.reduce((acc, v) => acc + (v - mean) ** 2, 0) / values.length;
+    return Math.sqrt(variance);
+}
+/**
+ * Dispatch the computation for a single NumericPrimitive over the given rows/values.
+ * rows are ordered by t_start ASC from getObservations.
+ * values[i] === rows[i].value.
+ * Returns null only for zscore (n<2) and slope (degenerate denominator).
+ *
+ * The exhaustive switch + never guard ensures every new member of the union
+ * causes a compile-time error if not handled (ADR-3 code-review gate).
+ */
+function computePrimitive(primitive, rows, values, percentile) {
+    const n = values.length;
+    switch (primitive) {
+        case "mean": {
+            const sum = values.reduce((acc, v) => acc + v, 0);
+            return sum / n;
+        }
+        case "min":
+            return Math.min(...values);
+        case "max":
+            return Math.max(...values);
+        case "latest":
+            // rows are ordered t_start ASC; last element is the most recent.
+            return values[n - 1];
+        case "delta":
+            // latest − earliest (ASC order: first is earliest, last is latest).
+            return values[n - 1] - values[0];
+        case "slope":
+            return leastSquaresSlope(rows);
+        case "percentile": {
+            const sorted = [...values].sort((a, b) => a - b);
+            return linearPercentile(sorted, percentile);
+        }
+        case "zscore": {
+            if (n < 2)
+                return null; // population stddev undefined for n<2
+            const mean = values.reduce((acc, v) => acc + v, 0) / n;
+            const std = populationStddev(values, mean);
+            if (std === 0)
+                return 0; // all values identical → z-score is 0 by definition
+            const latest = values[n - 1];
+            return (latest - mean) / std;
+        }
+        default: {
+            // Exhaustive never guard: if a new primitive is added to the union without
+            // a case here, TypeScript will raise a compile error (ADR-3).
+            const _exhaustive = primitive;
+            throw new Error(`Unhandled NumericPrimitive: ${String(_exhaustive)}`);
+        }
+    }
+}
+// ── NumericsQueryLayer ────────────────────────────────────────────────
+/**
+ * Provides deterministic, LLM-free numeric aggregations over HealthDataStore.
+ *
+ * All methods are SYNCHRONOUS. No async, no fs, no network, no LLM import.
+ * The LLM never performs arithmetic — this layer does.
+ */
+export class NumericsQueryLayer {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    /**
+     * Compute a numeric primitive over the observations in the given time window.
+     *
+     * Abstain conditions (return { value: null, sampleCount: 0 } without throwing):
+     *   - Empty window (no rows in the time range) — sc-4-6
+     *   - Heterogeneous units across rows — sc-4-7 (cross-unit refusal)
+     *
+     * Partial abstain (value: null, sampleCount: n):
+     *   - zscore with sampleCount < 2 (stddev undefined)
+     *   - slope with degenerate denominator (all same timestamp)
+     *
+     * @param window   — metric + ISO-8601 time range
+     * @param primitive — one of the 8 whitelisted NumericPrimitive values
+     * @param percentile — percentile p ∈ [0,100], used only for "percentile" primitive (default 50)
+     */
+    getMetric(window, primitive, percentile = 50) {
+        const rows = this.store.getObservations(window.metric, window.fromIso, window.toIso);
+        // ABSTAIN: empty window (sc-4-6)
+        if (rows.length === 0) {
+            return { primitive, value: null, unit: window.unit ?? "", sampleCount: 0 };
+        }
+        // UNIT GUARD (sc-4-7): refuse to aggregate across heterogeneous units (ADR-4).
+        // Architecture risk table line 328: "NumericsQueryLayer reads unit per row;
+        // refuses cross-unit aggregation."
+        const units = new Set(rows.map((r) => r.unit));
+        if (units.size > 1) {
+            // Abstain — no throw (no-throw contract from architecture API table line 251).
+            return { primitive, value: null, unit: "", sampleCount: rows.length };
+        }
+        const unit = rows[0].unit;
+        const values = rows.map((r) => r.value);
+        const value = computePrimitive(primitive, rows, values, percentile);
+        return { primitive, value, unit, sampleCount: rows.length };
+    }
+    /**
+     * Build a LabTrend summary for a biomarker series.
+     *
+     * Abstains (latestValue: null, slope: null) when sampleCount === 0 (sc-4-6).
+     * slope is null when sampleCount < 2 (not enough data for least-squares).
+     */
+    getLabTrend(biomarker) {
+        const series = this.store.getLabSeries(biomarker);
+        if (series.length === 0) {
+            return {
+                biomarker,
+                sampleCount: 0,
+                latestValue: null,
+                latestUnit: "",
+                latestCollectedAt: null,
+                slope: null,
+            };
+        }
+        // series is ordered collected_at ASC from getLabSeries.
+        const latest = series[series.length - 1];
+        let slope = null;
+        if (series.length >= 2) {
+            // Convert LabResult to pseudo-HealthObservation for slope helper reuse.
+            const pseudoRows = series.map((r) => ({
+                metric: r.biomarker,
+                value: r.value,
+                unit: r.unit,
+                tStart: r.collectedAtIso,
+                source: "lab",
+            }));
+            slope = leastSquaresSlope(pseudoRows);
+        }
+        return {
+            biomarker,
+            sampleCount: series.length,
+            latestValue: latest.value,
+            latestUnit: latest.unit,
+            latestCollectedAt: latest.collectedAtIso,
+            slope,
+        };
+    }
+}
+//# sourceMappingURL=numerics.js.map

package/dist/medical/numerics.js.map

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

package/dist/medical/profile.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Personalization profile -> SOPS-encrypted <vaultDir>/profile.yaml (Sprint 5).
+ * Encryption is behind an injectable cipher seam; tests inject a reversible fake.
+ * When the cipher is unavailable BOTH paths refuse and write NO plaintext PHI.
+ * Hand-rolled flat YAML emit/parse (string[] arrays) — NEVER import src/vault.
+ */
+import { z } from "zod";
+export declare const ProfileSchema: z.ZodObject<{
+    age: z.ZodNumber;
+    sex: z.ZodEnum<["male", "female", "other"]>;
+    conditions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    medications: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    supplements: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    allergies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    goals: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    age: number;
+    sex: "male" | "female" | "other";
+    conditions: string[];
+    medications: string[];
+    supplements: string[];
+    allergies: string[];
+    goals: string[];
+}, {
+    age: number;
+    sex: "male" | "female" | "other";
+    conditions?: string[] | undefined;
+    medications?: string[] | undefined;
+    supplements?: string[] | undefined;
+    allergies?: string[] | undefined;
+    goals?: string[] | undefined;
+}>;
+export type Profile = z.infer<typeof ProfileSchema>;
+/**
+ * Encryption seam for profile.yaml (SOPS age key by default).
+ * Tests inject a reversible fake; production uses the sops-via-execa default.
+ * available() MUST be synchronous — the caller gates IO on its return value.
+ */
+export interface ProfileCipher {
+    /** Returns true synchronously when the underlying binary is available. */
+    available(): boolean;
+    /** Encrypt plaintext to ciphertext (may return a Promise). */
+    encrypt(plaintext: string): string | Promise<string>;
+    /** Decrypt ciphertext to plaintext (may return a Promise). */
+    decrypt(ciphertext: string): string | Promise<string>;
+}
+/**
+ * Emit a Profile as a minimal YAML string.
+ * Scalars (age, sex) first; array fields follow.
+ * Empty arrays are emitted as `key: []`; non-empty as `key:\n  - item\n`.
+ */
+export declare function emitProfileYaml(p: Profile): string;
+/**
+ * Parse a minimal profile YAML string into a plain object (for ProfileSchema.parse).
+ * Handles flat scalars (age: 42, sex: male) and string arrays (key:\n  - item).
+ * Returns unknown — callers must validate through ProfileSchema.parse.
+ */
+export declare function parseProfileYaml(raw: string): unknown;
+/** Injectable dependencies for writeProfile / readProfile — production callers omit. */
+export interface ProfileDeps {
+    /** Override the encryption cipher (e.g. reversible fake in tests). */
+    cipher?: ProfileCipher;
+}
+/**
+ * Validate, serialize, encrypt and write the profile to <vaultDir>/profile.yaml.
+ *
+ * SAFETY: throws with a clear message (and writes NOTHING to disk) when
+ * cipher.available() returns false. The only bytes written to disk are ciphertext.
+ */
+export declare function writeProfile(vaultDir: string, profile: Profile, deps?: ProfileDeps): Promise<void>;
+/**
+ * Read, decrypt, parse and validate the profile from <vaultDir>/profile.yaml.
+ *
+ * SAFETY: throws with a clear message when cipher.available() returns false
+ * (no disk reads are attempted).
+ */
+export declare function readProfile(vaultDir: string, deps?: ProfileDeps): Promise<Profile>;
+/**
+ * Core logic for `bober medical profile show`.
+ * Reads and prints the profile to stdout.
+ * Errors are caught, written to stderr, process.exitCode set to 1 — never throws.
+ */
+export declare function runProfileShow(projectRoot: string, opts: {
+    vault?: string;
+}, deps?: ProfileDeps): Promise<void>;
+/**
+ * Core logic for `bober medical profile set <key> <value>`.
+ * Reads the existing profile (or starts from a safe default on ENOENT),
+ * updates one field, re-validates via ProfileSchema, and writes back.
+ * For array keys, value is parsed as a comma-separated list.
+ * Errors are caught, written to stderr, process.exitCode set to 1 — never throws.
+ */
+export declare function runProfileSet(projectRoot: string, key: string, value: string, opts: {
+    vault?: string;
+}, deps?: ProfileDeps): Promise<void>;
+//# sourceMappingURL=profile.d.ts.map

package/dist/medical/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/medical/profile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;EAQxB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAIpD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,SAAS,IAAI,OAAO,CAAC;IACrB,8DAA8D;IAC9D,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,8DAA8D;IAC9D,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvD;AA+DD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAgBlD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAqDrD;AAID,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAID;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,OAAO,CAAC,CAalB;AAYD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACxB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACxB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAuDf"}