Fixes post release 100 (#16)

* fix password issue

* implement wandb tool

* update doc

* force root on scripts

Author: eclipsevortex

README.md

@@ -32,6 +32,7 @@
 - [Introduction](#introduction)
 - [Prerequisites](#prerequisites)
 - [How It Works](#how-it-works)
+- [Quick Setup](#quick-setup)
 - [Quick Start](#quick-start)
 - [Quick Stop](#quick-stop)
 - [Quick Upgrade](#quick-upgrade)
@@ -42,6 +43,8 @@
   - [Miner](#installation-miner)
   - [Validator](#installation-validator)
   - [Other](#installation-other)
+- [Tools](#tools)
+  - [Wandb](#tool-wandb)
 - [Good to Know](#good-to-know)
 - [Troubleshooting](#troubleshooting)
 - [License](#license)
@@ -89,7 +92,7 @@ Here's a breakdown of the key variables:
   Set to `true` if you want the Auto Upgrader to apply both releases and pre-releases. Default is `false`.
 
 - **SUBVORTEX_EXECUTION_METHOD**:  
-  Defines how the neuron and its componentswill be installed by the Auto Upgrader. Options are `process`, `service`, or `container`. Default is `service`.
+  Defines how the neuron and its components will be installed by the Auto Upgrader. Options are `process`, `service`, or `container`. Default is `service`.
 
 - **SUBVORTEX_PRERELEASE_TYPE**:  
   Specifies a single prerelease identifier you want to be notified about. Options are `alpha` (**use ONLY in DEVNET**) or `rc` (**use ONLY in TESTNET**). Remove this variable to receive notifications from `latest` (**use in MAINNET**) prerelease types. Default is an empty string, which disables prerelease notifications.
@@ -120,7 +123,7 @@ Here's a breakdown of the key variables:
    - For miners, edit files matching `env.subvortex.miner.*`
    - For validators, edit files matching `env.subvortex.validator.*`
 
-3. Update the templates inside the `subvortex/auto_upgrader/template` folder.
+3. Update the templates inside the `subvortex/auto_upgrader/template` folder. Recommended to keep as it is.
 
 <br />
 
@@ -137,6 +140,9 @@ In these modes, the Auto Upgrader checks GitHub every **SUBVORTEX_CHECK_INTERVAL
 3. Updates the symlink to point to the new version
 4. Cleans up the previous version
 
+➡️ The execution directory for SubVortex will now be located under `$HOME/subvortex`, with each version in its own subdirectory and a symlink pointing to the current version.
+You no longer need to clone the SubVortex repository manually — and can safely remove any old local copies you previously cloned.
+
 🐳 Docker Mode
 
 Here, the Auto Upgrader also checks GitHub every **SUBVORTEX_CHECK_INTERVAL** seconds. When a new release is found:
@@ -167,6 +173,20 @@ Then, copy that token as value of `SUBVORTEX_GITHUB_TOKEN` in the main Auto Upgr
 
 <br />
 
+# 🚀 Quick Setup <a id="quick-setup"></a>
+
+To setup the Auto Upgrader in a quick way, you can run
+
+```bash
+./scripts/quick_setup.sh --neuron validator --release v3.0.1
+```
+
+It will download and unzip the newuon's assets of the SubVortex for the requested version.
+
+Use `-h` to see the options
+
+<br />
+
 # 🚀 Quick Start <a id="quick-start"></a>
 
 To install the Auto Upgrader in a quick way, you can run
@@ -264,6 +284,22 @@ For each of them, the same structure applies:
 
 <br />
 
+# Tools <a id="tools"></a>
+
+## Wandb <a id="tool-wandb"></a>
+
+To login to wandb, run
+
+```bash
+./scripts/wandb/wandb_login.sh --api-key <WANDB_API_KEY>
+```
+
+To force relogin to wandb, run
+
+```bash
+./scripts/wandb/wandb_login.sh --api-key <WANDB_API_KEY> --relogin
+```
+
 # 💡 Good to Know <a id="good-to-know"></a>
 
 After installing a version through the Auto Upgrader, you can directly run various management scripts for the Miner and/or Validator.

VERSION

@@ -1 +1 @@
-1.0.0
+1.0.1

scripts/cleaner/clean_workspace.sh

@@ -24,15 +24,34 @@ show_help() {
 }
 
 version_sort() {
-    if command -v sort >/dev/null && sort -V </dev/null &>/dev/null; then
-        sort -V
-    elif command -v gsort >/dev/null; then
-        gsort -V
-    else
-        echo "❌ Error: version sort (sort -V or gsort -V) not supported." >&2
-        echo "👉 On macOS: brew install coreutils" >&2
-        exit 1
-    fi
+  awk '
+  {
+    orig = $0
+    gsub(/^subvortex-/, "", orig)
+
+    base = orig
+    type = ""
+    val = 0
+    weight = 3
+
+    if (index(orig, "a") > 0) {
+      split(orig, parts, "a")
+      base = parts[1]
+      val = parts[2] + 0
+      weight = 1
+    } else if (index(orig, "rc") > 0) {
+      split(orig, parts, "rc")
+      base = parts[1]
+      val = parts[2] + 0
+      weight = 2
+    } else if (match(orig, /^[0-9]+\.[0-9]+\.[0-9]+$/)) {
+      base = orig
+      weight = 3
+    }
+
+    printf "%s-%d-%02d %s\n", base, weight, val, $0
+  }
+  ' | sort | awk '{print $2}'
 }
 
 OPTIONS="v:rdhf"
@@ -77,7 +96,10 @@ echo "🔍 Loading environment variables from .env..."
 export $(grep -v '^#' subvortex/auto_upgrader/.env | xargs)
 
 TARGET_BASE=${SUBVORTEX_WORKING_DIRECTORY:-/var/tmp/subvortex}
-SYMLINK_PATH="/root/subvortex"
+SYMLINK_PATH="$HOME/subvortex"
+
+echo "📁 Target base directory: $TARGET_BASE"
+echo "🔗 Symlink path: $SYMLINK_PATH"
 
 if [ ! -d "$TARGET_BASE" ]; then
     echo "❌ Directory '$TARGET_BASE' does not exist."
@@ -99,8 +121,11 @@ if [ "$FORCE_REINSTALL" = true ]; then
 fi
 
 cd "$TARGET_BASE"
+echo "🔍 Searching for directories in $TARGET_BASE..."
 all_dirs=($(find . -maxdepth 1 -mindepth 1 -type d -exec basename {} \;))
 
+echo "🔎 Found directories: ${all_dirs[*]}"
+
 versioned_dirs=()
 non_versioned_dirs=()
 
@@ -118,20 +143,33 @@ target_normalized=""
 
 if [ -n "$VERSION" ]; then
     target_normalized="subvortex-$(normalize_version "$VERSION")"
+    echo "🎯 Target version to remove: $target_normalized"
 else
     if [ ${#versioned_dirs[@]} -gt 0 ]; then
         latest_version=$(printf "%s\n" "${versioned_dirs[@]}" | version_sort | tail -n 1)
+        echo "🏷️ Latest version detected: $latest_version"
     fi
 fi
 
 # Get symlink target if it exists
+echo "🔗 Checking symlink at: $SYMLINK_PATH"
+
 symlink_target=""
-if [ -L "$SYMLINK_PATH" ]; then
-    symlink_target="$(readlink "$SYMLINK_PATH")"
-    symlink_target="$(basename "$symlink_target")"
+if [ -e "$SYMLINK_PATH" ] && [ -h "$SYMLINK_PATH" ]; then
+    resolved_target="$(readlink "$SYMLINK_PATH")"
+    echo "📌 Resolved symlink target: $resolved_target"
+
+    if [[ "$resolved_target" != /* ]]; then
+        resolved_target="$(cd "$(dirname "$SYMLINK_PATH")" && cd "$(dirname "$resolved_target")" && pwd)/$(basename "$resolved_target")"
+    fi
+
+    symlink_target="$(basename "$resolved_target")"
+    echo "🧭 Final resolved version dir: $symlink_target"
+else
+    echo "⚠️  No valid symlink found at $SYMLINK_PATH"
 fi
 
-echo "🧹 Cleaning up: $TARGET_BASE"
+echo "🧹 Starting cleanup in: $TARGET_BASE"
 
 for dir in "${all_dirs[@]}"; do
     keep=false
@@ -161,7 +199,12 @@ for dir in "${all_dirs[@]}"; do
         for nvd in "${non_versioned_dirs[@]}"; do
             [ "$dir" == "$nvd" ] && keep=true && break
         done
-        [ "$dir" == "$latest_version" ] && keep=true
+
+        if [ -n "$symlink_target" ]; then
+            [ "$dir" == "$symlink_target" ] && keep=true
+        else
+            [ "$dir" == "$latest_version" ] && keep=true
+        fi
     fi
 
     if [ "$keep" = true ]; then
@@ -183,4 +226,4 @@ for dir in "${all_dirs[@]}"; do
     fi
 done
 
-echo "✅ Cleanup workspace complete."
+echo "✅ Cleanup workspace complete."

scripts/miner/oneshot/miner_oneshot_installation.sh

@@ -2,6 +2,12 @@
 
 set -euo pipefail
 
+# Ensure script run as root
+if [[ "$EUID" -ne 0 ]]; then
+    echo "🛑 This script must be run as root. Re-running with sudo..."
+    exec sudo "$0" "$@"
+fi
+
 # 🧭 Navigate to project root
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 cd "$SCRIPT_DIR/../../.."
@@ -72,7 +78,7 @@ case "$val_mode" in
     1)
         read -rp "⚙️  Enter systemd service name: " val_svc
         echo "⛔ Stopping systemd service '$val_svc'..."
-        sudo systemctl stop "$val_svc" || echo "⚠️ Failed to stop systemd service"
+        systemctl stop "$val_svc" || echo "⚠️ Failed to stop systemd service"
     ;;
     2)
         read -rp "⚙️  Enter PM2 process name: " val_proc

scripts/miner/oneshot/miner_oneshot_teardown.sh

@@ -2,6 +2,12 @@
 
 set -euo pipefail
 
+# Ensure script run as root
+if [[ "$EUID" -ne 0 ]]; then
+    echo "🛑 This script must be run as root. Re-running with sudo..."
+    exec sudo "$0" "$@"
+fi
+
 # 🧭 Navigate to project root
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 cd "$SCRIPT_DIR/../../.."
@@ -94,7 +100,7 @@ case "$val_mode" in
     1)
         read -rp "⚙️  Enter systemd service name: " val_svc
         echo "🔼 Starting systemd service '$val_svc'..."
-        sudo systemctl start "$val_svc" || echo "⚠️ Failed to start systemd service"
+        systemctl start "$val_svc" || echo "⚠️ Failed to start systemd service"
     ;;
     2)
         read -rp "⚙️  Enter PM2 process name: " val_proc