higpertext-cli 0.8.0__py3-none-any.whl

config/context_engine.json

@@ -0,0 +1,33 @@
+{
+  "stopwords": [
+    "el", "la", "los", "las", "de", "del", "un", "una", "unos", "unas",
+    "que", "con", "por", "para", "como", "este", "esta", "estos", "estas",
+    "mi", "tu", "su", "sus", "lo", "le", "se", "en", "al", "más", "muy",
+    "sistema", "necesito", "quiero", "hacer", "aqui", "aquí",
+    "the", "and", "for", "with", "from", "that", "this", "into", "when"
+  ],
+  "state_file_path": ".higpertext/state/window_state.json",
+  "window_limit": {
+    "env_var": "HIGPERTEXT_WINDOW_LIMIT",
+    "default_str": "200000",
+    "default_int": 200000
+  },
+  "roadmap": {
+    "version": "1.0.0",
+    "default_project": "task-graph",
+    "fallback_skills": ["clean-code", "best-practices"],
+    "fallback_subagents": ["architect", "test-engineer"],
+    "name_truncation": 60,
+    "project_truncation": 50
+  },
+  "markdown": {
+    "symbols_header": "## Símbolos relevantes",
+    "memories_header": "## Memorias aplicables",
+    "skeletons_header": "## Esqueletos de archivos",
+    "efficiency_report_title": "# Efficiency Report — {session_id}",
+    "efficiency_table_header": [
+      "| Métrica | Valor |",
+      "|---------|-------|"
+    ]
+  }
+}

config/environments/model_defaults.json

@@ -0,0 +1,5 @@
+{
+    "version": "1.0.0",
+    "description": "Configuración opcional de modelos por asistente. higpertext no define modelos por defecto; el usuario debe escogerlos explícitamente.",
+    "model_config": {}
+}

config/governance/branching_strategy.json

@@ -0,0 +1,36 @@
+{
+    "version": "1.0.0",
+    "protected_branches": ["main", "develop", "release/*"],
+    "branch_naming": {
+        "feature": "feature/{ticket}-{description}",
+        "hotfix":  "hotfix/{ticket}-{description}",
+        "release": "release/{semver}",
+        "bugfix": "bugfix/{ticket}-{description}",
+        "fix":     "fix/{ticket}-{description}"
+    },
+    "merge_strategy": {
+        "main":    "squash",
+        "develop": "rebase",
+        "feature": "merge"
+    },
+    "rules": [
+        {
+            "id": "no-direct-push-main",
+            "pattern": "git\\s+push\\s+(origin\\s+)?main\\b",
+            "severity": "block",
+            "reason": "Push directo a main prohibido — usar PR con al menos 1 review aprobado"
+        },
+        {
+            "id": "no-direct-push-develop",
+            "pattern": "git\\s+push\\s+(origin\\s+)?develop\\b",
+            "severity": "block",
+            "reason": "Push directo a develop prohibido — las features deben integrarse vía PR"
+        },
+        {
+            "id": "no-direct-push-release",
+            "pattern": "git\\s+push\\s+(origin\\s+)?release/",
+            "severity": "block",
+            "reason": "Push directo a release/* prohibido — solo hotfixes vía PR con aprobación de seguridad"
+        }
+    ]
+}

config/governance/deployment_gates.json

@@ -0,0 +1,30 @@
+{
+    "version": "1.0.0",
+    "production_windows": {
+        "days": ["Tuesday", "Wednesday", "Thursday"],
+        "start_utc": "10:00",
+        "end_utc": "16:00"
+    },
+    "required_approvals": {
+        "production": 2,
+        "staging": 1
+    },
+    "strategy": {
+        "min_sla_canary": 99.5,
+        "preferred": "blue-green"
+    },
+    "blocked_patterns": [
+        {
+            "id": "no-prod-deploy-agent",
+            "pattern": "deploy.*prod|kubectl.*apply.*prod|helm.*upgrade.*prod",
+            "severity": "warn",
+            "reason": "Deploy a producción requiere aprobación humana explícita via deployment gate"
+        },
+        {
+            "id": "no-force-recreate-prod",
+            "pattern": "kubectl.*--force.*prod|docker.*rm.*prod",
+            "severity": "block",
+            "reason": "Recreación forzada en producción prohibida sin ventana de mantenimiento aprobada"
+        }
+    ]
+}

config/governance/guidelines_contract.json

@@ -0,0 +1,54 @@
+{
+  "code_quality_limits": {
+    "max_function_lines": 30,
+    "max_class_lines": 200
+  },
+  "guidelines": {
+    "security": [
+      "Never hardcode secrets, tokens, or credentials in source code or configuration files.",
+      "All secrets must be referenced via environment variables or a secrets manager.",
+      "Exposed secrets must be rotated immediately and the incident logged in the postmortem.",
+      "Container images must be scanned for CVEs before deployment.",
+      "Principle of least privilege applies to all service accounts and IAM roles.",
+      "SSH keys and PATs must have a maximum expiry of 90 days."
+    ],
+    "pull_requests": [
+      "Every PR must have at least one approved review before merge.",
+      "PR titles must follow conventional commits format: type(scope): description.",
+      "PRs must not decrease code coverage below the project threshold.",
+      "Merge strategy: squash merge on main; rebase merge on feature branches.",
+      "PRs touching infrastructure or secrets require a second reviewer from the security team.",
+      "Draft PRs must not be merged until explicitly marked ready."
+    ],
+    "deployments": [
+      "No deployment to production without a passing CI pipeline on the target commit.",
+      "Production deployments require explicit human approval via the deployment gate.",
+      "Rollback procedures must be documented and tested before each release.",
+      "Blue/green or canary strategy is mandatory for services with SLA > 99.5%.",
+      "Deployment windows for production: Tuesday\u2013Thursday 10:00\u201316:00 UTC only.",
+      "All deployments must emit a deployment event to the audit log."
+    ],
+    "code_quality": [
+      "Functions must not exceed 30 lines; classes must not exceed 200 lines.",
+      "Cyclomatic complexity must stay below 10 per function.",
+      "All public APIs must have typed signatures.",
+      "No commented-out code in merged branches.",
+      "Test coverage must be >= 80% for new modules."
+    ],
+    "doc_as_code": [
+      "Documentation must be version-controlled in Markdown format alongside the source code.",
+      "Any code modification that changes public interfaces or behavior must update the corresponding docs in the same commit or PR.",
+      "Documents must be modular, avoiding duplicate explanations (DRY documentation).",
+      "Format documentation according to standard Markdown lint rules.",
+      "Links within documentation must be relative and verified to prevent broken paths."
+    ],
+    "gitflow_commits": [
+      "Commit messages must follow the Conventional Commits specification (e.g., feat(scope): description).",
+      "Keep commits atomic: each commit should represent a single logical change with passing tests.",
+      "Feature branches must be branched from 'develop' and merged back via Pull Requests, never directly.",
+      "Release branches must be created from 'develop' and merged into both 'main' and 'develop'.",
+      "Hotfixes must be branched from 'main' and merged back to both 'main' and 'develop' immediately after validation.",
+      "Always rebase feature branches against 'develop' before merging to ensure a clean commit history."
+    ]
+  }
+}

config/governance/quality_gates.json

@@ -0,0 +1,39 @@
+{
+    "version": "1.0.0",
+    "severity": "warn",
+    "code_quality_limits": {
+        "max_function_lines": 30,
+        "max_class_lines": 200,
+        "max_cyclomatic_complexity": 10,
+        "min_test_coverage": 80
+    },
+    "gitflow_limits": {
+        "max_uncommitted_files": 5
+    },
+    "rules": [
+        {
+            "id": "max-function-lines",
+            "description": "Functions must not exceed 30 lines",
+            "threshold": 30,
+            "severity": "warn"
+        },
+        {
+            "id": "max-class-lines",
+            "description": "Classes must not exceed 200 lines",
+            "threshold": 200,
+            "severity": "warn"
+        },
+        {
+            "id": "min-coverage",
+            "description": "Test coverage must be >= 80% for new modules",
+            "threshold": 80,
+            "severity": "warn"
+        },
+        {
+            "id": "max-uncommitted",
+            "description": "No more than 5 files modified without committing",
+            "threshold": 5,
+            "severity": "warn"
+        }
+    ]
+}

