Metadata-Version: 2.4
Name: argon-architecture-scanner
Version: 0.9.1
Summary: Zero-install AST Context Engine for AI Assistants. Compresses codebases by 99% using PageRank & Semantic Search.
Author-email: Dante7u7r <your.email@example.com>
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: tiktoken>=0.12.0
Requires-Dist: pathspec>=1.1.1
Requires-Dist: tree-sitter>=0.25.2
Requires-Dist: tree-sitter-language-pack>=0.10.0
Requires-Dist: mcp>=1.27.1
Provides-Extra: dev
Requires-Dist: pytest>=9.0.0; extra == "dev"
Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
Requires-Dist: playwright>=1.59.0; extra == "dev"
Provides-Extra: semantic
Requires-Dist: sentence-transformers>=3.0.0; extra == "semantic"

# 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)

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

# Modo centinela (Watch)
python argon_watch.py .
```
## Uso rápido

```bash
# 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
