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

{context_map_ai-2.0.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.0.0 → context_map_ai-2.2.0}/AGENTS.md

@@ -67,6 +67,8 @@ Cualquier agente que tome una tarea en este proyecto **DEBE** seguir estos pasos
    Inspeccionar `.context-map/vault-ContextMap/2.0-IDEAS/2.1-Ideas-Pendientes/` y `5.0-BACKLOG/5.1-Tareas.md`.
 6. **No Suponer Rutas o Lógica**:
    Inspeccionar el código fuente antes de formular hipótesis de cambio.
+7. **Captura Autónoma del Dominio**:
+   Al inicializar o ponerse en contexto en un proyecto, inspeccionar los submódulos de lógica nuclear (algoritmos, ecuaciones implícitas, reglas de negocio) y documentar lo descubierto en `7.0-MANUAL/DOMINIO.md` o en las notas del Vault, ejecutando `ctxmap refresh .` para que el brief y el Vault contengan el alma matemática y funcional del sistema.
 
 > ⚠️ **NUNCA respondas "¿qué quedó pendiente?" basándote solo en un documento
 > suelto (auditoría, CHANGELOG, docs/)** — cruza SIEMPRE el brief + backlog manual

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

@@ -5,6 +5,31 @@ 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
+
+### ✨ Nuevo — Suite de Inteligencia Offline, Tokenización Profesional & Protocolo Agéntico de Dominio
+
+- **🧮 Visualización Profesional de Tokenización**: Medición en tiempo real del presupuesto de tokens en consola CLI y tabla ejecutiva en `CONTEXT.md` mostrando >99% de ahorro de ventana de contexto respecto al código crudo.
+- **🦙 Integración Ollama Local Adaptativa (`infrastructure/integrations/ollama.py`)**: Conexión opcional a Ollama en `http://localhost:11434` sin costo de API ni internet.
+- **🖥️ Diagnóstico de RAM y Guardián de Hardware (`domain/health/hardware.py`)**: Evaluación previa de memoria RAM y CPU para recomendar modelos de bajo consumo (`qwen2.5-coder:1.5b` ~1.2 GB RAM) y conmutar a AST determinístico si la RAM es baja (<3.5 GB libres).
+- **✍️ Enriquecedor de Código Función por Función (`ctxmap enrich`)**: Comando CLI (`application/commands/enrich.py`) que audita y documenta funciones sin docstring en Español Técnico (Google Style).
+- **🏷️ Extractor de Conceptos TF-IDF (`domain/normalization/domain_extractor.py`)**: Descubrimiento determinístico local de términos de dominio del negocio (`FACTURACION`, `INVENTARIO`, `TCG`, `AUTENTICACION`).
+- **🧠 Protocolo Agéntico de Captura del Dominio (`AGENTS.md`)**: Protocolo estandarizado en reglas agénticas para que cualquier IA en el IDE (`Antigravity`, `Cursor`, `Claude`) interprete y documente automáticamente ecuaciones implícitas y reglas nucleares en `7.0-MANUAL/DOMINIO.md`.
+- **🎨 Grupos de Color del Graph View Profesionalizados (`common.py`)**: Grafo de Obsidian limpio y estructurado únicamente por las 8 secciones de dominio principales y tipos de nodos base.
+- **Suite de Pruebas**: 173/173 tests unitarios pasados al 100% verde.
+
 ---
 
 ## [2.0.0] — 2026-08-17

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: context-map-ai
-Version: 2.0.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.0.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.0.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.0.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.0.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.0.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.2.0/context_map/__tests__/test_ast_summary.py

@@ -0,0 +1,30 @@
+"""Pruebas unitarias para el módulo context_map.domain.analyzers.ast_summary."""
+
+import pytest
+from context_map.domain.analyzers.ast_summary import ASTSummaryExtractor
+
+
+def test_ast_summary_extractor_docstring() -> None:
+    """Verifica que si existe docstring de módulo se priorice en el resumen."""
+    codigo = '''"""Módulo principal de autenticación OAuth2 para ContextMap."""
+
+def login():
+    pass
+'''
+    extractor = ASTSummaryExtractor(codigo)
+    resumen = extractor.inferir_resumen()
+    assert "Módulo principal de autenticación OAuth2" in resumen
+
+
+def test_ast_summary_extractor_imports() -> None:
+    """Verifica la inferencia de propósito basada en las importaciones AST."""
+    codigo = """import requests
+import pytest
+
+def test_api():
+    res = requests.get('https://api.example.com')
+    assert res.status_code == 200
+"""
+    extractor = ASTSummaryExtractor(codigo)
+    resumen = extractor.inferir_resumen()
+    assert "cliente HTTP" in resumen or "pruebas" in resumen

{context_map_ai-2.0.0 → context_map_ai-2.2.0}/context_map/__tests__/test_conexiones.py

@@ -466,11 +466,12 @@ def test_grupos_grafo_por_tag_y_path() -> None:
             graph = json.load(f)
         grupos = {g["query"]: g for g in graph["colorGroups"]}
         assert "tag:#riesgo" in grupos
-        assert "tag:#DEVOPS" in grupos
+        assert "tag:#idea" in grupos
+        assert "tag:#documento" in grupos
         assert "path:4.0-RIESGOS" in grupos
         assert "path:7.0-MANUAL" in grupos
         # colores distintos para grupos distintos
