Files
VerseVDI-Data-Plane/openspec/changes/phase-3d-macos-native-mvp/specs/macos-workspace/spec.md
T
sechmachine a1d68d33e5
Verify Data Plane / gateway (push) Successful in 4m42s
docs(openspec): reconcile workspace command surfaces
2026-08-11 12:57:01 +07:00

28 lines
2.3 KiB
Markdown

## ADDED Requirements
### Requirement: P3D-032 native desktop workspace
The app SHALL expose All, Favorites, Desktops, and Pools in a native split workspace without Apps, Add PC, manual endpoint, or direct-provider surfaces. Settings SHALL open from the app menu in a separate regular window, and a Connections menu SHALL expose applicable resource commands. Desktop cards SHALL use a bounded adaptive `300...360 pt` width, `16:10` aspect ratio, and `16 pt` spacing; grow continuously within natural column bands including three columns; add a column only when every card remains at least the minimum; clamp at the maximum with residual row width; and use full-bleed previews with subtle readable metadata treatment. Screenshot pixels SHALL be non-authoritative.
#### Scenario: Narrow and wide resize
- **WHEN** the workspace moves between narrow, medium, and wide widths
- **THEN** card width stays within `300...360 pt`, height preserves `16:10`, cards resize continuously within a column band, natural column transitions include three columns, and text/actions do not overflow
#### Scenario: Accessible card actions
- **WHEN** a card receives hover or keyboard focus
- **THEN** Favorite and settings controls become available without adding a connect button; double-click or Return connects
#### Scenario: Settings and Connections surfaces
- **WHEN** the user invokes Settings or a Connections command
- **THEN** Settings opens in its separate regular window and a resource command acts only on the currently visible selection; Return connects only a focused card
### Requirement: P3D-037 private favorites and previews
Favorites, search, sort, filters, diagnostics, and previews SHALL reveal only current authorized resources. A stable desktop MAY retain one `656 x 410` mode-`0600` preview only after an active session ends cleanly; pool art is generic and preview bytes are excluded from backup/telemetry/log/crash/support data.
#### Scenario: Failed launch and clean end
- **WHEN** a launch fails and a later active session ends cleanly
- **THEN** the failed launch preserves the old preview and only the clean end atomically replaces it
#### Scenario: Entitlement loss
- **WHEN** logout or reconciliation removes a desktop entitlement
- **THEN** its preview is cleared and cannot appear through Favorites, search, cache, or diagnostics