higpertext-cli 0.8.0__py3-none-any.whl

higpertext/capabilities/common/env-stop.json

@@ -0,0 +1,14 @@
+{
+  "id": "common.env-stop",
+  "version": "1.0.0",
+  "name": "Environment Stop",
+  "description": "Detiene un entorno local iniciado por env-runner.",
+  "entrypoint": "capabilities/common/scripts/env_stop.py",
+  "language": "python",
+  "parameters": [
+    {"name": "run_id", "description": "Run a detener.", "required": true},
+    {"name": "volumes", "description": "Eliminar volúmenes. Default: false.", "required": false, "default": "false"},
+    {"name": "json", "description": "Emite JSON estructurado.", "required": false, "default": "false"}
+  ],
+  "contract": {"rules": ["Debe ejecutar compose down para el run.", "Debe actualizar estado a stopped o failed."]}
+}

higpertext/capabilities/common/env-template.json

@@ -0,0 +1,14 @@
+{
+  "id": "common.env-template",
+  "version": "1.0.0",
+  "name": "Environment Template",
+  "description": "Crea, valida o muestra templates locales de entornos Docker/Podman.",
+  "entrypoint": "capabilities/common/scripts/env_template.py",
+  "language": "python",
+  "parameters": [
+    {"name": "action", "description": "validate, show o create.", "required": true},
+    {"name": "template", "description": "ID del template.", "required": true},
+    {"name": "json", "description": "Emite JSON estructurado.", "required": false, "default": "false"}
+  ],
+  "contract": {"rules": ["Debe crear templates bajo .higpertext/env/templates.", "Debe validar templates locales o globales.", "Debe soportar JSON para show/validate."]}
+}

higpertext/capabilities/common/error-context-locator.json

@@ -0,0 +1,23 @@
+{
+  "id": "common.error-context-locator",
+  "version": "1.0.0",
+  "name": "Error Context Locator",
+  "description": "Extrae file:line desde trazas, errores o logs y devuelve contexto mínimo con sugerencias de smart-read focalizado.",
+  "entrypoint": "capabilities/common/scripts/error_context_locator.py",
+  "language": "python",
+  "parameters": [
+    {"name": "error", "description": "Texto del error o traza.", "required": false},
+    {"name": "error_file", "description": "Archivo con error/log a analizar.", "required": false},
+    {"name": "max_context", "description": "Líneas alrededor de cada ubicación. Default: 5.", "required": false, "default": "5"},
+    {"name": "include_tests", "description": "Incluye ubicaciones de tests. Default: true.", "required": false, "default": "true"},
+    {"name": "json", "description": "Emite JSON estructurado.", "required": false, "default": "false"}
+  ],
+  "contract": {
+    "rules": [
+      "Debe detectar patrones Python File path, line N y file:line genéricos.",
+      "Debe devolver contexto mínimo por ubicación detectada.",
+      "Debe sugerir common.smart-read con around_line para cada ubicación.",
+      "Debe soportar error inline, error_file, include_tests y JSON."
+    ]
+  }
+}

higpertext/capabilities/common/eval-agent.json

@@ -0,0 +1,33 @@
+{
+    "id": "common.eval-agent",
+    "version": "1.0.0",
+    "description": "Ejecuta el framework de evaluación de modelos y configuración del higpertext Engine. Valida que los archivos generados contienen las secciones correctas, que los hooks responden bien y que el modelo se comporta según el perfil.",
+    "entrypoint": "capabilities/common/scripts/eval_agent.py",
+    "parameters": [
+        {
+            "name": "profile",
+            "description": "Perfil higpertext a evaluar. Usa 'all' para evaluar todos los perfiles.",
+            "required": false,
+            "default": "all"
+        },
+        {
+            "name": "mode",
+            "description": "Modo de evaluación: static (sin API) | hooks (sin API) | behavioral (API) | safety (API) | all",
+            "required": false,
+            "default": "static"
+        },
+        {
+            "name": "provider",
+            "description": "Provider LLM para modos behavioral/safety: gemini | anthropic",
+            "required": false,
+            "default": ""
+        }
+    ],
+    "contract": {
+        "rules": [
+            "Retorna exit code 0 si todos los tests pasan, 1 si hay fallos.",
+            "Los modos behavioral y safety requieren RUN_BEHAVIORAL_TESTS=1.",
+            "El modo static y hooks no requieren API keys y siempre deben pasar."
+        ]
+    }
+}

