blume 1.3.0 → 1.3.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # blume
 
+## 1.3.1
+
+### Patch Changes
+
+- 4d7dc87: Negotiate `Accept: text/markdown` on the homepage even when it's a landing page. A user-authored home page has no Markdown source, so agent requests for a markdown homepage previously fell through to HTML; the homepage's mirror now falls back to the `llms.txt` index — the machine-readable map of the site — served at `/index.md` and wired into the dev server, the Vercel routing config, and the homepage `Link` header's `rel="alternate"` entry.
+- ff31ab5: Remove a polynomial-backtracking regex from the font-name slugifier's dash trim
+- 02eb6c7: Fix the homepage `Link` header and `Vary: Accept` never being sent on Vercel deploys. The injected header routes sat after `handle: "filesystem"` in the Build Output config — the miss phase, which prerendered static responses never reach — so agent-readiness checkers saw no `Link` header on `GET /`. Both header routes now ride in the main phase, ahead of static-file matching.
+- de62812: Stamp an `x-markdown-tokens` header (estimated token count, ~4 characters per token) on Markdown responses, following the Cloudflare Markdown for Agents convention: the raw-Markdown endpoints send it on dev and server-rendered responses, and the Vercel routing config carries it on the negotiated homepage.
+
 ## 1.3.0
 
 ### Minor Changes

package/dist/cli/index.js

@@ -3522,7 +3522,7 @@ var GOOGLE_FONTS = {
 var FONT_SLUGS = Object.keys(GOOGLE_FONTS);
 var isFontSlug = (value) => Object.hasOwn(GOOGLE_FONTS, value);
 var DEFAULT_REMOTE_WEIGHTS = [400, 500, 600, 700];
-var slugifyFontName = (name) => name.toLowerCase().replaceAll(/[^a-z0-9]+/gu, "-").replaceAll(/^-+|-+$/gu, "");
+var slugifyFontName = (name) => name.toLowerCase().replaceAll(/[^a-z0-9]+/gu, "-").replaceAll(/^-|-$/gu, "");
 var fontVar = (slug) => `--blume-ff-${slug}`;
 var SLOTS = ["display", "body", "mono"];
 var slotCategory = (slot) => slot === "mono" ? "mono" : "sans";
@@ -4269,8 +4269,13 @@ export function getStaticPaths() {
 export function GET({ props }: { props: { route: string } }) {
   const entries = raw as Record<string, { md?: string; mdx?: string }>;
   const entry = entries[props.route];
-  return new Response(entry ? ${kind === "md" ? '(entry.md ?? entry.mdx ?? "")' : '(entry.mdx ?? "")'} : "", {
-    headers: { "Content-Type": "text/markdown; charset=utf-8" },
+  const body = entry ? ${kind === "md" ? '(entry.md ?? entry.mdx ?? "")' : '(entry.mdx ?? "")'} : "";
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/markdown; charset=utf-8",
+      // ~4 characters per token; keep in sync with markdownTokenCount.
+      "x-markdown-tokens": String(Math.ceil(body.length / 4)),
+    },
   });
 }
 `;
@@ -12593,7 +12598,7 @@ var indexedNavigations = (project) => {
   }
   return [{ nav: project.graph.navigation }];
 };
-var buildIndex = (project) => {
+var buildLlmsIndex = (project) => {
   const { config } = project;
   const { site } = config.deployment;
   const base = normalizeBasePath(config.deployment.base);
@@ -12704,12 +12709,55 @@ ${sections.join(`
 };
 var buildLlmsFiles = async (project) => ({
   full: await buildFull(project),
-  index: buildIndex(project)
+  index: buildLlmsIndex(project)
 });
 
+// src/ai/markdown.ts
+import { readFile as readFile10 } from "node:fs/promises";
+var agentMarkdown = (entry) => entry.md ?? entry.mdx;
+var markdownTokenCount = (text) => Math.ceil(text.length / 4);
+var buildRawMarkdown = async (project) => {
+  const pageById = new Map(project.graph.pages.map((page) => [page.id, page]));
+  const components = {
+    ...exampleComponentSerializers(project.examples ?? {}),
+    ...project.config.ai.markdownComponents
+  };
+  const readRoute = async (route) => {
+    const page = pageById.get(route.id);
+    if (page) {
+      return await readEntryText(project, page);
+    }
+    return route.sourcePath ? await readFile10(route.sourcePath, "utf-8") : "";
+  };
+  const entries = await Promise.all(project.manifest.routes.map(async (route) => {
+    let text = await readRoute(route);
+    if (route.sourcePath) {
+      text = rewriteRelativeImages({
+        deployBase: project.config.deployment.base,
+        projectRoot: project.context.root,
+        source: text,
+        sourcePath: route.sourcePath
+      });
+    }
+    const source = applyAgentVisibility(text);
+    const md = downlevelComponents(source, components, frontmatter_default(source).data);
+    const entry = md === source ? { mdx: source } : { md, mdx: source };
+    return [route.path, entry];
+  }));
+  const map = Object.fromEntries(entries);
+  if (!map["/"]) {
+    map["/"] = { mdx: buildLlmsIndex(project) };
+  }
+  return map;
+};
+var markdownRoutePaths = (project) => {
+  const paths = project.manifest.routes.map((route) => route.path);
+  return paths.includes("/") ? paths : [...paths, "/"];
+};
+
 // src/ai/skills.ts
 import { createHash as createHash2 } from "node:crypto";
