plc-checkweigher 1.6.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

@@ -0,0 +1,783 @@
+#!/usr/bin/env bash
+# plc_checkweigher — CLI for the PLC Check-Weigher system
+# Installed to /usr/local/bin/ by setup.sh
+
+set -euo pipefail
+
+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'
+
+ok()   { echo -e "  ${G}✓${NC}  $*"; }
+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}"; }
+
+# ── 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
+}
+
+# ── 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=$!
+}
+
+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
+}
+
+# ── 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 ""
+    banner "Update SMB Delivery 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")
+
+    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)}"
+    hr
+    echo ""
+
+    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}"
+
+    cat > "${SMB_CFG}" << EOF
+SMB_ENABLED  = True
+SMB_HOST     = "${NEW_HOST}"
+SMB_SHARE    = "${NEW_SHARE}"
+SMB_USERNAME = "${NEW_USER}"
+SMB_PASSWORD = "${NEW_PASS}"
+SMB_SUBDIR   = ""
+EOF
+
+    echo ""
+    ok "smb_config.py updated"
+    info "Target: //${NEW_HOST}/${NEW_SHARE}  as  ${NEW_USER}"
+    echo ""
+
+    spin_start "Pinging ${NEW_HOST}"
+    if ping -c 2 -W 2 "${NEW_HOST}" &>/dev/null; then
+        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
+            spin_warn "Auth failed — verify share name and credentials on the PC"
+        fi
+    else
+        spin_warn "${NEW_HOST} not reachable — config saved, will retry at runtime"
+    fi
+    echo ""
+}
+
+# ─────────────────────────────────────────────────────────────────────────────
+CMD="${1:-help}"
+shift || true
+
+case "$CMD" in
+
+# ── System diagnostic ─────────────────────────────────────────────────────────
+status|check|diag)
+    exec "${PYTHON}" "${INSTALL_DIR}/debugger.py" "$@"
+    ;;
+
+# ── Live logs ─────────────────────────────────────────────────────────────────
+logs)
+    exec journalctl -u plc_watcher -u plc_web -f --no-pager
+    ;;
+
+# ── Service control ───────────────────────────────────────────────────────────
+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
+    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
+    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 ─────────────────────────────────────────────────────────────────
+queue)
+    banner "SMB Delivery Queue"
+    echo ""
+    QUEUE="${INSTALL_DIR}/delivery_queue.json"
+    LEDGER="${INSTALL_DIR}/delivery_sent.log"
+    if [[ -f "$QUEUE" ]]; then
+        COUNT=$(python3 -c "import json; d=json.load(open('$QUEUE')); print(len(d))" 2>/dev/null || echo 0)
+        if [[ "$COUNT" -eq 0 ]]; then
+            ok "Queue empty — all reports delivered"
+        else
+            warn "${COUNT} file(s) pending delivery:"
+            python3 -m json.tool "$QUEUE" 2>/dev/null
+        fi
+    else
+        ok "Queue empty"
+    fi
+    echo ""
+    if [[ -f "$LEDGER" ]]; then
+        SENT=$(wc -l < "$LEDGER")
+        ok "Delivery ledger: ${SENT} file(s) sent"
+        sed 's/^/     /' "$LEDGER"
+    else
+        info "No deliveries recorded yet"
+    fi
+    echo ""
+    ;;
+
+# ── Push test ─────────────────────────────────────────────────────────────────
+push-test)
+    banner "SMB Push Test"
+    echo ""
+    LATEST=$(ls -t /home/pi/reports/*.pdf 2>/dev/null | head -1 || true)
+    if [[ -z "$LATEST" ]]; then
+        info "No PDFs found — generating one from PLC..."
+        "${PYTHON}" "${INSTALL_DIR}/plc_report.py"
+        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")"
+    echo ""
+    "${PYTHON}" -c "
+import sys, os
+sys.path.insert(0, '${INSTALL_DIR}')
+from pdf_push import _push_smb, _already_sent, _record_sent
+fname = os.path.basename('$LATEST')
+if _already_sent(fname):
+    print(f'  Already delivered: {fname}')
+    print('  Delete the ledger entry to re-test:')
+    print(f'  sed -i \"/{fname}/d\" ${INSTALL_DIR}/delivery_sent.log')
+    sys.exit(0)
+ok = _push_smb('$LATEST')
+if ok:
+    _record_sent(fname)
+sys.exit(0 if ok else 1)
+"
+    ;;
+
+# ─────────────────────────────────────────────────────────────────────────────
+# WIFI — scan + switch network
+# ─────────────────────────────────────────────────────────────────────────────
+wifi)
+    SUBCMD="${1:-scan}"
+    shift || true
+
+    case "$SUBCMD" in
+    scan|"")
+        banner "WiFi Networks"
+        echo ""
+
+        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 \
+            | awk -F: '$1!=""' \
+            | sort -t: -k2 -rn \
+            | awk -F: '!seen[$1]++'
+        )
+
+        [[ ${#RAW[@]} -eq 0 ]] && { warn "No networks found."; exit 0; }
+
+        echo ""
+        hr
+        printf "  ${B}%-4s %-28s %-8s %-10s %s${NC}\n" "#" "SSID" "Signal" "Security" ""
+        hr
+        declare -a SSIDS
+        for i in "${!RAW[@]}"; do
+            IFS=':' read -r SSID SIGNAL SECURITY INUSE <<< "${RAW[$i]}"
+            SSIDS[$i]="$SSID"
+            SIG="${SIGNAL:-0}"
+            if   [[ $SIG -ge 80 ]]; then BAR="${G}▂▄▆█${NC}"
+            elif [[ $SIG -ge 60 ]]; then BAR="${G}▂▄▆ ${NC}"
+            elif [[ $SIG -ge 40 ]]; then BAR="${Y}▂▄  ${NC}"
+            else                         BAR="${R}▂   ${NC}"; fi
+            ACTIVE=""
+            [[ "$INUSE" == "*" ]] && ACTIVE="${G} ← connected${NC}"
+            printf "  %-4s %-28s %b  %3s%%  %-10s%b\n" \
+                "$((i+1)))" "$SSID" "$BAR" "$SIG" "${SECURITY:---}" "$ACTIVE"
+        done
+        hr
+        printf "  %-4s %s\n" "0)" "Cancel"
+        echo ""
+
+        while true; do
+            read -r -p "  Choose network [1-${#RAW[@]}] or 0 to cancel: " CHOICE </dev/tty
+            [[ "$CHOICE" =~ ^[0-9]+$ ]] && \
+                [[ "$CHOICE" -ge 0 && "$CHOICE" -le "${#RAW[@]}" ]] && break
+            echo -e "  ${R}Enter a number 0–${#RAW[@]}${NC}"
+        done
+        [[ "$CHOICE" -eq 0 ]] && exit 0
+
+        SEL="${SSIDS[$((CHOICE-1))]}"
+        echo ""
+        read -r -s -p "  Password for '${SEL}' (blank if open): " WIFI_PASS </dev/tty
+        echo ""; echo ""
+
+        need_sudo
+        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" \
+                ssid "$SEL" wifi-sec.key-mgmt wpa-psk wifi-sec.psk "$WIFI_PASS" \
+                connection.autoconnect yes connection.autoconnect-priority 200 \
+                2>/dev/null
+        else
+            sudo nmcli connection add type wifi ifname wlan0 con-name "$SEL" \
+                ssid "$SEL" connection.autoconnect yes \
+                connection.autoconnect-priority 200 2>/dev/null
+        fi
+
+        spin_start "Connecting to '${SEL}'"
+        if sudo nmcli connection up "$SEL" 2>/dev/null; then
+            sleep 2
+            NEW_IP=$(ip -4 addr show wlan0 2>/dev/null | grep -oP '(?<=inet )\d+\.\d+\.\d+\.\d+' || echo "")
+            spin_ok "Connected"
+            [[ -n "$NEW_IP" ]] && ok "Pi IP: ${NEW_IP}  →  http://${NEW_IP}:8080"
+
+            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}"
+            [[ "${CONFIRM^^}" == "Y" ]] && \
+                prompt_smb_config "Network changed to '${SEL}'  (Pi IP: ${NEW_IP:-unknown})"
+        else
+            spin_warn "Could not connect — check password and try again"
+        fi
+        ;;
+
+    *)
+        echo "Usage: plc_checkweigher wifi [scan]"
+        ;;
+    esac
+    ;;
+
+# ─────────────────────────────────────────────────────────────────────────────
+# HOTSPOT — AP mode for direct PC connection + SMB push
+# ─────────────────────────────────────────────────────────────────────────────
+hotspot)
+    SUBCMD="${1:-status}"
+    shift || true
+    HOTSPOT_SSID="${HOTSPOT_SSID:-PLC-Reports}"
+    HOTSPOT_PASS="${HOTSPOT_PASS:-plcreport}"
+    HOTSPOT_CON="plc-hotspot"
+
+    case "$SUBCMD" in
+    on)
+        banner "Enable Hotspot"
+        need_sudo
+        echo ""
+        [[ -n "${1:-}" ]] && HOTSPOT_SSID="$1"
+        [[ -n "${2:-}" ]] && HOTSPOT_PASS="$2"
+
+        sudo nmcli connection delete "$HOTSPOT_CON" 2>/dev/null || true
+
+        spin_start "Starting hotspot '${HOTSPOT_SSID}'"
+        sudo nmcli device wifi hotspot \
+            ifname wlan0 con-name "$HOTSPOT_CON" \
+            ssid "$HOTSPOT_SSID" password "$HOTSPOT_PASS" &>/dev/null || true
+        sleep 2
+        spin_ok "Hotspot active"
+
+        HOTSPOT_IP=$(ip -4 addr show wlan0 2>/dev/null \
+            | grep -oP '(?<=inet )\d+\.\d+\.\d+\.\d+' || echo "10.42.0.1")
+
+        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" "Password:" "$HOTSPOT_PASS"
+        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 "Web UI still accessible at:  http://${HOTSPOT_IP}:8080"
+        echo ""
+        ;;
+
+    off)
+        banner "Disable Hotspot"
+        need_sudo
+        echo ""
+        spin_start "Stopping hotspot"
+        sudo nmcli connection delete "$HOTSPOT_CON" 2>/dev/null \
+            && spin_ok \
+            || spin_warn "No active hotspot found"
+        echo ""
+        info "To reconnect to WiFi:  plc_checkweigher wifi"
+        echo ""
+        ;;
+
+    status)
+        banner "Hotspot Status"
+        echo ""
+        if nmcli connection show --active 2>/dev/null | grep -q "$HOTSPOT_CON"; then
+            HOTSPOT_IP=$(ip -4 addr show wlan0 2>/dev/null \
+                | grep -oP '(?<=inet )\d+\.\d+\.\d+\.\d+' || echo "?")
+            ok "Hotspot is ON"
+            info "SSID: ${HOTSPOT_SSID}  |  Pi IP: ${HOTSPOT_IP}"
+            info "Run: plc_checkweigher hotspot scan  — to find connected PCs"
+        else
+            info "Hotspot is OFF"
+            info "Run: plc_checkweigher hotspot on  — to start"
+        fi
+        echo ""
+        ;;
+
+    scan)
+        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 "Sweeping ${SUBNET} ..."
+        echo ""
+
+        # 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"
+
+        mapfile -t CLIENTS < <(
+            ip neigh show 2>/dev/null \
+            | grep "REACHABLE\|STALE\|DELAY" \
+            | grep "${HOTSPOT_IP%.*}\." \
+            | grep -v "^${HOTSPOT_IP}" \
+            | awk '{print $1}' \
+            | sort -t. -k4 -n
+        )
+
+        if [[ ${#CLIENTS[@]} -eq 0 ]]; then
+            echo ""
+            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 ""
+        hr
+        printf "  ${B}%-4s %-18s %s${NC}\n" "#" "IP Address" "Hostname"
+        hr
+        declare -a CLIENT_IPS
+        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 "")
+            printf "  %-4s %-18s %s\n" "$((i+1)))" "$IP" "${HOST:-(unknown)}"
+        done
+        hr
+        printf "  %-4s %s\n" "0)" "Cancel"
+        echo ""
+
+        while true; do
+            read -r -p "  Set device as SMB target [1-${#CLIENTS[@]}] or 0 to cancel: " CHOICE </dev/tty
+            [[ "$CHOICE" =~ ^[0-9]+$ ]] && \
+                [[ "$CHOICE" -ge 0 && "$CHOICE" -le "${#CLIENTS[@]}" ]] && break
+        done
+        [[ "$CHOICE" -eq 0 ]] && exit 0
+
+        TARGET_IP="${CLIENT_IPS[$((CHOICE-1))]}"
+        echo ""
+        info "Selected: ${TARGET_IP}"
+        prompt_smb_config "Setting SMB target to hotspot client ${TARGET_IP}"
+        ;;
+
+    *)
+        echo "Usage: plc_checkweigher hotspot [on|off|status|scan]"
+        echo "  on [SSID] [PASSWORD]  — start hotspot (default: PLC-Reports / plcreport)"
+        echo "  off                   — stop hotspot"
+        echo "  status                — show hotspot state"
+        echo "  scan                  — find connected PCs and set as SMB target"
+        ;;
+    esac
+    ;;
+
+# ─────────────────────────────────────────────────────────────────────────────
+# DISPLAY — enable / disable LightDM
+# ─────────────────────────────────────────────────────────────────────────────
+display)
+    SUBCMD="${1:-status}"
+    shift || true
+
+    case "$SUBCMD" in
+    on)
+        banner "Enable Display"
+        need_sudo
+        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
+        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
+            sudo systemctl disable lightdm 2>/dev/null && ok "Auto-start disabled" || true
+        fi
+        echo ""
+        ;;
+    status)
+        banner "Display Status"
+        echo ""
+        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
+        if command -v tvservice &>/dev/null; then
+            info "HDMI: $(tvservice -s 2>/dev/null | head -1)"
+        fi
+        echo ""
+        ;;
+    *)
+        echo "Usage: plc_checkweigher display [on|off|status]"
+        ;;
+    esac
+    ;;
+
+# ─────────────────────────────────────────────────────────────────────────────
+# SMB CONFIG — interactive update of delivery target
+# ─────────────────────────────────────────────────────────────────────────────
+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
+# ─────────────────────────────────────────────────────────────────────────────
+help|--help|-h)
+    echo ""
+    echo -e "${B}  plc_checkweigher${NC} — PLC Check-Weigher system CLI"
+    echo ""
+    echo -e "  ${W}Diagnostics${NC}"
+    echo "    status                     Full system diagnostic — all checks + fix hints"
+    echo "    logs                       Stream live logs (plc_watcher + plc_web)"
+    echo "    queue                      Show SMB pending queue and delivery ledger"
+    echo ""
+    echo -e "  ${W}Services${NC}"
+    echo "    start                      Start plc_watcher and plc_web"
+    echo "    stop                       Stop both services"
+    echo "    restart                    Restart both services"
+    echo ""
+    echo -e "  ${W}Network${NC}"
+    echo "    wifi                       Scan and switch WiFi network"
+    echo "    hotspot on  [SSID] [PASS]  Start WiFi hotspot (direct PC connection)"
+    echo "    hotspot off                Stop hotspot"
+    echo "    hotspot status             Show hotspot state"
+    echo "    hotspot scan               Detect connected PCs → set as SMB target"
+    echo ""
+    echo -e "  ${W}Configuration${NC}"
+    echo "    smb-config                 Interactively update SMB delivery target"
+    echo "    push-test                  Push latest PDF to SMB target now"
+    echo ""
+    echo -e "  ${W}Display${NC}"
+    echo "    display on                 Enable display (start LightDM)"
+    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 ""
+    ;;
+
+*)
+    err "Unknown command: $CMD"
+    echo "  Run: plc_checkweigher help"
+    exit 1
+    ;;
+
+esac

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plc-checkweigher",
-  "version": "1.6.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/setup.sh

@@ -136,6 +136,21 @@ setup_dirs() {
     ok "${REPORTS_DIR}"
 }
 
+# ── CLI tool — install plc_checkweigher command ───────────────────────────────
+install_cli() {
+    step "CLI tool ..."
+    CLI_SRC="${INSTALL_DIR}/bin/plc_checkweigher"
+    CLI_DEST="/usr/local/bin/plc_checkweigher"
+    if [[ -f "${CLI_SRC}" ]]; then
+        chmod +x "${CLI_SRC}"
+        cp "${CLI_SRC}" "${CLI_DEST}"
+        ok "plc_checkweigher  →  ${CLI_DEST}"
+        ok "Run: plc_checkweigher status   (full system diagnostic)"
+    else
+        warn "bin/plc_checkweigher not found — skipping CLI install"
+    fi
+}
+
 # ── 5. WiFi — scan → pick → password ─────────────────────────────────────────
 setup_wifi() {
     step "WiFi Setup"
@@ -601,10 +616,11 @@ main() {
     setup_repo                # 2
     setup_venv                # 3
     setup_dirs                # 4
-    setup_wifi                # 5  — interactive WiFi picker
-    setup_smb                 # 6  — interactive SMB config → smb_config.py
-    setup_network_online      # 7
-    install_services          # 8
+    install_cli               # 5  — plc_checkweigher status command
+    setup_wifi                # 6  — interactive WiFi picker
+    setup_smb                 # 7  — interactive SMB config → smb_config.py
+    setup_network_online      # 8
+    install_services          # 9
     setup_boot_logo           # 9  — Plymouth: logo + "SAI SAMARTH ENGG"
     setup_display             # 10 — LightDM priority, CPU isolation, utmpx, GPU
     install_rt_kernel         # 11 — LAST, so only one reboot needed

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