higpertext-cli 0.8.0__tar.gz

higpertext_cli-0.8.0/MANIFEST.in

@@ -0,0 +1,6 @@
+recursive-include src/higpertext/capabilities *.json *.sh *.md
+recursive-include src/higpertext/templates *.json *.md *.yaml
+recursive-include src/higpertext/hooks *.json *.yaml
+recursive-include src/config *.yaml *.yml *.json *.md
+recursive-include src/workflows *.yaml *.yml *.json
+include requirements.txt

higpertext_cli-0.8.0/PKG-INFO

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: higpertext-cli
+Version: 0.8.0
+Summary: higpertext Engine — LLM-powered terminal agent framework
+Author-email: Angel Ortega <codenodehg@gmail.com>
+License: Proprietary
+Project-URL: Homepage, https://github.com/aomerge/higpertext
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.10
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: urllib3>=1.26.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tqdm>=4.65.0
+Provides-Extra: gemini
+Requires-Dist: google-generativeai>=0.5.0; extra == "gemini"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: flake8>=7.0.0; extra == "dev"
+Requires-Dist: pylint>=4.0.0; extra == "dev"
+Requires-Dist: bandit>=1.7.0; extra == "dev"
+Requires-Dist: autopep8>=2.0.0; extra == "dev"
+Requires-Dist: isort>=5.0.0; extra == "dev"
+Requires-Dist: radon>=6.0.0; extra == "dev"

higpertext_cli-0.8.0/README.md

@@ -0,0 +1,160 @@
+# 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. El agente no puede salirse de los rieles definidos por tu gobernanza.
+
+---
+
+## Instalación
+
+```bash
+pip install higpertext-cli
+```
+
+Verifica que el CLI está disponible:
+
+```bash
+htx --help
+```
+
+---
+
+## Concepto central
+
+Un **perfil** define qué puede hacer el agente, qué está prohibido, y cómo debe comportarse. Los **hooks** aplican esas reglas en tiempo real — interceptan comandos y redirigen al agente a las capacidades correctas.
+
+```
+tu-agente/
+├── src/config/profiles/software_developer.json   ← quién es el agente
+├── src/capabilities/                              ← qué puede hacer
+└── src/templates/skills/                         ← conocimiento especializado
+```
+
+El motor es neutro — los perfiles y capacidades viven en tu agente externo.
+
+---
+
+## Inicio rápido
+
+### 1. Inicializa un workspace
+
+```bash
+mkdir mi-proyecto && cd mi-proyecto
+htx agent init --profile global --assistant claude
+```
+
+### 2. Instala un perfil externo
+
+```bash
+htx profile install software_developer --source /ruta/a/tu-agente
+htx profile load software_developer --assistant claude
+```
+
+### 3. Ejecuta una capacidad
+
+```bash
+htx task common.grep-search --pattern "class.*Service" --path src/
+htx task git.committer --message "feat(auth): add JWT validation"
+```
+
+### 4. Corre un workflow
+
+```bash
+htx workflow run higpertext-build
+```
+
+---
+
+## Crear tu propio agente
+
+Un agente externo es un repositorio con esta estructura mínima:
+
+```
+mi-agente/
+└── src/
+    ├── config/
+    │   └── profiles/
+    │       └── mi_perfil.json
+    ├── capabilities/
+    │   └── mi_namespace/
+    │       ├── mi-capability.json
+    │       └── scripts/
+    │           └── mi_script.py
+    └── templates/
+        └── skills/
+            └── mi-skill/
+                └── skill.json
+```
+
+**Perfil mínimo** (`src/config/profiles/mi_perfil.json`):
+
+```json
+{
+    "name": "mi_perfil",
+    "description": "Mi agente personalizado",
+    "extends": "base_developer",
+    "capabilities": ["mi_namespace.mi-capability"],
+    "session_skills": [],
+    "session_subagents": []
+}
+```
+
+Instálalo:
+
+```bash
+htx profile install mi_perfil --source /ruta/a/mi-agente
+htx profile load mi_perfil --assistant claude
+```
+
+---
+
+## Asistentes soportados
+
+| Asistente | Configuración generada |
+|-----------|----------------------|
+| Claude Code | `.claude/rules/`, `.claude/commands/`, hooks nativos |
+| Gemini | `GEMINI.md`, `.gemini/rules/` |
+| OpenCode | `AGENTS.md`, `.opencode/rules/`, `.opencode/agents/` |
+| GitHub Copilot | `.github/copilot-instructions.md`, `.github/instructions/` |
+| Antigravity | `AGENTS.md`, `.agents/rules/` |
+
+---
+
+## Providers LLM
+
+El motor no requiere ningún SDK de LLM instalado. Instala solo lo que necesitas:
+
+```bash
+pip install higpertext-cli[gemini]    # Google Gemini
+```
+
+Anthropic, OpenAI y Ollama se integran via variables de entorno — sin dependencias adicionales.
+
+---
+
+## Comandos principales
+
+```bash
+# Perfiles
+htx profile load <nombre> --assistant <claude|gemini|opencode>
+htx profile install <nombre> --source <path>
+htx profile validate <nombre>
+
+# Capacidades
+htx task <namespace.capability> --<param> <valor>
+htx task common.list-rules          # ver capacidades disponibles
+
+# Workflows
+htx workflow run <nombre>
+
+# Diagnóstico
+htx task common.doctor
+```
+
+---
+
+## Requisitos
+
+- Python >= 3.10
+- Un asistente IA compatible (Claude Code, OpenCode, Gemini CLI, etc.)

