RESTier vNext: Modernize to ASP.NET Core, OData 8.x, and .NET 8/9/10

.gitignore

@@ -329,3 +329,9 @@ ASALocalRun/
 # MFractors (Xamarin productivity tool) working folder 
 .mfractor/
 /docs/msdocs/.vscode
+/docs/msdocs/_site/
+
+# DotNetDocs SDK regenerates this on build
+src/Microsoft.Restier.Docs/api-reference/
+# DotNetDocs SDK writes this as a Debug-build debug dump (not config)
+src/Microsoft.Restier.Docs/assembly-list.txt

CLAUDE.md

@@ -0,0 +1,119 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Microsoft RESTier is an OData V4 API development framework for building standardized RESTful services on .NET. It is the spiritual successor to WCF Data Services, providing convention-based query interception and data manipulation over Entity Framework.
+
+## Build & Test Commands
+
+```bash
+# Build entire solution
+dotnet build RESTier.slnx
+
+# Run all tests
+dotnet test RESTier.slnx
+
+# Run a single test project
+dotnet test test/Microsoft.Restier.Tests.Core/Microsoft.Restier.Tests.Core.csproj
+
+# Run a specific test by name
+dotnet test --filter "FullyQualifiedName~TestMethodName"
+
+# Build a single project
+dotnet build src/Microsoft.Restier.Core/Microsoft.Restier.Core.csproj
+```
+
+## Architecture
+
+### Core Pipeline (Chain of Responsibility)
+
+RESTier's central pattern is a **chain of responsibility** pipeline for both queries and submissions. Services implement `IChainedService<TService>` with an `Inner` property, composed via `IChainOfResponsibilityFactory`.
+
+**Query pipeline** (`Microsoft.Restier.Core.Query`):
+`IQueryExpressionSourcer` -> `IQueryExpressionAuthorizer` -> `IQueryExpressionExpander` -> `IQueryExpressionProcessor` -> `IQueryExecutor`
+Orchestrated by `DefaultQueryHandler`.
+
+**Submit pipeline** (`Microsoft.Restier.Core.Submit`):
+`IChangeSetInitializer` -> `IChangeSetItemFilter` -> `IChangeSetItemAuthorizer` -> `IChangeSetItemValidator` -> `ISubmitExecutor`
+Orchestrated by `DefaultSubmitHandler`.
+
+### Convention-Based Interception
+
+RESTier discovers interceptor methods by naming convention on `ApiBase` subclasses:
+- `OnFiltering{EntitySet}()` / `OnInserting{Entity}()` / `OnValidating{Entity}()` etc.
+- Implemented via `ConventionBasedQueryExpressionProcessor`, `ConventionBasedChangeSetItemFilter`, `ConventionBasedChangeSetItemValidator`
+
+### Key Base Classes
+
+- `ApiBase` - Base class for all RESTier APIs; subclass to define your API surface
+- `EntityFrameworkApi<TContext>` - EF-specific base providing DbContext integration
+- `RestierController : ODataController` - Handles OData HTTP requests in ASP.NET Core
+
+### Project Layout
+
+| Directory | Purpose |
+|-----------|---------|
+| `src/Microsoft.Restier.Core` | Core abstractions, pipelines, conventions, DI |
+| `src/Microsoft.Restier.AspNetCore` | ASP.NET Core integration, routing, controller |
+| `src/Microsoft.Restier.EntityFramework` | Entity Framework 6.x support |
+| `src/Microsoft.Restier.EntityFrameworkCore` | Entity Framework Core support |
+| `src/Microsoft.Restier.EntityFramework.Shared` | Shared EF code (shared project, not NuGet) |
+| `src/Microsoft.Restier.Breakdance` | In-memory testing framework |
+| `src/Microsoft.Restier.AspNetCore.Swagger` | Swagger/OpenAPI generation |
+
+### Dependency Injection
+
+Uses `Microsoft.Extensions.DependencyInjection` with per-route service containers. Service registration extensions are in `Microsoft.Restier.Core.DependencyInjection` and `Microsoft.Restier.AspNetCore.Extensions`.
+
+## Code Conventions
+
+- **Targets:** .NET 8.0, .NET 9.0, and .NET Framework 4.8
+- **Warnings as errors** enabled globally
+- **Implicit usings disabled** - all `using` directives must be explicit
+- **Nullable reference types disabled**
+- **Strong name signing** with `restier.snk`
+- **Allman brace style**, prefer `var`, prefer curly braces even for single-line blocks
+- **InternalsVisibleTo** is auto-configured from source to matching test project
+
+## Test Conventions
+
+- **Framework:** xUnit v3, FluentAssertions (AwesomeAssertions), NSubstitute
+- **Project naming:** `X` -> `X.Tests` (e.g., `Microsoft.Restier.Core` -> `Microsoft.Restier.Tests.Core`)
+- **File naming:** `X/Y/Z/A.cs` -> `X.Tests/Y/Z/ATests.cs`
+- **Namespace:** must match folder path (e.g., `Microsoft.Restier.Tests.Core.Convention`)
+- **Integration/scenario tests** go in `X.Tests/IntegrationTests` or `X.Tests/ScenarioTests`
+
+## Documentation
+
+Documentation lives in `src/Microsoft.Restier.Docs/` and is built with the **DotNetDocs SDK** (`<Project Sdk="DotNetDocs.Sdk/1.2.0">`), which generates Mintlify-flavored MDX.
+
+```bash
+# Build the docs project (regenerates api-reference/ and docs.json)
+dotnet build src/Microsoft.Restier.Docs/Microsoft.Restier.Docs.docsproj
+```
+
+The docs project is part of `RESTier.slnx`, so a full solution build also builds the docs:
+
+```bash
+dotnet build RESTier.slnx
+```
+
+**Authoring conventions:**
+- Hand-written content lives under `guides/`, `release-notes/`, and the project root (`index.mdx`, `quickstart.mdx`, `contribution-guidelines.mdx`, `why-restier.mdx`).
+- API reference under `api-reference/` is auto-generated from XML doc comments (six assemblies at TFM `net9.0`) and gitignored — do NOT hand-edit it.
+- Pages use Mintlify components: `<Info>`, `<Note>`, `<Tip>`, `<Warning>`, `<Steps>`, `<CodeGroup>`, `<Tabs>`, `<CardGroup>`. See existing pages for examples.
+
+**Navigation source of truth:** the `<MintlifyTemplate>` block in `Microsoft.Restier.Docs.docsproj`. The SDK regenerates `docs.json` from this template on every build, so commit `docs.json` alongside any nav-affecting change but do not hand-edit it.
+
+**Build-ordering note:** the docsproj has an explicit `BuildSourceProjectsForDocs` target that calls `<MSBuild>` on each documented source project for `net8.0` before doc generation runs. The DotNetDocs SDK resolves assembly paths against `bin/Debug/net8.0/`, and `<ProjectReference>` items alone don't reliably trigger a full Build of the multi-targeted source projects from this NoTargets-style docsproj.
+
+`assembly-list.txt` under the docs project is a Debug-build debug dump written by the SDK (not configuration). It is gitignored.
+
+## Key Dependencies
+
+- Microsoft.OData.Core / Microsoft.OData.Edm (8.x)
+- Microsoft.OData.ModelBuilder (2.x)
+- Microsoft.AspNetCore.OData (9.x)
+- EntityFramework 6.5.x / EntityFrameworkCore 8.x-10.x

