ddidderr
7aeaa0aeb9
Add the observability vocabulary needed for phase-1 frame logging and client status reporting. Runtime crates can now emit structured events without each binary inventing separate field names for the same tunnel state. The new models cover frame direction, action, drop reason, parsed Ethernet frame logs, malformed frame logs, tunnel counters, relay/QUIC/TAP client diagnostics, and user-facing diagnostic messages. TunnelStats now lives in lanparty-obs and is re-exported by lanparty-ctrl so stats remain one shared type whether they are logged locally or carried over the control stream. This still does not add logging sinks or tracing integration; those should be wired in when the relay, gateway, and client loops exist. Test Plan: - cargo fmt --check - cargo test --workspace - cargo clippy --workspace --all-targets -- -D warnings Refs: PLAN.md Logging / diagnostics
softlan-vpn
Monorepo for a Layer 2 over QUIC LAN party bridge.
Workspace crates
lanparty-proto: shared frame format, MAC validation, MTU helpers.lanparty-ctrl: control-plane messages (join/hello/role/version).lanparty-obs: shared diagnostics/logging event models.lanparty-client-core: platform-agnostic client session state.lanparty-client-win: Windows TAP + route/metric handling binary.lanparty-gateway: Linux AF_PACKET gateway binary.lanparty-relay: public QUIC relay binary.
lanparty-proto
Transport-agnostic tunnel contract shared by all binaries:
- overlay datagram header encoding and decoding
- Ethernet frame header parsing
- MAC address parsing and identity validation
- QUIC datagram to TAP MTU budget helpers
lanparty-ctrl
Reliable control-plane schema shared by the QUIC stream handlers:
- endpoint hello messages with role, room, MAC, and datagram budget
- server welcome, reject, peer lifecycle, stats, and disconnect messages
- room-code, role/MAC, peer-id, and effective-MTU validation
lanparty-obs
Shared diagnostics and structured logging vocabulary:
- gateway/relay frame logs with MACs, ethertype, length, peer, and action
- tunnel counters shared by control messages and runtime diagnostics
- client connectivity/TAP diagnostics and user-facing status messages
Build
cargo check --workspace