bib: sub-regulatory crosswalk — IOM section and eCFR section anchors per code family #689

New Issue

kert · 2026-09-09T14:30:04Z

kert commented

2026-09-09 14:30:04 +00:00

Spec docs/superpowers/specs/2026-09-09-code-family-longitudinal-design.md.

What. For each family, the manual sections and CFR sections that govern it, with page/section anchors so the chat can jump: e.g. CCM/PCM/APCM → MCPM ch. 12 (SPJB4FX2, PDF page located the P34 way via llm/pages.py), MBPM ch. 15 (YQFGB6JS), MLN909188 (PV8APQ4A); telehealth families → 42 CFR § 410.78 (SAJSGG28, eCFR round-trip via bib.cfrlink, P41) and the Medicare Telehealth Services List; incident-to elements → § 410.26 (Q78GP4Z9).

Source of truth. The FR paragraphs themselves cross-reference these ("as defined in § 410.78(a)(3)", 2KVJ2HKX ¶398): harvest § nnn.nn and "Chapter N, section X" mentions from code-anchored paragraphs, resolve with cfrlink/IOM item lookup, store pfs.code_guidance(code_or_family, kind, item_key, locator, item_key_src, p_id_src).

Done when each of the five fixture families lists ≥1 IOM section and ≥1 CFR section with a working jump link, every row cites the FR paragraph that made the cross-reference, and the IOM alert (bib.iom_alert) flags a chapter update touching an anchored section.

Spec docs/superpowers/specs/2026-09-09-code-family-longitudinal-design.md. **What.** For each family, the manual sections and CFR sections that govern it, with page/section anchors so the chat can jump: e.g. CCM/PCM/APCM → MCPM ch. 12 (`SPJB4FX2`, PDF page located the P34 way via `llm/pages.py`), MBPM ch. 15 (`YQFGB6JS`), MLN909188 (`PV8APQ4A`); telehealth families → 42 CFR § 410.78 (`SAJSGG28`, eCFR round-trip via `bib.cfrlink`, P41) and the Medicare Telehealth Services List; incident-to elements → § 410.26 (`Q78GP4Z9`). **Source of truth.** The FR paragraphs themselves cross-reference these ("as defined in § 410.78(a)(3)", `2KVJ2HKX` ¶398): harvest `§ nnn.nn` and "Chapter N, section X" mentions from code-anchored paragraphs, resolve with `cfrlink`/IOM item lookup, store `pfs.code_guidance(code_or_family, kind, item_key, locator, item_key_src, p_id_src)`. **Done when** each of the five fixture families lists ≥1 IOM section and ≥1 CFR section with a working jump link, every row cites the FR paragraph that made the cross-reference, and the IOM alert (`bib.iom_alert`) flags a chapter update touching an anchored section.

kert added this to the P49: Code families as first-class objects — element model, lineage anchors, longitudinal chat milestone 2026-09-09 14:30:04 +00:00

kert added the bib label 2026-09-09 14:30:04 +00:00

kert commented

2026-09-10 03:35:35 +00:00

Progress (branch worktree-p49-anchors-2, unmerged): stack pfs guidance --family … [--write] (383df09 + fix 839c5bf) harvests CFR and IOM references from every FR paragraph that names a family code (FR cites stripped first, word-bounded code match, one SQL per family) and from the CPT guideline/instruction text, resolves CFR cites through bib.cfrlink and IOM chapters through the pub:100-0N items, and stores pfs.code_guidance(family, code, kind, locator, item_key, item_key_src, p_id_src, page_src) with FR paragraph provenance. Live: 260 rows for the five hand families (CCM 175, TCM 28, ACP 24 cfr + 2 iom, PCM 22, APCM 9), all 260 resolved to a bib item. The fix round made CFR list citations complete (42 CFR 410.20, 410.26, and 410.32, parts 405, 414, and 426, §§ 410.26 and 410.32): corpus-wide CFR refs went from 44,929 to 46,145. Out of scope here, still open on this issue: PDF page locating inside an IOM chapter; MLN booklets are captured but never resolved to an item; the CPT guideline text turned out never to cite CFR/Medicare manuals, so the manual contributes no rows.

Progress (branch worktree-p49-anchors-2, unmerged): `stack pfs guidance --family … [--write]` (383df09 + fix 839c5bf) harvests CFR and IOM references from every FR paragraph that names a family code (FR cites stripped first, word-bounded code match, one SQL per family) and from the CPT guideline/instruction text, resolves CFR cites through `bib.cfrlink` and IOM chapters through the `pub:100-0N` items, and stores `pfs.code_guidance(family, code, kind, locator, item_key, item_key_src, p_id_src, page_src)` with FR paragraph provenance. Live: 260 rows for the five hand families (CCM 175, TCM 28, ACP 24 cfr + 2 iom, PCM 22, APCM 9), all 260 resolved to a bib item. The fix round made CFR list citations complete (`42 CFR 410.20, 410.26, and 410.32`, `parts 405, 414, and 426`, `§§ 410.26 and 410.32`): corpus-wide CFR refs went from 44,929 to 46,145. Out of scope here, still open on this issue: PDF page locating inside an IOM chapter; MLN booklets are captured but never resolved to an item; the CPT guideline text turned out never to cite CFR/Medicare manuals, so the manual contributes no rows.

kert referenced this issue from a commit

2026-09-10 05:29:41 +00:00

feat(pfs): IOM/CFR guidance crosswalk per code family — pfs.code_guidance + stack pfs guidance (refs #689)

kert referenced this issue from a commit

2026-09-10 05:29:42 +00:00

fix(pfs): CFR citation lists — capture every section and part in a run (refs #689)

kert referenced this issue from a commit

2026-09-10 05:29:42 +00:00

fix(pfs): guidance --write resolves+builds before opening the batch (refs #689)

kert referenced this issue from a commit

2026-09-10 05:29:42 +00:00

merge: P49 anchors slice — code:/family: item tags, cross-collection cited sources, IOM/CFR guidance crosswalk, public-reaction series, notebook sections 5–7 (refs #688 #689 #690)

kert referenced this issue

2026-09-10 05:30:11 +00:00

P49 anchors follow-ups: CPT manual as a chat source, IOM page locating, MLN resolver, shared code-or-family SQL predicate #705

kert commented

2026-09-10 05:30:33 +00:00

Merged to main as 4616d36 (branch worktree-p49-anchors-2, Tasks 4–8 of the anchors plan; suite 14,944 passed). Residue parked by rulings is tracked in #705 (CPT manual as a chat source, IOM page locating, MLN resolver, shared SQL predicate, key case).

Merged to main as 4616d36 (branch worktree-p49-anchors-2, Tasks 4–8 of the anchors plan; suite 14,944 passed). Residue parked by rulings is tracked in #705 (CPT manual as a chat source, IOM page locating, MLN resolver, shared SQL predicate, key case).

kert closed this issue

2026-09-10 05:30:33 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: homelab/stack#689