Repository navigation
Description
Current status - 2026-11-09
Blocked only by F6 #4445. Already merged: F1 composition (#4455), F7 boundary guards (#4454), and the F2 settled lifecycle and F3 lifelines/readiness (#4463). #4442 and #4444 are closed.
Storybook still replaces the neutral CLI lifecycle through its transitional integration. 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.
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.
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. Do not conflate this migration with those guarantees.
Dependencies
- Blocked by: F2 Infrastructure: Implement settled desktop lifecycle supervision and fenced ownership records #4442, F3 Infrastructure: Add owned-process lifelines and typed desktop service readiness #4444, and F6 Infrastructure: Tighten Storybook manifest provenance and native helper trust handoff #4445. F1 Infrastructure: Unify desktop driver-service composition and wire durable recovery #4436 and F7 Infrastructure: Guard neutral desktop package dependency and import boundaries #4438 implementation is already merged.
- Unblocks: the Storybook phase of F11 Infrastructure: Add scoped runner grants and drain-confirmed desktop controller handoff #4448 and 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.
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 owning
references/current-status.mdrows (done, work in progress, unsupported) 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" in
packages/agentic/desktop-test/references/current-status.md; transitional annotations inpackages/agentic/desktop-test/src/integration.ts. - Retired plan:
driver-next.mdat0569e1b86, sections 6 and 8 (F9).
Activity