Partir de l’état observable
Confirmez racine et fichiers avant toute modification : pwd, ls -la et cat package.json réduisent les erreurs de dossier. Voyez les scripts avec npm run, paquets de premier niveau avec npm ls et commandes disponibles avec help ou which.
Si un processus est actif, jobs donne son identifiant. Arrêter puis relancer le bon job est plus sûr que d’ouvrir plusieurs serveurs pour la même tâche.
pwd
ls -la
cat package.json
npm run
npm ls
which npm
jobsSymptôme et vérification suivante
« Commande introuvable » : lancez help ou which et utilisez npm exec pour un binaire local. « Script absent » : comparez son nom avec npm run. « Paquet natif » : lisez l’avertissement de l’installateur et exécutez ce flux là où le binaire est supporté.
« Preview arrêté » : vérifiez jobs, relancez seulement le job serveur et ouvrez son URL. « Fichier absent » : enregistrez, vérifiez la racine et cherchez le chemin ; node_modules, .git, dist et .odete sont ignorés dans la navigation récursive.
| Symptôme | Vérification |
|---|---|
| script absent | npm run |
| binaire local | npm exec nom ou which nom |
| serveur actif | jobs |
| port/Preview | URL affichée par serveur |
| erreur de texte | grep -rn "terme" src |
| limite Swift | Problems et Swift Playgrounds |
Quand changer d’environnement
Passez sur Mac ou CI pour addon natif, build Astro/Next, compilation Swift, intégration système ou API Node non implémentée. Conserver commande, sortie et version de paquet rend la reproduction concrète.
Avant de signaler un bug, réduisez le cas : commande saisie, dossier du projet, code minimal et sortie complète. Cela sépare une limite Odete connue d’un problème propre au projet.