src/Directory.Build.props → Directory.Build.props

@@ -3,6 +3,7 @@
 	<PropertyGroup>
 		<IsBenchmarkProject Condition="$(MSBuildProjectName.EndsWith('.Performance'))">true</IsBenchmarkProject>
 		<IsTestProject Condition="$(MSBuildProjectName.ToLower().Contains('.tests.'))">true</IsTestProject>
+    <IsTestSharedProject Condition="$(MSBuildProjectName.ToLower().Contains('.tests.shared'))">true</IsTestSharedProject>
 		<IsTestAssetProject Condition="$(RepoRelativeProjectDir.ToLower().Contains('testassets'))">true</IsTestAssetProject>
 		<IsSampleProject Condition="$(MSBuildProjectName.ToLower().Contains('.samples.'))">true</IsSampleProject>
 		<IsTemplateProject Condition="$(MSBuildProjectName.ToLower().Contains('.templates.'))">true</IsTemplateProject>
@@ -81,19 +82,13 @@
 		<!-- Suppress warnings about pre-release packages -->
 		<NoWarn>$(NoWarn);NU5104</NoWarn>
 
-	</PropertyGroup>
+		<!-- Suppress .NET 10 package pruning warnings for multi-targeted packages that are in-box on net10.0 -->
+		<NoWarn>$(NoWarn);NU1510</NoWarn>
 
