heor-agent-mcp 1.16.0 → 1.35.0

package/.well-known/mcp/server-card.json

@@ -1,8 +1,8 @@
 {
   "serverInfo": {
     "name": "heor-agent-mcp",
-    "version": "1.16.0",
-    "description": "AI-powered Health Economics and Outcomes Research (HEOR) MCP server. 28 tools for literature search (44 data sources incl. OHE and EuroQol), risk of bias assessment (RoB 2/ROBINS-I/AMSTAR-2 with GRADE integration), cost-effectiveness modeling (Markov/PartSA with live-formula XLSX, PSA/EVPPI/scenarios, QALY + evLYG summary metrics), budget impact analysis, abstract screening, survival curve fitting, indirect comparisons (Bucher/NMA/MAIC/STC) with I²/Cochran Q heterogeneity, ITC feasibility assessment (3-assumption framework), pharmacovigilance study classification (PASS/PAES/RMP/DUS/registry per EMA GVP rev 4), EU Joint Clinical Assessment (JCA) PICO matrix analyzer (DE/FR/IT/ES/NL + UK context), pharmacovigilance signal workflow (PRR/ROR/IC/MGPS per GVP Module IX rev 2 + GVP P.III pregnancy follow-up), MAIC pipeline orchestration, HTA dossier prep (NICE/EMA/FDA/IQWiG/HAS/EU JCA/GVD) with auto-GRADE + PV plan + NICE severity modifier + health inequalities + Global Value Dossier (13 sections, 4-market subsections US/UK/EU5/JP, gvd_evidence_pack pipe interface), structured unmet need assessment (evidence.unmet_need — 4-dimension framework: disease burden/treatment landscape/QoL/economic burden; pipes into GVD Section 4 + hta_dossier), UK EQ-5D-5L value set impact estimator, neurology & cognitive outcome scale scoring (UMSARS/UPDRS/MDS-UPDRS/ADAS-Cog/MoCA/MMSE with MCID responder classification + NNIPPS/PPMI/ADNI trajectory comparison), IRB/Ethics Committee submission classifier, examples + recipe templates."
+    "version": "1.35.0",
+    "description": "AI-powered Health Economics and Outcomes Research (HEOR) MCP server. 47 tools for literature search (44 data sources incl. OHE and EuroQol), risk of bias assessment (RoB 2/ROBINS-I/AMSTAR-2 with GRADE integration), cost-effectiveness modeling (Markov/PartSA with live-formula XLSX, PSA/EVPPI/scenarios, QALY + evLYG summary metrics), budget impact analysis, abstract screening, survival curve fitting, indirect comparisons (Bucher/NMA/MAIC/STC) with I²/Cochran Q heterogeneity, ITC feasibility assessment (3-assumption framework), pharmacovigilance study classification (PASS/PAES/RMP/DUS/registry per EMA GVP rev 4), EU Joint Clinical Assessment (JCA) PICO matrix analyzer (DE/FR/IT/ES/NL + UK context), pharmacovigilance signal workflow (PRR/ROR/IC/MGPS per GVP Module IX rev 2 + GVP P.III pregnancy follow-up), MAIC pipeline orchestration, HTA dossier prep (NICE/EMA/FDA/IQWiG/HAS/EU JCA/GVD) with auto-GRADE + PV plan + NICE severity modifier + health inequalities + Global Value Dossier (13 sections, 4-market subsections US/UK/EU5/JP, gvd_evidence_pack pipe interface), structured unmet need assessment (evidence.unmet_need — 4-dimension framework: disease burden/treatment landscape/QoL/economic burden; pipes into GVD Section 4 + hta_dossier), UK EQ-5D-5L value set impact estimator, neurology & cognitive outcome scale scoring (UMSARS/UPDRS/MDS-UPDRS/ADAS-Cog/MoCA/MMSE with MCID responder classification + NNIPPS/PPMI/ADNI trajectory comparison), IRB/Ethics Committee submission classifier, examples + recipe templates."
   },
   "authentication": {
     "required": false,

package/README.md

@@ -126,7 +126,16 @@ The first prompt exercises `literature_search` + `validate_links` (free, no API
 
 ## What's new
 
-See [CHANGELOG.md](./CHANGELOG.md) for full version history. Current: **v1.13.0** (28 tools, 44 data sources).
+See [CHANGELOG.md](./CHANGELOG.md) for full version history. Current: **v1.23.0** (45 tools, 44 data sources).
+
+### v1.17.0–v1.23.0 — Living Evidence Intelligence (review → reimbursement)
+
+A connected RWE + cross-deliverable layer (see [docs/FEATURES.md](./docs/FEATURES.md) for the full table):
+
+- **RWE & real-world safety:** `rwe.method_select` (study-design selection), `pv.comparative_safety` (class-level FAERS-style AE ranking), `evidence.triangulation` (per-outcome RCT↔RWE concordance).
+- **Governed social listening:** `rwe.social_listening_protocol` + `pv.social_listening_triage` (GVP Module VI ICSR triage — no scraping).
+- **One source of truth:** `evidence.claim_registry` (author/auto-import a figure once), `evidence.consistency_check` (detect drift across dossier/publication/payer), `publication.draft` (reuse claims; CONSORT/STROBE/PRISMA/CHEERS + GPP2022/ICMJE).
+- **Living orchestration:** `evidence.gap_analysis` (iEGP), `workflow.living_evidence` (SLR → living KB → JCA/HTA runbook), `hta.living_gvd` (regenerate only the GVD sections whose figures changed).
 
 ### v1.13.0 — AI Transparency Disclosure (ISPOR ELEVATE-GenAI aligned)
 

package/dist/audit/builder.d.ts

@@ -1,4 +1,4 @@
-import type { AuditRecord, SourceAudit, ExclusionRecord, ToolCallTrace } from "./types.js";
+import type { AuditRecord, SourceAudit, ExclusionRecord, ToolCallTrace, DecisionRecord } from "./types.js";
 export declare function createAuditRecord(tool: string, query: Record<string, unknown>, output_format: string, methodology?: string): AuditRecord;
 export declare function addToolCall(record: AuditRecord, trace: ToolCallTrace): AuditRecord;
 export declare function addSource(record: AuditRecord, source: SourceAudit): AuditRecord;
@@ -6,4 +6,5 @@ export declare function addExclusion(record: AuditRecord, exclusion: ExclusionRe
 export declare function addAssumption(record: AuditRecord, assumption: string): AuditRecord;
 export declare function addWarning(record: AuditRecord, warning: string): AuditRecord;
 export declare function setMethodology(record: AuditRecord, methodology: string): AuditRecord;
+export declare function addDecisions(record: AuditRecord, decisions: DecisionRecord[]): AuditRecord;
 //# sourceMappingURL=builder.d.ts.map

package/dist/audit/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/audit/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,aAAa,EAAE,MAAM,EACrB,WAAW,SAAK,GACf,WAAW,CAcb;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,aAAa,GACnB,WAAW,CAEb;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,GAClB,WAAW,CAMb;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,eAAe,GACzB,WAAW,CAKb;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GACjB,WAAW,CAEb;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAE5E;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,GAClB,WAAW,CAEb"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/audit/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,eAAe,EACf,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,aAAa,EAAE,MAAM,EACrB,WAAW,SAAK,GACf,WAAW,CAcb;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,aAAa,GACnB,WAAW,CAEb;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,GAClB,WAAW,CAMb;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,eAAe,GACzB,WAAW,CAKb;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GACjB,WAAW,CAEb;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAE5E;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,GAClB,WAAW,CAEb;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,cAAc,EAAE,GAC1B,WAAW,CAUb"}

package/dist/audit/builder.js

@@ -38,4 +38,16 @@ export function addWarning(record, warning) {
 export function setMethodology(record, methodology) {
     return { ...record, methodology };
 }
+export function addDecisions(record, decisions) {
+    if (decisions.length === 0)
+        return record;
+    const stamped = decisions.map((d) => ({
+        ...d,
+        recorded_at: new Date().toISOString(),
+    }));
+    return {
+        ...record,
+        decisions: [...(record.decisions ?? []), ...stamped],
+    };
+}
 //# sourceMappingURL=builder.js.map

package/dist/audit/builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/audit/builder.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,KAA8B,EAC9B,aAAqB,EACrB,WAAW,GAAG,EAAE;IAEhB,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK;QACL,eAAe,EAAE,EAAE;QACnB,WAAW;QACX,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,EAAE;QACZ,aAAa;QACb,YAAY,EAAE,EAAE;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,MAAmB,EACnB,KAAoB;IAEpB,OAAO,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,MAAmB,EACnB,MAAmB;IAEnB,OAAO;QACL,GAAG,MAAM;QACT,eAAe,EAAE,CAAC,GAAG,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC;QACpD,UAAU,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,gBAAgB;KACxD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAmB,EACnB,SAA0B;IAE1B,OAAO;QACL,GAAG,MAAM;QACT,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,MAAmB,EACnB,UAAkB;IAElB,OAAO,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAmB,EAAE,OAAe;IAC7D,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAAmB,EACnB,WAAmB;IAEnB,OAAO,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/audit/builder.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,KAA8B,EAC9B,aAAqB,EACrB,WAAW,GAAG,EAAE;IAEhB,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK;QACL,eAAe,EAAE,EAAE;QACnB,WAAW;QACX,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,EAAE;QACZ,aAAa;QACb,YAAY,EAAE,EAAE;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,MAAmB,EACnB,KAAoB;IAEpB,OAAO,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,MAAmB,EACnB,MAAmB;IAEnB,OAAO;QACL,GAAG,MAAM;QACT,eAAe,EAAE,CAAC,GAAG,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC;QACpD,UAAU,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,gBAAgB;KACxD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAmB,EACnB,SAA0B;IAE1B,OAAO;QACL,GAAG,MAAM;QACT,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,MAAmB,EACnB,UAAkB;IAElB,OAAO,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAmB,EAAE,OAAe;IAC7D,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAAmB,EACnB,WAAmB;IAEnB,OAAO,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAmB,EACnB,SAA2B;IAE3B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1C,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,CAAC;QACJ,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC,CAAC,CAAC;IACJ,OAAO;QACL,GAAG,MAAM;QACT,SAAS,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC;KACrD,CAAC;AACJ,CAAC"}

package/dist/audit/decisionPersistence.d.ts

@@ -0,0 +1,10 @@
+import type { DecisionRecord } from "./types.js";
+export declare const DECISIONS_WIKI_PATH = "wiki/decisions.md";
+/**
+ * Append decision records to the project's wiki/decisions.md.
+ * NEVER throws — persistence failure must not fail the analysis
+ * (design log #52). Returns null on success, a warning string on failure
+ * for the caller to attach via addWarning().
+ */
+export declare function persistDecisions(projectId: string, tool: string, decisions: DecisionRecord[]): Promise<string | null>;
+//# sourceMappingURL=decisionPersistence.d.ts.map

package/dist/audit/decisionPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisionPersistence.d.ts","sourceRoot":"","sources":["../../src/audit/decisionPersistence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAqBvD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,cAAc,EAAE,GAC1B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB"}

package/dist/audit/decisionPersistence.js

@@ -0,0 +1,39 @@
+import { appendWikiFile } from "../knowledge/wikiStore.js";
+export const DECISIONS_WIKI_PATH = "wiki/decisions.md";
+function decisionToWikiBlock(tool, d) {
+    const lines = [
+        `\n## ${d.decision_point} — ${tool}`,
+        `- **Recorded:** ${d.recorded_at ?? new Date().toISOString()}`,
+        `- **Decided by:** ${d.decided_by}`,
+        `- **Choice:** ${d.choice}`,
+        `- **Rationale:** ${d.rationale}`,
+    ];
+    if (d.alternatives_considered?.length) {
+        lines.push(`- **Alternatives considered:** ${d.alternatives_considered.join("; ")}`);
+    }
+    if (d.references?.length) {
+        lines.push(`- **References (unverified):** ${d.references.join(", ")}`);
+    }
+    return lines.join("\n") + "\n";
+}
+/**
+ * Append decision records to the project's wiki/decisions.md.
+ * NEVER throws — persistence failure must not fail the analysis
+ * (design log #52). Returns null on success, a warning string on failure
+ * for the caller to attach via addWarning().
+ */
+export async function persistDecisions(projectId, tool, decisions) {
+    if (decisions.length === 0)
+        return null;
+    try {
+        const content = decisions
+            .map((d) => decisionToWikiBlock(tool, d))
+            .join("");
+        await appendWikiFile(projectId, DECISIONS_WIKI_PATH, content);
+        return null;
+    }
+    catch (e) {
+        return `decision records could not be persisted to ${DECISIONS_WIKI_PATH}: ${e instanceof Error ? e.message : String(e)}`;
+    }
+}
+//# sourceMappingURL=decisionPersistence.js.map

package/dist/audit/decisionPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisionPersistence.js","sourceRoot":"","sources":["../../src/audit/decisionPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEvD,SAAS,mBAAmB,CAAC,IAAY,EAAE,CAAiB;IAC1D,MAAM,KAAK,GAAG;QACZ,QAAQ,CAAC,CAAC,cAAc,MAAM,IAAI,EAAE;QACpC,mBAAmB,CAAC,CAAC,WAAW,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;QAC9D,qBAAqB,CAAC,CAAC,UAAU,EAAE;QACnC,iBAAiB,CAAC,CAAC,MAAM,EAAE;QAC3B,oBAAoB,CAAC,CAAC,SAAS,EAAE;KAClC,CAAC;IACF,IAAI,CAAC,CAAC,uBAAuB,EAAE,MAAM,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CACR,kCAAkC,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAAiB,EACjB,IAAY,EACZ,SAA2B;IAE3B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,SAAS;aACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;aACxC,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,MAAM,cAAc,CAAC,SAAS,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,8CAA8C,mBAAmB,KACtE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAC3C,EAAE,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/audit/decisionSchema.d.ts

@@ -0,0 +1,89 @@
+import { z } from "zod";
+export declare const DecisionRecordSchema: z.ZodObject<{
+    decision_point: z.ZodString;
+    choice: z.ZodString;
+    rationale: z.ZodString;
+    alternatives_considered: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    decided_by: z.ZodEnum<["user", "agent_proposed_user_confirmed", "agent"]>;
+    references: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    decision_point: string;
+    choice: string;
+    rationale: string;
+    decided_by: "user" | "agent_proposed_user_confirmed" | "agent";
+    alternatives_considered?: string[] | undefined;
+    references?: string[] | undefined;
+}, {
+    decision_point: string;
+    choice: string;
+    rationale: string;
+    decided_by: "user" | "agent_proposed_user_confirmed" | "agent";
+    alternatives_considered?: string[] | undefined;
+    references?: string[] | undefined;
+}>;
+export declare const DecisionsParam: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    decision_point: z.ZodString;
+    choice: z.ZodString;
+    rationale: z.ZodString;
+    alternatives_considered: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    decided_by: z.ZodEnum<["user", "agent_proposed_user_confirmed", "agent"]>;
+    references: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    decision_point: string;
+    choice: string;
+    rationale: string;
+    decided_by: "user" | "agent_proposed_user_confirmed" | "agent";
+    alternatives_considered?: string[] | undefined;
+    references?: string[] | undefined;
+}, {
+    decision_point: string;
+    choice: string;
+    rationale: string;
+    decided_by: "user" | "agent_proposed_user_confirmed" | "agent";
+    alternatives_considered?: string[] | undefined;
+    references?: string[] | undefined;
+}>, "many">>;
+/** Hand-written JSON inputSchema fragment — reuse in every tool's inputSchema.properties (DRY, drift-proof). */
+export declare const DECISIONS_SCHEMA_PROPERTY: {
+    readonly type: "array";
+    readonly maxItems: 20;
+    readonly description: "Methodological decisions made in conversation (source selection, comparator choice, screening criteria, model structure...). Each entry records the choice, the rationale (why), alternatives rejected, and who decided. Embedded in the audit trail Decision Log and, when a project is supplied, appended to wiki/decisions.md for cross-session recall. Tools never invent decisions — only pass what the user made or confirmed. Design log #52.";
+    readonly items: {
+        readonly type: "object";
+        readonly required: readonly ["decision_point", "choice", "rationale", "decided_by"];
+        readonly properties: {
+            readonly decision_point: {
+                readonly type: "string";
+                readonly description: "e.g. source_selection, comparator_choice, screening_criteria, model_structure";
+            };
+            readonly choice: {
+                readonly type: "string";
+                readonly description: "What was decided";
+            };
+            readonly rationale: {
+                readonly type: "string";
+                readonly description: "Why — required, non-empty";
+            };
+            readonly alternatives_considered: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "What was rejected";
+            };
+            readonly decided_by: {
+                readonly type: "string";
+                readonly enum: readonly ["user", "agent_proposed_user_confirmed", "agent"];
+                readonly description: "Who made the decision — mark honestly";
+            };
+            readonly references: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "DOI/PMID/URL — recorded verbatim, rendered as unverified unless verified via utils.verify_citations";
+            };
+        };
+    };
+};
+//# sourceMappingURL=decisionSchema.d.ts.map

package/dist/audit/decisionSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisionSchema.d.ts","sourceRoot":"","sources":["../../src/audit/decisionSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;EAS/B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;YAIO,CAAC;AAEnC,gHAAgH;AAChH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC5B,CAAC"}

package/dist/audit/decisionSchema.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+const DECISIONS_DESCRIPTION = "Methodological decisions made in conversation (source selection, comparator choice, screening criteria, model structure...). Each entry records the choice, the rationale (why), alternatives rejected, and who decided. Embedded in the audit trail Decision Log and, when a project is supplied, appended to wiki/decisions.md for cross-session recall. Tools never invent decisions — only pass what the user made or confirmed. Design log #52.";
+export const DecisionRecordSchema = z.object({
+    decision_point: z.string().min(1),
+    choice: z.string().min(1),
+    rationale: z
+        .string()
+        .min(1, "rationale is required — a decision without a why is not provenance"),
+    alternatives_considered: z.array(z.string()).optional(),
+    decided_by: z.enum(["user", "agent_proposed_user_confirmed", "agent"]),
+    references: z.array(z.string()).optional(),
+});
+export const DecisionsParam = z
+    .array(DecisionRecordSchema)
+    .max(20)
+    .optional()
+    .describe(DECISIONS_DESCRIPTION);
+/** Hand-written JSON inputSchema fragment — reuse in every tool's inputSchema.properties (DRY, drift-proof). */
+export const DECISIONS_SCHEMA_PROPERTY = {
+    type: "array",
+    maxItems: 20,
+    description: DECISIONS_DESCRIPTION,
+    items: {
+        type: "object",
+        required: ["decision_point", "choice", "rationale", "decided_by"],
+        properties: {
+            decision_point: {
+                type: "string",
+                description: "e.g. source_selection, comparator_choice, screening_criteria, model_structure",
+            },
+            choice: { type: "string", description: "What was decided" },
+            rationale: {
+                type: "string",
+                description: "Why — required, non-empty",
+            },
+            alternatives_considered: {
+                type: "array",
+                items: { type: "string" },
+                description: "What was rejected",
+            },
+            decided_by: {
+                type: "string",
+                enum: ["user", "agent_proposed_user_confirmed", "agent"],
+                description: "Who made the decision — mark honestly",
+            },
+            references: {
+                type: "array",
+                items: { type: "string" },
+                description: "DOI/PMID/URL — recorded verbatim, rendered as unverified unless verified via utils.verify_citations",
+            },
+        },
+    },
+};
+//# sourceMappingURL=decisionSchema.js.map

package/dist/audit/decisionSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisionSchema.js","sourceRoot":"","sources":["../../src/audit/decisionSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,qBAAqB,GACzB,sbAAsb,CAAC;AAEzb,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,oEAAoE,CAAC;IAC/E,uBAAuB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvD,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,+BAA+B,EAAE,OAAO,CAAC,CAAC;IACtE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,KAAK,CAAC,oBAAoB,CAAC;KAC3B,GAAG,CAAC,EAAE,CAAC;KACP,QAAQ,EAAE;KACV,QAAQ,CAAC,qBAAqB,CAAC,CAAC;AAEnC,gHAAgH;AAChH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,qBAAqB;IAClC,KAAK,EAAE;QACL,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,gBAAgB,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC;QACjE,UAAU,EAAE;YACV,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,+EAA+E;aAClF;YACD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;YAC3D,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2BAA2B;aACzC;YACD,uBAAuB,EAAE;gBACvB,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,mBAAmB;aACjC;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,+BAA+B,EAAE,OAAO,CAAC;gBACxD,WAAW,EAAE,uCAAuC;aACrD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,qGAAqG;aACxG;SACF;KACF;CACO,CAAC"}

package/dist/audit/types.d.ts

@@ -25,6 +25,21 @@ export interface ToolCallTrace {
     outcome: "ok" | "degraded" | "skipped" | "error";
     output_size_bytes?: number;
 }
+export interface DecisionRecord {
+    /** e.g. "source_selection", "comparator_choice", "screening_criteria", "model_structure" */
+    decision_point: string;
+    /** What was decided */
+    choice: string;
+    /** Why — required, non-empty. A decision without a why is noise, not provenance. */
+    rationale: string;
+    alternatives_considered?: string[];
+    /** Provenance of the decision itself — feeds governance_self_check human-oversight dimension */
+    decided_by: "user" | "agent_proposed_user_confirmed" | "agent";
+    /** DOI/PMID/URL — recorded verbatim, rendered as unverified unless caller ran utils.verify_citations */
+    references?: string[];
+    /** ISO 8601 — stamped by addDecisions() on ingest, never caller-supplied */
+    recorded_at?: string;
+}
 export interface AuditRecord {
     tool: string;
     /** ISO 8601 timestamp when the tool invocation began (query start time, not completion time) */
@@ -42,5 +57,7 @@ export interface AuditRecord {
     warnings: string[];
     output_format: string;
     tools_called: ToolCallTrace[];
+    /** Methodological decisions supplied by the calling LLM/user — tools never invent these (design log #52) */
+    decisions?: DecisionRecord[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/audit/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/audit/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,QAAQ,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,IAAI,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,8FAA8F;IAC9F,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,UAAU,EAAE,MAAM,CAAC;IACnB,0LAA0L;IAC1L,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,aAAa,EAAE,CAAC;CAC/B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/audit/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,QAAQ,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,IAAI,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,4FAA4F;IAC5F,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,gGAAgG;IAChG,UAAU,EAAE,MAAM,GAAG,+BAA+B,GAAG,OAAO,CAAC;IAC/D,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,8FAA8F;IAC9F,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,UAAU,EAAE,MAAM,CAAC;IACnB,0LAA0L;IAC1L,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,4GAA4G;IAC5G,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B"}

package/dist/claims/consistency.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Pure cross-deliverable consistency checker. No I/O.
+ *
+ * For each registered claim × each deliverable, decides whether the claim
+ * appears consistently, has drifted (a DIFFERENT number sits next to the
+ * claim's keywords), or is absent. Deterministic: locates the claim by its
+ * keywords, extracts nearby numbers, and compares to the canonical value.
+ */
+import type { Claim, ConsistencyResult, DeliverableInput } from "./types.js";
+/** Parse a numeric token (currency/commas/%/whitespace tolerated) → number | null. */
+export declare function parseNumber(token: string): number | null;
+export declare function checkConsistency(claims: Claim[], deliverables: DeliverableInput[]): ConsistencyResult;
+//# sourceMappingURL=consistency.d.ts.map

package/dist/claims/consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consistency.d.ts","sourceRoot":"","sources":["../../src/claims/consistency.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EACV,KAAK,EAEL,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAKpB,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKxD;AAoID,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,KAAK,EAAE,EACf,YAAY,EAAE,gBAAgB,EAAE,GAC/B,iBAAiB,CAqCnB"}

package/dist/claims/consistency.js

@@ -0,0 +1,159 @@
+/** ±N characters around a keyword hit to scan for a number. */
+const WINDOW = 70;
+/** Parse a numeric token (currency/commas/%/whitespace tolerated) → number | null. */
+export function parseNumber(token) {
+    const cleaned = token.replace(/[,\s$£€%]/g, "").replace(/[^0-9.\-]/g, "");
+    if (cleaned === "" || cleaned === "-" || cleaned === ".")
+        return null;
+    const n = Number(cleaned);
+    return Number.isFinite(n) ? n : null;
+}
+const NUMBER_RE = /-?[£$€]?\s?\d[\d,]*(?:\.\d+)?\s?%?/g;
+function numbersNear(text, keyword) {
+    const lowerText = text.toLowerCase();
+    const kw = keyword.toLowerCase();
+    const out = [];
+    let from = 0;
+    for (;;) {
+        const idx = lowerText.indexOf(kw, from);
+        if (idx === -1)
+            break;
+        const start = Math.max(0, idx - WINDOW);
+        const end = Math.min(text.length, idx + kw.length + WINDOW);
+        const window = text.slice(start, end);
+        const matches = window.match(NUMBER_RE) ?? [];
+        for (const m of matches) {
+            const v = parseNumber(m);
+            if (v !== null)
+                out.push({ raw: m.trim(), value: v });
+        }
+        from = idx + kw.length;
+    }
+    return out;
+}
+/** Two numbers are "equal" within a small relative tolerance (exact for integers). */
+function numbersEqual(a, b) {
+    if (a === b)
+        return true;
+    const denom = Math.max(Math.abs(a), Math.abs(b), 1);
+    return Math.abs(a - b) / denom <= 0.005; // 0.5%
+}
+function hasAnyKeyword(text, claim) {
+    const lower = text.toLowerCase();
+    return claim.keywords.some((k) => k.trim() && lower.includes(k.trim().toLowerCase()));
+}
+function checkClaimInDeliverable(claim, deliverable) {
+    const keywordHit = hasAnyKeyword(deliverable.text, claim);
+    // Qualitative claim (no numeric value): presence by keyword is all we check.
+    if (typeof claim.numeric_value !== "number") {
+        if (keywordHit) {
+            return {
+                claim_id: claim.id,
+                deliverable: deliverable.name,
+                status: "consistent",
+                conflicting_values: [],
+                note: "Qualitative claim — keyword(s) present; verify wording manually.",
+            };
+        }
+        return {
+            claim_id: claim.id,
+            deliverable: deliverable.name,
+            status: "absent",
+            conflicting_values: [],
+            note: "Claim keywords not found in this deliverable.",
+        };
+    }
+    if (!keywordHit) {
+        return {
+            claim_id: claim.id,
+            deliverable: deliverable.name,
+            status: "absent",
+            conflicting_values: [],
+            note: "Claim keywords not found — claim does not appear in this deliverable.",
+        };
+    }
+    // Keyword present → look for numbers near it and compare to canonical.
+    const found = claim.keywords.flatMap((k) => numbersNear(deliverable.text, k));
+    if (found.length === 0) {
+        return {
+            claim_id: claim.id,
+            deliverable: deliverable.name,
+            status: "consistent",
+            conflicting_values: [],
+            note: "Keyword present but no adjacent number found — verify the value is stated.",
+        };
+    }
+    const matches = found.filter((f) => numbersEqual(f.value, claim.numeric_value));
+    if (matches.length > 0) {
+        // Canonical value found; report any conflicting numbers as drift too.
+        const conflicts = dedupeRaw(found.filter((f) => !numbersEqual(f.value, claim.numeric_value)));
+        if (conflicts.length > 0) {
+            return {
+                claim_id: claim.id,
+                deliverable: deliverable.name,
+                status: "drift",
+                conflicting_values: conflicts,
+                note: `Canonical value present but conflicting number(s) also appear near the keyword: ${conflicts.join(", ")} (canonical: ${claim.value_display ?? claim.numeric_value}).`,
+            };
+        }
+        return {
+            claim_id: claim.id,
+            deliverable: deliverable.name,
+            status: "consistent",
+            conflicting_values: [],
+            note: `Canonical value present (${claim.value_display ?? claim.numeric_value}).`,
+        };
+    }
+    // Keyword present, numbers present, but none match canonical → drift.
+    const conflicts = dedupeRaw(found);
+    return {
+        claim_id: claim.id,
+        deliverable: deliverable.name,
+        status: "drift",
+        conflicting_values: conflicts,
+        note: `Canonical value (${claim.value_display ?? claim.numeric_value}) NOT found; conflicting number(s) near keyword: ${conflicts.join(", ")}.`,
+    };
+}
+function dedupeRaw(items) {
+    const seen = new Set();
+    const out = [];
+    for (const i of items) {
+        if (!seen.has(i.value)) {
+            seen.add(i.value);
+            out.push(i.raw);
+        }
+    }
+    return out;
+}
+export function checkConsistency(claims, deliverables) {
+    const findings = [];
+    for (const claim of claims) {
+        for (const d of deliverables) {
+            findings.push(checkClaimInDeliverable(claim, d));
+        }
+    }
+    const drift = findings.filter((f) => f.status === "drift");
+    const absent = findings.filter((f) => f.status === "absent");
+    const drifting_claims = [...new Set(drift.map((f) => f.claim_id))];
+    const warnings = [];
+    if (drift.length > 0) {
+        warnings.push(`${drift.length} drift finding(s) across ${drifting_claims.length} claim(s) — a different value sits next to the claim keyword in at least one deliverable. Reconcile to the canonical source before release.`);
+    }
+    if (claims.length === 0) {
+        warnings.push("No claims supplied — nothing to check.");
+    }
+    if (deliverables.length === 0) {
+        warnings.push("No deliverables supplied — nothing to check.");
+    }
+    warnings.push("Detection is keyword-anchored and numeric — it flags drifting numbers near claim keywords, not paraphrased or unanchored claims. A 'consistent' result is necessary but not sufficient; human review remains required.");
+    return {
+        claims_checked: claims.length,
+        deliverables_checked: deliverables.length,
+        findings,
+        drift_count: drift.length,
+        absent_count: absent.length,
+        drifting_claims,
+        warnings,
+    };
+}
+//# sourceMappingURL=consistency.js.map

package/dist/claims/consistency.js.map

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

package/dist/claims/extract.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pure claim extractors: map a tool's structured result onto candidate
+ * claims for the registry, so the "single source of truth" self-populates
+ * instead of manual upserts. No I/O.
+ *
+ * Recognises the result shapes of models.cost_effectiveness and
+ * models.budget_impact. Unknown sources return [] (the caller warns).
+ * Defensive: navigates optional fields and skips anything missing or
+ * non-finite — never throws on a partial/odd result.
+ */
+export interface ExtractedClaim {
+    id: string;
+    statement: string;
+    numeric_value?: number;
+    value_display?: string;
+    unit?: string;
+    keywords: string[];
+}
+export declare const SUPPORTED_IMPORT_SOURCES: string[];
+export declare function extractClaims(sourceTool: string, result: unknown): ExtractedClaim[];
+//# sourceMappingURL=extract.d.ts.map

package/dist/claims/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/claims/extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAmGD,eAAO,MAAM,wBAAwB,UAA0B,CAAC;AAEhE,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,GACd,cAAc,EAAE,CAGlB"}