How ruc-datalab/evoontology works
EvoOntology provides a versioned semantic layer for data agents, accessed through MCP and adapted from workload and execution history. The main workflow prepares workload evidence, builds and publishes grounded ontology versions, serves semantics on demand, records task trajectories, and uses evolution diagnosis and paired evaluation to gate candidate updates. The graph emphasizes the canonical package; plugin copies expose the same core for Claude Code and Codex. Some subsystem relationships are documented in the README, while unsampled implementation details are left unconnected.
Main entry points: session.py Evolution Session · ops.py Lifecycle Operations · store.py Versioned Store · runtime.py Semantic Runtime
Components 19
Workspace & Ontology
- Workspace Context
evoontology/workspace.py - Ontology Records
evoontology/ontology/models.py - Versioned Store
evoontology/ontology/store.py
Agent Runtime
- Semantic Runtime
evoontology/runtime/runtime.py - Semantic Tools
evoontology/runtime/tools.py - MCP Server
evoontology/runtime/mcp_server.py
Workload & Evolution
- Workload Workflow
evoontology/workflow.py - Lifecycle Operations
evoontology/runtime/ops.py - Task Trajectories
evoontology/trajectory/trajectory.py - Evolution Trigger
evoontology/trigger/trigger.py - Evolution Session
evoontology/evolution/session.py - Candidate Evaluation
evoontology/evaluation/evaluation.py - Ontology Validation
evoontology/validate.py
Adapters & Views
- Agent Adapter
evoontology/evolution/adapter.py - Ontology Preview
evoontology/visualization/preview.py - Ontology Renderer
evoontology/visualization/renderer.py - Claude Code Plugin
plugins/claude-code/evoontology/runtime/mcp_server.py - Codex Plugin
plugins/evoontology-codex/evoontology/runtime/mcp_server.py
Other components
- Data Agent
Connections 23
- Data Agent → MCP Server: queries semantics
README.md - MCP Server → Semantic Runtime: dispatches tools
- Semantic Tools → Semantic Runtime: exposes operations
- Semantic Runtime → Versioned Store: reads version
evoontology/runtime/runtime.py - Versioned Store → Ontology Records: loads records
evoontology/ontology/store.py - Workload Workflow → Workspace Context: uses workspace
evoontology/workflow.py - Workload Workflow → Task Trajectories: reads history
evoontology/workflow.py - Lifecycle Operations → Workload Workflow: invokes workflow
evoontology/runtime/ops.py - Lifecycle Operations → Evolution Session: starts evolution
evoontology/runtime/ops.py - Lifecycle Operations → Evolution Trigger: checks due state
evoontology/runtime/ops.py - Lifecycle Operations → Ontology Validation: validates versions
evoontology/runtime/ops.py - Lifecycle Operations → Ontology Preview: previews ontology
evoontology/runtime/ops.py - Task Trajectories → Workspace Context: stores in workspace
evoontology/trajectory/trajectory.py - Evolution Trigger → Task Trajectories: counts new tasks
evoontology/trigger/trigger.py - Evolution Session → Evolution Trigger: consults gate
evoontology/evolution/session.py - Evolution Session → Candidate Evaluation: runs comparisons
evoontology/evolution/session.py - Evolution Session → Ontology Validation: validates candidate
evoontology/evolution/session.py - Evolution Session → Versioned Store: publishes candidate
evoontology/evolution/session.py - Agent Adapter → Evolution Session: supports session
evoontology/evolution/session.py - Ontology Renderer → Versioned Store: reads ontology
evoontology/visualization/renderer.py - Ontology Renderer → Semantic Runtime: renders runtime
evoontology/visualization/renderer.py - Claude Code Plugin → Data Agent: integrates agent
README.md - Codex Plugin → Data Agent: integrates agent
README.md