SeamGuard.Tool 0.1.0.1

<p align="center"> <img src="assets/logo.svg" alt="SeamGuard logo" width="189"> </p>

SeamGuard

SeamGuard is a C# Roslyn analyzer for enforcing JSON-defined architectural boundaries during .NET builds.

SeamGuard runs as an installed analyzer or as a .NET tool that injects the analyzer for one build. Both modes use the same configuration format.

What SeamGuard checks

• Behavioral types declared by a project, filtered by kind and visibility.
• Direct type references and constructor dependencies.
• Direct project and NuGet package references.
• InternalsVisibleTo friend assemblies.
• Mock providers and mocked types in test code.
• Layered project and type rules with namespace and kind filters.

Quick start

dotnet add package SeamGuard.Analyzer

Create .seamguard/config.json beside the solution or in the project directory or one of its ancestors.

{
  "version": 1,
  "projects": {
    "General.Core": {
      "projectReferences": {
        "deny": ["General.Data"]
      },
      "rules": [
        {
          "target": "General.Core.Services.**",
          "constructorDependencies": {
            "allow": ["System.**", "General.Contracts.**"],
            "deny": ["General.Data.**"]
          }
        }
      ]
    }
  }
}

dotnet build reports forbidden crossings as SGA diagnostics.

The tool runs SeamGuard without adding an analyzer reference to the target repository.

dotnet tool install --global SeamGuard.Tool
dotnet seam build path\to\Project.sln --config path\to\.seamguard\config.json -- -c Release

Documentation

• Getting started
• Configuration
• Policy reference
• Command-line tool
• Diagnostics

Scope

SeamGuard evaluates structural facts available to Roslyn and MSBuild. The configuration supplies the architecture rules.