config/governance/section_rules.json

@@ -0,0 +1,22 @@
+{
+  "section_map": {
+    "security":        { "scope": "any",    "severity": "critical" },
+    "pull_requests":   { "scope": "pr",     "severity": "high"     },
+    "deployments":     { "scope": "deploy", "severity": "high"     },
+    "code_quality":    { "scope": "commit", "severity": "medium"   },
+    "doc_as_code":     { "scope": "pr",     "severity": "low"      },
+    "gitflow_commits": { "scope": "commit", "severity": "high"     }
+  },
+  "automated_rule_positions": [
+    { "section": "security",        "index": 1, "comment": "Never hardcode secrets"         },
+    { "section": "code_quality",    "index": 1, "comment": "Functions must not exceed 30 lines" },
+    { "section": "code_quality",    "index": 5, "comment": "Test coverage >= 80%"            },
+    { "section": "gitflow_commits", "index": 1, "comment": "Conventional Commits format"    }
+  ],
+  "canonical_ids": [
+    { "section": "security",        "index": 1, "id": "security.no-hardcoded-secrets"       },
+    { "section": "code_quality",    "index": 1, "id": "code_quality.max-function-lines"     },
+    { "section": "code_quality",    "index": 5, "id": "code_quality.min-coverage"           },
+    { "section": "gitflow_commits", "index": 1, "id": "gitflow_commits.conventional-format" }
+  ]
+}

config/governance/security_guardrails.json

@@ -0,0 +1,52 @@
+{
+    "version": "2.0.0",
+    "blocked_patterns": [
+        { "pattern": "\\bsudo\\b", "reason": "sudo no permitido por política de seguridad", "severity": "block" },
+        { "pattern": "\\bgit\\s+push\\b", "reason": "git push es acción exclusiva del usuario — el agente no puede publicar cambios al remoto", "severity": "block" },
+        { "pattern": "\\brm\\s+-rf\\s+/", "reason": "eliminación recursiva de raíz del sistema prohibida", "severity": "block" },
+        { "pattern": "\\bcurl\\b.*\\|.*\\bsh\\b", "reason": "pipe de red a shell es vector de ataque de supply chain", "severity": "block" },
+        { "pattern": "\\bchmod\\s+777\\b", "reason": "permisos world-writable prohibidos por política de seguridad", "severity": "block" },
+        { "pattern": "\\bgit\\s+push\\s+--force\\b", "reason": "force push puede destruir historial compartido", "severity": "block" },
+        { "pattern": "\\bdropdb\\b|\\bdrop\\s+database\\b", "reason": "eliminación de base de datos requiere aprobación humana explícita", "severity": "block" },
+        { "pattern": "\\bmkfs(\\.|\\s|$)", "reason": "formateo de discos prohibido para agentes", "severity": "block" },
+        { "pattern": "\\bdd\\s+.*\\bif=", "reason": "operaciones raw de disco con dd requieren intervención humana", "severity": "block" },
+        { "pattern": "\\bshutdown\\b|\\breboot\\b", "reason": "apagado o reinicio del sistema prohibido para agentes", "severity": "block" },
+        { "pattern": "\\bterraform\\s+destroy\\b", "reason": "destrucción de infraestructura requiere aprobación humana explícita", "severity": "block" },
+        { "pattern": "\\bkubectl\\s+delete\\s+namespace\\b", "reason": "eliminación de namespaces de cluster prohibida para agentes", "severity": "block" },
+        { "pattern": "\\bdocker\\s+system\\s+prune\\b", "reason": "limpieza destructiva de Docker prohibida para agentes", "severity": "block" },
+        { "pattern": "\\baws\\b.*\\bdelete\\b", "reason": "borrado de recursos cloud requiere aprobación humana explícita", "severity": "block" },
+        { "pattern": "\\baz\\s+group\\s+delete\\b", "reason": "borrado de resource groups requiere aprobación humana explícita", "severity": "block" },
+        { "pattern": "\\bgcloud\\b.*\\bdelete\\b", "reason": "borrado de recursos cloud requiere aprobación humana explícita", "severity": "block" }
+    ],
+    "approval_patterns": [
+        { "pattern": "\\bdeploy\\b.*\\b(prod|production)\\b", "reason": "deploy a producción requiere aprobación humana explícita" },
+        { "pattern": "\\bsecrets?\\s+rotate\\b", "reason": "rotación de secretos requiere aprobación humana explícita" }
+    ],
+    "warning_patterns": [
+        { "pattern": "\\bdocker\\s+compose\\s+down\\b", "reason": "docker compose down puede interrumpir servicios locales", "severity": "warn" }
+    ],
+    "guardrails": {
+        "forbidden_commands": [
+            "rm -rf /",
+            "mkfs",
+            "dd if=",
+            "shutdown",
+            "reboot",
+            "git push --force"
+        ],
+        "require_human_approval": [
+            "production.deploy",
+            "cluster.destroy",
+            "database.drop",
+            "secrets.rotate"
+        ],
+        "max_execution_timeout_seconds": 300
+    },
+    "data_masking": {
+        "patterns": [
+            {"name": "ADO_PAT", "regex": "(?i)ado_pat[\\s:=]+[a-zA-Z0-9]{20,50}", "mask": "ADO_PAT=********[MASKED]"},
+            {"name": "API_KEY", "regex": "(?i)api_key[\\s:=]+[a-zA-Z0-9_\\-]{15,}", "mask": "API_KEY=********[MASKED]"},
+            {"name": "SSH_KEY", "regex": "-----BEGIN (RSA|OPENSSH|PRIVATE) KEY-----.*?-----END \\1 KEY-----", "mask": "-----BEGIN PRIVATE KEY-----[MASKED]-----END PRIVATE KEY-----"}
+        ]
+    }
+}

config/hooks/README.md

@@ -0,0 +1,35 @@
+# Agent Hooks — Capa de Integración
+
+Esta carpeta es propiedad del desarrollador del agente.
+
+## Estructura
+
+```
+src/hooks/
+├── global/          ← SOLO higpertext Engine escribe aquí (no editar)
+├── profiles/
+│   └── <perfil>/   ← hooks activados cuando ese perfil está activo
+└── custom/         ← hooks libres, sin restricción de perfil
+```
+
+## Esquema de un hook (JSON)
+
+```json
+{
+  "id": "custom.mi_hook",
+  "event": "PreToolUse | PostToolUse | UserPromptSubmit | Stop",
+  "matcher": "Bash | ''",
+  "script": "ruta/al/script.py",
+  "timeout": 10,
+  "priority": 2,
+  "override": false,
+  "description": "Qué hace este hook"
+}
+```
+
+- `priority`: 0=global, 1=perfil, 2=custom. A mayor número, mayor precedencia en override.
+- `override`: si `true`, reemplaza el hook de perfil con el mismo `id` base.
+
+## Compilación
+
+`python htx.py agent init --profile <nombre>` compila estas capas en `.higpertext/config/hooks_config.json`.

config/hooks/custom/test_output_limiter.json

@@ -0,0 +1,9 @@
+{
+  "id": "custom.test_output_limiter",
+  "event": "PostToolUse",
+  "matcher": "Bash|higpertext_task|higpertext_workflow",
+  "script": "src/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"
+}

config/hooks/global/session_prompt.json