higpertext/capabilities/common/file-map.json

@@ -0,0 +1,17 @@
+{
+  "id": "common.file-map",
+  "version": "1.0.0",
+  "name": "File Map",
+  "description": "Inspecciona estructura de archivos trackeados sin leer blobs: directorios, extensiones y archivos grandes candidatos a smart-read/skeleton.",
+  "entrypoint": "capabilities/common/scripts/file_map.py",
+  "language": "python",
+  "parameters": [
+    {"name": "path", "description": "Ruta/prefijo a mapear.", "required": false},
+    {"name": "preset", "description": "Reservado para filtros: all, code, docs, config.", "required": false, "default": "all"},
+    {"name": "max_depth", "description": "Profundidad máxima de agrupación. Default: 2.", "required": false, "default": "2"},
+    {"name": "show_sizes", "description": "Reservado para mostrar tamaños detallados.", "required": false, "default": "false"},
+    {"name": "large_threshold_kb", "description": "Umbral de archivo grande. Default: 100.", "required": false, "default": "100"},
+    {"name": "json", "description": "Emite JSON estructurado.", "required": false, "default": "false"}
+  ],
+  "contract": {"rules": ["Debe usar git ls-files para evitar dependencias/generados.", "Debe reportar directorios, extensiones y archivos grandes.", "Debe sugerir smart-read para archivos grandes."]}
+}

higpertext/capabilities/common/governance-exception.json

@@ -0,0 +1,54 @@
+{
+    "id": "common.governance-exception",
+    "version": "1.0.0",
+    "name": "Governance Exception",
+    "description": "Registra o lista excepciones aprobadas a reglas de gobernanza para un perfil.",
+    "entrypoint": "capabilities/common/scripts/governance_exception.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "action",
+            "type": "string",
+            "required": true,
+            "description": "Acción: register | list"
+        },
+        {
+            "name": "rule_id",
+            "type": "string",
+            "required": false,
+            "description": "ID de la regla a exceptuar (requerido para register)"
+        },
+        {
+            "name": "reason",
+            "type": "string",
+            "required": false,
+            "description": "Justificación de la excepción"
+        },
+        {
+            "name": "approver",
+            "type": "string",
+            "required": false,
+            "description": "Quien aprueba la excepción"
+        },
+        {
+            "name": "expires",
+            "type": "string",
+            "required": false,
+            "description": "Fecha de expiración ISO (YYYY-MM-DD)"
+        },
+        {
+            "name": "profile",
+            "type": "string",
+            "required": false,
+            "description": "Perfil al que aplica (por defecto el activo)"
+        }
+    ],
+    "contract": {
+        "rules": [
+            "No puede exceptuar reglas de severidad critical.",
+            "Toda excepción debe tener reason y approver.",
+            "Las excepciones expiradas no se aplican aunque existan en el store."
+        ],
+        "required_patterns": ["\\[SUCCESS\\]"]
+    }
+}

higpertext/capabilities/common/graph-query.json

