Cartographer Module

Status: Implemented Source: src/Cartographer/

Purpose

The Cartographer service materializes immutable SBOM property graphs, precomputes layout tiles, and hydrates policy and VEX overlays so other services (API, UI, CLI) can navigate and reason about dependency relationships with context.

Components

Services:

StellaOps.Cartographer - Core graph materialization, overlay management, and tile serving

Key Features

Graph Materialization - Convert normalized SBOMs (CycloneDX/SPDX) into immutable, versioned graph snapshots
Property Graph Generation - Build dependency relationship graphs with context-aware nodes and edges
Overlay Hydration - Merge Policy Engine findings and VEX metadata onto graph nodes and edges
Layout Tiles - Precomputed viewport tiles for efficient UI navigation
Path Relevance - Compute path importance within the dependency graph
Graph Diffing - Compare SBOM versions to track changes
Tenant-Aware Storage - Per-tenant graph isolation and versioning

API Capabilities

Viewport tile serving for large graphs (≥50k nodes)
Path exploration and filtering
Graph export and simulation overlays
RBAC-enforced access control via Authority

Dependencies

PostgreSQL - Graph and overlay storage
Policy Engine - Effective findings computation
SBom Service - Normalized SBOM projections
Excititor - VEX metadata ingestion
Authority - Authentication and RBAC enforcement (scopes: graph:*, sbom:read, findings:read)
Scheduler - Overlay update coordination

Architecture Charter: See src/Cartographer/StellaOps.Cartographer/AGENTS.md for charter and responsibilities
Sprint Plan: Check docs/implplan/SPRINT_*.md for current development status
Tasks: Completed tasks documented in src/Cartographer/StellaOps.Cartographer/TASKS.completed.md

Current Status

Active development. Materializes immutable SBOM property graphs with overlay hydration, deterministic snapshots, and optimized tile serving for dependency navigation.

README.md