Fix Zen jiggle mode for macOS 26 (Tahoe) + Optional CI/CD

[pjaol]

Summary

This PR fixes Zen jiggle mode compatibility with macOS 26 (Tahoe) and adds optional GitHub Actions CI/CD workflows to automate builds and releases.

Problem

Zen jiggle mode stopped working properly on macOS 26 due to two separate issues:

1. System sleep prevention - The previous IOPMAssertionCreateWithName() approach no longer properly resets the system idle timer on macOS 26
2. Screen lock prevention - macOS 26 separated display sleep/lock from system sleep, requiring a separate assertion

This is related to PR #35 which identified the same issue.

Solution

Code Changes

AppDelegate.h:

• Added _userActivityAssertion and _displaySleepAssertion instance variables
• Added IOKit import for power management APIs

AppDelegate.m - Initial Fix (v1.11):

Replaced deprecated API for system sleep:

• Old: IOPMAssertionCreateWithName() with kIOPMAssertionTypePreventUserIdleDisplaySleep
• New: IOPMAssertionDeclareUserActivity() with kIOPMUserActiveLocal

Improved assertion lifecycle:

• Properly release previous assertions before creating new ones via undeclareUserActivity()
• Prevents assertion leaks
• Ensures clean state for each jiggle

Removed obsolete code:

• Removed deprecated UpdateSystemActivity() weak import and usage
• This API was deprecated in macOS 10.8 and is no longer effective

AppDelegate.m - Screen Lock Fix (v1.12):

Added display sleep prevention:

• Create dual power assertions: one for system sleep, one for display sleep
• Prevents both system sleep AND screen lock on macOS 26
• Uses IOPMAssertionCreateWithName() with kIOPMAssertionTypePreventUserIdleDisplaySleep

Optional: GitHub Actions Workflows

This PR also includes three optional GitHub Actions workflows:

1. build.yml - Automatic builds on every push and PR

   • Verifies compilation
   • Uploads build artifacts
   • Runs basic code quality checks

2. pr-checks.yml - PR validation

   • Validates project structure
   • Reports warnings
   • Posts welcome message on new PRs

3. release.yml - Automated releases

   • Triggered by version tags (e.g., git tag v1.12)
   • Creates DMG and ZIP files
   • Publishes draft GitHub releases

Note: These workflows are completely optional and can be deleted if not desired. They require no secrets or configuration to work - builds are unsigned for testing purposes.

Testing

Tested on:

• macOS 26.3 (Tahoe) - Apple Silicon
• Xcode 26.3

Verification:

• ✅ Zen jiggle mode keeps Mac awake without cursor movement
• ✅ Screen does NOT lock even after extended idle time (v1.12 fix)
• ✅ System does NOT sleep (v1.11 fix)
• ✅ Standard and Click jiggle modes continue to work
• ✅ All conditional jiggling options functional
• ✅ No console errors or warnings
• ✅ App builds cleanly with no new warnings
• ✅ Power assertions verified via pmset -g assertions

Benefits

For macOS 26 users:

• Zen jiggle mode fully works - no system sleep, no screen lock
• No user-facing changes or configuration needed
• Seamless upgrade

For maintainers (optional):

• Automated build verification on every PR
• One-command releases with DMG/ZIP creation
• Faster contributor feedback loop
• Reduced maintenance burden

API Changes

The implementation now uses TWO power assertions:

// System sleep prevention (v1.11)
IOPMAssertionDeclareUserActivity(
    CFSTR("Jiggler Zen Jiggle Activity"),
    kIOPMUserActiveLocal,
    &_userActivityAssertion
);

// Display sleep/lock prevention (v1.12)
IOPMAssertionCreateWithName(
    kIOPMAssertionTypePreventUserIdleDisplaySleep,
    kIOPMAssertionLevelOn,
    CFSTR("Jiggler Prevent Display Sleep"),
    &_displaySleepAssertion
);

On macOS 26, both assertions are required because Apple separated system sleep from display sleep/lock.

Backward Compatibility

✅ These changes are backward compatible with older macOS versions (10.15+):

• IOPMAssertionDeclareUserActivity() available since macOS 10.9
• IOPMAssertionCreateWithName() with kIOPMAssertionTypePreventUserIdleDisplaySleep available since macOS 10.6

Files Changed

Core fixes:

• AppDelegate.h - Added assertion instance variables and IOKit import
• AppDelegate.m - Updated Zen jiggle implementation with dual assertions

Optional CI/CD (can be deleted if not wanted):

• .github/workflows/build.yml
• .github/workflows/pr-checks.yml
• .github/workflows/release.yml

Related Issues

• Addresses the same issue as PR updated zen jiggle to work on macOS 26 #35
• Potentially fixes issue add old activity assertions back in #44 (old activity assertions)

Releases

This fix has been tested in production:

• v1.11 - Initial system sleep fix (released 2026-03-19)
• v1.12 - Screen lock fix (released 2026-03-22)

Both releases available at: https://github.com/pjaol/Jiggler/releases

Request for Review

This is a focused change to fix macOS 26 compatibility. The CI/CD workflows are included as a bonus but are completely optional - feel free to delete them if you prefer to keep the project as-is.

The core fixes are well-tested and use recommended Apple APIs for these use cases.

[Panja0]

I tried both versions (v1.10 and 1.12 from you) and both seem to not work at all for me.
I have given the Accessibility rights within the Privacy settings and set Jiggler to standard mode.
Tried nearby and far but the mouse does not move for me. Jiggler activates (I have the onscreen icon and menu bar icon turns green) but no mouse movement is seen. Any ideas?

Using Tahoe 26.4

[pjaol]

I'll take a look, I had that as well and I thought I had fixed it

[Panja0]

Did you find anything? ☺️