Add docs-builder release-notes create command (#2298)

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>

Author: lcawl

config/changelog.yml.example

@@ -0,0 +1,56 @@
+# Changelog Configuration
+# This file configures the valid values for changelog fields.
+# Place this file as `changelog.yml` in the `docs/` directory
+
+# Available types for changelog entries
+available_types:
+  - feature
+  - enhancement
+  - bug-fix
+  - known-issue
+  - breaking-change
+  - deprecation
+  - docs
+  - regression
+  - security
+  - other
+
+# Available subtypes for breaking changes
+available_subtypes:
+  - api
+  - behavioral
+  - configuration
+  - dependency
+  - subscription
+  - plugin
+  - security
+  - other
+
+# Available lifecycle values
+available_lifecycles:
+  - preview
+  - beta
+  - ga
+
+# Available areas (optional - if not specified, all areas are allowed)
+available_areas:
+  - search
+  - security
+  - machine-learning
+  - observability
+  - index-management
+  # Add more areas as needed
+
+# Available products (optional - if not specified, all products are allowed)
+available_products:
+  - elasticsearch
+  - kibana
+  - apm
+  - beats
+  - elastic-agent
+  - fleet
+  - cloud-hosted
+  - cloud-serverless
+  - cloud-enterprise
+  # Add more products as needed
+

src/services/Elastic.Documentation.Services/Changelog/ChangelogConfiguration.cs

@@ -0,0 +1,51 @@
+// Licensed to Elasticsearch B.V under one or more agreements.
+// Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
+// See the LICENSE file in the project root for more information
+
+namespace Elastic.Documentation.Services.Changelog;
+
+/// <summary>
+/// Configuration for changelog generation
+/// </summary>
+public class ChangelogConfiguration
+{
+	public List<string> AvailableTypes { get; set; } =
+	[
+		"feature",
+		"enhancement",
+		"bug-fix",
+		"known-issue",
+		"breaking-change",
+		"deprecation",
+		"docs",
+		"regression",
+		"security",
+		"other"
+	];
+
+	public List<string> AvailableSubtypes { get; set; } =
+	[
+		"api",
+		"behavioral",
+		"configuration",
+		"dependency",
+		"subscription",
+		"plugin",
+		"security",
+		"other"
+	];
+
+	public List<string> AvailableLifecycles { get; set; } =
+	[
+		"preview",
+		"beta",
+		"ga"
+	];
+
+	public List<string>? AvailableAreas { get; set; }
+
+	public List<string>? AvailableProducts { get; set; }
+
+	public static ChangelogConfiguration Default => new();
+}
+

src/services/Elastic.Documentation.Services/Changelog/ChangelogData.cs

@@ -0,0 +1,35 @@
+// Licensed to Elasticsearch B.V under one or more agreements.
+// Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
+// See the LICENSE file in the project root for more information
+
+namespace Elastic.Documentation.Services.Changelog;
+
+/// <summary>
+/// Data structure for changelog YAML file matching the exact schema
+/// </summary>
+public class ChangelogData
+{
+	// Automated fields
+	public string? Pr { get; set; }
+	public List<string>? Issues { get; set; }
+	public string Type { get; set; } = string.Empty;
+	public string? Subtype { get; set; }
+	public List<ProductInfo> Products { get; set; } = [];
+	public List<string>? Areas { get; set; }
+
+	// Non-automated fields
+	public string Title { get; set; } = string.Empty;
+	public string? Description { get; set; }
+	public string? Impact { get; set; }
+	public string? Action { get; set; }
+	public string? FeatureId { get; set; }
+	public bool? Highlight { get; set; }
+}
+
+public class ProductInfo
+{
+	public string Product { get; set; } = string.Empty;
+	public string? Target { get; set; }
+	public string? Lifecycle { get; set; }
+}
+

src/services/Elastic.Documentation.Services/Changelog/ChangelogInput.cs

@@ -0,0 +1,27 @@
+// Licensed to Elasticsearch B.V under one or more agreements.
+// Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
+// See the LICENSE file in the project root for more information
+
+namespace Elastic.Documentation.Services.Changelog;
+
+/// <summary>
+/// Input data for creating a changelog fragment
+/// </summary>
+public class ChangelogInput
+{
+	public required string Title { get; set; }
+	public required string Type { get; set; }
+	public required List<ProductInfo> Products { get; set; }
+	public string? Subtype { get; set; }
+	public string[] Areas { get; set; } = [];
+	public string? Pr { get; set; }
+	public string[] Issues { get; set; } = [];
+	public string? Description { get; set; }
+	public string? Impact { get; set; }
+	public string? Action { get; set; }
+	public string? FeatureId { get; set; }
+	public bool? Highlight { get; set; }
+	public string? Output { get; set; }
+	public string? Config { get; set; }
+}
+

src/services/Elastic.Documentation.Services/Changelog/ChangelogYamlStaticContext.cs

@@ -0,0 +1,14 @@
+// Licensed to Elasticsearch B.V under one or more agreements.
+// Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
+// See the LICENSE file in the project root for more information
+
+using YamlDotNet.Serialization;
+
+namespace Elastic.Documentation.Services.Changelog;
+
+[YamlStaticContext]
+[YamlSerializable(typeof(ChangelogData))]
+[YamlSerializable(typeof(ProductInfo))]
+[YamlSerializable(typeof(ChangelogConfiguration))]
+public partial class ChangelogYamlStaticContext;
+