feat(acms): define UKO RDF ontology schema — Layer 0 core classes and Layer 1 domain vocabularies #3081

Open
opened 2026-04-05 05:25:45 +00:00 by freemo · 1 comment
Owner

Metadata

  • Branch: feat/v36/uko-rdf-ontology-schema
  • Commit Message: feat(acms): define UKO RDF ontology schema — Layer 0 core classes and Layer 1 domain vocabularies
  • Milestone: v3.6.0
  • Parent Epic: #367

Background

The Universal Knowledge Ontology (UKO) is an RDF-based, inheritance-driven ontology that represents resources at multiple levels of abstraction with provenance and temporal versioning. The spec defines a multi-layer ontology:

  • Layer 0: Core abstract classes (UKO_INFORMATION_UNIT, UKO_ANNOTATION, UKO_RESOURCE, UKO_AGENT, UKO_EVENT)
  • Layer 1: Domain vocabularies (uko-doc:, uko-data:, uko-infra:)
  • Layer 2: Concrete resource types mapped from the resource model

Currently, only 4 of 5 Layer 0 constants are exported from vocabularies.py (see #2617), and Layer 1 domain vocabularies are absent from the public API (see #2945).

Expected Behavior

  • All 5 Layer 0 UKO class constants are defined and exported from cleveragents.acms.uko.vocabularies
  • Layer 1 domain vocabulary namespaces (uko-doc:, uko-data:, uko-infra:) are defined and exported
  • RDF schema (.ttl or .owl) file is included in the package for the full UKO ontology
  • All vocabulary constants are statically typed and pass nox -e typecheck

Dependencies

  • Blocked by: (none — foundational)
  • Blocks: #367

Subtasks

  • Add missing UKO_ANNOTATION and UKO_INFORMATION_UNIT constants to vocabularies.py
  • Define Layer 1 namespace prefixes: uko-doc:, uko-data:, uko-infra:
  • Create RDF/OWL schema file for the full UKO ontology
  • Export all vocabulary constants from the cleveragents.acms.uko public API
  • Write Behave unit tests for all vocabulary constants and namespace resolution
  • Ensure nox -e typecheck passes with no suppressions

Definition of Done

  • All subtasks completed
  • Tests written and passing
  • All nox stages pass
  • Coverage >= 97%

Automated by CleverAgents Bot
Supervisor: Acting on behalf of: UAT Testing | Agent: ca-epic-planner

## Metadata - **Branch**: `feat/v36/uko-rdf-ontology-schema` - **Commit Message**: `feat(acms): define UKO RDF ontology schema — Layer 0 core classes and Layer 1 domain vocabularies` - **Milestone**: v3.6.0 - **Parent Epic**: #367 ## Background The Universal Knowledge Ontology (UKO) is an RDF-based, inheritance-driven ontology that represents resources at multiple levels of abstraction with provenance and temporal versioning. The spec defines a multi-layer ontology: - **Layer 0**: Core abstract classes (`UKO_INFORMATION_UNIT`, `UKO_ANNOTATION`, `UKO_RESOURCE`, `UKO_AGENT`, `UKO_EVENT`) - **Layer 1**: Domain vocabularies (`uko-doc:`, `uko-data:`, `uko-infra:`) - **Layer 2**: Concrete resource types mapped from the resource model Currently, only 4 of 5 Layer 0 constants are exported from `vocabularies.py` (see #2617), and Layer 1 domain vocabularies are absent from the public API (see #2945). ## Expected Behavior - All 5 Layer 0 UKO class constants are defined and exported from `cleveragents.acms.uko.vocabularies` - Layer 1 domain vocabulary namespaces (`uko-doc:`, `uko-data:`, `uko-infra:`) are defined and exported - RDF schema (`.ttl` or `.owl`) file is included in the package for the full UKO ontology - All vocabulary constants are statically typed and pass `nox -e typecheck` ## Dependencies - Blocked by: (none — foundational) - Blocks: #367 ## Subtasks - [ ] Add missing `UKO_ANNOTATION` and `UKO_INFORMATION_UNIT` constants to `vocabularies.py` - [ ] Define Layer 1 namespace prefixes: `uko-doc:`, `uko-data:`, `uko-infra:` - [ ] Create RDF/OWL schema file for the full UKO ontology - [ ] Export all vocabulary constants from the `cleveragents.acms.uko` public API - [ ] Write Behave unit tests for all vocabulary constants and namespace resolution - [ ] Ensure `nox -e typecheck` passes with no suppressions ## Definition of Done - [ ] All subtasks completed - [ ] Tests written and passing - [ ] All nox stages pass - [ ] Coverage >= 97% --- **Automated by CleverAgents Bot** Supervisor: Acting on behalf of: UAT Testing | Agent: ca-epic-planner
freemo added this to the v3.6.0 milestone 2026-04-05 05:26:38 +00:00
Author
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: Medium — foundational ontology work, not blocking any immediate milestone deadline but required for the RDF system chain
  • Milestone: v3.6.0 (already assigned)
  • MoSCoW: Should Have — the UKO ontology schema is the foundation for the entire Multi-Agent RDF System (Epic #367). Per the specification, the UKO system is part of the advanced ACMS pipeline. It is important for v3.6.0 scope but not strictly essential for the milestone to ship.
  • Parent Epic: #367 (dependency link already exists)

Dependency chain: This is the first issue in the chain: #3081#3082#3086#3087. Work should begin here.


Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: ca-project-owner

Issue triaged by project owner: - **State**: Verified ✅ - **Priority**: Medium — foundational ontology work, not blocking any immediate milestone deadline but required for the RDF system chain - **Milestone**: v3.6.0 (already assigned) - **MoSCoW**: Should Have — the UKO ontology schema is the foundation for the entire Multi-Agent RDF System (Epic #367). Per the specification, the UKO system is part of the advanced ACMS pipeline. It is important for v3.6.0 scope but not strictly essential for the milestone to ship. - **Parent Epic**: #367 (dependency link already exists) **Dependency chain**: This is the first issue in the chain: #3081 → #3082 → #3086 → #3087. Work should begin here. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: ca-project-owner
freemo removed this from the v3.6.0 milestone 2026-04-07 00:20:18 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks
#367 Epic: Multi-Agent RDF System
cleveragents/cleveragents-core
Reference
cleveragents/cleveragents-core#3081
No description provided.