proxmox/docs/archive/00-meta-pruned/MASTER_DOCUMENTATION_REVIEW_20260205.md

# Master Documentation Review — Inconsistencies and Gaps (2026-02-05)

**Purpose:** Single review of all master docs for consistency with the canonical missing-containers list (2506, 2507, 2508 only) and with the SSH inventory (2026-02-05). Apply fixes so master docs stay aligned.

**2026-02-06 addendum:** Option B (RPC via Cloudflare Tunnel) reflected across MASTER_INDEX, NETWORK_CONFIGURATION_MASTER, CLOUDFLARE_ROUTING_MASTER, RPC_ENDPOINTS_MASTER, OPERATIONAL_RUNBOOKS, 05-network/README, docs/README, NETWORK_ARCHITECTURE, DNS_ENTRIES_COMPLETE_STATUS for consistency.

**Canonical source for missing VMIDs:** [03-deployment/MISSING_CONTAINERS_LIST.md](../../03-deployment/MISSING_CONTAINERS_LIST.md)

---

## 1. Inconsistencies Found

### 1.1 DEPLOYMENT_STATUS_MASTER.md

| Issue | Location | Current | Should be |
|-------|----------|---------|-----------|
| Besu RPC on ml110 | § Current Container Inventory — ml110 | "2500-2502, 2503-2508 (9 containers)" | 2503–2505 are on **r630-01** (besu-rpc-hybx-1/2/3). 2506–2508 are **missing**. ml110 has 2500–2502 and **2303–2308** (Ali/Luis/Putu RPC). |
| Running count ml110 | Same | "Running Containers (20)" | Adjust to match actual VMIDs (e.g. include 1504, 2303–2308; exclude 2503–2508 from ml110). |
| Hyperledger on r630-01 | § r630-01 — Stopped | "Hyperledger services: 5200, 6000, 6400" listed under **Stopped** | SSH review: 5200 (cacti-1), 6000 (fabric-1), 6400 (indy-1) are **running** on r630-01. Move to running or separate "Running (Hyperledger)" line. |
| Last Updated | Footer | 2026-01-15 | 2026-02-05; note "Container inventory reconciled with SSH review (see MISSING_CONTAINERS_LIST.md)." |

### 1.2 CHAIN138_AUTOMATION_SCRIPTS.md

| Issue | Location | Current | Should be |
|-------|----------|---------|-----------|
| Create containers | Step 1: Create Containers | "create all required containers … 1504, 2503-2508, 6201, other services" | Only **2506, 2507, 2508** need to be created. 1504, 2503–2505, 6201, etc. exist. Reference [MISSING_CONTAINERS_LIST.md](../../03-deployment/MISSING_CONTAINERS_LIST.md) as canonical. |

### 1.3 MASTER_INDEX.md

| Issue | Location | Current | Should be |
|-------|----------|---------|-----------|
| 03-deployment directory | § Directory Structure | MISSING_CONTAINERS_LIST.md and DEPLOYMENT_STATUS_MASTER.md not listed | Add both to 03-deployment/ so they are discoverable. |
| Deployment table | § Core docs table | DEPLOYMENT_STATUS_MASTER not in table | Add row for DEPLOYMENT_STATUS_MASTER and for MISSING_CONTAINERS_LIST (or reference under OPERATIONAL_RUNBOOKS). |

### 1.4 DEPLOYMENT_TODO_MASTER.md

| Issue | Location | Current | Should be |
|-------|----------|---------|-----------|
| Missing containers | — | Not mentioned | Add one line: "Missing containers: 3 only (2506, 2507, 2508) — see [MISSING_CONTAINERS_LIST.md](../../03-deployment/MISSING_CONTAINERS_LIST.md)." |
| Last Updated | Footer | 2026-01-15 | 2026-02-05 |

### 1.5 REMAINING_TASKS_NEXT_STEPS_PHASES_REVIEW.md

| Issue | Location | Current | Should be |
|-------|----------|---------|-----------|
| Wave 2 "missing containers" | § Execution order table | "missing containers" with no count or ref | Add "(3 VMIDs only: see [MISSING_CONTAINERS_LIST.md](../../03-deployment/MISSING_CONTAINERS_LIST.md))". |

