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: Provisioning logic implemented.

Current blocker: Artifact contains source repository, not compiled release.

Needed: Artifact server must provide a runnable release archive.

Expected contents:

bin/code-server
lib/
node_modules/

Once artifact is corrected provisioning should succeed.

---

API (zlh-api)

Completed:

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

Outstanding:

• runtime validation endpoint
• dev runtime catalog endpoint for portal

---

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

Outstanding:

• correct code-server artifact
• 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 — client abort / upstream timeout / socket reset categories clarified
• ✅ Dev container filesystem support (container-aware, /workspace root)