agent-bober 0.17.1 → 0.19.0

package/dist/medical/red-flag.js

@@ -0,0 +1,161 @@
+/**
+ * RedFlagDetector — pure, synchronous, 0-LLM emergency detection (Phase 6, Sprint 3).
+ *
+ * ADR-2: Detection is deterministic and local. A conservative keyword/phrase match
+ * favors escalation reliability over paraphrase coverage. Novel phrasing may return
+ * 'none' and proceed to the normal (still-guardrailed) path — this is the accepted risk
+ * documented in ADR-2. Pattern set is versioned for auditability.
+ *
+ * NO async. NO fs. NO network. NO LLM import. Identical input => identical output.
+ */
+// ── Version constant ─────────────────────────────────────────────────
+/** Versioned pattern-set identifier recorded in the audit log (ADR-2). */
+export const PATTERNSET_VERSION = "redflag-2026.06.16";
+/**
+ * Conservative rule list. Order matters:
+ * self-harm and overdose are checked so the correct hotline (988) wins over
+ * any incidental cardiac/anaphylaxis phrase in the same message.
+ *
+ * bober: phrase-include matching for now; upgrade to word-boundary regex or
+ *        an embedded trie if the pattern count grows to > 50 rules.
+ */
+const RULES = [
+    // ── self-harm (988) ──────────────────────────────────────────────
+    {
+        ruleId: "self-harm-suicidal",
+        category: "self-harm",
+        test: (n) => n.includes("suicidal") || n.includes("suicid"),
+    },
+    {
+        ruleId: "self-harm-kill-self",
+        category: "self-harm",
+        test: (n) => n.includes("kill myself") ||
+            n.includes("end my life") ||
+            n.includes("take my life") ||
+            n.includes("want to die"),
+    },
+    {
+        ruleId: "self-harm-self-harm",
+        category: "self-harm",
+        test: (n) => n.includes("hurt myself") || n.includes("harm myself"),
+    },
+    // ── overdose (988) ───────────────────────────────────────────────
+    {
+        ruleId: "overdose-explicit",
+        category: "overdose",
+        test: (n) => n.includes("overdose") || n.includes("over dose"),
+    },
+    {
+        ruleId: "overdose-too-many",
+        category: "overdose",
+        test: (n) => n.includes("took too many") || n.includes("taken too many"),
+    },
+    // ── cardiac (911) ────────────────────────────────────────────────
+    {
+        ruleId: "cardiac-chest-pain-radiating",
+        category: "cardiac",
+        test: (n) => n.includes("chest pain") && (n.includes("radiating") || n.includes("left arm")),
+    },
+    {
+        ruleId: "cardiac-chest-pain-breath",
+        category: "cardiac",
+        test: (n) => n.includes("chest pain") && (n.includes("short of breath") || n.includes("shortness of breath")),
+    },
+    {
+        ruleId: "cardiac-chest-crushing",
+        category: "cardiac",
+        test: (n) => (n.includes("crushing chest") || n.includes("chest pressure") || n.includes("chest tightness")) &&
+            (n.includes("arm") || n.includes("jaw") || n.includes("breath")),
+    },
+    {
+        ruleId: "cardiac-heart-attack",
+        category: "cardiac",
+        test: (n) => n.includes("heart attack"),
+    },
+    // ── stroke (911) — FAST: Face, Arms, Speech, Time ───────────────
+    {
+        ruleId: "stroke-face-droop",
+        category: "stroke",
+        test: (n) => n.includes("face droop") ||
+            n.includes("facial droop") ||
+            n.includes("drooping face"),
+    },
+    {
+        ruleId: "stroke-slurred-speech",
+        category: "stroke",
+        test: (n) => n.includes("slurred speech") ||
+            n.includes("slurring words") ||
+            n.includes("can't speak") ||
+            n.includes("cannot speak"),
+    },
+    {
+        ruleId: "stroke-arm-weakness",
+        category: "stroke",
+        test: (n) => (n.includes("arm weakness") || n.includes("arm numb")) &&
+            (n.includes("sudden") || n.includes("both arms")),
+    },
+    {
+        ruleId: "stroke-sudden-numbness",
+        category: "stroke",
+        test: (n) => n.includes("sudden numbness") || n.includes("sudden weakness"),
+    },
+    {
+        ruleId: "stroke-sudden-severe-headache",
+        category: "stroke",
+        test: (n) => n.includes("worst headache") ||
+            (n.includes("sudden") && n.includes("severe headache")),
+    },
+    // ── anaphylaxis (911) ────────────────────────────────────────────
+    {
+        ruleId: "anaphylaxis-throat-closing",
+        category: "anaphylaxis",
+        test: (n) => n.includes("throat closing") ||
+            n.includes("throat is closing") ||
+            n.includes("throat swelling"),
+    },
+    {
+        ruleId: "anaphylaxis-trouble-breathing-allergic",
+        category: "anaphylaxis",
+        test: (n) => n.includes("trouble breathing") &&
+            (n.includes("allergic") || n.includes("allergy") || n.includes("sting") || n.includes("peanut")),
+    },
+    {
+        ruleId: "anaphylaxis-cant-breathe-allergic",
+        category: "anaphylaxis",
+        test: (n) => (n.includes("can't breathe") || n.includes("cannot breathe")) &&
+            (n.includes("allergic") || n.includes("allergy") || n.includes("sting") || n.includes("peanut")),
+    },
+    {
+        ruleId: "anaphylaxis-anaphylaxis",
+        category: "anaphylaxis",
+        test: (n) => n.includes("anaphylaxis") || n.includes("anaphylactic"),
+    },
+];
+// ── RedFlagDetector ──────────────────────────────────────────────────
+/**
+ * Detects emergency red-flag phrases in a medical prompt.
+ *
+ * PURE + SYNCHRONOUS. No async, no fs, no network, no LLM import.
+ * Identical input => identical RedFlagMatch (asserted by sc-3-5).
+ *
+ * bober: conservative phrase matching; novel or indirect phrasing may return
+ *        'none' and fall through to normal SOP handling (ADR-2 accepted risk).
+ */
+export class RedFlagDetector {
+    patternsetVersion = PATTERNSET_VERSION;
+    /**
+     * Returns the first matching RedFlagMatch, or { category: 'none' } if no
+     * rule fires. Evaluation order is self-harm → overdose → cardiac → stroke →
+     * anaphylaxis so the correct emergency hotline (988 vs 911) is assigned.
+     */
+    detect(prompt) {
+        const norm = prompt.toLowerCase().trim();
+        for (const rule of RULES) {
+            if (rule.test(norm)) {
+                return { category: rule.category, ruleId: rule.ruleId };
+            }
+        }
+        return { category: "none" };
+    }
+}
+//# sourceMappingURL=red-flag.js.map

