Metadata-Version: 2.4
Name: ophiolite-sdk
Version: 0.1.2
Summary: Local-first subsurface workflow SDK and install diagnostics for Ophiolite
Author: Ophiolite
Maintainer: Ophiolite
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://ophiolite.dev
Project-URL: Documentation, https://ophiolite.dev/docs/
Project-URL: System Requirements, https://ophiolite.dev/docs/start-here/system-requirements/
Project-URL: Issue Intake, https://ophiolite.dev/docs/start-here/current-scope-and-maturity/
Keywords: geoscience,subsurface,seismic,well-logs,workflow
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: <3.13,>=3.10
Description-Content-Type: text/markdown

# 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

```bash
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:

```bash
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:

```bash
python -m pip install --upgrade build
python -m build
```

Or from Python:

```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:

```bash
ophiolite-automation verify-surface-contracts
```