@@ -0,0 +1,59 @@
+{
+    "id": "common.graph-query",
+    "version": "1.0.0",
+    "name": "Graph Query",
+    "description": "Consulta el grafo semántico para encontrar símbolos relacionados con un nombre o keyword, expandiendo vecinos hasta una profundidad configurable y permitiendo filtrar, limitar o emitir resultados compactos.",
+    "entrypoint": "capabilities/common/scripts/graph_query.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "symbol",
+            "description": "Nombre o keyword del símbolo a buscar (búsqueda parcial, case-insensitive).",
+            "required": true
+        },
+        {
+            "name": "depth",
+            "description": "Profundidad de expansión de vecinos en el grafo. Default: 2.",
+            "required": false,
+            "default": "2"
+        },
+        {
+            "name": "budget",
+            "description": "Presupuesto de tokens para el resultado. Default: 8000.",
+            "required": false,
+            "default": "8000"
+        },
+        {
+            "name": "type",
+            "description": "Filtra por tipo de símbolo: class, function, method, variable o module.",
+            "required": false
+        },
+        {
+            "name": "limit",
+            "description": "Máximo de símbolos a mostrar. Default: 50.",
+            "required": false,
+            "default": "50"
+        },
+        {
+            "name": "files_only",
+            "description": "Si es true, muestra solo archivos únicos relacionados.",
+            "required": false,
+            "default": "false"
+        },
+        {
+            "name": "json",
+            "description": "Si es true, emite JSON estructurado.",
+            "required": false,
+            "default": "false"
+        }
+    ],
+    "contract": {
+        "rules": [
+            "Debe leer .higpertext/state/semantic_graph.json. Si no existe, indicar que hay que ejecutar common.graph-rebuild primero.",
+            "Debe mostrar cada símbolo con su archivo, línea y tipo.",
+            "Debe soportar filtro por tipo, límite de resultados, modo files_only y salida JSON.",
+            "Debe indicar el total de símbolos retornados y tokens estimados.",
+            "Debe completar con [SUCCESS] o [NOT FOUND] explícito."
+        ]
+    }
+}

higpertext/capabilities/common/graph-rebuild.json

@@ -0,0 +1,31 @@
+{
+    "id": "common.graph-rebuild",
+    "version": "1.0.0",
+    "name": "Graph Rebuild",
+    "description": "Regenera el grafo semántico del proyecto parseando todos los archivos Python con AST. Persiste el resultado en .higpertext/state/semantic_graph.json y actualiza el resumen en .higpertext/state/semantic_graph.md.",
+    "entrypoint": "capabilities/common/scripts/graph_rebuild.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "root",
+            "description": "Directorio raíz del proyecto a analizar. Por defecto el directorio actual.",
+            "required": false,
+            "default": "."
+        },
+        {
+            "name": "god_threshold",
+            "description": "Umbral de in-degree para clasificar un nodo como god node. Default: 5.",
+            "required": false,
+            "default": "5"
+        }
+    ],
+    "contract": {
+        "rules": [
+            "Debe generar .higpertext/state/semantic_graph.json con campos symbols y relations.",
+            "Debe imprimir el total de símbolos y relaciones indexados al finalizar.",
+            "Debe indicar cuántos god nodes fueron detectados.",
+            "Nunca debe exponer contenido de archivos .env o secrets.",
+            "Debe completar con [SUCCESS] o [ERROR] explícito."
+        ]
+    }
+}

higpertext/capabilities/common/graph-visualize.json

@@ -0,0 +1,37 @@
+{
+    "id": "common.graph-visualize",
+    "version": "1.0.0",
+    "name": "Graph Visualize",
+    "description": "Genera un grafo HTML interactivo con D3.js a partir del semantic_graph.json. El archivo se guarda en .higpertext/reports/semantic_graph.html y se puede abrir en el navegador.",
+    "entrypoint": "capabilities/common/scripts/graph_visualize.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "output",
+            "description": "Ruta de salida del archivo HTML. Default: .higpertext/reports/semantic_graph.html.",
+            "required": false,
+            "default": ".higpertext/reports/semantic_graph.html"
+        },
+        {
+            "name": "max_nodes",
+            "description": "Límite de nodos a renderizar para evitar grafos ilegibles. Default: 200.",
+            "required": false,
+            "default": "200"
+        },
+        {
+            "name": "god_threshold",
+            "description": "Umbral de in-degree para resaltar god nodes en rojo. Default: 5.",
+            "required": false,
+            "default": "5"
+        }
+    ],
+    "contract": {
+        "rules": [
+            "Debe leer .higpertext/state/semantic_graph.json. Si no existe, indicar que hay que ejecutar common.graph-rebuild primero.",
+            "Debe generar un archivo HTML self-contained (sin dependencias externas — D3 embebido o CDN).",
+            "Debe resaltar god nodes visualmente (color distinto).",
+            "Debe indicar la ruta del archivo generado al finalizar.",
+            "Debe completar con [SUCCESS] o [ERROR] explícito."
+        ]
+    }
+}

higpertext/capabilities/common/grep-search.json

@@ -0,0 +1,176 @@
+{
+    "id": "common.grep-search",
+    "version": "1.0.0",
+    "name": "Grep Search",
+    "description": "Busca patrones de texto, código o símbolos del grafo semántico Nexus/Higpertext. Soporta búsqueda recursiva, presets, filtros glob/extensión, exclusiones, priorización por relevancia, límites por archivo/línea/tamaño, contexto, modo regex, conteo por archivo y salida JSON estructurada.",
+    "entrypoint": "capabilities/common/scripts/grep_search.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "pattern",
+            "description": "Patrón de búsqueda (texto literal o regex si --regex=true).",
+            "required": true
+        },
+        {
+            "name": "path",
+            "description": "Directorio o archivo donde buscar. Por defecto el directorio actual.",
+            "required": false,
+            "default": "."
+        },
+        {
+            "name": "include",
+            "description": "Filtro de extensión de archivo, ej: '*.py' o '*.ts'. Acepta múltiples separados por coma.",
+            "required": false
+        },
+        {
+            "name": "extension",
+            "description": "Alias ergonómico de include. Acepta 'py,ts' o '*.py,*.ts'.",
+            "required": false
+        },
+        {
+            "name": "exclude",
+            "description": "Patrones de directorios o archivos a excluir, ej: '__pycache__,node_modules,.venv'. Por defecto excluye .venv, __pycache__, .git, node_modules.",
+            "required": false
+        },
+        {
+            "name": "regex",
+            "description": "Si es 'true', trata el patrón como expresión regular. Default: false (literal).",
+            "required": false,
+            "default": "false"
+        },
+        {
+            "name": "case_sensitive",
+            "description": "Si es 'true', la búsqueda distingue mayúsculas. Default: false.",
+            "required": false,
+            "default": "false"
+        },
+        {
+            "name": "context",
+            "description": "Número de líneas de contexto antes y después de cada coincidencia. Default: 0.",
+            "required": false,
+            "default": "0"
+        },
+        {
+            "name": "before",
+            "description": "Líneas antes de cada coincidencia. Se combina con context usando el valor mayor.",
+            "required": false
+        },
+        {
+            "name": "after",
+            "description": "Líneas después de cada coincidencia. Se combina con context usando el valor mayor.",
+            "required": false
+        },
+        {
+            "name": "max_results",
+            "description": "Límite máximo de resultados a mostrar. Default: 100.",
+            "required": false,
+            "default": "100"
+        },
+        {
+            "name": "max_per_file",
+            "description": "Límite máximo de coincidencias mostradas por archivo. Default: 20.",
+            "required": false,
+            "default": "20"
+        },
+        {
+            "name": "line_limit",
+            "description": "Caracteres máximos por línea impresa; 0 desactiva truncado. Default: 240.",
+            "required": false,
+            "default": "240"
+        },
+        {
+            "name": "max_file_size_kb",
+            "description": "Ignora archivos mayores al tamaño indicado; 0 desactiva. Default: 1024.",
+            "required": false,
+            "default": "1024"
+        },
+        {
+            "name": "sort",
+            "description": "Orden de resultados: relevance prioriza archivos con más hits; path ordena por ruta. Default: relevance.",
+            "required": false,
+            "default": "relevance"
+        },
+        {
+            "name": "preset",
+            "description": "Preset de búsqueda si no se pasa include/extension: all, code, python, web, docs o config. Default: all.",
+            "required": false,
+            "default": "all"
+        },
+        {
+            "name": "include_tests",
+            "description": "Incluye rutas de tests/specs. Default: true.",
+            "required": false,
+            "default": "true"
+        },
+        {
+            "name": "source_first",
+            "description": "Prioriza archivos fuente antes que tests al ordenar. Default: true.",
+            "required": false,
+            "default": "true"
+        },
+        {
+            "name": "files_only",
+            "description": "Si es 'true', solo muestra los nombres de archivos con coincidencias, sin el contenido.",
+            "required": false,
+            "default": "false"
+        },
+        {
+            "name": "count",
+            "description": "Si es 'true', muestra el conteo de coincidencias por archivo sin contenido de líneas.",
+            "required": false,
+            "default": "false"
+        },
+        {
+            "name": "semantic",
+            "description": "Si es 'true', busca también en el grafo semántico Nexus/Higpertext (.higpertext/state/semantic_graph.json o .nexus/semantic_graph.*).",
+            "required": false,
+            "default": "false"
+        },
+        {
+            "name": "json",
+            "description": "Si es 'true', emite una respuesta JSON estructurada para consumo por otras herramientas nativas.",
+            "required": false,
+            "default": "false"
+        },
+        {
+            "name": "absolute_paths",
+            "description": "Si es 'true', muestra rutas absolutas; por defecto usa rutas relativas para ahorrar contexto.",
+            "required": false,
+            "default": "false"
+        },
+        {
+            "name": "all",
+            "description": "Si es 'true', busca también en directorios de agentes/configuración normalmente excluidos; mantiene exclusiones seguras para .git, .venv, node_modules, binarios y secretos.",
+            "required": false,
+            "default": "false"
+        }
+    ],
+    "contract": {
+        "rules": [
+            "Debe usar grep (Linux/macOS) o el equivalente Python puro como fallback multiplataforma.",
+            "Debe mostrar resultados agrupados por archivo con número de línea y contenido de la línea.",
+            "Debe indicar el total de coincidencias encontradas al finalizar.",
+            "Si no hay coincidencias, debe indicarlo claramente con [NOT FOUND].",
+            "Si el patrón no es válido como regex (cuando regex=true), debe reportar el error.",
+            "Debe respetar el límite de max_results para evitar output excesivo.",
+            "Debe rechazar context negativo y max_results menor o igual a cero.",
+            "Debe aceptar --extension como alias de --include normalizando extensiones simples a globs.",
+            "Debe aceptar presets de búsqueda cuando no se indique include/extension.",
+            "Debe soportar límites por archivo, longitud de línea y tamaño máximo de archivo para proteger el contexto.",
+            "Debe ordenar por relevancia por defecto y permitir orden por ruta.",
+            "Debe poder omitir tests/specs con include_tests=false y priorizar fuente con source_first=true.",
+            "Con --semantic=true debe consultar el grafo semántico Nexus/Higpertext sin volcar el blob completo.",
+            "Con --json=true debe devolver salida parseable con total_matches, files_scanned, files_matched y matches.",
+            "Nunca debe exponer contenido de archivos de secretos (.env, secrets.json, *.key).",
+            "Con --all=true debe incluir directorios de agentes/configuración como .opencode, .claude, .agents y .gemini, pero nunca .git, .venv ni node_modules."
+        ]
+    },
+    "hook_task_id": "hook_grep_search",
+    "bash_intercept": {
+        "pattern": "\\bgrep\\b",
+        "description": "Buscar en el código",
+        "reason": "grep directo omite exclusiones de .venv, __pycache__ y .git, y no formatea los resultados con número de línea agrupado por archivo. common.grep-search aplica estos filtros automáticamente.",
+        "example": "htx task common.grep-search --pattern \"<patrón>\" --path <ruta>",
+        "has_dedicated_hook": true
+    }
+}

