> ## Documentation Index
> Fetch the complete documentation index at: https://gigi-f9937525.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# System Overview

> High-level view of the Go foundation runtime.

# 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.

```mermaid theme={null}
flowchart LR
  Env["Environment Config"]
  App["cmd/gigi + internal/app"]
  Web["internal/web<br/>/healthz + /readyz"]
  Ready["internal/storage<br/>DB readiness + migrations"]
  DB["Local PostgreSQL + pgvector"]
  Discord["Discord Gateway<br/>/ping + DM/mention + /permissions + /llm + /plugins + dry-run + public dispatch"]
  Security["Capability + Identity + Audit<br/>permission gate"]
  Seams["Future Seams<br/>jobs retrieval memory restricted dispatch"]
  Compose["Docker Compose"]
  CI["GitHub Actions<br/>Go + Compose smoke"]
  Deploy["Coolify / Docker Deploy"]

  Env --> App
  App --> Web
  App --> Discord
  Discord --> Security
  Web --> Ready
  Ready --> DB
  App --> Seams
  Compose --> App
  Compose --> DB
  CI --> Compose
  Deploy --> Compose
```

## 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