Modules and developer profiles
Reference · generated · the twelve optimization modules, and the developer profiles that select them
A developer profile is a tag that pms modules ls --for and pms doctor --for take, and that the MCP modules_list tool takes as profile. It selects modules from the table below and enables nothing: pms modules ls --for lists them, and pms doctor --for adds a line naming them. An unknown profile makes pms modules ls exit 1 and pms doctor report a warning. A developer profile is not the profiles repository (pulse-mesh-profiles), which holds the enterprise, HFT and robotics rings.
The table is static, in dev_ring/dev-functions/src/core_ops/modules.rs, and this page is generated from what pms modules ls --json prints.
Developer profiles
| Profile | Flag | Modules | Rings the modules sit in |
|---|---|---|---|
hft | --for hft | M01, M02, M03, M04, M09, M11 | dev_ring, hft_ring |
ai | --for ai, --for inference | M01, M04, M05, M06, M07, M12 | hft_ring, robotics_ring |
robotics | --for robotics | M03, M04, M08, M10, M12 | hft_ring |
telemetry | --for telemetry | M05, M07, M08, M10 | robotics_ring |
dev | --for dev | M04 | hft_ring |
Modules
A module is a crate of its own or a module inside one layer of a ring (crate::module). The ring column names the ring whose layer holds it, and is blank for a crate of its own.
| Module | Crate or module | Ring | What it does | Developer profiles |
|---|---|---|---|---|
| M01 | hft_stages::numa | hft_ring | Hugepages + NUMA-aware ring placement | hft, ai |
| M02 | dev_stages::conflation | dev_ring | Symbol-keyed last-write-wins router for quote-style traffic | hft |
| M03 | hft_functions::wait | hft_ring | UMWAIT / Park / BusySpin + smart poll_hint | hft, robotics |
| M04 | hft_stages::spmc | hft_ring | Lock-free SPMC ring (1 publisher, N readers) | hft, ai, robotics, dev |
| M05 | robotics_stages::net_uring | robotics_ring | io_uring batched send/recv for cross-host fan-out | ai, telemetry |
| M06 | robotics_stages::large_payload | robotics_ring | Tier-2 envelope LRU + NACK backfill | ai |
| M07 | robotics_stages::autoscale | robotics_ring | LagObserver + swap-ring protocol | telemetry, ai |
| M08 | pms-telemetry-export | Prometheus exporter | telemetry, robotics | |
| M09 | hft_core::prefetch | hft_ring | Adaptive cache-line prefetch | hft |
| M10 | pms-crc32c | CRC32C trailer integrity | robotics, telemetry | |
| M11 | hft_core::wire_v2 | hft_ring | Wire format v2 (separate data-ready line) | hft |
| M12 | mesh-broadcast | In-process listener fan-out | ai, robotics |