just_dna_enricher.enrich¶
just_dna_enricher.enrich ¶
enrich — fill the source-independent resolution table for a module spec, then hand off to compile.
The resolver chain, first-hit-wins: an existing/human-authored row (authoritative, never clobbered) →
the local cache (a downloaded snapshot, offline) → live Ensembl (REST). It writes
resolution.csv beside the spec; the compiler then consumes it with no source knowledge and no
network. Two modes: best_effort fills what it can and records the rest as not_found; strict
fails unless every in-scope variant resolves to a position (the network analogue of the compiler's
strict=True). --offline clamps the chain to the cache alone (guaranteed zero egress).
RM260: this __init__ is the re-export shell that keeps every dotted path into the old single-file
enrich.py resolving to the same object. The code lives in the submodules beside it — subjects,
outcome, build_declaration, orchestration, verification_records, resolution_csv — and
those import one another directly, never through this shell. The shell is removed at 1.0.