registry.RunStatus

registry.RunStatus(
    run_hash,
    status,
    superseded_by=None,
    reason=None,
    updated_at=None,
)

Lifecycle status of a single run.

“Current” is not a stored flag — it is exactly status == "active". A run that has never been marked has status is None, which is read as "active" (see :attr:effective_status). See REGISTRY_PROVENANCE.md for the full model.

Attributes

Name	Type	Description
run_hash	str	The run this status describes.
status	str | None	One of {"active", "superseded", "bad"} or None (unmarked, treated as active).
superseded_by	str | None	The run_hash that replaced this run, set when status == "superseded". None otherwise.
reason	str | None	Free-text explanation recorded when the status was set.
updated_at	datetime | None	When the status was last changed.