hack/ — developer & validation tooling #
Not part of the shipped binary. Excluded from the build fences and lint scope.
quic-tproxy-validate.sh + h3probe/ #
Runtime validation of the gateway's transparent UDP/QUIC datapath (bd_2_0-baq)
on the real Linux kernel, using the actual dvx binary. h3probe is a tiny
real HTTP/3 client + upstream + cert generator; the script wires them around
dvx serve gateway --udp-listen in throwaway network namespaces with real
iptables TPROXY rules.
# Needs root (netns + iptables) and Go on PATH incl. /usr/sbin:
sudo env PATH="/usr/sbin:/usr/bin:/sbin:/bin:$(dirname "$(command -v go)")" \
hack/quic-tproxy-validate.sh
Expected tail: === PASS: transparent QUIC/HTTP-3 datapath validated ===, with a
200 on the allowlisted authority, 403 on the denied one, and matching
gateway.egress mediation=quic-mitm allow/deny audits. See
deploy/enclave/README-udp-tproxy.md for how this maps onto a real deployment.
genwiredecode/ + genwireencode/ #
Code generators for internal/translation's hand-optimized wire arshalers:
genwiredecode emits wire_decode_gen.go (table-driven direct decoders that
skip reflection), genwireencode emits wire_encode_gen.go (direct encoders
byte-identical to encoding/json semantics, incl. omitempty len==0, HTML
escaping, and U+2028/U+2029 handling).
Regenerate after changing a wire type (add/remove/rename a struct or field) or
the omit/escape logic in the generator — never by editing the _gen.go files:
make gen-wire
The generators import (and thus compile) the translation package, so they
cannot write into it while its generated files are being replaced: the target
generates to a temp file and mvs it into place. Never redirect straight over
the _gen file. After regenerating, run the differential + fuzz harnesses
(go test ./internal/translation/) — they are the gate for accepting new
generated output. See internal/translation/doc.go and BENCHMARKING.md.
Site hero Scripts (render-script.js, check-script.js) #
render-script.js renders the Daevix.Script hero SVGs at build time from the
design handoff's component bundle, vendored with the React UMD bits in
hack/vendor/. make gen-site-scripts writes the committed Hugo partials
(site/www/layouts/partials/script-hero.html,
site/docs/layouts/partials/script-hero.html) using the release tag
(git describe --tags --abbrev=0) as seed and message; make check-site-scripts runs the bundle's own Daevix.decodeScript over the
committed SVGs and asserts the message.