initial: NAS agent runner setup

This commit is contained in:
Janpeter Visser 2026-05-02 15:43:59 +02:00
commit 9d8a7fe237
16 changed files with 1121 additions and 0 deletions

75
.env.example Normal file
View file

@ -0,0 +1,75 @@
# ============================================================
# scrum4me-agent-runner — environment configuratie
# ============================================================
# Kopieer naar .env en vul in. Houd .env buiten git (zie .gitignore).
# Permissies: chmod 600 .env
# ----- Claude Code authenticatie ----------------------------
# Genereer op je werkstation met: `claude setup-token`
# Output is een sk-ant-oat01-... token; geldig 1 jaar; gebruikt
# je Pro/Max subscription quota in plaats van per-token billing.
#
# Alternatief: ANTHROPIC_API_KEY (sk-ant-api03-...) voor pay-per-use
# via console.anthropic.com. Niet beide tegelijk zetten.
CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-vervang-mij
# ANTHROPIC_API_KEY=
# ----- Scrum4Me API token -----------------------------------
# Bearer-token van de DEDICATED agent-user (niet je persoonlijke
# account). Aanmaken: log in als de agent-user → /settings/tokens
# → label "NAS-runner". Token wordt eenmalig getoond.
#
# Als deze ge-revoked wordt: rebuild + redeploy (zie README).
SCRUM4ME_TOKEN=vervang-mij
# ----- Scrum4Me database ------------------------------------
# Beide URLs uit het Neon-dashboard. DATABASE_URL is pooled,
# DIRECT_URL is unpooled — scrum4me-mcp gebruikt DATABASE_URL
# voor reads/writes; DIRECT_URL is alleen nodig als je de mcp
# uitbreidt met LISTEN/NOTIFY (op dit moment niet).
DATABASE_URL=postgresql://user:pass@host/dbname?sslmode=require
DIRECT_URL=postgresql://user:pass@host/dbname?sslmode=require
# ----- Scrum4Me API host ------------------------------------
# Voor token-validatie via /api/health en /api/products
# voorafgaand aan het starten van de daemon-loop. Gebruik je
# productie-URL.
SCRUM4ME_BASE_URL=https://scrum4me.example.com
# ----- Scrum4Me MCP versie ----------------------------------
# Pin een specifieke commit-sha of tag van scrum4me-mcp.
# `main` werkt voor ontwikkeling; in productie altijd vastpinnen.
MCP_GIT_REF=main
# Idem voor Claude Code zelf. `latest` of een specifieke versie.
CLAUDE_CODE_VERSION=latest
# ----- NAS paths --------------------------------------------
# Basis-share waaronder cache/, logs/ en state/ vallen.
# Pas aan als je een andere share-naam gebruikt op QNAP.
NAS_BASE=/share/Agent
# UID/GID matchen met de share-eigenaar op QNAP (admin = 1000
# bij standaard QTS-installatie).
AGENT_UID=1000
AGENT_GID=1000
# ----- Health endpoint --------------------------------------
# Externe poort op de NAS waarop /health bereikbaar is.
# Wijzig als 8080 al in gebruik is door iets anders op QTS.
AGENT_HEALTH_PORT_HOST=8080
# ----- Daemon-loop tuning -----------------------------------
# Maximum opeenvolgende mislukte batches voordat de container
# zichzelf "unhealthy" markeert.
AGENT_MAX_FAILURES=5
# Backoff in seconden: start, factor, max
AGENT_BACKOFF_START=5
AGENT_BACKOFF_FACTOR=2
AGENT_BACKOFF_MAX=300
# Hoeveel uur logs bewaren voor we comprimeren (gzip).
AGENT_LOG_GZIP_AFTER_HOURS=24
# Hoeveel dagen ge-gzipte logs bewaren voor we ze verwijderen.
AGENT_LOG_DELETE_AFTER_DAYS=30