Resuelva cualquier conflicto en el lugar (las rutinas auxiliares en `src/host_aggregate.c` ya reflejan el diseño usado en `main`, por lo que las fusiones suelen ser sencillas) y ejecute `make` para confirmar que la compilación aún tenga éxito antes de enviar el resultado.

## Hooks de automatización

- `host_snapshot_last_captcha` expone el aviso de captcha generado más recientemente y su respuesta junto con una marca de tiempo para que los clientes externos puedan pasar desafíos en nombre de la automatización no supervisada.

## Endurecimiento de seguridad

- `scripts/safe_permission.sh` ajusta la propiedad y los modos de los archivos de datos en tiempo de ejecución (estado del BBS, estado de votación, instantáneas de enfriamiento y estado general de chatter). Ejecútelo después del despliegue para confinar el directorio de datos a `ssh-chatter` y asegurar que cada archivo tenga modo `0600`. Sobrescriba los destinos pasando rutas explícitas o exportando `STATE_ROOT` o las variables de entorno `CHATTER_*_FILE` correspondientes antes de la ejecución.
- Un vigilante BBS en segundo plano alimenta periódicamente publicaciones y comentarios a través del pipeline de moderación de IA (Gemini principal con respaldo de Ollama). Las publicaciones marcadas se eliminan automáticamente y se transmite un aviso a la sala.
- Los mensajes de chat, el arte ASCII y las publicaciones/comentarios del BBS pasan por un pipeline de moderación de IA. Actívelo con `CHATTER_SECURITY_AI=on` (configure `GEMINI_API_KEY` para Gemini; el daemon recurre automáticamente al endpoint local de Ollama en `http://127.0.0.1:11434`). Desactive todo con `CHATTER_SECURITY_FILTER=off`. Si todos los proveedores fallan, el filtro se desactiva automáticamente para mantener las conversaciones fluyendo en lugar de descartar contenido en silencio.
- El transporte SSH está fijado a intercambios de claves, cifrados y MACs modernos, y cada carga útil del puente está envuelta en una cebolla triple AES-256-GCM, por lo que los relevos solo ven texto cifrado.
- Las presentaciones sospechosas que activan el filtro en capas ahora se rastrean por IP; los impactos repetidos activan una patada y una prohibición automática cuando están habilitados, mientras que el detector de reconexión rápida permite ventanas de recuperación más largas para que las sesiones de red inestables puedan reincorporarse sin ser penalizadas. Las entradas de baneo automático están **desactivadas por defecto**; establezca `CHATTER_AUTO_BAN=on` (o `true`/`1`) para habilitarlas, o deje la variable sin definir para mantener advertencias y limitación sin escribir entradas de baneo automático.
- Los operadores pueden marcar puntos de entrada de confianza (salidas VPN, proxies inversos, localhost) con `CHATTER_PROTECTED_IPS` (separados por comas, por defecto `127.0.0.1,::1,192.168.0.1`) para que los baneos de emergencia nunca bloqueen al daemon fuera de su propio plano de control.

## Almacenamiento y transferencias de archivos

- Todos los archivos gestionados por el usuario ahora residen en `/etc/ssh-chatter/user-files` (sobrescribir con `CHATTER_FILESTORE_PATH`, respaldo heredado: `CHATTER_FILE_STORAGE_ROOT`). El daemon crea el directorio si es necesario y mantiene las subidas confinadas a él.
- Los clientes SSH usan `scp` estándar sin ningún envoltorio personalizado. Trate `/nombre.ext` como la raíz del árbol de almacenamiento: `scp my.zip user@host:/demos/my.zip` escribe en `/etc/ssh-chatter/user-files/demos/my.zip` mientras que `scp user@host:/readme.txt ./` descarga `/etc/ssh-chatter/user-files/readme.txt`.
- Los clientes TELNET usan los nuevos comandos `/filestore`. `/filestore` lista los archivos disponibles, `/filestore-upload` inicia una sesión `rz`, y `/filestore-download <nombre>` inicia una sesión `sz`. Instale `lrzsz` (o cualquier paquete que proporcione `rz`/`sz`) en el servidor para que el backend ZMODEM pueda lanzar esos helpers.
- `/filestore-upload` acepta un destino opcional (por ejemplo `/filestore-upload /kitten/meow.png`). SSH-Chatter crea el directorio `/kitten` automáticamente y coloca el archivo subido allí, reflejando cómo SCP usa rutas como `user@host:/kitten/meow.png`.
- Ambos transportes pueden mezclarse: SSH para transferencias programadas no supervisadas, TELNET para clientes BBS nostálgicos con herramientas ZMODEM integradas.

