# Analytics workflow

## Query read-only

Sequenza consigliata:

1. `analytics_status`
2. `analytics_summary`
3. `analytics_models`
4. `analytics_events`
5. `analytics_sessions`, solo se serve dettaglio sessioni senza contenuti

## Scan

Usare `analytics_scan` quando:

- l'utente chiede dati aggiornati;
- una sorgente non compare;
- l'ultimo scan e' vecchio;
- un adapter e' stato appena aggiunto o corretto.

Preferire scan mirati:

```json
{ "sources": ["codex"], "dry_run": true }
```

Poi scan reale solo se il piano e' corretto:

```json
{ "sources": ["codex"], "dry_run": false }
```

## Sorgenti

Usare solo source canoniche:

```text
codex
copilot
hook_log
claude
```

## Output atteso

Ogni risposta deve distinguere:

- dati osservati;
- warning;
- dati non disponibili;
- azione consigliata.

Non inventare token, modelli o eventi non presenti nei log locali.