Repair complete value-chain Colab PyPI provenance and rendering

[EvenSol]

Purpose

Repair the complete oil and gas value-chain notebook so its Colab setup uses the released public-PyPI neqsim package instead of cloning and source-building Java master. Preserve every merged example, cell, output, and visual.

This draft replaces #111 on a clean branch based exactly on current master b092f7dd; no force-update was used.

Changes

• install neqsim from public PyPI when absent and record package, bundled-JAR, SHA-256, Java, API-smoke, and JPype-classpath provenance;
• fail loudly under NEQSIM_VALIDATION_OFFLINE=1 if the verified validation environment is incomplete, rather than attempting network installation;
• convert all ten display equations to the repository's Colab-safe standalone $$ form;
• preserve and refresh all 17 numerical figures, including the accessible orange/blue decision-gate matrix;
• retain current-master FEM catalog additions while updating the value-chain description and maintenance evidence.

Preservation

• 52/52 merged-master cells preserved; 0 removed;
• 23 code and 29 Markdown cells;
• 17 pre-existing lifecycle applications and 17 figures preserved;
• 17/17 figure datasets recomputed; 0 figures removed or substituted.

Validation

• NeqSim 3.17.0, Python 3.12.13, OpenJDK 17.0.19;
• online-new-snapshot: 49 verified public-PyPI wheels for execution and 62 for rendering;
• final clean run: 23/23 code cells in 8.1 s, zero exceptions, stored error outputs, or notebook stderr;
• all 25 integrated checks pass; maximum connected process mass residual 6.034e-14;
• six connected ProcessSystem scenarios converge; PVT-support, hydraulic, ISO 6976, reservoir/facility, emissions, economics, RAM, and gate checks pass;
• all engineering outputs and all 17 PNG hashes are identical to the prior NeqSim 3.16.0 run;
• 17 figures and ten equations passed HTML/MathJax-compatible and visual inspection;
• code readability, nbformat/JSON, equation-delimiter, catalog-entry, and ledger gates pass locally.

Documentation impact

Notebook setup/provenance, offline-validation behavior, Colab equations, accessible decision-gate graphic, catalog description, and maintenance ledger are updated. No NeqSim Java API or physics changed.

Limitations

The PVT data, forecasts, reliability, emissions, and economics remain synthetic teaching screens. NeqSim supports but does not own the laboratory PVT basis. No upstream NeqSim defect was found.

[EvenSol]

Final validation for exact head a2bc3894ee9e5c9e1663f413eab5e061eb3786b8:

• branch is based on current master b092f7dd, five commits ahead and zero behind; GitHub reports it mergeable;
• exact-head Notebook integrity run Add reservoir-to-market system curve notebook #64 / 31290035532 passed, including unit tests and repository-wide notebook integrity;
• fresh bootstrap resolved NeqSim 3.17.0 from public PyPI with online-new-snapshot; execution used 49 verified wheels and rendering used 62;
• Python 3.12.13, OpenJDK 17.0.19, JAR SHA-256 f114c17bf99a7b02be9f8c49b66fd792c88fdcbfcb043487481fb0bf23298556;
• 23/23 code cells executed in order in 8.1 s with zero exceptions, error outputs, or notebook stderr;
• 25/25 engineering checks passed; maximum connected mass residual 6.034e-14;
• all 52 pre-existing cells, 17 substantive applications, and 17 figures are preserved;
• all engineering values and all 17 figure hashes are identical to the prior NeqSim 3.16.0 execution;
• nbformat/JSON, teaching-code readability, 100-character line target, equation delimiters, ten rendered equations, HTML conversion, and visual inspection of all 17 figures passed;
• no upstream NeqSim defect was found;
• no reviews, requested changes, Copilot suggestions, or review threads were present after the latest push.

Documentation impact: notebook setup/provenance and fail-loud offline validation behavior, Colab equations, catalog description, and maintenance evidence are updated. No NeqSim Java API or physics changed.