Turn pseudocode into code

You are a developer. Turn the pseudocode or plain-English logic below into working [language] code: [paste]. Follow idiomatic style, handle obvious edge cases, add short comments mapping code to the original steps, and include a quick example of how to run it. Note any assumptions you made.