higpertext-cli 0.8.0__tar.gz → 0.8.4__tar.gz

{higpertext_cli-0.8.0 → higpertext_cli-0.8.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: higpertext-cli
-Version: 0.8.0
+Version: 0.8.4
 Summary: higpertext Engine — LLM-powered terminal agent framework
 Author-email: Angel Ortega <codenodehg@gmail.com>
 License: Proprietary
@@ -21,8 +21,11 @@ Requires-Dist: pyyaml>=6.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: tqdm>=4.65.0
+Requires-Dist: pandas>=2.0.0
 Provides-Extra: gemini
 Requires-Dist: google-generativeai>=0.5.0; extra == "gemini"
+Provides-Extra: embeddings
+Requires-Dist: sentence-transformers>=3.0.0; extra == "embeddings"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == "dev"
 Requires-Dist: pytest-mock>=3.10.0; extra == "dev"

higpertext_cli-0.8.4/README.md

@@ -0,0 +1,112 @@
+# higpertext Engine
+
+**Framework de gobernanza activa para agentes IA.**
+
+higpertext controla el comportamiento de los asistentes IA (Claude, Gemini, OpenCode, Copilot) a través de perfiles, capacidades y hooks de runtime — no prompts.
+
+---
+
+## Instalación
+
+```bash
+pip install higpertext-cli
+```
+
+```bash
+htx --help
+```
+
+Con soporte Gemini:
+
+```bash
+pip install higpertext-cli[gemini]
+```
+
+---
+
+## Inicio rápido
+
+### 1. Inicializar el workspace
+
+```bash
+htx agent init --profile global --assistant claude
+```
+
+### 2. Cargar un perfil
+
+```bash
+htx profile load software_developer --assistant claude
+```
+
+### 3. Iniciar sesión
+
+```bash
+htx task common.session-start
+```
+
+### 4. Ejecutar una capacidad
+
+```bash
+htx task common.grep-search --pattern "class.*Service" --path src/
+htx task common.list-rules
+```
+
+### 5. Correr un workflow
+
+```bash
+htx workflow run higpertext-build
+```
+
+---
+
+## Comandos principales
+
+```bash
+# Agente
+htx agent init --assistant <claude|gemini|opencode|copilot>
+
+# Perfiles
+htx profile load <nombre> --assistant <asistente>
+htx profile install <nombre> --source <path>
+htx profile validate <nombre>
+
+# Capacidades
+htx task <namespace.capability> [--param valor]
+htx task common.list-rules
+
+# Sesión
+htx task common.session-start
+htx task common.session-clean
+
+# Workflows
+htx workflow run <nombre>
+
+# Diagnóstico
+htx task common.higpertext-tester
+```
+
+---
+
+## Asistentes soportados
+
+| Asistente | Configuración generada |
+|-----------|----------------------|
+| Claude Code | `CLAUDE.md`, `.claude/rules/`, hooks nativos |
+| Gemini | `GEMINI.md`, `.gemini/rules/` |
+| OpenCode | `AGENTS.md`, `.opencode/rules/` |
+| GitHub Copilot | `.github/copilot-instructions.md` |
+| Antigravity | `AGENTS.md`, `.agents/rules/` |
+
+---
+
+## Requisitos
+
+- Python >= 3.10
+- Un asistente IA compatible
+
+---
+
+## Documentación
+
+- [Guía de usuario](docs/external/README.md) — instalación, inicio rápido, referencia de comandos
+- [Documentación interna](docs/internal/README.md) — arquitectura, desarrollo de capacidades y agentes

{higpertext_cli-0.8.0 → higpertext_cli-0.8.4}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "higpertext-cli"
 authors = [{name = "Angel Ortega", email = "codenodehg@gmail.com"}]
-version = "0.8.0"
+version = "0.8.4"
 description = "higpertext Engine — LLM-powered terminal agent framework"
 requires-python = ">=3.10"
 license = {text = "Proprietary"}
@@ -28,12 +28,16 @@ dependencies = [
     "pydantic>=2.0.0",
     "rich>=13.0.0",
     "tqdm>=4.65.0",
+    "pandas>=2.0.0",
 ]
 
 [project.optional-dependencies]
 gemini = [
     "google-generativeai>=0.5.0",
 ]
+embeddings = [
+    "sentence-transformers>=3.0.0",
+]
 dev = [
     "pytest>=8.0.0",
     "pytest-mock>=3.10.0",
@@ -74,4 +78,3 @@ addopts = "-q --tb=short"
 
 [tool.black]
 line-length = 100
-

{higpertext_cli-0.8.0 → higpertext_cli-0.8.4}/src/config/adapters_config.json

@@ -9,7 +9,7 @@
       "",
       "## higpertext Engine — Contexto del Framework",
       "",
-      "Este archivo es generado por **higpertext Engine v5.0** al ejecutar `profile load`.",
+      "Este archivo es generado por **higpertext Engine v0.8.1** al ejecutar `profile load`.",
       "El archivo [`AGENTS.md`](AGENTS.md) contains the system prompt completo en formato multi-asistente.",
       "",
       "| Campo | Valor |",
@@ -21,7 +21,7 @@
       "| Custom slash commands | `.claude/commands/` (spec, plan, build, review) |",
       "",
       "> **Nota para Claude Code**: Los custom slash commands (`/spec`, `/plan`, `/build`, `/review`)",
-      "> requieren abrir VS Code desde el directorio `LLM-agent/`, no desde el directorio padre.",
+      "> requieren abrir VS Code desde la raíz del proyecto del agente, no desde el directorio padre.",
       "",
       "---",
       "",
@@ -117,7 +117,7 @@
       "```",
       "",
       "---",
-      "*higpertext Engine v5.0 — no editar manualmente.*"
+      "*higpertext Engine v0.8.1 — no editar manualmente.*"
     ]
   },
   "gemini": {
@@ -158,10 +158,10 @@
     "workflow_trigger_hint": "> When in doubt between a single capability and a workflow: **use the workflow**.",
     "operational_title": "## OPERATIONAL WORKFLOW (MANDATORY)",
     "operational_steps": [
-      "1. **RESEARCH** — Analyze the user request and identify the required capability ID.",
-      "2. **STRATEGY** — Propose a plan. If governance is involved, use `common.knowledge-asker` first.",
+      "1. **RESEARCH** — Analyze the user request, identify the required capability ID, and pin the expected runtime artifact/path. If the user names a path, start there.",
+      "2. **STRATEGY** — Use at most two targeted discovery calls before choosing a fix. If governance is involved, use `common.knowledge-asker` first.",
       "3. **EXECUTE** — Run the exact higpertext CLI command: `{htx_cmd} <id> --<param> <value>`.",
-      "4. **VALIDATE** — Ensure the output satisfies the TECHNICAL CONTRACT rules of the capability."
+      "4. **VALIDATE** — Ensure the output satisfies the TECHNICAL CONTRACT and the user-visible artifact/path."
     ],
     "token_rules_title": "## OUTPUT TOKEN REDUCTION (CRITICAL)",
     "token_rules": [
@@ -274,7 +274,7 @@
       "Usa este workflow con: `{htx_workflow_cmd} {wf_name}`",
       "Rules: `.github/rules/{wf_name}.md`",
       "",
-      "*higpertext Engine v5.0 — auto-generated.*"
+      "*higpertext Engine v0.8.1 — auto-generated.*"
     ],
     "agents_md_index": [
       "# {agent_name_upper} — higpertext Agent Workspace",
@@ -295,7 +295,7 @@
       "```",
       "",
       "---",
-      "*higpertext Engine v5.0 — no editar manualmente.*"
+      "*higpertext Engine v0.8.1 — no editar manualmente.*"
     ]
   },
   "opencode": {
@@ -326,7 +326,7 @@
       "```",
       "",
       "---",
-      "*higpertext Engine v5.0 — no editar manualmente.*"
+      "*higpertext Engine v0.8.1 — no editar manualmente.*"
     ],
     "agents_md_header": [
       "# {agent_name_upper} — higpertext Agent Workspace",

{higpertext_cli-0.8.0 → higpertext_cli-0.8.4}/src/config/app_config.json

@@ -1,10 +1,10 @@
 {
   "session": {
-    "default_assistant": "gemini",
+    "default_assistant": "antigravity",
     "default_profile": "ado_admin",
     "global_profile_names": ["global", "any", "all", ""],
-    "assistants": ["gemini", "claude", "copilot", "opencode", "github-copilot"],
-    "append_assistants": ["gemini", "copilot", "antigravity"]
+    "assistants": ["antigravity", "codex", "gemini", "claude", "copilot", "opencode", "github-copilot"],
+    "append_assistants": ["gemini", "copilot", "antigravity", "codex"]
   },
   "telemetry_reporter": {
     "box_width": 56,
@@ -74,7 +74,7 @@
   },
   "deployment": {
     "agent_json": "agent.json",
-    "playbooks": ["spec", "plan", "build", "review", "compact"],
+    "playbooks": ["spec", "plan", "build", "review"],
     "no_skills_message": "_No active session — run `session-start` to mount skills._",
     "no_subagents_message": "_No active session — run `session-start` to mount subagents._"
   },
@@ -82,7 +82,7 @@
     "ollama_base_url": "http://localhost:11434"
   },
   "context": {
-    "universal_skills": ["clean-code", "best-practices", "tdd-practices"],
+    "universal_skills": ["higpertext-guide"],
     "log_sep": "|||"
   },
   "docs": {
@@ -101,6 +101,7 @@
     "paths": {
       "gemini":      [".gemini/workflows",  ".gemini/skills",  ".gemini/agents"],
       "antigravity": [".agents/workflows",   ".agents/skills",  ".agents/agents"],
+      "codex":       [".higpertext/session/workflows", ".higpertext/session/skills", ".higpertext/session/subagents"],
       "claude":      [".claude/commands",    ".claude/skills",  ".claude/subagents"],
       "opencode":    [".opencode/agents",    ".opencode/skills",".opencode/subagents"],
       "copilot":     [".github/workflows",   ".github/skills",  ".github/subagents"]
@@ -109,6 +110,7 @@
       "claude":      ".claude/skills",
       "gemini":      ".gemini/skills",
       "antigravity": ".agents/skills",
+      "codex":       ".higpertext/session/skills",
       "opencode":    ".opencode/skills",
       "copilot":     ".github/skills"
     },
@@ -116,6 +118,7 @@
       "claude":      ".claude/subagents",
       "gemini":      ".gemini/subagents",
       "antigravity": ".agents/subagents",
+      "codex":       ".higpertext/session/subagents",
       "opencode":    ".opencode/subagents",
       "copilot":     ".github/subagents"
     },
@@ -124,27 +127,31 @@
       "claude":      ".claude",
       "copilot":     ".github",
       "opencode":    ".opencode",
-      "antigravity": ".agents"
+      "antigravity": ".agents",
+      "codex":       ".codex"
     },
     "display_names": {
       "gemini":      "Google Gemini",
       "claude":      "Claude Code",
       "copilot":     "GitHub Copilot",
       "opencode":    "OpenCode Assistant",
-      "antigravity": "Antigravity"
+      "antigravity": "Antigravity",
+      "codex":       "Codex"
     },
     "rules_destinations": {
       "claude":      ".claude/rules/session-capabilities.md",
       "opencode":    ".opencode/rules/session-capabilities.md",
       "gemini":      "GEMINI.md",
       "copilot":     ".github/copilot-instructions.md",
-      "antigravity": "AGENTS.md"
+      "antigravity": "AGENTS.md",
+      "codex":       "AGENTS.md"
     },
     "ignore_tools": ["Read", "Glob", "Grep", "WebFetch", "WebSearch"],
     "hooks_dirs": {
       "claude":        ".claude/hooks",
       "gemini":        ".gemini/hooks",
       "antigravity":   ".agents/hooks",
+      "codex":         ".codex/hooks",
       "opencode":      ".opencode/hooks",
       "copilot":       ".github/copilot/hooks",
       "github-copilot":".github/copilot/hooks"

{higpertext_cli-0.8.0 → higpertext_cli-0.8.4}/src/config/hooks/custom/test_output_limiter.json

@@ -2,7 +2,7 @@
   "id": "custom.test_output_limiter",
   "event": "PostToolUse",
   "matcher": "Bash|higpertext_task|higpertext_workflow",
-  "script": "src/hooks/custom/test_output_limiter.py",
+  "script": "src/config/hooks/custom/test_output_limiter.py",
   "timeout": 15,
   "priority": 10,
   "description": "Intercepta y limita la salida del test runner para evitar bloat en el contexto del LLM"

higpertext_cli-0.8.4/src/config/hooks/custom/test_output_limiter.py

@@ -0,0 +1,140 @@
+"""Hook PostToolUse: intercepta y limita la salida del test runner.
+
+Evita que tracebacks y logs largos saturen el contexto del LLM.
+- Éxito → reemplaza el output con una línea verde.
+- Fallo  → guarda traceback + git diff en .higpertext/reports/test_failure.md
+           y expone al LLM solo un resumen ligero con enlace al reporte.
+"""
+
+import json
+import subprocess
+import sys
+from pathlib import Path
+
+try:
+    from hook_io import get_project_root, read_payload
+except ImportError:
+
+    def get_project_root() -> Path:  # type: ignore[misc]
+        return Path.cwd()
+
+    def read_payload() -> dict:  # type: ignore[misc]
+        try:
+            return json.load(sys.stdin)
+        except Exception:
+            return {}
+
+
+_TEST_CAPABILITIES = {"common.test-resolver", "common.higpertext-tester"}
+_TEST_WORKFLOWS = {"testworkflow", "review"}
+_FAILURE_PATTERNS = {"failed", "failures", "errors", "error", "traceback", "exception"}
+_REPORT_REL = ".higpertext/reports/test_failure.md"
+
+
+def _is_test_run(tool_name: str, tool_input: dict) -> bool:
+    if tool_name == "Bash":
+        cmd = tool_input.get("command") or tool_input.get("CommandLine") or ""
+        return "pytest" in cmd or "python -m pytest" in cmd
+    if tool_name == "higpertext_task":
+        return tool_input.get("name", "") in _TEST_CAPABILITIES
+    if tool_name == "higpertext_workflow":
+        return tool_input.get("name", "") in _TEST_WORKFLOWS
+    return False
+
+
+def _has_failure(output: str, response: dict) -> bool:
+    lower = output.lower()
+    if any(p in lower for p in _FAILURE_PATTERNS):
+        return True
+    return response.get("metadata", {}).get("returncode", 0) != 0
+
+
+def _get_git_diff(project_root: Path) -> str:
+    try:
+        result = subprocess.run(
+            ["git", "diff"],
+            capture_output=True,
+            text=True,
+            cwd=str(project_root),
+            timeout=5,
+        )
+        return result.stdout or ""
+    except Exception as exc:
+        return f"No se pudo obtener git diff: {exc}"
+
+
+def _write_failure_report(report_file: Path, output: str, diff: str) -> None:
+    report_file.parent.mkdir(parents=True, exist_ok=True)
+    content = f"""# Reporte de Fallo de Pruebas Unitarias
+
+Generado por el hook `test_output_limiter` de higpertext.
+
+## Resumen del Fallo
+El test runner ha fallado durante la ejecución.
+
+## Output Original del Test (Traceback)
+```text
+{output}
+```
+
+## Cambios Activos (Git Diff)
+```diff
+{diff}
+```
+
+---
+*Usa `common.knowledge-asker` para consultar detalles de este reporte o consúltalo directamente.*
+"""
+    try:
+        report_file.write_text(content, encoding="utf-8")
+    except OSError:  # nosec B110
+        pass
+
+
+def main() -> None:
+    payload = read_payload()
+    if not payload:
+        print(json.dumps({"continue": True}))
+        return
+
+    tool_name: str = payload.get("tool_name", "")
+    tool_input: dict = payload.get("tool_input", {})
+    tool_response: dict = payload.get("tool_response", {})
+
+    if not _is_test_run(tool_name, tool_input):
+        print(json.dumps({"continue": True}))
+        return
+
+    output = tool_response.get("output", "") or tool_response.get("result", "") or ""
+    if not isinstance(output, str):
+        output = str(output)
+
+    if not _has_failure(output, tool_response):
+        print(json.dumps({
+            "continue": True,
+            "hookSpecificOutput": {
+                "replacementOutput": "[HIGPERTEXT TEST MONITOR] 🟢 All tests passed successfully."
+            },
+        }))
+        return
+
+    project_root = get_project_root()
+    report_file = project_root / _REPORT_REL
+    _write_failure_report(report_file, output, _get_git_diff(project_root))
+
+    link = f"file:///{report_file.as_posix()}"
+    summary = (
+        f"[HIGPERTEXT TEST MONITOR] 🔴 Tests failed.\n"
+        f"To avoid context bloat, the full traceback, error analysis, and the active git diff have been saved to:\n"
+        f"👉 [test_failure.md]({link})\n\n"
+        f"Use 'common.knowledge-asker' with a query like 'failure in test_file.py' to search the details "
+        f"of this failure dynamically, or read the file directly."
+    )
+    print(json.dumps({
+        "continue": True,
+        "hookSpecificOutput": {"replacementOutput": summary},
+    }))
+
+
+if __name__ == "__main__":
+    main()

higpertext_cli-0.8.4/src/config/profiles/agent_designer.json

@@ -0,0 +1,57 @@
+{
+  "name": "agent_designer",
+  "description": "Agent Designer — diseña y construye agentes higpertext externos, perfiles, capabilities y sus contratos técnicos. Incluye guía completa de creación paso a paso.",
+  "system_prompt": "Eres el Agent Designer experto del higpertext Engine. Tu misión es guiar al usuario para crear agentes externos completos, perfiles JSON válidos, capabilities con contratos técnicos y hooks — todo siguiendo los principios de bounded context, herencia de perfiles y principio de mínimo privilegio.\n\n---\n\n## CONOCIMIENTO BASE — ARQUITECTURA DE UN AGENTE\n\n### Estructura de directorios del agente generado\n```\nmi-agente/\n├── docs/                              ← documentación del agente\n├── src/\n│   ├── capabilities/                  ← capabilities propias del agente\n│   │   └── <namespace>/\n│   │       ├── mi-capability.json     ← definición + contrato técnico\n│   │       └── scripts/\n│   │           └── mi_script.py       ← lógica de ejecución\n│   ├── config/\n│   │   ├── profiles/\n│   │   │   ├── agent_designer.json    ← copiado automáticamente (NO editar)\n│   │   │   └── mi_perfil.json         ← TU perfil principal del agente\n│   │   ├── governance/                ← reglas y guardrails propios\n│   │   ├── templates/                 ← plantillas reutilizables\n│   │   └── hooks/\n│   │       ├── custom/                ← hooks activos siempre\n│   │       └── profiles/              ← hooks activos por perfil\n│   ├── hooks/\n│   │   ├── custom/                    ← scripts de hooks siempre activos\n│   │   └── profiles/<perfil>/         ← scripts de hooks por perfil\n│   ├── templates/\n│   │   ├── skills/<skill>/skill.json  ← skills para session_skills\n│   │   └── subagents/<sub>.json       ← subagentes para session_subagents\n│   └── workflows/\n│       └── mi-workflow.json            ← playbooks propios del agente\n├── tests/\n│   └── capabilities/<namespace>/      ← tests de capabilities propias\n```\n\n**Regla de oro**: el desarrollador solo toca `src/`. El directorio `.higpertext/` es generado automáticamente por el motor en runtime — nunca se versiona ni edita a mano.\n\n---\n\n## FLUJO DE CREACIÓN — PASO A PASO\n\n### PASO 1 — Crear el scaffolding del agente\n```bash\n# Desde el directorio del motor higpertext (LLM-agent/)\nhtx task common.agent-builder \\\n  --profile <nombre_perfil> \\\n  --target ../<nombre-agente> \\\n  --description \"Descripción del agente\"\n```\n\nEsto genera:\n- Estructura completa de `src/`\n- Launcher `htx.py` apuntando al motor central\n- Perfiles base incluyendo `agent_designer.json`\n- `.higpertext/` inicializado con hooks compilados\n- `semantic_graph.md` inicial\n\n> **Nombres RESERVADOS** — no usar como `--profile`:\n> `base_agent`, `agent_designer`, `global`, `base_developer`, `base_operator`, `base_auditor`\n\n### PASO 2 — Definir el perfil del agente\nCrea `src/config/profiles/<mi_perfil>.json`:\n```json\n{\n  \"name\": \"mi_perfil\",\n  \"description\": \"Descripción clara y concisa del rol del agente.\",\n  \"system_prompt\": \"Eres un experto en X. Tu misión principal es... Piensas antes de actuar: descompones la petición en su objetivo real, eliges el cambio mínimo correcto y verificas el resultado antes de concluir. Priorizas actuar sobre narrar.\",\n  \"capabilities\": [\n    \"common.grep-search\",\n    \"common.knowledge-asker\",\n    \"common.memory-manager\",\n    \"mi_namespace.mi-capability\"\n  ],\n  \"governance_access\": false,\n  \"rules\": [\n    \"Regla de comportamiento específica del dominio.\",\n    \"Nunca hardcodees secretos ni credenciales.\",\n    \"Documenta cambios en APIs públicas en el mismo PR.\"\n  ],\n  \"session_skills\": [\"best-practices\"],\n  \"session_subagents\": []\n}\n```\n\n#### Campos del perfil — referencia completa\n| Campo | Tipo | Requerido | Descripción |\n|---|---|---|---|\n| `name` | string | ✅ | Identificador único del perfil (snake_case) |\n| `description` | string | ✅ | Descripción del rol para catálogo |\n| `system_prompt` | string | ✅ | Instrucciones base del agente LLM |\n| `capabilities` | array | ✅ | IDs de capabilities disponibles (`namespace.id`) |\n| `governance_access` | boolean | ✅ | `true` solo para agentes de auditoría/compliance |\n| `rules` | array | ❌ | Reglas de comportamiento adicionales |\n| `session_skills` | array | ❌ | Skills cargados automáticamente al iniciar sesión |\n| `session_subagents` | array | ❌ | Subagentes disponibles en sesión |\n| `subprofiles` | array | ❌ | Perfiles que se incluyen como subperfil (ej: `agent_designer`) |\n| `hooks` | object | ❌ | Hooks globales del motor a activar |\n| `model_preference` | string | ❌ | Modelo preferido: `any`, `claude`, `gemini`, etc. |\n\n### PASO 3 — Crear una capability propia\n\n#### Estructura de archivos\n```\nsrc/capabilities/<namespace>/\n├── mi-capability.json\n└── scripts/\n    └── mi_script.py\n```\n\n#### `mi-capability.json` — esquema completo\n```json\n{\n  \"id\": \"mi_namespace.mi-capability\",\n  \"version\": \"1.0.0\",\n  \"name\": \"Mi Capability\",\n  \"description\": \"Descripción clara de qué hace esta capability.\",\n  \"entrypoint\": \"src/capabilities/mi_namespace/scripts/mi_script.py\",\n  \"language\": \"python\",\n  \"parameters\": [\n    {\n      \"name\": \"input\",\n      \"description\": \"Texto de entrada a procesar.\",\n      \"required\": true\n    },\n    {\n      \"name\": \"output_format\",\n      \"description\": \"Formato de salida: json | text.\",\n      \"required\": false,\n      \"default\": \"text\"\n    }\n  ],\n  \"contract\": {\n    \"rules\": [\n      \"Debe validar que --input no esté vacío.\",\n      \"Debe emitir [SUCCESS] al finalizar correctamente.\",\n      \"Debe emitir [ERROR] con mensaje descriptivo ante fallos.\",\n      \"Nunca debe exponer variables de entorno ni secrets en el output.\"\n    ],\n    \"success_pattern\": \"\\\\[SUCCESS\\\\]\"\n  },\n  \"examples\": [\n    {\n      \"description\": \"Uso básico\",\n      \"command\": \"htx task mi_namespace.mi-capability --input \\\"valor\\\"\"\n    }\n  ],\n  \"related_docs\": [\n    \"docs/guides/mi-capability.md\"\n  ]\n}\n```\n\n#### `mi_script.py` — plantilla base\n```python\nimport argparse\nimport sys\n\n\ndef parse_args() -> argparse.Namespace:\n    parser = argparse.ArgumentParser(description=\"Mi Capability Script\")\n    parser.add_argument(\"--input\", required=True, help=\"Texto de entrada\")\n    parser.add_argument(\"--output_format\", default=\"text\", choices=[\"json\", \"text\"])\n    return parser.parse_args()\n\n\ndef main() -> None:\n    args = parse_args()\n\n    if not args.input.strip():\n        print(\"[ERROR] --input no puede estar vacío\", file=sys.stderr)\n        sys.exit(1)\n\n    # --- lógica principal aquí ---\n    resultado = args.input.upper()\n    # --- fin de lógica ---\n\n    print(f\"[SUCCESS] Resultado: {resultado}\")\n\n\nif __name__ == \"__main__\":\n    main()\n```\n\n### PASO 4 — Agregar hooks propios (opcional)\n\n#### Tipos de hooks por carpeta\n| Ubicación | Alcance |\n|---|---|\n| `src/config/hooks/profiles/<perfil>/` | Solo activo cuando ese perfil está cargado |\n| `src/config/hooks/custom/` | Activo siempre, sin restricción de perfil |\n\n#### Esquema de un hook JSON\n```json\n{\n  \"id\": \"custom.mi_hook\",\n  \"event\": \"PreToolUse\",\n  \"matcher\": \"Bash\",\n  \"script\": \"src/config/hooks/custom/mi_hook.py\",\n  \"timeout\": 10,\n  \"priority\": 2,\n  \"override\": false,\n  \"description\": \"Bloquea comandos destructivos antes de ejecutar Bash\"\n}\n```\n\n#### Eventos disponibles para hooks\n| Evento | Cuándo se dispara |\n|---|---|\n| `PreToolUse` | Antes de que el LLM ejecute una herramienta |\n| `PostToolUse` | Después de que la herramienta termina |\n| `PreAgentStart` | Al iniciar el agente |\n| `SessionEnd` | Al cerrar la sesión |\n\n### PASO 5 — Recompilar el ambiente\nDespués de cambiar perfiles, hooks o configuración:\n```bash\n# Recompilar desde el motor\nhtx agent init --profile mi_perfil --target ../mi-agente\n\n# Ver estado actual del agente\nhtx agent status --target ../mi-agente\n\n# Limpiar sesión sin borrar configuración\nhtx agent clean --target ../mi-agente\n```\n\n### PASO 6 — Registrar y sincronizar el agente externo\n```bash\n# Registrar el agente en el motor\nhtx task common.agent-sync --action register \\\n  --name mi-agente \\\n  --path ../mi-agente \\\n  --profile mi_perfil\n\n# Sincronizar hooks y perfiles actualizados\nhtx task common.agent-sync --action sync \\\n  --name mi-agente \\\n  --assistant claude\n\n# Listar todos los agentes registrados\nhtx task common.agent-sync --action list\n```\n\n### PASO 7 — Cargar el perfil en el asistente\n```bash\n# Regenerar catálogo de documentación\nhtx task common.docs-sync\n\n# Cargar el perfil en Claude\nhtx profile load mi_perfil --assistant claude\n\n# Cargar el perfil en Gemini\nhtx profile load mi_perfil --assistant gemini\n```\n\n---\n\n## CAPABILITIES DEL MOTOR — CATÁLOGO DE REFERENCIA\n\nEstas capabilities del motor están disponibles para incluir en cualquier perfil:\n\n### Exploración y búsqueda\n| ID | Descripción breve |\n|---|---|\n| `common.grep-search` | Búsqueda de patrones en código/texto con filtros avanzados |\n| `common.smart-read` | Lectura segura de archivos sin saturar el contexto |\n| `common.file-map` | Mapeo de estructura de archivos trackeados |\n| `common.search-router` | Recomienda la capability de búsqueda correcta según la intención |\n| `common.error-context-locator` | Extrae file:line desde trazas de error |\n\n### Memoria y conocimiento\n| ID | Descripción breve |\n|---|---|\n| `common.memory-manager` | Persiste aprendizajes y acciones en `.memory/` |\n| `common.knowledge-asker` | Consulta base de conocimiento de gobernanza y minutas |\n\n### Gestión de sesión\n| ID | Descripción breve |\n|---|---|\n| `common.session-start` | Inicializa sesión con skills, subagentes y playbooks |\n| `common.session-clean` | Cierra sesión y desmonta recursos efímeros |\n| `common.list-rules` | Lista capabilities disponibles para el perfil activo |\n| `common.load-rules` | Carga reglas detalladas de capabilities al contexto del LLM |\n\n### Construcción de agentes\n| ID | Descripción breve |\n|---|---|\n| `common.agent-builder` | Crea scaffolding completo de un nuevo agente externo |\n| `common.agent-sync` | Registra y sincroniza agentes externos con el motor |\n| `common.subagent-executor` | Lanza ejecución aislada de un subagente especializado |\n| `common.sync-agents` | Propaga reglas y perfiles hacia carpetas del asistente IA |\n\n### Calidad y código\n| ID | Descripción breve |\n|---|---|\n| `common.code-skeletonizer` | Genera esqueleto de código sin implementación (ahorra tokens) |\n| `common.diff-reviewer` | Review de cambios git enfocado en Clean Code y SOLID |\n| `common.higpertext-tester` | Suite de validación e integridad del motor |\n| `common.eval-agent` | Framework de evaluación de modelos y configuración |\n\n### Documentación\n| ID | Descripción breve |\n|---|---|\n| `common.docs-sync` | Regenera catálogos de capabilities y perfiles |\n| `common.context-budget-report` | Estima consumo de contexto antes de ejecutar |\n| `common.hook-health` | Valida que los hooks estén registrados y funcionen |\n\n### Git\n| ID | Descripción breve |\n|---|---|\n| `git.committer` | Commit siguiendo Conventional Commits con push opcional |\n| `git.diff` | Muestra cambios locales en el repositorio Git |\n\n---\n\n## SKILLS DISPONIBLES — REFERENCIA\n\n| Skill ID | Categoría | Contenido |\n|---|---|---|\n| `higpertext-guide` | core | Guía completa del ecosistema CLI, delegación de comandos y análisis del proyecto |\n| `agent-design-standards` | agents | Single Responsibility, contratos de capability, tool minimalism, governance by profile |\n| `agent-builder-guide` | agents | Flujo de 7 pasos para construir agentes: scaffolding, perfil, capabilities, hooks, sync y carga |\n| `capability-validator` | agents | Validaciones de capability JSON, contratos técnicos, perfiles y hooks con checklists accionables |\n| `best-practices` | development | Docstrings, protección de secrets, cobertura de tests ≥ 80% |\n| `clean-code` | development | Principios SOLID, Clean Code, funciones ≤ 30 líneas |\n| `tdd-practices` | development | Test-Driven Development, cobertura y pirámide de tests |\n| `ddd-standards` | architecture | Domain-Driven Design, bounded contexts, agregados |\n\n---\n\n## PRINCIPIOS DE DISEÑO — REGLAS CRÍTICAS\n\n1. **Single Responsibility**: Cada agente tiene UN dominio claramente definido. Nunca crees un 'god agent'.\n2. **Mínimo privilegio**: Incluye solo las capabilities estrictamente necesarias para el rol.\n3. **Contratos técnicos**: Toda capability debe definir `contract.rules` con éxitos y fallos explícitos.\n4. **Governance by profile**: Un agente solo accede a capabilities listadas en su perfil.\n5. **Subagente por subtarea**: Delega tareas especializadas a subagentes en lugar de ampliar el scope del agente principal.\n6. **Nunca hardcodear rutas absolutas**: Usa siempre paths relativos al proyecto.\n7. **Verificar antes de referenciar**: Antes de incluir una capability en un perfil, confirma que su JSON existe en `src/higpertext/capabilities/` del motor o en `src/capabilities/` del agente.\n\n---\n\n## QUÉ NO HACER — ANTI-PATRONES\n\n| Acción | Razón |\n|---|---|\n| Copiar `src/core/` del motor | Rompe la modularidad — usa el launcher `htx.py` |\n| Editar `.higpertext/` a mano | Es estado compilado, se sobreescribe en cada `agent init` |\n| Usar nombres reservados como perfil | El motor los bloquea con error |\n| Modificar `src/config/hooks/global/` | Es exclusivo del motor higpertext |\n| Editar `agent_designer.json` del agente | Se sobreescribe en cada `agent init` |\n| Usar `governance_access: true` sin necesidad | Solo para agentes de auditoría/compliance |\n| Incluir capabilities no verificadas | Provoca errores en runtime al intentar cargar el perfil |\n\n---\n\n## WORKFLOW DE DISEÑO — PROTOCOLO ESTÁNDAR\n\nAntes de crear cualquier agente o perfil, sigue este orden:\n1. **Identificar el dominio** → ¿Cuál es la responsabilidad única del agente?\n2. **Listar capabilities necesarias** → `htx task common.list-rules` para ver disponibles\n3. **Verificar existencia** → Confirma que cada capability existe en el catálogo\n4. **Crear scaffolding** → `htx task common.agent-builder --profile X --target ../Y`\n5. **Definir perfil JSON** → `src/config/profiles/mi_perfil.json`\n6. **Crear capabilities propias** → Solo si la funcionalidad no existe en el motor\n7. **Registrar y sincronizar** → `htx task common.agent-sync --action register ...`\n8. **Cargar perfil** → `htx profile load mi_perfil --assistant claude`\n9. **Regenerar docs** → `htx task common.docs-sync`\n\n---\n\nPiensas de forma estructurada: descompones la petición en su objetivo real, propones una sola estrategia justificada en una línea, y verificas el resultado antes de concluir. Priorizas actuar sobre narrar.",
+  "capabilities": [
+    "common.agent-builder",
+    "common.agent-sync",
+    "common.grep-search",
+    "common.smart-read",
+    "common.knowledge-asker",
+    "common.list-rules",
+    "common.load-rules",
+    "common.memory-manager",
+    "common.truth-keeper",
+    "common.file-map",
+    "common.docs-sync",
+    "common.session-start",
+    "common.session-clean",
+    "common.hook-health",
+    "common.context-budget-report",
+    "common.eval-agent",
+    "common.sync-agents",
+    "common.subagent-executor",
+    "common.error-context-locator",
+    "common.search-router",
+    "common.env-catalog",
+    "common.env-runner",
+    "common.env-status",
+    "common.env-logs",
+    "common.env-stop",
+    "common.env-clean",
+    "common.env-template",
+    "common.project-explainer"
+  ],
+  "governance_access": false,
+  "rules": [
+    "Siempre conoces la estructura de un agente higpertext: src/capabilities/, src/config/profiles/, src/workflows/, src/config/hooks/.",
+    "Guías al usuario con el flujo completo: agent-builder → perfil JSON → capabilities → hooks → agent-sync → profile load.",
+    "Antes de referenciar una capability en un perfil, verifica que su JSON exista en src/higpertext/capabilities/ del motor o src/capabilities/ del agente.",
+    "Nunca hardcodees rutas absolutas — usa siempre paths relativos al proyecto.",
+    "Los nombres reservados (base_agent, agent_designer, global, base_developer, base_operator, base_auditor) no pueden usarse como nombre de perfil.",
+    "Los hooks globales del motor no se modifican — solo src/config/hooks/profiles/ y src/config/hooks/custom/ del agente.",
+    "Siempre propón un perfil con el mínimo de capabilities necesarias para el rol (principio de mínimo privilegio).",
+    "Todo capability creada debe incluir un contrato técnico (contract.rules) con patrones de éxito y error explícitos.",
+    "Después de crear o modificar perfiles y capabilities, recomienda ejecutar htx task common.docs-sync para regenerar el catálogo."
+  ],
+  "session_skills": [
+    "agent-design-standards",
+    "higpertext-guide",
+    "best-practices",
+    "agent-builder-guide",
+    "capability-validator"
+  ],
+  "session_subagents": [
+    "architect"
+  ]
+}

{higpertext_cli-0.8.0 → higpertext_cli-0.8.4}/src/config/profiles/base_agent.json

@@ -8,6 +8,7 @@
     "common.list-rules",
     "common.load-rules",
     "common.memory-manager",
+    "common.truth-keeper",
     "common.session-start",
     "common.session-clean",
     "common.agent-builder"
@@ -16,11 +17,11 @@
     "agent_designer"
   ],
   "rules": [
-    "Siempre conoces la estructura de un agente higpertext: src/capabilities/, src/config/profiles/, src/workflows/, src/hooks/.",
+    "Siempre conoces la estructura de un agente higpertext: src/capabilities/, src/config/profiles/, src/workflows/, src/config/hooks/.",
     "Puedes guiar al usuario para crear un perfil JSON válido, definir capabilities y configurar hooks.",
     "Nunca hardcodees rutas absolutas — usa paths relativos al proyecto.",
     "Antes de sugerir una capability, verifica que exista en src/capabilities/ del agente o del motor.",
-    "Los hooks globales no se modifican — solo los de src/hooks/profiles/ y src/hooks/custom/."
+    "Los hooks globales no se modifican — solo los de src/config/hooks/profiles/ y src/config/hooks/custom/."
   ],
   "hooks": {
     "global": [

{higpertext_cli-0.8.0 → higpertext_cli-0.8.4}/src/config/profiles/global.json

@@ -4,13 +4,12 @@
     "model_preference": "any",
     "capabilities": [
         "common.memory-manager",
+        "common.truth-keeper",
         "common.knowledge-asker",
         "common.sync-agents",
-        "common.wiki-manager",
         "common.subagent-executor",
         "common.session-start",
         "common.session-clean",
-        "common.guidelines-sync",
         "common.docs-sync",
         "common.grep-search",
         "common.smart-read",
@@ -27,7 +26,11 @@
         "common.env-clean",
         "common.env-template",
         "common.list-rules",
-        "common.load-rules"
+        "common.load-rules",
+        "common.project-explainer"
+    ],
+    "session_skills": [
+        "higpertext-guide"
     ],
     "system_prompt": "Herramientas transversales de gestión de memoria, base de conocimiento y auditoría del sistema."
 }

{higpertext_cli-0.8.0 → higpertext_cli-0.8.4}/src/config/router_content.json

@@ -15,6 +15,7 @@
     "gemini":        [".geminiignore"],
     "claude":        [".claudeignore"],
     "opencode":      [".opencodeignore"],
+    "codex":         [".codexignore"],
     "copilot":       [".copilotignore"],
     "github-copilot":[".copilotignore"],
     "antigravity":   [".antigravityignore"]
@@ -26,6 +27,7 @@
     ".claude/",
     ".gemini/",
     ".opencode/",
+    ".codex/",
     ".agents/",
     ".memory/",
     ".wiki/",
@@ -54,6 +56,15 @@
         "Las reglas de los perfiles se inyectarán en `AGENTS.md` y `.agents/rules/higpertext_rules.md` cuando uses el comando `profile load`."
       ]
     },
+    "codex": {
+      "filename": "AGENTS.md",
+      "title": "# Codex Guide",
+      "intro": [
+        "> Plantilla de Integración y Herramientas para Codex",
+        "\n## Configuración",
+        "Las reglas de los perfiles se inyectarán en `AGENTS.md` y `.codex/rules/higpertext_rules.md` cuando uses el comando `profile load`."
+      ]
+    },
     "claude": {
       "filename": "CLAUDE.md",
       "title": "# 🧊 Claude Code Guide",
@@ -104,7 +115,7 @@
     "\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>`",
+    "`htx profile load <nombre> --assistant <codex|gemini|claude|copilot|opencode|antigravity>`",
     "*(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:",