In this section
Roadmap
The roadmap describes capability boundaries and acceptance targets, not delivery dates. A feature moves to available only when its contract, failure behavior, and relevant acceptance path are documented and tested.
Status definitions
| Status | Meaning |
|---|---|
| Available | Usable in the current alpha with a documented contract and acceptance path. |
| In development | Actively being hardened or expanded; expect compatibility work and contract review. |
| Planned | Direction accepted, but implementation has not started or is not committed. |
| Deferred | Intentionally out of the current product boundary. |
Available today
- Command-scoped TCP and UDP proxying through cgroup eBPF, without
LD_PRELOAD. - Daemonless foreground execution for all decrypt modes, with isolated per-run relay, DNS, maps, links, cgroup, and JSONL state.
- No background service, machine-wide control plane, or persistent kernel state.
- Foreground owner signal forwarding and deterministic non-interactive setup authorization.
- Named SOCKS5 outbounds, direct egress, ordered rules, fake DNS, and explicit rejects.
- Strict TOML/YAML/JSON configuration with an offline generated schema and read-only complete examples.
heimdall agentas a read-onlyheimdall.agent/v8execution contract.- Runtime TLS pre-attachment for active and system-loader OpenSSL images, including loader-known images mapped after child exec without a privileged runtime broker.
- Low-cardinality
heimdall.logs.summary/v1run health derived from append-only evidence, with a strict offline schema. - Bounded
heimdall.logs.flow/v1explanations for one selected flow, with route/result, fixed capture direction/boundary counters, actual plaintext observation, TLS/HTTP and error evidence, and argv-safe next actions without payload, header, or SNI copy. - Correlated fake-DNS, policy, TCP/UDP, runtime TLS, relay ClientHello, negotiated TLS, and trust-boundary-specific certificate alert or unclean-close evidence.
- Bounded atomically published content-addressed payload blobs with boundary/direction allowlists and pre-storage exact-value redaction.
- Provenance-linked HTTP/1 request and response headers derived only from explicit TLS plaintext, with common credential headers masked and no body copy in JSONL.
- Current/Linux 6.6 LTS NixOS coverage plus pinned Ubuntu 24.04 and Debian 13 x86_64 archive, authorization, fake-DNS, lifecycle, TLS, log-integrity, and daemonless-cleanup gates.
- Current/LTS NixOS, Ubuntu 24.04, and Debian 13 machine-readable latency, RSS, 1/10/50 concurrency, sustained TCP/UDP/capture throughput, and event-integrity baselines.
- Reproducible static x86_64/aarch64 Linux archives with checksums, BTF-preserving artifact hygiene, authoritative local release gates, atomic install, and one-level rollback.
Resolver preflight is available. Additive heimdall.agent/v8 fields report system DNS, direct port-53 interception, or private-mount fallback together with NSS/nscd evidence, AppArmor/userns settings, inspection argv, and deterministic pre-exec blockers.
Relay CA preflight is available. Generated CAs and leaves carry strict signing extensions; incompatible material makes agent readiness false before execution.
Current platform scope. Published packages and the complete transparent backend remain Linux-only. Apple silicon can run the reduced cooperative macos-explicit backend from source. macos-interpose is active daemonless fallback research. The optional Network Extension control/provider prototype is deferred, source-only, and excluded from release artifacts.
In development
Daemonless lifecycle
The NixOS current/LTS, Ubuntu 24.04, and Debian 13 gates cover descendants, all owner signals, concurrent sessions, parent-death recovery, exact authorization, both TLS modes, and loader-configured OpenSSL mapped after exec. Extend this lifecycle matrix without retaining setup privilege at runtime.
Agent event evidence
Per-run health and per-flow explanations now have strict offline schemas. Expand beyond the available bounded, recoverable, provenance-linked HTTP/1 evidence only where new parsers remain conservative and directly usable with Linux tools.
Proxy compatibility
Ubuntu 24.04 proves namespace-free fake DNS under its AppArmor restriction. Debian 13 proves the private resolver mount for its stock nss-resolve status-action chain without host resolver edits or a session D-Bus service. Expand namespace-free compatibility across NSS modules and caches that bypass port 53.
TLS boundaries
Relay mode preserves ALPN and SNI, supports long-lived streams, emits strict CA/leaf extensions, and rejects incompatible CA material before execution without claiming pinning or client-certificate mTLS support.
Capture analysis
Expand the available flow explanation, boundary, direction, and blob inspection plus private run-store retention only where the result remains bounded, provenance-linked, and agent-readable.
Performance and observability
Low-cardinality run summaries and repeatable current/6.6 LTS NixOS, Ubuntu 24.04, and Debian 13 real-eBPF performance baselines are available. Repeat the contracts across more distributions.
Native ARM completion
Artifact hygiene is available. Run the defined aarch64 current/Linux 6.6 LTS real-eBPF gates on an ARM Linux executor, then add that result to the release transaction.
macOS backend
The native-accepted macos-explicit source backend stays available. Next, build the separately named macos-interpose fixture around authenticated DYLD interposition, TCP connect, libc resolver calls, and the foreground relay; add Proxyman-style child-only runtime proxy/trust adapters. Keep Hardened Runtime, SIP, static code, alternate APIs, unsupported descendants, strict scope, UDP, and TLS unavailable until native evidence proves each boundary. The heimdall.macos.control/v1 and NETransparentProxyProvider prototype remains deferred source research with release_included=false; package and release construction must not build or include it. Read the design →
The proxy-compatibility track keeps resolver reporting aligned with runtime decisions while expanding namespace-free compatibility only for NSS stacks that genuinely reach port 53.
Deferred boundaries
Heimdall is not a cluster controller, replacement VPN, desktop traffic dashboard, host-wide always-on system proxy, or universal TLS decryption layer. Shipping, signing, installing, or activating the checked-in macOS Network Extension prototype is also deferred. These are deliberate exclusions that keep the command wrapper reliable and inspectable.
heimdall agent. Discuss the boundary and acceptance criteria before opening a pull request.