@noeva/analytics-core 0.1.0 → 0.3.2

package/modello/repository/github/workflows/rilascio-windows.yml

@@ -0,0 +1,207 @@
+# I due eseguibili Windows del progetto, costruiti e provati su un runner Windows
+# (PyInstaller non fa cross-compilazione), con le ricette del pacchetto
+# @noeva/analytics-core (ADR 0005 di NOEVA Analytics):
+#
+#   mcp        la cartella per Claude Code sui PC: noeva-<id>.exe, il servizio MCP,
+#              con la configurazione di consegna.yml. Il modello lo scarica da se'
+#              dall'ultima versione pubblicata (ci.yml, job pubblica); quello nella
+#              cartella e' l'ultimo ripiego.
+#   snapshot   l'eseguibile del worker degli snapshot (noeva-snapshot.exe) e il
+#              pacchetto del progetto, per il server del cliente (ADR 0004).
+#
+# Solo manuale. Nessuna credenziale: le cartelle non ne contengono, e il database
+# del cliente da qui non si raggiunge. Si prova fin dove si arriva senza: il driver
+# ODBC 18, il login che fallisce sulla rete, installa.ps1 con PowerShell 5.1.
+#
+# Le cartelle escono come artefatto (7 giorni). Con `rilascia` diventano una
+# versione permanente di questo repository: noeva-<id>-v<versione> e
+# noeva-snapshot-<id>-v<versione>. Una versione non si riscrive.
+# File gestito: lo riscrive `analytics upgrade`, non si modifica a mano.
+
+name: rilascio-windows
+
+on:
+  workflow_dispatch:
+    inputs:
+      cosa:
+        description: "mcp = la cartella per Claude Code sui PC; snapshot = l'eseguibile del worker (ADR 0004)"
+        type: choice
+        options: [mcp, snapshot]
+        default: mcp
+      versione:
+        description: "La versione (es. 2026.11.6); vuota = la data di oggi"
+        required: false
+        default: ""
+      rilascia:
+        description: "Pubblica la versione come release permanente di questo repository"
+        type: boolean
+        default: false
+
+permissions:
+  contents: write
+
+jobs:
+  windows:
+    runs-on: windows-latest
+    timeout-minutes: 40
+    env:
+      # Il builder e il server stampano accenti e "·": la console del runner no.
+      PYTHONUTF8: "1"
+      PYTHONIOENCODING: utf-8
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+      - run: npm ci
+      - uses: astral-sh/setup-uv@v6
+
+      - name: Il progetto e le ricette del pacchetto
+        id: dove
+        shell: pwsh
+        run: |
+          $id = (Get-Content analytics.json -Raw | ConvertFrom-Json).progetto
+          $lib = (npx analytics percorso) + "\lib"
+          $versione = "${{ inputs.versione }}"
+          if (-not $versione) { $d = Get-Date; $versione = "$($d.Year).$($d.Month).$($d.Day)" }
+          "id=$id" >> $env:GITHUB_OUTPUT
+          "lib=$lib" >> $env:GITHUB_OUTPUT
+          "versione=$versione" >> $env:GITHUB_OUTPUT
+          "progetto $id, versione $versione, ricette da $lib (@noeva/analytics-core $(npx analytics versione))"
+
+      - name: Il driver ODBC 18, come sui PC e sul server del cliente
+        shell: pwsh
+        run: |
+          choco install sqlserver-odbcdriver -y --no-progress | Out-Null
+          Get-OdbcDriver -Platform 64-bit | Select-Object Name
+
+      # --- mcp ------------------------------------------------------------------
+      - name: La cartella e l'eseguibile del servizio MCP
+        if: ${{ inputs.cosa == 'mcp' }}
+        shell: pwsh
+        run: uv run --with pyyaml python "${{ steps.dove.outputs.lib }}\mcp-locale\costruisci.py" . --versione "${{ steps.dove.outputs.versione }}"
+
+      # Il ramo vivo con il driver 18 e una password finta: deve dire "ok driver" e
+      # poi fallire sulla rete. Un errore di import o di driver vuol dire una ricetta
+      # PyInstaller da correggere.
+      - name: Il ramo vivo dell'eseguibile (pyodbc e driver 18, senza rete)
+        if: ${{ inputs.cosa == 'mcp' }}
+        shell: pwsh
+        run: |
+          $id = "${{ steps.dove.outputs.id }}"
+          $exe = "dist\mcp-locale\noeva-$id\noeva\noeva-$id.exe"
+          $conf = Get-Content "dist\mcp-locale\noeva-$id\noeva\noeva.json" -Raw | ConvertFrom-Json
+          $vive = $conf.sorgenti.PSObject.Properties | Where-Object { $_.Value.tipo -eq 'mssql' }
+          if (-not $vive) { "nessuna sorgente viva: niente da provare"; exit 0 }
+          foreach ($v in $vive) {
+            if ($v.Value.password_env) { [Environment]::SetEnvironmentVariable($v.Value.password_env, 'non-e-la-password', 'Process') }
+            $out = "$env:RUNNER_TEMP\verifica-$($v.Name).txt"
+            $p = Start-Process $exe -ArgumentList '--verifica', '--sorgente', $v.Name -NoNewWindow -PassThru -RedirectStandardOutput $out
+            $tempo = [Diagnostics.Stopwatch]::StartNew()
+            if (-not $p.WaitForExit(180000)) { $p.Kill(); "  (fermato dopo 180 s)" }
+            $testo = Get-Content $out -Raw
+            $testo
+            "  durata: $([int]$tempo.Elapsed.TotalSeconds) s"
+            if ($testo -match 'pyodbc non utilizzabile|non e'' installato') { throw "il ramo vivo non arriva al login: ricetta da correggere" }
+            if ($testo -notmatch 'ok  driver') { throw "nessun 'ok driver' per $($v.Name)" }
+          }
+          exit 0
+
+      - name: installa.ps1 parte e chiude con il riepilogo
+        if: ${{ inputs.cosa == 'mcp' }}
+        shell: pwsh
+        run: |
+          $dir = "dist\mcp-locale\noeva-${{ steps.dove.outputs.id }}"
+          $out = (powershell -NoProfile -ExecutionPolicy Bypass -File "$dir\installa.ps1" -SoloControllo 2>&1 | Out-String)
+          $out
+          if ($out -notmatch 'RIEPILOGO' -or $out -notmatch 'NON COMPLETATA') { throw "installa.ps1 non arriva al riepilogo" }
+          $esito = Get-ChildItem $dir -Filter 'esito-installa-*.txt'
+          if (-not $esito) { throw "installa.ps1 non scrive il file dell'esito" }
+          Remove-Item $esito.FullName
+          "ok: installa.ps1 gira con PowerShell 5.1 e chiude con l'esito"
+          exit 0
+
+      # --- snapshot -------------------------------------------------------------
+      - name: L'eseguibile degli snapshot e il pacchetto del progetto
+        if: ${{ inputs.cosa == 'snapshot' }}
+        shell: pwsh
+        run: |
+          uv run --with pyyaml python "${{ steps.dove.outputs.lib }}\snapshot\impacchetta.py" eseguibile .
+          uv run --with pyyaml python "${{ steps.dove.outputs.lib }}\snapshot\impacchetta.py" pacchetto .
+
+      - name: Prova dell'eseguibile fino al login
+        if: ${{ inputs.cosa == 'snapshot' }}
+        shell: pwsh
+        run: |
+          $id = "${{ steps.dove.outputs.id }}"
+          $exe = "dist\snapshot\noeva-snapshot\noeva-snapshot.exe"
+          $pac = "dist\snapshot\pacchetti\$id"
+          & $exe versione
+          if ($LASTEXITCODE -ne 0) { throw "versione: uscita $LASTEXITCODE" }
+          $conf = Get-Content "$pac\connessione.json" -Raw | ConvertFrom-Json
+          if ($conf.password_env) { [Environment]::SetEnvironmentVariable($conf.password_env, 'non-e-la-password', 'Process') }
+          $out = "$env:RUNNER_TEMP\verifica.txt"
+          $p = Start-Process $exe -ArgumentList 'verifica', '--pacchetto', $pac, '--connessione', "$pac\connessione.json" -NoNewWindow -PassThru -RedirectStandardOutput $out -RedirectStandardError "$out.err"
+          if (-not $p.WaitForExit(240000)) { $p.Kill(); "  (fermato dopo 240 s)" }
+          $testo = (Get-Content $out -Raw -Encoding utf8) + (Get-Content "$out.err" -Raw -Encoding utf8)
+          $testo
+          if ($testo -match 'ModuleNotFoundError|ImportError|No module named|non e'' installato|Data source name not found|manca la password') { throw "l'eseguibile non arriva al login: ricetta da correggere" }
+          if ($testo -notmatch 'TCP Provider|Login timeout|timeout|08001|HYT00|network') { throw "atteso un errore di rete al login, non trovato" }
+          "ok: l'eseguibile arriva al login, si ferma sulla rete come deve"
+          # ascolta (ADR 0004): con un'API che non risponde deve dirlo e uscire con 1.
+          $w = Get-Content dist\snapshot\worker.json -Raw | ConvertFrom-Json
+          $w.api = 'http://127.0.0.1:9'
+          $w | ConvertTo-Json -Depth 5 | Set-Content "$env:RUNNER_TEMP\worker.json" -Encoding utf8
+          Copy-Item dist\snapshot\pacchetti "$env:RUNNER_TEMP\pacchetti" -Recurse -Force
+          $env:NOEVA_API_KEY = 'noeva_sk_finta'
+          $testo = (& $exe ascolta --config "$env:RUNNER_TEMP\worker.json" --una-volta 2>&1 | Out-String)
+          $testo
+          if ($testo -notmatch "in ascolto per analytics-snapshot-$id" -or $testo -notmatch 'non riesco a chiedere lavoro') { throw "ascolta non parte come deve" }
+          $out = (powershell -NoProfile -ExecutionPolicy Bypass -File dist\snapshot\installa.ps1 -SoloControllo 2>&1 | Out-String)
+          $out
+          if ($out -notmatch 'RIEPILOGO' -or $out -notmatch 'NON COMPLETATA') { throw "installa.ps1 non arriva al riepilogo" }
+          Get-ChildItem dist\snapshot -Filter 'esito-installa-*.txt' | Remove-Item
+          exit 0
+
+      - name: Lo zip degli snapshot
+        if: ${{ inputs.cosa == 'snapshot' }}
+        shell: pwsh
+        run: Compress-Archive -Path dist\snapshot\noeva-snapshot, dist\snapshot\pacchetti, dist\snapshot\worker.json, dist\snapshot\*.ps1 -DestinationPath dist\snapshot\noeva-snapshot-windows.zip
+
+      # --- artefatto e versione permanente --------------------------------------
+      - uses: actions/upload-artifact@v4
+        with:
+          name: ${{ inputs.cosa }}-${{ steps.dove.outputs.versione }}
+          path: |
+            dist/mcp-locale/*.zip
+            dist/snapshot/noeva-snapshot-windows.zip
+          retention-days: 7
+
+      - name: La versione permanente (release)
+        if: ${{ inputs.rilascia }}
+        shell: pwsh
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          $id = "${{ steps.dove.outputs.id }}"
+          $versione = "${{ steps.dove.outputs.versione }}"
+          if ("${{ inputs.cosa }}" -eq "mcp") {
+            $tag = "noeva-$id-v$versione"; $titolo = "noeva-$id $versione"
+            $zip = "dist\mcp-locale\noeva-$id-$versione.zip"; Copy-Item "dist\mcp-locale\noeva-$id.zip" $zip
+            $guida = "docs\installazione-$id-windows.md"
+            $note = "Cartella per Claude Code su Windows: noeva-$id.exe, dal commit $env:GITHUB_SHA. Il modello arriva da solo dall'ultima versione pubblicata. Installazione: $guida (allegata); poi ``noeva\noeva-$id.exe --verifica``."
+            $latest = "--latest"
+          } else {
+            $tag = "noeva-snapshot-$id-v$versione"; $titolo = "noeva-snapshot $id $versione"
+            $zip = "dist\snapshot\noeva-snapshot-$id-windows-$versione.zip"; Copy-Item dist\snapshot\noeva-snapshot-windows.zip $zip
+            $guida = "docs\installazione-snapshot-$id-windows.md"
+            $note = "noeva-snapshot.exe per Windows e il pacchetto di $id (snapshot.yml, mdl.json, connessione.json senza password), dal commit $env:GITHUB_SHA. ADR 0004. Installazione: $guida (allegata)."
+            # la release in evidenza resta quella della cartella MCP che il cliente usa
+            $latest = "--latest=false"
+          }
+          gh release view $tag 2>$null
+          if ($LASTEXITCODE -eq 0) { throw "la versione $tag esiste gia': una versione non si riscrive, scegline un'altra" }
+          $file = @($zip)
+          if (Test-Path $guida) { $file += $guida }
+          gh release create $tag @file --target $env:GITHUB_SHA --title $titolo --notes $note $latest
+          "pubblicata $tag"

package/modello/repository/gitignore

@@ -3,9 +3,10 @@
 .env.local
 .dev.vars
 
-# Il pacchetto e il catalogo compilato si rigenerano.
+# Il pacchetto, il catalogo compilato e le cartelle Windows (rilascio-windows.yml) si rigenerano.
 node_modules/
 target/
+dist/
 
 # Il motore wren-core-wasm (68 MB): in produzione arriva dal contenitore sotto /vendor/.
 apps/vendor/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noeva/analytics-core",
-  "version": "0.1.0",
+  "version": "0.3.2",
   "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": {
@@ -9,6 +9,7 @@
   "files": [
     "cli.js",
     "core.js",
+    "pubblica.js",
     "kit/",
     "modello/",
     "contenuto/",

package/pubblica.js

@@ -0,0 +1,211 @@
+// `analytics pubblica`: la apps/ del progetto sul contenitore, in R2 (ADR 0005, punto 3).
+//
+// Si pubblica il commit, non il disco: i file di apps/ tracciati in HEAD, meno
+// quelli che apps/.assetsignore esclude (lo snapshot, che ha la sua strada, il
+// motore, i file di lavoro). Cosi' quello che va online e' quello che `analytics
+// ci` ha verificato, in CI come sul Mac, e un file lasciato fuori da git non
+// parte per sbaglio.
+//
+// Il contenitore accetta una versione solo con un biglietto di tipo `pagine` per
+// quel progetto e quella versione, con il workspace che possiede il progetto:
+// firmato da chi ha il segreto del contenitore, o rilasciato dall'API NOEVA alla
+// chiave di un membro del workspace (chiediBiglietto, sotto).
+//
+// Il controllo dei percorsi e' lo stesso di lib/analytics/pagine-r2.js, che
+// rifiuterebbe comunque: qui si ferma prima di caricare mezza versione. Una
+// prova del monorepo li confronta.
+
+import { execFileSync } from 'node:child_process';
+import { createHmac } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { ErroreConfig } from './core.js';
+
+const SEGMENTO = /^[A-Za-z0-9_@][A-Za-z0-9_.@-]{0,99}$/;
+const PROFONDITA = 8;
+const ESTENSIONI = new Set([
+  'html', 'js', 'mjs', 'css', 'json', 'md', 'txt', 'csv', 'svg', 'png', 'jpg', 'jpeg', 'webp', 'gif', 'ico',
+  'pdf', 'woff', 'woff2', 'parquet', 'wasm',
+]);
+const IN_PARALLELO = 6;
+const DURATA_BIGLIETTO_MS = 15 * 60 * 1000;
+const API_NOEVA = 'https://api.noeva.ai';
+
+/** Un percorso di file della apps/ che il contenitore accetta (pagine-r2.js). */
+export function percorsoAmmesso(file) {
+  if (typeof file !== 'string' || !file) return false;
+  const segmenti = file.split('/');
+  if (segmenti.length > PROFONDITA || !segmenti.every((s) => SEGMENTO.test(s))) return false;
+  const nome = segmenti.at(-1);
+  return ESTENSIONI.has(nome.slice(nome.lastIndexOf('.') + 1).toLowerCase());
+}
+
+// Le regole di un .gitignore semplice, come le legge assembla.py: `vendor/**`,
+// `dati/*.parquet`, `dati/chat/**`. Un `*` non attraversa le cartelle.
+export function regoleIgnorate(testo) {
+  return testo.split('\n').map((r) => r.trim()).filter((r) => r && !r.startsWith('#'));
+}
+
+const comeRegex = (glob) => new RegExp(`^${glob.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*\*/g, '\0').replace(/\*/g, '[^/]*').replace(/\?/g, '[^/]').replace(/\0/g, '.*')}$`);
+
+export function ignorato(rel, regole) {
+  return regole.some((r) => (r.endsWith('/**') ? rel.startsWith(r.slice(0, -2)) : comeRegex(r).test(rel)));
+}
+
+const git = (radice, args, opzioni = {}) => execFileSync('git', args, { cwd: radice, maxBuffer: 256 * 1024 * 1024, ...opzioni });
+
+/**
+ * I file da pubblicare: {file, byte, oggetto} per ogni file di apps/ in HEAD che
+ * .assetsignore (di HEAD) non esclude. `scartati` sono quelli con un percorso o
+ * un tipo che il contenitore rifiuterebbe.
+ */
+export function filePubblicabili(radice) {
+  let righe;
+  try {
+    righe = git(radice, ['ls-tree', '-r', '-l', '-z', 'HEAD', '--', 'apps/'], { encoding: 'utf8' }).split('\0').filter(Boolean);
+  } catch {
+    throw new ErroreConfig('git ls-tree HEAD non risponde: serve un repository git con almeno un commit');
+  }
+  let regole = [];
+  try {
+    regole = regoleIgnorate(git(radice, ['show', 'HEAD:apps/.assetsignore'], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }));
+  } catch { /* nessun .assetsignore: si pubblica tutto, e analytics ci lo segnala */ }
+
+  const file = [];
+  const scartati = [];
+  for (const riga of righe) {
+    // <modo> <tipo> <oggetto> <byte>\t<percorso>
+    const [testa, percorso] = riga.split('\t');
+    const [, tipo, oggetto, byte] = testa.trim().split(/\s+/);
+    if (tipo !== 'blob') continue;
+    const rel = percorso.slice('apps/'.length);
+    const nome = rel.split('/').at(-1);
+    if (nome === '.assetsignore' || nome === '.DS_Store' || nome === '.gitkeep' || ignorato(rel, regole)) continue;
+    if (!percorsoAmmesso(rel)) { scartati.push(rel); continue; }
+    file.push({ file: rel, byte: Number(byte), oggetto });
+  }
+  return { file, scartati };
+}
+
+/** La versione: data e ora UTC del commit e il suo sha corto, unica e leggibile. */
+export function versioneDi(radice) {
+  const [sha, quando] = git(radice, ['log', '-1', '--format=%h%x09%cI'], { encoding: 'utf8' }).trim().split('\t');
+  const t = new Date(quando).toISOString().replace(/[-:]/g, '').replace('T', '-').slice(0, 15);
+  return `${t}-${sha}`;
+}
+
+/** Lo stesso formato di lib/cancello/sessione.js: base64url(JSON).base64url(HMAC-SHA256). */
+export function firmaBiglietto(payload, segreto) {
+  const corpo = Buffer.from(JSON.stringify(payload)).toString('base64url');
+  const mac = createHmac('sha256', segreto).update(corpo).digest('base64url');
+  return `${corpo}.${mac}`;
+}
+
+// Il valore della variabile o, se manca, quello del file nella home (permessi
+// 600, mai nel repository): come dal_file di lib/snapshot/pubblica.py.
+function dalFile(env, variabile, nome, casa) {
+  if (env[variabile]) return env[variabile].trim();
+  const f = join(casa, nome);
+  return existsSync(f) ? readFileSync(f, 'utf8').trim() || null : null;
+}
+
+/**
+ * Il biglietto per scrivere `tipo` (pagine) di questo progetto e versione. Due
+ * strade, come per i dati (lib/snapshot/pubblica.py): firmato qui col segreto del
+ * contenitore, sul Mac di chi lo amministra; o rilasciato dall'API NOEVA a chi ha
+ * la chiave di un membro del workspace, ed e' la strada della CI del repository.
+ */
+export async function chiediBiglietto({ progetto, versione, workspace, tipo, env, casa, fetchImpl }) {
+  const da = env.GITHUB_ACTIONS ? `ci ${env.GITHUB_REPOSITORY ?? ''}`.trim() : `analytics ${tipo}`;
+  const segreto = dalFile(env, 'SEGRETO_DATI', '.segreto-dati', casa);
+  if (segreto) {
+    return firmaBiglietto({ tipo, prog: progetto, ver: versione, ws: workspace, da, exp: Date.now() + DURATA_BIGLIETTO_MS }, segreto);
+  }
+  const chiave = dalFile(env, 'NOEVA_API_KEY', '.noeva-api-key', casa);
+  if (!chiave) {
+    throw new ErroreConfig('nessun biglietto: serve la chiave API NOEVA di un membro del workspace (NOEVA_API_KEY o ' +
+      '~/.noeva-api-key; in CI il secret del repository), o il segreto del contenitore (SEGRETO_DATI o ~/.segreto-dati)');
+  }
+  const api = (env.NOEVA_API || API_NOEVA).replace(/\/+$/, '');
+  const r = await fetchImpl(`${api}/api/analytics/biglietto-dati`, {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${chiave}`, 'x-noeva-workspace': workspace,
+      'Content-Type': 'application/json', 'User-Agent': 'noeva-analytics-core',
+    },
+    body: JSON.stringify({ progetto, versione, da, tipo }),
+  });
+  let corpo = {};
+  try { corpo = await r.json(); } catch { /* il messaggio d'errore sotto basta */ }
+  if (!r.ok || !corpo?.payload?.biglietto) {
+    throw new ErroreConfig(`l'API NOEVA non rilascia il biglietto (${r.status}): ${corpo?.message ?? corpo?.error ?? 'risposta inattesa'}`);
+  }
+  return corpo.payload.biglietto;
+}
+
+async function chiama(fetchImpl, metodo, url, biglietto, corpo, tipo) {
+  // Niente redirect: un contenitore senza la rotta manda al login con un 302, e
+  // seguirlo darebbe un 200 (la pagina di login) scambiato per una pubblicazione.
+  const r = await fetchImpl(url, {
+    method: metodo,
+    body: corpo,
+    redirect: 'manual',
+    headers: {
+      Authorization: `Bearer ${biglietto}`,
+      'User-Agent': 'noeva-analytics-core',
+      ...(corpo !== undefined ? { 'Content-Length': String(corpo.length), 'Content-Type': tipo } : {}),
+    },
+  });
+  const testo = await r.text();
+  let risposta;
+  try { risposta = JSON.parse(testo); } catch { risposta = { errore: testo.slice(0, 200) }; }
+  if (!r.ok || risposta.ok !== true) {
+    const dettaglio = risposta.mancanti ? ` (${risposta.mancanti.join(', ')})` : '';
+    const perche = r.status >= 300 && r.status < 400
+      ? `rimanda a ${r.headers.get('Location') ?? '?'}: il contenitore non ha questa rotta (va deployato?)`
+      : (risposta.errore ?? '');
+    throw new ErroreConfig(`${metodo} ${new URL(url).pathname}: ${r.status} ${perche}${dettaglio}`);
+  }
+  return risposta;
+}
+
+/**
+ * Pubblica la apps/ di HEAD: carica ogni file e sposta il puntatore. `prova`
+ * elenca e basta. Restituisce {versione, file, byte, scartati}.
+ */
+export async function pubblica(radice, config, {
+  url, workspace = config.workspace, env = process.env, fetchImpl = fetch, prova = false, stampa = () => {}, casa = homedir(),
+} = {}) {
+  const { file, scartati } = filePubblicabili(radice);
+  if (scartati.length) {
+    throw new ErroreConfig(`file che il contenitore non accetta (percorso o tipo): ${scartati.join(', ')}. ` +
+      'Si escludono in apps/.assetsignore o si rinominano.');
+  }
+  if (!file.some((f) => f.file === 'index.html')) throw new ErroreConfig('apps/index.html manca in HEAD');
+  const versione = versioneDi(radice);
+  const byte = file.reduce((s, f) => s + f.byte, 0);
+  const esito = { versione, file: file.length, byte, scartati };
+  if (prova) return esito;
+
+  if (!url) throw new ErroreConfig('serve --url: l\'indirizzo del contenitore (in prova http://localhost:8789)');
+  if (!workspace) throw new ErroreConfig('serve il workspace NOEVA che possiede il progetto: `workspace` in analytics.json, o --workspace');
+  const biglietto = await chiediBiglietto({
+    progetto: config.progetto, versione, workspace, tipo: 'pagine', env, casa, fetchImpl,
+  });
+
+  const base = `${url.replace(/\/+$/, '')}/_pagine/${config.progetto}/${versione}`;
+  stampa(`▸ ${config.progetto}: versione ${versione}, ${file.length} file, ${Math.round(byte / 1024)} kB -> ${url}`);
+  const coda = [...file];
+  const lavora = async () => {
+    for (let f = coda.shift(); f; f = coda.shift()) {
+      const corpo = git(radice, ['cat-file', 'blob', f.oggetto]);
+      const percorso = f.file.split('/').map(encodeURIComponent).join('/');
+      await chiama(fetchImpl, 'PUT', `${base}/${percorso}`, biglietto, corpo, 'application/octet-stream');
+    }
+  };
+  await Promise.all(Array.from({ length: IN_PARALLELO }, lavora));
+  const manifesto = Buffer.from(JSON.stringify({ file: file.map(({ file: f, byte: b }) => ({ file: f, byte: b })) }));
+  await chiama(fetchImpl, 'POST', `${base}/pubblica`, biglietto, manifesto, 'application/json');
+  return esito;
+}