-import { readdir, readFile as readFile10, stat as stat2 } from "node:fs/promises";
+import { readdir, readFile as readFile11, stat as stat2 } from "node:fs/promises";
 import { join as join18 } from "pathe";
 
 // src/ai/tar.ts
@@ -12794,7 +12842,7 @@ var collectEntries = async (dir, prefix = "") => {
     if (item.isDirectory()) {
       entries.push(...await collectEntries(path, relative12));
     } else if (item.isFile()) {
-      const [content, info] = await Promise.all([readFile10(path), stat2(path)]);
+      const [content, info] = await Promise.all([readFile11(path), stat2(path)]);
       entries.push({
         content: new Uint8Array(content),
         executable: (info.mode & 64) !== 0,
@@ -12895,12 +12943,12 @@ var buildSignaturesDirectory = (config) => {
 
 // src/core/gitignore.ts
 import { existsSync as existsSync10 } from "node:fs";
-import { readFile as readFile11, writeFile as writeFile6 } from "node:fs/promises";
+import { readFile as readFile12, writeFile as writeFile6 } from "node:fs/promises";
 import { join as join19 } from "pathe";
 var gitignoreKey = (line) => line.trim().replace(/\/+$/u, "");
 var ensureGitignore = async (root, entries) => {
   const path = join19(root, ".gitignore");
-  const existing = existsSync10(path) ? await readFile11(path, "utf-8") : "";
+  const existing = existsSync10(path) ? await readFile12(path, "utf-8") : "";
   const present = new Set(existing.split(`
 `).flatMap((line) => {
     const key = gitignoreKey(line);
@@ -13167,7 +13215,7 @@ var chunkPatterns = (patterns) => {
   }
   return chunks;
 };
-var buildNegotiationRoutes = (routePaths) => {
+var buildNegotiationRoutes = (routePaths, homeTokens) => {
   const home = routePaths.includes("/");
   const rest = routePaths.filter((path) => path !== "/").map((path) => routePattern(path));
   const chunks = chunkPatterns(rest);
@@ -13175,7 +13223,7 @@ var buildNegotiationRoutes = (routePaths) => {
     {
       dest: "/index.md",
       has: ACCEPT_MARKDOWN_CONDITION,
-      headers: VARY_ACCEPT,
+      headers: homeTokens === undefined ? VARY_ACCEPT : { ...VARY_ACCEPT, "x-markdown-tokens": String(homeTokens) },
       src: "^/$"
     }
   ] : [];
@@ -13197,7 +13245,7 @@ var buildNegotiationRoutes = (routePaths) => {
 };
 var HOME_SRC = "^/$";
 var isNegotiationRoute = (route) => route.has?.some((condition) => condition.value === ACCEPT_MARKDOWN_HEADER_VALUE) === true || route.continue === true && route.headers?.vary === "Accept" && typeof route.src === "string" && Object.keys(route).length === 3 || route.continue === true && typeof route.headers?.link === "string" && route.src === HOME_SRC && Object.keys(route).length === 3;
-var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTypeOverrides) => {
+var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTypeOverrides, homeTokens) => {
   const overrideEntries = Object.entries(contentTypeOverrides ?? {});
   if (routePaths.length === 0 && !homeLinkHeader && overrideEntries.length === 0) {
     return null;
@@ -13219,7 +13267,7 @@ var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTy
   if (filesystemIndex === -1) {
     return null;
   }
-  const { headerRoutes, rewriteRoutes } = buildNegotiationRoutes(routePaths);
+  const { headerRoutes, rewriteRoutes } = buildNegotiationRoutes(routePaths, homeTokens);
   if (homeLinkHeader) {
     headerRoutes.push({
       continue: true,
@@ -13227,8 +13275,7 @@ var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTy
       src: HOME_SRC
     });
   }
-  routes.splice(filesystemIndex + 1, 0, ...headerRoutes);
-  routes.splice(filesystemIndex, 0, ...rewriteRoutes);
+  routes.splice(filesystemIndex, 0, ...headerRoutes, ...rewriteRoutes);
   config.routes = routes;
   return `${JSON.stringify(config, null, "\t")}
 `;
@@ -13622,40 +13669,6 @@ var buildAskData = async (project) => {
   };
 };
 
-// src/ai/markdown.ts
-import { readFile as readFile12 } from "node:fs/promises";
-var agentMarkdown = (entry) => entry.md ?? entry.mdx;
-var buildRawMarkdown = async (project) => {
-  const pageById = new Map(project.graph.pages.map((page) => [page.id, page]));
-  const components = {
-    ...exampleComponentSerializers(project.examples ?? {}),
-    ...project.config.ai.markdownComponents
-  };
-  const readRoute = async (route) => {
-    const page = pageById.get(route.id);
-    if (page) {
-      return await readEntryText(project, page);
-    }
-    return route.sourcePath ? await readFile12(route.sourcePath, "utf-8") : "";
-  };
-  const entries = await Promise.all(project.manifest.routes.map(async (route) => {
-    let text2 = await readRoute(route);
-    if (route.sourcePath) {
-      text2 = rewriteRelativeImages({
-        deployBase: project.config.deployment.base,
-        projectRoot: project.context.root,
-        source: text2,
-        sourcePath: route.sourcePath
-      });
-    }
-    const source = applyAgentVisibility(text2);
-    const md = downlevelComponents(source, components, frontmatter_default(source).data);
-    const entry = md === source ? { mdx: source } : { md, mdx: source };
-    return [route.path, entry];
-  }));
-  return Object.fromEntries(entries);
-};
-
 // src/ai/mcp/data.ts
 var buildMcpData = async (project) => {
   const { config, graph, manifest } = project;
@@ -16366,7 +16379,7 @@ var generateRuntime = async (project) => {
         aliases: resolveTsconfigAliases(context.root),
         askPath,
         config,
-        contentRoutes: project.manifest.routes.map((route) => route.path),
+        contentRoutes: markdownRoutePaths(project),
         contentWatchesRuntimeDir: contentWatchesRuntimeDir(hasFilesystemSource, docsCollection.base, context),
         context,
         dataPath,
@@ -16700,7 +16713,7 @@ var emitHeaderFiles = async (project, distDir) => {
   if (config.deployment.output !== "static" || existsSync18(join30(distDir, "_headers"))) {
     return;
   }
-  await writeFile8(join30(distDir, "_headers"), buildNetlifyHeaders(config, buildHomeLinkHeader(config, project.manifest.routes.map((route) => route.path))), "utf-8");
+  await writeFile8(join30(distDir, "_headers"), buildNetlifyHeaders(config, buildHomeLinkHeader(config, markdownRoutePaths(project))), "utf-8");
   logger.success("Emitted _headers (UTF-8 Content-Type + homepage Link header)");
 };
 var emitAgentSkills = async (project, distDir) => {
@@ -16756,7 +16769,8 @@ var emitWellKnownFiles = async (config, distDir) => {
     logger.success(`Generated ${file.path.slice(1)} (${file.label})`);
   }
 };
-var emitVercelNegotiation = async (config, routePaths, root) => {
+var emitVercelNegotiation = async (project, routePaths, root) => {
+  const { config } = project;
   const configPath = join30(root, ".vercel", "output", "config.json");
   if (!existsSync18(configPath)) {
     return;
@@ -16765,7 +16779,9 @@ var emitVercelNegotiation = async (config, routePaths, root) => {
     ...hasApiCatalog(config) ? { [API_CATALOG_PATH.slice(1)]: API_CATALOG_TYPE } : {},
     ...config.ai.webBotAuth.keys.length > 0 ? { [SIGNATURES_DIRECTORY_PATH.slice(1)]: SIGNATURES_DIRECTORY_TYPE } : {}
   };
-  const injected = injectNegotiationRoutes(await readFile17(configPath, "utf-8"), routePaths, buildHomeLinkHeader(config, routePaths), overrides);
+  const rawMarkdown = await buildRawMarkdown(project);
+  const home = rawMarkdown["/"];
+  const injected = injectNegotiationRoutes(await readFile17(configPath, "utf-8"), routePaths, buildHomeLinkHeader(config, routePaths), overrides, home ? markdownTokenCount(agentMarkdown(home)) : undefined);
   if (injected === null) {
     logger.warn("Could not wire Accept: text/markdown negotiation into .vercel/output/config.json — raw Markdown stays available at the .md URLs.");
     return;
@@ -17026,7 +17042,7 @@ var buildCommand = defineCommand3({
       logger.success(`Surfaced ${adapter} output to ${surfaced.to}`);
     }
     if (project.config.deployment.output === "server" && adapter === "vercel") {
-      await emitVercelNegotiation(project.config, project.manifest.routes.map((route) => route.path), root);
+      await emitVercelNegotiation(project, markdownRoutePaths(project), root);
     }
     await publishBuildArtifacts(project, deployStaticDir(project.config, project.context), args);
   }
@@ -19873,5 +19889,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=CCE85D85BA5F467464756E2164756E21
+//# debugId=DE086E5CDF1627AA64756E2164756E21
 //# sourceMappingURL=index.js.map