diff --git a/README.md b/README.md index c448eba..3ba4cdc 100644 --- a/README.md +++ b/README.md @@ -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