agent-bober 0.18.0 → 0.19.0

package/dist/medical/recommend/recommend.d.ts

@@ -0,0 +1,86 @@
+/**
+ * generateRecommendation — recommendation generation end-to-end.
+ *
+ * Wires the sprint-2 judge loop into a real recommendation path:
+ *  1. Assemble profile context from FactStore + medical profile
+ *  2. Build four per-lens LLM clients (tier-diverse when cloud ON, all local when cloud OFF)
+ *  3. Generate a candidate + gate through runJudgeLoop
+ *  4. Emit a Finding:
+ *     - accepted   → kind="action" (LLM-assigned urgency/severity/confidence, NO refer-out hedging)
+ *     - rejected   → kind="question" flagged for review (per-lens dissent)
+ *     - short-circuit/refuse → canned escalation, NO finding
+ *  5. Append AuditLog entry (IDs/enums only — NonGoal #3)
+ *
+ * engine.ts is NO-TOUCH: patterns are COPIED (not imported) from engine.ts:250-410.
+ * runJudgeLoop is IMPORTED — do NOT re-implement (NonGoal #5).
+ *
+ * sc-3-5 (fail-closed model selection): when egress.isAllowed("cloud-inference") is FALSE,
+ * EVERY client (all four lenses + the generator) resolves via buildMedicalInferenceClient.
+ * deps.clientFactory is threaded through both paths so tests can spy without network.
+ */
+import type { BoberConfig } from "../../config/schema.js";
+import type { LLMClient } from "../../providers/types.js";
+import { EgressGuard } from "../egress.js";
+import type { GuardrailSet } from "../types.js";
+import type { ClientFactory } from "../inference.js";
+import { AuditLog } from "../audit.js";
+import type { FactStore } from "../../state/facts.js";
+import type { ProfileCipher } from "../profile.js";
+import { writeFinding } from "../analysis/finding-writer.js";
+import type { LensClients } from "./types.js";
+import type { UrgencyResult } from "./urgency.js";
+/** Discriminated outcome of generateRecommendation. */
+export type RecommendOutcomeKind = "accepted" | "question" | "escalated" | "refused";
+export interface RecommendOutcome {
+    kind: RecommendOutcomeKind;
+    /** Absolute path to the written Finding note (accepted + question paths). */
+    findingPath?: string;
+    /** Canned escalation response (escalated path). */
+    cannedResponse?: string;
+    /** Refusal reason (refused path). */
+    reason?: string;
+}
+/**
+ * Injectable dependencies for generateRecommendation.
+ * Production callers pass no deps. Tests inject everything to avoid real network/fs.
+ */
+export interface RecommendDeps {
+    /** Pre-built lens clients (tests inject fake ScriptedClients). */
+    lensClients?: LensClients;
+    /** Override the candidate generator (tests inject a deterministic fn). */
+    generateCandidate?: (prevFeedback?: string) => Promise<string>;
+    /** Override the guardrail set (tests inject shortCircuitGuard / allowGuard). */
+    redFlag?: GuardrailSet;
+    /** Override the urgency assigner (tests inject a fn returning fixed values). */
+    assignUrgency?: (llm: LLMClient, model: string, candidate: string, context: string) => Promise<UrgencyResult>;
+    /** Override writeFinding (tests inject a fn that writes to a temp vault). */
+    writeFindingFn?: typeof writeFinding;
+    /** Injected FactStore (tests pass :memory:; caller owns lifecycle). */
+    facts?: FactStore;
+    /** Override the EgressGuard (tests inject a fixed allow/deny guard). */
+    egress?: EgressGuard;
+    /**
+     * Injectable ClientFactory for cloud-OFF spy test (sc-3-5).
+     * Threaded into BOTH buildMedicalInferenceClient AND the tier createClient calls
+     * so tests can assert no cloud provider was constructed.
+     */
+    clientFactory?: ClientFactory;
+    /** Override the AuditLog (tests inject a no-op or in-memory log). */
+    auditLog?: AuditLog;
+    /** Override ProfileCipher (tests inject a reversible fake). */
+    profileCipher?: ProfileCipher;
+}
+/**
+ * Run the recommendation pipeline end-to-end.
+ *
+ * @param projectRoot  Absolute project root path
+ * @param config       Loaded BoberConfig
+ * @param opts         { question, goal?, now } — clock is read ONLY at the CLI boundary
+ * @param deps         Optional injectable dependencies for tests
+ */
+export declare function generateRecommendation(projectRoot: string, config: BoberConfig, opts: {
+    question: string;
+    goal?: string;
+    now: string;
+}, deps?: RecommendDeps): Promise<RecommendOutcome>;
+//# sourceMappingURL=recommend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recommend.d.ts","sourceRoot":"","sources":["../../../src/medical/recommend/recommend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AAG5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,uDAAuD;AACvD,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAErF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D,gFAAgF;IAChF,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,gFAAgF;IAChF,aAAa,CAAC,EAAE,CACd,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5B,6EAA6E;IAC7E,cAAc,CAAC,EAAE,OAAO,YAAY,CAAC;IACrC,uEAAuE;IACvE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,wEAAwE;IACxE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAID;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACtD,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAoO3B"}

package/dist/medical/recommend/recommend.js

@@ -0,0 +1,211 @@
+/**
+ * generateRecommendation — recommendation generation end-to-end.
+ *
+ * Wires the sprint-2 judge loop into a real recommendation path:
+ *  1. Assemble profile context from FactStore + medical profile
+ *  2. Build four per-lens LLM clients (tier-diverse when cloud ON, all local when cloud OFF)
+ *  3. Generate a candidate + gate through runJudgeLoop
+ *  4. Emit a Finding:
+ *     - accepted   → kind="action" (LLM-assigned urgency/severity/confidence, NO refer-out hedging)
+ *     - rejected   → kind="question" flagged for review (per-lens dissent)
+ *     - short-circuit/refuse → canned escalation, NO finding
+ *  5. Append AuditLog entry (IDs/enums only — NonGoal #3)
+ *
+ * engine.ts is NO-TOUCH: patterns are COPIED (not imported) from engine.ts:250-410.
+ * runJudgeLoop is IMPORTED — do NOT re-implement (NonGoal #5).
+ *
+ * sc-3-5 (fail-closed model selection): when egress.isAllowed("cloud-inference") is FALSE,
+ * EVERY client (all four lenses + the generator) resolves via buildMedicalInferenceClient.
+ * deps.clientFactory is threaded through both paths so tests can spy without network.
+ */
+import { join } from "node:path";
+import { EgressGuard } from "../egress.js";
+import { MedicalGuardrails } from "../guardrails.js";
+import { buildMedicalInferenceClient } from "../inference.js";
+import { createClient } from "../../providers/factory.js";
+import { tierPolicy } from "../../fleet/tier-policy.js";
+import { AuditLog } from "../audit.js";
+import { findingId } from "../analysis/finding.js";
+import { writeFinding } from "../analysis/finding-writer.js";
+import { runJudgeLoop } from "./judge-panel.js";
+import { assembleRecommendationContext, contextToString } from "./context.js";
+import { assignUrgencySeverity } from "./urgency.js";
+// -- generateRecommendation ----------------------------------------------
+/**
+ * Run the recommendation pipeline end-to-end.
+ *
+ * @param projectRoot  Absolute project root path
+ * @param config       Loaded BoberConfig
+ * @param opts         { question, goal?, now } — clock is read ONLY at the CLI boundary
+ * @param deps         Optional injectable dependencies for tests
+ */
+export async function generateRecommendation(projectRoot, config, opts, deps = {}) {
+    const { question, goal, now } = opts;
+    // 1. Egress guard + factory
+    const egress = deps.egress ?? EgressGuard.fromConfig(config);
+    const factory = deps.clientFactory ?? createClient;
+    // 2. Vault dir for findings (mirrors review-pass.ts:51-52)
+    const vaultDir = config.medical?.vaultDir ?? join(projectRoot, ".bober", "medical", "vault");
+    // 3. Audit log
+    const auditLog = deps.auditLog ?? new AuditLog(projectRoot);
+    // 4. Red-flag guard
+    const redFlag = deps.redFlag ?? new MedicalGuardrails();
+    // 5. Build four lens clients + generator client
+    //    CRITICAL (sc-3-5): gate the ENTIRE tier branch behind isAllowed("cloud-inference").
+    //    When cloud is OFF, ALL four lenses + the generator resolve via buildMedicalInferenceClient
+    //    using the injected factory so tests can spy.
+    let lensClients;
+    let generatorSpec;
+    if (deps.lensClients !== undefined) {
+        // Test-injected lens clients; build a local generator unless generateCandidate is also injected
+        lensClients = deps.lensClients;
+        generatorSpec = buildMedicalInferenceClient(config, egress, factory);
+    }
+    else if (egress.isAllowed("cloud-inference")) {
+        // Cloud ON: use tier diversity (briefing §E)
+        // evidenceGrader → cheap (deepseek)
+        // contraindicationChecker → standard (grok)
+        // conservativeClinician → hard (sonnet)
+        // optimizationLens → frontier (opus)
+        // generator → hard (sonnet)
+        const cheapBlock = tierPolicy.resolveTier("cheap").generator; // openai-compat deepseek
+        const standardBlock = tierPolicy.resolveTier("standard").generator; // openai-compat grok
+        const hardBlock = tierPolicy.resolveTier("hard").generator; // anthropic sonnet
+        const frontierBlock = tierPolicy.resolveTier("frontier").generator; // anthropic opus
+        lensClients = {
+            evidenceGrader: {
+                client: factory(cheapBlock.provider, cheapBlock.endpoint ?? undefined, undefined, cheapBlock.model),
+                model: cheapBlock.model,
+            },
+            contraindicationChecker: {
+                client: factory(standardBlock.provider, standardBlock.endpoint ?? undefined, undefined, standardBlock.model),
+                model: standardBlock.model,
+            },
+            conservativeClinician: {
+                client: factory(hardBlock.provider, hardBlock.endpoint ?? undefined, undefined, hardBlock.model),
+                model: hardBlock.model,
+            },
+            optimizationLens: {
+                client: factory(frontierBlock.provider, frontierBlock.endpoint ?? undefined, undefined, frontierBlock.model),
+                model: frontierBlock.model,
+            },
+        };
+        generatorSpec = {
+            client: factory(hardBlock.provider, hardBlock.endpoint ?? undefined, undefined, hardBlock.model),
+            model: hardBlock.model,
+        };
+    }
+    else {
+        // Cloud OFF: ALL four lenses + generator resolve via buildMedicalInferenceClient (fail-closed)
+        // bober: all local when cloud-inference off; swap for per-lens routing if cloud is opt-in.
+        const localSpec = buildMedicalInferenceClient(config, egress, factory);
+        lensClients = {
+            evidenceGrader: localSpec,
+            contraindicationChecker: localSpec,
+            conservativeClinician: localSpec,
+            optimizationLens: localSpec,
+        };
+        generatorSpec = localSpec;
+    }
+    // 6. Assemble profile context
+    const ctx = await assembleRecommendationContext(projectRoot, config, { goal }, { facts: deps.facts, profileCipher: deps.profileCipher });
+    // runJudgeLoop.context is a STRING — must be serialized (judge-panel.ts:92)
+    const contextString = contextToString(ctx);
+    // 7. Build generateCandidate (or use injected one)
+    const generateCandidate = deps.generateCandidate ??
+        (async (prevFeedback) => {
+            const systemPrompt = `You are a medical advisor. Given a patient question and their profile context, ` +
+                `provide a clear and specific recommendation. Be direct and actionable.` +
+                (prevFeedback !== undefined ? `\n\nPanel feedback to incorporate:\n${prevFeedback}` : "");
+            const response = await generatorSpec.client.chat({
+                model: generatorSpec.model,
+                system: systemPrompt,
+                messages: [{ role: "user", content: `Question: ${question}\n\nContext:\n${contextString}` }],
+            });
+            return response.text;
+        });
+    // 8. Run judge loop (IMPORT — do NOT re-implement)
+    const panelOutcome = await runJudgeLoop({
+        question,
+        generateCandidate,
+        lensClients,
+        context: contextString,
+        redFlag,
+        now,
+    });
+    // 9. Handle outcome — switch on outcome.outcome (types.ts:84-133)
+    if (panelOutcome.outcome === "short-circuit") {
+        // Red-flag matched: canned escalation, NO finding, short-circuit audit entry
+        // Pattern from engine.ts:250-289 (copied, not imported)
+        await auditLog.append({
+            tIso: now,
+            event: "short-circuit",
+            ruleId: panelOutcome.rule,
+            rulesetVersion: redFlag.rulesetVersion,
+        });
+        return { kind: "escalated", cannedResponse: panelOutcome.cannedResponse };
+    }
+    if (panelOutcome.outcome === "refuse") {
+        // Content-policy refusal: NO finding
+        await auditLog.append({
+            tIso: now,
+            event: "refuse",
+            ruleId: panelOutcome.rule,
+            rulesetVersion: redFlag.rulesetVersion,
+        });
+        return { kind: "refused", reason: panelOutcome.reason };
+    }
+    if (panelOutcome.outcome === "accepted") {
+        // Accepted: assign urgency/severity, write kind="action" Finding
+        const urgencyFn = deps.assignUrgency ?? assignUrgencySeverity;
+        const { urgency, severity, confidence } = await urgencyFn(generatorSpec.client, generatorSpec.model, panelOutcome.recommendation, contextString);
+        // id is deterministic — re-runs with the same question overwrite the same file (sc-1-4 pattern)
+        const id = findingId("medical", question, "recommend-action");
+        const finding = {
+            id,
+            domain: "medical",
+            // sc-3-2: title states the recommendation DIRECTLY — NO refer-out hedging
+            title: panelOutcome.recommendation.slice(0, 120).trimEnd(),
+            kind: "action",
+            urgency,
+            severity,
+            // evidence contains the full recommendation text (direct; no hedging added)
+            evidence: [panelOutcome.recommendation],
+            surfacedAt: now,
+            // sc-3-6: confidence recorded in tags (confidence:X.XX)
+            tags: [`confidence:${confidence.toFixed(2)}`],
+            status: "open",
+        };
+        const writeFindingFn = deps.writeFindingFn ?? writeFinding;
+        const findingPath = await writeFindingFn(vaultDir, finding);
+        // IDs/enums only (NonGoal #3) — no recommendation text, no health values
+        await auditLog.append({ tIso: now, event: "answer" });
+        return { kind: "accepted", findingPath };
+    }
+    // outcome === "rejected" (no-consensus or contraindication-veto)
+    // Write kind="question" Finding with per-lens dissent; NO kind="action" finding (sc-3-3)
+    const dissentLines = Object.entries(panelOutcome.dissent)
+        .filter(([, text]) => text.length > 0)
+        .map(([lens, text]) => `[${lens}] ${text}`);
+    const id = findingId("medical", question, "recommend-question");
+    const finding = {
+        id,
+        domain: "medical",
+        // sc-3-3: title must contain "flagged for your review" (lowercase per contract criterion)
+        title: `flagged for your review — panel disagreed on: ${question.slice(0, 80).trimEnd()}`,
+        kind: "question",
+        urgency: 2,
+        severity: 2,
+        // evidence = per-lens dissent strings (sc-3-3)
+        evidence: dissentLines.length > 0 ? dissentLines : ["Panel could not reach consensus"],
+        surfacedAt: now,
+        tags: ["no-consensus"],
+        status: "open",
+    };
+    const writeFindingFn = deps.writeFindingFn ?? writeFinding;
+    const findingPath = await writeFindingFn(vaultDir, finding);
+    // IDs/enums only — no recommendation text, no health values
+    await auditLog.append({ tIso: now, event: "abstain" });
+    return { kind: "question", findingPath };
+}
+//# sourceMappingURL=recommend.js.map

