Error handling

Updated Jul 27, 2026

Podbot uses semantic error types internally for conditions that callers might inspect, retry, or map to specific responses:

  • ConfigError: Configuration loading and validation errors
  • ContainerError: Container engine and lifecycle errors
  • GitHubError: GitHub App authentication errors
  • FilesystemError: Filesystem operation errors

At the application boundary, these are converted to human-readable error reports using eyre.