# harshitkulkarni8055/sentinel architecture

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

- Interactive diagram: https://gitdiagram.com/harshitkulkarni8055/sentinel
- Repository: https://github.com/harshitkulkarni8055/sentinel

## Overview

Sentinel is an autonomous dynamic application security testing platform. A user submits a target through the frontend; the API validates reachability and invokes a LangGraph scan that runs reconnaissance, dynamic security tests, adaptive DAST, authentication and authorization checks, reasoning, code analysis, AI review, and correlation. The API returns findings, attack-surface details, and risk summaries. The graph and sampled agents establish the backend workflow; frontend-to-API wiring and several unsampled agent internals could not be verified, so that connection is marked unverified.

Main entry points: [`backend/orchestration/graph.py`](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/orchestration/graph.py) (Scan Graph), [`backend/agents/security_tester.py`](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/security_tester.py) (Security Tester), [`backend/main.py`](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/main.py) (Sentinel API), [`backend/agents/coordinator.py`](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/coordinator.py) (Recon Coordinator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_frontend["Scan Interface<br/>[main.js]"]
end

subgraph group_api["Scan API"]
  node_api_server["Sentinel API<br/>[main.py]"]
  node_findings["Findings Summary<br/>[main.py]"]
end

subgraph group_workflow["Scan Workflow"]
  node_scan_graph["Scan Graph<br/>[graph.py]"]
  node_scan_state["Scan State<br/>[state.py]"]
  node_recon["Recon Coordinator<br/>[coordinator.py]"]
end

subgraph group_testing["Security Testing"]
  node_web_recon["Web Recon<br/>[web_recon.py]"]
  node_endpoint_discovery["Endpoint Discovery"]
  node_security_tests["Security Tester<br/>[security_tester.py]"]
  node_adaptive_dast["Adaptive DAST<br/>[adaptive_dast.py]"]
  node_auth_tests["Authentication Tests<br/>[auth_agent.py]"]
  node_authorization_tests["Authorization Tests"]
  node_http_request["HTTP Request Tool<br/>[http_request.py]"]
  node_security_http["Security HTTP Tool<br/>[security_http.py]"]
end

subgraph group_analysis["Evidence Analysis"]
  node_reasoning["Autonomous Reasoning"]
  node_code_analysis["Static Code Analysis<br/>[code_agent.py]"]
  node_code_scanner["Code Scanner<br/>[code_scanner.py]"]
  node_ai_review["AI Security Review"]
  node_correlation["Evidence Correlation<br/>[correlation.py]"]
end

node_user(("Security Engineer"))
node_target["Target Application"]
node_llm_provider["Featherless AI"]

node_user -->|"submits scan"| node_frontend
node_frontend -.->|"starts scan"| node_api_server
node_api_server -->|"checks reachability"| node_target
node_api_server -->|"invokes scan"| node_scan_graph
node_scan_graph -->|"dispatches"| node_recon
node_scan_graph -->|"dispatches"| node_security_tests
node_scan_graph -->|"dispatches"| node_adaptive_dast
node_scan_graph -->|"dispatches"| node_auth_tests
node_scan_graph -->|"dispatches"| node_authorization_tests
node_scan_graph -->|"dispatches"| node_reasoning
node_scan_graph -->|"dispatches"| node_code_analysis
node_scan_graph -->|"dispatches"| node_ai_review
node_scan_graph -->|"dispatches"| node_correlation
node_scan_graph -->|"uses state"| node_scan_state
node_recon -->|"passes state"| node_security_tests
node_security_tests -->|"passes state"| node_adaptive_dast
node_adaptive_dast -->|"passes state"| node_auth_tests
node_auth_tests -->|"passes state"| node_authorization_tests
node_authorization_tests -->|"passes state"| node_reasoning
node_reasoning -->|"passes state"| node_code_analysis
node_code_analysis -->|"passes state"| node_ai_review
node_ai_review -->|"passes state"| node_correlation
node_correlation -->|"returns results"| node_api_server
node_api_server -->|"formats findings"| node_findings
node_recon -.->|"uses recon"| node_web_recon
node_recon -.->|"discovers endpoints"| node_endpoint_discovery
node_security_tests -->|"tests endpoints"| node_target
node_auth_tests -->|"probes login"| node_target
node_authorization_tests -->|"checks access"| node_target
node_security_tests -.->|"uses requests"| node_http_request
node_security_tests -.->|"uses requests"| node_security_http
node_code_analysis -.->|"uses scanner"| node_code_scanner
node_ai_review -->|"analyzes evidence"| node_llm_provider

click node_frontend "https://github.com/harshitkulkarni8055/sentinel/blob/master/frontEnd/main.js"
click node_api_server "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/main.py"
click node_scan_graph "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/orchestration/graph.py"
click node_scan_state "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/orchestration/state.py"
click node_recon "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/coordinator.py"
click node_web_recon "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/tools/web_recon.py"
click node_endpoint_discovery "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/tools/endpoint_discovery.py"
click node_security_tests "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/security_tester.py"
click node_adaptive_dast "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/adaptive_dast.py"
click node_auth_tests "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/auth_agent.py"
click node_authorization_tests "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/authorization_tester.py"
click node_http_request "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/tools/http_request.py"
click node_security_http "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/tools/security_http.py"
click node_reasoning "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/autonomous_reasoning.py"
click node_code_analysis "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/code_agent.py"
click node_code_scanner "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/tools/code_scanner.py"
click node_ai_review "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/ai_security_agent.py"
click node_correlation "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/orchestration/correlation.py"
click node_findings "https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/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_frontend toneBlue
class node_api_server,node_findings toneAmber
class node_scan_graph,node_scan_state,node_recon toneMint
class node_web_recon,node_endpoint_discovery,node_security_tests,node_adaptive_dast,node_auth_tests,node_authorization_tests,node_http_request,node_security_http toneRose
class node_reasoning,node_code_analysis,node_code_scanner,node_ai_review,node_correlation,node_user,node_target,node_llm_provider toneIndigo
```

## Components

### User Interface

- [Scan Interface](https://github.com/harshitkulkarni8055/sentinel/blob/master/frontEnd/main.js): `frontEnd/main.js`

### Scan API

- [Sentinel API](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/main.py): `backend/main.py`
- [Findings Summary](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/main.py): `backend/main.py`

### Scan Workflow

- [Scan Graph](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/orchestration/graph.py): `backend/orchestration/graph.py`
- [Scan State](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/orchestration/state.py): `backend/orchestration/state.py`
- [Recon Coordinator](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/coordinator.py): `backend/agents/coordinator.py`

### Security Testing

- [Web Recon](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/tools/web_recon.py): `backend/tools/web_recon.py`
- [Endpoint Discovery](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/tools/endpoint_discovery.py): `backend/tools/endpoint_discovery.py`
- [Security Tester](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/security_tester.py): `backend/agents/security_tester.py`
- [Adaptive DAST](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/adaptive_dast.py): `backend/agents/adaptive_dast.py`
- [Authentication Tests](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/auth_agent.py): `backend/agents/auth_agent.py`
- [Authorization Tests](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/authorization_tester.py): `backend/agents/authorization_tester.py`
- [HTTP Request Tool](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/tools/http_request.py): `backend/tools/http_request.py`
- [Security HTTP Tool](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/tools/security_http.py): `backend/tools/security_http.py`

### Evidence Analysis

- [Autonomous Reasoning](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/autonomous_reasoning.py): `backend/agents/autonomous_reasoning.py`
- [Static Code Analysis](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/code_agent.py): `backend/agents/code_agent.py`
- [Code Scanner](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/tools/code_scanner.py): `backend/tools/code_scanner.py`
- [AI Security Review](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/agents/ai_security_agent.py): `backend/agents/ai_security_agent.py`
- [Evidence Correlation](https://github.com/harshitkulkarni8055/sentinel/blob/master/backend/orchestration/correlation.py): `backend/orchestration/correlation.py`

### Other components

- **Security Engineer**
- **Target Application**
- **Featherless AI**

## Connections

- Security Engineer → Scan Interface: submits scan (evidence: `README.md`)
- Scan Interface → Sentinel API: starts scan
- Sentinel API → Target Application: checks reachability (evidence: `backend/main.py`)
- Sentinel API → Scan Graph: invokes scan (evidence: `backend/main.py`)
- Scan Graph → Recon Coordinator: dispatches (evidence: `backend/orchestration/graph.py`)
- Scan Graph → Security Tester: dispatches (evidence: `backend/orchestration/graph.py`)
- Scan Graph → Adaptive DAST: dispatches (evidence: `backend/orchestration/graph.py`)
- Scan Graph → Authentication Tests: dispatches (evidence: `backend/orchestration/graph.py`)
- Scan Graph → Authorization Tests: dispatches (evidence: `backend/orchestration/graph.py`)
- Scan Graph → Autonomous Reasoning: dispatches (evidence: `backend/orchestration/graph.py`)
- Scan Graph → Static Code Analysis: dispatches (evidence: `backend/orchestration/graph.py`)
- Scan Graph → AI Security Review: dispatches (evidence: `backend/orchestration/graph.py`)
- Scan Graph → Evidence Correlation: dispatches (evidence: `backend/orchestration/graph.py`)
- Scan Graph → Scan State: uses state (evidence: `backend/orchestration/graph.py`)
- Recon Coordinator → Security Tester: passes state (evidence: `backend/orchestration/graph.py`)
- Security Tester → Adaptive DAST: passes state (evidence: `backend/orchestration/graph.py`)
- Adaptive DAST → Authentication Tests: passes state (evidence: `backend/orchestration/graph.py`)
- Authentication Tests → Authorization Tests: passes state (evidence: `backend/orchestration/graph.py`)
- Authorization Tests → Autonomous Reasoning: passes state (evidence: `backend/orchestration/graph.py`)
- Autonomous Reasoning → Static Code Analysis: passes state (evidence: `backend/orchestration/graph.py`)
- Static Code Analysis → AI Security Review: passes state (evidence: `backend/orchestration/graph.py`)
- AI Security Review → Evidence Correlation: passes state (evidence: `backend/orchestration/graph.py`)
- Evidence Correlation → Sentinel API: returns results (evidence: `backend/main.py`)
- Sentinel API → Findings Summary: formats findings (evidence: `backend/main.py`)
- Recon Coordinator → Web Recon: uses recon
- Recon Coordinator → Endpoint Discovery: discovers endpoints
- Security Tester → Target Application: tests endpoints (evidence: `backend/agents/security_tester.py`)
- Authentication Tests → Target Application: probes login (evidence: `backend/agents/auth_agent.py`)
- Authorization Tests → Target Application: checks access (evidence: `backend/agents/authorization_tester.py`)
- Security Tester → HTTP Request Tool: uses requests
- Security Tester → Security HTTP Tool: uses requests
- Static Code Analysis → Code Scanner: uses scanner
- AI Security Review → Featherless AI: analyzes evidence (evidence: `backend/agents/ai_security_agent.py`)
