# inthiiii/hyperreaility-sliit architecture

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

- Interactive diagram: https://gitdiagram.com/inthiiii/hyperreaility-sliit
- Repository: https://github.com/inthiiii/hyperreaility-sliit

## Overview

RE:L!NK is a proposed multi-agent decision-support application for planning telecom network restoration; the checked-in entry point is empty and the MVP is explicitly pending. The intended workflow loads incident and scenario data, coordinates specialist findings, builds and independently checks a constrained schedule, obtains human approval, then simulates approved actions and records outcomes. Material changes trigger renewed planning. The graph reflects documented plans, not verified runtime behavior; planned components without an implementing source file have null paths.

Main entry points: [`project/main.py`](https://github.com/inthiiii/hyperreaility-sliit/blob/main/project/main.py) (Coordinator and state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_evidence["Evidence and investigation"]
  node_scenario_inputs["Scenario inputs"]
  node_coordinator["Coordinator and state<br/>[main.py]"]
  node_investigator["Network Investigator"]
  node_dependency_analysis["Dependency analysis"]
end

subgraph group_planning["Planning and review"]
  node_resource_planner["Field Resource Planner"]
  node_priority_assessor["Service Priority Assessor"]
  node_scheduler["Constrained scheduler"]
  node_reviewer["Plan Reviewer"]
  node_feasibility_checker["Feasibility checker"]
end

subgraph group_operations["Approval and simulation"]
  node_operator_clarification["Operator clarification"]
  node_approval["Human approval"]
  node_simulator["Action simulator"]
  node_outcomes["Recorded outcomes"]
end

subgraph group_oversight["Evaluation and accountability"]
  node_trace_store[("State and trace storage")]
  node_baseline_evaluation["Baseline evaluation"]
end

node_operations_team(("Operations team"))

node_operations_team -->|"provides"| node_scenario_inputs
node_scenario_inputs -->|"loads and versions"| node_coordinator
node_coordinator -->|"routes findings"| node_investigator
node_coordinator -->|"routes findings"| node_resource_planner
node_coordinator -->|"routes findings"| node_priority_assessor
node_coordinator -->|"routes candidate"| node_reviewer
node_investigator -->|"inspects dependencies"| node_dependency_analysis
node_coordinator -->|"builds schedule"| node_scheduler
node_coordinator -->|"checks plan"| node_feasibility_checker
node_reviewer -->|"requests revision"| node_coordinator
node_coordinator -->|"escalates questions"| node_operator_clarification
node_operator_clarification -->|"confirms updates"| node_coordinator
node_operations_team -->|"reviews plan"| node_approval
node_approval -->|"authorizes actions"| node_simulator
node_simulator -->|"records results"| node_outcomes
node_coordinator -->|"versions state"| node_trace_store
node_coordinator -->|"supports comparison"| node_baseline_evaluation

click node_coordinator "https://github.com/inthiiii/hyperreaility-sliit/blob/main/project/main.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_scenario_inputs,node_coordinator,node_investigator,node_dependency_analysis toneBlue
class node_resource_planner,node_priority_assessor,node_scheduler,node_reviewer,node_feasibility_checker toneAmber
class node_operator_clarification,node_approval,node_simulator,node_outcomes toneMint
class node_trace_store,node_baseline_evaluation toneRose
class node_operations_team toneIndigo
```

## Components

### Evidence and investigation

- **Scenario inputs**
- [Coordinator and state](https://github.com/inthiiii/hyperreaility-sliit/blob/main/project/main.py): `project/main.py`
- **Network Investigator**
- **Dependency analysis**

### Planning and review

- **Field Resource Planner**
- **Service Priority Assessor**
- **Constrained scheduler**
- **Plan Reviewer**
- **Feasibility checker**

### Approval and simulation

- **Operator clarification**
- **Human approval**
- **Action simulator**
- **Recorded outcomes**

### Evaluation and accountability

- **State and trace storage**
- **Baseline evaluation**

### Other components

- **Operations team**

## Connections

- Operations team → Scenario inputs: provides (evidence: `README.md`)
- Scenario inputs → Coordinator and state: loads and versions (evidence: `README.md`)
- Coordinator and state → Network Investigator: routes findings (evidence: `README.md`)
- Coordinator and state → Field Resource Planner: routes findings (evidence: `README.md`)
- Coordinator and state → Service Priority Assessor: routes findings (evidence: `README.md`)
- Coordinator and state → Plan Reviewer: routes candidate (evidence: `README.md`)
- Network Investigator → Dependency analysis: inspects dependencies (evidence: `README.md`)
- Coordinator and state → Constrained scheduler: builds schedule (evidence: `README.md`)
- Coordinator and state → Feasibility checker: checks plan (evidence: `README.md`)
- Plan Reviewer → Coordinator and state: requests revision (evidence: `README.md`)
- Coordinator and state → Operator clarification: escalates questions (evidence: `README.md`)
- Operator clarification → Coordinator and state: confirms updates (evidence: `README.md`)
- Operations team → Human approval: reviews plan (evidence: `README.md`)
- Human approval → Action simulator: authorizes actions (evidence: `README.md`)
- Action simulator → Recorded outcomes: records results (evidence: `README.md`)
- Coordinator and state → State and trace storage: versions state (evidence: `README.md`)
- Coordinator and state → Baseline evaluation: supports comparison (evidence: `README.md`)
