Feat: OSI semantic-model core entity and CRUD

extensions/semantic-models/build.gradle.kts

@@ -41,8 +41,8 @@ dependencies {
   // CatalogAdapter and other shared catalog service abstractions.
   implementation(project(":polaris-runtime-service"))
 
-  // Dependencies required by the generated OSI semantic-model REST API code (mirrors the set used
-  // by the polaris-api-catalog-service generated code).
+  // Dependencies required by the generated Ossie semantic-model REST API code (mirrors the set
+  // used by the polaris-api-catalog-service generated code).
   implementation(platform(libs.iceberg.bom))
   implementation("org.apache.iceberg:iceberg-api")
   implementation("org.apache.iceberg:iceberg-core")
@@ -73,6 +73,17 @@ dependencies {
   testImplementation(platform(libs.junit.bom))
   testImplementation("org.junit.jupiter:junit-jupiter")
   testImplementation(libs.assertj.core)
+
+  // Real-manifest handler tests bootstrap services via the runtime-service test fixtures
+  // (TestServices), which is the only way to reproduce the strict resolution-manifest behavior
+  // that the pure-Mockito unit test cannot.
+  testImplementation(testFixtures(project(":polaris-runtime-service")))
+  testImplementation(project(":polaris-api-management-model"))
+  testImplementation(project(":polaris-api-management-service"))
+  testImplementation(project(":polaris-api-iceberg-service"))
+  testImplementation(project(":polaris-api-catalog-service"))
+  testCompileOnly(project(":polaris-immutables"))
+  testAnnotationProcessor(project(":polaris-immutables", configuration = "processor"))
 }
 
 val rootDir = rootProject.layout.projectDirectory

extensions/semantic-models/src/main/java/org/apache/polaris/service/catalog/semanticmodel/SemanticDocumentValidator.java

@@ -0,0 +1,40 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.polaris.service.catalog.semanticmodel;
+
+import org.apache.polaris.service.catalog.semanticmodel.types.SemanticModelDocument;
+
+/**
+ * Contract for validating an Apache Ossie semantic-model document at write time.
+ *
+ * <p>Only the interface ships in this phase. The concrete implementation (schema validation against
+ * the bundled Ossie JSON Schema, size caps, etc.) is tracked by <a
+ * href="https://github.com/apache/polaris/issues/4522">apache/polaris#4522</a>. Implementations are
+ * expected to signal an invalid document by throwing an exception that maps to HTTP 400 (e.g.
+ * {@link org.apache.iceberg.exceptions.BadRequestException}) with field-level detail.
+ */
+public interface SemanticDocumentValidator {
+
+  /**
+   * Validates the given Ossie document, throwing on failure.
+   *
+   * @param document the document to validate (its {@code version} and {@code semantic_model} body)
+   */
+  void validate(SemanticModelDocument document);
+}