Files
jhonny-editor/code/docs/recommendations/2026-08-18/13-uxp-heartbeat.md
T
João Henrique b541f502ba feat: initial commit - Jhonny Editor
- Adicionado estrutura completa do projeto
- Configurado MCP server para Premiere Pro
- Adicionado documentação e skills
- Configurado Gitignore para o projeto
2026-09-08 09:59:31 -04:00

25 lines
1.1 KiB
Markdown
Executable File

# Recommendation 13: UXP connection liveness
## Evidence
A TCP/WebSocket connection can remain open while Premiere is modal, suspended, or no
longer processing panel messages. Current state reports connected until socket closure
or a command timeout, delaying diagnosis and tying up pending work.
- [Adobe UXP WebSocket guidance](https://developer.adobe.com/premiere-pro/uxp/resources/recipes/network)
## Proposed improvement
Add protocol-level heartbeat sequence numbers and bounded round-trip measurements.
Classify `connected`, `degraded`, and `stale`; stop admitting new mutations when stale,
but never replay a timed-out mutation after reconnection.
## Acceptance
- Heartbeats are authenticated, size-bounded, and excluded from tool telemetry.
- Miss thresholds tolerate short event-loop stalls without reconnect storms.
- Stale connections reject new work and settle pending requests deterministically.
- Diagnostics distinguish socket liveness from successful Premiere host execution.
Live-host tests must cover modal dialogs, sleep/wake, panel reload, and Premiere exit.