# 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