Repository navigation
Description
Status: Done
Landed in #4490: strict, versioned v3 generated contracts that reject unknown fields; independent bridge and attachment credentials in owner-private storage (POSIX 0700/0600, Windows protected-DACL), with only bridge data projected into Metro; helper provenance pinned through an independent parent handoff and re-verified by the channel child that actually spawns it; and controlled Metro generation fixtures. Windows Fabric and Win32 Paper native Storybook lanes passed.
Residual macOS Fabric and macOS Paper requalification of these paths (the macOS consumer smokes were Accessibility-blocked for this change) lives in #4441.
Goal
Native helper provenance crosses an editable generated manifest, the macOS attach lease and the runtime bridge reuse the same nonce, and generated schemas are not centralized or versioned. Tighten the trust handoff so tampered artifacts fail before spawn and each secret has one purpose.
Part of #4435 (plan item F6).
Scope
- Owner: Storybook generated configuration.
- Paths (under
packages/agentic/):storybook-desktop/src/driver/driverManifest.ts, nonce and lease handling instorybook-desktop/src/cli/DesktopStorybookCli.ts,storybook-desktop/config/server.cjs,storybook-desktop-runtime/config/metro.cjs, and controlled config fixtures. - Separate runtime bridge and attach-credential secrets.
- Centralize and version generated schemas; reject unknown manifest fields.
- Reverify helper provenance in the process that actually spawns it. A hash stored in the same editable record is not independent trust.
- Exercise Metro generation only in controlled fixtures, because loading its config has write effects.
Dependencies
- Depended on: F2 Infrastructure: Implement settled desktop lifecycle supervision and fenced ownership records #4442 (ownership and publication contract; closed, Desktop driver: typed resources, process lifelines, story lifetimes, exclusive agent ingress, and native qualification runbook #4463).
- Unblocked: F9 Infrastructure: Convert Storybook lifecycle takeover into desktop-test resource contributions #4449.
- Parallel with: F5 Infrastructure: Authorize and settle every controlled Storybook mutation entrance #4443, F10-M Infrastructure: Implement neutral macOS desktop application ownership and identity recovery #4446, F10-W Infrastructure: Implement neutral Windows desktop application ownership and containment #4447, and F11 Infrastructure: Add scoped runner grants and drain-confirmed desktop controller handoff #4448.
- Coordination: merge after F3 Infrastructure: Add owned-process lifelines and typed desktop service readiness #4444's
server.cjsedits and sequence with F5's. F6 and F9 each own their phase ofDesktopStorybookCli.ts.
Acceptance
- Tampered or mismatched artifacts fail before spawn. (#4490)
- Unknown manifest fields fail. (#4490)
- Bridge and attach nonces are independent. (#4490)
- Secrets use owner-private POSIX modes and the appropriate Windows ACL or private-storage boundary. (#4490)
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 (#4490); 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 (F6).
Activity
JasonVMo commentedon Nov 16, 2026
Closing as completed by #4490.
Acceptance:
0700/0600with permissive-mode refusal; Windows protected-DACL storage, with the NTFS private-storage contract passing in CI.Native evidence: Windows Fabric and Win32 Paper (accessible and physical) native Storybook lanes passed in CI. The macOS Fabric and Paper consumer smokes for this change were blocked on Accessibility and executed no tests, so macOS is not claimed. The PowerShell parser check was not run.
Residual moved: macOS Fabric and macOS Paper requalification of the v3 manifest/credential handoff, channel-child helper re-verification and live authenticated bridge now lives in #4441 (macOS requalification item).