obacht

Appearance

Architecture ​

Data Flow ​

collectors (concurrent) → Facts JSON (schema v1.0)
  → embedded OPA evaluation with Rego policies
  → parse findings → diff against rule list
  → CheckResult per rule → reporter

Public API (pkg/) ​

pkg/schema ​

Type-safe data contracts:

  • Facts — collected environment data
  • ScanResult — evaluation results with summary
  • Rule — rule metadata

pkg/engine ​

OPA evaluation engine:

  • Evaluates policies in-process via embedded OPA library
  • Maps findings back to rules

Internal Packages ​

internal/collector ​

Nine concurrent collectors gathering environment facts:

  • SSH, Git, Docker, Kubernetes, Environment, Shell, Tools, PATH, OS
  • Three-state status: ok, skipped, error

internal/reporter ​

Output formatting:

  • Pretty (lipgloss-styled terminal output)
  • JSON (machine-readable)

internal/cli ​

Cobra command definitions:

  • scan — main security scan
  • explain — rule details
  • doctor — setup diagnostics