orchestrata_ultimate.factory.assumptions

Reference › orchestrata_ultimate › factory › assumptions

Assumption ledger + arbiter cascade (SPEC-033 REQ-033-C1, Phase 0).

The assumptions package records the assumptions that an executing model makes and works out whether each one is backed by an existing artifact (SPEC-033 row B13, requirement REQ-033-C1, ADR-0024). It is the first stage of the factory's governance: work is not ready until every assumption is pinned.

Data and storage: models (frozen records and enums) and ledger (the JSONL AssumptionLedger and the file-backed knowledge base of promoted adjudications). The cascade has four stages. Stage 0 looks the assumption up in the knowledge base. Stage 1 is the lexical prefilter over candidates from sources (acceptance criteria, ADRs, earlier rulings and, via the anchors package, ratified anchors). Stage 2 is an independent LLM tier in adjudicator. Stage 3 is human adjudication. cascade runs stages 0 to 2 and human_adjudicate performs stage 3. Anything uncertain falls to a human. dor reports readiness when all assumptions are pinned. The CLI entry point is scripts.factory_assumptions. Start with cascade.

8 modules, 1,371 lines of code.

Modules

Module Summary LOC
__init__ Assumption ledger + arbiter cascade (SPEC-033 REQ-033-C1, Phase 0). 27
adjudicator Stage 2 — independent-tier adjudication for the arbiter cascade (B13). 148
cascade ArbiterCascade — the SPEC-033 three-stage arbiter (B13, ADR-0024). 266
dor Definition-of-Ready check for the assumption ledger (AC-033-C1-02). 38
ledger AssumptionLedger + ProjectKB (SPEC-033 REQ-033-C1, Phase 0). 426
models Data model for the SPEC-033 assumption ledger + arbiter cascade (B13). 195
prefilter Stage 1 — deterministic pre-filter for the SPEC-033 arbiter cascade (B13). 85
sources Pinning-artifact sources for the SPEC-033 arbiter cascade (B13). 186

Dependency diagram

Package dependency diagram orchestrata_ultimate.factory.assumptions