docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates

- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>

scripts/setup.sh

@@ -1,11 +1,15 @@
 #!/bin/bash
+set -euo pipefail
+
 # Setup script for Proxmox MCP Server and workspace
 
 set -e
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 ENV_FILE="$HOME/.env"
-ENV_EXAMPLE="$SCRIPT_DIR/.env.example"
+ENV_EXAMPLE="$PROJECT_ROOT/.env.example"
+ENV_REPO="$PROJECT_ROOT/.env"
 CLAUDE_CONFIG_DIR="$HOME/.config/Claude"
 CLAUDE_CONFIG="$CLAUDE_CONFIG_DIR/claude_desktop_config.json"
 CLAUDE_CONFIG_EXAMPLE="$SCRIPT_DIR/claude_desktop_config.json.example"
@@ -14,16 +18,28 @@ echo "🚀 Proxmox MCP Server Setup"
 echo "============================"
 echo ""
 
-# Step 1: Check if .env exists
-if [ ! -f "$ENV_FILE" ]; then
-    echo "📝 Creating .env file from template..."
-    if [ -f "$ENV_EXAMPLE" ]; then
+# Step 1: Ensure .env exists (repo root and/or ~/.env)
+# Many scripts source PROJECT_ROOT/.env; load-env.sh and some scripts use ~/.env
+if [ -f "$ENV_EXAMPLE" ]; then
+    if [ ! -f "$ENV_REPO" ]; then
+        echo "📝 Creating repo root .env from template..."
+        cp "$ENV_EXAMPLE" "$ENV_REPO"
+        echo "✅ Created $ENV_REPO"
+    else
+        echo "✅ Repo root .env already exists at $ENV_REPO"
+    fi
+    if [ ! -f "$ENV_FILE" ]; then
+        echo "📝 Creating ~/.env from template..."
         cp "$ENV_EXAMPLE" "$ENV_FILE"
         echo "✅ Created $ENV_FILE"
-        echo "⚠️  Please edit $ENV_FILE and add your Proxmox credentials!"
     else
-        # Create .env file directly if template doesn't exist
-        echo "📝 Creating .env file directly..."
+        echo "✅ ~/.env already exists at $ENV_FILE"
+    fi
+    echo "⚠️  Edit $ENV_REPO and/or $ENV_FILE with your credentials (Proxmox, Cloudflare, NPM, etc.)"
+else
+    # Fallback: create minimal ~/.env if no template
+    if [ ! -f "$ENV_FILE" ]; then
+        echo "📝 Creating minimal ~/.env (no template found at $ENV_EXAMPLE)..."
         cat > "$ENV_FILE" << 'EOF'
 # Proxmox MCP Server Configuration
 # Fill in your actual values below
@@ -44,8 +60,6 @@ EOF
         echo "✅ Created $ENV_FILE"
         echo "⚠️  Please edit $ENV_FILE and add your Proxmox credentials!"
     fi
-else
-    echo "✅ .env file already exists at $ENV_FILE"
 fi
 
 # Step 2: Setup Claude Desktop config
@@ -77,7 +91,7 @@ fi
 # Step 3: Install dependencies
 echo ""
 echo "📦 Installing workspace dependencies..."
-cd "$SCRIPT_DIR"
+cd "$PROJECT_ROOT"
 pnpm install
 
 echo ""