.env.example

# UNITARES Governance MCP - Environment Configuration
# Copy to .env and fill in your values:
#   cp .env.example .env

# ===========================================
# DOCKER CREDENTIALS (used by docker-compose.yml)
# ===========================================
# These default the Postgres+AGE container at first startup. Change them
# before the first `docker compose up` if you want non-default credentials.
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
POSTGRES_DB=governance

# Host-side port mappings. Override only if those ports are already taken
# on your machine (e.g., a Homebrew Postgres on 5432, a host redis on 6379,
# or a separately-installed governance server on 8767).
# POSTGRES_HOST_PORT=5432
# REDIS_HOST_PORT=6379
# GOVERNANCE_HOST_PORT=8767

# ===========================================
# DATABASE (Required) - PostgreSQL is the sole backend
# ===========================================
# In docker-compose.yml the DB_POSTGRES_URL is wired automatically from the
# POSTGRES_* values above. Override below only for a non-Docker / external
# Postgres setup (Homebrew install, remote host, etc.).
DB_POSTGRES_URL=postgresql://postgres:postgres@localhost:5432/governance
DB_POSTGRES_MIN_CONN=2
DB_POSTGRES_MAX_CONN=10

# Knowledge graph backend: age (recommended), postgres (FTS), auto
UNITARES_KNOWLEDGE_BACKEND=age

# Dialectic session backend: postgres (recommended)
UNITARES_DIALECTIC_BACKEND=postgres

# ===========================================
# SERVER
# ===========================================
# SERVER_HOST=0.0.0.0
# SERVER_PORT=8767

# ===========================================
# AI SERVICES (Optional - for call_model and semantic search)
# ===========================================
# HF_TOKEN=xxx                         # Hugging Face Inference Providers (call_model cloud fallback)

# HuggingFace embeddings (offline mode recommended)
# HF_HOME=/path/to/.cache/huggingface
# TRANSFORMERS_OFFLINE=1
# HF_HUB_OFFLINE=1

# ===========================================
# GOVERNANCE TUNING (Optional)
# ===========================================
# UNITARES_PROCESS_UPDATE_RESPONSE_MODE=auto  # auto | minimal | compact | full

# I-channel dynamics mode (default: linear since v5)
# linear:   Prevents boundary saturation, stable equilibrium at I*≈0.80
# logistic: Legacy v4.1 behavior, can saturate I→1.0
# UNITARES_I_DYNAMICS=linear