higpertext-cli 0.8.0__py3-none-any.whl

higpertext/capabilities/common/semantic-search.json

@@ -0,0 +1,19 @@
+{
+  "id": "common.semantic-search",
+  "version": "1.0.0",
+  "name": "Semantic Search",
+  "description": "Busca fragmentos de código y documentación semánticamente usando RAG.",
+  "entrypoint": "capabilities/common/scripts/semantic_search.py",
+  "language": "python",
+  "parameters": [
+    {"name": "query", "description": "Consulta o concepto semántico a buscar.", "required": true},
+    {"name": "limit", "description": "Número máximo de fragmentos a retornar.", "required": false, "default": "5"},
+    {"name": "root", "description": "Ruta al directorio raíz del proyecto.", "required": false, "default": "."}
+  ],
+  "contract": {
+    "rules": [
+      "Debe calcular el embedding del query.",
+      "Debe devolver una lista ordenada de fragmentos por similitud coseno en JSON."
+    ]
+  }
+}

higpertext/capabilities/common/session-clean.json

@@ -0,0 +1,20 @@
+{
+    "id": "common.session-clean",
+    "version": "1.0.0",
+    "name": "Limpiar Sesión Temporal",
+    "description": "Cierra la sesión de desarrollo y desmonta/borra todos los recursos efímeros del workspace.",
+    "entrypoint": "capabilities/common/scripts/session_control.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "action",
+            "type": "string",
+            "required": true,
+            "description": "Acción a realizar: 'clean'"
+        }
+    ],
+    "security": {
+        "requires_pat": false
+    },
+    "hook_task_id": "hook_session_stop"
+}

higpertext/capabilities/common/session-start.json

@@ -0,0 +1,44 @@
+{
+    "id": "common.session-start",
+    "version": "1.0.0",
+    "name": "Iniciar Sesión Temporal",
+    "description": "Bootstraps a temporal development session by mounting required skills, subagents, and compiling dynamic playbooks.",
+    "entrypoint": "capabilities/common/scripts/session_control.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "action",
+            "type": "string",
+            "required": true,
+            "description": "Acción a realizar: 'start'"
+        },
+        {
+            "name": "profile",
+            "type": "string",
+            "required": false,
+            "description": "Nombre del perfil activo."
+        },
+        {
+            "name": "assistant",
+            "type": "string",
+            "required": false,
+            "description": "Asistente destino: claude, gemini, antigravity, copilot. Por defecto usa el del environment.json."
+        },
+        {
+            "name": "skills",
+            "type": "string",
+            "required": false,
+            "description": "Lista de skills separadas por comas."
+        },
+        {
+            "name": "subagents",
+            "type": "string",
+            "required": false,
+            "description": "Lista de subagentes separados por comas."
+        }
+    ],
+    "security": {
+        "requires_pat": false
+    },
+    "hook_task_id": "hook_session_start"
+}

higpertext/capabilities/common/smart-read.json

@@ -0,0 +1,28 @@
+{
+  "id": "common.smart-read",
+  "version": "1.0.0",
+  "name": "Smart Read",
+  "description": "Lee archivos de forma segura para LLM. En modo auto evita volcar archivos grandes y devuelve skeleton, rangos, símbolos o resumen con mapa de líneas.",
+  "entrypoint": "capabilities/common/scripts/smart_read.py",
+  "language": "python",
+  "parameters": [
+    {"name": "path", "description": "Archivo a leer.", "required": true},
+    {"name": "mode", "description": "auto, skeleton, range, symbol, full o summary. Default: auto.", "required": false, "default": "auto"},
+    {"name": "symbol", "description": "Símbolo a localizar con mode=symbol.", "required": false},
+    {"name": "offset", "description": "Línea inicial para mode=range. Default: 1.", "required": false, "default": "1"},
+    {"name": "limit", "description": "Cantidad de líneas para mode=range o radio para around_line. Default: 120.", "required": false, "default": "120"},
+    {"name": "around_line", "description": "Lee alrededor de una línea específica.", "required": false, "default": "0"},
+    {"name": "max_bytes", "description": "Umbral para considerar archivo grande. Default: 102400.", "required": false, "default": "102400"},
+    {"name": "max_tokens", "description": "Si el resultado excede el presupuesto, degrada a summary.", "required": false, "default": "0"},
+    {"name": "json", "description": "Emite JSON estructurado.", "required": false, "default": "false"}
+  ],
+  "contract": {
+    "rules": [
+      "Debe validar que el archivo exista.",
+      "En mode=auto debe devolver skeleton para archivos de código grandes.",
+      "Debe soportar lectura por rango, por símbolo, resumen y JSON.",
+      "Debe bloquear mode=full para archivos que superen max_bytes.",
+      "Debe incluir números de línea en rangos para facilitar lecturas focalizadas."
+    ]
+  }
+}

higpertext/capabilities/common/subagent-executor.json

@@ -0,0 +1,25 @@
+{
+    "id": "common.subagent-executor",
+    "version": "1.0.0",
+    "name": "Ejecutor de Subagentes",
+    "description": "Lanza la ejecución aislada de un subagente especializado para resolver una subtarea.",
+    "entrypoint": "python src/capabilities/common/scripts/subagent_executor.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "agent",
+            "type": "string",
+            "required": true,
+            "description": "Nombre del subagente a ejecutar (ej: test-engineer)."
+        },
+        {
+            "name": "task",
+            "type": "string",
+            "required": true,
+            "description": "Descripción detallada de la subtarea a resolver."
+        }
+    ],
+    "security": {
+        "requires_pat": false
+    }
+}

higpertext/capabilities/common/sync-agents.json

@@ -0,0 +1,32 @@
+{
+    "id": "common.sync-agents",
+    "version": "1.0.0",
+    "description": "Sincroniza y proyecta las reglas canónicas de AgentSystem (workflows primarios y subagentes) hacia las carpetas específicas del asistente IA en el proyecto destino.",
+    "entrypoint": "capabilities/common/scripts/sync_agents.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "target",
+            "description": "Ruta al proyecto destino donde proyectar las reglas y subagentes (opcional, por defecto el proyecto actual).",
+            "required": false
+        },
+        {
+            "name": "source",
+            "description": "Ruta origen de AgentSystem (opcional, por defecto se detecta automáticamente o vía variable de entorno AGENT_SYSTEM_PATH).",
+            "required": false
+        },
+        {
+            "name": "assistant",
+            "description": "Asistente objetivo para proyectar (gemini, claude, copilot, opencode, antigravity, all).",
+            "default": "all",
+            "required": false
+        }
+    ],
+    "contract": {
+        "rules": [
+            "Proyectar flujos de trabajo primarios (spec, plan, build, review) en las rutas del asistente.",
+            "Proyectar subagentes especializados en subagents/.",
+            "Generar un reporte claro en consola con la lista de archivos creados o actualizados."
+        ]
+    }
+}

higpertext/capabilities/common/task-decomposer.json

@@ -0,0 +1,37 @@
+{
+    "id": "common.task-decomposer",
+    "version": "1.0.0",
+    "name": "Task Decomposer",
+    "description": "Descompone un objetivo de ingeniería en un task-graph determinístico (DAG). Produce fases con dependencias, skills y subagentes por nodo, compatible con roadmap.json de higpertext. Motor heurístico (NO LLM): plantillas por tipo de tarea (refactor/feature/bugfix/review). El resultado es un punto de partida para iterar.",
+    "entrypoint": "capabilities/common/scripts/task_decomposer.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "goal",
+            "description": "Objetivo en lenguaje natural, ej: 'implementar el Efficiency Meter'.",
+            "required": true
+        },
+        {
+            "name": "type",
+            "description": "Tipo de tarea: refactor|feature|bugfix|review. Default: feature.",
+            "required": false,
+            "default": "feature"
+        },
+        {
+            "name": "save",
+            "description": "Si 'true', escribe .higpertext/config/roadmap.json. Default: true.",
+            "required": false,
+            "default": "true"
+        }
+    ],
+    "contract": {
+        "rules": [
+            "El grafo generado debe ser un DAG válido (sin ciclos).",
+            "Para tipo 'refactor', el primer nodo debe ser de exploración.",
+            "Cada nodo debe declarar sus skills y subagents.",
+            "El output debe ser compatible con el formato de roadmap.json de higpertext.",
+            "Si --save=true, debe escribir en .higpertext/config/roadmap.json.",
+            "El decomposer NO debe invocar ningún LLM — solo heurísticas determinísticas."
+        ]
+    }
+}

higpertext/capabilities/common/telemetry-report.json

@@ -0,0 +1,23 @@
+{
+    "id": "common.telemetry-report",
+    "version": "1.0.0",
+    "name": "Telemetry Report",
+    "description": "Muestra dashboard de telemetría higpertext en terminal: tokens estimados, costo, sesiones, commits y correlaciones.",
+    "entrypoint": "capabilities/common/scripts/telemetry_report.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "days",
+            "description": "Período en días a analizar (default: 7).",
+            "required": false,
+            "default": "7"
+        }
+    ],
+    "contract": {
+        "rules": [
+            "Lee únicamente .higpertext/telemetry.jsonl — nunca expone tokens de API ni variables de entorno.",
+            "Si no hay datos, muestra mensaje informativo sin error.",
+            "Tokens y costo son estimados (chars/4) — no son valores exactos del proveedor."
+        ]
+    }
+}

higpertext/capabilities/git/committer.json

@@ -0,0 +1,61 @@
+{
+    "id": "git.committer",
+    "version": "1.0.0",
+    "description": "Realiza un commit en Git siguiendo el estándar Conventional Commits y opcionalmente hace push a la rama en Azure DevOps.",
+    "entrypoint": "capabilities/git/scripts/commit_changes.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "message",
+            "description": "Mensaje del commit siguiendo Conventional Commits (ej. 'feat: añade capacidad de committer').",
+            "required": true
+        },
+        {
+            "name": "files",
+            "description": "Archivos a incluir en el commit (por defecto '.' para todos). Especifique rutas separadas por espacios o comas si es selectivo.",
+            "required": false
+        },
+        {
+            "name": "rationale",
+            "description": "Justificación técnica, arquitectónica y decisiones de negocio asociadas a este commit (opcional). Si no se indica, se deducirá automáticamente.",
+            "required": false
+        },
+        {
+            "name": "branch",
+            "description": "Nombre de la rama destino para realizar 'git push origin <branch>' (opcional).",
+            "required": false
+        },
+        {
+            "name": "tag",
+            "description": "Si se especifica '--tag', crea un tag anotado y hace bump de versión automático tras el commit. Soporta Python (pyproject.toml/setup.py/setup.cfg), Node (package.json), Java (pom.xml) y .NET (*.csproj/*.fsproj).",
+            "required": false
+        },
+        {
+            "name": "bump",
+            "description": "Tipo de incremento semver al usar --tag: 'patch' (default), 'minor' o 'major'.",
+            "required": false
+        },
+        {
+            "name": "tag-message",
+            "description": "Mensaje personalizado para el tag anotado (opcional). Si se omite, se genera automáticamente.",
+            "required": false
+        },
+        {
+            "name": "version",
+            "description": "Versión explícita para el tag (ej. '2.1.0' o 'v2.1.0'). Si se indica, omite el cálculo de --bump y usa esta versión directamente.",
+            "required": false
+        }
+    ],
+    "contract": {
+        "rules": [
+            "El mensaje de commit debe seguir Conventional Commits (prefijos válidos: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert).",
+            "Verificar cambios pendientes antes de realizar el commit."
+        ]
+    },
+    "hook_task_id": "hook_higpertext_enforcer",
+    "bash_intercept": {
+        "pattern": "\\bgit\\s+commit\\b",
+        "description": "Hacer un commit",
+        "example": "htx task git.committer --message \"<mensaje del commit>\""
+    }
+}

higpertext/capabilities/git/diff.json

@@ -0,0 +1,33 @@
+{
+    "id": "git.diff",
+    "version": "1.0.0",
+    "description": "Detecta cambios locales en el repositorio Git (archivos modificados, eliminados, sin seguimiento) y muestra un resumen estructurado o las diferencias detalladas (diffs) para ayudar al agente en tareas de versionado y documentación.",
+    "entrypoint": "capabilities/git/scripts/git_diff.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "detail",
+            "description": "Si es 'true', muestra el diff detallado del código. Si es 'false', solo lista los archivos. (default: 'false')",
+            "required": false
+        },
+        {
+            "name": "files",
+            "description": "Lista de archivos específicos separados por comas para analizar su diff. (opcional)",
+            "required": false
+        }
+    ],
+    "contract": {
+        "rules": [
+            "Mostrar el listado de archivos clasificados por su estado en Git (Staged, Unstaged, Untracked).",
+            "Si el parámetro detail está activo, formatear el diff en un bloque markdown legible con sintaxis diff."
+        ]
+    },
+    "hook_task_id": "hook_git_diff",
+    "bash_intercept": {
+        "pattern": "\\bgit\\s+(diff|status|log)\\b",
+        "description": "Ver diff/estado del repositorio",
+        "reason": "git diff/status/log nativo produce output sin clasificar. ado_admin.git-diff agrupa los archivos por estado (Staged, Unstaged, Untracked) y formatea el diff en markdown legible para el agente.",
+        "example": "htx task git.git-diff --detail true",
+        "has_dedicated_hook": true
+    }
+}

higpertext/capabilities/git/ls-files.json

