blume 1.7.3 → 2.0.0

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/preview.ts"],
+  "sourcesContent": [
+    "import { existsSync } from \"node:fs\";\n\nimport { preview } from \"astro\";\nimport { defineCommand } from \"citty\";\nimport { join } from \"pathe\";\n\nimport { loadConfig } from \"../../core/config.ts\";\nimport { resolveProjectContext } from \"../../core/project.ts\";\nimport { deployOutputDir } from \"../../deploy/adapter-output.ts\";\nimport { parsePort } from \"../args.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { normalizeHost } from \"../host-args.ts\";\nimport { logger } from \"../log.ts\";\n\nexport const previewCommand = defineCommand({\n  args: {\n    host: { description: \"Network host to bind.\", type: \"string\" },\n    port: { description: \"Port to listen on.\", type: \"string\" },\n  },\n  meta: commandMeta.preview,\n  async run({ args }) {\n    const root = process.cwd();\n    const { config } = await loadConfig(root);\n    const context = resolveProjectContext(root, config);\n\n    // `blume dev` writes `.blume/astro.config.mjs` too, so the runtime alone\n    // doesn't mean there's anything to serve: the build output must exist.\n    if (\n      !existsSync(join(context.outDir, \"astro.config.mjs\")) ||\n      !existsSync(deployOutputDir(config, context))\n    ) {\n      logger.error(\"No build found. Run `blume build` first.\");\n      process.exit(1);\n    }\n\n    await preview({\n      logLevel: \"info\",\n      root: context.outDir,\n      server: {\n        // `normalizeHost` maps a bare `--host` (citty parses it as \"\") to\n        // `true` so Vite binds all interfaces instead of the hostname \"\".\n        host: normalizeHost(args.host),\n        port: parsePort(args.port),\n      },\n    });\n  },\n});\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAEA;AACA;AACA;AAUO,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM,EAAE,aAAa,yBAAyB,MAAM,SAAS;AAAA,IAC7D,MAAM,EAAE,aAAa,sBAAsB,MAAM,SAAS;AAAA,EAC5D;AAAA,EACA,MAAM,YAAY;AAAA,OACZ,IAAG,GAAG,QAAQ;AAAA,IAClB,MAAM,OAAO,QAAQ,IAAI;AAAA,IACzB,QAAQ,WAAW,MAAM,WAAW,IAAI;AAAA,IACxC,MAAM,UAAU,sBAAsB,MAAM,MAAM;AAAA,IAIlD,IACE,CAAC,WAAW,KAAK,QAAQ,QAAQ,kBAAkB,CAAC,KACpD,CAAC,WAAW,gBAAgB,QAAQ,OAAO,CAAC,GAC5C;AAAA,MACA,OAAO,MAAM,0CAA0C;AAAA,MACvD,QAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,IAEA,MAAM,QAAQ;AAAA,MACZ,UAAU;AAAA,MACV,MAAM,QAAQ;AAAA,MACd,QAAQ;AAAA,QAGN,MAAM,cAAc,KAAK,IAAI;AAAA,QAC7B,MAAM,UAAU,KAAK,IAAI;AAAA,MAC3B;AAAA,IACF,CAAC;AAAA;AAEL,CAAC;",
+  "debugId": "7FC21538FC698FBD64756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-beat36xx.js

@@ -0,0 +1,279 @@
+#!/usr/bin/env node
+import {
+  BlumeError,
+  locateFrontmatterKey
+} from "./index.js";
+import {
+  ComponentOverridesError,
+  analyzeComponentOverrides
+} from "./chunk-f2972sbt.js";
+import {
+  frontmatter_default,
+  DEFAULT_CONTENT_INCLUDE,
+  DEFAULT_CONTENT_EXCLUDE,
+  pageMetaSchema,
+  createModuleLoader,
+  findConfigFile,
+  findComponentsFile,
+  ConfigValidationError,
+  loadConfig
+} from "./chunk-xaz13gwg.js";
+import {
+  baselineScanIgnore
+} from "./chunk-abh8yjkn.js";
+
+// src/upgrade/upgrade.ts
+import { existsSync } from "node:fs";
+import { readFile, writeFile } from "node:fs/promises";
+import { join, relative, resolve } from "pathe";
+import { glob } from "tinyglobby";
+import { z } from "zod";
+var UPGRADE_GUIDE_URL = "https://useblume.dev/docs/upgrading";
+var UPGRADE_GUIDE_FILE = join("docs", "03-upgrading.mdx");
+var DEPENDENCY_FIELDS = [
+  "dependencies",
+  "devDependencies"
+];
+var RANGE_MAJOR = /^[\s<=>^~v]*(?<major>\d+)/u;
+var rangeMajor = (range) => {
+  const major = RANGE_MAJOR.exec(range)?.groups?.major;
+  return major === undefined ? null : Number(major);
+};
+var INDENT = /^(?<indent>[ \t]+)"/mu;
+var REGEXP_SPECIAL = /[$()*+.?[\\\]^{|}]/gu;
+var escapeRegExp = (value) => value.replaceAll(REGEXP_SPECIAL, String.raw`\$&`);
+var replaceRange = (text, field, from, to) => {
+  const value = JSON.stringify(from);
+  const entry = new RegExp(`"blume"\\s*:\\s*${escapeRegExp(value)}`, "gu");
+  entry.lastIndex = Math.max(text.indexOf(JSON.stringify(field)), 0);
+  const match = entry.exec(text);
+  if (!match) {
+    return null;
+  }
+  const end = match.index + match[0].length;
+  return `${text.slice(0, end - value.length)}${JSON.stringify(to)}${text.slice(end)}`;
+};
+var bumpBlumeDependency = async (root, version) => {
+  const path = join(root, "package.json");
+  if (!existsSync(path)) {
+    return { status: "missing" };
+  }
+  const text = await readFile(path, "utf-8");
+  const pkg = JSON.parse(text);
+  const field = DEPENDENCY_FIELDS.find((name) => pkg[name]?.blume !== undefined);
+  const from = field ? pkg[field]?.blume : undefined;
+  if (!(field && from)) {
+    return { status: "missing" };
+  }
+  const current = rangeMajor(from);
+  const target = rangeMajor(version);
+  if (current === null || target === null || current >= target) {
+    return { range: from, status: "current" };
+  }
+  const to = `^${version}`;
+  const indent = INDENT.exec(text)?.groups?.indent ?? "  ";
+  const updated = { ...pkg, [field]: { ...pkg[field], blume: to } };
+  await writeFile(path, replaceRange(text, field, from, to) ?? `${JSON.stringify(updated, null, indent)}
+`);
+  return { field, from, status: "bumped", to };
+};
+var isOutsideBlumeProject = (root, bump) => bump.status === "missing" && findConfigFile(root) === null;
+var REMOVED_BUILD_FLAG = /^--(?<flag>adapter|base|output)(?:=|$)/u;
+var removedBuildFlags = (args) => [
+  ...new Set(args.flatMap((arg) => {
+    const flag = REMOVED_BUILD_FLAG.exec(arg)?.groups?.flag;
+    return flag ? [flag] : [];
+  }))
+];
+var flagList = (flags) => flags.map((flag) => `--${flag}`).join(", ");
+var removedBuildFlagsAdvice = (flags) => {
+  const advice = [];
+  if (flags.includes("adapter") || flags.includes("output")) {
+    advice.push('name the host in blume.config.ts with `deployment: vercel()` (or `netlify()`, `cloudflare()`, `node()`) from "blume/deploy" — a host adapter builds for the server, and `output: "static"` keeps it static');
+  }
+  if (flags.includes("base")) {
+    advice.push('set the subpath with `deployment: { base: "/docs" }`, or the host adapter\'s `base` option');
+  }
+  return `Drop ${flagList(flags)} and ${advice.join("; ")}.`;
+};
+var BLUME_BIN = /(?:^|[/\\])blume(?:@\S+)?$/u;
+var COMMAND_SEPARATOR = /&&|\|\||[;|]/u;
+var WHITESPACE = /\s+/u;
+var buildArgs = (script) => script.split(COMMAND_SEPARATOR).flatMap((command) => {
+  const words = command.trim().split(WHITESPACE);
+  const at = words.findIndex((word, index) => BLUME_BIN.test(word) && words[index + 1] === "build");
+  return at === -1 ? [] : words.slice(at + 2);
+});
+var scriptsSchema = z.looseObject({
+  scripts: z.record(z.string(), z.string()).default({})
+});
+var lineOf = (text, index) => text.slice(0, index).split(`
+`).length;
+var scriptFindings = async (root) => {
+  const path = join(root, "package.json");
+  if (!existsSync(path)) {
+    return [];
+  }
+  const text = await readFile(path, "utf-8");
+  const pkg = scriptsSchema.safeParse(JSON.parse(text));
+  const scripts = pkg.success ? pkg.data.scripts : {};
+  const scriptsAt = text.indexOf('"scripts"');
+  return Object.entries(scripts).flatMap(([name, script]) => {
+    const flags = removedBuildFlags(buildArgs(script));
+    if (flags.length === 0) {
+      return [];
+    }
+    const at = text.indexOf(JSON.stringify(name), scriptsAt);
+    return [
+      {
+        code: "BLUME_BUILD_FLAG_REMOVED",
+        file: path,
+        line: at === -1 ? undefined : lineOf(text, at),
+        message: `The "${name}" script passes ${flagList(flags)} to \`blume build\`, which Blume 2 removed.`,
+        severity: "error",
+        suggestion: removedBuildFlagsAdvice(flags)
+      }
+    ];
+  });
+};
+var globFields = {
+  exclude: z.array(z.string()).optional(),
+  include: z.array(z.string()).optional(),
+  root: z.string().optional()
+};
+var rawFilesystemSourceSchema = z.union([
+  z.looseObject({
+    kind: z.literal("filesystem"),
+    options: z.looseObject(globFields).default({})
+  }).transform((source) => source.options),
+  z.looseObject({ type: z.literal("filesystem"), ...globFields })
+]);
+var rawContentSchema = z.looseObject({
+  content: z.looseObject({ ...globFields, sources: z.array(z.unknown()).optional() }).optional()
+});
+var contentGlobs = ({
+  content
+}) => {
+  const sources = (content?.sources ?? []).flatMap((source) => {
+    const filesystem = rawFilesystemSourceSchema.safeParse(source);
+    return filesystem.success ? [filesystem.data] : [];
+  });
+  return (sources.length > 0 ? sources : [content ?? {}]).map((globs) => ({
+    exclude: globs.exclude ?? DEFAULT_CONTENT_EXCLUDE,
+    include: globs.include ?? DEFAULT_CONTENT_INCLUDE,
+    root: globs.root ?? "docs"
+  }));
+};
+var configContentGlobs = async (root) => {
+  const file = findConfigFile(root);
+  let raw = {};
+  if (file) {
+    try {
+      const parsed = rawContentSchema.safeParse(await createModuleLoader()(file));
+      raw = parsed.success ? parsed.data : {};
+    } catch {}
+  }
+  return contentGlobs(raw);
+};
+var isPathKey = (segment) => typeof segment !== "symbol";
+var PLAIN_UNKNOWN_KEY = "Unrecognized key";
+var removedFieldFindings = (file, text, issues) => issues.flatMap((issue) => {
+  if (issue.code !== "unrecognized_keys" || issue.message.startsWith(PLAIN_UNKNOWN_KEY)) {
+    return [];
+  }
+  const path = issue.path.filter(isPathKey);
+  const position = locateFrontmatterKey(text, [...path, ...issue.keys.slice(0, 1)]) ?? locateFrontmatterKey(text, path);
+  return [
+    {
+      code: "BLUME_FRONTMATTER_INVALID",
+      column: position?.column,
+      file,
+      line: position?.line,
+      message: issue.message,
+      severity: "error"
+    }
+  ];
+});
+var pageFindings = async (file) => {
+  const text = await readFile(file, "utf-8");
+  let parsed;
+  try {
+    parsed = pageMetaSchema.safeParse(frontmatter_default(text).data);
+  } catch {
+    return [];
+  }
+  return parsed.success ? [] : removedFieldFindings(file, text, parsed.error.issues);
+};
+var frontmatterFindings = async (root) => {
+  const roots = await configContentGlobs(root);
+  const matches = await Promise.all(roots.map((globs) => {
+    const cwd = resolve(root, globs.root);
+    return existsSync(cwd) ? glob(globs.include, {
+      absolute: true,
+      cwd,
+      ignore: [...globs.exclude, ...baselineScanIgnore()],
+      onlyFiles: true
+    }) : [];
+  }));
+  const files = [...new Set(matches.flat())].toSorted();
+  const findings = await Promise.all(files.map(pageFindings));
+  return findings.flat();
+};
+var findingsOf = async (check) => {
+  try {
+    await check();
+    return [];
+  } catch (error) {
+    if (error instanceof ConfigValidationError || error instanceof ComponentOverridesError) {
+      return error.issues;
+    }
+    if (error instanceof BlumeError) {
+      return [error.diagnostic];
+    }
+    throw error;
+  }
+};
+var collectUpgradeFindings = async (root) => {
+  const componentsFile = findComponentsFile(root);
+  return [
+    ...await findingsOf(async () => {
+      await loadConfig(root);
+    }),
+    ...componentsFile ? await findingsOf(async () => {
+      analyzeComponentOverrides(await readFile(componentsFile, "utf-8"), componentsFile);
+    }) : [],
+    ...await frontmatterFindings(root),
+    ...await scriptFindings(root)
+  ];
+};
+var plainFinding = (finding, root) => {
+  const where = finding.file ? `${relative(root, finding.file)}${finding.line === undefined ? "" : `:${finding.line}`}` : "blume.config.ts";
+  const fix = finding.suggestion ? `
+  Fix: ${finding.suggestion}` : "";
+  return `- ${where} (${finding.code})
+  ${finding.message.replaceAll(`
+`, `
+  `)}${fix}`;
+};
+var upgradePrompt = (options) => `Upgrade this Blume project to Blume ${options.version}. \`blume upgrade\` has bumped the \`blume\` dependency in package.json where it could; what's left is the config.
+
+The upgrade guide is at ${options.guidePath} (online at ${UPGRADE_GUIDE_URL}). It covers every change between Blume 1 and 2 with before-and-after examples: search, deployment, content sources, API references, analytics, and Ask AI become adapters imported from \`blume/*\` subpaths; the machine-readable settings move from \`ai\` to \`agents\`; and \`components.ts\` entries must be one of the static forms.
+
+\`blume upgrade\` found:
+
+${options.findings.map((finding) => plainFinding(finding, options.root)).join(`
+
+`)}
+
+Work through every finding:
+1. Read the guide section for each change before editing.
+2. Rewrite the config to the Blume 2 form, adding the adapter imports it needs. Keep the site's behavior the same: the same content, routes, search backend, deployment target, analytics, and credentials (keep reading secrets from the same environment variables).
+3. The config loader reports every invalid field at once, but some changes only surface once earlier ones are fixed, so rerun \`${options.runner} blume doctor\` after each round of edits.
+4. Never delete content, or remove a setting only to silence an error; if something needs a human decision, leave it and say so in your summary.
+
+When \`${options.runner} blume doctor\` reports no errors, run \`${options.runner} blume build\` and fix anything it reports until it succeeds.`;
+
+export { UPGRADE_GUIDE_URL, UPGRADE_GUIDE_FILE, bumpBlumeDependency, isOutsideBlumeProject, removedBuildFlags, flagList, removedBuildFlagsAdvice, collectUpgradeFindings, upgradePrompt };
+
+//# debugId=BBD151C21AC6C49164756E2164756E21
+//# sourceMappingURL=chunk-beat36xx.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/upgrade/upgrade.ts"],
+  "sourcesContent": [
+    "import { existsSync } from \"node:fs\";\nimport { readFile, writeFile } from \"node:fs/promises\";\n\nimport { join, relative, resolve } from \"pathe\";\nimport { glob } from \"tinyglobby\";\nimport { z } from \"zod\";\n\nimport {\n  analyzeComponentOverrides,\n  ComponentOverridesError,\n} from \"../core/component-overrides.ts\";\nimport { ConfigValidationError, loadConfig } from \"../core/config.ts\";\nimport { BlumeError, locateFrontmatterKey } from \"../core/diagnostics.ts\";\nimport matter from \"../core/frontmatter.ts\";\nimport { createModuleLoader } from \"../core/load-module.ts\";\nimport { findComponentsFile, findConfigFile } from \"../core/project.ts\";\nimport { pageMetaSchema } from \"../core/schema.ts\";\nimport { baselineScanIgnore } from \"../core/sources/watch.ts\";\nimport type { Diagnostic } from \"../core/types.ts\";\nimport {\n  DEFAULT_CONTENT_EXCLUDE,\n  DEFAULT_CONTENT_INCLUDE,\n} from \"../sources/filesystem.ts\";\n\n/**\n * `blume upgrade`'s logic, kept out of the command module so it runs (and is\n * covered) in-process: bump the `blume` dependency to the running CLI's major,\n * then check the project against it — the config through the same loader\n * every command uses, which names each removed or renamed field and its\n * replacement, `components.ts` through the same static planner the build\n * runs, and each page's front matter for fields the schema removed. The\n * command prints the findings or hands them to a coding agent.\n */\n\n/** The upgrade guide's route on the Blume docs site. */\nexport const UPGRADE_GUIDE_URL = \"https://useblume.dev/docs/upgrading\";\n\n/** The upgrade guide's file inside the published package's bundled docs. */\nexport const UPGRADE_GUIDE_FILE = join(\"docs\", \"03-upgrading.mdx\");\n\n/** What `bumpBlumeDependency` did to `package.json`. */\nexport type DependencyBump =\n  | {\n      field: DependencyField;\n      from: string;\n      status: \"bumped\";\n      to: string;\n    }\n  | { range: string; status: \"current\" }\n  | { status: \"missing\" };\n\ntype DependencyField = \"dependencies\" | \"devDependencies\";\n\nconst DEPENDENCY_FIELDS: DependencyField[] = [\n  \"dependencies\",\n  \"devDependencies\",\n];\n\n/** The slice of `package.json` the bump reads and rewrites. */\ninterface PackageJson {\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n}\n\n// Leading comparators and a `v` may precede the major (`^1.7.3`, `>=1 <2`,\n// `v1`); a protocol (`workspace:`, `file:`, `npm:`) or a tag (`latest`) names\n// no major at all, and those ranges are left to the user.\nconst RANGE_MAJOR = /^[\\s<=>^~v]*(?<major>\\d+)/u;\n\n/** The major version a dependency range pins, or null when it names none. */\nexport const rangeMajor = (range: string): number | null => {\n  const major = RANGE_MAJOR.exec(range)?.groups?.major;\n  return major === undefined ? null : Number(major);\n};\n\n// The file's own indentation (two spaces, four, or a tab), so a fallback\n// rewrite doesn't reformat a package.json the user keeps differently.\nconst INDENT = /^(?<indent>[ \\t]+)\"/mu;\n\nconst REGEXP_SPECIAL = /[$()*+.?[\\\\\\]^{|}]/gu;\nconst escapeRegExp = (value: string): string =>\n  value.replaceAll(REGEXP_SPECIAL, String.raw`\\$&`);\n\n/**\n * `text` with the `blume` range under `field` replaced in place, so the file\n * keeps its own formatting, key order, and inline objects; null when the entry\n * isn't written the plain way (an escaped key or value).\n */\nconst replaceRange = (\n  text: string,\n  field: DependencyField,\n  from: string,\n  to: string\n): string | null => {\n  const value = JSON.stringify(from);\n  const entry = new RegExp(`\"blume\"\\\\s*:\\\\s*${escapeRegExp(value)}`, \"gu\");\n  entry.lastIndex = Math.max(text.indexOf(JSON.stringify(field)), 0);\n  const match = entry.exec(text);\n  if (!match) {\n    return null;\n  }\n  const end = match.index + match[0].length;\n  return `${text.slice(0, end - value.length)}${JSON.stringify(to)}${text.slice(end)}`;\n};\n\n/**\n * Point `package.json`'s `blume` dependency at `^version` when it pins an\n * older major. A range already on this major, or one that names no version\n * (`workspace:*`, `latest`), is reported as current and left alone; a\n * project with no `package.json`, or none that lists `blume`, is `missing`.\n * Only the range changes: the rest of the file is kept byte for byte.\n */\nexport const bumpBlumeDependency = async (\n  root: string,\n  version: string\n): Promise<DependencyBump> => {\n  const path = join(root, \"package.json\");\n  if (!existsSync(path)) {\n    return { status: \"missing\" };\n  }\n  const text = await readFile(path, \"utf-8\");\n  // SAFETY: package.json is a JSON object; only its dependency maps, which\n  // map package names to range strings, are read.\n  const pkg = JSON.parse(text) as PackageJson;\n  const field = DEPENDENCY_FIELDS.find(\n    (name) => pkg[name]?.blume !== undefined\n  );\n  const from = field ? pkg[field]?.blume : undefined;\n  if (!(field && from)) {\n    return { status: \"missing\" };\n  }\n  const current = rangeMajor(from);\n  const target = rangeMajor(version);\n  if (current === null || target === null || current >= target) {\n    return { range: from, status: \"current\" };\n  }\n  const to = `^${version}`;\n  const indent = INDENT.exec(text)?.groups?.indent ?? \"  \";\n  const updated = { ...pkg, [field]: { ...pkg[field], blume: to } };\n  await writeFile(\n    path,\n    replaceRange(text, field, from, to) ??\n      `${JSON.stringify(updated, null, indent)}\\n`\n  );\n  return { field, from, status: \"bumped\", to };\n};\n\n/**\n * Whether `root` is no Blume project at all: no config file and no `blume`\n * dependency, so the upgrade would only check the defaults and report the\n * folder ready. A zero-config project still lists `blume`.\n */\nexport const isOutsideBlumeProject = (\n  root: string,\n  bump: DependencyBump\n): boolean => bump.status === \"missing\" && findConfigFile(root) === null;\n\n// ---------------------------------------------------------------------------\n// Removed `blume build` flags\n// ---------------------------------------------------------------------------\n\n/** A `blume build` flag Blume 2 removed, bare or with an `=value`. */\nconst REMOVED_BUILD_FLAG = /^--(?<flag>adapter|base|output)(?:=|$)/u;\n\n/** The removed `blume build` flags among `args`, in order, each once. */\nexport const removedBuildFlags = (args: readonly string[]): string[] => [\n  ...new Set(\n    args.flatMap((arg) => {\n      const flag = REMOVED_BUILD_FLAG.exec(arg)?.groups?.flag;\n      return flag ? [flag] : [];\n    })\n  ),\n];\n\n/** The flags as the reader typed them: `--adapter, --output`. */\nexport const flagList = (flags: string[]): string =>\n  flags.map((flag) => `--${flag}`).join(\", \");\n\n/** What replaces each removed flag: the `deployment` config. */\nexport const removedBuildFlagsAdvice = (flags: string[]): string => {\n  const advice: string[] = [];\n  if (flags.includes(\"adapter\") || flags.includes(\"output\")) {\n    advice.push(\n      'name the host in blume.config.ts with `deployment: vercel()` (or `netlify()`, `cloudflare()`, `node()`) from \"blume/deploy\" — a host adapter builds for the server, and `output: \"static\"` keeps it static'\n    );\n  }\n  if (flags.includes(\"base\")) {\n    advice.push(\n      'set the subpath with `deployment: { base: \"/docs\" }`, or the host adapter\\'s `base` option'\n    );\n  }\n  return `Drop ${flagList(flags)} and ${advice.join(\"; \")}.`;\n};\n\n// A command that runs the Blume CLI: the bare bin, a versioned package\n// (`blume@2`), or a path to it (`./node_modules/.bin/blume`).\nconst BLUME_BIN = /(?:^|[/\\\\])blume(?:@\\S+)?$/u;\nconst COMMAND_SEPARATOR = /&&|\\|\\||[;|]/u;\nconst WHITESPACE = /\\s+/u;\n\n/** The arguments each `blume build` in a script passes, flattened. */\nconst buildArgs = (script: string): string[] =>\n  script.split(COMMAND_SEPARATOR).flatMap((command) => {\n    const words = command.trim().split(WHITESPACE);\n    const at = words.findIndex(\n      (word, index) => BLUME_BIN.test(word) && words[index + 1] === \"build\"\n    );\n    return at === -1 ? [] : words.slice(at + 2);\n  });\n\n/** The slice of package.json the script check reads. */\nconst scriptsSchema = z.looseObject({\n  scripts: z.record(z.string(), z.string()).default({}),\n});\n\nconst lineOf = (text: string, index: number): number =>\n  text.slice(0, index).split(\"\\n\").length;\n\n/**\n * A finding for each package.json script that still passes a removed flag to\n * `blume build` — it would otherwise build a static site without a word.\n */\nconst scriptFindings = async (root: string): Promise<Diagnostic[]> => {\n  const path = join(root, \"package.json\");\n  if (!existsSync(path)) {\n    return [];\n  }\n  const text = await readFile(path, \"utf-8\");\n  const pkg = scriptsSchema.safeParse(JSON.parse(text));\n  const scripts = pkg.success ? pkg.data.scripts : {};\n  const scriptsAt = text.indexOf('\"scripts\"');\n  return Object.entries(scripts).flatMap(([name, script]) => {\n    const flags = removedBuildFlags(buildArgs(script));\n    if (flags.length === 0) {\n      return [];\n    }\n    const at = text.indexOf(JSON.stringify(name), scriptsAt);\n    return [\n      {\n        code: \"BLUME_BUILD_FLAG_REMOVED\",\n        file: path,\n        line: at === -1 ? undefined : lineOf(text, at),\n        message: `The \"${name}\" script passes ${flagList(flags)} to \\`blume build\\`, which Blume 2 removed.`,\n        severity: \"error\",\n        suggestion: removedBuildFlagsAdvice(flags),\n      } satisfies Diagnostic,\n    ];\n  });\n};\n\n// ---------------------------------------------------------------------------\n// Removed front matter fields\n// ---------------------------------------------------------------------------\n\n/** Where a project's local content lives, as its config names it. */\ninterface ContentGlobs {\n  exclude: string[];\n  include: string[];\n  root: string;\n}\n\nconst globFields = {\n  exclude: z.array(z.string()).optional(),\n  include: z.array(z.string()).optional(),\n  root: z.string().optional(),\n};\n\n/**\n * A filesystem source in either form a config being upgraded may hold: the\n * `filesystem()` descriptor, or Blume 1's `{ type: \"filesystem\" }` object.\n */\nconst rawFilesystemSourceSchema = z.union([\n  z\n    .looseObject({\n      kind: z.literal(\"filesystem\"),\n      options: z.looseObject(globFields).default({}),\n    })\n    .transform((source) => source.options),\n  z.looseObject({ type: z.literal(\"filesystem\"), ...globFields }),\n]);\n\n/** The `content` slice of a config as written, before validation. */\nconst rawContentSchema = z.looseObject({\n  content: z\n    .looseObject({ ...globFields, sources: z.array(z.unknown()).optional() })\n    .optional(),\n});\n\n/**\n * The content roots to scan, read from the config as written rather than the\n * validated config: the upgrade runs on configs that don't validate yet. Its\n * filesystem sources when it lists any, else the `content.root` shorthand,\n * else the zero-config `docs` folder.\n */\nexport const contentGlobs = ({\n  content,\n}: z.infer<typeof rawContentSchema>): ContentGlobs[] => {\n  const sources = (content?.sources ?? []).flatMap((source) => {\n    const filesystem = rawFilesystemSourceSchema.safeParse(source);\n    return filesystem.success ? [filesystem.data] : [];\n  });\n  return (sources.length > 0 ? sources : [content ?? {}]).map((globs) => ({\n    exclude: globs.exclude ?? DEFAULT_CONTENT_EXCLUDE,\n    include: globs.include ?? DEFAULT_CONTENT_INCLUDE,\n    root: globs.root ?? \"docs\",\n  }));\n};\n\n/** The content roots the project's config names, loaded as written. */\nconst configContentGlobs = async (root: string): Promise<ContentGlobs[]> => {\n  const file = findConfigFile(root);\n  let raw: z.infer<typeof rawContentSchema> = {};\n  if (file) {\n    try {\n      const parsed = rawContentSchema.safeParse(\n        await createModuleLoader()(file)\n      );\n      raw = parsed.success ? parsed.data : {};\n    } catch {\n      // A config that won't load is already reported by the config check;\n      // its content still gets the zero-config scan.\n    }\n  }\n  return contentGlobs(raw);\n};\n\nconst isPathKey = (segment: PropertyKey): segment is number | string =>\n  typeof segment !== \"symbol\";\n\n// Zod's own wording for an unknown key; a removed field's hint replaces it.\nconst PLAIN_UNKNOWN_KEY = \"Unrecognized key\";\n\n/**\n * The removed fields among one page's front matter issues, each at its own\n * line. Only issues the page schema words as a removed-field hint count: a\n * key a project declares through `frontmatter.extend` is unknown to the bare\n * schema, and any other invalid value was already an error on Blume 1.\n */\nconst removedFieldFindings = (\n  file: string,\n  text: string,\n  issues: readonly z.core.$ZodIssue[]\n): Diagnostic[] =>\n  issues.flatMap((issue) => {\n    if (\n      issue.code !== \"unrecognized_keys\" ||\n      issue.message.startsWith(PLAIN_UNKNOWN_KEY)\n    ) {\n      return [];\n    }\n    const path = issue.path.filter(isPathKey);\n    const position =\n      locateFrontmatterKey(text, [...path, ...issue.keys.slice(0, 1)]) ??\n      locateFrontmatterKey(text, path);\n    return [\n      {\n        code: \"BLUME_FRONTMATTER_INVALID\",\n        column: position?.column,\n        file,\n        line: position?.line,\n        message: issue.message,\n        severity: \"error\",\n      } satisfies Diagnostic,\n    ];\n  });\n\n/** The removed front matter fields in one page, or none it can't parse. */\nconst pageFindings = async (file: string): Promise<Diagnostic[]> => {\n  const text = await readFile(file, \"utf-8\");\n  let parsed: ReturnType<typeof pageMetaSchema.safeParse>;\n  try {\n    parsed = pageMetaSchema.safeParse(matter(text).data);\n  } catch {\n    // Unparseable front matter fails the build with its own diagnostic.\n    return [];\n  }\n  return parsed.success\n    ? []\n    : removedFieldFindings(file, text, parsed.error.issues);\n};\n\n/**\n * A finding for each front matter field Blume 2 removed, across the project's\n * local content. A page with one fails validation and drops out of the build,\n * which the config and components checks alone would report as ready.\n */\nconst frontmatterFindings = async (root: string): Promise<Diagnostic[]> => {\n  const roots = await configContentGlobs(root);\n  const matches = await Promise.all(\n    roots.map((globs) => {\n      const cwd = resolve(root, globs.root);\n      return existsSync(cwd)\n        ? glob(globs.include, {\n            absolute: true,\n            cwd,\n            ignore: [...globs.exclude, ...baselineScanIgnore()],\n            onlyFiles: true,\n          })\n        : [];\n    })\n  );\n  // Two sources can share a folder; each page is checked once.\n  const files = [...new Set(matches.flat())].toSorted();\n  const findings = await Promise.all(files.map(pageFindings));\n  return findings.flat();\n};\n\n/**\n * Run one check, turning the {@link BlumeError} it throws into its findings:\n * each config issue or `components.ts` entry on its own, or the one diagnostic\n * any other check has.\n */\nconst findingsOf = async (\n  check: () => Promise<void>\n): Promise<Diagnostic[]> => {\n  try {\n    await check();\n    return [];\n  } catch (error) {\n    if (\n      error instanceof ConfigValidationError ||\n      error instanceof ComponentOverridesError\n    ) {\n      return error.issues;\n    }\n    if (error instanceof BlumeError) {\n      return [error.diagnostic];\n    }\n    throw error;\n  }\n};\n\n/**\n * Check a project against this version of Blume: its config through the\n * loader (every invalid field, each with its line and replacement), its\n * `components.ts` through the static override planner (each entry at its\n * line), its pages' front matter for removed fields, and its package.json\n * scripts for `blume build` flags that no longer exist. Returns the failures;\n * an empty list means the project is ready.\n */\nexport const collectUpgradeFindings = async (\n  root: string\n): Promise<Diagnostic[]> => {\n  const componentsFile = findComponentsFile(root);\n  return [\n    ...(await findingsOf(async () => {\n      await loadConfig(root);\n    })),\n    ...(componentsFile\n      ? await findingsOf(async () => {\n          analyzeComponentOverrides(\n            await readFile(componentsFile, \"utf-8\"),\n            componentsFile\n          );\n        })\n      : []),\n    ...(await frontmatterFindings(root)),\n    ...(await scriptFindings(root)),\n  ];\n};\n\n/** A finding as plain text for the agent: where, what, and the fix. */\nconst plainFinding = (finding: Diagnostic, root: string): string => {\n  const where = finding.file\n    ? `${relative(root, finding.file)}${finding.line === undefined ? \"\" : `:${finding.line}`}`\n    : \"blume.config.ts\";\n  const fix = finding.suggestion ? `\\n  Fix: ${finding.suggestion}` : \"\";\n  return `- ${where} (${finding.code})\\n  ${finding.message.replaceAll(\"\\n\", \"\\n  \")}${fix}`;\n};\n\n/**\n * The handoff prompt: the findings inline (they're few, and each already\n * names its replacement), where the guide is, and the ground rules — change\n * the config's shape, never the site's behavior, and verify with the site's\n * own checks, run through the project's package runner (`npx`, `pnpm exec`),\n * since a local install puts no `blume` on PATH.\n */\nexport const upgradePrompt = (options: {\n  findings: Diagnostic[];\n  guidePath: string;\n  root: string;\n  runner: string;\n  version: string;\n}): string =>\n  `Upgrade this Blume project to Blume ${options.version}. \\`blume upgrade\\` has bumped the \\`blume\\` dependency in package.json where it could; what's left is the config.\n\nThe upgrade guide is at ${options.guidePath} (online at ${UPGRADE_GUIDE_URL}). It covers every change between Blume 1 and 2 with before-and-after examples: search, deployment, content sources, API references, analytics, and Ask AI become adapters imported from \\`blume/*\\` subpaths; the machine-readable settings move from \\`ai\\` to \\`agents\\`; and \\`components.ts\\` entries must be one of the static forms.\n\n\\`blume upgrade\\` found:\n\n${options.findings.map((finding) => plainFinding(finding, options.root)).join(\"\\n\\n\")}\n\nWork through every finding:\n1. Read the guide section for each change before editing.\n2. Rewrite the config to the Blume 2 form, adding the adapter imports it needs. Keep the site's behavior the same: the same content, routes, search backend, deployment target, analytics, and credentials (keep reading secrets from the same environment variables).\n3. The config loader reports every invalid field at once, but some changes only surface once earlier ones are fixed, so rerun \\`${options.runner} blume doctor\\` after each round of edits.\n4. Never delete content, or remove a setting only to silence an error; if something needs a human decision, leave it and say so in your summary.\n\nWhen \\`${options.runner} blume doctor\\` reports no errors, run \\`${options.runner} blume build\\` and fix anything it reports until it succeeds.`;\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AACA;AAEA;AACA;AACA;AA8BO,IAAM,oBAAoB;AAG1B,IAAM,qBAAqB,KAAK,QAAQ,kBAAkB;AAejE,IAAM,oBAAuC;AAAA,EAC3C;AAAA,EACA;AACF;AAWA,IAAM,cAAc;AAGb,IAAM,aAAa,CAAC,UAAiC;AAAA,EAC1D,MAAM,QAAQ,YAAY,KAAK,KAAK,GAAG,QAAQ;AAAA,EAC/C,OAAO,UAAU,YAAY,OAAO,OAAO,KAAK;AAAA;AAKlD,IAAM,SAAS;AAEf,IAAM,iBAAiB;AACvB,IAAM,eAAe,CAAC,UACpB,MAAM,WAAW,gBAAgB,OAAO,QAAQ;AAOlD,IAAM,eAAe,CACnB,MACA,OACA,MACA,OACkB;AAAA,EAClB,MAAM,QAAQ,KAAK,UAAU,IAAI;AAAA,EACjC,MAAM,QAAQ,IAAI,OAAO,mBAAmB,aAAa,KAAK,KAAK,IAAI;AAAA,EACvE,MAAM,YAAY,KAAK,IAAI,KAAK,QAAQ,KAAK,UAAU,KAAK,CAAC,GAAG,CAAC;AAAA,EACjE,MAAM,QAAQ,MAAM,KAAK,IAAI;AAAA,EAC7B,IAAI,CAAC,OAAO;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,MAAM,MAAM,MAAM,QAAQ,MAAM,GAAG;AAAA,EACnC,OAAO,GAAG,KAAK,MAAM,GAAG,MAAM,MAAM,MAAM,IAAI,KAAK,UAAU,EAAE,IAAI,KAAK,MAAM,GAAG;AAAA;AAU5E,IAAM,sBAAsB,OACjC,MACA,YAC4B;AAAA,EAC5B,MAAM,OAAO,KAAK,MAAM,cAAc;AAAA,EACtC,IAAI,CAAC,WAAW,IAAI,GAAG;AAAA,IACrB,OAAO,EAAE,QAAQ,UAAU;AAAA,EAC7B;AAAA,EACA,MAAM,OAAO,MAAM,SAAS,MAAM,OAAO;AAAA,EAGzC,MAAM,MAAM,KAAK,MAAM,IAAI;AAAA,EAC3B,MAAM,QAAQ,kBAAkB,KAC9B,CAAC,SAAS,IAAI,OAAO,UAAU,SACjC;AAAA,EACA,MAAM,OAAO,QAAQ,IAAI,QAAQ,QAAQ;AAAA,EACzC,IAAI,EAAE,SAAS,OAAO;AAAA,IACpB,OAAO,EAAE,QAAQ,UAAU;AAAA,EAC7B;AAAA,EACA,MAAM,UAAU,WAAW,IAAI;AAAA,EAC/B,MAAM,SAAS,WAAW,OAAO;AAAA,EACjC,IAAI,YAAY,QAAQ,WAAW,QAAQ,WAAW,QAAQ;AAAA,IAC5D,OAAO,EAAE,OAAO,MAAM,QAAQ,UAAU;AAAA,EAC1C;AAAA,EACA,MAAM,KAAK,IAAI;AAAA,EACf,MAAM,SAAS,OAAO,KAAK,IAAI,GAAG,QAAQ,UAAU;AAAA,EACpD,MAAM,UAAU,KAAK,MAAM,QAAQ,KAAK,IAAI,QAAQ,OAAO,GAAG,EAAE;AAAA,EAChE,MAAM,UACJ,MACA,aAAa,MAAM,OAAO,MAAM,EAAE,KAChC,GAAG,KAAK,UAAU,SAAS,MAAM,MAAM;AAAA,CAC3C;AAAA,EACA,OAAO,EAAE,OAAO,MAAM,QAAQ,UAAU,GAAG;AAAA;AAQtC,IAAM,wBAAwB,CACnC,MACA,SACY,KAAK,WAAW,aAAa,eAAe,IAAI,MAAM;AAOpE,IAAM,qBAAqB;AAGpB,IAAM,oBAAoB,CAAC,SAAsC;AAAA,EACtE,GAAG,IAAI,IACL,KAAK,QAAQ,CAAC,QAAQ;AAAA,IACpB,MAAM,OAAO,mBAAmB,KAAK,GAAG,GAAG,QAAQ;AAAA,IACnD,OAAO,OAAO,CAAC,IAAI,IAAI,CAAC;AAAA,GACzB,CACH;AACF;AAGO,IAAM,WAAW,CAAC,UACvB,MAAM,IAAI,CAAC,SAAS,KAAK,MAAM,EAAE,KAAK,IAAI;AAGrC,IAAM,0BAA0B,CAAC,UAA4B;AAAA,EAClE,MAAM,SAAmB,CAAC;AAAA,EAC1B,IAAI,MAAM,SAAS,SAAS,KAAK,MAAM,SAAS,QAAQ,GAAG;AAAA,IACzD,OAAO,KACL,4MACF;AAAA,EACF;AAAA,EACA,IAAI,MAAM,SAAS,MAAM,GAAG;AAAA,IAC1B,OAAO,KACL,4FACF;AAAA,EACF;AAAA,EACA,OAAO,QAAQ,SAAS,KAAK,SAAS,OAAO,KAAK,IAAI;AAAA;AAKxD,IAAM,YAAY;AAClB,IAAM,oBAAoB;AAC1B,IAAM,aAAa;AAGnB,IAAM,YAAY,CAAC,WACjB,OAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,YAAY;AAAA,EACnD,MAAM,QAAQ,QAAQ,KAAK,EAAE,MAAM,UAAU;AAAA,EAC7C,MAAM,KAAK,MAAM,UACf,CAAC,MAAM,UAAU,UAAU,KAAK,IAAI,KAAK,MAAM,QAAQ,OAAO,OAChE;AAAA,EACA,OAAO,OAAO,KAAK,CAAC,IAAI,MAAM,MAAM,KAAK,CAAC;AAAA,CAC3C;AAGH,IAAM,gBAAgB,EAAE,YAAY;AAAA,EAClC,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,IAAM,SAAS,CAAC,MAAc,UAC5B,KAAK,MAAM,GAAG,KAAK,EAAE,MAAM;AAAA,CAAI,EAAE;AAMnC,IAAM,iBAAiB,OAAO,SAAwC;AAAA,EACpE,MAAM,OAAO,KAAK,MAAM,cAAc;AAAA,EACtC,IAAI,CAAC,WAAW,IAAI,GAAG;AAAA,IACrB,OAAO,CAAC;AAAA,EACV;AAAA,EACA,MAAM,OAAO,MAAM,SAAS,MAAM,OAAO;AAAA,EACzC,MAAM,MAAM,cAAc,UAAU,KAAK,MAAM,IAAI,CAAC;AAAA,EACpD,MAAM,UAAU,IAAI,UAAU,IAAI,KAAK,UAAU,CAAC;AAAA,EAClD,MAAM,YAAY,KAAK,QAAQ,WAAW;AAAA,EAC1C,OAAO,OAAO,QAAQ,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY;AAAA,IACzD,MAAM,QAAQ,kBAAkB,UAAU,MAAM,CAAC;AAAA,IACjD,IAAI,MAAM,WAAW,GAAG;AAAA,MACtB,OAAO,CAAC;AAAA,IACV;AAAA,IACA,MAAM,KAAK,KAAK,QAAQ,KAAK,UAAU,IAAI,GAAG,SAAS;AAAA,IACvD,OAAO;AAAA,MACL;AAAA,QACE,MAAM;AAAA,QACN,MAAM;AAAA,QACN,MAAM,OAAO,KAAK,YAAY,OAAO,MAAM,EAAE;AAAA,QAC7C,SAAS,QAAQ,uBAAuB,SAAS,KAAK;AAAA,QACtD,UAAU;AAAA,QACV,YAAY,wBAAwB,KAAK;AAAA,MAC3C;AAAA,IACF;AAAA,GACD;AAAA;AAcH,IAAM,aAAa;AAAA,EACjB,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACtC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACtC,MAAM,EAAE,OAAO,EAAE,SAAS;AAC5B;AAMA,IAAM,4BAA4B,EAAE,MAAM;AAAA,EACxC,EACG,YAAY;AAAA,IACX,MAAM,EAAE,QAAQ,YAAY;AAAA,IAC5B,SAAS,EAAE,YAAY,UAAU,EAAE,QAAQ,CAAC,CAAC;AAAA,EAC/C,CAAC,EACA,UAAU,CAAC,WAAW,OAAO,OAAO;AAAA,EACvC,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,YAAY,MAAM,WAAW,CAAC;AAChE,CAAC;AAGD,IAAM,mBAAmB,EAAE,YAAY;AAAA,EACrC,SAAS,EACN,YAAY,KAAK,YAAY,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC,EACvE,SAAS;AACd,CAAC;AAQM,IAAM,eAAe;AAAA,EAC1B;AAAA,MACsD;AAAA,EACtD,MAAM,WAAW,SAAS,WAAW,CAAC,GAAG,QAAQ,CAAC,WAAW;AAAA,IAC3D,MAAM,aAAa,0BAA0B,UAAU,MAAM;AAAA,IAC7D,OAAO,WAAW,UAAU,CAAC,WAAW,IAAI,IAAI,CAAC;AAAA,GAClD;AAAA,EACD,QAAQ,QAAQ,SAAS,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW;AAAA,IACtE,SAAS,MAAM,WAAW;AAAA,IAC1B,SAAS,MAAM,WAAW;AAAA,IAC1B,MAAM,MAAM,QAAQ;AAAA,EACtB,EAAE;AAAA;AAIJ,IAAM,qBAAqB,OAAO,SAA0C;AAAA,EAC1E,MAAM,OAAO,eAAe,IAAI;AAAA,EAChC,IAAI,MAAwC,CAAC;AAAA,EAC7C,IAAI,MAAM;AAAA,IACR,IAAI;AAAA,MACF,MAAM,SAAS,iBAAiB,UAC9B,MAAM,mBAAmB,EAAE,IAAI,CACjC;AAAA,MACA,MAAM,OAAO,UAAU,OAAO,OAAO,CAAC;AAAA,MACtC,MAAM;AAAA,EAIV;AAAA,EACA,OAAO,aAAa,GAAG;AAAA;AAGzB,IAAM,YAAY,CAAC,YACjB,OAAO,YAAY;AAGrB,IAAM,oBAAoB;AAQ1B,IAAM,uBAAuB,CAC3B,MACA,MACA,WAEA,OAAO,QAAQ,CAAC,UAAU;AAAA,EACxB,IACE,MAAM,SAAS,uBACf,MAAM,QAAQ,WAAW,iBAAiB,GAC1C;AAAA,IACA,OAAO,CAAC;AAAA,EACV;AAAA,EACA,MAAM,OAAO,MAAM,KAAK,OAAO,SAAS;AAAA,EACxC,MAAM,WACJ,qBAAqB,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,KAC/D,qBAAqB,MAAM,IAAI;AAAA,EACjC,OAAO;AAAA,IACL;AAAA,MACE,MAAM;AAAA,MACN,QAAQ,UAAU;AAAA,MAClB;AAAA,MACA,MAAM,UAAU;AAAA,MAChB,SAAS,MAAM;AAAA,MACf,UAAU;AAAA,IACZ;AAAA,EACF;AAAA,CACD;AAGH,IAAM,eAAe,OAAO,SAAwC;AAAA,EAClE,MAAM,OAAO,MAAM,SAAS,MAAM,OAAO;AAAA,EACzC,IAAI;AAAA,EACJ,IAAI;AAAA,IACF,SAAS,eAAe,UAAU,oBAAO,IAAI,EAAE,IAAI;AAAA,IACnD,MAAM;AAAA,IAEN,OAAO,CAAC;AAAA;AAAA,EAEV,OAAO,OAAO,UACV,CAAC,IACD,qBAAqB,MAAM,MAAM,OAAO,MAAM,MAAM;AAAA;AAQ1D,IAAM,sBAAsB,OAAO,SAAwC;AAAA,EACzE,MAAM,QAAQ,MAAM,mBAAmB,IAAI;AAAA,EAC3C,MAAM,UAAU,MAAM,QAAQ,IAC5B,MAAM,IAAI,CAAC,UAAU;AAAA,IACnB,MAAM,MAAM,QAAQ,MAAM,MAAM,IAAI;AAAA,IACpC,OAAO,WAAW,GAAG,IACjB,KAAK,MAAM,SAAS;AAAA,MAClB,UAAU;AAAA,MACV;AAAA,MACA,QAAQ,CAAC,GAAG,MAAM,SAAS,GAAG,mBAAmB,CAAC;AAAA,MAClD,WAAW;AAAA,IACb,CAAC,IACD,CAAC;AAAA,GACN,CACH;AAAA,EAEA,MAAM,QAAQ,CAAC,GAAG,IAAI,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,SAAS;AAAA,EACpD,MAAM,WAAW,MAAM,QAAQ,IAAI,MAAM,IAAI,YAAY,CAAC;AAAA,EAC1D,OAAO,SAAS,KAAK;AAAA;AAQvB,IAAM,aAAa,OACjB,UAC0B;AAAA,EAC1B,IAAI;AAAA,IACF,MAAM,MAAM;AAAA,IACZ,OAAO,CAAC;AAAA,IACR,OAAO,OAAO;AAAA,IACd,IACE,iBAAiB,yBACjB,iBAAiB,yBACjB;AAAA,MACA,OAAO,MAAM;AAAA,IACf;AAAA,IACA,IAAI,iBAAiB,YAAY;AAAA,MAC/B,OAAO,CAAC,MAAM,UAAU;AAAA,IAC1B;AAAA,IACA,MAAM;AAAA;AAAA;AAYH,IAAM,yBAAyB,OACpC,SAC0B;AAAA,EAC1B,MAAM,iBAAiB,mBAAmB,IAAI;AAAA,EAC9C,OAAO;AAAA,IACL,GAAI,MAAM,WAAW,YAAY;AAAA,MAC/B,MAAM,WAAW,IAAI;AAAA,KACtB;AAAA,IACD,GAAI,iBACA,MAAM,WAAW,YAAY;AAAA,MAC3B,0BACE,MAAM,SAAS,gBAAgB,OAAO,GACtC,cACF;AAAA,KACD,IACD,CAAC;AAAA,IACL,GAAI,MAAM,oBAAoB,IAAI;AAAA,IAClC,GAAI,MAAM,eAAe,IAAI;AAAA,EAC/B;AAAA;AAIF,IAAM,eAAe,CAAC,SAAqB,SAAyB;AAAA,EAClE,MAAM,QAAQ,QAAQ,OAClB,GAAG,SAAS,MAAM,QAAQ,IAAI,IAAI,QAAQ,SAAS,YAAY,KAAK,IAAI,QAAQ,WAChF;AAAA,EACJ,MAAM,MAAM,QAAQ,aAAa;AAAA,SAAY,QAAQ,eAAe;AAAA,EACpE,OAAO,KAAK,UAAU,QAAQ;AAAA,IAAY,QAAQ,QAAQ,WAAW;AAAA,GAAM;AAAA,GAAM,IAAI;AAAA;AAUhF,IAAM,gBAAgB,CAAC,YAO5B,uCAAuC,QAAQ;AAAA;AAAA,0BAEvB,QAAQ,wBAAwB;AAAA;AAAA;AAAA;AAAA,EAIxD,QAAQ,SAAS,IAAI,CAAC,YAAY,aAAa,SAAS,QAAQ,IAAI,CAAC,EAAE,KAAK;AAAA;AAAA,CAAM;AAAA;AAAA;AAAA;AAAA;AAAA,kIAK8C,QAAQ;AAAA;AAAA;AAAA,SAGjI,QAAQ,kDAAkD,QAAQ;",
+  "debugId": "BBD151C21AC6C49164756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-bnbmcwfb.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+import {
+  packageRoot
+} from "./index.js";
+import {
+  commandsFor,
+  detectProjectPackageManager
+} from "./chunk-xaz13gwg.js";
+
+// src/astro/islands.ts
+import { readFile } from "node:fs/promises";
+import pMap from "p-map";
+import { basename, join } from "pathe";
+import { glob } from "tinyglobby";
+var DEFAULT_CLIENT = "visible";
+var READ_CONCURRENCY = 16;
+var VALID_MODES = new Set([
+  "idle",
+  "load",
+  "only",
+  "visible"
+]);
+var isClientMode = (mode) => VALID_MODES.has(mode);
+var FRAMEWORK_BY_EXT = new Map([
+  ["jsx", "react"],
+  ["svelte", "svelte"],
+  ["tsx", "react"],
+  ["vue", "vue"]
+]);
+var ISLAND_FILE = /\.(?<ext>jsx|svelte|tsx|vue)$/u;
+var CLIENT_EXPORT = /export\s+const\s+client\s*(?::[^=]+)?=\s*["'](?<mode>\w+)["']/u;
+var readClientMode = (source, file, warnings) => {
+  const mode = source.match(CLIENT_EXPORT)?.groups?.mode;
+  if (!mode) {
+    return DEFAULT_CLIENT;
+  }
+  if (!isClientMode(mode)) {
+    warnings.push(`Island "${file}" declares an unknown client mode "${mode}"; defaulting to "${DEFAULT_CLIENT}". Use "load", "idle", "visible", or "only".`);
+    return DEFAULT_CLIENT;
+  }
+  return mode;
+};
+var discoverIslands = async (root) => {
+  const dir = join(root, "islands");
+  const matches = await glob(["**/*"], {
+    absolute: true,
+    cwd: dir,
+    onlyFiles: true
+  });
+  const files = matches.toSorted();
+  const sources = await pMap(files, (file) => readFile(file, "utf-8"), {
+    concurrency: READ_CONCURRENCY
+  });
+  const islands = [];
+  const warnings = [];
+  const seen = new Map;
+  const collectIsland = (file, source) => {
+    const base = basename(file);
+    const ext = base.match(ISLAND_FILE)?.groups?.ext;
+    const framework = ext ? FRAMEWORK_BY_EXT.get(ext) : undefined;
+    if (!framework) {
+      return;
+    }
+    const name = base.replace(ISLAND_FILE, "");
+    if (!/^[A-Z][A-Za-z0-9_]*$/u.test(name)) {
+      warnings.push(`Island "${file}" must have a PascalCase identifier filename to be used in MDX (letters, digits, and underscores only, e.g. Counter.tsx → <Counter />); skipping it.`);
+      return;
+    }
+    const existing = seen.get(name);
+    if (existing) {
+      warnings.push(`Two islands both resolve to <${name}> ("${existing}" and "${file}"); ignoring the second. Give them distinct filenames.`);
+      return;
+    }
+    seen.set(name, file);
+    islands.push({
+      client: readClientMode(source, file, warnings),
+      file,
+      framework,
+      name
+    });
+  };
+  for (const [index, file] of files.entries()) {
+    collectIsland(file, sources[index] ?? "");
+  }
+  return { islands, warnings };
+};
+
+// src/astro/runtime-deps.ts
+import { createRequire } from "node:module";
+import { pathToFileURL } from "node:url";
+import { join as join2 } from "pathe";
+var canResolveFrom = (fromDir, spec) => {
+  try {
+    createRequire(pathToFileURL(join2(fromDir, "_.js")).href).resolve(spec);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var unresolved = (owner, deps, root, pkgDir) => deps.filter((dep) => !(canResolveFrom(root, dep) || canResolveFrom(pkgDir, dep))).map((dep) => ({ dep, install: [dep], owner }));
+var searchProviderDependencies = (provider, root, pkgDir = packageRoot()) => unresolved(`Search adapter "${provider.kind}"`, provider.runtimeDeps, root, pkgDir);
+var sourceAdapterDependencies = (sources, root, pkgDir = packageRoot()) => sources.flatMap((source) => unresolved(`Content source "${source.kind}"`, source.runtimeDeps, root, pkgDir));
+var askProviderDependencies = (ask, root, pkgDir = packageRoot()) => ask?.enabled && !ask.endpoint ? unresolved(`Ask AI provider "${ask.provider.kind}"`, ask.provider.runtimeDeps, root, pkgDir) : [];
+var deploymentAdapterDependencies = (deployment, root, pkgDir = packageRoot()) => unresolved(`Deployment adapter "${deployment.kind}"`, deployment.runtimeDeps, root, pkgDir);
+var ISLAND_FRAMEWORK_DEPS = new Map([
+  ["svelte", "@astrojs/svelte"],
+  ["vue", "@astrojs/vue"]
+]);
+var islandFrameworkDependencies = (frameworks, root) => [...frameworks].flatMap((framework) => {
+  const dep = ISLAND_FRAMEWORK_DEPS.get(framework);
+  return dep && !canResolveFrom(root, dep) ? [
+    {
+      dep,
+      install: [dep, framework],
+      owner: `Island framework "${framework}"`
+    }
+  ] : [];
+});
+var missingRuntimeDependencies = (config, root, frameworks = [], pkgDir = packageRoot()) => [
+  ...searchProviderDependencies(config.search.provider, root, pkgDir),
+  ...sourceAdapterDependencies(config.content.sources, root, pkgDir),
+  ...askProviderDependencies(config.ai.ask, root, pkgDir),
+  ...deploymentAdapterDependencies(config.deployment, root, pkgDir),
+  ...islandFrameworkDependencies(frameworks, root)
+];
+var missingDependencyDiagnostic = async (config, root, severity, frameworks = [], pkgDir = packageRoot()) => {
+  const missing = missingRuntimeDependencies(config, root, frameworks, pkgDir);
+  if (missing.length === 0) {
+    return;
+  }
+  const { add } = commandsFor(await detectProjectPackageManager(root));
+  const needs = missing.map(({ dep, owner }) => `${owner} needs "${dep}"`);
+  const packages = [...new Set(missing.flatMap(({ install }) => install))];
+  return {
+    code: "BLUME_DEPENDENCY_MISSING",
+    message: missing.length === 1 ? `${needs[0]}, which isn't installed.` : `These packages aren't installed: ${needs.join("; ")}.`,
+    severity,
+    suggestion: `Install ${packages.length === 1 ? "it" : "them"}: \`${add} ${packages.join(" ")}\`.`
+  };
+};
+
+export { readClientMode, discoverIslands, missingDependencyDiagnostic };
+
+//# debugId=340EEA216AAB3A0164756E2164756E21
+//# sourceMappingURL=chunk-bnbmcwfb.js.map

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

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/astro/islands.ts", "../src/astro/runtime-deps.ts"],
+  "sourcesContent": [
+    "import { readFile } from \"node:fs/promises\";\n\nimport pMap from \"p-map\";\nimport { basename, join } from \"pathe\";\nimport { glob } from \"tinyglobby\";\n\n/** Astro hydration directives Blume applies to a convention island. */\nexport type IslandClientMode = \"idle\" | \"load\" | \"only\" | \"visible\";\n\n/** Client framework an island is authored in, inferred from its extension. */\nexport type IslandFramework = \"react\" | \"svelte\" | \"vue\";\n\n/** A discovered `islands/` component, ready to wrap and expose to MDX. */\nexport interface IslandSpec {\n  /** Hydration directive, from `export const client` or the default. */\n  client: IslandClientMode;\n  /** Absolute path to the island source file. */\n  file: string;\n  /** Astro client framework, used to enable the renderer and for `client:only`. */\n  framework: IslandFramework;\n  /** Component name used in MDX — the file's basename without extension. */\n  name: string;\n}\n\nexport interface IslandDiscovery {\n  islands: IslandSpec[];\n  warnings: string[];\n}\n\n/** Hydration mode used when an island doesn't declare one. */\nconst DEFAULT_CLIENT: IslandClientMode = \"visible\";\n\n/** Ceiling on concurrent island-file reads; unbounded fan-out risks EMFILE. */\nconst READ_CONCURRENCY = 16;\n\nconst VALID_MODES = new Set<IslandClientMode>([\n  \"idle\",\n  \"load\",\n  \"only\",\n  \"visible\",\n]);\n\n/** Whether a declared client mode is one Astro's directives support. */\nconst isClientMode = (mode: string): mode is IslandClientMode =>\n  // SAFETY: `Set.has` only compares identity at runtime; the assertion widens\n  // the lookup key so the narrower-typed set accepts it, and the `has` result\n  // is exactly the predicate being claimed.\n  VALID_MODES.has(mode as IslandClientMode);\n\n/** Island extensions mapped to the Astro renderer that handles them. */\nconst FRAMEWORK_BY_EXT = new Map<string, IslandFramework>([\n  [\"jsx\", \"react\"],\n  [\"svelte\", \"svelte\"],\n  [\"tsx\", \"react\"],\n  [\"vue\", \"vue\"],\n]);\n\n// Captures the extension so we can both strip it from the name and pick the\n// framework. Kept in sync with the glob below.\nconst ISLAND_FILE = /\\.(?<ext>jsx|svelte|tsx|vue)$/u;\n\n// Matches `export const client = \"load\"` (with optional type annotation and\n// either quote style). Read statically so we never execute island code in Node.\nconst CLIENT_EXPORT =\n  /export\\s+const\\s+client\\s*(?::[^=]+)?=\\s*[\"'](?<mode>\\w+)[\"']/u;\n\nexport const readClientMode = (\n  source: string,\n  file: string,\n  warnings: string[]\n): IslandClientMode => {\n  const mode = source.match(CLIENT_EXPORT)?.groups?.mode;\n  if (!mode) {\n    return DEFAULT_CLIENT;\n  }\n  if (!isClientMode(mode)) {\n    warnings.push(\n      `Island \"${file}\" declares an unknown client mode \"${mode}\"; defaulting to \"${DEFAULT_CLIENT}\". Use \"load\", \"idle\", \"visible\", or \"only\".`\n    );\n    return DEFAULT_CLIENT;\n  }\n  return mode;\n};\n\n/**\n * Discover convention islands under `<root>/islands`. Every `.tsx`/`.jsx`/\n * `.vue`/`.svelte` file becomes a globally-available, hydrated MDX component\n * named after the file (which must be PascalCase to be usable as a JSX tag).\n * Hydration defaults to `client:visible`; a file opts out with `export const\n * client = \"load\" | \"idle\" | \"only\"`. Discovery is path-based (a glob), so no\n * user code is executed.\n */\nexport const discoverIslands = async (\n  root: string\n): Promise<IslandDiscovery> => {\n  const dir = join(root, \"islands\");\n  // Enumerate everything and let ISLAND_FILE do the filtering below, so\n  // unknown extensions take the skip guard instead of relying on a glob\n  // pattern staying in sync with the regex and framework map.\n  const matches = await glob([\"**/*\"], {\n    absolute: true,\n    cwd: dir,\n    onlyFiles: true,\n  });\n  const files = matches.toSorted();\n  const sources = await pMap(files, (file) => readFile(file, \"utf-8\"), {\n    concurrency: READ_CONCURRENCY,\n  });\n\n  const islands: IslandSpec[] = [];\n  const warnings: string[] = [];\n  const seen = new Map<string, string>();\n\n  // Extracted so the skip paths become early `return`s (one `continue` budget\n  // per loop under the lint rule) instead of `continue` statements.\n  const collectIsland = (file: string, source: string): void => {\n    const base = basename(file);\n    const ext = base.match(ISLAND_FILE)?.groups?.ext;\n    const framework = ext ? FRAMEWORK_BY_EXT.get(ext) : undefined;\n    if (!framework) {\n      return;\n    }\n    const name = base.replace(ISLAND_FILE, \"\");\n    // The name is used verbatim as both an MDX tag and an unquoted object key\n    // in the generated island map, so it must be a plain PascalCase identifier\n    // — a `-`, `.`, or space (e.g. `Time-Picker.tsx`) would otherwise emit a\n    // syntax-error module and fail the whole build with no pointer to the file.\n    if (!/^[A-Z][A-Za-z0-9_]*$/u.test(name)) {\n      warnings.push(\n        `Island \"${file}\" must have a PascalCase identifier filename to be used in MDX (letters, digits, and underscores only, e.g. Counter.tsx → <Counter />); skipping it.`\n      );\n      return;\n    }\n    const existing = seen.get(name);\n    if (existing) {\n      warnings.push(\n        `Two islands both resolve to <${name}> (\"${existing}\" and \"${file}\"); ignoring the second. Give them distinct filenames.`\n      );\n      return;\n    }\n    seen.set(name, file);\n    islands.push({\n      client: readClientMode(source, file, warnings),\n      file,\n      framework,\n      name,\n    });\n  };\n\n  for (const [index, file] of files.entries()) {\n    collectIsland(file, sources[index] ?? \"\");\n  }\n\n  return { islands, warnings };\n};\n",
+    "import { createRequire } from \"node:module\";\nimport { pathToFileURL } from \"node:url\";\n\nimport { join } from \"pathe\";\n\nimport {\n  commandsFor,\n  detectProjectPackageManager,\n} from \"../cli/init/scaffold.ts\";\nimport { packageRoot } from \"../core/package-root.ts\";\nimport type { ResolvedConfig } from \"../core/schema.ts\";\nimport type { Diagnostic } from \"../core/types.ts\";\n\n/** Whether a module specifier resolves from a directory via node resolution. */\nexport const canResolveFrom = (fromDir: string, spec: string): boolean => {\n  try {\n    createRequire(pathToFileURL(join(fromDir, \"_.js\")).href).resolve(spec);\n    return true;\n  } catch {\n    return false;\n  }\n};\n\n/** A package a configured feature imports that the project can't resolve. */\nexport interface MissingDependency {\n  /** The package whose absence was detected. */\n  dep: string;\n  /** Every package to install for the feature (a framework and its integration). */\n  install: string[];\n  /** What needs it, as the message names it: `Search adapter \"algolia\"`. */\n  owner: string;\n}\n\n/**\n * The declared `deps` of one feature that resolve neither from the project\n * root nor from the Blume package itself. A dep is available when the project\n * installed it OR Blume ships it (the same set the `.blume` deps link exposes\n * to the build). Resolving from the project root alone falsely flagged a\n * shipped SDK like Orama (the default provider) as missing whenever it wasn't\n * hoisted into the project, e.g. under isolated linkers. Each package is\n * resolved from its real location rather than through the `.blume` junction,\n * which can't be traversed reliably for store-symlinked deps.\n */\nconst unresolved = (\n  owner: string,\n  deps: readonly string[],\n  root: string,\n  pkgDir: string\n): MissingDependency[] =>\n  deps\n    .filter(\n      (dep) => !(canResolveFrom(root, dep) || canResolveFrom(pkgDir, dep))\n    )\n    .map((dep) => ({ dep, install: [dep], owner }));\n\n/**\n * The search adapter's SDK, when missing. Provider SDKs are optional peers,\n * so a hosted adapter's client import fails in Vite without one.\n */\nexport const searchProviderDependencies = (\n  provider: ResolvedConfig[\"search\"][\"provider\"],\n  root: string,\n  pkgDir: string = packageRoot()\n): MissingDependency[] =>\n  unresolved(\n    `Search adapter \"${provider.kind}\"`,\n    provider.runtimeDeps,\n    root,\n    pkgDir\n  );\n\n/** Content source SDKs (`@notionhq/client`, `@sanity/client`), when missing. */\nexport const sourceAdapterDependencies = (\n  sources: ResolvedConfig[\"content\"][\"sources\"],\n  root: string,\n  pkgDir: string = packageRoot()\n): MissingDependency[] =>\n  sources.flatMap((source) =>\n    unresolved(\n      `Content source \"${source.kind}\"`,\n      source.runtimeDeps,\n      root,\n      pkgDir\n    )\n  );\n\n/**\n * The Ask AI adapter's provider SDK, when missing — only `gateway` needs\n * nothing beyond the core `ai` package Blume ships. An external `endpoint`\n * means no generated route, so no SDK is imported.\n */\nexport const askProviderDependencies = (\n  ask: ResolvedConfig[\"ai\"][\"ask\"],\n  root: string,\n  pkgDir: string = packageRoot()\n): MissingDependency[] =>\n  ask?.enabled && !ask.endpoint\n    ? unresolved(\n        `Ask AI provider \"${ask.provider.kind}\"`,\n        ask.provider.runtimeDeps,\n        root,\n        pkgDir\n      )\n    : [];\n\n/**\n * The deployment adapter's package, when missing. Node and Vercel ship with\n * Blume, so theirs always resolve; Netlify and Cloudflare are optional peers.\n * The generated astro.config.mjs imports the package directly, so without it\n * the build dies with an opaque ERR_MODULE_NOT_FOUND from the hidden config.\n */\nexport const deploymentAdapterDependencies = (\n  deployment: ResolvedConfig[\"deployment\"],\n  root: string,\n  pkgDir: string = packageRoot()\n): MissingDependency[] =>\n  unresolved(\n    `Deployment adapter \"${deployment.kind}\"`,\n    deployment.runtimeDeps,\n    root,\n    pkgDir\n  );\n\n/** Astro integration package each non-React island framework needs installed. */\nconst ISLAND_FRAMEWORK_DEPS = new Map([\n  [\"svelte\", \"@astrojs/svelte\"],\n  [\"vue\", \"@astrojs/vue\"],\n]);\n\n/**\n * A Vue/Svelte island's Astro integration, when missing — the generated config\n * imports it. React ships with Blume, so it never needs this. The framework\n * itself is installed alongside its integration.\n */\nexport const islandFrameworkDependencies = (\n  frameworks: Iterable<string>,\n  root: string\n): MissingDependency[] =>\n  [...frameworks].flatMap((framework) => {\n    const dep = ISLAND_FRAMEWORK_DEPS.get(framework);\n    return dep && !canResolveFrom(root, dep)\n      ? [\n          {\n            dep,\n            install: [dep, framework],\n            owner: `Island framework \"${framework}\"`,\n          },\n        ]\n      : [];\n  });\n\n/**\n * Every package the resolved config's adapters (and the given island\n * frameworks) import that isn't installed: the search SDK, content source\n * SDKs, the Ask AI provider SDK, the deployment adapter, and island\n * integrations. The adapters' `runtimeDeps` are the one place that knows.\n */\nexport const missingRuntimeDependencies = (\n  config: ResolvedConfig,\n  root: string,\n  frameworks: Iterable<string> = [],\n  pkgDir: string = packageRoot()\n): MissingDependency[] => [\n  ...searchProviderDependencies(config.search.provider, root, pkgDir),\n  ...sourceAdapterDependencies(config.content.sources, root, pkgDir),\n  ...askProviderDependencies(config.ai.ask, root, pkgDir),\n  ...deploymentAdapterDependencies(config.deployment, root, pkgDir),\n  ...islandFrameworkDependencies(frameworks, root),\n];\n\n/**\n * One diagnostic for every package the config imports that isn't installed,\n * with the command that installs them all through the project's package\n * manager (`npm install`, `pnpm add`, …), or undefined when nothing is\n * missing. `blume build` raises it as an error and `blume dev` as a warning;\n * `blume doctor` reports it before a build ever runs.\n */\nexport const missingDependencyDiagnostic = async (\n  config: ResolvedConfig,\n  root: string,\n  severity: Diagnostic[\"severity\"],\n  frameworks: Iterable<string> = [],\n  pkgDir: string = packageRoot()\n): Promise<Diagnostic | undefined> => {\n  const missing = missingRuntimeDependencies(config, root, frameworks, pkgDir);\n  if (missing.length === 0) {\n    return undefined;\n  }\n  const { add } = commandsFor(await detectProjectPackageManager(root));\n  const needs = missing.map(({ dep, owner }) => `${owner} needs \"${dep}\"`);\n  const packages = [...new Set(missing.flatMap(({ install }) => install))];\n  return {\n    code: \"BLUME_DEPENDENCY_MISSING\",\n    message:\n      missing.length === 1\n        ? `${needs[0]}, which isn't installed.`\n        : `These packages aren't installed: ${needs.join(\"; \")}.`,\n    severity,\n    suggestion: `Install ${packages.length === 1 ? \"it\" : \"them\"}: \\`${add} ${packages.join(\" \")}\\`.`,\n  };\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "340EEA216AAB3A0164756E2164756E21",
+  "names": []
+}

package/dist/cli/{chunk-0xjyb285.js → chunk-bw22s759.js}

@@ -611,7 +611,7 @@ var CHECKS = [
   },
   {
     category: "ai",
-    fix: "Rebuild — `ai.llmsTxt` is enabled but the build has no llms.txt. If that's intentional, set `ai.llmsTxt: false`.",
+    fix: "Rebuild — `agents.llmsTxt` is enabled but the build has no llms.txt. If that's intentional, set `agents.llmsTxt: false`.",
     id: "BLUME_AUDIT_LLMS_TXT_MISSING",
     severity: "warning",
     tier: "static",
@@ -730,7 +730,7 @@ var checkMeta = (id) => {
   }
   return meta;
 };
-var DOCS_BASE = "https://useblume.dev/docs/reference/audit";
+var DOCS_BASE = "https://useblume.dev/docs/cli/audit";
 var checkDocsUrl = (id) => `${DOCS_BASE}#${id.replace("BLUME_AUDIT_", "").toLowerCase().replaceAll("_", "-")}`;
 var finding = (id, site, detail, fix) => {
   const meta = checkMeta(id);
@@ -945,8 +945,18 @@ var launchAgent = async (bin, prompt, platform = process.platform) => {
     `Read ${promptPath} and follow its instructions exactly.`
   ]);
 };
+var launchInstalledAgent = async (bin, prompt, platform = process.platform) => {
+  try {
+    return await launchAgent(bin, prompt, platform);
+  } catch (error) {
+    if (error?.code !== "ENOENT") {
+      throw error;
+    }
+    return null;
+  }
+};
 
-export { CHECKS, finding, formatReport, reportJson, formatCatalog, AGENTS, writeAgentReport, fixPrompt, launchAgent };
+export { CHECKS, finding, formatReport, reportJson, formatCatalog, AGENTS, writeAgentReport, fixPrompt, launchAgent, launchInstalledAgent };
 
-//# debugId=C3633A8B6C87D94F64756E2164756E21
-//# sourceMappingURL=chunk-0xjyb285.js.map
+//# debugId=0DEBBF082B3707F764756E2164756E21
+//# sourceMappingURL=chunk-bw22s759.js.map