Skip to main content
OLM Agent · First-class member of the ArcaQ constellation

OLM Agent — Ontology Lifecycle Management

OLM is not just a router. It is a first-class agent in the ArcaQ constellation with its own event bus, emitting lifecycle transitions that feed the correlation pipeline across HGT, GNN, causal reasoning and SCAG.

§0 — OLM as a First-Class Agent

OLM owns the ontology lifecycle end-to-end and publishes structured events that other agents consume.

📡

Agent Event Bus

Every state transition emits a olm:LifecycleEvent to the agent bus. Subscribers include the swarm orchestrator, the SOC collector, and the OLM Enrichment Dashboard.

🧠

Correlation Pipeline

OLM events are correlated with HGT link-prediction candidates, GNN federated signals, causal edge discoveries and SCAG filter verdicts before any graph write.

📊

OLM Enrichment Dashboard

Live view of Qdrant → LLM → SHACL → Jena pipeline state, causal workflow stages, HGT consensus tiers and PROV-O lineage per enrichment event.

🔒

PROV-O Lineage

Each transition is traced with prov:wasGeneratedBy, model version, timestamp and validator identity — auditable end-to-end.

KEDA Scaling

OLM workers scale from zero based on lifecycle-event backlog, keeping CPU free for the Agent Control Plane and on-premise LLM inference.

§1 — The 6-State Lifecycle

Every plm:OntologyProduct instance transitions through well-defined states. Illegal transitions are blocked at the RDF level.

DRAFT
Active editing,
no constraints enforced
IN_REVIEW
Submitted for
peer validation
APPROVED
All validators
approved · live
DEPRECATED
Soft-removed,
still queryable
ARCHIVED
Read-only,
sealed forever

Rejection loop: IN_REVIEW → REJECTED → DRAFT

§2 — State Transitions

Each trigger is a plm:StateTransition instance in the knowledge graph — machine-enforceable, SPARQL-queryable.

Trigger From State To State Requires
submit_for_review DRAFT IN_REVIEW Owner action
approve IN_REVIEW APPROVED ValidationRecord + Quorum + Four-eyes
reject IN_REVIEW REJECTED Validator decision · reason required
revise REJECTED DRAFT Owner action
deprecate APPROVED DEPRECATED Admin or Architecture Board
archive DEPRECATED ARCHIVED Must have plm:deprecatedAt
force_reinstate ARCHIVED DRAFT Emergency: Architecture Board only

§3 — Governance Rules

Three SPARQL-enforced constraints protect every ontology product from governance failures.

👁️‍👁️

Four-Eyes Principle

The ontology owner (plm:hasOwner) cannot be their own validator. The SHACL constraint plm:FourEyesConstraintShape blocks self-approval at query time.

Quorum Approval

APPROVED status requires all assigned validators to have an APPROVED plm:ValidationRecord. A single REJECTED vote triggers immediate rejection.

🕓

Temporal Sealing

ARCHIVED products must carry a plm:deprecatedAt timestamp. The SHACL shape plm:ArchivedRequiresDeprecatedAtShape enforces this immutably.

📋

Change Events

Every state transition generates an immutable plm:ChangeEvent in Jena Fuseki — who, when, from which state, to which state, and why. Full sovereign audit trail.

📜

SHACL Shapes

8 property constraints on plm:OntologyProductShape: ontologyId, namedGraph, SemVer version pattern, closed-set lifecycleState, owner cardinality exactly-1, and more.

🔗

OLM Maturity Levels

FULL — complete contract, quorum validation, aligned to standards. PARTIAL — contract defined, validation incomplete. NONE — bootstrap product, governance not yet applied.

§4 — The OntologyContract

An plm:OntologyContract is a single executable Turtle document bundling five sections into one machine-verifiable artefact.

🪪

§1 Metadata

contractId, namespace URI, approval gate (e.g. "ArcaQ_Architecture_Board"), status (active / draft / archived), SemVer version, provenance dates.

🧬

§2 Semantics T-Box

Fingerprint of all class + property URIs the contract covers. OWL axioms (disjointWith, TransitiveProperty, IrreflexiveProperty) embedded inline.

✔️

§3 Validation SHACL

Property shapes, cardinality rules, controlled vocabulary constraints, and SPARQL-based cross-instance constraints — all embedded in the contract TTL.

📦

§4 Versioning Policy

Three modes: IMMUTABLE_INSTANCES, VERSIONED_SNAPSHOT, MUTABLE_WITH_AUDIT. Immutability rules seal specific properties with optional SPARQL pre-conditions.

📤

§5 Interoperability

Standard alignments (DAMA-DMBOK, ISO-27001, GDPR-Art5, W3C-PROV, W3C-DCAT) with plm:mappingConfidence 0–1 scores + gateway definitions (SPARQL, RML, SHACL).

📤

Export Formats

Every contract can be exported from the ArcaQ dashboard as Turtle (.ttl), JSON-LD (.jsonld), or YAML (.yaml) — no tooling required.

§5 — Standard Alignments in arcaq-core

The reference contract arcaq-core-contract declares alignment confidence for 5 industry standards.

StandardVersionConfidenceScope
DAMA-DMBOK2nd Ed.
90%
Data quality & governance framework
ISO/IEC 270012022
80%
Information security management
GDPR Art. 52025
95%
Personal data processing principles
W3C PROV-O2013
85%
Provenance ontology & lineage
W3C DCAT v32024
75%
Data catalog vocabulary

§6 — 82 Ontologies · One Registry

ArcaQ's OLM registry tracks all 82 domain ontologies — from core governance to industry verticals, Moroccan legal frameworks, world religions, and geo-political regions.

🏛️ Core (8)

arcaq-core, governance, provenance, bitemporal, cultural, temporal-neurosymbolic, OLM schema, SHACL

🏭 Industries (22)

aerospace, agriculture, artisanat, automotive, construction, defense, education, energy, finance, food, healthcare…

⚖️ Moroccan Legal (20)

administrative, banking, civil, commercial, criminal, digital, family, fiscal, land, notarial, social, competition…

🫂 Moroccan Social (13)

health, education, housing, employment, youth, family_solidarity, disability, migration…

🖊️ Ethos (9)

bahai, buddhism, christianity, hinduism, islam, jainism, judaism, secular_ethics, sikhism

🌍 Regions (7)

africa, americas, asia, eu, gcc, luxembourg, mena

OLM Agent — A Sovereign Ontology Operator

The ArcaQ OLM Agent governs all 82 ontologies as products, publishes lifecycle events to the agent bus, and feeds the correlation pipeline with HGT, GNN, causal and SCAG signals — all traced in PROV-O.