Files
frameledger/wiki/Repository-map.md
poli0981andClaude Fable 5.2 49d7bd8e51 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) (#376)
* 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>
2026-11-10 23:13:00 +00:00

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.