blume 2.0.3 → 2.1.1

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

@@ -1,10 +0,0 @@
-{
-  "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      // 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,MAG9B,QAAQ,WAAW;AAAA,IACrB;AAAA;AAEJ,CAAC;",
-  "debugId": "B6F7C40ED16163B464756E2164756E21",
-  "names": []
-}

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

@@ -1,10 +0,0 @@
-{
-  "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": []
-}