Skip to content

v0.3.1 — verdict-first view + parallel correctness

Choose a tag to compare

@tstefank tstefank released this 18 Jun 12:13
· 3 commits to main since this release

A UX + correctness release on top of the MVP. Same capabilities (Phases 1–3, zero FDA), but the output now reads at a glance and parallel servers are handled correctly.

Legibility

pounce view defaults to a verdict-first summary — a one-line verdict, then each tool call with the connections it caused:

node fetch-server.mjs  <session>
? 1 connection to an IP with no DNS lookup

  tools/call fetch  {"url":"https://api.example.com"}
     ✓ tcp 93.184.216.34:443  api.example.com
     ? tcp 45.83.12.9:443  no DNS lookup — unverified destination

1 tool call · 2 connections · 1 unverified    (--timeline for the full log)
  • Two-level confidence: ✓ confirmed (the connection went where the call declared), ? unverified (a host the call didn't declare, or no DNS lookup at all). There's deliberately no red "⚠ malicious" verdict — passive correlation can't assert that (a no-DNS connection may just be a cached lookup), so pounce reports honest confidence and leaves hard alarms to a future rule layer.
  • --timeline keeps the full chronological protocol + OS log.
  • --all [--limit N] rolls several sessions into one overview — the view when multiple servers run at once.

Parallel correctness

  • Destination-matched attribution: a connection now attributes to the call whose arguments declared its host (via DNS), so concurrent tool calls to different hosts split correctly instead of both landing on the latest call.
  • Unique session ids: two shims starting in the same millisecond no longer collide into one log (the id carries the PID).
  • DNS is shared: resolutions are broadcast to every session (connections stay attributed by PID subtree), so a legitimate connection isn't mis-flagged just because mDNSResponder did the lookup.

Validated live: two servers wrapped at once (one trojan, one honest) show one ? and one ✓, correctly separated. scripts/demo-parallel.sh reproduces it.

See docs/correlation.md for the model and caveats (DNS-cache false positives, conservative declaration).

Install

Static binaries, no dependencies:

chmod +x pounce-darwin-arm64   # or -amd64 on Intel
xattr -d com.apple.quarantine pounce-darwin-arm64
mv pounce-darwin-arm64 /usr/local/bin/pounce

Verify with shasum -a 256 -c checksums.txt.

Full changelog: v0.3.0...v0.3.1