Releases: texasbe2trill/constellation-engine
Releases · texasbe2trill/constellation-engine
Initial Release (v0.1.0)
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 -> dstmeanssrcdepends ondst) - 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:
degradedtravels only over hard deps;latency_uponly 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 correctnessstats— basic structural insightsblast-radius— simulate failure impact (--serviceand--failurerequired)criticality— rank services by risk (supports--failure,--top)
Packaging & tooling
- Installable Python package with
constellation-engineconsole 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.