agent-bober 0.17.1 → 0.19.0

package/dist/hub/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/hub/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,yEAAyE;AAEzE,MAAM,gBAAgB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACpD,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IACxC,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;KACpB,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QAC1C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC3B,CAAC;CACH,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IACvC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC;AAED,yEAAyE;AAEzE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,QAAmB,EAAE,KAAY,EAAE,GAAS;IACtE,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,QAAQ,CAAC;IAE/C,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IAE7C,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3B,4DAA4D;QAC5D,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QAE9D,iEAAiE;QACjE,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAE7D,iFAAiF;QACjF,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,CAAC,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC,CAAC,4CAA4C;YACxE,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAC/E,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE;gBAAE,OAAO,KAAK,CAAC;QAC7D,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/hub/task-inbox.d.ts

@@ -0,0 +1,16 @@
+import type { Finding } from "./finding.js";
+import type { FactStore } from "../state/facts.js";
+/**
+ * Build a Finding from free text and persist it to the hub pool.
+ *
+ * Deterministic enrichment only: id is derived from title+now (no clock
+ * call here — `now` is always injected at the CLI boundary). All unknown
+ * fields are omitted; urgency/severity are set to safe neutral defaults.
+ *
+ * PURE: never calls Date.now() / new Date().
+ */
+export declare function captureTask(store: FactStore, text: string, { domain, now }: {
+    domain?: string;
+    now: string;
+}): Promise<Finding>;
+//# sourceMappingURL=task-inbox.d.ts.map

package/dist/hub/task-inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-inbox.d.ts","sourceRoot":"","sources":["../../src/hub/task-inbox.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAUnD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,EACZ,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,OAAO,CAAC,CAwBlB"}

package/dist/hub/task-inbox.js

@@ -0,0 +1,39 @@
+import { createHash } from "node:crypto";
+import { writeFinding } from "./finding-store.js";
+// ── Constants ─────────────────────────────────────────────────────────
+/** Fallback domain when none is provided — required min(1) on FindingSchema. */
+const DEFAULT_DOMAIN = "inbox";
+// ── captureTask ───────────────────────────────────────────────────────
+/**
+ * Build a Finding from free text and persist it to the hub pool.
+ *
+ * Deterministic enrichment only: id is derived from title+now (no clock
+ * call here — `now` is always injected at the CLI boundary). All unknown
+ * fields are omitted; urgency/severity are set to safe neutral defaults.
+ *
+ * PURE: never calls Date.now() / new Date().
+ */
+export async function captureTask(store, text, { domain, now }) {
+    const title = text.trim();
+    // Stable deterministic id — no clock dependency
+    const id = createHash("sha256")
+        .update(`${title}|${now}`)
+        .digest("hex")
+        .slice(0, 16);
+    const finding = {
+        id,
+        domain: domain ?? DEFAULT_DOMAIN, // REQUIRED min(1) — cannot be empty
+        title,
+        kind: "action",
+        urgency: 3, // neutral default (contract assumption §3a)
+        severity: 1, // neutral default
+        evidence: [],
+        surfacedAt: now,
+        tags: domain ? [`domain:${domain}`] : [],
+        status: "open",
+        // dueBy / estDurationMin / calendarSafeTitle / promotesTo: OMITTED (optional)
+    };
+    await writeFinding(store, finding, { now });
+    return finding;
+}
+//# sourceMappingURL=task-inbox.js.map

package/dist/hub/task-inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-inbox.js","sourceRoot":"","sources":["../../src/hub/task-inbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,yEAAyE;AAEzE,gFAAgF;AAChF,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,yEAAyE;AAEzE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAgB,EAChB,IAAY,EACZ,EAAE,MAAM,EAAE,GAAG,EAAoC;IAEjD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,gDAAgD;IAChD,MAAM,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC;SAC5B,MAAM,CAAC,GAAG,KAAK,IAAI,GAAG,EAAE,CAAC;SACzB,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhB,MAAM,OAAO,GAAY;QACvB,EAAE;QACF,MAAM,EAAE,MAAM,IAAI,cAAc,EAAE,oCAAoC;QACtE,KAAK;QACL,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC,EAAE,4CAA4C;QACxD,QAAQ,EAAE,CAAC,EAAE,kBAAkB;QAC/B,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,GAAG;QACf,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;QACxC,MAAM,EAAE,MAAM;QACd,8EAA8E;KAC/E,CAAC;IAEF,MAAM,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/incident/resolution-verify.d.ts

@@ -70,18 +70,18 @@ export declare const VerifyResultSchema: z.ZodObject<{
     hint: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     verified: boolean;
-    reason?: "OK" | "OUTLIER" | "NO_PROVIDER" | "NOT_IMPLEMENTED" | "MCP_ERROR" | undefined;
     hint?: string | undefined;
     observedValue?: number | undefined;
     sampledAt?: string | undefined;
     evidencePath?: string | undefined;
+    reason?: "OK" | "OUTLIER" | "NO_PROVIDER" | "NOT_IMPLEMENTED" | "MCP_ERROR" | undefined;
 }, {
     verified: boolean;
-    reason?: "OK" | "OUTLIER" | "NO_PROVIDER" | "NOT_IMPLEMENTED" | "MCP_ERROR" | undefined;
     hint?: string | undefined;
     observedValue?: number | undefined;
     sampledAt?: string | undefined;
     evidencePath?: string | undefined;
+    reason?: "OK" | "OUTLIER" | "NO_PROVIDER" | "NOT_IMPLEMENTED" | "MCP_ERROR" | undefined;
 }>;
 export type VerifyResult = z.infer<typeof VerifyResultSchema>;
 export declare const ResolutionEvidenceSchema: z.ZodObject<{

package/dist/incident/types.d.ts

@@ -26,14 +26,14 @@ export declare const TimelineEventSchema: z.ZodObject<{
     /** Optional relative path to the detail artifact (e.g. actions.jsonl). */
     refPath: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    timestamp: string;
     summary: string;
+    timestamp: string;
     source: "observability" | "human" | "diagnoser" | "deployer" | "system";
     eventKind: string;
     refPath?: string | undefined;
 }, {
-    timestamp: string;
     summary: string;
+    timestamp: string;
     source: "observability" | "human" | "diagnoser" | "deployer" | "system";
     eventKind: string;
     refPath?: string | undefined;
@@ -48,14 +48,14 @@ export declare const ObservationEntrySchema: z.ZodObject<{
     verified: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
     timestamp: string;
-    verified: boolean;
     phase: number;
+    verified: boolean;
     source: string;
     observation: string;
 }, {
     timestamp: string;
-    verified: boolean;
     phase: number;
+    verified: boolean;
     source: string;
     observation: string;
 }>;
@@ -257,12 +257,12 @@ export declare const IncidentMetadataSchema: z.ZodObject<{
     }>>;
     postmortemPath: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    status: "aborted" | "investigating" | "remediating" | "monitoring" | "resolved";
     createdAt: string;
+    status: "aborted" | "investigating" | "remediating" | "monitoring" | "resolved";
     incidentId: string;
     symptom: string;
-    resolvedAt?: string | undefined;
     severity?: "S1" | "S2" | "S3" | "S4" | undefined;
+    resolvedAt?: string | undefined;
     resolutionCriteria?: string | undefined;
     resolutionEvidence?: {
         verified: boolean;
@@ -278,12 +278,12 @@ export declare const IncidentMetadataSchema: z.ZodObject<{
     } | undefined;
     postmortemPath?: string | undefined;
 }, {
-    status: "aborted" | "investigating" | "remediating" | "monitoring" | "resolved";
     createdAt: string;
+    status: "aborted" | "investigating" | "remediating" | "monitoring" | "resolved";
     incidentId: string;
     symptom: string;
-    resolvedAt?: string | undefined;
     severity?: "S1" | "S2" | "S3" | "S4" | undefined;
+    resolvedAt?: string | undefined;
     resolutionCriteria?: string | undefined;
     resolutionEvidence?: {
         verified: boolean;

package/dist/index.d.ts

@@ -13,7 +13,8 @@ export { runPipeline, type PipelineResult, } from "./orchestrator/pipeline.js";
 export { resolveModel } from "./orchestrator/model-resolver.js";
 export { loadAgentDefinition, clearAgentCache, type AgentDefinition, } from "./orchestrator/agent-loader.js";
 export { buildToolSet, resolveRoleTools, getGraphState, getGraphDeps, ROLE_TOOLS, type ToolSet, type AgentRole, type GraphState, } from "./orchestrator/tools/index.js";
-export { runAgenticLoop, type AgenticLoopParams, type AgenticLoopResult, } from "./orchestrator/agentic-loop.js";
+export { runAgenticLoop, resumeSession, forkSession, type AgenticLoopParams, type AgenticLoopResult, } from "./orchestrator/agentic-loop.js";
+export { SessionStore, type SessionRecord, } from "./orchestrator/session-store.js";
 export { EvaluatorRegistry, createDefaultRegistry, runEvaluation, type EvaluationRunResult, } from "./evaluators/registry.js";
 export type { EvaluatorPlugin, EvaluatorFactory, EvalContext, } from "./evaluators/plugin-interface.js";
 export { ensureBoberDir, saveContract, loadContract, listContracts, updateContract, saveSpec, loadSpec, loadLatestSpec, listSpecs, appendHistory, loadHistory, saveBriefing, readBriefing, listBriefings, } from "./state/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAInE,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,gCAAgC,EAChC,6BAA6B,EAC7B,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,yBAAyB,EACzB,UAAU,EACV,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,IAAI,wBAAwB,EACjD,gBAAgB,EAChB,cAAc,GACf,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,OAAO,EACL,YAAY,EACZ,KAAK,eAAe,GACrB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,OAAO,EACL,UAAU,EACV,KAAK,cAAc,GACpB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,WAAW,EACX,KAAK,cAAc,GACpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,gCAAgC,CAAC;AAIxC,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,KAAK,mBAAmB,GACzB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,WAAW,GACZ,MAAM,kCAAkC,CAAC;AAI1C,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,EACT,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,kBAAkB,CAAC;AAI1B,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,EACP,UAAU,EACV,YAAY,EACZ,UAAU,EACV,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAIzF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAIlD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -16,7 +16,8 @@ export { runPipeline, } from "./orchestrator/pipeline.js";
 export { resolveModel } from "./orchestrator/model-resolver.js";
 export { loadAgentDefinition, clearAgentCache, } from "./orchestrator/agent-loader.js";
 export { buildToolSet, resolveRoleTools, getGraphState, getGraphDeps, ROLE_TOOLS, } from "./orchestrator/tools/index.js";
-export { runAgenticLoop, } from "./orchestrator/agentic-loop.js";
+export { runAgenticLoop, resumeSession, forkSession, } from "./orchestrator/agentic-loop.js";
+export { SessionStore, } from "./orchestrator/session-store.js";
 // ── Evaluators ─────────────────────────────────────────────────────
 export { EvaluatorRegistry, createDefaultRegistry, runEvaluation, } from "./evaluators/registry.js";
 // ── State ──────────────────────────────────────────────────────────

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAOL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEnE,sEAAsE;AAEtE,OAAO,EAOL,gCAAgC,EAChC,6BAA6B,EAC7B,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAYL,yBAAyB,EACzB,UAAU,EACV,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAOL,gBAAgB,EAChB,cAAc,GACf,MAAM,4BAA4B,CAAC;AAEpC,sEAAsE;AAEtE,OAAO,EAIL,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,OAAO,EACL,YAAY,GAEb,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,OAAO,EACL,UAAU,GAEX,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,WAAW,GAEZ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,OAAO,EACL,mBAAmB,EACnB,eAAe,GAEhB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,UAAU,GAIX,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,cAAc,GAGf,MAAM,gCAAgC,CAAC;AAExC,sEAAsE;AAEtE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GAEd,MAAM,0BAA0B,CAAC;AAQlC,sEAAsE;AAEtE,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,EACT,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,kBAAkB,CAAC;AAoB1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAqB,MAAM,wBAAwB,CAAC;AAEzF,sEAAsE;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,uEAAuE;AAEvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,wEAAwE;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAOL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEnE,sEAAsE;AAEtE,OAAO,EAOL,gCAAgC,EAChC,6BAA6B,EAC7B,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAYL,yBAAyB,EACzB,UAAU,EACV,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAOL,gBAAgB,EAChB,cAAc,GACf,MAAM,4BAA4B,CAAC;AAEpC,sEAAsE;AAEtE,OAAO,EAIL,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,OAAO,EACL,YAAY,GAEb,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,OAAO,EACL,UAAU,GAEX,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,WAAW,GAEZ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,OAAO,EACL,mBAAmB,EACnB,eAAe,GAEhB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,UAAU,GAIX,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,cAAc,EACd,aAAa,EACb,WAAW,GAGZ,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,YAAY,GAEb,MAAM,iCAAiC,CAAC;AAEzC,sEAAsE;AAEtE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GAEd,MAAM,0BAA0B,CAAC;AAQlC,sEAAsE;AAEtE,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,EACT,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,kBAAkB,CAAC;AAoB1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAqB,MAAM,wBAAwB,CAAC;AAEzF,sEAAsE;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,uEAAuE;AAEvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,wEAAwE;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/mcp/run-manager.d.ts

@@ -15,7 +15,7 @@ export interface RunResult {
 export interface RunState {
     runId: string;
     task: string;
-    status: "running" | "completed" | "failed" | "aborted";
+    status: "running" | "completed" | "failed" | "aborted" | "input-required" | "paused";
     startedAt: string;
     completedAt?: string;
     abortedAt?: string;
@@ -32,6 +32,14 @@ export interface RunState {
     /** Sprint 4: the git branch the worktree was created on. Undefined for
      *  in-place runs. */
     branch?: string;
+    /** Checkpoint id the run is paused at, awaiting human input. */
+    pendingCheckpointId?: string;
+    /** Human-readable prompt surfaced for the pending checkpoint. */
+    pendingPrompt?: string;
+    /** ISO timestamp the run entered 'input-required'. */
+    pendingSince?: string;
+    /** ISO timestamp the run was soft-paused. */
+    pausedAt?: string;
 }
 /**
  * Optional parameters for startRun().

package/dist/mcp/run-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-manager.d.ts","sourceRoot":"","sources":["../../src/mcp/run-manager.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAMlE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;8CAE0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;yBACqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAA+B;IAE3C;;;;;OAKG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;;OAMG;IACH,SAAS,IAAI,QAAQ,GAAG,IAAI;IAW5B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAItC;;OAEG;IACH,cAAc,IAAI,QAAQ,EAAE;IAI5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAe7C;;;OAGG;IACH,WAAW,IAAI,QAAQ,EAAE;IAIzB;;;;;;;;;;;;;;OAcG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,UAAU,GAAE,CACV,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,cAAc,CAAe,EAC1C,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,MAAM,CAAC;IAmElB;;;;;;;;;OASG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAoB/C;AAID,eAAO,MAAM,UAAU,YAAmB,CAAC"}
+{"version":3,"file":"run-manager.d.ts","sourceRoot":"","sources":["../../src/mcp/run-manager.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAMlE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,gBAAgB,GAAG,QAAQ,CAAC;IACrF,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;8CAE0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;yBACqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAA+B;IAE3C;;;;;OAKG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;;OAMG;IACH,SAAS,IAAI,QAAQ,GAAG,IAAI;IAW5B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAItC;;OAEG;IACH,cAAc,IAAI,QAAQ,EAAE;IAI5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAe7C;;;OAGG;IACH,WAAW,IAAI,QAAQ,EAAE;IAIzB;;;;;;;;;;;;;;OAcG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,UAAU,GAAE,CACV,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,cAAc,CAAe,EAC1C,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,MAAM,CAAC;IAmElB;;;;;;;;;OASG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAoB/C;AAID,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/mcp/run-manager.js.map

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

package/dist/medical/adapters/apple-health.d.ts

@@ -0,0 +1,32 @@
+import type { IngestionAdapter, IngestionResult, ObservationSink } from "../types.js";
+/**
+ * Streams Apple Health export XML via SAX with bounded (~1000-row) batches.
+ *
+ * Backpressure mechanism:
+ *   The stream is opened in paused (non-flowing) mode.
+ *   We drive it as an async iterator, reading one chunk at a time.
+ *   When the observation buffer reaches BATCH_CAP, we await sink.writeBatch
+ *   before continuing to iterate — preventing unbounded accumulation.
+ *
+ * NEVER calls readFile/readFileSync on the whole file — createReadStream only.
+ *
+ * bober: single .xml extension check; extend canHandle to sniff "HealthData"
+ *        root if the registry ever needs to distinguish multiple XML formats.
+ */
+export declare class AppleHealthAdapter implements IngestionAdapter {
+    readonly kind = "apple-health";
+    /**
+     * Returns true for .xml files (cheap extension check — no full read).
+     */
+    canHandle(filePath: string): boolean;
+    /**
+     * Stream-parse the Apple Health export XML file.
+     *
+     * Uses createReadStream as an async iterable to pull one chunk at a time.
+     * Feeds chunks to a strict SAX parser (synchronous per chunk).
+     * Flushes the observation buffer to the sink when it reaches BATCH_CAP,
+     * awaiting the write before pulling the next chunk (backpressure).
+     */
+    ingest(filePath: string, sink: ObservationSink): Promise<IngestionResult>;
+}
+//# sourceMappingURL=apple-health.d.ts.map

package/dist/medical/adapters/apple-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-health.d.ts","sourceRoot":"","sources":["../../../src/medical/adapters/apple-health.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,gBAAgB,EAChB,eAAe,EACf,eAAe,EAChB,MAAM,aAAa,CAAC;AAKrB;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,QAAQ,CAAC,IAAI,kBAAkB;IAE/B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;;;;OAOG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;CAwEhF"}

package/dist/medical/adapters/apple-health.js

@@ -0,0 +1,100 @@
+/** AppleHealthAdapter — SAX streaming import of Apple Health export.xml (Phase 6, Sprint 5). */
+import { createReadStream } from "node:fs";
+import sax from "sax";
+/** Maximum observations to buffer before awaiting a sink write (backpressure cap). */
+const BATCH_CAP = 1000;
+/**
+ * Streams Apple Health export XML via SAX with bounded (~1000-row) batches.
+ *
+ * Backpressure mechanism:
+ *   The stream is opened in paused (non-flowing) mode.
+ *   We drive it as an async iterator, reading one chunk at a time.
+ *   When the observation buffer reaches BATCH_CAP, we await sink.writeBatch
+ *   before continuing to iterate — preventing unbounded accumulation.
+ *
+ * NEVER calls readFile/readFileSync on the whole file — createReadStream only.
+ *
+ * bober: single .xml extension check; extend canHandle to sniff "HealthData"
+ *        root if the registry ever needs to distinguish multiple XML formats.
+ */
+export class AppleHealthAdapter {
+    kind = "apple-health";
+    /**
+     * Returns true for .xml files (cheap extension check — no full read).
+     */
+    canHandle(filePath) {
+        return filePath.toLowerCase().endsWith(".xml");
+    }
+    /**
+     * Stream-parse the Apple Health export XML file.
+     *
+     * Uses createReadStream as an async iterable to pull one chunk at a time.
+     * Feeds chunks to a strict SAX parser (synchronous per chunk).
+     * Flushes the observation buffer to the sink when it reaches BATCH_CAP,
+     * awaiting the write before pulling the next chunk (backpressure).
+     */
+    async ingest(filePath, sink) {
+        let recordsParsed = 0;
+        let buffer = [];
+        const parser = sax.parser(true, { trim: true });
+        parser.onopentag = (node) => {
+            if (node.name !== "Record")
+                return;
+            const a = node.attributes;
+            const value = parseFloat(a["value"] ?? "");
+            if (Number.isNaN(value))
+                return; // skip non-numeric records
+            recordsParsed++;
+            buffer.push({
+                metric: a["type"] ?? "",
+                value,
+                unit: a["unit"] ?? "",
+                tStart: a["startDate"] ?? "",
+                tEnd: a["endDate"] || undefined,
+                source: "apple-health",
+            });
+        };
+        // Collect any SAX parse errors so we can rethrow after the chunk.
+        let parseError = null;
+        parser.onerror = (err) => {
+            parseError = err;
+            // Clear so the parser does not get permanently stuck on the error state.
+            parser.error = null;
+        };
+        // createReadStream is an async iterable in Node.js >= 10 (streams2+).
+        // Using for-await-of pulls one chunk at a time — the stream stays paused
+        // between iterations, giving us natural backpressure control.
+        const stream = createReadStream(filePath, {
+            encoding: "utf8",
+        });
+        for await (const chunk of stream) {
+            // Feed chunk to the SAX parser synchronously (all opentag events fire here).
+            parser.write(chunk);
+            if (parseError) {
+                throw parseError;
+            }
+            // Flush in BATCH_CAP-sized slices whenever the buffer overflows.
+            // Awaiting writeBatch here IS the backpressure: the for-await loop
+            // does not pull the next chunk from the stream until this resolves.
+            while (buffer.length >= BATCH_CAP) {
+                const batch = buffer.splice(0, BATCH_CAP);
+                await sink.writeBatch(batch, []);
+            }
+        }
+        // Finalize the SAX parser.
+        try {
+            parser.close();
+        }
+        catch {
+            // ignore: tolerate malformed XML tails
+        }
+        // Flush remaining buffered observations (< BATCH_CAP) after stream ends.
+        if (buffer.length > 0) {
+            await sink.writeBatch(buffer, []);
+            buffer = [];
+        }
+        const newRows = "newRows" in sink ? sink.newRows : 0;
+        return { recordsParsed, newRows };
+    }
+}
+//# sourceMappingURL=apple-health.js.map

package/dist/medical/adapters/apple-health.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * Test-gap (cadence) analyzer — flags biomarkers overdue for re-testing.
+ *
+ * PURE except store reads. NO network / NO LLM / NO Date.now().
+ * All timestamps are injected parameters; the wall clock is read ONLY at the CLI boundary.
+ *
+ * ADR-3: RECOMMENDED_CADENCE_DAYS is a CLOSED code-reviewed table (mirror of NumericPrimitive
+ * at src/medical/types.ts:142). Extending it is a code-review event, not a runtime decision.
+ * Biomarkers ABSENT from the table are SKIPPED — no guessed cadence (sc-4-3).
+ */
+import type { HealthDataStore } from "../health-store.js";
+import type { MedicalFinding } from "./finding.js";
+/**
+ * Recommended re-test cadence in days, keyed by biomarker.
+ * Extending this is a code-review event (mirror NumericPrimitive at types.ts:142).
+ * Biomarkers absent here are SKIPPED — no guessed cadence (sc-4-3).
+ */
+export declare const RECOMMENDED_CADENCE_DAYS: Readonly<Record<string, number>>;
+/**
+ * Detect biomarkers that are overdue for re-testing based on the CLOSED cadence table.
+ *
+ * PURE except store reads. NO network / NO LLM / NO Date.now(). 'now' is injected.
+ * Biomarkers absent from RECOMMENDED_CADENCE_DAYS are SKIPPED (sc-4-3).
+ *
+ * @param store      HealthDataStore (caller owns lifecycle)
+ * @param biomarkers List of biomarker names to check
+ * @param opts       { now: ISO 8601 injected timestamp }
+ */
+export declare function detectTestGaps(store: HealthDataStore, biomarkers: string[], opts: {
+    now: string;
+}): MedicalFinding[];
+//# sourceMappingURL=cadence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cadence.d.ts","sourceRoot":"","sources":["../../../src/medical/analysis/cadence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMrE,CAAC;AA+BF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACpB,cAAc,EAAE,CAgBlB"}

package/dist/medical/analysis/cadence.js

@@ -0,0 +1,72 @@
+/**
+ * Test-gap (cadence) analyzer — flags biomarkers overdue for re-testing.
+ *
+ * PURE except store reads. NO network / NO LLM / NO Date.now().
+ * All timestamps are injected parameters; the wall clock is read ONLY at the CLI boundary.
+ *
+ * ADR-3: RECOMMENDED_CADENCE_DAYS is a CLOSED code-reviewed table (mirror of NumericPrimitive
+ * at src/medical/types.ts:142). Extending it is a code-review event, not a runtime decision.
+ * Biomarkers ABSENT from the table are SKIPPED — no guessed cadence (sc-4-3).
+ */
+import { findingId } from "./finding.js";
+// -- CLOSED cadence table -------------------------------------------------
+/**
+ * Recommended re-test cadence in days, keyed by biomarker.
+ * Extending this is a code-review event (mirror NumericPrimitive at types.ts:142).
+ * Biomarkers absent here are SKIPPED — no guessed cadence (sc-4-3).
+ */
+export const RECOMMENDED_CADENCE_DAYS = {
+    ldl: 365,
+    hba1c: 180,
+    tsh: 365,
+    vitamin_d: 365,
+    ferritin: 365,
+};
+const MS_PER_DAY = 86_400_000;
+// -- Internal helper ------------------------------------------------------
+function makeGapFinding(biomarker, cadenceDays, ageDays, now) {
+    return {
+        id: findingId("medical", biomarker, "cadence-gap"),
+        domain: "medical",
+        title: `${biomarker}: re-test overdue (recommended every ${cadenceDays} days)`,
+        kind: "question",
+        urgency: 2,
+        severity: 2,
+        evidence: [
+            `${biomarker} was last tested ${Math.floor(ageDays)} days ago`,
+            `Recommended re-test cadence: every ${cadenceDays} days`,
+        ],
+        surfacedAt: now,
+        tags: ["cadence-gap", biomarker],
+        status: "open",
+    };
+}
+// -- Public API -----------------------------------------------------------
+/**
+ * Detect biomarkers that are overdue for re-testing based on the CLOSED cadence table.
+ *
+ * PURE except store reads. NO network / NO LLM / NO Date.now(). 'now' is injected.
+ * Biomarkers absent from RECOMMENDED_CADENCE_DAYS are SKIPPED (sc-4-3).
+ *
+ * @param store      HealthDataStore (caller owns lifecycle)
+ * @param biomarkers List of biomarker names to check
+ * @param opts       { now: ISO 8601 injected timestamp }
+ */
+export function detectTestGaps(store, biomarkers, opts) {
+    const findings = [];
+    for (const biomarker of biomarkers) {
+        const cadenceDays = RECOMMENDED_CADENCE_DAYS[biomarker];
+        if (cadenceDays === undefined)
+            continue; // (b) CLOSED — skip unknown
+        const series = store.getLabSeries(biomarker); // ASC by collected_at
+        const latest = series[series.length - 1];
+        if (latest === undefined)
+            continue; // no data → no gap
+        const ageDays = (Date.parse(opts.now) - Date.parse(latest.collectedAtIso)) / MS_PER_DAY;
+        if (ageDays > cadenceDays) {
+            findings.push(makeGapFinding(biomarker, cadenceDays, ageDays, opts.now));
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=cadence.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cadence.js","sourceRoot":"","sources":["../../../src/medical/analysis/cadence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,4EAA4E;AAE5E;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACxE,GAAG,EAAE,GAAG;IACR,KAAK,EAAE,GAAG;IACV,GAAG,EAAE,GAAG;IACR,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B,4EAA4E;AAE5E,SAAS,cAAc,CACrB,SAAiB,EACjB,WAAmB,EACnB,OAAe,EACf,GAAW;IAEX,OAAO;QACL,EAAE,EAAE,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC;QAClD,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,GAAG,SAAS,wCAAwC,WAAW,QAAQ;QAC9E,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE;YACR,GAAG,SAAS,oBAAoB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW;YAC9D,sCAAsC,WAAW,OAAO;SACzD;QACD,UAAU,EAAE,GAAG;QACf,IAAI,EAAE,CAAC,aAAa,EAAE,SAAS,CAAC;QAChC,MAAM,EAAE,MAAM;KACf,CAAC;AACJ,CAAC;AAED,4EAA4E;AAE5E;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAsB,EACtB,UAAoB,EACpB,IAAqB;IAErB,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,WAAW,KAAK,SAAS;YAAE,SAAS,CAAC,4BAA4B;QAErE,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,sBAAsB;QACpE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzC,IAAI,MAAM,KAAK,SAAS;YAAE,SAAS,CAAC,mBAAmB;QAEvD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,GAAG,UAAU,CAAC;QACxF,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/medical/analysis/cross-marker.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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 type { HealthDataStore } from "../health-store.js";
+import type { MedicalFinding } from "./finding.js";
+/**
+ * Closed list of related-marker pairs (code-review to extend).
+ * When BOTH markers are out of reference range, an offer Finding is emitted.
+ */
+export declare const CROSS_MARKER_PAIRS: ReadonlyArray<readonly [string, string]>;
+/**
+ * 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 declare function detectCrossMarkerPatterns(store: HealthDataStore, opts: {
+    now: string;
+}): MedicalFinding[];
+//# sourceMappingURL=cross-marker.d.ts.map

package/dist/medical/analysis/cross-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-marker.d.ts","sourceRoot":"","sources":["../../../src/medical/analysis/cross-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAGvE,CAAC;AAwCF;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACpB,cAAc,EAAE,CAQlB"}