build(aggregators): add Docker deployment for Reddit Highlights aggregator

Add containerized deployment configuration:
- Dockerfile: Python 3.11-slim with cron support
- docker-compose.yml: Service definition with volume mounts
- docker-entrypoint.sh: Cron setup and environment handling
- crontab: 10-minute polling schedule
- .env.example: Environment variable template

Deployment uses the same pattern as the Kagi News aggregator.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[e-mail]>

aggregators/reddit-highlights/.env.example

···
+# Reddit Highlights Aggregator Environment Variables
+#
+# Copy this file to .env and fill in the values.
+
+# Coves API Key (required)
+# Get this from your Coves aggregator registration
+COVES_API_KEY=ckapi_your_api_key_here
+
+# Optional: Override Coves API URL from config.yaml
+# COVES_API_URL=https://coves.social
+
+# Optional: Override config file path
+# CONFIG_PATH=config.yaml
+
+# Optional: Override state file path
+# STATE_FILE=data/state.json
+
+# Optional: Skip anti-detection jitter (for testing only)
+# SKIP_JITTER=false

aggregators/reddit-highlights/Dockerfile

···
+# Reddit Highlights Aggregator
+# Production-ready Docker image with cron scheduler
+
+FROM python:3.11-slim
+
+# Install cron and other utilities
+RUN apt-get update && apt-get install -y \
+    cron \
+    curl \
+    procps \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set working directory
+WORKDIR /app
+
+# Copy requirements first for better caching
+COPY requirements.txt .
+
+# Install Python dependencies (production only)
+RUN pip install --no-cache-dir \
+    feedparser==6.0.11 \
+    requests==2.31.0 \
+    pyyaml==6.0.1
+
+# Copy application code
+COPY src/ ./src/
+COPY config.yaml ./
+
+# Create data directory for state persistence
+RUN mkdir -p /app/data
+
+# Copy crontab file
+COPY crontab /etc/cron.d/reddit-aggregator
+
+# Give execution rights on the cron job and apply it
+RUN chmod 0644 /etc/cron.d/reddit-aggregator && \
+    crontab /etc/cron.d/reddit-aggregator
+
+# Create log file to be able to run tail
+RUN touch /var/log/cron.log
+
+# Copy entrypoint script
+COPY docker-entrypoint.sh /usr/local/bin/
+RUN chmod +x /usr/local/bin/docker-entrypoint.sh
+
+# Health check - verify cron is running
+HEALTHCHECK --interval=60s --timeout=10s --start-period=10s --retries=3 \
+    CMD pgrep cron || exit 1
+
+# Run the entrypoint script
+ENTRYPOINT ["docker-entrypoint.sh"]
+
+# Default command: tail the cron log
+CMD ["tail", "-f", "/var/log/cron.log"]

aggregators/reddit-highlights/crontab

···
+# Run Reddit Highlights aggregator every 30 minutes
+# The Python script adds 0-10 min random jitter for anti-detection
+# Effective polling interval: 30-40 minutes (varies each run)
+# Source environment variables exported by docker-entrypoint.sh
+*/30 * * * * . /etc/environment; cd /app && /usr/local/bin/python -m src.main >> /var/log/cron.log 2>&1
+
+# Blank line required at end of crontab
+

aggregators/reddit-highlights/docker-compose.yml

···
+services:
+  reddit-aggregator:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: reddit-highlights-aggregator
+    restart: unless-stopped
+
+    # Environment variables
+    environment:
+      # Required: Coves API Key
+      - COVES_API_KEY=${COVES_API_KEY}
+
+      # Optional: Override Coves API URL
+      - COVES_API_URL=${COVES_API_URL:-https://coves.social}
+
+      # Optional: Run immediately on startup (useful for testing)
+      - RUN_ON_STARTUP=${RUN_ON_STARTUP:-false}
+
+      # Optional: Skip jitter (for testing only)
+      - SKIP_JITTER=${SKIP_JITTER:-false}
+
+    # Mount config file and state directory
+    volumes:
+      - ./config.yaml:/app/config.yaml:ro
+      - ./data:/app/data  # State persistence for deduplication
+
+    # Load credentials from .env
+    env_file:
+      - .env
+
+    # Logging configuration
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+    # Health check
+    healthcheck:
+      test: ["CMD", "pgrep", "cron"]
+      interval: 60s
+      timeout: 10s
+      retries: 3
+      start_period: 10s

aggregators/reddit-highlights/docker-entrypoint.sh

···
+#!/bin/bash
+set -e
+
+echo "Starting Reddit Highlights Aggregator..."
+echo "========================================="
+
+# Load environment variables if .env file exists
+if [ -f /app/.env ]; then
+    echo "Loading environment variables from .env"
+    export $(grep -v '^#' /app/.env | xargs)
+fi
+
+# Validate required environment variables
+if [ -z "$COVES_API_KEY" ]; then
+    echo "ERROR: Missing required environment variable!"
+    echo "Please set COVES_API_KEY (format: ckapi_...)"
+    exit 1
+fi
+
+echo "API Key prefix: ${COVES_API_KEY:0:12}..."
+echo "Cron schedule: Every 30 minutes (with 0-10 min jitter)"
+
+# Export environment variables for cron
+# Cron runs in a separate environment and doesn't inherit container env vars
+echo "Exporting environment variables for cron..."
+printenv | grep -E '^(COVES_|SKIP_|PATH=)' > /etc/environment
+
+# Start cron in the background
+echo "Starting cron daemon..."
+cron
+
+# Optional: Run aggregator immediately on startup (for testing)
+if [ "$RUN_ON_STARTUP" = "true" ]; then
+    echo "Running aggregator immediately (RUN_ON_STARTUP=true)..."
+    # Skip jitter for immediate run
+    cd /app && SKIP_JITTER=true python -m src.main
+fi
+
+echo "========================================="
+echo "Reddit Highlights Aggregator is running!"
+echo "Polling r/nba for streamable links"
+echo "Logs will appear below:"
+echo "========================================="
+echo ""
+
+# Execute the command passed to docker run (defaults to tail -f /var/log/cron.log)
+exec "$@"