.env.example

# RepoCiv Bridge
REPOCIV_PORT=5273
# Capital city display name shown in the panel header.
# If a folder in your workspace has this name (lowercased), it becomes the capital
# instead of a regular city tile.
# VITE_CAPITAL_NAME=Capital
BRIDGE_PORT=5274
BRIDGE_WS_PORT=5275
VITE_PORT=5273
# Frontend needs the same token as the bridge when REPOCIV_TOKEN is set.
VITE_REPOCIV_TOKEN=${VITE_REPOCIV_TOKEN:-}
# Auth token — dejar vacío = dev mode local (auth bypass). En remoto: token aleatorio de 32+ chars.
# Generar con: python3 -c "import secrets; print(secrets.token_hex(32))"
REPOCIV_TOKEN=

# Remote mode via Tailscale
# Set REPOCIV_REMOTE=true AND REPOCIV_TOKEN to expose the bridge on 0.0.0.0.
# WARNING: In remote mode, REPOCIV_TOKEN is REQUIRED. The bridge will REFUSE to
# start if REPOCIV_REMOTE=true is set without a token.
# REPOCIV_REMOTE_ORIGIN restricts CORS to a specific origin (e.g. Tailscale IP).
# Omitting it allows localhost only. Do NOT leave blank in production remote mode.
# REPOCIV_REMOTE=true
# REPOCIV_REMOTE_ORIGIN=http://<tailscale-ip>:5273
# REPOCIV_CORS_ORIGINS — comma-separated extra allowed CORS origins. Use this for
# WSL2 / Tailscale setups where the browser hits the bridge at the WSL2 external
# IP (e.g. http://100.123.206.92:5273) without enabling full remote mode.
# Example: REPOCIV_CORS_ORIGINS=http://100.123.206.92:5273
# REPOCIV_CORS_ORIGINS=

# Workspace paths — absolutas o con ~ (se expanden con expanduser)
# Mapa Imperial (Vite): carpetas hijas directas de esta ruta = ciudades. Prioridad: REPOCIV_MAP_ROOT > WORKSPACE_ROOT > REPOCIV_REPOS_ROOT > ~/.hermes/workspace/repos
# Ejemplo WSL/Linux: REPOCIV_MAP_ROOT=~/workspace
REPOCIV_MAP_ROOT=
WORKSPACE_ROOT=~/.hermes/workspace/repos
HERMES_ROOT=~/.hermes
REPOCIV_REPOS_ROOT=~/.hermes/workspace/repos

# ── Nebius Token Factory (hackathon Stage 1) ─────────────────────────────────
# API key ONLY here (this file is gitignored). Never commit a real key.
# Get one at https://build.nebius.com → Token Factory.
NEBIUS_API_KEY=
# Inference provider switch: 'hermes' (default, CLI gateway) or 'nebius'
# (direct Token Factory calls with Nemotron models, visible per-unit).
REPOCIV_INFERENCE_PROVIDER=hermes

# Hermes Agent API
HERMES_URL=http://localhost:8642/v1/chat/completions
HERMES_MODEL=minimax-m2.6
REPOCIV_CONFIG_DIR=~/.repociv

# ── Maravillas (Wonders) ──────────────────────────────────────────────────────
# NADA viene pre-instalado: el mapa arranca sin maravillas iframe. Conectás las
# que uses desde el Palacio → pestaña "Maravillas", que escribe el manifiesto en
# ~/.repociv/wonders/<id>.json. Ahí van la URL del iframe, el health-check y el
# bloque opcional `launch` con el comando que RepoCiv usa para levantar su
# servidor. Ver docs/CUSTOM_WONDERS.md. No hay variables VITE_WONDER_* que
# configurar: cada maravilla lleva sus URLs en su propio manifiesto.

# ── Agentes externos (Suvadu) ──────────────────────────────────────────────────
# El bridge lee `suv agent sessions` cada ~30 s y muestra en el mapa los Claude
# Code / Codex / Cursor activos (unidades ext-*). Fail-open si suv no está.
# Ver docs/EXTERNAL_AGENTS.md.
# SUVADU_BIN=~/.cargo/bin/suv
# REPOCIV_EXT_AGENTS=1                 # 0 = no arrancar el tracker
# REPOCIV_EXT_AGENTS_WINDOW_MIN=10     # sin actividad en N min → despawn
# REPOCIV_EXT_AGENTS_WORKING_MIN=2     # actividad en los últimos N min → working (si no, idle)
# REPOCIV_EXT_AGENTS_POLL_S=30
# REPOCIV_EXT_AGENTS_RECENT_H=24       # panel de Agentes (F8): sesiones de las últimas N h

# Maravillas iframe servidas en el origen de RepoCiv (/wonder-proxy/<id>/, HTTP + WS),
# para verlas desde otra máquina (Tailscale) sin exponer su puerto. Solo destinos
# loopback. Ver docs/CUSTOM_WONDERS.md §4.5 y docs/GHOSTDESK.md.
# REPOCIV_WONDER_PROXIES=ghostdesk=http://127.0.0.1:6080

# Isolated agent execution (Fase 5 — requires Docker + built image)
# REPOCIV_AGENT_CONTAINER=1
# REPOCIV_AGENT_IMAGE=repociv-agent:latest
# Optional smoke test only: REPOCIV_CONTAINER_STUB=1
# Build image: ./scripts/build-agent-image.sh