# Changelog

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

The format is based on [Keep a Changelog](https://keepachangelog.com/).

## [0.2.0] — 2026-04-01

### Added

- **Institutional validators**: PlaceOfServiceValidator, TaxonomyValidator, ModifierCompatibilityValidator, ConditionCodeValidator, ValueCodeValidator
- **Institutional API**: `validate_institutional()` for UB-04 / 837I claim validation
- **Async / batch API**: `validate_async()`, `validate_batch()`, `validate_batch_async()` with concurrency control and stop-on-first-error
- **Expanded code tables**: ICD-10-CM (2,554 codes), expanded HCPCS/CPT, Taxonomy (624 codes)
- **Timely filing**: expanded payer table from 11 to 58 US payers covering major insurers, regional plans, and marketplace carriers
- **AI confidence scores**: `confidence` field exposed in `Finding.context` for CoverageCheckAI and PriorAuthAI outputs

### Improved

- **AI validator prompts**: CodeValidationAI now checks mutually exclusive diagnoses, sequencing errors, and placeholder/unspecified codes; CoverageCheckAI checks frequency limitations and site-of-service concerns; PriorAuthAI checks step therapy requirements and quantity/duration limits

## [Unreleased]

### Added

- Project scaffolding with src layout, hatchling build backend, and hatch-vcs versioning
- Package skeleton with all subpackage stubs
- Development tooling: ruff, mypy, pytest configuration
