Compare commits
10
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
8f4c5f90f1 | ||
|
|
653e2991db | ||
|
|
79f21422a3 | ||
|
|
80df94a934 | ||
|
|
53048ab2e0 | ||
|
|
944f827a2b | ||
|
|
6fbf1f4cbc | ||
|
|
101bbbe5e4 | ||
|
|
7756072af0 | ||
|
|
b7a03f0fce |
No files matched your search
+178
@@ -27,6 +27,161 @@ under a `## [x.y.z] - date` heading in the same commit that bumps `VERSION`, the
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
### Added
|
||||
|
||||
- **FrameLedger finds the anti-cheat games in your library on its own, and hides their hooking switch** (owner decision
|
||||
2026-09-25). The Agent now scans every game in the library for anti-cheat — once, and again whenever the rules or the
|
||||
game's executable change — where until now it scanned only a game someone asked to hook, so most games had never
|
||||
been scanned at all. A game it finds anti-cheat in has its hooking turned off for good, as any finding does, and a
|
||||
notice says so when hooking had been on. The library card says **Anti-cheat**; the game's page says what was found —
|
||||
"BattlEye — its module BEClient_x64.dll was loaded in the game", "Easy Anti-Cheat — its folder EasyAntiCheat ships
|
||||
with the game", in your language — in place of the Hooking switch, which could only be refused. Settings ▸ Capture ▸
|
||||
*Hide hooking on anti-cheat games* (on by default) brings the disabled switch back beside the finding. Sessions of
|
||||
such a game are still recorded, with play time and sensors. The scan reads the game's files only: it opens no process
|
||||
and decides nothing on its own — every session start still runs the full check. Schema 0010 adds three columns; the
|
||||
database opens in place, and the first scan of the library runs when the Agent starts.
|
||||
- **The game page has a Details card: what the game's files say about it.** Whether the executable is 64-bit (x64),
|
||||
32-bit (x86), ARM or .NET "any CPU"; its file and product versions; the store's build ("Steam build 20374416" — the
|
||||
subtitle labels it that way too, instead of a bare number); the engine; and the upscaler and frame-generation files
|
||||
it ships with their versions — "DLSS: nvngx_dlss.dll 3.7.10.0", Streamline, FSR, XeSS. FSR is named by its file: its
|
||||
DLL's version is the SDK's, and FrameLedger does not guess which FSR that is. The capture agent reads every game in
|
||||
the library once after the update. Schema 0011 adds four columns; the database opens in place.
|
||||
- **A session's summary lists the libraries the game had loaded** — recorded since the first beta and shown nowhere
|
||||
until now — and says when one differs from the copy the game ships ("nvngx_dlss.dll 310.2.1.0 (the game ships
|
||||
3.7.10.0: another copy was loaded, for example by the driver or the NVIDIA App)").
|
||||
- **A 32-bit game's hooking switch cannot be turned on, and the page says why**: FrameLedger's hook runs in 64-bit
|
||||
games only. Until now the switch turned on and every launch was refused by the guard. A 32-bit game whose hooking
|
||||
was already on has it turned off the first time the capture agent reads it; its sessions are still recorded, with
|
||||
play time and sensors.
|
||||
|
||||
### Changed
|
||||
|
||||
- **The anti-cheat blocklist names twenty-two families, twice as many, most through more than one signal.** New:
|
||||
EA AntiCheat, Activision Ricochet (`randgrid.sys` and its `atvi-randgrid_*` services — the family 19_SAFETY carried
|
||||
as "no data yet" since August), NetEase Anti-Cheat, NetEase Yidun, Nexon Game Security (BlackCipher), TenProtect,
|
||||
AhnLab HackShield, EQU8, Anybrain, FredaikisAntiCheat and Roblox Hyperion. Existing families gained the groups they
|
||||
lacked: BattlEye's driver `BEDaisy.sys` and its services, FACEIT's and ESEA's drivers and services, HoYoverse's
|
||||
`HoYoKProtect.sys` (which the `mhyprot` prefix never matched), Xigncode3's driver and service, Denuvo Anti-Cheat's
|
||||
driver, GameGuard's folder, files and service, EAC's `start_protected_game.exe` launcher and setup files. 19 entries
|
||||
became 74 (rules `2026.09.3`). Every new name is documented — SteamDB's file-detection rules (MIT), the vendors'
|
||||
support pages, LOLDrivers, DRML — and none is measured on a real title yet; each entry's `note` says which. Three
|
||||
services are deliberately left out because they run outside play and would refuse every session on the machine:
|
||||
`EAAntiCheatService`, PunkBuster's `PnkBstrA`, and Denuvo's update service.
|
||||
- **Check 3 is live in both halves, and the per-title lists are seeded** (rules `2026.09.4`, owner decision
|
||||
2026-09-25). The store half reads the store's own files through a seam the guard owns — `appmanifest_*.acf` in the
|
||||
Steam library that holds the game, `goggame-<id>.info` for GOG — so nothing is handed in by a caller and nothing is
|
||||
read from the game. 30 Steam app ids and 33 executable names across nine families are listed: Valve's VAC titles
|
||||
(CS2, Dota 2, TF2, Deadlock and the older ones), VALORANT and League of Legends, Roblox, Blizzard's online titles,
|
||||
Call of Duty, Marvel Rivals, NARAKA, FragPunk, Once Human, Delta Force, Arena Breakout: Infinite, HoYoverse's games,
|
||||
Battlefield 2042/6 and EA SPORTS FC 25/26 — the titles whose anti-cheat leaves nothing of the game's own for the
|
||||
other checks to find. A game no store names is not refused by this half; a Steam library whose manifests cannot be
|
||||
read is. Both lists are floored like the families, so a rules file can add a title and never take one off, and the
|
||||
validator refuses names engines share (`Game.exe`, `Client-Win64-Shipping.exe`…). The AreWeAntiCheatYet bulk list was
|
||||
considered and declined: community data that outlives a game's anti-cheat would turn hooking off for good.
|
||||
- **Any kernel driver in a game's folder counts as anti-cheat** (owner decision 2026-09-25). A `*.sys` file in the
|
||||
install tree that no rule names is reported as "Kernel driver in the game folder" and turns that game's hooking off,
|
||||
like any finding. Every driver found in a game so far was an anti-cheat's; this catches the next one before anyone
|
||||
names it. It is code, so no rules file can remove it — and a game that ships a driver for another reason loses
|
||||
hooking with no way back, which is the trade the owner took.
|
||||
- **FSR 3's and XeSS's DX11 libraries count as "Supports FSR" / "Supports XeSS"** (rules `2026.09.5`):
|
||||
`ffx_fsr3_x64.dll` / `ffx_fsr3upscaler_x64.dll` and `libxess_dx11.dll` matched no rule before.
|
||||
- **The guard holds 256 blocklist entries instead of 64** (2 × 74 no longer fitted the worst case of the compiled-in
|
||||
floor plus a drifted file). The parsed rules are ~530 KB, so they are now reset in place instead of being copied from
|
||||
a temporary: the Vulkan layer parses them on whichever of a game's threads creates its Vulkan instance, and a
|
||||
temporary that size on a small thread stack would crash the game. The native tests hold them on the heap.
|
||||
|
||||
### Fixed
|
||||
|
||||
- **Turning hooking on for an Unreal game now sees its `EasyAntiCheat` folder.** The scan that runs when hooking is
|
||||
enabled was given the executable's own folder — `<game>\<Project>\Binaries\Win64\` for Unreal titles — and scanned
|
||||
exactly that, while `EasyAntiCheat\` sits at the game's root. The session-time scan always looked at the root, so no
|
||||
injection was ever allowed by the gap, but the toggle could be switched on and the refusal came only at launch. The
|
||||
guard now takes the executable and finds the root itself, and also checks the executable's name and its store id.
|
||||
- **A game blocked for anti-cheat no longer offers "Turn hooking back on" after a crash auto-disable.** The button
|
||||
could only be refused.
|
||||
- **19_SAFETY's fixture rule is enforced for every family, not eleven.** A generated test walks every value of the
|
||||
shipped seed and requires it to match its own family in its own group — which also catches a later row that an
|
||||
earlier prefix shadows. The rules file's note that called XIGNCODE3's `x3.xem` "not a loadable module" is corrected:
|
||||
XIGNCODE3 loads it as its loader, so the modules group names it too.
|
||||
|
||||
## [0.1.0-beta.7] - 2026-09-23
|
||||
|
||||
**The seventh pre-release: a program in the library can be left unrecorded, and Steam's own tools already are.** The
|
||||
same unsigned installer: verify its hash against `SHA256SUMS.txt`, then *More info → Run anyway*. What changed for a
|
||||
user:
|
||||
|
||||
- **The game page has a Recording switch.** Off, FrameLedger does not watch for that program at all — no session, no
|
||||
measurement, no injection — and a session of it that is running stops; sessions already recorded stay. The library
|
||||
card says **Not recorded**. Use it for a utility that starts with Windows: until now every program in the library was
|
||||
recorded whenever it ran, at every boot.
|
||||
- **Steam's own tools already in your library start with it off** — Borderless Gaming, Wallpaper Engine, SteamVR,
|
||||
Blender, the Steam runtimes and Proton — so a tool imported before 0.1.0-beta.5 stops being recorded without you
|
||||
doing anything.
|
||||
- **The Privacy Policy (2.3) and the Disclaimer (2.6) are updated**, so the Legal Gate opens once after the update.
|
||||
|
||||
**Updating from `0.1.0-beta.6`:**
|
||||
|
||||
- Quit the App (tray icon → Exit) and end `FrameLedger.Agent.exe` before running the installer.
|
||||
- Schema 0009 adds one column; the database opens in place, and the Steam tools above are switched off once.
|
||||
- Sessions a tool recorded before stay in its history; to remove them, remove the entry with *Delete sessions too* —
|
||||
the import will not add it again.
|
||||
|
||||
### Added
|
||||
|
||||
- **A library entry can be left unrecorded.** Borderless Gaming starts with Windows, and every program in the library
|
||||
was recorded whenever it ran — so each boot added a session of it, for as long as it ran, to the playtime totals. The
|
||||
game page now has a **Recording** switch: off, FrameLedger does not watch for that program at all — no session, no
|
||||
measurement, no injection — and a session of it that is running stops (sessions already recorded stay). The library
|
||||
card says **Not recorded**. Entries an earlier import made for Steam's own tools (Borderless Gaming, Wallpaper Engine,
|
||||
SteamVR, Blender, the Steam runtimes and Proton) start with it off; the import has skipped them since 0.1.0-beta.5.
|
||||
The Privacy Policy (2.3) says so — a program whose recording is off is not watched — and the Disclaimer (2.6) carries
|
||||
the updated accuracy statement, including the correction made in 0.1.0-beta.6; the Legal Gate shows both once after
|
||||
the update. Schema 0009 adds one column; the database opens in place.
|
||||
|
||||
## [0.1.0-beta.6] - 2026-09-23
|
||||
|
||||
**The sixth pre-release: a game is recorded under its own entry, one entry per game after a drive changes its
|
||||
letter, a game that is not measured is shown while it runs, and RE Engine and FromSoftware games are detected.** The
|
||||
same unsigned installer: verify its hash against `SHA256SUMS.txt`, then *More info → Run anyway*. What changed for a
|
||||
user:
|
||||
|
||||
- **Another game's `Game.exe` is no longer recorded under your entry.** A process that matches an entry by file name
|
||||
only starts nothing — unless it is that entry's own executable on a drive that changed its letter — so an RPG Maker
|
||||
game can no longer be recorded under another RPG Maker game's name, twice, as *HELLO, HELLO WORLD!* was under
|
||||
*Flower in Us*.
|
||||
- **A game that is not measured is shown while it runs.** Hooking off, refused by the guard, or a process Windows
|
||||
would not open: the Dashboard shows the game, the time and the temperatures, says why nothing is measured, and the
|
||||
tray turns to recording-only — until now it said "Nothing is being captured." for as long as the game ran.
|
||||
- **One entry per game when a drive changes its letter.** Two entries for the same executable under two letters
|
||||
merge on their own (the older one stays, with both histories); a game updated while its drive had another letter is
|
||||
followed with hooking off; the library import no longer adds a game again under the new letter.
|
||||
- **A game removed while it runs keeps its session** (under the entry that holds its executable), and a session file
|
||||
left behind can no longer stop the Agent at every start.
|
||||
- **RE Engine and FromSoftware games are detected**, engines are shown by name, and a game added by hand whose
|
||||
executable is `Game.exe` is named after the game.
|
||||
|
||||
**Updating from `0.1.0-beta.5`:**
|
||||
|
||||
- Quit the App (tray icon → Exit) and end `FrameLedger.Agent.exe` before running the installer.
|
||||
- No schema change; the database opens in place. Every game is re-detected once (rules `2026.09.2`).
|
||||
- Session files in `%LOCALAPPDATA%\FrameLedger\tmp` that beta.5 could not store are stored at the Agent's first start —
|
||||
under the entry that holds their executable — or dropped with a line in `agent-*.log`; the Agent keeps running either
|
||||
way.
|
||||
- An entry that a beta.5 file-name match created for another game keeps its wrong name until you rename it (*Edit…*)
|
||||
or remove it; its executable path says which game it is.
|
||||
- A game whose **folder** moved — not only its drive letter — now records nothing until *Change executable* points its
|
||||
entry at the new file.
|
||||
|
||||
### Added
|
||||
|
||||
- **RE Engine and FromSoftware games are detected.** Capcom's RE Engine titles (RESIDENT EVIL 2/3/4/7/Village, Devil
|
||||
May Cry 5, Monster Hunter Rise/Wilds, Street Fighter 6, Dragon's Dogma 2, Onimusha…) by their `re_chunk_000.pak`
|
||||
archive; FromSoftware's (DARK SOULS II/III, ELDEN RING, Sekiro…) by their `.bhd` + `.bdt` archive pairs. Both are
|
||||
relative signals — a file layout, not a proof — like every engine rule. Every game in the library is re-detected on
|
||||
the next sweep. Engines are now shown by name ("RPG Maker MV/MZ", "Unreal Engine") instead of the rule's id
|
||||
(`rpgmaker_mv`). A game added by hand whose executable says nothing (`Game.exe`) is named after the game — RPG
|
||||
Maker's own title when the folder carries one, else its folder — instead of "Game".
|
||||
|
||||
### Fixed
|
||||
|
||||
- **Another game's `Game.exe` no longer runs under a library entry — no wrong name, no second session.** On
|
||||
@@ -43,6 +198,16 @@ under a `## [x.y.z] - date` heading in the same commit that bumps `VERSION`, the
|
||||
*Change executable* points its entry at the new file. The "Flower in Us" entry the old match created stays until you
|
||||
rename it (it points at HHW's `swiftshader\Game.exe`, the file to measure HHW by) or remove it.
|
||||
|
||||
- **One entry per game after a drive letter changes — the two side by side become one.** When the owner's USB drive
|
||||
came back as `H:` for a morning, a second entry was made for each game played from it, and once the letter was back
|
||||
neither entry could move onto the other's path: two of each game, and "could not be moved" in the log every 15 s.
|
||||
Now the Agent merges two entries for the same executable (same path on two letters, same size and modification
|
||||
time): the entry made first stays, the other's sessions join it, a block on either is kept, and no consent moves
|
||||
between them — it waits while either game runs. A game whose executable changed on the new letter (it was updated
|
||||
meanwhile) is followed with hooking off, as *Change executable* does; turn hooking on again to measure it. The
|
||||
library import no longer adds a game again when it is already in the library under another drive letter. And a
|
||||
database error during the Agent's 15 s library pass no longer stops the Agent.
|
||||
|
||||
- **A game removed from the library while it runs no longer loses its session — or stops the Agent at the next
|
||||
start.** On 2026-09-22 23:26 and 2026-09-23 00:25 a GIRLS' FRONTLINE 2 session ended `FAULTED` on the database's
|
||||
foreign key: its entry had been removed (and re-imported) while the game ran, and the session was written under the
|
||||
@@ -54,6 +219,19 @@ under a `## [x.y.z] - date` heading in the same commit that bumps `VERSION`, the
|
||||
report, and the next file is recovered. The `FAULTED` and end-of-session log lines now name the session, the game and
|
||||
its executable, and the Agent's host logs its own warnings and errors into `agent-*.log`.
|
||||
|
||||
- **A game that is recorded without measuring is shown while it runs.** A game with hooking off, one the guard
|
||||
refused, or one whose process could not be read is recorded (duration, sensors, the reason) since beta.5 — but the
|
||||
Agent announced only hooked sessions, so for as long as such a game ran the Dashboard said "Nothing is being
|
||||
captured." and the tray stayed idle. Now the live card shows it with the T2 badge, the elapsed time, the
|
||||
temperatures, "Recording duration and sensors only — nothing is measured." and why, in the sentence its summary will
|
||||
use (no FPS readout: nothing is measured, so nothing is shown); the tray turns to recording-only; the refusal notice
|
||||
appears when the game starts rather than when it exits. A Dashboard opened after a game started shows it at once
|
||||
(it used to wait for the next start), a session running when the App connects is in the tray, the notice after a
|
||||
session names that session's game (it could name the previous one), a session that fails is let go of instead of
|
||||
staying on the card, and an update downloaded after a session ends is ready to install instead of waiting for the
|
||||
App to reconnect. A game whose executable changed since hooking was turned on — after a store update, usually — now
|
||||
says so in its summary instead of `RefusedConsentMissing`.
|
||||
|
||||
## [0.1.0-beta.5] - 2026-09-22
|
||||
|
||||
**The fifth pre-release: the guard override is gone, Tier 2 exists, and a drive that changes its letter is followed.**
|
||||
|
||||
@@ -5,11 +5,12 @@
|
||||
> No telemetry. No accounts. All data stays on your machine.
|
||||
|
||||
<!-- accuracy-block:begin -->
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-09-22.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.5`** (2026-09-22), an unsigned installer built from that tag with its
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-09-23.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.7`** (2026-09-23), an unsigned installer built from that tag with its
|
||||
> checksums published beside it. The source holds the desktop app
|
||||
> (library, store import, charts, settings) and the background Agent, which records a session when a
|
||||
> game in the library runs, injects only into games you enabled and only past the safety guard, and
|
||||
> game in the library runs (unless you switched its recording off), injects only into games you enabled
|
||||
> and only past the safety guard, and
|
||||
> stores sessions in a local database. What that path measures:
|
||||
>
|
||||
> - **Frame times and output resolution:** measured from the present call for Direct3D 11/12 and
|
||||
@@ -22,8 +23,8 @@
|
||||
> NVIDIA Streamline (with Ray Reconstruction Yes/No), and FSR through AMD's shipped FidelityFX DLLs:
|
||||
> named FSR 3 from the older DLLs, and FSR without a version from the newer ones, which host both
|
||||
> FSR 3.1 and FSR 4. FSR 2, and FSR shipped any other way, is not identified. For DLSS titles that
|
||||
> bypass Streamline, the NVIDIA driver's own per-process record is stored with the session, labelled
|
||||
> *driver-reported*; the app does not display it yet. Intel XeSS is **not** read (its SDK licence
|
||||
> bypass Streamline, the NVIDIA driver's own per-process record is stored with the session and shown
|
||||
> as *DLSS (driver-reported)*. Intel XeSS is **not** read (its SDK licence
|
||||
> forbids it), and neither is an upscaler compiled into the game: those read `N/A`, or "Unknown
|
||||
> upscaler" when another vendor's hook ran in the game. Vulkan and OpenGL titles read `N/A`.
|
||||
> - **Quality preset:** not reported on any title measured. The one route this software may use — the
|
||||
@@ -136,7 +137,7 @@ Elevation is **optional — for everything.** Hooked capture is the normal path
|
||||
|
||||
## Install
|
||||
|
||||
> **The latest pre-release is `v0.1.0-beta.5` (2026-09-22); before it `v0.1.0-beta.4` (2026-09-21), `v0.1.0-beta.3` (2026-09-21), `v0.1.0-beta.2` (2026-09-17) and `v0.1.0-beta.1` (2026-09-16).** They are pre-releases: read `CHANGELOG.md`'s section for the one you install — what it measures, what it does not yet, and how to update — before installing. A source build is `docs/12_BUILD.md`.
|
||||
> **The latest pre-release is `v0.1.0-beta.7` (2026-09-23); before it `v0.1.0-beta.6` (2026-09-23), `v0.1.0-beta.5` (2026-09-22), `v0.1.0-beta.4` (2026-09-21), `v0.1.0-beta.3` (2026-09-21), `v0.1.0-beta.2` (2026-09-17) and `v0.1.0-beta.1` (2026-09-16).** They are pre-releases: read `CHANGELOG.md`'s section for the one you install — what it measures, what it does not yet, and how to update — before installing. A source build is `docs/12_BUILD.md`.
|
||||
|
||||
1. Download the latest `FrameLedger.App-win-Setup.exe` from [Releases](https://github.com/poli0981/frameledger/releases). It installs into `%LOCALAPPDATA%\FrameLedger.App`; your data stays in `%LOCALAPPDATA%\FrameLedger`, and uninstalling asks before touching it.
|
||||
2. SmartScreen may warn — releases are not code-signed (free, open-source project). Verify the SHA-256 checksum published with each release, then **More info → Run anyway**.
|
||||
@@ -164,4 +165,4 @@ If you find a game with anti-cheat that FrameLedger fails to detect, please open
|
||||
|
||||
---
|
||||
|
||||
**Status:** pre-release (beta). Five tagged pre-releases so far; see `CHANGELOG.md` for what each one changed and the accuracy block at the top of this file for what is and is not measured. It is not feature-complete, it certainly still has bugs, and `legal/DISCLAIMER.md` §0 says what that means for you.
|
||||
**Status:** pre-release (beta). Seven tagged pre-releases so far; see `CHANGELOG.md` for what each one changed and the accuracy block at the top of this file for what is and is not measured. It is not feature-complete, it certainly still has bugs, and `legal/DISCLAIMER.md` §0 says what that means for you.
|
||||
+3
-2
@@ -10,13 +10,14 @@ Requirement IDs (`FR-x`, `NFR-x`) are referenced by other docs, commits, and tes
|
||||
- FR-1.3 Editable metadata (name, cover, publisher, version, notes); auto-detected fields badged and overridable.
|
||||
- FR-1.4 Remove game (asks whether to keep or delete its sessions).
|
||||
- FR-1.5 "Supports" row shows shipped-capability hints (DLSS/FSR/XeSS/FG) — visually distinct from measured per-session values (`05_DETECTION` §Capability hints).
|
||||
- FR-1.6 Recording switch per entry (2026-09-23, HANDOFF D29): off, the program is not watched at all — no session, no measurement, no injection — and a session of it that is running stops. On by default; entries an old import made for Steam's own tools start with it off. The library card says "Not recorded".
|
||||
|
||||
### FR-2 Hooking consent & control (new, safety-critical — see `19_SAFETY`)
|
||||
- FR-2.1 Hooking is **off by default for every game**. Enabling requires a per-game consent dialog stating what is injected, why, and the anti-cheat/ban risk.
|
||||
- FR-2.2 The static anti-cheat pre-scan disables the toggle outright for titles shipping anti-cheat; the reason is shown and the control is not clickable.
|
||||
- FR-2.2 The static anti-cheat pre-scan disables the toggle outright for titles shipping anti-cheat; the reason is shown and the control is not clickable. Since 2026-09-25 (beta.8, owner decision) the Agent runs that pre-scan over every library entry itself — once per rules version and executable, whether or not hooking was ever asked for — and by default the game's page shows only the finding in place of the Hooking card (Settings: *Hide hooking on anti-cheat games*, `ui.hide_anticheat_hooking`); the library card says "Anti-cheat". The reason is always on the page (`19_SAFETY` §What a finding does to the game).
|
||||
- FR-2.3 The runtime guard refuses injection and refuses to continue a session when anti-cheat is detected. **No override exists anywhere in the UI, config, or CLI.**
|
||||
- FR-2.4 Global "disable all hooking" kill switch in Settings; also honored by the Vulkan layer.
|
||||
- FR-2.7 (owner decision 2026-09-22; it was a per-game override for one day, withdrawn) A finding about a game — anti-cheat named in its process, on its title lists or in its folder — turns hooking off for that game wherever the guard makes it: at the pre-scan, at a session's start, or at the 30 s re-scan. The row carries the reason, the game's page and the notice say so, and nothing overrides it (`19_SAFETY` §What a finding does to the game).
|
||||
- FR-2.7 (owner decision 2026-09-22; it was a per-game override for one day, withdrawn) A finding about a game — anti-cheat named in its process, on its title lists or in its folder — turns hooking off for that game wherever the guard makes it: at the pre-scan, at a session's start, at the 30 s re-scan, or (since 2026-09-25) at the Agent's pre-scan of the library. The row carries the reason, the game's page and the notice say so, and nothing overrides it (`19_SAFETY` §What a finding does to the game).
|
||||
- FR-2.5 Repeated crashes shortly after injection auto-disable hooking for that game, with an explanation and a manual re-enable path.
|
||||
- FR-2.6 Users can always see, per session, which tier produced the data.
|
||||
|
||||
|
||||
@@ -160,6 +160,16 @@ which makes the notification more important than it was, not less.
|
||||
> (`05_DETECTION` §Caching) on its own task, because `GameFileProbe` blocks on file I/O and the 1 Hz poll must
|
||||
> not wait on it. It reads game files and writes the detected columns of `games`; it never touches a process,
|
||||
> a hook, or a consent column.**
|
||||
>
|
||||
> **The watchlist is the entries whose recording is on (2026-09-23, FR-1.6, D29).** Borderless Gaming starts with
|
||||
> Windows on the owner's machine, and since Tier 2 exists every library entry that runs gets a session — one per boot,
|
||||
> for as long as the utility ran, in the playtime totals. `games.record_sessions = 0` (schema 0009, the user's switch on
|
||||
> the game page) takes an entry out of the watchlist `PollOnceAsync` hands the watcher, and out of the launch election's
|
||||
> tracked set: its process appearing is no event, no session and no log line. Switched off while a session of it runs,
|
||||
> the orchestrator cancels that session's stop token at its next poll — the loop ends as a user stop and saves what it
|
||||
> had — and `LaunchGame` answers `RecordingOff`. Switched back on, a process that is still running is picked up by
|
||||
> the next poll (a pid the watcher never matched is new to it). Detection and the drive-letter relocator still follow
|
||||
> the entry; they read files, not processes.
|
||||
|
||||
## Launch mode vs attach mode
|
||||
|
||||
@@ -424,6 +434,13 @@ Crash-within-60s-of-injection happening twice for the same game ⇒ **hooking au
|
||||
> stands alone with the census qualifier (`FgLadder.PresentedQualifier`, the row's). CPU temperature is null until the Agent composes a
|
||||
> CPU sensor, and every other unmeasured field is null, never 0. Rate-limited to 1 Hz inside the observer's `Tick`, computed only while
|
||||
> a client is connected, and a fault in the computation is counted rather than allowed to end the session.
|
||||
>
|
||||
> **A held session is live too (2026-09-23).** The hold's ticks carry the refusal (`CaptureProgress.Held`, with the pid the loop
|
||||
> holds, 0 for a hooking-off hold that never opened the process). The publisher's first held tick announces the session —
|
||||
> `SessionStarted` at tier 2 with its `hold`, and the refusal's own event at once rather than when the game exits — and every tick
|
||||
> after feeds `SessionHeld` (elapsed and sensors, nothing measured) at the same 1 Hz while a client listens. It is never run through
|
||||
> `SessionProgressCalculator`, whose window over no records would still emit a qualifier. A session whose task faults now also
|
||||
> completes on the pipe (`finalize: faulted`, `07_IPC`), so nothing is left shown as running.
|
||||
|
||||
## Overhead rules (NFR-1)
|
||||
|
||||
|
||||
+56
-4
@@ -137,6 +137,8 @@ Recorded as a residual risk, not as a solved problem.
|
||||
| GameMaker | `data.win` | `N/A` |
|
||||
| RPG Maker MV/MZ | `nw.dll` **and** `package.json` siblings (since 2026-09-16) | `N/A` — the `.js` header needs a `from` that `strings_regex` lacks |
|
||||
| RPG Maker XP/VX/VX Ace | `RGSS1*`/`RGSS2*`/`RGSS3*.dll` sibling **or** a `*.rgssad`/`*.rgss2a`/`*.rgss3a` archive (since 2026-09-16) | `N/A` — one rule, the variant unnamed |
|
||||
| RE Engine (Capcom) | `re_chunk_000.pak` sibling, the exact name (since 2026-09-23) | `N/A` |
|
||||
| FromSoftware | a `*.bhd` **and** a `*.bdt` sibling (since 2026-09-23) | `N/A` |
|
||||
| Ren'Py | `renpy/` dir **or** `*.rpa` | `renpy/__init__` strings / `log.txt` first line |
|
||||
| CryEngine | `CrySystem.dll` | FileVersion |
|
||||
| Source | `gameinfo.txt` + `bin/engine.dll` | `N/A` |
|
||||
@@ -160,6 +162,25 @@ Order matters (first match wins). Engine is user-overridable.
|
||||
> `every_engine_marker` canary carries both engines' markers and still expects `unity`. `rulesVersion` is
|
||||
> `2026.09.1`, so the sweep's cache key changes and every game is re-detected on the next pass.
|
||||
|
||||
> **RE Engine and FromSoftware, 2026-09-23 (owner request, "mang tính tương đối" — a relative signal, not a proof).**
|
||||
> Both are file-layout signals, checked on the owner's disk before they were written. **RE Engine:** every Capcom RE
|
||||
> Engine title ships its content as `re_chunk_000.pak` beside the executable, with patches as
|
||||
> `re_chunk_000.pak.patch_00N.pak` (RESIDENT EVIL 2 and the Onimusha demo). The rule names the base archive exactly — a
|
||||
> glob without a star is the whole leaf name — so a patch archive alone is not it. **FromSoftware:** the studio's
|
||||
> titles keep their data as `.bhd` header + `.bdt` data pairs beside the executable — DARK SOULS II
|
||||
> (`GameDataEbl.bhd/.bdt`), DARK SOULS III (`Data0`–`Data5`), ELDEN RING (`Data0`–`Data3`, plus `DLC`) and Sekiro
|
||||
> (`Data1`–`Data5`). The request described the second extension as `.bht`; on disk it is **`.bdt`**. An `all` group
|
||||
> over the two globs — half a pair is not a pair. The request also described a `<Game>\Game\` layout; it is not a
|
||||
> signal here, because Sekiro has no `Game\` folder and "the parent folder is named X" is not a signal type anyway.
|
||||
> None of the owner's other 80 Steam titles carries either marker. Both rules sit after the RPG Maker rules and
|
||||
> before `godot`, whose `*.pck` would also match a loose Wwise sound bank (an `Unknown` there would stop the walk
|
||||
> before these rules). Fixtures `engines/re_engine` and `engines/fromsoftware`; the `every_engine_marker` canary
|
||||
> carries both engines' markers and still expects `unity`. `rulesVersion` is `2026.09.2`, so every stored game is
|
||||
> re-detected on the next sweep. Engine detection never feeds the guard: ELDEN RING stays refused by its anti-cheat
|
||||
> whatever engine it is shown as. **Engines are shown by name since the same date** (`Formats.Engine` in the App —
|
||||
> proper nouns, not resources; an unknown id, or one the user typed, passes through): the game card and page used
|
||||
> to show the raw id (`rpgmaker_mv`).
|
||||
|
||||
⛔ *(kept for the record — the two rows above were the ones this note described)* **Two rows cannot be expressed in schemaVersion 2**, and are documented rather than half-implemented — a rule that exists but never fires is worse than one that is absent, because it reads as coverage:
|
||||
|
||||
- ~~**RPG Maker MV/MZ.** The signal is `nw.dll` **and** (`www/` **or** `package.json`) — a nested group, and `signalGroup` sets `maxProperties: 1` with its own `$comment` saying nesting is unsupported in v2.~~ Its version is a header inside a sibling `.js`, and `strings_regex` carries no `from`, so it cannot be aimed at a file other than the executable.
|
||||
@@ -214,7 +235,7 @@ Everything else in the table is in the data and has a fixture; `rules-validate.p
|
||||
> is fetched (CLAUDE.md rule 8's "opt-in store metadata" is the online lookup, which does not exist). First-run
|
||||
> step 4 now points at File ▸ Import library… rather than saying "later build".
|
||||
|
||||
**Publisher/version order:** store manifest → PE `CompanyName`/`ProductVersion` → *(opt-in)* Steam `appdetails` lookup, cached 7 days.
|
||||
**Publisher/version order:** store manifest → PE `CompanyName`/`ProductVersion` → *(opt-in)* Steam `appdetails` lookup, cached 7 days. *(Since beta.8 the PE versions are stored beside the store's rather than instead of it — §What the files say about themselves; the page labels a store's value with its store, "Steam build 20374416".)*
|
||||
|
||||
## Capability hints (explicitly labelled as such)
|
||||
|
||||
@@ -222,8 +243,8 @@ Files shipped with a game tell us what it *supports*. These populate a **"Suppor
|
||||
|
||||
- DLSS SR `nvngx_dlss.dll` · DLSS-G `nvngx_dlssg.dll` · **Ray Reconstruction `nvngx_dlssd.dll`**
|
||||
- Streamline `sl.interposer.dll`, `sl.dlss_g.dll`, `sl.reflex.dll`
|
||||
- FSR `ffx_fsr2_*.dll`, `ffx_frameinterpolation_*.dll`, `amd_fidelityfx_*.dll`, `ffx_api*.dll` — a hint still, even though `amd_fidelityfx_dx12.dll` / `_upscaler_dx12.dll` / `_framegeneration_dx12.dll` are *hooked* since 2026-09-04: the measured chip comes from the dispatch, never from the file
|
||||
- XeSS `libxess.dll`, XeFG `libxess_fg.dll`
|
||||
- FSR `ffx_fsr2_*.dll`, `ffx_fsr3*.dll` (since rules 2026.09.5 — FSR 3's `ffx_fsr3_x64.dll` / `ffx_fsr3upscaler_x64.dll` matched nothing before), `ffx_frameinterpolation_*.dll`, `amd_fidelityfx_*.dll`, `ffx_api*.dll` — a hint still, even though `amd_fidelityfx_dx12.dll` / `_upscaler_dx12.dll` / `_framegeneration_dx12.dll` are *hooked* since 2026-09-04: the measured chip comes from the dispatch, never from the file
|
||||
- XeSS `libxess.dll`, `libxess_dx11.dll` (since rules 2026.09.5), XeFG `libxess_fg.dll`
|
||||
- DXR-capable: `d3d12.dll` usage + RT-capable GPU (capability only — says nothing about the game)
|
||||
- **Vulkan (since P4 PR-2, 2026-09-14) — a code-level fact, not a rule.** The rules can only ask about files
|
||||
beside the executable, and the Vulkan loader is not one of them (`vulkan-1.dll` lives in System32). So
|
||||
@@ -236,11 +257,42 @@ Files shipped with a game tell us what it *supports*. These populate a **"Suppor
|
||||
|
||||
The UI wording is deliberate: **"Supports DLSS-G"** (capability, from files) versus **"Frame Generation: DLSS-G ×1.9"** (measured, from this session). Users conflating these is exactly the confusion the old design created.
|
||||
|
||||
### What the files say about themselves (beta.8, 2026-09-25, schema 0011)
|
||||
|
||||
The owner asked for the game's version, the DLSS / FSR versions and whether a game is 32- or 64-bit. The sweep read
|
||||
most of it already and kept none of it; since beta.8 it keeps four more facts per game, written whole with each
|
||||
detection (`DetectionWrite`, `games.exe_machine` / `exe_file_version` / `exe_product_version` / `library_versions`):
|
||||
|
||||
- **What the executable runs as** — `PeImports.ReadArchitecture`, from the same bounded header read as the imports:
|
||||
the COFF machine and, for a .NET executable, the CLR header's flags (`Domain.Detection.ExecutableArchitecture`:
|
||||
`x64 | x86 | arm64 | arm | anycpu | anycpu32 | other | unknown`). An "AnyCPU" assembly carries an I386 machine and
|
||||
runs as a 64-bit process unless it prefers or requires 32-bit, which is why the machine alone is not the answer.
|
||||
`x86`, `anycpu32`, `arm64` and `arm` are **known not hookable** — the hook is an x64 DLL loaded with `LoadLibraryW`
|
||||
(CLAUDE.md rule 3) — so enabling hooking on one is refused before anything is scanned or stamped
|
||||
(`Refused { reason: "ExecutableNotX64", signal: <id> }`, `07_IPC`), and a row enabled before this build read the file
|
||||
has its hooking turned off by the sweep (`hook_autodisabled_reason` = `executable is x86: the hook runs in x64
|
||||
processes only`). `unknown` and `other` are not: the guard's `TargetIsWow64` at a session's start stays the check.
|
||||
A row whose `exe_machine` is NULL is stale once, so every library entry is read under this build.
|
||||
- **The executable's own versions** — the PE `FileVersion` and `ProductVersion` strings. The file's word, kept apart
|
||||
from `game_version`, which is the store's (a Steam build id, a GOG or Epic version string) or the user's. For an
|
||||
Unreal title the file version is often the *engine's*; the page labels both and does not pick one.
|
||||
- **What it ships, with versions** — every file a capability rule names among those the walk listed, with the
|
||||
numeric version of its `VS_FIXEDFILEINFO` (the version *string* may carry text, and Streamline stamps `2,8,0,0`):
|
||||
`nvngx_dlss.dll 3.7.10.0`, `sl.interposer.dll 2.8.0.0`, `ffx_fsr2_api_x64.dll …`. Bounded at 48 files. A file with
|
||||
no version resource is listed with none — it is shipped either way. FSR is named by its file, never mapped to an
|
||||
"FSR 2.2" number: the DLL's version is the SDK's, and no table of that mapping has been measured.
|
||||
|
||||
**Shipped is not loaded.** `library_versions` is what the game folder holds. What the process loaded is
|
||||
`sessions.runtime_modules` (Tier 1), and the two differ exactly when something else supplied the DLL — the NVIDIA
|
||||
App's DLSS override loads the driver's `nvngx_dlss.dll` from the driver store under the same name. The session
|
||||
summary prints the loaded list and names such a difference ("the game ships 3.7.10.0: another copy was loaded");
|
||||
it does not claim who loaded it.
|
||||
|
||||
## Anti-cheat pre-scan (static)
|
||||
|
||||
Before a game is ever launched with hooking enabled, the static scan checks for anti-cheat SDKs shipped alongside it (`EasyAntiCheat/` directory, BattlEye binaries, EOS anti-cheat components, etc.). A hit **disables the hooking toggle for that game entirely** in the UI, with an explanation — the user cannot enable it, so the guard never even has to fire at launch. Prevention beats interception.
|
||||
|
||||
**Implemented in the native guard, not here** (`fl_prescan.cpp`, exposed as `FlStaticPreScan`). It uses the same `MatchName` and the same rules file as the injection guard, matching directory names against the `anticheat.directories` group and file names against `anticheat.files`. Nothing managed matches a blocklist (§S15 item 1).
|
||||
**Implemented in the native guard, not here** (`fl_prescan.cpp`, exposed as ~~`FlStaticPreScan`~~ `FlStaticPreScanGame` since 2026-09-25, which takes the executable, resolves the install root itself and runs check 3 as well). It uses the same `MatchName` and the same rules file as the injection guard, matching directory names against the `anticheat.directories` group and file names against `anticheat.files`. Nothing managed matches a blocklist (§S15 item 1).
|
||||
|
||||
Three things this section previously implied that are not true, and are worth stating:
|
||||
|
||||
|
||||
+33
-2
@@ -2,7 +2,7 @@
|
||||
|
||||
`%LOCALAPPDATA%\FrameLedger\ledger.db`. Pragmas: `journal_mode=WAL`, `synchronous=NORMAL`, `foreign_keys=ON`, `busy_timeout=5000`. `Microsoft.Data.Sqlite` + Dapper; all writes in explicit transactions.
|
||||
|
||||
**Writer ownership:** Agent writes `sessions`, `session_segments`, `frame_blobs`, `sensor_blobs`, `hardware_snapshots`, the hook-state columns on `games`, **and since P4 PR-1 (2026-09-14) the *detected* columns on `games`** — `engine`, `engine_version`, `platform` under the per-field provenance rule (`05_DETECTION` §Caching: a `user` field is never touched), `capability_flags` whole, and the cache key `detection_rules_version` / `detection_exe_size_bytes` / `detection_exe_mtime_ms` — through `IGameRepository.ApplyDetectionAsync` only. The UI and the Agent were both already writers of `games`; this adds columns to the Agent's half, not a third writer (HANDOFF §P4). **And since P4 PR-4 the UI's library import writes `platform`, `store_id` and `game_version` through `ApplyStoreMetadataAsync`** — the same per-field provenance rule, badged `detected` (a store's record is not the user's typing), on columns the UI already owned. **Maintenance (P4 PR-7) adds no writer:** the retention sweep on demand is the Agent's, asked over the pipe; the UI's `VACUUM` rewrites pages with the same contents and changes no row (§Retention built note). UI writes `games` (user-editable fields — since P3 PR-3 that is the FR-1.3 metadata, the `*_default` tri-states, and `removed_at`; never a `hook_*` column), `session_annotations` (tags, notes, and since schema 0002 the FR-8.3 overrides — which is WHY they are on this table and not on `sessions`), `settings`, `legal_acceptance`. Both read everything. The ports say the same in their names: `IGameRepository.UpdateMetadataAsync` / `SetTriStateDefaultAsync` / `RemoveAsync`, `ISessionAnnotationRepository`, `RegisteredSettings`, `ILegalAcceptanceStore.RecordAsync` (all P3 PR-3).
|
||||
**Writer ownership:** Agent writes `sessions`, `session_segments`, `frame_blobs`, `sensor_blobs`, `hardware_snapshots`, the hook-state columns on `games`, **and since P4 PR-1 (2026-09-14) the *detected* columns on `games`** — `engine`, `engine_version`, `platform` under the per-field provenance rule (`05_DETECTION` §Caching: a `user` field is never touched), `capability_flags` whole, and the cache key `detection_rules_version` / `detection_exe_size_bytes` / `detection_exe_mtime_ms`, and since schema 0011 (2026-09-25) the executable's own facts `exe_machine` / `exe_file_version` / `exe_product_version` / `library_versions`, written whole like the flags — through `IGameRepository.ApplyDetectionAsync` only. The UI and the Agent were both already writers of `games`; this adds columns to the Agent's half, not a third writer (HANDOFF §P4). **And since P4 PR-4 the UI's library import writes `platform`, `store_id` and `game_version` through `ApplyStoreMetadataAsync`** — the same per-field provenance rule, badged `detected` (a store's record is not the user's typing), on columns the UI already owned. **And since 2026-09-23 the Agent's relocator merges two entries for one executable under two drive letters** (`IGameMerge`, HANDOFF D26, `19_SAFETY` §A moved drive is the same executable): in one transaction it re-parents the dropped entry's `sessions` to the survivor (before the delete — `sessions.game_id` cascades), carries a block or a crash auto-disable still in force to the survivor (`hook_enabled` only ever to 0; `hook_blocked_reason` is copied, never originated or cleared), adds the crash counts, deletes the dropped `games` row, and then moves the survivor to the file's path (after the delete — `exe_path` is UNIQUE). It is the one Agent write that deletes a `games` row; it never touches a consent column. **And since 2026-09-23 the UI writes `record_sessions`** (schema 0009, FR-1.6): the entry's recording switch, which the Agent only reads — off, the watcher does not watch for the program. The script's one data change switches it off for entries an old import made for Steam's own tools (`SteamLibrarySource.KnownTools`, the ids as of the script); a twin merge keeps it off when either twin had it off. **And since 2026-09-25 the Agent's pre-scan of the library (`19_SAFETY` §What a finding does to the game) writes the hook-state columns of every entry, not only of those the user asked to hook** — `hook_prescan_state`, and on a finding `hook_enabled = 0` and `hook_blocked_reason` — and its own key, `hook_prescan_rules_version` / `hook_prescan_exe_size_bytes` / `hook_prescan_exe_mtime_ms` (schema 0010), through `IGameConsentStore.RecordPreScanAsync` only: columns that were already the Agent's, never over a block, never a new row. **Maintenance (P4 PR-7) adds no writer:** the retention sweep on demand is the Agent's, asked over the pipe; the UI's `VACUUM` rewrites pages with the same contents and changes no row (§Retention built note). UI writes `games` (user-editable fields — since P3 PR-3 that is the FR-1.3 metadata, the `*_default` tri-states, and `removed_at`; never a `hook_*` column), `session_annotations` (tags, notes, and since schema 0002 the FR-8.3 overrides — which is WHY they are on this table and not on `sessions`), `settings`, `legal_acceptance`. Both read everything. The ports say the same in their names: `IGameRepository.UpdateMetadataAsync` / `SetTriStateDefaultAsync` / `RemoveAsync`, `ISessionAnnotationRepository`, `RegisteredSettings`, `ILegalAcceptanceStore.RecordAsync` (all P3 PR-3).
|
||||
|
||||
## Schema (v2 — hook architecture)
|
||||
|
||||
@@ -55,7 +55,14 @@ CREATE TABLE games (
|
||||
-- hooking state (19_SAFETY)
|
||||
hook_enabled INTEGER NOT NULL DEFAULT 0, -- 0 = Tier 2, i.e. nothing measured; default for every new game
|
||||
hook_consent_at INTEGER, -- per-game informed consent timestamp
|
||||
hook_blocked_reason TEXT, -- set by the static AC pre-scan; non-null = toggle disabled in UI
|
||||
hook_blocked_reason TEXT, -- set by the static AC pre-scan; non-null = toggle disabled in UI.
|
||||
-- 'Reason|Family|Signal' since 2026-09-25 (SqliteGameConsentStore.
|
||||
-- BlockText), so the App can say it in the user's language; older
|
||||
-- rows keep "Reason: Family Signal" and are shown as stored
|
||||
hook_prescan_rules_version TEXT, -- schema 0010 (2026-09-25): the key the Agent's pre-scan of the
|
||||
hook_prescan_exe_size_bytes INTEGER, -- library last scanned the row under — the rules version and the
|
||||
hook_prescan_exe_mtime_ms INTEGER, -- executable's size and mtime; NULL = never scanned by the sweep.
|
||||
-- Change executable clears them with hook_prescan_state
|
||||
hook_autodisabled_reason TEXT, -- set after repeated crashes
|
||||
hook_crash_count INTEGER NOT NULL DEFAULT 0,
|
||||
capability_flags TEXT, -- JSON: what the game SHIPS — never a measurement. Since P4 PR-1 (2026-09-14) a JSON
|
||||
@@ -69,6 +76,14 @@ CREATE TABLE games (
|
||||
rr_default TEXT NOT NULL DEFAULT 'na',
|
||||
|
||||
detection_rules_version TEXT,
|
||||
exe_machine TEXT, -- schema 0011 (2026-09-25): what the executable runs as, from its PE
|
||||
-- headers (x64|x86|arm64|arm|anycpu|anycpu32|other|unknown); NULL =
|
||||
-- not read by this build yet, which the detection sweep reads as stale
|
||||
exe_file_version TEXT, -- schema 0011: the executable's PE FileVersion (the file's word; game_version
|
||||
exe_product_version TEXT, -- is the store's or the user's) and its ProductVersion
|
||||
library_versions TEXT, -- schema 0011: JSON array, the capability files the game SHIPS —
|
||||
-- {"capability","path","fileVersion","productVersion"}; what a session
|
||||
-- LOADED is sessions.runtime_modules
|
||||
field_provenance TEXT, -- JSON: {"engine":"detected","publisher":"user",...}
|
||||
-- absent or unrecognised reads as "user"
|
||||
added_at INTEGER NOT NULL, updated_at INTEGER NOT NULL
|
||||
@@ -334,6 +349,7 @@ switch's rule); integers are invariant-culture within an inclusive range; choice
|
||||
| `ui.theme` | choice | `system` | `system` · `light` · `dark` | UI |
|
||||
| `ui.start_with_windows` | bool | `0` | | UI (P4) |
|
||||
| `ui.minimize_to_tray` | bool | `0` | | UI (PR-8) |
|
||||
| `ui.hide_anticheat_hooking` | bool | `1` | | UI (beta.8, 2026-09-25): the game page of an entry the guard found anti-cheat in shows the finding in place of its Hooking card (`08_UI` §Game detail) |
|
||||
| `capture.background` | bool | `1` | | Agent |
|
||||
| `hooking.kill_switch` | bool | `0` | | Agent (FR-2.4, since P2 PR-F) |
|
||||
| `capture.min_session_s` | int | `30` | 5–600 | Agent, per session (FR-3.6) |
|
||||
@@ -463,6 +479,21 @@ Sequential embedded SQL (`Migrations/0001_init.sql`, `0002_*.sql`, …), applied
|
||||
> absence). "Never edit an applied script; only append" holds: 0007 stays as applied and 0008 is the append. The
|
||||
> data dropped is the override acknowledgements themselves, which is the decision. `LatestVersion` is 8.
|
||||
|
||||
> **`0010_prescan_key.sql` (2026-09-25) — `games.hook_prescan_rules_version` / `hook_prescan_exe_size_bytes` /
|
||||
> `hook_prescan_exe_mtime_ms`.** The Agent pre-scans every library entry for anti-cheat since beta.8, and again
|
||||
> whenever the rules or the executable change, so it needs what each row was last scanned against — its own key, as
|
||||
> 0004's columns are the detection sweep's, and apart from `exe_size_bytes` / `exe_mtime_ms` for the same reason
|
||||
> (the consent fingerprint must never be refreshed by a background scan). `ALTER TABLE ADD COLUMN` only; existing
|
||||
> rows read NULL, which the sweep reads as "never scanned" and scans on its first pass. `LatestVersion` is 10;
|
||||
> `LedgerDatabaseTests.ScriptTenAddsThePreScanKeyEmptyForExistingRows` applies it from 9 to a ledger holding a row.
|
||||
|
||||
> **`0011_executable_facts.sql` (2026-09-25) — `games.exe_machine` / `exe_file_version` / `exe_product_version` /
|
||||
> `library_versions`.** The owner asked for the game's version, its DLSS / FSR versions and 32- or 64-bit; the detection
|
||||
> sweep read the PE version resource and walked the tree for the capability files, and kept neither. Four columns,
|
||||
> written whole by that sweep (`05_DETECTION` §What the files say about themselves) — facts about files, so no
|
||||
> provenance and no user override. Existing rows read NULL, and a NULL `exe_machine` makes the sweep read the row once
|
||||
> more on its first pass. `LatestVersion` is 11; `LedgerDatabaseTests.ScriptElevenAddsTheExecutableFactsEmptyForExistingRows`.
|
||||
|
||||
> **Every open used to migrate, and one that should not have did — 2026-09-16.** The Agent's `--console sessions`,
|
||||
> a verb that prints, was run against the owner's ledger while the file on disk was at schema 2 and applied 0003 and
|
||||
> 0004 to it. `LedgerDatabase.OpenReadOnlyAsync` exists since that day: an existing file, `PRAGMA query_only`, no
|
||||
|
||||
+16
-7
@@ -324,22 +324,24 @@ Unchanged in spirit from v1, bumped to `v2` for the new message set.
|
||||
| Type | Dir | Payload / notes |
|
||||
|---|---|---|
|
||||
| `Hello` | UI→A | `{ appVersion, protocol: 2 }` → `HelloAck { agentVersion, protocol, pid, elevated, overlayBuildId, vulkanLayerRegistered, telemetrySource /* composite, e.g. l1+lhm+nvapi */, cpuTempAvailable, disclosureVersion /* P3 PR-4, D14: the FR-2.1 text this Agent stamps against */, ~~etwAvailable~~ }` — `etwAvailable` struck 2026-09-13 with the tier it described (2026-08-28); `pid` added. `vulkanLayerRegistered` is **false by construction** today (the layer is per-launch, never registered) and `cpuTempAvailable` false unelevated; `telemetrySource` is the composite stood up once on the first `Hello` |
|
||||
| `GetStatus` | UI→A | → `StatusAck { state, activeSession?, tier? }` |
|
||||
| `GetStatus` | UI→A | → `StatusAck { state, activeSession?, tier? }` — and `activeSessions[]`, one `{ sessionGuid, gameId, gameName?, pid, tier, startedAt, hold? }` per running session. **`hold` added 2026-09-23, optional:** present on a session held unhooked (Tier 2), with the same words `SessionStarted.hold` carries; a session listed at tier 2 WITHOUT a `hold` has not attached yet — it is starting, not held. The App reads this list on every (re)connect (§Client behavior) |
|
||||
| `SetWatchlist` | UI→A | `{ entries: [{ gameId?, exePath }] }` — ~~full replace~~ **ensure, never remove** (built 2026-09-13, PR-1b): each entry's path is normalised by the Agent, its row ensured with hooking OFF when new, and the ack is `WatchlistAck { games: [{ gameId, exePath, name }], unreadable: [exePath] }`; `gameId` in a request is a hint and never trusted over the path. UI re-sends on connect. **Carries no hooking state** (see §The pipe is not a trust boundary). *Since the App writes `games` rows itself under `06_DATA_MODEL` §Writer ownership (HANDOFF §P3 D15), this is the pipe's way of adding a row, not the only one; the watcher reads the table at 1 Hz either way.* |
|
||||
| `LaunchGame` | UI→A | `{ gameId, arguments? }` → ~~suspended-launch~~ launch mode as built ("inject late", `04_CAPTURE` §Launch mode) → `LaunchAck { gameId, accepted, outcome, sessionGuid? }` — `outcome` is `Accepted` · `UnknownGame` · `SessionRunning` (one per game at a time) · `Unavailable`. *(Built 2026-09-13, PR-1b: `CaptureOrchestrator.LaunchAsync` over an `ILaunchRecorderFactory` the Agent composes with the Vulkan layer's environment — or none when FR-2.4's switch is on — and the launcher election runs after, as the console's `launch` does; the elected session is not addressable by the launch's guid.)* |
|
||||
| `SetHookEnabled` | UI→A | `{ gameId, enabled, disclosureVersion? }` — Agent re-runs the static AC pre-scan and may reply `Refused`. **The Agent stamps the consent timestamp itself.** *(Built 2026-09-13, PR-1b, as far as it can be: `enabled: false` → `RevokeAsync` → `HookEnabledAck { gameId, enabled: false, outcome }`; `enabled: true` → the pre-scan of the executable's directory, a refusal or a "could not verify" recorded through `RecordGuardBlockAsync` and answered `Refused { gameId, reason, family?, signal? }`; a clean scan → ~~**`Error DisclosureUnavailable`, nothing stamped** — the reviewed FR-2.1 text does not exist, and a client's `disclosureVersion` is a claim, not a disclosure shown. PR-4 replaces that last branch with the stamp~~ **since PR-4 (2026-09-13): the client's `disclosureVersion` compared with the Agent's own `SafetyDisclosure.Version`; equal → the stamp from the Agent's clock with `ConsentProvenance.ConsentDialog`, answered `HookEnabledAck { enabled, outcome, prescan: "clean" }`; anything else → `Error DisclosureVersionMismatch`, nothing written (D14). `DisclosureUnavailable` remains for a composition that wired no version, which `--serve` never is.)* |
|
||||
| `LaunchGame` | UI→A | `{ gameId, arguments? }` → ~~suspended-launch~~ launch mode as built ("inject late", `04_CAPTURE` §Launch mode) → `LaunchAck { gameId, accepted, outcome, sessionGuid? }` — `outcome` is `Accepted` · `UnknownGame` · `SessionRunning` (one per game at a time) · `Unavailable` · `RecordingOff` (2026-09-23: the entry's recording switch is off, FR-1.6 — FrameLedger does not start what it will not record). *(Built 2026-09-13, PR-1b: `CaptureOrchestrator.LaunchAsync` over an `ILaunchRecorderFactory` the Agent composes with the Vulkan layer's environment — or none when FR-2.4's switch is on — and the launcher election runs after, as the console's `launch` does; the elected session is not addressable by the launch's guid.)* |
|
||||
| `SetHookEnabled` | UI→A | `{ gameId, enabled, disclosureVersion? }` — Agent re-runs the static AC pre-scan and may reply `Refused`. **The Agent stamps the consent timestamp itself.** *(Built 2026-09-13, PR-1b, as far as it can be: `enabled: false` → `RevokeAsync` → `HookEnabledAck { gameId, enabled: false, outcome }`; `enabled: true` → the pre-scan of the executable's directory, a refusal or a "could not verify" recorded through `RecordGuardBlockAsync` and answered `Refused { gameId, reason, family?, signal? }`; a clean scan → ~~**`Error DisclosureUnavailable`, nothing stamped** — the reviewed FR-2.1 text does not exist, and a client's `disclosureVersion` is a claim, not a disclosure shown. PR-4 replaces that last branch with the stamp~~ **since PR-4 (2026-09-13): the client's `disclosureVersion` compared with the Agent's own `SafetyDisclosure.Version`; equal → the stamp from the Agent's clock with `ConsentProvenance.ConsentDialog`, answered `HookEnabledAck { enabled, outcome, prescan: "clean" }`; anything else → `Error DisclosureVersionMismatch`, nothing written (D14). `DisclosureUnavailable` remains for a composition that wired no version, which `--serve` never is.)* **Since beta.8 (2026-09-25):** the pre-scan is of the executable (the guard resolves the install root, PR-2 of that train), and BEFORE it an executable known not to run as x64 is answered `Refused { gameId, reason: "ExecutableNotX64", signal: "x86" | "anycpu32" | "arm64" | "arm" }` with nothing scanned and nothing written — not a guard reason and not a block (`05_DETECTION` §What the files say about themselves). |
|
||||
| `PauseCapture` / `ResumeCapture` | UI→A | global → `PauseAck { paused }`; `StatusAck.paused` reports it. *(Built 2026-09-13, PR-1b: one in-memory flag, `CapturePause`, read by every session loop at its tick and told to the ring once per transition; supervision — the guard scan, the kill switch, the safety stop — never pauses. Not persisted: an Agent that restarts resumes.)* |
|
||||
| `StopSession` | UI→A | `{ sessionGuid }` — graceful ~~unhook~~ stop + finalize → `StopAck { sessionGuid, accepted, reason? }`. *(Built 2026-09-13, PR-1b: the orchestrator names every session it starts and cancels THAT session's stop token; the loop reads it at its next tick, drains once more, and ends as `SessionEndReason.StoppedByUser` — `exit_status = normal`, the row stored like any other, the target left running. A guid nobody runs is `accepted: false`. Distinct from the host's cancellation, which leaves a `.partial`.)* |
|
||||
| `UpdateRules` | UI→A | **no payload** — a trigger, not a source. The Agent re-reads only its own `%LOCALAPPDATA%\FrameLedger\rules\` copy → `UpdateRulesAck { outcome }`. *(Built 2026-09-13, PR-1b: the seeder's `EnsureSeededAsync` outcome; a payload naming a path is ignored, and a test sends one to prove it.)* |
|
||||
| `Shutdown` | UI→A | graceful stop → `ShutdownAck`, then the host stops (sessions finalize inside its grace window). *(Built 2026-09-13, PR-1b: `IAgentLifetime`, the host's under `--serve`, a logged no-op under `--console`.)* |
|
||||
| `SweepRetention` | UI→A | **no payload** — a trigger, like `UpdateRules`: the Agent applies `06_DATA_MODEL` §Retention to every game with the `retention.raw_sessions_per_game` it reads itself → `SweepRetentionAck { keep, games, sessions }` (`keep` 0 = unlimited, and then nothing was swept). *(Built 2026-09-15, P4 PR-7, for Tools ▸ Database maintenance: `Application.Recording.RetentionSweep` over `ISessionRepository.SweepRetentionAllAsync`, composed into `AgentCommandHandler` under `--serve`. The client names no number because the rows are the Agent's (§Writer ownership). Additive: an older Agent answers `Error UnknownType`, which the dialog reads as "restart the Agent". Carries no safety fact.)* |
|
||||
| `SessionStarted` | A→UI | `{ sessionGuid, gameId, gameName, pid, tier, startedAt }` — **published at the attach**, i.e. when the session becomes Tier 1 and the live card has something to show; a session that never attaches has no `SessionStarted`, only its `SessionCompleted` (tier 2) and, when a refusal or error caused that, the event below that names it |
|
||||
| `SessionStarted` | A→UI | `{ sessionGuid, gameId, gameName, pid, tier, startedAt, hold? }` — **published once per session**: at the attach (tier 1, `startedAt` the attach), or — **since 2026-09-23** — at the first tick of a session held unhooked (tier 2, `startedAt` the session's start, `pid` 0 when the loop never opened the process, as a hooking-off hold never does). ~~a session that never attaches has no `SessionStarted`, only its `SessionCompleted` (tier 2)~~ — that was the beta.5 wire, and every hooking-off, refused or unreadable game read "Nothing is being captured." for as long as it ran. **`hold` (optional, tier 2 only)** is why nothing is measured: `{ reason, guardReason?, family?, signal?, hookingTurnedOff }` — the loop's `SessionEndReason` and, when the guard said anything but allow, its reason, family and signal: the same words the row's `capture_notes` will carry, so the live card and the summary read one sentence (`Formats.Tier2HoldReason` / `Tier2Reason`). The refusal's own event (`CaptureRefused` and the rest, below) goes out with this start rather than when the game exits, and is not repeated at the end |
|
||||
| `SessionHeld` | A→UI | **Added 2026-09-23.** 1 Hz while a client listens, for a session held unhooked only: `{ sessionGuid, elapsedS, gpuTempC?, cpuTempC?, gpuLoadPct?, cpuLoadPct? }` — how long it has run and the machine's sensors. **Never `SessionProgress`**: its `presents5s`, `presentedQualifier` and `fgMode` are required, and zeros there would put measured-looking numbers on the wire for a session that measures nothing (rule 6 has nothing to show and shows nothing) |
|
||||
| `SessionProgress` | A→UI | 1 Hz: `{ sessionGuid, elapsedS, presents5s, presentedFps5s?, presentedQualifier, nativeFps5s?, displayedFps5s?, fgFactor?, fgMode, upscaler?, upscalerQuality?, upscalerDriverReported?, renderW/H?, outputW/H?, rtActive?, gpuTempC?, cpuTempC?, cpuLoadPct?, vramProcMb?, latencyUs?, fgRefusal?, fgRuntimeCensus? }` — a 5 s rolling window over the ring through the SAME Domain calculators the row uses (`SessionProgressCalculator`, D13). **`upscalerDriverReported` added 2026-09-21, optional:** `dlss` when the NVIDIA driver reports an NGX super-resolution feature created and evaluated in the target (`03_METRICS` §The driver-reported rung), so the live card says `DLSS (driver-reported)` where no hook can name the upscaler; identity only. **`cpuLoadPct` added 2026-09-21, optional** (CPU time busy over the last telemetry tick, 0–100; `cpuTempC` has a producer from the same date, present only when the Agent is elevated with PawnIO). **Two fields added 2026-09-14, both optional (an older client ignores them, §C):** `fgRefusal` is the row's `fg_refusal` (schema 0003) — present when `fgMode` names a technology and `fgFactor` is absent, so the live card can say "DLSS-G active — factor not counted" rather than N/A; `fgRuntimeCensus` is the raw census so the `fg_runtime_loaded` chip can name the module. **Rule 6 at the wire (2026-09-13):** `nativeFps5s` / `displayedFps5s` / `fgFactor` are present only when frame generation was measured in the window; otherwise `presentedFps5s` stands alone with `presentedQualifier` (`census_not_run` · `no_fg_runtime` · `fg_runtime_loaded` · `none_withheld`, the row's `presented_qualifier` from the same function). Every unmeasured field is absent, never 0. Suppressed when no client is connected |
|
||||
| `SessionCompleted` | A→UI | `{ sessionGuid, sessionId?, exitStatus, tier, finalize, reason }` — UI loads the full row from SQLite; `sessionId` is null and `finalize` is `discarded` when the row was not stored (under the minimum length), or `game_removed` when its entry was removed with its sessions while it ran (2026-09-23); `exitStatus` is the row's vocabulary (`normal` · `crashed` · `unhooked_safety` · `degraded`); `reason` is the loop's `SessionEndReason` |
|
||||
| `SessionCompleted` | A→UI | `{ sessionGuid, sessionId?, exitStatus, tier, finalize, reason, gameId?, gameName? }` — UI loads the full row from SQLite; `sessionId` is null and `finalize` is `discarded` when the row was not stored (under the minimum length), or `game_removed` when its entry was removed with its sessions while it ran (2026-09-23), or **`faulted` when the session's task threw before it could finalize** (2026-09-23: it follows the `CaptureError SessionFaulted`, with `exitStatus` `interrupted` and `reason` `SessionFaulted`, so the live card and the tray let go of a session that no longer runs; the `.partial` stays for recovery); `exitStatus` is the row's vocabulary (`normal` · `crashed` · `unhooked_safety` · `degraded`); `reason` is the loop's `SessionEndReason`. **`gameId` / `gameName` added 2026-09-23, optional:** the entry the session was stored under — the finalizer's owner when it re-keyed a session whose entry was removed, else the one it started under — so the notice names the session that completed, not whatever the live card last showed |
|
||||
| `CaptureRefused` | A→UI | `{ gameId, gameName, reason, family?, signal?, hookingTurnedOff }` — **guard fired**; `hookingTurnedOff` (2026-09-22) is true when the finding turned the game's hooking off (`19_SAFETY` §What a finding does to the game); UI shows the plain-language explanation — ~~and the Tier-2 offer~~; there is no alternative measurement to offer, only the option to record the session unmeasured (`08_UI` §Safety events). *(Built: for `RefusedByGuard`, `RefusedPreviouslyBlocked`, `RefusedKillSwitch` and `PreScanCouldNotVerify` — the last with no family, because "could not verify" is neither a hit nor a pass; `family`/`signal` are the verdict's. A game merely not enabled or not consented raises nothing: that is an ordinary Tier-2 row, not a refusal to explain.)* |
|
||||
| `CaptureDegraded` | A→UI | `{ sessionGuid, from: 1, to: 2, reason }` — Tier 1 → Tier 2 mid-flight, or overlay self-disabled. **Under a two-rung ladder this means measurement STOPPED**, not that it continued at lower fidelity, and the notice must say so. *(Built: `SupervisionLost`, `WriterSelfDisabled`, `WriterStoppedBlocklisted`, `WriterNeverInstalledHooks`, `SupervisionFaulted`, `KillSwitchEngaged` — `RecordedSessionEvents.Classify` is the table.)* |
|
||||
| `SafetyUnhook` | A→UI | `{ sessionGuid, family?, signal?, hookingTurnedOff }` — anti-cheat appeared mid-session; prominent UI notice; `hookingTurnedOff` as on `CaptureRefused`. *(Built: the verdict that FIRED, not the pass that started the session — `CaptureOutcome.Verdict` carries the supervisor's last verdict on this reason since 2026-09-13.)* |
|
||||
| `CaptureError` | A→UI | `{ sessionGuid?, code, message }` — `InjectFailed`, `RingVersionMismatch`, `AttachRefused`, ~~`EtwAccessDenied`~~ (struck 2026-09-13 with the tier), ~~`PresentMonMissing`~~ (retired with the tool, 2026-08-27 — a code naming an implementation nobody chose), `TelemetryUnavailable`, `DbWriteFailed`, `SessionFaulted` (the session's task threw before finalize; the `.partial` stays for recovery, and no `SessionCompleted` follows). *(Built: `RingVersionMismatch` for a layout / record-size / build-id refusal — the "restart the game after an update" case — `AttachRefused` for the rest of the ring's refusals, `InjectFailed` for a target that could not be started, pinned, read or singled out.)* |
|
||||
| `HookingTurnedOff` | A→UI | `{ gameId, gameName?, reason, family?, signal? }` — **since 2026-09-25 (beta.8):** the Agent's pre-scan of the library (`19_SAFETY` §What a finding does to the game) found anti-cheat in a game whose hooking the user had turned on, and turned it off. Not a session event — no session is running — so the UI's notice carries no "record without measuring" action, only Dismiss (`SafetyNoticeKind.HookingOff`). A finding on a game whose hooking was already off sends nothing: its page and its library card change, nothing the user switched on did. Additive: a client that does not know the type ignores it (§Versioning). |
|
||||
| `CaptureError` | A→UI | `{ sessionGuid?, code, message }` — `InjectFailed`, `RingVersionMismatch`, `AttachRefused`, ~~`EtwAccessDenied`~~ (struck 2026-09-13 with the tier), ~~`PresentMonMissing`~~ (retired with the tool, 2026-08-27 — a code naming an implementation nobody chose), `TelemetryUnavailable`, `DbWriteFailed`, `SessionFaulted` (the session's task threw before finalize; the `.partial` stays for recovery, and ~~no `SessionCompleted` follows~~ a `SessionCompleted` with `finalize: faulted` follows since 2026-09-23). *(Built: `RingVersionMismatch` for a layout / record-size / build-id refusal — the "restart the game after an update" case — `AttachRefused` for the rest of the ring's refusals, `InjectFailed` for a target that could not be started, pinned, read or singled out.)* |
|
||||
| `Ping`/`Pong` | ~~both~~ UI→A | 15 s keepalive, **client-driven** (built 2026-09-13): the client pings, the Agent answers; the Agent initiates nothing on an idle connection |
|
||||
|
||||
## The pipe is not a trust boundary
|
||||
@@ -380,6 +382,13 @@ message, and that message always re-scans.
|
||||
|
||||
## Client behavior (UI)
|
||||
|
||||
- **The running sessions are the status's, then the events' (2026-09-23).** Every list of running sessions the App
|
||||
keeps is seeded from `StatusAck.activeSessions` on every (re)connect and moved by `SessionStarted` /
|
||||
`SessionCompleted` after that; a lost Agent empties it. The Dashboard reads the App-lifetime `LiveSessions`
|
||||
service (it is rebuilt per visit, so a list of its own would start empty); the tray and the updater seed their
|
||||
own from the same status. Before this a Dashboard opened after a game started read "Nothing is being captured.",
|
||||
the tray stayed idle for a session that began before the App connected, and the updater held an update at
|
||||
*Deferred* on a status read hours earlier.
|
||||
- Connect with 250 ms × 8 backoff; on failure start the Agent, retry; then show an Agent status banner with Repair.
|
||||
|
||||
> **Amended 2026-09-17: never a second Agent.** A round that ends without a connection starts one only when no
|
||||
@@ -391,7 +400,7 @@ message, and that message always re-scans.
|
||||
> the App's log. `AgentConnectionTests` pins both.
|
||||
- Treat the pipe as unreliable: library, history and charts must all work with the Agent offline. Only live status degrades.
|
||||
- SQLite is the source of truth for anything persisted; pipe events are refresh signals (except `SessionProgress`, which is live-only by design).
|
||||
- `CaptureRefused` and `SafetyUnhook` are **never** collapsed into a generic error toast — they get dedicated, explanatory UI (`08_UI` §Notifications).
|
||||
- `CaptureRefused`, `SafetyUnhook` and (since 2026-09-25) `HookingTurnedOff` are **never** collapsed into a generic error toast — they get dedicated, explanatory UI (`08_UI` §Notifications).
|
||||
|
||||
## Versioning
|
||||
|
||||
|
||||
@@ -111,6 +111,14 @@ The Menu sits in its own row **below** the TitleBar (never inside the drag regio
|
||||
> `PagesLoadTests.TheInfoBarTemplateRendersItsContent`, which renders both templates and fails when upstream
|
||||
> gains a presenter — the signal to delete the copy.
|
||||
|
||||
> **The pre-scan's notice (2026-09-25, beta.8).** The Agent's pre-scan of the library (`19_SAFETY` §What a finding
|
||||
> does to the game) sends `HookingTurnedOff` when it turned off hooking the user had turned on; `SafetyNotices` makes
|
||||
> it a `SafetyNotice` of kind `HookingOff` — Error, persistent like the others, titled *"{game}: hooking turned off"*
|
||||
> (`Notice_HookingOff_Title_Format`), the refusal sentence naming the family and the signal followed by
|
||||
> `Safety_HookingTurnedOff`. It has **no** `Notice_Refused_Recording` and its button is Dismiss, not
|
||||
> `Safety_RecordWithoutMeasuring`: no session is running, so there is nothing to record without measuring. A finding
|
||||
> on a game whose hooking was already off raises no notice; its card and its page say it (§Games).
|
||||
|
||||
## FPS display rule (global, FR-4.2 / CLAUDE.md rule 6)
|
||||
|
||||
Reusable control `FpsReadout` (custom control styled with WPF UI theme brushes):
|
||||
@@ -147,6 +155,19 @@ All screens are `Page`s registered with the navigation page provider and navigat
|
||||
> session reloads the lists (the row is in SQLite, `07_IPC` §Client behavior). Totals = the library's games,
|
||||
> `SummariseByGameAsync` playtime, `CountSinceAsync(now − 7 d)`. Capability badges and the Repair button are
|
||||
> PR-8's with the Agent section.
|
||||
>
|
||||
> **Amended 2026-09-23: the card shows every running session, measured or not.** A session held unhooked
|
||||
> (Tier 2 — hooking off, refused, unreadable) shows its name, the T2 badge, the elapsed time and the
|
||||
> machine's temperatures from `SessionHeld`, the line "Recording duration and sensors only — nothing is
|
||||
> measured." and **why**, in the sentence its summary will carry (`Formats.Tier2HoldReason` over the start's
|
||||
> `hold`, the same words `Tier2Reason` reads from `capture_notes`) — and no `FpsReadout` at all. A session the
|
||||
> status lists at tier 2 with no `hold` has not attached yet: its name and badge until the attach's start arrives,
|
||||
> never the held line and never the "Attached — waiting" one. A hooked session takes the card from a held one,
|
||||
> never the reverse. The card is seeded from the
|
||||
> App-lifetime `LiveSessions` when the Dashboard is built, so a session that started while another page was
|
||||
> open is on it at once; the completion notice names the session that completed (`SessionCompleted.gameName`)
|
||||
> and a `faulted` completion is no notice (the strip's `CaptureError` already said it). Until this date the
|
||||
> Agent announced only hooked sessions: every other game read "Nothing is being captured." while it ran.
|
||||
|
||||
### Games (grid → detail)
|
||||
- `GridView`-style panel of cover cards (`ui:CardAction`): name, platform badge, engine badge, total playtime, last played, mini trend sparkline (avg Native FPS last 10 sessions). Sort/filter/`ui:AutoSuggestBox` search.
|
||||
@@ -178,6 +199,42 @@ All screens are `Page`s registered with the navigation page provider and navigat
|
||||
> with tooltips. Frametime / Distribution / Trend / Sensors / Latency say which build brings them (PR-6, PR-7).
|
||||
> `PagesLoadTests` loads every page and both control templates under the real theme dictionaries on an STA
|
||||
> thread, so a binding typo is red in CI rather than a `XamlParseException` at first navigation.
|
||||
>
|
||||
> **The recording switch (2026-09-23, FR-1.6).** A `ui:CardControl` **Recording** above the hooking control, its
|
||||
> `ToggleSwitch` `OneWay` from `games.record_sessions` and its command writing the row through
|
||||
> `GameLibrary.SetRecordingAsync` — no dialog (it deletes nothing; sessions already recorded stay) and nothing over
|
||||
> the pipe (the Agent reads the table each tick). Status line *Recorded when it runs* / *Ignored — nothing is
|
||||
> recorded*; the body says what off means (the program is not watched; a running session stops) and when to use it
|
||||
> (a utility that starts with Windows). The library card shows **Not recorded** in place of the hooking badge, since an
|
||||
> ignored program is never hooked whatever its hooking switch says. The hooking control stays independent: a user can
|
||||
> keep a consent on an entry they stopped recording for a while.
|
||||
>
|
||||
> **Anti-cheat games (2026-09-25, beta.8, owner decision).** The Agent pre-scans every library entry now, so the App
|
||||
> knows which games ship anti-cheat before anyone asks to hook them (`19_SAFETY` §What a finding does to the game).
|
||||
> The library card says **Anti-cheat** in place of *Hooking off* — the caution fill with primary text, the warning
|
||||
> qualifier's pair that `ContrastTests` measures in both themes — for an entry that is recorded (*Not recorded* still
|
||||
> comes first). On the game's page the Hooking card is a switch that could only be refused, so while
|
||||
> `ui.hide_anticheat_hooking` is on — its default, Settings ▸ Capture *Hide hooking on anti-cheat games* — the card
|
||||
> and its lines give way to one **Anti-cheat** card: *"Found: {what}. Hooking is off for this game and cannot be
|
||||
> turned on; its sessions record play time and sensors only."* Off, the card is back with the switch disabled and
|
||||
> `Safety_Blocked_Toggle_Format` under it. `{what}` is `Services.BlockedReasonText` over the stored
|
||||
> `Reason|Family|Signal` — *"BattlEye — its module BEClient_x64.dll was loaded in the game"*, *"Easy Anti-Cheat —
|
||||
> its folder EasyAntiCheat ships with the game"*, *"… is a listed title"*, *"the game's store id … is listed"* —
|
||||
> and a row stored before that form is shown as it was. The crash auto-disable's re-enable bar is not offered on a
|
||||
> blocked row: its one action could only be refused. Tests: `GameDetailViewModelTests` (hidden, shown, the card
|
||||
> pill), `BlockedReasonTextTests`, `PagesLoadTests.AnAntiCheatGamesPageRendersTheFindingInPlaceOfTheHookingCard`.
|
||||
>
|
||||
> **Details (2026-09-25, beta.8, schema 0011).** A `ui:CardExpander` **Details** under the two rows, expanded, says
|
||||
> what the game's files and its store say (`05_DETECTION` §What the files say about themselves): *Runs as* (64-bit
|
||||
> (x64) · 32-bit (x86) · ARM64 · .NET, any CPU (runs as 64-bit) · …), *File version* and *Product version* (the
|
||||
> executable's PE resource — for an Unreal title often the engine's), *Store* ("Steam build 20374416", "GOG version
|
||||
> 1.2.3" — or *Version* when the user typed it), *Engine*, and *Ships with*, one line per capability file: "DLSS:
|
||||
> nvngx_dlss.dll 3.7.10.0", "XeSS: libxess.dll (no version)". A row the Agent has not read yet says so. The subtitle
|
||||
> labels the store's version the same way and then drops the bare store name it would repeat. **An executable that
|
||||
> cannot run as x64** (x86, 32-bit-preferring .NET, ARM) disables the hooking switch with `Hooking_NotX64_Format` under
|
||||
> it and no re-enable bar — turning it on could only be refused (the Agent refuses `ExecutableNotX64` anyway); a switch
|
||||
> already on can still be turned off. Tests: `GameDetailViewModelTests.TheDetailsCardSaysWhatTheFilesSayAndAnX86SwitchCannotBeTurnedOn`,
|
||||
> `FormatsTests`, and the page renders in `PagesLoadTests`.
|
||||
- Tabs (WPF `TabControl`, Fluent-styled):
|
||||
1. **Sessions** — `DataGrid`: date, duration, **tier badge (T1/T2)**, Native, Displayed, FG×, 1% Low, 0.1% Low, resolution + upscaler, max GPU temp, API, chips, ⚠ crash badge, tags. Row → Session summary. Multi-select → "Compare". Tier-2 rows render `—` (not blank, not zero) in Tier-1-only columns, with a tooltip explaining why.
|
||||
2. **Frametime** — ScottPlot timeline of selected session (decimated), stutter markers, sensor overlay toggle (temp on right axis).
|
||||
@@ -225,6 +282,13 @@ Stat cards (Avg uses `FpsReadout`, Median, 1% Low, 0.1% Low, Min/Max, σ, stutte
|
||||
> aggregates with N/A omitted, segments, the annotation); PNG through `Plot.SavePng`. Tags (comma-separated,
|
||||
> de-duplicated) and notes save to the annotation row. **FR-3.8** is an in-app notice on `SessionCompleted`
|
||||
> (saved / discarded); the tray toast with "View" arrives with the tray (PR-8).
|
||||
>
|
||||
> **The loaded libraries (2026-09-25, beta.8).** Under the hardware line, a Tier-1 session says what it had loaded —
|
||||
> `sessions.runtime_modules`, written since P2 and shown nowhere until then — sorted, one line: *"Loaded:
|
||||
> nvngx_dlss.dll 310.2.1.0 (the game ships 3.7.10.0: another copy was loaded, for example by the driver or the NVIDIA
|
||||
> App) · sl.interposer.dll 2,8,0,0"*. The comparison is with the game's own copy (`games.library_versions`) as the
|
||||
> same four numbers (`Formats.SameVersion`: Streamline's `2,8,0,0` string equals `2.8.0.0`); it names a difference and
|
||||
> never who made it. Older rows show their list the day this ships; a Tier-2 row has none and no line.
|
||||
|
||||
### Compare
|
||||
Session picker (2–5, cross-game allowed) → overlaid percentile curves + stat table with best-value highlighting; FG columns always show Native and Displayed separately. Export PNG.
|
||||
@@ -298,6 +362,10 @@ Agent section: elevation state with a plain explanation of what elevation *optio
|
||||
> enforces on its own after every consent change and every sweep — the button is the repair tool, `12_BUILD`
|
||||
> §The Vulkan layer is not registered at install time); Repair appears
|
||||
> when the task's action names another path (a moved install). "Minimize to tray on close" is honoured.
|
||||
>
|
||||
> **2026-09-25 (beta.8):** Capture gained *Hide hooking on anti-cheat games* (`ui.hide_anticheat_hooking`, on by
|
||||
> default) between the kill switch and the Vulkan layer row — §Games says what it hides; the game's page reads it at
|
||||
> each load. It hides a control that could only be refused, never the finding.
|
||||
|
||||
### First-run flow
|
||||
1. Legal Gate (FR-11): four documents, scrollable, links to GitHub-hosted versions, single Accept.
|
||||
|
||||
+5
-2
@@ -58,10 +58,13 @@ flow, and the tests run the flow over a fake client because nothing here may tou
|
||||
- **FR-12 is the shape of the flow, not a check at the end.** A downloaded package is `Ready` only while the Agent
|
||||
reports no session (its `StatusAck` at connect, then `SessionStarted` / `SessionCompleted` on the pipe);
|
||||
otherwise it is `Deferred`, the button is disabled and the body says why, and it becomes `Ready` when the last
|
||||
session ends. The apply is refused again inside if a session started meanwhile. A recording-only (Tier 2)
|
||||
session ends. The apply is refused again inside if a session started meanwhile. ~~A recording-only (Tier 2)
|
||||
session that began before the App connected is covered by the status; one that begins afterwards raises no
|
||||
`SessionStarted` (that event is the ring's) and is not — a known gap, recorded rather than hidden: the Overlay
|
||||
is not on disk under such a session, so the rule's reason does not apply to it.
|
||||
is not on disk under such a session, so the rule's reason does not apply to it.~~ **Closed 2026-09-23:** a held
|
||||
(Tier 2) session raises its own `SessionStarted`, so it defers an update like any other; and the status read at
|
||||
connect SEEDS the running set rather than being OR-ed with it forever — before, a session running when the App
|
||||
connected held every download at `Deferred` until the next reconnect, hours after it ended.
|
||||
- **Apply:** `Shutdown` to the Agent over the pipe, the connection's relaunch held (`IAgentLink.SetLaunchHold`),
|
||||
the pipe watched until it drops (10 s; an Agent that does not stop leaves everything as it was and says so),
|
||||
then `WaitExitThenApplyUpdates(asset, silent: false, restart: true)` and the host ends. The restarted App
|
||||
|
||||
+1
-1
@@ -8,7 +8,7 @@ The anti-cheat guard is the one component where a bug can cost someone an accoun
|
||||
|
||||
**These are Catch2 tests, not xUnit.** `20_OPEN_QUESTIONS` §S13(a) settled the guard into the C++ `FrameLedger.Injector`, so the fail-closed matrix below lives in the native suite and the guard needs seams — injectable enumerator function pointers — before any of these failures can be forced at all. ~~Landing Catch2 is a prerequisite of the guard, not a later nicety (§S15).~~ **Landed long since** — `ctest` runs 31 native suites on every gate (`fl_guard` alone is ~100 s); the sentence was left in the future tense until 2026-09-21.
|
||||
|
||||
- Blocklist matching: exact, case-insensitive, prefix rules; every family in `19_SAFETY` §Blocklist seed has a fixture. Two families (Activision Ricochet, Valve VAC) have **no data yet**, so their fixtures must assert that absence explicitly rather than quietly passing on an empty rule set.
|
||||
- Blocklist matching: exact, case-insensitive, prefix rules; every family in `19_SAFETY` §Blocklist seed has a fixture. Two families (Activision Ricochet, Valve VAC) have **no data yet**, so their fixtures must assert that absence explicitly rather than quietly passing on an empty rule set. **Since 2026-09-25** the fixture is generated from the shipped seed (`rules_budget_test.cpp`: every entry's every value matches its own family in its own group, which also catches a row an earlier prefix shadows), and Ricochet's fixture asserts its data; VAC's still asserts that no family entry fakes it.
|
||||
- **A finding turns the game's hooking off (2026-09-22), and the proofs are about WHICH findings.** `AntiCheatVerdictTests` pins `IsFindingAboutTheGame` per reason (in the game: yes; machine-wide driver or service, heuristics, failed scans, the latch: no) and that a finding without a family is not one; `CaptureSessionTests` that a start-time `BlockedModule` writes the block, keeps the consent stamp and says `HookingTurnedOff`, that a `BlockedDriver` refuses the session and leaves the row alone, and that the 30 s re-scan's finding writes the same block; `RecordedSessionEventsTests` and `SafetyNoticesTests` that the flag travels to the notice. The override of 2026-09-21 had its own proofs for one day; they went with it, and `NoSecondMatcherTests` counts the port's four methods again.
|
||||
- **Fail-closed proofs:** malformed `detection-rules.json`, missing `anticheat` block, unreadable target process, `EnumProcessModulesEx` failure, partial module list → **all must refuse injection**, never allow. Each is a named test.
|
||||
- **Measured error paths that must be named tests** (`spike-notes.md` §1): `ERROR_PARTIAL_COPY (299)` from a suspended target, `ERROR_ACCESS_DENIED (5)` from a protected one, a driver-list parse whose paths are not native paths, and a service query returning `ACCESS_DENIED` — the last of which **cannot be produced on real services by a standard user**, so it exists only as a fake. Every one means REFUSE.
|
||||
|
||||
+196
-26
@@ -220,6 +220,35 @@ Implemented in `FrameLedger.Injector` and reached from managed code through a th
|
||||
> never as *clean*. `20_OPEN_QUESTIONS` §S7 tracks the remaining work.
|
||||
3. **Rules blocklist** — `detection-rules.json` carries `anticheat.blockedExecutables` (exe names) and `anticheat.blockedStoreIds` (Steam appids etc.) for known competitive/online titles, updatable independently of app releases (`05_DETECTION` §Rules updates).
|
||||
|
||||
> **Both halves are wired and seeded since 2026-09-25** (owner: "as many and as strict as possible"; rules
|
||||
> `2026.09.4`). The block below is the history it replaces, kept for the reasoning.
|
||||
>
|
||||
> **The store half reads the store's own files, through a seam the guard owns.** `Sources::StoreIdentity` takes the
|
||||
> install root the guard already derives from the pid (check 4's `ImageDirectory`) and answers from disk: under
|
||||
> `<library>\steamapps\common\<folder>`, the one `appmanifest_<id>.acf` whose `installdir` is `<folder>` →
|
||||
> `steam:<id>`; a `goggame-<id>.info` in the root → `gog:<id>`. Nothing is handed in by a caller (§S3 is untouched —
|
||||
> the ABI still takes a pid and nothing else) and nothing is read from the game's process (rule 4).
|
||||
>
|
||||
> **The matrix §S14 asked for:** a listed identity refuses (`BlockedStoreId`, naming the family); an install no store
|
||||
> names — a loose folder, a GOG-less, manifest-less copy — is **not** refused, because "no store identity" is an
|
||||
> answer, not an unknown, and refusing it would be the gate that cannot pass; a store layout whose metadata could not
|
||||
> be read (a manifest that will not open, more than 4096 of them, a listing error) refuses as `PreScanFailed`. With
|
||||
> nothing listed, nothing is read. Epic has no reader: an Epic install carries no identity to this check.
|
||||
>
|
||||
> **What is listed, and why a title list at all:** 30 Steam app ids and 33 executable names across nine families —
|
||||
> Valve VAC (CS2, Dota 2, TF2, Deadlock and Valve's older VAC titles), Riot Vanguard, Roblox Hyperion, Blizzard's
|
||||
> online titles ("Blizzard Warden"), Call of Duty (Activision Ricochet), NetEase (Marvel Rivals, NARAKA, FragPunk,
|
||||
> Once Human), ACE (Delta Force, Arena Breakout: Infinite), HoYoverse and EA (Battlefield 2042/6, EA SPORTS FC 25/26).
|
||||
> These are the titles whose anti-cheat leaves nothing of the game's own for checks 1, 2 and 4 to find — VAC runs
|
||||
> inside Steam, Blizzard's scanner is built into the game — or whose kernel driver loads only after the checks run.
|
||||
> Every app id was checked against its Steam store page; Call of Duty's changed when Activision split CoD HQ, so only
|
||||
> ids with a live store page are listed. The per-title lists are **floored** like the families: a rules file can
|
||||
> add a title and cannot take one off. `rules-validate` refuses a name engines and tools share (`Game.exe`,
|
||||
> `Client-Win64-Shipping.exe`, `hl2.exe`…), an exact rule that names no `.exe`, and duplicates.
|
||||
>
|
||||
> **The owner declined the bulk list** (AreWeAntiCheatYet's ~250 Steam ids): community data that keeps listing a game
|
||||
> after it drops its anti-cheat would turn hooking off for good on a title that no longer needs it.
|
||||
|
||||
> ⚠ **◐ The EXECUTABLE half is wired as of 2026-08-05; the STORE-ID half is
|
||||
> blocked.** `CheckBlockedExecutable` runs inside `EvaluateImpl` between the
|
||||
> module scan and the pre-scan, and an unresolvable identity refuses with
|
||||
@@ -250,6 +279,23 @@ Implemented in `FrameLedger.Injector` and reached from managed code through a th
|
||||
> rules file — and therefore every title on the machine (§S17).
|
||||
4. **Multiplayer heuristic** — if the pre-launch file scan finds an anti-cheat SDK shipped alongside the game (e.g. EOS anti-cheat binaries, `EasyAntiCheat/` directory) even when not currently loaded → refuse and explain.
|
||||
|
||||
> **Any kernel driver in the install tree counts, since 2026-09-25 (owner decision).** A `*.sys` file that no
|
||||
> `files` entry names is reported as `AntiCheatFile` under the family **"Kernel driver in the game folder"**. Every
|
||||
> driver this project has found shipped inside a game — `PGameProtectDriver_X64.sys`, `randgrid.sys`,
|
||||
> `NeacSafe64.sys`, `BlackCat64.sys`, `mhyprot*.sys` — was an anti-cheat's, and naming each one in data first is how
|
||||
> the next one walks past, as ACE's did in August. The rule is **code, not data** (`fl_prescan.cpp`,
|
||||
> `kKernelDriverInTreeFamily`): no rules file can remove it or rename its family. A named `files` entry still wins,
|
||||
> so `randgrid.sys` reads as Activision Ricochet. **The cost the owner accepted:** a game that ships a driver for
|
||||
> some other purpose (a wheel, a peripheral, an old disc check) has its hooking turned off like any finding, and
|
||||
> nothing clears it.
|
||||
>
|
||||
> **The advisory pre-scan takes the executable and resolves the install root itself, since 2026-09-25.**
|
||||
> `FlStaticPreScan(gameDirectory)` scanned the directory it was handed, and its one caller (`SetHookEnabled`) handed
|
||||
> it the executable's own folder — so for an Unreal title, the scan that decides whether hooking may be turned on
|
||||
> looked at `<root>\<Project>\Binaries\Win64\`, exactly where the Lies of P measurement below says `EasyAntiCheat/`
|
||||
> is not. The chokepoint always resolved the root. `FlStaticPreScanGame(exePath)` replaces it: the same
|
||||
> `ResolveInstallRoot`, plus check 3 on the executable's name and the install's store identity.
|
||||
|
||||
> **Implemented, and stated narrowly.** `fl_prescan.cpp` walks the target's
|
||||
> own directory (derived from its pid, never from a caller-supplied path) to
|
||||
> **depth 3** — raised from 2 on 2026-08-04 (§S22, `spike-notes.md` §13), because a
|
||||
@@ -360,13 +406,36 @@ them). Sessions that ran under it keep `guard-bypass=` in `capture_notes`; nothi
|
||||
|
||||
**What replaced it is the opposite of an override: a finding turns the game's hooking off.** The pre-scan has done
|
||||
this since P2 (`RecordGuardBlockAsync`: `hook_enabled = 0`, `hook_blocked_reason`, `hook_prescan_state = 'blocked'`).
|
||||
The two later moments the guard can find something now write the same block:
|
||||
Every later moment the guard can find something writes the same block — a fourth since 2026-09-25:
|
||||
|
||||
| Moment | Where | What it sees |
|
||||
|---|---|---|
|
||||
| hooking is turned on | `AgentCommandHandler.SetHookEnabledAsync` | check 4 over the game's folder |
|
||||
| hooking is turned on | `AgentCommandHandler.SetHookEnabledAsync` | checks 3 and 4 over the executable and its install root (`PreScanGameAsync`; check 4 over the executable's own folder until 2026-09-25) |
|
||||
| a session starts | `CaptureSession.SessionAsync`, after the gate | checks 1–4 over the live process, its tree, the drivers, the folder |
|
||||
| the 30 s re-scan | `CaptureSession.DrainAsync`, on a `SafetyUnhook` | the same, for an anti-cheat that loaded late |
|
||||
| the Agent's pre-scan of the library | `AntiCheatPreScanSweep`, under `--serve` | checks 3 and 4 over every entry, whether or not its hooking was ever on |
|
||||
|
||||
**The Agent's pre-scan of the library — owner decision 2026-09-25 (beta.8).** Until then the first three moments were
|
||||
the only ones, and each needs the user to have asked for hooking: a game nobody enabled stayed
|
||||
`hook_prescan_state = 'not_run'`, so the App could not tell an anti-cheat game from any other. The owner asked for the
|
||||
hooking part of anti-cheat games to be hidden, which needs to know which they are, so the Agent now asks the advisory
|
||||
question itself (`AntiCheatPreScanHostedService`: at start, every 15 s, and at once after `UpdateRules`):
|
||||
|
||||
- **Which entries.** Every library row not removed, once per rules version and executable — the key is its own
|
||||
(schema 0010: `hook_prescan_rules_version`, `hook_prescan_exe_size_bytes`, `hook_prescan_exe_mtime_ms`), so a rules
|
||||
update that names a game already in the library, or a game update that adds anti-cheat, is a re-scan. Skipped: a
|
||||
blocked row (it is never asked again), an executable that cannot be read, an entry whose session is running (that
|
||||
session's own checks are). *Change executable* clears the key with the state, so the new binary is scanned.
|
||||
- **What it writes** (`IGameConsentStore.RecordPreScanAsync`): a finding about the game is the block above, the
|
||||
consent stamp kept; a pass is `'clean'`; a scan that could not answer is `'unverified'`, which leaves the toggle
|
||||
alone. It never writes over a block and never adds a row — the `UPDATE` itself requires both, so a block written
|
||||
between the sweep's read and its write still stands.
|
||||
- **What it tells.** A `HookingTurnedOff` event (`07_IPC`) only when the entry's hooking was on: the one case where
|
||||
something the user switched on changed. Every other finding changes only the game's page and card.
|
||||
- **What it is not.** It gates nothing: every session start still runs checks 1–4 against the live process, whatever
|
||||
the sweep wrote. It opens no process — the scan reads the executable's path, its install folder and the stores'
|
||||
files. It holds the guard's lock for one walk at a time (`NativeAntiCheatGuard` serialises every native call), so a
|
||||
session start waits for at most the one walk in flight.
|
||||
|
||||
**Which findings** — `AntiCheatVerdict.IsFindingAboutTheGame`: an anti-cheat *named* (family non-empty) in the game's
|
||||
own process (`BlockedModule`), on its title lists (`BlockedExecutable`, `BlockedStoreId`) or in its folder
|
||||
@@ -378,6 +447,11 @@ scan that could not look, not unusable rules, not the unsigned-module heuristic,
|
||||
block (`Safety_Blocked_Toggle_Format`) with the toggle disabled; `capture_notes` carry
|
||||
`hooking-turned-off=<reason>/<family>`; the Agent's session line carries `; hooking-turned-off`; `CaptureRefused` and
|
||||
`SafetyUnhook` carry `hookingTurnedOff` (`07_IPC`). `CaptureOutcome.HookingTurnedOff` is the loop's word for it.
|
||||
Since 2026-09-25 (beta.8): the block is stored as `Reason|Family|Signal` so the App says what was found in the user's
|
||||
language (rows written before keep `"Reason: Family Signal"` and are shown as stored); the library card says
|
||||
*Anti-cheat* instead of *Hooking off*; and the game's page shows the finding **in place of** the Hooking card, whose
|
||||
switch could only be refused, while `ui.hide_anticheat_hooking` is on — its default (`08_UI` §Game detail). Off, the
|
||||
card is back with the finding under its disabled switch. The finding itself is on the page either way (FR-2.2).
|
||||
|
||||
**What clears it.** Nothing, as before: the block outlives *Change executable* and a re-import (§A game already enabled
|
||||
can become blocked later). The owner asked for hooking to be turned off when anti-cheat is detected, not for a second
|
||||
@@ -465,32 +539,107 @@ earlier version of this table produced an entry that was matched *literally* and
|
||||
therefore never fired. A silent hole in the blocklist, created by its own
|
||||
normative documentation. Write tokens here exactly as the data must hold them.
|
||||
|
||||
| Family | Group | Match | Tokens |
|
||||
|---|---|---|---|
|
||||
| Easy Anti-Cheat | `modules` | prefix | `EasyAntiCheat`, `EasyAntiCheat_EOS` |
|
||||
| Easy Anti-Cheat | `directories` | name | `EasyAntiCheat` |
|
||||
| Easy Anti-Cheat | `services` | name | `EasyAntiCheat`, `EasyAntiCheat_EOS`, `EasyAntiCheat_EOSSys` |
|
||||
| Easy Anti-Cheat | `drivers` | prefix | `EasyAntiCheat` — **machine-wide refusal** (check 2) |
|
||||
| BattlEye | `modules` | prefix | `BEClient`, `BEService` |
|
||||
| BattlEye | `directories` | name | `BattlEye` |
|
||||
| Riot Vanguard | `drivers` | exact | `vgk.sys` — **machine-wide refusal** (check 2) |
|
||||
| Riot Vanguard | `services` | name | `vgc` |
|
||||
| Denuvo Anti-Cheat | `modules` | prefix | `denuvo` |
|
||||
| nProtect GameGuard | `modules` | prefix | `GameGuard`, `npgg`, `GameMon` |
|
||||
| Xigncode3 | `modules` | prefix | `xhunter` |
|
||||
| Xigncode3 | `files` | name | `x3.xem` |
|
||||
| mihoyo protect | `drivers` | prefix | `mhyprot` |
|
||||
| FACEIT | `modules` | prefix | `faceit` |
|
||||
| ESEA | `modules` | prefix | `esea` |
|
||||
| PunkBuster | `modules` | prefix | `PnkBstr`, `pbcl`, `pbsv` |
|
||||
| Anti-Cheat Expert | `drivers` | exact | `ACE-BASE.sys`, `ACE-ADVT.sys`, `ACE-GAME.sys` — **machine-wide refusal** (check 2) |
|
||||
| Anti-Cheat Expert | `services` | name | `AntiCheatExpert Protection`, `AntiCheatExpert Service` |
|
||||
| Anti-Cheat Expert | `files` | name | `PGameProtectDriver_X64.sys` |
|
||||
| **Activision Ricochet** | — | — | **No data yet** — driver and service names unconfirmed (`20_OPEN_QUESTIONS` §S5) |
|
||||
| **Valve VAC** | — | — | **No data yet** — needs `blockedStoreIds`, whose half of check 3 **cannot be called** (§S14; the executable half was wired in #52, but a renamed exe defeats it anyway, which is why this row reserves the store-id route). **Measured 2026-08-04: a real VAC title returns `Allow`** (`spike-notes.md` §13) |
|
||||
| Family | Group | Match | Tokens | Added |
|
||||
|---|---|---|---|---|
|
||||
| Easy Anti-Cheat | `modules` | prefix | `EasyAntiCheat`, `EasyAntiCheat_EOS` | seed |
|
||||
| Easy Anti-Cheat | `drivers` | prefix | `EasyAntiCheat` — **machine-wide refusal** (check 2) | seed |
|
||||
| Easy Anti-Cheat | `directories` | name | `EasyAntiCheat`, `EasyAntiCheat_EOS` | seed; `EasyAntiCheat_EOS` 2026-09-25 |
|
||||
| Easy Anti-Cheat | `services` | name | `EasyAntiCheat`, `EasyAntiCheat_EOS`, `EasyAntiCheat_EOSSys` | seed |
|
||||
| Easy Anti-Cheat | `files` | name | `EasyAntiCheat_EOS_Setup.exe`, `EasyAntiCheat_Setup.exe`, `EasyAntiCheat_x64.dll`, `EasyAntiCheat_x86.dll`, `EasyAntiCheat_EOS.sys`, `start_protected_game.exe`, `eac_server64.dll` | 2026-09-25 |
|
||||
| BattlEye | `modules` | prefix | `BEClient`, `BEService` | seed |
|
||||
| BattlEye | `drivers` | exact | `BEDaisy.sys` — **machine-wide refusal** (check 2) | 2026-09-25 |
|
||||
| BattlEye | `directories` | name | `BattlEye` | seed |
|
||||
| BattlEye | `services` | name | `BEService`, `BEDaisy` | 2026-09-25 |
|
||||
| BattlEye | `files` | name | `BEService.exe`, `BEService_x64.exe`, `BEClient.dll`, `BEClient_x64.dll`, `BEDaisy.sys` | 2026-09-25 |
|
||||
| Denuvo Anti-Cheat | `modules` | prefix | `denuvo` | seed |
|
||||
| Denuvo Anti-Cheat | `drivers` | exact | `denuvo-anti-cheat.sys` — **machine-wide refusal** (check 2) | 2026-09-25 |
|
||||
| Denuvo Anti-Cheat | `services` | name | `denuvo-anti-cheat` | 2026-09-25 |
|
||||
| Denuvo Anti-Cheat | `files` | name | `denuvo-anti-cheat.sys`, `denuvo-anti-cheat-runtime.dll`, `denuvo-anti-cheat-update-service.exe` | 2026-09-25 |
|
||||
| nProtect GameGuard | `modules` | prefix | `GameGuard`, `npgg`, `GameMon` | seed |
|
||||
| nProtect GameGuard | `directories` | name | `GameGuard` | 2026-09-25 |
|
||||
| nProtect GameGuard | `services` | name | `npggsvc` | 2026-09-25 |
|
||||
| nProtect GameGuard | `files` | name | `GameGuard.des`, `GameMon.des`, `GameMon64.des`, `npggNT.des`, `npggNT64.des`, `npsc.des` | 2026-09-25 |
|
||||
| Xigncode3 | `modules` | prefix | `xhunter` | seed |
|
||||
| Xigncode3 | `modules` | exact | `x3.xem` | 2026-09-25 |
|
||||
| Xigncode3 | `drivers` | prefix | `xhunter` — **machine-wide refusal** (check 2) | 2026-09-25 |
|
||||
| Xigncode3 | `directories` | name | `XIGNCODE`, `XIGNCODE3` | 2026-09-25 |
|
||||
| Xigncode3 | `services` | name | `xhunter1` | 2026-09-25 |
|
||||
| Xigncode3 | `files` | name | `x3.xem`, `xhunter1.sys` | seed; `xhunter1.sys` 2026-09-25 |
|
||||
| PunkBuster | `modules` | prefix | `PnkBstr`, `pbcl`, `pbsv` | seed |
|
||||
| PunkBuster | `drivers` | prefix | `PnkBstrK` — **machine-wide refusal** (check 2) | 2026-09-25 |
|
||||
| PunkBuster | `directories` | name | `PunkBuster` | 2026-09-25 |
|
||||
| PunkBuster | `files` | name | `pbsvc.exe`, `PnkBstrA.exe`, `PnkBstrB.exe`, `pbsv.dll`, `pbcl.dll`, `pbag.dll` | 2026-09-25 |
|
||||
| FACEIT | `modules` | prefix | `faceit` | seed |
|
||||
| FACEIT | `drivers` | exact | `FACEIT.sys` — **machine-wide refusal** (check 2) | 2026-09-25 |
|
||||
| FACEIT | `services` | name | `FACEIT`, `FACEITService` | 2026-09-25 |
|
||||
| ESEA | `modules` | prefix | `esea` | seed |
|
||||
| ESEA | `drivers` | prefix | `ESEADriver` — **machine-wide refusal** (check 2) | 2026-09-25 |
|
||||
| ESEA | `services` | name | `ESEADriver2` | 2026-09-25 |
|
||||
| Riot Vanguard | `drivers` | exact | `vgk.sys` — **machine-wide refusal** (check 2) | seed |
|
||||
| Riot Vanguard | `services` | name | `vgc`, `vgk` | seed; `vgk` 2026-09-25 |
|
||||
| mihoyo protect | `modules` | prefix | `mhypbase` | 2026-09-25 |
|
||||
| mihoyo protect | `drivers` | prefix | `mhyprot`, `HoYoKProtect` — **machine-wide refusal** (check 2) | seed; `HoYoKProtect` 2026-09-25 |
|
||||
| mihoyo protect | `services` | name | `mhyprot2`, `mhyprot3`, `HoYoKProtect` | 2026-09-25 |
|
||||
| mihoyo protect | `files` | name | `mhypbase.dll`, `mhyprot2.sys`, `mhyprot3.sys`, `HoYoKProtect.sys` | 2026-09-25 |
|
||||
| Anti-Cheat Expert | `modules` | prefix | `SGuard`, `AntiCheatExpert` | 2026-09-25 |
|
||||
| Anti-Cheat Expert | `drivers` | exact | `ACE-BASE.sys`, `ACE-ADVT.sys`, `ACE-GAME.sys` — **machine-wide refusal** (check 2) | seed |
|
||||
| Anti-Cheat Expert | `directories` | name | `AntiCheatExpert`, `AceAntibotClient` | 2026-09-25 |
|
||||
| Anti-Cheat Expert | `services` | name | `AntiCheatExpert Protection`, `AntiCheatExpert Service` | seed |
|
||||
| Anti-Cheat Expert | `files` | name | `PGameProtectDriver_X64.sys`, `SGuard64.exe`, `SGuardSvc64.exe` | seed; `SGuard64.exe`, `SGuardSvc64.exe` 2026-09-25 |
|
||||
| EA AntiCheat | `modules` | prefix | `EAAntiCheat` | 2026-09-25 |
|
||||
| EA AntiCheat | `drivers` | exact | `EAAntiCheat.sys` — **machine-wide refusal** (check 2) | 2026-09-25 |
|
||||
| EA AntiCheat | `files` | name | `EAAntiCheat.Installer.exe`, `EAAntiCheat.GameServiceLauncher.exe`, `EAAntiCheat.GameServiceLauncher.dll` | 2026-09-25 |
|
||||
| NetEase Anti-Cheat | `modules` | prefix | `NeacSafe`, `NeacClient` | 2026-09-25 |
|
||||
| NetEase Anti-Cheat | `drivers` | prefix | `NeacSafe` — **machine-wide refusal** (check 2) | 2026-09-25 |
|
||||
| NetEase Anti-Cheat | `files` | name | `NeacSafe64.sys`, `NeacSafe64_ex.sys` | 2026-09-25 |
|
||||
| NetEase Yidun | `modules` | exact | `NEP2.dll` | 2026-09-25 |
|
||||
| NetEase Yidun | `files` | name | `NEP2.dll` | 2026-09-25 |
|
||||
| Nexon Game Security | `modules` | prefix | `BlackCipher`, `BlackCall`, `BlackXchg` | 2026-09-25 |
|
||||
| Nexon Game Security | `drivers` | exact | `BlackCat64.sys` — **machine-wide refusal** (check 2) | 2026-09-25 |
|
||||
| Nexon Game Security | `directories` | name | `BlackCipher` | 2026-09-25 |
|
||||
| Nexon Game Security | `files` | name | `BlackCipher.aes`, `BlackCipher64.aes`, `BlackCall.aes`, `BlackCall64.aes`, `BlackCat64.sys` | 2026-09-25 |
|
||||
| TenProtect | `modules` | prefix | `TP3Helper`, `TenSafe` | 2026-09-25 |
|
||||
| TenProtect | `drivers` | exact | `TesSafe.sys` — **machine-wide refusal** (check 2) | 2026-09-25 |
|
||||
| TenProtect | `files` | name | `TP3Helper.exe` | 2026-09-25 |
|
||||
| AhnLab HackShield | `modules` | prefix | `EhSvc`, `HShield`, `HSInst` | 2026-09-25 |
|
||||
| AhnLab HackShield | `directories` | name | `HShield` | 2026-09-25 |
|
||||
| AhnLab HackShield | `files` | name | `HSInst.dll`, `EhSvc.dll` | 2026-09-25 |
|
||||
| Anybrain | `modules` | exact | `anybrainSDK.dll`, `Cerebro.dll` | 2026-09-25 |
|
||||
| Anybrain | `files` | name | `anybrainSDK.dll`, `Cerebro.dll` | 2026-09-25 |
|
||||
| Roblox Hyperion | `modules` | exact | `RobloxPlayerBeta.dll` | 2026-09-25 |
|
||||
| Roblox Hyperion | `files` | name | `RobloxPlayerBeta.dll` | 2026-09-25 |
|
||||
| EQU8 | `modules` | prefix | `equ8` | 2026-09-25 |
|
||||
| EQU8 | `drivers` | prefix | `EQU8_HELPER` — **machine-wide refusal** (check 2) | 2026-09-25 |
|
||||
| EQU8 | `files` | name | `equ8_conf.json` | 2026-09-25 |
|
||||
| Activision Ricochet | `drivers` | exact | `randgrid.sys`, `brynhildr.sys`, `atvi-brynhildr.sys` — **machine-wide refusal** (check 2) | 2026-09-25 |
|
||||
| Activision Ricochet | `services` | name | `atvi-randgrid_sr`, `atvi-randgrid_msstore` | 2026-09-25 |
|
||||
| Activision Ricochet | `files` | name | `randgrid.sys` | 2026-09-25 |
|
||||
| FredaikisAntiCheat | `directories` | name | `FredaikisAntiCheat` | 2026-09-25 |
|
||||
| **Valve VAC** | — | — | ~~**No data yet** — needs `blockedStoreIds`, whose half of check 3 **cannot be called**~~ **Per-title lists since 2026-09-25** (check 3): 13 Steam app ids and 8 executables, the store half wired. VAC runs inside Steam, so no module, driver or file of the game's own can name it — this row stays a dash on purpose. (**Measured 2026-08-04: a real VAC title returned `Allow`**, `spike-notes.md` §13 — the gap these lists close.) | 2026-09-25 |
|
||||
|
||||
The "no data yet" rows are deliberately kept rather than deleted. An admitted
|
||||
gap is reviewable; a deleted row is invisible.
|
||||
gap is reviewable; a deleted row is invisible. ~~Activision Ricochet's was one of them~~ — it has data since
|
||||
2026-09-25 (below); VAC's stays until its per-title route exists.
|
||||
|
||||
> **Expanded 2026-09-25 (owner: "as many anti-cheats and as strict as possible").** Eleven families became
|
||||
> twenty-two and 19 entries became 74: EA AntiCheat, Activision Ricochet, NetEase Anti-Cheat, NetEase Yidun, Nexon
|
||||
> Game Security, TenProtect, AhnLab HackShield, EQU8, Anybrain, FredaikisAntiCheat and Roblox Hyperion are new, and
|
||||
> most existing families gained the groups they lacked — BattlEye's `BEDaisy.sys`, FACEIT's and ESEA's drivers,
|
||||
> `HoYoKProtect.sys` (which the `mhyprot` prefix never matched), Xigncode3's driver and service, Denuvo's driver.
|
||||
> **Every new token is DOCUMENTED, not measured**: the sources are SteamDB's `FileDetectionRuleSets` (MIT), the
|
||||
> vendors' own support pages (Activision RICOCHET, EA, FACEIT, BattlEye), LOLDrivers and DRML, named per entry in
|
||||
> the data's `note`. The ACE rule above still holds — a blocklist may over-cover and must never under-cover, and a
|
||||
> wrong token fails closed by never firing — so an unmeasured token is admitted, labelled, and left for a real title
|
||||
> to confirm. `kMaxFamilies` went 64 → 256 with it (2 × 74 no longer fitted).
|
||||
>
|
||||
> **Three services are deliberately absent**, and the reason is the RUNNING rule above: a service counts while it
|
||||
> runs, and a service that runs outside play refuses every session on the machine. `EAAntiCheatService` can be set
|
||||
> to start automatically; PunkBuster's `PnkBstrA` runs at every boot once installed; Denuvo's update service runs
|
||||
> apart from the game. Each family is caught through its driver, its modules or its files instead.
|
||||
>
|
||||
> **New `modules` rows are appended, never inserted.** The Overlay's `LoadLibrary` detour reports a 1-based index
|
||||
> into this group's order (`FlWriterState.earlyStopFamily` → `sessions.early_stop_family`), so a row inserted above
|
||||
> an existing one would change what indexes already stored mean.
|
||||
|
||||
> **Anti-Cheat Expert was added 2026-08-04 from measurement, not from reading.**
|
||||
> `ACE-BASE.sys` and `ACE-ADVT.sys` were found installed under `System32\drivers`
|
||||
@@ -740,6 +889,27 @@ detection. The conditions are the safety of it:
|
||||
*Change executable* is the other operation and stays what it was: a different binary, so hooking off, consent gone,
|
||||
pre-scan not run — it is the user saying "that file", not "that file moved".
|
||||
|
||||
**Two more answers, 2026-09-23 (owner decisions D26, D27).** Both are downgrades or neutral by construction; neither
|
||||
can move a consent onto a binary it was not given for.
|
||||
|
||||
- **D27 — the file moved and changed.** When the row's file is gone and the only file at its path under another
|
||||
letter has OTHER bytes (the game updated while the drive had another letter), the row follows it through *Change
|
||||
executable*'s write (`ChangeExecutableAsync`): the new size and mtime, hooking off, consent cleared, the pre-scan
|
||||
back to not run, the block kept. The user turns hooking on again for the new binary, through the disclosure, as
|
||||
for any changed executable. Two such files (two drives) is an ambiguity and refuses. The same rule holds for the
|
||||
watcher's adopt, whose session is then Tier 2 until the user does.
|
||||
- **D26 — two entries for one file.** When the move is refused because another entry already holds the target path
|
||||
— a twin made while the letter was different, as the owner's `H:` entries were — and the file there has the bytes
|
||||
the stale entry recorded, the two become one (`IGameMerge`, one transaction): the entry made first stays (its name,
|
||||
notes, consent and history), the other's sessions are re-parented to it, a block either carried is kept (hooking
|
||||
off; nothing clears a block, and a merge must not be how one disappears), a crash auto-disable still in force is
|
||||
kept, the crash counts add, and the dropped row is deleted. **Nothing about consent moves between the rows:** the
|
||||
survivor keeps its own record — which, when it is the entry that moves, is about these same bytes — and the dropped
|
||||
row's goes with it. A merge waits while a session of either entry runs or waits in a `.partial` to be recovered (a
|
||||
session finalized under a deleted entry would be dropped), and it is never done with an entry removed from the
|
||||
library. Other bytes under the twin are not merged: they do not prove the other entry is this game, so the log says
|
||||
so once and the user removes the entry they do not want.
|
||||
|
||||
### A game already enabled can become blocked later
|
||||
|
||||
FR-2.2 disables the toggle for titles that ship anti-cheat, and FR-2.3 refuses at
|
||||
|
||||
@@ -94,7 +94,7 @@ or it becomes the next stale status claim this file exists to record.
|
||||
| **S1** | ◐ **launch mode built as "inject late" 2026-09-06 (P1 item 2); the cost is now measured per title** | `FlGuardedInjectWhenReady` polls until a presentation runtime is mapped, then runs the full guard; `dxgiPresentsBeforeHook` and the reported wait are the input the 2026-08-05 deferral lacked. The ruling "inject late vs. no launch mode" is answered by construction — inject late exists — and whether it is *preferred* per title is what the numbers decide |
|
||||
| **S13(c)** | ✅ **salvageable, and salvaged 2026-09-06** | The externally observable proxy the entry proposed is what was built; the missing input is produced by every launched session |
|
||||
| **S19(b)** | 🅓 **deferred, rationale written — and MEASURED** | CI 2026-08-05: the fragment fires on `System.Security.Cryptography.ProtectedData.dll` loaded by a .NET **test host**, i.e. inside a real scan set in the launch-mode arrangement — refusing our own injection. The entry's "plausible and unmeasured" is superseded; the deferral rationale (a `CryptCATAdmin*` PR doing network I/O inside the hard gate, NFR-10) still stands. *(Marked 🔴 until 2026-08-27. The measurement belongs in this cell, not in the marker — a glyph that means "deferred" and a glyph that means "open defect" cannot be the same one in a table audited by counting.)* |
|
||||
| **S14** | 🅓 **exe half wired 2026-08-05; store-id half deferred to P4, rationale written 2026-09-06** | The store-id half's only in-policy route is P4's platform metadata extractors feeding a guard-side resolver; a resolver with no extractor would refuse every title. No title is blocked by store id today because none is listed |
|
||||
| **S14** | ✅ **both halves wired and seeded 2026-09-25** (exe half 2026-08-05) | ~~The store-id half's only in-policy route is P4's platform metadata extractors feeding a guard-side resolver~~ — built as a guard-side seam that reads Steam's `appmanifest_*.acf` and GOG's `goggame-<id>.info` itself; an install no store names is not refused, unreadable store metadata is. 30 Steam ids and 33 executables listed (rules 2026.09.4), floored. Epic has no reader |
|
||||
| **S23-1** | ✅ **resolved 2026-08-05** | `FlGuardBuildId` gives the Agent a build id of its own, and `ShmHandshakeValidator` performs the comparison `07_IPC` and `04_CAPTURE` both specify. Every refusal path is driven, including **both ids empty** — the shape the feature shipped in, where `"" == ""` reported `Ok` for every process on the machine |
|
||||
| **S23-4** | ✅ **resolved 2026-08-05** | `19_SAFETY` §During a session said "the module scan and the driver scan"; `EvaluateImpl` runs four. Reworded to "every pre-injection check" so it cannot go stale when a check is added, with the two omissions named — `services` is the only tier measured firing on real anti-cheat, and the pre-scan is the only one touching the filesystem |
|
||||
| **S2 part three** | ✅ **built 2026-09-06 (P1 item 3)** | In-layer supervision on the present path, landed with `vkQueuePresentKHR`; `unhookRequested` and the tick deadline both stop the layer (passthrough with the reason on the mapping), proven by a fake loader chain and a 1.5 s test-only flavour of the DLL |
|
||||
@@ -171,6 +171,10 @@ the recount becomes the next thing that needs recounting.
|
||||
> as ◐ two here rather than re-glyphing the rows: the rows were right and the paragraph was
|
||||
> wrong, and the residue of each is a run, not a rationale. P2's sequencing is `HANDOFF` §P2.
|
||||
>
|
||||
> **2026-09-25: S14 ✅.** The store-id half, one of the six deferrals of 2026-09-06 (to P4), is built and seeded
|
||||
> in the beta.8 train: a guard-side seam reads the store's own metadata, and the lists carry 30 Steam ids and 33
|
||||
> executables. The deferred set is five; ◐ stays two (S1, H11); nothing else in this count moved.
|
||||
>
|
||||
> **STILL TEN on 2026-08-27, for the third consecutive movement.** S31 moved from ❓ to ◐,
|
||||
> so ❓ goes four to three and ◐ goes two to three. **The number has now stayed at ten across
|
||||
> three different changes**, and that is worth saying out loud precisely because a reader
|
||||
@@ -1637,7 +1641,9 @@ a system DLL.
|
||||
|
||||
**Two families remain unrepresented in the data** — Activision Ricochet (driver
|
||||
and service names unconfirmed) and Valve VAC (needs `blockedStoreIds`). Recorded
|
||||
in the seed's own `$comment`. The `heuristic.trustedSigners` list is a guess and
|
||||
in the seed's own `$comment`. ~~Ricochet~~ **has data since 2026-09-25** (`randgrid.sys`,
|
||||
`atvi-randgrid_sr`/`_msstore`, from Activision's support pages — documented, unmeasured; `19_SAFETY`
|
||||
§Blocklist seed). VAC still has none. The `heuristic.trustedSigners` list is a guess and
|
||||
is marked UNVERIFIED.
|
||||
|
||||
### S13(c) · Is launch-mode injection salvageable?
|
||||
@@ -3158,7 +3164,14 @@ gate.
|
||||
> and the block's own comment says so. The block was rewritten to 2026-09-06 truth in the same
|
||||
> PR (the previous §4 note still said frame generation and ray tracing had no hook).
|
||||
|
||||
### S14 ◐ · Pre-injection check 3 is **unwired**, and has no "cannot determine" state
|
||||
### S14 ✅ · Pre-injection check 3 ~~is **unwired**, and has no "cannot determine" state~~ — both halves wired and seeded 2026-09-25
|
||||
|
||||
> **Closed 2026-09-25 (beta.8, owner decision: title lists yes, the AreWeAntiCheatYet bulk list no).** The store
|
||||
> half reads the store's own metadata through `Sources::StoreIdentity`, from the install root the guard derives
|
||||
> from the pid — the ABI is unchanged, which was reason (2). Reason (3) is answered by the matrix in `19_SAFETY`
|
||||
> check 3: listed refuses, no store identity is not applicable, unreadable store metadata refuses. Both lists are
|
||||
> seeded (30 Steam ids, 33 executables) and floored. What stays open is Epic, which has no reader and so carries no
|
||||
> identity to this check. The body below is the history.
|
||||
|
||||
Found 2026-08-02 while hardening the rules toolchain. `19_SAFETY` §Pre-injection
|
||||
checks lists a per-title blocklist as check 3, but `anticheat.blockedExecutables`
|
||||
|
||||
+119
-5
@@ -1448,9 +1448,10 @@ executable to another drive-letter root when the file is gone from the row's pat
|
||||
file with the same size and mtime — with consent, block and detection kept (`19_SAFETY` §A moved drive is the same
|
||||
executable). Three callers: the 15 s sweep, the watcher's file-name match, the enable-hooking command. The owner's
|
||||
log of the same morning is the case: 46 rows unreadable on `D:` while the drive sat on `H:`, GF2 and ELDEN RING
|
||||
running from `H:` "BY FILE NAME ONLY". **Not done, on purpose:** re-import does not merge a duplicate row an earlier
|
||||
running from `H:` "BY FILE NAME ONLY". ~~**Not done, on purpose:** re-import does not merge a duplicate row an earlier
|
||||
re-scan created at the new path (`LibraryImporter` still dedupes on path); the relocator refuses to move onto a path
|
||||
another row owns and says so in the log.
|
||||
another row owns and says so in the log.~~ **Done 2026-09-23 (D26/D27, the beta.6 section below):** twins with the
|
||||
same bytes merge, a changed file is followed with hooking off, and the import no longer adds a twin.
|
||||
|
||||
**Trap.** `FakeIdentity` in three test classes answers the same fingerprint for ANY path; a relocation test needs one
|
||||
that answers per path, or the "exactly one candidate" rule reads every root as a match.
|
||||
@@ -1472,7 +1473,7 @@ fact stands.
|
||||
|
||||
## 2026-09-23 — the beta.6 train: a file name is not an identity, one entry per executable, Tier 2 shown live
|
||||
|
||||
*Status is `CHANGELOG.md` `[Unreleased]` until the tag; this is what no other file carries. The owner's list and the
|
||||
*Status is `CHANGELOG.md` `[0.1.0-beta.6]`; this is what no other file carries. The owner's list and the
|
||||
evidence behind each item are in the approved plan the PRs cite; the decisions it took are D25–D28.*
|
||||
|
||||
**Decision (D25, owner: "HELLO, HELLO WORLD! was recorded as Flower in Us, twice").** A file name is not an identity:
|
||||
@@ -1484,7 +1485,23 @@ nothing until *Change executable* — accepted, because the alternative is exact
|
||||
in Us. **D28 (owner, same day):** HHW itself is measured by pointing an entry at `swiftshader\Game.exe` (the NW.js
|
||||
runtime its .NET launcher starts); no launcher-following in beta.6.
|
||||
|
||||
**Decision (D26, owner: "the library still shows two entries side by side after the drive letter changed, with the
|
||||
data unchanged").** The Agent merges two entries for one executable under two drive letters by itself: the stale
|
||||
entry's file is gone, the other entry holds the same path on another letter, and the file there has the bytes the
|
||||
stale entry recorded. The entry made first stays; the other's sessions join it; a block or a crash auto-disable in
|
||||
force is kept; no consent moves between them; it waits while a session of either runs or waits to be recovered
|
||||
(`CaptureOrchestrator.IsRecording`, `IPartialSessionStore.PendingGameIds`). `19_SAFETY` §A moved drive has the rules,
|
||||
`06_DATA_MODEL` the writer. The import no longer adds a twin: a store's executable that is a library entry's path on
|
||||
another letter, with that entry's file gone, is shown "in the library under another drive letter" and skipped.
|
||||
**D27 (owner, same day):** when the only file at the entry's path on another letter has other bytes, the entry follows
|
||||
it with hooking off (`ChangeExecutableAsync`, the *Change executable* write). Other bytes under a twin are NOT merged
|
||||
— the log says once which entry to remove.
|
||||
|
||||
**Traps.**
|
||||
- **`IGameMerge` is a second writer that can delete a `games` row.** Only the relocator calls it; a test that removes
|
||||
rows under a running session must expect the merge to wait (busy), not to race it.
|
||||
- **Python patch scripts: `\"` inside a normal triple-quoted string is an escaped quote**, so `@"C:\"` silently loses
|
||||
its backslash and the replace finds nothing (or worse, writes the wrong text). Use raw strings (`r"""…"""`) for C#.
|
||||
- **`FakeIdentity` in `CaptureOrchestratorTests` answers every path with the same bytes — which is exactly the hazard
|
||||
D25 closed**, so it is the right fake for "identical bytes in another folder are another game" and the wrong one for
|
||||
any test that needs a relocation to succeed (use `ExecutableRelocatorTests.DiskByPath`).
|
||||
@@ -1497,6 +1514,102 @@ runtime its .NET launcher starts); no launcher-following in beta.6.
|
||||
were a removal (to clean up an `H:` twin) under a running session. The finalize now resolves the owner; a test that
|
||||
deletes a row mid-session must expect `GameRemoved` or a re-keyed row, never an exception.
|
||||
|
||||
**Tier 2 on the wire (item 4a, owner: "capture still does not show when some titles are launched").** `SessionStarted`
|
||||
is published ONCE per session — at the attach, or at a held session's first tick carrying `hold` — so the card never
|
||||
flickers between tiers; a held session's 1 Hz is `SessionHeld`, never `SessionProgress` (its required fields would put
|
||||
zeros that look measured on the wire); the refusal's event goes out when the hold begins and is not repeated at the
|
||||
end; a faulted session completes with `finalize: faulted`. Every list of running sessions the App keeps is seeded from
|
||||
the status at each connect (`07_IPC` §Client behavior). All fields are additive: `IpcProtocol.Version` stays 2.
|
||||
|
||||
**Traps.**
|
||||
- **Only `hold` means held.** The status lists every session that has not attached yet at tier 2 (beta.5's shape,
|
||||
kept), so a tier-2 `ActiveSession` without `hold` is a session STARTING. The card shows its name and badge and
|
||||
nothing else; "nothing is measured" and "Attached — waiting for the first frames…" would both be false there.
|
||||
- **`sed -i` in this machine's Git Bash writes a CRLF file back as LF.** Twice on 2026-09-23 a one-line `sed -i` turned
|
||||
a test file into `w/lf` (`git ls-files --eol`), which `dotnet format` then fails on for no visible reason. Check
|
||||
`git ls-files --eol -m -o --exclude-standard | grep -v w/crlf` after any shell edit; `unix2dos` repairs it.
|
||||
- **Heredocs that carry C# with nested quotes can fail to parse in the Bash tool** ("unexpected EOF while looking for
|
||||
matching `'`") even when quoted `<<'EOF'` — write the script with the Write tool and run it by path, as the traps
|
||||
above already say for patches.
|
||||
|
||||
## 2026-09-23 (after 0.1.0-beta.6) — the recording switch
|
||||
|
||||
*Status is `CHANGELOG.md` `[0.1.0-beta.7]`; this is what no other file carries.*
|
||||
|
||||
**Decision (D29, owner: "the Agent records Borderless Gaming although hooking is off, and it starts with Windows —
|
||||
propose an ignore list, a disable, or something suitable").** Both, as one mechanism: a per-entry **Recording**
|
||||
switch (`games.record_sessions`, schema 0009, FR-1.6) the user owns, and the import's known-tools list
|
||||
(`SteamLibrarySource.KnownTools`) applied once to the entries an earlier import made, which start with it off. Off
|
||||
means the program is not watched at all (the watchlist is the entries whose recording is on), a running session of it
|
||||
stops at the next poll, and `LaunchGame` answers `RecordingOff`. Not chosen: a hard-coded list the watcher consults
|
||||
(no user control, and a list is never complete), and D23's recorded alternative of recording Tier 2 only for entries
|
||||
hooking was once enabled for (it would take back the Tier-2 sessions the owner asked for). The Privacy Policy (2.3) and
|
||||
the Disclaimer (2.6, whose accuracy block also carries #224's correction) were bumped with the owner's leave ("sửa docs
|
||||
và legal"), so the Legal Gate shows both once.
|
||||
|
||||
**Traps.**
|
||||
- **A pid the watcher matched stays matched.** Switching recording off stops the session but leaves the process in
|
||||
`ProcessWatcher`'s table, so switching it back on while the same process still runs starts nothing until it restarts.
|
||||
A process the watcher never matched (off from the start) is picked up by the next poll.
|
||||
- **A migration that changes data needs its own rewind in a test.** `RewindSchemaAsync` leaves columns in place, so
|
||||
`ScriptNineAddsTheRecordingSwitchOffForSteamToolsOnly` drops the column itself before re-applying 0009.
|
||||
- **`SqliteGameRepository._columns` is read by ordinal** (`ReadMore`): a new column goes at the end of the list, and the
|
||||
twin merge reads its own columns — both had to learn `record_sessions`.
|
||||
|
||||
## 2026-09-25 — the beta.8 train
|
||||
|
||||
*Status is `CHANGELOG.md` `[Unreleased]` (then `[0.1.0-beta.8]`); this is what no other file carries. The owner's list
|
||||
(eight items: the anti-cheat set as large and strict as possible, hiding the hook part for anti-cheat games, more
|
||||
metadata, NVIDIA App overrides, clearer reasons, a working Trend, FPS decimals, chart fixes) is planned as nine PRs in
|
||||
one approved plan; each PR cites it.*
|
||||
|
||||
**Decision (D30, owner, asked before any code: "which strict rules, beyond named tokens?").** Two of three: **any
|
||||
kernel driver (`*.sys`) inside a game's install tree** is a finding (code, not data — `kKernelDriverInTreeFamily`),
|
||||
and **per-title lists** (30 Steam ids, 33 executables across nine families, floored like the families). **Not** the
|
||||
AreWeAntiCheatYet bulk import (~250 Steam ids): community data that keeps listing a game after it drops its anti-cheat
|
||||
would turn hooking off for good, since nothing clears a block. Recorded because the next person to "expand the list"
|
||||
will find that import one search away.
|
||||
|
||||
**Decision (D31, owner): the store half's matrix.** Listed → refuse; no store identity (a loose folder, an Epic
|
||||
install, a Steam folder no manifest names) → not applicable, recorded as nothing; a store layout whose metadata cannot
|
||||
be read → refuse (`PreScanFailed`). §S14's "unknown must never read clean" is kept by the third row; the second is not
|
||||
an unknown — it is the answer "this is not a store title", and refusing it would be the gate that cannot pass.
|
||||
|
||||
**Decision (D32, owner, item 2: "an option to hide the hook part for games with anti-cheat").** Hide **and** scan:
|
||||
the Agent pre-scans every library entry itself (`AntiCheatPreScanSweep`, checks 3 and 4, once per rules version and
|
||||
executable — schema 0010's key), a finding is the same block every other moment writes, and the game's page shows
|
||||
the finding in place of the Hooking card while `ui.hide_anticheat_hooking` is on (default on). Tier 2 is still
|
||||
recorded. **Why not the setting alone:** most entries sat at `hook_prescan_state = 'not_run'` — the pre-scan ran only
|
||||
when someone asked for hooking — so a hide keyed on a finding would have hidden nothing on most libraries. **What it
|
||||
must never become:** a gate. The chokepoint runs checks 1–4 at every session start whatever the sweep wrote; the sweep
|
||||
only answers early, writes through the consent store's block-preserving `UPDATE`, and hides a control that could
|
||||
only be refused, never the finding (FR-2.2).
|
||||
|
||||
**Traps.**
|
||||
- **`Rules` is ~650 KB now** (256 families, 128 per-title rules). `x = Rules{}` builds that on the stack before
|
||||
copying — use `ResetRules`. The Vulkan layer parses on a game's own `vkCreateInstance` thread, and native tests hold
|
||||
it on the heap (two in one test function overflowed the 1 MB default).
|
||||
- **New `anticheat.modules` rows go at the END.** The Overlay's early stop reports a 1-based index into that order, and
|
||||
`sessions.early_stop_family` stores it.
|
||||
- **`sed -i` and the Bash tool's heredocs strike again**: a heredoc halved `\\` in a Python patch (a C# verbatim path
|
||||
still matched by luck), and a one-line `sed -i` turned `layer.cpp` into LF. Scripts go through the Write tool and run
|
||||
by path; `git ls-files --eol -m` after any shell edit.
|
||||
- **`'clean'` is not new.** `AgentCommandHandler` has stamped it on every consented enable since P3; the sweep adds it
|
||||
for entries nobody enabled. Nothing gates on it — a reader that treats `'clean'` as "may hook" is a second gate.
|
||||
- **The sweep's notice is not a refusal.** `HookingTurnedOff` is `SafetyNoticeKind.HookingOff` with Dismiss: a
|
||||
`Refused` kind would offer "record this session without measuring it" with no session running.
|
||||
- **Analyzers on tests:** CA2000 flags a disposable passed into a record's constructor (construct it inside a class
|
||||
that disposes it), MA0023 a regex with numbered groups (name them), CA1062 a `[Theory]` string parameter
|
||||
dereferenced without a check.
|
||||
- **`exe_machine` NULL is stale (schema 0011).** The detection sweep re-reads any row whose executable facts this build
|
||||
has not written — so a test double of `IGameRepository.ApplyDetectionAsync` that drops the new fields makes every
|
||||
sweep test re-scan forever. `unknown` is the stored "looked, could not tell".
|
||||
- **`FileVersionInfo` on a System32 file reads its `.mui`.** `version.dll` read in place said 6.2.x, its copy in a temp
|
||||
folder 10.0.x: compare a version against the file that was read, never against its source.
|
||||
- **A 32-bit refusal is not a block.** `ExecutableNotX64` writes nothing — no `hook_blocked_reason`, no stamp — so a
|
||||
64-bit build of the same game under *Change executable* can be hooked; the sweep's turn-off uses
|
||||
`hook_autodisabled_reason`, which the page does not offer to undo while the file is still 32-bit.
|
||||
|
||||
## Owner-only — no PR can close these
|
||||
|
||||
1. **§S23-2 — branch protection.** `Rules / validate` is not a required status check on
|
||||
@@ -1512,8 +1625,9 @@ runtime its .NET launcher starts); no launcher-following in beta.6.
|
||||
2026-09-03 (P4) and 2026-09-04 (P1); done.** What is still owed here is the **quality
|
||||
preset** on a title that chains `sl::DLSSOptions` — Alan Wake 2 is the candidate — and
|
||||
the DLSS-G identity on a title where `kFeatureDLSS_G` is evaluated, if one exists.
|
||||
3. **Which titles** go in `blockedExecutables` — a product decision with false-refusal
|
||||
consequences. The list ships empty until it is taken.
|
||||
3. ~~**Which titles** go in `blockedExecutables` — a product decision with false-refusal
|
||||
consequences. The list ships empty until it is taken.~~ **Taken 2026-09-25 (D30):** per-title
|
||||
lists by Steam id and executable name, seeded and floored (§2026-09-25 — the beta.8 train).
|
||||
4. **§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
|
||||
|
||||
+6
-5
@@ -11,11 +11,12 @@
|
||||
that changes what FrameLedger.Overlay or the capture host does; date the change.
|
||||
HTML comments are not part of the block.
|
||||
-->
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-09-22.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.5`** (2026-09-22), an unsigned installer built from that tag with its
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-09-23.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.7`** (2026-09-23), an unsigned installer built from that tag with its
|
||||
> checksums published beside it. The source holds the desktop app
|
||||
> (library, store import, charts, settings) and the background Agent, which records a session when a
|
||||
> game in the library runs, injects only into games you enabled and only past the safety guard, and
|
||||
> game in the library runs (unless you switched its recording off), injects only into games you enabled
|
||||
> and only past the safety guard, and
|
||||
> stores sessions in a local database. What that path measures:
|
||||
>
|
||||
> - **Frame times and output resolution:** measured from the present call for Direct3D 11/12 and
|
||||
@@ -28,8 +29,8 @@
|
||||
> NVIDIA Streamline (with Ray Reconstruction Yes/No), and FSR through AMD's shipped FidelityFX DLLs:
|
||||
> named FSR 3 from the older DLLs, and FSR without a version from the newer ones, which host both
|
||||
> FSR 3.1 and FSR 4. FSR 2, and FSR shipped any other way, is not identified. For DLSS titles that
|
||||
> bypass Streamline, the NVIDIA driver's own per-process record is stored with the session, labelled
|
||||
> *driver-reported*; the app does not display it yet. Intel XeSS is **not** read (its SDK licence
|
||||
> bypass Streamline, the NVIDIA driver's own per-process record is stored with the session and shown
|
||||
> as *DLSS (driver-reported)*. Intel XeSS is **not** read (its SDK licence
|
||||
> forbids it), and neither is an upscaler compiled into the game: those read `N/A`, or "Unknown
|
||||
> upscaler" when another vendor's hook ran in the game. Vulkan and OpenGL titles read `N/A`.
|
||||
> - **Quality preset:** not reported on any title measured. The one route this software may use — the
|
||||
|
||||
+7
-6
@@ -1,6 +1,6 @@
|
||||
# FrameLedger — Disclaimer
|
||||
|
||||
**Version:** 2.5 · **Effective:** {{RELEASE_DATE}}
|
||||
**Version:** 2.6 · **Effective:** {{RELEASE_DATE}}
|
||||
|
||||
> **How this document is kept true.** The statement of what FrameLedger measures (§4) is `legal/ACCURACY.md`,
|
||||
> embedded here and in `README.md` and bound to its source by `tools/accuracy-check.ps1`, which fails the build when a
|
||||
@@ -97,11 +97,12 @@ Software running inside another process can, in principle, destabilize it. Frame
|
||||
Frame timing is derived from high-resolution timestamps taken at the moment the game presents each frame; upscaling, frame-generation and ray-tracing state are read from the parameters the game passes to those APIs. This is substantially more accurate than inferring settings from files on disk, but **no measurement is guaranteed to be exact**:
|
||||
|
||||
<!-- accuracy-block:begin -->
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-09-22.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.5`** (2026-09-22), an unsigned installer built from that tag with its
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-09-23.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.7`** (2026-09-23), an unsigned installer built from that tag with its
|
||||
> checksums published beside it. The source holds the desktop app
|
||||
> (library, store import, charts, settings) and the background Agent, which records a session when a
|
||||
> game in the library runs, injects only into games you enabled and only past the safety guard, and
|
||||
> game in the library runs (unless you switched its recording off), injects only into games you enabled
|
||||
> and only past the safety guard, and
|
||||
> stores sessions in a local database. What that path measures:
|
||||
>
|
||||
> - **Frame times and output resolution:** measured from the present call for Direct3D 11/12 and
|
||||
@@ -114,8 +115,8 @@ Frame timing is derived from high-resolution timestamps taken at the moment the
|
||||
> NVIDIA Streamline (with Ray Reconstruction Yes/No), and FSR through AMD's shipped FidelityFX DLLs:
|
||||
> named FSR 3 from the older DLLs, and FSR without a version from the newer ones, which host both
|
||||
> FSR 3.1 and FSR 4. FSR 2, and FSR shipped any other way, is not identified. For DLSS titles that
|
||||
> bypass Streamline, the NVIDIA driver's own per-process record is stored with the session, labelled
|
||||
> *driver-reported*; the app does not display it yet. Intel XeSS is **not** read (its SDK licence
|
||||
> bypass Streamline, the NVIDIA driver's own per-process record is stored with the session and shown
|
||||
> as *DLSS (driver-reported)*. Intel XeSS is **not** read (its SDK licence
|
||||
> forbids it), and neither is an upscaler compiled into the game: those read `N/A`, or "Unknown
|
||||
> upscaler" when another vendor's hook ran in the game. Vulkan and OpenGL titles read `N/A`.
|
||||
> - **Quality preset:** not reported on any title measured. The one route this software may use — the
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# FrameLedger — Privacy Policy
|
||||
|
||||
**Version:** 2.2 · **Effective:** {{RELEASE_DATE}}
|
||||
**Version:** 2.3 · **Effective:** {{RELEASE_DATE}}
|
||||
|
||||
**Short version: everything stays on your PC. FrameLedger has no accounts, no telemetry, no analytics, and never uploads your data anywhere.**
|
||||
|
||||
@@ -8,7 +8,7 @@
|
||||
|
||||
Stored in `%LOCALAPPDATA%\FrameLedger` on your device:
|
||||
|
||||
- Your game library entries (names, executable paths, metadata you or the app filled in).
|
||||
- Your game library entries (names, executable paths, metadata you or the app filled in, and whether each one is recorded).
|
||||
- Performance sessions: frame timing series, computed statistics, hardware sensor series (temperatures, load, memory usage), session duration, crash flags, tags and notes you write.
|
||||
- A hardware snapshot per session (CPU/GPU model, driver version, RAM size, OS build, display mode) used for the "what changed between sessions" feature.
|
||||
- App settings, logs (rotated daily — the app keeps 7 days, the capture agent 14 — including the logs written by the component loaded into games), and, after a crash of the app itself, crash dump files.
|
||||
@@ -37,9 +37,11 @@ The "Report a bug" feature builds a zip file **on your device**, shows you exact
|
||||
|
||||
## 4. What the app can technically observe
|
||||
|
||||
To do its job, FrameLedger observes: which of *your tracked* executables are running and their process trees; the parameters your games pass to the graphics APIs it intercepts (presentation, upscaling, ray tracing, pipeline creation); video-memory usage reported by the graphics runtime; loaded module names of a game being captured (for detection and for the anti-cheat safety check); and hardware sensor values from your graphics driver's own libraries.
|
||||
To do its job, FrameLedger observes: which of *your tracked* executables — the entries in your library whose recording is on — are running, and their process trees; the parameters your games pass to the graphics APIs it intercepts (presentation, upscaling, ray tracing, pipeline creation); video-memory usage reported by the graphics runtime; loaded module names of a game being captured (for detection and for the anti-cheat safety check); and hardware sensor values from your graphics driver's own libraries.
|
||||
|
||||
It does **not** read game memory outside those API parameters, and does not read game saves, chat, input content, network traffic, or anything unrelated to performance measurement. It records only for games you added to your library, and injects only into games you individually enabled.
|
||||
It does **not** read game memory outside those API parameters, and does not read game saves, chat, input content, network traffic, or anything unrelated to performance measurement. It records only for programs you added to your library and did not switch recording off for — a program whose recording is off is not watched at all — and injects only into games you individually enabled.
|
||||
|
||||
> **History.** Version 2.3 (2026-09-23) adds the per-entry recording switch. Before it, every program in your library was recorded whenever it ran, which recorded a utility that starts with Windows at every boot.
|
||||
|
||||
All of this stays on your device. None of it is transmitted anywhere.
|
||||
|
||||
|
||||
+189
-24
@@ -15,16 +15,15 @@
|
||||
"compilability, case-insensitive duplicate values — stay imperative in",
|
||||
"tools/rules-validate.ps1.",
|
||||
"",
|
||||
"STILL INCOMPLETE AS DATA: docs/19_SAFETY §Blocklist seed names two families",
|
||||
"with no representation here at all — Activision Ricochet (driver/service",
|
||||
"names not yet confirmed) and Valve VAC (needs blockedStoreIds entries).",
|
||||
"STILL INCOMPLETE AS DATA: docs/19_SAFETY §Blocklist seed names one family",
|
||||
"with no representation here at all — Valve VAC (needs blockedStoreIds",
|
||||
"entries). Activision Ricochet was the other until 2026-09-25, when its",
|
||||
"driver and services arrived from Activision's own support pages.",
|
||||
"",
|
||||
"PRE-INJECTION CHECK 3 MATCHES NOTHING, because `blockedExecutables` and",
|
||||
"`blockedStoreIds` are both empty. That is a fact about THIS DATA, which is",
|
||||
"why it is stated here; seeding the lists is a product decision (which",
|
||||
"titles, and what an unresolvable store id means) tracked as",
|
||||
"docs/20_OPEN_QUESTIONS.md §S14. Recorded rather than left to be inferred",
|
||||
"from two empty arrays.",
|
||||
"PRE-INJECTION CHECK 3 MATCHED NOTHING until 2026-09-25, because",
|
||||
"`blockedExecutables` and `blockedStoreIds` were both empty. The owner seeded",
|
||||
"them that day (rules 2026.09.4); what an unresolvable store id means is",
|
||||
"the matrix in docs/19_SAFETY check 3 (docs/20_OPEN_QUESTIONS.md §S14).",
|
||||
"",
|
||||
"WHICH CHECKS RUN IS DELIBERATELY NOT STATED HERE ANY MORE. This comment used",
|
||||
"to list them — a FOURTH restatement of the gate's composition, in the one",
|
||||
@@ -41,7 +40,7 @@
|
||||
"level, which made it a check that could not fire."
|
||||
],
|
||||
"schemaVersion": 2,
|
||||
"rulesVersion": "2026.09.1",
|
||||
"rulesVersion": "2026.09.5",
|
||||
|
||||
"engines": [
|
||||
{
|
||||
@@ -84,6 +83,23 @@
|
||||
] },
|
||||
"version": null
|
||||
},
|
||||
{
|
||||
"id": "re_engine",
|
||||
"name": "RE Engine",
|
||||
"signals": { "any": [
|
||||
{ "type": "sibling_glob", "value": "re_chunk_000.pak" }
|
||||
] },
|
||||
"version": null
|
||||
},
|
||||
{
|
||||
"id": "fromsoftware",
|
||||
"name": "FromSoftware",
|
||||
"signals": { "all": [
|
||||
{ "type": "sibling_glob", "value": "*.bhd" },
|
||||
{ "type": "sibling_glob", "value": "*.bdt" }
|
||||
] },
|
||||
"version": null
|
||||
},
|
||||
{
|
||||
"id": "godot",
|
||||
"name": "Godot",
|
||||
@@ -166,8 +182,8 @@
|
||||
{ "id": "dlss_g", "name": "DLSS Frame Gen", "signals": [ "nvngx_dlssg.dll", "sl.dlss_g.dll" ] },
|
||||
{ "id": "dlss_rr", "name": "Ray Reconstruction","signals": [ "nvngx_dlssd.dll" ] },
|
||||
{ "id": "streamline", "name": "Streamline", "signals": [ "sl.interposer.dll", "sl.reflex.dll" ] },
|
||||
{ "id": "fsr", "name": "FSR", "signals": [ "ffx_fsr2_*.dll", "ffx_frameinterpolation_*.dll", "amd_fidelityfx_*.dll", "ffx_api*.dll" ] },
|
||||
{ "id": "xess", "name": "XeSS", "signals": [ "libxess.dll" ] },
|
||||
{ "id": "fsr", "name": "FSR", "signals": [ "ffx_fsr2_*.dll", "ffx_fsr3*.dll", "ffx_frameinterpolation_*.dll", "amd_fidelityfx_*.dll", "ffx_api*.dll" ] },
|
||||
{ "id": "xess", "name": "XeSS", "signals": [ "libxess.dll", "libxess_dx11.dll" ] },
|
||||
{ "id": "xefg", "name": "XeSS Frame Gen", "signals": [ "libxess_fg.dll" ] }
|
||||
],
|
||||
|
||||
@@ -181,30 +197,129 @@
|
||||
{ "family": "Xigncode3", "match": "prefix", "values": [ "xhunter" ] },
|
||||
{ "family": "PunkBuster", "match": "prefix", "values": [ "PnkBstr", "pbcl", "pbsv" ] },
|
||||
{ "family": "FACEIT", "match": "prefix", "values": [ "faceit" ] },
|
||||
{ "family": "ESEA", "match": "prefix", "values": [ "esea" ] }
|
||||
{ "family": "ESEA", "match": "prefix", "values": [ "esea" ] },
|
||||
{ "family": "Anti-Cheat Expert", "match": "prefix", "values": [ "SGuard", "AntiCheatExpert" ],
|
||||
"note": "APPENDED 2026-09-25, as every row below: the Overlay reports a 1-based index into this array (sessions.early_stop_family), so a row inserted above shifts what stored indexes mean. SGuard64/SGuardSvc64 are ACE's guard processes (documented, file.net; unmeasured)." },
|
||||
{ "family": "EA AntiCheat", "match": "prefix", "values": [ "EAAntiCheat" ],
|
||||
"note": "EA Javelin: EAAntiCheat.GameServiceLauncher.dll / EAAntiCheat.GameService.exe (documented, EA forums). Unmeasured." },
|
||||
{ "family": "NetEase Anti-Cheat", "match": "prefix", "values": [ "NeacSafe", "NeacClient" ],
|
||||
"note": "NEAC (Naraka, Marvel Rivals, FragPunk). NeacSafe64 is documented (LOLDrivers, SteamDB NetEase_AntiCheatExperts); NeacClient unmeasured." },
|
||||
{ "family": "NetEase Yidun", "match": "exact", "values": [ "NEP2.dll" ],
|
||||
"note": "Documented (SteamDB FileDetectionRuleSets, NetEase_Yidun). Unmeasured." },
|
||||
{ "family": "Nexon Game Security", "match": "prefix", "values": [ "BlackCipher", "BlackCall", "BlackXchg" ],
|
||||
"note": "BlackCipher64.aes runs as its own process in the game's tree (The First Descendant, MapleStory). Documented (SteamDB BlackCipher). Unmeasured." },
|
||||
{ "family": "mihoyo protect", "match": "prefix", "values": [ "mhypbase" ],
|
||||
"note": "mhypbase.dll is the user-mode half HoYoverse titles load. Documented; unmeasured." },
|
||||
{ "family": "TenProtect", "match": "prefix", "values": [ "TP3Helper", "TenSafe" ],
|
||||
"note": "Tencent TenProtect. TP3Helper documented (SteamDB); TenSafe unmeasured." },
|
||||
{ "family": "AhnLab HackShield", "match": "prefix", "values": [ "EhSvc", "HShield", "HSInst" ],
|
||||
"note": "Documented (SteamDB HackShield: HShield/HSInst.dll). Unmeasured." },
|
||||
{ "family": "Anybrain", "match": "exact", "values": [ "anybrainSDK.dll", "Cerebro.dll" ],
|
||||
"note": "Behavioural, user-mode. Documented (SteamDB AnyBrain). Unmeasured." },
|
||||
{ "family": "Roblox Hyperion", "match": "exact", "values": [ "RobloxPlayerBeta.dll" ],
|
||||
"note": "Hyperion (Byfron) protects this module inside the Roblox player. Documented; unmeasured." },
|
||||
{ "family": "EQU8", "match": "prefix", "values": [ "equ8" ],
|
||||
"note": "Splitgate. Documented (SteamDB EQU8); module names unmeasured." },
|
||||
{ "family": "Xigncode3", "match": "exact", "values": [ "x3.xem" ],
|
||||
"note": "x3.xem is XIGNCODE3's loader, LoadLibrary'd as an ordinary module (documented). The files row names the same token in the install tree." }
|
||||
],
|
||||
"drivers": [
|
||||
{ "family": "Riot Vanguard", "match": "exact", "values": [ "vgk.sys" ], "scope": "machine" },
|
||||
{ "family": "mihoyo protect", "match": "prefix", "values": [ "mhyprot" ], "scope": "machine" },
|
||||
{ "family": "mihoyo protect", "match": "prefix", "values": [ "mhyprot", "HoYoKProtect" ], "scope": "machine",
|
||||
"note": "HoYoKProtect.sys (Genshin Impact's overseas client, 2025) is NOT matched by the mhyprot prefix, so it is named here (documented; unmeasured)." },
|
||||
{ "family": "Easy Anti-Cheat", "match": "prefix", "values": [ "EasyAntiCheat" ], "scope": "machine",
|
||||
"note": "MEASURED 2026-08-04: EasyAntiCheat_EOSSys was Running as a kernel driver while a real EAC title played, and matched NOTHING in this group — the refusal came from the service check instead. A family caught through only one of five groups is one rename away from being missed." },
|
||||
{ "family": "Anti-Cheat Expert", "match": "exact", "values": [ "ACE-BASE.sys", "ACE-ADVT.sys", "ACE-GAME.sys" ], "scope": "machine",
|
||||
"note": "ACE-BASE.sys and ACE-ADVT.sys MEASURED under System32\\drivers on the dev machine 2026-08-04. ACE-GAME.sys is a documented sibling and is UNMEASURED: a blocklist may over-cover, never under-cover. Exact not prefix — 'ACE-' is four characters over a namespace we do not own." }
|
||||
"note": "ACE-BASE.sys and ACE-ADVT.sys MEASURED under System32\\drivers on the dev machine 2026-08-04. ACE-GAME.sys is a documented sibling and is UNMEASURED: a blocklist may over-cover, never under-cover. Exact not prefix — 'ACE-' is four characters over a namespace we do not own." },
|
||||
{ "family": "BattlEye", "match": "exact", "values": [ "BEDaisy.sys" ], "scope": "machine",
|
||||
"note": "BattlEye's kernel driver, loaded by BEService while a protected game runs and unloaded after (documented, BattlEye FAQ). Unmeasured." },
|
||||
{ "family": "FACEIT", "match": "exact", "values": [ "FACEIT.sys" ], "scope": "machine",
|
||||
"note": "Loaded while the FACEIT AC client runs (documented, FACEIT support). Unmeasured." },
|
||||
{ "family": "ESEA", "match": "prefix", "values": [ "ESEADriver" ], "scope": "machine",
|
||||
"note": "ESEADriver2.sys (documented). Unmeasured." },
|
||||
{ "family": "EA AntiCheat", "match": "exact", "values": [ "EAAntiCheat.sys" ], "scope": "machine",
|
||||
"note": "EA Javelin's kernel driver, loaded with the game (documented, EA forums). Unmeasured. Its user-mode EAAntiCheatService is deliberately NOT listed: it can be set to start automatically, and a service that is always running would refuse every session on the machine." },
|
||||
{ "family": "Activision Ricochet", "match": "exact", "values": [ "randgrid.sys", "brynhildr.sys", "atvi-brynhildr.sys" ], "scope": "machine",
|
||||
"note": "RICOCHET's kernel driver randgrid.sys (documented, Activision support; a kernel service pointing at the file in the game folder); brynhildr is its 2021 predecessor (Microsoft Q&A). Unmeasured." },
|
||||
{ "family": "NetEase Anti-Cheat", "match": "prefix", "values": [ "NeacSafe" ], "scope": "machine",
|
||||
"note": "NeacSafe64.sys, a minifilter loaded during play (documented, LOLDrivers). Unmeasured." },
|
||||
{ "family": "Xigncode3", "match": "prefix", "values": [ "xhunter" ], "scope": "machine",
|
||||
"note": "xhunter1.sys, XIGNCODE3's kernel driver (documented, LOLDrivers / Wellbia FAQ). Unmeasured." },
|
||||
{ "family": "Denuvo Anti-Cheat", "match": "exact", "values": [ "denuvo-anti-cheat.sys" ], "scope": "machine",
|
||||
"note": "Loaded only while a protected game runs (documented, Irdeto Q&A; file name from DRML). Unmeasured." },
|
||||
{ "family": "EQU8", "match": "prefix", "values": [ "EQU8_HELPER" ], "scope": "machine",
|
||||
"note": "EQU8_HELPER_<n>.sys (documented). Unmeasured." },
|
||||
{ "family": "PunkBuster", "match": "prefix", "values": [ "PnkBstrK" ], "scope": "machine",
|
||||
"note": "PnkBstrK.sys, PunkBuster's kernel component. Unmeasured." },
|
||||
{ "family": "TenProtect", "match": "exact", "values": [ "TesSafe.sys" ], "scope": "machine",
|
||||
"note": "Tencent game-protection driver (documented). Unmeasured." },
|
||||
{ "family": "Nexon Game Security", "match": "exact", "values": [ "BlackCat64.sys" ], "scope": "machine",
|
||||
"note": "Documented (SteamDB BlackCipher). Unmeasured." }
|
||||
],
|
||||
"directories": [
|
||||
{ "family": "Easy Anti-Cheat", "values": [ "EasyAntiCheat" ] },
|
||||
{ "family": "BattlEye", "values": [ "BattlEye" ] }
|
||||
{ "family": "Easy Anti-Cheat", "values": [ "EasyAntiCheat", "EasyAntiCheat_EOS" ] },
|
||||
{ "family": "BattlEye", "values": [ "BattlEye" ] },
|
||||
{ "family": "Anti-Cheat Expert", "values": [ "AntiCheatExpert", "AceAntibotClient" ],
|
||||
"note": "Documented (SteamDB FileDetectionRuleSets, AntiCheatExpert). Unmeasured." },
|
||||
{ "family": "nProtect GameGuard", "values": [ "GameGuard" ] },
|
||||
{ "family": "Xigncode3", "values": [ "XIGNCODE", "XIGNCODE3" ] },
|
||||
{ "family": "AhnLab HackShield", "values": [ "HShield" ],
|
||||
"note": "Documented (SteamDB HackShield). Unmeasured." },
|
||||
{ "family": "Nexon Game Security", "values": [ "BlackCipher" ],
|
||||
"note": "Measured by others at M1/Binaries/Win64/BlackCipher/ (The First Descendant, Steam community); unmeasured here." },
|
||||
{ "family": "PunkBuster", "values": [ "PunkBuster" ],
|
||||
"note": "Documented (SteamDB PunkBuster). The two-letter pb/ folder some titles use is deliberately NOT a token: too short to be a signal." },
|
||||
{ "family": "FredaikisAntiCheat", "values": [ "FredaikisAntiCheat" ],
|
||||
"note": "Documented (SteamDB FileDetectionRuleSets). Unmeasured." }
|
||||
],
|
||||
"services": [
|
||||
{ "family": "Easy Anti-Cheat", "values": [ "EasyAntiCheat", "EasyAntiCheat_EOS", "EasyAntiCheat_EOSSys" ] },
|
||||
{ "family": "Riot Vanguard", "values": [ "vgc" ] },
|
||||
{ "family": "Riot Vanguard", "values": [ "vgc", "vgk" ],
|
||||
"note": "vgk is the kernel driver's service, started at boot like vgk.sys itself." },
|
||||
{ "family": "Anti-Cheat Expert", "values": [ "AntiCheatExpert Protection", "AntiCheatExpert Service" ],
|
||||
"note": "'AntiCheatExpert Protection' MEASURED registered on the dev machine 2026-08-04 by Neverness To Everness. The sibling name is unmeasured." }
|
||||
"note": "'AntiCheatExpert Protection' MEASURED registered on the dev machine 2026-08-04 by Neverness To Everness. The sibling name is unmeasured." },
|
||||
{ "family": "BattlEye", "values": [ "BEService", "BEDaisy" ],
|
||||
"note": "BEService is started by a protected game and stops after it; BEDaisy is the driver's service. A stopped service is absent (19_SAFETY). Unmeasured." },
|
||||
{ "family": "FACEIT", "values": [ "FACEIT", "FACEITService" ],
|
||||
"note": "Running while the FACEIT AC client runs (documented, FACEIT support). Unmeasured." },
|
||||
{ "family": "ESEA", "values": [ "ESEADriver2" ] },
|
||||
{ "family": "Activision Ricochet", "values": [ "atvi-randgrid_sr", "atvi-randgrid_msstore" ],
|
||||
"note": "Kernel services pointing at randgrid.sys; running only while Call of Duty runs (documented, Activision support). Unmeasured." },
|
||||
{ "family": "mihoyo protect", "values": [ "mhyprot2", "mhyprot3", "HoYoKProtect" ] },
|
||||
{ "family": "Xigncode3", "values": [ "xhunter1" ] },
|
||||
{ "family": "Denuvo Anti-Cheat", "values": [ "denuvo-anti-cheat" ],
|
||||
"note": "The driver's service. The separate update service runs outside play and is deliberately NOT listed." },
|
||||
{ "family": "nProtect GameGuard", "values": [ "npggsvc" ] }
|
||||
],
|
||||
"files": [
|
||||
{ "family": "Xigncode3", "values": [ "x3.xem" ], "note": "Data file shipped beside the game, not a loadable module." },
|
||||
{ "family": "Anti-Cheat Expert", "values": [ "PGameProtectDriver_X64.sys" ],
|
||||
"note": "A KERNEL DRIVER shipped inside the game install. MEASURED at 'Neverness To Everness/NTEGlobal/driver/' 2026-08-04, where check 4 returned Allow: no group named it, and the fuzzy tier is modules-only — so a name containing 'protect' sat in the game's tree and the static scan walked past." }
|
||||
{ "family": "Xigncode3", "values": [ "x3.xem", "xhunter1.sys" ],
|
||||
"note": "Shipped beside the game. This note said 'not a loadable module' until 2026-09-25: XIGNCODE3 LoadLibrary's x3.xem as its loader (documented), which is why the modules group names it too." },
|
||||
{ "family": "Anti-Cheat Expert", "values": [ "PGameProtectDriver_X64.sys", "SGuard64.exe", "SGuardSvc64.exe" ],
|
||||
"note": "A KERNEL DRIVER shipped inside the game install. MEASURED at 'Neverness To Everness/NTEGlobal/driver/' 2026-08-04, where check 4 returned Allow: no group named it, and the fuzzy tier is modules-only — so a name containing 'protect' sat in the game's tree and the static scan walked past." },
|
||||
{ "family": "Easy Anti-Cheat", "values": [ "EasyAntiCheat_EOS_Setup.exe", "EasyAntiCheat_Setup.exe", "EasyAntiCheat_x64.dll", "EasyAntiCheat_x86.dll", "EasyAntiCheat_EOS.sys", "start_protected_game.exe", "eac_server64.dll" ],
|
||||
"note": "For a layout where the EasyAntiCheat folder sits deeper than the scan reaches. start_protected_game.exe is the EAC launcher FromSoftware titles ship (ELDEN RING's appeared in the owner's Windows Application log on 2026-09-21)." },
|
||||
{ "family": "BattlEye", "values": [ "BEService.exe", "BEService_x64.exe", "BEClient.dll", "BEClient_x64.dll", "BEDaisy.sys" ],
|
||||
"note": "Documented (SteamDB BattlEye). Unmeasured." },
|
||||
{ "family": "EA AntiCheat", "values": [ "EAAntiCheat.Installer.exe", "EAAntiCheat.GameServiceLauncher.exe", "EAAntiCheat.GameServiceLauncher.dll" ],
|
||||
"note": "Documented (SteamDB EA_AntiCheat; EA forums). Unmeasured." },
|
||||
{ "family": "Activision Ricochet", "values": [ "randgrid.sys" ],
|
||||
"note": "The driver ships inside the game folder (documented, Activision support). Unmeasured." },
|
||||
{ "family": "mihoyo protect", "values": [ "mhypbase.dll", "mhyprot2.sys", "mhyprot3.sys", "HoYoKProtect.sys" ] },
|
||||
{ "family": "NetEase Anti-Cheat", "values": [ "NeacSafe64.sys", "NeacSafe64_ex.sys" ],
|
||||
"note": "Documented (SteamDB NetEase_AntiCheatExperts). Unmeasured." },
|
||||
{ "family": "NetEase Yidun", "values": [ "NEP2.dll" ] },
|
||||
{ "family": "Nexon Game Security", "values": [ "BlackCipher.aes", "BlackCipher64.aes", "BlackCall.aes", "BlackCall64.aes", "BlackCat64.sys" ] },
|
||||
{ "family": "TenProtect", "values": [ "TP3Helper.exe" ] },
|
||||
{ "family": "EQU8", "values": [ "equ8_conf.json" ] },
|
||||
{ "family": "AhnLab HackShield", "values": [ "HSInst.dll", "EhSvc.dll" ] },
|
||||
{ "family": "nProtect GameGuard", "values": [ "GameGuard.des", "GameMon.des", "GameMon64.des", "npggNT.des", "npggNT64.des", "npsc.des" ],
|
||||
"note": "GameGuard's engine files (documented, file.net / SteamDB). Unmeasured." },
|
||||
{ "family": "PunkBuster", "values": [ "pbsvc.exe", "PnkBstrA.exe", "PnkBstrB.exe", "pbsv.dll", "pbcl.dll", "pbag.dll" ],
|
||||
"note": "Files in the install tree, not services: PnkBstrA runs at every boot once installed, so as a service it would refuse every session on the machine." },
|
||||
{ "family": "Anybrain", "values": [ "anybrainSDK.dll", "Cerebro.dll" ] },
|
||||
{ "family": "Denuvo Anti-Cheat", "values": [ "denuvo-anti-cheat.sys", "denuvo-anti-cheat-runtime.dll", "denuvo-anti-cheat-update-service.exe" ],
|
||||
"note": "Documented (DRML). Unmeasured." },
|
||||
{ "family": "Roblox Hyperion", "values": [ "RobloxPlayerBeta.dll" ] }
|
||||
],
|
||||
"heuristic": {
|
||||
"$comment": [
|
||||
@@ -254,7 +369,57 @@
|
||||
],
|
||||
"action": "warn_and_refuse"
|
||||
},
|
||||
"blockedExecutables": [],
|
||||
"blockedStoreIds": []
|
||||
"blockedExecutables": [
|
||||
{ "family": "Valve VAC", "match": "exact", "values": [ "cs2.exe", "csgo.exe", "dota2.exe", "tf_win64.exe", "deadlock.exe", "project8.exe", "left4dead2.exe", "gmod.exe" ],
|
||||
"reason": "A VAC-secured online title. VAC runs inside Steam, so no file of the game's own names it." },
|
||||
{ "family": "Riot Vanguard", "match": "exact", "values": [ "VALORANT-Win64-Shipping.exe", "League of Legends.exe" ],
|
||||
"reason": "Protected by Riot Vanguard, a kernel anti-cheat that loads at boot." },
|
||||
{ "family": "Roblox Hyperion", "match": "exact", "values": [ "RobloxPlayerBeta.exe" ],
|
||||
"reason": "The Roblox player is protected by Hyperion anti-tamper." },
|
||||
{ "family": "Blizzard Warden", "match": "exact", "values": [ "Overwatch.exe", "Diablo IV.exe", "Diablo III64.exe", "Wow.exe", "WowClassic.exe", "SC2_x64.exe", "HeroesOfTheStorm_x64.exe" ],
|
||||
"reason": "An online Blizzard title: its anti-cheat is built into the game and ships no file of its own." },
|
||||
{ "family": "Activision Ricochet", "match": "exact", "values": [ "cod.exe", "ModernWarfare.exe", "BlackOpsColdWar.exe" ],
|
||||
"reason": "Call of Duty, protected by the RICOCHET kernel anti-cheat." },
|
||||
{ "family": "NetEase Anti-Cheat", "match": "exact", "values": [ "Marvel-Win64-Shipping.exe", "NarakaBladepoint.exe" ],
|
||||
"reason": "Protected by NetEase's kernel anti-cheat (NEAC)." },
|
||||
{ "family": "Anti-Cheat Expert", "match": "exact", "values": [ "DeltaForceClient-Win64-Shipping.exe" ],
|
||||
"reason": "Protected by Tencent Anti-Cheat Expert (ACE), a kernel anti-cheat." },
|
||||
{ "family": "mihoyo protect", "match": "exact", "values": [ "GenshinImpact.exe", "YuanShen.exe", "StarRail.exe", "ZenlessZoneZero.exe", "BH3.exe" ],
|
||||
"reason": "A HoYoverse title, protected by its kernel anti-cheat driver." },
|
||||
{ "family": "EA AntiCheat", "match": "exact", "values": [ "bf2042.exe", "bf6.exe", "FC25.exe", "FC26.exe" ],
|
||||
"reason": "Protected by EA AntiCheat (Javelin), a kernel anti-cheat." }
|
||||
],
|
||||
"blockedStoreIds": [
|
||||
{ "store": "steam", "id": "730", "family": "Valve VAC", "reason": "A VAC-secured online title. VAC runs inside Steam, so no file of the game's own names it." },
|
||||
{ "store": "steam", "id": "570", "family": "Valve VAC", "reason": "A VAC-secured online title. VAC runs inside Steam, so no file of the game's own names it." },
|
||||
{ "store": "steam", "id": "440", "family": "Valve VAC", "reason": "A VAC-secured online title. VAC runs inside Steam, so no file of the game's own names it." },
|
||||
{ "store": "steam", "id": "1422450", "family": "Valve VAC", "reason": "A VAC-secured online title. VAC runs inside Steam, so no file of the game's own names it." },
|
||||
{ "store": "steam", "id": "240", "family": "Valve VAC", "reason": "A VAC-secured online title. VAC runs inside Steam, so no file of the game's own names it." },
|
||||
{ "store": "steam", "id": "10", "family": "Valve VAC", "reason": "A VAC-secured online title. VAC runs inside Steam, so no file of the game's own names it." },
|
||||
{ "store": "steam", "id": "80", "family": "Valve VAC", "reason": "A VAC-secured online title. VAC runs inside Steam, so no file of the game's own names it." },
|
||||
{ "store": "steam", "id": "550", "family": "Valve VAC", "reason": "A VAC-secured online title. VAC runs inside Steam, so no file of the game's own names it." },
|
||||
{ "store": "steam", "id": "500", "family": "Valve VAC", "reason": "A VAC-secured online title. VAC runs inside Steam, so no file of the game's own names it." },
|
||||
{ "store": "steam", "id": "4000", "family": "Valve VAC", "reason": "A VAC-secured online title. VAC runs inside Steam, so no file of the game's own names it." },
|
||||
{ "store": "steam", "id": "320", "family": "Valve VAC", "reason": "A VAC-secured online title. VAC runs inside Steam, so no file of the game's own names it." },
|
||||
{ "store": "steam", "id": "300", "family": "Valve VAC", "reason": "A VAC-secured online title. VAC runs inside Steam, so no file of the game's own names it." },
|
||||
{ "store": "steam", "id": "20", "family": "Valve VAC", "reason": "A VAC-secured online title. VAC runs inside Steam, so no file of the game's own names it." },
|
||||
{ "store": "steam", "id": "1938090", "family": "Activision Ricochet", "reason": "Call of Duty, protected by the RICOCHET kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "1962663", "family": "Activision Ricochet", "reason": "Call of Duty, protected by the RICOCHET kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "3595270", "family": "Activision Ricochet", "reason": "Call of Duty, protected by the RICOCHET kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "4384550", "family": "Activision Ricochet", "reason": "Call of Duty, protected by the RICOCHET kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "2519060", "family": "Activision Ricochet", "reason": "Call of Duty, protected by the RICOCHET kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "2357570", "family": "Blizzard Warden", "reason": "An online Blizzard title: its anti-cheat is built into the game and ships no file of its own." },
|
||||
{ "store": "steam", "id": "2344520", "family": "Blizzard Warden", "reason": "An online Blizzard title: its anti-cheat is built into the game and ships no file of its own." },
|
||||
{ "store": "steam", "id": "2767030", "family": "NetEase Anti-Cheat", "reason": "Protected by NetEase's kernel anti-cheat (NEAC)." },
|
||||
{ "store": "steam", "id": "1203220", "family": "NetEase Anti-Cheat", "reason": "Protected by NetEase's kernel anti-cheat (NEAC)." },
|
||||
{ "store": "steam", "id": "2943650", "family": "NetEase Anti-Cheat", "reason": "Protected by NetEase's kernel anti-cheat (NEAC)." },
|
||||
{ "store": "steam", "id": "2139460", "family": "NetEase Anti-Cheat", "reason": "Protected by NetEase's kernel anti-cheat (NEAC)." },
|
||||
{ "store": "steam", "id": "2507950", "family": "Anti-Cheat Expert", "reason": "Protected by Tencent Anti-Cheat Expert (ACE), a kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "2073620", "family": "Anti-Cheat Expert", "reason": "Protected by Tencent Anti-Cheat Expert (ACE), a kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "1517290", "family": "EA AntiCheat", "reason": "Protected by EA AntiCheat (Javelin), a kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "2807960", "family": "EA AntiCheat", "reason": "Protected by EA AntiCheat (Javelin), a kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "2669320", "family": "EA AntiCheat", "reason": "Protected by EA AntiCheat (Javelin), a kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "3405690", "family": "EA AntiCheat", "reason": "Protected by EA AntiCheat (Javelin), a kernel anti-cheat." }
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -404,7 +404,7 @@
|
||||
"$comment": "maxItems is fl::guard::kMaxFamilies, and it bounds the SUM of all five groups, not this one array - the parser fills a single families[kMaxFamilies] from all of them. A schema cannot express a cross-array total, so the per-array cap is set to the total (no single array can breach it alone) and tools/rules-validate.ps1 checks the sum imperatively. Exceeding it is ParseResult::kTooLarge for the whole file, i.e. the guard refuses every title.",
|
||||
"type": "array",
|
||||
"minItems": 1,
|
||||
"maxItems": 64,
|
||||
"maxItems": 256,
|
||||
"items": { "$ref": "#/$defs/acMatchGroup" },
|
||||
"allOf": [
|
||||
{
|
||||
@@ -420,7 +420,7 @@
|
||||
"drivers": {
|
||||
"type": "array",
|
||||
"minItems": 1,
|
||||
"maxItems": 64,
|
||||
"maxItems": 256,
|
||||
"items": { "$ref": "#/$defs/acDriverGroup" },
|
||||
"allOf": [
|
||||
{
|
||||
@@ -429,29 +429,29 @@
|
||||
]
|
||||
},
|
||||
|
||||
"directories": { "type": "array", "minItems": 1, "maxItems": 64, "items": { "$ref": "#/$defs/acNameGroup" } },
|
||||
"services": { "type": "array", "minItems": 1, "maxItems": 64, "items": { "$ref": "#/$defs/acNameGroup" } },
|
||||
"directories": { "type": "array", "minItems": 1, "maxItems": 256, "items": { "$ref": "#/$defs/acNameGroup" } },
|
||||
"services": { "type": "array", "minItems": 1, "maxItems": 256, "items": { "$ref": "#/$defs/acNameGroup" } },
|
||||
|
||||
"files": {
|
||||
"$comment": "NEW in this schema. 19_SAFETY lists Xigncode3's `x3.xem`, which is a data file shipped beside the game rather than a loadable module - the previous seed had nowhere to put it. Also the home for the anti-cheat SDK payloads that 19_SAFETY check 4 (multiplayer heuristic) looks for during the static pre-scan.",
|
||||
"$comment": "NEW in this schema. 19_SAFETY lists Xigncode3's `x3.xem`, which is a data file shipped beside the game rather than a loadable module - the previous seed had nowhere to put it (2026-09-25: XIGNCODE3 also LoadLibrary's it as its loader, so modules names it too). Also the home for the anti-cheat SDK payloads that 19_SAFETY check 4 (multiplayer heuristic) looks for during the static pre-scan.",
|
||||
"type": "array",
|
||||
"minItems": 1,
|
||||
"maxItems": 64,
|
||||
"maxItems": 256,
|
||||
"items": { "$ref": "#/$defs/acNameGroup" }
|
||||
},
|
||||
|
||||
"heuristic": { "$ref": "#/$defs/heuristic" },
|
||||
|
||||
"blockedExecutables": {
|
||||
"$comment": "May legitimately be empty - a per-title list, not the family blocklist. minItems is deliberately absent here and deliberately present on modules/drivers. maxItems is fl::guard::kMaxTitleRules; at kMaxValuesPerTitleRule values each that is 512 blockable names, more than the 4096 this used to claim could ever have survived the parser.",
|
||||
"$comment": "May legitimately be empty - a per-title list, not the family blocklist. minItems is deliberately absent here and deliberately present on modules/drivers. maxItems is fl::guard::kMaxTitleRules (128 since 2026-09-25); at kMaxValuesPerTitleRule values each that is 1024 blockable names, more than the 4096 this used to claim could ever have survived the parser.",
|
||||
"type": "array",
|
||||
"maxItems": 64,
|
||||
"maxItems": 128,
|
||||
"items": { "$ref": "#/$defs/acBlockedExecutable" }
|
||||
},
|
||||
|
||||
"blockedStoreIds": {
|
||||
"type": "array",
|
||||
"maxItems": 64,
|
||||
"maxItems": 128,
|
||||
"items": { "$ref": "#/$defs/acBlockedStoreId" }
|
||||
}
|
||||
}
|
||||
|
||||
@@ -121,12 +121,18 @@ internal static class AgentServices
|
||||
services.AddSingleton<IDetectionRulesSource>(static _ => new DetectionRulesFile());
|
||||
services.AddSingleton<IGameFileProbe, GameFileProbe>();
|
||||
// A drive that changed its letter (2026-09-22): one relocator, asked by the sweep, the watcher and the enable-hooking
|
||||
// command, over the BCL's drive list.
|
||||
// command, over the BCL's drive list. Since 2026-09-23 it also merges two entries for one executable (D26), and waits
|
||||
// while a session of either runs — the orchestrator's table, read when asked (it holds the relocator itself) — or
|
||||
// waits in a .partial to be recovered.
|
||||
services.AddSingleton<IGameMerge>(static sp => new SqliteGameMerge(sp.GetRequiredService<LedgerDatabase>()));
|
||||
services.AddSingleton(static sp => new ExecutableRelocator(
|
||||
sp.GetRequiredService<IGameRepository>(),
|
||||
sp.GetRequiredService<IExecutableIdentitySource>(),
|
||||
VolumeRoots.Ready,
|
||||
static line => Serilog.Log.Information("{Line}", line)));
|
||||
static line => Serilog.Log.Information("{Line}", line),
|
||||
merge: sp.GetRequiredService<IGameMerge>(),
|
||||
busy: id => sp.GetRequiredService<CaptureOrchestrator>().IsRecording(id)
|
||||
|| sp.GetRequiredService<IPartialSessionStore>().PendingGameIds().Contains(id)));
|
||||
services.AddSingleton(static sp => new DetectionSweep(
|
||||
sp.GetRequiredService<IGameRepository>(),
|
||||
sp.GetRequiredService<IDetectionRulesSource>(),
|
||||
@@ -135,6 +141,20 @@ internal static class AgentServices
|
||||
static line => Serilog.Log.Information("{Line}", line),
|
||||
sp.GetRequiredService<ExecutableRelocator>()));
|
||||
|
||||
// The anti-cheat pre-scan of the library (beta.8, 19_SAFETY §What a finding does to the game): every entry through
|
||||
// the guard's advisory checks 3 and 4, again whenever the rules or the executable change. It waits while a session
|
||||
// of the entry runs (the session's own checks are running then), and tells the App only when it turned hooking off
|
||||
// for an entry the user had turned on. Hosted under --serve only, beside the detection sweep.
|
||||
services.AddSingleton(static sp => new AntiCheatPreScanSweep(
|
||||
sp.GetRequiredService<IGameRepository>(),
|
||||
sp.GetRequiredService<IGameConsentStore>(),
|
||||
sp.GetRequiredService<IAntiCheatGuard>(),
|
||||
sp.GetRequiredService<IDetectionRulesSource>(),
|
||||
sp.GetRequiredService<IExecutableIdentitySource>(),
|
||||
static line => Serilog.Log.Information("{Line}", line),
|
||||
sp.GetRequiredService<IIpcEventPublisher>(),
|
||||
id => sp.GetRequiredService<CaptureOrchestrator>().IsRecording(id)));
|
||||
|
||||
// The layer's registration follows the ledger (P4 PR-2, 12_BUILD §The Vulkan layer is not registered at
|
||||
// install time): the same manifest and key --register-vklayer writes, reconciled after every consent change
|
||||
// the handler makes and after every sweep.
|
||||
@@ -179,6 +199,8 @@ internal static class AgentServices
|
||||
{
|
||||
RulesSeedOutcome outcome = await new RulesSeeder(new FileSystemRulesStore()).EnsureSeededAsync(ct).ConfigureAwait(false);
|
||||
sp.GetRequiredService<DetectionSweep>().RequestNow();
|
||||
// And the anti-cheat pre-scan: new rules may name a game the library already holds (2026-09-25).
|
||||
sp.GetRequiredService<AntiCheatPreScanSweep>().RequestNow();
|
||||
return outcome.ToString();
|
||||
},
|
||||
// P3 PR-4 (D14): the reviewed disclosure this Agent stamps against, and its own clock for the stamp.
|
||||
@@ -187,7 +209,9 @@ internal static class AgentServices
|
||||
sp.GetRequiredService<VkLayerReconciler>(),
|
||||
// P4 PR-7: the on-demand retention sweep, over the Agent's own settings read and its own blob tables.
|
||||
ct => new RetentionSweep(sp.GetRequiredService<ISessionRepository>(), sp.GetRequiredService<RegisteredSettings>()).RunAsync(ct),
|
||||
sp.GetRequiredService<ExecutableRelocator>()));
|
||||
sp.GetRequiredService<ExecutableRelocator>(),
|
||||
// beta.8: an executable that cannot run as x64 is refused before anything is scanned or stamped.
|
||||
new PeArchitectureSource()));
|
||||
services.AddSingleton<IIpcRequestHandler>(static sp => new AgentRequestHandler(
|
||||
AgentIdentityFactory.OfThisProcess(sp.GetRequiredService<AgentPaths>().VkLayerDirectory),
|
||||
TelemetryDescriptor(),
|
||||
|
||||
@@ -0,0 +1,61 @@
|
||||
using System.Data.Common;
|
||||
using FrameLedger.Application.AntiCheat;
|
||||
using Microsoft.Extensions.Hosting;
|
||||
using Serilog;
|
||||
|
||||
namespace FrameLedger.Agent.Hosting;
|
||||
|
||||
/// <summary>
|
||||
/// <c>--serve</c> (beta.8, 2026-09-25): the anti-cheat pre-scan of the library on its own background task. One pass at
|
||||
/// start, then one every <see cref="Interval"/>, and one as soon as <c>UpdateRules</c> re-seeds the rules file
|
||||
/// (<see cref="AntiCheatPreScanSweep.RequestNow"/>). It reads executables' paths, install folders and the stores' own
|
||||
/// files, and writes the pre-scan's hook-state columns of <c>games</c>; it never opens a game's process
|
||||
/// (<c>19_SAFETY</c> §What a finding does to the game, CLAUDE.md rule 4).
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// Its own task, like <see cref="DetectionHostedService"/>'s, because the guard's directory walk blocks on file I/O.
|
||||
/// A pass that throws is logged and retried on the next tick rather than ending the service: a game's folder going away
|
||||
/// mid-walk is ordinary, a busy ledger is a retry, and a service that throws stops the Agent's host.
|
||||
/// </remarks>
|
||||
internal sealed class AntiCheatPreScanHostedService(AntiCheatPreScanSweep sweep) : BackgroundService
|
||||
{
|
||||
/// <summary>The idle cadence, the detection sweep's: a game the App just added is scanned within it.</summary>
|
||||
public static readonly TimeSpan Interval = TimeSpan.FromSeconds(15);
|
||||
|
||||
protected override async Task ExecuteAsync(CancellationToken stoppingToken)
|
||||
{
|
||||
Log.Information("prescan: scanning the library for anti-cheat every {Seconds} s, and on every rules update", Interval.TotalSeconds);
|
||||
while (!stoppingToken.IsCancellationRequested)
|
||||
{
|
||||
try
|
||||
{
|
||||
AntiCheatPreScanReport r = await sweep.SweepOnceAsync(stoppingToken).ConfigureAwait(false);
|
||||
// Said when something happened: a pass over an unchanged library scans nothing and says nothing.
|
||||
if (r.Scanned > 0 || r.RulesUnusable)
|
||||
{
|
||||
Log.Information("prescan: scanned {Scanned} — anti-cheat {Found}, clean {Clean}, could not verify {Unverified}; blocked {Blocked}, current {Current}{Rules}",
|
||||
r.Scanned, r.Found, r.Clean, r.Unverified, r.Blocked, r.Current, r.RulesUnusable ? ", rules unusable" : string.Empty);
|
||||
}
|
||||
}
|
||||
catch (OperationCanceledException) when (stoppingToken.IsCancellationRequested)
|
||||
{
|
||||
break;
|
||||
}
|
||||
catch (Exception ex) when (ex is IOException or UnauthorizedAccessException or InvalidOperationException or DbException)
|
||||
{
|
||||
Log.Warning(ex, "prescan: pass did not complete; retrying on the next tick");
|
||||
}
|
||||
|
||||
try
|
||||
{
|
||||
await sweep.WaitAsync(Interval, stoppingToken).ConfigureAwait(false);
|
||||
}
|
||||
catch (OperationCanceledException) when (stoppingToken.IsCancellationRequested)
|
||||
{
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
Log.Information("prescan: stopped");
|
||||
}
|
||||
}
|
||||
@@ -1,3 +1,4 @@
|
||||
using System.Data.Common;
|
||||
using FrameLedger.Application.Detection;
|
||||
using FrameLedger.Application.Vulkan;
|
||||
using Microsoft.Extensions.Hosting;
|
||||
@@ -15,7 +16,9 @@ namespace FrameLedger.Agent.Hosting;
|
||||
/// Its own task because <c>GameFileProbe</c> blocks on file I/O (a bounded directory walk, an 8 MB strings pass):
|
||||
/// the orchestrator's 1 Hz poll must not wait on it, and a session's drain must never share a thread with it.
|
||||
/// A sweep that throws is logged and retried on the next tick rather than ending the service — a game's
|
||||
/// directory going away mid-walk is ordinary, and one bad game must not stop the scan of the rest.
|
||||
/// directory going away mid-walk is ordinary, and one bad game must not stop the scan of the rest. A database error
|
||||
/// is one of those since 2026-09-23: the sweep writes rows (a relocation, a merge), a service that throws stops the
|
||||
/// Agent's host (the Generic Host's default), and a busy or locked ledger is a retry, not a reason to stop capturing.
|
||||
/// </remarks>
|
||||
internal sealed class DetectionHostedService(DetectionSweep sweep, VkLayerReconciler layer) : BackgroundService
|
||||
{
|
||||
@@ -49,7 +52,7 @@ internal sealed class DetectionHostedService(DetectionSweep sweep, VkLayerReconc
|
||||
{
|
||||
break;
|
||||
}
|
||||
catch (Exception ex) when (ex is IOException or UnauthorizedAccessException or InvalidOperationException)
|
||||
catch (Exception ex) when (ex is IOException or UnauthorizedAccessException or InvalidOperationException or DbException)
|
||||
{
|
||||
Log.Warning(ex, "detect: sweep did not complete; retrying on the next tick");
|
||||
}
|
||||
|
||||
@@ -248,6 +248,7 @@ internal static class Program
|
||||
builder.Services.AddHostedService<WatcherHostedService>();
|
||||
// The static detection sweep (P4 PR-1, 05_DETECTION §Caching): its own task, because the probe blocks on file I/O.
|
||||
builder.Services.AddHostedService<DetectionHostedService>();
|
||||
builder.Services.AddHostedService<AntiCheatPreScanHostedService>();
|
||||
// The pipe (07_IPC §C), the product's UI channel: --serve only, never under --console (P3 PR-1).
|
||||
builder.Services.AddHostedService<PipeServerHostedService>();
|
||||
// Finalize's grace on shutdown (04_CAPTURE §Threading model): a session that does not make it leaves
|
||||
|
||||
@@ -268,16 +268,7 @@ public partial class App : System.Windows.Application
|
||||
builder.Services.AddSingleton(closePolicy);
|
||||
builder.Services.AddSingleton<IThemeApplier, WpfThemeApplier>();
|
||||
|
||||
// The Agent over the pipe (07_IPC §Client behavior): connect, start it when it is not there, tell the shell.
|
||||
builder.Services.AddSingleton<IAgentLauncher, AgentLauncher>();
|
||||
builder.Services.AddSingleton(static sp => new AgentConnection(
|
||||
sp.GetRequiredService<IAgentLauncher>(),
|
||||
static () => new PipeClient(),
|
||||
new AgentConnectionOptions(),
|
||||
UiIdentity.Version));
|
||||
builder.Services.AddHostedService<AgentConnectionHostedService>();
|
||||
builder.Services.AddSingleton<IAgentRequests>(static sp => sp.GetRequiredService<AgentConnection>());
|
||||
builder.Services.AddSingleton<IAgentLink>(static sp => sp.GetRequiredService<AgentConnection>());
|
||||
AddAgentLink(builder.Services);
|
||||
|
||||
// FR-2.1 (P3 PR-4): the consent dialog and the request it ends in; the toggle that opens it is the game page's (PR-5).
|
||||
builder.Services.AddSingleton<IConsentPrompt, ConsentPrompt>();
|
||||
@@ -309,6 +300,23 @@ public partial class App : System.Windows.Application
|
||||
return builder.Build();
|
||||
}
|
||||
|
||||
/// <summary>The Agent over the pipe (07_IPC §Client behavior): connect, start it when it is not there, tell the shell.</summary>
|
||||
private static void AddAgentLink(IServiceCollection services)
|
||||
{
|
||||
services.AddSingleton<IAgentLauncher, AgentLauncher>();
|
||||
services.AddSingleton(static sp => new AgentConnection(
|
||||
sp.GetRequiredService<IAgentLauncher>(),
|
||||
static () => new PipeClient(),
|
||||
new AgentConnectionOptions(),
|
||||
UiIdentity.Version));
|
||||
services.AddHostedService<AgentConnectionHostedService>();
|
||||
services.AddSingleton<IAgentRequests>(static sp => sp.GetRequiredService<AgentConnection>());
|
||||
services.AddSingleton<IAgentLink>(static sp => sp.GetRequiredService<AgentConnection>());
|
||||
// What the Agent runs right now (2026-09-23), for the pages rebuilt on every visit; built before the connection's
|
||||
// first round by AgentConnectionHostedService, so it never misses a session.
|
||||
services.AddSingleton(static sp => new LiveSessions(sp.GetRequiredService<IAgentLink>()));
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// The library (P3 PR-5): the ports the pages read and write, the selection that travels between pages, and the
|
||||
/// pickers, prompts and confirmations behind interfaces so the view models are testable without a window.
|
||||
|
||||
@@ -10,7 +10,8 @@
|
||||
<StackPanel Style="{StaticResource PageRoot}">
|
||||
<ui:TextBlock FontTypography="Title" Text="{x:Static vm:DashboardViewModel.Header}" />
|
||||
|
||||
<!-- 08_UI §Dashboard: the live capture card, fed by SessionStarted / SessionProgress / SessionCompleted. -->
|
||||
<!-- 08_UI §Dashboard: the live capture card, fed by SessionStarted / SessionProgress / SessionHeld / SessionCompleted.
|
||||
A session recorded without measuring (Tier 2) shows why, and no readout (2026-09-23). -->
|
||||
<ui:Card Margin="0,16,0,0" HorizontalAlignment="Stretch">
|
||||
<StackPanel>
|
||||
<StackPanel Orientation="Horizontal">
|
||||
@@ -26,7 +27,12 @@
|
||||
<ui:TextBlock Appearance="Secondary" Text="{Binding ViewModel.Live.ElapsedText}" />
|
||||
<ui:TextBlock Appearance="Secondary" Text="{x:Static vm:LiveCaptureViewModel.WaitingText}"
|
||||
Visibility="{Binding ViewModel.Live.WaitingForFrames, Converter={StaticResource BoolToVis}}" />
|
||||
<controls:FpsReadout Margin="0,8,0,0" Model="{Binding ViewModel.Live.Readout}" />
|
||||
<StackPanel Margin="0,8,0,0" Visibility="{Binding ViewModel.Live.IsHeld, Converter={StaticResource BoolToVis}}">
|
||||
<ui:TextBlock Text="{x:Static vm:LiveCaptureViewModel.HeldText}" TextWrapping="Wrap" />
|
||||
<ui:TextBlock Appearance="Secondary" Text="{Binding ViewModel.Live.HeldReason}" TextWrapping="Wrap" />
|
||||
</StackPanel>
|
||||
<controls:FpsReadout Margin="0,8,0,0" Model="{Binding ViewModel.Live.Readout}"
|
||||
Visibility="{Binding ViewModel.Live.IsHeld, Converter={StaticResource InverseBoolToVis}}" />
|
||||
<WrapPanel Margin="0,8,0,0">
|
||||
<ui:TextBlock Margin="0,0,16,0" Text="{Binding ViewModel.Live.ResolutionText}" />
|
||||
<ui:TextBlock Margin="0,0,16,0" Text="{Binding ViewModel.Live.UpscalerText}" />
|
||||
|
||||
@@ -109,23 +109,68 @@
|
||||
</ui:Card>
|
||||
</Grid>
|
||||
|
||||
<!-- hooking control (FR-2.1 / FR-2.2 / FR-2.5) -->
|
||||
<ui:CardControl Margin="0,12,0,0" Header="{x:Static vm:GameDetailViewModel.HookingHeader}" Icon="{ui:SymbolIcon ShieldTask24}">
|
||||
<!-- details (beta.8, schema 0011): what the game's files and its store say — what it runs as, its versions, what it ships -->
|
||||
<ui:CardExpander Margin="0,12,0,0" IsExpanded="True" Icon="{ui:SymbolIcon Info24}"
|
||||
Header="{x:Static vm:GameDetailViewModel.DetailsHeader}">
|
||||
<ItemsControl ItemsSource="{Binding ViewModel.Details}">
|
||||
<ItemsControl.ItemTemplate>
|
||||
<DataTemplate DataType="{x:Type vm:GameDetailRow}">
|
||||
<Grid Margin="0,0,0,6">
|
||||
<Grid.ColumnDefinitions>
|
||||
<ColumnDefinition Width="180" />
|
||||
<ColumnDefinition Width="*" />
|
||||
</Grid.ColumnDefinitions>
|
||||
<ui:TextBlock Grid.Column="0" Appearance="Secondary" TextWrapping="Wrap" Text="{Binding Label}" />
|
||||
<ui:TextBlock Grid.Column="1" TextWrapping="Wrap" Text="{Binding Value}" />
|
||||
</Grid>
|
||||
</DataTemplate>
|
||||
</ItemsControl.ItemTemplate>
|
||||
</ItemsControl>
|
||||
</ui:CardExpander>
|
||||
|
||||
<!-- recording switch (schema 0009, 2026-09-23): off, FrameLedger does not watch for this program at all -->
|
||||
<ui:CardControl Margin="0,12,0,0" Header="{x:Static vm:GameDetailViewModel.RecordingHeader}" Icon="{ui:SymbolIcon Record24}">
|
||||
<StackPanel Orientation="Horizontal">
|
||||
<ui:TextBlock Appearance="Secondary" VerticalAlignment="Center" Margin="0,0,12,0" Text="{Binding ViewModel.HookStatusText}" />
|
||||
<ui:ToggleSwitch AutomationProperties.Name="{x:Static vm:GameDetailViewModel.HookingHeader}"
|
||||
IsChecked="{Binding ViewModel.HookEnabled, Mode=OneWay}"
|
||||
IsEnabled="{Binding ViewModel.HookToggleEnabled}"
|
||||
Command="{Binding ViewModel.ToggleHookingCommand}" />
|
||||
<ui:TextBlock Appearance="Secondary" VerticalAlignment="Center" Margin="0,0,12,0" Text="{Binding ViewModel.RecordingStatusText}" />
|
||||
<ui:ToggleSwitch AutomationProperties.Name="{x:Static vm:GameDetailViewModel.RecordingHeader}"
|
||||
IsChecked="{Binding ViewModel.RecordSessions, Mode=OneWay}"
|
||||
Command="{Binding ViewModel.ToggleRecordingCommand}" />
|
||||
</StackPanel>
|
||||
</ui:CardControl>
|
||||
<ui:TextBlock Margin="0,6,0,0" Appearance="Secondary" TextWrapping="Wrap" Text="{x:Static vm:GameDetailViewModel.HookingBody}" />
|
||||
<ui:TextBlock Margin="0,6,0,0" Appearance="Secondary" TextWrapping="Wrap" Text="{Binding ViewModel.BlockedText}"
|
||||
Visibility="{Binding ViewModel.BlockedText, Converter={StaticResource NullToCollapsed}}" />
|
||||
<ui:TextBlock Margin="0,6,0,0" Appearance="Secondary" TextWrapping="Wrap" Text="{Binding ViewModel.UnverifiedText}"
|
||||
Visibility="{Binding ViewModel.UnverifiedText, Converter={StaticResource NullToCollapsed}}" />
|
||||
<ui:TextBlock Margin="0,6,0,0" Appearance="Secondary" Text="{x:Static vm:GameDetailViewModel.BusyText}"
|
||||
Visibility="{Binding ViewModel.Busy, Converter={StaticResource BoolToVis}}" />
|
||||
<ui:TextBlock Margin="0,6,0,0" Appearance="Secondary" TextWrapping="Wrap" Text="{x:Static vm:GameDetailViewModel.RecordingBody}" />
|
||||
|
||||
<!-- anti-cheat found, shown IN PLACE of the hooking card while such cards are hidden (beta.8, ui.hide_anticheat_hooking) -->
|
||||
<ui:CardControl Margin="0,12,0,0" Icon="{ui:SymbolIcon ShieldError24}"
|
||||
Visibility="{Binding ViewModel.AntiCheatText, Converter={StaticResource NullToCollapsed}}">
|
||||
<ui:CardControl.Header>
|
||||
<StackPanel>
|
||||
<ui:TextBlock FontTypography="BodyStrong" Text="{x:Static vm:GameDetailViewModel.AntiCheatHeader}" />
|
||||
<ui:TextBlock Appearance="Secondary" TextWrapping="Wrap" Text="{Binding ViewModel.AntiCheatText}" />
|
||||
</StackPanel>
|
||||
</ui:CardControl.Header>
|
||||
</ui:CardControl>
|
||||
|
||||
<!-- hooking control (FR-2.1 / FR-2.2 / FR-2.5) -->
|
||||
<StackPanel Visibility="{Binding ViewModel.HookingSectionVisible, Converter={StaticResource BoolToVis}}">
|
||||
<ui:CardControl Margin="0,12,0,0" Header="{x:Static vm:GameDetailViewModel.HookingHeader}" Icon="{ui:SymbolIcon ShieldTask24}">
|
||||
<StackPanel Orientation="Horizontal">
|
||||
<ui:TextBlock Appearance="Secondary" VerticalAlignment="Center" Margin="0,0,12,0" Text="{Binding ViewModel.HookStatusText}" />
|
||||
<ui:ToggleSwitch AutomationProperties.Name="{x:Static vm:GameDetailViewModel.HookingHeader}"
|
||||
IsChecked="{Binding ViewModel.HookEnabled, Mode=OneWay}"
|
||||
IsEnabled="{Binding ViewModel.HookToggleEnabled}"
|
||||
Command="{Binding ViewModel.ToggleHookingCommand}" />
|
||||
</StackPanel>
|
||||
</ui:CardControl>
|
||||
<ui:TextBlock Margin="0,6,0,0" Appearance="Secondary" TextWrapping="Wrap" Text="{x:Static vm:GameDetailViewModel.HookingBody}" />
|
||||
<ui:TextBlock Margin="0,6,0,0" Appearance="Secondary" TextWrapping="Wrap" Text="{Binding ViewModel.BlockedText}"
|
||||
Visibility="{Binding ViewModel.BlockedText, Converter={StaticResource NullToCollapsed}}" />
|
||||
<ui:TextBlock Margin="0,6,0,0" Appearance="Secondary" TextWrapping="Wrap" Text="{Binding ViewModel.NotX64Text}"
|
||||
Visibility="{Binding ViewModel.NotX64Text, Converter={StaticResource NullToCollapsed}}" />
|
||||
<ui:TextBlock Margin="0,6,0,0" Appearance="Secondary" TextWrapping="Wrap" Text="{Binding ViewModel.UnverifiedText}"
|
||||
Visibility="{Binding ViewModel.UnverifiedText, Converter={StaticResource NullToCollapsed}}" />
|
||||
<ui:TextBlock Margin="0,6,0,0" Appearance="Secondary" Text="{x:Static vm:GameDetailViewModel.BusyText}"
|
||||
Visibility="{Binding ViewModel.Busy, Converter={StaticResource BoolToVis}}" />
|
||||
</StackPanel>
|
||||
<ui:InfoBar Margin="0,8,0,0" IsClosable="False" Severity="Warning"
|
||||
IsOpen="{Binding ViewModel.AutoDisabledText, Converter={StaticResource NotNull}}"
|
||||
Message="{Binding ViewModel.AutoDisabledText}">
|
||||
|
||||
@@ -53,6 +53,19 @@
|
||||
</StackPanel>
|
||||
</ui:CardExpander>
|
||||
|
||||
<!-- beta.8 (owner request 2026-09-25): an anti-cheat game's page shows the finding instead of its Hooking card. -->
|
||||
<ui:CardControl Margin="0,8,0,0" Icon="{ui:SymbolIcon ShieldError24}">
|
||||
<ui:CardControl.Header>
|
||||
<StackPanel>
|
||||
<ui:TextBlock FontTypography="BodyStrong" Text="{x:Static res:Strings.Settings_HideAntiCheatHooking_Label}" />
|
||||
<ui:TextBlock MaxWidth="520" HorizontalAlignment="Left" Appearance="Secondary" TextWrapping="Wrap"
|
||||
Text="{x:Static res:Strings.Settings_HideAntiCheatHooking_Body}" />
|
||||
</StackPanel>
|
||||
</ui:CardControl.Header>
|
||||
<ui:ToggleSwitch AutomationProperties.Name="{x:Static res:Strings.Settings_HideAntiCheatHooking_Label}"
|
||||
IsChecked="{Binding ViewModel.HideAntiCheatHooking, Mode=TwoWay}" />
|
||||
</ui:CardControl>
|
||||
|
||||
<ui:CardExpander Margin="0,8,0,0" Icon="{ui:SymbolIcon Layer24}">
|
||||
<ui:CardExpander.Header>
|
||||
<Grid>
|
||||
|
||||
@@ -3,9 +3,15 @@ using Microsoft.Extensions.Hosting;
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>Runs <see cref="AgentConnection"/> for the life of the host.</summary>
|
||||
internal sealed class AgentConnectionHostedService(AgentConnection connection) : BackgroundService
|
||||
internal sealed class AgentConnectionHostedService(AgentConnection connection, LiveSessions sessions) : BackgroundService
|
||||
{
|
||||
protected override Task ExecuteAsync(CancellationToken stoppingToken) => connection.RunAsync(stoppingToken);
|
||||
// The running-session view is built with this service, before the first round, so the first connect's status seeds
|
||||
// it and no event after it is missed (2026-09-23).
|
||||
protected override Task ExecuteAsync(CancellationToken stoppingToken)
|
||||
{
|
||||
GC.KeepAlive(sessions);
|
||||
return connection.RunAsync(stoppingToken);
|
||||
}
|
||||
|
||||
public override async Task StopAsync(CancellationToken cancellationToken)
|
||||
{
|
||||
|
||||
@@ -0,0 +1,40 @@
|
||||
using System.Diagnostics.CodeAnalysis;
|
||||
using System.Globalization;
|
||||
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>
|
||||
/// <c>games.hook_blocked_reason</c> in the user's language (beta.8, 2026-09-25): which anti-cheat, and what of it the
|
||||
/// guard found — a module in the game, a folder or file shipped with it, the title or its store id on the lists.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// The Agent stores a block as <c>Reason|Family|Signal</c> since 2026-09-25 (<c>SqliteGameConsentStore.BlockText</c>).
|
||||
/// Rows written before then say <c>"Reason: Family Signal"</c>, which cannot be split back apart — family names and file
|
||||
/// names both carry spaces — so those are shown as they were stored, which is what the page always showed.
|
||||
/// </remarks>
|
||||
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
|
||||
public static class BlockedReasonText
|
||||
{
|
||||
public static string Describe(string stored)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(stored);
|
||||
string[] parts = stored.Split('|');
|
||||
if (parts.Length != 3)
|
||||
{
|
||||
return stored;
|
||||
}
|
||||
|
||||
string format = parts[0] switch
|
||||
{
|
||||
"BlockedModule" => Strings.Blocked_Module_Format,
|
||||
"AntiCheatDirectory" => Strings.Blocked_Directory_Format,
|
||||
"AntiCheatFile" => Strings.Blocked_File_Format,
|
||||
"BlockedExecutable" => Strings.Blocked_Executable_Format,
|
||||
"BlockedStoreId" => Strings.Blocked_StoreId_Format,
|
||||
_ => Strings.Blocked_Other_Format,
|
||||
};
|
||||
string family = parts[1].Length > 0 ? parts[1] : Strings.Common_NotAvailable;
|
||||
string signal = parts[2].Length > 0 ? parts[2] : Strings.Common_NotAvailable;
|
||||
return string.Format(CultureInfo.CurrentCulture, format, family, signal);
|
||||
}
|
||||
}
|
||||
@@ -1,5 +1,6 @@
|
||||
using System.Diagnostics.CodeAnalysis;
|
||||
using System.Globalization;
|
||||
using FrameLedger.Domain.Detection;
|
||||
using FrameLedger.Domain.Metrics;
|
||||
using FrameLedger.Domain.Sessions;
|
||||
|
||||
@@ -129,6 +130,115 @@ public static class Formats
|
||||
_ => Strings.Exit_Normal,
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// The engine id as the engine's name (2026-09-23): a proper noun, the same in every language (the glossary rule
|
||||
/// above). The ids are the rules file's; one this table does not know — a newer rule, or an engine the user typed —
|
||||
/// passes through as it is, never blank.
|
||||
/// </summary>
|
||||
public static string Engine(string? id) => id switch
|
||||
{
|
||||
null => string.Empty,
|
||||
"unity" => "Unity",
|
||||
"unreal" => "Unreal Engine",
|
||||
"rpgmaker_mv" => "RPG Maker MV/MZ",
|
||||
"rpgmaker_rgss" => "RPG Maker XP/VX/VX Ace",
|
||||
"re_engine" => "RE Engine",
|
||||
"fromsoftware" => "FromSoftware",
|
||||
"godot" => "Godot",
|
||||
"gamemaker" => "GameMaker",
|
||||
"renpy" => "Ren'Py",
|
||||
"cryengine" => "CryEngine",
|
||||
"source" => "Source",
|
||||
_ => id,
|
||||
};
|
||||
|
||||
/// <summary>What an executable runs as (<c>games.exe_machine</c>, beta.8), in the user's language.</summary>
|
||||
public static string Architecture(string? id) => id switch
|
||||
{
|
||||
ExecutableArchitecture.X64 => Strings.Arch_X64,
|
||||
ExecutableArchitecture.X86 => Strings.Arch_X86,
|
||||
ExecutableArchitecture.Arm64 => Strings.Arch_Arm64,
|
||||
ExecutableArchitecture.Arm => Strings.Arch_Arm,
|
||||
ExecutableArchitecture.AnyCpu => Strings.Arch_AnyCpu,
|
||||
ExecutableArchitecture.AnyCpu32 => Strings.Arch_AnyCpu32,
|
||||
ExecutableArchitecture.Other => Strings.Arch_Other,
|
||||
_ => Strings.Arch_Unknown,
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// <c>games.game_version</c> said as what it is (beta.8): a store import writes a Steam build id or a GOG / Epic
|
||||
/// version string, and a bare "20374416" in the subtitle said nothing. Labelled with the store when a store wrote it
|
||||
/// (<paramref name="detected"/>); a version the user typed is shown as typed. Null when there is none.
|
||||
/// </summary>
|
||||
public static string? StoreVersion(string? platform, string? version, bool detected)
|
||||
{
|
||||
if (string.IsNullOrWhiteSpace(version))
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
string? format = !detected ? null : platform switch
|
||||
{
|
||||
"steam" => Strings.Store_Steam_Format,
|
||||
"gog" => Strings.Store_Gog_Format,
|
||||
"epic" => Strings.Store_Epic_Format,
|
||||
_ => null,
|
||||
};
|
||||
return format is null ? version : string.Format(CultureInfo.CurrentCulture, format, version);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Whether two file versions are the same four numbers — Streamline stamps its version STRING as <c>2,8,0,0</c> and
|
||||
/// the fixed part reads <c>2.8.0.0</c>, which agree; a string with text after the numbers is read up to it. Null
|
||||
/// when either has no number to compare (beta.8: the session summary's "another copy was loaded").
|
||||
/// </summary>
|
||||
public static bool? SameVersion(string? a, string? b)
|
||||
{
|
||||
int[]? x = VersionNumbers(a);
|
||||
int[]? y = VersionNumbers(b);
|
||||
if (x is null || y is null)
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
for (int i = 0; i < 4; i++)
|
||||
{
|
||||
if ((i < x.Length ? x[i] : 0) != (i < y.Length ? y[i] : 0))
|
||||
{
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
private static int[]? VersionNumbers(string? text)
|
||||
{
|
||||
if (string.IsNullOrWhiteSpace(text))
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
List<int> parts = new(4);
|
||||
foreach (string token in text.Split(['.', ','], StringSplitOptions.TrimEntries))
|
||||
{
|
||||
// "3.7.10.0 built by …": the numbers end at the first token that is not all digits.
|
||||
string digits = new([.. token.TakeWhile(char.IsAsciiDigit)]);
|
||||
if (digits.Length == 0 || !int.TryParse(digits, NumberStyles.None, CultureInfo.InvariantCulture, out int n))
|
||||
{
|
||||
break;
|
||||
}
|
||||
|
||||
parts.Add(n);
|
||||
if (parts.Count == 4 || digits.Length != token.Length)
|
||||
{
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
return parts.Count == 0 ? null : [.. parts];
|
||||
}
|
||||
|
||||
/// <summary>The platform token as its store name.</summary>
|
||||
public static string Platform(string? token) => token switch
|
||||
{
|
||||
@@ -143,21 +253,32 @@ public static class Formats
|
||||
/// Why a Tier-2 session measured nothing, from <c>capture_notes</c> (2026-09-22): hooking off, a block on the row,
|
||||
/// the guard's refusal by family, a process that could not be opened, or the end reason by name.
|
||||
/// </summary>
|
||||
public static string Tier2Reason(string? captureNotes)
|
||||
public static string Tier2Reason(string? captureNotes) => Tier2Reason(Application.Recording.CaptureNotes.Parse(captureNotes));
|
||||
|
||||
/// <summary>The same words for a session still running (2026-09-23): the hold its <c>SessionStarted</c> carried.</summary>
|
||||
public static string Tier2HoldReason(Shared.Ipc.SessionHold hold)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(hold);
|
||||
return Tier2Reason(new Application.Recording.CaptureNotes(hold.Reason, hold.GuardReason, hold.Family, hold.Signal));
|
||||
}
|
||||
|
||||
private static string Tier2Reason(Application.Recording.CaptureNotes n)
|
||||
{
|
||||
Application.Recording.CaptureNotes n = Application.Recording.CaptureNotes.Parse(captureNotes);
|
||||
switch (n.End)
|
||||
{
|
||||
case null:
|
||||
return string.Empty;
|
||||
case "RefusedHookNotEnabled" when string.Equals(n.GuardReason, "PreviouslyBlocked", StringComparison.Ordinal) && n.GuardSignal is { Length: > 0 } blocked:
|
||||
return string.Format(CultureInfo.CurrentCulture, Strings.Summary_Tier2_Why_Blocked_Format, blocked);
|
||||
return string.Format(CultureInfo.CurrentCulture, Strings.Summary_Tier2_Why_Blocked_Format, BlockedReasonText.Describe(blocked));
|
||||
case "RefusedHookNotEnabled":
|
||||
return Strings.Summary_Tier2_Why_HookOff;
|
||||
case "RefusedByGuard" or "SafetyUnhook" when n.GuardFamily is { Length: > 0 } family:
|
||||
return string.Format(CultureInfo.CurrentCulture, Strings.Summary_Tier2_Why_Guard_Format, family, n.GuardSignal ?? Strings.Common_NotAvailable);
|
||||
case "TargetUnreadable":
|
||||
return Strings.Summary_Tier2_Why_Unreadable;
|
||||
case "RefusedConsentMissing":
|
||||
// Common after a store update (2026-09-23): the consent is about the executable that was enabled, and this is a newer one.
|
||||
return Strings.Summary_Tier2_Why_ConsentChanged;
|
||||
default:
|
||||
return string.Format(CultureInfo.CurrentCulture, Strings.Summary_Tier2_Why_Other_Format, n.End);
|
||||
}
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
using System.IO;
|
||||
using FrameLedger.Application.Import;
|
||||
using FrameLedger.Application.Persistence;
|
||||
using FrameLedger.Domain.Consent;
|
||||
using FrameLedger.Infrastructure.Import;
|
||||
using FrameLedger.Infrastructure.Io;
|
||||
|
||||
namespace FrameLedger.App.Services;
|
||||
@@ -60,17 +62,18 @@ public sealed class GameLibrary
|
||||
return null;
|
||||
}
|
||||
|
||||
string name = Path.GetFileNameWithoutExtension(normalised);
|
||||
// A generic executable (Game.exe) is named from the game's own title or its folder, not "Game" (2026-09-23).
|
||||
string name = GameTitleGuess.Guess(normalised, () => RpgMakerTitle.TryRead(normalised));
|
||||
return await _games.EnsureAsync(fingerprint.Value, name, ct).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
/// <summary>Whether the row's executable is where the row says (2026-09-22): the page's "not found" line, nothing else.</summary>
|
||||
public static bool ExecutableExists(string normalisedExePath) => ExecutableIdentity.Read(normalisedExePath) is not null;
|
||||
|
||||
/// <summary>
|
||||
/// Points the row at another executable; null when the file cannot be read, false when another row owns that path.
|
||||
/// The caller revokes consent over the pipe FIRST, as removal does: the table write only downgrades.
|
||||
/// </summary>
|
||||
/// <summary>Whether the row's executable is where the row says (2026-09-22): the page's "not found" line, nothing else.</summary>
|
||||
public static bool ExecutableExists(string normalisedExePath) => ExecutableIdentity.Read(normalisedExePath) is not null;
|
||||
|
||||
public async Task<bool?> ChangeExecutableAsync(long gameId, string exePath, CancellationToken ct = default)
|
||||
{
|
||||
ArgumentException.ThrowIfNullOrWhiteSpace(exePath);
|
||||
@@ -86,6 +89,12 @@ public sealed class GameLibrary
|
||||
|
||||
public Task<bool> RemoveAsync(long gameId, bool keepSessions, CancellationToken ct = default) => _games.RemoveAsync(gameId, keepSessions, ct).AsTask();
|
||||
|
||||
/// <summary>
|
||||
/// The entry's recording switch (schema 0009, 2026-09-23). The Agent reads the same table each tick, so nothing is
|
||||
/// sent over the pipe: off, it stops watching for the program and stops a session of it that is running.
|
||||
/// </summary>
|
||||
public Task<bool> SetRecordingAsync(long gameId, bool record, CancellationToken ct = default) => _games.SetRecordingAsync(gameId, record, ct).AsTask();
|
||||
|
||||
public Task<bool> UpdateMetadataAsync(long gameId, GameMetadata metadata, CancellationToken ct = default) => _games.UpdateMetadataAsync(gameId, metadata, ct).AsTask();
|
||||
|
||||
/// <summary>The Dashboard's recent list: the last <paramref name="count"/> sessions across games, with their game names.</summary>
|
||||
|
||||
@@ -21,6 +21,12 @@ public sealed record HookingConsentResult(HookingConsentOutcome Outcome, string?
|
||||
return Shared.Strings.Safety_Refused_CouldNotVerify;
|
||||
}
|
||||
|
||||
// beta.8: the Agent refused because the executable cannot run as x64 — nothing was scanned (AgentCommandHandler.NotX64Reason).
|
||||
if (string.Equals(Refusal.Reason, "ExecutableNotX64", StringComparison.Ordinal))
|
||||
{
|
||||
return string.Format(System.Globalization.CultureInfo.CurrentCulture, Strings.Hooking_NotX64_Format, Formats.Architecture(Refusal.Signal));
|
||||
}
|
||||
|
||||
string? family = Refusal.Family ?? Refusal.Signal;
|
||||
return family is null
|
||||
? Shared.Strings.Safety_Refused_Unnamed
|
||||
|
||||
@@ -0,0 +1,94 @@
|
||||
using FrameLedger.Shared.Ipc;
|
||||
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>
|
||||
/// The sessions the Agent is running right now, kept for the App's whole life (2026-09-23): seeded from the status the
|
||||
/// Agent answers on every (re)connect, then moved by <c>SessionStarted</c> and <c>SessionCompleted</c>. Until this date the
|
||||
/// Dashboard, the tray and the updater each kept their own list from events alone — a Dashboard opened after a game
|
||||
/// started (it is rebuilt on every visit) showed "Nothing is being captured.", the updater read a status hours old, and a
|
||||
/// session the Agent never announced (every Tier-2 one) was in none of them.
|
||||
/// </summary>
|
||||
public sealed class LiveSessions : IDisposable
|
||||
{
|
||||
private readonly IAgentLink _agent;
|
||||
private readonly Lock _lock = new();
|
||||
private readonly Dictionary<Guid, RunningSession> _sessions = [];
|
||||
|
||||
public LiveSessions(IAgentLink agent)
|
||||
{
|
||||
_agent = agent ?? throw new ArgumentNullException(nameof(agent));
|
||||
_agent.Changed += OnAgentChanged;
|
||||
_agent.EventReceived += OnAgentEvent;
|
||||
Reseed();
|
||||
}
|
||||
|
||||
/// <summary>Raised on any change, on the thread that caused it; a view model marshals it as it does the link's own events.</summary>
|
||||
public event EventHandler? Changed;
|
||||
|
||||
/// <summary>A snapshot, oldest first.</summary>
|
||||
public IReadOnlyList<RunningSession> Current
|
||||
{
|
||||
get
|
||||
{
|
||||
lock (_lock)
|
||||
{
|
||||
return [.. _sessions.Values.OrderBy(static s => s.StartedAt)];
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
public void Dispose()
|
||||
{
|
||||
_agent.Changed -= OnAgentChanged;
|
||||
_agent.EventReceived -= OnAgentEvent;
|
||||
}
|
||||
|
||||
// The link raises Changed with a fresh StatusAck whenever it (re)connects, and on every state it leaves Connected for.
|
||||
private void OnAgentChanged(object? sender, EventArgs e) => Reseed();
|
||||
|
||||
private void Reseed()
|
||||
{
|
||||
StatusAck? status = _agent.State == AgentConnectionState.Connected ? _agent.Status : null;
|
||||
lock (_lock)
|
||||
{
|
||||
_sessions.Clear();
|
||||
foreach (ActiveSession a in status?.ActiveSessions ?? [])
|
||||
{
|
||||
_sessions[a.SessionGuid] = new RunningSession(a.SessionGuid, a.GameId, a.GameName, a.Tier, a.StartedAt, a.Hold);
|
||||
}
|
||||
}
|
||||
|
||||
Changed?.Invoke(this, EventArgs.Empty);
|
||||
}
|
||||
|
||||
private void OnAgentEvent(object? sender, AgentEventArgs e)
|
||||
{
|
||||
switch (e.Envelope.Type)
|
||||
{
|
||||
case IpcMessageType.SessionStarted when IpcCodec.Payload<SessionStartedEvent>(e.Envelope) is { } started:
|
||||
lock (_lock)
|
||||
{
|
||||
_sessions[started.SessionGuid] = new RunningSession(started.SessionGuid, started.GameId, started.GameName, started.Tier, started.StartedAt, started.Hold);
|
||||
}
|
||||
|
||||
Changed?.Invoke(this, EventArgs.Empty);
|
||||
break;
|
||||
case IpcMessageType.SessionCompleted when IpcCodec.Payload<SessionCompletedEvent>(e.Envelope) is { } completed:
|
||||
bool removed;
|
||||
lock (_lock)
|
||||
{
|
||||
removed = _sessions.Remove(completed.SessionGuid);
|
||||
}
|
||||
|
||||
if (removed)
|
||||
{
|
||||
Changed?.Invoke(this, EventArgs.Empty);
|
||||
}
|
||||
|
||||
break;
|
||||
default:
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,6 @@
|
||||
using FrameLedger.Shared.Ipc;
|
||||
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>One session the Agent is running, as the App knows it: its entry, its tier and — for Tier 2 — why nothing is measured.</summary>
|
||||
public sealed record RunningSession(Guid SessionGuid, long GameId, string? GameName, int Tier, DateTimeOffset StartedAt, SessionHold? Hold);
|
||||
@@ -5,10 +5,10 @@ namespace FrameLedger.App.Services;
|
||||
/// <summary>One persistent safety notice: what happened, in plain language, with the signal named; dismissed by the user and never by a timeout.</summary>
|
||||
public sealed record SafetyNotice(SafetyNoticeKind Kind, string Title, string Body, DateTimeOffset At)
|
||||
{
|
||||
public bool IsError => Kind is SafetyNoticeKind.Refused or SafetyNoticeKind.Unhooked;
|
||||
public bool IsError => Kind is SafetyNoticeKind.Refused or SafetyNoticeKind.Unhooked or SafetyNoticeKind.HookingOff;
|
||||
|
||||
public InfoBarSeverity Severity => IsError ? InfoBarSeverity.Error : InfoBarSeverity.Warning;
|
||||
|
||||
/// <summary>The one action FR-14 allows on a refusal — acknowledging that the session is recorded without measuring — and a plain Dismiss otherwise.</summary>
|
||||
/// <summary>The one action FR-14 allows on a refusal — acknowledging that the session is recorded without measuring — and a plain Dismiss otherwise (no session is running for the others).</summary>
|
||||
public string ActionText => Kind == SafetyNoticeKind.Refused ? Shared.Strings.Safety_RecordWithoutMeasuring : Strings.Notice_Dismiss;
|
||||
}
|
||||
@@ -11,4 +11,10 @@ public enum SafetyNoticeKind
|
||||
|
||||
/// <summary><c>CaptureDegraded</c>: measurement stopped mid-session for another reason.</summary>
|
||||
Degraded,
|
||||
|
||||
/// <summary>
|
||||
/// <c>HookingTurnedOff</c> (2026-09-25): the Agent's pre-scan of the library found anti-cheat in a game whose hooking
|
||||
/// the user had turned on, and turned it off. No session is running, so there is nothing to record without measuring.
|
||||
/// </summary>
|
||||
HookingOff,
|
||||
}
|
||||
@@ -51,6 +51,12 @@ public sealed class SafetyNotices : IDisposable
|
||||
case IpcMessageType.SafetyUnhook when IpcCodec.Payload<SafetyUnhookEvent>(envelope) is { } unhooked:
|
||||
return new SafetyNotice(SafetyNoticeKind.Unhooked, Strings.Notice_Unhooked_Title,
|
||||
TurnedOff(string.Format(CultureInfo.CurrentCulture, Shared.Strings.Safety_Unhooked_Format, unhooked.Family ?? unhooked.Signal ?? Strings.Common_NotAvailable), unhooked.HookingTurnedOff), now);
|
||||
// The Agent's pre-scan of the library turned hooking off for a game the user had turned it on for (2026-09-25):
|
||||
// not a session event, so none of a refusal's "this run is still recorded" — no run is going on.
|
||||
case IpcMessageType.HookingTurnedOff when IpcCodec.Payload<HookingTurnedOffEvent>(envelope) is { } off:
|
||||
return new SafetyNotice(SafetyNoticeKind.HookingOff,
|
||||
string.Format(CultureInfo.CurrentCulture, Strings.Notice_HookingOff_Title_Format, off.GameName ?? Strings.Common_NotAvailable),
|
||||
TurnedOff(RefusalText(off.Reason, off.Family, off.Signal), turnedOff: true), now);
|
||||
case IpcMessageType.CaptureDegraded when IpcCodec.Payload<CaptureDegradedEvent>(envelope) is { } degraded:
|
||||
return new SafetyNotice(SafetyNoticeKind.Degraded, Strings.Notice_Degraded_Title,
|
||||
string.Format(CultureInfo.CurrentCulture, Strings.Notice_Degraded_Body_Format, degraded.Reason), now);
|
||||
|
||||
Generated
+138
@@ -46,6 +46,20 @@ public static class Strings
|
||||
nameof(Agent_State_Offline),
|
||||
nameof(Agent_State_Starting),
|
||||
nameof(App_Title),
|
||||
nameof(Arch_AnyCpu),
|
||||
nameof(Arch_AnyCpu32),
|
||||
nameof(Arch_Arm),
|
||||
nameof(Arch_Arm64),
|
||||
nameof(Arch_Other),
|
||||
nameof(Arch_Unknown),
|
||||
nameof(Arch_X64),
|
||||
nameof(Arch_X86),
|
||||
nameof(Blocked_Directory_Format),
|
||||
nameof(Blocked_Executable_Format),
|
||||
nameof(Blocked_File_Format),
|
||||
nameof(Blocked_Module_Format),
|
||||
nameof(Blocked_Other_Format),
|
||||
nameof(Blocked_StoreId_Format),
|
||||
nameof(BugReport_BrowserRefused),
|
||||
nameof(BugReport_ClipboardRefused),
|
||||
nameof(BugReport_Copied),
|
||||
@@ -147,6 +161,7 @@ public static class Strings
|
||||
nameof(Dashboard_Live_GpuTemp_Format),
|
||||
nameof(Dashboard_Live_Header),
|
||||
nameof(Dashboard_Live_Idle),
|
||||
nameof(Dashboard_Live_RecordingOnly),
|
||||
nameof(Dashboard_Live_Rt_On),
|
||||
nameof(Dashboard_Live_Vram_Format),
|
||||
nameof(Dashboard_Live_Waiting),
|
||||
@@ -245,8 +260,22 @@ public static class Strings
|
||||
nameof(Fps_Native_Tooltip),
|
||||
nameof(Fps_None_Tooltip),
|
||||
nameof(Fps_Presented_Format),
|
||||
nameof(GameDetail_AntiCheat_Format),
|
||||
nameof(GameDetail_AntiCheat_Header),
|
||||
nameof(GameDetail_Back),
|
||||
nameof(GameDetail_ChangeExe),
|
||||
nameof(GameDetail_Details_Architecture),
|
||||
nameof(GameDetail_Details_Engine),
|
||||
nameof(GameDetail_Details_FileVersion),
|
||||
nameof(GameDetail_Details_Header),
|
||||
nameof(GameDetail_Details_Libraries),
|
||||
nameof(GameDetail_Details_Library_Format),
|
||||
nameof(GameDetail_Details_LibraryNoVersion_Format),
|
||||
nameof(GameDetail_Details_NoLibraries),
|
||||
nameof(GameDetail_Details_NotRead),
|
||||
nameof(GameDetail_Details_ProductVersion),
|
||||
nameof(GameDetail_Details_Store),
|
||||
nameof(GameDetail_Details_Version),
|
||||
nameof(GameDetail_Edit),
|
||||
nameof(GameDetail_ExeMissing),
|
||||
nameof(GameDetail_Hooking_Body),
|
||||
@@ -262,6 +291,10 @@ public static class Strings
|
||||
nameof(GameDetail_Measured_Header),
|
||||
nameof(GameDetail_Measured_NotHooked),
|
||||
nameof(GameDetail_NotFound),
|
||||
nameof(GameDetail_Recording_Body),
|
||||
nameof(GameDetail_Recording_Header),
|
||||
nameof(GameDetail_Recording_Off),
|
||||
nameof(GameDetail_Recording_On),
|
||||
nameof(GameDetail_Remove),
|
||||
nameof(GameDetail_Sessions_Empty),
|
||||
nameof(GameDetail_Supports_Empty),
|
||||
@@ -275,10 +308,12 @@ public static class Strings
|
||||
nameof(GameDetail_Tab_Sessions),
|
||||
nameof(GameDetail_Tab_Trend),
|
||||
nameof(Games_Add),
|
||||
nameof(Games_Card_AntiCheat),
|
||||
nameof(Games_Card_HookOff),
|
||||
nameof(Games_Card_HookOn),
|
||||
nameof(Games_Card_LastPlayed_Format),
|
||||
nameof(Games_Card_NeverPlayed),
|
||||
nameof(Games_Card_NotRecorded),
|
||||
nameof(Games_Card_Playtime_Format),
|
||||
nameof(Games_Card_Sessions_Format),
|
||||
nameof(Games_Empty),
|
||||
@@ -289,6 +324,7 @@ public static class Strings
|
||||
nameof(Games_Sort_LastPlayed),
|
||||
nameof(Games_Sort_Name),
|
||||
nameof(Games_Sort_Playtime),
|
||||
nameof(Hooking_NotX64_Format),
|
||||
nameof(Import_Add),
|
||||
nameof(Import_Column_Exe),
|
||||
nameof(Import_Column_Name),
|
||||
@@ -298,6 +334,7 @@ public static class Strings
|
||||
nameof(Import_Intro),
|
||||
nameof(Import_Note_Already),
|
||||
nameof(Import_Note_Guessed),
|
||||
nameof(Import_Note_Moved),
|
||||
nameof(Import_Note_NoExe),
|
||||
nameof(Import_NothingFound),
|
||||
nameof(Import_SelectAll),
|
||||
@@ -385,6 +422,7 @@ public static class Strings
|
||||
nameof(Notice_Degraded_Title),
|
||||
nameof(Notice_Dismiss),
|
||||
nameof(Notice_Error_Title),
|
||||
nameof(Notice_HookingOff_Title_Format),
|
||||
nameof(Notice_Refused_Recording),
|
||||
nameof(Notice_Refused_Title_Format),
|
||||
nameof(Notice_Unhooked_Title),
|
||||
@@ -451,6 +489,8 @@ public static class Strings
|
||||
nameof(Settings_Channel_Beta),
|
||||
nameof(Settings_Channel_Stable),
|
||||
nameof(Settings_Header),
|
||||
nameof(Settings_HideAntiCheatHooking_Body),
|
||||
nameof(Settings_HideAntiCheatHooking_Label),
|
||||
nameof(Settings_HookedGames_Empty),
|
||||
nameof(Settings_HookedGames_Label),
|
||||
nameof(Settings_HookedGames_Revoke),
|
||||
@@ -505,6 +545,9 @@ public static class Strings
|
||||
nameof(Settings_Window_Header),
|
||||
nameof(StartupFailed_Body_Format),
|
||||
nameof(StartupFailed_Title),
|
||||
nameof(Store_Epic_Format),
|
||||
nameof(Store_Gog_Format),
|
||||
nameof(Store_Steam_Format),
|
||||
nameof(Summary_Annotations_Header),
|
||||
nameof(Summary_Crash_Body),
|
||||
nameof(Summary_Crash_Title),
|
||||
@@ -516,6 +559,8 @@ public static class Strings
|
||||
nameof(Summary_Export_Tier2),
|
||||
nameof(Summary_Exported_Format),
|
||||
nameof(Summary_Frametime_Header),
|
||||
nameof(Summary_Libraries_Format),
|
||||
nameof(Summary_Library_Differs_Format),
|
||||
nameof(Summary_Line_Format),
|
||||
nameof(Summary_Lows_Presented),
|
||||
nameof(Summary_Notes_Placeholder),
|
||||
@@ -542,6 +587,7 @@ public static class Strings
|
||||
nameof(Summary_Tags_Placeholder),
|
||||
nameof(Summary_Tier2_Body),
|
||||
nameof(Summary_Tier2_Why_Blocked_Format),
|
||||
nameof(Summary_Tier2_Why_ConsentChanged),
|
||||
nameof(Summary_Tier2_Why_Guard_Format),
|
||||
nameof(Summary_Tier2_Why_HookOff),
|
||||
nameof(Summary_Tier2_Why_Other_Format),
|
||||
@@ -674,6 +720,34 @@ public static class Strings
|
||||
|
||||
public static string App_Title => ResourceManager.GetString(nameof(App_Title), Culture) ?? nameof(App_Title);
|
||||
|
||||
public static string Arch_AnyCpu => ResourceManager.GetString(nameof(Arch_AnyCpu), Culture) ?? nameof(Arch_AnyCpu);
|
||||
|
||||
public static string Arch_AnyCpu32 => ResourceManager.GetString(nameof(Arch_AnyCpu32), Culture) ?? nameof(Arch_AnyCpu32);
|
||||
|
||||
public static string Arch_Arm => ResourceManager.GetString(nameof(Arch_Arm), Culture) ?? nameof(Arch_Arm);
|
||||
|
||||
public static string Arch_Arm64 => ResourceManager.GetString(nameof(Arch_Arm64), Culture) ?? nameof(Arch_Arm64);
|
||||
|
||||
public static string Arch_Other => ResourceManager.GetString(nameof(Arch_Other), Culture) ?? nameof(Arch_Other);
|
||||
|
||||
public static string Arch_Unknown => ResourceManager.GetString(nameof(Arch_Unknown), Culture) ?? nameof(Arch_Unknown);
|
||||
|
||||
public static string Arch_X64 => ResourceManager.GetString(nameof(Arch_X64), Culture) ?? nameof(Arch_X64);
|
||||
|
||||
public static string Arch_X86 => ResourceManager.GetString(nameof(Arch_X86), Culture) ?? nameof(Arch_X86);
|
||||
|
||||
public static string Blocked_Directory_Format => ResourceManager.GetString(nameof(Blocked_Directory_Format), Culture) ?? nameof(Blocked_Directory_Format);
|
||||
|
||||
public static string Blocked_Executable_Format => ResourceManager.GetString(nameof(Blocked_Executable_Format), Culture) ?? nameof(Blocked_Executable_Format);
|
||||
|
||||
public static string Blocked_File_Format => ResourceManager.GetString(nameof(Blocked_File_Format), Culture) ?? nameof(Blocked_File_Format);
|
||||
|
||||
public static string Blocked_Module_Format => ResourceManager.GetString(nameof(Blocked_Module_Format), Culture) ?? nameof(Blocked_Module_Format);
|
||||
|
||||
public static string Blocked_Other_Format => ResourceManager.GetString(nameof(Blocked_Other_Format), Culture) ?? nameof(Blocked_Other_Format);
|
||||
|
||||
public static string Blocked_StoreId_Format => ResourceManager.GetString(nameof(Blocked_StoreId_Format), Culture) ?? nameof(Blocked_StoreId_Format);
|
||||
|
||||
public static string BugReport_BrowserRefused => ResourceManager.GetString(nameof(BugReport_BrowserRefused), Culture) ?? nameof(BugReport_BrowserRefused);
|
||||
|
||||
public static string BugReport_ClipboardRefused => ResourceManager.GetString(nameof(BugReport_ClipboardRefused), Culture) ?? nameof(BugReport_ClipboardRefused);
|
||||
@@ -876,6 +950,8 @@ public static class Strings
|
||||
|
||||
public static string Dashboard_Live_Idle => ResourceManager.GetString(nameof(Dashboard_Live_Idle), Culture) ?? nameof(Dashboard_Live_Idle);
|
||||
|
||||
public static string Dashboard_Live_RecordingOnly => ResourceManager.GetString(nameof(Dashboard_Live_RecordingOnly), Culture) ?? nameof(Dashboard_Live_RecordingOnly);
|
||||
|
||||
public static string Dashboard_Live_Rt_On => ResourceManager.GetString(nameof(Dashboard_Live_Rt_On), Culture) ?? nameof(Dashboard_Live_Rt_On);
|
||||
|
||||
public static string Dashboard_Live_Vram_Format => ResourceManager.GetString(nameof(Dashboard_Live_Vram_Format), Culture) ?? nameof(Dashboard_Live_Vram_Format);
|
||||
@@ -1072,10 +1148,38 @@ public static class Strings
|
||||
|
||||
public static string Fps_Presented_Format => ResourceManager.GetString(nameof(Fps_Presented_Format), Culture) ?? nameof(Fps_Presented_Format);
|
||||
|
||||
public static string GameDetail_AntiCheat_Format => ResourceManager.GetString(nameof(GameDetail_AntiCheat_Format), Culture) ?? nameof(GameDetail_AntiCheat_Format);
|
||||
|
||||
public static string GameDetail_AntiCheat_Header => ResourceManager.GetString(nameof(GameDetail_AntiCheat_Header), Culture) ?? nameof(GameDetail_AntiCheat_Header);
|
||||
|
||||
public static string GameDetail_Back => ResourceManager.GetString(nameof(GameDetail_Back), Culture) ?? nameof(GameDetail_Back);
|
||||
|
||||
public static string GameDetail_ChangeExe => ResourceManager.GetString(nameof(GameDetail_ChangeExe), Culture) ?? nameof(GameDetail_ChangeExe);
|
||||
|
||||
public static string GameDetail_Details_Architecture => ResourceManager.GetString(nameof(GameDetail_Details_Architecture), Culture) ?? nameof(GameDetail_Details_Architecture);
|
||||
|
||||
public static string GameDetail_Details_Engine => ResourceManager.GetString(nameof(GameDetail_Details_Engine), Culture) ?? nameof(GameDetail_Details_Engine);
|
||||
|
||||
public static string GameDetail_Details_FileVersion => ResourceManager.GetString(nameof(GameDetail_Details_FileVersion), Culture) ?? nameof(GameDetail_Details_FileVersion);
|
||||
|
||||
public static string GameDetail_Details_Header => ResourceManager.GetString(nameof(GameDetail_Details_Header), Culture) ?? nameof(GameDetail_Details_Header);
|
||||
|
||||
public static string GameDetail_Details_Libraries => ResourceManager.GetString(nameof(GameDetail_Details_Libraries), Culture) ?? nameof(GameDetail_Details_Libraries);
|
||||
|
||||
public static string GameDetail_Details_Library_Format => ResourceManager.GetString(nameof(GameDetail_Details_Library_Format), Culture) ?? nameof(GameDetail_Details_Library_Format);
|
||||
|
||||
public static string GameDetail_Details_LibraryNoVersion_Format => ResourceManager.GetString(nameof(GameDetail_Details_LibraryNoVersion_Format), Culture) ?? nameof(GameDetail_Details_LibraryNoVersion_Format);
|
||||
|
||||
public static string GameDetail_Details_NoLibraries => ResourceManager.GetString(nameof(GameDetail_Details_NoLibraries), Culture) ?? nameof(GameDetail_Details_NoLibraries);
|
||||
|
||||
public static string GameDetail_Details_NotRead => ResourceManager.GetString(nameof(GameDetail_Details_NotRead), Culture) ?? nameof(GameDetail_Details_NotRead);
|
||||
|
||||
public static string GameDetail_Details_ProductVersion => ResourceManager.GetString(nameof(GameDetail_Details_ProductVersion), Culture) ?? nameof(GameDetail_Details_ProductVersion);
|
||||
|
||||
public static string GameDetail_Details_Store => ResourceManager.GetString(nameof(GameDetail_Details_Store), Culture) ?? nameof(GameDetail_Details_Store);
|
||||
|
||||
public static string GameDetail_Details_Version => ResourceManager.GetString(nameof(GameDetail_Details_Version), Culture) ?? nameof(GameDetail_Details_Version);
|
||||
|
||||
public static string GameDetail_Edit => ResourceManager.GetString(nameof(GameDetail_Edit), Culture) ?? nameof(GameDetail_Edit);
|
||||
|
||||
public static string GameDetail_ExeMissing => ResourceManager.GetString(nameof(GameDetail_ExeMissing), Culture) ?? nameof(GameDetail_ExeMissing);
|
||||
@@ -1106,6 +1210,14 @@ public static class Strings
|
||||
|
||||
public static string GameDetail_NotFound => ResourceManager.GetString(nameof(GameDetail_NotFound), Culture) ?? nameof(GameDetail_NotFound);
|
||||
|
||||
public static string GameDetail_Recording_Body => ResourceManager.GetString(nameof(GameDetail_Recording_Body), Culture) ?? nameof(GameDetail_Recording_Body);
|
||||
|
||||
public static string GameDetail_Recording_Header => ResourceManager.GetString(nameof(GameDetail_Recording_Header), Culture) ?? nameof(GameDetail_Recording_Header);
|
||||
|
||||
public static string GameDetail_Recording_Off => ResourceManager.GetString(nameof(GameDetail_Recording_Off), Culture) ?? nameof(GameDetail_Recording_Off);
|
||||
|
||||
public static string GameDetail_Recording_On => ResourceManager.GetString(nameof(GameDetail_Recording_On), Culture) ?? nameof(GameDetail_Recording_On);
|
||||
|
||||
public static string GameDetail_Remove => ResourceManager.GetString(nameof(GameDetail_Remove), Culture) ?? nameof(GameDetail_Remove);
|
||||
|
||||
public static string GameDetail_Sessions_Empty => ResourceManager.GetString(nameof(GameDetail_Sessions_Empty), Culture) ?? nameof(GameDetail_Sessions_Empty);
|
||||
@@ -1132,6 +1244,8 @@ public static class Strings
|
||||
|
||||
public static string Games_Add => ResourceManager.GetString(nameof(Games_Add), Culture) ?? nameof(Games_Add);
|
||||
|
||||
public static string Games_Card_AntiCheat => ResourceManager.GetString(nameof(Games_Card_AntiCheat), Culture) ?? nameof(Games_Card_AntiCheat);
|
||||
|
||||
public static string Games_Card_HookOff => ResourceManager.GetString(nameof(Games_Card_HookOff), Culture) ?? nameof(Games_Card_HookOff);
|
||||
|
||||
public static string Games_Card_HookOn => ResourceManager.GetString(nameof(Games_Card_HookOn), Culture) ?? nameof(Games_Card_HookOn);
|
||||
@@ -1140,6 +1254,8 @@ public static class Strings
|
||||
|
||||
public static string Games_Card_NeverPlayed => ResourceManager.GetString(nameof(Games_Card_NeverPlayed), Culture) ?? nameof(Games_Card_NeverPlayed);
|
||||
|
||||
public static string Games_Card_NotRecorded => ResourceManager.GetString(nameof(Games_Card_NotRecorded), Culture) ?? nameof(Games_Card_NotRecorded);
|
||||
|
||||
public static string Games_Card_Playtime_Format => ResourceManager.GetString(nameof(Games_Card_Playtime_Format), Culture) ?? nameof(Games_Card_Playtime_Format);
|
||||
|
||||
public static string Games_Card_Sessions_Format => ResourceManager.GetString(nameof(Games_Card_Sessions_Format), Culture) ?? nameof(Games_Card_Sessions_Format);
|
||||
@@ -1160,6 +1276,8 @@ public static class Strings
|
||||
|
||||
public static string Games_Sort_Playtime => ResourceManager.GetString(nameof(Games_Sort_Playtime), Culture) ?? nameof(Games_Sort_Playtime);
|
||||
|
||||
public static string Hooking_NotX64_Format => ResourceManager.GetString(nameof(Hooking_NotX64_Format), Culture) ?? nameof(Hooking_NotX64_Format);
|
||||
|
||||
public static string Import_Add => ResourceManager.GetString(nameof(Import_Add), Culture) ?? nameof(Import_Add);
|
||||
|
||||
public static string Import_Column_Exe => ResourceManager.GetString(nameof(Import_Column_Exe), Culture) ?? nameof(Import_Column_Exe);
|
||||
@@ -1178,6 +1296,8 @@ public static class Strings
|
||||
|
||||
public static string Import_Note_Guessed => ResourceManager.GetString(nameof(Import_Note_Guessed), Culture) ?? nameof(Import_Note_Guessed);
|
||||
|
||||
public static string Import_Note_Moved => ResourceManager.GetString(nameof(Import_Note_Moved), Culture) ?? nameof(Import_Note_Moved);
|
||||
|
||||
public static string Import_Note_NoExe => ResourceManager.GetString(nameof(Import_Note_NoExe), Culture) ?? nameof(Import_Note_NoExe);
|
||||
|
||||
public static string Import_NothingFound => ResourceManager.GetString(nameof(Import_NothingFound), Culture) ?? nameof(Import_NothingFound);
|
||||
@@ -1352,6 +1472,8 @@ public static class Strings
|
||||
|
||||
public static string Notice_Error_Title => ResourceManager.GetString(nameof(Notice_Error_Title), Culture) ?? nameof(Notice_Error_Title);
|
||||
|
||||
public static string Notice_HookingOff_Title_Format => ResourceManager.GetString(nameof(Notice_HookingOff_Title_Format), Culture) ?? nameof(Notice_HookingOff_Title_Format);
|
||||
|
||||
public static string Notice_Refused_Recording => ResourceManager.GetString(nameof(Notice_Refused_Recording), Culture) ?? nameof(Notice_Refused_Recording);
|
||||
|
||||
public static string Notice_Refused_Title_Format => ResourceManager.GetString(nameof(Notice_Refused_Title_Format), Culture) ?? nameof(Notice_Refused_Title_Format);
|
||||
@@ -1484,6 +1606,10 @@ public static class Strings
|
||||
|
||||
public static string Settings_Header => ResourceManager.GetString(nameof(Settings_Header), Culture) ?? nameof(Settings_Header);
|
||||
|
||||
public static string Settings_HideAntiCheatHooking_Body => ResourceManager.GetString(nameof(Settings_HideAntiCheatHooking_Body), Culture) ?? nameof(Settings_HideAntiCheatHooking_Body);
|
||||
|
||||
public static string Settings_HideAntiCheatHooking_Label => ResourceManager.GetString(nameof(Settings_HideAntiCheatHooking_Label), Culture) ?? nameof(Settings_HideAntiCheatHooking_Label);
|
||||
|
||||
public static string Settings_HookedGames_Empty => ResourceManager.GetString(nameof(Settings_HookedGames_Empty), Culture) ?? nameof(Settings_HookedGames_Empty);
|
||||
|
||||
public static string Settings_HookedGames_Label => ResourceManager.GetString(nameof(Settings_HookedGames_Label), Culture) ?? nameof(Settings_HookedGames_Label);
|
||||
@@ -1592,6 +1718,12 @@ public static class Strings
|
||||
|
||||
public static string StartupFailed_Title => ResourceManager.GetString(nameof(StartupFailed_Title), Culture) ?? nameof(StartupFailed_Title);
|
||||
|
||||
public static string Store_Epic_Format => ResourceManager.GetString(nameof(Store_Epic_Format), Culture) ?? nameof(Store_Epic_Format);
|
||||
|
||||
public static string Store_Gog_Format => ResourceManager.GetString(nameof(Store_Gog_Format), Culture) ?? nameof(Store_Gog_Format);
|
||||
|
||||
public static string Store_Steam_Format => ResourceManager.GetString(nameof(Store_Steam_Format), Culture) ?? nameof(Store_Steam_Format);
|
||||
|
||||
public static string Summary_Annotations_Header => ResourceManager.GetString(nameof(Summary_Annotations_Header), Culture) ?? nameof(Summary_Annotations_Header);
|
||||
|
||||
public static string Summary_Crash_Body => ResourceManager.GetString(nameof(Summary_Crash_Body), Culture) ?? nameof(Summary_Crash_Body);
|
||||
@@ -1614,6 +1746,10 @@ public static class Strings
|
||||
|
||||
public static string Summary_Frametime_Header => ResourceManager.GetString(nameof(Summary_Frametime_Header), Culture) ?? nameof(Summary_Frametime_Header);
|
||||
|
||||
public static string Summary_Libraries_Format => ResourceManager.GetString(nameof(Summary_Libraries_Format), Culture) ?? nameof(Summary_Libraries_Format);
|
||||
|
||||
public static string Summary_Library_Differs_Format => ResourceManager.GetString(nameof(Summary_Library_Differs_Format), Culture) ?? nameof(Summary_Library_Differs_Format);
|
||||
|
||||
public static string Summary_Line_Format => ResourceManager.GetString(nameof(Summary_Line_Format), Culture) ?? nameof(Summary_Line_Format);
|
||||
|
||||
public static string Summary_Lows_Presented => ResourceManager.GetString(nameof(Summary_Lows_Presented), Culture) ?? nameof(Summary_Lows_Presented);
|
||||
@@ -1666,6 +1802,8 @@ public static class Strings
|
||||
|
||||
public static string Summary_Tier2_Why_Blocked_Format => ResourceManager.GetString(nameof(Summary_Tier2_Why_Blocked_Format), Culture) ?? nameof(Summary_Tier2_Why_Blocked_Format);
|
||||
|
||||
public static string Summary_Tier2_Why_ConsentChanged => ResourceManager.GetString(nameof(Summary_Tier2_Why_ConsentChanged), Culture) ?? nameof(Summary_Tier2_Why_ConsentChanged);
|
||||
|
||||
public static string Summary_Tier2_Why_Guard_Format => ResourceManager.GetString(nameof(Summary_Tier2_Why_Guard_Format), Culture) ?? nameof(Summary_Tier2_Why_Guard_Format);
|
||||
|
||||
public static string Summary_Tier2_Why_HookOff => ResourceManager.GetString(nameof(Summary_Tier2_Why_HookOff), Culture) ?? nameof(Summary_Tier2_Why_HookOff);
|
||||
|
||||
@@ -261,6 +261,10 @@
|
||||
<value>推定 — 確認してください</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Import_Note_Moved" xml:space="preserve">
|
||||
<value>別のドライブ文字でライブラリに登録済み — そのエントリがこのファイルに追従します</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Import_Selected_Format" xml:space="preserve">
|
||||
<value>{1} 件中 {0} 件を選択</value>
|
||||
<comment>review</comment>
|
||||
@@ -481,6 +485,10 @@
|
||||
<value>現在キャプチャ中のものはありません。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Dashboard_Live_RecordingOnly" xml:space="preserve">
|
||||
<value>時間とセンサーのみを記録中 — 計測は行っていません。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Dashboard_Live_Rt_On" xml:space="preserve">
|
||||
<value>RT 有効</value>
|
||||
<comment>review</comment>
|
||||
@@ -761,6 +769,22 @@
|
||||
<value>キャプチャエージェントに問い合わせ中…</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Recording_Header" xml:space="preserve">
|
||||
<value>記録</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Recording_On" xml:space="preserve">
|
||||
<value>起動するたびに記録します</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Recording_Off" xml:space="preserve">
|
||||
<value>無視 — 何も記録しません</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Recording_Body" xml:space="preserve">
|
||||
<value>ゲームではないプログラム(Windows と同時に起動するユーティリティなど)ではオフにしてください。オフの間、FrameLedger はそのプログラムを監視しません。セッションは記録されず、計測も注入も行わず、実行中のセッションは停止します。記録済みのセッションは残ります。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Hooking_Header" xml:space="preserve">
|
||||
<value>フック</value>
|
||||
<comment>review</comment>
|
||||
@@ -857,6 +881,10 @@
|
||||
<value>ゲームを追加…</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_Card_NotRecorded" xml:space="preserve">
|
||||
<value>記録しない</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_Card_HookOff" xml:space="preserve">
|
||||
<value>フック無効</value>
|
||||
<comment>review</comment>
|
||||
@@ -1229,6 +1257,10 @@
|
||||
<value>理由: このゲームのフックはオフです — ガードが {0} を検出しました。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Summary_Tier2_Why_ConsentChanged" xml:space="preserve">
|
||||
<value>理由: フックをオンにした後にゲームの実行ファイルが変わった(通常はアップデート)ため、その同意は適用されません — このゲームのフックをもう一度オンにしてください。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Summary_Tier2_Why_Guard_Format" xml:space="preserve">
|
||||
<value>理由: ガードが拒否しました — {0}({1})。</value>
|
||||
<comment>review</comment>
|
||||
@@ -2457,4 +2489,156 @@
|
||||
以下の文書が正式な条項であり、この要約はそれらに代わるものではありません。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Blocked_Module_Format" xml:space="preserve">
|
||||
<value>{0} — モジュール {1} がゲーム内で読み込まれました</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Blocked_Directory_Format" xml:space="preserve">
|
||||
<value>{0} — フォルダー {1} がゲームに同梱されています</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Blocked_File_Format" xml:space="preserve">
|
||||
<value>{0} — {1} がゲームに同梱されています</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Blocked_Executable_Format" xml:space="preserve">
|
||||
<value>{0} — {1} はリストに登録されたタイトルです</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Blocked_StoreId_Format" xml:space="preserve">
|
||||
<value>{0} — ゲームのストアID {1} がリストに登録されています</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Blocked_Other_Format" xml:space="preserve">
|
||||
<value>{0}({1})</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_AntiCheat_Header" xml:space="preserve">
|
||||
<value>アンチチート</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_AntiCheat_Format" xml:space="preserve">
|
||||
<value>検出: {0}。このゲームのフックはオフで、オンにすることはできません。セッションにはプレイ時間とセンサーの値だけが記録されます。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_Card_AntiCheat" xml:space="preserve">
|
||||
<value>アンチチート</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_HideAntiCheatHooking_Label" xml:space="preserve">
|
||||
<value>アンチチート搭載ゲームのフック設定を隠す</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_HideAntiCheatHooking_Body" xml:space="preserve">
|
||||
<value>アンチチートが検出されたゲームはフックできません。オンにするとゲームのページには検出内容だけが表示され、オフにすると無効化されたフックのスイッチも表示されます。どちらの場合も、フックなしで記録は続きます。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Notice_HookingOff_Title_Format" xml:space="preserve">
|
||||
<value>{0}: フックがオフになりました</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Arch_X64" xml:space="preserve">
|
||||
<value>64ビット (x64)</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Arch_X86" xml:space="preserve">
|
||||
<value>32ビット (x86)</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Arch_Arm64" xml:space="preserve">
|
||||
<value>ARM64</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Arch_Arm" xml:space="preserve">
|
||||
<value>ARM (32ビット)</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Arch_AnyCpu" xml:space="preserve">
|
||||
<value>.NET、任意の CPU(64ビットで実行)</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Arch_AnyCpu32" xml:space="preserve">
|
||||
<value>.NET、任意の CPU、32ビット優先(32ビットで実行)</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Arch_Other" xml:space="preserve">
|
||||
<value>その他のアーキテクチャ</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Arch_Unknown" xml:space="preserve">
|
||||
<value>読み取れませんでした</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Store_Steam_Format" xml:space="preserve">
|
||||
<value>Steam ビルド {0}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Store_Gog_Format" xml:space="preserve">
|
||||
<value>GOG バージョン {0}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Store_Epic_Format" xml:space="preserve">
|
||||
<value>Epic バージョン {0}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Header" xml:space="preserve">
|
||||
<value>詳細</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Architecture" xml:space="preserve">
|
||||
<value>実行形式</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Details_FileVersion" xml:space="preserve">
|
||||
<value>ファイル バージョン</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Details_ProductVersion" xml:space="preserve">
|
||||
<value>製品バージョン</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Store" xml:space="preserve">
|
||||
<value>ストア</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Version" xml:space="preserve">
|
||||
<value>バージョン</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Engine" xml:space="preserve">
|
||||
<value>エンジン</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Libraries" xml:space="preserve">
|
||||
<value>同梱ライブラリ</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Library_Format" xml:space="preserve">
|
||||
<value>{0}: {1} {2}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Details_LibraryNoVersion_Format" xml:space="preserve">
|
||||
<value>{0}: {1}(バージョンなし)</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Details_NoLibraries" xml:space="preserve">
|
||||
<value>ルールが挙げるファイルはありません</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Details_NotRead" xml:space="preserve">
|
||||
<value>まだ読み取っていません。キャプチャ エージェントが起動後まもなくゲームのファイルを読み取ります。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Hooking_NotX64_Format" xml:space="preserve">
|
||||
<value>このゲームの実行ファイルは {0} です。FrameLedger のフックは 64ビット (x64) のゲームでのみ動作するため、フックをオンにすることはできません。セッションにはプレイ時間とセンサーの値が記録されます。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Summary_Libraries_Format" xml:space="preserve">
|
||||
<value>読み込まれたライブラリ: {0}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Summary_Library_Differs_Format" xml:space="preserve">
|
||||
<value>{0} {1}(ゲーム同梱は {2}。ドライバーや NVIDIA App などにより別のコピーが読み込まれました)</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
</root>
|
||||
@@ -201,6 +201,9 @@
|
||||
<data name="Import_Note_Guessed" xml:space="preserve">
|
||||
<value>Guessed — check it</value>
|
||||
</data>
|
||||
<data name="Import_Note_Moved" xml:space="preserve">
|
||||
<value>In the library under another drive letter — that entry follows this file</value>
|
||||
</data>
|
||||
<data name="Import_Selected_Format" xml:space="preserve">
|
||||
<value>{0} of {1} selected</value>
|
||||
</data>
|
||||
@@ -366,6 +369,9 @@
|
||||
<data name="Dashboard_Live_Idle" xml:space="preserve">
|
||||
<value>Nothing is being captured.</value>
|
||||
</data>
|
||||
<data name="Dashboard_Live_RecordingOnly" xml:space="preserve">
|
||||
<value>Recording duration and sensors only — nothing is measured.</value>
|
||||
</data>
|
||||
<data name="Dashboard_Live_Rt_On" xml:space="preserve">
|
||||
<value>RT active</value>
|
||||
</data>
|
||||
@@ -576,6 +582,18 @@
|
||||
<data name="GameDetail_Hooking_Busy" xml:space="preserve">
|
||||
<value>Asking the capture agent…</value>
|
||||
</data>
|
||||
<data name="GameDetail_Recording_Header" xml:space="preserve">
|
||||
<value>Recording</value>
|
||||
</data>
|
||||
<data name="GameDetail_Recording_On" xml:space="preserve">
|
||||
<value>Recorded when it runs</value>
|
||||
</data>
|
||||
<data name="GameDetail_Recording_Off" xml:space="preserve">
|
||||
<value>Ignored — nothing is recorded</value>
|
||||
</data>
|
||||
<data name="GameDetail_Recording_Body" xml:space="preserve">
|
||||
<value>Turn this off for a program that is not a game — a utility that starts with Windows, for example. While it is off, FrameLedger does not watch for the program: no session is recorded, nothing is measured or injected, and a session running now stops. Sessions already recorded stay.</value>
|
||||
</data>
|
||||
<data name="GameDetail_Hooking_Header" xml:space="preserve">
|
||||
<value>Hooking</value>
|
||||
</data>
|
||||
@@ -648,6 +666,9 @@
|
||||
<data name="Games_Add" xml:space="preserve">
|
||||
<value>Add game…</value>
|
||||
</data>
|
||||
<data name="Games_Card_NotRecorded" xml:space="preserve">
|
||||
<value>Not recorded</value>
|
||||
</data>
|
||||
<data name="Games_Card_HookOff" xml:space="preserve">
|
||||
<value>Hooking off</value>
|
||||
</data>
|
||||
@@ -927,6 +948,9 @@
|
||||
<data name="Summary_Tier2_Why_Blocked_Format" xml:space="preserve">
|
||||
<value>Why: hooking is off for this game — the guard found {0}.</value>
|
||||
</data>
|
||||
<data name="Summary_Tier2_Why_ConsentChanged" xml:space="preserve">
|
||||
<value>Why: the game's executable changed since hooking was turned on (an update, usually), so that consent no longer applies — turn hooking on again for it.</value>
|
||||
</data>
|
||||
<data name="Summary_Tier2_Why_Guard_Format" xml:space="preserve">
|
||||
<value>Why: the guard refused — {0} ({1}).</value>
|
||||
</data>
|
||||
@@ -1853,4 +1877,118 @@ Open the log folder?</value>
|
||||
• Nothing is sent anywhere. Your recordings stay on this PC, and backing them up is up to you.
|
||||
The documents below are the full terms; this summary does not replace them.</value>
|
||||
</data>
|
||||
<data name="Blocked_Module_Format" xml:space="preserve">
|
||||
<value>{0} — its module {1} was loaded in the game</value>
|
||||
</data>
|
||||
<data name="Blocked_Directory_Format" xml:space="preserve">
|
||||
<value>{0} — its folder {1} ships with the game</value>
|
||||
</data>
|
||||
<data name="Blocked_File_Format" xml:space="preserve">
|
||||
<value>{0} — {1} ships with the game</value>
|
||||
</data>
|
||||
<data name="Blocked_Executable_Format" xml:space="preserve">
|
||||
<value>{0} — {1} is a listed title</value>
|
||||
</data>
|
||||
<data name="Blocked_StoreId_Format" xml:space="preserve">
|
||||
<value>{0} — the game's store id {1} is listed</value>
|
||||
</data>
|
||||
<data name="Blocked_Other_Format" xml:space="preserve">
|
||||
<value>{0} ({1})</value>
|
||||
</data>
|
||||
<data name="GameDetail_AntiCheat_Header" xml:space="preserve">
|
||||
<value>Anti-cheat</value>
|
||||
</data>
|
||||
<data name="GameDetail_AntiCheat_Format" xml:space="preserve">
|
||||
<value>Found: {0}. Hooking is off for this game and cannot be turned on; its sessions record play time and sensors only.</value>
|
||||
</data>
|
||||
<data name="Games_Card_AntiCheat" xml:space="preserve">
|
||||
<value>Anti-cheat</value>
|
||||
</data>
|
||||
<data name="Settings_HideAntiCheatHooking_Label" xml:space="preserve">
|
||||
<value>Hide hooking on anti-cheat games</value>
|
||||
</data>
|
||||
<data name="Settings_HideAntiCheatHooking_Body" xml:space="preserve">
|
||||
<value>A game in which anti-cheat was found can never be hooked. On, its page shows only what was found; off, it also shows the disabled Hooking switch. Either way it is still recorded without hooking.</value>
|
||||
</data>
|
||||
<data name="Notice_HookingOff_Title_Format" xml:space="preserve">
|
||||
<value>{0}: hooking turned off</value>
|
||||
</data>
|
||||
<data name="Arch_X64" xml:space="preserve">
|
||||
<value>64-bit (x64)</value>
|
||||
</data>
|
||||
<data name="Arch_X86" xml:space="preserve">
|
||||
<value>32-bit (x86)</value>
|
||||
</data>
|
||||
<data name="Arch_Arm64" xml:space="preserve">
|
||||
<value>ARM64</value>
|
||||
</data>
|
||||
<data name="Arch_Arm" xml:space="preserve">
|
||||
<value>ARM (32-bit)</value>
|
||||
</data>
|
||||
<data name="Arch_AnyCpu" xml:space="preserve">
|
||||
<value>.NET, any CPU (runs as 64-bit)</value>
|
||||
</data>
|
||||
<data name="Arch_AnyCpu32" xml:space="preserve">
|
||||
<value>.NET, any CPU, 32-bit preferred (runs as 32-bit)</value>
|
||||
</data>
|
||||
<data name="Arch_Other" xml:space="preserve">
|
||||
<value>another architecture</value>
|
||||
</data>
|
||||
<data name="Arch_Unknown" xml:space="preserve">
|
||||
<value>could not be read</value>
|
||||
</data>
|
||||
<data name="Store_Steam_Format" xml:space="preserve">
|
||||
<value>Steam build {0}</value>
|
||||
</data>
|
||||
<data name="Store_Gog_Format" xml:space="preserve">
|
||||
<value>GOG version {0}</value>
|
||||
</data>
|
||||
<data name="Store_Epic_Format" xml:space="preserve">
|
||||
<value>Epic version {0}</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Header" xml:space="preserve">
|
||||
<value>Details</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Architecture" xml:space="preserve">
|
||||
<value>Runs as</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_FileVersion" xml:space="preserve">
|
||||
<value>File version</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_ProductVersion" xml:space="preserve">
|
||||
<value>Product version</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Store" xml:space="preserve">
|
||||
<value>Store</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Version" xml:space="preserve">
|
||||
<value>Version</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Engine" xml:space="preserve">
|
||||
<value>Engine</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Libraries" xml:space="preserve">
|
||||
<value>Ships with</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Library_Format" xml:space="preserve">
|
||||
<value>{0}: {1} {2}</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_LibraryNoVersion_Format" xml:space="preserve">
|
||||
<value>{0}: {1} (no version)</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_NoLibraries" xml:space="preserve">
|
||||
<value>none of the files the rules name</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_NotRead" xml:space="preserve">
|
||||
<value>Not read yet: the capture agent reads the game's files shortly after it starts.</value>
|
||||
</data>
|
||||
<data name="Hooking_NotX64_Format" xml:space="preserve">
|
||||
<value>This game's executable is {0}. FrameLedger's hook runs in 64-bit (x64) games only, so hooking cannot be turned on; its sessions record play time and sensors.</value>
|
||||
</data>
|
||||
<data name="Summary_Libraries_Format" xml:space="preserve">
|
||||
<value>Loaded: {0}</value>
|
||||
</data>
|
||||
<data name="Summary_Library_Differs_Format" xml:space="preserve">
|
||||
<value>{0} {1} (the game ships {2}: another copy was loaded, for example by the driver or the NVIDIA App)</value>
|
||||
</data>
|
||||
</root>
|
||||
@@ -196,6 +196,9 @@
|
||||
<data name="Import_Note_Guessed" xml:space="preserve">
|
||||
<value>Đoán — hãy kiểm tra</value>
|
||||
</data>
|
||||
<data name="Import_Note_Moved" xml:space="preserve">
|
||||
<value>Đã có trong thư viện dưới ký tự ổ đĩa khác — mục đó sẽ đi theo tệp này</value>
|
||||
</data>
|
||||
<data name="Import_Selected_Format" xml:space="preserve">
|
||||
<value>Đã chọn {0}/{1}</value>
|
||||
</data>
|
||||
@@ -361,6 +364,9 @@
|
||||
<data name="Dashboard_Live_Idle" xml:space="preserve">
|
||||
<value>Không có gì đang được thu thập.</value>
|
||||
</data>
|
||||
<data name="Dashboard_Live_RecordingOnly" xml:space="preserve">
|
||||
<value>Chỉ ghi thời lượng và cảm biến — không đo gì.</value>
|
||||
</data>
|
||||
<data name="Dashboard_Live_Rt_On" xml:space="preserve">
|
||||
<value>RT đang bật</value>
|
||||
</data>
|
||||
@@ -571,6 +577,18 @@
|
||||
<data name="GameDetail_Hooking_Busy" xml:space="preserve">
|
||||
<value>Đang hỏi capture agent…</value>
|
||||
</data>
|
||||
<data name="GameDetail_Recording_Header" xml:space="preserve">
|
||||
<value>Ghi phiên</value>
|
||||
</data>
|
||||
<data name="GameDetail_Recording_On" xml:space="preserve">
|
||||
<value>Ghi phiên mỗi khi chạy</value>
|
||||
</data>
|
||||
<data name="GameDetail_Recording_Off" xml:space="preserve">
|
||||
<value>Bỏ qua — không ghi gì</value>
|
||||
</data>
|
||||
<data name="GameDetail_Recording_Body" xml:space="preserve">
|
||||
<value>Tắt mục này cho chương trình không phải game — ví dụ một tiện ích khởi động cùng Windows. Khi tắt, FrameLedger không theo dõi chương trình đó: không ghi phiên, không đo, không inject, và phiên đang chạy sẽ dừng. Các phiên đã ghi vẫn được giữ.</value>
|
||||
</data>
|
||||
<data name="GameDetail_Hooking_Header" xml:space="preserve">
|
||||
<value>Hooking</value>
|
||||
</data>
|
||||
@@ -643,6 +661,9 @@
|
||||
<data name="Games_Add" xml:space="preserve">
|
||||
<value>Thêm game…</value>
|
||||
</data>
|
||||
<data name="Games_Card_NotRecorded" xml:space="preserve">
|
||||
<value>Không ghi</value>
|
||||
</data>
|
||||
<data name="Games_Card_HookOff" xml:space="preserve">
|
||||
<value>Hooking tắt</value>
|
||||
</data>
|
||||
@@ -922,6 +943,9 @@
|
||||
<data name="Summary_Tier2_Why_Blocked_Format" xml:space="preserve">
|
||||
<value>Lý do: hooking đang tắt cho game này — guard đã phát hiện {0}.</value>
|
||||
</data>
|
||||
<data name="Summary_Tier2_Why_ConsentChanged" xml:space="preserve">
|
||||
<value>Lý do: file thực thi của game đã đổi kể từ khi bật hooking (thường là do cập nhật), nên sự đồng ý đó không còn áp dụng — hãy bật lại hooking cho game.</value>
|
||||
</data>
|
||||
<data name="Summary_Tier2_Why_Guard_Format" xml:space="preserve">
|
||||
<value>Lý do: guard đã từ chối — {0} ({1}).</value>
|
||||
</data>
|
||||
@@ -1848,4 +1872,118 @@ Mở thư mục log?</value>
|
||||
• Không có gì được gửi đi đâu cả. Dữ liệu ghi lại nằm trên máy này, và việc sao lưu là của bạn.
|
||||
Các tài liệu bên dưới là điều khoản đầy đủ; phần tóm tắt này không thay thế chúng.</value>
|
||||
</data>
|
||||
<data name="Blocked_Module_Format" xml:space="preserve">
|
||||
<value>{0} — mô-đun {1} của nó đã được nạp trong game</value>
|
||||
</data>
|
||||
<data name="Blocked_Directory_Format" xml:space="preserve">
|
||||
<value>{0} — thư mục {1} của nó đi kèm game</value>
|
||||
</data>
|
||||
<data name="Blocked_File_Format" xml:space="preserve">
|
||||
<value>{0} — {1} đi kèm game</value>
|
||||
</data>
|
||||
<data name="Blocked_Executable_Format" xml:space="preserve">
|
||||
<value>{0} — {1} nằm trong danh sách tựa game</value>
|
||||
</data>
|
||||
<data name="Blocked_StoreId_Format" xml:space="preserve">
|
||||
<value>{0} — mã store {1} của game nằm trong danh sách</value>
|
||||
</data>
|
||||
<data name="Blocked_Other_Format" xml:space="preserve">
|
||||
<value>{0} ({1})</value>
|
||||
</data>
|
||||
<data name="GameDetail_AntiCheat_Header" xml:space="preserve">
|
||||
<value>Anti-cheat</value>
|
||||
</data>
|
||||
<data name="GameDetail_AntiCheat_Format" xml:space="preserve">
|
||||
<value>Đã phát hiện: {0}. Hooking đã tắt cho game này và không thể bật; các phiên của nó chỉ ghi thời gian chơi và cảm biến.</value>
|
||||
</data>
|
||||
<data name="Games_Card_AntiCheat" xml:space="preserve">
|
||||
<value>Anti-cheat</value>
|
||||
</data>
|
||||
<data name="Settings_HideAntiCheatHooking_Label" xml:space="preserve">
|
||||
<value>Ẩn phần hooking ở game có anti-cheat</value>
|
||||
</data>
|
||||
<data name="Settings_HideAntiCheatHooking_Body" xml:space="preserve">
|
||||
<value>Game được phát hiện có anti-cheat sẽ không bao giờ được hook. Bật: trang game chỉ hiện điều đã phát hiện; tắt: hiện thêm công tắc Hooking bị vô hiệu hoá. Dù bật hay tắt, game vẫn được ghi mà không hook.</value>
|
||||
</data>
|
||||
<data name="Notice_HookingOff_Title_Format" xml:space="preserve">
|
||||
<value>{0}: đã tắt hooking</value>
|
||||
</data>
|
||||
<data name="Arch_X64" xml:space="preserve">
|
||||
<value>64-bit (x64)</value>
|
||||
</data>
|
||||
<data name="Arch_X86" xml:space="preserve">
|
||||
<value>32-bit (x86)</value>
|
||||
</data>
|
||||
<data name="Arch_Arm64" xml:space="preserve">
|
||||
<value>ARM64</value>
|
||||
</data>
|
||||
<data name="Arch_Arm" xml:space="preserve">
|
||||
<value>ARM (32-bit)</value>
|
||||
</data>
|
||||
<data name="Arch_AnyCpu" xml:space="preserve">
|
||||
<value>.NET, mọi CPU (chạy ở 64-bit)</value>
|
||||
</data>
|
||||
<data name="Arch_AnyCpu32" xml:space="preserve">
|
||||
<value>.NET, mọi CPU, ưu tiên 32-bit (chạy ở 32-bit)</value>
|
||||
</data>
|
||||
<data name="Arch_Other" xml:space="preserve">
|
||||
<value>kiến trúc khác</value>
|
||||
</data>
|
||||
<data name="Arch_Unknown" xml:space="preserve">
|
||||
<value>không đọc được</value>
|
||||
</data>
|
||||
<data name="Store_Steam_Format" xml:space="preserve">
|
||||
<value>Steam build {0}</value>
|
||||
</data>
|
||||
<data name="Store_Gog_Format" xml:space="preserve">
|
||||
<value>GOG phiên bản {0}</value>
|
||||
</data>
|
||||
<data name="Store_Epic_Format" xml:space="preserve">
|
||||
<value>Epic phiên bản {0}</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Header" xml:space="preserve">
|
||||
<value>Chi tiết</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Architecture" xml:space="preserve">
|
||||
<value>Chạy ở dạng</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_FileVersion" xml:space="preserve">
|
||||
<value>Phiên bản file</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_ProductVersion" xml:space="preserve">
|
||||
<value>Phiên bản sản phẩm</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Store" xml:space="preserve">
|
||||
<value>Cửa hàng</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Version" xml:space="preserve">
|
||||
<value>Phiên bản</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Engine" xml:space="preserve">
|
||||
<value>Engine</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Libraries" xml:space="preserve">
|
||||
<value>Đi kèm</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Library_Format" xml:space="preserve">
|
||||
<value>{0}: {1} {2}</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_LibraryNoVersion_Format" xml:space="preserve">
|
||||
<value>{0}: {1} (không có phiên bản)</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_NoLibraries" xml:space="preserve">
|
||||
<value>không có file nào mà bộ luật nêu tên</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_NotRead" xml:space="preserve">
|
||||
<value>Chưa đọc: capture agent sẽ đọc các file của game ngay sau khi nó khởi động.</value>
|
||||
</data>
|
||||
<data name="Hooking_NotX64_Format" xml:space="preserve">
|
||||
<value>File thực thi của game này là {0}. Hook của FrameLedger chỉ chạy trong game 64-bit (x64), nên không thể bật hooking; các phiên của nó ghi thời gian chơi và cảm biến.</value>
|
||||
</data>
|
||||
<data name="Summary_Libraries_Format" xml:space="preserve">
|
||||
<value>Đã nạp: {0}</value>
|
||||
</data>
|
||||
<data name="Summary_Library_Differs_Format" xml:space="preserve">
|
||||
<value>{0} {1} (game kèm bản {2}: một bản khác đã được nạp, ví dụ bởi driver hoặc NVIDIA App)</value>
|
||||
</data>
|
||||
</root>
|
||||
@@ -62,6 +62,8 @@
|
||||
until 2026-09-16, whose background is WPF UI's PaletteLightBlueBrush — a fixed Material colour outside the
|
||||
theme dictionaries, white-on-#03A9F4 in dark, 2.6:1 — which is the one way to break contrast that
|
||||
AccessibilityTests.NoXamlHardCodesAColour cannot see (08_UI §Contrast). ContrastTests holds both pairs now.
|
||||
A third state since 2026-09-25 (beta.8): "Anti-cheat", a guard finding on the row, on the caution fill with
|
||||
primary text — the warning qualifier's pair, which ContrastTests already measures in both themes.
|
||||
-->
|
||||
<Style x:Key="HookStatePill" TargetType="Border" BasedOn="{StaticResource Pill}">
|
||||
<Setter Property="Margin" Value="0" />
|
||||
@@ -70,6 +72,9 @@
|
||||
<Setter Property="Background" Value="{DynamicResource AccentFillColorDefaultBrush}" />
|
||||
<Setter Property="BorderThickness" Value="0" />
|
||||
</DataTrigger>
|
||||
<DataTrigger Binding="{Binding AntiCheat}" Value="True">
|
||||
<Setter Property="Background" Value="{DynamicResource SystemFillColorCautionBackgroundBrush}" />
|
||||
</DataTrigger>
|
||||
</Style.Triggers>
|
||||
</Style>
|
||||
|
||||
@@ -79,6 +84,9 @@
|
||||
<DataTrigger Binding="{Binding HookOn}" Value="True">
|
||||
<Setter Property="Foreground" Value="{DynamicResource TextOnAccentFillColorPrimaryBrush}" />
|
||||
</DataTrigger>
|
||||
<DataTrigger Binding="{Binding AntiCheat}" Value="True">
|
||||
<Setter Property="Foreground" Value="{DynamicResource TextFillColorPrimaryBrush}" />
|
||||
</DataTrigger>
|
||||
</Style.Triggers>
|
||||
</Style>
|
||||
|
||||
|
||||
@@ -19,9 +19,6 @@ namespace FrameLedger.App.Update;
|
||||
/// </summary>
|
||||
public sealed partial class UpdateService : ObservableObject, IDisposable
|
||||
{
|
||||
/// <summary><c>StatusAck.State</c> when no session runs.</summary>
|
||||
private const string _idleState = "idle";
|
||||
|
||||
private static readonly TimeSpan _defaultAgentStopTimeout = TimeSpan.FromSeconds(10);
|
||||
|
||||
private readonly TimeSpan _agentStopTimeout;
|
||||
@@ -64,20 +61,13 @@ public sealed partial class UpdateService : ObservableObject, IDisposable
|
||||
/// <summary>Raised once per release found, for the tray's toast; the banner follows <see cref="Stage"/>.</summary>
|
||||
public event EventHandler<UpdateAvailableEventArgs>? Available;
|
||||
|
||||
/// <summary>A session runs (hooked or recording): the Agent said so at connect, or a <c>SessionStarted</c> arrived without its <c>SessionCompleted</c>.</summary>
|
||||
public bool IsSessionActive
|
||||
{
|
||||
get
|
||||
{
|
||||
if (_running.Count > 0)
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
StatusAck? status = _agent.Status;
|
||||
return status is not null && (!string.Equals(status.State, _idleState, StringComparison.Ordinal) || status.ActiveSessions.Count > 0);
|
||||
}
|
||||
}
|
||||
/// <summary>
|
||||
/// A session runs (hooked or recording): one the Agent listed when this App (re)connected, or a <c>SessionStarted</c>
|
||||
/// since, without its <c>SessionCompleted</c>. Until 2026-09-23 it also OR-ed the status read at connect, which is
|
||||
/// never read again — so a session running when the App connected held every update at Deferred until the next
|
||||
/// reconnect, hours after it ended. The connect-time list now seeds the set and the completions empty it.
|
||||
/// </summary>
|
||||
public bool IsSessionActive => _running.Count > 0;
|
||||
|
||||
public void Dispose()
|
||||
{
|
||||
@@ -311,6 +301,14 @@ public sealed partial class UpdateService : ObservableObject, IDisposable
|
||||
private void OnAgentChanged(object? sender, EventArgs e) => Post(() =>
|
||||
{
|
||||
_running.Clear();
|
||||
if (_agent.State == AgentConnectionState.Connected && _agent.Status is { } status)
|
||||
{
|
||||
foreach (ActiveSession a in status.ActiveSessions)
|
||||
{
|
||||
_running.Add(a.SessionGuid);
|
||||
}
|
||||
}
|
||||
|
||||
Settle();
|
||||
});
|
||||
|
||||
|
||||
@@ -54,10 +54,13 @@ public sealed partial class DashboardViewModel : ObservableObject, IDisposable
|
||||
private bool _recentEmpty = true;
|
||||
|
||||
private readonly IShellPresence? _presence;
|
||||
private readonly LiveSessions? _sessions;
|
||||
|
||||
public DashboardViewModel(IAgentLink agent, GameLibrary library, GameSelection selection, IPageNavigator navigator, ISessionSummaryOpener summaries, IMessageStrip strip, IShellPresence? presence = null)
|
||||
public DashboardViewModel(IAgentLink agent, GameLibrary library, GameSelection selection, IPageNavigator navigator, ISessionSummaryOpener summaries, IMessageStrip strip, IShellPresence? presence = null,
|
||||
LiveSessions? sessions = null)
|
||||
{
|
||||
_presence = presence;
|
||||
_sessions = sessions;
|
||||
_agent = agent ?? throw new ArgumentNullException(nameof(agent));
|
||||
_library = library ?? throw new ArgumentNullException(nameof(library));
|
||||
_selection = selection ?? throw new ArgumentNullException(nameof(selection));
|
||||
@@ -66,7 +69,13 @@ public sealed partial class DashboardViewModel : ObservableObject, IDisposable
|
||||
_strip = strip ?? throw new ArgumentNullException(nameof(strip));
|
||||
_agent.Changed += OnAgentChanged;
|
||||
_agent.EventReceived += OnAgentEvent;
|
||||
if (_sessions is not null)
|
||||
{
|
||||
_sessions.Changed += OnSessionsChanged;
|
||||
}
|
||||
|
||||
Refresh();
|
||||
SeedLive();
|
||||
Pending = LoadAsync();
|
||||
}
|
||||
|
||||
@@ -95,6 +104,10 @@ public sealed partial class DashboardViewModel : ObservableObject, IDisposable
|
||||
{
|
||||
_agent.Changed -= OnAgentChanged;
|
||||
_agent.EventReceived -= OnAgentEvent;
|
||||
if (_sessions is not null)
|
||||
{
|
||||
_sessions.Changed -= OnSessionsChanged;
|
||||
}
|
||||
}
|
||||
|
||||
public async Task LoadAsync(CancellationToken ct = default)
|
||||
@@ -139,6 +152,27 @@ public sealed partial class DashboardViewModel : ObservableObject, IDisposable
|
||||
|
||||
private void OnAgentEvent(object? sender, AgentEventArgs e) => _ui.Post(() => Dispatch(e.Envelope));
|
||||
|
||||
private void OnSessionsChanged(object? sender, EventArgs e) => _ui.Post(() =>
|
||||
{
|
||||
SeedLive();
|
||||
Refresh();
|
||||
});
|
||||
|
||||
/// <summary>
|
||||
/// A session already running takes the idle card (2026-09-23): the Dashboard is rebuilt on every visit, so one that
|
||||
/// started while another page was open had no start event here and read "Nothing is being captured.". A hooked
|
||||
/// session is preferred over one recorded without measuring.
|
||||
/// </summary>
|
||||
private void SeedLive()
|
||||
{
|
||||
if (Live.IsActive || _sessions?.Current is not { Count: > 0 } running)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
Live.Seed(running.FirstOrDefault(static s => s.Tier == 1) ?? running[0]);
|
||||
}
|
||||
|
||||
/// <summary>The three session events drive the live card; a completed session reloads the lists (07_IPC §Client behavior: the row is in SQLite).</summary>
|
||||
private void Dispatch(IpcEnvelope envelope)
|
||||
{
|
||||
@@ -150,9 +184,15 @@ public sealed partial class DashboardViewModel : ObservableObject, IDisposable
|
||||
case IpcMessageType.SessionProgress when IpcCodec.Payload<SessionProgressEvent>(envelope) is { } progress:
|
||||
Live.Update(progress);
|
||||
break;
|
||||
case IpcMessageType.SessionHeld when IpcCodec.Payload<SessionHeldEvent>(envelope) is { } held:
|
||||
Live.Hold(held);
|
||||
break;
|
||||
case IpcMessageType.SessionCompleted when IpcCodec.Payload<SessionCompletedEvent>(envelope) is { } completed:
|
||||
// The session's own name (2026-09-23): the card may show another session, and a Tier-2 one had none here.
|
||||
string? name = completed.GameName ?? (Live.SessionGuid == completed.SessionGuid ? Live.GameName : null);
|
||||
Live.Stop(completed);
|
||||
Notice(completed);
|
||||
Notice(completed, name);
|
||||
SeedLive();
|
||||
Pending = LoadAsync();
|
||||
break;
|
||||
default:
|
||||
@@ -162,14 +202,15 @@ public sealed partial class DashboardViewModel : ObservableObject, IDisposable
|
||||
|
||||
/// <summary>FR-3.8's post-session notice, in-app while the window is on screen; the tray's balloon carries it otherwise (P3 PR-8b, one event → one channel). A safety stop is never a toast (08_UI §Notifications policy) — the shell's notices carry those.</summary>
|
||||
[System.Diagnostics.CodeAnalysis.SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format string is a resource that follows the UI culture, which changes at runtime")]
|
||||
private void Notice(SessionCompletedEvent completed)
|
||||
private void Notice(SessionCompletedEvent completed, string? name)
|
||||
{
|
||||
if (_presence is { IsShown: false })
|
||||
// A faulted session is the strip's CaptureError already; "discarded" would say something that did not happen.
|
||||
if (_presence is { IsShown: false } || string.Equals(completed.Finalize, "faulted", StringComparison.Ordinal))
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
string game = Live.GameName.Length > 0 ? Live.GameName : Strings.Common_NotAvailable;
|
||||
string game = name is { Length: > 0 } ? name : Strings.Common_NotAvailable;
|
||||
if (completed.SessionId is not null)
|
||||
{
|
||||
_strip.Success(Strings.Dashboard_Live_Header, string.Format(CultureInfo.CurrentCulture, Strings.Dashboard_SessionSaved_Format, game));
|
||||
@@ -189,6 +230,8 @@ public sealed partial class DashboardViewModel : ObservableObject, IDisposable
|
||||
TelemetrySource = hello?.TelemetrySource ?? Strings.Common_NotAvailable;
|
||||
OverlayBuildId = hello?.OverlayBuildId ?? Strings.Common_NotAvailable;
|
||||
Elevated = hello is null ? Strings.Common_NotAvailable : hello.Elevated ? Strings.Common_Yes : Strings.Common_No;
|
||||
RunningSessions = status?.ActiveSessions.Count.ToString(CultureInfo.CurrentCulture) ?? Strings.Common_NotAvailable;
|
||||
RunningSessions = _sessions is not null && _agent.State == AgentConnectionState.Connected
|
||||
? _sessions.Current.Count.ToString(CultureInfo.CurrentCulture)
|
||||
: status?.ActiveSessions.Count.ToString(CultureInfo.CurrentCulture) ?? Strings.Common_NotAvailable;
|
||||
}
|
||||
}
|
||||
@@ -72,6 +72,9 @@ public sealed partial class EditGameViewModel : ObservableObject
|
||||
|
||||
private static string? Blank(string value) => string.IsNullOrWhiteSpace(value) ? null : value.Trim();
|
||||
|
||||
/// <summary>Whether <paramref name="field"/> of <c>field_provenance</c> is badged <c>detected</c> (a store or the detection sweep wrote it).</summary>
|
||||
internal static bool IsDetectedField(string? provenanceJson, string field) => IsDetected(ParseProvenance(provenanceJson), field);
|
||||
|
||||
private static bool IsDetected(Dictionary<string, string> provenance, string field) =>
|
||||
provenance.TryGetValue(field, out string? p) && string.Equals(p, "detected", StringComparison.Ordinal);
|
||||
|
||||
|
||||
@@ -4,7 +4,11 @@ using FrameLedger.App.Services;
|
||||
|
||||
namespace FrameLedger.App.ViewModels;
|
||||
|
||||
/// <summary>One library card (<c>08_UI</c> §Games): name, platform and engine badges, playtime, last played, hooking state. The sparkline is PR-6's.</summary>
|
||||
/// <summary>
|
||||
/// One library card (<c>08_UI</c> §Games): name, platform and engine badges, playtime, last played, hooking state — or, since
|
||||
/// 2026-09-23, "Not recorded" in its place for an entry whose recording is off, and since 2026-09-25 "Anti-cheat" for one
|
||||
/// the guard found anti-cheat in. The sparkline is PR-6's.
|
||||
/// </summary>
|
||||
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
|
||||
public sealed class GameCardViewModel
|
||||
{
|
||||
@@ -15,9 +19,15 @@ public sealed class GameCardViewModel
|
||||
Id = card.Row.Id;
|
||||
Name = card.Row.Name;
|
||||
PlatformText = Formats.Platform(card.Row.Platform);
|
||||
EngineText = card.Row.Engine ?? string.Empty;
|
||||
HookOn = card.Row.HookEnabled;
|
||||
HookText = HookOn ? Strings.Games_Card_HookOn : Strings.Games_Card_HookOff;
|
||||
EngineText = Formats.Engine(card.Row.Engine);
|
||||
Recorded = card.Row.RecordSessions;
|
||||
HookOn = Recorded && card.Row.HookEnabled;
|
||||
// An entry the guard found anti-cheat in says so (beta.8): its hooking is off for good, and "Hooking off" read as
|
||||
// a switch the user could still flip. Not recorded still comes first — nothing runs for it at all.
|
||||
AntiCheat = Recorded && card.Row.BlockedByGuard;
|
||||
HookText = !Recorded ? Strings.Games_Card_NotRecorded
|
||||
: AntiCheat ? Strings.Games_Card_AntiCheat
|
||||
: HookOn ? Strings.Games_Card_HookOn : Strings.Games_Card_HookOff;
|
||||
SessionCount = card.Summary?.SessionCount ?? 0;
|
||||
TotalSeconds = card.Summary?.TotalSeconds ?? 0;
|
||||
LastPlayedAt = card.Summary?.LastPlayedAt;
|
||||
@@ -42,8 +52,17 @@ public sealed class GameCardViewModel
|
||||
|
||||
public bool HasEngine => EngineText.Length > 0;
|
||||
|
||||
/// <summary>Whether FrameLedger watches for this entry's program (schema 0009).</summary>
|
||||
public bool Recorded { get; }
|
||||
|
||||
public bool HookOn { get; }
|
||||
|
||||
/// <summary>
|
||||
/// The pill says "Anti-cheat" (caution fill, <c>Styles/FrameLedger.xaml</c>): a guard finding about this game is on its row
|
||||
/// (<c>19_SAFETY</c> §What a finding does to the game) and the entry is recorded — "Not recorded" says more.
|
||||
/// </summary>
|
||||
public bool AntiCheat { get; }
|
||||
|
||||
public string HookText { get; }
|
||||
|
||||
public long SessionCount { get; }
|
||||
|
||||
@@ -0,0 +1,4 @@
|
||||
namespace FrameLedger.App.ViewModels;
|
||||
|
||||
/// <summary>One line of the game page's Details card (beta.8): a label and what the game's files — or its store — say.</summary>
|
||||
public sealed record GameDetailRow(string Label, string Value);
|
||||
@@ -9,7 +9,9 @@ using FrameLedger.App.Charts;
|
||||
using FrameLedger.App.Pages;
|
||||
using FrameLedger.App.Services;
|
||||
using FrameLedger.Application.Persistence;
|
||||
using FrameLedger.Application.Settings;
|
||||
using FrameLedger.Application.TriState;
|
||||
using FrameLedger.Domain.Detection;
|
||||
using FrameLedger.Domain.Sessions;
|
||||
using FrameLedger.Infrastructure.Io;
|
||||
using Wpf.Ui.Controls;
|
||||
@@ -35,7 +37,11 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
private readonly SessionSeriesLoader _loader;
|
||||
private readonly IHardwareSnapshotRepository _hardware;
|
||||
private readonly SessionSelection _selection;
|
||||
private readonly RegisteredSettings? _settings;
|
||||
private readonly long? _gameId;
|
||||
|
||||
// ui.hide_anticheat_hooking (2026-09-25), read at each load; on until the settings say otherwise, as its default is.
|
||||
private bool _hideAntiCheatHooking = true;
|
||||
private GameDetail? _detail;
|
||||
|
||||
[ObservableProperty]
|
||||
@@ -67,6 +73,13 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
[ObservableProperty]
|
||||
private string _measuredEmptyText = string.Empty;
|
||||
|
||||
/// <summary>The entry's recording switch (schema 0009, 2026-09-23): off, FrameLedger does not watch for the program.</summary>
|
||||
[ObservableProperty]
|
||||
private bool _recordSessions = true;
|
||||
|
||||
[ObservableProperty]
|
||||
private string _recordingStatusText = string.Empty;
|
||||
|
||||
[ObservableProperty]
|
||||
private bool _hookEnabled;
|
||||
|
||||
@@ -79,6 +92,24 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
[ObservableProperty]
|
||||
private string? _blockedText;
|
||||
|
||||
/// <summary>
|
||||
/// The compact finding shown IN PLACE of the Hooking card when anti-cheat was found and the user keeps such cards hidden
|
||||
/// (beta.8); null otherwise. The finding itself is always on the page (FR-2.2) — here, or as the card's blocked text.
|
||||
/// </summary>
|
||||
[ObservableProperty]
|
||||
private string? _antiCheatText;
|
||||
|
||||
/// <summary>Whether the Hooking card and its lines show: false only for an anti-cheat game while they are hidden.</summary>
|
||||
[ObservableProperty]
|
||||
private bool _hookingSectionVisible = true;
|
||||
|
||||
/// <summary>
|
||||
/// Why the switch cannot be turned on when the executable cannot run as x64 (beta.8, <c>exe_machine</c>); null otherwise.
|
||||
/// A switch that is on for such a game can still be turned off.
|
||||
/// </summary>
|
||||
[ObservableProperty]
|
||||
private string? _notX64Text;
|
||||
|
||||
[ObservableProperty]
|
||||
private string? _autoDisabledText;
|
||||
|
||||
@@ -129,8 +160,10 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
|
||||
public GameDetailViewModel(GameLibrary library, GameSelection selection, HookingConsent consent, IPageNavigator navigator,
|
||||
IConfirmations confirmations, IEditGamePrompt edit, IMessageStrip strip, ISessionSummaryOpener summaries,
|
||||
SessionSeriesLoader loader, IHardwareSnapshotRepository hardware, SessionSelection sessionSelection, IGamePicker picker)
|
||||
SessionSeriesLoader loader, IHardwareSnapshotRepository hardware, SessionSelection sessionSelection, IGamePicker picker,
|
||||
RegisteredSettings? settings = null)
|
||||
{
|
||||
_settings = settings;
|
||||
_picker = picker ?? throw new ArgumentNullException(nameof(picker));
|
||||
_selection = sessionSelection ?? throw new ArgumentNullException(nameof(sessionSelection));
|
||||
_library = library ?? throw new ArgumentNullException(nameof(library));
|
||||
@@ -165,8 +198,19 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
|
||||
public static string MeasuredHeader => Strings.GameDetail_Measured_Header;
|
||||
|
||||
public static string RecordingHeader => Strings.GameDetail_Recording_Header;
|
||||
|
||||
public static string RecordingBody => Strings.GameDetail_Recording_Body;
|
||||
|
||||
public static string HookingHeader => Strings.GameDetail_Hooking_Header;
|
||||
|
||||
public static string AntiCheatHeader => Strings.GameDetail_AntiCheat_Header;
|
||||
|
||||
public static string DetailsHeader => Strings.GameDetail_Details_Header;
|
||||
|
||||
/// <summary>What the game's files and its store say about it (beta.8): what it runs as, its versions, what it ships.</summary>
|
||||
public ObservableCollection<GameDetailRow> Details { get; } = [];
|
||||
|
||||
public static string HookingBody => Strings.GameDetail_Hooking_Body;
|
||||
|
||||
public static string ReEnableText => Strings.GameDetail_Hooking_ReEnable;
|
||||
@@ -262,6 +306,11 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
Game = detail.Row;
|
||||
_detail = detail;
|
||||
NotFound = false;
|
||||
if (_settings is not null)
|
||||
{
|
||||
_hideAntiCheatHooking = await _settings.GetBooleanAsync(SettingsRegistry.UiHideAntiCheatHooking, ct).ConfigureAwait(true);
|
||||
}
|
||||
|
||||
Present(detail);
|
||||
await RebuildTrendAsync(ct).ConfigureAwait(true);
|
||||
}
|
||||
@@ -352,6 +401,9 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
[RelayCommand]
|
||||
private Task ToggleHookingAsync() => RunAsync(HookEnabled ? DisableAsync : EnableAsync);
|
||||
|
||||
[RelayCommand]
|
||||
private Task ToggleRecordingAsync() => RunAsync(ToggleRecordingCoreAsync);
|
||||
|
||||
[RelayCommand]
|
||||
private Task ReEnableHookingAsync() => RunAsync(EnableAsync);
|
||||
|
||||
@@ -414,6 +466,21 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
await LoadAsync().ConfigureAwait(true);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Flips the entry's recording switch (2026-09-23). No confirmation: it deletes nothing — sessions already recorded stay,
|
||||
/// and turning it back on is the same click.
|
||||
/// </summary>
|
||||
private async Task ToggleRecordingCoreAsync()
|
||||
{
|
||||
if (Game is null)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
await _library.SetRecordingAsync(Game.Id, !Game.RecordSessions).ConfigureAwait(true);
|
||||
await LoadAsync().ConfigureAwait(true);
|
||||
}
|
||||
|
||||
private async Task EditCoreAsync()
|
||||
{
|
||||
if (Game is null)
|
||||
@@ -516,7 +583,12 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
{
|
||||
GameRow row = detail.Row;
|
||||
Name = row.Name;
|
||||
Subtitle = string.Join(" · ", new[] { row.Publisher, row.GameVersion, Formats.Platform(row.Platform), EngineText(row) }.Where(static s => !string.IsNullOrWhiteSpace(s)));
|
||||
// A store's version is said as one ("Steam build 20374416", beta.8), and then names the store itself.
|
||||
bool storeVersion = EditGameViewModel.IsDetectedField(row.FieldProvenanceJson, "game_version") && row.Platform is "steam" or "gog" or "epic";
|
||||
string?[] subtitle = storeVersion
|
||||
? [row.Publisher, Formats.StoreVersion(row.Platform, row.GameVersion, detected: true) ?? Formats.Platform(row.Platform), EngineText(row)]
|
||||
: [row.Publisher, row.GameVersion, Formats.Platform(row.Platform), EngineText(row)];
|
||||
Subtitle = string.Join(" · ", subtitle.Where(static s => !string.IsNullOrWhiteSpace(s)));
|
||||
ExecutableText = row.Fingerprint.ExePath;
|
||||
ExecutableMissing = !GameLibrary.ExecutableExists(row.Fingerprint.ExePath);
|
||||
|
||||
@@ -527,11 +599,19 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
|
||||
PresentChips(detail, lastHooked);
|
||||
PresentSupports(row);
|
||||
PresentDetails(row);
|
||||
PresentMeasured(last, lastHooked);
|
||||
PresentRecording(row);
|
||||
PresentHooking(row);
|
||||
PresentSessions(detail);
|
||||
}
|
||||
|
||||
private void PresentRecording(GameRow row)
|
||||
{
|
||||
RecordSessions = row.RecordSessions;
|
||||
RecordingStatusText = row.RecordSessions ? Strings.GameDetail_Recording_On : Strings.GameDetail_Recording_Off;
|
||||
}
|
||||
|
||||
private void PresentChips(GameDetail detail, SessionRow? lastHooked)
|
||||
{
|
||||
Chips.Clear();
|
||||
@@ -555,6 +635,49 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
SupportsEmpty = Supports.Count == 0;
|
||||
}
|
||||
|
||||
private void PresentDetails(GameRow row)
|
||||
{
|
||||
Details.Clear();
|
||||
if (row.ExeMachine is null)
|
||||
{
|
||||
// Written by the Agent's detection sweep: a row it has not read under this build yet.
|
||||
Details.Add(new GameDetailRow(Strings.GameDetail_Details_Architecture, Strings.GameDetail_Details_NotRead));
|
||||
}
|
||||
else
|
||||
{
|
||||
Details.Add(new GameDetailRow(Strings.GameDetail_Details_Architecture, Formats.Architecture(row.ExeMachine)));
|
||||
AddDetail(Strings.GameDetail_Details_FileVersion, row.ExeFileVersion);
|
||||
AddDetail(Strings.GameDetail_Details_ProductVersion, row.ExeProductVersion);
|
||||
}
|
||||
|
||||
bool detected = EditGameViewModel.IsDetectedField(row.FieldProvenanceJson, "game_version");
|
||||
AddDetail(detected ? Strings.GameDetail_Details_Store : Strings.GameDetail_Details_Version, Formats.StoreVersion(row.Platform, row.GameVersion, detected));
|
||||
AddDetail(Strings.GameDetail_Details_Engine, EngineText(row));
|
||||
if (row.ExeMachine is not null)
|
||||
{
|
||||
Details.Add(new GameDetailRow(Strings.GameDetail_Details_Libraries, row.Libraries.Count == 0
|
||||
? Strings.GameDetail_Details_NoLibraries
|
||||
: string.Join(Environment.NewLine, row.Libraries.Select(LibraryText))));
|
||||
}
|
||||
}
|
||||
|
||||
private void AddDetail(string label, string? value)
|
||||
{
|
||||
if (!string.IsNullOrWhiteSpace(value))
|
||||
{
|
||||
Details.Add(new GameDetailRow(label, value));
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>"DLSS: nvngx_dlss.dll 3.7.10.0" — the product the rule names, the file, and what the file says it is.</summary>
|
||||
private static string LibraryText(LibraryFile library)
|
||||
{
|
||||
string product = CapabilityName(library.CapabilityId) is { Length: > 0 } name ? name : library.CapabilityId;
|
||||
return library.FileVersion is { } version
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.GameDetail_Details_Library_Format, product, library.FileName, version)
|
||||
: string.Format(CultureInfo.CurrentCulture, Strings.GameDetail_Details_LibraryNoVersion_Format, product, library.FileName);
|
||||
}
|
||||
|
||||
private void PresentMeasured(SessionRow? last, SessionRow? lastHooked)
|
||||
{
|
||||
Measured.Clear();
|
||||
@@ -577,16 +700,32 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
private void PresentHooking(GameRow row)
|
||||
{
|
||||
HookEnabled = row.HookEnabled;
|
||||
bool blocked = row.HookBlockedReason is not null || string.Equals(row.HookPrescanState, "blocked", StringComparison.Ordinal);
|
||||
bool blocked = row.BlockedByGuard;
|
||||
|
||||
// A blocked row's toggle is disabled because enabling it could only be refused (19_SAFETY §What a finding does
|
||||
// to the game): the finding is on the page, and there is no switch that overrules it (2026-09-22).
|
||||
HookToggleEnabled = !blocked && !Busy;
|
||||
// An executable that cannot run as x64 (beta.8): turning hooking ON could only be refused; a switch that is on
|
||||
// (enabled before this build read the file) can still be turned off.
|
||||
bool notX64 = ExecutableArchitecture.IsKnownNotHookable(row.ExeMachine);
|
||||
HookToggleEnabled = !blocked && !Busy && (row.HookEnabled || !notX64);
|
||||
NotX64Text = notX64 && !blocked
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.Hooking_NotX64_Format, Formats.Architecture(row.ExeMachine))
|
||||
: null;
|
||||
HookStatusText = row.HookEnabled ? Strings.GameDetail_Hooking_On : Strings.GameDetail_Hooking_Off;
|
||||
BlockedText = !blocked
|
||||
string? found = blocked ? BlockedReasonText.Describe(row.HookBlockedReason ?? row.HookPrescanState) : null;
|
||||
BlockedText = found is null
|
||||
? null
|
||||
: string.Format(CultureInfo.CurrentCulture, Shared.Strings.Safety_Blocked_Toggle_Format, row.HookBlockedReason ?? row.HookPrescanState);
|
||||
AutoDisabledText = row.HookAutoDisabledReason is { Length: > 0 } reason && !row.HookEnabled
|
||||
: string.Format(CultureInfo.CurrentCulture, Shared.Strings.Safety_Blocked_Toggle_Format, found);
|
||||
|
||||
// beta.8 (owner request 2026-09-25): for an anti-cheat game the card is a switch that can never be turned on, so
|
||||
// by default it gives way to the finding alone. The setting off keeps the card, with the finding under it.
|
||||
HookingSectionVisible = !(blocked && _hideAntiCheatHooking);
|
||||
AntiCheatText = found is not null && !HookingSectionVisible
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.GameDetail_AntiCheat_Format, found)
|
||||
: null;
|
||||
// Its "Turn hooking back on" could only be refused once anti-cheat was found, or for an executable that cannot run
|
||||
// as x64, so neither row offers it.
|
||||
AutoDisabledText = !blocked && !notX64 && row.HookAutoDisabledReason is { Length: > 0 } reason && !row.HookEnabled
|
||||
? string.Format(CultureInfo.CurrentCulture, Shared.Strings.Safety_AutoDisabled_Format, reason)
|
||||
: null;
|
||||
UnverifiedText = string.Equals(row.HookPrescanState, "unverified", StringComparison.Ordinal) ? Strings.GameDetail_Hooking_Unverified : null;
|
||||
@@ -604,7 +743,7 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
}
|
||||
|
||||
private static string EngineText(GameRow row) =>
|
||||
row.Engine is null ? string.Empty : row.EngineVersion is null ? row.Engine : row.Engine + " " + row.EngineVersion;
|
||||
row.Engine is null || row.EngineVersion is null ? Formats.Engine(row.Engine) : Formats.Engine(row.Engine) + " " + row.EngineVersion;
|
||||
|
||||
private static Domain.Metrics.Tri DefaultOf(GameRow row, TriStateKind kind) => kind switch
|
||||
{
|
||||
@@ -638,7 +777,7 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
}
|
||||
}
|
||||
|
||||
private static string CapabilityName(string token) => token switch
|
||||
internal static string CapabilityName(string token) => token switch
|
||||
{
|
||||
"dlss" => "DLSS",
|
||||
"dlssg" or "dlss_g" => "DLSS-G",
|
||||
|
||||
@@ -15,6 +15,7 @@ public sealed partial class ImportCandidateViewModel : ObservableObject
|
||||
Candidate = candidate ?? throw new ArgumentNullException(nameof(candidate));
|
||||
_isSelected = candidate.CanImport;
|
||||
Note = candidate.AlreadyInLibrary ? Strings.Import_Note_Already
|
||||
: candidate.MovedFrom is not null ? Strings.Import_Note_Moved
|
||||
: candidate.ExePath is null || candidate.ExecutableMissing ? Strings.Import_Note_NoExe
|
||||
: candidate.ExecutableGuessed ? Strings.Import_Note_Guessed
|
||||
: string.Empty;
|
||||
@@ -30,6 +31,6 @@ public sealed partial class ImportCandidateViewModel : ObservableObject
|
||||
|
||||
public string ExeText => Candidate.ExePath ?? Strings.Common_Dash;
|
||||
|
||||
/// <summary>Already in the library, no executable found, or a guessed executable the user should check.</summary>
|
||||
/// <summary>Already in the library (under this drive letter or, since 2026-09-23, another), no executable found, or a guessed executable the user should check.</summary>
|
||||
public string Note { get; }
|
||||
}
|
||||
@@ -8,9 +8,15 @@ namespace FrameLedger.App.ViewModels;
|
||||
|
||||
/// <summary>
|
||||
/// The Dashboard's live capture card (<c>08_UI</c> §Dashboard), fed by <c>SessionStarted</c> / <c>SessionProgress</c> /
|
||||
/// <c>SessionCompleted</c>. Tier 1 shows measured settings as facts; the readout follows the FPS display rule at
|
||||
/// 1 Hz, qualifier included. The sparkline is PR-6's.
|
||||
/// <c>SessionHeld</c> / <c>SessionCompleted</c>. Tier 1 shows measured settings as facts; the readout follows the FPS
|
||||
/// display rule at 1 Hz, qualifier included. The sparkline is PR-6's.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// <b>A session that is not measured is shown too (2026-09-23).</b> Its name, its tier, how long it has run, the machine's
|
||||
/// temperatures, and why nothing is measured — the same words its summary will use — with no readout at all. Until this
|
||||
/// date the Agent announced only hooked sessions, and a hooking-off or refused game read "Nothing is being captured." for
|
||||
/// as long as it ran. When two sessions run, a hooked one takes the card.
|
||||
/// </remarks>
|
||||
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
|
||||
public sealed partial class LiveCaptureViewModel : ObservableObject
|
||||
{
|
||||
@@ -20,6 +26,16 @@ public sealed partial class LiveCaptureViewModel : ObservableObject
|
||||
[ObservableProperty]
|
||||
private bool _waitingForFrames;
|
||||
|
||||
/// <summary>A Tier-2 session: recorded, not measured.</summary>
|
||||
[ObservableProperty]
|
||||
private bool _isHeld;
|
||||
|
||||
/// <summary>Why a held session measures nothing: the sentence its summary will carry.</summary>
|
||||
[ObservableProperty]
|
||||
private string _heldReason = string.Empty;
|
||||
|
||||
public static string HeldText => Strings.Dashboard_Live_RecordingOnly;
|
||||
|
||||
[ObservableProperty]
|
||||
private string _gameName = string.Empty;
|
||||
|
||||
@@ -63,17 +79,60 @@ public sealed partial class LiveCaptureViewModel : ObservableObject
|
||||
|
||||
public static string RtOnText => Strings.Dashboard_Live_Rt_On;
|
||||
|
||||
/// <summary>The tier of the session on the card; 0 when there is none.</summary>
|
||||
public int Tier { get; private set; }
|
||||
|
||||
public void Start(SessionStartedEvent started)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(started);
|
||||
SessionGuid = started.SessionGuid;
|
||||
GameName = started.GameName ?? Strings.Common_NotAvailable;
|
||||
TierText = started.Tier == 1 ? Strings.Tier_Hooked : Strings.Tier_NotHooked;
|
||||
Show(started.SessionGuid, started.GameName, started.Tier, started.Hold);
|
||||
}
|
||||
|
||||
/// <summary>A session that was already running when the card was built (the Dashboard is rebuilt on every visit).</summary>
|
||||
public void Seed(RunningSession session)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(session);
|
||||
Show(session.SessionGuid, session.GameName, session.Tier, session.Hold);
|
||||
}
|
||||
|
||||
/// <summary>A held session's 1 Hz tick: elapsed and the machine's temperatures.</summary>
|
||||
public void Hold(SessionHeldEvent held)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(held);
|
||||
if (SessionGuid != held.SessionGuid)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
ElapsedText = string.Format(CultureInfo.CurrentCulture, Strings.Dashboard_Live_Elapsed_Format, Formats.Duration(held.ElapsedS));
|
||||
GpuTempText = held.GpuTempC is double g ? string.Format(CultureInfo.CurrentCulture, Strings.Dashboard_Live_GpuTemp_Format, Math.Round(g)) : string.Empty;
|
||||
CpuTempText = held.CpuTempC is double c ? string.Format(CultureInfo.CurrentCulture, Strings.Dashboard_Live_CpuTemp_Format, Math.Round(c)) : string.Empty;
|
||||
}
|
||||
|
||||
private void Show(Guid sessionGuid, string? gameName, int tier, SessionHold? hold)
|
||||
{
|
||||
// A hooked session takes the card from an unhooked one, never the other way round.
|
||||
if (IsActive && SessionGuid is Guid shown && shown != sessionGuid && (Tier == 1 || tier != 1))
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
SessionGuid = sessionGuid;
|
||||
Tier = tier;
|
||||
GameName = gameName ?? Strings.Common_NotAvailable;
|
||||
TierText = tier == 1 ? Strings.Tier_Hooked : Strings.Tier_NotHooked;
|
||||
ElapsedText = string.Empty;
|
||||
Readout = FpsReadoutModel.Unavailable;
|
||||
ResolutionText = UpscalerText = FgText = GpuTempText = CpuTempText = VramText = string.Empty;
|
||||
RtActive = false;
|
||||
WaitingForFrames = true;
|
||||
|
||||
// Held means the Agent said why (a Tier-2 start carries its hold). A session the status lists at tier 2 with no hold
|
||||
// has not attached YET — it is starting: "nothing is measured" would be a claim nobody made, and the waiting line
|
||||
// says "Attached", which it is not. It shows its name and badge until its attach's start arrives.
|
||||
SessionHold? why = tier != 1 ? hold : null;
|
||||
IsHeld = why is not null;
|
||||
HeldReason = why is null ? string.Empty : Formats.Tier2HoldReason(why);
|
||||
WaitingForFrames = tier == 1;
|
||||
IsActive = true;
|
||||
}
|
||||
|
||||
@@ -86,6 +145,9 @@ public sealed partial class LiveCaptureViewModel : ObservableObject
|
||||
}
|
||||
|
||||
SessionGuid ??= progress.SessionGuid;
|
||||
Tier = 1;
|
||||
IsHeld = false;
|
||||
HeldReason = string.Empty;
|
||||
IsActive = true;
|
||||
WaitingForFrames = progress.Presents5s == 0;
|
||||
ElapsedText = string.Format(CultureInfo.CurrentCulture, Strings.Dashboard_Live_Elapsed_Format, Formats.Duration(progress.ElapsedS));
|
||||
@@ -108,7 +170,10 @@ public sealed partial class LiveCaptureViewModel : ObservableObject
|
||||
}
|
||||
|
||||
SessionGuid = null;
|
||||
Tier = 0;
|
||||
IsActive = false;
|
||||
WaitingForFrames = false;
|
||||
IsHeld = false;
|
||||
HeldReason = GameName = TierText = ElapsedText = GpuTempText = CpuTempText = VramText = string.Empty;
|
||||
}
|
||||
}
|
||||
@@ -44,6 +44,13 @@ public sealed partial class SessionSummaryViewModel : ObservableObject
|
||||
[ObservableProperty]
|
||||
private string _hardwareLine = string.Empty;
|
||||
|
||||
/// <summary>
|
||||
/// The runtime libraries the hooked game had loaded (<c>sessions.runtime_modules</c>, written since P2 and shown nowhere
|
||||
/// until beta.8), each against the copy the game ships where they differ; null when the row has none.
|
||||
/// </summary>
|
||||
[ObservableProperty]
|
||||
private string? _librariesLine;
|
||||
|
||||
[ObservableProperty]
|
||||
private FpsReadoutModel _readout = FpsReadoutModel.Unavailable;
|
||||
|
||||
@@ -290,6 +297,7 @@ public sealed partial class SessionSummaryViewModel : ObservableObject
|
||||
HardwareLine = _snapshot is null
|
||||
? string.Empty
|
||||
: string.Join(" · ", SystemInfoViewModel.Describe(_snapshot).Where(static l => !string.Equals(l.Value, Strings.Common_NotAvailable, StringComparison.Ordinal)).Select(static l => l.Value));
|
||||
LibrariesLine = LoadedLibraries(row.RuntimeModulesJson, Game.Libraries);
|
||||
Tags = _annotation is null ? string.Empty : string.Join(", ", _annotation.Tags);
|
||||
Notes = _annotation?.Notes ?? string.Empty;
|
||||
HasDisplayed = Series?.HasGenerated == true;
|
||||
@@ -319,6 +327,46 @@ public sealed partial class SessionSummaryViewModel : ObservableObject
|
||||
Stats.Add(new StatCardModel(Strings.Summary_Stat_Cpu, string.Format(CultureInfo.CurrentCulture, Strings.Summary_Stat_LoadTemp_Format, Formats.Percent(row.AvgCpuLoad), Formats.Temperature(row.MaxCpuTemp))));
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// <c>runtime_modules</c> ({file: version}) as one line, each module beside the version the game's own copy states when
|
||||
/// the two differ: a DLSS the NVIDIA App or the driver substituted is loaded from elsewhere under the same name. Null
|
||||
/// for a row with none — a Tier-2 session, or one written before the census existed.
|
||||
/// </summary>
|
||||
internal static string? LoadedLibraries(string? runtimeModulesJson, IReadOnlyList<Domain.Detection.LibraryFile> shipped)
|
||||
{
|
||||
if (string.IsNullOrWhiteSpace(runtimeModulesJson))
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
Dictionary<string, string>? modules;
|
||||
try
|
||||
{
|
||||
modules = System.Text.Json.JsonSerializer.Deserialize(runtimeModulesJson, AppJsonContext.Default.DictionaryStringString);
|
||||
}
|
||||
catch (System.Text.Json.JsonException)
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
if (modules is null || modules.Count == 0)
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
IEnumerable<string> items = modules.OrderBy(static m => m.Key, StringComparer.OrdinalIgnoreCase).Select(m =>
|
||||
{
|
||||
// A module with no version resource is stored as null (RuntimeModuleSnapshot.Describe).
|
||||
string? stated = m.Value;
|
||||
string version = stated ?? Strings.Common_NotAvailable;
|
||||
string? own = shipped.FirstOrDefault(l => string.Equals(l.FileName, m.Key, StringComparison.OrdinalIgnoreCase))?.FileVersion;
|
||||
return Formats.SameVersion(stated, own) == false
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.Summary_Library_Differs_Format, m.Key, version, own)
|
||||
: m.Key + " " + version;
|
||||
});
|
||||
return string.Format(CultureInfo.CurrentCulture, Strings.Summary_Libraries_Format, string.Join(" · ", items));
|
||||
}
|
||||
|
||||
private void PresentChips()
|
||||
{
|
||||
Chips.Clear();
|
||||
|
||||
@@ -69,6 +69,10 @@ public sealed partial class SettingsViewModel : ObservableObject
|
||||
[ObservableProperty]
|
||||
private bool _minimizeToTray;
|
||||
|
||||
/// <summary><c>ui.hide_anticheat_hooking</c> (beta.8): an anti-cheat game's page shows the finding instead of its Hooking card.</summary>
|
||||
[ObservableProperty]
|
||||
private bool _hideAntiCheatHooking = true;
|
||||
|
||||
[ObservableProperty]
|
||||
private bool _onlineMetadata;
|
||||
|
||||
@@ -224,6 +228,8 @@ public sealed partial class SettingsViewModel : ObservableObject
|
||||
|
||||
partial void OnBackgroundCaptureChanged(bool value) => Persist(SettingsRegistry.CaptureBackground, value);
|
||||
|
||||
partial void OnHideAntiCheatHookingChanged(bool value) => Persist(SettingsRegistry.UiHideAntiCheatHooking, value);
|
||||
|
||||
partial void OnMinimizeToTrayChanged(bool value)
|
||||
{
|
||||
if (!_loading)
|
||||
@@ -333,6 +339,7 @@ public sealed partial class SettingsViewModel : ObservableObject
|
||||
RetentionRawSessions = await _settings.GetIntegerAsync(SettingsRegistry.RetentionRawSessionsPerGame).ConfigureAwait(true);
|
||||
BackgroundCapture = await _settings.GetBooleanAsync(SettingsRegistry.CaptureBackground).ConfigureAwait(true);
|
||||
MinimizeToTray = await _settings.GetBooleanAsync(SettingsRegistry.UiMinimizeToTray).ConfigureAwait(true);
|
||||
HideAntiCheatHooking = await _settings.GetBooleanAsync(SettingsRegistry.UiHideAntiCheatHooking).ConfigureAwait(true);
|
||||
OnlineMetadata = await _settings.GetBooleanAsync(SettingsRegistry.PrivacyOnlineMetadata).ConfigureAwait(true);
|
||||
UpdateChannel = await _settings.GetAsync(SettingsRegistry.UpdateChannel).ConfigureAwait(true);
|
||||
AutoCheckUpdates = await _settings.GetBooleanAsync(SettingsRegistry.UpdateAutoCheck).ConfigureAwait(true);
|
||||
|
||||
@@ -143,9 +143,15 @@ public sealed partial class TrayViewModel : ObservableObject, IDisposable
|
||||
IsPaused = status.Paused;
|
||||
}
|
||||
|
||||
if (!_agent.IsConnected)
|
||||
// What the Agent runs is re-read on every (re)connect (2026-09-23): a session that started before this App
|
||||
// connected — or while it was away — was missing from the tray until it ended.
|
||||
_running.Clear();
|
||||
if (_agent.IsConnected && _agent.Status is { } running)
|
||||
{
|
||||
_running.Clear();
|
||||
foreach (ActiveSession a in running.ActiveSessions)
|
||||
{
|
||||
_running[a.SessionGuid] = (a.Tier, a.GameName ?? Strings.Common_NotAvailable);
|
||||
}
|
||||
}
|
||||
|
||||
Recompute();
|
||||
@@ -162,7 +168,8 @@ public sealed partial class TrayViewModel : ObservableObject, IDisposable
|
||||
Recompute();
|
||||
break;
|
||||
case IpcMessageType.SessionCompleted when IpcCodec.Payload<SessionCompletedEvent>(envelope) is { } completed:
|
||||
string name = _running.TryGetValue(completed.SessionGuid, out (int Tier, string Name) run) ? run.Name : Strings.Common_NotAvailable;
|
||||
string name = completed.GameName
|
||||
?? (_running.TryGetValue(completed.SessionGuid, out (int Tier, string Name) run) ? run.Name : Strings.Common_NotAvailable);
|
||||
_running.Remove(completed.SessionGuid);
|
||||
Recompute();
|
||||
if (completed.SessionId is long id)
|
||||
|
||||
@@ -38,6 +38,8 @@
|
||||
<!-- header line + chips -->
|
||||
<ui:TextBlock Appearance="Secondary" Text="{Binding ViewModel.Line}" />
|
||||
<ui:TextBlock Appearance="Tertiary" TextWrapping="Wrap" Text="{Binding ViewModel.HardwareLine}" />
|
||||
<ui:TextBlock Appearance="Tertiary" TextWrapping="Wrap" Text="{Binding ViewModel.LibrariesLine}"
|
||||
Visibility="{Binding ViewModel.LibrariesLine, Converter={StaticResource NullToCollapsed}}" />
|
||||
<ItemsControl Margin="0,8,0,0" ItemsSource="{Binding ViewModel.Chips}">
|
||||
<ItemsControl.ItemsPanel>
|
||||
<ItemsPanelTemplate>
|
||||
|
||||
@@ -0,0 +1,14 @@
|
||||
namespace FrameLedger.Application.AntiCheat;
|
||||
|
||||
/// <summary>What one pre-scan pass did.</summary>
|
||||
public sealed record AntiCheatPreScanReport
|
||||
{
|
||||
public int Found { get; init; }
|
||||
public int Clean { get; init; }
|
||||
public int Unverified { get; init; }
|
||||
public int Blocked { get; init; }
|
||||
public int Current { get; init; }
|
||||
public int Unreadable { get; init; }
|
||||
public bool RulesUnusable { get; init; }
|
||||
public int Scanned => Found + Clean + Unverified;
|
||||
}
|
||||
@@ -0,0 +1,163 @@
|
||||
using FrameLedger.Application.Consent;
|
||||
using FrameLedger.Application.Detection;
|
||||
using FrameLedger.Application.Ipc;
|
||||
using FrameLedger.Application.Persistence;
|
||||
using FrameLedger.Application.Watch;
|
||||
using FrameLedger.Domain.AntiCheat;
|
||||
using FrameLedger.Domain.Consent;
|
||||
using FrameLedger.Shared.Ipc;
|
||||
|
||||
namespace FrameLedger.Application.AntiCheat;
|
||||
|
||||
/// <summary>
|
||||
/// The Agent's pre-scan of the library (beta.8, owner decision 2026-09-25): every entry is asked the guard's advisory
|
||||
/// question — checks 3 and 4 over its executable (<see cref="IAntiCheatGuard.PreScanGameAsync"/>) — once, and again
|
||||
/// whenever the rules or the executable change, so a game that ships anti-cheat is known before it is ever launched
|
||||
/// and its hooking is off before anyone could turn it on.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// <b>Why it exists.</b> Until 2026-09-25 the pre-scan ran only when the user asked to turn hooking on
|
||||
/// (<c>SetHookEnabled</c>), and a session's own checks ran only for a game whose hooking was already on — so a game
|
||||
/// never enabled stayed <c>hook_prescan_state = 'not_run'</c>, and the App could not tell an anti-cheat game from any
|
||||
/// other. The owner asked for the hooking part of anti-cheat games to be hidden; that needs to know which they are.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// <b>What it writes</b> is what the guard answered, through the consent store (the hook-state writer): a finding
|
||||
/// about the game is the same block every other moment writes (<c>19_SAFETY</c> §What a finding does to the game) —
|
||||
/// hooking off, the reason on the row — plus the key it was scanned under; a pass is <c>'clean'</c>; a scan that could
|
||||
/// not answer is <c>'unverified'</c>. A blocked row is never scanned again and never written: nothing clears a block,
|
||||
/// and a later "clean" or "could not verify" must not read as one.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// <b>What it does not do.</b> It gates nothing: the chokepoint runs checks 1–4 against the live process at every
|
||||
/// session start whatever this sweep wrote, exactly as it did before. It never opens a game's process — the scan
|
||||
/// reads the executable's path, its install folder and the store's files.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public sealed class AntiCheatPreScanSweep : IDisposable
|
||||
{
|
||||
private readonly IGameRepository _games;
|
||||
private readonly IGameConsentStore _consent;
|
||||
private readonly IAntiCheatGuard _guard;
|
||||
private readonly IDetectionRulesSource _rules;
|
||||
private readonly IExecutableIdentitySource _identity;
|
||||
private readonly IIpcEventPublisher? _pipe;
|
||||
private readonly Func<long, bool> _isRecording;
|
||||
private readonly Action<string> _log;
|
||||
private readonly SemaphoreSlim _wake = new(0, 1);
|
||||
|
||||
public AntiCheatPreScanSweep(IGameRepository games, IGameConsentStore consent, IAntiCheatGuard guard, IDetectionRulesSource rules,
|
||||
IExecutableIdentitySource identity, Action<string> log, IIpcEventPublisher? pipe = null, Func<long, bool>? isRecording = null)
|
||||
{
|
||||
_games = games ?? throw new ArgumentNullException(nameof(games));
|
||||
_consent = consent ?? throw new ArgumentNullException(nameof(consent));
|
||||
_guard = guard ?? throw new ArgumentNullException(nameof(guard));
|
||||
_rules = rules ?? throw new ArgumentNullException(nameof(rules));
|
||||
_identity = identity ?? throw new ArgumentNullException(nameof(identity));
|
||||
_log = log ?? throw new ArgumentNullException(nameof(log));
|
||||
_pipe = pipe;
|
||||
_isRecording = isRecording ?? (static _ => false);
|
||||
}
|
||||
|
||||
/// <summary>Wake the hosted loop before its interval elapses (a rules update). Idempotent.</summary>
|
||||
public void RequestNow()
|
||||
{
|
||||
try
|
||||
{
|
||||
_wake.Release();
|
||||
}
|
||||
catch (SemaphoreFullException)
|
||||
{
|
||||
// Already requested and not yet consumed: one wake is one wake.
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>Wait for <see cref="RequestNow"/> or <paramref name="interval"/>, whichever first.</summary>
|
||||
public Task<bool> WaitAsync(TimeSpan interval, CancellationToken ct) => _wake.WaitAsync(interval, ct);
|
||||
|
||||
public void Dispose() => _wake.Dispose();
|
||||
|
||||
/// <summary>One pass over the library.</summary>
|
||||
public async ValueTask<AntiCheatPreScanReport> SweepOnceAsync(CancellationToken ct = default)
|
||||
{
|
||||
string rulesVersion;
|
||||
try
|
||||
{
|
||||
rulesVersion = (await _rules.LoadAsync(ct).ConfigureAwait(false)).RulesVersion;
|
||||
}
|
||||
catch (InvalidOperationException ex)
|
||||
{
|
||||
_log($"prescan: rules unusable, nothing scanned — {ex.Message}");
|
||||
return new AntiCheatPreScanReport { RulesUnusable = true };
|
||||
}
|
||||
|
||||
var report = new AntiCheatPreScanReport();
|
||||
foreach (GameRow game in await _games.ListAsync(ct).ConfigureAwait(false))
|
||||
{
|
||||
ct.ThrowIfCancellationRequested();
|
||||
if (game.BlockedByGuard)
|
||||
{
|
||||
// A block is final: nothing scans it again, and nothing this sweep writes could read as clearing it.
|
||||
report = report with { Blocked = report.Blocked + 1 };
|
||||
continue;
|
||||
}
|
||||
|
||||
if (_identity.Read(game.Fingerprint.ExePath) is not { } onDisk)
|
||||
{
|
||||
report = report with { Unreadable = report.Unreadable + 1 };
|
||||
continue; // the detection sweep names it; a file we cannot read is not one we can scan
|
||||
}
|
||||
|
||||
if (!IsStale(game, onDisk, rulesVersion) || _isRecording(game.Id))
|
||||
{
|
||||
report = report with { Current = report.Current + 1 };
|
||||
continue;
|
||||
}
|
||||
|
||||
report = await ScanAsync(game, onDisk, rulesVersion, report, ct).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
return report;
|
||||
}
|
||||
|
||||
private async ValueTask<AntiCheatPreScanReport> ScanAsync(GameRow game, ExecutableFingerprint onDisk, string rulesVersion,
|
||||
AntiCheatPreScanReport report, CancellationToken ct)
|
||||
{
|
||||
AntiCheatVerdict verdict = await _guard.PreScanGameAsync(onDisk.ExePath, ct).ConfigureAwait(false);
|
||||
if (await _consent.RecordPreScanAsync(onDisk, verdict, rulesVersion, ct).ConfigureAwait(false) != ConsentWriteOutcome.Written)
|
||||
{
|
||||
return report;
|
||||
}
|
||||
|
||||
if (verdict.IsFindingAboutTheGame)
|
||||
{
|
||||
_log($"prescan: {game.Name} — {verdict.Reason} {verdict.Family} ({verdict.Signal}); hooking off"
|
||||
+ (game.HookEnabled ? " (it was on)" : string.Empty));
|
||||
if (game.HookEnabled)
|
||||
{
|
||||
// The one case worth a notice: the user had turned hooking on, and a rules update or a game update has
|
||||
// just turned it off. A game whose hooking was already off changes nothing the user can see but its page.
|
||||
_pipe?.Publish(IpcMessageType.HookingTurnedOff,
|
||||
new HookingTurnedOffEvent(game.Id, game.Name, verdict.Reason.ToString(), NullIfEmpty(verdict.Family), NullIfEmpty(verdict.Signal)));
|
||||
}
|
||||
|
||||
return report with { Found = report.Found + 1 };
|
||||
}
|
||||
|
||||
return verdict.IsAllowed
|
||||
? report with { Clean = report.Clean + 1 }
|
||||
: report with { Unverified = report.Unverified + 1 };
|
||||
}
|
||||
|
||||
/// <summary>The pre-scan's own key (schema 0010) against the rules and the file right now: any difference is a re-scan.</summary>
|
||||
public static bool IsStale(GameRow game, ExecutableFingerprint onDisk, string rulesVersion)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(game);
|
||||
return !string.Equals(game.HookPrescanRulesVersion, rulesVersion, StringComparison.Ordinal)
|
||||
|| game.HookPrescanExeSizeBytes != onDisk.SizeBytes
|
||||
|| game.HookPrescanExeMtimeMs != onDisk.MtimeUnixMs;
|
||||
}
|
||||
|
||||
private static string? NullIfEmpty(string? s) => string.IsNullOrEmpty(s) ? null : s;
|
||||
}
|
||||
@@ -54,24 +54,30 @@ public interface IAntiCheatGuard
|
||||
CancellationToken ct = default);
|
||||
|
||||
/// <summary>
|
||||
/// Check 4 asked before anything is launched: does this game directory ship
|
||||
/// anti-cheat? Answers FR-2.2's question — whether the hooking toggle may be
|
||||
/// offered for this title at all.
|
||||
/// Checks 3 and 4 asked before anything is launched: is this executable a listed title, does its install carry a
|
||||
/// listed store identity, does its install tree ship anti-cheat? Answers FR-2.2's question — whether the hooking
|
||||
/// toggle may be offered for this title at all — and the Agent's pre-scan of the library.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// ADVISORY ONLY. This does not gate injection; <see cref="EvaluateAsync"/>
|
||||
/// and <see cref="GuardedInjectAsync"/> run the same scan inside the guard,
|
||||
/// and <see cref="GuardedInjectAsync"/> run the same checks inside the guard,
|
||||
/// against a directory derived from the target's own pid rather than one a
|
||||
/// caller named. A caller that skips this question, or lies about the
|
||||
/// answer, changes nothing about whether injection is allowed.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// It takes the EXECUTABLE since 2026-09-25 (it was <c>PreScanGameDirectoryAsync</c>). The only caller passed the
|
||||
/// executable's own folder and the guard scanned exactly that, so an Unreal title's root-level
|
||||
/// <c>EasyAntiCheat</c> folder was never seen by the scan that decides whether hooking may be enabled. The guard
|
||||
/// now resolves the install root from the path itself, as the chokepoint always did.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// It lives on this port rather than a second one deliberately. Splitting it
|
||||
/// out would have kept <c>NoSecondMatcherTests</c>' method count at two
|
||||
/// without that test ever seeing the new surface — the count would have gone
|
||||
/// on passing while the thing it guards grew somewhere else.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
ValueTask<AntiCheatVerdict> PreScanGameDirectoryAsync(string gameDirectory, CancellationToken ct = default);
|
||||
ValueTask<AntiCheatVerdict> PreScanGameAsync(string executablePath, CancellationToken ct = default);
|
||||
}
|
||||
@@ -28,6 +28,12 @@ public sealed record CaptureProgress
|
||||
|
||||
public required NgxDriverState NgxDriver { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// On a held session's tick (2026-09-23): the refusal it is held under — its reason, and the guard's verdict when the
|
||||
/// guard spoke — so the pipe can say, while the game runs, why nothing is measured. Null on every hooked tick.
|
||||
/// </summary>
|
||||
public CaptureOutcome? Hold { get; init; }
|
||||
|
||||
/// <summary>The tick of a session that never attached (Tier 2, 2026-09-22): no records, no ring, nothing measured.</summary>
|
||||
public static CaptureProgress Unhooked { get; } = new()
|
||||
{
|
||||
@@ -43,4 +49,11 @@ public sealed record CaptureProgress
|
||||
RuntimeModules = RuntimeModuleSet.Empty,
|
||||
NgxDriver = NgxDriverState.NotRun,
|
||||
};
|
||||
|
||||
/// <summary>The tick of a session held unhooked under <paramref name="refusal"/> (2026-09-23): <see cref="Unhooked"/> with its reason.</summary>
|
||||
public static CaptureProgress Held(CaptureOutcome refusal)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(refusal);
|
||||
return Unhooked with { Hold = refusal };
|
||||
}
|
||||
}
|
||||
@@ -143,6 +143,10 @@ public sealed class CaptureSession(
|
||||
}
|
||||
|
||||
DateTimeOffset? hardStop = options.MaxDuration > TimeSpan.Zero ? DateTimeOffset.UtcNow + options.MaxDuration : null;
|
||||
|
||||
// The ticks carry the refusal with the pid the loop holds, if any (2026-09-23: the pipe announces a held session from
|
||||
// its first tick). A hooking-off hold never opened the process and says 0.
|
||||
CaptureProgress held = CaptureProgress.Held(refusal with { TargetPid = pid ?? 0 });
|
||||
while (!stop.IsCancellationRequested)
|
||||
{
|
||||
bool running = alive is not null ? !alive.HasExited : resolver.IsRunning(normalisedExePath);
|
||||
@@ -151,11 +155,11 @@ public sealed class CaptureSession(
|
||||
break;
|
||||
}
|
||||
|
||||
observer?.Tick(CaptureProgress.Unhooked);
|
||||
observer?.Tick(held);
|
||||
await Task.Delay(options.HoldInterval, ct).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
observer?.Tick(CaptureProgress.Unhooked);
|
||||
observer?.Tick(held);
|
||||
return refusal with { HeldUnhooked = true, TargetPid = pid ?? 0, ExitCode = alive?.ExitCode };
|
||||
}
|
||||
|
||||
|
||||
@@ -113,4 +113,25 @@ public interface IGameConsentStore
|
||||
/// </remarks>
|
||||
ValueTask<ConsentWriteOutcome> RecordGuardBlockAsync(
|
||||
ExecutableFingerprint fingerprint, AntiCheatVerdict refusal, CancellationToken ct = default);
|
||||
|
||||
/// <summary>
|
||||
/// What the Agent's pre-scan of the library (2026-09-25) found for an EXISTING entry, and the key it scanned under:
|
||||
/// the rules version, and the executable's size and mtime in <paramref name="scanned"/>.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// A finding about the game (<see cref="AntiCheatVerdict.IsFindingAboutTheGame"/>) is the block every other moment
|
||||
/// writes — hooking off, the reason on the row, <c>'blocked'</c> — with the consent stamp preserved, as
|
||||
/// <see cref="RecordGuardBlockAsync"/> preserves it. A pass is <c>'clean'</c>; anything else is <c>'unverified'</c>,
|
||||
/// which does not disable the toggle.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// It never adds a row (the library is the App's and the watcher's to add to: <see cref="ConsentWriteOutcome.NotFound"/>)
|
||||
/// and never writes over a block (also <see cref="ConsentWriteOutcome.NotFound"/>, and nothing is written): nothing
|
||||
/// clears a block, and a later "clean" must not read as one. It does not touch the consent fingerprint either — the
|
||||
/// key is the pre-scan's own columns (schema 0010).
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
ValueTask<ConsentWriteOutcome> RecordPreScanAsync(
|
||||
ExecutableFingerprint scanned, AntiCheatVerdict verdict, string rulesVersion, CancellationToken ct = default);
|
||||
}
|
||||
@@ -101,12 +101,19 @@ public sealed class DetectionSweep : IDisposable
|
||||
foreach (GameRow listed in await _games.ListAsync(ct).ConfigureAwait(false))
|
||||
{
|
||||
ct.ThrowIfCancellationRequested();
|
||||
(GameRow game, ExecutableFingerprint? read, bool moved) = await ReadOrRelocateAsync(listed, ct).ConfigureAwait(false);
|
||||
(GameRow game, ExecutableFingerprint? read, bool moved, bool gone) = await ReadOrRelocateAsync(listed, ct).ConfigureAwait(false);
|
||||
if (moved)
|
||||
{
|
||||
relocated++;
|
||||
}
|
||||
|
||||
if (gone)
|
||||
{
|
||||
// Merged into its twin this pass (2026-09-23): not an entry any more, so not an unreadable one.
|
||||
_unreadableSaid.Remove(game.Id);
|
||||
continue;
|
||||
}
|
||||
|
||||
if (read is not { } onDisk)
|
||||
{
|
||||
unreadable++;
|
||||
@@ -136,6 +143,12 @@ public sealed class DetectionSweep : IDisposable
|
||||
return new DetectionSweepReport { Scanned = scanned, Current = current, Unreadable = unreadable, Relocated = relocated };
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// What <c>hook_autodisabled_reason</c> says when the sweep turns off hooking on an executable that cannot run as x64
|
||||
/// (beta.8). The page says it in the user's language from <c>exe_machine</c>; this is the row's and the log's record.
|
||||
/// </summary>
|
||||
public static string NotX64Reason(string architecture) => $"executable is {architecture}: the hook runs in x64 processes only";
|
||||
|
||||
/// <summary>One game through the detector and into the row; true when the row took the write.</summary>
|
||||
private async ValueTask<bool> ScanAsync(GameRow game, ExecutableFingerprint onDisk, CancellationToken ct)
|
||||
{
|
||||
@@ -154,39 +167,65 @@ public sealed class DetectionSweep : IDisposable
|
||||
RulesVersion = r.RulesVersion,
|
||||
ExeSizeBytes = onDisk.SizeBytes,
|
||||
ExeMtimeMs = onDisk.MtimeUnixMs,
|
||||
ExeArchitecture = r.ExeArchitecture,
|
||||
ExeFileVersion = r.ExeFileVersion,
|
||||
ExeProductVersion = r.ExeProductVersion,
|
||||
Libraries = r.Libraries,
|
||||
};
|
||||
if (!await _games.ApplyDetectionAsync(game.Id, write, ct).ConfigureAwait(false))
|
||||
{
|
||||
return false;
|
||||
}
|
||||
|
||||
// A hooking switch that can never work (beta.8): an x86, ARM or 32-bit-preferring executable is a process the x64
|
||||
// hook cannot enter. Enabling it is refused up front since this build; a row enabled before it is turned off here
|
||||
// rather than refused at every launch. The consent stays: the same row with a 64-bit executable can be re-enabled.
|
||||
if (game.HookEnabled && ExecutableArchitecture.IsKnownNotHookable(r.ExeArchitecture))
|
||||
{
|
||||
string reason = NotX64Reason(r.ExeArchitecture);
|
||||
_ = await _games.AutoDisableHookAsync(game.Id, reason, DateTimeOffset.UtcNow, ct).ConfigureAwait(false);
|
||||
_log($"detect: {game.Name} — {reason}; hooking turned off");
|
||||
}
|
||||
|
||||
_log($"detect: {game.Name} — engine={r.EngineId ?? (r.EngineUndetermined ? "undetermined" : "none")}"
|
||||
+ $"{(r.EngineVersion is null ? string.Empty : " " + r.EngineVersion)} platform={r.PlatformId ?? (r.PlatformUndetermined ? "undetermined" : "none")}"
|
||||
+ $" capabilities=[{string.Join(",", capabilities)}] vulkan={(r.UsesVulkan is { } v ? (v ? "yes" : "no") : "unknown")} rules={r.RulesVersion}");
|
||||
+ $" capabilities=[{string.Join(",", capabilities)}] vulkan={(r.UsesVulkan is { } v ? (v ? "yes" : "no") : "unknown")} rules={r.RulesVersion}"
|
||||
+ $" arch={r.ExeArchitecture} libraries={r.Libraries.Count}");
|
||||
return true;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// The row's executable as read from disk — and, when it is missing, one more question before the row is skipped
|
||||
/// (2026-09-22): is the same file under another drive letter? When it is, the row follows it and this very pass
|
||||
/// scans it there.
|
||||
/// scans it there. Since 2026-09-23 the relocator can also merge the row into the entry that already holds that
|
||||
/// file; the row is then gone, which this says rather than calling it unreadable.
|
||||
/// </summary>
|
||||
private async ValueTask<(GameRow Game, ExecutableFingerprint? Read, bool Moved)> ReadOrRelocateAsync(GameRow game, CancellationToken ct)
|
||||
private async ValueTask<(GameRow Game, ExecutableFingerprint? Read, bool Moved, bool Gone)> ReadOrRelocateAsync(GameRow game, CancellationToken ct)
|
||||
{
|
||||
ExecutableFingerprint? read = _identity.Read(game.Fingerprint.ExePath);
|
||||
if (read is not null || _relocator is null || await _relocator.TryRelocateAsync(game, ct).ConfigureAwait(false) is not { } moved)
|
||||
if (read is not null || _relocator is null)
|
||||
{
|
||||
return (game, read, false);
|
||||
return (game, read, false, false);
|
||||
}
|
||||
|
||||
return (game with { Fingerprint = moved }, _identity.Read(moved.ExePath), true);
|
||||
if (await _relocator.TryRelocateAsync(game, ct).ConfigureAwait(false) is { } moved)
|
||||
{
|
||||
return (game with { Fingerprint = moved }, _identity.Read(moved.ExePath), true, false);
|
||||
}
|
||||
|
||||
bool gone = await _games.FindByIdAsync(game.Id, ct).ConfigureAwait(false) is null;
|
||||
return (game, null, gone, gone);
|
||||
}
|
||||
|
||||
/// <summary><c>DetectionCacheKey</c> compared field by field against the row: any difference is a re-run.</summary>
|
||||
/// <summary>
|
||||
/// <c>DetectionCacheKey</c> compared field by field against the row: any difference is a re-run — and a row this build
|
||||
/// has not read the executable's facts for (schema 0011, <c>exe_machine</c> NULL) is one too, once.
|
||||
/// </summary>
|
||||
public static bool IsStale(GameRow game, ExecutableFingerprint onDisk, string rulesVersion)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(game);
|
||||
return !string.Equals(game.DetectionRulesVersion, rulesVersion, StringComparison.Ordinal)
|
||||
return game.ExeMachine is null
|
||||
|| !string.Equals(game.DetectionRulesVersion, rulesVersion, StringComparison.Ordinal)
|
||||
|| game.DetectionExeSizeBytes != onDisk.SizeBytes
|
||||
|| game.DetectionExeMtimeMs != onDisk.MtimeUnixMs;
|
||||
}
|
||||
|
||||
@@ -0,0 +1,13 @@
|
||||
using FrameLedger.Domain.Detection;
|
||||
|
||||
namespace FrameLedger.Application.Detection;
|
||||
|
||||
/// <summary>
|
||||
/// What an executable runs as, read from its PE headers (beta.8): an <see cref="ExecutableArchitecture"/> id. Read-only
|
||||
/// file I/O on the executable — never its process (CLAUDE.md rule 4).
|
||||
/// </summary>
|
||||
public interface IExecutableArchitectureSource
|
||||
{
|
||||
/// <summary>The id; <see cref="ExecutableArchitecture.Unknown"/> when the file cannot be read as a PE.</summary>
|
||||
string Read(string exePath);
|
||||
}
|
||||
@@ -46,6 +46,10 @@ public sealed class StaticGameDetector(IDetectionRulesSource rulesSource, IGameF
|
||||
CapabilityIds = [.. evaluator.MatchCapabilities(snapshot).Select(c => c.Id)],
|
||||
RulesVersion = rules.RulesVersion,
|
||||
UsesVulkan = snapshot.VulkanLoaderReferenced,
|
||||
ExeArchitecture = snapshot.ExeArchitecture,
|
||||
ExeFileVersion = snapshot.PeFileVersion,
|
||||
ExeProductVersion = snapshot.PeProductVersion,
|
||||
Libraries = snapshot.Libraries,
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,54 @@
|
||||
namespace FrameLedger.Application.Import;
|
||||
|
||||
/// <summary>
|
||||
/// The name an entry gets when the user adds an executable by hand (2026-09-23). The file name is the right answer for
|
||||
/// <c>DarkSoulsIII.exe</c> and the wrong one for <c>Game.exe</c>: every RPG Maker game, and a good share of engine
|
||||
/// runtimes, ship an executable whose name says nothing about the game. For those the engine's own title wins when there
|
||||
/// is one (RPG Maker's <c>System.json</c> <c>gameTitle</c>), then the nearest folder that is not a runtime folder — so
|
||||
/// <i>HELLO, HELLO WORLD!</i>'s <c>swiftshader\Game.exe</c> is "HELLO, HELLO WORLD!", not "Game" or "swiftshader".
|
||||
/// </summary>
|
||||
public static class GameTitleGuess
|
||||
{
|
||||
// Executable stems that name a runtime or a role, never a game.
|
||||
private static readonly HashSet<string> _generic = new(StringComparer.OrdinalIgnoreCase)
|
||||
{
|
||||
"game", "nw", "launcher", "launch", "start", "play", "main", "app", "client", "run", "runtime", "engine",
|
||||
"player", "bootstrap", "bootstrapper", "win64", "shipping",
|
||||
};
|
||||
|
||||
// Folders an engine puts its executable in; the game's name is above them.
|
||||
private static readonly HashSet<string> _runtimeFolders = new(StringComparer.OrdinalIgnoreCase)
|
||||
{
|
||||
"swiftshader", "bin", "binaries", "win64", "win32", "x64", "x86", "www", "nw", "game", "exe", "app", "runtime",
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// The name for <paramref name="exePath"/>: its file name when that names something, else <paramref name="engineTitle"/>
|
||||
/// (asked only then — it reads a file), else the nearest folder that is not a runtime folder, else the file name.
|
||||
/// </summary>
|
||||
public static string Guess(string exePath, Func<string?>? engineTitle = null)
|
||||
{
|
||||
ArgumentException.ThrowIfNullOrWhiteSpace(exePath);
|
||||
string stem = Path.GetFileNameWithoutExtension(exePath);
|
||||
if (!_generic.Contains(stem))
|
||||
{
|
||||
return stem;
|
||||
}
|
||||
|
||||
if (engineTitle?.Invoke() is { } title && !string.IsNullOrWhiteSpace(title))
|
||||
{
|
||||
return title.Trim();
|
||||
}
|
||||
|
||||
for (string? dir = Path.GetDirectoryName(exePath); !string.IsNullOrEmpty(dir); dir = Path.GetDirectoryName(dir))
|
||||
{
|
||||
string name = Path.GetFileName(dir);
|
||||
if (name.Length > 0 && !_runtimeFolders.Contains(name))
|
||||
{
|
||||
return name;
|
||||
}
|
||||
}
|
||||
|
||||
return stem;
|
||||
}
|
||||
}
|
||||
@@ -5,8 +5,14 @@ namespace FrameLedger.Application.Import;
|
||||
/// own when it names one, else the locator's guess — whether the ledger already has it, and whether the file is
|
||||
/// there to be read at all. A candidate with no executable cannot be imported and the list says so.
|
||||
/// </summary>
|
||||
public sealed record ImportCandidate(StoreGame Game, string? ExePath, bool AlreadyInLibrary, bool ExecutableGuessed, bool ExecutableMissing = false)
|
||||
/// <remarks>
|
||||
/// <see cref="MovedFrom"/> (2026-09-23) is the path of the library entry this executable already is, on a drive whose
|
||||
/// letter changed: that entry follows the file (the Agent's relocator), so importing it again would make the second,
|
||||
/// side-by-side entry the owner's library showed for every game on the re-lettered drive.
|
||||
/// </remarks>
|
||||
public sealed record ImportCandidate(StoreGame Game, string? ExePath, bool AlreadyInLibrary, bool ExecutableGuessed, bool ExecutableMissing = false,
|
||||
string? MovedFrom = null)
|
||||
{
|
||||
/// <summary>An executable is known, it is on disk, and the ledger does not have it yet.</summary>
|
||||
public bool CanImport => ExePath is not null && !ExecutableMissing && !AlreadyInLibrary;
|
||||
/// <summary>An executable is known, it is on disk, and the ledger does not have it yet — under this letter or another.</summary>
|
||||
public bool CanImport => ExePath is not null && !ExecutableMissing && !AlreadyInLibrary && MovedFrom is null;
|
||||
}
|
||||
@@ -36,6 +36,7 @@ public sealed class LibraryImporter
|
||||
{
|
||||
var seen = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
|
||||
List<ImportCandidate> candidates = [];
|
||||
IReadOnlyList<GameRow> library = await _games.ListAsync(ct).ConfigureAwait(false);
|
||||
foreach (IStoreLibrarySource source in _sources)
|
||||
{
|
||||
IReadOnlyList<StoreGame> games;
|
||||
@@ -67,7 +68,8 @@ public sealed class LibraryImporter
|
||||
// rather than the import failing later.
|
||||
bool missing = exe is not null && _identity.Read(exe) is null;
|
||||
bool already = exe is not null && await _games.FindAsync(exe, ct).ConfigureAwait(false) is { InLibrary: true };
|
||||
candidates.Add(new ImportCandidate(game, exe, already, guessed, missing));
|
||||
string? movedFrom = exe is null || already ? null : StaleTwinOf(exe, library)?.Fingerprint.ExePath;
|
||||
candidates.Add(new ImportCandidate(game, exe, already, guessed, missing, movedFrom));
|
||||
}
|
||||
|
||||
_log($"import: {source.Platform} — {games.Count} title(s)");
|
||||
@@ -82,6 +84,7 @@ public sealed class LibraryImporter
|
||||
ArgumentNullException.ThrowIfNull(selected);
|
||||
int added = 0;
|
||||
int skipped = 0;
|
||||
IReadOnlyList<GameRow> library = await _games.ListAsync(ct).ConfigureAwait(false);
|
||||
foreach (ImportCandidate c in selected)
|
||||
{
|
||||
ct.ThrowIfCancellationRequested();
|
||||
@@ -93,6 +96,13 @@ public sealed class LibraryImporter
|
||||
}
|
||||
|
||||
GameRow? before = await _games.FindAsync(c.ExePath, ct).ConfigureAwait(false);
|
||||
if (before is null && StaleTwinOf(c.ExePath, library) is { } twin)
|
||||
{
|
||||
skipped++;
|
||||
_log($"import: {c.Game.Name} not added — it is the library's '{twin.Name}' ({twin.Fingerprint.ExePath}) on a drive whose letter changed; that entry follows it");
|
||||
continue;
|
||||
}
|
||||
|
||||
GameRow row = await _games.EnsureAsync(fingerprint, c.Game.Name, ct).ConfigureAwait(false);
|
||||
_ = await _games.ApplyStoreMetadataAsync(row.Id, new StoreMetadata { Platform = c.Game.Platform, StoreId = c.Game.StoreId, GameVersion = c.Game.Version }, ct).ConfigureAwait(false);
|
||||
if (before is { InLibrary: true })
|
||||
@@ -108,4 +118,13 @@ public sealed class LibraryImporter
|
||||
|
||||
return new ImportReport(added, skipped);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// The library entry <paramref name="exe"/> already is on a drive that changed its letter (2026-09-23): its path with
|
||||
/// only the letter different, and its own file gone — the relocator's rule (<see cref="ExecutableRelocator.IsDriveLetterTwin"/>).
|
||||
/// The Agent's sweep moves that entry within one interval; a new entry beside it is how the owner's library came to
|
||||
/// show two of every game on the re-lettered drive.
|
||||
/// </summary>
|
||||
private GameRow? StaleTwinOf(string exe, IReadOnlyList<GameRow> library) =>
|
||||
library.FirstOrDefault(r => ExecutableRelocator.IsDriveLetterTwin(r.Fingerprint.ExePath, exe) && _identity.Read(r.Fingerprint.ExePath) is null);
|
||||
}
|
||||
@@ -1,11 +1,13 @@
|
||||
using FrameLedger.Application.AntiCheat;
|
||||
using FrameLedger.Application.Capture;
|
||||
using FrameLedger.Application.Consent;
|
||||
using FrameLedger.Application.Detection;
|
||||
using FrameLedger.Application.Persistence;
|
||||
using FrameLedger.Application.Vulkan;
|
||||
using FrameLedger.Application.Watch;
|
||||
using FrameLedger.Domain.AntiCheat;
|
||||
using FrameLedger.Domain.Consent;
|
||||
using FrameLedger.Domain.Detection;
|
||||
using FrameLedger.Shared.Ipc;
|
||||
using FrameLedger.Shared.Safety;
|
||||
|
||||
@@ -36,6 +38,13 @@ public sealed class AgentCommandHandler
|
||||
private readonly VkLayerReconciler? _layer;
|
||||
private readonly Func<CancellationToken, ValueTask<SweepRetentionAck>>? _sweepRetention;
|
||||
private readonly ExecutableRelocator? _relocator;
|
||||
private readonly IExecutableArchitectureSource? _architecture;
|
||||
|
||||
/// <summary>
|
||||
/// <c>Refused.reason</c> for an executable that cannot run as x64 (beta.8); <c>signal</c> carries its
|
||||
/// <see cref="ExecutableArchitecture"/> id. Not a guard reason — nothing was scanned — so not one of its names.
|
||||
/// </summary>
|
||||
public const string NotX64Reason = "ExecutableNotX64";
|
||||
|
||||
/// <summary>
|
||||
/// <c>disclosureVersion</c> is the version of FR-2.1's reviewed disclosure this Agent carries
|
||||
@@ -45,8 +54,12 @@ public sealed class AgentCommandHandler
|
||||
public AgentCommandHandler(IGameRepository games, IGameConsentStore consent, IAntiCheatGuard guard, IExecutableIdentitySource identity,
|
||||
CaptureOrchestrator orchestrator, CapturePause pause, IAgentLifetime lifetime, Func<CancellationToken, ValueTask<string>> updateRules,
|
||||
string? disclosureVersion = null, TimeProvider? clock = null, VkLayerReconciler? layer = null,
|
||||
Func<CancellationToken, ValueTask<SweepRetentionAck>>? sweepRetention = null, ExecutableRelocator? relocator = null)
|
||||
Func<CancellationToken, ValueTask<SweepRetentionAck>>? sweepRetention = null, ExecutableRelocator? relocator = null,
|
||||
IExecutableArchitectureSource? architecture = null)
|
||||
{
|
||||
// beta.8: an executable that cannot run as x64 is refused before anything is scanned or stamped; null skips the
|
||||
// question (the guard's TargetIsWow64 at a session's start stays the check either way).
|
||||
_architecture = architecture;
|
||||
// A drive that changed its letter (2026-09-22): the click that enables hooking looks for the file under another root
|
||||
// before it says the executable cannot be read.
|
||||
_relocator = relocator;
|
||||
@@ -175,8 +188,16 @@ public sealed class AgentCommandHandler
|
||||
return Error(request, IpcErrorCode.ExecutableUnreadable, $"{path} could not be read, so nothing can be scanned or stamped");
|
||||
}
|
||||
|
||||
string directory = Path.GetDirectoryName(path) ?? path;
|
||||
AntiCheatVerdict verdict = await _guard.PreScanGameDirectoryAsync(directory, ct).ConfigureAwait(false);
|
||||
// An executable known not to run as x64 (beta.8): the hook can never enter its process, so nothing is scanned or
|
||||
// stamped and nothing is written — the consent dialog would promise a measurement the capture cannot make.
|
||||
if (_architecture?.Read(path) is { } architecture && ExecutableArchitecture.IsKnownNotHookable(architecture))
|
||||
{
|
||||
return IpcCodec.Encode(IpcMessageType.Refused, request.Id, new RefusedAck(game.Id, NotX64Reason, Family: null, Signal: architecture));
|
||||
}
|
||||
|
||||
// The EXECUTABLE, not its folder (2026-09-25): the guard resolves the install root and runs check 3 on the
|
||||
// name and the store identity as well as check 4 on the tree.
|
||||
AntiCheatVerdict verdict = await _guard.PreScanGameAsync(path, ct).ConfigureAwait(false);
|
||||
if (!verdict.IsAllowed)
|
||||
{
|
||||
// A refusal, or a scan that reached no answer: the store records which (a default verdict is
|
||||
|
||||
@@ -59,14 +59,46 @@ public static class RecordedSessionEvents
|
||||
_ => CaptureErrorCode.AttachRefused,
|
||||
};
|
||||
|
||||
public static void PublishAll(IIpcEventPublisher pipe, RecordedSession session, SessionStartedInfo info)
|
||||
/// <summary>
|
||||
/// A finished session's events: its reason's safety/error event — unless <paramref name="reasonAlreadyPublished"/>, because
|
||||
/// a held session said it when its hold began (2026-09-23) — then always <c>SessionCompleted</c>, naming the entry the
|
||||
/// session was stored under.
|
||||
/// </summary>
|
||||
public static void PublishAll(IIpcEventPublisher pipe, RecordedSession session, SessionStartedInfo info, bool reasonAlreadyPublished = false)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(pipe);
|
||||
ArgumentNullException.ThrowIfNull(session);
|
||||
ArgumentNullException.ThrowIfNull(info);
|
||||
|
||||
if (!reasonAlreadyPublished)
|
||||
{
|
||||
PublishReason(pipe, session.SessionGuid, session.Outcome, info);
|
||||
}
|
||||
|
||||
CaptureOutcome o = session.Outcome;
|
||||
Guid guid = session.SessionGuid;
|
||||
pipe.Publish(IpcMessageType.SessionCompleted, new SessionCompletedEvent(
|
||||
session.SessionGuid,
|
||||
session.Finalize.SessionId,
|
||||
Vocabulary.ExitStatusText(session.ExitStatus),
|
||||
(int)session.Row.Tier,
|
||||
FinalizeText(session.Finalize.Status),
|
||||
o.Reason.ToString(),
|
||||
session.Finalize.GameId ?? info.GameId,
|
||||
info.GameName));
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// The one safety or error event <paramref name="outcome"/>'s reason warrants, or nothing. At the end of a session, or —
|
||||
/// for a session held unhooked (2026-09-23) — the moment its hold begins, so a refusal is said while the game runs and
|
||||
/// not when it exits.
|
||||
/// </summary>
|
||||
public static void PublishReason(IIpcEventPublisher pipe, Guid sessionGuid, CaptureOutcome outcome, SessionStartedInfo info)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(pipe);
|
||||
ArgumentNullException.ThrowIfNull(outcome);
|
||||
ArgumentNullException.ThrowIfNull(info);
|
||||
|
||||
CaptureOutcome o = outcome;
|
||||
switch (Classify(o.Reason))
|
||||
{
|
||||
case Kind.Refused:
|
||||
@@ -74,29 +106,41 @@ public static class RecordedSessionEvents
|
||||
new CaptureRefusedEvent(info.GameId, info.GameName, o.Reason.ToString(), NullIfEmpty(o.Verdict.Family), NullIfEmpty(o.Verdict.Signal), o.HookingTurnedOff));
|
||||
break;
|
||||
case Kind.SafetyUnhook:
|
||||
pipe.Publish(IpcMessageType.SafetyUnhook, new SafetyUnhookEvent(guid, NullIfEmpty(o.Verdict.Family), NullIfEmpty(o.Verdict.Signal), o.HookingTurnedOff));
|
||||
pipe.Publish(IpcMessageType.SafetyUnhook, new SafetyUnhookEvent(sessionGuid, NullIfEmpty(o.Verdict.Family), NullIfEmpty(o.Verdict.Signal), o.HookingTurnedOff));
|
||||
break;
|
||||
case Kind.Degraded:
|
||||
pipe.Publish(IpcMessageType.CaptureDegraded, new CaptureDegradedEvent(guid, From: 1, To: 2, o.Reason.ToString()));
|
||||
pipe.Publish(IpcMessageType.CaptureDegraded, new CaptureDegradedEvent(sessionGuid, From: 1, To: 2, o.Reason.ToString()));
|
||||
break;
|
||||
case Kind.AttachError:
|
||||
pipe.Publish(IpcMessageType.CaptureError,
|
||||
new CaptureErrorEvent(guid, RingCode(o.AttachRefusal), $"the ring could not be attached: {o.AttachRefusal}"));
|
||||
new CaptureErrorEvent(sessionGuid, RingCode(o.AttachRefusal), $"the ring could not be attached: {o.AttachRefusal}"));
|
||||
break;
|
||||
case Kind.TargetError:
|
||||
pipe.Publish(IpcMessageType.CaptureError, new CaptureErrorEvent(guid, CaptureErrorCode.InjectFailed, o.Reason.ToString()));
|
||||
pipe.Publish(IpcMessageType.CaptureError, new CaptureErrorEvent(sessionGuid, CaptureErrorCode.InjectFailed, o.Reason.ToString()));
|
||||
break;
|
||||
default:
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
pipe.Publish(IpcMessageType.SessionCompleted, new SessionCompletedEvent(
|
||||
guid,
|
||||
session.Finalize.SessionId,
|
||||
Vocabulary.ExitStatusText(session.ExitStatus),
|
||||
(int)session.Row.Tier,
|
||||
FinalizeText(session.Finalize.Status),
|
||||
o.Reason.ToString()));
|
||||
/// <summary><c>SessionCompleted.finalize</c> for a session whose task threw before it could finalize (2026-09-23).</summary>
|
||||
public const string FaultedFinalize = "faulted";
|
||||
|
||||
/// <summary>
|
||||
/// The words a held session's <c>capture_notes</c> will carry, for the wire (2026-09-23): the loop's reason and, when the
|
||||
/// guard said anything but a plain allow, its reason, family and signal.
|
||||
/// </summary>
|
||||
public static SessionHold HoldOf(CaptureOutcome outcome)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(outcome);
|
||||
Domain.AntiCheat.AntiCheatVerdict v = outcome.Verdict;
|
||||
bool guardSpoke = v.Reason != Domain.AntiCheat.AntiCheatRefusalReason.Allow;
|
||||
return new SessionHold(
|
||||
outcome.Reason.ToString(),
|
||||
guardSpoke ? v.Reason.ToString() : null,
|
||||
guardSpoke ? NullIfEmpty(v.Family) : null,
|
||||
guardSpoke ? NullIfEmpty(v.Signal) : null,
|
||||
outcome.HookingTurnedOff);
|
||||
}
|
||||
|
||||
public static string FinalizeText(FinalizeStatus status) => status switch
|
||||
|
||||
@@ -105,6 +105,12 @@ public sealed class SessionEventPublisher : ISessionObserver
|
||||
t.LastSystem = drained[^1].System;
|
||||
}
|
||||
|
||||
if (progress.Hold is { } hold && t.AttachedAt is null)
|
||||
{
|
||||
Held(sessionGuid, t, hold);
|
||||
return;
|
||||
}
|
||||
|
||||
if (t.AttachedAt is null || !_pipe.HasClients)
|
||||
{
|
||||
return;
|
||||
@@ -132,21 +138,72 @@ public sealed class SessionEventPublisher : ISessionObserver
|
||||
|
||||
if (t is not null)
|
||||
{
|
||||
RecordedSessionEvents.PublishAll(_pipe, session, t.Info);
|
||||
RecordedSessionEvents.PublishAll(_pipe, session, t.Info, reasonAlreadyPublished: t.ReasonPublished);
|
||||
}
|
||||
}
|
||||
|
||||
public void Faulted(Guid sessionGuid, Exception exception)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(exception);
|
||||
Tracked? t;
|
||||
lock (_lock)
|
||||
{
|
||||
_sessions.Remove(sessionGuid);
|
||||
_sessions.Remove(sessionGuid, out t);
|
||||
Republish();
|
||||
}
|
||||
|
||||
_pipe.Publish(IpcMessageType.CaptureError,
|
||||
new CaptureErrorEvent(sessionGuid, CaptureErrorCode.SessionFaulted, $"{exception.GetType().Name}: {exception.Message}"));
|
||||
|
||||
// And the session is over (2026-09-23): without a completion the live card and the tray stayed on a session that no
|
||||
// longer ran. Nothing was stored — the .partial stays for recovery — which is what "faulted" says.
|
||||
_pipe.Publish(IpcMessageType.SessionCompleted, new SessionCompletedEvent(
|
||||
sessionGuid, SessionId: null, Vocabulary.ExitStatusText(Domain.Sessions.ExitStatus.Interrupted), t?.AttachedAt is null ? 2 : 1,
|
||||
RecordedSessionEvents.FaultedFinalize, CaptureErrorCode.SessionFaulted, t?.Info.GameId, t?.Info.GameName));
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// A held (Tier-2) session's tick (2026-09-23). The first one announces it — <c>SessionStarted</c> at tier 2 with why,
|
||||
/// and the refusal's own event now rather than when the game exits — and every one after feeds <c>SessionHeld</c> at the
|
||||
/// progress interval while a client listens. Until this date a held session sent nothing until it ended.
|
||||
/// </summary>
|
||||
private void Held(Guid sessionGuid, Tracked t, CaptureOutcome hold)
|
||||
{
|
||||
if (t.Hold is null)
|
||||
{
|
||||
SessionHold why = RecordedSessionEvents.HoldOf(hold);
|
||||
lock (_lock)
|
||||
{
|
||||
t.Hold = why;
|
||||
t.Pid = hold.TargetPid;
|
||||
Republish();
|
||||
}
|
||||
|
||||
_pipe.Publish(IpcMessageType.SessionStarted,
|
||||
new SessionStartedEvent(sessionGuid, t.Info.GameId, t.Info.GameName, hold.TargetPid, Tier: 2, t.Info.StartedAt, why));
|
||||
RecordedSessionEvents.PublishReason(_pipe, sessionGuid, hold, t.Info);
|
||||
t.ReasonPublished = true;
|
||||
}
|
||||
|
||||
if (!_pipe.HasClients)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
long now = _clock.GetTimestamp();
|
||||
if (t.LastProgress is { } last && _clock.GetElapsedTime(last, now) < _interval)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
t.LastProgress = now;
|
||||
_pipe.Publish(IpcMessageType.SessionHeld, new SessionHeldEvent(
|
||||
sessionGuid,
|
||||
Math.Max(0, (_clock.GetUtcNow() - t.Info.StartedAt).TotalSeconds),
|
||||
t.LastGpu?.TempCoreC,
|
||||
t.LastSystem.CpuTempC,
|
||||
t.LastGpu?.LoadPct,
|
||||
t.LastSystem.CpuLoadPct));
|
||||
}
|
||||
|
||||
private void PublishProgress(Guid sessionGuid, Tracked t, CaptureProgress progress, long now)
|
||||
@@ -177,7 +234,8 @@ public sealed class SessionEventPublisher : ISessionObserver
|
||||
t.Info.GameName,
|
||||
t.Pid,
|
||||
t.AttachedAt is null ? 2 : 1,
|
||||
t.AttachedAt ?? t.Info.StartedAt);
|
||||
t.AttachedAt ?? t.Info.StartedAt,
|
||||
t.AttachedAt is null ? t.Hold : null);
|
||||
}
|
||||
|
||||
Volatile.Write(ref _status, new AgentStatus(sessions));
|
||||
@@ -198,5 +256,11 @@ public sealed class SessionEventPublisher : ISessionObserver
|
||||
public GpuSample? LastGpu { get; set; }
|
||||
|
||||
public SystemReading LastSystem { get; set; }
|
||||
|
||||
/// <summary>Why a held session measures nothing; set by its first held tick (2026-09-23).</summary>
|
||||
public SessionHold? Hold { get; set; }
|
||||
|
||||
/// <summary>The refusal's event went out when the hold began, so the end does not say it again.</summary>
|
||||
public bool ReasonPublished { get; set; }
|
||||
}
|
||||
}
|
||||
@@ -34,4 +34,16 @@ public sealed record DetectionWrite
|
||||
|
||||
/// <summary>The exe mtime, unix ms, the run saw.</summary>
|
||||
public required long ExeMtimeMs { get; init; }
|
||||
|
||||
/// <summary>What the executable runs as (schema 0011); written whole, like the capability flags — a fact about a file has no user override.</summary>
|
||||
public string ExeArchitecture { get; init; } = Domain.Detection.ExecutableArchitecture.Unknown;
|
||||
|
||||
/// <summary>The executable's PE <c>FileVersion</c>, or null (written as read: a file that lost its version clears the column).</summary>
|
||||
public string? ExeFileVersion { get; init; }
|
||||
|
||||
/// <summary>The executable's PE <c>ProductVersion</c>, or null.</summary>
|
||||
public string? ExeProductVersion { get; init; }
|
||||
|
||||
/// <summary>The capability files the game ships, with their versions; written whole.</summary>
|
||||
public IReadOnlyList<Domain.Detection.LibraryFile> Libraries { get; init; } = [];
|
||||
}
|
||||
@@ -0,0 +1,63 @@
|
||||
using FrameLedger.Domain.Consent;
|
||||
|
||||
namespace FrameLedger.Application.Persistence;
|
||||
|
||||
/// <summary>
|
||||
/// Two library entries for one executable under two drive letters, and which one stays (2026-09-23, HANDOFF D26). The
|
||||
/// owner's library showed <c>H:</c> twins beside their <c>D:</c> entries for a day: a drive that changed its letter made
|
||||
/// a second entry for the same file, and once the letter changed back neither could move onto the other's path.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// <b>The entry made first stays</b> (a tie keeps the lower id): its name, notes, consent and history are the user's
|
||||
/// oldest, and the other entry's sessions join it. Nothing about consent moves from the dropped entry to the survivor —
|
||||
/// a merge can only ever carry a block or an auto-disable, which turn hooking off.
|
||||
/// </remarks>
|
||||
public sealed record GameMergePlan
|
||||
{
|
||||
public required long SurvivorId { get; init; }
|
||||
|
||||
/// <summary>Where the survivor's row says its executable is, as the plan saw it.</summary>
|
||||
public required string SurvivorPath { get; init; }
|
||||
|
||||
public required long DroppedId { get; init; }
|
||||
|
||||
/// <summary>Where the dropped row says its executable is, as the plan saw it.</summary>
|
||||
public required string DroppedPath { get; init; }
|
||||
|
||||
/// <summary>The one file both entries name: where the survivor lives after the merge, with the bytes it was found with.</summary>
|
||||
public required ExecutableFingerprint Target { get; init; }
|
||||
|
||||
/// <summary>The survivor is the entry whose file is gone, so it takes the target's path once the other row is deleted.</summary>
|
||||
public bool SurvivorMoves => !string.Equals(SurvivorPath, Target.ExePath, StringComparison.OrdinalIgnoreCase);
|
||||
|
||||
/// <summary>
|
||||
/// The plan for <paramref name="stale"/> — the entry whose file is gone — and <paramref name="owner"/>, the entry at
|
||||
/// <paramref name="target"/>'s path.
|
||||
/// </summary>
|
||||
public static GameMergePlan For(GameRow stale, GameRow owner, ExecutableFingerprint target)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(stale);
|
||||
ArgumentNullException.ThrowIfNull(owner);
|
||||
if (stale.Id == owner.Id)
|
||||
{
|
||||
throw new ArgumentException("an entry is not its own twin", nameof(owner));
|
||||
}
|
||||
|
||||
if (!string.Equals(owner.Fingerprint.ExePath, target.ExePath, StringComparison.OrdinalIgnoreCase))
|
||||
{
|
||||
throw new ArgumentException("the owner is the entry at the target's path", nameof(owner));
|
||||
}
|
||||
|
||||
bool staleStays = stale.AddedAt < owner.AddedAt || (stale.AddedAt == owner.AddedAt && stale.Id < owner.Id);
|
||||
GameRow keep = staleStays ? stale : owner;
|
||||
GameRow drop = staleStays ? owner : stale;
|
||||
return new GameMergePlan
|
||||
{
|
||||
SurvivorId = keep.Id,
|
||||
SurvivorPath = keep.Fingerprint.ExePath,
|
||||
DroppedId = drop.Id,
|
||||
DroppedPath = drop.Fingerprint.ExePath,
|
||||
Target = target,
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -1,4 +1,5 @@
|
||||
using FrameLedger.Domain.Consent;
|
||||
using FrameLedger.Domain.Detection;
|
||||
using FrameLedger.Domain.Metrics;
|
||||
|
||||
namespace FrameLedger.Application.Persistence;
|
||||
@@ -78,5 +79,46 @@ public sealed record GameRow
|
||||
/// <summary>FR-1.4: set when the user removed the game but kept its sessions; such a row is not in the library.</summary>
|
||||
public DateTimeOffset? RemovedAt { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// Whether FrameLedger watches for this program at all (schema 0009, 2026-09-23): off, it records no session, measures
|
||||
/// nothing and injects nothing when the program runs — a utility that starts with Windows, say. The user's switch, on
|
||||
/// by default; entries an old import made for Steam's own tools start with it off.
|
||||
/// </summary>
|
||||
public bool RecordSessions { get; init; } = true;
|
||||
|
||||
/// <summary>
|
||||
/// The rules version the Agent's pre-scan of the library last scanned this entry under (schema 0010, 2026-09-25);
|
||||
/// null when it never has. With the two below, the pre-scan's own key — a different value is a re-scan.
|
||||
/// </summary>
|
||||
public string? HookPrescanRulesVersion { get; init; }
|
||||
|
||||
/// <summary>The executable's size when the pre-scan last scanned it (schema 0010).</summary>
|
||||
public long? HookPrescanExeSizeBytes { get; init; }
|
||||
|
||||
/// <summary>The executable's mtime (unix ms) when the pre-scan last scanned it (schema 0010).</summary>
|
||||
public long? HookPrescanExeMtimeMs { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// What the executable runs as (schema 0011, 2026-09-25; <see cref="ExecutableArchitecture"/>): written by the detection
|
||||
/// sweep from its PE headers. Null when this build has not looked yet; <c>unknown</c> when it looked and could not tell.
|
||||
/// </summary>
|
||||
public string? ExeMachine { get; init; }
|
||||
|
||||
/// <summary>The executable's PE <c>FileVersion</c> (schema 0011) — the file's word, not the store's (<see cref="GameVersion"/>).</summary>
|
||||
public string? ExeFileVersion { get; init; }
|
||||
|
||||
/// <summary>The executable's PE <c>ProductVersion</c> (schema 0011).</summary>
|
||||
public string? ExeProductVersion { get; init; }
|
||||
|
||||
/// <summary>The capability files the game ships, with their versions (schema 0011, <c>library_versions</c>); empty when none or never looked.</summary>
|
||||
public IReadOnlyList<LibraryFile> Libraries { get; init; } = [];
|
||||
|
||||
public bool InLibrary => RemovedAt is null;
|
||||
|
||||
/// <summary>
|
||||
/// A guard finding about this game is on the row (<c>19_SAFETY</c> §What a finding does to the game): its hooking is
|
||||
/// off and nothing clears it. Every block a guard wrote is a finding since 2026-09-22 — a scan that could not answer
|
||||
/// is <c>'unverified'</c>, never <c>'blocked'</c>.
|
||||
/// </summary>
|
||||
public bool BlockedByGuard => HookBlockedReason is not null || string.Equals(HookPrescanState, "blocked", StringComparison.Ordinal);
|
||||
}
|
||||
@@ -0,0 +1,17 @@
|
||||
namespace FrameLedger.Application.Persistence;
|
||||
|
||||
/// <summary>
|
||||
/// The one write that folds two library entries into one (2026-09-23, HANDOFF D26). The Agent's — its relocator is the
|
||||
/// only caller — because it moves sessions, which are the Agent's rows (<c>06_DATA_MODEL</c> §Writer ownership).
|
||||
/// </summary>
|
||||
public interface IGameMerge
|
||||
{
|
||||
/// <summary>
|
||||
/// Folds <see cref="GameMergePlan.DroppedId"/> into <see cref="GameMergePlan.SurvivorId"/> in one transaction: the
|
||||
/// dropped entry's sessions re-parented, any block or auto-disable it carried kept (hooking off), its crash count
|
||||
/// added, the row deleted, and the survivor at the target path. Null — nothing written — when either row is not what
|
||||
/// the plan saw: gone, removed from the library, at another path, or (for a survivor that moves) no longer holding the
|
||||
/// target's bytes. Otherwise the number of sessions that moved.
|
||||
/// </summary>
|
||||
ValueTask<int?> MergeAsync(GameMergePlan plan, CancellationToken ct = default);
|
||||
}
|
||||
@@ -62,6 +62,13 @@ public interface IGameRepository
|
||||
/// </summary>
|
||||
ValueTask<bool> RemoveAsync(long gameId, bool keepSessions, CancellationToken ct = default);
|
||||
|
||||
/// <summary>
|
||||
/// The user's recording switch (schema 0009, 2026-09-23): off, the Agent does not watch for the program — no session,
|
||||
/// no measurement, no injection — and a session of it that is running stops at its next tick. The UI's write; false
|
||||
/// when no row has that id.
|
||||
/// </summary>
|
||||
ValueTask<bool> SetRecordingAsync(long gameId, bool record, CancellationToken ct = default);
|
||||
|
||||
/// <summary>
|
||||
/// The Agent's detection sweep (P4 PR-1): persist one static detection run under the provenance rule of
|
||||
/// <c>05_DETECTION</c> §Caching — a <c>user</c> field is never overwritten, a <c>detected</c> one is refreshed, an
|
||||
|
||||
@@ -20,6 +20,13 @@ public interface IPartialSessionStore
|
||||
/// <summary>Removes the file; a missing file is not an error.</summary>
|
||||
void Delete(Guid sessionGuid);
|
||||
|
||||
/// <summary>
|
||||
/// The entries every pending file's header names (2026-09-23) — the sessions still running and those waiting to be
|
||||
/// recovered. What a merge of two entries waits for: a session re-keyed under a deleted entry would be dropped. Read
|
||||
/// beside a running session's writer; a file whose header cannot be read names nothing.
|
||||
/// </summary>
|
||||
IReadOnlySet<long> PendingGameIds();
|
||||
|
||||
/// <summary>
|
||||
/// Sets the file aside as <c><guid>.partial.failed</c> (2026-09-23): out of <see cref="ListPending"/>, never
|
||||
/// retried, kept for a bug report. What recovery does with a file it could not finalize, so that one bad file cannot
|
||||
|
||||
@@ -40,6 +40,18 @@ public static class SettingsRegistry
|
||||
Default = "0",
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// Whether a game the guard found anti-cheat in shows its Hooking card, or only the finding (beta.8, owner request
|
||||
/// 2026-09-25). On by default: the card's switch can never be turned on for such a game, so hiding it leaves the
|
||||
/// finding — which is always shown (FR-2.2) — and nothing that looks usable.
|
||||
/// </summary>
|
||||
public static readonly SettingDefinition UiHideAntiCheatHooking = new()
|
||||
{
|
||||
Key = "ui.hide_anticheat_hooking",
|
||||
Kind = SettingKind.Boolean,
|
||||
Default = "1",
|
||||
};
|
||||
|
||||
/// <summary>Whether the Agent's watcher records tracked games that the App did not launch (FR-3.1/FR-3.3).</summary>
|
||||
public static readonly SettingDefinition CaptureBackground = new()
|
||||
{
|
||||
@@ -127,7 +139,7 @@ public static class SettingsRegistry
|
||||
/// <summary>Every definition, in the order <c>06_DATA_MODEL</c> lists them.</summary>
|
||||
public static IReadOnlyList<SettingDefinition> All { get; } =
|
||||
[
|
||||
UiLanguage, UiTheme, UiStartWithWindows, UiMinimizeToTray,
|
||||
UiLanguage, UiTheme, UiStartWithWindows, UiMinimizeToTray, UiHideAntiCheatHooking,
|
||||
CaptureBackground, HookingKillSwitch, CaptureMinSessionSeconds, TelemetryIntervalMs, RetentionRawSessionsPerGame,
|
||||
UpdateChannel, UpdateAutoCheck, PrivacyOnlineMetadata, LogDebug,
|
||||
];
|
||||
|
||||
@@ -124,10 +124,15 @@ public sealed class CaptureOrchestrator
|
||||
await DrainRunningAsync().ConfigureAwait(false);
|
||||
}
|
||||
|
||||
/// <summary>One tick: snapshot, diff, start what appeared, report what finished.</summary>
|
||||
/// <summary>
|
||||
/// One tick: snapshot, diff, start what appeared, report what finished. An entry whose recording is off (schema 0009,
|
||||
/// 2026-09-23) is not watched at all — its program runs unobserved — and a session of it still running stops.
|
||||
/// </summary>
|
||||
public async Task<IReadOnlyList<WatchEvent>> PollOnceAsync(CancellationToken ct)
|
||||
{
|
||||
IReadOnlyList<GameRow> watchlist = await _games.ListAsync(ct).ConfigureAwait(false);
|
||||
IReadOnlyList<GameRow> library = await _games.ListAsync(ct).ConfigureAwait(false);
|
||||
StopUnrecorded(library);
|
||||
IReadOnlyList<GameRow> watchlist = Recorded(library);
|
||||
IReadOnlyList<ProcessSnapshot> snapshot = _processes.Take();
|
||||
_latest?.Publish(snapshot);
|
||||
IReadOnlyList<WatchEvent> events = _watcher.Poll(snapshot, watchlist);
|
||||
@@ -166,6 +171,35 @@ public sealed class CaptureOrchestrator
|
||||
return events;
|
||||
}
|
||||
|
||||
/// <summary>The entries FrameLedger watches for: the library minus those whose recording the user switched off.</summary>
|
||||
private static List<GameRow> Recorded(IReadOnlyList<GameRow> library) => [.. library.Where(static g => g.RecordSessions)];
|
||||
|
||||
/// <summary>
|
||||
/// A session whose entry's recording was switched off while it ran stops at its next tick (2026-09-23): "off" is about
|
||||
/// now, not the next launch — Borderless Gaming starts with Windows and runs until shutdown. Asked once per session; the
|
||||
/// loop's own stop path ends it as a user stop and saves what it had, as <c>StopSession</c> does.
|
||||
/// </summary>
|
||||
private void StopUnrecorded(IReadOnlyList<GameRow> library)
|
||||
{
|
||||
HashSet<long> off = [.. library.Where(static g => !g.RecordSessions).Select(static g => g.Id)];
|
||||
if (off.Count == 0)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
lock (_table)
|
||||
{
|
||||
foreach (Running r in _running.Values)
|
||||
{
|
||||
if (off.Contains(r.GameId) && !r.Task.IsCompleted && !r.Stop.IsCancellationRequested)
|
||||
{
|
||||
r.Stop.Cancel();
|
||||
_log($"session {r.SessionGuid:N}: recording was turned off for its entry; the loop ends at its next tick");
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// <c>StopSession</c> (P3 PR-1b): ask the session with this guid to end at its next tick. False when no running
|
||||
/// session started here carries it — an elected session after a launch, or a console capture, is not addressable.
|
||||
@@ -208,6 +242,11 @@ public sealed class CaptureOrchestrator
|
||||
return LaunchResult.Of(LaunchOutcome.UnknownGame);
|
||||
}
|
||||
|
||||
if (!game.RecordSessions)
|
||||
{
|
||||
return LaunchResult.Of(LaunchOutcome.RecordingOff);
|
||||
}
|
||||
|
||||
string path = game.Fingerprint.ExePath;
|
||||
lock (_table)
|
||||
{
|
||||
@@ -238,7 +277,7 @@ public sealed class CaptureOrchestrator
|
||||
return null;
|
||||
}
|
||||
|
||||
IReadOnlyList<GameRow> watchlist = await _games.ListAsync(ct).ConfigureAwait(false);
|
||||
IReadOnlyList<GameRow> watchlist = Recorded(await _games.ListAsync(ct).ConfigureAwait(false));
|
||||
HashSet<string> tracked = new(watchlist.Select(static g => g.Fingerprint.ExePath), StringComparer.OrdinalIgnoreCase);
|
||||
ProcessSnapshot? elected = DescendantElection.Elect(_processes.Take(), launched.Outcome.TargetPid, tracked.Contains);
|
||||
if (elected is not { ImagePath: { } path })
|
||||
|
||||
@@ -25,6 +25,15 @@ namespace FrameLedger.Application.Watch;
|
||||
/// (<see cref="IsDriveLetterTwin"/>), and exactly one such file with the row's bytes.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// <b>Two more answers since the same day (HANDOFF D26, D27).</b> When the only file at the row's path under another
|
||||
/// letter has OTHER bytes — the game was updated while the drive had another letter — the row follows it the way
|
||||
/// <i>Change executable</i> does: hooking off, consent cleared, the block kept (D27). And when the file the row
|
||||
/// would move to already has an entry of its own — a twin made while the letter was different — and it is the same
|
||||
/// bytes the row recorded, the two entries become one (<see cref="IGameMerge"/>, D26): the entry made first stays,
|
||||
/// the other's sessions join it, a block or auto-disable either carried is kept, and no consent moves between them.
|
||||
/// A merge waits while a session of either entry runs or waits to be recovered (<c>busy</c>).
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// <b>Three callers, one rule.</b> The 15 s sweep (a missing executable), the watcher (a process running from a path
|
||||
/// that is not the row's while the row's is gone) and the enable-hooking command (the same, when the user clicks). No
|
||||
/// caller opens a process; this reads files. A refusal is logged once per row until it changes — the owner's log
|
||||
@@ -38,6 +47,8 @@ public sealed class ExecutableRelocator
|
||||
private readonly Func<IReadOnlyList<string>> _roots;
|
||||
private readonly Action<string> _log;
|
||||
private readonly TimeProvider _clock;
|
||||
private readonly IGameMerge? _merge;
|
||||
private readonly Func<long, bool> _busy;
|
||||
private readonly Lock _logged = new();
|
||||
private readonly Dictionary<long, string> _lastLine = [];
|
||||
|
||||
@@ -47,13 +58,18 @@ public sealed class ExecutableRelocator
|
||||
/// <param name="roots">The mounted volumes' roots (<c>C:\</c>, <c>H:\</c>, …); an adapter's, so a test can name its own.</param>
|
||||
/// <param name="log">The Agent's log line.</param>
|
||||
/// <param name="clock">The row's <c>updated_at</c>.</param>
|
||||
public ExecutableRelocator(IGameRepository games, IExecutableIdentitySource identity, Func<IReadOnlyList<string>> roots, Action<string> log, TimeProvider? clock = null)
|
||||
/// <param name="merge">Folds a twin entry into its other half (D26); null never merges.</param>
|
||||
/// <param name="busy">Whether a session of the entry runs or waits to be recovered; a merge waits for it. Null is never busy.</param>
|
||||
public ExecutableRelocator(IGameRepository games, IExecutableIdentitySource identity, Func<IReadOnlyList<string>> roots, Action<string> log, TimeProvider? clock = null,
|
||||
IGameMerge? merge = null, Func<long, bool>? busy = null)
|
||||
{
|
||||
_games = games ?? throw new ArgumentNullException(nameof(games));
|
||||
_identity = identity ?? throw new ArgumentNullException(nameof(identity));
|
||||
_roots = roots ?? throw new ArgumentNullException(nameof(roots));
|
||||
_log = log ?? throw new ArgumentNullException(nameof(log));
|
||||
_clock = clock ?? TimeProvider.System;
|
||||
_merge = merge;
|
||||
_busy = busy ?? (static _ => false);
|
||||
}
|
||||
|
||||
/// <summary>The same path under each other drive-letter root; empty for a path that is not a drive-letter path (UNC).</summary>
|
||||
@@ -96,8 +112,10 @@ public sealed class ExecutableRelocator
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// The row's executable is gone from its path: find it under another root and move the row. Null when the file is
|
||||
/// still where the row says, when no other root has it, or when more than one does.
|
||||
/// The row's executable is gone from its path: find it under another root and move the row — or follow it with
|
||||
/// hooking off when its bytes changed (D27), or merge the row into the entry that already holds that path (D26).
|
||||
/// The row's executable as it now is, when the row still exists and moved; null when the file is still where the row
|
||||
/// says, when no other root has it, when more than one does, and when the row was merged into the other entry.
|
||||
/// </summary>
|
||||
public async ValueTask<ExecutableFingerprint?> TryRelocateAsync(GameRow row, CancellationToken ct = default)
|
||||
{
|
||||
@@ -108,21 +126,28 @@ public sealed class ExecutableRelocator
|
||||
return null;
|
||||
}
|
||||
|
||||
List<ExecutableFingerprint> found = SameBytesUnder(row, Candidates(row.Fingerprint.ExePath, _roots()), ct);
|
||||
if (found.Count > 1)
|
||||
List<ExecutableFingerprint> onDisk = Existing(Candidates(row.Fingerprint.ExePath, _roots()), ct);
|
||||
List<ExecutableFingerprint> same = [.. onDisk.Where(f => SameBytes(row.Fingerprint, f))];
|
||||
if (same.Count == 1)
|
||||
{
|
||||
LogOnce(row.Id, $"relocate: {row.Name} — {found.Count} drives hold {row.Fingerprint.ExePath[2..]} with the same size and mtime; not guessing which");
|
||||
return await MoveAsync(row, same[0], ct).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
if (same.Count > 1 || onDisk.Count > 1)
|
||||
{
|
||||
LogAmbiguous(row, onDisk.Count, sameBytes: same.Count > 1);
|
||||
return null;
|
||||
}
|
||||
|
||||
return found.Count == 1 ? await MoveAsync(row, found[0], ct).ConfigureAwait(false) : null;
|
||||
return onDisk.Count == 1 ? await FollowChangedAsync(row, onDisk[0], ct).ConfigureAwait(false) : null;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// The watcher saw the game run from <paramref name="observedPath"/>, not the row's path (a file-name match). When the
|
||||
/// row's file is gone, the running one is the row's path with only its drive letter changed, and it is the only file
|
||||
/// there with the row's size and mtime, it is the row's executable on a drive that changed its letter: move the row, so
|
||||
/// the session is the row's and its consent applies. False otherwise — including when both files exist, which is two
|
||||
/// row's file is gone and the running one is the row's path with only its drive letter changed, it is the row's
|
||||
/// executable on a drive that changed its letter: the row moves to it — with everything kept when it is the only file
|
||||
/// there with the row's size and mtime, or with hooking off when it is the only file there at all and its bytes
|
||||
/// changed (D27) — so the session is the row's. False otherwise — including when both files exist, which is two
|
||||
/// copies, not a move, and when the running file is in another folder, which is another game (2026-09-23).
|
||||
/// </summary>
|
||||
public async ValueTask<bool> TryAdoptAsync(GameRow row, string observedPath, CancellationToken ct = default)
|
||||
@@ -131,22 +156,33 @@ public sealed class ExecutableRelocator
|
||||
ArgumentException.ThrowIfNullOrWhiteSpace(observedPath);
|
||||
if (!IsDriveLetterTwin(row.Fingerprint.ExePath, observedPath)
|
||||
|| _identity.Read(row.Fingerprint.ExePath) is not null
|
||||
|| _identity.Read(observedPath) is not { } onDisk
|
||||
|| !SameBytes(row.Fingerprint, onDisk))
|
||||
|| _identity.Read(observedPath) is not { } running)
|
||||
{
|
||||
return false;
|
||||
}
|
||||
|
||||
// The running file's own drive is mounted by definition; the rest of the list may not know it yet.
|
||||
List<string> roots = [.. _roots(), observedPath[..3]];
|
||||
List<ExecutableFingerprint> found = SameBytesUnder(row, Candidates(row.Fingerprint.ExePath, roots), ct);
|
||||
if (found.Count != 1)
|
||||
List<ExecutableFingerprint> onDisk = Existing(Candidates(row.Fingerprint.ExePath, roots), ct);
|
||||
int same = onDisk.Count(f => SameBytes(row.Fingerprint, f));
|
||||
if (SameBytes(row.Fingerprint, running))
|
||||
{
|
||||
LogOnce(row.Id, $"relocate: {row.Name} — {found.Count} drives hold {row.Fingerprint.ExePath[2..]} with the same size and mtime; not guessing which");
|
||||
if (same != 1)
|
||||
{
|
||||
LogAmbiguous(row, onDisk.Count, sameBytes: true);
|
||||
return false;
|
||||
}
|
||||
|
||||
return await MoveAsync(row, running, ct).ConfigureAwait(false) is not null;
|
||||
}
|
||||
|
||||
if (same > 0 || onDisk.Count != 1)
|
||||
{
|
||||
LogAmbiguous(row, onDisk.Count, sameBytes: same > 1);
|
||||
return false;
|
||||
}
|
||||
|
||||
return await MoveAsync(row, onDisk, ct).ConfigureAwait(false) is not null;
|
||||
return await FollowChangedAsync(row, running, ct).ConfigureAwait(false) is not null;
|
||||
}
|
||||
|
||||
private static bool IsDriveLetterPath(string path) =>
|
||||
@@ -155,13 +191,13 @@ public sealed class ExecutableRelocator
|
||||
private static bool SameBytes(ExecutableFingerprint stored, ExecutableFingerprint onDisk) =>
|
||||
stored.SizeBytes == onDisk.SizeBytes && stored.MtimeUnixMs == onDisk.MtimeUnixMs;
|
||||
|
||||
private List<ExecutableFingerprint> SameBytesUnder(GameRow row, IReadOnlyList<string> candidates, CancellationToken ct)
|
||||
private List<ExecutableFingerprint> Existing(IReadOnlyList<string> candidates, CancellationToken ct)
|
||||
{
|
||||
List<ExecutableFingerprint> found = [];
|
||||
foreach (string candidate in candidates)
|
||||
{
|
||||
ct.ThrowIfCancellationRequested();
|
||||
if (_identity.Read(_identity.Normalise(candidate)) is { } onDisk && SameBytes(row.Fingerprint, onDisk))
|
||||
if (_identity.Read(_identity.Normalise(candidate)) is { } onDisk)
|
||||
{
|
||||
found.Add(onDisk);
|
||||
}
|
||||
@@ -170,6 +206,9 @@ public sealed class ExecutableRelocator
|
||||
return found;
|
||||
}
|
||||
|
||||
private void LogAmbiguous(GameRow row, int drives, bool sameBytes) =>
|
||||
LogOnce(row.Id, $"relocate: {row.Name} — {drives} drives hold {row.Fingerprint.ExePath[2..]}{(sameBytes ? " with the same size and mtime" : string.Empty)}; not guessing which");
|
||||
|
||||
private async ValueTask<ExecutableFingerprint?> MoveAsync(GameRow row, ExecutableFingerprint moved, CancellationToken ct)
|
||||
{
|
||||
bool done = await _games.RelocateExecutableAsync(row.Id, moved, _clock.GetUtcNow(), ct).ConfigureAwait(false);
|
||||
@@ -180,10 +219,71 @@ public sealed class ExecutableRelocator
|
||||
return moved;
|
||||
}
|
||||
|
||||
// Refused: another row owns that path, or this one changed underneath. The first, when that row is in the library,
|
||||
// is a twin made while the letter was different (D26).
|
||||
if (_merge is not null && await _games.FindAsync(moved.ExePath, ct).ConfigureAwait(false) is { InLibrary: true } owner && owner.Id != row.Id)
|
||||
{
|
||||
return await MergeAsync(row, owner, moved, ct).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
LogOnce(row.Id, $"relocate: {row.Name} — {moved.ExePath} has the row's size and mtime but the row could not be moved (another row owns that path, or the row changed underneath)");
|
||||
return null;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// D27 (owner, 2026-09-23): the row's file is gone and the only file at its path under another letter has other bytes
|
||||
/// — the game was updated while the drive had another letter. The row follows it as <i>Change executable</i> does
|
||||
/// (<see cref="IGameRepository.ChangeExecutableAsync"/>): hooking off, consent cleared, the block kept — a downgrade by
|
||||
/// construction, never a grant.
|
||||
/// </summary>
|
||||
private async ValueTask<ExecutableFingerprint?> FollowChangedAsync(GameRow row, ExecutableFingerprint changed, CancellationToken ct)
|
||||
{
|
||||
if (await _games.ChangeExecutableAsync(row.Id, changed, _clock.GetUtcNow(), ct).ConfigureAwait(false))
|
||||
{
|
||||
Forget(row.Id);
|
||||
_log($"relocate: {row.Name} — executable moved {row.Fingerprint.ExePath} → {changed.ExePath} and changed since the entry recorded it "
|
||||
+ "(other size or mtime); the entry follows it with hooking OFF, consent cleared, any block kept — turn hooking on again to measure it");
|
||||
return changed;
|
||||
}
|
||||
|
||||
// Not merged: other bytes are not proof that the entry holding that path is this one's game (D26 merges the same bytes only).
|
||||
LogOnce(row.Id, await _games.FindAsync(changed.ExePath, ct).ConfigureAwait(false) is { } owner && owner.Id != row.Id
|
||||
? $"relocate: {row.Name} — its executable is now {changed.ExePath}, which the entry '{owner.Name}' already holds, and the file there is not "
|
||||
+ "the one this entry recorded, so the two are not merged; remove the entry you do not want"
|
||||
: $"relocate: {row.Name} — {changed.ExePath} could not be followed (the row changed underneath)");
|
||||
return null;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// D26 (owner, 2026-09-23): <paramref name="stale"/>'s file is gone and <paramref name="owner"/> is the entry at the
|
||||
/// same file under another letter, with the bytes <paramref name="stale"/> recorded: one executable, two entries. They
|
||||
/// become one unless a session of either is running or waiting to be recovered.
|
||||
/// </summary>
|
||||
private async ValueTask<ExecutableFingerprint?> MergeAsync(GameRow stale, GameRow owner, ExecutableFingerprint target, CancellationToken ct)
|
||||
{
|
||||
if (_busy(stale.Id) || _busy(owner.Id))
|
||||
{
|
||||
LogOnce(stale.Id, $"relocate: {stale.Name} and {owner.Name} are one executable ({target.ExePath}) under two drive letters; "
|
||||
+ "they are merged once no session of either is running or waiting to be recovered");
|
||||
return null;
|
||||
}
|
||||
|
||||
GameMergePlan plan = GameMergePlan.For(stale, owner, target);
|
||||
if (await _merge!.MergeAsync(plan, ct).ConfigureAwait(false) is not { } sessions)
|
||||
{
|
||||
LogOnce(stale.Id, $"relocate: {stale.Name} — not merged with {owner.Name} (one of the two entries changed underneath); the next pass looks again");
|
||||
return null;
|
||||
}
|
||||
|
||||
Forget(stale.Id);
|
||||
Forget(owner.Id);
|
||||
(GameRow keep, GameRow drop) = plan.SurvivorId == stale.Id ? (stale, owner) : (owner, stale);
|
||||
_log($"relocate: merged — '{drop.Name}' ({drop.Fingerprint.ExePath}) and '{keep.Name}' ({keep.Fingerprint.ExePath}) are one executable under two "
|
||||
+ $"drive letters; '{keep.Name}' stays, at {target.ExePath}, with {sessions} session(s) moved to it"
|
||||
+ (drop.HookBlockedReason is not null && keep.HookBlockedReason is null ? ", and the other entry's block" : string.Empty));
|
||||
return plan.SurvivorMoves ? target : null;
|
||||
}
|
||||
|
||||
/// <summary>The same refusal about the same row is said once, until something about it changes.</summary>
|
||||
private void LogOnce(long rowId, string line)
|
||||
{
|
||||
|
||||
@@ -17,4 +17,7 @@ public enum LaunchOutcome
|
||||
|
||||
/// <summary>This orchestrator was composed without launch mode (the console's election-only instance, or a test).</summary>
|
||||
Unavailable,
|
||||
|
||||
/// <summary>The entry's recording is switched off (schema 0009, 2026-09-23): FrameLedger does not start what it will not record.</summary>
|
||||
RecordingOff,
|
||||
}
|
||||
@@ -0,0 +1,82 @@
|
||||
namespace FrameLedger.Domain.Detection;
|
||||
|
||||
/// <summary>
|
||||
/// What an executable runs as (beta.8, <c>games.exe_machine</c>), from its PE headers: the COFF machine, and for a .NET
|
||||
/// executable its CLR header's flags. The ids are stored, so they never change meaning.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// A .NET executable built "AnyCPU" carries an x86 COFF machine and runs as whatever process the OS starts — a 64-bit one
|
||||
/// on 64-bit Windows — unless it prefers 32-bit (<c>COMIMAGE_FLAGS_32BITPREFERRED</c>) or requires it
|
||||
/// (<c>COMIMAGE_FLAGS_32BITREQUIRED</c>, which is plain x86). Reading only the machine would call every FNA or MonoGame
|
||||
/// title 32-bit.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// FrameLedger's hook is an x64 DLL loaded with <c>LoadLibraryW</c> (CLAUDE.md rule 3): it can run in an x64 process and in
|
||||
/// nothing else. <see cref="IsKnownNotHookable"/> names the ids for which that is known before the game ever runs; an id
|
||||
/// this build could not establish is not one of them — the guard's own <c>TargetIsWow64</c> at a session's start stays
|
||||
/// the check.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public static class ExecutableArchitecture
|
||||
{
|
||||
/// <summary>AMD64: the one architecture the hook runs in.</summary>
|
||||
public const string X64 = "x64";
|
||||
|
||||
/// <summary>I386, native (or .NET requiring 32-bit): a WOW64 process on 64-bit Windows.</summary>
|
||||
public const string X86 = "x86";
|
||||
|
||||
/// <summary>ARM64: a native ARM process, which an x64 DLL cannot enter.</summary>
|
||||
public const string Arm64 = "arm64";
|
||||
|
||||
/// <summary>ARMv7 (Thumb-2).</summary>
|
||||
public const string Arm = "arm";
|
||||
|
||||
/// <summary>.NET, IL only: runs as a 64-bit process on 64-bit Windows.</summary>
|
||||
public const string AnyCpu = "anycpu";
|
||||
|
||||
/// <summary>.NET, IL only, 32-bit preferred: runs as a 32-bit process.</summary>
|
||||
public const string AnyCpu32 = "anycpu32";
|
||||
|
||||
/// <summary>A PE whose machine this build does not name.</summary>
|
||||
public const string Other = "other";
|
||||
|
||||
/// <summary>Looked at, and not a PE this build could read: stored so the sweep does not look again every pass.</summary>
|
||||
public const string Unknown = "unknown";
|
||||
|
||||
public const ushort MachineI386 = 0x014C;
|
||||
|
||||
public const ushort MachineAmd64 = 0x8664;
|
||||
|
||||
public const ushort MachineArm64 = 0xAA64;
|
||||
|
||||
public const ushort MachineArmNt = 0x01C4;
|
||||
|
||||
/// <summary><c>COMIMAGE_FLAGS_ILONLY</c>.</summary>
|
||||
public const uint ClrIlOnly = 0x0000_0001;
|
||||
|
||||
/// <summary><c>COMIMAGE_FLAGS_32BITREQUIRED</c>.</summary>
|
||||
public const uint Clr32BitRequired = 0x0000_0002;
|
||||
|
||||
/// <summary><c>COMIMAGE_FLAGS_32BITPREFERRED</c> (with 32BITREQUIRED clear it means "AnyCPU, prefer 32-bit").</summary>
|
||||
public const uint Clr32BitPreferred = 0x0002_0000;
|
||||
|
||||
/// <summary>The id for a COFF machine and, when the PE carries a CLR header, its flags (null for a native PE).</summary>
|
||||
public static string Of(ushort machine, uint? clrFlags) => machine switch
|
||||
{
|
||||
MachineAmd64 => X64,
|
||||
MachineArm64 => Arm64,
|
||||
MachineArmNt => Arm,
|
||||
MachineI386 when clrFlags is { } f && (f & ClrIlOnly) != 0 && (f & Clr32BitRequired) == 0
|
||||
=> (f & Clr32BitPreferred) != 0 ? AnyCpu32 : AnyCpu,
|
||||
MachineI386 => X86,
|
||||
_ => Other,
|
||||
};
|
||||
|
||||
/// <summary>Known, before the game runs, to be a process the x64 hook cannot enter.</summary>
|
||||
public static bool IsKnownNotHookable(string? id) =>
|
||||
string.Equals(id, X86, StringComparison.Ordinal)
|
||||
|| string.Equals(id, AnyCpu32, StringComparison.Ordinal)
|
||||
|| string.Equals(id, Arm64, StringComparison.Ordinal)
|
||||
|| string.Equals(id, Arm, StringComparison.Ordinal);
|
||||
}
|
||||
@@ -118,4 +118,16 @@ public sealed record GameFileSnapshot
|
||||
/// (<c>17_HOOK_ENGINE</c> §Vulkan).
|
||||
/// </summary>
|
||||
public bool? VulkanLoaderReferenced { get; init; }
|
||||
|
||||
/// <summary>
|
||||
/// What the executable runs as (<see cref="ExecutableArchitecture"/>), from its PE headers; <see cref="ExecutableArchitecture.Unknown"/>
|
||||
/// when they could not be read (beta.8). A fact about the file, not a rule signal.
|
||||
/// </summary>
|
||||
public string ExeArchitecture { get; init; } = ExecutableArchitecture.Unknown;
|
||||
|
||||
/// <summary>
|
||||
/// The files a capability rule names that the walk listed, with the versions their PE resources state (beta.8): what
|
||||
/// the game ships, never what it loaded. Empty when none matched or no rule names a file.
|
||||
/// </summary>
|
||||
public IReadOnlyList<LibraryFile> Libraries { get; init; } = [];
|
||||
}
|
||||
@@ -0,0 +1,17 @@
|
||||
namespace FrameLedger.Domain.Detection;
|
||||
|
||||
/// <summary>
|
||||
/// One file a game ships that a capability rule names — <c>nvngx_dlss.dll</c>, <c>sl.interposer.dll</c>,
|
||||
/// <c>ffx_fsr2_api_x64.dll</c>, <c>libxess.dll</c> — with the version its PE resource states (beta.8,
|
||||
/// <c>games.library_versions</c>). What the game SHIPS, read from disk: a driver or the NVIDIA App can load another copy
|
||||
/// at run time, which is <c>sessions.runtime_modules</c>' to say.
|
||||
/// </summary>
|
||||
/// <param name="CapabilityId">The capability rule that named the file (<c>dlss</c>, <c>fsr</c>, …).</param>
|
||||
/// <param name="RelativePath">The file under the install root, forward-slashed.</param>
|
||||
/// <param name="FileVersion">The numeric file version (<c>3.7.10.0</c>), or null when the file carries none or could not be read.</param>
|
||||
/// <param name="ProductVersion">The product version string as the file states it, or null.</param>
|
||||
public sealed record LibraryFile(string CapabilityId, string RelativePath, string? FileVersion, string? ProductVersion)
|
||||
{
|
||||
/// <summary>The file's name without its folders.</summary>
|
||||
public string FileName => RelativePath[(RelativePath.LastIndexOf('/') + 1)..];
|
||||
}
|
||||
@@ -272,7 +272,7 @@ public sealed class RuleEvaluator
|
||||
{
|
||||
foreach (string e in entries)
|
||||
{
|
||||
if (GlobMatch(pattern, e) || GlobMatch(pattern, LeafOf(e)))
|
||||
if (NamesFile(pattern, e))
|
||||
{
|
||||
return SignalOutcome.Match;
|
||||
}
|
||||
@@ -283,6 +283,18 @@ public sealed class RuleEvaluator
|
||||
return listingComplete ? SignalOutcome.NoMatch : SignalOutcome.Unknown;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Whether a file signal's glob names <paramref name="relativeFile"/> — its whole relative path or its file name, as
|
||||
/// a <c>file_exists</c> signal matches. The probe asks it which shipped files a capability rule names, to read their
|
||||
/// versions (beta.8, <see cref="LibraryFile"/>).
|
||||
/// </summary>
|
||||
public static bool NamesFile(string pattern, string relativeFile)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(pattern);
|
||||
ArgumentNullException.ThrowIfNull(relativeFile);
|
||||
return GlobMatch(pattern, relativeFile) || GlobMatch(pattern, LeafOf(relativeFile));
|
||||
}
|
||||
|
||||
private static string LeafOf(string path)
|
||||
{
|
||||
int slash = path.LastIndexOf('/');
|
||||
|
||||
@@ -7,8 +7,10 @@ namespace FrameLedger.Domain.Detection;
|
||||
/// It holds signals, never groups. The schema forbids nesting in v2
|
||||
/// (<c>maxProperties: 1</c> plus its own <c>$comment</c>), so that constraint is
|
||||
/// expressed as a type here rather than as a validation rule someone has to
|
||||
/// remember. It is also why two <c>05_DETECTION</c> engine rows — both RPG Maker
|
||||
/// variants — cannot be expressed at all in this schema version.
|
||||
/// remember. This remark used to say it is why both RPG Maker rows could not be
|
||||
/// expressed; since 2026-09-16 both are, without nesting (<c>05_DETECTION</c>
|
||||
/// §Engine signatures), and FromSoftware's two archive halves are one <c>all</c>
|
||||
/// group (2026-09-23).
|
||||
/// </remarks>
|
||||
public sealed record SignalGroup
|
||||
{
|
||||
|
||||
@@ -50,6 +50,18 @@ public sealed record StaticDetectionResult
|
||||
/// <summary>The capability id the sweep stores for <see cref="UsesVulkan"/>; not a rule id, and not in the rules file.</summary>
|
||||
public const string VulkanCapabilityId = "vulkan";
|
||||
|
||||
/// <summary>What the executable runs as (<see cref="ExecutableArchitecture"/>) — a fact about the file (beta.8).</summary>
|
||||
public string ExeArchitecture { get; init; } = ExecutableArchitecture.Unknown;
|
||||
|
||||
/// <summary>The executable's PE <c>FileVersion</c>, or null. For an Unreal title it is often the ENGINE's version.</summary>
|
||||
public string? ExeFileVersion { get; init; }
|
||||
|
||||
/// <summary>The executable's PE <c>ProductVersion</c>, or null.</summary>
|
||||
public string? ExeProductVersion { get; init; }
|
||||
|
||||
/// <summary>The capability files the game ships, with their versions (<see cref="GameFileSnapshot.Libraries"/>).</summary>
|
||||
public IReadOnlyList<LibraryFile> Libraries { get; init; } = [];
|
||||
|
||||
/// <summary>
|
||||
/// Whether a re-run may write <paramref name="detected"/> over a field whose
|
||||
/// current provenance is <paramref name="existing"/>.
|
||||
|
||||
@@ -74,7 +74,7 @@ public sealed class NativeAntiCheatGuard : IAntiCheatGuard
|
||||
|
||||
[DefaultDllImportSearchPaths(DllImportSearchPath.System32)]
|
||||
[DllImport(_guardDll, CallingConvention = CallingConvention.Cdecl, CharSet = CharSet.Unicode)]
|
||||
private static extern void FlStaticPreScan(string gameDirectory, out FlGuardResult result);
|
||||
private static extern void FlStaticPreScanGame(string exePath, out FlGuardResult result);
|
||||
|
||||
[DefaultDllImportSearchPaths(DllImportSearchPath.System32)]
|
||||
[DllImport(_guardDll, CallingConvention = CallingConvention.Cdecl)]
|
||||
@@ -140,13 +140,12 @@ public sealed class NativeAntiCheatGuard : IAntiCheatGuard
|
||||
}
|
||||
|
||||
/// <inheritdoc />
|
||||
public ValueTask<AntiCheatVerdict> PreScanGameDirectoryAsync(string gameDirectory,
|
||||
CancellationToken ct = default)
|
||||
public ValueTask<AntiCheatVerdict> PreScanGameAsync(string executablePath, CancellationToken ct = default)
|
||||
{
|
||||
ArgumentException.ThrowIfNullOrWhiteSpace(gameDirectory);
|
||||
ArgumentException.ThrowIfNullOrWhiteSpace(executablePath);
|
||||
return RunAsync(() =>
|
||||
{
|
||||
FlStaticPreScan(gameDirectory, out FlGuardResult r);
|
||||
FlStaticPreScanGame(executablePath, out FlGuardResult r);
|
||||
return AntiCheatVerdict.FromNative(r.Reason, r.Family, r.Signal);
|
||||
}, ct);
|
||||
}
|
||||
|
||||
@@ -42,6 +42,12 @@ public sealed class GameFileProbe : IGameFileProbe
|
||||
/// </remarks>
|
||||
public const int MaxEntries = 200_000;
|
||||
|
||||
/// <summary>
|
||||
/// How many capability files have their versions read (beta.8). A title ships a handful — DLSS, Streamline's plugins,
|
||||
/// the FidelityFX DLLs — and each read opens a file; a tree that matches more is named up to here, in walk order.
|
||||
/// </summary>
|
||||
public const int MaxLibraryFiles = 48;
|
||||
|
||||
private static readonly TimeSpan _regexBudget = TimeSpan.FromMilliseconds(250);
|
||||
|
||||
/// <inheritdoc />
|
||||
@@ -102,9 +108,48 @@ public sealed class GameFileProbe : IGameFileProbe
|
||||
ManifestFields = new Dictionary<string, string>(StringComparer.Ordinal),
|
||||
UncollectedFacts = uncollected,
|
||||
VulkanLoaderReferenced = ReferencesVulkanLoader(exePath, text),
|
||||
ExeArchitecture = PeImports.ReadArchitecture(exePath),
|
||||
Libraries = ReadLibraries(dir, files, rules),
|
||||
});
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// The files the capability rules name, among those the walk listed, with the versions their PE resources state
|
||||
/// (beta.8): <c>nvngx_dlss.dll 3.7.10.0</c>, <c>sl.interposer.dll 2.4.0.0</c>. A file the rules name twice is listed
|
||||
/// once, under the first rule; a file whose version cannot be read is listed with none — it is shipped either way.
|
||||
/// </summary>
|
||||
private static List<LibraryFile> ReadLibraries(string dir, List<string> files, DetectionRuleSet rules)
|
||||
{
|
||||
List<LibraryFile> found = [];
|
||||
if (string.IsNullOrEmpty(dir) || files.Count == 0)
|
||||
{
|
||||
return found;
|
||||
}
|
||||
|
||||
var seen = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
|
||||
foreach (CapabilityRule rule in rules.Capabilities)
|
||||
{
|
||||
foreach (string pattern in rule.Signals.Signals.Select(static sig => sig.Value))
|
||||
{
|
||||
foreach (string file in files.Where(f => RuleEvaluator.NamesFile(pattern, f)))
|
||||
{
|
||||
if (found.Count >= MaxLibraryFiles)
|
||||
{
|
||||
return found;
|
||||
}
|
||||
|
||||
if (seen.Add(file))
|
||||
{
|
||||
VersionInfo v = ReadVersionInfo(Path.Combine(dir, file));
|
||||
found.Add(new LibraryFile(rule.Id, file, v.NumericFileVersion, string.IsNullOrWhiteSpace(v.ProductVersion) ? null : v.ProductVersion.Trim()));
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return found;
|
||||
}
|
||||
|
||||
/// <summary>Breadth-first, bounded. Returns false if the walk did not complete.</summary>
|
||||
private static bool TryWalk(string root, List<string> files, List<string> dirs)
|
||||
{
|
||||
@@ -239,14 +284,18 @@ public sealed class GameFileProbe : IGameFileProbe
|
||||
try
|
||||
{
|
||||
FileVersionInfo v = FileVersionInfo.GetVersionInfo(exePath);
|
||||
return new VersionInfo(v.CompanyName, v.ProductName, v.FileVersion, v.ProductVersion);
|
||||
// The numeric form from VS_FIXEDFILEINFO: the FileVersion STRING may carry text ("3.7.10.0 built by …").
|
||||
string? numeric = v.FileMajorPart == 0 && v.FileMinorPart == 0 && v.FileBuildPart == 0 && v.FilePrivatePart == 0
|
||||
? null
|
||||
: string.Create(System.Globalization.CultureInfo.InvariantCulture, $"{v.FileMajorPart}.{v.FileMinorPart}.{v.FileBuildPart}.{v.FilePrivatePart}");
|
||||
return new VersionInfo(v.CompanyName, v.ProductName, v.FileVersion, v.ProductVersion, numeric);
|
||||
}
|
||||
catch (Exception ex) when (ex is IOException or UnauthorizedAccessException or ArgumentException)
|
||||
{
|
||||
// Null everywhere, so every pe_* signal evaluates Unknown. A PE we
|
||||
// could not read must not make "does the company contain Valve"
|
||||
// answer no.
|
||||
return new VersionInfo(null, null, null, null);
|
||||
return new VersionInfo(null, null, null, null, null);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -379,7 +428,7 @@ public sealed class GameFileProbe : IGameFileProbe
|
||||
}
|
||||
|
||||
private readonly record struct VersionInfo(string? Company, string? Product, string? FileVersion,
|
||||
string? ProductVersion)
|
||||
string? ProductVersion, string? NumericFileVersion)
|
||||
{
|
||||
public bool IsEmpty => Company is null && Product is null && FileVersion is null && ProductVersion is null;
|
||||
}
|
||||
|
||||
@@ -0,0 +1,9 @@
|
||||
using FrameLedger.Application.Detection;
|
||||
|
||||
namespace FrameLedger.Infrastructure.Detection;
|
||||
|
||||
/// <summary><see cref="IExecutableArchitectureSource"/> over <see cref="PeImports.ReadArchitecture(string)"/>: bounded, read-only, never throws for a bad file.</summary>
|
||||
public sealed class PeArchitectureSource : IExecutableArchitectureSource
|
||||
{
|
||||
public string Read(string exePath) => PeImports.ReadArchitecture(exePath);
|
||||
}
|
||||
@@ -1,6 +1,7 @@
|
||||
using System.Buffers.Binary;
|
||||
using System.Runtime.InteropServices;
|
||||
using System.Text;
|
||||
using FrameLedger.Domain.Detection;
|
||||
|
||||
namespace FrameLedger.Infrastructure.Detection;
|
||||
|
||||
@@ -8,7 +9,8 @@ namespace FrameLedger.Infrastructure.Detection;
|
||||
/// The module names an executable imports — its import directory and its delay-load directory — read from the
|
||||
/// file with bounded, read-only I/O (P4 PR-2). Null when the file is not a PE this reader understands or could not
|
||||
/// be read; an empty set when it is a PE that imports nothing. Names are returned as the file spells them, in a
|
||||
/// case-insensitive set.
|
||||
/// case-insensitive set. Since beta.8 (2026-09-25) the same headers also say what the file runs as
|
||||
/// (<see cref="ReadArchitecture(string)"/>).
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
@@ -53,7 +55,7 @@ public static class PeImports
|
||||
}
|
||||
|
||||
byte[] directories = new byte[16 * 8];
|
||||
List<Section>? sections = ReadHeaders(file, directories);
|
||||
List<Section>? sections = ReadHeaders(file, directories, out _);
|
||||
if (sections is null)
|
||||
{
|
||||
return null;
|
||||
@@ -71,9 +73,64 @@ public static class PeImports
|
||||
return names;
|
||||
}
|
||||
|
||||
/// <summary>DOS header → PE signature → optional header (PE32 or PE32+) → the 16 data directories and the section table. Null when any step does not read as a PE.</summary>
|
||||
private static List<Section>? ReadHeaders(Stream file, Span<byte> directories)
|
||||
/// <summary>
|
||||
/// What the executable runs as (beta.8): the COFF machine and, for a .NET executable, its CLR header's flags, as an
|
||||
/// <see cref="ExecutableArchitecture"/> id — <see cref="ExecutableArchitecture.Unknown"/> when the file is not a PE
|
||||
/// this reader understands or could not be read. Never throws for a malformed or missing file.
|
||||
/// </summary>
|
||||
public static string ReadArchitecture(string path)
|
||||
{
|
||||
ArgumentException.ThrowIfNullOrWhiteSpace(path);
|
||||
try
|
||||
{
|
||||
using FileStream fs = File.OpenRead(path);
|
||||
return ReadArchitecture(fs);
|
||||
}
|
||||
catch (Exception ex) when (ex is IOException or UnauthorizedAccessException or NotSupportedException)
|
||||
{
|
||||
return ExecutableArchitecture.Unknown;
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>The same over an open stream (tests hand in a synthetic PE).</summary>
|
||||
public static string ReadArchitecture(Stream file)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(file);
|
||||
if (!file.CanSeek || !file.CanRead)
|
||||
{
|
||||
return ExecutableArchitecture.Unknown;
|
||||
}
|
||||
|
||||
byte[] directories = new byte[16 * 8];
|
||||
if (ReadHeaders(file, directories, out ushort machine) is not { } sections)
|
||||
{
|
||||
return ExecutableArchitecture.Unknown;
|
||||
}
|
||||
|
||||
// Directory 14: the CLR runtime header (IMAGE_COR20_HEADER, Flags at +16). Present = a .NET executable, whose
|
||||
// flags decide between AnyCPU and x86 on an I386 machine; one we cannot read is unknown, never "native".
|
||||
uint rva = BinaryPrimitives.ReadUInt32LittleEndian(directories.AsSpan(14 * 8));
|
||||
uint size = BinaryPrimitives.ReadUInt32LittleEndian(directories.AsSpan((14 * 8) + 4));
|
||||
uint? clrFlags = null;
|
||||
if (rva != 0 && size != 0)
|
||||
{
|
||||
Span<byte> cor = stackalloc byte[20];
|
||||
long at = ToOffset(sections, rva);
|
||||
if (size < cor.Length || at < 0 || !ReadAt(file, at, cor))
|
||||
{
|
||||
return ExecutableArchitecture.Unknown;
|
||||
}
|
||||
|
||||
clrFlags = BinaryPrimitives.ReadUInt32LittleEndian(cor[16..]);
|
||||
}
|
||||
|
||||
return ExecutableArchitecture.Of(machine, clrFlags);
|
||||
}
|
||||
|
||||
/// <summary>DOS header → PE signature → optional header (PE32 or PE32+) → the 16 data directories and the section table. Null when any step does not read as a PE.</summary>
|
||||
private static List<Section>? ReadHeaders(Stream file, Span<byte> directories, out ushort machine)
|
||||
{
|
||||
machine = 0;
|
||||
Span<byte> dos = stackalloc byte[64];
|
||||
if (!ReadAt(file, 0, dos) || dos[0] != (byte)'M' || dos[1] != (byte)'Z')
|
||||
{
|
||||
@@ -87,6 +144,7 @@ public static class PeImports
|
||||
return null;
|
||||
}
|
||||
|
||||
machine = BinaryPrimitives.ReadUInt16LittleEndian(sig[4..]);
|
||||
int sectionCount = BinaryPrimitives.ReadUInt16LittleEndian(sig[6..]);
|
||||
int optionalSize = BinaryPrimitives.ReadUInt16LittleEndian(sig[20..]);
|
||||
long optionalOffset = peOffset + 24;
|
||||
|
||||
@@ -0,0 +1,59 @@
|
||||
using System.Text.Json;
|
||||
|
||||
namespace FrameLedger.Infrastructure.Import;
|
||||
|
||||
/// <summary>
|
||||
/// An RPG Maker MV/MZ game's own title (2026-09-23): <c>gameTitle</c> in <c>data\System.json</c> — under <c>www\</c> for
|
||||
/// MV, at the root for MZ — beside the executable or up to two folders above it (a launcher-fronted game keeps its
|
||||
/// runtime in a subfolder: <i>HELLO, HELLO WORLD!</i>'s is <c>swiftshader\</c>). Read only when the executable's own name
|
||||
/// says nothing (<c>Game.exe</c>), and bounded: a file over 1 MiB, an unreadable one or one without the field is null.
|
||||
/// </summary>
|
||||
public static class RpgMakerTitle
|
||||
{
|
||||
private const long _maxBytes = 1024 * 1024;
|
||||
|
||||
/// <summary>The title, or null when there is none to be read.</summary>
|
||||
public static string? TryRead(string exePath)
|
||||
{
|
||||
ArgumentException.ThrowIfNullOrWhiteSpace(exePath);
|
||||
string? dir = Path.GetDirectoryName(exePath);
|
||||
for (int up = 0; up <= 2 && !string.IsNullOrEmpty(dir); up++, dir = Path.GetDirectoryName(dir))
|
||||
{
|
||||
foreach (string relative in (string[])[Path.Combine("www", "data", "System.json"), Path.Combine("data", "System.json")])
|
||||
{
|
||||
if (TryTitle(Path.Combine(dir, relative)) is { } title)
|
||||
{
|
||||
return title;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
private static string? TryTitle(string path)
|
||||
{
|
||||
try
|
||||
{
|
||||
var file = new FileInfo(path);
|
||||
if (!file.Exists || file.Length > _maxBytes)
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
using FileStream stream = file.OpenRead();
|
||||
using JsonDocument doc = JsonDocument.Parse(stream);
|
||||
return doc.RootElement.ValueKind == JsonValueKind.Object
|
||||
&& doc.RootElement.TryGetProperty("gameTitle", out JsonElement title)
|
||||
&& title.ValueKind == JsonValueKind.String
|
||||
&& title.GetString() is { } text
|
||||
&& !string.IsNullOrWhiteSpace(text)
|
||||
? text.Trim()
|
||||
: null;
|
||||
}
|
||||
catch (Exception ex) when (ex is IOException or UnauthorizedAccessException or JsonException)
|
||||
{
|
||||
return null;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -2,10 +2,11 @@ using System.Text.Json.Serialization;
|
||||
|
||||
namespace FrameLedger.Infrastructure.Persistence;
|
||||
|
||||
/// <summary>Source-generated JSON for the two JSON columns the UI writes: <c>session_annotations.tags</c> (a string array) and <c>games.field_provenance</c> (field → provenance).</summary>
|
||||
/// <summary>Source-generated JSON for the two JSON columns the UI writes: <c>session_annotations.tags</c> (a string array) and <c>games.field_provenance</c> (field → provenance) — and, since schema 0011, the Agent's <c>games.library_versions</c>.</summary>
|
||||
[JsonSourceGenerationOptions(WriteIndented = false)]
|
||||
[JsonSerializable(typeof(string[]))]
|
||||
[JsonSerializable(typeof(Dictionary<string, string>))]
|
||||
[JsonSerializable(typeof(LibraryVersionsJson.Dto[]), TypeInfoPropertyName = "LibraryFileArray")]
|
||||
internal sealed partial class LedgerJsonContext : JsonSerializerContext
|
||||
{
|
||||
}
|
||||
@@ -0,0 +1,49 @@
|
||||
using System.Text.Json;
|
||||
using System.Text.Json.Serialization;
|
||||
using FrameLedger.Domain.Detection;
|
||||
|
||||
namespace FrameLedger.Infrastructure.Persistence;
|
||||
|
||||
/// <summary>
|
||||
/// <c>games.library_versions</c> (schema 0011): the capability files a game ships, as a JSON array of
|
||||
/// <c>{"capability","path","fileVersion","productVersion"}</c>. The names are the column's, not the Domain record's, so
|
||||
/// renaming a property cannot silently change what is stored.
|
||||
/// </summary>
|
||||
public static class LibraryVersionsJson
|
||||
{
|
||||
public static string Serialize(IReadOnlyList<LibraryFile> libraries)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(libraries);
|
||||
Dto[] dtos = [.. libraries.Select(static l => new Dto(l.CapabilityId, l.RelativePath, l.FileVersion, l.ProductVersion))];
|
||||
return JsonSerializer.Serialize(dtos, LedgerJsonContext.Default.LibraryFileArray);
|
||||
}
|
||||
|
||||
/// <summary>What the column holds; empty for NULL and for a value this build cannot read (the next scan rewrites it).</summary>
|
||||
public static IReadOnlyList<LibraryFile> Parse(string? json)
|
||||
{
|
||||
if (string.IsNullOrWhiteSpace(json))
|
||||
{
|
||||
return [];
|
||||
}
|
||||
|
||||
try
|
||||
{
|
||||
Dto[]? dtos = JsonSerializer.Deserialize(json, LedgerJsonContext.Default.LibraryFileArray);
|
||||
return dtos is null
|
||||
? []
|
||||
: [.. dtos.Where(static d => !string.IsNullOrWhiteSpace(d.Capability) && !string.IsNullOrWhiteSpace(d.Path))
|
||||
.Select(static d => new LibraryFile(d.Capability!, d.Path!, d.FileVersion, d.ProductVersion))];
|
||||
}
|
||||
catch (JsonException)
|
||||
{
|
||||
return [];
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>One element of the column, as stored.</summary>
|
||||
internal sealed record Dto(
|
||||
[property: JsonPropertyName("capability")] string? Capability,
|
||||
[property: JsonPropertyName("path")] string? Path,
|
||||
[property: JsonPropertyName("fileVersion")] string? FileVersion,
|
||||
[property: JsonPropertyName("productVersion")] string? ProductVersion);
|
||||
}
|
||||
@@ -0,0 +1,17 @@
|
||||
-- 0009 (2026-09-23): a library entry can be left unrecorded (owner request; HANDOFF D29).
|
||||
--
|
||||
-- Borderless Gaming starts with Windows on the owner's machine, and since Tier 2 exists (2026-09-22) every library
|
||||
-- entry that runs gets a session: one per boot, for as long as the utility runs, counted in the playtime totals.
|
||||
-- record_sessions = 0 means "FrameLedger does not watch for this program": no session, no measurement, no injection.
|
||||
-- It is the user's switch (the game page), written by the App; the Agent only reads it (06_DATA_MODEL §Writer ownership).
|
||||
--
|
||||
-- The one data change: entries an import made for Steam's own tools before the import learnt to skip them
|
||||
-- (SteamLibrarySource.KnownTools, 2026-09-22) start with the switch off. The ids are that list as this script was
|
||||
-- written; a test holds every id here to the list in code. A tool added to the list later is skipped by the import,
|
||||
-- and an entry that already exists for it keeps its switch until the user turns it off.
|
||||
|
||||
ALTER TABLE games ADD COLUMN record_sessions INTEGER NOT NULL DEFAULT 1;
|
||||
|
||||
UPDATE games SET record_sessions = 0
|
||||
WHERE platform = 'steam'
|
||||
AND store_id IN ('228980', '250820', '365670', '388080', '431960', '1070560', '1391110', '1493710', '1628350', '2180100');
|
||||
@@ -0,0 +1,14 @@
|
||||
-- 0010 (2026-09-25): the Agent pre-scans the library (beta.8; 19_SAFETY §What a finding does to the game).
|
||||
--
|
||||
-- Until now the static pre-scan ran only when the user asked to turn hooking on, so a game's anti-cheat was known only
|
||||
-- after that request or after a hooked session found it: most rows sat at hook_prescan_state = 'not_run', and the App
|
||||
-- could not tell an anti-cheat game from any other. The Agent now scans every entry itself, and again whenever the
|
||||
-- rules or the executable change — which needs to know what each row was last scanned against. These three columns are
|
||||
-- that key, the pre-scan's own (as 0004's detection_* columns are the detection sweep's): the rules version the scan
|
||||
-- ran under and the executable's size and mtime at the time. NULL is "never scanned by the sweep".
|
||||
--
|
||||
-- Written by the Agent only (06_DATA_MODEL §Writer ownership: hook-state columns are the Agent's).
|
||||
|
||||
ALTER TABLE games ADD COLUMN hook_prescan_rules_version TEXT;
|
||||
ALTER TABLE games ADD COLUMN hook_prescan_exe_size_bytes INTEGER;
|
||||
ALTER TABLE games ADD COLUMN hook_prescan_exe_mtime_ms INTEGER;
|
||||
@@ -0,0 +1,22 @@
|
||||
-- 0011 (2026-09-25): what a game's files say about themselves (beta.8, owner request: game version, DLSS/FSR versions,
|
||||
-- 32-bit or 64-bit).
|
||||
--
|
||||
-- The detection sweep already read the executable's PE version resource and walked the install tree for the files the
|
||||
-- capability rules name, and kept neither: games.game_version is the STORE's word (a Steam build id, a GOG or Epic
|
||||
-- version string) or the user's, under field_provenance, so the file's own versions get columns of their own.
|
||||
--
|
||||
-- exe_machine what the executable runs as, from its PE headers: x64 | x86 | arm64 | arm | anycpu |
|
||||
-- anycpu32 | other | unknown (Domain.Detection.ExecutableArchitecture). NULL = not looked at by
|
||||
-- this build yet, which the sweep reads as stale; 'unknown' = looked at and unreadable.
|
||||
-- exe_file_version the executable's PE FileVersion string (for an Unreal title, often the ENGINE's version)
|
||||
-- exe_product_version its PE ProductVersion string
|
||||
-- library_versions JSON array: the capability files the game SHIPS, one object per file —
|
||||
-- {"capability","path","fileVersion","productVersion"}. What the driver or the NVIDIA App loads
|
||||
-- at run time can differ; that is sessions.runtime_modules.
|
||||
--
|
||||
-- Written by the Agent's detection sweep only, whole, like capability_flags: facts about files have no user override.
|
||||
|
||||
ALTER TABLE games ADD COLUMN exe_machine TEXT;
|
||||
ALTER TABLE games ADD COLUMN exe_file_version TEXT;
|
||||
ALTER TABLE games ADD COLUMN exe_product_version TEXT;
|
||||
ALTER TABLE games ADD COLUMN library_versions TEXT;
|
||||
@@ -65,10 +65,61 @@ public sealed class SqliteGameConsentStore : IGameConsentStore
|
||||
"UPDATE games SET exe_size_bytes = @size, exe_mtime_ms = @mtime, hook_enabled = @enabled, "
|
||||
+ "hook_blocked_reason = @reason, hook_prescan_state = @state, updated_at = @at WHERE exe_path = @path";
|
||||
|
||||
// The pre-scan of the library (schema 0010). Both forms leave a block alone in SQL, not only in the sweep that skips
|
||||
// blocked rows: the WHERE is the guarantee, so a block written between the sweep's read and this write still stands.
|
||||
private const string _preScanFinding =
|
||||
"UPDATE games SET hook_enabled = 0, hook_blocked_reason = @reason, hook_prescan_state = 'blocked', "
|
||||
+ "hook_prescan_rules_version = @rules, hook_prescan_exe_size_bytes = @size, hook_prescan_exe_mtime_ms = @mtime, "
|
||||
+ "updated_at = @at WHERE exe_path = @path AND hook_blocked_reason IS NULL AND hook_prescan_state <> 'blocked'";
|
||||
|
||||
private const string _preScanOther =
|
||||
"UPDATE games SET hook_prescan_state = @state, hook_prescan_rules_version = @rules, "
|
||||
+ "hook_prescan_exe_size_bytes = @size, hook_prescan_exe_mtime_ms = @mtime, updated_at = @at "
|
||||
+ "WHERE exe_path = @path AND hook_blocked_reason IS NULL AND hook_prescan_state <> 'blocked'";
|
||||
|
||||
private readonly LedgerDatabase _db;
|
||||
|
||||
public SqliteGameConsentStore(LedgerDatabase db) => _db = db ?? throw new ArgumentNullException(nameof(db));
|
||||
|
||||
/// <summary>
|
||||
/// The words a block is stored in (<c>hook_blocked_reason</c>): <c>Reason|Family|Signal</c> since 2026-09-25, so the
|
||||
/// App can say what was found in the user's language. It was <c>"Reason: Family Signal"</c>, which cannot be split
|
||||
/// back apart — family names and file names both carry spaces — and rows written that way keep it. A family name
|
||||
/// cannot contain '|' (the rules schema's pattern) and a Windows file name cannot either.
|
||||
/// </summary>
|
||||
public static string BlockText(AntiCheatVerdict verdict) => $"{verdict.Reason}|{verdict.Family}|{verdict.Signal}";
|
||||
|
||||
/// <inheritdoc />
|
||||
public async ValueTask<ConsentWriteOutcome> RecordPreScanAsync(
|
||||
ExecutableFingerprint scanned, AntiCheatVerdict verdict, string rulesVersion, CancellationToken ct = default)
|
||||
{
|
||||
ArgumentException.ThrowIfNullOrWhiteSpace(rulesVersion);
|
||||
bool finding = verdict.IsFindingAboutTheGame;
|
||||
try
|
||||
{
|
||||
return await _db.WriteAsync(async (c, tx, token) =>
|
||||
{
|
||||
var p = new
|
||||
{
|
||||
path = scanned.ExePath,
|
||||
reason = BlockText(verdict),
|
||||
state = verdict.IsAllowed ? "clean" : "unverified",
|
||||
rules = rulesVersion,
|
||||
size = scanned.SizeBytes,
|
||||
mtime = scanned.MtimeUnixMs,
|
||||
at = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds(),
|
||||
};
|
||||
int rows = await c.ExecuteAsync(new CommandDefinition(finding ? _preScanFinding : _preScanOther, p, tx, cancellationToken: token))
|
||||
.ConfigureAwait(false);
|
||||
return rows == 0 ? ConsentWriteOutcome.NotFound : ConsentWriteOutcome.Written;
|
||||
}, ct).ConfigureAwait(false);
|
||||
}
|
||||
catch (SqliteException)
|
||||
{
|
||||
return ConsentWriteOutcome.Failed;
|
||||
}
|
||||
}
|
||||
|
||||
/// <inheritdoc />
|
||||
public async ValueTask<GameConsentRecord> FindAsync(string normalisedExePath, CancellationToken ct = default)
|
||||
{
|
||||
@@ -208,7 +259,7 @@ public sealed class SqliteGameConsentStore : IGameConsentStore
|
||||
mtime = fingerprint.MtimeUnixMs,
|
||||
// Forced to 0 on a real block (19_SAFETY); an unverified pre-scan does NOT disable the toggle.
|
||||
enabled = unverified && existing?.HookEnabled == true ? 1 : 0,
|
||||
reason = unverified ? existing?.BlockedReason : $"{refusal.Reason}: {refusal.Family} {refusal.Signal}".Trim(),
|
||||
reason = unverified ? existing?.BlockedReason : BlockText(refusal),
|
||||
state = unverified ? "unverified" : "blocked",
|
||||
at = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds(),
|
||||
};
|
||||
|
||||
@@ -0,0 +1,145 @@
|
||||
using System.Data.Common;
|
||||
using Dapper;
|
||||
using FrameLedger.Application.Persistence;
|
||||
using Microsoft.Data.Sqlite;
|
||||
|
||||
namespace FrameLedger.Infrastructure.Persistence;
|
||||
|
||||
/// <summary>
|
||||
/// <see cref="IGameMerge"/> over the ledger (2026-09-23, HANDOFF D26): two entries for one executable under two drive
|
||||
/// letters become one, in one transaction, or nothing is written.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// <b>The order is the schema's.</b> <c>sessions.game_id</c> is the only reference to <c>games</c> (0001–0009) and it
|
||||
/// cascades on delete, so the sessions are re-parented BEFORE the dropped row is deleted; <c>exe_path</c> is UNIQUE, so a
|
||||
/// survivor that moves takes the path AFTER the row that held it is gone.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// <b>Only ever toward hooking off.</b> A block the dropped entry carried is kept (it is never cleared anywhere, and a
|
||||
/// merge must not be the way one disappears); a crash auto-disable it is still under turns the survivor's hooking off
|
||||
/// too; its crash count is added. Nothing about consent is read from the dropped entry or written to the survivor —
|
||||
/// <c>hook_enabled</c> only ever goes to 0 here, and the survivor's own consent is untouched: a survivor that moves has
|
||||
/// the target's bytes (the plan's condition, checked again below), which is the move <see cref="IGameRepository.RelocateExecutableAsync"/>
|
||||
/// makes with consent kept. This class is therefore a writer of <c>hook_blocked_reason</c> that can only copy a block,
|
||||
/// never set one from nothing or clear one (<c>06_DATA_MODEL</c> §Writer ownership).
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// <b>The recording switch (schema 0009) follows the same direction:</b> off on either entry is off on the survivor. The
|
||||
/// user turned it off for this executable under one of its two names.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public sealed class SqliteGameMerge : IGameMerge
|
||||
{
|
||||
private const string _read =
|
||||
"SELECT id, exe_path, exe_size_bytes, exe_mtime_ms, removed_at, hook_enabled, hook_blocked_reason, hook_autodisabled_reason, "
|
||||
+ "hook_autodisabled_at, hook_crash_count, hook_last_injected_at, record_sessions FROM games WHERE id = @id";
|
||||
|
||||
private const string _reparent = "UPDATE sessions SET game_id = @keep WHERE game_id = @drop";
|
||||
|
||||
private const string _carry =
|
||||
"UPDATE games SET hook_blocked_reason = @blocked, hook_autodisabled_reason = @autoReason, hook_autodisabled_at = @autoAt, "
|
||||
+ "hook_crash_count = @crashes, hook_last_injected_at = @injected, record_sessions = @record, "
|
||||
+ "hook_enabled = CASE WHEN @hookOff THEN 0 ELSE hook_enabled END, "
|
||||
+ "hook_prescan_state = CASE WHEN @blockCarried THEN 'blocked' ELSE hook_prescan_state END, "
|
||||
+ "updated_at = @now WHERE id = @keep";
|
||||
|
||||
private const string _delete = "DELETE FROM games WHERE id = @drop";
|
||||
|
||||
private const string _move = "UPDATE games SET exe_path = @path, updated_at = @now WHERE id = @keep";
|
||||
|
||||
private readonly LedgerDatabase _db;
|
||||
|
||||
public SqliteGameMerge(LedgerDatabase db) => _db = db ?? throw new ArgumentNullException(nameof(db));
|
||||
|
||||
public ValueTask<int?> MergeAsync(GameMergePlan plan, CancellationToken ct = default)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(plan);
|
||||
return _db.WriteAsync(async (c, tx, token) =>
|
||||
{
|
||||
Twin? keep = await ReadAsync(c, tx, plan.SurvivorId, token).ConfigureAwait(false);
|
||||
Twin? drop = await ReadAsync(c, tx, plan.DroppedId, token).ConfigureAwait(false);
|
||||
if (!AsPlanned(plan, keep, drop))
|
||||
{
|
||||
return (int?)null;
|
||||
}
|
||||
|
||||
long now = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
|
||||
int sessions = await c.ExecuteAsync(new CommandDefinition(_reparent, new { keep = plan.SurvivorId, drop = plan.DroppedId }, tx, cancellationToken: token))
|
||||
.ConfigureAwait(false);
|
||||
|
||||
// A crash auto-disable the dropped entry is still under (hooking off because of it) turns the survivor's hooking off
|
||||
// too; one it was re-enabled after is history, and the survivor keeps its own.
|
||||
bool autoCarried = keep!.AutoDisabledReason is null && drop!.AutoDisabledReason is not null && !drop.HookEnabled;
|
||||
bool blockCarried = keep.BlockedReason is null && drop!.BlockedReason is not null;
|
||||
var carry = new
|
||||
{
|
||||
keep = plan.SurvivorId,
|
||||
blocked = keep.BlockedReason ?? drop!.BlockedReason,
|
||||
autoReason = autoCarried ? drop!.AutoDisabledReason : keep.AutoDisabledReason,
|
||||
autoAt = autoCarried ? drop!.AutoDisabledAt : keep.AutoDisabledAt,
|
||||
crashes = keep.CrashCount + drop!.CrashCount,
|
||||
injected = Later(keep.LastInjectedAt, drop.LastInjectedAt),
|
||||
record = keep.RecordSessions && drop.RecordSessions ? 1 : 0,
|
||||
hookOff = blockCarried || autoCarried,
|
||||
blockCarried,
|
||||
now,
|
||||
};
|
||||
await c.ExecuteAsync(new CommandDefinition(_carry, carry, tx, cancellationToken: token)).ConfigureAwait(false);
|
||||
await c.ExecuteAsync(new CommandDefinition(_delete, new { drop = plan.DroppedId }, tx, cancellationToken: token)).ConfigureAwait(false);
|
||||
if (plan.SurvivorMoves)
|
||||
{
|
||||
await c.ExecuteAsync(new CommandDefinition(_move, new { keep = plan.SurvivorId, path = plan.Target.ExePath, now }, tx, cancellationToken: token))
|
||||
.ConfigureAwait(false);
|
||||
}
|
||||
|
||||
return (int?)sessions;
|
||||
}, ct);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Both rows are still what the plan saw: there, in the library, at the paths it read — and a survivor that moves still
|
||||
/// holds the target's bytes, so the move keeps its consent for the file it was given for.
|
||||
/// </summary>
|
||||
private static bool AsPlanned(GameMergePlan plan, Twin? keep, Twin? drop) =>
|
||||
keep is { RemovedAt: null } && drop is { RemovedAt: null }
|
||||
&& string.Equals(keep.ExePath, plan.SurvivorPath, StringComparison.OrdinalIgnoreCase)
|
||||
&& string.Equals(drop.ExePath, plan.DroppedPath, StringComparison.OrdinalIgnoreCase)
|
||||
&& (plan.SurvivorMoves
|
||||
? string.Equals(drop.ExePath, plan.Target.ExePath, StringComparison.OrdinalIgnoreCase)
|
||||
&& keep.SizeBytes == plan.Target.SizeBytes && keep.MtimeMs == plan.Target.MtimeUnixMs
|
||||
: string.Equals(keep.ExePath, plan.Target.ExePath, StringComparison.OrdinalIgnoreCase));
|
||||
|
||||
private static long? Later(long? a, long? b) => a is null ? b : b is null ? a : Math.Max(a.Value, b.Value);
|
||||
|
||||
private static Task<Twin?> ReadAsync(SqliteConnection c, SqliteTransaction tx, long id, CancellationToken ct) =>
|
||||
SqliteReaders.ReadOneAsync(c, new CommandDefinition(_read, new { id }, tx, cancellationToken: ct), Read);
|
||||
|
||||
private static Twin Read(DbDataReader r) => new(
|
||||
r.GetInt64(0),
|
||||
r.GetString(1),
|
||||
SqliteReaders.Int64(r, 2),
|
||||
SqliteReaders.Int64(r, 3),
|
||||
SqliteReaders.Int64(r, 4),
|
||||
r.GetInt64(5) != 0,
|
||||
SqliteReaders.String(r, 6),
|
||||
SqliteReaders.String(r, 7),
|
||||
SqliteReaders.Int64(r, 8),
|
||||
r.GetInt32(9),
|
||||
SqliteReaders.Int64(r, 10),
|
||||
r.GetInt64(11) != 0);
|
||||
|
||||
private sealed record Twin(
|
||||
long Id,
|
||||
string ExePath,
|
||||
long? SizeBytes,
|
||||
long? MtimeMs,
|
||||
long? RemovedAt,
|
||||
bool HookEnabled,
|
||||
string? BlockedReason,
|
||||
string? AutoDisabledReason,
|
||||
long? AutoDisabledAt,
|
||||
int CrashCount,
|
||||
long? LastInjectedAt,
|
||||
bool RecordSessions);
|
||||
}
|
||||
@@ -14,7 +14,8 @@ namespace FrameLedger.Infrastructure.Persistence;
|
||||
/// The <c>games</c> table minus its consent columns. Nothing here can set <c>hook_enabled</c> to 1, stamp
|
||||
/// <c>hook_consent_at</c>, or touch <c>hook_blocked_reason</c>: those are <see cref="SqliteGameConsentStore"/>'s,
|
||||
/// and a second writer of the same columns would be the "two views of one state" the port forbids. The UI's
|
||||
/// half (P3 PR-3) writes the metadata, the tri-state defaults and <c>removed_at</c> — and nothing else.
|
||||
/// half (P3 PR-3) writes the metadata, the tri-state defaults, <c>removed_at</c> and, since 2026-09-23,
|
||||
/// <c>record_sessions</c> — and nothing else.
|
||||
/// </summary>
|
||||
public sealed class SqliteGameRepository : IGameRepository
|
||||
{
|
||||
@@ -23,7 +24,9 @@ public sealed class SqliteGameRepository : IGameRepository
|
||||
+ "hook_crash_count, hook_last_injected_at, added_at, updated_at, "
|
||||
+ "platform, store_id, engine, engine_version, publisher, game_version, cover_path, notes, field_provenance, capability_flags, "
|
||||
+ "rt_default, pt_default, rr_default, hook_consent_at, hook_prescan_state, removed_at, "
|
||||
+ "detection_rules_version, detection_exe_size_bytes, detection_exe_mtime_ms";
|
||||
+ "detection_rules_version, detection_exe_size_bytes, detection_exe_mtime_ms, record_sessions, "
|
||||
+ "hook_prescan_rules_version, hook_prescan_exe_size_bytes, hook_prescan_exe_mtime_ms, "
|
||||
+ "exe_machine, exe_file_version, exe_product_version, library_versions";
|
||||
|
||||
private const string _selectByPath = $"SELECT {_columns} FROM games WHERE exe_path = @path";
|
||||
|
||||
@@ -42,10 +45,12 @@ public sealed class SqliteGameRepository : IGameRepository
|
||||
|
||||
// A downgrade by construction: the consent columns go to their "nothing happened" defaults, never to a grant, and
|
||||
// hook_blocked_reason is not named (IGameRepository.ChangeExecutableAsync). NOT EXISTS is the UNIQUE index's answer
|
||||
// as a false instead of a constraint exception.
|
||||
// as a false instead of a constraint exception. The pre-scan's key goes with its state (schema 0010), so the Agent's
|
||||
// sweep scans the new executable on its next pass whatever its size and mtime happen to be.
|
||||
private const string _changeExecutable =
|
||||
"UPDATE games SET exe_path = @path, exe_size_bytes = @size, exe_mtime_ms = @mtime, hook_enabled = 0, hook_consent_at = NULL, "
|
||||
+ "hook_consent_provenance = 'NotRecorded', hook_consent_disclosure_version = '', hook_prescan_state = 'not_run', "
|
||||
+ "hook_prescan_rules_version = NULL, hook_prescan_exe_size_bytes = NULL, hook_prescan_exe_mtime_ms = NULL, "
|
||||
+ "updated_at = @at "
|
||||
+ "WHERE id = @id AND removed_at IS NULL AND NOT EXISTS (SELECT 1 FROM games other WHERE other.exe_path = @path AND other.id <> @id)";
|
||||
|
||||
@@ -68,6 +73,8 @@ public sealed class SqliteGameRepository : IGameRepository
|
||||
|
||||
private const string _remove = "UPDATE games SET removed_at = @now, updated_at = @now WHERE id = @id AND removed_at IS NULL";
|
||||
|
||||
private const string _setRecording = "UPDATE games SET record_sessions = @record, updated_at = @now WHERE id = @id";
|
||||
|
||||
private const string _delete = "DELETE FROM games WHERE id = @id";
|
||||
|
||||
private const string _applyStore =
|
||||
@@ -77,6 +84,7 @@ public sealed class SqliteGameRepository : IGameRepository
|
||||
private const string _applyDetection =
|
||||
"UPDATE games SET engine = @engine, engine_version = @engineVersion, platform = @platform, capability_flags = @flags, "
|
||||
+ "field_provenance = @provenance, detection_rules_version = @rules, detection_exe_size_bytes = @size, detection_exe_mtime_ms = @mtime, "
|
||||
+ "exe_machine = @machine, exe_file_version = @fileVersion, exe_product_version = @productVersion, library_versions = @libraries, "
|
||||
+ "updated_at = @now WHERE id = @id";
|
||||
|
||||
private readonly LedgerDatabase _db;
|
||||
@@ -203,6 +211,10 @@ public sealed class SqliteGameRepository : IGameRepository
|
||||
sql, new { id = gameId, value = Vocabulary.Tri(value), now = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds() }, tx, cancellationToken: token)).ConfigureAwait(false) == 1, ct);
|
||||
}
|
||||
|
||||
public ValueTask<bool> SetRecordingAsync(long gameId, bool record, CancellationToken ct = default) =>
|
||||
_db.WriteAsync(async (c, tx, token) => await c.ExecuteAsync(new CommandDefinition(
|
||||
_setRecording, new { id = gameId, record = record ? 1 : 0, now = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds() }, tx, cancellationToken: token)).ConfigureAwait(false) == 1, ct);
|
||||
|
||||
public ValueTask<bool> RemoveAsync(long gameId, bool keepSessions, CancellationToken ct = default) =>
|
||||
_db.WriteAsync(async (c, tx, token) =>
|
||||
{
|
||||
@@ -243,6 +255,10 @@ public sealed class SqliteGameRepository : IGameRepository
|
||||
rules = detection.RulesVersion,
|
||||
size = detection.ExeSizeBytes,
|
||||
mtime = detection.ExeMtimeMs,
|
||||
machine = detection.ExeArchitecture,
|
||||
fileVersion = detection.ExeFileVersion,
|
||||
productVersion = detection.ExeProductVersion,
|
||||
libraries = LibraryVersionsJson.Serialize(detection.Libraries),
|
||||
now = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds(),
|
||||
};
|
||||
return await c.ExecuteAsync(new CommandDefinition(_applyDetection, p, tx, cancellationToken: token)).ConfigureAwait(false) == 1;
|
||||
@@ -327,6 +343,14 @@ public sealed class SqliteGameRepository : IGameRepository
|
||||
DetectionRulesVersion = SqliteReaders.String(r, 28),
|
||||
DetectionExeSizeBytes = SqliteReaders.Int64(r, 29),
|
||||
DetectionExeMtimeMs = SqliteReaders.Int64(r, 30),
|
||||
RecordSessions = r.GetInt64(31) != 0,
|
||||
HookPrescanRulesVersion = SqliteReaders.String(r, 32),
|
||||
HookPrescanExeSizeBytes = SqliteReaders.Int64(r, 33),
|
||||
HookPrescanExeMtimeMs = SqliteReaders.Int64(r, 34),
|
||||
ExeMachine = SqliteReaders.String(r, 35),
|
||||
ExeFileVersion = SqliteReaders.String(r, 36),
|
||||
ExeProductVersion = SqliteReaders.String(r, 37),
|
||||
Libraries = LibraryVersionsJson.Parse(SqliteReaders.String(r, 38)),
|
||||
};
|
||||
|
||||
private static DateTimeOffset? At(long? unixMs) => unixMs is { } ms ? DateTimeOffset.FromUnixTimeMilliseconds(ms) : null;
|
||||
|
||||
@@ -19,6 +19,9 @@ public static class PartialSessionFile
|
||||
private const int _chunkOverhead = 12;
|
||||
private const int _recordBytes = 64;
|
||||
|
||||
// A header is a few hundred bytes of JSON; a length past this is a damaged file, not a header to allocate for.
|
||||
private const int _maxHeaderBytes = 1024 * 1024;
|
||||
|
||||
/// <summary>Opens a new file and writes the header chunk. Never overwrites: a guid is one session.</summary>
|
||||
public static IPartialSessionWriter Create(string path, PartialHeader header)
|
||||
{
|
||||
@@ -45,6 +48,43 @@ public static class PartialSessionFile
|
||||
return Parse(bytes);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// The header alone (2026-09-23), read beside the running session's writer — which holds the file for writing and
|
||||
/// shares it for reading only, so this opens it sharing read, write and delete. Null when the file is gone, cannot
|
||||
/// be opened, or its first chunk is not a whole header.
|
||||
/// </summary>
|
||||
public static PartialHeader? ReadHeader(string path)
|
||||
{
|
||||
try
|
||||
{
|
||||
using var stream = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.ReadWrite | FileShare.Delete);
|
||||
Span<byte> head = stackalloc byte[8];
|
||||
if (stream.ReadAtLeast(head, head.Length, throwOnEndOfStream: false) < head.Length)
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
int length = (int)BinaryPrimitives.ReadUInt32LittleEndian(head[4..]);
|
||||
if (length < 0 || length > _maxHeaderBytes)
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
byte[] chunk = new byte[_chunkOverhead + length];
|
||||
head.CopyTo(chunk);
|
||||
if (stream.ReadAtLeast(chunk.AsSpan(head.Length), chunk.Length - head.Length, throwOnEndOfStream: false) < chunk.Length - head.Length)
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
return Parse(chunk)?.Header;
|
||||
}
|
||||
catch (Exception ex) when (ex is IOException or UnauthorizedAccessException)
|
||||
{
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>The valid prefix of <paramref name="bytes"/>; null when the header itself is missing or unreadable.</summary>
|
||||
public static PartialSession? Parse(ReadOnlySpan<byte> bytes)
|
||||
{
|
||||
|
||||
@@ -51,6 +51,21 @@ public sealed class PartialSessionStore : IPartialSessionStore
|
||||
|
||||
public void Delete(Guid sessionGuid) => File.Delete(PathOf(sessionGuid));
|
||||
|
||||
/// <inheritdoc />
|
||||
public IReadOnlySet<long> PendingGameIds()
|
||||
{
|
||||
HashSet<long> ids = [];
|
||||
foreach (Guid guid in ListPending())
|
||||
{
|
||||
if (PartialSessionFile.ReadHeader(PathOf(guid)) is { } header)
|
||||
{
|
||||
ids.Add(header.GameId);
|
||||
}
|
||||
}
|
||||
|
||||
return ids;
|
||||
}
|
||||
|
||||
/// <inheritdoc />
|
||||
public void Quarantine(Guid sessionGuid)
|
||||
{
|
||||
|
||||
@@ -23,10 +23,12 @@ namespace FrameLedger.Shared.Ipc;
|
||||
[JsonSerializable(typeof(ErrorAck))]
|
||||
[JsonSerializable(typeof(SessionStartedEvent))]
|
||||
[JsonSerializable(typeof(SessionProgressEvent))]
|
||||
[JsonSerializable(typeof(SessionHeldEvent))]
|
||||
[JsonSerializable(typeof(SessionCompletedEvent))]
|
||||
[JsonSerializable(typeof(CaptureRefusedEvent))]
|
||||
[JsonSerializable(typeof(CaptureDegradedEvent))]
|
||||
[JsonSerializable(typeof(SafetyUnhookEvent))]
|
||||
[JsonSerializable(typeof(HookingTurnedOffEvent))]
|
||||
[JsonSerializable(typeof(CaptureErrorEvent))]
|
||||
[JsonSerializable(typeof(WatchlistEntry))]
|
||||
[JsonSerializable(typeof(SetWatchlistRequest))]
|
||||
|
||||
Loaded 100 of 179 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user