blume 2.0.2 → 2.0.3

package/src/astro/runtime-modules.ts

@@ -8,11 +8,11 @@
  * generated pages through aliases or relative paths. `generateRuntime` now
  * publishes them here and `runtimeModulesPlugin` serves them to Vite as
  * virtual modules, so a regeneration never round-trips the disk or waits on a
- * file watcher: publishing invalidates the changed modules in every live dev
- * server (Vite walks the importers, so the pages that render them re-evaluate
- * on the next request) and asks the browser to reload — the same effect a JSON
- * file change used to reach through the watcher, minus the write and the
- * watch debounce.
+ * file watcher: publishing invalidates the changed modules in every Vite
+ * environment of every live dev server (Vite walks the importers, so the
+ * pages that render them re-evaluate on the next request) and asks the
+ * browser to reload — the same effect a JSON file change used to reach
+ * through the watcher, minus the write and the watch debounce.
  *
  * The registry hangs off `globalThis`, not module state. On a published
  * install the CLI bundle (`dist/cli`) carries its own copy of this module,
@@ -61,18 +61,29 @@ interface RuntimeModuleNode {
   id: string | null;
 }
 
+/** One Vite environment's module graph, as far as the registry touches it. */
+interface RuntimeModuleGraph {
+  getModuleById: (id: string) => RuntimeModuleNode | undefined;
+  invalidateModule: (mod: RuntimeModuleNode) => void;
+}
+
 /**
  * The Vite dev-server slice the registry touches (structurally typed, like
  * every Blume-authored Vite plugin — see `includeHmrPlugin`).
  */
 export interface RuntimeModuleServer {
+  /**
+   * Every Vite environment, each with its own module graph. `moduleGraph` on
+   * the server itself is Vite's backward-compatible view of only `client`
+   * and `ssr`, and those are not the only environments that render: with
+   * `@astrojs/cloudflare` the `ssr` environment runs in workerd, so Astro
+   * renders the prerendered pages (every content page) in its `prerender`
+   * environment instead.
+   */
+  environments: Record<string, { moduleGraph: RuntimeModuleGraph }>;
   httpServer?: {
     once: (event: "close", listener: () => void) => void;
   } | null;
-  moduleGraph: {
-    getModuleById: (id: string) => RuntimeModuleNode | undefined;
-    invalidateModule: (mod: RuntimeModuleNode) => void;
-  };
   ws: { send: (payload: { type: "full-reload" }) => void };
 }
 
@@ -131,10 +142,14 @@ export const publishRuntimeModules = (
     return changed;
   }
   for (const server of servers) {
-    for (const id of changed) {
-      const mod = server.moduleGraph.getModuleById(`${RESOLVED_PREFIX}${id}`);
-      if (mod) {
-        server.moduleGraph.invalidateModule(mod);
+    // Every environment that loaded a module holds its own copy, and any of
+    // them may be the one rendering pages on this adapter.
+    for (const { moduleGraph } of Object.values(server.environments)) {
+      for (const id of changed) {
+        const mod = moduleGraph.getModuleById(`${RESOLVED_PREFIX}${id}`);
+        if (mod) {
+          moduleGraph.invalidateModule(mod);
+        }
       }
     }
     server.ws.send({ type: "full-reload" });

package/src/astro/templates.ts

@@ -19,9 +19,12 @@ import { deployPlatform } from "../deploy/platforms/index.ts";
 import { adapterRoot, distDir } from "../deploy/platforms/paths.ts";
 import { applyBaseToAstroRedirects } from "../deploy/redirects.ts";
 import type { OgCache } from "../og/cache.ts";
-import type { OgFont, OgFontFamilies } from "../og/card.ts";
+import type { OgFont, OgFontFamilies, OgGoogleFont } from "../og/card.ts";
 import type { MixedbreadOptions } from "../search/adapters/mixedbread.ts";
-import type { ResolvedSearchAdapter } from "../search/adapters/registry.ts";
+import type {
+  ResolvedSearchAdapter,
+  SearchAdapterKind,
+} from "../search/adapters/registry.ts";
 import { buildFontEntries, fontLocaleCodes } from "../theme/fonts.ts";
 import { importSpecifier, wrapperPropsType } from "./component-slots.ts";
 import type { ExampleSpec } from "./examples.ts";
@@ -398,14 +401,32 @@ export interface ClientFeatures {
 /** Every feature on: what a checkout that predates the detection shipped. */
 const ALL_CLIENT_FEATURES: ClientFeatures = { epub: true, mermaid: true };
 
+/**
+ * The npm module each browser-queried search adapter's client imports (see
+ * `components/layout/search/`). The `<Search>` dialog lazy-imports that client
+ * on first open, after the dev dep optimizer's startup run, so the first
+ * search of a fresh `blume dev` session discovered the library, re-ran the
+ * optimizer, and reloaded the page. Pagefind loads its script from the build
+ * output and Mixedbread queries through the server, so neither has one.
+ */
+const SEARCH_CLIENT_DEPS: Partial<Record<SearchAdapterKind, string>> = {
+  algolia: "algoliasearch/lite",
+  flexsearch: "flexsearch",
+  orama: "@orama/orama",
+  "orama-cloud": "@oramacloud/client",
+  typesense: "typesense",
+};
+
 const resolveOptimizeDeps = (options: {
   aliases: Record<string, string> | undefined;
   context: ProjectContext;
   features: ClientFeatures;
   needsReact: boolean;
   reactCompilerPath: string | null | undefined;
+  searchKind: SearchAdapterKind;
 }): OptimizeDepsConfig => {
   const { context, features } = options;
+  const searchDep = SEARCH_CLIENT_DEPS[options.searchKind];
   const optimizeDepsEntries = [
     ...(context.pagesRoot ? [`${context.pagesRoot}/**/*.astro`] : []),
     `${context.root}/islands/**/*.{jsx,svelte,tsx,vue}`,
@@ -418,6 +439,8 @@ const resolveOptimizeDeps = (options: {
     // Mermaid costs the dev server seconds at startup for nothing otherwise.
     ...(features.mermaid ? ["blume > mermaid"] : []),
     ...(features.epub ? ["blume > epub-gen-memory/bundle"] : []),
+    // Only the configured search adapter's client library.
+    ...(searchDep ? [`blume > ${searchDep}`] : []),
     // Astro's own client-router/prefetch virtual modules are deliberately NOT
     // forced in here: they read Vite `define`-injected constants
     // (__PREFETCH_PREFETCH_ALL__ and friends) that a pre-bundled copy loses,
@@ -538,7 +561,7 @@ const blumeIntegrationOptions = (options: {
         buildArtifactsRoot: ".",
         contentRoutes: options.contentRoutes,
         homeLinkHeader:
-          buildHomeLinkHeader(options.config, options.contentRoutes) ??
+          buildHomeLinkHeader(options.config, options.contentRoutes, "dev") ??
           undefined,
         pages: options.pages,
       }
@@ -623,6 +646,7 @@ export const astroConfigTemplate = (options: {
     features,
     needsReact,
     reactCompilerPath: options.reactCompilerPath,
+    searchKind: config.search.provider.kind,
   });
 
   const {
@@ -660,7 +684,8 @@ export const astroConfigTemplate = (options: {
   const basedRedirects = applyBaseToAstroRedirects(
     config.redirects,
     config.basePath,
-    deployment.options.base ?? ""
+    deployment.options.base ?? "",
+    new Set(contentRoutes)
   );
   const redirectsOption =
     basedRedirects.length > 0
@@ -892,6 +917,10 @@ ${userConfigSetup}export default defineConfig({
     // \`/bundle\` subpath that is actually imported: optimizing the package
     // root leaves that entry out. Production (Rollup) already handles the
     // interop, so all of this only affects dev.
+    //
+    // The search adapter's client library rides the list for the same reason
+    // as the compiler runtime: the search dialog lazy-imports it on first
+    // open, and discovering it then re-optimizes and reloads the page.
     optimizeDeps: {
       entries: ${JSON.stringify(optimizeDepsEntries)},
       include: ${JSON.stringify(optimizeDepsInclude)},
@@ -1246,9 +1275,15 @@ export const askEndpointTemplate = (
     "messages",
     ...backend.template.fields,
   ];
+  // The request's signal aborts when the reader closes the panel mid-answer
+  // (the client drops the connection): passing it on stops the model call,
+  // which otherwise kept generating, and billing, to completion into a closed
+  // connection. `streamText` ends an aborted call through its abort path, not
+  // `onError`, so the reader leaving is never logged as a provider error.
   const call = `    const result = streamText({
       ${streamFields.join(",\n      ")},
 ${onError}
+      abortSignal: request.signal,
     });`;
   const stream = grounded
     ? `    const instructions =
@@ -1792,7 +1827,7 @@ export const navFragmentTemplate = (): string =>
   `---
 // Generated by Blume. Do not edit.
 import NavTree from "blume/components/layout/NavTree.astro";
-import { withBase } from "blume/components/islands/base-path.ts";
+import { withMountedBase } from "blume/components/islands/base-path.ts";
 import {
   hiddenDefaultLocale,
   navGroupIds,
@@ -1831,7 +1866,7 @@ if (!(variant && node && node.kind === "group")) {
 }
 const strings =
   locale === "default" ? data.ui.nav : (data.uiByLocale[locale] ?? data.ui).nav;
-const fragmentBase = withBase(\`/blume-nav/\${version}/\${locale}\`);
+const fragmentBase = withMountedBase(\`/blume-nav/\${version}/\${locale}\`);
 ---
 
 <NavTree
@@ -1855,6 +1890,7 @@ export const ogEndpointTemplate = (
      * Absent, every card renders on every build.
      */
     cache?: OgCache;
+    fallbacks?: OgGoogleFont[];
     families?: OgFontFamilies;
     fonts?: OgFont[];
     /**
@@ -1868,7 +1904,7 @@ export const ogEndpointTemplate = (
 ): string =>
   `// Generated by Blume. Do not edit.
 import { cachedOgImage } from "blume/og";
-import type { OgCache, OgFont, OgFontFamilies } from "blume/og";
+import type { OgCache, OgFont, OgFontFamilies, OgGoogleFont } from "blume/og";
 import data from "blume:data";
 
 export const prerender = true;
@@ -1886,6 +1922,9 @@ const fonts: OgFont[] = ${JSON.stringify(og.fonts ?? [])};
 const families: OgFontFamilies | undefined = ${
     og.families ? JSON.stringify(og.families) : "undefined"
   };
+// Script fallbacks (Noto families, the configured locales' first). A card
+// fetches them only when its text has a glyph Takumi's built-in font lacks.
+const fallbacks: OgGoogleFont[] = ${JSON.stringify(og.fallbacks ?? [])};
 
 // Rendered cards are kept on disk between builds, keyed by everything that
 // decides their pixels, so a rebuild renders only the cards whose title,
@@ -1958,6 +1997,7 @@ export async function GET({ props }: { props: CardProps }) {
     accent: data.config.og.palette?.accent ?? data.config.theme.accent.light,
     brand: data.config.title,
     description: props.description ?? data.config.og.description,
+    fallbacks,
     families,
     fonts,
     logo: data.config.og.logo,
@@ -2153,8 +2193,8 @@ export const catchAllPageTemplate = (options: {
 import { getEntry, render } from "astro:content";
 import type { CollectionKey } from "astro:content";
 import RootLayout from "blume/components/layout/RootLayout.astro";
-import { withBase } from "blume/components/islands/base-path.ts";
-import { stripBasePath, withBasePath } from "blume/core/base-path.ts";
+import { withBase, withMountedBase } from "blume/components/islands/base-path.ts";
+import { mountBasePath, stripBasePath } from "blume/core/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
 ${componentImports}
 import data from "blume:data";
@@ -2219,12 +2259,16 @@ const base = data.config.site ? data.config.site.replace(/\\/$/, "") : null;
 const ogPath = data.config.og.enabled
   ? 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):
 // \`site + base + path\`. Only absolutize root-relative paths: \`seo.image\` may be
-// an external URL, which passes through verbatim (mirrors PageLayout).
-const ogImage =
-  ogRel && base && ogRel.startsWith("/") ? \`\${base}\${withBase(ogRel)}\` : ogRel;
+// an external URL, which passes through verbatim (mirrors PageLayout). An
+// authored \`seo.image\` keeps a base written by hand; the generated card is
+// always mounted under it.
+const absoluteOg = (path: string, based: (path: string) => string) =>
+  base && path.startsWith("/") ? \`\${base}\${based(path)}\` : path;
+const ogImage = seo.image
+  ? absoluteOg(seo.image, withBase)
+  : ogPath && absoluteOg(ogPath, withMountedBase);
 // Blume's generated card has known dimensions the layout can declare; a user's
 // \`seo.image\` could be any size or format, so it gets none.
 const ogGenerated = !seo.image && Boolean(ogPath);
@@ -2233,7 +2277,7 @@ const ogGenerated = !seo.image && Boolean(ogPath);
 // itself (a guest post crediting its own author) over the configured default.
 const x = { ...data.config.x, ...(seo.x?.creator ? { creator: seo.x.creator } : {}) };
 
-const basedRoute = withBase(route);
+const basedRoute = withMountedBase(route);
 
 // Locale resolution. With i18n on, pick the active locale's nav + dictionary,
 // build hreflang alternates, and derive the language-switcher targets.
@@ -2281,7 +2325,7 @@ const contentDir = i18n
   : "ltr";
 // The root route keeps its trailing slash (\`https://site/\`) so canonical and
 // hreflang URLs byte-match the sitemap's <loc> for the home page.
-const absolute = (path: string) => base + withBase(path);
+const absolute = (path: string) => base + withMountedBase(path);
 
 // A fallback page renders the fallback locale's page at this locale's URL, so
 // its canonical names the page it copies, and search engines never rank the
@@ -2326,7 +2370,7 @@ const xDefault = defaultAlt && base ? absolute(defaultAlt.path) : null;
 // carries sits *after* the base (\`/docs/ja/guide\`), while \`localePrefix\` is
 // base-less (\`/ja\`). Stripping and re-adding a locale therefore happen in
 // base-less space, with the base re-applied at the end — the same
-// \`withBasePath(basePath, localizeRoute(...))\` composition the manifest uses to
+// \`mountBasePath(basePath, localizeRoute(...))\` composition the manifest uses to
 // build every real route. Done in based space, \`stripLocale\` matches nothing
 // and \`localizeRoute\` prepends a second prefix (\`/ja/docs/ja/guide\`). Only a
 // switcher entry for a locale with no real translation reaches this fallback:
@@ -2334,7 +2378,7 @@ const xDefault = defaultAlt && base ? absolute(defaultAlt.path) : null;
 // generated reference (which has no \`alternates\` at all) for every locale
 // but its own.
 const mountLocalized = (logical: string, codeArg: string) =>
-  withBasePath(data.config.basePath, localizeRoute(logical, codeArg));
+  mountBasePath(data.config.basePath, localizeRoute(logical, codeArg));
 const logicalRoute = i18n
   ? stripLocale(stripBasePath(data.config.basePath, route), locale)
   : route;
@@ -2363,7 +2407,7 @@ const versionRootFor = (id: string) => {
   const logical = id ? \`/\${id}\` : "/";
   return i18n
     ? mountLocalized(logical, locale)
-    : withBasePath(data.config.basePath, logical);
+    : mountBasePath(data.config.basePath, logical);
 };
 const samePageSwitch = versionsConfig
   ? versionsConfig.switcher.redirect === "same-page"
@@ -2463,7 +2507,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   exportEpub={${options.exportEpub}}${
     options.navFragments
       ? `
-  navFragmentBase={withBase(\`/blume-nav/\${version || "current"}/\${i18n && localePrefix(locale) ? locale : "default"}\`)}`
+  navFragmentBase={withMountedBase(\`/blume-nav/\${version || "current"}/\${i18n && localePrefix(locale) ? locale : "default"}\`)}`
       : ""
   }
   openInChat={data.config.openInChat}
@@ -2516,7 +2560,7 @@ export const changelogIndexTemplate = (options: {
 // Generated by Blume. Do not edit.
 import { getCollection } from "astro:content";
 import RootLayout from "blume/components/layout/RootLayout.astro";
-import { withBase } from "blume/components/islands/base-path.ts";
+import { withMountedBase } from "blume/components/islands/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
 import { resolveDateFormatOptions } from "blume/core/date-format.ts";
 import { layoutOverrides } from "../generated/components.ts";
@@ -2615,7 +2659,7 @@ const items = changelogEntries.map((entry) => {
   return {
     date: date ? formatRowDate(date) : null,
     dateTime: date ? date.toISOString().slice(0, 10) : null,
-    href: route ? withBase(route) : null,
+    href: route ? withMountedBase(route) : null,
     id: slugify(label),
     label,
     tag: entry.data.changelog?.category ?? null,
@@ -2651,14 +2695,14 @@ for (const item of items) {
 
 const base = data.config.site ? data.config.site.replace(/\\/$/, "") : null;
 // The canonical URL carries the deployment base (the page is served under it),
-// matching how the catch-all canonicalizes via \`withBase(route)\`.
-const basedRoute = withBase("/changelog");
+// matching how the catch-all canonicalizes via \`withMountedBase(route)\`.
+const basedRoute = withMountedBase("/changelog");
 const canonical = base ? base + basedRoute : null;
 
 // The generated OG card for this route (the /og endpoint emits it alongside
 // the content-route cards), absolutized like the catch-all's so crawlers get
 // a full URL when the site is known.
-const ogPath = data.config.og.enabled ? withBase("/og/changelog.png") : null;
+const ogPath = data.config.og.enabled ? withMountedBase("/og/changelog.png") : null;
 const ogImage = ogPath && base ? base + ogPath : ogPath;
 
 // The page chrome (h1, title, description) comes from the translatable
@@ -2780,8 +2824,8 @@ export const notFoundPageTemplate = (): string => `---
 // Generated by Blume. Do not edit. Override by adding \`pages/404.astro\`.
 import Icon from "blume/components/Icon.astro";
 import PageLayout from "blume/components/layout/PageLayout.astro";
-import { withBase } from "blume/components/islands/base-path.ts";
-import { withBasePath } from "blume/core/base-path.ts";
+import { withMountedBase } from "blume/components/islands/base-path.ts";
+import { mountBasePath } from "blume/core/base-path.ts";
 import data from "blume:data";
 
 export const prerender = true;
@@ -2805,14 +2849,14 @@ const htmlLang = i18n ? i18n.defaultLocale : "en";
 // their resolved target when the section has no index page of its own.
 const suggestions = [
   ...data.navigation.tabs.map((tab) => ({
-    href: withBase(tab.href ?? tab.path),
+    href: withMountedBase(tab.href ?? tab.path),
     label: tab.label,
   })),
   ...(data.config.discovery.sitemap
-    ? [{ href: withBase("/sitemap.xml"), label: nf.sitemap }]
+    ? [{ href: withMountedBase("/sitemap.xml"), label: nf.sitemap }]
     : []),
   ...(data.config.discovery.llmsTxt
-    ? [{ href: withBase("/llms.txt"), label: nf.llms }]
+    ? [{ href: withMountedBase("/llms.txt"), label: nf.llms }]
     : []),
 ];
 
@@ -2824,7 +2868,7 @@ const suggestions = [
 // Localized routes sit under both bases (\`{deployment.base}/{basePath}/ar/…\`),
 // so the script strips the two together, trailing slash included.
 const { basePath } = data.config;
-const siteRoot = withBase(withBasePath(basePath, "/"));
+const siteRoot = withMountedBase(mountBasePath(basePath, "/"));
 const localeBase = siteRoot.endsWith("/") ? siteRoot : siteRoot + "/";
 const localized = Object.fromEntries(
   (i18n?.locales ?? [])
@@ -2837,7 +2881,7 @@ const localized = Object.fromEntries(
           description: strings.description,
           dir: l.dir ?? "ltr",
           home: strings.home,
-          homeHref: withBase(withBasePath(basePath, "/" + l.code)),
+          homeHref: withMountedBase(mountBasePath(basePath, "/" + l.code)),
           suggestions: strings.suggestions,
           title: strings.title,
         },
@@ -2887,7 +2931,7 @@ const localizedJson = JSON.stringify(localized).replaceAll("<", "\\\\u003c");
       <a
         class="mt-8 inline-flex items-center gap-1.5 rounded-full bg-accent py-2 pe-4 ps-3.5 text-sm font-medium text-accent-foreground transition-opacity hover:opacity-90"
         data-nf-home
-        href={withBase("/")}
+        href={withMountedBase("/")}
       >
         <Icon class="rtl:-scale-x-100" name="arrow-left" size={14} />
         <span data-nf="home">{nf.home}</span>
@@ -2969,7 +3013,7 @@ const localizedJson = JSON.stringify(localized).replaceAll("<", "\\\\u003c");
  */
 export const notFoundMarkdownTemplate =
   (): string => `// Generated by Blume. Do not edit. Override by adding \`pages/404.astro\`.
-import { withBase } from "blume/components/islands/base-path.ts";
+import { withMountedBase } from "blume/components/islands/base-path.ts";
 import { absoluteUrl } from "blume/core/site-url.ts";
 import data from "blume:data";
 
@@ -2980,7 +3024,7 @@ const nf = data.ui.notFound;
 // Absolute for internal routes when the site is known; an external tab href
 // passes through untouched.
 const href = (path: string): string => {
-  const based = withBase(path);
+  const based = withMountedBase(path);
   return data.config.site && based.startsWith("/") && !based.startsWith("//")
     ? absoluteUrl(data.config.site, based)
     : based;
@@ -3039,7 +3083,7 @@ export function GET() {
 export const notFoundJsonTemplate =
   (): string => `// Generated by Blume. Do not edit. Override by adding \`pages/404.astro\`.
 import { problem } from "blume/ai/api/problem.ts";
-import { withBase } from "blume/components/islands/base-path.ts";
+import { withMountedBase } from "blume/components/islands/base-path.ts";
 import { absoluteUrl } from "blume/core/site-url.ts";
 import data from "blume:data";
 
@@ -3050,7 +3094,7 @@ const nf = data.ui.notFound;
 // Absolute for internal routes when the site is known; an external tab href
 // passes through untouched.
 const href = (path: string): string => {
-  const based = withBase(path);
+  const based = withMountedBase(path);
   return data.config.site && based.startsWith("/") && !based.startsWith("//")
     ? absoluteUrl(data.config.site, based)
     : based;
@@ -3225,7 +3269,7 @@ ${wrapperPropsType("Example")}
 /**
  * The route prefix `<Component />` preview frames are served under:
  * `{basePath}/blume-examples/<example path>`. `deployment.base` is layered on
- * top by Astro (components apply it with `withBase`).
+ * top by Astro (components apply it with `withMountedBase`).
  */
 export const examplesRouteBase = (basePath: string): string =>
   `${basePath}/blume-examples`;

package/src/audit/checks/links.ts

@@ -14,6 +14,9 @@ import { isServed, normalizePath, resolveHref, siteOrigin } from "../url.ts";
 /** Browser-magic fragments that scroll without needing a matching id. */
 const MAGIC_FRAGMENTS = new Set(["", "top"]);
 
+/** Where a fragment's directives (text fragments) start. */
+const FRAGMENT_DIRECTIVE = ":~:";
+
 /** Whether a fragment lands on an id of the target page. */
 const anchorResolves = (target: PageSnapshot, fragment: string): boolean => {
   if (MAGIC_FRAGMENTS.has(fragment)) {
@@ -65,8 +68,12 @@ export const linkChecks: CheckModule = {
       page: PageSnapshot,
       link: SnapshotLink,
       target: PageSnapshot,
-      fragment: string
+      hash: string
     ): void => {
+      // A text fragment (`#:~:text=…`) is a directive the browser strips
+      // before it looks for an id; only the part in front of `:~:` names an
+      // element, and an empty one scrolls to the text instead.
+      const [fragment = ""] = hash.split(FRAGMENT_DIRECTIVE);
       if (anchorResolves(target, fragment)) {
         return;
       }

package/src/audit/graph.ts

@@ -58,7 +58,8 @@ export const buildGraph = (
  * Non-indexable pages are excluded — a `noindex` page is *meant* to be
  * unreachable — as is the home page, which is nobody's job to link to. Under a
  * `basePath` the home page's built URL is the base itself, so the caller names
- * it via `homeUrl`.
+ * it via `homeUrl`. An i18n fallback copy is excluded too: it stands in for a
+ * translation nobody has written yet, so the page to link to is the original.
  */
 export const orphanPages = (
   pages: PageSnapshot[],
@@ -68,6 +69,7 @@ export const orphanPages = (
   pages.filter(
     (page) =>
       page.indexable &&
+      page.route?.fallback !== true &&
       page.url !== "/" &&
       page.url !== homeUrl &&
       (graph.contentIn.get(page.url)?.size ?? 0) === 0

package/src/audit/run.ts

@@ -2,10 +2,12 @@ import { readFile } from "node:fs/promises";
 
 import pMap from "p-map";
 
-import { normalizeBasePath, withBasePath } from "../core/base-path.ts";
+import { normalizeBasePath } from "../core/base-path.ts";
+import { routeSetFor } from "../core/locale-links.ts";
 import type { BlumeProject } from "../core/project-graph.ts";
 import type { Diagnostic } from "../core/types.ts";
 import { deployStaticDir } from "../deploy/adapter-output.ts";
+import { applyBaseToAstroRedirects } from "../deploy/redirects.ts";
 import { CHECKS } from "./catalog.ts";
 import type { CheckId } from "./catalog.ts";
 import { assetChecks } from "./checks/assets.ts";
@@ -162,14 +164,15 @@ export const runAudit = async (options: AuditOptions): Promise<AuditResult> => {
     redirects: resolveRedirects(
       // Redirects are authored as if mounted at root; the built page URLs they
       // are checked against carry `basePath` (it's a real directory in the
-      // build), so both sides gain it here — mirroring what
-      // `applyBaseToAstroRedirects` does at build time. `withBasePath` is
-      // idempotent and leaves external `to` URLs untouched.
-      project.config.redirects.map((redirect) => ({
-        ...redirect,
-        from: withBasePath(basePath, redirect.from),
-        to: withBasePath(basePath, redirect.to),
-      })),
+      // build), so both sides gain it here, based exactly as the build bases
+      // them — a `to` naming a public file stays at the root, and external
+      // `to` URLs pass through.
+      applyBaseToAstroRedirects(
+        project.config.redirects,
+        basePath,
+        "",
+        routeSetFor(project.manifest.routes)
+      ),
       // Pages, static files, and server routes alike: a redirect may
       // legitimately land on a served asset (`/old-whitepaper` ->
       // `/files/whitepaper.pdf`), and the same predicate the link and llms.txt

package/src/audit/snapshot.ts

@@ -196,8 +196,13 @@ export const buildSnapshot = (options: {
     scripts: collectAssets(document, "script[src]", "src"),
     source: route?.sourcePath,
     styles: collectAssets(document, 'link[rel="stylesheet"][href]', "href"),
+    // Only the document's own titles: an accessible inline SVG carries a
+    // `<title>` of its own (an SVG-namespace element, not the page title), and
+    // counting it would flag BLUME_AUDIT_TITLE_MULTIPLE — or stand in for a
+    // head `<title>` that is genuinely missing.
     titles: document
       .querySelectorAll("title")
+      .filter((title) => !title.closest("svg"))
       .map((title) => title.text.trim())
       .filter((text) => text.length > 0),
     twitter: prefixedMeta(document, "name", "twitter:"),

package/src/cli/args.ts

@@ -21,3 +21,35 @@ export const parsePort = (value?: string): number | undefined => {
   }
   return port;
 };
+
+/**
+ * The longest `--timeout` a timer can hold, in seconds. Node clamps a
+ * `setTimeout` delay above 2^31−1 ms (about 24.8 days) to 1 ms, so a larger
+ * value would time every agent out the moment it starts.
+ */
+export const MAX_TIMEOUT_S = Math.floor(2_147_483_647 / 1000);
+
+/**
+ * Parse a `--timeout` value in whole seconds, or return `fallback` when unset.
+ * A non-integer, non-positive, or too-long value exits with an error.
+ */
+export const parseTimeoutSeconds = (
+  value: string | undefined,
+  fallback: number
+): number => {
+  if (value === undefined) {
+    return fallback;
+  }
+  const timeout = Number(value);
+  if (!Number.isInteger(timeout) || timeout <= 0) {
+    logger.error(`Invalid --timeout "${value}" (whole seconds).`);
+    process.exit(1);
+  }
+  if (timeout > MAX_TIMEOUT_S) {
+    logger.error(
+      `Invalid --timeout "${value}" (at most ${MAX_TIMEOUT_S} seconds, about 24 days).`
+    );
+    process.exit(1);
+  }
+  return timeout;
+};

package/src/cli/commands/audit.ts

@@ -238,7 +238,10 @@ export const auditCommand = defineCommand({
     process.stderr.write(formatReport(result, root, { verbose: args.verbose }));
 
     if (shouldFail(result, gate)) {
-      process.exit(1);
+      // Set the code and return rather than `process.exit`, which doesn't wait
+      // for a piped stderr: a long report was cut off after the first 64 KiB,
+      // in exactly the CI logs that need to show every finding.
+      process.exitCode = 1;
     }
   },
 });

package/src/cli/commands/doctor.ts

@@ -187,7 +187,9 @@ export const doctorCommand = defineCommand({
       logger.success("No problems found.");
     }
     if (hadErrors) {
-      process.exit(1);
+      // Set the code and return rather than `process.exit`, which doesn't wait
+      // for a piped stderr: a long diagnostic list would be cut off.
+      process.exitCode = 1;
     }
   },
 });