FE-1653: Ground every Brunch conversation in the current Petrinaut net

[kostandinang]

🌟 What is the purpose of this PR?

Brunch can currently ask users to attach or describe a Petri net that is already open in Petrinaut. This change grounds ordinary Brunch conversations in a fresh browser snapshot before answering requests to explain, review, or interview about the current net.

It consolidates the intended behavior from two retired workstreams into the mounted Flue path without exposing mutation tools, adding a parallel Voice context route, or caching canvas state.

🔗 Related links

• FE-1653: Ground every Brunch conversation in the current Petrinaut net (internal)
• Stack parent: #9619
• Retired behavior reference: #9523
• Retired portable implementation reference: #9538

🚫 Blocked by

• #9619

🔍 What does this change?

• Mounts getLatestNetDefinition for every SDCPN Brunch conversation while keeping all mutation tools mode-gated.
• Requires one fresh current-net read per net-referential user turn and rejects duplicate reads in the same continuation.
• Uses one browser client-tool catalog for live panel transport and hydrated history.
• Preserves current-net snapshots as correlated client-tool-result machine evidence.
• Adds deterministic two-turn coverage proving changed snapshots, preserved call IDs, no duplicate user turns, and no provider-executed browser tools.
• Documents on-demand grounding for typed and completed Voice input.

Pre-Merge Checklist 🚀

🚢 Has this modified a publishable library?

This PR:

• modifies an npm-publishable library and I have added a changeset file

📜 Does this require a change to the docs?

The changes in this PR:

• require changes to docs which are made as part of this PR

🕸️ Does this require a change to the Turbo Graph?

The changes in this PR:

• do not affect the execution graph

⚠️ Known issues

• The paid-provider browser and audible Voice witness was not run because this checkout only has the repository dummy provider key. Deterministic integration tests cover the shared submission and grounding path.

🐾 Next steps

• None required for this read-only grounding change. Automatic construction and answer provenance remain separate workstreams.

🛡 What tests cover this?

• Brunch agent unit and production-path deterministic integration tests.
• Petrinaut website transport and hydrated-history tests.
• SDCPN plugin tool-gating and public-entrypoint tests.
• Petrinaut documentation tests.

❓ How to test this?

1. Checkout this branch above PR FE-1604: Allow Voice interruption by speaking #9619.
2. Open an ordinary non-empty SIR net in Petrinaut with Brunch configured.
3. Click Explain this model and confirm the answer names visible SIR elements instead of requesting an attachment.
4. Change a visible net fact, ask again, and confirm the next answer reflects the changed state.
5. Confirm ordinary conversations cannot call any Petrinaut mutation tool.

📹 Demo

pr-9637-current-net-demo.mp4

This 10.8-second deterministic local browser witness uses no provider credentials. It shows the SIR model grounded, a visible title change, and a second fresh-net read producing the updated answer. It is not evidence of paid-provider output.

[vercel]

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

4 Skipped Deployments

Project	Deployment	Actions	Updated
hash	Ignored	Preview	Sep 10, 2026 3:44pm UTC
hashdotdesign-tokens	Ignored	Preview	Sep 10, 2026 3:44pm UTC
petrinaut	Skipped		Sep 10, 2026 3:44pm UTC
petrinaut-docs	Skipped		Sep 10, 2026 3:44pm UTC

[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 d1b31a9. Configure here.}