package/dist/medical/red-flag.js.map

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

package/dist/medical/refusal.d.ts

@@ -0,0 +1,46 @@
+/**
+ * RefusalDetector — pure, synchronous, 0-LLM non-emergency content-policy refusal.
+ *
+ * Classifies prescription / specific-dosing / individualized-treatment-plan requests.
+ * Conservative phrase matching: accept FALSE-NEGATIVES (fall through to 'none'),
+ * NEVER false-positive into giving medical advice. Pattern set is versioned for audit.
+ *
+ * NO async. NO fs. NO network. NO LLM import. Identical input => identical output.
+ */
+/** Four mutually-exclusive categories; 'none' means no refusal pattern matched. */
+export type RefusalCategory = "prescription" | "specific-dosing" | "individualized-treatment-plan" | "none";
+/** Result of a single RefusalDetector.detect() call. */
+export interface RefusalMatch {
+    category: RefusalCategory;
+    /**
+     * Rule ID that fired (IDs only — never prompt text).
+     * Undefined when category === 'none'.
+     */
+    ruleId?: string;
+}
+/** Versioned pattern-set identifier recorded in the audit log. */
+export declare const REFUSAL_PATTERNSET_VERSION = "refusal-2026.06.17";
+/**
+ * Fixed canned reason strings per refusal category.
+ * Exported so callers can assert byte-equality (proving non-model-generation).
+ */
+export declare const REFUSAL_REASONS: Record<Exclude<RefusalCategory, "none">, string>;
+/**
+ * Detects non-emergency content-policy refusal phrases in a medical prompt.
+ *
+ * PURE + SYNCHRONOUS. No async, no fs, no network, no LLM import.
+ * Identical input => identical RefusalMatch output.
+ *
+ * bober: conservative phrase matching; novel or indirect phrasing may return
+ *        'none' and fall through to normal SOP handling (accepted risk; false-negative
+ *        is safer than false-positive into refused advice).
+ */
+export declare class RefusalDetector {
+    readonly patternsetVersion = "refusal-2026.06.17";
+    /**
+     * Returns the first matching RefusalMatch, or { category: 'none' } if no
+     * rule fires. Evaluation order is prescription → specific-dosing → treatment-plan.
+     */
+    detect(prompt: string): RefusalMatch;
+}
+//# sourceMappingURL=refusal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refusal.d.ts","sourceRoot":"","sources":["../../src/medical/refusal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,mFAAmF;AACnF,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,iBAAiB,GACjB,+BAA+B,GAC/B,MAAM,CAAC;AAEX,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,kEAAkE;AAClE,eAAO,MAAM,0BAA0B,uBAAuB,CAAC;AAkB/D;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,CAI5E,CAAC;AA6FF;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,iBAAiB,wBAA8B;IAExD;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;CASrC"}

package/dist/medical/refusal.js

@@ -0,0 +1,131 @@
+/**
+ * RefusalDetector — pure, synchronous, 0-LLM non-emergency content-policy refusal.
+ *
+ * Classifies prescription / specific-dosing / individualized-treatment-plan requests.
+ * Conservative phrase matching: accept FALSE-NEGATIVES (fall through to 'none'),
+ * NEVER false-positive into giving medical advice. Pattern set is versioned for audit.
+ *
+ * NO async. NO fs. NO network. NO LLM import. Identical input => identical output.
+ */
+// ── Version constant ─────────────────────────────────────────────────
+/** Versioned pattern-set identifier recorded in the audit log. */
+export const REFUSAL_PATTERNSET_VERSION = "refusal-2026.06.17";
+// ── Canned refuse reason strings (NEVER model-generated) ─────────────
+// Decline + see-a-licensed-clinician. DISTINCT from 911/988 escalations —
+// no "911", "988", or "emergency" so refuse text is byte-distinct from escalation text.
+const REFUSE_PRESCRIPTION = "I can't provide a prescription or recommend a specific prescription medication. " +
+    "Please consult a licensed clinician who can evaluate you and prescribe appropriately.";
+const REFUSE_DOSING = "I can't provide a specific medication dose or dosing schedule for you. " +
+    "Please consult a licensed clinician or pharmacist for personalised dosing guidance.";
+const REFUSE_TREATMENT_PLAN = "I can't create an individualised treatment or care plan. " +
+    "Please consult a licensed clinician who can evaluate your situation and develop a plan for you.";
+/**
+ * Fixed canned reason strings per refusal category.
+ * Exported so callers can assert byte-equality (proving non-model-generation).
+ */
+export const REFUSAL_REASONS = {
+    prescription: REFUSE_PRESCRIPTION,
+    "specific-dosing": REFUSE_DOSING,
+    "individualized-treatment-plan": REFUSE_TREATMENT_PLAN,
+};
+/**
+ * Conservative rule list. Order: prescription → specific-dosing → treatment-plan.
+ * Accept false-negatives freely; NEVER fire on benign informational prompts.
+ *
+ * bober: phrase-include matching for now; upgrade to word-boundary regex or
+ *        a trie if the pattern count grows to > 50 rules.
+ */
+const RULES = [
+    // ── prescription ────────────────────────────────────────────────────
+    {
+        ruleId: "rx-request-modal",
+        category: "prescription",
+        test: (n) => n.includes("can you prescribe") || n.includes("could you prescribe"),
+    },
+    {
+        ruleId: "rx-request-write",
+        category: "prescription",
+        test: (n) => n.includes("write me a prescription") ||
+            n.includes("get me a prescription") ||
+            n.includes("prescription for me"),
+    },
+    {
+        ruleId: "rx-request-direct",
+        category: "prescription",
+        test: (n) => n.includes("prescribe me") ||
+            (n.includes("prescribe") && (n.includes(" me ") || n.includes(" me?") || n.includes(" i "))),
+    },
+    // ── specific-dosing ──────────────────────────────────────────────────
+    {
+        ruleId: "dose-quantity-mg",
+        category: "specific-dosing",
+        test: (n) => n.includes("how many mg") || n.includes("how many milligrams"),
+    },
+    {
+        ruleId: "dose-query-what",
+        category: "specific-dosing",
+        test: (n) => n.includes("what dose") || n.includes("what dosage"),
+    },
+    {
+        ruleId: "dose-query-take-mg",
+        category: "specific-dosing",
+        test: (n) => /should i take\s+\d/.test(n) ||
+            (n.includes("should i take") && (n.includes("mg") || n.includes("milligram"))),
+    },
+    {
+        ruleId: "dose-query-how-much-take",
+        category: "specific-dosing",
+        test: (n) => n.includes("how much") && n.includes("should i take"),
+    },
+    // ── individualized-treatment-plan ────────────────────────────────────
+    {
+        ruleId: "txplan-for-me",
+        category: "individualized-treatment-plan",
+        test: (n) => n.includes("treatment plan for me") || n.includes("my treatment plan"),
+    },
+    {
+        ruleId: "txplan-what-to-do",
+        category: "individualized-treatment-plan",
+        test: (n) => n.includes("what should i do to treat my") || n.includes("how do i treat my"),
+    },
+    {
+        ruleId: "txplan-personalized",
+        category: "individualized-treatment-plan",
+        test: (n) => n.includes("personalized treatment") ||
+            n.includes("personalised treatment") ||
+            n.includes("personal treatment plan"),
+    },
+    {
+        ruleId: "txplan-care-plan",
+        category: "individualized-treatment-plan",
+        test: (n) => n.includes("care plan for my") || n.includes("care plan for me"),
+    },
+];
+// ── RefusalDetector ──────────────────────────────────────────────────
+/**
+ * Detects non-emergency content-policy refusal phrases in a medical prompt.
+ *
+ * PURE + SYNCHRONOUS. No async, no fs, no network, no LLM import.
+ * Identical input => identical RefusalMatch output.
+ *
+ * bober: conservative phrase matching; novel or indirect phrasing may return
+ *        'none' and fall through to normal SOP handling (accepted risk; false-negative
+ *        is safer than false-positive into refused advice).
+ */
+export class RefusalDetector {
+    patternsetVersion = REFUSAL_PATTERNSET_VERSION;
+    /**
+     * Returns the first matching RefusalMatch, or { category: 'none' } if no
+     * rule fires. Evaluation order is prescription → specific-dosing → treatment-plan.
+     */
+    detect(prompt) {
+        const norm = prompt.toLowerCase().trim();
+        for (const rule of RULES) {
+            if (rule.test(norm)) {
+                return { category: rule.category, ruleId: rule.ruleId };
+            }
+        }
+        return { category: "none" };
+    }
+}
+//# sourceMappingURL=refusal.js.map

