# Artifacts hosting

Carpeta servida en `https://artifacts.faysalai.es/` desde el VPS (nginx:alpine + traefik).

## Para anadir un artifact nuevo

1. Crea la carpeta: `artifacts/<nombre>/`
2. Mete tu HTML como `index.html` (puede tener JS/CSS inline o archivos sueltos)
3. Commit + push a la branch (o `main` para auto-pull):
   ```bash
   git add artifacts/<nombre>
   git commit -m "Add artifact: <nombre>"
   git push
   ```
4. En el VPS: `cd /opt/agents && git pull` (o esperar al cron de :30)
5. Abre `https://artifacts.faysalai.es/<nombre>/`

## Para servir un HTML grande (claude.ai artifact)

Si vienes de un artifact de claude.ai:

1. En el artifact panel, copia el HTML completo (o usa Download)
2. Pega en `artifacts/<nombre>/index.html`
3. Push + pull en VPS

## Listado y descubrimiento

`https://artifacts.faysalai.es/` muestra el listado de carpetas (autoindex on).
Util para volver a un artifact sin recordar el nombre exacto.

## Helper rapido (desde el VPS)

```bash
bash /opt/agents/scripts/add-artifact.sh <nombre> /ruta/a/archivo.html
```

Esto copia el HTML a `artifacts/<nombre>/index.html`, hace commit + push automatico.

## Primera vez: setup del hosting

Solo una vez por VPS:

```bash
bash /opt/agents/scripts/setup-artifact-hosting.sh
```

Levanta el contenedor nginx + escribe la config dinamica de traefik. Idempotente.

## Limitaciones

- Solo HTML estatico (JS/CSS inline u otros archivos en la carpeta OK)
- NO hay backend, NO hay API. Si necesitas API, usa otra cosa.
- Publico en internet. NO metas datos sensibles aqui.
- Cache desactivada por defecto (iteracion rapida). Si quieres edge-caching agresivo, edita `nginx.conf` y reload.