Skip to content
hbs-tool.
Documentation07 of 07

Validation & testing

Unit suites, the 13-distro Linux sweep, Windows Server Core matrices, and the E2E harnesses.

≈ 1 min read

Unit / integration

cd extractor && cargo test              # Rust suite (unit + integration + catalog audit)
cd dashboard && bun test                # Bun backend + frontend unit suite
cd dashboard && bunx tsc --noEmit       # strict TypeScript
cd dashboard && bunx playwright test    # browser E2E (gated by HBS_E2E=1)

Real-world matrices

# Linux: static musl extractor inside real distros, root + non-root, --network none
bash scripts/docker-test/run.sh
bun run scripts/docker-test/validate-reports.ts   # decrypt + assert every sealed report

# Linux end-to-end: issue a musl extractor, run it in debian:12, push to dashboard
cd dashboard && bun run ../scripts/e2e-linux.ts

# Windows: Server Core LTSC 2019/2022/2025 via the Docker WINDOWS engine
cd dashboard && bun run ../scripts/docker-e2e-hosts-windows.ts

Harness reference

ScriptPurpose
scripts/build-all.shCross-compile the target matrix (+ size gate)
scripts/docker-test/run.sh13-distro Linux sweep, root/non-root, --network none
scripts/docker-test/validate-reports.tsDecrypt every report; assert content + logs
scripts/docker-e2e-hosts.tsDashboard-hosted Linux sweep (download → run → push/upload)
scripts/docker-e2e-hosts-windows.tsSame for Windows Server Core containers
scripts/e2e-linux.tsIssue → run in debian:12 → push → assert routing/exports
scripts/e2e-loop.tsWindows issued-extractor loop (incl. confidentiality assertions)
scripts/windows-validate.tsNative Windows scan matrix (full/filtered/category/list)
scripts/check-spa.tsSPA serving smoke (root, deep link, assets, API)