chore: sync all changes to Gitea

- Config, docs, scripts, and backup manifests
- Submodule refs unchanged (m = modified content in submodules)

Made-with: Cursor

scripts/monitoring/monitor-blockchain-health.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Comprehensive Blockchain Health Monitoring Script
 # Monitors block production, transaction inclusion, and node health
 
@@ -61,6 +61,12 @@ if [ "$BLOCK_DIFF" -gt 0 ]; then
     log_success "Blocks being produced ($BLOCK_DIFF blocks in 5s)"
 else
     log_error "Block production stalled (no new blocks in 5s)"
+    # If validators are all active, they may still be syncing (QBFT does not produce until sync completes)
+    SYNC_HINT=$(ssh -o ConnectTimeout=3 -o StrictHostKeyChecking=no "${PROXMOX_USER}@${PROXMOX_R630}" \
+        "pct exec 1000 -- journalctl -u besu-validator --no-pager -n 30 2>/dev/null" 2>/dev/null | grep -c "Full sync\|initial sync in progress\|QBFT mining coordinator not starting" || true)
+    if [ "${SYNC_HINT:-0}" -gt 0 ]; then
+        echo "  → Validators may be syncing; block production will resume when sync completes (see docs/06-besu/CRITICAL_ISSUE_BLOCK_PRODUCTION_STOPPED.md)."
+    fi
 fi
 
 # Check transaction inclusion
@@ -145,6 +151,10 @@ ISSUES=0
 if [ "$BLOCK_DIFF" -eq 0 ]; then
     log_error "❌ Block production stalled"
     ISSUES=$((ISSUES + 1))
+    # Hint when validators are syncing (all active but no new blocks yet)
+    if [ "$ACTIVE_COUNT" -eq 5 ]; then
+        echo "   (If validators recently restarted: they are likely in full sync; blocks will resume when sync completes.)"
+    fi
 else
     log_success "✓ Block production active"
 fi

scripts/monitoring/simple-alert.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Simple Alert Script
 # Sends alerts when Besu services are down
 # Can be extended to send email, Slack, etc.