reducto-graph 0.2.0__tar.gz

reducto_graph-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Reducto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

reducto_graph-0.2.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include .env.example
+include docker-compose.yml
+recursive-include reducto *.py py.typed

reducto_graph-0.2.0/PKG-INFO

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: reducto_graph
+Version: 0.2.0
+Summary: Universal knowledge graph for LLMs — reduce tokens, not intelligence.
+Author-email: Reducto <sudacadev@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/SudacaDev/reducto
+Project-URL: Documentation, https://github.com/SudacaDev/reducto#readme
+Project-URL: Repository, https://github.com/SudacaDev/reducto
+Project-URL: Bug Tracker, https://github.com/SudacaDev/reducto/issues
+Keywords: llm,knowledge-graph,tokens,mcp,claude,context,codebase,neo4j,ai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: networkx>=3.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Provides-Extra: ast
+Requires-Dist: tree-sitter>=0.23; extra == "ast"
+Requires-Dist: tree-sitter-python>=0.23; extra == "ast"
+Requires-Dist: tree-sitter-javascript>=0.23; extra == "ast"
+Requires-Dist: tree-sitter-typescript>=0.23; extra == "ast"
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Dynamic: license-file
+
+# Reducto
+
+> Reduce tokens, not intelligence.
+
+Reducto convierte tu codebase en un **knowledge graph local** que cualquier LLM puede consultar sin leer archivos enteros. Menos tokens, mejores respuestas, mismo resultado.
+
+## Qué hace
+
+- **Indexa tu proyecto** — parsea `.ts`, `.tsx`, `.js`, `.py` y `.md` extrayendo funciones, clases, imports y calls reales (AST via tree-sitter)
+- **Detecta comunidades** — agrupa automáticamente archivos relacionados usando Louvain clustering
+- **Guarda todo localmente** — en `reducto-out/graph.json`, sin base de datos, sin cuenta, sin internet
+- **Expone el grafo via MCP** — cualquier LLM que soporte MCP (Claude Code, Antigravity, VS Code Copilot, Cursor) lo puede consultar
+- **Cache inteligente (Schrödinger)** — los nodos se resuelven on-demand y se cachean con hash SHA256. Si el archivo cambia, el cache se invalida automáticamente (decoherencia)
+- **Vistas por observador** — pide solo la firma (`signature`), un resumen (`summary`), o el código completo (`full`) — cada vista se cachea independientemente
+
+## Requisitos
+
+- **Python 3.10+** (probado hasta 3.13)
+- **uv** (recomendado) o pip
+
+### Opcional (para parsing AST real)
+
+```bash
+pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript --user
+```
+
+Sin esto, Reducto usa un parser regex que funciona pero es menos preciso. Con tree-sitter se detectan CALLS reales (función→función).
+
+## Instalación
+
+### Opción 1: con pip (la más simple)
+
+```bash
+pip install git+https://github.com/SudacaDev/reducto.git --user
+```
+
+### Opción 2: con uv (más rápido)
+
+```bash
+uv tool install --from git+https://github.com/SudacaDev/reducto.git reducto
+```
+
+### Opción 3: clonar y instalar local
+
+```bash
+git clone https://github.com/SudacaDev/reducto.git
+cd reducto
+pip install . --user
+# o con uv:
+uv tool install --from . reducto
+```
+
+### Opcional: tree-sitter para parsing AST real
+
+```bash
+pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript --user
+```
+
+Sin esto, Reducto funciona con regex (menos preciso). Con tree-sitter detecta CALLS reales (función→función).
+
+### Verificar
+
+```bash
+reducto --help
+```
+
+### Actualizar a la última versión
+
+```bash
+pip install git+https://github.com/SudacaDev/reducto.git --user --force-reinstall
+# o con uv:
+uv tool install --from git+https://github.com/SudacaDev/reducto.git reducto --force
+```
+
+## Primeros pasos
+
+```bash
+# 1. Ir a tu proyecto
+cd mi-proyecto
+
+# 2. Indexar el código (primera vez)
+reducto ingest . --clean
+
+# 3. Conectar con tu IDE
+reducto install
+#   → te pregunta qué IDEs querés configurar
+#   → o directo: reducto install --target all
+
+# 4. Listo — abrí tu IDE y preguntale algo sobre el proyecto
+```
+
+## Uso diario
+
+```bash
+# Re-indexar después de cambios (solo procesa archivos modificados)
+reducto ingest .
+
+# Buscar en el grafo
+reducto query "auth"
+reducto query "getSession" --resolve
+
+# Ver stats de ahorro de tokens
+reducto context
+
+# Ver el grafo visualmente
+reducto visualize
+# → abre reducto-out/graph.html en el navegador
+
+# Agregar un skill de arquitectura desde GitHub
+reducto skill https://github.com/SudacaDev/react-architecture
+```
+
+## Comandos
+
+| Comando | Qué hace |
+|---|---|
+| `reducto ingest . [--clean]` | Indexa el proyecto (`--clean` = rebuild completo) |
+| `reducto install [--target X]` | Configura tu IDE (claude-code, antigravity, vscode, cursor, all) |
+| `reducto query "término" [--resolve]` | Busca en el grafo (`--resolve` = carga el código fuente) |
+| `reducto context` | Muestra tokens usados y ahorrados |
+| `reducto visualize` | Genera un HTML interactivo del grafo |
+| `reducto skill <url>` | Descarga e indexa un skill desde GitHub |
+| `reducto serve` | Levanta el MCP server (el IDE lo usa automáticamente) |
+
+## IDEs soportados
+
+| IDE | Config generada |
+|---|---|
+| Claude Code | `.mcp.json` + `CLAUDE.md` + slash commands |
+| Antigravity (Google) | `AGENTS.md` + `~/.gemini/antigravity/mcp_config.json` |
+| VS Code (Copilot) | `.vscode/mcp.json` |
+| Cursor | `.cursor/mcp.json` + `.cursorrules` |
+
+## Cómo funciona
+
+```
+reducto ingest .      ← parsea el código, extrae nodos y edges, detecta comunidades
+                        todo queda en reducto-out/graph.json
+
+Tu IDE pregunta algo → LLM consulta Reducto via MCP (search_context, get_callers, etc.)
+                     → Reducto busca en el grafo (metadata, ~10 tokens)
+                     → Si necesita el código: resuelve el nodo (lee solo esas líneas)
+                     → Lo cachea con hash SHA256 (próxima vez = 0 tokens)
+                     → Si el archivo cambió: invalida el cache automáticamente
+```
+
+## Archivos generados
+
+```
+tu-proyecto/
+  reducto-out/          ← gitignored
+    graph.json          ← el grafo completo
+    graph.html          ← visualización interactiva
+    session_stats.json  ← stats de tokens
+  .mcp.json             ← config MCP para Claude Code
+  CLAUDE.md             ← routing rules para Claude Code
+  AGENTS.md             ← routing rules para Antigravity
+  .reducto/
+    skills/             ← skills descargados con `reducto skill`
+```
+
+## Troubleshooting
+
+**"tree-sitter no disponible"** — Reducto funciona sin tree-sitter (usa regex), pero para CALLS reales necesitás instalarlo: `pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript --user`
+
+**"error: Failed to install entrypoint" en Windows** — Cerrá Antigravity/Claude Code (tienen `reducto.exe` bloqueado) y reintentá.
+
+**"UnicodeEncodeError" en Windows** — Setear `$env:PYTHONUTF8 = "1"` antes de correr Reducto, o agregarlo permanente: `[System.Environment]::SetEnvironmentVariable("PYTHONUTF8", "1", "User")`
+
+**El MCP no conecta en Antigravity** — Verificá que `~/.gemini/antigravity/mcp_config.json` tenga la entrada de reducto. Corré `reducto install --target antigravity` para regenerarlo.
+
+## Licencia
+
+MIT

