https://github.com/georgepwall1991/automapper-analyser
A Roslyn Analyzer for AutoMapper that detects mapping configuration errors and missing maps at compile-time, preventing runtime exceptions.
https://github.com/georgepwall1991/automapper-analyser
automapper code-analysis code-quality compile-time csharp developer-tools dotnet mapping nuget roslyn roslyn-analyzer static-analysis
Last synced: 19 days ago
JSON representation
A Roslyn Analyzer for AutoMapper that detects mapping configuration errors and missing maps at compile-time, preventing runtime exceptions.
- Host: GitHub
- URL: https://github.com/georgepwall1991/automapper-analyser
- Owner: georgepwall1991
- License: mit
- Created: 2025-06-05T09:00:56.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-06-02T16:04:33.000Z (24 days ago)
- Last Synced: 2026-06-02T16:10:19.730Z (24 days ago)
- Topics: automapper, code-analysis, code-quality, compile-time, csharp, developer-tools, dotnet, mapping, nuget, roslyn, roslyn-analyzer, static-analysis
- Language: C#
- Homepage: https://github.com/georgepwall1991/automapper-analyser
- Size: 18.4 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎯 AutoMapper Roslyn Analyzer
[](https://www.nuget.org/packages/AutoMapperAnalyzer.Analyzers/)
[](https://www.nuget.org/packages/AutoMapperAnalyzer.Analyzers/)
[](https://github.com/georgepwall1991/automapper-analyser/actions)
[](https://github.com/georgepwall1991/automapper-analyser/actions)
[](https://dotnet.microsoft.com/)
[](LICENSE)
[](https://codecov.io/gh/georgepwall1991/automapper-analyser)
> **✨ Catch AutoMapper configuration errors before they cause runtime chaos**
> *A sophisticated Roslyn analyzer that transforms AutoMapper development from reactive debugging to proactive
prevention*
---
## 🎉 Latest Release: v2.30.51
**AM011 nested per-property code-fix submenu**
✅ **Highlights**
- When 2+ required destination properties are unmapped on one `CreateMap`, AM011 now collapses the per-property scaffold/ignore actions under a single **"Fix individual required property…"** submenu (each property grouped under its own entry), shown next to the aggregate **"Map all / Ignore all"** actions — so the lightbulb shows three top-level entries instead of two per property.
- The single-unmapped-property case is unchanged — it stays a flat scaffold + ignore choice.
🧪 **Validation**
- Full solution test validation passed on `net10.0`.
- AnalyzerVerifier `--check-catalog --check-snapshots` green.
- Analyzer and test projects build clean under `-warnaserror` (the release gate; the samples project intentionally carries diagnostics).
### Recent Releases
- **v2.30.51**: AM011 nested "Fix individual required property…" submenu — keeps the lightbulb short when many required members are unmapped.
- **v2.30.50**: AM011 aggregate "Map all / Ignore all" code-fix actions — fix every unmapped required property of a `CreateMap` in a single action.
- **v2.30.49**: AM021 dictionary key/value decomposition (removes a false positive, adds `ToDictionary`/element-`CreateMap` fixes) and AM002 collection element nullability detection.
- **v2.30.48**: AM021 simple element-conversion fixes now cover destination `ImmutableArray` collections with fully qualified `ImmutableArray.CreateRange(...)` mappings.
- **v2.30.47**: AM003 now covers `ImmutableArray` container mismatches and offers `ImmutableArray.CreateRange(...)` for destination immutable arrays.
- **v2.30.46**: AM050 now covers redundant top-level `ForPath` `MapFrom` mappings and removes them with the same safe single-call rewrite guard as `ForMember`.
- **v2.30.45**: AM031 tracks `SequenceEqual` as a terminal enumeration, counts both sequence inputs, and keys static LINQ terminals to their source sequence arguments.
- **v2.30.44**: AM031 multiple-enumeration tracking now covers `Contains`, `ElementAt`, `ElementAtOrDefault`, and common linear collection instance `Contains` calls.
- **v2.30.43**: AM031 reports `GetAwaiter().GetResult()` sync-over-async mapping expressions across `Task`, configured `Task`, `ValueTask`, and configured `ValueTask` awaiters.
- **v2.30.42**: AM020 now respects compiler-known implicit nested conversions, while explicit-only nested conversions still report.
- **v2.30.41**: AM021 now respects compiler-known implicit element conversions, including value-object collection elements, while explicit-only element conversions still report.
- **v2.30.40**: AM001 now respects compiler-known implicit conversions, including user-defined value-object conversions, while explicit-only conversions still report.
- **v2.30.39**: Refreshed CI, release, and CodeQL workflow action pins to current major versions with Node.js 24-compatible releases.
- **v2.30.38**: AM031 complex LINQ `SelectMany` diagnostics now require real `System.Linq.Enumerable`/`Queryable` calls, so user-defined namesakes with nested selector logic stay quiet.
- **v2.30.37**: AM001 uses the exact C# implicit numeric conversion table, reports `double`/`float` to `decimal` mappings, and preserves valid widenings such as `char` to `int`.
- **v2.30.36**: AM002 preserves constructed generic type labels in nullable diagnostics and uses `default!` for generic/reference fallback defaults in generated fixes.
- **v2.30.35**: Split AM030's mixed converter diagnostics into AM030 invalid implementation, AM032 null handling, and AM033 unused converter rules with independent docs, severities, and trust metadata.
- **v2.30.34**: Calibrated AM021's analyzer-health Tests score to 5, aligning it with AM022 based on comparable analyzer coverage and stronger AM021 code-fix method count.
- **v2.30.33**: AM003 detects immutable/frozen destination container mismatches and offers fully qualified factory fixes for `ImmutableList`, `ImmutableHashSet`, and `FrozenSet`.
- **v2.30.32**: AM004/AM006 diagnostics now point at the offending source/destination property identifiers while preserving code-fix routing through mapping invocation metadata.
- **v2.30.31**: Correctness/code-fix hardening from an adversarial audit — AM001 signed/unsigned numeric mismatches, keyword-name escaping, AM020 qualified/generic nested `CreateMap` names, AM003 implicit-conversion-gated element casts, AM031 `ValueTask.Result`.
- **v2.30.30**: Added AM021 simple-conversion fixes for `ImmutableList`, `ImmutableHashSet`, and `FrozenSet` while keeping custom immutable-lookalikes manual-only.
- **v2.30.29**: Hardened AM003 custom collection fixer safety while preserving safe BCL collection constructor rewrites.
- **v2.30.28**: Tightened AM031 and AM001 fixer action selection so automatic rewrites stay executable and behavior-preserving.
- **v2.30.27**: Added a direct AM041 test locking the `ForPath` chained-configuration withhold behavior alongside the existing `ForMember`/parenthesized/`ReverseMap()`-chained coverage.
- **v2.30.26**: Locked AM050 sibling-config withhold behavior with direct `PreCondition`/`UseDestinationValue`/`Ignore` regression tests alongside the existing `Condition`/`NullSubstitute` cases.
- **v2.30.25**: Corrected six AM002/AM011/AM020/AM021/AM022/AM030 rule-docs category lines to match the shipped descriptor categories and added a category drift guard that prevents future doc/descriptor drift.
- **v2.30.24**: Marked unwired AM003/AM030 `DiagnosticDescriptor` relics `[Obsolete]` (binary compatibility preserved) and added a trust drift guard that fails when any shipped analyzer declares a `DiagnosticDescriptor` field outside its `SupportedDiagnostics` without an explicit Obsolete attribute.
- **v2.30.23**: AM050 code fix is withheld when the redundant-`MapFrom` `ForMember` lambda contains sibling configuration (`Condition`, `NullSubstitute`, …) that would otherwise be dropped.
- **v2.30.22**: AM031 normalises chained pre-terminal LINQ receivers so multiple enumerations of the same source-rooted collection report.
- **v2.30.21**: AM050 redundant-`MapFrom` detection now also fires on parenthesized and typed lambdas such as `o.MapFrom((Source s) => s.Name)`.
- **v2.30.20**: AM030 recognises `ArgumentNullException.ThrowIfNull`, `ArgumentException.ThrowIfNullOrEmpty`, and `ArgumentException.ThrowIfNullOrWhiteSpace` as null guards on the converter's source parameter.
- **v2.30.19**: AM030 stops reporting concrete converters as unused when a matching `ITypeConverter` is passed to `ConvertUsing` through DI/service-locator shapes.
- **v2.30.18**: AM031 multiple-enumeration tracking covers `Min`, `Max`, `Aggregate`, `LongCount`, `Single`, `SingleOrDefault`, `ToHashSet`, `ToDictionary`, and `ToLookup`, with a `System.Linq.Enumerable`/`Queryable` namesake gate.
- **v2.30.17**: AM041 withholds the duplicate-removal fix when the duplicate `CreateMap<>()` carries chained mapping policy.
- **v2.30.16**: Analyzer precision hardening across AM002, AM006, AM021, AM031, and AM041.
- **v2.30.15**: Fixer UX trust hardening with descriptor-specific no-fix metadata and executable interface collection rewrites.
- **v2.30.14**: AM021 reverse-map collection element diagnostics catch missing reverse element maps without duplicate noise.
- **v2.30.13**: AM041 duplicate-map labels now preserve generic type arguments and array ranks.
- **v2.30.12**: AM030 interface-typed converter usage and AM021 dictionary fixer safety.
- **v2.30.11**: AM001 enum/string conversion fixes for direct property mismatch remediation.
- **v2.30.10**: AM050 proven redundant `MapFrom` cleanup for string-based members and type-safe suppressions.
- **v2.30.9**: AM004/AM005 severity documentation trust with descriptor-aligned rule docs.
- **v2.30.8**: AM030 null-guard fixer precision without invasive `using System` edits.
- **v2.30.7**: AM022 recursion boundary precision for nested-map chains and explicit recursion controls.
- **v2.30.6**: AM031 source collection cache precision with nested source paths and Task-property `.Result` coverage.
- **v2.30.5**: AM030 type-based converter usage precision for `ConvertUsing(typeof(...))`.
- **v2.30.4**: AM022 mapped recursion precision with unrelated-cycle false-positive reductions.
- **v2.30.3**: AM011 ForPath required-member boundary with explicit configuration coverage.
- **v2.30.2**: AM003 assignable collection boundary suppression with targeted regression coverage.
- **v2.30.1**: AM002 nullability contract alignment with descriptor-accurate docs and nullable-context regression coverage.
- **v2.30.0**: Fixer hardening for AM001, AM005, AM006, AM011, and AM021 with safer action selection.
- **v2.29.0**: Smart primary fix and reduced fixer noise across the main data-integrity fixers.
- **v2.28.2**: False-positive reduction, fixer UX improvements, and release workflow hardening.
- **v2.28.1**: Case-aware AM021 suppression and fixer reliability improvements.
- **v2.28.0**: Analyzer logic fixes and performance improvements.
- **v2.27.0**: AM050 nullable safety fix and broad regression coverage expansion.
- **v2.25.0**: Code-fix consolidation and sample verification.
---
## 🌟 Why This Matters
AutoMapper is powerful, but silent failures are its Achilles' heel. Properties that don't map, type mismatches that
throw at runtime, nullable violations that cause NullReferenceExceptions—these issues typically surface in production,
not during development.
**This analyzer changes that equation entirely.**
```csharp
// Before: 😰 Runtime surprise!
public void MapUserData()
{
var user = mapper.Map(userEntity);
// 💥 NullReferenceException in production
// 💥 Data loss from unmapped properties
// 💥 Type conversion failures
}
// After: 🛡️ Compile-time confidence!
public void MapUserData()
{
var user = mapper.Map(userEntity);
// ✅ All mapping issues caught at compile-time
// ✅ Code fixes suggest proper solutions
// ✅ Ship with confidence
}
```
---
## ⚡ Quick Start
```bash
# Install via .NET CLI
dotnet add package AutoMapperAnalyzer.Analyzers
# Or via Package Manager Console
Install-Package AutoMapperAnalyzer.Analyzers
```
That's it! The analyzer automatically activates and starts checking your AutoMapper configurations. Open any file with
AutoMapper mappings and see diagnostics appear instantly.
**See it work:**
```csharp
var config = new MapperConfiguration(cfg =>
{
cfg.CreateMap();
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ AM001: Property 'Age' type mismatch
// 💡 Press Ctrl+. for code fix suggestions
});
```
---
## 🚀 What You Get
### 🛡️ **Complete Type Safety**
- **AM001**: Property type mismatches with smart conversion suggestions
- **AM002**: Nullable-to-non-nullable mapping with null safety patterns
- **AM003**: Collection type incompatibility detection
### 🔍 **Zero Data Loss**
- **AM004**: Missing destination properties (prevent silent data loss)
- **AM006**: Unmapped destination properties (detect unintentional defaults)
- **AM011**: Required property validation (avoid runtime exceptions)
- **AM005**: Case sensitivity issues (cross-platform reliability)
### 🧩 **Complex Mapping Intelligence**
- **AM020**: Nested object mapping validation with CreateMap suggestions (supports internal properties & cross-profile
detection)
- **AM021**: Collection element type analysis with conversion strategies
- **AM022**: Circular reference detection with MaxDepth recommendations
- **AM030/AM032/AM033**: Custom type converter implementation, null safety, and usage validation
### ⚡ **Instant Code Fixes**
Every analyzer comes with **intelligent code fixes** that don't just identify problems—they solve them:
```csharp
// Problem detected ⚠️
cfg.CreateMap();
// ~~~~~~~~~~~~~~~~~~~~~~~~~ AM001: Property 'Age' type mismatch
// Code fix applied ✨
cfg.CreateMap()
.ForMember(dest => dest.Age, opt => opt.MapFrom(src =>
int.TryParse(src.Age, out var age) ? age : 0));
```
---
## 🎯 Real-World Impact
| | Before | After |
|----|----------------------------------------|----------------------------------|
| 🐛 | Runtime mapping failures | ✅ Compile-time validation |
| 🔍 | Manual debugging sessions | ✅ Instant error highlights |
| 📝 | Guessing correct configurations | ✅ Code fixes with best practices |
| ⚠️ | Production NullReferenceExceptions | ✅ Null safety enforcement |
| 📊 | Silent data loss | ✅ Missing property detection |
| 🌐 | Cross-platform mapping inconsistencies | ✅ Case sensitivity validation |
---
## 📦 Installation
### .NET CLI (Recommended)
```bash
dotnet add package AutoMapperAnalyzer.Analyzers
```
### Package Manager Console
```powershell
Install-Package AutoMapperAnalyzer.Analyzers
```
### Project File (For CI/CD)
```xml
all
runtime; build; native; contentfiles; analyzers
```
### ⚡ Universal Compatibility
| Platform | Version | Support | AutoMapper | CI/CD Status |
|----------------|---------|-------------|------------|--------------|
| .NET Framework | 4.8+ | 🟢 **Full** | 10.1.1+ | ✅ **Tested** |
| .NET | 6.0+ | 🟢 **Full** | 12.0.1+ | ✅ **Tested** |
| .NET | 8.0+ | 🟢 **Full** | 14.0.0+ | ✅ **Tested** |
| .NET | 9.0+ | 🟢 **Full** | 14.0.0+ | ✅ **Tested** |
| .NET | 10.0+ | 🟢 **Full** | 14.0.0+ | ✅ **Tested** |
*Analyzer targets .NET Standard 2.0 for maximum compatibility*
*All platforms validated in automated CI/CD pipeline*
---
## 🎨 See It In Action
### ❌ **The Problems**
```csharp
public class UserEntity
{
public int Id { get; set; }
public string? FirstName { get; set; } // Nullable
public string LastName { get; set; }
public string Email { get; set; }
public DateTime CreatedAt { get; set; }
public List Tags { get; set; } // Collection type
public Address HomeAddress { get; set; } // Complex object
}
public class UserDto
{
public int Id { get; set; }
public string FirstName { get; set; } // Non-nullable!
public string FullName { get; set; } // Different property!
public string Age { get; set; } // Different type!
public HashSet Tags { get; set; } // Incompatible collection!
public AddressDto HomeAddress { get; set; } // Needs explicit mapping!
}
// This configuration has MULTIPLE issues:
cfg.CreateMap();
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// 🚨 AM002: FirstName nullable→non-nullable (NullReferenceException risk)
// 🚨 AM004: LastName will not be mapped (data loss)
// 🚨 AM001: Age expects int but gets DateTime (runtime exception)
// 🚨 AM021: Tags List→HashSet incompatible (mapping failure)
// 🚨 AM020: HomeAddress→AddressDto needs CreateMap (runtime exception)
```
### ✅ **The Solutions** (Auto-Generated!)
```csharp
// Code fixes automatically suggest:
cfg.CreateMap()
.ForMember(dest => dest.FirstName, opt => opt.MapFrom(src => src.FirstName ?? ""))
.ForMember(dest => dest.FullName, opt => opt.MapFrom(src => $"{src.FirstName} {src.LastName}"))
.ForMember(dest => dest.Age, opt => opt.MapFrom(src =>
DateTime.Now.Year - src.CreatedAt.Year))
.ForMember(dest => dest.Tags, opt => opt.MapFrom(src =>
src.Tags.Select((tag, index) => index).ToHashSet()));
// Separate mapping for complex types
cfg.CreateMap
();
```
---
## ⚙️ Fine-Tuned Control
### Severity Configuration (.editorconfig)
```ini
# Treat type safety as build errors
dotnet_diagnostic.AM001.severity = error
dotnet_diagnostic.AM002.severity = error
dotnet_diagnostic.AM011.severity = error
# Data loss warnings
dotnet_diagnostic.AM004.severity = warning
dotnet_diagnostic.AM005.severity = warning
# Suggestions for optimization
dotnet_diagnostic.AM020.severity = suggestion
dotnet_diagnostic.AM021.severity = suggestion
```
### Selective Suppression
```csharp
// Suppress with clear justification
#pragma warning disable AM001 // Custom IValueConverter handles string→int
cfg.CreateMap();
#pragma warning restore AM001
// Method-level suppression
[SuppressMessage("AutoMapper", "AM004:Missing destination property",
Justification = "PII data intentionally excluded for GDPR compliance")]
public void ConfigureSafeUserMapping() { }
```
---
## 📊 Complete Analyzer Coverage
| Rule | Description | Analyzer | Code Fix | Severity |
|-------------------------|--------------------------------|----------|----------|----------|
| **🔒 Type Safety** | | | |
| AM001 | Property Type Mismatch | ✅ | ✅ | Error |
| AM002 | Nullable→Non-nullable | ✅ | ✅ | Error / Info |
| AM003 | Collection Incompatibility | ✅ | ✅ | Error |
| **📊 Data Integrity** | | | |
| AM004 | Missing Destination Property | ✅ | ✅ | Warning |
| AM005 | Case Sensitivity Issues | ✅ | ✅ | Warning |
| AM006 | Unmapped Destination Property | ✅ | ✅ | Info |
| AM011 | Required Property Missing | ✅ | ✅ | Error |
| **🧩 Complex Mappings** | | | |
| AM020 | Nested Object Issues | ✅ | ✅ | Warning |
| AM021 | Collection Element Mismatch | ✅ | ✅ | Warning |
| AM022 | Circular Reference Risk | ✅ | ✅ | Warning |
| AM030 | Invalid Type Converter Implementation | ✅ | — | Error |
| AM032 | Type Converter Null Handling | ✅ | ✅ | Warning |
| AM033 | Unused Type Converter | ✅ | — | Info |
| **⚡ Performance** | | | |
| AM031 | Performance Warnings | ✅ | ✅ | Warning / Info |
| **⚙️ Configuration** | | | |
| AM041 | Duplicate Mapping Registration | ✅ | ✅ | Warning |
| AM050 | Redundant MapFrom | ✅ | ✅ | Info |
| **🚀 Future** | | | |
| AM034+ | Advanced Null Propagation | 🔮 | 🔮 | - |
| AM040+ | Configuration Rules | 🔮 | 🔮 | - |
| AM050+ | Advanced Optimizations | 🔮 | 🔮 | - |
---
## 🛠️ Development Experience
### IDE Integration
- **Visual Studio**: Full IntelliSense integration with lightbulb code fixes
- **VS Code**: Rich diagnostic experience via OmniSharp
- **JetBrains Rider**: Native analyzer support with quick-fix suggestions
- **Command Line**: Works seamlessly with `dotnet build`
### Testing Your Configuration
```bash
# Quick validation
dotnet build # Analyzer runs automatically
# Comprehensive testing
git clone https://github.com/georgepwall1991/automapper-analyser.git
cd automapper-analyser
dotnet run --project samples/AutoMapperAnalyzer.Samples
# See all analyzer warnings in action
dotnet build samples/ --verbosity normal
# Run full test suite with coverage
dotnet test --collect:"XPlat Code Coverage" --settings coverlet.runsettings
```
### CI/CD & Quality Assurance
- **🔄 Automated Testing**: Every commit tested across multiple .NET versions
- **📊 Code Coverage**: Integrated with Codecov for comprehensive coverage tracking
- **🛡️ Quality Gates**: Build fails only on genuine errors, warnings are preserved
- **⚡ Cross-Platform**: Validated on Ubuntu (CI) and Windows (compatibility tests)
- **📈 Performance**: Incremental builds with analyzer caching for optimal speed
---
## 🏗️ Architecture Highlights
This isn't just another analyzer—it's built for **enterprise-grade reliability**:
- **🏎️ Performance-First**: Incremental analysis with minimal IDE impact
- **🔧 Extensible Design**: Clean plugin architecture for new rules
- **🧪 Battle-Tested**: release validation includes full suite coverage plus targeted regression tests for high-risk fixers
- **🌐 Cross-Platform**: Identical behavior on Windows, macOS, Linux
- **⚡ CI/CD Ready**: Automated GitHub Actions with codecov integration
- **📊 Code Coverage**: 55%+ coverage with comprehensive testing
---
## 🎯 What's Next
### Recently Completed ✅
- **v2.30.15**: Fixer UX trust hardening with descriptor-specific no-fix metadata and executable interface collection rewrites
- **v2.30.14**: AM021 reverse-map collection element diagnostics catch missing reverse element maps without duplicate noise
- **v2.30.13**: AM041 duplicate-map labels preserve generic type arguments and array ranks
- **v2.30.12**: AM030 interface-typed converter usage and AM021 dictionary fixer safety
- **v2.30.11**: AM001 enum/string conversion fixes for direct property mismatch remediation
- **v2.30.10**: AM050 proven redundant `MapFrom` cleanup for string-based members and type-safe suppressions
- **v2.30.9**: AM004/AM005 severity documentation trust with descriptor-aligned rule docs
- **v2.30.8**: AM030 null-guard fixer precision without invasive `using System` edits
- **v2.30.7**: AM022 recursion boundary precision for nested-map chains and explicit recursion controls
- **v2.30.6**: AM031 source collection cache precision with nested source paths and Task-property `.Result` coverage
- **v2.30.5**: AM030 type-based converter usage precision for `ConvertUsing(typeof(...))`
- **v2.30.4**: AM022 mapped recursion precision with unrelated-cycle false-positive reductions
- **v2.30.3**: AM011 ForPath required-member boundary with explicit-configuration regression coverage
- **v2.30.2**: AM003 assignable collection boundary suppression with targeted regression coverage
- **v2.30.1**: AM002 nullability contract alignment with descriptor-accurate docs and nullable-context regression coverage
- **v2.30.0**: Fixer hardening for AM001, AM005, AM006, AM011, and AM021 with safer action selection
- **v2.29.0**: Smart Primary Fix — reduced fixer noise to max 2 lightbulb options per diagnostic
- **v2.28.2**: False-positive reduction, fixer UX improvements, and release workflow hardening
- **v2.28.1**: Case-aware AM021 suppression and fixer accuracy improvements
- **v2.28.0**: Analyzer logic fixes and performance improvements
- **v2.27.0**: AM050 nullable safety fix and expanded regression coverage
### Phase 5B: Enhanced Analysis (Upcoming)
- **AM034**: Advanced null propagation patterns with smart fixes
### Phase 6: Configuration & Profile Analysis
- **AM040**: Profile registration analysis and auto-registration fixes
### Beyond Code Analysis
- **NuGet Package Templates**: Project templates with pre-configured analyzers
- **MSBuild Integration**: Custom build targets for mapping validation
- **Documentation Generation**: Auto-generate mapping documentation
- **Metrics Dashboard**: Build-time analysis reporting
---
## 🤝 Contributing
We're building something special, and **your expertise makes it better**.
**Quick Start Contributing:**
```bash
git clone https://github.com/georgepwall1991/automapper-analyser.git
cd automapper-analyser
dotnet test
```
**What We Need:**
- 🧪 More edge-case scenarios
- 📝 Documentation improvements
- 🚀 Performance optimizations
- 💡 New analyzer rule ideas
See our [Contributing Guide](docs/CONTRIBUTING.md) for detailed guidelines.
---
## 📚 Deep Dive Resources
- 📖 [**Architecture Guide**](docs/ARCHITECTURE.md) - How it all works under the hood
- 🔍 [**Diagnostic Rules**](docs/DIAGNOSTIC_RULES.md) - Complete rule reference
- 🧭 [**Generated Rule Catalog**](docs/RULE_CATALOG.md) - Descriptor, fixer, sample, and trust-level source of truth
- 🧪 [**Sample Gallery**](samples/AutoMapperAnalyzer.Samples/README.md) - Real-world scenarios
- 🚀 [**CI/CD Pipeline**](docs/CI-CD.md) - Our build and deployment process
- 📊 [**Compatibility Matrix**](docs/COMPATIBILITY.md) - Framework support details
---
## 💬 Community & Support
**Get Help:**
- 🐛 [**Issues**](https://github.com/georgepwall1991/automapper-analyser/issues) - Bug reports and feature requests
- 💬 [**Discussions**](https://github.com/georgepwall1991/automapper-analyser/discussions) - Questions and ideas
- 📖 [**Wiki**](https://github.com/georgepwall1991/automapper-analyser/wiki) - Comprehensive documentation
## 📄 License
**MIT License** - Use it anywhere, contribute back if you can.
---
### ⭐ **Star this repo if it's saving you time!**
**Built with ❤️ by developers who've debugged too many AutoMapper issues**
[🚀 **Get Started Now**](#-installation) • [📖 **Read the Docs**](docs/) • [💬 **Join the Discussion
**](https://github.com/georgepwall1991/automapper-analyser/discussions)