context-map-ai 2.1.0__tar.gz → 2.2.0__tar.gz

{context_map_ai-2.1.0 → context_map_ai-2.2.0}/.github/copilot-instructions.md

@@ -18,7 +18,7 @@
 
 # GitHub Copilot — Instrucciones para ContextMap
 
-> Generado automáticamente por **ContextMap** (2026-08-18).
+> Generado automáticamente por **ContextMap** (2026-08-19).
 
 ## Antes de sugerir código
 

{context_map_ai-2.1.0 → context_map_ai-2.2.0}/CHANGELOG.md

@@ -5,6 +5,16 @@ Todas las notas de versión y cambios destacables en este proyecto serán docume
 El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1.0.0/),
 y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.0] — 2026-08-19
+
+### 🗜️ Nuevo — Paquetes de Contexto Portátiles Offline, Escáner de Auditoría AST & Fallback de Modelos
+
+- **🗜️ Empaquetado y Desempaquetado Portátil (`ctxmap pack` / `ctxmap unpack`)**: Nuevo sistema para comprimir la memoria viva completa de cualquier proyecto en un archivo único binario `.ctxpack` con manifiesto de integridad (`pack_manifest.json`) y restaurarlo 100% offline en cualquier equipo.
+- **🛡️ Escáner Sintáctico AST de Auditoría Local (`domain/analyzers/ast_audit.py`)**: Motor determinístico de análisis estático que detecta ejecuciones dinámicas inseguras (`eval/exec`), concatenaciones de SQL dinámicas, bloques `except Exception: pass` silenciosos, desuso de administradores de contexto en archivos y credenciales hardcodadas.
+- **🦙 Fallback Inteligente de Modelos Ollama (`infrastructure/integrations/ollama.py`)**: Auto-resolución de modelos locales instalados vía API `/api/tags` para seleccionar automáticamente modelos disponibles (`coder`, `qwen`, `llama`, `deepseek`, `phi`) sin fallar por modelos ausentes.
+- **⚙️ Generación Automática de Plantilla `dominios.yaml` (`application/commands/_helpers.py`)**: Creación transparente de la plantilla por defecto de agrupamiento temático para Obsidian.
+- **Suite de Pruebas**: 176/176 tests unitarios pasados al 100% verde.
+
 ---
 
 ## [2.1.0] — 2026-08-18

