homelab/stack
1
0
Fork 0
Code Issues 70 Pull Requests 1 Actions Packages Projects 1 Releases Wiki Activity

bib: cfrlink core — parse_cite / url / cite_of with round-trip law #639

New Issue
Closed
opened 2026-08-17 18:50:41 +00:00 by kert · 0 comments
kert commented 2026-08-17 18:50:41 +00:00
Owner
Copy Link

src/bib/cfrlink.py: CfrCite(title, part, section, paras, date); parse_cite accepting 42 CFR 425.400(c)(1)(iv), 42 C.F.R. § 425.400, 42 CFR Part 425 spellings (title REQUIRED — bare § raises); url() emitting the server-resolved short form https://www.ecfr.gov/current/title-{t}/section-{s} + semantic #p-{s}(c)(1)(iv) fragment (verified: eCFR paragraph ids ARE the cite paths; short URLs 302 to canonical; fragments survive), /on/{date}/ pinning; cite_of(url) inverting short/canonical/dated/fragmented URL forms.

Round-trip law tested both ways: cite→URL→cite is the canonical spelling; URL→cite→URL reproduces the short form. Pure functions, no network, no store.

Spec: docs/superpowers/specs/2026-08-17-ecfr-jump-links-design.md.

`src/bib/cfrlink.py`: `CfrCite(title, part, section, paras, date)`; `parse_cite` accepting `42 CFR 425.400(c)(1)(iv)`, `42 C.F.R. § 425.400`, `42 CFR Part 425` spellings (title REQUIRED — bare § raises); `url()` emitting the server-resolved short form `https://www.ecfr.gov/current/title-{t}/section-{s}` + semantic `#p-{s}(c)(1)(iv)` fragment (verified: eCFR paragraph ids ARE the cite paths; short URLs 302 to canonical; fragments survive), `/on/{date}/` pinning; `cite_of(url)` inverting short/canonical/dated/fragmented URL forms. **Round-trip law tested both ways**: cite→URL→cite is the canonical spelling; URL→cite→URL reproduces the short form. Pure functions, no network, no store. Spec: docs/superpowers/specs/2026-08-17-ecfr-jump-links-design.md.
kert added this to the P41: eCFR Jump Links — bidirectional CFR cite ↔ URL milestone 2026-08-17 18:50:41 +00:00
kert added the bibcli labels 2026-08-17 18:50:41 +00:00
kert closed this issue 2026-08-17 19:08:34 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
api
REST API (FastAPI)
 auth
Authentication and authorization
 bib
Bibliography, Zotero, citations
 ci
CI/CD pipelines and Woodpecker plugins
 cli
CLI commands and UX
 cloud
Cloud provider abstraction (AWS, GCP, Azure, self-hosted)
 config
Configuration and wiring
 data
Data loading, CCLF, BCDA, seeds
 databricks
Databricks jobs and deployment
 docs
Documentation and generated references
 image:api
image:docs
image:mc
image:notebooks
image:zotero
infra
lakehouse
Nessie, Polaris, Trino, Iceberg
 llm
llm module — local RAG over comments + Zotero corpus
 notebooks
marimo notebook errors (auto-filed by nb-watcher/nb-integration)
 packaging
Python packaging, optional deps, build system
 pfs
pipeline
Pipeline execution and validation
 pipeline:ci
pipeline:deploy
pipeline:harden
pipeline:infra-ci
pipeline:rebuild-all
pipeline:release
qpp
quality
Testing, coverage, error handling
 step:build
step:deploy
step:hadolint
step:lint
step:publish
step:scan
step:test
step:validate
styles
Charts, figures, visual theming
 tree
Project directory structure and file organization
No Label bib cli
Milestone
No items
No Milestone P41: eCFR Jump Links — bidirectional CFR cite ↔ URL
Projects
Clear projects
No project
Assignees
Clear assignees
kert renovate-bot
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: homelab/stack#639
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?