npm - plc-checkweigher - Versions diffs - 1.7.0 → 1.12.0 - Mend

plc-checkweigher 1.7.0 → 1.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/bin/cli.js CHANGED Viewed

@@ -6,61 +6,170 @@ 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));
+}
+// ── 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('');
+  process.exit(1);
+}
+// ── 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)) {
+  showAccessDenied();
 }
-if (arch() !== 'arm64') {
-  die('Requires 64-bit ARM (arm64). Got: ' + arch() +
-      '\nMake sure you are running 64-bit Raspberry Pi OS.');
+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 !== '')                    showAccessDenied();
+// ── 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.');
 }
-// ── Banner ────────────────────────────────────────────────────────────────────
-console.log(`
-${B}╔════════════════════════════════════════════╗
-║   PLC Check-Weigher — Full Stack Installer  ║
-╚════════════════════════════════════════════╝${NC}
+// ── 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
+}
+if (mode === 'install') {
+  if (!fs.existsSync(setupScript))
+    die('setup.sh not found — try reinstalling the package: npx plc-checkweigher@latest');
+  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('');
-// ── 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');
+  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 reinstalling the package: npx plc-checkweigher@latest');
+  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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "plc-checkweigher",
-  "version": "1.7.0",
+  "version": "1.12.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 ADDED Viewed

@@ -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