About the project
SIAR (Sistema de Inspección de Archivos y Repositorios) es una herramienta de ciberdefensa fronteriza diseñada para actuar como una aduana de seguridad entre los agentes de programación basados en Inteligencia Artificial (como Cursor, Copilot o herramientas MCP) y el mundo exterior. Desarrollado para el Hackathon Cyber.ar 2026 (Eje 2), el sistema intercepta, aísla y analiza repositorios y dependencias antes de que la IA pueda interactuar con ellos, previniendo ataques de cadena de suministro y manipulación de modelos.
El proyecto resuelve una vulnerabilidad crítica emergente: los asistentes de código actuales instalan paquetes de terceros sin supervisión humana. Esto abre vectores para prompt injections ocultas (instrucciones maliciosas camufladas en archivos legibles para manipular a la IA), typosquatting (dependencias maliciosas que suplantan a las legítimas) y la exposición involuntaria de secretos alojados en historiales de Git.
🛡️ Motor de Detección Híbrido
SIAR opera bajo un modelo de análisis sin ejecución. Descarga el objetivo en un entorno de cuarentena y lo somete a un pipeline de evaluación que combina reglas deterministas con un triage semántico mediante IA soberana:
- Instrucciones y Manipulación: Busca patrones dirigidos específicamente a vulnerar agentes de IA en archivos de configuración o documentación (ej.
.cursorrules,README.md). - Inspección de Unicode: Implementa una vista de "rayos X" para detectar caracteres invisibles, etiquetas Unicode y texto de ancho cero utilizados para contrabandear instrucciones.
- Análisis de Dependencias: Identifica paquetes sospechosos, de reciente creación o con scripts de instalación (
postinstall) potencialmente peligrosos. - Auditoría de Credenciales: Rastrea tokens y secretos tanto en el árbol de archivos activo como en el historial completo de Git mediante la integración con
gitleaks. - Triage Semántico Local: Utiliza un modelo LLM servido localmente a través de Ollama para clasificar hallazgos ambiguos. Por diseño de seguridad, la IA nunca puede reducir la severidad de una amenaza detectada por los módulos deterministas.
🛂 Veredicto y Autorización Humana (Fail-Closed)
Tras el análisis, el motor emite un dictamen vinculante clasificado en tres niveles: 🟢 LIBERADO, 🟡 REVISAR o 🔴 RETENIDO.
Si el veredicto es de revisión o retención, la IA no puede avanzar por sí sola. El sistema implementa un flujo estricto de autorización humana:
- La IA detiene su ejecución y notifica al operador.
- El operador revisa un informe ejecutivo generado por la interfaz web de SIAR.
- Si el humano decide asumir el riesgo (exigiendo doble confirmación en casos críticos), el sistema genera un Token de Aprobación de un solo uso.
- La IA presenta este token al sistema para desbloquear el acceso al artefacto. Sin este token válido y trazable, el proceso permanece bloqueado por defecto.
🏗️ Arquitectura y Stack Tecnológico
El sistema está diseñado para garantizar la privacidad de los datos mediante ejecución 100% local (127.0.0.1), estructurado en tres grandes bloques:
| Componente | Descripción | Tecnologías Clave |
|---|---|---|
| Plataforma | Orquesta la API, la ingesta de código hacia cuarentenas efímeras, la persistencia de datos y la comunicación en vivo. Incluye un servidor MCP. | Node.js, Express, SQLite (WAL), SSE, CLI. |
| Motor | Contiene la lógica de evaluación (SAST + Analizadores deterministas), el cliente del modelo local y el calculador de veredictos basado en scoring. | TypeScript, Ollama. |
| Frontend | Interfaz del operador para seguimiento de inspecciones en tiempo real e impresión de informes ejecutivos con formato institucional formal. | React 18, Vite, Tailwind CSS 4, TanStack Query. |
⚖️ Alineación Normativa e Institucional
SIAR no solo realiza un análisis técnico, sino que enmarca sus hallazgos en un contexto normativo. El informe ejecutivo generado incluye sustentación basada en marcos de Defensa Nacional, como el MITRE ATLAS (tácticas de inyección de prompts y compromiso de cadena de suministro), la Resolución 1380/2019 del MinDefensa (anticipación de ciberataques) y la Ley 23.554. Esta sustentación es inyectada de manera determinista, evitando alucinaciones del LLM y asegurando que el documento final sea válido para procesos de auditoría en infraestructuras críticas.
Hacki