bench: rename projects to role-based names (NuGet/Current)

After the baseline moved to 9.0.0, a project named Benchmarks.V8
containing the v9 package was a lie waiting to confuse someone. The
names now state roles, not versions:
- Benchmarks.V8 -> Benchmarks.NuGet (the published baseline package)
- Benchmarks.V9 -> Benchmarks.Current (this source tree)
- Benchmarks.YetAnother unchanged (third-party yardstick)

Assembly names, build.fsx, benchmark.yml, comments and READMEs follow;
the historical v8-vs-v9 result tables keep their version labels.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: mishamyte

.github/workflows/benchmark.yml

@@ -50,7 +50,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 90
     steps:
-      # Full history + tags for MinVer (the V9 project builds ../src).
+      # Full history + tags for MinVer (the Current project builds ../src).
       - uses: actions/checkout@v6
         with:
           fetch-depth: 0
@@ -73,7 +73,7 @@ jobs:
       - name: Resolve baseline version (latest on NuGet)
         id: baseline
         run: |
-          # Keep in sync with the BaselineVersion default in the V8 benchmark fsproj.
+          # Keep in sync with the BaselineVersion default in the NuGet benchmark fsproj.
           # The latest NuGet version is used only when it shares that pin's API major:
           # a different major means a different public API, and the baseline project's
           # Benchmarks.fs must be migrated before the pin can move.
@@ -93,14 +93,14 @@ jobs:
       - name: Run baseline (NuGet ${{ steps.baseline.outputs.version }})
         run: >
           dotnet run -c Release
-          --project benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.V8
+          --project benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.NuGet
           -p:BaselineVersion=${{ steps.baseline.outputs.version }}
           -- --filter "$BENCH_FILTER"
 
       - name: Run source
         run: >
           dotnet run -c Release
-          --project benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.V9
+          --project benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.Current
           -- --filter "$BENCH_FILTER"
 
       - name: Run YetAnother yardstick
@@ -115,8 +115,8 @@ jobs:
           BASELINE_VERSION: ${{ steps.baseline.outputs.version }}
           BASELINE_NOTE: ${{ steps.baseline.outputs.note }}
         run: |
-          v8="benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.V8/bin/Release/net8.0/BenchmarkDotNet.Artifacts"
-          v9="benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.V9/bin/Release/net8.0/BenchmarkDotNet.Artifacts"
+          nuget="benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.NuGet/bin/Release/net8.0/BenchmarkDotNet.Artifacts"
+          current="benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.Current/bin/Release/net8.0/BenchmarkDotNet.Artifacts"
           ya="benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.YetAnother/bin/Release/net8.0/BenchmarkDotNet.Artifacts"
 
           {
@@ -127,12 +127,12 @@ jobs:
             echo '> `Allocated` is exact and deterministic — treat it as the regression signal.'
             echo '> `Mean` on shared CI runners is noisy; deltas within ±10% are not meaningful.'
             echo ''
-            dotnet fsi benchmarks/compare-results.fsx "$v8" "$v9" "v$BASELINE_VERSION" 'source'
+            dotnet fsi benchmarks/compare-results.fsx "$nuget" "$current" "v$BASELINE_VERSION" 'source'
             if [ -d "$ya" ]; then
               echo ''
               echo '### vs Serilog.Sinks.Loki.YetAnother (yardstick)'
               echo ''
-              dotnet fsi benchmarks/compare-results.fsx "$ya" "$v9" 'YetAnother' 'source'
+              dotnet fsi benchmarks/compare-results.fsx "$ya" "$current" 'YetAnother' 'source'
             fi
           } > benchmark-report.md
 

CLAUDE.md

