# pralhadyadawad/avvarre architecture

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

- Interactive diagram: https://gitdiagram.com/pralhadyadawad/avvarre
- Repository: https://github.com/pralhadyadawad/avvarre

## Overview

Avvarre is a local-first coding assistant that combines style analysis, workspace and PR reviews, dependency-impact analysis, and persistent memory behind an MCP server and IDE integrations. The main review flow runs from an IDE or CLI request through the server to file/workspace scanning, language rules, scoring, and optional AI analysis. Separate branches cover graph-based impact, memory, setup and skill detection, and IDE lifecycle hooks. Several subsystem links are documented in the README or SOURCE INDEX; unsampled internals are not inferred beyond those references.

Main entry points: [`src/server.ts`](https://github.com/pralhadyadawad/avvarre/blob/master/src/server.ts) (MCP server), [`src/analyzer/engine.ts`](https://github.com/pralhadyadawad/avvarre/blob/master/src/analyzer/engine.ts) (Analysis engine), [`src/index.ts`](https://github.com/pralhadyadawad/avvarre/blob/master/src/index.ts) (CLI entry), [`src/workspace/scanner.ts`](https://github.com/pralhadyadawad/avvarre/blob/master/src/workspace/scanner.ts) (Workspace scanner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and review"]
  node_cli["CLI entry<br/>[index.ts]"]
  node_mcp["MCP server<br/>[server.ts]"]
  node_workspace["Workspace scanner<br/>[scanner.ts]"]
  node_pr["PR scanner<br/>[pr_scanner.ts]"]
end

subgraph group_analysis["Code analysis"]
  node_engine["Analysis engine<br/>[engine.ts]"]
  node_rules["Language rules"]
  node_scorer["Scoring<br/>[scorer.ts]"]
  node_ai["AI analysis"]
  node_ai_factory["AI client factory<br/>[client.ts]"]
end

subgraph group_context["Context and impact"]
  node_graph["Dependency graph<br/>[index.ts]"]
  node_graph_parser["AST graph parser<br/>[parser.ts]"]
  node_graph_store[("Graph database<br/>[connection.ts]")]
  node_memory["Memory store<br/>[store.ts]"]
  node_memory_search["Hybrid memory search<br/>[search.ts]"]
  node_memory_db[("Memory database")]
end

subgraph group_ecosystem["Setup and skills"]
  node_scaffold["Workspace scaffold<br/>[scaffold.ts]"]
  node_stack["Stack detection<br/>[stack_detector.ts]"]
  node_skills["Community skills"]
  node_claude_setup["Claude setup<br/>[claude_setup.ts]"]
end

subgraph group_integrations["IDE integrations"]
  node_hooks["IDE lifecycle hooks"]
end

node_developer(("Developer / IDE"))

node_developer -->|"runs CLI"| node_cli
node_developer -->|"invokes tools"| node_mcp
node_cli -->|"starts server"| node_mcp
node_cli -->|"analyzes file"| node_engine
node_mcp -->|"scans workspace"| node_workspace
node_mcp -->|"audits changes"| node_pr
node_workspace -->|"analyzes files"| node_engine
node_workspace -->|"requests AI client"| node_ai_factory
node_engine -->|"runs rules"| node_rules
node_engine -->|"calculates scores"| node_scorer
node_ai_factory -->|"selects provider"| node_ai
node_mcp -.->|"queries impact"| node_graph
node_graph -->|"parses files"| node_graph_parser
node_graph -->|"updates metadata"| node_graph_store
node_mcp -.->|"exposes memory tools"| node_memory
node_memory -->|"persists memories"| node_memory_db
node_memory -.->|"supports retrieval"| node_memory_search
node_memory_search -->|"queries records"| node_memory_db
node_mcp -->|"scaffolds workspace"| node_scaffold
node_mcp -->|"sets up Claude"| node_claude_setup
node_scaffold -->|"detects stack"| node_stack
node_scaffold -->|"fetches rules"| node_skills
node_developer -->|"triggers lifecycle"| node_hooks

click node_cli "https://github.com/pralhadyadawad/avvarre/blob/master/src/index.ts"
click node_mcp "https://github.com/pralhadyadawad/avvarre/blob/master/src/server.ts"
click node_workspace "https://github.com/pralhadyadawad/avvarre/blob/master/src/workspace/scanner.ts"
click node_pr "https://github.com/pralhadyadawad/avvarre/blob/master/src/workspace/pr_scanner.ts"
click node_engine "https://github.com/pralhadyadawad/avvarre/blob/master/src/analyzer/engine.ts"
click node_rules "https://github.com/pralhadyadawad/avvarre/tree/master/src/analyzer/rules"
click node_scorer "https://github.com/pralhadyadawad/avvarre/blob/master/src/analyzer/scorer.ts"
click node_ai "https://github.com/pralhadyadawad/avvarre/tree/master/src/ai"
click node_ai_factory "https://github.com/pralhadyadawad/avvarre/blob/master/src/ai/client.ts"
click node_graph "https://github.com/pralhadyadawad/avvarre/blob/master/src/graph/index.ts"
click node_graph_parser "https://github.com/pralhadyadawad/avvarre/blob/master/src/graph/parser.ts"
click node_graph_store "https://github.com/pralhadyadawad/avvarre/blob/master/src/db/connection.ts"
click node_memory "https://github.com/pralhadyadawad/avvarre/blob/master/src/memory/store.ts"
click node_memory_search "https://github.com/pralhadyadawad/avvarre/blob/master/src/memory/search.ts"
click node_memory_db "https://github.com/pralhadyadawad/avvarre/blob/master/src/db/memory-connection.ts"
click node_scaffold "https://github.com/pralhadyadawad/avvarre/blob/master/src/ecosystem/scaffold.ts"
click node_stack "https://github.com/pralhadyadawad/avvarre/blob/master/src/ecosystem/stack_detector.ts"
click node_skills "https://github.com/pralhadyadawad/avvarre/blob/master/src/ecosystem/community_fetcher.ts"
click node_claude_setup "https://github.com/pralhadyadawad/avvarre/blob/master/src/ecosystem/claude_setup.ts"
click node_hooks "https://github.com/pralhadyadawad/avvarre/tree/master/plugins/avvarre/hooks"

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_cli,node_mcp,node_workspace,node_pr toneBlue
class node_engine,node_rules,node_scorer,node_ai,node_ai_factory toneAmber
class node_graph,node_graph_parser,node_graph_store,node_memory,node_memory_search,node_memory_db toneMint
class node_scaffold,node_stack,node_skills,node_claude_setup toneRose
class node_hooks,node_developer toneIndigo
```

## Components

### Entry and review

- [CLI entry](https://github.com/pralhadyadawad/avvarre/blob/master/src/index.ts): `src/index.ts`
- [MCP server](https://github.com/pralhadyadawad/avvarre/blob/master/src/server.ts): `src/server.ts`
- [Workspace scanner](https://github.com/pralhadyadawad/avvarre/blob/master/src/workspace/scanner.ts): `src/workspace/scanner.ts`
- [PR scanner](https://github.com/pralhadyadawad/avvarre/blob/master/src/workspace/pr_scanner.ts): `src/workspace/pr_scanner.ts`

### Code analysis

- [Analysis engine](https://github.com/pralhadyadawad/avvarre/blob/master/src/analyzer/engine.ts): `src/analyzer/engine.ts`
- [Language rules](https://github.com/pralhadyadawad/avvarre/tree/master/src/analyzer/rules): `src/analyzer/rules`
- [Scoring](https://github.com/pralhadyadawad/avvarre/blob/master/src/analyzer/scorer.ts): `src/analyzer/scorer.ts`
- [AI analysis](https://github.com/pralhadyadawad/avvarre/tree/master/src/ai): `src/ai`
- [AI client factory](https://github.com/pralhadyadawad/avvarre/blob/master/src/ai/client.ts): `src/ai/client.ts`

### Context and impact

- [Dependency graph](https://github.com/pralhadyadawad/avvarre/blob/master/src/graph/index.ts): `src/graph/index.ts`
- [AST graph parser](https://github.com/pralhadyadawad/avvarre/blob/master/src/graph/parser.ts): `src/graph/parser.ts`
- [Graph database](https://github.com/pralhadyadawad/avvarre/blob/master/src/db/connection.ts): `src/db/connection.ts`
- [Memory store](https://github.com/pralhadyadawad/avvarre/blob/master/src/memory/store.ts): `src/memory/store.ts`
- [Hybrid memory search](https://github.com/pralhadyadawad/avvarre/blob/master/src/memory/search.ts): `src/memory/search.ts`
- [Memory database](https://github.com/pralhadyadawad/avvarre/blob/master/src/db/memory-connection.ts): `src/db/memory-connection.ts`

### Setup and skills

- [Workspace scaffold](https://github.com/pralhadyadawad/avvarre/blob/master/src/ecosystem/scaffold.ts): `src/ecosystem/scaffold.ts`
- [Stack detection](https://github.com/pralhadyadawad/avvarre/blob/master/src/ecosystem/stack_detector.ts): `src/ecosystem/stack_detector.ts`
- [Community skills](https://github.com/pralhadyadawad/avvarre/blob/master/src/ecosystem/community_fetcher.ts): `src/ecosystem/community_fetcher.ts`
- [Claude setup](https://github.com/pralhadyadawad/avvarre/blob/master/src/ecosystem/claude_setup.ts): `src/ecosystem/claude_setup.ts`

### IDE integrations

- [IDE lifecycle hooks](https://github.com/pralhadyadawad/avvarre/tree/master/plugins/avvarre/hooks): `plugins/avvarre/hooks`

### Other components

- **Developer / IDE**

## Connections

- Developer / IDE → CLI entry: runs CLI (evidence: `README.md`)
- Developer / IDE → MCP server: invokes tools (evidence: `README.md`)
- CLI entry → MCP server: starts server (evidence: `src/index.ts`)
- CLI entry → Analysis engine: analyzes file (evidence: `src/index.ts`)
- MCP server → Workspace scanner: scans workspace (evidence: `src/server.ts`)
- MCP server → PR scanner: audits changes (evidence: `README.md`)
- Workspace scanner → Analysis engine: analyzes files (evidence: `src/workspace/scanner.ts`)
- Workspace scanner → AI client factory: requests AI client (evidence: `src/workspace/scanner.ts`)
- Analysis engine → Language rules: runs rules (evidence: `src/analyzer/engine.ts`)
- Analysis engine → Scoring: calculates scores (evidence: `src/analyzer/engine.ts`)
- AI client factory → AI analysis: selects provider (evidence: `src/ai/client.ts`)
- MCP server → Dependency graph: queries impact (evidence: `README.md`)
- Dependency graph → AST graph parser: parses files (evidence: `src/graph/index.ts`)
- Dependency graph → Graph database: updates metadata (evidence: `src/graph/index.ts`)
- MCP server → Memory store: exposes memory tools (evidence: `README.md`)
- Memory store → Memory database: persists memories (evidence: `src/memory/store.ts`)
- Memory store → Hybrid memory search: supports retrieval (evidence: `README.md`)
- Hybrid memory search → Memory database: queries records (evidence: `src/memory/search.ts`)
- MCP server → Workspace scaffold: scaffolds workspace (evidence: `src/server.ts`)
- MCP server → Claude setup: sets up Claude (evidence: `src/server.ts`)
- Workspace scaffold → Stack detection: detects stack (evidence: `src/ecosystem/scaffold.ts`)
- Workspace scaffold → Community skills: fetches rules (evidence: `src/ecosystem/scaffold.ts`)
- Developer / IDE → IDE lifecycle hooks: triggers lifecycle (evidence: `README.md`)
