blume 1.7.3 → 2.0.1

package/dist/cli/chunk-s1p84fyh.js

@@ -0,0 +1,261 @@
+#!/usr/bin/env node
+import {
+  commandMeta,
+  logger
+} from "./index.js";
+import {
+  deployPlatform
+} from "./chunk-qkqwkpte.js";
+import"./chunk-jts8mvcz.js";
+import"./chunk-fs23ddbb.js";
+import {
+  publishBuildProject,
+  ogCacheDir,
+  pruneCardCache,
+  cardCacheTally
+} from "./chunk-wgm7m9qk.js";
+import"./chunk-6crbhc3x.js";
+import {
+  deployOutputDir,
+  deployStaticDir,
+  surfaceAdapterOutput
+} from "./chunk-82bbrxdn.js";
+import {
+  ensureGitignore
+} from "./chunk-yzhm0j9q.js";
+import"./chunk-vtk4a6dg.js";
+import {
+  removedBuildFlags,
+  flagList,
+  removedBuildFlagsAdvice
+} from "./chunk-dh8cwk36.js";
+import {
+  refuseIfDevRunning
+} from "./chunk-27g6wdth.js";
+import"./chunk-2hn4b8z7.js";
+import {
+  refuseIfEjected
+} from "./chunk-yt5n7ppj.js";
+import"./chunk-jq5n4avg.js";
+import"./chunk-zxcczpyx.js";
+import"./chunk-wm7js3j9.js";
+import {
+  prepareProject
+} from "./chunk-zxh4d9vy.js";
+import {
+  serverFeatures
+} from "./chunk-ah61y8py.js";
+
+// src/cli/commands/build.ts
+import { existsSync } from "node:fs";
+import { readdir, stat } from "node:fs/promises";
+import { build } from "astro";
+import { defineCommand } from "citty";
+import { join } from "pathe";
+var BUDGET_JS = "budget-js";
+var BUDGET_CSS = "budget-css";
+var validateBudgetFlags = (args) => {
+  for (const flag of [BUDGET_JS, BUDGET_CSS]) {
+    const value = args[flag];
+    const parsed = Number(value);
+    if (value !== undefined && (Number.isNaN(parsed) || parsed <= 0)) {
+      logger.error(`Invalid --${flag} "${value}" (expected a positive number of kB).`);
+      process.exit(1);
+    }
+  }
+};
+var reportCardCache = async (project, prune) => {
+  const cards = cardCacheTally();
+  if (!cards) {
+    return;
+  }
+  logger.info(`OG cards: ${cards.hits} reused from the cache, ${cards.misses} rendered`);
+  if (prune) {
+    await pruneCardCache(ogCacheDir(project.context));
+  }
+};
+var formatBytes = (bytes) => {
+  if (bytes < 1024) {
+    return `${bytes} B`;
+  }
+  const digits = bytes < 1024 * 100 ? 1 : 0;
+  return `${(bytes / 1024).toFixed(digits)} kB`;
+};
+var astroAssets = async (distDir, ext) => {
+  const astroDir = join(distDir, "_astro");
+  if (!existsSync(astroDir)) {
+    return [];
+  }
+  const entries = await readdir(astroDir);
+  const files = entries.filter((name) => name.endsWith(`.${ext}`));
+  const sized = await Promise.all(files.map(async (name) => {
+    const info = await stat(join(astroDir, name));
+    return { name, size: info.size };
+  }));
+  return sized.toSorted((a, b) => b.size - a.size);
+};
+var totalSize = (assets) => assets.reduce((sum, asset) => sum + asset.size, 0);
+var reportBundleSizes = async (distDir) => {
+  const sized = await astroAssets(distDir, "js");
+  if (sized.length === 0) {
+    logger.info("No client JavaScript emitted — the site ships zero JS.");
+    return;
+  }
+  const rows = sized.slice(0, 15).map((file) => `  ${formatBytes(file.size).padStart(8)}  ${file.name}`);
+  logger.box([
+    `Client JavaScript — ${sized.length} file(s), ${formatBytes(totalSize(sized))} total`,
+    "",
+    ...rows,
+    sized.length > 15 ? `  … and ${sized.length - 15} more` : null
+  ].filter((line) => line !== null).join(`
+`));
+};
+var enforceBudget = async (distDir, args) => {
+  const checks = [
+    ...args[BUDGET_JS] ? [{ ext: "js", limitKb: Number(args[BUDGET_JS]), name: "JavaScript" }] : [],
+    ...args[BUDGET_CSS] ? [{ ext: "css", limitKb: Number(args[BUDGET_CSS]), name: "CSS" }] : []
+  ];
+  if (checks.length === 0) {
+    return "skip";
+  }
+  let passed = true;
+  for (const check of checks) {
+    const total = totalSize(await astroAssets(distDir, check.ext));
+    const limit = check.limitKb * 1024;
+    if (total > limit) {
+      passed = false;
+      logger.error(`${check.name} budget exceeded: ${formatBytes(total)} > ${check.limitKb} kB`);
+    } else {
+      logger.success(`${check.name} budget: ${formatBytes(total)} / ${check.limitKb} kB`);
+    }
+  }
+  return passed ? "pass" : "fail";
+};
+var runClientAssetChecks = async (staticDir, args) => {
+  if (args.analyze) {
+    await reportBundleSizes(staticDir);
+  }
+  if (await enforceBudget(staticDir, args) === "fail") {
+    process.exit(1);
+  }
+};
+var reportBuild = async (project, distDir, args) => {
+  const { config } = project;
+  const features = serverFeatures(config);
+  const sitemapNote = config.seo.sitemap ? "no (set deployment.site)" : "no (seo.sitemap is false)";
+  const rows = [
+    ["Output", config.deployment.options.output],
+    ["Adapter", config.deployment.kind],
+    ["Site", config.deployment.options.site ?? "not set"],
+    ["Search", config.search.provider.kind],
+    ["Redirects", config.redirects.length],
+    [
+      "Sitemap",
+      config.deployment.options.site && config.seo.sitemap ? "yes" : sitemapNote
+    ],
+    ["Robots", config.seo.robots ? "yes" : "no"],
+    ["Agent JSON", config.agents.agentReadability ? "yes" : "no"],
+    ["LLM files", config.agents.llmsTxt.enabled ? "yes" : "no"],
+    ["Server features", features.length > 0 ? features.join(", ") : "none"]
+  ];
+  const labelWidth = Math.max(...rows.map(([label]) => label.length)) + 2;
+  logger.box(rows.map(([label, value]) => `${label.padEnd(labelWidth)}${value}`).join(`
+`));
+  await runClientAssetChecks(distDir, args);
+  if (project.droppedPages > 0) {
+    logger.warn(`${project.droppedPages} page(s) failed frontmatter validation and are missing from this build.`);
+  }
+  logger.success(`Built to ${distDir}`);
+};
+var buildCommand = defineCommand({
+  args: {
+    analyze: {
+      description: "Report client JavaScript bundle sizes after the build.",
+      type: "boolean"
+    },
+    [BUDGET_CSS]: {
+      description: "Fail if total client CSS exceeds this many kB.",
+      type: "string"
+    },
+    [BUDGET_JS]: {
+      description: "Fail if total client JavaScript exceeds this many kB.",
+      type: "string"
+    },
+    isolated: {
+      description: "Build into an isolated .blume-verify runtime (and its own dist) so a running dev server and the real dist/ are untouched. For verifying changes while `blume dev` runs.",
+      type: "boolean"
+    },
+    preview: {
+      description: "Include drafts and unpublished CMS content.",
+      type: "boolean"
+    },
+    strict: {
+      default: true,
+      description: "Fail on error diagnostics (default; pass --no-strict to build anyway, dropping pages that fail validation).",
+      type: "boolean"
+    }
+  },
+  meta: commandMeta.build,
+  async run({ args, rawArgs }) {
+    const root = process.cwd();
+    const removed = removedBuildFlags(rawArgs);
+    if (removed.length > 0) {
+      logger.error(`blume build no longer takes ${flagList(removed)}. ${removedBuildFlagsAdvice(removed)}`);
+      process.exit(1);
+    }
+    await refuseIfEjected(root, "build");
+    const runtimeDir = args.isolated ? ".blume-verify" : process.env.BLUME_RUNTIME_DIR;
+    refuseIfDevRunning(root, "building", { isolatedHint: true, runtimeDir });
+    if (args.isolated) {
+      await ensureGitignore(root, [".blume-verify/"]);
+    }
+    validateBudgetFlags(args);
+    const project = await prepareProject({
+      mode: "build",
+      preview: args.preview,
+      root,
+      runtimeDir,
+      strict: args.strict
+    });
+    logger.start(`Building ${project.graph.pages.length} page(s) (${project.config.deployment.options.output} output)`);
+    if (!runtimeDir) {
+      publishBuildProject(project);
+    }
+    await build({
+      logLevel: "info",
+      root: project.context.outDir
+    });
+    await reportCardCache(project, !runtimeDir);
+    const { deployment } = project.config;
+    const platform = deployPlatform(deployment);
+    const server = deployment.options.output === "server";
+    const finalize = async (isolated) => {
+      if (server && platform.finalizeBuild && !await platform.finalizeBuild({ isolated, log: logger, project })) {
+        process.exit(1);
+      }
+    };
+    if (runtimeDir) {
+      await finalize(true);
+      await runClientAssetChecks(deployStaticDir(project.config, project.context), args);
+      logger.success(`Isolated build OK — output at ${deployOutputDir(project.config, project.context)} (not published).`);
+      return;
+    }
+    const { ignoreDir } = platform.hiddenRuntime;
+    if (server && ignoreDir) {
+      await ensureGitignore(root, [ignoreDir]);
+    }
+    const surfaced = await surfaceAdapterOutput(project.config, project.context);
+    if (surfaced.moved) {
+      logger.success(`Surfaced ${deployment.kind} output to ${surfaced.to}`);
+    }
+    await finalize(false);
+    await reportBuild(project, deployStaticDir(project.config, project.context), args);
+  }
+});
+export {
+  buildCommand,
+  runClientAssetChecks
+};
+
+//# debugId=7C559CDFA7F83DB064756E2164756E21
+//# sourceMappingURL=chunk-s1p84fyh.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/build.ts"],
+  "sourcesContent": [
+    "import { existsSync } from \"node:fs\";\nimport { readdir, stat } from \"node:fs/promises\";\n\nimport { build } from \"astro\";\nimport { defineCommand } from \"citty\";\nimport { join } from \"pathe\";\n\nimport { publishBuildProject } from \"../../astro/integration.ts\";\nimport { ensureGitignore } from \"../../core/gitignore.ts\";\nimport type { BlumeProject } from \"../../core/project-graph.ts\";\nimport { serverFeatures } from \"../../core/server-features.ts\";\nimport {\n  deployOutputDir,\n  deployStaticDir,\n  surfaceAdapterOutput,\n} from \"../../deploy/adapter-output.ts\";\nimport { deployPlatform } from \"../../deploy/platforms/index.ts\";\nimport { cardCacheTally, ogCacheDir, pruneCardCache } from \"../../og/cache.ts\";\nimport {\n  flagList,\n  removedBuildFlags,\n  removedBuildFlagsAdvice,\n} from \"../../upgrade/upgrade.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { refuseIfDevRunning } from \"../dev-lock.ts\";\nimport { refuseIfEjected } from \"../eject-scripts.ts\";\nimport { logger } from \"../log.ts\";\nimport { prepareProject } from \"../prepare.ts\";\n\nconst BUDGET_JS = \"budget-js\";\nconst BUDGET_CSS = \"budget-css\";\n\ninterface BudgetArgs {\n  \"budget-css\"?: string;\n  \"budget-js\"?: string;\n}\n\n/**\n * Reject a non-numeric performance budget. `Number(\"250kb\")` is `NaN` and\n * `total > NaN` is always false, so a typo'd flag would silently pass the gate;\n * fail up front instead.\n */\nconst validateBudgetFlags = (args: BudgetArgs): void => {\n  for (const flag of [BUDGET_JS, BUDGET_CSS] as const) {\n    const value = args[flag];\n    const parsed = Number(value);\n    // Equivalent to `!(parsed > 0)` but without the inverted check: this must\n    // also reject `NaN` (a typo'd flag like \"250kb\"), which `parsed <= 0` alone\n    // would let through since `NaN <= 0` is false.\n    if (value !== undefined && (Number.isNaN(parsed) || parsed <= 0)) {\n      logger.error(\n        `Invalid --${flag} \"${value}\" (expected a positive number of kB).`\n      );\n      process.exit(1);\n    }\n  }\n};\n\n/**\n * Report how many OG cards the build read back from the on-disk cache against\n * how many it rendered (the endpoint tallies both), so a warm rebuild shows\n * where the time went. With `prune`, also drop the cached cards this build\n * never asked for — renamed pages, edited descriptions, cards from an earlier\n * Blume version — so a persisted cache holds exactly the current site's cards.\n */\nconst reportCardCache = async (\n  project: BlumeProject,\n  prune: boolean\n): Promise<void> => {\n  const cards = cardCacheTally();\n  if (!cards) {\n    return;\n  }\n  logger.info(\n    `OG cards: ${cards.hits} reused from the cache, ${cards.misses} rendered`\n  );\n  if (prune) {\n    await pruneCardCache(ogCacheDir(project.context));\n  }\n};\n\nconst formatBytes = (bytes: number): string => {\n  if (bytes < 1024) {\n    return `${bytes} B`;\n  }\n  const digits = bytes < 1024 * 100 ? 1 : 0;\n  return `${(bytes / 1024).toFixed(digits)} kB`;\n};\n\n/** Sizes of `dist/_astro/*.<ext>`, largest first (empty when none exist). */\nconst astroAssets = async (\n  distDir: string,\n  ext: string\n): Promise<{ name: string; size: number }[]> => {\n  const astroDir = join(distDir, \"_astro\");\n  if (!existsSync(astroDir)) {\n    return [];\n  }\n  const entries = await readdir(astroDir);\n  const files = entries.filter((name) => name.endsWith(`.${ext}`));\n  const sized = await Promise.all(\n    files.map(async (name) => {\n      const info = await stat(join(astroDir, name));\n      return { name, size: info.size };\n    })\n  );\n  return sized.toSorted((a, b) => b.size - a.size);\n};\n\nconst totalSize = (assets: { size: number }[]): number =>\n  assets.reduce((sum, asset) => sum + asset.size, 0);\n\n/**\n * Print the client JavaScript Astro shipped, largest first, plus the total. A\n * dependency-free bundle report — the interactive weight of a docs site is its\n * `_astro/*.js`, so this surfaces regressions without a visualizer.\n */\nconst reportBundleSizes = async (distDir: string): Promise<void> => {\n  const sized = await astroAssets(distDir, \"js\");\n  if (sized.length === 0) {\n    logger.info(\"No client JavaScript emitted — the site ships zero JS.\");\n    return;\n  }\n  const rows = sized\n    .slice(0, 15)\n    .map((file) => `  ${formatBytes(file.size).padStart(8)}  ${file.name}`);\n  logger.box(\n    [\n      `Client JavaScript — ${sized.length} file(s), ${formatBytes(totalSize(sized))} total`,\n      \"\",\n      ...rows,\n      sized.length > 15 ? `  … and ${sized.length - 15} more` : null,\n    ]\n      .filter((line) => line !== null)\n      .join(\"\\n\")\n  );\n};\n\n/**\n * Enforce a performance budget on the built client assets: fail the build when\n * total `_astro/*.js` (or `*.css`) exceeds the given kB cap. Budgets that would\n * otherwise be \"documented, not measured\" become a real CI gate. Returns whether\n * every budget passed.\n */\nconst enforceBudget = async (\n  distDir: string,\n  args: BudgetArgs\n): Promise<\"fail\" | \"pass\" | \"skip\"> => {\n  const checks: { ext: string; limitKb: number; name: string }[] = [\n    ...(args[BUDGET_JS]\n      ? [{ ext: \"js\", limitKb: Number(args[BUDGET_JS]), name: \"JavaScript\" }]\n      : []),\n    ...(args[BUDGET_CSS]\n      ? [{ ext: \"css\", limitKb: Number(args[BUDGET_CSS]), name: \"CSS\" }]\n      : []),\n  ];\n  if (checks.length === 0) {\n    return \"skip\";\n  }\n  let passed = true;\n  for (const check of checks) {\n    // oxlint-disable-next-line no-await-in-loop -- a couple of sequential reads\n    const total = totalSize(await astroAssets(distDir, check.ext));\n    const limit = check.limitKb * 1024;\n    if (total > limit) {\n      passed = false;\n      logger.error(\n        `${check.name} budget exceeded: ${formatBytes(total)} > ${check.limitKb} kB`\n      );\n    } else {\n      logger.success(\n        `${check.name} budget: ${formatBytes(total)} / ${check.limitKb} kB`\n      );\n    }\n  }\n  return passed ? \"pass\" : \"fail\";\n};\n\n/**\n * Run the optional bundle report (`--analyze`) and performance-budget gate\n * against the directory whose `_astro/` client assets the deploy serves.\n * Shared by real and isolated builds — an isolated CI run passing\n * `--budget-js` must still fail on an exceeded budget rather than silently\n * skipping the check. Exits non-zero when a budget is exceeded.\n */\nexport const runClientAssetChecks = async (\n  staticDir: string,\n  args: { analyze?: boolean } & BudgetArgs\n): Promise<void> => {\n  if (args.analyze) {\n    await reportBundleSizes(staticDir);\n  }\n  if ((await enforceBudget(staticDir, args)) === \"fail\") {\n    process.exit(1);\n  }\n};\n\n/**\n * Print the build summary box and run the optional bundle report / budget\n * gate against the served static dir. The deploy artifacts themselves\n * (search index, llms.txt, sitemap, robots, redirect and header files, …)\n * were written by the integration's `astro:build:done` hook during\n * `build()` — see `deploy/artifacts.ts`. Exits non-zero if a budget is\n * exceeded.\n */\nconst reportBuild = async (\n  project: BlumeProject,\n  distDir: string,\n  args: { analyze?: boolean } & BudgetArgs\n): Promise<void> => {\n  const { config } = project;\n  const features = serverFeatures(config);\n  // The sitemap needs both the flag and a `site` (absolute URLs) — only the\n  // latter deserves the remediation hint.\n  const sitemapNote = config.seo.sitemap\n    ? \"no (set deployment.site)\"\n    : \"no (seo.sitemap is false)\";\n  const rows: [label: string, value: string | number][] = [\n    [\"Output\", config.deployment.options.output],\n    [\"Adapter\", config.deployment.kind],\n    [\"Site\", config.deployment.options.site ?? \"not set\"],\n    [\"Search\", config.search.provider.kind],\n    [\"Redirects\", config.redirects.length],\n    [\n      \"Sitemap\",\n      config.deployment.options.site && config.seo.sitemap\n        ? \"yes\"\n        : sitemapNote,\n    ],\n    [\"Robots\", config.seo.robots ? \"yes\" : \"no\"],\n    [\"Agent JSON\", config.agents.agentReadability ? \"yes\" : \"no\"],\n    [\"LLM files\", config.agents.llmsTxt.enabled ? \"yes\" : \"no\"],\n    [\"Server features\", features.length > 0 ? features.join(\", \") : \"none\"],\n  ];\n  // One label column for every row, sized by the longest label.\n  const labelWidth = Math.max(...rows.map(([label]) => label.length)) + 2;\n  logger.box(\n    rows\n      .map(([label, value]) => `${label.padEnd(labelWidth)}${value}`)\n      .join(\"\\n\")\n  );\n\n  await runClientAssetChecks(distDir, args);\n\n  // Only reachable with --no-strict (strict aborts earlier): repeat the missing\n  // count next to the success banner so it can't scroll away unseen.\n  if (project.droppedPages > 0) {\n    logger.warn(\n      `${project.droppedPages} page(s) failed frontmatter validation and are missing from this build.`\n    );\n  }\n  logger.success(`Built to ${distDir}`);\n};\n\nexport const buildCommand = defineCommand({\n  args: {\n    analyze: {\n      description: \"Report client JavaScript bundle sizes after the build.\",\n      type: \"boolean\",\n    },\n    [BUDGET_CSS]: {\n      description: \"Fail if total client CSS exceeds this many kB.\",\n      type: \"string\",\n    },\n    [BUDGET_JS]: {\n      description: \"Fail if total client JavaScript exceeds this many kB.\",\n      type: \"string\",\n    },\n    isolated: {\n      description:\n        \"Build into an isolated .blume-verify runtime (and its own dist) so a running dev server and the real dist/ are untouched. For verifying changes while `blume dev` runs.\",\n      type: \"boolean\",\n    },\n    preview: {\n      description: \"Include drafts and unpublished CMS content.\",\n      type: \"boolean\",\n    },\n    strict: {\n      default: true,\n      description:\n        \"Fail on error diagnostics (default; pass --no-strict to build anyway, dropping pages that fail validation).\",\n      type: \"boolean\",\n    },\n  },\n  meta: commandMeta.build,\n  async run({ args, rawArgs }) {\n    const root = process.cwd();\n\n    // citty accepts unknown flags, so a Blume 1 `--adapter vercel --output\n    // server` would otherwise build a static site without a word.\n    const removed = removedBuildFlags(rawArgs);\n    if (removed.length > 0) {\n      logger.error(\n        `blume build no longer takes ${flagList(removed)}. ${removedBuildFlagsAdvice(removed)}`\n      );\n      process.exit(1);\n    }\n    await refuseIfEjected(root, \"build\");\n\n    // `--isolated` (or BLUME_RUNTIME_DIR) relocates the whole runtime to a\n    // sibling dir so this build never touches a live dev server's `.blume/` or\n    // the user's real `dist/`. A non-default runtime dir has no dev lock, so the\n    // refusal below lets it proceed; a plain build still refuses.\n    const runtimeDir = args.isolated\n      ? \".blume-verify\"\n      : process.env.BLUME_RUNTIME_DIR;\n    refuseIfDevRunning(root, \"building\", { isolatedHint: true, runtimeDir });\n    if (args.isolated) {\n      await ensureGitignore(root, [\".blume-verify/\"]);\n    }\n\n    validateBudgetFlags(args);\n\n    const project = await prepareProject({\n      mode: \"build\",\n      preview: args.preview,\n      root,\n      runtimeDir,\n      strict: args.strict,\n    });\n\n    logger.start(\n      `Building ${project.graph.pages.length} page(s) (${project.config.deployment.options.output} output)`\n    );\n\n    // Hand the scanned project to the integration: its `astro:build:done`\n    // hook writes the deploy artifacts (search index, llms.txt, sitemap, …)\n    // into Astro's client output during the build. An isolated build is a\n    // throwaway verify that only needs to confirm the site compiles and\n    // renders, so it publishes nothing — no network post-steps (a hosted\n    // search sync would push), no deploy artifacts.\n    if (!runtimeDir) {\n      publishBuildProject(project);\n    }\n\n    await build({\n      logLevel: \"info\",\n      root: project.context.outDir,\n    });\n\n    // A real build also prunes the cache; an isolated verify must not evict\n    // cards a live dev server is still serving.\n    await reportCardCache(project, !runtimeDir);\n\n    // Everything the deploy target does differently after `astro build` comes\n    // off its platform (see `deploy/platforms/*`): a server build's post-build\n    // step (Vercel's function-bundle audit and negotiation routes, Cloudflare's\n    // wrapper Worker), and where its bundle and static assets landed.\n    const { deployment } = project.config;\n    const platform = deployPlatform(deployment);\n    const server = deployment.options.output === \"server\";\n    const finalize = async (isolated: boolean): Promise<void> => {\n      if (\n        server &&\n        platform.finalizeBuild &&\n        !(await platform.finalizeBuild({ isolated, log: logger, project }))\n      ) {\n        process.exit(1);\n      }\n    };\n\n    // The bundle report and budget gate still run for an isolated build —\n    // `blume build --isolated --budget-js 100` exiting 0 without measuring\n    // anything would be a silent false pass in CI. An isolated build never\n    // surfaces the adapter bundle to the project root, so its output dirs\n    // resolve under the relocated runtime.\n    if (runtimeDir) {\n      await finalize(true);\n      await runClientAssetChecks(\n        deployStaticDir(project.config, project.context),\n        args\n      );\n      logger.success(\n        `Isolated build OK — output at ${deployOutputDir(project.config, project.context)} (not published).`\n      );\n      return;\n    }\n\n    // A server adapter's deploy bundle is a build artifact — keep it out of\n    // version control (Vercel's own CLI ignores `.vercel/` for the same reason).\n    // Ignoring it is independent of whether the bundle had to be moved below:\n    // Vercel writes straight to the project root, Netlify does not.\n    const { ignoreDir } = platform.hiddenRuntime;\n    if (server && ignoreDir) {\n      await ensureGitignore(root, [ignoreDir]);\n    }\n\n    // Netlify writes its deploy bundle relative to the Astro root — which Blume\n    // points at the hidden `.blume` runtime — so the bundle lands where the\n    // deploy platform never looks. Surface it up to the project root before\n    // publishing artifacts into the served static dir.\n    const surfaced = await surfaceAdapterOutput(\n      project.config,\n      project.context\n    );\n    if (surfaced.moved) {\n      logger.success(`Surfaced ${deployment.kind} output to ${surfaced.to}`);\n    }\n\n    await finalize(false);\n\n    await reportBuild(\n      project,\n      deployStaticDir(project.config, project.context),\n      args\n    );\n  },\n});\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AACA;AAEA;AACA;AACA;AAwBA,IAAM,YAAY;AAClB,IAAM,aAAa;AAYnB,IAAM,sBAAsB,CAAC,SAA2B;AAAA,EACtD,WAAW,QAAQ,CAAC,WAAW,UAAU,GAAY;AAAA,IACnD,MAAM,QAAQ,KAAK;AAAA,IACnB,MAAM,SAAS,OAAO,KAAK;AAAA,IAI3B,IAAI,UAAU,cAAc,OAAO,MAAM,MAAM,KAAK,UAAU,IAAI;AAAA,MAChE,OAAO,MACL,aAAa,SAAS,4CACxB;AAAA,MACA,QAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AAAA;AAUF,IAAM,kBAAkB,OACtB,SACA,UACkB;AAAA,EAClB,MAAM,QAAQ,eAAe;AAAA,EAC7B,IAAI,CAAC,OAAO;AAAA,IACV;AAAA,EACF;AAAA,EACA,OAAO,KACL,aAAa,MAAM,+BAA+B,MAAM,iBAC1D;AAAA,EACA,IAAI,OAAO;AAAA,IACT,MAAM,eAAe,WAAW,QAAQ,OAAO,CAAC;AAAA,EAClD;AAAA;AAGF,IAAM,cAAc,CAAC,UAA0B;AAAA,EAC7C,IAAI,QAAQ,MAAM;AAAA,IAChB,OAAO,GAAG;AAAA,EACZ;AAAA,EACA,MAAM,SAAS,QAAQ,OAAO,MAAM,IAAI;AAAA,EACxC,OAAO,IAAI,QAAQ,MAAM,QAAQ,MAAM;AAAA;AAIzC,IAAM,cAAc,OAClB,SACA,QAC8C;AAAA,EAC9C,MAAM,WAAW,KAAK,SAAS,QAAQ;AAAA,EACvC,IAAI,CAAC,WAAW,QAAQ,GAAG;AAAA,IACzB,OAAO,CAAC;AAAA,EACV;AAAA,EACA,MAAM,UAAU,MAAM,QAAQ,QAAQ;AAAA,EACtC,MAAM,QAAQ,QAAQ,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC;AAAA,EAC/D,MAAM,QAAQ,MAAM,QAAQ,IAC1B,MAAM,IAAI,OAAO,SAAS;AAAA,IACxB,MAAM,OAAO,MAAM,KAAK,KAAK,UAAU,IAAI,CAAC;AAAA,IAC5C,OAAO,EAAE,MAAM,MAAM,KAAK,KAAK;AAAA,GAChC,CACH;AAAA,EACA,OAAO,MAAM,SAAS,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI;AAAA;AAGjD,IAAM,YAAY,CAAC,WACjB,OAAO,OAAO,CAAC,KAAK,UAAU,MAAM,MAAM,MAAM,CAAC;AAOnD,IAAM,oBAAoB,OAAO,YAAmC;AAAA,EAClE,MAAM,QAAQ,MAAM,YAAY,SAAS,IAAI;AAAA,EAC7C,IAAI,MAAM,WAAW,GAAG;AAAA,IACtB,OAAO,KAAK,wDAAwD;AAAA,IACpE;AAAA,EACF;AAAA,EACA,MAAM,OAAO,MACV,MAAM,GAAG,EAAE,EACX,IAAI,CAAC,SAAS,KAAK,YAAY,KAAK,IAAI,EAAE,SAAS,CAAC,MAAM,KAAK,MAAM;AAAA,EACxE,OAAO,IACL;AAAA,IACE,uBAAuB,MAAM,mBAAmB,YAAY,UAAU,KAAK,CAAC;AAAA,IAC5E;AAAA,IACA,GAAG;AAAA,IACH,MAAM,SAAS,KAAK,WAAW,MAAM,SAAS,YAAY;AAAA,EAC5D,EACG,OAAO,CAAC,SAAS,SAAS,IAAI,EAC9B,KAAK;AAAA,CAAI,CACd;AAAA;AASF,IAAM,gBAAgB,OACpB,SACA,SACsC;AAAA,EACtC,MAAM,SAA2D;AAAA,IAC/D,GAAI,KAAK,aACL,CAAC,EAAE,KAAK,MAAM,SAAS,OAAO,KAAK,UAAU,GAAG,MAAM,aAAa,CAAC,IACpE,CAAC;AAAA,IACL,GAAI,KAAK,cACL,CAAC,EAAE,KAAK,OAAO,SAAS,OAAO,KAAK,WAAW,GAAG,MAAM,MAAM,CAAC,IAC/D,CAAC;AAAA,EACP;AAAA,EACA,IAAI,OAAO,WAAW,GAAG;AAAA,IACvB,OAAO;AAAA,EACT;AAAA,EACA,IAAI,SAAS;AAAA,EACb,WAAW,SAAS,QAAQ;AAAA,IAE1B,MAAM,QAAQ,UAAU,MAAM,YAAY,SAAS,MAAM,GAAG,CAAC;AAAA,IAC7D,MAAM,QAAQ,MAAM,UAAU;AAAA,IAC9B,IAAI,QAAQ,OAAO;AAAA,MACjB,SAAS;AAAA,MACT,OAAO,MACL,GAAG,MAAM,yBAAyB,YAAY,KAAK,OAAO,MAAM,YAClE;AAAA,IACF,EAAO;AAAA,MACL,OAAO,QACL,GAAG,MAAM,gBAAgB,YAAY,KAAK,OAAO,MAAM,YACzD;AAAA;AAAA,EAEJ;AAAA,EACA,OAAO,SAAS,SAAS;AAAA;AAUpB,IAAM,uBAAuB,OAClC,WACA,SACkB;AAAA,EAClB,IAAI,KAAK,SAAS;AAAA,IAChB,MAAM,kBAAkB,SAAS;AAAA,EACnC;AAAA,EACA,IAAK,MAAM,cAAc,WAAW,IAAI,MAAO,QAAQ;AAAA,IACrD,QAAQ,KAAK,CAAC;AAAA,EAChB;AAAA;AAWF,IAAM,cAAc,OAClB,SACA,SACA,SACkB;AAAA,EAClB,QAAQ,WAAW;AAAA,EACnB,MAAM,WAAW,eAAe,MAAM;AAAA,EAGtC,MAAM,cAAc,OAAO,IAAI,UAC3B,6BACA;AAAA,EACJ,MAAM,OAAkD;AAAA,IACtD,CAAC,UAAU,OAAO,WAAW,QAAQ,MAAM;AAAA,IAC3C,CAAC,WAAW,OAAO,WAAW,IAAI;AAAA,IAClC,CAAC,QAAQ,OAAO,WAAW,QAAQ,QAAQ,SAAS;AAAA,IACpD,CAAC,UAAU,OAAO,OAAO,SAAS,IAAI;AAAA,IACtC,CAAC,aAAa,OAAO,UAAU,MAAM;AAAA,IACrC;AAAA,MACE;AAAA,MACA,OAAO,WAAW,QAAQ,QAAQ,OAAO,IAAI,UACzC,QACA;AAAA,IACN;AAAA,IACA,CAAC,UAAU,OAAO,IAAI,SAAS,QAAQ,IAAI;AAAA,IAC3C,CAAC,cAAc,OAAO,OAAO,mBAAmB,QAAQ,IAAI;AAAA,IAC5D,CAAC,aAAa,OAAO,OAAO,QAAQ,UAAU,QAAQ,IAAI;AAAA,IAC1D,CAAC,mBAAmB,SAAS,SAAS,IAAI,SAAS,KAAK,IAAI,IAAI,MAAM;AAAA,EACxE;AAAA,EAEA,MAAM,aAAa,KAAK,IAAI,GAAG,KAAK,IAAI,EAAE,WAAW,MAAM,MAAM,CAAC,IAAI;AAAA,EACtE,OAAO,IACL,KACG,IAAI,EAAE,OAAO,WAAW,GAAG,MAAM,OAAO,UAAU,IAAI,OAAO,EAC7D,KAAK;AAAA,CAAI,CACd;AAAA,EAEA,MAAM,qBAAqB,SAAS,IAAI;AAAA,EAIxC,IAAI,QAAQ,eAAe,GAAG;AAAA,IAC5B,OAAO,KACL,GAAG,QAAQ,qFACb;AAAA,EACF;AAAA,EACA,OAAO,QAAQ,YAAY,SAAS;AAAA;AAG/B,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,SAAS;AAAA,MACP,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,KACC,aAAa;AAAA,MACZ,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,KACC,YAAY;AAAA,MACX,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,IACA,UAAU;AAAA,MACR,aACE;AAAA,MACF,MAAM;AAAA,IACR;AAAA,IACA,SAAS;AAAA,MACP,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,IACA,QAAQ;AAAA,MACN,SAAS;AAAA,MACT,aACE;AAAA,MACF,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,MAAM,YAAY;AAAA,OACZ,IAAG,GAAG,MAAM,WAAW;AAAA,IAC3B,MAAM,OAAO,QAAQ,IAAI;AAAA,IAIzB,MAAM,UAAU,kBAAkB,OAAO;AAAA,IACzC,IAAI,QAAQ,SAAS,GAAG;AAAA,MACtB,OAAO,MACL,+BAA+B,SAAS,OAAO,MAAM,wBAAwB,OAAO,GACtF;AAAA,MACA,QAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,IACA,MAAM,gBAAgB,MAAM,OAAO;AAAA,IAMnC,MAAM,aAAa,KAAK,WACpB,kBACA,QAAQ,IAAI;AAAA,IAChB,mBAAmB,MAAM,YAAY,EAAE,cAAc,MAAM,WAAW,CAAC;AAAA,IACvE,IAAI,KAAK,UAAU;AAAA,MACjB,MAAM,gBAAgB,MAAM,CAAC,gBAAgB,CAAC;AAAA,IAChD;AAAA,IAEA,oBAAoB,IAAI;AAAA,IAExB,MAAM,UAAU,MAAM,eAAe;AAAA,MACnC,MAAM;AAAA,MACN,SAAS,KAAK;AAAA,MACd;AAAA,MACA;AAAA,MACA,QAAQ,KAAK;AAAA,IACf,CAAC;AAAA,IAED,OAAO,MACL,YAAY,QAAQ,MAAM,MAAM,mBAAmB,QAAQ,OAAO,WAAW,QAAQ,gBACvF;AAAA,IAQA,IAAI,CAAC,YAAY;AAAA,MACf,oBAAoB,OAAO;AAAA,IAC7B;AAAA,IAEA,MAAM,MAAM;AAAA,MACV,UAAU;AAAA,MACV,MAAM,QAAQ,QAAQ;AAAA,IACxB,CAAC;AAAA,IAID,MAAM,gBAAgB,SAAS,CAAC,UAAU;AAAA,IAM1C,QAAQ,eAAe,QAAQ;AAAA,IAC/B,MAAM,WAAW,eAAe,UAAU;AAAA,IAC1C,MAAM,SAAS,WAAW,QAAQ,WAAW;AAAA,IAC7C,MAAM,WAAW,OAAO,aAAqC;AAAA,MAC3D,IACE,UACA,SAAS,iBACT,CAAE,MAAM,SAAS,cAAc,EAAE,UAAU,KAAK,QAAQ,QAAQ,CAAC,GACjE;AAAA,QACA,QAAQ,KAAK,CAAC;AAAA,MAChB;AAAA;AAAA,IAQF,IAAI,YAAY;AAAA,MACd,MAAM,SAAS,IAAI;AAAA,MACnB,MAAM,qBACJ,gBAAgB,QAAQ,QAAQ,QAAQ,OAAO,GAC/C,IACF;AAAA,MACA,OAAO,QACL,iCAAiC,gBAAgB,QAAQ,QAAQ,QAAQ,OAAO,oBAClF;AAAA,MACA;AAAA,IACF;AAAA,IAMA,QAAQ,cAAc,SAAS;AAAA,IAC/B,IAAI,UAAU,WAAW;AAAA,MACvB,MAAM,gBAAgB,MAAM,CAAC,SAAS,CAAC;AAAA,IACzC;AAAA,IAMA,MAAM,WAAW,MAAM,qBACrB,QAAQ,QACR,QAAQ,OACV;AAAA,IACA,IAAI,SAAS,OAAO;AAAA,MAClB,OAAO,QAAQ,YAAY,WAAW,kBAAkB,SAAS,IAAI;AAAA,IACvE;AAAA,IAEA,MAAM,SAAS,KAAK;AAAA,IAEpB,MAAM,YACJ,SACA,gBAAgB,QAAQ,QAAQ,QAAQ,OAAO,GAC/C,IACF;AAAA;AAEJ,CAAC;",
+  "debugId": "7C559CDFA7F83DB064756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-s6jhgk0q.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+import {
+  packageRoot,
+  getBlumeVersion,
+  commandMeta,
+  reportInternalError,
+  logger
+} from "./index.js";
+import {
+  AGENTS,
+  launchInstalledAgent
+} from "./chunk-qwsrynx5.js";
+
+// src/cli/commands/migrate.ts
+import { defineCommand } from "citty";
+import { join as join2 } from "pathe";
+
+// src/migrate/migrate.ts
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join } from "pathe";
+var MIGRATE_SOURCES = [
+  "mintlify",
+  "fumadocs",
+  "docusaurus",
+  "starlight",
+  "nextra"
+];
+var MIGRATE_SOURCE_NAMES = {
+  docusaurus: "Docusaurus",
+  fumadocs: "Fumadocs",
+  mintlify: "Mintlify",
+  nextra: "Nextra",
+  starlight: "Starlight"
+};
+var MIGRATE_SKILL_DIR = join("skills", "blume-migrate");
+var isMigrateSource = (value) => MIGRATE_SOURCES.some((source) => source === value);
+var dependencyNames = async (root) => {
+  const path = join(root, "package.json");
+  if (!existsSync(path)) {
+    return new Set;
+  }
+  try {
+    const pkg = JSON.parse(await readFile(path, "utf-8"));
+    return new Set([
+      ...Object.keys(pkg.dependencies ?? {}),
+      ...Object.keys(pkg.devDependencies ?? {})
+    ]);
+  } catch {
+    return new Set;
+  }
+};
+var SIGNALS = [
+  { files: ["docs.json", "mint.json"], source: "mintlify" },
+  {
+    files: [
+      "docusaurus.config.ts",
+      "docusaurus.config.js",
+      "docusaurus.config.mjs",
+      "docusaurus.config.cjs"
+    ],
+    source: "docusaurus"
+  },
+  {
+    deps: ["fumadocs-core", "fumadocs-ui", "fumadocs-mdx"],
+    files: ["source.config.ts"],
+    source: "fumadocs"
+  },
+  { deps: ["nextra"], source: "nextra" },
+  { deps: ["@astrojs/starlight"], source: "starlight" }
+];
+var detectMigrateSource = async (root) => {
+  const deps = await dependencyNames(root);
+  for (const { deps: tells = [], files = [], source } of SIGNALS) {
+    const file = files.find((name) => existsSync(join(root, name)));
+    if (file) {
+      return { evidence: file, source };
+    }
+    const dep = tells.find((name) => deps.has(name));
+    if (dep) {
+      return { evidence: `${dep} in package.json`, source };
+    }
+  }
+  return null;
+};
+var migratePrompt = (options) => {
+  const { detected, skillDir, source, version } = options;
+  const evidence = detected && detected.source === source ? ` (detected from ${detected.evidence})` : "";
+  const sourceLine = source ? `The source is ${MIGRATE_SOURCE_NAMES[source]}${evidence}. Its exact mappings are in ${join(skillDir, "references", `${source}.md`)}.` : `The source framework wasn't detected, so inventory the repo first. If it's ${MIGRATE_SOURCES.map((id) => MIGRATE_SOURCE_NAMES[id]).join(", ")}, read that framework's file in ${join(skillDir, "references")}; otherwise follow the skill's mental model directly.`;
+  return `Migrate this documentation project to Blume ${version}.
+
+Follow the blume-migrate skill: read ${join(skillDir, "SKILL.md")} first and work through its migration workflow. Wherever the skill says \`<skill>\`, it means ${skillDir}.
+
+${sourceLine}
+
+Add \`blume@^${version}\` as the docs package's dependency. Keep every page, and add a redirect for any URL that moves. Report everything you drop or approximate, and run the skill's verification steps before you finish.`;
+};
+
+// src/cli/commands/migrate.ts
+var migrateCommand = defineCommand({
+  args: {
+    claude: {
+      description: "Run the migration with Claude Code.",
+      type: "boolean"
+    },
+    codex: {
+      description: "Run the migration with Codex.",
+      type: "boolean"
+    },
+    source: {
+      description: `The framework to migrate from: ${MIGRATE_SOURCES.join(" | ")}. Detected when omitted.`,
+      required: false,
+      type: "positional"
+    }
+  },
+  meta: commandMeta.migrate,
+  async run({ args }) {
+    const root = process.cwd();
+    const agents = Object.keys(AGENTS).filter((kind) => args[kind]);
+    if (agents.length > 1) {
+      logger.error("Pass at most one of --codex or --claude.");
+      process.exit(1);
+    }
+    const [agent] = agents;
+    if (args.source && !isMigrateSource(args.source)) {
+      logger.error(`Unknown source "${args.source}" (use ${MIGRATE_SOURCES.join(" | ")}). Leave it out to detect the framework, or to migrate from one not listed.`);
+      process.exit(1);
+    }
+    try {
+      const detected = await detectMigrateSource(root);
+      const named = args.source && isMigrateSource(args.source) ? args.source : null;
+      const source = named ?? detected?.source ?? null;
+      process.stderr.write(source ? `  Migrating from ${MIGRATE_SOURCE_NAMES[source]}${named ? "" : ` (detected from ${detected?.evidence})`}.
+` : `  Couldn't detect the docs framework; the agent will inventory the repo first.
+`);
+      if (named && detected && detected.source !== named) {
+        process.stderr.write(`  Warning: this looks like a ${MIGRATE_SOURCE_NAMES[detected.source]} project (${detected.evidence}); migrating from ${MIGRATE_SOURCE_NAMES[named]} as named.
+`);
+      }
+      const skillDir = join2(packageRoot(), MIGRATE_SKILL_DIR);
+      if (!agent) {
+        process.stderr.write(`  blume migrate runs the migration with a coding agent: rerun with --codex or --claude.
+  Using another agent? Point it at ${join2(skillDir, "SKILL.md")},
+  or install the skill where your agent looks for skills: npx skills add haydenbleasel/blume --skill blume-migrate
+`);
+        return;
+      }
+      const cli = AGENTS[agent];
+      process.stderr.write(`  Handing the migration to ${cli.name}…
+
+`);
+      const code = await launchInstalledAgent(cli.bin, migratePrompt({
+        detected,
+        skillDir,
+        source,
+        version: getBlumeVersion()
+      }));
+      if (code === null) {
+        logger.error(`${cli.name} (\`${cli.bin}\`) was not found on PATH. Install it with \`${cli.install}\`.`);
+        process.exit(1);
+      }
+      if (code !== 0) {
+        process.exit(code);
+      }
+    } catch (error) {
+      reportInternalError(error);
+      process.exit(1);
+    }
+  }
+});
+export {
+  migrateCommand
+};
+
+//# debugId=A9196D6CE8B0C0B464756E2164756E21
+//# sourceMappingURL=chunk-s6jhgk0q.js.map

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

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/migrate.ts", "../src/migrate/migrate.ts"],
+  "sourcesContent": [
+    "import { defineCommand } from \"citty\";\nimport { join } from \"pathe\";\n\nimport { AGENTS, launchInstalledAgent } from \"../../audit/agent.ts\";\nimport type { AgentKind } from \"../../audit/agent.ts\";\nimport { packageRoot } from \"../../core/package-root.ts\";\nimport { getBlumeVersion } from \"../../core/version.ts\";\nimport {\n  MIGRATE_SKILL_DIR,\n  MIGRATE_SOURCES,\n  MIGRATE_SOURCE_NAMES,\n  detectMigrateSource,\n  isMigrateSource,\n  migratePrompt,\n} from \"../../migrate/migrate.ts\";\nimport type { MigrateSourceId } from \"../../migrate/migrate.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { reportInternalError } from \"../internal-error.ts\";\nimport { logger } from \"../log.ts\";\n\n/**\n * `blume migrate [source]` — move a docs site from another framework to Blume\n * with a coding agent. Run it through the package runner (`npx blume migrate\n * fumadocs --claude`) in the site being migrated: it names the source (or\n * detects it), then opens Claude Code or Codex on the `blume-migrate` skill\n * bundled in this package, the way `blume audit --claude` hands off its\n * findings. The judgment stays in the skill; the command is the front door.\n * Status lines go straight to stderr: consola drops info-level lines in test\n * and CI environments.\n */\nexport const migrateCommand = defineCommand({\n  args: {\n    claude: {\n      description: \"Run the migration with Claude Code.\",\n      type: \"boolean\",\n    },\n    codex: {\n      description: \"Run the migration with Codex.\",\n      type: \"boolean\",\n    },\n    source: {\n      description: `The framework to migrate from: ${MIGRATE_SOURCES.join(\" | \")}. Detected when omitted.`,\n      required: false,\n      type: \"positional\",\n    },\n  },\n  meta: commandMeta.migrate,\n  async run({ args }) {\n    const root = process.cwd();\n    // SAFETY: AGENTS is a closed record keyed by AgentKind, so its keys are\n    // exactly the agent kinds.\n    const agents = (Object.keys(AGENTS) as AgentKind[]).filter(\n      (kind) => args[kind]\n    );\n    if (agents.length > 1) {\n      logger.error(\"Pass at most one of --codex or --claude.\");\n      process.exit(1);\n    }\n    const [agent] = agents;\n    if (args.source && !isMigrateSource(args.source)) {\n      logger.error(\n        `Unknown source \"${args.source}\" (use ${MIGRATE_SOURCES.join(\" | \")}). Leave it out to detect the framework, or to migrate from one not listed.`\n      );\n      process.exit(1);\n    }\n\n    try {\n      const detected = await detectMigrateSource(root);\n      const named: MigrateSourceId | null =\n        args.source && isMigrateSource(args.source) ? args.source : null;\n      const source = named ?? detected?.source ?? null;\n      process.stderr.write(\n        source\n          ? `  Migrating from ${MIGRATE_SOURCE_NAMES[source]}${named ? \"\" : ` (detected from ${detected?.evidence})`}.\\n`\n          : \"  Couldn't detect the docs framework; the agent will inventory the repo first.\\n\"\n      );\n      // A named source wins, but a repo that looks like another framework is\n      // worth a second look before an agent rewrites it on the wrong mappings.\n      if (named && detected && detected.source !== named) {\n        process.stderr.write(\n          `  Warning: this looks like a ${MIGRATE_SOURCE_NAMES[detected.source]} project (${detected.evidence}); migrating from ${MIGRATE_SOURCE_NAMES[named]} as named.\\n`\n        );\n      }\n      const skillDir = join(packageRoot(), MIGRATE_SKILL_DIR);\n\n      // Without an agent flag the command is the pointer for any other agent:\n      // the bundled skill's path (which lives in a throwaway cache under npx),\n      // plus the install line that puts the skill where agents look for it.\n      if (!agent) {\n        process.stderr.write(\n          `  blume migrate runs the migration with a coding agent: rerun with --codex or --claude.\\n  Using another agent? Point it at ${join(skillDir, \"SKILL.md\")},\\n  or install the skill where your agent looks for skills: npx skills add haydenbleasel/blume --skill blume-migrate\\n`\n        );\n        return;\n      }\n\n      const cli = AGENTS[agent];\n      process.stderr.write(`  Handing the migration to ${cli.name}…\\n\\n`);\n      const code = await launchInstalledAgent(\n        cli.bin,\n        migratePrompt({\n          detected,\n          skillDir,\n          source,\n          version: getBlumeVersion(),\n        })\n      );\n      if (code === null) {\n        logger.error(\n          `${cli.name} (\\`${cli.bin}\\`) was not found on PATH. Install it with \\`${cli.install}\\`.`\n        );\n        process.exit(1);\n      }\n      if (code !== 0) {\n        process.exit(code);\n      }\n    } catch (error) {\n      reportInternalError(error);\n      process.exit(1);\n    }\n  },\n});\n",
+    "import { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\n\nimport { join } from \"pathe\";\n\n/**\n * `blume migrate`'s logic, kept out of the command module so it runs (and is\n * covered) in-process. Migration is judgment work — idiomatic navigation,\n * component rewrites, what to drop — so it stays in the `blume-migrate` skill,\n * shipped inside the package; this module only names the source (from the\n * argument, or detected from the repo's own files) and writes the prompt that\n * points a coding agent at the skill and that source's mappings.\n */\n\n/** The docs frameworks the skill has a mapping reference for. */\nexport const MIGRATE_SOURCES = [\n  \"mintlify\",\n  \"fumadocs\",\n  \"docusaurus\",\n  \"starlight\",\n  \"nextra\",\n] as const;\n\nexport type MigrateSourceId = (typeof MIGRATE_SOURCES)[number];\n\n/** Display names, for messages and the prompt. */\nexport const MIGRATE_SOURCE_NAMES: Record<MigrateSourceId, string> = {\n  docusaurus: \"Docusaurus\",\n  fumadocs: \"Fumadocs\",\n  mintlify: \"Mintlify\",\n  nextra: \"Nextra\",\n  starlight: \"Starlight\",\n};\n\n/** The skill's directory inside the published package. */\nexport const MIGRATE_SKILL_DIR = join(\"skills\", \"blume-migrate\");\n\nexport const isMigrateSource = (value: string): value is MigrateSourceId =>\n  MIGRATE_SOURCES.some((source) => source === value);\n\n/** A detected source and the file or dependency that gave it away. */\nexport interface DetectedSource {\n  evidence: string;\n  source: MigrateSourceId;\n}\n\n/** The slice of `package.json` detection reads. */\ninterface PackageJson {\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n}\n\n/** Every dependency the project's `package.json` names, or none when unreadable. */\nconst dependencyNames = async (root: string): Promise<Set<string>> => {\n  const path = join(root, \"package.json\");\n  if (!existsSync(path)) {\n    return new Set();\n  }\n  try {\n    // SAFETY: package.json is a JSON object; only its dependency maps are read.\n    const pkg = JSON.parse(await readFile(path, \"utf-8\")) as PackageJson;\n    return new Set([\n      ...Object.keys(pkg.dependencies ?? {}),\n      ...Object.keys(pkg.devDependencies ?? {}),\n    ]);\n  } catch {\n    // A malformed package.json is the agent's to deal with; detection just\n    // falls back to the other signals.\n    return new Set();\n  }\n};\n\n/**\n * Each source's tell, in the order the skill's workflow checks them: a config\n * file the framework owns, or a dependency only it installs.\n */\nconst SIGNALS: {\n  deps?: string[];\n  files?: string[];\n  source: MigrateSourceId;\n}[] = [\n  { files: [\"docs.json\", \"mint.json\"], source: \"mintlify\" },\n  {\n    files: [\n      \"docusaurus.config.ts\",\n      \"docusaurus.config.js\",\n      \"docusaurus.config.mjs\",\n      \"docusaurus.config.cjs\",\n    ],\n    source: \"docusaurus\",\n  },\n  {\n    deps: [\"fumadocs-core\", \"fumadocs-ui\", \"fumadocs-mdx\"],\n    files: [\"source.config.ts\"],\n    source: \"fumadocs\",\n  },\n  { deps: [\"nextra\"], source: \"nextra\" },\n  { deps: [\"@astrojs/starlight\"], source: \"starlight\" },\n];\n\n/**\n * Detect the docs framework a project is built on from its own files, or\n * null when nothing gives it away (the skill still migrates any framework,\n * working from its general model instead of a mapping reference).\n */\nexport const detectMigrateSource = async (\n  root: string\n): Promise<DetectedSource | null> => {\n  const deps = await dependencyNames(root);\n  for (const { deps: tells = [], files = [], source } of SIGNALS) {\n    const file = files.find((name) => existsSync(join(root, name)));\n    if (file) {\n      return { evidence: file, source };\n    }\n    const dep = tells.find((name) => deps.has(name));\n    if (dep) {\n      return { evidence: `${dep} in package.json`, source };\n    }\n  }\n  return null;\n};\n\n/**\n * The handoff prompt: follow the skill, where its mappings for this source\n * are, and the few rules worth restating — the target version, and that no\n * page or URL is lost.\n */\nexport const migratePrompt = (options: {\n  detected: DetectedSource | null;\n  skillDir: string;\n  source: MigrateSourceId | null;\n  version: string;\n}): string => {\n  const { detected, skillDir, source, version } = options;\n  const evidence =\n    detected && detected.source === source\n      ? ` (detected from ${detected.evidence})`\n      : \"\";\n  const sourceLine = source\n    ? `The source is ${MIGRATE_SOURCE_NAMES[source]}${evidence}. Its exact mappings are in ${join(skillDir, \"references\", `${source}.md`)}.`\n    : `The source framework wasn't detected, so inventory the repo first. If it's ${MIGRATE_SOURCES.map((id) => MIGRATE_SOURCE_NAMES[id]).join(\", \")}, read that framework's file in ${join(skillDir, \"references\")}; otherwise follow the skill's mental model directly.`;\n  return `Migrate this documentation project to Blume ${version}.\n\nFollow the blume-migrate skill: read ${join(skillDir, \"SKILL.md\")} first and work through its migration workflow. Wherever the skill says \\`<skill>\\`, it means ${skillDir}.\n\n${sourceLine}\n\nAdd \\`blume@^${version}\\` as the docs package's dependency. Keep every page, and add a redirect for any URL that moves. Report everything you drop or approximate, and run the skill's verification steps before you finish.`;\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "A9196D6CE8B0C0B464756E2164756E21",
+  "names": []
+}