higpertext/capabilities/common/higpertext-tester.json

@@ -0,0 +1,25 @@
+{
+    "id": "common.higpertext-tester",
+    "version": "1.0.0",
+    "description": "Suite de validación y testing para asegurar la integridad de capacidades y el cumplimiento de contratos técnicos.",
+    "entrypoint": "capabilities/common/scripts/higpertext_tester.py",
+    "parameters": [
+        {
+            "name": "level",
+            "description": "Nivel de prueba a ejecutar: integrity, smoke o full.",
+            "default": "full"
+        },
+        {
+            "name": "target",
+            "description": "Capacidad específica a testear (opcional, por defecto todas).",
+            "required": false
+        }
+    ],
+    "contract": {
+        "rules": [
+            "Generar un reporte de salud del motor en formato Markdown.",
+            "Listar fallos de integridad (archivos faltantes) con prioridad crítica.",
+            "Validar cumplimiento de reglas de contrato (Regex/Heurística)."
+        ]
+    }
+}

higpertext/capabilities/common/hook-health.json

@@ -0,0 +1,19 @@
+{
+  "id": "common.hook-health",
+  "version": "1.0.0",
+  "name": "Hook Health",
+  "description": "Valida que los hooks de reducción de contexto estén registrados, detecten outputs grandes, bloqueen Read masivo y no recomienden flags inexistentes conocidos.",
+  "entrypoint": "capabilities/common/scripts/hook_health.py",
+  "language": "python",
+  "parameters": [
+    {"name": "json", "description": "Emite JSON estructurado.", "required": false, "default": "false"}
+  ],
+  "contract": {
+    "rules": [
+      "Debe verificar hook_post_observer, hook_context_manager, hook_session_prompt, hook_read_guard y hook_bash_guard.",
+      "Debe validar detección de output grande en PostToolUse.",
+      "Debe validar bloqueo de Read grande con sugerencia common.smart-read.",
+      "Debe fallar si encuentra recomendaciones de --source_path en hooks."
+    ]
+  }
+}

