docs: update README with Feb 8 handover - metrics, console UI, agent updates complete

This commit is contained in:
jester 2026-02-08 22:53:37 +00:00
parent 3869ca7cba
commit eb46e18d4e

View File

@ -2,27 +2,37 @@
Execution workspace for **ZeroLagHub (ZLH)**.
This repo is intentionally lightweight and is used for:
- handovers / "where we left off" notes
- architecture decisions + rationale
- config snippets worth preserving
- TODO lists that don't belong in a code repo
This repository is intentionally lightweight and is used for:
- project handovers / "where we left off" notes
- architecture decisions and rationale
- system constraints and guardrails
- scratch investigations that shouldn't live in code repos
## Latest handover (2026-02-07)
---
- `SCRATCH/2026-02-07_customer-id-schema.md`
- Why a newly registered user looked "hashed" (it's Prisma `cuid()`),
- Why `ContainerInstance.customerId` got polluted with `u-dev-001`,
- The chosen short-term rule: **use `req.user.id` everywhere**.
## Latest handover (2026-02-08)
- `SCRATCH/2026-02-07_prometheus-grafana.md`
- Prometheus HTTP service discovery via API `/sd/exporters`,
- Grafana dashboard import gotchas + the "CPU doesn't match top" note,
- Next steps to power portal server cards with metrics.
**System state**
- API, frontend, and agent are now aligned and operational.
- Interactive PTY-backed consoles are stable for both dev and game servers.
- Customer isolation is enforced end-to-end (API → frontend).
- Agent update system is live, versioned, and hash-verified.
- `SCRATCH/2026-02-07_host-controls-and-delete-failsafe.md`
- Decision: keep delete failsafe, add host controls.
**Key areas completed**
- Metrics API (server-side Prometheus summaries)
- Game console UI (metrics, notes, player presence)
- Agent auto-update pipeline (manifest + SHA validation)
- Minecraft player presence via agent `/game/players`
- Forge startup race condition resolved
- Prometheus SD schema + auth fixes
## Scratchpad
**Primary focus moving forward**
- Final UI polish & stabilization
- Concurrent provisioning validation
- Hardening agent update + rollback paths
- Defining GA readiness criteria
`SCRATCH/` contains one-off notes that may later be promoted into formal docs.
See:
- `SESSION_LOG.md` for chronological execution details
- `OPEN_THREADS.md` for remaining work
- `ANTI_DRIFT*.md` for guardrails and constraints