heor-agent-mcp 1.6.3 → 1.9.2

package/README.md

@@ -20,24 +20,45 @@ Built for pharmaceutical, biotech, CRO, and medical affairs teams who need rigor
 
 ---
 
-## What's new in v1.1.0
+## First 60 seconds
 
-Pharmacovigilance + workflow orchestration:
+Verify your install works **before** wiring it into Claude / Cursor / Continue. Open two terminal tabs:
 
-- **`pv_classify` tool** — classifies a planned study into its EMA pharmacovigilance regulatory category (PASS imposed/voluntary, PAES, RMP Annex 4, DUS, active surveillance registry, pregnancy registry, spontaneous reporting, ICH E2E plan). Returns the matching GVP module (V/VI/VIII/VIII Addendum I), ENCePP protocol template ID, RMP implications, FDA analogue, and submission obligations. Pure decision-tree per EMA GVP rev 4 + EU Regulation 1235/2010 Article 107a. <200ms response.
-- **`hta_dossier` Pharmacovigilance Plan section** — pass `pv_classification` from `pv_classify` to `hta_dossier` and the dossier output now includes a PV Plan section between RoB and CEA. Without it, a one-line "PV plan not provided" note flags the gap so reviewers see what's missing.
-- **`maic_workflow` orchestrator** *(v1.0.6)* — runs the full MAIC discovery+screening pipeline (ITC feasibility + parallel literature_search + screening + RoB + network) in one MCP call. Built for ChatGPT-5.3 surfaces where chaining 5+ tool calls in parallel is unreliable; works equally well from Claude.
-- **`examples` tool** *(v1.0.5)* — pre-filled JSON inputs for heavy-schema tools (CEA, BIA, survival, MAIC, Bucher) plus a `maic_workflow_recipe` multi-step prompt template for ChatGPT users.
-- **CMS IRA awareness** — when `pv_classify` is called with US jurisdiction, output explicitly notes that CMS IRA Medicare price-negotiation calculations exclude PV cost data — track those obligations in the regulatory budget, not the HEOR cost-effectiveness model.
-- **GRADE I²-based inconsistency, GRADE upgrading (Guyatt 2011), Bucher consistency check, EQ-5D 5L baseline-utility-aware impact** *(v1.0.4)* — see [CHANGELOG.md](./CHANGELOG.md).
-- **ChatGPT Custom GPT support** *(v1.0.4)* — OpenAPI 3.1 adapter at `/api/openapi` lets you build a Custom GPT in 5 minutes. See [ChatGPT Custom GPT](#chatgpt-custom-gpt) below.
-- **Surface-tagged analytics** *(v1.0.4)* — every `tool_call` PostHog event carries a `surface` property (`claude_anthropic_web` / `chatgpt_adapter` / `claude_desktop` / `direct_mcp`).
+**Tab 1 — start the server in HTTP mode:**
 
-See [CHANGELOG.md](./CHANGELOG.md) for the full diff.
+```bash
+MCP_HTTP_PORT=8080 npx heor-agent-mcp@latest
+```
+
+You should see:
+
+```
+HEORAgent MCP server running on HTTP port 8080
+```
+
+**Tab 2 — confirm it responds:**
+
+```bash
+curl -s http://localhost:8080/health
+```
+
+Expected output:
+
+```json
+{"status":"ok","server":"heor-agent-mcp","version":"1.9.2"}
+```
+
+✅ If you see the JSON above, the npm package works on your machine. Any further issues are in your MCP client config (Claude Desktop / Cursor / Continue), not the server.
+
+❌ If you see `command not found`, run `node --version` — you need Node ≥20. If you see a different error, file a quick issue at https://github.com/neptun2000/heor-agent-mcp/issues with the output.
+
+Now stop Tab 1 (`Ctrl+C`) and pick your client below — you don't need the HTTP mode for the actual integration; Claude / Cursor / Continue all use stdio.
 
 ---
 
-## Quick Start
+## Quick Start (per client)
+
+Pick your MCP host:
 
 ### Claude Code
 
@@ -47,9 +68,9 @@ claude mcp add heor-agent -- npx heor-agent-mcp
 
 Then restart Claude Code.
 
-### Claude Desktop / claude.ai
+### Claude Desktop / claude.ai Desktop
 
-Add to your MCP configuration:
+Edit your MCP config file (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS) and add:
 
 ```json
 {
@@ -62,15 +83,69 @@ Add to your MCP configuration:
 }
 ```
 
-### Verify
+Then restart Claude Desktop.
+
+### Cursor / Continue / Cline
+
+Same config shape as Claude Desktop above; the file path differs by client:
+- **Cursor:** `Settings → MCP → Add new MCP server`
+- **Continue:** `~/.continue/config.json` under the `mcpServers` key
+- **Cline:** `Settings → MCP Servers → Edit MCP Settings`
+
+### Hosted (no install)
+
+- **ChatGPT (Plus / Team):** [HEORAgent on ChatGPT](https://chatgpt.com/g/g-69f651f588f48191b1d69d54409857ec-heoragent) — type `/heor` to use it; works on any conversation.
+- **Web UI (Claude, BYOK):** [web-michael-ns-projects.vercel.app](https://web-michael-ns-projects.vercel.app) — bring your Anthropic API key; runs the full v1.6.3 toolset.
+
+---
+
+## Your first prompt
+
+Once your MCP host is configured, paste any of these to verify end-to-end:
+
+```
+Run a literature search for semaglutide cost-effectiveness in T2D
+using PubMed, NICE TAs, and ICER reports. Set runs=2.
+```
 
 ```
-> Run a literature search for semaglutide cost-effectiveness in T2D using PubMed and NICE TAs
+Run irb_review for an industry-funded interventional Phase 2 trial in
+relapsed MM — multi-site US+EU, pseudonymized data, greater-than-minimal
+risk. I need the review tier, GDPR/HIPAA DMP, SAE framework, and the
+ready-to-paste cover letter.
 ```
 
+```
+Run jca_pico_scope for osimertinib in EGFR-mutant 2L NSCLC across
+DE/FR/IT/ES/NL. Then prepare an EU JCA dossier draft using the picos.
+```
+
+The first prompt exercises `literature_search` + `validate_links` (free, no API keys needed). The second exercises `irb_review` (pure decision tree, instant). The third exercises `jca_pico_scope` → `hta_dossier` pipeline.
+
+---
+
+## What's new
+
+See [CHANGELOG.md](./CHANGELOG.md) for full version history. Current: **v1.9.2** (27 tools, 44 data sources).
+
+### v1.0.4 highlights (still in v1.6.3)
+
+Pharmacovigilance + workflow orchestration:
+
+- **`pv_classify` tool** — classifies a planned study into its EMA pharmacovigilance regulatory category (PASS imposed/voluntary, PAES, RMP Annex 4, DUS, active surveillance registry, pregnancy registry, spontaneous reporting, ICH E2E plan). Returns the matching GVP module (V/VI/VIII/VIII Addendum I), ENCePP protocol template ID, RMP implications, FDA analogue, and submission obligations. Pure decision-tree per EMA GVP rev 4 + EU Regulation 1235/2010 Article 107a. <200ms response.
+- **`hta_dossier` Pharmacovigilance Plan section** — pass `pv_classification` from `pv_classify` to `hta_dossier` and the dossier output now includes a PV Plan section between RoB and CEA. Without it, a one-line "PV plan not provided" note flags the gap so reviewers see what's missing.
+- **`maic_workflow` orchestrator** *(v1.0.6)* — runs the full MAIC discovery+screening pipeline (ITC feasibility + parallel literature_search + screening + RoB + network) in one MCP call. Built for ChatGPT-5.3 surfaces where chaining 5+ tool calls in parallel is unreliable; works equally well from Claude.
+- **`examples` tool** *(v1.0.5)* — pre-filled JSON inputs for heavy-schema tools (CEA, BIA, survival, MAIC, Bucher) plus a `maic_workflow_recipe` multi-step prompt template for ChatGPT users.
+- **CMS IRA awareness** — when `pv_classify` is called with US jurisdiction, output explicitly notes that CMS IRA Medicare price-negotiation calculations exclude PV cost data — track those obligations in the regulatory budget, not the HEOR cost-effectiveness model.
+- **GRADE I²-based inconsistency, GRADE upgrading (Guyatt 2011), Bucher consistency check, EQ-5D 5L baseline-utility-aware impact** *(v1.0.4)* — see [CHANGELOG.md](./CHANGELOG.md).
+- **ChatGPT Custom GPT support** *(v1.0.4)* — OpenAPI 3.1 adapter at `/api/openapi` lets you build a Custom GPT in 5 minutes. See [ChatGPT Custom GPT](#chatgpt-custom-gpt) below.
+- **Surface-tagged analytics** *(v1.0.4)* — every `tool_call` PostHog event carries a `surface` property (`claude_anthropic_web` / `chatgpt_adapter` / `claude_desktop` / `direct_mcp`).
+
+See [CHANGELOG.md](./CHANGELOG.md) for the full diff.
+
 ---
 
-## Tools (22)
+## Tools (27)
 
 | Tool | Purpose |
 |------|---------|

package/dist/icf/jargon.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Curated medical-jargon dictionary for ICF readability checking.
+ *
+ * Built from common patterns flagged in NIH Plain Language ICF
+ * guidance, FDA's "Communicating Risks and Benefits" guidance, and
+ * the most-frequently-cited offenders in IRB consent-form audits.
+ *
+ * Each entry maps a clinical-trial term to a plain-language alternative
+ * and (optionally) a one-line rationale. Matching is case-insensitive
+ * with whole-word boundaries (so "co-administered" doesn't match
+ * "co-author").
+ *
+ * v1 covers ~80 high-frequency terms. Future revs can grow this without
+ * any code change.
+ */
+import type { JargonHit } from "./types.js";
+export interface JargonEntry {
+    term: string;
+    plain_language: string;
+    rationale?: string;
+}
+export declare const JARGON_DICTIONARY: ReadonlyArray<JargonEntry>;
+/**
+ * Find all jargon hits in a body of text. Whole-word, case-insensitive.
+ * Returns one JargonHit per dictionary entry that matches at least once,
+ * with up to 5 occurrence offsets per term (capped to keep the output
+ * compact for repeated terms).
+ */
+export declare function findJargon(text: string): JargonHit[];
+//# sourceMappingURL=jargon.d.ts.map

package/dist/icf/jargon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jargon.d.ts","sourceRoot":"","sources":["../../src/icf/jargon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,WAAW,CAsLxD,CAAC;AASF;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAgCpD"}

package/dist/icf/jargon.js

@@ -0,0 +1,233 @@
+/**
+ * Curated medical-jargon dictionary for ICF readability checking.
+ *
+ * Built from common patterns flagged in NIH Plain Language ICF
+ * guidance, FDA's "Communicating Risks and Benefits" guidance, and
+ * the most-frequently-cited offenders in IRB consent-form audits.
+ *
+ * Each entry maps a clinical-trial term to a plain-language alternative
+ * and (optionally) a one-line rationale. Matching is case-insensitive
+ * with whole-word boundaries (so "co-administered" doesn't match
+ * "co-author").
+ *
+ * v1 covers ~80 high-frequency terms. Future revs can grow this without
+ * any code change.
+ */
+export const JARGON_DICTIONARY = [
+    // Trial-design terminology
+    { term: "randomized", plain_language: "assigned by chance" },
+    { term: "randomised", plain_language: "assigned by chance" },
+    {
+        term: "double-blind",
+        plain_language: "neither you nor your study doctor will know which group you are in",
+    },
+    {
+        term: "single-blind",
+        plain_language: "you will not know which group you are in",
+    },
+    {
+        term: "placebo",
+        plain_language: "an inactive substance with no medicine in it",
+    },
+    {
+        term: "open-label",
+        plain_language: "you and the study doctor will both know which medicine you are taking",
+    },
+    {
+        term: "crossover",
+        plain_language: "you will switch from one treatment to the other partway through",
+    },
+    { term: "stratified", plain_language: "grouped by certain characteristics" },
+    { term: "cohort", plain_language: "group of people in the study" },
+    { term: "arm", plain_language: "treatment group" },
+    { term: "intervention", plain_language: "the treatment being studied" },
+    { term: "comparator", plain_language: "the treatment being compared" },
+    // Adverse events / safety
+    {
+        term: "adverse event",
+        plain_language: "side effect or unwanted health problem",
+    },
+    { term: "adverse reaction", plain_language: "side effect" },
+    {
+        term: "serious adverse event",
+        plain_language: "serious side effect (one that is life-threatening, requires hospital care, or causes lasting harm)",
+    },
+    { term: "SAE", plain_language: "serious side effect" },
+    {
+        term: "SUSAR",
+        plain_language: "an unexpected serious side effect that may be related to the study drug",
+    },
+    { term: "untoward", plain_language: "unwanted or unexpected" },
+    // Pharmacology
+    {
+        term: "pharmacokinetics",
+        plain_language: "how the medicine moves through your body",
+    },
+    {
+        term: "pharmacodynamics",
+        plain_language: "how the medicine works in your body",
+    },
+    {
+        term: "bioavailability",
+        plain_language: "how much of the medicine your body absorbs",
+    },
+    {
+        term: "half-life",
+        plain_language: "how long the medicine stays in your body",
+    },
+    {
+        term: "metabolite",
+        plain_language: "a substance your body makes from the medicine",
+    },
+    {
+        term: "metabolism",
+        plain_language: "how your body breaks down the medicine",
+    },
+    // Disease / clinical
+    { term: "etiology", plain_language: "cause" },
+    { term: "aetiology", plain_language: "cause" },
+    { term: "prognosis", plain_language: "likely course of the disease" },
+    {
+        term: "comorbidity",
+        plain_language: "another health condition you have",
+    },
+    { term: "comorbidities", plain_language: "other health conditions" },
+    { term: "concomitant", plain_language: "at the same time" },
+    { term: "exacerbation", plain_language: "flare-up or worsening" },
+    { term: "remission", plain_language: "the disease is under control" },
+    {
+        term: "refractory",
+        plain_language: "not responding to standard treatment",
+    },
+    { term: "neoplasm", plain_language: "tumor" },
+    { term: "malignant", plain_language: "cancerous" },
+    { term: "benign", plain_language: "not cancerous" },
+    {
+        term: "metastasis",
+        plain_language: "the cancer has spread to another part of the body",
+    },
+    { term: "metastatic", plain_language: "cancer that has spread" },
+    {
+        term: "in situ",
+        plain_language: "in its original place; has not spread",
+    },
+    // Statistical / measurement
+    {
+        term: "biomarker",
+        plain_language: "a measurement we use to track disease or treatment",
+    },
+    { term: "endpoint", plain_language: "outcome we are measuring" },
+    {
+        term: "primary endpoint",
+        plain_language: "the main outcome we are measuring",
+    },
+    {
+        term: "secondary endpoint",
+        plain_language: "additional outcome we are measuring",
+    },
+    {
+        term: "efficacy",
+        plain_language: "how well the treatment works under controlled conditions",
+    },
+    // v1.9.1 fix: removed an "effectiveness" entry here. NIH Plain Language
+    // ICF guidance and FDA Communicating Risks and Benefits recommend
+    // "effectiveness" AS the plain-language replacement for "efficacy" —
+    // flagging it as jargon contradicts the cited authority and would tell
+    // investigators who did the right thing to undo it.
+    { term: "incidence", plain_language: "how often new cases occur" },
+    {
+        term: "prevalence",
+        plain_language: "how many people have the condition right now",
+    },
+    {
+        term: "statistical significance",
+        plain_language: "the difference is unlikely to be due to chance",
+    },
+    {
+        term: "confidence interval",
+        plain_language: "the likely range of the true value",
+    },
+    // Procedures
+    {
+        term: "venipuncture",
+        plain_language: "blood draw with a needle",
+    },
+    { term: "phlebotomy", plain_language: "drawing blood" },
+    { term: "lumbar puncture", plain_language: "spinal tap" },
+    { term: "biopsy", plain_language: "taking a small tissue sample" },
+    { term: "intravenous", plain_language: "given through a vein" },
+    { term: "subcutaneous", plain_language: "given under the skin" },
+    { term: "intramuscular", plain_language: "given into a muscle" },
+    { term: "oral", plain_language: "by mouth" },
+    { term: "topical", plain_language: "applied to the skin" },
+    { term: "ophthalmic", plain_language: "for the eye" },
+    { term: "ocular", plain_language: "of the eye" },
+    // Regulatory / consent-specific
+    {
+        term: "informed consent",
+        plain_language: "your decision to take part after learning about the study",
+    },
+    { term: "withdrawal", plain_language: "leaving the study" },
+    { term: "discontinuation", plain_language: "stopping" },
+    { term: "compensation", plain_language: "payment" },
+    { term: "reimbursement", plain_language: "money back for your costs" },
+    { term: "remuneration", plain_language: "payment for your time" },
+    { term: "ascertain", plain_language: "find out" },
+    { term: "elucidate", plain_language: "explain" },
+    { term: "facilitate", plain_language: "help" },
+    { term: "utilize", plain_language: "use" },
+    { term: "utilise", plain_language: "use" },
+    { term: "demonstrate", plain_language: "show" },
+    { term: "subsequent", plain_language: "later" },
+    { term: "prior to", plain_language: "before" },
+    { term: "in the event that", plain_language: "if" },
+    { term: "in conjunction with", plain_language: "with" },
+    { term: "due to the fact that", plain_language: "because" },
+    { term: "at this point in time", plain_language: "now" },
+];
+/**
+ * Escape regex metacharacters for safe inclusion in a constructed pattern.
+ */
+function escapeRegex(s) {
+    return s.replace(/[\\^$.*+?()[\]{}|]/g, "\\$&");
+}
+/**
+ * Find all jargon hits in a body of text. Whole-word, case-insensitive.
+ * Returns one JargonHit per dictionary entry that matches at least once,
+ * with up to 5 occurrence offsets per term (capped to keep the output
+ * compact for repeated terms).
+ */
+export function findJargon(text) {
+    if (!text)
+        return [];
+    const lower = text.toLowerCase();
+    const hits = [];
+    for (const entry of JARGON_DICTIONARY) {
+        const term = entry.term.toLowerCase();
+        // Optional trailing "s" handles English plurals: "adverse event"
+        // matches "adverse events", "biomarker" matches "biomarkers", etc.
+        // Harmless on terms with no plural form (e.g., "in situ"). Doesn't
+        // cover irregular plurals like "metastasis → metastases" — those
+        // get separate dictionary entries when frequent.
+        const pattern = new RegExp(`\\b${escapeRegex(term)}s?\\b`, "gi");
+        const matches = Array.from(lower.matchAll(pattern));
+        if (matches.length === 0)
+            continue;
+        const occurrences = [];
+        for (const m of matches.slice(0, 5)) {
+            const idx = m.index ?? 0;
+            occurrences.push({
+                index: idx,
+                matched_form: text.slice(idx, idx + m[0].length),
+            });
+        }
+        hits.push({
+            term: entry.term,
+            occurrences,
+            plain_language: entry.plain_language,
+            rationale: entry.rationale,
+        });
+    }
+    return hits;
+}
+//# sourceMappingURL=jargon.js.map

package/dist/icf/jargon.js.map

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

package/dist/icf/readability.d.ts

@@ -0,0 +1,18 @@
+import type { DocumentStats, ReadabilityScores } from "./types.js";
+export declare function splitSentences(text: string): string[];
+export declare function tokenizeWords(sentence: string): string[];
+export declare function computeStats(text: string): {
+    stats: DocumentStats;
+    sentenceTokens: Array<{
+        raw: string;
+        words: string[];
+        syllables: number;
+        complex: number;
+    }>;
+};
+export declare function fleschKincaidGrade(stats: DocumentStats): number;
+export declare function fleschReadingEase(stats: DocumentStats): number;
+export declare function gunningFog(stats: DocumentStats): number;
+export declare function smog(stats: DocumentStats): number;
+export declare function computeReadabilityScores(stats: DocumentStats): ReadabilityScores;
+//# sourceMappingURL=readability.d.ts.map

package/dist/icf/readability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readability.d.ts","sourceRoot":"","sources":["../../src/icf/readability.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA6BnE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAwCrD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAMxD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAC1C,KAAK,EAAE,aAAa,CAAC;IACrB,cAAc,EAAE,KAAK,CAAC;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ,CAkCA;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAO/D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAO9D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAOvD;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CASjD;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,aAAa,GACnB,iBAAiB,CAOnB"}

package/dist/icf/readability.js

@@ -0,0 +1,156 @@
+/**
+ * Readability formulas: Flesch-Kincaid Grade Level, Flesch Reading
+ * Ease, Gunning Fog Index, SMOG Grade.
+ *
+ * All four standard formulas in one place so the tool can report a
+ * cross-validated readability picture (no single score is perfect;
+ * disagreements between FKGL and SMOG often signal text with unusual
+ * sentence-vs-word complexity tradeoffs).
+ *
+ * References:
+ * - Kincaid, Fishburne, Rogers, Chissom (1975). FKGL.
+ * - Flesch (1948). Reading Ease.
+ * - Gunning (1952). Fog Index.
+ * - McLaughlin (1969). SMOG.
+ */
+import { countSyllables, countComplexWord } from "./syllables.js";
+/**
+ * Split into sentences using punctuation as terminators. Handles common
+ * abbreviations (Dr., Mr., e.g., i.e.) by NOT splitting on them.
+ */
+const ABBREV = new Set([
+    "dr",
+    "mr",
+    "mrs",
+    "ms",
+    "prof",
+    "st",
+    "co",
+    "ltd",
+    "inc",
+    "corp",
+    "vs",
+    "etc",
+    "e.g",
+    "i.e",
+    "fig",
+    "vol",
+    "pp",
+    "no",
+    "ed",
+    "eds",
+]);
+export function splitSentences(text) {
+    if (!text || text.trim().length === 0)
+        return [];
+    // Normalise newlines and bullets to sentence terminators.
+    const normalised = text.replace(/\s+/g, " ").trim();
+    const candidates = [];
+    let start = 0;
+    for (let i = 0; i < normalised.length; i++) {
+        const ch = normalised[i];
+        if (ch === "." || ch === "!" || ch === "?") {
+            // Look-back for known abbreviation immediately before the period.
+            const prevWord = normalised
+                .slice(Math.max(0, i - 8), i)
+                .toLowerCase()
+                .match(/[a-z.]+$/)?.[0];
+            if (ch === "." &&
+                prevWord &&
+                ABBREV.has(prevWord.replace(/\.$/, ""))) {
+                continue; // skip — abbreviation, not a sentence end
+            }
+            // Look-ahead — must be followed by whitespace+capital or EOS.
+            const next = normalised[i + 1];
+            const next2 = normalised[i + 2];
+            if (i === normalised.length - 1 ||
+                (next === " " &&
+                    next2 &&
+                    (next2 === next2.toUpperCase() || /[0-9"(]/.test(next2)))) {
+                candidates.push(normalised.slice(start, i + 1).trim());
+                start = i + 1;
+            }
+        }
+    }
+    if (start < normalised.length) {
+        const tail = normalised.slice(start).trim();
+        if (tail.length > 0)
+            candidates.push(tail);
+    }
+    return candidates.filter((s) => s.length > 0);
+}
+export function tokenizeWords(sentence) {
+    return sentence
+        .replace(/[^a-zA-Z\s'-]/g, " ")
+        .split(/\s+/)
+        .map((w) => w.trim())
+        .filter((w) => w.length > 0 && /[a-zA-Z]/.test(w));
+}
+export function computeStats(text) {
+    const sentences = splitSentences(text);
+    const sentenceTokens = sentences.map((raw) => {
+        const words = tokenizeWords(raw);
+        const syllables = words.reduce((sum, w) => sum + countSyllables(w), 0);
+        const complex = words.reduce((sum, w) => sum + (countComplexWord(w) ? 1 : 0), 0);
+        return { raw, words, syllables, complex };
+    });
+    const totalSentences = sentenceTokens.length;
+    const totalWords = sentenceTokens.reduce((s, t) => s + t.words.length, 0);
+    const totalSyllables = sentenceTokens.reduce((s, t) => s + t.syllables, 0);
+    const complexWords = sentenceTokens.reduce((s, t) => s + t.complex, 0);
+    const avgSentenceLength = totalSentences > 0 ? totalWords / totalSentences : 0;
+    const avgSyllablesPerWord = totalWords > 0 ? totalSyllables / totalWords : 0;
+    return {
+        stats: {
+            total_sentences: totalSentences,
+            total_words: totalWords,
+            total_syllables: totalSyllables,
+            complex_words: complexWords,
+            avg_sentence_length: avgSentenceLength,
+            avg_syllables_per_word: avgSyllablesPerWord,
+        },
+        sentenceTokens,
+    };
+}
+export function fleschKincaidGrade(stats) {
+    if (stats.total_sentences === 0 || stats.total_words === 0)
+        return 0;
+    return (0.39 * stats.avg_sentence_length +
+        11.8 * stats.avg_syllables_per_word -
+        15.59);
+}
+export function fleschReadingEase(stats) {
+    if (stats.total_sentences === 0 || stats.total_words === 0)
+        return 0;
+    return (206.835 -
+        1.015 * stats.avg_sentence_length -
+        84.6 * stats.avg_syllables_per_word);
+}
+export function gunningFog(stats) {
+    if (stats.total_sentences === 0 || stats.total_words === 0)
+        return 0;
+    return (0.4 *
+        (stats.avg_sentence_length +
+            100 * (stats.complex_words / stats.total_words)));
+}
+export function smog(stats) {
+    // SMOG was designed for ≥30 sentences; for shorter text we still
+    // apply the formula but note in the markdown that SMOG is unreliable
+    // below 30 sentences.
+    if (stats.total_sentences === 0)
+        return 0;
+    return (1.043 * Math.sqrt((stats.complex_words * 30) / stats.total_sentences) +
+        3.1291);
+}
+export function computeReadabilityScores(stats) {
+    return {
+        flesch_kincaid_grade: round1(fleschKincaidGrade(stats)),
+        flesch_reading_ease: round1(fleschReadingEase(stats)),
+        gunning_fog: round1(gunningFog(stats)),
+        smog: round1(smog(stats)),
+    };
+}
+function round1(x) {
+    return Math.round(x * 10) / 10;
+}
+//# sourceMappingURL=readability.js.map

package/dist/icf/readability.js.map

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

package/dist/icf/syllables.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Syllable counting heuristic.
+ *
+ * No dependency on a phonetic dictionary (CMU Pronouncing Dict etc.) —
+ * a deterministic rule-based counter that gets within ±1 of the truth
+ * for ~95% of English words. Sufficient for readability scoring where
+ * aggregate stats matter more than per-word precision.
+ *
+ * Algorithm (lowercase the word first):
+ *   1. Remove leading/trailing non-alpha, drop possessive.
+ *   2. Count vowel groups (one or more contiguous a/e/i/o/u/y).
+ *   3. Subtract one for a silent terminal "e" (but not "le" — table = 2).
+ *   4. Floor at 1 syllable per non-empty word.
+ *
+ * Special cases handled: words ending in "-le" preceded by a consonant
+ * count an extra syllable ("table"=2, "simple"=2). Words ending in "-ed"
+ * after a non-d/t consonant are silent ("walked"=1, but "added"=2).
+ */
+export declare function countSyllables(rawWord: string): number;
+export declare function countComplexWord(word: string): boolean;
+//# sourceMappingURL=syllables.d.ts.map

package/dist/icf/syllables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syllables.d.ts","sourceRoot":"","sources":["../../src/icf/syllables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAwCtD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAkCtD"}