Skip to content

feat(settings): reorganize page into grouped sections with sticky nav (ROADMAP #13)#56

Merged
coccyx merged 2 commits into
masterfrom
feat/settings-cleanup
May 29, 2026
Merged

feat(settings): reorganize page into grouped sections with sticky nav (ROADMAP #13)#56
coccyx merged 2 commits into
masterfrom
feat/settings-cleanup

Conversation

@coccyx
Copy link
Copy Markdown
Contributor

@coccyx coccyx commented May 29, 2026

Summary

ROADMAP item #13. Pure UX rearrangement — no new features, no schema or query changes.

The Settings page had grown to 8 sections in chronological-by-landing order rather than mental-model order. Setup actions were buried at the bottom; first-time installers had to scroll past 5 tuning sections to find provisioning. No section nav, no setup-status summary. Trace originators (a read-only audit table) was mixed with config-action sections. Noise filters and Error filtering were separated by Dataset even though they're the same kind of "shape what counts as an error" tuning.

What's now in place

  • Setup status card at the top — two checkmark rows (Scheduled searches, Dataset acceleration) showing live provisioning state. Green-left-border when both OK; otherwise shows what's missing with a "Jump to X" anchor button. Reuses the same planOnly + getDatasetStatus checks the global ProvisioningBanners use.
  • Two-column layout: sticky left-rail section nav with IntersectionObserver-driven active-link highlight; content cards on the right. Collapses to single column below 960px.
  • Sections grouped by purpose with group headings:
    • Setup — Provisioning, Dataset acceleration (TOP).
    • Workspace — Dataset, Detection cadence, Notification targets.
    • Filtering & heuristics — Noise filters, Error filtering.
    • Diagnostics — Trace originators (collapsed by default).
  • Setup panels moved from the bottom to the top. The duplicate at the bottom is removed.
  • Trace originators collapsed by default — operators rarely look at the classification audit; the section title is now a toggle.

Screenshot

settings

Test plan

  • npx tsc --noEmit — clean
  • npm run lint — 0 errors
  • npm test — 107/107 passing
  • npm run build — succeeds
  • npm run deploy — packed + uploaded + provisioned on staging
  • Playwright capture: setup status renders with both green checks; nav highlights the in-view section; sticky scroll behavior intact

Validate on staging

  1. Open Settings — confirm Setup status card with two green checkmarks at the top
  2. Confirm sticky left nav with four groups
  3. Click a nav link — page anchors-scrolls to that section
  4. Scroll content — nav highlight follows
  5. Diagnostics → click Trace originators title — expands the table

Session log

docs/sessions/2026-05-29-settings-cleanup.md

🤖 Generated with Claude Code

coccyx and others added 2 commits May 29, 2026 14:05
ROADMAP item #13. Pure UX rearrangement — no new features, no
schema or query changes.

The page had grown to 8 sections in chronological-by-landing
order rather than mental-model order. Setup actions were buried
at the bottom; first-time installers had to scroll past 5 tuning
sections to find provisioning. No section nav, no setup-status
summary. Trace originators (a read-only audit table) was mixed
with config-action sections. Noise filters and Error filtering
were separated by Dataset even though they're the same kind of
"shape what counts as an error" tuning.

What's now in place:

- Setup status card at the top — two checkmark rows
  (Scheduled searches / Dataset acceleration) showing live
  provisioning state. Green-left-border when both OK; otherwise
  shows what's missing with a "Jump to X" anchor button. Reuses
  the same planOnly + getDatasetStatus checks the global
  ProvisioningBanners use.

- Two-column layout: sticky left-rail section nav (with
  IntersectionObserver-driven active-link highlight) and the
  content cards on the right. Collapses to single column below
  960px.

- Sections grouped by purpose with group headings:
  - Setup: Provisioning, Dataset acceleration (TOP).
  - Workspace: Dataset, Detection cadence, Notification targets.
  - Filtering & heuristics: Noise filters, Error filtering.
  - Diagnostics: Trace originators (collapsed by default).

- Setup panels moved from the very bottom to the top. The
  duplicate at the bottom is removed.

- Trace originators collapsed by default — operators rarely look
  at the classification audit; the section title is now a toggle.

New files: SettingsSetupStatus.tsx (+css), SettingsNav.tsx (+css).

Pre-merge: tsc clean, lint 0 errors, 107/107 unit tests, build
succeeds, deployed + visually validated on staging.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- Item #2 (Faceted trace search) is now DONE — folded into the
  v0.9.0 Faceted-search + Spotlight thread (PRs #46#55) with a
  short summary block under Completed.
- Item #13 (Settings page cleanup) is DONE — PR #56 (this branch).
- Renumbered items 3–12 down by one to close the gap.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coccyx coccyx merged commit 75cf174 into master May 29, 2026
3 checks passed
@coccyx coccyx deleted the feat/settings-cleanup branch May 29, 2026 21:09
coccyx added a commit that referenced this pull request May 29, 2026
Faceted trace search + Spotlight + Settings page reorganization.

- Faceted-nav data layer + UI primitives (#46, #47)
- Search-page integration with Spotlight rail (#48, #49)
- Spotlight on Errors page + Service Detail (#50, #51, #53)
- Small-multiples / readable-card / rate-bar Spotlight redesigns
  driven by manual validation feedback (#52, #54, #55)
- Settings page reorganization with Setup status card, sticky
  nav, and grouped sections (#56)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant