Complete Module Matrix

Audience: engineers and architects who need a one-page map of every Stella Ops module — what it is, where its code lives, and how it is deployed. Source of truth: src/ is authoritative; this matrix is reconciled in passes and may lag a consolidation. When the matrix and the code disagree, the code wins. Module build entry points are the module solutions listed in docs/dev/SOLUTION_BUILD_GUIDE.md.

This document inventories the top-level modules in the Stella Ops platform. Several historical modules have been consolidated into a parent (for example Signer and Provenance into Attestor, Feedser and Excititor into Concelier, Scheduler and PacksRegistry into JobEngine); those rows are annotated with the consolidation sprint so the older names remain searchable.

Table of Contents


1. Module Count Explanation

The solution contains roughly four dozen top-level modules in src/. The architecture documentation focuses on the core user-facing modules; the table below groups them so the inventory in section 2 is easier to navigate. Counts are indicative, not a contract — the exact set shifts as modules are consolidated.

CategoryModules
Core PlatformAuthority, Router (hosts the Gateway WebService), Platform
Data IngestionConcelier (includes Feedser, Excititor), VexLens, VexHub, Mirror
Scanning & AnalysisScanner, BinaryIndex (includes Symbols), AdvisoryAI, ReachGraph
Artifacts & EvidenceAttestor (includes Signer, Provenance), SbomService, EvidenceLocker, ExportCenter, Provcache
Policy & RiskPolicy, Findings (includes RiskEngine, VulnExplorer), Unknowns
OperationsJobEngine (includes Scheduler, PacksRegistry), Notify, Notifier, Timeline, Replay
IntegrationCLI, Zastava, Web, API, Registry
InfrastructureCryptography, Telemetry, Graph, Signals, AirGap, AOC
Testing & BenchmarksBenchmark, Bench
Utility & InternalTools, SmRemote, PluginBinaries

Cartographer is retired (merged into Graph API). VulnExplorer and RiskEngine now live under Findings. src/Gateway/ was deleted (Sprint 200); the API gateway is hosted by Router as StellaOps.Gateway.WebService.


2. Complete Module Inventory

Core Platform (3 modules)

ModulePathPurposeWebServiceWorkerStorage
Authoritysrc/Authority/Authentication, authorization, OAuth/OIDC, DPoP, tenant management. Includes IssuerDirectory (Sprint 216).YesNoPostgreSQL (authority)
Routersrc/Router/Transport-agnostic messaging (TCP/TLS/UDP/RabbitMQ/Valkey) and HTTP ingress gateway. src/Gateway/ deleted (Sprint 200).YesNoValkey
Platformsrc/Platform/Platform Service aggregation APIs, console data compositionYesNoAggregates

Data Ingestion (4 modules)

ModulePathPurposeWebServiceWorkerStorage
Conceliersrc/Concelier/Vulnerability advisory ingestion (NVD, OSV, GHSA, CSAF), merge engine with AOC. Includes Feedser and Excititor (Sprint 203).YesYesPostgreSQL (vuln, vex)
VexLenssrc/VexLens/VEX consensus computation across issuers, conflict analysisYesNoPostgreSQL (cache)
VexHubsrc/VexHub/VEX distribution and exchange hubYesNoPostgreSQL
Mirrorsrc/Mirror/Vulnerability feed mirror and distributionYesYesRustFS

Scanning & Analysis (4 modules)

ModulePathPurposeWebServiceWorkerStorage
Scannersrc/Scanner/Container scanning with SBOM generation (11 language analyzers), call graphs. Cartographer retired (merged into Graph API).YesYesPostgreSQL (scanner) + RustFS
BinaryIndexsrc/BinaryIndex/Binary identity extraction and fingerprinting. Includes Symbols (Sprint 202).YesNoPostgreSQL
AdvisoryAIsrc/AdvisoryAI/AI-assisted advisory analysis and summarization. Includes OpsMemory (Sprint 213).YesNoPostgreSQL
ReachGraphsrc/ReachGraph/Reachability graph service, CVE reachability analysisYesNoPostgreSQL

Artifacts & Evidence (5 modules)

