@noeva/analytics-core 0.4.1 → 0.5.1

package/contenuto/lib/modello/istruzioni.json

@@ -6,9 +6,12 @@
     "istruzioni.js: i segnaposto sono {progetto} (l'id del registro e di analytics.json) e,",
     "per lo snapshot, {data} (la data del dato). Cio' che e' vero del progetto (cliente,",
     "cosa coprono i dati, dashboard, contatto) sta nella scheda knowledge/rules/00-progetto.md,",
-    "non qui (NW-1261)."
+    "non qui (NW-1261).",
+    "regole_query: come si interroga un database vivo senza bloccarlo (11/11/2026); si",
+    "aggiunge alle istruzioni del vivo e alla scheda 00-progetto, che arriva col modello pubblicato."
   ],
   "nome": "noeva-{progetto}",
   "vivo": "NOEVA Analytics, progetto {progetto}: i dati del cliente dal vivo, in sola lettura. Prima di scrivere SQL leggi get_instructions: la regola 00-progetto dice di chi sono i dati, cosa coprono, dove stanno le dashboard e chi e' il contatto in 4D; le altre regole e describe_model dicono cosa significano i numeri. Valida con dry_run, poi run_sql con un limit; aggrega nel database invece di scaricare righe.",
-  "snapshot": "NOEVA Analytics, progetto {progetto}: SNAPSHOT delle dashboard (dato al {data}), il ripiego offline, non il database vivo. Prima di scrivere SQL leggi get_instructions: la regola 00-snapshot dice quali tabelle esistono e a che data e' il dato, la 00-progetto di chi sono i dati e dove stanno le dashboard. Dillo sempre nella risposta: e' il ripiego offline."
+  "snapshot": "NOEVA Analytics, progetto {progetto}: SNAPSHOT delle dashboard (dato al {data}), il ripiego offline, non il database vivo. Prima di scrivere SQL leggi get_instructions: la regola 00-snapshot dice quali tabelle esistono e a che data e' il dato, la 00-progetto di chi sono i dati e dove stanno le dashboard. Dillo sempre nella risposta: e' il ripiego offline.",
+  "regole_query": "Il database vivo e' quello di produzione, che usa anche il gestionale, e ogni query ha un tempo massimo di 2 minuti: prova la query su un mese, poi sull'anno; una query pesante alla volta, mai in parallelo; aggrega ogni tabella (GROUP BY) prima di unirla alle altre, mai un join riga per riga tra tabelle grandi (per esempio listino e fatture); se una query va in timeout riduci il periodo invece di spezzarla in piu' query in parallelo."
 }

package/contenuto/lib/modello/istruzioni.py

@@ -27,8 +27,13 @@ def nome_server(progetto: str) -> str:
     return _riempi(TESTI["nome"], progetto=progetto)
 
 
+def regole_query() -> str:
+    """Come si interroga un database vivo senza bloccarlo: anche nella scheda 00-progetto."""
+    return TESTI["regole_query"]
+
+
 def istruzioni_vivo(progetto: str) -> str:
-    return _riempi(TESTI["vivo"], progetto=progetto)
+    return _riempi(TESTI["vivo"], progetto=progetto) + " " + regole_query()
 
 
 def istruzioni_snapshot(progetto: str, data: str | None) -> str:

package/contenuto/lib/modello/pubblica.py

@@ -80,6 +80,20 @@ def estrai_da_head(radice: pathlib.Path, dest: pathlib.Path) -> None:
             tar.extractall(dest, filter="data")
 
 
+def costruisci(radice: pathlib.Path, tmp: pathlib.Path) -> tuple[pathlib.Path, dict]:
+    """Il modello consegnato dal commit di `radice`, compilato, in `tmp`/modello.
+
+    E' il modello pubblicato: lo usa main() per caricarlo e il backend del gateway
+    (lib/gateway/backend/modello.py) per metterlo nell'immagine, cosi' le due strade
+    non possono divergere. Restituisce la cartella e i conteggi delle trasformazioni."""
+    sorgente, dest = tmp / "sorgente", tmp / "modello"
+    estrai_da_head(radice, sorgente)
+    # Le trasformazioni di consegna.yml anche loro dal commit, non dal disco.
+    conta = modello_di_consegna(sorgente, dest, leggi_consegna(sorgente))
+    compila(dest)
+    return dest, conta
+
+
 def file_della_versione(dest: pathlib.Path) -> list[pathlib.Path]:
     return sorted(p for p in dest.rglob("*") if p.is_file() and not p.name.startswith("."))
 