@@ -67,7 +67,7 @@ Local Loki + Grafana for manual testing: `docker compose up -d loki` (Loki on :3
 
 - **Unit tests** (`tests/...UnitTests`, xUnit + **Unquote** `test <@ ... @>` assertions, all 3 TFMs): wire-format tests assert on exact serialized JSON captured via fake handlers/loopback; `AppSettingsBindingTests` builds a logger from JSON config to pin the appsettings contract; `ExtensionDefaultsTests` guards default-value drift.
 - **Integration tests** (`tests/...IntegrationTests`, net10.0 only): Testcontainers spins up a real Loki and queries pushed entries back. Fail fast without Docker — no skip logic. Not part of the FAKE `Default` chain.
-- **Benchmarks** (`benchmarks/`): three BenchmarkDotNet executables — V9 = this source (ProjectReference), V8 = the published NuGet baseline (pin via `BaselineVersion`/`VersionOverride`, default 9.0.0 — the "V8" name is historical), and Serilog.Sinks.Loki.YetAnother (yardstick) — sharing sources from `benchmarks/Shared/`. Deliberately **not in the .slnx** (each pins a conflicting Serilog/sink closure with the same assembly name). `Allocated` is the deterministic CI regression signal; `Mean` is noisy. `compare-results.fsx` diffs two result dirs (used by `.github/workflows/benchmark.yml` for PR comparisons against the latest NuGet version).
+- **Benchmarks** (`benchmarks/`): three BenchmarkDotNet executables — `Current` = this source (ProjectReference), `NuGet` = the published baseline (pin via `BaselineVersion`/`VersionOverride`, default 9.0.0; CI moves it to the latest same-major release), and `YetAnother` (third-party yardstick) — sharing sources from `benchmarks/Shared/`. Deliberately **not in the .slnx** (each pins a conflicting Serilog/sink closure with the same assembly name). `Allocated` is the deterministic CI regression signal; `Mean` is noisy. `compare-results.fsx` diffs two result dirs (used by `.github/workflows/benchmark.yml` for PR comparisons against the latest NuGet version).
 
 ## Conventions and gotchas
 

benchmarks/README.md

@@ -1,20 +1,20 @@
-# Benchmarks — V8 vs V9 vs YetAnother
+# Benchmarks — NuGet baseline vs current source vs YetAnother
 
 BenchmarkDotNet suites comparing three Grafana Loki sinks:
 
 | Project | Package | Notes |
 |---|---|---|
-| `…Benchmarks.V8` | `Serilog.Sinks.Grafana.Loki` (NuGet, `BaselineVersion`, default **9.0.0**) | the published **baseline**; CI moves it to the latest same-major release on NuGet |
-| `…Benchmarks.V9` | this repo (`../src`, `ProjectReference`) | the current **source**; streams JSON **bytes** through a pooled `Utf8JsonWriter` |
+| `…Benchmarks.NuGet` | `Serilog.Sinks.Grafana.Loki` (NuGet, `BaselineVersion`, default **9.0.0**) | the published **baseline**; CI moves it to the latest same-major release on NuGet |
+| `…Benchmarks.Current` | this repo (`../src`, `ProjectReference`) | the current **source**; streams JSON **bytes** through a pooled `Utf8JsonWriter` |
 | `…Benchmarks.YetAnother` | `Serilog.Sinks.Loki.YetAnother` **4.0.5** (NuGet) | third-party yardstick; Serilog 4.x, also a streaming "low-allocation" design |
 
-> Until v9.0.0 shipped, the baseline project compiled against the v8 API (hence its name) and
-> pinned `8.3.2` — the result tables below are that release-time v8 → v9 comparison, kept as
-> the historical record.
+> Until v9.0.0 shipped, the baseline project compiled against the v8 API and pinned `8.3.2` —
+> the result tables below are that release-time v8 → v9 comparison, kept as the historical
+> record.
 
 ## Why three projects
 
-V8 and V9 ship the **same** assembly name (`Serilog.Sinks.Grafana.Loki.dll`) and cannot
+The NuGet and Current projects ship the **same** assembly name (`Serilog.Sinks.Grafana.Loki.dll`) and cannot
 coexist in one process. Each contender therefore lives in its own executable;
 BenchmarkDotNet runs each in isolation and the reports are merged below. The shared
 workload, config and entry point live in `Shared/` and are linked into all three
@@ -25,7 +25,7 @@ projects, so every side measures byte-for-byte identical inputs.
 - **Public API only, all sides.** Nothing reaches into internals. Each sink is driven
   through its public configuration extension (`WriteTo.GrafanaLoki` / `WriteTo.Loki`).
 - **Identical in-process transport.** Each sink exposes an HTTP injection point
-  (V9 `httpMessageHandler`, V8 `ILokiHttpClient`, YetAnother `httpClient`). A fake drains
+  (NuGet/Current `httpMessageHandler`, YetAnother `httpClient`). A fake drains
   the request body — forcing the real serialization to run — and returns `204` like Loki
   on success. No sockets, no network variance. Set `LOKI_BENCH_TARGET` to hit a real Loki
   instead (see below).
@@ -42,16 +42,17 @@ projects, so every side measures byte-for-byte identical inputs.
 1. **`SinkBenchmarks`** — the full public pipeline (configure → write _N_ events → dispose
    → serialize + POST). The real production path, run for all three sinks.
    `EventCount` ∈ {1000, 10000}, `Payload` ∈ {Simple, Exception}.
-2. **`FormatterBenchmarks`** — per-event `LokiJsonTextFormatter.Format`, **V8 and V9 only**
-   (YetAnother has no public per-event formatter). V9's sink doesn't use this public path
-   in production (it writes bytes directly), so this group is a conservative view of V9.
+2. **`FormatterBenchmarks`** — per-event `LokiJsonTextFormatter.Format`, **NuGet and Current
+   only** (YetAnother has no public per-event formatter). The sink doesn't use this public
+   path in production (it writes bytes directly), so this group is a conservative view.
 
 ## Results
 
 > AMD Ryzen 9 3950X, .NET 8.0 host, BenchmarkDotNet 0.15.8, fake in-process transport.
 > Lower is better; **bold** marks the best in each row.
-> V8 and YetAnother are fixed NuGet packages, so their numbers are stable references; V9 is
-> the current source build. Regenerate the whole table with `dotnet fsi build.fsx -- --target Benchmark`.
+> V8 8.3.2 and YetAnother 4.0.5 are fixed NuGet packages, so their numbers are stable
+> references; the V9 column was the source build at the v9.0.0 release. (Re-running
+> `dotnet fsi build.fsx -- --target Benchmark` today compares the current baseline instead.)
 
 ### End-to-end sink — Allocated (MB/op)
 
@@ -143,7 +144,7 @@ Optional environment variables:
 To run a single suite directly:
 
 ```bash
-dotnet run -c Release --project benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.V9
+dotnet run -c Release --project benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.Current
 ```
 
 Reports land in each project's `bin/Release/net8.0/BenchmarkDotNet.Artifacts/results/`

…Grafana.Loki.Benchmarks.V9/Benchmarks.fs …na.Loki.Benchmarks.Current/Benchmarks.fsbenchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.V9/Benchmarks.fs renamed to benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.Current/Benchmarks.fs benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.V9/Benchmarks.fs renamed to benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.Current/Benchmarks.fs

@@ -21,7 +21,7 @@ open Serilog.Events
 open Serilog.Sinks.Grafana.Loki
 open Benchmarks.Shared
 
-/// In-process transport for the V9 sink: drains the request body — which forces the
+/// In-process transport for the current source sink: drains the request body — which forces the
 /// streaming serialization in LokiPushContent to run — then returns 204, exactly like
 /// Loki's success response. No sockets, fully deterministic. Injected via the sink's
 /// `httpMessageHandler` option, so the sink owns the HttpClient and runs its real path.
@@ -37,8 +37,8 @@ type private Fake204Handler() =
         }
 
 // ── Group 1: per-event body formatter (public ITextFormatter surface) ─────────────
-// NOTE: the V9 sink does NOT use this public Format path in production — it calls the
-// internal byte-oriented FormatToBuffer. This group therefore measures V9's *public*
+// NOTE: the sink does NOT use this public Format path in production — it calls the
+// internal byte-oriented FormatToBuffer. This group therefore measures the *public*
 // formatter (which round-trips through a string to honour the TextWriter contract),
 // a deliberately conservative view. The real production path is in Group 2.
 

….Sinks.Grafana.Loki.Benchmarks.V9.fsproj …s.Grafana.Loki.Benchmarks.Current.fsprojbenchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.V9/Serilog.Sinks.Grafana.Loki.Benchmarks.V9.fsproj renamed to benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.Current/Serilog.Sinks.Grafana.Loki.Benchmarks.Current.fsproj benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.V9/Serilog.Sinks.Grafana.Loki.Benchmarks.V9.fsproj renamed to benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.Current/Serilog.Sinks.Grafana.Loki.Benchmarks.Current.fsproj

@@ -3,7 +3,7 @@
     <PropertyGroup>
         <OutputType>Exe</OutputType>
         <TargetFramework>net8.0</TargetFramework>
-        <AssemblyName>Serilog.Sinks.Grafana.Loki.Benchmarks.V9</AssemblyName>
+        <AssemblyName>Serilog.Sinks.Grafana.Loki.Benchmarks.Current</AssemblyName>
         <RootNamespace>Benchmarks</RootNamespace>
         <!-- BenchmarkDotNet refuses to run a non-optimized build. -->
         <Optimize>true</Optimize>
