Skip to content

WireTrail v0.3.2

Latest
Latest

Choose a tag to compare

View all tags
@johnneerdael johnneerdael released this 26 Oct 23:08
v0.3.2
d1da263

WireTrail. Follow the request. Find the cause.

WireTrail — Follow the request. Find the cause.

What's new

This release is about the documentation and the identity. Analysis output is unchanged.

  • A user guide at https://wiretrail.neerdael.nl/. Tutorials, how-tos, recipes, concepts and a reference, 79 pages in all. Every block of output in it comes from a real run on a demo capture that you can download, and CI fails the build if a block of output no longer matches a real run or a page uses a flag the tool does not have.
  • The README and the guide now say what redaction does not mask. WireTrail masks the secrets it recognizes by header name, by JSON key name and by shape. It does not recognize every secret: search and extract mask by shape only, a JWT in a header outside the known list is printed, form-encoded bodies are not masked, summary prints the query values of repeated calls, and errors, report, diagnose and summary print the server's message as received. How redaction works lists what each command does. Read output before you share it.
  • A Limitations page lists, with a file that reproduces each, where a result can mislead. One example: --top cuts each check before the findings are ranked, so a capture with many error routes can hide a 5xx cluster at the default.
  • A new README and the WireTrail identity. The README opens with the project banner, which follows your light or dark setting, and the guide uses the WireTrail typefaces and colors.
  • USERGUIDE.md is now a map into the guide. Its examples came from a private capture, and the guide's demo captures replace them.
  • The Claude Code plugin text is corrected and links to the guide. It no longer tells an agent that output is safe to quote directly. Update the plugin to get it.
  • The crate links to the guide as its documentation, and the published package no longer carries the guide's scripts and configuration.

See What's new in the user guide.

Downloads

Download Platform
wiretrail-aarch64-apple-darwin.tar.gz macOS, Apple silicon
wiretrail-x86_64-apple-darwin.tar.gz macOS, Intel
wiretrail-x86_64-unknown-linux-gnu.tar.gz Linux, x86-64
wiretrail-aarch64-unknown-linux-gnu.tar.gz Linux, ARM64
wiretrail-x86_64-pc-windows-msvc.zip Windows, x86-64
wiretrail-aarch64-pc-windows-msvc.zip Windows, ARM64

Or install from source with cargo install wiretrail. The binaries are built by the release workflow from the tagged commit and are not code-signed.

Validation:

  • cargo fmt --check
  • cargo clippy --workspace --all-targets --all-features -- -D warnings
  • cargo test (236 tests)
  • mkdocs build --strict and the guide's output checks (79 pages and the README, 0 errors)
  • the demo captures regenerate byte for byte, and every command in the guide was run against them
  • 72 contrast pairs of the brand tokens meet WCAG AA, and the guide has no horizontal overflow at 390 px
  • the prose was fact-checked against the source by four independent reviewers, and every confirmed discrepancy was corrected
Assets 8
Loading