Alpha public usage

note

Dhal is currently on the v0.12.0-beta.0 beta track. This page documents the prior alpha track; see Beta / v1 readiness for the current guidance.

Dhal 0.11.0-alpha.0 is public and usable, but still pre-1.0.

Stability posture

Area	Status
Package	@rokadhq/dhal
CLI	dhal
Config	dhal.json
Recommended install	exact pinned version
Recommended first mode	monitor
Recommended enforcement	route-level block after review
Public API	usable but not frozen until 1.0

Recommended install during alpha

npm install @rokadhq/dhal@0.11.0-alpha.0

Or if the package is published under the alpha dist-tag:

npm install @rokadhq/dhal@alpha

Before enabling block mode

Run:

npx dhal doctor
npx dhal rules
npx dhal simulate fixtures.simulation.json
npx dhal replay fixtures.replay.json
npx dhal ci

For production, prefer route-level block mode over a global switch.

Runtime safety defaults

Dhal defaults to availability-first behavior:

• internal Dhal errors fail open by default;
• health/readiness/liveness paths can bypass inspection;
• OPTIONS can bypass inspection for preflight compatibility;
• observability event data is redacted by default.

Public issue reports

Generate a redacted report:

npx dhal report --output dhal.report.json

Review the file before sharing it. It should not include secrets, but route names and posture settings can still reveal operational details.