Skip to main content

Runbooks

Login failures (OTP)​

Check:

  • allowed domains settings,
  • mail provider config,
  • Mailpit/SMTP reachability,
  • rate-limit responses (too_many_requests).

Ticket cannot be closed​

Symptom: closure_summary_required.

Action:

  1. add public closure summary comment,
  2. retry status change to closed.

Board/DevTodo mismatch​

Check:

  • ticket assignee and status,
  • linked dev_tasks rows,
  • outbox events (task.synced) and worker stats.

Upload errors​

Check:

  • MIME type allowed list,
  • file size constraints,
  • aggregate upload limits.