diff --git a/smoke/README.md b/smoke/README.md
index 86d1b5f..0f6d35d 100644
--- a/smoke/README.md
+++ b/smoke/README.md
@@ -2,6 +2,18 @@
 
 Suite manuale di mini-progetti per verificare il toolkit end-to-end senza pytest.
 
+Questa cartella non definisce il core smoke contract del repository:
+
+- lo smoke offline canonico resta `project-example`
+- gli smoke tecnici deterministici restano in `tests/test_smoke_tiny_e2e.py`
+- i casi sotto `smoke/` sono playbook manuali, utili per controlli operativi su sorgenti locali o pubbliche
+
+Di conseguenza:
+
+- non sono CI gate
+- alcune sorgenti pubbliche possono cambiare formato o disponibilita`
+- eventuali output locali sotto `_smoke_out/` non vanno tenuti nella working tree
+
 Progetti inclusi:
 
 - `smoke/ispra_http_csv`: `http_file` contro server locale `http.server`
diff --git a/smoke/bdap_http_csv/dataset.yml b/smoke/bdap_http_csv/dataset.yml
index 1357754..0d91dbd 100644
--- a/smoke/bdap_http_csv/dataset.yml
+++ b/smoke/bdap_http_csv/dataset.yml
@@ -5,11 +5,11 @@ dataset:
   years: [2022]
 
 raw:
-  source:
-    type: "http_file"
-    args:
-      url: "https://bdap-opendata.rgs.mef.gov.it/export/csv/Rendiconto-Pubblicato---Serie-storica---Saldi.csv"
-      filename: "bdap_rendiconto_saldi_{year}.csv"
+  sources:
+    - type: "http_file"
+      args:
+        url: "https://bdap-opendata.rgs.mef.gov.it/export/csv/Rendiconto-Pubblicato---Serie-storica---Saldi.csv"
+        filename: "bdap_rendiconto_saldi_{year}.csv"
 
 clean:
   sql: "sql/clean.sql"
diff --git a/smoke/finanze_http_zip_2023/dataset.yml b/smoke/finanze_http_zip_2023/dataset.yml
index c7c40e4..3acc4ec 100644
--- a/smoke/finanze_http_zip_2023/dataset.yml
+++ b/smoke/finanze_http_zip_2023/dataset.yml
@@ -7,10 +7,10 @@ dataset:
 raw:
   extractor:
     type: "unzip_first_csv"
-  source:
-    type: "http_file"
-    args:
-      url: "https://www1.finanze.gov.it/finanze/analisi_stat/public/v_4_0_0/contenuti/Redditi_e_principali_variabili_IRPEF_su_base_comunale_CSV_2023.zip?d=1615465800"
+  sources:
+    - type: "http_file"
+      args:
+        url: "https://www1.finanze.gov.it/finanze/analisi_stat/public/v_4_0_0/contenuti/Redditi_e_principali_variabili_IRPEF_su_base_comunale_CSV_2023.zip?d=1615465800"
 
 clean:
   sql: "sql/clean.sql"
diff --git a/smoke/ispra_http_csv/dataset.yml b/smoke/ispra_http_csv/dataset.yml
index 36a3bad..e62568d 100644
--- a/smoke/ispra_http_csv/dataset.yml
+++ b/smoke/ispra_http_csv/dataset.yml
@@ -5,11 +5,11 @@ dataset:
   years: [2022]
 
 raw:
-  source:
-    type: "http_file"
-    args:
-      url: "https://www.catasto-rifiuti.isprambiente.it/get/getDettaglioComunale.csv.php?&aa={year}"
-      filename: "ispra_http_sample_{year}.csv"
+  sources:
+    - type: "http_file"
+      args:
+        url: "https://www.catasto-rifiuti.isprambiente.it/get/getDettaglioComunale.csv.php?&aa={year}"
+        filename: "ispra_http_sample_{year}.csv"
 
 clean:
   sql: "sql/clean.sql"
diff --git a/smoke/local_file_csv/dataset.yml b/smoke/local_file_csv/dataset.yml
index 096c7d6..db89a27 100644
--- a/smoke/local_file_csv/dataset.yml
+++ b/smoke/local_file_csv/dataset.yml
@@ -5,11 +5,11 @@ dataset:
   years: [2022]
 
 raw:
-  source:
-    type: "local_file"
-    args:
-      path: "fixtures/local_file_sample.csv"
-      filename: "local_file_sample_{year}.csv"
+  sources:
+    - type: "local_file"
+      args:
+        path: "fixtures/local_file_sample.csv"
+        filename: "local_file_sample_{year}.csv"
 
 clean:
   sql: "sql/clean.sql"
diff --git a/smoke/zip_http_csv/dataset.yml b/smoke/zip_http_csv/dataset.yml
index ff206f4..3884a40 100644
--- a/smoke/zip_http_csv/dataset.yml
+++ b/smoke/zip_http_csv/dataset.yml
@@ -7,10 +7,10 @@ dataset:
 raw:
   extractor:
     type: "unzip_first_csv"
-  source:
-    type: "http_file"
-    args:
-      url: "http://127.0.0.1:8000/fixtures/irpef_http_sample.zip"
+  sources:
+    - type: "http_file"
+      args:
+        url: "http://127.0.0.1:8000/fixtures/irpef_http_sample.zip"
 
 clean:
   sql: "sql/clean.sql"