The owner took an Ultimate licence for the Qodana Cloud organisation and asked for Qodana over every language. This is the first of two pull requests: the existing job moves to Qodana for .NET (Rider's engine) and what it reports over the managed code is settled. The C++ is the next one's, as a second report. The job - qodana.yaml: linter qodana-dotnet, withinDocker false (native mode on the job's Windows runner, the SDK from global.json; no container, no EnableWindowsTargeting, no bootstrap line). Everything a run needs is in the file. - qodana.yml: the job is `managed` (Qodana (managed)), on windows-latest - checkout, setup-dotnet, the NuGet cache restored, dotnet build -c Release, then the action pinned by commit. Still advisory, still a gate of zero. What its first run reported, and what was done (docs/13_CI_CD.md, section Qodana, has each) - 3,953 problems, 3,607 of them hints - the level an editor offers without underlining anything; the Community linter never reported them. Hints are off as a severity (one group in qodana.yaml). 347 left. - 271: a vi or ja value equal to the English one - off in .editorconfig for .resx (names, units, format strings). - 23 + 10: two Markdown inspections (table padding; anchors computed otherwise than GitHub does) off in qodana.yaml; the application manifest's XML ignored for XmlHighlighting. - 6 in PrimaryDisplay.cs are the linter's own fault (an internal assertion, in its log); two inspections are excluded for that file, and the file is as it was. - 1 fixed: a test expression that carried a clause its first half implied. - 36 from JetBrains' security rules: 35 process starts and 1 SQL text. Each was read - what it starts, where the path and the arguments come from (a table in the docs). None takes a value from outside the PC, except the game the user added. One place was hardened: ShellUrlOpener now refuses any address that is not http, https or mailto itself, where it trusted each caller to have checked (ShellUrlOpenerTests). The rules stay on. A rule's own id is honoured nowhere - a profile entry's `ignore`, an `exclude` path and `enabled: false` were each tried in a run of its own and every result stood: the OpenGrep plugin reports every rule through one inspection, OpenGrepInspection, and hands its server every rule file whatever the profile says. That inspection does take a path, so the eleven files of src the results were read in, and tests, are listed under its name in qodana.yaml: a new file that starts a process is reported. - ProcessStartSitesTests, in the gate, is the same tripwire where a merge is blocked: it sweeps src for every way a process is started here - Process.Start, a ProcessStartInfo, CreateProcessWithTokenW, the logon task's registration - and fails on a file that has not been read and listed. Also: ShmDrainIntegrationTests' drain under supervision supervises at least twice whatever the first drain holds. On a busy machine the first scan was slow enough for fifty presents to be waiting, the loop ended after one evaluation, and the test failed its own "supervised more than once" (once, in a local gate of this change). Where an inspection is switched off (D100, amending D93's "never in qodana.yaml"): in the place the engine that raised it reads - one of ReSharper's in .editorconfig, what has no key there in qodana.yaml. Docs: 13_CI_CD (section Qodana rewritten above D93's account, which is kept as history), CLAUDE.md (the rule, the layout), HANDOFF (D99, D100, this part's section, and the facts of the two releases of 2026-11-11: v0.1.0-beta.37 and v0.1.0-alpha.4), wiki/Releasing, CHANGELOG. Shipped code: ShellUrlOpener.cs alone. No link the App could open before stops opening. Co-authored-by: Claude Fable 5.2 <noreply@anthropic.com>
66 KiB
HANDOFF — read this first, then stop reading it
The one file a new session opens to pick up P0 work (corrected 2026-10-04). It carries sequencing, decisions
and traps. It deliberately carries no status.
The rule this file lives under
This file must never restate what another document already states. Four documents disagreeing about the gate's composition is what §S23-4 and §S23-5 were raised for, and
rules-validatenow fails a fifth copy in the shipped data. A handoff that summarises status becomes the next stale copy within a day — that has already happened three times here (#45's note, then #46–#52;15_ROADMAP's status block;spike-notes§8 correcting a stale claim and going stale in the same file).So: status lives where it lives. Read it there.
Question File What is unresolved and what does it block? docs/20_OPEN_QUESTIONS.md— §S24 is the index; the ✅/◐/❓/🔴/🅓 markers are load-bearingWhat was measured, on what machine? docs/spike-notes.mdWhich P0 item is where? docs/15_ROADMAP.mdWhat landed? CHANGELOG.mdWhat does the software promise users? README.md,legal/DISCLAIMER.md— both carry accuracy blocksAnd verify a status claim against the code before planning on it. Four times now those files have asserted in the present tense something that had been closed, or was never true. The 2026-08-05 session found the ledger stale across seven PRs and two documents contradicting themselves inside one section.
How this file is split (2026-10-19, beta.24, owner decision D66)
Everything this file held is still here or one link away, moved verbatim: what to do next and the open
owner-only items stay below; the history of every train, the passed owner-only items and the traps moved to
docs/handoff/. Code and documents cite the old sections by name — each name resolves here:
START HERE — 2026-11-11, 0.1.0-beta.37: the main line on .NET 11, what an alpha is now, and why no C# 15 yet
Status is docs/changelog/0.1.0-beta.37.md; this is what no other file carries. The owner, with two screenshots — a
Qodana Ultimate licence in the JetBrains console, and the Qodana Cloud project's setup page: "Bạn có thể bắt đầu với phiên
cải tiến cho .net 11 và set up cho qodana cho tất cả ngôn ngữ (gói ultimate) nhé." The session D92 had left for after
.NET 11's release (2026-11-10), and Qodana for every language on the Ultimate licence. One plan, approved whole, in
three parts: beta.37 (#376 the move, #379 what an alpha is, #380 .NET 11's API and the C# 15 finding, and this
release) → alpha.4 → Qodana Ultimate in two reports. This section is the first part; the other two follow it on
main the same way.
Decisions (asked while planning, do not re-ask):
- D94 — the main line moves to .NET 11 now. Asked whether the betas move or only alpha.4 — with
20_OPEN_QUESTIONS§G's table quoted: two alphas on the released runtime and an owner's run of a hooked title first — the owner chose "Chuyển main sang .NET 11 ngay". Condition (a) of that table was set aside, not met;12_BUILD§The main line's .NET says what stood in for it, and owner-only item 34 is the run it asked for. - D95 — Windows 10 22H2 is not blocked, and is stated as untested and unsupported ("Vẫn chạy, ghi rõ không được hỗ trợ"). NFR-8 is amended; a processor needs SSE4.2 and POPCNT.
- D96 — C# 15 in the same release ("Áp dụng cả C# 15 ngay trong beta.37"). The plan narrowed it in writing, and was approved with that: a construct only where the build, CodeQL and Qodana all read it.
- D97 — all three legal texts reworded ("Sửa cả ba văn bản"): EULA 1.7, Disclaimer 2.14, Alpha notice 1.1. Their text was in the plan and approved with it.
- D98 — alpha.4, then the alpha line rests until a newer .NET has a preview ("alpha.4 rồi nghỉ tới .NET 12 Preview").
- The order: beta.37 → alpha.4 first, Qodana after; and Qodana in two reports from the start (the third part's decision, D99).
Choices made here:
- No C# 15 construct is used, although the owner asked for them. The rule decided it, not a preference:
ReSharper's engine, which Qodana runs, reads none of the four (
13_CI_CD§C# 15 and the analyses,spike-notes§29). Unions would not have been the form in any case — the SDK's own CA1815 asks every union to hand-write its equality, and the shapes that wanted one are closed record hierarchies. What the release takes is API. - .NET 11's
IHost.RunAsyncis accepted, not wrapped: a failed background service now ends the Agent through its crash report. A catch there would hide a fault, and could not reproduce .NET 10's exit exactly either. - A resting alpha says so in the build, not only in its notes: the anti-cheat list reaches a user only inside a
release, so an alpha nobody updates carries an ageing one.
FlAlphaLineRestsis stamped on both lines; thealphabranch sets it to false when it next tries a .NET. - "A prerelease .NET" is said only by a build that runs on one, read from the runtime's own description — the next preview alpha says it again with no change to the code.
release.ymlnames the .NET 10 runtimevpkneeds, rather than relying on the hosted image carrying one.- The Community Qodana job was kept alive across the move by installing the SDK into its container — an interim; the Ultimate linter replaces the job in the third part.
- The 2026-10-31 forms stay where they read as well (
json.AsSpan().TrimStart().StartsWith('[')avoids a string): .NET 11'scharoverloads replaced a span only where the span was there for .NET 10's sake.
Measured on the way (spike-notes §28 and §29): the gate on SDK 11.0.100 — two analyzer sites beyond RC3's
twenty-one, both in tests written after the last alpha; IHost.RunAsync rethrowing, observed for the first time; the
first delta across two runtime majors (372 of 443 files patched, 72.6 MB on the rehearsal); main's first full CodeQL
C# analysis on net11.0 (1,221 of 1,221 files, the same 23 unresolved Windows.Win32 types as on .NET 10); the
SonarScanner 12.0.0 on the 11.0 runtime; InspectCode 2026.2.3.1 and 2026.3.0 against each C# 15 construct.
Traps met on the way:
- A pull request's CodeQL C# run is an overlay analysis: it extracts the changed files on top of
main's cached database, and its "scanned N out of N" ismain's baseline. #376 wrote "CodeQL readsnet11.0whole" from one and was corrected, dated, two pull requests later withmain's own run. For anything the extractor has not met, dispatchcodeql.ymlon the branch (it takesworkflow_dispatchsince #380). ShmDrainIntegrationTests.TheGuardInjectsTheOverlayAndTheReaderDrainsRealFramesfailed once on the dev box — "our own harness must not start matching the blocklist mid-run": the guard's re-scan refused the harness in one gate run of five. The class passed three times in a row straight after and no guard code had changed; not looked into.- A wiki page names no version (
wiki-check): "since 0.1.0-alpha.4" inwiki/Releasing.mdwas red. The guide's pages may. - The runner queue: with three workflows per pull request and a probe's pull request open beside the train,
checkwaited about 25 minutes for a runner. Cancel a probe's runs once it has told what it can. - A Bash heredoc halves the backslashes of an inline Python regex — write the script with the Write tool.
x.Should().NotBeNull(); x!.Member: ReSharper reads the!as redundant (Qodana's one finding on #376) and the compiler wants it. Keep the value the assertion needs, not the object.- CA2025 on a lambda that captures a
usingvariable in a test: await inside atry, assert after. - A local gate reseeds
%LOCALAPPDATA%\FrameLedger\ruleswhile the owner's installed copy runs beside it: the files were hashed before and after every gate (identical each time — the repository's rules were the installed ones).
The release (the tag, 2026-11-11). Rehearsed first (release.yml dispatched on the release branch, run
42926539241), then the signed tag v0.1.0-beta.37 on 1a7fbf3: run 42930394186, published 2026-11-11T00:36:54Z.
Eight assets, the seven listed in SHA256SUMS.txt equal to the digests GitHub computed; FL_BUILD_ID v0.1.0-beta.37
in the shipped natives. The delta across two major runtimes exists — the stop condition the plan had named: "Delta
processed 0443 files. 0373 patched, 0070 unchanged, 0009 new, 0017 removed", 72,681,960 bytes beside a full package of
110,325,368. The wiki was published by its own run (42932792575).
Owner-only: item 34 — beta.37 on real hardware, a hooked session on .NET 11.0.0, and Windows 10 if a PC with it is at hand.
0.1.0-alpha.4 — the fourth alpha, the same day, and the last for now (D98)
alpha takes main at this pull request — v0.1.0-beta.37 and these notes, no other change — by a merge commit. This
sync is not like the three before it: main now holds what the switch held (global.json, the TFM, the three
packages, legal/licenses/nuget/, the Transitive row), so every switch file conflicts, and each is resolved by
taking main's — the branch's RC3 lines go, RELEASE_LINE stays alpha, and git diff --name-only origin/main on the
merged tree must print that one name. Its gate must pass on alpha before the pull request is merged by hand (the
branch has no auto-merge); the release runs from the signed tag v0.1.0-alpha.4 on alpha, with its delta from
alpha.3. Its notes are docs/changelog/0.1.0-alpha.4.md: the warning, and that it is the last alpha for now.
- After it the line rests (
12_BUILD§The alpha line): no sync follows a beta and no alpha is cut until a newer .NET has a preview.FlAlphaLineRestsinDirectory.Build.propssays so to the build; the next trial sets it tofalseonalphawith the rest of the switch. - What a resting alpha costs its user is in its notes, the guide and its banner: no update, the anti-cheat list included; and once ten betas have followed it, a copy of alpha.3 or older no longer finds alpha.4 (Velopack reads the newest ten releases).
The sync and the release (2026-11-11). #382 put the notes on main (428b723); #383 merged main into alpha by
hand (134115b): twenty-seven conflicts, every one resolved to main's side, and git diff --name-only origin/main origin/alpha prints RELEASE_LINE alone. Rehearsed on alpha (run 42933603983: channel alpha, a delta from
alpha.3), then the signed tag v0.1.0-alpha.4: run 42935876535, published 2026-11-11T01:16:22Z as FrameLedger
0.1.0-alpha.4 (experimental alpha), a pre-release. Eight assets, seven of seven digests equal; "Delta processed 0448
files. 0369 patched, 0079 unchanged, 0004 new, 0005 removed", 18,207,557 bytes; FrameLedger.App-alpha-Setup.exe,
releases.alpha.json; the wiki run skipped, as it does for an alpha.
- One tag push started two release runs (42935876535 and 42935878584, both
push, created in the same second; the tag was pushed once).release.yml's concurrency group made the second wait for the first, and it then began the whole build again. It was cancelled once the first had published: it could only have ended red, atgh release createon a release that existed. If a tag ever shows two runs, let the first finish, verify the release, then cancel the other.
Owner-only: item 35 — the fourth alpha on real hardware, and the beta installed over it.
Qodana for .NET on the Ultimate licence — the managed report (D99, D100)
Status is docs/13_CI_CD.md §Qodana and CHANGELOG.md; this is what no other file carries. The third part of the
plan, in two pull requests: this one moves the existing job to Qodana for .NET (Rider's engine, native on a Windows
runner) and settles what it reports over the managed code; the next adds the C++ as a second report.
Decisions:
- D99 — two reports from the start ("Hai báo cáo ngay từ đầu"). The owner made a second Qodana Cloud project,
frameledger-cpp, and the secretQODANA_TOKEN_NATIVE; the managed report goes toframeledgerwithQODANA_TOKEN. Both secrets are the owner's; no token was ever read or handled here. - D100 — where an inspection is switched off (the plan's design, approved with it; it amends D93's "never in
qodana.yaml"): in the place the engine that raised it reads — one of ReSharper's in.editorconfig; what has no key there inqodana.yaml. Hints are off as a severity. In code loaded into a game only defects are fixed.
Choices made here:
- JetBrains' security rules stay on, scoped by path — which took four runs to find. Every result was read first
(the table in
13_CI_CD§Qodana), and one place hardened (ShellUrlOpenerrefuses anything buthttp,httpsandmailto). Then the files read had to be told to the linter, and a rule's own id is honoured nowhere:ignore, anexcludepath andenabled: falseeach left all 36 results standing. The report's ownlog/effective.profile.xmlandqodana_inspections_summary.csvgave the answer — one inspection,OpenGrepInspection, produces every rule's results, and it does take a path. Between the third run and the fourth the rules were written as off, with a test in their place; the test stayed (ProcessStartSitesTests, in the gate, and wider than the rule), the rules came back on. PrimaryDisplay.cswas not changed to please the linter. Its six results come from an internal assertion in this linter's build (in the job'sbackend.log), not from the file; the first guess — that the engine misreads anunsafetuple — was wrong, and a rewrite made on it was reverted. Two inspections are excluded for that one file, to be removed when a linter build reads it.- What the Ultimate licence offers and this job does not use: quick-fixes (the job cannot push, on purpose), code
coverage in Qodana, FlexInspect. If the licence lapses the job is red and advisory; the way back is in
qodana.yaml.
Traps:
- A security rule's id is not an inspection. The OpenGrep plugin's rules all report through
OpenGrepInspection; only that name works inqodana.yaml, and only by path. Readlog/qodana_inspections_summary.csvin the report artifact to see which inspection produced a result before spending a run on a guess. - A report artifact is a zip inside the download, with backslash paths:
unzipextracts it and exits non-zero on the warnings, so do not chain on its exit code. - A linter result can be the linter's fault: read the job's log directory (the report artifact carries it) for an
AssertionExceptionbefore changing the code it points at. - A Qodana run of the managed job takes fifteen to seventeen minutes, most of it the scan; a pull request's own run
reads the whole solution (
pr-mode: false), so there is no quick partial run to iterate on.
Next: the native report — a Visual Studio solution generated by CMake (x64-vs-analysis), qodana-native.yaml,
the job native; 655 results on its first run with the hints off, 494 of them distinct (a file compiled into three
targets is reported three times), about a quarter in code loaded into a game.
Owner-only — no PR can close these
The items that passed — 3, 12, 14–19 — moved verbatim to handoff/owner-only-passed.md on 2026-10-19 (D66); the numbers are kept, and a number is never reused.
-
§S23-2 — branch protection.
Rules / validateis not a required status check onmain, so the gate that makes the anti-cheat blocklist un-removable is advisory. Second-order problem:rules-publish.ymlfilters on four paths for bothpushandpull_request, so requiring the context as-is blocks every PR touching none of them, forever. Land the skip-shim (droppaths:, short-circuit inside the job) first; the setting is the owner's. -
Real-title verification runs for the upscaler/FG/RT work, against each game's own settings menu.
Live as of 2026-09-03: theRun twice, 2026-09-03 (P4) and 2026-09-04 (P1); done. What is still owed here is the quality preset on a title that chainsslGetNewFrameTokenproducer's table — Cyberpunk 2077 off / ×2 / ×4 and Hell Is Us DLSS + FG ×4, one launch each, readingpresents/tokensoff theFG counts:line against §S31's rows P1–P4.sl::DLSSOptions— Alan Wake 2 is the candidate — and the DLSS-G identity on a title wherekFeatureDLSS_Gis evaluated, if one exists. -
§H7's confirmation against the overlays actually resident on the dev machine. The compare-and-restore path is proven against a fixture (ctest
fl_unhook_inline); §H7 still says the six real overlays are "worth doing once the Overlay has real hooks", and it has them since P1. One capture with each overlay active; the result is aspike-notesrow. -
Re-ratify §S18 blocker 3 and §S27's basis once P2's PR-C/PR-F make the Agent the shipped injecting entry point (§P2, decision D4). The PRs restate both entries; whether the restatement stands is the owner's.
-
D33's first real use (beta.9).Done by 2026-09-27, read from a copy of the owner's ledger: three normal hooked sessions of GIRLS' FRONTLINE 2 under the exception (NetEase Yidun) on 2026-09-26 and 09-27, the longest 3 h 9 min; thejareview below is still owed. (The item as written:) Turn the option on; GIRLS' FRONTLINE 2 should be listed eligible (NetEase Yidun,NEP2.dll, three sessions); make the exception, turn hooking on and play one session: hooked, marked Hooked · exception, not stopped by the 30 s re-scan or by the Overlay whenNEP2.dllloads. Aniimo should read not eligible with itsNEPKernel.sys; the option off makes the next session Tier 2 with the exception kept. And thejatext ofSafety_Exception_*, which ships as English until a reviewer signs. -
beta.10 on real hardware. (a) The display mode: one DXGI game taken through exclusive full-screen → borderless → windowed in one session — the summary's shares, the Sessions column, the Trend's three share metrics — with a note of what the game's own menu called each mode. (b) The admin mode: turn it on → the disclosure → the UAC prompt → Settings says Running elevated; decline it → the administrator prompt was declined; sign out and in with the logon task → the prompt waits on the taskbar and one Agent results; start a game from FrameLedger while elevated → Task Manager's Elevated column says No; a game that runs as administrator → hooked; the CPU temperature with PawnIO (closes §M10 if it reads). (c) The Unreal Engine version on each Unreal game's page. (d) The Legal Gate shows Privacy 2.5 and Disclaimer 2.8 once. (e) The
jatext ofSafety_AdminMode_*, English until reviewed. (f)docs/LIST_GAME_TESTED.md— reviewed and approved by the owner before it was committed (D35, 2026-09-27); keep it current as games are run. -
beta.11 on real hardware. (a) GIRLS' FRONTLINE 2: the option on → Eligible → Make exception… (the disclosure
ac-exception-dialog/2, with its Trial paragraph) → hooking on → two sessions: the card says trial: 0 of 2, then 1 of 2, then Exception in force since … alone. (b) The library at your window's width, and the list; Refresh after installing a game, and with the USB drive unplugged (Not installed, the drive named). (c) Delete all sessions on a game's page and in Settings ▸ Data. (d) Sessions at a glance and the Trend with a second unit. (e) The Legal Gate shows the Disclaimer 2.9 and the EULA 1.4 once. (f) Thejatext ofSafety_Exception_Trial(English until reviewed) and the App strings markedreview. -
beta.12 on real hardware. (a) The game's memory: one hooked game and one that is not (hooking off, or a blocked game), each beside Task Manager's Details tab at the same moment — the summary's VRAM (this game) against Dedicated GPU memory, RAM (this game) against Memory (private working set); the Dashboard's live line; the Sessions columns, the Trend's memory metrics and the Sensors charts. (b) The Legal Gate shows the EULA 1.5, the Disclaimer 2.10 and the Privacy Policy 2.6 once, rendered, with the GPL as your licence, needing no acceptance. (c) Help ▸ User guide, Help ▸ About (its three tabs; Open the licences folder in the installed copy), and View on GitHub opening the
v0.1.0-beta.12tag. (d) Thejastrings markedreview(the memory labels, the About window, the first-start summary). (e)docs/LIST_GAME_TESTED.mdis as of beta.10: refresh it from a copy of the ledger, with the games' memory figures, and approve it before it is committed (D35). -
beta.13 on real hardware. (a) The first delta: update an installed
0.1.0-beta.12through Help ▸ Check for updates — the download is a fraction of the full ~107 MB, and the App comes back as beta.13; if it downloaded the full package instead, say so (Velopack falls back silently). (b) On this PC: with an Easy Anti-Cheat service running for any game, start a hook-enabled game — the notice says the anti-cheat is running on this PC, not in the game. (c) Two graphics cards, if a machine with them is at hand: the Sensors chart's GPU figures are the game's card. (d) Thejareview of the new safety strings, with the others still marked for it. -
beta.14 on real hardware. (a) The update from beta.13: choose Beta in Settings ▸ Updates, Help ▸ Check for updates, then Restart to update with no game running; Settings then reads Automatic (Beta). The
velopack:lines inui-*.logsay what was downloaded — a delta of about 2 MB; say so if it was the full package. (b) Explorer ▸ Properties ▸ Details ofFrameLedger.exeandFrameLedger.Agent.exename FrameLedger and the copyright; Task Manager lists FrameLedger Agent. (c) The wheel on every page, the dialogs and the summary window; over a chart the wheel scrolls the page and Ctrl+wheel zooms; the Logs page follows the newest line. (d) Hide scroll bars on and off, without a restart. (e) The import list in the dark theme, and Compare's tick boxes. (f) A crash: an Unreal game that crashes reads crashed (… CrashReportClient.exe); The Witcher 3 closed normally no longer reads crashed. (g) The new measurements on the RTX 5080: the VSync share against the game's own VSync setting, the render scale against the DLSS mode, the clocks, fan and limits. (h) Thejastrings markedreview. (i) The Privacy Policy 2.7 wording — before PR-5 and PR-7 merge. -
beta.17 on real hardware. (a) A theme switch: on Settings, Dark → Light → Dark, and again with a session's summary window open — every description and caption follows at once. (b) Hide scroll bars on: the Dashboard, Games, a game's page, Logs, About, Help ▸ User guide and a drop-down list draw no bar, and the wheel still scrolls; off, the bars come back without a restart. (c) Help ▸ User guide lists twelve pages and Limitations; a link to a section opens that section. (d) The wiki, once the release is out: the Wiki tab shows Home, the sidebar's two halves and a footer naming
v0.1.0-beta.17— then tick Restrict editing to collaborators only (Settings ▸ General ▸ Features ▸ Wikis), or anyone can change a page until the next release overwrites it. (e) Thejastrings markedreview. -
beta.24 on real hardware — decision tables written before the runs. (a) The mix (D62): a DLSS 4 title (Cyberpunk 2077 or Hell Is Us) with the NVIDIA App's Frame Generation Mode on Use 3D app setting, one session of about two minutes each at ×2, ×3 and ×4 chosen in the game's menu, plus its menus → the summary's Frame generation in this session lists ×2.0 / ×3.0 / ×4.0 with shares near the time spent, each with its own Native → Displayed, and the line Set in the game — no NVIDIA App frame-generation override. Then the MFG title with the App's Fixed ×6 → a ×6.0 row and Set in the NVIDIA App: Fixed ×6. Then Dynamic, Target FPS = Max refresh rate, Multiplier = Up to 6x → several rows or Not classified, and Set in the NVIDIA App: Dynamic, up to ×6, target: max refresh rate. Record the stored
driver_profilevalues for the Dynamic run:NGX_DLSSG_DYNAMIC_MULTI_FRAME_COUNT_MAX5 and the target0x01000000confirm the decode; anything else correctsNvidiaOverrides.FrameGenerationContext. (b) The quality mode (D63) on Expedition 33: the App's Super Resolution mode Quality, then DLAA, Ultra Performance, Performance, one short session each → the header reads DLSS (driver-reported) Quality · NVIDIA App and so on. StoredperformanceMode: Ultra Performance 3 (already measured on Silent Hill 2) and DLAA 5 confirm NGX's numbering; DLAA 4 would mean the report follows the profile's numbering above 3 — thenUpscalerNames.FromDriverReportchanges, and the row goes intospike-notes. (c) The libraries (D64): the same sessions' DLSS line names the super-resolution library and from the graphics driver when the override's copy is loaded; preset L → DLSS 4.5 (preset L). With Model Presets on Use 3D app setting, the game's own library and no generation beyond what was observed. Record the names the override loads under%ProgramData%\NVIDIA\NGX(the summary's Loaded: line) — they correct05_DETECTION§Shipped is not loaded. (d) DLSS 5 on the owner's DLSS 5 title: DLSS 5 runtime loaded. If it is not shown, record the module names it loads (Loaded: line);nvngx_dlssnr.dllis then corrected inCensusNamesand05_DETECTION. (2026-11-06,spike-notes§26: Hogwarts Legacy, Neural Rendering on, loadednvngx_dlssnr.dll310.9.16.0 from the game's folder — the name holds; whether it ran is what beta.34 measures, item 30(a).) (e) SonarCloud (D67): bulk-mark per13_CI_CD§SonarCloud; optionally its Ignore issues on multiple criteria rows; close PR #315. (f) The Legal Gate shows Disclaimer 2.11 and Privacy Policy 2.12 once. (g) Thejastrings markedreview. (2026-10-19, the owner's first runs —spike-notes§22: (a) the Dynamic context line reads the App's own words, and the mix found ×2.0 / ×3.0 / ×6.1 — plus a ×1336.0 row that was a defect, fixed in beta.26; (c) the override loads160_E658700.bin310.9.16.0 and1B0_E658703.dll2.14.16.0 from the NGX folder; (e) done — every issue marked; the last six, triaged in13_CI_CD§SonarCloud (beta.26), the same day, andmain's quality gate passes. The rest is not run yet.) (2026-10-20, the owner's runs of beta.26 —spike-notes§23: (a) done — ×2, ×3 and ×4 chosen in Cyberpunk 2077's menu read ×1.9 (ten seconds), ×3.0 and ×4.0, each with its own rates, under "Set in the game — no NVIDIA App frame-generation override"; Fixed ×6 on Expedition 33 read ×6.0 under "Set in the NVIDIA App: Fixed ×6"; Dynamic on Silent Hill 2 read ×2.0 and ×3.0, plus a ×2.52 row that was a defect, fixed in beta.27. The Witcher 3 under Fixed ×6 presented ×2.0 throughout: the rows are the frames, the line is the setting. (b) could not pass before beta.27: every stored driver word had lostCREATED | EVALUATE, read after the game had closed, so an NGX-direct title under the override never read its mode — run it on beta.27. (c) The Witcher 3 under the override loaded160_E658700.bin310.9.16.0 and1B0_E658700.dll2.14.16.0; Silent Hill 2 and Expedition 33 loaded1B0_E658703.dll.) -
beta.25 on real hardware — FSR's quality mode (D65), decision table written before the run. Lies of P (FSR through AMD's FidelityFX libraries) launched by FrameLedger, not attached, with the game's own FSR at Quality, then a second session at Performance → the summary's header reads FSR 3 Quality, then FSR 3 Performance (or FSR Quality where the SDK 2.x libraries name no version), and the CSV export's
# quality_mode:saysquality (game). Then: no mode on both → the title sizes its frames without asking, or asked before the hook was in: record the session's render → output resolution and the Loaded: line inspike-notes, and D65 stays built and silent for that title. A wrong mode (the Quality session reading Balanced) → the answers this title receives are not the vendor's documented ratios: record the storedupscaler_qualityand the render size inspike-notes, and the match is withdrawn until it is explained. With the game's dynamic resolution on (if it offers one) → no mode. (2026-10-19,spike-notes§22: the Quality session read no mode with the query hooked — the first branch; 1707×961 is the engine's own rounding of 66.67 %, not the size answer, so the title asked before the hook was in or never asked. D65 stays built and silent for Lies of P. The Performance session is not run.) (2026-10-20, §23: the Performance session, started through Steam, read "FSR 3 · 1280×720 → 2560×1440" and no mode — the first branch on both. 1280×720 is exactly the vendor's Performance size, so a query the hook met would have matched: the title did not ask while the hook was in. It cannot be launched by FrameLedger as this item asks — started directly it hands itself to Steam within seconds, and before beta.27 the game Steam started was not recorded at all.) -
beta.27 on real hardware. (a) The driver's report, and item 20(b): Expedition 33 under the NVIDIA App's DLSS override → the header reads DLSS (driver-reported) with the override's mode and · NVIDIA App (Balanced as set on 2026-10-20); then 20(b)'s four modes. Still Upscaler not identified → record the session's stored
ngx_driver_words: no reading while the game ran said the feature was created and evaluated. (b) Start directly on Lies of P: the notice says a Steam game may hand itself to Steam first, and the game Steam starts is recorded —agent-*.logsays started while the last session of its executable was ending; recording it now. The crash safety counts the hand-off: after two such starts hooking is off again (19_SAFETY). (c) One window per session: open a session from a Sessions tab, then again from the game page or its notification → the same window comes forward, restored if minimised. (d) A game in exclusive full-screen (Dark Souls III, Lies of P) → its summary's Display card shows the window size. -
beta.28 on real hardware. Two games at once — one hooked, one with hooking off (or refused) → the Dashboard shows two cards side by side, the hooked one first, and 2 games recording beside Live capture; each card's numbers are its own game's; closing one leaves the other's card where it is, and the count goes. A third game → a third card on the next row and 3 games recording. (The
jastringDashboard_Live_Count_Formatis markedreview.) -
beta.29 — SonarCloud from CI (D68), the owner's settings. None blocks anything. (a) Optional: add
SONAR_TOKENto the repository's Dependabot secrets (Settings ▸ Secrets and variables ▸ Dependabot) if Dependabot's pull requests should be analysed too; until thenci.yml'ssonarcloudjob is skipped for them, as it is for a fork's. (b) Optional: SonarCloud's branch list holdsbeta29/pr1-sonarcloud-ci, left by a dispatch of that branch the plan then refused (13_CI_CD§SonarCloud, The first analyses); delete it under Branches, or let SonarCloud remove it after 30 days without an analysis. (c) Optional:analyze (actions, none)(CodeQL over the workflows) andsonarcloudare not required checks; making either one required is the owner's setting. (d) Velopack 1.2.161 and Markdig 1.5.0 were not taken by #335 (docs/changelog/0.1.0-beta.29.md, The libraries Dependabot never updated): the first changes how updates install and wants a run of the update path on the owner's machine, the second its licence copy re-read. (2026-10-26, beta.30: Velopack 1.2.161 taken — the owner's decision D71, its update path is item 25(c); Markdig went to 1.4.2, its licence text re-read and unchanged; 1.5.0 waits for the cooldown.) -
beta.30 on real hardware. (a) Enter in the consent dialog (D69): on a game whose hooking is off, turn the switch on, type the phrase exactly and press Enter → hooking is on, and the switch and its text agree; Enter before the phrase is complete → nothing happens; Esc → the switch is back off beside off, and leaving the page and coming back shows the same. (b) The numbered markers (D70): the game whose GPU driver changed on 2026-10-24 — Sessions at a glance and the Trend show a badge 1 above the chart, whole, in both themes; the list under each chart names that day and Driver GPU: 32.0.16.1742 → 32.0.16.2101; pointing at the dashed line shows the same; a narrow window keeps every badge whole. (c) The updater (D71): Help ▸ Check for updates on beta.29 installs beta.30 (beta.29's updater, a delta); the update to beta.31, when it comes, is the first Velopack 1.2.161 installs — say whether it downloaded the delta or the full package, and whether it came back. (d) The
jastrings markedreview(Trend_Changes_Header,Trend_Change_Heading_Format). -
beta.32 on real hardware. (a) The update from beta.31: Help ▸ Check for updates, Restart to update — the terms window shows the EULA 1.6 and the Disclaimer 2.12 once, with no tick box, and nothing else of the alpha appears: no ALPHA badge, no banner, the title FrameLedger, Settings ▸ Updates ▸ Channel as before. (b) About ▸ Legal documents lists the Alpha notice, and its version line reads Runs on .NET 10.0.x; Help ▸ User guide has Alpha builds. (c) Whether the update downloaded the delta or the whole package. (d) The
jastrings markedreview:About_Runtime_*here;Alpha_*,FirstRun_Alpha_*,FirstRun_Doc_Alpha,App_Title_AlphaandSettings_UpdateChannel_AlphaBodyshow only in an alpha. -
0.1.0-alpha.1 on real hardware (D73, D74). (a) Installing it over beta.32:
FrameLedger.App-alpha-Setup.exefrom its release page — Velopack asks whether to replace the installed FrameLedger; the terms window shows the Alpha notice with its warning box, and Accept stays off until the box is ticked; Decline closes the App. (b) While it runs: the ALPHA badge (its tooltip names .NET 11.0.0-rc.3), the title FrameLedger Alpha, the banner at start (closable; its button opens the notice); About reads Alpha build — runs on .NET 11.0.0-rc.3…; Settings ▸ Updates ▸ Channel is locked with its line. (c)%LOCALAPPDATA%\FrameLedger\backups\ledger-before-0.1.0-alpha.1.dbexists and opens. (d) One hooked (Tier-1) session of a game measured before records as on the beta; the Agent's log names the release line and .NET 11. (e) Going back: the beta'sFrameLedger.App-win-Setup.exeover it — the beta shows the alpha's session. (f) Thejastrings markedreviewthat only an alpha shows (Alpha_*,FirstRun_Alpha_*,FirstRun_Doc_Alpha,App_Title_Alpha,About_Runtime_Alpha_Format,Settings_UpdateChannel_AlphaBody). -
beta.33 on real hardware: the Xbox titles (D77–D81). (a) The update from beta.32 (or alpha.2's, item 29): the terms window shows the Privacy Policy 2.13 once. (b) Import library offers the eleven Xbox titles as Xbox — the Unreal titles with their shipping executables (
…-WinGDK-Shipping.exe,ValorMortisMSG-Win64-Shipping.exe), the Unity titles with their players, nevergamelaunchhelper.exe— each with its package version (Xbox version 1.3.5124.0). (c) Each game's page shows its square logo whole in a square slot and its splash image as the banner, captioned Xbox. (d) Play starts Valor Mortis and FINAL FANTASY through Windows in both Play modes, and from an App run as administrator — the notice says Windows is starting it. (e) With consent given, one hooked session of each: Tier 1, frames, late attach, the engine and platform on the game page. (f) Thejastrings markedreview:Store_Xbox_Format,Art_Source_Xbox,Import_NothingFound,FirstRun_Import_Body,Settings_GameArt_Body,Play_Xbox_Format,Play_Xbox_NotStarted_Format,Play_PackagedGame_Format,Play_ToolTip_Store,Play_ToolTip_Direct,Settings_PlayMode_Body,Guard_TargetAppContainer,Guard_TargetMitigation. Thendocs/LIST_GAME_TESTED.mdgains the Xbox titles from a ledger copy (D35), approved before the commit. (2026-11-06, beta.34: done — inKONBINI and Valor Mortis, with the refresh the owner approved with the plan.) -
0.1.0-alpha.2 on real hardware (D73, D82). (a) The update from alpha.1: Help ▸ Check for updates offers alpha.2 — the first update an alpha's updater has found — and Restart to update installs it; say whether it downloaded the delta or the whole package. (b) The terms window shows the Privacy Policy 2.13 and the Alpha notice with its box again, and Accept waits for the tick. (c)
%LOCALAPPDATA%\FrameLedger\backups\ledger-before-0.1.0-alpha.2.dbexists beside alpha.1's, and opens. (d) Item 28's Xbox checks, on the alpha. -
beta.34 on real hardware (D83–D86). (a) The update from beta.33 (or alpha.3's, item 31): the terms window shows the Disclaimer 2.13 and the Privacy Policy 2.14 once. (b) Hogwarts Legacy with Neural Rendering on, one hooked session → DLSS 5 (neural rendering on N % of rendered frames); then off —
spike-notes§26's table, written before the run, decides (on and 0 %: neural rendering runs outsideslEvaluateFeature, the line stays runtime loaded, not seen running, and the session'ssl_tag_censusis recorded before anything is named). (c) Phantom Blade Zero under the NVIDIA App's Dynamic, up to ×3 → DLSS 4.5 (Dynamic multi frame generation, set in the NVIDIA App); the game's own ×3 with no override from the App → DLSS 4. (d) Games from any page: the cards at once, a second visit at once; the Debug lineui: page … shown … ms after its navigation. (e) Settings → change the language → the window comes back on Settings. (f) The filters on Games and Compare, the Compare columns and selection bar, the selected page's label in the pane, in both themes. (g) The 34jastrings this release adds, all markedreview:Dlss_Basis_Dynamic,Dlss_NeuralRendering_NotSeen,Dlss_Feature_NeuralRendering,Dlss_Basis_NeuralRendering_Format,Games_Filter_*,Games_Header_Filtered_Format,Filter_Clear,Compare_Filter_*,Compare_Count_Format,Compare_Count_Filtered_Format,Compare_ClearSelection,Compare_MidSession_Changed,A11y_Games_Filter_*,A11y_Compare_Filter_*. -
0.1.0-alpha.3 on real hardware (D73, D87). (a) The update from alpha.2: Help ▸ Check for updates offers alpha.3 and Restart to update installs it; say whether it downloaded the delta or the whole package. (b) The terms window shows the Disclaimer 2.13, the Privacy Policy 2.14 and the Alpha notice with its box again, and Accept waits for the tick. (c)
%LOCALAPPDATA%\FrameLedger\backups\ledger-before-0.1.0-alpha.3.dbexists beside alpha.2's, and opens; the ledger it left is at schema 22. (d) Item 30's checks, on the alpha. -
beta.35 on real hardware (D88–D91). (a) The update from beta.34 (or alpha.3's): no terms window, the ledger unchanged. (b) Narrator: a safety notice is read as it appears; the agent's banner going and coming; Tools ▸ Database maintenance ▸ Check reads its result; a short message at the bottom is read; H moves between each page's title and its sections; Settings ▸ Theme's options read their words; the Sessions table's cells read their values; Tab to a chart says its name and where its numbers are, and its arrows, Ctrl+arrows and A move it without scrolling the page; a double-click shows all of it. (c) Contrast themes: Aquatic and Desert, and one with an edited colour (Windows 10 if at hand) — every page, a dialog, the title bar's agent pill, a short message, a chart; turned on and off with FrameLedger open, it follows at once; Settings ▸ Theme shows its line. (d) Ctrl+1 … Ctrl+5 put the keyboard in the page and Narrator says its title. (e) Animation effects off (Settings ▸ Accessibility ▸ Visual effects): no page slides in. (f) Remove on a game's page: the box opens over the window, its Cancel puts the focus back on Remove; the light theme's agent pill and a done message read clearly. (g) Help ▸ Accessibility shows the statement. (h) The 35
jastrings this release adds, all markedreview:Menu_Help_Accessibility,Accessibility_Title,Settings_Theme_ContrastOnand 32A11y_*(the names, the chart names and keys, the announcements). -
Qodana, and beta.36 on real hardware (D93). (a) The update from beta.35: no terms window, the ledger unchanged. (b) The re-pointed bindings, by hand — the tests pin their text, not a click: on Games, a card opens its game and both Play buttons (card and list) start it, greyed in a viewer; on the Dashboard a recent session opens; on a game's page a session row's Open opens its summary; in a session's summary a Yes/No/N/A chip opens the override dialog; a safety notice's button dismisses it; Settings lists the hooked games with Revoke, the exception rows with Grant/Withdraw, and the system information lines. (c) Qodana Cloud: the trial's end changes nothing in CI (the Community linter needs no licence; the token names the project the report goes to). If an Ultimate licence is wanted — JetBrains has a programme for open-source projects —
13_CI_CD§Qodana says what moves. (d)qodanaas a required check, or not: advisory today, likesonarcloud. (e) The members nothing uses (13_CI_CD§Qodana, 34 and 49 getters): say which are dead, and a pull request removes them. -
beta.37 on real hardware — the first build on .NET 11's release (D94–D98). (a) The update from beta.36: Help ▸ Check for updates offers beta.37 and Restart to update installs it — a download of about 70 MB, not a few; the terms window shows the EULA 1.7 and the Disclaimer 2.14 once and nothing else; the ledger stays at schema 22. (b) A hooked session on .NET 11.0.0: one title you measure often, Tier 1 — frame times, the upscaler and frame generation as before; the Agent's log opens with
release line main, .NET 11.0.0, and Help ▸ About reads Runs on .NET 11.0.0. This is the run20_OPEN_QUESTIONS§G's table asked for before the move and did not get (D94). (c) The Agent in admin mode and the logon task still start it — the publish is self-contained on a new runtime. (d) Windows 10 22H2, if a PC or a VM with it is at hand: does it install and start? No version has ever been run there; D95 states it as untested, and one run would be the first evidence either way. (e) The Japanese of the three alpha strings that changed or are new (Alpha_Banner_Body_Format,Alpha_Banner_Body_Resting_Format,About_Runtime_Alpha_Format) and of the first-run summary's first line. (f) Going back — only if something is wrong: install beta.36 over it; the ledger opens. -
alpha.4 on real hardware — the last alpha for now (D98). (a) The update from alpha.3: Help ▸ Check for updates offers alpha.4 and Restart to update installs it — a large download, the runtime moving from the release candidate to 11.0.0. (b) The terms window shows the EULA 1.7, the Disclaimer 2.14 and the Alpha notice 1.1 and waits for the notice's box;
…\backups\ledger-before-0.1.0-alpha.4.dbexists beside the older copies, and opens; the ledger stays at schema 22. (c) The banner says the alpha line is paused and to install the beta — not the experimental-build warning — and Help ▸ About reads Alpha build — runs on .NET 11.0.0, with no "prerelease". (d) Then install beta.37 over it: the installer asks to replace it; the beta opens the ledger, shows no Alpha notice, and its update channel is no longer locked. Answered 2026-08-05, do not re-ask: removegameguardand keepguard(approved over a redRulesgate, with the reasoning recorded in the merge commit); vendor NVAPI headers andamd64/nvapi64.lib; Windows 11 is the measurement scope only —SupportedOSPlatformVersionstays at Win 10 22H2 and the D3DKMT two-OS requirement is deferred with a written rationale.
Decisions index
Where each owner decision is recorded — the file and its section, and a label to find it by. The decision itself is the text there, not this table.
| D | Recorded in | About |
|---|---|---|
| D1 | handoff/history/p2.md |
FrameLedger.Application gains a reference to FrameLedger.Shared (A); Domain still |
| D2 | handoff/history/p2.md |
never assigned — the numbering skips D2 and D3 (§P2 says so) |
| D3 | handoff/history/p2.md |
never assigned — see D2 |
| D4 | handoff/history/p2.md |
the Agent ships --console consent grant |
| D5 | handoff/history/p2.md |
FileGameConsentStore is retired in B; the CaptureHost writes a build-tree ledger.db |
| D6 | handoff/history/p2.md |
--data-dir exists only under --console (F; 12_BUILD §Debugging), so --serve can never |
| D7 | handoff/history/p2.md |
the FR-2.4 kill switch is the FOURTH input of HookedCaptureGate, not an upstream |
| D8 | handoff/history/p2.md |
FR-11 is NOT a consent precondition in P2 |
| D9 | handoff/history/p2.md |
P2 never clears hook_blocked_reason |
| D10 | handoff/history/p2.md |
the pipe (07_IPC) is P3, not P2; --serve is watcher-driven and logs |
| D11 | handoff/history/p3.md |
the pipe's transport |
| D12 | handoff/history/p3.md |
commands join as one more producer |
| D13 | handoff/history/p3.md |
SessionProgress is a third ICaptureObserver |
| D14 | handoff/history/p3.md |
Safety_ lives in FrameLedger.Shared, once |
| D15 | handoff/history/p3.md |
the App opens ledger.db directly, under 06_DATA_MODEL §Writer ownership: it writes games' |
| D16 | handoff/history/p3.md |
the settings registry (closes §G's row, written into 06_DATA_MODEL in PR-3): ui.language |
| D17 | handoff/history/p3.md |
FL_MOCK, if the owner wants it, is --serve --mock under --data-dir only (D6's shape), so a |
| D18 | handoff/history/0.1.0-beta.3.md |
the guard has one override, and its shape is fixed |
| D19 | handoff/history/0.1.0-beta.3.md |
the DLSS preset derived from the render scale is STILL not shown |
| D20 | handoff/history/0.1.0-beta.3.md |
the bug bundle does not get the machine's hardware |
| D21 | handoff/history/0.1.0-beta.4.md |
a process an anti-cheat driver protects is TargetUnreadable, and nothing offers a way past it |
| D22 | handoff/history/0.1.0-beta.5.md |
the per-game guard override (D18) is withdrawn; a finding about the game turns its hooking off |
| D23 | handoff/history/0.1.0-beta.5.md |
Tier 2 is a held session: duration, telemetry and the reason |
| D24 | handoff/history/0.1.0-beta.5.md |
a row follows its executable to another drive letter when exactly one other root holds it |
| D25 | handoff/history/0.1.0-beta.6.md |
a file name is not an identity |
| D26 | handoff/history/0.1.0-beta.6.md |
the Agent merges two entries for one executable under two drive letters |
| D27 | handoff/history/0.1.0-beta.6.md |
other bytes at the entry's path on another letter: the entry follows them with hooking off |
| D28 | handoff/history/0.1.0-beta.6.md |
HHW is measured through an entry pointed at swiftshader\Game.exe |
| D29 | handoff/history/0.1.0-beta.7.md |
a per-entry Recording switch (games.record_sessions) and the import's known-tools list |
| D30 | handoff/history/0.1.0-beta.8.md |
strict anti-cheat rules: any .sys in the install tree, and per-title lists |
| D31 | handoff/history/0.1.0-beta.8.md |
the store half's matrix |
| D32 | handoff/history/0.1.0-beta.8.md |
games blocked by anti-cheat: hide the hooking part, and scan the library ahead |
| D33 | handoff/history/0.1.0-beta.9.md |
the user-mode anti-cheat exception (CLAUDE.md rule 2, amended) |
| D34 | handoff/history/0.1.0-beta.10.md |
the admin mode asks Windows at EVERY Agent start |
| D35 | handoff/history/0.1.0-beta.10.md |
the tested-games list comes from a COPY of the owner's ledger (scratchpad, Python sqlit… |
| D36 | handoff/history/0.1.0-beta.10.md |
legal text changes where it would become false (Privacy 2.5, Disclaimer 2.8; EULA stays… |
| D37 | handoff/history/0.1.0-beta.10.md |
each PR merges when its CI is green, then the release PR and the GPG-signed tag |
| D38 | handoff/history/0.1.0-beta.11.md |
the user-mode exception's evidence moved under the grant, as a trial |
| D39 | handoff/history/0.1.0-beta.11.md |
charts across a game's sessions: both — Sessions at a glance on the Sessions tab, and A… |
| D40 | handoff/history/0.1.0-beta.11.md |
Delete all sessions: both places — the game's page and Settings ▸ Data |
| D41 | handoff/history/0.1.0-beta.11.md |
Refresh does all three: reload the library, offer the games the stores installed since,… |
| D42 | handoff/history/0.1.0-beta.11.md |
the library switches between a grid that fills the window and a list (ui.library_view) |
| D43 | handoff/history/0.1.0-beta.12.md |
the game's memory is measured from OUTSIDE the game, in both tiers |
| D44 | handoff/history/0.1.0-beta.12.md |
a user guide in English, guide/, rendered in the App (Help ▸ User guide), linked from t… |
| D45 | handoff/history/0.1.0-beta.12.md |
the legal split |
| D46 | handoff/history/0.1.0-beta.12.md |
documentation is corrected in place (struck, dated) with an index, docs/README.md; hist… |
| D47 | handoff/history/0.1.0-beta.14.md |
the update channel follows the running copy |
| D48 | handoff/history/0.1.0-beta.14.md |
the guard's narrow fix, both halves |
| D49 | handoff/history/0.1.0-beta.14.md |
all four metric groups |
| D50 | handoff/history/0.1.0-beta.14.md |
the managed binaries' identity |
| D51 | handoff/history/0.1.0-beta.15.md |
the scan set cuts a parent/child link only when it is proven wrong: both creation times… |
| D52 | handoff/history/0.1.0-beta.15.md |
the App's --data-dir is a viewer over a copy: no Agent is started or contacted (its com… |
| D53 | handoff/history/0.1.0-beta.17.md |
the wiki's source is the repository |
| D54 | handoff/history/0.1.0-beta.17.md |
the wiki's End-user half is the user guide, one source: it grows past D44's eight pages… |
| D55 | handoff/history/0.1.0-beta.19.md |
a game you uninstalled leaves the library by itself when it has no session (amends D41'… |
| D56 | handoff/history/0.1.0-beta.19.md |
an NW.js runtime is the import's game: an executable beside nw.dll + package.json ranks… |
| D57 | handoff/history/0.1.0-beta.21.md |
the four itch "launchers" are malware: the documentation is corrected, the import is no… |
| D58 | handoff/history/0.1.0-beta.21.md |
Wuthering Waves is on the title list (Steam 3513350, Anti-Cheat Expert), beside the fix… |
| D59 | handoff/history/0.1.0-beta.21.md |
Play, in two modes switched in Settings: "1: press Play → the platform opens → it runs;… |
| D60 | handoff/history/0.1.0-beta.23.md |
a game's artwork is what is already on the PC |
| D61 | handoff/history/0.1.0-beta.23.md |
the band takes the artwork's colour as far as every text on it reads: primary and secon… |
| D62 | handoff/history/0.1.0-beta.24.md |
the mix: every frame-generation state a session held, with its share, never averaged |
| D63 | handoff/history/0.1.0-beta.24.md |
the NVIDIA App's override is the quality mode where the driver reports it applied |
| D64 | handoff/history/0.1.0-beta.24.md |
DLSS labels are evidence-bound: versions and folder class, DLSS 4/4.5 only when shown, 5 only loaded |
| D65 | handoff/history/0.1.0-beta.25.md |
FSR's quality mode through ffxQuery — deferred from beta.24, built in beta.25; none at a dynamic resolution |
| D66 | handoff/history/0.1.0-beta.24.md |
the long documents are split; every original path stays as the index of its parts |
| D67 | handoff/history/0.1.0-beta.24.md |
SonarCloud stays on Automatic Analysis with .sonarcloud.properties; the owner marks in its UI |
| D68 | 13_CI_CD.md §SonarCloud |
SonarCloud is analysed from CI (ci.yml's sonarcloud job, SonarQube.Analysis.xml), with coverage; replaces D67 |
| D69 | 19_SAFETY_AND_ANTICHEAT.md §User-facing consent |
Enter enables once the consent phrase is typed exactly; before it Enter does nothing |
| D70 | 08_UI.md §Games › Trend |
the hardware-change markers are numbered badges, their changes listed under each chart, with a tooltip |
| D71 | 13_CI_CD.md §Dependabot and the NuGet audit |
Velopack and vpk 1.2.161 in beta.30 (item 24(d)'s Velopack half) |
| D72 | 13_CI_CD.md §Dependabot and the NuGet audit |
beta.31 takes the remaining updates inside the seven-day cooldown: .NET 10.0.14 packages, Markdig 1.5.0, CsWin32, Meziantou, coverlet 10.1.0, Catch2 3.16.1 |
| D73 | 12_BUILD.md §The alpha line |
the alpha line: a released beta's source on a prerelease .NET (.NET 11 RC3 first), on the alpha branch and Velopack's alpha channel; it replaces the beta, shares its data folder and copies the ledger before it first opens it |
| D74 | 08_UI.md §First-run flow |
the alpha's warning: the Alpha notice with its own tick box in the Legal Gate, the alpha's Agent waiting for it, an ALPHA badge and a banner, the update channel locked |
| D75 | ../legal/EULA.md §2B |
EULA 1.6 and Disclaimer 2.12 name alphas beside betas; the Alpha notice 1.0 approved with the plan |
| D76 | 12_BUILD.md §The alpha line |
alpha.1 is a retarget only: net11.0, C# 15 by LangVersion latest, three runtime-serviced packages; no preview feature, no C# 15 syntax |
| D77 | spike-notes/25-xbox-gdk.md |
the Xbox titles measured first, by package activation, read-only, each closed by its window; the decision table before the run |
| D78 | 19_SAFETY_AND_ANTICHEAT.md §The target must be able to take the Overlay |
GDK games only; an app-container (UWP) process is refused as TargetAppContainer, Tier 2 |
| D79 | 05_DETECTION.md §Platform signatures & metadata |
the platform is "Xbox" (xbox), in full: import, artwork, Play, capture, detection, docs and legal |
| D80 | 08_UI.md §Games |
Play on an Xbox game always activates its package, in both modes; the Agent answers PackagedGame and records it in attach mode |
| D81 | 20_OPEN_QUESTIONS.md §G |
title lists stay keyed by Steam id; an Xbox copy is matched by everything but that entry |
| D82 | handoff/history/0.1.0-beta.33.md |
alpha.2 right after beta.33; on RC3 unless the train reaches it after .NET 11 ships (then SDK 11.0.100, packages 11.0.0) |
| D83 | 05_DETECTION.md §DLSS generation |
the NVIDIA App's Dynamic frame generation, reported applied by the driver in a session where DLSS Frame Generation was identified, is DLSS 4.5 (amends D64) |
| D84 | 05_DETECTION.md §DLSS generation |
DLSS 5 heads the DLSS line where its neural rendering was measured running (kFeatureDLSS_NR, dlss_nr_pct); loaded only reads "runtime loaded" (amends D64) |
| D85 | 08_UI.md §Games, §Compare |
filters: Games — store, engine, state, installed, played; Compare — game, tier, frame generation (no period); Compare lists every session |
| D86 | 08_UI.md (the shell) |
the left pane's selected item keeps its label: our copy of WPF UI 4.3.0's LeftFluent item template |
| D87 | handoff/history/0.1.0-beta.34.md |
alpha.3 right after beta.34, on RC3 (before .NET 11's release, 2026-11-10) |
| D88 | ../ACCESSIBILITY.md |
the accessibility statement at the root, under Help ▸ Accessibility and on the wiki: WCAG 2.2 AA through WCAG2ICT is a goal, never a claim; reports by severity, no promised times |
| D89 | 08_UI.md §Screen readers |
what appears is said to a screen reader — notices, the agent's and the update's banners, the snackbars, a game page's notice, Database maintenance's results — while FrameLedger's window is active |
| D90 | 08_UI.md §Screen readers |
page titles heading 1, section titles heading 2; every chart named with where its numbers are; no series told apart by colour alone |
| D91 | 08_UI.md §Contrast |
Windows contrast themes are followed, whatever Settings ▸ Theme says |
| D92 | handoff/history/0.1.0-beta.35.md |
beta.35 in this train, no alpha; alpha.4 is the move to .NET 11's release (SDK 11.0.100, packages 11.0.0), a task of its own after 2026-11-10 |
| D93 | 13_CI_CD.md §Qodana |
Qodana Community for .NET from a workflow of its own (the organisation's licence is a 30-day trial, so not the Rider linter): a gate of zero problems, advisory; an inspection is switched off only in .editorconfig, with its reason |
| D94 | 12_BUILD.md §The main line's .NET |
the main line moves to .NET 11 with 0.1.0-beta.37, the day after it shipped; condition (a) of 20_OPEN_QUESTIONS §G's table — two alphas on the released runtime — set aside by the owner, not met |
| D95 | 02_SPEC.md NFR-8 |
Windows 10 22H2 is not blocked, and is stated as untested and unsupported (Microsoft supports .NET 11 on Windows 11); a processor needs SSE4.2 and POPCNT |
| D96 | 13_CI_CD.md §C# 15 and the analyses |
C# 15 on the main line from beta.37, a construct only where the build, CodeQL and Qodana read it — none of the four yet (Qodana's engine reads none, 2026-11-11), so beta.37 takes .NET 11's API and no syntax; no preview feature |
| D97 | ../legal/ALPHA_NOTICE.md |
an alpha is "a beta's source built to try a newer version of .NET, at times a prerelease one": EULA 1.7, Disclaimer 2.14 (with a paragraph on Windows and the processor), Alpha notice 1.1, approved with the plan; the App says "a prerelease .NET" only where the runtime is one |
| D98 | 12_BUILD.md §The alpha line |
alpha.4 is beta.37's source on .NET 11.0.0, and then the alpha line rests until a newer .NET has a preview; a resting alpha tells its user to install the beta |
| D99 | 13_CI_CD.md §Qodana |
Qodana for .NET on the Ultimate licence, in two reports from the start: the managed code to the Qodana Cloud project frameledger, the C++ to frameledger-cpp |
| D100 | 13_CI_CD.md §Qodana |
an inspection is switched off where the engine that raised it reads — ReSharper's in .editorconfig, the rest in qodana.yaml (amends D93); hints are off as a severity; in code loaded into a game only defects are fixed |
Keeping this file honest
It goes stale the moment it starts describing state. If you find yourself writing "X is
done" here, that belongs in CHANGELOG.md or §S24 — put it there and write a pointer.
The only things that belong here are: what to do next and in what order, why that
order, decisions that live in no other file, and traps.
Since 2026-10-19 (beta.24, D66) this file is split, and the split is kept up by the release: at each release
the previous START HERE section moves, verbatim, to docs/handoff/history/<version>.md and gets its row in
§How this file is split; an owner-only item the owner reports passed moves to handoff/owner-only-passed.md
with its number; a new decision gets its row in §Decisions index. tools/docs-split-check.ps1 holds the
history index and its files to each other.