JavaScript / CLI / Action / MCP
dev-error-explainers.
Expliquer une erreur de développement sans LLM.
Sept analyseurs JavaScript déterministes, partagés avec six outils iloveblogs. La bibliothèque s’utilise hors ligne, dans un terminal, en CI ou via un client MCP.
Commencer par l’erreur exacte
La bibliothèque reconnaît des signatures d’erreurs connues et renvoie une explication structurée : règle, gravité, cause et correctifs proposés. Ses modules couvrent CORS, ESM/CommonJS, les dépendances npm, les chunks périmés, les URL et connexions de bases de données et les builds Next.js. Une entrée inconnue est signalée comme telle, sans diagnostic généré par un modèle.
La même logique dans plusieurs contextes
Le paquet public expose les fonctions JavaScript, une interface en ligne de commande, une Action GitHub et un serveur MCP stdio avec l’outil explain_error. Six modules alimentent aussi les outils dans le navigateur sur iloveblogs : le lecteur peut passer de l’explication au fichier source. Le module de connexion aux bases de données reste propre à la bibliothèque.
Un contrat que l’on peut vérifier
Le dépôt comprend un contrat de sortie et un corpus de cas de test. Les tests exécutent diagnose() et vérifient le résultat attendu. Les entrées CLI, Action et MCP masquent les motifs de secrets reconnaissables avant l’analyse ; le contrat en décrit les limites. L’analyseur d’URL de base de données utilise un parcours distinct. Consultez ces limites avant d’utiliser une intégration.
Essayer un exemple documenté
window is not defined
Depuis un checkout du dépôt, utilisez le cas de test public. Le résultat attendu identifie la règle ci-dessous.
npx dev-error-explainers --json < fixtures/next-build/window-undefined/input.txtrule: next-build.window-undefined