roadmap.json

{
  "$schema": "https://raw.githubusercontent.com/k3rt4s/medbill-dispute-kit/main/schemas/roadmap.schema.json",
  "project": "medbill-dispute-kit",
  "description": "LLM-droppable instruction toolkit for analyzing US medical bills, deduplicating follow-up statements, and running a months-long dispute process",
  "repository": "https://github.com/k3rt4s/medbill-dispute-kit",
  "license": "MIT",
  "updated": "2026-05-22",
  "patches": [
    {
      "id": "fix-wc-auto-form-label-false-positive",
      "title": "Fix WC / auto detector false positive on form-label checkbox blocks",
      "description": "scripts/draft_letters_by_state.py now strips 'Please indicate if applicable:' form-label blocks before counting WC_INJURY_RE / AUTO_INJURY_RE keyword hits, so UB-04 / CMS-1500 / Imagine-Pay style bill templates no longer mis-route to WC carrier redirect or auto-medpay letters.",
      "status": "implemented",
      "release": { "version": "v0.13.1", "date": "2026-05-21" }
    },
    {
      "id": "workstation-config-toml",
      "title": "Workstation-local overrides via kit_config.toml at HEALTHBILLS_ROOT",
      "description": "ALWAYS_SKIP_SLUGS, FOLDER_TEMPLATE_OVERRIDES, and BILLER_STATE_OVERRIDES now load from <HEALTHBILLS_ROOT>/kit_config.toml (override path via MEDBILL_KIT_CONFIG_FILE). Removes the recurring 'do not commit this hunk' risk on workstation-tuned kits; the public sources ship with safe empty defaults and the actual values live outside any tracked tree.",
      "status": "implemented",
      "release": { "version": "v0.13.2", "date": "2026-05-22" }
    },
    {
      "id": "fix-tracker-schema-and-template",
      "title": "Fix duplicate next_action in tracker.toml and regenerate tracker_template.csv",
      "description": "schemas/tracker.toml had next_action declared twice (the v0.13.0 state-machine work appended a second block instead of editing the original); merged the enum description into the original block and removed the duplicate. tracker/tracker_template.csv was still on the v0.1 22-column schema after v0.13.x added 31 columns; regenerated from the schema's authoritative column order so scripts/validate_tracker.py passes in CI.",
      "status": "implemented",
      "release": { "version": "v0.13.3", "date": "2026-05-22" }
    }
  ],
  "features": [
    {
      "id": "kit-scaffold",
      "title": "Initial kit scaffold",
      "description": "LLM operating layer, methodology rules, federal-law references, schemas, letter templates, tracker template",
      "status": "implemented",
      "release": { "version": "v0.1.0", "date": "2026-05-18" }
    },
    {
      "id": "state-tn",
      "title": "Tennessee state pack",
      "description": "Worked TN state-law layer including § 68-11-220 itemization, § 56-7-105 bad faith, § 56-2-305 dental, General Sessions small claims",
      "status": "implemented",
      "release": { "version": "v0.1.0", "date": "2026-05-18" }
    },
    {
      "id": "state-ga",
      "title": "Georgia state pack",
      "description": "Worked GA state-law layer with O.C.G.A. § 10-1-393(b)(14) automatic itemization, § 10-1-399 FBPA private right of action, § 33-4-6 bad faith, § 33-20E ground ambulance",
      "status": "implemented",
      "release": { "version": "v0.2.0", "date": "2026-05-18" }
    },
    {
      "id": "tpl-hardship",
      "title": "Hardship negotiation letter template",
      "description": "For correctly-billed but unaffordable charges; anchors to Medicare allowable rate, references IRS § 501(r)",
      "status": "implemented",
      "release": { "version": "v0.2.0", "date": "2026-05-18" }
    },
    {
      "id": "tpl-fdcpa-validation",
      "title": "FDCPA § 1692g validation request template",
      "description": "Third-party medical-debt collector validation within 30 days of first contact",
      "status": "implemented",
      "release": { "version": "v0.2.0", "date": "2026-05-18" }
    },
    {
      "id": "rule-ground-ambulance",
      "title": "Ground-ambulance rule and dispute template",
      "description": "Federal NSA explicitly excludes ground ambulance; state-by-state protection table + two-variant letter (state-protected vs unprotected)",
      "status": "implemented",
      "release": { "version": "v0.3.0", "date": "2026-05-18" }
    },
    {
      "id": "tpl-fap-application",
      "title": "IRS § 501(r) Financial Assistance Policy application template",
      "description": "For non-profit hospital bills; triggers § 1.501(r)-6 collection-action suspension during pendency",
      "status": "implemented",
      "release": { "version": "v0.3.0", "date": "2026-05-18" }
    },
    {
      "id": "tpl-cms-hpt-complaint",
      "title": "CMS Hospital Price Transparency complaint template",
      "description": "For hospitals not posting compliant machine-readable file under 45 CFR Part 180",
      "status": "implemented",
      "release": { "version": "v0.3.0", "date": "2026-05-18" }
    },
    {
      "id": "rule-ppdr-walkthrough",
      "title": "PPDR (Patient-Provider Dispute Resolution) walkthrough rule",
      "description": "Federal NSA self-pay arbitration process at nsa-idr.cms.gov; $25 filing fee, 120-day window, collection-pause during pendency",
      "status": "implemented",
      "release": { "version": "v0.3.0", "date": "2026-05-18" }
    },
    {
      "id": "state-ca",
      "title": "California state pack",
      "description": "Worked CA state-law layer with AB 72 surprise billing, IMR, Hospital Fair Pricing Act, AB 716 ground ambulance, SB 1061 credit-reporting",
      "status": "implemented",
      "release": { "version": "v0.4.0", "date": "2026-05-18" }
    },
    {
      "id": "state-tx",
      "title": "Texas state pack",
      "description": "Worked TX state-law layer with Chapter 541 private right of action, SB 1264 balance billing, SB 916 ground ambulance, TX Constitution wage-garnishment ban",
      "status": "implemented",
      "release": { "version": "v0.4.0", "date": "2026-05-18" }
    },
    {
      "id": "state-ny",
      "title": "New York state pack",
      "description": "Worked NY state-law layer with Fair Medical Debt Reporting Act, Consumer Credit Fairness Act, PHL § 2807-k(9-a) hospital FA at 400% FPL",
      "status": "implemented",
      "release": { "version": "v0.4.0", "date": "2026-05-18" }
    },
    {
      "id": "state-fl",
      "title": "Florida state pack",
      "description": "Worked FL state-law layer with § 624.155 Civil Remedy Notice, § 395.301 7-day itemization, HB 7089 3-year SOL on facility medical debt",
      "status": "implemented",
      "release": { "version": "v0.4.0", "date": "2026-05-18" }
    },
    {
      "id": "rule-medicare-appeals",
      "title": "Medicare five-level appeals track",
      "description": "Redetermination, QIC reconsideration, ALJ at OMHA, Appeals Council, federal court — for Parts A, B, C, D",
      "status": "implemented",
      "release": { "version": "v0.4.0", "date": "2026-05-18" }
    },
    {
      "id": "tpl-medicaid-appeal",
      "title": "Medicaid appeal template",
      "description": "Two-step process (MCO internal then state fair hearing) under 42 CFR § 438.402 with Aid Paid Pending and EPSDT block; TennCare worked example",
      "status": "implemented",
      "release": { "version": "v0.4.0", "date": "2026-05-18" }
    },
    {
      "id": "tpl-dental-dispute",
      "title": "Dental dispute template",
      "description": "Downcoding, bundling, frequency-limit denials, VCC objections; Tennessee § 56-2-305 worked example",
      "status": "implemented",
      "release": { "version": "v0.4.0", "date": "2026-05-18" }
    },
    {
      "id": "doc-glossary",
      "title": "Glossary",
      "description": "Plain-English definitions for every acronym used in the kit",
      "status": "implemented",
      "release": { "version": "v0.4.0", "date": "2026-05-18" }
    },
    {
      "id": "doc-faq",
      "title": "FAQ",
      "description": "20+ patient-facing questions covering kit use, deadlines, escalation, edge cases, contribution",
      "status": "implemented",
      "release": { "version": "v0.4.0", "date": "2026-05-18" }
    },
    {
      "id": "doc-llm-compatibility",
      "title": "LLM compatibility notes",
      "description": "Coverage of Claude, ChatGPT, Gemini, Llama, Qwen with context-window and vision guidance",
      "status": "implemented",
      "release": { "version": "v0.4.0", "date": "2026-05-18" }
    },
    {
      "id": "doc-quickstart-short-context",
      "title": "Short-context QUICKSTART",
      "description": "7-stage staged-load pattern for LLMs under 32k tokens",
      "status": "implemented",
      "release": { "version": "v0.4.0", "date": "2026-05-18" }
    },
    {
      "id": "doc-contributing",
      "title": "Contribution guidelines",
      "description": "PR guidelines with 12-section state-pack checklist, template-creation rules, schema-extension rules",
      "status": "implemented",
      "release": { "version": "v0.4.0", "date": "2026-05-18" }
    },
    {
      "id": "tool-validate-tracker",
      "title": "Tracker CSV validator script",
      "description": "Python 3.11+ stdlib-only validator with structural checks against the TOML schemas",
      "status": "implemented",
      "release": { "version": "v0.4.0", "date": "2026-05-18" }
    },
    {
      "id": "state-pa",
      "title": "Pennsylvania state pack",
      "description": "Worked PA state-law layer with 42 Pa.C.S. § 8371 bad faith (interest+punitives+fees+costs), § 8127 wage-garnishment exemption, UTPCPL/FCEUA original-creditor reach, Act 146 surprise billing",
      "status": "implemented",
      "release": { "version": "v0.5.0", "date": "2026-05-18" }
    },
    {
      "id": "state-il",
      "title": "Illinois state pack",
      "description": "Worked IL state-law layer with Hospital Uninsured Patient Discount Act (135% of cost cap), ICFA original-creditor reach with treble damages, 10-year SOL, Fair Patient Billing Act, SB 2405 ground ambulance",
      "status": "implemented",
      "release": { "version": "v0.5.0", "date": "2026-05-18" }
    },
    {
      "id": "state-oh",
      "title": "Ohio state pack",
      "description": "Worked OH state-law layer with OCSPA reach over hospitals post-Brakle, Hospital Care Assurance Program statutory free-care at 100% FPL, § 3902.50 ground ambulance, no general hospital-lien statute",
      "status": "implemented",
      "release": { "version": "v0.5.0", "date": "2026-05-18" }
    },
    {
      "id": "examples-multi-encounter",
      "title": "Multi-encounter worked example",
      "description": "Two hospital encounters, 7 bills, three sessions over six weeks demonstrating dedup, encounter linking, save/resume, settlement accounting",
      "status": "implemented",
      "release": { "version": "v0.5.0", "date": "2026-05-18" }
    },
    {
      "id": "examples-insurance-denial",
      "title": "Insurance-denial worked example",
      "description": "ERISA self-funded plan denial, internal appeal, external IRO review, parallel EBSA and state DOI complaints",
      "status": "implemented",
      "release": { "version": "v0.5.0", "date": "2026-05-18" }
    },
    {
      "id": "github-polish",
      "title": "GitHub repo polish",
      "description": "Issue templates (bug, state-pack request, content correction), PR template, SECURITY policy, CODE_OF_CONDUCT (Contributor Covenant 2.1)",
      "status": "implemented",
      "release": { "version": "v0.5.0", "date": "2026-05-18" }
    },
    {
      "id": "ci-tests",
      "title": "CI workflow and validator tests",
      "description": "GitHub Actions workflow runs validator and pytest; markdown link checker. 8 pytest cases covering happy path and error cases",
      "status": "implemented",
      "release": { "version": "v0.5.0", "date": "2026-05-18" }
    },
    {
      "id": "rule-emtala",
      "title": "EMTALA rule and complaint template",
      "description": "Federal emergency-care anti-dumping statute; CMS regulatory complaint route; civil action under § 1395dd(d)(2)(A)",
      "status": "implemented",
      "release": { "version": "v0.6.0", "date": "2026-05-18" }
    },
    {
      "id": "rule-hipaa-right-of-access",
      "title": "HIPAA right-of-access rule and OCR complaint template",
      "description": "45 CFR § 164.524; 30-day deadline, reasonable cost-based fee cap, OCR complaint within 180 days",
      "status": "implemented",
      "release": { "version": "v0.6.0", "date": "2026-05-18" }
    },
    {
      "id": "rule-auto-med-pay",
      "title": "Auto med-pay and accident-related billing rule",
      "description": "Med-pay / PIP / UM-UIM / hospital lien interactions for motor-vehicle accident billing",
      "status": "implemented",
      "release": { "version": "v0.6.0", "date": "2026-05-18" }
    },
    {
      "id": "tpl-auto-med-pay",
      "title": "Auto med-pay letter template (3 variants)",
      "description": "Demand to apply med-pay/PIP; demand to bill health insurance instead of relying on lien; challenge to perfected hospital lien",
      "status": "implemented",
      "release": { "version": "v0.6.0", "date": "2026-05-18" }
    },
    {
      "id": "rule-workers-comp",
      "title": "Workers' compensation rule",
      "description": "Balance-billing prohibition for accepted WC claims; state-specific statutes; coordination with health insurance for contested claims",
      "status": "implemented",
      "release": { "version": "v0.6.0", "date": "2026-05-18" }
    },
    {
      "id": "state-nc",
      "title": "North Carolina state pack",
      "description": "Worked NC state-law layer including § 75-1.1 UDPA with treble damages",
      "status": "implemented",
      "release": { "version": "v0.6.0", "date": "2026-05-18" }
    },
    {
      "id": "state-mi",
      "title": "Michigan state pack",
      "description": "Worked MI state-law layer including the no-fault auto-insurance interaction with medical billing",
      "status": "implemented",
      "release": { "version": "v0.6.0", "date": "2026-05-18" }
    },
    {
      "id": "state-wa",
      "title": "Washington state pack",
      "description": "Worked WA state-law layer with Charity Care Act (100% free care to 300% FPL), IFCA bad faith, Balance Billing Protection Act including ground ambulance",
      "status": "implemented",
      "release": { "version": "v0.6.0", "date": "2026-05-18" }
    },
    {
      "id": "state-nj",
      "title": "New Jersey state pack",
      "description": "Worked NJ state-law layer with Consumer Fraud Act (mandatory treble + fees), comprehensive state-funded charity care program, Out-of-Network Consumer Protection Act predating NSA, Louisa Carman Medical Debt Relief Act",
      "status": "implemented",
      "release": { "version": "v0.7.0", "date": "2026-05-18" }
    },
    {
      "id": "state-va",
      "title": "Virginia state pack",
      "description": "Worked VA state-law layer with VCPA treble damages, small-claims no-attorney rule, Balance Billing Protection Act with HB 730 ground ambulance, Va. Code § 59.1-444.4 medical-debt credit-reporting prohibition (2025), Medical Debt Protection Act 2026",
      "status": "implemented",
      "release": { "version": "v0.7.0", "date": "2026-05-18" }
    },
    {
      "id": "state-az",
      "title": "Arizona state pack",
      "description": "Worked AZ state-law layer with Proposition 209 (3% medical-debt interest cap + garnishment + homestead protections), Noble/Rawlings/Linthicum bad-faith trilogy, small-claims no-attorney rule, Abbott v. Banner hospital-lien customary-charges rule",
      "status": "implemented",
      "release": { "version": "v0.7.0", "date": "2026-05-18" }
    },
    {
      "id": "state-ma",
      "title": "Massachusetts state pack",
      "description": "Worked MA state-law layer with Chapter 93A mandatory 30-day demand-letter mechanic + mandatory treble damages + mandatory attorney's fees, Health Safety Net Program, Chapter 58 near-universal coverage context",
      "status": "implemented",
      "release": { "version": "v0.7.0", "date": "2026-05-18" }
    },
    {
      "id": "rule-bankruptcy",
      "title": "Bankruptcy and medical debt rule",
      "description": "Chapter 7 vs Chapter 13 decision-making, automatic stay under 11 U.S.C. § 362, coordination with other dispute tracks, Upsolve referral for simple cases",
      "status": "implemented",
      "release": { "version": "v0.7.0", "date": "2026-05-18" }
    },
    {
      "id": "examples-small-claims",
      "title": "Small claims walkthrough",
      "description": "Full worked Tennessee General Sessions filing for $310 walking-boot price-gouging dispute: filing decision, statement of claim, exhibits, hearing-day script, post-judgment collection",
      "status": "implemented",
      "release": { "version": "v0.7.0", "date": "2026-05-18" }
    },
    {
      "id": "tool-deadline-watch",
      "title": "Deadline-watcher script",
      "description": "scripts/deadline_watch.py reports overdue and upcoming bill actions from a tracker CSV with configurable window",
      "status": "implemented",
      "release": { "version": "v0.7.0", "date": "2026-05-18" }
    },
    {
      "id": "doc-start-here",
      "title": "START_HERE copy-paste quickstart",
      "description": "docs/START_HERE.md three-minute setup with copy-paste prompts for the 7 most common patient scenarios",
      "status": "implemented",
      "release": { "version": "v0.7.0", "date": "2026-05-18" }
    },
    {
      "id": "state-co",
      "title": "Colorado state pack",
      "description": "Worked CO state-law layer with Hospital Discounted Care Act (uninsured rate cap at Medicare/Medicaid average), § 10-3-1116 2x bad-faith with attorney's fees, § 25.5-4-414 ground ambulance 2025",
      "status": "implemented",
      "release": { "version": "v0.8.0", "date": "2026-05-18" }
    },
    {
      "id": "state-md",
      "title": "Maryland state pack",
      "description": "Worked MD state-law layer; HSCRC all-payer rate-setting system as the distinctive nationwide feature",
      "status": "implemented",
      "release": { "version": "v0.8.0", "date": "2026-05-18" }
    },
    {
      "id": "state-mo",
      "title": "Missouri state pack",
      "description": "Worked MO state-law layer with § 375.296 vexatious refusal-to-pay statute and 10-year SOL on written contracts",
      "status": "implemented",
      "release": { "version": "v0.8.0", "date": "2026-05-18" }
    },
    {
      "id": "state-mn",
      "title": "Minnesota state pack",
      "description": "Worked MN state-law layer with Minnesota Debt Fairness Act (2024), $20,000 no-attorney Conciliation Court, § 604.18 first-party bad-faith",
      "status": "implemented",
      "release": { "version": "v0.8.0", "date": "2026-05-18" }
    },
    {
      "id": "rule-tricare",
      "title": "TRICARE rule",
      "description": "Federal program for military beneficiaries: 15% balance-billing cap, active-duty zero-cost-share, BCAC referral, regional contractors",
      "status": "implemented",
      "release": { "version": "v0.8.0", "date": "2026-05-18" }
    },
    {
      "id": "rule-va-community-care",
      "title": "VA Community Care / MISSION Act rule",
      "description": "Direct-billing prohibition for VA-authorized community care; Optum/TriWest TPA routing; emergency-care 72-hour notification",
      "status": "implemented",
      "release": { "version": "v0.8.0", "date": "2026-05-18" }
    },
    {
      "id": "rule-telehealth",
      "title": "Telehealth billing rule",
      "description": "POS codes (02/10/11/22), modifiers 95/93, audio-only coding, telehealth parity laws, licensure-across-state-lines",
      "status": "implemented",
      "release": { "version": "v0.8.0", "date": "2026-05-18" }
    },
    {
      "id": "doc-decision-tree",
      "title": "DECISION_TREE.md quick-reference index",
      "description": "Single-page flowchart from 'what kind of bill' to 'which template applies' covering 14+ patient scenarios",
      "status": "implemented",
      "release": { "version": "v0.8.0", "date": "2026-05-18" }
    },
    {
      "id": "state-in",
      "title": "Indiana state pack",
      "description": "Worked IN state-law layer with Erie v. Hickman common-law bad-faith, 2023 HB 1004 price-transparency rules, Indiana DCSA",
      "status": "implemented",
      "release": { "version": "v0.9.0", "date": "2026-05-18" }
    },
    {
      "id": "state-wi",
      "title": "Wisconsin state pack",
      "description": "Worked WI state-law layer with Anderson v. Continental common-law bad-faith and punitive damages, OCI complaint channel",
      "status": "implemented",
      "release": { "version": "v0.9.0", "date": "2026-05-18" }
    },
    {
      "id": "state-sc",
      "title": "South Carolina state pack",
      "description": "Worked SC state-law layer with Nichols v. State Farm bad-faith doctrine, 3-year SOL, $7,500 Magistrate Court",
      "status": "implemented",
      "release": { "version": "v0.9.0", "date": "2026-05-18" }
    },
    {
      "id": "state-al",
      "title": "Alabama state pack",
      "description": "Worked AL state-law layer with Aetna v. Lavoie robust bad-faith doctrine and punitive damages",
      "status": "implemented",
      "release": { "version": "v0.9.0", "date": "2026-05-18" }
    },
    {
      "id": "rule-section-1557",
      "title": "ACA Section 1557 anti-discrimination rule",
      "description": "Federal civil-rights lever for language-access, disability-accommodation, and disparate-impact patterns; 45 CFR Part 92; HHS OCR complaint within 180 days",
      "status": "implemented",
      "release": { "version": "v0.9.0", "date": "2026-05-18" }
    },
    {
      "id": "rule-air-ambulance",
      "title": "Air ambulance rule",
      "description": "Federal NSA covers air ambulance (unlike ground); ADA preemption of state remedies; membership-program prevention pattern",
      "status": "implemented",
      "release": { "version": "v0.9.0", "date": "2026-05-18" }
    },
    {
      "id": "doc-common-outcomes",
      "title": "Common outcomes reference",
      "description": "Public-source typical-outcome figures by dispute track for expectation-setting",
      "status": "implemented",
      "release": { "version": "v0.9.0", "date": "2026-05-18" }
    },
    {
      "id": "doc-anti-patterns",
      "title": "Anti-patterns reference",
      "description": "20+ common patient-side mistakes with the right move for each",
      "status": "implemented",
      "release": { "version": "v0.9.0", "date": "2026-05-18" }
    },
    {
      "id": "state-ky",
      "title": "Kentucky state pack",
      "description": "Worked KY state-law layer with 15-year written-contract SOL, Reeder third-party UCSPA private RoA, Wittmer common-law bad faith",
      "status": "implemented",
      "release": { "version": "v0.10.0", "date": "2026-05-19" }
    },
    {
      "id": "state-or",
      "title": "Oregon state pack",
      "description": "Worked OR state-law layer with UTPA civil penalties + attorney's fees, ORS § 442.563 Hospital Financial Assistance, Balance Billing Protection Act",
      "status": "implemented",
      "release": { "version": "v0.10.0", "date": "2026-05-19" }
    },
    {
      "id": "state-ok",
      "title": "Oklahoma state pack",
      "description": "Worked OK state-law layer with Christian bad-faith doctrine and punitive damages, OK Consumer Protection Act original-creditor reach",
      "status": "implemented",
      "release": { "version": "v0.10.0", "date": "2026-05-19" }
    },
    {
      "id": "state-ct",
      "title": "Connecticut state pack",
      "description": "Worked CT state-law layer with CUTPA punitive damages + fees + class actions, state-mandated comprehensive hospital FA, CT Medical Debt Reform Act 2024",
      "status": "implemented",
      "release": { "version": "v0.10.0", "date": "2026-05-19" }
    },
    {
      "id": "rule-aca-marketplace",
      "title": "ACA marketplace plan appeal rule",
      "description": "45 CFR § 147.136 internal/external appeal framework with binding IRO decision, distinct from ERISA and Medicare tracks",
      "status": "implemented",
      "release": { "version": "v0.10.0", "date": "2026-05-19" }
    },
    {
      "id": "rule-observation-status",
      "title": "Medicare observation-status rule",
      "description": "Two-midnight rule, MOON notice, Condition Code 44 reclassification, SNF three-day rule, self-administered drug refunds, Alexander v. Becerra observation appeals",
      "status": "implemented",
      "release": { "version": "v0.10.0", "date": "2026-05-19" }
    },
    {
      "id": "doc-records-retention",
      "title": "Records retention guide",
      "description": "What paperwork to keep, where, for how long, with naming conventions and special cases",
      "status": "implemented",
      "release": { "version": "v0.10.0", "date": "2026-05-19" }
    },
    {
      "id": "state-ut",
      "title": "Utah state pack",
      "description": "Worked UT state-law layer with Beck v. Farmers bad-faith and UCSPA",
      "status": "implemented",
      "release": { "version": "v0.11.0", "date": "2026-05-19" }
    },
    {
      "id": "state-ia",
      "title": "Iowa state pack",
      "description": "Worked IA state-law layer with 10-year written-contract SOL and Dolan bad-faith",
      "status": "implemented",
      "release": { "version": "v0.11.0", "date": "2026-05-19" }
    },
    {
      "id": "state-nv",
      "title": "Nevada state pack",
      "description": "Worked NV state-law layer with NRS § 686A.310 private right of action and AB 469 surprise billing",
      "status": "implemented",
      "release": { "version": "v0.11.0", "date": "2026-05-19" }
    },
    {
      "id": "state-ar",
      "title": "Arkansas state pack",
      "description": "Worked AR state-law layer with Aetna v. Broadway Arms bad-faith and ADTPA private right of action",
      "status": "implemented",
      "release": { "version": "v0.11.0", "date": "2026-05-19" }
    },
    {
      "id": "doc-cpt-quick-reference",
      "title": "CPT/HCPCS quick reference",
      "description": "High-frequency codes for E/M, imaging, lab, procedures, surgical, ambulance, DME, J-codes with common modifiers and place-of-service codes",
      "status": "implemented",
      "release": { "version": "v0.11.0", "date": "2026-05-19" }
    },
    {
      "id": "doc-hpt-mrf-format",
      "title": "Hospital Price Transparency MRF format reference",
      "description": "CMS template format, discoverable-URL pattern, reading the CSV, common compliance failures, dispute-letter citation patterns",
      "status": "implemented",
      "release": { "version": "v0.11.0", "date": "2026-05-19" }
    },
    {
      "id": "state-ks",
      "title": "Kansas state pack",
      "description": "Worked KS state-law layer; no common-law first-party bad-faith tort (Spencer); KCPA with mandatory attorney's fees",
      "status": "implemented",
      "release": { "version": "v0.12.0", "date": "2026-05-19" }
    },
    {
      "id": "state-ms",
      "title": "Mississippi state pack",
      "description": "Worked MS state-law layer with Tighe v. Crosthwait bad-faith doctrine; no general hospital lien statute",
      "status": "implemented",
      "release": { "version": "v0.12.0", "date": "2026-05-19" }
    },
    {
      "id": "state-nm",
      "title": "New Mexico state pack",
      "description": "Worked NM state-law layer with Hovet v. Allstate UCSPA private right of action and Sloan bad faith; § 59A-57 includes ground ambulance",
      "status": "implemented",
      "release": { "version": "v0.12.0", "date": "2026-05-19" }
    },
    {
      "id": "state-ne",
      "title": "Nebraska state pack",
      "description": "Worked NE state-law layer with Braesch v. Union Ins. bad faith; County Court small claims at $3,900 with no attorneys",
      "status": "implemented",
      "release": { "version": "v0.12.0", "date": "2026-05-19" }
    },
    {
      "id": "doc-index",
      "title": "INDEX.md cross-reference map",
      "description": "Single-page navigation index covering all kit files by scenario, file type, federal law, and state",
      "status": "implemented",
      "release": { "version": "v0.12.0", "date": "2026-05-19" }
    },
    {
      "id": "doc-faq-refresh",
      "title": "FAQ refresh for v0.6–v0.11 features",
      "description": "18+ new FAQ entries covering EMTALA, HIPAA, auto med-pay, workers' comp, bankruptcy, TRICARE, VA, telehealth, ground/air ambulance, observation, ACA marketplace, Section 1557, plus process-and-tooling questions",
      "status": "implemented",
      "release": { "version": "v0.12.0", "date": "2026-05-19" }
    },
    {
      "id": "allen-price-benchmarking",
      "title": "Price benchmarking against Medicare PFS",
      "description": "Per-folder _benchmarks.csv with Medicare ratio, FAIR Health and Bluebook URLs; bundles ~150 codes at CY2025 national rates; drives the counter-offer gate",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-counter-offer",
      "title": "UCC 2-305 negotiated counter-offer template and drafter integration",
      "description": "letter_negotiation_counter_offer.md with embedded benchmark table; auto-computed counter at 200% Medicare (20% of balance fallback); state-machine branch in draft_letters_by_state.py",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-doi-portals",
      "title": "State DOI / AG portal directory and parallel complaint draft",
      "description": "references/doi_portals.md covers 35 states plus federal parallel filings; drafter emits COMPLAINT_DOI.md alongside the main letter",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-small-claims",
      "title": "Small-claims civil-warrant skeleton with five claim theories",
      "description": "templates/small_claims_civil_warrant.md county-agnostic; UCC 2-305, NSA, HPT, state itemization, FDCPA",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-billing-audit",
      "title": "Billing-error audit detector",
      "description": "scripts/audit_billing_errors.py emits _audit.csv from duplicate-CPT, NCCI unbundling, modifier-25, late-fee, service-not-received, quantity-inflation detectors",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-records-hipaa",
      "title": "HIPAA medical records request template",
      "description": "templates/letter_records_request_hipaa.md invoking 45 CFR 164.524 with state per-page fee caps and the 30-day statutory clock",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-gfe-ppdr",
      "title": "GFE request and PPDR initiate templates for the NSA self-pay path",
      "description": "templates/letter_good_faith_estimate_request.md and templates/letter_ppdr_initiate.md for uninsured / self-pay patients",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-lien-subrogation",
      "title": "Hospital lien challenge and subrogation response templates",
      "description": "templates/letter_challenge_hospital_lien.md (six grounds) and templates/letter_subrogation_response.md (made-whole, common-fund, allocation defenses)",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-fcra-credit",
      "title": "FCRA credit-report dispute template",
      "description": "templates/letter_credit_report_dispute_fcra.md with eight grounds (CFPB rule, bureau policies, state bans, active dispute, paid-by-insurance, identity theft, outdated)",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-idr-request",
      "title": "Insurer-IDR request template",
      "description": "templates/letter_request_insurer_initiate_idr.md demanding the plan initiate federal IDR while protecting patient cost-sharing at the in-network amount",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-encounter-clustering",
      "title": "Encounter clustering and combined dispute letter",
      "description": "check_completeness.py clusters bills with overlapping DOS into E-YYYY-NNN encounters; drafter emits a single LETTER_ENCOUNTER_COMBINED.md for encounters with 4+ billers and an EOB on file",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-action-log",
      "title": "Interaction log producer",
      "description": "scripts/log_interaction.py appends rows to actions.csv, validates against schemas/action.toml, refuses unknown bill_ids",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-evidence-bundle",
      "title": "Evidence bundler and cloud push",
      "description": "scripts/bundle_evidence.py zips per-dispute artifacts with MANIFEST.md; scripts/bundle_to_cloud.py pushes via rclone with --immutable",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-aging-ladder",
      "title": "Second-written-dispute (aging-letter ladder) template",
      "description": "templates/letter_dispute_reply.md for non-substantive responses; blocks A-E for the common reply patterns",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-sol-tracker",
      "title": "Medical-debt SOL tracking",
      "description": "references/sol_by_state.md plus deadline_watch.py --sol --state flag surfacing SOL-expired and SOL-approaching accounts",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-erisa-penalty",
      "title": "ERISA 502(c)(1) statutory-penalty template",
      "description": "templates/letter_erisa_502c_penalty.md computing $110/day from the 30-day window, with a 15-day cure period",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-wc-auto-routing",
      "title": "WC and auto med-pay payer redirect",
      "description": "templates/letter_wc_carrier_redirect.md plus drafter sidecar-keyword detection that routes accident_related and work_related_injury bills to the right redirect template in parallel with the dispute flow",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-state-debt-protection",
      "title": "State medical-debt protection summary",
      "description": "references/medical_debt_protection_by_state.md covering 15 states across credit-reporting, interest cap, charity-care screening, itemized-bill statute",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-irs-990",
      "title": "IRS Form 990 community-benefit review reference",
      "description": "references/irs_990_review.md describing Schedule H Part I/V/VI fields, where to find them, and how to use them in dispute letters and Form 13909 complaints",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-mrf-fetch",
      "title": "Hospital MRF lookup and per-CPT price extraction",
      "description": "scripts/fetch_mrf.py with four-format adapter (CMS JSON, CMS CSV, Turquoise CSV, TransparentRx JSON, Epic CSV); references/mrf_vendor_adapters.md",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-spd-parser",
      "title": "SPD parser",
      "description": "scripts/parse_spd.py emits structured plan profile JSON via Azure OpenAI gpt-5.2; references/spd_parsing_guide.md describes the field set and use cases",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "allen-phone-scripts",
      "title": "Phone-call scripts and protocols (community use)",
      "description": "references/phone_call_scripts.md ships six scripts plus universal protocols and a state-by-state recording-law list. Kit remains mail-first; scripts are for users who choose to call.",
      "status": "implemented",
      "release": { "version": "v0.13.0", "date": "2026-05-21" }
    },
    {
      "id": "state-long-tail",
      "title": "State packs for the remaining 14 states",
      "description": "AK, DE (initial), HI, ID, LA, ME, MT, ND, NH, RI, SD, VT, WV, WY",
      "status": "planned",
      "issue": "https://github.com/k3rt4s/medbill-dispute-kit/labels/state-pack"
    },
    {
      "id": "spanish-localization",
      "title": "Spanish-language patient-facing prompts and templates",
      "description": "Translate the most-used templates and rules into Spanish for bilingual patients",
      "status": "planned"
    },
    {
      "id": "outcomes-bank",
      "title": "Anonymized real-outcomes bank",
      "description": "Community-contributed anonymized dispute outcomes for calibration",
      "status": "proposed"
    },
    {
      "id": "advocate-variant",
      "title": "Advocate-side variant",
      "description": "Kit oriented for patient advocates handling multiple patients simultaneously",
      "status": "proposed"
    },
    {
      "id": "turquoise-integration",
      "title": "Turquoise Health API integration",
      "description": "Auto-lookup of fair prices given CPT and ZIP code via Turquoise's API",
      "status": "proposed"
    },
    {
      "id": "dollar-for-integration",
      "title": "Dollar For screener integration",
      "description": "Auto-screen non-profit hospital bills for charity-care eligibility via Dollar For",
      "status": "proposed"
    }
  ]
}