[Copilot]

The code relied heavily on API-level documentation while leaving critical implementation details implicit. This change adds targeted inline context for non-obvious behavior.

• Synchronization and planning

  • Explain snapshot fencing, event coalescing, reconciliation, guarded writes, and reconnect safety.
  • Document mapping, ordering, deduplication, and risk-classification decisions.

• Infrastructure

  • Clarify WAPI process isolation, FIFO command handling, persistence recovery, cache concurrency, and discovery validation.

• Application and native host

  • Describe UI safety-reset and live-confirmation flows.
  • Document native command scheduling, batch validation, and event polling invariants.

Comments focus on intent and correctness constraints without changing runtime behavior.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d175ee4dc0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".