Awake and DevEx improvements

[dend]

This PR contains a set of bug fixes and general improvements to Awake and developer experience tooling for building the module.

Awake Fixes

• Awake settings are ignored when PC is woken from sleep #32544 - Fixed an issue where Awake settings became non-functional after the PC wakes from sleep. Added WM_POWERBROADCAST handling to detect system resume events (PBT_APMRESUMEAUTOMATIC, PBT_APMRESUMESUSPEND) and re-apply SetThreadExecutionState to restore the awake state.

• Awake does not work if DC power is connected #36150 - Fixed an issue where Awake would not prevent sleep when AC power is connected. Added PBT_APMPOWERSTATUSCHANGE handling to re-apply SetThreadExecutionState when the power source changes (AC/battery transitions).

• [Awake] SetThreadExecutionState failure not handled - silent failure bug when changing state #41674 - Fixed silent failure when SetThreadExecutionState fails. The monitor thread now handles the return value, logs an error, and reverts to passive mode with updated tray icon.

• [Awake] Inconsistency in --display-on default behaviour and documentation #41738 - Fixed --display-on CLI flag default from true to false to align with documentation and PowerToys settings behavior. This is a breaking change for scripts relying on the undocumented default.

• [Awake] WM_COMMAND message processing flaw #41918 - Fixed WM_COMMAND message processing flaw in TrayHelper.WndProc that incorrectly compared enum values against enum count. Added proper bounds checking for custom tray time entries.

• Scheduled TRIM doesn't happen with Awake enabled. #44134 - Documented that ES_DISPLAY_REQUIRED (used when "Keep display on" is enabled) blocks Task Scheduler idle detection, preventing scheduled maintenance tasks like SSD TRIM. Workaround: disable "Keep display on" or manually run Optimize-Volume -DriveLetter C -ReTrim.

• Awake Icon in tray is missing after windows update #38770 - Fixed tray icon failing to appear after Windows updates. Increased retry attempts and delays for icon Add operations (10 attempts, up to ~15.5 seconds total) while keeping existing fast retry behavior for Update/Delete operations.

• The Awake tray icon does not disappear #40501 - Fixed tray icon not disappearing when Awake is disabled. The SetShellIcon function was incorrectly requiring an icon for Delete operations, causing the NIM_DELETE message to never be sent.

• Fixed an issue where toggling "Keep screen on" during an active timed session would disrupt the countdown timer. The display setting now updates directly without restarting the timer, preserving the exact remaining time.

Developer Experience

• Added setup-dev-environment.ps1 script to automate development environment setup.
• Added build script that allows standalone command line build of the Awake module.

[github-actions]

@check-spelling-bot Report

🔴 Please review

See the 📂 files view, the 📜action log, or 📝 job summary for details.

❌ Errors and Warnings	Count
❌ forbidden-pattern	1
⚠️ ignored-expect-variant	6
⚠️ large-file	2

See ❌ Event descriptions for more information.

These words are not needed and should be removed

ATX cppcoreguidelines

Some files were automatically ignored 🙈

These sample patterns would exclude them:

^src/modules/powerrename/unittests/testdata/avif_test\.avif$
^src/modules/powerrename/unittests/testdata/heif_test\.heic$

You should consider adding them to:

.github/actions/spell-check/excludes.txt

File matching is via Perl regular expressions.

To check these files, more of their words need to be in the dictionary than not. You can use patterns.txt to exclude portions, add items to the dictionary (e.g. by adding them to allow.txt), or fix typos.

To update file exclusions and remove the previously acknowledged and now absent words, you could run the following commands

... in a clone of the [email protected]:dend/PowerToys.git repository
on the main branch (ℹ️ how do I use this?):

curl -s -S -L 'https://raw.githubusercontent.com/check-spelling/check-spelling/c635c2f3f714eec2fcf27b643a1919b9a811ef2e/apply.pl' |
perl - 'https://github.com/microsoft/PowerToys/actions/runs/21128469821/attempts/1' &&
git commit -m 'Update check-spelling metadata'

Forbidden patterns 🙅 (1)

In order to address this, you could change the content to not match the forbidden patterns (comments before forbidden patterns may help explain why they're forbidden), add patterns for acceptable instances, or adjust the forbidden patterns themselves.

These forbidden patterns matched content:

Should be reentrant

[Rr]e[- ]entrant

If the flagged items are 🤯 false positives

If items relate to a ...

• binary file (or some other file you wouldn't want to check at all).

  Please add a file path to the excludes.txt file matching the containing file.

  File paths are Perl 5 Regular Expressions - you can test yours before committing to verify it will match your files.

  ^ refers to the file's path from the root of the repository, so ^README\.md$ would exclude README.md (on whichever branch you're using).

• well-formed pattern.

  If you can write a pattern that would match it,
  try adding it to the patterns.txt file.

  Patterns are Perl 5 Regular Expressions - you can test yours before committing to verify it will match your lines.

  Note that patterns can't match multiline strings.