{"id":42013549,"url":"https://github.com/texasbe2trill/constellation-engine","last_synced_at":"2026-01-26T02:45:38.531Z","repository":{"id":330193991,"uuid":"1121288383","full_name":"texasbe2trill/constellation-engine","owner":"texasbe2trill","description":"A dependency graph–driven system for reasoning about failure propagation, blast radius, and architectural risk in complex systems.","archived":false,"fork":false,"pushed_at":"2025-12-23T19:56:27.000Z","size":39,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-25T09:49:00.880Z","etag":null,"topics":["ai-reasoning","architecture","good-first-issue","graph-theory","python","reliability-engineering","systems-engineering"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/texasbe2trill.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"texasbe2trill","buy_me_a_coffee":"texasbe2trill"}},"created_at":"2025-12-22T18:33:58.000Z","updated_at":"2025-12-23T19:56:27.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/texasbe2trill/constellation-engine","commit_stats":null,"previous_names":["texasbe2trill/constellation-engine"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/texasbe2trill/constellation-engine","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/texasbe2trill%2Fconstellation-engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/texasbe2trill%2Fconstellation-engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/texasbe2trill%2Fconstellation-engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/texasbe2trill%2Fconstellation-engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/texasbe2trill","download_url":"https://codeload.github.com/texasbe2trill/constellation-engine/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/texasbe2trill%2Fconstellation-engine/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28765350,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T02:25:41.078Z","status":"ssl_error","status_checked_at":"2026-01-26T02:24:28.809Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-reasoning","architecture","good-first-issue","graph-theory","python","reliability-engineering","systems-engineering"],"created_at":"2026-01-26T02:45:33.746Z","updated_at":"2026-01-26T02:45:38.525Z","avatar_url":"https://github.com/texasbe2trill.png","language":"Python","readme":"# Constellation Engine\n\n\u003e A deterministic dependency reasoning engine for analyzing failure propagation in distributed systems\n\nConstellation Engine is an open-source tool designed to model complex system architectures as explicit dependency graphs and compute failure blast radius before incidents occur. By focusing on system structure rather than runtime metrics, it provides deterministic answers to critical architectural questions: *What breaks when this service fails?*\n\n## Core Capabilities\n\n**Graph-Based System Modeling**\n- Represents services and their dependencies as a directed graph\n- Validates architectural definitions against invariants\n- Supports complex topologies including microservices, workers, and infrastructure\n\n**Failure Impact Analysis**\n- Computes blast radius for different failure scenarios\n- Ranks service criticality by downstream impact\n- Provides deterministic, reproducible results\n\n**Architectural Visibility**\n- Makes hidden coupling and cascading failures explicit\n- Identifies single points of failure\n- Quantifies architectural risk before deployment\n\n## What This Is Not\n\nConstellation Engine is intentionally **not**:\n- A monitoring or observability platform\n- An alerting or incident response tool\n- A probabilistic or ML-based system\n\nIt focuses purely on structural dependency analysis using deterministic rules.\n\n## Quick Start\n\n### Install\n\n```bash\n# From the repo root (editable for local development)\npip install -e .\n# or install directly from a published wheel/sdist\npip install constellation-engine\n```\n\nThis installs the `constellation-engine` console script defined in `pyproject.toml`.\n\n### Basic Commands\n\n```bash\n# Validate system definition\nconstellation-engine validate docs/examples/simple.yaml\n\n# View system statistics\nconstellation-engine stats docs/examples/simple.yaml\n\n# Analyze blast radius for a service failure (flags are required)\nconstellation-engine blast-radius --service db --failure down docs/examples/simple.yaml\n```\n\n### Run Tests\n\n```bash\npython -m pytest -q\n```\n```text\n.....                                                    [100%]\n5 passed in 0.08s\n```\n\n## Enterprise Example\n\nConstellation Engine includes a comprehensive enterprise architecture example at `docs/examples/enterprise.yaml` modeling a distributed e-commerce platform with 20+ services.\n\n### Criticality Analysis\n\nIdentify which services have the highest downstream impact:\n\n```bash\nconstellation-engine criticality docs/examples/enterprise.yaml\n```\n```text\ncriticality ranking (failure=down):\n- postgres: impacts 18 services\n- telemetry: impacts 16 services\n- kafka: impacts 13 services\n- audit-log: impacts 9 services\n- redis: impacts 8 services\n- elastic: impacts 8 services\n- catalog: impacts 7 services\n- orders: impacts 6 services\n- payments: impacts 5 services\n- inventory: impacts 5 services\n```\n\n### Blast Radius Analysis\n\nAnalyze the cascading impact of critical infrastructure failures:\n\n**Scenario: PostgreSQL Database Failure**\n```bash\nconstellation-engine blast-radius --service postgres --failure down docs/examples/enterprise.yaml\n```\nBoth `--service` and `--failure` are required flags; omitting either will return a usage error.\n```text\nblast radius from postgres (down) [impacts dependers]:\n- postgres: down\n- user: down\n- auth: down\n- catalog: down\n- payments: down\n- orders: down\n- inventory: down\n- shipping: down\n- orders-worker-1: down\n- orders-worker-2: down\n- orders-worker-3: down\n- api-gateway: down\n- catalog-read-us: down\n- catalog-read-eu: down\n- catalog-read-apac: down\n- checkout: down\n- web-frontend: down\n- mobile-api: down\n```\n\n*Result: 17 of 20 services impacted by a single database failure — a critical architectural dependency.*\n\n## Architecture\n\n### Dependency Semantics\nEdges in the dependency graph are defined as:\n```\nsrc → dst  means  \"src depends on dst\"\n```\n\nWhen `dst` fails, `src` becomes impacted. This simple semantic enables deterministic propagation analysis.\n\n### Project Structure\n```\nconstellation_engine/\n├── cli/          # Command-line interface\n├── core/         # Graph modeling and validation\n├── io/           # Manifest loading and schema validation\n└── sim/          # Failure propagation and criticality analysis\n```\n\n## Use Cases\n\n- **Pre-Production Architecture Review**: Identify critical dependencies before deployment\n- **Incident Response Planning**: Understand blast radius for incident scenarios\n- **System Design Validation**: Quantify the impact of architectural decisions\n- **Risk Assessment**: Identify single points of failure in distributed systems\n\n## Development Status\n\nConstellation Engine is under active development. The current version provides deterministic dependency modeling and failure propagation analysis. Future enhancements may include advanced graph algorithms and integration capabilities.\n\n## License\n\nThis project is open source. See [LICENSE](LICENSE) for details.\n","funding_links":["https://github.com/sponsors/texasbe2trill","https://buymeacoffee.com/texasbe2trill"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftexasbe2trill%2Fconstellation-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftexasbe2trill%2Fconstellation-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftexasbe2trill%2Fconstellation-engine/lists"}