six-hats 0.1.0__tar.gz

six_hats-0.1.0/.cursor/mcp.json

@@ -0,0 +1,39 @@
+{
+  "mcpServers": {
+    "sequential-thinking": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "--silent",
+        "@modelcontextprotocol/server-sequential-thinking"
+      ]
+    },
+    "sixhats-filesystem": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "--silent",
+        "@modelcontextprotocol/server-filesystem",
+        "/home/pablo/Escritorio/SIX HATS"
+      ]
+    },
+    "duckdb": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "--silent",
+        "mcp-duckdb-local"
+      ]
+    },
+    "six-hats": {
+      "command": "/home/pablo/Escritorio/SIX HATS/.venv/bin/six-hats",
+      "args": [
+        "mcp"
+      ],
+      "env": {
+        "PYTHONIOENCODING": "utf-8",
+        "PYTHONPATH": "/home/pablo/Escritorio/SIX HATS/src"
+      }
+    }
+  }
+}

six_hats-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,35 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  pypi-publish:
+    name: Publicar en PyPI
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # Obligatorio para Trusted Publishing (OIDC) en PyPI
+      contents: read
+    environment:
+      name: pypi
+      url: https://pypi.org/p/six-hats
+
+    steps:
+      - name: Checkout código
+        uses: actions/checkout@v4
+
+      - name: Instalar uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Construir paquetes de distribución
+        run: uv build
+
+      - name: Publicar en PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+          skip-existing: true

six_hats-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,45 @@
+name: CI Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - name: Checkout código
+        uses: actions/checkout@v4
+
+      - name: Instalar uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Configurar Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Instalar dependencias
+        run: |
+          uv venv --python ${{ matrix.python-version }}
+          uv pip install -e ".[dev]"
+
+      - name: Ejecutar suite de pruebas
+        run: |
+          source .venv/bin/activate
+          pytest tests/ -v
+
+      - name: Verificar CLI y exportación de herramientas
+        run: |
+          source .venv/bin/activate
+          six-hats --help
+          six-hats export-tools --format openai
+          six-hats export-tools --format hermes-chatml

six_hats-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+# Entornos virtuales
+.venv/
+env/
+venv/
+ENV/
+
+# Python cache y compilados
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Pruebas y cobertura
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+lcov.info
+
+# Empaquetado y distribución
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# IDEs y editores
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store

six_hats-0.1.0/.mcp.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "six-hats": {
+      "command": "uvx",
+      "args": [
+        "--from",
+        "git+https://github.com/elpabloultron/six-hats.git",
+        "six-hats",
+        "mcp"
+      ]
+    }
+  }
+}

six_hats-0.1.0/.pre-commit-hooks.yaml

@@ -0,0 +1,15 @@
+- id: six-hats-review
+  name: Six Hats Code Review
+  description: Ejecuta la revisión de código multifacética de los Seis Sombreros
+  entry: six-hats review
+  language: python
+  types: [text]
+  stages: [pre-commit]
+
+- id: six-hats-ponytail
+  name: Ponytail Anti-Overengineering Audit
+  description: Audita código aplicando la Escalera de la Pereza contra sobreingeniería
+  entry: six-hats ponytail
+  language: python
+  types: [text]
+  stages: [pre-commit]

six_hats-0.1.0/.vscode/mcp.json

@@ -0,0 +1,39 @@
+{
+  "mcpServers": {
+    "sequential-thinking": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "--silent",
+        "@modelcontextprotocol/server-sequential-thinking"
+      ]
+    },
+    "sixhats-filesystem": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "--silent",
+        "@modelcontextprotocol/server-filesystem",
+        "/home/pablo/Escritorio/SIX HATS"
+      ]
+    },
+    "duckdb": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "--silent",
+        "mcp-duckdb-local"
+      ]
+    },
+    "six-hats": {
+      "command": "/home/pablo/Escritorio/SIX HATS/.venv/bin/six-hats",
+      "args": [
+        "mcp"
+      ],
+      "env": {
+        "PYTHONIOENCODING": "utf-8",
+        "PYTHONPATH": "/home/pablo/Escritorio/SIX HATS/src"
+      }
+    }
+  }
+}

six_hats-0.1.0/CLAUDE.md

