blume 2.0.0 → 2.0.1

package/AGENTS.md

@@ -3,7 +3,7 @@
 This package ships agent skills for working with Blume documentation projects. Before modifying a Blume project, read the relevant skill. Each skill's canonical instructions live in its `SKILL.md`:
 
 - `./skills/blume/SKILL.md` — build and maintain a Blume site: scaffolding, writing Markdown/MDX, `blume.config.ts`, navigation, search, theming, SEO, and the `blume` CLI.
-- `./skills/blume-migrate/SKILL.md` — migrate an existing docs site (Mintlify, Fumadocs, Docusaurus, Starlight, Nextra, or another framework) to Blume. `blume migrate [source] --claude` (or `--codex`) opens an agent on it.
+- `./skills/blume-migrate/SKILL.md` — migrate an existing docs site (Mintlify, Fumadocs, Docusaurus, Starlight, Nextra, or another framework) to Blume. `blume migrate [source] --codex` (or `--claude`) opens an agent on it.
 - `./skills/blume-update-docs/SKILL.md` — audit a Blume docs site against the product it documents, fix stale pages, and open a maintenance pull request.
 
 Use the relevant `SKILL.md` as the source of truth for Blume-specific workflows. The full Blume documentation is bundled under `./docs/`, and the `blume` skill points at it.

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # blume
 
+## 2.0.1
+
+### Patch Changes
+
+- c785ef8: `blume eval` now runs its reader and judge with Codex by default; pass `--agent claude` to keep using Claude Code. The other agent commands (`audit`, `migrate`, `translate`, `upgrade`) now suggest `--codex` first in their hints and errors, as do the bundled skills.
+- f51f556: The previous and next page links now sit side by side at equal width on phones, as they do on larger screens, instead of stacking with only the previous link stretched full width. Long page titles wrap to a second line rather than truncating.
+- cd3cbe9: Rename Ask AI to the assistant. In `blume.config.ts`, `ai.ask` is now `ai.assistant`, with the same fields and no alias:
+  
+  ```ts
+  export default defineConfig({
+    ai: {
+      // was: ask: { enabled: true }
+      assistant: { enabled: true },
+    },
+  });
+  ```
+  
+  A config that still sets `ai.ask` fails validation with a hint naming `ai.assistant`, and `blume upgrade` and `blume doctor` report it at its line. The feature's other names follow:
+  
+  - `i18n.ui` overrides: the `ask` group is now `assistant`, and `search.askAi` and `search.askAiHint` are now `search.assistant` and `search.assistantHint`. The old keys fail validation with a hint, where an unknown key used to be dropped silently.
+  - `useAskAI` from `blume/hooks` is now `useAssistant`, and its `UseAskAI` and `UseAskAIOptions` types are now `UseAssistant` and `UseAssistantOptions`.
+  - The `askEnabled` prop on `PageLayout`, `RootLayout`, `Header`, and a `Search` override is now `assistantEnabled`.
+  - In `blume:data`, `config.ask` and `ui.ask` are now `config.assistant` and `ui.assistant`.
+  - The adapter types from `blume/ai` swap their `Ask` prefix for `Assistant` (`AskAdapter` is now `AssistantAdapter`), and `askReasoningLevels` and `AskReasoning` from `blume/schema` are now `assistantReasoningLevels` and `AssistantReasoning`.
+  - The `blume:open-ask-ai` window event is now `blume:open-assistant`, and the panel's `data-blume-ask` body attribute is now `data-blume-assistant`.
+  
+  The header trigger, panel title, and search hand-off now read "Assistant" in English and in every built-in locale. The generated `/api/ask` route and the `ask`, `ask_answer`, and `ask_error` analytics events keep their names. The unused `actions.askAI` UI string is removed.
+
 ## 2.0.0
 
 ### Major Changes

package/README.md

@@ -39,7 +39,7 @@ Moving from another docs framework? `npx blume migrate` hands a Mintlify, Fumado
 - **Type-safe config** — `blume.config.ts` and every `meta.ts` are real TypeScript, validated by a schema and authored with `defineConfig` / `defineMeta`, so your editor catches mistakes before a build.
 - **Components, no imports** — cards, columns, steps, tabs, accordions, badges, code groups, frames, file trees, type tables, live component previews, diffs, and more, usable in any MDX page.
 - **Local search** — Orama runs in dev and production with no hosted service; FlexSearch, Pagefind, Algolia, Typesense, Orama Cloud, and Mixedbread are one adapter away (`search: pagefind()` from `blume/search`).
-- **AI-ready** — `llms.txt` / `llms-full.txt`, raw Markdown at any `.md` URL, a JSON docs API, Copy as Markdown, Open in chat, an optional Ask AI assistant, and a hosted MCP server so coding agents can search and read your docs directly.
+- **AI-ready** — `llms.txt` / `llms-full.txt`, raw Markdown at any `.md` URL, a JSON docs API, Copy as Markdown, Open in chat, an optional in-page assistant, and a hosted MCP server so coding agents can search and read your docs directly.
 - **Agent skills** — Blume ships [agent skills](https://useblume.dev/docs/advanced/skills) that teach a coding agent to scaffold, write, and maintain your docs site.
 - **Content sources** — mix local files with remote MDX, GitHub Releases, Notion, Sanity, Contentful, Payload, Strapi, or any custom backend into a single site.
 - **Internationalization** — drop translated files into place for locale-aware routing, per-language navigation, translated UI, and SEO.
@@ -78,7 +78,7 @@ The Blume CLI loads `blume.config.ts`, scans your content into a graph, and gene
 
 ## Deployment
 
-`blume build` outputs static HTML to `dist/` — deploy to any static host (Vercel, Netlify, Cloudflare Pages, GitHub Pages, S3 + CloudFront, or any CDN). For request-time features like Ask AI or the MCP server, name a host adapter from `blume/deploy` in `blume.config.ts`, which switches the build to server output:
+`blume build` outputs static HTML to `dist/` — deploy to any static host (Vercel, Netlify, Cloudflare Pages, GitHub Pages, S3 + CloudFront, or any CDN). For request-time features like the assistant or the MCP server, name a host adapter from `blume/deploy` in `blume.config.ts`, which switches the build to server output:
 
 ```ts
 import { defineConfig } from "blume";

package/dist/cli/{chunk-f7t03s3g.js → chunk-27g6wdth.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   resolveRuntimeDir
-} from "./chunk-xaz13gwg.js";
+} from "./chunk-qkqwkpte.js";
 import {
   logger
 } from "./index.js";
@@ -133,4 +133,4 @@ var refuseIfDevRunning = (root, action, options = {}) => {
 export { readDevLock, DevLockHeldError, acquireDevLock, updateDevLockPort, describeDevLock, refuseIfDevRunning };
 
 //# debugId=1007843429DAE30664756E2164756E21
-//# sourceMappingURL=chunk-f7t03s3g.js.map
+//# sourceMappingURL=chunk-27g6wdth.js.map

package/dist/cli/{chunk-mnqj32sj.js → chunk-2hn4b8z7.js}

@@ -15,7 +15,7 @@ import {
   adapterRoot,
   SVG_ASSET_POLICY,
   deployPlatform
-} from "./chunk-xaz13gwg.js";
+} from "./chunk-qkqwkpte.js";
 import {
   BLUME_IGNORE_DIRS
 } from "./chunk-abh8yjkn.js";
@@ -255,8 +255,8 @@ var runtimeDependencies = (options) => {
       }
     }
   }
-  if (config.ai.ask?.enabled && !config.ai.ask.endpoint) {
-    deps.push(...config.ai.ask.provider.runtimeDeps);
+  if (config.ai.assistant?.enabled && !config.ai.assistant.endpoint) {
+    deps.push(...config.ai.assistant.provider.runtimeDeps);
   }
   deps.push(...config.deployment.runtimeDeps);
   return deps;
@@ -740,7 +740,7 @@ const ground = createAskContext(askData${groundOptions});
   }));`;
   const { keyCheck } = backend.template;
   const onError = `      onError({ error }) {
-        console.error("Ask AI provider error:", error);
+        console.error("Assistant provider error:", error);
       },`;
   const streamFields = [
     `model: ${backend.template.model}`,
@@ -779,22 +779,22 @@ ${setup}${cors.setup}
 ${handler}
 `;
 };
-var askComponentTemplate = (askEnabled) => askEnabled ? `---
+var askComponentTemplate = (assistantEnabled) => assistantEnabled ? `---
 // Generated by Blume. Do not edit.
-import AskAI from "blume/components/islands/AskAI.astro";
+import Assistant from "blume/components/islands/Assistant.astro";
 import data from "blume:data";
 
 const { strings } = Astro.props;
 ---
 
-<AskAI
-  endpoint={data.config.ask?.endpoint ?? undefined}
-  strings={strings ?? data.ui.ask}
-  suggestions={data.config.ask?.suggestions ?? []}
+<Assistant
+  endpoint={data.config.assistant?.endpoint ?? undefined}
+  strings={strings ?? data.ui.assistant}
+  suggestions={data.config.assistant?.suggestions ?? []}
 />
 ` : `---
 // Generated by Blume. Do not edit.
-// Ask AI is off (\`ai.ask.enabled\`), so the header's Ask trigger renders nothing.
+// The assistant is off (\`ai.assistant.enabled\`), so the header's Ask trigger renders nothing.
 // Deliberately imports no React island, keeping the JSX renderer out of projects
 // that don't need it.
 ---
@@ -2467,5 +2467,5 @@ var runtimeTsconfigTemplate = () => `${JSON.stringify({
 
 export { planComponentSlots, publishRuntimeModules, runtimeDependencies, EJECTED_CONFIG_HEADER, astroConfigTemplate, stagedContentDir, contentConfigTemplate, askEndpointTemplate, askComponentTemplate, searchEndpointTemplate, featuresTemplate, searchClientTemplate, mixedbreadSearchEndpointTemplate, rawMarkdownEndpointTemplate, contentAssetsEndpointTemplate, mcpPageFile, mcpEndpointTemplate, playgroundProxyTemplate, staticJsonEndpointTemplate, rssEndpointTemplate, navFragmentTemplate, ogEndpointTemplate, scalarReferenceTemplate, catchAllPageTemplate, changelogIndexTemplate, notFoundPageTemplate, notFoundMarkdownTemplate, notFoundJsonTemplate, apiPagesIndexTemplate, apiPageTemplate, apiNavigationTemplate, apiSearchTemplate, apiNotFoundTemplate, exampleSlug, exampleWrapperTemplate, examplesRouteBase, exampleMapTemplate, examplesPageTemplate, runtimePackageTemplate, runtimeTsconfigTemplate };
 
-//# debugId=9E2BF1A2CC0BBFF264756E2164756E21
-//# sourceMappingURL=chunk-mnqj32sj.js.map
+//# debugId=4C36F12BB67C30E764756E2164756E21
+//# sourceMappingURL=chunk-2hn4b8z7.js.map