Skip to content

Remove the Python bridge #30

Closed
Closed

Description

@Skeyelab

Parent

#12

What to build

Once the Swift app does everything the Python bridge did, the Python code goes and the README describes the app.

Acceptance criteria

  • Every parity story in Native macOS menu-bar app (Swift, Mac App Store) #12 passes in the app. The in-app diagnostics replace monitor and led-sweep, and mapping import replaces --config.
  • The Python package, tests, pyproject and egg-info are removed.
  • The README is rewritten for the app: install, Syndicate setup, settings, diagnostics and mapping overrides.
  • CI no longer runs pytest.

Blocked by

Activity

  1. added this to the v1.0: native Mac app milestone on Nov 16, 2026
  2. Skeyelab commented on Nov 16, 2026

    @Skeyelab
    MemberAuthor

    Parity audit for #30

    Every parity story in #12 and every Python test, mapped to the Swift test that covers it. The Swift tests live in Packages/ControllerBridgeKit/Tests. Gaps are filed as #72.

    Parity stories (#12)

    Story Covered by
    9. 14-bit pitch fader as a float TempoSlider ContinuousTests: "The 14-bit pitch fader sends TempoSlider as a float…", "Fader bottom is -1.0; the center snaps to 0.0…", "pitch.invert flips the direction…"
    10. Jog nudges while playing, seeks while paused, BeatSkip without a length ContinuousTests: "While playing, the jog nudges with PhaseBend ±1…", "While paused, the jog moves the playhead… 0.501", "Paused with no track length, 32 jog ticks skip one beat"
    11. Nudge released 80 ms after the wheel stops ContinuousTests: "…PhaseBend 0 follows 80 ms after the wheel stops". EngineTests: "A tick from the pipe… the jog nudge is released"
    12. Needle Drop seeks while touched ContinuousTests: "Needle Drop seeks only while the strip is touched…"
    13. Transport and browse buttons send the same OSC CoordinatorTests: Play. TransportTests: Cue, Censor, Sync and Master, Pitch ± with Shift reset, Key Lock, Slip. BrowseTests: Loop In, Loop Out and Auto Loop, beat jump and Shift + beat jump (bar), Param ◀ ▶, Track ◀ ▶, Back and Forward, Select press, Shift + Select, Select turn
    14. Hot Cue, Roll and Loop pads; mode switch releases a held pad PadsTests: "In Hot Cue mode…", "In Roll mode…", "Roll sizes…", "In Loop mode…", "In Slicer mode the pads send nothing", "Switching pad mode while a pad is held releases it once…", "…releases only the pads, not a held Cue"
    15. Auto loop knob halves and doubles BrowseTests: "Turning the auto loop knob doubles the loop forward (LoopOut) and halves it back (LoopIn)…"
    16. Play, Cue, Sync and Master LEDs follow Syndicate CoordinatorTests: "The Play LED is dim (1) while stopped and full (127)…". TransportTests: "The Cue LED…", "The Sync LED follows Sync; Master…". MasterStatusTests
    17. Key Lock, Slip, Shift and pad-mode LEDs show the bridge's state TransportTests: Key Lock and Slip toggles with their LEDs, "The Shift LED…". PadsTests: "The mode button LEDs show the current mode…"
    18. Pads in Syndicate's cue colors, quantized PadsTests: "Hot cue pads show their cue colors… red 48, orange 56", "ColorPalette feedback recolors a slot…", "A dim cue color still lights…", Roll and Loop pad colors
    19. Platter ring lit while loaded PadsTests: "The platter ring (note 40) lights in the ring color… = 11"
    52. MIDI monitor with mapping names or UNMAPPED DiagnosticsTests: "The monitor names each message from the mapping, or UNMAPPED…", "…shows every channel…". Window: App/DiagnosticsWindow.swift (#26)
    53. LED sweep: 64 colors, then each button note DiagnosticsTests: "The LED sweep steps the pads and ring through all 64 colors…", "After the colors… every other note lights full, dim, then off…"

    The 23 Python tests

    Python test Covered by
    test_coordinator::test_start_opens_matching_ports_and_asks_for_state CoordinatorTests: "Start asks Syndicate to resend its state", "Start connects the source whose name matches…, and no other"
    test_coordinator::test_poll_turns_controller_midi_into_osc CoordinatorTests: "Pressing Play sends PlayPause 1…". EngineTests: "A Play press from the pipe…"
    test_coordinator::test_poll_releases_jog_nudge_after_wheel_stops EngineTests: "A tick from the pipe… the jog nudge is released"
    test_coordinator::test_feedback_lights_the_controller EngineTests: "A Playing 1 datagram from the pipe is decoded and lights the Play LED full"
    test_coordinator::test_stop_releases_held_controls_and_closes_ports RecoveryTests: "Quit (stop) releases held controls, then closes the ports"
    test_coordinator::test_missing_controller_names_the_ports_that_exist Changed on purpose (spec #12: starting with no controller isn't an error). RecoveryTests: "Starting with no controller is fine…". ProfileMatchingTests: "With no matching device nothing is bridged: the device is listed with a plain message, and logged"
    test_coordinator::test_no_output_port_still_bridges_without_leds Gap → #72
    test_bridge::test_relative_ticks BrowseTests: Select turn 0x02, 0x7F and 0, and 0x7D. The 0x3F/0x40 boundary is a gap → #72
    test_bridge::test_join_14bit_and_pitch ContinuousTests: the three pitch tests above
    test_bridge::test_rgb_to_velocity PadsTests: red 48, orange 56, dim lights at 16, roll 56, loop 12, ring 11. White (0x3F) and black (0) are a gap → #72
    test_bridge::test_trigger_only_on_press CoordinatorTests: "Pressing Play sends PlayPause 1; releasing it… sends nothing"
    test_bridge::test_hold_sends_release TransportTests: "Cue is a hold…"
    test_bridge::test_other_channel_ignored CoordinatorTests: "MIDI on another channel is ignored"
    test_bridge::test_hotcue_pad_hold PadsTests: "In Hot Cue mode… HotCue n 1, then HotCue n 0"
    test_bridge::test_roll_mode_and_mode_switch_releases PadsTests: "In Roll mode…", "Switching pad mode while a pad is held releases it once…"
    test_bridge::test_pitch_fader_14bit ContinuousTests: "The 14-bit pitch fader… a repeated value isn't resent"
    test_bridge::test_jog_bend_while_playing_then_release ContinuousTests: "While playing, the jog nudges with PhaseBend ±1, and PhaseBend 0 follows 80 ms…"
    test_bridge::test_jog_seek_while_paused ContinuousTests: "…seeks to 0.501"
    test_bridge::test_jog_fallback_beatskip_without_duration ContinuousTests: "Paused with no track length, 32 jog ticks skip one beat"
    test_bridge::test_release_all TransportTests: "Stop releases every held control exactly once…". ContinuousTests: "The nudge is a held control…". PadsTests: "Held pads are in the held-control list…"
    test_bridge::test_feedback_drives_leds PadsTests: cue colors. CoordinatorTests: the Play LED
    test_bridge::test_osc_args_must_be_numbers By construction: OSCArgument is .int, .float or .string, so a Bool can't be sent. OSCCodecTests check the bytes
    test_bridge::test_udp_loopback scripts/smoke.sh: the sandboxed app against a virtual MIDI source and a UDP loopback. It runs in CI on a best-effort basis

    CLI replacements

  3. added a commit that references this issue on Nov 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    ready-for-agentFully specified, ready for an AFK agent

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions