blume 2.0.1 → 2.0.3

package/dist/cli/{chunk-ch6g3ar0.js → chunk-p3v96n38.js}

@@ -4,7 +4,7 @@ import {
   customStaticRoutes,
   hasGeneratedChangelog,
   validateLinks
-} from "./chunk-qkqwkpte.js";
+} from "./chunk-pv29h0wf.js";
 import {
   commandMeta,
   reportInternalError,
@@ -14,11 +14,11 @@ import {
   reportDiagnosticsJson,
   reportDiagnostics
 } from "./index.js";
-import"./chunk-jts8mvcz.js";
+import"./chunk-3em5wd2y.js";
 import {
   buildManifest,
   scanProject
-} from "./chunk-fs23ddbb.js";
+} from "./chunk-j85vccga.js";
 
 // src/cli/commands/validate.ts
 import { existsSync } from "node:fs";
@@ -90,7 +90,7 @@ var validateCommand = defineCommand({
       logger.success("No broken links found.");
     }
     if (hadErrors || strictFailure) {
-      process.exit(1);
+      process.exitCode = 1;
     }
   }
 });
@@ -98,5 +98,5 @@ export {
   validateCommand
 };
 
-//# debugId=1EEBE4960D9C18F364756E2164756E21
-//# sourceMappingURL=chunk-ch6g3ar0.js.map
+//# debugId=B6F7C40ED16163B464756E2164756E21
+//# sourceMappingURL=chunk-p3v96n38.js.map

package/dist/cli/{chunk-ch6g3ar0.js.map → chunk-p3v96n38.js.map}

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/cli/commands/validate.ts"],
   "sourcesContent": [
-    "import { existsSync } from \"node:fs\";\n\nimport { defineCommand } from \"citty\";\nimport { join } from \"pathe\";\n\nimport {\n  customStaticRoutes,\n  discoverPages,\n  hasGeneratedChangelog,\n} from \"../../astro/pages.ts\";\nimport { BlumeError } from \"../../core/diagnostics.ts\";\nimport { validateLinks } from \"../../core/links.ts\";\nimport { buildManifest } from \"../../core/manifest.ts\";\nimport { scanProject } from \"../../core/project-graph.ts\";\nimport type { Diagnostic } from \"../../core/types.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { reportInternalError } from \"../internal-error.ts\";\nimport {\n  flushStdout,\n  logger,\n  reportDiagnostics,\n  reportDiagnosticsJson,\n} from \"../log.ts\";\n\nexport const validateCommand = defineCommand({\n  args: {\n    external: {\n      description: \"Check external (HTTP) links over the network.\",\n      type: \"boolean\",\n    },\n    json: {\n      description: \"Emit diagnostics as JSON on stdout (for CI/editors).\",\n      type: \"boolean\",\n    },\n    strict: {\n      description: \"Treat warnings as errors.\",\n      type: \"boolean\",\n    },\n  },\n  meta: commandMeta.validate,\n  async run({ args }) {\n    const root = process.cwd();\n    const diagnostics: Diagnostic[] = [];\n\n    try {\n      const project = await scanProject(root, { mode: \"build\" });\n      // Surface content/graph problems too: a page that fails to parse is a\n      // link-validation blind spot, so silently passing would be misleading.\n      diagnostics.push(...project.diagnostics);\n\n      // Custom `.astro` pages and the generated changelog index are servable\n      // routes the content graph can't see — without them, a docs link to e.g.\n      // a custom landing page fails as BLUME_BROKEN_LINK.\n      const userPages = project.context.pagesRoot\n        ? await discoverPages(project.context.pagesRoot)\n        : [];\n      const extraRoutes = customStaticRoutes(userPages);\n      if (hasGeneratedChangelog(project, userPages)) {\n        extraRoutes.push(\"/changelog\");\n      }\n\n      // Fallback-materialized locale routes (an untranslated page prerendered\n      // at its localized URL) are servable but absent from the content graph —\n      // without them a link to an untranslated sibling under a non-default\n      // locale fails as BLUME_BROKEN_LINK even though the built site serves it.\n      if (project.config.i18n) {\n        const manifest = buildManifest({\n          config: project.config,\n          context: project.context,\n          graph: project.graph,\n        });\n        extraRoutes.push(\n          ...manifest.routes.flatMap((route) =>\n            route.fallback ? [route.path] : []\n          )\n        );\n      }\n\n      const publicDir = join(root, \"public\");\n      diagnostics.push(\n        ...(await validateLinks(project.graph, {\n          basePath: project.config.basePath,\n          checkExternal: Boolean(args.external),\n          extraRoutes,\n          i18n: project.config.i18n,\n          publicDir: existsSync(publicDir) ? publicDir : null,\n          redirects: project.config.redirects,\n        }))\n      );\n    } catch (error) {\n      if (error instanceof BlumeError) {\n        diagnostics.push(error.diagnostic);\n      } else {\n        reportInternalError(error);\n        process.exit(1);\n      }\n    }\n\n    // `--strict` escalates warnings to failures; info-level notes (e.g.\n    // BLUME_ASSETS_UNCHECKED when there is no public/ dir) stay advisory.\n    const strictFailure =\n      Boolean(args.strict) &&\n      diagnostics.some((diagnostic) => diagnostic.severity !== \"info\");\n\n    if (args.json) {\n      // Drain stdout before exiting non-zero: `process.exit` would otherwise\n      // truncate the JSON payload mid-write when stdout is a pipe — exactly how\n      // `--json` is consumed in CI/editors.\n      const hadErrors = reportDiagnosticsJson(diagnostics, root);\n      if (hadErrors || strictFailure) {\n        await flushStdout();\n        process.exit(1);\n      }\n      return;\n    }\n\n    const hadErrors = reportDiagnostics(diagnostics, root);\n    if (diagnostics.length === 0) {\n      logger.success(\"No broken links found.\");\n    }\n    if (hadErrors || strictFailure) {\n      process.exit(1);\n    }\n  },\n});\n"
+    "import { existsSync } from \"node:fs\";\n\nimport { defineCommand } from \"citty\";\nimport { join } from \"pathe\";\n\nimport {\n  customStaticRoutes,\n  discoverPages,\n  hasGeneratedChangelog,\n} from \"../../astro/pages.ts\";\nimport { BlumeError } from \"../../core/diagnostics.ts\";\nimport { validateLinks } from \"../../core/links.ts\";\nimport { buildManifest } from \"../../core/manifest.ts\";\nimport { scanProject } from \"../../core/project-graph.ts\";\nimport type { Diagnostic } from \"../../core/types.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { reportInternalError } from \"../internal-error.ts\";\nimport {\n  flushStdout,\n  logger,\n  reportDiagnostics,\n  reportDiagnosticsJson,\n} from \"../log.ts\";\n\nexport const validateCommand = defineCommand({\n  args: {\n    external: {\n      description: \"Check external (HTTP) links over the network.\",\n      type: \"boolean\",\n    },\n    json: {\n      description: \"Emit diagnostics as JSON on stdout (for CI/editors).\",\n      type: \"boolean\",\n    },\n    strict: {\n      description: \"Treat warnings as errors.\",\n      type: \"boolean\",\n    },\n  },\n  meta: commandMeta.validate,\n  async run({ args }) {\n    const root = process.cwd();\n    const diagnostics: Diagnostic[] = [];\n\n    try {\n      const project = await scanProject(root, { mode: \"build\" });\n      // Surface content/graph problems too: a page that fails to parse is a\n      // link-validation blind spot, so silently passing would be misleading.\n      diagnostics.push(...project.diagnostics);\n\n      // Custom `.astro` pages and the generated changelog index are servable\n      // routes the content graph can't see — without them, a docs link to e.g.\n      // a custom landing page fails as BLUME_BROKEN_LINK.\n      const userPages = project.context.pagesRoot\n        ? await discoverPages(project.context.pagesRoot)\n        : [];\n      const extraRoutes = customStaticRoutes(userPages);\n      if (hasGeneratedChangelog(project, userPages)) {\n        extraRoutes.push(\"/changelog\");\n      }\n\n      // Fallback-materialized locale routes (an untranslated page prerendered\n      // at its localized URL) are servable but absent from the content graph —\n      // without them a link to an untranslated sibling under a non-default\n      // locale fails as BLUME_BROKEN_LINK even though the built site serves it.\n      if (project.config.i18n) {\n        const manifest = buildManifest({\n          config: project.config,\n          context: project.context,\n          graph: project.graph,\n        });\n        extraRoutes.push(\n          ...manifest.routes.flatMap((route) =>\n            route.fallback ? [route.path] : []\n          )\n        );\n      }\n\n      const publicDir = join(root, \"public\");\n      diagnostics.push(\n        ...(await validateLinks(project.graph, {\n          basePath: project.config.basePath,\n          checkExternal: Boolean(args.external),\n          extraRoutes,\n          i18n: project.config.i18n,\n          publicDir: existsSync(publicDir) ? publicDir : null,\n          redirects: project.config.redirects,\n        }))\n      );\n    } catch (error) {\n      if (error instanceof BlumeError) {\n        diagnostics.push(error.diagnostic);\n      } else {\n        reportInternalError(error);\n        process.exit(1);\n      }\n    }\n\n    // `--strict` escalates warnings to failures; info-level notes (e.g.\n    // BLUME_ASSETS_UNCHECKED when there is no public/ dir) stay advisory.\n    const strictFailure =\n      Boolean(args.strict) &&\n      diagnostics.some((diagnostic) => diagnostic.severity !== \"info\");\n\n    if (args.json) {\n      // Drain stdout before exiting non-zero: `process.exit` would otherwise\n      // truncate the JSON payload mid-write when stdout is a pipe — exactly how\n      // `--json` is consumed in CI/editors.\n      const hadErrors = reportDiagnosticsJson(diagnostics, root);\n      if (hadErrors || strictFailure) {\n        await flushStdout();\n        process.exit(1);\n      }\n      return;\n    }\n\n    const hadErrors = reportDiagnostics(diagnostics, root);\n    if (diagnostics.length === 0) {\n      logger.success(\"No broken links found.\");\n    }\n    if (hadErrors || strictFailure) {\n      // Set the code and return rather than `process.exit`, which doesn't wait\n      // for a piped stderr: a long diagnostic list would be cut off.\n      process.exitCode = 1;\n    }\n  },\n});\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;AAAA;AAEA;AACA;AAqBO,IAAM,kBAAkB,cAAc;AAAA,EAC3C,MAAM;AAAA,IACJ,UAAU;AAAA,MACR,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,IACA,MAAM;AAAA,MACJ,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,IACA,QAAQ;AAAA,MACN,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,MAAM,YAAY;AAAA,OACZ,IAAG,GAAG,QAAQ;AAAA,IAClB,MAAM,OAAO,QAAQ,IAAI;AAAA,IACzB,MAAM,cAA4B,CAAC;AAAA,IAEnC,IAAI;AAAA,MACF,MAAM,UAAU,MAAM,YAAY,MAAM,EAAE,MAAM,QAAQ,CAAC;AAAA,MAGzD,YAAY,KAAK,GAAG,QAAQ,WAAW;AAAA,MAKvC,MAAM,YAAY,QAAQ,QAAQ,YAC9B,MAAM,cAAc,QAAQ,QAAQ,SAAS,IAC7C,CAAC;AAAA,MACL,MAAM,cAAc,mBAAmB,SAAS;AAAA,MAChD,IAAI,sBAAsB,SAAS,SAAS,GAAG;AAAA,QAC7C,YAAY,KAAK,YAAY;AAAA,MAC/B;AAAA,MAMA,IAAI,QAAQ,OAAO,MAAM;AAAA,QACvB,MAAM,WAAW,cAAc;AAAA,UAC7B,QAAQ,QAAQ;AAAA,UAChB,SAAS,QAAQ;AAAA,UACjB,OAAO,QAAQ;AAAA,QACjB,CAAC;AAAA,QACD,YAAY,KACV,GAAG,SAAS,OAAO,QAAQ,CAAC,UAC1B,MAAM,WAAW,CAAC,MAAM,IAAI,IAAI,CAAC,CACnC,CACF;AAAA,MACF;AAAA,MAEA,MAAM,YAAY,KAAK,MAAM,QAAQ;AAAA,MACrC,YAAY,KACV,GAAI,MAAM,cAAc,QAAQ,OAAO;AAAA,QACrC,UAAU,QAAQ,OAAO;AAAA,QACzB,eAAe,QAAQ,KAAK,QAAQ;AAAA,QACpC;AAAA,QACA,MAAM,QAAQ,OAAO;AAAA,QACrB,WAAW,WAAW,SAAS,IAAI,YAAY;AAAA,QAC/C,WAAW,QAAQ,OAAO;AAAA,MAC5B,CAAC,CACH;AAAA,MACA,OAAO,OAAO;AAAA,MACd,IAAI,iBAAiB,YAAY;AAAA,QAC/B,YAAY,KAAK,MAAM,UAAU;AAAA,MACnC,EAAO;AAAA,QACL,oBAAoB,KAAK;AAAA,QACzB,QAAQ,KAAK,CAAC;AAAA;AAAA;AAAA,IAMlB,MAAM,gBACJ,QAAQ,KAAK,MAAM,KACnB,YAAY,KAAK,CAAC,eAAe,WAAW,aAAa,MAAM;AAAA,IAEjE,IAAI,KAAK,MAAM;AAAA,MAIb,MAAM,YAAY,sBAAsB,aAAa,IAAI;AAAA,MACzD,IAAI,aAAa,eAAe;AAAA,QAC9B,MAAM,YAAY;AAAA,QAClB,QAAQ,KAAK,CAAC;AAAA,MAChB;AAAA,MACA;AAAA,IACF;AAAA,IAEA,MAAM,YAAY,kBAAkB,aAAa,IAAI;AAAA,IACrD,IAAI,YAAY,WAAW,GAAG;AAAA,MAC5B,OAAO,QAAQ,wBAAwB;AAAA,IACzC;AAAA,IACA,IAAI,aAAa,eAAe;AAAA,MAC9B,QAAQ,KAAK,CAAC;AAAA,IAChB;AAAA;AAEJ,CAAC;",
-  "debugId": "1EEBE4960D9C18F364756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;AAAA;AAEA;AACA;AAqBO,IAAM,kBAAkB,cAAc;AAAA,EAC3C,MAAM;AAAA,IACJ,UAAU;AAAA,MACR,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,IACA,MAAM;AAAA,MACJ,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,IACA,QAAQ;AAAA,MACN,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,MAAM,YAAY;AAAA,OACZ,IAAG,GAAG,QAAQ;AAAA,IAClB,MAAM,OAAO,QAAQ,IAAI;AAAA,IACzB,MAAM,cAA4B,CAAC;AAAA,IAEnC,IAAI;AAAA,MACF,MAAM,UAAU,MAAM,YAAY,MAAM,EAAE,MAAM,QAAQ,CAAC;AAAA,MAGzD,YAAY,KAAK,GAAG,QAAQ,WAAW;AAAA,MAKvC,MAAM,YAAY,QAAQ,QAAQ,YAC9B,MAAM,cAAc,QAAQ,QAAQ,SAAS,IAC7C,CAAC;AAAA,MACL,MAAM,cAAc,mBAAmB,SAAS;AAAA,MAChD,IAAI,sBAAsB,SAAS,SAAS,GAAG;AAAA,QAC7C,YAAY,KAAK,YAAY;AAAA,MAC/B;AAAA,MAMA,IAAI,QAAQ,OAAO,MAAM;AAAA,QACvB,MAAM,WAAW,cAAc;AAAA,UAC7B,QAAQ,QAAQ;AAAA,UAChB,SAAS,QAAQ;AAAA,UACjB,OAAO,QAAQ;AAAA,QACjB,CAAC;AAAA,QACD,YAAY,KACV,GAAG,SAAS,OAAO,QAAQ,CAAC,UAC1B,MAAM,WAAW,CAAC,MAAM,IAAI,IAAI,CAAC,CACnC,CACF;AAAA,MACF;AAAA,MAEA,MAAM,YAAY,KAAK,MAAM,QAAQ;AAAA,MACrC,YAAY,KACV,GAAI,MAAM,cAAc,QAAQ,OAAO;AAAA,QACrC,UAAU,QAAQ,OAAO;AAAA,QACzB,eAAe,QAAQ,KAAK,QAAQ;AAAA,QACpC;AAAA,QACA,MAAM,QAAQ,OAAO;AAAA,QACrB,WAAW,WAAW,SAAS,IAAI,YAAY;AAAA,QAC/C,WAAW,QAAQ,OAAO;AAAA,MAC5B,CAAC,CACH;AAAA,MACA,OAAO,OAAO;AAAA,MACd,IAAI,iBAAiB,YAAY;AAAA,QAC/B,YAAY,KAAK,MAAM,UAAU;AAAA,MACnC,EAAO;AAAA,QACL,oBAAoB,KAAK;AAAA,QACzB,QAAQ,KAAK,CAAC;AAAA;AAAA;AAAA,IAMlB,MAAM,gBACJ,QAAQ,KAAK,MAAM,KACnB,YAAY,KAAK,CAAC,eAAe,WAAW,aAAa,MAAM;AAAA,IAEjE,IAAI,KAAK,MAAM;AAAA,MAIb,MAAM,YAAY,sBAAsB,aAAa,IAAI;AAAA,MACzD,IAAI,aAAa,eAAe;AAAA,QAC9B,MAAM,YAAY;AAAA,QAClB,QAAQ,KAAK,CAAC;AAAA,MAChB;AAAA,MACA;AAAA,IACF;AAAA,IAEA,MAAM,YAAY,kBAAkB,aAAa,IAAI;AAAA,IACrD,IAAI,YAAY,WAAW,GAAG;AAAA,MAC5B,OAAO,QAAQ,wBAAwB;AAAA,IACzC;AAAA,IACA,IAAI,aAAa,eAAe;AAAA,MAG9B,QAAQ,WAAW;AAAA,IACrB;AAAA;AAEJ,CAAC;",
+  "debugId": "B6F7C40ED16163B464756E2164756E21",
   "names": []
 }

package/dist/cli/{chunk-q5163e60.js → chunk-p73c0m7w.js}

@@ -6,38 +6,39 @@ import {
   TEMPLATES,
   PACKAGE_MANAGERS,
   commandsFor,
+  cdCommand,
   detectPackageManager,
   validateContentDir,
   titleize,
+  outsidePnpmWorkspace,
   workspaceNote,
   buildPlan,
   applyPlan,
   readExistingPackage,
   nextSteps
-} from "./chunk-qkqwkpte.js";
+} from "./chunk-pv29h0wf.js";
+import"./chunk-3em5wd2y.js";
+import"./chunk-c8chx29p.js";
 import {
   commandMeta,
   logger
 } from "./index.js";
-import"./chunk-6crbhc3x.js";
-import"./chunk-jts8mvcz.js";
-import"./chunk-2hn4b8z7.js";
-import"./chunk-wm7js3j9.js";
-import"./chunk-wgm7m9qk.js";
-import"./chunk-fs23ddbb.js";
-import"./chunk-vtk4a6dg.js";
+import"./chunk-yfyb25rh.js";
+import"./chunk-j85vccga.js";
+import"./chunk-5m5nmvyq.js";
+import"./chunk-b07cmahc.js";
+import"./chunk-8ktnccpt.js";
 import"./chunk-jq5n4avg.js";
-import"./chunk-zxcczpyx.js";
-import"./chunk-82bbrxdn.js";
+import"./chunk-r20tn01b.js";
 import {
   eject
-} from "./chunk-6hsn950k.js";
+} from "./chunk-9t7a85s3.js";
 import {
   updatePackageScripts
-} from "./chunk-yt5n7ppj.js";
+} from "./chunk-ey84smr6.js";
 import {
   installDependencies
-} from "./chunk-5shv93fd.js";
+} from "./chunk-tkacnehg.js";
 
 // src/cli/commands/init.ts
 import * as clack from "@clack/prompts";
@@ -137,7 +138,7 @@ var collectAnswers = async (prompter, flags, defaults) => {
 };
 
 // src/cli/commands/init.ts
-var cdStep = (answers) => answers.directory === "." ? [] : [`cd ${answers.directory}`];
+var cdStep = (answers) => answers.directory === "." ? [] : [cdCommand(answers.directory)];
 var installScaffold = async (root, answers, interactive) => {
   const command = commandsFor(answers.packageManager).install;
   const spinner2 = interactive ? clack.spinner() : undefined;
@@ -191,7 +192,8 @@ var ejectScaffold = async (root, answers, needsInstall) => {
   ${steps.join(`
   `)}`);
   } catch (error) {
-    logger.warn(`Scaffolded, but eject needs the project's dependencies installed to load blume.config.ts: ${error.message}`);
+    const { message } = error;
+    logger.warn(needsInstall ? `Scaffolded, but eject needs the project's dependencies installed to load blume.config.ts: ${message}` : `Scaffolded, but eject failed: ${message}`);
     const steps = [...cd, ...install, `${commands.exec} blume eject --yes`];
     logger.box(`Next steps:
 
@@ -271,7 +273,7 @@ var initCommand = defineCommand({
         template
       }, { cwd, userAgent: process.env.npm_config_user_agent });
       if (collected === null) {
-        clack.cancel("Cancelled — nothing was written.");
+        clack.cancel("Canceled — nothing was written.");
         process.exit(0);
       }
       answers = collected;
@@ -302,7 +304,7 @@ var initCommand = defineCommand({
     if (ignored.length > 0) {
       sink.success(`Added ${ignored.join(", ")} to .gitignore`);
     }
-    const shouldInstall = createdPackage && args.install;
+    const shouldInstall = createdPackage && args.install && !outsidePnpmWorkspace(root, answers);
     if (note) {
       (interactive ? clack.log : logger).warn(note);
     }
@@ -326,5 +328,5 @@ export {
   initCommand
 };
 
-//# debugId=1529DCF0EE516DB064756E2164756E21
-//# sourceMappingURL=chunk-q5163e60.js.map
+//# debugId=AF2963A0DBE8E1BA64756E2164756E21
+//# sourceMappingURL=chunk-p73c0m7w.js.map

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

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/init.ts", "../src/cli/init/questions.ts"],
+  "sourcesContent": [
+    "import * as clack from \"@clack/prompts\";\nimport { defineCommand } from \"citty\";\nimport { resolve } from \"pathe\";\n\nimport { ensureGitignore } from \"../../core/gitignore.ts\";\nimport { eject } from \"../../registry/eject.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { updatePackageScripts } from \"../eject-scripts.ts\";\nimport { installDependencies } from \"../init/install.ts\";\nimport { collectAnswers } from \"../init/questions.ts\";\nimport {\n  applyPlan,\n  buildPlan,\n  cdCommand,\n  commandsFor,\n  detectPackageManager,\n  nextSteps,\n  outsidePnpmWorkspace,\n  PACKAGE_MANAGERS,\n  readExistingPackage,\n  TEMPLATES,\n  validateContentDir,\n  workspaceNote,\n} from \"../init/scaffold.ts\";\nimport type { InitAnswers } from \"../init/scaffold.ts\";\nimport { logger } from \"../log.ts\";\n\n/** The `cd` line that opens every next-steps hint, when one is needed. */\nconst cdStep = (answers: InitAnswers): string[] =>\n  answers.directory === \".\" ? [] : [cdCommand(answers.directory)];\n\n/**\n * Install the scaffolded project's dependencies. Interactive runs hide the\n * package manager's output behind a spinner; `--yes`/CI runs stream it. On\n * failure the scaffold is left intact and the exact retry command is printed\n * before exiting non-zero, so a CI wrapper can tell the two outcomes apart.\n */\nconst installScaffold = async (\n  root: string,\n  answers: InitAnswers,\n  interactive: boolean\n): Promise<void> => {\n  const command = commandsFor(answers.packageManager).install;\n  const spinner = interactive ? clack.spinner() : undefined;\n  if (spinner) {\n    spinner.start(`Installing dependencies (${command})`);\n  } else {\n    logger.info(`Installing dependencies (${command})…`);\n  }\n  const outcome = await installDependencies(root, answers.packageManager, {\n    quiet: interactive,\n  });\n  if (outcome.failure === undefined) {\n    if (spinner) {\n      spinner.stop(\"Installed dependencies\");\n    } else {\n      logger.success(\"Installed dependencies\");\n    }\n    return;\n  }\n  const retry = [...cdStep(answers), command];\n  const hint = `Project created successfully, but dependency installation failed.\\n\\nRetry with:\\n\\n  ${retry.join(\"\\n  \")}\\n`;\n  if (spinner) {\n    spinner.stop(\"Dependency installation failed\");\n    clack.log.error(outcome.failure);\n    clack.note(hint.trimEnd());\n    clack.outro(\"Scaffolded without dependencies.\");\n  } else {\n    logger.error(outcome.failure);\n    logger.box(hint.trimEnd());\n  }\n  process.exit(1);\n};\n\n/**\n * Eject the freshly scaffolded project, or print the install-then-eject path.\n * Eject jiti-loads the scaffolded blume.config.ts, whose `import { defineConfig }\n * from \"blume\"` only resolves once dependencies are installed (or blume is\n * hoisted from an ancestor node_modules, as in a monorepo) — so the fallback\n * below is the common path when the install step was skipped.\n */\nconst ejectScaffold = async (\n  root: string,\n  answers: InitAnswers,\n  needsInstall: boolean\n): Promise<void> => {\n  const commands = commandsFor(answers.packageManager);\n  const cd = cdStep(answers);\n  const install = needsInstall ? [commands.install] : [];\n  try {\n    const { dependencies } = await eject(root);\n    // The scaffolded scripts point at the Blume CLI; the ejected app runs\n    // Astro directly (mirroring the standalone `blume eject` command).\n    const added = await updatePackageScripts(root, dependencies);\n    logger.success(\"Ejected to a standalone Astro project.\");\n    // The packages eject added aren't installed yet, even when the scaffold's\n    // own install already ran, so install comes first either way.\n    const ejectInstall = added.length > 0 ? [commands.install] : install;\n    const steps = [...cd, ...ejectInstall, commands.dev];\n    logger.box(`Next steps:\\n\\n  ${steps.join(\"\\n  \")}`);\n  } catch (error) {\n    // SAFETY: eject and the script rewrite throw Error instances; only the\n    // message is surfaced in the fallback hint.\n    const { message } = error as Error;\n    // Only a skipped install explains the failure; after an install that ran,\n    // the error itself is the reason.\n    logger.warn(\n      needsInstall\n        ? `Scaffolded, but eject needs the project's dependencies installed to load blume.config.ts: ${message}`\n        : `Scaffolded, but eject failed: ${message}`\n    );\n    const steps = [...cd, ...install, `${commands.exec} blume eject --yes`];\n    logger.box(`Next steps:\\n\\n  ${steps.join(\"\\n  \")}`);\n  }\n};\n\n/**\n * Print the closing next steps. An existing package.json was left alone, so\n * the steps add what it lacks; a workspace `note` already printed ahead of an\n * install that ran, so it closes the steps only when the install is still the\n * user's to run.\n */\nconst printNextSteps = async (\n  root: string,\n  answers: InitAnswers,\n  outcome: {\n    createdPackage: boolean;\n    interactive: boolean;\n    needsInstall: boolean;\n    note: string | undefined;\n  }\n): Promise<void> => {\n  const existing = outcome.createdPackage\n    ? undefined\n    : await readExistingPackage(root);\n  const steps = nextSteps(\n    answers,\n    outcome.needsInstall,\n    existing,\n    outcome.needsInstall ? outcome.note : undefined\n  );\n  if (outcome.interactive) {\n    clack.note(steps.trimEnd());\n    clack.outro(\"You're all set.\");\n  } else {\n    // consola's box pads its content itself; a trailing newline would add\n    // blank rows at the bottom.\n    logger.box(steps.trimEnd());\n  }\n};\n\n/**\n * Validate the enum-valued flags up front, exiting with the accepted values\n * on a typo so a bad flag never reaches the prompts.\n */\nconst resolveFlags = (args: {\n  \"package-manager\"?: string;\n  template?: string;\n}) => {\n  const template = TEMPLATES.find((candidate) => candidate === args.template);\n  if (args.template !== undefined && template === undefined) {\n    logger.error(\n      `Unknown template \"${args.template}\" (use ${TEMPLATES.join(\" | \")}).`\n    );\n    process.exit(1);\n  }\n  const pm = PACKAGE_MANAGERS.find(\n    (candidate) => candidate === args[\"package-manager\"]\n  );\n  if (args[\"package-manager\"] !== undefined && pm === undefined) {\n    logger.error(\n      `Unknown package manager \"${args[\"package-manager\"]}\" (use ${PACKAGE_MANAGERS.join(\" | \")}).`\n    );\n    process.exit(1);\n  }\n  return { pm, template };\n};\n\nexport const initCommand = defineCommand({\n  args: {\n    \"content-dir\": {\n      description: \"Content directory.\",\n      type: \"string\",\n    },\n    dir: {\n      description: \"Directory to scaffold into (default: current directory).\",\n      required: false,\n      type: \"positional\",\n    },\n    eject: {\n      description: \"Eject to a standalone Astro project after scaffolding.\",\n      type: \"boolean\",\n    },\n    install: {\n      default: true,\n      description: \"Install dependencies after scaffolding.\",\n      negativeDescription: \"Skip installing dependencies after scaffolding.\",\n      type: \"boolean\",\n    },\n    \"package-manager\": {\n      description:\n        \"Package manager to install with and print in the next steps (npm|pnpm|yarn|bun).\",\n      type: \"string\",\n    },\n    template: {\n      description: \"Starter template: docs | api | sdk | changelog.\",\n      type: \"string\",\n    },\n    yes: {\n      description: \"Skip prompts and scaffold with defaults.\",\n      type: \"boolean\",\n    },\n  },\n  meta: commandMeta.init,\n  async run({ args }) {\n    const cwd = process.cwd();\n    const { pm, template } = resolveFlags(args);\n\n    const interactive =\n      !args.yes &&\n      process.stdin.isTTY === true &&\n      clack.isTTY(process.stdout) &&\n      !clack.isCI();\n\n    let answers: InitAnswers;\n    if (interactive) {\n      clack.intro(\"blume init\");\n      const collected = await collectAnswers(\n        clack,\n        {\n          contentDir: args[\"content-dir\"],\n          directory: args.dir,\n          packageManager: pm,\n          template,\n        },\n        { cwd, userAgent: process.env.npm_config_user_agent }\n      );\n      if (collected === null) {\n        clack.cancel(\"Canceled — nothing was written.\");\n        process.exit(0);\n      }\n      answers = collected;\n    } else {\n      answers = {\n        contentDir: args[\"content-dir\"] ?? \"docs\",\n        directory: args.dir ?? \".\",\n        packageManager:\n          pm ?? detectPackageManager(process.env.npm_config_user_agent),\n        sources: [\"filesystem\"],\n        template: template ?? \"docs\",\n        title: \"My Docs\",\n      };\n    }\n\n    const root = resolve(cwd, answers.directory);\n    // Interactive runs validate this inline, but an explicit --content-dir\n    // flag skips that prompt, so guard here in both modes.\n    if (validateContentDir(root, answers.contentDir) !== undefined) {\n      logger.error(\n        `Invalid --content-dir \"${answers.contentDir}\" (must be a path inside the project).`\n      );\n      process.exit(1);\n    }\n\n    const sink = interactive ? clack.log : logger;\n    const env = { userAgent: process.env.npm_config_user_agent };\n    const { createdPackage } = await applyPlan(\n      buildPlan(root, answers, env),\n      sink\n    );\n    // A workspace the project joins keeps its own package-manager config,\n    // which `init` leaves alone; say what it still needs before installing.\n    const note = workspaceNote(root, answers, env);\n\n    // Keep installed dependencies, Blume's generated runtime (`.blume/`), and\n    // build output (`dist/`) out of version control. Idempotent: creates\n    // `.gitignore` when absent and skips entries already present\n    // (trailing-slash agnostic).\n    const ignored = await ensureGitignore(root, [\n      \"node_modules/\",\n      \".blume/\",\n      \"dist/\",\n    ]);\n    if (ignored.length > 0) {\n      sink.success(`Added ${ignored.join(\", \")} to .gitignore`);\n    }\n\n    // A newly written package.json is the only one `init` knows lists blume;\n    // an existing one is left alone, and so are its dependencies. In a pnpm\n    // workspace that doesn't list the folder, an install would exit 0 without\n    // installing it, so that one waits until the note's change is made.\n    const shouldInstall =\n      createdPackage && args.install && !outsidePnpmWorkspace(root, answers);\n    if (note) {\n      (interactive ? clack.log : logger).warn(note);\n    }\n    if (shouldInstall) {\n      await installScaffold(root, answers, interactive);\n    }\n    const needsInstall = createdPackage && !shouldInstall;\n\n    if (args.eject) {\n      await ejectScaffold(root, answers, needsInstall);\n      return;\n    }\n\n    await printNextSteps(root, answers, {\n      createdPackage,\n      interactive,\n      needsInstall,\n      note,\n    });\n  },\n});\n",
+    "import { basename, resolve } from \"pathe\";\n\nimport {\n  detectPackageManager,\n  titleize,\n  validateContentDir,\n} from \"./scaffold.ts\";\nimport type {\n  InitAnswers,\n  PackageManager,\n  SourceKind,\n  Template,\n} from \"./scaffold.ts\";\n\n/** One prompt option: value plus display label and optional hint. */\ninterface PromptOption<Value> {\n  hint?: string;\n  label: string;\n  value: Value;\n}\n\n/**\n * The prompt surface `collectAnswers` needs — structurally satisfied by the\n * `@clack/prompts` module itself, and by plain fakes in tests. Every prompt\n * resolves to a cancel symbol when the user aborts.\n */\nexport interface Prompter {\n  multiselect: (opts: {\n    initialValues?: SourceKind[];\n    message: string;\n    options: PromptOption<SourceKind>[];\n    required?: boolean;\n  }) => Promise<SourceKind[] | symbol>;\n  select: (opts: {\n    message: string;\n    options: PromptOption<Template>[];\n  }) => Promise<Template | symbol>;\n  text: (opts: {\n    defaultValue?: string;\n    initialValue?: string;\n    message: string;\n    placeholder?: string;\n    validate?: (value: string | undefined) => string | undefined;\n  }) => Promise<string | symbol>;\n}\n\n/** Flag values the user passed explicitly; each one skips its question. */\nexport interface InitFlags {\n  contentDir?: string;\n  directory?: string;\n  packageManager?: PackageManager;\n  template?: Template;\n}\n\nconst cancelled = (value: string | string[] | symbol): value is symbol =>\n  typeof value === \"symbol\";\n\n/**\n * Run the interactive init flow, returning the collected answers or `null`\n * when the user cancels. All questions run before anything is written, so a\n * cancel never leaves a partial scaffold behind.\n */\nexport const collectAnswers = async (\n  prompter: Prompter,\n  flags: InitFlags,\n  defaults: { cwd: string; userAgent?: string }\n): Promise<InitAnswers | null> => {\n  const directory =\n    flags.directory ??\n    (await prompter.text({\n      defaultValue: \".\",\n      message: \"Where should we create your project?\",\n      placeholder: \"./my-docs\",\n    }));\n  if (cancelled(directory)) {\n    return null;\n  }\n\n  const root = resolve(defaults.cwd, directory);\n  const title = await prompter.text({\n    initialValue: titleize(basename(root)),\n    message: \"What's your docs site called?\",\n    validate: (value) =>\n      value?.trim() ? undefined : \"Give your docs site a name.\",\n  });\n  if (cancelled(title)) {\n    return null;\n  }\n\n  const template =\n    flags.template ??\n    (await prompter.select({\n      message: \"Which template?\",\n      options: [\n        { hint: \"Markdown docs site\", label: \"docs\", value: \"docs\" },\n        { hint: \"OpenAPI reference at /api\", label: \"api\", value: \"api\" },\n        { hint: \"SDK docs with an install page\", label: \"sdk\", value: \"sdk\" },\n        {\n          hint: \"Docs plus a changelog tab\",\n          label: \"changelog\",\n          value: \"changelog\",\n        },\n      ],\n    }));\n  if (cancelled(template)) {\n    return null;\n  }\n\n  const picked = await prompter.multiselect({\n    initialValues: [\"filesystem\"],\n    message: \"Where does your content live?\",\n    options: [\n      { hint: \"Local .mdx files\", label: \"filesystem\", value: \"filesystem\" },\n      { hint: \"An Obsidian vault\", label: \"obsidian\", value: \"obsidian\" },\n      {\n        hint: \"Changelog from GitHub Releases\",\n        label: \"github-releases\",\n        value: \"github-releases\",\n      },\n      { hint: \"A Notion database\", label: \"notion\", value: \"notion\" },\n      { hint: \"A Sanity dataset\", label: \"sanity\", value: \"sanity\" },\n      {\n        hint: \"A Contentful content type\",\n        label: \"contentful\",\n        value: \"contentful\",\n      },\n      { hint: \"A Payload collection\", label: \"payload\", value: \"payload\" },\n      { hint: \"A Strapi content type\", label: \"strapi\", value: \"strapi\" },\n      {\n        hint: \"MDX fetched from a GitHub repo\",\n        label: \"mdx-remote\",\n        value: \"mdx-remote\",\n      },\n    ],\n    required: false,\n  });\n  if (cancelled(picked)) {\n    return null;\n  }\n  // No selection desugars to the implicit local source, same as the schema.\n  const sources: SourceKind[] = picked.length === 0 ? [\"filesystem\"] : picked;\n\n  let contentDir = flags.contentDir ?? \"docs\";\n  if (flags.contentDir === undefined && sources.includes(\"filesystem\")) {\n    const answer = await prompter.text({\n      defaultValue: \"docs\",\n      message: \"Content directory?\",\n      placeholder: \"docs\",\n      validate: (value) => validateContentDir(root, value || \"docs\"),\n    });\n    if (cancelled(answer)) {\n      return null;\n    }\n    contentDir = answer;\n  }\n\n  return {\n    contentDir,\n    directory,\n    packageManager:\n      flags.packageManager ?? detectPackageManager(defaults.userAgent),\n    sources,\n    template,\n    title,\n  };\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "AF2963A0DBE8E1BA64756E2164756E21",
+  "names": []
+}

package/dist/cli/{chunk-dh8cwk36.js → chunk-pehfxfta.js}

@@ -6,21 +6,19 @@ import {
 import {
   ComponentOverridesError,
   analyzeComponentOverrides
-} from "./chunk-vtk4a6dg.js";
+} from "./chunk-8ktnccpt.js";
 import {
   frontmatter_default,
   DEFAULT_CONTENT_INCLUDE,
   DEFAULT_CONTENT_EXCLUDE,
   pageMetaSchema,
+  baselineScanIgnore,
   createModuleLoader,
   findConfigFile,
   findComponentsFile,
   ConfigValidationError,
   loadConfig
-} from "./chunk-qkqwkpte.js";
-import {
-  baselineScanIgnore
-} from "./chunk-abh8yjkn.js";
+} from "./chunk-pv29h0wf.js";
 
 // src/upgrade/upgrade.ts
 import { existsSync } from "node:fs";
@@ -39,6 +37,16 @@ var rangeMajor = (range) => {
   const major = RANGE_MAJOR.exec(range)?.groups?.major;
   return major === undefined ? null : Number(major);
 };
+var CATALOG_RANGE = /^catalog:(?<name>.*)$/u;
+var NPM_ALIAS = /^npm:.+@(?<range>[^@]*)$/u;
+var manualBumpAdvice = (range, version) => {
+  const catalog = CATALOG_RANGE.exec(range)?.groups?.name;
+  if (catalog === undefined) {
+    return `package.json installs blume through the alias \`${range}\`, which \`blume upgrade\` doesn't rewrite: set the alias's version to ^${version}, then reinstall.`;
+  }
+  const entry = catalog === "" || catalog === "default" ? "`catalog`" : `\`catalogs.${catalog}\``;
+  return `package.json takes blume from the pnpm catalog (\`${range}\`), which \`blume upgrade\` can't bump: set blume to ^${version} under ${entry} in pnpm-workspace.yaml if it isn't already, then reinstall.`;
+};
 var INDENT = /^(?<indent>[ \t]+)"/mu;
 var REGEXP_SPECIAL = /[$()*+.?[\\\]^{|}]/gu;
 var escapeRegExp = (value) => value.replaceAll(REGEXP_SPECIAL, String.raw`\$&`);
@@ -65,11 +73,18 @@ var bumpBlumeDependency = async (root, version) => {
   if (!(field && from)) {
     return { status: "missing" };
   }
-  const current = rangeMajor(from);
+  if (CATALOG_RANGE.test(from)) {
+    return { range: from, status: "manual" };
+  }
+  const aliased = NPM_ALIAS.exec(from)?.groups?.range;
+  const current = rangeMajor(aliased ?? from);
   const target = rangeMajor(version);
   if (current === null || target === null || current >= target) {
     return { range: from, status: "current" };
   }
+  if (aliased !== undefined) {
+    return { range: from, status: "manual" };
+  }
   const to = `^${version}`;
   const indent = INDENT.exec(text)?.groups?.indent ?? "  ";
   const updated = { ...pkg, [field]: { ...pkg[field], blume: to } };
@@ -273,7 +288,7 @@ Work through every finding:
 
 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 };
+export { UPGRADE_GUIDE_URL, UPGRADE_GUIDE_FILE, manualBumpAdvice, bumpBlumeDependency, isOutsideBlumeProject, removedBuildFlags, flagList, removedBuildFlagsAdvice, collectUpgradeFindings, upgradePrompt };
 
-//# debugId=9BE967FC7391289164756E2164756E21
-//# sourceMappingURL=chunk-dh8cwk36.js.map
+//# debugId=220AF85AD7ADA53D64756E2164756E21
+//# sourceMappingURL=chunk-pehfxfta.js.map

package/dist/cli/chunk-pehfxfta.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  | { range: string; status: \"manual\" }\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// Ranges whose version lives somewhere the bump doesn't rewrite: a pnpm\n// catalog in pnpm-workspace.yaml, or the `range` of an `npm:name@range` alias.\nconst CATALOG_RANGE = /^catalog:(?<name>.*)$/u;\nconst NPM_ALIAS = /^npm:.+@(?<range>[^@]*)$/u;\n\n/**\n * What to change by hand for a `blume` range the bump can't rewrite (a\n * `manual` {@link DependencyBump}): the pnpm catalog entry it points at, or\n * the version inside its `npm:` alias.\n */\nexport const manualBumpAdvice = (range: string, version: string): string => {\n  const catalog = CATALOG_RANGE.exec(range)?.groups?.name;\n  if (catalog === undefined) {\n    return `package.json installs blume through the alias \\`${range}\\`, which \\`blume upgrade\\` doesn't rewrite: set the alias's version to ^${version}, then reinstall.`;\n  }\n  const entry =\n    catalog === \"\" || catalog === \"default\"\n      ? \"`catalog`\"\n      : `\\`catalogs.${catalog}\\``;\n  return `package.json takes blume from the pnpm catalog (\\`${range}\\`), which \\`blume upgrade\\` can't bump: set blume to ^${version} under ${entry} in pnpm-workspace.yaml if it isn't already, then reinstall.`;\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; one whose\n * version lives elsewhere (`catalog:`, an `npm:` alias of an older major) is\n * `manual`, for the user to change; a project with no `package.json`, or none\n * that lists `blume`, is `missing`. Only the range changes: the rest of the\n * 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  if (CATALOG_RANGE.test(from)) {\n    return { range: from, status: \"manual\" };\n  }\n  const aliased = NPM_ALIAS.exec(from)?.groups?.range;\n  const current = rangeMajor(aliased ?? from);\n  const target = rangeMajor(version);\n  if (current === null || target === null || current >= target) {\n    return { range: from, status: \"current\" };\n  }\n  if (aliased !== undefined) {\n    return { range: from, status: \"manual\" };\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 the assistant's model provider become adapters imported from \\`blume/*\\` subpaths; the machine-readable settings move from \\`ai\\` to \\`agents\\`; Ask AI is renamed the assistant, so \\`ai.ask\\` becomes \\`ai.assistant\\`; 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": "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",
+  "debugId": "220AF85AD7ADA53D64756E2164756E21",
+  "names": []
+}