package/dist/medical/refusal.js.map

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

package/dist/medical/research/online-research.d.ts

@@ -0,0 +1,65 @@
+/**
+ * runResearchJob — egress-gated online research job (schedulable entrypoint).
+ *
+ * When literature-retrieval is OFF: returns { disabled: true, notesWritten: 0, findingsWritten: 0 }
+ * IMMEDIATELY — NO retriever constructed, ZERO egress. This is the zero-egress proof (sc-5-2).
+ *
+ * When ON: retrieves MedlinePlus passages via LiteratureRetriever, grounds notes through
+ * synthesizeGrounded (fail-closed grounding critic), writes research notes and optional watch
+ * findings to the vault.
+ *
+ * PURE clock: `now` is injected — NEVER call Date.now()/new Date() here.
+ * NO network imports — ADR-6 restricts network to medline-source.ts only.
+ *
+ * Exported as the schedulable entrypoint for spec-20260628-research-scheduler.
+ * Signature: (projectRoot, config, {markers, now}, deps?) => Promise<ResearchSummary>
+ */
+import type { BoberConfig } from "../../config/schema.js";
+import { type ClientFactory } from "../inference.js";
+import { writeFinding } from "../analysis/finding-writer.js";
+import type { LLMClient } from "../../providers/types.js";
+import type { RetrievalOutcome } from "../retrieval/medline-source.js";
+/** Summary returned by runResearchJob. */
+export interface ResearchSummary {
+    notesWritten: number;
+    findingsWritten: number;
+    disabled: boolean;
+}
+/**
+ * Injectable dependencies for runResearchJob.
+ * Production callers pass no deps — all defaults are wired from real modules.
+ * Tests inject fakes for: retriever (avoids MedlineSource), clientFactory (spy), writeFindingFn.
+ */
+export interface ResearchDeps {
+    /** Injectable retriever — defaults to a real LiteratureRetriever when axis is ON. */
+    retriever?: {
+        retrieve(query: string): Promise<RetrievalOutcome>;
+    };
+    /** Injectable LLMClient for synthesis — use clientFactory instead when testing sc-5-5. */
+    llmClient?: LLMClient;
+    /** Injectable client factory so tests can spy on which provider/endpoint is requested (sc-5-5). */
+    clientFactory?: ClientFactory;
+    /** Injectable finding writer so tests avoid real fs writes. Defaults to writeFinding. */
+    writeFindingFn?: typeof writeFinding;
+}
+/**
+ * Run the online research job for the given markers.
+ *
+ * Gating order (load-bearing — mirrors runImportLabs pattern at medical.ts:165-178):
+ *   1. Build EgressGuard.
+ *   2. axis OFF -> return {disabled:true, notesWritten:0, findingsWritten:0} BEFORE any construction.
+ *   3. Build synthesis client via buildMedicalInferenceClient (fail-closed local unless cloud-inference ON).
+ *   4. Resolve vault dir.
+ *   5. For each marker: retrieve -> synthesizeGrounded -> abstained? skip : write note + finding.
+ *   6. Return { disabled: false, notesWritten, findingsWritten }.
+ *
+ * @param projectRoot  Absolute project root path
+ * @param config       Loaded BoberConfig
+ * @param opts         { markers: string[]; now: string } — clock injected NEVER read here
+ * @param deps         Optional injectable dependencies (tests only)
+ */
+export declare function runResearchJob(projectRoot: string, config: BoberConfig, opts: {
+    markers: string[];
+    now: string;
+}, deps?: ResearchDeps): Promise<ResearchSummary>;
+//# sourceMappingURL=online-research.d.ts.map

package/dist/medical/research/online-research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"online-research.d.ts","sourceRoot":"","sources":["../../../src/medical/research/online-research.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1D,OAAO,EAA+B,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAElF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAKvE,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,qFAAqF;IACrF,SAAS,CAAC,EAAE;QACV,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;KACpD,CAAC;IACF,0FAA0F;IAC1F,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,mGAAmG;IACnG,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,yFAAyF;IACzF,cAAc,CAAC,EAAE,OAAO,YAAY,CAAC;CACtC;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACxC,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,eAAe,CAAC,CAqE1B"}

package/dist/medical/research/online-research.js

@@ -0,0 +1,101 @@
+/**
+ * runResearchJob — egress-gated online research job (schedulable entrypoint).
+ *
+ * When literature-retrieval is OFF: returns { disabled: true, notesWritten: 0, findingsWritten: 0 }
+ * IMMEDIATELY — NO retriever constructed, ZERO egress. This is the zero-egress proof (sc-5-2).
+ *
+ * When ON: retrieves MedlinePlus passages via LiteratureRetriever, grounds notes through
+ * synthesizeGrounded (fail-closed grounding critic), writes research notes and optional watch
+ * findings to the vault.
+ *
+ * PURE clock: `now` is injected — NEVER call Date.now()/new Date() here.
+ * NO network imports — ADR-6 restricts network to medline-source.ts only.
+ *
+ * Exported as the schedulable entrypoint for spec-20260628-research-scheduler.
+ * Signature: (projectRoot, config, {markers, now}, deps?) => Promise<ResearchSummary>
+ */
+import { writeFile } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { EgressGuard } from "../egress.js";
+import { LiteratureRetriever } from "../retrieval/literature.js";
+import { synthesizeGrounded } from "../retrieval/literature.js";
+import { buildMedicalInferenceClient } from "../inference.js";
+import { DisclaimerComposer } from "../disclaimer.js";
+import { writeFinding } from "../analysis/finding-writer.js";
+import { findingId } from "../analysis/finding.js";
+import { ensureDir } from "../../utils/fs.js";
+import { serializeResearchNote, researchNotePath } from "./research-note.js";
+// ── runResearchJob ─────────────────────────────────────────────────────
+/**
+ * Run the online research job for the given markers.
+ *
+ * Gating order (load-bearing — mirrors runImportLabs pattern at medical.ts:165-178):
+ *   1. Build EgressGuard.
+ *   2. axis OFF -> return {disabled:true, notesWritten:0, findingsWritten:0} BEFORE any construction.
+ *   3. Build synthesis client via buildMedicalInferenceClient (fail-closed local unless cloud-inference ON).
+ *   4. Resolve vault dir.
+ *   5. For each marker: retrieve -> synthesizeGrounded -> abstained? skip : write note + finding.
+ *   6. Return { disabled: false, notesWritten, findingsWritten }.
+ *
+ * @param projectRoot  Absolute project root path
+ * @param config       Loaded BoberConfig
+ * @param opts         { markers: string[]; now: string } — clock injected NEVER read here
+ * @param deps         Optional injectable dependencies (tests only)
+ */
+export async function runResearchJob(projectRoot, config, opts, deps = {}) {
+    // ── 1. Egress guard ─────────────────────────────────────────────────
+    const egress = EgressGuard.fromConfig(config);
+    // ── 2. Zero-egress short-circuit (sc-5-2) ────────────────────────────
+    // Return BEFORE constructing any LiteratureRetriever / MedlineSource (zero-egress proof).
+    if (!egress.isAllowed("literature-retrieval")) {
+        return { disabled: true, notesWritten: 0, findingsWritten: 0 };
+    }
+    // ── 3. Synthesis client (fail-closed local unless cloud-inference ON) (sc-5-5) ─
+    const { client, model } = buildMedicalInferenceClient(config, egress, deps.clientFactory);
+    const llm = deps.llmClient ?? client;
+    // ── 4. Vault dir resolution (mirrors review-pass.ts:78-79) ─────────
+    const vaultDir = config.medical?.vaultDir ?? join(projectRoot, ".bober", "medical", "vault");
+    // ── 5. Retriever (constructed ONLY here — axis-on branch) ───────────
+    // Injecting deps.retriever keeps tests free of real MedlineSource construction.
+    const retriever = deps.retriever ?? new LiteratureRetriever(egress);
+    const footer = new DisclaimerComposer().footer();
+    const writeFindingFn = deps.writeFindingFn ?? writeFinding;
+    let notesWritten = 0;
+    let findingsWritten = 0;
+    // ── 6. Per-marker retrieval + grounded synthesis ─────────────────────
+    for (const marker of opts.markers) {
+        const query = `Latest evidence on ${marker}`;
+        // Retrieve passages from MedlinePlus
+        const outcome = await retriever.retrieve(query);
+        // Grounded synthesis with fail-closed critic gate
+        const result = await synthesizeGrounded(query, outcome, llm, footer, model);
+        // sc-5-4: if critic rejected / abstained -> write NO clinical note for this topic
+        if (result.answer.abstained) {
+            // Count as abstained — do not persist uncited synthesis
+            continue;
+        }
+        // Non-abstained: write research note under <vault>/research/<date>-<marker>.md
+        const notePath = researchNotePath(vaultDir, marker, opts.now);
+        const noteContent = serializeResearchNote(marker, result.answer, opts.now);
+        await ensureDir(dirname(notePath));
+        await writeFile(notePath, noteContent, "utf-8");
+        notesWritten++;
+        // Optional watch finding (Pattern G)
+        const finding = {
+            id: findingId("medical", marker, "new-evidence"),
+            domain: "medical",
+            title: `New evidence on ${marker}`,
+            kind: "watch",
+            urgency: 2,
+            severity: 2,
+            evidence: result.answer.citations.map((c) => c.url),
+            surfacedAt: opts.now, // injected — never wall-clock
+            tags: ["research", marker],
+            status: "open",
+        };
+        await writeFindingFn(vaultDir, finding);
+        findingsWritten++;
+    }
+    return { disabled: false, notesWritten, findingsWritten };
+}
+//# sourceMappingURL=online-research.js.map

