terra-hiven 3.2.0

package/LICENSE.md

@@ -0,0 +1,20 @@
+# Hiven Public License (HPL) Version 1.0
+
+Copyright (c) 2026 Hiven Authors. All rights reserved.
+
+## 1. Definitions
+*   **"Software"** refers to the Hiven source code repositories, files, workflows, templates, and documentation (including the Queen, Drone, and Worker orchestrations).
+*   **"Licensor"** refers to the copyright owners of the Software.
+*   **"You"** (or **"Your"**) refers to the individual or legal entity exercising permissions granted by this License.
+
+## 2. Grant of Rights
+*   **Use and Inspection:** You are granted a free, worldwide, non-exclusive, non-transferable license to run, install, inspect, and execute the Software for personal, educational, or internal corporate purposes.
+*   **Private Modifications:** You are permitted to modify the Software solely for Your own private, internal usage, provided that these modifications are not made available to any third party.
+
+## 3. Strict Restrictions and Prohibitions
+*   **No Redistribution:** You may NOT redistribute, publish, share, sell, rent, lease, or sub-license the Software, or any modified or unmodified derivative works thereof, to any third party in source or binary format.
+*   **No SaaS/PaaS Commercialization:** You may NOT use the Software (or any portion or derivative of it) to offer a commercial software-as-a-service (SaaS), platform-as-a-service (PaaS), managed service, API service, or cloud-hosted platform that competes directly or indirectly with Hiven.
+*   **Notice Preservation:** You must retain all copyright, trademark, and proprietary notices of the Licensor in all copies of the Software.
+
+## 4. Limitation of Liability and Disclaimer
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,233 @@
+<p align="center">
+  <img src="./assets/hiven_logo_v2.png" alt="Hiven Logo" width="150" style="border-radius: 12px; box-shadow: 0 0 20px rgba(245, 158, 11, 0.3);" />
+</p>
+
+<h1 align="center">HIVEN</h1>
+
+<p align="center">
+  <strong>Agente Cognitivo Autónomo, Mente Enjambre Multi-Agente & Memoria Colectiva Honeycombs a Coste $0</strong>
+</p>
+
+<p align="center">
+  <a href="https://amglogicalis.github.io/hiven-repo-public/"><img src="https://img.shields.io/badge/Console-Online%20Web%20Studio-d7ed04?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Live Console" /></a>
+  <a href="https://www.npmjs.com/package/terra-hiven"><img src="https://img.shields.io/badge/npm-terra--hiven-d7ed04?style=for-the-badge&logo=npm&logoColor=black" alt="npm package" /></a>
+  <img src="https://img.shields.io/badge/Version-3.0.0-d7ed04?style=for-the-badge" alt="Version 3.0.0" />
+  <img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="License MIT" />
+  <img src="https://img.shields.io/badge/Architecture-100%25%20Serverless%20$0-blueviolet?style=for-the-badge" alt="Cost $0" />
+</p>
+
+<p align="center">
+  <a href="#-visión-general-y-arquitectura-0">Visión General</a> •
+  <a href="#-instalación-y-puesta-en-marcha">Instalación</a> •
+  <a href="#-pipeline-multi-fase-y-robustez-al-99">Pipeline & Robustez</a> •
+  <a href="#-hiven-honeycombs-memoria-global">Hiven Honeycombs</a> •
+  <a href="#-referencia-del-cli-y-sdk">CLI & SDK</a> •
+  <a href="#-preguntas-frecuentes-faq">FAQ</a>
+</p>
+
+---
+
+## 🌟 Visión General y Arquitectura $0
+
+**HIVEN** es el primer titán cognitivo del ecosistema **Terra**. Transforma la potencia de cómputo gratuita de los runners de GitHub Actions en un laboratorio de desarrollo neuronal distribuido, capaz de analizar bases de código complejas, diseñar arquitecturas, escribir código mediante diffs quirúrgicos y auto-sanar errores en un sandbox aislado previo a la creación de Pull Requests:
+
+```
+                                  🐝 HIVEN ENGINE V3
+                         (Autonomous Multi-Agent Swarm)
+                                         │
+    ┌────────────────────┬───────────────┴───────────────┬────────────────────┐
+    ▼                    ▼                               ▼                    ▼
+🖥️ HIVEN STUDIO    💻 CLI & SDK (terra-hiven)      🤖 ISSUE BOT GATEWAY  🍯 HIVEN HONEYCOMBS
+(Web SPA Pages $0)  (Hiven Swarm API)               (Menciones @hiven)    (Memoria Global K/V)
+    │                    │                               │                    │
+    └────────────────────┼───────────────────────────────┴────────────────────┘
+                         ▼
+             ⚡ WORKER SWARM (GitHub Actions)
+       [Phase 0] ➔ [Phase 1] ➔ [Phase 2] ➔ [Phase 3] ➔ [🩹 Self-Heal 3-5x] ➔ [🚀 PR]
+```
+
+### Principios Fundamentales:
+* **🔒 100% Privado y Soberano:** Todo el código se procesa en runners efímeros bajo la cuenta de GitHub del usuario.
+* **🍯 Memoria Colectiva Honeycombs:** Subsistema K/V nativo a coste \$0 que acumula patrones (`hive_patterns:{ext}`) de buenas prácticas aprendidas.
+* **🩹 Garantía de Robustez del 99%:** Incorpora bucle de auto-corrección (Self-Healing Loop) reinyectando trazas de error de tests hasta lograr compilación limpia (`exit 0`).
+
+---
+
+## 📦 Instalación y Puesta en Marcha
+
+### 1. Instalación Global del CLI:
+```bash
+# Directamente desde el registro público de NPM:
+npm install -g terra-hiven
+
+# O instalando el paquete local generado (.tgz):
+npm install -g ./terra-hiven-3.2.0.tgz
+```
+
+### 2. Publicación del Paquete en NPM:
+El paquete compilado y empaquetado está listo en `c:\mis-proyectos\Terra\hiven\hiven-komb-queen\terra-hiven-3.2.0.tgz`. Para publicarlo en tu cuenta de npm:
+```bash
+npm publish terra-hiven-3.2.0.tgz --access public
+```
+
+### 3. Ejecución Instantánea sin Instalación previa con `npx`:
+```bash
+# Iniciar la Consola Web local:
+npx terra-hiven console
+
+# Despachar una misión:
+npx terra-hiven run --repo usuario/mi-app --prompt "Implementar login OAuth"
+```
+
+### 3. Instalación como Dependencia en tu Proyecto (SDK):
+```bash
+npm install terra-hiven
+```
+
+### 4. Levantar la Consola Web Local (Hiven Studio):
+```bash
+# Puerto por defecto (7460):
+hiven console
+
+# En un puerto y host personalizado:
+hiven console --port 8080 --host 0.0.0.0
+```
+
+---
+
+## 🧪 Pipeline Multi-Fase y Robustez al 99%
+
+El enjambre de Hiven ejecuta un ciclo estricto y determinista:
+
+1. **Fase 0 (Deterministic Extractor):** Extrae dependencias, scripts de test y firmas AST sin alucinaciones de LLM.
+2. **Fase 1 (Swarm Architect):** Descompone la misión en un grafo acíclico de tareas (Task DAG) y selecciona patrones de Honeycombs.
+3. **Fase 2 (Parallel Coders):** Nodos Kōmbee concurrentes escriben código aplicando bloques de búsqueda y reemplazo (`SEARCH/REPLACE`) quirúrgicos para evitar truncamiento de archivos.
+4. **Fase 3 (Shadow Sandbox):** Ejecuta la suite de pruebas unitarias (`npm test`, `pytest`, `cargo test`) en un contenedor aislado.
+5. **🩹 Bucle de Auto-Sanación (Self-Healing Loop):** Si los tests fallan, Hiven reinyecta los stack traces a un sub-enjambre de corrección (hasta 3-5 intentos) hasta que la suite pase en verde.
+6. **Fase 4 (Consolidator):** Consolida los cambios ganadores y publica la Pull Request en GitHub.
+
+---
+
+## 🍯 Hiven Honeycombs: Memoria Global Colectiva
+
+**Honeycombs** es el subsistema de almacenamiento K/V nativo de Hiven que sustituye cualquier servicio SaaS externo. Almacena:
+* **Patrones Federados (`hive_patterns:{ext}`):** Convenciones, librerías óptimas y directivas *Do's & Don'ts*.
+* **Historial & Telemetría:** Tiempos de ejecución, rondas de auto-sanación y enlaces de PRs en `.hiven-storage`.
+
+---
+
+## 💻 Referencia del CLI y SDK
+
+### Uso Programático con TypeScript / ES Modules:
+```typescript
+import { Hiven } from 'terra-hiven';
+
+const hiven = new Hiven({
+  githubToken: process.env.GITHUB_TOKEN
+});
+
+await hiven.init();
+
+// Despachar una misión autónoma
+const result = await hiven.dispatchSwarm({
+  repo: 'mi-organizacion/mi-app',
+  instruction: 'Añadir endpoints de autenticación y tests unitarios',
+  workerCount: 6,
+  testCommand: 'npm test',
+  maxSelfHealingRetries: 3
+});
+
+console.log(`Swarm despachado con éxito: ${result.swarmId}`);
+console.log(`Pull Request: ${result.pullRequestUrl}`);
+```
+
+## ⚙️ Referencia Completa de Parámetros del Despachador
+
+Tanto en la Consola Web como en el CLI (`hiven run`), puedes configurar los siguientes parámetros:
+
+| Parámetro CLI | Control Consola | Tipo / Rango | Por Defecto | Descripción & Mejores Prácticas |
+| :--- | :--- | :--- | :--- | :--- |
+| `--repo` | Repositorio Objetivo | `owner/repo` | *Requerido* | Repositorio de GitHub destino. Requiere permisos de `repo` y `workflow`. |
+| `--prompt` | Instrucción / Misión | Texto libre | *Requerido* | Especificación detallada de la tarea. Debe incluir archivos, entradas, salidas y restricciones. |
+| `--branch` | Rama de Trabajo | String | `hiven/patch-[id]` | Rama donde se subirá el commit. Si se omite, se genera con timestamp. |
+| `--baseBranch` | Rama Base | String | `main` | Rama destino contra la cual se abrirá la Pull Request. |
+| `--workers` | Kōmbees Concurrentes | 1 – 10 | `4` | Nodos en paralelo. **2** para utilidades simples, **4** para features estándar, **6-10** para refactors masivos. |
+| `--test-cmd` | Comando de Test | String | *Opcional* | Comando que el Shadow Sandbox ejecuta para verificar cambios (ej. `npm test`). **Es la brújula del Self-Healing**. |
+| `--retries` | Reintentos Self-Healing | 1, 3, 5 | `3` | Rondas máximas de auto-corrección ante fallos de tests. **3** es el balance óptimo para alcanzar el 99% de éxito. |
+| `--dry-run` | Modo de Ejecución | Boolean | `false` | Si se activa, simula la descomposición y valida diffs en local sin tocar GitHub. |
+
+---
+
+## 🎯 Manual de Buen Prompting para Enjambres
+
+Hiven no es un chatbot conversacional; es un enjambre de síntesis determinista. **Los agentes prosperan cuando les proporcionas criterios de éxito verificables, no intenciones difusas.**
+
+### La Fórmula en 4 Pasos:
+1. **Ubicación & Módulo Objetivo:** Especifica el archivo o directorio a crear o editar (ej. `src/utils/math.ts`).
+2. **Contrato de la Interfaz:** Nombres de funciones, parámetros, tipos esperados y estructura del retorno.
+3. **Casos Límite & Restricciones:** Manejo de excepciones, timeouts, nulos o compatibilidad ESM.
+4. **Criterio de Verificación:** Comando de test unitario o aserciones que deben validarse en el Shadow Sandbox.
+
+### Ejemplos Comparativos:
+
+#### ❌ Mal Prompt (Vago & Ambiguo)
+```text
+Crea un validador de emails y ponle pruebas.
+```
+> *Problema:* No define archivo, estándar regex, si lanza error o retorna boolean, ni casos edge.
+
+#### ✅ Buen Prompt (Específico & Determinista)
+```text
+Crear en src/validators/email.js la función isWorkEmail(email).
+- Debe validar formato RFC 5322 y rechazar dominios gratuitos (gmail, yahoo, hotmail).
+- Retornar { valid: boolean, domain: string, reason?: string }.
+- Si el input no es string, lanzar TypeError.
+- Exportar en ESM y crear suite de tests con al menos 6 casos límite.
+```
+
+---
+
+## 🔌 Hiven Swarm REST API (Compatibilidad con Sphexn)
+
+Al ejecutar `hiven console` o `hiven serve`, se inicia un servidor HTTP con endpoints REST estándar en `http://localhost:7460`:
+
+* **`POST /api/v1/swarm/dispatch`**: Despacha un enjambre autónomo.
+  ```json
+  {
+    "repo": "amglogicalis/mi-app",
+    "instruction": "Implementar módulo de pagos con Stripe",
+    "workers": 4,
+    "testCommand": "npm test",
+    "retries": 3
+  }
+  ```
+* **`GET /api/v1/swarm/:id`**: Consulta en tiempo real el estado, logs de actividad y URL de la Pull Request.
+* **`GET /api/v1/honeycombs/patterns?lang=ts`**: Recupera las directivas heurísticas Do's & Don'ts aprendidas.
+* **`POST /api/v1/honeycombs/patterns`**: Alimenta la memoria colectiva con nuevos patrones validados.
+* **`GET /api/v1/health`**: Estado operativo del motor Hiven y Honeycombs.
+
+---
+
+## ❓ Preguntas Frecuentes (FAQ)
+
+<details>
+<summary><strong>Q: ¿Cómo invoco a Hiven directamente en mis Issues de GitHub?</strong></summary>
+<p>
+Puedes instalar la GitHub App de Hiven en tu repositorio y simplemente comentar <code>@hiven /fix corrige el error de validación en auth.ts</code>. Hiven despertará automáticamente un runner efímero y abrirá una PR resolviendo el issue.
+</p>
+</details>
+
+<details>
+<summary><strong>Q: ¿Requiere una cuenta o suscripción externa?</strong></summary>
+<p>
+No. Hiven está construido bajo la estricta filosofía de <strong>Coste Marginal Cero ($0)</strong> de Terra. Todo el cómputo y persistencia se ejecutan en tu propia infraestructura gratuita de GitHub.
+</p>
+</details>
+
+---
+
+<p align="center">
+  <strong>HIVEN — Terra Ecosystem</strong><br>
+  Mente Enjambre & Agente Cognitivo Autónomo a Coste $0.<br>
+  <a href="https://amglogicalis.github.io/hiven-repo-public/">🌐 Abrir Consola Web Online</a> • <a href="https://github.com/amglogicalis/hiven-repo-public">Repositorio Público en GitHub</a>
+</p>

