Windows 11 Release Guard

Windows 11 Release Guard Wiki

Windows 11 Release Guard helps administrators decide whether an existing Windows 11 device is on the current broad-fleet release and quality baseline. It uses a signed public JSON policy feed, build-first local Windows evidence, and optional read-only WUA diagnostics.

README is the quick entry. This wiki is the deep dive. Code, tests, workflows, and AGENTS.md remain source of truth.

Windows 11 Release Guard GitHub Pages dashboard overview


Pick Your Path

You areStart hereWhy
New userQuick StartInstall, run, and verify quickly.
Admin / RMM userCLI and RMM UsageJSON output, exit codes, strict-production mode.
MaintainerBuild, Test and ReleaseLocal gates, CI, public feed checks.
Release managerTagged Release LaneClean archive release path.
Package maintainerTagged Release LanePyPI Trusted Publishing values and tag-gated publish path.
Future agentAgent ChokepointsRegression traps and required smoke tests.

What This Solves

ProblemGuard behavior
Device is still on 24H2 while fleet target is 25H2.Returns FEATURE_UPDATE_REQUIRED.
Device has current target but older quality baseline.Returns QUALITY_UPDATE_REQUIRED.
Device reports stale display labels.Preserves raw labels but evaluates from build/policy evidence.
WUA does not offer a required feature update.Keeps policy verdict and adds read-only diagnostics.
Static Pages feed gets old.Uses generated epoch fields plus live age checks.

Current Documentation Map

PageContents
ArchitectureRuntime flow, source hierarchy, module boundaries.
Policy Feed and Trust ModelSigned JSON, Ed25519, manifest, key rotation, JSON hardening.
Local Windows DetectionBuild-first detection, local signals, WUA role.
GitHub Pages DashboardStatic dashboard and public endpoint contract.
Pages ChangelogGenerated release history from CHANGELOG.md, with historical version sections preserved.
Source DiagnosticsParser/source drift events and publish gate semantics.
Anti-Static Freshnessgenerated_at_epoch_s, Date.now(), 14/45-day gates.
ConfigurationRecommended defaults, knobs, fallback behavior.
Release v0.3.3Corrective source-evidence hardening, changed areas, verify commands.
Safe Exports and Clean ArchivesSource ZIP rules and validation.
TroubleshootingCheck/action tables for common failures.
FAQShort answers to common questions.

Core Concepts In One Screen

ConceptRule
Broad targetExisting devices currently target Windows 11 25H2.
Special release26H1 is new-devices-only / excluded for existing devices.
Quality baselinerequired_baseline_build is the required B-release baseline.
Release Health latestlatest_build is the Microsoft Release Health Current Versions value.
Latest observedlatest_observed_build is newest supported public Microsoft evidence and can be newer.
Caught-up statelatest_build, latest_observed_build, and required_baseline_build can all match when sources and baseline rules align.
Local evidenceBuild signals outrank display labels.
WUAOptional read-only explanatory signal.
TrustPublic feed plus Ed25519 signature, not repository privacy.
FreshnessBrowser and CLI recompute age from generated epoch timestamps.

Good Defaults

python -m win11_release_guard --pretty
python -m win11_release_guard --json-pretty --no-wua
python -m win11_release_guard --strict-production --json-pretty --no-wua
python -m win11_release_guard --check-policy-source
python -m win11_release_guard --check-public-pages
ResourceLink
Repositoryhttps://github.com/Avnsx/win11_release_guard
READMEhttps://github.com/Avnsx/win11_release_guard/blob/main/README.md
Pages dashboardhttps://avnsx.github.io/win11_release_guard/
Pages changeloghttps://avnsx.github.io/win11_release_guard/wiki/changelog/
Public policy JSONhttps://avnsx.github.io/win11_release_guard/windows-release-policy.json
Releaseshttps://github.com/Avnsx/win11_release_guard/releases
Release v0.3.3Release v0.3.3
Release v0.3.2Release v0.3.2
Licensehttps://github.com/Avnsx/win11_release_guard/blob/main/LICENSE.txt

The local wiki/ folder is source for the static Pages Wiki and source/staging for GitHub internal Wiki pages. The Pages workflow renders it to /wiki/; .github/workflows/sync-wiki.yml can mirror the same wiki/*.md Markdown into the live GitHub internal Wiki or produce a dry-run artifact for manual sync fallback.