jester/zlh-grind
1
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases Wiki Activity

Update Portal Codex current state for Node 24 and cleanup pass

Browse Source
This commit is contained in:
jester 2026-04-19 21:25:08 +00:00
parent 1773bc89b3
commit 29f7710173
1 changed files with 27 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
Codex/Portal/CURRENT_STATE.md
View File

@ -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.