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

{context_map_ai-2.2.0 → context_map_ai-2.2.1}/.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.2.1}/CHANGELOG.md

@@ -5,6 +5,19 @@ 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.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.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: context-map-ai
-Version: 2.2.0
+Version: 2.2.1
 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,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.2.1}/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.2.1}/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.2.1}/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.2.1}/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.2.1}/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.2.1}/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.2.1}/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.2.1}/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.2.1/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.2.0 → context_map_ai-2.2.1}/context_map/__tests__/test_ollama.py

@@ -1,6 +1,5 @@
 """Pruebas unitarias para el módulo context_map.infrastructure.integrations.ollama."""
 
-import pytest
 from context_map.infrastructure.integrations.ollama import OllamaLocalClient
 
 

context_map_ai-2.2.1/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.2.1}/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.2.0 → context_map_ai-2.2.1}/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.2.1}/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.2.1}/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.2.1}/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
 

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

@@ -8,6 +8,8 @@ from __future__ import annotations
 
 import argparse
 
+from context_map.infrastructure.version_check import version_local
+
 
 def create_parser() -> argparse.ArgumentParser:
     """Construye y configura el parser principal con sus subcomandos.
@@ -20,6 +22,12 @@ def create_parser() -> argparse.ArgumentParser:
         description="Mapa mental narrativo de proyectos para agentes de IA",
     )
     p.add_argument("-v", "--verbose", action="store_true", help="Logs detallados (nivel DEBUG)")
+    p.add_argument(
+        "--version",
+        action="version",
+        version=f"ContextMap v{version_local()}",
+        help="Muestra la versión instalada y sale",
+    )
     sub = p.add_subparsers(dest="cmd", help="Comandos disponibles")
 
     s_auto = sub.add_parser("auto", help="Automatización completa en 1 paso (scan + git + build)")
@@ -136,7 +144,7 @@ def create_parser() -> argparse.ArgumentParser:
     s_antigravity.add_argument("--limit", type=int, default=5, help="Máximo de conversaciones")
 
     sub.add_parser("update", help="Actualiza ContextMap a la última versión")
-    
+
     s_doctor = sub.add_parser("doctor", help="Diagnóstico y auto-reparación (Self-Healing) del proyecto")
     s_doctor.add_argument("target", nargs="?", default=".", help="Ruta del proyecto a diagnosticar")
     s_doctor.add_argument("--fix", action="store_true", help="Auto-reparar anomalías e inconsistencias encontradas")

{context_map_ai-2.2.0 → context_map_ai-2.2.1}/context_map/application/commands/doctor_cmd.py

@@ -3,12 +3,12 @@
 from __future__ import annotations
 
 import json
-from typing import Any, Dict
+from typing import Any
 
 from context_map.domain.health.doctor import diagnosticar_salud, reparar_salud
 
 
-def cmd_doctor(args: Dict[str, Any]) -> None:
+def cmd_doctor(args: dict[str, Any]) -> None:
     """Manejador del comando CLI `ctxmap doctor`.
 
     Args:
@@ -18,10 +18,7 @@ def cmd_doctor(args: Dict[str, Any]) -> None:
     fix = bool(args.get("fix", False))
     as_json = bool(args.get("json", False))
 
