Slopgate

Qué problema resuelve

Tu agente corrige un problema y vuelve a introducir la misma conversión insegura, un manejador de errores vacío o una importación prohibida. Slopgate convierte las reglas del proyecto en comprobaciones tras editar y antes de cada commit, para no repetir los mismos comentarios en cada conversación.

Formas de usarlo

• Detectar conversiones inseguras

  Activa el paquete as-any. Si el agente añade una conversión insegura, la comprobación rápida señala el archivo y la regla; corrige el tipo o la validación antes de seguir.

• Añadir controles a una app existente

  Revisa una línea base inicial de infracciones existentes. Las nuevas bloquean futuros commits mientras corriges la deuda anterior; no actualices la línea base para ocultar regresiones.

• Separar la interfaz de la base de datos

  Añade una regla de límites del proyecto en dependency-cruiser. La comprobación de commit puede detectar una importación que la cruza en vez de depender solo de una instrucción escrita.

Antes de empezar

• Un repositorio Git y Node.js 18 o posterior con npm.
• Permiso para instalar la CLI y añadir hooks de Git o Claude Code al proyecto.
• Dependencias de las comprobaciones que actives; el paquete incluye su motor nativo y ast-grep fijado.

Instalación y configuración

1. Instalar la versión documentada

   Ejecuta esto en una terminal con Node/npm. La versión documentada es 0.3.4; el motor empaquetado no necesita Rust.

   npm install -g @alexcodeplace/slopgate@0.3.4

2. Inicializar el proyecto

   Desde la raíz del repositorio, inicializa Slopgate. Revisa la configuración .slopgate y los cambios de hooks antes de aceptarlos.

   slopgate init .

3. Revisar la línea base inicial

   Solo después de revisar las infracciones, crea la línea base inicial. El comando rechaza sobrescribir una existente; actualizarla es una decisión aparte.

   slopgate baseline --config .slopgate/config.toml

Uso en tu proyecto

1. Comprobar un archivo modificado

   Sustituye src/app.ts por tu archivo. El nivel rápido ofrece comentarios concretos sin ejecutar todas las comprobaciones pesadas.

   slopgate --file src/app.ts --config .slopgate/config.toml

2. Comprobar los cambios preparados

   Prepara solo los archivos del commit y ejecuta el control. El código 0 indica éxito, 1 señala infracciones bloqueantes y 2 requiere reparar la configuración o el motor AST.

   slopgate --staged --config .slopgate/config.toml

3. Reducir deuda sin aceptar infracciones nuevas

   Después de corregir infracciones existentes, elimina sus huellas resueltas. Esto modifica la línea base; no es una simulación ni acepta infracciones nuevas.

   slopgate baseline --prune --config .slopgate/config.toml

Qué debes saber antes

Las reglas no garantizan que una aplicación sea correcta o segura. Algunas comprobaciones necesitan herramientas del proyecto.