reducto_graph-0.2.0/README.md

@@ -0,0 +1,174 @@
+# Reducto
+
+> Reduce tokens, not intelligence.
+
+Reducto convierte tu codebase en un **knowledge graph local** que cualquier LLM puede consultar sin leer archivos enteros. Menos tokens, mejores respuestas, mismo resultado.
+
+## Qué hace
+
+- **Indexa tu proyecto** — parsea `.ts`, `.tsx`, `.js`, `.py` y `.md` extrayendo funciones, clases, imports y calls reales (AST via tree-sitter)
+- **Detecta comunidades** — agrupa automáticamente archivos relacionados usando Louvain clustering
+- **Guarda todo localmente** — en `reducto-out/graph.json`, sin base de datos, sin cuenta, sin internet
+- **Expone el grafo via MCP** — cualquier LLM que soporte MCP (Claude Code, Antigravity, VS Code Copilot, Cursor) lo puede consultar
+- **Cache inteligente (Schrödinger)** — los nodos se resuelven on-demand y se cachean con hash SHA256. Si el archivo cambia, el cache se invalida automáticamente (decoherencia)
+- **Vistas por observador** — pide solo la firma (`signature`), un resumen (`summary`), o el código completo (`full`) — cada vista se cachea independientemente
+
+## Requisitos
+
+- **Python 3.10+** (probado hasta 3.13)
+- **uv** (recomendado) o pip
+
+### Opcional (para parsing AST real)
+
+```bash
+pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript --user
+```
+
+Sin esto, Reducto usa un parser regex que funciona pero es menos preciso. Con tree-sitter se detectan CALLS reales (función→función).
+
+## Instalación
+
+### Opción 1: con pip (la más simple)
+
+```bash
+pip install git+https://github.com/SudacaDev/reducto.git --user
+```
+
+### Opción 2: con uv (más rápido)
+
+```bash
+uv tool install --from git+https://github.com/SudacaDev/reducto.git reducto
+```
+
+### Opción 3: clonar y instalar local
+
+```bash
+git clone https://github.com/SudacaDev/reducto.git
+cd reducto
+pip install . --user
+# o con uv:
+uv tool install --from . reducto
+```
+
+### Opcional: tree-sitter para parsing AST real
+
+```bash
+pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript --user
+```
+
+Sin esto, Reducto funciona con regex (menos preciso). Con tree-sitter detecta CALLS reales (función→función).
+
+### Verificar
+
+```bash
+reducto --help
+```
+
+### Actualizar a la última versión
+
+```bash
+pip install git+https://github.com/SudacaDev/reducto.git --user --force-reinstall
+# o con uv:
+uv tool install --from git+https://github.com/SudacaDev/reducto.git reducto --force
+```
+
+## Primeros pasos
+
+```bash
+# 1. Ir a tu proyecto
+cd mi-proyecto
+
+# 2. Indexar el código (primera vez)
+reducto ingest . --clean
+
+# 3. Conectar con tu IDE
+reducto install
+#   → te pregunta qué IDEs querés configurar
+#   → o directo: reducto install --target all
+
+# 4. Listo — abrí tu IDE y preguntale algo sobre el proyecto
+```
+
+## Uso diario
+
+```bash
+# Re-indexar después de cambios (solo procesa archivos modificados)
+reducto ingest .
+
+# Buscar en el grafo
+reducto query "auth"
+reducto query "getSession" --resolve
+
+# Ver stats de ahorro de tokens
+reducto context
+
+# Ver el grafo visualmente
+reducto visualize
+# → abre reducto-out/graph.html en el navegador
+
+# Agregar un skill de arquitectura desde GitHub
+reducto skill https://github.com/SudacaDev/react-architecture
+```
+
+## Comandos
+
+| Comando | Qué hace |
+|---|---|
+| `reducto ingest . [--clean]` | Indexa el proyecto (`--clean` = rebuild completo) |
+| `reducto install [--target X]` | Configura tu IDE (claude-code, antigravity, vscode, cursor, all) |
+| `reducto query "término" [--resolve]` | Busca en el grafo (`--resolve` = carga el código fuente) |
+| `reducto context` | Muestra tokens usados y ahorrados |
+| `reducto visualize` | Genera un HTML interactivo del grafo |
+| `reducto skill <url>` | Descarga e indexa un skill desde GitHub |
+| `reducto serve` | Levanta el MCP server (el IDE lo usa automáticamente) |
+
+## IDEs soportados
+
+| IDE | Config generada |
+|---|---|
+| Claude Code | `.mcp.json` + `CLAUDE.md` + slash commands |
+| Antigravity (Google) | `AGENTS.md` + `~/.gemini/antigravity/mcp_config.json` |
+| VS Code (Copilot) | `.vscode/mcp.json` |
+| Cursor | `.cursor/mcp.json` + `.cursorrules` |
+
+## Cómo funciona
+
+```
+reducto ingest .      ← parsea el código, extrae nodos y edges, detecta comunidades
+                        todo queda en reducto-out/graph.json
+
+Tu IDE pregunta algo → LLM consulta Reducto via MCP (search_context, get_callers, etc.)
+                     → Reducto busca en el grafo (metadata, ~10 tokens)
+                     → Si necesita el código: resuelve el nodo (lee solo esas líneas)
+                     → Lo cachea con hash SHA256 (próxima vez = 0 tokens)
+                     → Si el archivo cambió: invalida el cache automáticamente
+```
+
+## Archivos generados
+
+```
+tu-proyecto/
+  reducto-out/          ← gitignored
+    graph.json          ← el grafo completo
+    graph.html          ← visualización interactiva
+    session_stats.json  ← stats de tokens
+  .mcp.json             ← config MCP para Claude Code
+  CLAUDE.md             ← routing rules para Claude Code
+  AGENTS.md             ← routing rules para Antigravity
+  .reducto/
+    skills/             ← skills descargados con `reducto skill`
+```
+
+## Troubleshooting
+
+**"tree-sitter no disponible"** — Reducto funciona sin tree-sitter (usa regex), pero para CALLS reales necesitás instalarlo: `pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript --user`
+
+**"error: Failed to install entrypoint" en Windows** — Cerrá Antigravity/Claude Code (tienen `reducto.exe` bloqueado) y reintentá.
+
+**"UnicodeEncodeError" en Windows** — Setear `$env:PYTHONUTF8 = "1"` antes de correr Reducto, o agregarlo permanente: `[System.Environment]::SetEnvironmentVariable("PYTHONUTF8", "1", "User")`
+
+**El MCP no conecta en Antigravity** — Verificá que `~/.gemini/antigravity/mcp_config.json` tenga la entrada de reducto. Corré `reducto install --target antigravity` para regenerarlo.
+
+## Licencia
+
+MIT

