blume 1.6.5 → 1.7.0

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # blume
 
+## 1.7.0
+
+### Minor Changes
+
+- 78aadc8: Bundle Mermaid and the EPUB generator only for sites that use them. Both were dynamic imports, so they never loaded on a page that didn't need them, but they were still built on every `blume build` — over 3 MB of client chunks (ELK, Cytoscape, KaTeX, every diagram type) that most sites never serve, and most of the client build's memory. The generated runtime now decides at generation time whether any page has a mermaid fence and whether `export.epub` is on, and leaves the libraries out of the module graph otherwise; the dev server also stops pre-bundling them for sites that don't need them.
+- 51eb2ac: Leave collapsed sidebar sections out of the page. In `group` and `page` display modes, a section that isn't open on the current page no longer ships its rows in that page's HTML; the empty disclosure or panel fetches a prerendered fragment on first open (prefetched on hover or focus, and kept for the visit), so a large site's pages carry only the open section instead of every section on every page. Group ids are now stable across tab-scoped views of the sidebar.
+
+### Patch Changes
+
+- ede3c94: Cache rendered OG cards between builds. Each card is stored under `node_modules/.cache/blume/og`, keyed by everything that decides its pixels (title, description, branding, palette, fonts, and the Blume version), so a rebuild renders only the cards whose inputs changed and reads the rest back from disk. The build log reports how many cards were reused, and cards no page asks for any more are pruned after each build.
+- a43c1d9: Paint code-block language icons from the theme instead of inlining an SVG in every block. A block now carries `data-icon="<slug>"` and the theme masks the brand path onto it, with one rule per language the site's Markdown uses, so a page with twenty TypeScript blocks no longer repeats the same 1 kB logo twenty times. Set icons rendered by the Icon component are deduplicated the same way, through a per-page sprite.
+- 7b7d585: Prerender pages concurrently. The build now renders up to eight pages at once (one per available CPU below that), so the main thread renders the next page while a page's OG card renders on a native thread and its HTML is written to disk, instead of idling behind each page's off-thread work. A 1,400-page site's route generation phase runs in roughly half the time.
+- 903eec0: Render the sidebar's group rows (collapsible summaries, flat headings, drill-in buttons, and the links inside them) through theme utility classes, as page rows already are, so a sidebar with many groups adds a few dozen bytes per group to every page instead of several hundred.
+- 7b7d585: Shrink the sidebar's per-page cost. Every page's HTML carries the whole sidebar, so on a large site the sidebar was most of every page: each row now renders as a single theme utility class (`blume-nav-link`) instead of a dozen Tailwind classes, a bare row drops its inner spans, and groups that don't contain the current page are rendered once per build and reused across pages. A 1,400-page site's pages go from about 570 kB to under 190 kB each, and the build's HTML output shrinks and renders accordingly.
+- 4005c27: Load the curated Google fonts that ship as variable fonts (every preset except IBM Plex Mono, IBM Plex Serif, and Space Mono) as one weight range, so each page declares one `@font-face` per style instead of one per weight — the same font files, a quarter of the inline font CSS. A configured `"100..900"` range now reaches Astro in the form it understands; it previously loaded nothing for that weight.
+- 071e35d: Fix `blume dev` and `blume build` failing on Windows with `Cannot find module '@astrojs/mdx'` under Bun's isolated linker. The hidden runtime's `node_modules` link is now a directory symlink (falling back to a junction where symlinks need elevated privileges), because Windows can't follow the relative symlinks Bun writes into Blume's dependency directory when they're reached through a junction.
+
+## 1.6.6
+
+### Patch Changes
+
+- 2c373ef: Stop repeating `API` in generated descriptions when the name already says it. API reference overview and operation meta descriptions no longer turn a spec titled `Example API` (or `Payments APIs`, `Example API v2`) into `Example API API`, and the generated `/openapi.json` title no longer doubles the word for a site titled the same way.
+- 520a660: Write the deploy artifacts from the integration's `astro:build:done` hook instead of after `astro build` returns: the search index and hosted-provider sync, `llms.txt`, `sitemap.xml`, `robots.txt`, `agent-readability.json`, the `.well-known` discovery files, Agent Skills, and the platform `_redirects`/`_headers` files now land in the directory Astro reports as its client output during the build. `blume build` output is unchanged. An ejected app keeps producing all of them from plain `astro build` — its config tells the hook to scan the project — so `blume eject` no longer warns that they are lost.
+- a63c10e: Serve the prerendered per-page JSON documents on Cloudflare server builds whose requests run through the Worker: the wrapper answers them from the asset binding (conditional revalidations included) instead of letting Astro hand them to the `/api/` catch-all, and `.json` files stay on the static path under a deployment base or the coarse worker-first fallback.
+- 1197e8b: Opt Cloudflare server builds out of Astro sessions with `session: false` instead of configuring an in-memory session driver. Blume never reads `Astro.session`; the driver only existed to keep `@astrojs/cloudflare` from declaring a `SESSION` KV binding, which Astro's opt-out now does directly.
+- 1328384: Declare Blume's page front-matter schema on the generated content collections, so `entry.data` in the runtime is typed and normalized the same way the scan's page metadata is. Custom front-matter keys pass through, and a page the scan already dropped as invalid resolves to defaults instead of failing Astro's content sync.
+- 4f5660b: Honor `Accept: text/markdown` and send the homepage agent-discovery `Link` header in `blume dev` when `deployment.base` is set. Astro's dev server rewrites the base off the URL before Blume's handler runs, so stripping it a second time left every request unmatched.
+- bbdaa55: Keep the dev server up across page adds, removes, and folder renames. `blume dev` used to stop and recreate the Astro server on every route-set change; it now asks Astro's content layer to re-sync (`refreshContent`) and republishes the Markdown-negotiation routes in memory, so the generated config no longer changes with content and Astro never restarts in place for it. A moved page answers under its new route within a second, and editing an `<include>` partial re-syncs the store the same way instead of touching page mtimes.
+- 6b9f367: Drop the `image-size` dependency. Its ICNS, HEIF/AVIF, and JXL parsers can be driven into an infinite loop by a crafted file with a zero-sized box or entry, which would hang `blume audit` or a build, and no patched release exists. The audit's Open Graph image checks now read dimensions through sharp, the image optimizer the build already ships, which covers the same formats and rejects malformed input instead of looping on it. SVG logos for the header and the OG card are measured by a small root-tag parser with the same rules as before: explicit `width`/`height`, a `viewBox` fallback, and CSS units at 96dpi.
+- 7ee1100: Show Blume's config and content errors in the browser error overlay during `blume dev` on published installs. The dev-server handle was a module-level variable, and the CLI bundle and the copy of the integration Vite loads are separate module instances, so the overlay only ever worked inside the Blume repository itself. The handle now lives on `globalThis`, like the runtime data registry.
+- 6b26322: Improve Ask AI grounding for conversational follow-ups and long structured pages. A bare follow-up ("Why?", "And then?") retrieves from the earlier user turn, a short follow-up keeps that turn's best match in view behind its own, and a question that names its subject always leads. Excerpts now keep whole Markdown sections — heading, list, and code fence intact — chosen by how well they cover the question rather than by length, and pages are parsed once per endpoint instead of per request. A closing code fence must now be bare, as CommonMark requires, so a same-length fence line with an info string inside an open block no longer ends it.
+- 8d32eb3: Keep `<include>`-bearing Markdown pages fresh through Astro's documented loader context instead of patching the content store's writes. The collection loader now records a digest of each including page's partials in the collection's meta store and evicts the page's entry when that digest changes, so Astro's glob loader re-renders it on the next sync exactly as it would a new file. Same behavior on a partial edit in dev and on a warm-cache production build; no more replaying the store's private import bookkeeping.
+- e9cd88f: Declare the `blume:*` virtual modules through Astro's `injectTypes` hook instead of a generated `src/env.d.ts`. The declarations now live under `.astro/integrations/blume/` and are referenced from Astro's own `types.d.ts`, so every project that mounts the integration — the hidden runtime and an ejected app alike — gets them without a hand-written file. A project `tsconfig.json` no longer needs `.blume/src/env.d.ts` in its `include`.
+- 3e58b91: Load only the selected CLI command, reducing startup time for every command.
+- f04afce: Read the Vercel function bundle audit's imports with `es-module-lexer` instead of a text scan, so code samples inside the MCP data chunk (a page quoting `import { config } from 'dotenv'` or `await import('bcryptjs')`) no longer fail `blume build` as missing packages.
+- 3422d29: Read provider secrets through Astro's `getSecret()` from `astro:env/server` instead of `process.env`: the Ask AI endpoint's provider key (and the AI Gateway key, now passed to the gateway provider explicitly), the Mixedbread search endpoint's key, and `<GithubInfo>`'s `GITHUB_TOKEN`. Each adapter supplies secrets its own way, so a Cloudflare deployment's Worker bindings now reach these endpoints the same as environment variables do on Node and Vercel.
+- 9dde9cb: Default `<html lang>` and `dir` in every document shell to the locale Astro resolves from the URL (`Astro.currentLocale`), then the site's default locale. A custom `pages/` page or a Scalar reference page under `/fr/` rendered as `lang="en"` unless it passed `locale` itself; the content catch-all still passes the manifest's locale, which also covers fallback pages.
+- 8bbf9a1: Set Astro's `trailingSlash: "never"` in the generated config instead of hand-splicing a trailing-slash redirect into the Vercel routing config. Blume already treats the slashless URL as the one address for a page (canonicals, sitemap, hreflang), so Astro now enforces it too: `blume dev` answers `/guide/` with a 404 that names the setting, an on-demand server route redirects to `/guide`, and the Vercel adapter emits the same 308 route from the config that Blume used to splice by hand. Prerendered pages on static hosts are served exactly as before.
+
 ## 1.6.5
 
 ### Patch Changes

