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>

README.md

@@ -49,10 +49,13 @@ This will:
 
 4. **Configure environment**:
    ```bash
-   # Copy .env template
-   cp .env.example ~/.env
-   # Edit with your Proxmox credentials
-   nano ~/.env
+   # Recommended: run setup to create .env in repo root and ~/.env from .env.example
+   ./scripts/setup.sh
+   # Or manually: copy template to repo root and/or home
+   cp .env.example .env
+   # and/or: cp .env.example ~/.env
+   # Edit with your Proxmox, Cloudflare, NPM credentials (see .env.example)
+   nano .env
    ```
 
 5. **Configure Claude Desktop**:
@@ -91,6 +94,13 @@ From the root directory, you can run:
 - `pnpm test:basic` - Run basic MCP server tests (read-only operations)
 - `pnpm test:workflows` - Run comprehensive workflow tests (requires elevated permissions)
 
+### UniFi Commands
+
+- `pnpm unifi:build` - Build UniFi API and MCP server packages
+- `pnpm unifi:start` - Start the UniFi MCP server
+- `pnpm unifi:dev` - Start the UniFi MCP server in development mode
+- `pnpm unifi:cli` - Run UniFi CLI tool
+
 ## RPC Node Health, Testing, and Remediation (Chain 138)
 
 This repo includes scripts to **test all RPC nodes**, **audit Proxmox storage restrictions**, and **enforce safe Besu heap sizing** to prevent swap/IO thrash.
@@ -153,6 +163,23 @@ A Next.js frontend for browsing and managing Proxmox helper scripts.
 
 See [ProxmoxVE/frontend/README.md](docs/01-getting-started/README.md) for more information.
 
+### unifi-api & mcp-unifi-server
+
+UniFi API client library and MCP server for managing Ubiquiti UniFi/UDM Pro devices.
+
+**Features:**
+- Type-safe API client with full TypeScript support
+- Dual API mode support (Official Local API and Private Controller API)
+- MCP server for Claude Desktop integration
+- CLI tool for common operations
+- Utility scripts for monitoring and health checks
+
+See [unifi-api/README.md](unifi-api/README.md) for API client documentation.
+See [mcp-unifi/README.md](mcp-unifi/README.md) for MCP server documentation.
+
+**Configuration:**
+See [docs/04-configuration/UNIFI_API_SETUP.md](docs/04-configuration/UNIFI_API_SETUP.md) for setup instructions.
+
 ## Environment Configuration
 
 ### MCP Server Configuration
@@ -218,6 +245,17 @@ proxmox/
 
 See [PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md) for detailed structure documentation.
 
+## How to Navigate This Repo
+
+**New to this repository?** Start here:
+
+- **[ROOT_INDEX.md](ROOT_INDEX.md)** - Quick navigation index for newcomers and auditors
+- **[DIRECTORY_REFERENCE.md](DIRECTORY_REFERENCE.md)** - Complete directory structure and organization guide
+- **[docs/MASTER_INDEX.md](docs/MASTER_INDEX.md)** - Documentation index (deployment, architecture, services)
+- **[PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md)** - Project and docs structure
+
+**Organization principles:** This repository uses a **flat + indexed** structure. The three-layer separation (control plane / core systems / ops evidence) is a **mental model**, not an enforced structure. See [docs/MASTER_INDEX.md](docs/MASTER_INDEX.md) and [PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md) for structure and intent.
+
 ## Project Documentation
 
 ### Setup & Configuration
@@ -226,15 +264,23 @@ See [PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md) for detailed structure document
 - [docs/ENV_STANDARDIZATION.md](docs/04-configuration/ENV_STANDARDIZATION.md) - Environment variable standardization
 
 ### Quick References
-- [docs/QUICK_REFERENCE.md](docs/QUICK_REFERENCE.md) - Quick reference for ProxmoxVE scripts
-- [docs/README_START_HERE.md](docs/01-getting-started/README_START_HERE.md) - Getting started guide
+- [docs/12-quick-reference/QUICK_REFERENCE.md](docs/12-quick-reference/QUICK_REFERENCE.md) - Quick reference for ProxmoxVE scripts
+- [docs/12-quick-reference/QUICK_REFERENCE_CARDS.md](docs/12-quick-reference/QUICK_REFERENCE_CARDS.md) - Network, VMID, commands, troubleshooting cards
+- [docs/01-getting-started/README_START_HERE.md](docs/01-getting-started/README_START_HERE.md) - Getting started guide
 
 ### Deployment
-- [docs/DEPLOYMENT_VALIDATION_REPORT.md](docs/DEPLOYMENT_VALIDATION_REPORT.md) - Deployment validation for ml110-01
+- [docs/03-deployment/DEPLOYMENT_STATUS_CONSOLIDATED.md](docs/03-deployment/DEPLOYMENT_STATUS_CONSOLIDATED.md) - Deployment status
+- [docs/03-deployment/DEPLOYMENT_READINESS.md](docs/03-deployment/DEPLOYMENT_READINESS.md) - Deployment readiness checklist
+- **Next steps (master list):** [docs/00-meta/NEXT_STEPS_MASTER.md](docs/00-meta/NEXT_STEPS_MASTER.md)
+- **CCIP WETH9 Bridge (Chain 138):** `./scripts/deploy-and-configure-weth9-bridge-chain138.sh` (use `--dry-run` to simulate) then set `CCIPWETH9_BRIDGE_CHAIN138`; see [COMPREHENSIVE_STATUS_BRIDGE_READY.md](COMPREHENSIVE_STATUS_BRIDGE_READY.md), [docs/07-ccip/README.md](docs/07-ccip/README.md), [scripts/README.md](scripts/README.md)
 
 ### Project Documentation
-- [mcp-proxmox/README.md](docs/01-getting-started/README.md) - MCP Server detailed documentation
-- [ProxmoxVE/README.md](docs/01-getting-started/README.md) - ProxmoxVE scripts documentation
+- [mcp-proxmox/README.md](mcp-proxmox/README.md) - MCP Server detailed documentation
+- [ProxmoxVE/README.md](ProxmoxVE/README.md) - ProxmoxVE scripts documentation
+
+### Multi-Chain Integration
+- [ALL Mainnet Integration](ALL_MAINNET_MASTER_DOCUMENTATION.md) - Complete ALL Mainnet (651940) integration guide
+- [ALL Mainnet Master Documentation](ALL_MAINNET_MASTER_DOCUMENTATION.md) - Quick reference for ALL Mainnet configuration
 
 ## Deployment Status
 
@@ -253,7 +299,7 @@ cd smom-dbis-138-proxmox
 sudo ./scripts/deployment/deploy-all.sh
 ```
 
-See [docs/DEPLOYMENT_READINESS.md](docs/DEPLOYMENT_READINESS.md) for complete deployment guide.
+See [docs/03-deployment/DEPLOYMENT_READINESS.md](docs/03-deployment/DEPLOYMENT_READINESS.md) for complete deployment guide.
 
 ## Validation