# vijay-msrit/ai-ain-t-ready-for-us- architecture

> Architecture diagram of the GitHub repository vijay-msrit/ai-ain-t-ready-for-us-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vijay-msrit/ai-ain-t-ready-for-us-
- Repository: https://github.com/vijay-msrit/ai-ain-t-ready-for-us-

## Overview

Fixora accepts a GitHub issue or a manual run request, then indexes the repository, classifies the issue, locates relevant code, generates a patch, evaluates it, and can open a pull request. Its React frontend exposes those five phases and displays pipeline results. The README documents the agent workflow; the excerpts directly show webhook dispatch, API pipeline execution, and localizer retrieval/LLM use. Several agent implementations and graph wiring were not sampled, so their documented workflow links cite the README rather than implying source-level calls.

Main entry points: [`app/graph.py`](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/graph.py) (Agent Orchestrator), [`app/agents/indexer.py`](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/agents/indexer.py) (Repository Indexer), [`app/webhook.py`](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/webhook.py) (Webhook Triggers), [`app/tools/llm_client.py`](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/tools/llm_client.py) (LLM Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingress["Ingress and API"]
  node_main["FastAPI App<br/>[main.py]"]
  node_webhook["Webhook Triggers<br/>[webhook.py]"]
  node_api["Pipeline API<br/>[api.py]"]
end

subgraph group_pipeline["Resolution Pipeline"]
  node_graph["Agent Orchestrator<br/>[graph.py]"]
  node_state["Shared State<br/>[state.py]"]
  node_indexer["Repository Indexer<br/>[indexer.py]"]
  node_issue["Issue Processor<br/>[issue_processor.py]"]
  node_localizer["Bug Localizer<br/>[localizer.py]"]
  node_patcher["Patch Generator<br/>[patcher.py]"]
  node_evaluator["Patch Evaluator<br/>[evaluator.py]"]
end

subgraph group_tools["Runtime Tools"]
  node_repo["Repository Utilities<br/>[repo_utils.py]"]
  node_chunker["Code Chunker<br/>[chunker.py]"]
  node_vectors[("Vector Store<br/>[vector_store.py]")]
  node_llm["LLM Client<br/>[llm_client.py]"]
  node_applicator["Patch Applicator<br/>[code_applicator.py]"]
  node_github_client["GitHub Client<br/>[github_client.py]"]
  node_config["Configuration<br/>[config.py]"]
end

subgraph group_frontend["Frontend"]
  node_app["Web Interface<br/>[App.jsx]"]
  node_pages["Pipeline Pages"]
  node_client["API Client<br/>[client.js]"]
end

node_user(("User"))
node_github{{"GitHub"}}
node_chroma[("ChromaDB")]
node_model{{"LLM Provider"}}

node_user -->|"uses"| node_app
node_user -.->|"submits issue"| node_webhook
node_main -->|"registers router"| node_webhook
node_main -->|"registers router"| node_api
node_webhook -->|"dispatches run"| node_graph
node_api -->|"runs pipeline"| node_graph
node_graph -.->|"runs phase"| node_indexer
node_graph -.->|"runs phase"| node_issue
node_graph -.->|"runs phase"| node_localizer
node_graph -.->|"runs phase"| node_patcher
node_graph -.->|"runs phase"| node_evaluator
node_indexer -.->|"clones repository"| node_repo
node_indexer -.->|"chunks code"| node_chunker
node_indexer -.->|"indexes chunks"| node_vectors
node_vectors -.->|"reads and writes"| node_chroma
node_localizer -->|"queries index"| node_vectors
node_localizer -->|"builds and reranks"| node_llm
node_llm -.->|"requests completion"| node_model
node_patcher -.->|"generates patch"| node_llm
node_patcher -.->|"applies patch"| node_applicator
node_evaluator -.->|"opens pull request"| node_github_client
node_github_client -->|"creates branch and PR"| node_github
node_github -.->|"sends issue event"| node_webhook
node_app -->|"routes to"| node_pages
node_pages -.->|"requests pipeline data"| node_client
node_client -.->|"calls API"| node_api
node_config -->|"configures provider"| node_llm
node_config -->|"provides token"| node_github_client

click node_main "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/main.py"
click node_webhook "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/webhook.py"
click node_api "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/api.py"
click node_graph "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/graph.py"
click node_state "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/state.py"
click node_indexer "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/agents/indexer.py"
click node_issue "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/agents/issue_processor.py"
click node_localizer "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/agents/localizer.py"
click node_patcher "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/agents/patcher.py"
click node_evaluator "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/agents/evaluator.py"
click node_repo "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/tools/repo_utils.py"
click node_chunker "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/tools/chunker.py"
click node_vectors "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/tools/vector_store.py"
click node_llm "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/tools/llm_client.py"
click node_applicator "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/tools/code_applicator.py"
click node_github_client "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/tools/github_client.py"
click node_config "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/config.py"
click node_app "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/frontend/src/App.jsx"
click node_pages "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/tree/main/frontend/src/pages"
click node_client "https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/frontend/src/api/client.js"

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_main,node_webhook,node_api,node_user toneBlue
class node_graph,node_state,node_indexer,node_issue,node_localizer,node_patcher,node_evaluator,node_chroma toneAmber
class node_repo,node_chunker,node_vectors,node_llm,node_applicator,node_github_client,node_config toneMint
class node_app,node_pages,node_client toneRose
class node_github,node_model toneIndigo
```

## Components

### Ingress and API

- [FastAPI App](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/main.py): `app/main.py`
- [Webhook Triggers](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/webhook.py): `app/webhook.py`
- [Pipeline API](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/api.py): `app/api.py`

### Resolution Pipeline

- [Agent Orchestrator](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/graph.py): `app/graph.py`
- [Shared State](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/state.py): `app/state.py`
- [Repository Indexer](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/agents/indexer.py): `app/agents/indexer.py`
- [Issue Processor](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/agents/issue_processor.py): `app/agents/issue_processor.py`
- [Bug Localizer](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/agents/localizer.py): `app/agents/localizer.py`
- [Patch Generator](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/agents/patcher.py): `app/agents/patcher.py`
- [Patch Evaluator](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/agents/evaluator.py): `app/agents/evaluator.py`

### Runtime Tools

- [Repository Utilities](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/tools/repo_utils.py): `app/tools/repo_utils.py`
- [Code Chunker](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/tools/chunker.py): `app/tools/chunker.py`
- [Vector Store](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/tools/vector_store.py): `app/tools/vector_store.py`
- [LLM Client](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/tools/llm_client.py): `app/tools/llm_client.py`
- [Patch Applicator](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/tools/code_applicator.py): `app/tools/code_applicator.py`
- [GitHub Client](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/tools/github_client.py): `app/tools/github_client.py`
- [Configuration](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/app/config.py): `app/config.py`

### Frontend

- [Web Interface](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Pipeline Pages](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/tree/main/frontend/src/pages): `frontend/src/pages`
- [API Client](https://github.com/vijay-msrit/ai-ain-t-ready-for-us-/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`

### Other components

- **User**
- **GitHub**
- **ChromaDB**
- **LLM Provider**

## Connections

- User → Web Interface: uses (evidence: `frontend/src/App.jsx`)
- User → Webhook Triggers: submits issue (evidence: `README.md`)
- FastAPI App → Webhook Triggers: registers router (evidence: `app/main.py`)
- FastAPI App → Pipeline API: registers router (evidence: `app/main.py`)
- Webhook Triggers → Agent Orchestrator: dispatches run (evidence: `app/webhook.py`)
- Pipeline API → Agent Orchestrator: runs pipeline (evidence: `app/api.py`)
- Agent Orchestrator → Repository Indexer: runs phase (evidence: `README.md`)
- Agent Orchestrator → Issue Processor: runs phase (evidence: `README.md`)
- Agent Orchestrator → Bug Localizer: runs phase (evidence: `README.md`)
- Agent Orchestrator → Patch Generator: runs phase (evidence: `README.md`)
- Agent Orchestrator → Patch Evaluator: runs phase (evidence: `README.md`)
- Repository Indexer → Repository Utilities: clones repository (evidence: `README.md`)
- Repository Indexer → Code Chunker: chunks code (evidence: `README.md`)
- Repository Indexer → Vector Store: indexes chunks (evidence: `README.md`)
- Vector Store → ChromaDB: reads and writes (evidence: `README.md`)
- Bug Localizer → Vector Store: queries index (evidence: `app/agents/localizer.py`)
- Bug Localizer → LLM Client: builds and reranks (evidence: `app/agents/localizer.py`)
- LLM Client → LLM Provider: requests completion (evidence: `app/tools/llm_client.py`)
- Patch Generator → LLM Client: generates patch (evidence: `README.md`)
- Patch Generator → Patch Applicator: applies patch (evidence: `README.md`)
- Patch Evaluator → GitHub Client: opens pull request (evidence: `README.md`)
- GitHub Client → GitHub: creates branch and PR (evidence: `app/tools/github_client.py`)
- GitHub → Webhook Triggers: sends issue event (evidence: `README.md`)
- Web Interface → Pipeline Pages: routes to (evidence: `frontend/src/App.jsx`)
- Pipeline Pages → API Client: requests pipeline data (evidence: `frontend/src/pages/Evaluator.jsx`)
- API Client → Pipeline API: calls API (evidence: `frontend/src/api/client.js`)
- Configuration → LLM Client: configures provider (evidence: `app/tools/llm_client.py`)
- Configuration → GitHub Client: provides token (evidence: `app/tools/github_client.py`)
