Skip to content

CHANGELOG.md

Latest commit

 

History

History
180 lines (144 loc) · 8.74 KB

CHANGELOG.md

File metadata and controls

180 lines (144 loc) · 8.74 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

1.6.2 - 2026-03-19

Changed

  • Tightened the production readiness gate so production deployments without transport security fail readiness instead of only warning
  • Corrected stale registry-count assertions to follow the expanded 151-calculator catalog
  • Normalized generated REST API documentation to use the server root as the base URL and emit markdown-lint-friendly section formatting

Fixed

  • Rejected unsupported opioid names in the MME calculator instead of silently defaulting to a morphine-equivalent factor of 1.0
  • Realigned the MME calculator public opioid type surface with the supported conversion table and sorted the published support list deterministically
  • Added regression coverage for unsupported MME opioid names and TLS-gated production readiness

1.6.0 - 2026-03-19

Added

  • 151 clinical calculators across 31 primary specialties with expanded evidence-backed screening, sleep, palliative, nutrition, psychiatry, and geriatrics coverage
  • Production readiness framework with readiness report generation, CLI validation, API metadata support, and security-profile checks
  • MedCalc-Bench evaluation pipeline with benchmarking utilities, sample dataset, sample report, and automated tests
  • Registry-backed documentation generation for calculator catalog, guideline coverage, specialty coverage gap analysis, OpenAPI snapshot, and REST API reference
  • Dependency governance and automation through Dependabot lanes, lockfile refresh workflow, git hooks, and commit message validation
  • 2,067 collected tests with updated readiness and release coverage

Changed

  • Hardened MCP discovery, guidance, and calculator handling flows around the active high-level and low-level registry metadata model
  • Regenerated docs/ and docs_site/ release artifacts for version 1.6.0
  • Tightened project consistency checks, formula provenance validation, project metadata handling, fuzzy matching, and smart input normalization
  • Updated CI and contributor workflows to use frozen uv dependency flows and stricter review lanes

Fixed

  • Corrected stale documentation quality snapshots so release consistency checks pass against current calculator, citation, and test counts
  • Cleaned up lint-sensitive formatting in batch-maintained modules to stabilize CI

1.5.0 - 2026-01-08

