How saishabari05/dev_guard_ai works
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: main.py Flask API · investigator.py Investigation Orchestrator · developer_mcp.py MCP Tool Adapter · autonomous_pipeline.py Autonomous Pipeline
Components 19
User Interfaces
- Dashboard
frontend/src/components/Dashboard.jsx - API Client
frontend/src/api/devguard.js - Flask API
backend/app/main.py
Repository Ingestion
- Repository Manager
backend/app/repository/manager.py - Workspace Handling
backend/app/repository/workspace.py - Metadata Detection
backend/app/repository/detector.py
Evidence and Investigation
- Investigation Orchestrator
backend/app/agent/investigator.py - Autonomous Pipeline
backend/app/agent/autonomous_pipeline.py - Test Runner
backend/app/tools/testing.py - Repository Evidence Tools
backend/app/tools/repository.py - Provider Factory
backend/app/agent/provider_factory.py - Gemini Provider
backend/app/agent/providers/gemini.py - Git History and Diff
backend/app/tools/git.py
Fix and Reporting
- Patch Application
backend/app/tools/patching.py - Approval Validation
backend/app/agent/validator.py - Markdown Report
backend/app/agent/report_generator.py
Developer Tools
- MCP Tool Adapter
mcp/developer_mcp.py - MCP Server
mcp/server/mcpserver.py
Other components
- Engineer
Connections 27
- Engineer → Dashboard: uses
README.md - Dashboard → API Client: calls
frontend/src/components/Dashboard.jsx - API Client → Flask API: sends HTTP requests
README.md - Flask API → Repository Manager: ingests repositories
backend/app/main.py - Repository Manager → Workspace Handling: creates or resolves
backend/app/repository/manager.py - Repository Manager → Metadata Detection: detects metadata
backend/app/repository/manager.py - Flask API → Investigation Orchestrator: starts investigation
backend/app/main.py - Investigation Orchestrator → Autonomous Pipeline: delegates investigation
backend/app/agent/investigator.py - Autonomous Pipeline → Test Runner: runs tests
backend/app/agent/autonomous_pipeline.py - Autonomous Pipeline → Repository Evidence Tools: reads evidence
backend/app/agent/autonomous_pipeline.py - Autonomous Pipeline → Metadata Detection: gets repository metadata
backend/app/agent/autonomous_pipeline.py - Investigation Orchestrator → Provider Factory: selects provider
backend/app/agent/investigator.py - Provider Factory → Gemini Provider: configures provider
- Investigation Orchestrator → Repository Evidence Tools: uses investigation tools
backend/app/agent/investigator.py - Investigation Orchestrator → Test Runner: runs tests
backend/app/agent/investigator.py - Investigation Orchestrator → Git History and Diff: uses Git evidence
backend/app/agent/investigator.py - Flask API → Approval Validation: validates approved patch
backend/app/main.py - Approval Validation → Patch Application: applies patch
backend/app/agent/validator.py - Approval Validation → Test Runner: runs validation tests
backend/app/agent/validator.py - Approval Validation → Git History and Diff: checks diff
backend/app/agent/validator.py - Flask API → Markdown Report: generates report
backend/app/main.py - Flask API → Git History and Diff: gets patch diff
backend/app/main.py - MCP Tool Adapter → MCP Server: registers tools
mcp/developer_mcp.py - MCP Tool Adapter → Repository Evidence Tools: exposes repository tools
mcp/developer_mcp.py - MCP Tool Adapter → Test Runner: exposes test runner
mcp/developer_mcp.py - MCP Tool Adapter → Git History and Diff: exposes Git tools
mcp/developer_mcp.py - MCP Tool Adapter → Workspace Handling: resolves workspace
mcp/developer_mcp.py