daevix hack
10 folders · 9 files

demo-opencode-probe
demo-stream-client
demo-transfer-agent
demo-transfer-mcp
genwiredecode
genwireencode
h3probe
lpxm-e2e-material
lpxm-e2e-upstream
vendor
check-script.js
containerd-snapshot-orphans.sh
deploy-enclave-instance.sh
opencode-e2e.sh
quic-tproxy-validate.sh
README.md
render-script.js
vm-enclave-down.sh
vm-enclave-up.sh
README.md

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.