Skip to content

Fix session response matching, fallback sticks, and GameCube motor gating - #3

Merged
jmonster merged 2 commits into
test/macos-protocol-buildfrom
fix/session-command-and-model-guards
Sep 10, 2026
Merged

jmonster merged 2 commits into
test/macos-protocol-buildfrom
fix/session-command-and-model-guards

Conversation

@jmonster

@jmonster jmonster commented Sep 9, 2026

Copy link
Copy Markdown
Owner

Ready for review — scoped session corrections, depends on #1

Head 2ee0d1ca5b84f45a267b62a05c88ad6518d60f6b. Exact-head macOS tests and actual app build passed.

  • Unrelated/short command notifications no longer consume the current command or cancel its timeout. Existing response classes 0x01/0x02 remain accepted; no speculative status interpretation.
  • Memory reads require the documented echoed address, not just the requested length. Missing calibration uses a nominal 12-bit stick fallback instead of permanently returning (0,0); valid calibration and handedness are preserved.
  • Normal and direct/experimental motor writes enforce the existing model.hasHDRumble capability. GameCube HD motor writes are suppressed; GameCube preset rumble is not implemented. LED keep-alives continue during unsupported rumble requests. Other models retain their existing motor bytes.

Four named cases reproduce the original failures and exercise the production session methods through test-only radio stand-ins. Apple-framework compilation and ad-hoc bundle validation run separately in CI. This candidate's session changes also passed the combined nine-PR macOS integration check.

Compatibility: memory address validation follows research/PROTOCOL.md; firmware differences require captures. Rumble suppression deliberately avoids a motor path the upstream model declares unsupported. The fallback is uncalibrated input, not factory accuracy. Physical firmware, keep-alive and rumble acceptance remain unperformed.

Pairing/encryption, GATT UUIDs, initialization command bytes/order, input decoding and connection timeouts are unchanged. Merge #1 first, then retarget this PR to main; #8 follows this PR. No merge or release performed.

…ut for readiness (#8)

Guard late notifications, queued commands and timers after session retirement.
Clear notify completion before invocation to preserve reentrant replacement.
Require isNotifying on essential channels and one existing-decoder input report
before readiness, retaining the established keep-alive and handshake bytes.

Eleven synthetic production-session tests pass locally; five new targeted
cases fail against the prior session source. Full Apple-framework build and
regressions remain the hosted gate. No new connection deadline or protocol.
@jmonster
jmonster merged commit 5ae4d21 into test/macos-protocol-build Sep 10, 2026
1 check passed
@jmonster
jmonster deleted the fix/session-command-and-model-guards branch September 10, 2026 00:02
jmonster added a commit that referenced this pull request Sep 10, 2026
* test: add protocol fixtures and read-only macOS app build checks

* test: run isolated regression groups alongside protocol fixtures

* Adopt the browser bridge with replay, lifecycle, and access guards (#5)

* feat(browser): stage attributed browser bridge for guarded integration

Adapted from Andrei-Kondrykau/switch2mac browser-bridge at
24b0cd3 (upstream PR #2).
Keep the output sink unregistered until access and lifecycle guards are added.
Retain the contributor's source and documentation, with our read-only checks.

* fix(browser): guard replay, rumble ownership, and opt-in WebSocket access

Preserve complete connection/state replay after rename and reject obsolete
socket callbacks. Keep long effects alive only for their requested lifetime,
settle cancelled effects, and reject retired actuators. Eight deterministic
Node regressions cover these behaviors (seven fail on the imported source).

Add an opt-in settings window, exact extension-Origin checks, bounded clients
and messages, and per-client rumble ownership. GameCube HD rumble is withheld
using the existing model capability. Origin checks are not native-process
authentication. Exercise the actual Network.framework listener in macOS CI.

Adapted browser feature retains attribution to Andrei-Kondrykau's upstream
browser-bridge at 24b0cd3.

* fix(browser): distinguish validated rumble values from clamped magnitudes

* docs(browser): document fork opt-in setup and actual compatibility limits

* fix(browser): preserve bridged controllers when native gamepads hotplug

Move only a conflicting virtual index and announce the old/new indices,
without mutating prior snapshots or hiding the native device. A regression
fails against the previous shim and all nine Node cases pass after repair.

* Adopt optional RetroArch network output with input-delivery regressions (#6)

* feat(retroarch): import the optional network gamepad sink for regression validation

Adapted from vialoh/switch2mac retroarch-network-gamepad at
2c7a396 (upstream PR #1).
Retain the contributor's opt-in default and attribution; validate actual
Swift builds and repair edge/lifecycle behavior before marking ready.

* fix(retroarch): preserve edges, refresh releases and retire old destinations

Retain the attributed optional fork output and existing remote_message bytes.
Replace latest-only button state with a bounded edge queue; overflow explicitly
neutralizes this output until disable/re-enable. Include zeros in periodic
refreshes and clear the old port before switching destinations. Reject nonfinite
axes and remove the imported Array safe-subscript compile failure.

Eight synthetic/real-loopback cases pass locally; the tap, release refresh,
destination, overflow and finite-axis cases fail against the imported source.
UDP acceptance is not acknowledgement; no physical-gameplay claim is made.

* fix(retroarch): resume ordered input after cancelling a destination change

A partially completed reset left switchIndex active when the user changed
back to the original port. Subsequent button edges were never queued.
Reassert the desired state and retire that reset; the new real-loopback
regression fails against the previous head and the nine-case suite passes.

* fix(fork): isolate app identity and disable upstream automatic updates (#9)

Use io.github.jmonster.switch2mac and a distinct bundle name/defaults domain.
Keep upstream credits but reject default or saved update feeds and updater
entry points until a fork-specific signing/update trust path is established.

Require explicit signing identities, notary credentials and fork-matching
entitlements instead of silently consuming upstream signing configuration.
No certificate, profile, notarization request or release is created here.

Add metadata, actual feed-resolver and early signing-refusal regressions and
build the actual ad-hoc fork app in the existing read-only macOS check.

* Neutralize disconnected UDP controllers and bound subscriber processing (#4)

* fix(udp): neutralize disconnected slots and bound subscriber handling

* test(udp): synchronize real datagram arrival before subscriber assertions

* Fix session response matching, fallback sticks, and GameCube motor gating (#3)

* fix(session): preserve command correlation and respect model capabilities

* fix(session): retire callbacks before teardown and require usable input for readiness (#8)

Guard late notifications, queued commands and timers after session retirement.
Clear notify completion before invocation to preserve reentrant replacement.
Require isNotifying on essential channels and one existing-decoder input report
before readiness, retaining the established keep-alive and handshake bytes.

Eleven synthetic production-session tests pass locally; five new targeted
cases fail against the prior session source. Full Apple-framework build and
regressions remain the hosted gate. No new connection deadline or protocol.
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