Repository navigation
Releases: tsuchim/priority-gear
Release list
PriorityGear v0.3.7 - GitHub installer release
PriorityGear v0.3.7
PriorityGear v0.3.7 is a packaging reliability follow-up to v0.3.6.
What's Changed
- The GitHub installer ZIP is now self-contained.
PriorityGear.Setup.exe, the GUI app, CLI, and System Mode service can run on a clean Windows machine without a separately installed .NET Desktop Runtime.- Windows Sandbox validation passed with no
dotnetcommand found and noMicrosoft.WindowsDesktop.Appregistry key found. - Silent install succeeded with no .NET runtime prompt.
PriorityGear.Servicewas created and running as LocalSystem.- CLI
service statussucceeded. - CLI
core-topologysucceeded. - Silent uninstall succeeded.
%ProgramData%\PriorityGearis preserved by design.
Known Limitations
- GPU process attribution remains unsupported unless a verified PID-attributed source is added later.
- Multiple processor groups are rejected by the current Core Reserve affinity path.
- Protected or elevated processes may require System Mode.
- Deleting a rule does not necessarily restore priority or affinity already applied to a running process.
- winget update is not included in this release and will be handled after release publication.
Artifacts
PriorityGear-v0.3.7-win-x64-installer.zipPriorityGear-v0.3.7-SHA256SUMS.txt
PriorityGear v0.3.6
PriorityGear v0.3.6
PriorityGear v0.3.6 is the usability, monitoring, and Core Reserve release.
What's new
- Process-name filtering in the process grid.
- Manual
3s snapshotaction for one-shot process resource measurement. - CPU snapshot metrics from process CPU-time deltas.
- Disk I/O snapshot metrics from process I/O counter deltas.
- GPU shown as an explicit unsupported/unavailable state unless verified PID attribution is available.
- Metric sorting and filtering for CPU, GPU, and Disk I/O snapshot data.
- Priority selectors ordered high to low.
- Active priority defaults to
Same as normal. - Core Reserve rule setting for physical-core affinity reservation.
PriorityGear.Cli core-topologydiagnostic for physical-core topology and allowed/reserved masks.- Installed System Mode validation for
vmmemWSL.exe:CoreReserve=1allowed affinity0xFFFFFFC;CoreReserve=2allowed affinity0xFFFFFF0; changing only Core Reserve reapplied correctly. - Validation Safety policy: validation must not stop WSL, Docker, containers, databases, VS Code remote sessions, or user workloads as routine cleanup.
Known limitations
- GPU process attribution remains unsupported unless a verified PID-attributed source is added later.
- Multiple processor groups are rejected by the current Core Reserve affinity path.
- Protected or elevated processes may require System Mode.
- Deleting a rule does not necessarily restore priority or affinity already applied to a running process.
- winget currently publishes
tsuchim.PriorityGear 0.3.4; winget remains behind and will be updated separately.
Artifacts
PriorityGear-v0.3.6-win-x64-installer.zipPriorityGear-v0.3.6-SHA256SUMS.txt
PriorityGear v0.3.5 - GitHub installer release
PriorityGear v0.3.5 - winget readiness installer fix
v0.3.5 fixes a blocker found while validating the v0.3.4 installer against the winget local lifecycle gate.
Installer
- Fixes silent uninstall when
PriorityGear.Setup.exeis launched from the installed version directory. - Removes the uninstall registration and Start Menu shortcut before removing installed program files.
- Schedules installed program file removal after setup exits when the running setup executable is inside
%ProgramFiles%\PriorityGear. - Preserves
%ProgramData%\PriorityGearrules and logs by default.
Distribution boundary
- This is still an unsigned GitHub installer release.
- Store, winget acceptance, signing, MSI, and MSIX are not claimed by this release.
- The installer configures
PriorityGear.Serviceas a LocalSystem service. - Changing process priority can affect system stability.
- Arbitrary shared-host
svchost.exemutation remains out of scope.
PriorityGear v0.3.4 - GitHub installer release
PriorityGear v0.3.4 - Start Menu installer registration
v0.3.4 is a formal GitHub installer patch release after v0.3.3.
Summary
- Registers PriorityGear in the machine-wide Start Menu during install.
- The installed application is launched from
Start Menu > PriorityGear > PriorityGear. - Removes the Start Menu shortcut during uninstall.
- Keeps the
PriorityGear.Setup.exeinstaller distribution. - Keeps live setup progress and deterministic setup logging from
v0.3.3.
Safety boundary
- Provided AS IS.
- Unsigned.
- Installs a LocalSystem Windows Service for System Mode.
- Changing process priority can affect system responsiveness and stability.
- No Store, winget, signing, MSI, or MSIX distribution is included in this release.
- Arbitrary shared-host
svchost.exemutation remains out of scope. - GitHub Actions does not run elevated setup.
winget registration is not included in this release. The previous winget submission was closed because the installed application launch path and documentation were not ready.
PriorityGear v0.3.3 - GitHub installer release
PriorityGear v0.3.3 - installer progress visibility fix
v0.3.3 is a patch release for the formal GitHub installer. It fixes the blank installer progress window reported in the v0.3.1 / v0.3.2 installer line.
Summary
- Fixes the blank setup window by writing startup diagnostics immediately.
- Streams setup log lines into the installer window as work happens.
- Runs long install/update work on a background task so the form can repaint and stay responsive.
- Flushes setup logs incrementally so failures leave durable diagnostics.
- Keeps silent installer entrypoints:
PriorityGear.Setup.exe --install --silentPriorityGear.Setup.exe --uninstall --silent
- Publishes
PriorityGear-v0.3.3-win-x64-installer.zip.
Installer
PriorityGear.Setup.exe remains the normal install/update entrypoint. Double-click installation keeps the setup UI and UAC flow. The window now shows the setup start, log path, and mode before long-running installation work begins.
Silent mode runs the same production installer state machine without setup UI or message boxes. It still requires elevation for install/update and uninstall. Exit code 0 means success; required install/update or uninstall failures return non-zero.
The installer installs the GUI app, CLI, and System Mode service payload, configures PriorityGear.Service as LocalSystem, uses versioned install directories, and preserves ProgramData rules/logs by default.
Safety boundary
PriorityGear System Mode is privileged software and installs a LocalSystem Windows Service. It changes process priority and may affect system responsiveness or stability. It is provided AS IS.
The installer is unsigned. Microsoft Store, winget registration, signing, MSI, and MSIX packaging are not included in this release.
This release does not expand unsafe service mutation support. Arbitrary shared-host svchost.exe priority mutation remains out of scope.
GitHub Actions builds and packages the installer. GitHub Actions does not run elevated setup.
Validation
Expected validation:
dotnet restore PriorityGear.slnx
dotnet build PriorityGear.slnx --configuration Release --no-restore
dotnet test PriorityGear.slnx --configuration Release --no-build
.\scripts\build-verification-installer.ps1
.\scripts\package-release.ps1 -TagName "v0.3.3" -OutputDirectory ".\artifacts\release-test-v0.3.3"
.\scripts\inspect-release-artifacts.ps1 -ArtifactDirectory ".\artifacts\release-test-v0.3.3" -TagName "v0.3.3"PriorityGear v0.3.2 - GitHub installer release
PriorityGear v0.3.2 - winget-compatible installer mode
v0.3.2 is a patch release for the formal GitHub installer. It adds command-line behavior needed for Windows Package Manager / winget submission.
Summary
- Keeps the
PriorityGear.Setup.exeinstaller distribution fromv0.3.1. - Adds silent installer entrypoints for package-manager use:
PriorityGear.Setup.exe --install --silentPriorityGear.Setup.exe --uninstall --silent
- Adds
PriorityGear.Setup.exe --helpandPriorityGear.Setup.exe --version. - Adds release artifact metadata describing the nested installer and silent install/uninstall switches.
- Publishes
PriorityGear-v0.3.2-win-x64-installer.zip.
Installer
PriorityGear.Setup.exe remains the normal install/update entrypoint. Double-click installation keeps the existing setup UI and UAC flow.
For winget and automation, silent mode runs the same production installer state machine without setup UI or message boxes. It still requires elevation for install/update and uninstall. Exit code 0 means success; required install/update or uninstall failures return non-zero.
The installer installs the GUI app, CLI, and System Mode service payload, configures PriorityGear.Service as LocalSystem, uses versioned install directories, and preserves ProgramData rules/logs by default.
Safety boundary
PriorityGear System Mode is privileged software and installs a LocalSystem Windows Service. It changes process priority and may affect system responsiveness or stability. It is provided AS IS.
The installer is unsigned. Microsoft Store, signing, MSI, and MSIX packaging are not included in this release.
This release does not expand unsafe service mutation support. Arbitrary shared-host svchost.exe priority mutation remains out of scope.
GitHub Actions builds and packages the installer. GitHub Actions does not run elevated setup.
Validation
Expected validation:
dotnet restore PriorityGear.slnx
dotnet build PriorityGear.slnx --configuration Release --no-restore
dotnet test PriorityGear.slnx --configuration Release --no-build
.\scripts\build-verification-installer.ps1
.\scripts\package-release.ps1 -TagName "v0.3.2" -OutputDirectory ".\artifacts\release-test-v0.3.2"
.\scripts\inspect-release-artifacts.ps1 -ArtifactDirectory ".\artifacts\release-test-v0.3.2" -TagName "v0.3.2"PriorityGear v0.3.1 - GitHub installer release
PriorityGear v0.3.1 - GitHub installer release with adversarial installer gate
v0.3.1 is the formal GitHub installer release built from the current post-PR #9 main.
Summary
- Keeps the
PriorityGear.Setup.exeinstaller distribution introduced inv0.3.0. - Includes the adversarial installer state-machine gate added after
v0.3.0. - Publishes
PriorityGear-v0.3.1-win-x64-installer.zipas the primary release artifact. - Releases from the
mainstate that includes PR #9.
Installer
PriorityGear.Setup.exe is the normal install/update entrypoint. The installer installs the GUI app, CLI, and System Mode service payload, configures PriorityGear.Service as LocalSystem, and uses versioned install directories under %ProgramFiles%\PriorityGear\versions.
The installer preserves ProgramData rules and logs by default, including %ProgramData%\PriorityGear\rules.machine.json and %ProgramData%\PriorityGear\Logs. It also supports uninstall/cleanup behavior through:
.\PriorityGear.Setup.exe --uninstallAdversarial installer gate
This release includes adversarial installer state-machine tests for:
- payload missing;
- service stop failure;
- partial copy failure;
- service configure failure;
- service start timeout;
- status pipe timeout;
- non-LocalSystem service account;
- stale or hostile service
binPath; - missing process identity;
- old version cleanup warning-only behavior;
- immutable result snapshots.
Safety boundary
PriorityGear System Mode is privileged software and installs a LocalSystem Windows Service. It changes process priority and may affect system responsiveness or stability. It is provided AS IS.
The installer is unsigned. Store, winget, signing, MSI, and MSIX packaging are not included in this release.
This release does not expand unsafe service mutation support. Arbitrary shared-host svchost.exe priority mutation remains out of scope.
GitHub Actions builds and packages the installer. GitHub Actions does not run elevated setup.
Validation
Expected validation:
dotnet restore PriorityGear.slnx
dotnet build PriorityGear.slnx --configuration Release --no-restore
dotnet test PriorityGear.slnx --configuration Release --no-build
.\scripts\build-verification-installer.ps1
.\scripts\package-release.ps1 -TagName "v0.3.1" -OutputDirectory ".\artifacts\release-test-v0.3.1"
.\scripts\inspect-release-artifacts.ps1 -ArtifactDirectory ".\artifacts\release-test-v0.3.1" -TagName "v0.3.1"PriorityGear v0.3.0 - GitHub installer release
PriorityGear v0.3.0 - GitHub installer release
v0.3.0 moves PriorityGear from verification-setup distribution to a formal GitHub release installer artifact.
Summary
- Adds
PriorityGear.Setup.exeas the normal install/update entrypoint. - Publishes
PriorityGear-v0.3.0-win-x64-installer.zipas the primary release artifact. - Installs the GUI app, CLI, and System Mode service payload under a versioned Program Files directory.
- Configures
PriorityGear.Serviceas LocalSystem and confirms service status through the status pipe. - Adds
PriorityGear.Setup.exe --uninstallfor normal service cleanup while preserving ProgramData.
Safety boundary
PriorityGear System Mode is privileged software and installs a LocalSystem Windows Service. It changes process priority and may affect system responsiveness or stability. It is provided AS IS.
The installer is unsigned. Store, winget, signing, MSI, and MSIX packaging are not included in this release.
This release does not expand unsafe service mutation support. Arbitrary shared-host svchost.exe priority mutation remains out of scope.
GitHub Actions builds and packages the installer. GitHub Actions does not run elevated setup.
Validation
Expected validation:
dotnet restore PriorityGear.slnx
dotnet build PriorityGear.slnx --configuration Release --no-restore
dotnet test PriorityGear.slnx --configuration Release --no-build
.\scripts\build-verification-installer.ps1
.\scripts\package-release.ps1 -TagName "v0.3.0" -OutputDirectory ".\artifacts\release-test-v0.3.0"
.\scripts\inspect-release-artifacts.ps1 -ArtifactDirectory ".\artifacts\release-test-v0.3.0" -TagName "v0.3.0"PriorityGear v0.2.1 - System Mode status update
PriorityGear v0.2.1 - System Mode status update
This is a small update after v0.2.0-preview.1. It is not a stable v0.2.0 release.
Summary
- Uses the automated release workflow for plain semantic version tags.
- Improves operator-facing System Mode status visibility for already-supported service status data.
- Keeps the application icon wired into the WPF app and verification setup artifacts.
- Keeps the v0.2 System Mode safety boundary unchanged.
Included
- System Mode status display includes service identity, service binary/version path,
SeDebugPrivilege, machine-rule monitor summary, and service-process discovery truncation metadata. - Release packaging continues to include the verification setup and payload executables.
- App icon configuration remains part of the WPF app executable and tray resource path.
Safety boundary
PriorityGear System Mode is privileged software and installs a LocalSystem Windows Service during verification. It is provided AS IS and must be used at the user's own risk.
This release does not expand unsafe service mutation support. Arbitrary shared-host svchost.exe priority mutation remains out of scope. Shared-host behavior remains guarded by service-name rules, administrator approval, and dry-run/reject safety.
The verification setup is not a production installer.
Out of scope
- Stable
v0.2.0release. - Production installer, MSI/MSIX, Store, winget, signing, or updater.
- GUI machine-rule editing.
- Arbitrary shared-host
svchost.exemutation. - CPU affinity, I/O priority, EcoQoS, Realtime priority UI, drivers, telemetry, network features, or System Mode active-window switching.
Validation
Expected validation for this release:
dotnet restore PriorityGear.slnx
dotnet build PriorityGear.slnx --configuration Release --no-restore
dotnet test PriorityGear.slnx --configuration Release --no-build
.\scripts\build-verification-installer.ps1
.\scripts\check-workflow-release-state.ps1
.\scripts\package-preview-release.ps1 -TagName "v0.2.1" -SetupDirectory ".\artifacts\setup-v0.2\PriorityGear-v0.2-system-mode-verification" -OutputDirectory ".\artifacts\release-test-v0.2.1"
.\scripts\inspect-release-artifacts.ps1 -ArtifactDirectory ".\artifacts\release-test-v0.2.1" -TagName "v0.2.1"GitHub Actions does not run the elevated verification setup. Elevated setup verification remains a local, user-approved UAC operation.
PriorityGear v0.2.0-preview.1 - System Mode preview
PriorityGear v0.2.0-preview.1 - System Mode preview
This is a preview prerelease for the v0.2 System Mode foundation. It is not the final stable v0.2.0 release.
Summary
- v0.2 System Mode preview
- LocalSystem service foundation
- status/admin named pipe split
- administrator authorization for mutating service commands
- service-side priority mutation
- machine-rule monitor
- service-process discovery
- service-name machine rules
- shared-host safety gate
Verified
Latest confirmed elevated verification setup run:
- setup version:
20260514-004830 - service path:
C:\Program Files\PriorityGear\versions\20260514-004830\PriorityGear.Service.exe - final verdict:
passed - total duration: about 8 seconds
- direct discovery: 7 ms
- targeted host discovery: 2 ms
- bounded discovery: 130 ms
- shared-host bounded discovery: 131 ms
- shared-host post-scan targeted discovery: 3 ms
- PID 4 probe:
AccessDenied, Win32 error5 - shared-host dry-run/reject:
SharedHostRejected, priority remainedNormal
Safety boundary
PriorityGear System Mode is privileged software. It installs a LocalSystem Windows Service and changes process priority, which can affect system responsiveness or stability.
This software is provided AS IS. Use it at your own risk.
- shared-host
svchost.exemutation is not enabled by default - executable-only
svchost.exerules are not treated as safe - service-name rules require administrator approval
- protected or denied targets are reported explicitly
- PriorityGear does not bypass Windows protected-process boundaries
What is included
- User Mode from v0.1
- System Mode service preview
- machine rules under
%ProgramData%\PriorityGear\rules.machine.json - machine-rule monitor
- CLI/admin pipe operations
- minimal GUI System Mode status visibility
- System Mode verification setup
What is not included
- production-grade installer
- Microsoft Store package
- winget package
- code signing
- MSI/MSIX
- arbitrary shared-host
svchost.exepriority control - GUI machine-rule editing
- CPU affinity
- I/O priority
- EcoQoS
- Realtime priority UI
- driver support
- telemetry, updater, or network features
- System Mode active-window priority switching
Validation
Commands run during draft prerelease preparation:
dotnet restore PriorityGear.slnx
dotnet build PriorityGear.slnx --configuration Release --no-restore
dotnet test PriorityGear.slnx --configuration Release --no-build
.\scripts\build-verification-installer.ps1Result:
Build succeeded
Tests passed: 64
Verification setup artifact generated
Elevated setup was not run by Codex during release draft creation
Artifact
PriorityGear-v0.2.0-preview.1-system-mode-verification.zip- Contains
PriorityGear.VerificationSetup.exeand its payload. - This is a local verification setup, not a production installer.
- Contains
PriorityGear-v0.2.0-preview.1-SHA256SUMS.txt