Assistant vocal local ESP32 : étapes 1 à 15, et 15b écrite

État du projet au premier commit :
- firmware ESP32 : micro I2S, lecture anti-gigue, MQTT (état retenu, testament),
  mains libres, domotique de démonstration, chien de garde, présence du serveur ;
- serveur Python : sessions, VAD, faster-whisper, pyannote, identification,
  droits par profil, domotique, mot de réveil, Piper ;
- broker Mosquitto : configuration, comptes et ACL (non activés en développement) ;
- étape 15b écrite, en attente d'essai : agent MQTT pour machines Linux.

Étapes 1 à 15 validées. 203 tests, pyright sans erreur.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

firmware/src/PushButton.h

@@ -0,0 +1,46 @@
+#pragma once
+
+#include <Arduino.h>
+
+/**
+ * @brief Bouton poussoir anti-rebond, câblé entre la broche et GND.
+ *
+ * Le rebond (« bounce ») est l'oscillation mécanique du contact pendant quelques
+ * millisecondes : sans filtrage, un seul appui produirait plusieurs fronts.
+ * La broche utilise le pull-up interne : niveau haut au repos, bas quand on appuie.
+ */
+class PushButton {
+public:
+    /**
+     * @param pin        Broche du bouton.
+     * @param debounceMs Durée de stabilité exigée avant de valider un changement.
+     */
+    PushButton(int pin, uint32_t debounceMs);
+
+    /// Configure la broche en entrée avec pull-up interne.
+    void begin();
+
+    /// À appeler à chaque tour de boucle : met à jour l'état filtré.
+    void update();
+
+    /// true tant que le bouton est maintenu enfoncé.
+    bool isDown() const;
+
+    /// true une seule fois, au front d'appui (consomme l'événement).
+    bool wasPressed();
+
+    /// true une seule fois, au front de relâchement (consomme l'événement).
+    bool wasReleased();
+
+    /// Oublie les événements en attente (un appui mémorisé pendant une session, par exemple).
+    void clearEvents();
+
+private:
+    int _pin;
+    uint32_t _debounceMs;
+    bool _stableState = false;    ///< état filtré : true = enfoncé
+    bool _lastRawState = false;   ///< dernière lecture brute
+    uint32_t _lastChangeMs = 0;   ///< date du dernier changement brut
+    bool _pressedEvent = false;
+    bool _releasedEvent = false;
+};