Breehavior-Monitor/CLAUDE.md

Breehavior Monitor

Discord bot for monitoring chat toxicity, topic drift, coherence, and game channel routing. Runs as a Docker container on barge.lan.

Deployment

Production runs at barge.lan:/mnt/docker/breehavior-monitor/.

The Docker image is hosted on the Gitea registry at git.thecozycat.net/aj/breehavior-monitor:latest. The config.yaml is volume-mounted (not baked into the image).

Steps

1. Push code to Gitea (origin):

   git push origin master
   

2. Build and push the Docker image:

   docker build -t git.thecozycat.net/aj/breehavior-monitor:latest .
   docker push git.thecozycat.net/aj/breehavior-monitor:latest
   

3. Copy config.yaml to barge (it's volume-mounted, not in the image):

   scp config.yaml aj@barge.lan:/mnt/docker/breehavior-monitor/config.yaml
   

4. Pull and restart on barge:

   ssh aj@barge.lan "cd /mnt/docker/breehavior-monitor && docker compose pull && docker compose up -d"
   

5. Verify the bot started:

   ssh aj@barge.lan "docker logs bcs-bot --tail 10"
   

Config-only changes

If only config.yaml changed (no code changes), skip steps 1-2 and just do steps 3-4. The config is mounted as a volume so a container restart picks it up.

Architecture

• LLM backend: llama.cpp on athena.lan:11434 (text mode must be active)
• Database: MSSQL Express in a separate container (bcs-mssql) on barge — only used for local dev. Production DB is already running on barge.
• Prompts: prompts/*.txt — loaded at import time, so code changes require a container rebuild