just_dna_enricher.cli.acmg_commands¶
just_dna_enricher.cli.acmg_commands ¶
The ACMG secondary-findings list: check-acmg and the acmg builder group (RM260 split this out of
the former single-file cli.py).
check_acmg_ ¶
check_acmg_(
spec_dir: Path = typer.Argument(
...,
exists=True,
file_okay=False,
help="Module spec directory",
),
strict: bool = typer.Option(
False,
"--strict/--best-effort",
help="Exit 1 if any acmg_sf disagrees.",
),
offline: bool = typer.Option(
False,
"--offline",
help="No network. Needs --sf-list, else nothing is checked.",
),
url: str = typer.Option(
DEFAULT_ACMG_URL,
"--url",
help="ACMG secondary-findings page URL (fallback).",
),
sf_list: Path | None = typer.Option(
None,
"--sf-list",
exists=True,
file_okay=False,
help="Built ACMG SF snapshot (see `acmg build`). Preferred: NCBI's page still serves v3.2. Omit it and a snapshot in $JUST_DNA_ACMG_CACHE (or the shared cache base) is used; the page is scraped only when neither is there.",
),
) -> None
Check each row's acmg_sf against the ACMG secondary-findings list (reports only).
Writes no authored cell, and records that the question was put — the same two halves as
check-identifiers. acmg_sf is an authored cell this asks a registry about, not a fact this
pass contributes, and filling it here would break the check (see hints.REDUNDANCY_BEARING). The
verification.json record is an attestation, never a value: it says the list was consulted and
over how many rows, which is the one thing a downstream reader cannot reconstruct from the
artifact (RM45/RM72).
Source code in enricher/src/just_dna_enricher/cli/acmg_commands.py
23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 | |
acmg_build_ ¶
acmg_build_(
workbook: Path = typer.Argument(
...,
exists=True,
dir_okay=False,
help="ACMG SF supplementary workbook (.xlsx), downloaded by you.",
),
out: Path = typer.Option(
repro_out("acmg_sf"),
"--out",
file_okay=False,
help="Output snapshot directory (writes acmg_sf.csv + release.json).",
),
source_url: str | None = typer.Option(
None,
"--source-url",
help="Where the workbook came from, recorded in release.json.",
),
doi: str | None = typer.Option(
None,
"--doi",
help="DOI of the statement the workbook accompanies, recorded in release.json.",
),
) -> None
Convert ACMG's SF workbook into the snapshot check-acmg --sf-list reads.
Why this exists: NCBI's page serves v3.2 and ACMG published v3.3 in June 2025, so the live scrape reports correctly authored rows as wrong. Nothing is downloaded here — the workbook is ACMG/Elsevier supplementary material and the author supplies their own copy, which is the same inject-only shape every other reference in this repo uses.