Fix link checker false positives for enterprise-server@latest URLs (#59716)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: heiskr

src/links/lib/extract-links.ts

@@ -9,6 +9,7 @@ import fs from 'fs'
 import path from 'path'
 
 import { allVersions } from '@/versions/lib/all-versions'
+import { latestStable } from '@/versions/lib/enterprise-server-releases'
 import { getDataByLanguage } from '@/data-directory/lib/get-data'
 import type { Context, Page } from '@/types'
 
@@ -307,22 +308,31 @@ export function checkInternalLink(
 ): { exists: boolean; isRedirect: boolean; redirectTarget?: string } {
   const normalized = normalizeLinkPath(href)
 
+  // Resolve enterprise-server@latest to actual version, mirroring runtime behavior.
+  // Handle both /enterprise-server@latest/... and /en/enterprise-server@latest/...
+  const latestPrefix = '/enterprise-server@latest'
+  const stablePrefix = `/enterprise-server@${latestStable}`
+  const resolved =
+    normalized.startsWith(latestPrefix) || normalized.startsWith(`/en${latestPrefix}`)
+      ? normalized.replace(latestPrefix, stablePrefix)
+      : normalized
+
   // Check if it's a direct page
-  if (pageMap[normalized]) {
+  if (pageMap[resolved]) {
     return { exists: true, isRedirect: false }
   }
 
   // Check if it's a redirect
-  if (redirects[normalized]) {
+  if (redirects[resolved]) {
     return {
       exists: true,
       isRedirect: true,
-      redirectTarget: redirects[normalized],
+      redirectTarget: redirects[resolved],
     }
   }
 
   // Check with /en prefix (FPT pages are stored with language prefix)
-  const withLang = `/en${normalized}`
+  const withLang = `/en${resolved}`
   if (pageMap[withLang]) {
     return { exists: true, isRedirect: false }
   }

src/links/tests/extract-links.ts

@@ -6,6 +6,7 @@ import {
   checkAssetLink,
   isAssetLink,
 } from '../lib/extract-links'
+import { latestStable } from '@/versions/lib/enterprise-server-releases'
 
 describe('extractLinksFromMarkdown', () => {
   test('extracts simple internal links', () => {
@@ -179,6 +180,7 @@ describe('checkInternalLink', () => {
     '/en/actions/getting-started': {} as any,
     '/en/repositories/overview': {} as any,
     '/actions/guides': {} as any,
+    [`/en/enterprise-server@${latestStable}/admin/overview`]: {} as any,
   }
 
   const redirects = {
@@ -210,6 +212,27 @@ describe('checkInternalLink', () => {
     expect(result.exists).toBe(false)
     expect(result.isRedirect).toBe(false)
   })
+
+  test('resolves enterprise-server@latest to actual version', () => {
+    const result = checkInternalLink('/enterprise-server@latest/admin/overview', pageMap, redirects)
+    expect(result.exists).toBe(true)
+    expect(result.isRedirect).toBe(false)
+  })
+
+  test('resolves enterprise-server@latest with language prefix', () => {
+    const result = checkInternalLink(
+      '/en/enterprise-server@latest/admin/overview',
+      pageMap,
+      redirects,
+    )
+    expect(result.exists).toBe(true)
+    expect(result.isRedirect).toBe(false)
+  })
+
+  test('resolves enterprise-server@latest for non-existent page', () => {
+    const result = checkInternalLink('/enterprise-server@latest/does/not/exist', pageMap, redirects)
+    expect(result.exists).toBe(false)
+  })
 })
 
 describe('isAssetLink', () => {