Architecture Decision Records (ADRs)¶

ADR-001 (API-Centric)
    ├── ADR-002 (Scheduler) ─────┐
    │       └── ADR-006 (HA) ◄───┤
    │                            │
    ├── ADR-005 (State Store) ◄──┘
    │       └── ADR-006 (HA)
    │
    └── ADR-013 (SSE Improvements)
            └── no controller-direct Redis

ADR-003 (CloudEvents)
    └── ADR-004 (Ports)

ADR-007 (Templates) ← standalone

ADR-008 (Draining)
    └── ADR-002 (Scheduler)

ADR-009 (Shared Core)
    └── ADR-010 (Neuroglia Unification)

ADR-010 (Neuroglia Unification)
    ├── ADR-011 (APScheduler Removal)
    └── ADR-012 (Dynamic Region Config)

ADR-011 (APScheduler Removal)
    └── controller-based execution replaces jobs

ADR-012 (Dynamic Region Config)
    └── SystemSettings + WorkerReconciler._run_discovery_loop()

ADR-013 (SSE Improvements)
    └── batching, filtering, extended events

ADR-018 (LDS Integration)
    ├── ADR-017 (Lab Operations via Lablet-Controller)
    ├── ADR-020 (Session Entity Model) ← amends terminology
    └── ADR-022 (CloudEvent Ingestion) ← amends routing

ADR-019 (LabRecord)
    └── ADR-020 (Session Entity Model) ← supersedes binding model

ADR-020 (Session Entity Model)
    ├── ADR-018 (LDS Integration)
    ├── ADR-019 (LabRecord) ← partially supersedes
    └── ADR-021 (Child Entities)

ADR-021 (Child Entity Architecture)
    ├── ADR-020 (Session Entity Model)
    └── ADR-022 (CloudEvent Ingestion)

ADR-022 (CloudEvent Ingestion)
    ├── ADR-003 (CloudEvents)
    ├── ADR-015 (Control Plane API No External Calls)
    └── ADR-018 (LDS Integration) ← amends §7

# Content Synchronization cluster (ADR-023–028)
ADR-023 (Content Sync Trigger)
    ├── ADR-005 (Dual State Store) ← extends etcd key namespace
    ├── ADR-015 (CPA No External Calls)
    ├── ADR-017 (Lab Operations) ← extends reconciliation pattern
    ├── ADR-024 (Package Storage)
    ├── ADR-025 (Content Metadata)
    └── ADR-026 (Upstream Notifier)

ADR-024 (Package Storage in RustFS)
    └── ADR-025 (Content Metadata) ← complementary

ADR-025 (Content Metadata in MongoDB)
    ├── ADR-005 (Dual State Store)
    └── ADR-024 (Package Storage) ← complementary

ADR-026 (Upstream Notifier Pattern)
    └── ADR-018 (LDS Integration)

ADR-027 (Version Auto-Increment)
    ├── ADR-023 (Content Sync Trigger)
    └── ADR-028 (Definition Initial Status)

ADR-028 (Definition Initial Status)
    ├── ADR-023 (Content Sync Trigger)
    └── ADR-027 (Version Auto-Increment)

ADR-029 (Port Template Extraction)
    ├── ADR-025 (Content Metadata Storage)
    └── ADR-028 (Definition Initial Status)

ADR-030 (Resource & Port Observation — Learn from Live)
    ├── ADR-004 (Port Allocation per Worker)
    ├── ADR-017 (Lab Operations via Lablet-Controller)
    ├── ADR-020 (Session Entity Model)
    └── ADR-029 (Port Template Extraction)

# Instantiation Pipeline cluster (ADR-031–033)
ADR-031 (Checkpoint Pipeline)
    ├── ADR-004 (Port Allocation per Worker)
    ├── ADR-017 (Lab Operations via Lablet-Controller)
    ├── ADR-020 (Session Entity Model)
    ├── ADR-029 (Port Template Extraction)
    ├── ADR-030 (Resource Observation)
    ├── ADR-032 (Port Allocation on LabRecord)
    └── ADR-033 (CML Node Tag Sync)

ADR-032 (Port Allocation as LabRecord Topology)
    ├── ADR-004 (Port Allocation per Worker)
    ├── ADR-019 (LabRecord as AggregateRoot)
    ├── ADR-020 (Session Entity Model)
    ├── ADR-029 (Port Template Extraction)
    ├── ADR-031 (Checkpoint Pipeline)
    └── ADR-033 (CML Node Tag Sync)

ADR-033 (CML Node Tag Sync)
    ├── ADR-004 (Port Allocation per Worker)
    ├── ADR-017 (Lab Operations via Lablet-Controller)
    ├── ADR-029 (Port Template Extraction)
    ├── ADR-031 (Checkpoint Pipeline)
    └── ADR-032 (Port Allocation on LabRecord)

ADR-039 (SSE Race Condition Fix)
    ├── ADR-013 (SSE Protocol Improvements)
    └── ADR-001 (API-Centric State Management)

ADR-040 (LDS CloudEvent Direct Ingestion via CPA)
    ├── ADR-003 (CloudEvents)
    ├── ADR-015 (CPA No External Calls)
    ├── ADR-018 (LDS Integration)
    └── ADR-022 (CloudEvent Ingestion) ← amends (dual routing)

# Worker / runtime hardening (ADR-041–043)
ADR-041 (WebSocket-Based CML Worker Monitoring)
    └── ADR-013 (SSE Protocol Improvements)

ADR-042 (CommandHandlerBase Dependency Simplification)
    └── ADR-010 (Service Unification on Neuroglia)

ADR-043 (Startup State Reconciliation and Discovery Separation)
    ├── ADR-012 (Dynamic Region Configuration)
    └── ADR-014 (Worker Orphan Detection)

# Generalized resource-plane cluster (current model — ADR-036 + 044–054, all Proposed)
ADR-036 (Resource Management Abstraction Layer) ← layered state base
    ├── ADR-037 (Timeslot Management)
    ├── ADR-046 (Host / PodType–HostType Split) ← extends
    ├── ADR-047 (Generic Reconciliation Framework) ← extends (with ADR-038)
    └── ADR-050 (Definition/Instance Duality) ← extends

ADR-044 (ScenarioEngine — Pod Automation as a Separate Service, Rev 2)
    ├── supersedes Rev 1 (in-process design)
    └── ADR-049 (Unified Workflow DSL) ← job/step description

ADR-045 (Multi-part Session / Part Model)
    ├── ADR-036 (Resource Abstraction)
    ├── ADR-020 (Session Entity Model) ← supersedes (state machine → part level)
    ├── ADR-021 (Child Entity Architecture) ← supersedes (part model)
    ├── ADR-046 (Host / Type split)
    └── ADR-047 (Generic Reconciliation)

ADR-047 (Generic Reconciliation Framework)
    ├── ADR-036 (Resource Abstraction)
    ├── ADR-038 (Step Handler Registry) ← extends
    └── ADR-054 (Controller Topology) ← maps managers → services

ADR-050 (Definition/Instance Duality)
    ├── ADR-036 (Resource Abstraction) ← extends
    ├── ADR-051 (Provisioning Sources) ← extends
    ├── ADR-052 (Content-Authoring Taxonomy) ← extends
    └── ADR-053 (Authorization Policy Model) ← extends

ADR-051 (Provisioning Sources)
    ├── ADR-050 (Definition/Instance Duality)
    └── ADR-023–028 (Content Sync cluster) ← reconciles content_package source

ADR-052 (Content-Authoring Taxonomy)
    ├── ADR-050 / ADR-051
    ├── ADR-044 (Content-driven lifecycle / SE)
    └── ADR-045 (Multi-part — supplies the Forms parts select)

ADR-053 (Authorization Policy Model)
    ├── ADR-050 (Definition/Instance Duality)
    └── ADR-001 (API-Centric State Management)

ADR-054 (Controller Topology by Resource Kind)
    ├── ADR-047 (Per-type managers) ← extends
    ├── ADR-016 (License ops) ← supersedes topology
    ├── ADR-017 (Lab ops) ← supersedes topology
    ├── ADR-002 (Resource Scheduler) ← re-scopes role
    ├── ADR-035 (Legacy Scheduler Removal) ← re-scopes role
    └── ADR-046 (Host adapters live inside pod-controller)