snapcontext 3.3.0__tar.gz → 3.5.0__tar.gz

{snapcontext-3.3.0/snapcontext.egg-info → snapcontext-3.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: snapcontext
-Version: 3.3.0
+Version: 3.5.0
 Summary: SnapContext: Asistente de IA con contexto automático para desarrollo
 Author-email: SnapContext Contributors <tu@email.com>
 License-Expression: MIT
@@ -45,7 +45,7 @@ Dynamic: license-file
 
 # SnapContext
 
-![v2.1.0](https://img.shields.io/badge/version-2.1.0-blue.svg)
+![v3.5.0](https://img.shields.io/badge/version-3.5.0-blue.svg)
 [![PyPI](https://badge.fury.io/py/snapcontext.svg)](https://pypi.org/project/snapcontext/)
 [![CI](https://img.shields.io/github/actions/workflow/status/NicolasBruna24/snapcontext/ci.yml?branch=main&label=tests)](https://github.com/NicolasBruña24/snapcontext/actions)
 ![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue.svg)
@@ -199,8 +199,81 @@ 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
+
+# Validación de sintaxis desactivada (comportamiento previo a v3.4.0)
+snapcontext "corregir tipado" --editor propio --no-validar-sintaxis
+```
+
+### Validación de sintaxis antes de guardar (v3.4.0)
+
+Cuando uses `--editor propio`, SnapContext **valida la sintaxis** del código que
+ha generado la IA **antes de escribirlo en disco**. Si la validación falla, el
+cambio se rechaza y se le envía el error al proveedor para que lo corrija,
+repitiéndose hasta `--max-intentos-validacion` intentos (por defecto 3). Si tras
+esos intentos el código sigue roto, se **cancela la edición** y el archivo queda
+intacto.
+
+- Se detecta el lenguaje del archivo y se usa el validador adecuado:
+  Python (`py_compile`), JavaScript/TypeScript (`node --check`), Dart
+  (`dart analyze` → `dart format`), Go (`go build -n` → `gofmt -e`), Rust
+  (`rustc --parse-only`), Java (`javac -Xlint:none`), C/C++ (`gcc`/`clang
+  -fsyntax-only`). Si no hay validador o comando disponible, se omite la
+  validación (solo aviso en logs con `--depurar`).
+- La validación se hace sobre un **archivo temporal**, nunca toca el original.
+- Flag `--validar` (por defecto activado) / `--no-validar-sintaxis` para
+  desactivarla. Nota: el nombre usa `--no-validar-sintaxis` porque
+  `--no-validar` ya es alias de `--iniciar-proyecto`.
+
+```bash
+# Desactivar la validación por completo (comportamiento anterior)
+snapcontext "..." --editor propio --no-validar-sintaxis
+
+# Ajustar el número de reintentos
+snapcontext "..." --editor propio --max-intentos-validacion 5
 ```
 
+### 🧠 Asesor de código proactivo (v3.5.0)
+
+SnapContext no solo ejecuta órdenes: también **analiza tu código por su cuenta**
+y te sugiere mejoras (refactorizaciones, deuda técnica, optimizaciones).
+
+```bash
+# Análisis informativo (nunca modifica código)
+snapcontext --asesor
+snapcontext --sugerir          # alias
+
+# Aplicar automáticamente las mejoras seguras (renombrar símbolos);
+# cada cambio se valida antes de guardarse y se descarta si rompe la sintaxis
+snapcontext --asesor-auto
+
+# Ajustar la sensibilidad del detector de funciones largas (defecto: 20)
+snapcontext --asesor --asesor-umbral 30
+```
+
+**Qué detecta:**
+
+- 🔴 **Prioridad alta**: `except:` desnudos (capturan todo sin querer).
+- 🟡 **Prioridad media**: funciones largas (> 20 líneas), clases con demasiadas
+  responsabilidades (> 10 métodos), bloques de código duplicados entre archivos,
+  comparaciones `== None` y patrones obsoletos (`.has_key()`, Python 2).
+- 🔵 **Prioridad baja**: nombres poco descriptivos (`d`, `tmp`...) con una
+  sugerencia concreta de renombrado.
+
+Cada sugerencia incluye descripción, ubicación `archivo:línea`, solución
+propuesta y prioridad. Los umbrales se personalizan en
+`~/.snapcontext/config.json`:
+
+```json
+{ "asesor": { "funcion_larga": 30, "clase_metodos": 15, "duplicado_lineas": 8 } }
+```
+
+El asesor también está disponible:
+
+- **En el chat**: comando `/asesor` (o `/sugerir`) dentro de `--chat`.
+- **En el planificador**: paso `{"accion": "asesor", "descripcion": "..."}` —
+  cada sugerencia se presenta para aceptarla o rechazarla individualmente.
+- **En la web**: acción *Asesor* que muestra las sugerencias en un panel.
+
 ## 🧭 Modos y alias
 
 | Modo | Comando |
@@ -475,7 +548,7 @@ snapcontext --plan "..."                                             # commits '
   (requiere `ANTHROPIC_API_KEY` y `pip install snapcontext[anthropic]`). Modelo por
   defecto: `claude-3-5-sonnet-20241022`.
 - **Modo chat interactivo**: `snapcontext --chat` abre un REPL con los comandos
-  `/salir`, `/archivos`, `/limpiar`, `/seleccion <consulta>`,
+  `/salir`, `/archivos`, `/limpiar`, `/seleccion <consulta>`, `/asesor`,
   `/provider <proveedor>`, `/historial` y `/ayuda`. Cualquier otro texto se envía
   al proveedor actual manteniendo la conversación.
 - **Memoria persistente**: cada tarea se guarda en `~/.snapcontext/historial.json`
@@ -1013,6 +1086,15 @@ locales y te deja elegir con las flechas:
 | `--url-defecto` | `http://localhost:5000` | URL para abrir el navegador si Flutter no reporta una |
 | `--comando-test` | `"flutter test"` | Comando del bucle de pruebas |
 | `--max-iteraciones` | `3` | Iteraciones máximas del bucle |
+| `--validar` | on | Valida la sintaxis del código antes de guardar en el editor propio |
+| `--no-validar-sintaxis` | off | Desactiva la validación de sintaxis del editor propio |
+| `--max-intentos-validacion` | `3` | Intentos de validación de sintaxis antes de cancelar la edición |
+| `--asesor` (`--sugerir`) | off | Asesor proactivo: analiza y sugiere mejoras sin modificar código |
+| `--asesor-auto` | off | Aplica automáticamente las mejoras seguras del asesor |
+| `--asesor-umbral` | `20` | Líneas máximas por función para el asesor |
+
+> **Nota:** el flag negativo de validación de sintaxis se llama `--no-validar-sintaxis`
+> porque `--no-validar` ya existe como alias de `--iniciar-proyecto`.
 
 ---
 

{snapcontext-3.3.0 → snapcontext-3.5.0}/README.md

@@ -1,6 +1,6 @@
 # SnapContext
 
-![v2.1.0](https://img.shields.io/badge/version-2.1.0-blue.svg)
+![v3.5.0](https://img.shields.io/badge/version-3.5.0-blue.svg)
 [![PyPI](https://badge.fury.io/py/snapcontext.svg)](https://pypi.org/project/snapcontext/)
 [![CI](https://img.shields.io/github/actions/workflow/status/NicolasBruna24/snapcontext/ci.yml?branch=main&label=tests)](https://github.com/NicolasBruña24/snapcontext/actions)
 ![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue.svg)
@@ -154,8 +154,81 @@ 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
+
+# Validación de sintaxis desactivada (comportamiento previo a v3.4.0)
+snapcontext "corregir tipado" --editor propio --no-validar-sintaxis
+```
+
+### Validación de sintaxis antes de guardar (v3.4.0)
+
+Cuando uses `--editor propio`, SnapContext **valida la sintaxis** del código que
+ha generado la IA **antes de escribirlo en disco**. Si la validación falla, el
+cambio se rechaza y se le envía el error al proveedor para que lo corrija,
+repitiéndose hasta `--max-intentos-validacion` intentos (por defecto 3). Si tras
+esos intentos el código sigue roto, se **cancela la edición** y el archivo queda
+intacto.
+
+- Se detecta el lenguaje del archivo y se usa el validador adecuado:
+  Python (`py_compile`), JavaScript/TypeScript (`node --check`), Dart
+  (`dart analyze` → `dart format`), Go (`go build -n` → `gofmt -e`), Rust
+  (`rustc --parse-only`), Java (`javac -Xlint:none`), C/C++ (`gcc`/`clang
+  -fsyntax-only`). Si no hay validador o comando disponible, se omite la
+  validación (solo aviso en logs con `--depurar`).
+- La validación se hace sobre un **archivo temporal**, nunca toca el original.
+- Flag `--validar` (por defecto activado) / `--no-validar-sintaxis` para
+  desactivarla. Nota: el nombre usa `--no-validar-sintaxis` porque
+  `--no-validar` ya es alias de `--iniciar-proyecto`.
+
+```bash
+# Desactivar la validación por completo (comportamiento anterior)
+snapcontext "..." --editor propio --no-validar-sintaxis
+
+# Ajustar el número de reintentos
+snapcontext "..." --editor propio --max-intentos-validacion 5
 ```
 
+### 🧠 Asesor de código proactivo (v3.5.0)
+
+SnapContext no solo ejecuta órdenes: también **analiza tu código por su cuenta**
+y te sugiere mejoras (refactorizaciones, deuda técnica, optimizaciones).
+
+```bash
+# Análisis informativo (nunca modifica código)
+snapcontext --asesor
+snapcontext --sugerir          # alias
+
+# Aplicar automáticamente las mejoras seguras (renombrar símbolos);
+# cada cambio se valida antes de guardarse y se descarta si rompe la sintaxis
+snapcontext --asesor-auto
+
+# Ajustar la sensibilidad del detector de funciones largas (defecto: 20)
+snapcontext --asesor --asesor-umbral 30
+```
+
+**Qué detecta:**
+
+- 🔴 **Prioridad alta**: `except:` desnudos (capturan todo sin querer).
+- 🟡 **Prioridad media**: funciones largas (> 20 líneas), clases con demasiadas
+  responsabilidades (> 10 métodos), bloques de código duplicados entre archivos,
+  comparaciones `== None` y patrones obsoletos (`.has_key()`, Python 2).
+- 🔵 **Prioridad baja**: nombres poco descriptivos (`d`, `tmp`...) con una
+  sugerencia concreta de renombrado.
+
+Cada sugerencia incluye descripción, ubicación `archivo:línea`, solución
+propuesta y prioridad. Los umbrales se personalizan en
+`~/.snapcontext/config.json`:
+
+```json
+{ "asesor": { "funcion_larga": 30, "clase_metodos": 15, "duplicado_lineas": 8 } }
+```
+
+El asesor también está disponible:
+
+- **En el chat**: comando `/asesor` (o `/sugerir`) dentro de `--chat`.
+- **En el planificador**: paso `{"accion": "asesor", "descripcion": "..."}` —
+  cada sugerencia se presenta para aceptarla o rechazarla individualmente.
+- **En la web**: acción *Asesor* que muestra las sugerencias en un panel.
+
 ## 🧭 Modos y alias
 
 | Modo | Comando |
@@ -430,7 +503,7 @@ snapcontext --plan "..."                                             # commits '
   (requiere `ANTHROPIC_API_KEY` y `pip install snapcontext[anthropic]`). Modelo por
   defecto: `claude-3-5-sonnet-20241022`.
 - **Modo chat interactivo**: `snapcontext --chat` abre un REPL con los comandos
-  `/salir`, `/archivos`, `/limpiar`, `/seleccion <consulta>`,
+  `/salir`, `/archivos`, `/limpiar`, `/seleccion <consulta>`, `/asesor`,
   `/provider <proveedor>`, `/historial` y `/ayuda`. Cualquier otro texto se envía
   al proveedor actual manteniendo la conversación.
 - **Memoria persistente**: cada tarea se guarda en `~/.snapcontext/historial.json`
@@ -968,6 +1041,15 @@ locales y te deja elegir con las flechas:
 | `--url-defecto` | `http://localhost:5000` | URL para abrir el navegador si Flutter no reporta una |
 | `--comando-test` | `"flutter test"` | Comando del bucle de pruebas |
 | `--max-iteraciones` | `3` | Iteraciones máximas del bucle |
+| `--validar` | on | Valida la sintaxis del código antes de guardar en el editor propio |
+| `--no-validar-sintaxis` | off | Desactiva la validación de sintaxis del editor propio |
+| `--max-intentos-validacion` | `3` | Intentos de validación de sintaxis antes de cancelar la edición |
+| `--asesor` (`--sugerir`) | off | Asesor proactivo: analiza y sugiere mejoras sin modificar código |
+| `--asesor-auto` | off | Aplica automáticamente las mejoras seguras del asesor |
+| `--asesor-umbral` | `20` | Líneas máximas por función para el asesor |
+
+> **Nota:** el flag negativo de validación de sintaxis se llama `--no-validar-sintaxis`
+> porque `--no-validar` ya existe como alias de `--iniciar-proyecto`.
 
 ---
 

{snapcontext-3.3.0 → snapcontext-3.5.0}/agentes.py

@@ -232,9 +232,55 @@ class AgenteEditorPropio:
         return sc._editor_ast(archivo, tarea, directorio=directorio,
                               proveedor=proveedor, modelo=modelo)
 
+    @staticmethod
+    def _aplicar_parche_preview(parche: str, contenido_actual: str):
+        """Aplica ``parche`` a ``contenido_actual`` **en memoria** para poder
+        validar la sintaxis del resultado sin tocar el archivo real.
+
+        Reutiliza la segmentación de hunks de ``_parsear_hunks`` y aplica cada
+        hunk con tolerancia a pequeños desfases. Devuelve ``(resultado, n)``
+        donde ``n`` es el número de hunks aplicados (0 ⇒ no se pudo reproducir).
+        """
+        import snapcontext as sc
+
+        resultado = (contenido_actual or "").splitlines()
+        desplazamiento = 0
+        aplicados = 0
+        for inicio_orig, cambios in sc._parsear_hunks(parche):
+            base = max(inicio_orig - 1 + desplazamiento, 0)
+            n_borrados = sum(1 for marca, _ in cambios if marca != "+")
+            nuevos = [texto for marca, texto in cambios if marca != "-"]
+
+            posicion = -1
+            for delta in (0, 1, -1, 2, -2, 3, -3, 5, -5, 10, -10):
+                candidato = base + delta
+                if candidato < 0 or candidato > len(resultado):
+                    continue
+                idx = candidato
+                encaja = True
+                for marca, texto in cambios:
+                    if marca == "+":
+                        continue
+                    if idx >= len(resultado) or resultado[idx] != texto:
+                        encaja = False
+                        break
+                    idx += 1
+                if encaja:
+                    posicion = candidato
+                    break
+            if posicion < 0:
+                continue
+
+            resultado[posicion:posicion + n_borrados] = nuevos
+            desplazamiento += len(nuevos) - n_borrados
+            aplicados += 1
+
+        return "\n".join(resultado) + "\n", aplicados
+
     def _aplicar_modo_parche(self, archivo: str, mensaje: str,
                              contenido_actual: str, modelo: Optional[str],
-                             directorio: str) -> bool:
+                             directorio: str, validar: bool = True,
+                             max_intentos_validacion: int = 3) -> bool:
         """Intenta editar `archivo` pidiendo un parche unificado al proveedor."""
         import snapcontext as sc
 
@@ -243,57 +289,134 @@ class AgenteEditorPropio:
         lenguaje = sc._lenguaje_archivo(archivo, contenido_actual) or "?"
         num_lineas = (contenido_actual.count("\n") + 1
                       if contenido_actual else 0)
-        prompt = (
-            f"Genera un parche unificado (unified diff) que modifique el archivo "
-            f"para cumplir con la tarea con precisión máxima.\n"
-            f"El parche debe ser aplicable con 'patch -p1' o 'git apply' "
-            f"(encabezados --- a/{archivo} y +++ b/{archivo}).\n\n"
-            f"Tarea: {mensaje}\n"
-            f"Archivo: {archivo}  (lenguaje: {lenguaje}, {num_lineas} líneas)\n\n"
-            f"Instrucciones:\n"
-            f"- Incluye suficiente contexto (3 líneas) para anclar cada hunk.\n"
-            f"- Conserva el estilo existente (indentación, comillas).\n"
-            f"- Modifica SOLO lo necesario; no reorganices el resto del archivo.\n\n"
-            f"Contenido actual completo:\n```{lenguaje}\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:
-            # v3.3.0: validación previa + resolución de conflictos.
-            return self.aplicar_parche(diff_limpio, directorio,
-                                       contenido_esperado=contenido_actual)
+        max_val = max(1, int(max_intentos_validacion))
+
+        error_msj = ""
+        for intento in range(1, max_val + 1):
+            prompt = (
+                f"Genera un parche unificado (unified diff) que modifique el archivo "
+                f"para cumplir con la tarea con precisión máxima.\n"
+                f"El parche debe ser aplicable con 'patch -p1' o 'git apply' "
+                f"(encabezados --- a/{archivo} y +++ b/{archivo}).\n\n"
+                f"Tarea: {mensaje}\n"
+                f"Archivo: {archivo}  (lenguaje: {lenguaje}, {num_lineas} líneas)\n\n"
+                f"Instrucciones:\n"
+                f"- Incluye suficiente contexto (3 líneas) para anclar cada hunk.\n"
+                f"- Conserva el estilo existente (indentación, comillas).\n"
+                f"- Modifica SOLO lo necesario; no reorganices el resto del archivo.\n"
+            )
+            if error_msj:
+                prompt += (
+                    f"\nTu intento anterior produjo un error de sintaxis que debes "
+                    f"corregir:\n{error_msj}\n\n"
+                    f"Mantén el objetivo de la tarea pero arregla ese error.\n"
+                )
+            prompt += (
+                f"\nContenido actual completo:\n```{lenguaje}\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 not ("--- " in diff_limpio and "+++ " in diff_limpio
+                    and "@@" in diff_limpio):
+                return False
+
+            if not validar:
+                # v3.3.0: validación previa + resolución de conflictos.
+                return self.aplicar_parche(diff_limpio, directorio,
+                                           contenido_esperado=contenido_actual)
+
+            # v3.4.0: validar la sintaxis del contenido resultante.
+            preview, aplicados = self._aplicar_parche_preview(
+                diff_limpio, contenido_actual)
+            if aplicados == 0:
+                # No se pudo reproducir en memoria → se omite la validación.
+                return self.aplicar_parche(diff_limpio, directorio,
+                                           contenido_esperado=contenido_actual)
+
+            sc.info(f"Validando sintaxis de {archivo}...")
+            exito, err = sc._validar_sintaxis(archivo, preview, directorio)
+            if exito:
+                sc.exito("Sintaxis válida.")
+                return self.aplicar_parche(diff_limpio, directorio,
+                                           contenido_esperado=contenido_actual)
+
+            error_msj = err
+            if intento < max_val:
+                sc.error(
+                    f"Error de sintaxis: {err}. "
+                    f"Reintentando ({intento}/{max_val})...")
+            else:
+                sc.error(
+                    f"No se pudo validar tras {max_val} intentos. "
+                    f"Edición cancelada.")
+                return False
         return False
 
     def _aplicar_modo_sobrescribir(self, archivo: str, mensaje: str,
                                    contenido_actual: str, modelo: Optional[str],
-                                   directorio: str) -> bool:
+                                   directorio: str, validar: bool = True,
+                                   max_intentos_validacion: int = 3) -> 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
         lenguaje = sc._lenguaje_archivo(archivo, contenido_actual) or "?"
-        prompt = (
-            f"Modifica el siguiente archivo ({lenguaje}) para cumplir con la "
-            f"tarea, conservando el estilo existente y cambiando solo lo necesario.\n\n"
-            f"Tarea: {mensaje}\n"
-            f"Archivo: {archivo}  (lenguaje: {lenguaje})\n\n"
-            f"Contenido actual completo:\n```{lenguaje}\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])
+        max_val = max(1, int(max_intentos_validacion))
+
+        error_msj = ""
+        nuevo_contenido = ""
+        for intento in range(1, max_val + 1):
+            prompt = (
+                f"Modifica el siguiente archivo ({lenguaje}) para cumplir con la "
+                f"tarea, conservando el estilo existente y cambiando solo lo necesario.\n\n"
+                f"Tarea: {mensaje}\n"
+                f"Archivo: {archivo}  (lenguaje: {lenguaje})\n"
+            )
+            if error_msj:
+                prompt += (
+                    f"\nTu intento anterior produjo un error de sintaxis que debes "
+                    f"corregir:\n{error_msj}\n\n"
+                    f"Mantén el objetivo de la tarea pero arregla ese error.\n"
+                )
+            prompt += (
+                f"\nContenido actual completo:\n```{lenguaje}\n{contenido_actual}\n```\n\n"
+                f"Devuelve ÚNICAMENTE el código completo resultante, sin explicaciones ni markdown."
+            )
+            respuesta = sc._enviar_al_proveedor(
+                proveedor, modelo, [{"role": "user", "content": prompt}])
+            nuevo_contenido = respuesta
+            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 validar:
+                break
+
+            sc.info(f"Validando sintaxis de {archivo}...")
+            exito, err = sc._validar_sintaxis(archivo, nuevo_contenido, directorio)
+            if exito:
+                sc.exito("Sintaxis válida.")
+                break
+            error_msj = err
+            if intento < max_val:
+                sc.error(
+                    f"Error de sintaxis: {err}. "
+                    f"Reintentando ({intento}/{max_val})...")
+            else:
+                sc.error(
+                    f"No se pudo validar tras {max_val} intentos. "
+                    f"Edición cancelada.")
+                return False
+
         return self.sobrescribir(archivo, nuevo_contenido, directorio)
 
     def ejecutar(
@@ -303,6 +426,8 @@ class AgenteEditorPropio:
         directorio: str = ".",
         modo_edicion: str = "auto",
         modelo: Optional[str] = None,
+        validar: bool = True,
+        max_intentos_validacion: int = 3,
     ) -> bool:
         """Aplica las modificaciones para `archivos` con el `mensaje` especificado.
 
@@ -353,10 +478,14 @@ class AgenteEditorPropio:
                                                      str(raiz), modelo)
                     elif estrategia == "parche":
                         conseguido = self._aplicar_modo_parche(
-                            arch, mensaje, contenido_actual, modelo, str(raiz))
+                            arch, mensaje, contenido_actual, modelo, str(raiz),
+                            validar=validar,
+                            max_intentos_validacion=max_intentos_validacion)
                     elif estrategia == "sobrescribir":
                         conseguido = self._aplicar_modo_sobrescribir(
-                            arch, mensaje, contenido_actual, modelo, str(raiz))
+                            arch, mensaje, contenido_actual, modelo, str(raiz),
+                            validar=validar,
+                            max_intentos_validacion=max_intentos_validacion)
                     else:
                         conseguido = False
                 except Exception as exc:
@@ -539,4 +668,40 @@ class AgenteAprendizaje:
         """Lista los skills almacenados en la memoria persistente."""
         import snapcontext as sc
 
-        return sc._skill_listar(incluir_archivados=incluir_archivados)
+        return sc._skill_listar(incluir_archivados=incluir_archivados)
+
+
+class AgenteAsesor:
+    """Asesor de código proactivo (v3.5.0).
+
+    Analiza el proyecto sin que el usuario lo pida explícitamente y propone
+    mejoras (refactorizaciones, deuda técnica, patrones obsoletos...). Por
+    defecto solo informa; las sugerencias marcadas como seguras pueden
+    aplicarse con ``--asesor-auto`` y siempre se validan antes de guardarse.
+    """
+
+    def analizar(self, directorio: str = ".",
+                 umbral_funcion: Optional[int] = None) -> List[dict]:
+        """Ejecuta el análisis estático y devuelve la lista de sugerencias."""
+        import snapcontext as sc
+
+        return sc._asesor_analizar(directorio, umbral_funcion=umbral_funcion)
+
+    def mostrar(self, sugerencias: List[dict]) -> None:
+        """Muestra las sugerencias en la CLI con colores."""
+        import snapcontext as sc
+
+        sc._asesor_mostrar(sugerencias)
+
+    def aplicar_automaticas(self, sugerencias: List[dict],
+                            directorio: str = ".") -> int:
+        """Aplica las mejoras seguras (auto=True); devuelve cuántas se aplicaron."""
+        import snapcontext as sc
+
+        return sc._asesor_aplicar_automaticas(sugerencias, directorio)
+
+    def ejecutar(self, args) -> int:
+        """Flujo completo del modo CLI (--asesor / --asesor-auto)."""
+        import snapcontext as sc
+
+        return sc._ejecutar_asesor(args)

{snapcontext-3.3.0 → snapcontext-3.5.0}/orquestador.py

@@ -21,7 +21,8 @@ import sys
 from typing import List, Optional, Tuple
 
 from agentes import (AgenteContexto, AgenteEditor, AgenteEditorAST,
-                     AgenteEditorPropio, AgenteAprendizaje, AgenteTester)
+                     AgenteEditorPropio, AgenteAprendizaje, AgenteTester,
+                     AgenteAsesor)
 
 # Centinela diferenciado del None de "aborto": _planificar lo devuelve cuando
 # el pipeline termina de forma exitosa y temprana (p. ej. --vista-previa).
@@ -44,6 +45,7 @@ class Orquestador:
         self.agente_editor_ast = AgenteEditorAST()
         self.agente_tester = AgenteTester()
         self.agente_aprendizaje = AgenteAprendizaje()
+        self.agente_asesor = AgenteAsesor()
         self.evento_callback = evento_callback
 
     def _on_evento(self, evento: dict) -> None:
@@ -190,6 +192,9 @@ class Orquestador:
                         directorio=str(raiz),
                         modo_edicion=modo_ed,
                         modelo=getattr(args, "modelo", None),
+                        validar=getattr(args, "validar", True),
+                        max_intentos_validacion=getattr(
+                            args, "max_intentos_validacion", 3),
                     )
                     self._emitir_tipo("editor", accion="fin", ok=ok)
                 else:

{snapcontext-3.3.0 → snapcontext-3.5.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 # 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 = "3.3.0"
+version = "3.5.0"
 description = "SnapContext: Asistente de IA con contexto automático para desarrollo"
 readme = "README.md"
 requires-python = ">=3.9"