How dakhane-parag/codesageai-multi-agent_github_code_review_platform works
CodeSage AI receives GitHub pull-request webhooks, validates and extracts PR diffs, classifies files, runs four parallel Gemini-backed review agents, then aggregates findings into a GitHub review and persists the report for historical REST queries. The graph follows the documented and excerpted webhook workflow; several agent and aggregation internals are represented by their source-indexed modules, without assuming their unsampled implementation details.
Main entry points: review_workflow.py Review Workflow · webhooks.py Webhook Receiver · pr_extraction.py PR Extractor · service.py GitHub Service
Components 22
Webhook API
- API Router
backend/app/api/main.py - Webhook Receiver
backend/app/api/routes/webhooks.py
PR Extraction
- PR Extractor
backend/app/services/pr_extraction.py - File Classifier
backend/app/services/file_classifier.py - Extracted PR Data
backend/app/schemas/extraction.py
AI Review
- Review Workflow
backend/app/workflows/review_workflow.py - Workflow State
backend/app/schemas/review.py - Security Agent
backend/app/agents/security_agent.py - Performance Agent
backend/app/agents/performance_agent.py - Quality Agent
backend/app/agents/quality_agent.py - Testing Agent
backend/app/agents/testing_agent.py - Review Aggregator
backend/app/agents/aggregator.py - Gemini Service
backend/app/services/llm_service.py
GitHub Integration
- GitHub Service
backend/app/github/service.py - GitHub API Client
backend/app/github/client.py - GitHub Models
backend/app/github/models.py
Review History
- Reviews API
backend/app/api/routes/reviews.py - Review Repository
backend/app/db/repositories/ai_reviews.py - MongoDB Session
backend/app/db/session.py - AI Review Model
backend/app/models/ai_review.py - MongoDB
Other components
- GitHub
Connections 28
- GitHub → Webhook Receiver: sends events
README.md - API Router → Webhook Receiver: routes requests
backend/app/api/main.py - API Router → Reviews API: routes requests
backend/app/api/main.py - Webhook Receiver → PR Extractor: extracts PR
backend/app/api/routes/webhooks.py - PR Extractor → GitHub Service: fetches PR files
backend/app/services/pr_extraction.py - PR Extractor → File Classifier: classifies files
backend/app/services/pr_extraction.py - PR Extractor → Extracted PR Data: returns extracted data
backend/app/services/pr_extraction.py - Webhook Receiver → Review Workflow: invokes workflow
backend/app/api/routes/webhooks.py - Webhook Receiver → Workflow State: builds state
backend/app/api/routes/webhooks.py - Review Workflow → Workflow State: uses state
backend/app/workflows/review_workflow.py - Review Workflow → Security Agent: dispatches analysis
backend/app/workflows/review_workflow.py - Review Workflow → Performance Agent: dispatches analysis
backend/app/workflows/review_workflow.py - Review Workflow → Quality Agent: dispatches analysis
backend/app/workflows/review_workflow.py - Review Workflow → Testing Agent: dispatches analysis
backend/app/workflows/review_workflow.py - Review Workflow → Review Aggregator: dispatches aggregation
backend/app/workflows/review_workflow.py - Security Agent → Gemini Service: obtains LLM
backend/app/agents/security_agent.py - Performance Agent → Gemini Service: obtains LLM
backend/app/agents/performance_agent.py - Quality Agent → Gemini Service: obtains LLM
backend/app/agents/quality_agent.py - Testing Agent → Gemini Service: obtains LLM
backend/app/agents/testing_agent.py - Review Aggregator → GitHub Service: posts review
backend/app/agents/aggregator.py - GitHub Service → GitHub API Client: sends API calls
backend/app/github/service.py - GitHub Service → GitHub Models: validates responses
backend/app/github/service.py - Webhook Receiver → Review Repository: persists review
backend/app/api/routes/webhooks.py - Review Repository → MongoDB Session: uses database
backend/app/db/repositories/ai_reviews.py - Review Repository → AI Review Model: stores model
backend/app/db/repositories/ai_reviews.py - MongoDB Session → MongoDB: connects to
backend/app/db/session.py - Reviews API → Review Repository: queries history
backend/app/api/routes/reviews.py - Reviews API → AI Review Model: returns reviews
backend/app/api/routes/reviews.py