blume 2.0.1 → 2.0.3

package/src/core/ui-packs/sk.ts

@@ -43,9 +43,20 @@ export const sk: UIStringsOverride = {
     title: "Zoznam zmien",
   },
   content: {
+    code: "Kód",
     copyColor: "Kopírovať farbu {name} {value}",
     copyPrompt: "Kopírovať prompt",
+    default: "Predvolené",
     diagramError: "Tento diagram sa nepodarilo vykresliť.",
+    forks: "Forky",
+    preview: "Náhľad",
+    prop: "Vlastnosť",
+    selectTab: "Vybrať kartu",
+    showMore: "Zobraziť viac",
+    stars: "Hviezdičky",
+    tab: "Karta {n}",
+    type: "Typ",
+    update: "Aktualizácia",
   },
   feedback: {
     no: "Nie",
@@ -87,8 +98,10 @@ export const sk: UIStringsOverride = {
     assistantHint: "Získajte okamžitú odpoveď od AI",
     button: "Hľadať",
     devOnly: "Vyhľadávanie je dostupné v produkčnom builde.",
+    docs: "Dokumentácia",
     error: "Niečo sa pokazilo. Skúste to znova.",
     label: "Prehľadať dokumentáciu",
+    latest: "najnovšia",
     navigate: "navigácia",
     noResults: "Nenašli sa žiadne výsledky.",
     open: "otvoriť",

package/src/core/ui-packs/sr.ts

@@ -43,9 +43,20 @@ export const sr: UIStringsOverride = {
     title: "Дневник измена",
   },
   content: {
+    code: "Код",
     copyColor: "Копирај боју {name} {value}",
     copyPrompt: "Копирај упит",
+    default: "Подразумевано",
     diagramError: "Није могуће приказати овај дијаграм.",
+    forks: "Форкови",
+    preview: "Преглед",
+    prop: "Својство",
+    selectTab: "Изабери картицу",
+    showMore: "Прикажи више",
+    stars: "Звездице",
+    tab: "Картица {n}",
+    type: "Тип",
+    update: "Ажурирање",
   },
   feedback: {
     no: "Не",
@@ -87,8 +98,10 @@ export const sr: UIStringsOverride = {
     assistantHint: "Добијте тренутан одговор од AI-ја",
     button: "Претражи",
     devOnly: "Претрага је доступна у продукцијској верзији.",
+    docs: "Документација",
     error: "Нешто је пошло наопако. Покушајте поново.",
     label: "Претражи документацију",
+    latest: "најновија",
     navigate: "навигација",
     noResults: "Нема резултата.",
     open: "отвори",

package/src/core/ui-packs/sv.ts

@@ -44,9 +44,20 @@ export const sv: UIStringsOverride = {
     title: "Ändringslogg",
   },
   content: {
+    code: "Kod",
     copyColor: "Kopiera färgen {name} {value}",
     copyPrompt: "Kopiera prompt",
+    default: "Standard",
     diagramError: "Det här diagrammet kunde inte visas.",
+    forks: "Forkar",
+    preview: "Förhandsgranskning",
+    prop: "Egenskap",
+    selectTab: "Välj flik",
+    showMore: "Visa mer",
+    stars: "Stjärnor",
+    tab: "Flik {n}",
+    type: "Typ",
+    update: "Uppdatering",
   },
   feedback: {
     no: "Nej",
@@ -88,8 +99,10 @@ export const sv: UIStringsOverride = {
     assistantHint: "Få ett omedelbart svar från AI",
     button: "Sök",
     devOnly: "Sökning är tillgänglig i produktionsbygget.",
+    docs: "Dokumentation",
     error: "Något gick fel. Försök igen.",
     label: "Sök i dokumentationen",
+    latest: "senaste",
     navigate: "navigera",
     noResults: "Inga resultat hittades.",
     open: "öppna",

package/src/core/ui-packs/th.ts

@@ -43,9 +43,20 @@ export const th: UIStringsOverride = {
     title: "บันทึกการเปลี่ยนแปลง",
   },
   content: {
+    code: "โค้ด",
     copyColor: "คัดลอกสี {name} {value}",
     copyPrompt: "คัดลอกพรอมต์",
+    default: "ค่าเริ่มต้น",
     diagramError: "ไม่สามารถแสดงไดอะแกรมนี้ได้",
+    forks: "ฟอร์ก",
+    preview: "ตัวอย่าง",
+    prop: "คุณสมบัติ",
+    selectTab: "เลือกแท็บ",
+    showMore: "แสดงเพิ่มเติม",
+    stars: "ดาว",
+    tab: "แท็บ {n}",
+    type: "ชนิด",
+    update: "อัปเดต",
   },
   feedback: {
     no: "ไม่",
@@ -87,8 +98,10 @@ export const th: UIStringsOverride = {
     assistantHint: "รับคำตอบทันทีจาก AI",
     button: "ค้นหา",
     devOnly: "การค้นหาพร้อมใช้งานในบิลด์โปรดักชัน",
+    docs: "เอกสาร",
     error: "เกิดข้อผิดพลาดบางอย่าง โปรดลองอีกครั้ง",
     label: "ค้นหาเอกสาร",
+    latest: "ล่าสุด",
     navigate: "นำทาง",
     noResults: "ไม่พบผลลัพธ์",
     open: "เปิด",

package/src/core/ui-packs/tr.ts

@@ -44,9 +44,20 @@ export const tr: UIStringsOverride = {
     title: "Değişiklik günlüğü",
   },
   content: {
+    code: "Kod",
     copyColor: "Rengi kopyala: {name} {value}",
     copyPrompt: "İstemi kopyala",
+    default: "Varsayılan",
     diagramError: "Bu diyagram görüntülenemedi.",
+    forks: "Çatallar",
+    preview: "Önizleme",
+    prop: "Özellik",
+    selectTab: "Sekme seç",
+    showMore: "Daha fazla göster",
+    stars: "Yıldızlar",
+    tab: "Sekme {n}",
+    type: "Tür",
+    update: "Güncelleme",
   },
   feedback: {
     no: "Hayır",
@@ -88,8 +99,10 @@ export const tr: UIStringsOverride = {
     assistantHint: "Yapay zekâdan anında yanıt alın",
     button: "Ara",
     devOnly: "Arama, üretim derlemesinde kullanılabilir.",
+    docs: "Belgeler",
     error: "Bir şeyler ters gitti. Lütfen tekrar deneyin.",
     label: "Belgelerde ara",
+    latest: "en son",
     navigate: "gezin",
     noResults: "Sonuç bulunamadı.",
     open: "aç",

package/src/core/ui-packs/uk.ts

@@ -44,9 +44,20 @@ export const uk: UIStringsOverride = {
     title: "Журнал змін",
   },
   content: {
+    code: "Код",
     copyColor: "Скопіювати колір {name} {value}",
     copyPrompt: "Скопіювати промпт",
+    default: "За замовчуванням",
     diagramError: "Не вдалося відобразити цю діаграму.",
+    forks: "Форки",
+    preview: "Попередній перегляд",
+    prop: "Властивість",
+    selectTab: "Вибрати вкладку",
+    showMore: "Показати більше",
+    stars: "Зірки",
+    tab: "Вкладка {n}",
+    type: "Тип",
+    update: "Оновлення",
   },
   feedback: {
     no: "Ні",
@@ -88,8 +99,10 @@ export const uk: UIStringsOverride = {
     assistantHint: "Отримайте миттєву відповідь від ШІ",
     button: "Пошук",
     devOnly: "Пошук доступний у production-збірці.",
+    docs: "Документація",
     error: "Щось пішло не так. Спробуйте ще раз.",
     label: "Пошук у документації",
+    latest: "остання",
     navigate: "навігація",
     noResults: "Нічого не знайдено.",
     open: "відкрити",

package/src/core/ui-packs/vi.ts

@@ -43,9 +43,20 @@ export const vi: UIStringsOverride = {
     title: "Nhật ký thay đổi",
   },
   content: {
+    code: "Mã",
     copyColor: "Sao chép màu {name} {value}",
     copyPrompt: "Sao chép prompt",
+    default: "Mặc định",
     diagramError: "Không thể hiển thị sơ đồ này.",
+    forks: "Fork",
+    preview: "Xem trước",
+    prop: "Thuộc tính",
+    selectTab: "Chọn tab",
+    showMore: "Hiển thị thêm",
+    stars: "Sao",
+    tab: "Tab {n}",
+    type: "Kiểu",
+    update: "Cập nhật",
   },
   feedback: {
     no: "Không",
@@ -87,8 +98,10 @@ export const vi: UIStringsOverride = {
     assistantHint: "Nhận câu trả lời tức thì từ AI",
     button: "Tìm kiếm",
     devOnly: "Tìm kiếm có sẵn trong bản dựng production.",
+    docs: "Tài liệu",
     error: "Đã xảy ra sự cố. Vui lòng thử lại.",
     label: "Tìm kiếm tài liệu",
+    latest: "mới nhất",
     navigate: "di chuyển",
     noResults: "Không tìm thấy kết quả.",
     open: "mở",

package/src/core/ui-packs/zh-tw.ts

@@ -43,9 +43,20 @@ export const zhTW: UIStringsOverride = {
     title: "更新日誌",
   },
   content: {
+    code: "程式碼",
     copyColor: "複製顏色 {name} {value}",
     copyPrompt: "複製提示詞",
+    default: "預設值",
     diagramError: "無法顯示此圖表。",
+    forks: "複刻",
+    preview: "預覽",
+    prop: "屬性",
+    selectTab: "選擇分頁",
+    showMore: "顯示更多",
+    stars: "星標",
+    tab: "分頁 {n}",
+    type: "型別",
+    update: "更新",
   },
   feedback: {
     no: "沒有幫助",
@@ -87,8 +98,10 @@ export const zhTW: UIStringsOverride = {
     assistantHint: "從 AI 即時取得解答",
     button: "搜尋",
     devOnly: "搜尋在正式版組建中可用。",
+    docs: "文件",
     error: "發生了一些問題，請再試一次。",
     label: "搜尋文件",
+    latest: "最新",
     navigate: "導覽",
     noResults: "找不到結果。",
     open: "開啟",

package/src/core/ui-packs/zh.ts

@@ -43,9 +43,20 @@ export const zh: UIStringsOverride = {
     title: "更新日志",
   },
   content: {
+    code: "代码",
     copyColor: "复制颜色 {name} {value}",
     copyPrompt: "复制提示词",
+    default: "默认值",
     diagramError: "无法渲染此图表。",
+    forks: "复刻",
+    preview: "预览",
+    prop: "属性",
+    selectTab: "选择标签页",
+    showMore: "显示更多",
+    stars: "星标",
+    tab: "标签页 {n}",
+    type: "类型",
+    update: "更新",
   },
   feedback: {
     no: "没有帮助",
@@ -87,8 +98,10 @@ export const zh: UIStringsOverride = {
     assistantHint: "从 AI 即时获取答案",
     button: "搜索",
     devOnly: "搜索在生产构建中可用。",
+    docs: "文档",
     error: "出了点问题，请重试。",
     label: "搜索文档",
+    latest: "最新",
     navigate: "导航",
     noResults: "未找到结果。",
     open: "打开",

package/src/core/version-cut.ts

@@ -3,7 +3,7 @@ import { cp, readdir, readFile, rm } from "node:fs/promises";
 
 import { join, relative } from "pathe";
 
-import { stripBasePath } from "./base-path.ts";
+import { mountBasePath, stripBasePath } from "./base-path.ts";
 import { nextFenceState } from "./code-fences.ts";
 import type { FenceState } from "./code-fences.ts";
 import { writeTextAtomic } from "./fs-atomic.ts";
@@ -45,18 +45,22 @@ export class CutError extends Error {
 // matching so replacements can splice into the real line by index (the mask
 // preserves length). Mirrors the content-assets rewriter.
 const INLINE_CODE = /`[^`]*`/gu;
-// A markdown link/image target or an HTML href/src attribute whose value is
-// root-absolute. Named groups carry the prefix (kept) and target (rewritten).
-const ROOT_LINK = /(?<prefix>\]\(|href="|src=")(?<target>\/[^\s"')]*)/gu;
+// A root-absolute markdown link/image target, reference-style link definition
+// (`[setup]: /guides/setup`, up to three spaces in, never a `[^note]:`
+// footnote), or HTML href/src attribute in either quote style. Named groups
+// carry the prefix (kept) and target (rewritten).
+const ROOT_LINK =
+  /(?<prefix>\]\(|^ {0,3}\[(?!\^)[^\]]+\]:[ \t]*<?|(?:href|src)=["'])(?<target>\/[^\s"'<>)]*)/gu;
 
 /**
  * Build the link-rewrite table: every current-version route (basePath
- * stripped, since authors write root-absolute links as if mounted at root)
- * mapped to the same page's route inside the new snapshot. Only pages the
- * snapshot actually contains qualify — filesystem pages under the content
- * root. Spec-rendered references (`/api`, `/events`) and remote sources
- * aren't copied, so links to them keep pointing at the live pages instead of
- * a 404 inside the snapshot.
+ * stripped, since authors write root-absolute links as if mounted at root;
+ * a link that spells the base out is looked up without it, see
+ * `snapshotTarget`) mapped to the same page's route inside the new snapshot.
+ * Only pages the snapshot actually contains qualify — filesystem pages under
+ * the content root. Spec-rendered references (`/api`, `/events`) and remote
+ * sources aren't copied, so links to them keep pointing at the live pages
+ * instead of a 404 inside the snapshot.
  */
 const buildRouteRewrites = (
   project: BlumeProject,
@@ -65,6 +69,13 @@ const buildRouteRewrites = (
   const { basePath, i18n } = project.config;
   const { contentRoot } = project.context;
   const rewrites = new Map<string, string>();
+  // Under i18n, authors write links in the unprefixed form (`/guides/setup`)
+  // and rendering moves them into the reader's locale — a form no page is
+  // routed at when the default locale keeps its prefix
+  // (`hideDefaultLocalePrefix: false`). So it is mapped too, to the
+  // unprefixed snapshot route, which rendering localizes the same way. Page
+  // routes win where the two forms coincide.
+  const logical = new Map<string, string>();
   for (const page of project.graph.pages) {
     // `sourcePath` marks a page backed by a local file, which excludes
     // generated and remote pages; the content-root check below excludes local
@@ -81,17 +92,52 @@ const buildRouteRewrites = (
     ) {
       continue;
     }
-    const logical = versionizeRoute(page.versionKey, id);
+    const snapshot = versionizeRoute(page.versionKey, id);
     rewrites.set(
       stripBasePath(basePath, page.route),
-      i18n ? localizeRoute(logical, page.locale, i18n) : logical
+      i18n ? localizeRoute(snapshot, page.locale, i18n) : snapshot
     );
+    if (i18n) {
+      logical.set(page.versionKey, snapshot);
+    }
+  }
+  for (const [route, snapshot] of logical) {
+    if (!rewrites.has(route)) {
+      rewrites.set(route, snapshot);
+    }
   }
   return rewrites;
 };
 
+/**
+ * The snapshot link a root-absolute path rewrites to, or undefined when the
+ * snapshot has no copy of its page. A path written with the base path by hand
+ * (`/docs/guides/x` under `basePath: "/docs"`) names the same page as
+ * `/guides/x` — rendering leaves an already-based link alone (see
+ * `withBasePath`) — so it is looked up without the base and keeps it.
+ */
+const snapshotTarget = (
+  path: string,
+  rewrites: Map<string, string>,
+  basePath: string
+): string | undefined => {
+  const based =
+    basePath !== "" && (path === basePath || path.startsWith(`${basePath}/`));
+  if (!based) {
+    return rewrites.get(path);
+  }
+  const replacement = rewrites.get(stripBasePath(basePath, path));
+  return replacement === undefined
+    ? undefined
+    : mountBasePath(basePath, replacement);
+};
+
 /** Rewrite one line's root-absolute internal links via the rewrite table. */
-const rewriteLine = (line: string, rewrites: Map<string, string>): string => {
+const rewriteLine = (
+  line: string,
+  rewrites: Map<string, string>,
+  basePath: string
+): string => {
   const masked = line.replaceAll(INLINE_CODE, (span) =>
     " ".repeat(span.length)
   );
@@ -105,7 +151,7 @@ const rewriteLine = (line: string, rewrites: Map<string, string>): string => {
     const path = hash === -1 ? target : target.slice(0, hash);
     const suffix = hash === -1 ? "" : target.slice(hash);
     const bare = path !== "/" && path.endsWith("/") ? path.slice(0, -1) : path;
-    const replacement = rewrites.get(bare);
+    const replacement = snapshotTarget(bare, rewrites, basePath);
     if (replacement === undefined) {
       continue;
     }
@@ -127,10 +173,12 @@ export interface SnapshotRewrite {
  * Rewrite a copied page's root-absolute internal links to their snapshot
  * equivalents, skipping fenced and inline code. Relative links need no
  * rewriting — the whole tree copies together, so they stay self-contained.
+ * `basePath` is the site's, for links that spell it out by hand.
  */
 export const rewriteSnapshotLinks = (
   source: string,
-  rewrites: Map<string, string>
+  rewrites: Map<string, string>,
+  basePath = ""
 ): SnapshotRewrite => {
   let fence: FenceState = null;
   let count = 0;
@@ -141,7 +189,7 @@ export const rewriteSnapshotLinks = (
     if (inFence) {
       return line;
     }
-    const rewrittenLine = rewriteLine(line, rewrites);
+    const rewrittenLine = rewriteLine(line, rewrites, basePath);
     if (rewrittenLine !== line) {
       count += 1;
     }
@@ -401,7 +449,11 @@ export const cutVersion = async (
           return;
         }
         const source = await readFile(abs, "utf-8");
-        const { text, count } = rewriteSnapshotLinks(source, rewrites);
+        const { text, count } = rewriteSnapshotLinks(
+          source,
+          rewrites,
+          project.config.basePath
+        );
         if (count > 0) {
           await writeTextAtomic(abs, text);
           rewritten.push({ count, file: relative(dir, abs) });

package/src/core/versions.ts

@@ -150,9 +150,12 @@ export const versionsDiagnostics = (
   for (const page of pages) {
     // The version-looking folder is the first segment of the source-local ref
     // (e.g. `v1.0/guide.md`), not the namespaced id (`filesystem:v1.0/guide.md`).
-    const [first] = page.source.ref.split("/");
+    // Only a folder can be a snapshot: a root file like `v3-migration.md` has
+    // no further segments.
+    const [first, ...rest] = page.source.ref.split("/");
     if (
       first &&
+      rest.length > 0 &&
       !seen.has(first) &&
       VERSION_LIKE.test(first) &&
       !configured.has(first)

package/src/deploy/adapters/node.ts

@@ -7,8 +7,11 @@ export const NODE_ADAPTER_PACKAGE = "@astrojs/node";
 
 /**
  * Options for {@link node}: `output`, `site`, and `base`, plus any option of
- * `@astrojs/node` forwarded verbatim (`mode`, `host`, `port`, …). Blume
- * defaults `mode` to `"standalone"`; an option you pass wins.
+ * `@astrojs/node` forwarded verbatim (`mode`, `staticHeaders`, …). Blume
+ * defaults `mode` to `"standalone"`; an option you pass wins. `host` and
+ * `port` are forwarded too, but `@astrojs/node` replaces both with Astro's
+ * own server settings, so the standalone server listens on `localhost:4321`
+ * unless the `HOST` and `PORT` environment variables are set when it starts.
  */
 export type NodeOptions = DeployOptions;
 

package/src/deploy/adapters/registry.ts

@@ -7,6 +7,7 @@ import { netlify, netlifyAdapterSchema } from "./netlify.ts";
 import type { NetlifyAdapter } from "./netlify.ts";
 import { node, nodeAdapterSchema } from "./node.ts";
 import type { NodeAdapter } from "./node.ts";
+import { siteUrlSchema } from "./types.ts";
 import type { DeployOutput, StaticDeployment } from "./types.ts";
 import { vercel, vercelAdapterSchema } from "./vercel.ts";
 import type { VercelAdapter } from "./vercel.ts";
@@ -56,7 +57,7 @@ const staticDeploymentSchema = z.strictObject(
   {
     base: z.string().optional(),
     kind: z.literal("static").optional(),
-    site: z.url().optional(),
+    site: siteUrlSchema.optional(),
   },
   {
     error: (issue) => (issue.code === "unrecognized_keys" ? HINT : undefined),

package/src/deploy/adapters/types.ts

@@ -59,12 +59,24 @@ export interface StaticDeployment {
   site?: string;
 }
 
+/**
+ * `deployment.site`: an absolute http(s) URL, which always has a host. A bare
+ * `z.url()` takes any scheme, so `localhost:4321` (scheme `localhost:`),
+ * `mailto:`, and `javascript:` all passed and became the prefix of every
+ * sitemap entry and canonical link.
+ */
+export const siteUrlSchema = z.url({
+  error:
+    'Use an absolute http(s) URL with a host, like "https://docs.example.com" or "http://localhost:4321".',
+  protocol: /^https?$/u,
+});
+
 /** The named options' schema; every host adapter extends it with `z.json()` passthrough. */
 export const deployOptionsSchema = z
   .object({
     base: z.string().optional(),
     output: z.enum(["static", "server"]).optional(),
-    site: z.url().optional(),
+    site: siteUrlSchema.optional(),
   })
   .catchall(z.json());
 

package/src/deploy/artifacts.ts

@@ -4,6 +4,7 @@ import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "pathe";
 
 import { buildAgentReadability } from "../ai/agent-readability.ts";
+import { advertisedConfig, servesMcp } from "../ai/agent-surface.ts";
 import {
   AI_CATALOG_PATH,
   ARD_MANIFEST_PATH,
@@ -15,6 +16,7 @@ import { buildLlmsFiles } from "../ai/llms.ts";
 import { markdownRoutePaths } from "../ai/markdown.ts";
 import {
   AGENT_SKILLS_DIR,
+  AGENT_SKILLS_INDEX_PATH,
   buildSkillsIndex,
   collectSkills,
 } from "../ai/skills.ts";
@@ -23,6 +25,8 @@ import {
   buildSignaturesDirectory,
   SIGNATURES_DIRECTORY_PATH,
 } from "../ai/web-bot-auth.ts";
+import { normalizeBasePath } from "../core/base-path.ts";
+import { discoverPagesSync } from "../core/custom-pages.ts";
 import type { BlumeProject } from "../core/project-graph.ts";
 import type { ResolvedConfig } from "../core/schema.ts";
 import { buildSearchIndex } from "../search/build.ts";
@@ -48,10 +52,12 @@ import { buildSitemapFiles, describeSitemapFiles } from "./sitemap.ts";
  * Written from the integration's `astro:build:done` hook — Astro's channel
  * for exactly this kind of post-build work — into the directory Astro
  * reports as the client output (`dist/`, or `dist/client` for a server
- * build). The Vercel adapter copies that directory into its Build Output
- * static tree in a later hook, so the artifacts ride along; every other
- * adapter serves it directly. Running inside the hook rather than after
- * `astro build` returns means an ejected project keeps producing them.
+ * build, or `dist/client/<base>/` on Cloudflare, whose `_headers` goes to
+ * the root the platform serves above it). The Vercel adapter copies that
+ * directory into its Build Output static tree in a later hook, so the
+ * artifacts ride along; every other adapter serves it directly. Running
+ * inside the hook rather than after `astro build` returns means an ejected
+ * project keeps producing them.
  *
  * Every file yields to one the user ships in `public/` (Astro copied it into
  * the output before this runs).
@@ -85,7 +91,7 @@ const emitRedirectFiles = async (
     return;
   }
   const platform = deployPlatform(config.deployment);
-  const redirects = platformRedirects(config);
+  const redirects = platformRedirects(project);
   const vercelHeaders = platform.redirectFiles.includes(VERCEL_JSON_FILE)
     ? buildVercelHeaders(
         config,
@@ -124,6 +130,24 @@ const emitRedirectFiles = async (
   logger.info(`Emitted redirect files for ${redirects.length} redirect(s)`);
 };
 
+/**
+ * The root of the static assets the platform serves, where it reads
+ * `_headers`: `distDir` itself, except on a server build whose adapter moved
+ * the client output under `deployment.base` (`@astrojs/cloudflare` hands
+ * `astro:build:done` `dist/client/<base>/` but serves `dist/client`). A file
+ * left in `distDir` there would never be read, and would be served publicly
+ * at `<base>/_headers`.
+ */
+const assetsRoot = (config: ResolvedConfig, distDir: string): string => {
+  const base = normalizeBasePath(config.deployment.options.base);
+  const nested =
+    config.deployment.options.output === "server" &&
+    deployPlatform(config.deployment).serverClientUnderBase;
+  // One `..` per base segment climbs back out of `dist/client/<base>/`.
+  const depth = base.split("/").length - 1;
+  return nested && base ? join(distDir, "../".repeat(depth)) : distDir;
+};
+
 /**
  * Emit a `_headers` file so Netlify / Cloudflare serve the raw AI-ready
  * endpoints (`*.md`, `*.mdx`, `*.txt`) with an explicit `charset=utf-8`. Without
@@ -176,7 +200,7 @@ export const emitHeaderFiles = async (
   // An adapter may have written its own rules here already (Cloudflare adds an
   // immutable Cache-Control for /_astro/*). Keep them and append ours: both
   // sets are wanted, and `_headers` has no merge semantics beyond order.
-  const target = join(distDir, "_headers");
+  const target = join(assetsRoot(config, distDir), "_headers");
   const existing = existsSync(target) ? await readFile(target, "utf-8") : "";
   await writeFile(
     target,
@@ -367,9 +391,26 @@ export const publishBuildArtifacts = async (
   });
 
   // Collected once: llms.txt lists the skills the build publishes below.
+  const userSkillsIndex = existsSync(
+    join(distDir, AGENT_SKILLS_INDEX_PATH.slice(1))
+  );
   const skills = await collectConfiguredSkills(project, distDir, logger);
+  // The discovery documents advertise what this build serves: no MCP server
+  // when a page took its route, no skills index when nothing was published.
+  const advertised: BlumeProject = {
+    ...project,
+    config: advertisedConfig(project.config, {
+      mcp: servesMcp(
+        project,
+        project.context.pagesRoot
+          ? discoverPagesSync(project.context.pagesRoot)
+          : []
+      ),
+      skills: skills.length > 0 || userSkillsIndex,
+    }),
+  };
   if (project.config.agents.llmsTxt.enabled) {
-    await publishLlmsFiles(project, distDir, skills, logger);
+    await publishLlmsFiles(advertised, distDir, skills, logger);
   }
 
   const sitemapFiles = buildSitemapFiles(project);
@@ -388,7 +429,7 @@ export const publishBuildArtifacts = async (
     logger.info("Generated robots.txt");
   }
 
-  const agentReadability = buildAgentReadability(project);
+  const agentReadability = buildAgentReadability(advertised);
   if (
     agentReadability &&
     !existsSync(join(distDir, "agent-readability.json"))
@@ -401,9 +442,9 @@ export const publishBuildArtifacts = async (
     logger.info("Generated agent-readability.json");
   }
 
-  await emitWellKnownFiles(project.config, distDir, skills, logger);
+  await emitWellKnownFiles(advertised.config, distDir, skills, logger);
   await emitAgentSkills(project, distDir, skills, logger);
 
-  await emitRedirectFiles(project, distDir, logger);
-  await emitHeaderFiles(project, distDir, logger);
+  await emitRedirectFiles(advertised, distDir, logger);
+  await emitHeaderFiles(advertised, distDir, logger);
 };