package/dist/medical/recommend/recommend.js.map

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

package/dist/medical/recommend/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Recommendation judge-panel shared types.
+ *
+ * PURE orchestration over injected fns — NO fs / NO network / NO real provider / NO FactStore.
+ * All execution logic lives in lenses.ts and judge-panel.ts.
+ */
+import type { LLMClient } from "../../providers/types.js";
+/** Number of parse-retry attempts per lens call (mirrors GROUNDING_PARSE_MAX_RETRIES). */
+export declare const LENS_PARSE_MAX_RETRIES = 1;
+/** Total LLM calls per lens per round: 1 initial + parse retries (mirrors GROUNDING_MAX_LLM_CALLS). */
+export declare const LENS_MAX_LLM_CALLS: number;
+/** Default maximum judge rounds before fail-closed (research §4a:192). */
+export declare const MEDICAL_PANEL_MAX_ROUNDS = 3;
+/**
+ * Worst-case LLM call budget for the full judge loop.
+ * Per round = 1 generateCandidate + 4 lenses × LENS_MAX_LLM_CALLS.
+ * Total = MEDICAL_PANEL_MAX_ROUNDS × (1 + 4 × LENS_MAX_LLM_CALLS) = 3 × 9 = 27.
+ */
+export declare const MEDICAL_PANEL_MAX_TOTAL_CALLS: number;
+/**
+ * Four lens names (research §4a:186-191).
+ * Only contraindication-checker may carry a veto.
+ */
+export type LensName = "evidence-grader" | "contraindication-checker" | "conservative-clinician" | "optimization-lens";
+/**
+ * Verdict returned by each lens.
+ * Only the contraindication-checker populates veto; other lenses always have veto===false.
+ */
+export interface LensVerdict {
+    verdict: "approve" | "reject";
+    feedback: string;
+    /** True only when contraindication-checker finds an absolute contraindication. */
+    veto?: boolean;
+}
+/** An injected LLM client + model identifier for a single lens. */
+export interface LensSpec {
+    client: LLMClient;
+    model: string;
+}
+/** One LensSpec per lens — each may use a different model (sprint 3 wires tier-policy). */
+export interface LensClients {
+    evidenceGrader: LensSpec;
+    contraindicationChecker: LensSpec;
+    conservativeClinician: LensSpec;
+    optimizationLens: LensSpec;
+}
+/** Internal reconciliation outcome; not exported as part of the public API. */
+export interface PanelDecision {
+    accepted: boolean;
+    /** Present only when accepted is false. */
+    reason?: "contraindication-veto" | "no-consensus";
+}
+/**
+ * Accepted recommendation: all four lenses approved (strict majority) and no veto was present.
+ */
+export interface AcceptedOutcome {
+    outcome: "accepted";
+    accepted: true;
+    /** The raw candidate returned by generateCandidate — NOT a Finding (sprint 3 emits Findings). */
+    recommendation: string;
+    /** Per-lens verdict map for the winning round. */
+    verdicts: Record<LensName, LensVerdict>;
+    /** Round number in which consensus was reached (1-indexed). */
+    rounds: number;
+}
+/**
+ * Rejected after maxRounds — no consensus was reached.
+ */
+export interface RejectedOutcome {
+    outcome: "rejected";
+    accepted: false;
+    reason: "contraindication-veto" | "no-consensus";
+    /** Per-lens feedback strings collected on the final round. */
+    dissent: Record<LensName, string>;
+    /** Per-lens verdict map from the final round. */
+    verdicts: Record<LensName, LensVerdict>;
+    /** Number of rounds executed before giving up. */
+    rounds: number;
+}
+/**
+ * Guard short-circuited the loop — red-flag matched, emergency escalation required.
+ */
+export interface ShortCircuitOutcome {
+    outcome: "short-circuit";
+    rule: string;
+    cannedResponse: string;
+}
+/**
+ * Guard refused the request — policy-based refusal (not an emergency).
+ */
+export interface RefuseOutcome {
+    outcome: "refuse";
+    rule: string;
+    reason: string;
+}
+/** Discriminated union of all possible outcomes from runJudgeLoop. */
+export type PanelOutcome = AcceptedOutcome | RejectedOutcome | ShortCircuitOutcome | RefuseOutcome;
+//# sourceMappingURL=types.d.ts.map

