Skip to content

Walkthrough UX polish: collapsible Apply readiness summary + unified Change display title - #284

Merged
Gaubee merged 1 commit into
mainfrom
fix/walkthrough-v13-ux
Sep 12, 2026
Merged

Gaubee merged 1 commit into
mainfrom
fix/walkthrough-v13-ux

Conversation

@Gaubee

@Gaubee Gaubee commented Sep 12, 2026

Copy link
Copy Markdown
Contributor

Summary

Two fixes from the Owner's acceptance walkthrough of the OpenSpecUI 13 instance:

  1. Apply readiness guidance no longer consumes the page. The always-expanded warnings/build-order blocks are now ONE always-visible summary row — warning count + the full build-order chain + openspec instructions apply attribution (role="status", collapsed by default). One explicit expansion reveals the verbatim upstream evidence on the same direct plane; Tooltip-only remains forbidden, and the divergence notice keeps its direct uncollapsed block. The change's spec delta (Apply Readiness Guidance Surface) is updated to codify the summary-row contract.

  2. One Change title everywhere. The Changes list titled rows with the legacy parser's proposal H1 (the scaffold's generic # Proposal), while Change Detail used the CLI status name (= id). New shared changeDisplayTitle(id, name) in the web lib: an informative proposal heading wins; generic/blank/id-equal values fall back to the change id. Wired into the Changes list rows + VT handoff, Dashboard rows, and the Change Detail header (rows name with the status name as pre-rows fallback).

Evidence

  • Focused suites green: 51/51 (helper + notice + change-view + change-list), 25/25 (dashboard + continuity), 39/39 final re-verify; web typecheck green; scoped prettier clean.
  • Browser self-verification on the live acceptance instance (screenshots recorded): collapsed summary renders one line with count + specs → design; expansion reveals verbatim evidence; Changes list row titles read ["no-specs-but-tasks","fresh-blocked-change"] (no generic "Proposal"); Detail header shows the same id title.
  • Full web suite classification: 8 failures were load-induced timeouts (acceptance dev server + gates running concurrently; terminal/ssg files re-verified green in isolation) plus one pre-existing View-Transition scroll flake reproduced on unmodified main — unrelated to this change's files.

Notes

  • The acceptance instance at http://localhost:3517 already serves the rebuilt assets for re-walkthrough.
  • Changeset: @openspecui/web patch.

… unify the Change display title

Owner walkthrough round on the OpenSpecUI 13 acceptance instance:

1. Apply warnings/build-order notices consumed the Change Detail page.
   ApplyProgressNotice now renders one always-visible summary row (warning
   count + full build-order chain + CLI attribution, role=status, collapsed
   by default); one explicit expansion reveals the verbatim upstream
   evidence on the same direct plane. Divergence stays a direct block.
   Spec delta updated to codify the summary-row contract.

2. The Changes list titled rows with the generic scaffold heading
   "# Proposal" while Change Detail used the change id. New shared
   changeDisplayTitle(id, name): an informative proposal heading wins,
   generic/blank/id-equal values fall back to the change id — wired into
   the Changes list, Dashboard rows, and the Change Detail header.
@Gaubee
Gaubee merged commit 7f13a46 into main Sep 12, 2026
6 checks passed
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