Étape 7 · À tout moment
/pulse:fix
Comprendre et corriger une erreur précise (message, console du navigateur, bouton qui ne marche pas), en cherchant la vraie cause, puis expliquer la correction et comment l'éviter.
Description
Une erreur est une étape normale. Avec cette commande, Pulse commence par comprendre pourquoi elle arrive, avant de toucher au code. Il relie le message au bon fichier, cherche la vraie cause et la dit en une phrase.
Il choisit ensuite la plus petite correction qui règle la cause, sans casser ce qui fonctionne. Puis il le prouve : les contrôles automatiques repassent, et vous refaites vous-même l'action qui échouait.
Pour finir, il vous explique ce qui s'est passé, comment l'éviter, et une notion de programmation liée à l'erreur.
🩺 Correction
Problème : le bouton « Réserver » ne faisait rien
Cause : le code du bouton se lançait avant que le bouton existe dans la page
Correction : le code attend que la page soit prête — src/reservation.js:14
Preuve : ✅ contrôles sans erreur · 🧪 réservation refaite par vous
Pour l'éviter : chercher un élément de la page seulement une fois la page chargée
Le compte rendu de /pulse:fix après une correction.
Pourquoi l'utiliser
- La vraie cause est réglée. Pulse distingue le symptôme de la cause, et cherche si le même oubli se répète ailleurs.
- La correction est prouvée. Vous refaites l'action avec les mêmes données fictives, et vous confirmez que tout fonctionne.
- La sécurité reste intacte. Une « correction » qui ouvrirait l'accès à tous ou désactiverait un contrôle est écartée.
- Vous apprenez à chaque erreur. Le réflexe à retenir et la notion du jour vous sont expliqués.
Quand l'utiliser
- 1 Démarrer
- 2 Décrire
- 3 Préparer
- 4 Construire
- 5 Mettre en ligne
- 6 Être trouvé
- 7 À tout moment
- Vous avez un message d'erreur dans le terminal ou dans la console du navigateur.
- Un bouton ne fait rien, une liste reste vide alors que les données existent.
- Tout marche chez vous, mais pas en ligne.
- Les contrôles automatiques ont échoué après un envoi :
/pulse:statusvous propose alors cette commande.
Comment la lancer
/pulse:fix <message d'erreur ou description du problème> [fichier]
Entre crochets [ ] : facultatif. Entre chevrons < > : à remplacer par votre valeur. La barre | sépare les choix possibles.
- Le message d'erreur ou la description : collez le message tel quel, la ligne rouge de la console, ou décrivez ce qui se passe avec vos mots.
- Le fichier, facultatif : si vous savez où chercher.
- Rien : Pulse pose une seule série de questions. Que faisiez-vous ? Qu'attendiez-vous ? Y a-t-il un message en rouge ?
/pulse:fix "le bouton Réserver ne fait rien"
/pulse:fix "TypeError: Cannot read properties of null" src/reservation.js
Ce qu'elle produit
| Fichier | Ce qui change |
|---|---|
| Les fichiers de code en cause | La plus petite correction possible, dans le style du code existant. |
docs/lexique.md | La notion du jour, si elle est nouvelle pour vous. |
Le plan de la tâche, dans aidd_docs/tasks/ | Une ligne de journal, si la correction touche une tâche d'un plan. |
aidd_docs/memory/technical.md | Un piège qui peut revenir, seulement si vous acceptez la ligne proposée. |
La correction n'est pas encore enregistrée : la prochaine étape est /pulse:review si elle touche une tâche en cours ou plusieurs fichiers, sinon /pulse:commit.
Risques et précautions
- Si la correction change le comportement attendu (une règle du salon, un écran), Pulse vous pose la question avant. C'est une décision, pas une simple correction.
- Deux tentatives au plus. Si l'erreur résiste, Pulse s'arrête, explique où il en est et propose
/pulse:get-help. - Une action manuelle est parfois nécessaire (une variable à saisir chez l'hébergeur, une règle d'accès dans la console de la base) : Pulse vous guide pas à pas.
Problèmes et solutions
Je ne trouve pas de message d'erreur
Dans le navigateur, appuyez sur la touche F12, ouvrez l'onglet « Console » et copiez la ligne rouge. Pour le serveur en local, regardez le terminal où l'appli tourne ; en ligne, les journaux de votre hébergeur.
Ça marche chez moi, mais pas sur le site en ligne
Souvent, une variable n'a pas été saisie chez l'hébergeur, ou un fichier n'a pas été publié. Donnez le symptôme à /pulse:fix : il vérifie ces pistes et vous guide pour saisir la variable.
La liste des rendez-vous reste vide alors qu'il y en a
Une règle d'accès en lecture manque souvent pour cet utilisateur, ou un filtre est faux. Pulse corrige la règle sans l'ouvrir à tout le monde.
Toujours le même problème après la correction
Répondez « Toujours le même problème » : Pulse reprend la recherche avec ce nouvel élément. Après deux essais, il prépare la suite avec /pulse:get-help.
Pulse dit qu'aucun contrôle automatique n'existe
Votre projet n'a pas encore de commande pour repérer les erreurs. Pulse propose d'en ajouter avec /pulse:tech.
Exemples
/pulse:fix "le bouton Réserver ne fait rien"
Une erreur est une étape normale. On va d'abord comprendre pourquoi, avant de toucher au code. Y a-t-il un message en rouge ? Appuyez sur F12, onglet « Console », et copiez la ligne rouge.
Cannot read properties of null (reading 'addEventListener')
pulse-aidd verifier
Cause : le code du bouton se lance avant que le bouton existe dans la page. Je corrige src/reservation.js, ligne 14. Refaites une réservation pour Camille Test, demain à 10 h. Est-ce que ça fonctionne maintenant ?
Oui
🩺 Correction : le code attend maintenant que la page soit prête. 💡 La notion du jour : l'ordre de chargement. Une page se construit de haut en bas ; un code placé trop tôt cherche un bouton qui n'existe pas encore. ➡️ Prochaine étape : /pulse:commit
/pulse:fix
Que faisiez-vous ? → J'ouvrais la liste du jour Qu'attendiez-vous, et que s'est-il passé à la place ? → Les rendez-vous d'aujourd'hui, mais la liste est vide Y a-t-il un message en rouge ? → Non
Cause : la règle d'accès laisse lire les rendez-vous seulement à la personne qui les a pris, pas au salon. Je l'ajuste pour le compte du salon, sans l'ouvrir à tous.
Commandes liées
/pulse:auto-fix: corriger d'un coup les erreurs rouges de tout le projet./pulse:get-help: préparer une demande d'aide quand l'erreur résiste./pulse:review: relire une correction qui touche une tâche en cours./pulse:commit: enregistrer la correction./pulse:annuler: revenir en arrière si une tâche a tout cassé.