higpertext-cli 0.8.0__py3-none-any.whl

config/router_content.json

@@ -0,0 +1,137 @@
+{
+  "ignore_patterns": [
+    ".git/",
+    ".venv/",
+    "node_modules/",
+    ".higpertext/",
+    ".memory/",
+    "__pycache__/",
+    "*.pyc",
+    ".pytest_cache/",
+    "*.log",
+    ""
+  ],
+  "assistant_ignore_files": {
+    "gemini":        [".geminiignore"],
+    "claude":        [".claudeignore"],
+    "opencode":      [".opencodeignore"],
+    "copilot":       [".copilotignore"],
+    "github-copilot":[".copilotignore"],
+    "antigravity":   [".antigravityignore"]
+  },
+  "gitignore_section": [
+    "",
+    "# higpertext Engine - archivos generados (no versionar)",
+    ".higpertext/",
+    ".claude/",
+    ".gemini/",
+    ".opencode/",
+    ".agents/",
+    ".memory/",
+    ".wiki/",
+    "CLAUDE.md",
+    "GEMINI.md",
+    "AGENTS.md",
+    "opencode.json",
+    ""
+  ],
+  "guide_specs": {
+    "gemini": {
+      "filename": "GEMINI.md",
+      "title": "# ♊ Google Gemini Guide",
+      "intro": [
+        "> Plantilla de Integración y Herramientas para Gemini",
+        "\n## Configuración",
+        "Las reglas de los perfiles se inyectarán directamente en `GEMINI.md` en la raíz del proyecto cuando uses el comando `profile load`."
+      ]
+    },
+    "antigravity": {
+      "filename": "AGENTS.md",
+      "title": "# 🚀 Antigravity Guide",
+      "intro": [
+        "> Plantilla de Integración y Herramientas para Antigravity",
+        "\n## Configuración",
+        "Las reglas de los perfiles se inyectarán en `AGENTS.md` y `.agents/rules/higpertext_rules.md` cuando uses el comando `profile load`."
+      ]
+    },
+    "claude": {
+      "filename": "CLAUDE.md",
+      "title": "# 🧊 Claude Code Guide",
+      "intro": [
+        "> Plantilla de Integración y Herramientas para Claude",
+        "\n## Configuración",
+        "Las reglas de los perfiles se inyectarán directamente en `CLAUDE.md` en la raíz del proyecto cuando uses el comando `profile load`."
+      ]
+    },
+    "opencode": {
+      "filename": "AGENTS.md",
+      "title": "# 🌐 OpenCode Guide",
+      "intro": [
+        "> Plantilla de Integración y Herramientas para OpenCode",
+        "\n## Integración",
+        "Las reglas del perfil se inyectarán en `.opencode/rules/`, los workflows se registrarán como agentes en `.opencode/agents/`, y se generará `AGENTS.md` al ejecutar `profile load`."
+      ]
+    },
+    "copilot": {
+      "filename": "AGENTS.md",
+      "title": "# 🤖 GitHub Copilot Guide",
+      "intro": [
+        "> Plantilla de Integración y Herramientas para GitHub Copilot",
+        "\n## Configuración",
+        "Las instrucciones del perfil se inyectarán en `.github/copilot-instructions.md` y `.github/instructions/` al ejecutar `profile load`."
+      ]
+    },
+    "github-copilot": {
+      "filename": "AGENTS.md",
+      "title": "# 🤖 GitHub Copilot Guide",
+      "intro": [
+        "> Plantilla de Integración y Herramientas para GitHub Copilot",
+        "\n## Configuración",
+        "Las instrucciones del perfil se inyectarán en `.github/copilot-instructions.md` y `.github/instructions/` al ejecutar `profile load`."
+      ]
+    },
+    "agent": {
+      "filename": "agent.md",
+      "title": "# 🤖 higpertext Open Agent",
+      "intro": [
+        "> Plantilla de Integración y Herramientas para Agentes Abiertos",
+        "\n## Guía General de Agente",
+        "Este archivo expone el catálogo general de herramientas."
+      ]
+    }
+  },
+  "profiles_section": [
+    "\n## 👤 Creación y Gestión de Perfiles",
+    "Este espacio comienza vacío para que puedas personalizar la personalidad y alcances de tu asistente IA.",
+    "\n### Cargar un rol predefinido del catálogo de higpertext:",
+    "`htx profile load <nombre> --assistant <gemini|claude|copilot|opencode>`",
+    "*(Roles disponibles: devsecops, sre, pwsh_engineer, ado_admin, agents_architect)*",
+    "\n### Crear tu propio perfil personalizado:",
+    "1. En el repositorio de higpertext Engine, crea un archivo `src/config/profiles/mi-perfil.json` con esta estructura:",
+    "```json",
+    "{",
+    "    \"name\": \"mi-perfil\",",
+    "    \"description\": \"Descripción de mi rol personalizado\",",
+    "    \"system_prompt\": \"Eres un asistente experto en...\",",
+    "    \"capabilities\": [\"common.memory-manager\", \"common.knowledge-asker\"],",
+    "    \"governance_access\": false",
+    "}",
+    "```",
+    "2. En la terminal de tu proyecto, ejecuta `htx profile load mi-perfil --assistant <asistente>` para inyectarlo.",
+    "\n---"
+  ],
+  "rules_section": [
+    "\n## ⚡ Reglas de Reducción de Tokens de Salida (CRÍTICO)",
+    "Para maximizar el rendimiento de tu asistente IA en este proyecto, sigue estas reglas:",
+    "1. **Sé conciso**: Elimina introducciones, saludos y explicaciones innecesarias.",
+    "2. **Diffs mínimos**: Muestra solo las líneas modificadas o el diff exacto al proponer cambios.",
+    "3. **Estructura limpia**: Usa viñetas o tablas en lugar de párrafos de prosa.",
+    "4. **Respuestas directas**: Responde directamente con comandos.",
+    "\n## 💾 Persistencia y Memoria por Proyecto",
+    "El orquestador higpertext guarda automáticamente un historial en `.memory/` cada vez que ejecutas un comando.",
+    "```powershell",
+    "htx task memory-manager --action \"Resolución Bug X\" --status success --notes \"Causa raíz: ... Solución: ...\"",
+    "```",
+    "\n---"
+  ]
+}

