Skip to content

fix(remote): restore authenticated GUI health (carry of #3168) - #3179

Merged
lidge-jun merged 1 commit into
devfrom
codex/3168-gui-health-carry
Sep 1, 2026
Merged

fix(remote): restore authenticated GUI health (carry of #3168)#3179
lidge-jun merged 1 commit into
devfrom
codex/3168-gui-health-carry

Conversation

@lidge-jun

Copy link
Copy Markdown
Owner

Summary

Maintainer rebase carry of #3168 by @Ingwannu, cherry-picked onto current dev with author credit preserved.

Restores authenticated GUI health through the management plane: a GUI attached to a connected runtime could not reach a health endpoint because the existing one lives on the data plane. This is the T3 follow-up recorded in #3158.

Why a carry branch. #3168 was DIRTY — it conflicted with dev. A maintainer cannot push a rebase to a contributor branch, so the commit is re-applied here.

The conflicts, and how they were resolved. Both were in documentation that #3173 had touched in the same week, and both sides had independently documented the same facts:

  • reference/cli/lifecycle.md — both added the three /readyz protocol fields. Kept the fuller wording, which additionally says where managementUrl comes from in each runtime role and that a readiness request with no HTTP(S) origin is rejected rather than guessed.
  • reference/configuration/server.md — both documented remoteGui.allowInsecureHttp as retired. Kept the table form, which covers all four remote-hub keys with their defaults and failure modes rather than that one key alone.

No code conflicted. The resolution keeps both authors' conclusions; they agreed on the substance.

Verification

Exact head ed0db2ceb:

  • bun test ./tests/server-management-auth.test.ts ./tests/cli-capabilities.test.ts55 pass, 0 fail, 421 expect() calls. Those are the suites covering the management-auth surface and the capability/route parity ratchet this diff extends.
  • git show --stat confirms the carry: 25 files, +112/-19, author Ingwannu.

Full-suite, GUI, and typecheck coverage is left to CI on this exact head.

Checklist

  • Targets dev
  • Author credit preserved via cherry-pick
  • Conflict resolution documented above rather than silently taking one side
  • Management-plane route addition is registered in the route registry and covered by the parity ratchet test
  • No credential storage, OAuth flow, workflow, or release-automation change

@lidge-jun
lidge-jun requested a review from Ingwannu as a code owner September 1, 2026 17:14
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 1, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-01T17:18:20.674237Z ed0db2c PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@lidge-jun
lidge-jun merged commit eceb02d into dev Sep 1, 2026
6 checks passed
@lidge-jun
lidge-jun deleted the codex/3168-gui-health-carry branch September 1, 2026 17:14
@github-actions

github-actions Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Deterministic PR hygiene checks passed.

@github-actions github-actions Bot added the bug Something isn't working label Sep 1, 2026
@github-actions

github-actions Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

⏳ DRAFT

  • UI screenshot required.

What to do

  • Add a screenshot of the UI change to the PR description.

Automatic draft conversion failed (token cannot change draft status). Please convert this pull request to a draft manually. The required enforce-target check will keep failing until every issue above is resolved.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ed0db2ceb2

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

try {
const [hRes, pRes] = await Promise.all([
fetch(`${apiBase}/healthz`, { signal }),
fetch(`${apiBase}/api/system/health`, { signal }),

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Negotiate the new health route before requiring it

When a connected client is upgraded before its hub, the local GUI uses this new endpoint while the still-supported protocol-1 hub returns 404 because /api/system/health does not exist there. requireJson then rejects and the catch marks the entire overview unavailable, discarding the successful /api/providers response and showing “Cannot connect” even though the hub is reachable. The remote protocol remains at version 1 and explicitly permits additive version skew, so either negotiate/fallback for older hubs or raise the minimum hub protocol before making this route mandatory.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants