blume 1.7.3 → 2.0.1

package/dist/cli/chunk-zxh4d9vy.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+import {
+  packageDirFrom,
+  generateRuntime
+} from "./chunk-wgm7m9qk.js";
+import {
+  loadEnvFiles,
+  reportInternalError,
+  BlumeError,
+  hasErrors,
+  logger,
+  reportDiagnostics
+} from "./index.js";
+import {
+  scanProject
+} from "./chunk-fs23ddbb.js";
+import {
+  serverFeatures,
+  checkRequiredSecrets
+} from "./chunk-ah61y8py.js";
+
+// src/cli/yarn-pnp.ts
+import { existsSync } from "node:fs";
+import { dirname, join } from "pathe";
+var hasPnpManifest = (root) => {
+  let dir = root;
+  while (true) {
+    if (existsSync(join(dir, ".pnp.cjs")) || existsSync(join(dir, ".pnp.js"))) {
+      return true;
+    }
+    const parent = dirname(dir);
+    if (parent === dir) {
+      return false;
+    }
+    dir = parent;
+  }
+};
+var yarnPnpDiagnostic = (root, pnpVersion = process.versions.pnp) => {
+  const underPnp = pnpVersion !== undefined || hasPnpManifest(root) && packageDirFrom("blume", root) === null;
+  if (!underPnp) {
+    return null;
+  }
+  return {
+    code: "BLUME_YARN_PNP",
+    message: "Yarn Plug'n'Play isn't supported: the Astro project Blume generates in `.blume/` resolves Astro and Blume's dependencies from a `node_modules` folder, which Plug'n'Play doesn't create.",
+    severity: "error",
+    suggestion: "Add `nodeLinker: node-modules` to `.yarnrc.yml`, run `yarn install`, then run this command again."
+  };
+};
+
+// src/cli/prepare.ts
+var prepareProject = async (options) => {
+  const pnp = yarnPnpDiagnostic(options.root);
+  if (pnp) {
+    reportDiagnostics([pnp], options.root);
+    process.exit(1);
+  }
+  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.options.output === "static") {
+    const features = serverFeatures(project.config);
+    if (features.length > 0) {
+      const { kind } = project.config.deployment;
+      reportDiagnostics([
+        {
+          code: "BLUME_SERVER_FEATURE_REQUIRED",
+          message: `${features.join(", ")} ${features.length === 1 ? "requires" : "require"} server output, but this is a static build.`,
+          severity: "error",
+          suggestion: kind === "static" ? 'Set deployment to a host adapter from "blume/deploy" in blume.config.ts, e.g. `deployment: vercel()`.' : `Drop \`output: "static"\` from \`deployment: ${kind}()\` in blume.config.ts to build for the server.`
+        }
+      ], 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. ` : "";
+  const optIn = options.strictOptIn ?? options.mode === "dev";
+  if (hadErrors && options.strict) {
+    logger.error(`Aborting due to errors. ${dropped}Fix the diagnostics above, or ${optIn ? "drop --strict" : "pass --no-strict"} to continue despite them.`);
+    process.exit(1);
+  }
+  if (hasErrors(project.diagnostics) && !options.strict) {
+    logger.warn(`Continuing despite errors. ${dropped}${optIn ? "Pass --strict" : "Drop --no-strict"} to fail instead.`);
+  }
+  let warnings;
+  try {
+    ({ warnings } = await generateRuntime(project));
+  } catch (error) {
+    if (error instanceof BlumeError) {
+      reportDiagnostics([error.diagnostic], options.root);
+      process.exit(1);
+    }
+    throw error;
+  }
+  for (const warning of warnings) {
+    logger.warn(warning);
+  }
+  reportDiagnostics(checkRequiredSecrets(project.config), options.root);
+  return project;
+};
+
+export { prepareProject };
+
+//# debugId=28CF8258A34C9DAE64756E2164756E21
+//# sourceMappingURL=chunk-zxh4d9vy.js.map

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

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/yarn-pnp.ts", "../src/cli/prepare.ts"],
+  "sourcesContent": [
+    "import { existsSync } from \"node:fs\";\n\nimport { dirname, join } from \"pathe\";\n\nimport { packageDirFrom } from \"../astro/render-deps.ts\";\nimport type { Diagnostic } from \"../core/types.ts\";\n\n/** Whether `root` or one of its ancestors holds a Yarn Plug'n'Play manifest. */\nconst hasPnpManifest = (root: string): boolean => {\n  let dir = root;\n  while (true) {\n    if (existsSync(join(dir, \".pnp.cjs\")) || existsSync(join(dir, \".pnp.js\"))) {\n      return true;\n    }\n    const parent = dirname(dir);\n    if (parent === dir) {\n      return false;\n    }\n    dir = parent;\n  }\n};\n\n/**\n * The diagnostic for a project installed with Yarn Plug'n'Play, or null.\n *\n * Plug'n'Play installs no `node_modules`, and the Astro project Blume\n * generates in `.blume/` imports Astro and Blume's dependencies by name, which\n * only a `node_modules` tree resolves — so under PnP the build dies loading\n * `astro/config`, a failure that reads like a bug in Blume. Caught up front\n * instead: when the command runs under the PnP runtime (`process.versions.pnp`,\n * set by `yarn run`), or when a `.pnp.cjs` manifest sits in the project with no\n * `node_modules` copy of Blume beside it.\n */\nexport const yarnPnpDiagnostic = (\n  root: string,\n  pnpVersion: string | undefined = process.versions.pnp\n): Diagnostic | null => {\n  const underPnp =\n    pnpVersion !== undefined ||\n    (hasPnpManifest(root) && packageDirFrom(\"blume\", root) === null);\n  if (!underPnp) {\n    return null;\n  }\n  return {\n    code: \"BLUME_YARN_PNP\",\n    message:\n      \"Yarn Plug'n'Play isn't supported: the Astro project Blume generates in `.blume/` resolves Astro and Blume's dependencies from a `node_modules` folder, which Plug'n'Play doesn't create.\",\n    severity: \"error\",\n    suggestion:\n      \"Add `nodeLinker: node-modules` to `.yarnrc.yml`, run `yarn install`, then run this command again.\",\n  };\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\";\nimport { yarnPnpDiagnostic } from \"./yarn-pnp.ts\";\n\nexport interface PrepareOptions {\n  root: string;\n  mode?: BuildMode;\n  strict?: boolean;\n  /**\n   * Whether the command is strict only on request (`blume check --strict`),\n   * which changes how the abort message says to continue. Defaults to true in\n   * dev mode (`blume dev`, `blume sync`) and false otherwise, where strict is\n   * the default a user turns off with `--no-strict` (`blume build`).\n   */\n  strictOptIn?: 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  // Under Yarn Plug'n'Play the generated runtime can't resolve anything; say\n  // so before scanning, instead of failing inside Astro's config load.\n  const pnp = yarnPnpDiagnostic(options.root);\n  if (pnp) {\n    reportDiagnostics([pnp], options.root);\n    process.exit(1);\n  }\n\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.options.output === \"static\"\n  ) {\n    const features = serverFeatures(project.config);\n    if (features.length > 0) {\n      // A host adapter already names the target, so only its\n      // `output: \"static\"` stands in the way; otherwise name one.\n      const { kind } = project.config.deployment;\n      reportDiagnostics(\n        [\n          {\n            code: \"BLUME_SERVER_FEATURE_REQUIRED\",\n            message: `${features.join(\", \")} ${features.length === 1 ? \"requires\" : \"require\"} server output, but this is a static build.`,\n            severity: \"error\",\n            suggestion:\n              kind === \"static\"\n                ? 'Set deployment to a host adapter from \"blume/deploy\" in blume.config.ts, e.g. `deployment: vercel()`.'\n                : `Drop \\`output: \"static\"\\` from \\`deployment: ${kind}()\\` in blume.config.ts to build for the server.`,\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  const optIn = options.strictOptIn ?? options.mode === \"dev\";\n  if (hadErrors && options.strict) {\n    logger.error(\n      `Aborting due to errors. ${dropped}Fix the diagnostics above, or ${optIn ? \"drop --strict\" : \"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}${optIn ? \"Pass --strict\" : \"Drop --no-strict\"} to fail instead.`\n    );\n  }\n\n  let warnings: string[];\n  try {\n    ({ warnings } = await generateRuntime(project));\n  } catch (error) {\n    // A config error the generator raised (an unplannable `components.ts`\n    // override, a missing font file) is the user's to fix, not an internal\n    // failure: report the diagnostic and stop, like a scan-time error.\n    if (error instanceof BlumeError) {\n      reportDiagnostics([error.diagnostic], options.root);\n      process.exit(1);\n    }\n    throw error;\n  }\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": "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",
+  "debugId": "28CF8258A34C9DAE64756E2164756E21",
+  "names": []
+}

package/dist/cli/index.js

@@ -79,6 +79,10 @@ var commandMeta = {
     description: "Serve an MCP data snapshot over stdio (internal, used by `blume eval`).",
     name: "mcp-stdio"
   },
+  migrate: {
+    description: "Migrate a docs site from Mintlify, Fumadocs, Docusaurus, Starlight, or Nextra with a coding agent.",
+    name: "migrate"
+  },
   preview: {
     description: "Preview the last production build.",
     name: "preview"
@@ -91,6 +95,10 @@ var commandMeta = {
     description: "Translate docs into the configured locales with a local agent CLI.",
     name: "translate"
   },
+  upgrade: {
+    description: "Upgrade to this version of Blume: bump the dependency and list the config changes left.",
+    name: "upgrade"
+  },
   validate: {
     description: "Validate internal, anchor, asset, and external links.",
     name: "validate"
@@ -160,37 +168,6 @@ var reportInternalError = (error) => {
 `);
 };
 
-// src/cli/lazy-command.ts
-var lazyCommand = (meta, load, key) => {
-  const command = async () => {
-    const module = await load();
-    return module[key];
-  };
-  return {
-    args: async () => {
-      const { args } = await command();
-      return args;
-    },
-    cleanup: async (context) => {
-      const loaded = await command();
-      await loaded.cleanup?.(context);
-    },
-    meta,
-    run: async (context) => {
-      const loaded = await command();
-      await loaded.run?.(context);
-    },
-    setup: async (context) => {
-      const loaded = await command();
-      await loaded.setup?.(context);
-    }
-  };
-};
-
-// src/cli/log.ts
-import { consola } from "consola";
-import { relative as relative2 } from "pathe";
-
 // src/core/diagnostics.ts
 import { colors as colors2 } from "consola/utils";
 import { relative } from "pathe";
@@ -205,25 +182,28 @@ class BlumeError extends Error {
 }
 var DOCS_BASE = "https://useblume.dev";
 var DOCS_DEPLOYMENT = "/docs/deployment";
-var DOCS_REFERENCE_CLI = "/docs/reference/cli";
+var DOCS_CLI_VALIDATE = "/docs/cli/validate";
 var DOCS_CONTENT_SOURCES = "/docs/content/sources";
 var DOCS_CONTENT_NAVIGATION = "/docs/content/navigation";
 var DOCS_CONTENT_INCLUDES = "/docs/content/includes";
 var DOCS_PATHS = new Map(Object.entries({
   BLUME_ADAPTER_REQUIRED: DOCS_DEPLOYMENT,
-  BLUME_ASSETS_UNCHECKED: DOCS_REFERENCE_CLI,
+  BLUME_ASSETS_UNCHECKED: DOCS_CLI_VALIDATE,
   BLUME_ASSET_FETCH_FAILED: DOCS_CONTENT_SOURCES,
-  BLUME_BROKEN_ANCHOR: DOCS_REFERENCE_CLI,
-  BLUME_BROKEN_ASSET: DOCS_REFERENCE_CLI,
-  BLUME_BROKEN_LINK: DOCS_REFERENCE_CLI,
+  BLUME_BROKEN_ANCHOR: DOCS_CLI_VALIDATE,
+  BLUME_BROKEN_ASSET: DOCS_CLI_VALIDATE,
+  BLUME_BROKEN_LINK: DOCS_CLI_VALIDATE,
+  BLUME_COMPONENTS_INVALID: "/docs/configuration/customization",
   BLUME_CONFIG_INVALID: "/docs/configuration",
   BLUME_CONFIG_LOAD_FAILED: "/docs/configuration",
   BLUME_CONTENT_ROOT_MISSING: DOCS_CONTENT_SOURCES,
-  BLUME_DEAD_LINK: DOCS_REFERENCE_CLI,
+  BLUME_DEAD_LINK: DOCS_CLI_VALIDATE,
+  BLUME_DEPENDENCY_MISSING: "/docs/cli/doctor",
   BLUME_DUPLICATE_ROUTE: DOCS_CONTENT_NAVIGATION,
   BLUME_DUPLICATE_SIDEBAR_ORDER: DOCS_CONTENT_NAVIGATION,
-  BLUME_FRONTMATTER_INVALID: "/docs/reference/frontmatter",
+  BLUME_FRONTMATTER_INVALID: "/docs/content/frontmatter",
   BLUME_INCLUDE_CYCLE: DOCS_CONTENT_INCLUDES,
+  BLUME_INCLUDE_MALFORMED: DOCS_CONTENT_INCLUDES,
   BLUME_INCLUDE_NOT_FOUND: DOCS_CONTENT_INCLUDES,
   BLUME_INCLUDE_OUTSIDE_ROOT: DOCS_CONTENT_INCLUDES,
   BLUME_MDX_CURLY_ANCHOR: "/docs/content/syntax",
@@ -242,10 +222,14 @@ var DOCS_PATHS = new Map(Object.entries({
   BLUME_SOURCE_OFFLINE: DOCS_CONTENT_SOURCES,
   BLUME_SOURCE_SDK_MISSING: DOCS_CONTENT_SOURCES,
   BLUME_SOURCE_UNAVAILABLE: DOCS_CONTENT_SOURCES,
+  BLUME_TRANSLATE_MISSING: "/docs/cli/translate",
+  BLUME_TRANSLATE_STALE: "/docs/cli/translate",
   BLUME_UNKNOWN_COMPONENT: "/docs/configuration/customization",
   BLUME_UNKNOWN_ICON: DOCS_CONTENT_NAVIGATION,
+  BLUME_UNKNOWN_OPTION: "/docs/cli",
   BLUME_WIKILINK_AMBIGUOUS: DOCS_CONTENT_SOURCES,
-  BLUME_WIKILINK_UNRESOLVED: DOCS_CONTENT_SOURCES
+  BLUME_WIKILINK_UNRESOLVED: DOCS_CONTENT_SOURCES,
+  BLUME_YARN_PNP: "/docs/quickstart"
 }));
 var resolveDocsUrl = (code) => {
   const path = DOCS_PATHS.get(code);
@@ -358,6 +342,8 @@ var countBySeverity = (diagnostics) => {
 };
 
 // src/cli/log.ts
+import { consola } from "consola";
+import { relative as relative2 } from "pathe";
 var logger = consola.withTag("blume");
 var flushStdout = () => new Promise((resolve) => {
   process.stdout.write("", () => resolve());
@@ -392,29 +378,198 @@ ${summary}
   return hasErrors(diagnostics);
 };
 
+// src/cli/unknown-flags.ts
+var kebabCase = (name) => name.replaceAll(/(?<upper>[A-Z])/gu, (letter) => `-${letter.toLowerCase()}`);
+var camelCase = (name) => name.replaceAll(/-(?<letter>[a-z])/gu, (match) => match.slice(1).toUpperCase());
+var aliasesOf = (alias) => {
+  if (alias === undefined) {
+    return [];
+  }
+  return Array.isArray(alias) ? alias : [alias];
+};
+var knownFlags = (argsDef) => {
+  const flags = new Map;
+  for (const [name, def] of Object.entries(argsDef)) {
+    if (def.type === "positional") {
+      continue;
+    }
+    const kebab = kebabCase(name);
+    const boolean = def.type === "boolean";
+    const onByDefault = boolean && "default" in def && def.default === true;
+    const flag = {
+      boolean,
+      display: onByDefault ? `--no-${kebab}` : `--${kebab}`,
+      name: kebab,
+      takesValue: def.type === "string" || def.type === "enum"
+    };
+    for (const spelling of [
+      name,
+      kebabCase(name),
+      camelCase(name),
+      ...aliasesOf("alias" in def ? def.alias : undefined)
+    ]) {
+      flags.set(spelling, flag);
+    }
+  }
+  return flags;
+};
+var distance = (from, to) => {
+  let previous = Array.from({ length: to.length + 1 }, (_, index) => index);
+  for (const [row, fromChar] of [...from].entries()) {
+    const current = [row + 1];
+    for (const [column, toChar] of [...to].entries()) {
+      current.push(Math.min((previous[column + 1] ?? 0) + 1, (current[column] ?? 0) + 1, (previous[column] ?? 0) + (fromChar === toChar ? 0 : 1)));
+    }
+    previous = current;
+  }
+  return previous[to.length] ?? 0;
+};
+var closestMatch = (name, candidates) => {
+  let best;
+  for (const candidate of candidates) {
+    const edits = distance(name, candidate);
+    if (edits <= 2 && edits * 2 < candidate.length && (best === undefined || edits < best.edits)) {
+      best = { candidate, edits };
+    }
+  }
+  return best?.candidate;
+};
+var parseToken = (arg) => {
+  const long = arg.startsWith("--");
+  const [name = ""] = arg.slice(long ? 2 : 1).split("=");
+  return {
+    hasValue: arg.includes("="),
+    long,
+    name,
+    negated: long && name.startsWith("no-") ? name.slice(3) : undefined
+  };
+};
+var declaredWidth = (token, flags) => {
+  const known = flags.get(token.name) ?? (token.negated === undefined ? undefined : flags.get(token.negated));
+  if (known) {
+    return known.takesValue && !token.hasValue && token.negated === undefined ? 1 : 0;
+  }
+  const grouped = !token.long && token.name.length > 1 && [...token.name].every((letter) => flags.get(letter)?.takesValue === false);
+  return grouped ? 0 : undefined;
+};
+var describeUnknown = (token, flags) => {
+  const unknown = {
+    flag: `${token.long ? "--" : "-"}${token.name}`
+  };
+  const names = [...new Set([...flags.values()].map((flag) => flag.name))];
+  const match = closestMatch(token.negated ?? token.name, names);
+  if (match) {
+    const negate = token.negated !== undefined && flags.get(match)?.boolean;
+    unknown.suggestion = negate ? `--no-${match}` : `--${match}`;
+  }
+  return unknown;
+};
+var unknownFlags = (rawArgs, argsDef, accepted = []) => {
+  const flags = knownFlags(argsDef);
+  const unknown = [];
+  for (let index = 0;index < rawArgs.length; index += 1) {
+    const arg = rawArgs[index] ?? "";
+    if (arg === "--") {
+      break;
+    }
+    if (!arg.startsWith("-") || arg === "-") {
+      continue;
+    }
+    const token = parseToken(arg);
+    const width = declaredWidth(token, flags);
+    if (width !== undefined) {
+      index += width;
+    } else if (!accepted.includes(token.negated ?? token.name)) {
+      unknown.push(describeUnknown(token, flags));
+    }
+  }
+  return unknown;
+};
+var COMMAND_HANDLED_FLAGS = new Map([
+  ["build", ["adapter", "output", "base"]]
+]);
+var unknownFlagsDiagnostic = (command, unknown, argsDef) => {
+  const listed = unknown.map(({ flag, suggestion }) => suggestion ? `${flag} (did you mean ${suggestion}?)` : flag).join(", ");
+  const declared = [
+    ...new Set([...knownFlags(argsDef).values()].map((flag) => flag.display))
+  ].toSorted();
+  const takes = declared.length > 0 ? `It takes ${declared.join(", ")}.` : "It takes no options.";
+  return {
+    code: "BLUME_UNKNOWN_OPTION",
+    message: `blume ${command} doesn't know ${unknown.length === 1 ? "the option" : "the options"} ${listed}.`,
+    severity: "error",
+    suggestion: `${takes} Run \`blume ${command} --help\` for what each does.`
+  };
+};
+
+// src/cli/lazy-command.ts
+var lazyCommand = (meta, load, key) => {
+  const command = async () => {
+    const module = await load();
+    return module[key];
+  };
+  const name = meta.name ?? key;
+  return {
+    args: async () => {
+      const { args } = await command();
+      return args;
+    },
+    cleanup: async (context) => {
+      const loaded = await command();
+      await loaded.cleanup?.(context);
+    },
+    meta,
+    run: async (context) => {
+      const loaded = await command();
+      try {
+        await loaded.run?.(context);
+      } catch (error) {
+        if (error instanceof BlumeError) {
+          reportDiagnostics([error.diagnostic], process.cwd());
+        } else {
+          reportInternalError(error);
+        }
+        process.exit(1);
+      }
+    },
+    setup: async (context) => {
+      const loaded = await command();
+      const argsDef = loaded.args ?? {};
+      const unknown = unknownFlags(context.rawArgs, argsDef, COMMAND_HANDLED_FLAGS.get(name));
+      if (unknown.length > 0) {
+        reportDiagnostics([unknownFlagsDiagnostic(name, unknown, argsDef)]);
+        process.exit(1);
+      }
+      await loaded.setup?.(context);
+    }
+  };
+};
+
 // src/cli/index.ts
 var main = defineCommand({
   meta: {
-    description: "Markdown-first documentation powered by Astro and Vite.",
+    description: "The open-source docs framework for humans and agents.",
     name: "blume",
     version: getBlumeVersion()
   },
   subCommands: {
-    add: lazyCommand(commandMeta.add, () => import("./chunk-e7f42gdj.js"), "addCommand"),
-    audit: lazyCommand(commandMeta.audit, () => import("./chunk-yg63d42r.js"), "auditCommand"),
-    build: lazyCommand(commandMeta.build, () => import("./chunk-ex56aa81.js"), "buildCommand"),
-    check: lazyCommand(commandMeta.check, () => import("./chunk-rqy0s5wh.js"), "checkCommand"),
-    dev: lazyCommand(commandMeta.dev, () => import("./chunk-cjtn640a.js"), "devCommand"),
-    doctor: lazyCommand(commandMeta.doctor, () => import("./chunk-rz9jmfhz.js"), "doctorCommand"),
-    eject: lazyCommand(commandMeta.eject, () => import("./chunk-5093q3n7.js"), "ejectCommand"),
-    eval: lazyCommand(commandMeta.eval, () => import("./chunk-ahnw3kxw.js"), "evalCommand"),
-    init: lazyCommand(commandMeta.init, () => import("./chunk-5qk08vmp.js"), "initCommand"),
-    "mcp-stdio": lazyCommand(commandMeta["mcp-stdio"], () => import("./chunk-3r45185y.js"), "mcpStdioCommand"),
-    preview: lazyCommand(commandMeta.preview, () => import("./chunk-b27xqwn9.js"), "previewCommand"),
-    sync: lazyCommand(commandMeta.sync, () => import("./chunk-bvwwhd84.js"), "syncCommand"),
-    translate: lazyCommand(commandMeta.translate, () => import("./chunk-5g0w1e2c.js"), "translateCommand"),
-    validate: lazyCommand(commandMeta.validate, () => import("./chunk-97r59kpr.js"), "validateCommand"),
-    version: lazyCommand(commandMeta.version, () => import("./chunk-4x36ddpw.js"), "versionCommand")
+    add: lazyCommand(commandMeta.add, () => import("./chunk-fxypxtvm.js"), "addCommand"),
+    audit: lazyCommand(commandMeta.audit, () => import("./chunk-79jhk4py.js"), "auditCommand"),
+    build: lazyCommand(commandMeta.build, () => import("./chunk-s1p84fyh.js"), "buildCommand"),
+    check: lazyCommand(commandMeta.check, () => import("./chunk-epjnccmv.js"), "checkCommand"),
+    dev: lazyCommand(commandMeta.dev, () => import("./chunk-kdp5q7ke.js"), "devCommand"),
+    doctor: lazyCommand(commandMeta.doctor, () => import("./chunk-6vm74dry.js"), "doctorCommand"),
+    eject: lazyCommand(commandMeta.eject, () => import("./chunk-f2z5v128.js"), "ejectCommand"),
+    eval: lazyCommand(commandMeta.eval, () => import("./chunk-jwyddg7y.js"), "evalCommand"),
+    init: lazyCommand(commandMeta.init, () => import("./chunk-q5163e60.js"), "initCommand"),
+    "mcp-stdio": lazyCommand(commandMeta["mcp-stdio"], () => import("./chunk-yw7dm696.js"), "mcpStdioCommand"),
+    migrate: lazyCommand(commandMeta.migrate, () => import("./chunk-s6jhgk0q.js"), "migrateCommand"),
+    preview: lazyCommand(commandMeta.preview, () => import("./chunk-mb2919y2.js"), "previewCommand"),
+    sync: lazyCommand(commandMeta.sync, () => import("./chunk-fz5wtpmh.js"), "syncCommand"),
+    translate: lazyCommand(commandMeta.translate, () => import("./chunk-kpf8rrjc.js"), "translateCommand"),
+    upgrade: lazyCommand(commandMeta.upgrade, () => import("./chunk-m3vmjgmq.js"), "upgradeCommand"),
+    validate: lazyCommand(commandMeta.validate, () => import("./chunk-ch6g3ar0.js"), "validateCommand"),
+    version: lazyCommand(commandMeta.version, () => import("./chunk-hdpx1tax.js"), "versionCommand")
   }
 });
 loadEnvFiles(process.cwd());
@@ -439,13 +594,15 @@ export {
   locateFrontmatterKey,
   diagnosticsFromIssues,
   diagnosticsFromZod,
+  formatDiagnostic,
   hasErrors,
   countBySeverity,
   logger,
   flushStdout,
   reportDiagnosticsJson,
-  reportDiagnostics
+  reportDiagnostics,
+  closestMatch
 };
 
-//# debugId=3D851F7CCD64619664756E2164756E21
+//# debugId=3B8E364FC63CDED364756E2164756E21
 //# sourceMappingURL=index.js.map