Program: implement PacketDump #87

Closed
opened 2026-08-08 08:24:32 +00:00 by hugo · 1 comment
Owner

Objective

Port PacketDump with safe raw/decoded packet subscription, filtering, formatting, and output handling.

Deliverables

  • Preserve documented login/connection flow and packet logging purpose.
  • Support sanitized output, optional raw bytes, direction/type filters, and bounded file/stdout writes.
  • Never print credentials or capability tokens.

Validation

  • Fake-grid packet capture tests cover filters and formatting.
  • Malformed/unknown packets are reported without crashing.
  • Clean cancellation/logout is verified.

Prerequisite

The library behavior required by the program is implemented and its translated parity tests pass.

Project constraints

  • Programs must use the native Rust public API; no CLR, C# process, bridge, RPC, or fallback.
  • Provide deterministic offline/fake validation before opt-in live or device tests.
  • Never log/store credentials or capability tokens, and keep destructive/spending actions separately opt-in.
  • Update program/source completeness, docs, and workspace validation evidence.
## Objective Port PacketDump with safe raw/decoded packet subscription, filtering, formatting, and output handling. ## Deliverables - Preserve documented login/connection flow and packet logging purpose. - Support sanitized output, optional raw bytes, direction/type filters, and bounded file/stdout writes. - Never print credentials or capability tokens. ## Validation - Fake-grid packet capture tests cover filters and formatting. - Malformed/unknown packets are reported without crashing. - Clean cancellation/logout is verified. ## Prerequisite The library behavior required by the program is implemented and its translated parity tests pass. ## Project constraints - Programs must use the native Rust public API; no CLR, C# process, bridge, RPC, or fallback. - Provide deterministic offline/fake validation before opt-in live or device tests. - Never log/store credentials or capability tokens, and keep destructive/spending actions separately opt-in. - Update program/source completeness, docs, and workspace validation evidence.
hugo added this to the 11 - Programs and live-grid validation milestone 2026-08-08 08:24:32 +00:00
hugo added the enhancement label 2026-08-08 08:24:32 +00:00
Author
Owner

Implemented in f0420f6.

  • Added native packet-dump with the upstream positional login/duration flow, 20-second timeout, disabled multi-sim mode, reduced land/wind/cloud throttles, finite or Ctrl-C capture, and ordered logout/disposal.
  • Added bounded incoming/outgoing capture, exact direction/type filters, decoded header formatting, optional sanitized raw hex, bounded file/stdout output, queue/drop accounting, and stable errors.
  • Added deterministic fake datagram scripts using the real native packet decoder; malformed and unknown packets are reported without aborting.
  • Extended decoded packet events to retain optional original datagrams through synchronous and asynchronous callbacks, with a focused native test.
  • Added password/session-byte masking plus URL, authorization, capability, and token suppression, and updated program completeness documentation.

Verified: PacketDump unit and CLI suites; native raw-callback test; native packet_wire 6/6; translated wire_semantics 54/54; rustfmt; Clippy with warnings denied for both changed crates; shim/API coverage; workspace all-target check and no-run test build; rustdoc with warnings denied.

Implemented in f0420f6. - Added native `packet-dump` with the upstream positional login/duration flow, 20-second timeout, disabled multi-sim mode, reduced land/wind/cloud throttles, finite or Ctrl-C capture, and ordered logout/disposal. - Added bounded incoming/outgoing capture, exact direction/type filters, decoded header formatting, optional sanitized raw hex, bounded file/stdout output, queue/drop accounting, and stable errors. - Added deterministic fake datagram scripts using the real native packet decoder; malformed and unknown packets are reported without aborting. - Extended decoded packet events to retain optional original datagrams through synchronous and asynchronous callbacks, with a focused native test. - Added password/session-byte masking plus URL, authorization, capability, and token suppression, and updated program completeness documentation. Verified: PacketDump unit and CLI suites; native raw-callback test; native `packet_wire` 6/6; translated `wire_semantics` 54/54; rustfmt; Clippy with warnings denied for both changed crates; shim/API coverage; workspace all-target check and no-run test build; rustdoc with warnings denied.
hugo closed this issue 2026-08-11 08:07:20 +00:00
Sign in to join this conversation.