Repository navigation
Description
Current status - 2026-11-16
Ready; unblocked by #4490 (F6). Merged prerequisites: F1 composition (#4455), F7 boundary guards (#4454), F2 settled lifecycle and F3 lifelines/readiness (#4463), F6 manifest provenance and credential isolation (#4490), the generic attach-only handoff from F11 (#4491), and neutral application ownership (#4492 macOS, #4494 Windows). #4442, #4444, #4445, #4446, #4447 and #4448 are closed.
Storybook still replaces the neutral CLI lifecycle through its transitional integration (integration.run, supportsAgent, adapter-written readiness), and its outer CLI claim still carries unregistered target/instance placeholders (#4492). The shared driver-service factory, typed resources, and passing smoke do not mean this takeover has been removed. Migrate Metro, channel, context and workload runners to the same real neutral resource owner. Preserve CLI compatibility and Windows port 8081, and never adopt unknown occupants or start a redundant driver. Preserve the #4490 contracts while moving code: strict v3 manifests, owner-private bridge and attachment credentials, helper provenance re-verified by the channel child, and the protected Windows lease.
Existing attach-only behavior is sufficient; native supervisor launch and transparent bridge reconnect are not global prerequisites. F4 #4437 and F5 #4443 are closed (#4463), and their macOS evidence moved to #4441. They gated exclusive controlled-context claims, not the base contribution migration.
Follow-up phases moved here from closed F11 #4448 and F10-M #4446 are listed under Scope: Storybook runner handoff, the retained supervisor-launched application option, and relocation of Storybook's macOS attach-lease duties.
Goal
storybook-desktop replaces the whole desktop-test CLI lifecycle through integration.run; #4434 marks that takeover, supportsAgent, and adapter-written readiness as transitional. Make Storybook contribute Metro, channel, context, and workload runners to the shared host instead, so storybook driver and neutral serve use one resource-ownership implementation.
Part of #4435 (plan item F9).
Scope
- Owner: Storybook and harness integration.
- Paths (under
packages/agentic/):storybook-desktop/src/{config/integration.ts,cli/*,driver/driverManifest.ts},storybook-desktop/config/server.cjs, and harness integration call sites. - Contribute Metro, channel, and context resources and workload runners rather than replacing the parent CLI lifecycle.
- Preserve current process placement and CLI compatibility; retire the transitional takeover surfaces compatibly.
- Full bridge reconnect and new native launch ownership are not prerequisites; existing attach-only behavior is sufficient.
- Exclusive controlled-context claims additionally require F4 Infrastructure: Settle Storybook story-provider cancellation and reconnect epochs #4437 and F5 Infrastructure: Authorize and settle every controlled Storybook mutation entrance #4443 (both delivered in Desktop driver: typed resources, process lifelines, story lifetimes, exclusive agent ingress, and native qualification runbook #4463; their remaining native evidence is in Infrastructure: Live-qualify the desktop driver and MCP foundation on macOS, Windows, and Win32 #4441). Do not conflate this migration with those guarantees.
- Lease relocation (from F10-M Infrastructure: Implement neutral macOS desktop application ownership and identity recovery #4446, Add neutral macOS application ownership with exact workload identity #4492): Storybook's existing macOS attach-lease/lifecycle code was deliberately not moved. After the contributions land, relocate generic attach-identity duties to
desktop-test/application-ownership(read-onlyinspectApplicationalready exists), keeping Windows/Win32 identity attachment unchanged. - Storybook runner handoff (from F11 Infrastructure: Add scoped runner grants and drain-confirmed desktop controller handoff #4448, delivered generically in Add scoped attach-only runner grants and drain-confirmed desktop handoff #4491): integrate the grant/drain handoff with the Storybook runner (
storybook-desktop/src/testing/{runWdioTests,worker}.ts) once Storybook lifecycle resources aredesktop-testcontributions. MCP and Storybook WDIO runs must not be able to control the same reserved target; a Storybook worker crash drains its session; stale references, cursors and artifact links fail after handoff; credentials do not enter capabilities, generated config, logs or model output. Keep the documented CSF borrowed-session exception unless deliberately migrated. Qualify separately on macOS Fabric, macOS Paper, Windows Fabric and Win32 Paper; hosted skips are not passes. - Retained supervisor-launched application across handoff (from F11 Infrastructure: Add scoped runner grants and drain-confirmed desktop controller handoff #4448): needs an explicit ownership option. Prerequisites are met: Add neutral macOS application ownership with exact workload identity #4492 (macOS; both launch kinds are
uncontained) and feat(desktop-test): qualify Windows application ownership and containment #4494 (Windows; packaged launchesuncontained, REXjob-object; applications recorded as claim resources). Attached or external applications must never be placed in owned termination groups. - Not supported and out of scope: cross-MCP-connection resume and automatic replay.
Dependencies
- Blocked by: none. F1 Infrastructure: Unify desktop driver-service composition and wire durable recovery #4436, F2 Infrastructure: Implement settled desktop lifecycle supervision and fenced ownership records #4442, F3 Infrastructure: Add owned-process lifelines and typed desktop service readiness #4444, F6 Infrastructure: Tighten Storybook manifest provenance and native helper trust handoff #4445 and F7 Infrastructure: Guard neutral desktop package dependency and import boundaries #4438 are merged (Unify desktop driver-service composition and wire durable recovery #4455, Desktop driver: typed resources, process lifelines, story lifetimes, exclusive agent ingress, and native qualification runbook #4463, Tighten Storybook manifest provenance and credential isolation #4490, Enforce application-neutral desktop package boundaries #4454).
- Unblocks: the Storybook facet of F13 Infrastructure: Add the generalized desktop-mcp management facet #4450.
- Coordination: one owner for supervisor and Storybook CLI integration; no parallel wholesale CLI rewrites. This is the last
server.cjsintegration in the sequence F1, F3, F5, F6, F9.
Acceptance
- Generic and Storybook fixtures exercise the same real seam.
- There is one workload and resource owner and one readiness and result presentation.
- No unnecessary second driver is started.
- The fixed Windows Metro-port policy is preserved (8081 for the Windows Debug host).
- Unknown port occupants are never adopted.
- Existing CLI commands remain compatible.
- Storybook runner handoff meets the Scope criteria on each endpoint, separately qualified.
- Generic attach-identity duties are relocated to
desktop-test/application-ownershipwithout changing Windows/Win32 attachment.
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: "Storybook resource contributions" and "MCP/WDIO handoff" in
packages/agentic/desktop-test/references/current-status.md; transitional annotations inpackages/agentic/desktop-test/src/integration.ts. Per-run evidence lives in pull request descriptions and issues; each package'sreferences/current-status.mdkeeps a status overview, stable topic sections, and only the latest result per native endpoint with a link. - Add scoped attach-only runner grants and drain-confirmed desktop handoff #4491 qualified the generic attach-only handoff only (macOS 5/5 and Windows 5/5, zero skips); it did not cover Storybook or retained launches.
- Retired plan:
driver-next.mdat0569e1b86, sections 6 and 8 (F9).
Activity
JasonVMo commentedon Nov 16, 2026
Status update:
Status: Blockedremoved. The blocker, F6 (#4445), landed in #4490, and the generic attach-only handoff landed in #4491; #4445, #4446, #4447 and #4448 are closed. The body now carries the follow-up phases moved here from those issues: relocating Storybook's macOS attach-lease duties, the Storybook runner handoff, and the retained supervisor-launched application option. Storybook's lifecycle takeover is still in place; no acceptance item is ticked.JasonVMo commentedon Nov 17, 2026
Fixed by PR #4510