# Mocco events

Besides forwarding Sentry, Vercel and GitHub, Mocco posts its own deploy governance events. They
need no source: add a rule to a channel and they start arriving.

| Event | When | The message shows |
|---|---|---|
| `gate.pending` | A run reached a gate and waits for approval. | Repository, pipeline, short commit, who triggered the run, the gate, and what it needs (for example "2 × deployer"), with a link to the run. |
| `gate.resumed` | Someone with the right role resumed the gate. | The same run details and the roles that resumed it. |
| `gate.rejected` | Someone rejected the gate. | The same run details and the reason given. |
| `run.failed` | A run failed. | The run details, the step that failed and a link to its logs, when known. |
| `run.succeeded` | A run finished successfully. | The run details. |

Every message links back to the run in Mocco.

## The Mocco preset

On a channel's **Rules**, choose the **Mocco** preset and click **Apply**. It adds `gate.pending`,
`gate.resumed`, `gate.rejected` and `run.failed`; the OTA events `ota.promotion.requested`,
`ota.promotion.approved`, `ota.promotion.rejected` and `ota.emergency_launch.spike`; and the
feature-flag events `flags.changeset.requested`, `flags.changeset.applied`,
`flags.changeset.rejected`, `flags.flag.killed` and `flags.stale.digest`; and the messenger events
`messenger.conversation.created` and `messenger.message.received`. It leaves out
`run.succeeded`, which is often noisy, and `messenger.conversation.unassigned` (a new conversation
nobody in the inbox rotation was available for), which repeats a created message; add them by
hand if you want them. You can also use `gate.*` or `run.*` to get a whole family.

Mocco events never come from a source, so a rule limited with **Only from source** never matches
them.

## Filter keys

| Event | Keys |
|---|---|
| `run.*` | `repo` (`acme/web`), `pipeline` (the `pipeline` name in `.mocco.yml`) |
| `gate.*` | `repo`, `pipeline`, `gate` (the gate's name) |

For example, to send only production approvals to `#deploys`, add a rule on `gate.pending` with
the filter `gate=production`.

## In Activity

Mocco events appear in the **Activity** tab with the source **Mocco** when at least one channel got
a message for them. Their details show the delivery to each channel, the same as for events from a
source. See [Troubleshooting](./troubleshooting.md) for what each status means.