# gust-feng/deltaconverge architecture

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

- Interactive diagram: https://gitdiagram.com/gust-feng/deltaconverge
- Repository: https://github.com/gust-feng/deltaconverge

## Overview

DeltaConverge is a local code-review workbench with Web and CLI entry points sharing one KernelFacade. A review request is orchestrated through diff/context preparation, intent analysis, planning, plan fusion, and review execution; optional static scanning adds findings. The result and ordered run events are stored and exposed to clients, which can inspect sessions and ask follow-up questions. The README documents project, configuration, scan, dashboard, and rule-growth capabilities; those are represented as service branches. Wiring beyond the supplied excerpts is shown only where README or source explicitly supports it.

Main entry points: [`kernel/application/pipeline_executor.py`](https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/pipeline_executor.py) (Pipeline executor), [`kernel/application/services`](https://github.com/gust-feng/deltaconverge/tree/main/kernel/application/services) (Domain services), [`kernel/infrastructure/engine_adapter.py`](https://github.com/gust-feng/deltaconverge/blob/main/kernel/infrastructure/engine_adapter.py) (Legacy engine adapter), [`kernel/application/facade.py`](https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/facade.py) (Kernel facade)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User clients"]
  node_react["React workbench<br/>[App.tsx]"]
  node_cli["Review CLI<br/>[runner.py]"]
end

subgraph group_entry["Entry and API"]
  node_web["Web API v2<br/>[app.py]"]
  node_routers["API routers"]
  node_facade["Kernel facade<br/>[facade.py]"]
  node_sse["Review event stream<br/>[review_service.py]"]
end

subgraph group_workflow["Review workflow"]
  node_orchestrator["Review orchestrator"]
  node_executor["Pipeline executor"]
  node_diff["Diff stage<br/>[diff_stage.py]"]
  node_intent["Intent stage<br/>[intent_stage.py]"]
  node_planner["Planning stage<br/>[planner_stage.py]"]
  node_fusion["Fusion stage<br/>[fusion_stage.py]"]
  node_scan["Static scanning<br/>[runner.py]"]
  node_review["Review stage<br/>[review_stage.py]"]
end

subgraph group_engines["Review engines"]
  node_legacy_engines["Legacy engine adapter<br/>[engine_adapter.py]"]
  node_llm["LLM integration<br/>[llm_adapter.py]"]
end

subgraph group_state["State and services"]
  node_services["Domain services"]
  node_storage[("Session and artifacts<br/>[persistence.py]")]
  node_events["Run event bus<br/>[event_bus.py]"]
end

node_user(("Reviewer"))
node_project["Code repository"]
node_model_service(("Model provider"))

node_user -->|"uses"| node_react
node_user -->|"invokes"| node_cli
node_react -->|"calls API"| node_web
node_cli -->|"invokes"| node_facade
node_web -->|"dispatches"| node_routers
node_routers -->|"delegates"| node_facade
node_facade -->|"dispatches"| node_services
node_services -->|"starts review"| node_orchestrator
node_orchestrator -->|"executes stages"| node_executor
node_executor -->|"runs stage"| node_diff
node_executor -->|"runs stage"| node_intent
node_executor -->|"runs stage"| node_planner
node_executor -->|"runs stage"| node_fusion
node_executor -.->|"runs stage"| node_scan
node_executor -->|"runs stage"| node_review
node_diff -->|"reads changes"| node_project
node_intent -->|"analyzes intent"| node_legacy_engines
node_planner -->|"plans review"| node_legacy_engines
node_fusion -->|"fuses plan"| node_legacy_engines
node_review -->|"reviews code"| node_legacy_engines
node_legacy_engines -->|"uses adapter"| node_llm
node_llm -->|"requests completion"| node_model_service
node_services -->|"reads and writes"| node_storage
node_orchestrator -->|"publishes events"| node_events
node_services -->|"streams events"| node_sse
node_sse -->|"sends SSE"| node_react
node_facade -->|"serves capabilities"| node_services

click node_react "https://github.com/gust-feng/deltaconverge/blob/main/frontend/react/src/App.tsx"
click node_cli "https://github.com/gust-feng/deltaconverge/blob/main/adapters/cli/runner.py"
click node_web "https://github.com/gust-feng/deltaconverge/blob/main/adapters/web/app.py"
click node_routers "https://github.com/gust-feng/deltaconverge/tree/main/adapters/web/routers"
click node_facade "https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/facade.py"
click node_orchestrator "https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/review_orchestrator.py"
click node_executor "https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/pipeline_executor.py"
click node_diff "https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/stages/diff_stage.py"
click node_intent "https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/stages/intent_stage.py"
click node_planner "https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/stages/planner_stage.py"
click node_fusion "https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/stages/fusion_stage.py"
click node_scan "https://github.com/gust-feng/deltaconverge/blob/main/kernel/infrastructure/scan/runner.py"
click node_review "https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/stages/review_stage.py"
click node_legacy_engines "https://github.com/gust-feng/deltaconverge/blob/main/kernel/infrastructure/engine_adapter.py"
click node_llm "https://github.com/gust-feng/deltaconverge/blob/main/kernel/infrastructure/llm_adapter.py"
click node_services "https://github.com/gust-feng/deltaconverge/tree/main/kernel/application/services"
click node_storage "https://github.com/gust-feng/deltaconverge/blob/main/kernel/infrastructure/persistence.py"
click node_events "https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/event_bus.py"
click node_sse "https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/services/review_service.py"

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_react,node_cli,node_user toneBlue
class node_web,node_routers,node_facade,node_sse toneAmber
class node_orchestrator,node_executor,node_diff,node_intent,node_planner,node_fusion,node_scan,node_review toneMint
class node_legacy_engines,node_llm toneRose
class node_services,node_storage,node_events,node_project,node_model_service toneIndigo
```

## Components

### User clients

- [React workbench](https://github.com/gust-feng/deltaconverge/blob/main/frontend/react/src/App.tsx): `frontend/react/src/App.tsx`
- [Review CLI](https://github.com/gust-feng/deltaconverge/blob/main/adapters/cli/runner.py): `adapters/cli/runner.py`

### Entry and API

- [Web API v2](https://github.com/gust-feng/deltaconverge/blob/main/adapters/web/app.py): `adapters/web/app.py`
- [API routers](https://github.com/gust-feng/deltaconverge/tree/main/adapters/web/routers): `adapters/web/routers`
- [Kernel facade](https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/facade.py): `kernel/application/facade.py`
- [Review event stream](https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/services/review_service.py): `kernel/application/services/review_service.py`

### Review workflow

- [Review orchestrator](https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/review_orchestrator.py): `kernel/application/review_orchestrator.py`
- [Pipeline executor](https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/pipeline_executor.py): `kernel/application/pipeline_executor.py`
- [Diff stage](https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/stages/diff_stage.py): `kernel/application/stages/diff_stage.py`
- [Intent stage](https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/stages/intent_stage.py): `kernel/application/stages/intent_stage.py`
- [Planning stage](https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/stages/planner_stage.py): `kernel/application/stages/planner_stage.py`
- [Fusion stage](https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/stages/fusion_stage.py): `kernel/application/stages/fusion_stage.py`
- [Static scanning](https://github.com/gust-feng/deltaconverge/blob/main/kernel/infrastructure/scan/runner.py): `kernel/infrastructure/scan/runner.py`
- [Review stage](https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/stages/review_stage.py): `kernel/application/stages/review_stage.py`

### Review engines

- [Legacy engine adapter](https://github.com/gust-feng/deltaconverge/blob/main/kernel/infrastructure/engine_adapter.py): `kernel/infrastructure/engine_adapter.py`
- [LLM integration](https://github.com/gust-feng/deltaconverge/blob/main/kernel/infrastructure/llm_adapter.py): `kernel/infrastructure/llm_adapter.py`

### State and services

- [Domain services](https://github.com/gust-feng/deltaconverge/tree/main/kernel/application/services): `kernel/application/services`
- [Session and artifacts](https://github.com/gust-feng/deltaconverge/blob/main/kernel/infrastructure/persistence.py): `kernel/infrastructure/persistence.py`
- [Run event bus](https://github.com/gust-feng/deltaconverge/blob/main/kernel/application/event_bus.py): `kernel/application/event_bus.py`

### Other components

- **Reviewer**
- **Code repository**
- **Model provider**

## Connections

- Reviewer → React workbench: uses
- Reviewer → Review CLI: invokes
- React workbench → Web API v2: calls API
- Review CLI → Kernel facade: invokes
- Web API v2 → API routers: dispatches
- API routers → Kernel facade: delegates
- Kernel facade → Domain services: dispatches
- Domain services → Review orchestrator: starts review
- Review orchestrator → Pipeline executor: executes stages
- Pipeline executor → Diff stage: runs stage
- Pipeline executor → Intent stage: runs stage
- Pipeline executor → Planning stage: runs stage
- Pipeline executor → Fusion stage: runs stage
- Pipeline executor → Static scanning: runs stage
- Pipeline executor → Review stage: runs stage
- Diff stage → Code repository: reads changes
- Intent stage → Legacy engine adapter: analyzes intent
- Planning stage → Legacy engine adapter: plans review
- Fusion stage → Legacy engine adapter: fuses plan
- Review stage → Legacy engine adapter: reviews code
- Legacy engine adapter → LLM integration: uses adapter
- LLM integration → Model provider: requests completion
- Domain services → Session and artifacts: reads and writes
- Review orchestrator → Run event bus: publishes events
- Domain services → Review event stream: streams events
- Review event stream → React workbench: sends SSE
- Kernel facade → Domain services: serves capabilities