@@ -99,11 +113,7 @@ def main(argv: list[str]) -> int:
     versione = versione_di(radice)
 
     with tempfile.TemporaryDirectory() as tmp:
-        sorgente, dest = pathlib.Path(tmp) / "sorgente", pathlib.Path(tmp) / "modello"
-        estrai_da_head(radice, sorgente)
-        # Le trasformazioni di consegna.yml anche loro dal commit, non dal disco.
-        conta = modello_di_consegna(sorgente, dest, leggi_consegna(sorgente))
-        compila(dest)
+        dest, conta = costruisci(radice, pathlib.Path(tmp))
         file = file_della_versione(dest)
         byte = sum(p.stat().st_size for p in file)
         print(f"▸ {progetto}: modello {versione}, {numero_modelli(dest)} modelli, {len(file)} file, "

package/contenuto/lib/modello/scheda.py

@@ -21,6 +21,7 @@ Legge, tutti facoltativi tranne analytics.json:
     models/                 quanti modelli
     apps/index.html         il titolo del progetto, che e' quello dell'indice
     apps/*/index.html       le dashboard, col titolo della pagina
+    istruzioni.json         le regole delle query sul vivo (regole_query), se ci sono sorgenti vive
 
 Il registro dei progetti (lib/rilascio/progetti.json) sta nel monorepo di 4D e il
 repository di un cliente non lo vede (il pacchetto non nomina clienti, ADR 0005):
@@ -41,6 +42,11 @@ import sys
 
 import yaml
 
+try:
+    from istruzioni import regole_query
+except (ImportError, OSError):  # un eseguibile costruito senza istruzioni.json: la scheda resta senza
+    regole_query = None
+
 FILE = "00-progetto.md"
 CONTENITORE = "https://analytics.noeva.ai"
 # Le cartelle di apps/ che non sono dashboard: il motore e i moduli di pagina.
@@ -119,6 +125,11 @@ def scheda(sorgente: pathlib.Path, conf: dict | None = None) -> str:
         r.append("- La copertura per sorgente non e' descritta (`cosa` in consegna.yml): la dicono "
                  "le regole e la descrizione dei modelli.")
 
+    if conf.get("sorgenti") and regole_query is not None:
+        # Arriva col modello pubblicato anche ai servizi gia' installati, prima del
+        # loro aggiornamento (11/11/2026: query pesanti in parallelo, connettore fermo).
+        r += ["", "## Le query sul database vivo", "", regole_query()]
+
     r += ["", "## Le dashboard", "",
           "Dietro il login NOEVA: le apre chi ha il progetto nel suo workspace.", "",
           f"- Indice: {base}"]

package/contenuto/lib/snapshot/ai.py

@@ -9,6 +9,12 @@ dalle stesse funzioni di commento.py, cosi' le regole restano in un posto solo.
 
   apps/dati/ai/commento-<pagina>.<lingua>.json   {sistema, modi, schema, generato}
   apps/dati/ai/chat-<pagina>.<lingua>.json       {sistema, testi, generato}   se c'e' chat.py
+  apps/dati/ai/presentazione-<pagina>.<lingua>.json
+      {sistema, sistema_modifica, schema, schema_modifica, partenze, generato}   se c'e' presentazione.py
+
+Questi file sono l'unica strada dell'AI delle pagine: chat.py, commento.py e
+presentazione.py del progetto tengono solo prompt e regole, mai una chiamata a un
+modello (la CLI di Claude non si usa; `analytics ci` lo controlla).
 
 Le pagine sono le cartelle di apps/ con un index.html, piu' l'indice; le lingue
 quelle di commento.LINGUE (apps/en/ non e' una pagina: e' la gemella inglese, che
@@ -73,6 +79,35 @@ def carica_chat(progetto: pathlib.Path):
     return modulo
 
 
+def carica_presentazione(progetto: pathlib.Path):
+    """presentazione.py del progetto, o None: il PowerPoint e' facoltativo."""
+    if not (progetto / "presentazione.py").exists():
+        return None
+    spec = importlib.util.spec_from_file_location(f"presentazione_{progetto.name}", progetto / "presentazione.py")
+    modulo = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(modulo)
+    for nome in ("istruzioni", "LINGUE", "SCHEMA", "SCHEMA_MODIFICA", "PRESET", "MODIFICA"):
+        if not hasattr(modulo, nome):
+            raise SystemExit(f"{progetto.name}/presentazione.py non ha {nome}: non e' allineato allo standard")
+    return modulo
+
+
+def prompt_presentazione(ppt, c, pagina: str, lingua: str) -> dict:
+    """Il prompt delle slide come lo costruiva presentazione.py sul Mac: per scriverle
+    (istruzioni) e per sistemarle in chat (istruzioni piu' MODIFICA), con la knowledge base."""
+    kb = "\n\n# Knowledge base del progetto\n\n" + c.conoscenza(pagina)
+    risposta = ppt.LINGUE[lingua].get("risposta", "nella lingua della pagina")
+    return {
+        "sistema": ppt.istruzioni(lingua) + kb,
+        "sistema_modifica": ppt.istruzioni(lingua) + "\n\n" + ppt.MODIFICA.replace("{RISPOSTA}", risposta) + kb,
+        "schema": ppt.SCHEMA,
+        "schema_modifica": ppt.SCHEMA_MODIFICA,
+        "partenze": [{"id": k, "nome": v["nome"].get(lingua) or v["nome"]["it"],
+                      "descrizione": v["descrizione"].get(lingua) or v["descrizione"]["it"],
+                      "richiesta": v["richiesta"]} for k, v in ppt.PRESET.items()],
+    }
+
+
 def pagine(progetto: pathlib.Path) -> list[str]:
     apps = progetto / "apps"
     trovate = sorted(p.name for p in apps.iterdir()
@@ -110,9 +145,19 @@ def main(argv: list[str]) -> int:
                      "generato": adesso},
                     ensure_ascii=False, indent=1) + "\n", encoding="utf-8")
                 n_chat += 1
+    ppt = carica_presentazione(progetto)
+    n_ppt = 0
+    if ppt:
+        for pagina in pagine(progetto):
+            for lingua in ppt.LINGUE:
+                (uscita / f"presentazione-{pagina}.{lingua}.json").write_text(json.dumps(
+                    {**prompt_presentazione(ppt, c, pagina, lingua), "generato": adesso},
+                    ensure_ascii=False, indent=1) + "\n", encoding="utf-8")
+                n_ppt += 1
     if not scritti and not n_chat:
         raise SystemExit(f"{progetto.name}: ne' commento guidato ne' chat, nessun prompt da scrivere")
-    print(f"  apps/dati/ai: {scritti} prompt del commento, {n_chat} della chat ({len(c.LINGUE)} lingue)")
+    print(f"  apps/dati/ai: {scritti} prompt del commento, {n_chat} della chat, {n_ppt} della presentazione"
+          f" ({len(c.LINGUE)} lingue)")
     return 0
 
 

package/contenuto/lib/snapshot/worker/installa.ps1

@@ -310,8 +310,13 @@ if ($SoloControllo) {
 } else {
     Write-Host "  Ogni $minuti minuti lancia 'ascolta --una-volta' come $env:USERNAME, anche senza sessione aperta:"
     Write-Host '  per questo Windows chiede la password di questo utente (quella di Windows, non del database).'
-    $credenziali = Get-Credential -UserName "$env:USERDOMAIN\$env:USERNAME" -Message "Password Windows di $env:USERNAME"
-    if (-not $credenziali) { Ferma 'attivita''' 'nessuna password Windows: senza, l''attivita'' non gira a sessione chiusa' }
+    # In console, non con Get-Credential: in desktop remoto la finestrella finisce dietro e lo
+    # script sembra fermo (12/11/2026, sulla VM di un cliente).
+    $utenteWin = "$env:USERDOMAIN\$env:USERNAME"
+    $pwWin = ChiediSegreto "Password Windows di $utenteWin (non si vede mentre scrivi, poi Invio)"
+    if (-not $pwWin) { Ferma 'attivita''' 'nessuna password Windows: senza, l''attivita'' non gira a sessione chiusa' }
+    $credenziali = [pscustomobject]@{ UserName = $utenteWin }
+    Write-Host '  Registro l''attivita'' con Windows...'
     $log = Join-Path $destinazione 'lavoro\ascolta.log'
     $azione = New-ScheduledTaskAction -Execute 'cmd.exe' -WorkingDirectory $destinazione `
         -Argument "/c `"`"$exe`" ascolta --config `"$(Join-Path $destinazione 'worker.json')`" --una-volta >> `"$log`" 2>&1`""
@@ -320,13 +325,13 @@ if ($SoloControllo) {
         -StartWhenAvailable -DontStopIfGoingOnBatteries -AllowStartIfOnBatteries
     try {
         Register-ScheduledTask -TaskName $attivita -Action $azione -Trigger $quando -Settings $regole `
-            -User $credenziali.UserName -Password $credenziali.GetNetworkCredential().Password -RunLevel Limited -Force | Out-Null
+            -User $credenziali.UserName -Password $pwWin -RunLevel Limited -Force -ErrorAction Stop | Out-Null
         Enable-ScheduledTask -TaskName $attivita | Out-Null
         Esito 'attivita''' 'ok' "ogni $minuti minuti come $($credenziali.UserName); registro in $log"
     } catch {
         Esito 'attivita''' 'NO' "Windows l'ha rifiutata (password giusta?): $($_.Exception.Message)"
     }
-    $credenziali = $null
+    $credenziali = $null; $pwWin = $null
 }
 
 # 8. La dashboard ------------------------------------------------------------------------------

package/contenuto/lib/snapshot/worker/ultimi-giri.ps1

@@ -0,0 +1,202 @@
+# Gli ultimi giri del worker degli snapshot e il loro esito, senza cambiare niente.
+#
+#   powershell -ExecutionPolicy Bypass -File C:\NOEVA\snapshot\ultimi-giri.ps1
+#   powershell -ExecutionPolicy Bypass -File C:\NOEVA\snapshot\ultimi-giri.ps1 -Giri 20
+#
+# Legge l'attivita' pianificata, lavoro\ascolta.log (tutti i giri, con l'esito) e il
+# giro.json degli ultimi giri tenuti in lavoro\<progetto>\ (le cifre di controllo che
+# hanno avvisato o fermato). Non legge chiavi ne' password e non chiama NOEVA.
+# Lo lancia l'utente del worker, o chiunque possa leggere C:\NOEVA\snapshot.
+
+param(
+    [int]$Giri = 10,
+    [string]$Cartella = ''
+)
+
+# Di solito accanto a noeva-snapshot (C:\NOEVA\snapshot); copiato altrove, guarda li'.
+if (-not $Cartella) {
+    $Cartella = if ($PSScriptRoot -and (Test-Path (Join-Path $PSScriptRoot 'worker.json'))) { $PSScriptRoot } else { 'C:\NOEVA\snapshot' }
+}
+
+$ErrorActionPreference = 'Continue'
+# Il nome lo da' installa.ps1: "NOEVA snapshot <progetto>", dal progetto di worker.json.
+$attivita = 'NOEVA snapshot'
+$log = Join-Path $Cartella 'lavoro\ascolta.log'
+$conf = Join-Path $Cartella 'worker.json'
+
+function Riga([string]$etichetta, [string]$stato, [string]$testo) {
+    $colore = switch ($stato) { 'ok' { 'Green' } 'avviso' { 'Yellow' } 'NO' { 'Red' } default { 'Gray' } }
+    Write-Host ('  {0,-8}' -f $stato) -ForegroundColor $colore -NoNewline
+    Write-Host (' {0,-22} {1}' -f $etichetta, $testo)
+}
+
+function Durata([timespan]$d) {
+    if ($d.TotalMinutes -lt 1) { return '{0} s' -f [int]$d.TotalSeconds }
+    if ($d.TotalHours -lt 1) { return '{0} min' -f [int]$d.TotalMinutes }
+    if ($d.TotalDays -lt 1) { return '{0:0.#} ore' -f $d.TotalHours }
+    return '{0:0.#} giorni' -f $d.TotalDays
+}
+
+if (Test-Path $conf) {
+    try {
+        $w = Get-Content $conf -Raw | ConvertFrom-Json
+        $progetti = @($w.pipeline.PSObject.Properties | ForEach-Object { $_.Value.progetto })
+        if ($progetti.Count -eq 1) { $attivita = "NOEVA snapshot $($progetti[0])" }
+    } catch { }
+}
+# Senza worker.json leggibile: la prima attivita' del worker che c'e' su questa macchina.
+if ($attivita -eq 'NOEVA snapshot' -and (Get-Command Get-ScheduledTask -ErrorAction SilentlyContinue)) {
+    $trovata = Get-ScheduledTask -TaskName 'NOEVA snapshot *' -ErrorAction SilentlyContinue | Select-Object -First 1
+    if ($trovata) { $attivita = $trovata.TaskName }
+}
+
+Write-Host ''
+Write-Host "NOEVA Analytics - gli ultimi giri del worker degli snapshot" -ForegroundColor Cyan
+Write-Host ("macchina {0} - {1} - {2}" -f $env:COMPUTERNAME, $Cartella, (Get-Date -Format 'dd/MM/yyyy HH:mm'))
+
+# --- l'attivita' pianificata ------------------------------------------------------
+Write-Host ''
+Write-Host "== L'attivita' pianificata '$attivita'"
+$t = if (Get-Command Get-ScheduledTask -ErrorAction SilentlyContinue) { Get-ScheduledTask -TaskName $attivita -ErrorAction SilentlyContinue }
+if (-not $t) {
+    Riga 'attivita''' 'NO' "non c'e': va rilanciato installa.ps1"
+} else {
+    $info = Get-ScheduledTaskInfo -TaskName $attivita
+    $codici = @{
+        '0'          = 'ok'
+        '267009'     = 'in corso adesso'
+        '267011'     = 'non e'' mai partita'
+        '2147943785' = 'Windows rifiuta l''accesso: manca il diritto "Accesso come processo batch"'
+        '2147942402' = 'file non trovato: la cartella e'' cambiata, rilancia installa.ps1'
+        '2147943726' = 'password Windows sbagliata o cambiata: rilancia installa.ps1'
+    }
+    $r = [int64]$info.LastTaskResult
+    if ($r -lt 0) { $r += 4294967296 }
+    $significato = if ($codici.ContainsKey("$r")) { $codici["$r"] } else { 'codice 0x{0:X8}' -f $r }
+    $stato = if ($t.State -eq 'Disabled') { 'NO' } elseif ($r -in 0, 267009) { 'ok' } elseif ($r -eq 267011) { 'avviso' } else { 'NO' }
+    Riga 'stato' $stato ("{0}, ultimo avvio {1:dd/MM HH:mm}, {2}" -f $t.State, $info.LastRunTime, $significato)
+    if ($t.State -eq 'Disabled') {
+        Riga 'disattivata' 'NO' "non parte finche' non si riaccende: i giri di NOEVA restano in coda"
+        Write-Host "           Enable-ScheduledTask -TaskName '$attivita'; Start-ScheduledTask -TaskName '$attivita'" -ForegroundColor Yellow
+        Write-Host "           (installa.ps1 la spegne durante un aggiornamento e la riaccende al passo 7)" -ForegroundColor Yellow
+    }
+    Riga 'prossimo avvio' 'info' ("{0:dd/MM HH:mm} (ogni 5 minuti chiede a NOEVA se c'e' un giro)" -f $info.NextRunTime)
+}
+
+# --- ascolta.log ------------------------------------------------------------------
+Write-Host ''
+Write-Host "== I giri in ascolta.log"
+if (-not (Test-Path $log)) {
+    Riga 'ascolta.log' 'avviso' "non c'e' ancora: nessun giro"
+    Write-Host ''
+    exit 0
+}
+
+$righe = Get-Content $log -Encoding UTF8
+$reTs = '^(\d{4}-\d\d-\d\d \d\d:\d\d:\d\d) '
+$tutti = New-Object System.Collections.ArrayList
+$corrente = $null
+$ultimoAscolto = $null
+$erroriApi = New-Object System.Collections.ArrayList
+
+foreach ($riga in $righe) {
+    if ($riga -match ($reTs + 'in ascolto per')) {
+        $ultimoAscolto = [datetime]$Matches[1]
+    } elseif ($riga -match ($reTs + 'non riesco a chiedere lavoro all''API: (.*)$')) {
+        [void]$erroriApi.Add([pscustomobject]@{ Quando = [datetime]$Matches[1]; Testo = $Matches[2] })
+    } elseif ($riga -match ($reTs + '(\S+): processo (\S+), giro in (.+)$')) {
+        $corrente = [pscustomobject]@{
+            Inizio = [datetime]$Matches[1]; Pipeline = $Matches[2]; Processo = $Matches[3]
+            Cartella = $Matches[4].Trim(); Fine = $null; Esito = 'interrotto'; Dettaglio = ''
+            Versione = ''; DataDato = ''; Avvisi = 0
+        }
+        [void]$tutti.Add($corrente)
+    } elseif ($corrente -and $riga -match '^\s+data del dato: (\S+)') {
+        $corrente.DataDato = $Matches[1]
+    } elseif ($corrente -and $riga -match '^\s+(\d+) cifre di controllo spostate entro la tolleranza') {
+        $corrente.Avvisi = [int]$Matches[1]
+    } elseif ($corrente -and $riga -match ($reTs + '\S+: pubblicata (\S+) in ([\d.]+)s')) {
+        $corrente.Fine = [datetime]$Matches[1]; $corrente.Esito = 'pubblicato'; $corrente.Versione = $Matches[2]
+        $corrente = $null
+    } elseif ($corrente -and $riga -match ($reTs + '\S+: FALLITO, (.*)$')) {
+        $corrente.Fine = [datetime]$Matches[1]; $corrente.Esito = 'FALLITO'; $corrente.Dettaglio = $Matches[2]
+        $corrente = $null
+    }
+}
+
+$ok = @($tutti | Where-Object Esito -eq 'pubblicato')
+$ko = @($tutti | Where-Object Esito -eq 'FALLITO')
+Riga 'giri nel log' 'info' ("{0} in tutto: {1} pubblicati, {2} falliti, dal {3:dd/MM/yyyy}" -f $tutti.Count, $ok.Count, $ko.Count, $(if ($tutti.Count) { $tutti[0].Inizio } else { Get-Date }))
+
+if ($ultimoAscolto) {
+    $fa = (Get-Date) - $ultimoAscolto
+    $stato = if ($fa.TotalMinutes -le 15) { 'ok' } else { 'NO' }
+    $nota = if ($stato -eq 'ok') { '' } else { ': l''attivita'' non parte, guarda lo stato qui sopra' }
+    Riga 'ultimo controllo' $stato ("{0:dd/MM HH:mm}, {1} fa{2}" -f $ultimoAscolto, (Durata $fa), $nota)
+}
+if ($ok.Count) {
+    $u = $ok[-1]
+    $fa = (Get-Date) - $u.Fine
+    Riga 'ultimo pubblicato' $(if ($fa.TotalHours -le 26) { 'ok' } else { 'avviso' }) ("{0:dd/MM HH:mm}, {1} fa, versione {2}, dato al {3}" -f $u.Fine, (Durata $fa), $u.Versione, $u.DataDato)
+} else {
+    Riga 'ultimo pubblicato' 'NO' 'nessun giro pubblicato in ascolta.log'
+}
+$recenti = @($erroriApi | Where-Object { $_.Quando -gt (Get-Date).AddDays(-1) })
+if ($recenti.Count) {
+    Riga 'errori verso NOEVA' 'avviso' ("{0} nelle ultime 24 ore, l'ultimo {1:dd/MM HH:mm}: {2}" -f $recenti.Count, $recenti[-1].Quando, $recenti[-1].Testo)
+}
+
+Write-Host ''
+Write-Host ("== Gli ultimi {0} giri (il piu' recente in alto)" -f [Math]::Min($Giri, $tutti.Count))
+if (-not $tutti.Count) { Write-Host '  nessun giro ancora' }
+$mostrati = @($tutti | Select-Object -Last $Giri)
+[array]::Reverse($mostrati)
+foreach ($g in $mostrati) {
+    $durata = if ($g.Fine) { Durata ($g.Fine - $g.Inizio) } else { '-' }
+    switch ($g.Esito) {
+        'pubblicato' {
+            $avv = if ($g.Avvisi) { ", $($g.Avvisi) avvisi" } else { '' }
+            Riga ('{0:ddd dd/MM HH:mm}' -f $g.Inizio) 'ok' ("pubblicato {0}, dato al {1}, {2}{3}" -f $g.Versione, $g.DataDato, $durata, $avv)
+        }
+        'FALLITO' {
+            Riga ('{0:ddd dd/MM HH:mm}' -f $g.Inizio) 'NO' ("FALLITO dopo {0}: {1}" -f $durata, $g.Dettaglio)
+        }
+        default {
+            $inCorso = ((Get-Date) - $g.Inizio).TotalMinutes -lt 30 -and $g -eq $tutti[-1]
+            Riga ('{0:ddd dd/MM HH:mm}' -f $g.Inizio) $(if ($inCorso) { 'info' } else { 'avviso' }) $(if ($inCorso) { 'in corso adesso' } else { 'interrotto senza esito (macchina spenta o processo chiuso?)' })
+        }
+    }
+}
+
+# --- le cifre di controllo degli ultimi giri ----------------------------------------
+# giro.json resta per gli ultimi 5 giri di ogni progetto (ascolta.py, GIRI_TENUTI).
+$ultimi = @($tutti | Where-Object { $_.Cartella -and (Test-Path -LiteralPath ([IO.Path]::Combine($_.Cartella, 'giro.json'))) } | Select-Object -Last 1)
+if ($ultimi.Count) {
+    $g = $ultimi[0]
+    Write-Host ''
+    Write-Host ("== Le cifre di controllo del giro del {0:dd/MM HH:mm}" -f $g.Inizio)
+    try {
+        $rep = Get-Content -LiteralPath ([IO.Path]::Combine($g.Cartella, 'giro.json')) -Raw -Encoding UTF8 | ConvertFrom-Json
+        $controlli = @($rep.controlli | Where-Object { $_.PSObject.Properties.Name -contains 'esito' })
+        $fuori = @($controlli | Where-Object { $_.esito -ne 'ok' })
+        Riga 'controlli' $(if (@($fuori | Where-Object esito -eq 'diverso').Count) { 'NO' } elseif ($fuori.Count) { 'avviso' } else { 'ok' }) ("{0} in tutto, {1} ok" -f $controlli.Count, ($controlli.Count - $fuori.Count))
+        foreach ($c in $fuori) {
+            $scarto = if ([double]$c.atteso -ne 0) { ' ({0:+0.00;-0.00}%)' -f ((([double]$c.trovato - [double]$c.atteso) / [Math]::Abs([double]$c.atteso)) * 100) } else { '' }
+            $stato = if ($c.esito -eq 'diverso') { 'NO' } else { 'avviso' }
+            Write-Host ('  {0,-8}' -f $stato) -ForegroundColor $(if ($stato -eq 'NO') { 'Red' } else { 'Yellow' }) -NoNewline
+            Write-Host (" {0}" -f $c.nome)
+            Write-Host ("           trovato {0:N2}, atteso {1:N2}{2}" -f [double]$c.trovato, [double]$c.atteso, $scarto)
+        }
+        if (@($fuori | Where-Object esito -eq 'diverso').Count) {
+            Write-Host ''
+            Write-Host '  Una cifra fuori tolleranza ferma la pubblicazione: online resta lo snapshot di prima.' -ForegroundColor Yellow
+            Write-Host '  Si guarda la cifra (snapshot.yml del progetto), non si forza.' -ForegroundColor Yellow
+        }
+    } catch {
+        Riga 'giro.json' 'avviso' "non leggibile: $($_.Exception.Message)"
+    }
+}
+
+Write-Host ''
+Write-Host "Il log completo: $log"
+Write-Host ''

package/core.js

@@ -209,6 +209,47 @@ export const ASSETSIGNORE = [
 const ROTTE_DEL_CONTENITORE = new Set(['', 'vendor', 'sessione', 'logout']);
 const RIFERIMENTO = /(?:(?:href|src)=["']|fetch\(\s*["'`]|from\s+["']|import\(\s*["'`]|url\(\s*["']?)\/([^"'`)/?#\s]*)/g;
 
+// L'AI passa solo da NOEVA (inferenza NOEVA o NOEVA Agents, ADR 0006): nessun file
+// del progetto lancia la CLI di Claude o chiama un'API di modelli diretta, e
+// serve-app.py non espone le rotte che la lanciavano. Non c'e' eccezione da
+// dichiarare: un token AI che non passa da NOEVA ferma la verifica.
+export const AI_FUORI_DA_NOEVA = [
+  [/\bwhich\(\s*["'`]claude["'`]/, 'cerca la CLI di Claude'],
+  [/["'`]claude["'`]\s*,\s*["'`]-(?:p|-print|-resume|-session-id|-output-format)\b/, 'lancia la CLI di Claude'],
+  [/\bclaude\s+(?:-p|--print)\b/, 'lancia la CLI di Claude'],
+  [/\.local\/bin\/claude\b/, 'cerca la CLI di Claude'],
+  [/\bapi\.anthropic\.com\b|@anthropic-ai\/|^\s*(?:import|from)\s+anthropic\b|\bANTHROPIC_API_KEY\b/m, "chiama l'API di Anthropic diretta"],
+  [/\bapi\.openai\.com\b|^\s*(?:import|from)\s+openai\b|\bOPENAI_API_KEY\b/m, "chiama l'API di OpenAI diretta"],
+  [/\bbedrock-runtime\b|generativelanguage\.googleapis\.com/, 'chiama un servizio di modelli diretto'],
+  [/["'`]\/ai\/(?:chat|chat\/storia|tour|presentazione\/modifica)["'`]/, 'serve una rotta che lanciava la CLI di Claude'],
+];
+const FUORI_DALLA_RICERCA = new Set(['node_modules', '.git', '.wren', '.venv', 'venv', '__pycache__', 'target', 'dist',
+  'vendor', '.claude', '.wrangler', 'dati']);
+
+function fileDelCodice(cartella) {
+  const fuori = [];
+  for (const voce of readdirSync(cartella, { withFileTypes: true })) {
+    if (voce.isDirectory()) {
+      if (!FUORI_DALLA_RICERCA.has(voce.name)) fuori.push(...fileDelCodice(join(cartella, voce.name)));
+    } else if (/\.(py|js|mjs|cjs|ts|sh|ps1|html)$/.test(voce.name)) fuori.push(join(cartella, voce.name));
+  }
+  return fuori;
+}
+
+export function aiFuoriDaNoeva(radice) {
+  const trovati = new Map();
+  for (const f of fileDelCodice(radice)) {
+    const testo = readFileSync(f, 'utf8');
+    for (const [re, cosa] of AI_FUORI_DA_NOEVA) {
+      const m = re.exec(testo);
+      if (!m) continue;
+      const dove = `${posix(relative(radice, f))}:${testo.slice(0, m.index).split('\n').length}`;
+      if (!trovati.has(dove)) trovati.set(dove, `${dove} ${cosa}: l'AI passa solo da NOEVA (inferenza o Agents)`);
+    }
+  }
+  return [...trovati.values()];
+}
+
 function trackedDaGit(radice) {
   if (!existsSync(join(radice, '.git'))) return null;
   try {
@@ -258,6 +299,8 @@ export function verifica(radice, config) {
     }
   }
 
+  errori.push(...aiFuoriDaNoeva(radice));
+
   const tracciati = trackedDaGit(radice);
   if (tracciati) {
     for (const f of tracciati) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noeva/analytics-core",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "Gli strumenti di un progetto NOEVA Analytics nel suo repository: moduli di pagina, snapshot, verifica dello standard e kit dell'agente (ADR 0005).",
   "type": "module",
   "bin": {