Frontend UX: update docs, invariants, and E2E coverage for the redesign #298

Closed
opened 2026-06-06 09:35:21 +00:00 by PlasticDigits · 10 comments
PlasticDigits commented 2026-06-06 09:35:21 +00:00 (Migrated from gitlab.com)

Summary

Update documentation, invariants, manual QA checklists, and Playwright E2E coverage to reflect the new cyberminimalist PvP command-console UX across the platform.

Scope

  • Document new Arena layout and component map in arena-views.md and design.md
  • Create page-by-page content audit checklist against canonical TimeArena docs
  • Update manual QA checklists for visual regression and mechanics verification
  • Refresh Playwright selectors, test expectations, and branding strings (Yield Omega)
  • Add/update frontend invariants for the redesign where needed

Key files

  • docs/frontend/arena-views.md
  • docs/frontend/design.md
  • docs/testing/manual-qa-checklists.md
  • docs/testing/invariants-and-business-logic.md
  • frontend/e2e/ (all arena, home, referrals, navigation, footer specs)
  • scripts/check-arena-naming.sh

Constraints

  • Product mechanics remain canonical in docs/product/time-arena.md — docs describe UI, not redefine rules
  • E2E must use 5 Playwright workers per project convention
  • Branding: Yield Omega (with space) in user-facing test expectations
  • Keep arena-* CSS naming convention per #280

Acceptance criteria

  • arena-views.md and design.md describe the new command-console layout
  • Page-by-page content audit checklist exists and covers all routes
  • Manual QA checklists updated for visual + mechanics smoke
  • Playwright E2E specs pass with updated selectors
  • npm run typecheck, npm run lint, npm test pass in frontend/
  • bash scripts/check-arena-naming.sh passes
## Summary Update documentation, invariants, manual QA checklists, and Playwright E2E coverage to reflect the new cyberminimalist PvP command-console UX across the platform. ## Scope - Document new Arena layout and component map in `arena-views.md` and `design.md` - Create page-by-page content audit checklist against canonical TimeArena docs - Update manual QA checklists for visual regression and mechanics verification - Refresh Playwright selectors, test expectations, and branding strings (Yield Omega) - Add/update frontend invariants for the redesign where needed ## Key files - `docs/frontend/arena-views.md` - `docs/frontend/design.md` - `docs/testing/manual-qa-checklists.md` - `docs/testing/invariants-and-business-logic.md` - `frontend/e2e/` (all arena, home, referrals, navigation, footer specs) - `scripts/check-arena-naming.sh` ## Constraints - Product mechanics remain canonical in `docs/product/time-arena.md` — docs describe UI, not redefine rules - E2E must use 5 Playwright workers per project convention - Branding: **Yield Omega** (with space) in user-facing test expectations - Keep `arena-*` CSS naming convention per #280 ## Acceptance criteria - [ ] `arena-views.md` and `design.md` describe the new command-console layout - [ ] Page-by-page content audit checklist exists and covers all routes - [ ] Manual QA checklists updated for visual + mechanics smoke - [ ] Playwright E2E specs pass with updated selectors - [ ] `npm run typecheck`, `npm run lint`, `npm test` pass in `frontend/` - [ ] `bash scripts/check-arena-naming.sh` passes
ghost1 commented 2026-06-07 09:53:19 +00:00 (Migrated from gitlab.com)

mentioned in commit 2dad029245

mentioned in commit 2dad0292454b44f7fffcc059bacf57cd759f86d4
PlasticDigits commented 2026-06-07 09:53:30 +00:00 (Migrated from gitlab.com)

mentioned in merge request !439

mentioned in merge request !439
ghost1 commented 2026-06-07 11:50:15 +00:00 (Migrated from gitlab.com)

mentioned in commit 383b979406

mentioned in commit 383b9794067e8326064ceeca264b6a5fadc5bd30
PlasticDigits (Migrated from gitlab.com) closed this issue 2026-06-07 11:57:50 +00:00
PlasticDigits commented 2026-06-07 11:58:18 +00:00 (Migrated from gitlab.com)

mentioned in commit 4d26577b8d

mentioned in commit 4d26577b8d332a76db37d773eee95bafaffee182
PlasticDigits commented 2026-06-07 12:02:48 +00:00 (Migrated from gitlab.com)

Verification report — GitLab #298

Issue: Frontend UX: update docs, invariants, and E2E coverage for the redesign

Branch verified: main @ 4d26577 (merge of cursor/issue-298-frontend-ux-docs-e2e-0369)

Verifier: Cloud Agent (agent:verify automation)


Acceptance criteria

