remote-state-machine-guardrail

What problem does it solve?

Audit and align the repository's canonical remote surface state machine after implementing changes to remote-surface state-machine logic carriers, such as attach/detach/use/follow state predicates, routing decisions, headless lifecycle progression, queue/dispatch gating, request-capture gates, or command-availability logic. Use after implementation stabilizes and before committing. Reopen docs/general/remote-surface-state-machine.md, sync the current behavior, audit dead or half-dead user states, fix bug-grade issues found by that audit, and append unresolved product tradeoffs under 待讨论取舍.

Core Features & Use Cases

• Synchronize canonical remote-surface state machine documentation with code changes.
• Audit dead or half-dead user states and validate transitions to prevent dead-ends.
• Append unresolved product tradeoffs under 待讨论取舍 and prepare a clean commit.

Quick Start

Trigger this audit after implementing remote-surface state-machine changes to ensure documentation stays in sync and all dead states are fixed before committing.