@noeva/etl-core 1.0.0-next.5 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. package/CHANGELOG.md +192 -0
  2. package/LICENSE +19 -0
  3. package/README.md +1 -1
  4. package/deploy/Dockerfile +3 -2
  5. package/dist/guida/404.html +3 -3
  6. package/dist/guida/GUIDA_SVILUPPO.html +6 -6
  7. package/dist/guida/TECHNICAL_OVERVIEW.html +8 -8
  8. package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.iD1gDlJY.js → TECHNICAL_OVERVIEW.md.DTIhkkg9.js} +1 -1
  9. package/dist/guida/assets/{app.BrI3mcoI.js → app.DeVEBaIz.js} +1 -1
  10. package/dist/guida/assets/chunks/@localSearchIndexroot.NgfCNDyz.js +1 -0
  11. package/dist/guida/assets/chunks/{VPLocalSearchBox.BlKLVNlB.js → VPLocalSearchBox.CsTQzJUK.js} +2 -2
  12. package/dist/guida/assets/chunks/{theme.Cuah39Zj.js → theme.Dfy0C_Zf.js} +2 -2
  13. package/dist/guida/assets/{guide_claude-code_index.md.CxVSru8e.js → guide_claude-code_index.md.DEnzf9b_.js} +1 -1
  14. package/dist/guida/assets/{runbooks_aggiornamento-pm2.md.f3LAxif4.js → runbooks_aggiornamento-pm2.md.DrFr4blI.js} +1 -1
  15. package/dist/guida/assets/{runbooks_deployment.md.CsIYRa_5.js → runbooks_deployment.md.CwG77qGO.js} +1 -1
  16. package/dist/guida/assets/{style.BNn_AkzN.css → style.DFlUbYCk.css} +1 -1
  17. package/dist/guida/connectors/README.html +5 -5
  18. package/dist/guida/connectors/file.html +6 -6
  19. package/dist/guida/connectors/http.html +6 -6
  20. package/dist/guida/connectors/imap.html +6 -6
  21. package/dist/guida/connectors/jira.html +6 -6
  22. package/dist/guida/connectors/noeva.html +6 -6
  23. package/dist/guida/connectors/oauth.html +6 -6
  24. package/dist/guida/connectors/postgres.html +6 -6
  25. package/dist/guida/connectors/process.html +6 -6
  26. package/dist/guida/connectors/sendgrid.html +6 -6
  27. package/dist/guida/connectors/smtp.html +6 -6
  28. package/dist/guida/connectors/sqlserver.html +6 -6
  29. package/dist/guida/connectors/zoho.html +6 -6
  30. package/dist/guida/conventions/node-columns.html +6 -6
  31. package/dist/guida/conventions/node-descriptor.html +6 -6
  32. package/dist/guida/conventions/run-report.html +6 -6
  33. package/dist/guida/conventions/run-trace.html +6 -6
  34. package/dist/guida/conventions/variabili-del-core.html +5 -5
  35. package/dist/guida/conventions/versioni-di-pipeline.html +6 -6
  36. package/dist/guida/guide/claude-code/index.html +7 -7
  37. package/dist/guida/guide/claude-code/prompt.html +6 -6
  38. package/dist/guida/guide/claude-code/strumenti.html +5 -5
  39. package/dist/guida/guide/grafo.html +6 -6
  40. package/dist/guida/guide/usare/app-desktop.html +5 -5
  41. package/dist/guida/guide/usare/esito-di-una-run.html +6 -6
  42. package/dist/guida/guide/usare/index.html +5 -5
  43. package/dist/guida/hashmap.json +1 -1
  44. package/dist/guida/index.html +6 -6
  45. package/dist/guida/nodes/README.html +6 -6
  46. package/dist/guida/nodes/action.html +6 -6
  47. package/dist/guida/nodes/ai.html +6 -6
  48. package/dist/guida/nodes/join.html +6 -6
  49. package/dist/guida/nodes/lookup.html +6 -6
  50. package/dist/guida/nodes/pipeline.html +6 -6
  51. package/dist/guida/nodes/route.html +6 -6
  52. package/dist/guida/nodes/sink.html +6 -6
  53. package/dist/guida/nodes/source.html +6 -6
  54. package/dist/guida/nodes/task.html +6 -6
  55. package/dist/guida/nodes/transform.html +6 -6
  56. package/dist/guida/nodes/try-catch.html +6 -6
  57. package/dist/guida/nodes/union.html +6 -6
  58. package/dist/guida/pipelines/README.html +6 -6
  59. package/dist/guida/pipelines/crm-leads-sync.html +6 -6
  60. package/dist/guida/pipelines/cross-workspace-csv-merge.html +6 -6
  61. package/dist/guida/pipelines/movimenti-per-conto.html +6 -6
  62. package/dist/guida/pipelines/orders-enriched-daily.html +6 -6
  63. package/dist/guida/pipelines/test-posta.html +6 -6
  64. package/dist/guida/runbooks/aggiornamento-pm2.html +7 -7
  65. package/dist/guida/runbooks/deploy-ecr.html +6 -6
  66. package/dist/guida/runbooks/deployment.html +8 -8
  67. package/dist/guida/runbooks/etl-worker.html +6 -6
  68. package/dist/guida/runbooks/graph-server.html +6 -6
  69. package/dist/guida/runbooks/mask-key.html +6 -6
  70. package/dist/guida/runbooks/oauth-google-posta.html +6 -6
  71. package/dist/guida/runbooks/rollback-di-pipeline.html +6 -6
  72. package/dist/guida/runbooks/scd2-rehash.html +6 -6
  73. package/dist/guida/runbooks/sql-task-truncate-swap.html +6 -6
  74. package/dist/guida/runbooks/stato-incrementale.html +6 -6
  75. package/dist/guida/sub-pipelines/README.html +6 -6
  76. package/dist/guida/sub-pipelines/riepilogo-ordini.html +6 -6
  77. package/kit/boilerplate/.github/workflows/ci.yml +1 -1
  78. package/kit/boilerplate/.github/workflows/image.yml +1 -1
  79. package/kit/boilerplate/package.json +1 -1
  80. package/package.json +5 -4
  81. package/dist/guida/assets/chunks/@localSearchIndexroot.DjrQYH6x.js +0 -1
  82. /package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.iD1gDlJY.lean.js → TECHNICAL_OVERVIEW.md.DTIhkkg9.lean.js} +0 -0
  83. /package/dist/guida/assets/{guide_claude-code_index.md.CxVSru8e.lean.js → guide_claude-code_index.md.DEnzf9b_.lean.js} +0 -0
  84. /package/dist/guida/assets/{runbooks_aggiornamento-pm2.md.f3LAxif4.lean.js → runbooks_aggiornamento-pm2.md.DrFr4blI.lean.js} +0 -0
  85. /package/dist/guida/assets/{runbooks_deployment.md.CsIYRa_5.lean.js → runbooks_deployment.md.CwG77qGO.lean.js} +0 -0
package/CHANGELOG.md ADDED
@@ -0,0 +1,192 @@
1
+ # @noeva/etl-core
2
+
3
+ ## 1.0.1
4
+
5
+ ### Patch Changes
6
+
7
+ - 7cd8a0d: L'immagine dell'artefatto (`deploy/Dockerfile`) torna a costruirsi su `node:26-slim`. Da Node 25
8
+ corepack non è più distribuito con Node, e `RUN corepack enable` usciva con 127: ora si installa da
9
+ npm, a versione fissata (`npm install -g corepack@0.36.0`), prima di abilitarlo. Un repo cliente
10
+ che ha preso il Dockerfile in `unmanaged` fa la stessa modifica a mano.
11
+
12
+ ## 1.0.0
13
+
14
+ ### Major Changes
15
+
16
+ - 417e6dc: Il core chiede Node 26 o successivo (`engines`, ADR-0107). L'immagine dell'artefatto
17
+ (`deploy/Dockerfile`) parte da `node:26-slim`, e il boilerplate di `etl init` nasce con `engines`
18
+ `>=26` e Node 26 nei workflow `ci.yml` e `image.yml`. In un repo cliente già nato `etl upgrade`
19
+ porta i due workflow gestiti a Node 26, mentre `engines` del suo `package.json` si alza a mano. Un
20
+ server PM2 va aggiornato a Node 26 prima del bump del core.
21
+ - 032d9e1: Prima versione pubblicata come `@noeva/etl-core` (ADR-0093): il core è un pacchetto, e ogni
22
+ cliente scrive le sue pipeline in un repo cliente, con il catalogo in `etl.config.ts` e la CLI
23
+ `etl` del pacchetto. L'API pubblica è la radice più un subpath per area, con la mappa `exports`
24
+ come unico confine.
25
+
26
+ Il pacchetto è pubblico su npmjs.com, sull'org `noeva` (ADR-0105): si installa senza token e
27
+ senza righe di registry, quindi il `.npmrc` del repo cliente non dichiara un registry, `ci.yml` e
28
+ `image.yml` installano senza segreti e il Dockerfile non monta un BuildKit secret. Porta
29
+ `"license": "UNLICENSED"` e il file `LICENSE`, lo stesso dei pacchetti MCP di Noeva (ETL-191): tutti i
30
+ diritti riservati, uso consentito per interagire con i servizi Noeva secondo i termini
31
+ contrattuali con 4D S.R.L.
32
+
33
+ ### Minor Changes
34
+
35
+ - 688ff49: Le due confezioni del deploy arrivano col pacchetto. `./deploy/Dockerfile`, con il suo
36
+ `Dockerfile.dockerignore`, costruisce l'immagine di un repo cliente: `node:26-slim`,
37
+ `pnpm install --prod --frozen-lockfile` senza credenziali,
38
+ `ETL_RELEASE` come build arg, la documentazione del cliente costruita nell'immagine, `ENTRYPOINT etl`
39
+ e `CMD serve`. `./pm2` esporta `ecosystem(radice)`, che avvia solo `etl serve` con l'arresto via
40
+ messaggio IPC, `kill_timeout` e `node` diretto anche su Windows: la UI con Vite su :9011 non c'è
41
+ più. `etl init` scrive i file gestiti `image.yml` (build e push su
42
+ `ghcr.io/<owner>/noeva-etl-<slug>` con tag = SHA, a mano o su tag, mai `latest`) ed
43
+ `ecosystem.config.cjs` di una riga. La CLI carica da sola il `.env` alla radice dell'`etl.config.ts`
44
+ prima di ogni comando, e le variabili già nel processo vincono. Il preset `./eslint` riconosce i
45
+ file `.cjs` come CommonJS di Node. I piani delle pipeline d'esempio e
46
+ pronte non cambiano.
47
+ - 772beb9: `etl catalog check` verifica la conformità del catalogo di `etl.config.ts`: scopo dei nodi,
48
+ changelog valido, piano senza credenziali e senza segreti (ambiente di prova da `.env.example`,
49
+ poi con le credenziali alternative commentate) e cartelle orfane in `src/pipelines/`. Una riga per
50
+ violazione su stdout, exit 1 se ce n'è una. Il `.env.example` del repo deve portare le variabili
51
+ obbligatorie di ogni pipeline del catalogo. Il pacchetto esporta tre preset, `./tsconfig`
52
+ (`moduleResolution: bundler`), `./eslint` (`no-explicit-any` e `no-console` a `error`) e
53
+ `./vitest` (senza soglia di coverage), e porta `eslint`, `typescript-eslint` e `vitest` fra le
54
+ dipendenze. I piani delle pipeline d'esempio e pronte non cambiano.
55
+ - 287e06d: Tre connettori entrano nell'API pubblica: `./connectors/sendgrid` (mail via API REST di SendGrid),
56
+ `./connectors/mail` (`mailAction` e `mailSink`, che scelgono fra SMTP e SendGrid dalla
57
+ configurazione) e `./connectors/process` (un programma esterno lanciato da un nodo `action`).
58
+ `./testing` aggiunge `WorkspaceNoevaFinto`, un workspace Noeva in memoria, e `fetchSendgridFinto`,
59
+ un `fetch` finto per l'API di SendGrid. I piani delle pipeline d'esempio e pronte non cambiano.
60
+ - 2d1e181: `etl deploy-ecr <cliente>` porta su ECR + ECS l'immagine di un cliente che ha scelto ECR invece di
61
+ GHCR (ADR-0104). Lo script arriva col pacchetto, in `deploy/deploy-ecr.sh`, e lavora sulla radice del
62
+ repo da cui si lancia: legge la `deploy-ecr.conf` del repo cliente, usa `etl ci` come gate (o
63
+ `pnpm run check` dove lo script `check` c'è) e costruisce l'immagine col Dockerfile del pacchetto, o
64
+ con quello alla radice se il repo l'ha preso in `unmanaged`. Le opzioni sono quelle di prima
65
+ (`--dry-run`, `--env`, `--solo-env`, `--solo-ecr`, `--attendi`, `etl deploy-ecr --help`). Il comando
66
+ non carica il `.env` del repo. Con `CLIENTE_SLUG` la `deploy-ecr.conf` dichiara di
67
+ quale cliente è, e il deploy si ferma su uno slug diverso. I piani delle pipeline d'esempio e pronte non cambiano.
68
+ - aa59de3: `etl docs build` e `etl docs dev` costruiscono il sito di documentazione del repo con
69
+ configurazione, tema e componenti dei grafi dal pacchetto: in un repo cliente resta solo il
70
+ markdown di `docs/`, e il sito, col nome del cliente nel titolo («Noeva ETL · ACME») e gli ADR
71
+ compresi, va in `docs/.vitepress/dist`. Il build genera la pagina indice del catalogo,
72
+ `docs/catalogo.md`, da non versionare, con le pipeline pronte come righe che portano alla guida del
73
+ core. Prima di costruire si ferma, una riga per problema ed exit 1, se una pipeline del catalogo o
74
+ una sub-pipeline istanziata non ha la scheda, se un nodo non ha scopo, se un link è rotto o se un
75
+ link `core:` non è una pagina della guida del core installata; le pipeline pronte sono esenti. I
76
+ link `core:nodes/lookup.md` diventano `/guida/core/nodes/lookup`. `vitepress`, `vue`, `mermaid` e
77
+ `gray-matter` entrano fra le dipendenze, e il pacchetto porta la guida del core costruita in
78
+ `dist/guida/`. I piani delle pipeline d'esempio e pronte non cambiano.
79
+ - f4bb538: `etl init <slug>` crea un repo cliente in una cartella vuota: il boilerplate del pacchetto
80
+ (`package.json` con gli alias `pipeline:*`, `etl.config.ts` col catalogo vuoto, `.env.example` con
81
+ le variabili obbligatorie del core, `tsconfig`, `eslint` e `vitest` di una riga sui preset,
82
+ `AGENTS.md` col blocco gestito, `CLAUDE.md` e `ci.yml`), poi `git init` e i branch `dev`, `staging`
83
+ e `main`. Su una cartella non vuota si ferma senza scrivere. `etl ci` è il gate del repo cliente:
84
+ `tsc --noEmit`, lint, format, test, `etl versions check`, `etl catalog check` ed `etl docs build`,
85
+ in quest'ordine, fermandosi alla prima fase che fallisce e nominandola. `ci.yml` lo lancia dopo il
86
+ setup, senza workflow riusabili dell'org. Le `devDependencies` del boilerplate portano la
87
+ toolchain (`vitest`, `eslint`, `typescript`, `prettier`, `@types/node`) con i range del core.
88
+
89
+ `etl versions check` senza la base della mappa dei branch (`origin/dev`, oppure `origin/main` per
90
+ `main` e per un `hotfix/*` verso `main`) non fallisce più per la base mancante: con l'avviso
91
+ «nessuna base (<ref>): niente da confrontare» salta bump e numero di versione e controlla solo gli
92
+ snapshot, così passano un repo appena creato e il bootstrap di un repo migrato con pipeline già
93
+ oltre la v1. Una base data con
94
+ `--base` che non c'è resta un errore.
95
+
96
+ - 36f9aaa: `etl upgrade [--check] [--force]`: con `--check`, in sola lettura, la versione del core installata e
97
+ l'ultima sul registry, il changelog fra le due con le major e «Cambia il piano» in evidenza, e la
98
+ deriva dei file gestiti. Senza, il bump del core (con la toolchain allineata ai suoi range) e il
99
+ sync dei file gestiti col template del core nuovo; si ferma su un file gestito modificato a mano,
100
+ salvo `--force`, e rispetta `unmanaged`; `--sync` fa solo il sync, senza registry. `etl ci` avvisa, senza fallire, di un core non aggiornato.
101
+ - cb938fa: `etl serve` serve la documentazione: su `/guida/` il sito del cliente, che `etl docs build`
102
+ costruisce in `docs/.vitepress/dist`, e su `/guida/core/` la guida del core del pacchetto
103
+ installato (`dist/guida/`), con gli URL puliti e il `404.html` di ciascun sito. `etl serve` non
104
+ costruisce niente: se il sito del cliente manca, `/guida/` dice «Documentazione del cliente non
105
+ costruita» e porta alla guida del core, e il log lo segnala con un avviso senza fermare l'avvio.
106
+ La guida del core del pacchetto si costruisce col prefisso `/guida/core/`, e la favicon dei due
107
+ siti segue il loro prefisso. I piani delle pipeline d'esempio e pronte non cambiano.
108
+ - 593fdfa: La guida del core è una sola, la stessa nel pacchetto (`dist/guida/`) e su Cloudflare: escono le
109
+ varianti `app` e `public`, `NOEVA_DOCS_TARGET` e i blocchi `::: solo-app`. Non contiene ADR, piani,
110
+ processo del team né clienti, e ha le sezioni «Pipeline pronte» ed «Esempi», generate dal catalogo
111
+ del core. Il manifesto `pagine.json` ora porta le schede delle pipeline pronte, quindi un link
112
+ `core:pipelines/test-posta.md` da un repo cliente si valida. In `etl docs build` un link a un file
113
+ che esiste ma non si pubblica, o fuori da `docs/`, ferma il build anche nella guida del core. Le
114
+ pagine di sviluppo descrivono il repo cliente, e una pagina nuova elenca le variabili d'ambiente del
115
+ core con i default. Nuova pipeline d'esempio `movimenti-per-conto`, di riferimento per `parse`, `sort`
116
+ e `serialize`. I piani delle pipeline d'esempio e pronte esistenti non cambiano.
117
+ - 5b34808: `./connectors/jira` esporta `istanzaJiraDichiarata(id)`, il sito Jira da passare ad
118
+ `ambienteDellaPipeline` nel membro `environment(env)`: `etl env check` vede così anche
119
+ `JIRA_<ID>_EMAIL` e `JIRA_<ID>_API_TOKEN`, che il piano non mostra, e non dà le variabili del sito
120
+ per sconosciute. I piani delle pipeline d'esempio e pronte non cambiano.
121
+ - 2faf13d: `etl agent sync` copia nel repo il kit dell'agente del core installato: le skill `etl-graph`,
122
+ `new-pipeline`, `new-connector`, `new-transform`, `etl-review` e `doc-sync` in
123
+ `.claude/skills/noeva-etl-*`, i subagent di scaffolding e di review in `.claude/agents/noeva-etl-*`
124
+ e la guardia sui branch in `.claude/hooks/noeva-etl-branch-guard.sh`, con la sua voce in
125
+ `.claude/settings.json`. Scrive anche il blocco gestito di `AGENTS.md`, con le regole del core su
126
+ upgrade, doc nello stesso commit, `--realign` e i tre rollback, e lascia al repo il resto del file
127
+ e di `.claude/`. Toglie le voci `noeva-etl-*` che il kit non ha più e salta quelle dichiarate in
128
+ `unmanaged`. `etl init` lancia il sync, quindi un repo nuovo nasce col kit. Il pacchetto pubblica
129
+ la cartella `kit/` intera. I piani delle pipeline d'esempio e pronte non cambiano.
130
+ - a5f661c: `./connectors/sendgrid` esporta `istanzaSendgridDichiarata(id)`, l'account SendGrid da passare ad
131
+ `ambienteDellaPipeline` nel membro `environment(env)`: `etl env check` vede così anche
132
+ `SENDGRID_API_KEY`, che il piano non mostra, e non dà le variabili dell'account per sconosciute.
133
+
134
+ `etl versions check` senza la base della mappa dei branch (un repo mai pubblicato, il bootstrap di
135
+ uno migrato) non salta più tutto: con l'avviso «nessuna base» salta solo il bump richiesto e la
136
+ versione uguale a base + 1, e controlla comunque che lo snapshot della versione corrente ci sia e
137
+ coincida col piano. Un repo che prima era verde senza base con uno snapshot sbagliato ora esce
138
+ con 1. I piani delle pipeline d'esempio e pronte non cambiano.
139
+
140
+ - 781e8d0: Lo storage S3, SFTP e FTP di `./connectors/file` prende la config di un'istanza al posto di un
141
+ client già connesso (ADR-0103): `s3Storage(config, { bucket })`, `sftpStorage(config)` e
142
+ `ftpStorage(config)`, con `config` da `loadS3Registry`, `loadSftpRegistry` o `loadFtpRegistry`. Il
143
+ connettore costruisce il client, apre la sessione alla prima operazione e la chiude quando non ne
144
+ resta nessuna in corso, anche su errore e abort; una sessione su cui un'operazione fallisce non si
145
+ riusa. Un repo cliente non importa più
146
+ `@aws-sdk/client-s3`, `ssh2-sftp-client` né `basic-ftp`. L'opzione `client` sparisce; restano
147
+ `name`, si aggiungono `timeoutMs` (default 30 secondi) e `creaClient`, la porta dei test verso
148
+ `ClientS3`, `ClientSftp` e `ClientFtp`. Per `environment(env)` arrivano `istanzaS3Dichiarata`,
149
+ `istanzaSftpDichiarata` e `istanzaFtpDichiarata`, con i manifest `MANIFEST_S3`, `MANIFEST_SFTP` e
150
+ `MANIFEST_FTP`. I loader elencano tutte le variabili mancanti insieme, e un `SFTP_PORT` non valido
151
+ non finisce più nel messaggio. `ftpStorage` scrive a partire dalla home del login e non da `/`,
152
+ che su un server senza chroot non è scrivibile. I piani delle pipeline d'esempio e pronte non cambiano.
153
+ - a9a864e: Il connettore Jira Cloud entra nell'API pubblica: `./connectors/jira` esporta `jiraIssues` (pieno o
154
+ incrementale), i lookup `jiraIssueLookup`, `jiraChangelogLookup`, `jiraCommentsLookup` e
155
+ `jiraWorklogsLookup`, le azioni di scrittura (`jiraCreateIssue`, `jiraUpdateIssue`,
156
+ `jiraTransition`, `jiraUpsertIssue`, `jiraAddComment`, `jiraAddWorklog`, `jiraLinkIssues`),
157
+ `istanzaJiraPerIlPiano` e i convertitori fra Markdown, ADF e testo. Le istanze si dichiarano con
158
+ le variabili `JIRA_*`. I piani delle pipeline d'esempio e pronte non cambiano.
159
+ - f3dbed1: Il connettore Zoho CRM entra nell'API pubblica: `./connectors/zoho` esporta `zohoCrmRecords`, il
160
+ source dei record di un modulo con i soli campi dichiarati, in ordine di `id` (Records API v8 fino a
161
+ 100.000 record, Query API COQL oltre), il registry delle organizzazioni (`loadZohoRegistry`,
162
+ `loadZohoInstance`), `istanzaZohoPerIlPiano` e le funzioni sulle colonne (`colonneZoho`,
163
+ `schemaRecordZoho`). Le organizzazioni si dichiarano con le variabili `ZOHO_*`; il token lo rinnova
164
+ un'identità `OAUTH_*`. `PREFISSO_ZOHO` entra in `./connector-kit`. In `./connectors/oauth`,
165
+ `fornitoreToken` tratta una risposta 200 con `{ error }` nel corpo (come la dà Zoho quando il
166
+ rinnovo fallisce) come un rifiuto: il `ConfigError` porta il codice del provider invece del
167
+ messaggio generico. I piani delle pipeline d'esempio
168
+ e pronte non cambiano.
169
+
170
+ ### Patch Changes
171
+
172
+ - c1bad71: Il pacchetto non porta più codice né nomi di un cliente: il catalogo del repo del core non registra
173
+ più la pipeline di un cliente, che vive nel suo repo cliente (ETL-276). `etl deploy-ecr` legge solo la
174
+ `deploy-ecr.conf` alla radice del repo cliente: la ricerca in `clienti/<cliente>/`, che serviva ai
175
+ clienti ospitati nel core, è tolta. Né l'API né i piani delle pipeline d'esempio e pronte cambiano.
176
+ - ff4930d: `etl versions check` con una base, e il rollback che legge i changelog allo stesso modo, tornano
177
+ a funzionare su Node 20 e 22. Il changelog della base, scritto in una cartella temporanea per
178
+ importarlo, ha accanto un `package.json` con `"type": "module"`: senza, `tsx` lo caricava come
179
+ CommonJS e Node si fermava nel ciclo `require(esm)` («non si importa da solo»). Su Node 24 il gate
180
+ passava già. Lo smoke test del pacchetto prova ora il gate anche con una base (ETL-287).
181
+ - 2d17b19: `etl init` funziona dal pacchetto pubblicato. Si fermava con uno `ZodError` su `packageManager`:
182
+ il pnpm del repo cliente veniva letto dal `package.json` del core, e `pnpm pack` toglie quel campo
183
+ dal manifest pubblicato. Ora il valore sta nel codice del core, allineato al suo `packageManager`
184
+ da un test. `etl init --help` (e `-h`) stampa l'uso invece di prendere l'opzione per uno slug. Lo
185
+ smoke test del pacchetto lancia `etl init` dal tarball installato, non più dal `dist/` del repo
186
+ (ETL-286).
187
+ - 24c50e9: Il pacchetto non porta più il materiale di sviluppo del tema delle docs: i test e le fixture di
188
+ `docs/.vitepress/`, `wrangler.jsonc`, la cache di VitePress e i siti costruiti. `pnpm pack`, e
189
+ quindi `changeset publish`, ignorava le negazioni di `files`; ora li esclude
190
+ `docs/.vitepress/.npmignore`. Uno smoke test, nel check e in CI, installa il tarball in un repo
191
+ nato da `etl init` e verifica `etl ci`, `etl run` ed `etl serve` con la guida del core del
192
+ pacchetto. I piani delle pipeline d'esempio e pronte non cambiano.
package/LICENSE ADDED
@@ -0,0 +1,19 @@
1
+ Copyright © 2026 4D S.R.L. Tutti i diritti riservati.
2
+
3
+ "Noeva" è un marchio registrato di 4D S.R.L. (P.IVA IT03000790356),
4
+ Via Brigata Reggio 32, 42124 Reggio Emilia (RE), Italia.
5
+
6
+ Questo software è concesso in licenza, non venduto. È consentito installare ed
7
+ eseguire questo pacchetto esclusivamente per interagire con i servizi Noeva,
8
+ in conformità ai termini contrattuali applicabili tra l'utente e 4D S.R.L.
9
+
10
+ Non sono concessi diritti di modifica, ridistribuzione, sublicenza, decompilazione
11
+ o reverse engineering, salvo diversa autorizzazione scritta di 4D S.R.L. o per
12
+ quanto inderogabilmente consentito dalla legge applicabile.
13
+
14
+ IL SOFTWARE È FORNITO "COSÌ COM'È", SENZA GARANZIE DI ALCUN TIPO, ESPRESSE O
15
+ IMPLICITE, INCLUSE, A TITOLO ESEMPLIFICATIVO, LE GARANZIE DI COMMERCIABILITÀ E
16
+ IDONEITÀ A UNO SCOPO PARTICOLARE. IN NESSUN CASO 4D S.R.L. SARÀ RESPONSABILE PER
17
+ QUALSIASI RECLAMO, DANNO O ALTRA RESPONSABILITÀ DERIVANTE DALL'USO DEL SOFTWARE.
18
+
19
+ Contatti: hello@noeva.ai
package/README.md CHANGED
@@ -86,7 +86,7 @@ pnpm exec etl upgrade
86
86
  pnpm run etl worker
