blume 2.1.0 → 2.1.1

package/dist/cli/{chunk-713mngdq.js → chunk-hebn0tpx.js}

@@ -35,7 +35,13 @@ import { z as z2 } from "zod";
 import { z } from "zod";
 
 // src/search/orama-index.ts
-import { create, insertMultiple, search } from "@orama/orama";
+import {
+  components,
+  create,
+  insert,
+  insertMultiple,
+  search
+} from "@orama/orama";
 var SCHEMA = {
   content: "string",
   contentType: "enum",
@@ -143,16 +149,55 @@ var segmentingTokenizer = (locale) => {
     }
   };
 };
+var translationTokenizers = new WeakMap;
+var localeTokenizers = (documents) => {
+  const tokenizers = new Map;
+  for (const code of new Set(documents.map((doc) => doc.locale ?? ""))) {
+    const tokenizer = segmentingTokenizer(code);
+    if (tokenizer) {
+      tokenizers.set(code, tokenizer);
+    }
+  }
+  return tokenizers;
+};
+var dispatchingTokenizer = (tokenizers) => {
+  const standard = components.tokenizer.createTokenizer();
+  return {
+    language: standard.language,
+    normalizationCache: standard.normalizationCache,
+    tokenize: (raw, language, prop, withCache) => (tokenizers.get(language ?? "") ?? standard).tokenize(raw, undefined, prop, withCache)
+  };
+};
 var buildOramaIndex = async (documents, locale) => {
+  const rows = documents.map((doc) => doc.facets ? { ...doc, facetTerms: toFacetTerms(doc.facets) } : doc);
   const tokenizer = segmentingTokenizer(locale);
-  const db = tokenizer ? create({ components: { tokenizer }, schema: SCHEMA }) : create({ schema: SCHEMA });
-  await insertMultiple(db, documents.map((doc) => doc.facets ? { ...doc, facetTerms: toFacetTerms(doc.facets) } : doc));
+  const translations = tokenizer ? undefined : localeTokenizers(documents);
+  let db;
+  if (translations && translations.size > 0) {
+    db = create({
+      components: { tokenizer: dispatchingTokenizer(translations) },
+      schema: SCHEMA
+    });
+    for (const row of rows) {
+      await insert(db, row, row.locale);
+    }
+    translationTokenizers.set(db, translations);
+  } else {
+    db = tokenizer ? create({ components: { tokenizer }, schema: SCHEMA }) : create({ schema: SCHEMA });
+    await insertMultiple(db, rows);
+  }
   if (documents.some((doc) => (doc.boost ?? 1) !== 1)) {
     boostedDatabases.add(db);
   }
   return db;
 };
 var ALL_TOKENS = 0;
+var rankedHits = async (db, params, language, bigrammed) => {
+  const strict = bigrammed ? await search(db, { ...params, threshold: ALL_TOKENS }, language) : undefined;
+  const found = strict && strict.hits.length > 0 ? strict : await search(db, params, language);
+  return found.hits;
+};
+var boostedScore = (hit) => hit.score * (hit.document.boost ?? 1);
 var queryOramaIndex = async (db, term, limit, filters) => {
   const facetTerms = filters?.facets ? toFacetTerms(filters.facets) : [];
   const where = {};
@@ -176,10 +221,27 @@ var queryOramaIndex = async (db, term, limit, filters) => {
     term
   };
   const params = Object.keys(where).length > 0 ? { ...unfiltered, where } : unfiltered;
-  const bigrammed = isBigramLanguage(db.tokenizer?.language ?? "");
-  const strict = bigrammed ? await search(db, { ...params, threshold: ALL_TOKENS }) : undefined;
-  const found = strict && strict.hits.length > 0 ? strict : await search(db, params);
-  return found.hits.map((hit) => hit.document);
+  const translations = translationTokenizers.get(db);
+  if (!translations) {
+    const bigrammed = isBigramLanguage(db.tokenizer?.language ?? "");
+    const hits = await rankedHits(db, params, undefined, bigrammed);
+    return hits.map((hit) => hit.document);
+  }
+  if (filters?.locale) {
+    const { language = "" } = translations.get(filters.locale) ?? {};
+    const bigrammed = isBigramLanguage(language);
+    const hits = await rankedHits(db, params, filters.locale, bigrammed);
+    return hits.map((hit) => hit.document);
+  }
+  const searches = [
+    rankedHits(db, {
+      ...params,
+      where: { ...where, locale: { nin: [...translations.keys()] } }
+    }, undefined, false),
+    ...[...translations].map(([code, tokenizer]) => rankedHits(db, { ...params, where: { ...where, locale: { eq: code } } }, code, isBigramLanguage(tokenizer.language)))
+  ];
+  const found = await Promise.all(searches);
+  return found.flat().toSorted((a, b) => boostedScore(b) - boostedScore(a)).slice(0, limit).map((hit) => hit.document);
 };
 
 // src/ai/mcp/query.ts
