OntoKit demo: preview how communities build the Catholic Semantic Canon and FOLIO together. Suggestions here land in demo copies on GitHub, never the official ontologies.

OntoKit

Changelog

Summary of changes for each release.

0.3.0

2026-04-09

New features

  • Projects list as landing page with Public, My Projects, Private, and All tabs.
  • Separate viewer and editor routes for projects with role-appropriate default views.
  • Ontology search index management UI for PostgreSQL-backed entity indexing.
  • Multi-page Ontology Guide documentation accessible from the app.
  • Upstream source loop prevention UI with informational banners when sync config matches GitHub integration.
  • Exemplar ontology support in project UI for template-based project creation.
  • Explicit Save button in detail panel edit mode.
  • Branch topology visualization in revision history graph.
  • Share button to copy project permalink.
  • Unfiltered project count shown when search or filter is active.

Improvements

  • Upgraded to Next.js 16, Tailwind CSS 4, Zod 4, and lucide-react 1.7.
  • Renamed 'upstream sync' to 'remote sync' / 'Sync from Remote' for clarity.
  • Renamed misleading 'Private' tab to 'My Projects'.
  • Skip project dashboard — navigate directly to editor.
  • Improved auth UX for private projects in the editor.
  • Improved import error UX with server-reachability probe.
  • Improved lint issue display consistency and prevented UI freeze on large rule sets.
  • Replaced window.location.reload() with React Query refetch for smoother navigation.
  • Removed accessToken from React Query keys to prevent unnecessary refetches.
  • Disabled branch switching for unauthenticated users.
  • Moved Tooltip provider to app level for shared usage.
  • Docker deployment configuration with multi-stage build.
  • Test coverage increased to 80% with 2400+ tests.

Bug fixes

  • Fixed viewer source tab appearing empty in developer mode.
  • Fixed total project count not shown with Load More pagination.
  • Fixed duplicate BranchBadge in editor header.
  • Fixed nullable index fields from API causing runtime errors.
  • Fixed manualSave prop renamed to hideSaveButton with correct default behavior.
  • Fixed exhaustive-deps false positive in useProjectViewer.
  • Resolved Dependabot security alerts and CodeQL findings.

CI/CD & Quality

  • Split CI quality gate into parallel lint, type-check, test, and build jobs.
  • Added Codecov bundle analysis and test coverage reporting.
  • Upgraded Vite to 8.0.7 for security fix.

0.2.0

2026-03-09

New features

  • Form-based entity editing for classes, properties, and individuals replacing raw Turtle source editing.
  • Standard/Developer mode toggle with persistent preference for simplified or advanced editing views.
  • Suggestion workflow: new 'suggester' role allows non-editors to propose changes with mandatory editor review.
  • Two-tier auto-save system: on blur saves drafts to localStorage, navigation commits to git.
  • Interactive graph visualization using React Flow with ELK layout for exploring ontology relationships.
  • Drag-and-drop class reparenting with cycle detection and undo support.
  • Context menus (right-click) for Add Subclass, Copy IRI, View in Source, and Delete operations.
  • Notification system with polling and event-driven refetch for suggestion and collaboration updates.
  • Entity history tab with revision tracking.
  • Similar concepts panel and cross-references panel for entity discovery.
  • SPARQL query execution support (SELECT/ASK/CONSTRUCT) on the backend.
  • Semantic search using vector similarity with pluggable embedding providers (OpenAI, Voyage, local).
  • Duplicate detection with union-find clustering and similarity scoring.
  • Consistency checking: cycle detection, class hierarchy validation, and deprecated entity tracking.
  • Full dark mode support with theme sync preventing flash of unstyled content.
  • Keyboard shortcuts: Ctrl+S to flush drafts, Ctrl+N to create entities, ? for help.

Improvements

  • Shared FOLIO-style tree renderer reused across Classes, Properties, and Individuals.
  • Multi-level expand/collapse controls with split-button for one level or all/none.
  • Auto-expand on 800ms hover during drag operations.
  • Language tags displayed as country flag emojis.
  • Resizable panel dividers for tree/detail layout.
  • Delete impact analysis before entity removal.
  • API retry logic with 30s timeout and exponential backoff.
  • Rate limiting via slowapi (100 req/min default).
  • Security headers: X-Content-Type-Options, X-Frame-Options, HSTS, CSP.
  • Request ID middleware with unique X-Request-ID header and access logging.
  • Zod-based environment variable validation on the frontend.
  • ESLint flat config migration with stricter TypeScript rules.

Accessibility

  • Skip links in layout for keyboard navigation.
  • Screen reader announcer with polite and assertive live regions.
  • ARIA labels on all icon buttons.
  • Reduced motion and high contrast media query support.
  • Tree keyboard navigation with aria-activedescendant.

Testing & Quality

  • 111 new tests added across frontend (26) and backend (85).
  • CI/CD pipeline with GitHub Actions: lint, type-check, test, and build stages.
  • All 178 mypy strict-mode errors fixed on the backend.
  • Pre-commit hooks with ruff and mypy for the backend.

Bug fixes

  • Fixed session expiry guard detecting RefreshAccessTokenError and auto-redirecting to login.
  • Fixed HttpUrl crash in class tree sort keys.
  • Fixed stale search/autocomplete responses with proper IRI handling.
  • Fixed language flag alignment with invisible placeholders.
  • Fixed falsy 0.0 similarity lookup in semantic search.
  • Fixed beacon token payload type validation.
  • Fixed branch cleanup on suggestion commit failures.

0.1.0

2026-02-18

New features

  • Initial release of OntoKit as a standalone package.
  • Renamed package from 'app' to 'ontokit' with consistent module imports.
  • Added CLI entry point ('ontokit' command) installed via pyproject.toml scripts.
  • Weblate-style version management in ontokit/version.py with dynamic version in pyproject.toml via hatch.
  • CI/CD pipeline with GitHub Actions: lint, test, build, and publish to PyPI on tagged releases.
  • Docker image publishing as part of the release workflow.
  • Bare git repository service using pygit2 for concurrent access to ontology projects.
  • Three-panel ontology editor with class tree, detail panel, and Turtle source editor.
  • Branch-based workflow with pull requests for collaborative ontology editing.
  • Ontology health check (linter) with 20+ semantic validation rules.
  • Role-based access control with Owner, Admin, Editor, and Viewer roles.