chore: sync all changes to Gitea

- Config, docs, scripts, and backup manifests
- Submodule refs unchanged (m = modified content in submodules)

Made-with: Cursor

scripts/verify/run-shellcheck.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # Run shellcheck on verification scripts (optional — requires shellcheck to be installed).
 # Usage: bash scripts/verify/run-shellcheck.sh [--optional]
-#   --optional: exit 0 if shellcheck not installed (for CI where shellcheck is optional).
+#   --optional: exit 0 if shellcheck not installed; and do not fail the run on findings (report only).
 # Install: apt install shellcheck  (or brew install shellcheck)
 
 set -euo pipefail
@@ -17,5 +17,10 @@ if ! command -v shellcheck &>/dev/null; then
 fi
 
 echo "Running shellcheck on scripts/verify/*.sh..."
+if [[ "$OPTIONAL" == true ]]; then
+  shellcheck -x ./*.sh || true
+  echo "Done (optional: exit 0)."
+  exit 0
+fi
 shellcheck -x ./*.sh
 echo "Done."