@@ -191,12 +253,16 @@ var contentTypesField = z.preprocess((value) => {
   return list.length > 0 ? list : undefined;
 }, z.array(z.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 looseFacetObject = z.record(z.string(), z.unknown());
+var facetFilterValue = z.union([z.string(), z.number(), z.boolean()]).transform(String);
 var filtersField = z.preprocess((value) => {
   const candidate = looseFacetObject.safeParse(value);
   if (!candidate.success) {
     return;
   }
-  const entries = Object.entries(candidate.data).filter((entry) => typeof entry[1] === "string");
+  const entries = Object.entries(candidate.data).flatMap(([key, entry]) => {
+    const parsed = facetFilterValue.safeParse(entry);
+    return parsed.success ? [[key, parsed.data]] : [];
+  });
   return entries.length > 0 ? Object.fromEntries(entries) : undefined;
 }, z.record(z.string(), z.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 = z.preprocess((value) => {
@@ -479,5 +545,5 @@ export {
   mcpStdioCommand
 };
 
-//# debugId=19894529A226AE0264756E2164756E21
-//# sourceMappingURL=chunk-713mngdq.js.map
+//# debugId=E6710E6AD54250CC64756E2164756E21
+//# sourceMappingURL=chunk-hebn0tpx.js.map

package/dist/cli/chunk-hebn0tpx.js.map

@@ -0,0 +1,14 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/mcp-stdio.ts", "../src/ai/mcp/stdio.ts", "../src/ai/mcp/server.ts", "../src/ai/mcp/query.ts", "../src/search/orama-index.ts"],
+  "sourcesContent": [
+    "import { readFile } from \"node:fs/promises\";\n\nimport { defineCommand } from \"citty\";\n\nimport type { McpData } from \"../../ai/mcp/data.ts\";\nimport { serveMcpStdio } from \"../../ai/mcp/stdio.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\n\nexport const mcpStdioCommand = defineCommand({\n  args: {\n    data: {\n      description: \"Path to a serialized MCP data snapshot (JSON).\",\n      required: true,\n      type: \"string\",\n    },\n  },\n  meta: commandMeta[\"mcp-stdio\"],\n  async run({ args }) {\n    // stdout belongs to the JSON-RPC transport from here on; every diagnostic\n    // must go to stderr or the MCP client chokes on the stray line.\n    let data: McpData;\n    try {\n      // SAFETY: the snapshot is written by `blume eval` itself as\n      // JSON.stringify of an McpData; a hand-mangled file fails the parse and\n      // lands in the catch below.\n      data = JSON.parse(await readFile(args.data, \"utf-8\")) as McpData;\n    } catch (error) {\n      const detail = error instanceof Error ? error.message : String(error);\n      process.stderr.write(\n        `blume mcp-stdio: cannot load the snapshot at ${args.data}: ${detail}\\n`\n      );\n      process.exit(1);\n    }\n    await serveMcpStdio(data);\n  },\n});\n",
+    "import { once } from \"node:events\";\nimport type { Readable, Writable } from \"node:stream\";\n\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\n\nimport type { McpData } from \"./data.ts\";\nimport { buildServer, createIndexProvider } from \"./server.ts\";\n\n/** Streams for `serveMcpStdio`, injectable so tests can use in-memory pipes. */\nexport interface McpStdioStreams {\n  stdin?: Readable;\n  stdout?: Writable;\n}\n\n/**\n * Serve a precomputed MCP data snapshot over a stdio transport until the\n * client hangs up.\n *\n * The SDK transport reads its input stream but never watches for its end, so\n * a client that simply closes the pipe — which is how every MCP host shuts a\n * stdio server down — would leave the process running forever. EOF on the\n * input stream therefore ends the serve loop explicitly.\n */\nexport const serveMcpStdio = async (\n  data: McpData,\n  streams: McpStdioStreams = {}\n): Promise<void> => {\n  const stdin = streams.stdin ?? process.stdin;\n  const stdout = streams.stdout ?? process.stdout;\n  const transport = new StdioServerTransport(stdin, stdout);\n  const server = buildServer(\n    data,\n    createIndexProvider(data.documents, data.defaultLocale)\n  );\n  await server.connect(transport);\n  await once(stdin, \"end\");\n  await transport.close();\n};\n",
+    "import { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport type { ServerOptions } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport { WebStandardStreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js\";\nimport {\n  ErrorCode,\n  ListResourcesRequestSchema,\n  ListToolsRequestSchema,\n  McpError,\n  ReadResourceRequestSchema,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport { mountBasePath } from \"../../core/base-path.ts\";\nimport { readCappedText } from \"../../core/request-body.ts\";\nimport type { McpData } from \"./data.ts\";\nimport {\n  createIndexProvider,\n  getNavigation,\n  getPageMarkdown,\n  listPages,\n  normalizeRoute,\n  searchDocs,\n  TOOL_INPUTS,\n  urlFor,\n} from \"./query.ts\";\nimport type { OramaIndexProvider } from \"./query.ts\";\nimport { MCP_TOOLS } from \"./tools.ts\";\n\nexport { createIndexProvider } from \"./query.ts\";\nexport type { OramaIndexProvider } from \"./query.ts\";\n\n/**\n * The low-level SDK `Server` is used (rather than the high-level `McpServer`)\n * because the latter's `registerTool` is generic over the caller's Zod instance;\n * Blume's zod and the SDK's may resolve to different copies, whose types don't\n * unify. The operations themselves live in `query.ts`, shared with the JSON\n * docs API; this module is the MCP transport over them.\n */\n\n/** Every page resource is the page's agent Markdown. */\nconst RESOURCE_MIME_TYPE = \"text/markdown\";\n/** The MCP spec's JSON-RPC code for an unknown resource URI. */\nconst RESOURCE_NOT_FOUND = -32_002;\n/** URI scheme for page resources when no `deployment.site` is configured. */\nconst LOCAL_RESOURCE_SCHEME = \"blume:\";\n/**\n * The largest request body the HTTP endpoint reads. A JSON-RPC call to these\n * tools is a few hundred bytes; the cap keeps one oversized POST from being\n * buffered whole, as the assistant route's does.\n */\nconst MCP_BODY_LIMIT_BYTES = 65_536;\n\nconst CORS_HEADERS = {\n  \"Access-Control-Allow-Headers\":\n    \"Content-Type, Mcp-Session-Id, Mcp-Protocol-Version\",\n  \"Access-Control-Allow-Methods\": \"GET, POST, OPTIONS\",\n  \"Access-Control-Allow-Origin\": \"*\",\n  \"Access-Control-Expose-Headers\": \"Mcp-Session-Id\",\n};\n\n/**\n * A tool's advertised JSON Schema. The dialect key is dropped (noise in a\n * tools/list payload), as is the root `additionalProperties: false` — the\n * runtime strips unknown keys rather than rejecting them, and the advertised\n * schema shouldn't promise stricter validation than the server performs.\n */\nconst inputSchemaFor = (schema: z.ZodType) => {\n  const {\n    $schema: _dialect,\n    additionalProperties: _closed,\n    ...rest\n  } = z.toJSONSchema(schema);\n  return rest;\n};\n\n/** The `tools/list` payload, derived from shared metadata + input schemas. */\nconst TOOL_DEFINITIONS = MCP_TOOLS.map((tool) => ({\n  annotations: tool.annotations,\n  description: tool.description,\n  inputSchema: inputSchemaFor(\n    // SAFETY: TOOL_INPUTS declares a schema for every MCP_TOOLS name; the two\n    // lists are maintained together so names and descriptions never drift.\n    TOOL_INPUTS[tool.name as keyof typeof TOOL_INPUTS]\n  ),\n  name: tool.name,\n  title: tool.title,\n}));\n\n/** One `resources/list` entry: a page served as `text/markdown`. */\ninterface PageResource {\n  description?: string;\n  mimeType: string;\n  name: string;\n  title: string;\n  uri: string;\n}\n\n/**\n * A page's resource URI. Resource URIs must be absolute, so this is the page's\n * served URL when a site is configured (the same URL `search_docs` and\n * `list_pages` emit, so an agent can hand either back to `resources/read`),\n * and a `blume:` URI carrying the based route otherwise.\n */\nconst resourceUri = (route: string, data: McpData): string =>\n  data.site\n    ? urlFor(route, data)\n    : `${LOCAL_RESOURCE_SCHEME}${mountBasePath(data.base, route)}`;\n\n/** The `pages` key a resource URI (either form, or a bare route) names. */\nconst resourceRoute = (uri: string, data: McpData): string =>\n  normalizeRoute(\n    uri.startsWith(LOCAL_RESOURCE_SCHEME)\n      ? uri.slice(LOCAL_RESOURCE_SCHEME.length)\n      : uri,\n    data\n  );\n\n/**\n * The `tools/call` params, as far as the server reads them before dispatch:\n * each tool validates its own `arguments` against `TOOL_INPUTS`.\n */\nconst TOOL_CALL_PARAMS = z.object({\n  arguments: z.record(z.string(), z.unknown()).optional(),\n  name: z.string(),\n});\n\n/** A tool call's `arguments` object, before the tool's own validation. */\ntype ToolArguments = NonNullable<\n  z.output<typeof TOOL_CALL_PARAMS>[\"arguments\"]\n>;\n\n/** A tool call's text result, marked as an error when `isError` is set. */\nconst text = (value: string, isError = false) => {\n  const content = [{ text: value, type: \"text\" as const }];\n  return isError ? { content, isError: true } : { content };\n};\n\n/** Construct a fresh MCP server with Blume's read-only docs tools registered. */\nexport const buildServer = (\n  data: McpData,\n  index: OramaIndexProvider\n): Server => {\n  const capabilities = { resources: {}, tools: {} };\n  const serverOptions: ServerOptions = data.instructions\n    ? { capabilities, instructions: data.instructions }\n    : { capabilities };\n  const server = new Server(\n    { name: data.name, version: data.version },\n    serverOptions\n  );\n\n  server.setRequestHandler(ListToolsRequestSchema, () => ({\n    tools: TOOL_DEFINITIONS,\n  }));\n\n  // Every page doubles as a resource, so a client that attaches context by\n  // URI (rather than calling tools) can browse and read the docs too. The\n  // list is the same route set `list_pages` returns; reading one serves the\n  // same agent Markdown `get_page` does.\n  server.setRequestHandler(ListResourcesRequestSchema, () => ({\n    resources: data.routes.map((route) => {\n      const resource: PageResource = {\n        mimeType: RESOURCE_MIME_TYPE,\n        name: route.title,\n        title: route.title,\n        uri: resourceUri(route.route, data),\n      };\n      if (route.description) {\n        resource.description = route.description;\n      }\n      return resource;\n    }),\n  }));\n\n  server.setRequestHandler(ReadResourceRequestSchema, (request) => {\n    const { uri } = request.params;\n    const markdown = getPageMarkdown(data, resourceRoute(uri, data));\n    if (markdown === undefined) {\n      throw new McpError(\n        RESOURCE_NOT_FOUND,\n        `No page found at \"${uri}\". Use resources/list or list_pages to find valid URIs.`\n      );\n    }\n    return {\n      contents: [{ mimeType: RESOURCE_MIME_TYPE, text: markdown, uri }],\n    };\n  });\n\n  const callTool = async (name: string, args: ToolArguments) => {\n    if (name === \"search_docs\") {\n      const results = await searchDocs(\n        data,\n        index,\n        TOOL_INPUTS.search_docs.parse(args)\n      );\n      return text(JSON.stringify(results, null, 2));\n    }\n\n    if (name === \"get_page\") {\n      const input = TOOL_INPUTS.get_page.parse(args);\n      const key = normalizeRoute(input.route, data);\n      const markdown = getPageMarkdown(data, key);\n      if (markdown === undefined) {\n        return text(\n          `No page found at \"${key}\". Use list_pages or search_docs to find valid routes.`,\n          true\n        );\n      }\n      return text(markdown);\n    }\n\n    if (name === \"list_pages\") {\n      const listing = listPages(data, TOOL_INPUTS.list_pages.parse(args));\n      return text(JSON.stringify(listing, null, 2));\n    }\n\n    if (name === \"get_navigation\") {\n      const result = getNavigation(\n        data,\n        TOOL_INPUTS.get_navigation.parse(args)\n      );\n      if (\"error\" in result) {\n        return text(result.error, true);\n      }\n      return text(JSON.stringify(result.navigation, null, 2));\n    }\n\n    // The MCP spec answers an unknown tool with a protocol error, not a\n    // failed tool result.\n    throw new McpError(ErrorCode.InvalidParams, `Unknown tool: ${name}`);\n  };\n\n  // `tools/call` goes through the fallback handler rather than a registered\n  // one: the SDK parses a registered handler's request against its own\n  // schema first and reports a malformed call (`arguments` that aren't an\n  // object) as -32603 Internal error carrying a raw Zod dump. Reading the\n  // params here answers it as -32602 Invalid params with a short message.\n  server.fallbackRequestHandler = async (request) => {\n    if (request.method !== \"tools/call\") {\n      throw new McpError(ErrorCode.MethodNotFound, \"Method not found\");\n    }\n    const params = TOOL_CALL_PARAMS.safeParse(request.params);\n    if (!params.success) {\n      throw new McpError(\n        ErrorCode.InvalidParams,\n        \"Invalid tools/call params: `name` must be a string and `arguments`, when given, an object.\"\n      );\n    }\n    return await callTool(params.data.name, params.data.arguments ?? {});\n  };\n\n  return server;\n};\n\n/** A JSON-RPC error response the transport would send, for errors raised before it runs. */\nconst jsonRpcError = (\n  status: number,\n  code: number,\n  message: string\n): Response =>\n  Response.json(\n    { error: { code, message }, id: null, jsonrpc: \"2.0\" },\n    { headers: CORS_HEADERS, status }\n  );\n\n/**\n * Build a stateless Streamable-HTTP MCP request handler from a data snapshot.\n *\n * The Orama index is built once and reused; a fresh `Server` and transport are\n * created per request (required by the SDK's stateless mode, which skips session\n * tracking). `enableJsonResponse` makes each call a plain request/response — no\n * SSE — which suits read-only docs tools and runs on any adapter (Node, Vercel,\n * Netlify, Cloudflare). CORS is added so browser-based connectors (e.g.\n * claude.ai) can reach the endpoint.\n */\nexport const createMcpFetchHandler = (\n  data: McpData\n): ((request: Request) => Promise<Response>) => {\n  const index = createIndexProvider(data.documents, data.defaultLocale);\n\n  return async (request: Request): Promise<Response> => {\n    if (request.method === \"OPTIONS\") {\n      return new Response(null, { headers: CORS_HEADERS, status: 204 });\n    }\n    if (request.method === \"GET\") {\n      // No server-initiated streams are needed for read-only tools.\n      return new Response(\"Method Not Allowed\", {\n        headers: { ...CORS_HEADERS, Allow: \"POST, OPTIONS\" },\n        status: 405,\n      });\n    }\n\n    // The transport would read the body with `request.json()`, buffering\n    // whatever a client sends; read it under the cap first and hand the\n    // transport a copy.\n    let forwarded = request;\n    if (request.method === \"POST\") {\n      const body = await readCappedText(request, MCP_BODY_LIMIT_BYTES);\n      if (body === undefined) {\n        return jsonRpcError(\n          413,\n          ErrorCode.InvalidRequest,\n          \"Request too large: the body must be at most 64 KB.\"\n        );\n      }\n      forwarded = new Request(request.url, {\n        body,\n        headers: request.headers,\n        method: \"POST\",\n      });\n    }\n\n    const server = buildServer(data, index);\n    const transport = new WebStandardStreamableHTTPServerTransport({\n      enableJsonResponse: true,\n      // The SDK enables stateless mode only when this is `undefined`; `null` is\n      // not an accepted value for the `(() => string) | undefined` option.\n      // oxlint-disable-next-line sonarjs/no-undefined-assignment\n      sessionIdGenerator: undefined,\n    });\n    await server.connect(transport);\n    const response = await transport.handleRequest(forwarded);\n\n    const headers = new Headers(response.headers);\n    for (const [key, value] of Object.entries(CORS_HEADERS)) {\n      headers.set(key, value);\n    }\n    return new Response(response.body, {\n      headers,\n      status: response.status,\n      statusText: response.statusText,\n    });\n  };\n};\n",
+    "import { z } from \"zod\";\n\nimport {\n  mountBasePath,\n  normalizeRoute as normalizePageRoute,\n  stripBasePath,\n} from \"../../core/base-path.ts\";\nimport { absoluteUrl } from \"../../core/site-url.ts\";\nimport { trimEnd } from \"../../core/trim.ts\";\nimport type { Navigation } from \"../../core/types.ts\";\nimport { buildOramaIndex, queryOramaIndex } from \"../../search/orama-index.ts\";\nimport type { OramaDoc } from \"../../search/orama-index.ts\";\nimport type { McpData } from \"./data.ts\";\n\n/**\n * The read-only docs operations behind the agent-facing surfaces — search,\n * page lookup, the page listing, and the navigation tree — over an\n * {@link McpData} snapshot. The MCP server (`server.ts`) and the JSON docs API\n * (`ai/api/handlers.ts`) are both thin transports over these, so a tool call\n * and its REST twin can never answer differently. SDK-free on purpose: the\n * prerendered API endpoints import this module without pulling the MCP SDK\n * into their bundle.\n *\n * Each input is defined once in Zod: the runtime parse and the JSON Schema\n * advertised by `tools/list` (via `z.toJSONSchema`) derive from the same\n * definition, so they cannot drift.\n */\n\n/** Default and maximum number of hits returned by a search. */\nexport const DEFAULT_SEARCH_LIMIT = 8;\nexport const MAX_SEARCH_LIMIT = 20;\n/** Excerpt length when a page has no description. */\nconst EXCERPT_LENGTH = 200;\n\n// Each field is a preprocess pipe: the input side accepts the sloppy shapes\n// LLM callers actually send (a bare string for an array field, `[]`/`{}`\n// meaning \"no filter\", out-of-range limits clamped rather than rejected), and\n// the pipe's *output* side is the clean shape — which is exactly what\n// `z.toJSONSchema` emits for `tools/list`. No coercion can ever fail, so a\n// tool call is never rejected on argument shape, matching the previous\n// hand-rolled coercions.\n\n/**\n * The optional content-type filter `search_docs` and `list_pages` share.\n * `[]` or no usable strings mean \"no filter\", not \"match nothing\"; a bare\n * string is accepted as a one-element list.\n */\nconst contentTypesField = z.preprocess((value) => {\n  const list = (Array.isArray(value) ? value : [value]).filter(\n    (entry): entry is string => typeof entry === \"string\"\n  );\n  return list.length > 0 ? list : undefined;\n}, z.array(z.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.'));\n\n/**\n * The optional facet filter `search_docs` and `list_pages` share. A value\n * is read the way `pageFacets` stores one: a string as-is, a number or\n * boolean stringified (`{\"priority\": 1}` matches the facet `\"1\"`). Entries of\n * any other shape are dropped; an empty `{}` means \"no filter\".\n */\n/** Accepts any plain object, so the usable entries can be sifted out. */\nconst looseFacetObject = z.record(z.string(), z.unknown());\n\n/** A filter value a facet can hold, stringified like `pageFacets` does. */\nconst facetFilterValue = z\n  .union([z.string(), z.number(), z.boolean()])\n  .transform(String);\n\nconst filtersField = z.preprocess((value) => {\n  const candidate = looseFacetObject.safeParse(value);\n  if (!candidate.success) {\n    return;\n  }\n  const entries = Object.entries(candidate.data).flatMap(([key, entry]) => {\n    const parsed = facetFilterValue.safeParse(entry);\n    return parsed.success ? [[key, parsed.data] as const] : [];\n  });\n  return entries.length > 0 ? Object.fromEntries(entries) : undefined;\n}, z.record(z.string(), z.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.'));\n\n/** Clamped into range rather than rejected; non-numeric means the default. */\nconst limitField = z.preprocess(\n  (value) => {\n    // `Number` is the identity on numbers, so one conversion covers both the\n    // well-typed call and a numeric string.\n    const num = Number(value);\n    return Number.isFinite(num)\n      ? Math.min(Math.max(Math.trunc(num), 1), MAX_SEARCH_LIMIT)\n      : undefined;\n  },\n  z\n    .int()\n    .min(1)\n    .max(MAX_SEARCH_LIMIT)\n    .optional()\n    .describe(`Maximum hits to return (default ${DEFAULT_SEARCH_LIMIT}).`)\n);\n\n/** A required text field; a missing or non-string value coerces to \"\". */\nconst textField = (description: string) =>\n  z.preprocess((value) => {\n    const parsed = z.string().safeParse(value);\n    return parsed.success ? parsed.data : \"\";\n  }, z.string().describe(description));\n\n/** An optional trimmed text field; blank or non-string means \"absent\". */\nconst optionalTextField = (description: string) =>\n  z.preprocess((value) => {\n    const parsed = z.string().safeParse(value);\n    const trimmed = parsed.success ? parsed.data.trim() : \"\";\n    return trimmed || undefined;\n  }, z.string().optional().describe(description));\n\n/** The optional locale filter `search_docs` and `list_pages` share. */\nconst localeField = optionalTextField(\n  \"Only include pages in this locale (e.g. `fr`). Omit for every language.\"\n);\n\n/** The optional docs-version scope `search_docs` and `list_pages` share. */\nconst versionField = optionalTextField(\n  'Docs version to scope to on a versioned site: `\"latest\"` (the default — current docs only), `\"all\"` (every version), or an archived version id (e.g. `\"v1.0\"`). Ignored when the site is unversioned.'\n);\n\n/** Every tool's input schema — the runtime parse and tools/list source. */\nexport const TOOL_INPUTS = {\n  get_navigation: z.object({\n    locale: optionalTextField(\n      \"Locale whose navigation tree to return (defaults to the default locale).\"\n    ),\n    version: optionalTextField(\n      \"Archived version id whose tree to return (defaults to the current docs).\"\n    ),\n  }),\n  get_page: z.object({\n    route: textField(\"The page route, e.g. `/guides/install`.\"),\n  }),\n  list_pages: z.object({\n    contentTypes: contentTypesField,\n    filters: filtersField,\n    locale: localeField,\n    version: versionField,\n  }),\n  search_docs: z.object({\n    contentTypes: contentTypesField,\n    filters: filtersField,\n    limit: limitField,\n    locale: localeField,\n    query: textField(\"The search query.\"),\n    version: versionField,\n  }),\n};\n\n/** One `search_docs` result entry; `version` only appears on versioned sites. */\nexport interface SearchHitPayload {\n  contentType: string | undefined;\n  excerpt: string;\n  facets: Record<string, string> | undefined;\n  route: string;\n  title: string;\n  url: string;\n  version?: string;\n}\n\n/** One `list_pages` entry; `version` only appears on versioned sites. */\nexport interface PageListingPayload {\n  contentType: string;\n  description: string | undefined;\n  facets: Record<string, string> | undefined;\n  lastModified: string | null;\n  route: string;\n  title: string;\n  url: string;\n  version?: string;\n}\n\n/** Whether a page's facet values satisfy every requested filter entry. */\nconst matchesFacets = (\n  facets: Record<string, string> | undefined,\n  filters: Record<string, string>\n): boolean =>\n  Object.entries(filters).every(([key, value]) => facets?.[key] === value);\n\n/**\n * Resolve the `version` scope on a versioned site: `undefined` disables the\n * filter (`\"all\"`), `\"\"` is the current docs (the default — agents almost\n * always want the live documentation), and anything else is an archived id\n * (an unknown id simply matches nothing). On an unversioned site the input is\n * ignored entirely. The input arrives pre-trimmed (blank coerced to absent)\n * from the tool's input schema.\n */\nconst asVersionScope = (\n  value: string | undefined,\n  data: McpData\n): string | undefined => {\n  if (!data.archivedVersions) {\n    return;\n  }\n  if (value === \"all\") {\n    return;\n  }\n  if (value === undefined || value === \"latest\" || value === \"current\") {\n    return \"\";\n  }\n  return value;\n};\n\n/**\n * Error message for a `get_navigation` version id that isn't a configured\n * archived version, or `null` when the id is valid (or the site is\n * unversioned, where the id is ignored like the other tools' scopes). Unlike\n * `asVersionScope`'s match-nothing filters, a bad id here would otherwise\n * silently return the *current* tree posing as the requested snapshot.\n */\nconst unknownVersionError = (\n  versionId: string | undefined,\n  data: McpData\n): string | null =>\n  versionId &&\n  data.archivedVersions &&\n  !data.archivedVersions.includes(versionId)\n    ? `Unknown version \"${versionId}\". Archived versions: ${data.archivedVersions.join(\", \")}.`\n    : null;\n\n/**\n * Normalize a user-supplied route to a `pages` key (`/`, `/a/b`, no suffix).\n * Accepts a full URL too — `search_docs` hits and llms.txt entries carry\n * `site` + `deployment.base`, and an agent following \"pass a route from\n * `search_docs`\" will hand one straight back — reducing it to its base-less,\n * percent-decoded path.\n */\nexport const normalizeRoute = (input: string, data: McpData): string => {\n  let value = input.trim();\n  if (/^https?:\\/\\//iu.test(value)) {\n    try {\n      value = new URL(value).pathname;\n    } catch {\n      // Not parseable as a URL after all; treat it as a path.\n    }\n  }\n  try {\n    value = decodeURI(value);\n  } catch {\n    // Malformed percent sequence — compare it as written.\n  }\n  // Trailing slashes come off before the suffix so `/a/b.md/` still loses its\n  // `.md`; normalizePageRoute then settles the leading slash.\n  const noSuffix = trimEnd(value, \"/\").replace(/\\.mdx?$/u, \"\");\n  return stripBasePath(data.base, normalizePageRoute(noSuffix));\n};\n\n/** Build the absolute (or root-relative) URL for a route. */\nexport const urlFor = (route: string, data: McpData): string => {\n  // Routes are base-less manifest paths; layer `deployment.base` on top so the\n  // URL matches where the page is served (the sitemap/llms.txt convention).\n  const path = mountBasePath(data.base, route);\n  // Concatenate rather than `new URL(path, site)` — a root-absolute path\n  // would drop the base path of a subpath deployment (`acme.com/docs`).\n  return data.site ? absoluteUrl(data.site, path) : path;\n};\n\n/** A hit's excerpt: its description, else the head of its content with an\n * ellipsis only when something was actually cut off. */\nconst excerptFor = (doc: OramaDoc): string => {\n  if (doc.description) {\n    return doc.description;\n  }\n  const head = doc.content.slice(0, EXCERPT_LENGTH).trim();\n  return doc.content.length > EXCERPT_LENGTH ? `${head}…` : head;\n};\n\n/** Lazily builds the Orama index over a snapshot's documents, once. */\nexport type OramaIndexProvider = () => Promise<\n  Awaited<ReturnType<typeof buildOramaIndex>>\n>;\n\n/**\n * Memoize the search index so every server built from a snapshot shares it.\n * `locale` is the snapshot's `defaultLocale`, forwarded so non-Latin scripts\n * (Japanese and Chinese, but equally Cyrillic, Greek, Hebrew, Devanagari…)\n * get a word-segmenting tokenizer.\n */\nexport const createIndexProvider = (\n  documents: OramaDoc[],\n  locale?: string\n): OramaIndexProvider => {\n  let dbPromise: ReturnType<OramaIndexProvider> | null = null;\n  return function provideIndex() {\n    dbPromise ??= buildOramaIndex(documents, locale);\n    return dbPromise;\n  };\n};\n\n/** Full-text search over the snapshot; the `search_docs` operation. */\nexport const searchDocs = async (\n  data: McpData,\n  index: OramaIndexProvider,\n  input: z.output<typeof TOOL_INPUTS.search_docs>\n): Promise<SearchHitPayload[]> => {\n  const db = await index();\n  const hits = await queryOramaIndex(\n    db,\n    input.query,\n    input.limit ?? DEFAULT_SEARCH_LIMIT,\n    {\n      contentTypes: input.contentTypes,\n      facets: input.filters,\n      locale: input.locale,\n      version: asVersionScope(input.version, data),\n    }\n  );\n  // `route` is the key `get_page` takes (the tool descriptions promise\n  // it); `url` is where the page is served.\n  return hits.map((doc: OramaDoc) => {\n    const hit: SearchHitPayload = {\n      contentType: doc.contentType,\n      excerpt: excerptFor(doc),\n      facets: doc.facets,\n      route: doc.route,\n      title: doc.title,\n      url: urlFor(doc.route, data),\n    };\n    if (data.archivedVersions) {\n      hit.version = doc.version ?? \"\";\n    }\n    return hit;\n  });\n};\n\n/** A page's agent Markdown, or `undefined` when no page has the route. */\nexport const getPageMarkdown = (\n  data: McpData,\n  route: string\n): string | undefined => data.pages[route];\n\n/** Every non-hidden route matching the filters; the `list_pages` operation. */\nexport const listPages = (\n  data: McpData,\n  input: z.output<typeof TOOL_INPUTS.list_pages>\n): PageListingPayload[] => {\n  const { contentTypes, filters, locale } = input;\n  const versionScope = asVersionScope(input.version, data);\n  return data.routes\n    .filter(\n      (route) =>\n        (!contentTypes || contentTypes.includes(route.contentType)) &&\n        (!filters || matchesFacets(route.facets, filters)) &&\n        (!locale || route.locale === locale) &&\n        (versionScope === undefined || route.version === versionScope)\n    )\n    .map((route) => {\n      const listing: PageListingPayload = {\n        contentType: route.contentType,\n        description: route.description,\n        facets: route.facets,\n        lastModified: route.lastModified,\n        route: route.route,\n        title: route.title,\n        url: urlFor(route.route, data),\n      };\n      if (data.archivedVersions) {\n        listing.version = route.version;\n      }\n      return listing;\n    });\n};\n\n/**\n * The navigation tree for a locale and version; the `get_navigation`\n * operation. A version id selects the snapshot's tree; a locale selects its\n * language (falling back through the default locale to any tree the snapshot\n * has). Without a version, a locale selects the current docs' localized\n * tree. An unknown id on a versioned site is an error string — the current\n * tree would silently masquerade as the requested snapshot.\n */\nexport const getNavigation = (\n  data: McpData,\n  input: z.output<typeof TOOL_INPUTS.get_navigation>\n): { error: string } | { navigation: Navigation } => {\n  const { locale, version: versionId } = input;\n  const unknownVersion = unknownVersionError(versionId, data);\n  if (unknownVersion) {\n    return { error: unknownVersion };\n  }\n  let { navigation } = data;\n  const byLocale = versionId\n    ? data.navigationByVersion?.[versionId]\n    : undefined;\n  if (byLocale) {\n    navigation =\n      (locale ? byLocale[locale] : undefined) ??\n      byLocale[data.defaultLocale ?? \"\"] ??\n      Object.values(byLocale)[0] ??\n      navigation;\n  } else if (locale && data.navigationByLocale?.[locale]) {\n    navigation = data.navigationByLocale[locale];\n  }\n  return { navigation };\n};\n",
+    "import {\n  components,\n  create,\n  insert,\n  insertMultiple,\n  search,\n} from \"@orama/orama\";\nimport type {\n  AnyOrama,\n  EnumArrComparisonOperator,\n  EnumComparisonOperator,\n  Result,\n  SearchParamsFullText,\n  Tokenizer,\n} from \"@orama/orama\";\n\n/**\n * The minimal document shape both the client-side search dialog and the\n * server-side MCP `search_docs` tool index. Mirrors the `blume-search.json`\n * entries built by `buildSearchDocuments`.\n */\nexport interface OramaDoc {\n  content: string;\n  description: string;\n  route: string;\n  title: string;\n  /** Locale code; indexed as an enum so queries can filter to one language. */\n  locale?: string;\n  /**\n   * Docs version; indexed as an enum so queries can filter to one version.\n   * The current docs carry `\"\"`, which the enum stores and matches exactly.\n   */\n  version?: string;\n  /** Resolved page `type`; indexed as an enum so queries can filter by type. */\n  contentType?: string;\n  /** Declared facet values (`content.types.<type>.facets`), key → value. */\n  facets?: Record<string, string>;\n  /** Carried through for the search dialog's breadcrumb + filter pills. Stored\n   * but not indexed, so they ride along on the returned document untouched. */\n  breadcrumb?: string[];\n  section?: string;\n  /** The page's relevance multiplier (`search.boost`); stored, not indexed. */\n  boost?: number;\n  /** Extra terms the page is found by (`search.keywords`). */\n  keywords?: string[];\n}\n\nconst SCHEMA = {\n  content: \"string\",\n  // Enums (not full-text \"string\") so `where` does an exact-match filter.\n  contentType: \"enum\",\n  description: \"string\",\n  // Facets, flattened to `key:value` terms — enum[] so one static schema\n  // serves every project's facet keys, with `containsAll` matching a filter\n  // set. Derived from `facets` at insert time.\n  facetTerms: \"enum[]\",\n  keywords: \"string[]\",\n  locale: \"enum\",\n  route: \"string\",\n  title: \"string\",\n  version: \"enum\",\n} as const;\n\n/** Flatten a facet map to the `key:value` terms the `facetTerms` enum holds. */\nconst toFacetTerms = (facets: Record<string, string>): string[] =>\n  Object.entries(facets).map(([key, value]) => `${key}:${value}`);\n\n/**\n * Title and description outrank body text, matching the search dialog; a\n * page's keywords count as much as its title, since its author chose them.\n */\nconst BOOST = { description: 2, keywords: 3, title: 3 };\n\n/** Databases holding a boosted page, which rank by boosted score. */\nconst boostedDatabases = new WeakSet<AnyOrama>();\n\n/** A search match as Orama's sort function sees it: id, score, document. */\ntype RankedMatch = [unknown, number, OramaDoc];\n\n/** Rank matches by relevance times the page's `search.boost`. */\nconst byBoostedScore = (a: RankedMatch, b: RankedMatch): number =>\n  b[1] * (b[2].boost ?? 1) - a[1] * (a[2].boost ?? 1);\n\n/**\n * The script whose text Orama's default tokenizer keeps mostly intact. Its\n * delimiter class is `/[^A-Za-zàèéìòóù0-9_'-]+/`, so every character outside\n * that set counts as a separator: text in any other script collapses to zero\n * tokens and every query silently returns no hits. Unspaced scripts are the\n * best-known casualty, but the failure is not about spacing — Russian, Greek,\n * Hebrew and Hindi lose their tokens the same way Japanese does.\n */\nconst LATIN_SCRIPT = \"Latn\";\n\n/**\n * Parse a locale tag, tolerating the legacy forms that reach here from\n * hand-written config: underscores (`ru_RU`), POSIX suffixes (`ja_JP.UTF-8`,\n * `zh_TW@Big5`), and extlang tags ICU rejects (`zh-cmn-Hans`). The POSIX\n * codeset/modifier suffix is dropped first — it carries no BCP 47 meaning,\n * and dropping it keeps an explicit script subtag in play: `az_Cyrl.UTF-8`\n * must resolve to `Cyrl`, not fall back to `az` and maximize to Latin.\n * `Intl.Locale` still throws on extlang forms, so a failed parse retries with\n * the primary language subtag alone — enough to resolve the script, which is\n * all that gates the tokenizer. Returns `undefined` when even that subtag is\n * unparseable.\n */\nconst parseLocale = (tag: string): Intl.Locale | undefined => {\n  const hyphenated = tag.replace(/[.@].*$/u, \"\").replaceAll(\"_\", \"-\");\n  try {\n    return new Intl.Locale(hyphenated);\n  } catch {\n    // Retry below with the primary subtag.\n  }\n  const [primary = \"\"] = hyphenated.split(\"-\");\n  try {\n    return new Intl.Locale(primary);\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * The maximized locale — script and language filled in from CLDR likely-subtags\n * and alias data, so `ru` resolves to `Cyrl`, `cmn` to the canonical `zh`, and\n * an explicit script subtag is honored: `sr-Latn` reports `Latn` while\n * `az-Cyrl` reports `Cyrl`. `undefined` for tags {@link parseLocale} cannot\n * salvage; a well-formed tag ICU knows nothing about keeps an `undefined`\n * script instead.\n */\nconst resolveLocale = (tag: string): Intl.Locale | undefined =>\n  parseLocale(tag)?.maximize();\n\n/**\n * Indexes whose language maximizes to one of these scripts are built as\n * character bigrams rather than whole segments, and queried to match\n * accordingly. Japanese and Chinese write compounds in {@link BIGRAM_SCRIPTS}\n * without delimiters, and the writing system — not the language subtag — is\n * what carries that convention: `yue` (Cantonese) maximizes to `Hant` and\n * needs bigrams the same way `zh` does. Korean maximizes to `Kore` and Thai\n * to `Thai`; Korean separates words with spaces and Thai has no comparable\n * bigram convention, so both keep the plain segmented tokens even where a\n * page mixes in Han or kana.\n *\n * Dictionary segmentation alone drops the adjacency that makes a compound term\n * distinctive: 資金決済法 becomes 資金 / 決済 / 法, and because Orama scores a\n * bag of words, a page that merely mentions each fragment somewhere outranks\n * the page about the law itself. Bigrams put that adjacency back as index\n * terms, and dropping the whole-segment tokens keeps a fragment as common as\n * 法 from matching on its own.\n */\nconst BIGRAM_INDEX_SCRIPTS = new Set([\"Hans\", \"Hant\", \"Jpan\"]);\n\n/**\n * Whether the index keyed to this tokenizer language is built from bigrams.\n * {@link segmentingTokenizer} stores the canonical maximized language, so the\n * builder and the strict pass in {@link queryOramaIndex} share this predicate\n * — an index is never built from bigrams that the query side then matches\n * loosely, or vice versa.\n */\nconst isBigramLanguage = (language: string): boolean => {\n  const script = resolveLocale(language)?.script;\n  return script !== undefined && BIGRAM_INDEX_SCRIPTS.has(script);\n};\n\n/**\n * Segments written entirely in these scripts are the ones re-cut into bigrams,\n * matching the scripts Lucene's CJK analyzer bigrams. Property escapes rather\n * than ranges, so ideographs outside the basic plane are covered as well —\n * 𠮟, the 常用漢字表 form of しかる, is one. The literals that follow belong to\n * no script of their own but appear only inside such words: the iteration\n * marks, the prolonged sound mark, and the halfwidth voiced sound marks.\n */\nconst BIGRAM_SCRIPTS =\n  /^[\\p{Script=Han}\\p{Script=Hiragana}\\p{Script=Katakana}々〆〇ーﾞﾟ]+$/u;\n\n/**\n * One index term inside a word-like segment. Being word-like does not make a\n * segment all letters: UAX #29 keeps connector punctuation, format characters\n * and mid-number punctuation *within* a word, so `Intl.Segmenter` reports\n * スネーク_ケース and robots.txt as one segment each. A term is a run of\n * letters, combining marks and digits. Marks are spelling, not punctuation —\n * Thai writes vowels and tones as combining marks, so dropping them leaves\n * consonant skeletons that collapse distinct words (เสื้อ, shirt, and เสือ,\n * tiger, differ by one mark). Two separators stay where the surrounding text\n * makes them part of the word: an apostrophe followed by a letter (don't),\n * and a decimal point or thousands separator flanked by digits (1.0.3,\n * 1,000) — split, either would leave one-letter and one-digit fragments that\n * co-occur on unrelated pages.\n */\nconst TERM =\n  /[\\p{L}\\p{M}\\p{N}]+(?:(?:['’](?=\\p{L})|(?<=\\p{N})[.,](?=\\p{N}))[\\p{L}\\p{M}\\p{N}]+)*/gu;\n\n/**\n * A term written entirely in Latin script (plus digits and the separators\n * {@link TERM} keeps within a word). Orama's default tokenizer folds the\n * accented vowels it recognizes (café → cafe), so a segmented index folds\n * Latin terms too — otherwise switching a Cyrillic- or Greek-default site to\n * the segmenting tokenizer would silently drop the unaccented-query matches\n * the default tokenizer provided. Only all-Latin terms fold: marks are\n * spelling elsewhere (Thai vowels and tones; the breve that separates\n * Cyrillic й from и), so a term carrying any other script keeps its marks.\n */\nconst LATIN_TERM = /^[\\p{Script=Latin}\\p{N}'’.,]+$/u;\n\nconst MARKS = /\\p{M}+/gu;\n\nconst foldDiacritics = (term: string): string =>\n  LATIN_TERM.test(term) ? term.normalize(\"NFD\").replace(MARKS, \"\") : term;\n\n/**\n * Emit every overlapping 2-character window of `run`, or the lone character.\n * Windows are cut by code point: an ideograph outside the basic plane is a\n * surrogate pair, and slicing by code unit would split it into halves that\n * match nothing.\n *\n * Dropping the whole-segment tokens means a single-character query reaches\n * only pages where the character opens a bigram: a run-final 法 sits in 示法,\n * which the query 法 does not prefix-match. Lucene's CJK analyzer shares this\n * property; indexing lone characters alongside the bigrams would reinvite the\n * fragment noise this file exists to remove.\n */\nconst addBigrams = (run: string, tokens: Set<string>): void => {\n  const characters = [...run];\n  if (characters.length === 1) {\n    tokens.add(run);\n    return;\n  }\n  let previous = \"\";\n  for (const character of characters) {\n    if (previous) {\n      tokens.add(previous + character);\n    }\n    previous = character;\n  }\n};\n\n/**\n * `Intl.Segmenter` is missing on some runtimes even though the lib type\n * declares it, so the constructor's presence is probed before use.\n */\nconst hasSegmenter = (\n  segmenter: typeof Intl.Segmenter | undefined\n): segmenter is typeof Intl.Segmenter => typeof segmenter === \"function\";\n\n/**\n * A word-segmenting tokenizer for languages the default splitter can't handle,\n * built on `Intl.Segmenter` (the same engine `@orama/tokenizers` wraps).\n * Input is NFC-normalized and lowercased before segmenting — unlike the\n * upstream tokenizers — so decomposed text (macOS filenames, some CMS\n * pipelines) indexes the same terms a composed query produces, and Latin\n * terms (\"GDPR\", English pages on a mixed-locale site) still match\n * case-insensitively, with their diacritics folded by\n * {@link foldDiacritics}. Returns `undefined` for scripts the default\n * tokenizer already serves ({@link resolveLocale} decides, so `sr-Latn` keeps\n * the default while `az-Cyrl` is segmented), and on runtimes without\n * `Intl.Segmenter`, where the caller falls back to Orama's default.\n *\n * On a {@link BIGRAM_INDEX_SCRIPTS} index, runs of adjacent\n * {@link BIGRAM_SCRIPTS} segments are joined and re-cut into character\n * bigrams; everything else (Latin, digits, and every segment on a Korean or\n * Thai index) is emitted one {@link TERM} at a time. Separators end a run\n * either way — whether they stand between segments, as 「クーリング・オフ」\n * does, or inside one.\n */\nconst segmentingTokenizer = (locale?: string): Tokenizer | undefined => {\n  const resolved = resolveLocale(locale ?? \"\");\n  if (!resolved?.script || resolved.script === LATIN_SCRIPT) {\n    return;\n  }\n  if (!hasSegmenter(Intl.Segmenter)) {\n    return;\n  }\n  // The canonical maximized language (`cmn` → `zh`), so the bigram predicate\n  // here and the strict query pass read the same name.\n  const { language } = resolved;\n  const segmenter = new Intl.Segmenter(language, { granularity: \"word\" });\n  const bigram = isBigramLanguage(language);\n  return {\n    language,\n    normalizationCache: new Map(),\n    tokenize: (raw: string): string[] => {\n      const tokens = new Set<string>();\n      let run = \"\";\n      const flush = (): void => {\n        if (run) {\n          addBigrams(run, tokens);\n          run = \"\";\n        }\n      };\n      const take = (term: string): void => {\n        if (bigram && BIGRAM_SCRIPTS.test(term)) {\n          run += term;\n          return;\n        }\n        flush();\n        tokens.add(foldDiacritics(term));\n      };\n      for (const segment of segmenter.segment(\n        raw.normalize(\"NFC\").toLowerCase()\n      )) {\n        if (!segment.isWordLike) {\n          flush();\n          continue;\n        }\n        let end = 0;\n        for (const match of segment.segment.matchAll(TERM)) {\n          // A gap means punctuation stood there, which ends the run as surely\n          // as a non-word-like segment would: スネーク_ケース pairs either side\n          // of the connector, never across it.\n          if (match.index > end) {\n            flush();\n          }\n          take(match[0]);\n          end = match.index + match[0].length;\n        }\n        if (end < segment.segment.length) {\n          flush();\n        }\n      }\n      flush();\n      return [...tokens];\n    },\n  };\n};\n\n/**\n * On a Latin-default index holding pages in non-Latin locales, the tokenizer\n * each of those locales' pages was indexed with, keyed by locale code. A query\n * reads it to tokenize its term the way the pages it searches were.\n */\nconst translationTokenizers = new WeakMap<AnyOrama, Map<string, Tokenizer>>();\n\n/** A segmenting tokenizer for each document locale Orama's can't serve. */\nconst localeTokenizers = (documents: OramaDoc[]): Map<string, Tokenizer> => {\n  const tokenizers = new Map<string, Tokenizer>();\n  for (const code of new Set(documents.map((doc) => doc.locale ?? \"\"))) {\n    const tokenizer = segmentingTokenizer(code);\n    if (tokenizer) {\n      tokenizers.set(code, tokenizer);\n    }\n  }\n  return tokenizers;\n};\n\n/**\n * One tokenizer that hands each text to its locale's: Orama passes the\n * language given to `insert` and `search` through to `tokenize`, so a page\n * inserted under `ja` and a query searched under `ja` both reach the Japanese\n * tokenizer, and everything else reaches Orama's own, exactly as on an index\n * with no translations.\n */\nconst dispatchingTokenizer = (\n  tokenizers: Map<string, Tokenizer>\n): Tokenizer => {\n  const standard = components.tokenizer.createTokenizer();\n  return {\n    language: standard.language,\n    normalizationCache: standard.normalizationCache,\n    tokenize: (raw, language, prop, withCache) =>\n      // Orama's tokenizer rejects a language other than its own, so the\n      // locale that picked it is not passed on.\n      (tokenizers.get(language ?? \"\") ?? standard).tokenize(\n        raw,\n        undefined,\n        prop,\n        withCache\n      ),\n  };\n};\n\n/**\n * Build an in-memory Orama full-text index from search documents. Shared by the\n * Orama client loader (browser), the MCP server, and assistant grounding (Node),\n * so ranking is identical wherever docs are queried. `locale` — the site's\n * `i18n.defaultLocale` — swaps in a word-segmenting tokenizer for every\n * non-Latin script, all of which Orama's default tokenizer reduces to zero\n * tokens. A non-Latin default's tokenizer serves every page: Latin words\n * survive segmentation intact, so English pages on a segmented index stay\n * searchable. A Latin default keeps Orama's tokenizer for its Latin-script\n * pages, and each page in a non-Latin locale (the Japanese and Hindi\n * translations of an English site) is indexed with its own locale's tokenizer.\n */\nexport const buildOramaIndex = async (\n  documents: OramaDoc[],\n  locale?: string\n): Promise<AnyOrama> => {\n  const rows = documents.map((doc) =>\n    doc.facets ? { ...doc, facetTerms: toFacetTerms(doc.facets) } : doc\n  );\n  const tokenizer = segmentingTokenizer(locale);\n  const translations = tokenizer ? undefined : localeTokenizers(documents);\n  let db: AnyOrama;\n  if (translations && translations.size > 0) {\n    db = create({\n      components: { tokenizer: dispatchingTokenizer(translations) },\n      schema: SCHEMA,\n    });\n    for (const row of rows) {\n      // oxlint-disable-next-line no-await-in-loop -- one at a time, in order, so each page is tokenized under its own locale and ties still rank in document order.\n      await insert(db, row, row.locale);\n    }\n    translationTokenizers.set(db, translations);\n  } else {\n    db = tokenizer\n      ? create({ components: { tokenizer }, schema: SCHEMA })\n      : create({ schema: SCHEMA });\n    await insertMultiple(db, rows);\n  }\n  if (documents.some((doc) => (doc.boost ?? 1) !== 1)) {\n    boostedDatabases.add(db);\n  }\n  return db;\n};\n\n/** Orama keeps only documents matching every token at a threshold of 0. */\nconst ALL_TOKENS = 0;\n\n/** Optional exact-match filters applied to a query via Orama's `where`. */\nexport interface OramaQueryFilters {\n  /** Keep only documents whose `contentType` is in this list. */\n  contentTypes?: string[];\n  /**\n   * Keep only documents matching every facet, key → required value. Facet\n   * keys and values come from the `facets` field on the indexed documents.\n   */\n  facets?: Record<string, string>;\n  /** Keep only documents in this locale. */\n  locale?: string;\n  /**\n   * Keep only documents of this docs version (`\"\"` is the current docs — a\n   * meaningful filter value, so absence alone disables version filtering).\n   */\n  version?: string;\n}\n\n/**\n * The exact-match `where` clause the filters compile to. Orama types `where`\n * openly (any schema property to an operator), mirrored here by the index\n * signature; this module only ever emits the two enum operators.\n */\ninterface OramaWhereClause {\n  [property: string]:\n    | EnumArrComparisonOperator\n    | EnumComparisonOperator\n    | undefined;\n}\n\n/** A ranked match, scored and carrying its document. */\ntype Hit = Result<OramaDoc>;\n\n/**\n * One search, with the term tokenized under `language`. On a bigrammed\n * tokenizer the strict pass runs first: a term is only meant to match where\n * its bigrams sit together, and scoring them independently lets a page\n * sharing a couple of windows outrank the page the term is about. Terms\n * spanning several words rarely appear in full on one page, so an empty\n * strict result falls back to the default pass rather than reporting no\n * matches.\n */\nconst rankedHits = async (\n  db: AnyOrama,\n  params: SearchParamsFullText<AnyOrama, OramaDoc>,\n  language: string | undefined,\n  bigrammed: boolean\n): Promise<Hit[]> => {\n  // The result-document generic is OramaDoc because `buildOramaIndex` is the\n  // only writer to this database and inserts OramaDoc records (plus the\n  // derived `facetTerms`).\n  const strict = bigrammed\n    ? await search<AnyOrama, OramaDoc>(\n        db,\n        { ...params, threshold: ALL_TOKENS },\n        language\n      )\n    : undefined;\n  const found =\n    strict && strict.hits.length > 0\n      ? strict\n      : await search<AnyOrama, OramaDoc>(db, params, language);\n  return found.hits;\n};\n\n/** A hit's rank across searches: its relevance times the page's boost. */\nconst boostedScore = (hit: Hit): number =>\n  hit.score * (hit.document.boost ?? 1);\n\n/**\n * Query the index, returning the matching documents (highest-ranked first).\n * `filters` narrows results by exact `where` matches on the enum fields:\n * `locale` to one language, `contentTypes` to a set of page types, `facets`\n * to documents carrying every requested `key:value` term.\n *\n * On an index whose translations have tokenizers of their own, a query scoped\n * to a locale is tokenized with that locale's tokenizer. An unscoped query\n * searches each locale's pages with its own tokenizer, and the Latin-script\n * pages with Orama's, then merges the matches by score: every search runs over\n * the one index, so their scores share its term statistics.\n */\nexport const queryOramaIndex = async (\n  db: AnyOrama,\n  term: string,\n  limit: number,\n  filters?: OramaQueryFilters\n): Promise<OramaDoc[]> => {\n  const facetTerms = filters?.facets ? toFacetTerms(filters.facets) : [];\n  const where: OramaWhereClause = {};\n  if (filters?.locale) {\n    where.locale = { eq: filters.locale };\n  }\n  // `\"\"` (the current docs) is a real filter value, so test for presence.\n  if (filters?.version !== undefined) {\n    where.version = { eq: filters.version };\n  }\n  if (filters?.contentTypes && filters.contentTypes.length > 0) {\n    where.contentType = { in: filters.contentTypes };\n  }\n  if (facetTerms.length > 0) {\n    where.facetTerms = { containsAll: facetTerms };\n  }\n  // Boosts multiply every match's score before the limit applies (Orama\n  // sorts the whole match set with a sort function), so a boosted page can\n  // rise past matches outside the first page.\n  const unfiltered = {\n    boost: BOOST,\n    limit,\n    properties: [\"title\", \"keywords\", \"description\", \"content\"],\n    ...(boostedDatabases.has(db) && { sortBy: byBoostedScore }),\n    term,\n  };\n  const params =\n    Object.keys(where).length > 0 ? { ...unfiltered, where } : unfiltered;\n  const translations = translationTokenizers.get(db);\n  if (!translations) {\n    const bigrammed = isBigramLanguage(db.tokenizer?.language ?? \"\");\n    const hits = await rankedHits(db, params, undefined, bigrammed);\n    return hits.map((hit) => hit.document);\n  }\n  if (filters?.locale) {\n    const { language = \"\" } = translations.get(filters.locale) ?? {};\n    const bigrammed = isBigramLanguage(language);\n    const hits = await rankedHits(db, params, filters.locale, bigrammed);\n    return hits.map((hit) => hit.document);\n  }\n  // `nin` matches only pages with a locale, which every Blume-built index\n  // gives each page. (Orama's `not` would admit locale-less pages, but it\n  // drops the sibling filters beside it.)\n  const searches = [\n    rankedHits(\n      db,\n      {\n        ...params,\n        where: { ...where, locale: { nin: [...translations.keys()] } },\n      },\n      undefined,\n      false\n    ),\n    ...[...translations].map(([code, tokenizer]) =>\n      rankedHits(\n        db,\n        { ...params, where: { ...where, locale: { eq: code } } },\n        code,\n        isBigramLanguage(tokenizer.language)\n      )\n    ),\n  ];\n  const found = await Promise.all(searches);\n  return found\n    .flat()\n    .toSorted((a, b) => boostedScore(b) - boostedScore(a))\n    .slice(0, limit)\n    .map((hit) => hit.document);\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "E6710E6AD54250CC64756E2164756E21",
+  "names": []
+}

package/dist/cli/{chunk-2n4ps1b3.js → chunk-htrwgabr.js}

@@ -11,17 +11,17 @@ import {
 import {
   AGENTS,
   launchAgent
-} from "./chunk-0gz36akr.js";
+} from "./chunk-42t4jxdx.js";
 import {
   YAML_SCHEMA
-} from "./chunk-xkz5xbtv.js";
+} from "./chunk-ehweg4fr.js";
 import"./chunk-zccbjcj0.js";
 import {
   scanProject
-} from "./chunk-43zcf4gz.js";
+} from "./chunk-ncj7w596.js";
 import {
   buildMcpData
-} from "./chunk-2f3ndkpw.js";
+} from "./chunk-n0v7m8ry.js";
 import {
   seconds,
   money,
@@ -31,10 +31,10 @@ import {
   agentArgs,
   readAgentOutput,
   parseVerdict
-} from "./chunk-ga0pf4aj.js";
+} from "./chunk-0n9xkp3d.js";
 import {
   parseTimeoutSeconds
-} from "./chunk-4ejxbzee.js";
+} from "./chunk-j134vrp2.js";
 
 // src/cli/commands/eval.ts
 import { existsSync } from "node:fs";
@@ -73,7 +73,7 @@ An answer that states the documentation lacks the information FAILS.
 Reply with ONLY this JSON object on a single line, no markdown fences:
 {"pass": true|false, "score": 0.0-1.0, "missing": ["expected facts absent or contradicted"], "notes": "one sentence"}`;
 };
-var evalFixPrompt = (reportPath) => `Fix the documentation gaps found by \`blume eval\` in this project.
+var evalFixPrompt = (reportPath, command) => `Fix the documentation gaps found by \`blume eval\` in this project.
 
 The full report is at ${reportPath}. It is JSON: each entry in \`eval.results\` with status "fail" is one question the documentation could not answer. Each carries the \`question\`, the \`expected\` facts, the judge's \`missing\` facts, and the reader agent's \`answer\` (what the docs currently convey). The matching \`diagnostics\` entry names the source \`file\` of the page that should answer it.
 
@@ -82,7 +82,7 @@ Work through every failed question:
 2. Edit the documentation so it states the missing facts explicitly. Add prose, not filler; keep the page's voice.
 3. Never delete questions from the evals file or weaken expected facts.
 
-When you are done, run \`blume eval\` to verify, and repeat until every question passes.`;
+When you are done, run \`${command}\` to verify, and repeat until every question passes.`;
 var initPrompt = (evalsPath) => `Draft a starter evals file for \`blume eval\` in this documentation project.
 
 Read the documentation source pages in this project and write ${evalsPath} with about 10 high-value questions a real user would ask — installation, configuration, deployment, and the project's headline features. For each question, list the expected facts a correct answer must state, grounded in what the documentation actually promises (never invent facts the docs don't state).
@@ -114,18 +114,22 @@ var GLYPH = {
   error: "!",
   fail: "✖",
   pass: "✔",
-  skip: "⊘"
+  skip: "⊘",
+  warn: "⚠"
 };
 var STATUS_COLOR = {
   error: colors.yellow,
   fail: colors.red,
   pass: colors.green,
-  skip: colors.dim
+  skip: colors.dim,
+  warn: colors.yellow
 };
+var warned = (result) => result.status === "fail" && result.severity === "warning";
 var ID_PAD = 28;
 var questionLine = (result) => {
-  const color = STATUS_COLOR[result.status];
-  const glyph = color(GLYPH[result.status]);
+  const shown = warned(result) ? "warn" : result.status;
+  const color = STATUS_COLOR[shown];
+  const glyph = color(GLYPH[shown]);
   const id = result.id.padEnd(ID_PAD);
   if (result.status === "skip") {
     return `  ${glyph} ${id} ${colors.dim("skipped")}`;
@@ -133,7 +137,7 @@ var questionLine = (result) => {
   const score = result.score === undefined ? "" : result.score.toFixed(2);
   const cost = money(result.costUsd);
   const cells = [
-    color(result.status),
+    color(shown),
     score,
     colors.dim(seconds(result.durationMs)),
     cost === "" ? "" : colors.dim(cost)
@@ -158,9 +162,12 @@ var questionDetails = (result, verbose) => {
 };
 var summaryLine = (result) => {
   const { counts } = result;
+  const warnings = result.results.filter(warned).length;
+  const failures = counts.fail - warnings;
   const parts = [
     `${counts.pass} passed`,
-    counts.fail > 0 ? `${counts.fail} failed` : "",
+    failures > 0 ? `${failures} failed` : "",
+    warnings > 0 ? `${warnings} warned` : "",
     counts.error > 0 ? `${counts.error} errored` : "",
     counts.skip > 0 ? `${counts.skip} skipped` : "",
     duration(result.durationMs),
@@ -170,12 +177,12 @@ var summaryLine = (result) => {
 };
 var headerLine = (total, agent) => `${colors.bold("blume eval")}  ${total} question(s) · ${AGENTS[agent].name}`;
 var startLine = (id, index, total) => `  ${colors.dim(`▸ ${id} (${index + 1}/${total})`)}`;
-var fixLines = (result, root) => result.diagnostics.filter((diagnostic) => diagnostic.code !== "BLUME_EVAL_ROUTE_UNKNOWN").map((finding) => {
+var fixLines = (result, root) => result.diagnostics.filter((diagnostic) => diagnostic.severity !== "warning").map((finding) => {
   const site = finding.file ? `${relative(root, finding.file)}${finding.line ? `:${finding.line}` : ""}` : "";
   const label = finding.code === "BLUME_EVAL_QUESTION_ERROR" ? colors.red("run failed:") : colors.cyan("fix:");
   return `  ${label} ${site} ${colors.dim(finding.message)}`;
 });
-var warningLines = (result, root) => result.diagnostics.filter((diagnostic) => diagnostic.code === "BLUME_EVAL_ROUTE_UNKNOWN").map((finding) => {
+var warningLines = (result, root) => result.diagnostics.filter((diagnostic) => diagnostic.severity === "warning").map((finding) => {
   const site = finding.file ? ` ${relative(root, finding.file)}${finding.line ? `:${finding.line}` : ""}` : "";
   return `  ${colors.yellow("⚠")}${site} ${colors.dim(finding.message)}`;
 });
@@ -344,6 +351,7 @@ var errored = (question, detail, durationMs) => ({
   missing: [],
   question: question.question,
   routes: question.routes,
+  severity: question.severity,
   status: "error"
 });
 var runQuestion = async (question, index, context) => {
@@ -398,6 +406,7 @@ var runQuestion = async (question, index, context) => {
     question: question.question,
     routes: question.routes,
     score: verdict.score,
+    severity: question.severity,
     status: verdict.pass ? "pass" : "fail"
   };
 };
@@ -444,6 +453,7 @@ var runEval = async (options) => {
         missing: [],
         question: question.question,
         routes: question.routes,
+        severity: question.severity,
         status: "skip"
       });
       continue;
@@ -530,7 +540,14 @@ var parseFlags = (args) => {
   const timeoutS = parseTimeoutSeconds(args.timeout, DEFAULT_TIMEOUT_S);
   return { agent: args.agent, threshold, timeoutS };
 };
-var runFixHandoff = async (agent, result, root, threshold) => {
+var shellWord = (value) => /^[\w./:@%+=,-]+$/u.test(value) ? value : `'${value.replaceAll("'", String.raw`'\''`)}'`;
+var rerunCommand = (args, { agent, threshold, timeoutS }) => [
+  `blume eval --agent ${agent}`,
+  args.file === DEFAULT_FILE ? "" : `--file ${shellWord(args.file)}`,
+  args.threshold === undefined ? "" : `--threshold ${threshold}`,
+  args.timeout === undefined ? "" : `--timeout ${timeoutS}`
+].filter((part) => part !== "").join(" ");
+var runFixHandoff = async (agent, result, root, threshold, command) => {
   const count = result.counts.fail + result.counts.error;
   if (count === 0) {
     return;
@@ -540,7 +557,7 @@ var runFixHandoff = async (agent, result, root, threshold) => {
   process.stderr.write(`  Handing ${count} failed question${count === 1 ? "" : "s"} to ${cli.name}…
 
 `);
-  const code = await launchAgentCode(agent, evalFixPrompt(report));
+  const code = await launchAgentCode(agent, evalFixPrompt(report, command));
   if (code !== 0) {
     process.exit(code);
   }
@@ -597,7 +614,8 @@ var evalCommand = defineCommand({
   meta: commandMeta.eval,
   async run({ args }) {
     const root = process.cwd();
-    const { agent, threshold, timeoutS } = parseFlags(args);
+    const flags = parseFlags(args);
+    const { agent, threshold, timeoutS } = flags;
     if (args.action === "init") {
       await runInit(agent, args.file);
       return;
@@ -659,7 +677,7 @@ var evalCommand = defineCommand({
 `));
     const failed = passFraction(result) < threshold;
     if (args.fix) {
-      await runFixHandoff(agent, result, root, threshold);
+      await runFixHandoff(agent, result, root, threshold, rerunCommand(args, flags));
       return;
     }
     if (args.json) {
@@ -679,5 +697,5 @@ export {
   evalCommand
 };
 
-//# debugId=C123F57ABFFCB50F64756E2164756E21
-//# sourceMappingURL=chunk-2n4ps1b3.js.map
+//# debugId=7E23EC6FFD50900B64756E2164756E21
+//# sourceMappingURL=chunk-htrwgabr.js.map