### 1.6 REMAINING_TASKS_MASTER_20260201.md (reports)

| Issue | Location | Current | Should be |
|-------|----------|---------|-----------|
| Missing containers | Pending sections | Not mentioned | Optional: add "Missing containers: 3 (2506, 2507, 2508) — [MISSING_CONTAINERS_LIST.md](../../03-deployment/MISSING_CONTAINERS_LIST.md)." |

### 1.7 PHASES_AND_TASKS_MASTER.md

| Issue | Location | Current | Should be |
|-------|----------|---------|-----------|
| Missing containers | Phase 3 — CCIP Fleet | No mention of missing containers | Optional: add note "Missing containers (3 only): see [MISSING_CONTAINERS_LIST.md](../../03-deployment/MISSING_CONTAINERS_LIST.md)." so Phase 3 is aligned with MASTER_PLAN 3.2. |

---

## 2. Docs Already Consistent

- **MASTER_PLAN.md** — Phase 3.2: "3 only (2506, 2507, 2508)", links to MISSING_CONTAINERS_LIST. ✅  
- **NEXT_STEPS_MASTER.md** — Missing Containers section: "3 (2506, 2507, 2508)", single source of truth ref. ✅  
- **TODO_TASK_LIST_MASTER.md** — No duplicate missing list; references ALL_IMPROVEMENTS. ✅  
- **WAVE2_WAVE3_OPERATOR_CHECKLIST.md** — W2-6: "3 VMIDs only (2506, 2507, 2508)". ✅  
- **FULL_PARALLEL_EXECUTION_ORDER.md** — W2-6: same. ✅  
- **ALL_IMPROVEMENTS_AND_GAPS_INDEX.md** — Item 79: "3 missing (2506, 2507, 2508)". ✅  
- **MISSING_CONTAINERS_LIST.md** — Canonical header and single table. ✅  
- **OPERATIONAL_RUNBOOKS.md** — Links to MISSING_CONTAINERS_LIST. ✅  

---

## 3. Gaps (No Fix Required Here)

- **DEPLOYMENT_STATUS_CONSOLIDATED.md** vs **DEPLOYMENT_STATUS_MASTER.md** — Two status docs; MASTER is the one updated in this review. Consider one day consolidating or clearly labeling which is authoritative.
- **PHASES_AND_TASKS_MASTER** Phase 2 "Monitoring stack deployed" = full deploy; TODO_TASK_LIST_MASTER Phase 2 = config + runbook. Different granularity; acceptable.
- **RPC_ENDPOINTS_MASTER / ALL_VMIDS_ENDPOINTS** — 2506–2508 have IP/VMID mappings; some docs mark 2506–2508 as "Destroyed". For **creation** use MISSING_CONTAINERS_LIST; for **IP/port reference** keep RPC/VMID docs as-is.

---

## 4. Fixes Applied (checklist)

- [x] DEPLOYMENT_STATUS_MASTER: Updated ml110 inventory (2503–2508 → 2303–2308 + 2500–2502; note 2503–2505 on r630-01, 2506–2508 missing). Moved 5200, 6000, 6400 to running on r630-01. Updated date and reconciliation note.
- [x] CHAIN138_AUTOMATION_SCRIPTS: Step 1 "Create Containers" — only 2506, 2507, 2508; reference MISSING_CONTAINERS_LIST.
- [x] MASTER_INDEX: Added MISSING_CONTAINERS_LIST.md and DEPLOYMENT_STATUS_MASTER.md under 03-deployment/.
- [x] DEPLOYMENT_TODO_MASTER: Added missing-containers line and date.
- [x] REMAINING_TASKS_NEXT_STEPS_PHASES_REVIEW: Wave 2 added "(3 VMIDs only: see MISSING_CONTAINERS_LIST)".
- [x] REMAINING_TASKS_MASTER_20260201: Added missing-containers row. PHASES_AND_TASKS_MASTER Phase 3: added missing-containers task with ref.

---

**Review completed:** 2026-02-05  
**Next review:** After next SSH inventory or when container list changes.