Add docs-builder release-notes create command

config/release-notes.yml.example

@@ -0,0 +1,92 @@
+# Release Notes Configuration
+# This file configures how PR labels are mapped to YAML fields in release notes fragments
+# Place this file as `release-notes.yml` in the `config/` directory
+
+# Available types for release notes
+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
+
+# Label mappings - maps GitHub PR labels to YAML field values
+label_mappings:
+  # Maps PR labels to "type" field
+  type:
+    bug: bug-fix
+    enhancement: enhancement
+    feature: feature
+    breaking: breaking-change
+    deprecation: deprecation
+    security: security
+    docs: docs
+    regression: regression
+    known-issue: known-issue
+
+  # Maps PR labels to "subtype" field (for breaking changes)
+  subtype:
+    breaking:api: api
+    breaking:behavioral: behavioral
+    breaking:config: configuration
+    breaking:dependency: dependency
+    breaking:subscription: subscription
+    breaking:plugin: plugin
+    breaking:security: security
+
+  # Maps PR labels to "product" field
+  # Add mappings for your products, e.g.:
+  product:
+    product:elasticsearch: elasticsearch
+    product:kibana: kibana
+    product:elasticsearch-client: elasticsearch-client
+    product:apm: apm
+    product:beats: beats
+    product:elastic-agent: elastic-agent
+    product:fleet: fleet
+    product:cloud-hosted: cloud-hosted
+    product:cloud-enterprise: cloud-enterprise
+    # Add more product mappings as needed
+
+  # Maps PR labels to "area" field
+  # Areas vary by product - add mappings for your specific areas
+  area:
+    area:search: search
+    area:security: security
+    area:ml: machine-learning
+    area:observability: observability
+    area:index-management: index-management
+    # Add more area mappings as needed
+
+  # Maps PR labels to "lifecycle" field
+  lifecycle:
+    lifecycle:preview: preview
+    lifecycle:beta: beta
+    lifecycle:ga: ga
+
+  # Maps PR labels to "highlight" flag
+  highlight:
+    highlight: true
+    release-highlight: true

src/services/Elastic.Documentation.Services/Elastic.Documentation.Services.csproj

@@ -6,8 +6,15 @@
     <Nullable>enable</Nullable>
   </PropertyGroup>
 
+  <ItemGroup>
+    <PackageReference Include="Vecc.YamlDotNet.Analyzers.StaticGenerator" />
+    <PackageReference Include="YamlDotNet" />
+    <PackageReference Include="System.IO.Abstractions" />
+  </ItemGroup>
+
   <ItemGroup>
     <ProjectReference Include="..\..\Elastic.Documentation\Elastic.Documentation.csproj"/>
+    <ProjectReference Include="..\..\Elastic.Documentation.Configuration\Elastic.Documentation.Configuration.csproj"/>
   </ItemGroup>
 
 </Project>

src/services/Elastic.Documentation.Services/ReleaseNotes/ReleaseNotesConfiguration.cs

@@ -0,0 +1,80 @@
+// 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.ReleaseNotes;
+
+/// <summary>
+/// Configuration for release notes generation, including label mappings
+/// </summary>
+public class ReleaseNotesConfiguration
+{
+	public LabelMappings LabelMappings { get; set; } = new();
+	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 static ReleaseNotesConfiguration Default => new();
+}
+
+public class LabelMappings
+{
+	/// <summary>
+	/// Maps PR labels to type values (e.g., "bug" -> "bug-fix")
+	/// </summary>
+	public Dictionary<string, string> Type { get; set; } = [];
+
+	/// <summary>
+	/// Maps PR labels to subtype values (e.g., "breaking:api" -> "api")
+	/// </summary>
+	public Dictionary<string, string> Subtype { get; set; } = [];
+
+	/// <summary>
+	/// Maps PR labels to product IDs (e.g., "product:elasticsearch" -> "elasticsearch")
+	/// </summary>
+	public Dictionary<string, string> Product { get; set; } = [];
+
+	/// <summary>
+	/// Maps PR labels to area values (e.g., "area:search" -> "search")
+	/// </summary>
+	public Dictionary<string, string> Area { get; set; } = [];
+
+	/// <summary>
+	/// Maps PR labels to lifecycle values (e.g., "lifecycle:preview" -> "preview")
+	/// </summary>
+	public Dictionary<string, string> Lifecycle { get; set; } = [];
+
+	/// <summary>
+	/// Maps PR labels to highlight flag (e.g., "highlight" -> true)
+	/// </summary>
+	public Dictionary<string, bool> Highlight { get; set; } = [];
+}

src/services/Elastic.Documentation.Services/ReleaseNotes/ReleaseNotesData.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.ReleaseNotes;
+
+/// <summary>
+/// Data structure for release notes YAML file matching the exact schema
+/// </summary>
+public class ReleaseNotesData
+{
+	// Automated fields
+	public int Id { get; set; }
+	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/ReleaseNotes/ReleaseNotesInput.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.ReleaseNotes;
+
+/// <summary>
+/// Input data for creating a release notes changelog fragment
+/// </summary>
+public class ReleaseNotesInput
+{
+	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 int? Id { get; set; }
+	public string? Output { get; set; }
+}
+

src/services/Elastic.Documentation.Services/ReleaseNotes/ReleaseNotesYamlStaticContext.cs

@@ -0,0 +1,15 @@
+// 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.ReleaseNotes;
+
+[YamlStaticContext]
+[YamlSerializable(typeof(ReleaseNotesData))]
+[YamlSerializable(typeof(ProductInfo))]
+[YamlSerializable(typeof(ReleaseNotesConfiguration))]
+[YamlSerializable(typeof(LabelMappings))]
+public partial class ReleaseNotesYamlStaticContext;
+