Update checkout-latest-filament

Author: danharrin

docs/bin/checkout-latest-filament

@@ -8,11 +8,26 @@ DOCS_VERSIONS=(
 )
 
 for v in "${DOCS_VERSIONS[@]}"; do
+    major="${v%%.*}"   # 1, 2, 3, 4
+
     if [ -d "filament/$v" ]; then
-        echo "Pulling latest documentation updates for $v..."
-        (cd filament/$v && git pull)
+        echo "Updating $v..."
+        (cd filament/$v && git fetch --tags origin)
     else
         echo "Cloning $v..."
-        git clone --single-branch --branch "$v" [email protected]:filamentphp/filament.git "filament/$v"
-    fi;
+        git clone --no-checkout [email protected]:filamentphp/filament.git "filament/$v"
+        (cd filament/$v && git fetch --tags origin)
+    fi
+
+    latest_tag=$(git -C filament/$v tag -l "v${major}.*" --sort=-v:refname \
+        | grep -E '^[^ -]+$' \
+        | head -n1)
+
+    if [ -z "$latest_tag" ]; then
+        echo "No stable tag found for $v"
+        continue
+    fi
+
+    echo "Checking out $latest_tag for $v..."
+    (cd filament/$v && git checkout -f "$latest_tag")
 done