@@ -19,7 +19,7 @@
 
     <ItemGroup>
         <PackageReference Include="BenchmarkDotNet"/>
-        <!-- V9 under test: the local source project (multi-targeted; net8.0 asset resolved). -->
+        <!-- Current = the sink under test: the local source project (multi-targeted; net8.0 asset resolved). -->
         <ProjectReference Include="..\..\src\Serilog.Sinks.Grafana.Loki\Serilog.Sinks.Grafana.Loki.fsproj"/>
     </ItemGroup>
 

…Grafana.Loki.Benchmarks.V8/Benchmarks.fs …fana.Loki.Benchmarks.NuGet/Benchmarks.fsbenchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.V8/Benchmarks.fs renamed to benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.NuGet/Benchmarks.fs benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.V8/Benchmarks.fs renamed to benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.NuGet/Benchmarks.fs

@@ -21,7 +21,7 @@ open Serilog.Events
 open Serilog.Sinks.Grafana.Loki
 open Benchmarks.Shared
 
-/// In-process transport for the baseline sink (a published v9.x package): drains the
+/// In-process transport for the baseline sink (the published NuGet package): drains the
 /// request body — which forces the streaming serialization in LokiPushContent to run —
 /// then returns 204, exactly like Loki's success response. No sockets, fully
 /// deterministic. Injected via the sink's `httpMessageHandler` option, so the sink owns
@@ -38,8 +38,8 @@ type private Fake204Handler() =
         }
 
 // ── Group 1: per-event body formatter (public ITextFormatter surface) ─────────────
-// Measures the baseline package's public formatter. Like the source project, this is
-// a conservative view: the v9 sink uses the internal byte-oriented path in production,
+// Measures the baseline package's public formatter. Like the Current project, this is
+// a conservative view: the sink uses the internal byte-oriented path in production,
 // which is measured end to end in Group 2.
 
 [<Config(typeof<Config.MicroConfig>)>]

….Sinks.Grafana.Loki.Benchmarks.V8.fsproj …nks.Grafana.Loki.Benchmarks.NuGet.fsprojbenchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.V8/Serilog.Sinks.Grafana.Loki.Benchmarks.V8.fsproj renamed to benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.NuGet/Serilog.Sinks.Grafana.Loki.Benchmarks.NuGet.fsproj benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.V8/Serilog.Sinks.Grafana.Loki.Benchmarks.V8.fsproj renamed to benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.NuGet/Serilog.Sinks.Grafana.Loki.Benchmarks.NuGet.fsproj

