Events
This page is generated from docs/plugins/en/EVENTS.md · Edit this page on GitLab
Generated from
sdk/contract.js(API 1) bysdk/scripts/generer-docs-events.js— do not edit by hand.
An event is a name (domain.action) and a serialisable payload that always carries version. Handlers run one after the other, each under try/catch and a timeout (30 s): a failing subscriber is logged, never propagated. A plugin subscribes with ctx.events.on(name, handler) and emits its own (declared in plugin.json → events.emits) with ctx.events.emit(name, payload).
| Event | Version | Source | When |
|---|---|---|---|
app.ready | 1 | cœur | le serveur écoute et les plugins sont activés |
app.shutdown | 1 | cœur | le serveur s’arrête (avant la désactivation des plugins) |
repo.deleted | 1 | cœur | un dépôt suivi est retiré de Réglages → Dépôts |
session.started | 1 | cœur | une session (codage, exploration, hors dépôt, question) commence à tourner |
session.finished | 1 | cœur | une session a fini de tourner (succès, erreur, arrêt, question posée) |
mr.created | 1 | cœur | une merge request devient connue de Mergerie (découverte sur la forge) |
review.completed | 1 | cœur | un rapport de review est enregistré |
converge.finished | 1 | cœur | une boucle de convergence s’arrête |
verify.finished | 1 | cœur | une vérification objective a rendu son verdict (ou échoué) |
jenkins.job.started | 1 | plugin jenkins | un build démarre : lancé depuis Mergerie, ou — si « Annoncer tous les jobs » est coché dans le plugin — lancé par n’importe qui |
jenkins.job.finished | 1 | plugin jenkins | un build s’est terminé : lancé depuis Mergerie, ou — si « Annoncer tous les jobs » est coché dans le plugin — lancé par n’importe qui |
app.ready
When : le serveur écoute et les plugins sont activés. Source : cœur. Version : 1.
| Champ | Type |
|---|---|
port | number |
host | string |
demo | boolean |
{
"version": 1,
"port": 42,
"host": "host-example",
"demo": true
}
app.shutdown
When : le serveur s’arrête (avant la désactivation des plugins). Source : cœur. Version : 1.
(aucun champ en dehors de version)
{
"version": 1
}
repo.deleted
When : un dépôt suivi est retiré de Réglages → Dépôts. Source : cœur. Version : 1.
| Champ | Type |
|---|---|
id | number |
project | string |
{
"version": 1,
"id": 42,
"project": "project-example"
}
session.started
When : une session (codage, exploration, hors dépôt, question) commence à tourner. Source : cœur. Version : 1.
| Champ | Type |
|---|---|
kind | `"task" |
id | number |
action | string |
{
"version": 1,
"kind": "task",
"id": 42,
"action": "action-example"
}
session.finished
When : une session a fini de tourner (succès, erreur, arrêt, question posée). Source : cœur. Version : 1.
| Champ | Type |
|---|---|
kind | `"task" |
id | number |
action | string |
status | `"done" |
{
"version": 1,
"kind": "task",
"id": 42,
"action": "action-example",
"status": "done"
}
mr.created
When : une merge request devient connue de Mergerie (découverte sur la forge). Source : cœur. Version : 1.
| Champ | Type |
|---|---|
mr_id | number |
iid | number |
project | string |
title | string |
{
"version": 1,
"mr_id": 42,
"iid": 42,
"project": "project-example",
"title": "title-example"
}
review.completed
When : un rapport de review est enregistré. Source : cœur. Version : 1.
| Champ | Type |
|---|---|
mr_id | number |
iid | number |
note10 | `number |
{
"version": 1,
"mr_id": 42,
"iid": 42,
"note10": 42
}
converge.finished
When : une boucle de convergence s’arrête. Source : cœur. Version : 1.
| Champ | Type |
|---|---|
mr_id | number |
iid | number |
status | string |
note10 | `number |
passes | number |
{
"version": 1,
"mr_id": 42,
"iid": 42,
"status": "status-example",
"note10": 42,
"passes": 42
}
verify.finished
When : une vérification objective a rendu son verdict (ou échoué). Source : cœur. Version : 1.
| Champ | Type |
|---|---|
verification_id | number |
verdict | string |
{
"version": 1,
"verification_id": 42,
"verdict": "verdict-example"
}
jenkins.job.started
When : un build démarre : lancé depuis Mergerie, ou — si « Annoncer tous les jobs » est coché dans le plugin — lancé par n’importe qui. Source : plugin jenkins. Version : 1.
| Champ | Type |
|---|---|
source | `"mergerie" |
path | string |
since | number |
parameters | Record<string, string> |
url | string |
startedBy | string |
{
"version": 1,
"source": "mergerie",
"path": "path-example",
"since": 42,
"parameters": {
"BRANCH": "main"
},
"url": "url-example",
"startedBy": "startedBy-example"
}
jenkins.job.finished
When : un build s’est terminé : lancé depuis Mergerie, ou — si « Annoncer tous les jobs » est coché dans le plugin — lancé par n’importe qui. Source : plugin jenkins. Version : 1.
| Champ | Type |
|---|---|
source | `"mergerie" |
path | string |
number | number |
result | string |
ok | boolean |
url | string |
duration | number |
startedBy | string |
parameters | Record<string, string> |
{
"version": 1,
"source": "mergerie",
"path": "path-example",
"number": 42,
"result": "result-example",
"ok": true,
"url": "url-example",
"duration": 42,
"startedBy": "startedBy-example",
"parameters": {
"BRANCH": "main"
}
}
Compatibility
A field added to a payload does not change the version. A field removed or renamed, or a meaning that changes, increments version: the plugin reads payload.version and knows what to expect. See MIGRATION.md.