aidiff-lint

aidiff-lint

Linter independiente (sin dependencias de terceros) para diffs de Git generados por agentes de codificacion IA (Kimi, Aider, Copilot, Cursor, etc.).

Detecta patrones de falla recurrentes que no son errores de sintaxis evidentes, pero rompen la compilacion, el renderizado, o introducen basura en la base de codigo:

• Inyeccion de caracteres CJK en docstrings/comentarios.
• Cadenas Django ORM alucinadas (Model.field.related_model.objects).
• Tags de Django templates rotos o desbalanceados (incluyendo cierres eliminados por el propio diff, no solo agregados).
• Tags HTML estructurales rotos o duplicados.
• "Smells" de templates Django: URLs de admin hardcodeadas, target="_blank" sin rel="noopener noreferrer", formularios POST sin {% csrf_token %}.
• Cadenas de atributos sospechosamente profundas a traves de objetos tipo diccionario (alert.metadata.batch.id) que fallan en silencio en templates Django.

Instalacion

pip install -e ".[dev]"

Uso

aidiff-lint                      # unstaged changes
aidiff-lint --staged             # staged changes
aidiff-lint --commit <hash>      # un commit especifico
aidiff-lint --range <a>..<b>     # un rango de commits
aidiff-lint --diff-file path.diff
aidiff-lint --repo /ruta/al/repo

Exit codes

• 0: sin hallazgos ERROR (puede haber WARNING).
• 1: al menos un hallazgo ERROR.
• 2: error de uso/ejecucion.

Tests

pytest tests/ -v