Compare commits

...
Author SHA1 Message Date
poli0981andClaude Opus 5.5 d269dc4847 release: 0.1.0-beta.23 - the CHANGELOG section, release lines, HANDOFF's beta.23 section with D60-D61 and owner-only item 19 (beta.23 PR-5)
The [Unreleased] entries of #308-#311 move under [0.1.0-beta.23] with the release's
summary and how to update from beta.22: the Privacy Policy (2.11) is shown once, no game
is read again (detection rules 2026.10.4 unchanged), the artwork shows by itself for games
Steam or GOG GALAXY installed.

Release lines: legal/ACCURACY.md, README.md and legal/DISCLAIMER.md (the identical
accuracy line), README's list of pre-releases and its count (twenty-three), LIMITATIONS'
version line.

HANDOFF: beta.22's START HERE struck; beta.23's section with the owner's request, D60 (the
artwork is what is already on the PC; a chosen image's path is followed only when it is
ours, never through a link), D61 (the band's colour as far as every text reads), the bar
the pages' speed was judged by and what it left for the owner (the library grid's
virtualization), and the traps met; owner-only item 19 (the artwork on real Steam and GOG
games, the theme switch, choosing and dropping an image, the speed on WALTO's longest
session, Privacy 2.11 shown once, the ja strings).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 00:22:16 +07:00
6 changed files with 72 additions and 7 deletions

No files matched your search

