orchestrata_ultimate.core

Reference › orchestrata_ultimate › core

Orchestrata Core — interfaces, enums, traceability, config, domain, state, adapters.

The foundation layer of orchestrata-ultimate: the shared vocabulary, contracts and infrastructure access that every other package builds on, while core itself orchestrates nothing and (by decision K6) imports nothing from the cxp, postman, orchestrator or kernel packages. The curated core narrative tells the story; the architecture overview places it at the bottom of the import layers.

By role:

A process starts by loading the environment contract, then asks the factories for Redis, graph or Prolog access; subsystems talk through the protocols and the packet. There are no command-line entry points here. To start reading, take base, protocols and infra_config.

Curated narrative

The hand-written story of this package: orchestrata_ultimate.core.

92 modules, 18,404 lines of code.

Subpackages

Package Modules LOC
adapters 5 1,226
base 6 501
config 3 867
domain 5 283
enums 1 20
graph 8 993
interfaces 7 317
monitoring 3 566
packet 6 1,529
patterns 3 425
protocols 9 1,779
state 2 173
threading 7 4,204
traceability 1 452
tracing 6 1,109

Modules

Module Summary LOC
__init__ Orchestrata Core — interfaces, enums, traceability, config, domain, state, adapters. 1
artifact_store Canonical artifact store shared by the kernel and orchestrator pipelines. 515
atomic_json Atomic JSON writes — a truncate-in-place write is a corruption waiting to land. 160
banned_libraries The banned-dependency registry, read from one place by everything. 118
capability_mesh The capability -> provider resolver shared by both pipeline meshes. 69
env_bootstrap The RUL-019 environment contract — THE canonical two-phase loader. 208
gate_waivers The # gate-ok: waiver convention, read from one place by everything. 85
graph_directives Knowledge graph context extraction for LLM injection. 40
graph_factory Graph driver factory. 224
infra_config Infrastructure configuration using Pydantic Settings. 359
infra_env_rule The no-literal-fallback rule for infra-connection env keys (RUL-003). 137
isolation 40
janus_bootstrap janus_bootstrap.py — RTLD_GLOBAL preload that fixes library(json) under janus. 324
logging Centralized structured logging with correlation IDs. 179
lru_cache Thread-safe LRU cache with TTL support. 124
paths Project root and Prolog directory path resolution. 86
prolog_adapter Prolog engine adapter -- janus-swi. 277
redis_factory Thread-safe Redis client factory for Python 3.14t (free-threaded). 238
standards Canonical coding standards for all Orchestrata volks. 240
traceability_utils Standalone traceability engine for spike-generated projects. 536

Dependency diagram

Package dependency diagram orchestrata_ultimate.core