aeat.domain.calculations.registry._legal module

Legal catalogue helpers.

verify_legal_reference(reference, *, source_root=None)

Verify one already parsed legal reference is filing-grade.

Type-system invariants enforced by the Pydantic schema (and thus NOT re-checked here):

• review_status is Literal["reviewed"] — the type makes any other value unrepresentable, so a prior runtime check if reference.review_status != "reviewed" was structurally unreachable dead code.

• evidence_tier on LegalReference is Literal["legal_authority"] — same dead-branch reasoning.

• corpus_ref matches the path#anchor shape — the LegalReference model validator rejects malformed refs at parse time, so the defensive corpus_ref.split("#", 1)[0] in _legal_corpus_text() will always find a non-empty path.

This function therefore only checks runtime invariants that the type system cannot express: known-bad citation patterns and required-text presence against the local corpus.

Return type:

None

Parameters:

• reference (LegalReference)

• source_root (Path | None)

verify_legal_catalogue(legal, *, source_root=None)

Verify every legal reference in a shared legal catalogue.

Return type:

None

Parameters:

• legal (Mapping[str, LegalReference])

• source_root (Path | None)