From 29f7710173ed051353904cb4225399bd622ece44 Mon Sep 17 00:00:00 2001 From: jester Date: Sun, 19 Apr 2026 21:25:08 +0000 Subject: [PATCH] Update Portal Codex current state for Node 24 and cleanup pass --- Codex/Portal/CURRENT_STATE.md | 29 +++++++++++++++++++++++++++-- 1 file changed, 27 insertions(+), 2 deletions(-) diff --git a/Codex/Portal/CURRENT_STATE.md b/Codex/Portal/CURRENT_STATE.md index c449996..933f764 100644 --- a/Codex/Portal/CURRENT_STATE.md +++ b/Codex/Portal/CURRENT_STATE.md @@ -1,9 +1,25 @@ # Portal — Current State -Verified against local Portal repo `jester/zpack-portal` commit `69a4c3c` on 2026-04-16, plus local working-tree updates for code-server controls. +Verified against local Portal repo plus the reported Node 24 / Next 16 cleanup pass. This file records what is implemented now. +## Runtime / tooling baseline +- Portal is now aligned to the Node 24 runtime line used by the API repo. +- `.nvmrc`, `package.json` engines, and `package-lock.json` are expected to be synchronized on the current Node 24 baseline. +- Lint no longer relies on removed `next lint`; the repo uses `eslint .` with the Next 16 flat-config path. +- The lint configuration has been adjusted so current project patterns lint cleanly without forcing a broad React-compiler-style refactor. +- `npm run lint` reportedly passes with only existing React hook dependency warnings. +- `npm run build` reportedly passes on Next 16.2.4 with Turbopack. +- npm audit is reported clean at moderate-or-higher severity. + +## Repo cleanup already done +- Confirmed-unused HUD wrapper components have been removed. +- Stale `src/styles.old/*` legacy CSS has been removed. +- Unused `js-cookie` type shim has been removed. +- Unused dependencies and Tailwind plugins have reportedly been pruned from the Portal repo. +- The Portal cleanup pass reports net line-count reduction rather than growth. + ## Readiness / operation UI - Portal consumes API-normalized state. - Portal understands: @@ -34,12 +50,21 @@ This file records what is implemented now. - billing UI alignment exists with the newer billing state model. - forgot/reset password flow exists. - first-login onboarding flow exists. +- Next 16 / current TypeScript cleanup included fixes around nullable normalization and search-param/Suspense usage in affected pages/components. ## Hosted IDE -- console and server-list "Open IDE" actions request `/api/dev/{serverId}/ide-token`. +- console and server-list `Open IDE` actions request `/api/dev/{serverId}/ide-token`. - Portal opens the hosted URL returned by the API, falling back to the configured API base for relative URLs. - DEV server console and server-list rows show code-server `start`, `restart`, and `stop` controls directly under the `Open IDE` button. - code-server service actions call `/api/dev/{serverId}/codeserver/start`, `/api/dev/{serverId}/codeserver/restart`, and `/api/dev/{serverId}/codeserver/stop`. +## API client layer +- Portal still uses API-mediated transport rather than direct agent calls. +- Project cleanup has reportedly removed dead weight around unused wrappers/dependencies, but API-client/status-polling consolidation is not yet considered fully complete. + ## Dashboard / IA - spotlight server card/dashboard refresh landed. + +## Still true +- Portal should track API auth / JWT behavior closely because API-side token hardening can require Portal compatibility verification. +- Portal cleanup should remain behavior-preserving; build/lint green status is part of the current baseline.