-	<!-- Base settings for all test projects -->
-	<PropertyGroup Condition=" $(IsTestProject) == 'true' ">
-		<NoWarn>$(NoWarn);CA1001;CA1031;CA1062;CA1301;CA1303;AC1307;CA1707;CA1716;CA1801;CA1806;CA1819;CA1822;CA1825;CA2000;CA2007;CA2227;CA2234</NoWarn>
-		<IsPackable>false</IsPackable>
 	</PropertyGroup>
 
-	<!-- Use VSTest for all test projects to support both net48 and modern .NET in the same test run.
-		 MSTest 4.x with EnableMSTestRunner=true would enable Microsoft.Testing.Platform,
-		 but that conflicts with net48 projects which cannot use MTP. -->
 	<PropertyGroup Condition=" $(IsTestProject) == 'true' ">
-		<EnableMSTestRunner>false</EnableMSTestRunner>
+		<NoWarn>$(NoWarn);CA1001;CA1031;CA1062;CA1301;CA1303;AC1307;CA1707;CA1716;CA1801;CA1806;CA1819;CA1822;CA1825;CA2000;CA2007;CA2227;CA2234</NoWarn>
 	</PropertyGroup>
 
 	<PropertyGroup Condition=" $(IsSampleProject) == 'true' ">
@@ -108,26 +103,44 @@
 
 	<PropertyGroup>
 		<StandardTestTfms>net48</StandardTestTfms>
+		<RestierBreakdanceVersion>[8.0.0, 9.0.0)</RestierBreakdanceVersion>
+		<RestierEasyAfVersion>[4.0.0, 5.0.0)</RestierEasyAfVersion>
+		<RestierNet9DependencyInjectionVersion>[9.*, 10.0.0)</RestierNet9DependencyInjectionVersion>
+		<RestierNet9EntityFrameworkVersion>[9.*, 10.0.0)</RestierNet9EntityFrameworkVersion>
+		<RestierNet9SystemTextJsonVersion>[9.*, 10.0.0)</RestierNet9SystemTextJsonVersion>
+		<RestierNet9UserSecretsVersion>[9.*, 10.0.0)</RestierNet9UserSecretsVersion>
+		<RestierNet9AspNetCoreTestHostVersion>[9.*, 10.0.0)</RestierNet9AspNetCoreTestHostVersion>
+		<RestierNet10DependencyInjectionVersion>[10.*, 11.0.0)</RestierNet10DependencyInjectionVersion>
+		<RestierNet10EntityFrameworkVersion>[10.*, 11.0.0)</RestierNet10EntityFrameworkVersion>
+		<RestierNet10SystemTextJsonVersion>[10.*, 11.0.0)</RestierNet10SystemTextJsonVersion>
+		<RestierNet10UserSecretsVersion>[10.*, 11.0.0)</RestierNet10UserSecretsVersion>
+		<RestierNet10AspNetCoreTestHostVersion>[10.*, 11.0.0)</RestierNet10AspNetCoreTestHostVersion>
 	</PropertyGroup>
 
