env.example

# Copy this file to .env and fill in the values for your environment.
# See `just load-env` to automatically copy this file to .env.
#
# This file is committed to version control so contributors can see what
# environment variables are required.
#
# Note: This file is named env.example (not .env.example) because Copier
# excludes .env* files as a safety feature to prevent accidental commits
# of real environment files.

# ===========================================================================
# Structured logging (structlog) — {{ package_name }}.common.logging_manager
# ===========================================================================
#
# These are read by configure_logging() and _detect_context(). Sensible defaults
# apply when unset; set them explicitly to document intent for your team / CI.

# Execution mode: "human" (colourful console) or "llm" (compact JSON, llm-tagged events).
# EXECUTION_CONTEXT=human

# Console log level in human mode (DEBUG, INFO, WARNING, ERROR, CRITICAL).
# HUMAN_LOG_LEVEL=INFO

# Minimum level for llm=True events in LLM mode (DEBUG adds verbose agent trace; WARNING is default).
# LLM_LOG_LEVEL=WARNING

# Optional: Claude / Anthropic API usage without HUMAN_DEV=1 is treated as LLM execution context.
# ANTHROPIC_API_KEY=

# Set to 1 to force human mode even when ANTHROPIC_API_KEY is present (local dev beside agent tools).
# HUMAN_DEV=

# ===========================================================================
# Application Configuration
# ===========================================================================

# Enable debug mode for development
# DEBUG=false

# ===========================================================================
# Database (if needed)
# ===========================================================================

# Database connection URL (PostgreSQL, MySQL, SQLite, etc.)
# Uncomment and set if your project uses a database.
# DATABASE_URL=postgresql://user:password@localhost:5432/{{ package_name }}  # pragma: allowlist secret
# ===========================================================================
# API Keys & Secrets (if needed)
# ===========================================================================

# Secret key for sessions, JWT signing, etc.
# Uncomment if your project requires a secret key.
# SECRET_KEY=your-secret-key-here

# External API keys (OpenAI, Stripe, AWS, etc.)
# Uncomment and fill in if your project calls external services.
# API_KEY=your-api-key-here

# ===========================================================================
# Third-party Services (if needed)
# ===========================================================================

# Example: Sentry error tracking
# SENTRY_DSN=https://key@sentry.io/project-id

# Example: Email configuration
# EMAIL_HOST=smtp.example.com
# EMAIL_PORT=587
# EMAIL_USER=your-email@example.com
# EMAIL_PASSWORD=your-password