star-magic-program 0.396.0__tar.gz → 0.398.0__tar.gz

{star_magic_program-0.396.0 → star_magic_program-0.398.0}/CHANGELOG.md

@@ -7,6 +7,79 @@ Versioning: [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## v0.398.0 — 2026-08-25 — THE CATALOGUE SHIP
+
+`uqff_downhole_simulator` v1.14.0–v1.20.0 — the real-well profile catalogue
+grows from three entries to TEN, one well at a time on Daniel's standing
+order ("continue to catalogue real wells, one at a time. grab all necessary
+data!!!!"), every value verbatim, every entry provenance-sidecar'd, every
+addition gate-pinned and test-verified:
+
+- **v1.14.0 — University 6-17 No.1** (Wildcat, Reagan County, TEXAS; API
+  42-303-34774; Halliburton 1997): LAS 1.2 dialect (value-after-colon branch
+  on VERS), first imperial-depth well, second real BHT (141 °F @ 9,097 ft).
+- **v1.15.0 — Collingwood 1-28** (Amoco, Stanton County, KANSAS; API
+  15-187-20743; KGS): first COMPLETE-file entry, second wrapped shape
+  (27 curves), third real BHT (125 °F) — no TD parameter, so the converter's
+  honest no-anchor fallback is exercised, not papered over.
+- **v1.16.0 — GISP2 (Greenland), THE TEMPERATURE-CURVE PRIZE**: the first
+  continuous MEASURED temperature profile (598 stations, 72.61–3,053.15 m to
+  bedrock; USGS/Clow via GEUS, doi:10.5194/tc-17-3829-2023) — the converter's
+  TOP tier (MEASURED_CURVES) exercised with real data for the first time;
+  the three-tier ladder closes on real wells.
+- **v1.17.0 — Agassiz77** (Agassiz Ice Cap, Ellesmere Island, CANADA, 1977):
+  second COMPLETE measured temperature curve (67 stations) in a different
+  thermal regime; the catalogue's oldest measurement.
+- **v1.18.0 — L07-01** (Petroland 1971, Dutch North Sea via NLOG): first
+  DESCENDING-index log; converter → loader → engine proven order-agnostic.
+- **v1.19.0 — L06-06 survey** (NLOG): FIRST REAL WELL TRAJECTORY — 200
+  measured stations (MD/inclination/azimuth/TVD to MD 5,605) driving
+  DeviationSurvey and MD→TVD physics on real data; survey entries refuse
+  `stream()` (kind discipline); units-undeclared ambiguity disclosed.
+- **v1.20.0 — Volve 15/9-19 A core analysis** (Equinor): first LABORATORY
+  GROUND TRUTH — 87 core-plug samples (core 1 complete + the 20,800 mD
+  ultra-perm streak; permeability spans ×138,000 in one excerpt); lab
+  interleave preserved; units interpretive-not-in-file disclosed;
+  `read_core_csv` + core-kind dispatch in the loader.
+
+Catalogue standing: **TEN entries / EIGHT regions / FIVE kinds**. Real files
+drove four port upgrades (wrapped-LAS parsing, LAS 1.x branch, ~P BHT/TD
+meta anchors, descending index). Gate 5,835 → 5,858, 0 failures. 23-file
+pass verified.
+
+---
+
+## v0.397.0 — 2026-08-24 — THE CONNECTIVITY SHIP
+
+**PAPER_2257** (new dispatch — 2,253 wired / 2,308 keys): the two-stream
+architecture canonized as a standing landmark with a live-verifying dispatch
+(`two_stream_verified`), Daniel's ruling verbatim, the refusal doctrine as §5.
+
+`uqff_downhole_simulator` v1.10.0–v1.13.0:
+
+- **v1.10.0 file-follower** — quasi-live monitoring of continuously-appended
+  historian exports (poll/diff/reconcile; rotation detected; caller-scheduled);
+  formal connectivity-tier ladder published in response to an independent
+  assessment (correct on no-live-connection; stale on "only simulates").
+- **v1.11.0 real Modbus client** (Daniel GO on the optional pymodbus dependency) —
+  READ-ONLY tap, citation-mandatory register maps (none invented — no public G6
+  map exists), raw-struct decoding, LOOPBACK-VERIFIED against an in-process
+  server; gate green with or without the dependency installed.
+- **v1.12.0 profile catalogue** — 6-database public-source table with honest
+  access notes; provenance-mandatory catalogue entries; honest LAS→profile
+  converter (derived conditions labeled).
+- **v1.13.0 three real wells** — Volve 15/9-19 SR (North Sea), Scorpio E1
+  (South Australia), Kennetcook #2 P-129 (Nova Scotia). The third forced two
+  port upgrades: WRAPPED-LAS parsing (superseding the v1.8.0 refusal, verified
+  against the real file) and the DERIVED_FROM_MEASURED_BHT converter tier
+  (real BHT 42 °C @ TD 1,935 m from the log's own parameter block). All values
+  verbatim-pinned; all entries provenance-complete.
+
+Also: v0.396.0-era portability guard held; SHIP GUARD v5 (surfaces badge
+measured directly) landed mid-arc. Gate 5,816 → 5,835.
+
+---
+
 ## v0.396.0 — 2026-08-24 — THE TWO-STREAM SHIP
 
 `uqff_downhole_simulator` v1.7.0–v1.9.0 — Daniel's two-stream architecture

{star_magic_program-0.396.0 → star_magic_program-0.398.0}/CITATION.cff

@@ -3,8 +3,8 @@ message: "If you use Star-Magic-Program (UQFF systematic rebuild) in your resear
 type: software
 title: "Star-Magic-Program: UQFF Systematic Rebuild"
 abbreviation: "UQFF"
-version: "0.396.0"
-date-released: "2026-08-24"
+version: "0.398.0"
+date-released: "2026-08-25"
 authors:
   - family-names: "Murphy"
     given-names: "Daniel T."
@@ -53,7 +53,7 @@ preferred-citation:
     - family-names: "Murphy"
       given-names: "Daniel T."
   year: 2026
-  version: "0.396.0"
+  version: "0.398.0"
   url: "https://github.com/Daniel8Murphy0007/Star-Magic-Program"
   notes: >-
     Cite both the software and the relevant whitepapers by PAPER_N

{star_magic_program-0.396.0/star_magic_program.egg-info → star_magic_program-0.398.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: star-magic-program
-Version: 0.396.0
-Summary: Star-Magic UQFF calculator v0.396.0: THE TWO-STREAM SHIP. 2,252 dispatches (2,307 keys), gate 5,816/0. uqff_downhole_simulator v1.7.0-v1.9.0 completes Daniel's two-stream architecture: cited tool library (8 entries, no invented vendor data), read-only ports (historian CSV + LAS 2.0 implemented, live taps declared), and the two-stream reconciler - closed-stream predictions vs live data, offsets classified, undervalued streams flagged (kick-well find: 6,083 psi unexplained). Next: PAPER_2257.
+Version: 0.398.0
+Summary: Star-Magic UQFF calculator v0.398.0: THE CATALOGUE SHIP. 2,253 dispatches (2,308 keys), gate 5,858/0. uqff_downhole_simulator v1.14-v1.20: the real-well catalogue grows 3 -> 10 entries / 8 regions / 5 kinds - Texas LAS 1.2 + BHT 141F, Kansas complete file, GISP2 + Agassiz77 MEASURED temperature curves (converter tier ladder closed on real data), Dutch North Sea descending log + 200-station real trajectory, Volve core analysis (20,800 mD lab ground truth). Next: PAPER_2258.
 Author-email: "Daniel T. Murphy" <daniel.murphy00@enrgyone.com>
 License: AGPL-3.0-or-later OR LicenseRef-StarMagic-Commercial
 Project-URL: Homepage, https://github.com/Daniel8Murphy0007/Star-Magic-Program
@@ -30,21 +30,25 @@ Requires-Dist: sympy>=1.12
 Requires-Dist: mpmath>=1.3
 Requires-Dist: numpy>=1.24
 Requires-Dist: scipy>=1.10
+Provides-Extra: modbus
+Requires-Dist: pymodbus>=3.15; extra == "modbus"
+Provides-Extra: gui
+Requires-Dist: PyQt6; extra == "gui"
 Dynamic: license-file
 
 # Star-Magic-Program
 
-[![PyPI version](https://img.shields.io/pypi/v/star-magic-program.svg?cacheBust=0.396.0)](https://pypi.org/project/star-magic-program/)
-[![Python versions](https://img.shields.io/pypi/pyversions/star-magic-program.svg?cacheBust=0.396.0)](https://pypi.org/project/star-magic-program/)
+[![PyPI version](https://img.shields.io/pypi/v/star-magic-program.svg?cacheBust=0.398.0)](https://pypi.org/project/star-magic-program/)
+[![Python versions](https://img.shields.io/pypi/pyversions/star-magic-program.svg?cacheBust=0.398.0)](https://pypi.org/project/star-magic-program/)
 [![Documentation Status](https://readthedocs.org/projects/star-magic-program/badge/?version=latest)](https://star-magic-program.readthedocs.io/en/latest/?badge=latest)
 [![License: AGPL-3.0 + Commercial](https://img.shields.io/badge/License-AGPL--3.0%20%2B%20Commercial-blue.svg)](LICENSE)
-[![Fidelity gate](https://img.shields.io/badge/fidelity_gate-5816%2F0-brightgreen)](uqff_fidelity_tests.py)
-[![Public surfaces](https://img.shields.io/badge/public_surfaces-2307-blue)](uqff_calculator.py)
-[![Whitepapers](https://img.shields.io/badge/whitepapers-2291-orange)](whitepapers/)
+[![Fidelity gate](https://img.shields.io/badge/fidelity_gate-5858%2F0-brightgreen)](uqff_fidelity_tests.py)
+[![Public surfaces](https://img.shields.io/badge/public_surfaces-2308-blue)](uqff_calculator.py)
+[![Whitepapers](https://img.shields.io/badge/whitepapers-2292-orange)](whitepapers/)
 
-**UQFF systematic rebuild — v0.396.0 complete-compile campaign live**
+**UQFF systematic rebuild — v0.398.0 complete-compile campaign live**
 
-**This release (v0.396.0): THE TWO-STREAM SHIP — THE ARCHITECTURE COMPLETE.** **PAPER_2256 + `uqff_downhole_simulator` v1.6.0:** the program's first packaged industry-application module, built from Daniel's 22Aug2026 template thread (grok_cce7a73b) on same-day GO — a deep-well HPHT simulator (TD ≈ 20,300 ft) with a quartz P/T gauge string whose drift is **suppressed by the canonical lattice**: suppression = (0.58+0.32·(1−F_TRZ))·(0.52+0.38·K_MEX)·(0.68+0.27·Φ_res) = **1.0324 at the locked {0.1, 25/12, 0.84}** — drift BELOW the 0.215 %FS/yr industry baseline. **The knob ruling (Rule 2):** the template's adjustable "K_MEX"/"Φ_res" sliders were tuning gains wearing primitive names — canonicals now LOCKED in-physics (verified live by the dispatch on every call), sliders renamed `k_structural_trim`/`phi_coupling_trim`. **v1.1.0 extensions (Daniel-directed):** N-gauge strings (`make_sensor_string`); real well profiles from CSV (`load_well_profile_csv`; the shipped sample carries an HPHT overpressure kick the linear model cannot see — 18,405 vs 9,313 psi at the deepest gauge); and **twin-gauge drift-comparison mode** — every station carries a conventional reference gauge, and away from the clip band the measured conventional/UQFF ratio EQUALS the canonical suppression (1.0325 measured vs 1.0324 predicted across a 12-gauge string on the real profile) — the PAPER_2250 quartz bench test's complete simulation instrument. **v1.2.0 extension:** service-life drift ACCUMULATION (`ServiceLifeSimulator`) — the rates integrated over simulated service years, twin-leg divergence curves (2-3 psi/yr separation per station at FS 30,000 psi, 10-15 psi at a 5-yr horizon), recalibration resets, years-to-error-budget arithmetic; the accumulated-error ratio converges to the canonical suppression at every station. **v1.3.0 extension:** field-telemetry realism (`TelemetryRecorder`) — 1-reading/min timestamped acquisition with line dropouts, stuck gauges and spikes, historian quality flags, and a scored QC pipeline (frozen-value detection 1.0/1.0; Hampel despiker with common-mode veto, spike precision 0.83-1.0) exporting field-historian-style CSVs. **v1.4.0 extension:** depth-sweep case-study mode (`case_study`/`write_markdown` + CLI) — where the advantage is largest: 2.04 psi/yr flat below the HPHT knees compounding to 3.04 psi/yr at 20,000 ft (4.21 at 27,000 ft on a 30,000-ft well), rendered as a one-page customer case with the honest DERIVED_HYBRID note. **v1.5.0 extension:** real-datasheet gauge specs (`GaugeSpec`/`GAUGE_SPECS`) — web-verified GEO PSI GEOQ 177 (Quartzdyne) presets with mandatory citations (uncited specs rejected in code), plumbed through every layer; the suppression ratio is baseline-independent while the psi/yr story honestly scales with the cited spec bound. **v1.6.0 extensions:** wellbore deviation (MD/TVD surveys — a 60-deg tangent reads 6,525 vs the vertical model's 9,315 psi at the deepest gauge), multi-well batch runs (ratio invariant across geometries), and a headless CLI (`python -m uqff_downhole_simulator run|service-life|telemetry|case-study`). The 2026-08-23 extension list is complete. **v1.7.0 (two-stream build, piece 1): the tool library** — cited catalog of 8 toolstring entries (quartz twins, piezoresistive class with ChampionX-cited exponential drift form, vibrating wire/DTS/thermocouple as PARAMETERS_USER_SUPPLIED refusing invented numbers, and the G6 Modbus-RS485 surface interface declared as the ports-layer target) + ToolString composition + station rating checks (catches a 177 °C gauge in the 217 °C kick zone). **v1.8.0 (two-stream build, piece 2): the ports/plug-in layer** — READ-ONLY ingest to the normalized LiveStream form: historian-CSV and LAS 2.0 readers IMPLEMENTED (round-trip verified against the v1.3.0 telemetry export; wrapped LAS refused, not mis-parsed), live-protocol taps (modbus_g6/witsml/opcua) DECLARED and refusing until site details exist, `register_port()` for site plug-ins, CLI `ingest` subcommand. **v1.9.0 (piece 3 — the architecture COMPLETE): the two-stream reconciler** — per-station offset series classified IN_FAMILY / CALIBRATION_OFFSET / DRIFT_CONSISTENT / TRANSIENTS / UNEXPLAINED with disclosed thresholds; validated on four scenarios incl. THE FIND: the kick well reconciled against a linear-gradient assumption flags 610/4,448/6,083 psi unexplained offsets — the closed stream exposing the undervalued data stream. CLI `reconcile` subcommand. Sixteen package files (14 modules incl. the headless CLI + README + sample profile), installable package, engine headless by design, DERIVED_HYBRID with every industry anchor inline-commented, gate-verified per run. **Totals: 2,252 wired (2,307 DISPATCH keys) / gate 5,816 green / 4,179 defs. Next paper: PAPER_2257.**
+**This release (v0.398.0): THE CATALOGUE SHIP — TEN REAL WELLS, FIVE KINDS OF REAL DATA.** `uqff_downhole_simulator` v1.14.0–v1.20.0 grows the real-well profile catalogue from three entries to **ten**, one well at a time on Daniel's standing order, every value verbatim, every entry provenance-sidecar'd, every addition gate-pinned and test-verified: **University 6-17 No.1** (Reagan County, TEXAS; API 42-303-34774; Halliburton 1997 — LAS 1.2 dialect with the value-after-colon branch, first imperial-depth well, second real BHT 141 °F @ 9,097 ft); **Collingwood 1-28** (Stanton County, KANSAS; API 15-187-20743; KGS — the first COMPLETE-file entry, a second wrapped shape at 27 curves, third real BHT 125 °F whose missing TD parameter exercises the converter's honest no-anchor fallback); **GISP2** (Greenland — THE TEMPERATURE-CURVE PRIZE: the catalogue's first continuous MEASURED temperature profile, 598 stations from 72.61 m to bedrock at 3,053.15 m, USGS/Clow via the GEUS ice-temperature database, doi:10.5194/tc-17-3829-2023 — the converter's TOP tier MEASURED_CURVES exercised with real data for the first time, closing the three-tier ladder on real wells); **Agassiz77** (Agassiz Ice Cap, Ellesmere Island, CANADIAN Arctic, 1977 — a second COMPLETE measured temperature curve, 67 stations in a different thermal regime, the catalogue's oldest measurement); **L07-01** (Petroland 1971, Dutch North Sea via NLOG — the first DESCENDING-index log, flowing converter→loader→engine order-agnostically); **the L06-06 survey** (NLOG — the FIRST REAL WELL TRAJECTORY: 200 measured stations, MD/inclination/azimuth/TVD to MD 5,605, driving `DeviationSurvey` and the engine's MD→TVD physics on real data; survey entries refuse `stream()` — kind discipline; units-undeclared ambiguity DISCLOSED, not assumed); and **Volve 15/9-19 A core analysis** (Equinor — the first LABORATORY GROUND TRUTH: 87 core-plug samples, core 1 complete plus the 20,800 mD ultra-permeability streak, permeability spanning ×138,000 in one excerpt, porosity/saturations/grain density with the lab's interleaved sample pattern preserved exactly; units interpretive-not-in-file DISCLOSED in provenance; `read_core_csv` + core-kind dispatch). Real files drove four port upgrades across the arc: wrapped-LAS parsing (superseding the v1.8.0 refusal only once a real wrapped file existed to verify against), the LAS 1.x meta branch, ~P BHT/TMAX/TDL/TDD meta anchors, and descending-index handling. Catalogue standing: **TEN entries / EIGHT regions / FIVE kinds** (log excerpts, complete logs, measured temperature curves, real trajectory, core analysis) — the closed stream now has real wells to describe, real curves to convert, a real trajectory to bend to, and lab ground truth to calibrate against. Package v1.20.0 (catalog/ 20 files, measured). **Totals: 2,253 wired (2,308 DISPATCH keys) / gate 5,858 green / 4,180 defs. Next paper: PAPER_2258.**
 
 Author: Daniel T. Murphy · Star-Magic Research Program
 License: AGPL-3.0-or-later OR Commercial
@@ -102,7 +106,7 @@ Mizuno, Rossi).
 Full framework physics lives in the whitepaper corpus — the physics is the
 whitepapers; the calculator computes what the whitepapers derive.
 
-## What is currently shipped (v0.396.0)
+## What is currently shipped (v0.398.0)
 
 ### Wiring campaign — LIVE (see `CLAUDE.md` charter)
 
@@ -110,7 +114,7 @@ Sequential wiring of all 2,255 whitepapers, starting at PAPER_001.
 Authorized 2026-07-28: autonomous band sessions, ship per session via
 `ship.ps1`, full stop at PAPER_500 for manual review.
 
-**Wired: 2,252 distinct dispatches (2307 DISPATCH keys incl. the 55 canonical alias numbers 2179-2233)** (one per paper, Rule B closed). **Complete-compile frontier: PAPER_001-1300** (+ b-variants) fully captured over a **1766-function primitive-sourced equation library** — every equation and section (core + Session-225 + Production Framework + Cosmogenesis Lagrangian + VDS/DVP/BSH + Kozima-LENR K.1-K.6) via _common_uqff_blocks, with paper-specific §B DVP prime ladder (gate-guarded), 40/40+ linked-paper mapping, and a campaign-aware XGEO chain.
+**Wired: 2,253 distinct dispatches (2308 DISPATCH keys incl. the 55 canonical alias numbers 2179-2233)** (one per paper, Rule B closed). **Complete-compile frontier: PAPER_001-1300** (+ b-variants) fully captured over a **1766-function primitive-sourced equation library** — every equation and section (core + Session-225 + Production Framework + Cosmogenesis Lagrangian + VDS/DVP/BSH + Kozima-LENR K.1-K.6) via _common_uqff_blocks, with paper-specific §B DVP prime ladder (gate-guarded), 40/40+ linked-paper mapping, and a campaign-aware XGEO chain.
 
 **Derived-constants catalog (v0.344.0):** all **1,272 unique predecessor-registry derived constants** wired and callable via `uqff_derived_constants.py` — e.g. `derived_constant("alpha_inverse")` → 137.0 (PAPER_1167), `derived_constant("astro_BH_entropy_coeff")` → 0.24833 (PAPER_594). 661 numeric, routes + provenance preserved.
 

{star_magic_program-0.396.0 → star_magic_program-0.398.0}/README.md

@@ -1,16 +1,16 @@
 # Star-Magic-Program
 
-[![PyPI version](https://img.shields.io/pypi/v/star-magic-program.svg?cacheBust=0.396.0)](https://pypi.org/project/star-magic-program/)
-[![Python versions](https://img.shields.io/pypi/pyversions/star-magic-program.svg?cacheBust=0.396.0)](https://pypi.org/project/star-magic-program/)
+[![PyPI version](https://img.shields.io/pypi/v/star-magic-program.svg?cacheBust=0.398.0)](https://pypi.org/project/star-magic-program/)
+[![Python versions](https://img.shields.io/pypi/pyversions/star-magic-program.svg?cacheBust=0.398.0)](https://pypi.org/project/star-magic-program/)
 [![Documentation Status](https://readthedocs.org/projects/star-magic-program/badge/?version=latest)](https://star-magic-program.readthedocs.io/en/latest/?badge=latest)
 [![License: AGPL-3.0 + Commercial](https://img.shields.io/badge/License-AGPL--3.0%20%2B%20Commercial-blue.svg)](LICENSE)
-[![Fidelity gate](https://img.shields.io/badge/fidelity_gate-5816%2F0-brightgreen)](uqff_fidelity_tests.py)
-[![Public surfaces](https://img.shields.io/badge/public_surfaces-2307-blue)](uqff_calculator.py)
-[![Whitepapers](https://img.shields.io/badge/whitepapers-2291-orange)](whitepapers/)
+[![Fidelity gate](https://img.shields.io/badge/fidelity_gate-5858%2F0-brightgreen)](uqff_fidelity_tests.py)
+[![Public surfaces](https://img.shields.io/badge/public_surfaces-2308-blue)](uqff_calculator.py)
+[![Whitepapers](https://img.shields.io/badge/whitepapers-2292-orange)](whitepapers/)
 
-**UQFF systematic rebuild — v0.396.0 complete-compile campaign live**
+**UQFF systematic rebuild — v0.398.0 complete-compile campaign live**
 
-**This release (v0.396.0): THE TWO-STREAM SHIP — THE ARCHITECTURE COMPLETE.** **PAPER_2256 + `uqff_downhole_simulator` v1.6.0:** the program's first packaged industry-application module, built from Daniel's 22Aug2026 template thread (grok_cce7a73b) on same-day GO — a deep-well HPHT simulator (TD ≈ 20,300 ft) with a quartz P/T gauge string whose drift is **suppressed by the canonical lattice**: suppression = (0.58+0.32·(1−F_TRZ))·(0.52+0.38·K_MEX)·(0.68+0.27·Φ_res) = **1.0324 at the locked {0.1, 25/12, 0.84}** — drift BELOW the 0.215 %FS/yr industry baseline. **The knob ruling (Rule 2):** the template's adjustable "K_MEX"/"Φ_res" sliders were tuning gains wearing primitive names — canonicals now LOCKED in-physics (verified live by the dispatch on every call), sliders renamed `k_structural_trim`/`phi_coupling_trim`. **v1.1.0 extensions (Daniel-directed):** N-gauge strings (`make_sensor_string`); real well profiles from CSV (`load_well_profile_csv`; the shipped sample carries an HPHT overpressure kick the linear model cannot see — 18,405 vs 9,313 psi at the deepest gauge); and **twin-gauge drift-comparison mode** — every station carries a conventional reference gauge, and away from the clip band the measured conventional/UQFF ratio EQUALS the canonical suppression (1.0325 measured vs 1.0324 predicted across a 12-gauge string on the real profile) — the PAPER_2250 quartz bench test's complete simulation instrument. **v1.2.0 extension:** service-life drift ACCUMULATION (`ServiceLifeSimulator`) — the rates integrated over simulated service years, twin-leg divergence curves (2-3 psi/yr separation per station at FS 30,000 psi, 10-15 psi at a 5-yr horizon), recalibration resets, years-to-error-budget arithmetic; the accumulated-error ratio converges to the canonical suppression at every station. **v1.3.0 extension:** field-telemetry realism (`TelemetryRecorder`) — 1-reading/min timestamped acquisition with line dropouts, stuck gauges and spikes, historian quality flags, and a scored QC pipeline (frozen-value detection 1.0/1.0; Hampel despiker with common-mode veto, spike precision 0.83-1.0) exporting field-historian-style CSVs. **v1.4.0 extension:** depth-sweep case-study mode (`case_study`/`write_markdown` + CLI) — where the advantage is largest: 2.04 psi/yr flat below the HPHT knees compounding to 3.04 psi/yr at 20,000 ft (4.21 at 27,000 ft on a 30,000-ft well), rendered as a one-page customer case with the honest DERIVED_HYBRID note. **v1.5.0 extension:** real-datasheet gauge specs (`GaugeSpec`/`GAUGE_SPECS`) — web-verified GEO PSI GEOQ 177 (Quartzdyne) presets with mandatory citations (uncited specs rejected in code), plumbed through every layer; the suppression ratio is baseline-independent while the psi/yr story honestly scales with the cited spec bound. **v1.6.0 extensions:** wellbore deviation (MD/TVD surveys — a 60-deg tangent reads 6,525 vs the vertical model's 9,315 psi at the deepest gauge), multi-well batch runs (ratio invariant across geometries), and a headless CLI (`python -m uqff_downhole_simulator run|service-life|telemetry|case-study`). The 2026-08-23 extension list is complete. **v1.7.0 (two-stream build, piece 1): the tool library** — cited catalog of 8 toolstring entries (quartz twins, piezoresistive class with ChampionX-cited exponential drift form, vibrating wire/DTS/thermocouple as PARAMETERS_USER_SUPPLIED refusing invented numbers, and the G6 Modbus-RS485 surface interface declared as the ports-layer target) + ToolString composition + station rating checks (catches a 177 °C gauge in the 217 °C kick zone). **v1.8.0 (two-stream build, piece 2): the ports/plug-in layer** — READ-ONLY ingest to the normalized LiveStream form: historian-CSV and LAS 2.0 readers IMPLEMENTED (round-trip verified against the v1.3.0 telemetry export; wrapped LAS refused, not mis-parsed), live-protocol taps (modbus_g6/witsml/opcua) DECLARED and refusing until site details exist, `register_port()` for site plug-ins, CLI `ingest` subcommand. **v1.9.0 (piece 3 — the architecture COMPLETE): the two-stream reconciler** — per-station offset series classified IN_FAMILY / CALIBRATION_OFFSET / DRIFT_CONSISTENT / TRANSIENTS / UNEXPLAINED with disclosed thresholds; validated on four scenarios incl. THE FIND: the kick well reconciled against a linear-gradient assumption flags 610/4,448/6,083 psi unexplained offsets — the closed stream exposing the undervalued data stream. CLI `reconcile` subcommand. Sixteen package files (14 modules incl. the headless CLI + README + sample profile), installable package, engine headless by design, DERIVED_HYBRID with every industry anchor inline-commented, gate-verified per run. **Totals: 2,252 wired (2,307 DISPATCH keys) / gate 5,816 green / 4,179 defs. Next paper: PAPER_2257.**
+**This release (v0.398.0): THE CATALOGUE SHIP — TEN REAL WELLS, FIVE KINDS OF REAL DATA.** `uqff_downhole_simulator` v1.14.0–v1.20.0 grows the real-well profile catalogue from three entries to **ten**, one well at a time on Daniel's standing order, every value verbatim, every entry provenance-sidecar'd, every addition gate-pinned and test-verified: **University 6-17 No.1** (Reagan County, TEXAS; API 42-303-34774; Halliburton 1997 — LAS 1.2 dialect with the value-after-colon branch, first imperial-depth well, second real BHT 141 °F @ 9,097 ft); **Collingwood 1-28** (Stanton County, KANSAS; API 15-187-20743; KGS — the first COMPLETE-file entry, a second wrapped shape at 27 curves, third real BHT 125 °F whose missing TD parameter exercises the converter's honest no-anchor fallback); **GISP2** (Greenland — THE TEMPERATURE-CURVE PRIZE: the catalogue's first continuous MEASURED temperature profile, 598 stations from 72.61 m to bedrock at 3,053.15 m, USGS/Clow via the GEUS ice-temperature database, doi:10.5194/tc-17-3829-2023 — the converter's TOP tier MEASURED_CURVES exercised with real data for the first time, closing the three-tier ladder on real wells); **Agassiz77** (Agassiz Ice Cap, Ellesmere Island, CANADIAN Arctic, 1977 — a second COMPLETE measured temperature curve, 67 stations in a different thermal regime, the catalogue's oldest measurement); **L07-01** (Petroland 1971, Dutch North Sea via NLOG — the first DESCENDING-index log, flowing converter→loader→engine order-agnostically); **the L06-06 survey** (NLOG — the FIRST REAL WELL TRAJECTORY: 200 measured stations, MD/inclination/azimuth/TVD to MD 5,605, driving `DeviationSurvey` and the engine's MD→TVD physics on real data; survey entries refuse `stream()` — kind discipline; units-undeclared ambiguity DISCLOSED, not assumed); and **Volve 15/9-19 A core analysis** (Equinor — the first LABORATORY GROUND TRUTH: 87 core-plug samples, core 1 complete plus the 20,800 mD ultra-permeability streak, permeability spanning ×138,000 in one excerpt, porosity/saturations/grain density with the lab's interleaved sample pattern preserved exactly; units interpretive-not-in-file DISCLOSED in provenance; `read_core_csv` + core-kind dispatch). Real files drove four port upgrades across the arc: wrapped-LAS parsing (superseding the v1.8.0 refusal only once a real wrapped file existed to verify against), the LAS 1.x meta branch, ~P BHT/TMAX/TDL/TDD meta anchors, and descending-index handling. Catalogue standing: **TEN entries / EIGHT regions / FIVE kinds** (log excerpts, complete logs, measured temperature curves, real trajectory, core analysis) — the closed stream now has real wells to describe, real curves to convert, a real trajectory to bend to, and lab ground truth to calibrate against. Package v1.20.0 (catalog/ 20 files, measured). **Totals: 2,253 wired (2,308 DISPATCH keys) / gate 5,858 green / 4,180 defs. Next paper: PAPER_2258.**
 
 Author: Daniel T. Murphy · Star-Magic Research Program
 License: AGPL-3.0-or-later OR Commercial
@@ -68,7 +68,7 @@ Mizuno, Rossi).
 Full framework physics lives in the whitepaper corpus — the physics is the
 whitepapers; the calculator computes what the whitepapers derive.
 
-## What is currently shipped (v0.396.0)
+## What is currently shipped (v0.398.0)
 
 ### Wiring campaign — LIVE (see `CLAUDE.md` charter)
 
@@ -76,7 +76,7 @@ Sequential wiring of all 2,255 whitepapers, starting at PAPER_001.
 Authorized 2026-07-28: autonomous band sessions, ship per session via
 `ship.ps1`, full stop at PAPER_500 for manual review.
 
-**Wired: 2,252 distinct dispatches (2307 DISPATCH keys incl. the 55 canonical alias numbers 2179-2233)** (one per paper, Rule B closed). **Complete-compile frontier: PAPER_001-1300** (+ b-variants) fully captured over a **1766-function primitive-sourced equation library** — every equation and section (core + Session-225 + Production Framework + Cosmogenesis Lagrangian + VDS/DVP/BSH + Kozima-LENR K.1-K.6) via _common_uqff_blocks, with paper-specific §B DVP prime ladder (gate-guarded), 40/40+ linked-paper mapping, and a campaign-aware XGEO chain.
+**Wired: 2,253 distinct dispatches (2308 DISPATCH keys incl. the 55 canonical alias numbers 2179-2233)** (one per paper, Rule B closed). **Complete-compile frontier: PAPER_001-1300** (+ b-variants) fully captured over a **1766-function primitive-sourced equation library** — every equation and section (core + Session-225 + Production Framework + Cosmogenesis Lagrangian + VDS/DVP/BSH + Kozima-LENR K.1-K.6) via _common_uqff_blocks, with paper-specific §B DVP prime ladder (gate-guarded), 40/40+ linked-paper mapping, and a campaign-aware XGEO chain.
 
 **Derived-constants catalog (v0.344.0):** all **1,272 unique predecessor-registry derived constants** wired and callable via `uqff_derived_constants.py` — e.g. `derived_constant("alpha_inverse")` → 137.0 (PAPER_1167), `derived_constant("astro_BH_entropy_coeff")` → 0.24833 (PAPER_594). 661 numeric, routes + provenance preserved.
 

{star_magic_program-0.396.0 → star_magic_program-0.398.0}/SESSION_LOG.md

@@ -11848,3 +11848,93 @@ release paragraph/campaign/shipped header; CHANGELOG + _BUILD_LOG +
 SHIP_MESSAGE + RULINGS trail; 10 TWOSTREAM_ARC trail rows. Zero calculator
 physics changes; zero new dispatches (ratchet untouched). Awaiting Daniel:
 `.\ship.ps1` (clear .git/index.lock first).
+
+## Entry 269 — 2026-08-24 — v0.397.0 THE CONNECTIVITY SHIP (PAPER_2257 + downhole v1.10–v1.13)
+
+The session that answered "can this program read deployed sensors?" with built
+code and real wells:
+
+1. PAPER_2257 authored + wired (2,253 wired / 2,308 keys): the two-stream
+   architecture landmark; dispatch live-verifies suppression lock, ratio
+   equality, citations, port statuses, and a micro reconciliation per call;
+   refusal doctrine canonized §5. WHITEPAPER_INDEX flipped; residual ratchet
+   fed; whitepapers 2,292.
+2. Independent connectivity assessment adjudicated: CORRECT on no live
+   connection (the declared-refusing tier, by design); STALE on "only
+   simulates" (v1.8.0 offline ingest of real exports already existed).
+   Connectivity-tier ladder published (simulate / offline-ingest /
+   file-follow / live-protocol).
+3. v1.10.0 `uqff_follower.py`: HistorianFollower — poll/diff/reconcile on
+   continuously-appended exports; rotation detected; missing file soft error;
+   caller-scheduled. Tier 3 live today with zero network code.
+4. v1.11.0 `uqff_modbus.py` (Daniel GO on optional pymodbus): READ-ONLY
+   ModbusHistorianTap; register maps user-supplied + citation-mandatory (no
+   public G6 map exists — none invented; example labeled TEST_FIXTURE);
+   raw-struct decode; LOOPBACK-VERIFIED (in-process server, exact float32/
+   uint16 recovery); registry status reflects dependency presence; gate
+   carries BOTH branches (green on Daniel's no-pymodbus Windows).
+5. v1.12.0 `uqff_profile_catalog.py`: PROFILE_SOURCES (6 public databases,
+   honest access notes — GDR/KGS binary/zip barriers documented after live
+   fetch attempts); provenance-mandatory CATALOG; honest las_to_profile.
+6. v1.13.0 THREE REAL WELLS, one at a time per Daniel's order, each verbatim
+   + provenance-sidecar'd + test-verified: Volve 15/9-19 SR (Statoil, North
+   Sea; GR[0]=5.3274 verbatim); Scorpio E1 (SA 6038-187; -99999-NULL
+   dialect); Kennetcook #2 P-129 (Nova Scotia, Schlumberger 2007; WRAP. YES
+   PETREL export + REAL BHT 42.0 °C @ TD 1,935 m). Real data forced two
+   upgrades: wrapped-LAS parsing in read_las (SUPERSEDES the v1.8.0 refusal,
+   verified against the real file; partial records dropped not guessed) and
+   the converter's DERIVED_FROM_MEASURED_BHT tier (~P anchors BHT/TMAX/TDL/
+   TDD captured to stream meta).
+
+Ship prep: pins at 0.397.0 (desc 467 chars, measured counts); SHIP GUARD
+marker TWOSTREAM_ARC→CONNECTIVITY_ARC (+ GAPS id connectivity_arc_rule7);
+README release/campaign/shipped headers; CHANGELOG + _BUILD_LOG +
+SHIP_MESSAGE + RULINGS trail (pymodbus GO recorded); 10 CONNECTIVITY_ARC
+trail rows. Gate 5,816 → 5,835, 0 failures. Package v1.13.0 (26 files incl.
+catalog/, measured). Awaiting Daniel: `.\ship.ps1` (clear .git/index.lock first).
+
+## Entry 270 — 2026-08-25 — v0.398.0 THE CATALOGUE SHIP (downhole v1.14–v1.20, entries 4–10)
+
+Seven wells in seven package versions, one at a time per Daniel's standing
+order ("continue to catalogue real wells, one at a time. grab all necessary
+data!!!! Then test verify that you did your job."), each fetched read-only,
+transcribed verbatim, provenance-sidecar'd, gate-pinned, and live-verified:
+
+1. v1.14.0 University 6-17 No.1 (Reagan Co., TEXAS; API 42-303-34774;
+   Halliburton 1997): LAS 1.2 — third version dialect (VERS<2.0
+   value-after-colon branch), first imperial-depth well, second real BHT
+   (141 °F @ 9,097 ft) exercising the converter's DEGF + feet branches.
+2. v1.15.0 Collingwood 1-28 (Stanton Co., KANSAS; API 15-187-20743; KGS):
+   first COMPLETE-file entry, second wrapped shape (27 curves), third real
+   BHT (125 °F) with NO TD parameter — the converter's honest no-anchor
+   fallback exercised (labeled gradients, no fabricated anchor).
+3. v1.16.0 GISP2 (Greenland) — THE TEMPERATURE-CURVE PRIZE: first
+   continuous MEASURED temperature profile, 598 stations 72.61–3,053.15 m
+   to bedrock (USGS/Clow via GEUS, doi:10.5194/tc-17-3829-2023); the
+   MEASURED_CURVES top tier real for the first time — tier ladder closed.
+4. v1.17.0 Agassiz77 (Ellesmere Island, CANADA, 1977): second COMPLETE
+   measured curve (67 stations), different thermal regime, oldest entry.
+5. v1.18.0 L07-01 (Dutch North Sea, NLOG, 1971): first DESCENDING-index
+   log — converter/loader/engine order-agnostic, verified.
+6. v1.19.0 L06-06 survey (NLOG): FIRST REAL WELL TRAJECTORY — 200 measured
+   stations to MD 5,605 driving DeviationSurvey MD→TVD on real data;
+   survey entries refuse stream() (kind discipline); units-undeclared
+   ambiguity DISCLOSED in provenance rather than assumed.
+7. v1.20.0 Volve 15/9-19 A core analysis (Equinor): first LABORATORY
+   GROUND TRUTH — 87 core-plug samples (core 1 complete + 20,800 mD
+   ultra-perm streak; ×138,000 permeability span in one excerpt); lab
+   interleave preserved; units interpretive-not-in-file DISCLOSED;
+   read_core_csv + core-kind dispatch added.
+
+Real files drove four port upgrades across the arc: wrapped-LAS parsing
+(supersedes the v1.8.0 refusal, verified against Kennetcook), LAS 1.x
+meta branch, ~P BHT/TMAX/TDL/TDD meta anchors, descending-index handling.
+Catalogue standing: TEN entries / EIGHT regions / FIVE kinds.
+
+Ship prep: pins at 0.398.0 (desc 477 chars, measured counts); SHIP GUARD
+marker CONNECTIVITY_ARC→CATALOGUE_ARC (+ GAPS id catalogue_arc_rule7);
++2 CATALOGUE_ARC ship pins; README release/campaign/shipped headers +
+badges; CHANGELOG + _BUILD_LOG + SHIP_MESSAGE + RULINGS trail; 11
+CATALOGUE_ARC trail rows (incl. DUPLICATES family record). Gate 5,856 →
+5,858, 0 failures. Package v1.20.0 (catalog/ 20 files, measured). Awaiting
+Daniel: `.\ship.ps1` (clear .git/index.lock first).

{star_magic_program-0.396.0 → star_magic_program-0.398.0}/UNIFIED_REGISTRY_RESIDUALS.csv

@@ -2306,3 +2306,4 @@ PAPER_S202_Phase_H202_VariantBranches,0.0,EXACT_OR_CENSUS
 PAPER_S203_Phase_H203_PTF,0.0,EXACT_OR_CENSUS
 PAPER_S204_Phase_H204_GapClosure,0.0,EXACT_OR_CENSUS
 PAPER_S205_Phase_H205_ExpansionErosion,0.0,EXACT_OR_CENSUS
+PAPER_2257,0.0,EXACT_OR_CENSUS

star_magic_program-0.398.0/UNIFIED_REGISTRY_VERSION.txt

@@ -0,0 +1 @@
+v0.398.0

{star_magic_program-0.396.0 → star_magic_program-0.398.0}/UNIFIED_REGISTRY_XGEO_QUEUE.csv

@@ -1723,3 +1723,5 @@ LEDGER_ARC,n/a,n/a,NOT_APPLICABLE,census+packaging single-geometry,v0.393.0
 DOWNHOLE_ARC,n/a,n/a,NOT_APPLICABLE,application module single-geometry,v0.394.0
 INSTRUMENT_ARC,n/a,n/a,NOT_APPLICABLE,application-module extensions single-geometry,v0.395.0
 TWOSTREAM_ARC,n/a,n/a,NOT_APPLICABLE,application-module architecture single-geometry,v0.396.0
+CONNECTIVITY_ARC,n/a,n/a,NOT_APPLICABLE,application connectivity + real-data catalogue single-geometry,v0.397.0
+CATALOGUE_ARC,n/a,n/a,NOT_APPLICABLE,application real-data catalogue single-geometry,v0.398.0

{star_magic_program-0.396.0 → star_magic_program-0.398.0}/UNIFIED_REGISTRY_XGEO_ROUTES.csv

@@ -1724,3 +1724,5 @@ LEDGER_ARC,n/a,XGEO_NOT_REQUIRED,none,v0.393.0
 DOWNHOLE_ARC,n/a,XGEO_NOT_REQUIRED,none,v0.394.0
 INSTRUMENT_ARC,n/a,XGEO_NOT_REQUIRED,none,v0.395.0
 TWOSTREAM_ARC,n/a,XGEO_NOT_REQUIRED,none,v0.396.0
+CONNECTIVITY_ARC,n/a,XGEO_NOT_REQUIRED,none,v0.397.0
+CATALOGUE_ARC,n/a,XGEO_NOT_REQUIRED,none,v0.398.0

{star_magic_program-0.396.0 → star_magic_program-0.398.0}/WHITEPAPER_INDEX.md

@@ -99,7 +99,7 @@ Every previously non-numeric key now carries a canonical PAPER number (2179-2212
 | 2233 | PAPER_1203b |
 
 - **Verification arc 2026-08-16 (v0.387.0):** paradox-corpus audit ZERO recalcs; grammar dragnet 110 family sites; origin term verified; AP text layer EXHAUSTED (458 docs). Runnable queue empty — remaining items Daniel-owned.
-- **Distinct wired papers: 2,252 (+55 canonical alias numbers 2179-2233; 2,307 DISPATCH keys). Absorption pass + PAPER_2234 campaign-completion landmark, 2026-08-16.** = `wired_count()` = `len(DISPATCH)` (live at band 2121-2130, 2026-08-16; earlier eras' 1,417 figure superseded).
+- **Distinct wired papers: 2,253 (+55 canonical alias numbers 2179-2233; 2,308 DISPATCH keys). PAPER_2257 two-stream architecture landmark, 2026-08-24; v0.398.0 CATALOGUE SHIP (downhole v1.14-v1.20, ten real-data entries), 2026-08-25.** = `wired_count()` = `len(DISPATCH)` (live at band 2121-2130, 2026-08-16; earlier eras' 1,417 figure superseded).
 - **Index table file-row marks:** **934 ✓ CLEAN**, **245 ⚠ OPEN_RULING**, **1076 ⬜** not-touched (934 + 245 + 1076 = 2255 ✓). Wired file-rows (934 + 245 = 1,179) sit below `wired_count()` = 1,417 because variant files share a base dispatch.
 - **ORPHAN-PHYSICS (v0.367.1 audit):** no paper numbers are missing, but 71 non-numbered `.md` files in the predecessor hold **6,615 equation blocks** outside the corpus. Queued as Q-ORPHAN-PHYSICS.
 - **OPEN targets:** 0
@@ -2413,3 +2413,4 @@ Every previously non-numeric key now carries a canonical PAPER number (2179-2212
 | ✓ | PAPER_2254 | ANCHOR_CENSUS: 33 named / 981 uses / 17 external-value surface / live introspection drift-catch in UNIFIED_REGISTRY_ANCHORS.csv (new artifact); 4 relabeled UQFF_DERIVED; board-item scope measured 3/49; P2149 ledger complete (authored+wired 2026-08-21) |
 | ✓ | PAPER_2255 | OPEN_ITEMS_CENSUS: 20 ledger rows / 10 classes / 29 OPEN + 15 route-family measured live per call in UNIFIED_REGISTRY_OPEN_ITEMS.csv (new artifact); Daniel board in-ledger; deliberate-vs-open distinguished; CENSUS SERIES COMPLETE (authored+wired 2026-08-21) |
 | ✓ | PAPER_2256 | UQFF_DOWNHOLE_SIMULATOR: first industry-application module (uqff_downhole_simulator/ package; HPHT quartz string TD 20,300 ft x6 gauges); canonical lock K_MEX=25/12 + Phi_res=0.84, suppression 1.0324; knob ruling (trims renamed); template port grok_cce7a73b 22Aug2026 (authored+wired 2026-08-22) |
+| ✓ | PAPER_2257 | TWO_STREAM_ARCHITECTURE: closed stream finds offset undervalued live data (Daniel ruling 2026-08-23); tool library v1.7.0 + read-only ports v1.8.0 + reconciler v1.9.0; four-scenario validation incl. kick find 6,083 psi; refusal doctrine canonized; dispatch re-verifies architecture live (authored+wired 2026-08-24) |

{star_magic_program-0.396.0 → star_magic_program-0.398.0}/_BUILD_LOG.md

@@ -309,3 +309,9 @@ THE INSTRUMENT SHIP: uqff_downhole_simulator v1.2.0-v1.6.0 (service-life diverge
 
 ## v0.396.0 — 2026-08-24
 THE TWO-STREAM SHIP: uqff_downhole_simulator v1.7.0-v1.9.0 (cited tool library; read-only ports with historian/LAS implemented and live taps declared; two-stream reconciler with four-scenario validation incl. the 6,083-psi kick find). Architecture complete. Gate 5,816/0. 23-file pass verified.
+
+## v0.397.0 — 2026-08-24
+THE CONNECTIVITY SHIP: PAPER_2257 landmark+dispatch; downhole v1.10-v1.13 (file-follower; real Modbus client loopback-verified; connectivity ladder; profile catalogue with THREE REAL WELLS incl. wrapped-LAS parsing + measured-BHT tier). Gate 5,835/0. 23-file pass verified.
+
+## v0.398.0 — 2026-08-25
+THE CATALOGUE SHIP: downhole v1.14-v1.20 — real-well catalogue 3→10 entries / 8 regions / 5 kinds (TX LAS 1.2 + BHT; KS complete file; GISP2 + Agassiz77 MEASURED temperature curves — converter tier ladder closed on real data; NL descending log; L06-06 200-station real trajectory; Volve core 20,800 mD lab ground truth). Four port upgrades driven by real files. Gate 5,858/0. 23-file pass verified.

{star_magic_program-0.396.0 → star_magic_program-0.398.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "star-magic-program"
-version = "0.396.0"
-description = "Star-Magic UQFF calculator v0.396.0: THE TWO-STREAM SHIP. 2,252 dispatches (2,307 keys), gate 5,816/0. uqff_downhole_simulator v1.7.0-v1.9.0 completes Daniel's two-stream architecture: cited tool library (8 entries, no invented vendor data), read-only ports (historian CSV + LAS 2.0 implemented, live taps declared), and the two-stream reconciler - closed-stream predictions vs live data, offsets classified, undervalued streams flagged (kick-well find: 6,083 psi unexplained). Next: PAPER_2257."
+version = "0.398.0"
+description = "Star-Magic UQFF calculator v0.398.0: THE CATALOGUE SHIP. 2,253 dispatches (2,308 keys), gate 5,858/0. uqff_downhole_simulator v1.14-v1.20: the real-well catalogue grows 3 -> 10 entries / 8 regions / 5 kinds - Texas LAS 1.2 + BHT 141F, Kansas complete file, GISP2 + Agassiz77 MEASURED temperature curves (converter tier ladder closed on real data), Dutch North Sea descending log + 200-station real trajectory, Volve core analysis (20,800 mD lab ground truth). Next: PAPER_2258."
 readme = "README.md"
 authors = [
     { name = "Daniel T. Murphy", email = "daniel.murphy00@enrgyone.com" }
@@ -52,6 +52,10 @@ Source = "https://github.com/Daniel8Murphy0007/Star-Magic-Program"
 Predecessor = "https://github.com/Daniel8Murphy0007/Star-Magic"
 Issues = "https://github.com/Daniel8Murphy0007/Star-Magic-Program/issues"
 
+[project.optional-dependencies]
+modbus = ["pymodbus>=3.15"]
+gui = ["PyQt6"]
+
 [tool.setuptools]
 packages = ["uqff_downhole_simulator"]
 py-modules = ["uqff_session_closures", "uqff_fubii_variants", "uqff_ngc_catalog", "uqff_primitive_identities", "uqff_material_landmarks", "uqff_backbone_locks", "uqff_derived_functions", "uqff_derived_constants", 
@@ -101,4 +105,25 @@ py-modules = ["uqff_session_closures", "uqff_fubii_variants", "uqff_ngc_catalog"
     "notebooks/00_quickstart.ipynb",
     "uqff_downhole_simulator/README.md",
     "uqff_downhole_simulator/sample_well_profile.csv",
+    "uqff_downhole_simulator/example_register_map.json",
+    "uqff_downhole_simulator/catalog/volve_15_9_19_sr_excerpt.las",
+    "uqff_downhole_simulator/catalog/volve_15_9_19_sr_excerpt.provenance.json",
+    "uqff_downhole_simulator/catalog/scorpio_e1_sa_excerpt.las",
+    "uqff_downhole_simulator/catalog/scorpio_e1_sa_excerpt.provenance.json",
+    "uqff_downhole_simulator/catalog/kennetcook_2_p129_excerpt.las",
+    "uqff_downhole_simulator/catalog/kennetcook_2_p129_excerpt.provenance.json",
+    "uqff_downhole_simulator/catalog/university_6_17_no1_tx_excerpt.las",
+    "uqff_downhole_simulator/catalog/university_6_17_no1_tx_excerpt.provenance.json",
+    "uqff_downhole_simulator/catalog/collingwood_1_28_ks_complete.las",
+    "uqff_downhole_simulator/catalog/collingwood_1_28_ks_complete.provenance.json",
+    "uqff_downhole_simulator/catalog/gisp2_greenland_temperature.csv",
+    "uqff_downhole_simulator/catalog/gisp2_greenland_temperature.provenance.json",
+    "uqff_downhole_simulator/catalog/agassiz77_canada_temperature.csv",
+    "uqff_downhole_simulator/catalog/agassiz77_canada_temperature.provenance.json",
+    "uqff_downhole_simulator/catalog/l07_01_nl_excerpt.las",
+    "uqff_downhole_simulator/catalog/l07_01_nl_excerpt.provenance.json",
+    "uqff_downhole_simulator/catalog/l06_06_nl_survey.csv",
+    "uqff_downhole_simulator/catalog/l06_06_nl_survey.provenance.json",
+    "uqff_downhole_simulator/catalog/volve_15_9_19a_core_excerpt.csv",
+    "uqff_downhole_simulator/catalog/volve_15_9_19a_core_excerpt.provenance.json",
 ]

{star_magic_program-0.396.0 → star_magic_program-0.398.0/star_magic_program.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: star-magic-program
-Version: 0.396.0
-Summary: Star-Magic UQFF calculator v0.396.0: THE TWO-STREAM SHIP. 2,252 dispatches (2,307 keys), gate 5,816/0. uqff_downhole_simulator v1.7.0-v1.9.0 completes Daniel's two-stream architecture: cited tool library (8 entries, no invented vendor data), read-only ports (historian CSV + LAS 2.0 implemented, live taps declared), and the two-stream reconciler - closed-stream predictions vs live data, offsets classified, undervalued streams flagged (kick-well find: 6,083 psi unexplained). Next: PAPER_2257.
+Version: 0.398.0
+Summary: Star-Magic UQFF calculator v0.398.0: THE CATALOGUE SHIP. 2,253 dispatches (2,308 keys), gate 5,858/0. uqff_downhole_simulator v1.14-v1.20: the real-well catalogue grows 3 -> 10 entries / 8 regions / 5 kinds - Texas LAS 1.2 + BHT 141F, Kansas complete file, GISP2 + Agassiz77 MEASURED temperature curves (converter tier ladder closed on real data), Dutch North Sea descending log + 200-station real trajectory, Volve core analysis (20,800 mD lab ground truth). Next: PAPER_2258.
 Author-email: "Daniel T. Murphy" <daniel.murphy00@enrgyone.com>
 License: AGPL-3.0-or-later OR LicenseRef-StarMagic-Commercial
 Project-URL: Homepage, https://github.com/Daniel8Murphy0007/Star-Magic-Program
@@ -30,21 +30,25 @@ Requires-Dist: sympy>=1.12
 Requires-Dist: mpmath>=1.3
 Requires-Dist: numpy>=1.24
 Requires-Dist: scipy>=1.10
+Provides-Extra: modbus
+Requires-Dist: pymodbus>=3.15; extra == "modbus"
+Provides-Extra: gui
+Requires-Dist: PyQt6; extra == "gui"
 Dynamic: license-file
 
 # Star-Magic-Program
 
-[![PyPI version](https://img.shields.io/pypi/v/star-magic-program.svg?cacheBust=0.396.0)](https://pypi.org/project/star-magic-program/)
-[![Python versions](https://img.shields.io/pypi/pyversions/star-magic-program.svg?cacheBust=0.396.0)](https://pypi.org/project/star-magic-program/)
+[![PyPI version](https://img.shields.io/pypi/v/star-magic-program.svg?cacheBust=0.398.0)](https://pypi.org/project/star-magic-program/)
+[![Python versions](https://img.shields.io/pypi/pyversions/star-magic-program.svg?cacheBust=0.398.0)](https://pypi.org/project/star-magic-program/)
 [![Documentation Status](https://readthedocs.org/projects/star-magic-program/badge/?version=latest)](https://star-magic-program.readthedocs.io/en/latest/?badge=latest)
 [![License: AGPL-3.0 + Commercial](https://img.shields.io/badge/License-AGPL--3.0%20%2B%20Commercial-blue.svg)](LICENSE)
-[![Fidelity gate](https://img.shields.io/badge/fidelity_gate-5816%2F0-brightgreen)](uqff_fidelity_tests.py)
-[![Public surfaces](https://img.shields.io/badge/public_surfaces-2307-blue)](uqff_calculator.py)
-[![Whitepapers](https://img.shields.io/badge/whitepapers-2291-orange)](whitepapers/)
+[![Fidelity gate](https://img.shields.io/badge/fidelity_gate-5858%2F0-brightgreen)](uqff_fidelity_tests.py)
+[![Public surfaces](https://img.shields.io/badge/public_surfaces-2308-blue)](uqff_calculator.py)
+[![Whitepapers](https://img.shields.io/badge/whitepapers-2292-orange)](whitepapers/)
 
-**UQFF systematic rebuild — v0.396.0 complete-compile campaign live**
+**UQFF systematic rebuild — v0.398.0 complete-compile campaign live**
 
-**This release (v0.396.0): THE TWO-STREAM SHIP — THE ARCHITECTURE COMPLETE.** **PAPER_2256 + `uqff_downhole_simulator` v1.6.0:** the program's first packaged industry-application module, built from Daniel's 22Aug2026 template thread (grok_cce7a73b) on same-day GO — a deep-well HPHT simulator (TD ≈ 20,300 ft) with a quartz P/T gauge string whose drift is **suppressed by the canonical lattice**: suppression = (0.58+0.32·(1−F_TRZ))·(0.52+0.38·K_MEX)·(0.68+0.27·Φ_res) = **1.0324 at the locked {0.1, 25/12, 0.84}** — drift BELOW the 0.215 %FS/yr industry baseline. **The knob ruling (Rule 2):** the template's adjustable "K_MEX"/"Φ_res" sliders were tuning gains wearing primitive names — canonicals now LOCKED in-physics (verified live by the dispatch on every call), sliders renamed `k_structural_trim`/`phi_coupling_trim`. **v1.1.0 extensions (Daniel-directed):** N-gauge strings (`make_sensor_string`); real well profiles from CSV (`load_well_profile_csv`; the shipped sample carries an HPHT overpressure kick the linear model cannot see — 18,405 vs 9,313 psi at the deepest gauge); and **twin-gauge drift-comparison mode** — every station carries a conventional reference gauge, and away from the clip band the measured conventional/UQFF ratio EQUALS the canonical suppression (1.0325 measured vs 1.0324 predicted across a 12-gauge string on the real profile) — the PAPER_2250 quartz bench test's complete simulation instrument. **v1.2.0 extension:** service-life drift ACCUMULATION (`ServiceLifeSimulator`) — the rates integrated over simulated service years, twin-leg divergence curves (2-3 psi/yr separation per station at FS 30,000 psi, 10-15 psi at a 5-yr horizon), recalibration resets, years-to-error-budget arithmetic; the accumulated-error ratio converges to the canonical suppression at every station. **v1.3.0 extension:** field-telemetry realism (`TelemetryRecorder`) — 1-reading/min timestamped acquisition with line dropouts, stuck gauges and spikes, historian quality flags, and a scored QC pipeline (frozen-value detection 1.0/1.0; Hampel despiker with common-mode veto, spike precision 0.83-1.0) exporting field-historian-style CSVs. **v1.4.0 extension:** depth-sweep case-study mode (`case_study`/`write_markdown` + CLI) — where the advantage is largest: 2.04 psi/yr flat below the HPHT knees compounding to 3.04 psi/yr at 20,000 ft (4.21 at 27,000 ft on a 30,000-ft well), rendered as a one-page customer case with the honest DERIVED_HYBRID note. **v1.5.0 extension:** real-datasheet gauge specs (`GaugeSpec`/`GAUGE_SPECS`) — web-verified GEO PSI GEOQ 177 (Quartzdyne) presets with mandatory citations (uncited specs rejected in code), plumbed through every layer; the suppression ratio is baseline-independent while the psi/yr story honestly scales with the cited spec bound. **v1.6.0 extensions:** wellbore deviation (MD/TVD surveys — a 60-deg tangent reads 6,525 vs the vertical model's 9,315 psi at the deepest gauge), multi-well batch runs (ratio invariant across geometries), and a headless CLI (`python -m uqff_downhole_simulator run|service-life|telemetry|case-study`). The 2026-08-23 extension list is complete. **v1.7.0 (two-stream build, piece 1): the tool library** — cited catalog of 8 toolstring entries (quartz twins, piezoresistive class with ChampionX-cited exponential drift form, vibrating wire/DTS/thermocouple as PARAMETERS_USER_SUPPLIED refusing invented numbers, and the G6 Modbus-RS485 surface interface declared as the ports-layer target) + ToolString composition + station rating checks (catches a 177 °C gauge in the 217 °C kick zone). **v1.8.0 (two-stream build, piece 2): the ports/plug-in layer** — READ-ONLY ingest to the normalized LiveStream form: historian-CSV and LAS 2.0 readers IMPLEMENTED (round-trip verified against the v1.3.0 telemetry export; wrapped LAS refused, not mis-parsed), live-protocol taps (modbus_g6/witsml/opcua) DECLARED and refusing until site details exist, `register_port()` for site plug-ins, CLI `ingest` subcommand. **v1.9.0 (piece 3 — the architecture COMPLETE): the two-stream reconciler** — per-station offset series classified IN_FAMILY / CALIBRATION_OFFSET / DRIFT_CONSISTENT / TRANSIENTS / UNEXPLAINED with disclosed thresholds; validated on four scenarios incl. THE FIND: the kick well reconciled against a linear-gradient assumption flags 610/4,448/6,083 psi unexplained offsets — the closed stream exposing the undervalued data stream. CLI `reconcile` subcommand. Sixteen package files (14 modules incl. the headless CLI + README + sample profile), installable package, engine headless by design, DERIVED_HYBRID with every industry anchor inline-commented, gate-verified per run. **Totals: 2,252 wired (2,307 DISPATCH keys) / gate 5,816 green / 4,179 defs. Next paper: PAPER_2257.**
+**This release (v0.398.0): THE CATALOGUE SHIP — TEN REAL WELLS, FIVE KINDS OF REAL DATA.** `uqff_downhole_simulator` v1.14.0–v1.20.0 grows the real-well profile catalogue from three entries to **ten**, one well at a time on Daniel's standing order, every value verbatim, every entry provenance-sidecar'd, every addition gate-pinned and test-verified: **University 6-17 No.1** (Reagan County, TEXAS; API 42-303-34774; Halliburton 1997 — LAS 1.2 dialect with the value-after-colon branch, first imperial-depth well, second real BHT 141 °F @ 9,097 ft); **Collingwood 1-28** (Stanton County, KANSAS; API 15-187-20743; KGS — the first COMPLETE-file entry, a second wrapped shape at 27 curves, third real BHT 125 °F whose missing TD parameter exercises the converter's honest no-anchor fallback); **GISP2** (Greenland — THE TEMPERATURE-CURVE PRIZE: the catalogue's first continuous MEASURED temperature profile, 598 stations from 72.61 m to bedrock at 3,053.15 m, USGS/Clow via the GEUS ice-temperature database, doi:10.5194/tc-17-3829-2023 — the converter's TOP tier MEASURED_CURVES exercised with real data for the first time, closing the three-tier ladder on real wells); **Agassiz77** (Agassiz Ice Cap, Ellesmere Island, CANADIAN Arctic, 1977 — a second COMPLETE measured temperature curve, 67 stations in a different thermal regime, the catalogue's oldest measurement); **L07-01** (Petroland 1971, Dutch North Sea via NLOG — the first DESCENDING-index log, flowing converter→loader→engine order-agnostically); **the L06-06 survey** (NLOG — the FIRST REAL WELL TRAJECTORY: 200 measured stations, MD/inclination/azimuth/TVD to MD 5,605, driving `DeviationSurvey` and the engine's MD→TVD physics on real data; survey entries refuse `stream()` — kind discipline; units-undeclared ambiguity DISCLOSED, not assumed); and **Volve 15/9-19 A core analysis** (Equinor — the first LABORATORY GROUND TRUTH: 87 core-plug samples, core 1 complete plus the 20,800 mD ultra-permeability streak, permeability spanning ×138,000 in one excerpt, porosity/saturations/grain density with the lab's interleaved sample pattern preserved exactly; units interpretive-not-in-file DISCLOSED in provenance; `read_core_csv` + core-kind dispatch). Real files drove four port upgrades across the arc: wrapped-LAS parsing (superseding the v1.8.0 refusal only once a real wrapped file existed to verify against), the LAS 1.x meta branch, ~P BHT/TMAX/TDL/TDD meta anchors, and descending-index handling. Catalogue standing: **TEN entries / EIGHT regions / FIVE kinds** (log excerpts, complete logs, measured temperature curves, real trajectory, core analysis) — the closed stream now has real wells to describe, real curves to convert, a real trajectory to bend to, and lab ground truth to calibrate against. Package v1.20.0 (catalog/ 20 files, measured). **Totals: 2,253 wired (2,308 DISPATCH keys) / gate 5,858 green / 4,180 defs. Next paper: PAPER_2258.**
 
 Author: Daniel T. Murphy · Star-Magic Research Program
 License: AGPL-3.0-or-later OR Commercial
@@ -102,7 +106,7 @@ Mizuno, Rossi).
 Full framework physics lives in the whitepaper corpus — the physics is the
 whitepapers; the calculator computes what the whitepapers derive.
 
-## What is currently shipped (v0.396.0)
+## What is currently shipped (v0.398.0)
 
 ### Wiring campaign — LIVE (see `CLAUDE.md` charter)
 
@@ -110,7 +114,7 @@ Sequential wiring of all 2,255 whitepapers, starting at PAPER_001.
 Authorized 2026-07-28: autonomous band sessions, ship per session via
 `ship.ps1`, full stop at PAPER_500 for manual review.
 
-**Wired: 2,252 distinct dispatches (2307 DISPATCH keys incl. the 55 canonical alias numbers 2179-2233)** (one per paper, Rule B closed). **Complete-compile frontier: PAPER_001-1300** (+ b-variants) fully captured over a **1766-function primitive-sourced equation library** — every equation and section (core + Session-225 + Production Framework + Cosmogenesis Lagrangian + VDS/DVP/BSH + Kozima-LENR K.1-K.6) via _common_uqff_blocks, with paper-specific §B DVP prime ladder (gate-guarded), 40/40+ linked-paper mapping, and a campaign-aware XGEO chain.
+**Wired: 2,253 distinct dispatches (2308 DISPATCH keys incl. the 55 canonical alias numbers 2179-2233)** (one per paper, Rule B closed). **Complete-compile frontier: PAPER_001-1300** (+ b-variants) fully captured over a **1766-function primitive-sourced equation library** — every equation and section (core + Session-225 + Production Framework + Cosmogenesis Lagrangian + VDS/DVP/BSH + Kozima-LENR K.1-K.6) via _common_uqff_blocks, with paper-specific §B DVP prime ladder (gate-guarded), 40/40+ linked-paper mapping, and a campaign-aware XGEO chain.
 
 **Derived-constants catalog (v0.344.0):** all **1,272 unique predecessor-registry derived constants** wired and callable via `uqff_derived_constants.py` — e.g. `derived_constant("alpha_inverse")` → 137.0 (PAPER_1167), `derived_constant("astro_BH_entropy_coeff")` → 0.24833 (PAPER_594). 661 numeric, routes + provenance preserved.