How orurh/patchcourt works
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: review Review workflow · engine.go Analysis engine · reviewbundle Review bundle · RepositoryPanel.tsx Compare controls
Components 27
Review entry
- PatchCourt CLI
core/go/internal/adapter/cli - Review workflow
core/go/internal/usecase/review - Git source
core/go/internal/source
Project analysis
- Analysis engine
core/go/internal/engine/engine.go - Project discovery
core/go/internal/analyzer/discovery - Project model
core/go/internal/analyzer/project/builder.go - Dependency graph
core/go/internal/analyzer/graph/layer_graph.go - Architecture rules
core/go/internal/analyzer/rules/engine.go - Runtime risk signals
core/go/internal/analyzer/lang/cpp/runtime
Patch impact
- Before/after models
core/go/internal/diff/project/compare.go - Dependency changes
core/go/internal/diff/dep/diff.go - Contract changes
core/go/internal/diff/contract - Finding changes
core/go/internal/diff/finding/diff.go - Review impact
core/go/internal/reviewrisk/risk.go
Review delivery
- Review bundle
core/go/internal/render/reviewbundle - LLM context pack
core/go/internal/render/llmpack/pack.go - SARIF export
core/go/internal/render/sarif/sarif.go - Local review API
core/go/internal/serve/bundle/server.go - Viewer app
web/viewer/src/App.tsx - Viewer API client
web/viewer/src/api.ts - Compare controls
web/viewer/src/components/RepositoryPanel.tsx - Review dashboard
web/viewer/src/components/ReviewDashboard.tsx - Architecture map
web/viewer/src/components/ProjectTree.tsx - Dependency flow view
web/viewer/src/components/ArchitectureFlow.tsx - Commit graph
web/viewer/src/components/git/CommitGraph.tsx
Other components
- Reviewer
- C++ repository
Connections 28
- Reviewer → PatchCourt CLI: runs review
README.md - C++ repository → Review workflow: supplies comparison
README.md - PatchCourt CLI → Review workflow: starts review
README.md - Review workflow → Git source: compares revisions
README.md - Review workflow → Analysis engine: requests analysis
README.md - Analysis engine → Project discovery: discovers project
core/go/internal/engine/engine.go - Analysis engine → Project model: builds model
core/go/internal/engine/engine.go - Analysis engine → Dependency graph: analyzes usage
core/go/internal/engine/engine.go - Analysis engine → Architecture rules: applies rules
core/go/internal/engine/engine.go - Analysis engine → Runtime risk signals: analyzes runtime risk
- Review workflow → Before/after models: compares models
README.md - Review workflow → Dependency changes: diffs dependencies
README.md - Review workflow → Contract changes: diffs contracts
README.md - Review workflow → Finding changes: diffs findings
README.md - Review workflow → Review impact: assesses impact
- Review workflow → Review bundle: writes bundle
README.md - Review bundle → LLM context pack: includes context pack
README.md - Review bundle → SARIF export: includes SARIF
README.md - Reviewer → Compare controls: selects revisions
README.md - Compare controls → Viewer API client: creates review
web/viewer/src/components/RepositoryPanel.tsx - Viewer app → Viewer API client: fetches review data
web/viewer/src/App.tsx - Viewer app → Compare controls: renders controls
web/viewer/src/App.tsx - Viewer app → Review dashboard: renders results
web/viewer/src/App.tsx - Viewer API client → Local review API: calls review API
README.md - Local review API → Review bundle: serves review data
README.md - Review dashboard → Architecture map: renders architecture tab
web/viewer/src/components/ReviewDashboard.tsx - Architecture map → Dependency flow view: renders dependency map
web/viewer/src/components/ProjectTree.tsx - Compare controls → Commit graph: renders commit selection
web/viewer/src/components/RepositoryPanel.tsx