Repository navigation
Description
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 indesktop-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-componentoverlay anddesktop-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
- Depended on: F2 Infrastructure: Implement settled desktop lifecycle supervision and fenced ownership records #4442 (exact ownership and claim contract; closed, Desktop driver: typed resources, process lifelines, story lifetimes, exclusive agent ingress, and native qualification runbook #4463).
- Enabled: the retained supervisor-launched app option, now tracked in F9 Infrastructure: Convert Storybook lifecycle takeover into desktop-test resource contributions #4449.
- Parallel with: F10-W Infrastructure: Implement neutral Windows desktop application ownership and containment #4447, F5 Infrastructure: Authorize and settle every controlled Storybook mutation entrance #4443, and F6 Infrastructure: Tighten Storybook manifest provenance and native helper trust handoff #4445.
Acceptance
- PID reuse, duplicate bundle identities, permission failure, interrupted publication, surviving descendants, and foreign or stale exit events fail closed. (#4492) Forced OS PID recycling and arbitrary descendant containment are not qualified - tracked in Infrastructure: Qualify desktop lifecycle failure paths and maintain a support matrix #4451
- Attached applications survive cleanup; owned applications close by exact identity. (#4492)
- Stable signing and TCC responsibility behavior is qualified on macOS Fabric and macOS Paper. Stable-signed helper lifecycle and accessible smokes passed on both (#4492, #4493); TCC revocation, regrant and durable grants - tracked in Infrastructure: Complete Desktop Driver production release qualification #4345
Validation
- Iterate with focused
yarn test <name>in each changed package, then run itsyarn format,yarn lint,yarn build, andyarn test. Finish withyarn clean-lage-cachethenyarn lage buildci; runyarn lage test-links --verbose --groupedafter 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.mdkeeps a status overview, stable topic sections, and only the latest result per native endpoint with a link. - Retired plan:
driver-next.mdat0569e1b86, section 8 (F10-M).
Activity
JasonVMo commentedon Nov 16, 2026
Closing as completed by #4492, with permission-enabled macOS evidence from #4493.
Landed: neutral
desktop-test/application-ownershipwith 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 buildcifailed on an unrelatedboundedCommandassertion and is not claimed; hosted CI passed.Residual items moved to open issues: