@noeva/analytics-core 0.1.0 → 0.3.0

package/contenuto/lib/mcp-locale/cartella/CLAUDE.md

@@ -0,0 +1,52 @@
+# NOEVA Analytics · {{cliente}}
+
+Questa cartella serve a interrogare i dati di {{cliente}} con Claude. Chi la usa sono gli
+analisti di {{cliente}}: rispondi in italiano, con numeri verificabili, senza gergo tecnico se
+non lo chiedono.
+
+## Da dove vengono i dati
+
+Il server MCP **{{server}}** legge in sola lettura il database di produzione: {{cosa}}.
+È il modello semantico NOEVA: tabelle con nomi leggibili (`fatture_vendita`, `versamenti`,
+`giacenze`, …) e le regole di business già scritte dentro o accanto.
+
+Server SQL {{host}}, raggiungibile solo dalla rete di {{cliente}} (o in VPN).
+
+## Come si risponde a una domanda sui dati
+
+1. A inizio sessione chiama `get_instructions`: sono le regole di business (quali documenti
+   sono fatturato, quale data usare, i segni degli importi, le regole P1-P14 della produzione
+   e M1-M10 del magazzino). Valgono più di quello che sembra ovvio dai nomi delle colonne.
+2. `list_models` e `describe_model` per le tabelle e le colonne; `recall_queries` per le
+   domande simili già risolte.
+3. Scrivi la SQL sul modello, validala con `dry_run`, eseguila con `run_sql`.
+4. Aggrega nel database (SUM, COUNT, GROUP BY) invece di scaricare righe, e metti sempre
+   un `limit`: è il database di produzione, in orario di lavoro lo usa anche l'ERP.
+5. Nella risposta di' periodo, filtri e regole applicate. Se l'analista lo chiede, mostra
+   la query.
+
+## Cosa non fare
+
+- Non inventare né stimare cifre. Se una query fallisce o un dato manca, dillo.
+- Non collegarti al database per altre strade (sqlcmd, script, ODBC): solo {{server}}.
+- Non scrivere mai la password in chat, in un file o in un comando. Sta nella variabile
+  d'ambiente `{{password_env}}` dell'utente Windows e la legge solo il server.
+- Non modificare la cartella `noeva/`: è il motore (eseguibile, modello, regole). Le regole
+  si leggono in `noeva/modello/knowledge/rules/`, si cambiano solo con un aggiornamento
+  di NOEVA.
+
+## Se {{server}} non risponde
+
+Se `/mcp` mostra {{server}} come *failed*, o gli strumenti non ci sono, esegui in PowerShell
+dalla cartella:
+
+```powershell
+{{exe_ps}} --verifica
+```
+
+Dice cosa manca: la password (`imposta-password.ps1`), il driver "ODBC Driver 18 for SQL
+Server", la rete verso {{host}}. Spiegalo all'analista con le istruzioni di `LEGGIMI.md`.
+Dopo aver impostato la password bisogna chiudere e riaprire Claude Code.
+
+Ripiego offline (snapshot delle dashboard): {{server_snapshot}}. È spento; si accende da
+`/mcp` solo se l'analista lo chiede, e le risposte devono dire che il dato è dello snapshot.

package/contenuto/lib/mcp-locale/cartella/LEGGIMI.md

