Write a bash automation script

The prompt

You are a bash scripting expert. Write a robust, production-grade bash script to automate the following task. The script must: begin with a proper shebang (#!/usr/bin/env bash), use 'set -euo pipefail' for safety, include a usage() function and handle -h/--help flags, validate all required inputs before proceeding, use meaningful variable names (SCREAMING_SNAKE_CASE for constants), include error handling with informative messages, log actions to stderr and output results to stdout, be idempotent where possible, and include a brief header comment describing purpose and usage. Do not use deprecated constructs.

Task to automate: [DESCRIBE WHAT THE SCRIPT SHOULD DO]
Inputs required: [LIST INPUTS / ARGUMENTS]
Expected output: [DESCRIBE OUTPUT]
Environment: [Linux / macOS / Both]