plc-checkweigher 1.6.0 → 1.7.0

package/bin/plc_checkweigher

@@ -0,0 +1,582 @@
+#!/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
+
+INSTALL_DIR="/home/pi/plc_checkweigher"
+PYTHON="/home/pi/plc_env/bin/python3"
+SMB_CFG="${INSTALL_DIR}/smb_config.py"
+
+# ── 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}"; }
+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
+    fi
+}
+
+# ── Read current SMB config ───────────────────────────────────────────────────
+smb_get() {
+    local key="$1"
+    grep "^${key}" "${SMB_CFG}" 2>/dev/null \
+        | head -1 | sed 's/.*= *"//;s/".*//'
+}
+
+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}"
+    fi
+}
+
+# ── SMB config update prompt (reused by wifi + smb-config) ───────────────────
+prompt_smb_config() {
+    local context="${1:-}"
+    echo ""
+    banner "Update SMB Delivery Config"
+    [[ -n "$context" ]] && info "$context"
+    echo ""
+
+    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)}"
+    hr
+    echo ""
+
+    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     (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}"
+SMB_SHARE    = "${NEW_SHARE}"
+SMB_USERNAME = "${NEW_USER}"
+SMB_PASSWORD = "${NEW_PASS}"
+SMB_SUBDIR   = ""
+EOF
+
+    echo ""
+    ok "smb_config.py updated"
+    info "Host: ${NEW_HOST}  |  Share: //${NEW_HOST}/${NEW_SHARE}  |  User: ${NEW_USER}"
+
+    # Quick connectivity test
+    echo ""
+    echo -n "  Testing connection ..."
+    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"
+        else
+            warn "SMB 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"
+    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"
+    sudo systemctl restart plc_watcher plc_web
+    sleep 2
+    systemctl status plc_watcher plc_web --no-pager | grep -E 'Active|Main PID'
+    ;;
+start)
+    need_sudo
+    banner "Starting services"
+    sudo systemctl start plc_watcher plc_web
+    ok "plc_watcher and plc_web started"
+    ;;
+stop)
+    need_sudo
+    banner "Stopping services"
+    sudo systemctl stop plc_watcher plc_web
+    warn "Services stopped — they will restart automatically on next boot"
+    warn "To disable auto-start: sudo systemctl disable plc_watcher plc_web"
+    ;;
+
+# ── 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"
+        cat "$LEDGER" | sed 's/^/     /'
+    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 ""
+        info "Scanning ..."
+        nmcli dev wifi rescan ifname wlan0 2>/dev/null || true
+        sleep 2
+
+        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
+        # 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" \
+                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
+
+        echo -n "  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"
+
+            # 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
+                prompt_smb_config "Network changed to '${SEL}'  (Pi IP: ${NEW_IP:-unknown})"
+            fi
+        else
+            echo ""
+            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 ""
+
+        # 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 ..."
+        sudo nmcli device wifi hotspot \
+            ifname wlan0 \
+            con-name "$HOTSPOT_CON" \
+            ssid "$HOTSPOT_SSID" \
+            password "$HOTSPOT_PASS" 2>&1 | grep -v "^$" || true
+
+        sleep 2
+
+        # 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" "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 "  — detects PC's IP and updates SMB config automatically"
+        echo ""
+        info "Web UI still accessible at:  http://${HOTSPOT_IP}:8080"
+        echo ""
+        ;;
+
+    off)
+        banner "Disable Hotspot"
+        need_sudo
+        sudo nmcli connection delete "$HOTSPOT_CON" 2>/dev/null \
+            && ok "Hotspot stopped" \
+            || 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)
+        # 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} ..."
+
+        # Refresh ARP table by pinging the subnet
+        for i in $(seq 1 254); do
+            ping -c 1 -W 1 "${HOTSPOT_IP%.*}.${i}" &>/dev/null &
+        done
+        wait
+        sleep 1
+
+        # Collect clients (exclude Pi itself)
+        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
+            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
+        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
+        sudo systemctl start lightdm 2>/dev/null \
+            && ok "Display enabled — LightDM started" \
+            || warn "LightDM failed to start (may not be installed)"
+        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"
+        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 || echo "inactive")
+        ENABLED=$(systemctl is-enabled lightdm 2>/dev/null || echo "disabled")
+        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}"
+        fi
+        echo ""
+        ;;
+    *)
+        echo "Usage: plc_checkweigher display [on|off|status]"
+        ;;
+    esac
+    ;;
+
+# ─────────────────────────────────────────────────────────────────────────────
+# SMB CONFIG — interactive update of delivery target
+# ─────────────────────────────────────────────────────────────────────────────
+smb-config)
+    prompt_smb_config
+    ;;
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 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 ""
+    ;;
+
+*)
+    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.7.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"

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