Production readiness and pilot criteria¶
This page states what OntoCode / OntoIndex v0.8.0 is appropriate for in production-like environments. It is not legal advice and does not replace your organization's risk review.
Canonical capability matrix: What ships today.
Maturity model¶
| Level | Version | Meaning |
|---|---|---|
| Pre-1.0 | 0.8.x (current) | Active development. Library APIs, LSP JSON, and SQL virtual table columns may change between minor releases until v1.0. |
| Stable CI gates | 0.8.x | ontoindex validate and ontoindex classify exit codes are documented and intended for CI — see workspace limits. |
| v1.0 target | Planned | Protégé-competitive OWL 2 DL + OBO in VS Code per Protégé parity. |
OntoCode v0.8 is not documented as a general-availability replacement for Protégé or full OWL 2 DL engineering.
Approved use cases (pilot or production)¶
| Use case | v0.8 readiness | Notes |
|---|---|---|
| CI lint gate on ontology repos | Suitable | ontoindex validate — CI integration |
| CI consistency gate (EL profile) | Suitable | ontoindex classify --profile el — profile must match ontology |
| Developer IDE for Turtle authoring | Pilot | Turtle write-back only; pre-1.0 extension APIs |
| Workspace refactoring (rename, migrate, move, extract) | Pilot | Turtle only; preview before apply — Refactoring guide |
| Git-native ontology browse/query in VS Code | Pilot | Local-first; see enterprise deployment |
| Air-gapped VS Code install | Pilot | VSIX + SHA256 — enterprise deployment |
| OBO index + ROBOT CLI in CI | Pilot | Index .obo; ontoindex robot validate — requires Java + robot on PATH — ROBOT interop |
| Replace Protégé for OWL 2 DL | Not supported | Keep Protégé — Protégé coexistence |
| Full OBO write-back in VS Code | Not supported | OBO is read-only in inspector; Turtle write-back only |
| Org-wide mandatory IDE standard | Defer | Complete pilot + legal review first |
Pilot criteria (recommended before wider rollout)¶
Complete these on a representative ontology project (not only tutorial fixtures):
- Functional fit — Compare Protégé parity against required axiom types and reasoning profile.
- Sizing — Confirm workspace within limits; run production evidence protocol on your corpus — performance and sizing.
- Security — Platform review of security policy and enterprise deployment (LSP stdio, Restricted Mode, path jail).
- Legal — Review LGPL (
horned-owl) and third-party notices — LGPL compliance. - CI proof —
validateand optionalclassifyin a test pipeline on real branches. - Coexistence — If migrating from Protégé, follow Protégé coexistence split workflow for 1–2 release cycles.
- Exit criteria — Define what would trigger rollback (e.g. unsatisfiable-class false positives, scale failures, DL axiom editing gaps).
Suggested pilot duration: 4–8 weeks with 3–10 engineers on one ontology repository.
What is stable enough for automation¶
| Surface | Stability (v0.8) |
|---|---|
ontoindex validate exit codes |
Documented for CI |
ontoindex classify exit codes |
Documented for CI |
| SQL virtual table column names | May change pre-1.0 |
LSP ontoindex/* JSON |
May change pre-1.0 |
Rust ontoindex-* crate APIs |
May change pre-1.0 |
Pin CLI version in CI: release binary with VERSION=0.8.0 or cargo install ontoindex-cli --locked --version 0.8.0.
Support and incident response¶
| Topic | v0.8 policy |
|---|---|
| Commercial support | Not offered — community / GitHub issues |
| Security reports | GitHub Security Advisories — not public issues |
| Acknowledgment target | Within a few business days (SECURITY.md on GitHub) |
| Patch SLA | No committed SLA — track GitHub Security Advisories for your version |
| Supported versions | 0.8.x (security policy) |
Enterprises requiring contractual SLAs should treat OntoCode as internal OSS adoption with your own escalation path to maintainers via GitHub.
Compliance questionnaires (honest answers)¶
| Question | Answer from documentation |
|---|---|
| Is data sent to the vendor cloud? | No by default — local-first (security) |
| SOC 2 / ISO 27001 certified? | No — not claimed |
| HIPAA BAA available? | No |
| Telemetry? | None shipped |
| Code-signed binaries? | Not yet — SHA256 only (release integrity) |
Reference architecture (pilot)¶
Developers (VS Code + OntoCode VSIX)
│
▼
ontoindex-lsp (stdio, local)
│
▼
Git repo (.ttl primary, .obo index, .owl read-only)
│
▼
CI pipeline (ontoindex validate / classify / robot)
│
▼
Optional: Protégé for DL review