Skip to content

v1.1.0

Latest

Choose a tag to compare

@github-actions github-actions released this 02 Jun 16:32
· 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. /landscape 308-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 via frontend/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 in docs/reports/2026-06-02-update.md, registered in frontend/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 (--confirm required, --email/--limit for 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 LatestUpdates banner is removed from layout.tsx. Same surface lives in /findings hub timeline; the banner band above every page was redundant noise.
  • The yellow HomepageLatestStrip is removed from the new homepage — the H40 feature-card was three banded rows of meta-context before the actual visualization.
  • The WipBanner is 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.tsx curated 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 main accurately in CLAUDE.md (the prior strict ruleset description was stale; what's actually enforced today is allow_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