Skip to content

feat(platform): cross-platform desktop adapters for macOS Metal and Linux (M12) - #16

Merged
BerryUIKI merged 1 commit into
devfrom
feature/m12-cross-platform
Sep 23, 2026
Merged

BerryUIKI merged 1 commit into
devfrom
feature/m12-cross-platform

Conversation

@BerryUIKI

Copy link
Copy Markdown
Owner

Summary

This PR implements Milestone M12: Cross-Platform Desktop Adapters (macOS Metal MPS & Linux).

Key Capabilities

  • Cross-Platform Single-Instance Mutex:
    • Implements reliable, zero-dependency Unix domain socket single-instance locking in \launcher/src/single_instance.rs\ on non-Windows targets (macOS and Linux).
    • Handles stale socket detection, automatic unlinking on drop, and cross-platform unit tests.
  • Cross-Platform Browser Launcher:
    • Abstracts workspace opening across Windows (\cmd /c start), macOS (\open), and Linux (\xdg-open).
  • Hermetic Runtime Path Resolution:
    • Adapts directory structures, virtual environments, and python binary resolution for Unix (
      untime/python/bin/python, \�ackend/.venv/bin/python) and Windows.
  • Platform Portability Architecture Guide:
    • Detailed reference documentation in \docs/PLATFORM_PORTABILITY.md.

Automated Verification

  • Backend pytest: 103 passed (including 4 new tests in \�ackend/tests/test_m12_cross_platform.py)
  • Frontend: TypeScript typecheck and Vite build passed cleanly
  • Launcher: \cargo test\ (3 passed, including cross-platform single instance test)

@BerryUIKI
BerryUIKI merged commit 2551796 into dev Sep 23, 2026
3 checks passed
@BerryUIKI
BerryUIKI deleted the feature/m12-cross-platform branch September 23, 2026 10:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant