diff --git a/docs/cultnet-transport-parity.md b/docs/cultnet-transport-parity.md index 89478d59..2276b2cb 100644 --- a/docs/cultnet-transport-parity.md +++ b/docs/cultnet-transport-parity.md @@ -29,10 +29,12 @@ CultNet owns cross-runtime transport semantics: | TypeScript `cultnet-ts` | `CultNetPeer` over any Node `Duplex`, TCP-framed transport, or single-peer RUDP socket transport; interop uses TCP | UDP multicast probe/announce in the interop peer | First UDP socket binding for the shared RUDP reliability owner | | Rust `cultnet-rs` | Interop example uses TCP length-prefixed MessagePack frames; single-peer RUDP socket transport exists in the library | UDP multicast probe/announce | UDP socket binding for the shared RUDP reliability owner | | Python `cultcache-py` | TCP sockets with 4-byte length-prefixed MessagePack frames for local CultMesh/CultNet server and client; single-peer RUDP socket transport exists in the library | Endpoint lists and CultMesh peer/Verse catalogs | UDP socket binding for the shared RUDP reliability owner | -| Kotlin `cultmesh-kotlin` | Minimal WebSocket-like lane over TCP socket; single-peer RUDP socket transport exists in the library | None found in the live package | UDP socket binding for the shared RUDP reliability owner, with build-script self-test | +| Kotlin `cultmesh-kotlin` | Minimal WebSocket-like lane over TCP socket; single-peer RUDP socket transport exists in the library | CultMesh Verse and peer catalogs, plus endpoint lists carried in schema-v0 catalog messages | UDP socket binding for the shared RUDP reliability owner, with build-script self-test | -The live split is therefore: payload language is converging, transport language -is not. +The live split is therefore: payload language and the native RUDP packet/session +language now converge across the targeted runtimes, while production service +adoption still varies by runtime and older TCP/LiteNetLib/WebSocket bodies have +not all been lowered behind the shared transport port. ## Invariants diff --git a/packages/cultcache-py/PARITY.md b/packages/cultcache-py/PARITY.md index 49442389..fb4f465e 100644 --- a/packages/cultcache-py/PARITY.md +++ b/packages/cultcache-py/PARITY.md @@ -40,7 +40,7 @@ CultCache, CultNet, and CultMesh. It is evidence, not confetti. responses because oversized snapshots and other peer failures use that contract on the wire. It also advertises the shared `cultnet.transport_profile.v0` contract so Python peers can describe their - current transport honestly before the cross-runtime reliable UDP owner lands. + TCP-framed and RUDP transport capabilities honestly. - Python CultNet security/session primitives: `CultNetClientSecurityOptions`, `CultNetServerSecurityOptions`, and `CultNetSecret` mirror the C#/TS connection-key, server signing-secret, @@ -95,6 +95,16 @@ CultCache, CultNet, and CultMesh. It is evidence, not confetti. Provides typed `CultNetWitnessArtifactBundle` ownership for the C#-compatible 8-slot witness artifact payload while preserving dict helpers for existing wire callers. +- Python CultNet RUDP transport: + Provides the shared `cultnet.transport.rudp.v0` packet codec, deterministic + RUDP session state machine, socket-backed single-peer transport connection, + transport profile advertisement, ping/pong, disconnect reason propagation, + timeout state, fragmentation/reassembly, reliable ordered `schema` delivery, + unreliable sequenced `latest`, unreliable unordered `realtime`, resend + pressure, and bounded reliable-send backpressure. The TypeScript interop + harness proves bidirectional Python/TypeScript RUDP socket exchange, + packet-loss recovery, reordering recovery, fragmentation, ping/pong, and + disconnect reason propagation through the shared wire language. - Python CultMesh discovery client: Fetches Verse catalogs and peer exchange responses from live endpoints over CultNet frames. It can also parse `cultnet://host:port` endpoints, discover @@ -269,10 +279,11 @@ node --test packages\cultnet-ts\dist-test\test\interop\cultnet-interop.test.js - Python does not implement the full LiteNetLib client/server auth flow. It now owns the shared security/session primitives for helper parity, while the live transport harness still speaks the schema-v0 interop lane. -- Python does not implement cross-runtime reliable UDP yet. The current - transport ownership map lives in `docs/cultnet-transport-parity.md`; the next - coherent target is a CultNet-owned transport port and `rudp` adapter shared - across runtimes, not a Python-only LiteNetLib imitation. +- Python does not make RUDP the only public pipe yet. The local CultMesh server, + raw client, and interop peer still use the TCP-framed schema lane for many + service and harness flows, while `docs/cultnet-transport-parity.md` tracks the + remaining work to put broader server-side bodies behind the shared transport + port instead of cloning LiteNetLib. - Python does not implement the full C# daemon/server stack. Its current role is package runtime, raw interop peer, launchable local CultMesh endpoint, local CultMesh session facade, and typed state participant.