# orurh/patchcourt architecture

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

- Interactive diagram: https://gitdiagram.com/orurh/patchcourt
- Repository: https://github.com/orurh/patchcourt

## Overview

PatchCourt is a deterministic C++ architecture-review tool: it compares project architecture across a patch, distinguishes newly introduced or amplified risk from improvements and existing debt, and packages evidence for reviewers. Its main workflow runs from a repository comparison through project analysis and before/after impact review to a data-first bundle, optionally shown in a local viewer. The README documents the product workflow; sampled engine and viewer excerpts support several internal and presentation links, while unsampled implementation details are represented only where the tree and README establish their role.

Main entry points: [`core/go/internal/usecase/review`](https://github.com/orurh/patchcourt/tree/main/core/go/internal/usecase/review) (Review workflow), [`core/go/internal/engine/engine.go`](https://github.com/orurh/patchcourt/blob/main/core/go/internal/engine/engine.go) (Analysis engine), [`core/go/internal/render/reviewbundle`](https://github.com/orurh/patchcourt/tree/main/core/go/internal/render/reviewbundle) (Review bundle), [`web/viewer/src/components/RepositoryPanel.tsx`](https://github.com/orurh/patchcourt/blob/main/web/viewer/src/components/RepositoryPanel.tsx) (Compare controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Review entry"]
  node_cli["PatchCourt CLI"]
  node_reviewusecase["Review workflow"]
  node_gitsource["Git source"]
end

subgraph group_analysis["Project analysis"]
  node_engine["Analysis engine<br/>[engine.go]"]
  node_discovery["Project discovery"]
  node_projectbuilder["Project model<br/>[builder.go]"]
  node_dependencygraph["Dependency graph<br/>[layer_graph.go]"]
  node_rules["Architecture rules<br/>[engine.go]"]
  node_runtime["Runtime risk signals"]
end

subgraph group_impact["Patch impact"]
  node_projectcompare["Before/after models<br/>[compare.go]"]
  node_dependencydiff["Dependency changes<br/>[diff.go]"]
  node_contractdiff["Contract changes"]
  node_findingdiff["Finding changes<br/>[diff.go]"]
  node_reviewrisk["Review impact<br/>[risk.go]"]
end

subgraph group_delivery["Review delivery"]
  node_bundle["Review bundle"]
  node_llmpack["LLM context pack<br/>[pack.go]"]
  node_sarif["SARIF export<br/>[sarif.go]"]
  node_server["Local review API<br/>[server.go]"]
  node_viewerapp["Viewer app<br/>[App.tsx]"]
  node_viewerapi["Viewer API client<br/>[api.ts]"]
  node_repositorypanel["Compare controls"]
  node_dashboard["Review dashboard"]
  node_projecttree["Architecture map<br/>[ProjectTree.tsx]"]
  node_architectureflow["Dependency flow view"]
  node_commitgraph["Commit graph<br/>[CommitGraph.tsx]"]
end

node_reviewer(("Reviewer"))
node_repository["C++ repository"]

node_reviewer -->|"runs review"| node_cli
node_repository -->|"supplies comparison"| node_reviewusecase
node_cli -->|"starts review"| node_reviewusecase
node_reviewusecase -->|"compares revisions"| node_gitsource
node_reviewusecase -->|"requests analysis"| node_engine
node_engine -->|"discovers project"| node_discovery
node_engine -->|"builds model"| node_projectbuilder
node_engine -->|"analyzes usage"| node_dependencygraph
node_engine -->|"applies rules"| node_rules
node_engine -.->|"analyzes runtime risk"| node_runtime
node_reviewusecase -->|"compares models"| node_projectcompare
node_reviewusecase -->|"diffs dependencies"| node_dependencydiff
node_reviewusecase -->|"diffs contracts"| node_contractdiff
node_reviewusecase -->|"diffs findings"| node_findingdiff
node_reviewusecase -.->|"assesses impact"| node_reviewrisk
node_reviewusecase -->|"writes bundle"| node_bundle
node_bundle -->|"includes context pack"| node_llmpack
node_bundle -->|"includes SARIF"| node_sarif
node_reviewer -->|"selects revisions"| node_repositorypanel
node_repositorypanel -->|"creates review"| node_viewerapi
node_viewerapp -->|"fetches review data"| node_viewerapi
node_viewerapp -->|"renders controls"| node_repositorypanel
node_viewerapp -->|"renders results"| node_dashboard
node_viewerapi -->|"calls review API"| node_server
node_server -->|"serves review data"| node_bundle
node_dashboard -->|"renders architecture tab"| node_projecttree
node_projecttree -->|"renders dependency map"| node_architectureflow
node_repositorypanel -->|"renders commit selection"| node_commitgraph

click node_cli "https://github.com/orurh/patchcourt/tree/main/core/go/internal/adapter/cli"
click node_reviewusecase "https://github.com/orurh/patchcourt/tree/main/core/go/internal/usecase/review"
click node_gitsource "https://github.com/orurh/patchcourt/tree/main/core/go/internal/source"
click node_engine "https://github.com/orurh/patchcourt/blob/main/core/go/internal/engine/engine.go"
click node_discovery "https://github.com/orurh/patchcourt/tree/main/core/go/internal/analyzer/discovery"
click node_projectbuilder "https://github.com/orurh/patchcourt/blob/main/core/go/internal/analyzer/project/builder.go"
click node_dependencygraph "https://github.com/orurh/patchcourt/blob/main/core/go/internal/analyzer/graph/layer_graph.go"
click node_rules "https://github.com/orurh/patchcourt/blob/main/core/go/internal/analyzer/rules/engine.go"
click node_runtime "https://github.com/orurh/patchcourt/tree/main/core/go/internal/analyzer/lang/cpp/runtime"
click node_projectcompare "https://github.com/orurh/patchcourt/blob/main/core/go/internal/diff/project/compare.go"
click node_dependencydiff "https://github.com/orurh/patchcourt/blob/main/core/go/internal/diff/dep/diff.go"
click node_contractdiff "https://github.com/orurh/patchcourt/tree/main/core/go/internal/diff/contract"
click node_findingdiff "https://github.com/orurh/patchcourt/blob/main/core/go/internal/diff/finding/diff.go"
click node_reviewrisk "https://github.com/orurh/patchcourt/blob/main/core/go/internal/reviewrisk/risk.go"
click node_bundle "https://github.com/orurh/patchcourt/tree/main/core/go/internal/render/reviewbundle"
click node_llmpack "https://github.com/orurh/patchcourt/blob/main/core/go/internal/render/llmpack/pack.go"
click node_sarif "https://github.com/orurh/patchcourt/blob/main/core/go/internal/render/sarif/sarif.go"
click node_server "https://github.com/orurh/patchcourt/blob/main/core/go/internal/serve/bundle/server.go"
click node_viewerapp "https://github.com/orurh/patchcourt/blob/main/web/viewer/src/App.tsx"
click node_viewerapi "https://github.com/orurh/patchcourt/blob/main/web/viewer/src/api.ts"
click node_repositorypanel "https://github.com/orurh/patchcourt/blob/main/web/viewer/src/components/RepositoryPanel.tsx"
click node_dashboard "https://github.com/orurh/patchcourt/blob/main/web/viewer/src/components/ReviewDashboard.tsx"
click node_projecttree "https://github.com/orurh/patchcourt/blob/main/web/viewer/src/components/ProjectTree.tsx"
click node_architectureflow "https://github.com/orurh/patchcourt/blob/main/web/viewer/src/components/ArchitectureFlow.tsx"
click node_commitgraph "https://github.com/orurh/patchcourt/blob/main/web/viewer/src/components/git/CommitGraph.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_cli,node_reviewusecase,node_gitsource,node_reviewer toneBlue
class node_engine,node_discovery,node_projectbuilder,node_dependencygraph,node_rules,node_runtime toneAmber
class node_projectcompare,node_dependencydiff,node_contractdiff,node_findingdiff,node_reviewrisk toneMint
class node_bundle,node_llmpack,node_sarif,node_server,node_viewerapp,node_viewerapi,node_repositorypanel,node_dashboard,node_projecttree,node_architectureflow,node_commitgraph toneRose
class node_repository toneIndigo
```

## Components

### Review entry

- [PatchCourt CLI](https://github.com/orurh/patchcourt/tree/main/core/go/internal/adapter/cli): `core/go/internal/adapter/cli`
- [Review workflow](https://github.com/orurh/patchcourt/tree/main/core/go/internal/usecase/review): `core/go/internal/usecase/review`
- [Git source](https://github.com/orurh/patchcourt/tree/main/core/go/internal/source): `core/go/internal/source`

### Project analysis

- [Analysis engine](https://github.com/orurh/patchcourt/blob/main/core/go/internal/engine/engine.go): `core/go/internal/engine/engine.go`
- [Project discovery](https://github.com/orurh/patchcourt/tree/main/core/go/internal/analyzer/discovery): `core/go/internal/analyzer/discovery`
- [Project model](https://github.com/orurh/patchcourt/blob/main/core/go/internal/analyzer/project/builder.go): `core/go/internal/analyzer/project/builder.go`
- [Dependency graph](https://github.com/orurh/patchcourt/blob/main/core/go/internal/analyzer/graph/layer_graph.go): `core/go/internal/analyzer/graph/layer_graph.go`
- [Architecture rules](https://github.com/orurh/patchcourt/blob/main/core/go/internal/analyzer/rules/engine.go): `core/go/internal/analyzer/rules/engine.go`
- [Runtime risk signals](https://github.com/orurh/patchcourt/tree/main/core/go/internal/analyzer/lang/cpp/runtime): `core/go/internal/analyzer/lang/cpp/runtime`

### Patch impact

- [Before/after models](https://github.com/orurh/patchcourt/blob/main/core/go/internal/diff/project/compare.go): `core/go/internal/diff/project/compare.go`
- [Dependency changes](https://github.com/orurh/patchcourt/blob/main/core/go/internal/diff/dep/diff.go): `core/go/internal/diff/dep/diff.go`
- [Contract changes](https://github.com/orurh/patchcourt/tree/main/core/go/internal/diff/contract): `core/go/internal/diff/contract`
- [Finding changes](https://github.com/orurh/patchcourt/blob/main/core/go/internal/diff/finding/diff.go): `core/go/internal/diff/finding/diff.go`
- [Review impact](https://github.com/orurh/patchcourt/blob/main/core/go/internal/reviewrisk/risk.go): `core/go/internal/reviewrisk/risk.go`

### Review delivery

- [Review bundle](https://github.com/orurh/patchcourt/tree/main/core/go/internal/render/reviewbundle): `core/go/internal/render/reviewbundle`
- [LLM context pack](https://github.com/orurh/patchcourt/blob/main/core/go/internal/render/llmpack/pack.go): `core/go/internal/render/llmpack/pack.go`
- [SARIF export](https://github.com/orurh/patchcourt/blob/main/core/go/internal/render/sarif/sarif.go): `core/go/internal/render/sarif/sarif.go`
- [Local review API](https://github.com/orurh/patchcourt/blob/main/core/go/internal/serve/bundle/server.go): `core/go/internal/serve/bundle/server.go`
- [Viewer app](https://github.com/orurh/patchcourt/blob/main/web/viewer/src/App.tsx): `web/viewer/src/App.tsx`
- [Viewer API client](https://github.com/orurh/patchcourt/blob/main/web/viewer/src/api.ts): `web/viewer/src/api.ts`
- [Compare controls](https://github.com/orurh/patchcourt/blob/main/web/viewer/src/components/RepositoryPanel.tsx): `web/viewer/src/components/RepositoryPanel.tsx`
- [Review dashboard](https://github.com/orurh/patchcourt/blob/main/web/viewer/src/components/ReviewDashboard.tsx): `web/viewer/src/components/ReviewDashboard.tsx`
- [Architecture map](https://github.com/orurh/patchcourt/blob/main/web/viewer/src/components/ProjectTree.tsx): `web/viewer/src/components/ProjectTree.tsx`
- [Dependency flow view](https://github.com/orurh/patchcourt/blob/main/web/viewer/src/components/ArchitectureFlow.tsx): `web/viewer/src/components/ArchitectureFlow.tsx`
- [Commit graph](https://github.com/orurh/patchcourt/blob/main/web/viewer/src/components/git/CommitGraph.tsx): `web/viewer/src/components/git/CommitGraph.tsx`

### Other components

- **Reviewer**
- **C++ repository**

## Connections

- Reviewer → PatchCourt CLI: runs review (evidence: `README.md`)
- C++ repository → Review workflow: supplies comparison (evidence: `README.md`)
- PatchCourt CLI → Review workflow: starts review (evidence: `README.md`)
- Review workflow → Git source: compares revisions (evidence: `README.md`)
- Review workflow → Analysis engine: requests analysis (evidence: `README.md`)
- Analysis engine → Project discovery: discovers project (evidence: `core/go/internal/engine/engine.go`)
- Analysis engine → Project model: builds model (evidence: `core/go/internal/engine/engine.go`)
- Analysis engine → Dependency graph: analyzes usage (evidence: `core/go/internal/engine/engine.go`)
- Analysis engine → Architecture rules: applies rules (evidence: `core/go/internal/engine/engine.go`)
- Analysis engine → Runtime risk signals: analyzes runtime risk
- Review workflow → Before/after models: compares models (evidence: `README.md`)
- Review workflow → Dependency changes: diffs dependencies (evidence: `README.md`)
- Review workflow → Contract changes: diffs contracts (evidence: `README.md`)
- Review workflow → Finding changes: diffs findings (evidence: `README.md`)
- Review workflow → Review impact: assesses impact
- Review workflow → Review bundle: writes bundle (evidence: `README.md`)
- Review bundle → LLM context pack: includes context pack (evidence: `README.md`)
- Review bundle → SARIF export: includes SARIF (evidence: `README.md`)
- Reviewer → Compare controls: selects revisions (evidence: `README.md`)
- Compare controls → Viewer API client: creates review (evidence: `web/viewer/src/components/RepositoryPanel.tsx`)
- Viewer app → Viewer API client: fetches review data (evidence: `web/viewer/src/App.tsx`)
- Viewer app → Compare controls: renders controls (evidence: `web/viewer/src/App.tsx`)
- Viewer app → Review dashboard: renders results (evidence: `web/viewer/src/App.tsx`)
- Viewer API client → Local review API: calls review API (evidence: `README.md`)
- Local review API → Review bundle: serves review data (evidence: `README.md`)
- Review dashboard → Architecture map: renders architecture tab (evidence: `web/viewer/src/components/ReviewDashboard.tsx`)
- Architecture map → Dependency flow view: renders dependency map (evidence: `web/viewer/src/components/ProjectTree.tsx`)
- Compare controls → Commit graph: renders commit selection (evidence: `web/viewer/src/components/RepositoryPanel.tsx`)
