aigovops_lantern.ucid

Universal Control Identifier (UCID) registry: load, lookup, and crosswalk explain.

UCID registry loader & lookup.

The Unified Control Identifier (UCID) registry is maintained at https://github.com/bobrapp/umbrella-govops/blob/main/crosswalks/unified-control-id.yaml under the Designated Expert review process described in UCID-REGISTRY.md of the same repository.

Lantern does not maintain its own copy of the registry. It either:

• reads a local YAML file the user points it at (--registry), or
• falls back to a minimal bundled snapshot used purely for tests and offline demos (see EMBEDDED_FALLBACK below).

Lantern is read-only with respect to the registry: it never mutates, re-numbers, or "fixes" UCIDs. The Designated Expert process is the only way to change a UCID's metadata.

UcidError

Bases: LookupError

A UCID could not be resolved.

Ucid dataclass

One UCID entry as Lantern surfaces it.

Mirrors the fields most relevant for human-readable rendering. Unknown fields from the YAML are preserved in extras so that Lantern degrades gracefully when the upstream registry adds columns.

load_registry(path=None)

Load a UCID registry from a YAML file, or return the embedded fallback.

path should point at a unified-control-id.yaml-shaped file (the canonical source lives in umbrella-govops/crosswalks/).