snapcontext 2.1.0__tar.gz → 2.2.0__tar.gz

{snapcontext-2.1.0/snapcontext.egg-info → snapcontext-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: snapcontext
-Version: 2.1.0
+Version: 2.2.0
 Summary: SnapContext: Asistente de IA con contexto automático para desarrollo
 Author-email: SnapContext Contributors <tu@email.com>
 License-Expression: MIT
@@ -104,12 +104,18 @@ snapcontext interactive  # o snapcontext --web
 Auto-detección de proyecto (Flutter, Node/React, Python, Go, Rust…) que ajusta
 carpetas, extensiones y comandos de test por defecto.
 
-## 🛠️ Editor Integrado Propio (v2.1.0)
+## 🛠️ Editor Integrado Propio (v2.2.0)
 
-SnapContext incluye su propio editor integrado con soporte de parches unificados:
+SnapContext incluye su propio editor integrado con soporte de parches unificados
+y edición basada en AST (Árbol Sintáctico) para refactorizaciones precisas:
 - **`--editor propio`**: Aplica cambios directamente y crea copias de seguridad automáticas en `~/.snapcontext/backups/`.
-- **`--modo-edicion {auto,parche,sobrescribir}`**:
-  - `auto` (por defecto): Genera un parche unificado (`git apply` / `patch`) y hace fallback a sobrescritura si no es aplicable.
+- **`--modo-edicion {auto,parche,sobrescribir,ast}`**:
+  - `auto` (por defecto): Genera un parche unificado (`git apply` / `patch`), pero
+    para refactorizaciones estructurales intenta primero la edición **AST** y cae a
+    sobrescritura si nada es aplicable.
+  - `ast`: Edita comprendiendo la estructura sintáctica del archivo (Python con
+    `ast`, otros lenguajes con `tree-sitter` si está instalado). Soporta renombrar
+    símbolos, insertar imports y recibir el código completo resultante.
   - `parche`: Fuerza la aplicación de parches unificados para ediciones precisas.
   - `sobrescribir`: Sobrescribe el archivo completo.
 - **`--editor aider`** (por defecto): Mantiene el flujo de edición con Aider para máxima compatibilidad.
@@ -120,6 +126,9 @@ snapcontext "añadir endpoint de métricas" --editor propio
 
 # Forzar modo parche
 snapcontext "corregir tipado en login" --editor propio --modo-edicion parche
+
+# Refactorización estructural con AST
+snapcontext "renombrar la variable 'usuario' a 'cuenta'" --editor propio --modo-edicion ast
 ```
 
 ## 🧭 Modos y alias

{snapcontext-2.1.0 → snapcontext-2.2.0}/README.md

@@ -59,12 +59,18 @@ snapcontext interactive  # o snapcontext --web
 Auto-detección de proyecto (Flutter, Node/React, Python, Go, Rust…) que ajusta
 carpetas, extensiones y comandos de test por defecto.
 
-## 🛠️ Editor Integrado Propio (v2.1.0)
+## 🛠️ Editor Integrado Propio (v2.2.0)
 
-SnapContext incluye su propio editor integrado con soporte de parches unificados:
+SnapContext incluye su propio editor integrado con soporte de parches unificados
+y edición basada en AST (Árbol Sintáctico) para refactorizaciones precisas:
 - **`--editor propio`**: Aplica cambios directamente y crea copias de seguridad automáticas en `~/.snapcontext/backups/`.
-- **`--modo-edicion {auto,parche,sobrescribir}`**:
-  - `auto` (por defecto): Genera un parche unificado (`git apply` / `patch`) y hace fallback a sobrescritura si no es aplicable.
+- **`--modo-edicion {auto,parche,sobrescribir,ast}`**:
+  - `auto` (por defecto): Genera un parche unificado (`git apply` / `patch`), pero
+    para refactorizaciones estructurales intenta primero la edición **AST** y cae a
+    sobrescritura si nada es aplicable.
+  - `ast`: Edita comprendiendo la estructura sintáctica del archivo (Python con
+    `ast`, otros lenguajes con `tree-sitter` si está instalado). Soporta renombrar
+    símbolos, insertar imports y recibir el código completo resultante.
   - `parche`: Fuerza la aplicación de parches unificados para ediciones precisas.
   - `sobrescribir`: Sobrescribe el archivo completo.
 - **`--editor aider`** (por defecto): Mantiene el flujo de edición con Aider para máxima compatibilidad.
@@ -75,6 +81,9 @@ snapcontext "añadir endpoint de métricas" --editor propio
 
 # Forzar modo parche
 snapcontext "corregir tipado en login" --editor propio --modo-edicion parche
+
+# Refactorización estructural con AST
+snapcontext "renombrar la variable 'usuario' a 'cuenta'" --editor propio --modo-edicion ast
 ```
 
 ## 🧭 Modos y alias

{snapcontext-2.1.0 → snapcontext-2.2.0}/agentes.py

@@ -21,6 +21,22 @@ logs de depuración visibles con ``--depurar`` (marcas ``[Agente…]``).
 import subprocess
 from typing import List, Optional, Union
 
+def _tarea_estructura(tarea: str) -> bool:
+    """Heurística simple para `auto`: ¿la tarea parece una refactorización estructural?
+
+    Si es así, merece la pena intentar primero la edición basada en AST.
+    Se normalizan acentos para tolerar variaciones ("renombra"/"renombrar", etc.).
+    """
+    if not tarea:
+        return False
+    import unicodedata as _u
+
+    t = _u.normalize("NFD", tarea.lower())
+    t = "".join(c for c in t if not _u.combining(c))
+    claves = ("refactor", "renombra", "renombrar", "extra", "extraer",
+              "mueve", "mover", "inserta", "insertar", "nueva funcion",
+              "crear funcion", "funcion", "extraccion")
+    return any(k in t for k in claves)
 
 class AgenteContexto:
     """Agente de Contexto: selecciona los archivos relevantes para la consulta.
@@ -175,6 +191,91 @@ class AgenteEditorPropio:
         sc.depurar(f"[AgenteEditorPropio] Aplicando parche en '{directorio}'")
         return sc._aplicar_parche(parche, directorio=directorio)
 
+    def _cadena_modos(self, archivo: str, mensaje: str,
+                      modo_edicion: str) -> List[str]:
+        """Devuelve la cadena de estrategias de edición a intentar para un archivo.
+
+        - 'sobrescribir' → solo sobrescritura.
+        - 'parche'       → solo parche unificado (sin fallback).
+        - 'ast'          → AST y, si falla, sobrescritura.
+        - 'auto'         → AST (si el lenguaje lo permite y la tarea es estructural),
+                           luego parche y, por último, sobrescritura.
+        """
+        import snapcontext as sc
+
+        if modo_edicion == "sobrescribir":
+            return ["sobrescribir"]
+        if modo_edicion == "parche":
+            return ["parche"]
+        if modo_edicion == "ast":
+            return ["ast", "sobrescribir"]
+        # auto: heurística simple según lenguaje y tarea
+        if sc._ast_disponible(archivo) and _tarea_estructura(mensaje):
+            return ["ast", "parche", "sobrescribir"]
+        return ["parche", "sobrescribir"]
+
+    def editar_ast(self, archivo: str, tarea: str,
+                   directorio: str = ".", modelo: Optional[str] = None) -> bool:
+        """Edita ``archivo`` con base en su AST usando el proveedor de IA."""
+        import snapcontext as sc
+
+        pref = sc.cargar_configuracion()
+        proveedor = pref.get("provider") or sc.PROVEEDOR_DEFECTO
+        sc.depurar(f"[AgenteEditorPropio] Editando por AST '{archivo}' en '{directorio}'")
+        return sc._editor_ast(archivo, tarea, directorio=directorio,
+                              proveedor=proveedor, modelo=modelo)
+
+    def _aplicar_modo_parche(self, archivo: str, mensaje: str,
+                             contenido_actual: str, modelo: Optional[str],
+                             directorio: str) -> bool:
+        """Intenta editar `archivo` pidiendo un parche unificado al proveedor."""
+        import snapcontext as sc
+
+        pref = sc.cargar_configuracion()
+        proveedor = pref.get("provider") or sc.PROVEEDOR_DEFECTO
+        prompt = (
+            f"Genera un parche unificado (unified diff) que modifique el archivo para cumplir con la tarea. "
+            f"El parche debe ser aplicable con 'patch -p1' o 'git apply' (encabezados --- a/{archivo} y +++ b/{archivo}).\n\n"
+            f"Tarea: {mensaje}\n"
+            f"Archivo: {archivo}\n\n"
+            f"Contenido actual:\n```\n{contenido_actual}\n```\n\n"
+            f"Devuelve ÚNICAMENTE el diff unificado, sin explicaciones ni rodeos."
+        )
+        respuesta = sc._enviar_al_proveedor(
+            proveedor, modelo, [{"role": "user", "content": prompt}])
+        diff_limpio = respuesta
+        if "--- " in diff_limpio and "+++ " in diff_limpio:
+            idx_inicio = diff_limpio.find("--- ")
+            diff_limpio = diff_limpio[idx_inicio:]
+            if "```" in diff_limpio:
+                diff_limpio = diff_limpio[:diff_limpio.find("```")]
+        if "--- " in diff_limpio and "+++ " in diff_limpio and "@@" in diff_limpio:
+            return self.aplicar_parche(diff_limpio, directorio)
+        return False
+
+    def _aplicar_modo_sobrescribir(self, archivo: str, mensaje: str,
+                                   contenido_actual: str, modelo: Optional[str],
+                                   directorio: str) -> bool:
+        """Sobrescribe `archivo` con el código completo que devuelve el proveedor."""
+        import snapcontext as sc
+
+        pref = sc.cargar_configuracion()
+        proveedor = pref.get("provider") or sc.PROVEEDOR_DEFECTO
+        prompt = (
+            f"Modifica el siguiente archivo para cumplir con la tarea.\n\n"
+            f"Tarea: {mensaje}\n"
+            f"Archivo: {archivo}\n\n"
+            f"Contenido actual:\n```\n{contenido_actual}\n```\n\n"
+            f"Devuelve ÚNICAMENTE el código completo resultante, sin explicaciones ni markdown."
+        )
+        nuevo_contenido = sc._enviar_al_proveedor(
+            proveedor, modelo, [{"role": "user", "content": prompt}])
+        if nuevo_contenido.startswith("```"):
+            lineas = nuevo_contenido.splitlines()
+            if len(lineas) >= 2 and lineas[-1].startswith("```"):
+                nuevo_contenido = "\n".join(lineas[1:-1])
+        return self.sobrescribir(archivo, nuevo_contenido, directorio)
+
     def ejecutar(
         self,
         archivos: List[str],
@@ -187,14 +288,13 @@ class AgenteEditorPropio:
 
         - modo_edicion == 'parche': intenta aplicar parche unificado (falla si no puede).
         - modo_edicion == 'sobrescribir': aplica directamente sobrescritura de archivo.
-        - modo_edicion == 'auto': intenta primero parche unificado; si falla o no es diff,
-          hace fallback a sobrescritura.
+        - modo_edicion == 'ast': edita con base en el AST y cae a sobrescritura si falla.
+        - modo_edicion == 'auto': decide por heurística (AST para refactorizaciones,
+          parche, y fallback a sobrescritura).
         """
         import snapcontext as sc
         from pathlib import Path
 
-        pref = sc.cargar_configuracion()
-        proveedor = pref.get("provider") or sc.PROVEEDOR_DEFECTO
         raiz = Path(directorio).resolve()
         todo_ok = True
 
@@ -203,75 +303,77 @@ class AgenteEditorPropio:
             contenido_actual = ""
             if camino.is_file():
                 try:
-                    contenido_actual = camino.read_text(encoding="utf-8", errors="replace")
+                    contenido_actual = camino.read_text(encoding="utf-8",
+                                                        errors="replace")
                 except Exception:
                     pass
 
-            if modo_edicion in ("parche", "auto"):
-                prompt = (
-                    f"Genera un parche unificado (unified diff) que modifique el archivo para cumplir con la tarea. "
-                    f"El parche debe ser aplicable con 'patch -p1' o 'git apply' (encabezados --- a/{arch} y +++ b/{arch}).\n\n"
-                    f"Tarea: {mensaje}\n"
-                    f"Archivo: {arch}\n\n"
-                    f"Contenido actual:\n```\n{contenido_actual}\n```\n\n"
-                    f"Devuelve ÚNICAMENTE el diff unificado, sin explicaciones ni rodeos."
-                )
+            cadena = self._cadena_modos(arch, mensaje, modo_edicion)
+            conseguido = False
+            for estrategia in cadena:
                 try:
-                    respuesta = sc._enviar_al_proveedor(
-                        proveedor, modelo,
-                        [{"role": "user", "content": prompt}]
-                    )
-                    # Limpiar delimitadores markdown si vinieron
-                    diff_limpio = respuesta
-                    if "--- " in diff_limpio and "+++ " in diff_limpio:
-                        # Extraer solo desde ---
-                        idx_inicio = diff_limpio.find("--- ")
-                        diff_limpio = diff_limpio[idx_inicio:]
-                        if "```" in diff_limpio:
-                            diff_limpio = diff_limpio[:diff_limpio.find("```")]
-
-                    # Si parece un diff unificado válido, intentar aplicarlo
-                    if ("--- " in diff_limpio and "+++ " in diff_limpio and "@@" in diff_limpio):
-                        if self.aplicar_parche(diff_limpio, str(raiz)):
-                            continue
-                        sc.aviso(f"[AgenteEditorPropio] Parche para '{arch}' falló al aplicarse.")
-                        if modo_edicion == "parche":
-                            todo_ok = False
-                            continue
+                    if estrategia == "ast":
+                        conseguido = self.editar_ast(arch, mensaje,
+                                                     str(raiz), modelo)
+                    elif estrategia == "parche":
+                        conseguido = self._aplicar_modo_parche(
+                            arch, mensaje, contenido_actual, modelo, str(raiz))
+                    elif estrategia == "sobrescribir":
+                        conseguido = self._aplicar_modo_sobrescribir(
+                            arch, mensaje, contenido_actual, modelo, str(raiz))
+                    else:
+                        conseguido = False
                 except Exception as exc:
-                    sc.depurar(f"[AgenteEditorPropio] Error pidiendo parche para '{arch}': {exc}")
-                    if modo_edicion == "parche":
-                        sc.error(f"Error generando parche para {arch}: {exc}")
-                        todo_ok = False
-                        continue
-
-            # Fallback o modo sobrescribir
-            sc.depurar(f"[AgenteEditorPropio] Aplicando edición por sobrescritura para '{arch}'...")
-            prompt_sobrescribir = (
-                f"Modifica el siguiente archivo para cumplir con la tarea.\n\n"
-                f"Tarea: {mensaje}\n"
-                f"Archivo: {arch}\n\n"
-                f"Contenido actual:\n```\n{contenido_actual}\n```\n\n"
-                f"Devuelve ÚNICAMENTE el código completo resultante, sin explicaciones ni markdown."
-            )
-            try:
-                nuevo_contenido = sc._enviar_al_proveedor(
-                    proveedor, modelo,
-                    [{"role": "user", "content": prompt_sobrescribir}]
-                )
-                if nuevo_contenido.startswith("```"):
-                    lineas = nuevo_contenido.splitlines()
-                    if len(lineas) >= 2 and lineas[-1].startswith("```"):
-                        nuevo_contenido = "\n".join(lineas[1:-1])
-                if not self.sobrescribir(arch, nuevo_contenido, str(raiz)):
-                    todo_ok = False
-            except Exception as exc:
-                sc.error(f"Error generando cambios por sobrescritura para {arch}: {exc}")
+                    sc.depurar(
+                        f"[AgenteEditorPropio] {estrategia} falló para '{arch}': {exc}")
+                    conseguido = False
+                if conseguido:
+                    break
+            if not conseguido:
+                sc.error(f"[AgenteEditorPropio] No se pudo editar '{arch}'.")
                 todo_ok = False
 
         return todo_ok
 
 
+class AgenteEditorAST:
+    """Agente Editor AST (Fase 3): ediciones precisas basadas en árbol sintáctico.
+
+    Trabaja directamente con el AST del archivo (Python con ``ast``; otros
+    lenguajes con ``tree-sitter`` si está instalado) pidiendo al proveedor
+    operaciones de modificación del árbol o el código completo resultante.
+    """
+
+    def editar(
+        self,
+        archivos: List[str],
+        mensaje: str,
+        directorio: str = ".",
+        modelo: Optional[str] = None,
+    ) -> bool:
+        """Aplica a cada archivo una edición guiada por AST. Devuelve bool."""
+        todo = True
+        for archivo in archivos:
+            if not self.editar_archivo(archivo, mensaje,
+                                       directorio=directorio, modelo=modelo):
+                todo = False
+        return todo
+
+    def editar_archivo(
+        self,
+        archivo: str,
+        tarea: str,
+        directorio: str = ".",
+        modelo: Optional[str] = None,
+    ) -> bool:
+        """Edita un único archivo con AST. Devuelve ``True`` si tuvo éxito."""
+        import snapcontext as sc
+
+        pref = sc.cargar_configuracion()
+        proveedor = pref.get("provider") or sc.PROVEEDOR_DEFECTO
+        sc.depurar(f"[AgenteEditorAST] AST sobre '{archivo}' en '{directorio}'")
+        return sc._editor_ast(archivo, tarea, directorio=directorio,
+                              proveedor=proveedor, modelo=modelo)
 
 
 class AgenteTester:

{snapcontext-2.1.0 → snapcontext-2.2.0}/orquestador.py

@@ -20,7 +20,8 @@ import shlex
 import sys
 from typing import List, Optional, Tuple
 
-from agentes import AgenteContexto, AgenteEditor, AgenteEditorPropio, AgenteTester
+from agentes import (AgenteContexto, AgenteEditor, AgenteEditorAST,
+                     AgenteEditorPropio, AgenteTester)
 
 # Centinela diferenciado del None de "aborto": _planificar lo devuelve cuando
 # el pipeline termina de forma exitosa y temprana (p. ej. --vista-previa).
@@ -40,6 +41,7 @@ class Orquestador:
         self.agente_contexto = AgenteContexto()
         self.agente_editor = AgenteEditor()
         self.agente_editor_propio = AgenteEditorPropio()
+        self.agente_editor_ast = AgenteEditorAST()
         self.agente_tester = AgenteTester()
         self.evento_callback = evento_callback
 

{snapcontext-2.1.0 → snapcontext-2.2.0}/pyproject.toml

@@ -1,90 +1,90 @@
-[build-system]
-requires = ["setuptools>=77"]
-build-backend = "setuptools.build_meta"
-
-[project]
-# Nombre verificado disponible en PyPI (18/08/2026): pypi.org/pypi/snapcontext → 404.
-# Alternativas si algún día estuviera ocupado: "snapcontext-cli" o "snapcontext-tool".
-name = "snapcontext"
-version = "2.1.0"
-description = "SnapContext: Asistente de IA con contexto automático para desarrollo"
-readme = "README.md"
-requires-python = ">=3.9"
-# PEP 639: licencia SPDX + fichero de licencia incluido en el paquete.
-license = "MIT"
-license-files = ["LICENSE"]
-authors = [
-    # TODO: cambia por tu nombre y correo reales antes de publicar.
-    { name = "SnapContext Contributors", email = "tu@email.com" },
-]
-keywords = [
-    "ai", "aider", "gemini", "ollama", "deepseek", "groq", "claude", "anthropic",
-    "flutter", "supabase", "cli",
-]
-classifiers = [
-    "Development Status :: 5 - Production/Stable",
-    "Environment :: Console",
-    "Intended Audience :: Developers",
-    "Operating System :: OS Independent",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Topic :: Software Development :: Code Generators",
-]
-dependencies = [
-    "google-generativeai>=0.8.3",
-    "openai>=1.30.0",
-]
-
-[project.optional-dependencies]
-dev = [
-    "aider-chat>=0.67.0",
-    "build>=1.2.0",
-    "twine>=5.0.0",
-]
-# Menú interactivo de selección de proveedor (--provider y --local omitidos).
-interactive = [
-    "questionary>=1.10.0",
-]
-# Claude (Anthropic) como proveedor de IA (--provider anthropic, --chat).
-anthropic = [
-    "anthropic>=0.30.0",
-]
-# Interfaz web (FastAPI + WebSockets) con --web.
-web = [
-    "fastapi>=0.110.0",
-    "uvicorn[standard]>=0.29.0",
-]
-# Búsqueda semántica local con embeddings (--search, pre-filtro del planificador).
-embeddings = [
-    "sentence-transformers>=3.0.0",
-    "torch>=2.0.0",
-]
-# MCP avanzado (v1.4.0): análisis sintáctico multi-lenguaje con tree-sitter
-# (herramienta `ast_avanzado`). Sin él, cae a `ast` de la stdlib (solo Python).
-mcp_avanzado = [
-    "tree-sitter>=0.20.0",
-    "tree-sitter-languages>=1.10.0",
-]
-
-[project.urls]
-# TODO: apunta a tu repositorio real (no bloquea la publicación si lo dejas).
-Homepage = "https://github.com/NicolasBruna24/snapcontext"
-Repository = "https://github.com/NicolasBruna24/snapcontext"
-"Bug Tracker" = "https://github.com/NicolasBruna24/snapcontext/issues"
-
-# Entry point: expone el comando `snapcontext` que llama a main().
-[project.scripts]
-snapcontext = "snapcontext:main"
-
-[tool.setuptools]
-# Módulos en la raíz (sin paquete): CLI + arquitectura de agentes.
-py-modules = ["snapcontext", "agentes", "orquestador"]
-packages = ["web"]
-
-[tool.setuptools.package-data]
-# El estático de la interfaz web debe viajar dentro del paquete instalado.
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+# Nombre verificado disponible en PyPI (18/08/2026): pypi.org/pypi/snapcontext → 404.
+# Alternativas si algún día estuviera ocupado: "snapcontext-cli" o "snapcontext-tool".
+name = "snapcontext"
+version = "2.2.0"
+description = "SnapContext: Asistente de IA con contexto automático para desarrollo"
+readme = "README.md"
+requires-python = ">=3.9"
+# PEP 639: licencia SPDX + fichero de licencia incluido en el paquete.
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    # TODO: cambia por tu nombre y correo reales antes de publicar.
+    { name = "SnapContext Contributors", email = "tu@email.com" },
+]
+keywords = [
+    "ai", "aider", "gemini", "ollama", "deepseek", "groq", "claude", "anthropic",
+    "flutter", "supabase", "cli",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Code Generators",
+]
+dependencies = [
+    "google-generativeai>=0.8.3",
+    "openai>=1.30.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "aider-chat>=0.67.0",
+    "build>=1.2.0",
+    "twine>=5.0.0",
+]
+# Menú interactivo de selección de proveedor (--provider y --local omitidos).
+interactive = [
+    "questionary>=1.10.0",
+]
+# Claude (Anthropic) como proveedor de IA (--provider anthropic, --chat).
+anthropic = [
+    "anthropic>=0.30.0",
+]
+# Interfaz web (FastAPI + WebSockets) con --web.
+web = [
+    "fastapi>=0.110.0",
+    "uvicorn[standard]>=0.29.0",
+]
+# Búsqueda semántica local con embeddings (--search, pre-filtro del planificador).
+embeddings = [
+    "sentence-transformers>=3.0.0",
+    "torch>=2.0.0",
+]
+# MCP avanzado (v1.4.0): análisis sintáctico multi-lenguaje con tree-sitter
+# (herramienta `ast_avanzado`). Sin él, cae a `ast` de la stdlib (solo Python).
+mcp_avanzado = [
+    "tree-sitter>=0.20.0",
+    "tree-sitter-languages>=1.10.0",
+]
+
+[project.urls]
+# TODO: apunta a tu repositorio real (no bloquea la publicación si lo dejas).
+Homepage = "https://github.com/NicolasBruna24/snapcontext"
+Repository = "https://github.com/NicolasBruna24/snapcontext"
+"Bug Tracker" = "https://github.com/NicolasBruna24/snapcontext/issues"
+
+# Entry point: expone el comando `snapcontext` que llama a main().
+[project.scripts]
+snapcontext = "snapcontext:main"
+
+[tool.setuptools]
+# Módulos en la raíz (sin paquete): CLI + arquitectura de agentes.
+py-modules = ["snapcontext", "agentes", "orquestador"]
+packages = ["web"]
+
+[tool.setuptools.package-data]
+# El estático de la interfaz web debe viajar dentro del paquete instalado.
 "web" = ["static/index.html"]