reducto_graph-0.2.0/pyproject.toml

@@ -0,0 +1,66 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "reducto_graph"
+version = "0.2.0"
+description = "Universal knowledge graph for LLMs — reduce tokens, not intelligence."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [
+    { name = "Reducto", email = "sudacadev@gmail.com" }
+]
+keywords = [
+    "llm", "knowledge-graph", "tokens", "mcp", "claude",
+    "context", "codebase", "neo4j", "ai"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "networkx>=3.0",
+    "mcp>=1.0.0",
+    "click>=8.1",
+    "rich>=13.0",
+]
+
+[project.urls]
+Homepage      = "https://github.com/SudacaDev/reducto"
+Documentation = "https://github.com/SudacaDev/reducto#readme"
+Repository    = "https://github.com/SudacaDev/reducto"
+"Bug Tracker" = "https://github.com/SudacaDev/reducto/issues"
+
+[project.scripts]
+reducto = "reducto.cli:cli"
+
+# Permite `uv tool install reducto` y `pipx install reducto`
+[project.optional-dependencies]
+ast = [
+    "tree-sitter>=0.23",
+    "tree-sitter-python>=0.23",
+    "tree-sitter-javascript>=0.23",
+    "tree-sitter-typescript>=0.23",
+]
+dev = [
+    "build>=1.0",
+    "twine>=5.0",
+    "pytest>=8.0",
+    "ruff>=0.4",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["reducto*"]
+
+[tool.setuptools.package-data]
+reducto = ["py.typed", "assets/*.js"]

reducto_graph-0.2.0/reducto/__init__.py

@@ -0,0 +1,6 @@
+"""
+Reducto — Universal knowledge graph for LLMs.
+Reduce tokens, not intelligence.
+"""
+
+__version__ = "0.1.0"