feat(llm-docs): add .md shorthand redirects

Author: lukeocodes

server/middleware/canonical-redirects.global.ts

@@ -54,7 +54,7 @@ export default defineEventHandler(async event => {
   // /@org/pkg or /pkg → /package/org/pkg or /package/pkg
   // Also handles trailing /llms.txt or /llms_full.txt suffixes
   let pkgMatch = path.match(
-    /^\/(?:(?<org>@[^/]+)\/)?(?<name>[^/@]+)(?<suffix>\/(?:llms\.txt|llms_full\.txt))?$/,
+    /^\/(?:(?<org>@[^/]+)\/)?(?<name>[^/@]+?)(?<suffix>\.md|\/(?:llms\.txt|llms_full\.txt))?$/,
   )
   if (pkgMatch?.groups) {
     const args = [pkgMatch.groups.org, pkgMatch.groups.name].filter(Boolean).join('/')
@@ -68,10 +68,10 @@ export default defineEventHandler(async event => {
   // Also handles trailing /llms.txt or /llms_full.txt suffixes
   const pkgVersionMatch =
     path.match(
-      /^\/(?:(?<org>@[^/]+)\/)?(?<name>[^/@]+)\/v\/(?<version>[^/]+)(?<suffix>\/(?:llms\.txt|llms_full\.txt))?$/,
+      /^\/(?:(?<org>@[^/]+)\/)?(?<name>[^/@]+)\/v\/(?<version>[^/]+?)(?<suffix>\.md|\/(?:llms\.txt|llms_full\.txt))?$/,
     ) ||
     path.match(
-      /^\/(?:(?<org>@[^/]+)\/)?(?<name>[^/@]+)@(?<version>[^/]+)(?<suffix>\/(?:llms\.txt|llms_full\.txt))?$/,
+      /^\/(?:(?<org>@[^/]+)\/)?(?<name>[^/@]+)@(?<version>[^/]+?)(?<suffix>\.md|\/(?:llms\.txt|llms_full\.txt))?$/,
     )
 
   if (pkgVersionMatch?.groups) {

server/middleware/llm-docs.ts

@@ -11,7 +11,7 @@ import {
 const CACHE_HEADER = 's-maxage=3600, stale-while-revalidate=86400'
 
 /**
- * Middleware to handle ALL llms.txt / llms_full.txt routes.
+ * Middleware to handle ALL llms.txt / llms_full.txt / .md routes.
  *
  * All llms.txt handling lives here rather than in file-based routes because
  * Vercel's ISR route rules with glob patterns (e.g. `/package/ ** /llms.txt`)
@@ -20,6 +20,10 @@ const CACHE_HEADER = 's-maxage=3600, stale-while-revalidate=86400'
  *
  * Handles:
  * - /llms.txt (root discovery page)
+ * - /package/:name.md (unscoped, latest, raw README)
+ * - /package/@:org/:name.md (scoped, latest, raw README)
+ * - /package/:name/v/:version.md (unscoped, versioned, raw README)
+ * - /package/@:org/:name/v/:version.md (scoped, versioned, raw README)
  * - /package/@:org/llms.txt (org package listing)
  * - /package/:name/llms.txt (unscoped, latest)
  * - /package/:name/llms_full.txt (unscoped, latest, full)