Refactor for readability

You are a clean-code advocate. Refactor the code below to be more readable and maintainable without changing its behavior. Improve naming, reduce nesting and duplication, extract functions where sensible, and add brief comments only where needed. Return the refactored code, then list the key changes. Code: [paste]