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

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

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

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/.github/workflows/docs.yml

@@ -7,11 +7,13 @@ on:
       - main
 
 permissions:
-  contents: write
+  contents: read
 
 jobs:
   deploy:
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
     steps:
       - uses: actions/checkout@v4
 

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/.github/workflows/publish.yml

@@ -40,3 +40,17 @@ jobs:
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
           skip-existing: true
+
+  github-release:
+    name: Create GitHub Release
+    needs: pypi-publish
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/.pre-commit-hooks.yaml

@@ -1,7 +1,7 @@
 - id: context-map
   name: ContextMap Auto Sync
   description: Escanea y actualiza automáticamente la bóveda de Obsidian y briefs de ContextMap antes de cada commit.
-  entry: ctxmap build --clean --brief --quiet
+  entry: python -m context_map.cli build --clean --brief --quiet
   language: python
   stages: [pre-commit]
   types: [python, markdown, yaml, json]

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

@@ -5,6 +5,44 @@ 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.3.0] — 2026-08-21
+
+### 🛡️ Novedades y Mejoras — Escáner de Secretos Avanzado, Entropía Shannon, Opt-Out Ollama & Automatización Release
+
+- **feat(`security`)**: Detección ampliada de credenciales con soporte para Slack tokens (`xoxb-`), Stripe keys (`sk_live_`, `sk_test_`), Twilio SIDs (`AC`, `SK`), SendGrid (`SG.`), npm access tokens (`npm_`) y webhooks de Discord.
+- **feat(`security`)**: Análisis matemático de alta entropía de Shannon (`calcular_entropia_shannon`) en asignaciones de variables sensibles para detectar llaves criptográficas no estructuradas.
+- **feat(`ollama`)**: Soporte de opt-out mediante flag `--no-ollama` en `ctxmap enrich` y variable de entorno `CTXMAP_NO_OLLAMA=1` para forzar análisis puramente offline y estático AST.
+- **feat(`ci/cd`)**: Creación automática de GitHub Releases (`softprops/action-gh-release@v2`) con notas generadas al publicar tags en `publish.yml`, y principio de mínimo privilegio en permisos de `docs.yml`.
+- **feat(`personal`)**: Soporte para la variable `CTXMAP_GDRIVE_ROOTS` en `personal sync` y optimización de búsqueda acotada de unidades en Windows.
+
+---
+
+## [2.2.2] — 2026-08-21
+
+### 🔧 Correcciones y Hardening — Saneamiento Técnico y Parche
+
+- **fix(`enrich`)**: Persistencia real en disco de los docstrings generados en `ctxmap enrich` vía `filepath.write_text` con formateo adecuado de indentación y soporte completo para flag `--dry-run` de previsualización sin alterar archivos.
+- **refactor(`complexity`/`cyclomatic`)**: Eliminación de la duplicación de código entre `domain/analysis/complexity.py` y `domain/analyzers/cyclomatic.py`. Consolidación unificada de métricas ciclomáticas de McCabe en `domain/analyzers/cyclomatic.py` (con soporte AST completo para `AsyncFor`, `AsyncWith`, `Assert`, `IfExp`, `BoolOp`).
+- **security(`adaptador`)**: Endurecimiento de `_es_generado_ctxmap` para exigir estrictamente el marcador `CONTEXTMAP:BEGIN` evitando falsos positivos con archivos de usuario.
+- **security(`hermes`)**: Parametrización segura de cláusulas `LIMIT ?` en SQLite para defensa en profundidad.
+- **devops(`pre-commit`)**: Actualización de `.pre-commit-hooks.yaml` para invocar el módulo local `python -m context_map.cli` en lugar del binario global.
+- **docs(`domain_extractor`)**: Corrección de docstrings clarificando análisis de frecuencia léxica local en lugar de TF-IDF.
+
+---
+
+## [2.2.1] — 2026-08-21
+
+### 🔧 Correcciones — Saneamiento de release
+
+- **fix: flag `--version` real**: `ctxmap --version` ahora imprime la versión instalada (antes no existía y `update` mostraba un mensaje hardcodeado).
+- **fix: detección de versión con el paquete renombrado**: `version_check` prioriza `context-map-ai` (nombre canónico actual) sobre el heredado `context-map`, eliminando avisos falsos de actualización.
+- **fix: lint (ruff) 100% limpio**: corregidos 11 errores (`F811` redefinición en `brief.py`, `F841` variables sin usar, `SIM102/105/108`).
+- **style: ruff --fix e isort** aplicados en todo el paquete (anotaciones modernas `dict`/`| None` y orden de imports).
+
+Suite: 176/176 tests verdes · ruff limpio.
+
+---
+
 ## [2.2.0] — 2026-08-19
 
 ### 🗜️ Nuevo — Paquetes de Contexto Portátiles Offline, Escáner de Auditoría AST & Fallback de Modelos

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: context-map-ai
-Version: 2.2.0
+Version: 2.3.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
@@ -9,9 +9,12 @@ Author-email: kudawasama <cespedes.jac@gmail.com>
 License-Expression: MIT
 License-File: LICENSE
 Keywords: agent,ai,context,mindmap,obsidian
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Natural Language :: Spanish
+Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -41,7 +44,7 @@ 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.2.0-blue.svg?style=for-the-badge)](https://github.com/kudawasama/ContextMap)
+[![Release](https://img.shields.io/badge/version-v2.2.1-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)

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

@@ -9,7 +9,7 @@
 
 *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.2.0-blue.svg?style=for-the-badge)](https://github.com/kudawasama/ContextMap)
+[![Release](https://img.shields.io/badge/version-v2.2.1-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)

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

@@ -9,7 +9,7 @@
 
 *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.2.0-blue.svg?style=for-the-badge)](https://github.com/kudawasama/ContextMap)
+[![Release](https://img.shields.io/badge/version-v2.2.1-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)

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/context_map/__tests__/test_ast_summary.py

@@ -1,6 +1,5 @@
 """Pruebas unitarias para el módulo context_map.domain.analyzers.ast_summary."""
 
-import pytest
 from context_map.domain.analyzers.ast_summary import ASTSummaryExtractor
 
 

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/context_map/__tests__/test_cyclomatic.py

@@ -1,6 +1,5 @@
 """Pruebas unitarias para el módulo context_map.domain.analyzers.cyclomatic."""
 
-import pytest
 from context_map.domain.analyzers.cyclomatic import calcular_complejidad_ciclomatica
 
 

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

@@ -3,7 +3,8 @@
 from __future__ import annotations
 
 import os
-from context_map.domain.health.doctor import diagnosticar_salud, reparar_salud, run
+
+from context_map.domain.health.doctor import diagnosticar_salud, reparar_salud
 from context_map.presentation.briefs.extractors import vault_nombre
 
 
@@ -13,7 +14,7 @@ def test_doctor_diagnosticar_salud(tmp_path, monkeypatch):
     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
@@ -41,8 +42,6 @@ def test_doctor_reparar_vaults_desalineados(tmp_path):
     (ctx_dir / "vault-Viejo").mkdir(parents=True)
     (ctx_dir / "vault-Viejo" / "nota.md").write_text("# Nota", encoding="utf-8")
 
-    repo_name = os.path.basename(os.path.abspath(str(tmp_path)))
-    # El vault esperado para tmp_path será vault-<repo_name>
-
-    report = reparar_salud(str(tmp_path))
+    # El vault esperado para tmp_path será vault-<nombre del directorio>
+    reparar_salud(str(tmp_path))
     assert os.path.isdir(ctx_dir / "_legacy" / "vault-Viejo")

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/context_map/__tests__/test_domain_extractor.py

@@ -1,8 +1,6 @@
 """Pruebas unitarias para el módulo context_map.domain.normalization.domain_extractor."""
 
-import pytest
-from pathlib import Path
-from context_map.domain.normalization.domain_extractor import DomainConceptExtractor, extraer_conceptos_proyecto
+from context_map.domain.normalization.domain_extractor import DomainConceptExtractor
 
 
 def test_domain_concept_extractor() -> None:

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/context_map/__tests__/test_ecosistema.py

@@ -328,8 +328,10 @@ def test_adaptar_upgrade_memoria_viva_agents_generado() -> None:
         with open(agents_path, "w", encoding="utf-8") as f:
             f.write(
                 "# Instrucciones — Bot Demo\n\n"
-                "Este proyecto utiliza **ContextMap** para gobernanza de contexto.\n"
+                "<!-- CONTEXTMAP:BEGIN -->\n"
+                "Este proyecto utiliza ContextMap para gobernanza de contexto.\n"
                 "## 1. Protocolo de Inicio\n- Leer el brief\n"
+                "<!-- CONTEXTMAP:END -->\n"
             )
 
         eco = detectar_ecosistema(temp_dir)

context_map_ai-2.3.0/context_map/__tests__/test_enrich.py

@@ -0,0 +1,68 @@
+"""Pruebas unitarias para el comando ctxmap enrich y su persistencia en disco."""
+
+import argparse
+import ast
+import tempfile
+from pathlib import Path
+
+from context_map.application.commands.enrich import _formatear_docstring, cmd_enrich
+
+
+def test_formatear_docstring_simple() -> None:
+    """Verifica el formateo de un docstring simple de una sola línea."""
+    res = _formatear_docstring("Calcula el total de la orden.", "    ")
+    assert len(res) == 1
+    assert res[0] == '    """Calcula el total de la orden."""'
+
+
+def test_formatear_docstring_multilinea() -> None:
+    """Verifica el formateo de un docstring con múltiples líneas e indentación."""
+    doc = """Calcula el total.
+
+Args:
+    subtotal: Monto base.
+"""
+    res = _formatear_docstring(doc, "    ")
+    assert res[0] == '    """Calcula el total.'
+    assert "    Args:" in res
+    assert "        subtotal: Monto base." in res
+    assert res[-1] == '    """'
+
+
+def test_cmd_enrich_persiste_cambios_en_disco() -> None:
+    """Verifica que cmd_enrich escriba efectivamente el docstring generado en el archivo."""
+    codigo_original = "def sumar(a: int, b: int) -> int:\n    return a + b\n"
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        test_file = Path(tmpdir) / "matematica.py"
+        test_file.write_text(codigo_original, encoding="utf-8")
+
+        args = argparse.Namespace(path=str(test_file), model=None, dry_run=False)
+        ret = cmd_enrich(args)
+        assert ret == 0
+
+        contenido_nuevo = test_file.read_text(encoding="utf-8")
+        assert contenido_nuevo != codigo_original
+
+        # Validar que sea sintácticamente válido
+        tree = ast.parse(contenido_nuevo)
+        fn = tree.body[0]
+        assert isinstance(fn, ast.FunctionDef)
+        assert ast.get_docstring(fn) is not None
+        assert "sumar" in ast.get_docstring(fn).lower() or len(ast.get_docstring(fn)) > 0
+
+
+def test_cmd_enrich_dry_run_no_modifica_disco() -> None:
+    """Verifica que en modo --dry-run el archivo en disco permanezca intacto."""
+    codigo_original = "def restar(a: int, b: int) -> int:\n    return a - b\n"
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        test_file = Path(tmpdir) / "calculo.py"
+        test_file.write_text(codigo_original, encoding="utf-8")
+
+        args = argparse.Namespace(path=str(test_file), model=None, dry_run=True)
+        ret = cmd_enrich(args)
+        assert ret == 0
+
+        contenido_despues = test_file.read_text(encoding="utf-8")
+        assert contenido_despues == codigo_original

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/context_map/__tests__/test_enterprise_features.py

@@ -4,7 +4,7 @@ import tempfile
 
 from context_map.application.commands.hook import cmd_hook_install
 from context_map.core.storage.config_loader import load_project_config
-from context_map.domain.analysis.complexity import calcular_complejidad_archivo
+from context_map.domain.analyzers.cyclomatic import calcular_complejidad_archivo
 
 
 def test_hook_install_creates_pre_commit_script() -> None:

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/context_map/__tests__/test_hardware.py

@@ -1,7 +1,6 @@
 """Pruebas unitarias para el módulo context_map.domain.health.hardware."""
 
-import pytest
-from context_map.domain.health.hardware import evaluar_hardware_pc, EspecificacionesHardware
+from context_map.domain.health.hardware import EspecificacionesHardware, evaluar_hardware_pc
 
 
 def test_evaluar_hardware_pc() -> None:

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/context_map/__tests__/test_hooks.py

@@ -2,7 +2,6 @@
 
 from __future__ import annotations
 
-import os
 from context_map.domain.ecosystem.hooks import desinstalar_git_hooks, instalar_git_hooks
 
 

context_map_ai-2.3.0/context_map/__tests__/test_mcp_server_seguridad.py

@@ -0,0 +1,31 @@
+"""Tests de seguridad del servidor MCP: confirmación destructiva y validación de rutas."""
+
+from __future__ import annotations
+
+from context_map.infrastructure import mcp_server
+
+
+def test_mcp_build_clean_sin_confirmacion_es_rechazado():
+    """Verifica que build(clean=True) exige confirm=True."""
+    res = mcp_server.build(target=".", clean=True)
+    assert "rechazada por seguridad" in res
+    assert "confirm=True" in res
+
+
+def test_mcp_doctor_fix_sin_confirmacion_es_rechazado():
+    """Verifica que doctor(fix=True) exige confirm=True."""
+    res = mcp_server.doctor(target=".", fix=True)
+    assert "rechazada por seguridad" in res
+
+
+def test_mcp_install_hooks_sin_confirmacion_es_rechazado():
+    """Verifica que install_hooks exige confirm=True."""
+    res = mcp_server.install_hooks(target=".", force=True)
+    assert "rechazada por seguridad" in res
+
+
+def test_mcp_target_invalido_devuelve_error():
+    """Verifica que un target inexistente no se procesa."""
+    res = mcp_server.check(target="/ruta/inexistente/xyz-123")
+    assert "ERROR" in res
+    assert "no es un directorio" in res

context_map_ai-2.3.0/context_map/__tests__/test_ollama.py

@@ -0,0 +1,29 @@
+"""Pruebas unitarias para el módulo context_map.infrastructure.integrations.ollama."""
+
+from context_map.infrastructure.integrations.ollama import OllamaLocalClient
+
+
+def test_ollama_client_init() -> None:
+    """Verifica la inicialización del cliente de Ollama local."""
+    client = OllamaLocalClient()
+    assert client.host == "http://localhost:11434"
+    assert client.hardware is not None
+    # Si no hay Ollama corriendo en el entorno de test, esta_disponible() debe retornar False sin lanzar excepción
+    disponible = client.esta_disponible()
+    assert isinstance(disponible, bool)
+
+
+def test_ollama_client_opt_out_parametro() -> None:
+    """Verifica que el parámetro opt_out desactive inmediatamente el cliente."""
+    client = OllamaLocalClient(opt_out=True)
+    assert client.opt_out is True
+    assert client.esta_disponible() is False
+    assert client.listar_modelos_instalados() == []
+
+
+def test_ollama_client_opt_out_entorno(monkeypatch) -> None:
+    """Verifica que la variable de entorno CTXMAP_NO_OLLAMA desactive el cliente."""
+    monkeypatch.setenv("CTXMAP_NO_OLLAMA", "1")
+    client = OllamaLocalClient()
+    assert client.opt_out is True
+    assert client.esta_disponible() is False

context_map_ai-2.3.0/context_map/__tests__/test_pack_unpack.py

@@ -0,0 +1,135 @@
+"""Tests unitarios para el empaquetado y desempaquetado de contexto (.ctxpack)."""
+
+from __future__ import annotations
+
+import io
+import os
+import tarfile
+
+import pytest
+
+from context_map.domain.storage.packer import (
+    _sha256_archivo,
+    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
+
+
+def test_manifest_incluye_checksums_sha256(tmp_path):
+    """Verifica que el manifiesto registra un checksum SHA-256 por archivo."""
+    src_dir = tmp_path / "origen"
+    state_dir = src_dir / ".context-map" / "state"
+    state_dir.mkdir(parents=True)
+    (state_dir / "graph.jsonl").write_text("hola\n", encoding="utf-8")
+
+    out_file = tmp_path / "backup.ctxpack"
+    _, _, manifest = crear_paquete_contexto(str(src_dir), str(out_file), project_name="Checksums")
+
+    ruta_rel = os.path.join(".context-map", "state", "graph.jsonl")
+    assert ruta_rel in manifest["files"]
+    assert manifest["files"][ruta_rel] == _sha256_archivo(str(state_dir / "graph.jsonl"))
+
+
+def test_unpack_detecta_integridad_comprometida(tmp_path):
+    """Verifica que un paquete con contenido alterado se rechaza por checksum."""
+    src_dir = tmp_path / "origen"
+    state_dir = src_dir / ".context-map" / "state"
+    state_dir.mkdir(parents=True)
+    (state_dir / "graph.jsonl").write_text('{"id": "a", "type": "IDEA"}\n', encoding="utf-8")
+
+    out_file = tmp_path / "backup.ctxpack"
+    crear_paquete_contexto(str(src_dir), str(out_file), project_name="Integridad")
+
+    # Reescribir el tar alterando graph.jsonl sin actualizar el manifiesto
+    tampered = tmp_path / "tampered.ctxpack"
+    with tarfile.open(str(out_file), "r:gz") as tar, tarfile.open(str(tampered), "w:gz") as out:
+        for m in tar.getmembers():
+            f = tar.extractfile(m)
+            contenido = f.read() if f else b""
+            if m.name == ".context-map/state/graph.jsonl":
+                contenido = b'{"id": "ALTERADO_TAMPERED"}\n'
+            ti = tarfile.TarInfo(m.name)
+            ti.size = len(contenido)
+            ti.mode = m.mode
+            out.addfile(ti, io.BytesIO(contenido))
+
+    with pytest.raises(ValueError, match="Integridad"):
+        desempaquetar_contexto(str(tampered), str(tmp_path / "destino"))
+
+
+def _crear_tar_con_symlink(path: str) -> None:
+    """Crea un .ctxpack malicioso con un symlink apuntando fuera del destino."""
+    with tarfile.open(path, "w:gz") as tar:
+        data = b"contenido"
+        ti = tarfile.TarInfo(".context-map/state/graph.jsonl")
+        ti.size = len(data)
+        tar.addfile(ti, io.BytesIO(data))
+
+        # Symlink malicioso que apunta fuera del directorio destino
+        sl = tarfile.TarInfo("escape")
+        sl.type = tarfile.SYMTYPE
+        sl.linkname = "/tmp/ctxmap_escape_target"
+        tar.addfile(sl)
+
+
+def test_unpack_rechaza_symlinks(tmp_path):
+    """Verifica que un .ctxpack con symlinks no los extrae (hardening)."""
+    archivo = tmp_path / "malicioso.ctxpack"
+    _crear_tar_con_symlink(str(archivo))
+
+    destino = tmp_path / "destino"
+    desempaquetar_contexto(str(archivo), str(destino))
+
+    assert (destino / ".context-map" / "state" / "graph.jsonl").exists()
+    assert not (destino / "escape").exists()  # el symlink no se extrae

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/context_map/__tests__/test_scan_cache.py

@@ -1,7 +1,7 @@
 """Pruebas unitarias para el módulo context_map.domain.scanning.cache."""
 
-import pytest
 from pathlib import Path
+
 from context_map.domain.scanning.cache import ScanCacheManager
 
 

context_map_ai-2.3.0/context_map/__tests__/test_security.py

@@ -0,0 +1,65 @@
+"""Pruebas unitarias para el escáner de secretos y análisis de entropía de Shannon."""
+
+from context_map.domain.scanning.security import SecurityScanner, calcular_entropia_shannon
+
+
+def test_calcular_entropia_shannon() -> None:
+    """Verifica el cálculo de entropía de Shannon en cadenas repetitivas y aleatorias."""
+    assert calcular_entropia_shannon("") == 0.0
+    # Cadena de caracteres repetidos tiene entropía 0
+    assert calcular_entropia_shannon("aaaaaaaaaaaaaaaa") == 0.0
+    # Cadena pseudoaleatoria criptográfica tiene alta entropía (> 4.0)
+    entropia_alta = calcular_entropia_shannon("a8F9z!q2L#m9X$v1K@p8")
+    assert entropia_alta > 4.0
+
+
+def test_scanner_detecta_slack_y_stripe() -> None:
+    """Verifica la detección de tokens de Slack y Stripe."""
+    token_slack = "".join(["xo", "xb-", "123456789012-", "1234567890123-", "abcDEFghiJKLmnoPQR"])
+    token_stripe = "".join(["sk_", "live_", "51HzABC1234567890abcdefghijklmnOPQR"])
+    codigo = f"""
+    SLACK_BOT = "{token_slack}"
+    STRIPE_KEY = "{token_stripe}"
+    """
+    hallazgos = SecurityScanner.escanear_contenido(codigo, "app/config.py")
+    tipos = [h["tipo"] for h in hallazgos]
+    assert "Slack Token" in tipos
+    assert "Stripe API Key" in tipos
+
+
+def test_scanner_detecta_sendgrid_npm_twilio() -> None:
+    """Verifica la detección de SendGrid, npm y Twilio."""
+    token_sendgrid = "".join(["SG.", "abcdefghij1234567890_-.", "_-abcdefghijklmnopqrstuvwxyz0123456789012"])
+    token_npm = "".join(["npm_", "1234567890abcdefghijklmnopqrstuv"])
+    token_twilio = "".join(["AC", "1234567890abcdef1234567890abcdef"])
+    codigo = f"""
+    SENDGRID_API = "{token_sendgrid}"
+    NPM_AUTH = "{token_npm}"
+    TWILIO_SID = "{token_twilio}"
+    """
+    hallazgos = SecurityScanner.escanear_contenido(codigo, "services/auth.py")
+    tipos = [h["tipo"] for h in hallazgos]
+    assert "SendGrid API Key" in tipos
+    assert "npm Access Token" in tipos
+    assert "Twilio API Key or SID" in tipos
+
+
+def test_scanner_detecta_alta_entropia_generica() -> None:
+    """Verifica que asignaciones de alta entropía a variables sensibles sean advertidas."""
+    token_entropy = "".join(["9f8a7b6c5d", "4e3f2a1b0c", "9d8e7f6a5b", "4c3d2e1f0a"])
+    codigo = f'AUTH_TOKEN = "{token_entropy}"'
+    hallazgos = SecurityScanner.escanear_contenido(codigo, "sec/secrets.py")
+    tipos = [h["tipo"] for h in hallazgos]
+    assert any("Entropy" in t or "Token" in t for t in tipos)
+
+
+def test_scanner_ignora_lineas_dummy() -> None:
+    """Verifica que líneas con dummy, placeholder o example no disparen falsos positivos."""
+    token_anthropic = "".join(["sk-ant-", "api03-", "1234567890123456789012345678901234567890"])
+    token_example = "".join(["xo", "xb-", "123456789012-", "1234567890123-", "placeholder"])
+    codigo = f"""
+    # dummy_key = {token_anthropic}
+    EXAMPLE_TOKEN = "{token_example}"
+    """
+    hallazgos = SecurityScanner.escanear_contenido(codigo, "tests/mock.py")
+    assert len(hallazgos) == 0

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/context_map/__tests__/test_security_scanner.py

@@ -1,6 +1,7 @@
 """Pruebas unitarias para el detector preventivo de secretos en el código fuente."""
 
 from pathlib import Path
+
 from context_map.domain.scanning.security import SecurityScanner, escanear_secretos_archivo
 
 

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/context_map/__tests__/test_similarity.py

@@ -1,11 +1,10 @@
 """Pruebas unitarias para el módulo context_map.domain.normalization.similarity."""
 
-import pytest
 from context_map.domain.normalization.similarity import (
+    deduplicar_elementos_similares,
     distancia_levenshtein,
     similitud_jaccard_ngramas,
     son_textos_similares,
-    deduplicar_elementos_similares,
 )
 
 

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/context_map/__tests__/test_tokenization.py

@@ -1,6 +1,5 @@
 """Pruebas unitarias para el módulo de tokenización context_map.core.tokenization."""
 
-import pytest
 from context_map.core.tokenization import TokenCounter, contar_tokens_texto, normalize_model_name
 
 

{context_map_ai-2.2.0 → context_map_ai-2.3.0}/context_map/__tests__/test_wrap.py

@@ -8,7 +8,6 @@ lo registrado (eventos en events.jsonl) vs lo que queda sin importar
 from __future__ import annotations
 
 import json
-import os
 
 from context_map.application.commands.wrap import cmd_wrap