nuxt-ai-ready 2.4.1 → 2.5.1

package/README.md

@@ -3,6 +3,13 @@
 [![npm version][npm-version-src]][npm-version-href]
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
 [![Nuxt][nuxt-src]][nuxt-href]
+<a href="https://skilld.dev/gh/harlan-zw/nuxt-ai-ready">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://skilld.dev/b/harlan-zw/nuxt-ai-ready?theme=dark">
+    <source media="(prefers-color-scheme: light)" srcset="https://skilld.dev/b/harlan-zw/nuxt-ai-ready?theme=light">
+    <img alt="Skill repository on skilld.dev" src="https://skilld.dev/b/harlan-zw/nuxt-ai-ready?theme=light">
+  </picture>
+</a>
 
 > Best practice AI & LLM discoverability for Nuxt sites. Score 100 on [`npx @vercel/agent-readability audit <URL>`](https://github.com/vercel-labs/agent-readability).
 
@@ -38,10 +45,7 @@ npx nuxi@latest module add nuxt-ai-ready
 ```
 
 > [!TIP]
-> Generate an Agent Skill for this package using [skilld](https://github.com/harlan-zw/skilld):
-> ```bash
-> npx skilld add nuxt-ai-ready
-> ```
+> Using an AI agent? Get the nuxt-ai-ready Skill on [skilld.dev/gh/harlan-zw/nuxt-ai-ready](https://skilld.dev/gh/harlan-zw/nuxt-ai-ready).
 
 💡 Made your site AI-ready? Preview how a page converts to LLM-readable markdown with the free [HTML→Markdown tool](https://nuxtseo.com/tools/html-to-markdown), or track how AI engines index, rank and cite your site with [Nuxt SEO Pro](https://nuxtseo.com/pro).
 

package/dist/chunks/agent-skills.mjs

@@ -2,7 +2,7 @@ import { createHash } from 'node:crypto';
 import { realpath, readFile, readdir } from 'node:fs/promises';
 import { resolve, isAbsolute, join, relative, sep } from 'node:path';
 import { parseDocument } from 'yaml';
-import { A as AGENT_SKILLS_SCHEMA } from '../shared/nuxt-ai-ready.CxJE2WLA.mjs';
+import { A as AGENT_SKILLS_SCHEMA } from '../shared/nuxt-ai-ready.CLSWou20.mjs';
 import 'node:module';
 import '@nuxt/kit';
 import 'defu';

package/dist/chunks/prerender.mjs

@@ -5,7 +5,7 @@ import { colorize } from 'consola/utils';
 import { resolveLocaleFromRoute } from 'nuxtseo-shared/i18n-runtime';
 import { collectSitemap } from 'sitemapd/parse';
 import { withLeadingSlash, joinURL, withBase } from 'ufo';
-import { l as logger, s as supportsNativeNodeSqlite, M as MARKDOWN_LINK_AVAILABILITY_FILE } from '../shared/nuxt-ai-ready.CxJE2WLA.mjs';
+import { l as logger, s as supportsNativeNodeSqlite, M as MARKDOWN_LINK_AVAILABILITY_FILE } from '../shared/nuxt-ai-ready.CLSWou20.mjs';
 import { normalizePagePath, toMarkdownPath } from '../../dist/runtime/markdown-path.js';
 import { toDeployedRoute, toLogicalRoute } from '../../dist/runtime/route-path.js';
 import { initSchema, computeContentHash, insertPage, queryAllPages, exportDbDump } from '../../dist/runtime/server/db/shared.js';

package/dist/module.json

@@ -4,7 +4,7 @@
     "nuxt": ">=4.0.0"
   },
   "configKey": "aiReady",
-  "version": "2.4.1",
+  "version": "2.5.1",
   "builder": {
     "@nuxt/module-builder": "1.0.3",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -7,7 +7,7 @@ import 'defu';
 import 'nuxt-site-config/kit';
 import 'nuxtseo-shared/kit';
 import 'pkg-types';
-export { m as default } from './shared/nuxt-ai-ready.CxJE2WLA.mjs';
+export { m as default } from './shared/nuxt-ai-ready.CLSWou20.mjs';
 import '../dist/runtime/markdown-path.js';
 import '../dist/runtime/server/utils/sitemap-md.js';
 import '../dist/runtime/server/utils/discovery-response.js';

package/dist/runtime/app/plugins/md-hints.prerender.js

@@ -1,6 +1,5 @@
-import { isPathFile } from "nuxt-site-config/urls";
 import { defineNuxtPlugin, prerenderRoutes } from "nuxt/app";
-import { toMarkdownPath } from "../../markdown-path.js";
+import { markdownAlternatePath } from "../../markdown-path.js";
 export default defineNuxtPlugin({
   setup(nuxtApp) {
     if (!import.meta.prerender) {
@@ -8,10 +7,11 @@ export default defineNuxtPlugin({
     }
     nuxtApp.hooks.hook("app:rendered", (ctx) => {
       const url = ctx.ssrContext?.url || "";
-      if (isPathFile(url) || ctx.ssrContext?.error || ctx.ssrContext?.noSSR) {
+      const markdownPath = markdownAlternatePath(url);
+      if (!markdownPath || ctx.ssrContext?.error || ctx.ssrContext?.noSSR) {
         return;
       }
-      prerenderRoutes(toMarkdownPath(url));
+      prerenderRoutes(markdownPath);
     });
   }
 });

package/dist/runtime/llms-txt-utils.js

@@ -4,16 +4,12 @@ import { useRuntimeConfig } from "#nuxtseo/nitro";
 import { getSiteConfig } from "#site-config/server/composables/getSiteConfig";
 import { withSiteTrailingSlash, withSiteUrl } from "#site-config/server/composables/utils";
 import { formatLlmsTxtPageLink, normalizeLlmsTxtConfig } from "./llms-txt-format.js";
-import { isReservedPath, toMarkdownPath } from "./markdown-path.js";
+import { hasMarkdownTwin, toMarkdownPath } from "./markdown-path.js";
 import { normalizePersistedRoute, toDeployedRoute, toLogicalRoute } from "./route-path.js";
 import { queryPages } from "./server/db/queries.js";
 import { logger } from "./server/logger.js";
 import { fetchSitemapUrls } from "./server/utils/sitemap.js";
 export { normalizeLlmsTxtConfig };
-function hasRuntimeMarkdownHandler(pathname) {
-  const lastSegment = pathname.split("/").pop() || "";
-  return !isReservedPath(pathname) && !lastSegment.includes(".");
-}
 async function findMarkdownLinkAvailability() {
   if (!import.meta.prerender) {
     return {
@@ -205,7 +201,7 @@ Canonical Origin: ${canonicalSiteUrl}`);
     resolvePageHref = (pathname) => {
       const deployedPathname = resolvePath(pathname);
       const markdownPath = resolvePath(toMarkdownPath(pathname));
-      if (markdownLinkAvailability.paths.has(decodePath(markdownPath)) || markdownLinkAvailability.runtimeMarkdownAvailable && hasRuntimeMarkdownHandler(pathname)) {
+      if (markdownLinkAvailability.paths.has(decodePath(markdownPath)) || markdownLinkAvailability.runtimeMarkdownAvailable && hasMarkdownTwin(pathname)) {
         return markdownPath;
       }
       return deployedPathname;

package/dist/runtime/markdown-path.d.ts

@@ -3,9 +3,13 @@ export declare function isReservedPath(path: string): boolean;
 export declare function normalizePagePath(path: string): string;
 export declare function toMarkdownPath(path: string): string;
 /**
- * The `.md` sibling a page may advertise, or null when it has none.
+ * True when a path names a page with a `.md` twin: outside the reserved
+ * namespaces, and not a file such as `/feed.xml`. A dot alone does not make a
+ * file, so `/v1.2` is a page.
  *
- * Advertising and serving read the same predicate here, so a page cannot link
- * a representation the markdown handler declines.
+ * Prerendering and every advertisement read this one predicate, so a page
+ * cannot link a representation the build or the markdown handler lacks.
  */
+export declare function hasMarkdownTwin(path: string): boolean;
+/** The `.md` sibling a page may advertise, or null when it has none. */
 export declare function markdownAlternatePath(path: string): string | null;

package/dist/runtime/markdown-path.js

@@ -1,4 +1,5 @@
 const RE_TRAILING_SLASHES = /\/+$/;
+const RE_FILE_EXTENSION = /\.[a-z][a-z\d]*$/i;
 const RE_RESERVED_PATH = /^\/(?:api(?:\/|$)|_|@(?:id|fs|vite|react-refresh)(?:\/|$))/;
 export function isReservedPath(path) {
   return RE_RESERVED_PATH.test(path);
@@ -12,11 +13,10 @@ export function toMarkdownPath(path) {
     return "/index.md";
   return `${normalizedPath}.md`;
 }
-export function markdownAlternatePath(path) {
-  if (isReservedPath(path))
-    return null;
+export function hasMarkdownTwin(path) {
   const lastSegment = normalizePagePath(path).split("/").pop() || "";
-  if (lastSegment.includes("."))
-    return null;
-  return toMarkdownPath(path);
+  return !isReservedPath(path) && !RE_FILE_EXTENSION.test(lastSegment);
+}
+export function markdownAlternatePath(path) {
+  return hasMarkdownTwin(path) ? toMarkdownPath(path) : null;
 }

package/dist/runtime/server/db/queries.js

@@ -1,5 +1,7 @@
 import { randomUUID } from "uncrypto";
 import { useEvent, useRuntimeConfig } from "#nuxtseo/nitro";
+import { logger } from "../logger.js";
+import { checkAndHandleStale } from "../utils/checkStale.js";
 import { parseSitemapCrawlState, serializeSitemapCrawlState } from "../utils/sitemap-crawl-state.js";
 import { initSchema } from "./drizzle/queries.js";
 import { useRawDb } from "./drizzle/raw.js";
@@ -15,15 +17,33 @@ function getEventFromContext(providedEvent) {
     return void 0;
   }
 }
-let devWarningShown = false;
+let devNoticeShown = false;
 let schemaInitializationState = { _tag: "Uninitialized" };
+let dumpSyncState = { _tag: "Pending" };
+function syncBuildDump(event) {
+  if (dumpSyncState._tag === "Synced")
+    return Promise.resolve();
+  if (dumpSyncState._tag === "Syncing")
+    return dumpSyncState.promise;
+  const promise = checkAndHandleStale(event).then(
+    () => {
+      dumpSyncState = { _tag: "Synced" };
+    },
+    (error) => {
+      dumpSyncState = { _tag: "Pending" };
+      throw error;
+    }
+  );
+  dumpSyncState = { _tag: "Syncing", promise };
+  return promise;
+}
 const RE_FTS_CHARS = /[*:^"()]/g;
 const RE_WHITESPACE = /\s+/;
 async function getDb(event) {
   if (import.meta.dev) {
-    if (!devWarningShown) {
-      console.warn("[nuxt-ai-ready] Page data unavailable in dev. Run `nuxi generate` for full metadata.");
-      devWarningShown = true;
+    if (!devNoticeShown) {
+      logger.info("Page data unavailable in dev. Run `nuxi generate` for full metadata.");
+      devNoticeShown = true;
     }
     return null;
   }
@@ -32,7 +52,8 @@ async function getDb(event) {
   }
   const resolvedEvent = getEventFromContext(event);
   const cfg = useRuntimeConfig(resolvedEvent);
-  if (cfg["nuxt-ai-ready"]?.database?._tag === "Disabled")
+  const database = cfg["nuxt-ai-ready"]?.database?._tag;
+  if (database === "Disabled")
     return null;
   const db = await useRawDb(resolvedEvent);
   if (schemaInitializationState._tag === "Uninitialized") {
@@ -46,6 +67,8 @@ async function getDb(event) {
   }
   if (schemaInitializationState._tag === "Initializing")
     await schemaInitializationState.promise;
+  if (database === "Enabled")
+    await syncBuildDump(resolvedEvent);
   return db;
 }
 async function getPrerenderDb() {

package/dist/runtime/server/middleware/markdown.js

@@ -165,7 +165,7 @@ ${contentPage.markdown}`);
     canonicalUrl,
     config.mdreamOptions,
     {
-      hooks: { route: path, event },
+      hooks: { route: path, event, isPrerender: false },
       additionalFrontmatter
     }
   );

package/dist/runtime/server/middleware/markdown.prerender.js

@@ -104,6 +104,7 @@ ${contentPage.markdown}`;
     runtimeConfig.mdreamOptions,
     {
       extractUpdatedAt: true,
+      hooks: { route: path, event, isPrerender: true },
       additionalFrontmatter: {
         canonical_url: canonicalUrl,
         ...lastUpdated && { last_updated: lastUpdated }

package/dist/runtime/server/utils/checkStale.js

@@ -10,9 +10,17 @@ import {
 import { decompressFromBase64, importDbDump } from "../db/shared.js";
 import { logger } from "../logger.js";
 import { fetchPublicAsset } from "./cloudflare.js";
+function parseBuildMeta(value) {
+  if (!value || typeof value !== "object")
+    return null;
+  const { buildId, pageCount, createdAt } = value;
+  if (typeof buildId !== "string" || !buildId || typeof pageCount !== "number")
+    return null;
+  return { buildId, pageCount, createdAt: typeof createdAt === "string" ? createdAt : "" };
+}
 async function fetchBuildMeta(event) {
   logger.debug("[stale-check] Fetching meta...");
-  return fetchPublicAsset(event, "/__ai-ready/pages.meta.json");
+  return parseBuildMeta(await fetchPublicAsset(event, "/__ai-ready/pages.meta.json"));
 }
 async function fetchDump(event) {
   logger.debug("[stale-check] Fetching dump...");
@@ -22,7 +30,10 @@ async function fetchDump(event) {
     return null;
   }
   logger.debug(`[stale-check] Decompressing dump (${(dumpData.length / 1024).toFixed(1)}kb)...`);
-  return decompressFromBase64(dumpData);
+  return decompressFromBase64(dumpData).catch((error) => {
+    logger.warn("[stale-check] Build dump is unreadable, skipping restore:", error);
+    return null;
+  });
 }
 async function getStoredBuildId(event) {
   return getInfoValue(event, "build_id");

package/dist/runtime/server/utils/cloudflare.js

@@ -1,3 +1,5 @@
+import { withBase } from "ufo";
+import { useRuntimeConfig } from "#nuxtseo/nitro";
 const FETCH_TIMEOUT = 5e3;
 function unavailablePublicAsset(_error) {
   return null;
@@ -29,7 +31,7 @@ export async function fetchPublicAsset(event, path, options) {
   }
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT);
-  return globalThis.$fetch(path, {
+  return globalThis.$fetch(withBase(path, useRuntimeConfig(event).app.baseURL), {
     baseURL: "/",
     signal: controller.signal,
     responseType

package/dist/runtime/server/utils/frontmatter.d.ts

@@ -12,4 +12,10 @@ interface FrontmatterFields {
 }
 export declare function buildFrontmatter(fields: FrontmatterFields): string;
 export declare function layerFrontmatter(fields: FrontmatterFields, markdown: string): string;
+/**
+ * Move mdream's `meta.description` to a root `description` field, the shape
+ * Content source pages and hand-built frontmatter already use. Other `meta`
+ * fields stay where mdream put them.
+ */
+export declare function hoistMetaDescription(markdown: string): string;
 export {};

package/dist/runtime/server/utils/frontmatter.js

@@ -1,4 +1,4 @@
-import { isMap, parseDocument } from "yaml";
+import { isMap, isScalar, parseDocument } from "yaml";
 function escapeYamlString(value) {
   return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
 }
@@ -43,3 +43,25 @@ ${document.toString({ lineWidth: 0 }).trimEnd()}
 
 ${body}`;
 }
+export function hoistMetaDescription(markdown) {
+  const match = markdown.match(FRONTMATTER_RE);
+  if (!match)
+    return markdown;
+  const document = parseDocument(match[1]);
+  const root = document.contents;
+  const meta = document.get("meta");
+  if (document.errors.length || !isMap(root) || !isMap(meta) || !meta.has("description"))
+    return markdown;
+  const description = meta.get("description", true);
+  meta.delete("description");
+  if (!meta.items.length)
+    document.delete("meta");
+  if (!document.has("description")) {
+    const titleIndex = root.items.findIndex((pair) => isScalar(pair.key) && pair.key.value === "title");
+    root.items.splice(titleIndex + 1, 0, document.createPair("description", description));
+  }
+  return `---
+${document.toString({ lineWidth: 0 }).trimEnd()}
+---
+${markdown.slice(match[0].length)}`;
+}

package/dist/runtime/server/utils/indexPage.js

@@ -19,7 +19,10 @@ export async function indexPage(route, html, options = {}, event) {
   const isError = html.includes("__NUXT_ERROR__") || html.includes("nuxt-error-page");
   const { siteUrl } = createUniversalContext(event);
   const fullUrl = siteUrl ? `${siteUrl}${route}` : route;
-  const result = await convertHtmlToMarkdown(html, fullUrl, config.mdreamOptions, { extractUpdatedAt: true });
+  const result = await convertHtmlToMarkdown(html, fullUrl, config.mdreamOptions, {
+    extractUpdatedAt: true,
+    hooks: { route, event, isPrerender: false }
+  });
   const headings = JSON.stringify(result.headings);
   const keywords = extractKeywords(result.textContent, result.metaKeywords);
   const contentHash = await computeContentHash(result.markdown);

package/dist/runtime/server/utils/sitemap-routes.js

@@ -1,8 +1,9 @@
+import { hasMarkdownTwin } from "../../markdown-path.js";
 export function mapSitemapRoutes(urls) {
   const routeToUrl = /* @__PURE__ */ new Map();
   for (const url of urls) {
     const route = url._path?.pathname ?? (url.loc.startsWith("/") ? url.loc.split("?")[0] ?? url.loc : new URL(url.loc).pathname);
-    if (!route.includes("."))
+    if (hasMarkdownTwin(route))
       routeToUrl.set(route, url);
   }
   return routeToUrl;

package/dist/runtime/server/utils.d.ts

@@ -4,15 +4,19 @@ export declare function extractLastUpdated(html: string): string | undefined;
 interface ConvertHtmlOptions {
     /** Extract updatedAt from meta tags */
     extractUpdatedAt?: boolean;
-    /** Call runtime hooks (ai-ready:mdreamConfig, ai-ready:page:markdown) */
-    hooks?: {
+    /**
+     * Context for the Nitro hooks (ai-ready:mdreamConfig, ai-ready:page:markdown).
+     * Every conversion runs them, so prerender, runtime and indexing agree.
+     */
+    hooks: {
         route: string;
-        event: H3Event;
+        event?: H3Event;
+        isPrerender: boolean;
     };
     /** Extra fields to inject at the root of mdream's emitted YAML frontmatter */
     additionalFrontmatter?: Record<string, string>;
 }
-export declare function convertHtmlToMarkdown(html: string, url: string, mdreamOptions: ModuleOptions['mdreamOptions'], opts?: ConvertHtmlOptions): Promise<{
+export declare function convertHtmlToMarkdown(html: string, url: string, mdreamOptions: ModuleOptions['mdreamOptions'], opts: ConvertHtmlOptions): Promise<{
     updatedAt?: string | undefined;
     markdown: string;
     title: string;

package/dist/runtime/server/utils.js

@@ -1,5 +1,6 @@
 import { htmlToMarkdown } from "mdream";
 import { useNitroApp } from "#nuxtseo/nitro";
+import { hoistMetaDescription } from "./utils/frontmatter.js";
 const RE_NBSP = /\u00A0/g;
 function normalizeWhitespace(text) {
   return text.replace(RE_NBSP, " ");
@@ -67,27 +68,22 @@ export function extractLastUpdated(html) {
   }
   return void 0;
 }
-export async function convertHtmlToMarkdown(html, url, mdreamOptions, opts = {}) {
+export async function convertHtmlToMarkdown(html, url, mdreamOptions, opts) {
   const meta = { title: "", description: "", metaKeywords: "", headings: [], textContent: [] };
   const options = buildMdreamOptions(url, mdreamOptions, meta, opts.extractUpdatedAt ?? false, opts.additionalFrontmatter ?? {});
-  let markdown;
-  if (opts.hooks) {
-    const nitroApp = useNitroApp();
-    await nitroApp.hooks.callHook("ai-ready:mdreamConfig", options);
-    const context = {
-      html,
-      markdown: htmlToMarkdown(html, options),
-      route: opts.hooks.route,
-      title: meta.title,
-      description: meta.description,
-      isPrerender: false,
-      event: opts.hooks.event
-    };
-    await nitroApp.hooks.callHook("ai-ready:page:markdown", context);
-    markdown = context.markdown;
-  } else {
-    markdown = htmlToMarkdown(html, options);
-  }
+  const nitroApp = useNitroApp();
+  await nitroApp.hooks.callHook("ai-ready:mdreamConfig", options);
+  const context = {
+    html,
+    markdown: hoistMetaDescription(htmlToMarkdown(html, options)),
+    route: opts.hooks.route,
+    title: meta.title,
+    description: meta.description,
+    isPrerender: opts.hooks.isPrerender,
+    event: opts.hooks.event
+  };
+  await nitroApp.hooks.callHook("ai-ready:page:markdown", context);
+  const markdown = context.markdown;
   return {
     markdown: normalizeWhitespace(markdown),
     title: normalizeWhitespace(meta.title),

package/dist/runtime/types.d.ts

@@ -406,8 +406,9 @@ export interface PageDocument {
 /**
  * Hook context for markdown processing (Nitro runtime hook)
  *
- * This hook is called during HTML→Markdown conversion in the runtime middleware.
- * You can modify the markdown content before it's returned to the client.
+ * This hook is called for every HTML→Markdown conversion: runtime `.md`
+ * requests, prerendering, and page indexing. Modify the markdown content
+ * before the module serves, writes, or stores it.
  *
  * @example Modify markdown content
  * nitroApp.hooks.hook('ai-ready:page:markdown', async (context) => {
@@ -438,8 +439,11 @@ export interface MarkdownContext {
     description: string;
     /** Whether this is during prerendering (true) or runtime (false) */
     isPrerender: boolean;
-    /** The H3 event object for accessing request/response */
-    event: H3Event;
+    /**
+     * The H3 event object for accessing request/response. Undefined when
+     * indexing runs outside a request, such as a scheduled task.
+     */
+    event?: H3Event;
 }
 /**
  * Markdown a site already holds for a route, supplied instead of converting the

package/dist/shared/{nuxt-ai-ready.CxJE2WLA.mjs → nuxt-ai-ready.CLSWou20.mjs}

@@ -2,13 +2,13 @@ import { createHash, randomBytes } from 'node:crypto';
 import { readFile, mkdir, writeFile, access } from 'node:fs/promises';
 import { createRequire } from 'node:module';
 import { dirname, basename, join } from 'node:path';
-import { hasNuxtModule, useNuxt, useLogger, addTypeTemplate, addTemplate, defineNuxtModule, createResolver, addServerImports, addServerPlugin, addServerHandler, extendRouteRules, addPlugin, addImports } from '@nuxt/kit';
+import { hasNuxtModule, useNuxt, useLogger, addTypeTemplate, addTemplate, defineNuxtModule, createResolver, addServerImports, addServerHandler, extendRouteRules, addServerPlugin, addPlugin, addImports } from '@nuxt/kit';
 import defu$1, { defu } from 'defu';
 import { installNuxtSiteConfig, useSiteConfig, withSiteUrl } from 'nuxt-site-config/kit';
 import { resolveNuxtContentVersion, renderNitroTypeAugmentations, setupNitroRuntimeCompatibility } from 'nuxtseo-shared/kit';
 import { readPackageJSON, resolvePackageJSON } from 'pkg-types';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { isReservedPath, normalizePagePath, toMarkdownPath } from '../../dist/runtime/markdown-path.js';
+import { hasMarkdownTwin, normalizePagePath, toMarkdownPath } from '../../dist/runtime/markdown-path.js';
 import { SITEMAP_MD_ROUTE } from '../../dist/runtime/server/utils/sitemap-md.js';
 import { publicCacheControl } from '../../dist/runtime/cache-control.js';
 import { MCP_SERVER_CARD_MEDIA_TYPE, AI_CATALOG_MEDIA_TYPE } from '../../dist/runtime/server/utils/discovery-response.js';
@@ -912,11 +912,7 @@ const RE_MD_EXT = /\.md$/;
 function isStaticMarkdownSourceRoute(route) {
   if (route.includes("*") || route.includes(":"))
     return false;
-  const path = route.split("?")[0] || route;
-  if (isReservedPath(path))
-    return false;
-  const lastSegment = path.split("/").pop() || "";
-  return !lastSegment.includes(".");
+  return hasMarkdownTwin(route.split("?")[0] || route);
 }
 function staticDescribedbyEntry(baseURL) {
   return `<${encodeURI(toDeployedRoute("/llms.txt", baseURL))}>; rel="describedby"`;
@@ -1467,8 +1463,6 @@ ${details}`);
           updateSeoProFeatures(seoProModules);
         return;
       }
-      if (databaseEnabled)
-        addServerPlugin(resolve("./runtime/server/plugins/mcp-data"));
       const mcpLink = {
         title: "MCP",
         href: withSiteUrl(finalMcpToolkitState.route, { withBase: true }),
@@ -1610,7 +1604,7 @@ ${details}`);
     if (!runtimeSyncSecret && runtimeSyncEnabled) {
       runtimeSyncSecret = randomBytes(32).toString("hex");
       if (!nuxt.options.dev && !nuxt.options._prepare)
-        logger.info(`Generated runtimeSyncSecret (use NUXT_AI_READY_RUNTIME_SYNC_SECRET env to set explicitly)`);
+        logger.info("Generated a new runtimeSyncSecret for this build. If an external scheduler calls /__ai-ready/*, set NUXT_AI_READY_RUNTIME_SYNC_SECRET; the generated secret changes on every build.");
     }
     if (runtimeSyncSecret) {
       const cacheDir = join(nuxt.options.rootDir, "node_modules/.cache/nuxt/ai-ready");
@@ -1624,6 +1618,8 @@ ${details}`);
       nitroConfig.experimental.asyncContext = true;
       const preset = String(nitroConfig.preset || "");
       const isEdgePreset = ["cloudflare", "vercel-edge", "netlify-edge", "deno"].some((p) => preset.startsWith(p));
+      if (isEdgePreset)
+        nitroConfig.experimental.wasm = true;
       if (nitroCompatibility._tag === "nitro-v3") {
         const nitro3Config = nitroConfig;
         const noExternals = Array.isArray(nitro3Config.noExternals) ? nitro3Config.noExternals : [];

package/node_modules/@mdream/js/LICENSE.md

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2025 Harlan Wilton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.