FE-1659: Give local Petrinaut documents UUID URLs and copy examples by kube · Pull Request #9661 · hashintel/hash

kube · 2026-09-11T02:40:55Z

Summary

Local demo documents open at /local/<UUID>, so bookmarks, reloads, and browser history reopen the selected file. Documents stay in the browser's local storage.

Published examples offer Make a local copy in the top bar. The copy opens at its own local URL with editing enabled.

Links

Website preview
Ticket FE-1659 (internal)
Docs Drawing a net

Changes

Assign persistent UUIDs to saved documents while preserving legacy storage keys and attached conversations
Give new, imported, and copied documents distinct UUIDs
Redirect / to the most recently edited document and /new to a new document
Keep empty documents when switching files so their URLs remain usable
Explain missing local documents and provide a link back to Petrinaut
Handle failed example-copy writes with an inline error
Update the user guide and website README, with a patch changeset for the guide bundled in @hashintel/petrinaut

Test coverage

Website suite: 463 tests passed, including UUID migration, duplicate repair, independent copies, direct routes, missing files, and Back/Forward navigation
Website build, type check, lint, repository formatting, and architecture check passed
Browser verification: copied a published example, edited its local copy, and reloaded the UUID URL
The Turbo execution graph is unchanged

How to test

Open /examples/sir-epidemic-model on the website preview
Choose Make a local copy and confirm the URL is /local/<UUID>
Rename the copy, move a place, and reload
Create another document from Menu > New, then use Back and Forward
Open /local/550e8400-e29b-41d4-a716-446655440000 in a browser without that file and confirm the recovery message

vercel · 2026-09-11T02:41:03Z

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

Project	Deployment	Actions	Updated
hash	Ready	Preview	Sep 11, 2026 2:51am UTC
petrinaut	Ready	Preview	Sep 11, 2026 2:51am UTC
petrinaut-docs	Ready	Preview	Sep 11, 2026 2:51am UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
hashdotdesign-tokens	Ignored		Sep 11, 2026 2:51am UTC

cursor · 2026-09-11T03:04:52Z

PR Summary

Medium Risk
Routing and localStorage migration affect how every visitor opens and switches documents; behavior changes (no empty-net pruning, new / redirect) could surprise existing users but is covered by tests.

Overview
Local demo documents now open at stable /local/<UUID> URLs so bookmarks, reloads, and browser history target a specific file. / redirects to the most recently edited document (or creates one), and /new always creates a new empty document at its own URL. Switching nets no longer deletes untouched empty documents, so those links keep working.

Storage identity adds a persistent uuid on each saved net (new records use UUID as id), with readLocalStorageNets migrating legacy entries in place—repairing bad or duplicate UUIDs while keeping existing storage keys and AI conversation keys.

Published examples gain a top-bar Make a local copy action that saves a fork to localStorage and navigates to the new local URL; failed writes show an inline alert. Unknown UUIDs show a tailored not-found recovery page.

Docs (website README and drawing-a-net.md) and a patch changeset document the new URL and copy flows.

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

Copilot

🟡 Changes recommended

The central editor-to-UUID navigation workflow lacks integration coverage.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Adds persistent UUID routes for browser-local Petrinaut documents and enables editable copies of published examples.

Changes:

Adds UUID migration, creation, routing, and navigation.
Adds example copying and missing-document recovery.
Updates tests, documentation, and release metadata.

File summaries

File	Description
`.changeset/local-document-urls.md`	Adds the Petrinaut patch changeset.
`apps/petrinaut-website/README.md`	Documents local UUID routes and copies.
`apps/petrinaut-website/src/examples/full-example-page.tsx`	Adds the copy action and error alert.
`apps/petrinaut-website/src/main/app/local-storage-demo/local-storage-demo-app.tsx`	Connects document selection to routing.
`apps/petrinaut-website/src/main/app/local-storage-demo/resolve-crew-reservation-bundle.test.ts`	Adds UUID data to the fixture.
`apps/petrinaut-website/src/main/app/local-storage-demo/use-local-storage-sdcpns.test.ts`	Tests UUID migration and copies.
`apps/petrinaut-website/src/main/app/local-storage-demo/use-local-storage-sdcpns.ts`	Implements UUID persistence and migration.
`apps/petrinaut-website/src/routes/-local.test.tsx`	Tests local routes and history.
`apps/petrinaut-website/src/routes/-new.test.ts`	Tests distinct `/new` documents.
`apps/petrinaut-website/src/routes/-not-found-page.tsx`	Supports customized recovery messages.
`apps/petrinaut-website/src/routes/__root.tsx`	Adapts root not-found rendering.
`apps/petrinaut-website/src/routes/examples.$slug.tsx`	Saves and opens example copies.
`apps/petrinaut-website/src/routes/index.tsx`	Redirects home to the latest document.
`apps/petrinaut-website/src/routes/local.$uuid.tsx`	Adds the local-document route.
`apps/petrinaut-website/src/routes/new.tsx`	Redirects new documents to UUID URLs.
`libs/@hashintel/petrinaut/docs/drawing-a-net.md`	Documents local URLs and example copies.

Review details

Files reviewed: 16/16 changed files
Comments generated: 1
Review effort level: Balanced

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

+    if (onNetChange) onNetChange(newNet);
+    else clearSharedLocation();


cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 1014585. Configure here.}

cursor · 2026-09-11T03:14:14Z

    setCurrentNetId(newNet.id);
-    clearSharedLocation();
+    if (onNetChange) onNetChange(newNet);
+    else clearSharedLocation();


New documents can 404 on navigate

Medium Severity

createNewNet adds the document through setStoredSDCPNs and then calls onNetChange, which navigates to /local/$uuid. That route's loader reads localStorage via readLocalStorageNets, not the hook. Mantine swallows setItem failures, so a quota or blocked-storage write still navigates and the loader throws not-found. /new and Make a local copy persist with saveLocalStorageNet before navigating, so those flows surface a save error instead of a missing-document page.

Additional Locations (1)

apps/petrinaut-website/src/routes/local.$uuid.tsx#L23-L43

^{Reviewed by Cursor Bugbot for commit 1014585. Configure here.}

kube · 2026-09-11T10:09:24Z

 export const Route = createFileRoute("/")({
+  beforeLoad: ({ search }) => {
+    readLocalStorageNets(window.localStorage);
+    if (isCrewReservationFixtureSelected(search)) return;


This is specific to Brunch fixture and should be flagged as something to remove soon.

We should not have (too much) spaghetti in the app.

kube added 2 commits September 11, 2026 04:27

Give local Petrinaut documents persistent URLs and fork examples

19d4167

Include the local document guide in the next Petrinaut release

1014585

kube self-assigned this Sep 11, 2026

github-actions Bot added area/infra Relates to version control, CI, CD or IaC (area) area/libs Relates to first-party libraries/crates/packages (area) type/eng > frontend Owned by the @frontend team area/apps labels Sep 11, 2026

kube mentioned this pull request Sep 11, 2026

FE-1660: Explain blocked edits in read-only Petrinaut documents #9662

Open

kube added this pull request to stack #9663 September 11, 2026 02:41

vercel Bot deployed to Preview – petrinaut September 11, 2026 02:43 View deployment

vercel Bot deployed to Preview – petrinaut-docs September 11, 2026 02:44 View deployment

vercel Bot deployed to Preview – hash September 11, 2026 02:51 View deployment

kube marked this pull request as ready for review September 11, 2026 03:04

Copilot AI balanced review requested due to automatic review settings September 11, 2026 03:04

Copilot started reviewing on behalf of kube September 11, 2026 03:05 View session

Copilot AI reviewed Sep 11, 2026

View reviewed changes

Comment thread apps/petrinaut-website/src/main/app/local-storage-demo/local-storage-demo-app.tsx

Comment on lines +479 to +480

if (onNetChange) onNetChange(newNet);

else clearSharedLocation();

cursor Bot reviewed Sep 11, 2026

View reviewed changes

kube commented Sep 11, 2026

View reviewed changes

Navigation Menu

Uh oh!

FE-1659: Give local Petrinaut documents UUID URLs and copy examples - #9661

FE-1659: Give local Petrinaut documents UUID URLs and copy examples#9661
kube wants to merge 2 commits into
mainfrom
codex/fe-1659-local-document-urls

kube commented Sep 11, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Sep 11, 2026 •

edited

Loading

Uh oh!

cursor Bot commented Sep 11, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

cursor Bot left a comment

Uh oh!

cursor Bot Sep 11, 2026

Uh oh!

kube Sep 11, 2026

Uh oh!

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

2 participants

		if (onNetChange) onNetChange(newNet);
		else clearSharedLocation();

Uh oh!

Conversation

kube commented Sep 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Links

Changes

Test coverage

How to test

Uh oh!

vercel Bot commented Sep 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cursor Bot commented Sep 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Summary

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor Bot Sep 11, 2026

Choose a reason for hiding this comment

New documents can 404 on navigate

Uh oh!

kube Sep 11, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

2 participants

kube commented Sep 11, 2026 •

edited

Loading

vercel Bot commented Sep 11, 2026 •

edited

Loading

cursor Bot commented Sep 11, 2026 •

edited

Loading