docs: clarify workflow validation boundaries

Author: ayush-shah

platform-api/src/openmetadata_demo_api/catalog.py

@@ -380,7 +380,10 @@ def scenarios() -> dict[str, Scenario]:
         ),
         "governance-insights": scenario_from_operations(
             "governance-insights",
-            "Governance workflows, analytics, insights, KPIs, reports, and forms",
+            (
+                "Governance, insight, and report requests validated against RC1 schemas "
+                "and available models"
+            ),
             tuple(
                 operation
                 for operation in all_operations

platform-api/tests/test_runtime.py

@@ -831,7 +831,7 @@ def test_governance_insight_scenario_covers_source_routes_and_dependencies() ->
     assert ordered.index("createDashboardService") < ordered.index("createOrUpdateReport")
 
 
-def test_governance_insight_requests_are_validated_and_placeholder_free() -> None:
+def test_governance_insight_requests_respect_recorded_validation_boundaries() -> None:
     scenario = scenarios()["governance-insights"]
 
     assert not {
@@ -853,3 +853,13 @@ def test_governance_insight_requests_are_validated_and_placeholder_free() -> Non
         "CreateWorkflowDefinitionRequest",
         "CreateWorkflowInstanceStateRequest",
     } <= models
+    assets_by_model = {
+        str(asset["model"]).rsplit(".", 1)[-1]: asset
+        for asset in load_assets()
+        if "governance-insights" in asset["scenarios"]
+    }
+    for model_name in ("CreateWorkflowDefinitionRequest", "WorkflowConfiguration"):
+        assert assets_by_model[model_name]["validation"] == "json-schema-only"
+        assert assets_by_model[model_name]["validationNote"].startswith(
+            "RC1 generated-model defect:"
+        )