.env.example

# =============================================================================
# Logger Configuration
# =============================================================================

# Output format for logs
# - 'human': Colored, formatted output with emojis (default for development)
# - 'json': Machine-readable JSON output (for CI/CD or Claude integration)
LOG_FORMAT=human

# Minimum log level to display
# - 'debug': Show all logs (verbose, useful for debugging)
# - 'info': Show info, warn, error (default, recommended for development)
# - 'warn': Show warn, error only (production)
# - 'error': Show only errors (critical issues only)
LOG_LEVEL=info

# Include timestamps in log output
# Set to 'false' to disable timestamps (cleaner output, but less traceable)
LOG_TIMESTAMPS=true

# Include emoji indicators in log output
# Only applies to 'human' format. Set to 'false' for cleaner terminal output
LOG_EMOJI=true

# =============================================================================
# File Watcher Configuration
# =============================================================================

# Debounce delay for file watcher (milliseconds)
# Prevents multiple rapid regenerations when saving multiple YAML files
# - Set to 300 (default): Wait 300ms after last change before regenerating
# - Set to 0: Process every change immediately (disables debouncing)
# - Increase to 500-1000: Useful if you frequently save many files at once
FILE_WATCH_DEBOUNCE_MS=300

# Compact logging mode for tailor-server
# Reduces log output to minimal essential information
# - Set to 'false' (default): Show all detailed logs (recommended for development)
# - Set to 'true': Show only startup message and regeneration results
#   Compact mode output example:
#     🚀 Tailor server ready • Watching: tech-corp • Debounce: 300ms
#     ✅ metadata.yaml → Regenerated (1.2s)
#     ❌ resume.yaml → Failed (validation error details shown)
TAILOR_SERVER_COMPACT_LOGS=true

# =============================================================================
# Usage Examples
# =============================================================================
#
# Development (human-friendly):
#   LOG_FORMAT=human LOG_LEVEL=info bun run tailor-server
#
# Debugging (verbose):
#   LOG_LEVEL=debug bun run generate-data
#
# Claude/Automation (JSON output):
#   LOG_FORMAT=json bun run set-env -C company-name
#
# Production (JSON, warnings only):
#   LOG_FORMAT=json LOG_LEVEL=warn bun run start
#
# Disable file watcher debouncing:
#   FILE_WATCH_DEBOUNCE_MS=0 bun run tailor-server
#
# Increase debounce for batch edits:
#   FILE_WATCH_DEBOUNCE_MS=1000 bun run tailor-server
#
# Compact mode (minimal logging):
#   TAILOR_SERVER_COMPACT_LOGS=true bun run tailor-server
#
# =============================================================================