AST Diagram — Package Dependencies

Component-level dependency graph of src/orchestrata_ultimate — each node is a top-level package, each edge a real import found in the source AST (tests excluded). For per-module class maps see the individual module pages.

orchestrata-ultimate package dependencies

29 nodes, 113 edges. Extracted with Python ast.


Generated from the live source AST by scripts/gen-ast-project-diagrams.py (re-run it, then scripts/render-diagrams.py, to refresh).


Structure tree (visual AST)

Real directory/module tree of src/orchestrata_ultimate, walked directly off disk (find ... -name "*.py") and cross-checked against docs/CODEBASE_MAP.md. Every node below is a path that exists on disk right now — no invented names.

Package overview — src root → all 27 top-level packages, each leaf carrying its true .py module count.

Diagram projects-orchestrata-ultimate-ast-diagrams-1

Deep tree 1/3 — agents/ (76 modules): 24 top-level files + swarm/ (3) + volks/ (49 across 5 shared files and 11 volk sub-packages).

Diagram projects-orchestrata-ultimate-ast-diagrams-2

Deep tree 2/3 — factory/ (72 modules): only __init__.py at top level, all else in 16 sub-packages.

Diagram projects-orchestrata-ultimate-ast-diagrams-3

Deep tree 3/3 — verification/ (64 modules): 6 top-level files + 16 sub-packages (includes a nested verification/verification/ engine+feedback pair).

Diagram projects-orchestrata-ultimate-ast-diagrams-4

Class-level diagrams — kernel, volks, factory scheduler

Hand-verified against the live source (grep/AST, 2026-07-24) — every class, method, and inheritance edge below exists in src/orchestrata_ultimate as shown.

Kernel core — OrchestrataKernel/OrchestrationKernel implementing the component protocol, plus MessageDispatcher's dispatch-result model

Diagram projects-orchestrata-ultimate-ast-diagrams-5

Volks — BaseAgent (Pydantic BaseModel) and its concrete per-role subclasses, all overriding process()

Diagram projects-orchestrata-ultimate-ast-diagrams-6

Thin *Agent aliases (QualityAssuranceAgent(QaVolk), ProjectManagerAgent(PMVolk), CodeDirectorAgent(CodeDirectorVolk), JuniorAgent(JuniorVolk), UserExperienceAgent(UXVolk), ConciergeAgent(ConciergeVolk), DocumentorAgent(DocumentorVolk), ComplianceAgent(ComplianceVolk)) exist as one-line pass-body subclasses of the volks above and are omitted here for readability.

Factory build scheduler (SPEC-033 §9, B9) — function/call ownership, not OO (run_pipeline is a free function)

Diagram projects-orchestrata-ultimate-ast-diagrams-7