add script to update Nix release branches

default.nix

@@ -140,6 +140,7 @@ let
         python ${pkgs.writeText "live.py" script}
       '';
     };
+  update-nix-releases = pkgs.callPackage ./nix/update-nix-releases.nix { };
 in
 {
   # build with `nix-build -A build`
@@ -149,6 +150,7 @@ in
     inputsFrom = [ nix-dev ];
     packages = [
       devmode
+      update-nix-releases
       pkgs.niv
       pkgs.python310.pkgs.black
       pkgs.vale

nix/update-nix-releases.nix

@@ -0,0 +1,39 @@
+{ writeShellApplication
+, git
+, gnused
+, niv
+, nix
+, ripgrep
+, coreutils
+}:
+# add or update Nix releases using `niv` in the current directory.
+# this will clone the entire Git repository of Nix.
+writeShellApplication {
+  name = "update-nix-releases";
+  runtimeInputs = [ git gnused niv nix ripgrep ];
+  text = ''
+    tmp=$(mktemp -d)
+    trap 'rm -rf "$tmp"' EXIT
+
+    git clone https://github.com/nixos/nix "$tmp"
+
+    pushd "$tmp" > /dev/null
+    git branch -r | rg 'origin/\d\.\d*-maintenance' | sed 's|.*origin/\(.*\)|\1|' > releases.txt
+
+    while IFS= read -r release; do
+      git checkout "$release"
+      # very old versions don't have a `default.nix`
+      if [ ! -f default.nix ]; then continue; fi
+      doc=$(nix-store --query "$(nix-instantiate -A default)" | rg doc)
+      # only use cached builds, to avoid building Nix locally
+      if nix-store --query --size "$doc" --store https://cache.nixos.org > /dev/null 2>&1; then
+        popd > /dev/null
+        if niv show "$release" > /dev/null 2>&1; then
+          niv drop "nix_''${release%-maintenance}"
+        fi
+        niv add nixos/nix -n "nix_''${release%-maintenance}" -b "$release"
+        pushd "$tmp" > /dev/null
+      fi
+    done < releases.txt
+  '';
+}