…Hackers#2690)

* ci(workflows): upgrade actions for node24

Update active GitHub Actions workflows to Node 24-compatible major versions to remove runner deprecation warnings in release and CI jobs.

Align checkout, cache, upload-artifact, and download-artifact usage across the active workflow set and document the change in the development diary.

* ci(ci): upgrade dorny/paths-filter to v4 for node24

And default enable 5 Committee approved fixes

…tables (TheSuperHackers#2607)

…s#2694)

This reverts commit 67f50d1 because it can cause mismatching

…letion (#134)

* fix(audio-openal): advance Attack/Sound/Decay portions on sample completion

The OpenAL backend polled sourceIsStopped() in processPlayingList() but
discarded PlayingAudio without calling notifyOfAudioCompletion(). Miles
Sound System used EOS callbacks for this, so the port lacked the
equivalent polling-based trigger.

Result: the Attack portion (radio static, gradio1*.wav) played once,
then the PlayingAudio was released before the Sound (voice) or Decay
portions could start. All aircraft and unit voice lines were silent on
Linux/macOS.

Fix: call notifyOfAudioCompletion() before releasing a stopped sample.
If it starts the next portion the AL source transitions back to playing
and the object remains in the list; only release when the source is
still stopped after the call (cycle complete or failed to load).

Apply the same fix to both m_playingSounds (2D) and m_playing3DSounds
(3D positional) loops. Skip the call when m_requestStop is set (user
explicitly stopped the event).

Also add a multichannel positional-audio fallback in playSample3D() and
OpenALAudioCache so that stereo voice assets fall back to 2D playback
instead of being dropped or crashing.

Fixes #129

* chore(audio-openal): remove voice diagnostics instrumentation

Use wrapper-managed render-target transitions in pillarbox begin/end,

re-sync cached render states after the final blit, and keep

pillarbox presentation from semantically enabling RTT for the

entire frame.

Fixes #131

* fix(linux-filesystem): resolve asset-root case mismatches

Fix Linux asset-root fallback lookups to preserve case-insensitive path resolution semantics used by legacy data references. This unblocks cursor ANI discovery and related media lookups when file names differ only by case on disk.

Fixes #128

Related-to #103

* fix(linux-filesystem): resolve asset-root case mismatches
## Summary
This PR fixes Linux asset lookup behavior when game data references mixed-case paths but files on disk differ only by case.

The root cause was in asset-root fallback resolution: the fallback path did not perform case-insensitive traversal, unlike the main local path resolution flow.

## What Changed
- Added Linux-only case-insensitive traversal to asset-root fallback in [Core/GameEngineDevice/Source/StdDevice/Common/StdLocalFileSystem.cpp](Core/GameEngineDevice/Source/StdDevice/Common/StdLocalFileSystem.cpp).
- Kept platform behavior isolated with `#ifdef __linux__` to avoid changing macOS behavior.
- Kept SDL3 cursor loading hardening in both products:
  - [GeneralsMD/Code/GameEngineDevice/Source/SDL3Device/GameClient/SDL3Mouse.cpp](GeneralsMD/Code/GameEngineDevice/Source/SDL3Device/GameClient/SDL3Mouse.cpp)
  - [Generals/Code/GameEngineDevice/Source/SDL3Device/GameClient/SDL3Mouse.cpp](Generals/Code/GameEngineDevice/Source/SDL3Device/GameClient/SDL3Mouse.cpp)
- Updated docs:
  - [docs/DEV_BLOG/2026-05-DIARY.md](docs/DEV_BLOG/2026-05-DIARY.md)
  - [docs/WORKDIR/lessons/2026-05-LESSONS.md](docs/WORKDIR/lessons/2026-05-LESSONS.md)

## Validation
Manual Linux validation confirmed:
- default/action/attack cursors render correctly (no fallback to OS pointer).
- intro playback works.
- campaign start videos play.

## Issues
Fixes #128
Related-to #103

…ackers#2698)

…ackers#2698)

* fix(timing): protect timer APIs and validate FPS limits on non-Windows platforms

Resolve FPS uncapping and frame counter instability that affected both Generals
and Zero Hour on macOS and Linux.

Changes:
- protect timeBeginPeriod/timeEndPeriod Windows API calls with #ifdef _WIN32
  guards in FramePacer constructor/destructor
- add early-exit validation in FrameRateLimit::wait() to handle zero or invalid
  FPS limits without division-by-zero errors
- ensure uncapped mode (maxFps > 1000000) skips limiting gracefully

Shared Core/GameEngine fixes apply to both games automatically.
Both GeneralsX and GeneralsXZH build and launch successfully with stable frame pacing.

Fixes #132"

* fix(fps-init): ensure valid FPS default independent of m_useFpsLimit flag state

Root cause analysis: Generals base had FPS uncapped while Zero Hour worked because
GameEngine.cpp was checking (m_useFpsLimit && m_framesPerSecondLimit <= 0) before
setting default FPS. When m_useFpsLimit=FALSE (default) and m_framesPerSecondLimit=0
(default from INI loading), the condition failed and FPS remained 0 (uncapped).

Changed initialization logic to always set BaseFps default when m_framesPerSecondLimit <= 0,
regardless of m_useFpsLimit flag state. This ensures stable frame pacing on startup.

Applied to both GeneralsX and GeneralsXZH for consistency.

Fixes #132 completely"

* chore(generals-parity): complete parity audit wave 1-5 with CompatLib headers and GameEngine alignment

Summary of changes:
- Added full CompatLib header suite to Generals base for Win32/COM compatibility
- Completed GeneralsMD GameLOD, Player, PlayerList, and UI alignments
- Updated WWVegas2 libraries for both games
- Fixed FPS initialization logic (previously: only reset FPS when m_useFpsLimit=TRUE, now always set default)
- Protected Windows timer APIs with #ifdef guards
- Added FPS limit validation for uncapped mode
- Comprehensive audit trails in docs/WORKDIR/audit/

Generals base now has feature parity with Zero Hour for core systems.
Both titles compile successfully with stable frame pacing on macOS/Linux.

Related commits:
- 62dab6f: fix(timing) - timer API guards and FPS limit validation
- c722ca1: fix(fps-init) - ensure valid FPS default independent of flag state

…SuperHackers#2695)

…t dies (TheSuperHackers#2513)

…heSuperHackers#2706)

merge(sync): import TheSuperHackers upstream into GeneralsX (2026-05-15)