Session Log — ZeroLagHub (Execution Ledger)

Chronological ledger of notable execution work. Keep this high signal; link to code PRs/commits in upstream repos when available.

2026-02-07 → 2026-02-08 — Console stabilization

Migrated console from log tailing to PTY-backed interactive console over WebSockets.
Hardened WS stability:
- moved to a single-writer pattern
- ensured exactly one PTY read loop per {vmid, container_type}
Fixed "it works but not on prod" issues caused by stale binaries still running.
Confirmed systemd points to /opt/zlh-agent/current/zlh-agent with current -> releases/<ver> layout.

Added src/routes/game.js, mounted at /api/game.
Added:
- GET /api/game/servers/:id/players (Redis-backed, normalized response)
- GET /api/game/servers/:id/update-status (agent version + update state)
Extended src/utils/agentPoller.js:
- poll agent GET /game/players for game containers
- poll agent GET /version + GET /agent/update/status
- cache agentVersion, updateStatus, updateAvailable
Persisted engineType/engineVersion in ContainerInstance on provisioning.
Rolled back provisioning-time agent update triggers (back to direct /config flow).

Game console polling switched to:
- GET /api/game/servers/:id/players
- GET /api/game/servers/:id/update-status
UI shows player count + optional name list.
Version context rendered as Version: X or Version: X -> Y.

/game/players hardened for more reliable Minecraft presence (port/protocol fallbacks).
Added periodic update checks:
- ZLH_AGENT_UPDATE_MODE=notify|auto|off
- ZLH_AGENT_UPDATE_INTERVAL (default 30m)
Implemented Phase 1 mod management:
- GET /game/mods
- POST /game/mods/install (allowlist + redirect constraints + size cap + sha256 verify)
- PATCH /game/mods/:mod_id (enable/disable)
- DELETE /game/mods/:mod_id (moves to mods-removed/)
Implemented GET /metrics/process (PID + VmRSS/VmSize; restart_count mapped to crashCount).
Added Minecraft readiness probe after start/restart and stop-wait-before-restart sync to reduce restart races.
Added lifecycle.log for lifecycle/probe diagnostics.

Expanded Minecraft artifact tree to include NeoForge under /opt/zlh/zpacks/minecraft/neoforge/<mc_version>/.
Encountered installer naming contract mismatch; Phase 1 fix is to normalize the NeoForge installer filename for predictable installs.

Moved away from self-hosting all mod artifacts.
zlh-artifactd Phase 1 scope: mod resolver only (Modrinth API + NeoForge maven).
- No local mod storage in Phase 1; agent fetches from upstream, verifies hash.
- Local caching added in Phase 2 based on real usage patterns.
Full artifact orchestrator (game jars, runtimes, mods unified) is the Phase 3 vision.
Rationale: single-operator sustainability; learn ingestion patterns from mods before automating game jars.

Modrinth as primary source (open API, no key required, hash provided, NeoForge/Fabric/Forge/Quilt filter support).
CurseForge: manual SFTP upload by user (their friction, not ours).
Modrinth API base: api.modrinth.com/v2, rate limit 300 req/min, requires User-Agent header.

Currently at 1.21.7; need to add 1.21.8 through 1.21.11.
Source: Mojang version manifest at piston-meta.mojang.com/mc/game/version_manifest_v2.json.

Vanilla, Paper, Purpur, Forge, Quilt (covers Fabric mods too) — already in place.
NeoForge added (3 versions above).
No Fabric standalone needed; Quilt provides compatibility.

API: proxy agent mod + process metrics endpoints behind auth/ownership.
Artifacts: add vanilla 1.21.8–1.21.11 jars + confirm NeoForge naming contract resolved.
Frontend: add Mods UI surface using API proxy endpoints.
zlh-artifactd: Phase 1 design (Modrinth resolver, no local mod storage).