@@ -0,0 +1,163 @@
+# NOEVA Analytics · {{cliente}} — installazione su Windows 11
+
+Questa cartella permette di fare domande sui dati di {{cliente}} a Claude, con Claude Code
+(dal terminale o dalla scheda **Code** di Claude Desktop). Claude legge il database di
+produzione in sola lettura attraverso **{{server}}**, un programma nella cartella `noeva\`
+che Claude Code avvia da solo quando apri la cartella: non c'è niente da tenere acceso, e
+dopo un riavvio del PC funziona come prima.
+
+Versione {{versione}}.
+
+## Il modo più semplice: installa.ps1
+
+Estrai lo zip dove vuoi (Desktop o Download, non in `C:\NOEVA`), apri PowerShell in quella
+cartella e lancia:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\installa.ps1
+```
+
+Fa tutto lui, passo per passo, e chiede solo quello che serve: controlla la rete, Claude
+Code e il driver, copia la cartella in `C:\NOEVA\{{nome}}` (se c'è già la mette da parte e
+riporta i tuoi file), chiede la password se manca, verifica i numeri dal vivo e alla fine
+scrive l'esito in `esito-installa-<data>.txt`. Dopo un riavvio, per controllare senza
+cambiare niente: `.\installa.ps1 -SoloControllo`.
+
+I passi qui sotto sono gli stessi, a mano.
+
+## Cosa serve
+
+- Windows 10 (1809 o successivo) o Windows 11, 64 bit.
+- Un account Claude Pro, Max, Team o Enterprise. Il piano gratuito non include Claude Code.
+- Il PC nella rete di {{cliente}} (o in VPN): deve raggiungere il server SQL {{host}}
+  sulla porta 1433.
+- La password dell'utente `{{utente}}`, che vi diamo a parte, mai insieme alla cartella.
+
+## 0. La rete
+
+Prima di installare, controlla che il PC raggiunga il database:
+
+```powershell
+Test-NetConnection {{host}} -Port 1433
+```
+
+Deve rispondere `TcpTestSucceeded : True`. Se no, è un problema di rete da risolvere con
+l'IT: il resto non funzionerebbe.
+
+## 1. Claude Code
+
+Apri **PowerShell** (non serve come amministratore) e lancia:
+
+```powershell
+irm https://claude.ai/install.ps1 | iex
+```
+
+Poi apri un **nuovo** PowerShell e controlla:
+
+```powershell
+claude --version
+```
+
+Se l'installer avvisa che `%USERPROFILE%\.local\bin` non è nel PATH e `claude` non
+esiste, Claude Code è installato ma manca il PATH (non serve winget). Aggiungilo così, poi
+apri un PowerShell **nuovo**:
+
+```powershell
+[Environment]::SetEnvironmentVariable('Path', [Environment]::GetEnvironmentVariable('Path','User') + ";$env:USERPROFILE\.local\bin", 'User')
+```
+
+La prima volta che lanci `claude` chiede di accedere con l'account Claude: fallo, poi esci
+con `/exit`.
+
+Git for Windows non è necessario: senza, Claude Code usa PowerShell.
+
+Se preferite Claude Desktop, la scheda **Code** usa la stessa cartella e la stessa
+configurazione: va bene uno dei due o entrambi.
+
+## 2. Il driver per SQL Server
+
+Serve **Microsoft ODBC Driver 18 for SQL Server** (x64). Scaricalo dalla pagina Microsoft
+"Download ODBC Driver for SQL Server" (https://aka.ms/downloadmsodbcsql) e installalo: questo
+passaggio chiede i diritti di amministratore, una volta per PC.
+
+Per controllare, in PowerShell:
+
+```powershell
+Get-OdbcDriver -Name "ODBC Driver 18 for SQL Server" -Platform 64-bit
+```
+
+## 3. La cartella
+
+Estrai lo zip in una cartella **locale**, per esempio `C:\NOEVA\{{nome}}`. Evita Desktop e
+Documenti se sono sincronizzati con OneDrive.
+
+Windows segna i file arrivati da internet; per evitare l'avviso di SmartScreen sul
+programma, una volta, dalla cartella:
+
+```powershell
+cd C:\NOEVA\{{nome}}
+Get-ChildItem -Recurse | Unblock-File
+```
+
+## 4. La password
+
+Dalla cartella:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\imposta-password.ps1
+```
+
+Chiede la password di `{{utente}}` (non si vede mentre scrivi), la salva nella variabile
+d'ambiente `{{password_env}}` del tuo utente Windows e prova subito la connessione. Deve
+finire con **tutto a posto**.
+
+Poi **chiudi questa finestra di PowerShell e aprine una nuova**: la finestra in cui hai
+lanciato lo script non vede la password, e lì `--verifica` direbbe *manca la password*.
+
+Perché una variabile d'ambiente e non un file nella cartella: la cartella si copia, si
+zippa, si manda per email e a volte finisce su OneDrive; la variabile resta sul PC, legata
+al tuo utente, e sopravvive agli aggiornamenti della cartella. Ogni utente Windows che usa
+la cartella imposta la sua.
+
+## 5. Il primo avvio
+
+Chiudi e riapri PowerShell (la variabile si legge all'avvio), poi:
+
+```powershell
+cd C:\NOEVA\{{nome}}
+claude
+```
+
+La prima volta Claude Code chiede se ti fidi della cartella: rispondi di sì. Poi scrivi:
+
+```
+/mcp
+```
+
+Devi vedere **{{server}}** come connesso. Prova con una domanda, per esempio: *«Qual è il
+fatturato 2025 per famiglia di prodotto?»*
+
+Con Claude Desktop: chiudilo del tutto e riaprilo dopo il passo 4, scheda **Code**, scegli
+la cartella `C:\NOEVA\{{nome}}`.
+
+## Problemi
+
+Il controllo che dice cosa manca, da PowerShell nella cartella:
+
+```powershell
+{{exe_ps}} --verifica
+```
+
+| Cosa vedi | Cosa fare |
+|---|---|
+| `manca la password di {{utente}}` | passo 4, poi chiudi e riapri Claude Code |
+| `il driver 'ODBC Driver 18 for SQL Server' non e' installato` | passo 2 |
+| `Login timeout expired` o `TCP Provider` | il PC non raggiunge {{host}}: rete di {{cliente}} o VPN |
+| `Login failed for user '{{utente}}'` | password sbagliata: rifai il passo 4 |
+| in `/mcp` {{server}} è *failed* ma `--verifica` è a posto | chiudi e riapri Claude Code dalla cartella giusta (`cd` prima di `claude`) |
+| Windows blocca `{{nome}}.exe` | `Unblock-File` del passo 3; se c'è un antivirus aziendale, va messa in eccezione la cartella `noeva\` |
+
+## Aggiornamenti
+
+Vi mandiamo una nuova cartella `noeva\`: si sostituisce quella vecchia. La password resta
+nella variabile d'ambiente, non va reimpostata.

package/contenuto/lib/mcp-locale/cartella/imposta-password.ps1

@@ -0,0 +1,40 @@
+# Imposta la password di {{utente}} per NOEVA Analytics ({{cliente}}) e controlla la connessione.
+#
+#   powershell -ExecutionPolicy Bypass -File .\imposta-password.ps1
+#
+# La password va nella variabile d'ambiente {{password_env}} del tuo utente Windows: non
+# nella cartella, che si copia, si zippa e a volte finisce su OneDrive. La legge solo
+# noeva\{{nome}}.exe, che Claude Code avvia. Dopo, chiudi e riapri Claude Code.
+
+$ErrorActionPreference = 'Stop'
+$qui = Split-Path -Parent $MyInvocation.MyCommand.Path
+
+$sicura = Read-Host "Password di {{utente}}" -AsSecureString
+$bstr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($sicura)
+try {
+    $chiaro = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($bstr)
+} finally {
+    [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($bstr)
+}
+if (-not $chiaro) {
+    Write-Host "Nessuna password inserita: non cambio niente."
+    exit 1
+}
+
+[Environment]::SetEnvironmentVariable('{{password_env}}', $chiaro, 'User')
+$env:{{password_env}} = $chiaro
+Write-Host "Password salvata nella variabile {{password_env}} del tuo utente Windows."
+Write-Host ""
+
+& (Join-Path $qui 'noeva\{{nome}}.exe') --verifica
+$esito = $LASTEXITCODE
+
+Write-Host ""
+if ($esito -eq 0) {
+    Write-Host "Ora chiudi QUESTA finestra di PowerShell e aprine una nuova: qui la password non si vede,"
+    Write-Host "e un --verifica lanciato da qui direbbe 'manca la password'. Chiudi e riapri anche"
+    Write-Host "Claude Code (o Claude Desktop): leggono la variabile solo all'avvio."
+} else {
+    Write-Host "Qualcosa non va: leggi le righe NO qui sopra e la sezione Problemi di LEGGIMI.md."
+}
+exit $esito

package/contenuto/lib/mcp-locale/cartella/installa.ps1

@@ -0,0 +1,286 @@
+# Installa o aggiorna {{nome}} su questo PC, passo per passo, e alla fine dice com'e' andata.
+#
+#   powershell -ExecutionPolicy Bypass -File .\installa.ps1                  installa o aggiorna
+#   powershell -ExecutionPolicy Bypass -File .\installa.ps1 -SoloControllo   controlla e basta (dopo un riavvio)
+#
+# Si lancia dalla cartella estratta dallo zip, dove si vuole (Desktop, Download): la copia
+# in C:\NOEVA\{{nome}} la fa lo script. Se C:\NOEVA\{{nome}} c'e' gia' e' un aggiornamento:
+# la cartella vecchia si mette da parte (non si cancella), i file dell'utente si riportano,
+# la password resta. Nessun segreto finisce a schermo o nel file dell'esito.
+
+param([switch]$SoloControllo)
+
+$ErrorActionPreference = 'Stop'
+try { [Console]::OutputEncoding = [Text.Encoding]::UTF8 } catch { }
+
+$qui = Split-Path -Parent $MyInvocation.MyCommand.Path
+$nome = '{{nome}}'
+$cliente = '{{cliente}}'
+$versione = '{{versione}}'
+$dbHost = '{{host}}'
+$dbPorta = 1433
+$utenteDb = '{{utente}}'
+$varPassword = '{{password_env}}'
+# La variabile della chiave API NOEVA con cui il servizio scarica il modello aggiornato
+# (ADR 0005, punto 6). Vuota: il modello e' solo quello della cartella.
+$varChiave = '{{chiave_env}}'
+$domanda = '{{domanda}}'
+$destinazione = "C:\NOEVA\$nome"
+$exe = Join-Path $destinazione "noeva\$nome.exe"
+$modo = 'nuova installazione'
+$esiti = New-Object System.Collections.ArrayList
+
+function Passo($titolo) {
+    Write-Host ''
+    Write-Host "== $titolo" -ForegroundColor Cyan
+}
+
+function Esito($passo, $stato, $nota) {
+    [void]$esiti.Add([pscustomobject]@{ Passo = $passo; Stato = $stato; Nota = $nota })
+    $colore = @{ 'ok' = 'Green'; 'avviso' = 'Yellow'; 'NO' = 'Red'; 'saltato' = 'DarkGray' }[$stato]
+    Write-Host ('  {0,-7} {1}' -f $stato, $nota) -ForegroundColor $colore
+}
+
+function Chiedi($domanda, [bool]$predefinito = $true) {
+    $suggerimento = if ($predefinito) { '(S/n)' } else { '(s/N)' }
+    $r = Read-Host "  $domanda $suggerimento"
+    if (-not $r) { return $predefinito }
+    return $r.Trim().ToLower().StartsWith('s')
+}
+
+function ChiediSegreto($domanda) {
+    $sicura = Read-Host "  $domanda" -AsSecureString
+    $bstr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($sicura)
+    try { return [Runtime.InteropServices.Marshal]::PtrToStringBSTR($bstr) }
+    finally { [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($bstr) }
+}
+
+function PortaAperta($h, $p) {
+    $c = New-Object Net.Sockets.TcpClient
+    try { return $c.BeginConnect($h, $p, $null, $null).AsyncWaitHandle.WaitOne(5000) -and $c.Connected }
+    catch { return $false }
+    finally { $c.Close() }
+}
+
+# Un eseguibile, con lo stderr insieme allo stdout e senza che PowerShell 5 lo prenda per un errore.
+function Esegui($comando, [string[]]$argomenti) {
+    $prima = $ErrorActionPreference
+    $ErrorActionPreference = 'Continue'
+    try {
+        $testo = (& $comando @argomenti 2>&1 | ForEach-Object { "$_" }) -join "`n"
+        return [pscustomobject]@{ Codice = $LASTEXITCODE; Testo = $testo }
+    } finally { $ErrorActionPreference = $prima }
+}
+
+# Come Esegui, ma le righe si vedono mentre arrivano (la verifica e il giro durano minuti).
+function EseguiDalVivo($comando, [string[]]$argomenti) {
+    $prima = $ErrorActionPreference
+    $ErrorActionPreference = 'Continue'
+    try {
+        $righe = New-Object System.Collections.ArrayList
+        & $comando @argomenti 2>&1 | ForEach-Object { $r = "$_"; [void]$righe.Add($r); Write-Host "    $r" }
+        return [pscustomobject]@{ Codice = $LASTEXITCODE; Testo = ($righe -join "`n") }
+    } finally { $ErrorActionPreference = $prima }
+}
+
+function Fine {
+    $no = @($esiti | Where-Object { $_.Stato -eq 'NO' }).Count
+    $avvisi = @($esiti | Where-Object { $_.Stato -eq 'avviso' }).Count
+    $esitoGenerale = if ($no) { "NON COMPLETATA: $no passi da sistemare" } elseif ($avvisi) { "COMPLETATA con $avvisi avvisi" } else { 'COMPLETATA' }
+    $quando = Get-Date
+    $righe = @(
+        "$nome $versione · $modo · $esitoGenerale",
+        "PC $env:COMPUTERNAME · utente Windows $env:USERDOMAIN\$env:USERNAME · $($quando.ToString('dd/MM/yyyy HH:mm'))",
+        ''
+    ) + ($esiti | ForEach-Object { '{0,-7} {1,-22} {2}' -f $_.Stato, $_.Passo, $_.Nota })
+    Write-Host ''
+    Write-Host '==================== RIEPILOGO ====================' -ForegroundColor Cyan
+    $colore = if ($no) { 'Red' } elseif ($avvisi) { 'Yellow' } else { 'Green' }
+    Write-Host $righe[0] -ForegroundColor $colore
+    $righe | Select-Object -Skip 1 | ForEach-Object { Write-Host $_ }
+    $cartellaEsito = if (Test-Path $destinazione) { $destinazione } else { $qui }
+    $file = Join-Path $cartellaEsito ("esito-installa-{0}.txt" -f $quando.ToString('yyyyMMdd-HHmm'))
+    try {
+        $righe | Set-Content -Path $file -Encoding UTF8
+        Write-Host ''
+        Write-Host "Esito salvato in $file (senza password): da mandare a chi segue l'installazione."
+    } catch { Write-Host "Non riesco a salvare l'esito in $file" -ForegroundColor Yellow }
+    if ($no) { exit 1 } else { exit 0 }
+}
+
+function Ferma($passo, $nota) {
+    Esito $passo 'NO' $nota
+    Write-Host '  Mi fermo qui: sistemato questo, rilancia lo script.' -ForegroundColor Red
+    Fine
+}
+
+Write-Host "NOEVA Analytics per $cliente · $nome $versione" -ForegroundColor Cyan
+Write-Host "PC $env:COMPUTERNAME · utente Windows $env:USERDOMAIN\$env:USERNAME"
+if ($SoloControllo) { $modo = 'solo controllo'; Write-Host 'Solo controllo: non cambio niente.' }
+
+# 1. La rete --------------------------------------------------------------------
+Passo "1. Il PC vede il database ($dbHost, porta $dbPorta)"
+if (PortaAperta $dbHost $dbPorta) { Esito 'rete' 'ok' "$dbHost`:$dbPorta raggiungibile" }
+else { Ferma 'rete' "$dbHost`:$dbPorta non risponde: e' un problema di rete o di VPN, per l'IT" }
+
+# 2. Claude Code ------------------------------------------------------------------
+Passo '2. Claude Code'
+$cartellaClaude = Join-Path $env:USERPROFILE '.local\bin'
+$claude = Get-Command claude -ErrorAction SilentlyContinue
+if (-not $claude -and -not (Test-Path (Join-Path $cartellaClaude 'claude.exe'))) {
+    if ($SoloControllo) { Esito 'Claude Code' 'NO' 'non installato' }
+    elseif (Chiedi 'Claude Code non e'' installato. Lo installo adesso?') {
+        $prima = $ErrorActionPreference
+        $ErrorActionPreference = 'Continue'
+        try { Invoke-RestMethod https://claude.ai/install.ps1 | Invoke-Expression } catch { Write-Host "  $($_.Exception.Message)" }
+        $ErrorActionPreference = $prima
+    }
+}
+if (Test-Path (Join-Path $cartellaClaude 'claude.exe')) {
+    # L'installer non aggiunge la cartella al PATH dell'utente (successo il 20/10 su tutti i PC).
+    $pathUtente = [Environment]::GetEnvironmentVariable('Path', 'User')
+    if (-not (($pathUtente -split ';') -contains $cartellaClaude)) {
+        if ($SoloControllo) { Esito 'PATH' 'avviso' "$cartellaClaude non e' nel PATH dell'utente" }
+        else {
+            [Environment]::SetEnvironmentVariable('Path', ($pathUtente.TrimEnd(';') + ";$cartellaClaude"), 'User')
+            Esito 'PATH' 'ok' "aggiunto $cartellaClaude al PATH dell'utente"
+        }
+    }
+    if (-not (($env:Path -split ';') -contains $cartellaClaude)) { $env:Path += ";$cartellaClaude" }
+}
+$claude = Get-Command claude -ErrorAction SilentlyContinue
+if ($claude) {
+    $v = Esegui $claude.Source @('--version')
+    Esito 'Claude Code' 'ok' ($v.Testo.Trim() -split "`n")[0]
+} elseif (-not $SoloControllo) {
+    Ferma 'Claude Code' 'non installato: https://claude.ai/install.ps1, poi rilancia'
+}
+
+# 3. Il driver ODBC -----------------------------------------------------------------
+Passo '3. Il driver ODBC per SQL Server'
+$driver = @(Get-OdbcDriver -Platform 64-bit -ErrorAction SilentlyContinue | Where-Object { $_.Name -match '^ODBC Driver (18|17) for SQL Server$' } | ForEach-Object { $_.Name })
+if ($driver -contains 'ODBC Driver 18 for SQL Server') { Esito 'driver' 'ok' 'ODBC Driver 18 for SQL Server' }
+elseif ($driver -contains 'ODBC Driver 17 for SQL Server') {
+    if (-not $SoloControllo) { [Environment]::SetEnvironmentVariable('NOEVA_MSSQL_DRIVER', 'ODBC Driver 17 for SQL Server', 'User') }
+    $env:NOEVA_MSSQL_DRIVER = 'ODBC Driver 17 for SQL Server'
+    Esito 'driver' 'avviso' 'c''e'' il 17, non il 18: va bene, impostato NOEVA_MSSQL_DRIVER'
+} else {
+    Ferma 'driver' 'manca: ODBC Driver 18 for SQL Server x64 da https://aka.ms/downloadmsodbcsql (serve un amministratore)'
+}
+$driverUtente = [Environment]::GetEnvironmentVariable('NOEVA_MSSQL_DRIVER', 'User')
+if ($driverUtente) { $env:NOEVA_MSSQL_DRIVER = $driverUtente }
+
+# 4. La cartella --------------------------------------------------------------------
+Passo "4. La cartella $destinazione"
+if ($SoloControllo) {
+    if (Test-Path $exe) { Esito 'cartella' 'ok' "$destinazione, con noeva\$nome.exe" } else { Ferma 'cartella' "$exe non c'e'" }
+} elseif ($qui.TrimEnd('\') -ieq $destinazione) {
+    $modo = 'sul posto'
+    Esito 'cartella' 'ok' "lo script gira gia' da $destinazione"
+} else {
+    if (Test-Path $destinazione) {
+        $modo = 'aggiornamento'
+        $aperti = @(Get-Process -Name $nome, 'claude', 'Claude' -ErrorAction SilentlyContinue)
+        if ($aperti.Count) {
+            Write-Host "  Sono aperti: $((($aperti | ForEach-Object { $_.ProcessName }) | Sort-Object -Unique) -join ', '). Tengono bloccata la cartella."
+            if (Chiedi 'Li chiudo? (salva prima eventuali conversazioni aperte)') {
+                $aperti | Stop-Process -Force -ErrorAction SilentlyContinue
+                Start-Sleep -Seconds 2
+            } else { Ferma 'cartella' 'chiudi Claude Code e Claude Desktop (anche dall''icona vicino all''orologio), poi rilancia' }
+        }
+        $vecchia = "$destinazione-prima-$((Get-Date).ToString('yyyyMMdd-HHmm'))"
+        try { Rename-Item $destinazione (Split-Path -Leaf $vecchia) }
+        catch { Ferma 'cartella' "non riesco a rinominare $destinazione (ancora in uso?): $($_.Exception.Message)" }
+        Copy-Item $qui $destinazione -Recurse
+        # I file dell'utente (report, appunti) tornano nella cartella nuova; quelli della versione no.
+        $dellaVersione = @(Get-ChildItem -Force $qui | ForEach-Object { $_.Name })
+        $riportati = @()
+        foreach ($f in Get-ChildItem -Force $vecchia) {
+            if ($dellaVersione -contains $f.Name -or $f.Name -like 'esito-installa-*') { continue }
+            Copy-Item $f.FullName (Join-Path $destinazione $f.Name) -Recurse -Force
+            $riportati += $f.Name
+        }
+        $nota = "vecchia messa da parte in $vecchia"
+        if ($riportati.Count) { $nota += "; riportati: $($riportati -join ', ')" }
+        Esito 'cartella' 'ok' $nota
+    } else {
+        New-Item -ItemType Directory -Force (Split-Path $destinazione) | Out-Null
+        Copy-Item $qui $destinazione -Recurse
+        Esito 'cartella' 'ok' "copiata in $destinazione"
+    }
+    Get-ChildItem $destinazione -Recurse | Unblock-File
+    if (-not (Test-Path $exe)) { Ferma 'cartella' "$exe non c'e' dopo la copia" }
+}
+
+# 5. La password ----------------------------------------------------------------------
+Passo "5. La password di $utenteDb"
+$password = [Environment]::GetEnvironmentVariable($varPassword, 'User')
+if ($password -and ($SoloControllo -or (Chiedi "La password e' gia' salvata per $env:USERNAME. La tengo?"))) {
+    Esito 'password' 'ok' "gia' salvata in $varPassword"
+} elseif ($SoloControllo) {
+    Esito 'password' 'NO' "manca: rilancia senza -SoloControllo"
+} else {
+    $password = ''
+    for ($i = 0; $i -lt 3 -and -not $password; $i++) { $password = ChiediSegreto "Password di $utenteDb (non si vede mentre scrivi)" }
+    if (-not $password) { Ferma 'password' 'nessuna password inserita' }
+    [Environment]::SetEnvironmentVariable($varPassword, $password, 'User')
+    Esito 'password' 'ok' "salvata in $varPassword dell'utente $env:USERNAME"
+}
+if ($password) { Set-Item "env:$varPassword" $password }
+$password = $null
+
+# 6. La chiave API NOEVA -----------------------------------------------------------------
+# Senza chiave il servizio funziona lo stesso, col modello della cartella: chi la
+# salta lo vede nel riepilogo, non si ferma l'installazione.
+if ($varChiave) {
+    Passo "6. La chiave API NOEVA di $env:USERNAME (il modello aggiornato)"
+    $chiave = [Environment]::GetEnvironmentVariable($varChiave, 'User')
+    if ($chiave -and ($SoloControllo -or (Chiedi "La chiave e' gia' salvata per $env:USERNAME. La tengo?"))) {
+        Esito 'chiave NOEVA' 'ok' "gia' salvata in $varChiave"
+    } elseif ($SoloControllo) {
+        Esito 'chiave NOEVA' 'NO' "manca: il modello resta quello della cartella; rilancia senza -SoloControllo"
+    } else {
+        $chiave = ''
+        for ($i = 0; $i -lt 3 -and -not $chiave; $i++) {
+            $chiave = ChiediSegreto "La tua chiave API NOEVA, dal pannello NOEVA (noeva_sk_..., non si vede mentre scrivi; vuota per saltare)"
+            if (-not $chiave) { break }
+            if (-not $chiave.StartsWith('noeva_sk_')) { Write-Host '  Non sembra una chiave NOEVA (comincia con noeva_sk_).' -ForegroundColor Yellow; $chiave = '' }
+        }
+        if ($chiave) {
+            [Environment]::SetEnvironmentVariable($varChiave, $chiave, 'User')
+            Esito 'chiave NOEVA' 'ok' "salvata in $varChiave dell'utente $env:USERNAME"
+        } else {
+            Esito 'chiave NOEVA' 'NO' "saltata: il modello resta quello della cartella, senza aggiornamenti"
+        }
+    }
+    if ($chiave) { Set-Item "env:$varChiave" $chiave }
+    $chiave = $null
+}
+
+# 7. La verifica -----------------------------------------------------------------------
+Passo '7. La verifica: connessione e numeri noti, dal vivo'
+$v = EseguiDalVivo $exe @('--verifica')
+if ($v.Codice -eq 0) { Esito 'verifica' 'ok' 'tutti i controlli tornano' }
+else {
+    $primoNo = ($v.Testo -split "`n" | Where-Object { $_ -match '^\s*NO\s' } | Select-Object -First 1)
+    Esito 'verifica' 'NO' ("{0}" -f ($(if ($primoNo) { $primoNo.Trim() } else { "uscita $($v.Codice)" })))
+}
+
+# 8. Claude e la domanda di prova --------------------------------------------------------
+if ($SoloControllo) {
+    Esito 'Claude' 'saltato' 'la prova in Claude si fa a mano'
+} else {
+    Passo '8. Claude e la domanda di prova'
+    Write-Host '  Apri una finestra di PowerShell NUOVA (questa non vede le variabili appena salvate) e lancia:'
+    Write-Host "      cd $destinazione" -ForegroundColor White
+    Write-Host '      claude' -ForegroundColor White
+    Write-Host '  Al primo avvio la persona fa il login con il suo account. Alla domanda sulla fiducia nella cartella: si''.'
+    Write-Host "  Poi /mcp: $nome deve essere connesso. Domanda di prova:"
+    Write-Host "      $domanda" -ForegroundColor White
+    if (Chiedi "In /mcp $nome e' connesso?") { Esito 'Claude /mcp' 'ok' "$nome connesso" }
+    else { Esito 'Claude /mcp' 'NO' "$nome non connesso: hai fatto cd nella cartella prima di claude?" }
+    if (Chiedi 'La domanda di prova ha risposto con numeri sensati?') { Esito 'domanda di prova' 'ok' 'risponde' }
+    else { Esito 'domanda di prova' 'NO' 'da guardare con chi segue l''installazione' }
+}
+
+Fine