Known Issues
Audience: preview users and support
Status: Preview
This page tracks issues that are known before the commercial MVP is declared ready. It should be updated with every preview release.
Activation
Section titled “Activation”- Account login is not configured yet.
- Stripe-backed subscription activation is not live.
- A missing license certificate is expected in the preview build unless a signed preview certificate has been imported.
- Workbench paid feature unlocks are not live yet.
Workaround: use ophiolite auth status, ophiolite auth import <license_json_path>, and ophiolite doctor for the local certificate path.
Packaging
Section titled “Packaging”- The first
ophiolite-sdkwheel lane is macOS 14+ Apple Silicon with Python 3.10-3.12. - Windows and Linux wheels are not the first public preview lane.
- The Workbench signed installer path is not live yet.
Workaround: use the supported wheel lane or source checkout path for contributor work.
Workflow Scope
Section titled “Workflow Scope”.tbflowis the preferred authoring surface, but visual workflow authoring depth is still narrow.- Current
.tbflowsection smoke support is limited to documented section methods such asamplitude_scalar,trace_rms_normalize, andagc_rms. - Large-result streaming/windowing is still narrower than the long-term product target.
Workaround: use the documented proof paths and keep private large-dataset trials behind explicit smoke checks.
Bundles And Compatibility
Section titled “Bundles And Compatibility”- Preview bundles should remain inspectable when practical, but rerun/replay compatibility is narrower than read compatibility.
- Evidence-only artifacts may not contain full numeric outputs.
- Migration tooling exists only where the compatibility promise requires it.
Workaround: keep the original source data and workflow script with important preview bundles.
Diagnostics
Section titled “Diagnostics”- Workbench diagnostics export is available through the desktop runtime.
- Browser-only development sessions cannot export the native diagnostics bundle.
- Diagnostics redact sensitive paths in structured metadata by default, but logs should still be reviewed before sharing.
Workaround: reproduce desktop issues in the Tauri runtime and export diagnostics before restarting or clearing state.
Next: Troubleshooting