blume 1.6.5 → 1.7.0

package/dist/cli/chunk-jxkxjsc1.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import {
+  commandsFor,
+  detectProjectPackageManager,
+  eject,
+  updatePackageScripts
+} from "./chunk-s5dsk8bj.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/eject.ts
+import { defineCommand } from "citty";
+import { relative } from "pathe";
+var ejectCommand = defineCommand({
+  args: {
+    yes: { description: "Skip the confirmation prompt.", type: "boolean" }
+  },
+  meta: commandMeta.eject,
+  async run({ args }) {
+    const root = process.cwd();
+    refuseIfDevRunning(root, "ejecting");
+    if (!args.yes) {
+      logger.warn("Eject is one-way: it writes astro.config.mjs, src/, and (if absent) tsconfig.json, rewrites your package.json scripts, and removes .blume. An existing tsconfig.json is left untouched.");
+      logger.info("Re-run with --yes to proceed.");
+      return;
+    }
+    const { files, warnings } = await eject(root);
+    await updatePackageScripts(root);
+    for (const warning of warnings) {
+      logger.warn(warning);
+    }
+    logger.success(`Ejected ${files.length} file(s):`);
+    for (const file of files) {
+      process.stdout.write(`  ${relative(root, file)}
+`);
+    }
+    const pm = await detectProjectPackageManager(root);
+    const { build, dev } = commandsFor(pm);
+    logger.box(`Your project is now a standalone Astro app.
+
+  ${dev}
+  ${build}
+
+The blume package remains importable.`);
+  }
+});
+export {
+  ejectCommand
+};
+
+//# debugId=7089C2D59766320964756E2164756E21
+//# sourceMappingURL=chunk-jxkxjsc1.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/eject.ts"],
+  "sourcesContent": [
+    "import { defineCommand } from \"citty\";\nimport { relative } from \"pathe\";\n\nimport { eject } from \"../../registry/eject.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { refuseIfDevRunning } from \"../dev-lock.ts\";\nimport { updatePackageScripts } from \"../eject-scripts.ts\";\nimport { commandsFor, detectProjectPackageManager } from \"../init/scaffold.ts\";\nimport { logger } from \"../log.ts\";\n\nexport const ejectCommand = defineCommand({\n  args: {\n    yes: { description: \"Skip the confirmation prompt.\", type: \"boolean\" },\n  },\n  meta: commandMeta.eject,\n  async run({ args }) {\n    const root = process.cwd();\n    refuseIfDevRunning(root, \"ejecting\");\n\n    if (!args.yes) {\n      logger.warn(\n        \"Eject is one-way: it writes astro.config.mjs, src/, and (if absent) tsconfig.json, rewrites your package.json scripts, and removes .blume. An existing tsconfig.json is left untouched.\"\n      );\n      logger.info(\"Re-run with --yes to proceed.\");\n      return;\n    }\n\n    const { files, warnings } = await eject(root);\n    await updatePackageScripts(root);\n\n    // The same surface as the generated-runtime path (prepare.ts): one warn\n    // per generation warning, e.g. a Scalar reference spec that wasn't found.\n    for (const warning of warnings) {\n      logger.warn(warning);\n    }\n\n    logger.success(`Ejected ${files.length} file(s):`);\n    for (const file of files) {\n      process.stdout.write(`  ${relative(root, file)}\\n`);\n    }\n    // Print run commands matching the project's package manager (lockfile\n    // detection, since eject runs inside an existing project).\n    const pm = await detectProjectPackageManager(root);\n    const { build, dev } = commandsFor(pm);\n    logger.box(\n      `Your project is now a standalone Astro app.\\n\\n  ${dev}\\n  ${build}\\n\\nThe blume package remains importable.`\n    );\n  },\n});\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AACA;AASO,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,KAAK,EAAE,aAAa,iCAAiC,MAAM,UAAU;AAAA,EACvE;AAAA,EACA,MAAM,YAAY;AAAA,OACZ,IAAG,GAAG,QAAQ;AAAA,IAClB,MAAM,OAAO,QAAQ,IAAI;AAAA,IACzB,mBAAmB,MAAM,UAAU;AAAA,IAEnC,IAAI,CAAC,KAAK,KAAK;AAAA,MACb,OAAO,KACL,yLACF;AAAA,MACA,OAAO,KAAK,+BAA+B;AAAA,MAC3C;AAAA,IACF;AAAA,IAEA,QAAQ,OAAO,aAAa,MAAM,MAAM,IAAI;AAAA,IAC5C,MAAM,qBAAqB,IAAI;AAAA,IAI/B,WAAW,WAAW,UAAU;AAAA,MAC9B,OAAO,KAAK,OAAO;AAAA,IACrB;AAAA,IAEA,OAAO,QAAQ,WAAW,MAAM,iBAAiB;AAAA,IACjD,WAAW,QAAQ,OAAO;AAAA,MACxB,QAAQ,OAAO,MAAM,KAAK,SAAS,MAAM,IAAI;AAAA,CAAK;AAAA,IACpD;AAAA,IAGA,MAAM,KAAK,MAAM,4BAA4B,IAAI;AAAA,IACjD,QAAQ,OAAO,QAAQ,YAAY,EAAE;AAAA,IACrC,OAAO,IACL;AAAA;AAAA,IAAoD;AAAA,IAAU;AAAA;AAAA,sCAChE;AAAA;AAEJ,CAAC;",
+  "debugId": "7089C2D59766320964756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-kwx90v78.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+import {
+  prepareProject
+} from "./chunk-0qhq7b8q.js";
+import"./chunk-n0nyat6g.js";
+import"./chunk-btfr9yvw.js";
+import {
+  readDevLock
+} 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 {
+  loadConfig,
+  resolveProjectContext,
+  resolveRuntimeDir
+} from "./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/sync.ts
+import { rm } from "node:fs/promises";
+import { defineCommand } from "citty";
+import { join } from "pathe";
+var syncCommand = defineCommand({
+  args: {
+    force: {
+      description: "Clear the source cache before refetching.",
+      type: "boolean"
+    },
+    preview: {
+      description: "Include drafts and unpublished CMS content.",
+      type: "boolean"
+    },
+    strict: { description: "Fail on diagnostics.", type: "boolean" }
+  },
+  meta: commandMeta.sync,
+  async run({ args }) {
+    const root = process.cwd();
+    if (args.force) {
+      const { config } = await loadConfig(root);
+      const context = resolveProjectContext(root, config);
+      await rm(join(context.outDir, "cache"), { force: true, recursive: true });
+      logger.info("Cleared source cache.");
+    }
+    const lock = readDevLock(resolveRuntimeDir(root));
+    const devServerUrl = lock?.port ? `http://localhost:${lock.port}` : undefined;
+    await prepareProject({
+      devServerUrl,
+      mode: "dev",
+      preview: args.preview,
+      refresh: true,
+      root,
+      strict: args.strict
+    });
+    logger.success("Synced content sources.");
+  }
+});
+export {
+  syncCommand
+};
+
+//# debugId=CD2123C1322DDD3C64756E2164756E21
+//# sourceMappingURL=chunk-kwx90v78.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/sync.ts"],
+  "sourcesContent": [
+    "import { rm } from \"node:fs/promises\";\n\nimport { defineCommand } from \"citty\";\nimport { join } from \"pathe\";\n\nimport { loadConfig } from \"../../core/config.ts\";\nimport {\n  resolveProjectContext,\n  resolveRuntimeDir,\n} from \"../../core/project.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { readDevLock } from \"../dev-lock.ts\";\nimport { logger } from \"../log.ts\";\nimport { prepareProject } from \"../prepare.ts\";\n\nexport const syncCommand = defineCommand({\n  args: {\n    force: {\n      description: \"Clear the source cache before refetching.\",\n      type: \"boolean\",\n    },\n    preview: {\n      description: \"Include drafts and unpublished CMS content.\",\n      type: \"boolean\",\n    },\n    strict: { description: \"Fail on diagnostics.\", type: \"boolean\" },\n  },\n  meta: commandMeta.sync,\n  async run({ args }) {\n    const root = process.cwd();\n\n    // `--force` drops the snapshots so a stale or corrupt cache can't be served;\n    // scoped to `.blume/cache`, so a running dev server's runtime is untouched.\n    if (args.force) {\n      const { config } = await loadConfig(root);\n      const context = resolveProjectContext(root, config);\n      await rm(join(context.outDir, \"cache\"), { force: true, recursive: true });\n      logger.info(\"Cleared source cache.\");\n    }\n\n    // Dev mode keeps drafts and skips the static-build gate; `refresh` forces\n    // remote sources to re-fetch rather than serve their cached snapshot. A\n    // running dev server hot-reloads from the regenerated runtime — so when one\n    // is live, regenerate with the same site fallback (its URL) it used, else\n    // its astro.config loses `site` (dropping OG and canonicals) and Astro\n    // restarts cold.\n    const lock = readDevLock(resolveRuntimeDir(root));\n    const devServerUrl = lock?.port\n      ? `http://localhost:${lock.port}`\n      : undefined;\n    await prepareProject({\n      devServerUrl,\n      mode: \"dev\",\n      preview: args.preview,\n      refresh: true,\n      root,\n      strict: args.strict,\n    });\n\n    logger.success(\"Synced content sources.\");\n  },\n});\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAEA;AACA;AAYO,IAAM,cAAc,cAAc;AAAA,EACvC,MAAM;AAAA,IACJ,OAAO;AAAA,MACL,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,IACA,SAAS;AAAA,MACP,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,IACA,QAAQ,EAAE,aAAa,wBAAwB,MAAM,UAAU;AAAA,EACjE;AAAA,EACA,MAAM,YAAY;AAAA,OACZ,IAAG,GAAG,QAAQ;AAAA,IAClB,MAAM,OAAO,QAAQ,IAAI;AAAA,IAIzB,IAAI,KAAK,OAAO;AAAA,MACd,QAAQ,WAAW,MAAM,WAAW,IAAI;AAAA,MACxC,MAAM,UAAU,sBAAsB,MAAM,MAAM;AAAA,MAClD,MAAM,GAAG,KAAK,QAAQ,QAAQ,OAAO,GAAG,EAAE,OAAO,MAAM,WAAW,KAAK,CAAC;AAAA,MACxE,OAAO,KAAK,uBAAuB;AAAA,IACrC;AAAA,IAQA,MAAM,OAAO,YAAY,kBAAkB,IAAI,CAAC;AAAA,IAChD,MAAM,eAAe,MAAM,OACvB,oBAAoB,KAAK,SACzB;AAAA,IACJ,MAAM,eAAe;AAAA,MACnB;AAAA,MACA,MAAM;AAAA,MACN,SAAS,KAAK;AAAA,MACd,SAAS;AAAA,MACT;AAAA,MACA,QAAQ,KAAK;AAAA,IACf,CAAC;AAAA,IAED,OAAO,QAAQ,yBAAyB;AAAA;AAE5C,CAAC;",
+  "debugId": "CD2123C1322DDD3C64756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-n0nyat6g.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import {
+  searchProviderMeta
+} from "./chunk-wd27zjcz.js";
+import {
+  needsPlaygroundProxy
+} from "./chunk-xv91q4nm.js";
+
+// src/core/server-features.ts
+var serverFeatures = (config) => {
+  const features = [];
+  if (config.ai.ask?.enabled && !config.ai.ask.endpoint) {
+    features.push("Ask AI");
+  }
+  if (config.ai.mcp.enabled) {
+    features.push("MCP server");
+  }
+  if (needsPlaygroundProxy(config)) {
+    features.push("API playground proxy");
+  }
+  if (searchProviderMeta(config.search.provider).requiresServer) {
+    features.push(`Search (${config.search.provider})`);
+  }
+  return features;
+};
+
+export { serverFeatures };
+
+//# debugId=0DFA9D31AEDBECCC64756E2164756E21
+//# sourceMappingURL=chunk-n0nyat6g.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/core/server-features.ts"],
+  "sourcesContent": [
+    "import { needsPlaygroundProxy } from \"../openapi/references.ts\";\nimport { searchProviderMeta } from \"../search/providers.ts\";\nimport type { ResolvedConfig } from \"./schema.ts\";\n\n/**\n * List the enabled features that require Astro server output. Static builds\n * fail clearly when any of these are enabled.\n */\nexport const serverFeatures = (config: ResolvedConfig): string[] => {\n  const features: string[] = [];\n  if (config.ai.ask?.enabled && !config.ai.ask.endpoint) {\n    features.push(\"Ask AI\");\n  }\n  // The hosted MCP server is a live JSON-RPC endpoint, so it needs a runtime.\n  if (config.ai.mcp.enabled) {\n    features.push(\"MCP server\");\n  }\n  // The built-in playground proxy (`playground.proxy: true` on the OpenAPI or\n  // GraphQL block) is a live fetch endpoint at `/_api-proxy`; an external\n  // proxy URL (string) or a proxy-less playground stays fully static.\n  if (needsPlaygroundProxy(config)) {\n    features.push(\"API playground proxy\");\n  }\n  // Mixedbread (and any future provider) that proxies queries through a secret\n  // server endpoint can't run on a static build.\n  if (searchProviderMeta(config.search.provider).requiresServer) {\n    features.push(`Search (${config.search.provider})`);\n  }\n  return features;\n};\n"
+  ],
+  "mappings": ";;;;;;;;;AAQO,IAAM,iBAAiB,CAAC,WAAqC;AAAA,EAClE,MAAM,WAAqB,CAAC;AAAA,EAC5B,IAAI,OAAO,GAAG,KAAK,WAAW,CAAC,OAAO,GAAG,IAAI,UAAU;AAAA,IACrD,SAAS,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,IAAI,OAAO,GAAG,IAAI,SAAS;AAAA,IACzB,SAAS,KAAK,YAAY;AAAA,EAC5B;AAAA,EAIA,IAAI,qBAAqB,MAAM,GAAG;AAAA,IAChC,SAAS,KAAK,sBAAsB;AAAA,EACtC;AAAA,EAGA,IAAI,mBAAmB,OAAO,OAAO,QAAQ,EAAE,gBAAgB;AAAA,IAC7D,SAAS,KAAK,WAAW,OAAO,OAAO,WAAW;AAAA,EACpD;AAAA,EACA,OAAO;AAAA;",
+  "debugId": "0DFA9D31AEDBECCC64756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-pxj10x8y.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+// src/ai/mcp/tools.ts
+var READ_ONLY = { openWorldHint: false, readOnlyHint: true };
+var MCP_TOOLS = [
+  {
+    annotations: READ_ONLY,
+    description: 'Full-text search across the documentation. Returns matching pages with their title, route, content type, and a short excerpt; pass `contentTypes` to search only pages of certain types (e.g. `rfc`, `changelog`), `filters` to require facet values the site declares per type (e.g. `{"status": "enforced"}`), and `locale` to search one language. On a versioned site results default to the current docs — pass `version` to search an archived version (e.g. `"v1.0"`) or `"all"` for every version. Use this first to discover relevant pages, then `get_page` to read one in full.',
+    name: "search_docs",
+    title: "Search documentation"
+  },
+  {
+    annotations: READ_ONLY,
+    description: "Fetch a single documentation page as agent-optimized Markdown (frontmatter included, components downleveled to plain Markdown). Pass a route from `search_docs` or `list_pages`, e.g. `/guides/install`.",
+    name: "get_page",
+    title: "Get page Markdown"
+  },
+  {
+    annotations: READ_ONLY,
+    description: 'List every documentation page with its route, title, description, content type, and any declared facet values; pass `contentTypes`, `filters`, and/or `locale` to narrow the list. On a versioned site the list defaults to the current docs — pass `version` for an archived version or `"all"`. Useful for enumerating the docs, discovering the types and facets in use, or finding a page when search is too narrow.',
+    name: "list_pages",
+    title: "List pages"
+  },
+  {
+    annotations: READ_ONLY,
+    description: "Return the documentation navigation tree (header tabs and the sidebar hierarchy), reflecting how the docs are organized for readers. Pass `locale` for a language's tree and, on a versioned site, `version` for an archived snapshot's tree.",
+    name: "get_navigation",
+    title: "Get navigation"
+  }
+];
+
+export { MCP_TOOLS };
+
+//# debugId=56B52393DC55784564756E2164756E21
+//# sourceMappingURL=chunk-pxj10x8y.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/ai/mcp/tools.ts"],
+  "sourcesContent": [
+    "/**\n * Static metadata for the MCP tools Blume exposes. Shared by the server (which\n * pairs each entry with a Zod input schema and handler) and the `.well-known`\n * discovery documents, so tool names and descriptions never drift between the\n * live server and its advertised capabilities.\n */\n\n/** A read-only, non-mutating tool hint set (every Blume tool is read-only). */\nconst READ_ONLY = { openWorldHint: false, readOnlyHint: true } as const;\n\nexport interface McpToolMeta {\n  annotations: { openWorldHint: boolean; readOnlyHint: boolean };\n  description: string;\n  name: string;\n  title: string;\n}\n\nexport const MCP_TOOLS: McpToolMeta[] = [\n  {\n    annotations: READ_ONLY,\n    description:\n      'Full-text search across the documentation. Returns matching pages with their title, route, content type, and a short excerpt; pass `contentTypes` to search only pages of certain types (e.g. `rfc`, `changelog`), `filters` to require facet values the site declares per type (e.g. `{\"status\": \"enforced\"}`), and `locale` to search one language. On a versioned site results default to the current docs — pass `version` to search an archived version (e.g. `\"v1.0\"`) or `\"all\"` for every version. Use this first to discover relevant pages, then `get_page` to read one in full.',\n    name: \"search_docs\",\n    title: \"Search documentation\",\n  },\n  {\n    annotations: READ_ONLY,\n    description:\n      \"Fetch a single documentation page as agent-optimized Markdown (frontmatter included, components downleveled to plain Markdown). Pass a route from `search_docs` or `list_pages`, e.g. `/guides/install`.\",\n    name: \"get_page\",\n    title: \"Get page Markdown\",\n  },\n  {\n    annotations: READ_ONLY,\n    description:\n      'List every documentation page with its route, title, description, content type, and any declared facet values; pass `contentTypes`, `filters`, and/or `locale` to narrow the list. On a versioned site the list defaults to the current docs — pass `version` for an archived version or `\"all\"`. Useful for enumerating the docs, discovering the types and facets in use, or finding a page when search is too narrow.',\n    name: \"list_pages\",\n    title: \"List pages\",\n  },\n  {\n    annotations: READ_ONLY,\n    description:\n      \"Return the documentation navigation tree (header tabs and the sidebar hierarchy), reflecting how the docs are organized for readers. Pass `locale` for a language's tree and, on a versioned site, `version` for an archived snapshot's tree.\",\n    name: \"get_navigation\",\n    title: \"Get navigation\",\n  },\n];\n"
+  ],
+  "mappings": ";;;AAQA,IAAM,YAAY,EAAE,eAAe,OAAO,cAAc,KAAK;AAStD,IAAM,YAA2B;AAAA,EACtC;AAAA,IACE,aAAa;AAAA,IACb,aACE;AAAA,IACF,MAAM;AAAA,IACN,OAAO;AAAA,EACT;AAAA,EACA;AAAA,IACE,aAAa;AAAA,IACb,aACE;AAAA,IACF,MAAM;AAAA,IACN,OAAO;AAAA,EACT;AAAA,EACA;AAAA,IACE,aAAa;AAAA,IACb,aACE;AAAA,IACF,MAAM;AAAA,IACN,OAAO;AAAA,EACT;AAAA,EACA;AAAA,IACE,aAAa;AAAA,IACb,aACE;AAAA,IACF,MAAM;AAAA,IACN,OAAO;AAAA,EACT;AACF;",
+  "debugId": "56B52393DC55784564756E2164756E21",
+  "names": []
+}