Repository navigation
·
244 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
Provider data landscape becomes the homepage; REAL Health Providers Act audit framework
Significant feature release. Two coordinated additions position AINPI as the audit substrate for the Requiring Enhanced and Accurate Lists of Health Providers Act (HR 7148 § 6220, signed 2026-02-03) and the 2028 CMS scoring-methodology RFC.
Headline features
- New homepage at
/— Karpathy-style hierarchical treemap. 548 cells, one per (state × specialty). Area scales with active practitioner count. Color is the audit metric in the layer you select. Tile-by toggle: group by specialty or by state. Click any cell for a side panel with all six dimension scores vs the national baseline plus 5 sample NPIs each linked to NPPES Registry, OIG LEIE, and SAM.gov primary sources. - Fullscreen mode on the treemap. Re-runs the D3 layout at viewport dimensions (not CSS-scale) so cells and labels physically grow — small specialty/state cells become legible. ESC or Minimize button to exit.
/real-health-providers— policy brief mapping every § 6220 obligation (90-day verification cadence, 5-business-day removal, eight required fields, annual accuracy analysis, MH/SUD oversampling, 2029 machine-readable score format) to the AINPI signal that measures it. Decomposes accuracy into six independently citable dimensions: completeness, cross-source correctness, currency, reachability, integrity, exposure. Ships copy-paste citation language for any submitter to the 2028 CMS scoring-methodology RFC./map— the prior US choropleth (federally-excluded NPIs per state, click-to-side-panel state detail) moved cleanly from/to its own route./landscape308-redirects to/for prior external bookmarks.
Data pipeline + contract
- New
analysis/landscape.py— single-pass BQ aggregation under the project's 100 GB per-query cap. Three queries (main, NPPES cross-source, endpoint reachability) merged in Python. Suppresses cells with fewer than 25 practitioners for PHI / readability reasons. - New stable JSON contract at
/api/v1/landscape.json(typed viafrontend/src/lib/landscape-types.ts). Today's payload is a deterministic synthetic seed clearly marked on-page (methodology_version: 0.7.1-draft-seed); the weekly-refresh cron replaces with measured values on the next pass.
Release update + subscriber communication
- New release report at
/reports/2026-06-02-update(markdown source indocs/reports/2026-06-02-update.md, registered infrontend/src/data/reports.ts). - Subscriber newsletter sent via
scripts/send-2026-06-02-update.ts(13 of 13 recipients accepted by the Resend API). Same dry-run-by-default safety pattern as the prior monthly scripts (--confirmrequired,--email/--limitfor narrow targeting, 250ms throttle, fire-and-forget per-recipient with ok/fail counters). HTML pared down to plain semantic markup with no gradients, badges, or marketing button stacks so the email reads as a maintainer update rather than a campaign.
Chrome cleanup
- The blue
LatestUpdatesbanner is removed fromlayout.tsx. Same surface lives in/findingshub timeline; the banner band above every page was redundant noise. - The yellow
HomepageLatestStripis removed from the new homepage — the H40 feature-card was three banded rows of meta-context before the actual visualization. - The
WipBanneris no longer rendered twice (once from layout, once from page.tsx). Layout keeps the single global instance per the CLAUDE.md "every page shows a WIP banner" methodology principle; data-heavy pages still carry the disclaimer. - Navbar: Landscape →
/, Map →/map. Drops the prior Explore/Landscape pair that became redundant after the page swap. - Updated
frontend/src/components/LatestUpdates.tsxcurated entries to reflect today's release (component itself is currently dead code; data is current for any future re-mount).
Methodology + branch protection
- Methodology version bumped to
0.7.1-draft(landscape introduction). - Documented baseline branch protection on
mainaccurately in CLAUDE.md (the prior strict ruleset description was stale; what's actually enforced today isallow_force_pushes: false,allow_deletions: false).
Constraints kept
- No "produced for" / "guided by" any state agency or CMS in any shipped page.
- No plan or vendor named in adjectives; numbers do the talking.
- No cost-of-error claims without primary-source verification per record (the 2026-05-22 H40 SAM-NPI false-positive incident remains the cautionary tale wired into the cohort verify-URLs pattern).
What's deliberately deferred
- Real BigQuery run replaces the landscape seed (weekly-refresh cron).
- Per-MA-plan scoreboard (H26 4-payer probe generalized).
- MCP server:
lookup_npi,cross_source_check,get_real_health_score(plan_id, state). - Per-NPI history view (5-business-day removal audit instrument).
- Diff-since-last-release feed (quarterly compliance cadence).
PRs in this release
- #114 — REAL Health Providers Act positioning + landscape visualizer (Karpathy-style hierarchical treemap with tile-by toggle and stats strip)
- #115 — landscape becomes the homepage, choropleth moves to /map, 2026-06-02 release
Plus four direct-to-main fixes: home Latest-strip removal (a5107cb), fullscreen mode (01e306f), LatestUpdates banner removal + WipBanner dedupe (7761fea), and the LatestUpdates data refresh (b71375d).
Live: ainpi.dev · policy brief · release update · map