chore: sync all changes to Gitea

- Config, docs, scripts, and backup manifests - Submodule refs unchanged (m = modified content in submodules) Made-with: Cursor
2026-03-02 11:37:34 -08:00
parent ed85135249
commit b3a8fe4496
883 changed files with 73580 additions and 4796 deletions
--- a/docs/02-architecture/VMID_ALLOCATION_FINAL.md
+++ b/docs/02-architecture/VMID_ALLOCATION_FINAL.md
@@ -2,12 +2,27 @@

 **Navigation:** [Home](/docs/01-getting-started/README.md) > [Architecture](/docs/01-getting-started/README.md) > VMID Allocation

-**Last Updated:** 2025-01-20  
-**Document Version:** 1.0  
+**Last Updated:** 2026-02-26  
+**Document Version:** 1.1  
 **Status:** 🟢 Active Documentation

 ---

+## VMID Quick Reference (Operational)
+
+| Range | Purpose | Notes |
+|------:|---------|-------|
+| 3000–3003 | Monitor / RPC-adjacent (ml110 / ccip-monitor-1..4) | Within RPC/Gateways (2500–3499). Not CCIP DON. Not AI/Agents. |
+| 5400–5599 | CCIP DON (Chainlink CCIP) | 5410–5429 Commit, 5440–5459 Execute, 5470–5476 RMN. |
+| 5700–5999 | AI / Agents / Dev | Official band for model serving, MCP, agent runtimes. |
+
+**Naming/Tags (recommended):**
+- AI VMs: `ai-<role>-<env>` (e.g. `ai-mcp-prod`, `ai-inf-dev`, `ai-agent-prod`)
+- Monitor/RPC-adjacent: `ccip-monitor-<n>`
+- Proxmox tags: `AI`, `MCP`, `HF`, `MONITOR`, `PROD`/`DEV`
+
+---
+
 ## Complete VMID Allocation Table

 | VMID Range      | Domain                                                          | Total VMIDs | Initial Usage | Available |
@@ -16,7 +31,7 @@
 | 5000–5099       | Blockscout                                                     | 100         | 1             | 99        |
 | 5200–5299       | Cacti                                                           | 100         | 1             | 99        |
 | 5400–5599       | Chainlink CCIP                                                 | 200         | 1+            | 199       |
-| 5700–5999       | (available / buffer)                                           | 300         | 0             | 300       |
+| 5700–5999       | AI / Agents / Dev (model serving, MCP, agent runtimes)         | 300         | 1             | 299       |
 | 6000–6099       | Fabric                                                          | 100         | 1             | 99        |
 | 6200–6299       | FireFly                                                         | 100         | 1             | 99        |
 | 6400–7399       | Indy                                                            | 1,000       | 1             | 999       |
@@ -41,10 +56,14 @@
 - **1500-1503**: Initial sentries (4 nodes)
 - **1504-2499**: Reserved for sentry expansion (996 VMIDs)

-#### RPC / Gateways (2500-3499) - 1,000 VMIDs
- **2500-2502**: Initial RPC nodes (3 nodes)
- **2503-2505**: Besu RPC (HYBX; 3 nodes). **2506-2508 destroyed 2026-02-08** (no longer in use).
- **2509-3499**: Reserved for RPC/Gateway expansion
+#### RPC / Gateways (Besu) — 2500–3499
+- **2500–2508:** In-use RPC/Gateway nodes (2500–2502 initial; 2503–2505 HYBX; 2506–2508 destroyed 2026-02-08).
+- **2509–2999:** Reserved for RPC/Gateway expansion
+- **3000–3003:** **ml110 / monitor-style (RPC-adjacent)** — legacy/current usage
+  - Suggested naming: **ccip-monitor-1..4**
+  - **Not** the CCIP DON allocation (CCIP DON = **5400–5599**)
+  - **Not** the AI/Agents allocation (AI/Agents = **5700–5999**)
+- **3004–3499:** Reserved for RPC/Gateway expansion

 #### Archive / Telemetry (3500-4299) - 800 VMIDs
 - **3500+**: Archive / Snapshots / Mirrors / Telemetry
@@ -78,10 +97,16 @@

 ---

-### Available / Buffer (5700-5999) - 300 VMIDs
+### AI / Agents / Dev — 5700–5999

- **5700**: Dev VM (shared Cursor dev + private Gitea for four users). See [DEV_VM_GITOPS_PLAN.md](../04-configuration/DEV_VM_GITOPS_PLAN.md).
- **5701-5999**: Reserved for future use / buffer space
+This is the **official VMID range** for AI workloads, agent runtimes, MCP servers, and AI/dev experimentation. **Do not** place AI workloads in 3000–3099; that range is within RPC/Gateways expansion and includes legacy monitor/RPC-adjacent nodes (3000–3003).
+
+- **5700:** Dev VM (existing). See [DEV_VM_GITOPS_PLAN.md](../04-configuration/DEV_VM_GITOPS_PLAN.md).
+- **5701–5749:** AI platform services (model serving, MCP hub, auth, observability)
+- **5750–5899:** AI applications (per-project agents, DODO PMM tooling, policy guardrails)
+- **5900–5999:** Experiments / temporary / buffer
+
+**Optional suggested layout:** 5701 = MCP Hub; 5702 = Inference (HF model server); 5703 = Agent Worker (orchestration); 5704 = Memory/State (Postgres/Redis/Vector DB). See [AI_AGENTS_57XX_DEPLOYMENT_PLAN.md](AI_AGENTS_57XX_DEPLOYMENT_PLAN.md) for copy/paste deployment steps (QEMU guest agent, 57xx layout, MCP/DODO PMM, read-only vs execution).

 ---

@@ -131,16 +156,18 @@ VMID_VALIDATORS_START=1000         # Besu validators: 1000-1499
 VMID_SENTRIES_START=1500           # Besu sentries: 1500-2499
 VMID_RPC_START=2500                # Besu RPC: 2500-3499
 VMID_ARCHIVE_START=3500            # Besu archive/telemetry: 3500-4299
-VMID_BESU_RESERVED_START=4300     # Besu reserved: 4300-4999
-VMID_EXPLORER_START=5000          # Blockscout: 5000-5099
-VMID_CACTI_START=5200             # Cacti: 5200-5299
-VMID_CCIP_START=5400              # Chainlink CCIP: 5400-5599
-VMID_BUFFER_START=5700            # Buffer: 5700-5999
-VMID_FABRIC_START=6000            # Fabric: 6000-6099
-VMID_FIREFLY_START=6200           # Firefly: 6200-6299
-VMID_INDY_START=6400              # Indy: 6400-7399
-VMID_SANKOFA_START=7800           # Sankofa/Phoenix/PanTel: 7800-8999
-VMID_SOVEREIGN_CLOUD_START=10000  # Sovereign Cloud: 10000-13999
+VMID_BESU_RESERVED_START=4300      # Besu reserved: 4300-4999
+VMID_EXPLORER_START=5000           # Blockscout: 5000-5099
+VMID_CACTI_START=5200              # Cacti: 5200-5299
+VMID_CCIP_START=5400               # Chainlink CCIP: 5400-5599
+VMID_AI_AGENTS_START=5700          # AI / Agents / Dev: 5700-5999 (model serving, MCP, agent runtimes)
+# Optional alias for backward compatibility (deprecated):
+# VMID_BUFFER_START=5700           # deprecated: use VMID_AI_AGENTS_START
+VMID_FABRIC_START=6000             # Fabric: 6000-6099
+VMID_FIREFLY_START=6200            # Firefly: 6200-6299
+VMID_INDY_START=6400               # Indy: 6400-7399
+VMID_SANKOFA_START=7800            # Sankofa/Phoenix/PanTel: 7800-8999
+VMID_SOVEREIGN_CLOUD_START=10000   # Sovereign Cloud: 10000-13999
 ```

 ---
@@ -153,7 +180,7 @@ VMID_SOVEREIGN_CLOUD_START=10000  # Sovereign Cloud: 10000-13999
 | Blockscout | 5000 | 5099 | 100 | 1 | 99 | 99.0% |
 | Cacti | 5200 | 5299 | 100 | 1 | 99 | 99.0% |
 | Chainlink CCIP | 5400 | 5599 | 200 | 1+ | 199 | 99.5% |
-| Buffer | 5700 | 5999 | 300 | 0 | 300 | 100% |
+| AI/Agents/Dev | 5700 | 5999 | 300 | 1 | 299 | 99.7% |
 | Fabric | 6000 | 6099 | 100 | 1 | 99 | 99.0% |
 | FireFly | 6200 | 6299 | 100 | 1 | 99 | 99.0% |
 | Indy | 6400 | 7399 | 1,000 | 1 | 999 | 99.9% |
@@ -170,11 +197,16 @@ VMID_SOVEREIGN_CLOUD_START=10000  # Sovereign Cloud: 10000-13999
 ✅ **Future-proof** - Large buffers and reserved ranges  
 ✅ **Modular design** - Each service has dedicated range  
 ✅ **Sovereign Cloud Band** - 4,000 VMIDs for SMOM/ICCC/DBIS/Absolute Realms  
+✅ **AI/Agents band (5700–5999)** — Dedicated range for model serving, MCP, agent runtimes; 3000–3003 remain RPC/monitor-adjacent  

 ---

 ## Migration Notes

+**New Additions (v1.1):**
+- **AI/Agents/Dev (5700–5999)** defined as the official band for AI inference, MCP, agent runtimes, vector DB, and AI platform services (not 3000–3099).
+- **3000–3003** explicitly documented as **RPC/monitor-adjacent** (ml110 / ccip-monitor-1..4), not CCIP DON and not AI/Agents.
+
 **Previous Allocations**:
 - Validators: 106-110, 1100-1104 → **1000-1004**
 - Sentries: 111-114, 1110-1113 → **1500-1503**
@@ -187,8 +219,13 @@ VMID_SOVEREIGN_CLOUD_START=10000  # Sovereign Cloud: 10000-13999
 - Indy: 8000, 263 → **6400**

 **New Additions**:
- Buffer: 5700-5999 (300 VMIDs)
+- AI/Agents/Dev: 5700-5999 (300 VMIDs). **Use this band for AI inference, MCP, agent runtimes, vector DB; not 3000-3099.** Sub-ranges: 5701-5749 platform, 5750-5899 apps, 5900-5999 experiments. 3000-3003 remain RPC/monitor-adjacent (ml110/ccip-monitor-1..4).
 - Sankofa/Phoenix/PanTel: 7800-8999 (1,200 VMIDs)
 - Sovereign Cloud Band: 10000-13999 (4,000 VMIDs)
 - **NPMplus Alltra/HYBX:** VMID 10235 (192.168.11.169). See [04-configuration/NPMPLUS_ALLTRA_HYBX_MASTER_PLAN.md](../04-configuration/NPMPLUS_ALLTRA_HYBX_MASTER_PLAN.md). NPMplus range: 10233 (primary), 10234 (HA secondary), 10235 (Alltra/HYBX).

+---
+
+**Owner:** Architecture  
+**Review cadence:** Quarterly or upon new VMID band creation  
+**Change control:** PR required; update Version + Last Updated