Skip to content

fix: report the real version, add --socket, and refuse mismatched release tags - #4

Merged
raffaelschneider merged 1 commit into
mainfrom
fix/version-and-socket
Oct 20, 2026
Merged

raffaelschneider merged 1 commit into
mainfrom
fix/version-and-socket

Conversation

@raffaelschneider

Copy link
Copy Markdown
Contributor

Addresses #3.

Version. The v0.3.0 and v0.4.0 binaries were built from their tags, but Cargo.toml was still at 0.2.0, so -V printed 0.2.0.

  • This PR bumps it to 0.5.0, a minor bump because --socket is new.
  • release.yml now fails the build when the tag and Cargo.toml disagree, so this can't recur.

--socket. The README documented it, but it never existed; the agent only served gRPC.

  • --socket <PATH> (env TRANSFORM_SOCKET) now serves the v2 protocol over UDS, the same way the ratelimit and waf agents do.
  • Without it, the agent still listens for gRPC on 0.0.0.0:50051, so existing deployments are unchanged. The two flags are mutually exclusive.

README. The CLI options now match --help, with a note on the gRPC KDL form.

Verified end to end against zentinel 26.10_5, with a rule that sets a response header:

  • --socket /tmp/zt-xform.sock with unix-socket "/tmp/zt-xform.sock" → 200 with X-Transformed: yes
  • no flag with grpc "http://127.0.0.1:50051" → 200 with X-Transformed: yes

fmt, clippy -D warnings and cargo test all pass. Issue #3 stays open until a v0.5.0 release ships the new binary.

…ease tags

The v0.3.0 and v0.4.0 binaries were built from their tags, but Cargo.toml was
never bumped past 0.2.0, so `-V` printed 0.2.0 (#3). Bump to 0.5.0, and make
the release workflow fail when the tag and Cargo.toml disagree.

The README documented `--socket`, which never existed: the agent only served
gRPC on 0.0.0.0:50051. Add it, the same way the ratelimit and waf agents do:
`--socket <PATH>` (or TRANSFORM_SOCKET) serves the v2 protocol over UDS.
Without it, the agent still listens for gRPC on 0.0.0.0:50051, so existing
deployments are unchanged. The two flags are mutually exclusive.

Verified end to end against zentinel 26.10_5, with a rule that sets a
response header. Over `--socket` with `unix-socket` in the KDL, and over the
gRPC default with `grpc "http://127.0.0.1:50051"`, the response carries the
header.

README: the CLI options now match `--help`.
@raffaelschneider
raffaelschneider merged commit 34a7519 into main Oct 20, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant