# Quickstart: Workspace Switch Semantic Fix

**Feature**: 121-workspace-switch-fix | **Date**: 2026-03-07

## Scope

A small navigation-semantic correction:
- update the context-bar `Switch workspace` link,
- remove the duplicate user-menu `Switch workspace` shortcut,
- keep chooser behavior unchanged,
- keep workspace management navigation unchanged,
- add focused regression coverage.

## Implementation order

1. Update [resources/views/filament/partials/context-bar.blade.php](../../../resources/views/filament/partials/context-bar.blade.php) so `Switch workspace` targets the chooser helper with `?choose=1`.
2. Remove the admin user-menu `Switch workspace` shortcut from [app/Providers/Filament/AdminPanelProvider.php](../../../app/Providers/Filament/AdminPanelProvider.php).
3. Extend [tests/Feature/Monitoring/HeaderContextBarTest.php](../../../tests/Feature/Monitoring/HeaderContextBarTest.php) to assert the rendered context-bar link points to the chooser target.
4. Extend [tests/Feature/Workspaces/WorkspaceSwitchUserMenuTest.php](../../../tests/Feature/Workspaces/WorkspaceSwitchUserMenuTest.php) to assert no user-menu shortcut is registered.
5. Add or extend one workspace regression test to confirm management navigation remains separately reachable.
6. Run focused Sail-based tests.
7. Run Pint on dirty files.

## Reference files

- [app/Filament/Pages/ChooseWorkspace.php](../../../app/Filament/Pages/ChooseWorkspace.php)
- [app/Providers/Filament/AdminPanelProvider.php](../../../app/Providers/Filament/AdminPanelProvider.php)
- [app/Http/Middleware/EnsureWorkspaceSelected.php](../../../app/Http/Middleware/EnsureWorkspaceSelected.php)
- [tests/Feature/Workspaces/WorkspaceSwitchUserMenuTest.php](../../../tests/Feature/Workspaces/WorkspaceSwitchUserMenuTest.php)
- [tests/Feature/Workspaces/ChooseWorkspacePageTest.php](../../../tests/Feature/Workspaces/ChooseWorkspacePageTest.php)

## Validation commands

```bash
vendor/bin/sail artisan test --compact tests/Feature/Monitoring/HeaderContextBarTest.php
vendor/bin/sail artisan test --compact tests/Feature/Workspaces/WorkspaceSwitchUserMenuTest.php
vendor/bin/sail artisan test --compact tests/Feature/Workspaces/ChooseWorkspacePageTest.php
vendor/bin/sail bin pint --dirty --format agent
```

## Expected outcome

- Context-bar switching always opens the chooser.
- The top-right user menu does not offer a duplicate workspace switch entry.
- Workspace management remains a separate administrative path.
- Existing chooser branching behavior and middleware semantics remain unchanged.