orchestrata_ultimate.factory.anchors

Reference › orchestrata_ultimate › factory › anchors › init

Package marker for semantic anchors, covering authoring, storage and ratification (SPEC-033 row B15a) and evaluation (row B15b). It defines no code of its own; see the package page for the modules.

At a glance

Source src/orchestrata_ultimate/factory/anchors/__init__.py
Lines of code 31
Classes 0
Functions 0
Imports (internal) none
Imported by none
Tests that import it none

Class diagram

No classes; see Functions.

Dependency diagram

No internal imports and no importers.

API

No public API: the module defines no classes, functions or constants.

Source

Permalink: https://gitlab.com/MSamy/orchestrata-ultimate-architecture/-/blob/a4cbc2bdf/src/orchestrata_ultimate/factory/anchors/__init__.py

"""SPEC-033 semantic anchors — authoring, storage, ratification (B15a).

Anchors (ADR-0012) are requirement-derived constraints on behaviour —
examples, properties/metamorphic invariants, and differential oracles — that
do not derive from the implementation, so they cannot be co-authored by the
code that they check. ADR-0013 makes them constitution-tier: human-authored
and human-ratified only, with any edit to a ratified anchor treated as a
loosening (supersede + propose-new, never update-in-place). ADR-0016 ranks
the three classes by independence from the design author and makes a
differential oracle mandatory for every amendment.

This package covers AUTHORING + STORAGE + RATIFICATION + the B13
pinning-source seam only. Anchor RUNTIME (evaluation/satisfaction checking,
fast-path gating) is a separate task (B15b) and is not built here.

Modules
-------
models   :class:`~.models.Anchor`, :class:`~.models.AnchorClass`,
         :class:`~.models.AnchorStatus` — the frozen data model + its
         constructor invariants.
store    :class:`~.store.AnchorRegistry` — the JSON-file-backed store
         (propose / ratify / supersede / anchors / get) plus the
         anchor-weakened-to-pass ledger.
intake   The B23 DoR-construction-procedure bridge
         (:func:`~.intake.import_dor_candidates`) and the amendment-path
         differential-oracle helper (:func:`~.intake.propose_oracle`).
source   :class:`~.source.AnchorSource` — the B13 ``PinningSource``
         implementation exposing RATIFIED anchors to the arbiter cascade.
"""

from __future__ import annotations