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 |