# jaurakunal/isitsecure architecture

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

- Interactive diagram: https://gitdiagram.com/jaurakunal/isitsecure
- Repository: https://github.com/jaurakunal/isitsecure

## Overview

isitsecure is an AI-assisted web-application security scanner. Its main workflow accepts a repository and/or live target, performs static and dynamic analysis, uses SAST findings to guide targeted DAST, cross-references and triages results, then generates reports and optional fixes. The graph also shows the web UI and MCP entry points, plus LSP-assisted false-positive validation. The README documents the scan stages and capabilities; source excerpts and the index support the module boundaries, but unsampled implementation details are not inferred.

Main entry points: [`isitsecure/engine/agent.py`](https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/agent.py) (Scan orchestrator), [`isitsecure/cli/main.py`](https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/cli/main.py) (CLI), [`ui/src/app/scan/page.tsx`](https://github.com/jaurakunal/isitsecure/blob/main/ui/src/app/scan/page.tsx) (Web UI), [`isitsecure/mcp_server.py`](https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/mcp_server.py) (MCP server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry points"]
  node_cli["CLI<br/>[main.py]"]
  node_webui["Web UI<br/>[page.tsx]"]
  node_mcp["MCP server<br/>[mcp_server.py]"]
end

subgraph group_analysis["Scanning and analysis"]
  node_agent["Scan orchestrator<br/>[agent.py]"]
  node_ingestion["Repository ingestion<br/>[repo_ingestion.py]"]
  node_sast["Static analysis"]
  node_dast["Live-app scanners"]
  node_guided["Guided DAST"]
  node_crossref["Finding cross-reference"]
  node_lsp["LSP validation"]
end

subgraph group_results["Findings and remediation"]
  node_triage["Finding triage"]
  node_llm["LLM providers<br/>[adapters.py]"]
  node_report["Report generation"]
  node_fixes["Fix generation<br/>[fix_generator.py]"]
end

subgraph group_delivery["Interfaces and integrations"]
  node_server["Web API<br/>[app.py]"]
  node_cicd["CI/CD integration<br/>[cicd_service.py]"]
end

node_developer(("Developer"))

node_developer -->|"runs scans"| node_cli
node_developer -->|"starts scans"| node_webui
node_developer -->|"requests scans"| node_mcp
node_cli -->|"starts scan"| node_agent
node_webui -->|"sends requests"| node_server
node_server -->|"starts scan"| node_agent
node_mcp -->|"runs scan"| node_agent
node_agent -->|"ingests repository"| node_ingestion
node_agent -->|"runs static analysis"| node_sast
node_agent -->|"runs live tests"| node_dast
node_sast -->|"guides tests"| node_guided
node_agent -->|"cross-references findings"| node_crossref
node_agent -->|"triages findings"| node_triage
node_triage -->|"requests enrichment"| node_llm
node_agent -->|"validates findings"| node_lsp
node_agent -->|"builds report"| node_report
node_report -->|"feeds fix generation"| node_fixes
node_cli -.->|"exports findings"| node_cicd

click node_cli "https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/cli/main.py"
click node_webui "https://github.com/jaurakunal/isitsecure/blob/main/ui/src/app/scan/page.tsx"
click node_mcp "https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/mcp_server.py"
click node_agent "https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/agent.py"
click node_ingestion "https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/code_analysis/repo_ingestion.py"
click node_sast "https://github.com/jaurakunal/isitsecure/tree/main/isitsecure/engine/code_analysis"
click node_dast "https://github.com/jaurakunal/isitsecure/tree/main/isitsecure/engine/scanners"
click node_guided "https://github.com/jaurakunal/isitsecure/tree/main/isitsecure/engine/guided_dast"
click node_crossref "https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/cross_referencer.py"
click node_lsp "https://github.com/jaurakunal/isitsecure/tree/main/isitsecure/engine/code_analysis/lsp"
click node_triage "https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/triage/llm_triage_service.py"
click node_llm "https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/llm/adapters.py"
click node_report "https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/reporting/report_generator.py"
click node_fixes "https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/fixes/fix_generator.py"
click node_server "https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/server/app.py"
click node_cicd "https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/integrations/cicd_service.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_webui,node_mcp toneBlue
class node_agent,node_ingestion,node_sast,node_dast,node_guided,node_crossref,node_lsp toneAmber
class node_triage,node_llm,node_report,node_fixes toneMint
class node_server,node_cicd toneRose
class node_developer toneIndigo
```

## Components

### User entry points

- [CLI](https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/cli/main.py): `isitsecure/cli/main.py`
- [Web UI](https://github.com/jaurakunal/isitsecure/blob/main/ui/src/app/scan/page.tsx): `ui/src/app/scan/page.tsx`
- [MCP server](https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/mcp_server.py): `isitsecure/mcp_server.py`

### Scanning and analysis

- [Scan orchestrator](https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/agent.py): `isitsecure/engine/agent.py`
- [Repository ingestion](https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/code_analysis/repo_ingestion.py): `isitsecure/engine/code_analysis/repo_ingestion.py`
- [Static analysis](https://github.com/jaurakunal/isitsecure/tree/main/isitsecure/engine/code_analysis): `isitsecure/engine/code_analysis`
- [Live-app scanners](https://github.com/jaurakunal/isitsecure/tree/main/isitsecure/engine/scanners): `isitsecure/engine/scanners`
- [Guided DAST](https://github.com/jaurakunal/isitsecure/tree/main/isitsecure/engine/guided_dast): `isitsecure/engine/guided_dast`
- [Finding cross-reference](https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/cross_referencer.py): `isitsecure/engine/cross_referencer.py`
- [LSP validation](https://github.com/jaurakunal/isitsecure/tree/main/isitsecure/engine/code_analysis/lsp): `isitsecure/engine/code_analysis/lsp`

### Findings and remediation

- [Finding triage](https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/triage/llm_triage_service.py): `isitsecure/engine/triage/llm_triage_service.py`
- [LLM providers](https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/llm/adapters.py): `isitsecure/llm/adapters.py`
- [Report generation](https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/reporting/report_generator.py): `isitsecure/engine/reporting/report_generator.py`
- [Fix generation](https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/fixes/fix_generator.py): `isitsecure/engine/fixes/fix_generator.py`

### Interfaces and integrations

- [Web API](https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/server/app.py): `isitsecure/server/app.py`
- [CI/CD integration](https://github.com/jaurakunal/isitsecure/blob/main/isitsecure/engine/integrations/cicd_service.py): `isitsecure/engine/integrations/cicd_service.py`

### Other components

- **Developer**

## Connections

- Developer → CLI: runs scans (evidence: `README.md`)
- Developer → Web UI: starts scans (evidence: `README.md`)
- Developer → MCP server: requests scans (evidence: `isitsecure/mcp_server.py`)
- CLI → Scan orchestrator: starts scan (evidence: `isitsecure/cli/main.py`)
- Web UI → Web API: sends requests (evidence: `README.md`)
- Web API → Scan orchestrator: starts scan (evidence: `isitsecure/server/app.py`)
- MCP server → Scan orchestrator: runs scan (evidence: `isitsecure/mcp_server.py`)
- Scan orchestrator → Repository ingestion: ingests repository
- Scan orchestrator → Static analysis: runs static analysis (evidence: `README.md`)
- Scan orchestrator → Live-app scanners: runs live tests (evidence: `README.md`)
- Static analysis → Guided DAST: guides tests (evidence: `README.md`)
- Scan orchestrator → Finding cross-reference: cross-references findings (evidence: `README.md`)
- Scan orchestrator → Finding triage: triages findings (evidence: `README.md`)
- Finding triage → LLM providers: requests enrichment (evidence: `isitsecure/engine/triage/llm_triage_service.py`)
- Scan orchestrator → LSP validation: validates findings (evidence: `README.md`)
- Scan orchestrator → Report generation: builds report (evidence: `isitsecure/engine/reporting/report_generator.py`)
- Report generation → Fix generation: feeds fix generation (evidence: `README.md`)
- CLI → CI/CD integration: exports findings
