hormigasais-edge-starter 0.1.2 → 0.1.3

package/LICENSE

@@ -0,0 +1,48 @@
+HormigasAIS Source-Available License (Proprietary)
+Versión 1.0 — hormigasais-edge-starter
+
+Copyright (c) 2026 Cristhiam Leonardo Hernández Quiñonez (CLHQ)
+Todos los derechos reservados.
+
+1. Naturaleza de esta licencia
+
+Esta no es una licencia de código abierto ni una Business Source License.
+Es una licencia propietaria de código fuente visible ("source-available"):
+el código puede leerse, estudiarse y auditarse públicamente, pero su uso,
+copia, modificación y redistribución requieren autorización explícita del
+Licenciante.
+
+2. Lo que SÍ está permitido sin autorización adicional
+
+  - Leer y estudiar el código fuente con fines de evaluación o auditoría.
+  - Hacer fork privado únicamente para revisión personal, sin distribuir
+    ni desplegar en producción.
+  - Instalar el paquete desde el registro npm y ejecutar el generador
+    (create-hormigas-node) para crear y probar un nodo propio con fines
+    de evaluación, aprendizaje o uso personal no comercial. Los archivos
+    de configuración generados para el nodo (p. ej. node_config.json)
+    pertenecen a quien los genera. El uso en producción sigue sujeto
+    a la sección 3.
+
+3. Lo que requiere autorización explícita de CLHQ
+
+  - Uso en producción, propio o de terceros.
+  - Redistribución, en forma original o modificada.
+  - Creación de obras derivadas destinadas a distribución o uso público.
+  - Cualquier uso comercial.
+
+4. Vigencia
+
+Esta licencia no tiene fecha de conversión a una licencia de código
+abierto. El Licenciante (CLHQ) retiene control indefinido sobre los
+términos de uso de hormigasais-edge-starter, y puede otorgar licencias adicionales
+o cambiar estos términos para versiones futuras a su propio criterio.
+
+5. Sin garantía
+
+EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO,
+EXPRESA O IMPLÍCITA, INCLUYENDO PERO NO LIMITADO A GARANTÍAS DE
+COMERCIABILIDAD, IDONEIDAD PARA UN PROPÓSITO PARTICULAR Y NO INFRACCIÓN.
+
+Para solicitar una licencia de uso, contactar a CLHQ a través de
+github.com/Thrumanshow.

package/README.md

@@ -4,28 +4,31 @@ Starter oficial para desplegar un **nodo soberano** de HormigasAIS con agentes L
 
 > "Soberanía digital en el edge"
 
-## 🚀 Instalación Rápida
+## 🚀 Instalación
 
-### Opción 1: Desde GitHub (Recomendada actualmente)
+### Opción 1 — Starter CLI vía npm (recomendado)
 
