Plan and build visionOS companion surface

[shiny-code-bot]

Objective

Plan and build a visionOS Context Panel companion surface using the same shared model, sync, and UI foundations as iPhone/iPad.

Finish Line

visionOS has an intentional read-only Context Panel companion experience that does not run provider connectors or duplicate widget UI logic, and it respects the actual visionOS app/widget surface available for the target OS versions.

Current Status

The visionOS companion surface has moved from packaging/upload repair into physical-device validation on a fixed replacement build.

Completed in this pass:

• PR Add visionOS companion appearance controls #243 merged to main at 667863eac05fb8d72b0256e48014ad9e653dc2f4, adding visionOS-only Appearance controls:
  • App: Dark or Light.
  • Widget: Match App, Dark, or Light.
  • iOS and macOS remain system-adaptive.
• PR Fix visionOS companion appearance controls #244 merged to main at 63fd50a, fixing the first AVP-tested appearance regression by applying one explicit visionOS app palette to all companion sections and keeping widget appearance isolated to widget rendering.
• PR Keep visionOS app preview tied to app appearance #245 merged to main at 047b3c7, correcting the in-app widget-shaped preview so it follows App appearance rather than the Widget selector.
• Fixed replacement visionOS TestFlight build 1.0.29 / 202606212142 was uploaded and distributed to internal group OG.

Active child/validation lane: #231. Next decision point is AVP TestFlight smoke evidence on build 1.0.29 / 202606212142 and approved screenshots before selecting a visionOS App Store build or submitting for review.

Current Status

The visionOS companion surface has moved from packaging/upload repair into physical-device validation on a fixed replacement build.

Completed in this pass:

• PR Add visionOS companion appearance controls #243 merged to main at 667863eac05fb8d72b0256e48014ad9e653dc2f4, adding visionOS-only Appearance controls:
  • App: Dark or Light.
  • Widget: Match App, Dark, or Light.
  • iOS and macOS remain system-adaptive.
• PR Fix visionOS companion appearance controls #244 merged to main at 63fd50a, fixing the first AVP-tested appearance regression by applying one explicit visionOS app palette to all companion sections and keeping widget appearance isolated to widget rendering.
• PR Keep visionOS app preview tied to app appearance #245 merged to main at 047b3c7, correcting the in-app widget-shaped preview so it follows App appearance rather than the Widget selector.
• Fixed replacement visionOS TestFlight build 1.0.29 / 202606212142 was uploaded and distributed to internal group OG.

Active child/validation lane: #231. Next decision point is AVP TestFlight smoke evidence on build 1.0.29 / 202606212142 and approved screenshots before selecting a visionOS App Store build or submitting for review.

Scope

• Verify the actual visionOS WidgetKit/app surface for target OS versions.
• Decide whether the first deliverable is a widget, app, ornament-like surface, or app-first companion.
• Reuse shared snapshot and glance UI components where they fit.
• Keep spatial/Liquid Glass styling separate from mechanical platform support.

Acceptance Criteria

• visionOS implementation does not require provider credentials, OAuth, local auth files, refresh execution, or Mac App Group access.
• Platform support and widget/app families are confirmed before target work begins.
• The visionOS surface displays stale/no-iCloud/no-Mac states clearly.
• Shared UI changes required by visionOS do not regress iPhone/iPad/macOS layouts.
• Any spatial or Liquid Glass treatment remains isolated from the mechanical port.

Next Action

Revisit after iPhone/iPad companion sync is working, then confirm visionOS surface constraints with the active Xcode/SDK.

Relationships

Parent: #163