Skip to content

docs(testing): rewrite the UI test phases for the v1 UI - #3437

Merged
vybe merged 1 commit into
devfrom
docs/ui-scenarios-v1-refresh
Oct 9, 2026
Merged

vybe merged 1 commit into
devfrom
docs/ui-scenarios-v1-refresh

Conversation

@trinity-ability

Copy link
Copy Markdown
Contributor

What

Rewrites the click-through UI test phases in docs/testing/phases/ for the v1 UI. Docs only.

  • 23 phases rewritten against current source (0–5, 9, 11–13, 15, 17–28).
  • 5 phases retired as short stubs that say why and what covers them now: 7 (Scheduling), 8 (Execution Queue), 10 (Error Handling), 14 (OpenTelemetry), 16 (Web Terminal).
  • 9 phases added (29–37): Workspace chats; Workspace inbox, rooms and projects; Operations; Library; the newer agent-detail tabs; Canvas and shared canvas links; Settings keys and retention; onboarding and app chrome; mobile admin.
  • README.md and INDEX.md rewritten. References to a run_test_phases.py runner are gone — it never existed.

Why

The phases dated from January and none matched the product. They typed into a Terminal tab that is hidden, started at /agents (now a redirect), assumed eight GitHub-template agents (three local fixtures exist), and tested pages that are gone (/credentials, the system-agent page, the dashboard graph, a Public Links tab). Phase 0 deleted the fixture agents by name and phase 12 was "delete all agents", so the set could not be run unattended.

Rules every phase now follows

Independent of every other phase · only the three local fixture agents (plus one self-deleted sweep-tmp-… throwaway where creation or deletion is the thing under test) · reads and restores anything it changes · no credentials or real addresses · steps needing a second user, a mailbox, an external repository, a fresh database or a fleet-wide action sit under a Manual-only heading.

How it was checked

  • Each author verified routes, tabs, labels and endpoints in source before writing them.
  • A mechanical pass over the result: every /api/… path resolves to a backend route, and 813 of 879 quoted UI strings match source verbatim; the remainder are templated strings ("N shown"), test data, or quotes of the old flow.
  • The public-docs guard pattern from enterprise-docs-guard.yml has no hits.

Not done

No phase has been run in a browser since the rewrite. The index marks every phase 🟡 or 🆕 for that reason. Expect the first run of each to need a few steps tightened.

🤖 Generated with Claude Code

The 28 click-through phases dated from January and none matched the
product: they drove a Terminal tab that is hidden, an /agents page that
is now a redirect, eight GitHub-template agents of which three exist,
and several pages that are gone. Two of them deleted the fixture agents.

- Rewrite the 23 surviving phases against current source. Every phase is
  now independent, uses only the three local fixture agents, restores
  what it changes, carries no credentials, and moves anything that needs
  a second user, a mailbox, an external repo or a fresh database under a
  Manual-only heading.
- Retire phases 7, 8, 10, 14 and 16 as short stubs that say why and what
  covers them now.
- Add phases 29-37 for surfaces that had no scenario: Workspace (chats;
  inbox, rooms, projects), Operations, Library, the newer agent tabs,
  Canvas and shared canvas links, Settings keys and retention,
  onboarding and app chrome, mobile admin.
- Rewrite README.md and INDEX.md; drop references to a
  run_test_phases.py runner that never existed.

Source-verified only: no phase has been run in a browser since the
rewrite, and the index marks each one accordingly.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@vybe vybe left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

merge-train: batch validated on train/20261009-2324-b (#3504)

@vybe
vybe merged commit 4d411aa into dev Oct 9, 2026
23 of 26 checks passed
vybe pushed a commit that referenced this pull request Oct 10, 2026
Conflicts: docs/testing/phases/PHASE_14_OPENTELEMETRY.md (kept dev's
retired-phase rewrite from #3437, repointed its two mentions of the
removed /api/observability routes at /api/ops/costs) and
tests/registry.json (rebuilt from git stages: dev's file minus the
entry this branch removed plus the entry it added).

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

Labels

type-docs Documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants