From e5324998d095c14bc3c20cd2f41b805f66953863 Mon Sep 17 00:00:00 2001 From: sechmachine <97589681+sechmachine727@users.noreply.github.com> Date: Tue, 11 Aug 2026 02:29:10 +0700 Subject: [PATCH] docs(openspec): reconcile adaptive workspace cards --- openspec/changes/phase-3d-macos-native-mvp/design.md | 9 ++++++--- openspec/changes/phase-3d-macos-native-mvp/proposal.md | 6 ++++-- .../specs/macos-workspace/spec.md | 4 ++-- openspec/changes/phase-3d-macos-native-mvp/tasks.md | 2 +- 4 files changed, 13 insertions(+), 8 deletions(-) diff --git a/openspec/changes/phase-3d-macos-native-mvp/design.md b/openspec/changes/phase-3d-macos-native-mvp/design.md index 175cf25..e11901b 100644 --- a/openspec/changes/phase-3d-macos-native-mvp/design.md +++ b/openspec/changes/phase-3d-macos-native-mvp/design.md @@ -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 diff --git a/openspec/changes/phase-3d-macos-native-mvp/proposal.md b/openspec/changes/phase-3d-macos-native-mvp/proposal.md index dd43320..971a84c 100644 --- a/openspec/changes/phase-3d-macos-native-mvp/proposal.md +++ b/openspec/changes/phase-3d-macos-native-mvp/proposal.md @@ -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`). diff --git a/openspec/changes/phase-3d-macos-native-mvp/specs/macos-workspace/spec.md b/openspec/changes/phase-3d-macos-native-mvp/specs/macos-workspace/spec.md index 3037c91..2de0201 100644 --- a/openspec/changes/phase-3d-macos-native-mvp/specs/macos-workspace/spec.md +++ b/openspec/changes/phase-3d-macos-native-mvp/specs/macos-workspace/spec.md @@ -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 diff --git a/openspec/changes/phase-3d-macos-native-mvp/tasks.md b/openspec/changes/phase-3d-macos-native-mvp/tasks.md index 0c69799..fafae61 100644 --- a/openspec/changes/phase-3d-macos-native-mvp/tasks.md +++ b/openspec/changes/phase-3d-macos-native-mvp/tasks.md @@ -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