Skip to content

contracts: extend workstation examples for Mac-on-Linux polish signals#81

Open
Copilot wants to merge 2 commits intomainfrom
copilot/update-workstation-examples-mac-on-linux
Open

contracts: extend workstation examples for Mac-on-Linux polish signals#81
Copilot wants to merge 2 commits intomainfrom
copilot/update-workstation-examples-mac-on-linux

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 2, 2026

The workstation contract examples lacked representation of Mac-on-Linux polish surfaces shipped in SociOS-Linux/source-os (screenshot helper, Quick Look/Sushi, sidebar bookmarks, appearance defaults, keyboard remap policy, aggregate polish validation).

Schema extensions (additive, non-breaking)

WorkstationProfile

  • macOnLinuxPolish — optional object capturing active polish signals: status (enum: active | planned | non-goal), screenshotHelperCommand, quickLookPackages, keymapPolicyRef
  • validation.polishValidationCommand — aggregate polish validation entrypoint

DesktopProfile

  • appearance — bounded appearance defaults: colorScheme, accentColor, fontScaling
  • sidebarBookmarks — Finder-style sidebar bookmark list (label + path)

Updated examples

workstationprofile.json:

"macOnLinuxPolish": {
  "status": "active",
  "screenshotHelperCommand": "sourceos-screenshot",
  "quickLookPackages": ["gnome-sushi"],
  "keymapPolicyRef": "urn:srcos:keymap-profile:mac-linux-primary"
},
"validation": {
  "polishValidationCommand": "sourceos polish validate --json"
}

desktopprofile.json:

"appearance": { "colorScheme": "dark", "fontScaling": 1.0 },
"sidebarBookmarks": [
  { "label": "Home", "path": "~/" },
  { "label": "Code", "path": "~/code" }
]

Docs

docs/workstation-contract-family.md gains a Mac-on-Linux polish signals section that:

  • Tables active signals against their contract fields
  • Explicitly lists future/non-goal signals (deep MIME registration, per-app appearance, full macOS parity)
  • States implementation authority remains in SociOS-Linux/source-os

- Extend WorkstationProfile schema with optional macOnLinuxPolish object
  (status, screenshotHelperCommand, quickLookPackages, keymapPolicyRef) and
  validation.polishValidationCommand
- Extend DesktopProfile schema with optional appearance (colorScheme,
  accentColor, fontScaling) and sidebarBookmarks fields
- Update workstationprofile.json example with active mac polish signals
- Update desktopprofile.json example with appearance defaults and sidebar bookmarks
- Expand workstation-contract-family.md with Mac polish section distinguishing
  active vs future/non-goal signals and stating implementation authority in
  SociOS-Linux/source-os

Closes #<issue-number>

Agent-Logs-Url: https://github.com/SourceOS-Linux/sourceos-spec/sessions/5a28c60b-2317-4af5-ba15-5ad53a02ceb1

Co-authored-by: mdheller <21163552+mdheller@users.noreply.github.com>
Copilot AI changed the title [WIP] Update workstation examples for Mac-on-Linux polish signals contracts: extend workstation examples for Mac-on-Linux polish signals May 2, 2026
Copilot AI requested a review from mdheller May 2, 2026 19:01
@mdheller mdheller marked this pull request as ready for review May 3, 2026 01:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

contracts: extend workstation examples for Mac-on-Linux polish signals

2 participants