package/dist/medical/research/online-research.js.map

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

package/dist/medical/research/research-note.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Research note serializer — PURE citation-frontmatter markdown note for MedlinePlus findings.
+ *
+ * PURE / NO network / NO LLM / NO Date.now()
+ * All timestamps are injected parameters; the wall clock is read ONLY at the CLI boundary.
+ *
+ * Produces a vault research note with flattened citation frontmatter (title/url/source
+ * as parallel arrays) so serializeFrontmatter (scalar/array-of-scalar only) renders correctly.
+ * See: Pattern E / briefing §2 (the nested-object pitfall with Citation[]).
+ */
+import type { MedicalAnswer } from "../types.js";
+/**
+ * Derive the canonical path for a research note under the vault.
+ * Output: <vaultDir>/research/<YYYY-MM-DD>-<marker>.md
+ * Date is sliced from the injected ISO string — never wall-clock.
+ */
+export declare function researchNotePath(vaultDir: string, marker: string, now: string): string;
+/**
+ * Serialize a grounded MedicalAnswer into a vault research note string.
+ *
+ * Frontmatter:
+ *   title, domain, type, marker, source (scalar "medlineplus"),
+ *   citationTitles[] (strings), citationUrls[] (strings), surfacedAt, status.
+ *
+ * PITFALL: Citation is an object {title, url, source}. Passing citations straight into
+ * serializeFrontmatter would render "  - [object Object]". This function FLATTENS them
+ * into parallel arrays-of-strings (citationTitles, citationUrls) + a scalar `source`.
+ *
+ * Body: answer.body + disclaimerFooter.
+ */
+export declare function serializeResearchNote(marker: string, answer: MedicalAnswer, now: string): string;
+//# sourceMappingURL=research-note.d.ts.map

package/dist/medical/research/research-note.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-note.d.ts","sourceRoot":"","sources":["../../../src/medical/research/research-note.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGtF;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAoBhG"}

package/dist/medical/research/research-note.js

@@ -0,0 +1,55 @@
+/**
+ * Research note serializer — PURE citation-frontmatter markdown note for MedlinePlus findings.
+ *
+ * PURE / NO network / NO LLM / NO Date.now()
+ * All timestamps are injected parameters; the wall clock is read ONLY at the CLI boundary.
+ *
+ * Produces a vault research note with flattened citation frontmatter (title/url/source
+ * as parallel arrays) so serializeFrontmatter (scalar/array-of-scalar only) renders correctly.
+ * See: Pattern E / briefing §2 (the nested-object pitfall with Citation[]).
+ */
+import { serializeFrontmatter } from "../../vault/frontmatter.js";
+import { join } from "node:path";
+// ── Path helper ──────────────────────────────────────────────────────
+/**
+ * Derive the canonical path for a research note under the vault.
+ * Output: <vaultDir>/research/<YYYY-MM-DD>-<marker>.md
+ * Date is sliced from the injected ISO string — never wall-clock.
+ */
+export function researchNotePath(vaultDir, marker, now) {
+    const date = now.slice(0, 10); // YYYY-MM-DD
+    return join(vaultDir, "research", `${date}-${marker}.md`);
+}
+// ── Serializer ───────────────────────────────────────────────────────
+/**
+ * Serialize a grounded MedicalAnswer into a vault research note string.
+ *
+ * Frontmatter:
+ *   title, domain, type, marker, source (scalar "medlineplus"),
+ *   citationTitles[] (strings), citationUrls[] (strings), surfacedAt, status.
+ *
+ * PITFALL: Citation is an object {title, url, source}. Passing citations straight into
+ * serializeFrontmatter would render "  - [object Object]". This function FLATTENS them
+ * into parallel arrays-of-strings (citationTitles, citationUrls) + a scalar `source`.
+ *
+ * Body: answer.body + disclaimerFooter.
+ */
+export function serializeResearchNote(marker, answer, now) {
+    // Flatten Citation[] into scalar/array-of-string fields (Pattern E)
+    const citationTitles = answer.citations.map((c) => c.title);
+    const citationUrls = answer.citations.map((c) => c.url);
+    const frontmatter = {
+        title: `Latest evidence — ${marker}`,
+        domain: "medical",
+        type: "research",
+        marker,
+        source: "medlineplus", // scalar — satisfies sc-5-3 "source 'medlineplus'"
+        citationTitles, // array of strings — serializeFrontmatter safe
+        citationUrls, // array of strings — serializeFrontmatter safe
+        surfacedAt: now, // injected ISO string — never wall-clock
+        status: "open",
+    };
+    const body = `\n## Latest evidence on ${marker}\n\n${answer.body}\n\n${answer.disclaimerFooter}\n`;
+    return serializeFrontmatter(frontmatter, body);
+}
+//# sourceMappingURL=research-note.js.map

package/dist/medical/research/research-note.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-note.js","sourceRoot":"","sources":["../../../src/medical/research/research-note.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,wEAAwE;AAExE;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,MAAc,EAAE,GAAW;IAC5E,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa;IAC5C,OAAO,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,IAAI,MAAM,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,wEAAwE;AAExE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,MAAqB,EAAE,GAAW;IACtF,oEAAoE;IACpE,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAExD,MAAM,WAAW,GAA4B;QAC3C,KAAK,EAAE,qBAAqB,MAAM,EAAE;QACpC,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,UAAU;QAChB,MAAM;QACN,MAAM,EAAE,aAAa,EAAE,mDAAmD;QAC1E,cAAc,EAAE,+CAA+C;QAC/D,YAAY,EAAE,+CAA+C;QAC7D,UAAU,EAAE,GAAG,EAAE,yCAAyC;QAC1D,MAAM,EAAE,MAAM;KACf,CAAC;IAEF,MAAM,IAAI,GAAG,2BAA2B,MAAM,OAAO,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,gBAAgB,IAAI,CAAC;IAEnG,OAAO,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC"}