Module Landscape Overview

The Stella Ops Suite comprises existing modules (vulnerability scanning) and new modules (release orchestration). Modules are organized into themes (functional areas).

Architecture Diagram

┌─────────────────────────────────────────────────────────────────────────────────┐
│                           STELLA OPS SUITE                                      │
│                                                                                 │
│  ┌───────────────────────────────────────────────────────────────────────────┐ │
│  │                    EXISTING THEMES (Vulnerability)                        │ │
│  │                                                                           │ │
│  │  INGEST          VEXOPS         REASON         SCANENG        EVIDENCE   │ │
│  │  ├─concelier     ├─excititor    ├─policy       ├─scanner      ├─locker   │ │
│  │  └─advisory-ai   └─linksets     └─opa-runtime  ├─sbom-gen     ├─export   │ │
│  │                                                └─reachability └─timeline │ │
│  │                                                                           │ │
│  │  RUNTIME         JOBCTRL        OBSERVE        REPLAY         DEVEXP     │ │
│  │  ├─signals       ├─scheduler    ├─notifier     └─replay-core  ├─cli      │ │
│  │  ├─graph         ├─orchestrator └─telemetry                   ├─web-ui   │ │
│  │  └─zastava       └─task-runner                                └─sdk      │ │
│  └───────────────────────────────────────────────────────────────────────────┘ │
│                                                                                 │
│  ┌───────────────────────────────────────────────────────────────────────────┐ │
│  │                    NEW THEMES (Release Orchestration)                     │ │
│  │                                                                           │ │
│  │  INTHUB (Integration Hub)                                                 │ │
│  │  ├─integration-manager        Central registry of configured integrations │ │
│  │  ├─connection-profiles        Default settings + credential management   │ │
│  │  ├─connector-runtime          Plugin connector execution environment     │ │
│  │  └─doctor-checks              Integration health diagnostics             │ │
│  │                                                                           │ │
│  │  ENVMGR (Environment & Inventory)                                         │ │
│  │  ├─environment-manager        Environment CRUD, ordering, config         │ │
│  │  ├─target-registry            Deployment targets (hosts/services)        │ │
│  │  ├─agent-manager              Agent registration, health, capabilities   │ │
│  │  └─inventory-sync             Drift detection, state reconciliation      │ │
│  │                                                                           │ │
│  │  RELMAN (Release Management)                                              │ │
│  │  ├─component-registry         Image repos → components mapping           │ │
│  │  ├─version-manager            Tag/digest → semver mapping                │ │
│  │  ├─release-manager            Release bundle lifecycle                   │ │
│  │  └─release-catalog            Release history, search, compare           │ │
│  │                                                                           │ │
│  │  WORKFL (Workflow Engine)                                                 │ │
│  │  ├─workflow-designer          Template creation, step graph editor       │ │
│  │  ├─workflow-engine            DAG execution, state machine               │ │
│  │  ├─step-executor              Step dispatch, retry, timeout              │ │
│  │  └─step-registry              Built-in + plugin-provided steps           │ │
│  │                                                                           │ │
│  │  PROMOT (Promotion & Approval)                                            │ │
│  │  ├─promotion-manager          Promotion request lifecycle                │ │
│  │  ├─approval-gateway           Approval collection, SoD enforcement       │ │
│  │  ├─decision-engine            Gate evaluation, policy integration        │ │
│  │  └─gate-registry              Built-in + custom gates                    │ │
│  │                                                                           │ │
│  │  DEPLOY (Deployment Execution)                                            │ │
│  │  ├─deploy-orchestrator        Deployment job coordination                │ │
│  │  ├─target-executor            Target-specific deployment logic           │ │
│  │  ├─runner-executor            Script/hook execution sandbox              │ │
│  │  ├─artifact-generator         Compose/script artifact generation         │ │
│  │  └─rollback-manager           Rollback orchestration                     │ │
│  │                                                                           │ │
│  │  AGENTS (Deployment Agents)                                               │ │
│  │  ├─agent-core                 Shared agent runtime                       │ │
│  │  ├─agent-docker               Docker host agent                          │ │
│  │  ├─agent-compose              Docker Compose agent                       │ │
│  │  ├─agent-ssh                  SSH remote executor                        │ │
│  │  ├─agent-winrm                WinRM remote executor                      │ │
│  │  ├─agent-ecs                  AWS ECS agent                              │ │
│  │  └─agent-nomad                HashiCorp Nomad agent                      │ │
│  │                                                                           │ │
│  │  PROGDL (Progressive Delivery)                                            │ │
│  │  ├─ab-manager                 A/B release coordination                   │ │
│  │  ├─traffic-router             Router plugin orchestration                │ │
│  │  ├─canary-controller          Canary ramp automation                     │ │
│  │  └─rollout-strategy           Strategy templates                         │ │
│  │                                                                           │ │
│  │  RELEVI (Release Evidence)                                                │ │
│  │  ├─evidence-collector         Evidence aggregation                       │ │
│  │  ├─evidence-signer            Cryptographic signing                      │ │
│  │  ├─sticker-writer             Version sticker generation                 │ │
│  │  └─audit-exporter             Compliance report generation               │ │
│  │                                                                           │ │
│  │  PLUGIN (Plugin Infrastructure)                                           │ │
│  │  ├─plugin-registry            Plugin discovery, versioning               │ │
│  │  ├─plugin-loader              Plugin lifecycle management                │ │
│  │  ├─plugin-sandbox             Isolation, resource limits                 │ │
│  │  └─plugin-sdk                 SDK for plugin development                 │ │
│  └───────────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────────┘

