CodeMetrics.AI 1.1.0

CodeMetrics.AI

A .NET 10 global tool that performs deterministic static analysis on .NET solutions using the Roslyn compiler API. Produces VS-compatible code metrics and scored scorecard evidence across 9 quality dimensions.

Install

dotnet tool install -g CodeMetrics.AI

Usage

# Auto-discover solution in current directory
code-metrics

# Specify solution explicitly
code-metrics --solution MyApp.slnx

# Skip dependency probe (avoids dotnet list package calls)
code-metrics --skip-dependency-probe

# Custom output paths
code-metrics --output ./results/metrics.csv --scorecard-output ./results/evidence.json

Output

Dimensions

The tool scores your codebase across 9 quality dimensions (0-10 scale):

Raw Metrics

Per-type and per-member metrics collected via Roslyn:

• Cyclomatic Complexity — decision point counting
• Lines of Code — source lines (excluding comments/blanks/braces) and executable statements
• Maintainability Index — composite of CC, LOC, and Halstead Volume
• Class Coupling — distinct external type dependencies
• Depth of Inheritance — base type chain length

MSBuild Integration

Copy Directory.Build.targets from the scorecard-tooling directory to your solution root:

dotnet build /t:Scorecard
dotnet build /t:Scorecard /p:ScorecardConfiguration=Release

Options

Project Filtering

The tool automatically skips non-production projects:

• Test projects (name contains "Tests")
• Aspire hosts (AppHost, ServiceDefaults, Hosting)
• Benchmarks, Samples, Demo, Playground projects

Attribute Support

CodeMetrics.AI recognizes common .NET test framework attributes when scoring the Testing dimension.

Test projects are detected by project name or by methods decorated with one of these attributes:

• Fact
• Theory
• Test
• TestCase
• TestMethod
• DataTestMethod

Attributes may be written with the Attribute suffix or a namespace qualifier, such as [FactAttribute] or [Xunit.Fact].

Skipped or ignored tests are counted when a supported test attribute has a named Skip or Ignore argument:

[Fact(Skip = "temporarily disabled")]
public void Uses_xunit_skip() { }

[Test(Ignore = "temporarily disabled")]
public void Uses_nunit_ignore() { }

CodeMetrics.AI does not currently provide a custom attribute for excluding production types or members from code metrics. Production code in analyzed projects is included unless the project itself is skipped by the filtering rules above.

Requirements

• .NET 10 SDK
• Solution must be buildable (dotnet build succeeds)

License

MIT