Added

  • 121 MCP Calculators: Expanded from 103 to 121 clinical calculators (+18)
  • Phase 26 - Endocrinology (5 new tools):
    • FINDRISC (Finnish Diabetes Risk Score)
    • NDS (Neuropathy Disability Score)
    • Toronto CSS (Clinical Scoring System for Diabetic Polyneuropathy)
    • CAS (Clinical Activity Score for Graves' Ophthalmopathy)
    • Cushingoid Score
  • Phase 27 - Urology (4 new tools):
    • IPSS (International Prostate Symptom Score)
    • ICIQ-SF (Urinary Incontinence Severity)
    • STONE Score (Ureteral Stone Prediction)
    • Bosniak Classification (Renal Cyst Malignancy Risk)
  • Phase 28 - OB/GYN (3 new tools):
    • EPDS (Edinburgh Postnatal Depression Scale)
    • POP-Q (Pelvic Organ Prolapse Quantification)
    • sFlt-1/PlGF Ratio (Preeclampsia Biomarker)
  • Phase 30 - Geriatrics (6 new tools):
    • CFS (Clinical Frailty Scale)
    • MMSE (Mini-Mental State Examination)
    • MoCA (Montreal Cognitive Assessment)
    • TUG (Timed Up and Go Test)
    • Barthel Index (ADL Assessment)
    • MNA (Mini Nutritional Assessment)
  • 1,721 Tests: Comprehensive test coverage maintained

Changed

  • Updated test assertions for new calculator count (121 total)
  • Improved specialty coverage across Endocrinology, Urology, OB/GYN, and Geriatrics

1.2.0 - 2026-01-06

Added

  • 82 MCP Tools: Expanded library to 75 clinical calculators and 7 discovery tools.
  • 1,566 Tests: Reached 92% code coverage with a comprehensive unit and E2E test suite.
  • uv Package Management: Migrated from pip to uv for faster and more reliable dependency management.
  • Strict Type Safety: Achieved 100% mypy --strict coverage across the entire codebase (src, tests, examples, scripts).
  • Internationalization: Split documentation into English (README.md) and Traditional Chinese (README.zh-TW.md).
  • Modernized Tooling: Integrated ruff for linting and formatting.

Changed

  • CI/CD Pipeline: Enhanced GitHub Actions with uv and enforced a 90% coverage threshold.
  • Project Structure: Updated pyproject.toml to use hatchling as build backend.
  • MCP Entry Point: Unified MCP server entry point to src.main.
  • Docker Image: Updated Dockerfile to v1.2.0 using uv for multi-stage builds.
  • MCP Debugging: Optimized logging to stderr for better compatibility with MCP clients.
  • VS Code Integration: Updated .vscode/mcp.json to follow the latest Copilot MCP server configuration standards.

Fixed

  • Resolved hundreds of type-hinting issues and potential null-pointer exceptions.
  • Fixed regression in MCP calculator handlers where return keys were inconsistent.
  • Corrected Windows-specific paths in .vscode/settings.json for Linux compatibility.

1.1.0 - 2025-12-09

Added

  • Comprehensive E2E Test Suite: 697 E2E tests covering all 75 medical calculators
    • 77 test files in tests/e2e/ directory
    • One test file per calculator with multiple clinical scenarios
    • Tests cover normal cases, edge cases, and error handling
    • Full coverage of parameter validation

Changed

  • Test Count: 1639 total tests (was ~940)
    • E2E tests: 697 (new)
    • Unit tests: 940 (existing)
  • Test Coverage: Comprehensive REST API endpoint testing

Fixed

  • Multiple E2E test parameter fixes to match actual calculator implementations:
    • tbsa: Corrected body region parameters (chest, abdomen, thigh vs anterior_trunk)
    • timi_stemi: Fixed parameter names and types (age_years, killip_class, booleans)
    • news2_score: Fixed consciousness AVPU values ("A", "C" vs "alert", "confusion")
    • transfusion_calc: Corrected assertion for mL output
    • And 20+ other calculators with parameter/assertion fixes

1.0.0 - 2025-12-03

Added

  • 75 Medical Calculators across 12 specialties
  • MCP Server with FastMCP SDK integration
  • REST API with Starlette/Uvicorn
  • Docker Support with docker-compose.yml and HTTPS configuration
  • Security Features: Optional rate limiting and API key authentication
  • Tool Discovery: Two-level key system (Low/High Level) for AI tool selection
  • DDD Architecture: Clean onion architecture with domain-driven design

Specialties Covered

  • Anesthesiology/Preoperative (ASA-PS, Mallampati, STOP-BANG, Aldrete, etc.)
  • Critical Care/ICU (APACHE II, SOFA, qSOFA, SAPS II, etc.)
  • Pediatrics (Pediatric GCS, PEWS, PIM3, APGAR, etc.)
  • Nephrology (eGFR-CKD-EPI, Cockcroft-Gault, KDIGO-AKI, etc.)
  • Pulmonology (A-a Gradient, CURB-65, PSI/PORT, ROX Index, etc.)
  • Cardiology (CHA₂DS₂-VASc, HAS-BLED, HEART Score, TIMI, etc.)
  • Hematology (4Ts HIT, PLASMIC, DIC Score, Transfusion Calc)
  • Emergency Medicine (Wells DVT/PE, Canadian C-Spine, etc.)
  • Hepatology (Child-Pugh, MELD, MELD-Na, etc.)
  • Acid-Base/Metabolic (Anion Gap, Osmolar Gap, Winters Formula, etc.)
  • Neurology (GCS, NIHSS, Hunt & Hess, Fisher Grade, ICH Score)
  • Trauma/Surgery (ISS, TBSA, Parkland Formula, MABL)

Technical Features

  • 1566 tests with 92% code coverage
  • Fully migrated to uv for dependency management
  • Type-safe Python with dataclass entities
  • Evidence-based formulas with paper citations (Vancouver style)
  • Bilingual documentation (English/Chinese)

Version History

Version Date Highlights
1.6.2 2026-03-19 MME safety fix, TLS-gated readiness, stale test cleanup, REST docs correction
1.6.0 2026-03-19 151 calculators, readiness checks, benchmark pipeline, release automation
1.5.0 2026-01-08 121 calculators, Phase 26-30 complete
1.2.0 2026-01-06 82 MCP tools, uv migration
1.1.0 2025-12-09 697 E2E tests, comprehensive API testing
1.0.0 2025-12-03 Initial release, 75 calculators