-    if fix:
-        report = reparar_salud(target_dir)
-    else:
-        report = diagnosticar_salud(target_dir)
+    report = reparar_salud(target_dir) if fix else diagnosticar_salud(target_dir)
 
     if as_json:
         data = {

{context_map_ai-2.2.0 → context_map_ai-2.2.1}/context_map/application/commands/enrich.py

@@ -4,13 +4,13 @@ Analiza archivos Python mediante AST y genera docstrings formales en Español T
 (Google Style) utilizando Ollama local si está disponible o inferencia AST estática.
 """
 
-import ast
 import argparse
+import ast
 from pathlib import Path
-from typing import List, Optional
+
+from context_map.domain.analyzers.ast_summary import ASTSummaryExtractor
 from context_map.domain.health.hardware import evaluar_hardware_pc
 from context_map.infrastructure.integrations.ollama import OllamaLocalClient
-from context_map.domain.analyzers.ast_summary import ASTSummaryExtractor
 
 
 def cmd_enrich(args: argparse.Namespace) -> int:
@@ -23,7 +23,6 @@ def cmd_enrich(args: argparse.Namespace) -> int:
         Código de salida 0 (éxito) o 1 (error).
     """
     ruta_target = Path(args.path).resolve() if hasattr(args, "path") and args.path else Path(".").resolve()
-    dry_run = getattr(args, "dry_run", False)
 
     print(f"[enrich] Analizando directorio: {ruta_target}")
 
@@ -32,7 +31,7 @@ def cmd_enrich(args: argparse.Namespace) -> int:
     print(f"[enrich] Hardware: {hw.mensaje_diagnostico}")
 
     # 2. Inicializar cliente Ollama si es apto
-    ollama_client: Optional[OllamaLocalClient] = None
+    ollama_client: OllamaLocalClient | None = None
     if hw.es_apto_para_ollama:
         client = OllamaLocalClient(model_name=getattr(args, "model", None) or hw.modelo_recomendado)
         if client.esta_disponible():
@@ -57,7 +56,6 @@ def cmd_enrich(args: argparse.Namespace) -> int:
         except Exception:
             continue
 
-        modificado = False
         lineas = contenido.splitlines()
 
         for node in ast.walk(tree):

{context_map_ai-2.2.0 → context_map_ai-2.2.1}/context_map/application/commands/export.py

@@ -1,9 +1,8 @@
 """Comando de exportación portable (XML/JSON/Markdown) para chats web de LLMs."""
 
 import json
-from pathlib import Path
-from typing import Dict, List, Optional
 import xml.etree.ElementTree as ET
+from pathlib import Path
 from xml.dom import minidom
 
 from context_map.core.models import Node
@@ -16,7 +15,7 @@ from context_map.presentation.briefs.brief import generar_brief
 def exportar_contexto(
     project_path: Path,
     format_type: str = "xml",
-    output_file: Optional[Path] = None,
+    output_file: Path | None = None,
     brief_only: bool = False,
     model_name: str = "gpt-4o",
 ) -> Path:
@@ -42,7 +41,7 @@ def exportar_contexto(
         output_file = project_path / f"contextmap_export.{ext}"
 
     # Cargar nodos y edges del mapa
-    nodos: List[Node] = []
+    nodos: list[Node] = []
     edges: list = []
     graph_file = project_path / ".context-map" / "maps" / "graph.jsonl"
     edges_file = project_path / ".context-map" / "maps" / "edges.jsonl"
@@ -50,7 +49,7 @@ def exportar_contexto(
     if graph_file.exists():
         records = load_jsonl(str(graph_file))
         nodos = [Node.from_dict(r) for r in records if isinstance(r, dict)]
-    
+
     if edges_file.exists():
         edges = load_jsonl(str(edges_file))
 
@@ -87,7 +86,7 @@ def exportar_contexto(
         output_file.write_text(json.dumps(data_json, indent=2, ensure_ascii=False), encoding="utf-8")
 
     elif fmt == "markdown":
-        parts: List[str] = [
+        parts: list[str] = [
             f"# ContextMap Export: {project_path.name}",
             f"> **Target Model:** {model_name} | **Brief Tokens:** {tokens_brief} | **Nodes:** {len(nodos)}",
             "",

{context_map_ai-2.2.0 → context_map_ai-2.2.1}/context_map/application/commands/hook.py

@@ -2,9 +2,13 @@
 
 from __future__ import annotations
 
-from typing import Any, Dict
+from typing import Any
 
-from context_map.domain.ecosystem.hooks import PRE_COMMIT_SCRIPT, desinstalar_git_hooks, instalar_git_hooks
+from context_map.domain.ecosystem.hooks import (
+    PRE_COMMIT_SCRIPT,
+    desinstalar_git_hooks,
+    instalar_git_hooks,
+)
 
 
 def _script_hook() -> str:
@@ -22,7 +26,7 @@ def cmd_hook_install(args=None) -> None:
         print(f"[OK] Pre-commit hook de ContextMap instalado en: {target_dir}/.git/hooks/pre-commit")
 
 
-def cmd_hook(args: Dict[str, Any]) -> None:
+def cmd_hook(args: dict[str, Any]) -> None:
     """Manejador del comando CLI `ctxmap hook`.
 
     Args:

{context_map_ai-2.2.0 → context_map_ai-2.2.1}/context_map/application/commands/refresh.py

@@ -134,6 +134,7 @@ def cmd_refresh(args) -> None:
         if not quiet:
             try:
                 from pathlib import Path
+
                 from context_map.core.tokenization import TokenCounter
                 brief_p = Path(".context-map/CONTEXT.md")
                 if brief_p.exists():