Minos

Minos is an explainable settlement intelligence platform for Polish hospital care. It combines versioned medical terminology (Polish ICD-10 and ICD-9 PL) with the NFZ JGP hospital grouping system: the group definitions, point catalogs, and grouper algorithm that determine how Polish hospitals are paid.

In Dante's Inferno, Minos hears each case in full and assigns it to its circle. That is what a DRG grouper does, and this one shows its reasoning.

The repository and command use the short name minos. Minos is the provisional public brand pending trademark counsel review; a registry pre-screen was performed on 2026-08-06 (see decisions).

Product Layers

1. Terminology: icd10-pl and icd9-pl with deterministic, fast search and full source provenance.
2. JGP knowledge base: groups, grouping conditions, directional ICD lists, age and length-of-stay rules, point values, and version-to-version diffs, ingested from NFZ normative acts.
3. Grouper engine: deterministic evaluation of the reviewed supported rules, with points, source-linked traces and bounded near misses. Unsupported rules remain undetermined rather than being guessed into an answer.

Delivery Status (2026-10-19)

The public validation site serves terminology/JGP search, dated group and code pages, the stepped encounter builder at minoshealth.pl/gruper, and a public MCP server for agents at https://minoshealth.pl/mcp (documentation), listed in the official MCP Registry as pl.minoshealth/mcp. The latest recorded verified validation deployment is b0dee0d (activated 2026-10-19T11:42:10Z, bundle 5cea0d5d unchanged) with the patched NGINX 1.31.7 edge base (#197). 2b6e26b activated blue/green API colours earlier that day (#192): no Uptime Kuma down beat, with an accepted ~24-second edge window. Both needed one retry after a rolled-back startup exit (#198). fda0788 (#191) passed all 102 site audit checks. f9a0a72 added MODTAR generation 103, the 2026-10-13 knowledge horizon (#184) and faster API startup (#189); 736ba9f added source filters, sharing and bounded startup readiness, and #171/#172 (088f190) initial source HTML and durable RSK/BAW citations. The schema-10 bundle and release-pinned concept JSON remain available. Reviewed MODTAR binding, governing-act settlement-product exclusions, pinned JGP comparisons and NFZ publication metadata are also live. Deployment evidence records the recovery, API, browser, privacy and exact-digest checks, including the owner-approved one-off startup wait after guarded recovery. This is a dated acceptance record, not a new production inspection.

Startup warm-up reliability (#157), guarded recovery diagnostics (#162), NFZ publication metadata (#92) and concept JSON (#23) are delivered and closed. The no-JS source-catalog and durable RSK/BAW citation slice from PR #171 passed production recovery and public/browser acceptance; source filters, sorting and shareable views followed at 736ba9f (#185), and broader #80 remains open. Bounded startup readiness (#181) passed its first production activation. Actions usage is measured in #174; full CI runs on every push to main again since #272.

The initial golden suite has 9 synthetic and 5 pinned-source derived cases. Practitioner builder acceptance (#158), real ward agreement (#38), and full signed-release/capacity acceptance remain open; open work is tracked in GitHub issues.

Roadmap

... View full README on GitHub