fix(cli): detect changelog overview pages beyond reserved filenames

packages/cli/cli/changes/unreleased/fix-changelog-overview-detection.yml

@@ -0,0 +1,7 @@
+- summary: |
+    Fix changelog overview page detection to recognize non-date files beyond
+    the reserved names (summary, index, overview). When no reserved-name file
+    is present, the first non-date file in the changelog directory is now
+    treated as the overview page, allowing its frontmatter slug override to
+    propagate correctly to the V1 navigation tree.
+  type: fix

packages/cli/docs-resolver/src/ChangelogNodeConverter.ts

@@ -46,6 +46,7 @@ export class ChangelogNodeConverter {
         }[] = [];
 
         let overviewPagePath: AbsoluteFilePath | undefined = undefined;
+        let fallbackOverviewPath: AbsoluteFilePath | undefined = undefined;
         for (const absoluteFilepath of this.changelogFiles ?? []) {
             const filename = last(absoluteFilepath.split("/"));
             if (filename == null) {
@@ -56,6 +57,8 @@ export class ChangelogNodeConverter {
                 const nameWithoutExtension = filename.split(".")[0]?.toLowerCase();
                 if (nameWithoutExtension != null && RESERVED_OVERVIEW_PAGE_NAMES.includes(nameWithoutExtension)) {
                     overviewPagePath = absoluteFilepath;
+                } else if (fallbackOverviewPath == null) {
+                    fallbackOverviewPath = absoluteFilepath;
                 }
 
                 continue;
@@ -68,6 +71,13 @@ export class ChangelogNodeConverter {
             });
         }
 
+        // Fall back to any non-date file as the overview when no reserved-name file is found.
+        // This handles changelogs where the overview page has a non-standard filename
+        // (e.g., "release-notes.mdx") and may carry a frontmatter slug override.
+        if (overviewPagePath == null && fallbackOverviewPath != null) {
+            overviewPagePath = fallbackOverviewPath;
+        }
+
         const slug = opts.parentSlug.apply({
             fullSlug: overviewPagePath != null ? this.markdownToFullSlug.get(overviewPagePath)?.split("/") : undefined,
             skipUrlSlug: false, // changelog pages should always have a url slug