Skip to content

Infrastructure: Implement neutral macOS desktop application ownership and identity recovery #4446

Closed

Description

@JasonVMo

Status: Done

Landed in #4492, with macOS permission-enabled evidence recorded in #4493: neutral desktop-test/application-ownership with exact macOS attach identity, opt-in supervisor-owned launch (session-owned launch stays the default; attached apps stay external), claim schema 3 using the driver's OS start identity, LaunchServices versus direct-child causality, both macOS launch kinds recorded as uncontained, and fail-closed handling of duplicate, foreign, stale and surviving identities. Qualified natively on macOS Fabric and macOS Paper with the stable-signed helper.

Residual items now live elsewhere: TCC grant/revoke/regrant, durable helper-owned grants and signing policy in #4345; macOS requalification, launch-capable discovery on macOS and survivor/failed-cleanup cases in #4441; forced PID recycling, arbitrary descendant containment, power-loss rename and repeated-run reliability in #4451; moving Storybook's attach lease to the neutral harness in #4449.

Goal

On macOS, attach identity (the application lease) lives in the Storybook integration, and there is no supervisor-owned launch: a launched app is owned by its driver session, and an attached app is owned externally. Move generic attach identity into the neutral harness and add opt-in supervisor-owned launch with exact identity recovery.

Part of #4435 (plan item F10-M).

Scope

  • Owner: macOS lifecycle backend.
  • Paths (under packages/agentic/): neutral application ownership adapters in desktop-test, and the driver's macOS authority and native support only where needed, with native contracts.
  • Move generic attach-identity duties out of Storybook.
  • Add opt-in supervisor-owned launch; attached applications stay external.
  • Distinguish LaunchServices causal ownership from direct child-process ownership.
  • Native helper changes follow the implement-native-component overlay and desktop-driver/native/PROTOCOL.md.
  • Moving Storybook's existing lease code is an integration commit after F9 Infrastructure: Convert Storybook lifecycle takeover into desktop-test resource contributions #4449, not a blocker for backend work.

Dependencies

Acceptance

Validation

  • Iterate with focused yarn test <name> in each changed package, then run its yarn format, yarn lint, yarn build, and yarn test. Finish with yarn clean-lage-cache then yarn lage buildci; run yarn lage test-links --verbose --grouped after markdown changes.
  • Add a patch changeset for each changed published package. Update the affected topic section and its status-overview line in the owning references/current-status.md, and affected README/AGENTS guidance, in the same change.
  • Native, provider, or process-topology changes need matching-OS native contracts and the affected consumer lane. JavaScript tests and bundles do not qualify native behavior; hosted capability skips are not passes. Report each check as passed, failed, skipped, not run, or unsupported.

Evidence

  • Current state: per-run evidence is recorded in the pull request description or an issue comment (#4492, #4493); each package's references/current-status.md keeps a status overview, stable topic sections, and only the latest result per native endpoint with a link.
  • Retired plan: driver-next.md at 0569e1b86, section 8 (F10-M).

Activity

  1. JasonVMo commented on Nov 16, 2026

    @JasonVMo
    ContributorAuthor

    Closing as completed by #4492, with permission-enabled macOS evidence from #4493.

    Landed: neutral desktop-test/application-ownership with exact macOS attach identity and opt-in supervisor-owned launch (session-owned stays the default; attached apps stay external); claim schema 3 with OS start identity; LaunchServices versus direct-child causality, with both launch kinds recorded as uncontained; duplicate, foreign and stale identity refusal; cross-helper exclusion.

    Evidence: on macOS with the stable-signed helper, 43 ownership tests passed (13 real AppKit), covering interrupted acquired-record publication, owner death and a known-descendant survivor (claim stays fenced). macOS Fabric and macOS Paper each passed the ownership lifecycle checks and the accessible Storybook smoke. Local yarn lage buildci failed on an unrelated boundedCommand assertion and is not claimed; hosted CI passed.

    Residual items moved to open issues:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions