Merge pull request #53 from Zektopic/bolt/timeout-validation-fast-path-6526799171722381284

⚡ Bolt: Optimize timeout validation with integer fast-path

Author: manupawickramasinghe

.jules/bolt.md

@@ -36,3 +36,7 @@
 ## 2024-05-31 - [Regex Compilation Overhead in Hot-Path]
 **Learning:** Calling `re.fullmatch(pattern, string)` directly inside a high-frequency loop (like `is_reachable` receiving thousands of IP addresses) incurs CPU overhead. Although Python caches compiled regexes internally, the cache lookup and potential cache eviction still consume measurable time compared to using a pre-compiled regex object directly. Benchmarks show a ~40% speedup for the regex matching step when using a pre-compiled regex.
 **Action:** Always pre-compile regular expressions using `re.compile()` at the module or class level when they are used within tight loops or high-concurrency functions, rather than relying on the `re` module's top-level convenience functions.
+
+## 2024-06-05 - [Type-Checking Fast Path for Integers]
+**Learning:** In high-frequency loops, when handling polymorphic inputs that default to primitive types like integers (e.g., `timeout` args), structuring validation to check `type(val) is int` first before falling back to string length checks and `try...except` parsing blocks provides a significant fast-path. Benchmarks showed >50% speedup for parameter validation by bypassing redundant exception handling overhead.
+**Action:** Always structure polymorphic parameter validation to immediately process and return/assign the expected primitive type first, enclosing slower parsing/casting operations in an `else` block.