Skip to content

Migration: v0.20.0 → v0.21.0

Status: Applies when upgrading from v0.20.0 to tagged v0.21.0.

Summary

v0.21.0 delivers required format write-back: RDF/XML (.owl / .rdf) and OWL/XML (.owx) support open → edit → save → reload without semantic loss. Edits still flow through ontocore-edit::Transaction / Turtle-shaped PatchOp JSON; XML documents use Horned load → mutate → full-document re-serialize (ADR-0021), not Turtle span surgery.

What changed for editors

  • Entity Inspector and catalog editable flags: true for successfully parsed .owl / .rdf / .owx (same as Turtle/OBO for root documents).
  • LSP ontocore/applyAxiomPatch accepts those formats (no longer returns read-only).
  • CLI ontocore patch accepts .owl, .rdf, and .owx in addition to .ttl / .obo.
  • XML re-serialization may rewrite prefix order and formatting; verify with semantic compare / reindex, not diff of raw XML.

Supported XML patch operations

Supported in the first cut: create/delete entity, labels/comments/generic annotations, SubClassOf add/remove, imports, ontology IRI / version IRI, class assertions.

Unsupported ops (for example AddPrefix, complex Manchester SubClassOf, many property characteristics) return structured errors and do not rewrite the file.

What did not change

  • Turtle span surgery and OBO stanza surgery unchanged
  • Refactor apply remains Turtle-only
  • JSON-LD / TriG / N-Triples write-back still out of scope
  • Wire format for patch JSON arrays / transaction envelopes unchanged for Turtle-shaped ops

Upgrade steps

  1. Bump OntoCode extension and ontocore CLI to 0.21.0
  2. No migration of saved patch payloads required
  3. If you previously dual-maintained .ttl copies solely for editing RDF/XML sources, you can edit the XML files in place (optional cleanup)