docs(openspec): reconcile adaptive workspace cards
Verify Data Plane / gateway (push) Successful in 4m47s

This commit is contained in:
sechmachine
2026-08-11 02:29:10 +07:00
parent f981823909
commit e5324998d0
4 changed files with 13 additions and 8 deletions
@@ -89,9 +89,12 @@ review evidence only.
- The client uses `NavigationSplitView`, native controls/materials, and standard macOS 26
Liquid Glass APIs conditionally. macOS 15/14 retain identical hierarchy with native
materials; no custom glass framework is introduced.
- Desktop cards remain `328 x 205 pt`; an adaptive grid only changes column count. Card
actions remain accessible without hover, and no direct-connect button or endpoint entry is
added.
- Desktop cards use a bounded adaptive `300...360 pt` width, `16:10` aspect ratio, and
`16 pt` spacing. Cards grow continuously within natural column bands, including three
columns; a new column appears only when every card can remain at least `300 pt` wide;
cards clamp at `360 pt` and retain residual row width. Screenshot pixels are
non-authoritative. Card actions remain accessible without hover, and no direct-connect
button or endpoint entry is added.
- Automatic mode reads physical pixels for the screen where the session window opens and
uses its maximum FPS. A defensible notch-safe built-in mode is preferred; otherwise Full
Native is disclosed. A display move offers a new-session reconnect and never mutates the
@@ -10,8 +10,10 @@ control and transport boundaries.
- Build the Apple-Silicon SwiftUI/AppKit client and platform-neutral Rust Streaming Core
behind one sized/versioned C ABI (`P3D-001``P3D-031`).
- Implement the reviewed native workspace, fixed preview cards, Favorites, search/sort,
settings, accessibility, and privacy-bounded desktop previews (`P3D-032`, `P3D-037`).
- Implement the reviewed native workspace, bounded adaptive `300...360 pt` `16:10` preview
cards with `16 pt` spacing and natural columns, Favorites, search/sort, settings,
accessibility, and privacy-bounded desktop previews (`P3D-032`, `P3D-037`). Screenshot
pixels are behavioral evidence, not authoritative geometry constants.
- Add feature-gated requested/effective display modes, Server-owned policy clamping,
client display detection/disclosure, and explicit reconnect-on-display-change behavior
(`P3D-033``P3D-034`).
@@ -1,11 +1,11 @@
## ADDED Requirements
### Requirement: P3D-032 native desktop workspace
The app SHALL expose Favorites, Desktops, Pools, and Settings in a native split workspace without Apps, Add PC, manual endpoint, or direct-provider surfaces. Desktop cards SHALL remain `328 x 205 pt`, use full-bleed previews and subtle readable metadata treatment, and adapt only the grid column count.
The app SHALL expose Favorites, Desktops, Pools, and Settings in a native split workspace without Apps, Add PC, manual endpoint, or direct-provider surfaces. 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 geometry remains fixed, the column count changes, and text/actions do not overflow
- **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
@@ -35,7 +35,7 @@
## 6. Workspace and Display UX
- [ ] 6.1 Build the screenshot-backed Favorites/Desktops/Pools/Settings shell with fixed `328 x 205 pt` cards, adaptive columns, safe truncation, native focus/VoiceOver, and no Apps/Add-PC/direct endpoint surfaces
- [ ] 6.1 Build the screenshot-backed Favorites/Desktops/Pools/Settings shell with bounded adaptive `300...360 pt` `16:10` cards, `16 pt` spacing, continuous within-band growth, natural minimum-triggered columns including three, maximum clamp/residual width, safe truncation, native focus/VoiceOver, and no Apps/Add-PC/direct endpoint surfaces; treat screenshot pixels as non-authoritative
- [ ] 6.2 Add global and resource Automatic/preset/Custom/Full Native settings, physical-pixel/FPS detection, notch-safe disclosure, and requested/accepted projections with deterministic display fakes
- [ ] 6.3 Add aspect-fit viewport math, letterbox pointer exclusion, display-move reconnect offer, and new-session/idempotency behavior tests
- [ ] 6.4 Pass geometry/hierarchy/visibility/responsive/accessibility automation and bounded macOS 26/15/14 native-material review