feat: pristine harness JSON interfaces and require-existing semantic mode (P2)

harness/tht/adapters/vector/qdrant.py

@@ -55,6 +55,7 @@ class QdrantVectorStore:
         workspace_id: str,
         workspace_revision: str | None = None,
         expected_dimension: int | None = None,
+        collection_lifecycle: str = "self_heal",
         request: Callable[..., object] | None = None,
         connect_timeout: float = 2.0,
         read_timeout: float = 10.0,
@@ -64,6 +65,7 @@ class QdrantVectorStore:
         self._workspace_id = workspace_id
         self._workspace_revision = workspace_revision
         self._expected_dimension = expected_dimension
+        self._collection_lifecycle = collection_lifecycle
         self._request = request or requests.request
         self._timeout = (connect_timeout, read_timeout)
 
@@ -306,6 +308,8 @@ class QdrantVectorStore:
         if response is None:
             if not strict:
                 raise VectorStoreError("Qdrant collection is missing")
+            if self._collection_lifecycle == "require_existing":
+                raise VectorStoreError("semantic_index_incompatible")
             self._call(
                 "PUT",
                 f"/collections/{self._collection}",
@@ -328,9 +332,13 @@ class QdrantVectorStore:
             self._expected_dimension is not None
             and (size != self._expected_dimension or distance != "Cosine")
         ):
+            if strict and self._collection_lifecycle == "require_existing":
+                raise VectorStoreError("semantic_index_incompatible")
             raise VectorStoreError("Qdrant collection configuration mismatch")
         for field_name in _KEYWORD_INDEXES:
             if field_name not in result.get("payload_schema", {}):
+                if strict and self._collection_lifecycle == "require_existing":
+                    raise VectorStoreError("semantic_index_incompatible")
                 if not strict:
                     raise VectorStoreError("Qdrant collection payload indexes mismatch")
                 self._call(