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

---

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 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."
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)".

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."

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." 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)

• 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.
• CHAIN138_AUTOMATION_SCRIPTS: Step 1 "Create Containers" — only 2506, 2507, 2508; reference MISSING_CONTAINERS_LIST.
• MASTER_INDEX: Added MISSING_CONTAINERS_LIST.md and DEPLOYMENT_STATUS_MASTER.md under 03-deployment/.
• DEPLOYMENT_TODO_MASTER: Added missing-containers line and date.
• REMAINING_TASKS_NEXT_STEPS_PHASES_REVIEW: Wave 2 added "(3 VMIDs only: see MISSING_CONTAINERS_LIST)".
• 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.