Skip to content

terok-util

The shared utility library that sits at the bottom of the terok-* dependency chain — the foundation of terok.

Every terok-* package depends on terok-util. terok-util depends on nothing else in the ecosystem. The package collects cross-cutting bits that would otherwise be duplicated (or quietly diverge) across the siblings: CLI registry types, filesystem invariants, namespace-aware XDG path resolution, layered config reading and the YAML config-merge engine, a best-effort file logger, podman helpers, untrusted-string sanitisation, and a round-trip YAML facade (terok_util.yaml).

Where to go next

  • Usage Guide — how to depend on terok-util and what to know when calling it.
  • API Reference — every public symbol, grouped by module.
  • Code Metrics — package-level stats (LoC, complexity, coverage).
  • CI Workflow Map — what runs where, on what triggers.

Source

github.com/terok-ai/terok-util