{"rule_id":"AB-154","category":"retry_semantics","icon":"🔁","title":"Retry semantics declared","short_description":"Idempotency-Key or Retry-After headers are documented.","user_value":"Agents need to know which requests are safe to retry and how long to wait.","wrong_example":"// no mention of idempotency or retry","right_example":"headers: { 'Idempotency-Key': { description: 'Prevents duplicate charges' } }","effort_hint":"moderate","estimated_cost":"$0","severity":"medium","pillar":"executability","version":"1.0.0","counted_in_score":true,"check":{"type":"semantic_validation","sources":["openapi","guide"]},"fix":{"eligible":false,"type":"assisted","note":"Declare Idempotency-Key support and Retry-After headers for 429/5xx responses"},"checklist_anchor":"#AB-154","checklist_url":"/agent-readiness-checklist#AB-154","html_url":"/rules/AB-154","json_url":"/rules/AB-154.json","related_rules":[]}