package/bin/hiven.js

@@ -0,0 +1,225 @@
+#!/usr/bin/env node
+
+import { Hiven, SwarmEngine, startConsoleServer } from "../dist/index.js";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+function printBanner() {
+  console.log(`
+  \x1b[38;5;214m   🐝 HIVEN CLI — Autonomous Swarm Intelligence Engine V3\x1b[0m
+  \x1b[90m   Terra Ecosystem • Zero-Cost Cloud Compute & Collective Honeycombs\x1b[0m
+  `);
+}
+
+function printHelp() {
+  printBanner();
+  console.log(`
+  \x1b[1mUso:\x1b[0m
+    hiven <comando> [opciones]
+    terra-hiven <comando> [opciones]
+
+  \x1b[1mComandos Disponibles:\x1b[0m
+    \x1b[33minit\x1b[0m                               Inicializa el entorno y valida la memoria Honeycombs
+    \x1b[33mrun\x1b[0m --repo <owner/repo> --prompt "..." Despacha un enjambre autónomo multi-agente
+    \x1b[33mstatus\x1b[0m <swarmId>                     Consulta el progreso y logs de un enjambre
+    \x1b[33mswarms\x1b[0m [list]                        Lista el historial de misiones y PRs generadas
+    \x1b[33mhoneycombs\x1b[0m [list|clear]              Inspecciona o gestiona la memoria de patrones
+    \x1b[33mconsole\x1b[0m [--port 7460] [--host 0.0.0.0] Inicia la consola web interactiva local
+    \x1b[33mserve\x1b[0m                                Alias de 'console'
+    \x1b[33mstudio\x1b[0m                               Alias de 'console'
+    \x1b[33mworkflow\x1b[0m [--output <path>]            Genera el archivo YAML del Swarm para GitHub Actions
+
+  \x1b[1mOpciones de 'run':\x1b[0m
+    --repo <owner/repo>            Repositorio de destino (ej. usuario/proyecto)
+    --prompt "<instrucción>"       Misión u objetivo en lenguaje natural
+    --branch <nombre>              Rama de trabajo destino (opcional)
+    --workers <1-10>               Número de Kōmbees concurrentes (defecto: 4) (opcional)
+    --test-cmd "<comando>"         Comando de verificación en Shadow Sandbox (opcional)
+    --retries <1-5>                Máximas rondas de Self-Healing (defecto: 3) (opcional)
+    --dry-run                      Simula la descomposición y ejecución local (opcional)
+
+  \x1b[1mEjemplos:\x1b[0m
+    hiven run --repo amglogicalis/mi-app --prompt "Implementar login OAuth con Google" --workers 6
+    hiven honeycombs list
+    hiven console --port 8080
+  `);
+}
+
+async function main() {
+  if (!command || command === "--help" || command === "-h" || command === "help") {
+    printHelp();
+    return;
+  }
+
+  const hiven = new Hiven();
+
+  if (command === "init") {
+    printBanner();
+    console.log("  [*] Inicializando Hiven Engine y memoria Honeycombs...");
+    await hiven.init();
+    console.log("  \x1b[32m[✓] Hiven inicializado con éxito. Honeycombs listo en .hiven-storage\x1b[0m\n");
+    return;
+  }
+
+  if (command === "console" || command === "serve" || command === "studio") {
+    printBanner();
+    let port = 7460;
+    let host = "localhost";
+    const portIdx = args.indexOf("--port");
+    if (portIdx !== -1 && args[portIdx + 1]) {
+      port = parseInt(args[portIdx + 1], 10);
+    }
+    const hostIdx = args.indexOf("--host");
+    if (hostIdx !== -1 && args[hostIdx + 1]) {
+      host = args[hostIdx + 1];
+    }
+
+    const consoleDir = path.resolve(__dirname, "../console");
+    await startConsoleServer({ port, host, consoleDir });
+    console.log(`  \x1b[32m[✓] Hiven Studio Web Console corriendo en:\x1b[0m`);
+    console.log(`      \x1b[1m\x1b[36mhttp://${host}:${port}/\x1b[0m`);
+    console.log(`  \x1b[90mPresiona Ctrl+C para detener el servidor.\x1b[0m\n`);
+    return;
+  }
+
+  if (command === "run") {
+    printBanner();
+    const repoIdx = args.indexOf("--repo");
+    const promptIdx = args.indexOf("--prompt");
+    const branchIdx = args.indexOf("--branch");
+    const workersIdx = args.indexOf("--workers");
+    const testCmdIdx = args.indexOf("--test-cmd");
+    const retriesIdx = args.indexOf("--retries");
+    const dryRun = args.includes("--dry-run");
+
+    const repo = repoIdx !== -1 ? args[repoIdx + 1] : "";
+    const prompt = promptIdx !== -1 ? args[promptIdx + 1] : "";
+    const branch = branchIdx !== -1 ? args[branchIdx + 1] : undefined;
+    const workers = workersIdx !== -1 ? parseInt(args[workersIdx + 1], 10) : 4;
+    const testCommand = testCmdIdx !== -1 ? args[testCmdIdx + 1] : undefined;
+    const maxRetries = retriesIdx !== -1 ? parseInt(args[retriesIdx + 1], 10) : 3;
+
+    if (!repo || !prompt) {
+      console.error("  \x1b[31m[!] Error: Se requieren los parámetros --repo y --prompt\x1b[0m");
+      console.log("      Ejemplo: hiven run --repo usuario/repo --prompt 'Refactorizar módulo de pagos'");
+      process.exit(1);
+    }
+
+    console.log(`  [*] Despachando Enjambre Autónomo para \x1b[1m${repo}\x1b[0m...`);
+    console.log(`      • Kōmbees: ${workers} en paralelo`);
+    console.log(`      • Misión: "${prompt}"`);
+    console.log(`      • Self-Healing: hasta ${maxRetries} reintentos\n`);
+
+    const result = await hiven.dispatchSwarm({
+      repo,
+      instruction: prompt,
+      branch,
+      workerCount: workers,
+      testCommand,
+      maxSelfHealingRetries: maxRetries,
+      dryRun
+    });
+
+    console.log(`  \x1b[32m[✓] Swarm despachado con éxito (ID: ${result.swarmId})\x1b[0m`);
+    console.log(`      • Estado: ${result.status}`);
+    console.log(`      • Rama: ${result.branch}`);
+    console.log(`      • Tareas planificadas (DAG): ${result.taskGraph?.nodes.length || 3} nodos`);
+    if (result.pullRequestUrl) {
+      console.log(`      • Pull Request: \x1b[36m${result.pullRequestUrl}\x1b[0m`);
+    }
+    console.log("");
+    return;
+  }
+
+  if (command === "status") {
+    printBanner();
+    const swarmId = args[1];
+    if (!swarmId) {
+      console.error("  \x1b[31m[!] Error: Especifica el ID del enjambre: hiven status <swarmId>\x1b[0m");
+      process.exit(1);
+    }
+    const status = await hiven.getSwarmStatus(swarmId);
+    if (!status) {
+      console.log(`  \x1b[33m[!] No se encontraron registros para el Swarm ID '${swarmId}'\x1b[0m\n`);
+      return;
+    }
+    console.log(`  \x1b[1mInformación del Swarm:\x1b[0m`);
+    console.log(`  • ID: ${status.swarmId}`);
+    console.log(`  • Repositorio: ${status.repo}`);
+    console.log(`  • Estado: \x1b[32m${status.status}\x1b[0m`);
+    console.log(`  • Fase Actual: ${status.currentPhase}`);
+    console.log(`  • Progreso: ${status.progressPercent}%`);
+    console.log("\n  \x1b[1mLogs de Actividad:\x1b[0m");
+    status.logs.forEach(l => console.log(`    \x1b[90m›\x1b[0m ${l}`));
+    console.log("");
+    return;
+  }
+
+  if (command === "honeycombs") {
+    printBanner();
+    const sub = args[1] || "list";
+    if (sub === "list") {
+      const patterns = await hiven.getLearnedPatterns();
+      const langs = Object.keys(patterns);
+      console.log(`  \x1b[1mMemoria Global Honeycombs (Celdas: ${langs.length}):\x1b[0m`);
+      if (langs.length === 0) {
+        console.log("  \x1b[90m(Aún no hay patrones registrados. Se aprenderán automáticamente con cada misión)\x1b[0m\n");
+        return;
+      }
+      for (const lang of langs) {
+        console.log(`  \x1b[33m🐝 Lenguaje/Entorno: [${lang.toUpperCase()}]\x1b[0m (${patterns[lang].length} patrones)`);
+        patterns[lang].forEach(p => {
+          console.log(`     • [${p.patternType}] \x1b[1m${p.summary}\x1b[0m (Usos: ${p.usageCount})`);
+          console.log(`       \x1b[32mDo:\x1b[0m ${p.doDirective}`);
+          if (p.dontDirective) console.log(`       \x1b[31mDon't:\x1b[0m ${p.dontDirective}`);
+        });
+      }
+      console.log("");
+      return;
+    } else if (sub === "clear") {
+      await hiven.honeycombs.clearPatterns();
+      console.log("  \x1b[32m[✓] Memoria global Honeycombs purgada con éxito.\x1b[0m\n");
+      return;
+    }
+  }
+
+  if (command === "swarms") {
+    printBanner();
+    const list = await hiven.listSwarms();
+    console.log(`  \x1b[1mHistorial de Misiones del Enjambre (${list.length}):\x1b[0m`);
+    if (list.length === 0) {
+      console.log("  \x1b[90m(No hay misiones registradas. Despacha una con 'hiven run')\x1b[0m\n");
+      return;
+    }
+    list.forEach((s, idx) => {
+      console.log(`  ${idx + 1}. \x1b[1m${s.repo}\x1b[0m [\x1b[32m${s.status}\x1b[0m] (${s.swarmId})`);
+      console.log(`     "${s.summary}"`);
+      console.log(`     Iniciado: ${s.startedAt}`);
+    });
+    console.log("");
+    return;
+  }
+
+  if (command === "workflow") {
+    const yaml = SwarmEngine.generateWorkflowYaml({
+      repo: "user/project",
+      instruction: "Autonomous Task Execution",
+      workerCount: 4
+    });
+    console.log(yaml);
+    return;
+  }
+
+  console.log(`  \x1b[31m[!] Comando desconocido: '${command}'\x1b[0m`);
+  printHelp();
+}
+
+main().catch(err => {
+  console.error(`\x1b[31m[!] Error fatal:\x1b[0m ${err.message}`);
+  process.exit(1);
+});