package/dist/medical/recommend/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/medical/recommend/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAI1D,0FAA0F;AAC1F,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,uGAAuG;AACvG,eAAO,MAAM,kBAAkB,QAA6B,CAAC;AAE7D,0EAA0E;AAC1E,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,QACe,CAAC;AAI1D;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAChB,iBAAiB,GACjB,0BAA0B,GAC1B,wBAAwB,GACxB,mBAAmB,CAAC;AAIxB;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2FAA2F;AAC3F,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,QAAQ,CAAC;IACzB,uBAAuB,EAAE,QAAQ,CAAC;IAClC,qBAAqB,EAAE,QAAQ,CAAC;IAChC,gBAAgB,EAAE,QAAQ,CAAC;CAC5B;AAID,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,uBAAuB,GAAG,cAAc,CAAC;CACnD;AAID;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,IAAI,CAAC;IACf,iGAAiG;IACjG,cAAc,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACxC,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC;IAChB,MAAM,EAAE,uBAAuB,GAAG,cAAc,CAAC;IACjD,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClC,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACxC,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sEAAsE;AACtE,MAAM,MAAM,YAAY,GACpB,eAAe,GACf,eAAe,GACf,mBAAmB,GACnB,aAAa,CAAC"}

package/dist/medical/recommend/types.js

