WARN precatch precatch mapping absent|unmapped_channel_fallback

Salon precatch sans mapping `[[precatcher.mappings]]`

Résumé

Un salon IRC voit passer une annonce precatch sans entrée [[precatcher.mappings]] : le bot utilise src_site=default et alerte le hub une fois par session.

Quand ça apparaît

• Hub LOG_ERROR (#ZarFTP ou satellite) : precatch mapping absent — NET#CHAN → src_site=default …
• Log : event=unmapped_channel_fallback (rate-limit : une alerte IRC par NET#CHAN / session)
• Désactivable : [precatcher].unmapped_mapping_notify_hub = false

Ce que ça signifie

Le precatcher résout le site FTP source via [[precatcher.mappings]]. Sans mapping, repli default — pas un site FTP réel. Distinction :

Impact si ignoré

• Stats site_race : default est exclu (!sitestop, !raceline incomplets)
• Origine STATS / TopClient peut dégénérer si le salon devrait mapper un vrai site

À faire

1. !precatch-mapping-gap NET#CHAN — détail + bloc TOML à coller
2. Ajouter dans precatcher_mappings_added.toml :

[[precatcher.mappings]]
net = "EPX"
chan = "#OPERS"
src_site = "NOM_SITE"

1. !reload puis revérifier !precatch-mapping-gap
2. Optionnel : bash scripts/pre/audit-precatch-mapping-gap.sh (dist)

À ne pas faire

• Mapper un salon ops/logs sans precatch réel « pour faire taire » l’alerte
• Confondre avec listen gap (!precatch-listen-gap)
• Attendre une alerte répétée : le rate-limit n’envoie qu’une fois par salon / session

Validation

• !precatch-mapping-gap : salon absent de la liste
• !configcheck : segment mapping gap vide ou OK pour ce salon
• bash scripts/pre/audit-precatch-mapping-gap.sh exit 0 (si dist configuré)

Références code

• zartek-fxp/src/precatcher/mapping_gap/notify.rs (L58–69)
• zartek-fxp/src/pre/prenet_admin/precatch_mapping_gap.rs
• docs/CONFIG.md § mapping precatch

Voir aussi

• SITE_RACE_STATS.md — exclusion default
• !help precatch-mapping-gap · !help alert precatch-mapping-absent