Centralize site section config for both validators

Move site section definitions (name, root, urlPrefix) into config.ts
as the single source of truth. Both validate-paths and validate-links
now read from the shared config instead of defining their own lists.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: louis-pre

codegen/lib/config.ts

@@ -1,17 +1,34 @@
 import { join } from 'node:path'
 
-// Site section roots (paths from repo root)
-export const apiReferenceRoot = join('docs', 'api-reference')
-export const guidesRoot = join('docs', 'guides')
-
-// The published URL prefix for the API Reference site section on docs.seam.co.
-export const apiReferenceUrlPrefix = '/api'
-
 // The base URL for the published documentation site.
 export const baseUrl = 'https://docs.seam.co/latest/'
 
 // The URL prefix to strip when resolving absolute URLs to file paths.
 export const siteUrlPrefix = '/latest'
 
+// Each site section is a GitBook site section with its own SUMMARY.md.
+export interface SiteSection {
+  // Display name for logging/errors.
+  name: string
+  // Path from repo root to the section's content directory.
+  root: string
+  // Published URL prefix (e.g., '/api'). Empty string for the default section.
+  urlPrefix: string
+}
+
+export const siteSections: SiteSection[] = [
+  { name: 'Guides', root: join('docs', 'guides'), urlPrefix: '' },
+  {
+    name: 'API Reference',
+    root: join('docs', 'api-reference'),
+    urlPrefix: '/api',
+  },
+]
+
+// Convenience accessors (used by codegen)
+export const guidesRoot = siteSections[0]!.root
+export const apiReferenceRoot = siteSections[1]!.root
+export const apiReferenceUrlPrefix = siteSections[1]!.urlPrefix
+
 // Derived paths
 export const apiReferenceSummaryPath = join(apiReferenceRoot, 'SUMMARY.md')

codegen/validate-links.ts

@@ -1,19 +1,7 @@
 import { existsSync, readdirSync, readFileSync } from 'node:fs'
 import { dirname, join, resolve } from 'node:path'
 
-import {
-  apiReferenceRoot,
-  apiReferenceUrlPrefix,
-  baseUrl,
-  guidesRoot,
-  siteUrlPrefix,
-} from './lib/config.js'
-
-// Maps published URL prefixes to their site section root on disk.
-const siteSections: Array<{ urlPrefix: string; root: string }> = [
-  { urlPrefix: apiReferenceUrlPrefix, root: apiReferenceRoot },
-  { urlPrefix: '', root: guidesRoot },
-]
+import { baseUrl, siteSections, siteUrlPrefix } from './lib/config.js'
 
 const absoluteUrlPattern = new RegExp(
   `${baseUrl.replaceAll('.', '\\.')}[^)\\s]+`,

codegen/validate-paths.ts

@@ -1,26 +1,7 @@
 import { existsSync, readFileSync } from 'node:fs'
 import { join } from 'node:path'
 
-import { apiReferenceRoot, guidesRoot } from './lib/config.js'
-
-interface SiteSection {
-  name: string
-  root: string
-  summaryPath: string
-}
-
-const siteSections: SiteSection[] = [
-  {
-    name: 'Guides',
-    root: guidesRoot,
-    summaryPath: join(guidesRoot, 'SUMMARY.md'),
-  },
-  {
-    name: 'API Reference',
-    root: apiReferenceRoot,
-    summaryPath: join(apiReferenceRoot, 'SUMMARY.md'),
-  },
-]
+import { siteSections } from './lib/config.js'
 
 // Matches markdown links in SUMMARY.md: * [Title](path/to/file.md)
 const summaryLinkPattern = /\[([^\]]*)\]\(([^)]+)\)/g
@@ -37,11 +18,6 @@ function slugify(heading: string): string {
     .trim()
 }
 
-// Groups listed here contain files from multiple subdirectories by design,
-// so we only check that referenced files exist (not that their path prefix
-// matches the group slug).
-const exemptGroups = new Set<string>([])
-
 interface PathMismatch {
   section: string
   line: number
@@ -53,9 +29,10 @@ interface PathMismatch {
 const mismatches: PathMismatch[] = []
 
 for (const section of siteSections) {
-  if (!existsSync(section.summaryPath)) continue
+  const summaryPath = join(section.root, 'SUMMARY.md')
+  if (!existsSync(summaryPath)) continue
 
-  const contents = readFileSync(section.summaryPath, 'utf-8')
+  const contents = readFileSync(summaryPath, 'utf-8')
   const lines = contents.split('\n')
 
   let currentGroup: string | null = null
@@ -93,11 +70,7 @@ for (const section of siteSections) {
       }
 
       // Check 2: file path starts with the group slug
-      if (
-        currentGroup != null &&
-        !exemptGroups.has(currentGroup) &&
-        !linkPath.startsWith(currentGroup + '/')
-      ) {
+      if (currentGroup != null && !linkPath.startsWith(currentGroup + '/')) {
         mismatches.push({
           section: section.name,
           line: i + 1,