RelationBasedGraphProjector

Graph projector that uses predicates from both the DataDictionary schema and Relations to determine relationship types.

Does not use LLM - matches proposition text directly against known predicates.

Matching priority:

1. Schema relationships from DataDictionary.allowedRelationships with explicit predicates defined via @Semantics(With(key = Proposition.PREDICATE, value = "...")). Uses the property name as the relationship type.

2. Schema relationships with derived predicates from the property name. For example, property employer derives predicate "has employer".

3. Fallback to Relations predicates, deriving relationship type from predicate using UPPER_SNAKE_CASE convention.

Example with explicit @Semantics predicate:

// Given: Person.employer property annotated with @Semantics predicate="works at"
val schema = DataDictionary.fromClasses("myschema", Person::class.java, Company::class.java)
val projector = RelationBasedGraphProjector.from(Relations.empty())

// "Bob works at Acme" -> (bob)-[:employer]->(acme)
// Uses property name "employer" as relationship type

Example with derived predicate (no annotation needed):

// Given: Person.employer property with no @Semantics annotation
// Predicate "has employer" is derived automatically

// "Bob has employer Acme" -> (bob)-[:employer]->(acme)

Example with Relations fallback:

val relations = Relations.empty()
    .withProcedural("likes", "expresses preference for")

val projector = RelationBasedGraphProjector.from(relations)

// "Alice likes jazz" -> (alice)-[:LIKES]->(jazz)
// Derives LIKES from predicate

Parameters