@noeva/analytics-core 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 Le versioni del pacchetto che i repository dei progetti installano (ADR 0005). Prima di
 `analytics upgrade` si legge cosa cambia fra la versione installata e la nuova.
 
+## 0.3.3 — 6 novembre 2026
+
+- Il contenitore parla Oracle: l'extra `oracle` di wrenai (oracledb in modalita' thin,
+  Oracle 12.1 e successivi). Per una sorgente 11.2 serve la modalita' thick, con
+  l'Instant Client, che il contenitore non ha.
+- `correggi-oracle.py` corregge in build il connettore Oracle di wrenai 0.15.0, che
+  leggeva i `NUMBER` senza precisione (colonne non vincolate, `SUM`, divisioni) come
+  interi e troncava i decimali senza errori. Si ferma se una versione nuova di wrenai
+  cambia il connettore. Un `FLOAT` (anche `CAST(... AS DOUBLE)`, che il motore traduce in
+  `DOUBLE PRECISION`) faceva fallire la query: ora e' virgola mobile.
+- Si ricostruisce il contenitore: `docker compose --env-file .env.local up -d --build`.
+
 ## 0.3.2 — 6 novembre 2026
 
 - Su Windows la CLI non partiva: la cartella del pacchetto si ricavava con

package/modello/contenitore/Dockerfile

@@ -44,11 +44,18 @@ USER wren
 WORKDIR /home/wren
 
 # mcp<2: wrenai importa mcp.server.fastmcp, tolto nell'SDK 2.x.
+# `oracle` porta oracledb in modalita' thin (Oracle 12.1 e successivi, niente
+# Instant Client).
 ARG WRENAI_VERSION=0.15.0
 RUN pip install --user \
-      "wrenai[mssql,clickhouse,postgres,memory-onnx,mcp,main]==${WRENAI_VERSION}" \
+      "wrenai[mssql,clickhouse,postgres,oracle,memory-onnx,mcp,main]==${WRENAI_VERSION}" \
       "mcp[cli]>=1.19,<2"
 
+# Il connettore Oracle di wrenai 0.15.0 tronca i decimali dei NUMBER senza
+# precisione: vedi correggi-oracle.py.
+COPY correggi-oracle.py /tmp/correggi-oracle.py
+RUN python /tmp/correggi-oracle.py
+
 RUN python -c "import pyodbc; \
     drivers = pyodbc.drivers(); \
     assert any('SQL Server' in d for d in drivers), f'driver ODBC assente: {drivers}'; \

package/modello/contenitore/correggi-oracle.py

@@ -0,0 +1,39 @@
+"""Corregge il connettore Oracle di wrenai 0.15.0, che tronca i decimali.
+
+`wren/connector/oracle.py` traduce un NUMBER senza precisione in int64: e' il tipo
+delle colonne non vincolate (molte, nei data mart Oracle) e di ogni espressione
+calcolata da Oracle (SUM, divisioni, ROUND). Il risultato e' 400,68 € letto come
+400, senza errori. Qui, quando i metadati non dicono la precisione, decidono i
+valori: tutti interi -> int64, altrimenti float64. Un FLOAT(p) (scala -127: e'
+anche il CAST(... AS DOUBLE) che il motore traduce in DOUBLE PRECISION) diventava
+decimal(38,0) e la query falliva: diventa float64.
+
+Si applica in build (Dockerfile) e si ferma se il connettore e' cambiato: a una
+versione nuova di wrenai si controlla se la correzione serve ancora.
+"""
+import pathlib
+import sys
+
+import wren.connector.oracle as connettore
+
+file = pathlib.Path(connettore.__file__)
+sorgente = file.read_text()
+prima = """        if db_type == oracledb.DB_TYPE_NUMBER:
+            arrow_type = _ora_number_type(precision, scale)"""
+dopo = """        if db_type == oracledb.DB_TYPE_NUMBER and not precision and scale in (None, -127):
+            # NUMBER senza precisione: decidono i valori (correggi-oracle.py).
+            vals = [v for v in col_values[i] if v is not None]
+            arrow_type = pa.int64() if all(isinstance(v, int) for v in vals) else pa.float64()
+        elif db_type == oracledb.DB_TYPE_NUMBER and scale == -127:
+            # FLOAT(p), anche CAST(... AS DOUBLE PRECISION): virgola mobile.
+            arrow_type = pa.float64()
+        elif db_type == oracledb.DB_TYPE_NUMBER:
+            arrow_type = _ora_number_type(precision, scale)"""
+
+if dopo in sorgente:
+    print("connettore Oracle: gia' corretto")
+    sys.exit(0)
+if sorgente.count(prima) != 1:
+    sys.exit("connettore Oracle cambiato: rivedere correggi-oracle.py")
+file.write_text(sorgente.replace(prima, dopo))
+print("connettore Oracle: corretto", file)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noeva/analytics-core",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "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": {