feat(webui): Settings nav in four groups, organization pages at one address, and a four-step Model setup with account health (#1873) #2004

Merged
jason.woltje merged 14 commits from settings-s4 into refactor 2026-11-20 01:29:04 +00:00
Owner

What changes

Settings layout slice 4 (lane settings-s4): the new Settings nav and a guided Model setup page. Browser side only, in packages/webui/src/public/ (display.js, bus.js, shell.css, workspace.js, brand.js, triage-settings.js).

  • Nav in four groups. You (Appearance). Your models (Model setup, and Triage for the instance owner). All organizations (Organizations, Console, About). This organization (a picker over Models, Agents, Launch limits, Token use, Assistant, Organization file).
  • Addresses. An organization's pages live at #/settings/<page>?org=<id>, so picking an organization no longer changes the URL base. Every old #/orgs/<id>/settings/<page> address redirects. #/settings/model-proxy and #/settings/routing still open their pages.
  • Model setup at #/settings/model-setup. Four step cards: Model service, Accounts and models, Organizations, Triage. The page shows at most one primary button. One press runs download, set up, install and start in order and shows a progress list. A failed step stops the chain and offers Try again. No write is retried on its own. Done cards fold to one line, and a reload resumes at the step the status read names.
  • Accounts with health. Each account is a row with its kind and a health badge. A row shows why an account is not working, from the reason field #2003 added to the accounts read, as plain text. Sign in to a provider, or check and add an API key. Nothing goes to browser storage or the console.
  • Models offered per provider, read-only, with a search box past eight models.
  • Removed, as the design says. "Use my own key" and its key fields (init always generates the key), key rotation grace, the Client keys table and its read.
  • Sidebar marks. An organization reads "needs restart", "can't start" (stand-in models and a stopped bus) or "paused" (its model service is set up but down). Model setup step 3 names a "can't start" organization in the same words, with the fix.
  • Carried from #2002. The Ride all done line leaves out an organization that turned the model service off.

No new route, bus verb, schema change, refusal code, grant or role. Nothing under roles/, contracts/, packages/queue/, packages/bus/ or any server file.

Tests

  • New: packages/webui/tests/settings-s4-browser.test.mjs (red on the old base). Eleven older test files read the new nav and addresses.
  • Lane gate on ead56db35: 221 files, 2007 pass, 1 fail, 7 skip. The one red was tasks-board-browser, fixed on refactor by #2003.
  • Lead check in a clean environment on the rebased tip 524132b42: 496 files, 5173 pass, 0 fail, 7 skip.

Review

A fresh claude-opus-5-5 reviewer asked for three changes (picker changed the URL base, the "can't start" mark had no matching words, the design's removals were not done). The lane fixed all three. A second fresh reviewer re-checked and approved. Two commits came after the re-check started: the account reason line, which the Lead read (three lines in display.js, inserted as text, plus two CSS rules), and a fix to a race in one test.

Left for later

  • Nine items need a backend lane: account remove, per-model on/off, the service's log lines, port and timeouts after init, instance-wide programs, a provider list read, service key renewal status, per-organization access health, and setup history across sessions.
  • Sidebar marks refresh on page load and bus events only.
  • A stand-in organization shows "can't start" before the first account exists, while step 3 says only "Opens after your first account".
  • The Move dialog and its result lines name the organization by id. Step 3 says "your models" where the Ride line says "the owner's models".
  • The standalone /proxy page keeps its key controls.
  • Layout slices 5 to 8.
## What changes Settings layout slice 4 (lane settings-s4): the new Settings nav and a guided Model setup page. Browser side only, in `packages/webui/src/public/` (`display.js`, `bus.js`, `shell.css`, `workspace.js`, `brand.js`, `triage-settings.js`). - **Nav in four groups.** You (Appearance). Your models (Model setup, and Triage for the instance owner). All organizations (Organizations, Console, About). This organization (a picker over Models, Agents, Launch limits, Token use, Assistant, Organization file). - **Addresses.** An organization's pages live at `#/settings/<page>?org=<id>`, so picking an organization no longer changes the URL base. Every old `#/orgs/<id>/settings/<page>` address redirects. `#/settings/model-proxy` and `#/settings/routing` still open their pages. - **Model setup** at `#/settings/model-setup`. Four step cards: Model service, Accounts and models, Organizations, Triage. The page shows at most one primary button. One press runs download, set up, install and start in order and shows a progress list. A failed step stops the chain and offers Try again. No write is retried on its own. Done cards fold to one line, and a reload resumes at the step the status read names. - **Accounts with health.** Each account is a row with its kind and a health badge. A row shows why an account is not working, from the `reason` field #2003 added to the accounts read, as plain text. Sign in to a provider, or check and add an API key. Nothing goes to browser storage or the console. - **Models offered** per provider, read-only, with a search box past eight models. - **Removed, as the design says.** "Use my own key" and its key fields (init always generates the key), key rotation grace, the Client keys table and its read. - **Sidebar marks.** An organization reads "needs restart", "can't start" (stand-in models and a stopped bus) or "paused" (its model service is set up but down). Model setup step 3 names a "can't start" organization in the same words, with the fix. - **Carried from #2002.** The Ride all done line leaves out an organization that turned the model service off. No new route, bus verb, schema change, refusal code, grant or role. Nothing under `roles/`, `contracts/`, `packages/queue/`, `packages/bus/` or any server file. ## Tests - New: `packages/webui/tests/settings-s4-browser.test.mjs` (red on the old base). Eleven older test files read the new nav and addresses. - Lane gate on ead56db35: 221 files, 2007 pass, 1 fail, 7 skip. The one red was `tasks-board-browser`, fixed on refactor by #2003. - Lead check in a clean environment on the rebased tip 524132b42: 496 files, 5173 pass, 0 fail, 7 skip. ## Review A fresh claude-opus-5-5 reviewer asked for three changes (picker changed the URL base, the "can't start" mark had no matching words, the design's removals were not done). The lane fixed all three. A second fresh reviewer re-checked and approved. Two commits came after the re-check started: the account reason line, which the Lead read (three lines in `display.js`, inserted as text, plus two CSS rules), and a fix to a race in one test. ## Left for later - Nine items need a backend lane: account remove, per-model on/off, the service's log lines, port and timeouts after init, instance-wide programs, a provider list read, service key renewal status, per-organization access health, and setup history across sessions. - Sidebar marks refresh on page load and bus events only. - A stand-in organization shows "can't start" before the first account exists, while step 3 says only "Opens after your first account". - The Move dialog and its result lines name the organization by id. Step 3 says "your models" where the Ride line says "the owner's models". - The standalone `/proxy` page keeps its key controls. - Layout slices 5 to 8.
jason.woltje added 14 commits 2026-11-20 01:29:01 +00:00
jason.woltje merged commit 524132b42b into refactor 2026-11-20 01:29:04 +00:00
Sign in to join this conversation.