Handle additional text inside changelog

Author: egorikftp

src/main/kotlin/org/jetbrains/changelog/Changelog.kt

@@ -137,7 +137,31 @@ data class Changelog(
 
             val (summary, items) = value.extractItemData()
 
-            Item(key, header, summary, isUnreleased, items)
+            // Capture any extra text (paragraphs, tables, ordered lists, etc.) that falls
+            // outside structured release notes by reading raw source after the last node
+            // that extractItemData actually processes.
+            val nodesWithoutHeader = value.filter { it.type != ATX_2 }
+            val sectionNodes = nodesWithoutHeader
+                .filter { it.type == ATX_3 || it.type == UNORDERED_LIST || it.type == ORDERED_LIST }
+            val lastSectionNode = sectionNodes.lastOrNull { it.type == ATX_3 }
+            // The last processed node is either the first list right after the last ATX_3, or the last list before any ATX_3
+            val lastProcessedNode = if (lastSectionNode != null) {
+                sectionNodes.firstOrNull { it.startOffset > lastSectionNode.endOffset } ?: lastSectionNode
+            } else {
+                sectionNodes.lastOrNull()
+            }
+            // Fall back to summary paragraphs
+            val endOfProcessed = lastProcessedNode?.endOffset
+                ?: nodesWithoutHeader.takeWhile { it.type == PARAGRAPH }.lastOrNull()?.endOffset
+
+            val blockEnd = value.last().endOffset
+            val suffix = if (endOfProcessed != null && endOfProcessed < blockEnd) {
+                content.substring(endOfProcessed, blockEnd).trim()
+            } else {
+                ""
+            }
+
+            Item(key, header, summary, isUnreleased, items, suffix)
                 .withEmptySections(isUnreleased)
         }
     }
@@ -250,6 +274,11 @@ data class Changelog(
                     }
                 }
 
+            if (suffix.isNotEmpty()) {
+                add(lineSeparator)
+                add(suffix)
+            }
+
             if (withLinks) {
                 links
                     .filterKeys { id ->
@@ -300,6 +329,7 @@ data class Changelog(
         val summary: String = "",
         val isUnreleased: Boolean = false,
         private val items: Map<String, Set<String>> = mutableMapOf(),
+        internal val suffix: String = "",
     ) {
 
         internal var withHeader = true
@@ -333,13 +363,14 @@ data class Changelog(
             summary: String = this.summary,
             isUnreleased: Boolean = this.isUnreleased,
             items: Map<String, Set<String>> = this.items,
+            suffix: String = this.suffix,
             withHeader: Boolean = this.withHeader,
             withLinkedHeader: Boolean = this.withLinkedHeader,
             withSummary: Boolean = this.withSummary,
             withLinks: Boolean = this.withLinks,
             withEmptySections: Boolean = this.withEmptySections,
             filterCallback: ((String) -> Boolean)? = this.filterCallback,
-        ) = Item(version, header, summary, isUnreleased, items).also {
+        ) = Item(version, header, summary, isUnreleased, items, suffix).also {
             it.withHeader = withHeader
             it.withLinkedHeader = withLinkedHeader
             it.withSummary = withSummary
@@ -356,6 +387,7 @@ data class Changelog(
             return copy(
                 summary = summary.ifEmpty { item.summary },
                 items = items + item.items,
+                suffix = listOf(suffix, item.suffix).filter { it.isNotEmpty() }.joinToString("\n\n"),
                 filterCallback = filterCallback,
             )
         }

src/test/kotlin/org/jetbrains/changelog/tasks/PatchChangelogTaskTest.kt

@@ -8,7 +8,12 @@ import org.jetbrains.changelog.exceptions.MissingVersionException
 import org.jetbrains.changelog.normalizeLineSeparator
 import java.text.SimpleDateFormat
 import java.util.*
-import kotlin.test.*
+import kotlin.test.BeforeTest
+import kotlin.test.Test
+import kotlin.test.assertEquals
+import kotlin.test.assertFailsWith
+import kotlin.test.assertFalse
+import kotlin.test.assertTrue
 
 class PatchChangelogTaskTest : BaseTest() {
 
@@ -1715,4 +1720,87 @@ class PatchChangelogTaskTest : BaseTest() {
 
         assertMarkdown(expectedContent, changelog)
     }
+
+    @Test
+    fun `additional text inside release notes`() {
+        changelog =
+            """
+            # Gradle plugin changelog
+
+            ## Unreleased
+
+            ## 0.4.0 - 2026-02-25
+
+            ### Added
+
+            - Some release notes
+            
+            Additional note for customers.
+            
+            Structured info:
+            
+            1. **L1** - text
+            2. **L2** - text
+            3. **L3** - text
+
+            ## 0.3.0 - 2026-02-24
+            
+            ### Changed
+
+            - Introduce breaking changes
+            
+            | Before | After       |
+            |--------|-------------|
+            | `test` | `test test` |
+           
+            """.trimIndent()
+
+        buildFile =
+            """
+            plugins {
+                id 'org.jetbrains.changelog'
+            }
+            changelog {
+                version = "0.4.0"
+                groups.empty()
+            }
+            """.trimIndent()
+        project.evaluate()
+        runTask(PATCH_CHANGELOG_TASK_NAME)
+
+        val expectedContent =
+            """
+            # Gradle plugin changelog
+
+            ## Unreleased
+
+            ## 0.4.0 - 2026-02-25
+
+            ### Added
+
+            - Some release notes
+            
+            Additional note for customers.
+            
+            Structured info:
+            
+            1. **L1** - text
+            2. **L2** - text
+            3. **L3** - text
+
+            ## 0.3.0 - 2026-02-24
+            
+            ### Changed
+
+            - Introduce breaking changes
+            
+            | Before | After       |
+            |--------|-------------|
+            | `test` | `test test` |
+           
+            """.trimIndent()
+
+
+        assertMarkdown(expectedContent, changelog)
+    }
 }