feat(acms): implement UKO ontology inference engine — resource-to-RDF mapping and relationship inference #3086

Open
opened 2026-04-05 05:29:29 +00:00 by freemo · 2 comments
Owner

Metadata

  • Branch: feat/v36/uko-inference-engine
  • Commit Message: feat(acms): implement UKO ontology inference engine — resource-to-RDF mapping and relationship inference
  • Milestone: v3.6.0
  • Parent Epic: #367

Background

The UKO system must automatically infer RDF relationships from content analysis. The inference engine maps CleverAgents resource objects to UKO ontology classes, infers relationships between resources (e.g., file-in-directory, code-imports-module), and populates the triple store with these inferred triples.

Expected Behavior

  • UkoInferenceEngine class that:
    • Accepts a resource object and maps it to the appropriate UKO Layer 2 class
    • Infers structural relationships (containment, dependency, similarity)
    • Produces a set of RDF triples for insertion into the triple store
    • Supports pluggable inference strategies (structural, semantic, temporal)
  • Integration with RdfTripleStoreService for triple persistence
  • All inference is statically typed and passes nox -e typecheck

Dependencies

  • Blocked by: #3082 (triple store service must exist first)
  • Blocks: #367

Subtasks

  • Define UkoInferenceEngine abstract base class
  • Implement StructuralInferenceStrategy (containment, file hierarchy)
  • Implement ResourceToUkoMapper for mapping resource types to UKO classes
  • Wire inference engine to resource lifecycle events
  • Write Behave unit tests for each inference strategy
  • 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-inference-engine` - **Commit Message**: `feat(acms): implement UKO ontology inference engine — resource-to-RDF mapping and relationship inference` - **Milestone**: v3.6.0 - **Parent Epic**: #367 ## Background The UKO system must automatically infer RDF relationships from content analysis. The inference engine maps CleverAgents resource objects to UKO ontology classes, infers relationships between resources (e.g., file-in-directory, code-imports-module), and populates the triple store with these inferred triples. ## Expected Behavior - `UkoInferenceEngine` class that: - Accepts a resource object and maps it to the appropriate UKO Layer 2 class - Infers structural relationships (containment, dependency, similarity) - Produces a set of RDF triples for insertion into the triple store - Supports pluggable inference strategies (structural, semantic, temporal) - Integration with `RdfTripleStoreService` for triple persistence - All inference is statically typed and passes `nox -e typecheck` ## Dependencies - Blocked by: #3082 (triple store service must exist first) - Blocks: #367 ## Subtasks - [ ] Define `UkoInferenceEngine` abstract base class - [ ] Implement `StructuralInferenceStrategy` (containment, file hierarchy) - [ ] Implement `ResourceToUkoMapper` for mapping resource types to UKO classes - [ ] Wire inference engine to resource lifecycle events - [ ] Write Behave unit tests for each inference strategy - [ ] 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:29:57 +00:00
Author
Owner

Transition attempt: State/Unverified -> State/Verified

Preconditions:

  • No blocking conditions identified for this transition (not Paused).

Action attempted:

  • Removed old state label: State/Unverified
  • Added new state label: State/Verified

Current labels before change: State/Unverified, Priority/Medium, Type/Feature
Note: The Forgejo API wrapper used in this session did not apply label changes automatically for issue labels. The issue's labels remain unchanged in the UI.

Recommended next steps for maintainers:

  • Manually remove the State/Unverified label from issue #3086 and add State/Verified
  • Retain Priority/Medium and Type/Feature unless otherwise needed

If you want me to retry the label updates via alternative means, say the word.


Automated by CleverAgents Bot
Supervisor: Implementation | Agent: ca-issue-state-updater

Transition attempt: State/Unverified -> State/Verified Preconditions: - No blocking conditions identified for this transition (not Paused). Action attempted: - Removed old state label: State/Unverified - Added new state label: State/Verified Current labels before change: State/Unverified, Priority/Medium, Type/Feature Note: The Forgejo API wrapper used in this session did not apply label changes automatically for issue labels. The issue's labels remain unchanged in the UI. Recommended next steps for maintainers: - Manually remove the State/Unverified label from issue #3086 and add State/Verified - Retain Priority/Medium and Type/Feature unless otherwise needed If you want me to retry the label updates via alternative means, say the word. --- **Automated by CleverAgents Bot** Supervisor: Implementation | Agent: ca-issue-state-updater
Author
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: Medium — inference engine depends on the triple store (#3082) being available
  • Milestone: v3.6.0 (already assigned)
  • MoSCoW: Should Have — the inference engine maps resources to RDF triples. Important for the full UKO system but not blocking other v3.6.0 work.
  • Parent Epic: #367 (dependency link already exists)

Dependency chain: #3081#3082#3086#3087. Blocked by #3082.


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

Issue triaged by project owner: - **State**: Verified ✅ - **Priority**: Medium — inference engine depends on the triple store (#3082) being available - **Milestone**: v3.6.0 (already assigned) - **MoSCoW**: Should Have — the inference engine maps resources to RDF triples. Important for the full UKO system but not blocking other v3.6.0 work. - **Parent Epic**: #367 (dependency link already exists) **Dependency chain**: #3081 → #3082 → **#3086** → #3087. Blocked by #3082. --- **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:05 +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.

Reference
cleveragents/cleveragents-core#3086
No description provided.