# deeep095/infrastructure_reality architecture

> Architecture diagram of the GitHub repository deeep095/infrastructure_reality, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/deeep095/infrastructure_reality
- Repository: https://github.com/deeep095/infrastructure_reality

## Overview

reality is a read-only cloud discovery and local blast-radius tool. Users scan Terraform exports and, only with explicit opt-in, selected AWS sources; the scan stores evidence and relationship candidates locally. Reconciliation compares declared and observed facts, then users inspect findings with why, traverse impact, or simulate a Terraform plan. The graph preserves the documented graph-export and hidden-dependency capabilities. Edges are limited to README statements and source-index references; unsampled implementation details are not inferred.

Main entry points: [`src/reality/cli.py`](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/cli.py) (CLI commands), [`src/reality/services/scan.py`](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/scan.py) (Scan orchestrator), [`src/reality/services/reports.py`](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/reports.py) (Why and reports), [`src/reality/storage/repositories.py`](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/storage/repositories.py) (Evidence repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Command entry"]
  node_cli["CLI commands<br/>[cli.py]"]
  node_config["Runtime config<br/>[config.py]"]
  node_doctor["Environment checks<br/>[doctor.py]"]
end

subgraph group_collection["Discovery sources"]
  node_scan["Scan orchestrator<br/>[scan.py]"]
  node_terraform["Terraform parser<br/>[terraform.py]"]
  node_aws["AWS resource adapter<br/>[aws_resources.py]"]
  node_iam["IAM adapter<br/>[iam.py]"]
  node_cloudtrail["CloudTrail adapter<br/>[cloudtrail.py]"]
end

subgraph group_analysis["Evidence analysis"]
  node_identity["Identity mapping<br/>[identity.py]"]
  node_reconcile["Reconciliation<br/>[reconcile.py]"]
  node_graph["Graph view/export<br/>[graph.py]"]
  node_impact["Impact and simulation<br/>[impact.py]"]
  node_reports["Why and reports<br/>[reports.py]"]
  node_hidden["Hidden dependencies"]
  node_domain["Evidence contracts<br/>[models.py]"]
end

subgraph group_storage["Local evidence store"]
  node_repositories["Evidence repositories<br/>[repositories.py]"]
  node_sqlite[("SQLite store<br/>[sqlite.py]")]
  node_migrations["Schema migrations<br/>[migrations.py]"]
end

node_user(("Operator"))

node_user -->|"runs commands"| node_cli
node_cli -->|"loads settings"| node_config
node_cli -->|"runs scan"| node_scan
node_cli -->|"runs reconcile"| node_reconcile
node_cli -->|"requests why"| node_reports
node_cli -->|"requests impact"| node_impact
node_cli -->|"runs doctor"| node_doctor
node_scan -->|"parses exports"| node_terraform
node_scan -->|"collects resources"| node_aws
node_scan -->|"collects policies"| node_iam
node_scan -->|"collects events"| node_cloudtrail
node_scan -->|"resolves identities"| node_identity
node_scan -->|"stores scan data"| node_repositories
node_terraform -->|"produces records"| node_domain
node_aws -->|"produces records"| node_domain
node_iam -->|"produces records"| node_domain
node_cloudtrail -->|"produces records"| node_domain
node_reconcile -->|"reads graph"| node_graph
node_reconcile -->|"writes findings"| node_repositories
node_graph -->|"reads relationships"| node_repositories
node_impact -->|"traverses graph"| node_graph
node_impact -->|"parses plan"| node_terraform
node_impact -->|"reads stored data"| node_repositories
node_reports -->|"assembles reports"| node_graph
node_reports -->|"renders impact"| node_impact
node_reports -->|"renders findings"| node_reconcile
node_reports -->|"reports hidden links"| node_hidden
node_reports -->|"reads evidence"| node_repositories
node_repositories -->|"queries database"| node_sqlite
node_migrations -->|"uses connection"| node_sqlite

click node_cli "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/cli.py"
click node_config "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/config.py"
click node_doctor "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/doctor.py"
click node_scan "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/scan.py"
click node_terraform "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/adapters/terraform.py"
click node_aws "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/adapters/aws_resources.py"
click node_iam "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/adapters/iam.py"
click node_cloudtrail "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/adapters/cloudtrail.py"
click node_identity "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/identity.py"
click node_reconcile "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/reconcile.py"
click node_graph "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/graph.py"
click node_impact "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/impact.py"
click node_reports "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/reports.py"
click node_hidden "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/hidden_dependencies.py"
click node_domain "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/domain/models.py"
click node_repositories "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/storage/repositories.py"
click node_sqlite "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/storage/sqlite.py"
click node_migrations "https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/storage/migrations.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_config,node_doctor toneBlue
class node_scan,node_terraform,node_aws,node_iam,node_cloudtrail toneAmber
class node_identity,node_reconcile,node_graph,node_impact,node_reports,node_hidden,node_domain toneMint
class node_repositories,node_sqlite,node_migrations toneRose
class node_user toneIndigo
```

## Components

### Command entry

- [CLI commands](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/cli.py): `src/reality/cli.py`
- [Runtime config](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/config.py): `src/reality/config.py`
- [Environment checks](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/doctor.py): `src/reality/services/doctor.py`

### Discovery sources

- [Scan orchestrator](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/scan.py): `src/reality/services/scan.py`
- [Terraform parser](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/adapters/terraform.py): `src/reality/adapters/terraform.py`
- [AWS resource adapter](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/adapters/aws_resources.py): `src/reality/adapters/aws_resources.py`
- [IAM adapter](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/adapters/iam.py): `src/reality/adapters/iam.py`
- [CloudTrail adapter](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/adapters/cloudtrail.py): `src/reality/adapters/cloudtrail.py`

### Evidence analysis

- [Identity mapping](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/identity.py): `src/reality/services/identity.py`
- [Reconciliation](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/reconcile.py): `src/reality/services/reconcile.py`
- [Graph view/export](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/graph.py): `src/reality/services/graph.py`
- [Impact and simulation](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/impact.py): `src/reality/services/impact.py`
- [Why and reports](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/reports.py): `src/reality/services/reports.py`
- [Hidden dependencies](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/services/hidden_dependencies.py): `src/reality/services/hidden_dependencies.py`
- [Evidence contracts](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/domain/models.py): `src/reality/domain/models.py`

### Local evidence store

- [Evidence repositories](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/storage/repositories.py): `src/reality/storage/repositories.py`
- [SQLite store](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/storage/sqlite.py): `src/reality/storage/sqlite.py`
- [Schema migrations](https://github.com/deeep095/infrastructure_reality/blob/main/src/reality/storage/migrations.py): `src/reality/storage/migrations.py`

### Other components

- **Operator**

## Connections

- Operator → CLI commands: runs commands (evidence: `README.md`)
- CLI commands → Runtime config: loads settings (evidence: `src/reality/cli.py`)
- CLI commands → Scan orchestrator: runs scan (evidence: `src/reality/cli.py`)
- CLI commands → Reconciliation: runs reconcile (evidence: `src/reality/cli.py`)
- CLI commands → Why and reports: requests why (evidence: `src/reality/cli.py`)
- CLI commands → Impact and simulation: requests impact (evidence: `src/reality/cli.py`)
- CLI commands → Environment checks: runs doctor (evidence: `src/reality/cli.py`)
- Scan orchestrator → Terraform parser: parses exports (evidence: `src/reality/services/scan.py`)
- Scan orchestrator → AWS resource adapter: collects resources (evidence: `src/reality/services/scan.py`)
- Scan orchestrator → IAM adapter: collects policies (evidence: `src/reality/services/scan.py`)
- Scan orchestrator → CloudTrail adapter: collects events (evidence: `src/reality/services/scan.py`)
- Scan orchestrator → Identity mapping: resolves identities (evidence: `src/reality/services/scan.py`)
- Scan orchestrator → Evidence repositories: stores scan data (evidence: `src/reality/services/scan.py`)
- Terraform parser → Evidence contracts: produces records (evidence: `src/reality/adapters/terraform.py`)
- AWS resource adapter → Evidence contracts: produces records (evidence: `src/reality/adapters/aws_resources.py`)
- IAM adapter → Evidence contracts: produces records (evidence: `src/reality/adapters/iam.py`)
- CloudTrail adapter → Evidence contracts: produces records (evidence: `src/reality/adapters/cloudtrail.py`)
- Reconciliation → Graph view/export: reads graph (evidence: `src/reality/services/reconcile.py`)
- Reconciliation → Evidence repositories: writes findings (evidence: `src/reality/services/reconcile.py`)
- Graph view/export → Evidence repositories: reads relationships (evidence: `src/reality/services/graph.py`)
- Impact and simulation → Graph view/export: traverses graph (evidence: `src/reality/services/impact.py`)
- Impact and simulation → Terraform parser: parses plan (evidence: `src/reality/services/impact.py`)
- Impact and simulation → Evidence repositories: reads stored data (evidence: `src/reality/services/impact.py`)
- Why and reports → Graph view/export: assembles reports (evidence: `src/reality/services/reports.py`)
- Why and reports → Impact and simulation: renders impact (evidence: `src/reality/services/reports.py`)
- Why and reports → Reconciliation: renders findings (evidence: `src/reality/services/reports.py`)
- Why and reports → Hidden dependencies: reports hidden links (evidence: `src/reality/services/reports.py`)
- Why and reports → Evidence repositories: reads evidence (evidence: `src/reality/services/reports.py`)
- Evidence repositories → SQLite store: queries database (evidence: `src/reality/storage/repositories.py`)
- Schema migrations → SQLite store: uses connection (evidence: `src/reality/storage/migrations.py`)
