feat: add dev script update-docs.sh

dev-scripts/update-docs.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+script_dir="$(dirname "${BASH_SOURCE[0]}")"
+cd "$script_dir/.." || exit
+
+PYTHON=".venv/bin/python"
+
+if ! command -v $PYTHON &> /dev/null; then
+  echo "Python virtual environment not found. See Makefile for setup instructions."
+  exit 1
+fi
+
+updated_readme=$($PYTHON generate-docs.py README.md)
+
+if [ "$updated_readme" = "" ]; then
+  echo "Updated README is empty, will not overwrite."
+  exit 1
+fi
+
+echo "$updated_readme" > README.md
+git diff README.md