ophiolite-sdk 0.1.1

Local-first subsurface workflow SDK and install diagnostics for Ophiolite

ophiolite-sdk

ophiolite-sdk provides the ophiolite_sdk Python package and the local ophiolite command surface for Ophiolite's preview subsurface workflow SDK.

The current public wheel is an early macOS Apple Silicon preview for Python 3.10-3.12. It bundles the native Ophiolite CLI so a clean install can run ophiolite doctor without a source checkout.

It does not introduce a second backend. Automation commands shell out to the existing JSON-producing CLI so scripts, notebooks, and local automation can reuse the same platform-owned operation surface.

Install

python -m pip install ophiolite-sdk
ophiolite doctor
ophiolite auth status

The current preview reports a license warning until commercial activation is implemented. Other doctor failures should be treated as install issues.

Scope

Current wrapped platform operations:

• project lifecycle and inventory
• well, wellbore, and survey discovery
• well-panel, survey-map, trajectory, and section-overlay resolution
• operator lock inspection and operator package installation
• compute catalog lookup and compute execution
• install doctor and local license certificate inspection
• import preview, vendor bridge, and fixture-generation utilities

The Python wrapper stays checked against the platform operation catalog, so the wrapped CLI surface does not drift silently.

Usage

For a source checkout:

python -m pip install -e .
ophiolite doctor
ophiolite auth status
ophiolite-automation operation-catalog

ophiolite is the preferred command name for user-facing install checks. ophiolite-automation remains available as the explicit automation wrapper name.

Build the preview SDK package from the python/ directory with:

python -m pip install --upgrade build
python -m build

Or from Python:

from ophiolite_automation import OphioliteApp

app = OphioliteApp()
catalog = app.operation_catalog()
print(catalog["catalog_name"])

Surface Conformance

Ophiolite keeps a checked-in platform operation catalog at crates/ophiolite-cli/operations/catalog.json.

Run the Python-side conformance check with:

ophiolite-automation verify-surface-contracts