cooldown

Documentation

Overview

Package cooldown implements per-profile rate limiting for notifications.

Index

• func Check(profile, action string, cooldownSeconds int) bool
• func Record(profile, action string)

Functions

func Check

func Check(profile, action string, cooldownSeconds int) bool

Check returns true if the given profile/action is still within its cooldown window. A missing or unreadable state file is treated as "not on cooldown" (fail-open: if checking fails, notifications are allowed through rather than blocked, so a corrupt state file never silences alerts).

func Record

func Record(profile, action string)

Record writes the current timestamp for the given profile/action. Errors are printed to stderr but never fatal (best-effort).