docs(idempotency): describe dedup as bounded by the claim lease and result TTL

Author: waleedlatif1

apps/sim/lib/core/idempotency/service.ts

@@ -572,8 +572,9 @@ export class IdempotencyService {
   }
 
   /**
-   * Runs `operation` at most once per key. A caller that finds another holder's live claim
-   * polls until that holder finishes and returns (or rethrows) its outcome, so use this when
+   * Runs `operation` once per key while its claim lease and stored result last. A caller that
+   * finds another holder's live claim polls until that holder finishes and returns (or rethrows)
+   * its outcome, so use this when
    * the caller's own response depends on the result (e.g. Stripe must not get a 2xx before
    * the first attempt settles).
    */