chore: update submodule references and documentation

- Marked submodules ai-mcp-pmm-controller, explorer-monorepo, and smom-dbis-138 as dirty to reflect recent changes.
- Updated documentation to clarify operator script usage, including dotenv loading and task execution instructions.
- Enhanced the README and various index files to provide clearer navigation and task completion guidance.

Made-with: Cursor

docs/OPTIONAL_RECOMMENDATIONS_INDEX.md

@@ -1,6 +1,6 @@
 # Optional, Recommendations, and Suggestions — Master Index
 
-**Last Updated:** 2026-03-01  
+**Last Updated:** 2026-02-27  
 **Purpose:** Single entry point for all optional tasks, recommendations, and suggestions across the repo.
 
 ---
@@ -10,6 +10,7 @@
 | Document | Description |
 |----------|-------------|
 | **[00-meta/COMPLETE_REQUIRED_OPTIONAL_RECOMMENDED_INDEX.md](00-meta/COMPLETE_REQUIRED_OPTIONAL_RECOMMENDED_INDEX.md)** | **Full plan — required, optional, recommended (Wave 0–3, execution order)** |
+| **[00-meta/OPTIONAL_TASKS_CHECKLIST.md](00-meta/OPTIONAL_TASKS_CHECKLIST.md)** | **Consolidated optional tasks checklist (Done / Pending / Operator-only)** |
 | **[00-meta/ALL_RECOMMENDATIONS_AND_IMPROVEMENTS_LIST.md](00-meta/ALL_RECOMMENDATIONS_AND_IMPROVEMENTS_LIST.md)** | **Canonical list — all recommendations/gaps 1–139 (20 sections)** |
 | **[00-meta/ALL_RECOMMENDATIONS_HIGH_PRIORITY.md](00-meta/ALL_RECOMMENDATIONS_HIGH_PRIORITY.md)** | High-priority only (filtered view) |
 | **[00-meta/ALL_RECOMMENDATIONS_OPERATOR_ONLY.md](00-meta/ALL_RECOMMENDATIONS_OPERATOR_ONLY.md)** | Operator-only checklist (LAN/Proxmox) |
@@ -35,6 +36,7 @@
 | Quick Wins (secure .env, backup, metrics, snapshots, health check) | IMPLEMENTATION_CHECKLIST | ✅ Marked complete |
 | TransactionMirror + DODO pool Chain 138 (nonce-fix deploy, .env, frontend config) | smom-dbis-138/.env, frontend-dapp contracts.ts, CONTRACT_DEPLOYMENT_RUNBOOK, RPC_2101_READONLY_FIX | ✅ Done — 0x7131F887DBEEb2e44c1Ed267D2A68b5b83285afc; chain138.TRANSACTION_MIRROR in contracts.ts |
 | Optional batch (2026-02-27 / 2026-03-01) | DeployCompliantFiatTokens (10 tokens); MCP allowlist-138; add-liquidity runbook; token-aggregation fallbacks; ENV_EXAMPLE; E2E routing verify; PMM/REQUIRED_FIXES docs; cCADT (commented) in script | ✅ Done — see TODOS_CONSOLIDATED, PMM_DEX_ROUTING_STATUS |
+| MCP plan upgrades (all 8 additional recommendations) | ai-mcp-pmm-controller, docs/03-deployment/MCP_AI_POOL_MANAGEMENT_PLAN_UPGRADES.md | ✅ Done — multi-chain allowlist + RPC by chain; Uniswap get_pool_state; GET /bot_state + dodo.get_bot_state; POST /webhook/trigger; merge-mcp-allowlist-multichain.sh; rate limits/cooldown/gas caps; audit log; dodo.get_router_quote stub. See §5.1 Implementation status. |
 
 ---
 
@@ -65,6 +67,7 @@
 | `scripts/utils/retry_with_backoff.sh` | Retry command with exponential backoff (source or run) |
 | `scripts/utils/dry-run-example.sh` | Example `DRY_RUN` / `--dry-run` pattern for scripts |
 | `scripts/validation/validate-config-files.sh` | Validate required config files and optional env (set `VALIDATE_REQUIRED_FILES`) |
+| `scripts/merge-mcp-allowlist-multichain.sh` | Merge Chain 138 + per-chain allowlists into one multi-chain allowlist for MCP |
 
 ---
 
@@ -73,9 +76,10 @@
 To add a Wallet link to the Blockscout/explorer navbar (e.g. on VMID 5000):
 
 1. SSH to the explorer VM.
-2. Edit the main HTML (e.g. `/var/www/html/index.html`).
+2. Edit the main HTML or Blockscout nav (e.g. `/var/www/html/index.html`).
 3. Add in the nav: `<a href="/wallet">Wallet</a>`.
 
+**Runbook (step-by-step):** [EXPLORER_WALLET_LINK_QUICK_WIN.md](04-configuration/EXPLORER_WALLET_LINK_QUICK_WIN.md).  
 **See:** [REMAINING_TASKS.md](REMAINING_TASKS.md) § Quick Wins.
 
 ---