Python File Renaming Automation Script

I need a clean, well-documented Python script that automates file management, with the core focus on renaming files in bulk. The goal is to streamline a repetitive workflow where files arrive in a watch folder and must be renamed according to specific patterns (e.g., prepend timestamp, replace spaces with underscores, or map current names to a CSV of target names).

Key details:
• The script should accept arguments from the command line (source folder, naming rule, optional destination).
• Cross-platform compatibility is important, so please stick to standard libraries such as os, pathlib, re, argparse, and, if useful, shutil.
• Clear error handling is a must—skip or log collisions, unreadable files, and permission issues without crashing the run.
• I’d like concise inline comments plus a short README explaining usage, parameters, and at least one sample run.

Delivery: the .py file, README, and a quick demo (screen recording or screenshots) showing the rename routine in action.

If you have questions about the naming logic or edge cases, let me know early so we can lock it down and keep the process smooth.