* build: the main line on .NET 11 - SDK 11.0.100, net11.0, the three runtime-serviced packages at 11.0.0; Windows 10 stated as untested and unsupported (D94, D95) (beta.37 PR-1) The owner moved the main line to .NET 11 the day after it shipped (D94), setting aside condition (a) of 20_OPEN_QUESTIONS section G's table - two alphas on the released runtime. This is the alpha branch's switch applied to main at released versions, and what follows from it. - global.json 11.0.100 (allowPrerelease false), TFM net11.0-windows10.0.22621.0, Microsoft.Extensions.Hosting, Microsoft.Data.Sqlite and System.Diagnostics.EventLog 11.0.0; legal/licenses/nuget regenerated (78 packages -> 69). - Two CA1307 sites the released SDK raised in tests written after the last alpha was cut take the (char, StringComparison) overload. - IHost.RunAsync rethrows a failed BackgroundService on .NET 11: the Agent's --serve leaves through its crash report where it exited 0. Accepted, not wrapped; HostBackgroundFailureTests holds the runtime's behaviour, which nothing had observed. - release.yml installs a .NET 10 runtime for vpk 1.2.161; Qodana's container installs the .NET 11 SDK first (interim, until the Ultimate linter); Dependabot's and the workflows' comments follow. - Windows 10 22H2 is not blocked, and is stated as untested and unsupported (D95): NFR-8, LIMITATIONS, README, the guide, the wiki. A processor needs SSE4.2 and POPCNT. - docs: 12_BUILD (the main line's .NET; the alpha line rests after alpha.4, D98), 13_CI_CD, 20_OPEN_QUESTIONS row closed, 10_LOGGING, spike-notes section 28, CLAUDE.md, the decisions index (D94-D96, D98). Gate on the dev box: all passed in 338 s on SDK 11.0.100 (native 32/32, 2,561 tests, coverage floors held). Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com> * build: what this pull request's runs measured on .NET 11 - CodeQL reads net11.0 whole, the delta from beta.36, Qodana's one finding fixed - HostBackgroundFailureTests: the message is kept rather than the exception, so no `!` is needed - the one problem Qodana's interim run reported (run 42916491047, InspectCode 2026.2.3.1 on SDK 11.0.100). - 13_CI_CD: what analyze (csharp, none) read of net11.0 (CodeQL 2.27.4, "scanned 1220 out of 1220 C# files", 363 references resolved, none unresolved), and the rule for C# 15 constructs (D96); the interim's first run. - spike-notes section 28: the table of this pull request's runs - check, CodeQL, SonarCloud, Qodana, and the release rehearsal with the first delta across two runtime majors (72.6 MB, 372 of 443 files patched). Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5.2 <noreply@anthropic.com>
3.0 KiB
3.0 KiB
Repository map
The layout with its history is in CLAUDE.md §Solution layout.
Managed code (src/, .NET 11, C#)
| Project | What it holds |
|---|---|
src/FrameLedger.Domain |
Entities and the metric calculators. References nothing. |
src/FrameLedger.Application |
Use cases and ports: the capture loop, the session recorder, settings, the safety decisions. |
src/FrameLedger.Infrastructure |
SQLite, the shared-memory reader, telemetry, the native interop, parsers. The only project that calls native code. |
src/FrameLedger.Shared |
The pipe's message contracts and the C# mirror of the shared-memory structs. |
src/FrameLedger.Agent |
The capture agent's host: the watcher, the pipe server, the recorder. |
src/FrameLedger.App |
The WPF app (WPF UI 4.3.0): pages, dialogs, charts, strings in English, Vietnamese and Japanese. |
src/FrameLedger.CaptureHost |
A developer tool, never shipped. |
Dependencies point inwards: App and Agent → Application → Domain; Infrastructure implements Application's ports.
Native code (src/native/, C++20, MSVC)
| Folder | What it holds |
|---|---|
src/native/FrameLedger.Overlay |
The component loaded into a game: hooks, the ring writer. |
src/native/FrameLedger.Injector |
The anti-cheat guard and injection, built into FrameLedger.Guard.dll for the agent. |
src/native/FrameLedger.VkLayer |
The Vulkan implicit layer and its manifest. |
src/native/FrameLedger.Shm |
The shared-memory layout, header-only; fl_shm.h is normative. |
src/native/FrameLedger.NvapiBridge |
NVIDIA telemetry, loaded by the agent. |
src/native/FrameLedger.ProcessStats |
The game's own memory, read from the agent. |
src/native/tests |
The native test suites (ctest). |
src/native/tools |
hook-harness (a dummy Direct3D 11/12, Vulkan and OpenGL app to hook), the probes, fl-layout-dump. |
src/native/third_party |
Vendored vendor headers: NVAPI, Streamline, FidelityFX, Vulkan. |
Everything else
| Path | What it holds |
|---|---|
tests/ |
One test project per managed project, plus shared helpers and fixtures. |
tools/ |
The PowerShell gates and generators ./build.ps1 runs — see Build and test. |
rules/detection-rules.json |
Engine, platform and capability signatures, and the anti-cheat blocklist. |
guide/ |
The user guide — embedded in the App, and the End-user half of this wiki. |
wiki/ |
This wiki's own pages, published to the Wiki tab when a release is made. |
docs/ |
The developer documents; docs/README.md is their index. |
legal/ |
The documents a user accepts, the accuracy statement, licences and notices. |
.github/workflows/ |
CI, CodeQL, the rules gate, the release and the wiki. |
LIMITATIONS.md |
What the whole software cannot do, in a player's words; also in the App. |
ACCESSIBILITY.md |
The accessibility statement: the goal, what works, the known limits, how a barrier is reported; also in the App. |