{snapcontext-2.1.0 → snapcontext-2.2.0/snapcontext.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: snapcontext
-Version: 2.1.0
+Version: 2.2.0
 Summary: SnapContext: Asistente de IA con contexto automático para desarrollo
 Author-email: SnapContext Contributors <tu@email.com>
 License-Expression: MIT
@@ -104,12 +104,18 @@ snapcontext interactive  # o snapcontext --web
 Auto-detección de proyecto (Flutter, Node/React, Python, Go, Rust…) que ajusta
 carpetas, extensiones y comandos de test por defecto.
 
-## 🛠️ Editor Integrado Propio (v2.1.0)
+## 🛠️ Editor Integrado Propio (v2.2.0)
 
-SnapContext incluye su propio editor integrado con soporte de parches unificados:
+SnapContext incluye su propio editor integrado con soporte de parches unificados
+y edición basada en AST (Árbol Sintáctico) para refactorizaciones precisas:
 - **`--editor propio`**: Aplica cambios directamente y crea copias de seguridad automáticas en `~/.snapcontext/backups/`.
-- **`--modo-edicion {auto,parche,sobrescribir}`**:
-  - `auto` (por defecto): Genera un parche unificado (`git apply` / `patch`) y hace fallback a sobrescritura si no es aplicable.
+- **`--modo-edicion {auto,parche,sobrescribir,ast}`**:
+  - `auto` (por defecto): Genera un parche unificado (`git apply` / `patch`), pero
+    para refactorizaciones estructurales intenta primero la edición **AST** y cae a
+    sobrescritura si nada es aplicable.
+  - `ast`: Edita comprendiendo la estructura sintáctica del archivo (Python con
+    `ast`, otros lenguajes con `tree-sitter` si está instalado). Soporta renombrar
+    símbolos, insertar imports y recibir el código completo resultante.
   - `parche`: Fuerza la aplicación de parches unificados para ediciones precisas.
   - `sobrescribir`: Sobrescribe el archivo completo.
 - **`--editor aider`** (por defecto): Mantiene el flujo de edición con Aider para máxima compatibilidad.
@@ -120,6 +126,9 @@ snapcontext "añadir endpoint de métricas" --editor propio
 
 # Forzar modo parche
 snapcontext "corregir tipado en login" --editor propio --modo-edicion parche
+
+# Refactorización estructural con AST
+snapcontext "renombrar la variable 'usuario' a 'cuenta'" --editor propio --modo-edicion ast
 ```
 
 ## 🧭 Modos y alias

{snapcontext-2.1.0 → snapcontext-2.2.0}/snapcontext.egg-info/SOURCES.txt

@@ -15,6 +15,7 @@ tests/test_agentes.py
 tests/test_auto_017.py
 tests/test_deteccion.py
 tests/test_diff_editor_210.py
+tests/test_editor_ast_220.py
 tests/test_editor_propio_200.py
 tests/test_embeddings_110.py
 tests/test_exe_150.py