docs(cli): regenerate stack pfs cpt-ingest and stack bib import-zotero pages (F7)

Ran docs/scripts/extract_cli.py. Both commands existed with no CLI doc
page at all (import-zotero since #687, cpt-ingest from this branch's
earlier commits). Also refreshed pfs.md and bib.md (group pages whose
Commands table now lists them) and pfs-families.md (the new --verbose
option, F5's minor). The generator does a full rmtree+regenerate and
the repo's docs/docs/cli/ tree was already stale for several unrelated
command groups (mail, comments, lake, db, docs, api, llm, zot, prisma,
most of bib's own long-standing subcommands) — left untouched here,
out of scope for this fix wave; only the files this branch's commands
actually affect are included.
This commit is contained in:
kert
2026-09-09 21:23:35 -04:00
parent 041378b16b
commit 5628b50548
5 changed files with 112 additions and 12 deletions

View File

@@ -0,0 +1,38 @@
---
title: stack bib import-zotero
sidebar_position: 23
---
# `stack bib import-zotero`
```
Usage: stack bib import-zotero [OPTIONS]
Pull a Zotero collection's book items (with files) into bib.
The reverse of ``sync-zotero``: reads the Zotero SQLite database
read-only and upserts each book as a bib ``Source`` item (dedup by
URL), copying its attachment file(s) into bib storage — an ordinary
corpus document like any other, indexed like everything else in
bib. ``llm:skip`` is available as a generic opt-out for material
that should not be embedded (see ``llm.source.iter_corpus_refs``)
— e.g. a scratch export or a duplicate scan — but it's never added
automatically here; pass ``--tag llm:skip`` explicitly if it
applies.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ * --collection TEXT Zotero collection name to pull │
│ from. │
│ [required] │
│ --with-files --no-with-files Only import items that have at │
│ least one attachment file. │
│ [default: no-with-files] │
│ --only TEXT Title substring filter │
│ (case-insensitive). │
│ --tag TEXT Tag every imported item with │
│ this. Repeat for multiple. │
│ --dry-run Report what would happen without │
│ writing. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
```

View File

@@ -17,5 +17,40 @@ Usage: stack bib [OPTIONS] COMMAND [ARGS]...
│ sync Apply col: tags as DuckDB column comments. │ │ sync Apply col: tags as DuckDB column comments. │
│ tag List or search bibliography tags. │ │ tag List or search bibliography tags. │
│ query Search the bibliography store. │ │ query Search the bibliography store. │
│ discover-pfs-rules Walk the Federal Register API for every PFS rule │
│ since a date. │
│ fetch-docket-comments Walk one docket's comments from its stored watermark; │
│ upsert as Source items. │
│ fetch-pfs-comments Discover every PFS proposed rule since *since* and │
│ pull new comments │
│ on each docket from its stored watermark. │
│ ingest-mail Pull UNSEEN mail from a mailbox via IMAPS, upsert as │
│ bib Sources. │
│ backfill-comments Enrich every reg-gov comment stub with body + │
│ attachments. │
│ ingest-iom Crawl the CMS IOM index and upsert every chapter as a │
│ Manual. │
│ attach-iom Download the PDF for every Manual and attach it to │
│ the record. │
│ watch-iom Poll the CMS futurepdf.pdf schedule; attach if │
│ changed. │
│ import-zotero Pull a Zotero collection's book items (with files) │
│ into bib. │
│ sync-zotero Push bib items (and their attachments) to the Zotero │
│ database. │
│ ingest-oig Crawl OIG Compliance Program Guidance + fraud alerts │
│ indexes. │
│ attach-oig Download and attach the PDF/HTML for every OIG │
│ guidance record. │
│ refresh-oig One-shot: ingest-oig → attach-oig → sync-zotero (OIG │
│ tag). │
│ refresh-iom One-shot: ingest-iom → watch-iom → attach-iom → │
│ sync-zotero. │
│ fr-grab Grab federalregister.gov paragraph/page anchor maps │
│ into bib (#634). │
│ fr-jump Resolve an FR citation to its web jump link (#637); │
│ optionally place it. │
│ cfr-jump Bidirectional CFR cite ↔ eCFR URL (#640); optionally │
│ place the link. │
╰──────────────────────────────────────────────────────────────────────────────╯ ╰──────────────────────────────────────────────────────────────────────────────╯
``` ```

View File

@@ -0,0 +1,21 @@
---
title: stack pfs cpt-ingest
sidebar_position: 69
---
# `stack pfs cpt-ingest`
```
Usage: stack pfs cpt-ingest [OPTIONS]
Parse CPT EPUB editions into pfs.cpt_section/cpt_code/cpt_instruction/
cpt_reference/cpt_crosswalk/cpt_list (docs/superpowers/specs/
2026-09-09-cpt-canonical-schema-design.md §3).
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --edition INTEGER CPT edition year to ingest (repeatable). │
│ --all Every CPT EPUB edition found in bib (source:ama). │
│ --dry-run Parse and report counts; write nothing. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
```

View File

@@ -1,6 +1,6 @@
--- ---
title: stack pfs families title: stack pfs families
sidebar_position: 65 sidebar_position: 67
--- ---
# `stack pfs families` # `stack pfs families`
@@ -12,6 +12,7 @@ Usage: stack pfs families [OPTIONS]
╭─ Options ────────────────────────────────────────────────────────────────────╮ ╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --write │ │ --write │
│ --verbose Print every family's members, not just the summary. │
│ --help Show this message and exit. │ │ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯ ╰──────────────────────────────────────────────────────────────────────────────╯
``` ```

View File

@@ -1,6 +1,6 @@
--- ---
title: stack pfs title: stack pfs
sidebar_position: 62 sidebar_position: 64
--- ---
# `stack pfs` # `stack pfs`
@@ -18,7 +18,12 @@ Usage: stack pfs [OPTIONS] COMMAND [ARGS]...
│ queue). │ │ queue). │
│ lineage Timeline of a code: RVU-file diffs and FR paragraphs, │ │ lineage Timeline of a code: RVU-file diffs and FR paragraphs, │
│ cross-checked. │ │ cross-checked. │
│ families Derive families from pfs.code_element / pfs.code_event / pfs.rvu. │ │ families Derive families from pfs.code_element / pfs.code_event / │
│ pfs.rvu. │
│ review Element lines the classifier could not place. │ │ review Element lines the classifier could not place. │
│ cpt-ingest Parse CPT EPUB editions into │
│ pfs.cpt_section/cpt_code/cpt_instruction/ │
│ cpt_reference/cpt_crosswalk/cpt_list (docs/superpowers/specs/ │
│ 2026-09-09-cpt-canonical-schema-design.md §3). │
╰──────────────────────────────────────────────────────────────────────────────╯ ╰──────────────────────────────────────────────────────────────────────────────╯
``` ```