agent-bober 0.17.1 → 0.19.0

package/dist/medical/analysis/cross-marker.js

@@ -0,0 +1,79 @@
+/**
+ * Cross-marker pattern detector — OFFERS a dig-deeper finding when related markers are both OOR.
+ *
+ * PURE except store reads. NO LLM / NO network / NO Date.now().
+ * All timestamps are injected parameters; the wall clock is read ONLY at the CLI boundary.
+ *
+ * ADR-3: CROSS_MARKER_PAIRS is a CLOSED code-reviewed list (mirror of NumericPrimitive
+ * at src/medical/types.ts:142). Extending it is a code-review event, not a runtime decision.
+ *
+ * The offer finding persists its marker pair in tags (["cross-marker", a, b]) so the
+ * dig-deeper path can recover the pair from the note frontmatter (sc-4-6).
+ */
+import { findingId } from "./finding.js";
+// -- CLOSED cross-marker pairs table ---------------------------------------
+/**
+ * Closed list of related-marker pairs (code-review to extend).
+ * When BOTH markers are out of reference range, an offer Finding is emitted.
+ */
+export const CROSS_MARKER_PAIRS = [
+    ["ldl", "triglycerides"],
+    ["hba1c", "triglycerides"],
+];
+// -- Internal helpers -----------------------------------------------------
+/**
+ * True when the marker's LATEST result is outside [referenceLow, referenceHigh].
+ * Returns false when no data is available (missing series → cannot be OOR).
+ */
+function isOutOfRange(store, marker) {
+    const series = store.getLabSeries(marker);
+    const latest = series[series.length - 1];
+    if (latest === undefined)
+        return false;
+    const { value, referenceLow, referenceHigh } = latest;
+    if (referenceHigh !== undefined && value > referenceHigh)
+        return true;
+    if (referenceLow !== undefined && value < referenceLow)
+        return true;
+    return false;
+}
+function makeOfferFinding(a, b, now) {
+    return {
+        id: findingId("medical", a, `cross-marker-${a}-${b}`),
+        domain: "medical",
+        title: `Cross-marker pattern: ${a} and ${b} both out of reference range — want me to dig deeper?`,
+        kind: "question",
+        urgency: 2,
+        severity: 2,
+        evidence: [
+            `${a} is outside its reference range`,
+            `${b} is outside its reference range`,
+            `Both ${a} and ${b} being out of range may indicate a combined pattern worth investigating`,
+        ],
+        surfacedAt: now,
+        // (c) INVARIANT: tags carry the marker pair in positions 1+ for dig-deeper recovery (sc-4-6)
+        tags: ["cross-marker", a, b],
+        status: "open",
+    };
+}
+// -- Public API -----------------------------------------------------------
+/**
+ * Detect cross-marker patterns and OFFER (not auto-run) deeper analysis.
+ *
+ * PURE except store reads. NO LLM / NO network. OFFERS only — never runs analysis.
+ * When BOTH markers of a configured pair are out of reference range, emits a single
+ * kind="question" finding with the marker pair persisted in tags for dig-deeper (sc-4-6).
+ *
+ * @param store  HealthDataStore (caller owns lifecycle)
+ * @param opts   { now: ISO 8601 injected timestamp }
+ */
+export function detectCrossMarkerPatterns(store, opts) {
+    const findings = [];
+    for (const [a, b] of CROSS_MARKER_PAIRS) {
+        if (isOutOfRange(store, a) && isOutOfRange(store, b)) {
+            findings.push(makeOfferFinding(a, b, opts.now));
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=cross-marker.js.map

package/dist/medical/analysis/cross-marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-marker.js","sourceRoot":"","sources":["../../../src/medical/analysis/cross-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,6EAA6E;AAE7E;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6C;IAC1E,CAAC,KAAK,EAAE,eAAe,CAAC;IACxB,CAAC,OAAO,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF,4EAA4E;AAE5E;;;GAGG;AACH,SAAS,YAAY,CAAC,KAAsB,EAAE,MAAc;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;IACtD,IAAI,aAAa,KAAK,SAAS,IAAI,KAAK,GAAG,aAAa;QAAE,OAAO,IAAI,CAAC;IACtE,IAAI,YAAY,KAAK,SAAS,IAAI,KAAK,GAAG,YAAY;QAAE,OAAO,IAAI,CAAC;IACpE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAS,EAAE,CAAS,EAAE,GAAW;IACzD,OAAO;QACL,EAAE,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,yBAAyB,CAAC,QAAQ,CAAC,uDAAuD;QACjG,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE;YACR,GAAG,CAAC,iCAAiC;YACrC,GAAG,CAAC,iCAAiC;YACrC,QAAQ,CAAC,QAAQ,CAAC,yEAAyE;SAC5F;QACD,UAAU,EAAE,GAAG;QACf,6FAA6F;QAC7F,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,EAAE,MAAM;KACf,CAAC;AACJ,CAAC;AAED,4EAA4E;AAE5E;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAsB,EACtB,IAAqB;IAErB,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,kBAAkB,EAAE,CAAC;QACxC,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC;YACrD,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/medical/analysis/finding-writer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Finding vault writer — writes MedicalFinding notes and the Dataview dashboard.
+ *
+ * PURE file I/O only.
+ * NO network. NO LLM. NO Date.now(). All timestamps are injected via MedicalFinding.surfacedAt.
+ *
+ * Mirrors writeLabNote pattern at src/medical/lab-note.ts:191-236.
+ * Uses node:fs/promises only (principles: no sync fs).
+ */
+import type { MedicalFinding } from "./finding.js";
+/**
+ * Write a MedicalFinding to <vaultDir>/findings/<finding.id>.md.
+ * Creates parent directories as needed (ensureDir mirrors lab-note.ts:232).
+ * Returns the absolute path written.
+ *
+ * Finding ids are deterministic hex strings (no colons, no spaces) — safe as filenames.
+ */
+export declare function writeFinding(vaultDir: string, finding: MedicalFinding): Promise<string>;
+/**
+ * Write the Dataview findings dashboard to <vaultDir>/findings/dashboard.md.
+ * The dashboard references frontmatter fields urgency, severity, kind, and status (sc-1-5).
+ * Creates parent directories as needed.
+ * Returns the absolute path written.
+ */
+export declare function writeDashboard(vaultDir: string): Promise<string>;
+//# sourceMappingURL=finding-writer.d.ts.map

package/dist/medical/analysis/finding-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-writer.d.ts","sourceRoot":"","sources":["../../../src/medical/analysis/finding-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAM7F;AAuBD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKtE"}

package/dist/medical/analysis/finding-writer.js

@@ -0,0 +1,60 @@
+/**
+ * Finding vault writer — writes MedicalFinding notes and the Dataview dashboard.
+ *
+ * PURE file I/O only.
+ * NO network. NO LLM. NO Date.now(). All timestamps are injected via MedicalFinding.surfacedAt.
+ *
+ * Mirrors writeLabNote pattern at src/medical/lab-note.ts:191-236.
+ * Uses node:fs/promises only (principles: no sync fs).
+ */
+import { writeFile } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { ensureDir } from "../../utils/fs.js";
+import { serializeFindingToMarkdown } from "./finding.js";
+// -- Finding writer -------------------------------------------------------
+/**
+ * Write a MedicalFinding to <vaultDir>/findings/<finding.id>.md.
+ * Creates parent directories as needed (ensureDir mirrors lab-note.ts:232).
+ * Returns the absolute path written.
+ *
+ * Finding ids are deterministic hex strings (no colons, no spaces) — safe as filenames.
+ */
+export async function writeFinding(vaultDir, finding) {
+    const notePath = join(vaultDir, "findings", `${finding.id}.md`);
+    const serialized = serializeFindingToMarkdown(finding);
+    await ensureDir(dirname(notePath));
+    await writeFile(notePath, serialized, "utf-8");
+    return notePath;
+}
+// -- Dashboard writer -----------------------------------------------------
+/**
+ * Dataview dashboard content.
+ * TABLE rows: urgency, severity, kind, status for all medical findings, sorted by urgency DESC.
+ */
+const DASHBOARD_CONTENT = `---
+title: Medical Findings Dashboard
+domain: medical
+---
+
+# Medical Findings Dashboard
+
+\`\`\`dataview
+TABLE urgency, severity, kind, status
+FROM "findings"
+WHERE domain = "medical"
+SORT urgency DESC
+\`\`\`
+`;
+/**
+ * Write the Dataview findings dashboard to <vaultDir>/findings/dashboard.md.
+ * The dashboard references frontmatter fields urgency, severity, kind, and status (sc-1-5).
+ * Creates parent directories as needed.
+ * Returns the absolute path written.
+ */
+export async function writeDashboard(vaultDir) {
+    const dashPath = join(vaultDir, "findings", "dashboard.md");
+    await ensureDir(dirname(dashPath));
+    await writeFile(dashPath, DASHBOARD_CONTENT, "utf-8");
+    return dashPath;
+}
+//# sourceMappingURL=finding-writer.js.map

package/dist/medical/analysis/finding-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-writer.js","sourceRoot":"","sources":["../../../src/medical/analysis/finding-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAG1D,4EAA4E;AAE5E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB,EAAE,OAAuB;IAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnC,MAAM,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,4EAA4E;AAE5E;;;GAGG;AACH,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;CAazB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;IAC5D,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnC,MAAM,SAAS,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/medical/analysis/finding.d.ts

@@ -0,0 +1,63 @@
+/**
+ * MedicalFinding — common Finding field set emitted as vault markdown frontmatter.
+ *
+ * PURE / NO network / NO LLM / NO Date.now()
+ * All timestamps are injected parameters; the wall clock is read ONLY at the CLI boundary.
+ *
+ * Finding ids are deterministic SHA-256 slices (mirrors observationId at
+ * src/medical/health-store.ts:32-42) over stable content (domain|biomarker|ruleKey).
+ * 'now' is NEVER included in the id — re-runs with the same condition produce the same id.
+ *
+ * Does NOT define a canonical Zod schema; the canonical schema is owned by
+ * spec-20260628-priority-hub. This module emits the common Finding field set as
+ * vault markdown frontmatter only.
+ */
+/** Finding domain — fixed to "medical" for all findings in this module. */
+export type FindingDomain = "medical";
+/** Finding kind — research §3a finding taxonomy. */
+export type FindingKind = "action" | "watch" | "risk" | "question";
+/** Finding status. */
+export type FindingStatus = "open" | "resolved" | "dismissed";
+/**
+ * Common Finding field set for medical findings (research §3a, spec §5).
+ * domain is fixed to "medical".
+ * Emitted as YAML frontmatter only; no canonical Zod schema here.
+ */
+export interface MedicalFinding {
+    id: string;
+    domain: FindingDomain;
+    title: string;
+    kind: FindingKind;
+    /** Urgency level 1–5 (5 = most urgent). */
+    urgency: number;
+    /** Severity level 1–5 (5 = most severe). */
+    severity: number;
+    evidence: string[];
+    /** ISO 8601 — INJECTED parameter, never wall-clock. */
+    surfacedAt: string;
+    dueBy?: string;
+    tags: string[];
+    status: FindingStatus;
+    promotesTo?: string;
+}
+/**
+ * Derive a deterministic 16-char hex finding id.
+ * Mirrors observationId at src/medical/health-store.ts:32-42.
+ * NEVER includes `now` — same condition must map to same id across runs (idempotency).
+ *
+ * @param domain    Finding domain (e.g. "medical")
+ * @param biomarker Lab biomarker name
+ * @param ruleKey   Rule identifier (e.g. "rule-a-high", "rule-b-low")
+ */
+export declare function findingId(domain: string, biomarker: string, ruleKey: string): string;
+/**
+ * Serialize a MedicalFinding to a YAML-frontmatter markdown note string.
+ *
+ * Uses the array-aware serializeFrontmatter from src/vault/frontmatter.ts (Pattern C).
+ * Required frontmatter keys (sc-1-6): id, domain, kind, urgency, severity, surfacedAt, status.
+ * Also emits: title, evidence[], tags[].
+ *
+ * surfacedAt equals MedicalFinding.surfacedAt (injected opts.now) — NEVER wall-clock.
+ */
+export declare function serializeFindingToMarkdown(finding: MedicalFinding): string;
+//# sourceMappingURL=finding.d.ts.map

package/dist/medical/analysis/finding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding.d.ts","sourceRoot":"","sources":["../../../src/medical/analysis/finding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC;AAEtC,oDAAoD;AACpD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnE,sBAAsB;AACtB,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKpF;AAID;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CA8B1E"}

package/dist/medical/analysis/finding.js

@@ -0,0 +1,70 @@
+/**
+ * MedicalFinding — common Finding field set emitted as vault markdown frontmatter.
+ *
+ * PURE / NO network / NO LLM / NO Date.now()
+ * All timestamps are injected parameters; the wall clock is read ONLY at the CLI boundary.
+ *
+ * Finding ids are deterministic SHA-256 slices (mirrors observationId at
+ * src/medical/health-store.ts:32-42) over stable content (domain|biomarker|ruleKey).
+ * 'now' is NEVER included in the id — re-runs with the same condition produce the same id.
+ *
+ * Does NOT define a canonical Zod schema; the canonical schema is owned by
+ * spec-20260628-priority-hub. This module emits the common Finding field set as
+ * vault markdown frontmatter only.
+ */
+import { createHash } from "node:crypto";
+import { serializeFrontmatter } from "../../vault/frontmatter.js";
+// -- Deterministic id -----------------------------------------------------
+/**
+ * Derive a deterministic 16-char hex finding id.
+ * Mirrors observationId at src/medical/health-store.ts:32-42.
+ * NEVER includes `now` — same condition must map to same id across runs (idempotency).
+ *
+ * @param domain    Finding domain (e.g. "medical")
+ * @param biomarker Lab biomarker name
+ * @param ruleKey   Rule identifier (e.g. "rule-a-high", "rule-b-low")
+ */
+export function findingId(domain, biomarker, ruleKey) {
+    return createHash("sha256")
+        .update(`${domain}|${biomarker}|${ruleKey}`)
+        .digest("hex")
+        .slice(0, 16);
+}
+// -- Serialization --------------------------------------------------------
+/**
+ * Serialize a MedicalFinding to a YAML-frontmatter markdown note string.
+ *
+ * Uses the array-aware serializeFrontmatter from src/vault/frontmatter.ts (Pattern C).
+ * Required frontmatter keys (sc-1-6): id, domain, kind, urgency, severity, surfacedAt, status.
+ * Also emits: title, evidence[], tags[].
+ *
+ * surfacedAt equals MedicalFinding.surfacedAt (injected opts.now) — NEVER wall-clock.
+ */
+export function serializeFindingToMarkdown(finding) {
+    const frontmatter = {
+        id: finding.id,
+        domain: finding.domain,
+        title: finding.title,
+        kind: finding.kind,
+        urgency: finding.urgency,
+        severity: finding.severity,
+        evidence: finding.evidence,
+        surfacedAt: finding.surfacedAt,
+        tags: finding.tags,
+        status: finding.status,
+    };
+    if (finding.dueBy !== undefined) {
+        frontmatter["dueBy"] = finding.dueBy;
+    }
+    if (finding.promotesTo !== undefined) {
+        frontmatter["promotesTo"] = finding.promotesTo;
+    }
+    const body = `\n## ${finding.title}\n\n` +
+        `**Kind:** ${finding.kind}  \n` +
+        `**Urgency:** ${finding.urgency}/5  \n` +
+        `**Severity:** ${finding.severity}/5\n\n` +
+        finding.evidence.map((e) => `- ${e}`).join("\n") +
+        "\n";
+    return serializeFrontmatter(frontmatter, body);
+}
+//# sourceMappingURL=finding.js.map

package/dist/medical/analysis/finding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding.js","sourceRoot":"","sources":["../../../src/medical/analysis/finding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAoClE,4EAA4E;AAE5E;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,SAAiB,EAAE,OAAe;IAC1E,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,GAAG,MAAM,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;SAC3C,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,4EAA4E;AAE5E;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAuB;IAChE,MAAM,WAAW,GAA4B;QAC3C,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;IAEF,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IACvC,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,WAAW,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,GACR,QAAQ,OAAO,CAAC,KAAK,MAAM;QAC3B,aAAa,OAAO,CAAC,IAAI,MAAM;QAC/B,gBAAgB,OAAO,CAAC,OAAO,QAAQ;QACvC,iBAAiB,OAAO,CAAC,QAAQ,QAAQ;QACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAChD,IAAI,CAAC;IAEP,OAAO,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/medical/analysis/review-pass.d.ts

@@ -0,0 +1,76 @@
+/**
+ * runProactiveReview — deterministic proactive review pass over HealthDataStore lab series.
+ *
+ * NO LLM / NO network. Fully deterministic and offline.
+ * Finding ids are stable — re-running over an unchanged store with the same opts.now
+ * overwrites the same files without creating duplicates (sc-1-4 idempotency).
+ *
+ * Mirrors src/cli/commands/medical.ts:155-215 (open-store / try / finally-close / vault-resolve).
+ * Health.db path resolution mirrors src/medical/engine.ts:350.
+ *
+ * Accepts an optional opts.store for testability — if provided the caller owns the lifecycle
+ * (this function will NOT close an injected store, mirrors engine.ts:342-347).
+ *
+ * Sprint 4 extension: also runs detectTestGaps (cadence.ts) and detectCrossMarkerPatterns
+ * (cross-marker.ts) in the same offline pass. All finding ids use DISTINCT ruleKeys so they
+ * never collide with trend ids and idempotency (sc-1-4) is preserved.
+ *
+ * digDeeper: reads an offer finding from disk, recovers its marker pair from frontmatter tags,
+ * and delegates the deep analysis to generateRecommendation (the ONLY LLM step in this module).
+ */
+import { HealthDataStore } from "../health-store.js";
+import type { BoberConfig } from "../../config/schema.js";
+import { generateRecommendation } from "../recommend/recommend.js";
+import type { RecommendDeps, RecommendOutcome } from "../recommend/recommend.js";
+/** Result returned by runProactiveReview. */
+export interface ProactiveReviewResult {
+    findingsWritten: number;
+    dashboardPath: string;
+    findingPaths: string[];
+}
+/**
+ * Injectable dependencies for digDeeper.
+ * Production callers pass no deps. Tests inject a generateRecommendation spy
+ * to assert delegation without triggering real LLM/network calls (sc-4-6).
+ */
+export interface DigDeeperDeps {
+    /** Injected for sc-4-6 spy — defaults to the real generateRecommendation. */
+    generateRecommendation?: typeof generateRecommendation;
+    /** Forwarded to generateRecommendation for its own test deps. */
+    recommendDeps?: RecommendDeps;
+}
+/**
+ * Run the proactive trend review pass.
+ *
+ * Opens a HealthDataStore at <projectRoot>/.bober/medical/health.db (always closes in finally
+ * unless store was injected). Resolves vaultDir from config.medical.vaultDir or the default
+ * <projectRoot>/.bober/medical/vault.
+ *
+ * Sprint 4: emits trend + gap + cross-marker-offer findings in one deterministic offline pass.
+ *
+ * @param projectRoot  Absolute path to the project root
+ * @param config       Loaded BoberConfig
+ * @param opts         { now: ISO 8601 timestamp; biomarkers?: list; store?: injected store }
+ */
+export declare function runProactiveReview(projectRoot: string, config: BoberConfig, opts: {
+    now: string;
+    biomarkers?: string[];
+    store?: HealthDataStore;
+}): Promise<ProactiveReviewResult>;
+/**
+ * Run deeper cross-marker analysis for a given offer finding id (the ONLY LLM step here).
+ *
+ * Reads the offer finding note from disk, recovers the marker pair from its frontmatter tags
+ * (tags: ["cross-marker", markerA, markerB]), frames a question, and delegates to
+ * generateRecommendation (sprint 3). Does NOT re-implement the judge loop.
+ *
+ * @param projectRoot  Absolute project root path
+ * @param config       Loaded BoberConfig
+ * @param offerId      Finding id of the cross-marker offer note
+ * @param opts         { now: ISO 8601 injected timestamp }
+ * @param deps         Optional injectable deps (tests inject a generateRecommendation spy)
+ */
+export declare function digDeeper(projectRoot: string, config: BoberConfig, offerId: string, opts: {
+    now: string;
+}, deps?: DigDeeperDeps): Promise<RecommendOutcome>;
+//# sourceMappingURL=review-pass.d.ts.map

package/dist/medical/analysis/review-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-pass.d.ts","sourceRoot":"","sources":["../../../src/medical/analysis/review-pass.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAM1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAIjF,6CAA6C;AAC7C,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,sBAAsB,CAAC,EAAE,OAAO,sBAAsB,CAAC;IACvD,iEAAiE;IACjE,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,eAAe,CAAA;CAAE,GACpE,OAAO,CAAC,qBAAqB,CAAC,CAyDhC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EACrB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAc3B"}

package/dist/medical/analysis/review-pass.js

@@ -0,0 +1,119 @@
+/**
+ * runProactiveReview — deterministic proactive review pass over HealthDataStore lab series.
+ *
+ * NO LLM / NO network. Fully deterministic and offline.
+ * Finding ids are stable — re-running over an unchanged store with the same opts.now
+ * overwrites the same files without creating duplicates (sc-1-4 idempotency).
+ *
+ * Mirrors src/cli/commands/medical.ts:155-215 (open-store / try / finally-close / vault-resolve).
+ * Health.db path resolution mirrors src/medical/engine.ts:350.
+ *
+ * Accepts an optional opts.store for testability — if provided the caller owns the lifecycle
+ * (this function will NOT close an injected store, mirrors engine.ts:342-347).
+ *
+ * Sprint 4 extension: also runs detectTestGaps (cadence.ts) and detectCrossMarkerPatterns
+ * (cross-marker.ts) in the same offline pass. All finding ids use DISTINCT ruleKeys so they
+ * never collide with trend ids and idempotency (sc-1-4) is preserved.
+ *
+ * digDeeper: reads an offer finding from disk, recovers its marker pair from frontmatter tags,
+ * and delegates the deep analysis to generateRecommendation (the ONLY LLM step in this module).
+ */
+import { join } from "node:path";
+import { readFile } from "node:fs/promises";
+import { HealthDataStore } from "../health-store.js";
+import { ensureDir } from "../../utils/fs.js";
+import { analyzeTrends } from "./trends.js";
+import { detectTestGaps } from "./cadence.js";
+import { detectCrossMarkerPatterns } from "./cross-marker.js";
+import { writeFinding, writeDashboard } from "./finding-writer.js";
+import { parseFrontmatter } from "../../vault/frontmatter.js";
+import { generateRecommendation } from "../recommend/recommend.js";
+// -- Public API -----------------------------------------------------------
+/**
+ * Run the proactive trend review pass.
+ *
+ * Opens a HealthDataStore at <projectRoot>/.bober/medical/health.db (always closes in finally
+ * unless store was injected). Resolves vaultDir from config.medical.vaultDir or the default
+ * <projectRoot>/.bober/medical/vault.
+ *
+ * Sprint 4: emits trend + gap + cross-marker-offer findings in one deterministic offline pass.
+ *
+ * @param projectRoot  Absolute path to the project root
+ * @param config       Loaded BoberConfig
+ * @param opts         { now: ISO 8601 timestamp; biomarkers?: list; store?: injected store }
+ */
+export async function runProactiveReview(projectRoot, config, opts) {
+    // Resolve vault dir: config.medical.vaultDir or default
+    const vaultDir = config.medical?.vaultDir ?? join(projectRoot, ".bober", "medical", "vault");
+    const medicalDir = join(projectRoot, ".bober", "medical");
+    // Store lifecycle: injected store (test) → caller owns; else open and own
+    const weOpened = opts.store === undefined;
+    let store = opts.store;
+    try {
+        if (weOpened) {
+            await ensureDir(medicalDir);
+            store = new HealthDataStore(join(medicalDir, "health.db"));
+        }
+        if (store === undefined) {
+            // Defensive guard — unreachable in practice (weOpened=false => opts.store is set)
+            throw new Error("[review-pass] HealthDataStore not available");
+        }
+        // Resolve biomarkers: use provided list or enumerate all from the store
+        const biomarkers = opts.biomarkers !== undefined && opts.biomarkers.length > 0
+            ? opts.biomarkers
+            : store.listBiomarkers();
+        // Sprint 4: gather trend + gap + cross-marker-offer findings in one offline pass.
+        // Each analyzer uses a DISTINCT ruleKey so ids never collide and idempotency holds (sc-1-4).
+        const findings = [
+            ...analyzeTrends(store, biomarkers, { now: opts.now }),
+            ...detectTestGaps(store, biomarkers, { now: opts.now }),
+            ...detectCrossMarkerPatterns(store, { now: opts.now }),
+        ];
+        // Write one finding note per detected condition
+        const findingPaths = [];
+        for (const finding of findings) {
+            const path = await writeFinding(vaultDir, finding);
+            findingPaths.push(path);
+        }
+        // Always write the dashboard (sc-1-5)
+        const dashboardPath = await writeDashboard(vaultDir);
+        return {
+            findingsWritten: findings.length,
+            dashboardPath,
+            findingPaths,
+        };
+    }
+    finally {
+        // Only close stores we opened; never close an injected store (sc-1-4 / `:memory:` tests)
+        if (weOpened && store !== undefined) {
+            store.close();
+        }
+    }
+}
+/**
+ * Run deeper cross-marker analysis for a given offer finding id (the ONLY LLM step here).
+ *
+ * Reads the offer finding note from disk, recovers the marker pair from its frontmatter tags
+ * (tags: ["cross-marker", markerA, markerB]), frames a question, and delegates to
+ * generateRecommendation (sprint 3). Does NOT re-implement the judge loop.
+ *
+ * @param projectRoot  Absolute project root path
+ * @param config       Loaded BoberConfig
+ * @param offerId      Finding id of the cross-marker offer note
+ * @param opts         { now: ISO 8601 injected timestamp }
+ * @param deps         Optional injectable deps (tests inject a generateRecommendation spy)
+ */
+export async function digDeeper(projectRoot, config, offerId, opts, deps = {}) {
+    const vaultDir = config.medical?.vaultDir ?? join(projectRoot, ".bober", "medical", "vault");
+    const notePath = join(vaultDir, "findings", `${offerId}.md`);
+    const raw = await readFile(notePath, "utf-8");
+    const { frontmatter } = parseFrontmatter(raw);
+    const tags = frontmatter["tags"] ?? [];
+    // Recover marker pair: filter out the "cross-marker" sentinel; remainder is [markerA, markerB]
+    const pair = tags.filter((t) => t !== "cross-marker");
+    const question = `The markers ${pair.join(" and ")} are both out of reference range. ` +
+        `Dig deeper into what that combination suggests.`;
+    const gen = deps.generateRecommendation ?? generateRecommendation;
+    return gen(projectRoot, config, { question, now: opts.now }, deps.recommendDeps);
+}
+//# sourceMappingURL=review-pass.js.map

package/dist/medical/analysis/review-pass.js.map

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

package/dist/medical/analysis/trends.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Lab trend analyzer — deterministic reference-range and slope rules.
+ *
+ * PURE / NO network / NO LLM / NO Date.now() / NO async / NO fs.
+ * Identical input => identical output.
+ *
+ * ADR-3: The LLM NEVER performs arithmetic. All trend math is delegated exclusively to
+ * NumericsQueryLayer.getLabTrend (slope + latestValue). No hand-rolled slope arithmetic.
+ *
+ * Rules:
+ *   A. Reference-range crossing: latestValue outside [referenceLow, referenceHigh]
+ *      → kind 'watch' (severity 3, urgency 3);
+ *        >20% beyond the edge → kind 'risk' (severity 4, urgency 4).
+ *   B. Slope-toward-edge: slope != null, value is in range, trending toward the nearer
+ *      reference edge with a projected crossing → kind 'watch' (severity 2, urgency 2).
+ *
+ * Abstains (empty findings) when sampleCount === 0 for a biomarker.
+ * Reference range is read from store.getLabSeries (LabTrend does not carry it).
+ */
+import type { HealthDataStore } from "../health-store.js";
+import type { MedicalFinding } from "./finding.js";
+/**
+ * Analyze lab trends for a set of biomarkers and return detected findings.
+ *
+ * PURE, synchronous, deterministic. No async, no fs, no network, no LLM.
+ * Delegates ALL trend math to NumericsQueryLayer.getLabTrend (ADR-3).
+ * Reference ranges are read from store.getLabSeries (LabTrend does not carry them).
+ *
+ * @param store       HealthDataStore (caller is responsible for lifecycle)
+ * @param biomarkers  List of biomarker names to analyze
+ * @param opts        { now: ISO 8601 injected timestamp }
+ */
+export declare function analyzeTrends(store: HealthDataStore, biomarkers: string[], opts: {
+    now: string;
+}): MedicalFinding[];
+//# sourceMappingURL=trends.d.ts.map

package/dist/medical/analysis/trends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trends.d.ts","sourceRoot":"","sources":["../../../src/medical/analysis/trends.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,cAAc,CAAC;AAmJhE;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACpB,cAAc,EAAE,CAoDlB"}