docs(spec): products, drugs and diseases — ASP, NDC crosswalks, HCPCS and ICD-10 lineage, MCD articles, licensed drug and surgical books; product links for the market tier
Some checks failed
CI / lint (push) Successful in 1m12s
CI / notebooks-smoke (push) Successful in 2m14s
Deploy / changes (push) Successful in 17s
CI / test (push) Failing after 4m55s
Infra CI / notebooks (push) Successful in 1m10s
Infra CI / zotero (push) Successful in 17s
Infra CI / docs (push) Successful in 1m40s
Infra CI / api (push) Successful in 1m44s
Infra CI / llm (push) Successful in 1m31s
Infra CI / mc (push) Successful in 24s
Deploy / notebooks (push) Has been skipped
Deploy / zotero (push) Has been skipped
Infra CI / bcda (push) Successful in 3m11s
Deploy / docs (push) Successful in 1m10s
Deploy / api (push) Successful in 2m14s
Deploy / bcda (push) Successful in 2m3s
Deploy / mc (push) Has been skipped
Deploy / llm (push) Successful in 1m30s
Deploy / report (push) Successful in 17s
Some checks failed
CI / lint (push) Successful in 1m12s
CI / notebooks-smoke (push) Successful in 2m14s
Deploy / changes (push) Successful in 17s
CI / test (push) Failing after 4m55s
Infra CI / notebooks (push) Successful in 1m10s
Infra CI / zotero (push) Successful in 17s
Infra CI / docs (push) Successful in 1m40s
Infra CI / api (push) Successful in 1m44s
Infra CI / llm (push) Successful in 1m31s
Infra CI / mc (push) Successful in 24s
Deploy / notebooks (push) Has been skipped
Deploy / zotero (push) Has been skipped
Infra CI / bcda (push) Successful in 3m11s
Deploy / docs (push) Successful in 1m10s
Deploy / api (push) Successful in 2m14s
Deploy / bcda (push) Successful in 2m3s
Deploy / mc (push) Has been skipped
Deploy / llm (push) Successful in 1m30s
Deploy / report (push) Successful in 17s
This commit is contained in:
@@ -284,6 +284,40 @@ This layer covers who sits in which district and on which committee, and where e
|
||||
- **District roll-ups:** providers, Medicare payments and facility counts per district, joined to who represents the district and their committees.
|
||||
- **Use:** power stakes beyond the RUC. It shows which committee members' districts depend most on a family's billers or on an exposed company. It sits beside lobbying (LDA) and contributions (FEC) by the same organizations.
|
||||
|
||||
**Products, drugs and diseases (user, 2026-11-13)**
|
||||
|
||||
The user's direction: "vendor in the ASP files and the drug books, see the skin subs work that we already did, and leverage that because it was used to figure out manufacturers, also we have the ICD-10 book, and the surgical book, so you can know what drugs/diseases have code lineage and tie into procedures or treatments".
|
||||
|
||||
- **Why.**
|
||||
- Drug, biologic and device makers are exposed through their own products' codes, not through risk-factor boilerplate. In the market tier's Task 2 review, 12 of 15 sampled pharma and device links were generic PFS or QPP text.
|
||||
- A product link is the evidence that counts: manufacturer → NDC → HCPCS code → Medicare payment (ASP + 6%, or a flat rate) → the rule that changed it.
|
||||
- **What exists today.**
|
||||
- The skin-substitute work (#232–#239, `skin_subs.*`) already parses every quarterly ASP payment-limit file from 2005-Q1 to 2026-Q2 (`dev/scripts/ingest_asp.py`, `data/cms/asp/`, with column-drift handling and per-row provenance).
|
||||
- It also curated product → manufacturer for 286 skin-substitute codes (`data/cms/skin_substitute_hcpcs.csv`).
|
||||
- This tier generalizes that work. It reuses the parser, keeps the skin-substitute tables as one consumer, and seeds the manufacturer map from that curation.
|
||||
- **Public sources (hoarded, never overwritten).**
|
||||
- **CMS ASP payment-limit files:** all codes, every quarter, with "not payable" files kept as rows. The file's short descriptions for CPT codes (vaccines and similar) are AMA text, so they are never stored in the served tables.
|
||||
- **CMS ASP NDC–HCPCS crosswalks:** labeler name, NDC, HCPCS code, billing units.
|
||||
- **FDA NDC Directory:** labeler and firm, application number.
|
||||
- **FDA Orange Book and Purple Book:** application holder; biosimilar and reference product.
|
||||
- **CMS HCPCS quarterly update files:** add, change and termination dates. These give drug-code lineage the way RVU files give CPT lineage.
|
||||
- **CMS Medicare Coverage Database billing and coding articles:** HCPCS ↔ covered ICD-10-CM codes. This ties a drug or product to the diseases it is paid for.
|
||||
- **CDC/CMS ICD-10-CM and ICD-10-PCS annual files and conversion tables:** disease and procedure code lineage.
|
||||
- **Licensed books in Zotero (structured facts only, cited by edition and page, never published; the AMA rule applies to every licensed publisher):**
|
||||
- HCPCS Level II 2019 (`KSHBH7WT`), its Table of Drugs: drug name → code, unit, route;
|
||||
- the ICD-10-CM and ICD-10-PCS codebooks, 2016–2025;
|
||||
- *Netter's Atlas of Surgical Anatomy for CPT Coding* (`9EV89ZYX`): procedure → anatomy, to tie procedures to the drugs and products used in them;
|
||||
- *Coding with Modifiers*.
|
||||
- **What it produces.**
|
||||
- A product registry: HCPCS code ↔ NDC ↔ labeler ↔ application holder ↔ the market tier's entity (CIK and ticker), each link cited.
|
||||
- Quarterly payment series per code.
|
||||
- Code-lineage events for drug and product codes and for ICD-10 codes.
|
||||
- Product → disease (MCD articles) and product → procedure links. Examples: skin substitutes ↔ 15271–15278, infused drugs ↔ the administration codes. The procedure links are curated in `curated.yaml` like the family links.
|
||||
- **How the market tier uses it.**
|
||||
- An `asp` link basis (company → its products' codes, with the products' Medicare payment share) sits beside the `fts` passages.
|
||||
- A pharma or device company prices on product evidence even without a `revenue_exposure` passage.
|
||||
- Event windows include ASP methodology changes and code reclassifications. The CY2026 skin-substitute flat rate is the natural first study: Organogenesis, MiMedx, Smith & Nephew.
|
||||
|
||||
**Constraints**
|
||||
|
||||
- Public data only. No material non-public information.
|
||||
|
||||
Reference in New Issue
Block a user