vil-server.reference.yaml

# =============================================================================
# vil-server.reference.yaml — Complete VIL Server Configuration Reference
# =============================================================================
#
# All values shown are defaults for the "dev" profile.
# Precedence: Code Default → YAML → Profile → ENV
#
# Profiles: dev, staging, prod
#   VIL_PROFILE=prod  (env override)
#
# Environment variables override any YAML value:
#   VIL_SERVER_PORT=9090
#   VIL_LOG_LEVEL=debug
#   VIL_SHM_CAPACITY_MB=256
#   ... (see each section for VIL_* env var names)

# ── Profile ──────────────────────────────────────────────────────────
# dev:     debug logging, 8MB SHM, small buffers, admin enabled
# staging: info+json logging, 64MB SHM, rate limits on
# prod:    warn+json logging, 256MB SHM, large buffers, admin disabled
profile: dev  # VIL_PROFILE

# ── Server ───────────────────────────────────────────────────────────
server:
  name: vil-server
  port: 8080                        # VIL_SERVER_PORT
  host: "0.0.0.0"                   # VIL_SERVER_HOST
  workers: 0                        # VIL_WORKERS (0 = num_cpus)
  metrics_port: null                # VIL_METRICS_PORT (null = same as main)
  max_body_size: "10MB"
  request_timeout_secs: 30          # VIL_REQUEST_TIMEOUT
  graceful_shutdown_timeout_secs: 30

# ── Logging ──────────────────────────────────────────────────────────
logging:
  level: info                       # VIL_LOG_LEVEL
  format: text                      # VIL_LOG_FORMAT (text | json)
  modules: {}                       # Per-module overrides: { "vil_server_core": "debug" }

# ── SHM (Shared Memory) ─────────────────────────────────────────────
# ExchangeHeap pool for zero-copy HTTP I/O.
# P99 tuning: check_interval controls amortized reset frequency.
shm:
  enabled: true
  pool_size: "64MB"                 # VIL_SHM_POOL_SIZE
  reset_threshold_pct: 85           # VIL_SHM_RESET_PCT (reset when util > N%)
  check_interval: 256               # VIL_SHM_CHECK_INTERVAL (check every N allocs)
  query_cache:
    enabled: true
    region_size: "32MB"
    default_ttl_secs: 60
    max_entries: 10000

# ── Mesh (Tri-Lane) ─────────────────────────────────────────────────
# Trigger/Data/Control lane configuration for inter-service messaging.
mesh:
  mode: unified                     # unified | distributed
  channels:
    trigger:
      buffer_size: 1024
      shm_region_size: "4MB"
    data:
      buffer_size: 1024
      shm_region_size: "16MB"
    control:
      buffer_size: 256
      shm_region_size: "1MB"
  discovery:
    mode: shm                       # shm | dns | consul
  routes: []
  # routes:
  #   - from: order-svc
  #     to: payment-svc
  #     lane: data

# ── Pipeline ─────────────────────────────────────────────────────────
# SDK Pipeline runtime settings (ShmToken/GenericToken processing).
pipeline:
  queue_capacity: 1024              # VIL_PIPELINE_QUEUE_CAPACITY
  session_timeout_secs: 300         # VIL_PIPELINE_SESSION_TIMEOUT
  max_concurrent: 64

# ── Database ─────────────────────────────────────────────────────────
database:
  postgres:
    url: "postgres://vil:vil@localhost:5432/vil"  # VIL_DATABASE_URL
    max_connections: 10             # VIL_DATABASE_MAX_CONNECTIONS
    min_connections: 1
    connect_timeout_secs: 5
    idle_timeout_secs: 300
    max_lifetime_secs: 1800
  redis:
    url: "redis://localhost:6380"   # VIL_REDIS_URL
    pool_size: 4

# ── Message Queues ───────────────────────────────────────────────────
mq:
  nats:
    url: "nats://localhost:4222"    # VIL_NATS_URL
    max_reconnects: 60
  kafka:
    brokers: "localhost:9092"       # VIL_KAFKA_BROKERS
    group_id: vil-default
  mqtt:
    host: localhost                 # VIL_MQTT_HOST
    port: 1883                      # VIL_MQTT_PORT
    client_id: vil-client
    keep_alive_secs: 30

# ── Services ─────────────────────────────────────────────────────────
services: []
# services:
#   - name: order-svc
#     visibility: public
#     prefix: /api/orders

# ── Middleware ───────────────────────────────────────────────────────
middleware:
  request_tracker:
    enabled: true
  handler_metrics:
    enabled: true
    sample_rate: 1
  tracing:
    enabled: true
    sample_rate: 1
    propagation: w3c
  cors:
    enabled: true
    mode: permissive               # permissive | strict
  compression:
    enabled: false                 # prod profile enables this
    min_body_size: 256
  timeout:
    enabled: true
    duration_secs: 30
  security_headers:
    enabled: true
  hsts:
    enabled: false                 # prod profile enables this
    max_age_secs: 31536000
    include_subdomains: true

# ── Security ─────────────────────────────────────────────────────────
security:
  jwt:
    enabled: false
    secret: ""                     # Use env: VIL_JWT_SECRET
    algorithm: HS256
    optional: false
  rate_limit:
    enabled: false                 # staging/prod profiles enable this
    max_requests: 1000
    window_secs: 60
    per: ip                        # ip | api_key
  csrf:
    enabled: false
    cookie_name: vil-csrf-token
    exempt_paths: []
  brute_force:
    enabled: false
    max_attempts: 5
    block_duration_secs: 300

# ── Session ──────────────────────────────────────────────────────────
session:
  enabled: false
  cookie_name: vil-session
  ttl_secs: 1800
  http_only: true
  secure: false                    # prod profile sets true
  same_site: Lax                   # prod profile sets Strict

# ── Observability ────────────────────────────────────────────────────
observability:
  error_tracker:
    enabled: true
    max_recent: 1000
  span_collector:
    max_spans: 10000
  profiler:
    enabled: true

# ── Performance ──────────────────────────────────────────────────────
performance:
  metrics_sample_rate: 1           # 1 = every request, 10 = 1 in 10
  trace_sample_rate: 1
  idempotency:
    enabled: false
    ttl_secs: 86400
    max_entries: 10000

# ── gRPC ─────────────────────────────────────────────────────────────
grpc:
  enabled: false
  port: 50051
  max_message_size: "4MB"
  health_check: true
  reflection: true
  max_concurrent_streams: 200

# ── GraphQL ──────────────────────────────────────────────────────────
graphql:
  enabled: false
  playground: true
  max_depth: 10
  max_complexity: 1000
  introspection: true
  default_page_size: 20
  max_page_size: 100

# ── Feature Flags ────────────────────────────────────────────────────
feature_flags:
  flags: {}
  file: null

# ── Scheduler ────────────────────────────────────────────────────────
scheduler:
  jobs: []
  # jobs:
  #   - name: cleanup-expired
  #     every_secs: 3600

# ── Plugins ──────────────────────────────────────────────────────────
plugins:
  directory: "~/.vil/plugins"
  encryption_key: "~/.vil/secrets/encryption.key"
  active: []

# ── Rolling Restart ──────────────────────────────────────────────────
rolling_restart:
  drain_timeout_secs: 30

# ── Admin ────────────────────────────────────────────────────────────
admin:
  playground: true                 # prod profile disables this
  diagnostics: true
  hot_reload: true
  plugin_gui: true