netgescon-day0/docs/ai/restart/AGENT-OPERATIVO-COMANDI-DAY0.md

3.2 KiB

Agent Operativo - Comandi Day-0

Documento operativo da dare al nuovo agent.

0. Letture obbligatorie iniziali

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

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)

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

3. Avvio/Riavvio server sviluppo su :8000

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

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)

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

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

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)

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

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

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.