melodic-software/solution-health

/dotnet:solution-health

Comprehensive solution health analysis covering structure, dependencies, versioning, and best practices.

Arguments

Parse arguments from $ARGUMENTS:

| Flag | Description | Default | |------|-------------|---------| | --solution <path> | Target solution (fuzzy matching) | Auto-detect | | --check <category> | Run specific check only | All checks | | --fix-suggestions | Include actionable fix commands | true |

Health Checks

| Check | Category | Description | |-------|----------|-------------| | Orphaned projects | structure | Projects in folder but not in .sln | | Missing references | dependencies | Referenced projects that don't exist | | Circular dependencies | dependencies | A -> B -> A cycles | | TFM inconsistencies | versioning | Mixed target frameworks | | Duplicate packages | packages | Same package, different versions | | Central package management | packages | Directory.Packages.props status | | Build props | config | Directory.Build.props presence | | EditorConfig | config | .editorconfig presence | | Git ignored artifacts | hygiene | bin/obj in git |

Workflow

Step 1: Locate Solution

Find and parse solution file:

# Find .sln files
find . -name "*.sln" -maxdepth 2

# Parse solution for project references
grep "Project(" *.sln

Step 2: Run Health Checks

Execute each check and collect findings.

Step 3: Generate Report

Output Format

Solution Health Report

Solution: MyApp.sln
Location: D:\repos\myapp
Projects: 12
Generated: 2026-01-18 11:00:00 UTC

═══════════════════════════════════════════════════════════════
                        HEALTH SCORE: 78/100
═══════════════════════════════════════════════════════════════

┌─────────────────────────────────────────────────────────────┐
│ Category         Status    Issues    Score                  │
├─────────────────────────────────────────────────────────────┤
│ Structure        Warning   1         15/20                  │
│ Dependencies     Pass      0         20/20                  │
│ Versioning       Warning   2         12/20                  │
│ Packages         Warning   3         16/20                  │
│ Configuration    Pass      0         15/20                  │
└─────────────────────────────────────────────────────────────┘

───────────────────────────────────────────────────────────────
STRUCTURE CHECKS
───────────────────────────────────────────────────────────────

[WARNING] Orphaned Projects Found

  Projects in filesystem but not in solution:
    - tools/CodeGen/CodeGen.csproj
    - experimental/Prototype/Prototype.csproj

  Fix: Add to solution or delete if unused
    dotnet sln add tools/CodeGen/CodeGen.csproj
    dotnet sln add experimental/Prototype/Prototype.csproj

[PASS] No Missing Project References

  All referenced projects exist and are resolvable.

[PASS] No Circular Dependencies

  Dependency graph is acyclic.

───────────────────────────────────────────────────────────────
VERSIONING CHECKS
───────────────────────────────────────────────────────────────

[WARNING] Inconsistent Target Frameworks

  Most projects: net10.0 (10 projects)
  Outliers:
    - src/Legacy/Legacy.csproj: net8.0
    - tests/Integration/Integration.csproj: net9.0

  Recommendation: Standardize TFMs across solution
  Run: /dotnet:update-dotnet-version --check-only

[WARNING] LangVersion Not Standardized

  Projects without explicit LangVersion: 4
  Projects with LangVersion: 8

  Recommendation: Set LangVersion in Directory.Build.props

[INFO] SDK Version

  global.json: 10.0.100 (rollForward: latestPatch)
  Installed: 10.0.100

───────────────────────────────────────────────────────────────
PACKAGE CHECKS
───────────────────────────────────────────────────────────────

[WARNING] Duplicate Package Versions

  Newtonsoft.Json:
    - 13.0.1 in src/MyApp.Core
    - 13.0.3 in src/MyApp.Api
    - 12.0.3 in src/Legacy

  Microsoft.Extensions.Logging:
    - 8.0.0 in 3 projects
    - 10.0.0 in 7 projects

  Fix: Consolidate versions or enable Central Package Management

[WARNING] Central Package Management Not Enabled

  You have 12 projects with package references.
  Central Package Management would consolidate version management.

  Enable:
    1. Create Directory.Packages.props
    2. Add <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
    3. Move versions from .csproj to Directory.Packages.props

[PASS] No Vulnerable Packages

  Run 'dotnet list package --vulnerable' returned no results.

───────────────────────────────────────────────────────────────
CONFIGURATION CHECKS
───────────────────────────────────────────────────────────────

[PASS] Directory.Build.props Found

  Location: D:\repos\myapp\Directory.Build.props
  Contents:
    - TreatWarningsAsErrors: true
    - Nullable: enable
    - ImplicitUsings: enable

[PASS] .editorconfig Found

  Location: D:\repos\myapp\.editorconfig
  Enforcing: 45 rules

[PASS] .gitignore Configured

  bin/ and obj/ are properly ignored.

───────────────────────────────────────────────────────────────
RECOMMENDATIONS
───────────────────────────────────────────────────────────────

Priority fixes to improve health score:

1. [EASY] Add orphaned projects to solution
   Impact: +5 points
   Command: dotnet sln add tools/CodeGen/CodeGen.csproj

2. [MEDIUM] Standardize target frameworks
   Impact: +8 points
   Command: /dotnet:update-dotnet-version

3. [MEDIUM] Enable Central Package Management
   Impact: +5 points
   Creates: Directory.Packages.props

4. [EASY] Consolidate Newtonsoft.Json versions
   Impact: +2 points
   Command: Update all to 13.0.3

───────────────────────────────────────────────────────────────
PROJECT DEPENDENCY GRAPH
───────────────────────────────────────────────────────────────

MyApp.Api
  └── MyApp.Core
  └── MyApp.Infrastructure
        └── MyApp.Core
        └── MyApp.Domain
  └── MyApp.Domain

MyApp.Tests
  └── MyApp.Api
  └── MyApp.Core

(No circular dependencies detected)

Check Details

Orphaned Projects

Projects found in filesystem but not referenced in .sln:

# Find all .csproj files
find . -name "*.csproj" -type f

# Compare against solution references
# Report difference

Circular Dependencies

Build dependency graph from ProjectReference elements:

<ProjectReference Include="..\Other\Other.csproj" />

Detect cycles using DFS traversal.

TFM Inconsistencies

Parse TargetFramework(s) from all projects:

grep -h "<TargetFramework" **/*.csproj

Report when projects use different TFMs without apparent reason.

Duplicate Package Versions

Parse PackageReference elements:

<PackageReference Include="Newtonsoft.Json" Version="13.0.1" />

Group by package, flag different versions.

Examples

# Full health check
/dotnet:solution-health

# Check specific category only
/dotnet:solution-health --check dependencies

# Check specific solution
/dotnet:solution-health --solution MyApp.sln

# Quick check without fix suggestions
/dotnet:solution-health --fix-suggestions false

Health Score Calculation

| Category | Max Points | Criteria | |----------|------------|----------| | Structure | 20 | No orphaned projects, no missing refs | | Dependencies | 20 | No circular deps, clean graph | | Versioning | 20 | Consistent TFMs, global.json present | | Packages | 20 | No duplicates, CPM enabled, no vulnerabilities | | Configuration | 20 | Build.props, editorconfig, gitignore |

Score Interpretation:

• 90-100: Excellent - Well-maintained solution
• 70-89: Good - Minor improvements recommended
• 50-69: Fair - Several issues to address
• Below 50: Needs attention - Significant technical debt