Add roll script for updating 3rd-party layer revisions

1 files changed, 34 insertions, 0 deletions

diff --git a/.git.automation/README.md b/.git.automation/README.md
new file mode 100644
index 0000000..038ca48
--- /dev/null
+++ b/.git.automation/README.md
@@ -0,0 +1,34 @@
+# Automation
+## Roll
+Use the [roll.py](roll.py) script to update 3rd-party layers to their latest revisions in the working tree.
+
+### Check types
+```bash
+uvx --with-requirements roll.py ty check roll.py
+```
+
+### Lint
+```bash
+uvx ruff check --fix roll.py
+```
+
+### Format
+```bash
+uvx ruff format roll.py
+```
+
+### Run
+Run with no output.
+```bash
+uv run roll.py
+```
+
+Run with info output.
+```bash
+uv run roll.py --level INFO
+```
+
+Run with debug output.
+```bash
+uv run roll.py --level DEBUG
+```