@@ -0,0 +1,9 @@
+{
+  "id": "global.session_prompt",
+  "event": "UserPromptSubmit",
+  "matcher": "",
+  "script": "src/higpertext/hooks/hook_tasks/hook_session_prompt.py",
+  "timeout": 10,
+  "priority": 0,
+  "description": "Inyecta estado de sesión higpertext y contexto de skills activas en cada prompt."
+}

config/htx_config.json

@@ -0,0 +1,24 @@
+{
+  "htx": {
+    "cli_name": "htx",
+    "env_override": "HIGPERTEXT_HTX_BIN",
+    "venv_bin": ".venv/bin/htx",
+    "venv_bin_windows": ".venv/Scripts/htx.exe",
+    "fallback_script": "htx.py",
+    "workspace_dir": ".higpertext",
+    "file_extension": ".json"
+  },
+  "paths": {
+    "capabilities": "src/higpertext/capabilities",
+    "profiles": "src/config/profiles",
+    "workflows": "src/config/workflows",
+    "hooks_global": "src/config/hooks/global",
+    "hooks_profiles": "src/config/hooks/profiles",
+    "hooks_custom": "src/config/hooks/custom",
+    "governance": "src/config/governance",
+    "templates": "src/config/templates",
+    "environments": "src/config/environments",
+    "skills_templates": "src/higpertext/templates/skills",
+    "subagents_templates": "src/higpertext/templates/subagents"
+  }
+}

config/profile_learner.json

@@ -0,0 +1,18 @@
+{
+  "conventional_commit_types": [
+    "feat", "fix", "refactor", "test", "docs", "chore", "style", "perf", "ci", "build"
+  ],
+  "scoring_defaults": {
+    "hook_intercept": 2,
+    "capability_used": 3,
+    "higpertext_direct": 1,
+    "bash_direct_penalty": -1,
+    "zero_commits_penalty": -5,
+    "conventional_commit": 4,
+    "high_adoption_bonus": 10,
+    "high_adoption_threshold": 80,
+    "effective_session_bonus": 8,
+    "effective_session_max_min": 45,
+    "effective_session_min_commits": 2
+  }
+}

config/profiles/base_agent.json

@@ -0,0 +1,40 @@
+{
+  "name": "base_agent",
+  "description": "Perfil base incluido en todo agente higpertext. Provee contexto de configuración, hooks esenciales y el subperfil agent_designer para guiar la creación de agentes.",
+  "system_prompt": "Eres un asistente base de higpertext Engine. Conoces en profundidad cómo crear perfiles, hooks, workflows y capabilities. Guías al desarrollador para configurar y extender su agente correctamente. Piensas de forma estructurada: descompones la petición en su objetivo real, eliges una sola estrategia y la justificas en una línea, y verificas el resultado antes de concluir. Eres conciso y directo — actúas sobre narrar.",
+  "capabilities": [
+    "common.grep-search",
+    "common.knowledge-asker",
+    "common.list-rules",
+    "common.load-rules",
+    "common.memory-manager",
+    "common.session-start",
+    "common.session-clean",
+    "common.agent-builder"
+  ],
+  "subprofiles": [
+    "agent_designer"
+  ],
+  "rules": [
+    "Siempre conoces la estructura de un agente higpertext: src/capabilities/, src/config/profiles/, src/workflows/, src/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/."
+  ],
+  "hooks": {
+    "global": [
+      "session_start",
+      "session_context",
+      "session_stop",
+      "exit_guard",
+      "telemetry",
+      "audit_logger",
+      "higpertext_enforcer",
+      "grep_search",
+      "knowledge_asker",
+      "list_rules",
+      "load_rules"
+    ]
+  }
+}

config/profiles/base_auditor.json

@@ -0,0 +1,19 @@
+{
+    "name": "base_auditor",
+    "description": "Perfil base de auditoría con foco en cumplimiento de gobernanza, seguridad, inspección de calidad y cobertura de código.",
+    "system_prompt": "Eres un auditor de seguridad y cumplimiento experto. Tu tono es directo, objetivo y profesional. Tu misión es garantizar que las operaciones cumplan estrictamente con las políticas de gobernanza, seguridad y estándares establecidos.",
+    "capabilities": [
+        "security.k8s-auditor",
+        "security.secret-scanner",
+        "security.vuln-resolver",
+        "git.diff",
+        "git.committer"
+    ],
+    "session_skills": [
+        "best-practices"
+    ],
+    "session_subagents": [
+        "docs-curator",
+        "migration-reviewer"
+    ]
+}

config/profiles/base_developer.json

@@ -0,0 +1,19 @@
+{
+    "name": "base_developer",
+    "description": "Perfil base de desarrollo con foco en la escritura de código, Clean Code y TDD.",
+    "system_prompt": "Eres un desarrollador experto. Tu prioridad es escribir código limpio, modular y de alto rendimiento que cumpla con los principios SOLID, Clean Code y patrones de diseño modernos. Implementas pruebas unitarias rigurosas y documentas tu código. Piensas antes de actuar: descompones el problema en su objetivo real, eliges el cambio mínimo correcto, y verificas tu trabajo contra ese objetivo antes de darlo por terminado. Priorizas actuar sobre narrar — cuando tienes lo necesario para avanzar, avanzas; cuando algo te bloquea de verdad, haces una sola pregunta precisa.",
+    "capabilities": [
+        "git.committer",
+        "git.diff",
+        "common.higpertext-tester",
+        "common.quality-updater",
+        "common.code-skeletonizer",
+        "common.diff-reviewer",
+        "common.agent-builder",
+        "common.eval-agent"
+    ],
+    "session_skills": [
+        "best-practices"
+    ],
+    "session_subagents": []
+}

config/profiles/base_operator.json

@@ -0,0 +1,16 @@
+{
+    "name": "base_operator",
+    "description": "Perfil base de operaciones con foco en monitoreo, diagnóstico de clusters, postmortems y aplicación de parches/hotfixes.",
+    "system_prompt": "Eres un operador de sistemas experto. Tu objetivo es mantener la disponibilidad, automatizar operaciones y diagnosticar incidentes. No adivines estados; consulta las APIs y analiza los logs de forma estructurada.",
+    "capabilities": [
+        "git.diff",
+        "git.committer",
+        "common.code-skeletonizer"
+    ],
+    "session_skills": [
+        "best-practices"
+    ],
+    "session_subagents": [
+        "ado-pipeline-guardian"
+    ]
+}

config/profiles/global.json

@@ -0,0 +1,33 @@
+{
+    "name": "global",
+    "description": "Capacidades globales transversales accesibles universalmente por cualquier usuario o perfil de higpertext en todo momento.",
+    "model_preference": "any",
+    "capabilities": [
+        "common.memory-manager",
+        "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",
+        "common.error-context-locator",
+        "common.search-router",
+        "common.file-map",
+        "common.context-budget-report",
+        "common.hook-health",
+        "common.env-catalog",
+        "common.env-runner",
+        "common.env-status",
+        "common.env-logs",
+        "common.env-stop",
+        "common.env-clean",
+        "common.env-template",
+        "common.list-rules",
+        "common.load-rules"
+    ],
+    "system_prompt": "Herramientas transversales de gestión de memoria, base de conocimiento y auditoría del sistema."
+}

config/profiles/software_developer.json

@@ -0,0 +1,23 @@
+{
+    "name": "software_developer",
+    "description": "Desarrollador de Software experto enfocado en Clean Code, SOLID y diseño de arquitectura modular.",
+    "model": "openai/gpt-5.5",
+    "extends": "base_developer",
+    "playbooks": ["plan"],
+    "capabilities": [
+        "common.coverage-resolver",
+        "common.test-resolver",
+        "common.quality-scan",
+        "common.quality-resolver",
+        "common.doctor",
+        "common.hook-sync-check",
+        "security.vuln-resolver",
+        "common.rag-index",
+        "common.semantic-search"
+    ],
+    "session_skills": [],
+    "session_subagents": [
+        "architect",
+        "test-engineer"
+    ]
+}