# garvgupta25/rakshakai architecture

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

- Interactive diagram: https://gitdiagram.com/garvgupta25/rakshakai
- Repository: https://github.com/garvgupta25/rakshakai

## Overview

AgentGuard is a persistent repository-protection control plane. GitHub events enter through Probot, are queued for per-repository analysis, and lead to a pass, safe correction, or block/remediation decision; incidents and repository health remain inspectable. A parallel dependency-graph workflow builds and updates code relationships, then supplies bounded affected context to model analysis and dashboard views. The main worker excerpt shows key orchestration calls; several README-documented capabilities, including correction and operator notifications, have only partial source evidence, so those links are cited to the README.

Main entry points: [`backend/src/worker.ts`](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/worker.ts) (Analysis worker), [`backend/src/graph.ts`](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/graph.ts) (Graph builder), [`backend/src/index.ts`](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/index.ts) (Probot webhook), [`backend/src/incidents.ts`](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/incidents.ts) (Incident records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Event intake"]
  node_probot["Probot webhook<br/>[index.ts]"]
  node_job_queue["Analysis queue<br/>[queue.ts]"]
end

subgraph group_analysis["Change analysis"]
  node_analysis_worker["Analysis worker<br/>[worker.ts]"]
  node_patch_classifier["Patch classifier<br/>[classification.ts]"]
  node_secret_scan["Secret scan sandbox<br/>[sandbox.ts]"]
  node_correction["Safe correction<br/>[corrections.ts]"]
  node_context_state["Repository context<br/>[state.ts]"]
  node_cheap_model["Cheap risk model<br/>[llm.ts]"]
  node_reasoning_model["Reasoning model<br/>[llm.ts]"]
end

subgraph group_graph["Dependency graph"]
  node_graph_builder["Graph builder<br/>[graph.ts]"]
  node_graph_store[("Graph persistence<br/>[graph-store.ts]")]
end

subgraph group_response["Decisions and response"]
  node_repo_state_store[("Repository state<br/>[state.ts]")]
  node_incident_store[("Incident records<br/>[incidents.ts]")]
  node_credential_rotation["Credential rotation<br/>[oidc.ts]"]
  node_rollback["Branch rollback<br/>[remediation.ts]"]
end

subgraph group_operations["Operations workspace"]
  node_dashboard["Operations dashboard<br/>[dashboard.tsx]"]
end

node_developer(("Repository teams"))
node_github_events(("GitHub events"))
node_github_api["GitHub API"]
node_groq["Groq"]
node_gemini["Gemini"]
node_postgres[("PostgreSQL")]
node_github_checks["GitHub Checks"]
node_discord["Discord alerts"]

node_developer -->|"pushes changes"| node_github_events
node_github_events -->|"delivers events"| node_probot
node_probot -->|"enqueues jobs"| node_job_queue
node_job_queue -->|"dispatches jobs"| node_analysis_worker
node_analysis_worker -->|"fetches diff"| node_github_api
node_analysis_worker -->|"updates graph"| node_graph_builder
node_analysis_worker -->|"scans patch"| node_secret_scan
node_analysis_worker -->|"classifies patch"| node_patch_classifier
node_analysis_worker -->|"requests correction"| node_correction
node_analysis_worker -->|"gets context"| node_context_state
node_context_state -->|"marks dirty nodes"| node_graph_builder
node_graph_builder -->|"persists graph"| node_graph_store
node_graph_store -->|"reads and writes"| node_postgres
node_analysis_worker -->|"requests verdict"| node_cheap_model
node_cheap_model -->|"calls provider"| node_groq
node_analysis_worker -->|"escalates verdict"| node_reasoning_model
node_reasoning_model -->|"calls provider"| node_gemini
node_analysis_worker -->|"updates verdict state"| node_repo_state_store
node_analysis_worker -->|"sets check result"| node_github_checks
node_analysis_worker -->|"records incidents"| node_incident_store
node_analysis_worker -->|"rotates credentials"| node_credential_rotation
node_analysis_worker -->|"requests rollback"| node_rollback
node_incident_store -->|"notifies operators"| node_discord
node_developer -->|"reviews outcomes"| node_dashboard
node_dashboard -.->|"resolves incidents"| node_incident_store
node_probot -->|"builds initial graph"| node_graph_builder
node_github_api -->|"provides repository sources"| node_graph_builder

click node_probot "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/index.ts"
click node_job_queue "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/queue.ts"
click node_analysis_worker "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/worker.ts"
click node_patch_classifier "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/classification.ts"
click node_secret_scan "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/sandbox.ts"
click node_correction "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/corrections.ts"
click node_context_state "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/state.ts"
click node_cheap_model "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/llm.ts"
click node_reasoning_model "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/llm.ts"
click node_graph_builder "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/graph.ts"
click node_graph_store "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/graph-store.ts"
click node_repo_state_store "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/state.ts"
click node_incident_store "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/incidents.ts"
click node_credential_rotation "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/oidc.ts"
click node_rollback "https://github.com/garvgupta25/rakshakai/blob/main/backend/src/remediation.ts"
click node_dashboard "https://github.com/garvgupta25/rakshakai/blob/main/dashboard/app/dashboard.tsx"

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_probot,node_job_queue toneBlue
class node_analysis_worker,node_patch_classifier,node_secret_scan,node_correction,node_context_state,node_cheap_model,node_reasoning_model,node_postgres toneAmber
class node_graph_builder,node_graph_store,node_github_api toneMint
class node_repo_state_store,node_incident_store,node_credential_rotation,node_rollback toneRose
class node_dashboard,node_developer,node_github_events,node_groq,node_gemini,node_github_checks,node_discord toneIndigo
```

## Components

### Event intake

- [Probot webhook](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/index.ts): `backend/src/index.ts`
- [Analysis queue](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/queue.ts): `backend/src/queue.ts`

### Change analysis

- [Analysis worker](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/worker.ts): `backend/src/worker.ts`
- [Patch classifier](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/classification.ts): `backend/src/classification.ts`
- [Secret scan sandbox](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/sandbox.ts): `backend/src/sandbox.ts`
- [Safe correction](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/corrections.ts): `backend/src/corrections.ts`
- [Repository context](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/state.ts): `backend/src/state.ts`
- [Cheap risk model](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/llm.ts): `backend/src/llm.ts`
- [Reasoning model](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/llm.ts): `backend/src/llm.ts`

### Dependency graph

- [Graph builder](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/graph.ts): `backend/src/graph.ts`
- [Graph persistence](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/graph-store.ts): `backend/src/graph-store.ts`

### Decisions and response

- [Repository state](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/state.ts): `backend/src/state.ts`
- [Incident records](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/incidents.ts): `backend/src/incidents.ts`
- [Credential rotation](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/oidc.ts): `backend/src/oidc.ts`
- [Branch rollback](https://github.com/garvgupta25/rakshakai/blob/main/backend/src/remediation.ts): `backend/src/remediation.ts`

### Operations workspace

- [Operations dashboard](https://github.com/garvgupta25/rakshakai/blob/main/dashboard/app/dashboard.tsx): `dashboard/app/dashboard.tsx`

### Other components

- **Repository teams**
- **GitHub events**
- **GitHub API**
- **Groq**
- **Gemini**
- **PostgreSQL**
- **GitHub Checks**
- **Discord alerts**

## Connections

- Repository teams → GitHub events: pushes changes (evidence: `README.md`)
- GitHub events → Probot webhook: delivers events (evidence: `README.md`)
- Probot webhook → Analysis queue: enqueues jobs (evidence: `backend/src/index.ts`)
- Analysis queue → Analysis worker: dispatches jobs (evidence: `README.md`)
- Analysis worker → GitHub API: fetches diff (evidence: `backend/src/worker.ts`)
- Analysis worker → Graph builder: updates graph (evidence: `backend/src/worker.ts`)
- Analysis worker → Secret scan sandbox: scans patch (evidence: `backend/src/worker.ts`)
- Analysis worker → Patch classifier: classifies patch (evidence: `README.md`)
- Analysis worker → Safe correction: requests correction (evidence: `README.md`)
- Analysis worker → Repository context: gets context (evidence: `backend/src/worker.ts`)
- Repository context → Graph builder: marks dirty nodes (evidence: `backend/src/state.ts`)
- Graph builder → Graph persistence: persists graph (evidence: `backend/src/graph.ts`)
- Graph persistence → PostgreSQL: reads and writes (evidence: `backend/src/graph-store.ts`)
- Analysis worker → Cheap risk model: requests verdict (evidence: `backend/src/worker.ts`)
- Cheap risk model → Groq: calls provider (evidence: `backend/src/llm.ts`)
- Analysis worker → Reasoning model: escalates verdict (evidence: `backend/src/worker.ts`)
- Reasoning model → Gemini: calls provider (evidence: `backend/src/llm.ts`)
- Analysis worker → Repository state: updates verdict state (evidence: `backend/src/worker.ts`)
- Analysis worker → GitHub Checks: sets check result (evidence: `README.md`)
- Analysis worker → Incident records: records incidents (evidence: `README.md`)
- Analysis worker → Credential rotation: rotates credentials (evidence: `backend/src/worker.ts`)
- Analysis worker → Branch rollback: requests rollback (evidence: `backend/src/worker.ts`)
- Incident records → Discord alerts: notifies operators (evidence: `README.md`)
- Repository teams → Operations dashboard: reviews outcomes (evidence: `README.md`)
- Operations dashboard → Incident records: resolves incidents
- Probot webhook → Graph builder: builds initial graph (evidence: `backend/src/index.ts`)
- GitHub API → Graph builder: provides repository sources
