Qu’est-ce que stalemap ?
stalemap repère les dépendances npm d'un projet dont les API ont changé après la date limite d'entraînement du modèle, et transmet ces changements à l'agent de code. Il obtient la date limite du modèle configuré via models.dev, considère comme connue du modèle la version stable la plus récente publiée au moins 30 jours avant, et la compare à la version que vous fixez.
Pour comparer, il télécharge les fichiers de types .d.ts des deux versions et les confronte avec l'API du compilateur TypeScript, puis ajoute les changements cassants tirés des changelogs et des GitHub Releases. L'agent reçoit le résultat de trois façons : un bloc de notes classé dans AGENTS.md ou CLAUDE.md (1 800 tokens par défaut), un garde qui lance le tsc du projet après chaque modification et joint à chaque erreur la note correspondante, et un outil MCP nommé search_changes.
Il est distribué sous forme de paquet npm, de plugin Claude Code, de GitHub Action et de commandes d'installation pour Cursor, Codex et OpenCode. Le code est sous MIT, le dépôt a été créé le 19 octobre 2026 et la dernière version est la 0.4.1, du 20 octobre.
stalemap vaut-il le coup ?
stalemap vise un échec précis : un agent écrit du code pour la version d'une bibliothèque sur laquelle il a été entraîné, pas pour celle que vous fixez. Les exemples du README sont maxSteps face à AI SDK 7, required_error face à zod 4 et middleware.ts face à Next 16. Au lieu de récupérer des pages entières de documentation, il compare les définitions de types des deux versions et ne transmet à l'agent que ce qui a changé dans les API que votre code importe.
Les preuves sont meilleures que pour la plupart des outils d'agents. Dans un test à l'aveugle et pré-enregistré de 66 tâches tirées des changements publiés par 33 paquets npm populaires entre juillet et octobre 2026, claude-sonnet-5-5 a réussi 89 % des sessions avec stalemap, contre 68 % seul et 73 % avec un simple hook tsc --noEmit après chaque modification ; l'intervalle de la comparaison principale allait de 13,6 à 28,3 points. L'auteur donne aussi le plafond : une indication d'une ligne écrite à la main qui nomme le changement atteint 98 %. L'outil, le banc et les protocoles ont le même auteur, mais les tâches ont été écrites par une session distincte et vérifiées par un relecteur indépendant, et seuls deux modèles Claude ont été mesurés.
Son usage n'est pas gratuit. Le coût médian par session est passé de $0.041 à $0.050 avec claude-sonnet-5-5, et de $0.085 à $0.124 avec claude-sonnet-4-5, avec des sessions de 79 secondes au lieu de 47. Le code ne quitte jamais la machine, mais les noms et versions des paquets partent vers le registre npm, GitHub et models.dev, et les modes optionnels --llm, --examples et --guides envoient à Claude des diffs de types et les noms des API importées.
Les limites sont écrites noir sur blanc dans le README : un seul package.json sans prise en charge des workspaces, pas de comparaison des paquets @types, un suivi d'usage qui s'arrête aux noms importés et aux accès x.member, et une installation pour Cursor, Codex et OpenCode jamais essayée dans une installation réelle. Context7 couvre plus de langages en servant la documentation à jour à la demande ; stalemap est l'outil le plus strict, car le garde attrape les appels périmés au moment de l'édition même quand l'agent ne pense pas à demander.
Là où il fait la différence
Un développeur indépendant sur une app Next.js 16 et AI SDK 7, sous Claude Code
Empêcher l'agent d'écrire du code middleware.ts et maxSteps qui ne compile plus
Installer le plugin Claude Code avec deux commandes /plugin ; les notes se chargent au démarrage de la session et le garde signale les erreurs de compilation avec la correction après chaque modification. Les sessions coûtent un peu plus, environ $0.009 par tâche en médiane sur claude-sonnet-5-5.
Un responsable technique dans une agence TypeScript de 20 développeurs
Garder les consignes des agents à jour quand Renovate monte une version majeure
Commiter le bloc de notes, puis ajouter la GitHub Action avec un paramètre model : npx stalemap check fait échouer la CI quand le bloc est périmé, ou le mode commentaire indique ce qui a changé sur les pull requests qui touchent aux dépendances. Le mode commentaire demande pull-requests: write.
Une développeuse qui utilise Cursor ou Codex plutôt que Claude Code
Donner à l'agent les changements d'API actuels à la demande pendant qu'il travaille
Lancer stalemap setup --agent cursor (ou codex) pour écrire les notes, enregistrer le serveur MCP et installer le garde après modification sous forme de fichiers du projet. Selon l'auteur, ce parcours n'a pas encore été essayé dans une vraie installation de Cursor ou de Codex.
Avant de vous engager
- Mise en route
- /plugin marketplace add Umair/stalemap puis /plugin install stalemap@stalemap dans Claude Code, ou npx stalemap pour un aperçu et npx stalemap sync pour écrire le bloc ; tout client MCP peut lancer npx -y stalemap@latest mcp.
- Intégrations
- Quatre outils MCP (search_changes, package_changes, project_changes, check_notes) ; hooks SessionStart et PostToolUse de Claude Code ; installation pour Cursor, Codex et OpenCode ; une GitHub Action ; lockfiles npm, pnpm, yarn et bun.
- Données et confidentialité
- Le code source est analysé en local et jamais envoyé. Les noms et versions des paquets vont au registre npm, à GitHub et à models.dev ; --llm, --examples et --guides envoient à Claude des diffs de types, des extraits de notes de version et les noms des API importées. Les caches sont dans ~/.cache/stalemap. MIT.
- Coût à grande échelle
- L'outil est gratuit. Dans le banc d'essai de l'auteur, il a fait passer le coût médian par session de $0.041 à $0.050 sur claude-sonnet-5-5 et de $0.085 à $0.124 sur claude-sonnet-4-5 ; les résumés optionnels écrits par Claude ajoutent des appels d'API sur votre clé.
- Limites
- JavaScript et TypeScript seulement ; un package.json ; les paquets @types ne sont pas comparés ; les changements de comportement ne sont repérés que si les notes de version ou les guides de migration les nomment ; les agents ignorent parfois des notes correctes.
Les points forts
- Compare de vraies définitions de types, pas un résumé de documentation fait par un modèle
- Le garde à l'édition associe chaque erreur du compilateur à la note de changement correspondante
- Banc d'essai à l'aveugle et pré-enregistré, avec plafond et coûts publiés
- Le code source n'est jamais envoyé ; l'analyse est locale
- Plugin Claude Code, serveur MCP, CLI et GitHub Action
Les points faibles
- JavaScript et TypeScript seulement ; un package.json, pas de workspaces
- Augmente le coût médian par session, d'environ 22 % sur claude-sonnet-5-5
- Installation pour Cursor, Codex et OpenCode non testée en conditions réelles
- Un seul mainteneur ; créé le 19 octobre 2026
Idéal pour
Les développeurs TypeScript dont l'agent de code écrit encore pour d'anciennes versions de paquets qui évoluent vite, comme Next.js, l'AI SDK ou zod.
stalemap : questions fréquentes
- stalemap vaut-il le coup ?
- Une solution étroite à un problème réel et coûteux, adossée à un banc d'essai d'une rigueur peu commune, mais uniquement pour JavaScript et TypeScript et portée par un seul mainteneur. Nous lui donnons 3.8 sur 5.
- Combien coûte stalemap ?
- Gratuit sous MIT. Les fonctions optionnelles --llm, --examples et --guides appellent Claude avec votre propre clé Anthropic ou votre connexion Claude Code.
- Quels sont les inconvénients de stalemap ?
- JavaScript et TypeScript seulement ; un package.json, pas de workspaces; augmente le coût médian par session, d'environ 22 % sur claude-sonnet-5-5; installation pour Cursor, Codex et OpenCode non testée en conditions réelles; un seul mainteneur ; créé le 19 octobre 2026.
- À qui s’adresse stalemap ?
- Les développeurs TypeScript dont l'agent de code écrit encore pour d'anciennes versions de paquets qui évoluent vite, comme Next.js, l'AI SDK ou zod.
- Combien coûte stalemap pour une équipe ou en production ?
- L'outil est gratuit. Dans le banc d'essai de l'auteur, il a fait passer le coût médian par session de $0.041 à $0.050 sur claude-sonnet-5-5 et de $0.085 à $0.124 sur claude-sonnet-4-5 ; les résumés optionnels écrits par Claude ajoutent des appels d'API sur votre clé.
- stalemap est-il sûr pour les données de l’entreprise ?
- Le code source est analysé en local et jamais envoyé. Les noms et versions des paquets vont au registre npm, à GitHub et à models.dev ; --llm, --examples et --guides envoient à Claude des diffs de types, des extraits de notes de version et les noms des API importées. Les caches sont dans ~/.cache/stalemap. MIT.
Réponses vérifiées le 5 nov. 2026.