package/bin/blume.mjs

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 // Blume CLI launcher.
 //
-// The published package ships a Node-compatible bundle at dist/cli/index.js
-// (built by scripts/build.ts) and the launcher prefers it. When it is absent —
+// The published package ships a Node-compatible bundle in dist/cli/ — the entry
+// index.js plus the code-split command chunks it imports, built by
+// scripts/build.ts — and the launcher prefers it. When it is absent —
 // e.g. running from a source checkout — it falls back to the TypeScript source,
 // which requires a TS-aware runtime such as Bun (`bun bin/blume.mjs <cmd>`).
 import { existsSync } from "node:fs";

package/dist/cli/chunk-0qhq7b8q.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+import {
+  serverFeatures
+} from "./chunk-n0nyat6g.js";
+import {
+  reportInternalError
+} from "./chunk-btfr9yvw.js";
+import {
+  generateRuntime
+} from "./chunk-5d4q7121.js";
+import {
+  loadEnvFiles
+} from "./chunk-vt8fgygt.js";
+import {
+  resolveAskBackend
+} from "./chunk-agy5rzxy.js";
+import {
+  scanProject
+} from "./chunk-s102bysw.js";
+import {
+  BlumeError,
+  hasErrors,
+  logger,
+  reportDiagnostics
+} from "./chunk-ey89bjj1.js";
+
+// src/cli/required-secrets.ts
+var checkRequiredSecrets = (config) => {
+  const diagnostics = [];
+  const requireSecret = (feature, env, note) => {
+    if (process.env[env]) {
+      return;
+    }
+    const noteSuffix = note ? ` (${note})` : "";
+    diagnostics.push({
+      code: "BLUME_MISSING_SECRET",
+      message: `${feature} is enabled but ${env} is not set${noteSuffix}.`,
+      severity: "warning",
+      suggestion: `Set ${env} in .env.local for local dev, or in your host's environment for production.`
+    });
+  };
+  if (config.ai.ask?.enabled && !config.ai.ask.endpoint) {
+    const backend = resolveAskBackend(config.ai.ask);
+    if (backend.kind === "gateway") {
+      requireSecret("Ask AI (AI Gateway)", "AI_GATEWAY_API_KEY", "on Vercel the gateway can also authenticate via OIDC");
+    } else {
+      requireSecret("Ask AI", backend.apiKeyEnv);
+    }
+  }
+  if (config.search.provider === "mixedbread") {
+    requireSecret("Mixedbread search", "MIXEDBREAD_API_KEY");
+  }
+  return diagnostics;
+};
+
+// src/cli/prepare.ts
+var prepareProject = async (options) => {
+  loadEnvFiles(options.root);
+  let project;
+  try {
+    project = await scanProject(options.root, {
+      devServerUrl: options.devServerUrl,
+      mode: options.mode,
+      overrides: options.overrides,
+      preview: options.preview,
+      refresh: options.refresh,
+      runtimeDir: options.runtimeDir
+    });
+  } catch (error) {
+    if (error instanceof BlumeError) {
+      reportDiagnostics([error.diagnostic], options.root);
+    } else {
+      reportInternalError(error);
+    }
+    process.exit(1);
+  }
+  if (options.mode === "build" && project.config.deployment.output === "static") {
+    const features = serverFeatures(project.config);
+    if (features.length > 0) {
+      reportDiagnostics([
+        {
+          code: "BLUME_SERVER_FEATURE_REQUIRED",
+          message: `${features.join(", ")} require server output, but deployment.output is "static".`,
+          severity: "error",
+          suggestion: 'Set deployment: { output: "server", adapter: "vercel" } in blume.config.ts.'
+        }
+      ], options.root);
+      process.exit(1);
+    }
+  }
+  const hadErrors = reportDiagnostics(project.diagnostics, options.root);
+  const dropped = project.droppedPages > 0 ? `${project.droppedPages} page(s) failed frontmatter validation and were dropped from the site. ` : "";
+  if (hadErrors && options.strict) {
+    logger.error(`Aborting due to errors. ${dropped}Fix the diagnostics above, or pass --no-strict to continue despite them.`);
+    process.exit(1);
+  }
+  if (hasErrors(project.diagnostics) && !options.strict) {
+    logger.warn(`Continuing despite errors. ${dropped}Use --strict to fail instead.`);
+  }
+  const { warnings } = await generateRuntime(project);
+  for (const warning of warnings) {
+    logger.warn(warning);
+  }
+  reportDiagnostics(checkRequiredSecrets(project.config), options.root);
+  return project;
+};
+
+export { prepareProject };
+
+//# debugId=134333D0D8A00B5564756E2164756E21
+//# sourceMappingURL=chunk-0qhq7b8q.js.map

