# saishabari05/dev_guard_ai architecture

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

- Interactive diagram: https://gitdiagram.com/saishabari05/dev_guard_ai
- Repository: https://github.com/saishabari05/dev_guard_ai

## Overview

DEVGUARD AI imports repositories, detects their metadata, and investigates failures through a deterministic-first workflow: run tests, collect relevant evidence, then use an agent to produce a cause and proposed patch. The user reviews the diff and explicitly approves validation; reports and downloadable artifacts complete the workflow. The React dashboard is the main user interface, with an MCP server offering a separate developer-tools entry point. Several backend modules are represented from the SOURCE INDEX and README rather than inspected excerpts, so their internal links are limited to documented or indexed relationships.

Main entry points: [`backend/app/main.py`](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/main.py) (Flask API), [`backend/app/agent/investigator.py`](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/agent/investigator.py) (Investigation Orchestrator), [`mcp/developer_mcp.py`](https://github.com/saishabari05/dev_guard_ai/blob/main/mcp/developer_mcp.py) (MCP Tool Adapter), [`backend/app/agent/autonomous_pipeline.py`](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/agent/autonomous_pipeline.py) (Autonomous Pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interfaces"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_api_client["API Client<br/>[devguard.js]"]
  node_flask_api["Flask API<br/>[main.py]"]
end

subgraph group_ingestion["Repository Ingestion"]
  node_repository_manager["Repository Manager<br/>[manager.py]"]
  node_workspace["Workspace Handling<br/>[workspace.py]"]
  node_metadata["Metadata Detection<br/>[detector.py]"]
end

subgraph group_investigation["Evidence and Investigation"]
  node_investigator["Investigation Orchestrator<br/>[investigator.py]"]
  node_autonomous_pipeline["Autonomous Pipeline"]
  node_test_runner["Test Runner<br/>[testing.py]"]
  node_repository_tools["Repository Evidence Tools<br/>[repository.py]"]
  node_provider_factory["Provider Factory"]
  node_gemini_provider["Gemini Provider<br/>[gemini.py]"]
  node_git_tools["Git History and Diff<br/>[git.py]"]
end

subgraph group_fixes["Fix and Reporting"]
  node_patching["Patch Application<br/>[patching.py]"]
  node_validator["Approval Validation<br/>[validator.py]"]
  node_report["Markdown Report"]
end

subgraph group_tools["Developer Tools"]
  node_mcp_entry["MCP Tool Adapter<br/>[developer_mcp.py]"]
  node_mcp_server["MCP Server<br/>[mcpserver.py]"]
end

node_user(("Engineer"))

node_user -->|"uses"| node_dashboard
node_dashboard -->|"calls"| node_api_client
node_api_client -->|"sends HTTP requests"| node_flask_api
node_flask_api -->|"ingests repositories"| node_repository_manager
node_repository_manager -->|"creates or resolves"| node_workspace
node_repository_manager -->|"detects metadata"| node_metadata
node_flask_api -->|"starts investigation"| node_investigator
node_investigator -->|"delegates investigation"| node_autonomous_pipeline
node_autonomous_pipeline -->|"runs tests"| node_test_runner
node_autonomous_pipeline -->|"reads evidence"| node_repository_tools
node_autonomous_pipeline -->|"gets repository metadata"| node_metadata
node_investigator -->|"selects provider"| node_provider_factory
node_provider_factory -.->|"configures provider"| node_gemini_provider
node_investigator -->|"uses investigation tools"| node_repository_tools
node_investigator -->|"runs tests"| node_test_runner
node_investigator -->|"uses Git evidence"| node_git_tools
node_flask_api -->|"validates approved patch"| node_validator
node_validator -->|"applies patch"| node_patching
node_validator -->|"runs validation tests"| node_test_runner
node_validator -->|"checks diff"| node_git_tools
node_flask_api -->|"generates report"| node_report
node_flask_api -->|"gets patch diff"| node_git_tools
node_mcp_entry -->|"registers tools"| node_mcp_server
node_mcp_entry -->|"exposes repository tools"| node_repository_tools
node_mcp_entry -->|"exposes test runner"| node_test_runner
node_mcp_entry -->|"exposes Git tools"| node_git_tools
node_mcp_entry -->|"resolves workspace"| node_workspace

click node_dashboard "https://github.com/saishabari05/dev_guard_ai/blob/main/frontend/src/components/Dashboard.jsx"
click node_api_client "https://github.com/saishabari05/dev_guard_ai/blob/main/frontend/src/api/devguard.js"
click node_flask_api "https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/main.py"
click node_repository_manager "https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/repository/manager.py"
click node_workspace "https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/repository/workspace.py"
click node_metadata "https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/repository/detector.py"
click node_investigator "https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/agent/investigator.py"
click node_autonomous_pipeline "https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/agent/autonomous_pipeline.py"
click node_test_runner "https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/tools/testing.py"
click node_repository_tools "https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/tools/repository.py"
click node_provider_factory "https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/agent/provider_factory.py"
click node_gemini_provider "https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/agent/providers/gemini.py"
click node_git_tools "https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/tools/git.py"
click node_patching "https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/tools/patching.py"
click node_validator "https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/agent/validator.py"
click node_report "https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/agent/report_generator.py"
click node_mcp_entry "https://github.com/saishabari05/dev_guard_ai/blob/main/mcp/developer_mcp.py"
click node_mcp_server "https://github.com/saishabari05/dev_guard_ai/blob/main/mcp/server/mcpserver.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_dashboard,node_api_client,node_flask_api toneBlue
class node_repository_manager,node_workspace,node_metadata toneAmber
class node_investigator,node_autonomous_pipeline,node_test_runner,node_repository_tools,node_provider_factory,node_gemini_provider,node_git_tools toneMint
class node_patching,node_validator,node_report toneRose
class node_mcp_entry,node_mcp_server,node_user toneIndigo
```

## Components

### User Interfaces

- [Dashboard](https://github.com/saishabari05/dev_guard_ai/blob/main/frontend/src/components/Dashboard.jsx): `frontend/src/components/Dashboard.jsx`
- [API Client](https://github.com/saishabari05/dev_guard_ai/blob/main/frontend/src/api/devguard.js): `frontend/src/api/devguard.js`
- [Flask API](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/main.py): `backend/app/main.py`

### Repository Ingestion

- [Repository Manager](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/repository/manager.py): `backend/app/repository/manager.py`
- [Workspace Handling](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/repository/workspace.py): `backend/app/repository/workspace.py`
- [Metadata Detection](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/repository/detector.py): `backend/app/repository/detector.py`

### Evidence and Investigation

- [Investigation Orchestrator](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/agent/investigator.py): `backend/app/agent/investigator.py`
- [Autonomous Pipeline](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/agent/autonomous_pipeline.py): `backend/app/agent/autonomous_pipeline.py`
- [Test Runner](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/tools/testing.py): `backend/app/tools/testing.py`
- [Repository Evidence Tools](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/tools/repository.py): `backend/app/tools/repository.py`
- [Provider Factory](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/agent/provider_factory.py): `backend/app/agent/provider_factory.py`
- [Gemini Provider](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/agent/providers/gemini.py): `backend/app/agent/providers/gemini.py`
- [Git History and Diff](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/tools/git.py): `backend/app/tools/git.py`

### Fix and Reporting

- [Patch Application](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/tools/patching.py): `backend/app/tools/patching.py`
- [Approval Validation](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/agent/validator.py): `backend/app/agent/validator.py`
- [Markdown Report](https://github.com/saishabari05/dev_guard_ai/blob/main/backend/app/agent/report_generator.py): `backend/app/agent/report_generator.py`

### Developer Tools

- [MCP Tool Adapter](https://github.com/saishabari05/dev_guard_ai/blob/main/mcp/developer_mcp.py): `mcp/developer_mcp.py`
- [MCP Server](https://github.com/saishabari05/dev_guard_ai/blob/main/mcp/server/mcpserver.py): `mcp/server/mcpserver.py`

### Other components

- **Engineer**

## Connections

- Engineer → Dashboard: uses (evidence: `README.md`)
- Dashboard → API Client: calls (evidence: `frontend/src/components/Dashboard.jsx`)
- API Client → Flask API: sends HTTP requests (evidence: `README.md`)
- Flask API → Repository Manager: ingests repositories (evidence: `backend/app/main.py`)
- Repository Manager → Workspace Handling: creates or resolves (evidence: `backend/app/repository/manager.py`)
- Repository Manager → Metadata Detection: detects metadata (evidence: `backend/app/repository/manager.py`)
- Flask API → Investigation Orchestrator: starts investigation (evidence: `backend/app/main.py`)
- Investigation Orchestrator → Autonomous Pipeline: delegates investigation (evidence: `backend/app/agent/investigator.py`)
- Autonomous Pipeline → Test Runner: runs tests (evidence: `backend/app/agent/autonomous_pipeline.py`)
- Autonomous Pipeline → Repository Evidence Tools: reads evidence (evidence: `backend/app/agent/autonomous_pipeline.py`)
- Autonomous Pipeline → Metadata Detection: gets repository metadata (evidence: `backend/app/agent/autonomous_pipeline.py`)
- Investigation Orchestrator → Provider Factory: selects provider (evidence: `backend/app/agent/investigator.py`)
- Provider Factory → Gemini Provider: configures provider
- Investigation Orchestrator → Repository Evidence Tools: uses investigation tools (evidence: `backend/app/agent/investigator.py`)
- Investigation Orchestrator → Test Runner: runs tests (evidence: `backend/app/agent/investigator.py`)
- Investigation Orchestrator → Git History and Diff: uses Git evidence (evidence: `backend/app/agent/investigator.py`)
- Flask API → Approval Validation: validates approved patch (evidence: `backend/app/main.py`)
- Approval Validation → Patch Application: applies patch (evidence: `backend/app/agent/validator.py`)
- Approval Validation → Test Runner: runs validation tests (evidence: `backend/app/agent/validator.py`)
- Approval Validation → Git History and Diff: checks diff (evidence: `backend/app/agent/validator.py`)
- Flask API → Markdown Report: generates report (evidence: `backend/app/main.py`)
- Flask API → Git History and Diff: gets patch diff (evidence: `backend/app/main.py`)
- MCP Tool Adapter → MCP Server: registers tools (evidence: `mcp/developer_mcp.py`)
- MCP Tool Adapter → Repository Evidence Tools: exposes repository tools (evidence: `mcp/developer_mcp.py`)
- MCP Tool Adapter → Test Runner: exposes test runner (evidence: `mcp/developer_mcp.py`)
- MCP Tool Adapter → Git History and Diff: exposes Git tools (evidence: `mcp/developer_mcp.py`)
- MCP Tool Adapter → Workspace Handling: resolves workspace (evidence: `mcp/developer_mcp.py`)