Criterion Result How verified
arena-views.md and design.md describe command-console layout PASS Read docs/frontend/arena-views.md §291 (production arena-command-console) and docs/frontend/design.md §290 (cyberminimalist command console); both document Last Buy primary, inline CHARM buy, decision row, secondary operations rail, AUDIT console
Page-by-page content audit checklist covers all routes PASS docs/testing/frontend-content-audit.md exists with sections for /, /home, launch countdown, /arena, /arena/protocol, /arena/:code, /referrals, /kumbaya, /sir, 404, legacy redirects, shared primitives; frontend/src/lib/frontendContentAudit.test.ts asserts required sections
Manual QA checklists updated (visual + mechanics smoke) PASS docs/testing/manual-qa-checklists.md §298 documents visual smoke, mechanics smoke, and automated commands; cross-links to frontend-content-audit.md and invariants INV-FRONTEND-298-UX-DOCS-E2E
Playwright E2E specs pass with updated selectors PASS cd frontend && npm run build && CI=1 npm run test:e2e -- --workers=5 e2e/arena.spec.ts e2e/home.spec.ts e2e/navigation.spec.ts e2e/referrals-surface.spec.ts e2e/footer-site-links.spec.ts e2e/launch-countdown.spec.ts e2e/surface-shells.spec.ts e2e/referral-path.spec.ts → 23 passed, 2 skipped (launch-state conditional skips in launch-countdown.spec.ts)
npm run typecheck, npm run lint, npm test PASS typecheck exit 0; lint exit 0 (9 pre-existing warnings, 0 errors); vitest 110 files / 564 tests passed
bash scripts/check-arena-naming.sh PASS OK — no legacy timecurve-* identifiers in frontend/src

Manual QA §298 (visual + mechanics)

Check Result Evidence
Global shell: --yo-* glass, Time Arena / Referrals nav, Yield Omega brand PASS e2e/home.spec.ts, e2e/navigation.spec.ts; AgentFooterCard.tsx copy
/arena: single arena-command-console, Last Buy primary, inline buy, decision row, podiums PASS e2e/arena.spec.ts, e2e/anvil-arena-01-mount.spec.ts; arenaCommandConsoleStatic.test.ts
/arena/protocol: compact AUDIT hierarchy PASS e2e/arena.spec.ts AUDIT navigation
Home / launch countdown: PLAY TIME ARENA + AUDIT PASS e2e/home.spec.ts, e2e/launch-countdown.spec.ts
/referrals, /kumbaya, /sir, 404 glass surfaces PASS e2e/surface-shells.spec.ts, e2e/referrals-surface.spec.ts, e2e/navigation.spec.ts
Responsive 390×844 (no horizontal overflow on key routes) PASS e2e/arena.spec.ts mobile viewport test (included in focused run)
Mechanics copy: Arena v2 only; no TimeCurve / sale / PvE framing PASS surfaceContent.test.ts forbidden-copy assertions
Branding Yield Omega (with space) PASS E2E getByRole("heading", { name: "Yield Omega" }) on home/countdown; arena.spec.ts console chrome
arena-* CSS naming PASS check-arena-naming.sh

Rabby / Chromium full visual pass: SKIP — not required for docs/E2E gate; covered by Playwright preview smoke above. Optional chain writes (bash scripts/e2e-anvil.sh) not run in this verification pass.


Invariants

  • INV-FRONTEND-298-UX-DOCS-E2E documented in docs/testing/invariants-and-business-logic.md with command mapping — PASS

Outcome

All acceptance criteria PASS. No repository changes required from this verification pass.