package/dist/cli/chunk-0qhq7b8q.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/required-secrets.ts", "../src/cli/prepare.ts"],
+  "sourcesContent": [
+    "import { resolveAskBackend } from \"../ai/ask.ts\";\nimport type { ResolvedConfig } from \"../core/schema.ts\";\nimport type { Diagnostic } from \"../core/types.ts\";\n\n/**\n * Warn early when an enabled feature needs a secret env var that isn't set, so\n * the failure surfaces at `blume dev`/`build` instead of at the first request in\n * production. These are runtime secrets (the endpoint reads them on the server),\n * so this warns rather than hard-fails — the value may live only in the deploy\n * environment. Build-time secrets (search-index sync) already warn during sync.\n */\nexport const checkRequiredSecrets = (config: ResolvedConfig): Diagnostic[] => {\n  const diagnostics: Diagnostic[] = [];\n  const requireSecret = (feature: string, env: string, note?: string): void => {\n    if (process.env[env]) {\n      return;\n    }\n    const noteSuffix = note ? ` (${note})` : \"\";\n    diagnostics.push({\n      code: \"BLUME_MISSING_SECRET\",\n      message: `${feature} is enabled but ${env} is not set${noteSuffix}.`,\n      severity: \"warning\",\n      suggestion: `Set ${env} in .env.local for local dev, or in your host's environment for production.`,\n    });\n  };\n\n  if (config.ai.ask?.enabled && !config.ai.ask.endpoint) {\n    const backend = resolveAskBackend(config.ai.ask);\n    if (backend.kind === \"gateway\") {\n      requireSecret(\n        \"Ask AI (AI Gateway)\",\n        \"AI_GATEWAY_API_KEY\",\n        \"on Vercel the gateway can also authenticate via OIDC\"\n      );\n    } else {\n      requireSecret(\"Ask AI\", backend.apiKeyEnv);\n    }\n  }\n\n  if (config.search.provider === \"mixedbread\") {\n    requireSecret(\"Mixedbread search\", \"MIXEDBREAD_API_KEY\");\n  }\n\n  return diagnostics;\n};\n",
+    "import { generateRuntime } from \"../astro/generate.ts\";\nimport { BlumeError, hasErrors } from \"../core/diagnostics.ts\";\nimport { scanProject } from \"../core/project-graph.ts\";\nimport type {\n  BlumeProject,\n  BuildMode,\n  ConfigOverrides,\n} from \"../core/project-graph.ts\";\nimport { serverFeatures } from \"../core/server-features.ts\";\nimport { loadEnvFiles } from \"./env.ts\";\nimport { reportInternalError } from \"./internal-error.ts\";\nimport { logger, reportDiagnostics } from \"./log.ts\";\nimport { checkRequiredSecrets } from \"./required-secrets.ts\";\n\nexport interface PrepareOptions {\n  root: string;\n  mode?: BuildMode;\n  strict?: boolean;\n  /** Local dev server URL, used as the `deployment.site` fallback (dev only). */\n  devServerUrl?: string;\n  /** Render drafts and fetch unpublished CMS content. */\n  preview?: boolean;\n  /** Force remote sources to re-fetch instead of serving the cached snapshot. */\n  refresh?: boolean;\n  /** CLI config overrides (e.g. `--output`, `--content-dir`). */\n  overrides?: ConfigOverrides;\n  /** Relocate the generated runtime (e.g. `.blume-verify` for `--isolated`). */\n  runtimeDir?: string;\n}\n\n/**\n * Scan the project, surface diagnostics, and (re)generate the `.blume` runtime.\n * In strict mode, any error aborts. Returns the resolved project.\n */\nexport const prepareProject = async (\n  options: PrepareOptions\n): Promise<BlumeProject> => {\n  // Load `.env` files from the project root before the scan: remote sources\n  // read their tokens from `process.env` during `scanProject`, and\n  // `loadEnvFiles` never overrides variables that are already set.\n  loadEnvFiles(options.root);\n\n  let project: BlumeProject;\n  try {\n    project = await scanProject(options.root, {\n      devServerUrl: options.devServerUrl,\n      mode: options.mode,\n      overrides: options.overrides,\n      preview: options.preview,\n      refresh: options.refresh,\n      runtimeDir: options.runtimeDir,\n    });\n  } catch (error) {\n    if (error instanceof BlumeError) {\n      reportDiagnostics([error.diagnostic], options.root);\n    } else {\n      reportInternalError(error);\n    }\n    process.exit(1);\n  }\n\n  // Hard gate: server-only features cannot ship in a static build.\n  if (\n    options.mode === \"build\" &&\n    project.config.deployment.output === \"static\"\n  ) {\n    const features = serverFeatures(project.config);\n    if (features.length > 0) {\n      reportDiagnostics(\n        [\n          {\n            code: \"BLUME_SERVER_FEATURE_REQUIRED\",\n            message: `${features.join(\", \")} require server output, but deployment.output is \"static\".`,\n            severity: \"error\",\n            suggestion:\n              'Set deployment: { output: \"server\", adapter: \"vercel\" } in blume.config.ts.',\n          },\n        ],\n        options.root\n      );\n      process.exit(1);\n    }\n  }\n\n  const hadErrors = reportDiagnostics(project.diagnostics, options.root);\n  const dropped =\n    project.droppedPages > 0\n      ? `${project.droppedPages} page(s) failed frontmatter validation and were dropped from the site. `\n      : \"\";\n  if (hadErrors && options.strict) {\n    logger.error(\n      `Aborting due to errors. ${dropped}Fix the diagnostics above, or pass --no-strict to continue despite them.`\n    );\n    process.exit(1);\n  }\n  if (hasErrors(project.diagnostics) && !options.strict) {\n    logger.warn(\n      `Continuing despite errors. ${dropped}Use --strict to fail instead.`\n    );\n  }\n\n  const { warnings } = await generateRuntime(project);\n  for (const warning of warnings) {\n    logger.warn(warning);\n  }\n\n  // Fail-fast on missing runtime secrets: warn now, not at the first request.\n  reportDiagnostics(checkRequiredSecrets(project.config), options.root);\n\n  return project;\n};\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;AAWO,IAAM,uBAAuB,CAAC,WAAyC;AAAA,EAC5E,MAAM,cAA4B,CAAC;AAAA,EACnC,MAAM,gBAAgB,CAAC,SAAiB,KAAa,SAAwB;AAAA,IAC3E,IAAI,QAAQ,IAAI,MAAM;AAAA,MACpB;AAAA,IACF;AAAA,IACA,MAAM,aAAa,OAAO,KAAK,UAAU;AAAA,IACzC,YAAY,KAAK;AAAA,MACf,MAAM;AAAA,MACN,SAAS,GAAG,0BAA0B,iBAAiB;AAAA,MACvD,UAAU;AAAA,MACV,YAAY,OAAO;AAAA,IACrB,CAAC;AAAA;AAAA,EAGH,IAAI,OAAO,GAAG,KAAK,WAAW,CAAC,OAAO,GAAG,IAAI,UAAU;AAAA,IACrD,MAAM,UAAU,kBAAkB,OAAO,GAAG,GAAG;AAAA,IAC/C,IAAI,QAAQ,SAAS,WAAW;AAAA,MAC9B,cACE,uBACA,sBACA,sDACF;AAAA,IACF,EAAO;AAAA,MACL,cAAc,UAAU,QAAQ,SAAS;AAAA;AAAA,EAE7C;AAAA,EAEA,IAAI,OAAO,OAAO,aAAa,cAAc;AAAA,IAC3C,cAAc,qBAAqB,oBAAoB;AAAA,EACzD;AAAA,EAEA,OAAO;AAAA;;;ACTF,IAAM,iBAAiB,OAC5B,YAC0B;AAAA,EAI1B,aAAa,QAAQ,IAAI;AAAA,EAEzB,IAAI;AAAA,EACJ,IAAI;AAAA,IACF,UAAU,MAAM,YAAY,QAAQ,MAAM;AAAA,MACxC,cAAc,QAAQ;AAAA,MACtB,MAAM,QAAQ;AAAA,MACd,WAAW,QAAQ;AAAA,MACnB,SAAS,QAAQ;AAAA,MACjB,SAAS,QAAQ;AAAA,MACjB,YAAY,QAAQ;AAAA,IACtB,CAAC;AAAA,IACD,OAAO,OAAO;AAAA,IACd,IAAI,iBAAiB,YAAY;AAAA,MAC/B,kBAAkB,CAAC,MAAM,UAAU,GAAG,QAAQ,IAAI;AAAA,IACpD,EAAO;AAAA,MACL,oBAAoB,KAAK;AAAA;AAAA,IAE3B,QAAQ,KAAK,CAAC;AAAA;AAAA,EAIhB,IACE,QAAQ,SAAS,WACjB,QAAQ,OAAO,WAAW,WAAW,UACrC;AAAA,IACA,MAAM,WAAW,eAAe,QAAQ,MAAM;AAAA,IAC9C,IAAI,SAAS,SAAS,GAAG;AAAA,MACvB,kBACE;AAAA,QACE;AAAA,UACE,MAAM;AAAA,UACN,SAAS,GAAG,SAAS,KAAK,IAAI;AAAA,UAC9B,UAAU;AAAA,UACV,YACE;AAAA,QACJ;AAAA,MACF,GACA,QAAQ,IACV;AAAA,MACA,QAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AAAA,EAEA,MAAM,YAAY,kBAAkB,QAAQ,aAAa,QAAQ,IAAI;AAAA,EACrE,MAAM,UACJ,QAAQ,eAAe,IACnB,GAAG,QAAQ,wFACX;AAAA,EACN,IAAI,aAAa,QAAQ,QAAQ;AAAA,IAC/B,OAAO,MACL,2BAA2B,iFAC7B;AAAA,IACA,QAAQ,KAAK,CAAC;AAAA,EAChB;AAAA,EACA,IAAI,UAAU,QAAQ,WAAW,KAAK,CAAC,QAAQ,QAAQ;AAAA,IACrD,OAAO,KACL,8BAA8B,sCAChC;AAAA,EACF;AAAA,EAEA,QAAQ,aAAa,MAAM,gBAAgB,OAAO;AAAA,EAClD,WAAW,WAAW,UAAU;AAAA,IAC9B,OAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EAGA,kBAAkB,qBAAqB,QAAQ,MAAM,GAAG,QAAQ,IAAI;AAAA,EAEpE,OAAO;AAAA;",
+  "debugId": "134333D0D8A00B5564756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-18tjv4f7.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import {
+  ensureGitignore
+} from "./chunk-5hs6gb7n.js";
+import {
+  prepareProject
+} from "./chunk-0qhq7b8q.js";
+import"./chunk-n0nyat6g.js";
+import"./chunk-btfr9yvw.js";
+import {
+  refuseIfDevRunning
+} from "./chunk-ye9zdkgv.js";
+import"./chunk-5d4q7121.js";
+import"./chunk-ynacq3ev.js";
+import"./chunk-pxj10x8y.js";
+import"./chunk-sbdqrjbb.js";
+import"./chunk-v5mm027v.js";
+import"./chunk-ev67ycx0.js";
+import"./chunk-vt8fgygt.js";
+import"./chunk-3r94j3tc.js";
+import"./chunk-agy5rzxy.js";
+import"./chunk-j6pxe0dt.js";
+import"./chunk-vxv4x1n8.js";
+import"./chunk-wd27zjcz.js";
+import"./chunk-s102bysw.js";
+import"./chunk-xv91q4nm.js";
+import"./chunk-27gtm2ym.js";
+import"./chunk-4xyggvgf.js";
+import"./chunk-6kzzpsx8.js";
+import {
+  logger
+} from "./chunk-ey89bjj1.js";
+import {
+  commandMeta
+} from "./chunk-2aj8ddew.js";
+
+// src/cli/commands/check.ts
+import { existsSync } from "node:fs";
+import { check } from "@astrojs/check";
+import { sync } from "astro";
+import { defineCommand } from "citty";
+import { join } from "pathe";
+var checkCommand = defineCommand({
+  args: {
+    isolated: {
+      description: "Type-check in an isolated .blume-verify runtime so a running dev server is untouched. For verifying changes while `blume dev` runs.",
+      type: "boolean"
+    },
+    preview: {
+      description: "Include drafts and unpublished CMS content.",
+      type: "boolean"
+    },
+    strict: {
+      description: "Fail on content diagnostics as well as type errors.",
+      type: "boolean"
+    }
+  },
+  meta: commandMeta.check,
+  async run({ args }) {
+    const root = process.cwd();
+    const runtimeDir = args.isolated ? ".blume-verify" : process.env.BLUME_RUNTIME_DIR;
+    refuseIfDevRunning(root, "checking", { isolatedHint: true, runtimeDir });
+    if (args.isolated) {
+      await ensureGitignore(root, [".blume-verify/"]);
+    }
+    const project = await prepareProject({
+      mode: "build",
+      preview: args.preview,
+      root,
+      runtimeDir,
+      strict: args.strict
+    });
+    const { outDir } = project.context;
+    await sync({ logLevel: "warn", root: outDir });
+    const tsconfig = join(root, "tsconfig.json");
+    logger.start(`Type-checking ${project.graph.pages.length} page(s)`);
+    const failed = await check({
+      minimumFailingSeverity: "error",
+      minimumSeverity: "hint",
+      root: outDir,
+      tsconfig: existsSync(tsconfig) ? tsconfig : undefined,
+      watch: false
+    });
+    if (failed) {
+      logger.error("Type check failed.");
+      process.exit(1);
+    }
+    logger.success("No type errors.");
+  }
+});
+export {
+  checkCommand
+};
+
+//# debugId=3E921ABECB33B7AC64756E2164756E21
+//# sourceMappingURL=chunk-18tjv4f7.js.map

