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

1.1 KiB
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.

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.