## Verification report — GitLab #298 **Issue:** [Frontend UX: update docs, invariants, and E2E coverage for the redesign](https://gitlab.com/PlasticDigits/yieldomega/-/work_items/298) **Branch verified:** `main` @ `4d26577` (merge of `cursor/issue-298-frontend-ux-docs-e2e-0369`) **Verifier:** Cloud Agent (`agent:verify` automation) --- ### Acceptance criteria | Criterion | Result | How verified | |-----------|--------|--------------| | `arena-views.md` and `design.md` describe command-console layout | **PASS** | Read `docs/frontend/arena-views.md` §291 (production `arena-command-console`) and `docs/frontend/design.md` §290 (cyberminimalist command console); both document Last Buy primary, inline CHARM buy, decision row, secondary operations rail, AUDIT console | | Page-by-page content audit checklist covers all routes | **PASS** | `docs/testing/frontend-content-audit.md` exists with sections for `/`, `/home`, launch countdown, `/arena`, `/arena/protocol`, `/arena/:code`, `/referrals`, `/kumbaya`, `/sir`, 404, legacy redirects, shared primitives; `frontend/src/lib/frontendContentAudit.test.ts` asserts required sections | | Manual QA checklists updated (visual + mechanics smoke) | **PASS** | `docs/testing/manual-qa-checklists.md` §298 documents visual smoke, mechanics smoke, and automated commands; cross-links to `frontend-content-audit.md` and invariants `INV-FRONTEND-298-UX-DOCS-E2E` | | Playwright E2E specs pass with updated selectors | **PASS** | `cd frontend && npm run build && CI=1 npm run test:e2e -- --workers=5 e2e/arena.spec.ts e2e/home.spec.ts e2e/navigation.spec.ts e2e/referrals-surface.spec.ts e2e/footer-site-links.spec.ts e2e/launch-countdown.spec.ts e2e/surface-shells.spec.ts e2e/referral-path.spec.ts` → **23 passed**, 2 skipped (launch-state conditional skips in `launch-countdown.spec.ts`) | | `npm run typecheck`, `npm run lint`, `npm test` | **PASS** | typecheck exit 0; lint exit 0 (9 pre-existing warnings, 0 errors); vitest **110 files / 564 tests** passed | | `bash scripts/check-arena-naming.sh` | **PASS** | `OK — no legacy timecurve-* identifiers in frontend/src` | --- ### Manual QA §298 (visual + mechanics) | Check | Result | Evidence | |-------|--------|----------| | Global shell: `--yo-*` glass, **Time Arena** / **Referrals** nav, **Yield Omega** brand | **PASS** | `e2e/home.spec.ts`, `e2e/navigation.spec.ts`; `AgentFooterCard.tsx` copy | | `/arena`: single `arena-command-console`, Last Buy primary, inline buy, decision row, podiums | **PASS** | `e2e/arena.spec.ts`, `e2e/anvil-arena-01-mount.spec.ts`; `arenaCommandConsoleStatic.test.ts` | | `/arena/protocol`: compact **AUDIT** hierarchy | **PASS** | `e2e/arena.spec.ts` AUDIT navigation | | Home / launch countdown: **PLAY TIME ARENA** + **AUDIT** | **PASS** | `e2e/home.spec.ts`, `e2e/launch-countdown.spec.ts` | | `/referrals`, `/kumbaya`, `/sir`, 404 glass surfaces | **PASS** | `e2e/surface-shells.spec.ts`, `e2e/referrals-surface.spec.ts`, `e2e/navigation.spec.ts` | | Responsive 390×844 (no horizontal overflow on key routes) | **PASS** | `e2e/arena.spec.ts` mobile viewport test (included in focused run) | | Mechanics copy: Arena v2 only; no TimeCurve / sale / PvE framing | **PASS** | `surfaceContent.test.ts` forbidden-copy assertions | | Branding **Yield Omega** (with space) | **PASS** | E2E `getByRole("heading", { name: "Yield Omega" })` on home/countdown; `arena.spec.ts` console chrome | | `arena-*` CSS naming | **PASS** | `check-arena-naming.sh` | **Rabby / Chromium full visual pass:** **SKIP** — not required for docs/E2E gate; covered by Playwright preview smoke above. Optional chain writes (`bash scripts/e2e-anvil.sh`) not run in this verification pass. --- ### Invariants - **`INV-FRONTEND-298-UX-DOCS-E2E`** documented in `docs/testing/invariants-and-business-logic.md` with command mapping — **PASS** --- ### Outcome All acceptance criteria **PASS**. No repository changes required from this verification pass.
PlasticDigits commented 2026-06-08 08:45:13 +00:00 (Migrated from gitlab.com)

mentioned in commit 0eb35a5cd1

mentioned in commit 0eb35a5cd18adad2e98cae3191f434ca6dd7f360
PlasticDigits commented 2026-06-08 08:45:14 +00:00 (Migrated from gitlab.com)

mentioned in commit 0fb75d964c

mentioned in commit 0fb75d964ca0b055d73fc300e4e5053b4513b3f0
PlasticDigits commented 2026-06-13 07:02:53 +00:00 (Migrated from gitlab.com)

mentioned in issue #309

mentioned in issue #309
PlasticDigits commented 2026-06-13 07:34:27 +00:00 (Migrated from gitlab.com)

mentioned in issue #318

mentioned in issue #318
PlasticDigits commented 2026-06-19 03:09:46 +00:00 (Migrated from gitlab.com)

mentioned in issue #331

mentioned in issue #331
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
code/yieldomega#298
No description provided.