hormigasais-edge-starter 0.1.0

package/.env.example

@@ -0,0 +1,4 @@
+LBH_SECRET=
+NODE_NAME=
+OWNER_NAME=
+OWNER_EMAIL=

package/.hormigasais/node_config.json

@@ -0,0 +1,27 @@
+{
+    "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"
+}

package/README.md

@@ -0,0 +1,66 @@
+# 🐜 HormigasAIS Edge Starter
+
+Starter oficial para desplegar un **nodo soberano** de HormigasAIS con agentes LBH.
+
+> "Soberanía digital en el edge"
+
+## 🚀 Instalación Rápida
+
+### Opción 1: Desde GitHub (Recomendada actualmente)
+
+\`\`\`bash
+npx create-hormigas-node@latest
+\`\`\`
+
+O manualmente:
+
+\`\`\`bash
+git clone https://github.com/Thrumanshow/hormigasais-edge-starter.git
+cd hormigasais-edge-starter
+bash bootstrap.sh
+python3 generator.py
+\`\`\`
+
+### Opción 2: Cuando esté publicado en npm (próximamente)
+
+\`\`\`bash
+npx create-hormigas-node
+\`\`\`
+
+## ¿Qué incluye?
+
+- **Bootstrap automático** del entorno en Termux
+- **SDK LBH completo** (encoder, decoder, signer, verifier)
+- **Agentes autónomos**: \`hormiga_centinela\` y \`hormiga_relevo\`
+- **Generadores modulares** (config, protocols, scripts, agents, contracts)
+- **Verificación POST** del SDK (\`verify_sdk.py\`)
+- Soporte para secretos en \`~/.hormigas_secrets\`
+
+## Comandos útiles
+
+\`\`\`bash
+./bootstrap.sh                    # Preparar entorno
+python3 generator.py              # Ejecutar generadores
+python3 scripts/verify_sdk.py     # Test completo del SDK LBH
+\`\`\`
+
+## Estructura del proyecto
+
+\`\`\`
+hormigasais-edge-starter/
+├── bootstrap.sh
+├── generator.py
+├── package.json
+├── protocols/          # SDK LBH
+├── agents/             # Agentes autónomos
+├── scripts/            # Scripts de verificación
+├── utils/              # Utilidades
+├── .hormigasais/       # Configuración del nodo
+└── logs/
+\`\`\`
+
+---
+
+**Made with ❤️ for digital sovereignty**
+
+[hormigasais.com](https://hormigasais.com) | [@Thrumanshow](https://github.com/Thrumanshow)

package/agents/hormiga_centinela.py

@@ -0,0 +1,41 @@
+#!/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
+
+if __name__ == "__main__":
+    print(f"[CENTINELA] Iniciando en nodo {NODE_ID}")
+    while True:
+        emit_pulse()
+        time.sleep(INTERVAL)

package/generator.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const targetName = process.argv[2] || 'mi-colonia';
+const targetDir = path.join(process.cwd(), targetName);
+
+console.log(`🐜 [HormigasAIS] Desplegando nodo soberano en edge: ${targetName}...`);
+
+if (!fs.existsSync(targetDir)) {
+    fs.mkdirSync(targetDir, { 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));
+
+console.log(`✅ Nodo configurado en ${targetDir}`);
+console.log(`
+Siguiente paso:\n  cd ${targetName}\n  ./scripts/ignicion.sh`);

package/generator.py

@@ -0,0 +1,84 @@
+#!/usr/bin/env python3
+"""
+HormigasAIS Edge Starter
+generator.py
+
+Orquestador principal del starter.
+
+Responsabilidades:
+- Crear la estructura base.
+- Ejecutar cada generador especializado.
+- No sobrescribir archivos existentes salvo indicación explícita.
+"""
+
+from pathlib import Path
+import importlib
+import sys
+
+ROOT = Path(__file__).resolve().parent
+GENERATORS = ROOT / "generators"
+
+sys.path.insert(0, str(ROOT))
+
+MODULES = [
+    "config_generator",
+    "readme_generator",
+    "protocol_generator",
+    "contracts_generator",
+    "agents_generator",
+    "scripts_generator",
+]
+
+
+def main():
+
+    GENERATORS.mkdir(exist_ok=True)
+
+    init = GENERATORS / "__init__.py"
+
+    if not init.exists():
+        init.write_text(
+            "# HormigasAIS Generators Package\n",
+            encoding="utf-8"
+        )
+
+    print("============================================")
+    print("🐜 HormigasAIS Generator")
+    print("============================================")
+
+    for module_name in MODULES:
+
+        print(f"[LOAD] {module_name}")
+
+        try:
+
+            module = importlib.import_module(
+                f"generators.{module_name}"
+            )
+
+            if hasattr(module, "generate"):
+
+                module.generate(ROOT)
+
+                print(f"[ OK ] {module_name}")
+
+            else:
+
+                print(f"[SKIP] {module_name} (sin generate())")
+
+        except ModuleNotFoundError:
+
+            print(f"[WAIT] {module_name} aún no existe")
+
+        except Exception as e:
+
+            print(f"[FAIL] {module_name}")
+            print(e)
+
+    print("")
+    print("Proceso terminado.")
+    print("============================================")
+
+
+if __name__ == "__main__":
+    main()

package/generators/agents_generator.py

@@ -0,0 +1,68 @@
+"""
+agents_generator.py
+HormigasAIS Edge Starter
+"""
+
+from pathlib import Path
+
+def write_if_missing(path: Path, content: str):
+    if path.exists():
+        print(f"  └── {path.name} ya existe")
+        return
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(content, encoding="utf-8")
+    print(f"  └── {path.name} creado")
+
+def generate(root: Path):
+    print("[LOAD] agents_generator")
+    agents_dir = root / "agents"
+    agents_dir.mkdir(exist_ok=True)
+
+    centinela_code = '''#!/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
+
+if __name__ == "__main__":
+    print(f"[CENTINELA] Iniciando en nodo {NODE_ID}")
+    while True:
+        emit_pulse()
+        time.sleep(INTERVAL)
+'''
+
+    c_path = agents_dir / "hormiga_centinela.py"
+    write_if_missing(c_path, centinela_code)
+    c_path.chmod(0o755)
+
+    print("[ OK ] agents_generator")

package/generators/config_generator.py

@@ -0,0 +1,65 @@
+"""
+config_generator.py
+HormigasAIS Edge Starter
+
+Genera la configuración inicial del nodo.
+No sobrescribe configuraciones existentes.
+"""
+
+from pathlib import Path
+import json
+import datetime
+import getpass
+import socket
+
+
+def generate(root: Path):
+
+    config_dir = root / ".hormigasais"
+    config_dir.mkdir(exist_ok=True)
+
+    config_file = config_dir / "node_config.json"
+
+    if config_file.exists():
+        print("  └── node_config.json ya existe")
+        return
+
+    now = datetime.datetime.now(datetime.UTC).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    hostname = socket.gethostname()
+
+    if hostname == "localhost":
+        hostname = "A16"
+
+    config = {
+        "schema": "LBH_NODE_CONFIG_V1",
+        "node_id": f"{hostname}-{getpass.getuser()}",
+        "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": now,
+        "status": "INITIALIZED",
+        "agents": [
+            "hormiga_centinela",
+            "hormiga_relevo"
+        ],
+        "security": {
+            "hmac_required": True,
+            "algorithm": "HMAC-SHA256"
+        },
+        "certificate": "PENDING"
+    }
+
+    with open(config_file, "w", encoding="utf-8") as f:
+        json.dump(config, f, indent=4, ensure_ascii=False)
+
+    print("  └── node_config.json creado")

package/generators/contracts_generator.py

@@ -0,0 +1,38 @@
+"""
+contracts_generator.py
+HormigasAIS Edge Starter
+"""
+
+from pathlib import Path
+import datetime
+
+def write_if_missing(path: Path, content: str):
+    if path.exists():
+        print(f"  └── {path.name} ya existe")
+        return
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(content, encoding="utf-8")
+    print(f"  └── {path.name} creado")
+
+def generate(root: Path):
+    print("[LOAD] contracts_generator")
+    protocols_dir = root / "protocols"
+    protocols_dir.mkdir(exist_ok=True)
+
+    fecha = datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    contract_content = f"""\
+==============================================================================
+.human GOVERNANCE CONTRACT — HormigasAIS Edge Starter
+==============================================================================
+NODE:       A16
+OWNER:      Cristhiam Leonardo Hernández Quiñonez
+CREATED:    {fecha}
+SOVEREIGNTY DECLARATION:
+This node operates under full digital sovereignty.
+CERT::LBH-HUMAN-STARTER-V1-CLHQ
+==============================================================================
+"""
+    contract_path = protocols_dir / "human_contract.lbh"
+    write_if_missing(contract_path, contract_content)
+    print("[ OK ] contracts_generator")

package/generators/protocol_generator.py

@@ -0,0 +1,167 @@
+"""
+protocol_generator.py
+HormigasAIS Edge Starter
+
+Genera el paquete protocols/ modular del SDK LBH.
+No sobrescribe archivos existentes.
+"""
+
+from pathlib import Path
+
+
+def write_if_missing(path: Path, content: str):
+    if path.exists():
+        print(f"  └── {path.name} ya existe")
+        return
+    path.write_text(content, encoding="utf-8")
+    print(f"  └── {path.name} creado")
+
+
+def generate(root: Path):
+
+    protocols = root / "protocols"
+    protocols.mkdir(exist_ok=True)
+
+    write_if_missing(
+        protocols / "__init__.py",
+        '''"""
+LBH Protocol SDK
+"""
+
+from .constants import TYPE_CODES
+from .encoder import encode_packet
+from .decoder import decode_packet
+from .signer import seal_action
+from .verifier import verify_signature
+'''
+    )
+
+    write_if_missing(
+        protocols / "constants.py",
+        '''"""
+Constantes oficiales LBH
+"""
+
+TYPE_CODES = {
+    "SEAL":"5345414c",
+    "VERI":"56455249",
+    "SYNC":"53594e43",
+    "PING":"50494e47",
+    "FUEL":"4655454c",
+    "ACKK":"41434b4b",
+    "ERRR":"45525252",
+}
+'''
+    )
+
+    write_if_missing(
+        protocols / "encoder.py",
+        '''from .constants import TYPE_CODES
+
+def make_header(node_id="A16", version="00"):
+    return (
+        node_id.encode().hex()[:4].ljust(4,"0") +
+        version.encode().hex()[:4].ljust(4,"0")
+    )
+
+def encode_packet(header, type_code, payload):
+    payload_hex = payload.encode().hex()
+    length = format(len(payload_hex)//2,"08x")
+    return f"{header}{type_code}{length}{payload_hex}"
+'''
+    )
+
+    write_if_missing(
+        protocols / "decoder.py",
+        '''def decode_packet(frame):
+    return {
+        "header":frame[:8],
+        "type_code":frame[8:16],
+        "length":int(frame[16:24],16),
+        "payload":bytes.fromhex(frame[24:]).decode()
+    }
+'''
+    )
+
+    write_if_missing(
+        protocols / "signer.py",
+        '''import hashlib
+import hmac
+import os
+import time
+
+def seal_action(content, owner):
+
+    secret = os.environ.get("LBH_SECRET")
+
+    if not secret:
+        raise RuntimeError(
+            "LBH_SECRET no definido."
+        )
+
+    sha = hashlib.sha256(content.encode()).hexdigest()
+
+    ts = int(time.time())
+
+    payload = f"{sha}|{owner}|{ts}"
+
+    sig = hmac.new(
+        secret.encode(),
+        payload.encode(),
+        hashlib.sha256
+    ).hexdigest()
+
+    return {
+        "sha256":sha,
+        "firma":sig,
+        "timestamp":ts,
+        "owner":owner
+    }
+'''
+    )
+
+    write_if_missing(
+        protocols / "verifier.py",
+        '''import hashlib
+import hmac
+import os
+
+def verify_signature(content, signature, owner, timestamp):
+
+    secret = os.environ.get("LBH_SECRET")
+
+    if not secret:
+        return False
+
+    sha = hashlib.sha256(content.encode()).hexdigest()
+
+    payload = f"{sha}|{owner}|{timestamp}"
+
+    expected = hmac.new(
+        secret.encode(),
+        payload.encode(),
+        hashlib.sha256
+    ).hexdigest()
+
+    return hmac.compare_digest(
+        expected,
+        signature
+    )
+'''
+    )
+
+    write_if_missing(
+        protocols / "lbh_core.py",
+        '''"""
+Compatibilidad con versiones anteriores.
+
+Importa automáticamente todos los módulos del SDK.
+"""
+
+from .constants import *
+from .encoder import *
+from .decoder import *
+from .signer import *
+from .verifier import *
+'''
+    )

package/generators/scripts_generator.py

@@ -0,0 +1,283 @@
+"""
+scripts_generator.py
+HormigasAIS Edge Starter
+
+Genera scripts auxiliares del starter.
+
+Fase:
+- utils/env_loader.py
+- scripts/verify_sdk.py (POST del SDK LBH)
+"""
+
+from pathlib import Path
+
+
+def write_if_missing(path: Path, content: str):
+    if path.exists():
+        print(f"  └── {path.name} ya existe")
+        return
+
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(content, encoding="utf-8")
+    print(f"  └── {path.name} creado")
+
+
+def generate(root: Path):
+
+    print("[LOAD] scripts_generator")
+
+    # ============================================================
+    # utils/env_loader.py
+    # ============================================================
+
+    utils = root / "utils"
+    utils.mkdir(exist_ok=True)
+
+    env_loader = r'''
+"""
+env_loader.py
+HormigasAIS Secret Loader
+
+Carga secretos desde:
+- Variables de entorno
+- ~/.hormigas_secrets
+"""
+
+from pathlib import Path
+import os
+
+
+def load_termux_secrets():
+
+    secret_file = Path.home() / ".hormigas_secrets"
+
+    if not secret_file.exists():
+        return
+
+    for line in secret_file.read_text(
+        encoding="utf-8"
+    ).splitlines():
+
+        line = line.strip()
+
+        if (
+            not line
+            or line.startswith("#")
+            or "=" not in line
+        ):
+            continue
+
+        key, value = line.split("=", 1)
+
+        os.environ.setdefault(
+            key.strip(),
+            value.strip()
+            .strip('"')
+            .strip("'")
+        )
+'''
+
+    write_if_missing(
+        utils / "env_loader.py",
+        env_loader
+    )
+
+
+    # ============================================================
+    # scripts/verify_sdk.py
+    # ============================================================
+
+    scripts = root / "scripts"
+    scripts.mkdir(exist_ok=True)
+
+
+    verify_sdk = r'''#!/usr/bin/env python3
+
+"""
+verify_sdk.py
+HormigasAIS LBH SDK Power-On Self Test (POST)
+"""
+
+import json
+import os
+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()
+
+
+print("========================================")
+print("🐜 HormigasAIS :: SDK POST")
+print("========================================")
+
+
+try:
+
+    from protocols.encoder import (
+        make_header,
+        encode_packet
+    )
+
+    from protocols.decoder import (
+        decode_packet
+    )
+
+    from protocols.constants import (
+        TYPE_CODES
+    )
+
+    from protocols.signer import (
+        seal_action
+    )
+
+    from protocols.verifier import (
+        verify_signature
+    )
+
+
+except Exception as e:
+
+    print("[FAIL] Importación del SDK")
+    print(e)
+    sys.exit(1)
+
+
+print("[ OK ] Importación del SDK")
+
+
+secret = os.environ.get(
+    "LBH_SECRET"
+)
+
+
+if not secret:
+
+    print(
+        "[FAIL] LBH_SECRET no definido"
+    )
+
+    print(
+        "Configure ~/.hormigas_secrets"
+    )
+
+    sys.exit(1)
+
+
+print(
+    "[ OK ] LBH_SECRET disponible"
+)
+
+
+payload = json.dumps(
+    {
+        "action": "sdk_post",
+        "node": "SELFTEST"
+    }
+)
+
+
+frame = encode_packet(
+    make_header(
+        "A16",
+        "00"
+    ),
+    TYPE_CODES["FUEL"],
+    payload
+)
+
+
+print(
+    "[ OK ] Codificación LBH"
+)
+
+
+decoded = decode_packet(frame)
+
+
+if decoded["payload"] != payload:
+
+    print(
+        "[FAIL] Decodificación"
+    )
+
+    sys.exit(1)
+
+
+print(
+    "[ OK ] Decodificación"
+)
+
+
+seal = seal_action(
+    payload,
+    "SELFTEST"
+)
+
+
+print(
+    "[ OK ] Firma HMAC"
+)
+
+
+valid = verify_signature(
+    payload,
+    seal["firma"],
+    seal["owner"],
+    seal["timestamp"]
+)
+
+
+if not valid:
+
+    print(
+        "[FAIL] Verificación HMAC"
+    )
+
+    sys.exit(1)
+
+
+print(
+    "[ OK ] Verificación HMAC"
+)
+
+
+print("")
+
+print(
+    "========================================"
+)
+
+print(
+    "SDK LBH OPERATIVO"
+)
+
+print(
+    "========================================"
+)
+'''
+
+
+    verify = scripts / "verify_sdk.py"
+
+    write_if_missing(
+        verify,
+        verify_sdk
+    )
+
+    verify.chmod(0o755)
+
+
+    print("[ OK ] scripts_generator")
+
+

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "hormigasais-edge-starter",
+  "version": "0.1.0",
+  "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"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Thrumanshow/hormigasais-edge-starter.git"
+  },
+  "keywords": [
+    "hormigasais",
+    "edge-computing",
+    "sovereign-node",
+    "lbh-protocol",
+    "agent-based",
+    "termux",
+    "offline-first"
+  ],
+  "author": "Cristhiam Leonardo Hernández Quiñonez",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Thrumanshow/hormigasais-edge-starter/issues"
+  },
+  "homepage": "https://github.com/Thrumanshow/hormigasais-edge-starter#readme",
+  "scripts": {
+    "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"
+  }
+}

package/protocols/__init__.py

@@ -0,0 +1,9 @@
+"""
+LBH Protocol SDK
+"""
+
+from .constants import TYPE_CODES
+from .encoder import encode_packet
+from .decoder import decode_packet
+from .signer import seal_action
+from .verifier import verify_signature

package/protocols/constants.py

@@ -0,0 +1,13 @@
+"""
+Constantes oficiales LBH
+"""
+
+TYPE_CODES = {
+    "SEAL":"5345414c",
+    "VERI":"56455249",
+    "SYNC":"53594e43",
+    "PING":"50494e47",
+    "FUEL":"4655454c",
+    "ACKK":"41434b4b",
+    "ERRR":"45525252",
+}

package/protocols/decoder.py

@@ -0,0 +1,7 @@
+def decode_packet(frame):
+    return {
+        "header":frame[:8],
+        "type_code":frame[8:16],
+        "length":int(frame[16:24],16),
+        "payload":bytes.fromhex(frame[24:]).decode()
+    }

package/protocols/encoder.py

@@ -0,0 +1,12 @@
+from .constants import TYPE_CODES
+
+def make_header(node_id="A16", version="00"):
+    return (
+        node_id.encode().hex()[:4].ljust(4,"0") +
+        version.encode().hex()[:4].ljust(4,"0")
+    )
+
+def encode_packet(header, type_code, payload):
+    payload_hex = payload.encode().hex()
+    length = format(len(payload_hex)//2,"08x")
+    return f"{header}{type_code}{length}{payload_hex}"

package/protocols/human_contract.lbh

@@ -0,0 +1,10 @@
+==============================================================================
+.human GOVERNANCE CONTRACT — HormigasAIS Edge Starter
+==============================================================================
+NODE:       A16
+OWNER:      Cristhiam Leonardo Hernández Quiñonez
+CREATED:    2026-07-24T05:54:01Z
+SOVEREIGNTY DECLARATION:
+This node operates under full digital sovereignty.
+CERT::LBH-HUMAN-STARTER-V1-CLHQ
+==============================================================================

package/protocols/lbh_core.py

@@ -0,0 +1,11 @@
+"""
+Compatibilidad con versiones anteriores.
+
+Importa automáticamente todos los módulos del SDK.
+"""
+
+from .constants import *
+from .encoder import *
+from .decoder import *
+from .signer import *
+from .verifier import *

package/protocols/signer.py

@@ -0,0 +1,32 @@
+import hashlib
+import hmac
+import os
+import time
+
+def seal_action(content, owner):
+
+    secret = os.environ.get("LBH_SECRET")
+
+    if not secret:
+        raise RuntimeError(
+            "LBH_SECRET no definido."
+        )
+
+    sha = hashlib.sha256(content.encode()).hexdigest()
+
+    ts = int(time.time())
+
+    payload = f"{sha}|{owner}|{ts}"
+
+    sig = hmac.new(
+        secret.encode(),
+        payload.encode(),
+        hashlib.sha256
+    ).hexdigest()
+
+    return {
+        "sha256":sha,
+        "firma":sig,
+        "timestamp":ts,
+        "owner":owner
+    }

package/protocols/verifier.py

@@ -0,0 +1,25 @@
+import hashlib
+import hmac
+import os
+
+def verify_signature(content, signature, owner, timestamp):
+
+    secret = os.environ.get("LBH_SECRET")
+
+    if not secret:
+        return False
+
+    sha = hashlib.sha256(content.encode()).hexdigest()
+
+    payload = f"{sha}|{owner}|{timestamp}"
+
+    expected = hmac.new(
+        secret.encode(),
+        payload.encode(),
+        hashlib.sha256
+    ).hexdigest()
+
+    return hmac.compare_digest(
+        expected,
+        signature
+    )

package/scripts/verify_sdk.py

@@ -0,0 +1,84 @@
+#!/usr/bin/env python3
+"""
+verify_sdk.py
+LBH SDK Power-On Self Test (POST)
+"""
+
+import json
+import os
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+sys.path.insert(0, str(ROOT))
+
+print("========================================")
+print("🐜 HormigasAIS :: SDK POST")
+print("========================================")
+
+try:
+    from protocols.encoder import make_header, encode_packet
+    from protocols.decoder import decode_packet
+    from protocols.constants import TYPE_CODES
+    from protocols.signer import seal_action
+    from protocols.verifier import verify_signature
+except Exception as e:
+    print("[FAIL] Importación del SDK")
+    print(e)
+    sys.exit(1)
+
+print("[ OK ] Importación del SDK")
+
+secret = os.environ.get("LBH_SECRET")
+
+if not secret:
+    print("[FAIL] LBH_SECRET no definido")
+    sys.exit(1)
+
+print("[ OK ] LBH_SECRET disponible")
+
+payload = json.dumps({
+    "action":"sdk_post",
+    "node":"SELFTEST"
+})
+
+frame = encode_packet(
+    make_header("A16","00"),
+    TYPE_CODES["FUEL"],
+    payload
+)
+
+print("[ OK ] Codificación LBH")
+
+decoded = decode_packet(frame)
+
+if decoded["payload"] != payload:
+    print("[FAIL] Decodificación")
+    sys.exit(1)
+
+print("[ OK ] Decodificación")
+
+seal = seal_action(
+    payload,
+    "SELFTEST"
+)
+
+print("[ OK ] Firma HMAC")
+
+valid = verify_signature(
+    payload,
+    seal["firma"],
+    seal["owner"],
+    seal["timestamp"]
+)
+
+if not valid:
+    print("[FAIL] Verificación HMAC")
+    sys.exit(1)
+
+print("[ OK ] Verificación HMAC")
+
+print("")
+print("========================================")
+print("SDK LBH OPERATIVO")
+print("========================================")

package/update_agents_and_contracts.sh

@@ -0,0 +1,123 @@
+#!/usr/bin/env bash
+cd ~/hormigasais-edge-starter
+
+echo "🐜 Actualizando agents_generator.py y contracts_generator.py..."
+
+# agents_generator.py
+cat << 'AGENT' > generators/agents_generator.py
+"""
+agents_generator.py
+HormigasAIS Edge Starter
+"""
+
+from pathlib import Path
+
+def write_if_missing(path: Path, content: str):
+    if path.exists():
+        print(f"  └── {path.name} ya existe")
+        return
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(content, encoding="utf-8")
+    print(f"  └── {path.name} creado")
+
+def generate(root: Path):
+    print("[LOAD] agents_generator")
+    agents_dir = root / "agents"
+    agents_dir.mkdir(exist_ok=True)
+
+    centinela_code = '''#!/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
+
+if __name__ == "__main__":
+    print(f"[CENTINELA] Iniciando en nodo {NODE_ID}")
+    while True:
+        emit_pulse()
+        time.sleep(INTERVAL)
+'''
+
+    c_path = agents_dir / "hormiga_centinela.py"
+    write_if_missing(c_path, centinela_code)
+    c_path.chmod(0o755)
+
+    print("[ OK ] agents_generator")
+AGENT
+
+# contracts_generator.py
+cat << 'CONTRACT' > generators/contracts_generator.py
+"""
+contracts_generator.py
+HormigasAIS Edge Starter
+"""
+
+from pathlib import Path
+import datetime
+
+def write_if_missing(path: Path, content: str):
+    if path.exists():
+        print(f"  └── {path.name} ya existe")
+        return
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(content, encoding="utf-8")
+    print(f"  └── {path.name} creado")
+
+def generate(root: Path):
+    print("[LOAD] contracts_generator")
+    protocols_dir = root / "protocols"
+    protocols_dir.mkdir(exist_ok=True)
+
+    fecha = datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    contract_content = f"""\
+==============================================================================
+.human GOVERNANCE CONTRACT — HormigasAIS Edge Starter
+==============================================================================
+NODE:       A16
+OWNER:      Cristhiam Leonardo Hernández Quiñonez
+CREATED:    {fecha}
+SOVEREIGNTY DECLARATION:
+This node operates under full digital sovereignty.
+CERT::LBH-HUMAN-STARTER-V1-CLHQ
+==============================================================================
+"""
+    contract_path = protocols_dir / "human_contract.lbh"
+    write_if_missing(contract_path, contract_content)
+    print("[ OK ] contracts_generator")
+CONTRACT
+
+echo "✅ Generadores actualizados"
+
+python3 generator.py
+echo "✅ agents y contracts actualizados correctamente."

package/utils/env_loader.py

@@ -0,0 +1,42 @@
+
+"""
+env_loader.py
+HormigasAIS Secret Loader
+
+Carga secretos desde:
+- Variables de entorno
+- ~/.hormigas_secrets
+"""
+
+from pathlib import Path
+import os
+
+
+def load_termux_secrets():
+
+    secret_file = Path.home() / ".hormigas_secrets"
+
+    if not secret_file.exists():
+        return
+
+    for line in secret_file.read_text(
+        encoding="utf-8"
+    ).splitlines():
+
+        line = line.strip()
+
+        if (
+            not line
+            or line.startswith("#")
+            or "=" not in line
+        ):
+            continue
+
+        key, value = line.split("=", 1)
+
+        os.environ.setdefault(
+            key.strip(),
+            value.strip()
+            .strip('"')
+            .strip("'")
+        )