@@ -0,0 +1,20 @@
+/**
+ * Recommendation judge-panel shared types.
+ *
+ * PURE orchestration over injected fns — NO fs / NO network / NO real provider / NO FactStore.
+ * All execution logic lives in lenses.ts and judge-panel.ts.
+ */
+// ── Budget constants ──────────────────────────────────────────────────
+/** Number of parse-retry attempts per lens call (mirrors GROUNDING_PARSE_MAX_RETRIES). */
+export const LENS_PARSE_MAX_RETRIES = 1;
+/** Total LLM calls per lens per round: 1 initial + parse retries (mirrors GROUNDING_MAX_LLM_CALLS). */
+export const LENS_MAX_LLM_CALLS = 1 + LENS_PARSE_MAX_RETRIES; // = 2
+/** Default maximum judge rounds before fail-closed (research §4a:192). */
+export const MEDICAL_PANEL_MAX_ROUNDS = 3;
+/**
+ * Worst-case LLM call budget for the full judge loop.
+ * Per round = 1 generateCandidate + 4 lenses × LENS_MAX_LLM_CALLS.
+ * Total = MEDICAL_PANEL_MAX_ROUNDS × (1 + 4 × LENS_MAX_LLM_CALLS) = 3 × 9 = 27.
+ */
+export const MEDICAL_PANEL_MAX_TOTAL_CALLS = MEDICAL_PANEL_MAX_ROUNDS * (1 + 4 * LENS_MAX_LLM_CALLS); // = 27
+//# sourceMappingURL=types.js.map