@@ -0,0 +1,70 @@
+# Directrices de Claude Code para el Repositorio Six Hats
+
+Este proyecto implementa la metodología de los **Seis Sombreros para Pensar** (*Six Thinking Hats*) de Edward de Bono aplicada a la ingeniería de software, arquitectura de sistemas y revisión de código forense.
+
+Como asistente que opera a través de **Claude Code**, debes integrar metódicamente esta disciplina analítica en cada interacción, diagnóstico y propuesta de cambio.
+
+---
+
+## Servidor MCP y Herramientas Disponibles
+
+El servidor MCP `six-hats` está configurado y accesible. Si ejecutas en un entorno nuevo, puedes añadirlo con:
+```bash
+claude mcp add six-hats uvx --from git+https://github.com/elpabloultron/six-hats.git six-hats mcp
+```
+
+### Catálogo de Herramientas MCP
+1. `six_hats_review(code_diff: str, task_context: str = "", is_diff: bool = false)`:
+   - Ejecuta la deliberación paralela de los 6 sombreros.
+   - Provee telemetría AST, complejidad ciclomática de McCabe, complejidad cognitiva de SonarSource, índice de mantenibilidad, análisis adversarial de seguridad (CWE/OWASP), cálculo de entropía de Shannon, trampas de rendimiento $O(n^2)$, filtro anti-sobreingeniería Ponytail y parche unificado de mitigación.
+2. `six_hats_debate(architecture_proposal: str)`:
+   - Confronta dialécticamente una propuesta entre el Sombrero Negro (Riesgos/Costos ocultos) y el Sombrero Verde (Innovación/Disrupción), con síntesis del Sombrero Azul.
+3. `six_hats_quick_check(code_diff: str)`:
+   - Chequeo rápido de la tríada crítica: Hechos (Blanco), Riesgos (Negro) y Valor (Amarillo).
+4. `six_hats_ponytail_audit(code: str, threshold: float = 25.0)`:
+   - Auditoría estricta contra la Escalera de la Pereza de Ponytail para extirpar sobreingeniería, capas especulativas y clases innecesarias.
+
+---
+
+## Protocolo de Razonamiento de los Seis Sombreros
+
+Cuando analices código, resuelvas incidencias o propongas diseños arquitectónicos, estructura tu respuesta respetando las perspectivas:
+
+- ⚪ **[Sombrero Blanco] (Hechos y Telemetría):** Apóyate en datos empíricos, métricas estáticas, complejidad ciclomática y cobertura real. Prohibido especular sin evidencia.
+- 🟢 **[Sombrero Verde] (Innovación Lateral):** Genera alternativas disruptivas (estructuras zero-copy, paradigmas funcionales inmutables o arquitecturas reactivas desacopladas). Explica siempre el *trade-off* de cada alternativa.
+- ⚫ **[Sombrero Negro] (Juicio Crítico y Seguridad):** Identifica puntos únicos de fallo, condiciones de carrera, vectores de inyección y riesgos operacionales con severidad (CRITICAL, HIGH, MEDIUM, LOW).
+- 🟡 **[Sombrero Amarillo] (Valor y Eficiencia):** Modela los beneficios tangibles, reducciones de latencia, optimizaciones de throughput y viabilidad operativa.
+- 🔴 **[Sombrero Rojo] (DX y Ergonomía Ponytail):** Evalúa la legibilidad del código a las 3:00 AM, la carga cognitiva y aplica el principio de la Escalera de la Pereza para podar abstracciones innecesarias.
+- 🔵 **[Sombrero Azul] (Orquestación y Síntesis):** Emite el veredicto ejecutivo final, mitiga los riesgos críticos y genera parches limpios y aplicables.
+
+---
+
+## Estándares Lingüísticos y Ortotipográficos (RAE / Chile)
+
+1. **Jerarquía de comillas:** Usa comillas angulares (`« »`) como comillas primarias; comillas inglesas (`" "`) solo dentro de citas; comillas simples (`' '`) en tercer nivel.
+2. **Puntuación exterior:** Los signos de puntuación van siempre fuera de las comillas de cierre: `«ejemplo», «ejemplo».`
+3. **Signos dobles obligatorios:** Abre siempre con `¿` e `¡` y cierra con `?` y `!`. Jamás agregues punto tras `?` o `!`.
+4. **Raya de inciso (`—`):** Pegada a la palabra inicial y final del inciso (`palabra —inciso— palabra`).
+5. **Cifras y porcentajes:** Espacio obligatorio antes del símbolo `%` (`100 %`, `25 %`). Usa coma decimal para cifras en español (`0,45`).
+6. **Titulares:** Los encabezados y títulos no llevan punto final.
+
+---
+
+## Comandos Frecuentes de Desarrollo
+
+- **Ejecutar pruebas unitarias:**
+  ```bash
+  .venv/bin/pytest tests/ -v
+  ```
+- **Auditoría de sobreingeniería con CLI:**
+  ```bash
+  .venv/bin/six-hats ponytail <archivo> --threshold 25.0
+  ```
+- **Revisión completa con reporte SARIF:**
+  ```bash
+  .venv/bin/six-hats review <archivo> --sarif reporte.sarif
+  ```
+- **Exportar esquemas para agentes:**
+  ```bash
+  .venv/bin/six-hats export-tools --format [openai|hermes|claude|mcp]
+  ```

six_hats-0.1.0/GEMINI.md

