blume 1.4.2 → 1.4.3

package/dist/cli/index.js

@@ -537,9 +537,9 @@ Next steps:
 import { defineCommand as defineCommand2 } from "citty";
 
 // src/audit/agent.ts
-import { spawn } from "node:child_process";
 import { mkdtemp, writeFile as writeFile2 } from "node:fs/promises";
 import { tmpdir } from "node:os";
+import spawn from "cross-spawn";
 import { join as join5 } from "pathe";
 
 // src/audit/report.ts
@@ -1463,24 +1463,43 @@ Work through every finding:
 3. Never fix a finding by deleting a page, removing content, or hiding it from the audit; if a finding genuinely needs a human decision, leave it and say so in your summary.
 
 When you are done, run \`blume build\` and then \`blume audit\` to verify, and repeat until the audit reports no issues.`;
-var spawnAgent = (command, args, shell) => new Promise((resolve2, reject) => {
-  const child = spawn(command, args, { shell, stdio: "inherit" });
+var spawnAgent = (bin, args) => new Promise((resolve2, reject) => {
+  const child = spawn(bin, args, { stdio: "inherit" });
   child.once("error", reject);
   child.once("close", (code) => resolve2(code ?? 1));
 });
-var WINDOWS_COMMAND_NOT_FOUND = 9009;
 var launchAgent = async (bin, prompt, platform = process.platform) => {
   if (platform !== "win32") {
-    return await spawnAgent(bin, [prompt], false);
+    return await spawnAgent(bin, [prompt]);
   }
   const dir = await mkdtemp(join5(tmpdir(), "blume-audit-"));
   const promptPath = join5(dir, "prompt.md");
   await writeFile2(promptPath, prompt);
-  return await spawnAgent(`"${bin}" "Read ${promptPath} and follow its instructions exactly."`, [], true);
+  return await spawnAgent(bin, [
+    `Read ${promptPath} and follow its instructions exactly.`
+  ]);
 };
 
 // src/audit/run.ts
 import { readFile as readFile4 } from "node:fs/promises";
+import pMap3 from "p-map";
+
+// src/core/trim.ts
+var trimStart = (text, char) => {
+  let start = 0;
+  while (start < text.length && text[start] === char) {
+    start += 1;
+  }
+  return text.slice(start);
+};
+var trimEnd = (text, char) => {
+  let end = text.length;
+  while (end > 0 && text[end - 1] === char) {
+    end -= 1;
+  }
+  return text.slice(0, end);
+};
+var trimChar = (text, char) => trimEnd(trimStart(text, char), char);
 
 // src/core/base-path.ts
 var normalizeBasePath = (input) => {
@@ -1491,9 +1510,16 @@ var normalizeBasePath = (input) => {
   return trimmed === "" ? "" : `/${trimmed}`;
 };
 var normalizePath = (path) => {
-  const trimmed = path.replace(/\/+$/u, "");
+  const trimmed = trimEnd(path, "/");
   return trimmed === "" ? "/" : trimmed;
 };
+var normalizeRoute = (input) => {
+  const trimmed = trimEnd(input.trim(), "/");
+  if (trimmed === "") {
+    return "/";
+  }
+  return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+};
 var isInternalPath = (target) => target.startsWith("/") && !target.startsWith("//");
 var withBasePath = (basePath, route) => {
   if (!basePath || !isInternalPath(route)) {
@@ -1709,7 +1735,28 @@ var withYamlEngine = (options) => ({
     ...options?.engines
   }
 });
-var matter = Object.assign((input, options) => baseMatter(input, withYamlEngine(options)), baseMatter, {
+var opensWithThematicBreak = (input) => {
+  const [first = "", second] = input.split(/\r?\n/u, 2);
+  if (!/^-{3}\s*$/u.test(first)) {
+    return false;
+  }
+  if (second === undefined || second.trim() === "") {
+    return true;
+  }
+  return !input.includes(`
+---`, 1);
+};
+var passthrough = (input) => ({
+  content: input,
+  data: {},
+  excerpt: "",
+  isEmpty: false,
+  language: "",
+  matter: "",
+  orig: input,
+  stringify: () => input
+});
+var matter = Object.assign((input, options) => typeof input === "string" && opensWithThematicBreak(input) ? passthrough(input) : baseMatter(input, withYamlEngine(options)), baseMatter, {
   read: (filepath, options) => baseMatter.read(filepath, withYamlEngine(options)),
   stringify: (file, data, options) => baseMatter.stringify(file, data, withYamlEngine(options))
 });
@@ -2428,6 +2475,7 @@ var llmsChecks = {
 };
 
 // src/core/probe.ts
+import pMap from "p-map";
 var PROBE_CONCURRENCY = 8;
 var PROBE_TIMEOUT_MS = 1e4;
 var STATUS_NOT_FOUND = 404;
@@ -2489,20 +2537,8 @@ var gradeExternal = (result) => {
 };
 var probeAll = async (urls, options = {}) => {
   const unique = [...new Set(urls)];
-  const results = new Map;
-  const limit = Math.min(options.concurrency ?? PROBE_CONCURRENCY, unique.length);
-  let cursor = 0;
-  const worker = async () => {
-    while (cursor < unique.length) {
-      const url = unique[cursor];
-      cursor += 1;
-      if (url !== undefined) {
-        results.set(url, await probe(url, options));
-      }
-    }
-  };
-  await Promise.all(Array.from({ length: limit }, worker));
-  return results;
+  const entries = await pMap(unique, async (url) => [url, await probe(url, options)], { concurrency: Math.max(1, options.concurrency ?? PROBE_CONCURRENCY) });
+  return new Map(entries);
 };
 
 // src/audit/checks/network.ts
@@ -2996,6 +3032,8 @@ var urlChecks = {
 // src/audit/crawl.ts
 import { readFile as readFile3, stat } from "node:fs/promises";
 import { XMLParser } from "fast-xml-parser";
+import { fromMarkdown } from "mdast-util-from-markdown";
+import pMap2 from "p-map";
 import { join as join9, relative as relative6 } from "pathe";
 import { glob } from "tinyglobby";
 
@@ -3057,32 +3095,19 @@ var askBackendRuntimeDep = (ask) => {
   return ASK_PRESETS[provider]?.runtimeDep ?? OPENAI_COMPATIBLE_DEP;
 };
 
-// src/core/trim.ts
-var trimStart = (text, char) => {
-  let start = 0;
-  while (start < text.length && text[start] === char) {
-    start += 1;
-  }
-  return text.slice(start);
+// src/core/site-url.ts
+import { joinURL } from "ufo";
+var siteRoot = (site) => trimEnd(site, "/");
+var absoluteUrl = (site, path) => {
+  const root = siteRoot(site);
+  return path === "/" ? `${root}/` : joinURL(root, path);
 };
-var trimEnd = (text, char) => {
-  let end = text.length;
-  while (end > 0 && text[end - 1] === char) {
-    end -= 1;
-  }
-  return text.slice(0, end);
-};
-var trimChar = (text, char) => trimEnd(trimStart(text, char), char);
 
 // src/openapi/references.ts
-var NON_SLUG = /[^a-z0-9]+/gu;
-var slugify = (text) => trimChar(text.toLowerCase().replace(NON_SLUG, "-"), "-");
-var normalizeRoute = (route) => {
-  const trimmed = route.trim();
-  const withSlash = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
-  const noTrailing = trimEnd(withSlash, "/");
-  return noTrailing === "" ? "/" : noTrailing;
-};
+var NON_SLUG = /[^\p{L}\p{M}\p{N}]+/gu;
+var FORMAT_CHARS = /\p{Cf}/gu;
+var LEADING_MARKS = /^\p{M}+/u;
+var slugify = (text) => trimChar(text.normalize("NFC").toLowerCase().replace(FORMAT_CHARS, "").replace(NON_SLUG, "-"), "-").replace(LEADING_MARKS, "");
 var routeSlug = (route) => slugify(trimChar(route, "/")) || "reference";
 var sourcesOf = (block) => {
   const sources = [...block.sources];
@@ -3182,7 +3207,7 @@ var linksetEntries = (config) => {
   const deployBase = normalizeBasePath(config.deployment.base);
   const abs = (path) => {
     const based = withBasePath(deployBase, path);
-    return site ? `${trimEnd(site, "/")}${based}` : based;
+    return site ? absoluteUrl(site, based) : based;
   };
   const entries = [];
   for (const reference of resolveReferences(config)) {
@@ -3989,7 +4014,11 @@ ${stagedBlock}
 export const collections = { docs${options.staged ? ", staged" : ""} };
 `;
 };
-var askEndpointTemplate = (backend, grounded) => {
+var ASK_FALLBACK_PROMPT = "You are a helpful documentation assistant. Answer using the project's documentation.";
+var askEndpointTemplate = (backend, grounded, instructions) => {
+  const fallbackPrompt = instructions ? `${ASK_FALLBACK_PROMPT}
+
+${instructions}` : ASK_FALLBACK_PROMPT;
   const imports = [
     'import type { APIRoute } from "astro";',
     'import { streamText } from "ai";'
@@ -4015,8 +4044,9 @@ const provider = createOpenAICompatible({
   }
   if (grounded) {
     imports.push('import { createAskContext } from "blume/ai/ask-context.ts";', 'import askData from "../../generated/ask-data.json";');
+    const groundOptions = instructions ? `, { instructions: ${JSON.stringify(instructions)} }` : "";
     setup += `
-const ground = createAskContext(askData);
+const ground = createAskContext(askData${groundOptions});
 `;
   }
   const validate = `  const body = await request.json().catch(() => null);
@@ -4061,7 +4091,7 @@ const ground = createAskContext(askData);
       },`;
   const stream = grounded ? `    const instructions =
       (await ground(messages, body.page)) ??
-      "You are a helpful documentation assistant. Answer using the project's documentation.";
+      ${JSON.stringify(fallbackPrompt)};
     const result = streamText({
       model: ${modelExpr},
       instructions,
@@ -4070,7 +4100,7 @@ ${onError}
     });` : `    const result = streamText({
       model: ${modelExpr},
       instructions:
-        "You are a helpful documentation assistant. Answer using the project's documentation.",
+        ${JSON.stringify(fallbackPrompt)},
       messages,
 ${onError}
     });`;
@@ -4252,7 +4282,7 @@ export function GET({ props }: { props: { route: string } }) {
 var contentAssetsEndpointTemplate = (stagedAssetsDir) => `// Generated by Blume. Do not edit.
 import { existsSync } from "node:fs";
 import { readdir, readFile } from "node:fs/promises";
-import { join, relative, resolve } from "node:path";
+import { isAbsolute, join, relative, resolve } from "node:path";
 import type { APIRoute } from "astro";
 import assets from "../../generated/content-assets.json";
 
@@ -4312,7 +4342,13 @@ const resolveAsset = (asset: string): string | null => {
   const abs = resolve(STAGED_DIR, asset);
   // Traversal guard: the dev server renders on demand, so the param is
   // attacker-controlled there — never step outside the staged directory.
-  if (!abs.startsWith(STAGED_DIR + "/")) {
+  // path.relative rather than a string-prefix test: STAGED_DIR is baked in
+  // with forward slashes while resolve() answers in the platform's
+  // separators, so on Windows the prefix test 404'd every legitimate staged
+  // asset — and a bare prefix also admits a sibling directory that merely
+  // shares the name.
+  const rel = relative(STAGED_DIR, abs);
+  if (rel === "" || rel.startsWith("..") || isAbsolute(rel)) {
     return null;
   }
   return existsSync(abs) ? abs : null;
@@ -4617,8 +4653,11 @@ const frontmatter = entry.data ?? {};
 const seo = frontmatter.seo ?? {};
 const base = data.config.site ? data.config.site.replace(/\\/$/, "") : null;
 
+// Percent-encode the route-derived path (the sitemap convention): a Unicode
+// slug (\`/api/größe\`) is not legal in a raw URI, and crawlers compare
+// canonical against the sitemap's encoded <loc> byte-for-byte.
 const ogPath = data.config.og.enabled
-  ? \`/og/\${route === "/" ? "index" : route.slice(1)}.png\`
+  ? encodeURI(\`/og/\${route === "/" ? "index" : route.slice(1)}.png\`)
   : null;
 const ogRel = seo.image ?? ogPath;
 // Absolute URLs also carry the deployment base (the page is served under it):
@@ -4637,7 +4676,7 @@ const x = { ...data.config.x, ...(seo.x?.creator ? { creator: seo.x.creator } :
 const basedRoute = withBase(route);
 const canonical =
   seo.canonical ??
-  (base ? \`\${base}\${basedRoute === "/" ? "" : basedRoute}\` : null);
+  (base ? \`\${base}\${basedRoute === "/" ? "" : encodeURI(basedRoute)}\` : null);
 
 // Locale resolution. With i18n on, pick the active locale's nav + dictionary,
 // build hreflang alternates, and derive the language-switcher targets.
@@ -5282,6 +5321,21 @@ var visibleText = (element) => {
 
 // src/audit/snapshot.ts
 var CHROME = "nav, aside, header, footer";
+var countWords = (prose, lang) => {
+  let segmenter;
+  try {
+    segmenter = new Intl.Segmenter(lang ?? undefined, { granularity: "word" });
+  } catch {
+    segmenter = new Intl.Segmenter(undefined, { granularity: "word" });
+  }
+  let count = 0;
+  for (const segment of segmenter.segment(prose)) {
+    if (segment.isWordLike) {
+      count += 1;
+    }
+  }
+  return count;
+};
 var CONTENT_ROOTS = ["main", "article", "body"];
 var contentRoot = (document) => {
   for (const selector of CONTENT_ROOTS) {
@@ -5341,6 +5395,7 @@ var buildSnapshot = (options) => {
   const root = contentRoot(document);
   const prose = root ? visibleText(root) : "";
   const robots = document.querySelector('meta[name="robots"]');
+  const lang = attr(document.querySelector("html") ?? document, "lang");
   const { jsonld, jsonldErrors } = collectJsonLd(document);
   return {
     bytes: Buffer.byteLength(html, "utf-8"),
@@ -5361,7 +5416,7 @@ var buildSnapshot = (options) => {
     indexable: !robots?.getAttribute("content")?.includes("noindex"),
     jsonld,
     jsonldErrors,
-    lang: attr(document.querySelector("html") ?? document, "lang"),
+    lang,
     links,
     metaRefresh: document.querySelector('meta[http-equiv="refresh" i]')?.getAttribute("content")?.trim() ?? null,
     og: prefixedMeta(document, "property", "og:"),
@@ -5374,12 +5429,13 @@ var buildSnapshot = (options) => {
     twitter: prefixedMeta(document, "name", "twitter:"),
     url,
     viewport: document.querySelector('meta[name="viewport"]')?.getAttribute("content")?.trim() ?? null,
-    wordCount: prose ? prose.split(/\s+/u).length : 0
+    wordCount: countWords(prose, lang)
   };
 };
 
 // src/audit/crawl.ts
 var EXAMPLES_PREFIX = `${examplesRouteBase("")}/`;
+var CRAWL_CONCURRENCY = 16;
 var fileToUrl = (staticDir, file) => {
   const rel = relative6(staticDir, file).replaceAll("\\", "/");
   const path = rel.replace(/(?:^|\/)index\.html$/u, "").replace(/\.html$/u, "");
@@ -5387,11 +5443,11 @@ var fileToUrl = (staticDir, file) => {
 };
 var indexFiles = async (staticDir) => {
   const found = await glob("**/*", { cwd: staticDir, dot: true });
-  const sized = await Promise.all(found.map(async (file) => {
+  const sized = await pMap2(found, async (file) => {
     const path = `/${file.replaceAll("\\", "/")}`;
     const info = await stat(join9(staticDir, file));
     return [path, info.size];
-  }));
+  }, { concurrency: CRAWL_CONCURRENCY });
   return new Map(sized);
 };
 var routeIndex = (manifest, basePath) => {
@@ -5444,15 +5500,17 @@ var parseSitemap = (file, xml, bytes) => {
 };
 var parseLlms = (file, text) => {
   const entries = [];
-  const link = /\]\((?<url>[^)\s]+)\)/gu;
-  for (const [index, line] of text.split(/\r?\n/u).entries()) {
-    for (const match of line.matchAll(link)) {
-      const url = match.groups?.url;
-      if (url) {
-        entries.push({ line: index + 1, url });
+  const collect = (node) => {
+    if ((node.type === "link" || node.type === "image" || node.type === "definition") && node.url) {
+      entries.push({ line: node.position?.start.line ?? 1, url: node.url });
+    }
+    if ("children" in node) {
+      for (const child of node.children) {
+        collect(child);
       }
     }
-  }
+  };
+  collect(fromMarkdown(text));
   return { entries, file };
 };
 var ROBOTS_DIRECTIVE = /^(?<field>[a-z-]+)\s*:\s*(?<value>.*)$/iu;
@@ -5488,7 +5546,7 @@ var crawlStaticDir = async (options) => {
   const { staticDir, manifest, basePath } = options;
   const routes = routeIndex(manifest, basePath);
   const htmlFiles = await glob("**/*.html", { absolute: true, cwd: staticDir });
-  const snapshots = await Promise.all(htmlFiles.toSorted().map(async (file) => {
+  const snapshots = await pMap2(htmlFiles.toSorted(), async (file) => {
     const url = fileToUrl(staticDir, file);
     if (stripBasePath(basePath, url).startsWith(EXAMPLES_PREFIX)) {
       return null;
@@ -5503,7 +5561,7 @@ var crawlStaticDir = async (options) => {
       route: routes.get(url) ?? routes.get(stripBasePath(basePath, url)),
       url
     });
-  }));
+  }, { concurrency: CRAWL_CONCURRENCY });
   const pages = snapshots.filter((page) => page !== null);
   const sitemapFile = join9(staticDir, "sitemap.xml");
   const sitemapXml = await readIfPresent(sitemapFile);
@@ -5600,17 +5658,18 @@ class NoBuildError extends Error {
     this.staticDir = staticDir;
   }
 }
+var READ_CONCURRENCY = 16;
 var readSources = async (pages) => {
   const paths = [
     ...new Set(pages.flatMap((page) => page.source ? [page.source] : []))
   ];
-  const entries = await Promise.all(paths.map(async (path) => {
+  const entries = await pMap3(paths, async (path) => {
     try {
       return [path, await readFile4(path, "utf-8")];
     } catch {
       return null;
     }
-  }));
+  }, { concurrency: READ_CONCURRENCY });
   return new Map(entries.filter((entry) => entry !== null));
 };
 var matches = (id, terms) => {
@@ -9520,6 +9579,7 @@ var sanitySourceSchema = z2.object({
   type: z2.literal("sanity")
 });
 var notionSourceSchema = z2.object({
+  concurrency: z2.number().positive().optional(),
   database: z2.string(),
   pollInterval: z2.number().positive().optional(),
   prefix: z2.string().optional(),
@@ -9775,6 +9835,7 @@ var aiConfigSchema = z2.strictObject({
     baseUrl: z2.url().optional(),
     enabled: z2.boolean().default(false),
     endpoint: askEndpointSchema.optional(),
+    instructions: z2.string().trim().min(1).optional(),
     model: z2.string().default("openai/gpt-5.5"),
     provider: z2.enum(askAiProviders).default("gateway"),
     suggestions: z2.array(z2.strictObject({
@@ -11232,9 +11293,10 @@ var GROUP_FOLDER2 = /^\((?<label>.+)\)$/u;
 var WORD_SPLIT2 = /[-_]/u;
 var stripNumericPrefix = (segment) => segment.replace(NUMERIC_PREFIX2, "");
 var groupLabel = (segment) => segment.match(GROUP_FOLDER2)?.groups?.label ?? null;
-var slugify2 = (text) => text.toLowerCase().trim().replaceAll(/[^\w\s-]/gu, "").replaceAll(/[\s_]+/gu, "-").replaceAll(/-+/gu, "-").replaceAll(/^-|-$/gu, "");
+var slugify2 = (text) => text.normalize("NFC").toLowerCase().trim().replaceAll(/[^\p{L}\p{M}\p{N}\s_-]/gu, "").replaceAll(/[\s_]+/gu, "-").replaceAll(/-+/gu, "-").replaceAll(/^-|-$/gu, "");
 var slugifyPath = (text) => text.split("/").map(slugify2).filter(Boolean).join("/");
 var titleCase = (value) => value.split(WORD_SPLIT2).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+var sanitizeSegment = (segment) => segment.replaceAll(/[:\p{Cc}]/gu, "");
 var addRouteSegment = (part, segments, groups) => {
   if (part === "") {
     return;
@@ -11248,7 +11310,11 @@ var addRouteSegment = (part, segments, groups) => {
   if (clean === "index") {
     return;
   }
-  segments.push(clean);
+  const safe = sanitizeSegment(clean);
+  if (safe === "") {
+    return;
+  }
+  segments.push(safe);
 };
 var mapRoute = (relativePath) => {
   const withoutExt = relativePath.slice(0, relativePath.length - extname2(relativePath).length);
@@ -11578,15 +11644,10 @@ var normalizeEntry = (entry, ctx) => {
 import { isAbsolute as isAbsolute5, join as join17, resolve as resolve4 } from "pathe";
 
 // src/core/sources/cache.ts
+import { createHash as createHash2 } from "node:crypto";
 import { mkdir as mkdir3, readFile as readFile5, writeFile as writeFile3 } from "node:fs/promises";
 import { join as join11 } from "pathe";
-var hashText = (text) => {
-  let hash = 5381;
-  for (let i = 0;i < text.length; i += 1) {
-    hash = (hash * 33 + (text.codePointAt(i) ?? 0)) % 2147483647;
-  }
-  return hash.toString(36);
-};
+var hashText = (text) => createHash2("sha256").update(text).digest("hex").slice(0, 16);
 var entriesDigest = (entries) => hashText(entries.map((entry) => `${entry.ref}:${entry.hash ?? hashText(entry.body.text)}`).join("|"));
 var pollingWatch = (load2, intervalSeconds, seed) => (onChange) => {
   let last = "";
@@ -11663,9 +11724,6 @@ var loadWithCache = async (name, cache, fetchEntries, refresh = true) => {
 };
 
 // src/openapi/model.ts
-var NON_SLUG2 = /[^a-z0-9]+/gu;
-var SLUG_EDGES = /^-+|-+$/gu;
-var slugify3 = (text) => text.toLowerCase().replace(NON_SLUG2, "-").replace(SLUG_EDGES, "");
 var HTTP_METHODS = [
   "get",
   "put",
@@ -11678,8 +11736,8 @@ var HTTP_METHODS = [
 ];
 var UNTAGGED = "Operations";
 var operationKey = (method, path, operationId) => {
-  const fromId = operationId ? slugify3(operationId) : "";
-  return fromId || slugify3(`${method}-${path}`);
+  const fromId = operationId ? slugify(operationId) : "";
+  return fromId || slugify(`${method}-${path}`);
 };
 var isOperation = (value) => typeof value === "object" && value !== null;
 var tagSlugger = () => {
@@ -11690,7 +11748,7 @@ var tagSlugger = () => {
     if (existing) {
       return existing;
     }
-    const base = slugify3(name) || "operations";
+    const base = slugify(name) || "operations";
     let slug = base;
     for (let suffix = 2;taken.has(slug); suffix += 1) {
       slug = `${base}-${suffix}`;
@@ -11759,6 +11817,7 @@ var extractOperations = (document, baseRoute) => {
 import { mkdir as mkdir4, readFile as readFile6, writeFile as writeFile4 } from "node:fs/promises";
 import { setTimeout as sleep } from "node:timers/promises";
 import { normalize as normalize2, upgrade } from "@scalar/openapi-parser";
+import pRetry, { AbortError } from "p-retry";
 import { isAbsolute as isAbsolute3, join as join12 } from "pathe";
 var URL_SPEC = /^https?:\/\//u;
 var FETCH_TIMEOUT_MS = 15000;
@@ -11796,8 +11855,15 @@ var ensureProxyDispatcher = async () => {
 };
 var retryAfterMs = (response) => {
   const header = response.headers.get("retry-after");
-  const seconds = header ? Number(header) : Number.NaN;
-  return Number.isFinite(seconds) && seconds > 0 ? seconds * SECOND_MS : undefined;
+  if (!header) {
+    return;
+  }
+  const seconds = Number(header);
+  if (Number.isFinite(seconds)) {
+    return seconds > 0 ? seconds * SECOND_MS : undefined;
+  }
+  const delta = Date.parse(header) - Date.now();
+  return Number.isFinite(delta) && delta > 0 ? delta : undefined;
 };
 var attemptFetch = async (spec) => {
   try {
@@ -11824,25 +11890,37 @@ var attemptFetch = async (spec) => {
     };
   }
 };
+var retryableFetchError = (error, retryAfter) => {
+  const wrapper = new Error(error.message, {
+    cause: error
+  });
+  wrapper.name = "RetryableFetchError";
+  wrapper.retryAfter = retryAfter;
+  return wrapper;
+};
 var fetchSpecText = async (spec) => {
   await ensureProxyDispatcher();
-  let last = {
-    error: new Error(`Could not fetch ${spec}`),
-    retryable: false
-  };
-  for (let attempt = 0;attempt < MAX_ATTEMPTS; attempt += 1) {
-    last = await attemptFetch(spec);
-    if ("text" in last) {
-      return last.text;
-    }
-    if (!last.retryable) {
-      break;
-    }
-    if (attempt < MAX_ATTEMPTS - 1) {
-      await sleep(Math.min(last.retryAfter ?? BASE_BACKOFF_MS * 2 ** attempt, MAX_RETRY_WAIT_MS));
-    }
-  }
-  throw last.error;
+  return await pRetry(async () => {
+    const attempt = await attemptFetch(spec);
+    if ("text" in attempt) {
+      return attempt.text;
+    }
+    if (!attempt.retryable) {
+      throw new AbortError(attempt.error);
+    }
+    throw retryableFetchError(attempt.error, attempt.retryAfter);
+  }, {
+    factor: 2,
+    maxTimeout: MAX_RETRY_WAIT_MS,
+    minTimeout: BASE_BACKOFF_MS,
+    onFailedAttempt: async (context) => {
+      const { retryAfter } = context.error;
+      if (retryAfter !== undefined && context.retriesLeft > 0) {
+        await sleep(Math.max(0, Math.min(retryAfter, MAX_RETRY_WAIT_MS) - context.retryDelay));
+      }
+    },
+    retries: MAX_ATTEMPTS - 1
+  });
 };
 var cacheFileFor = (cacheDir, spec) => join12(cacheDir, `spec-${hashText(spec)}.cache`);
 var readCache = async (file) => {
@@ -11902,6 +11980,8 @@ var parseSpec = async (spec, root, options = {}) => {
 };
 
 // src/openapi/render-mdx.ts
+import { fromMarkdown as fromMarkdown2 } from "mdast-util-from-markdown";
+import { toString as mdastToString } from "mdast-util-to-string";
 var MDX_UNSAFE = /[<{}]/gu;
 var ENTITIES = {
   "<": "&lt;",
@@ -11909,26 +11989,46 @@ var ENTITIES = {
   "}": "&#125;"
 };
 var MDX_ESM_KEYWORD = /^(?<keyword>import|export)\b/gmu;
-var BACKTICK_CODE = /(?<!`)(?<bt>`+)(?!`)[\s\S]*?(?<!`)\k<bt>(?!`)/gu;
 var escapeProse = (text) => text.replace(MDX_UNSAFE, (char) => ENTITIES[char] ?? char).replace(MDX_ESM_KEYWORD, (keyword) => `&#${keyword.codePointAt(0)};${keyword.slice(1)}`);
+var codeSpans = (text) => {
+  const spans = [];
+  const collect = (node) => {
+    if (node.type === "inlineCode" || node.type === "code") {
+      const start = node.position?.start.offset ?? -1;
+      const end = node.position?.end.offset ?? -1;
+      const head = text.slice(Math.max(start, 0), Math.max(end, 0)).trimStart();
+      if (start >= 0 && (node.type === "inlineCode" || head.startsWith("`") || head.startsWith("~"))) {
+        spans.push([start, end]);
+      }
+      return;
+    }
+    if ("children" in node) {
+      for (const child of node.children) {
+        collect(child);
+      }
+    }
+  };
+  collect(fromMarkdown2(text));
+  return spans;
+};
 var mdxSafe = (text) => {
   let out = "";
   let cursor = 0;
-  for (const match of text.matchAll(BACKTICK_CODE)) {
-    const start = match.index ?? 0;
+  for (const [start, end] of codeSpans(text)) {
     out += escapeProse(text.slice(cursor, start));
-    out += match[0];
-    cursor = start + match[0].length;
+    out += text.slice(start, end);
+    cursor = end;
   }
   return out + escapeProse(text.slice(cursor));
 };
 var META_DESCRIPTION_MAX = 160;
-var PARAGRAPH_BREAK = /\n\s*\n/u;
-var MARKDOWN_LINK = /\[(?<text>[^\]]*)\]\([^)]*\)/gu;
-var MARKDOWN_MARKS = /[*_`#>]/gu;
 var WHITESPACE = /\s+/gu;
 var TRAILING_WORD = /\s+\S*$/u;
-var plainProse = (markdown) => (markdown.trim().split(PARAGRAPH_BREAK).at(0) ?? "").replace(MARKDOWN_LINK, "$<text>").replace(MARKDOWN_MARKS, "").replace(WHITESPACE, " ").trim();
+var plainProse = (markdown) => {
+  const tree = fromMarkdown2(markdown);
+  const first = tree.children.find((node) => node.type === "paragraph") ?? tree.children[0];
+  return first ? mdastToString(first).replace(WHITESPACE, " ").trim() : "";
+};
 var clip = (text, max) => {
   if (max <= 0) {
     return "";
@@ -12047,6 +12147,13 @@ var specEntries = (spec, operations, reference) => {
   entries.push(toEntry(overviewMdx(spec, reference), base ? `${base}/index.mdx` : "index.mdx"));
   return entries;
 };
+var tagFolderMeta = (spec, tags) => {
+  const base = routeToRef(spec.route);
+  return Object.fromEntries(tags.map((tag) => [
+    base ? `${base}/${tag.slug}` : tag.slug,
+    { title: tag.name }
+  ]));
+};
 var openApiSource = (references, ctx) => {
   let parsed = {};
   const loadReference = async (reference) => {
@@ -12099,6 +12206,7 @@ var openApiSource = (references, ctx) => {
           ] : []
         ],
         entries: specEntries(spec, operations, reference),
+        folderMeta: tagFolderMeta(spec, tags),
         slug: reference.slug,
         spec
       };
@@ -12120,6 +12228,7 @@ var openApiSource = (references, ctx) => {
       severity: "warning"
     })));
     const data = {};
+    const folderMeta = {};
     for (const result of results) {
       if ("severity" in result) {
         diagnostics.push(result);
@@ -12127,10 +12236,11 @@ var openApiSource = (references, ctx) => {
       }
       data[result.slug] = result.spec;
       entries.push(...result.entries);
+      Object.assign(folderMeta, result.folderMeta);
       diagnostics.push(...result.diagnostics);
     }
     parsed = data;
-    return { diagnostics, entries };
+    return { diagnostics, entries, folderMeta };
   };
   return {
     kind: "openapi-source",
@@ -12206,15 +12316,15 @@ var filesystemSource = (options) => {
 };
 
 // src/core/sources/github-releases.ts
-import { fromMarkdown } from "mdast-util-from-markdown";
+import { fromMarkdown as fromMarkdown3 } from "mdast-util-from-markdown";
 import { gfmFromMarkdown } from "mdast-util-gfm";
-import { toString as mdastToString } from "mdast-util-to-string";
+import { toString as mdastToString2 } from "mdast-util-to-string";
 import { gfm } from "micromark-extension-gfm";
 var DEFAULT_BASE_URL = "https://api.github.com";
 var DEFAULT_LIMIT = 100;
 var PER_PAGE = 100;
 var LEADING_V = /^v/iu;
-var NON_SLUG3 = /[^a-z0-9]+/gu;
+var NON_SLUG2 = /[^a-z0-9]+/gu;
 var EDGE_DASHES = /^-+|-+$/gu;
 var DESCRIPTION_MAX = 160;
 var DESCRIPTION_MIN = 110;
@@ -12222,24 +12332,35 @@ var CHANGESET_HASH = /^(?<mark>\s*(?:[-*+]|\d+[.)])\s+)[0-9a-f]{7,40}:\s+/gmu;
 var WHITESPACE2 = /\s+/gu;
 var TRAILING_FRAGMENT = /[\s,;:.—–-]+$/u;
 var NON_PROSE = new Set(["code", "heading", "html", "thematicBreak"]);
+var graphemePrefix = (text, max) => {
+  let end = 0;
+  const graphemes = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+  for (const { index, segment } of graphemes.segment(text)) {
+    if (index + segment.length > max) {
+      break;
+    }
+    end = index + segment.length;
+  }
+  return text.slice(0, end);
+};
 var releaseDescription = (body) => {
-  const tree = fromMarkdown(body.replaceAll(CHANGESET_HASH, "$<mark>"), {
+  const tree = fromMarkdown3(body.replaceAll(CHANGESET_HASH, "$<mark>"), {
     extensions: [gfm()],
     mdastExtensions: [gfmFromMarkdown()]
   });
-  const text = tree.children.filter((node) => !NON_PROSE.has(node.type)).map((node) => mdastToString(node, { includeHtml: false, includeImageAlt: false })).join(" ").replaceAll(WHITESPACE2, " ").trim();
+  const text = tree.children.filter((node) => !NON_PROSE.has(node.type)).map((node) => mdastToString2(node, { includeHtml: false, includeImageAlt: false })).join(" ").replaceAll(WHITESPACE2, " ").trim();
   if (!text) {
     return;
   }
   if (text.length <= DESCRIPTION_MAX) {
     return text;
   }
-  const slice = text.slice(0, DESCRIPTION_MAX - 1);
+  const slice = graphemePrefix(text, DESCRIPTION_MAX - 1);
   const boundary = slice.lastIndexOf(" ");
   const head = (boundary >= DESCRIPTION_MIN ? slice.slice(0, boundary) : slice).replace(TRAILING_FRAGMENT, "");
   return `${head}…`;
 };
-var slugifyTag = (tag) => tag.toLowerCase().replaceAll(NON_SLUG3, "-").replaceAll(EDGE_DASHES, "");
+var slugifyTag = (tag) => tag.toLowerCase().replaceAll(NON_SLUG2, "-").replaceAll(EDGE_DASHES, "");
 var githubHeaders = () => {
   const headers = new Headers({ Accept: "application/vnd.github+json" });
   const token = process.env.GITHUB_TOKEN;
@@ -12492,6 +12613,7 @@ var mdxRemoteSource = (options, ctx) => {
 
 // src/core/sources/notion.ts
 import { setTimeout as sleep2 } from "node:timers/promises";
+import pLimit from "p-limit";
 import { join as join15 } from "pathe";
 
 // src/core/sources/assets.ts
@@ -12571,6 +12693,7 @@ var RATE_LIMITED = 429;
 var MAX_RETRIES = 4;
 var BASE_DELAY_MS = 500;
 var SECOND_MS2 = 1000;
+var DEFAULT_CONCURRENCY = 3;
 var withNotionRetry = async (call, attempt = 0) => {
   try {
     return await call();
@@ -12580,7 +12703,7 @@ var withNotionRetry = async (call, attempt = 0) => {
       throw error;
     }
     const retryAfter = Number(error.headers?.["retry-after"]);
-    const wait = retryAfter > 0 ? retryAfter * SECOND_MS2 : BASE_DELAY_MS * 2 ** attempt;
+    const wait = retryAfter > 0 ? retryAfter * SECOND_MS2 : BASE_DELAY_MS * 2 ** attempt * (1 + Math.random());
     await sleep2(wait);
     return withNotionRetry(call, attempt + 1);
   }
@@ -12644,6 +12767,8 @@ ${text}
 };
 var notionSource = (options, ctx) => {
   const props = options.properties ?? {};
+  const limit = pLimit(Math.max(1, options.concurrency ?? DEFAULT_CONCURRENCY));
+  const notionCall = (call) => withNotionRetry(() => limit(call));
   const cache = snapshotCache(ctx?.cacheDir ?? join15(".blume", "cache", options.name));
   const assetsDir = ctx?.assetsDir ?? join15(".blume", "public", "blume-assets", options.name);
   const assetsBaseUrl = ctx?.assetsBaseUrl ?? `/blume-assets/${options.name}`;
@@ -12664,7 +12789,7 @@ var notionSource = (options, ctx) => {
     }
     return new Client({ auth: options.token ?? process.env.NOTION_TOKEN });
   };
-  const childrenOf = (client, blockId) => collectAll((cursor) => withNotionRetry(() => client.blocks.children.list({ block_id: blockId, start_cursor: cursor })));
+  const childrenOf = (client, blockId) => collectAll((cursor) => notionCall(() => client.blocks.children.list({ block_id: blockId, start_cursor: cursor })));
   const renderContainer = async (client, block, render) => {
     const children = async (target) => {
       if (!target.has_children) {
@@ -12797,7 +12922,7 @@ ${nested}`;
       }
     };
   };
-  const queryDatabase = (client, cursor) => withNotionRetry(() => client.databases.query({
+  const queryDatabase = (client, cursor) => notionCall(() => client.databases.query({
     database_id: options.database,
     start_cursor: cursor
   }));
@@ -12848,8 +12973,11 @@ var HEADING_STYLES = {
   h5: "##### ",
   h6: "###### "
 };
+var MARKDOWN_SPECIALS = /[\\`*_[\]~<]/gu;
+var escapeText = (text) => text.replaceAll(MARKDOWN_SPECIALS, String.raw`\$&`);
 var renderSpan = (span, defs) => {
-  let text = span.text ?? "";
+  const isCode = span.marks?.includes("code") ?? false;
+  let text = isCode ? span.text ?? "" : escapeText(span.text ?? "");
   if (!span.marks || span.marks.length === 0) {
     return text;
   }
@@ -13086,6 +13214,7 @@ var buildSource = (def, name, context, runtime) => {
   }
   if (def.type === "notion") {
     return notionSource({
+      concurrency: def.concurrency,
       database: def.database,
       name,
       pollInterval: def.pollInterval,
@@ -13260,6 +13389,10 @@ var scanProject = async (root, options = {}) => {
     Promise.all(sources.map(async (source) => ({ source, ...await source.load() }))),
     discoverFolderMeta(metaSources, { localeDirs })
   ]);
+  const sharedFolderMeta = new Map([
+    ...loaded.flatMap(({ folderMeta: sourceMeta }) => Object.entries(sourceMeta ?? {})),
+    ...folderMeta.shared
+  ]);
   const {
     diagnostics: contentDiagnostics,
     droppedPages,
@@ -13282,7 +13415,7 @@ var scanProject = async (root, options = {}) => {
     folderMeta: folderMeta.meta,
     i18n: config.i18n,
     navigation: config.navigation,
-    sharedFolderMeta: folderMeta.shared
+    sharedFolderMeta
   });
   const manifest = buildManifest({ config, context, graph });
   const i18nWarnings = config.i18n ? i18nDiagnostics(pages, config.i18n) : [];
@@ -13345,14 +13478,16 @@ var shouldFail = (result, gate) => {
   const failing = failingSeverities(gate);
   return result.diagnostics.some((d) => failing.has(d.severity));
 };
-var launchAgentCode = async (bin, prompt) => {
+var launchAgentCode = async (agent, prompt) => {
+  const cli = AGENTS[agent];
   try {
-    return await launchAgent(bin, prompt);
+    return await launchAgent(cli.bin, prompt);
   } catch (error) {
     if (error?.code !== "ENOENT") {
       throw error;
     }
-    return WINDOWS_COMMAND_NOT_FOUND;
+    logger.error(`${cli.name} (\`${cli.bin}\`) was not found on PATH. Install it with \`${cli.install}\`.`);
+    return process.exit(1);
   }
 };
 var auditCommand = defineCommand2({
@@ -13460,11 +13595,7 @@ var auditCommand = defineCommand2({
       process.stderr.write(`  Handing ${count} finding${count === 1 ? "" : "s"} to ${cli.name}…
 
 `);
-      const code = await launchAgentCode(cli.bin, fixPrompt(report));
-      if (code === WINDOWS_COMMAND_NOT_FOUND) {
-        logger.error(`${cli.name} (\`${cli.bin}\`) was not found on PATH. Install it with \`${cli.install}\`.`);
-        process.exit(1);
-      }
+      const code = await launchAgentCode(agent, fixPrompt(report));
       if (code !== 0) {
         process.exit(code);
       }
@@ -13510,7 +13641,7 @@ var buildRssFeeds = (project) => {
   if (!(rss.enabled && site)) {
     return [];
   }
-  const base = site.replace(/\/$/u, "");
+  const base = siteRoot(site);
   const deployBase = normalizeBasePath(config.deployment.base);
   const rootLink = `${base}${deployBase}`;
   const feeds = [];
@@ -13590,7 +13721,7 @@ var askApiUrl = (endpoint, site, abs) => {
   if (!endpoint) {
     return abs("/api/ask");
   }
-  return site && endpoint.startsWith("/") ? `${site.replace(/\/+$/u, "")}${endpoint}` : endpoint;
+  return site && endpoint.startsWith("/") ? absoluteUrl(site, endpoint) : endpoint;
 };
 var wellKnownArtifacts = (config, abs) => {
   const artifacts = {};
@@ -13614,7 +13745,7 @@ var buildAgentReadability = (project) => {
   const deployBase = normalizeBasePath(config.deployment.base);
   const abs = (path) => {
     const based = withBasePath(deployBase, path);
-    return site ? `${site.replace(/\/+$/u, "")}${based}` : based;
+    return site ? absoluteUrl(site, based) : based;
   };
   const negotiates = config.deployment.output === "server" && (config.deployment.adapter === "vercel" || config.deployment.adapter === "cloudflare");
   const artifacts = {
@@ -14079,7 +14210,7 @@ var applyAgentVisibility = (markdown) => applyAudienceVisibility(markdown, "agen
 // src/ai/llms.ts
 var pageUrl = (route, site, base = "") => {
   const path = withBasePath(base, route);
-  return encodeURI(site ? `${site.replace(/\/$/u, "")}${path}` : path);
+  return encodeURI(site ? absoluteUrl(site, path) : path);
 };
 var eligiblePages = (project) => project.graph.pages.filter((page) => !(page.meta.ai.exclude || page.meta.draft || page.meta.sidebar.hidden || page.meta.seo.noindex && page.source.name !== "openapi") && (project.config.ai.llmsTxt.openapi || page.source.name !== "openapi"));
 var indexedNavigations = (project) => {
@@ -14253,49 +14384,16 @@ var markdownRoutePaths = (project) => {
 };
 
 // src/ai/skills.ts
-import { createHash as createHash2 } from "node:crypto";
+import { createHash as createHash3 } from "node:crypto";
 import { readdir, readFile as readFile11, stat as stat2 } from "node:fs/promises";
 import { join as join18 } from "pathe";
 
 // src/ai/tar.ts
 import { gzipSync } from "node:zlib";
-var BLOCK = 512;
+import { createTar } from "nanotar";
 var NAME_MAX = 100;
 var encoder = new TextEncoder;
-var octal = (header, offset, length, value) => {
-  const text = value.toString(8).padStart(length - 1, "0");
-  header.set(encoder.encode(text), offset);
-  header[offset + length - 1] = 0;
-};
-var text = (header, offset, value) => {
-  header.set(encoder.encode(value), offset);
-};
-var fileHeader = (entry) => {
-  const header = new Uint8Array(BLOCK);
-  text(header, 0, entry.path);
-  octal(header, 100, 8, entry.executable ? 493 : 420);
-  octal(header, 108, 8, 0);
-  octal(header, 116, 8, 0);
-  octal(header, 124, 12, entry.content.byteLength);
-  octal(header, 136, 12, 0);
-  text(header, 156, "0");
-  text(header, 257, "ustar");
-  header[262] = 0;
-  text(header, 263, "00");
-  octal(header, 329, 8, 0);
-  octal(header, 337, 8, 0);
-  header.fill(32, 148, 156);
-  let sum = 0;
-  for (const byte of header) {
-    sum += byte;
-  }
-  text(header, 148, sum.toString(8).padStart(6, "0"));
-  header[154] = 0;
-  header[155] = 32;
-  return header;
-};
 var buildTarGz = (entries) => {
-  const blocks = [];
   for (const entry of entries) {
     if (encoder.encode(entry.path).byteLength > NAME_MAX) {
       throw new Error(`tar path exceeds ${NAME_MAX} bytes: ${entry.path}`);
@@ -14303,20 +14401,19 @@ var buildTarGz = (entries) => {
     if (entry.path.startsWith("/") || entry.path.split("/").includes("..")) {
       throw new Error(`tar path must be archive-relative: ${entry.path}`);
     }
-    blocks.push(fileHeader(entry), entry.content);
-    const overhang = entry.content.byteLength % BLOCK;
-    if (overhang > 0) {
-      blocks.push(new Uint8Array(BLOCK - overhang));
-    }
-  }
-  blocks.push(new Uint8Array(BLOCK * 2));
-  const total = blocks.reduce((sum, block) => sum + block.byteLength, 0);
-  const tar = new Uint8Array(total);
-  let offset = 0;
-  for (const block of blocks) {
-    tar.set(block, offset);
-    offset += block.byteLength;
   }
+  const tar = createTar(entries.map((entry) => ({
+    attrs: {
+      gid: 0,
+      group: "",
+      mode: entry.executable ? "755" : "644",
+      mtime: 0,
+      uid: 0,
+      user: ""
+    },
+    data: entry.content,
+    name: entry.path
+  })));
   return new Uint8Array(gzipSync(tar, { level: 9 }));
 };
 
@@ -14326,7 +14423,7 @@ var AGENT_SKILLS_SCHEMA = "https://schemas.agentskills.io/discovery/0.2.0/schema
 var SKILL_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
 var SKILL_NAME_MAX = 64;
 var DESCRIPTION_MAX2 = 1024;
-var sha256 = (content) => `sha256:${createHash2("sha256").update(content).digest("hex")}`;
+var sha256 = (content) => `sha256:${createHash3("sha256").update(content).digest("hex")}`;
 var collectEntries = async (dir, prefix = "") => {
   const entries = [];
   const items = await readdir(dir, { withFileTypes: true });
@@ -14587,6 +14684,20 @@ const redirectFor = (pathname) => {
   return Object.hasOwn(REDIRECTS, path) ? REDIRECTS[path] : null;
 };
 
+// \`_redirects\` semantics, which the static layer applies to these same
+// paths: the request's query string is forwarded unless the destination
+// carries its own, and a destination fragment stays after the query.
+const redirectLocation = (destination, search) => {
+  const hashIndex = destination.indexOf("#");
+  const bare = hashIndex === -1 ? destination : destination.slice(0, hashIndex);
+  if (!search || bare.includes("?")) {
+    return destination;
+  }
+  return hashIndex === -1
+    ? bare + search
+    : bare + search + destination.slice(hashIndex);
+};
+
 const parseAccept = (accept) =>
   accept.split(",").map((part) => {
     const segments = part.trim().split(";");
@@ -14666,7 +14777,7 @@ export default {
     const redirect = redirectFor(url.pathname);
     if (redirect !== null) {
       return new Response(null, {
-        headers: { location: redirect[0] },
+        headers: { location: redirectLocation(redirect[0], url.search) },
         status: redirect[1],
       });
     }
@@ -14839,7 +14950,7 @@ var buildRobots = (project) => {
   const { site } = config.deployment;
   if (site && config.seo.sitemap) {
     const sitemapPath = withBasePath(normalizeBasePath(config.deployment.base), "/sitemap.xml");
-    lines.push("", `Sitemap: ${site.replace(/\/$/u, "")}${sitemapPath}`);
+    lines.push("", `Sitemap: ${absoluteUrl(site, sitemapPath)}`);
   }
   return `${lines.join(`
 `)}
@@ -14934,12 +15045,19 @@ var lastmodTag = (value) => {
   const date = new Date(value);
   return Number.isNaN(date.getTime()) ? "" : `<lastmod>${date.toISOString().slice(0, 10)}</lastmod>`;
 };
-var buildSitemap = (project) => {
+var URLS_PER_FILE = 50000;
+var renderUrlset = (urls) => `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urls.join(`
+`)}
+</urlset>
+`;
+var buildSitemapFiles = (project) => {
   const { site } = project.config.deployment;
   if (!(site && project.config.seo.sitemap)) {
     return null;
   }
-  const base = site.replace(/\/$/u, "");
+  const base = siteRoot(site);
   const deployBase = normalizeBasePath(project.config.deployment.base);
   const seen = new Set;
   const urls = [];
@@ -14966,12 +15084,27 @@ var buildSitemap = (project) => {
     pushUrl(withBasePath(deployBase, route));
   }
   urls.sort();
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-${urls.join(`
+  if (urls.length <= URLS_PER_FILE) {
+    return [{ name: "sitemap.xml", xml: renderUrlset(urls) }];
+  }
+  const chunks = [];
+  const references = [];
+  for (let start = 0;start < urls.length; start += URLS_PER_FILE) {
+    const name = `sitemap-${chunks.length + 1}.xml`;
+    chunks.push({
+      name,
+      xml: renderUrlset(urls.slice(start, start + URLS_PER_FILE))
+    });
+    const loc = escapeXml2(encodeURI(`${base}${withBasePath(deployBase, `/${name}`)}`));
+    references.push(`  <sitemap><loc>${loc}</loc></sitemap>`);
+  }
+  const index = `<?xml version="1.0" encoding="UTF-8"?>
+<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${references.join(`
 `)}
-</urlset>
+</sitemapindex>
 `;
+  return [{ name: "sitemap.xml", xml: index }, ...chunks];
 };
 
 // src/deploy/vercel-negotiation.ts
@@ -15081,6 +15214,11 @@ var buildSearchIndex = async (outDir) => {
   return result.page_count;
 };
 
+// src/search/documents.ts
+import { fromMarkdown as fromMarkdown4 } from "mdast-util-from-markdown";
+import { gfmFromMarkdown as gfmFromMarkdown2 } from "mdast-util-gfm";
+import { gfm as gfm2 } from "micromark-extension-gfm";
+
 // src/search/facets.ts
 var pageFacets = (page, config) => {
   const declared = config.content.types[page.contentType]?.facets;
@@ -15098,25 +15236,60 @@ var pageFacets = (page, config) => {
 };
 
 // src/search/documents.ts
-var CODE_FENCE2 = /```[\s\S]*?```/gu;
-var INLINE_CODE2 = /`(?<code>[^`]+)`/gu;
 var HTML_OR_JSX = /<\/?[a-zA-Z][^\n<>]*>|<\/?>/gu;
-var IMAGE = /!\[[^\]]*\]\([^)]*\)/gu;
-var LINK = /\[(?<text>[^\]]*)\]\([^)]*\)/gu;
-var HEADING_MARK = /^#{1,6}\s+/gmu;
-var MARKDOWN_PUNCT = /[*_~>]+/gu;
 var WHITESPACE3 = /\s+/gu;
-var toPlainText = (markdown) => {
-  const withoutBlocks = markdown.replaceAll(CODE_FENCE2, " ").replaceAll(IMAGE, " ").replaceAll(LINK, "$<text>");
-  const pieces = [];
-  let cursor = 0;
-  for (const match of withoutBlocks.matchAll(INLINE_CODE2)) {
-    const start = match.index ?? 0;
-    pieces.push(withoutBlocks.slice(cursor, start).replaceAll(HTML_OR_JSX, " "), match.groups?.code ?? "");
-    cursor = start + match[0].length;
+var INLINE_PARENTS = new Set([
+  "delete",
+  "emphasis",
+  "footnoteReference",
+  "link",
+  "linkReference",
+  "strong"
+]);
+var collectText = (node, out) => {
+  switch (node.type) {
+    case "code":
+    case "image":
+    case "imageReference": {
+      return;
+    }
+    case "inlineCode": {
+      out.push(node.value);
+      return;
+    }
+    case "html": {
+      out.push(node.value.replaceAll(HTML_OR_JSX, " "));
+      return;
+    }
+    case "break": {
+      out.push(" ");
+      return;
+    }
+    default: {
+      break;
+    }
+  }
+  if ("value" in node) {
+    out.push(node.value);
+    return;
+  }
+  if ("children" in node) {
+    for (const child of node.children) {
+      collectText(child, out);
+    }
+    if (!INLINE_PARENTS.has(node.type)) {
+      out.push(" ");
+    }
   }
-  pieces.push(withoutBlocks.slice(cursor).replaceAll(HTML_OR_JSX, " "));
-  return pieces.join("").replaceAll(HEADING_MARK, "").replaceAll(MARKDOWN_PUNCT, " ").replaceAll(WHITESPACE3, " ").trim();
+};
+var toPlainText = (markdown) => {
+  const tree = fromMarkdown4(markdown, {
+    extensions: [gfm2()],
+    mdastExtensions: [gfmFromMarkdown2()]
+  });
+  const out = [];
+  collectText(tree, out);
+  return out.join("").replaceAll(WHITESPACE3, " ").trim();
 };
 var buildCrumbIndex = (sidebar) => {
   const index = new Map;
@@ -15436,7 +15609,7 @@ var refuseIfDevRunning = (root, action, options = {}) => {
 };
 
 // src/astro/generate.ts
-import { createHash as createHash3 } from "node:crypto";
+import { createHash as createHash4 } from "node:crypto";
 import { existsSync as existsSync16, readFileSync as readFileSync8, realpathSync } from "node:fs";
 import {
   lstat,
@@ -15449,6 +15622,8 @@ import {
 } from "node:fs/promises";
 import { createRequire as createRequire4 } from "node:module";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
+import { imageSize as imageSize2 } from "image-size";
+import pMap6 from "p-map";
 import { basename as basename3, dirname as dirname11, join as join28, normalize as normalize3, relative as relative14, resolve as resolve8 } from "pathe";
 import { glob as glob7 } from "tinyglobby";
 
@@ -15557,7 +15732,7 @@ var MCP_TOOLS = [
 // src/ai/mcp/discovery.ts
 var serverUrl = (input) => {
   const path = withBasePath(input.base, input.route);
-  return input.site ? `${trimEnd(input.site, "/")}${path}` : path;
+  return input.site ? absoluteUrl(input.site, path) : path;
 };
 var buildMcpDiscovery = (input) => ({
   servers: [
@@ -15570,7 +15745,10 @@ var buildMcpDiscovery = (input) => ({
 });
 var SERVER_CARD_SCHEMA = "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json";
 var CARD_TEXT_MAX = 100;
-var truncate = (text2) => text2.length > CARD_TEXT_MAX ? `${text2.slice(0, CARD_TEXT_MAX - 1)}…` : text2;
+var truncate = (text) => text.length > CARD_TEXT_MAX ? `${text.slice(0, CARD_TEXT_MAX - 1)}…` : text;
+var NON_ASCII_SLUG = /[^a-z0-9]+/gu;
+var COMBINING_MARKS = /\p{M}+/gu;
+var asciiSlugify = (text) => trimChar(text.normalize("NFKD").replace(COMBINING_MARKS, "").toLowerCase().replace(NON_ASCII_SLUG, "-"), "-");
 var reverseDnsName = (input) => {
   let namespace = "localhost";
   if (input.site) {
@@ -15578,7 +15756,7 @@ var reverseDnsName = (input) => {
       namespace = new URL(input.site).hostname.split(".").toReversed().join(".");
     } catch {}
   }
-  return `${namespace}/${slugify(input.name) || "docs"}`;
+  return `${namespace}/${asciiSlugify(input.name) || "docs"}`;
 };
 var HTTP_URL2 = /^https?:\/\//u;
 var buildMcpServerCard = (input) => {
@@ -15601,7 +15779,7 @@ var buildMcpServerCard = (input) => {
     transports: [{ endpoint: url, type: "streamable-http" }],
     url,
     version: input.version,
-    ...input.site ? { websiteUrl: trimEnd(input.site, "/") } : {}
+    ...input.site ? { websiteUrl: siteRoot(input.site) } : {}
   };
 };
 
@@ -15936,9 +16114,9 @@ var analyzeComponentOverrides = (source, filePath) => {
 import { mkdir as mkdir6 } from "node:fs/promises";
 import { dirname as dirname9 } from "pathe";
 import writeFileAtomic from "write-file-atomic";
-var writeTextAtomic = async (path, text2) => {
+var writeTextAtomic = async (path, text) => {
   await mkdir6(dirname9(path), { recursive: true });
-  await writeFileAtomic(path, text2, { encoding: "utf-8", fsync: false });
+  await writeFileAtomic(path, text, { encoding: "utf-8", fsync: false });
 };
 
 // src/core/tsconfig-aliases.ts
@@ -16185,9 +16363,8 @@ ${dark}`;
 
 // src/openapi/scalar.ts
 var URL_SPEC2 = /^https?:\/\//u;
-var ROUTE_EDGES = /^\/+|\/+$/gu;
 var referencePagePath = (route) => {
-  const segments = route.replace(ROUTE_EDGES, "");
+  const segments = trimChar(route, "/");
   return `${segments === "" ? "index" : segments}.astro`;
 };
 var darkModeConfig = (mode) => {
@@ -17229,14 +17406,17 @@ export const layoutOverrides = { ...(overrides.layout ?? {})${layoutEntries.leng
 
 // src/astro/examples.ts
 import { readFile as readFile15 } from "node:fs/promises";
+import pMap5 from "p-map";
 import { join as join27, relative as relative13 } from "pathe";
 import { glob as glob6 } from "tinyglobby";
 
 // src/astro/islands.ts
 import { readFile as readFile14 } from "node:fs/promises";
+import pMap4 from "p-map";
 import { basename as basename2, join as join26 } from "pathe";
 import { glob as glob5 } from "tinyglobby";
 var DEFAULT_CLIENT = "visible";
+var READ_CONCURRENCY2 = 16;
 var VALID_MODES = new Set([
   "idle",
   "load",
@@ -17270,7 +17450,9 @@ var discoverIslands = async (root) => {
     onlyFiles: true
   });
   const files = matches2.toSorted();
-  const sources = await Promise.all(files.map((file) => readFile14(file, "utf-8")));
+  const sources = await pMap4(files, (file) => readFile14(file, "utf-8"), {
+    concurrency: READ_CONCURRENCY2
+  });
   const islands = [];
   const warnings = [];
   const seen = new Map;
@@ -17315,6 +17497,7 @@ var FRAMEWORK_BY_EXT3 = {
 };
 var EXAMPLE_FILE = /\.(?<ext>astro|jsx|svelte|tsx|vue)$/u;
 var DEFAULT_EXAMPLE_GLOB = "**/*.{astro,jsx,svelte,tsx,vue}";
+var READ_CONCURRENCY3 = 16;
 var GLOB_MAGIC = /[!*?[\]{}]/u;
 var splitGlobBase = (pattern) => {
   const segments = pattern.split("/");
@@ -17333,7 +17516,9 @@ var discoverExamples = async (root, pattern = "examples") => {
     onlyFiles: true
   });
   const files = matches2.toSorted();
-  const sources = await Promise.all(files.map((file) => readFile15(file, "utf-8")));
+  const sources = await pMap5(files, (file) => readFile15(file, "utf-8"), {
+    concurrency: READ_CONCURRENCY3
+  });
   const examples = [];
   const warnings = [];
   const seen = new Map;
@@ -17542,6 +17727,18 @@ var searchProviderWarnings = (provider, root, pkgDir = packageRoot()) => {
   }
   return warnings;
 };
+var askProviderWarnings = (ask, root, pkgDir = packageRoot()) => {
+  if (!ask?.enabled || ask.endpoint) {
+    return [];
+  }
+  const dep = askBackendRuntimeDep(ask);
+  if (!dep || canResolveFrom(root, dep) || canResolveFrom(pkgDir, dep)) {
+    return [];
+  }
+  return [
+    `Ask AI provider "${ask.provider}" needs "${dep}", which isn't installed. Run \`npm install ${dep}\` (or your package manager's equivalent).`
+  ];
+};
 var examplesCssFile = (root, config) => config.examples.css ? join28(root, config.examples.css) : null;
 var writeExamplesPreview = async (options) => {
   const { config, hasExamples, root, srcDir, write } = options;
@@ -17572,16 +17769,19 @@ var detectNeedsReact = async (root) => {
   return matches2.length > 0;
 };
 var containsMath = (content) => content.includes("$$") || content.includes("<Math");
+var READ_CONCURRENCY4 = 16;
 var detectUsesMath = async (root, staged = []) => {
   const files = await glob7(["**/*.{md,mdx}"], {
     cwd: root,
     ignore: ["**/node_modules/**", "**/.blume/**", "**/dist/**"],
     onlyFiles: true
   });
-  const contents = await Promise.all(files.map((file) => readOptional(join28(root, file))));
+  const contents = await pMap6(files, (file) => readOptional(join28(root, file)), {
+    concurrency: READ_CONCURRENCY4
+  });
   return [...contents, ...staged].some(containsMath);
 };
-var hashConfigSource = (source) => createHash3("sha256").update(source).digest("hex");
+var hashConfigSource = (source) => createHash4("sha256").update(source).digest("hex");
 var loadIntegrationBridge = async (config, context) => {
   if (config.integrations.length === 0 || !context.configFile) {
     return;
@@ -17631,35 +17831,25 @@ var collectStaged = (project) => {
 var writeStagedContent = async (out, staged) => {
   const contentDir = stagedContentDir(out);
   const written = new Set;
-  await Promise.all([...staged].map(async ([entryId, text2]) => {
+  await Promise.all([...staged].map(async ([entryId, text]) => {
     const path = join28(contentDir, entryId);
     written.add(normalize3(path));
-    await writeIfChanged(path, text2);
+    await writeIfChanged(path, text);
   }));
   if (existsSync16(contentDir)) {
     await pruneOrphans(contentDir, written);
   }
 };
-var SVG_ROOT = /<svg\b(?<attributes>[^>]*)>/u;
-var SVG_WIDTH = /\bwidth\s*=\s*["'](?<value>[^"']+)["']/u;
-var SVG_HEIGHT = /\bheight\s*=\s*["'](?<value>[^"']+)["']/u;
-var SVG_LENGTH = /^\s*(?<value>[\d.]+)(?:px)?\s*$/u;
-var SVG_VIEW_BOX = /\bviewBox\s*=\s*["'][\d.-]+[\s,]+[\d.-]+[\s,]+(?<width>[\d.]+)[\s,]+(?<height>[\d.]+)["']/u;
-var parseSvgLength = (value) => {
-  const length = Number(value?.match(SVG_LENGTH)?.groups?.value);
-  return length > 0 ? length : undefined;
-};
 var svgDimensions = (svg) => {
-  const attributes = svg?.match(SVG_ROOT)?.groups?.attributes;
-  const width = parseSvgLength(attributes?.match(SVG_WIDTH)?.groups?.value);
-  const height = parseSvgLength(attributes?.match(SVG_HEIGHT)?.groups?.value);
-  if (width && height) {
-    return { height, width };
+  if (!svg) {
+    return;
+  }
+  try {
+    const { height, width } = imageSize2(Buffer.from(svg));
+    return height && width ? { height, width } : undefined;
+  } catch {
+    return;
   }
-  const viewBox = attributes?.match(SVG_VIEW_BOX);
-  const viewBoxWidth = Number(viewBox?.groups?.width);
-  const viewBoxHeight = Number(viewBox?.groups?.height);
-  return viewBoxWidth > 0 && viewBoxHeight > 0 ? { height: viewBoxHeight, width: viewBoxWidth } : undefined;
 };
 var readLogoSvg = (project, source) => {
   if (!source?.toLowerCase().endsWith(".svg")) {
@@ -17678,7 +17868,7 @@ var resolveLogo = (project) => {
     return null;
   }
   const config = typeof logo === "string" ? { image: logo } : logo;
-  const { href, image: source, text: text2 } = config;
+  const { href, image: source, text } = config;
   const image = typeof source === "string" ? { light: source } : source;
   const light = image?.light ?? image?.dark;
   const dark = image?.dark ?? image?.light;
@@ -17687,12 +17877,12 @@ var resolveLogo = (project) => {
   const lightSvg = readLogoSvg(project, light);
   const darkSvg = dark === light ? lightSvg : readLogoSvg(project, dark);
   if (light && light === dark && lightSvg) {
-    return { alt, href: brandHref, svg: lightSvg, text: text2 };
+    return { alt, href: brandHref, svg: lightSvg, text };
   }
   const lightDimensions = svgDimensions(lightSvg);
   const darkDimensions = svgDimensions(darkSvg);
   const dimensions = lightDimensions || darkDimensions ? { dark: darkDimensions, light: lightDimensions } : undefined;
-  return { alt, dark, dimensions, href: brandHref, light, text: text2 };
+  return { alt, dark, dimensions, href: brandHref, light, text };
 };
 var FAVICON_CANDIDATES = [
   "icon.svg",
@@ -17980,7 +18170,7 @@ var writeAskFiles = async (project, srcDir, write) => {
     await write(join28(srcDir, "generated", "ask-data.json"), `${JSON.stringify(await buildAskData(project))}
 `);
   }
-  await write(join28(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(resolveAskBackend(ask), grounded));
+  await write(join28(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(resolveAskBackend(ask), grounded, ask.instructions));
 };
 var writeNotFoundPage = async (write, srcDir, pages, contentPages) => {
   if (routeIsTaken(pages, contentPages, "/404")) {
@@ -18217,7 +18407,7 @@ var generateRuntime = async (project) => {
     ...islandDiscovery.islands.map((island) => island.name),
     ...overrideTags
   ]);
-  warnings.push(...validateUsedComponents(project.graph.pages, knownComponentTags, new Set(registry.map((item) => item.name))).map(diagnosticWarning), ...searchProviderWarnings(config.search.provider, context.root), ...deploymentAdapterWarnings(config.deployment, context.root), ...islandFrameworkWarnings(frameworks, context.root));
+  warnings.push(...validateUsedComponents(project.graph.pages, knownComponentTags, new Set(registry.map((item) => item.name))).map(diagnosticWarning), ...searchProviderWarnings(config.search.provider, context.root), ...askProviderWarnings(config.ai.ask, context.root), ...deploymentAdapterWarnings(config.deployment, context.root), ...islandFrameworkWarnings(frameworks, context.root));
   if (hasScalarReferences(config)) {
     const references = await buildReferenceFiles({
       config,
@@ -18241,37 +18431,24 @@ var generateRuntime = async (project) => {
 };
 
 // src/cli/env.ts
-import { existsSync as existsSync17, readFileSync as readFileSync9 } from "node:fs";
-import { parse as parse2 } from "dotenv";
+import { existsSync as existsSync17 } from "node:fs";
+import { config } from "dotenv";
 import { dirname as dirname12, join as join29, resolve as resolve9 } from "pathe";
-var applyEnv = (parsed) => {
-  for (const [key, value] of Object.entries(parsed)) {
-    if (!(key in process.env)) {
-      process.env[key] = value;
-    }
-  }
-};
-var loadFile = (path) => {
-  try {
-    if (existsSync17(path)) {
-      applyEnv(parse2(readFileSync9(path, "utf-8")));
-    }
-  } catch {}
-};
 var loadEnvFiles = (startDir) => {
+  const paths = [];
   let dir = resolve9(startDir);
   let done = false;
   while (!done) {
-    loadFile(join29(dir, ".env.local"));
-    loadFile(join29(dir, ".env"));
+    paths.push(join29(dir, ".env.local"), join29(dir, ".env"));
     const parent = dirname12(dir);
     done = existsSync17(join29(dir, ".git")) || parent === dir;
     dir = parent;
   }
+  config({ path: paths, quiet: true });
 };
 
 // src/cli/required-secrets.ts
-var checkRequiredSecrets = (config) => {
+var checkRequiredSecrets = (config2) => {
   const diagnostics = [];
   const requireSecret = (feature, env, note) => {
     if (process.env[env]) {
@@ -18285,15 +18462,15 @@ var checkRequiredSecrets = (config) => {
       suggestion: `Set ${env} in .env.local for local dev, or in your host's environment for production.`
     });
   };
-  if (config.ai.ask?.enabled && !config.ai.ask.endpoint) {
-    const backend = resolveAskBackend(config.ai.ask);
+  if (config2.ai.ask?.enabled && !config2.ai.ask.endpoint) {
+    const backend = resolveAskBackend(config2.ai.ask);
     if (backend.kind === "gateway") {
       requireSecret("Ask AI (AI Gateway)", "AI_GATEWAY_API_KEY", "on Vercel the gateway can also authenticate via OIDC");
     } else {
       requireSecret("Ask AI", backend.apiKeyEnv);
     }
   }
-  if (config.search.provider === "mixedbread") {
+  if (config2.search.provider === "mixedbread") {
     requireSecret("Mixedbread search", "MIXEDBREAD_API_KEY");
   }
   return diagnostics;
@@ -18365,9 +18542,9 @@ var validateBudgetFlags = (args) => {
     }
   }
 };
-var emitRedirectFiles = async (config, distDir) => {
-  const redirects = platformRedirects(config);
-  if (redirects.length === 0 || config.deployment.output !== "static") {
+var emitRedirectFiles = async (config2, distDir) => {
+  const redirects = platformRedirects(config2);
+  if (redirects.length === 0 || config2.deployment.output !== "static") {
     return;
   }
   await writeFile7(join30(distDir, "blume-redirects.json"), buildRedirectManifest(redirects), "utf-8");
@@ -18379,11 +18556,11 @@ var emitRedirectFiles = async (config, distDir) => {
   logger.success(`Emitted redirect files for ${redirects.length} redirect(s)`);
 };
 var emitHeaderFiles = async (project, distDir) => {
-  const { config } = project;
-  if (!readsHeaderFiles(config.deployment) || existsSync18(join30(project.context.root, "public", "_headers"))) {
+  const { config: config2 } = project;
+  if (!readsHeaderFiles(config2.deployment) || existsSync18(join30(project.context.root, "public", "_headers"))) {
     return;
   }
-  const ours = buildNetlifyHeaders(config, buildHomeLinkHeader(config, markdownRoutePaths(project)));
+  const ours = buildNetlifyHeaders(config2, buildHomeLinkHeader(config2, markdownRoutePaths(project)));
   const target = join30(distDir, "_headers");
   const existing = existsSync18(target) ? await readFile17(target, "utf-8") : "";
   await writeFile7(target, existing ? `${existing.trimEnd()}
@@ -18420,15 +18597,15 @@ var emitAgentSkills = async (project, distDir) => {
   await writeFile7(join30(outDir, "index.json"), buildSkillsIndex(skills, project.config), "utf-8");
   logger.success(`Published ${skills.length} agent skill(s) (.well-known/agent-skills/index.json)`);
 };
-var emitWellKnownFiles = async (config, distDir) => {
+var emitWellKnownFiles = async (config2, distDir) => {
   const files = [
     {
-      content: buildSignaturesDirectory(config),
+      content: buildSignaturesDirectory(config2),
       label: "Web Bot Auth",
       path: SIGNATURES_DIRECTORY_PATH
     },
     {
-      content: buildApiCatalog(config),
+      content: buildApiCatalog(config2),
       label: "RFC 9727",
       path: API_CATALOG_PATH
     }
@@ -18444,18 +18621,18 @@ var emitWellKnownFiles = async (config, distDir) => {
   }
 };
 var emitVercelNegotiation = async (project, routePaths, root) => {
-  const { config } = project;
+  const { config: config2 } = project;
   const configPath = join30(root, ".vercel", "output", "config.json");
   if (!existsSync18(configPath)) {
     return;
   }
   const overrides = {
-    ...hasApiCatalog(config) ? { [API_CATALOG_PATH.slice(1)]: API_CATALOG_TYPE } : {},
-    ...config.ai.webBotAuth.keys.length > 0 ? { [SIGNATURES_DIRECTORY_PATH.slice(1)]: SIGNATURES_DIRECTORY_TYPE } : {}
+    ...hasApiCatalog(config2) ? { [API_CATALOG_PATH.slice(1)]: API_CATALOG_TYPE } : {},
+    ...config2.ai.webBotAuth.keys.length > 0 ? { [SIGNATURES_DIRECTORY_PATH.slice(1)]: SIGNATURES_DIRECTORY_TYPE } : {}
   };
   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);
+  const injected = injectNegotiationRoutes(await readFile17(configPath, "utf-8"), routePaths, buildHomeLinkHeader(config2, 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;
@@ -18465,7 +18642,7 @@ var emitVercelNegotiation = async (project, routePaths, root) => {
 };
 var warnCloudflareNegotiationSkipped = () => logger.warn("Could not wire Accept: text/markdown negotiation into dist/server/wrangler.json — raw Markdown stays available at the .md URLs.");
 var emitCloudflareNegotiation = async (project, routePaths) => {
-  const { config, context } = project;
+  const { config: config2, context } = project;
   const serverDir = join30(context.distDir ?? join30(context.root, "dist"), "server");
   const wranglerPath = join30(serverDir, "wrangler.json");
   if (!existsSync18(wranglerPath)) {
@@ -18475,11 +18652,11 @@ var emitCloudflareNegotiation = async (project, routePaths) => {
   const rawMarkdown = await buildRawMarkdown(project);
   const home = rawMarkdown["/"];
   const injected = injectWorkerNegotiation(await readFile17(wranglerPath, "utf-8"), {
-    base: config.deployment.base,
+    base: config2.deployment.base,
     contentRoutePaths: project.manifest.routes.map((route) => route.path),
-    homeLinkHeader: buildHomeLinkHeader(config, routePaths),
+    homeLinkHeader: buildHomeLinkHeader(config2, routePaths),
     homeTokens: home ? markdownTokenCount(agentMarkdown(home)) : undefined,
-    redirects: platformRedirects(config),
+    redirects: platformRedirects(config2),
     routePaths
   });
   if (injected === null) {
@@ -18555,20 +18732,20 @@ var runClientAssetChecks = async (staticDir, args) => {
     process.exit(1);
   }
 };
-var isolatedOutputDir = (config, context) => {
-  const { adapter, output } = config.deployment;
+var isolatedOutputDir = (config2, context) => {
+  const { adapter, output } = config2.deployment;
   if (output === "server" && adapter === "vercel") {
     return join30(context.outDir, ".vercel", "output");
   }
   return context.distDir ?? join30(context.outDir, "dist");
 };
-var isolatedStaticDir = (config, context) => {
-  const { adapter, output } = config.deployment;
-  const outputDir = isolatedOutputDir(config, context);
+var isolatedStaticDir = (config2, context) => {
+  const { adapter, output } = config2.deployment;
+  const outputDir = isolatedOutputDir(config2, context);
   if (output === "server" && adapter === "vercel") {
     return join30(outputDir, "static");
   }
-  if (servesClientSubdir(config.deployment)) {
+  if (servesClientSubdir(config2.deployment)) {
     return join30(outputDir, "client");
   }
   return outputDir;
@@ -18609,10 +18786,10 @@ var publishBuildArtifacts = async (project, distDir, args) => {
   if (project.config.ai.llmsTxt.enabled) {
     await publishLlmsFiles(project, distDir);
   }
-  const sitemap = buildSitemap(project);
-  if (sitemap && !existsSync18(join30(distDir, "sitemap.xml"))) {
-    await writeFile7(join30(distDir, "sitemap.xml"), sitemap, "utf-8");
-    logger.success("Generated sitemap.xml");
+  const sitemapFiles = buildSitemapFiles(project);
+  if (sitemapFiles && !existsSync18(join30(distDir, "sitemap.xml"))) {
+    await Promise.all(sitemapFiles.map((file) => writeFile7(join30(distDir, file.name), file.xml, "utf-8")));
+    logger.success(sitemapFiles.length === 1 ? "Generated sitemap.xml" : `Generated sitemap.xml (index of ${sitemapFiles.length - 1} sitemap files)`);
   }
   const robots = buildRobots(project);
   if (robots && !existsSync18(join30(distDir, "robots.txt"))) {
@@ -18629,19 +18806,19 @@ var publishBuildArtifacts = async (project, distDir, args) => {
   await emitAgentSkills(project, distDir);
   await emitRedirectFiles(project.config, distDir);
   await emitHeaderFiles(project, distDir);
-  const { config } = project;
-  const features = serverFeatures(config);
-  const sitemapNote = config.seo.sitemap ? "no (set deployment.site)" : "no (seo.sitemap is false)";
+  const { config: config2 } = project;
+  const features = serverFeatures(config2);
+  const sitemapNote = config2.seo.sitemap ? "no (set deployment.site)" : "no (seo.sitemap is false)";
   logger.box([
-    `Output     ${config.deployment.output}`,
-    `Adapter    ${config.deployment.adapter ?? "none"}`,
-    `Site       ${config.deployment.site ?? "not set"}`,
-    `Search     ${config.search.provider}`,
-    `Redirects  ${config.redirects.length}`,
-    `Sitemap    ${sitemap ? "yes" : sitemapNote}`,
+    `Output     ${config2.deployment.output}`,
+    `Adapter    ${config2.deployment.adapter ?? "none"}`,
+    `Site       ${config2.deployment.site ?? "not set"}`,
+    `Search     ${config2.search.provider}`,
+    `Redirects  ${config2.redirects.length}`,
+    `Sitemap    ${sitemapFiles ? "yes" : sitemapNote}`,
     `Robots     ${robots ? "yes" : "no"}`,
     `Agent JSON ${agentReadability ? "yes" : "no"}`,
-    `LLM files  ${config.ai.llmsTxt.enabled ? "yes" : "no"}`,
+    `LLM files  ${config2.ai.llmsTxt.enabled ? "yes" : "no"}`,
     `Server features  ${features.length > 0 ? features.join(", ") : "none"}`
   ].join(`
 `));
@@ -18814,6 +18991,7 @@ var checkCommand = defineCommand4({
 import { dev } from "astro";
 import { watch } from "chokidar";
 import { defineCommand as defineCommand5 } from "citty";
+import { debounce } from "perfect-debounce";
 
 // src/astro/integration.ts
 var overlayServer = null;
@@ -18868,29 +19046,6 @@ var parsePort = (value) => {
   return port;
 };
 
-// src/cli/coalesce.ts
-var coalescedRunner = (task) => {
-  let inFlight = null;
-  let pending = false;
-  const cycle = async () => {
-    try {
-      do {
-        pending = false;
-        await task();
-      } while (pending);
-    } finally {
-      inFlight = null;
-    }
-  };
-  return () => {
-    if (inFlight) {
-      pending = true;
-      return;
-    }
-    inFlight = cycle();
-  };
-};
-
 // src/cli/commands/dev.ts
 var normalizeHost = (host) => host === "" ? true : host ?? false;
 var routeSignature = (routes) => routes.map((route) => `${route.path} ${route.entryId}`).toSorted().join(`
@@ -18958,7 +19113,7 @@ var devCommand = defineCommand5({
     }
     showBlumeErrorOverlay(project.diagnostics);
     let lastSignature = routeSignature(project.manifest.routes);
-    const runRegenerate = coalescedRunner(async () => {
+    const regenerate = debounce(async () => {
       try {
         const next = await scanProject(root, {
           devServerUrl,
@@ -18981,16 +19136,9 @@ var devCommand = defineCommand5({
       } catch (error) {
         logger.error(`Regeneration failed: ${error.message}`);
       }
-    });
-    let timer = null;
-    const regenerate = () => {
-      if (timer) {
-        clearTimeout(timer);
-      }
-      timer = setTimeout(runRegenerate, 80);
-    };
+    }, 80);
     if (boundPort !== port) {
-      runRegenerate();
+      regenerate();
     }
     const dirTargets = [project.context.pagesRoot].filter((target) => target !== null);
     const fileTargets = [
@@ -19019,14 +19167,14 @@ var devCommand = defineCommand5({
 });
 
 // src/cli/commands/doctor.ts
-import { readFileSync as readFileSync10 } from "node:fs";
+import { readFileSync as readFileSync9 } from "node:fs";
 import { defineCommand as defineCommand6 } from "citty";
 import { join as join32 } from "pathe";
 import { satisfies } from "semver";
 var FALLBACK_NODE_RANGE = ">=22.12.0";
 var supportedNodeRange = () => {
   try {
-    const pkg = JSON.parse(readFileSync10(join32(packageRoot(), "package.json"), "utf-8"));
+    const pkg = JSON.parse(readFileSync9(join32(packageRoot(), "package.json"), "utf-8"));
     return pkg.engines?.node || FALLBACK_NODE_RANGE;
   } catch {
     return FALLBACK_NODE_RANGE;
@@ -19057,9 +19205,9 @@ var doctorCommand = defineCommand6({
     try {
       const project = await scanProject(root, { mode: "build" });
       diagnostics.push(...project.diagnostics);
-      const { config } = project;
-      const features = serverFeatures(config);
-      if (features.length > 0 && config.deployment.output === "static") {
+      const { config: config2 } = project;
+      const features = serverFeatures(config2);
+      if (features.length > 0 && config2.deployment.output === "static") {
         diagnostics.push({
           code: "BLUME_SERVER_FEATURE_REQUIRED",
           message: `${features.join(", ")} require server output.`,
@@ -19067,7 +19215,7 @@ var doctorCommand = defineCommand6({
           suggestion: 'Set deployment.output to "server".'
         });
       }
-      if (config.deployment.output === "server" && !config.deployment.adapter) {
+      if (config2.deployment.output === "server" && !config2.deployment.adapter) {
         diagnostics.push({
           code: "BLUME_ADAPTER_REQUIRED",
           message: "Server output requires an adapter.",
@@ -19077,8 +19225,8 @@ var doctorCommand = defineCommand6({
       }
       if (!args.json) {
         logger.info(`Pages: ${project.graph.pages.length}`);
-        logger.info(`Output: ${config.deployment.output}`);
-        logger.info(`Search: ${config.search.provider}`);
+        logger.info(`Output: ${config2.deployment.output}`);
+        logger.info(`Search: ${config2.search.provider}`);
       }
     } catch (error) {
       if (error instanceof BlumeError) {
@@ -19224,16 +19372,16 @@ var examplesPreviewFiles = (srcDir, basePath, hasExamples) => hasExamples ? [
     path: join33(srcDir, "pages", ...basePath.split("/").filter(Boolean), "blume-examples", "[...path].astro")
   }
 ] : [];
-var ejectIntegrationBridge = (config, root, configFile) => config.integrations.length > 0 && configFile ? { configFile: toPosix(relative15(root, configFile)) } : undefined;
+var ejectIntegrationBridge = (config2, root, configFile) => config2.integrations.length > 0 && configFile ? { configFile: toPosix(relative15(root, configFile)) } : undefined;
 var eject = async (root) => {
   const project = await scanProject(root, { mode: "build" });
-  const { context, config } = project;
+  const { context, config: config2 } = project;
   const srcDir = join33(root, "src");
   const genDir = join33(srcDir, "generated");
-  const askEnabled = config.ai.ask?.enabled ?? false;
-  const exportPdf = config.export.pdf;
-  const exportEpub = config.export.epub;
-  const examples = await discoverExamples(root, config.examples.source);
+  const askEnabled = config2.ai.ask?.enabled ?? false;
+  const exportPdf = config2.export.pdf;
+  const exportEpub = config2.export.epub;
+  const examples = await discoverExamples(root, config2.examples.source);
   project.examples = exampleMarkdownLookup(examples.examples);
   const [
     pages,
@@ -19248,7 +19396,7 @@ var eject = async (root) => {
     detectNeedsReact(root),
     detectUsesMath(root),
     context.themeFile ? readFile18(context.themeFile, "utf-8") : Promise.resolve(""),
-    readExamplesCss(root, config.examples.css),
+    readExamplesCss(root, config2.examples.css),
     buildRawMarkdown(project),
     discoverIslands(root)
   ]);
@@ -19280,13 +19428,13 @@ var eject = async (root) => {
     {
       content: astroConfigTemplate({
         askPath: "./src/generated/Ask.astro",
-        config,
+        config: config2,
         contentRoutes: project.manifest.routes.map((route) => route.path),
         context: relContext,
         dataPath: "./src/generated/data.json",
         examplesPath: "./src/generated/examples.ts",
         examplesThemePath: "./src/generated/examples.css",
-        integrationBridge: ejectIntegrationBridge(config, root, context.configFile),
+        integrationBridge: ejectIntegrationBridge(config2, root, context.configFile),
         needsReact,
         needsSvelte,
         needsVue,
@@ -19305,7 +19453,7 @@ var eject = async (root) => {
     { content: envTemplate(), path: join33(srcDir, "env.d.ts") },
     {
       content: contentConfigTemplate({
-        config,
+        config: config2,
         context: relContext,
         staged: hasStaged,
         stagedBase: stagedDir
@@ -19330,12 +19478,12 @@ var eject = async (root) => {
       path: join33(genDir, "islands.ts")
     },
     {
-      content: exampleMapTemplate(examples.examples, config.basePath),
+      content: exampleMapTemplate(examples.examples, config2.basePath),
       path: join33(genDir, "examples.ts")
     },
     {
       content: examplesEntryTemplate({
-        configTokens: buildThemeCss(config.theme),
+        configTokens: buildThemeCss(config2.theme),
         sources: ["../../**/*.{astro,jsx,svelte,ts,tsx,vue}"],
         userCss: userExamplesCss
       }),
@@ -19343,7 +19491,7 @@ var eject = async (root) => {
     },
     {
       content: tailwindEntryTemplate({
-        configTokens: buildThemeCss(config.theme),
+        configTokens: buildThemeCss(config2.theme),
         sources: [
           blumeSourceGlob(root, genDir),
           "../../**/*.{astro,mdx,ts,tsx}"
@@ -19380,9 +19528,9 @@ var eject = async (root) => {
   if (askEnabled) {
     files.push(...await askFiles(project, srcDir, genDir));
   }
-  if (config.seo.og.enabled) {
+  if (config2.seo.og.enabled) {
     files.push({
-      content: ogEndpointTemplate(customOgRoutes(pages, config.title, config.seo.og.titles)),
+      content: ogEndpointTemplate(customOgRoutes(pages, config2.title, config2.seo.og.titles)),
       path: join33(srcDir, "pages", "og", "[...slug].png.ts")
     });
   }
@@ -19399,10 +19547,10 @@ var eject = async (root) => {
     });
   }
   files.push({
-    content: searchClientTemplate(config),
+    content: searchClientTemplate(config2),
     path: join33(genDir, "search-client.ts")
   });
-  if (servesStaticIndex(config.search.provider)) {
+  if (servesStaticIndex(config2.search.provider)) {
     const documents = await buildSearchDocuments(project);
     files.push({
       content: `${JSON.stringify(documents)}
@@ -19413,9 +19561,9 @@ var eject = async (root) => {
       path: join33(srcDir, "pages", "blume-search.json.ts")
     });
   }
-  if (config.search.provider === "mixedbread") {
+  if (config2.search.provider === "mixedbread") {
     files.push({
-      content: mixedbreadSearchEndpointTemplate(config.search.mixedbread?.storeId ?? ""),
+      content: mixedbreadSearchEndpointTemplate(config2.search.mixedbread?.storeId ?? ""),
       path: join33(srcDir, "pages", "api", "search.ts")
     });
   }
@@ -19432,9 +19580,9 @@ var eject = async (root) => {
     });
   }
   const warnings = [];
-  if (hasScalarReferences(config)) {
+  if (hasScalarReferences(config2)) {
     const references = await buildReferenceFiles({
-      config,
+      config: config2,
       contentRoutes: new Set(project.graph.pages.map((page) => page.route)),
       root
     });
@@ -19452,7 +19600,7 @@ var eject = async (root) => {
   })), ...examples.examples.map((example) => ({
     content: exampleWrapperTemplate(example),
     path: join33(genDir, "examples", `${exampleSlug(example.path)}.astro`)
-  })), ...examplesPreviewFiles(srcDir, config.basePath, examples.examples.length > 0));
+  })), ...examplesPreviewFiles(srcDir, config2.basePath, examples.examples.length > 0));
   for (const [entryId, content] of staged) {
     files.push({ content, path: join33(root, stagedDir, entryId) });
   }
@@ -19474,27 +19622,27 @@ var eject = async (root) => {
 // src/cli/eject-scripts.ts
 import { readFile as readFile19, writeFile as writeFile9 } from "node:fs/promises";
 import { join as join34 } from "pathe";
-var droppedArtifactNotices = (config) => {
+var droppedArtifactNotices = (config2) => {
   const notices = [];
-  if (config.search.provider === "pagefind") {
+  if (config2.search.provider === "pagefind") {
     notices.push('the Pagefind search index — the search UI loads it from the built site, so search will break in production. Add a post-build step: `"build": "astro build && pagefind --site dist"` (with `pagefind` installed as a devDependency).');
   }
-  if (searchProviderMeta(config.search.provider).syncs) {
-    notices.push(`the hosted ${config.search.provider} index sync — new and updated pages stop being pushed; re-upload your search records after each build with the provider's API or CLI.`);
+  if (searchProviderMeta(config2.search.provider).syncs) {
+    notices.push(`the hosted ${config2.search.provider} index sync — new and updated pages stop being pushed; re-upload your search records after each build with the provider's API or CLI.`);
   }
-  if (config.ai.llmsTxt.enabled) {
+  if (config2.ai.llmsTxt.enabled) {
     notices.push("llms.txt and llms-full.txt");
   }
-  if (config.deployment.site && config.seo.sitemap) {
+  if (config2.deployment.site && config2.seo.sitemap) {
     notices.push("sitemap.xml — recreate it with the @astrojs/sitemap integration.");
   }
-  if (config.seo.robots) {
+  if (config2.seo.robots) {
     notices.push("robots.txt — recreate it as a public/robots.txt file.");
   }
-  if (config.seo.agentReadability) {
+  if (config2.seo.agentReadability) {
     notices.push("agent-readability.json");
   }
-  if (config.redirects.length > 0 && config.deployment.output === "static") {
+  if (config2.redirects.length > 0 && config2.deployment.output === "static") {
     notices.push("the platform redirect files (_redirects, vercel.json) — your redirects still work as Astro-generated meta-refresh pages.");
   }
   return notices;
@@ -19521,6 +19669,7 @@ var updatePackageScripts = async (root) => {
 // src/cli/init/scaffold.ts
 import { existsSync as existsSync21 } from "node:fs";
 import { mkdir as mkdir10, writeFile as writeFile10 } from "node:fs/promises";
+import { detect } from "package-manager-detector/detect";
 import { basename as basename4, dirname as dirname14, isAbsolute as isAbsolute9, join as join35, relative as relative16 } from "pathe";
 
 // src/core/package-json.ts
@@ -19649,6 +19798,11 @@ var detectPackageManager = (userAgent) => {
   const name = userAgent?.split("/")[0];
   return name !== undefined && PACKAGE_MANAGERS.includes(name) ? name : "npm";
 };
+var detectProjectPackageManager = async (root) => {
+  const detected = await detect({ cwd: root });
+  const name = detected?.name;
+  return name !== undefined && PACKAGE_MANAGERS.includes(name) ? name : detectPackageManager(process.env.npm_config_user_agent);
+};
 var validateContentDir = (root, dir) => isAbsolute9(dir) || relative16(root, join35(root, dir)).startsWith("..") ? "Must be a relative path inside the project." : undefined;
 var titleize = (raw) => {
   const words = raw.replaceAll(/[-_.]+/gu, " ").split(/\s+/u).filter(Boolean);
@@ -19793,8 +19947,8 @@ var ejectCommand = defineCommand7({
     refuseIfDevRunning(root, "ejecting");
     let notices = [];
     try {
-      const { config } = await loadConfig(root);
-      notices = droppedArtifactNotices(config);
+      const { config: config2 } = await loadConfig(root);
+      notices = droppedArtifactNotices(config2);
     } catch {}
     if (!args.yes) {
       logger.warn("Eject is one-way: it writes astro.config.mjs, src/, and (if absent) tsconfig.json, rewrites your package.json scripts, and removes .blume. An existing tsconfig.json is left untouched.");
@@ -19813,7 +19967,7 @@ var ejectCommand = defineCommand7({
 `);
     }
     reportDroppedArtifacts(notices);
-    const pm = detectPackageManager(process.env.npm_config_user_agent);
+    const pm = await detectProjectPackageManager(root);
     const { build: build2, dev: dev2 } = commandsFor(pm);
     logger.box(`Your project is now a standalone Astro app.
 
@@ -19898,6 +20052,20 @@ import { mkdtemp as mkdtemp2, writeFile as writeFile11 } from "node:fs/promises"
 import { tmpdir as tmpdir2 } from "node:os";
 import { colors as colors4 } from "consola/utils";
 import { join as join36, relative as relative18 } from "pathe";
+
+// src/cli/report-format.ts
+var seconds = (ms) => `${(ms / 1000).toFixed(1)}s`;
+var money = (cost) => cost === undefined ? "" : `$${cost.toFixed(2)}`;
+var duration = (ms) => {
+  if (ms < 60000) {
+    return seconds(ms);
+  }
+  const minutes = Math.floor(ms / 60000);
+  const rest = Math.round(ms % 60000 / 1000);
+  return `${minutes}m ${rest}s`;
+};
+
+// src/eval/report.ts
 var GLYPH2 = {
   error: "!",
   fail: "✖",
@@ -19911,16 +20079,6 @@ var STATUS_COLOR = {
   skip: colors4.dim
 };
 var ID_PAD = 28;
-var seconds = (ms) => `${(ms / 1000).toFixed(1)}s`;
-var money = (cost) => cost === undefined ? "" : `$${cost.toFixed(2)}`;
-var duration = (ms) => {
-  if (ms < 60000) {
-    return seconds(ms);
-  }
-  const minutes = Math.floor(ms / 60000);
-  const rest = Math.round(ms % 60000 / 1000);
-  return `${minutes}m ${rest}s`;
-};
 var questionLine = (result) => {
   const color = STATUS_COLOR[result.status];
   const glyph = color(GLYPH2[result.status]);
@@ -20005,8 +20163,8 @@ import { tmpdir as tmpdir3 } from "node:os";
 import { join as join38 } from "pathe";
 
 // src/eval/agents.ts
-import { spawn as spawn2 } from "node:child_process";
 import { readFile as readFile20, writeFile as writeFile12 } from "node:fs/promises";
+import spawn2 from "cross-spawn";
 import { join as join37 } from "pathe";
 import { z as z3 } from "zod";
 var KILL_GRACE_MS = 5000;
@@ -20030,19 +20188,17 @@ var DISALLOWED_TOOLS = [
   "Task"
 ];
 var runAgentHeadless = (bin, args, options) => new Promise((resolve11, reject) => {
-  const platform = options.platform ?? process.platform;
   const child = spawn2(bin, args, {
     cwd: options.cwd,
-    shell: platform === "win32",
     stdio: ["pipe", "pipe", "pipe"]
   });
   let stdout = "";
   let stderr = "";
   let timedOut = false;
-  child.stdout.on("data", (chunk) => {
+  child.stdout?.on("data", (chunk) => {
     stdout += chunk.toString("utf-8");
   });
-  child.stderr.on("data", (chunk) => {
+  child.stderr?.on("data", (chunk) => {
     stderr += chunk.toString("utf-8");
   });
   const deadline = setTimeout(() => {
@@ -20066,7 +20222,7 @@ var runAgentHeadless = (bin, args, options) => new Promise((resolve11, reject) =
       resolve11({ code: code ?? 1, stderr, stdout, timedOut });
     }
   });
-  child.stdin.end(options.prompt);
+  child.stdin?.end(options.prompt);
 });
 var writeMcpConfig = async (dir, snapshotPath, launcher) => {
   const resolved = launcher ?? {
@@ -20074,12 +20230,12 @@ var writeMcpConfig = async (dir, snapshotPath, launcher) => {
     command: process.execPath
   };
   const configPath = join37(dir, "mcp-config.json");
-  const config = {
+  const config2 = {
     mcpServers: {
       [MCP_SERVER_NAME]: { args: resolved.args, command: resolved.command }
     }
   };
-  await writeFile12(configPath, JSON.stringify(config, null, 2));
+  await writeFile12(configPath, JSON.stringify(config2, null, 2));
   return {
     configPath,
     serverArgs: resolved.args,
@@ -20181,17 +20337,17 @@ var readAgentOutput = async (kind, result, lastMessagePath) => {
       text: payload.data.result
     };
   }
-  let text2;
+  let text;
   try {
     const raw = await readFile20(lastMessagePath, "utf-8");
-    text2 = raw.trim();
+    text = raw.trim();
   } catch {
     return { detail: "no last message written", isError: true, text: "" };
   }
-  if (text2 === "") {
+  if (text === "") {
     return { detail: "empty last message", isError: true, text: "" };
   }
-  return { isError: false, text: text2 };
+  return { isError: false, text };
 };
 var verdictSchema = z3.object({
   missing: z3.array(z3.string()).default([]),
@@ -20199,15 +20355,15 @@ var verdictSchema = z3.object({
   pass: z3.boolean(),
   score: z3.number().min(0).max(1).optional()
 });
-var parseVerdict = (text2) => {
-  const start = text2.indexOf("{");
-  const end = text2.lastIndexOf("}");
+var parseVerdict = (text) => {
+  const start = text.indexOf("{");
+  const end = text.lastIndexOf("}");
   if (start === -1 || end <= start) {
     return;
   }
   let parsed;
   try {
-    parsed = JSON.parse(text2.slice(start, end + 1));
+    parsed = JSON.parse(text.slice(start, end + 1));
   } catch {
     return;
   }
@@ -20486,21 +20642,21 @@ var runEval = async (options) => {
 var DEFAULT_FILE = "evals.yaml";
 var DEFAULT_TIMEOUT_S = 180;
 var isAgentKind = (value) => (value in AGENTS);
-var launchAgentCode2 = async (bin, prompt) => {
+var notInstalled = (agent) => {
+  const cli = AGENTS[agent];
+  logger.error(`${cli.name} (\`${cli.bin}\`) was not found on PATH. Install it with \`${cli.install}\`.`);
+  return process.exit(1);
+};
+var launchAgentCode2 = async (agent, prompt) => {
   try {
-    return await launchAgent(bin, prompt);
+    return await launchAgent(AGENTS[agent].bin, prompt);
   } catch (error) {
     if (error?.code !== "ENOENT") {
       throw error;
     }
-    return WINDOWS_COMMAND_NOT_FOUND;
+    return notInstalled(agent);
   }
 };
-var notInstalled = (agent) => {
-  const cli = AGENTS[agent];
-  logger.error(`${cli.name} (\`${cli.bin}\`) was not found on PATH. Install it with \`${cli.install}\`.`);
-  return process.exit(1);
-};
 var passFraction = (result) => {
   const ran = result.results.length - result.counts.skip;
   return ran === 0 ? 1 : result.counts.pass / ran;
@@ -20540,10 +20696,7 @@ var runFixHandoff = async (agent, result, root, threshold) => {
   process.stderr.write(`  Handing ${count} failed question${count === 1 ? "" : "s"} to ${cli.name}…
 
 `);
-  const code = await launchAgentCode2(cli.bin, evalFixPrompt(report));
-  if (code === WINDOWS_COMMAND_NOT_FOUND) {
-    notInstalled(agent);
-  }
+  const code = await launchAgentCode2(agent, evalFixPrompt(report));
   if (code !== 0) {
     process.exit(code);
   }
@@ -20554,10 +20707,7 @@ var runInit = async (agent, file) => {
     logger.error(`${file} already exists — edit it directly, or pass --file to draft elsewhere.`);
     process.exit(1);
   }
-  const code = await launchAgentCode2(AGENTS[agent].bin, initPrompt(file));
-  if (code === WINDOWS_COMMAND_NOT_FOUND) {
-    notInstalled(agent);
-  }
+  const code = await launchAgentCode2(agent, initPrompt(file));
   if (code !== 0) {
     process.exit(code);
   }
@@ -20915,6 +21065,7 @@ import {
   CallToolRequestSchema,
   ListToolsRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
+import { z as z5 } from "zod";
 
 // src/search/orama-index.ts
 import { create, insertMultiple, search } from "@orama/orama";
@@ -20932,6 +21083,7 @@ var BOOST = { description: 2, title: 3 };
 var SEGMENTED_LANGUAGES = new Set(["ja", "ko", "th", "zh"]);
 var BIGRAM_LANGUAGES = new Set(["ja", "zh"]);
 var BIGRAM_SCRIPTS = /^[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}々〆〇ーﾞﾟ]+$/u;
+var TERM = /[\p{L}\p{M}\p{N}]+(?:(?:['’](?=\p{L})|(?<=\p{N})[.,](?=\p{N}))[\p{L}\p{M}\p{N}]+)*/gu;
 var addBigrams = (run, tokens) => {
   const characters = [...run];
   if (characters.length === 1) {
@@ -20968,17 +21120,30 @@ var segmentingTokenizer = (locale) => {
           run = "";
         }
       };
-      for (const segment of segmenter.segment(raw.toLowerCase())) {
+      const take = (term) => {
+        if (bigram && BIGRAM_SCRIPTS.test(term)) {
+          run += term;
+          return;
+        }
+        flush();
+        tokens.add(term);
+      };
+      for (const segment of segmenter.segment(raw.normalize("NFC").toLowerCase())) {
         if (!segment.isWordLike) {
           flush();
           continue;
         }
-        if (bigram && BIGRAM_SCRIPTS.test(segment.segment)) {
-          run += segment.segment;
-          continue;
+        let end = 0;
+        for (const match of segment.segment.matchAll(TERM)) {
+          if (match.index > end) {
+            flush();
+          }
+          take(match[0]);
+          end = match.index + match[0].length;
+        }
+        if (end < segment.segment.length) {
+          flush();
         }
-        flush();
-        tokens.add(segment.segment);
       }
       flush();
       return [...tokens];
@@ -21019,78 +21184,54 @@ var queryOramaIndex = async (db, term, limit, filters) => {
 var DEFAULT_SEARCH_LIMIT = 8;
 var MAX_SEARCH_LIMIT = 20;
 var EXCERPT_LENGTH = 200;
-var CONTENT_TYPES_SCHEMA = {
-  description: 'Only include pages of these content types (frontmatter `type`, e.g. `["doc", "rfc"]`). `list_pages` shows each page\'s type. Omit to include every type.',
-  items: { type: "string" },
-  type: "array"
-};
-var FILTERS_SCHEMA = {
-  additionalProperties: { type: "string" },
-  description: 'Only include pages matching every facet, key → required value (e.g. `{"status": "enforced"}`). Facets are metadata the site declares per content type; `list_pages` shows each page\'s facet values. Omit for no facet filtering.',
-  type: "object"
-};
-var INPUT_SCHEMAS = {
-  get_navigation: { properties: {}, type: "object" },
-  get_page: {
-    properties: {
-      route: {
-        description: "The page route, e.g. `/guides/install`.",
-        type: "string"
-      }
-    },
-    required: ["route"],
-    type: "object"
-  },
-  list_pages: {
-    properties: {
-      contentTypes: CONTENT_TYPES_SCHEMA,
-      filters: FILTERS_SCHEMA
-    },
-    type: "object"
-  },
-  search_docs: {
-    properties: {
-      contentTypes: CONTENT_TYPES_SCHEMA,
-      filters: FILTERS_SCHEMA,
-      limit: {
-        description: `Maximum hits to return (default ${DEFAULT_SEARCH_LIMIT}).`,
-        maximum: MAX_SEARCH_LIMIT,
-        minimum: 1,
-        type: "integer"
-      },
-      query: { description: "The search query.", type: "string" }
-    },
-    required: ["query"],
-    type: "object"
+var contentTypesField = z5.preprocess((value) => {
+  const list2 = (Array.isArray(value) ? value : [value]).filter((entry) => typeof entry === "string");
+  return list2.length > 0 ? list2 : undefined;
+}, z5.array(z5.string()).optional().describe('Only include pages of these content types (frontmatter `type`, e.g. `["doc", "rfc"]`). `list_pages` shows each page\'s type. Omit to include every type.'));
+var filtersField = z5.preprocess((value) => {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return;
   }
+  const entries = Object.entries(value).filter((entry) => typeof entry[1] === "string");
+  return entries.length > 0 ? Object.fromEntries(entries) : undefined;
+}, z5.record(z5.string(), z5.string()).optional().describe('Only include pages matching every facet, key → required value (e.g. `{"status": "enforced"}`). Facets are metadata the site declares per content type; `list_pages` shows each page\'s facet values. Omit for no facet filtering.'));
+var limitField = z5.preprocess((value) => {
+  const num = typeof value === "number" ? value : Number(value);
+  return Number.isFinite(num) ? Math.min(Math.max(Math.trunc(num), 1), MAX_SEARCH_LIMIT) : undefined;
+}, z5.int().min(1).max(MAX_SEARCH_LIMIT).optional().describe(`Maximum hits to return (default ${DEFAULT_SEARCH_LIMIT}).`));
+var textField = (description) => z5.preprocess((value) => typeof value === "string" ? value : "", z5.string().describe(description));
+var TOOL_INPUTS = {
+  get_navigation: z5.object({}),
+  get_page: z5.object({
+    route: textField("The page route, e.g. `/guides/install`.")
+  }),
+  list_pages: z5.object({
+    contentTypes: contentTypesField,
+    filters: filtersField
+  }),
+  search_docs: z5.object({
+    contentTypes: contentTypesField,
+    filters: filtersField,
+    limit: limitField,
+    query: textField("The search query.")
+  })
+};
+var inputSchemaFor = (schema) => {
+  const {
+    $schema: _dialect,
+    additionalProperties: _closed,
+    ...rest
+  } = z5.toJSONSchema(schema);
+  return rest;
 };
 var TOOL_DEFINITIONS = MCP_TOOLS.map((tool) => ({
   annotations: tool.annotations,
   description: tool.description,
-  inputSchema: INPUT_SCHEMAS[tool.name],
+  inputSchema: inputSchemaFor(TOOL_INPUTS[tool.name]),
   name: tool.name,
   title: tool.title
 }));
-var asString2 = (value) => typeof value === "string" ? value : "";
-var asContentTypes = (value) => {
-  const list2 = Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [value].filter((entry) => typeof entry === "string");
-  return list2.length > 0 ? list2 : undefined;
-};
-var asFacetFilters = (value) => {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    return;
-  }
-  const entries = Object.entries(value).filter((entry) => typeof entry[1] === "string");
-  return entries.length > 0 ? Object.fromEntries(entries) : undefined;
-};
 var matchesFacets = (facets, filters) => Object.entries(filters).every(([key, value]) => facets?.[key] === value);
-var asLimit = (value) => {
-  const num = typeof value === "number" ? value : Number(value);
-  if (!Number.isFinite(num)) {
-    return DEFAULT_SEARCH_LIMIT;
-  }
-  return Math.min(Math.max(Math.trunc(num), 1), MAX_SEARCH_LIMIT);
-};
 var normalizeRoute2 = (input, data) => {
   let value = input.trim();
   if (/^https?:\/\//iu.test(value)) {
@@ -21101,15 +21242,12 @@ var normalizeRoute2 = (input, data) => {
   try {
     value = decodeURI(value);
   } catch {}
-  const noTrailing = value.replace(/\/+$/u, "");
-  const noSuffix = noTrailing.replace(/\.mdx?$/u, "");
-  const withSlash = noSuffix.startsWith("/") ? noSuffix : `/${noSuffix}`;
-  const based = stripBasePath(data.base, withSlash);
-  return based === "" ? "/" : based;
+  const noSuffix = trimEnd(value, "/").replace(/\.mdx?$/u, "");
+  return stripBasePath(data.base, normalizeRoute(noSuffix));
 };
 var urlFor = (route, data) => {
   const path = withBasePath(data.base, route);
-  return data.site ? `${data.site.replace(/\/+$/u, "")}${path}` : path;
+  return data.site ? absoluteUrl(data.site, path) : path;
 };
 var excerptFor = (doc) => {
   if (doc.description) {
@@ -21118,7 +21256,7 @@ var excerptFor = (doc) => {
   const head = doc.content.slice(0, EXCERPT_LENGTH).trim();
   return doc.content.length > EXCERPT_LENGTH ? `${head}…` : head;
 };
-var text2 = (value, isError = false) => ({
+var text = (value, isError = false) => ({
   content: [{ text: value, type: "text" }],
   ...isError ? { isError: true } : {}
 });
@@ -21140,10 +21278,11 @@ var buildServer = (data, index) => {
   server.setRequestHandler(CallToolRequestSchema, async (request2) => {
     const { arguments: args = {}, name } = request2.params;
     if (name === "search_docs") {
+      const input = TOOL_INPUTS.search_docs.parse(args);
       const db = await index();
-      const hits = await queryOramaIndex(db, asString2(args.query), asLimit(args.limit), {
-        contentTypes: asContentTypes(args.contentTypes),
-        facets: asFacetFilters(args.filters)
+      const hits = await queryOramaIndex(db, input.query, input.limit ?? DEFAULT_SEARCH_LIMIT, {
+        contentTypes: input.contentTypes,
+        facets: input.filters
       });
       const results = hits.map((doc) => ({
         contentType: doc.contentType,
@@ -21153,21 +21292,21 @@ var buildServer = (data, index) => {
         title: doc.title,
         url: urlFor(doc.route, data)
       }));
-      return text2(JSON.stringify(results, null, 2));
+      return text(JSON.stringify(results, null, 2));
     }
     if (name === "get_page") {
-      const key = normalizeRoute2(asString2(args.route), data);
+      const input = TOOL_INPUTS.get_page.parse(args);
+      const key = normalizeRoute2(input.route, data);
       const markdown = data.pages[key];
       if (markdown === undefined) {
-        return text2(`No page found at "${key}". Use list_pages or search_docs to find valid routes.`, true);
+        return text(`No page found at "${key}". Use list_pages or search_docs to find valid routes.`, true);
       }
-      return text2(markdown);
+      return text(markdown);
     }
     if (name === "list_pages") {
-      const contentTypes = asContentTypes(args.contentTypes);
-      const filters = asFacetFilters(args.filters);
+      const { contentTypes, filters } = TOOL_INPUTS.list_pages.parse(args);
       const routes = data.routes.filter((route) => (!contentTypes || contentTypes.includes(route.contentType)) && (!filters || matchesFacets(route.facets, filters)));
-      return text2(JSON.stringify(routes.map((route) => ({
+      return text(JSON.stringify(routes.map((route) => ({
         contentType: route.contentType,
         description: route.description,
         facets: route.facets,
@@ -21178,9 +21317,9 @@ var buildServer = (data, index) => {
       })), null, 2));
     }
     if (name === "get_navigation") {
-      return text2(JSON.stringify(data.navigation, null, 2));
+      return text(JSON.stringify(data.navigation, null, 2));
     }
-    return text2(`Unknown tool: ${name}`, true);
+    return text(`Unknown tool: ${name}`, true);
   });
   return server;
 };
@@ -21239,8 +21378,8 @@ var previewCommand = defineCommand11({
   },
   async run({ args }) {
     const root = process.cwd();
-    const { config } = await loadConfig(root);
-    const context = resolveProjectContext(root, config);
+    const { config: config2 } = await loadConfig(root);
+    const context = resolveProjectContext(root, config2);
     if (!existsSync23(join40(context.outDir, "astro.config.mjs"))) {
       logger.error("No build found. Run `blume build` first.");
       process.exit(1);
@@ -21279,8 +21418,8 @@ var syncCommand = defineCommand12({
   async run({ args }) {
     const root = process.cwd();
     if (args.force) {
-      const { config } = await loadConfig(root);
-      const context = resolveProjectContext(root, config);
+      const { config: config2 } = await loadConfig(root);
+      const context = resolveProjectContext(root, config2);
       await rm4(join41(context.outDir, "cache"), { force: true, recursive: true });
       logger.info("Cleared source cache.");
     }
@@ -21327,20 +21466,20 @@ var codexArgs2 = (lastMessagePath) => [
 var translateAgentArgs = (kind, lastMessagePath) => kind === "claude" ? claudeArgs2() : codexArgs2(lastMessagePath);
 
 // src/translate/ledger.ts
-import { createHash as createHash4 } from "node:crypto";
+import { createHash as createHash5 } from "node:crypto";
 import { readFile as readFile23 } from "node:fs/promises";
 import { join as join42 } from "pathe";
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 var LEDGER_FILE = "blume.translations.json";
-var ledgerSchema = z5.object({
-  files: z5.record(z5.string(), z5.record(z5.string(), z5.string())),
-  version: z5.literal(1)
+var ledgerSchema = z6.object({
+  files: z6.record(z6.string(), z6.record(z6.string(), z6.string())),
+  version: z6.literal(1)
 });
 var emptyLedger = () => ({
   files: {},
   version: 1
 });
-var hashSource = (text3) => createHash4("sha256").update(text3).digest("hex").slice(0, 16);
+var hashSource = (text2) => createHash5("sha256").update(text2).digest("hex").slice(0, 16);
 var readLedger = async (root) => {
   let raw;
   try {
@@ -21427,16 +21566,6 @@ var SPINNER_FRAMES = [
 ];
 var SPINNER_INTERVAL_MS = 80;
 var REWRITE = `\r${ESC}[K`;
-var seconds2 = (ms) => `${(ms / 1000).toFixed(1)}s`;
-var money2 = (cost) => cost === undefined ? "" : `$${cost.toFixed(2)}`;
-var duration2 = (ms) => {
-  if (ms < 60000) {
-    return seconds2(ms);
-  }
-  const minutes = Math.floor(ms / 60000);
-  const rest = Math.round(ms % 60000 / 1000);
-  return `${minutes}m ${rest}s`;
-};
 var itemLabel = (item) => item.kind === "page" ? `${item.sourceRel} → ${item.locale}` : `meta title${item.entries.length === 1 ? "" : "s"} (${item.entries.length}) → ${item.locale}`;
 var spinnerLine = (active, done, total, frame) => {
   const first = active[0];
@@ -21448,7 +21577,7 @@ var itemEndLine = (result) => {
   const glyph = color(GLYPH3[result.status]);
   const label = itemLabel(result.item);
   if (result.status === "translated") {
-    const cells = [seconds2(result.durationMs), money2(result.costUsd)].filter((cell) => cell !== "").join(" ");
+    const cells = [seconds(result.durationMs), money(result.costUsd)].filter((cell) => cell !== "").join(" ");
     return `  ${glyph} ${label} ${colors5.dim(cells)}`;
   }
   const word = result.status === "partial" ? "partial" : "failed";
@@ -21463,8 +21592,8 @@ var translateSummaryLine = (result, workList) => {
     counts.partial > 0 ? `${counts.partial} partial` : "",
     workList.untracked.length > 0 ? `${workList.untracked.length} adopted` : "",
     workList.upToDate > 0 ? `${workList.upToDate} already up to date` : "",
-    duration2(result.durationMs),
-    money2(result.costUsd)
+    duration(result.durationMs),
+    money(result.costUsd)
   ].filter((part) => part !== "");
   return parts.join(" · ");
 };
@@ -21605,6 +21734,8 @@ var createProgressRenderer = (options) => {
 import { existsSync as existsSync24 } from "node:fs";
 import { mkdtemp as mkdtemp4, readFile as readFile25 } from "node:fs/promises";
 import { tmpdir as tmpdir4 } from "node:os";
+import pLimit2 from "p-limit";
+import pMap7 from "p-map";
 import { join as join44 } from "pathe";
 
 // src/translate/meta.ts
@@ -21725,12 +21856,12 @@ ${JSON.stringify(titles, null, 2)}`;
 // src/translate/validate.ts
 var FRONTMATTER_OPEN = /^---\r?\n/u;
 var FENCE_LINE = /^\s*(?:```|~~~)/u;
-var stripOuterFence = (text3) => {
-  const trimmed = text3.trim();
+var stripOuterFence = (text2) => {
+  const trimmed = text2.trim();
   const match = trimmed.match(/^(?<fence>`{3,}|~{3,})[^\n]*\n(?<inner>[\s\S]*?)\n\k<fence>\s*$/u);
   return match?.groups?.inner ?? trimmed;
 };
-var countFenceLines = (text3) => text3.split(`
+var countFenceLines = (text2) => text2.split(`
 `).filter((line) => FENCE_LINE.test(line)).length;
 var getPath2 = (data, path) => {
   let value = data;
@@ -21749,8 +21880,8 @@ var setPath = (data, path, value) => {
   }
   parent[path.at(-1)] = value;
 };
-var ensureTrailingNewline = (text3) => text3.endsWith(`
-`) ? text3 : `${text3}
+var ensureTrailingNewline = (text2) => text2.endsWith(`
+`) ? text2 : `${text2}
 `;
 var validateTranslation = (sourceText, agentText) => {
   const candidate = stripOuterFence(agentText);
@@ -21829,11 +21960,6 @@ var metaDirKey = (dir) => dir === "" ? "." : dir;
 var invokeAgent = async (context, prompt, index) => {
   const messagePath = join44(context.dir, `message-${index}.txt`);
   const result = await context.run(context.bin, translateAgentArgs(context.kind, messagePath), { cwd: context.dir, prompt, timeoutMs: context.timeoutMs });
-  if (!result.timedOut && result.code === WINDOWS_COMMAND_NOT_FOUND) {
-    const missing = new Error(`${context.bin} was not found on PATH`);
-    missing.code = "ENOENT";
-    throw missing;
-  }
   return await readAgentOutput(context.kind, result, messagePath);
 };
 var runPageItem = async (item, index, context, ledger) => {
@@ -21922,37 +22048,26 @@ var runTranslate = async (options) => {
     timeoutMs: options.timeoutMs ?? DEFAULT_TRANSLATE_TIMEOUT_MS
   };
   const { items } = options.workList;
-  const results = Array.from({ length: items.length });
   const concurrency = Math.max(1, Math.min(options.concurrency ?? 1, items.length || 1));
-  let persisting = Promise.resolve();
-  const persist = () => {
-    persisting = persisting.then(() => options.persistLedger?.());
-    return persisting;
-  };
-  let nextIndex = 0;
-  const worker = async () => {
-    while (nextIndex < items.length) {
-      const index = nextIndex;
-      nextIndex += 1;
-      const item = items[index];
-      options.onProgress?.({
-        index,
-        item,
-        kind: "item-start",
-        total: items.length
-      });
-      const result = await (item.kind === "page" ? runPageItem(item, index, context, options.ledger) : runMetaItem(item, index, context, options.ledger));
-      results[index] = result;
-      await persist();
-      options.onProgress?.({
-        index,
-        kind: "item-end",
-        result,
-        total: items.length
-      });
-    }
-  };
-  await Promise.all(Array.from({ length: concurrency }, () => worker()));
+  const persistLimit = pLimit2(1);
+  const persist = () => persistLimit(() => options.persistLedger?.());
+  const results = await pMap7(items, async (item, index) => {
+    options.onProgress?.({
+      index,
+      item,
+      kind: "item-start",
+      total: items.length
+    });
+    const result = await (item.kind === "page" ? runPageItem(item, index, context, options.ledger) : runMetaItem(item, index, context, options.ledger));
+    await persist();
+    options.onProgress?.({
+      index,
+      kind: "item-end",
+      result,
+      total: items.length
+    });
+    return result;
+  }, { concurrency });
   const diagnostics = [];
   for (const result of results) {
     if (result.status !== "translated") {
@@ -22106,7 +22221,7 @@ var computeWorkList = async (project, ledger, options = {}) => {
 
 // src/cli/commands/translate.ts
 var DEFAULT_TIMEOUT_S2 = DEFAULT_TRANSLATE_TIMEOUT_MS / 1000;
-var DEFAULT_CONCURRENCY = 4;
+var DEFAULT_CONCURRENCY2 = 4;
 var MAX_CONCURRENCY = 16;
 var parseFlags2 = (args) => {
   const agents = Object.keys(AGENTS).filter((kind) => args[kind]);
@@ -22127,7 +22242,7 @@ var parseFlags2 = (args) => {
     logger.error(`Invalid --timeout "${args.timeout}" (whole seconds).`);
     process.exit(1);
   }
-  const concurrency = args.concurrency === undefined ? DEFAULT_CONCURRENCY : Number(args.concurrency);
+  const concurrency = args.concurrency === undefined ? DEFAULT_CONCURRENCY2 : Number(args.concurrency);
   if (!Number.isInteger(concurrency) || concurrency < 1 || concurrency > MAX_CONCURRENCY) {
     logger.error(`Invalid --concurrency "${args.concurrency}" (use 1..${MAX_CONCURRENCY}).`);
     process.exit(1);
@@ -22174,7 +22289,7 @@ var translateCommand = defineCommand13({
       type: "boolean"
     },
     concurrency: {
-      description: `Parallel agent sessions. Defaults to ${DEFAULT_CONCURRENCY}, max ${MAX_CONCURRENCY}.`,
+      description: `Parallel agent sessions. Defaults to ${DEFAULT_CONCURRENCY2}, max ${MAX_CONCURRENCY}.`,
       type: "string"
     },
     force: {
@@ -22593,5 +22708,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=84600BB45DA0E5EB64756E2164756E21
+//# debugId=07BF7082AA0A5EEC64756E2164756E21
 //# sourceMappingURL=index.js.map