Expose stage/release status in schema

.vscode/settings.json

@@ -22,5 +22,13 @@
         "script": "shellscript",
         "script.prepare": "shellscript",
         "script.cleanup": "shellscript"
+    },
+    "yaml.schemas": {
+        "./bundle/schema/jsonschema.json": [
+            "databricks.yml",
+            "databricks.yaml",
+            "bundle.yml",
+            "bundle.yaml",
+        ]
     }
 }

bundle/docsgen/main.go

@@ -139,13 +139,57 @@ func assignAnnotation(s *jsonschema.Schema, a annotation.Descriptor) {
 		s.Deprecated = true
 		s.DeprecationMessage = a.DeprecationMessage
 	}
-	if a.Preview == "PRIVATE" {
-		s.DoNotSuggest = true
+	if a.Preview != "" {
 		s.Preview = a.Preview
+		if a.Preview == "PRIVATE" {
+			s.DoNotSuggest = true
+		}
+	}
+	if a.LaunchStage != "" {
+		s.LaunchStage = a.LaunchStage
+		switch a.LaunchStage {
+		case "PRIVATE_PREVIEW", "DEVELOPMENT":
+			s.DoNotSuggest = true
+		}
 	}
 	if a.OutputOnly != nil && *a.OutputOnly {
 		s.DoNotSuggest = true
 	}
+
+	if tag := previewTag(a.LaunchStage, a.Preview); tag != "" {
+		if s.Description != "" {
+			s.Description = tag + " " + s.Description
+		} else {
+			s.Description = tag
+		}
+	}
+}
+
+// previewTag returns the human-readable launch-stage prefix to prepend to a
+// field's description. LaunchStage is preferred over Preview because it carries
+// the richer signal (Beta vs. Public Preview), falling back to the legacy
+// Preview field when only that's available. DEVELOPMENT is intentionally not
+// surfaced — those fields are filtered out at extraction time, so reaching
+// this code path with DEVELOPMENT means something is wrong; the safe default
+// is to emit no tag rather than leak a [Development] marker into the docs.
+//
+// Keep this in sync with previewTag in bundle/internal/schema/annotations.go.
+func previewTag(launchStage, preview string) string {
+	switch launchStage {
+	case "PRIVATE_PREVIEW":
+		return "[Private Preview]"
+	case "PUBLIC_BETA":
+		return "[Public Beta]"
+	case "PUBLIC_PREVIEW":
+		return "[Public Preview]"
+	}
+	switch preview {
+	case "PRIVATE":
+		return "[Private Preview]"
+	case "PUBLIC":
+		return "[Public Preview]"
+	}
+	return ""
 }
 
 func fillTemplateVariables(s string) string {