Skip to content

Releases: texasbe2trill/constellation-engine

Initial Release (v0.1.0)

23 Dec 16:21
v0.1.0
49b2086

Choose a tag to compare

Constellation Engine — Initial Release (v0.1.0)

This release introduces the first complete, usable slice of Constellation Engine: a deterministic system for modeling service dependencies and reasoning about failure impact.

Included

Core modeling

  • Typed domain model for services and dependencies
  • Explicit dependency semantics (src -> dst means src depends on dst)
  • Validation of system invariants before analysis

Dependency graph

  • Deterministic graph construction from validated models
  • Clear separation between input schema and internal domain types

Failure propagation

  • Deterministic blast radius computation for simulated failures
  • Supported failure types: down, degraded, latency_up
  • Reverse-edge propagation to model impact on dependers
  • Propagation rules: degraded travels only over hard deps; latency_up only over sync calls

Criticality analysis

  • Ranks services by blast radius size
  • Surfaces single points of failure and shared dependencies

CLI (constellation-engine)

  • validate — verify manifest correctness
  • stats — basic structural insights
  • blast-radius — simulate failure impact (--service and --failure required)
  • criticality — rank services by risk (supports --failure, --top)

Packaging & tooling

  • Installable Python package with constellation-engine console script
  • Test suite covering validation, propagation, and criticality
  • CI workflow with linting, type checking, and tests

Non-Goals (Intentional)

  • No live monitoring, alerting, or remediation
  • No probabilistic or opaque reasoning
  • No runtime state or “current outage” modeling

Status

Initial release focused on correctness, clarity, and architectural reasoning. Future releases may expand analysis depth and add optional explanation layers, but deterministic behavior remains the foundation.