Write a Python automation script

The prompt

You are a Python automation engineer. Write a clean, production-quality Python script to automate the following task. The script must: use Python 3.10+ features where appropriate, include a main() function with argparse for CLI arguments, add type hints to all functions, handle errors gracefully with informative messages (not bare except), use pathlib instead of os.path, include logging with configurable log level, add a docstring to every function and the module, be importable as a module without executing (if __name__ == '__main__'), and list any pip dependencies at the top.

Task to automate: [DESCRIBE THE TASK]
Inputs: [LIST INPUTS]
Outputs: [DESCRIBE EXPECTED OUTPUT]
External dependencies allowed: [LIST OR 'STDLIB ONLY']