package/dist/medical/recommend/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/medical/recommend/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,yEAAyE;AAEzE,0FAA0F;AAC1F,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC,uGAAuG;AACvG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAG,sBAAsB,CAAC,CAAC,MAAM;AAEpE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,wBAAwB,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,OAAO"}

package/dist/medical/recommend/urgency.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Urgency/severity/confidence assigner — one bounded LLM call with a NEVER-throwing validator.
+ *
+ * PURE: NO fs / NO FactStore / NO network beyond the injected LLMClient.
+ * All timestamps are injected; wall clock is read ONLY at the CLI boundary.
+ *
+ * By design OUTSIDE the ADR-3 deterministic-numerics boundary:
+ * urgency/severity/confidence are INTERPRETATION, not arithmetic (contract assumption 3).
+ *
+ * Most similar: src/medical/recommend/lenses.ts:65-113 (validateLensVerdict pattern).
+ */
+import type { LLMClient } from "../../providers/types.js";
+export interface UrgencyResult {
+    /** Urgency level 1..5 (5 = most urgent). */
+    urgency: number;
+    /** Severity level 1..5 (5 = most severe). */
+    severity: number;
+    /** Confidence in the assessment (0..1). */
+    confidence: number;
+}
+/**
+ * Assign urgency, severity, and confidence via ONE bounded LLM call.
+ * NEVER throws — returns DEFAULT_URGENCY on any error or parse failure.
+ */
+export declare function assignUrgencySeverity(llm: LLMClient, model: string, candidate: string, context: string): Promise<UrgencyResult>;
+//# sourceMappingURL=urgency.d.ts.map

package/dist/medical/recommend/urgency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urgency.d.ts","sourceRoot":"","sources":["../../../src/medical/recommend/urgency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAgB1D,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAwFD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,CAqBxB"}

package/dist/medical/recommend/urgency.js