package/dist/cli/chunk-18tjv4f7.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/check.ts"],
+  "sourcesContent": [
+    "import { existsSync } from \"node:fs\";\n\nimport { check } from \"@astrojs/check\";\nimport { sync } from \"astro\";\nimport { defineCommand } from \"citty\";\nimport { join } from \"pathe\";\n\nimport { ensureGitignore } from \"../../core/gitignore.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { refuseIfDevRunning } from \"../dev-lock.ts\";\nimport { logger } from \"../log.ts\";\nimport { prepareProject } from \"../prepare.ts\";\n\nexport const checkCommand = defineCommand({\n  args: {\n    isolated: {\n      description:\n        \"Type-check in an isolated .blume-verify runtime so a running dev server is untouched. For verifying changes while `blume dev` runs.\",\n      type: \"boolean\",\n    },\n    preview: {\n      description: \"Include drafts and unpublished CMS content.\",\n      type: \"boolean\",\n    },\n    strict: {\n      description: \"Fail on content diagnostics as well as type errors.\",\n      type: \"boolean\",\n    },\n  },\n  meta: commandMeta.check,\n  async run({ args }) {\n    const root = process.cwd();\n\n    // `blume check` regenerates `.blume` just like `build`, so it must refuse a\n    // live dev server unless isolated. `--isolated` (or BLUME_RUNTIME_DIR)\n    // relocates the runtime to `.blume-verify`, which dev never locks.\n    const runtimeDir = args.isolated\n      ? \".blume-verify\"\n      : process.env.BLUME_RUNTIME_DIR;\n    refuseIfDevRunning(root, \"checking\", { isolatedHint: true, runtimeDir });\n    if (args.isolated) {\n      await ensureGitignore(root, [\".blume-verify/\"]);\n    }\n\n    const project = await prepareProject({\n      mode: \"build\",\n      preview: args.preview,\n      root,\n      runtimeDir,\n      strict: args.strict,\n    });\n\n    const { outDir } = project.context;\n\n    // Generate Astro's content/collection and font types into `.blume/.astro`\n    // so `astro:*` virtual modules resolve during the check.\n    await sync({ logLevel: \"warn\", root: outDir });\n\n    // The project-root tsconfig is what covers the authored `pages/` and config;\n    // without it astro check only sees the generated `.blume` project. Falls back\n    // to the generated project's own tsconfig when the project has none.\n    const tsconfig = join(root, \"tsconfig.json\");\n\n    logger.start(`Type-checking ${project.graph.pages.length} page(s)`);\n    const failed = await check({\n      minimumFailingSeverity: \"error\",\n      minimumSeverity: \"hint\",\n      root: outDir,\n      tsconfig: existsSync(tsconfig) ? tsconfig : undefined,\n      watch: false,\n    });\n\n    if (failed) {\n      logger.error(\"Type check failed.\");\n      process.exit(1);\n    }\n\n    logger.success(\"No type errors.\");\n  },\n});\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAEA;AACA;AACA;AACA;AAQO,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,UAAU;AAAA,MACR,aACE;AAAA,MACF,MAAM;AAAA,IACR;AAAA,IACA,SAAS;AAAA,MACP,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,IACA,QAAQ;AAAA,MACN,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,MAAM,YAAY;AAAA,OACZ,IAAG,GAAG,QAAQ;AAAA,IAClB,MAAM,OAAO,QAAQ,IAAI;AAAA,IAKzB,MAAM,aAAa,KAAK,WACpB,kBACA,QAAQ,IAAI;AAAA,IAChB,mBAAmB,MAAM,YAAY,EAAE,cAAc,MAAM,WAAW,CAAC;AAAA,IACvE,IAAI,KAAK,UAAU;AAAA,MACjB,MAAM,gBAAgB,MAAM,CAAC,gBAAgB,CAAC;AAAA,IAChD;AAAA,IAEA,MAAM,UAAU,MAAM,eAAe;AAAA,MACnC,MAAM;AAAA,MACN,SAAS,KAAK;AAAA,MACd;AAAA,MACA;AAAA,MACA,QAAQ,KAAK;AAAA,IACf,CAAC;AAAA,IAED,QAAQ,WAAW,QAAQ;AAAA,IAI3B,MAAM,KAAK,EAAE,UAAU,QAAQ,MAAM,OAAO,CAAC;AAAA,IAK7C,MAAM,WAAW,KAAK,MAAM,eAAe;AAAA,IAE3C,OAAO,MAAM,iBAAiB,QAAQ,MAAM,MAAM,gBAAgB;AAAA,IAClE,MAAM,SAAS,MAAM,MAAM;AAAA,MACzB,wBAAwB;AAAA,MACxB,iBAAiB;AAAA,MACjB,MAAM;AAAA,MACN,UAAU,WAAW,QAAQ,IAAI,WAAW;AAAA,MAC5C,OAAO;AAAA,IACT,CAAC;AAAA,IAED,IAAI,QAAQ;AAAA,MACV,OAAO,MAAM,oBAAoB;AAAA,MACjC,QAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,IAEA,OAAO,QAAQ,iBAAiB;AAAA;AAEpC,CAAC;",
+  "debugId": "3E921ABECB33B7AC64756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-27gtm2ym.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+
+// src/core/trim.ts
+var trimStart = (text, char) => {
+  let start = 0;
+  while (start < text.length && text[start] === char) {
+    start += 1;
+  }
+  return text.slice(start);
+};
+var trimEnd = (text, char) => {
+  let end = text.length;
+  while (end > 0 && text[end - 1] === char) {
+    end -= 1;
+  }
+  return text.slice(0, end);
+};
+var trimChar = (text, char) => trimEnd(trimStart(text, char), char);
+
+// src/core/base-path.ts
+var normalizeBasePath = (input) => {
+  if (!input) {
+    return "";
+  }
+  const trimmed = input.trim().split("/").filter(Boolean).join("/");
+  return trimmed === "" ? "" : `/${trimmed}`;
+};
+var normalizePath = (path) => {
+  const trimmed = trimEnd(path, "/");
+  return trimmed === "" ? "/" : trimmed;
+};
+var normalizeRoute = (input) => {
+  const trimmed = trimEnd(input.trim(), "/");
+  if (trimmed === "") {
+    return "/";
+  }
+  return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+};
+var isInternalPath = (target) => target.startsWith("/") && !target.startsWith("//");
+var withBasePath = (basePath, route) => {
+  if (!basePath || !isInternalPath(route)) {
+    return route;
+  }
+  if (route === basePath || route.startsWith(`${basePath}/`)) {
+    return route;
+  }
+  return route === "/" ? basePath : `${basePath}${route}`;
+};
+var withComposedBasePath = (deployBase, basePath, route) => {
+  const composed = `${deployBase}${basePath}`;
+  if (composed && isInternalPath(route) && (route === composed || route.startsWith(`${composed}/`))) {
+    return route;
+  }
+  return withBasePath(deployBase, withBasePath(basePath, route));
+};
+var stripBasePath = (basePath, route) => {
+  if (!basePath) {
+    return route;
+  }
+  if (route === basePath) {
+    return "/";
+  }
+  return route.startsWith(`${basePath}/`) ? route.slice(basePath.length) : route;
+};
+
+export { trimEnd, trimChar, normalizeBasePath, normalizePath, normalizeRoute, isInternalPath, withBasePath, withComposedBasePath, stripBasePath };
+
+//# debugId=208B4F87BEF51A7364756E2164756E21
+//# sourceMappingURL=chunk-27gtm2ym.js.map

package/dist/cli/chunk-27gtm2ym.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/core/trim.ts", "../src/core/base-path.ts"],
+  "sourcesContent": [
+    "/**\n * Single-character trimming, done without regular expressions.\n *\n * The obvious spellings — `/^\\/+/`, `/\\/+$/`, `/^\\/+|\\/+$/g` — take quadratic\n * time on a run of the trimmed character, because a failed match at one start\n * position tells the engine nothing about the next one. Every caller here trims\n * a value that comes from outside Blume (a configured route, a spec URL, a site\n * origin), so the slow path is reachable from user input rather than only from\n * our own literals. These loops are linear and allocation-free.\n */\n\n/** Drop every leading `char` (`\"///a\"` -> `\"a\"` for `\"/\"`). */\nexport const trimStart = (text: string, char: string): string => {\n  let start = 0;\n  while (start < text.length && text[start] === char) {\n    start += 1;\n  }\n  return text.slice(start);\n};\n\n/** Drop every trailing `char` (`\"a///\"` -> `\"a\"` for `\"/\"`). */\nexport const trimEnd = (text: string, char: string): string => {\n  let end = text.length;\n  while (end > 0 && text[end - 1] === char) {\n    end -= 1;\n  }\n  return text.slice(0, end);\n};\n\n/** Drop every leading *and* trailing `char` (`\"///a///\"` -> `\"a\"`). */\nexport const trimChar = (text: string, char: string): string =>\n  trimEnd(trimStart(text, char), char);\n",
+    "/**\n * The site-wide `basePath` — a mount point that prepends a segment to every\n * generated route (`/docs/getting-started`) while staying invisible to the\n * navigation tree (see `core/navigation.ts`, which builds groups from a page's\n * base-less `navPath` and takes URLs from its based `route`). This is distinct\n * from a per-source `prefix` (a namespace that *does* create a sidebar group)\n * and from `deployment.base` (Astro's host-subdirectory base); the two compose,\n * stacking as `{deployment.base}/{basePath}/page`.\n *\n * These helpers run server-side (config, route construction, the link checker,\n * redirects, the markdown link plugin). The client-side counterpart lives in\n * `components/islands/base-path.ts` and serves `deployment.base` via `BASE_URL`.\n */\n\nimport { trimEnd } from \"./trim.ts\";\n\n/**\n * Canonicalize a configured base path to either `\"\"` (none) or `/seg[/seg…]`\n * (leading slash, no trailing slash, collapsed inner slashes). A blank value or\n * bare `/` normalizes to `\"\"`, so an unset/`\"/\"` base is a clean no-op.\n */\nexport const normalizeBasePath = (input?: string): string => {\n  if (!input) {\n    return \"\";\n  }\n  // Splitting on \"/\" and dropping the empty parts trims the edges and collapses\n  // inner runs in one linear pass; the regex spellings of both are quadratic on\n  // a long run of slashes (see `core/trim.ts`).\n  const trimmed = input.trim().split(\"/\").filter(Boolean).join(\"/\");\n  return trimmed === \"\" ? \"\" : `/${trimmed}`;\n};\n\n/**\n * Normalize a served path for comparison: drop the trailing slash (Astro serves\n * `/docs` and `/docs/` as the same page) and collapse an empty path to `/`.\n */\nexport const normalizePath = (path: string): string => {\n  const trimmed = trimEnd(path, \"/\");\n  return trimmed === \"\" ? \"/\" : trimmed;\n};\n\n/**\n * Canonicalize a route-ish string (a configured route, a page path, an agent-\n * supplied route) to `/` or `/seg[/seg…]`: trimmed, exactly one leading slash,\n * no trailing slash. The shared spelling of what openapi/references,\n * ai/ask-context, and ai/mcp/server each hand-rolled with slightly different\n * regexes.\n */\nexport const normalizeRoute = (input: string): string => {\n  const trimmed = trimEnd(input.trim(), \"/\");\n  if (trimmed === \"\") {\n    return \"/\";\n  }\n  return trimmed.startsWith(\"/\") ? trimmed : `/${trimmed}`;\n};\n\n/**\n * Whether a link target is a root-relative internal path (`/x`) — the only\n * shape a base path applies to. Protocol-relative (`//host`), absolute URLs,\n * other schemes (`mailto:`), fragments (`#x`), and relative paths are excluded.\n */\nexport const isInternalPath = (target: string): boolean =>\n  target.startsWith(\"/\") && !target.startsWith(\"//\");\n\n/**\n * Whether a rendered link should open in a new tab: an absolute http(s) URL or\n * a protocol-relative one (`//host/path`). Other schemes (`mailto:`, `tel:`)\n * also leave the site but hand off to another application, where a `_blank`\n * target only opens an empty tab beside it. The one predicate behind every\n * chrome link, so a header action and a sidebar featured link treat the same\n * href alike.\n */\nexport const isExternalUrl = (target: string): boolean =>\n  /^https?:\\/\\//iu.test(target) || target.startsWith(\"//\");\n\n/**\n * Idempotently prepend `basePath` to a root-relative route. A route already\n * equal to or nested under the base is returned unchanged, so authors who write\n * the base by hand (`/docs/x`) aren't double-prefixed to `/docs/docs/x`.\n */\nexport const withBasePath = (basePath: string, route: string): string => {\n  if (!basePath || !isInternalPath(route)) {\n    return route;\n  }\n  if (route === basePath || route.startsWith(`${basePath}/`)) {\n    return route;\n  }\n  return route === \"/\" ? basePath : `${basePath}${route}`;\n};\n\n/**\n * {@link withBasePath} for the composed `deployment.base` + `basePath` stack\n * (`/base` + `/docs` serves pages at `/base/docs/x`). The hand-written-base\n * promise applies per layer: authors write `basePath` by hand (see\n * `markdown/base-links.ts`), so a `/docs/x` link gains only the deployment base\n * (`/base/docs/x`) rather than being double-prefixed to `/base/docs/docs/x`,\n * and a route already under the full composite is returned unchanged.\n */\nexport const withComposedBasePath = (\n  deployBase: string,\n  basePath: string,\n  route: string\n): string => {\n  const composed = `${deployBase}${basePath}`;\n  if (\n    composed &&\n    isInternalPath(route) &&\n    (route === composed || route.startsWith(`${composed}/`))\n  ) {\n    return route;\n  }\n  return withBasePath(deployBase, withBasePath(basePath, route));\n};\n\n/**\n * Remove `basePath` from the front of a route (`/docs/guide` -> `/guide`,\n * `/docs` -> `/`). A route not under the base is returned unchanged. Inverse of\n * {@link withBasePath}; used to resolve public assets, which live at the site\n * root regardless of the base.\n */\nexport const stripBasePath = (basePath: string, route: string): string => {\n  if (!basePath) {\n    return route;\n  }\n  if (route === basePath) {\n    return \"/\";\n  }\n  return route.startsWith(`${basePath}/`)\n    ? route.slice(basePath.length)\n    : route;\n};\n"
+  ],
+  "mappings": ";;;AAYO,IAAM,YAAY,CAAC,MAAc,SAAyB;AAAA,EAC/D,IAAI,QAAQ;AAAA,EACZ,OAAO,QAAQ,KAAK,UAAU,KAAK,WAAW,MAAM;AAAA,IAClD,SAAS;AAAA,EACX;AAAA,EACA,OAAO,KAAK,MAAM,KAAK;AAAA;AAIlB,IAAM,UAAU,CAAC,MAAc,SAAyB;AAAA,EAC7D,IAAI,MAAM,KAAK;AAAA,EACf,OAAO,MAAM,KAAK,KAAK,MAAM,OAAO,MAAM;AAAA,IACxC,OAAO;AAAA,EACT;AAAA,EACA,OAAO,KAAK,MAAM,GAAG,GAAG;AAAA;AAInB,IAAM,WAAW,CAAC,MAAc,SACrC,QAAQ,UAAU,MAAM,IAAI,GAAG,IAAI;;;ACV9B,IAAM,oBAAoB,CAAC,UAA2B;AAAA,EAC3D,IAAI,CAAC,OAAO;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EAIA,MAAM,UAAU,MAAM,KAAK,EAAE,MAAM,GAAG,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG;AAAA,EAChE,OAAO,YAAY,KAAK,KAAK,IAAI;AAAA;AAO5B,IAAM,gBAAgB,CAAC,SAAyB;AAAA,EACrD,MAAM,UAAU,QAAQ,MAAM,GAAG;AAAA,EACjC,OAAO,YAAY,KAAK,MAAM;AAAA;AAUzB,IAAM,iBAAiB,CAAC,UAA0B;AAAA,EACvD,MAAM,UAAU,QAAQ,MAAM,KAAK,GAAG,GAAG;AAAA,EACzC,IAAI,YAAY,IAAI;AAAA,IAClB,OAAO;AAAA,EACT;AAAA,EACA,OAAO,QAAQ,WAAW,GAAG,IAAI,UAAU,IAAI;AAAA;AAQ1C,IAAM,iBAAiB,CAAC,WAC7B,OAAO,WAAW,GAAG,KAAK,CAAC,OAAO,WAAW,IAAI;AAkB5C,IAAM,eAAe,CAAC,UAAkB,UAA0B;AAAA,EACvE,IAAI,CAAC,YAAY,CAAC,eAAe,KAAK,GAAG;AAAA,IACvC,OAAO;AAAA,EACT;AAAA,EACA,IAAI,UAAU,YAAY,MAAM,WAAW,GAAG,WAAW,GAAG;AAAA,IAC1D,OAAO;AAAA,EACT;AAAA,EACA,OAAO,UAAU,MAAM,WAAW,GAAG,WAAW;AAAA;AAW3C,IAAM,uBAAuB,CAClC,YACA,UACA,UACW;AAAA,EACX,MAAM,WAAW,GAAG,aAAa;AAAA,EACjC,IACE,YACA,eAAe,KAAK,MACnB,UAAU,YAAY,MAAM,WAAW,GAAG,WAAW,IACtD;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EACA,OAAO,aAAa,YAAY,aAAa,UAAU,KAAK,CAAC;AAAA;AASxD,IAAM,gBAAgB,CAAC,UAAkB,UAA0B;AAAA,EACxE,IAAI,CAAC,UAAU;AAAA,IACb,OAAO;AAAA,EACT;AAAA,EACA,IAAI,UAAU,UAAU;AAAA,IACtB,OAAO;AAAA,EACT;AAAA,EACA,OAAO,MAAM,WAAW,GAAG,WAAW,IAClC,MAAM,MAAM,SAAS,MAAM,IAC3B;AAAA;",
+  "debugId": "208B4F87BEF51A7364756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-2aj8ddew.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/cli/command-meta.ts
+var commandMeta = {
+  add: {
+    description: "Install a source component or template from the registry.",
+    name: "add"
+  },
+  audit: {
+    description: "Audit the built site for SEO and site-health issues.",
+    name: "audit"
+  },
+  build: {
+    description: "Build the docs site for production.",
+    name: "build"
+  },
+  check: {
+    description: "Type-check the docs site with astro check.",
+    name: "check"
+  },
+  dev: {
+    description: "Start the Blume development server.",
+    name: "dev"
+  },
+  doctor: {
+    description: "Diagnose common configuration and content problems.",
+    name: "doctor"
+  },
+  eject: {
+    description: "Promote the generated runtime into an owned Astro project.",
+    name: "eject"
+  },
+  eval: {
+    description: "Test the docs: an agent answers your questions using only the documentation.",
+    name: "eval"
+  },
+  init: {
+    description: "Scaffold a minimal Blume project.",
+    name: "init"
+  },
+  "mcp-stdio": {
+    description: "Serve an MCP data snapshot over stdio (internal, used by `blume eval`).",
+    name: "mcp-stdio"
+  },
+  preview: {
+    description: "Preview the last production build.",
+    name: "preview"
+  },
+  sync: {
+    description: "Re-fetch remote content sources and regenerate the runtime.",
+    name: "sync"
+  },
+  translate: {
+    description: "Translate docs into the configured locales with a local agent CLI.",
+    name: "translate"
+  },
+  validate: {
+    description: "Validate internal, anchor, asset, and external links.",
+    name: "validate"
+  },
+  version: {
+    description: "Freeze the current docs as an archived version.",
+    name: "version"
+  }
+};
+
+export { __require, commandMeta };
+
+//# debugId=3DF60EB79641093164756E2164756E21
+//# sourceMappingURL=chunk-2aj8ddew.js.map

package/dist/cli/chunk-2aj8ddew.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/command-meta.ts"],
+  "sourcesContent": [
+    "import type { CommandMeta } from \"citty\";\n\n/**\n * Every command's `meta`, held apart from the command modules themselves.\n *\n * The CLI entry loads each command lazily (see `lazy-command.ts`), but citty\n * still reads every subcommand's `meta` to render `blume --help` and to match\n * an unknown name against aliases. Keeping that table here lets those paths\n * run without importing a single command module — `dev` alone drags in Astro,\n * `mcp-stdio` the MCP SDK. The command modules read their `meta` from this\n * table too, so the entry and the command can't drift.\n */\nexport const commandMeta = {\n  add: {\n    description: \"Install a source component or template from the registry.\",\n    name: \"add\",\n  },\n  audit: {\n    description: \"Audit the built site for SEO and site-health issues.\",\n    name: \"audit\",\n  },\n  build: {\n    description: \"Build the docs site for production.\",\n    name: \"build\",\n  },\n  check: {\n    description: \"Type-check the docs site with astro check.\",\n    name: \"check\",\n  },\n  dev: {\n    description: \"Start the Blume development server.\",\n    name: \"dev\",\n  },\n  doctor: {\n    description: \"Diagnose common configuration and content problems.\",\n    name: \"doctor\",\n  },\n  eject: {\n    description: \"Promote the generated runtime into an owned Astro project.\",\n    name: \"eject\",\n  },\n  eval: {\n    description:\n      \"Test the docs: an agent answers your questions using only the documentation.\",\n    name: \"eval\",\n  },\n  init: {\n    description: \"Scaffold a minimal Blume project.\",\n    name: \"init\",\n  },\n  \"mcp-stdio\": {\n    description:\n      \"Serve an MCP data snapshot over stdio (internal, used by `blume eval`).\",\n    name: \"mcp-stdio\",\n  },\n  preview: {\n    description: \"Preview the last production build.\",\n    name: \"preview\",\n  },\n  sync: {\n    description: \"Re-fetch remote content sources and regenerate the runtime.\",\n    name: \"sync\",\n  },\n  translate: {\n    description:\n      \"Translate docs into the configured locales with a local agent CLI.\",\n    name: \"translate\",\n  },\n  validate: {\n    description: \"Validate internal, anchor, asset, and external links.\",\n    name: \"validate\",\n  },\n  version: {\n    description: \"Freeze the current docs as an archived version.\",\n    name: \"version\",\n  },\n} satisfies Record<string, CommandMeta>;\n"
+  ],
+  "mappings": ";;;;;AAYO,IAAM,cAAc;AAAA,EACzB,KAAK;AAAA,IACH,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,OAAO;AAAA,IACL,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,OAAO;AAAA,IACL,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,OAAO;AAAA,IACL,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,KAAK;AAAA,IACH,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,QAAQ;AAAA,IACN,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,OAAO;AAAA,IACL,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,MAAM;AAAA,IACJ,aACE;AAAA,IACF,MAAM;AAAA,EACR;AAAA,EACA,MAAM;AAAA,IACJ,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,aAAa;AAAA,IACX,aACE;AAAA,IACF,MAAM;AAAA,EACR;AAAA,EACA,SAAS;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,MAAM;AAAA,IACJ,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,WAAW;AAAA,IACT,aACE;AAAA,IACF,MAAM;AAAA,EACR;AAAA,EACA,UAAU;AAAA,IACR,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,SAAS;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AACF;",
+  "debugId": "3DF60EB79641093164756E2164756E21",
+  "names": []
+}