Developer Guide

Welcome to the HaH development documentation. This section covers the internals, project structure, and how to contribute to HaH.

Project Structure

HaH is organized as a Cargo workspace:

hah: The main CLI binary.
hah-core: Core data models, traits, and common functionality.
hah-dsl: YAML rule engine, pipeline evaluator, and capability bridge.
hah-caps: Capability implementations — system queries (apt, files, kernel, journal, etc.).
hah-utils: Low-level shared utilities and library facades.

Checks: Units of diagnostic logic that implement the Check trait.
Findings: Results returned by checks, containing a severity and remediation suggestions.
Capabilities: Data sources (like apt, files, sysctl) implemented in hah-caps that rules can query via capability triggers.

Refer to the Agent Guidelines for the full quality gate requirements (make check).