@@ -3,11 +3,11 @@
     <PropertyGroup>
         <OutputType>Exe</OutputType>
         <TargetFramework>net8.0</TargetFramework>
-        <AssemblyName>Serilog.Sinks.Grafana.Loki.Benchmarks.V8</AssemblyName>
+        <AssemblyName>Serilog.Sinks.Grafana.Loki.Benchmarks.NuGet</AssemblyName>
         <RootNamespace>Benchmarks</RootNamespace>
         <!-- BenchmarkDotNet refuses to run a non-optimized build. -->
         <Optimize>true</Optimize>
-        <!-- Unlike the V9 project, this one has no F# project reference to drag FSharp.Core
+        <!-- Unlike the Current project, this one has no F# project reference to drag FSharp.Core
              in as a copy-local package, so the SDK's implicit (non-copy-local) reference
              leaves FSharp.Core.dll out of the output and the F# exe fails to start. Reference
              it explicitly (the version comes from central package management). -->

benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.YetAnother/Benchmarks.fs

@@ -24,7 +24,7 @@ open Benchmarks.Shared
 /// In-process transport for Serilog.Sinks.Loki.YetAnother: drains the request body
 /// (forcing its streaming serialization to run) and returns 204 like Loki on success.
 /// Injected by wrapping it in the HttpClient the sink accepts — the same deterministic,
-/// socketless transport used for the V8 and V9 benchmarks.
+/// socketless transport used for the NuGet and Current benchmarks.
 type private Fake204Handler() =
     inherit HttpMessageHandler()
 
@@ -39,7 +39,7 @@ type private Fake204Handler() =
 // ── End-to-end sink push (real production serialization + batching) ────────────────
 // YetAnother exposes no public per-event formatter (its message writer is internal),
 // so only the end-to-end group has a fair equivalent here. Same workload, same fake
-// transport, same batching settings as the V8/V9 SinkBenchmarks.
+// transport, same batching settings as the NuGet/Current SinkBenchmarks.
 
 [<Config(typeof<Config.SinkConfig>)>]
 type SinkBenchmarks() =

benchmarks/Serilog.Sinks.Grafana.Loki.Benchmarks.YetAnother/Serilog.Sinks.Grafana.Loki.Benchmarks.YetAnother.fsproj

@@ -9,7 +9,7 @@
         <Optimize>true</Optimize>
         <MSBuildWarningsAsMessages>MSB3277</MSBuildWarningsAsMessages>
         <!-- No F# project reference to drag FSharp.Core in as a copy-local package, so
-             reference it explicitly (see the V8 project for the full rationale). -->
+             reference it explicitly (see the NuGet project for the full rationale). -->
         <DisableImplicitFSharpCoreReference>true</DisableImplicitFSharpCoreReference>
     </PropertyGroup>
 

benchmarks/Shared/BenchConfig.fs

@@ -27,9 +27,10 @@ open BenchmarkDotNet.Loggers
 /// consumed by the CI comparison step), and the allocation diagnoser (whose numbers
 /// are exact regardless of the short timing job).
 ///
-/// The artifacts path is pinned to this assembly's output directory. Both benchmark
+/// The artifacts path is pinned to this assembly's output directory. The benchmark
 /// projects use the same `Benchmarks` namespace, so their report files share names;
-/// keeping each project's output under its own bin folder stops V8 overwriting V9.
+/// keeping each project's output under its own bin folder stops one project
+/// overwriting another.
 let private applyCommon (config: ManualConfig) =
     config.ArtifactsPath <- Path.Combine(AppContext.BaseDirectory, "BenchmarkDotNet.Artifacts")