elf v1.1.1 Release Notes

Release Date: 2025-12-04 // 6 months ago
  • 🚀 v1.1.1 — Bug Fix Release

    🐛 Bug Fixes

    • 🛠 Fixed an issue where guesses that previously returned a WAIT (throttle) response were incorrectly treated as permanent duplicates after the cooldown TTL expired.
      Now, WAIT responses are ignored during duplicate detection once the throttle window has passed, allowing the guess to be properly evaluated.
      Thanks @tanzimfh for the great catch and contribution!

    • Improved cache semantics so only guesses with real evaluations (TOO_LOW, TOO_HIGH, INCORRECT, CORRECT, COMPLETED) are treated as duplicates.

    Notes

    • No breaking changes.
    • 🚀 This is a pure bug-fix release and is a drop-in upgrade from v1.1.0.
    • ⚡️ If you encountered the “blocked due to repeated guess” issue, updating to v1.1.1 resolves it.

Previous changes from v1.1.0

  • elf v1.1.0

    Small improvements and refinements to make elf more reliable and user friendly during Advent of Code.

    👌 Improvements

    👉 User-Agent Handling (thanks @NotTheEconomist 🎅)

    • Cleaned up the internal User-Agent validation logic.
    • Sanitizes newline and whitespace characters before validation.
    • 👉 Improves warnings and error paths when AOC_USER_AGENT is missing or invalid.
    • Ensures elf always sends a correctly formatted, compliant User-Agent header.

    File Input Helpers

    • 👌 Improved read_input():

    📚 Documentation

    • ⚡️ Updated README to show how to save puzzle inputs to files.
    • 👉 Added a new section describing AOC_USER_AGENT and how to configure it.

    Happy coding, and good luck on this year's puzzles! 🎄