## Retransmisión Morse
SSH-Chatter soporta retransmisión de radioaficionados ham.
Esto muestra señales morse globales.
`/morse on` para ver, `/morse-reply` para enviar.

### Detalles del Protocolo

La implementación sigue la especificación del protocolo Binkp:
- Estructura de trama Binkp estándar con encabezados de 2 bytes
- Autenticación con contraseña de sesión (CMD\_PWD/CMD\_OK)
- Mecanismo de Keepalive (CMD\_NUL) cada 60 segundos
- Comando CHAT personalizado (CMD\_CHAT, extensión) para sincronización de mensajes

## Requisitos previos

Construir el proyecto requiere un entorno POSIX con:

- Un compilador compatible con C23 (por ejemplo `gcc` o `clang`)
- `make`
- Encabezados de desarrollo y biblioteca `libssh` (`libssh-dev` en Debian/Ubuntu)
- Encabezados de desarrollo y biblioteca `libcurl` (`libcurl4-openssl-dev` en Debian/Ubuntu)
- Encabezados de desarrollo y biblioteca `uchardet` (`libuchardet-dev` en Debian/Ubuntu)
- Encabezados de desarrollo y biblioteca `icu` (Componentes Internacionales para Unicode) (`libicu-dev` en Debian/Ubuntu)
- Biblioteca de compresión `lz4` y encabezados de desarrollo (`liblz4-dev` en Debian/Ubuntu)
- Hilos POSIX (normalmente proporcionados por el sistema `libpthread`)
- `python3-pygments` (proporciona el resaltador `pygmentize` para la pantalla de camuflaje Tetris)

En Debian/Ubuntu las dependencias se pueden instalar con:```bash
sudo apt-get update
sudo apt-get install build-essential libssh-dev libcurl4-openssl-dev libuchardet-dev libicu-dev liblz4-dev

Esto produce un binario `ssh-chatter` en la raíz del repositorio y un objeto compartido `libssh_chatter_backend.so` que expone las
ayudantes de traducción para su reutilización en otras aplicaciones. Limpie los artefactos intermedios con `make clean`.

### Usando el backend de traducción compartido

El objeto compartido reutiliza el pipeline de traducción C del servidor (incluyendo la preservación de marcadores ANSI) para que otros procesos puedan
obtener traducciones sin iniciar el host SSH completo. Enlace contra `libssh_chatter_backend.so` e incluya
`include/ssh_chatter/ssh_chatter_backend.h`:```c
#include "ssh_chatter/ssh_chatter_backend.h"

int main(void) {
  char translated[4096];
  char detected[64];

  if (ssh_chatter_backend_translate_line("Hello, world!", "ko", translated, sizeof(translated), detected, sizeof(detected))) {
    printf("Detected %s -> %s\n", detected, translated);
  }
}

Cuando se proporciona, `-m` lee el mensaje del día desde la ruta de archivo especificada.

Ejemplos comunes:```bash
# Start the chat server on port 2022, loading host keys from /etc/ssh
./ssh-chatter -p 2022 -k /etc/ssh

# Enable telnet access on 0.0.0.0:4242 alongside SSH
./ssh-chatter -T 0.0.0.0:4242

# Serve a custom MOTD from a file and bind to localhost
./ssh-chatter -a 127.0.0.1 -m /etc/ssh-chatter/motd

El servidor público está disponible en `bbs.chatter.pw` en el puerto SSH predeterminado:```bash
ssh -p 2222 [email protected]

Pasa `-T off` (o `-T disable`) para desactivar el listener telnet por completo.

### API de líneas JSON

El servidor también expone un protocolo de líneas JSON sobre TCP para automatización e integraciones externas. Escucha en el puerto `34567` por defecto y se puede desactivar o reconfigurar con `-J`:```bash
# Disable the JSON API
./ssh-chatter -J off

# Bind JSON API on a custom port
./ssh-chatter -J 0.0.0.0:45678

**Ejemplos de solicitud (cliente → servidor)**```json
{"type":"chat","id":1,"username":"alice","message":"안녕하세요"}
{"type":"image","id":2,"username":"alice","url":"https://example.com/cat.png","caption":"cat"}
{"type":"asciiart","id":3,"username":"alice","message":" /\\_/\\\\n( o.o )\\\\n > ^ <"}
{"type":"poll","id":4,"username":"op","is_operator":true,"question":"Favorite color?","options":["red","blue","green"]}
{"type":"poll","id":5,"username":"bob","action":"vote","choice":2}
{"type":"vote","id":6,"username":"op","label":"weekend","question":"Plan?","options":["hike","rest"],"allow_multiple":true}
{"type":"vote","id":7,"username":"bob","label":"weekend","action":"vote","choice":1}

Para un ejemplo ejecutable, consulta `scripts/json_api_example.py`:```bash
python3 scripts/json_api_example.py --url tcp://127.0.0.1:34567 --save /tmp/json_api_output.txt

Lo que hace el script:

1. Compila el proyecto (`make`).
2. Instala el binario resultante en `/usr/local/bin/ssh-chatter`.
3. Crea un usuario y grupo de sistema dedicados `ssh-chatter` (si aún no existen).
4. Crea `/var/lib/ssh-chatter` para el estado en tiempo de ejecución (incluyendo la clave de host SSH) y `/etc/ssh-chatter` para los archivos de configuración.
5. Genera una clave de host RSA predeterminada en `/var/lib/ssh-chatter/ssh_host_rsa_key` si falta.
6. Crea un MOTD predeterminado en `/etc/ssh-chatter/motd` y un archivo de anulación `/etc/ssh-chatter/chatter.env` para el ajuste basado en variables de entorno.
7. Escribe `/etc/systemd/system/chatter.service`, recarga `systemd`, habilita el servicio y lo inicia inmediatamente.

La unidad `chatter.service` resultante inicia el servidor con valores predeterminados sensatos y otorga la capacidad `CAP_NET_BIND_SERVICE` para que la cuenta de servicio no root pueda enlazarse a puertos privilegiados si es necesario.

### Personalizando el servicio

Puede ajustar los valores predeterminados editando `/etc/ssh-chatter/chatter.env` y reiniciando el servicio:```bash
sudo systemctl edit chatter.service   # or edit the environment file directly
sudo systemctl restart chatter.service

Puede editar cualquier archivo copiado para personalizar lo que aparece cuando la pantalla de camuflaje está activa.

La compatibilidad con la traducción ahora depende de la API de Google Gemini. Configure lo siguiente en `chatter.env` (o en el entorno) para habilitarla:

- `GEMINI_API_KEY` – Clave API secreta utilizada para autenticar las solicitudes de traducción.
- `GEMINI_API_BASE` – Anulación opcional de la URL base de la API (por defecto `https://generativelanguage.googleapis.com/v1beta`).
- `GEMINI_MODEL` – Anulación opcional del nombre del modelo Gemini (por defecto `gemini-2.5-flash`).

Cuando la traducción está activa, el chat envía cada mensaje inmediatamente en su idioma original y, a continuación, añade un subtítulo con sangría que contiene el texto traducido una vez que llega la respuesta de Gemini. Los resúmenes de reacciones utilizan el mismo estilo de subtítulo, por lo que las actualizaciones aparecen directamente debajo del mensaje al que hacen referencia.

Si las inserciones de subtítulos en línea resultan molestas, puede reservar un pequeño búfer de líneas en blanco con antelación con `/chat-spacing <0-5>`. Esta configuración solo afecta a los hilos de chat en vivo (el contenido del tablón de anuncios continúa traduciéndose sin reserva), por lo que puede ajustar el espaciado para su propia sesión sin afectar a las publicaciones largas.

Los cambios de idioma y la opción de traducción se guardan en `chatter_state.dat`, por lo que las sesiones futuras restauran automáticamente la misma configuración una vez que se reconecte.

Si prefiere instalar sin iniciar el servicio inmediatamente, ejecute el script con `SKIP_START=1`.

Comandos de gestión del servicio:```bash
sudo systemctl status chatter.service
sudo systemctl restart chatter.service
sudo systemctl disable --now chatter.service