plc-checkweigher 1.7.0 → 1.11.0

package/bin/cli.js

@@ -6,61 +6,185 @@ const { platform, arch } = require('os');
 const path = require('path');
 const fs   = require('fs');
 
-// ── Colour helpers ────────────────────────────────────────────────────────────
+// ── Colours ───────────────────────────────────────────────────────────────────
 const B  = '\x1b[1;34m';   // bold blue
 const G  = '\x1b[0;32m';   // green
 const R  = '\x1b[1;31m';   // red
 const Y  = '\x1b[1;33m';   // yellow
-const NC = '\x1b[0m';
+const D  = '\x1b[2m';      // dim
+const NC = '\x1b[0m';      // reset
 
 function die(msg) {
   console.error(`\n${R}Error:${NC} ${msg}`);
   process.exit(1);
 }
 
-// ── Platform guards ───────────────────────────────────────────────────────────
-if (platform() !== 'linux') {
-  die('This installer only runs on Raspberry Pi (Linux). Got: ' + platform());
+// ── Dot-matrix font  (5 px wide × 5 px tall, █ = lit, space = dark) ──────────
+const GLYPHS = {
+  'T': ['█████', '  █  ', '  █  ', '  █  ', '  █  '],
+  'Ø': [' ███ ', '█  /█', '█ / █', '█/  █', ' ███ '],
+  'V': ['█   █', '█   █', ' █ █ ', ' █ █ ', '  █  '],
+  'E': ['█████', '█    ', '████ ', '█    ', '█████'],
+  'X': ['█   █', ' █ █ ', '  █  ', ' █ █ ', '█   █'],
+  'S': [' ████', '█    ', ' ███ ', '    █', '████ '],
+  'Y': ['█   █', ' █ █ ', '  █  ', '  █  ', '  █  '],
+  'M': ['█   █', '██ ██', '█ █ █', '█   █', '█   █'],
+  ' ': ['     ', '     ', '     ', '     ', '     '],
+};
+
+/**
+ * Returns 5 equal-length strings representing the dot-matrix rows of `word`.
+ * Each character glyph is 5 wide; glyphs are separated by a single space.
+ */
+function dotRows(word) {
+  const rows = ['', '', '', '', ''];
+  for (const ch of word.toUpperCase()) {
+    const g = GLYPHS[ch] || GLYPHS[' '];
+    for (let i = 0; i < 5; i++) rows[i] += g[i] + ' ';
+  }
+  // Remove the one trailing separator space added after the last glyph
+  return rows.map(r => r.slice(0, -1));
 }
-if (arch() !== 'arm64') {
-  die('Requires 64-bit ARM (arm64). Got: ' + arch() +
-      '\nMake sure you are running 64-bit Raspberry Pi OS.');
+
+// ── TØVEX-SYSTEMS access banner ───────────────────────────────────────────────
+function showAccessDenied() {
+  const INNER = 52;   // characters between the ║ borders
+
+  // Center a plain-text string inside INNER
+  function cen(str) {
+    const len  = str.length;
+    const lpad = Math.floor((INNER - len) / 2);
+    const rpad = INNER - len - lpad;
+    return ' '.repeat(Math.max(0, lpad)) + str + ' '.repeat(Math.max(0, rpad));
+  }
+
+  const bar   = '═'.repeat(INNER);
+  const blank = `${B}║${' '.repeat(INNER)}║${NC}`;
+
+  function boxRow(str, color) {
+    return `${B}║${NC}${color}${cen(str)}${NC}${B}║${NC}`;
+  }
+
+  const tRow = dotRows('TØVEX');
+  const sRow = dotRows('SYSTEMS');
+
+  // Dot-separator exactly as wide as SYSTEMS
+  const sep = Array.from({ length: sRow[0].length }, (_, i) => i % 2 ? ' ' : '·').join('');
+
+  // ── Print box ─────────────────────────────────────────────────────────────
+  console.log('');
+  console.log(`${B}╔${bar}╗${NC}`);
+  console.log(blank);
+  for (const r of tRow)  console.log(boxRow(r, B));
+  console.log(blank);
+  console.log(boxRow(sep, D));
+  console.log(blank);
+  for (const r of sRow)  console.log(boxRow(r, B));
+  console.log(blank);
+  console.log(`${B}╚${bar}╝${NC}`);
+
+  // ── Access-denied message ─────────────────────────────────────────────────
+  console.log('');
+  console.log(`  ${R}⚠  Please contact administrator for access${NC}`);
+  console.log('');
+  console.log(`  ${D}Install:${NC}    npx plc-checkweigher ${Y}-tov${NC}`);
+  console.log(`  ${D}Uninstall:${NC}  npx plc-checkweigher ${Y}-ex${NC}`);
+  console.log(`  ${D}Help:${NC}       npx plc-checkweigher ${Y}--help${NC}`);
+  console.log('');
+
+  process.exit(1);
 }
 
-// ── Banner ────────────────────────────────────────────────────────────────────
-console.log(`
-${B}╔════════════════════════════════════════════╗
-║   PLC Check-Weigher — Full Stack Installer  ║
-╚════════════════════════════════════════════╝${NC}
+// ── Argument parsing ──────────────────────────────────────────────────────────
+const arg = (process.argv[2] || '').trim();
+
+const INSTALL_FLAGS   = ['-tov', '--install',   'install'];
+const UNINSTALL_FLAGS = ['-ex',  '--uninstall',  'uninstall', 'remove'];
+const HELP_FLAGS      = ['-h',   '--help',       'help'];
+
+if (HELP_FLAGS.includes(arg)) {
+  console.log(`
+${B}npx plc-checkweigher${NC} — PLC Check-Weigher setup utility
+
+  ${Y}npx plc-checkweigher -tov${NC}   Install   ${D}(set up stack, services, RT kernel)${NC}
+  ${Y}npx plc-checkweigher -ex${NC}    Uninstall ${D}(remove everything)${NC}
+  ${Y}npx plc-checkweigher --help${NC} Help
+
+${D}Aliases:${NC}
+  ${D}-tov / --install / install${NC}
+  ${D}-ex  / --uninstall / uninstall / remove${NC}
 `);
+  process.exit(0);
+}
+
+let mode = 'access';   // default: show brand banner + access denied
+if      (INSTALL_FLAGS.includes(arg))   mode = 'install';
+else if (UNINSTALL_FLAGS.includes(arg)) mode = 'uninstall';
+else if (arg !== '')                    die(`Unknown argument: ${arg}\nRun: npx plc-checkweigher --help`);
+
+// ── Platform guards (skip for help / access-denied) ───────────────────────────
+if (mode !== 'access') {
+  if (platform() !== 'linux')
+    die('This installer only runs on Raspberry Pi (Linux). Got: ' + platform());
+  if (arch() !== 'arm64')
+    die('Requires 64-bit ARM (arm64). Got: ' + arch() +
+        '\nMake sure you are running 64-bit Raspberry Pi OS.');
+}
+
+// ── Locate scripts ────────────────────────────────────────────────────────────
+const pkgRoot        = path.resolve(__dirname, '..');
+const setupScript    = path.join(pkgRoot, 'setup.sh');
+const uninstallScript = path.join(pkgRoot, 'uninstall.sh');
+
+// ── Dispatch ──────────────────────────────────────────────────────────────────
+if (mode === 'access') {
+  showAccessDenied();   // exits with code 1
+}
 
-// ── Locate setup.sh (bundled inside this npm package) ────────────────────────
-const setupScript = path.resolve(__dirname, '..', 'setup.sh');
-if (!fs.existsSync(setupScript)) {
-  die('setup.sh not found inside the package — try: npm install -g plc-checkweigher@latest');
+if (mode === 'install') {
+  if (!fs.existsSync(setupScript))
+    die('setup.sh not found — try: npx plc-checkweigher@latest -tov');
+
+  console.log(`
+${B}╔══════════════════════════════════════════════╗
+║   PLC Check-Weigher — Full Stack Installer   ║
+╚══════════════════════════════════════════════╝${NC}
+`);
+  console.log(`${Y}This will:${NC}`);
+  console.log('  1. Install the PREEMPT_RT real-time kernel (reboots once)');
+  console.log('  2. Install all Python dependencies');
+  console.log('  3. Clone / update the plc-checkweigher repo');
+  console.log('  4. Configure WiFi, SMB file sharing  (credentials → smb_config.py)');
+  console.log('  5. Install systemd services with RT scheduling priority');
+  console.log('  6. Set up live dashboard  →  http://<pi-ip>:8080/live');
+  console.log('  7. Set up PDF report viewer with instant auto-refresh');
+  console.log('');
+  console.log(`${Y}Sudo password required to make system-level changes.${NC}`);
+  console.log('');
+
+  const result = spawnSync('sudo', ['bash', setupScript], {
+    stdio: 'inherit',
+    env:   process.env,
+  });
+  process.exit(result.status ?? 0);
 }
 
-// ── Inform the user ───────────────────────────────────────────────────────────
-console.log(`${Y}This will:${NC}`);
-console.log('  1. Install the PREEMPT_RT real-time kernel (reboots once)');
-console.log('  2. Install all Python dependencies');
-console.log('  3. Clone / update the plc-checkweigher repo');
-console.log('  4. Configure WiFi, SMB file sharing  (credentials → smb_config.py)');
-console.log('  5. Install systemd services with RT scheduling priority');
-console.log('  6. Set up live dashboard  →  http://<pi-ip>:8080/live');
-console.log('  7. Set up PDF report viewer with instant auto-refresh');
-console.log('');
-console.log(`${Y}Sudo password required to make system-level changes.${NC}`);
-console.log('');
-
-// ── Run setup.sh via sudo ─────────────────────────────────────────────────────
-// stdio:'inherit' keeps the terminal fully interactive:
-//   • sudo password prompt works
-//   • WiFi password prompt works
-//   • All colour output passes through
-const result = spawnSync('sudo', ['bash', setupScript], {
-  stdio: 'inherit',
-  env: process.env,
-});
-
-process.exit(result.status ?? 0);
+if (mode === 'uninstall') {
+  if (!fs.existsSync(uninstallScript))
+    die('uninstall.sh not found — try: npx plc-checkweigher@latest -ex');
+
+  console.log(`
+${R}╔══════════════════════════════════════════════╗
+║   PLC Check-Weigher — Uninstaller            ║
+╚══════════════════════════════════════════════╝${NC}
+`);
+  console.log(`${D}Removes all services, code, venv, kernel config, and CLI tools.${NC}`);
+  console.log(`${D}You will be asked whether to keep your PDF reports.${NC}`);
+  console.log('');
+
+  const result = spawnSync('sudo', ['bash', uninstallScript], {
+    stdio: 'inherit',
+    env:   process.env,
+  });
+  process.exit(result.status ?? 0);
+}

package/bin/plc_checkweigher

@@ -1,17 +1,6 @@
 #!/usr/bin/env bash
 # plc_checkweigher — CLI for the PLC Check-Weigher system
 # Installed to /usr/local/bin/ by setup.sh
-#
-# Commands:
-#   status                  Full system diagnostic
-#   logs                    Live journalctl stream
-#   restart / start / stop  Service control
-#   push-test               Push latest PDF to SMB target
-#   queue                   Show SMB delivery queue + ledger
-#   wifi                    Scan and switch WiFi network (prompts SMB IP update)
-#   hotspot on/off/status/scan  WiFi hotspot (AP mode) — direct PC connection
-#   display on/off/status   Enable/disable the display (LightDM)
-#   smb-config              Interactively update SMB delivery target
 
 set -euo pipefail
 
@@ -19,6 +8,9 @@ INSTALL_DIR="/home/pi/plc_checkweigher"
 PYTHON="/home/pi/plc_env/bin/python3"
 SMB_CFG="${INSTALL_DIR}/smb_config.py"
 
+# ── TTY detection — animations only when connected to a real terminal ─────────
+[[ -t 1 ]] && _TTY=1 || _TTY=0
+
 # ── Colours ───────────────────────────────────────────────────────────────────
 B='\033[1;34m'; G='\033[0;32m'; R='\033[1;31m'; Y='\033[1;33m'
 C='\033[0;36m'; D='\033[2m'; W='\033[1m'; NC='\033[0m'
@@ -28,33 +20,72 @@ err()  { echo -e "  ${R}✗${NC}  $*" >&2; }
 warn() { echo -e "  ${Y}!${NC}  $*"; }
 info() { echo -e "  ${C}i${NC}  $*"; }
 hr()   { echo -e "  ${D}$(printf '─%.0s' {1..56})${NC}"; }
-banner() { echo -e "\n${B}  ▸ $*${NC}"; }
 
-need_sudo() {
-    if [[ $EUID -ne 0 ]]; then
-        if ! sudo -n true 2>/dev/null; then
-            echo -e "  ${Y}sudo password required${NC}"
-        fi
+# ── Typewrite banner ──────────────────────────────────────────────────────────
+banner() {
+    echo ""
+    if [[ $_TTY -eq 1 ]]; then
+        printf "  ${B}▸ ${NC}"
+        local txt="$*" i
+        for ((i=0; i<${#txt}; i++)); do
+            printf "${B}%s${NC}" "${txt:$i:1}"
+            sleep 0.022
+        done
+        echo ""
+    else
+        echo -e "${B}  ▸ $*${NC}"
     fi
 }
 
-# ── Read current SMB config ───────────────────────────────────────────────────
-smb_get() {
-    local key="$1"
-    grep "^${key}" "${SMB_CFG}" 2>/dev/null \
-        | head -1 | sed 's/.*= *"//;s/".*//'
+# ── Spinner ───────────────────────────────────────────────────────────────────
+_SP_PID=""
+_SP_MSG=""
+_SP_FRAMES=(⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧ ⠇ ⠏)
+
+_spin_kill() {
+    if [[ -n "$_SP_PID" ]]; then
+        kill "$_SP_PID" 2>/dev/null || true
+        wait "$_SP_PID" 2>/dev/null || true
+        _SP_PID=""
+    fi
+    if [[ $_TTY -eq 1 ]]; then printf '\r\033[K'; fi
+    return 0
+}
+trap '_spin_kill' EXIT INT TERM
+
+spin_start() {
+    _SP_MSG="${1:-}"
+    [[ $_TTY -eq 0 ]] && { echo -e "  ${C}…${NC}  ${_SP_MSG}"; return; }
+    _spin_kill
+    (
+        local i=0
+        while true; do
+            printf "\r  ${C}%s${NC}  %s " "${_SP_FRAMES[$((i % 10))]}" "${_SP_MSG}"
+            sleep 0.08
+            i=$((i + 1))
+        done
+    ) &
+    _SP_PID=$!
 }
 
-smb_set() {
-    local key="$1" val="$2"
-    if grep -q "^${key}" "${SMB_CFG}" 2>/dev/null; then
-        sed -i "s|^${key}.*|${key} = \"${val}\"|" "${SMB_CFG}"
-    else
-        echo "${key} = \"${val}\"" >> "${SMB_CFG}"
+spin_ok()   { local m="${_SP_MSG}"; _spin_kill; ok   "${m}${1:+  ${D}$1${NC}}"; return 0; }
+spin_warn() { local m="${_SP_MSG}"; _spin_kill; warn "${m}${1:+  ${D}$1${NC}}"; return 0; }
+spin_err()  { local m="${_SP_MSG}"; _spin_kill; err  "${m}${1:+  ${D}$1${NC}}"; return 0; }
+
+# ── sudo helper ───────────────────────────────────────────────────────────────
+need_sudo() {
+    if [[ $EUID -ne 0 ]] && ! sudo -n true 2>/dev/null; then
+        echo -e "  ${Y}sudo password required${NC}"
+        sudo -v
     fi
 }
 
-# ── SMB config update prompt (reused by wifi + smb-config) ───────────────────
+# ── Read / write smb_config.py ────────────────────────────────────────────────
+smb_get() {
+    grep "^${1}" "${SMB_CFG}" 2>/dev/null | head -1 | sed 's/.*= *"//;s/".*//'
+}
+
+# ── SMB config update prompt (reused by wifi + smb-config + hotspot scan) ────
 prompt_smb_config() {
     local context="${1:-}"
     echo ""
@@ -62,34 +93,26 @@ prompt_smb_config() {
     [[ -n "$context" ]] && info "$context"
     echo ""
 
+    local CUR_HOST CUR_SHARE CUR_USER CUR_PASS
     CUR_HOST=$(smb_get "SMB_HOST")
     CUR_SHARE=$(smb_get "SMB_SHARE")
     CUR_USER=$(smb_get "SMB_USERNAME")
     CUR_PASS=$(smb_get "SMB_PASSWORD")
-    CUR_ENABLED=$(grep "^SMB_ENABLED" "${SMB_CFG}" 2>/dev/null | grep -o "True\|False" || echo "True")
 
     hr
-    printf "  ${B}%-22s${NC} ${D}current: %s${NC}\n" "Host IP"      "${CUR_HOST:-(not set)}"
-    printf "  ${B}%-22s${NC} ${D}current: %s${NC}\n" "Share name"   "${CUR_SHARE:-(not set)}"
-    printf "  ${B}%-22s${NC} ${D}current: %s${NC}\n" "Username"     "${CUR_USER:-(not set)}"
-    printf "  ${B}%-22s${NC} ${D}current: %s${NC}\n" "Password"     "${CUR_PASS:-(not set)}"
+    printf "  ${B}%-22s${NC} ${D}current: %s${NC}\n" "Host IP"    "${CUR_HOST:-(not set)}"
+    printf "  ${B}%-22s${NC} ${D}current: %s${NC}\n" "Share name" "${CUR_SHARE:-(not set)}"
+    printf "  ${B}%-22s${NC} ${D}current: %s${NC}\n" "Username"   "${CUR_USER:-(not set)}"
+    printf "  ${B}%-22s${NC} ${D}current: %s${NC}\n" "Password"   "${CUR_PASS:-(not set)}"
     hr
     echo ""
 
-    read -r -p "  Host IP      [${CUR_HOST}]: " NEW_HOST </dev/tty
-    NEW_HOST="${NEW_HOST:-$CUR_HOST}"
+    local NEW_HOST NEW_SHARE NEW_USER NEW_PASS
+    read -r -p "  Host IP      [${CUR_HOST}]: "          NEW_HOST  </dev/tty; NEW_HOST="${NEW_HOST:-$CUR_HOST}"
+    read -r -p "  Share name   [${CUR_SHARE:-Reports}]: " NEW_SHARE </dev/tty; NEW_SHARE="${NEW_SHARE:-${CUR_SHARE:-Reports}}"
+    read -r -p "  Username     [${CUR_USER:-plcreport}]: " NEW_USER </dev/tty; NEW_USER="${NEW_USER:-${CUR_USER:-plcreport}}"
+    read -r -s -p "  Password     (blank = keep current): " NEW_PASS </dev/tty; echo ""; NEW_PASS="${NEW_PASS:-$CUR_PASS}"
 
-    read -r -p "  Share name   [${CUR_SHARE:-Reports}]: " NEW_SHARE </dev/tty
-    NEW_SHARE="${NEW_SHARE:-${CUR_SHARE:-Reports}}"
-
-    read -r -p "  Username     [${CUR_USER:-plcreport}]: " NEW_USER </dev/tty
-    NEW_USER="${NEW_USER:-${CUR_USER:-plcreport}}"
-
-    read -r -s -p "  Password     (leave blank to keep current): " NEW_PASS </dev/tty
-    echo ""
-    NEW_PASS="${NEW_PASS:-$CUR_PASS}"
-
-    # Write updated config
     cat > "${SMB_CFG}" << EOF
 SMB_ENABLED  = True
 SMB_HOST     = "${NEW_HOST}"
@@ -101,22 +124,21 @@ EOF
 
     echo ""
     ok "smb_config.py updated"
-    info "Host: ${NEW_HOST}  |  Share: //${NEW_HOST}/${NEW_SHARE}  |  User: ${NEW_USER}"
-
-    # Quick connectivity test
+    info "Target: //${NEW_HOST}/${NEW_SHARE}  as  ${NEW_USER}"
     echo ""
-    echo -n "  Testing connection ..."
+
+    spin_start "Pinging ${NEW_HOST}"
     if ping -c 2 -W 2 "${NEW_HOST}" &>/dev/null; then
-        echo ""
-        ok "${NEW_HOST} reachable"
-        if smbclient "//${NEW_HOST}/${NEW_SHARE}" -U "${NEW_USER}%${NEW_PASS}" -c "ls" &>/dev/null 2>&1; then
-            ok "SMB auth OK — PDF delivery is ready"
+        spin_ok "${NEW_HOST} reachable"
+        spin_start "Authenticating with //${NEW_HOST}/${NEW_SHARE}"
+        if smbclient "//${NEW_HOST}/${NEW_SHARE}" \
+               -U "${NEW_USER}%${NEW_PASS}" -c "ls" &>/dev/null 2>&1; then
+            spin_ok "SMB auth OK — PDF delivery ready"
         else
-            warn "SMB auth failed — verify share name and credentials on the PC"
+            spin_warn "Auth failed — verify share name and credentials on the PC"
         fi
     else
-        echo ""
-        warn "${NEW_HOST} not reachable right now — config saved, will retry at runtime"
+        spin_warn "${NEW_HOST} not reachable — config saved, will retry at runtime"
     fi
     echo ""
 }
@@ -141,22 +163,38 @@ logs)
 restart)
     need_sudo
     banner "Restarting services"
+    echo ""
+    spin_start "Restarting plc_watcher and plc_web"
     sudo systemctl restart plc_watcher plc_web
     sleep 2
+    spin_ok
+    echo ""
     systemctl status plc_watcher plc_web --no-pager | grep -E 'Active|Main PID'
+    echo ""
     ;;
+
 start)
     need_sudo
     banner "Starting services"
+    echo ""
+    spin_start "Starting plc_watcher and plc_web"
     sudo systemctl start plc_watcher plc_web
-    ok "plc_watcher and plc_web started"
+    sleep 1
+    spin_ok
+    echo ""
     ;;
+
 stop)
     need_sudo
     banner "Stopping services"
+    echo ""
+    spin_start "Stopping plc_watcher and plc_web"
     sudo systemctl stop plc_watcher plc_web
-    warn "Services stopped — they will restart automatically on next boot"
+    spin_ok
+    echo ""
+    warn "Services stopped — will restart automatically on next boot"
     warn "To disable auto-start: sudo systemctl disable plc_watcher plc_web"
+    echo ""
     ;;
 
 # ── SMB queue ─────────────────────────────────────────────────────────────────
@@ -180,7 +218,7 @@ queue)
     if [[ -f "$LEDGER" ]]; then
         SENT=$(wc -l < "$LEDGER")
         ok "Delivery ledger: ${SENT} file(s) sent"
-        cat "$LEDGER" | sed 's/^/     /'
+        sed 's/^/     /' "$LEDGER"
     else
         info "No deliveries recorded yet"
     fi
@@ -198,7 +236,7 @@ push-test)
         LATEST=$(ls -t /home/pi/reports/*.pdf 2>/dev/null | head -1 || true)
     fi
     [[ -z "$LATEST" ]] && { err "Could not generate PDF — is PLC connected?"; exit 1; }
-    info "File: $(basename $LATEST)"
+    info "File: $(basename "$LATEST")"
     echo ""
     "${PYTHON}" -c "
 import sys, os
@@ -228,9 +266,11 @@ wifi)
     scan|"")
         banner "WiFi Networks"
         echo ""
-        info "Scanning ..."
+
+        spin_start "Scanning for networks"
         nmcli dev wifi rescan ifname wlan0 2>/dev/null || true
         sleep 2
+        spin_ok
 
         mapfile -t RAW < <(
             nmcli -t -f SSID,SIGNAL,SECURITY,IN-USE dev wifi list ifname wlan0 2>/dev/null \
@@ -274,11 +314,9 @@ wifi)
         SEL="${SSIDS[$((CHOICE-1))]}"
         echo ""
         read -r -s -p "  Password for '${SEL}' (blank if open): " WIFI_PASS </dev/tty
-        echo ""
-        echo ""
+        echo ""; echo ""
 
         need_sudo
-        # Remove existing connection if any, then connect
         sudo nmcli connection delete "$SEL" 2>/dev/null || true
         if [[ -n "$WIFI_PASS" ]]; then
             sudo nmcli connection add type wifi ifname wlan0 con-name "$SEL" \
@@ -291,25 +329,21 @@ wifi)
                 connection.autoconnect-priority 200 2>/dev/null
         fi
 
-        echo -n "  Connecting to '$SEL' ..."
+        spin_start "Connecting to '${SEL}'"
         if sudo nmcli connection up "$SEL" 2>/dev/null; then
-            echo ""
             sleep 2
             NEW_IP=$(ip -4 addr show wlan0 2>/dev/null | grep -oP '(?<=inet )\d+\.\d+\.\d+\.\d+' || echo "")
-            ok "Connected to '${SEL}'"
-            [[ -n "$NEW_IP" ]] && ok "New IP: ${NEW_IP}  →  web UI at http://${NEW_IP}:8080"
+            spin_ok "Connected"
+            [[ -n "$NEW_IP" ]] && ok "Pi IP: ${NEW_IP}  →  http://${NEW_IP}:8080"
 
-            # Prompt to update SMB host IP
             echo ""
             echo -e "  ${Y}Network changed — SMB delivery target may need updating.${NC}"
             read -r -p "  Update SMB host IP? [Y/n]: " CONFIRM </dev/tty
             CONFIRM="${CONFIRM:-Y}"
-            if [[ "${CONFIRM^^}" == "Y" ]]; then
+            [[ "${CONFIRM^^}" == "Y" ]] && \
                 prompt_smb_config "Network changed to '${SEL}'  (Pi IP: ${NEW_IP:-unknown})"
-            fi
         else
-            echo ""
-            warn "Could not connect — check password and try again"
+            spin_warn "Could not connect — check password and try again"
         fi
         ;;
 
@@ -334,41 +368,31 @@ hotspot)
         banner "Enable Hotspot"
         need_sudo
         echo ""
-
-        # Allow custom SSID/pass as args
         [[ -n "${1:-}" ]] && HOTSPOT_SSID="$1"
         [[ -n "${2:-}" ]] && HOTSPOT_PASS="$2"
 
-        # Bring down existing hotspot connection if any
         sudo nmcli connection delete "$HOTSPOT_CON" 2>/dev/null || true
 
-        info "Creating hotspot '${HOTSPOT_SSID}' on wlan0 ..."
+        spin_start "Starting hotspot '${HOTSPOT_SSID}'"
         sudo nmcli device wifi hotspot \
-            ifname wlan0 \
-            con-name "$HOTSPOT_CON" \
-            ssid "$HOTSPOT_SSID" \
-            password "$HOTSPOT_PASS" 2>&1 | grep -v "^$" || true
-
+            ifname wlan0 con-name "$HOTSPOT_CON" \
+            ssid "$HOTSPOT_SSID" password "$HOTSPOT_PASS" &>/dev/null || true
         sleep 2
+        spin_ok "Hotspot active"
 
-        # Get Pi's hotspot IP (usually 10.42.0.1)
         HOTSPOT_IP=$(ip -4 addr show wlan0 2>/dev/null \
             | grep -oP '(?<=inet )\d+\.\d+\.\d+\.\d+' || echo "10.42.0.1")
 
-        echo ""
-        ok "Hotspot active"
         echo ""
         echo -e "  ${W}┌────────────────────────────────────────────────┐${NC}"
         echo -e "  ${W}│  Connect your PC to this WiFi:                 │${NC}"
         echo -e "  ${W}│                                                │${NC}"
-        printf  "  ${W}│  %-14s ${G}%-30s${W}  │${NC}\n" "SSID:" "$HOTSPOT_SSID"
+        printf  "  ${W}│  %-14s ${G}%-30s${W}  │${NC}\n" "SSID:"     "$HOTSPOT_SSID"
         printf  "  ${W}│  %-14s ${G}%-30s${W}  │${NC}\n" "Password:" "$HOTSPOT_PASS"
-        printf  "  ${W}│  %-14s ${C}%-30s${W}  │${NC}\n" "Pi IP:" "$HOTSPOT_IP"
+        printf  "  ${W}│  %-14s ${C}%-30s${W}  │${NC}\n" "Pi IP:"    "$HOTSPOT_IP"
         echo -e "  ${W}└────────────────────────────────────────────────┘${NC}"
         echo ""
         info "After PC connects, run:  plc_checkweigher hotspot scan"
-        info "  — detects PC's IP and updates SMB config automatically"
-        echo ""
         info "Web UI still accessible at:  http://${HOTSPOT_IP}:8080"
         echo ""
         ;;
@@ -376,9 +400,11 @@ hotspot)
     off)
         banner "Disable Hotspot"
         need_sudo
+        echo ""
+        spin_start "Stopping hotspot"
         sudo nmcli connection delete "$HOTSPOT_CON" 2>/dev/null \
-            && ok "Hotspot stopped" \
-            || warn "No active hotspot found"
+            && spin_ok \
+            || spin_warn "No active hotspot found"
         echo ""
         info "To reconnect to WiFi:  plc_checkweigher wifi"
         echo ""
@@ -401,29 +427,34 @@ hotspot)
         ;;
 
     scan)
-        # Find devices connected to the hotspot subnet and offer to set as SMB target
         banner "Scanning for connected devices"
         echo ""
 
         HOTSPOT_IP=$(ip -4 addr show wlan0 2>/dev/null \
             | grep -oP '(?<=inet )\d+\.\d+\.\d+\.\d+' || echo "")
-
         if [[ -z "$HOTSPOT_IP" ]]; then
             err "Hotspot not active — run: plc_checkweigher hotspot on"
             exit 1
         fi
 
         SUBNET="${HOTSPOT_IP%.*}.0/24"
-        info "Scanning ${SUBNET} ..."
+        info "Sweeping ${SUBNET} ..."
+        echo ""
 
-        # Refresh ARP table by pinging the subnet
+        # Parallel ping sweep with live counter
+        DONE=0
         for i in $(seq 1 254); do
             ping -c 1 -W 1 "${HOTSPOT_IP%.*}.${i}" &>/dev/null &
+            DONE=$((DONE + 1))
+            if [[ $_TTY -eq 1 && $((DONE % 16)) -eq 0 ]]; then
+                printf "\r  ${C}⠹${NC}  Pinging hosts ... ${D}%d / 254${NC}   " "$DONE"
+            fi
         done
         wait
+        [[ $_TTY -eq 1 ]] && printf '\r\033[K'
         sleep 1
+        ok "Subnet sweep complete"
 
-        # Collect clients (exclude Pi itself)
         mapfile -t CLIENTS < <(
             ip neigh show 2>/dev/null \
             | grep "REACHABLE\|STALE\|DELAY" \
@@ -434,10 +465,10 @@ hotspot)
         )
 
         if [[ ${#CLIENTS[@]} -eq 0 ]]; then
-            warn "No devices found yet — make sure the PC is connected to '${HOTSPOT_SSID}'"
-            info "Try again in a few seconds: plc_checkweigher hotspot scan"
             echo ""
-            exit 0
+            warn "No devices found — make sure the PC is connected to '${HOTSPOT_SSID}'"
+            info "Try again: plc_checkweigher hotspot scan"
+            echo ""; exit 0
         fi
 
         echo ""
@@ -448,7 +479,8 @@ hotspot)
         for i in "${!CLIENTS[@]}"; do
             IP="${CLIENTS[$i]}"
             CLIENT_IPS[$i]="$IP"
-            HOST=$(host "$IP" 2>/dev/null | grep "domain name pointer" | awk '{print $NF}' | sed 's/\.$//' || echo "")
+            HOST=$(host "$IP" 2>/dev/null | grep "domain name pointer" \
+                | awk '{print $NF}' | sed 's/\.$//' || echo "")
             printf "  %-4s %-18s %s\n" "$((i+1)))" "$IP" "${HOST:-(unknown)}"
         done
         hr
@@ -489,18 +521,26 @@ display)
     on)
         banner "Enable Display"
         need_sudo
-        sudo systemctl start lightdm 2>/dev/null \
-            && ok "Display enabled — LightDM started" \
-            || warn "LightDM failed to start (may not be installed)"
+        echo ""
+        spin_start "Starting LightDM"
+        if sudo systemctl start lightdm 2>/dev/null; then
+            spin_ok "Display enabled"
+        else
+            spin_warn "LightDM failed to start (may not be installed)"
+        fi
         sudo systemctl enable lightdm 2>/dev/null && ok "Auto-start enabled" || true
         echo ""
         ;;
     off)
         banner "Disable Display"
         need_sudo
-        sudo systemctl stop lightdm 2>/dev/null \
-            && ok "Display disabled — LightDM stopped" \
-            || warn "LightDM was not running"
+        echo ""
+        spin_start "Stopping LightDM"
+        if sudo systemctl stop lightdm 2>/dev/null; then
+            spin_ok "Display disabled"
+        else
+            spin_warn "LightDM was not running"
+        fi
         read -r -p "  Disable auto-start on boot too? [y/N]: " DIS </dev/tty
         DIS="${DIS:-N}"
         if [[ "${DIS^^}" == "Y" ]]; then
@@ -511,17 +551,15 @@ display)
     status)
         banner "Display Status"
         echo ""
-        ACTIVE=$(systemctl is-active lightdm 2>/dev/null || echo "inactive")
-        ENABLED=$(systemctl is-enabled lightdm 2>/dev/null || echo "disabled")
+        ACTIVE=$(systemctl is-active  lightdm 2>/dev/null || true)
+        ENABLED=$(systemctl is-enabled lightdm 2>/dev/null || true)
         if [[ "$ACTIVE" == "active" ]]; then
             ok "LightDM: RUNNING  (auto-start: ${ENABLED})"
         else
             info "LightDM: ${ACTIVE}  (auto-start: ${ENABLED})"
         fi
-        # HDMI / display connected
         if command -v tvservice &>/dev/null; then
-            HDMI=$(tvservice -s 2>/dev/null | head -1)
-            info "HDMI: ${HDMI}"
+            info "HDMI: $(tvservice -s 2>/dev/null | head -1)"
         fi
         echo ""
         ;;
@@ -538,6 +576,167 @@ smb-config)
     prompt_smb_config
     ;;
 
+# ─────────────────────────────────────────────────────────────────────────────
+# UNINSTALL — remove everything setup.sh installed
+# ─────────────────────────────────────────────────────────────────────────────
+uninstall)
+    PI_USER="${PI_USER:-pi}"
+    HOME_DIR="/home/${PI_USER}"
+    VENV_DIR="${HOME_DIR}/plc_env"
+    REPORTS_DIR="${HOME_DIR}/reports"
+    BOOT_FW="/boot/firmware"
+
+    echo ""
+    echo -e "${R}  ╔══════════════════════════════════════════════════════════╗${NC}"
+    echo -e "${R}  ║              PLC CHECK-WEIGHER UNINSTALLER               ║${NC}"
+    echo -e "${R}  ╚══════════════════════════════════════════════════════════╝${NC}"
+    echo ""
+    echo -e "  This will permanently remove:"
+    echo ""
+    echo -e "  ${R}✗${NC}  systemd services    plc_watcher  plc_web"
+    echo -e "  ${R}✗${NC}  project code        ${INSTALL_DIR}"
+    echo -e "  ${R}✗${NC}  Python venv         ${VENV_DIR}"
+    echo -e "  ${R}✗${NC}  CLI tool            /usr/local/bin/plc_checkweigher"
+    echo -e "  ${R}✗${NC}  Plymouth theme      saismruth (reverts to default)"
+    echo -e "  ${R}✗${NC}  RT kernel config    (reverts /boot/firmware/config.txt)"
+    echo -e "  ${R}✗${NC}  LightDM drop-in     /etc/systemd/system/lightdm.service.d/"
+    echo -e "  ${R}✗${NC}  NetworkManager cfg  /etc/systemd/system/NetworkManager-wait-online.service.d/"
+    echo -e "  ${R}✗${NC}  Hotspot connection  plc-hotspot (nmcli)"
+    echo -e "  ${Y}!${NC}  reports folder      ${REPORTS_DIR}  (you will be asked)"
+    echo ""
+    echo -e "  ${D}System packages (git, python3-venv, samba-client) are NOT removed.${NC}"
+    echo ""
+    hr
+    echo ""
+
+    read -r -p "  Type  YES  to confirm full uninstall: " CONFIRM </dev/tty
+    [[ "$CONFIRM" == "YES" ]] || { echo "  Aborted."; exit 0; }
+
+    echo ""
+    read -r -p "  Keep report PDFs in ${REPORTS_DIR}? [Y/n]: " KEEP_REPORTS </dev/tty
+    KEEP_REPORTS="${KEEP_REPORTS:-Y}"
+
+    echo ""
+    need_sudo
+
+    # Step counter
+    _US=0; _UT=9
+    ustep() { _US=$((_US + 1)); spin_start "[${_US}/${_UT}] $*"; }
+
+    # ── 1. Stop and disable services ─────────────────────────────────────────
+    echo ""
+    ustep "Stopping and disabling services"
+    for SVC in plc_watcher plc_web; do
+        systemctl is-active --quiet "$SVC" 2>/dev/null \
+            && sudo systemctl stop    "$SVC" 2>/dev/null || true
+        systemctl is-enabled --quiet "$SVC" 2>/dev/null \
+            && sudo systemctl disable "$SVC" 2>/dev/null || true
+    done
+    sudo rm -f /etc/systemd/system/plc_watcher.service \
+               /etc/systemd/system/plc_web.service
+    spin_ok "Services removed"
+
+    # ── 2. System drop-ins ───────────────────────────────────────────────────
+    ustep "Removing system drop-ins"
+    sudo rm -f /etc/systemd/system/lightdm.service.d/display-priority.conf
+    sudo rm -f /etc/systemd/system/NetworkManager-wait-online.service.d/timeout.conf
+    sudo rm -f /etc/tmpfiles.d/utmp-fix.conf
+    sudo systemctl reenable lightdm 2>/dev/null || true
+    spin_ok
+
+    # ── 3. Plymouth theme ────────────────────────────────────────────────────
+    ustep "Removing Plymouth theme"
+    THEME_DIR="/usr/share/plymouth/themes/saismruth"
+    [[ -d "$THEME_DIR" ]] && sudo rm -rf "$THEME_DIR"
+    DEFAULT_THEME=$(sudo plymouth-set-default-theme --list 2>/dev/null \
+        | grep -E "^pix$|^bgrt$|^spinner$" | head -1 || echo "")
+    if [[ -n "$DEFAULT_THEME" ]]; then
+        sudo plymouth-set-default-theme "$DEFAULT_THEME" 2>/dev/null || true
+    else
+        sudo plymouth-set-default-theme --reset 2>/dev/null || true
+    fi
+    spin_ok "Reverted to '${DEFAULT_THEME:-default}'"
+
+    # ── 4. Rebuild initramfs (slowest step — keep spinner alive) ─────────────
+    ustep "Rebuilding initramfs  ${D}(~30 s)${NC}"
+    sudo update-initramfs -u > /tmp/uninstall_initramfs.log 2>&1 \
+        && spin_ok \
+        || spin_warn "Warnings — see /tmp/uninstall_initramfs.log"
+
+    # ── 5. RT kernel revert ──────────────────────────────────────────────────
+    ustep "Reverting RT kernel config"
+    if [[ -f "${BOOT_FW}/config.txt" ]]; then
+        sudo sed -i '/### PLC-RT-BLOCK-START ###/,/### PLC-RT-BLOCK-END ###/d' \
+            "${BOOT_FW}/config.txt"
+        sudo sed -i '/^gpu_mem=128$/d' "${BOOT_FW}/config.txt"
+        sudo rm -f "${BOOT_FW}/kernel8-rt.img" \
+                   "${BOOT_FW}/initramfs8-rt"   \
+                   "${BOOT_FW}/kernel8-stock.img"
+        spin_ok "Stock kernel will boot after reboot"
+    else
+        spin_warn "config.txt not found — skipped"
+    fi
+
+    # ── 6. Hotspot + nmcli cleanup ───────────────────────────────────────────
+    ustep "Cleaning up network connections"
+    sudo nmcli connection delete "plc-hotspot" 2>/dev/null || true
+    sudo systemctl daemon-reload
+    spin_ok
+
+    # ── 7. Python venv ───────────────────────────────────────────────────────
+    ustep "Removing Python environment"
+    if [[ -d "$VENV_DIR" ]]; then
+        rm -rf "$VENV_DIR"
+        spin_ok "Removed ${VENV_DIR}"
+    else
+        spin_ok "Already gone"
+    fi
+
+    # ── 8. Reports (optional) + temp files ───────────────────────────────────
+    ustep "Cleaning up runtime files"
+    rm -f /tmp/plc_live.json 2>/dev/null || true
+    BASHRC="${HOME_DIR}/.bashrc"
+    [[ -f "$BASHRC" ]] && sed -i '/export PATH.*\.local\/bin/d' "$BASHRC" 2>/dev/null || true
+    sudo rm -f /usr/local/bin/plc_checkweigher
+    rm -f "${HOME_DIR}/.local/bin/plc_checkweigher" 2>/dev/null || true
+    if [[ "${KEEP_REPORTS^^}" != "Y" && -d "$REPORTS_DIR" ]]; then
+        rm -rf "$REPORTS_DIR"
+    fi
+    spin_ok "CLI and temp files removed"
+
+    # ── 9. Remove project directory (self-deletes last) ───────────────────────
+    ustep "Removing project code"
+    if [[ -d "$INSTALL_DIR" ]]; then
+        rm -rf "$INSTALL_DIR"
+        spin_ok "Removed ${INSTALL_DIR}"
+    else
+        spin_ok "Already gone"
+    fi
+
+    # ── Done ─────────────────────────────────────────────────────────────────
+    echo ""
+    echo -e "${G}"
+    echo "  ╔══════════════════════════════════════════════════════════╗"
+    echo "  ║  Uninstall complete.                                     ║"
+    echo "  ║                                                          ║"
+    echo "  ║  A reboot is needed to apply kernel revert.             ║"
+    echo "  ╚══════════════════════════════════════════════════════════╝"
+    echo -e "${NC}"
+    [[ "${KEEP_REPORTS^^}" == "Y" ]] && info "PDFs still at: ${REPORTS_DIR}  (remove manually if needed)"
+    echo ""
+
+    read -r -p "  Reboot now? [Y/n]: " DO_REBOOT </dev/tty
+    DO_REBOOT="${DO_REBOOT:-Y}"
+    if [[ "${DO_REBOOT^^}" == "Y" ]]; then
+        spin_start "Rebooting"
+        sleep 1
+        sudo reboot
+    else
+        warn "Remember to reboot for kernel changes to take effect."
+        echo ""
+    fi
+    ;;
+
 # ─────────────────────────────────────────────────────────────────────────────
 # HELP
 # ─────────────────────────────────────────────────────────────────────────────
@@ -571,6 +770,8 @@ help|--help|-h)
     echo "    display off                Disable display (stop LightDM)"
     echo "    display status             Show display state"
     echo ""
+    echo -e "  ${R}  uninstall${NC}                   Remove everything setup.sh installed"
+    echo ""
     ;;
 
 *)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plc-checkweigher",
-  "version": "1.7.0",
+  "version": "1.11.0",
   "description": "One-command installer for the PLC Check-Weigher system on Raspberry Pi (PREEMPT_RT kernel, Python stack, WiFi, SMB, systemd RT services)",
   "bin": {
     "plc-checkweigher": "bin/cli.js"
@@ -8,6 +8,7 @@
   "files": [
     "bin/",
     "setup.sh",
+    "uninstall.sh",
     "assets/"
   ],
   "keywords": [

package/uninstall.sh

@@ -0,0 +1,203 @@
+#!/usr/bin/env bash
+# =============================================================================
+#  PLC Check-Weigher — Full Uninstaller
+# =============================================================================
+#  Run directly:   sudo bash uninstall.sh
+#  Via npx:        npx plc-checkweigher -ex
+# =============================================================================
+
+set -euo pipefail
+
+PI_USER="${PI_USER:-pi}"
+HOME_DIR="/home/${PI_USER}"
+INSTALL_DIR="${HOME_DIR}/plc_checkweigher"
+VENV_DIR="${HOME_DIR}/plc_env"
+REPORTS_DIR="${HOME_DIR}/reports"
+BOOT_FW="/boot/firmware"
+
+B='\033[1;34m'; G='\033[0;32m'; R='\033[1;31m'; Y='\033[1;33m'
+C='\033[0;36m'; D='\033[2m'; NC='\033[0m'
+
+ok()     { echo -e "  ${G}✓${NC}  $*"; }
+warn()   { echo -e "  ${Y}!${NC}  $*"; }
+info()   { echo -e "  ${C}i${NC}  $*"; }
+hr()     { echo -e "  ${D}$(printf '─%.0s' {1..56})${NC}"; }
+banner() {
+    echo ""
+    echo -e "${B}  ▸ $*${NC}"
+}
+
+# ── Spinner ───────────────────────────────────────────────────────────────────
+_SP_PID=""; _SP_MSG=""
+_SP_FRAMES=(⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧ ⠇ ⠏)
+_TTY=0; [[ -t 1 ]] && _TTY=1
+
+_spin_kill() {
+    if [[ -n "$_SP_PID" ]]; then
+        kill "$_SP_PID" 2>/dev/null || true
+        wait "$_SP_PID" 2>/dev/null || true
+        _SP_PID=""
+    fi
+    if [[ $_TTY -eq 1 ]]; then printf '\r\033[K'; fi
+    return 0
+}
+trap '_spin_kill' EXIT INT TERM
+
+spin_start() {
+    _SP_MSG="${1:-}"
+    [[ $_TTY -eq 0 ]] && { echo -e "  ${C}…${NC}  ${_SP_MSG}"; return; }
+    _spin_kill
+    ( local i=0
+      while true; do
+          printf "\r  ${C}%s${NC}  %s " "${_SP_FRAMES[$((i % 10))]}" "${_SP_MSG}"
+          sleep 0.08; i=$((i+1))
+      done ) &
+    _SP_PID=$!
+}
+spin_ok()   { local m="${_SP_MSG}"; _spin_kill; ok   "${m}${1:+  ${D}$1${NC}}"; return 0; }
+spin_warn() { local m="${_SP_MSG}"; _spin_kill; warn "${m}${1:+  ${D}$1${NC}}"; return 0; }
+
+# ─────────────────────────────────────────────────────────────────────────────
+[[ "${EUID}" -eq 0 ]] || { echo -e "${R}Run as root:${NC}  sudo bash uninstall.sh"; exit 1; }
+
+echo ""
+echo -e "${R}  ╔══════════════════════════════════════════════════════════╗${NC}"
+echo -e "${R}  ║              PLC CHECK-WEIGHER UNINSTALLER               ║${NC}"
+echo -e "${R}  ╚══════════════════════════════════════════════════════════╝${NC}"
+echo ""
+echo -e "  This will permanently remove:"
+echo ""
+echo -e "  ${R}✗${NC}  systemd services    plc_watcher  plc_web"
+echo -e "  ${R}✗${NC}  project code        ${INSTALL_DIR}"
+echo -e "  ${R}✗${NC}  Python venv         ${VENV_DIR}"
+echo -e "  ${R}✗${NC}  CLI tool            /usr/local/bin/plc_checkweigher"
+echo -e "  ${R}✗${NC}  Plymouth theme      saismruth (reverts to default)"
+echo -e "  ${R}✗${NC}  RT kernel config    (reverts /boot/firmware/config.txt)"
+echo -e "  ${R}✗${NC}  LightDM drop-in     /etc/systemd/system/lightdm.service.d/"
+echo -e "  ${R}✗${NC}  NetworkManager cfg  /etc/systemd/system/NetworkManager-wait-online.service.d/"
+echo -e "  ${R}✗${NC}  Hotspot connection  plc-hotspot (nmcli)"
+echo -e "  ${Y}!${NC}  reports folder      ${REPORTS_DIR}  (you will be asked)"
+echo ""
+echo -e "  ${D}System packages (git, python3-venv, samba-client) are NOT removed.${NC}"
+echo ""
+hr
+echo ""
+
+read -r -p "  Type  YES  to confirm full uninstall: " CONFIRM </dev/tty
+[[ "$CONFIRM" == "YES" ]] || { echo "  Aborted."; exit 0; }
+
+echo ""
+read -r -p "  Keep report PDFs in ${REPORTS_DIR}? [Y/n]: " KEEP_REPORTS </dev/tty
+KEEP_REPORTS="${KEEP_REPORTS:-Y}"
+echo ""
+
+_US=0; _UT=9
+ustep() { _US=$((_US + 1)); spin_start "[${_US}/${_UT}] $*"; }
+
+# ── 1. Stop and disable services ─────────────────────────────────────────────
+ustep "Stopping and disabling services"
+for SVC in plc_watcher plc_web; do
+    systemctl is-active  --quiet "$SVC" 2>/dev/null && systemctl stop    "$SVC" 2>/dev/null || true
+    systemctl is-enabled --quiet "$SVC" 2>/dev/null && systemctl disable "$SVC" 2>/dev/null || true
+done
+rm -f /etc/systemd/system/plc_watcher.service \
+      /etc/systemd/system/plc_web.service
+spin_ok "Services removed"
+
+# ── 2. System drop-ins ────────────────────────────────────────────────────────
+ustep "Removing system drop-ins"
+rm -f /etc/systemd/system/lightdm.service.d/display-priority.conf
+rm -f /etc/systemd/system/NetworkManager-wait-online.service.d/timeout.conf
+rm -f /etc/tmpfiles.d/utmp-fix.conf
+systemctl reenable lightdm 2>/dev/null || true
+spin_ok
+
+# ── 3. Plymouth theme ────────────────────────────────────────────────────────
+ustep "Removing Plymouth theme"
+THEME_DIR="/usr/share/plymouth/themes/saismruth"
+[[ -d "$THEME_DIR" ]] && rm -rf "$THEME_DIR"
+DEFAULT_THEME=$(plymouth-set-default-theme --list 2>/dev/null \
+    | grep -E "^pix$|^bgrt$|^spinner$" | head -1 || echo "")
+if [[ -n "$DEFAULT_THEME" ]]; then
+    plymouth-set-default-theme "$DEFAULT_THEME" 2>/dev/null || true
+else
+    plymouth-set-default-theme --reset 2>/dev/null || true
+fi
+spin_ok "Reverted to '${DEFAULT_THEME:-default}'"
+
+# ── 4. Rebuild initramfs ──────────────────────────────────────────────────────
+ustep "Rebuilding initramfs  (${D}~30 s${NC})"
+update-initramfs -u > /tmp/uninstall_initramfs.log 2>&1 \
+    && spin_ok \
+    || spin_warn "Warnings — see /tmp/uninstall_initramfs.log"
+
+# ── 5. RT kernel revert ───────────────────────────────────────────────────────
+ustep "Reverting RT kernel config"
+if [[ -f "${BOOT_FW}/config.txt" ]]; then
+    sed -i '/### PLC-RT-BLOCK-START ###/,/### PLC-RT-BLOCK-END ###/d' "${BOOT_FW}/config.txt"
+    sed -i '/^gpu_mem=128$/d' "${BOOT_FW}/config.txt"
+    rm -f "${BOOT_FW}/kernel8-rt.img" \
+          "${BOOT_FW}/initramfs8-rt"  \
+          "${BOOT_FW}/kernel8-stock.img"
+    spin_ok "Stock kernel will boot after reboot"
+else
+    spin_warn "config.txt not found — skipped"
+fi
+
+# ── 6. Network cleanup ────────────────────────────────────────────────────────
+ustep "Cleaning up network connections"
+nmcli connection delete "plc-hotspot" 2>/dev/null || true
+systemctl daemon-reload
+spin_ok
+
+# ── 7. Python venv ────────────────────────────────────────────────────────────
+ustep "Removing Python environment"
+if [[ -d "$VENV_DIR" ]]; then
+    rm -rf "$VENV_DIR"
+    spin_ok "Removed ${VENV_DIR}"
+else
+    spin_ok "Already gone"
+fi
+
+# ── 8. Runtime files + CLI ────────────────────────────────────────────────────
+ustep "Cleaning up runtime files and CLI"
+rm -f /tmp/plc_live.json 2>/dev/null || true
+BASHRC="${HOME_DIR}/.bashrc"
+[[ -f "$BASHRC" ]] && sed -i '/export PATH.*\.local\/bin/d' "$BASHRC" 2>/dev/null || true
+rm -f /usr/local/bin/plc_checkweigher
+rm -f "${HOME_DIR}/.local/bin/plc_checkweigher" 2>/dev/null || true
+if [[ "${KEEP_REPORTS^^}" != "Y" && -d "$REPORTS_DIR" ]]; then
+    rm -rf "$REPORTS_DIR"
+fi
+spin_ok "CLI and temp files removed"
+
+# ── 9. Project code ───────────────────────────────────────────────────────────
+ustep "Removing project code"
+if [[ -d "$INSTALL_DIR" ]]; then
+    rm -rf "$INSTALL_DIR"
+    spin_ok "Removed ${INSTALL_DIR}"
+else
+    spin_ok "Already gone"
+fi
+
+# ── Done ──────────────────────────────────────────────────────────────────────
+echo ""
+echo -e "${G}"
+echo "  ╔══════════════════════════════════════════════════════════╗"
+echo "  ║  Uninstall complete.                                     ║"
+echo "  ║                                                          ║"
+echo "  ║  A reboot is needed to apply kernel revert.             ║"
+echo "  ╚══════════════════════════════════════════════════════════╝"
+echo -e "${NC}"
+[[ "${KEEP_REPORTS^^}" == "Y" ]] && info "PDFs still at: ${REPORTS_DIR}  (remove manually if needed)"
+echo ""
+
+read -r -p "  Reboot now? [Y/n]: " DO_REBOOT </dev/tty
+DO_REBOOT="${DO_REBOOT:-Y}"
+if [[ "${DO_REBOOT^^}" == "Y" ]]; then
+    echo ""; info "Rebooting ..."
+    reboot
+else
+    warn "Remember to reboot for kernel changes to take effect."
+    echo ""
+fi