stable asset queries, lexical search, filters, contextual entity and relationship retrieval, permission-aware fail-closed behavior, source-grounded snippets, feedback capture, and KPI hooks

src/kontextual_engine/__init__.py

@@ -49,6 +49,8 @@ from .core import (
     PolicyEffect,
     RelationshipTargetKind,
     RepresentationKind,
+    RetrievalFeedbackLabel,
+    RetrievalFeedbackRecord,
     Sensitivity,
     SourceReference,
     SourcePayload,
@@ -81,8 +83,23 @@ from .services import (
     AssetChangeResult,
     AssetIngestionResult,
     AssetIngestionService,
+    AssetQueryItem,
+    AssetQueryRequest,
+    AssetQueryResult,
     AssetRegistryService,
+    AssetRetrievalService,
+    ContextEntityQueryItem,
+    ContextEntityQueryRequest,
+    ContextEntityQueryResult,
+    LexicalIndexRefreshResult,
     RelationshipChangeResult,
+    RelationshipQueryItem,
+    RelationshipQueryRequest,
+    RelationshipQueryResult,
+    RetrievalFeedbackRequest,
+    RetrievalFeedbackResult,
+    RetrievalQualityMetrics,
+    RetrievalSnippet,
 )
 from .storage import InMemoryKnowledgeRepository
 from .workflows import (
@@ -108,8 +125,12 @@ __all__ = [
     "AssetChangeResult",
     "AssetIngestionResult",
     "AssetIngestionService",
+    "AssetQueryItem",
+    "AssetQueryRequest",
+    "AssetQueryResult",
     "AssetRegistryRepository",
     "AssetRegistryService",
+    "AssetRetrievalService",
     "AssetVersion",
     "AuditEvent",
     "AuditOutcome",
@@ -121,6 +142,9 @@ __all__ = [
     "Collection",
     "ContextAssembler",
     "ContextEntity",
+    "ContextEntityQueryItem",
+    "ContextEntityQueryRequest",
+    "ContextEntityQueryResult",
     "ContextEntityType",
     "ContextItem",
     "ContextPackage",
@@ -146,6 +170,7 @@ __all__ = [
     "IdempotencyStatus",
     "KnowledgeAsset",
     "KontextualError",
+    "LexicalIndexRefreshResult",
     "LifecycleState",
     "MetadataFieldDefinition",
     "MetadataRecord",
@@ -167,9 +192,18 @@ __all__ = [
     "Relationship",
     "RelationshipChangeResult",
     "RelationshipGraph",
+    "RelationshipQueryItem",
+    "RelationshipQueryRequest",
+    "RelationshipQueryResult",
     "RelationshipTargetKind",
     "RelationshipType",
     "RepresentationKind",
+    "RetrievalFeedbackLabel",
+    "RetrievalFeedbackRecord",
+    "RetrievalFeedbackRequest",
+    "RetrievalFeedbackResult",
+    "RetrievalQualityMetrics",
+    "RetrievalSnippet",
     "RunManifest",
     "RunStatus",
     "Sensitivity",