config/semantic_graph.json

@@ -0,0 +1,66 @@
+{
+  "ignore_folders": [
+    ".git", ".venv", "node_modules", ".higpertext",
+    ".memory", "__pycache__", ".agents",
+    "assets", "vendor", "static", "dist", "build"
+  ],
+  "ignore_suffixes": [
+    ".min.js", ".min.css", ".map",
+    ".png", ".jpg", ".jpeg", ".ico", ".gif", ".svg",
+    ".html", ".htm"
+  ],
+  "supported_suffixes": [
+    ".py", ".ps1", ".psm1",
+    ".js", ".jsx", ".ts", ".tsx",
+    ".json", ".md"
+  ],
+  "ignore_patterns": [
+    ".git", ".venv", "__pycache__", "node_modules", ".higpertext",
+    ".memory", "build", "dist", ".pytest_cache", ".agents",
+    "*.pyc", "*.pyo", "*.log", ".ignore", ".gitignore", ".geminiignore"
+  ],
+  "ignore_files": [".gitignore", ".ignore", ".geminiignore"],
+  "parser_map": {
+    ".py":   "python",
+    ".ps1":  "powershell",
+    ".psm1": "powershell",
+    ".js":   "typescript",
+    ".jsx":  "typescript",
+    ".ts":   "typescript",
+    ".tsx":  "typescript"
+  },
+  "paths": {
+    "capabilities_root": "src/higpertext/capabilities",
+    "profiles_root":     "src/config/profiles"
+  },
+  "description_max_length": 80,
+  "test_group_markers": ["test", "spec", "fixture", "__test__"],
+  "markdown": {
+    "graph_title": "Project Semantic Graph",
+    "graph_description": "This file summarizes the codebase modules, classes, functions, and dependencies. It is dynamically generated to help agents locate symbols with minimal token consumption.",
+    "section_overview":    "## Overview",
+    "section_layer_map":   "## Layer Map",
+    "section_entry_points":"## Entry Points",
+    "section_dep_graph":   "## Dependency Graph (Layer Level)",
+    "section_files_dir":   "## Files & Symbols Directory",
+    "section_caps_index":  "## Capabilities Index",
+    "section_profiles":    "## Profiles Index",
+    "caps_description":    "Tabla generada desde `src/capabilities/**/*.json`. Usa estos IDs con `htx task <id>`.",
+    "profiles_description":"Perfiles disponibles con sus capabilities habilitadas y hooks que activan.",
+    "caps_table_header":   "| ID | Description | Hook Task | Entrypoint |",
+    "caps_table_sep":      "|----|-------------|-----------|------------|",
+    "layer_table_header":  "| Layer | Files with symbols |",
+    "layer_table_sep":     "|-------|--------------------|"
+  },
+  "ranking": {
+    "base_tokens_per_symbol": 8,
+    "scores": {
+      "exact_name":        100,
+      "name_starts_with":   75,
+      "name_contains":      60,
+      "structural_fqn":     25,
+      "structural_file":    15,
+      "type_match":         10
+    }
+  }
+}

config/workflows/ado_release_flow.json

@@ -0,0 +1,38 @@
+{
+    "id": "workflow.ado-release-flow",
+    "name": "Ciclo Completo de Release en ADO",
+    "required_profile": "ado_admin",
+    "description": "Realiza commit de cambios locales con convención de Conventional Commits y registra la operación exitosa en la memoria del proyecto. La aprobación del PR es responsabilidad del humano revisor.",
+    "parameters": [
+        {
+            "name": "commit_msg",
+            "description": "Mensaje del commit (ej. 'feat: versión 5.1 release')",
+            "required": true
+        },
+        {
+            "name": "repo_id",
+            "description": "Nombre o identificador del repositorio destino",
+            "required": true
+        }
+    ],
+    "execution_chain": [
+        {
+            "step": 1,
+            "task": "committer",
+            "params": {
+                "message": "{commit_msg}",
+                "files": "."
+            },
+            "on_failure": "abort"
+        },
+        {
+            "step": 2,
+            "task": "memory-manager",
+            "params": {
+                "action": "Release ADO — {repo_id}",
+                "status": "success",
+                "notes": "Commit realizado en {repo_id}: {commit_msg}. PR pendiente de aprobación humana."
+            }
+        }
+    ]
+}

config/workflows/docs-update.json

@@ -0,0 +1,33 @@
+{
+    "id": "workflow.docs-update",
+    "name": "Actualización y Sincronización Automática de Documentación",
+    "required_profile": "global",
+    "description": "Escanea las definiciones JSON de capacidades y perfiles, regenera los archivos del catálogo de referencia en docs/ y registra la operación en la memoria del sistema.",
+    "parameters": [
+        {
+            "name": "notes",
+            "description": "Notas opcionales para registrar en la memoria del sistema.",
+            "required": false,
+            "default": "Sincronización automatizada de catálogos de documentación completada."
+        }
+    ],
+    "execution_chain": [
+        {
+            "step": 1,
+            "task": "docs-sync",
+            "params": {},
+            "on_failure": "abort"
+        },
+        {
+            "step": 2,
+            "task": "memory-manager",
+            "params": {
+                "action": "Docs Auto-Update",
+                "status": "success",
+                "notes": "{notes}",
+                "tags": "docs,governance,sync"
+            },
+            "on_failure": "continue"
+        }
+    ]
+}

config/workflows/governance-check.yaml

@@ -0,0 +1,26 @@
+id: workflow.governance-check
+name: "Governance Check"
+description: "Evalúa gobernanza en el scope indicado (commit/pr/deploy) y bloquea si hay violaciones críticas."
+required_profile: "any"
+
+parameters:
+  - name: scope
+    description: "Scope a evaluar: commit | pr | deploy"
+    required: true
+  - name: commit_message
+    description: "Mensaje de commit (para scope=commit)"
+    required: false
+    default: ""
+  - name: coverage_pct
+    description: "Cobertura actual % (para scope=pr o deploy)"
+    required: false
+    default: ""
+
+execution_chain:
+  - step: enforce
+    capability: "common.governance-enforcer"
+    params:
+      scope: "{{ scope }}"
+      commit_message: "{{ commit_message }}"
+      coverage_pct: "{{ coverage_pct }}"
+    on_failure: abort

config/workflows/guidelines-sync.json

@@ -0,0 +1,40 @@
+{
+    "id": "workflow.guidelines-sync",
+    "name": "Sincronización de Lineamientos de Gobernanza",
+    "required_profile": "global",
+    "description": "Descarga los lineamientos de gobernanza desde la fuente configurada (URL git o path local), actualiza el contrato central guidelines_contract.json, elimina el repositorio temporal si fue clonado, y registra la operación en memoria. La fuente se toma de HIGPERTEXT_GUIDELINES_SOURCE, environment.json[variables.guidelines_source] o del parámetro --source.",
+    "parameters": [
+        {
+            "name": "source",
+            "description": "URL git (https:// o git@) o path local con los lineamientos. Si se omite, usa HIGPERTEXT_GUIDELINES_SOURCE del entorno o el valor en environment.json.",
+            "required": false
+        },
+        {
+            "name": "notes",
+            "description": "Notas adicionales para registrar en memoria tras la sincronización.",
+            "required": false,
+            "default": "Lineamientos de gobernanza sincronizados exitosamente."
+        }
+    ],
+    "execution_chain": [
+        {
+            "step": 1,
+            "task": "guidelines-sync",
+            "params": {
+                "source": "{source}"
+            },
+            "on_failure": "abort"
+        },
+        {
+            "step": 2,
+            "task": "memory-manager",
+            "params": {
+                "action": "Sync Lineamientos de Gobernanza",
+                "status": "success",
+                "notes": "{notes}",
+                "tags": "governance,guidelines,sync"
+            },
+            "on_failure": "continue"
+        }
+    ]
+}

config/workflows/higpertext-build.json

@@ -0,0 +1,73 @@
+{
+    "id": "workflow.higpertext-build",
+    "name": "Validación en Caliente del Build",
+    "required_profile": "global",
+    "description": "Pipeline de validación completo tras escribir código: calidad → tests → seguridad → resolución automática de deuda. Encadena code-quality, code-coverage, vuln-resolver y quality-resolver en orden, abortando ante fallos críticos.",
+    "parameters": [
+        {
+            "name": "path",
+            "description": "Directorio o archivo a validar.",
+            "required": false,
+            "default": "."
+        },
+        {
+            "name": "min_coverage",
+            "description": "Cobertura mínima requerida (%). Default: 80.",
+            "required": false,
+            "default": "80"
+        },
+        {
+            "name": "output_report",
+            "description": "Nombre del reporte de calidad generado.",
+            "required": false,
+            "default": "build_quality_report.md"
+        }
+    ],
+    "execution_chain": [
+        {
+            "step": 1,
+            "task": "code-quality",
+            "params": {
+                "path": "{path}",
+                "output_report": "{output_report}",
+                "min_score": "100"
+            },
+            "on_failure": "continue"
+        },
+        {
+            "step": 2,
+            "task": "code-coverage",
+            "params": {
+                "min_coverage": "{min_coverage}"
+            },
+            "on_failure": "continue"
+        },
+        {
+            "step": 3,
+            "task": "vuln-resolver",
+            "params": {
+                "path": "{path}"
+            },
+            "on_failure": "continue"
+        },
+        {
+            "step": 4,
+            "task": "quality-resolver",
+            "params": {
+                "report": "{output_report}"
+            },
+            "on_failure": "continue"
+        },
+        {
+            "step": 5,
+            "task": "memory-manager",
+            "params": {
+                "action": "Build Validation",
+                "status": "success",
+                "notes": "Pipeline higpertext-build completado: calidad, cobertura y seguridad verificadas.",
+                "tags": "build,quality,coverage,security"
+            },
+            "on_failure": "continue"
+        }
+    ]
+}

config/workflows/higpertext-plan.json

@@ -0,0 +1,38 @@
+{
+    "id": "workflow.higpertext-plan",
+    "name": "Pre-chequeo y Apertura de Sesión",
+    "required_profile": "global",
+    "description": "Valida la integridad de las capacidades técnicas e inicializa la sesión cargando selectivamente las skills y subagentes indicados.",
+    "parameters": [
+        {
+            "name": "skills",
+            "description": "Lista de skills separadas por comas",
+            "required": false
+        },
+        {
+            "name": "subagents",
+            "description": "Lista de subagentes separados por comas",
+            "required": false
+        }
+    ],
+    "execution_chain": [
+        {
+            "step": 1,
+            "task": "higpertext-tester",
+            "params": {
+                "level": "smoke"
+            },
+            "on_failure": "abort"
+        },
+        {
+            "step": 2,
+            "task": "session-start",
+            "params": {
+                "action": "start",
+                "skills": "{skills}",
+                "subagents": "{subagents}"
+            },
+            "on_failure": "abort"
+        }
+    ]
+}

config/workflows/higpertext-review.json

@@ -0,0 +1,41 @@
+{
+    "id": "workflow.higpertext-review",
+    "name": "Certificación Final y Limpieza de la Sesión",
+    "required_profile": "global",
+    "description": "Verifica contratos del motor a nivel full, guarda los aprendizajes en la base de datos de memoria y desmonta la sesión temporal.",
+    "parameters": [
+        {
+            "name": "notes",
+            "description": "Notas y aprendizajes para la persistencia en memoria",
+            "required": true
+        }
+    ],
+    "execution_chain": [
+        {
+            "step": 1,
+            "task": "higpertext-tester",
+            "params": {
+                "level": "full"
+            },
+            "on_failure": "abort"
+        },
+        {
+            "step": 2,
+            "task": "memory-manager",
+            "params": {
+                "action": "Finalización de Sesión de Desarrollo",
+                "status": "success",
+                "notes": "{notes}"
+            },
+            "on_failure": "continue"
+        },
+        {
+            "step": 3,
+            "task": "session-clean",
+            "params": {
+                "action": "clean"
+            },
+            "on_failure": "continue"
+        }
+    ]
+}

config/workflows/pr-quality-check.json

@@ -0,0 +1,56 @@
+{
+    "id": "workflow.pr-quality-check",
+    "name": "Revisión Técnica de PR + Análisis de Calidad",
+    "required_profile": "ado_admin",
+    "description": "Ejecuta un análisis técnico completo sobre un Pull Request: primero genera el reporte de peer review (Clean Code, SOLID) y luego analiza la calidad del código del path afectado con score porcentual. El resultado es legible directamente por el usuario.",
+    "parameters": [
+        {
+            "name": "pr_id",
+            "description": "ID numérico del Pull Request a revisar en Azure DevOps.",
+            "required": true
+        },
+        {
+            "name": "path",
+            "description": "Path del código a analizar para el score de calidad (ej. src/ o un archivo específico).",
+            "required": true
+        },
+        {
+            "name": "min_score",
+            "description": "Umbral mínimo de calidad aceptable (0-100). Por defecto 70.",
+            "required": false,
+            "default": "70"
+        }
+    ],
+    "execution_chain": [
+        {
+            "step": 1,
+            "task": "pr-reviewer",
+            "params": {
+                "pr_id": "{pr_id}",
+                "output_report": "pr_review_{pr_id}.md"
+            },
+            "on_failure": "continue"
+        },
+        {
+            "step": 2,
+            "task": "code-quality",
+            "params": {
+                "path": "{path}",
+                "output_report": "code_quality_pr_{pr_id}.md",
+                "min_score": "{min_score}"
+            },
+            "on_failure": "continue"
+        },
+        {
+            "step": 3,
+            "task": "memory-manager",
+            "params": {
+                "action": "PR Quality Check #{pr_id}",
+                "status": "success",
+                "notes": "Revisión técnica y análisis de calidad completados para PR #{pr_id}. Reportes en .higpertext/reportes/.",
+                "tags": "pr-review,code-quality,governance"
+            },
+            "on_failure": "continue"
+        }
+    ]
+}

config/workflows/quality-remediation.json

@@ -0,0 +1,57 @@
+{
+    "id": "workflow.quality-remediation",
+    "name": "Plan de Remediación y Reducción Progresiva de Deuda",
+    "required_profile": "global",
+    "description": "Escanea el código para detectar violaciones a las compuertas de calidad, genera un reporte detallado y crea un plan de acción progresivo (TODO checklist) para resolver la deuda técnica paso a paso sin saturación de contexto.",
+    "parameters": [
+        {
+            "name": "path",
+            "description": "Directorio o archivo a escanear en busca de deuda técnica.",
+            "required": true
+        },
+        {
+            "name": "output_report",
+            "description": "Nombre del reporte de calidad resultante.",
+            "required": false,
+            "default": "code_quality_report.md"
+        },
+        {
+            "name": "todo_file",
+            "description": "Nombre del archivo de tareas progresivas resultante.",
+            "required": false,
+            "default": "remediation_todo.md"
+        }
+    ],
+    "execution_chain": [
+        {
+            "step": 1,
+            "task": "code-quality",
+            "params": {
+                "path": "{path}",
+                "output_report": "{output_report}",
+                "min_score": "100"
+            },
+            "on_failure": "continue"
+        },
+        {
+            "step": 2,
+            "task": "quality-resolver",
+            "params": {
+                "report": "{output_report}",
+                "todo_file": "{todo_file}"
+            },
+            "on_failure": "abort"
+        },
+        {
+            "step": 3,
+            "task": "memory-manager",
+            "params": {
+                "action": "Quality Remediation Plan",
+                "status": "success",
+                "notes": "Plan de remediación progresiva generado exitosamente en .higpertext/reportes/{todo_file}",
+                "tags": "quality,remediation,debt"
+            },
+            "on_failure": "continue"
+        }
+    ]
+}

higpertext/__init__.py

@@ -0,0 +1,18 @@
+"""High-level package exports for the higpertext package."""
+
+from higpertext.kernel import HigpertextEngine, get_htx_cmd, HTX_CMD, HTX_WORKFLOW_CMD
+from higpertext.hooks import HookRenderer, HookRegistry, SkillHookCompiler
+from higpertext.adapters import get_adapter_class
+from higpertext.kernel.application.telemetry import TelemetryAggregator
+
+__all__ = [
+    "HigpertextEngine",
+    "get_htx_cmd",
+    "HTX_CMD",
+    "HTX_WORKFLOW_CMD",
+    "HookRenderer",
+    "HookRegistry",
+    "SkillHookCompiler",
+    "get_adapter_class",
+    "TelemetryAggregator",
+]

higpertext/adapters/__init__.py

@@ -0,0 +1,27 @@
+"""Adapters package for Higpertext."""
+
+from higpertext.adapters.adapter_utils import (
+    HTX_CMD,
+    HTX_WORKFLOW_CMD,
+    load_session,
+    get_adapter_class,
+    delegation_rule_lines,
+    workflow_trigger_lines,
+)
+from higpertext.adapters.claude_adapter.claude_adapter import ClaudeAdapter
+from higpertext.adapters.gemini_adapter.gemini_adapter import GeminiAdapter
+from higpertext.adapters.copilot_adapter.copilot_adapter import CopilotAdapter
+from higpertext.adapters.open_code_adapter.open_code_adapter import OpenCodeAdapter
+
+__all__ = [
+    "HTX_CMD",
+    "HTX_WORKFLOW_CMD",
+    "load_session",
+    "get_adapter_class",
+    "delegation_rule_lines",
+    "workflow_trigger_lines",
+    "ClaudeAdapter",
+    "GeminiAdapter",
+    "CopilotAdapter",
+    "OpenCodeAdapter",
+]