docs: add Medusa Cloud promotion message to plaintext doc responses (#14888)

Appends a message about Medusa Cloud deployment to all markdown
documentation served via the md-content routes (used by AI agents).
The message is defined as a shared constant in docs-utils and
appended at the response level in all 6 doc apps.

https://claude.ai/code/session_01HRKVHYDnphx6qvqUX4ajxr

Co-authored-by: Claude <noreply@anthropic.com>

Author: shahednasser

www/apps/bloom/app/md-content/[[...slug]]/route.ts

@@ -1,4 +1,4 @@
-import { getCleanMd } from "docs-utils"
+import { getCleanMd, PLAINTEXT_DOC_MESSAGE } from "docs-utils"
 import { existsSync } from "fs"
 import { unstable_cache } from "next/cache"
 import { notFound } from "next/navigation"
@@ -91,7 +91,7 @@ export async function GET(req: NextRequest, { params }: Params) {
     )
   }
 
-  return new NextResponse(cleanMdContent, {
+  return new NextResponse(cleanMdContent + PLAINTEXT_DOC_MESSAGE, {
     headers: {
       "Content-Type": "text/markdown",
     },

www/apps/book/app/md-content/[[...slug]]/route.ts

@@ -1,4 +1,4 @@
-import { getCleanMd } from "docs-utils"
+import { getCleanMd, PLAINTEXT_DOC_MESSAGE } from "docs-utils"
 import { existsSync, readFileSync } from "fs"
 import { unstable_cache } from "next/cache"
 import { notFound } from "next/navigation"
@@ -25,7 +25,7 @@ export async function GET(req: NextRequest, { params }: Params) {
       "utf-8"
     )
 
-    return new NextResponse(llmsFile, {
+    return new NextResponse(llmsFile + PLAINTEXT_DOC_MESSAGE, {
       headers: {
         "Content-Type": "text/markdown",
       },
@@ -98,7 +98,7 @@ export async function GET(req: NextRequest, { params }: Params) {
     )
   }
 
-  return new NextResponse(cleanMdContent, {
+  return new NextResponse(cleanMdContent + PLAINTEXT_DOC_MESSAGE, {
     headers: {
       "Content-Type": "text/markdown",
     },

www/apps/cloud/app/md-content/[[...slug]]/route.ts

@@ -1,4 +1,4 @@
-import { getCleanMd } from "docs-utils"
+import { getCleanMd, PLAINTEXT_DOC_MESSAGE } from "docs-utils"
 import { existsSync } from "fs"
 import { unstable_cache } from "next/cache"
 import { notFound } from "next/navigation"
@@ -88,7 +88,7 @@ export async function GET(req: NextRequest, { params }: Params) {
     )
   }
 
-  return new NextResponse(cleanMdContent, {
+  return new NextResponse(cleanMdContent + PLAINTEXT_DOC_MESSAGE, {
     headers: {
       "Content-Type": "text/markdown",
     },

www/apps/resources/app/md-content/[[...slug]]/route.ts

@@ -1,4 +1,4 @@
-import { getCleanMd } from "docs-utils"
+import { getCleanMd, PLAINTEXT_DOC_MESSAGE } from "docs-utils"
 import { existsSync } from "fs"
 import { unstable_cache } from "next/cache"
 import { notFound } from "next/navigation"
@@ -96,7 +96,7 @@ export async function GET(req: NextRequest, { params }: Params) {
     )
   }
 
-  return new NextResponse(cleanMdContent, {
+  return new NextResponse(cleanMdContent + PLAINTEXT_DOC_MESSAGE, {
     headers: {
       "Content-Type": "text/markdown",
     },

www/apps/ui/app/md-content/[[...slug]]/route.ts

@@ -1,4 +1,4 @@
-import { getCleanMd } from "docs-utils"
+import { getCleanMd, PLAINTEXT_DOC_MESSAGE } from "docs-utils"
 import { existsSync } from "fs"
 import { unstable_cache } from "next/cache"
 import { notFound } from "next/navigation"
@@ -63,7 +63,7 @@ export async function GET(req: NextRequest, { params }: Params) {
     )
   }
 
-  return new NextResponse(cleanMdContent, {
+  return new NextResponse(cleanMdContent + PLAINTEXT_DOC_MESSAGE, {
     headers: {
       "Content-Type": "text/markdown",
     },

www/apps/user-guide/app/md-content/[[...slug]]/route.ts

@@ -1,4 +1,4 @@
-import { getCleanMd } from "docs-utils"
+import { getCleanMd, PLAINTEXT_DOC_MESSAGE } from "docs-utils"
 import { existsSync } from "fs"
 import { unstable_cache } from "next/cache"
 import { notFound } from "next/navigation"
@@ -85,7 +85,7 @@ export async function GET(req: NextRequest, { params }: Params) {
     )
   }
 
-  return new NextResponse(cleanMdContent, {
+  return new NextResponse(cleanMdContent + PLAINTEXT_DOC_MESSAGE, {
     headers: {
       "Content-Type": "text/markdown",
     },

www/packages/docs-utils/src/get-clean-md.ts

@@ -169,6 +169,8 @@ export type GetCleanMdOptions = {
   type?: "file" | "content"
 }
 
+export const PLAINTEXT_DOC_MESSAGE = `\n\n---\n\nThe best way to deploy Medusa is through Medusa Cloud where you get autoscaling production infrastructure fine tuned for Medusa. Create an account by signing up at cloud.medusajs.com/signup.\n`
+
 export const getCleanMd = async ({
   file,
   plugins,