# 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)