Project Layout

jaunty/
│
├── Configuration Files
│   ├── .editorconfig                    # Editor configuration (formatting, naming)
│   ├── .gitattributes                   # Git line endings, merge strategies
│   ├── .gitignore                       # Git ignore patterns
│   ├── Directory.Build.props            # Settings shared by every project
│   ├── coverage.runsettings             # Coverage collector settings, applied by scripts/coverage.ps1
│   ├── docker-compose.yml               # SQL Server, PostgreSQL, MySQL, MariaDB for the integration suites
│   ├── docker-compose.bulkinsert.yml    # The same engines for the bulk-insert benchmark
│   └── Jaunty.slnx                      # Solution file (opens all projects)
│
├── Documentation Files
│   ├── README.md                        # Project overview and quick start
│   ├── CHANGELOG.md                     # Release notes
│   ├── LICENSE.md                       # ISL-R 1.2
│   ├── LICENSE-DISTRIBUTION-EXCEPTION.md  # Permission to ship the packages inside your application
│   ├── CLA.md                           # Contributor license agreement
│   ├── CONTRIBUTING.md                  # How to contribute
│   ├── CONTRIBUTORS.md
│   └── SECURITY.md                      # How to report a vulnerability, and what is in scope
│
├── Folders
│   ├── .github/                         # Workflows: ci.yml, nightly.yml, release.yml
│   │
│   ├── src/                             # Source code packages
│   ├── tests/                           # Test projects
│   ├── docs/                            # Documentation (Markdown source)
│   │   └── specs/                       # Specifications, NNN-slug/NNN-spec.md
│   ├── work/                            # The work underway (tasklist, status, todo); untracked
│   ├── audit/                           # The audit record; untracked
│   │
│   ├── benchmarks/                      # Performance benchmarks
│   ├── samples/                         # Sample projects
│   ├── scripts/                         # Build and utility scripts
│   ├── data/                            # Test databases and seed scripts
│   └── dist/                            # Distribution artifacts (generated)

src/
├── Jaunty/                        # Core micro-ORM (package Extrode.Jaunty)
│   ├── Attributes/                # [Table], [Column], [Key], [Ignore], [DatabaseGenerated], [EnumStorage]
│   ├── Configuration/             # JauntyConfig, BulkCopyConfiguration
│   ├── Core/                      # CommandOptions<T>, GridReader
│   ├── Diagnostics/               # AuditInterceptor, DiagnosticSource listener
│   ├── Dialects/                  # SQL Server, PostgreSQL, MySQL, SQLite; SqlIdentifierValidator
│   ├── Execute/                   # Execute (non-query) methods
│   ├── Import/                    # CSV import
│   ├── Interceptors/              # ICommandInterceptor, CommandContext, InterceptorPipeline
│   ├── Interfaces/                # IMapped<T>, IEntity<T>, generated-accessor contracts
│   ├── Multiple/                  # QueryMultiple
│   ├── Read/                      # Query* methods
│   ├── StoredProcedure/           # ExecuteStoredProcedure*, SpParameters
│   ├── Streaming/                 # QueryStream*, QueryPartialStream*
│   ├── TypeHandlers/              # Custom type handlers
│   ├── Write/                     # Insert, Update, Delete, Upsert, Bulk*
│   └── Internals/                 # Entity metadata, parameter parsing and binding, read and write cores
│
├── Jaunty.SourceGenerator/        # Roslyn generator, packed inside Extrode.Jaunty (not a package of its own)
├── Jaunty.Fluent/                 # Fluent query API
├── Jaunty.FlatFiles/              # Flat file support (interfaces)
├── Jaunty.FlatFiles.DuckDB/       # DuckDB implementation
├── Jaunty.Extensions.Reflection/  # Reflection-based mapping and native bulk copy providers
├── Jaunty.Extensions.Logging/     # ILogger + DI integration (keeps core dependency-free)
├── Jaunty.Extensions.Npgsql/      # PostgreSQL-specific parameter binding without boxing
├── Jaunty.Scaffolding/            # Database scaffolding
└── Jaunty.Scaffolding.Cli/        # dotnet tool; the NativeAOT publish target

tests/
├── Helpers/                       # Shared across projects
├── database-setup.sql             # SQL Server seed
├── postgres-setup.sql
├── mysql-setup.sql
├── mariadb-setup.sql
│
├── Jaunty.Tests/                  # Core integration suite, per engine
│   ├── Integration/               # Read/, Write/, Multiple/, Streaming/, StoredProcedure/, Dialects/ ...
│   ├── Unit/                      # Unit tests that need the core's internals
│   ├── Performance/
│   ├── Entities/                  # Test models
│   └── Helpers/                   # NorthwindDatabase, recording and throwing connections
│
├── Jaunty.UnitTests/              # Core unit tests, no database
├── Jaunty.SourceGenerator.Tests/  # Generator output and generated-mapper behaviour
├── Jaunty.Fluent.Tests/           # Fluent API tests
├── Jaunty.Fluent.ConfigTests/
├── Jaunty.Fluent.SourceGen.Tests/
├── Jaunty.FlatFiles.Tests/        # FlatFiles interface tests
├── Jaunty.FlatFiles.DuckDB.Tests/ # DuckDB implementation tests
├── Jaunty.Scaffolding.Tests/      # Scaffolding tests
└── Jaunty.Scaffolding.Cli.Tests/

docs/
├── 00-quick-start/                # Getting started
├── 01-api-reference/              # API documentation
├── 02-architecture/               # Architecture docs
├── 03-development/                # Development guides
├── 04-extensions/                 # Extension docs
├── 05-quality/                    # Quality, testing, audit record, benchmark reports
├── 06-releases/                   # Release runbook, order templates
├── 07-design/                     # Docs-site design source
├── 08-learn/                      # Tutorials, exercises, error messages, migration guides
├── 99-archive/                    # Historical documents
├── _assets/                       # Media assets (logos, charts, diagrams)
├── decisions/                     # Dated decision records
├── plans/                         # Dated implementation plans
├── specs/                         # Numbered feature specifications
├── lessons/                       # Lessons for AI assistants and for humans
├── constitution.md                # The binding rules for the codebase
└── conventions.md                 # Naming, git and cleanup conventions

# All tests
dotnet test Jaunty.slnx

# Specific test project
dotnet test tests/Jaunty.Tests

# With coverage
pwsh -NoProfile -File scripts/coverage.ps1