higpertext_cli-0.8.0/pyproject.toml

@@ -0,0 +1,77 @@
+[build-system]
+requires = ["setuptools>=68", "wheel", "build"]
+build-backend = "setuptools.build_meta"
+
+
+[project]
+name = "higpertext-cli"
+authors = [{name = "Angel Ortega", email = "codenodehg@gmail.com"}]
+version = "0.8.0"
+description = "higpertext Engine — LLM-powered terminal agent framework"
+requires-python = ">=3.10"
+license = {text = "Proprietary"}
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+dependencies = [
+    "python-dotenv>=1.0.0",
+    "requests>=2.28.0",
+    "urllib3>=1.26.0",
+    "pyyaml>=6.0",
+    "pydantic>=2.0.0",
+    "rich>=13.0.0",
+    "tqdm>=4.65.0",
+]
+
+[project.optional-dependencies]
+gemini = [
+    "google-generativeai>=0.5.0",
+]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-mock>=3.10.0",
+    "pytest-cov>=5.0.0",
+    "flake8>=7.0.0",
+    "pylint>=4.0.0",
+    "bandit>=1.7.0",
+    "autopep8>=2.0.0",
+    "isort>=5.0.0",
+    "radon>=6.0.0",
+]
+
+[project.scripts]
+htx = "higpertext.kernel.infrastructure.cli.router:main"
+
+[project.urls]
+Homepage = "https://github.com/aomerge/higpertext"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+exclude = ["tests*", "*.tests*"]
+
+[tool.setuptools.package-data]
+"*" = [
+    "capabilities/**/*.json",
+    "capabilities/**/*.sh",
+    "capabilities/**/*.md",
+    "config/**/*",
+    "workflows/**/*",
+    "templates/**/*",
+    "hooks/**/*.json",
+    "hooks/**/*.yaml",
+    "hooks/hooks_catalog.json",
+]
+
+[tool.pytest.ini_options]
+addopts = "-q --tb=short"
+
+[tool.black]
+line-length = 100
+

higpertext_cli-0.8.0/requirements.txt

@@ -0,0 +1,10 @@
+# Dependency source of truth is pyproject.toml.
+# Runtime deps: [project] dependencies.
+# Dev/test/lint deps: [project.optional-dependencies] dev.
+#
+# Install for local development:
+#   pip install -e .[dev]
+#
+# Install for production/runtime only:
+#   pip install .
+-e .[dev]

higpertext_cli-0.8.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

higpertext_cli-0.8.0/setup.py

@@ -0,0 +1,28 @@
+"""
+Build entrypoint — setuptools invoca este archivo automáticamente.
+Instala src/core y src/capabilities como código Python puro sin Cython.
+"""
+from setuptools import setup, find_packages
+
+setup(
+    packages=find_packages("src") + ["higpertext_data"],
+    package_dir={"": "src", "higpertext_data": "src"},
+    package_data={
+        "higpertext_data": [
+            "capabilities/**/*.json",
+            "capabilities/**/*.sh",
+            "capabilities/**/*.md",
+            "config/**/*",
+            "workflows/**/*",
+            "hooks/**/*.yaml",
+            "hooks/**/*.yml",
+            "hooks/**/*.json",
+            "core/templates/**/*",
+            "higpertext/templates/**/*",
+            "higpertext/capabilities/**/*.json",
+            "higpertext/capabilities/**/*.sh",
+            "higpertext/capabilities/**/*.md",
+            "higpertext/hooks/hooks_catalog.json",
+        ],
+    },
+)