# Agent Operativo - Comandi Day-0

Documento operativo da dare al nuovo agent.

## 0. Letture obbligatorie iniziali

```bash
cd /home/michele/netgescon/netgescon-day0
sed -n '1,220p' docs/ai/restart/START-HERE-NETGESCON-DAY0.md
sed -n '1,260p' docs/ai/restart/HANDOFF_AGENT_OPERATIVO_20260311.md
sed -n '1,260p' docs/ai/restart/CONTINUITA-STORICO-DAY0.md
sed -n '1,260p' docs/ai/restart/FILAMENT-ONLY-CUTOVER-CHECKLIST.md
```

## 1. Preflight workspace e continuita

```bash
cd /home/michele/netgescon/netgescon-day0
git pull --rebase origin main
git status --short --branch
bash scripts/ops/netgescon-day0-legacy-sync.sh
```

## 2. Dipendenze locali (se mancanti)

```bash
cd /home/michele/netgescon/netgescon-day0
composer install
npm install
```

## 3. Avvio/Riavvio server sviluppo su :8000

```bash
pkill -f "php artisan serve --host=0.0.0.0 --port=8000" || true
cd /home/michele/netgescon/netgescon-day0
mkdir -p storage/logs
nohup php artisan serve --host=0.0.0.0 --port=8000 --no-reload > storage/logs/dev-server.log 2>&1 &
sleep 2
curl -I -sS http://127.0.0.1:8000/up | head -n 1
```

## 4. Check Filament e pagina modifiche

```bash
curl -I -sS http://127.0.0.1:8000/admin-filament | head -n 1
curl -I -sS http://127.0.0.1:8000/admin-filament/supporto/modifiche | head -n 1
```

## 5. Aggiornare changelog manuale (feature/bug)

```bash
cd /home/michele/netgescon/netgescon-day0
bash scripts/ops/netgescon-add-modifica.sh \
  --area "Filament / Ticket / Google" \
  --desc "<funzionalita o bugfix>" \
  --type U
```

Tipi validi:

- `U` utenti finali
- `P` operativo/sviluppo
- `E` errore non bloccante
- `E!` errore bloccante

## 6. Agganciare il changelog automatico al Git

```bash
cd /home/michele/netgescon/netgescon-day0
bash scripts/ops/netgescon-sync-git-changelog.sh
```

File generato:

- `docs/NETGESCON-GIT-AUTOCHANGELOG.md`

## 7. Commit e push con changelog aggiornato

```bash
cd /home/michele/netgescon/netgescon-day0
git add docs/NETGESCON-MODIFICHE.md docs/NETGESCON-GIT-AUTOCHANGELOG.md
git add -A
git commit -m "feat: <descrizione sintetica>"
git push origin main
```

## 8. Backup chat/sessione AI (anti-perdita)

```bash
cd /home/michele/netgescon/netgescon-day0
bash scripts/ai/handoff_checkpoint.sh
bash scripts/ai/topic_checkpoint.sh "NetGescon Day-0" "Checkpoint operativo"
bash scripts/ai/save_periodic_summary.sh "NetGescon Day-0" both
bash scripts/ai/archive_heavy_chats.sh --threshold=150 --dry-run
bash scripts/ai/archive_heavy_chats.sh --threshold=150 --apply
bash scripts/ai/continuity_auto.sh --threshold=150 --topic="NetGescon Day-0" --note="Ripartenza sviluppo"
```

## 9. Ciclo aggiornamento staging

```bash
cd /var/www/netgescon
php artisan optimize:clear
php artisan config:clear
php artisan route:clear
php artisan netgescon:update --channel=free
php artisan netgescon:update --channel=free --apply
curl -I -sS "https://staging.netgescon.it/up" | head -n 1
curl -I -sS "https://staging.netgescon.it/fornitore/tickets?fornitore=1" | head -n 1
```

## 10. Prompt standard da dare al nuovo agent

```text
Leggi prima:
- docs/ai/restart/AGENT-OPERATIVO-COMANDI-DAY0.md
- docs/ai/restart/START-HERE-NETGESCON-DAY0.md
- docs/ai/restart/HANDOFF_AGENT_OPERATIVO_20260311.md
Poi esegui i passi 1->10 senza saltare controlli.
```