@@ -0,0 +1,61 @@
+# Marco de Trabajo: Metodología de los Seis Sombreros para Pensar (Edward de Bono)
+
+Este espacio de trabajo está diseñado para la deliberación estratégica, la toma de decisiones complejas, el análisis multifactorial y la resolución de problemas mediante la técnica sistemática de los **Seis Sombreros para Pensar** (*Six Thinking Hats*), integrando rigor forense, creatividad y análisis de riesgos.
+
+---
+
+## Estructura de los Seis Sombreros
+
+```mermaid
+graph TD
+    Azul["🔵 Sombrero Azul: Control, Orquestación y Síntesis"]
+    Blanco["⚪ Sombrero Blanco: Datos y Hechos"]
+    Rojo["🔴 Sombrero Rojo: Emociones e Intuición"]
+    Negro["⚫ Sombrero Negro: Riesgos y Cautela"]
+    Amarillo["🟡 Sombrero Amarillo: Oportunidades y Beneficios"]
+    Verde["🟢 Sombrero Verde: Creatividad e Innovación"]
+
+    Azul --> Blanco
+    Azul --> Rojo
+    Azul --> Negro
+    Azul --> Amarillo
+    Azul --> Verde
+    Blanco & Rojo & Negro & Amarillo & Verde --> Azul
+```
+
+### 1. ⚪ Sombrero Blanco (Objetividad y Evidencia)
+- **Foco:** Datos duros, cifras cuantitativas, documentos verificados, registros oficiales y lagunas de información.
+- **Preguntas guía:** ¿Qué información fehaciente tenemos? ¿Qué datos nos faltan? ¿Cómo los conseguimos de manera fidedigna?
+- **Prohibición:** Cero especulaciones, juicios de valor o interpretaciones sesgadas.
+
+### 2. 🔴 Sombrero Rojo (Emoción e Intuición)
+- **Foco:** Sentimientos, corazonadas, reacciones viscerales del público o stakeholders, tono emocional y clima de opinión.
+- **Preguntas guía:** ¿Qué me dice el instinto ante esta situación? ¿Cómo reaccionará emocionalmente la comunidad o la contraparte?
+- **Premisa:** No requiere justificación racional ni lógica probatoria.
+
+### 3. ⚫ Sombrero Negro (Juicio Crítico y Cautela)
+- **Foco:** Identificación de riesgos, vulnerabilidades jurídicas o éticas, posibles fallos, escenarios adversos y costos ocultos.
+- **Preguntas guía:** ¿Por qué podría fallar esta iniciativa? ¿Qué riesgos legales, penales o reputacionales corremos? ¿Dónde están los puntos ciegos?
+- **Premisa:** Crítica constructiva e implacable basada en el principio de precaución.
+
+### 4. 🟡 Sombrero Amarillo (Optimismo Constructivo y Valor)
+- **Foco:** Beneficios, oportunidades, ventajas comparativas, rentabilidad social o institucional y viabilidad positiva.
+- **Preguntas guía:** ¿Cuáles son las mayores fortalezas de esta idea? ¿Cuál es el impacto positivo más ambicioso alcanzable?
+- **Premisa:** Optimismo fundamentado en razones lógicas de viabilidad.
+
+### 5. 🟢 Sombrero Verde (Creatividad y Pensamiento Lateral)
+- **Foco:** Alternativas disruptivas, hipótesis audaces, caminos no explorados y superación de obstáculos mediante ingenio.
+- **Preguntas guía:** ¿Qué enfoque totalmente diferente no se ha intentado? ¿Cómo podemos transformar un obstáculo en una ventaja?
+- **Premisa:** Libertad creativa sin juzgar la viabilidad de forma prematura.
+
+### 6. 🔵 Sombrero Azul (Control Metacognitivo y Síntesis)
+- **Foco:** Gestión de la agenda de deliberación, selección del sombrero activo, balanceo del debate y compilación del plan de acción final.
+- **Preguntas guía:** ¿Qué sombrero corresponde utilizar ahora? ¿Cuál es la conclusión ejecutiva tras recorrer las distintas perspectivas?
+
+---
+
+## Protocolo Operativo del Agente en SIX HATS
+
+1. **Activación de Pensamiento Secuencial:** Se utiliza el servidor MCP `sequential-thinking` para registrar los pasos reflexivos y alternar metódicamente entre perspectivas.
+2. **Registro de Rondas:** En cada sesión o problema planteado, se documentarán las intervenciones identificando explícitamente el sombrero activo (`[⚪ Blanco]`, `[⚫ Negro]`, `[🟢 Verde]`, etc.).
+3. **Regla de Cierre:** Toda deliberación concluye obligatoriamente bajo el **Sombrero Azul** con un dictamen de síntesis, matriz de riesgos mitigados y hoja de ruta con próximos pasos concretos.

six_hats-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Six Hats Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.