FE-1883: Resolve legacy entity IDs and display names

[kube]

Summary

Before this PR, a link that named an item or scenario by an id from before UUID conversion opened the default view: the editor dropped the selection and the Simulate drawer, and the scenario fell back to the first one. Actual mode events, Brunch removal approvals and Brunch draft experiments showed raw ids, which are now UUIDs.

This PR resolves older ids in a location to their converted ids and replaces the location once, so old links and published embeds open the same item. Events, approvals and draft experiments show names. Router integration and oEmbed docs describe how older ids resolve.

Links

• Ticket FE-1883
• Docs Router integration
• Docs oEmbed and iframe embedding
• Docs Actual mode

Changes

Petrinaut

• Selection and Simulate resources in a location resolve by id as written, then by converted id

  Ids as written win, since a custom handle may keep ids it never converted.
  Arc ids convert with canonicalizeArcId.
  Items the net lacks in either form are dropped.

• Editor writes the resolved location back once

  Navigation carries cause normalization.
  Items found as written keep their identity, so an unchanged location causes no navigation.

• Requested scenario resolves the same way

  An older ?scenario= link opens that scenario instead of the first one.

• Actual mode events show transition and place names

  An unnamed transition or place shows its id.

Website

• Brunch removal approvals name the items they remove

  The card reads names from the editor instance through usePetrinautInstance, subnets included.
  An unnamed or missing item shows its id.

• Arc rows name both ends

  Place and component port ends parse from the arc endpoint key. Transition ends show the transition's name.

• Brunch draft experiments name the metric that reports an unsupported condition

Review fixes

• Arc ids in links always convert

  The editor reads every generated arc id as an arc, so arcs skip the as-written check.

• Older link ids resolve during render

  The editor view's selection cleanup runs before the provider's effect and dropped them.

Test coverage

• resolve-navigated-ids.test.ts:

  Ids resolve as written or converted, arcs included. Items found as written keep identity, missing ones drop, and experiments pass through.

• editor-provider.test.tsx:

  An older link's scenario and place reopen with one replace navigation, with selection cleanup mounted.

• provider.test.ts:

  An older scenario id resolves to its converted id.

• actual-events.test.tsx:

  Events show names, and an unnamed place shows its id.

• brunch-mutation-approval.test.tsx:

  Rows name a place and both arc ends, and a missing item shows its id.

• brunch-draft-experiment-interactive-tool.test.tsx:

  Reporting metric shows its name.

• Existing Petrinaut and website unit and integration suites

How to test

• Open Petrinaut preview on Vercel
• Menu > Load example > SIR Epidemic Model
• Select Infected place
• Copy URL
• Set itemId to older id place__infected
• Open edited URL

  Expect Infected selected and URL showing its UUID

[vercel]

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

Project	Deployment	Actions	Updated
hash	Ready	Preview	Oct 8, 2026 6:46pm UTC
petrinaut	Ready	Preview	Oct 8, 2026 6:46pm UTC
petrinaut-docs	Ready	Preview	Oct 8, 2026 6:46pm UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
hashdotdesign-tokens	Ignored	Preview	Oct 8, 2026 6:46pm UTC

[cursor]

PR Summary

Medium Risk
Navigation normalization touches deep-linking, selection, and simulate routing across the editor; behavior is well-tested but incorrect resolution could mis-open scenarios or selections.

Overview
Legacy deep links and embeds now map pre-UUID ids to the document’s converted ids instead of dropping selection or defaulting simulate state. New resolveNavigatedId / resolveNavigatedItems try ids as written first, then toPetrinautId (arcs via canonicalizeArcId), and drop items that still don’t exist. The editor resolves during render and replaces the URL once (normalization); simulation scenario selection uses the same resolution so older ?scenario= links open the intended scenario.

Human-readable labels replace raw UUIDs in several UIs: Actual mode Events shows transition and place names (id when unnamed); Brunch destructive-edit approval lists removals by document names, including arc endpoints as A → B; draft experiment cards show the reporting metric’s name via exported nameOfMetric.

Docs for Actual mode, router integration, and oEmbed note legacy id resolution.

^{Reviewed by Cursor Bugbot for commit 3d71466. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Stale Bugbot comment from a previous run.