ANcpLua.Analyzers 1.29.2

ANcpLua.Analyzers

Roslyn analyzers for modern C# patterns, AOT safety, ASP.NET Core, reliability, GenAI tool governance, and ANcpLua ecosystem conventions.

Installation

dotnet add package ANcpLua.Analyzers

Using ANcpLua.NET.Sdk? This package is auto-injected - no installation needed.

What you get

• 90 diagnostics spanning design, reliability, usage, Roslyn utilities, ASP.NET Core, AOT, threading, style, configuration, GenAI, and version management.
• 38 automatic code fixes for high-confidence transformations.
• CI-friendly enforcement through .editorconfig severity configuration.

Rule coverage by category

Full rule catalog

Legend: Error = build error, Warning = build warning, Info = IDE suggestion, Disabled = off by default.

Notable rules

AL0126 — CancellationToken propagation (Reliability, Info). Forwards an available cancellation token into async calls. The rule and its code fix cover two patterns:

• Calls that omit a CancellationToken overload argument when a suitable token is available in scope.
• Calls that explicitly pass a default/no-op token — default, default(CancellationToken), or CancellationToken.None — and should use the available real token instead.

Both paths use the same token-selection logic: nearest useful token expression first. In xUnit v3 tests, when no closer token is available, the fix can use global::Xunit.TestContext.Current.CancellationToken.

Code fixes

Automatic fixes are currently available for:

AL0002, AL0004, AL0005, AL0008, AL0011, AL0014, AL0015, AL0016, AL0025, AL0026, AL0027, AL0028, AL0029, AL0030, AL0031, AL0032, AL0033, AL0034, AL0035, AL0036, AL0037, AL0039, AL0040, AL0045, AL0046, AL0047, AL0048, AL0049, AL0050, AL0051, AL0103, AL0121, AL0122, AL0126, AL0137, AL0138, AL0139, AL0140

Configuration

[*.cs]
dotnet_diagnostic.AL0001.severity = error
dotnet_diagnostic.AL0014.severity = none

Development commands

# Build
dotnet build ANcpLua.Analyzers.slnx -c Release

# Test
dotnet test --project tests/ANcpLua.Analyzers.Tests/ANcpLua.Analyzers.Tests.csproj

# Pack
dotnet pack src/ANcpLua.Analyzers/ANcpLua.Analyzers.csproj -c Release -o artifacts -p:PackageId=ANcpLua.Analyzers

Documentation

• Overview: ancplua.mintlify.app/analyzers/overview
• Rule docs: ancplua.mintlify.app/analyzers/rules

Generated analyzer scenario docs

Per-analyzer scenario catalogs auto-generated from the test scenarios in src/ANcpLua.Analyzers.AnalyzerDocs/ — each file shows the before/after example and the analyzer's real diagnostic message (regression-gated by CI via scripts/generate-docs.ps1 -ValidateNoChanges):

• AL0028 — Use IsEqualTo extension

To regenerate after touching scenarios or a diagnostic message:

pwsh ./scripts/generate-docs.ps1

Related projects

• ANcpLua.NET.Sdk - MSBuild SDK (auto-injects this analyzer package)
• ANcpLua.Roslyn.Utilities - Shared Roslyn helpers and extensions
• ANcpLua.Agents - MAF runtime helpers + agent test infrastructure

License

MIT