Theme Summary

Existing Themes (Vulnerability Scanning)

ThemePurposeKey Modules
INGESTAdvisory ingestionconcelier, advisory-ai
VEXOPSVEX document handlingexcititor, linksets
REASONPolicy and decisioningpolicy, opa-runtime
SCANENGScanning and SBOMscanner, sbom-gen, reachability
EVIDENCEEvidence and attestationlocker, export, timeline
RUNTIMERuntime signalssignals, graph, zastava
JOBCTRLJob orchestrationscheduler, orchestrator, task-runner
OBSERVEObservabilitynotifier, telemetry
REPLAYDeterministic replayreplay-core
DEVEXPDeveloper experiencecli, web-ui, sdk

New Themes (Release Orchestration)

ThemePurposeKey ModulesDocumentation
INTHUBIntegration hubintegration-manager, connection-profiles, connector-runtime, doctor-checksDetails
ENVMGREnvironment & inventoryenvironment-manager, target-registry, agent-manager, inventory-syncDetails
RELMANRelease managementcomponent-registry, version-manager, release-manager, release-catalogDetails
WORKFLWorkflow engineworkflow-designer, workflow-engine, step-executor, step-registryDetails
PROMOTPromotion & approvalpromotion-manager, approval-gateway, decision-engine, gate-registryDetails
DEPLOYDeployment executiondeploy-orchestrator, target-executor, runner-executor, artifact-generator, rollback-managerDetails
AGENTSDeployment agentsagent-core, agent-docker, agent-compose, agent-ssh, agent-winrm, agent-ecs, agent-nomadDetails
PROGDLProgressive deliveryab-manager, traffic-router, canary-controller, rollout-strategyDetails
RELEVIRelease evidenceevidence-collector, evidence-signer, sticker-writer, audit-exporterDetails
PLUGINPlugin infrastructureplugin-registry, plugin-loader, plugin-sandbox, plugin-sdkDetails

Module Dependencies

                    ┌──────────────┐
                    │   AUTHORITY  │
                    └──────┬───────┘
                           │
        ┌──────────────────┼──────────────────┐
        │                  │                  │
        ▼                  ▼                  ▼
┌───────────────┐  ┌───────────────┐  ┌───────────────┐
│    INTHUB     │  │    ENVMGR     │  │    PLUGIN     │
│ (Integrations)│  │ (Environments)│  │  (Plugins)    │
└───────┬───────┘  └───────┬───────┘  └───────┬───────┘
        │                  │                  │
        └──────────┬───────┴──────────────────┘
                   │
                   ▼
           ┌───────────────┐
           │    RELMAN     │
           │  (Releases)   │
           └───────┬───────┘
                   │
                   ▼
           ┌───────────────┐
           │    WORKFL     │
           │  (Workflows)  │
           └───────┬───────┘
                   │
        ┌──────────┴──────────┐
        │                     │
        ▼                     ▼
┌───────────────┐     ┌───────────────┐
│    PROMOT     │     │    DEPLOY     │
│  (Promotion)  │     │ (Deployment)  │
└───────┬───────┘     └───────┬───────┘
        │                     │
        │                     ▼
        │             ┌───────────────┐
        │             │    AGENTS     │
        │             │   (Agents)    │
        │             └───────┬───────┘
        │                     │
        └──────────┬──────────┘
                   │
                   ▼
           ┌───────────────┐
           │    RELEVI     │
           │  (Evidence)   │
           └───────────────┘

Communication Patterns

PatternUsage
Synchronous APIUser-initiated operations (CRUD, queries)
Event BusCross-module notifications (domain events)
Task QueueLong-running operations (deployments, syncs)
WebSocket/SSEReal-time UI updates
gRPC StreamsAgent communication

Database Schema Organization

Each theme owns a PostgreSQL schema:

SchemaOwner Theme
release.integrationsINTHUB
release.environmentsENVMGR
release.componentsRELMAN
release.workflowsWORKFL
release.promotionsPROMOT
release.deploymentsDEPLOY
release.agentsAGENTS
release.evidenceRELEVI
release.pluginsPLUGIN