ModulePathPurposeWebServiceWorkerStorage
Attestorsrc/Attestor/in-toto/DSSE attestation generation, Rekor v2 integration. Includes Signer and Provenance (Sprint 204).YesNoPostgreSQL + RustFS
SbomServicesrc/SbomService/SBOM storage, versioning, and lineage ledgerYesNoPostgreSQL + RustFS
EvidenceLockersrc/EvidenceLocker/Sealed evidence storage and exportYesNoRustFS
ExportCentersrc/ExportCenter/Batch export and report generation (SARIF, SBOM, evidence bundles)YesNoRustFS
ProvcacheLibraryProvenance cache utilitiesLibraryN/AN/A

Policy & Risk (3 modules)

ModulePathPurposeWebServiceWorkerStorage
Policysrc/Policy/Policy engine with K4 lattice logic, confidence scoring, VEX emissionYesYesPostgreSQL (policy)
Unknownssrc/Unknowns/Unknown component and symbol tracking registry (boundary preserved, Sprint 206)YesNoPostgreSQL
Findingssrc/Findings/Centralized findings aggregation. Includes RiskEngine and VulnExplorer (Sprint 207).YesNoPostgreSQL

Operations (5 modules)

ModulePathPurposeWebServiceWorkerStorage
JobEnginesrc/JobEngine/Workflow orchestration, scheduling, pack registry. Includes Scheduler, PacksRegistry (Sprint 208); renamed from Orchestrator (Sprint 221). TaskRunner removed.YesYesPostgreSQL (orchestrator, scheduler)
Notifysrc/Notify/Unified notification service (shared libraries + merged WebService). Notifier WebService merged into Notify WebService (2026-04-08).YesN/APostgreSQL (notify)
Notifiersrc/Notifier/Notifier Worker (delivery engine). WebService merged into Notify (2026-04-08).N/AYesPostgreSQL (notify)
Timelinesrc/Timeline/Timeline query, event indexing, and replay. Includes TimelineIndexer (Sprint 210).YesNoPostgreSQL
Replaysrc/Replay/Deterministic replay engineYesNoPostgreSQL

Integration (5 modules)

ModulePathPurposeWebServiceWorkerStorage
CLIsrc/Cli/Command-line interface (Native AOT, multi-platform)CLIN/AN/A
Zastavasrc/Zastava/Container registry webhook observer, admission controlYesNoPostgreSQL
Websrc/Web/Angular 21 frontend SPAStaticN/AN/A
APIsrc/Api/OpenAPI contracts and governanceLibraryN/AN/A
Registrysrc/Registry/Container registry integration, token serviceYesNoPostgreSQL

Infrastructure (6 modules)

ModulePathPurposeWebServiceWorkerStorage
Cryptographysrc/Cryptography/Crypto plugins (FIPS, eIDAS, GOST, SM, PQ)LibraryN/AN/A
Telemetrysrc/Telemetry/OpenTelemetry traces, metrics, loggingLibraryN/AN/A
Graphsrc/Graph/Call graph and reachability data structuresLibraryN/AN/A
Signalssrc/Signals/Runtime signal collection and correlationLibraryN/AN/A
AirGapsrc/AirGap/Air-gapped deployment support, Offline Kit bundlingYesYesRustFS
AOCsrc/Aoc/Append-Only Contract enforcement (Roslyn analyzers)LibraryN/AN/A

Testing & Benchmarks (2 modules)

ModulePathPurposeWebServiceWorkerStorage
BenchmarkScanner libraryCompetitive benchmarking (accuracy comparison)ToolN/AN/A
Benchsrc/Bench/Performance benchmarksToolN/AN/A

Utility & Internal (3 modules)

Findings is detailed under Policy & Risk; it materializes effective findings from Policy outputs and feeds UI/CLI/Notify.

ModulePathPurposeNotes
SmRemotesrc/SmRemote/Remote SM2/SM3/SM4 cryptographic operationsIntegration utility
Toolssrc/Tools/Utility programs (fixture generators, migration scripts). Includes Bench, Verifier, Sdk, DevPortal (Sprint 212).Dev tooling
PluginBinariesVariousAuthority and Concelier plugin binariesPlugin hosting

3. Module Categories

