list:   every patchable name in the project (kind: track | folder | group), plus counts.
rename: apply changes [{"old","new","kind"?}] to the project's ProjectData. By default writes to an
        APFS clone "<name> OFFLINE.logicx" next to the original (instant, no data copied); in_place
        patches the original after saving ProjectData.bak, and is refused while Logic has that
        document open (Logic would overwrite it on save). Returns uncertain: only Logic reopening
        the file proves the edit, so open the result and read the names back.

bounce  - one pass, several formats at once: formats=["wav","mp3"]. Optional start_bar/end_bar limit the range.
          sample_rate like "44.1 kHz", bit_depth like "24-bit", normalize "Off", mode "Offline".
stems   - File > Export > All Tracks as Audio Files, one file per track (the input for level analysis).
options - read the current bounce dialog settings without changing anything.
dismiss - close any stray Logic dialog (escape hatch).

bounce_and_upload - the whole chain: render the project to `formats`, verify the files, upload them,
                    and return share links. Give directory + filename + formats + folder.
upload            - push existing local `paths` to remote:folder.
remotes / list    - what storage is configured, and what is already in a folder.
setup             - how the user connects their OWN cloud account.

Uploads go to the user's own remote: this server ships no credentials and no default account. The
remote comes from `remote`, else $LOGIC_MCP_REMOTE, else the single configured remote; with several
configured and nothing pinned it refuses rather than guessing. Run `setup` for the exact commands —
the user runs them themselves, since the flow ends in a browser sign-in to their own account.

insert   - add a plugin to a track by name, e.g. plugin="Channel EQ" (uses Mix > Search and Add Plug-in).
describe - every parameter, switch and menu in an open plugin window, with its current readout.
get      - one parameter's current value.
set      - drive a parameter to a target: value="+3 dB", "1.2 kHz", "80 Hz", 2.0. Verified by re-reading
           the plugin's own readout. A parameter whose band is switched off is enabled first when
           enable_band is true, otherwise it refuses rather than silently doing nothing.
switch   - toggle a named switch (an EQ band, Analyzer, HQ...).
preset   - read the current preset name.
windows / close - list or close open plugin editors.

Logic's meters report clipping only, with no numbers, so levels are measured from audio rather than read
off the UI — which is what a human engineer does anyway.

analyse         - loudness (gated LUFS per BS.1770), true peak, crest, stereo correlation and spectral
                  balance for each file in `paths`.
plan            - the above, plus a proposed gain and pan per stem. Nothing is applied.
export_and_plan - render one stem per track out of Logic first, then plan.
apply           - carry the plan out on the matching tracks, verified in dB. dry_run reports what it
                  would do without touching anything.

mode matters. "relative" adds each gain to the track's CURRENT fader, which is right when the stems were
rendered through those faders (export_and_plan). It is NOT idempotent — running it twice applies the move
twice. "absolute" treats each gain as the fader position itself, which is right for stems that came from
outside this project, and is safe to re-run.

We advertise a Bonjour service in the TouchOSC Mk1 format, Logic binds it as a control surface (one-time
alert "OSC app TouchOSC wants to connect" -> Connect, pressed automatically), then Logic streams its state
(track names of the current 8-strip bank, select/mute/solo, volumes, meters, bar, SMPTE time, transport)
and accepts the fixed LogicPad address map. Faster and more reliable than Mackie emulation for transport,
selection and mixer moves; every result is read back from Logic's own OSC echo.

connect        bind the device (idempotent).            status    snapshot of everything Logic last sent.
transport      command=play|stop|record|cycle|rewind|forward|click|soloreset (record starts recording on
               armed tracks -- only on explicit request).
bank           command=bank+|bank-|track+|track-  (move the 8-strip window; strips are 1..8 inside it).
select|mute|solo  strip=1..8 (mute/solo toggle; readback says the new state).
volume         strip=1..8 value=0..1 (fader, 0.75 ~ 0 dB).   master_volume value=0..1.
send           address=/1/... args=[...] raw message; feedback returns what Logic sent in the last `wait` s.

Selected-track pages (select a track first):
strip          inserts (slot, name, bypassed), focused plug-in name + its 16 parameters (name, 0..1, display),
               sends, pan, mute/solo/arm of the SELECTED track.
eq             the Channel EQ on the selected track: 8 bands (1 high-pass, 2 low shelf, 3-6 peaks, 7 high shelf,
               8 low-pass) with on/gain/freq/q (+slope on 1 and 8), each as 0..1 and Logic's display value.
               present=false means the track has no Channel EQ (insert one via logic_plugins first).
eq_set         band=1..8 param=gain|freq|q|slope|on, then EITHER value=0..1 (raw) OR target=<number in
               Logic's units: dB, Hz, Q> which is reached by bisection on Logic's display value
               ("cut the mud": band=4 param=freq target=300; param=gain target=-3; param=q target=1).
plugin         command=slot+|slot-|page+|page-|bypass|open  (bypass/open take slot=1..12) on the selected track.
param          list the focused plug-in's parameters (same as strip.params).
param_set      param=<n or exact name> + value=0..1 or target=<number in the display unit>; read back.