gea-program 0.14.0__tar.gz → 0.16.0__tar.gz

{gea_program-0.14.0 → gea_program-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gea-program
-Version: 0.14.0
+Version: 0.16.0
 Summary: GEA-Program: downhole gauge monitoring - canonical measurement records, quality rules, drift evaluation with a re-fit change log, well-test validation, alarm management, model cards, store-and-forward, monthly SLA measurement, FAT/SAT protocols and a dashboard, generated from live objects in the client's reporting outline.
 Author: Daniel T. Murphy
 License: MPL-2.0
@@ -72,7 +72,7 @@ reaches a client document. Nothing unmeasured is ever reported as met.
   rate-controlled replay, duplicate suppression, per-record latency.
 - **Configuration versioning, SBOM, monthly SLA, FAT/SAT**
   (`config_versioning.py`, `sbom.py`, `sla_report.py`, `fat_sat.py`).
-- **Live protocol ports** (`live_ports.py`, `wits0.py`, `witsml.py`, `opcua_port.py`,
+- **Live protocol ports** (`live_ports.py`, `wits0.py`, `witsml.py`, `etp.py`, `opcua_port.py`,
   `mqtt_port.py`, `modbus.py`): WITS Level 0 from the drill floor (TCP connect,
   TCP listen, serial), WITSML 1.4.1 stores (read-only, polled), OPC UA (read and
   subscribe), MQTT (number, JSON, Sparkplug B), Modbus TCP; every message becomes
@@ -125,7 +125,7 @@ gea dashboard --catalog-well volve_f12_f14_production_excerpt:15/9-F-12:10000 --
 gea client-report --report accuracy --out client_report
 gea model-cards --out model_cards
 gea sbom --out sbom
-gea accept                     # the product gate (330 checks)
+gea accept                     # the product gate (337 checks)
 gea help drift                 # the help library, by the job (16 pages; the same text is on every dashboard page)
 gea guide                      # the click-by-click tester guide (docs/TESTER_GUIDE.md)
 gea gui                        # the desktop window (pip install "gea-program[desktop]")
@@ -143,7 +143,7 @@ gea swaps / gea certificates / gea notify / gea housekeeping / gea loadtest   #
 
 ## Live data
 
-The engine reads live data through five protocol ports. All are **read-only**,
+The engine reads live data through six protocol ports. All are **read-only**,
 all map only what the site declares (a tag map the client owns; an empty map
 is declined), and all write every received message to a JSON-lines recording
 that `--replay` turns back into records without a connection - which is how a
@@ -156,6 +156,9 @@ gea wits0-sim --port 5001                             # a WITS0 sender to rehear
 gea wits0  --config wits0.json --seconds 60 --record floor/session.jsonl --out floor --stream-csv floor/stream.csv   # in the first window, while the sender runs
 gea witsml --write-example-config witsml.json         # a WITSML 1.4.1 store: url, uids, mnemonics -> tags; credentials by env name
 gea witsml --config witsml.json --seconds 60 --out store                 # needs a real store: the example url is a placeholder until you edit it
+gea etp    --write-example-config etp.json            # a WITSML 2.x store over ETP v1.2: ws:// or wss:// url, bearer token by env name, channel URIs -> tags, units
+gea etp-sim --port 9800                               # an ETP store with two channels to rehearse with - run it in a SECOND window and leave it running
+gea etp    --config etp.json --seconds 60 --record rig/session.jsonl --out rig   # subscribes; the store pushes every value as it is written
 gea opcua  --write-example-config opcua.json          # edit: endpoint, security, credential env names, nodes
 gea opcua  --config opcua.json --seconds 60 --record opc/session.jsonl --out opc --stream-csv opc/stream.csv   # needs a real OPC UA server, likewise
 gea mqtt   --write-example-config mqtt.json           # edit: broker, TLS, credential env names, topics
@@ -167,6 +170,7 @@ gea ingest --file floor/stream.csv                    # a stream CSV feeds the h
 |---|---|---|---|
 | `wits0` | WITS Level 0 frames (`&&` ... `!!`, four-digit item codes) over TCP connect, TCP listen or serial; record-01 dictionary built in | numeric GOOD; sentinels (-9999, -999.25) and non-numeric -> GAP with the reason | items 0105/0106 (date, time) when present, else arrival; ingest at arrival |
 | `witsml` | WITSML 1.4.1 SOAP store: GetVersion, GetCap, GetFromStore on one log object, rows newer than the last seen at each poll | numeric GOOD; the store's nullValue and empty fields -> GAP | the index curve of a time log; arrival for a depth log |
+| `etp` | Energistics ETP v1.2 over WebSocket (`etp12.energistics.org`, Avro binary to the published schemas): RequestSession/OpenSession, GetChannelMetadata for the declared URIs, SubscribeChannels, ChannelData pushed by the store (Protocol 21) | numeric GOOD; a non-numeric or null value -> BAD with the reason; a channel the map does not name is counted unmapped | the store's own index: an ETP DateTime index is microseconds since the epoch; an ElapsedTime index is seconds from its declared start; a depth index leaves the arrival time standing, named |
 | `opcua` | opc.tcp, read + subscribe; Basic256Sha256 SignAndEncrypt when a certificate and key are given | StatusCode severity bits: Good -> GOOD, Uncertain -> STALE, Bad -> GAP (value withheld) | source timestamp, else server timestamp, else arrival |
 | `mqtt` | MQTT v5 / v3.1.1, TLS optional, QoS per topic; `+`/`#` wildcards | number: GOOD or GAP; JSON: value/time/quality paths; Sparkplug B: `is_null` -> GAP, `Quality` != 192 -> STALE | JSON time path, Sparkplug metric timestamp, else arrival |
 | `modbus_g6` | Modbus TCP, user-supplied register map with a citation | read failures -> GAP | arrival |
@@ -619,6 +623,50 @@ promoted; the group and the support are declarations; a matched frequency
 is not a fault size. CSV or miniSEED/SAC; `gea vibration` runs the labelled
 pump; `gea help vibration`.
 
+### WITSML 2.x over ETP
+
+The newer rigs and stores do not poll: Energistics ETP v1.2 is a WebSocket
+session, Avro-encoded to the published schemas, on which the customer names
+the channels it wants and the store pushes every value as it is written.
+`gea/etp.py` is that customer: the handshake with the subprotocol, the
+binary encoding and the payload limits; RequestSession for Discovery, Store
+and ChannelSubscribe and what the store answered; the channel metadata for
+the URIs the mapping declares (a URI the store does not have is named as
+missing); the subscription; and each ChannelData DataItem as a record under
+the mapping's tag and unit, with the store's own index as the source time -
+microseconds since the epoch for a DateTime index, seconds from the declared
+start for ElapsedTime, the arrival time standing (and named) for a depth
+index - and the arrival as the ingest time, so the latency is per record.
+Client message ids even, the store's odd; a ProtocolException carried with
+its code; a client or a store without the subprotocol refused at the
+handshake. The patch supervisor runs it like every other port; the page
+offers it; `gea etp-sim` is a store with two channels of a synthetic
+disposal well; `gea etp --selftest` runs the codec and a loopback session;
+`gea help etp`. The doctor now also names a panel started through the
+`gea.exe` launcher, which pip cannot replace while it runs - stop, update,
+start with `python -m gea serve`.
+
+### Conformity, in the standards' words
+
+The drift report's "bias inside the instrument's class" is a statement of
+conformity, and ISO/IEC 17025:2017 7.8.6 says what one carries: the result it
+applies to, the specification, and the decision rule - which has to take
+the uncertainty into account. The report now states it that way: the tag's
+bias over the window with its sample count, the certificate's accuracy
+class as the tolerance limit, the bias's expanded uncertainty (k = 2) as the
+guard band, and the ILAC-G8:09/2019 non-binary rule - PASS, CONDITIONAL
+PASS, CONDITIONAL FAIL or FAIL, with the acceptance limit printed; without
+an uncertainty it falls back to simple acceptance and says so. The
+certificate register takes what 7.8.4 asks the paper to carry (the expanded
+uncertainty with k and probability, the traceability statement as worded,
+the conditions, the calibration date, the method, who authorised it) and
+`gea certificates --action conformance` prints each certificate against
+the fourteen items of 7.8.2.1 and 7.8.4.1 - CARRIED, NOT CARRIED, NOT
+RECORDED - with COMPLETE or INCOMPLETE and the missing clauses named. The
+well page's filing form takes the items and its table shows U (k) and the
+standing. `gea conformance --action decide` states one decision. `gea help
+conformance`.
+
 ### Audit / Update
 
 The Audit / Update tab holds three things. The whole audit log

{gea_program-0.14.0 → gea_program-0.16.0}/README.md

@@ -33,7 +33,7 @@ reaches a client document. Nothing unmeasured is ever reported as met.
   rate-controlled replay, duplicate suppression, per-record latency.
 - **Configuration versioning, SBOM, monthly SLA, FAT/SAT**
   (`config_versioning.py`, `sbom.py`, `sla_report.py`, `fat_sat.py`).
-- **Live protocol ports** (`live_ports.py`, `wits0.py`, `witsml.py`, `opcua_port.py`,
+- **Live protocol ports** (`live_ports.py`, `wits0.py`, `witsml.py`, `etp.py`, `opcua_port.py`,
   `mqtt_port.py`, `modbus.py`): WITS Level 0 from the drill floor (TCP connect,
   TCP listen, serial), WITSML 1.4.1 stores (read-only, polled), OPC UA (read and
   subscribe), MQTT (number, JSON, Sparkplug B), Modbus TCP; every message becomes
@@ -86,7 +86,7 @@ gea dashboard --catalog-well volve_f12_f14_production_excerpt:15/9-F-12:10000 --
 gea client-report --report accuracy --out client_report
 gea model-cards --out model_cards
 gea sbom --out sbom
-gea accept                     # the product gate (330 checks)
+gea accept                     # the product gate (337 checks)
 gea help drift                 # the help library, by the job (16 pages; the same text is on every dashboard page)
 gea guide                      # the click-by-click tester guide (docs/TESTER_GUIDE.md)
 gea gui                        # the desktop window (pip install "gea-program[desktop]")
@@ -104,7 +104,7 @@ gea swaps / gea certificates / gea notify / gea housekeeping / gea loadtest   #
 
 ## Live data
 
-The engine reads live data through five protocol ports. All are **read-only**,
+The engine reads live data through six protocol ports. All are **read-only**,
 all map only what the site declares (a tag map the client owns; an empty map
 is declined), and all write every received message to a JSON-lines recording
 that `--replay` turns back into records without a connection - which is how a
@@ -117,6 +117,9 @@ gea wits0-sim --port 5001                             # a WITS0 sender to rehear
 gea wits0  --config wits0.json --seconds 60 --record floor/session.jsonl --out floor --stream-csv floor/stream.csv   # in the first window, while the sender runs
 gea witsml --write-example-config witsml.json         # a WITSML 1.4.1 store: url, uids, mnemonics -> tags; credentials by env name
 gea witsml --config witsml.json --seconds 60 --out store                 # needs a real store: the example url is a placeholder until you edit it
+gea etp    --write-example-config etp.json            # a WITSML 2.x store over ETP v1.2: ws:// or wss:// url, bearer token by env name, channel URIs -> tags, units
+gea etp-sim --port 9800                               # an ETP store with two channels to rehearse with - run it in a SECOND window and leave it running
+gea etp    --config etp.json --seconds 60 --record rig/session.jsonl --out rig   # subscribes; the store pushes every value as it is written
 gea opcua  --write-example-config opcua.json          # edit: endpoint, security, credential env names, nodes
 gea opcua  --config opcua.json --seconds 60 --record opc/session.jsonl --out opc --stream-csv opc/stream.csv   # needs a real OPC UA server, likewise
 gea mqtt   --write-example-config mqtt.json           # edit: broker, TLS, credential env names, topics
@@ -128,6 +131,7 @@ gea ingest --file floor/stream.csv                    # a stream CSV feeds the h
 |---|---|---|---|
 | `wits0` | WITS Level 0 frames (`&&` ... `!!`, four-digit item codes) over TCP connect, TCP listen or serial; record-01 dictionary built in | numeric GOOD; sentinels (-9999, -999.25) and non-numeric -> GAP with the reason | items 0105/0106 (date, time) when present, else arrival; ingest at arrival |
 | `witsml` | WITSML 1.4.1 SOAP store: GetVersion, GetCap, GetFromStore on one log object, rows newer than the last seen at each poll | numeric GOOD; the store's nullValue and empty fields -> GAP | the index curve of a time log; arrival for a depth log |
+| `etp` | Energistics ETP v1.2 over WebSocket (`etp12.energistics.org`, Avro binary to the published schemas): RequestSession/OpenSession, GetChannelMetadata for the declared URIs, SubscribeChannels, ChannelData pushed by the store (Protocol 21) | numeric GOOD; a non-numeric or null value -> BAD with the reason; a channel the map does not name is counted unmapped | the store's own index: an ETP DateTime index is microseconds since the epoch; an ElapsedTime index is seconds from its declared start; a depth index leaves the arrival time standing, named |
 | `opcua` | opc.tcp, read + subscribe; Basic256Sha256 SignAndEncrypt when a certificate and key are given | StatusCode severity bits: Good -> GOOD, Uncertain -> STALE, Bad -> GAP (value withheld) | source timestamp, else server timestamp, else arrival |
 | `mqtt` | MQTT v5 / v3.1.1, TLS optional, QoS per topic; `+`/`#` wildcards | number: GOOD or GAP; JSON: value/time/quality paths; Sparkplug B: `is_null` -> GAP, `Quality` != 192 -> STALE | JSON time path, Sparkplug metric timestamp, else arrival |
 | `modbus_g6` | Modbus TCP, user-supplied register map with a citation | read failures -> GAP | arrival |
@@ -580,6 +584,50 @@ promoted; the group and the support are declarations; a matched frequency
 is not a fault size. CSV or miniSEED/SAC; `gea vibration` runs the labelled
 pump; `gea help vibration`.
 
+### WITSML 2.x over ETP
+
+The newer rigs and stores do not poll: Energistics ETP v1.2 is a WebSocket
+session, Avro-encoded to the published schemas, on which the customer names
+the channels it wants and the store pushes every value as it is written.
+`gea/etp.py` is that customer: the handshake with the subprotocol, the
+binary encoding and the payload limits; RequestSession for Discovery, Store
+and ChannelSubscribe and what the store answered; the channel metadata for
+the URIs the mapping declares (a URI the store does not have is named as
+missing); the subscription; and each ChannelData DataItem as a record under
+the mapping's tag and unit, with the store's own index as the source time -
+microseconds since the epoch for a DateTime index, seconds from the declared
+start for ElapsedTime, the arrival time standing (and named) for a depth
+index - and the arrival as the ingest time, so the latency is per record.
+Client message ids even, the store's odd; a ProtocolException carried with
+its code; a client or a store without the subprotocol refused at the
+handshake. The patch supervisor runs it like every other port; the page
+offers it; `gea etp-sim` is a store with two channels of a synthetic
+disposal well; `gea etp --selftest` runs the codec and a loopback session;
+`gea help etp`. The doctor now also names a panel started through the
+`gea.exe` launcher, which pip cannot replace while it runs - stop, update,
+start with `python -m gea serve`.
+
+### Conformity, in the standards' words
+
+The drift report's "bias inside the instrument's class" is a statement of
+conformity, and ISO/IEC 17025:2017 7.8.6 says what one carries: the result it
+applies to, the specification, and the decision rule - which has to take
+the uncertainty into account. The report now states it that way: the tag's
+bias over the window with its sample count, the certificate's accuracy
+class as the tolerance limit, the bias's expanded uncertainty (k = 2) as the
+guard band, and the ILAC-G8:09/2019 non-binary rule - PASS, CONDITIONAL
+PASS, CONDITIONAL FAIL or FAIL, with the acceptance limit printed; without
+an uncertainty it falls back to simple acceptance and says so. The
+certificate register takes what 7.8.4 asks the paper to carry (the expanded
+uncertainty with k and probability, the traceability statement as worded,
+the conditions, the calibration date, the method, who authorised it) and
+`gea certificates --action conformance` prints each certificate against
+the fourteen items of 7.8.2.1 and 7.8.4.1 - CARRIED, NOT CARRIED, NOT
+RECORDED - with COMPLETE or INCOMPLETE and the missing clauses named. The
+well page's filing form takes the items and its table shows U (k) and the
+standing. `gea conformance --action decide` states one decision. `gea help
+conformance`.
+
 ### Audit / Update
 
 The Audit / Update tab holds three things. The whole audit log

{gea_program-0.14.0 → gea_program-0.16.0}/gea/__init__.py

@@ -87,6 +87,7 @@ from .opcua_port import ASYNCUA_AVAILABLE, OpcUaTap          # registers the 'op
 from .mqtt_port import PAHO_AVAILABLE, MqttTap                # registers the 'mqtt' port at import
 from .wits0 import Wits0Tap, SERIAL_AVAILABLE                  # registers the 'wits0' port at import
 from .witsml import WitsmlTap                                  # registers the 'witsml' port at import
+from .etp import EtpTap                                        # registers the 'etp' port at import (WITSML 2.x over ETP v1.2)
 from .well_assembler import (
     WellAssembly, WellComponent, assemble, assemble_ktb_hb, assemble_odp_504b,
     assemble_site_1027, assemble_u1324, BUILTIN_ASSEMBLIES,
@@ -122,7 +123,7 @@ from .profile_catalog import (
     read_pangaea_txt,
 )
 
-__version__ = "0.14.0"
+__version__ = "0.16.0"
 __all__ = [
     "aging_rate", "rate_psi_yr", "accuracy_psi",
     "Sensor", "SimulatorConfig", "DownholeEngine",

{gea_program-0.14.0 → gea_program-0.16.0}/gea/__main__.py

@@ -265,7 +265,8 @@ def main(argv=None) -> int:
     for name, helptxt in (("opcua", "OPC UA client port: read once or subscribe; record; replay a recording offline"),
                           ("mqtt", "MQTT subscriber port (3.1.1/5.0; number | json | Sparkplug B): run; record; replay offline"),
                           ("wits0", "WITS Level 0 port (drill floor: mud logger / EDR) over TCP connect, TCP listen or serial: run; record; replay offline"),
-                          ("witsml", "WITSML 1.4.1 read-only client: poll a log object from the store; record; replay offline")):
+                          ("witsml", "WITSML 1.4.1 read-only client: poll a log object from the store; record; replay offline"),
+                          ("etp", "WITSML 2.x over Energistics ETP v1.2 (WebSocket, Avro): subscribe to channels and the store pushes; record; replay the session's shape")):
         p_lp = sub.add_parser(name, help=helptxt)
         p_lp.add_argument("--config", type=str, default=None, help="site map JSON (client-owned)")
         p_lp.add_argument("--write-example-config", type=str, default=None, help="write an example map here and exit")
@@ -275,6 +276,7 @@ def main(argv=None) -> int:
         p_lp.add_argument("--read-once", action="store_true", help="opcua: one Read of all nodes instead of a subscription")
         p_lp.add_argument("--out", type=str, default=None, help="write the records CSV here")
         p_lp.add_argument("--stream-csv", type=str, default=None, help="also write a historian-style CSV the other commands ingest")
+        p_lp.add_argument("--selftest", action="store_true", help="etp: the codec round-trip and a session against the simulated store on the loopback")
 
     p_ws = sub.add_parser("workspace", help="the client site folder: init, add wells (file | catalogue | live), list, migrate a --out folder, refresh the dashboard, audit log")
     p_ws.add_argument("--path", type=str, required=True, help="the workspace folder")
@@ -400,6 +402,11 @@ def main(argv=None) -> int:
     p_us.add_argument("--password-env", type=str, default="GEA_PASSWORD", help="environment variable holding the password (never a flag, never on the command line)")
     p_us.add_argument("--actor", type=str, default="cli")
 
+    p_es = sub.add_parser("etp-sim", help="an ETP v1.2 store for testing a patch without a rig: two channels of a synthetic disposal well, pushed as a customer subscribes")
+    p_es.add_argument("--port", type=int, default=9800)
+    p_es.add_argument("--frames", type=int, default=600)
+    p_es.add_argument("--interval", type=float, default=1.0, help="seconds between samples")
+    p_es.add_argument("--seed", type=int, default=1)
     p_w0 = sub.add_parser("wits0-sim", help="a WITS0 sender for testing a patch without a rig: listens once, then streams a deterministic drilling sequence")
     p_w0.add_argument("--port", type=int, default=5001)
     p_w0.add_argument("--frames", type=int, default=600)
@@ -409,6 +416,14 @@ def main(argv=None) -> int:
 
     p_osdu = sub.add_parser("osdu", help="the OSDU-shaped export: the self-test on a labelled site")
     p_osdu.add_argument("--action", choices=["selftest"], default="selftest")
+    p_cf = sub.add_parser("conformance", help="ISO/IEC 17025 7.8 certificate items and the ILAC-G8 decision rules: the self-test, or one decision")
+    p_cf.add_argument("--action", choices=["selftest", "decide"], default="selftest")
+    p_cf.add_argument("--value", type=float, default=None, help="decide: the measured value (a deviation; the tolerance is symmetric)")
+    p_cf.add_argument("--tolerance", type=float, default=None, help="decide: the tolerance limit TL")
+    p_cf.add_argument("--uncertainty", type=float, default=None, help="decide: the expanded uncertainty U of the value (omit: simple acceptance)")
+    p_cf.add_argument("--k", type=float, default=2.0)
+    p_cf.add_argument("--rule", choices=["simple-acceptance", "binary-guard-band", "non-binary-guard-band"], default="non-binary-guard-band")
+    p_cf.add_argument("--unit", type=str, default="")
     p_vib = sub.add_parser("vibration", help="machine vibration: ISO 20816-3 zone and bearing envelope analysis on a record, or the self-test")
     p_vib.add_argument("--action", choices=["selftest", "assess"], default="selftest")
     p_vib.add_argument("--record", type=str, default=None, help="assess: the record (CSV with a time column, or miniSEED/SAC)")
@@ -522,7 +537,7 @@ def main(argv=None) -> int:
 
     p_ce = sub.add_parser("certificates", help="calibration certificates per instrument: list, file one, status against today")
     p_ce.add_argument("--register", type=str, required=True, help="the well's certificates.jsonl")
-    p_ce.add_argument("--action", choices=["list", "add", "status"], default="list")
+    p_ce.add_argument("--action", choices=["list", "add", "status", "conformance"], default="list")
     p_ce.add_argument("--tag", type=str, default=None)
     p_ce.add_argument("--tags", type=str, default=None, help="comma-separated tags for --action status")
     p_ce.add_argument("--serial", type=str, default="")
@@ -536,6 +551,17 @@ def main(argv=None) -> int:
     p_ce.add_argument("--doc", type=str, default=None, help="the certificate file (hashed, not copied)")
     p_ce.add_argument("--note", type=str, default="")
     p_ce.add_argument("--actor", type=str, default="cli")
+    p_ce.add_argument("--calibrated", type=str, default="", help="ISO/IEC 17025 7.8.2.1 i: the date the calibration was performed")
+    p_ce.add_argument("--method", type=str, default="", help="7.8.2.1 f: the method used")
+    p_ce.add_argument("--authorised-by", type=str, default="", help="7.8.2.1 o: who authorised the certificate")
+    p_ce.add_argument("--uncertainty", type=float, default=None, help="7.8.4.1 a: the expanded uncertainty U, in --uncertainty-unit (default the result's unit)")
+    p_ce.add_argument("--uncertainty-unit", type=str, default="")
+    p_ce.add_argument("--k", type=float, default=None, help="7.8.4.1 a: the coverage factor U is stated at")
+    p_ce.add_argument("--probability", type=float, default=None, help="7.8.4.1 a: the coverage probability as a fraction (0.95)")
+    p_ce.add_argument("--conditions", type=str, default="", help="7.8.4.1 b: the conditions the calibration was made under")
+    p_ce.add_argument("--traceability", type=str, default="", help="7.8.4.1 c: the statement of metrological traceability, as the certificate words it")
+    p_ce.add_argument("--adjustment", type=str, default="", help="7.8.4.1 d: results before and after adjustment, if the certificate carries them")
+    p_ce.add_argument("--decision-rule", type=str, default="", help="7.8.6: the decision rule the certificate's conformity statement names, if any")
 
     p_tr = sub.add_parser("transient", help="shut-in detection and build-up analysis (Horner + Bourdet derivative with a bootstrap band)")
     p_tr.add_argument("--file", type=str, required=True, help="historian file")
@@ -773,7 +799,10 @@ def main(argv=None) -> int:
         if a.action == "add":
             try:
                 print(_json.dumps(reg.add(a.tag or "", a.serial, a.certificate, a.issued or "", a.valid_until or "", a.actor, a.lab,
-                                          a.accuracy_pct_fs, a.full_scale, a.unit, a.doc, a.note), indent=1))
+                                          a.accuracy_pct_fs, a.full_scale, a.unit, a.doc, a.note,
+                                          calibrated_utc=a.calibrated, method=a.method, authorised_by=a.authorised_by, uncertainty=a.uncertainty,
+                                          uncertainty_unit=a.uncertainty_unit, uncertainty_k=a.k, uncertainty_probability=a.probability,
+                                          conditions=a.conditions, traceability=a.traceability, adjustment=a.adjustment, decision_rule=a.decision_rule), indent=1))
             except (ValueError, TypeError) as e:
                 raise SystemExit(f"certificates: {e}")
             return 0
@@ -784,6 +813,13 @@ def main(argv=None) -> int:
                 print(f"{r['tag_id']:24s} {r['status']:9s} {r.get('certificate_id') or '-':16s} until {r.get('valid_until_utc') or '-'}  {('' if r['days_left'] is None else str(r['days_left']) + ' d')}")
             print(_json.dumps(CertificateRegister.summary(rows)))
             return 0 if CertificateRegister.summary(rows)['all_valid'] else 1
+        if a.action == "conformance":
+            from .conformance import report_lines
+            c = reg.conformance()
+            for r in c["rows"]:
+                print("\n".join(report_lines(r)))
+            print(f"certificates: {c['n']} filed, {c['complete']} COMPLETE against ISO/IEC 17025:2017 7.8" + (f"; incomplete: {', '.join(c['incomplete'])}" if c['incomplete'] else ''))
+            return 0 if not c["incomplete"] else 1
         for e in reg.list():
             print(f"{e['tag_id']:24s} {e['serial']:12s} {e['certificate_id']:16s} {e['issued_utc'][:10]} to {e['valid_until_utc'][:10]}  ±{e.get('accuracy_pct_fs') or '-'} % FS  {e.get('lab', '')}")
         print(f"certificates: {len(reg.list())} filed")
@@ -1524,6 +1560,23 @@ def main(argv=None) -> int:
             return 0
         print(f"notifications: {'configured' if n.cfg else 'not configured'}" + (f" - {len(n.cfg['channels'])} channel(s), {len(n.cfg['rules'])} rule(s), quiet {n.cfg['quiet_s']} s" if n.cfg else " (gea notify --example)"))
         return 0
+    elif a.cmd == "conformance":
+        from . import conformance as _C
+        if a.action == "decide":
+            if a.value is None or a.tolerance is None:
+                raise SystemExit("conformance --action decide needs --value and --tolerance")
+            d = _C.decide(a.value, a.tolerance, a.uncertainty, rule=a.rule, k=a.k if a.uncertainty is not None else None,
+                          probability=(0.95 if abs(a.k - 2.0) < 1e-9 else None) if a.uncertainty is not None else None, unit=a.unit)
+            print(d["statement"]); print(f"  {d['rule_text']}")
+            return 0 if d["outcome"] in ("PASS", "CONDITIONAL PASS") else 1
+        r = _C.selftest()
+        print(f"conformance selftest [{r['label']}]: {r['status']}")
+        for k, v in r["checks"].items():
+            print(f"  {'ok ' if v else 'BAD'} {k}")
+        print("\n".join(_C.report_lines(r["full"])))
+        for d in r["decisions"]:
+            print("  " + d["statement"])
+        return 0 if r["status"] == "OK" else 1
     elif a.cmd == "vibration":
         from . import vibration as _V
         if a.action == "assess":
@@ -1920,10 +1973,30 @@ def main(argv=None) -> int:
             stop.set()
             print("wits0-sim: stopped")
         return 0
-    elif a.cmd in ("opcua", "mqtt", "wits0", "witsml"):
+    elif a.cmd == "etp-sim":
+        from . import etp as _E
+        th, port, stop = _E.simulate_store(port=a.port, frames=a.frames, interval_s=a.interval, seed=a.seed, verbose=True)
+        print(f"etp-sim: an ETP v1.2 store listening on ws://127.0.0.1:{port}/ - this window is the STORE and stays here; nothing happens until a customer connects.\n"
+              f"  Open a SECOND window and run:  gea etp --config etp.json --seconds 60 --out floor   (with etp.json: url ws://127.0.0.1:{port}/ and the two example channel URIs)\n"
+              f"  or on the dashboard: Patch panel -> Add a patch -> etp, url ws://127.0.0.1:{port}/. Then it pushes {a.frames} samples per channel {a.interval:g} s apart. Ctrl+C stops it.", flush=True)
+        try:
+            while th.is_alive():
+                th.join(0.5)
+        except KeyboardInterrupt:
+            stop.set()
+            print("etp-sim: stopped")
+        return 0
+    elif a.cmd in ("opcua", "mqtt", "wits0", "witsml", "etp"):
         import json as _json
         from .live_ports import records_to_stream, summarize, write_records_csv
-        mod = __import__({"opcua": "gea.opcua_port", "mqtt": "gea.mqtt_port", "wits0": "gea.wits0", "witsml": "gea.witsml"}[a.cmd], fromlist=["x"])
+        mod = __import__({"opcua": "gea.opcua_port", "mqtt": "gea.mqtt_port", "wits0": "gea.wits0", "witsml": "gea.witsml", "etp": "gea.etp"}[a.cmd], fromlist=["x"])
+        if a.cmd == "etp" and getattr(a, "selftest", False):
+            r = mod.selftest()
+            print(f"etp selftest [{r['label']}]: {r['status']}")
+            for k, v in r["checks"].items():
+                print(f"  {'ok ' if v else 'BAD'} {k}")
+            print(f"  {r['n_records']} record(s) on {r['tags']}; store {r['store'].get('application')} protocols {r['store'].get('protocols')}; counts {r['counts']}")
+            return 0 if r["status"] == "OK" else 1
         if a.write_example_config:
             print("config:", mod.write_example_config(a.write_example_config))
             return 0
@@ -1948,6 +2021,11 @@ def main(argv=None) -> int:
                 tap = mod.Wits0Tap(a.config, recording_path=a.record)
                 recs = tap.run(a.seconds)
                 src = f"{tap.cfg['transport']} {tap.cfg.get('host') or tap.cfg.get('device') or ('listen:' + str(tap.cfg.get('listen_port')))}"
+            elif a.cmd == "etp":
+                tap = mod.EtpTap(a.config, recording_path=a.record)
+                recs = tap.run(a.seconds)
+                src = tap.cfg["url"] + (f"  (store: {tap.state.get('store', {}).get('application')}, {tap.state.get('channels')} channel(s) subscribed"
+                                        + (f", missing {tap.state.get('missing_uris')}" if tap.state.get('missing_uris') else '') + ')')
             else:
                 tap = mod.WitsmlTap(a.config, recording_path=a.record)
                 recs = tap.run(a.seconds)
@@ -1955,11 +2033,17 @@ def main(argv=None) -> int:
         except (NotImplementedError, ConnectionError, ValueError) as e:
             hint = {"wits0": "nothing is sending on that host:port - start `gea wits0-sim --port 5001` in a SECOND window first (it must be running while this reads), or point the config at the rig's real WITS0 feed",
                     "witsml": "no WITSML store answers at that url - the example config points at 127.0.0.1:8000, a placeholder; put the real store's url, uids and credential env names in it",
+                    "etp": "no ETP store answers at that url - start `gea etp-sim --port 9800` in a SECOND window first, or point the config at the rig's ETP endpoint (wss://...) with the channel URIs it publishes",
                     "opcua": "no OPC UA server answers at that endpoint - the example config is a placeholder; put the real server's endpoint, security and node ids in it",
                     "mqtt": "no MQTT broker answers at that host:port - the example config is a placeholder; put the real broker in it"}.get(a.cmd, "")
             raise SystemExit(f"{a.cmd}: {e}" + (f"\n  {hint}" if hint else ""))          # the reason and what to do, without a traceback
         print(f"{a.cmd}: {src}")
-        print(_json.dumps(summarize(recs), indent=1))
+        if a.cmd == "etp" and a.replay:
+            shape = getattr(mod.replay, "summary", {})
+            print(_json.dumps({"session_shape": shape, "records": 0,
+                               "note": "an ETP recording holds the messages as received with ChannelData as counts (the samples went to --out); the replay reproduces the session's shape, not the samples"}, indent=1))
+        else:
+            print(_json.dumps(summarize(recs), indent=1))
         if a.out:
             print("  records:", write_records_csv(recs, a.out))
         if a.stream_csv and recs: