blume 0.5.4 → 0.6.0

package/dist/cli/index.js

@@ -519,6 +519,150 @@ import { build } from "astro";
 import { defineCommand as defineCommand2 } from "citty";
 import { join as join23 } from "pathe";
 
+// src/deploy/xml.ts
+var escapeXml = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
+
+// src/deploy/rss.ts
+var capitalize = (value) => value.charAt(0).toUpperCase() + value.slice(1);
+var pageDate = (page) => {
+  const raw = page.meta.date ?? page.meta.changelog?.date;
+  if (!raw) {
+    return;
+  }
+  const date = new Date(raw);
+  return Number.isNaN(date.getTime()) ? undefined : date;
+};
+var buildRssFeeds = (project) => {
+  const { config } = project;
+  const { rss } = config.seo;
+  const { site } = config.deployment;
+  if (!(rss.enabled && site)) {
+    return [];
+  }
+  const base = site.replace(/\/$/u, "");
+  const feeds = [];
+  for (const type of rss.types) {
+    const pages = project.graph.pages.filter((page) => page.contentType === type && !(page.meta.draft || page.meta.sidebar.hidden));
+    if (pages.length === 0) {
+      continue;
+    }
+    const items = pages.map((page) => ({
+      date: pageDate(page),
+      description: page.description,
+      link: `${base}${page.route}`,
+      title: page.title
+    })).toSorted((a, b) => (b.date?.getTime() ?? 0) - (a.date?.getTime() ?? 0)).slice(0, rss.limit);
+    feeds.push({
+      description: config.description,
+      items,
+      link: base,
+      path: `/${type}/rss.xml`,
+      title: `${config.title} — ${capitalize(type)}`,
+      type
+    });
+  }
+  return feeds;
+};
+var renderItem = (item) => {
+  const parts = [
+    `    <title>${escapeXml(item.title)}</title>`,
+    `    <link>${escapeXml(item.link)}</link>`,
+    `    <guid isPermaLink="true">${escapeXml(item.link)}</guid>`
+  ];
+  if (item.description) {
+    parts.push(`    <description>${escapeXml(item.description)}</description>`);
+  }
+  if (item.date) {
+    parts.push(`    <pubDate>${item.date.toUTCString()}</pubDate>`);
+  }
+  return `  <item>
+${parts.join(`
+`)}
+  </item>`;
+};
+var renderRssFeed = (feed) => {
+  const channel = [
+    `  <title>${escapeXml(feed.title)}</title>`,
+    `  <link>${escapeXml(feed.link)}</link>`,
+    `  <description>${escapeXml(feed.description ?? feed.title)}</description>`,
+    `  <atom:link href="${escapeXml(`${feed.link}${feed.path}`)}" rel="self" type="application/rss+xml" />`
+  ];
+  const items = feed.items.map(renderItem).join(`
+`);
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+<channel>
+${channel.join(`
+`)}
+${items}
+</channel>
+</rss>
+`;
+};
+
+// src/ai/agent-readability.ts
+var USAGE_TOKENS = [
+  ["search", "search"],
+  ["aiInput", "ai-input"],
+  ["aiTrain", "ai-train"]
+];
+var usagePolicy = (signals) => {
+  if (!signals) {
+    return null;
+  }
+  return Object.fromEntries(USAGE_TOKENS.map(([key, token]) => [token, signals[key]]));
+};
+var buildAgentReadability = (project) => {
+  const { config } = project;
+  if (!config.seo.agentReadability) {
+    return null;
+  }
+  const site = config.deployment.site ?? null;
+  const abs = (path) => site ? `${site.replace(/\/+$/u, "")}${path}` : path;
+  const artifacts = {
+    markdown: {
+      contentNegotiation: "text/markdown",
+      pattern: abs("/{route}.md")
+    }
+  };
+  if (config.ai.llmsTxt) {
+    artifacts.llmsFullTxt = abs("/llms-full.txt");
+    artifacts.llmsTxt = abs("/llms.txt");
+  }
+  if (config.mcp.enabled) {
+    artifacts.mcp = {
+      discovery: abs("/.well-known/mcp.json"),
+      url: abs(config.mcp.route)
+    };
+  }
+  if (config.ai.ask?.enabled) {
+    artifacts.askApi = abs("/api/ask");
+  }
+  if (site && config.seo.sitemap) {
+    artifacts.sitemap = abs("/sitemap.xml");
+  }
+  const feeds = site && config.seo.rss.enabled ? buildRssFeeds(project).map((feed) => abs(feed.path)) : [];
+  if (feeds.length > 0) {
+    artifacts.feeds = feeds;
+  }
+  const version = project.manifest?.blumeVersion;
+  const manifest = {
+    artifacts,
+    description: config.description,
+    generator: version ? `blume@${version}` : undefined,
+    name: config.mcp.name ?? config.title,
+    site
+  };
+  const usage = usagePolicy(config.seo.contentSignals);
+  if (usage) {
+    manifest.contentUsage = usage;
+  }
+  if (config.github) {
+    manifest.repository = `https://github.com/${config.github.owner}/${config.github.repo}`;
+  }
+  return manifest;
+};
+
 // src/core/frontmatter.ts
 import baseMatter from "gray-matter";
 import { dump, load } from "js-yaml";
@@ -720,12 +864,29 @@ var buildRedirectManifest = (redirects) => `${JSON.stringify(redirects.map((redi
 `;
 
 // src/deploy/robots.ts
+var SIGNAL_TOKENS = [
+  ["search", "search"],
+  ["aiInput", "ai-input"],
+  ["aiTrain", "ai-train"]
+];
+var contentSignalLine = (signals) => {
+  if (!signals) {
+    return null;
+  }
+  const tokens = SIGNAL_TOKENS.map(([key, token]) => `${token}=${signals[key] ? "yes" : "no"}`);
+  return `Content-Signal: ${tokens.join(", ")}`;
+};
 var buildRobots = (project) => {
   const { config } = project;
   if (!config.seo.robots) {
     return null;
   }
-  const lines = ["User-agent: *", "Allow: /"];
+  const lines = ["User-agent: *"];
+  const signal = contentSignalLine(config.seo.contentSignals);
+  if (signal) {
+    lines.push(signal);
+  }
+  lines.push("Allow: /");
   const { site } = config.deployment;
   if (site && config.seo.sitemap) {
     lines.push("", `Sitemap: ${site.replace(/\/$/u, "")}/sitemap.xml`);
@@ -735,9 +896,6 @@ var buildRobots = (project) => {
 `;
 };
 
-// src/deploy/xml.ts
-var escapeXml = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
-
 // src/deploy/sitemap.ts
 var lastmodTag = (value) => {
   if (!value) {
@@ -2676,7 +2834,8 @@ var buildSearchDocuments = async (project, options) => {
   return await Promise.all(indexable.map(async (route) => {
     const page = pageById.get(route.id);
     const raw = page ? await readEntryText(project, page) : "";
-    const body = raw ? toPlainText(frontmatter_default(raw).content) : "";
+    const source = raw ? frontmatter_default(raw).content : "";
+    const body = options?.content === "markdown" ? source.trim() : toPlainText(source);
     const tags = page?.meta?.search?.tags;
     const crumb = crumbs.get(route.path);
     return {
@@ -2867,15 +3026,26 @@ var resolveProjectContext = (root, config, options) => {
 
 // src/cli/dev-lock.ts
 var lockPath = (outDir) => join8(outDir, "dev.lock");
-var isDevLocked = (outDir) => {
-  const path = lockPath(outDir);
-  if (!existsSync5(path)) {
-    return false;
+var isValidPid = (pid) => typeof pid === "number" && Number.isInteger(pid) && pid > 0;
+var parseLock = (raw) => {
+  let data;
+  try {
+    data = JSON.parse(raw.trim());
+  } catch {
+    return null;
   }
-  const pid = Number.parseInt(readFileSync2(path, "utf-8").trim(), 10);
-  if (!(Number.isInteger(pid) && pid > 0)) {
-    return false;
+  if (isValidPid(data)) {
+    return { pid: data };
+  }
+  if (typeof data === "object" && data !== null) {
+    const { pid, port } = data;
+    if (isValidPid(pid)) {
+      return typeof port === "number" ? { pid, port } : { pid };
+    }
   }
+  return null;
+};
+var isProcessAlive = (pid) => {
   try {
     process.kill(pid, 0);
     return true;
@@ -2883,10 +3053,34 @@ var isDevLocked = (outDir) => {
     return error.code === "EPERM";
   }
 };
-var acquireDevLock = (outDir) => {
+var readDevLock = (outDir) => {
   const path = lockPath(outDir);
+  if (!existsSync5(path)) {
+    return null;
+  }
+  const lock = parseLock(readFileSync2(path, "utf-8"));
+  return lock && isProcessAlive(lock.pid) ? lock : null;
+};
+var writeLock = (outDir, port) => {
+  writeFileSync(lockPath(outDir), JSON.stringify({
+    pid: process.pid,
+    ...port === undefined ? {} : { port }
+  }));
+};
+var ownsLock = (outDir) => {
+  const path = lockPath(outDir);
+  if (!existsSync5(path)) {
+    return false;
+  }
+  try {
+    return parseLock(readFileSync2(path, "utf-8"))?.pid === process.pid;
+  } catch {
+    return false;
+  }
+};
+var acquireDevLock = (outDir, port) => {
   mkdirSync(outDir, { recursive: true });
-  writeFileSync(path, String(process.pid));
+  writeLock(outDir, port);
   let released = false;
   return () => {
     if (released) {
@@ -2894,15 +3088,22 @@ var acquireDevLock = (outDir) => {
     }
     released = true;
     try {
-      if (existsSync5(path) && readFileSync2(path, "utf-8").trim() === String(process.pid)) {
-        rmSync(path, { force: true });
+      if (ownsLock(outDir)) {
+        rmSync(lockPath(outDir), { force: true });
       }
     } catch {}
   };
 };
+var updateDevLockPort = (outDir, port) => {
+  if (ownsLock(outDir)) {
+    writeLock(outDir, port);
+  }
+};
+var describeDevLock = (lock) => lock.port === undefined ? "" : ` at http://localhost:${lock.port}`;
 var refuseIfDevRunning = (root, action, runtimeDir) => {
-  if (isDevLocked(resolveRuntimeDir(root, runtimeDir))) {
-    logger.error(`A \`blume dev\` server is running against .blume; ${action} would corrupt it. Stop the dev server, or re-run with --isolated to build/verify against .blume-verify without touching it.`);
+  const lock = readDevLock(resolveRuntimeDir(root, runtimeDir));
+  if (lock) {
+    logger.error(`A \`blume dev\` server is running${describeDevLock(lock)}; ${action} would corrupt its .blume runtime. Reuse that server, stop it first, or re-run with --isolated to build/verify against .blume-verify without touching it.`);
     process.exit(1);
   }
 };
@@ -2926,6 +3127,7 @@ import { glob as glob4 } from "tinyglobby";
 // src/ai/ask-data.ts
 var buildAskData = async (project) => {
   const documents = await buildSearchDocuments(project, {
+    content: "markdown",
     includeWhenDisabled: true
   });
   return {
@@ -3424,6 +3626,7 @@ var uiStringsObject = z.object({
     connectMcp: z.string().default("Connect to MCP"),
     copied: z.string().default("Copied!"),
     copyClaudeCode: z.string().default("Copy Claude Code command"),
+    copyCodex: z.string().default("Copy Codex command"),
     copyMarkdown: z.string().default("Copy as Markdown"),
     copyServerUrl: z.string().default("Copy server URL"),
     edit: z.string().default("Edit on GitHub"),
@@ -3431,11 +3634,15 @@ var uiStringsObject = z.object({
     scrollToTop: z.string().default("Scroll to top")
   }).default({}),
   ask: z.object({
+    clear: z.string().default("Clear conversation"),
+    close: z.string().default("Close"),
+    copy: z.string().default("Copy conversation"),
     empty: z.string().default("Ask a question about the docs."),
     error: z.string().default("Sorry, something went wrong."),
     label: z.string().default("Ask a question"),
     placeholder: z.string().default("Ask a question…"),
     send: z.string().default("Send"),
+    tip: z.string().default("Tip: You can open and close chat with"),
     title: z.string().default("Ask AI")
   }).default({}),
   feedback: z.object({
@@ -3568,6 +3775,9 @@ var collectIcons = (navigation) => {
       push(item.icon, `selector "${item.label}"`);
     }
   }
+  for (const link of navigation.featured) {
+    push(link.icon, `featured link "${link.label}"`);
+  }
   const sidebars = [navigation.sidebar];
   for (const sidebar of sidebars) {
     for (const node of flattenNodes(sidebar)) {
@@ -3597,7 +3807,11 @@ var resolvesToPages = (routes, path) => routes.has(path) || [...routes].some((ro
 var validateNavTargets = (navigation, routes) => {
   const targets = [
     ...navigation.tabs.map((tab) => ({ label: tab.label, path: tab.path })),
-    ...navigation.selectors.flatMap((selector) => selector.items.map((item) => ({ label: item.label, path: item.path })))
+    ...navigation.selectors.flatMap((selector) => selector.items.map((item) => ({ label: item.label, path: item.path }))),
+    ...navigation.featured.map((link) => ({
+      label: link.label,
+      path: link.href
+    }))
   ];
   const diagnostics = [];
   const seen = new Set;
@@ -3813,84 +4027,6 @@ var resolveTsconfigAliases = (root) => {
   return aliases;
 };
 
-// src/deploy/rss.ts
-var capitalize = (value) => value.charAt(0).toUpperCase() + value.slice(1);
-var pageDate = (page) => {
-  const raw = page.meta.date ?? page.meta.changelog?.date;
-  if (!raw) {
-    return;
-  }
-  const date = new Date(raw);
-  return Number.isNaN(date.getTime()) ? undefined : date;
-};
-var buildRssFeeds = (project) => {
-  const { config } = project;
-  const { rss } = config.seo;
-  const { site } = config.deployment;
-  if (!(rss.enabled && site)) {
-    return [];
-  }
-  const base = site.replace(/\/$/u, "");
-  const feeds = [];
-  for (const type of rss.types) {
-    const pages = project.graph.pages.filter((page) => page.contentType === type && !(page.meta.draft || page.meta.sidebar.hidden));
-    if (pages.length === 0) {
-      continue;
-    }
-    const items = pages.map((page) => ({
-      date: pageDate(page),
-      description: page.description,
-      link: `${base}${page.route}`,
-      title: page.title
-    })).toSorted((a, b) => (b.date?.getTime() ?? 0) - (a.date?.getTime() ?? 0)).slice(0, rss.limit);
-    feeds.push({
-      description: config.description,
-      items,
-      link: base,
-      path: `/${type}/rss.xml`,
-      title: `${config.title} — ${capitalize(type)}`,
-      type
-    });
-  }
-  return feeds;
-};
-var renderItem = (item) => {
-  const parts = [
-    `    <title>${escapeXml(item.title)}</title>`,
-    `    <link>${escapeXml(item.link)}</link>`,
-    `    <guid isPermaLink="true">${escapeXml(item.link)}</guid>`
-  ];
-  if (item.description) {
-    parts.push(`    <description>${escapeXml(item.description)}</description>`);
-  }
-  if (item.date) {
-    parts.push(`    <pubDate>${item.date.toUTCString()}</pubDate>`);
-  }
-  return `  <item>
-${parts.join(`
-`)}
-  </item>`;
-};
-var renderRssFeed = (feed) => {
-  const channel = [
-    `  <title>${escapeXml(feed.title)}</title>`,
-    `  <link>${escapeXml(feed.link)}</link>`,
-    `  <description>${escapeXml(feed.description ?? feed.title)}</description>`,
-    `  <atom:link href="${escapeXml(`${feed.link}${feed.path}`)}" rel="self" type="application/rss+xml" />`
-  ];
-  const items = feed.items.map(renderItem).join(`
-`);
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
-<channel>
-${channel.join(`
-`)}
-${items}
-</channel>
-</rss>
-`;
-};
-
 // src/openapi/references.ts
 var NON_SLUG = /[^a-z0-9]+/gu;
 var SLUG_EDGES = /^-+|-+$/gu;
@@ -3977,6 +4113,30 @@ import { isAbsolute as isAbsolute5, join as join11 } from "pathe";
 import { existsSync as existsSync8, readFileSync as readFileSync4 } from "node:fs";
 import { dirname as dirname6, isAbsolute as isAbsolute4, join as join10, relative as relative4 } from "pathe";
 
+// src/core/sources/watch.ts
+var BLUME_IGNORE_DIRS = [
+  ".blume",
+  ".cache",
+  ".git",
+  ".next",
+  ".turbo",
+  ".vercel",
+  "dist",
+  "node_modules"
+];
+var baselineScanIgnore = () => BLUME_IGNORE_DIRS.map((dir) => `**/${dir}/**`);
+var BLUME_WATCH_IGNORE_DIRS = BLUME_IGNORE_DIRS;
+var excludeDirSegments = (patterns) => patterns.map((pattern) => /^(?<dir>[^*/]+)\/\*\*$/u.exec(pattern)?.groups?.dir).filter((dir) => dir !== undefined);
+var ignoringWatchListener = (onChange, ignoreDirs = BLUME_WATCH_IGNORE_DIRS) => {
+  const ignore = new Set(ignoreDirs);
+  return (_event, filename) => {
+    if (typeof filename === "string" && filename.split(/[/\\]/u).some((segment) => ignore.has(segment))) {
+      return;
+    }
+    onChange();
+  };
+};
+
 // src/theme/fonts.ts
 var FALLBACKS = {
   mono: ["ui-monospace", "SF Mono", "Menlo", "monospace"],
@@ -4314,9 +4474,17 @@ export default defineConfig({
     // native bindings resolve at runtime and isolated linkers don't bundle
     // symlinked store copies (which would surface their children as unresolvable
     // imports). See RENDER_EXTERNAL_DEPS / prerenderDepsPlugin.
+    //
+    // The SSR externals go through the legacy \`ssr.external\` key rather than
+    // \`environments.ssr\`: defining a user-owned \`environments.ssr\` block
+    // collides with the internal environment Astro 7 builds the server under and
+    // detaches the adapter's server entrypoint from the rolldown input, so the
+    // SSR entry is emitted as \`index.mjs\` instead of the \`entry.mjs\` the
+    // Vercel adapter's \`astro:build:done\` hook then fails to find. \`prerender\`
+    // is Astro-only and has no legacy equivalent, so it stays under \`environments\`.
+    ssr: { external: ${JSON.stringify(RENDER_EXTERNAL_DEPS)} },
     environments: {
       prerender: { resolve: { external: ${JSON.stringify(RENDER_EXTERNAL_DEPS)} } },
-      ssr: { resolve: { external: ${JSON.stringify(RENDER_EXTERNAL_DEPS)} } },
     },
     resolve: {
       alias: {
@@ -4355,7 +4523,7 @@ var contentConfigTemplate = (options) => {
   const docsPattern = filesystem ? [
     ...config.content.include,
     ...(config.content.exclude ?? []).map((pattern) => `!${pattern}`),
-    "!**/node_modules/**",
+    ...BLUME_IGNORE_DIRS.filter((dir) => dir !== ".blume").map((dir) => `!**/${dir}/**`),
     ...outDirIgnore
   ] : [];
   const stagedBlock = options.staged ? `
@@ -4691,7 +4859,7 @@ const siteHost = (() => {
 
 export async function GET({ props }) {
   const png = await renderOgImage({
-    accent: data.config.theme.accent,
+    accent: data.config.theme.accent.light,
     brand: data.config.title,
     description: data.config.description,
     logo: data.config.logo?.svg,
@@ -4739,7 +4907,7 @@ var catchAllPageTemplate = (options) => {
   const askImport = options.askEnabled ? `import AskAI from "blume/components/islands/AskAI.astro";
 ` : "";
   const askSlot = options.askEnabled ? `
-  <AskAI slot="ask" strings={ui.ask} />` : "";
+  <AskAI slot="ask" strings={ui.ask} suggestions={data.config.ask?.suggestions ?? []} />` : "";
   const mathImport = options.mathEnabled ? `import Math from "blume/components/content/Math.astro";
 ` : "";
   const mathEntry = options.mathEnabled ? `Math,
@@ -4991,7 +5159,7 @@ var changelogIndexTemplate = (options) => {
   const askImport = options.askEnabled ? `import AskAI from "blume/components/islands/AskAI.astro";
 ` : "";
   const askSlot = options.askEnabled ? `
-  <AskAI slot="ask" />` : "";
+  <AskAI slot="ask" strings={data.ui.ask} suggestions={data.config.ask?.suggestions ?? []} />` : "";
   const clientData = options.needsReact ? `
   clientData={{ config: data.config, navigation: data.navigation, page: { route: "/changelog", title: data.config.title + " changelog" } }}` : "";
   const stagedSpread = options.staged ? `
@@ -5281,8 +5449,8 @@ var themeRootCss = (theme, options) => [
   `  --blume-accent: ${options.accent};`,
   ...cssToken("--blume-action", options.action),
   ...cssToken("--blume-action-foreground", options.action ? "oklch(1 0 0)" : null),
-  ...cssToken("--blume-background", safeColorOrNull(theme.background)),
-  ...cssToken("--blume-background-image", theme.backgroundImage ? backgroundImageCss(theme.backgroundImage) : null),
+  ...cssToken("--blume-background", safeColorOrNull(theme.background?.light)),
+  ...cssToken("--blume-background-image", theme.backgroundImage?.light ? backgroundImageCss(theme.backgroundImage.light) : null),
   `  --blume-radius: ${options.radius};`
 ].filter(Boolean).join(`
 `);
@@ -5292,8 +5460,8 @@ var themeDarkCss = (theme, options) => {
     "  --blume-accent-foreground: oklch(1 0 0);",
     ...cssToken("--blume-action", options.action),
     ...cssToken("--blume-action-foreground", options.action ? "oklch(1 0 0)" : null),
-    ...cssToken("--blume-background", safeColorOrNull(theme.backgroundDark)),
-    ...cssToken("--blume-background-image", theme.backgroundImageDark ? backgroundImageCss(theme.backgroundImageDark) : null)
+    ...cssToken("--blume-background", safeColorOrNull(theme.background?.dark)),
+    ...cssToken("--blume-background-image", theme.backgroundImage?.dark ? backgroundImageCss(theme.backgroundImage.dark) : null)
   ].filter(Boolean);
   return `:root[data-theme="dark"] {
 ${tokens.join(`
@@ -5301,20 +5469,22 @@ ${tokens.join(`
 }
 `;
 };
-var resolveAccent = (theme) => presetOrColor(theme.accent);
+var resolveAccent = (theme) => ({
+  dark: presetOrColor(theme.accent.dark),
+  light: presetOrColor(theme.accent.light)
+});
 var resolveRadius = (theme) => RADII[theme.radius];
 var buildThemeCss = (theme) => {
-  const accent = presetOrColor(theme.accent);
-  const accentDark = theme.accentDark ? presetOrColor(theme.accentDark) : null;
+  const accent = resolveAccent(theme);
   const action = theme.action ? presetOrColor(theme.action) : null;
   const radius = RADII[theme.radius];
   const root = themeRootCss(theme, {
-    accent,
+    accent: accent.light,
     action,
     radius
   });
   const dark = themeDarkCss(theme, {
-    accent: accentDark ?? accent,
+    accent: accent.dark,
     action
   });
   return `/* Generated by Blume from theme config. */
@@ -5347,7 +5517,7 @@ var themeConfiguration = (config, override) => {
   const accent = resolveAccent(config.theme);
   const radius = resolveRadius(config.theme);
   return {
-    customCss: `:root,.light-mode,.dark-mode{--scalar-color-accent:${accent};--scalar-radius:${radius};}`,
+    customCss: `:root,.light-mode,.dark-mode{--scalar-color-accent:${accent.light};--scalar-radius:${radius};}.dark-mode{--scalar-color-accent:${accent.dark};}`,
     ...darkModeConfig(config.theme.mode)
   };
 };
@@ -7097,6 +7267,7 @@ var buildRuntimeData = (project) => {
   const navigationByLocale = i18n ? Object.fromEntries(i18n.locales.map(({ code }) => [
     code,
     withReferenceTabs(graph.navigationByLocale[code] ?? {
+      featured: [],
       selectors: [],
       sidebar: [],
       tabs: []
@@ -7106,6 +7277,7 @@ var buildRuntimeData = (project) => {
     config: {
       analytics: config.analytics ?? null,
       appleIcon: resolveAppleIcon(project),
+      ask: config.ai.ask?.enabled ? { suggestions: config.ai.ask.suggestions } : null,
       banner: resolveBanner(config),
       codeWrap: config.markdown.code.wrap,
       description: config.description,
@@ -7545,7 +7717,6 @@ var pageMetaSchema = pageMetaBaseSchema;
 var sidebarDisplaySchema = z2.enum(["flat", "group", "page"]);
 var folderMetaSchema = z2.object({
   collapsed: z2.boolean().optional(),
-  display: sidebarDisplaySchema.optional(),
   icon: iconName.optional(),
   order: z2.number().optional(),
   pages: z2.array(z2.string()).optional(),
@@ -7699,14 +7870,18 @@ var sidebarItemSchema = z2.lazy(() => z2.union([
 var fontSlug = z2.string().refine(isFontSlug, (value) => ({
   message: `Unknown font "${value}". Supported fonts: ${FONT_SLUGS.join(", ")}.`
 }));
+var perModeValueSchema = z2.union([
+  z2.string(),
+  z2.object({ dark: z2.string().optional(), light: z2.string().optional() }).strict()
+]).optional().transform((value) => typeof value === "string" ? { dark: value, light: value } : value);
 var themeConfigSchema = z2.object({
-  accent: z2.string().default("blue"),
-  accentDark: z2.string().optional(),
+  accent: z2.union([
+    z2.string(),
+    z2.object({ dark: z2.string(), light: z2.string() }).strict()
+  ]).default("blue").transform((value) => typeof value === "string" ? { dark: value, light: value } : value),
   action: z2.string().optional(),
-  background: z2.string().optional(),
-  backgroundDark: z2.string().optional(),
-  backgroundImage: z2.string().optional(),
-  backgroundImageDark: z2.string().optional(),
+  background: perModeValueSchema,
+  backgroundImage: perModeValueSchema,
   fonts: z2.object({
     body: fontSlug.default("inter"),
     display: fontSlug.default("inter-tight"),
@@ -7785,7 +7960,11 @@ var aiConfigSchema = z2.object({
     baseUrl: z2.string().url().optional(),
     enabled: z2.boolean().default(false),
     model: z2.string().default("openai/gpt-5.5"),
-    provider: z2.enum(askAiProviders).default("gateway")
+    provider: z2.enum(askAiProviders).default("gateway"),
+    suggestions: z2.array(z2.object({
+      icon: iconName.optional(),
+      label: z2.string().min(1)
+    }).strict()).default([])
   }).strict().superRefine((value, ctx) => {
     if (value.provider === "openai-compatible" && !value.baseUrl) {
       ctx.addIssue({
@@ -7797,10 +7976,22 @@ var aiConfigSchema = z2.object({
   }).optional(),
   llmsTxt: z2.boolean().default(false)
 }).strict();
+var featuredLinkSchema = z2.object({
+  href: z2.string(),
+  icon: iconName.optional(),
+  label: z2.string()
+}).strict();
 var navigationConfigSchema = z2.object({
+  featured: z2.array(featuredLinkSchema).default([]),
   repo: z2.boolean().default(true),
   selectors: z2.array(navSelectorSchema).default([]),
-  sidebar: z2.array(sidebarItemSchema).optional(),
+  sidebar: z2.union([
+    z2.array(sidebarItemSchema),
+    z2.object({
+      display: sidebarDisplaySchema.default("flat"),
+      items: z2.array(sidebarItemSchema).optional()
+    }).strict()
+  ]).default({}).transform((value) => Array.isArray(value) ? { display: "flat", items: value } : value),
   tabs: z2.array(navTabSchema).optional()
 }).strict();
 var exportConfigSchema = z2.union([
@@ -7880,7 +8071,23 @@ var rssConfigSchema = z2.object({
   limit: z2.number().int().positive().default(50),
   types: z2.array(z2.string()).default(["blog", "changelog"])
 }).strict();
+var contentSignalsObjectSchema = z2.object({
+  aiInput: z2.boolean().default(true),
+  aiTrain: z2.boolean().default(true),
+  search: z2.boolean().default(true)
+}).strict();
+var contentSignalsSchema = z2.union([z2.boolean(), contentSignalsObjectSchema]).transform((value) => {
+  if (value === true) {
+    return contentSignalsObjectSchema.parse({});
+  }
+  if (value === false) {
+    return null;
+  }
+  return value;
+});
 var seoConfigSchema = z2.object({
+  agentReadability: z2.boolean().default(true),
+  contentSignals: contentSignalsSchema.default(true),
   og: ogConfigSchema.default({}),
   robots: z2.boolean().default(true),
   rss: rssConfigSchema.default({}),
@@ -8091,7 +8298,6 @@ var applyFolderMeta = (group, folderMeta, sharedMeta, metaPrefix) => {
     group.icon = meta.icon ?? group.icon;
     group.order = meta.order ?? group.order;
     group.collapsed = meta.collapsed ?? group.collapsed;
-    group.display = meta.display ?? group.display;
     if (meta.pages) {
       const rank = new Map(meta.pages.map((key, i) => [key, i]));
       for (const child of group.children) {
@@ -8121,7 +8327,15 @@ var sortNodes = (nodes) => {
     }
   }
 };
-var toNavNode = (node) => {
+var hoistPages = (nodes) => {
+  const pages = nodes.filter((node) => node.kind === "page");
+  const groups = nodes.filter((node) => node.kind === "group");
+  nodes.splice(0, nodes.length, ...pages, ...groups);
+  for (const group of groups) {
+    hoistPages(group.children);
+  }
+};
+var toNavNode = (node, display) => {
   if (node.kind === "page") {
     return {
       badge: node.badge,
@@ -8135,16 +8349,16 @@ var toNavNode = (node) => {
     };
   }
   return {
-    children: node.children.map(toNavNode),
+    children: node.children.map((child) => toNavNode(child, display)),
     collapsed: node.collapsed,
-    display: node.display,
+    display,
     icon: node.icon,
     kind: "group",
     label: node.label,
     path: node.routePath
   };
 };
-var buildFileSystemSidebar = (pages, folderMeta, sharedMeta, metaPrefix) => {
+var buildFileSystemSidebar = (pages, folderMeta, sharedMeta, metaPrefix, display) => {
   const root = createGroup("", "", "", 0);
   for (const page of pages) {
     if (page.meta.sidebar.hidden) {
@@ -8175,7 +8389,10 @@ var buildFileSystemSidebar = (pages, folderMeta, sharedMeta, metaPrefix) => {
   }
   applyFolderMeta(root, folderMeta, sharedMeta, metaPrefix);
   sortNodes(root.children);
-  return root.children.map(toNavNode);
+  if (display === "flat") {
+    hoistPages(root.children);
+  }
+  return root.children.map((child) => toNavNode(child, display));
 };
 var normalizeRef = (ref) => {
   if (ref === "index") {
@@ -8192,7 +8409,7 @@ var routeForRef = (ref, byRoute) => {
   const normalized = normalizeRef(ref);
   return byRoute.get(normalized)?.route ?? normalized;
 };
-var buildConfigSidebar = (items, byRoute) => {
+var buildConfigSidebar = (items, byRoute, display) => {
   const nodes = [];
   for (const item of items) {
     if (typeof item === "string") {
@@ -8214,10 +8431,10 @@ var buildConfigSidebar = (items, byRoute) => {
     if (item.items) {
       nodes.push({
         badge: item.badge,
-        children: buildConfigSidebar(item.items, byRoute),
+        children: buildConfigSidebar(item.items, byRoute, display),
         collapsed: item.collapsed,
         directory: item.directory,
-        display: item.display,
+        display: item.display ?? display,
         icon: item.icon,
         kind: "group",
         label: item.label,
@@ -8252,8 +8469,10 @@ var buildConfigSidebar = (items, byRoute) => {
   return nodes;
 };
 var buildNavigation = (pages, options) => {
+  const featured = options.featured ?? [];
   const selectors = options.selectors ?? [];
   const tabs = options.tabs ?? [];
+  const display = options.display ?? "flat";
   const metaPrefix = options.metaPrefix ?? "";
   const sharedFolderMeta = options.sharedFolderMeta ?? new Map;
   const byRoute = new Map(pages.map((page) => [
@@ -8262,14 +8481,16 @@ var buildNavigation = (pages, options) => {
   ]));
   if (options.sidebar) {
     return {
+      featured,
       selectors,
-      sidebar: buildConfigSidebar(options.sidebar, byRoute),
+      sidebar: buildConfigSidebar(options.sidebar, byRoute, display),
       tabs
     };
   }
   return {
+    featured,
     selectors,
-    sidebar: buildFileSystemSidebar(pages, options.folderMeta, sharedFolderMeta, metaPrefix),
+    sidebar: buildFileSystemSidebar(pages, options.folderMeta, sharedFolderMeta, metaPrefix, display),
     tabs
   };
 };
@@ -8327,26 +8548,31 @@ var buildContentGraph = (pages, options) => {
         localePages = [...real, ...filled];
       }
       navigationByLocale[code] = buildNavigation(localePages, {
+        display: options.navigation.sidebar.display,
+        featured: options.navigation.featured,
         folderMeta: options.folderMeta,
         metaPrefix: i18n.parser === "dir" && code !== i18n.defaultLocale ? code : "",
         refByLogical: true,
         selectors: options.navigation.selectors,
         sharedFolderMeta: options.sharedFolderMeta,
-        sidebar: options.navigation.sidebar,
+        sidebar: options.navigation.sidebar.items,
         tabs
       });
     }
     navigation = navigationByLocale[i18n.defaultLocale] ?? {
+      featured: [],
       selectors: [],
       sidebar: [],
       tabs: []
     };
   } else {
     navigation = buildNavigation(pages, {
+      display: options.navigation.sidebar.display,
+      featured: options.navigation.featured,
       folderMeta: options.folderMeta,
       selectors: options.navigation.selectors,
       sharedFolderMeta: options.sharedFolderMeta,
-      sidebar: options.navigation.sidebar,
+      sidebar: options.navigation.sidebar.items,
       tabs: options.navigation.tabs
     });
   }
@@ -8662,28 +8888,13 @@ import { existsSync as existsSync12, watch as fsWatch } from "node:fs";
 import { readFile as readFile11 } from "node:fs/promises";
 import { extname as extname5, isAbsolute as isAbsolute7, join as join17, relative as relative10, resolve as resolve5 } from "pathe";
 import { glob as glob6 } from "tinyglobby";
-
-// src/core/sources/watch.ts
-var BLUME_WATCH_IGNORE_DIRS = [".blume", ".git", "node_modules"];
-var excludeDirSegments = (patterns) => patterns.map((pattern) => /^(?<dir>[^*/]+)\/\*\*$/u.exec(pattern)?.groups?.dir).filter((dir) => dir !== undefined);
-var ignoringWatchListener = (onChange, ignoreDirs = BLUME_WATCH_IGNORE_DIRS) => {
-  const ignore = new Set(ignoreDirs);
-  return (_event, filename) => {
-    if (typeof filename === "string" && filename.split(/[/\\]/u).some((segment) => ignore.has(segment))) {
-      return;
-    }
-    onChange();
-  };
-};
-
-// src/core/sources/filesystem.ts
 var filesystemSource = (options) => {
   const contentRoot = isAbsolute7(options.root) ? options.root : join17(resolve5(options.projectRoot), options.root);
   const load2 = async () => {
     const files = await glob6(options.include, {
       absolute: true,
       cwd: contentRoot,
-      ignore: options.exclude,
+      ignore: [...options.exclude, ...baselineScanIgnore()],
       onlyFiles: true
     });
     files.sort();
@@ -10010,6 +10221,12 @@ var publishBuildArtifacts = async (project, distDir, args) => {
     await writeFile7(join23(distDir, "robots.txt"), robots, "utf-8");
     logger.success("Generated robots.txt");
   }
+  const agentReadability = buildAgentReadability(project);
+  if (agentReadability && !existsSync14(join23(distDir, "agent-readability.json"))) {
+    await writeFile7(join23(distDir, "agent-readability.json"), `${JSON.stringify(agentReadability, null, 2)}
+`, "utf-8");
+    logger.success("Generated agent-readability.json");
+  }
   await emitRedirectFiles(project.config, distDir);
   const { config } = project;
   const features = serverFeatures(config);
@@ -10021,6 +10238,7 @@ var publishBuildArtifacts = async (project, distDir, args) => {
     `Redirects  ${config.redirects.length}`,
     `Sitemap    ${sitemap ? "yes" : "no (set deployment.site)"}`,
     `Robots     ${robots ? "yes" : "no"}`,
+    `Agent JSON ${agentReadability ? "yes" : "no"}`,
     `LLM files  ${config.ai.llmsTxt ? "yes" : "no"}`,
     `Server features  ${features.length > 0 ? features.join(", ") : "none"}`
   ].join(`
@@ -10279,6 +10497,14 @@ var devCommand = defineCommand4({
     const explicitPort = parsePort(args.port);
     const port = explicitPort ?? 4321;
     const devServerUrl = `http://localhost:${port}`;
+    const outDir = resolveRuntimeDir(root);
+    const running = readDevLock(outDir);
+    if (running) {
+      logger.error(`A \`blume dev\` server is already running${describeDevLock(running)} in this project. Reuse that server instead of starting a second one — two dev servers would corrupt the shared .blume dir. If it crashed, delete .blume/dev.lock.`);
+      process.exit(1);
+    }
+    const releaseLock = acquireDevLock(outDir, port);
+    process.on("exit", releaseLock);
     const project = await prepareProject({
       devServerUrl,
       mode: "dev",
@@ -10287,12 +10513,6 @@ var devCommand = defineCommand4({
       root,
       strict: args.strict
     });
-    if (isDevLocked(project.context.outDir)) {
-      logger.error("Another `blume dev` is already running in this project; two dev servers would corrupt the shared .blume dir. Stop the other one first (or delete .blume/dev.lock if it crashed).");
-      process.exit(1);
-    }
-    const releaseLock = acquireDevLock(project.context.outDir);
-    process.on("exit", releaseLock);
     const server = await dev({
       logLevel: args.debug ? "debug" : "info",
       root: project.context.outDir,
@@ -10302,6 +10522,9 @@ var devCommand = defineCommand4({
         port: explicitPort
       }
     });
+    if (server.address.port !== port) {
+      updateDevLockPort(outDir, server.address.port);
+    }
     showBlumeErrorOverlay(project.diagnostics);
     const runRegenerate = coalescedRunner(async () => {
       try {
@@ -11330,5 +11553,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=59F90AF7D601CF0764756E2164756E21
+//# debugId=0E9EF5D2749C00F464756E2164756E21
 //# sourceMappingURL=index.js.map