How codingbrushup2/performance-agent works
Performance Agent measures .NET benchmarks, compares baseline and candidate evidence against explicit budgets, and emits deterministic PASS, FAIL, or INCONCLUSIVE results. The CLI also supports run history, calibration, readiness and changed-code hints, reports, a local web UI, and optional advisory AI analysis. The benchmark host and core algorithms are represented from excerpts and the source index; unsampled subsystem internals and some CLI wiring are not inferred.
Main entry points: PerformanceAgent.Cli/Program.cs CLI commands · PerformanceAgent.BenchmarkHost/Program.cs Benchmark host · RegressionCheckService.cs Regression check · ProjectRunner.cs Project runner
Components 22
CLI workflows
- CLI commands
apps/cli/PerformanceAgent.Cli/Program.cs - Project runner
apps/cli/PerformanceAgent.Cli/ProjectRunner.cs - Changed-code hints
apps/cli/PerformanceAgent.Cli/GitDiffCandidateService.cs - Experiment readiness
apps/cli/PerformanceAgent.Cli/ExperimentReadinessService.cs - Workspace state
apps/cli/PerformanceAgent.Cli/WorkspaceStorage.cs
Benchmark measurement
- Benchmark host
apps/benchmark-host/PerformanceAgent.BenchmarkHost/Program.cs - BenchmarkDotNet runner
src/PerformanceAgent.BenchmarkDotNet/BenchmarkDotNetRunner.cs - Benchmark validity
src/PerformanceAgent.BenchmarkDotNet/BenchmarkDotNetValidator.cs
Evidence and verdicts
- Benchmark evidence
src/PerformanceAgent.Core/Evidence/BenchmarkEvidence.cs - Evidence JSON
src/PerformanceAgent.Core/Evidence/JsonBenchmarkEvidenceReader.cs - Regression check
apps/cli/PerformanceAgent.Cli/RegressionCheckService.cs - Budget comparison
src/PerformanceAgent.Core/Budgets/PerformanceBudgetChecker.cs - Confidence evaluation
src/PerformanceAgent.Core/Quality/MeanDecisionQualityEvaluator.cs - Verdict
src/PerformanceAgent.Core/Verdicts/PerformanceVerdict.cs
History and baselines
- Run archive
src/PerformanceAgent.Core/History/FileRunArchive.cs - Baseline selection
src/PerformanceAgent.Core/History/FileBaselineStore.cs - Calibration
src/PerformanceAgent.Core/Calibration/CalibrationAnalyzer.cs
Reports and insights
- Report writers
src/PerformanceAgent.Core/Reporting - Local web UI
apps/cli/PerformanceAgent.Cli/LocalWebUi.cs - Advisory analysis
src/PerformanceAgent.Core/Analysis/PerformanceAnalysisService.cs - OpenAI provider
src/PerformanceAgent.AI/OpenAIPerformanceAnalysisProvider.cs
Other components
- Developer / CI
Connections 23
- Developer / CI → CLI commands: runs commands
README.md - CLI commands → Project runner: starts benchmark
apps/cli/PerformanceAgent.Cli/Program.cs - Project runner → Benchmark host: launches process
README.md - Benchmark host → BenchmarkDotNet runner: runs benchmarks
apps/benchmark-host/PerformanceAgent.BenchmarkHost/Program.cs - Benchmark host → Benchmark validity: validates benchmarks
apps/benchmark-host/PerformanceAgent.BenchmarkHost/Program.cs - BenchmarkDotNet runner → Benchmark evidence: produces measurements
apps/benchmark-host/PerformanceAgent.BenchmarkHost/Program.cs - Benchmark host → Evidence JSON: writes evidence
apps/benchmark-host/PerformanceAgent.BenchmarkHost/Program.cs - CLI commands → Evidence JSON: reads evidence
apps/cli/PerformanceAgent.Cli/Program.cs - CLI commands → Regression check: checks regression
apps/cli/PerformanceAgent.Cli/Program.cs - Regression check → Budget comparison: checks budgets
apps/cli/PerformanceAgent.Cli/RegressionCheckService.cs - Regression check → Confidence evaluation: evaluates confidence
apps/cli/PerformanceAgent.Cli/RegressionCheckService.cs - Regression check → Verdict: assigns verdict
apps/cli/PerformanceAgent.Cli/RegressionCheckService.cs - CLI commands → Run archive: archives runs
apps/cli/PerformanceAgent.Cli/Program.cs - CLI commands → Baseline selection: selects baseline
apps/cli/PerformanceAgent.Cli/Program.cs - CLI commands → Calibration: calibrates runs
README.md - CLI commands → Changed-code hints: finds changed members
apps/cli/PerformanceAgent.Cli/Program.cs - CLI commands → Experiment readiness: checks readiness
apps/cli/PerformanceAgent.Cli/Program.cs - CLI commands → Report writers: generates reports
README.md - CLI commands → Local web UI: serves local UI
README.md - CLI commands → Workspace state: resolves state
apps/cli/PerformanceAgent.Cli/WorkspaceStorage.cs - CLI commands → Advisory analysis: requests analysis
- Advisory analysis → OpenAI provider: delegates analysis
src/PerformanceAgent.Core/Analysis/PerformanceAnalysisService.cs - OpenAI provider → Benchmark evidence: explains evidence
README.md