argon-architecture-scanner 0.9.1

Zero-install AST Context Engine for AI Assistants. Compresses codebases by 99% using PageRank & Semantic Search.

ARGON — Universal Architecture Scanner

ARGON is a Tier-S static analysis tool designed specifically for AI Coding Assistants. It parses massive repositories using Tree-sitter, ranks symbols via Google PageRank, and uses local ML embeddings (sentence-transformers) to deliver surgical context. Save up to 99% of your LLM token context window.

ARGON escanea proyectos de software y genera un grafo de arquitectura con:

• Símbolos (clases, funciones, interfaces) vía Tree-sitter o regex
• Conexiones entre archivos (imports/dependencias)
• Call graph intra-archivo (función A llama a función B en el mismo archivo)
• Búsqueda semántica con embeddings locales (TF-IDF, sentence-transformers, Ollama)
• Visualización interactiva con D3.js (SVG voxels) o PixiJS/WebGL (GPU)
• MCP Server para integración con asistentes IA
• Watch mode para actualización automática en cambios
• Auto-Bootstrap JIT (Zero-Install): Ejecuta el script. Todas las dependencias (AST, MCP, tokenizers) se autoinstalan en segundo plano si faltan.

Uso (Plug & Play)

# Escaneo de precisión
python argon.py . --precision

# Modo centinela (Watch)
python argon_watch.py .

Uso rápido

# Escanear proyecto
python argon.py /ruta/proyecto --context

# Generar visualización interactiva
python argon_view.py --json argon_graph.json

# Servidor MCP (para Claude, Cursor, etc.)
python argon_mcp.py

# Watch mode (actualización automática)
python argon_watch.py /ruta/proyecto

Herramientas

Comando	Descripción
argon.py	Escáner universal con parser dual (Tree-sitter + regex)
argon_view.py	Genera visualización HTML interactiva
argon_mcp.py	Servidor MCP con herramientas para IA
argon_watch.py	Sentinel que actualiza el grafo en cambios
argon_semantic.py	Motor de búsqueda semántica por embeddings
argon_quality_bench.py	Benchmarks formales precision@budget multi-lenguaje
argon_template.html	Template del visualizador D3.js/PixiJS

Visualización

• < 500 nodos: SVG voxels (cubos 3D isométricos, tema cyberpunk)
• ≥ 500 nodos: PixiJS/WebGL (renderizado GPU, 10K+ nodos suaves)
• 6 temas visuales: Architect, Cyber, Fallout, Vaporwave, Matrix, Industrial
• Búsqueda por nombre de archivo, símbolo o concepto

MCP Tools

Tool	Descripción
argon_overview	Resumen del proyecto estadísticas y hubs
argon_query	Buscar símbolos específicos
argon_deps	Dependencias de un archivo
argon_search	Búsqueda por concepto/funcionalidad
argon_focused_context	Contexto optimizado para tareas específicas
argon_semantic_search	Búsqueda semántica por intención (embeddings)
argon_ast_query	Buscar por patrón en firmas/nombres (regex)
argon_rescan	Regenerar grafo tras cambios

Licencia

MIT