defmodule Apero do
  @moduledoc """
  Apero — Utility library for system operations and development workflows.

  Provides domain-specific tools organised into independent modules behind a
  consistent `{:ok, result} | {:error, reason}` interface.

  ## File & Path

  - `Apero.VFS` — virtual file system: file ops, atomic writes, temp resources, locking, watching
  - `Apero.Compress` — zip, tar and gzip compression

  ## Git & VCS

  - `Apero.Git` — repository management, sync, commits

  ## Containers

  - `Apero.Docker` — Docker / Podman lifecycle management

  ## Security

  - `Apero.Crypto` — hashing, AES encryption, key and password generation

  ## Environment

  - `Apero.Env` — environment variable management and `.env` files
  - `Apero.Conf` — config file validation, linting and formatting

  ## System

  - `Apero.OS` — operating system information (type, arch, CPU, memory, disk)
  - `Apero.Proc` — process and executable utilities
  - `Apero.Pkg` — cross-distro package manager abstraction

  ## Cache

  - `Apero.Cache` — unified cache interface with ETS adapter
  """
end