Skip to content

chore(studio): track project-mode unification#1252

Merged
christso merged 2 commits into
mainfrom
chore/studio-unify-project-mode
May 19, 2026
Merged

chore(studio): track project-mode unification#1252
christso merged 2 commits into
mainfrom
chore/studio-unify-project-mode

Conversation

@christso
Copy link
Copy Markdown
Collaborator

Objective

Converge Studio onto a single project-scoped architecture so "single-project mode" becomes a UI presentation choice, not a separate routing/data path.

Why

  • PR fix(studio): scope experiment detail pages to project #1251 fixed a bug caused by drift between unscoped single-project experiment detail pages and project-scoped multi-project pages.
  • The current split makes routes, navigation, breadcrumbs, and data fetching easy to diverge.
  • Phoenix-style behavior is the target: when one project exists, auto-focus it; when many exist, show project selection; underneath, use the same project-scoped pages.

Proposed approach

  1. Make project-scoped routes the canonical Studio routes for runs, experiments, analytics, targets, and drill-down pages.
  2. Treat the current unscoped home as a thin redirect/selection layer:
    • 0 projects: onboarding/empty state
    • 1 project: automatically land on that project
    • many projects: show projects dashboard / picker
  3. Move any remaining unscoped data loaders, links, sidebar logic, and breadcrumbs onto project-scoped equivalents.
  4. Preserve current UX features; only remove duplicate mode-specific plumbing.
  5. Add focused regression coverage for route/link generation so single-vs-multi drift cannot recur.

Acceptance signals

  • Opening Studio with one registered project still gives a streamlined experience, without exposing broken or missing features.
  • Opening Studio with many projects uses the same run/experiment/detail pages after a project is selected.
  • No page fetches unscoped run/experiment data after a project has been selected.
  • Sidebar, breadcrumbs, and deep links remain project-aware across runs, experiments, evals, analytics, and targets.
  • Existing URLs either continue to work or redirect cleanly to project-scoped URLs.

Non-goals

  • Redesigning Studio visuals
  • Changing scoring or backend result semantics
  • Reworking project registry behavior beyond what is needed to unify the UI flow

Suggested implementation order

  1. Inventory remaining unscoped routes/components used after project selection.
  2. Introduce redirect behavior from single-project entrypoints to the selected project.
  3. Remove duplicate unscoped detail pages once project-scoped equivalents fully cover them.
  4. Add regression tests for project-aware navigation and route generation.

Handoff notes

Document the follow-up work to converge Studio onto one project-scoped routing and data model so single-project mode becomes a presentation choice instead of a separate app path.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented May 19, 2026

Deploying agentv with  Cloudflare Pages  Cloudflare Pages

Latest commit: 58251b5
Status:⚡️  Build in progress...

View logs

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@christso christso marked this pull request as ready for review May 19, 2026 22:45
@christso christso merged commit 5278f48 into main May 19, 2026
1 check was pending
@christso christso deleted the chore/studio-unify-project-mode branch May 19, 2026 22:46
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