148 lines
3.1 KiB
Markdown
148 lines
3.1 KiB
Markdown
# 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
|