89 lines
7.4 KiB
Markdown
89 lines
7.4 KiB
Markdown
# Runtime Parity Scope
|
|
|
|
This is the claim CultLib can make without turning evidence into incense.
|
|
Parity means the targeted runtimes speak the same wire language and expose
|
|
similar developer-facing entrypoints for the roles they own. It does not mean
|
|
every runtime clones the C# production server, LiteNetLib history, or hot-loop
|
|
memory layout.
|
|
|
|
## Objective
|
|
|
|
Cross-runtime parity has three layers:
|
|
|
|
- Wire parity: shared CultCache file/state contracts, schema-v0 MessagePack
|
|
documents, transport profiles, and RUDP packets must cross runtime boundaries
|
|
without translation folklore.
|
|
- Feature parity: each runtime must expose the CultCache/CultNet/CultMesh
|
|
surfaces needed for its intended role, with unsupported production-server
|
|
ownership called out plainly.
|
|
- Ergonomic parity: callers should find a branded `CultMesh` entrypoint,
|
|
typed catalogs, discovery helpers, authority checks, stream surfaces, and
|
|
transport helpers instead of assembling raw maps and channel strings.
|
|
|
|
SoA performance parity is deliberately not a cross-runtime requirement. C#
|
|
owns the CPU-local SoA table and shared-memory streaming body path. Other
|
|
runtimes may add native hot paths when their runtime role earns them, but they
|
|
do not need to mimic Unity/C# memory layout to speak CultNet or participate in
|
|
CultMesh.
|
|
|
|
## Current Targeted Runtimes
|
|
|
|
| Runtime | Role | Claimed parity | Not claimed |
|
|
| --- | --- | --- | --- |
|
|
| C# | Reference implementation and production game/server substrate | CultCache typed documents and SoA, CultNet schema-v0, LiteNetLib production path with adapter profile, shared transport profiles, shared RUDP socket transport, RUDP reconnect policy/controller and reconnect-loop helper, LiteNetLib client reconnect-controller adoption, schema-client transport port for service request/response clients, CultMesh node/session/catalog/stream/simulation/RUDP surfaces, authorized peer lookup | No need to abandon LiteNetLib before the CultNet adapter fully owns production service adoption |
|
|
| Python | Package runtime, local daemon endpoint, raw interop peer, typed state participant | CultCache/CultNet/CultMesh package surface, branded CultMesh node/schema/shard/Verse/peer/authority/stream/RUDP ergonomics, authorized peer lookup, shard catalogs/logs, schema-transport factory for raw client request/subscription flows, local TCP CultMesh server, session/prediction/simulation fact helpers, RUDP codec/session/socket transport, RUDP reconnect policy/controller and reconnect-loop helper, schema-v0 MessagePack over RUDP evidence, benchmark evidence against C# cache paths | Universal C# throughput, full C# daemon/server stack, and RUDP as the only public service pipe |
|
|
| TypeScript | Node/browser-adjacent projection and interop runtime | CultCache parity tests, CultNet schema-v0 peer, advertised schema/shard catalog wire contracts plus request/sync helpers, transport profiles, TCP-framed transport port and peer helper, shared RUDP socket transport, RUDP reconnect policy/controller, RUDP reconnect-loop helper, branded CultMesh node/schema/shard/Verse/peer/authority/stream/RUDP ergonomics, authorized peer lookup | Full C# game session/server stack |
|
|
| Rust | Low-level cache/transport/runtime substrate | CultCache/CultNet interop lane, schema and shard catalog helpers, transport profiles, TCP-framed port, shared RUDP codec/session/socket transport, RUDP reconnect policy/controller and reconnect-loop helper, schema-v0 MessagePack over RUDP evidence, small CultMesh facade for schema registry, shard catalog, peer cards, authority leases, authorized peer lookup, RUDP endpoint parsing, and peer-card/authorized-peer RUDP client construction | Full CultMesh game-session/server facade, stream catalog, or production game-session server |
|
|
| Kotlin | JVM/Android client substrate | Typed MessagePack cache, built-in schema catalog advertisement, schema/shard catalogs with shared schema-message transport fetch/sync helpers, authority leases, authorized peer lookup, stream catalog, branded `CultMesh` facade, WebSocket transport profile/connection helper, RUDP client/server sugar, RUDP reconnect policy/controller and reconnect-loop helper, schema-v0 MessagePack over RUDP evidence | C# SoA store, full C# server daemon, or Unity hot-loop memory layout |
|
|
|
|
## Evidence Gates
|
|
|
|
- `.github/workflows/cultnet-interop.yml` is the hosted CI witness for the
|
|
cross-runtime wire claim. It builds the TypeScript workspace, Kotlin interop
|
|
peer, Rust/C# interop peers through the TypeScript harness, installs the
|
|
Python package dependencies, then runs named RUDP lanes for Python, Rust, C#,
|
|
and Kotlin, the RUDP impairment matrix, and the schema-v0 discovery lane.
|
|
- `packages/cultnet-ts/test/interop/cultnet-interop.test.ts` is the main live
|
|
wire harness. It covers schema-v0 interop and RUDP exchange across C#,
|
|
TypeScript, Rust, Python, and Kotlin, including loss, reordering,
|
|
fragmentation, disconnect reason propagation, ping/pong, and schema-v0
|
|
MessagePack over RUDP for C#, Rust, Python, and Kotlin peers against
|
|
TypeScript. Those RUDP schema-message tests also assert the advertised
|
|
`reconnectPolicy` profile field from C#, Rust, Python, and Kotlin peers.
|
|
Runtime-local tests cover the deterministic delay helper and reconnect
|
|
controller in C#, TypeScript, Rust, Python, and Kotlin.
|
|
- `packages/cultcache-py/PARITY.md` is the Python-specific audit ledger. Its
|
|
"Still Not Claimed" section is part of the contract, not an apology.
|
|
- `docs/cultnet-transport-parity.md` is the transport ownership map. It tracks
|
|
the remaining work to lower older LiteNetLib/WebSocket bodies behind the
|
|
shared transport port and expand RUDP adoption beyond the core proof.
|
|
- `packages/cultmesh-kotlin/README.md` records Kotlin's runtime role and
|
|
ergonomic surface, including the explicit non-claim around C# SoA storage.
|
|
|
|
## Expansion Work Outside The Current Parity Claim
|
|
|
|
The current claim is role-scoped feature, wire, and ergonomic parity across the
|
|
targeted runtimes. The stronger claim that every production daemon/service body
|
|
has already moved to native RUDP, or that every runtime clones the C# production
|
|
server body, is deliberately not made.
|
|
|
|
- Broaden production service adoption so remaining daemon paths use the shared
|
|
transport port consistently. The C# built-in LiteNetLib service wrappers now
|
|
register transport-aware `CultNetServerPeer` listeners instead of requiring
|
|
`NetPeer` callbacks, and TypeScript TCP peer creation has a transport-first
|
|
helper. C# Verse discovery, peer exchange, shard-log fetch, shard-snapshot
|
|
fetch, and shard write forwarding clients now consume a schema-client
|
|
transport port with the LiteNetLib client as the default adapter; broader
|
|
daemon adoption remains the unclaimed layer.
|
|
- Extend RUDP adoption through daemon/socket reconnect loops. RUDP profiles now
|
|
advertise the portable reconnect policy, runtime-local tests prove the shared
|
|
controller across the targeted runtimes, and the C# LiteNetLib client plus
|
|
C#/TypeScript/Rust/Python/Kotlin RUDP reconnect loops use that controller;
|
|
broader service adoption remains a separate claim.
|
|
- Keep Kotlin ergonomic parity moving with Android/JVM-shaped APIs instead of
|
|
backfilling C# server responsibilities it should not own. Kotlin WebSocket
|
|
and RUDP adapters now share one `CultNetSchemaMessageTransport` helper shape
|
|
for schema/shard catalog request and sync flows.
|
|
- Keep performance claims evidence-bound: C# owns SoA; Python has benchmark
|
|
comparison gates; other runtimes should advertise measured native hot paths
|
|
only when those paths exist.
|