用途：mergify events 以时间线形式列出仓库的 Mergify 活动日志，涵盖引擎记录的约 45 种事件类型，包括 action.queue.* 生命周期、工作流动作（action.merge、action.rebase、action.label 等）、用户命令（command.queue、command.dequeue）、ci_insights.*、队列暂停和定时冻结。一个命令配合过滤器使用，不按事件类型分设子命令。
主要能力与用法： mergify events 查看整个仓库最近 24 小时； mergify events --pr 1740 查看单个 PR 最近 24 小时； mergify events --pr 1740 --since 7d 扩大时间窗口（支持 s/m/h/d/w，最大 90d）； mergify events --type action.queue.leave --type command.queue 按类型过滤，可重复； mergify events --pr 1740 --json 输出原始事件，最新在前； mergify events --limit 20 仅显示最新 20 条。
时间窗口规则：每次结果都覆盖明确的时间窗口，并在头部和空结果提示中说明。默认窗口为最近 24 小时；保留期为 90 天，--since 90d 是最宽的有效窗口，更宽会被直接拒绝并给出修正提示。空结果会标明窗口，若尚未搜索完整保留期，应先用 --since 90d 再下结论。
时间线阅读：按从旧到新排列，元数据带有摘要时逐条显示。注意 action.queue.checks_end 上的中止代码（如 PR_AHEAD_DEQUEUED、MERGE_QUEUE_RESET、CHECKS_RETRIED）表示检查被中断但 PR 仍在队列中；只有 action.queue.leave 才表示 PR 离开队列，其 merged: true 变体表示因合并而离开。不要因 checks_end 事件重新入队。
JSON 契约：--json 输出单个文档，events 为 API 原始对象（未知字段保留），最新在前，并回显时间窗口，便于用 jq 按 .events[].type 和 .events[].metadata 过滤。
适用场景与限制：适合查看完整事件轨迹或非队列事件；若问“PR 为何被移出队列”，应使用 mergify queue show <PR>。未安装 CLI 或令牌拒绝日志时，可调用 GET /v1/repos/{owner}/{repo}/logs，需始终传入 received_from（API 默认仅 1 天），跨度不超过 93 天。