env vars

.env.test.example

@@ -1,10 +1,28 @@
-# Test Environment Configuration
-# Copy this file to .env.test and adjust values as needed
+# Test Environment Configuration (automation stack)
+# Copy this file to `.env.test` and adjust values as needed.
+#
+# Scope:
+# - This file is for the hosted-session automation stack (companion/automation).
+# - It is NOT used by the Website ↔ API Docker smoke stack (that stack is driven by env vars in
+#   [`docker-compose.test.yml`](docker-compose.test.yml:1) and scripts in [`package.json`](package.json:92)).
+#
+# Note on legacy config:
+# - `AUTOMATION_MODE` is deprecated in favor of `NODE_ENV` mapping in [`getAutomationMode()`](adapters/automation/config/AutomationConfig.ts:104).
+# - Keep `AUTOMATION_MODE` only if you need to force legacy behavior.
 
-# Use mock adapter for testing (no real browser automation)
+# Prefer this:
+NODE_ENV=test
+
+# Optional legacy override (deprecated): `dev` | `mock` | `production`
 AUTOMATION_MODE=mock
 
-# Test timeouts (can be shorter for faster tests)
+# Shared automation settings
 AUTOMATION_TIMEOUT=5000
 RETRY_ATTEMPTS=1
-SCREENSHOT_ON_ERROR=false
+SCREENSHOT_ON_ERROR=false
+
+# Logging (automation/adapters)
+# LOG_LEVEL=warn
+# LOG_FILE_PATH=./logs/gridpilot
+# LOG_MAX_FILES=7
+# LOG_MAX_SIZE=10m