Epic: transport subcommands

[JPHutchins]

This is an epic issue to track the progress of the high level feature "transport subcommands", in both this repo and smp/smpclient.

Briefly, this is necessary because we currently pool transport options across all transports, meaning that it's possible to give transport options to the "wrong transport" - a no-op, but spaghetti code + UX. Instead the options should be sum types on the subcommands so that invalid options are not representable.

smp: https://github.com/JPHutchins/smp
smpclient: https://github.com/intercreate/smpclient

Organization

Breaking changes

Must be merged to a feature branch (on the respective repository) named screaming-goblin.

Other

Can merge to main as usual. Consider a PR or rebase of screaming-goblin after the merge to main to keep the breaking change feature branches relatively ready for merge.

Issues

Issues may be added or edited as work is completed.

smpmgr

• Migrate from Typer -> Cyclopts #68 (we may use argtree instead for speed/shell support, but that depends on time available)
• completion will close RFC: Use URIs for transport selection and config #35
• Switch from poetry to uv #57
• add camas #101
• Breaking: transport subcommands #102
• Feature request: Allow forcing cached GATT services (Bleak/WinRT) #82

smpclient

• breaking (this is the main pre-req): breaking: remove address from SMPClient; SMPTransport owns address smpclient#58
• Bleak transport options smpclient#90
• Remove the generic request/response pattern smpclient#124

smp

• Switch from poetry to uv JPHutchins/smp#47
• Use camas as runner instead of envr JPHutchins/smp#61
• Add coverage for python 3.15 JPHutchins/smp#60
• Add coverage for macos-15-intel & ubuntu arm runners JPHutchins/smp#53
• SMP message excludes fields from the SMP data JPHutchins/smp#45
  • update the existing impl: breaking: header and smp_data in Frame (related to #45) JPHutchins/smp#46
• Move generic request/response from smpclient to here JPHutchins/smp#62

[JPHutchins]

Warning

LLM Disclosure

This comment was authored by claude-opus-4-8 on behalf of @JPHutchins, summarizing recent smp progress on this epic and confirming the cross-repo staging plan.

smp — on screaming-goblin

• Frame[T]/Data on msgspec (breaking: rework SMP messages to Frame[T]/Data on msgspec (#45, #26, #5) JPHutchins/smp#65) — an SMP message is now Frame[T] = (Header, Data[T]); de/serialization moved from pydantic + cbor2 to msgspec + msgspec-cbor.
• Generic request/response moved into smp (Move generic request/response from smpclient to here JPHutchins/smp#62) — SMPRequest binds each request to its Response/ErrorV1/ErrorV2; the TypeIs narrowing helpers live in smp's static-typing tests as the consumer contract rather than shipping from the lib. This unblocks Remove the generic request/response pattern smpclient#124.
• custom grp: Import custom groups #45 (SMP data may contain fields named header/version/sequence/smp_data) — fixed by the Frame/Data split; regression coverage added in test: regression for #45 — SMP payload may contain header/version/sequence/smp_data JPHutchins/smp#69. Closes via the release PR breaking: screaming-goblin JPHutchins/smp#66.

smp — landed on main (non-breaking), rebased into screaming-goblin

• Python 3.15 (Add coverage for python 3.15 JPHutchins/smp#60, closed) — CI now matrixes 3.15, with the GHA python axis sourced from camas (camas matrix --github-matrix). The earlier import failure was a stale-uv alpha predating a CPython C-API addition (PEP 820), not an smp/cbor2 bug — closed upstream at 6.1.3 fails to import on CPython 3.15.0a2: undefined symbol PyType_FromSlots (no pure-Python fallback) agronholm/cbor2#328.

Cross-repo staging

To migrate all three repos in lockstep without cutting an smp release first: smpclient's screaming-goblin branch will pin smp's screaming-goblin (git dependency). smpclient — then smpmgr — build against the new smp API while it's still on the branch; when the breaking set is complete and downstreams are ready, smp cuts the release and the pins move to the released version.