higpertext/capabilities/common/hook-sync-check.json

@@ -0,0 +1,19 @@
+{
+  "id": "common.hook-sync-check",
+  "version": "1.0.0",
+  "name": "Hook Sync Check",
+  "description": "Compara los hooks desplegados en asistentes contra la fuente canónica del motor.",
+  "entrypoint": "capabilities/common/scripts/hook_sync_check.py",
+  "language": "python",
+  "parameters": [
+    {"name": "json", "description": "Emite JSON estructurado.", "required": false, "default": "false"},
+    {"name": "strict", "description": "Si true, asistentes sin hooks desplegados fallan.", "required": false, "default": "false"}
+  ],
+  "contract": {
+    "rules": [
+      "Debe comparar hashes de hooks fuente contra hooks desplegados.",
+      "Debe reportar drift por asistente.",
+      "Debe soportar salida JSON."
+    ]
+  }
+}

higpertext/capabilities/common/hooks-manager.json

@@ -0,0 +1,55 @@
+{
+  "id": "common.hooks-manager",
+  "version": "1.0.0",
+  "name": "Hooks Manager",
+  "description": "Gestiona el ciclo de vida de hooks nativos de higpertext: listar, agregar, habilitar, deshabilitar y eliminar entradas en .higpertext/hooks_config.json. Regenera la configuración nativa del asistente activo tras cada cambio.",
+  "entrypoint": "capabilities/common/scripts/hooks_manager.py",
+  "language": "python",
+  "parameters": [
+    {
+      "name": "action",
+      "description": "Acción a ejecutar: list | add | remove | enable | disable | render",
+      "required": true
+    },
+    {
+      "name": "id",
+      "description": "ID del hook (requerido para remove, enable, disable).",
+      "required": false
+    },
+    {
+      "name": "event",
+      "description": "Evento del hook para --action add: PreToolUse | PostToolUse | Stop | Notification",
+      "required": false
+    },
+    {
+      "name": "script",
+      "description": "Ruta relativa al script del hook (requerido para --action add).",
+      "required": false
+    },
+    {
+      "name": "description",
+      "description": "Descripción del hook (opcional para --action add).",
+      "required": false
+    },
+    {
+      "name": "assistant",
+      "description": "Asistente para --action render: claude | gemini | antigravity | copilot. Por defecto usa el activo en environment.json.",
+      "required": false
+    },
+    {
+      "name": "profile",
+      "description": "Perfil para --action render. Por defecto usa el activo en environment.json.",
+      "required": false
+    }
+  ],
+  "contract": {
+    "rules": [
+      "Debe mostrar la lista completa de hooks con su estado (enabled/disabled) al usar --action list.",
+      "Al agregar un hook debe validar que el evento sea uno de los soportados.",
+      "Al remover un hook debe confirmar que el ID existe antes de eliminar.",
+      "Tras enable/disable/add/remove debe llamar a HookRenderer para regenerar la config nativa del asistente activo.",
+      "Nunca debe exponer variables de entorno o secrets en el output.",
+      "Debe indicar claramente el número de hooks activos por perfil al listar."
+    ]
+  }
+}

higpertext/capabilities/common/knowledge-asker.json

@@ -0,0 +1,27 @@
+{
+    "id": "common.knowledge-asker",
+    "version": "1.0.0",
+    "description": "Consulta la base de conocimiento de Gobernanza y Minutas para resolver dudas sobre normas y decisiones previas.",
+    "entrypoint": "capabilities/common/scripts/ask_htx.py",
+    "parameters": [
+        {
+            "name": "query",
+            "description": "La pregunta o tema sobre el cual se desea obtener información de gobernanza.",
+            "required": true
+        }
+    ],
+    "contract": {
+        "rules": [
+            "Citar siempre el nombre del archivo fuente encontrado.",
+            "Si no se encuentra información, sugerir consultar al administrador de gobernanza.",
+            "Resumir los puntos clave de forma ejecutiva."
+        ]
+    },
+    "hook_task_id": "hook_knowledge_asker",
+    "bash_intercept": {
+        "pattern": "\\bcat\\s+.*\\.(md|json|yaml|yml|txt)\\b",
+        "description": "Consultar documentación o gobernanza",
+        "reason": "cat de archivos de docs/gobernanza omite el contexto semántico. knowledge-asker indexa y responde con las secciones relevantes, evitando leer archivos completos.",
+        "example": "htx task common.knowledge-asker --query \"<pregunta>\""
+    }
+}

higpertext/capabilities/common/list-rules.json

@@ -0,0 +1,27 @@
+{
+    "id": "common.list-rules",
+    "version": "1.0.0",
+    "name": "List Rules",
+    "description": "Lista todas las capacidades disponibles para el perfil activo con su namespace, ID corto y descripción de una línea. Útil para descubrir qué capacidades están disponibles antes de invocar load-rules.",
+    "entrypoint": "capabilities/common/scripts/list_rules.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "type",
+            "description": "Tipo de recursos a listar: 'capabilities', 'workflows' o 'all'.",
+            "required": false,
+            "default": "all"
+        }
+    ],
+    "hook_task_id": "hook_list_rules",
+    "contract": {
+        "rules": [
+            "Debe leer el perfil activo desde .higpertext/environment.json.",
+            "Debe cruzar los IDs del perfil con los JSONs en src/capabilities/.",
+            "Debe mostrar una tabla con columnas: NAMESPACE, ID, DESCRIPCIÓN.",
+            "Debe indicar el total de capacidades al finalizar.",
+            "Si un JSON de capacidad no existe, debe marcarlo como '(JSON no encontrado)' sin fallar.",
+            "Debe imprimir el comando de ejemplo para invocar load-rules al finalizar."
+        ]
+    }
+}