-        assert grupos["tag:#riesgo"]["color"]["rgb"] != grupos["tag:#DEVOPS"]["color"]["rgb"]
+        assert grupos["tag:#riesgo"]["color"]["rgb"] != grupos["tag:#idea"]["color"]["rgb"]
     finally:
         shutil.rmtree(temp_dir, ignore_errors=True)
 

{context_map_ai-2.0.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_domain_extractor.py

@@ -0,0 +1,17 @@
+"""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
+
+
+def test_domain_concept_extractor() -> None:
+    """Verifica la extracción de términos de negocio dominantes."""
+    extractor = DomainConceptExtractor()
+    extractor.registrar_texto("FacturacionElectronicaService")
+    extractor.registrar_texto("procesar_facturacion")
+    extractor.registrar_texto("FacturacionDetalle")
+
+    conceptos = extractor.obtener_conceptos_dominantes(top_n=2)
+    assert len(conceptos) > 0
+    assert "FACTURACION" in conceptos[0]

context_map_ai-2.2.0/context_map/__tests__/test_hardware.py

@@ -0,0 +1,13 @@
+"""Pruebas unitarias para el módulo context_map.domain.health.hardware."""
+
+import pytest
+from context_map.domain.health.hardware import evaluar_hardware_pc, EspecificacionesHardware
+
+
+def test_evaluar_hardware_pc() -> None:
+    """Verifica que el diagnóstico de hardware retorne un objeto EspecificacionesHardware válido."""
+    hw = evaluar_hardware_pc()
+    assert isinstance(hw, EspecificacionesHardware)
+    assert hw.ram_total_gb > 0
+    assert hw.cpu_cores >= 1
+    assert hw.mensaje_diagnostico != ""

context_map_ai-2.2.0/context_map/__tests__/test_ollama.py

@@ -0,0 +1,14 @@
+"""Pruebas unitarias para el módulo context_map.infrastructure.integrations.ollama."""
+
+import pytest
+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)

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.2.0/context_map/__tests__/test_similarity.py

@@ -0,0 +1,41 @@
+"""Pruebas unitarias para el módulo context_map.domain.normalization.similarity."""
+
+import pytest
+from context_map.domain.normalization.similarity import (
+    distancia_levenshtein,
+    similitud_jaccard_ngramas,
+    son_textos_similares,
+    deduplicar_elementos_similares,
+)
+
+
+def test_distancia_levenshtein() -> None:
+    """Verifica el cálculo de distancia de edición."""
+    assert distancia_levenshtein("gato", "gato") == 0
+    assert distancia_levenshtein("casa", "caza") == 1
+
+
+def test_similitud_jaccard() -> None:
+    """Verifica el índice de similitud de Jaccard por n-gramas."""
+    sim = similitud_jaccard_ngramas("Falta de pruebas unitarias", "Falta de tests unitarios")
+    assert sim > 0.4
+
+
+def test_son_textos_similares() -> None:
+    """Verifica la detección de similitud difusa."""
+    t1 = "Falta de pruebas unitarias en el módulo de autenticación"
+    t2 = "Ausencia de pruebas unitarias en el módulo autenticación"
+    assert son_textos_similares(t1, t2, umbral=0.75)
+
+
+def test_deduplicar_elementos_similares() -> None:
+    """Verifica la deduplicación de listas por texto similar."""
+    items = [
+        "Riesgo 1: Falta de cobertura de pruebas unitarias",
+        "Riesgo 1: Ausencia de cobertura de pruebas unitarias",
+        "Riesgo 2: Vulnerabilidad de seguridad en dependencias",
+    ]
+    filtrados = deduplicar_elementos_similares(items, lambda x: x, umbral=0.75)
+    assert len(filtrados) == 2
+    assert filtrados[0] == items[0]
+    assert filtrados[1] == items[2]

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

@@ -29,6 +29,9 @@ from context_map.application.commands import (
     cmd_watch,
     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
@@ -119,6 +122,9 @@ def main() -> None:
         "adapt": cmd_adapt,
         "personal": cmd_personal,
         "export": cmd_export,
+        "enrich": cmd_enrich,
+        "pack": cmd_pack,
+        "unpack": cmd_unpack,
         "mcp": cmd_mcp,
     }
 

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

@@ -48,6 +48,11 @@ def create_parser() -> argparse.ArgumentParser:
         help="Arranca el servidor MCP (stdio) que expone las herramientas de ctxmap como tools",
     )
 
+    s_enrich = sub.add_parser("enrich", help="Enriquece el código con docstrings función por función usando Ollama local o AST")
+    s_enrich.add_argument("path", nargs="?", default=".", help="Ruta del archivo o directorio a enriquecer")
+    s_enrich.add_argument("--model", default=None, help="Modelo de Ollama preferido (ej. qwen2.5-coder:1.5b)")
+    s_enrich.add_argument("--dry-run", action="store_true", help="Solo muestra la vista previa sin modificar archivos")
+
     sub.add_parser("init", help="Crea estructura .context-map/")
 
     s_build = sub.add_parser("build", help="Genera vault completo")
@@ -201,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.0.0 → context_map_ai-2.2.0}/context_map/application/commands/__init__.py

@@ -32,8 +32,13 @@ from context_map.application.commands.tools import (
 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",
     "cmd_sync",

{context_map_ai-2.0.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.