# RUNBOOK — Deploy t8agent.mailittlexp.org + operatività

> Deploy del sito Superman su Cloudflare Pages (direct upload) + dominio custom.
> Il sito è 100% statico: compatibile CF Pages. Nessun backend, nessun filesystem server-side.

## 1. Deploy

```bash
cd /Users/mario/Progetti/10_W3_TELCO_LAVORO/003_PROGRAMMI/superman-agent
npx wrangler pages deploy public --project-name=superman-agent
```

Se il progetto non esiste, `wrangler pages deploy` lo crea via Direct Upload.
⚠️ La scelta Direct Upload è irrevocabile (niente Git integration retroattiva): accettata di proposito per
questo progetto (repo GitHub resta la fonte, il deploy gira da locale).

## 2. Dominio custom

```bash
# a) registra il dominio sul progetto Pages (POST, wrangler OAuth lo permette)
ACCOUNT_ID="fdd8f4a187e661aa958f6d17d8beb286"
TOKEN=$(cat ~/Library/Preferences/.wrangler/config/default.toml | grep oauth_token | cut -d'"' -f2)
curl -s -X POST "https://api.cloudflare.com/client/v4/accounts/${ACCOUNT_ID}/pages/projects/superman-agent/domains" \
  -H "Authorization: Bearer ${TOKEN}" -H "Content-Type: application/json" \
  -d '{"name":"t8agent.mailittlexp.org"}'

# b) CNAME via cf CLI (wrangler OAuth NON ha zone:write — regola: DNS solo via cf)
cf dns records create --zone mailittlexp.org \
  --body '{"type":"CNAME","name":"t8agent","content":"superman-agent.pages.dev","proxied":true}'

# c) verifica entro ~1-2 minuti
curl -sI https://t8agent.mailittlexp.org/ | head -3
```

Zone mailittlexp.org: `22b176ea32c4ea230befcf498ff9078c`. Pattern già usato per pcc/cbmkt/vtop.

## 3. Run mattutino (manuale o cron)

```bash
cd /Users/mario/Progetti/10_W3_TELCO_LAVORO/003_PROGRAMMI/superman-agent
python3 engine/superman_cli.py build-site \
  --src <cartella benchmarks> --out public --agent-dir agent --docs-dir docs
npx wrangler pages deploy public --project-name=superman-agent
```

## 4. Cron opzionale (fase 2 — NON attivato)

- **Classificazione**: `script-only` (l'engine è Python puro, 0 call LLM del run).
- **Consumo atteso**: ogni tick risveglia il gateway ≈ **2 call/tick**; a 1 run/giorno → **~2 call/giorno**.
- Trigger: 8:00 feriali; log audit (GOV-05) e notifica TG solo su esito non 0.
- Attivazione (se richiesta da Morpheus): `cronjob_manage` con prompt che chiama `superman_cli.py build-site`
  + `wrangler pages deploy`. NOTA: la regola cron→consumo richiede la dichiarazione qui sopra allegata alla richiesta.

## 5. Rollback

Il deploy Pages mantiene tutte le versioni precedenti: `wrangler pages deployment list --project-name=superman-agent`
e eventuale `rollback`. DNS: rimuovere il CNAME con `cf dns records delete` per spegnere il dominio.