-\`\`\`bash
-npx create-hormigas-node@latest
-\`\`\`
+El starter técnico se distribuye como paquete npm independiente, sin el contenido pedagógico completo:
 
-O manualmente:
+    npm install -g @hormigasais/edge-starter
+    hormigasais-edge --help
+    hormigasais-edge bootstrap
+    hormigasais-edge validate
 
-\`\`\`bash
-git clone https://github.com/Thrumanshow/hormigasais-edge-starter.git
-cd hormigasais-edge-starter
-bash bootstrap.sh
-python3 generator.py
-\`\`\`
+Por defecto, el laboratorio se crea en .hormigasais-edge-lab/ en el directorio actual. Puedes cambiar la ubicación con LAB_DIR:
 
-### Opción 2:
+    LAB_DIR="$HOME/hormigasais-edge-lab" hormigasais-edge bootstrap
 
-\`\`\`bash
-npx create-hormigas-node
-\`\`\`
+Paquete: [@hormigasais/edge-starter](https://www.npmjs.com/package/@hormigasais/edge-starter)
+
+### Opción 2 — Clonar el repositorio completo (incluye el curso)
+
+    git clone https://github.com/Thrumanshow/hormigasais-edge-starter.git
+    cd hormigasais-edge-starter
+    bash bootstrap.sh
+    python3 generator.py
+
+Usa esta opción si además del starter quieres acceso al curso práctico completo (./course/).
 
 ## ¿Qué incluye?
 
@@ -65,3 +68,30 @@ Author: Cristhiam Leonardo Hernández Quiñonez (CLHQ)
 © HormigasAIS • Lenguaje Binario HormigasAIS (LBH)
 
 [hormigasais.com](https://hormigasais.com) | [@Thrumanshow](https://github.com/Thrumanshow)
+
+## Curso Práctico
+
+El directorio [`course/`](./course/) contiene un laboratorio educativo aislado para aprender administración Edge y protocolos LBH desde Android/Termux. Sus scripts utilizan fixtures y no requieren secretos reales. Consulta [`course/README.md`](./course/README.md) para comenzar.
+
+---
+
+## 📄 Componentes y Enlaces del Ecosistema
+
+| Repo | Descripción |
+| :--- | :--- |
+| **LBH-Net** | Red soberana P2P :9199/:9200 |
+| **Institucionalidad** | Foundation & Governance |
+
+---
+
+### Arquitectura y Ecosistema HormigasAIS
+* **Red P2P Base:** [LBH-Net](https://github.com/HormigasAIS/LBH-Net) — Red soberana distribuida basada en Protocolo LBH (Termux / UDP :9199 / TCP :9200 / SQLite / Ed25519).
+* **Vitrina Oficial:** [hormigasais.com](https://hormigasais.com)
+* **Documentación Técnica:** [docs.hormigasais.com](https://docs.hormigasais.com)
+* **Fundador:** CLHQ — Cristhiam Leonardo Hernández Quiñonez | El Salvador 2026 | DOI: 10.5281/zenodo.17767205
+
+## Licencia
+
+HormigasAIS Source-Available License v1.0 (ver `LICENSE`). Puedes leer y estudiar el código, e instalar el paquete para generar y probar un nodo propio con fines personales no comerciales. El uso en producción, la redistribución y el uso comercial requieren autorización de CLHQ.
+
+Las versiones 0.1.0 a 0.1.2 se publicaron declarando MIT; desde la 0.1.3 rige esta licencia.

package/agents/colonia_bus.py

@@ -0,0 +1,58 @@
+import subprocess, json, sys, time, threading
+
+VERSION = "0.3.0"
+
+def reporter(trampa_ref, intervalo=30):
+    while True:
+        time.sleep(intervalo)
+        estado = "ACTIVO" if trampa_ref.activo else "LETARGO"
+        print(f"\n[REPORTE] Capturas={trampa_ref.total_capturas} | "
+              f"Estado={estado} | Temp={trampa_ref.temperatura}C")
+
+def iniciar_colonia():
+    print(f"[HormigasAIS] Colonia Nodo Escuela v{VERSION}")
+    print("[BUS] Acoplando subprocesos y cargando contratos...")
+    print("-" * 70)
+
+    try:
+        from hormiga_trampa import HormigaTrampa
+        trampa = HormigaTrampa()
+    except ImportError:
+        print("[ERROR] Falta hormiga_trampa.py")
+        return
+
+    threading.Thread(
+        target=reporter, args=(trampa, 30), daemon=True
+    ).start()
+
+    proceso = subprocess.Popen(
+        ["python3", "hormiga_centinela.py"],
+        stdout=subprocess.PIPE,
+        stderr=subprocess.STDOUT,
+        text=True,
+        bufsize=1,
+    )
+
+    try:
+        for linea in iter(proceso.stdout.readline, ""):
+            linea = linea.strip()
+            if "FEROMONA_EMITIDA ==>" in linea:
+                partes = linea.split("==>")
+                if len(partes) > 1:
+                    trampa.escuchar_bus(partes[1].strip())
+            elif "*" in linea:
+                sys.stdout.write("* ")
+                sys.stdout.flush()
+                trampa.escuchar_bus('{"type":"env_clear"}')
+    except KeyboardInterrupt:
+        print("\n\n[INTERRUPCION] Apagado manual detectado.")
+    except Exception as e:
+        print(f"\n[FALLO BUS] Anomalia: {e}")
+    finally:
+        print("\n[FAILSAFE] Protocolo de desconexion segura...")
+        proceso.terminate()
+        trampa.apagado_seguro()
+        print("[OK] Colonia cerrada de forma soberana.")
+
+if __name__ == "__main__":
+    iniciar_colonia()

package/agents/hormiga_centinela.py

@@ -1,41 +1,68 @@
-#!/usr/bin/env python3
-"""
-hormiga_centinela.py
-"""
-import time
-import json
-import sys
-from pathlib import Path
-
-ROOT = Path(__file__).resolve().parent.parent
-sys.path.insert(0, str(ROOT))
-
-from utils.env_loader import load_termux_secrets
-load_termux_secrets()
-
-from protocols.encoder import make_header, encode_packet
-from protocols.constants import TYPE_CODES
-from protocols.signer import seal_action
-
-NODE_ID = "A16"
-OWNER = "Cristhiam Leonardo Hernández Quiñonez"
-INTERVAL = 30
-
-def emit_pulse():
-    payload = json.dumps({
-        "agent": "hormiga_centinela",
-        "status": "ACTIVE",
-        "node": NODE_ID,
-        "ts": int(time.time())
-    })
-    header = make_header(NODE_ID[:3], "00")
-    frame = encode_packet(header, TYPE_CODES["FUEL"], payload)
-    seal = seal_action(payload, OWNER)
-    print("[CENTINELA] FUEL pulse emitido")
-    return frame
+import os
+import time, json, random, sys, hmac, hashlib
+
+VERSION   = "0.3.0"
+NODE_ID   = "centinela_escuela_01"
+TARGET    = "mosquito_pulse"
+SECRET    = os.environ.get("LAB_ESCUELA_SECRET", "hormigasais-colonia-escuela-demo").encode()
+
+class UmbralAdaptativo:
+    def __init__(self, base=0.75, ventana=20):
+        self.historial = []
+        self.base      = base
+        self.ventana   = ventana
+
+    def actualizar(self, v):
+        self.historial.append(v)
+        if len(self.historial) > self.ventana:
+            self.historial.pop(0)
+
+    @property
+    def umbral(self):
+        if len(self.historial) < 5:
+            return self.base
+        media = sum(self.historial) / len(self.historial)
+        return round(min(media + 0.15, 0.92), 3)
+
+def firmar(paquete_dict):
+    payload = json.dumps(paquete_dict, sort_keys=True).encode()
+    sig     = hmac.new(SECRET, payload, hashlib.sha256).hexdigest()[:16]
+    paquete_dict["sig"] = sig
+    return json.dumps(paquete_dict)
+
+def generar_feromona(intensidad):
+    p = {
+        "timestamp": round(time.time(), 6),
+        "type":      TARGET,
+        "origin":    NODE_ID,
+        "status":    "active",
+        "intensity": round(intensidad, 2),
+        "version":   VERSION,
+    }
+    return firmar(p)
+
+def ejecutar():
+    ua = UmbralAdaptativo()
+    print(f"[HormigasAIS] Centinela [{NODE_ID}] v{VERSION}")
+    print(f"Escaneando espectro infrarrojo... Ctrl+C para detener.")
+    print("-" * 70)
+    try:
+        while True:
+            lectura = random.uniform(0.1, 1.0)
+            ua.actualizar(lectura)
+            if lectura > ua.umbral:
+                print(f"[ALERTA] Gradiente={round(lectura,2)} Umbral={ua.umbral}")
+                paquete = generar_feromona(lectura)
+                print(f"[XOXO-BUS] FEROMONA_EMITIDA ==> {paquete}")
+                print("[BUS] Nodos trampa alertados.")
+                print("-" * 70)
+                time.sleep(5)
+            else:
+                sys.stdout.write("* ")
+                sys.stdout.flush()
+                time.sleep(1.5)
+    except KeyboardInterrupt:
+        print("\n[STOP] Centinela detenido. Modo letargo.")
 
 if __name__ == "__main__":
-    print(f"[CENTINELA] Iniciando en nodo {NODE_ID}")
-    while True:
-        emit_pulse()
-        time.sleep(INTERVAL)
+    ejecutar()

package/agents/hormiga_centinela_hw.py

@@ -0,0 +1,72 @@
+import os
+import serial, json, sys, time, hmac, hashlib
+
+VERSION  = "1.0.0-hw"
+NODE_ID  = "centinela_hw_01"
+SECRET   = os.environ.get("LAB_ESCUELA_SECRET", "hormigasais-colonia-escuela-demo").encode()
+PORT     = "/dev/ttyUSB0"   # Termux: ls /dev/tty* para confirmar
+BAUD     = 115200
+
+def firmar(d):
+    payload = json.dumps(d, sort_keys=True).encode()
+    sig = hmac.new(SECRET, payload, hashlib.sha256).hexdigest()[:16]
+    d["sig"] = sig
+    return json.dumps(d)
+
+def abrir_serial():
+    intentos = 0
+    while intentos < 5:
+        try:
+            s = serial.Serial(PORT, BAUD, timeout=2)
+            print(f"[HW] Puerto {PORT} abierto a {BAUD} baud.")
+            return s
+        except serial.SerialException as e:
+            intentos += 1
+            print(f"[HW] Reintento {intentos}/5 — {e}")
+            time.sleep(3)
+    print(f"[ERROR] No se pudo abrir {PORT}. Verifica: pkg install python-pyserial")
+    sys.exit(1)
+
+def ejecutar():
+    print(f"[HormigasAIS] Centinela Hardware [{NODE_ID}] v{VERSION}")
+    print(f"[HW] Escuchando ESP8266 en {PORT}...")
+    print("-" * 70)
+    ser = abrir_serial()
+    try:
+        while True:
+            linea = ser.readline().decode("utf-8", errors="ignore").strip()
+            if not linea:
+                sys.stdout.write("* ")
+                sys.stdout.flush()
+                continue
+            try:
+                d = json.loads(linea)
+            except json.JSONDecodeError:
+                continue
+
+            # Boot message del ESP
+            if "boot" in d:
+                print(f"\n[HW] ESP8266 conectado: {d}")
+                continue
+
+            # Evento de deteccion real
+            if d.get("type") == "mosquito_pulse":
+                d["origin"] = NODE_ID
+                d["version"] = VERSION
+                # Firmar antes de emitir al bus
+                paquete = firmar(d)
+                print(f"\n[ALERTA] Sensor PIR activado (I={d.get('intensity', 0):.2f})")
+                print(f"[XOXO-BUS] FEROMONA_EMITIDA ==> {paquete}")
+                print("[BUS] Nodos trampa alertados.")
+                print("-" * 70)
+                # Cooldown para no saturar
+                time.sleep(4)
+
+    except KeyboardInterrupt:
+        print("\n[STOP] Centinela hardware detenido.")
+    finally:
+        ser.close()
+        print("[HW] Puerto serial cerrado.")
+
+if __name__ == "__main__":
+    ejecutar()

package/agents/hormiga_trampa.py

@@ -0,0 +1,95 @@
+import os
+import time, json, hmac, hashlib
+
+VERSION          = "0.3.0"
+NODE_ID          = "trampa_escuela_01"
+TRIGGER_TYPE     = "mosquito_pulse"
+CICLOS_GRACIA    = 4
+SECRET           = os.environ.get("LAB_ESCUELA_SECRET", "hormigasais-colonia-escuela-demo").encode()
+LOG_FILE         = "capturas.jsonl"
+
+class HormigaTrampa:
+    def __init__(self):
+        self.activo              = False
+        self.temperatura         = 24.0
+        self.ciclos_sin_feromona = 0
+        self.total_capturas      = 0
+        self._ultimo_ts          = 0.0   # anti-duplicado
+
+    # ── Verificación HMAC ──────────────────────────────────────────────
+    def _verificar(self, d):
+        sig_rx = d.pop("sig", "")
+        payload = json.dumps(d, sort_keys=True).encode()
+        sig_ok  = hmac.new(SECRET, payload, hashlib.sha256).hexdigest()[:16]
+        d["sig"] = sig_rx          # restaurar para no mutar el dict
+        return hmac.compare_digest(sig_rx, sig_ok)
+
+    # ── Registro soberano ──────────────────────────────────────────────
+    def _registrar(self, intensidad):
+        entrada = {
+            "ts":        round(time.time(), 3),
+            "node":      NODE_ID,
+            "intensidad": intensidad,
+            "succion":   "MAX" if intensidad > 0.85 else "MOD",
+        }
+        with open(LOG_FILE, "a") as f:
+            f.write(json.dumps(entrada) + "\n")
+
+    # ── Bus principal ──────────────────────────────────────────────────
+    def escuchar_bus(self, paquete_crudo):
+        try:
+            d = json.loads(paquete_crudo)
+        except Exception:
+            return
+
+        if d.get("type") == TRIGGER_TYPE and d.get("status") == "active":
+            # Anti-duplicado: ignorar si mismo timestamp ya procesado
+            ts = d.get("timestamp", 0)
+            if ts == self._ultimo_ts:
+                return
+            self._ultimo_ts = ts
+
+            if not self._verificar(dict(d)):
+                print(f"[SEGURIDAD] Firma invalida — paquete descartado.")
+                return
+
+            self.ciclos_sin_feromona = 0
+            self.reaccionar(d.get("intensity", 0.5))
+        else:
+            self.evaluar_disipacion()
+
+    # ── Reacción ───────────────────────────────────────────────────────
+    def reaccionar(self, intensidad):
+        self.activo      = True
+        self.temperatura = 36.5
+        self.total_capturas += 1
+        succion = "100% (MAXIMA)" if intensidad > 0.85 else "60% (MODERADA)"
+
+        print(f"\n[{NODE_ID}] Feromona detectada (I={intensidad} | Captura #{self.total_capturas})")
+        print(f"[ACTUADOR] Resistencia IR -> {self.temperatura}C")
+        print(f"[MECANICO] Extractor al {succion}")
+        print("-" * 65)
+        self._registrar(intensidad)
+
+    # ── Disipación ─────────────────────────────────────────────────────
+    def evaluar_disipacion(self):
+        if not self.activo:
+            return
+        self.ciclos_sin_feromona += 1
+        restantes = CICLOS_GRACIA - self.ciclos_sin_feromona
+        if restantes > 0:
+            print(f"\n[{NODE_ID}] Silencio. Persistencia biologica ({restantes} ciclos)...")
+            print(f"[ACTUADOR] Manteniendo gradiente a {self.temperatura}C")
+            print("-" * 65)
+        else:
+            print(f"\n[{NODE_ID}] Feromona evaporada.")
+            self.apagado_seguro()
+
+    # ── Apagado ────────────────────────────────────────────────────────
+    def apagado_seguro(self):
+        if self.activo:
+            self.temperatura = 24.0
+            self.activo      = False
+            print("[BAJO CONSUMO] Extractor OFF. IR -> 24C. Modo letargo.")
+            print(f"[STATS] Total capturas esta sesion: {self.total_capturas}")
+            print("-" * 65)

package/agents/hormiga_trampa_hw_ext.py

@@ -0,0 +1,58 @@
+# EXTENSION para hormiga_trampa.py — agregar metodo activar_gpio()
+# Conectar segundo ESP8266 (o mismo via segundo canal) que controle:
+#   D1 -> Relay Resistencia IR
+#   D2 -> Relay Ventilador
+#   D3 -> LED UV (ya activo en firmware, este lo modula)
+
+import serial, json, time
+
+PUERTO_TRAMPA = "/dev/ttyUSB1"  # Si hay segundo ESP; si es uno solo, mismo puerto
+BAUD_TRAMPA   = 115200
+
+class GPIOBridge:
+    def __init__(self):
+        self.ser = None
+        self._conectar()
+
+    def _conectar(self):
+        try:
+            self.ser = serial.Serial(PUERTO_TRAMPA, BAUD_TRAMPA, timeout=1)
+            print(f"[HW-TRAMPA] GPIO Bridge activo en {PUERTO_TRAMPA}")
+        except Exception as e:
+            print(f"[HW-TRAMPA] Sin GPIO Bridge: {e} — modo simulacion activo")
+            self.ser = None
+
+    def _enviar(self, cmd):
+        if self.ser and self.ser.is_open:
+            try:
+                self.ser.write((json.dumps(cmd) + "\n").encode())
+            except Exception as e:
+                print(f"[HW-TRAMPA] Error GPIO: {e}")
+
+    def activar_trampa(self, intensidad):
+        potencia = 100 if intensidad > 0.85 else 60
+        self._enviar({
+            "cmd": "trampa_on",
+            "ir_on": True,
+            "fan_pct": potencia,
+            "uv_on": True
+        })
+
+    def apagar_trampa(self):
+        self._enviar({
+            "cmd": "trampa_off",
+            "ir_on": False,
+            "fan_pct": 0,
+            "uv_on": True  # UV siempre activo para atraccion pasiva
+        })
+
+    def cerrar(self):
+        if self.ser:
+            self.apagar_trampa()
+            time.sleep(0.5)
+            self.ser.close()
+
+# Instrucciones de integracion:
+# 1. En HormigaTrampa.__init__() agregar: self.gpio = GPIOBridge()
+# 2. En reaccionar() agregar:             self.gpio.activar_trampa(intensidad)
+# 3. En apagado_seguro() agregar:         self.gpio.apagar_trampa()

package/bootstrap.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# HormigasAIS Edge Starter — bootstrap.sh
+# Prepara el entorno antes de ejecutar generator.py
+
+set -Eeuo pipefail
+
+echo "🐜 HormigasAIS Edge Starter — Bootstrap"
+echo "========================================"
+
+# 1. Validar Python3
+if ! command -v python3 >/dev/null 2>&1; then
+  echo "❌ python3 no encontrado. Instálalo antes de continuar."
+  exit 1
+fi
+echo "✅ python3: $(python3 --version)"
+
+# 2. Validar Node (opcional, solo si se usará generator.js)
+if command -v node >/dev/null 2>&1; then
+  echo "✅ node: $(node --version)"
+else
+  echo "⚠️ node no encontrado (opcional, solo necesario para generator.js)"
+fi
+
+# 3. Crear directorios base si no existen
+mkdir -p logs generators .hormigasais
+echo "✅ Directorios base verificados: logs/, generators/, .hormigasais/"
+
+# 4. Instalar dependencias npm solo si existe package.json y node/npm disponibles
+if [ -f package.json ] && command -v npm >/dev/null 2>&1; then
+  echo "📦 Instalando dependencias npm..."
+  npm install --omit=dev
+else
+  echo "⚠️ Saltando npm install (sin package.json o sin npm)"
+fi
+
+echo "========================================"
+echo "✅ Bootstrap completado. Siguiente paso:"
+echo "   python3 generator.py"

package/generator.js

@@ -1,42 +1,36 @@
 #!/usr/bin/env node
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
+import fs from 'node:fs';
+import path from 'node:path';
 
 const targetName = process.argv[2] || 'mi-colonia';
 const targetDir = path.join(process.cwd(), targetName);
 
-console.log(`🐜 [HormigasAIS] Desplegando nodo soberano en edge: ${targetName}...`);
+console.log(`🐜 [HormigasAIS] Creando nodo: ${targetName}...`);
 
-if (!fs.existsSync(targetDir)) {
-    fs.mkdirSync(targetDir, { recursive: true });
+for (const dir of ['agents', 'protocols', 'scripts', '.hormigasais']) {
+  fs.mkdirSync(path.join(targetDir, dir), { recursive: true });
 }
 
-// Estructura de directorios
-const subdirs = ['agents', 'protocols', 'scripts', '.hormigasais'];
-subdirs.forEach(dir => {
-    const p = path.join(targetDir, dir);
-    if (!fs.existsSync(p)) fs.mkdirSync(p, { recursive: true });
-});
-
-// Copiar o generar archivos base en el directorio destino
-const fecha = new Date().toISOString();
-
-const config = {
-    "node_id": "NODE-" + Math.random().toString(36).substring(2, 8).toUpperCase(),
-    "node_name": targetName,
-    "protocol": "LBH_BINARY_V1",
-    "version": "2.0",
-    "owner": "Cristhiam Leonardo Hernández Quiñonez",
-    "location": "San Miguel, El Salvador",
-    "nodo_maestro": "A16-SanMiguel-SV",
-    "created": fecha,
-    "agents": ["hormiga_centinela", "hormiga_relevo"],
-    "cert": "SELLADO-SOBERANO-LBH"
-};
-
-fs.writeFileSync(path.join(targetDir, '.hormigasais', 'node_config.json'), JSON.stringify(config, null, 2));
+const configFile = path.join(targetDir, '.hormigasais', 'node_config.json');
+
+if (fs.existsSync(configFile)) {
+  console.log('  node_config.json ya existe, no se sobrescribe.');
+} else {
+  const config = {
+    schema: 'LBH_NODE_CONFIG_V1',
+    node_id: 'NODE-' + Math.random().toString(36).substring(2, 8).toUpperCase(),
+    node_name: targetName,
+    protocol: 'LBH_BINARY_V2',
+    version: '2.0.0',
+    owner: { name: 'YOUR-NAME', email: 'YOUR-EMAIL' },
+    location: { country: 'YOUR-COUNTRY', city: 'YOUR-CITY' },
+    created_at: new Date().toISOString(),
+    status: 'INITIALIZED',
+    agents: ['hormiga_centinela', 'hormiga_relevo'],
+    certificate: 'PENDING'
+  };
+  fs.writeFileSync(configFile, JSON.stringify(config, null, 2) + '\n');
+}
 
-console.log(`✅ Nodo configurado en ${targetDir}`);
-console.log(`
-Siguiente paso:\n  cd ${targetName}\n  ./scripts/ignicion.sh`);
+console.log(`✅ Nodo creado en ${targetDir}`);
+console.log(`Siguiente paso: cd ${targetName} y completa .hormigasais/node_config.json`);

package/generator.py

@@ -22,7 +22,6 @@ sys.path.insert(0, str(ROOT))
 
 MODULES = [
     "config_generator",
-    "readme_generator",
     "protocol_generator",
     "contracts_generator",
     "agents_generator",
@@ -46,6 +45,9 @@ def main():
     print("🐜 HormigasAIS Generator")
     print("============================================")
 
+    fallos = []
+    faltantes = []
+
     for module_name in MODULES:
 
         print(f"[LOAD] {module_name}")
@@ -68,15 +70,27 @@ def main():
 
         except ModuleNotFoundError:
 
-            print(f"[WAIT] {module_name} aún no existe")
+            print(f"[FALTA] {module_name} no existe — módulo obligatorio")
+            faltantes.append(module_name)
 
         except Exception as e:
 
             print(f"[FAIL] {module_name}")
             print(e)
+            fallos.append(module_name)
 
     print("")
-    print("Proceso terminado.")
+
+    if faltantes or fallos:
+        print("❌ Proceso terminado CON ERRORES.")
+        if faltantes:
+            print(f"   Módulos faltantes: {", ".join(faltantes)}")
+        if fallos:
+            print(f"   Módulos con fallo: {", ".join(fallos)}")
+        print("============================================")
+        sys.exit(1)
+
+    print("✅ Proceso terminado correctamente.")
     print("============================================")
 
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hormigasais-edge-starter",
-  "version": "0.1.2",
-  "description": "Starter template para desplegar un nodo soberano HormigasAIS con agentes LBH. Incluye SDK de protocolos LBH, generadores autom\u00e1ticos y agentes edge.",
+  "version": "0.1.3",
+  "description": "Starter template para desplegar un nodo soberano HormigasAIS con agentes LBH. Incluye SDK de protocolos LBH, generadores automáticos y agentes edge.",
   "main": "./generator.js",
   "bin": {
     "create-hormigas-node": "generator.js"
@@ -19,8 +19,8 @@
     "termux",
     "offline-first"
   ],
-  "author": "Cristhiam Leonardo Hern\u00e1ndez Qui\u00f1onez",
-  "license": "MIT",
+  "author": "Cristhiam Leonardo Hernández Quiñonez",
+  "license": "SEE LICENSE IN LICENSE",
   "bugs": {
     "url": "https://github.com/Thrumanshow/hormigasais-edge-starter/issues"
   },
@@ -29,12 +29,8 @@
     "start": "python3 generator.py",
     "bootstrap": "bash bootstrap.sh",
     "verify": "python3 scripts/verify_sdk.py",
-    "postinstall": "python3 generator.py --quick || echo 'HormigasAIS Edge Starter instalado'",
     "test": "python3 scripts/verify_sdk.py"
   },
-  "dependencies": {
-    "jspdf": "^2.5.1"
-  },
   "engines": {
     "node": ">=14.0.0"
   },
@@ -48,9 +44,8 @@
     "scripts",
     "utils",
     "generators",
-    ".hormigasais",
     "README.md",
     "package.json"
   ],
   "packageManager": "npm@11.15.0"
-}
+}

package/.hormigasais/node_config.json

@@ -1,27 +0,0 @@
-{
-    "schema": "LBH_NODE_CONFIG_V1",
-    "node_id": "A16-u0_a350",
-    "node_name": "mi-colonia",
-    "protocol": "LBH_BINARY_V2",
-    "version": "2.0.0",
-    "owner": {
-        "name": "YOUR-NAME",
-        "email": "YOUR-EMAIL"
-    },
-    "location": {
-        "country": "SV",
-        "city": "San Miguel"
-    },
-    "master_node": "A16-SanMiguel-SV",
-    "created_at": "2026-07-24T02:27:25Z",
-    "status": "INITIALIZED",
-    "agents": [
-        "hormiga_centinela",
-        "hormiga_relevo"
-    ],
-    "security": {
-        "hmac_required": true,
-        "algorithm": "HMAC-SHA256"
-    },
-    "certificate": "PENDING"
-}