From b4343ae1e9502126054ddf56e89742b129803de2 Mon Sep 17 00:00:00 2001
From: jester <admin@zerolaghub.com>
Date: Thu, 16 Apr 2026 19:09:09 +0000
Subject: [PATCH] Add Codex repo-specific tracking structure

---
 Codex/Portal/CURRENT_STATE.md | 36 +++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 Codex/Portal/CURRENT_STATE.md

diff --git a/Codex/Portal/CURRENT_STATE.md b/Codex/Portal/CURRENT_STATE.md
new file mode 100644
index 0000000..efc4163
--- /dev/null
+++ b/Codex/Portal/CURRENT_STATE.md
@@ -0,0 +1,36 @@
+# Portal — Current State
+
+This file records what is believed to be implemented now.
+
+## Readiness / operation UI
+- Portal consumes API-normalized state.
+- Portal understands:
+  - `ready`
+  - `operationInProgress`
+  - `operationType`
+  - `maintenance`
+  - `operationStartedAt`
+  - `operationMessage`
+- targeted `409` and `503` UX messaging exists for operation conflicts and not-ready states.
+
+## Backup UI
+- game backup UI exists for:
+  - list
+  - create
+  - restore
+  - delete
+- Portal uses API routes, not direct agent calls.
+
+## Console / action gating
+- console command transport uses POST JSON through API.
+- previous blanket `ready === false` gating bug for game actions was fixed.
+- Start is not blocked merely because a stopped server is not ready.
+- backup actions are not blocked purely by `ready === false`; backend validity decides.
+
+## Billing / auth / onboarding
+- billing UI alignment exists with the newer billing state model.
+- forgot/reset password flow exists.
+- first-login onboarding flow exists.
+
+## Dashboard / IA
+- spotlight server card/dashboard refresh landed.