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

2.3 KiB

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