FE-1534: Run Storybook against the real optimizer service

[kube]

Important

Dev tooling, nothing user-facing.

Summary

Before this PR, demo website consumes Petrinaut's built dist, so editor changes need a rebuild before they show against the real optimizer. Storybook builds the editor from source with fast refresh but only offered a fake optimizer.

turbo run dev --filter @hashintel/petrinaut -- --with-optimizer-service now runs Petrinaut's Storybook against the real service. Service adapter moves into the shared optimizer client so the website and Storybook use one implementation.

Links

• Ticket FE-1534
• Docs Running the loop locally

Changes

Shared adapter

• Service adapter moves into @local/petrinaut-optimizer-client

  Exported as createServicePetrinautOptimization({ endpoint, fetchImpl }).
  Carries the client construction plus the error-classification fields category, httpStatus and retryAfter that Petrinaut's optimization provider reads for its reconnect logic.
  Its tests move with it.
  Website file shrinks to its dev-proxy endpoint plus a delegation.

Storybook

• Storybook's Vite server proxies /api/petrinaut-opt/*

  Same proxy as the website's, targeting PETRINAUT_OPT_ORIGIN.

• "With real optimizer" story mounts the full editor against the real service

  Supply-chain-profit net inside a PetrinautOptimizationContext backed by the service.
  Requires VITE_PETRINAUT_OPT_PROVIDER=service; otherwise the story renders the launch instructions.

• Story files are exempted from the "no unpublished local packages" lint rule

  Stories are not part of the published build.

• Petrinaut dev task gains --with-optimizer-service

  libs/@hashintel/petrinaut/scripts/dev.sh runs Storybook as before.
  With the flag it starts the optimizer service through the shared shell library first and passes the provider environment.
  Every other argument after -- goes to Storybook.

Test coverage

• service-optimization.test.ts in @local/petrinaut-optimizer-client:

  Adapter's error classification, moved from the website.

How to test

• turbo run dev --filter @hashintel/petrinaut -- --with-optimizer-service
• Petrinaut > With real optimizer
• Simulate mode > create optimization study
• Expect study running on local container
• Edit editor source
• Expect fast refresh
• turbo run dev --filter @hashintel/petrinaut alone
• Expect story renders launch instructions instead

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
hash	Ready	Preview	Sep 3, 2026 4:26pm UTC
petrinaut	Ready	Preview	Sep 3, 2026 4:26pm UTC
petrinaut-docs	Ready	Preview	Sep 3, 2026 4:26pm UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
hashdotdesign-tokens	Ignored	Preview	Sep 3, 2026 4:26pm UTC

[TimDiekmann]

re-approval of pre-rebase