Idempotency contract
Idempotency Contract¶
| Operation | Idempotency Mechanism |
|---|---|
resolve |
Upsert on (mention, entity_type); return existing ID if already resolved |
promote |
Check canonical status before attempting; return existing record if already canonical |
find_synonyms |
Read-only; always idempotent |
merge |
Check merge log before executing; return existing MergeResult if already merged |
on_entity_added |
Implementation responsibility; hook must be idempotent |