zlh-grind/OPEN_THREADS.md

Open Threads – zlh-grind

This file tracks active but unfinished work.

Keep it short.

---

Agent (zlh-agent)

Dev Runtime System

Completed:

• catalog validation implemented
• runtime installs artifact-backed
• install guard implemented

Outstanding:

• runtime install verification improvements
• catalog hash validation
• runtime removal / upgrade handling

---

Dev Environment

Completed:

• dev user creation
• workspace root /home/dev/workspace
• console runs as dev user

Outstanding:

• PATH normalization
• shell profile consistency
• runtime PATH injection

---

Code Server Addon

Status: ✅ Operational — artifact fixed, install confirmed working 2026-03-15

Port: 6000

Routing: Traefik + Cloudflare wildcard (*.dev.zerolaghub.com) — no SRV records needed

Outstanding:

• code-server launch link in portal
• Traefik dynamic config written by API on provisioning

---

Agent Future Work (priority order)

1. Unified structured logging (slog) — Promtail/Loki needs structured fields
2. Dev container /status — provisioningComplete + provisioningError fields
3. Crash recovery with backoff — 30s/60s/120s, max 3 attempts, then error state
4. Graceful shutdown verification — SIGTERM + wait before SIGKILL for Minecraft
5. Agent restart/process reattachment — detect existing process on restart

---

API (zlh-api)

Completed:

• dev provisioning payload
• runtime/version fields
• enable_code_server flag

Outstanding:

• runtime validation endpoint
• dev runtime catalog endpoint for portal
• write Traefik dynamic config file on dev container provisioning
• remove Traefik dynamic config on dev container deletion

---

Portal (zlh-portal)

Completed:

• dev runtime dropdown
• dotnet runtime support
• enable code-server checkbox
• dev file browser support

Outstanding:

• runtime list driven from catalog API
• dev port exposure UI
• code-server launch link

---

Artifact Server

Completed:

• runtime artifacts hosted
• devcontainer catalog
• runtime archive structure
• code-server compiled release artifact ✅

Outstanding:

• checksum publishing
• artifact metadata support

---

Platform

Future work:

• dev port routing
• dev service detection
• artifact version promotion
• runtime rollback support

---

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
• ✅ Modrinth resolver + full mod lifecycle
• ✅ Direct runtime upload model (no staging, no symlinks)
• ✅ .zlh_metadata.json provenance tracking
• ✅ Raw http.request streaming in API upload proxy
• ✅ Filesystem architecture docs consolidated
• ✅ Upload transport timeout tuning
• ✅ Dev container filesystem support (container-aware, /workspace root)
• ✅ Code-server artifact fix — compiled release on zlh-artifacts, install confirmed working