{context_map_ai-2.1.0 → context_map_ai-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: context-map-ai
-Version: 2.1.0
+Version: 2.2.0
 Summary: Mapa mental narrativo de proyectos para agentes de IA
 Project-URL: Homepage, https://github.com/kudawasama/ContextMap
 Project-URL: Repository, https://github.com/kudawasama/ContextMap
@@ -41,7 +41,8 @@ Description-Content-Type: text/markdown
 
 *Captura el alma de tu proyecto, establece gobernanza automática y mantiene vivo el contexto para cualquier Agente de IA (`Antigravity`, `Cursor`, `Claude`, `Hermes`, `Copilot`, `Windsurf`, `Gemini`).*
 
-[![Release](https://img.shields.io/badge/version-v2.1.0-blue.svg?style=for-the-badge)](https://github.com/kudawasama/ContextMap)
+[![Release](https://img.shields.io/badge/version-v2.2.0-blue.svg?style=for-the-badge)](https://github.com/kudawasama/ContextMap)
+[![PyPI](https://img.shields.io/pypi/v/context-map-ai.svg?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/context-map-ai/)
 [![Python](https://img.shields.io/badge/python-3.10+-3776AB.svg?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)](LICENSE)
 [![Readiness](https://img.shields.io/badge/Readiness-100%2F100-brightgreen.svg?style=for-the-badge)](file:///.context-map/CONTEXT.md)
@@ -62,7 +63,7 @@ Description-Content-Type: text/markdown
 ContextMap creates an interconnected **Obsidian Vault** and **AI Executive Brief (`CONTEXT.md`)** to manage context, multi-IDE rules, living memory, and autonomous self-maintenance for your software projects across agents like `Antigravity`, `Cursor`, `Claude Code`, `Copilot`, `Hermes`, and `Gemini`.
 
 - 📖 **Full English Documentation:** See [**README_EN.md**](README_EN.md)
-- ⚡ **Quick Install:** `uv tool install git+https://github.com/kudawasama/ContextMap.git`
+- ⚡ **PyPI Install:** `pip install context-map-ai` or `uv tool install context-map-ai`
 - 💬 **Initialize:** Tell your AI Agent: *"Initialize ContextMap for this project"* or run `ctxmap auto .`
 </details>
 
@@ -85,14 +86,17 @@ Construye una bóveda interconectada en **Obsidian** ([Graph View en Árbol Estr
 
 ## ⚡ Inicio Rápido en 10 Segundos
 
-### 1. Instalación Global (con `uv`)
+### 1. Instalación Global (con `pip` o `uv`)
 
 ```bash
-# Recomendado: instalación directa en 1 comando (requiere https://docs.astral.sh/uv/)
-uv tool install git+https://github.com/kudawasama/ContextMap.git
+# Opción 1: Desde PyPI oficial (recomendado con pip)
+pip install context-map-ai
+
+# Opción 2: Instalación aislada global con uv (ultra-rápido)
+uv tool install context-map-ai
 
-# O con pip desde un clon local:
-# git clone https://github.com/kudawasama/ContextMap.git && cd ContextMap && pip install -e .
+# Opción 3: Desde el repositorio en GitHub
+uv tool install git+https://github.com/kudawasama/ContextMap.git
 ```
 
 ### 2. Poner en Contexto un Proyecto
@@ -224,6 +228,10 @@ ctxmap hook install                   # Inyecta pre-commit y post-commit transpa
 # 🔄 Cierre de sesión de trabajo
 ctxmap wrap                           # refresh + resumen de memoria viva registrada
 
+# 📦 Empaquetado y Transporte Offline Portátil
+ctxmap pack . --output mi_proyecto.ctxpack  # Comprime la memoria viva en un paquete único
+ctxmap unpack mi_proyecto.ctxpack ./destino # Restaura el contexto completo 100% offline
+
 # 📦 Exportación de Contexto Portable (Repomix compatible)
 ctxmap export . --format xml          # Exporta contexto plano en XML, JSON o Markdown
 

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

@@ -9,7 +9,8 @@
 
 *Captura el alma de tu proyecto, establece gobernanza automática y mantiene vivo el contexto para cualquier Agente de IA (`Antigravity`, `Cursor`, `Claude`, `Hermes`, `Copilot`, `Windsurf`, `Gemini`).*
 
-[![Release](https://img.shields.io/badge/version-v2.1.0-blue.svg?style=for-the-badge)](https://github.com/kudawasama/ContextMap)
+[![Release](https://img.shields.io/badge/version-v2.2.0-blue.svg?style=for-the-badge)](https://github.com/kudawasama/ContextMap)
+[![PyPI](https://img.shields.io/pypi/v/context-map-ai.svg?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/context-map-ai/)
 [![Python](https://img.shields.io/badge/python-3.10+-3776AB.svg?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)](LICENSE)
 [![Readiness](https://img.shields.io/badge/Readiness-100%2F100-brightgreen.svg?style=for-the-badge)](file:///.context-map/CONTEXT.md)
@@ -30,7 +31,7 @@
 ContextMap creates an interconnected **Obsidian Vault** and **AI Executive Brief (`CONTEXT.md`)** to manage context, multi-IDE rules, living memory, and autonomous self-maintenance for your software projects across agents like `Antigravity`, `Cursor`, `Claude Code`, `Copilot`, `Hermes`, and `Gemini`.
 
 - 📖 **Full English Documentation:** See [**README_EN.md**](README_EN.md)
-- ⚡ **Quick Install:** `uv tool install git+https://github.com/kudawasama/ContextMap.git`
+- ⚡ **PyPI Install:** `pip install context-map-ai` or `uv tool install context-map-ai`
 - 💬 **Initialize:** Tell your AI Agent: *"Initialize ContextMap for this project"* or run `ctxmap auto .`
 </details>
 
@@ -53,14 +54,17 @@ Construye una bóveda interconectada en **Obsidian** ([Graph View en Árbol Estr
 
 ## ⚡ Inicio Rápido en 10 Segundos
 
-### 1. Instalación Global (con `uv`)
+### 1. Instalación Global (con `pip` o `uv`)
 
 ```bash
-# Recomendado: instalación directa en 1 comando (requiere https://docs.astral.sh/uv/)
-uv tool install git+https://github.com/kudawasama/ContextMap.git
+# Opción 1: Desde PyPI oficial (recomendado con pip)
+pip install context-map-ai
+
+# Opción 2: Instalación aislada global con uv (ultra-rápido)
+uv tool install context-map-ai
 
-# O con pip desde un clon local:
-# git clone https://github.com/kudawasama/ContextMap.git && cd ContextMap && pip install -e .
+# Opción 3: Desde el repositorio en GitHub
+uv tool install git+https://github.com/kudawasama/ContextMap.git
 ```
 
 ### 2. Poner en Contexto un Proyecto
@@ -192,6 +196,10 @@ ctxmap hook install                   # Inyecta pre-commit y post-commit transpa
 # 🔄 Cierre de sesión de trabajo
 ctxmap wrap                           # refresh + resumen de memoria viva registrada
 
+# 📦 Empaquetado y Transporte Offline Portátil
+ctxmap pack . --output mi_proyecto.ctxpack  # Comprime la memoria viva en un paquete único
+ctxmap unpack mi_proyecto.ctxpack ./destino # Restaura el contexto completo 100% offline
+
 # 📦 Exportación de Contexto Portable (Repomix compatible)
 ctxmap export . --format xml          # Exporta contexto plano en XML, JSON o Markdown
 

{context_map_ai-2.1.0 → context_map_ai-2.2.0}/README_EN.md

@@ -9,7 +9,8 @@
 
 *Capture the soul of your project, establish automated governance, and keep living context available for any AI Agent (`Antigravity`, `Cursor`, `Claude Code`, `Hermes`, `Copilot`, `Windsurf`, `Gemini`).*
 
-[![Release](https://img.shields.io/badge/version-v2.1.0-blue.svg?style=for-the-badge)](https://github.com/kudawasama/ContextMap)
+[![Release](https://img.shields.io/badge/version-v2.2.0-blue.svg?style=for-the-badge)](https://github.com/kudawasama/ContextMap)
+[![PyPI](https://img.shields.io/pypi/v/context-map-ai.svg?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/context-map-ai/)
 [![Python](https://img.shields.io/badge/python-3.10+-3776AB.svg?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)](LICENSE)
 [![Readiness](https://img.shields.io/badge/Readiness-100%2F100-brightgreen.svg?style=for-the-badge)](file:///.context-map/CONTEXT.md)
@@ -25,14 +26,14 @@
 
 ## 💡 What is ContextMap and why does it exist?
 
-When working with AI Agents in your IDE (`Antigravity`, `Cursor`, `Claude Code`, `Copilot`, etc.), AI models frequently forget past architectural decisions, miss core project rules, or propose blind refactorings that break your codebase.
+When working with AI Agents in your IDE (`Antigravity`, `Cursor`, `Claude Code`, `Copilot`, etc.), AI often forgets past decisions, ignores strict architecture constraints, or proposes blind refactors that break the system.
 
 **ContextMap solves this by creating a living memory for your project:**
 It builds an interconnected **Obsidian Vault** ([Strict Tree Graph View](file:///.context-map/vault-ContextMap/)) and an AI Executive Brief ([`CONTEXT.md`](file:///.context-map/CONTEXT.md)) that teach any AI Agent:
-- **Why does the project exist?** (Purpose, business domain, and scope).
-- **What risks does it face?** (Static complexity hotspots, warnings, and fragile areas).
+- **Why does the project exist?** (Purpose, business, and identity).
+- **What risks does it face?** (Static complexity, code alerts, and sensitive zones).
 - **What is implemented vs. pending?** (Deduplicated graph of ideas, bases, and changes).
-- **What architectural decisions were made?** (Living memory of past sessions and commit history).
+- **What architecture decisions were made?** (Living memory of past conversations and commit histories).
 
 > 🚫 **ContextMap is not just a passive doc generator.** It is an active system for **Agentic Governance**, **Permanent Memory**, **Readiness Assessment**, and **Autonomous Self-Maintenance**.
 
@@ -40,14 +41,17 @@ It builds an interconnected **Obsidian Vault** ([Strict Tree Graph View](file://
 
 ## ⚡ 10-Second Quick Start
 
-### 1. Global Installation (with `uv`)
+### 1. Global Installation (via `pip` or `uv`)
 
 ```bash
-# Recommended: 1-command direct install (requires https://docs.astral.sh/uv/)
-uv tool install git+https://github.com/kudawasama/ContextMap.git
+# Option 1: Official PyPI Package (Recommended via pip)
+pip install context-map-ai
+
+# Option 2: Global isolated tool via uv
+uv tool install context-map-ai
 
-# Or with pip from local clone:
-# git clone https://github.com/kudawasama/ContextMap.git && cd ContextMap && pip install -e .
+# Option 3: Direct from GitHub repository
+uv tool install git+https://github.com/kudawasama/ContextMap.git
 ```
 
 ### 2. Contextualize a Project
@@ -173,6 +177,10 @@ ctxmap hook install                   # Injects transparent pre-commit & post-co
 # 🔄 Work session closing
 ctxmap wrap                           # refresh + summary of logged living memory
 
+# 📦 Offline Portable Context Packaging
+ctxmap pack . --output project.ctxpack  # Packs living context into a single archive
+ctxmap unpack project.ctxpack ./target # Restores context 100% offline
+
 # 📦 Portable Context Exporter (Repomix compatible)
 ctxmap export . --format xml          # Exports flat context XML, JSON, or Markdown
 

context_map_ai-2.2.0/context_map/__tests__/test_ast_audit.py

@@ -0,0 +1,38 @@
+"""Tests para el módulo de auditoría AST local (ast_audit.py)."""
+
+from __future__ import annotations
+
+from context_map.domain.analyzers.ast_audit import auditar_archivo_python, auditar_proyecto_python
+
+
+def test_auditar_archivo_python_detecta_eval_y_pass(tmp_path):
+    """Verifica la detección de eval() y except pass."""
+    code_file = tmp_path / "vulnerable.py"
+    code_file.write_text(
+        "def test():\n"
+        "    eval('1 + 1')\n"
+        "    try:\n"
+        "        pass\n"
+        "    except Exception:\n"
+        "        pass\n",
+        encoding="utf-8",
+    )
+
+    alertas = auditar_archivo_python(str(code_file))
+    assert len(alertas) >= 2
+    categorias = [a.categoria for a in alertas]
+    assert "SEGURIDAD" in categorias
+    assert "ROBUSTEZ" in categorias
+
+
+def test_auditar_proyecto_python(tmp_path):
+    """Verifica que el escáner de proyecto audite archivos .py recursivamente."""
+    sub_dir = tmp_path / "core"
+    sub_dir.mkdir()
+    f1 = sub_dir / "db.py"
+    f1.write_text("password = 'super_secret_12345'", encoding="utf-8")
+
+    alertas = auditar_proyecto_python(str(tmp_path))
+    assert len(alertas) == 1
+    assert alertas[0].categoria == "SEGURIDAD"
+    assert "password" in alertas[0].mensaje

{context_map_ai-2.1.0 → context_map_ai-2.2.0}/context_map/__tests__/test_doctor.py

@@ -7,8 +7,13 @@ from context_map.domain.health.doctor import diagnosticar_salud, reparar_salud,
 from context_map.presentation.briefs.extractors import vault_nombre
 
 
-def test_doctor_diagnosticar_salud(tmp_path):
+def test_doctor_diagnosticar_salud(tmp_path, monkeypatch):
     """Verifica que diagnosticar_salud retorna un reporte OK."""
+    # Aísla la verificación de ~/.context-map-update a un directorio limpio
+    fake_home = tmp_path / "fake_home"
+    fake_home.mkdir()
+    monkeypatch.setattr("os.path.expanduser", lambda path: str(fake_home) if "~" in path else os.path.expanduser(path))
+    
     report = diagnosticar_salud(str(tmp_path))
     assert report.ok
     assert len(report.checks) >= 4

context_map_ai-2.2.0/context_map/__tests__/test_pack_unpack.py

@@ -0,0 +1,60 @@
+"""Tests unitarios para el empaquetado y desempaquetado de contexto (.ctxpack)."""
+
+from __future__ import annotations
+
+import os
+from context_map.domain.storage.packer import (
+    crear_paquete_contexto,
+    desempaquetar_contexto,
+)
+
+
+def test_pack_y_unpack_flujo_completo(tmp_path):
+    """Verifica la creación y extracción completa de un archivo .ctxpack."""
+    # 1. Crear estructura simulada .context-map/
+    src_dir = tmp_path / "proyecto_origen"
+    ctx_dir = src_dir / ".context-map"
+    state_dir = ctx_dir / "state"
+    state_dir.mkdir(parents=True)
+
+    graph_file = state_dir / "graph.jsonl"
+    graph_file.write_text(
+        '{"id": "idea_1", "type": "IDEA", "title": "Idea 1"}\n'
+        '{"id": "base_1", "type": "BASE", "title": "Base 1"}\n',
+        encoding="utf-8",
+    )
+
+    brief_file = ctx_dir / "CONTEXT.md"
+    brief_file.write_text("# Brief de Contexto", encoding="utf-8")
+
+    agents_file = src_dir / "AGENTS.md"
+    agents_file.write_text("# Reglas Agénticas", encoding="utf-8")
+
+    # 2. Empaquetar
+    out_file = tmp_path / "backup.ctxpack"
+    ruta_gen, size, manifest = crear_paquete_contexto(
+        target_dir=str(src_dir),
+        output_path=str(out_file),
+        project_name="ProyectoPrueba",
+    )
+
+    assert os.path.isfile(ruta_gen)
+    assert size > 0
+    assert manifest["project"] == "ProyectoPrueba"
+    assert manifest["node_count"] == 2
+
+    # 3. Desempaquetar en directorio destino
+    dst_dir = tmp_path / "proyecto_destino"
+    res_manifest = desempaquetar_contexto(
+        archive_path=str(out_file),
+        target_dir=str(dst_dir),
+    )
+
+    assert res_manifest["project"] == "ProyectoPrueba"
+    assert (dst_dir / ".context-map" / "state" / "graph.jsonl").exists()
+    assert (dst_dir / ".context-map" / "CONTEXT.md").exists()
+    assert (dst_dir / "AGENTS.md").exists()
+
+    content = (dst_dir / ".context-map" / "state" / "graph.jsonl").read_text(encoding="utf-8")
+    assert "idea_1" in content
+    assert "base_1" in content

{context_map_ai-2.1.0 → context_map_ai-2.2.0}/context_map/application/cli/cli.py

@@ -30,6 +30,8 @@ from context_map.application.commands import (
     cmd_weekly,
     cmd_wrap,
     cmd_enrich,
+    cmd_pack,
+    cmd_unpack,
 )
 from context_map.application.commands.adapt import cmd_adapt
 from context_map.application.commands.export import exportar_contexto
@@ -121,6 +123,8 @@ def main() -> None:
         "personal": cmd_personal,
         "export": cmd_export,
         "enrich": cmd_enrich,
+        "pack": cmd_pack,
+        "unpack": cmd_unpack,
         "mcp": cmd_mcp,
     }
 

{context_map_ai-2.1.0 → context_map_ai-2.2.0}/context_map/application/cli/parser.py

@@ -206,4 +206,12 @@ def create_parser() -> argparse.ArgumentParser:
     sp_backup.add_argument("--destino", required=True, help="Ruta destino (ej. /run/media/usb/personal.db)")
     sp_backup.add_argument("--db", default=None, help="Ruta a la BD personal (default: la activa)")
 
+    p_pack = sub.add_parser("pack", help="Empaqueta el contexto en un archivo comprimido .ctxpack portátil")
+    p_pack.add_argument("target", nargs="?", default=".", help="Ruta del proyecto (default: .)")
+    p_pack.add_argument("--output", "-o", default=None, help="Ruta del archivo de salida .ctxpack")
+
+    p_unpack = sub.add_parser("unpack", help="Desempaqueta un archivo .ctxpack y restaura el contexto")
+    p_unpack.add_argument("archive", help="Ruta del archivo .ctxpack")
+    p_unpack.add_argument("target", nargs="?", default=".", help="Directorio destino para la restauración (default: .)")
+
     return p

{context_map_ai-2.1.0 → context_map_ai-2.2.0}/context_map/application/commands/__init__.py

@@ -33,8 +33,11 @@ from context_map.application.commands.update import cmd_update
 from context_map.application.commands.watch import cmd_watch
 from context_map.application.commands.wrap import cmd_wrap
 from context_map.application.commands.enrich import cmd_enrich
+from context_map.application.commands.pack import cmd_pack, cmd_unpack
 
 __all__ = [
+    "cmd_pack",
+    "cmd_unpack",
     "cmd_enrich",
     "cmd_auto",
     "cmd_build",

{context_map_ai-2.1.0 → context_map_ai-2.2.0}/context_map/application/commands/_helpers.py

@@ -119,13 +119,38 @@ def project_name(args) -> str:
 
 
 def ensure_dirs(_proj: str | None = None) -> None:
-    """Crea el árbol de directorios de .context-map/.
-
-    NOTA: el vault se crea bajo demanda en build/sync, no acá.
-    """
+    """Crea el árbol de directorios de .context-map/ y plantilla de dominios.yaml si no existe."""
     for path in [STATE_DIR, MAPS_DIR, HISTORY_DIR, CHATS_DIR, RAW_DIR]:
         os.makedirs(path, exist_ok=True)
 
+    dominios_file = os.path.join(CONTEXT_DIR, "dominios.yaml")
+    if not os.path.exists(dominios_file):
+        try:
+            default_template = (
+                "# Dominios temáticos del proyecto (grupos profesionales del contexto)\n"
+                "# Cada nota se etiqueta automáticamente con grupo-<dominio> según las\n"
+                "# palabras clave que aparecen en su título o resumen.\n\n"
+                "raiz:\n"
+                "  - proposito\n"
+                "  - que es\n"
+                "  - identidad\n"
+                "  - esencia\n"
+                "  - objetivo\n\n"
+                "gobierno:\n"
+                "  - gobierno\n"
+                "  - verificar\n"
+                "  - corregir\n"
+                "  - regla\n\n"
+                "vault:\n"
+                "  - vault\n"
+                "  - obsidian\n"
+                "  - nota manual\n"
+            )
+            with open(dominios_file, "w", encoding="utf-8") as f:
+                f.write(default_template)
+        except Exception as err:
+            logger.debug("No se pudo auto-crear dominios.yaml por defecto: %s", err)
+
 
 def resolve_vault_mode(args) -> str:
     """Resuelve el modo de generación del vault desde los argumentos del CLI.

context_map_ai-2.2.0/context_map/application/commands/pack.py

@@ -0,0 +1,68 @@
+"""Comandos CLI pack y unpack: empaquetado y desempaquetado de contexto portátil.
+
+Permite comprimir la estructura .context-map/ en un archivo .ctxpack
+y restaurarlo 100% offline en cualquier equipo.
+"""
+
+from __future__ import annotations
+
+import os
+
+from context_map.domain.storage.packer import (
+    crear_paquete_contexto,
+    desempaquetar_contexto,
+)
+
+
+def cmd_pack(args) -> None:
+    """Ejecuta el empaquetado de contexto en un archivo .ctxpack.
+
+    Args:
+        args: Namespace de argparse con atributos ``target`` y ``output``.
+    """
+    target = getattr(args, "target", ".") or "."
+    output = getattr(args, "output", None)
+    quiet = getattr(args, "quiet", False)
+
+    try:
+        ruta_salida, tamanio, manifest = crear_paquete_contexto(
+            target_dir=target,
+            output_path=output,
+        )
+        if not quiet:
+            kb = tamanio / 1024.0
+            print(f"🗜️ [pack] Contexto empaquetado exitosamente en: {ruta_salida} ({kb:.1f} KB)")
+            print(f"   · Proyecto: {manifest.get('project')} | Nodos: {manifest.get('node_count')} | Formato: {manifest.get('format')}")
+    except Exception as err:
+        if not quiet:
+            print(f"❌ [pack] Error al empaquetar contexto: {err}")
+        raise
+
+
+def cmd_unpack(args) -> None:
+    """Ejecuta el desempaquetado de un archivo .ctxpack.
+
+    Args:
+        args: Namespace de argparse con atributos ``archive`` y ``target``.
+    """
+    archive = getattr(args, "archive", None)
+    target = getattr(args, "target", ".") or "."
+    quiet = getattr(args, "quiet", False)
+
+    if not archive:
+        if not quiet:
+            print("❌ [unpack] Debe especificar la ruta del archivo .ctxpack")
+        return
+
+    try:
+        manifest = desempaquetar_contexto(
+            archive_path=archive,
+            target_dir=target,
+        )
+        if not quiet:
+            print(f"📦 [unpack] Contexto desempaquetado exitosamente en: {os.path.abspath(target)}")
+            print(f"   · Proyecto: {manifest.get('project', 'Restaurado')} | Nodos: {manifest.get('node_count', 0)} | Generado: {manifest.get('timestamp', 'N/A')}")
+    except Exception as err:
+        if not quiet:
+            print(f"❌ [unpack] Error al desempaquetar contexto: {err}")
+        raise

context_map_ai-2.2.0/context_map/domain/analyzers/ast_audit.py

@@ -0,0 +1,155 @@
+"""Analizador sintáctico AST de seguridad y calidad de código local para ContextMap.
+
+Ejecuta verificaciones determinísticas sin internet ni dependencias externas sobre:
+- Uso inseguro de eval() y exec()
+- Supresión silenciosa de excepciones (except Exception: pass)
+- Concatenación de cadenas en consultas SQL (cursor.execute)
+- Apertura de archivos sin administrador de contexto (with open)
+- Claves o contraseñas hardcodadas en código
+"""
+
+from __future__ import annotations
+
+import ast
+import os
+from dataclasses import dataclass
+from typing import List
+
+
+@dataclass
+class AlertaAuditoria:
+    """Alerta de calidad o seguridad detectada por el analizador AST.
+
+    Attributes:
+        archivo (str): Ruta del archivo inspeccionado.
+        linea (int): Número de línea de la anomalía.
+        categoria (str): Categoría ('SEGURIDAD', 'ROBUSTEZ', 'RECURSOS').
+        mensaje (str): Descripción detallada del hallazgo.
+    """
+
+    archivo: str
+    linea: int
+    categoria: str
+    mensaje: str
+
+
+class AuditVisitor(ast.NodeVisitor):
+    """Visitor de AST que inspecciona patrones de calidad y seguridad."""
+
+    def __init__(self, filepath: str) -> None:
+        self.filepath = filepath
+        self.alertas: List[AlertaAuditoria] = []
+
+    def visit_Call(self, node: ast.Call) -> None:
+        # Detectar eval() y exec()
+        if isinstance(node.func, ast.Name) and node.func.id in ("eval", "exec"):
+            self.alertas.append(
+                AlertaAuditoria(
+                    archivo=self.filepath,
+                    linea=node.lineno,
+                    categoria="SEGURIDAD",
+                    mensaje=f"Uso inseguro de ejecutor dinámico '{node.func.id}()'.",
+                )
+            )
+
+        # Detectar cursor.execute con f-strings o concatenación
+        if isinstance(node.func, ast.Attribute) and node.func.attr in ("execute", "executemany"):
+            if node.args:
+                primer_arg = node.args[0]
+                if isinstance(primer_arg, (ast.JoinedStr, ast.BinOp)):
+                    self.alertas.append(
+                        AlertaAuditoria(
+                            archivo=self.filepath,
+                            linea=node.lineno,
+                            categoria="SEGURIDAD",
+                            mensaje="Posible inyección SQL: consulta formateada con cadenas dinámicas en execute().",
+                        )
+                    )
+
+        # Detectar open() suelto fuera de with
+        if isinstance(node.func, ast.Name) and node.func.id == "open":
+            # Si no está dentro de un ast.With, advertir consumo potencial de descriptor
+            self.alertas.append(
+                AlertaAuditoria(
+                    archivo=self.filepath,
+                    linea=node.lineno,
+                    categoria="RECURSOS",
+                    mensaje="Uso de open() directo. Se recomienda usar 'with open(...)' para garantizar el cierre del archivo.",
+                )
+            )
+
+        self.generic_visit(node)
+
+    def visit_ExceptHandler(self, node: ast.ExceptHandler) -> None:
+        # Detectar except Exception: pass o except: pass
+        if len(node.body) == 1 and isinstance(node.body[0], ast.Pass):
+            self.alertas.append(
+                AlertaAuditoria(
+                    archivo=self.filepath,
+                    linea=node.lineno,
+                    categoria="ROBUSTEZ",
+                    mensaje="Bloque 'except' que ignora excepciones silenciosamente con 'pass'.",
+                )
+            )
+        self.generic_visit(node)
+
+    def visit_Assign(self, node: ast.Assign) -> None:
+        # Detectar contraseñas hardcodadas
+        for target in node.targets:
+            if isinstance(target, ast.Name):
+                nombre_var = target.id.lower()
+                if any(k in nombre_var for k in ["password", "secret_key", "api_key", "auth_token"]):
+                    if isinstance(node.value, ast.Constant) and isinstance(node.value.value, str):
+                        val = node.value.value
+                        if len(val) > 4 and val not in ("placeholder", "change_me", "dummy"):
+                            self.alertas.append(
+                                AlertaAuditoria(
+                                    archivo=self.filepath,
+                                    linea=node.lineno,
+                                    categoria="SEGURIDAD",
+                                    mensaje=f"Posible credencial hardcodada en la variable '{target.id}'.",
+                                )
+                            )
+        self.generic_visit(node)
+
+
+def auditar_archivo_python(filepath: str) -> List[AlertaAuditoria]:
+    """Audita un archivo Python individual mediante análisis AST.
+
+    Args:
+        filepath: Ruta del archivo Python.
+
+    Returns:
+        Lista de AlertaAuditoria encontradas.
+    """
+    if not os.path.isfile(filepath) or not filepath.endswith(".py"):
+        return []
+
+    try:
+        with open(filepath, "r", encoding="utf-8", errors="ignore") as f:
+            tree = ast.parse(f.read(), filename=filepath)
+        visitor = AuditVisitor(filepath)
+        visitor.visit(tree)
+        return visitor.alertas
+    except Exception:
+        return []
+
+
+def auditar_proyecto_python(target_dir: str = ".") -> List[AlertaAuditoria]:
+    """Escanea y audita sintácticamente todos los archivos Python del proyecto.
+
+    Args:
+        target_dir: Directorio raíz del proyecto.
+
+    Returns:
+        Lista consolidada de AlertaAuditoria del proyecto.
+    """
+    alertas: List[AlertaAuditoria] = []
+    for raiz, _, archivos in os.walk(target_dir):
+        if any(ign in raiz for ign in [".git", "venv", ".venv", "__pycache__", ".context-map"]):
+            continue
+        for f in archivos:
+            if f.endswith(".py"):
+                r = os.path.join(raiz, f)
+                alertas.extend(auditar_archivo_python(r))
+    return alertas