@@ -0,0 +1,44 @@
+{
+    "id": "git.ls-files",
+    "version": "1.1.0",
+    "description": "Lista e inspecciona archivos trackeados por git como alternativa segura a ls/find. Incluye filtros por ruta, glob, extensión, presets, árbol compacto, resumen, directorios, tamaños, JSON y límites de contexto.",
+    "entrypoint": "capabilities/git/scripts/git_ls_files.py",
+    "language": "python",
+    "parameters": [
+        {"name": "path", "description": "Prefijo o ruta a explorar, ejemplo: src/higpertext.", "required": false},
+        {"name": "pattern", "description": "Filtro substring opcional para rutas.", "required": false},
+        {"name": "include", "description": "Globs incluidos separados por coma, ejemplo: *.py,*.json.", "required": false},
+        {"name": "exclude", "description": "Globs o rutas excluidas separados por coma.", "required": false},
+        {"name": "extension", "description": "Alias de include para extensiones, ejemplo: py,json.", "required": false},
+        {"name": "preset", "description": "Preset de filtro: all, code, python, web, docs, config o tests. Default: all.", "required": false, "default": "all"},
+        {"name": "mode", "description": "Modo de salida: list, tree, summary, dirs o json. Default: summary.", "required": false, "default": "summary"},
+        {"name": "max_results", "description": "Máximo de rutas, grupos o nodos impresos. Default: 100.", "required": false, "default": "100"},
+        {"name": "max_depth", "description": "Profundidad máxima para tree/dirs. Default: 3.", "required": false, "default": "3"},
+        {"name": "show_size", "description": "Si es true, muestra tamaño por archivo en mode=list.", "required": false, "default": "false"},
+        {"name": "large_threshold_kb", "description": "Umbral para marcar archivos grandes y sugerir skeletonizer. Default: 100.", "required": false, "default": "100"},
+        {"name": "sort", "description": "Orden: path, size o extension. Default: path.", "required": false, "default": "path"},
+        {"name": "group_by", "description": "Agrupación para mode=list: none, dir o extension. Default: none.", "required": false, "default": "none"},
+        {"name": "files_only", "description": "Si es true, imprime solo rutas, una por línea.", "required": false, "default": "false"},
+        {"name": "json", "description": "Si es true, emite JSON estructurado.", "required": false, "default": "false"},
+        {"name": "include_untracked", "description": "Si es true, incluye archivos no trackeados respetando .gitignore.", "required": false, "default": "false"}
+    ],
+    "contract": {
+        "rules": [
+            "Listar archivos trackeados en el índice git, uno por línea o mediante resúmenes compactos, como reemplazo gobernado de ls/find.",
+            "Debe filtrar por path, pattern, include, exclude, extension y preset.",
+            "Debe limitar resultados mediante max_results para evitar output excesivo.",
+            "Debe soportar modos list, tree, summary, dirs y json.",
+            "Debe poder mostrar tamaños, ordenar por path/size/extension y agrupar por directorio o extensión.",
+            "Debe marcar archivos grandes y sugerir common.code-skeletonizer --path cuando aplique.",
+            "Debe emitir JSON parseable con total y files cuando json=true o mode=json.",
+            "Debe indicar total de archivos encontrados al final en salidas de texto."
+        ]
+    },
+    "bash_intercept": {
+        "pattern": "(^|[;&|]\\s*)ls(\\s|$)|\\bgit\\s+ls-files\\b",
+        "description": "Listar archivos trackeados en el índice git",
+        "reason": "ls/git ls-files directo puede producir inventarios crudos o inconsistentes. git.ls-files formatea, filtra y resume archivos desde Higpertext.",
+        "example": "htx task git.ls-files --path src --mode summary",
+        "has_dedicated_hook": true
+    }
+}

higpertext/capabilities/git/rm.json

@@ -0,0 +1,27 @@
+{
+    "id": "git.rm",
+    "version": "1.0.0",
+    "description": "Remueve archivos del índice git (git rm --cached) sin eliminarlos del sistema de archivos local. Útil para dejar de trackear archivos que deben ser ignorados.",
+    "entrypoint": "capabilities/git/scripts/git_rm.py",
+    "language": "python",
+    "parameters": [
+        {
+            "name": "files",
+            "description": "Lista de archivos o patrones separados por comas a remover del índice (e.g. 'AGENTS.md,.higpertext/environment.json').",
+            "required": true
+        }
+    ],
+    "contract": {
+        "rules": [
+            "Ejecutar git rm --cached sobre cada archivo especificado.",
+            "Reportar cada archivo removido exitosamente.",
+            "Si un archivo no está trackeado, reportarlo como advertencia sin fallar.",
+            "Nunca eliminar archivos del sistema de archivos local (solo del índice)."
+        ]
+    },
+    "bash_intercept": {
+        "pattern": "\\bgit\\s+rm\\b",
+        "description": "Remover archivos del índice git",
+        "example": "htx task git.git-rm --files \"<archivo1,archivo2>\""
+    }
+}