+	<ItemGroup Condition="'$(TargetFramework)' == 'net9.0'">
+		<PackageReference Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="$(RestierNet9DependencyInjectionVersion)" PrivateAssets="All" />
+		<PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="$(RestierNet9UserSecretsVersion)" PrivateAssets="All" />
+		<PackageReference Include="Microsoft.Extensions.Configuration.Json" Version="$(RestierNet9UserSecretsVersion)" PrivateAssets="All" />
+		<PackageReference Include="Microsoft.Extensions.FileProviders.Abstractions" Version="$(RestierNet9UserSecretsVersion)" PrivateAssets="All" />
+		<PackageReference Include="Microsoft.Extensions.FileProviders.Physical" Version="$(RestierNet9UserSecretsVersion)" PrivateAssets="All" />
+		<PackageReference Include="System.Text.Json" Version="$(RestierNet9SystemTextJsonVersion)" PrivateAssets="All" />
+	</ItemGroup>
+
+
 	<ItemGroup Condition=" $(IsTestProject) != 'true' AND $(IsSampleProject) != 'true'">
 		<PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.*" PrivateAssets="All" />
+
 		<InternalsVisibleTo Include="$(AssemblyName.Replace('Microsoft.Restier.', 'Microsoft.Restier.Tests.')), $(StrongNamePublicKey)" />
 	</ItemGroup>
 
-	<ItemGroup Condition=" $(IsTestProject) == 'true' and $(IsSampleProject) != 'true'">
+	<ItemGroup Condition=" $(IsTestProject) == 'true' and $(IsSampleProject) != 'true' and $(IsTestSharedProject) != 'true'">
 		<PackageReference Include="coverlet.collector" Version="6.*" />
-		<PackageReference Include="FluentAssertions" Version="6.*" PrivateAssets="All" />
-		<PackageReference Include="FluentAssertions.Analyzers" Version="0.*" PrivateAssets="All" />
-		<PackageReference Include="MSTest" Version="4.*" />
-
-        <!-- Enable parallel test execution in MSTest 4 and later. -->
-        <AssemblyAttribute Include="Microsoft.VisualStudio.TestTools.UnitTesting.Parallelize">
-            <_Parameter1>Workers = 1</_Parameter1>
-            <_Parameter1_IsLiteral>true</_Parameter1_IsLiteral>
-            <_Parameter2>Scope = Microsoft.VisualStudio.TestTools.UnitTesting.ExecutionScope.MethodLevel</_Parameter2>
-            <_Parameter2_IsLiteral>true</_Parameter2_IsLiteral>
-        </AssemblyAttribute>
+		<PackageReference Include="AwesomeAssertions" Version="8.*" PrivateAssets="All" />
+		<PackageReference Include="AwesomeAssertions.Analyzers" Version="0.*" PrivateAssets="All" />
+		<PackageReference Include="xunit.v3" Version="3.*" />
+		<PackageReference Include="xunit.runner.visualstudio" Version="3.*" />
+		<PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.*" />
+		<PackageReference Include="NSubstitute" Version="5.3.0"></PackageReference>
 	</ItemGroup>
 
 	<ItemGroup>

RESTier.slnx

@@ -0,0 +1,52 @@
+<Solution>
+  <Folder Name="/Solution Items/">
+    <File Path="NuGet.Config" />
+    <File Path="README.md" />
+    <File Path=".editorconfig" />
+    <File Path="Directory.Build.props" />
+    <File Path="dotnet-logo.png" />
+  </Folder>
+  <Folder Name="/src/" Id="02ea681e-c7d8-13c7-8484-4ac65e1b71e8">
+    <Project Path="src/Microsoft.Restier.Breakdance/Microsoft.Restier.Breakdance.csproj" />
+    <Project Path="src/Microsoft.Restier.Core/Microsoft.Restier.Core.csproj" />
+    <Project Path="src/Microsoft.Restier.EntityFramework.Spatial/Microsoft.Restier.EntityFramework.Spatial.csproj" />
+    <Project Path="src/Microsoft.Restier.EntityFrameworkCore.Spatial/Microsoft.Restier.EntityFrameworkCore.Spatial.csproj" />
+  </Folder>
+  <Folder Name="/src/EntityFramework/" Id="a290b16b-6f9e-4703-8c01-135831ad90df">
+    <Project Path="src/Microsoft.Restier.EntityFramework.Shared/Microsoft.Restier.EntityFramework.Shared.shproj" Id="83ad7aa8-9ed8-4b9f-966a-73ce9cae51c6" />
+    <Project Path="src/Microsoft.Restier.EntityFramework/Microsoft.Restier.EntityFramework.csproj" />
+    <Project Path="src/Microsoft.Restier.EntityFrameworkCore/Microsoft.Restier.EntityFrameworkCore.csproj" />
+  </Folder>
+  <Folder Name="/src/Samples/">
+    <Project Path="src/Microsoft.Restier.Samples.Northwind.AspNetCore/Microsoft.Restier.Samples.Northwind.AspNetCore.csproj" />
+    <Project Path="src/Microsoft.Restier.Samples.NorthwindVersioned.AspNetCore/Microsoft.Restier.Samples.NorthwindVersioned.AspNetCore.csproj" />
+    <Project Path="src/Microsoft.Restier.Samples.Postgres.AspNetCore/Microsoft.Restier.Samples.Postgres.AspNetCore.csproj" />
+  </Folder>
+  <Folder Name="/src/Web/" Id="bf61c3f1-7c7e-4515-8b51-14b374a034f9">
+    <Project Path="src/Microsoft.Restier.AspNetCore.NSwag/Microsoft.Restier.AspNetCore.NSwag.csproj" />
+    <Project Path="src/Microsoft.Restier.AspNetCore.Swagger/Microsoft.Restier.AspNetCore.Swagger.csproj" />
+    <Project Path="src/Microsoft.Restier.AspNetCore.Versioning/Microsoft.Restier.AspNetCore.Versioning.csproj" />
+    <Project Path="src/Microsoft.Restier.AspNetCore/Microsoft.Restier.AspNetCore.csproj" />
+  </Folder>
+  <Folder Name="/docs/">
+    <Project Path="src/Microsoft.Restier.Docs/Microsoft.Restier.Docs.docsproj" Type="C#" />
+  </Folder>
+  <Folder Name="/test/" Id="67e76b39-b345-4061-b1a8-31b95b6f83a8">
+    <Project Path="test/Microsoft.Restier.Tests.Core/Microsoft.Restier.Tests.Core.csproj" />
+    <Project Path="test/Microsoft.Restier.Tests.EntityFramework.Spatial/Microsoft.Restier.Tests.EntityFramework.Spatial.csproj" />
+    <Project Path="test/Microsoft.Restier.Tests.Shared/Microsoft.Restier.Tests.Shared.csproj" />
+  </Folder>
+  <Folder Name="/test/EntityFramework/" Id="b45d57df-5e57-4cf8-9ff8-86a03f39bb09">
+    <Project Path="test/Microsoft.Restier.Tests.EntityFramework/Microsoft.Restier.Tests.EntityFramework.csproj" />
+    <Project Path="test/Microsoft.Restier.Tests.EntityFrameworkCore.Spatial/Microsoft.Restier.Tests.EntityFrameworkCore.Spatial.csproj" />
+    <Project Path="test/Microsoft.Restier.Tests.EntityFrameworkCore/Microsoft.Restier.Tests.EntityFrameworkCore.csproj" />
+    <Project Path="test/Microsoft.Restier.Tests.Shared.EntityFramework/Microsoft.Restier.Tests.Shared.EntityFramework.csproj" />
+    <Project Path="test/Microsoft.Restier.Tests.Shared.EntityFrameworkCore/Microsoft.Restier.Tests.Shared.EntityFrameworkCore.csproj" />
+  </Folder>
+  <Folder Name="/test/Web/" Id="ae160b58-fb2d-4b9f-9357-8c7648381b95">
+    <Project Path="test/Microsoft.Restier.Tests.AspNetCore.NSwag/Microsoft.Restier.Tests.AspNetCore.NSwag.csproj" />
+    <Project Path="test/Microsoft.Restier.Tests.AspNetCore.Swagger/Microsoft.Restier.Tests.AspNetCore.Swagger.csproj" />
+    <Project Path="test/Microsoft.Restier.Tests.AspNetCore.Versioning/Microsoft.Restier.Tests.AspNetCore.Versioning.csproj" />
+    <Project Path="test/Microsoft.Restier.Tests.AspNetCore/Microsoft.Restier.Tests.AspNetCore.csproj" />
+  </Folder>
+</Solution>