Skip to main content

System Overview

This overview reflects the current Go foundation. Health/readiness, Discord liveness routing, permission grants, guild-scoped LLM provider controls, plugin catalog controls, external app dry-run matching, semantic dry-run routing, guild mention chat fallback, aggregate LLM usage reporting, and consented opt-in public dispatch run today when configured. Retrieval, memory, rich DM chat, and restricted external app dispatch remain later behavior.

Reading Guide

  • The runtime starts from cmd/gigi, loads config, and serves HTTP.
  • /healthz reports process/build health.
  • /readyz fails closed unless required config exists and PostgreSQL is reachable.
  • Discord liveness behavior is active when Discord is enabled.
  • Capability, identity, and audit gate /permissions, /llm, external app dry-run planning, semantic routing, and consented public dispatch; job, retrieval, and memory packages are foundations for later privileged behavior.
  • Docker Compose is the local and production deployment shape.

Keep This Updated When

  • command surfaces become live
  • restricted external app dispatch becomes live
  • job workers become live
  • storage schema boundaries change
  • deployment topology changes