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:
- Base classes and domain: base (entity, error, repository, service, the
@tracesdecorator), domain and enums. - Contracts: protocols (the canonical protocols), interfaces (the older names, aliased), and the CXP message in packet.
- Infrastructure access: infra_config, env_bootstrap, redis_factory, graph_factory with the graph repository seam, prolog_adapter with janus_bootstrap, config and state. The no-literal-fallback rule is in infra_env_rule.
- Observability and traceability: logging, monitoring, tracing, traceability and traceability_utils.
- Parallel test execution: threading.
- Claude Code integration: adapters.
- Utilities and gate support: patterns, artifact_store, capability_mesh, atomic_json, banned_libraries, gate_waivers, lru_cache, paths, standards, graph_directives and isolation.
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 |