open-multi-agent-kit 0.80.7 → 0.90.0

package/dist/core/context-graph-ontology-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-graph-ontology-registry.d.ts","sourceRoot":"","sources":["../../src/core/context-graph-ontology-registry.ts"],"names":[],"mappings":"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","sourcesContent":["export const ONTOLOGY_SCHEMA_VERSION = \"0.1.0\";\nexport const ONTOLOGY_REGISTRY_VERSION = \"0.1.0\";\n\nexport const UA_NODE_TYPES = [\n\t\"file\",\n\t\"function\",\n\t\"class\",\n\t\"module\",\n\t\"concept\",\n\t\"config\",\n\t\"document\",\n\t\"service\",\n\t\"table\",\n\t\"endpoint\",\n\t\"pipeline\",\n\t\"schema\",\n\t\"resource\",\n\t\"domain\",\n\t\"flow\",\n\t\"step\",\n\t\"article\",\n\t\"entity\",\n\t\"topic\",\n\t\"claim\",\n\t\"source\",\n] as const;\nexport type UaNodeType = (typeof UA_NODE_TYPES)[number];\n\nexport const UA_EDGE_TYPES = [\n\t\"imports\",\n\t\"exports\",\n\t\"contains\",\n\t\"inherits\",\n\t\"implements\",\n\t\"calls\",\n\t\"subscribes\",\n\t\"publishes\",\n\t\"middleware\",\n\t\"reads_from\",\n\t\"writes_to\",\n\t\"transforms\",\n\t\"validates\",\n\t\"depends_on\",\n\t\"dependsOn\",\n\t\"tested_by\",\n\t\"configures\",\n\t\"related\",\n\t\"related_to\",\n\t\"similar_to\",\n\t\"deploys\",\n\t\"serves\",\n\t\"provisions\",\n\t\"triggers\",\n\t\"migrates\",\n\t\"documents\",\n\t\"routes\",\n\t\"defines_schema\",\n\t\"contains_flow\",\n\t\"flow_step\",\n\t\"cross_domain\",\n\t\"cites\",\n] as const;\nexport type UaEdgeType = (typeof UA_EDGE_TYPES)[number];\n\nexport const DIRECT_NON_TRANSITIVE_UA_EDGE_TYPES = [\n\t\"calls\",\n\t\"imports\",\n\t\"depends_on\",\n\t\"dependsOn\",\n] as const satisfies readonly UaEdgeType[];\n\nexport type OntologyClassIri = `omk:${string}`;\nexport type RelationIri = `omk:${string}`;\n\nexport interface OntologyClassDefinition {\n\tiri: OntologyClassIri;\n\tlabel: string;\n\tparentIris: readonly OntologyClassIri[];\n\tabstract: boolean;\n\tuaNodeTypes?: readonly UaNodeType[];\n\tidentityFields: readonly string[];\n}\n\nexport interface RelationDefinition {\n\tiri: RelationIri;\n\tuaEdgeType?: UaEdgeType;\n\tdomain: readonly OntologyClassIri[];\n\trange: readonly OntologyClassIri[];\n\tinverse?: RelationIri;\n\tsymmetric?: boolean;\n\ttransitive?: boolean;\n\tacyclic?: boolean;\n\tfunctional?: boolean;\n\tretrievalWeight: number;\n\timpactWeight: number;\n\tdefaultConfidence: number;\n\tderived?: boolean;\n}\n\nexport interface OntologyRegistryCandidate {\n\tschemaVersion: string;\n\tregistryVersion: string;\n\tclasses: readonly OntologyClassDefinition[];\n\trelations: readonly RelationDefinition[];\n\tuaNodeTypeToClassIri: Readonly<Partial<Record<UaNodeType, OntologyClassIri>>>;\n\tuaEdgeTypeToRelationIri: Readonly<Partial<Record<UaEdgeType, RelationIri>>>;\n}\n\nexport interface OntologyRegistry {\n\tschemaVersion: string;\n\tregistryVersion: string;\n\tclasses: readonly OntologyClassDefinition[];\n\trelations: readonly RelationDefinition[];\n\tuaNodeTypeToClassIri: Readonly<Record<UaNodeType, OntologyClassIri>>;\n\tuaEdgeTypeToRelationIri: Readonly<Record<UaEdgeType, RelationIri>>;\n}\n\nexport type OntologyRegistryDiagnosticCode =\n\t| \"class.duplicate_iri\"\n\t| \"class.parent_missing\"\n\t| \"class.hierarchy_cycle\"\n\t| \"relation.duplicate_iri\"\n\t| \"relation.domain_missing\"\n\t| \"relation.range_missing\"\n\t| \"relation.inverse_missing\"\n\t| \"relation.inverse_not_reciprocal\"\n\t| \"relation.inverse_domain_range_mismatch\"\n\t| \"relation.symmetric_inverse_invalid\"\n\t| \"relation.direct_edge_transitive\"\n\t| \"relation.invalid_weight\"\n\t| \"mapping.ua_node_missing\"\n\t| \"mapping.ua_node_class_missing\"\n\t| \"mapping.ua_edge_missing\"\n\t| \"mapping.ua_edge_relation_missing\";\n\nexport interface OntologyRegistryDiagnostic {\n\tcode: OntologyRegistryDiagnosticCode;\n\tmessage: string;\n\tiri?: OntologyClassIri | RelationIri;\n\tuaNodeType?: UaNodeType;\n\tuaEdgeType?: UaEdgeType;\n\tpath?: readonly OntologyClassIri[];\n}\n\nexport const ONTOLOGY_CLASSES = [\n\t{ iri: \"omk:Thing\", label: \"Thing\", parentIris: [], abstract: true, identityFields: [\"logicalId\"] },\n\t{\n\t\tiri: \"omk:SoftwareEntity\",\n\t\tlabel: \"Software entity\",\n\t\tparentIris: [\"omk:Thing\"],\n\t\tabstract: true,\n\t\tidentityFields: [\"workspaceId\", \"repositoryId\", \"logicalId\"],\n\t},\n\t{\n\t\tiri: \"omk:Repository\",\n\t\tlabel: \"Repository\",\n\t\tparentIris: [\"omk:SoftwareEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"repositoryId\"],\n\t},\n\t{\n\t\tiri: \"omk:Revision\",\n\t\tlabel: \"Revision\",\n\t\tparentIris: [\"omk:SoftwareEntity\"],\n\t\tabstract: true,\n\t\tidentityFields: [\"repositoryId\", \"repoSha\"],\n\t},\n\t{\n\t\tiri: \"omk:Commit\",\n\t\tlabel: \"Commit\",\n\t\tparentIris: [\"omk:Revision\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"repositoryId\", \"repoSha\"],\n\t},\n\t{\n\t\tiri: \"omk:WorkingTreeSnapshot\",\n\t\tlabel: \"Working tree snapshot\",\n\t\tparentIris: [\"omk:Revision\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"repositoryId\", \"branch\", \"contentHash\"],\n\t},\n\t{\n\t\tiri: \"omk:SoftwareArtifact\",\n\t\tlabel: \"Software artifact\",\n\t\tparentIris: [\"omk:SoftwareEntity\"],\n\t\tabstract: true,\n\t\tidentityFields: [\"repositoryId\", \"filePath\"],\n\t},\n\t{\n\t\tiri: \"omk:File\",\n\t\tlabel: \"File\",\n\t\tparentIris: [\"omk:SoftwareArtifact\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"file\"],\n\t\tidentityFields: [\"repositoryId\", \"filePath\"],\n\t},\n\t{\n\t\tiri: \"omk:Module\",\n\t\tlabel: \"Module\",\n\t\tparentIris: [\"omk:SoftwareArtifact\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"module\"],\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\"],\n\t},\n\t{\n\t\tiri: \"omk:Document\",\n\t\tlabel: \"Document\",\n\t\tparentIris: [\"omk:SoftwareArtifact\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"document\"],\n\t\tidentityFields: [\"repositoryId\", \"filePath\"],\n\t},\n\t{\n\t\tiri: \"omk:Configuration\",\n\t\tlabel: \"Configuration\",\n\t\tparentIris: [\"omk:SoftwareArtifact\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"config\"],\n\t\tidentityFields: [\"repositoryId\", \"filePath\"],\n\t},\n\t{\n\t\tiri: \"omk:Pipeline\",\n\t\tlabel: \"Pipeline\",\n\t\tparentIris: [\"omk:SoftwareArtifact\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"pipeline\"],\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\"],\n\t},\n\t{\n\t\tiri: \"omk:InfrastructureResource\",\n\t\tlabel: \"Infrastructure resource\",\n\t\tparentIris: [\"omk:SoftwareArtifact\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"resource\"],\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\"],\n\t},\n\t{\n\t\tiri: \"omk:Symbol\",\n\t\tlabel: \"Symbol\",\n\t\tparentIris: [\"omk:SoftwareEntity\"],\n\t\tabstract: true,\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\", \"normalizedSignature\"],\n\t},\n\t{\n\t\tiri: \"omk:Callable\",\n\t\tlabel: \"Callable\",\n\t\tparentIris: [\"omk:Symbol\"],\n\t\tabstract: true,\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\", \"normalizedSignature\"],\n\t},\n\t{\n\t\tiri: \"omk:Function\",\n\t\tlabel: \"Function\",\n\t\tparentIris: [\"omk:Callable\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"function\"],\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\", \"normalizedSignature\"],\n\t},\n\t{\n\t\tiri: \"omk:Method\",\n\t\tlabel: \"Method\",\n\t\tparentIris: [\"omk:Callable\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\", \"normalizedSignature\"],\n\t},\n\t{\n\t\tiri: \"omk:TypeSymbol\",\n\t\tlabel: \"Type symbol\",\n\t\tparentIris: [\"omk:Symbol\"],\n\t\tabstract: true,\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\", \"normalizedSignature\"],\n\t},\n\t{\n\t\tiri: \"omk:Class\",\n\t\tlabel: \"Class\",\n\t\tparentIris: [\"omk:TypeSymbol\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"class\"],\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\", \"normalizedSignature\"],\n\t},\n\t{\n\t\tiri: \"omk:Interface\",\n\t\tlabel: \"Interface\",\n\t\tparentIris: [\"omk:TypeSymbol\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\", \"normalizedSignature\"],\n\t},\n\t{\n\t\tiri: \"omk:Schema\",\n\t\tlabel: \"Schema\",\n\t\tparentIris: [\"omk:TypeSymbol\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"schema\"],\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\", \"normalizedSignature\"],\n\t},\n\t{\n\t\tiri: \"omk:Endpoint\",\n\t\tlabel: \"Endpoint\",\n\t\tparentIris: [\"omk:Symbol\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"endpoint\"],\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\", \"routePattern\"],\n\t},\n\t{\n\t\tiri: \"omk:DataEntity\",\n\t\tlabel: \"Data entity\",\n\t\tparentIris: [\"omk:Symbol\"],\n\t\tabstract: true,\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\"],\n\t},\n\t{\n\t\tiri: \"omk:Table\",\n\t\tlabel: \"Table\",\n\t\tparentIris: [\"omk:DataEntity\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"table\"],\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\"],\n\t},\n\t{\n\t\tiri: \"omk:MessageSchema\",\n\t\tlabel: \"Message schema\",\n\t\tparentIris: [\"omk:DataEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\"],\n\t},\n\t{\n\t\tiri: \"omk:Service\",\n\t\tlabel: \"Service\",\n\t\tparentIris: [\"omk:SoftwareEntity\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"service\"],\n\t\tidentityFields: [\"repositoryId\", \"qualifiedName\"],\n\t},\n\t{\n\t\tiri: \"omk:SemanticEntity\",\n\t\tlabel: \"Semantic entity\",\n\t\tparentIris: [\"omk:Thing\"],\n\t\tabstract: true,\n\t\tidentityFields: [\"workspaceId\", \"name\"],\n\t},\n\t{\n\t\tiri: \"omk:Concept\",\n\t\tlabel: \"Concept\",\n\t\tparentIris: [\"omk:SemanticEntity\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"concept\"],\n\t\tidentityFields: [\"workspaceId\", \"name\"],\n\t},\n\t{\n\t\tiri: \"omk:Domain\",\n\t\tlabel: \"Domain\",\n\t\tparentIris: [\"omk:SemanticEntity\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"domain\"],\n\t\tidentityFields: [\"workspaceId\", \"name\"],\n\t},\n\t{\n\t\tiri: \"omk:Flow\",\n\t\tlabel: \"Flow\",\n\t\tparentIris: [\"omk:SemanticEntity\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"flow\"],\n\t\tidentityFields: [\"workspaceId\", \"qualifiedName\"],\n\t},\n\t{\n\t\tiri: \"omk:Step\",\n\t\tlabel: \"Step\",\n\t\tparentIris: [\"omk:SemanticEntity\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"step\"],\n\t\tidentityFields: [\"workspaceId\", \"qualifiedName\", \"order\"],\n\t},\n\t{\n\t\tiri: \"omk:Topic\",\n\t\tlabel: \"Topic\",\n\t\tparentIris: [\"omk:SemanticEntity\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"topic\"],\n\t\tidentityFields: [\"workspaceId\", \"name\"],\n\t},\n\t{\n\t\tiri: \"omk:Claim\",\n\t\tlabel: \"Claim\",\n\t\tparentIris: [\"omk:SemanticEntity\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"claim\"],\n\t\tidentityFields: [\"workspaceId\", \"contentHash\"],\n\t},\n\t{\n\t\tiri: \"omk:ExternalEntity\",\n\t\tlabel: \"External entity\",\n\t\tparentIris: [\"omk:SemanticEntity\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"entity\"],\n\t\tidentityFields: [\"workspaceId\", \"name\", \"source\"],\n\t},\n\t{\n\t\tiri: \"omk:Article\",\n\t\tlabel: \"Article\",\n\t\tparentIris: [\"omk:Document\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"article\"],\n\t\tidentityFields: [\"workspaceId\", \"source\", \"title\"],\n\t},\n\t{\n\t\tiri: \"omk:OperationalEntity\",\n\t\tlabel: \"Operational entity\",\n\t\tparentIris: [\"omk:Thing\"],\n\t\tabstract: true,\n\t\tidentityFields: [\"workspaceId\", \"episodeId\"],\n\t},\n\t{\n\t\tiri: \"omk:Episode\",\n\t\tlabel: \"Episode\",\n\t\tparentIris: [\"omk:OperationalEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"episodeId\"],\n\t},\n\t{\n\t\tiri: \"omk:Session\",\n\t\tlabel: \"Session\",\n\t\tparentIris: [\"omk:OperationalEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"sessionId\"],\n\t},\n\t{\n\t\tiri: \"omk:Turn\",\n\t\tlabel: \"Turn\",\n\t\tparentIris: [\"omk:OperationalEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"sessionId\", \"turnId\"],\n\t},\n\t{\n\t\tiri: \"omk:ToolCall\",\n\t\tlabel: \"Tool call\",\n\t\tparentIris: [\"omk:OperationalEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"sessionId\", \"toolCallId\"],\n\t},\n\t{\n\t\tiri: \"omk:CommandRun\",\n\t\tlabel: \"Command run\",\n\t\tparentIris: [\"omk:OperationalEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"commandHash\", \"startedAt\"],\n\t},\n\t{\n\t\tiri: \"omk:TestRun\",\n\t\tlabel: \"Test run\",\n\t\tparentIris: [\"omk:OperationalEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"commandHash\", \"startedAt\"],\n\t},\n\t{\n\t\tiri: \"omk:BuildRun\",\n\t\tlabel: \"Build run\",\n\t\tparentIris: [\"omk:OperationalEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"commandHash\", \"startedAt\"],\n\t},\n\t{\n\t\tiri: \"omk:Error\",\n\t\tlabel: \"Error\",\n\t\tparentIris: [\"omk:OperationalEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"errorHash\"],\n\t},\n\t{\n\t\tiri: \"omk:GeneratedArtifact\",\n\t\tlabel: \"Generated artifact\",\n\t\tparentIris: [\"omk:OperationalEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"filePath\", \"contentHash\"],\n\t},\n\t{\n\t\tiri: \"omk:GovernanceEntity\",\n\t\tlabel: \"Governance entity\",\n\t\tparentIris: [\"omk:Thing\"],\n\t\tabstract: true,\n\t\tidentityFields: [\"workspaceId\", \"logicalId\"],\n\t},\n\t{\n\t\tiri: \"omk:Requirement\",\n\t\tlabel: \"Requirement\",\n\t\tparentIris: [\"omk:GovernanceEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"requirementId\"],\n\t},\n\t{\n\t\tiri: \"omk:Constraint\",\n\t\tlabel: \"Constraint\",\n\t\tparentIris: [\"omk:GovernanceEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"constraintHash\"],\n\t},\n\t{\n\t\tiri: \"omk:Decision\",\n\t\tlabel: \"Decision\",\n\t\tparentIris: [\"omk:GovernanceEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"decisionHash\"],\n\t},\n\t{\n\t\tiri: \"omk:Evidence\",\n\t\tlabel: \"Evidence\",\n\t\tparentIris: [\"omk:GovernanceEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"evidenceHash\"],\n\t},\n\t{\n\t\tiri: \"omk:Source\",\n\t\tlabel: \"Source\",\n\t\tparentIris: [\"omk:GovernanceEntity\"],\n\t\tabstract: false,\n\t\tuaNodeTypes: [\"source\"],\n\t\tidentityFields: [\"workspaceId\", \"sourceUri\", \"contentHash\"],\n\t},\n\t{\n\t\tiri: \"omk:Assumption\",\n\t\tlabel: \"Assumption\",\n\t\tparentIris: [\"omk:GovernanceEntity\"],\n\t\tabstract: false,\n\t\tidentityFields: [\"workspaceId\", \"assumptionHash\"],\n\t},\n] as const satisfies readonly OntologyClassDefinition[];\n\nconst THING_DOMAIN = [\"omk:Thing\"] as const satisfies readonly OntologyClassIri[];\nconst THING_RANGE = [\"omk:Thing\"] as const satisfies readonly OntologyClassIri[];\n\nexport const ONTOLOGY_RELATIONS = [\n\t{\n\t\tiri: \"omk:contains\",\n\t\tuaEdgeType: \"contains\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: THING_RANGE,\n\t\tacyclic: true,\n\t\tretrievalWeight: 1,\n\t\timpactWeight: 0.75,\n\t\tdefaultConfidence: 0.95,\n\t},\n\t{\n\t\tiri: \"omk:imports\",\n\t\tuaEdgeType: \"imports\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: THING_RANGE,\n\t\ttransitive: false,\n\t\tretrievalWeight: 0.7,\n\t\timpactWeight: 0.8,\n\t\tdefaultConfidence: 0.9,\n\t},\n\t{\n\t\tiri: \"omk:exports\",\n\t\tuaEdgeType: \"exports\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: THING_RANGE,\n\t\tretrievalWeight: 0.8,\n\t\timpactWeight: 0.75,\n\t\tdefaultConfidence: 0.88,\n\t},\n\t{\n\t\tiri: \"omk:inherits\",\n\t\tuaEdgeType: \"inherits\",\n\t\tdomain: [\"omk:Class\"],\n\t\trange: [\"omk:Class\"],\n\t\tacyclic: true,\n\t\tretrievalWeight: 0.9,\n\t\timpactWeight: 0.9,\n\t\tdefaultConfidence: 0.9,\n\t},\n\t{\n\t\tiri: \"omk:implements\",\n\t\tuaEdgeType: \"implements\",\n\t\tdomain: [\"omk:Class\"],\n\t\trange: [\"omk:Class\", \"omk:Interface\", \"omk:Concept\"],\n\t\tacyclic: true,\n\t\tretrievalWeight: 0.9,\n\t\timpactWeight: 0.85,\n\t\tdefaultConfidence: 0.9,\n\t},\n\t{\n\t\tiri: \"omk:calls\",\n\t\tuaEdgeType: \"calls\",\n\t\tdomain: [\"omk:Callable\", \"omk:Endpoint\"],\n\t\trange: [\"omk:Callable\", \"omk:Endpoint\"],\n\t\ttransitive: false,\n\t\tretrievalWeight: 0.8,\n\t\timpactWeight: 0.9,\n\t\tdefaultConfidence: 0.88,\n\t},\n\t{\n\t\tiri: \"omk:subscribes\",\n\t\tuaEdgeType: \"subscribes\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: [\"omk:Topic\", \"omk:Endpoint\"],\n\t\tretrievalWeight: 0.6,\n\t\timpactWeight: 0.55,\n\t\tdefaultConfidence: 0.78,\n\t},\n\t{\n\t\tiri: \"omk:publishes\",\n\t\tuaEdgeType: \"publishes\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: [\"omk:Topic\", \"omk:Endpoint\"],\n\t\tretrievalWeight: 0.6,\n\t\timpactWeight: 0.55,\n\t\tdefaultConfidence: 0.78,\n\t},\n\t{\n\t\tiri: \"omk:middleware\",\n\t\tuaEdgeType: \"middleware\",\n\t\tdomain: [\"omk:Endpoint\", \"omk:Service\", \"omk:File\"],\n\t\trange: THING_RANGE,\n\t\tretrievalWeight: 0.55,\n\t\timpactWeight: 0.6,\n\t\tdefaultConfidence: 0.78,\n\t},\n\t{\n\t\tiri: \"omk:readsFrom\",\n\t\tuaEdgeType: \"reads_from\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: [\"omk:DataEntity\", \"omk:Schema\", \"omk:File\", \"omk:ExternalEntity\"],\n\t\tretrievalWeight: 0.65,\n\t\timpactWeight: 0.65,\n\t\tdefaultConfidence: 0.82,\n\t},\n\t{\n\t\tiri: \"omk:writesTo\",\n\t\tuaEdgeType: \"writes_to\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: [\"omk:DataEntity\", \"omk:Schema\", \"omk:File\", \"omk:ExternalEntity\"],\n\t\tretrievalWeight: 0.65,\n\t\timpactWeight: 0.8,\n\t\tdefaultConfidence: 0.82,\n\t},\n\t{\n\t\tiri: \"omk:transforms\",\n\t\tuaEdgeType: \"transforms\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: THING_RANGE,\n\t\tretrievalWeight: 0.55,\n\t\timpactWeight: 0.65,\n\t\tdefaultConfidence: 0.76,\n\t},\n\t{\n\t\tiri: \"omk:validates\",\n\t\tuaEdgeType: \"validates\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: THING_RANGE,\n\t\tretrievalWeight: 0.55,\n\t\timpactWeight: 0.55,\n\t\tdefaultConfidence: 0.8,\n\t},\n\t{\n\t\tiri: \"omk:dependsOn\",\n\t\tuaEdgeType: \"depends_on\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: THING_RANGE,\n\t\ttransitive: false,\n\t\tretrievalWeight: 0.6,\n\t\timpactWeight: 0.85,\n\t\tdefaultConfidence: 0.86,\n\t},\n\t{\n\t\tiri: \"omk:testedBy\",\n\t\tuaEdgeType: \"tested_by\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: [\"omk:File\", \"omk:TestRun\", \"omk:GeneratedArtifact\"],\n\t\tretrievalWeight: 0.5,\n\t\timpactWeight: 0.95,\n\t\tdefaultConfidence: 0.9,\n\t},\n\t{\n\t\tiri: \"omk:configures\",\n\t\tuaEdgeType: \"configures\",\n\t\tdomain: [\"omk:Configuration\", \"omk:Decision\", \"omk:File\"],\n\t\trange: THING_RANGE,\n\t\tretrievalWeight: 0.6,\n\t\timpactWeight: 0.6,\n\t\tdefaultConfidence: 0.82,\n\t},\n\t{\n\t\tiri: \"omk:related\",\n\t\tuaEdgeType: \"related\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: THING_RANGE,\n\t\tsymmetric: true,\n\t\tretrievalWeight: 0.5,\n\t\timpactWeight: 0.2,\n\t\tdefaultConfidence: 0.6,\n\t},\n\t{\n\t\tiri: \"omk:similarTo\",\n\t\tuaEdgeType: \"similar_to\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: THING_RANGE,\n\t\tsymmetric: true,\n\t\tretrievalWeight: 0.45,\n\t\timpactWeight: 0.1,\n\t\tdefaultConfidence: 0.58,\n\t},\n\t{\n\t\tiri: \"omk:deploys\",\n\t\tuaEdgeType: \"deploys\",\n\t\tdomain: [\"omk:Pipeline\", \"omk:Service\"],\n\t\trange: [\"omk:Service\", \"omk:InfrastructureResource\"],\n\t\tretrievalWeight: 0.7,\n\t\timpactWeight: 0.7,\n\t\tdefaultConfidence: 0.82,\n\t},\n\t{\n\t\tiri: \"omk:serves\",\n\t\tuaEdgeType: \"serves\",\n\t\tdomain: [\"omk:Service\", \"omk:Endpoint\"],\n\t\trange: [\"omk:Endpoint\", \"omk:Service\"],\n\t\tretrievalWeight: 0.6,\n\t\timpactWeight: 0.6,\n\t\tdefaultConfidence: 0.82,\n\t},\n\t{\n\t\tiri: \"omk:provisions\",\n\t\tuaEdgeType: \"provisions\",\n\t\tdomain: [\"omk:Pipeline\", \"omk:InfrastructureResource\"],\n\t\trange: [\"omk:InfrastructureResource\", \"omk:Service\"],\n\t\tretrievalWeight: 0.6,\n\t\timpactWeight: 0.6,\n\t\tdefaultConfidence: 0.8,\n\t},\n\t{\n\t\tiri: \"omk:triggers\",\n\t\tuaEdgeType: \"triggers\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: [\"omk:Pipeline\", \"omk:CommandRun\", \"omk:BuildRun\", \"omk:TestRun\", \"omk:ToolCall\"],\n\t\tretrievalWeight: 0.6,\n\t\timpactWeight: 0.6,\n\t\tdefaultConfidence: 0.8,\n\t},\n\t{\n\t\tiri: \"omk:migrates\",\n\t\tuaEdgeType: \"migrates\",\n\t\tdomain: [\"omk:Pipeline\", \"omk:File\", \"omk:Schema\"],\n\t\trange: [\"omk:Table\", \"omk:Schema\", \"omk:DataEntity\"],\n\t\tretrievalWeight: 0.7,\n\t\timpactWeight: 0.7,\n\t\tdefaultConfidence: 0.82,\n\t},\n\t{\n\t\tiri: \"omk:documents\",\n\t\tuaEdgeType: \"documents\",\n\t\tdomain: [\"omk:Document\", \"omk:Source\", \"omk:Article\"],\n\t\trange: THING_RANGE,\n\t\tretrievalWeight: 0.5,\n\t\timpactWeight: 0.2,\n\t\tdefaultConfidence: 0.78,\n\t},\n\t{\n\t\tiri: \"omk:routes\",\n\t\tuaEdgeType: \"routes\",\n\t\tdomain: [\"omk:Endpoint\", \"omk:Service\", \"omk:File\"],\n\t\trange: [\"omk:Callable\", \"omk:Endpoint\", \"omk:Service\"],\n\t\tretrievalWeight: 0.7,\n\t\timpactWeight: 0.75,\n\t\tdefaultConfidence: 0.84,\n\t},\n\t{\n\t\tiri: \"omk:definesSchema\",\n\t\tuaEdgeType: \"defines_schema\",\n\t\tdomain: [\"omk:Schema\", \"omk:File\"],\n\t\trange: [\"omk:Schema\", \"omk:Table\", \"omk:Endpoint\", \"omk:DataEntity\"],\n\t\tretrievalWeight: 0.8,\n\t\timpactWeight: 0.7,\n\t\tdefaultConfidence: 0.84,\n\t},\n\t{\n\t\tiri: \"omk:containsFlow\",\n\t\tuaEdgeType: \"contains_flow\",\n\t\tdomain: [\"omk:Domain\"],\n\t\trange: [\"omk:Flow\"],\n\t\tacyclic: true,\n\t\tretrievalWeight: 0.55,\n\t\timpactWeight: 0.3,\n\t\tdefaultConfidence: 0.76,\n\t},\n\t{\n\t\tiri: \"omk:flowStep\",\n\t\tuaEdgeType: \"flow_step\",\n\t\tdomain: [\"omk:Flow\"],\n\t\trange: [\"omk:Step\"],\n\t\tacyclic: true,\n\t\tretrievalWeight: 0.55,\n\t\timpactWeight: 0.3,\n\t\tdefaultConfidence: 0.76,\n\t},\n\t{\n\t\tiri: \"omk:crossDomain\",\n\t\tuaEdgeType: \"cross_domain\",\n\t\tdomain: [\"omk:Domain\"],\n\t\trange: [\"omk:Domain\"],\n\t\tsymmetric: true,\n\t\tretrievalWeight: 0.45,\n\t\timpactWeight: 0.25,\n\t\tdefaultConfidence: 0.7,\n\t},\n\t{\n\t\tiri: \"omk:cites\",\n\t\tuaEdgeType: \"cites\",\n\t\tdomain: [\"omk:Article\", \"omk:Claim\", \"omk:Document\"],\n\t\trange: [\"omk:Source\", \"omk:Article\", \"omk:Document\"],\n\t\tretrievalWeight: 0.5,\n\t\timpactWeight: 0.2,\n\t\tdefaultConfidence: 0.76,\n\t},\n\t{\n\t\tiri: \"omk:sameAs\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: THING_RANGE,\n\t\tsymmetric: true,\n\t\ttransitive: true,\n\t\tretrievalWeight: 0.8,\n\t\timpactWeight: 0.45,\n\t\tdefaultConfidence: 0.95,\n\t\tderived: true,\n\t},\n\t{\n\t\tiri: \"omk:possibleSameAs\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: THING_RANGE,\n\t\tsymmetric: true,\n\t\tretrievalWeight: 0.35,\n\t\timpactWeight: 0.1,\n\t\tdefaultConfidence: 0.6,\n\t\tderived: true,\n\t},\n\t{\n\t\tiri: \"omk:renamedTo\",\n\t\tdomain: [\"omk:SoftwareEntity\"],\n\t\trange: [\"omk:SoftwareEntity\"],\n\t\tacyclic: true,\n\t\tretrievalWeight: 0.65,\n\t\timpactWeight: 0.4,\n\t\tdefaultConfidence: 0.9,\n\t\tderived: true,\n\t},\n\t{\n\t\tiri: \"omk:supersededBy\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: THING_RANGE,\n\t\tfunctional: true,\n\t\tacyclic: true,\n\t\tretrievalWeight: 0.4,\n\t\timpactWeight: 0.2,\n\t\tdefaultConfidence: 0.9,\n\t\tderived: true,\n\t},\n\t{\n\t\tiri: \"omk:hasEvidence\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: [\"omk:Evidence\", \"omk:Source\", \"omk:Episode\"],\n\t\tretrievalWeight: 0.65,\n\t\timpactWeight: 0.2,\n\t\tdefaultConfidence: 0.85,\n\t\tderived: true,\n\t},\n\t{\n\t\tiri: \"omk:inferredFrom\",\n\t\tdomain: THING_DOMAIN,\n\t\trange: THING_RANGE,\n\t\tacyclic: true,\n\t\tretrievalWeight: 0.55,\n\t\timpactWeight: 0.2,\n\t\tdefaultConfidence: 0.8,\n\t\tderived: true,\n\t},\n] as const satisfies readonly RelationDefinition[];\n\nexport const DEFAULT_UA_NODE_TYPE_TO_CLASS_IRI = {\n\tarticle: \"omk:Article\",\n\tclass: \"omk:Class\",\n\tconcept: \"omk:Concept\",\n\tconfig: \"omk:Configuration\",\n\tdocument: \"omk:Document\",\n\tendpoint: \"omk:Endpoint\",\n\tentity: \"omk:ExternalEntity\",\n\tfile: \"omk:File\",\n\tflow: \"omk:Flow\",\n\tfunction: \"omk:Function\",\n\tdomain: \"omk:Domain\",\n\tmodule: \"omk:Module\",\n\tpipeline: \"omk:Pipeline\",\n\tresource: \"omk:InfrastructureResource\",\n\tschema: \"omk:Schema\",\n\tservice: \"omk:Service\",\n\tsource: \"omk:Source\",\n\tstep: \"omk:Step\",\n\ttable: \"omk:Table\",\n\ttopic: \"omk:Topic\",\n\tclaim: \"omk:Claim\",\n} as const satisfies Readonly<Record<UaNodeType, OntologyClassIri>>;\n\nexport const DEFAULT_UA_EDGE_TYPE_TO_RELATION_IRI = {\n\tcalls: \"omk:calls\",\n\tcites: \"omk:cites\",\n\tconfigures: \"omk:configures\",\n\tcontains: \"omk:contains\",\n\tcontains_flow: \"omk:containsFlow\",\n\tcross_domain: \"omk:crossDomain\",\n\tdefines_schema: \"omk:definesSchema\",\n\tdepends_on: \"omk:dependsOn\",\n\tdependsOn: \"omk:dependsOn\",\n\tdeploys: \"omk:deploys\",\n\tdocuments: \"omk:documents\",\n\texports: \"omk:exports\",\n\tflow_step: \"omk:flowStep\",\n\timplements: \"omk:implements\",\n\timports: \"omk:imports\",\n\tinherits: \"omk:inherits\",\n\tmiddleware: \"omk:middleware\",\n\tmigrates: \"omk:migrates\",\n\tprovisions: \"omk:provisions\",\n\tpublishes: \"omk:publishes\",\n\treads_from: \"omk:readsFrom\",\n\trelated: \"omk:related\",\n\trelated_to: \"omk:related\",\n\troutes: \"omk:routes\",\n\tserves: \"omk:serves\",\n\tsimilar_to: \"omk:similarTo\",\n\tsubscribes: \"omk:subscribes\",\n\ttested_by: \"omk:testedBy\",\n\ttransforms: \"omk:transforms\",\n\ttriggers: \"omk:triggers\",\n\tvalidates: \"omk:validates\",\n\twrites_to: \"omk:writesTo\",\n} as const satisfies Readonly<Record<UaEdgeType, RelationIri>>;\n\nexport const ONTOLOGY_REGISTRY: OntologyRegistry = {\n\tschemaVersion: ONTOLOGY_SCHEMA_VERSION,\n\tregistryVersion: ONTOLOGY_REGISTRY_VERSION,\n\tclasses: ONTOLOGY_CLASSES,\n\trelations: ONTOLOGY_RELATIONS,\n\tuaNodeTypeToClassIri: DEFAULT_UA_NODE_TYPE_TO_CLASS_IRI,\n\tuaEdgeTypeToRelationIri: DEFAULT_UA_EDGE_TYPE_TO_RELATION_IRI,\n};\n\nexport function validateOntologyRegistry(\n\tregistry: OntologyRegistryCandidate = ONTOLOGY_REGISTRY,\n): OntologyRegistryDiagnostic[] {\n\tconst diagnostics: OntologyRegistryDiagnostic[] = [];\n\tconst classMap = createOntologyClassMap(registry.classes);\n\tconst relationMap = createRelationMap(registry.relations);\n\n\tpushDuplicateClassDiagnostics(registry.classes, diagnostics);\n\tpushDuplicateRelationDiagnostics(registry.relations, diagnostics);\n\tpushParentDiagnostics(registry.classes, classMap, diagnostics);\n\tpushClassHierarchyCycleDiagnostics(registry.classes, classMap, diagnostics);\n\tpushRelationDiagnostics(registry.relations, classMap, relationMap, diagnostics);\n\tpushMappingDiagnostics(registry, classMap, relationMap, diagnostics);\n\n\treturn diagnostics;\n}\n\nexport function createOntologyClassMap(\n\tclasses: readonly OntologyClassDefinition[] = ONTOLOGY_CLASSES,\n): ReadonlyMap<OntologyClassIri, OntologyClassDefinition> {\n\treturn new Map(classes.map((definition) => [definition.iri, definition]));\n}\n\nexport function createRelationMap(\n\trelations: readonly RelationDefinition[] = ONTOLOGY_RELATIONS,\n): ReadonlyMap<RelationIri, RelationDefinition> {\n\treturn new Map(relations.map((definition) => [definition.iri, definition]));\n}\n\nexport function mapUaNodeTypeToClassIri(\n\tnodeType: UaNodeType,\n\tregistry: OntologyRegistryCandidate = ONTOLOGY_REGISTRY,\n): OntologyClassIri {\n\tconst classIri = registry.uaNodeTypeToClassIri[nodeType];\n\tif (classIri === undefined) {\n\t\tthrow new Error(`No ontology class mapping exists for UA node type '${nodeType}'`);\n\t}\n\treturn classIri;\n}\n\nexport function mapUaEdgeTypeToRelationIri(\n\tedgeType: UaEdgeType,\n\tregistry: OntologyRegistryCandidate = ONTOLOGY_REGISTRY,\n): RelationIri {\n\tconst relationIri = registry.uaEdgeTypeToRelationIri[edgeType];\n\tif (relationIri === undefined) {\n\t\tthrow new Error(`No ontology relation mapping exists for UA edge type '${edgeType}'`);\n\t}\n\treturn relationIri;\n}\n\nexport function getOntologyClassDefinition(\n\tclassIri: OntologyClassIri,\n\tregistry: OntologyRegistryCandidate = ONTOLOGY_REGISTRY,\n): OntologyClassDefinition | undefined {\n\treturn createOntologyClassMap(registry.classes).get(classIri);\n}\n\nexport function getRelationDefinition(\n\trelationIri: RelationIri,\n\tregistry: OntologyRegistryCandidate = ONTOLOGY_REGISTRY,\n): RelationDefinition | undefined {\n\treturn createRelationMap(registry.relations).get(relationIri);\n}\n\nexport function getOntologyClassForUaNodeType(\n\tnodeType: UaNodeType,\n\tregistry: OntologyRegistryCandidate = ONTOLOGY_REGISTRY,\n): OntologyClassDefinition {\n\tconst classIri = mapUaNodeTypeToClassIri(nodeType, registry);\n\tconst definition = getOntologyClassDefinition(classIri, registry);\n\tif (definition === undefined) {\n\t\tthrow new Error(`Ontology class '${classIri}' mapped from UA node type '${nodeType}' is not defined`);\n\t}\n\treturn definition;\n}\n\nexport function getRelationForUaEdgeType(\n\tedgeType: UaEdgeType,\n\tregistry: OntologyRegistryCandidate = ONTOLOGY_REGISTRY,\n): RelationDefinition {\n\tconst relationIri = mapUaEdgeTypeToRelationIri(edgeType, registry);\n\tconst definition = getRelationDefinition(relationIri, registry);\n\tif (definition === undefined) {\n\t\tthrow new Error(`Ontology relation '${relationIri}' mapped from UA edge type '${edgeType}' is not defined`);\n\t}\n\treturn definition;\n}\n\nfunction pushDuplicateClassDiagnostics(\n\tclasses: readonly OntologyClassDefinition[],\n\tdiagnostics: OntologyRegistryDiagnostic[],\n): void {\n\tconst seen = new Set<OntologyClassIri>();\n\tfor (const definition of classes) {\n\t\tif (seen.has(definition.iri)) {\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"class.duplicate_iri\",\n\t\t\t\tmessage: `Duplicate ontology class '${definition.iri}'`,\n\t\t\t\tiri: definition.iri,\n\t\t\t});\n\t\t}\n\t\tseen.add(definition.iri);\n\t}\n}\n\nfunction pushDuplicateRelationDiagnostics(\n\trelations: readonly RelationDefinition[],\n\tdiagnostics: OntologyRegistryDiagnostic[],\n): void {\n\tconst seen = new Set<RelationIri>();\n\tfor (const definition of relations) {\n\t\tif (seen.has(definition.iri)) {\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"relation.duplicate_iri\",\n\t\t\t\tmessage: `Duplicate ontology relation '${definition.iri}'`,\n\t\t\t\tiri: definition.iri,\n\t\t\t});\n\t\t}\n\t\tseen.add(definition.iri);\n\t}\n}\n\nfunction pushParentDiagnostics(\n\tclasses: readonly OntologyClassDefinition[],\n\tclassMap: ReadonlyMap<OntologyClassIri, OntologyClassDefinition>,\n\tdiagnostics: OntologyRegistryDiagnostic[],\n): void {\n\tfor (const definition of classes) {\n\t\tfor (const parentIri of definition.parentIris) {\n\t\t\tif (!classMap.has(parentIri)) {\n\t\t\t\tdiagnostics.push({\n\t\t\t\t\tcode: \"class.parent_missing\",\n\t\t\t\t\tmessage: `Ontology class '${definition.iri}' references missing parent '${parentIri}'`,\n\t\t\t\t\tiri: definition.iri,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n}\n\nfunction pushClassHierarchyCycleDiagnostics(\n\tclasses: readonly OntologyClassDefinition[],\n\tclassMap: ReadonlyMap<OntologyClassIri, OntologyClassDefinition>,\n\tdiagnostics: OntologyRegistryDiagnostic[],\n): void {\n\tconst visited = new Set<OntologyClassIri>();\n\tconst visiting = new Set<OntologyClassIri>();\n\tconst reported = new Set<string>();\n\n\tfor (const definition of classes) {\n\t\tvisitClassHierarchy(definition.iri, [], classMap, visited, visiting, reported, diagnostics);\n\t}\n}\n\nfunction visitClassHierarchy(\n\tclassIri: OntologyClassIri,\n\tpath: readonly OntologyClassIri[],\n\tclassMap: ReadonlyMap<OntologyClassIri, OntologyClassDefinition>,\n\tvisited: Set<OntologyClassIri>,\n\tvisiting: Set<OntologyClassIri>,\n\treported: Set<string>,\n\tdiagnostics: OntologyRegistryDiagnostic[],\n): void {\n\tif (visited.has(classIri)) return;\n\tconst existingPathIndex = path.indexOf(classIri);\n\tif (visiting.has(classIri) || existingPathIndex >= 0) {\n\t\tconst cyclePath = [...path.slice(Math.max(existingPathIndex, 0)), classIri];\n\t\tconst key = [...cyclePath].sort().join(\"|\");\n\t\tif (!reported.has(key)) {\n\t\t\treported.add(key);\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"class.hierarchy_cycle\",\n\t\t\t\tmessage: `Ontology class hierarchy contains a cycle: ${cyclePath.join(\" -> \")}`,\n\t\t\t\tiri: classIri,\n\t\t\t\tpath: cyclePath,\n\t\t\t});\n\t\t}\n\t\treturn;\n\t}\n\n\tconst definition = classMap.get(classIri);\n\tif (definition === undefined) return;\n\n\tvisiting.add(classIri);\n\tfor (const parentIri of definition.parentIris) {\n\t\tif (classMap.has(parentIri)) {\n\t\t\tvisitClassHierarchy(parentIri, [...path, classIri], classMap, visited, visiting, reported, diagnostics);\n\t\t}\n\t}\n\tvisiting.delete(classIri);\n\tvisited.add(classIri);\n}\n\nfunction pushRelationDiagnostics(\n\trelations: readonly RelationDefinition[],\n\tclassMap: ReadonlyMap<OntologyClassIri, OntologyClassDefinition>,\n\trelationMap: ReadonlyMap<RelationIri, RelationDefinition>,\n\tdiagnostics: OntologyRegistryDiagnostic[],\n): void {\n\tfor (const relation of relations) {\n\t\tpushRelationClassExistenceDiagnostics(relation, classMap, diagnostics);\n\t\tpushRelationInverseDiagnostics(relation, relationMap, diagnostics);\n\t\tpushDirectRelationDiagnostics(relation, diagnostics);\n\t\tpushRelationWeightDiagnostics(relation, diagnostics);\n\t}\n}\n\nfunction pushRelationClassExistenceDiagnostics(\n\trelation: RelationDefinition,\n\tclassMap: ReadonlyMap<OntologyClassIri, OntologyClassDefinition>,\n\tdiagnostics: OntologyRegistryDiagnostic[],\n): void {\n\tfor (const classIri of relation.domain) {\n\t\tif (!classMap.has(classIri)) {\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"relation.domain_missing\",\n\t\t\t\tmessage: `Relation '${relation.iri}' references missing domain class '${classIri}'`,\n\t\t\t\tiri: relation.iri,\n\t\t\t});\n\t\t}\n\t}\n\tfor (const classIri of relation.range) {\n\t\tif (!classMap.has(classIri)) {\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"relation.range_missing\",\n\t\t\t\tmessage: `Relation '${relation.iri}' references missing range class '${classIri}'`,\n\t\t\t\tiri: relation.iri,\n\t\t\t});\n\t\t}\n\t}\n}\n\nfunction pushRelationInverseDiagnostics(\n\trelation: RelationDefinition,\n\trelationMap: ReadonlyMap<RelationIri, RelationDefinition>,\n\tdiagnostics: OntologyRegistryDiagnostic[],\n): void {\n\tif (relation.symmetric === true && relation.inverse !== undefined && relation.inverse !== relation.iri) {\n\t\tdiagnostics.push({\n\t\t\tcode: \"relation.symmetric_inverse_invalid\",\n\t\t\tmessage: `Symmetric relation '${relation.iri}' must omit inverse or point to itself`,\n\t\t\tiri: relation.iri,\n\t\t});\n\t}\n\n\tif (relation.inverse === undefined) return;\n\n\tconst inverse = relationMap.get(relation.inverse);\n\tif (inverse === undefined) {\n\t\tdiagnostics.push({\n\t\t\tcode: \"relation.inverse_missing\",\n\t\t\tmessage: `Relation '${relation.iri}' references missing inverse '${relation.inverse}'`,\n\t\t\tiri: relation.iri,\n\t\t});\n\t\treturn;\n\t}\n\n\tif (inverse.inverse !== relation.iri) {\n\t\tdiagnostics.push({\n\t\t\tcode: \"relation.inverse_not_reciprocal\",\n\t\t\tmessage: `Relation '${relation.iri}' inverse '${inverse.iri}' does not point back to '${relation.iri}'`,\n\t\t\tiri: relation.iri,\n\t\t});\n\t}\n\n\tif (!sameIriSet(relation.domain, inverse.range) || !sameIriSet(relation.range, inverse.domain)) {\n\t\tdiagnostics.push({\n\t\t\tcode: \"relation.inverse_domain_range_mismatch\",\n\t\t\tmessage: `Relation '${relation.iri}' inverse '${inverse.iri}' has incompatible domain/range`,\n\t\t\tiri: relation.iri,\n\t\t});\n\t}\n}\n\nfunction pushDirectRelationDiagnostics(relation: RelationDefinition, diagnostics: OntologyRegistryDiagnostic[]): void {\n\tif (relation.uaEdgeType === undefined) return;\n\tif (!isDirectNonTransitiveUaEdgeType(relation.uaEdgeType)) return;\n\tif (relation.transitive !== true) return;\n\n\tdiagnostics.push({\n\t\tcode: \"relation.direct_edge_transitive\",\n\t\tmessage: `Direct UA relation '${relation.uaEdgeType}' must not be marked transitive`,\n\t\tiri: relation.iri,\n\t\tuaEdgeType: relation.uaEdgeType,\n\t});\n}\n\nfunction pushRelationWeightDiagnostics(relation: RelationDefinition, diagnostics: OntologyRegistryDiagnostic[]): void {\n\tconst weightedFields = [\n\t\t[\"retrievalWeight\", relation.retrievalWeight],\n\t\t[\"impactWeight\", relation.impactWeight],\n\t\t[\"defaultConfidence\", relation.defaultConfidence],\n\t] as const;\n\n\tfor (const [fieldName, value] of weightedFields) {\n\t\tif (!isUnitInterval(value)) {\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"relation.invalid_weight\",\n\t\t\t\tmessage: `Relation '${relation.iri}' field '${fieldName}' must be in [0,1]`,\n\t\t\t\tiri: relation.iri,\n\t\t\t});\n\t\t}\n\t}\n}\n\nfunction pushMappingDiagnostics(\n\tregistry: OntologyRegistryCandidate,\n\tclassMap: ReadonlyMap<OntologyClassIri, OntologyClassDefinition>,\n\trelationMap: ReadonlyMap<RelationIri, RelationDefinition>,\n\tdiagnostics: OntologyRegistryDiagnostic[],\n): void {\n\tfor (const nodeType of UA_NODE_TYPES) {\n\t\tconst classIri = registry.uaNodeTypeToClassIri[nodeType];\n\t\tif (classIri === undefined) {\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"mapping.ua_node_missing\",\n\t\t\t\tmessage: `Missing ontology class mapping for UA node type '${nodeType}'`,\n\t\t\t\tuaNodeType: nodeType,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tif (!classMap.has(classIri)) {\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"mapping.ua_node_class_missing\",\n\t\t\t\tmessage: `UA node type '${nodeType}' maps to missing ontology class '${classIri}'`,\n\t\t\t\tiri: classIri,\n\t\t\t\tuaNodeType: nodeType,\n\t\t\t});\n\t\t}\n\t}\n\n\tfor (const edgeType of UA_EDGE_TYPES) {\n\t\tconst relationIri = registry.uaEdgeTypeToRelationIri[edgeType];\n\t\tif (relationIri === undefined) {\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"mapping.ua_edge_missing\",\n\t\t\t\tmessage: `Missing ontology relation mapping for UA edge type '${edgeType}'`,\n\t\t\t\tuaEdgeType: edgeType,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tif (!relationMap.has(relationIri)) {\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"mapping.ua_edge_relation_missing\",\n\t\t\t\tmessage: `UA edge type '${edgeType}' maps to missing ontology relation '${relationIri}'`,\n\t\t\t\tiri: relationIri,\n\t\t\t\tuaEdgeType: edgeType,\n\t\t\t});\n\t\t}\n\t}\n}\n\nfunction isDirectNonTransitiveUaEdgeType(edgeType: UaEdgeType): boolean {\n\treturn DIRECT_NON_TRANSITIVE_UA_EDGE_TYPES.some((directEdgeType) => directEdgeType === edgeType);\n}\n\nfunction isUnitInterval(value: number): boolean {\n\treturn Number.isFinite(value) && value >= 0 && value <= 1;\n}\n\nfunction sameIriSet(left: readonly OntologyClassIri[], right: readonly OntologyClassIri[]): boolean {\n\tif (left.length !== right.length) return false;\n\tconst rightSet = new Set(right);\n\treturn left.every((iri) => rightSet.has(iri));\n}\n"]}