Clarify revoke flow and simplify revoke handling internals.

Restructure revoke logic for readability with plain-language scope comments, inline flow-oriented rule rewriting, and reduced helper complexity while keeping documented revoke behavior and test coverage aligned.

Made-with: Cursor

Author: anniegracehu