FE-1833: Speak progress while Brunch works

[kostandinang]

🌟 What is the purpose of this PR?

Let Brunch say a short progress line during long Live voice turns, while staying silent through quick answers and fast tool bursts.

🔗 Related links

• FE-1833
• Stacked on FE-1793: Brunch assistant follow-ups and improvements #9886.

🚫 Blocked by

• Merge FE-1793: Brunch assistant follow-ups and improvements #9886 and retarget to main.
• Verify spoken progress in a real Live session. Both lines were audible, and the later summary was accepted under the original delegation.

🔍 What does this change?

• Code chooses up to two fixed progress lines per turn and instructs Live to read them verbatim.
• Stay quiet during speech and approval waits, with timing limits to avoid chatter.
• Send Live quiet context about the current work, keep progress out of written history, and hold the final summary while progress audio is active.

Pre-Merge Checklist 🚀

🚢 Has this modified a publishable library?

• No publishable library changes.

📜 Does this require a change to the docs?

• Yes; voice documentation is still pending.

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

• No execution graph changes.

⚠️ Known issues

The recording exposed a final-caption mismatch: part of the acknowledgement appears in the written summary but not its audio. Live also added “I'm” to the second progress line. The model build was blocked by browser-tool lease failures.

🐾 Next steps

Fix the caption mismatch, verify a successful model-building turn, and finish the voice docs before marking ready.

🛡 What tests cover this?

• Scripted turns, timing boundaries, approval waits, interruptions, summary ordering, and written history.
• Passed: 1,038 unit tests, 5 integration tests, type checking, lint, formatting, and build.

❓ How to test this?

1. With working voice credentials, run PETRINAUT_OPENAI_VOICE_ENABLED=true PETRINAUT_VOICE_PROVIDER=live yarn dev:brunch. Open /new on port 4915.
2. Try quick answers, long model-building and experiment turns, interruptions, and approval waits.
3. Check verbose [Petrinaut Live trace] logs. Progress should be audible only on long turns, leave the request open, and neither overlap the summary nor appear in written history.

📹 Demo

progress-demo.mp4

Click to play with sound. Real Live session, 70 seconds with long pauses trimmed: first progress at 0:28, second at 0:39, final response at 0:48. The final response reports the failed model build; this is not a successful-build demo.

[vercel]

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

Project	Deployment	Actions	Updated
hash	Ready	Preview	Oct 2, 2026 10:01pm UTC
petrinaut	Ready	Preview	Oct 2, 2026 10:01pm UTC
petrinaut-docs	Ready	Preview	Oct 2, 2026 10:01pm UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
hashdotdesign-tokens	Ignored	Preview	Oct 2, 2026 10:01pm UTC

[cursor]

PR Summary

Medium Risk
Changes Live turn timing, delegation commentary, and settlement ordering in the voice bridge; mistakes could overlap progress with summaries or speak during approval waits.

Overview
Adds spoken progress for long Brunch Live voice turns: a new ProgressPolicy watches assistant tool UI state (plus host mutation approval via isToolAwaitingApproval) and may send up to two fixed commentary lines through Live, with timing gates so quick answers and fast tool bursts stay silent.

LiveBrunchBridge polls progress on a timer, publishes quiet JSON progress via appendThinking, sends null-delegation commentary, and holds the final summarized answer until Live output is quiet (with bounded fallbacks). Captions treat progress as spoken-only so it does not land in written voice history or steal wrap-up captions; Live session instructions now tell the model to read supplied progress verbatim.

The demo wires approval pending state from mutationApproval.coordinator into voice mode; controls forward output activity into liveSpeaking and attribute late append acceptances to the correct turn.

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

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

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

[cursor]

Progress send failures warn as answers

Medium Severity

Progress lines are sent as commentary with a null delegation, but append failures still use the existing commentary warning that calls the payload an answer. A refused progress send can surface that warning while Brunch is still working and the wrap-up has not been attempted.

Additional Locations (1)

• apps/petrinaut-website/src/main/app/voice-interview/live-brunch-bridge.ts#L537-L546

 

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