Automation and stability (pre-1.0)¶

This page answers one question: what can you safely automate against OntoCore today?

Stable enough for CI gates (recommended)¶

These are documented and intentionally stable for automation:

• ontocore validate — exit code gates on diagnostic errors
• ontocore classify — exit code gates on consistency/unsatisfiable classes
• ontocore diff — documented CLI usage (pin version pre-1.0)

See:

• CI integration
• Workspace limits

Pinning guidance (strongly recommended)¶

Until v1.0, minor releases may change non-gate details. For reproducible pipelines:

• Pin the CLI in CI:
• cargo install ontocore-cli --locked --version 0.18.2, or
• Linux x64: pinned release binary + SHA256 verification

Surfaces that may change pre-1.0¶

• SQL virtual table column names and supported SQL subset
• LSP ontocore/* JSON payload shapes
• Plugin API surface beyond the shipped host MVP

For integrations, treat these as versioned contracts and pin your deployed version:

• LSP API + schema
• SQL reference
• Plugin authoring