sourcebook

Detecta los archivos que tu agente de IA olvidó cambiar.

Una capa de seguridad para cambios de código. sourcebook analiza los diffs de git en busca de integridad: marca los archivos que deberían haberse modificado pero no lo hicieron. Detección estructural basada en reglas más análisis semántico impulsado por IA. Cero falsos positivos en diffs limpios.

npx sourcebook init # sets up Claude Code hooks + generates CLAUDE.md
npx sourcebook check # check your current diff for missing files
npx sourcebook scan-history # see what you've been missing

Qué detecta

Tu agente de IA cambió el manejador. ¿Actualizó la prueba? ¿El módulo hermano? ¿La configuración que hace referencia al valor antiguo?

sourcebook verifica tu diff contra la estructura real del repositorio:

• Archivos de prueba faltantes — el archivo fuente cambió, el archivo de prueba no

• Módulos hermanos — archivos que importan o son importados por lo que cambiaste

• Compañeros de cambio conjunto — archivos que históricamente cambian juntos en los commits de git

• Radio de impacto de archivos centrales — tocaste algo con más de 50 dependientes

Con --ai: relaciones semánticas entre módulos, cambios de nombre de campos que requieren migraciones, lógica de validación obsoleta.

Related MCP server: Carto MCP Server

Estadísticas clave

Cuatro superficies

1. CLI

Ejecútalo en cualquier diff. No requiere configuración.

npx sourcebook check # check staged/unstaged changes
npx sourcebook check --ai # add AI semantic analysis (requires ANTHROPIC_API_KEY)
npx sourcebook check --quiet # exit code only (for CI/scripts)
npx sourcebook check --branch main # compare vs a branch

2. Hooks de Claude Code

Un comando configura los hooks de pre-commit. El agente edita un archivo, sourcebook verifica el diff, el agente ve lo que falta, todo antes de que el commit se realice.

npx sourcebook init # generates CLAUDE.md + installs hooks

3. Servidor MCP

Publicado en el registro oficial de MCP. Los agentes pueden consultar la estructura del repositorio, el radio de impacto, las convenciones y los datos de cambios conjuntos bajo demanda.

npx sourcebook serve

Agrégalo a tu cliente MCP:

{
 "mcpServers": {
 "sourcebook": {
 "command": "npx",
 "args": ["-y", "sourcebook", "serve", "--dir", "/path/to/your/project"]
 }
 }
}

4. Aplicación de GitHub (próximamente)

Verificaciones de integridad automatizadas en cada pull request. Únete a la lista de espera.

Comandos

Cómo funciona

Capa A — Basada en reglas (sin LLM, <1 segundo)

1. Análisis de cambios conjuntos — extrae el historial de git para encontrar archivos que cambian juntos. Si tocaste auth.ts y cambia con session.ts en el 88% de los commits, sourcebook marca session.ts.

2. Detección de archivos de prueba — mapea archivos fuente a archivos de prueba mediante convenciones de nomenclatura e historial de cambios conjuntos.

3. Grafo de importaciones — construye un grafo de dependencias y verifica si los archivos que importan (o son importados por) tus archivos cambiados también necesitan actualizaciones.

4. Detección de archivos centrales — marca cuando has modificado un archivo con alto fan-in (muchos dependientes). Estos cambios tienen radio de impacto.

Capa B — Impulsada por IA (~$0.012/ejecución)

Envía el diff más el contexto de dependencia a Claude Sonnet. Detecta relaciones semánticas que la Capa A no puede ver: cambios de nombre de campos que necesitan migraciones, lógica de validación que asume esquemas antiguos, dependencias entre módulos sin enlace de importación.

Cada sugerencia de IA requiere una cita de dependencia. Las rutas de archivo alucinadas se filtran. La puerta de integridad asegura cero falsos positivos: si el diff está realmente completo, la Capa B permanece en silencio.

Configuración

# Required for --ai flag only
export ANTHROPIC_API_KEY=sk-ant-...

No se necesita ninguna otra configuración. sourcebook lee el historial de git y la estructura de archivos de tu repositorio directamente.

Soporte de idiomas

Investigación

Construido sobre benchmarks reales, no sobre suposiciones:

• Verificar resultados de validación — metodología y datos de precisión

• Benchmark: 19 tareas, 10 repositorios, 4 idiomas — pruebas de rendimiento de agentes controladas

• Por qué el contexto generado automáticamente empeora a los agentes — el hallazgo de ETH Zurich que dio forma a nuestro enfoque

Licencia

BSL-1.1 — código disponible, uso gratuito, no puede ofrecerse como servicio alojado. Se convierte a MIT el 25-03-2030. Consulta LICENSE para más detalles.

sourcebook.run · GitHub · npm · @maroond_

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers