homelab-codex-ws/inventory/topology.yaml

topology:
  mesh: tailscale
  git_provider: forgejo

deployment:
  mode: pull
  orchestrator: saturn

nodes:

  saturn:
    roles:
      - control
      - development

  piha:
    roles:
      - infra
      - monitoring
    services:
      - node-agent
      - ha-diag-agent
      - brain-watchdog
      - vikunja             # Task management (vikunja + postgres), public via npm
      - kb-postgres         # KB spine: Postgres 16 + pgvector, port 5433 (always-on)

  solaria:
    roles:
      - compute
      - ai
    services:
      - node-agent

  vps:
    roles:
      - edge
      - ingress
      - control-plane
    services:
      # Repo-managed GitOps services (hosts/vps/services.yaml is authoritative)
      - node-agent
      - control-plane       # executor, observer, supervisor, operator-ui
      - node_exporter
      - fleet-prometheus    # Fleet liveness source of truth (Tailscale-internal)
      - stability-agent
      - npm                 # Nginx Proxy Manager — public ingress, TLS termination
      - outline             # Team wiki (outline + postgres + redis)
      - joplin              # Note sync server (joplin-server + postgres)
      - ai-cluster          # AI workers: codex-worker, openclaw, planner-worker,
                            # service-ops-worker, redis, mosquitto

  chelsty-infra:
    site: chelsty
    roles:
      - remote
      - hypervisor
      - infra
      - staging
    connectivity:
      uplink: lte
      intermittent: true
    home_automation:
      offline_operation_required: true
      services:
        - zigbee2mqtt
        - mosquitto
      coordinator:
        model: SLZB-06U
        connection: network
        usb: false

  chelsty-ha:
    site: chelsty
    roles:
      - remote
      - homeassistant
    connectivity:
      uplink: lte
      intermittent: true
    home_automation:
      offline_operation_required: true
      services:
        - homeassistant

  lustro:
    roles:
      - edge
    services:
      - node-agent