87
87
  ```
88
88
 
89
- Requisiti: Node ≥ 20, pnpm 9.
89
+ Requisiti: Node ≥ 26, pnpm 9.
90
90
 
91
91
  ## Distribuzione (Docker / CLI)
92
92
 
package/deploy/Dockerfile CHANGED
@@ -16,12 +16,13 @@
16
16
  # Il contesto lo filtra `Dockerfile.dockerignore`, accanto a questo file. Un
17
17
  # cliente che ha bisogno di altro (un CA aziendale, un proxy) copia il
18
18
  # Dockerfile nel suo repo e se ne assume l'aggiornamento.
19
- FROM node:20-slim
19
+ FROM node:26-slim
20
20
  ENV NODE_ENV=production \
21
21
  COREPACK_ENABLE_DOWNLOAD_PROMPT=0 \
22
22
  PATH=/app/node_modules/.bin:$PATH
23
23
  WORKDIR /app
24
- RUN corepack enable
24
+ # Da Node 25 corepack non è più in Node: si installa da npm, a versione fissata (ETL-297).
25
+ RUN npm install -g corepack@0.36.0 && corepack enable
25
26
 
26
27
  # L'`.npmrc` del repo porta le impostazioni di pnpm del cliente, se ne ha.
27
28
  COPY package.json pnpm-lock.yaml .npmrc* ./
@@ -6,10 +6,10 @@
6
6
  <title>404 · Noeva ETL</title>
7
7
  <meta name="description" content="Not Found">
8
8
  <meta name="generator" content="VitePress v1.6.4">
9
- <link rel="preload stylesheet" href="/guida/core/assets/style.BNn_AkzN.css" as="style">
9
+ <link rel="preload stylesheet" href="/guida/core/assets/style.DFlUbYCk.css" as="style">
10
10
  <link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
11
11
 
12
- <script type="module" src="/guida/core/assets/app.BrI3mcoI.js"></script>
12
+ <script type="module" src="/guida/core/assets/app.DeVEBaIz.js"></script>
13
13
  <link rel="preload" href="/guida/core/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
14
14
  <link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
15
15
  <meta name="theme-color" content="#0a0e15">
@@ -18,7 +18,7 @@
18
18
  </head>
19
19
  <body>
20
20
  <div id="app"></div>
21
- <script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"BeotXAWb\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"BqI2RLCu\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"connectors_zoho.md\":\"BfEzRNZk\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"MQaGlm8a\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"CrN52ZDN\",\"guide_claude-code_index.md\":\"CxVSru8e\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"DP2i3GFv\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"f3LAxif4\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"CsIYRa_5\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_graph-server.md\":\"opGHnuzK\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"C8viT-fp\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"iD1gDlJY\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"},{\"text\":\"Zoho CRM (record di un modulo, con i campi dichiarati)\",\"link\":\"/connectors/zoho\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"un cliente su ECR + ECS\",\"link\":\"/runbooks/deploy-ecr\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
21
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"BeotXAWb\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"BqI2RLCu\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"connectors_zoho.md\":\"BfEzRNZk\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"MQaGlm8a\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"CrN52ZDN\",\"guide_claude-code_index.md\":\"DEnzf9b_\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"DP2i3GFv\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"DrFr4blI\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"CwG77qGO\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_graph-server.md\":\"opGHnuzK\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"C8viT-fp\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"DTIhkkg9\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"},{\"text\":\"Zoho CRM (record di un modulo, con i campi dichiarati)\",\"link\":\"/connectors/zoho\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"un cliente su ECR + ECS\",\"link\":\"/runbooks/deploy-ecr\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
22
22
 
23
23
  </body>
24
24
  </html>