+11
View File
@@ -28,6 +28,17 @@ numeric core and does not move; the heading is the full version — corrected 20
## [Unreleased]
## [0.1.0-beta.23] - 2026-10-14
**The twenty-third pre-release: a game's artwork on its page, in a band that takes the picture's colour, and pages
that open and change session without freezing.** The same unsigned installer: verify its hash against
`SHA256SUMS.txt`, then *More info → Run anyway*.
**Updating from `0.1.0-beta.22`:** Help ▸ Check for updates, then *Restart to update* with no game running. The
Privacy Policy (2.11) is shown once for you to accept. No game is read again: the detection rules (`2026.10.4`) are
beta.22's. The artwork shows by itself for the games Steam or GOG GALAXY installed; **Settings ▸ Games** turns it, or
its colour, off.
### Added
- **A game's page shows its artwork** (owner request 2026-10-14, decisions D60/D61). At the top of the page: the
+1 -1
View File
@@ -5,7 +5,7 @@ hooking on for — and reading the graphics calls the game makes. That is why it
resolution, the upscaler, frame generation and ray tracing apart. It is also where its limits come from. This
page lists them in plain words; each item links to the document that has the details.
*Beta software: this page describes version 0.1.0-beta.22.*
*Beta software: this page describes version 0.1.0-beta.23.*
## Games it will not measure
+3 -3
View File
@@ -12,7 +12,7 @@ pages.
<!-- accuracy-block:begin -->
> ⚠ **What FrameLedger actually measures today — 2026-10-13.** The software is a beta; its latest
> **pre-release is `0.1.0-beta.22`** (2026-10-13), an unsigned installer built from that tag with its
> **pre-release is `0.1.0-beta.23`** (2026-10-14), 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 (unless you switched its recording off), injects only into games you enabled
@@ -167,7 +167,7 @@ Elevation is **optional — for everything.** Hooked capture is the normal path
## Install
> **The latest pre-release is `v0.1.0-beta.22` (2026-10-13); before it `v0.1.0-beta.21` (2026-10-13), `v0.1.0-beta.20` (2026-10-12), `v0.1.0-beta.19` (2026-10-12), `v0.1.0-beta.18` (2026-10-07), `v0.1.0-beta.17` (2026-10-07), `v0.1.0-beta.16` (2026-10-06), `v0.1.0-beta.15` (2026-10-06), `v0.1.0-beta.14` (2026-10-06), `v0.1.0-beta.13` (2026-10-04), `v0.1.0-beta.12` (2026-10-04), `v0.1.0-beta.11` (2026-10-03), `v0.1.0-beta.10` (2026-09-28), `v0.1.0-beta.9` (2026-09-26), `v0.1.0-beta.8` (2026-09-25), `v0.1.0-beta.7` (2026-09-23), `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`.
> **The latest pre-release is `v0.1.0-beta.23` (2026-10-14); before it `v0.1.0-beta.22` (2026-10-13), `v0.1.0-beta.21` (2026-10-13), `v0.1.0-beta.20` (2026-10-12), `v0.1.0-beta.19` (2026-10-12), `v0.1.0-beta.18` (2026-10-07), `v0.1.0-beta.17` (2026-10-07), `v0.1.0-beta.16` (2026-10-06), `v0.1.0-beta.15` (2026-10-06), `v0.1.0-beta.14` (2026-10-06), `v0.1.0-beta.13` (2026-10-04), `v0.1.0-beta.12` (2026-10-04), `v0.1.0-beta.11` (2026-10-03), `v0.1.0-beta.10` (2026-09-28), `v0.1.0-beta.9` (2026-09-26), `v0.1.0-beta.8` (2026-09-25), `v0.1.0-beta.7` (2026-09-23), `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**.
@@ -216,4 +216,4 @@ GPU telemetry is layered so the project never depends on a proprietary vendor li
---
**Status:** pre-release (beta). Twenty-two 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). Twenty-three 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.
+55 -1
View File
@@ -2277,7 +2277,7 @@ Privacy Policy 2.10 — then the release.*
**Owner-only, added to the list below:** item 17.
## **START HERE** — 2026-10-13, 0.1.0-beta.22: a request the capture agent never answered
## ~~**START HERE**~~ — 2026-10-13, 0.1.0-beta.22: a request the capture agent never answered *(struck 2026-10-14: the head is §beta.23 below)*
*Status is `CHANGELOG.md` `[0.1.0-beta.22]`; this is what no other file carries.* The owner, during the beta.21
train: "Bạn xử lý chip thành 1 pr mới sau release và thành 1 phiên bản mới nhé" — the chip beta.21's review of Play
@@ -2305,6 +2305,52 @@ hammering-writer guard, red on a correct ring) became beta.23 PR-1, #308: both c
overlapped the writer (§Traps, the native-test entry). Merged for the next pre-release; no release, since nothing a
user runs changed.
## **START HERE** — 2026-10-14, 0.1.0-beta.23: a game's artwork, pages that do not freeze, the documents that drifted
*Status is `CHANGELOG.md` `[0.1.0-beta.23]`; this is what no other file carries.* The owner, 2026-10-14: "Bạn phân tích
và lên plan cho phần tiếp theo gồm những nội dung sau: 1. Thêm ảnh bìa/hero/cover của game từ các nền tảng đó - Đặt trong
detail của game. (Nếu được); Tuỳ chọn: có thể sync màu cùa cover với màu của detail; 2. Cập nhật, sync docs; 3. Kiểm tra
hiệu suất khi chuyển giữa các tab (nếu có vấn đề hiệu năng)" — then the whole train to the release without asking again.
On top of #308 (PR-1): #309 (the pages, measured first), #310 (the artwork), #311 (the drift), then this release.
**Decisions:**
- **D60 — a game's artwork is what is already on the PC.** The image the user chose (*Edit… ▸ Choose image…*), else
what the Steam or GOG GALAXY app keeps for the game it installed — found through the stores' own records as Play finds
them (`StoreRecords.Owning`, never the row's platform alone). Nothing is downloaded: `privacy.online_metadata` stays
reserved. A chosen image is a PNG copy, `<data>\covers\game-<id>-<unix ms>.png`, named relative in `cover_path`; only
those names are followed — never a rooted, share or `..` path, never through a junction or a symbolic link, because a
viewer's copy of a ledger may come from anywhere (D52).
- **D61 — the band takes the artwork's colour as far as every text on it reads**: primary and secondary 4.5:1, tertiary
3:1, the pills' and the warning's text 4.5:1 on their own fills; at most 30 % on the dark theme, 22 % on the light. On
by default (the owner's choice); never in high contrast; it follows a theme switch by resource reference.
- **The pages' speed was judged by a bar written before the first measurement** (`spike-notes` §21): fix what keeps the
UI thread busy 50 ms or more, can block on I/O, or grows with each visit. Recorded, not fixed: page builds of 85–370 ms,
and **the library grid (275 ms at 48 games) — non-virtualizing by the beta.11 decision; a virtualizing one changes the
page's look, which is the owner's call**; no `sessions.started_at` index (a schema version locks out every earlier
build, and nothing measured asked for it).
- `LIST_GAME_TESTED`: the Everhex Demo row and the corrected Vulkan sentence, approved by the owner under D35.
**Traps met on the way:**
- **Microsoft.Data.Sqlite completes its "async" calls synchronously**: after a ledger read, `ConfigureAwait(false)` is
still on the UI thread — the session decode, the sorts and the stutter detection all ran there (`16_WPFUI_SYNTAX`
§Gotchas).
- **A transient view model that is `IDisposable` lives until the App exits** (the root container keeps it), and every
Dashboard ever opened stayed subscribed. FR-3.8's "Session saved" lived in that view model and reached every page only
through the leak — it is `Services.SessionNotices` now.
- **A `ui:Image` given a `Style` of its own that is not based on `DefaultImageStyle` has no template** and draws nothing
in the place it takes. Only a render showed it; `AccessibilityTests.NoStyleOfAWpfUiControlLeavesOutItsTemplate`
refuses it now.
- **A page just navigated to is mid-fade**: a `RenderTargetBitmap` of it reads every colour washed out unless the
presenter's `Transition` is `None`.
- **The Bash tool's heredocs halve backslashes**: `covers\game-` became an invalid C# escape, and `\r\n` in a Python
heredoc became real line breaks. Write such files with the editor tools.
- **`Directory.Delete(…, recursive: true)` over a junction throws without elevation** (it asks Windows to unmount a
volume, and the link is removed anyway): a test deletes its junction itself first.
**Owner-only, added to the list below:** item 19.
## Owner-only — no PR can close these
1. **§S23-2 — branch protection.** `Rules / validate` is not a required status check on
@@ -2440,6 +2486,14 @@ user runs changed.
string marked `review` (`Agent_Unanswered`). (b) Nothing else to run: the change answers a request the agent drops
mid-way, which the tests make happen and a person can only meet by chance — if a notice ever says the capture agent
did not answer, the page beside it shows what was stored.
19. **beta.23 on real hardware.** (a) **Artwork:** open the page of a Steam game (one on the D: drive) and of a GOG game
— the banner, the cover beside the name, the band's colour; an itch game shows none. With a page open, switch Dark →
Light → Dark: the band changes with the theme and every text on it stays readable. (b) **Your own image:** *Edit… ▸
Choose image…* then Save — the page shows it; *Edit… ▸ Use the store's image* — the store's again; choosing an image
and pressing Cancel leaves nothing new in `%LOCALAPPDATA%\FrameLedger\covers`. (c) **Settings ▸ Games:** *Show game
artwork* and *Colour the game page from its artwork* off, then on. (d) **Speed:** open WALTO's page and choose its
longest session, switch the page's tabs; visit the Dashboard a few times, then end a session — one "Session saved".
(e) The Privacy Policy 2.11 is shown once after the update. (f) The `ja` strings marked `review`.
**Answered 2026-08-05, do not re-ask:** remove `gameguard` and keep `guard` (approved
over a red `Rules` gate, with the reasoning recorded in the merge commit); vendor NVAPI
+1 -1
View File
@@ -12,7 +12,7 @@
HTML comments are not part of the block.
-->
> ⚠ **What FrameLedger actually measures today — 2026-10-13.** The software is a beta; its latest
> **pre-release is `0.1.0-beta.22`** (2026-10-13), an unsigned installer built from that tag with its
> **pre-release is `0.1.0-beta.23`** (2026-10-14), 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 (unless you switched its recording off), injects only into games you enabled
+1 -1
View File
@@ -114,7 +114,7 @@ Frame timing is derived from high-resolution timestamps taken at the moment the
<!-- accuracy-block:begin -->
> ⚠ **What FrameLedger actually measures today — 2026-10-13.** The software is a beta; its latest
> **pre-release is `0.1.0-beta.22`** (2026-10-13), an unsigned installer built from that tag with its
> **pre-release is `0.1.0-beta.23`** (2026-10-14), 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 (unless you switched its recording off), injects only into games you enabled