zlh-grind/OPEN_THREADS.md

Open Threads — ZeroLagHub

This document tracks known open questions and deferred decisions.

---

Closed Threads

• ✅ Interactive PTY-backed console (dev + game)
• ✅ WebSocket stability and PTY ownership
• ✅ Customer isolation (API + frontend)
• ✅ Agent update system (versioned, hash-verified)
• ✅ Minecraft player presence (agent-sourced)
• ✅ Game telemetry router separation (/api/game/*)
• ✅ Agent Phase 1 mod management endpoints
• ✅ Agent process metrics endpoint
• ✅ Minecraft readiness probe + restart race mitigation (initial)

---

Still Open (Phase 1 / Go-to-market)

API: proxy the new agent capabilities

• Add game-mod endpoints behind auth + ownership:
  • GET /api/game/servers/:vmid/mods
  • POST /api/game/servers/:vmid/mods/install
  • PATCH /api/game/servers/:vmid/mods/:mod_id
  • DELETE /api/game/servers/:vmid/mods/:mod_id
• Add process metrics proxy:
  • GET /api/game/servers/:vmid/metrics/process
• Decide caching shape (Redis keys + TTLs) for:
  • mods list (agent already caches 5m internally)
  • process metrics (likely low TTL, e.g. 5–10s)

Artifacts: Modrinth / NeoForge supply-chain workflow

• Define a local-first artifact ingestion workflow:
  • detect → pending → verified → active → deprecated
• Decide Phase 1 scope:
  • curated mod list vs modpack-first
  • whether to ingest only Modrinth + NeoForge initially
• Standardize loader naming contracts:
  • minecraft/neoforge/<mc_version>/neoforge-installer.jar (Phase 1)
  • confirm similar conventions for Forge/Fabric installers

Frontend: Mods UI (Phase 1)

• Add "Mods" surface for game servers:
  • installed mods list (enabled/disabled)
  • enable/disable toggle
  • remove mod
  • curated install flow (no arbitrary URLs)
• Decide if "upload custom mods" is Phase 1 or Phase 2:
  • Phase 2 is preferred unless there is sandboxing/scanning/allowlist.

Provisioning & scale validation

• Validate concurrent provisioning (multi-user, parallel creates)
• Stress-test agent update checks under load (notify/auto modes)
• Confirm safe limits for restart/backoff behavior

---

Still Open (Polish / Phase 2)

Console UI

• Finalize player list UX (overlay vs inline)
• Final accessibility/contrast pass

Agent hardening

• Rollback behavior if a new agent fails health checks after update
• Optional manifest signing (minisign/GPG)

Game platform roadmap

• Modpack-first install flow (server files + manifests)
• Engine abstraction for additional games (Rust/Terraria/Valheim)

---

Explicit Non-Goals (for now)

• In-console player management actions
• Live chat overlays
• Grafana iframe embedding for customers
• Per-player stats in the main console
• Arbitrary mod uploads without scanning/sandboxing