gea-program 0.10.0__tar.gz → 0.11.0__tar.gz

{gea_program-0.10.0 → gea_program-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gea-program
-Version: 0.10.0
+Version: 0.11.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
@@ -125,12 +125,12 @@ 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 (314 checks)
+gea accept                     # the product gate (320 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]")
 gea workspace --path C:\site --action init --name "Pad 3"     # a site folder
-gea serve --workspace C:\site                                 # the dashboard as the door: http://127.0.0.1:8765/
+gea serve --workspace C:\site                                 # the dashboard as the door: opens http://127.0.0.1:8765/ in your browser
 gea doctor --workspace C:\site                                # which code runs, can it serve, with every fix
 gea files --workspace C:\site --action list --root historian  # the import roots, detection by content, import, export, packs
 gea transient --file historian.csv --params params.json --out pta   # shut-ins and build-up analysis with a band
@@ -551,6 +551,21 @@ and a daily export under the Notice's own parameter names. It will not
 invent a volume for a well with no rate channel, a tier from depth alone, or
 an aftershock: those are declarations, and the packet says so.
 
+### The OSDU-shaped export
+
+What a buyer's data team asks for on the first call. `gea workspace --action
+osdu-export --site <id> --partition ... --acl-owner ... --acl-viewer ...
+--legal-tag ...` writes the site as an `osdu:wks:Manifest:1.0.0` to the
+published well-known schemas: each well as Well and Wellbore 1.0.0 with its
+API and UIC as name aliases, its record as a WellLog 1.1.0 in the time
+domain over a File.Generic dataset with the file's SHA-256, each seismic
+station as a generic component with its records as datasets, the site as the
+work product, the files copied beside it. Every position goes out twice - as
+given on its own datum with that datum's EPSG code, and on WGS 84 with the
+operation between them written out; a point on an unknown datum gets no WGS
+84 coordinates and is named. Without the operator's partition, ACL and legal
+tag the manifest is NOT LOADABLE and says so. `gea help osdu`.
+
 ### Audit / Update
 
 The Audit / Update tab holds three things. The whole audit log

{gea_program-0.10.0 → gea_program-0.11.0}/README.md

@@ -86,12 +86,12 @@ 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 (314 checks)
+gea accept                     # the product gate (320 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]")
 gea workspace --path C:\site --action init --name "Pad 3"     # a site folder
-gea serve --workspace C:\site                                 # the dashboard as the door: http://127.0.0.1:8765/
+gea serve --workspace C:\site                                 # the dashboard as the door: opens http://127.0.0.1:8765/ in your browser
 gea doctor --workspace C:\site                                # which code runs, can it serve, with every fix
 gea files --workspace C:\site --action list --root historian  # the import roots, detection by content, import, export, packs
 gea transient --file historian.csv --params params.json --out pta   # shut-ins and build-up analysis with a band
@@ -512,6 +512,21 @@ and a daily export under the Notice's own parameter names. It will not
 invent a volume for a well with no rate channel, a tier from depth alone, or
 an aftershock: those are declarations, and the packet says so.
 
+### The OSDU-shaped export
+
+What a buyer's data team asks for on the first call. `gea workspace --action
+osdu-export --site <id> --partition ... --acl-owner ... --acl-viewer ...
+--legal-tag ...` writes the site as an `osdu:wks:Manifest:1.0.0` to the
+published well-known schemas: each well as Well and Wellbore 1.0.0 with its
+API and UIC as name aliases, its record as a WellLog 1.1.0 in the time
+domain over a File.Generic dataset with the file's SHA-256, each seismic
+station as a generic component with its records as datasets, the site as the
+work product, the files copied beside it. Every position goes out twice - as
+given on its own datum with that datum's EPSG code, and on WGS 84 with the
+operation between them written out; a point on an unknown datum gets no WGS
+84 coordinates and is named. Without the operator's partition, ACL and legal
+tag the manifest is NOT LOADABLE and says so. `gea help osdu`.
+
 ### Audit / Update
 
 The Audit / Update tab holds three things. The whole audit log

{gea_program-0.10.0 → gea_program-0.11.0}/gea/__init__.py

@@ -122,7 +122,7 @@ from .profile_catalog import (
     read_pangaea_txt,
 )
 
-__version__ = "0.10.0"
+__version__ = "0.11.0"
 __all__ = [
     "aging_rate", "rate_psi_yr", "accuracy_psi",
     "Sensor", "SimulatorConfig", "DownholeEngine",

{gea_program-0.10.0 → gea_program-0.11.0}/gea/__main__.py

@@ -282,7 +282,7 @@ def main(argv=None) -> int:
                       choices=["init", "add-file", "add-catalog", "add-live", "remove", "list", "migrate", "refresh", "audit",
                                "add-seismic", "refresh-seismic", "remove-seismic", "sar-film", "refresh-all", "add-track", "refresh-track", "remove-track",
                                "seismic-dataset", "seismic-field", "add-site", "sites", "site-report", "remove-site", "rename",
-                               "set-well", "sra-define", "sra-report", "associate"])
+                               "set-well", "sra-define", "sra-report", "associate", "osdu-export"])
     p_ws.add_argument("--stations", type=str, nargs="+", default=None, help="add-track: two or more array station ids of this workspace")
     p_ws.add_argument("--site", type=str, default=None, help="site-report/remove-site: the site id")
     p_ws.add_argument("--api", type=str, default=None, help="set-well: the API number")
@@ -309,6 +309,13 @@ def main(argv=None) -> int:
     p_ws.add_argument("--start", type=str, default=None, help="sra-report: first day of the record, YYYY-MM-DD")
     p_ws.add_argument("--end", type=str, default=None, help="sra-report: last day of the record, YYYY-MM-DD")
     p_ws.add_argument("--vp", type=float, default=5.8, help="associate: the P velocity of the model, km/s (declared)")
+    p_ws.add_argument("--partition", type=str, default="", help="osdu-export: the platform's data partition id (declared)")
+    p_ws.add_argument("--acl-owner", type=str, nargs="*", default=None, help="osdu-export: ACL owners group(s)")
+    p_ws.add_argument("--acl-viewer", type=str, nargs="*", default=None, help="osdu-export: ACL viewers group(s)")
+    p_ws.add_argument("--legal-tag", type=str, nargs="*", default=None, help="osdu-export: legal tag(s)")
+    p_ws.add_argument("--country", type=str, nargs="*", default=None, help="osdu-export: otherRelevantDataCountries (default US)")
+    p_ws.add_argument("--operator-org", type=str, default="", help="osdu-export: the operator's Organisation record id on the platform")
+    p_ws.add_argument("--out", type=str, default=None, help="osdu-export: the folder to write the manifest and files into")
     p_ws.add_argument("--depth-km", type=float, default=6.0, help="associate: the hypocentral depth the location is made under, km (declared)")
     p_ws.add_argument("--rms-tol", type=float, default=0.15, help="associate: the RMS residual an event must fit within, s")
     p_ws.add_argument("--wells", type=str, nargs="+", default=None, help="add-site: well ids of this workspace")
@@ -355,6 +362,7 @@ def main(argv=None) -> int:
     p_sv.add_argument("--workers", type=int, default=1, help="jobs run at once")
     p_sv.add_argument("--no-scheduler", action="store_true", help="do not run scheduled jobs from this process")
     p_sv.add_argument("--behind-proxy", action="store_true", help="a reverse proxy terminates TLS in front: trust X-Forwarded-For/-Proto, mark the cookie Secure (deploy/ has nginx and Caddy examples)")
+    p_sv.add_argument("--no-browser", action="store_true", help="do not open the control panel in a browser once the service is listening (a scheduled start, a restart, a server with no desktop)")
 
     p_hk = sub.add_parser("housekeeping", help="rotate the append-only logs, prune finished job folders and old live recordings (dry run unless --apply)")
     p_hk.add_argument("--workspace", type=str, required=True)
@@ -389,6 +397,8 @@ def main(argv=None) -> int:
     p_w0.add_argument("--seed", type=int, default=1)
     p_w0.add_argument("--connect", type=str, default=None, help="host:port - instead of listening, connect to a listening tap and push frames")
 
+    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_sra = sub.add_parser("sra", help="the Seismicity Response Area packet: the self-test on a labelled scene")
     p_sra.add_argument("--action", choices=["selftest"], default="selftest")
     p_sra.add_argument("--json", action="store_true")
@@ -1486,6 +1496,14 @@ 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 == "osdu":
+        from . import osdu as _O
+        r = _O.selftest()
+        print(f"osdu selftest [{r['label']}]: {r['status']}")
+        for k, v in r["checks"].items():
+            print(f"  {'ok ' if v else 'BAD'} {k}")
+        print(_O.report_text(r["summary"]))
+        return 0 if r["status"] == "OK" else 1
     elif a.cmd == "sra":
         from . import sra as _SRA
         r = _SRA.selftest()
@@ -1545,6 +1563,10 @@ def main(argv=None) -> int:
         print("   Ctrl+C stops it; every action is in records/audit.jsonl, every start and stop in records/runlog.jsonl")
         print("   the control panel's Stop and Restart end this run with a stated code: 0 stop, 86 start me again -")
         print("   the launcher reads it, and on anything but 86 it hands the window to a PowerShell prompt, never a Python one")
+        print("   this window is the server and has nothing more to load: the control panel is the page in the browser,")
+        print("   and what happens there (the page opening, sign-ins, jobs, stops and restarts) is printed below as it happens")
+        svc.console = True
+        svc.open_browser = not a.no_browser
         return svc.serve_forever()
     elif a.cmd == "users":
         import getpass
@@ -1723,6 +1745,14 @@ def main(argv=None) -> int:
                     print(f"  {sid}: {x['status']}, {x['picks']} pick(s)")
                 print(_assoc_text(r["association"], r["catalogue"]))
                 print("  written:", os.path.join(ws.path, "reports", "sites", a.site, "association.json")); return 0
+            elif a.action == "osdu-export":
+                from .osdu import report_text as _osdu_text
+                if not a.site:
+                    raise SystemExit("osdu-export needs --site <id>")
+                r = ws.osdu_export(a.site, partition=a.partition, acl_owners=a.acl_owner, acl_viewers=a.acl_viewer, legal_tags=a.legal_tag,
+                                   countries=a.country, operator_org_id=a.operator_org, out_dir=a.out, actor=a.actor)
+                print(_osdu_text(r)); v = r["validate"]
+                print(f"  structure: {'ok' if v['ok'] else 'PROBLEMS'} ({v['records']} record(s))" + ('' if v['ok'] else '; ' + '; '.join(v['problems'][:5]))); return 0
             elif a.action == "seismic-dataset":
                 r = ws.write_seismic_dataset_report(actor=a.actor)
                 inv = r["inventory"]

{gea_program-0.10.0 → gea_program-0.11.0}/gea/acceptance_tests.py

@@ -3390,12 +3390,13 @@ def section_aq_sar_and_audit(tmp: str) -> None:
     # AQ4 - the page and the help
     page_src = (pkg / "web" / "app.html").read_text(encoding="utf-8")
     ok("function sarPanelHtml" in page_src and "function sarDraw" in page_src and "id=\"sarScreen\"" in page_src and "/api/seismic/sar/run" in page_src
+       and "VIEWS.sar = " in page_src and "['#/sar', 'SAR panel']" in page_src and H.VIEW_TOPIC.get("sar") == "seismic"
        and "SIMULATION_SELF_TEST" in page_src and "film.label" in page_src and "not a measurement of any ground" in page_src
        and "VIEWS.audit = " in page_src and "['#/audit', 'Audit / Update']" in page_src and "/api/update/program" in page_src and "/api/update/data" in page_src
        and "Download CSV" in page_src and 'href="#/audit"' in page_src.split("VIEWS.admin = ")[1].split("VIEWS.")[0]
        and H.VIEW_TOPIC.get("audit") == "audit-update" and any(t["topic"] == "audit-update" for t in H.topics()) and not H.check("audit-update")
        and "sar-film" in (pkg / "help" / "seismic.md").read_text(encoding="utf-8") and "never a film" in (pkg / "help" / "seismic.md").read_text(encoding="utf-8"),
-       "AQ4 the Seismic page carries the SAR panel (the controls, Run the scene as a job, Play/Pause/Stop/speed/scrub, the four-pane screen with the stamp on every frame); "
+       "AQ4 the Seismic page carries the SAR panel (the controls, Run the scene as a job, Play/Pause/Stop/speed/scrub, the four-pane screen with the stamp on every frame) and the panel has a page and a navigation entry of its own, because at the foot of the Seismic page it was reported as nowhere to be found; "
        "the Audit / Update view has the program card, the data card with its two jobs, the audit log with filters and a CSV; Administration points at it; the help index "
        "has the audit-update page, the view maps to it, and the seismic page names the film and what it is not")
 
@@ -4593,6 +4594,55 @@ def section_bb_supervisor(tmp: str) -> None:
        "BB11 an authorised restart is logged before the server is touched, stops the run and leaves 86 as the code the launcher reads; the control "
        "panel's own page carries the Stop and Restart controls, the authorisation step behind a popup, and the auto-restart switch")
 
+    # -- the console answers (0.11.0) -------------------------------------------------------
+    # a server that answers in silence looks, from the window it was started in, exactly like one that is
+    # still loading. An operator waited hours at a console that had been serving the page all along.
+    svc2 = Service(wsp, host="127.0.0.1", port=0, scheduler=False)
+    lines: list = []
+    svc2._console_line = lambda m: lines.append(m)
+    svc2.console = True
+    svc2.open_browser = False
+    base2 = svc2.url.rstrip("/")
+    th2 = _th.Thread(target=svc2.serve_forever, daemon=True); th2.start()
+    time.sleep(0.6)
+    cj2 = http.cookiejar.CookieJar(); opener2 = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(cj2))
+
+    def call2(method, path, body=None):
+        req = urllib.request.Request(base2 + path, method=method, data=(json.dumps(body).encode() if body is not None else None))
+        req.add_header("Content-Type", "application/json")
+        if method == "POST":
+            req.add_header("X-GEA-Action", "1")
+        try:
+            with opener2.open(req, timeout=60) as r:
+                return r.status, (json.loads(r.read()) if path.startswith("/api/") else r.read())
+        except urllib.error.HTTPError as e:
+            return e.code, json.loads(e.read())
+
+    call2("GET", "/"); call2("GET", "/")                   # the second fetch from the same address is not a second line
+    call2("POST", "/api/login", {"name": "adm", "password": "wrong-pass-999"})
+    call2("POST", "/api/login", {"name": "adm", "password": "admin-pass-123"})
+    call2("POST", "/api/control/restart", {"authorize": True})
+    th2.join(timeout=30)
+    joined = "\n".join(lines)
+    ok(svc2.ws.on_audit is not None and svc2.app.console is not None
+       and sum(1 for m in lines if m.startswith("listening at")) == 1
+       and sum(1 for m in lines if m.startswith("control panel opened in a browser")) == 1
+       and "sign-in refused for 'adm'" in joined and "signed in: adm (admin)" in joined
+       and "restart requested by adm" in joined and not th2.is_alive(),
+       "BB12 the serving console says what happens as it happens - the page being opened (once per address), a sign-in refused, a sign-in, a "
+       "stop or restart requested - because a server that answers in silence looks, from the window it was started in, like one that is still "
+       "loading; the audit file is written first and the console line is only a courtesy to whoever is watching")
+    main_src = (pkg / "__main__.py").read_text(encoding="utf-8")
+    ok('"--no-browser", action="store_true"' in main_src
+       and "svc.open_browser = not a.no_browser" in main_src and "svc.console = True" in main_src
+       and hasattr(Service, "_open_browser_later") and Service(wsp, host="127.0.0.1", port=0, scheduler=False).open_browser is False
+       and (cmd is None or ("%GEA_BROWSER%" in cmd and "timeout /t 4" not in cmd and 'if "%1"=="--no-browser" set GEA_BROWSER=--no-browser' in cmd
+                            and "set GEA_BROWSER=--no-browser" in cmd))
+       and (sh is None or ("$browser" in sh and 'browser="--no-browser"' in sh)),
+       "BB13 `gea serve` opens the control panel in the browser itself once its port is listening, and the launchers no longer race it with a "
+       "browser of their own - opened first, it showed a failure page from the second before the server was up; a scheduled start passes "
+       "--no-browser through, a restart from the panel does not open a second page, and the service run in-process by this gate opens nothing")
+
 
 def section_bc_sra(tmp: str) -> None:
     """Section BC - the Seismicity Response Area packet. The Railroad Commission's operator-led response plans
@@ -4831,6 +4881,90 @@ def section_bd_association(tmp: str) -> None:
        "runs the labelled scene from the command line")
 
 
+def section_be_osdu(tmp: str) -> None:
+    """Section BE - the OSDU-shaped export: the manifest a large operator's data platform loads, built to the
+    published well-known schemas from what the site holds, with both coordinate sets on every position,
+    the operator's declarations required rather than filled in, and every gap named."""
+    import csv as _csv
+    import subprocess as _sp
+    from datetime import datetime as _dt, timedelta as _td, timezone as _tz
+    from . import osdu as O
+    from .workspace import Workspace
+    d = Path(tmp, "be"); d.mkdir()
+
+    r = O.selftest(str(d / "self"))
+    ok(r["status"] == "OK" and all(r["checks"].values()) and r["label"] == "SIMULATION_SELF_TEST" and r["validate"]["ok"],
+       "BE1 the self-test: a Manifest 1.0.0 with Well and Wellbore 1.0.0, WellLog 1.1.0 in the time domain with a curve per channel over a "
+       "File.Generic dataset carrying the file's size and SHA-256, a seismic station as a generic component with its records as datasets; a NAD27 "
+       "position carries both coordinate sets with the 45 m shift written out; a position on an unknown datum gets no WGS 84 coordinates and is "
+       "named; a catalogue well with no file is named; the manifest validates; and without the operator's partition, ACL and legal tag it is "
+       "NOT LOADABLE with the four names listed")
+
+    # -- the position discipline, record by record ------------------------------------------
+    ctx = O.Context("opendes", ["o@x"], ["v@x"], ["tag"])
+    sl = O.spatial_location(31.96, -102.24, "NAD83", ctx)
+    sl27 = O.spatial_location(31.96, -102.24, "NAD27", ctx)
+    slu = O.spatial_location(31.96, -102.24, None, ctx)
+    w84 = sl["Wgs84Coordinates"]["features"][0]["geometry"]["coordinates"]
+    w27 = sl27["Wgs84Coordinates"]["features"][0]["geometry"]["coordinates"]
+    ok(sl["AsIngestedCoordinates"]["CoordinateReferenceSystemID"] == "opendes:reference-data--CoordinateReferenceSystem:Geographic2D:EPSG::4269:"
+       and w84 == [-102.24, 31.96] and w27 != [-102.24, 31.96] and abs(w27[0] + 102.24) < 0.001 and abs(w27[1] - 31.96) < 0.001
+       and "shift 45" in sl27["AppliedOperations"][0] and "Wgs84Coordinates" not in slu and slu["_gap"] and "unknown" in slu["AppliedOperations"][0]
+       and slu["QualitativeSpatialAccuracyTypeID"].endswith(":Unverifiable:"),
+       "BE2 every position goes out twice, as given on its own datum with the EPSG code of that datum, and on WGS 84 with the operation between "
+       "them written into AppliedOperations - NAD83 passes through unchanged, NAD27 moves 45 m and says so, and an unknown datum gets no WGS 84 "
+       "point at all, marked Unverifiable, because a platform that indexed it would place the well tens of metres wrong")
+
+    # -- the structural validation catches a broken manifest ---------------------------------
+    man = json.load(open(Path(d, "self", "osdu_full", "manifest.json"), encoding="utf-8"))
+    broken = json.loads(json.dumps(man))
+    broken["Data"]["WorkProductComponents"][0]["data"]["Datasets"] = ["surrogate-key:file-nowhere"]
+    del broken["MasterData"][0]["legal"]
+    broken["MasterData"][1]["kind"] = "Wellbore"
+    v = O.validate(broken)
+    ok(not v["ok"] and len(v["problems"]) >= 3 and any("not in this manifest" in p for p in v["problems"]) and any("no legal" in p for p in v["problems"])
+       and any("osdu:wks:" in p for p in v["problems"]),
+       "BE3 the validation makes the platform loader's first checks before the platform does: a component naming a dataset the manifest does not "
+       "carry, a record with no legal block, and a kind not in the osdu:wks:<group>--<Type>:<version> form are each named")
+
+    # -- through the workspace and the command line ------------------------------------------
+    t0 = _dt(2026, 3, 1, tzinfo=_tz.utc)
+    hist = d / "swd.csv"
+    with open(hist, "w", newline="") as f:
+        w = _csv.writer(f); w.writerow(["timestamp", "P_surf_psi", "Q_bpm"])
+        for i in range(2 * 144):
+            w.writerow([(t0 + _td(seconds=600 * i)).strftime("%Y-%m-%dT%H:%M:%SZ"), "1500.0", "5.0"])
+    ws = Workspace.create(str(d / "ws"), "Pad 3", actor="tester")
+    w1 = ws.add_well_file(str(hist), display="SWD 1", actor="tester", station_md_ft=9800.0)
+    ws.set_well(w1["id"], surface={"lat": 31.96, "lon": -102.24, "datum": "NAD27"}, disposal={"api_number": "42-329-12345", "uic_number": "123456"}, actor="tester")
+    w2 = ws.add_well_catalog("volve_f12_f14_production_excerpt", "15/9-F-12", 10000.0, actor="tester")
+    ws.add_site("OSDU block", wells=[w1["id"], w2["id"]], client="Acme", actor="tester")
+    run = lambda *a: _sp.run([sys.executable, "-m", "gea", "workspace", "--path", ws.path, "--actor", "tester", *a], capture_output=True, text=True)
+    r1 = run("--action", "osdu-export", "--site", "OSDU-block")
+    r2 = run("--action", "osdu-export", "--site", "OSDU-block", "--partition", "opendes", "--acl-owner", "data.default.owners@opendes.example.com",
+             "--acl-viewer", "data.default.viewers@opendes.example.com", "--legal-tag", "opendes-public-usa", "--operator-org", "opendes:master-data--Organisation:Acme:")
+    out = Path(ws.path, "reports", "sites", "OSDU-block", "osdu")
+    man2 = json.load(open(out / "manifest.json", encoding="utf-8"))
+    summ = json.load(open(out / "export_summary.json", encoding="utf-8"))
+    well = next(m for m in man2["MasterData"] if m["kind"] == O.KINDS["well"] and m["data"]["FacilityID"] == "42-329-12345")
+    log = next(c for c in man2["Data"]["WorkProductComponents"] if c["kind"] == O.KINDS["welllog"])
+    audit = Path(ws.path, "records", "audit.jsonl").read_text(encoding="utf-8")
+    r3 = _sp.run([sys.executable, "-m", "gea", "osdu"], capture_output=True, text=True)
+    ok(r1.returncode == 0 and "NOT LOADABLE" in r1.stdout and "--partition" in r1.stdout
+       and r2.returncode == 0 and "[LOADABLE]" in r2.stdout and "structure: ok" in r2.stdout and summ["status"] == "LOADABLE"
+       and well["legal"]["legaltags"] == ["opendes-public-usa"] and well["data"]["CurrentOperatorID"] == "opendes:master-data--Organisation:Acme:"
+       and well["data"]["VerticalMeasurements"][0]["VerticalMeasurement"] == 9800.0 and "Wgs84Coordinates" in well["data"]["SpatialLocation"]
+       and log["data"]["ZeroTime"] == "2026-03-01T00:00:00Z" and log["data"]["SamplingInterval"] == 600.0
+       and [c["Mnemonic"] for c in log["data"]["Curves"]] == ["TIME", "P_surf_psi", "Q_bpm"]
+       and (out / "files" / "wells" / w1["id"] / "swd.csv").is_file()
+       and any(w2["id"] in g and "no file" in g for g in summ["gaps"]) and "site.osdu_export" in audit
+       and r3.returncode == 0 and "SIMULATION_SELF_TEST" in r3.stdout,
+       "BE4 `--action osdu-export` writes the site's manifest and copies its files beside it: without the operator's declarations it says NOT "
+       "LOADABLE and which flags are missing; with them the well goes out as Well and Wellbore with its API and UIC, its gauge station as a "
+       "vertical measurement, its position on both datums; its record as a WellLog in the time domain over the file; a catalogue well with no "
+       "file is a named gap; the structure validates; every export is audited; `gea osdu` runs the self-test from the command line")
+
+
 def main() -> int:
     print("GEA-Program - ACCEPTANCE SUITE (the product gate)")
     # a handle a job subprocess still holds at the end must not turn a finished gate into a traceback on Windows:
@@ -4890,6 +5024,7 @@ def main() -> int:
         section_bb_supervisor(tmp)
         section_bc_sra(tmp)
         section_bd_association(tmp)
+        section_be_osdu(tmp)
     if _FAILS:
         print(f"[ACCEPTANCE] {len(_FAILS)} FAILURES ({_PASS} passed):")
         for f in _FAILS:

gea_program-0.11.0/gea/help/osdu.md

@@ -0,0 +1,13 @@
+# The OSDU-shaped export
+
+> The site as the Manifest a large operator's OSDU data platform loads, built to the published well-known schemas, with every file beside it.
+
+**The command**: `gea workspace --path C:\site --action osdu-export --site <id> --partition <partition> --acl-owner <group> --acl-viewer <group> --legal-tag <tag> [--country US] [--operator-org <partition>:master-data--Organisation:<id>:] [--out <folder>]`. The partition, the ACL groups and the legal tag are the platform's and yours; without them the manifest is still written and marked NOT LOADABLE with the missing names. `gea osdu` runs the self-test on a labelled site.
+
+**What it writes**: `reports/sites/<site>/osdu/manifest.json` - `osdu:wks:Manifest:1.0.0` with MasterData (each well as `master-data--Well:1.0.0` and `master-data--Wellbore:1.0.0`, its API and UIC numbers as name aliases, the gauge station as a vertical measurement), Data (the site as the WorkProduct; each well's record as `work-product-component--WellLog:1.1.0` in the time domain with ZeroTime, the sampling interval and a curve per channel; each seismic station as a generic component with its position) and Datasets (`dataset--File.Generic:1.0.0` for every file, with its size and SHA-256); `files/` beside it with the files themselves; `export_summary.json` with the counts, the gaps and whether it is loadable. Every export is in `records/audit.jsonl`.
+
+**The number to check**: `[LOADABLE]` or `[NOT LOADABLE]` on the first line, and `structure: ok (<n> record(s))` - the platform loader's first checks made here first: every record has its id, kind, ACL, legal block and data; every dataset a component names is in the manifest; every wellbore's well is in MasterData; the work product lists every component.
+
+**What this page will not call a measurement**: a WGS 84 position for a point whose datum is unknown - every position goes out twice, as given on its own datum with that datum's EPSG code, and on WGS 84 with the operation between them written into AppliedOperations; a point on an unknown datum gets no WGS 84 coordinates at all, because a platform that indexed it would place the well tens of metres wrong. A loadable manifest without the operator's partition, ACL and legal tag - they are never filled in. A seismic trace component - the seismic trace schema was not verified against a published example when this export was written, and a kind not read here is not a kind written here; stations go out as generic components with their records as datasets.
+
+Related: `gea help sites`, `gea help sra`, `gea help data-in`.

{gea_program-0.10.0 → gea_program-0.11.0}/gea/help/site.md

@@ -2,7 +2,7 @@
 
 > The workspace folder, the four roles and what each cannot do, the audit log.
 
-**The command**: `gea workspace --path C:\site --action init --name "Pad 3"`; `gea serve --workspace C:\site` (loopback by default; `--behind-proxy` with a TLS proxy in front, see `deploy/README.md`); `gea users --workspace C:\site --action add --name ... --role admin` (the password from `GEA_PASSWORD`, never the command line). `gea workspace --path C:\site --action rename --name "Pad 3"` sets the site's name as every report prints it.
+**The command**: `gea workspace --path C:\site --action init --name "Pad 3"`; `gea serve --workspace C:\site` (loopback by default; it opens the control panel in your browser once it is listening, `--no-browser` for a scheduled start, and the window it runs in prints what happens on the page - sign-ins, jobs, stops - as it happens; `--behind-proxy` with a TLS proxy in front, see `deploy/README.md`); `gea users --workspace C:\site --action add --name ... --role admin` (the password from `GEA_PASSWORD`, never the command line). `gea workspace --path C:\site --action rename --name "Pad 3"` sets the site's name as every report prints it.
 
 **What it writes**: `workspace.json`, `wells/<id>/{source,records}`, `config/` (every configuration versioned, diffed, reversible), `monitor/`, `reports/`, `jobs/<id>/{job.json,log.txt}`, `records/audit.jsonl` (append-only, every action with the actor and the SHA-256 of its inputs), `users.json` (salted PBKDF2-SHA256, never a password).
 

{gea_program-0.10.0 → gea_program-0.11.0}/gea/help/start.md

@@ -2,7 +2,7 @@
 
 > Install, the first run, and what the program will not claim.
 
-**The command**: `python -m pip install "gea-program[live]"` then `gea quickstart` (a real catalogue well through every report, then the strata survey on a public hole). A site: `gea workspace --path C:\site --action init --name "Pad 3"` and `gea serve --workspace C:\site`, then open http://127.0.0.1:8765/.
+**The command**: `python -m pip install "gea-program[live]"` then `gea quickstart` (a real catalogue well through every report, then the strata survey on a public hole). A site: `gea workspace --path C:\site --action init --name "Pad 3"` and `gea serve --workspace C:\site`, which opens http://127.0.0.1:8765/ in your browser (the serve window is the server, not the panel: it stays open and prints what happens on the page).
 
 **What it writes**: `gea_quickstart/index.html` with every report beside it; a site writes under its workspace folder (`reports/`, `records/`, `jobs/`).
 

{gea_program-0.10.0 → gea_program-0.11.0}/gea/helplib.py

@@ -39,6 +39,7 @@ INDEX: List[tuple] = [
     ('files', 'Files', 'import and export roots, detection by content, the evidence pack'),
     ('notifications', 'Notifications', 'rules, channels, the delivery log'),
     ('sra', 'The Seismicity Response Area', 'the packet an operator inside an SRA puts in front of the Commission'),
+    ('osdu', 'The OSDU-shaped export', 'the site as the manifest an operator\'s data platform loads'),
     ('doctor', 'Which code is running', 'gea doctor and the serve start-up gate'),
     ('audit-update', 'Audit / Update', 'the whole audit log with filters, the program against PyPI, every report against its source'),
     ('upkeep', 'Upkeep', 'housekeeping, sessions, the TLS proxy, the load test'),
@@ -49,7 +50,7 @@ REQUIRED_LINES = ('**The command**', '**What it writes**', '**The number to chec
 VIEW_TOPIC: Dict[str, str] = {
     'home': 'start', 'wells': 'data-in', 'well': 'drift', 'live': 'patches', 'patch': 'patches', 'files': 'files', 'alarms': 'alarms',
     'approvals': 'well-tests', 'config': 'site', 'reports': 'drift', 'verify': 'start', 'survey': 'data-in', 'jobs': 'site',
-    'admin': 'site', 'prefs': 'site', 'search': 'start', 'welcome': 'start', 'seismic': 'seismic', 'seismic_station': 'seismic', 'track': 'seismic', 'sites': 'sites', 'audit': 'audit-update',
+    'admin': 'site', 'prefs': 'site', 'search': 'start', 'welcome': 'start', 'seismic': 'seismic', 'seismic_station': 'seismic', 'track': 'seismic', 'sar': 'seismic', 'sites': 'sites', 'audit': 'audit-update',
 }