¿Qué es stalemap?
stalemap localiza las dependencias npm de un proyecto cuyas API cambiaron después de la fecha de corte de entrenamiento del modelo y pasa esos cambios al agente de código. Obtiene la fecha de corte del modelo configurado a través de models.dev, toma como lo que el modelo conoce la versión estable más reciente publicada al menos 30 días antes, y la compara con la versión que fijas.
Para compararlas descarga los archivos de tipos .d.ts de ambas versiones y los contrasta con la API del compilador de TypeScript, y añade los cambios incompatibles de changelogs y GitHub Releases. El agente recibe el resultado de tres maneras: un bloque de notas ordenado en AGENTS.md o CLAUDE.md (1.800 tokens por defecto), un guardián que ejecuta el tsc del propio proyecto tras cada edición y adjunta a cada error la nota correspondiente, y una herramienta MCP llamada search_changes.
Se distribuye como paquete npm, plugin de Claude Code, GitHub Action y comandos de configuración para Cursor, Codex y OpenCode. El código es MIT, el repositorio se creó el 19 de octubre de 2026 y la última versión es la 0.4.1, del 20 de octubre.
¿Merece la pena stalemap?
stalemap ataca un fallo concreto: un agente escribe código para la versión de una biblioteca con la que se entrenó, no para la que fijas tú. Los ejemplos del README son maxSteps frente a AI SDK 7, required_error frente a zod 4 y middleware.ts frente a Next 16. En lugar de descargar páginas enteras de documentación, compara las definiciones de tipos de las dos versiones y le pasa al agente solo lo que cambió en las API que importa tu código.
Las pruebas son mejores que las de casi cualquier herramienta para agentes. En un test ciego y prerregistrado de 66 tareas sacadas de cambios que 33 paquetes npm populares publicaron entre julio y octubre de 2026, claude-sonnet-5-5 superó el 89 % de las sesiones con stalemap, frente al 68 % sin ayuda y el 73 % con un simple hook de tsc --noEmit tras cada edición; el intervalo de la comparación principal fue de 13,6 a 28,3 puntos. El autor también da el techo: una pista de una línea escrita a mano que nombra el cambio llegó al 98 %. La herramienta, el entorno de pruebas y los protocolos son del mismo autor, aunque las tareas las escribió una sesión separada y las revisó un revisor independiente, y solo se midieron dos modelos de Claude.
No sale gratis usarlo. El coste mediano por sesión subió de $0.041 a $0.050 con claude-sonnet-5-5, y de $0.085 a $0.124 con claude-sonnet-4-5, con sesiones de 79 segundos en lugar de 47. El código nunca sale de la máquina, pero los nombres y versiones de paquetes van al registro de npm, a GitHub y a models.dev, y los modos opcionales --llm, --examples y --guides envían a Claude diffs de tipos y los nombres de las API importadas.
Los límites están claros en el README: un único package.json sin soporte de workspaces, sin comparar paquetes @types, un seguimiento de uso que se queda en nombres importados y accesos x.member, y una configuración para Cursor, Codex y OpenCode que no se ha probado en una instalación real. Context7 cubre más lenguajes sirviendo documentación actual bajo demanda; stalemap es la herramienta más estricta, porque el guardián detecta llamadas obsoletas al editar aunque al agente nunca se le ocurra preguntar.
Dónde se gana su sitio
Un desarrollador independiente con una app en Next.js 16 y AI SDK 7 que usa Claude Code
Que el agente deje de escribir código con middleware.ts y maxSteps que ya no compila
Instalar el plugin de Claude Code con dos comandos /plugin; las notas se cargan al iniciar la sesión y el guardián informa de los errores de compilación con el arreglo tras cada edición. Las sesiones cuestan algo más, unos $0.009 por tarea en la mediana con claude-sonnet-5-5.
Un responsable técnico en una agencia de TypeScript con 20 desarrolladores
Mantener al día las instrucciones de los agentes cuando Renovate sube una versión mayor
Hacer commit del bloque de notas y añadir la GitHub Action con el parámetro model: npx stalemap check hace fallar el CI si el bloque está desfasado, o el modo comentario publica qué cambió en los pull requests que tocan dependencias. El modo comentario necesita pull-requests: write.
Una desarrolladora que usa Cursor o Codex en lugar de Claude Code
Dar al agente los cambios de API actuales cuando los necesite mientras trabaja
Ejecutar stalemap setup --agent cursor (o codex) para escribir las notas, registrar el servidor MCP e instalar el guardián tras edición como archivos del proyecto. Según el autor, esta vía aún no se ha probado en una instalación real de Cursor o Codex.
Antes de decidirte
- Puesta en marcha
- /plugin marketplace add Umair/stalemap y después /plugin install stalemap@stalemap en Claude Code, o npx stalemap para ver la vista previa y npx stalemap sync para escribir el bloque; cualquier cliente MCP puede ejecutar npx -y stalemap@latest mcp.
- Integraciones
- Cuatro herramientas MCP (search_changes, package_changes, project_changes, check_notes); hooks SessionStart y PostToolUse de Claude Code; configuración para Cursor, Codex y OpenCode; una GitHub Action; lockfiles de npm, pnpm, yarn y bun.
- Datos y privacidad
- El código fuente se analiza en local y nunca se sube. Los nombres y versiones de paquetes van al registro de npm, a GitHub y a models.dev; --llm, --examples y --guides envían a Claude diffs de tipos, extractos de notas de versión y nombres de API importadas. Las cachés están en ~/.cache/stalemap. MIT.
- Coste a escala
- La herramienta es gratuita. En la prueba del autor subió el coste mediano por sesión de $0.041 a $0.050 con claude-sonnet-5-5 y de $0.085 a $0.124 con claude-sonnet-4-5; los resúmenes opcionales escritos por Claude añaden llamadas a la API con tu clave.
- Límites
- Solo JavaScript y TypeScript; un package.json; los paquetes @types no se comparan; los cambios de comportamiento solo se detectan si los nombran las notas de versión o las guías de actualización; a veces los agentes ignoran notas correctas.
Lo bueno
- Compara definiciones de tipos reales, no un resumen de la documentación hecho por un modelo
- El guardián al editar une cada error del compilador con su nota de cambio
- Prueba ciega y prerregistrada que publica el techo y los costes
- El código fuente nunca se sube; el análisis es local
- Plugin de Claude Code, servidor MCP, CLI y GitHub Action
Lo malo
- Solo JavaScript y TypeScript; un package.json, sin workspaces
- Sube el coste mediano por sesión, un 22 % aprox. con claude-sonnet-5-5
- Configuración para Cursor, Codex y OpenCode sin probar en instalaciones reales
- Un solo mantenedor; creado el 19 de octubre de 2026
Ideal para
Desarrolladores de TypeScript cuyo agente de código sigue escribiendo para versiones antiguas de paquetes que cambian rápido, como Next.js, el AI SDK o zod.
stalemap: preguntas frecuentes
- ¿Merece la pena stalemap?
- Un arreglo estrecho para un problema real y caro, con una prueba inusualmente cuidadosa detrás, pero solo para JavaScript y TypeScript y de un único mantenedor. Le damos un 3.8 sobre 5.
- ¿Cuánto cuesta stalemap?
- Gratis bajo MIT. Las funciones opcionales --llm, --examples y --guides llaman a Claude con tu propia clave de Anthropic o tu sesión de Claude Code.
- ¿Qué inconvenientes tiene stalemap?
- Solo JavaScript y TypeScript; un package.json, sin workspaces; sube el coste mediano por sesión, un 22 % aprox. con claude-sonnet-5-5; configuración para Cursor, Codex y OpenCode sin probar en instalaciones reales; un solo mantenedor; creado el 19 de octubre de 2026.
- ¿Para quién es stalemap?
- Desarrolladores de TypeScript cuyo agente de código sigue escribiendo para versiones antiguas de paquetes que cambian rápido, como Next.js, el AI SDK o zod.
- ¿Cuánto cuesta stalemap para un equipo o en producción?
- La herramienta es gratuita. En la prueba del autor subió el coste mediano por sesión de $0.041 a $0.050 con claude-sonnet-5-5 y de $0.085 a $0.124 con claude-sonnet-4-5; los resúmenes opcionales escritos por Claude añaden llamadas a la API con tu clave.
- ¿Es stalemap seguro para los datos de la empresa?
- El código fuente se analiza en local y nunca se sube. Los nombres y versiones de paquetes van al registro de npm, a GitHub y a models.dev; --llm, --examples y --guides envían a Claude diffs de tipos, extractos de notas de versión y nombres de API importadas. Las cachés están en ~/.cache/stalemap. MIT.
Respuestas comprobadas el 5 nov 2026.