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

docs: stack pfs elements|lineage|families|review (refs #684-#687)

Browse Source 
Claude-Session: https://claude.ai/code/session_01Aum3pEMAM3yQVdFSdVe6Gc
This commit is contained in:
kert
2026-09-09 13:10:27 -04:00
parent 7fcec9c908
commit aa11fe6a52
6 changed files with 106 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
docs/docs/cli/pfs-elements.md Normal file
View File

@@ -0,0 +1,22 @@
---
title: stack pfs elements
sidebar_position: 63
---
# `stack pfs elements`
```
Usage: stack pfs elements [OPTIONS]
Extract typed elements for codes into pfs.code_element (+ review queue).
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --code TEXT HCPCS/CPT code (repeatable). │
│ --family TEXT Expand a registered family (CCM, APCM, …). │
│ --all-payable Every A/R/T code in the newest RVU year. │
│ --no-llm Skip the local-model classifier (unknown lines go │
│ to review). │
│ --dry-run Extract and report; write nothing. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
```

17
docs/docs/cli/pfs-families.md Normal file
View File

@@ -0,0 +1,17 @@
---
title: stack pfs families
sidebar_position: 65
---
# `stack pfs families`
```
Usage: stack pfs families [OPTIONS]
Derive families from pfs.code_element / pfs.code_event / pfs.rvu.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --write │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
```

18
docs/docs/cli/pfs-lineage.md Normal file
View File

@@ -0,0 +1,18 @@
---
title: stack pfs lineage
sidebar_position: 64
---
# `stack pfs lineage`
```
Usage: stack pfs lineage [OPTIONS]
Timeline of a code: RVU-file diffs and FR paragraphs, cross-checked.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ * --code TEXT [required] │
│ --write Persist to pfs.code_event and republish. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
```

17
docs/docs/cli/pfs-review.md Normal file
View File

@@ -0,0 +1,17 @@
---
title: stack pfs review
sidebar_position: 66
---
# `stack pfs review`
```
Usage: stack pfs review [OPTIONS]
Element lines the classifier could not place.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --code TEXT │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
```

24
docs/docs/cli/pfs.md Normal file
View File

@@ -0,0 +1,24 @@
---
title: stack pfs
sidebar_position: 62
---
# `stack pfs`
```
Usage: stack pfs [OPTIONS] COMMAND [ARGS]...
Code elements, lineage events and derived families.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ elements Extract typed elements for codes into pfs.code_element (+ review │
│ queue). │
│ lineage Timeline of a code: RVU-file diffs and FR paragraphs, │
│ cross-checked. │
│ families Derive families from pfs.code_element / pfs.code_event / pfs.rvu. │
│ review Element lines the classifier could not place. │
╰──────────────────────────────────────────────────────────────────────────────╯
```

8
docs/docs/cli/stack.md
View File

@@ -23,9 +23,17 @@ Usage: stack [OPTIONS] COMMAND [ARGS]...
│ load Ingest data (CCLF, BCDA, seeds). │
│ generate Regenerate code artefacts. │
│ bib Bibliography operations. │
│ comments CMS rulemaking comment text extraction & analysis. │
│ lake Lakehouse schema and data. │
│ llm Local RAG — index, search, tag. │
│ db DuckDB utilities. │
│ docs Documentation generation. │
│ api API server. │
│ perf Pipeline telemetry utilities. │
│ rec Reconcile calculated payments against CMS ground-truth files. │
│ pfs Code elements, lineage events and derived families. │
│ zot Zotero database maintenance. │
│ prisma LLM-driven PRISMA screening workflow. │
│ mail Maddy mail server (DO + Resend smarthost). │
╰──────────────────────────────────────────────────────────────────────────────╯
```