@@ -0,0 +1,124 @@
+/**
+ * Urgency/severity/confidence assigner — one bounded LLM call with a NEVER-throwing validator.
+ *
+ * PURE: NO fs / NO FactStore / NO network beyond the injected LLMClient.
+ * All timestamps are injected; wall clock is read ONLY at the CLI boundary.
+ *
+ * By design OUTSIDE the ADR-3 deterministic-numerics boundary:
+ * urgency/severity/confidence are INTERPRETATION, not arithmetic (contract assumption 3).
+ *
+ * Most similar: src/medical/recommend/lenses.ts:65-113 (validateLensVerdict pattern).
+ */
+import { z } from "zod";
+// -- Schema --------------------------------------------------------------
+/**
+ * Raw schema for the urgency response.
+ * Values are parsed as raw numbers; clamping is applied after validation.
+ */
+const UrgencyResponseSchema = z.object({
+    urgency: z.number(),
+    severity: z.number(),
+    confidence: z.number(),
+});
+// -- Conservative defaults -----------------------------------------------
+/**
+ * Conservative default returned on parse failure — never throws.
+ * Represents moderate urgency/severity; confidence reflects uncertainty.
+ */
+const DEFAULT_URGENCY = { urgency: 3, severity: 3, confidence: 0.5 };
+// -- Clamp helper --------------------------------------------------------
+/** Clamp a number to the integer range [1, 5]. */
+function clampInt(n) {
+    return Math.min(5, Math.max(1, Math.round(n)));
+}
+// -- validateUrgencyResponse (NEVER throws) ------------------------------
+/**
+ * Four-tier JSON extraction strategy — mirrors validateLensVerdict (lenses.ts:65-113).
+ * Returns null on any failure so the caller can fall back to DEFAULT_URGENCY.
+ */
+function validateUrgencyResponse(rawText) {
+    let parsed;
+    // Tier 1: direct parse
+    try {
+        parsed = JSON.parse(rawText.trim());
+    }
+    catch {
+        // Tier 2: fenced JSON block
+        const fenceMatch = /```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/.exec(rawText);
+        if (fenceMatch) {
+            try {
+                parsed = JSON.parse(fenceMatch[1].trim());
+            }
+            catch {
+                // Fall through to tier 3
+            }
+        }
+        // Tier 3: first { ... } block
+        if (!parsed) {
+            const braceStart = rawText.indexOf("{");
+            const braceEnd = rawText.lastIndexOf("}");
+            if (braceStart !== -1 && braceEnd > braceStart) {
+                try {
+                    parsed = JSON.parse(rawText.slice(braceStart, braceEnd + 1));
+                }
+                catch {
+                    // Tier 4: fail
+                    return null;
+                }
+            }
+            else {
+                return null;
+            }
+        }
+    }
+    const result = UrgencyResponseSchema.safeParse(parsed);
+    if (!result.success) {
+        return null;
+    }
+    return {
+        urgency: clampInt(result.data.urgency),
+        severity: clampInt(result.data.severity),
+        confidence: result.data.confidence,
+    };
+}
+// -- System prompt -------------------------------------------------------
+const URGENCY_SYSTEM_PROMPT = `You are a medical urgency assessor. Given a candidate recommendation and patient context, assess the urgency, severity, and your confidence in the assessment.
+
+Output ONLY a JSON object with EXACTLY this shape:
+{
+  "urgency": <integer 1..5>,
+  "severity": <integer 1..5>,
+  "confidence": <float 0..1>
+}
+
+Rules:
+- urgency: how soon action is needed (1=routine/months, 5=immediate/today)
+- severity: impact on health if not addressed (1=minimal, 5=critical)
+- confidence: your confidence in this assessment (0=uncertain, 1=certain)
+- Output the JSON object and nothing else.`;
+// -- assignUrgencySeverity -----------------------------------------------
+/**
+ * Assign urgency, severity, and confidence via ONE bounded LLM call.
+ * NEVER throws — returns DEFAULT_URGENCY on any error or parse failure.
+ */
+export async function assignUrgencySeverity(llm, model, candidate, context) {
+    const userContent = `Candidate recommendation:\n${candidate}\n\nPatient context:\n${context}`;
+    let rawText;
+    try {
+        const response = await llm.chat({
+            model,
+            system: URGENCY_SYSTEM_PROMPT,
+            messages: [{ role: "user", content: userContent }],
+            jsonObjectMode: true,
+        });
+        rawText = response.text;
+    }
+    catch {
+        // Transport failure — conservative default
+        return DEFAULT_URGENCY;
+    }
+    const result = validateUrgencyResponse(rawText);
+    // bober: fall back to DEFAULT_URGENCY on parse failure; intentional conservative default.
+    return result ?? DEFAULT_URGENCY;
+}
+//# sourceMappingURL=urgency.js.map

package/dist/medical/recommend/urgency.js.map

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