¿Qué hace dev-experiment-031?
waterline - analizador diferencial de alcanzabilidad offline, sin LLM y sin dependencias para paquetes de habilidades de agente: calcula el cierre alcanzable bajo cuatro modelos de resolución e informa dónde diverge la vista de un escáner de la de un agente (la brecha auditoría-ejecución + blanqueo de referencias).
Descripción
waterline es una herramienta que analiza paquetes de habilidades de agente (skill bundles) sin conexión a internet, sin uso de modelos de lenguaje y sin instalar dependencias adicionales. Su objetivo es determinar qué archivos, recursos o referencias son realmente alcanzables por un agente en tiempo de ejecución, en comparación con lo que un escáner de seguridad tradicional podría reportar.
Modelos de resolución
waterline implementa cuatro modelos de resolución de dependencias:
- Modelo estricto: Resuelve solo las dependencias declaradas explícitamente en el manifiesto del paquete.
- Modelo permisivo: Resuelve dependencias declaradas más aquellas que el agente puede inferir dinámicamente.
- Modelo de escáner: Simula la vista de un escáner típico que analiza el sistema de archivos.
- Modelo de agente: Simula la vista del agente, que puede acceder a recursos a través de referencias indirectas o dinámicas.
Uso
waterline <ruta-del-paquete>
Opciones
--model <modelo>: Especifica el modelo de resolución a usar (estricto, permisivo, escáner, agente).--output <formato>: Formato de salida (json, tabla, texto).--diff: Muestra solo las diferencias entre el modelo de escáner y el de agente.--verbose: Muestra información detallada del proceso de resolución.
Salida
La herramienta genera un informe que incluye:
- Cierre alcanzable: Lista de todos los archivos y recursos accesibles bajo cada modelo.
- Brecha auditoría-ejecución: Diferencias entre la vista del escáner y la del agente.
- Blanqueo de referencias: Casos donde el agente puede acceder a un recurso que el escáner no detecta porque la referencia está oculta o se construye dinámicamente.
Ejemplo
# Analizar un paquete de habilidades
waterline ./mi-skill-bundle --diff --output json
Compatibilidad
waterline es compatible con paquetes de habilidades para:
- Claude Code
- Cursor
- Codex
- Otros agentes que usen formatos de paquete similares
Licencia
Este proyecto se distribuye bajo la licencia MIT.
Contribuciones
Las contribuciones son bienvenidas. Por favor, abre un issue o un pull request en el repositorio.