Package ai.chatur.cortex

Interface CortexIngestor

All Known Subinterfaces:

Cortex

public interface CortexIngestor

Validates and stages incoming RDF assertions onto a review branch.

Method Summary

Modifier and Type	Method	Description
IngestResult	ingest(String ttl)	Validates the given assertions and stages them on a new branch.

Method Details

ingest

IngestResult ingest(String ttl)

Validates the given assertions and stages them on a new branch.

The input must first pass the lint check against the ontology; assertions failing it are rejected without being staged. Input that lints clean is then validated against the configured SHACL shapes, together with the already approved assertions, so incoming statements may rely on approved ones to conform. If the union conforms, the statements not already approved are stored on a newly created branch awaiting approval; otherwise nothing is stored and the validation errors are reported in the result. Statements that are already approved are never staged again; if nothing novel remains, no branch is created.

Parameters:

ttl - RDF assertions in Turtle syntax, based on the classes and properties of the ontology

Returns:

the outcome, carrying either the name of the created branch — null if every assertion was already approved — or the lint or validation errors