Category membership below uses the consolidated module names from section 2 (for example Excititor is part of Concelier, Signer is part of Attestor, Scheduler is part of JobEngine). Historical names are kept only where they aid search.

By Runtime Type

TypeModules
WebService + WorkerScanner, Concelier, Policy, Notifier, AirGap, Mirror
WebService OnlyAuthority, Router (hosts Gateway WebService), Platform, VexLens, VexHub, BinaryIndex, AdvisoryAI, ReachGraph, Attestor, SbomService, EvidenceLocker, ExportCenter, Findings, Unknowns, JobEngine, Timeline, Replay, Zastava, Registry
LibraryProvcache, Notify, API, Cryptography, Telemetry, Graph, Signals, AOC
CLI/ToolCLI, Benchmark, Bench, Tools
StaticWeb (Angular SPA)

By Data Store

StoreModules
PostgreSQLAuthority, Concelier, VexLens, VexHub, Scanner, BinaryIndex, AdvisoryAI, ReachGraph, Attestor, SbomService, Policy, Findings, Unknowns, JobEngine, Notify/Notifier, Timeline, Replay, Zastava, Registry
RustFS (S3)Scanner, Attestor, SbomService, EvidenceLocker, ExportCenter, AirGap, Mirror
ValkeyRouter, Scanner, Policy, JobEngine, Notifier (queues/cache)
StatelessPlatform, CLI, Web

By Communication Pattern

PatternModules
HTTP RESTAll WebService modules
Binary Frame (Router)Gateway WebService to all backend services
Event Streams (Valkey/NATS)Scanner, Concelier, Policy, JobEngine, Notifier
Direct LibraryAll Library modules

4. Service Deployment Matrix

Replica counts below are illustrative deployment guidance, not hard requirements; “2+” means “run more than one for availability”, “N” means “scale by workload”.

ServiceContainer ImageReplicasStorageQueueObservable
Authoritystellaops/authority2+PostgreSQLValkey (DPoP)Yes
Router Gatewaystellaops/router-gateway2+Stateless (Valkey)-Yes
Scanner.Webstellaops/scanner-web2+PostgreSQL + RustFS-Yes
Scanner.Workerstellaops/scanner-workerNRustFSValkey/NATSYes
Concelier.Webstellaops/concelier-web2+PostgreSQL-Yes
Concelier.Workerstellaops/concelier-workerNPostgreSQLValkey/NATSYes
Policy.Enginestellaops/policy-engine2+PostgreSQLValkeyYes
Policy.Workerstellaops/policy-workerNPostgreSQLValkeyYes
Schedulerstellaops/scheduler2+PostgreSQLValkeyYes
Notifierstellaops/notifier2+PostgreSQLValkeyYes
ExportCenterstellaops/export-center2+RustFS-Yes
Web (UI)stellaops/web2+Static-Yes

5. Module Dependencies

Core Dependency Graph

                                    +-------------+
                                    |  Authority  |
                                    +------+------+
                                           |
              +----------------------------+----------------------------+
              |                            |                            |
              v                            v                            v
        +----------+                 +----------+                 +----------+
        |  Gateway |---------------->|  Scanner |---------------->|  Policy  |
        | (Router) |                 +----+-----+                 +----+-----+
        +----+-----+                      |                            |
             |                            v                            v
             |                      +----------+                 +-----------------+
             |                      | Concelier|                 |    Attestor     |
             |                      +----------+                 | (Signer +       |
             |                                                   |  Provenance)    |
             v                                                   +-----------------+
        +----------+
        | Web (UI) |
        +----------+

Concelier subsumes the former Feedser and Excititor ingestion paths; Attestor subsumes Signer and Provenance.

Key Integration Points

FromToIntegration
Gateway (Router)AuthorityToken validation (JWKS)
Gateway (Router)All ServicesBinary frame routing
ScannerAttestorSBOM signing (Signer) + in-toto attestation
PolicyConcelierAdvisory + VEX data (read-only)
PolicyScannerSBOM data (read-only)
JobEngine (Scheduler)ScannerTrigger rescans
JobEngine (Scheduler)ConcelierObserve advisory deltas
NotifierAll ServicesConsume events