legal: what an alpha is once .NET 11 has shipped - EULA 1.7, Disclaimer 2.14, Alpha notice 1.1; a resting alpha says so and names a prerelease only where it runs on one (D97, D98) (beta.37 PR-2) (#379)
Until 0.1.0-alpha.3 an alpha was "a beta's source built on a prerelease .NET" and every text said so. 0.1.0-alpha.4 runs on .NET 11's release - the betas' own from beta.37 - and the alpha line rests after it. - EULA 1.7 (section 2B), Disclaimer 2.14 (section 0, which also gains the paragraph on Windows and the processor), Alpha notice 1.1 (what an alpha is, the hardware, the pause), the accuracy statement's line and its two copies. The texts were approved with the plan of 2026-11-11. - Shared.AlphaLine: IsPrerelease(the runtime's description) and Rests, stamped from Directory.Build.props' FlAlphaLineRests (true on main since beta.37; set to false on the alpha branch when it tries a newer .NET). App/Services/AlphaTexts picks the banner and About's line from the two facts; a prerelease runtime is said whatever the stamp says. - Strings in en, vi and ja: the banner and About's line no longer say "a prerelease .NET" unconditionally; three new keys. - guide (the alphas are paused: install the beta; a paused alpha's anti-cheat list is not updated; ten betas after alpha.4 hide it from older alphas), LIMITATIONS, 11_UPDATER, 12_BUILD, 08_UI, the wiki. Co-authored-by: Claude Fable 5.2 <noreply@anthropic.com>
This commit is contained in:
1 parent
49d7bd8e51
commit
1c60c87b92
29 files changed
+368
-63
No files matched your search
@@ -58,6 +58,19 @@ numeric core and does not move; the heading is the full version — corrected 20
|
||||
that runs on .NET 11 alone; Qodana's container installs the .NET 11 SDK before it builds (an interim, until the
|
||||
Ultimate linter); two `string.StartsWith`/`EndsWith(char)` calls in the App's tests name the comparison .NET 11's
|
||||
analyzer asks for; `HostBackgroundFailureTests` holds .NET 11's `IHost.RunAsync` behaviour.
|
||||
- **What an alpha is, now that .NET 11 has shipped** (owner decisions D97 and D98). Until 0.1.0-alpha.3 an alpha was
|
||||
"a beta's source built on a prerelease .NET", and every text said so. 0.1.0-alpha.4 runs on .NET 11's release — the
|
||||
betas' own from this version — so an alpha is now described as *a beta's source built to try a newer version of
|
||||
.NET, at times a prerelease one*: **EULA 1.7** (§2B), **Disclaimer 2.14** (§0, which also gains a paragraph on
|
||||
Windows and the processor), **Alpha notice 1.1** (what an alpha is, the hardware, and a new part on the pause), the
|
||||
accuracy statement's line, the guide and `LIMITATIONS.md`. The terms window shows the EULA and the Disclaimer once
|
||||
more; an alpha asks for its notice's tick again.
|
||||
- **The alphas pause after 0.1.0-alpha.4, and a paused alpha says so** (D98). With the betas on the same .NET there is
|
||||
nothing for an alpha to try, so none is published until a newer .NET has a preview — and a paused alpha gets no
|
||||
update, the anti-cheat list included, which reaches FrameLedger only inside one. An alpha cut while the line rests
|
||||
shows, above every page, that the line is paused and to install the latest beta; the words "a prerelease .NET" now
|
||||
appear only in an alpha that really runs on one. For developers: `FlAlphaLineRests` in `Directory.Build.props`,
|
||||
stamped into every assembly, `Shared.AlphaLine`, `App/Services/AlphaTexts`; three new strings in en, vi and ja.
|
||||
|
||||
## Releases
|
||||
|
||||
|
||||
+12
-2
@@ -73,17 +73,27 @@
|
||||
<IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
|
||||
|
||||
<!-- D73 (2026-10-31): the RELEASE LINE, from the RELEASE_LINE file beside VERSION - `main`, the betas and releases on
|
||||
the .NET that global.json pins, or `alpha`, a beta's source built on a prerelease .NET from the long-lived `alpha`
|
||||
branch, where this file and global.json are two of the few lines that differ (docs/12_BUILD.md §The alpha line).
|
||||
the .NET that global.json pins, or `alpha`, a beta's source built to try a newer .NET from the long-lived `alpha`
|
||||
branch, where this file and global.json are two of the few lines that differ while it does (docs/12_BUILD.md
|
||||
§The alpha line).
|
||||
Not a property a command line sets: the file is the one source, release.yml refuses a tag that disagrees with it,
|
||||
and the target below refuses a value that is neither line. Every assembly carries it (the ItemGroup below), and
|
||||
Shared.BuildLine reads it at run time. -->
|
||||
<FrameLedgerReleaseLineFile>$(MSBuildThisFileDirectory)RELEASE_LINE</FrameLedgerReleaseLineFile>
|
||||
<FlReleaseLine Condition="Exists('$(FrameLedgerReleaseLineFile)')">$([System.IO.File]::ReadAllText('$(FrameLedgerReleaseLineFile)').Trim())</FlReleaseLine>
|
||||
|
||||
<!-- D98 (2026-11-11): THE ALPHA LINE RESTS - the betas build on the same .NET as the newest alpha (0.1.0-alpha.4,
|
||||
.NET 11.0.0), so no alpha is cut until a newer .NET is tried. An alpha built while this says true tells its user
|
||||
that the line is paused and to install the beta: a resting alpha gets no update, its anti-cheat list included
|
||||
(Shared.AlphaLine, App/Services/AlphaTexts). Stamped on both lines, read by an alpha alone. When the `alpha`
|
||||
branch starts trying a newer .NET it sets this to false there - one more line of its switch (docs/12_BUILD.md
|
||||
§The alpha line). -->
|
||||
<FlAlphaLineRests>true</FlAlphaLineRests>
|
||||
</PropertyGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<AssemblyMetadata Include="FrameLedger.ReleaseLine" Value="$(FlReleaseLine)" />
|
||||
<AssemblyMetadata Include="FrameLedger.AlphaLineRests" Value="$(FlAlphaLineRests)" />
|
||||
</ItemGroup>
|
||||
|
||||
<Target Name="FrameLedgerReleaseLineCheck" BeforeTargets="BeforeBuild" Condition="'$(FlReleaseLine)' != 'main' And '$(FlReleaseLine)' != 'alpha'">
|
||||
|
||||
+6
-2
@@ -289,9 +289,13 @@ releases unless you choose *Beta* in Settings ▸ Updates, and apply a downloade
|
||||
*Only for an alpha — a version ending in `-alpha.N`, an experimental build on a new .NET
|
||||
([Alpha builds](guide/11-alpha-builds.md)).*
|
||||
|
||||
- **It runs on a .NET that Microsoft has not finished** — .NET 11's release candidate first — and has not been tested
|
||||
the way a beta is: everything on this page applies to it, and so can problems no beta has shown
|
||||
- **It is built to try a newer .NET — at times one Microsoft has not finished** — and has not been tested the way a
|
||||
beta is: everything on this page applies to it, and so can problems no beta has shown
|
||||
([Alpha notice](legal/ALPHA_NOTICE.md)).
|
||||
- **The alphas are paused since 0.1.0-alpha.4, and a paused alpha gets no updates** — the list of anti-cheat software
|
||||
it refuses included, which arrives only inside an update. The betas run on the same .NET 11 since 0.1.0-beta.37:
|
||||
install the latest beta over the alpha. Once ten betas have followed 0.1.0-alpha.4, an older alpha no longer finds
|
||||
it as an update ([Updater](docs/11_UPDATER.md)).
|
||||
- **It shares the beta's data folder.** It copies the database into `backups` before it first opens it, and does not
|
||||
open it if the copy cannot be made; the newest three copies are kept and older ones it made are deleted.
|
||||
- **It updates only to newer alphas**, and its update channel is locked; going back to the beta means installing the
|
||||
|
||||
@@ -14,7 +14,7 @@ app too (Help ▸ User guide, Help ▸ Limitations, Help ▸ Accessibility), and
|
||||
<!-- accuracy-block:begin -->
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-11-06.** The software is a beta; its latest
|
||||
> **beta is `0.1.0-beta.36`** (2026-11-10), an unsigned installer built from that tag with its
|
||||
> checksums published beside it (alphas — experimental builds on a prerelease .NET — are published apart). The source holds the desktop app
|
||||
> checksums published beside it (alphas — experimental builds that try a newer .NET — are published apart). 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
|
||||
> and only past the safety guard, and
|
||||
|
||||
+1
-1
@@ -924,7 +924,7 @@ Agent section: elevation state with a plain explanation of what elevation *optio
|
||||
> `Infrastructure.Startup.RunAtLogon` — this user's `HKCU\…\Run` value, quoted executable path, never HKLM —
|
||||
> and the Run entry is the truth the toggle loads from; "Minimize to tray on close" is stored now and honoured
|
||||
> when the tray exists. **Privacy:** ~~`privacy.online_metadata`, off by default, with the network sentence~~ — the card is not shown since 2026-09-16 (no code makes the request; the setting stays reserved).
|
||||
> **Updates (alpha, D73, 2026-10-31):** in an alpha build the channel picker is locked and its line reads *An alpha build updates only to newer alphas, whatever is chosen here…* — an alpha's packages are on Velopack's own channel (`11_UPDATER` §Channels). **The alpha's shell (D74):** an **ALPHA** badge left of the Agent pill in the title bar for as long as it runs (its tooltip names `RuntimeInformation.FrameworkDescription`), the window and taskbar titled *FrameLedger Alpha*, and a Warning InfoBar above every page at every start, closable for that run, whose button opens the Alpha notice; About's version line names the runtime on every line, and `--diag` prints `release_line:` and the runtime's description.
|
||||
> **Updates (alpha, D73, 2026-10-31):** in an alpha build the channel picker is locked and its line reads *An alpha build updates only to newer alphas, whatever is chosen here…* — an alpha's packages are on Velopack's own channel (`11_UPDATER` §Channels). **The alpha's shell (D74):** an **ALPHA** badge left of the Agent pill in the title bar for as long as it runs (its tooltip names `RuntimeInformation.FrameworkDescription`), the window and taskbar titled *FrameLedger Alpha*, and a Warning InfoBar above every page at every start, closable for that run, whose button opens the Alpha notice *(since beta.37, D97 and D98: its text is one of three — the experimental-build warning; the same naming "a prerelease .NET" where the runtime's description is a prerelease's; or, in an alpha cut while the alpha line rests, that the line is paused and to install the beta — `Services/AlphaTexts`, `Shared.AlphaLine`)*; About's version line names the runtime on every line, and `--diag` prints `release_line:` and the runtime's description.
|
||||
>
|
||||
> **Updates:** `update.channel` is read by PR-5's updater (beta = GitHub pre-releases; since beta.14 *Automatic (Beta)* or *(Stable)* first, the default, following the running copy — D47), and `update.auto_check` — the startup check, on by default — sits beside it. **Logging:** `log.debug` moves this app's `LoggingLevelSwitch` at
|
||||
> once; the Agent has no reader for the key yet, and the row says so. **Legal:** reopen is a "not yet" line
|
||||
|
||||
+1
-1
@@ -98,7 +98,7 @@ flow, and the tests run the flow over a fake client because nothing here may tou
|
||||
never sees a beta, under either setting of `update.channel` — and in an alpha build that picker is locked, its line
|
||||
saying so (`08_UI` §Settings). **One limit follows from the source, read from Velopack's code 2026-10-31:** it asks
|
||||
GitHub for one page of ten releases, newest first, so ten releases of one line in a row would hide the other line's
|
||||
newest from its update check. The cadence is one alpha per beta (`13_CI_CD` §The alpha line). Moving between the lines
|
||||
newest from its update check. The cadence is one alpha per beta (`13_CI_CD` §The alpha line) — *while the line tries a .NET; it rests since 0.1.0-alpha.4 (D98, 2026-11-11), betas then follow one another with no alpha between, and once ten of them have been published after alpha.4 a copy of alpha.3 or older no longer finds it: the alpha's notes, the guide and its banner say to install the beta.* Moving between the lines
|
||||
is a deliberate install, never an update: the other line's `Setup.exe` over the installed copy, which Velopack answers
|
||||
with its overwrite prompt — the packId, the install folder and the data folder are the same.)*
|
||||
- **Hooks** (`VelopackHooks`, in the hand-written `Program.Main` so `VelopackApp.Run()` precedes any window):
|
||||
|
||||
+7
-2
@@ -208,13 +208,18 @@ Release Candidate 3 in alpha.1 to alpha.3 (2026-10-31 to 2026-11-06), the releas
|
||||
until a newer .NET has a preview to try (.NET 12's, expected in 2027). While the line rests, the `alpha` branch differs
|
||||
from main in **`RELEASE_LINE` alone** (`git diff main alpha --name-only` prints that one name), and a resting alpha
|
||||
gets no update: its anti-cheat list, which reaches a user only inside a release (`13_CI_CD` §rules-publish.yml), stays
|
||||
the one it shipped with. Its notes, the guide and the Alpha notice tell its user to install the beta.
|
||||
the one it shipped with. Its notes, the guide and the Alpha notice tell its user to install the beta — **and the build
|
||||
itself does**: `Directory.Build.props` stamps its `FlAlphaLineRests` property (true on main since beta.37) into every
|
||||
assembly, `Shared.AlphaLine.Rests` reads it, and an alpha cut while it is true shows a banner that says the line is
|
||||
paused and to install the beta, in place of the experimental-build one (`App/Services/AlphaTexts`; D97: the words
|
||||
"a prerelease .NET" appear only where the runtime's own description is a prerelease's).
|
||||
- **The switch — what `alpha` differs from main in while it tries a newer .NET, and nothing else:** `RELEASE_LINE`
|
||||
(`alpha`); `global.json` (that SDK, with `allowPrerelease: true` when it is a prerelease); the TFM in
|
||||
`Directory.Build.props` (`SupportedOSPlatformVersion` stays `10.0.19045.0`); the three Microsoft packages in
|
||||
`Directory.Packages.props` that are serviced with the runtime (`Microsoft.Extensions.Hosting`,
|
||||
`System.Diagnostics.EventLog`, `Microsoft.Data.Sqlite`); `legal/licenses/nuget/` regenerated for that package set and
|
||||
the *Transitive* row of `legal/THIRD_PARTY_NOTICES.md`; and a fix only the newer .NET can take, if one is ever forced.
|
||||
the *Transitive* row of `legal/THIRD_PARTY_NOTICES.md`; `FlAlphaLineRests` set to `false` in `Directory.Build.props`;
|
||||
and a fix only the newer .NET can take, if one is ever forced.
|
||||
As it stood for .NET 11 RC3: SDK `11.0.100-rc.3.26522.148`, `net11.0-windows10.0.22621.0`, the three packages at
|
||||
`11.0.0-rc.3.26522.148` (`spike-notes` §24). **No newer language syntax and no preview feature on `alpha`** (D76): the
|
||||
source is main's, and main compiles with its own SDK.
|
||||
|
||||
@@ -521,6 +521,7 @@ Where each owner decision is recorded — the file and its section, and a label
|
||||
| D94 | [`12_BUILD.md`](12_BUILD.md) §The main line's .NET | the main line moves to .NET 11 with 0.1.0-beta.37, the day after it shipped; condition (a) of `20_OPEN_QUESTIONS` §G's table — two alphas on the released runtime — set aside by the owner, not met |
|
||||
| D95 | [`02_SPEC.md`](02_SPEC.md) NFR-8 | Windows 10 22H2 is not blocked, and is stated as untested and unsupported (Microsoft supports .NET 11 on Windows 11); a processor needs SSE4.2 and POPCNT |
|
||||
| D96 | [`12_BUILD.md`](12_BUILD.md) §The main line's .NET | C# 15 on the main line from beta.37, a construct only where the required checks read it; no preview feature |
|
||||
| D97 | [`../legal/ALPHA_NOTICE.md`](../legal/ALPHA_NOTICE.md) | an alpha is "a beta's source built to try a newer version of .NET, at times a prerelease one": EULA 1.7, Disclaimer 2.14 (with a paragraph on Windows and the processor), Alpha notice 1.1, approved with the plan; the App says "a prerelease .NET" only where the runtime is one |
|
||||
| D98 | [`12_BUILD.md`](12_BUILD.md) §The alpha line | alpha.4 is beta.37's source on .NET 11.0.0, and then the alpha line rests until a newer .NET has a preview; a resting alpha tells its user to install the beta |
|
||||
|
||||
---
|
||||
|
||||
+23
-11
@@ -2,14 +2,25 @@
|
||||
|
||||
## What an alpha is
|
||||
|
||||
Besides the betas, FrameLedger publishes **alphas**: the same program as a beta, built on a version of .NET that
|
||||
Microsoft has not finished yet — .NET 11's release candidate first. They exist so that a new .NET can be tried before the
|
||||
betas move to it. An alpha's version ends in `-alpha.N` (`0.1.0-alpha.1`), its page on GitHub says *experimental alpha*,
|
||||
and its installer is `FrameLedger.App-alpha-Setup.exe`.
|
||||
Besides the betas, FrameLedger publishes **alphas**: the same program as a beta, built to try a newer version of .NET —
|
||||
sometimes one Microsoft has not finished yet. They exist so that a new .NET can be tried before the betas rely on it. An
|
||||
alpha's version ends in `-alpha.N` (`0.1.0-alpha.1`), its page on GitHub says *experimental alpha*, and its installer is
|
||||
`FrameLedger.App-alpha-Setup.exe`.
|
||||
|
||||
**If you want results you can rely on, use the beta.** An alpha can crash, record wrongly or fail to update in ways no
|
||||
beta has. The part of FrameLedger that goes into a game is the beta's own and does not use .NET; everything that starts
|
||||
it, reads it and stores what it measured runs on the new .NET.
|
||||
it, reads it and stores what it measured runs on the alpha's .NET.
|
||||
|
||||
## Right now: the alphas are paused
|
||||
|
||||
The alphas tried .NET 11. Since 0.1.0-beta.37 the betas run on .NET 11 too, so **0.1.0-alpha.4 is the last alpha for
|
||||
now**: it brings an installed alpha onto the finished .NET 11, and after it no alpha is published until there is a newer
|
||||
.NET to try.
|
||||
|
||||
A paused alpha gets **no updates** — no fixes, and not the list of anti-cheat software FrameLedger refuses to touch, which
|
||||
only arrives inside an update. Its banner tells you so. **Install the latest beta over it** (below); your data stays.
|
||||
One more thing: once ten betas have been published after 0.1.0-alpha.4, an older alpha can no longer find it as an
|
||||
update, and installing the beta by hand is the only way forward.
|
||||
|
||||
## Before it runs
|
||||
|
||||
@@ -18,7 +29,8 @@ tick: *I understand that this is an experimental build and I use it at my own ri
|
||||
Until you accept, the alpha's capture agent does not run at all. The notice is shown again whenever its text changes.
|
||||
|
||||
While an alpha runs, the title bar carries an **ALPHA** badge (hover it to see the .NET version), and a yellow banner
|
||||
above every page says what it is each time it starts; you can close the banner for that run. **Help ▸ About** names the
|
||||
above every page says what it is each time it starts — while the alphas are paused, that they are, and to install the
|
||||
beta; you can close the banner for that run. **Help ▸ About** names the
|
||||
.NET it runs on.
|
||||
|
||||
## Your data
|
||||
@@ -45,9 +57,9 @@ alpha.
|
||||
|
||||
## Windows and your PC
|
||||
|
||||
Microsoft supports .NET 11 on Windows 11 24H2 and later; on Windows 10 only in its LTSC and IoT editions. An alpha may
|
||||
work on Windows 10 22H2 Home or Pro, but nobody supports it there. .NET 11 also needs a processor with SSE4.2 and POPCNT,
|
||||
which every processor Windows 11 accepts has; on an older one the alpha does not start at all.
|
||||
An alpha needs what a beta needs since 0.1.0-beta.37 ([Install](01-install.md)): Microsoft supports .NET 11 on
|
||||
Windows 11; on Windows 10 (22H2) FrameLedger may run, but it is not tested there and nobody supports it; and on a
|
||||
processor without SSE4.2 and POPCNT it does not start at all.
|
||||
|
||||
A release candidate stops being supported by Microsoft when the final version ships — for .NET 11's, 10 November 2026 —
|
||||
and the next alpha moves to the final version.
|
||||
When an alpha runs on a .NET Microsoft has not finished, Microsoft stops supporting that version when the finished one
|
||||
ships, and the next alpha moves to the finished one.
|
||||
+1
-1
@@ -13,7 +13,7 @@
|
||||
-->
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-11-06.** The software is a beta; its latest
|
||||
> **beta is `0.1.0-beta.36`** (2026-11-10), an unsigned installer built from that tag with its
|
||||
> checksums published beside it (alphas — experimental builds on a prerelease .NET — are published apart). The source holds the desktop app
|
||||
> checksums published beside it (alphas — experimental builds that try a newer .NET — are published apart). 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
|
||||
> and only past the safety guard, and
|
||||
|
||||
+22
-16
@@ -1,10 +1,11 @@
|
||||
# FrameLedger — Alpha notice
|
||||
|
||||
**Version:** 1.0 · **Effective:** {{RELEASE_DATE}}
|
||||
**Version:** 1.1 · **Effective:** {{RELEASE_DATE}}
|
||||
|
||||
<!-- Owner decisions D73-D76 (2026-10-31): the text below was approved with the plan. Shared.AlphaNotice.Version must
|
||||
equal the version above (AlphaNoticeTests); an alpha build's Legal Gate shows this document with its own tick box,
|
||||
and an alpha's Agent does not serve until it is accepted at this version. -->
|
||||
<!-- Owner decisions D73-D76 (2026-10-31): the text was approved with the plan. Version 1.1 (owner decisions D97 and D98,
|
||||
2026-11-11: what an alpha is once .NET 11 has shipped, and the line's pause) was approved with that day's plan.
|
||||
Shared.AlphaNotice.Version must equal the version above (LegalDocumentsTests); an alpha build's Legal Gate shows this
|
||||
document with its own tick box, and an alpha's Agent does not serve until it is accepted at this version. -->
|
||||
|
||||
This notice applies only to **alpha** builds of FrameLedger (versions named `x.y.z-alpha.N`). An alpha build shows it, and
|
||||
it must be accepted, before the build runs. It adds to the EULA, the Disclaimer and the Privacy Policy and takes nothing
|
||||
@@ -12,16 +13,18 @@ away from them; nothing in it limits your rights under the GPL-3.0.
|
||||
|
||||
## 1. What an alpha build is
|
||||
|
||||
An alpha build is the source of a published beta, built for and run on a **prerelease version of .NET** — when this
|
||||
notice was written, .NET 11 Release Candidate 3 — with the matching C# compiler. It exists so that a new .NET can be tried
|
||||
before FrameLedger's regular builds move to it. The runtime, its libraries and its compiler are prerelease software from
|
||||
Microsoft, and FrameLedger has not been tested on them the way a beta is.
|
||||
An alpha build is the source of a published beta, built to try a newer version of .NET — at times a **prerelease
|
||||
version** — with the matching C# compiler. When this notice was written the alpha ran on .NET 11.0.0, Microsoft's final
|
||||
release of .NET 11, which the betas moved to in 0.1.0-beta.37; the alphas before it ran on its Release Candidate 3, and a
|
||||
later alpha may run on a prerelease of the next .NET. It exists so that a new .NET can be tried before FrameLedger's
|
||||
regular builds rely on it. When the runtime is a prerelease, it, its libraries and its compiler are prerelease software
|
||||
from Microsoft, and the build says so. In either case FrameLedger has not been tested on an alpha the way a beta is.
|
||||
|
||||
## 2. What can go wrong
|
||||
|
||||
Everything the Disclaimer says about pre-release builds (§0), and more: an alpha may crash, hang, fail to record, record
|
||||
wrongly or fail to update in ways no beta has shown. The component loaded into a game is the same native code as the
|
||||
beta's and does not use .NET; everything that starts it, reads it, computes from it and stores it runs on the prerelease
|
||||
beta's and does not use .NET; everything that starts it, reads it, computes from it and stores it runs on the alpha's
|
||||
runtime.
|
||||
|
||||
## 3. Your data
|
||||
@@ -32,9 +35,9 @@ open the ledger if that copy cannot be made. Sessions an alpha records stay in t
|
||||
|
||||
## 4. Windows and hardware
|
||||
|
||||
Microsoft supports .NET 11 on Windows 11 24H2 and later, and on Windows 10 only in its LTSC and IoT editions. An alpha may
|
||||
run on Windows 10 22H2 Home or Pro, but nobody supports it there. .NET 11 needs a processor with SSE4.2 and POPCNT
|
||||
(x86-64-v2) and does not start without them.
|
||||
Microsoft supports .NET 11 on Windows 11, and on Windows 10 only in its LTSC and IoT editions. An alpha — as a beta does
|
||||
from 0.1.0-beta.37 — may run on Windows 10 22H2 Home or Pro, but it is untested there and nobody supports it. .NET 11
|
||||
needs a processor with SSE4.2 and POPCNT (x86-64-v2) and does not start without them.
|
||||
|
||||
## 5. Your responsibility
|
||||
|
||||
@@ -42,9 +45,12 @@ You install and run an alpha build **entirely at your own risk**. It comes with
|
||||
the developer is not responsible for any incident, loss or damage that results from using it (EULA §6, Disclaimer §0). If
|
||||
you need dependable results, use the beta.
|
||||
|
||||
## 6. Updates, and going back
|
||||
## 6. Updates, the pause, and going back
|
||||
|
||||
An alpha updates only to newer alphas, and a beta only to newer betas; neither becomes the other by itself. To go back,
|
||||
install the latest beta from the project's GitHub Releases over the alpha; your ledger stays where it is. A release
|
||||
candidate stops being supported by Microsoft when the final release ships (for .NET 11 RC3, 10 November 2026); the next
|
||||
alpha moves to it.
|
||||
install the latest beta from the project's GitHub Releases over the alpha; your ledger stays where it is.
|
||||
|
||||
A prerelease .NET stops being supported by Microsoft when its final release ships; the next alpha moves to it. **When the
|
||||
betas run on the same .NET as the newest alpha, the alpha line pauses**: no further alpha is published until a newer .NET
|
||||
is tried, and a paused alpha receives no updates — its list of anti-cheat software included, which reaches FrameLedger
|
||||
only inside an update. A paused alpha says so when it starts. Install the latest beta over it.
|
||||
+9
-4
@@ -1,18 +1,23 @@
|
||||
# FrameLedger — Disclaimer
|
||||
|
||||
**Version:** 2.13 · **Effective:** {{RELEASE_DATE}}
|
||||
**Version:** 2.14 · **Effective:** {{RELEASE_DATE}}
|
||||
|
||||
## 0. This is pre-release software
|
||||
|
||||
**FrameLedger is pre-release software.** Every build published so far is a pre-release: a beta, or an alpha — a beta's
|
||||
source built on a prerelease version of .NET, with the further risks set out in the Alpha notice
|
||||
(`legal/ALPHA_NOTICE.md`, shown before an alpha build runs). It has been tested on a small number of
|
||||
source built to try a newer version of .NET, at times a prerelease one, with the further risks set out in the Alpha
|
||||
notice (`legal/ALPHA_NOTICE.md`, shown before an alpha build runs). It has been tested on a small number of
|
||||
machines and games — the games are listed in `docs/LIST_GAME_TESTED.md` in the project's repository, and what the software
|
||||
cannot do is listed in `LIMITATIONS.md` there and in the app under Help ▸ Limitations — and **it certainly still contains
|
||||
bugs — some of them not yet known to anyone.** Features can
|
||||
change or disappear between builds, recorded data can turn out to be wrong, and an update can require your data to be
|
||||
migrated.
|
||||
|
||||
**Windows and your processor.** From 0.1.0-beta.37 FrameLedger is built on .NET 11. Microsoft supports .NET 11 on
|
||||
Windows 11, and on Windows 10 only in its LTSC and IoT editions. FrameLedger has been run on Windows 11 only: on
|
||||
Windows 10 22H2 Home or Pro it may run, but it is untested there and nobody supports it. It does not start on a
|
||||
processor without SSE4.2 and POPCNT.
|
||||
|
||||
By installing or running a pre-release build you accept that:
|
||||
|
||||
- it may crash, hang, fail to record, or record wrongly, and may cause the game you are measuring to do the same;
|
||||
@@ -117,7 +122,7 @@ Frame timing is derived from high-resolution timestamps taken at the moment the
|
||||
<!-- accuracy-block:begin -->
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-11-06.** The software is a beta; its latest
|
||||
> **beta is `0.1.0-beta.36`** (2026-11-10), an unsigned installer built from that tag with its
|
||||
> checksums published beside it (alphas — experimental builds on a prerelease .NET — are published apart). The source holds the desktop app
|
||||
> checksums published beside it (alphas — experimental builds that try a newer .NET — are published apart). 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
|
||||
> and only past the safety guard, and
|
||||
|
||||
+3
-3
@@ -1,6 +1,6 @@
|
||||
# FrameLedger — End User License Agreement (EULA)
|
||||
|
||||
**Version:** 1.6 · **Effective:** {{RELEASE_DATE}}
|
||||
**Version:** 1.7 · **Effective:** {{RELEASE_DATE}}
|
||||
|
||||
This End User License Agreement ("Agreement") applies to **FrameLedger** ("the Software"), developed and published by **poli0981** ("the Developer"), contactable at <contact@poli0981.dev> — see <https://poli0981.dev/> for other contact channels.
|
||||
|
||||
@@ -33,8 +33,8 @@ The Software records without injecting unless you enable injection for a specifi
|
||||
## 2B. Pre-release software, and your PC
|
||||
|
||||
The Software is currently distributed only as **pre-release builds** — **betas**, and **alphas**: a beta's source built
|
||||
on a prerelease version of .NET, with the further risks the Alpha notice describes (`legal/ALPHA_NOTICE.md`) — which
|
||||
certainly still contain defects (Disclaimer §0). You use a pre-release build at your own risk, and the Developer is not
|
||||
to try a newer version of .NET, at times a prerelease one, with the further risks the Alpha notice describes
|
||||
(`legal/ALPHA_NOTICE.md`) — which certainly still contain defects (Disclaimer §0). You use a pre-release build at your own risk, and the Developer is not
|
||||
responsible for any incident that results.
|
||||
|
||||
You are responsible for making sure your PC meets at least the minimum system requirements published by the developer
|
||||
|
||||
@@ -101,7 +101,7 @@ internal static class Program
|
||||
// Before anything else. The guard reads this file on every evaluation and refuses every title
|
||||
// when it is absent, so a capture started before the seed lands would fail for a reason that
|
||||
// has nothing to do with the game (§S20).
|
||||
// D73: which line this build is, on which runtime - an alpha's prerelease .NET is the first thing its log says.
|
||||
// D73: which line this build is, on which runtime - the first thing the log says, an alpha's above all.
|
||||
Log.Information("agent: release line {Line}, {Runtime}", BuildLine.Current, RuntimeInformation.FrameworkDescription);
|
||||
RulesSeedOutcome seeded = await new RulesSeeder(new FileSystemRulesStore()).EnsureSeededAsync().ConfigureAwait(false);
|
||||
AgentConsole.Line($"rules: {Describe(seeded)}");
|
||||
|
||||
@@ -0,0 +1,40 @@
|
||||
// SPDX-License-Identifier: GPL-3.0-only
|
||||
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
|
||||
|
||||
using System.Diagnostics.CodeAnalysis;
|
||||
using System.Globalization;
|
||||
using FrameLedger.Shared;
|
||||
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>
|
||||
/// What an alpha build says about the .NET it runs on (owner decisions D97 and D98, 2026-11-11). Until 0.1.0-alpha.3 every
|
||||
/// alpha ran on a prerelease and the texts said so unconditionally; 0.1.0-alpha.4 runs on .NET 11's release, the betas'
|
||||
/// own from 0.1.0-beta.37, and its line rests after it. So the words follow two facts handed in here rather than read
|
||||
/// here - a test gives each combination: the runtime's description, and whether the build was cut while the line rested.
|
||||
/// </summary>
|
||||
internal static class AlphaTexts
|
||||
{
|
||||
/// <summary>
|
||||
/// The banner above every page of an alpha. A prerelease runtime is said first: it is what the process can see for
|
||||
/// itself, and a line that tries a prerelease is not resting whatever the build was stamped with.
|
||||
/// </summary>
|
||||
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format string is a resource that follows the UI culture")]
|
||||
public static string BannerBody(bool rests, string runtime)
|
||||
{
|
||||
string format = AlphaLine.IsPrerelease(runtime) ? Strings.Alpha_Banner_Body_Prerelease_Format
|
||||
: rests ? Strings.Alpha_Banner_Body_Resting_Format
|
||||
: Strings.Alpha_Banner_Body_Format;
|
||||
return string.Format(CultureInfo.CurrentCulture, format, runtime);
|
||||
}
|
||||
|
||||
/// <summary>About's line naming the runtime: a beta's, an alpha's, and an alpha's on a prerelease.</summary>
|
||||
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format string is a resource that follows the UI culture")]
|
||||
public static string AboutRuntime(bool alpha, string runtime)
|
||||
{
|
||||
string format = !alpha ? Strings.About_Runtime_Format
|
||||
: AlphaLine.IsPrerelease(runtime) ? Strings.About_Runtime_Alpha_Prerelease_Format
|
||||
: Strings.About_Runtime_Alpha_Format;
|
||||
return string.Format(CultureInfo.CurrentCulture, format, runtime);
|
||||
}
|
||||
}
|
||||
@@ -34,7 +34,7 @@ public static class DiagReport
|
||||
sb.AppendLine(CultureInfo.InvariantCulture, $"FrameLedger --diag {now.ToString("O", CultureInfo.InvariantCulture)}");
|
||||
sb.AppendLine(CultureInfo.InvariantCulture, $"app_version: {appVersion}");
|
||||
sb.AppendLine(CultureInfo.InvariantCulture, $"os: {Environment.OSVersion.VersionString} ({(Environment.Is64BitOperatingSystem ? "x64" : "x86")}), process {(Environment.Is64BitProcess ? "x64" : "x86")}");
|
||||
// D73: the release line and the runtime's own description - an alpha's prerelease .NET reads ".NET 11.0.0-rc.3...".
|
||||
// D73: the release line and the runtime's own description - a prerelease .NET reads ".NET 11.0.0-rc.3...", a released one ".NET 11.0.0".
|
||||
sb.AppendLine(CultureInfo.InvariantCulture, $"release_line: {Shared.BuildLine.Current}");
|
||||
sb.AppendLine(CultureInfo.InvariantCulture, $"runtime: {System.Runtime.InteropServices.RuntimeInformation.FrameworkDescription} ({Environment.Version})");
|
||||
sb.AppendLine(CultureInfo.InvariantCulture, $"locale: {CultureInfo.CurrentUICulture.Name}");
|
||||
|
||||
@@ -37,7 +37,7 @@ public static partial class LegalDocuments
|
||||
|
||||
/// <summary>
|
||||
/// The four documents, in the order the gate shows them — and on the alpha line the Alpha notice after them, accepted
|
||||
/// with them (D74, 2026-10-31): an alpha is a beta's source on a prerelease .NET, and its user accepts that first.
|
||||
/// with them (D74, 2026-10-31): an alpha is a beta's source built to try a newer .NET, and its user accepts that first.
|
||||
/// </summary>
|
||||
public static IReadOnlyList<LegalDocument> Load(BuildLine line)
|
||||
{
|
||||
|
||||
Generated
+9
@@ -86,6 +86,7 @@ public static class Strings
|
||||
nameof(About_OpenLicencesFolder),
|
||||
nameof(About_OpenSource),
|
||||
nameof(About_Runtime_Alpha_Format),
|
||||
nameof(About_Runtime_Alpha_Prerelease_Format),
|
||||
nameof(About_Runtime_Format),
|
||||
nameof(About_Tab_App),
|
||||
nameof(About_Tab_Legal),
|
||||
@@ -117,6 +118,8 @@ public static class Strings
|
||||
nameof(Alpha_Badge),
|
||||
nameof(Alpha_Badge_Tooltip_Format),
|
||||
nameof(Alpha_Banner_Body_Format),
|
||||
nameof(Alpha_Banner_Body_Prerelease_Format),
|
||||
nameof(Alpha_Banner_Body_Resting_Format),
|
||||
nameof(Alpha_Banner_Read),
|
||||
nameof(Alpha_Banner_Title),
|
||||
nameof(App_Title),
|
||||
@@ -1376,6 +1379,8 @@ public static class Strings
|
||||
|
||||
public static string About_Runtime_Alpha_Format => ResourceManager.GetString(nameof(About_Runtime_Alpha_Format), Culture) ?? nameof(About_Runtime_Alpha_Format);
|
||||
|
||||
public static string About_Runtime_Alpha_Prerelease_Format => ResourceManager.GetString(nameof(About_Runtime_Alpha_Prerelease_Format), Culture) ?? nameof(About_Runtime_Alpha_Prerelease_Format);
|
||||
|
||||
public static string About_Runtime_Format => ResourceManager.GetString(nameof(About_Runtime_Format), Culture) ?? nameof(About_Runtime_Format);
|
||||
|
||||
public static string About_Tab_App => ResourceManager.GetString(nameof(About_Tab_App), Culture) ?? nameof(About_Tab_App);
|
||||
@@ -1438,6 +1443,10 @@ public static class Strings
|
||||
|
||||
public static string Alpha_Banner_Body_Format => ResourceManager.GetString(nameof(Alpha_Banner_Body_Format), Culture) ?? nameof(Alpha_Banner_Body_Format);
|
||||
|
||||
public static string Alpha_Banner_Body_Prerelease_Format => ResourceManager.GetString(nameof(Alpha_Banner_Body_Prerelease_Format), Culture) ?? nameof(Alpha_Banner_Body_Prerelease_Format);
|
||||
|
||||
public static string Alpha_Banner_Body_Resting_Format => ResourceManager.GetString(nameof(Alpha_Banner_Body_Resting_Format), Culture) ?? nameof(Alpha_Banner_Body_Resting_Format);
|
||||
|
||||
public static string Alpha_Banner_Read => ResourceManager.GetString(nameof(Alpha_Banner_Read), Culture) ?? nameof(Alpha_Banner_Read);
|
||||
|
||||
public static string Alpha_Banner_Title => ResourceManager.GetString(nameof(Alpha_Banner_Title), Culture) ?? nameof(Alpha_Banner_Title);
|
||||
|
||||
@@ -4798,9 +4798,17 @@
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Alpha_Banner_Body_Format" xml:space="preserve">
|
||||
<value>試験版:{0} で動作するアルファ版です。結果が誤っていたり、クラッシュしたりすることがあります。ご利用は自己責任です。安定して使えるのはベータ版です。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Alpha_Banner_Body_Prerelease_Format" xml:space="preserve">
|
||||
<value>試験版:プレリリース版の .NET である {0} で動作しています。結果が誤っていたり、クラッシュしたりすることがあります。ご利用は自己責任です。安定して使えるのはベータ版です。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Alpha_Banner_Body_Resting_Format" xml:space="preserve">
|
||||
<value>アルファ版の提供は一時停止中です。ベータ版も {0} で動作するようになり、更新を受け取るのはベータ版だけです(アンチチートのリストも含みます)。最新のベータ版をこのアルファ版に上書きインストールしてください。データはそのまま残ります。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Alpha_Banner_Read" xml:space="preserve">
|
||||
<value>アルファ版の通知を読む</value>
|
||||
<comment>review</comment>
|
||||
@@ -4811,7 +4819,7 @@
|
||||
</data>
|
||||
<data name="FirstRun_Alpha_Summary" xml:space="preserve">
|
||||
<value>これはアルファ版です:
|
||||
• ベータ版のソースをプレリリース版の .NET でビルドしたものです。測定値の誤りやクラッシュを含め、ベータ版より多くの問題が起こることを想定してください。
|
||||
• ベータ版のソースを、より新しい .NET(プレリリース版の場合もあります)を試すためにビルドしたものです。測定値の誤りやクラッシュを含め、ベータ版より多くの問題が起こることを想定してください。
|
||||
• この PC のベータ版を置き換え、そのデータを共有します。初めて台帳を開く前に backups フォルダーへコピーし、コピーできない場合は開きません。
|
||||
• ご利用は完全に自己責任です。下の一覧にあるアルファ版に関する通知が同意する文書です。読んだことを示すためにチェックを入れてください。</value>
|
||||
<comment>review</comment>
|
||||
@@ -4829,6 +4837,10 @@
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="About_Runtime_Alpha_Format" xml:space="preserve">
|
||||
<value>アルファ版 — {0} で動作</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="About_Runtime_Alpha_Prerelease_Format" xml:space="preserve">
|
||||
<value>アルファ版 — プレリリース版の .NET である {0} で動作</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
|
||||
@@ -3609,8 +3609,14 @@ The documents below are the full terms; this summary does not replace them.</val
|
||||
<value>Alpha build</value>
|
||||
</data>
|
||||
<data name="Alpha_Banner_Body_Format" xml:space="preserve">
|
||||
<value>Experimental: an alpha build on {0}. Results can be wrong and it can crash; you use it at your own risk. The beta is the dependable build.</value>
|
||||
</data>
|
||||
<data name="Alpha_Banner_Body_Prerelease_Format" xml:space="preserve">
|
||||
<value>Experimental: it runs on {0}, a prerelease .NET. Results can be wrong and it can crash; you use it at your own risk. The beta is the dependable build.</value>
|
||||
</data>
|
||||
<data name="Alpha_Banner_Body_Resting_Format" xml:space="preserve">
|
||||
<value>The alpha line is paused: the betas now run on {0} too, and only they get updates — the anti-cheat list included. Install the latest beta over this alpha; your data stays.</value>
|
||||
</data>
|
||||
<data name="Alpha_Banner_Read" xml:space="preserve">
|
||||
<value>Read the alpha notice</value>
|
||||
</data>
|
||||
@@ -3619,7 +3625,7 @@ The documents below are the full terms; this summary does not replace them.</val
|
||||
</data>
|
||||
<data name="FirstRun_Alpha_Summary" xml:space="preserve">
|
||||
<value>This is an ALPHA build:
|
||||
• It is a beta's source built on a prerelease .NET. Expect more problems than in a beta, wrong measurements and crashes among them.
|
||||
• It is a beta's source built to try a newer .NET, at times a prerelease one. Expect more problems than in a beta, wrong measurements and crashes among them.
|
||||
• It replaces the beta on this PC and shares its data. Before it first opens your ledger it copies it to the backups folder, and it does not open it if that copy cannot be made.
|
||||
• You use it entirely at your own risk. The Alpha notice in the list below is the text you accept; tick the box to say you have read it.</value>
|
||||
</data>
|
||||
@@ -3633,6 +3639,9 @@ The documents below are the full terms; this summary does not replace them.</val
|
||||
<value>Runs on {0}</value>
|
||||
</data>
|
||||
<data name="About_Runtime_Alpha_Format" xml:space="preserve">
|
||||
<value>Alpha build — runs on {0}</value>
|
||||
</data>
|
||||
<data name="About_Runtime_Alpha_Prerelease_Format" xml:space="preserve">
|
||||
<value>Alpha build — runs on {0}, a prerelease .NET</value>
|
||||
</data>
|
||||
<data name="A11y_Pair_Format" xml:space="preserve">
|
||||
|
||||
@@ -3604,8 +3604,14 @@ Các văn bản bên dưới là điều khoản đầy đủ; bản tóm tắt
|
||||
<value>Bản alpha</value>
|
||||
</data>
|
||||
<data name="Alpha_Banner_Body_Format" xml:space="preserve">
|
||||
<value>Thử nghiệm: đây là bản alpha chạy trên {0}. Kết quả có thể sai và ứng dụng có thể gặp sự cố; bạn dùng nó và tự chịu rủi ro. Bản beta mới là bản đáng tin cậy.</value>
|
||||
</data>
|
||||
<data name="Alpha_Banner_Body_Prerelease_Format" xml:space="preserve">
|
||||
<value>Thử nghiệm: bản này chạy trên {0}, một phiên bản .NET chưa phát hành chính thức. Kết quả có thể sai và ứng dụng có thể gặp sự cố; bạn dùng nó và tự chịu rủi ro. Bản beta mới là bản đáng tin cậy.</value>
|
||||
</data>
|
||||
<data name="Alpha_Banner_Body_Resting_Format" xml:space="preserve">
|
||||
<value>Nhánh alpha đang tạm nghỉ: các bản beta nay cũng chạy trên {0}, và chỉ bản beta còn nhận cập nhật — kể cả danh sách anti-cheat. Hãy cài bản beta mới nhất đè lên bản alpha này; dữ liệu của bạn được giữ nguyên.</value>
|
||||
</data>
|
||||
<data name="Alpha_Banner_Read" xml:space="preserve">
|
||||
<value>Đọc thông báo bản alpha</value>
|
||||
</data>
|
||||
@@ -3614,7 +3620,7 @@ Các văn bản bên dưới là điều khoản đầy đủ; bản tóm tắt
|
||||
</data>
|
||||
<data name="FirstRun_Alpha_Summary" xml:space="preserve">
|
||||
<value>Đây là một bản ALPHA:
|
||||
• Đây là mã nguồn của một bản beta, được build trên một phiên bản .NET chưa phát hành chính thức. Hãy chờ đợi nhiều vấn đề hơn bản beta, trong đó có số đo sai và ứng dụng gặp sự cố.
|
||||
• Đây là mã nguồn của một bản beta, được build để thử một phiên bản .NET mới hơn, có lúc là bản chưa phát hành chính thức. Hãy chờ đợi nhiều vấn đề hơn bản beta, trong đó có số đo sai và ứng dụng gặp sự cố.
|
||||
• Bản này thay bản beta trên máy và dùng chung dữ liệu. Trước khi mở ledger lần đầu, nó chép ledger vào thư mục backups, và sẽ không mở nếu không chép được.
|
||||
• Bạn dùng bản này và hoàn toàn tự chịu rủi ro. Thông báo bản alpha trong danh sách bên dưới là văn bản bạn chấp nhận; hãy đánh dấu ô để xác nhận bạn đã đọc.</value>
|
||||
</data>
|
||||
@@ -3628,6 +3634,9 @@ Các văn bản bên dưới là điều khoản đầy đủ; bản tóm tắt
|
||||
<value>Chạy trên {0}</value>
|
||||
</data>
|
||||
<data name="About_Runtime_Alpha_Format" xml:space="preserve">
|
||||
<value>Bản alpha — chạy trên {0}</value>
|
||||
</data>
|
||||
<data name="About_Runtime_Alpha_Prerelease_Format" xml:space="preserve">
|
||||
<value>Bản alpha — chạy trên {0}, một phiên bản .NET chưa phát hành chính thức</value>
|
||||
</data>
|
||||
<data name="A11y_Pair_Format" xml:space="preserve">
|
||||
|
||||
@@ -111,8 +111,8 @@ public sealed partial class MainWindowViewModel : ObservableObject, IDisposable,
|
||||
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format string is a resource that follows the UI culture")]
|
||||
public string AlphaBadgeTooltip => _line.IsAlpha ? string.Format(CultureInfo.CurrentCulture, Strings.Alpha_Badge_Tooltip_Format, RuntimeInformation.FrameworkDescription) : string.Empty;
|
||||
|
||||
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format string is a resource that follows the UI culture")]
|
||||
public string AlphaBannerBody => _line.IsAlpha ? string.Format(CultureInfo.CurrentCulture, Strings.Alpha_Banner_Body_Format, RuntimeInformation.FrameworkDescription) : string.Empty;
|
||||
/// <summary>What the banner says follows the runtime and whether the alpha line rests (D97, D98): <see cref="AlphaTexts"/>.</summary>
|
||||
public string AlphaBannerBody => _line.IsAlpha ? AlphaTexts.BannerBody(AlphaLine.Rests, RuntimeInformation.FrameworkDescription) : string.Empty;
|
||||
|
||||
/// <summary>
|
||||
/// The menu entries that ask the Agent or change this PC (Update detection rules, Check for updates) are live everywhere
|
||||
|
||||
@@ -35,8 +35,7 @@ public partial class AboutWindow : FluentWindow
|
||||
theme.Apply(appearance.Theme, null);
|
||||
InitializeComponent();
|
||||
VersionText.Text = string.Format(CultureInfo.CurrentCulture, Strings.About_Version_Format, UiIdentity.Version) + Environment.NewLine
|
||||
+ string.Format(CultureInfo.CurrentCulture, Shared.BuildLine.Current.IsAlpha ? Strings.About_Runtime_Alpha_Format : Strings.About_Runtime_Format,
|
||||
System.Runtime.InteropServices.RuntimeInformation.FrameworkDescription);
|
||||
+ AlphaTexts.AboutRuntime(Shared.BuildLine.Current.IsAlpha, System.Runtime.InteropServices.RuntimeInformation.FrameworkDescription);
|
||||
SourceText.Text = string.Format(CultureInfo.CurrentCulture, Strings.About_Notices_Source_Format, SourceCode.AbsoluteUri);
|
||||
ThirdParty.UrlOpener = urls;
|
||||
ThirdParty.Pages = EmbeddedDocuments.ThirdParty();
|
||||
|
||||
@@ -0,0 +1,43 @@
|
||||
// SPDX-License-Identifier: GPL-3.0-only
|
||||
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
|
||||
|
||||
using System.Reflection;
|
||||
|
||||
namespace FrameLedger.Shared;
|
||||
|
||||
/// <summary>
|
||||
/// Two facts an alpha build's own words turn on (owner decisions D97 and D98, 2026-11-11). An alpha is a beta's source
|
||||
/// built to try a newer .NET, which is at times a prerelease and at times - 0.1.0-alpha.4 - the release the betas
|
||||
/// moved to as well; so the build says "a prerelease .NET" only where the runtime it runs on is one
|
||||
/// (<see cref="IsPrerelease"/>), and says that its line is paused where it was cut while the line rested
|
||||
/// (<see cref="Rests"/>): a resting alpha gets no update, its anti-cheat list included, and tells its user to install
|
||||
/// the beta (<c>docs/12_BUILD.md</c> §The alpha line).
|
||||
/// </summary>
|
||||
public static class AlphaLine
|
||||
{
|
||||
/// <summary>The metadata key <c>Directory.Build.props</c> writes from its <c>FlAlphaLineRests</c> property.</summary>
|
||||
public const string RestsMetadataKey = "FrameLedger.AlphaLineRests";
|
||||
|
||||
/// <summary>
|
||||
/// Whether the alpha line was resting when this build was made - the betas on the same .NET, no further alpha until a
|
||||
/// newer one is tried. Stamped on both lines and read only by an alpha; false for an assembly that carries no stamp.
|
||||
/// </summary>
|
||||
public static bool Rests { get; } = ParseRests(typeof(AlphaLine).Assembly.GetCustomAttributes<AssemblyMetadataAttribute>()
|
||||
.FirstOrDefault(static a => string.Equals(a.Key, RestsMetadataKey, StringComparison.Ordinal))?.Value);
|
||||
|
||||
/// <summary>Only the word <c>true</c>, in any case, says the line rests.</summary>
|
||||
public static bool ParseRests(string? stamped) => string.Equals(stamped, "true", StringComparison.OrdinalIgnoreCase);
|
||||
|
||||
/// <summary>
|
||||
/// Whether a runtime's own description (<c>RuntimeInformation.FrameworkDescription</c>) names a prerelease:
|
||||
/// <c>.NET 11.0.0-rc.3.26522.148</c> does, <c>.NET 11.0.0</c> does not. The version is the last word, and a
|
||||
/// prerelease version is the one with a hyphen in it.
|
||||
/// </summary>
|
||||
public static bool IsPrerelease(string frameworkDescription)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(frameworkDescription);
|
||||
ReadOnlySpan<char> version = frameworkDescription.AsSpan().TrimEnd();
|
||||
int space = version.LastIndexOf(' ');
|
||||
return version[(space + 1)..].Contains('-');
|
||||
}
|
||||
}
|
||||
@@ -7,7 +7,7 @@ namespace FrameLedger.Shared;
|
||||
/// The Alpha notice (owner decision D74, 2026-10-31): <c>legal/ALPHA_NOTICE.md</c>, which an alpha build's Legal Gate shows
|
||||
/// with a tick box of its own and records in <c>legal_acceptance</c> under <see cref="DocumentKey"/>. Here rather than in the
|
||||
/// App because the Agent reads the same row: an alpha's <c>--serve</c> does not start until the notice is accepted at
|
||||
/// <see cref="Version"/>. <c>AlphaNoticeTests</c> holds the constant to the document's own <c>**Version:**</c> line, so the
|
||||
/// <see cref="Version"/>. <c>LegalDocumentsTests</c> holds the constant to the document's own <c>**Version:**</c> line, so the
|
||||
/// text cannot move without the gate showing it again.
|
||||
/// </summary>
|
||||
public static class AlphaNotice
|
||||
@@ -16,5 +16,5 @@ public static class AlphaNotice
|
||||
public const string DocumentKey = "alpha";
|
||||
|
||||
/// <summary>The version this build carries, as the document's <c>**Version:**</c> line states it.</summary>
|
||||
public const string Version = "1.0";
|
||||
public const string Version = "1.1";
|
||||
}
|
||||
@@ -7,8 +7,9 @@ namespace FrameLedger.Shared;
|
||||
|
||||
/// <summary>
|
||||
/// The release line this build belongs to (owner decision D73, 2026-10-31): <see cref="Main"/>, the betas and releases on
|
||||
/// the .NET that <c>global.json</c> pins, or <see cref="Alpha"/>, a beta's source built on a prerelease .NET from the
|
||||
/// long-lived <c>alpha</c> branch (<c>docs/12_BUILD.md</c> §The alpha line). The <c>RELEASE_LINE</c> file at the repository
|
||||
/// the .NET that <c>global.json</c> pins, or <see cref="Alpha"/>, a beta's source built to try a newer .NET - at times a
|
||||
/// prerelease one (<see cref="AlphaLine"/>) - from the long-lived <c>alpha</c> branch (<c>docs/12_BUILD.md</c> §The alpha
|
||||
/// line). The <c>RELEASE_LINE</c> file at the repository
|
||||
/// root names it; <c>Directory.Build.props</c> stamps it into every assembly as the <see cref="MetadataKey"/> metadata and
|
||||
/// refuses any other value; <c>release.yml</c> refuses a tag that disagrees with it.
|
||||
/// </summary>
|
||||
@@ -26,7 +27,7 @@ public sealed class BuildLine
|
||||
/// <summary>The betas and releases.</summary>
|
||||
public static BuildLine Main { get; } = new("main");
|
||||
|
||||
/// <summary>A beta's source on a prerelease .NET.</summary>
|
||||
/// <summary>A beta's source built to try a newer .NET.</summary>
|
||||
public static BuildLine Alpha { get; } = new("alpha");
|
||||
|
||||
/// <summary>The line this build was stamped with; <see cref="Main"/> for an assembly that carries no stamp.</summary>
|
||||
|
||||
@@ -0,0 +1,52 @@
|
||||
// SPDX-License-Identifier: GPL-3.0-only
|
||||
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
|
||||
|
||||
using System.Globalization;
|
||||
using FluentAssertions;
|
||||
using FrameLedger.App.Services;
|
||||
|
||||
namespace FrameLedger.App.Tests;
|
||||
|
||||
/// <summary>
|
||||
/// D97 and D98 (2026-11-11): an alpha says "a prerelease .NET" only where its runtime is one, and says that its line is
|
||||
/// paused where it was cut while the line rested. Each combination, by the two facts <see cref="AlphaTexts"/> is handed.
|
||||
/// </summary>
|
||||
public sealed class AlphaTextsTests
|
||||
{
|
||||
private const string _release = ".NET 11.0.0";
|
||||
private const string _candidate = ".NET 11.0.0-rc.3.26522.148";
|
||||
|
||||
private static string Of(string format, string runtime) => string.Format(CultureInfo.CurrentCulture, format, runtime);
|
||||
|
||||
[Fact]
|
||||
public void AnAlphaOnAReleasedRuntimeWhoseLineStillTriesItNamesTheRuntimeAndNoPrerelease() =>
|
||||
AlphaTexts.BannerBody(rests: false, _release).Should().Be(Of(Strings.Alpha_Banner_Body_Format, _release));
|
||||
|
||||
[Fact]
|
||||
public void AnAlphaCutWhileTheLineRestsSaysItIsPausedAndToInstallTheBeta() =>
|
||||
AlphaTexts.BannerBody(rests: true, _release).Should().Be(Of(Strings.Alpha_Banner_Body_Resting_Format, _release));
|
||||
|
||||
[Theory]
|
||||
[InlineData(false)]
|
||||
[InlineData(true)]
|
||||
public void APrereleaseRuntimeIsSaidWhateverTheStampSays(bool rests) =>
|
||||
AlphaTexts.BannerBody(rests, _candidate).Should().Be(Of(Strings.Alpha_Banner_Body_Prerelease_Format, _candidate),
|
||||
"a line that tries a prerelease is not resting, and the runtime is what the process sees for itself");
|
||||
|
||||
[Fact]
|
||||
public void TheThreeBannersAreThreeTexts() =>
|
||||
new[] { Strings.Alpha_Banner_Body_Format, Strings.Alpha_Banner_Body_Prerelease_Format, Strings.Alpha_Banner_Body_Resting_Format }
|
||||
.Should().OnlyHaveUniqueItems().And.OnlyContain(static f => f.Contains("{0}", StringComparison.Ordinal));
|
||||
|
||||
[Fact]
|
||||
public void AboutNamesTheRuntimeForABeta() =>
|
||||
AlphaTexts.AboutRuntime(alpha: false, _release).Should().Be(Of(Strings.About_Runtime_Format, _release));
|
||||
|
||||
[Fact]
|
||||
public void AboutSaysAlphaAndPrereleaseOnlyWhereTheRuntimeIsOne()
|
||||
{
|
||||
AlphaTexts.AboutRuntime(alpha: true, _release).Should().Be(Of(Strings.About_Runtime_Alpha_Format, _release));
|
||||
AlphaTexts.AboutRuntime(alpha: true, _candidate).Should().Be(Of(Strings.About_Runtime_Alpha_Prerelease_Format, _candidate));
|
||||
AlphaTexts.AboutRuntime(alpha: false, _candidate).Should().Be(Of(Strings.About_Runtime_Format, _candidate), "a beta never runs on one, and says nothing more if it did");
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,73 @@
|
||||
// SPDX-License-Identifier: GPL-3.0-only
|
||||
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
|
||||
|
||||
using System.Reflection;
|
||||
using FluentAssertions;
|
||||
using FrameLedger.Shared;
|
||||
|
||||
namespace FrameLedger.Infrastructure.Tests;
|
||||
|
||||
/// <summary>
|
||||
/// D97 and D98 (2026-11-11): what an alpha says about its .NET follows the runtime's own description, and that its line is
|
||||
/// paused follows a stamp <c>Directory.Build.props</c> writes. Like <see cref="BuildLineTests"/>, the stamp's test holds on
|
||||
/// both branches: it pins that the build carries what the file says, not which value that is.
|
||||
/// </summary>
|
||||
public sealed class AlphaLineTests
|
||||
{
|
||||
private static string RepoRoot()
|
||||
{
|
||||
for (DirectoryInfo? dir = new(AppContext.BaseDirectory); dir is not null; dir = dir.Parent)
|
||||
{
|
||||
if (File.Exists(Path.Combine(dir.FullName, "FrameLedger.slnx")))
|
||||
{
|
||||
return dir.FullName;
|
||||
}
|
||||
}
|
||||
|
||||
throw new InvalidOperationException("the repository root (FrameLedger.slnx) is not above " + AppContext.BaseDirectory);
|
||||
}
|
||||
|
||||
[Theory]
|
||||
[InlineData(".NET 11.0.0", false)]
|
||||
[InlineData(".NET 11.0.1", false)]
|
||||
[InlineData(".NET 10.0.15", false)]
|
||||
[InlineData(".NET 11.0.0-rc.3.26522.148", true)]
|
||||
[InlineData(".NET 12.0.0-preview.1.27101.5", true)]
|
||||
[InlineData(".NET 11.0.0-rc.3.26522.148 ", true)]
|
||||
[InlineData("11.0.0", false)]
|
||||
[InlineData("", false)]
|
||||
public void ARuntimeIsAPrereleaseWhenItsVersionCarriesAHyphen(string description, bool prerelease) =>
|
||||
AlphaLine.IsPrerelease(description).Should().Be(prerelease);
|
||||
|
||||
[Fact]
|
||||
public void AHyphenBeforeTheVersionIsNotThePrereleaseMark() =>
|
||||
AlphaLine.IsPrerelease("Some-Runtime 11.0.0").Should().BeFalse("the version is the last word, and it has no hyphen");
|
||||
|
||||
[Theory]
|
||||
[InlineData("true", true)]
|
||||
[InlineData("True", true)]
|
||||
[InlineData("false", false)]
|
||||
[InlineData("", false)]
|
||||
[InlineData(null, false)]
|
||||
[InlineData("yes", false)]
|
||||
public void OnlyTheWordTrueSaysTheLineRests(string? stamped, bool rests) => AlphaLine.ParseRests(stamped).Should().Be(rests);
|
||||
|
||||
[Fact]
|
||||
public void TheBuildCarriesWhatDirectoryBuildPropsSaysAboutTheAlphaLine()
|
||||
{
|
||||
const string open = "<FlAlphaLineRests>";
|
||||
const string close = "</FlAlphaLineRests>";
|
||||
string props = File.ReadAllText(Path.Combine(RepoRoot(), "Directory.Build.props"));
|
||||
int from = props.IndexOf(open, StringComparison.Ordinal);
|
||||
int to = props.IndexOf(close, StringComparison.Ordinal);
|
||||
string? stamped = typeof(AlphaLine).Assembly.GetCustomAttributes<AssemblyMetadataAttribute>()
|
||||
.FirstOrDefault(static a => string.Equals(a.Key, AlphaLine.RestsMetadataKey, StringComparison.Ordinal))?.Value;
|
||||
|
||||
from.Should().BeGreaterThanOrEqualTo(0, "Directory.Build.props declares FlAlphaLineRests");
|
||||
to.Should().BeGreaterThan(from);
|
||||
string declared = props[(from + open.Length)..to];
|
||||
declared.Should().BeOneOf("true", "false");
|
||||
stamped.Should().Be(declared, "Directory.Build.props stamps the property into every assembly");
|
||||
AlphaLine.Rests.Should().Be(string.Equals(declared, "true", StringComparison.Ordinal));
|
||||
}
|
||||
}
|
||||
+6
-4
@@ -37,14 +37,16 @@ Releases are not code-signed, so every release says so and publishes its checksu
|
||||
|
||||
## Cutting an alpha
|
||||
|
||||
An alpha is a beta's source built on a prerelease .NET, from the long-lived `alpha` branch — which differs from `main`
|
||||
only where [`docs/12_BUILD.md`](../docs/12_BUILD.md) §The alpha line lists (its `RELEASE_LINE` says `alpha`). One alpha
|
||||
follows each beta, never several in a row ([`docs/13_CI_CD.md`](../docs/13_CI_CD.md) §The alpha line):
|
||||
An alpha is a beta's source built to try a newer .NET — at times a prerelease — from the long-lived `alpha` branch, which
|
||||
differs from `main` only where [`docs/12_BUILD.md`](../docs/12_BUILD.md) §The alpha line lists (its `RELEASE_LINE` says
|
||||
`alpha`). **The line rests since its first alpha on .NET 11's release** (2026-11-11): the betas build on the same .NET 11, the branch differs
|
||||
from `main` in `RELEASE_LINE` alone, and no alpha is cut until a newer .NET has a preview. While the line tries a .NET,
|
||||
one alpha follows each beta, never several in a row ([`docs/13_CI_CD.md`](../docs/13_CI_CD.md) §The alpha line):
|
||||
|
||||
1. A pull request on `main` adds the alpha's notes, `docs/changelog/<version>.md`, opening with the experimental-build
|
||||
warning and naming the beta it is cut from, and its row in the Releases table. No release line moves: README, the
|
||||
accuracy statement, `LIMITATIONS.md` and `ACCESSIBILITY.md` keep naming the beta.
|
||||
2. A pull request merges `main` into `alpha` with a merge commit; CI runs the gate there on the prerelease SDK.
|
||||
2. A pull request merges `main` into `alpha` with a merge commit; CI runs the gate there on the SDK the branch pins.
|
||||
3. A rehearsal of `release.yml` on `alpha`, then a signed tag `vx.y.z-alpha.N` on its head. The workflow refuses any
|
||||
other tag on that branch, and an alpha's tag anywhere else; it packs on Velopack's `alpha` channel, so no beta is
|
||||
offered the alpha and no alpha a beta.
|
||||
|
||||
Reference in new issue
Block a user