chore: enrich/update .env.example

Author: Chemaclass

.env.example

@@ -1,13 +1,60 @@
-BASHUNIT_DEFAULT_PATH=
-BASHUNIT_DEV_LOG=
-BASHUNIT_BOOTSTRAP=
-BASHUNIT_LOG_JUNIT=
-BASHUNIT_REPORT_HTML=
-
-# Booleans
-BASHUNIT_PARALLEL_RUN=
-BASHUNIT_SHOW_HEADER=
-BASHUNIT_HEADER_ASCII_ART=
-BASHUNIT_SIMPLE_OUTPUT=
-BASHUNIT_STOP_ON_FAILURE=
-BASHUNIT_SHOW_EXECUTION_TIME=
+################################################################################
+# bashunit Configuration
+# Copy this file to .env and customize as needed
+# All values shown are defaults (leave empty to use default)
+################################################################################
+
+#───────────────────────────────────────────────────────────────────────────────
+# Test Discovery
+#───────────────────────────────────────────────────────────────────────────────
+BASHUNIT_DEFAULT_PATH=           # Default: tests
+BASHUNIT_BOOTSTRAP=              # Default: tests/bootstrap.sh
+BASHUNIT_BOOTSTRAP_ARGS=         # Arguments passed to bootstrap script
+
+#───────────────────────────────────────────────────────────────────────────────
+# Output Display
+#───────────────────────────────────────────────────────────────────────────────
+BASHUNIT_SHOW_HEADER=            # Default: true
+BASHUNIT_HEADER_ASCII_ART=       # Default: false
+BASHUNIT_SIMPLE_OUTPUT=          # Default: false (use dots instead of test names)
+BASHUNIT_VERBOSE=                # Default: false (show environment variables)
+BASHUNIT_NO_OUTPUT=              # Default: false (suppress all output)
+BASHUNIT_SHOW_EXECUTION_TIME=    # Default: true
+BASHUNIT_SHOW_SKIPPED=           # Default: false (show skipped test details)
+BASHUNIT_SHOW_INCOMPLETE=        # Default: false (show incomplete test details)
+BASHUNIT_FAILURES_ONLY=          # Default: false (only show failures)
+BASHUNIT_NO_COLOR=               # Default: false (disable colors)
+
+#───────────────────────────────────────────────────────────────────────────────
+# Test Execution
+#───────────────────────────────────────────────────────────────────────────────
+BASHUNIT_PARALLEL_RUN=           # Default: false
+BASHUNIT_STOP_ON_FAILURE=        # Default: false (stop suite on first failure)
+BASHUNIT_STOP_ON_ASSERTION_FAILURE= # Default: true (stop test on first assertion fail)
+BASHUNIT_STRICT_MODE=            # Default: false (enable set -euo pipefail)
+BASHUNIT_LOGIN_SHELL=            # Default: false (source login shell profiles)
+
+#───────────────────────────────────────────────────────────────────────────────
+# Reports
+#───────────────────────────────────────────────────────────────────────────────
+BASHUNIT_LOG_JUNIT=              # JUnit XML report path (e.g., report.xml)
+BASHUNIT_REPORT_HTML=            # HTML test report path (e.g., report.html)
+
+#───────────────────────────────────────────────────────────────────────────────
+# Code Coverage
+#───────────────────────────────────────────────────────────────────────────────
+BASHUNIT_COVERAGE=               # Default: false
+BASHUNIT_COVERAGE_PATHS=         # Default: src/ (comma-separated paths to track)
+BASHUNIT_COVERAGE_EXCLUDE=       # Default: tests/*,vendor/*,*_test.sh,*Test.sh
+BASHUNIT_COVERAGE_REPORT=        # Default: coverage/lcov.info
+BASHUNIT_COVERAGE_REPORT_HTML=   # HTML coverage report directory (e.g., coverage/html)
+BASHUNIT_COVERAGE_MIN=           # Minimum coverage % (fails if below)
+BASHUNIT_COVERAGE_THRESHOLD_LOW= # Default: 50 (red below this)
+BASHUNIT_COVERAGE_THRESHOLD_HIGH=# Default: 80 (green above this)
+
+#───────────────────────────────────────────────────────────────────────────────
+# Advanced / Debug
+#───────────────────────────────────────────────────────────────────────────────
+BASHUNIT_DEV_LOG=                # Developer log file path
+BASHUNIT_BENCH_MODE=             # Default: false (benchmark mode)
+BASHUNIT_INTERNAL_LOG=           # Default: false (internal debug logging)