blume 2.1.3 → 2.2.1

package/dist/cli/{chunk-5cmts6dv.js → chunk-kmswjxj9.js}

@@ -8,15 +8,15 @@ import {
   VERSION_ID,
   VERSION_LIKE,
   versionizeRoute
-} from "./chunk-124fvmzq.js";
+} from "./chunk-r5nm9w0c.js";
+import {
+  isWithin,
+  scanProject
+} from "./chunk-zxd5jrgx.js";
 import {
   mountBasePath,
   stripBasePath
 } from "./chunk-zccbjcj0.js";
-import {
-  isWithin,
-  scanProject
-} from "./chunk-0pmb4tr4.js";
 
 // src/core/version-cut.ts
 import { existsSync } from "node:fs";
@@ -279,5 +279,5 @@ var cutVersion = async (root, id, options = {}) => {
 
 export { CutError, unregisteredSnapshotDiagnostics, cutVersion };
 
-//# debugId=8631919BA7BA49B664756E2164756E21
-//# sourceMappingURL=chunk-5cmts6dv.js.map
+//# debugId=1864DE871652686F64756E2164756E21
+//# sourceMappingURL=chunk-kmswjxj9.js.map

package/dist/cli/{chunk-5cmts6dv.js.map → chunk-kmswjxj9.js.map}

@@ -5,6 +5,6 @@
     "import { existsSync } from \"node:fs\";\nimport { cp, readdir, readFile, rm } from \"node:fs/promises\";\n\nimport { join, relative } from \"pathe\";\n\nimport { mountBasePath, stripBasePath } from \"./base-path.ts\";\nimport { nextFenceState } from \"./code-fences.ts\";\nimport type { FenceState } from \"./code-fences.ts\";\nimport { writeTextAtomic } from \"./fs-atomic.ts\";\nimport { localizeRoute } from \"./i18n.ts\";\nimport type { BlumeProject } from \"./project-graph.ts\";\nimport { isWithin, scanProject } from \"./project-graph.ts\";\nimport { VERSION_ID } from \"./schema.ts\";\nimport type { Diagnostic } from \"./types.ts\";\nimport { VERSION_LIKE, versionizeRoute } from \"./versions.ts\";\n\n/** What `cutVersion` did, for the CLI to report. */\nexport interface CutResult {\n  /** Files copied into the snapshot. */\n  copied: number;\n  /** Markdown pages whose root-absolute links were rewritten, with counts. */\n  rewritten: { file: string; count: number }[];\n  /** Whether `blume.config.ts` was updated in place. */\n  configUpdated: boolean;\n  /**\n   * Whether that update added the whole `versions` block — the first cut of a\n   * project that had no versioning — rather than one `archived` entry.\n   */\n  versionsAdded: boolean;\n  /** Ready-to-paste config snippet when in-place update was not possible. */\n  configSnippet: string | null;\n  /** Absolute path of the created snapshot directory. */\n  dir: string;\n}\n\n/** A `cutVersion` failure the CLI reports as a user error, not a crash. */\nexport class CutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CutError\";\n  }\n}\n\n// Inline code spans are syntax being *shown*, not links — blank them before\n// matching so replacements can splice into the real line by index (the mask\n// preserves length). Mirrors the content-assets rewriter.\nconst INLINE_CODE = /`[^`]*`/gu;\n// A root-absolute markdown link/image target, reference-style link definition\n// (`[setup]: /guides/setup`, up to three spaces in, never a `[^note]:`\n// footnote), or HTML href/src attribute in either quote style. Named groups\n// carry the prefix (kept) and target (rewritten).\nconst ROOT_LINK =\n  /(?<prefix>\\]\\(|^ {0,3}\\[(?!\\^)[^\\]]+\\]:[ \\t]*<?|(?:href|src)=[\"'])(?<target>\\/[^\\s\"'<>)]*)/gu;\n\n/**\n * Build the link-rewrite table: every current-version route (basePath\n * stripped, since authors write root-absolute links as if mounted at root;\n * a link that spells the base out is looked up without it, see\n * `snapshotTarget`) mapped to the same page's route inside the new snapshot.\n * Only pages the snapshot actually contains qualify — filesystem pages under\n * the content root. Spec-rendered references (`/api`, `/events`) and remote\n * sources aren't copied, so links to them keep pointing at the live pages\n * instead of a 404 inside the snapshot.\n */\nconst buildRouteRewrites = (\n  project: BlumeProject,\n  id: string\n): Map<string, string> => {\n  const { basePath, i18n } = project.config;\n  const { contentRoot } = project.context;\n  const rewrites = new Map<string, string>();\n  // Under i18n, authors write links in the unprefixed form (`/guides/setup`)\n  // and rendering moves them into the reader's locale — a form no page is\n  // routed at when the default locale keeps its prefix\n  // (`hideDefaultLocalePrefix: false`). So it is mapped too, to the\n  // unprefixed snapshot route, which rendering localizes the same way. Page\n  // routes win where the two forms coincide.\n  const logical = new Map<string, string>();\n  for (const page of project.graph.pages) {\n    // `sourcePath` marks a page backed by a local file, which excludes\n    // generated and remote pages; the content-root check below excludes local\n    // files that live outside the tree a version snapshot copies. A staged\n    // page (an Obsidian note) is served from its source, not from the copied\n    // tree, so it keeps publishing as current even when its file sits under\n    // the content root.\n    const { sourcePath } = page;\n    if (\n      page.version !== \"\" ||\n      page.collection === \"staged\" ||\n      !sourcePath ||\n      relative(contentRoot, sourcePath).startsWith(\"..\")\n    ) {\n      continue;\n    }\n    const snapshot = versionizeRoute(page.versionKey, id);\n    rewrites.set(\n      stripBasePath(basePath, page.route),\n      i18n ? localizeRoute(snapshot, page.locale, i18n) : snapshot\n    );\n    if (i18n) {\n      logical.set(page.versionKey, snapshot);\n    }\n  }\n  for (const [route, snapshot] of logical) {\n    if (!rewrites.has(route)) {\n      rewrites.set(route, snapshot);\n    }\n  }\n  return rewrites;\n};\n\n/**\n * The snapshot link a root-absolute path rewrites to, or undefined when the\n * snapshot has no copy of its page. A path written with the base path by hand\n * (`/docs/guides/x` under `basePath: \"/docs\"`) names the same page as\n * `/guides/x` — rendering leaves an already-based link alone (see\n * `withBasePath`) — so it is looked up without the base and keeps it.\n */\nconst snapshotTarget = (\n  path: string,\n  rewrites: Map<string, string>,\n  basePath: string\n): string | undefined => {\n  const based =\n    basePath !== \"\" && (path === basePath || path.startsWith(`${basePath}/`));\n  if (!based) {\n    return rewrites.get(path);\n  }\n  const replacement = rewrites.get(stripBasePath(basePath, path));\n  return replacement === undefined\n    ? undefined\n    : mountBasePath(basePath, replacement);\n};\n\n/** Rewrite one line's root-absolute internal links via the rewrite table. */\nconst rewriteLine = (\n  line: string,\n  rewrites: Map<string, string>,\n  basePath: string\n): string => {\n  const masked = line.replaceAll(INLINE_CODE, (span) =>\n    \" \".repeat(span.length)\n  );\n  let out = \"\";\n  let cursor = 0;\n  let count = 0;\n  for (const match of masked.matchAll(ROOT_LINK)) {\n    const target = match.groups?.target ?? \"\";\n    // An anchor or query stays attached to the rewritten path.\n    const hash = target.search(/[#?]/u);\n    const path = hash === -1 ? target : target.slice(0, hash);\n    const suffix = hash === -1 ? \"\" : target.slice(hash);\n    const bare = path !== \"/\" && path.endsWith(\"/\") ? path.slice(0, -1) : path;\n    const replacement = snapshotTarget(bare, rewrites, basePath);\n    if (replacement === undefined) {\n      continue;\n    }\n    const offset = (match.index ?? 0) + (match.groups?.prefix?.length ?? 0);\n    out += line.slice(cursor, offset) + replacement + suffix;\n    cursor = offset + target.length;\n    count += 1;\n  }\n  return count === 0 ? line : out + line.slice(cursor);\n};\n\n/** A page's link-rewritten text and how many of its lines changed. */\nexport interface SnapshotRewrite {\n  text: string;\n  count: number;\n}\n\n/**\n * Rewrite a copied page's root-absolute internal links to their snapshot\n * equivalents, skipping fenced and inline code. Relative links need no\n * rewriting — the whole tree copies together, so they stay self-contained.\n * `basePath` is the site's, for links that spell it out by hand.\n */\nexport const rewriteSnapshotLinks = (\n  source: string,\n  rewrites: Map<string, string>,\n  basePath = \"\"\n): SnapshotRewrite => {\n  let fence: FenceState = null;\n  let count = 0;\n  const lines = source.split(\"\\n\").map((line) => {\n    const next = nextFenceState(line, fence);\n    const inFence = fence !== null || next !== null;\n    fence = next;\n    if (inFence) {\n      return line;\n    }\n    const rewrittenLine = rewriteLine(line, rewrites, basePath);\n    if (rewrittenLine !== line) {\n      count += 1;\n    }\n    return rewrittenLine;\n  });\n  return { count, text: lines.join(\"\\n\") };\n};\n\n/**\n * The switcher label a first cut gives the live docs. `versions.current.label`\n * is required, and \"Latest\" reads right until the author names the release.\n */\nconst CURRENT_LABEL = \"Latest\";\n\n/** The config entry to add, as a paste-ready snippet for the fallback path. */\nconst snippetFor = (id: string, hasVersions: boolean): string =>\n  hasVersions\n    ? `Add to versions.archived in blume.config.ts (newest first):\\n\\n  { id: \"${id}\" },\\n`\n    : `Add to blume.config.ts:\\n\\n  versions: {\\n    archived: [{ id: \"${id}\" }],\\n    current: { label: \"${CURRENT_LABEL}\" },\\n  },\\n`;\n\n/**\n * Best-effort in-place config update: insert the new id at the head of an\n * existing \\`archived: [\\` array literal, preserving indentation. Anything\n * fancier (computed arrays, config spread across files) falls back to a\n * printed snippet — the config is user-authored TypeScript, and string-level\n * surgery beyond this simple shape risks corrupting it.\n */\nexport const insertArchivedVersion = async (\n  configPath: string,\n  id: string\n): Promise<boolean> => {\n  let text: string;\n  try {\n    text = await readFile(configPath, \"utf-8\");\n  } catch {\n    return false;\n  }\n  const match = text.match(/(?<lead>archived:\\s*\\[)/u);\n  if (!match || match.index === undefined) {\n    return false;\n  }\n  const insertAt = match.index + (match.groups?.lead?.length ?? 0);\n  // Indentation: one level deeper than the line holding `archived:`.\n  const lineStart = text.lastIndexOf(\"\\n\", match.index) + 1;\n  const indent = text.slice(lineStart).match(/^\\s*/u)?.[0] ?? \"\";\n  const rest = text.slice(insertAt);\n  // Match the array's authored shape: empty stays bare, an inline array gets\n  // an inline entry, a multiline array gets its own indented line — on the\n  // file's own line ending, so a CRLF config doesn't gain a lone LF.\n  const eol = /^\\r?\\n/u.exec(rest)?.[0];\n  let entry: string;\n  if (rest.trimStart().startsWith(\"]\")) {\n    entry = `{ id: \"${id}\" }`;\n  } else if (eol) {\n    entry = `${eol}${indent}  { id: \"${id}\" },`;\n  } else {\n    entry = `{ id: \"${id}\" }, `;\n  }\n  await writeTextAtomic(configPath, text.slice(0, insertAt) + entry + rest);\n  return true;\n};\n\n/** The opening brace of the config object: `defineConfig({` or `export default {`. */\nconst CONFIG_OBJECT = /(?:defineConfig\\(\\s*|export\\s+default\\s+)\\{/gu;\n\n/**\n * Best-effort in-place registration of a first version: add a `versions` block\n * (the id archived, the live docs labeled {@link CURRENT_LABEL}) as the first\n * property of the config object. Only the plain shape is edited — exactly one\n * `defineConfig({` or `export default {` and no `versions` key yet — so a\n * config built any other way falls back to the printed snippet rather than\n * risk corrupting it.\n */\nexport const insertVersionsBlock = async (\n  configPath: string,\n  id: string\n): Promise<boolean> => {\n  let text: string;\n  try {\n    text = await readFile(configPath, \"utf-8\");\n  } catch {\n    return false;\n  }\n  const matches = [...text.matchAll(CONFIG_OBJECT)];\n  const [match] = matches;\n  if (matches.length !== 1 || !match || /\\bversions\\s*:/u.test(text)) {\n    return false;\n  }\n  const insertAt = match.index + match[0].length;\n  const rest = text.slice(insertAt);\n  const eol = text.includes(\"\\r\\n\") ? \"\\r\\n\" : \"\\n\";\n  const lineStart = text.lastIndexOf(\"\\n\", match.index) + 1;\n  const outer = /^[ \\t]*/u.exec(text.slice(lineStart))?.[0] ?? \"\";\n  // Match the indentation of the property on the next line, when there is one.\n  const indent =\n    /^[ \\t]*\\r?\\n(?<indent>[ \\t]*)\\S/u.exec(rest)?.groups?.indent ??\n    `${outer}  `;\n  const block = [\n    \"versions: {\",\n    `  archived: [{ id: \"${id}\" }],`,\n    `  current: { label: \"${CURRENT_LABEL}\" },`,\n    \"},\",\n  ]\n    .map((line) => `${indent}${line}`)\n    .join(eol);\n  const body = rest.trimStart();\n  let tail: string;\n  if (body.startsWith(\"}\")) {\n    // An empty object: close it on its own line.\n    tail = `${eol}${outer}${body}`;\n  } else if (/^[ \\t]*\\r?\\n/u.test(rest)) {\n    tail = rest;\n  } else {\n    // An inline object: move its first property onto the next line.\n    tail = `${eol}${indent}${body}`;\n  }\n  await writeTextAtomic(\n    configPath,\n    `${text.slice(0, insertAt)}${eol}${block}${tail}`\n  );\n  return true;\n};\n\n/**\n * Version-shaped folders (`v1.0/`) at the top of the content root of a project\n * with no `versions` config — usually a snapshot `blume version` cut but\n * couldn't register — which build as ordinary content at `/v1.0/…`, so every\n * page ships twice. With versioning configured, the scan's own\n * `BLUME_VERSIONS_UNCONFIGURED_VERSION` covers a folder it doesn't list; this\n * check is `blume doctor`'s alone, since an unversioned site can have a real\n * `v1/` section that a warning on every build would only nag about.\n */\nexport const unregisteredSnapshotDiagnostics = (\n  project: BlumeProject\n): Diagnostic[] => {\n  if (project.config.versions) {\n    return [];\n  }\n  const { contentRoot } = project.context;\n  const folders = new Set<string>();\n  for (const page of project.graph.pages) {\n    const [first, ...rest] = page.sourcePath\n      ? relative(contentRoot, page.sourcePath).split(\"/\")\n      : [];\n    if (first && rest.length > 0 && VERSION_LIKE.test(first)) {\n      folders.add(first);\n    }\n  }\n  return [...folders].toSorted().map((folder) => ({\n    code: \"BLUME_VERSIONS_UNCONFIGURED_VERSION\",\n    file: join(contentRoot, folder),\n    message: `Folder \"${folder}/\" looks like a version snapshot, but versioning isn't configured, so its pages build as ordinary content at /${folder}/….`,\n    severity: \"warning\",\n    suggestion: `If it's a snapshot, register it with \\`versions: { archived: [{ id: \"${folder}\" }], current: { label: \"${CURRENT_LABEL}\" } }\\` in blume.config.ts; if it's an ordinary section, ignore this.`,\n  }));\n};\n\n/**\n * Freeze the current docs as an archived version: copy the content tree into\n * `<contentRoot>/<id>/` (excluding existing snapshots), rewrite root-absolute\n * internal links so the copy is self-contained, and register the id in\n * `blume.config.ts` (or print the snippet to paste).\n */\nexport const cutVersion = async (\n  root: string,\n  id: string,\n  options: { force?: boolean } = {}\n): Promise<CutResult> => {\n  if (!VERSION_ID.test(id)) {\n    throw new CutError(\n      `Version ids must start with a letter (e.g. \"v1.0\") and contain only letters, digits, dots, hyphens, and underscores — got \"${id}\".`\n    );\n  }\n\n  const project = await scanProject(root);\n  const errors = project.diagnostics.filter(\n    (diagnostic) => diagnostic.severity === \"error\"\n  );\n  if (errors.length > 0) {\n    throw new CutError(\n      `The project has ${errors.length} error diagnostic(s) — fix them before cutting a version (run \\`blume validate\\`).`\n    );\n  }\n  // A missing content root already fails inside `scanProject` (the filesystem\n  // source's own validation), so only the version-level checks remain here.\n  const { contentRoot } = project.context;\n  if (project.config.versions?.archived.some((version) => version.id === id)) {\n    throw new CutError(\n      `Version \"${id}\" is already registered in versions.archived.`\n    );\n  }\n\n  const dir = join(contentRoot, id);\n  if (existsSync(dir)) {\n    if (!options.force) {\n      throw new CutError(\n        `${dir} already exists — pass --force to overwrite the snapshot.`\n      );\n    }\n    await rm(dir, { force: true, recursive: true });\n  }\n\n  // Existing snapshots must not nest inside the new one: configured ids, plus\n  // any version-shaped directory (`v1.0/`) that never made it into the config —\n  // e.g. a prior cut whose config update fell back to a printed snippet. A\n  // genuine content folder that merely looks like a version already draws the\n  // rename-or-register diagnostic, so skipping it here is consistent.\n  const excluded = new Set([\n    id,\n    \"node_modules\",\n    ...(project.config.versions?.archived.map((version) => version.id) ?? []),\n  ]);\n  // Another local source's tree under the content root — an Obsidian vault the\n  // filesystem source excludes — is that source's to publish. Copying it would\n  // republish its raw notes (wikilinks and `%%comments%%` intact) as\n  // filesystem pages of the snapshot, while the source itself keeps serving\n  // them as current.\n  const foreignRoots = project.sources\n    .flatMap((source) =>\n      source.staged && source.contentRoot ? [source.contentRoot] : []\n    )\n    .filter((tree) => isWithin(contentRoot, tree));\n  const isForeign = (path: string): boolean =>\n    foreignRoots.some((tree) => isWithin(tree, path));\n  const entries = await readdir(contentRoot, { withFileTypes: true });\n  let copied = 0;\n  await Promise.all(\n    entries.map(async (entry) => {\n      if (\n        excluded.has(entry.name) ||\n        entry.name.startsWith(\".\") ||\n        (entry.isDirectory() && VERSION_LIKE.test(entry.name))\n      ) {\n        return;\n      }\n      await cp(join(contentRoot, entry.name), join(dir, entry.name), {\n        filter: (source) => !isForeign(source),\n        recursive: true,\n      });\n    })\n  );\n\n  // Rewrite root-absolute internal links in every copied markdown page.\n  const rewrites = buildRouteRewrites(project, id);\n  const rewritten: { file: string; count: number }[] = [];\n  const walk = async (current: string): Promise<void> => {\n    const children = await readdir(current, { withFileTypes: true });\n    await Promise.all(\n      children.map(async (child) => {\n        const abs = join(current, child.name);\n        if (child.isDirectory()) {\n          await walk(abs);\n          return;\n        }\n        copied += 1;\n        if (!/\\.mdx?$/u.test(child.name)) {\n          return;\n        }\n        const source = await readFile(abs, \"utf-8\");\n        const { text, count } = rewriteSnapshotLinks(\n          source,\n          rewrites,\n          project.config.basePath\n        );\n        if (count > 0) {\n          await writeTextAtomic(abs, text);\n          rewritten.push({ count, file: relative(dir, abs) });\n        }\n      })\n    );\n  };\n  await walk(dir);\n\n  const configPath =\n    project.context.configFile ?? join(root, \"blume.config.ts\");\n  const firstVersion = project.config.versions === undefined;\n  const configUpdated = firstVersion\n    ? await insertVersionsBlock(configPath, id)\n    : await insertArchivedVersion(configPath, id);\n\n  return {\n    configSnippet: configUpdated ? null : snippetFor(id, !firstVersion),\n    configUpdated,\n    copied,\n    dir,\n    rewritten,\n    versionsAdded: configUpdated && firstVersion,\n  };\n};\n"
   ],
   "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA;AACA;AAEA;AAiCO,MAAM,iBAAiB,MAAM;AAAA,EAClC,WAAW,CAAC,SAAiB;AAAA,IAC3B,MAAM,OAAO;AAAA,IACb,KAAK,OAAO;AAAA;AAEhB;AAKA,IAAM,cAAc;AAKpB,IAAM,YACJ;AAYF,IAAM,qBAAqB,CACzB,SACA,OACwB;AAAA,EACxB,QAAQ,UAAU,SAAS,QAAQ;AAAA,EACnC,QAAQ,gBAAgB,QAAQ;AAAA,EAChC,MAAM,WAAW,IAAI;AAAA,EAOrB,MAAM,UAAU,IAAI;AAAA,EACpB,WAAW,QAAQ,QAAQ,MAAM,OAAO;AAAA,IAOtC,QAAQ,eAAe;AAAA,IACvB,IACE,KAAK,YAAY,MACjB,KAAK,eAAe,YACpB,CAAC,cACD,SAAS,aAAa,UAAU,EAAE,WAAW,IAAI,GACjD;AAAA,MACA;AAAA,IACF;AAAA,IACA,MAAM,WAAW,gBAAgB,KAAK,YAAY,EAAE;AAAA,IACpD,SAAS,IACP,cAAc,UAAU,KAAK,KAAK,GAClC,OAAO,cAAc,UAAU,KAAK,QAAQ,IAAI,IAAI,QACtD;AAAA,IACA,IAAI,MAAM;AAAA,MACR,QAAQ,IAAI,KAAK,YAAY,QAAQ;AAAA,IACvC;AAAA,EACF;AAAA,EACA,YAAY,OAAO,aAAa,SAAS;AAAA,IACvC,IAAI,CAAC,SAAS,IAAI,KAAK,GAAG;AAAA,MACxB,SAAS,IAAI,OAAO,QAAQ;AAAA,IAC9B;AAAA,EACF;AAAA,EACA,OAAO;AAAA;AAUT,IAAM,iBAAiB,CACrB,MACA,UACA,aACuB;AAAA,EACvB,MAAM,QACJ,aAAa,OAAO,SAAS,YAAY,KAAK,WAAW,GAAG,WAAW;AAAA,EACzE,IAAI,CAAC,OAAO;AAAA,IACV,OAAO,SAAS,IAAI,IAAI;AAAA,EAC1B;AAAA,EACA,MAAM,cAAc,SAAS,IAAI,cAAc,UAAU,IAAI,CAAC;AAAA,EAC9D,OAAO,gBAAgB,YACnB,YACA,cAAc,UAAU,WAAW;AAAA;AAIzC,IAAM,cAAc,CAClB,MACA,UACA,aACW;AAAA,EACX,MAAM,SAAS,KAAK,WAAW,aAAa,CAAC,SAC3C,IAAI,OAAO,KAAK,MAAM,CACxB;AAAA,EACA,IAAI,MAAM;AAAA,EACV,IAAI,SAAS;AAAA,EACb,IAAI,QAAQ;AAAA,EACZ,WAAW,SAAS,OAAO,SAAS,SAAS,GAAG;AAAA,IAC9C,MAAM,SAAS,MAAM,QAAQ,UAAU;AAAA,IAEvC,MAAM,OAAO,OAAO,OAAO,OAAO;AAAA,IAClC,MAAM,OAAO,SAAS,KAAK,SAAS,OAAO,MAAM,GAAG,IAAI;AAAA,IACxD,MAAM,SAAS,SAAS,KAAK,KAAK,OAAO,MAAM,IAAI;AAAA,IACnD,MAAM,OAAO,SAAS,OAAO,KAAK,SAAS,GAAG,IAAI,KAAK,MAAM,GAAG,EAAE,IAAI;AAAA,IACtE,MAAM,cAAc,eAAe,MAAM,UAAU,QAAQ;AAAA,IAC3D,IAAI,gBAAgB,WAAW;AAAA,MAC7B;AAAA,IACF;AAAA,IACA,MAAM,UAAU,MAAM,SAAS,MAAM,MAAM,QAAQ,QAAQ,UAAU;AAAA,IACrE,OAAO,KAAK,MAAM,QAAQ,MAAM,IAAI,cAAc;AAAA,IAClD,SAAS,SAAS,OAAO;AAAA,IACzB,SAAS;AAAA,EACX;AAAA,EACA,OAAO,UAAU,IAAI,OAAO,MAAM,KAAK,MAAM,MAAM;AAAA;AAe9C,IAAM,uBAAuB,CAClC,QACA,UACA,WAAW,OACS;AAAA,EACpB,IAAI,QAAoB;AAAA,EACxB,IAAI,QAAQ;AAAA,EACZ,MAAM,QAAQ,OAAO,MAAM;AAAA,CAAI,EAAE,IAAI,CAAC,SAAS;AAAA,IAC7C,MAAM,OAAO,eAAe,MAAM,KAAK;AAAA,IACvC,MAAM,UAAU,UAAU,QAAQ,SAAS;AAAA,IAC3C,QAAQ;AAAA,IACR,IAAI,SAAS;AAAA,MACX,OAAO;AAAA,IACT;AAAA,IACA,MAAM,gBAAgB,YAAY,MAAM,UAAU,QAAQ;AAAA,IAC1D,IAAI,kBAAkB,MAAM;AAAA,MAC1B,SAAS;AAAA,IACX;AAAA,IACA,OAAO;AAAA,GACR;AAAA,EACD,OAAO,EAAE,OAAO,MAAM,MAAM,KAAK;AAAA,CAAI,EAAE;AAAA;AAOzC,IAAM,gBAAgB;AAGtB,IAAM,aAAa,CAAC,IAAY,gBAC9B,cACI;AAAA;AAAA,WAA2E;AAAA,IAC3E;AAAA;AAAA;AAAA,wBAAmE;AAAA,yBAAmC;AAAA;AAAA;AASrG,IAAM,wBAAwB,OACnC,YACA,OACqB;AAAA,EACrB,IAAI;AAAA,EACJ,IAAI;AAAA,IACF,OAAO,MAAM,SAAS,YAAY,OAAO;AAAA,IACzC,MAAM;AAAA,IACN,OAAO;AAAA;AAAA,EAET,MAAM,QAAQ,KAAK,MAAM,0BAA0B;AAAA,EACnD,IAAI,CAAC,SAAS,MAAM,UAAU,WAAW;AAAA,IACvC,OAAO;AAAA,EACT;AAAA,EACA,MAAM,WAAW,MAAM,SAAS,MAAM,QAAQ,MAAM,UAAU;AAAA,EAE9D,MAAM,YAAY,KAAK,YAAY;AAAA,GAAM,MAAM,KAAK,IAAI;AAAA,EACxD,MAAM,SAAS,KAAK,MAAM,SAAS,EAAE,MAAM,OAAO,IAAI,MAAM;AAAA,EAC5D,MAAM,OAAO,KAAK,MAAM,QAAQ;AAAA,EAIhC,MAAM,MAAM,UAAU,KAAK,IAAI,IAAI;AAAA,EACnC,IAAI;AAAA,EACJ,IAAI,KAAK,UAAU,EAAE,WAAW,GAAG,GAAG;AAAA,IACpC,QAAQ,UAAU;AAAA,EACpB,EAAO,SAAI,KAAK;AAAA,IACd,QAAQ,GAAG,MAAM,kBAAkB;AAAA,EACrC,EAAO;AAAA,IACL,QAAQ,UAAU;AAAA;AAAA,EAEpB,MAAM,gBAAgB,YAAY,KAAK,MAAM,GAAG,QAAQ,IAAI,QAAQ,IAAI;AAAA,EACxE,OAAO;AAAA;AAIT,IAAM,gBAAgB;AAUf,IAAM,sBAAsB,OACjC,YACA,OACqB;AAAA,EACrB,IAAI;AAAA,EACJ,IAAI;AAAA,IACF,OAAO,MAAM,SAAS,YAAY,OAAO;AAAA,IACzC,MAAM;AAAA,IACN,OAAO;AAAA;AAAA,EAET,MAAM,UAAU,CAAC,GAAG,KAAK,SAAS,aAAa,CAAC;AAAA,EAChD,OAAO,SAAS;AAAA,EAChB,IAAI,QAAQ,WAAW,KAAK,CAAC,SAAS,kBAAkB,KAAK,IAAI,GAAG;AAAA,IAClE,OAAO;AAAA,EACT;AAAA,EACA,MAAM,WAAW,MAAM,QAAQ,MAAM,GAAG;AAAA,EACxC,MAAM,OAAO,KAAK,MAAM,QAAQ;AAAA,EAChC,MAAM,MAAM,KAAK,SAAS;AAAA,CAAM,IAAI;AAAA,IAAS;AAAA;AAAA,EAC7C,MAAM,YAAY,KAAK,YAAY;AAAA,GAAM,MAAM,KAAK,IAAI;AAAA,EACxD,MAAM,QAAQ,WAAW,KAAK,KAAK,MAAM,SAAS,CAAC,IAAI,MAAM;AAAA,EAE7D,MAAM,SACJ,mCAAmC,KAAK,IAAI,GAAG,QAAQ,UACvD,GAAG;AAAA,EACL,MAAM,QAAQ;AAAA,IACZ;AAAA,IACA,uBAAuB;AAAA,IACvB,wBAAwB;AAAA,IACxB;AAAA,EACF,EACG,IAAI,CAAC,SAAS,GAAG,SAAS,MAAM,EAChC,KAAK,GAAG;AAAA,EACX,MAAM,OAAO,KAAK,UAAU;AAAA,EAC5B,IAAI;AAAA,EACJ,IAAI,KAAK,WAAW,GAAG,GAAG;AAAA,IAExB,OAAO,GAAG,MAAM,QAAQ;AAAA,EAC1B,EAAO,SAAI,gBAAgB,KAAK,IAAI,GAAG;AAAA,IACrC,OAAO;AAAA,EACT,EAAO;AAAA,IAEL,OAAO,GAAG,MAAM,SAAS;AAAA;AAAA,EAE3B,MAAM,gBACJ,YACA,GAAG,KAAK,MAAM,GAAG,QAAQ,IAAI,MAAM,QAAQ,MAC7C;AAAA,EACA,OAAO;AAAA;AAYF,IAAM,kCAAkC,CAC7C,YACiB;AAAA,EACjB,IAAI,QAAQ,OAAO,UAAU;AAAA,IAC3B,OAAO,CAAC;AAAA,EACV;AAAA,EACA,QAAQ,gBAAgB,QAAQ;AAAA,EAChC,MAAM,UAAU,IAAI;AAAA,EACpB,WAAW,QAAQ,QAAQ,MAAM,OAAO;AAAA,IACtC,OAAO,UAAU,QAAQ,KAAK,aAC1B,SAAS,aAAa,KAAK,UAAU,EAAE,MAAM,GAAG,IAChD,CAAC;AAAA,IACL,IAAI,SAAS,KAAK,SAAS,KAAK,aAAa,KAAK,KAAK,GAAG;AAAA,MACxD,QAAQ,IAAI,KAAK;AAAA,IACnB;AAAA,EACF;AAAA,EACA,OAAO,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,YAAY;AAAA,IAC9C,MAAM;AAAA,IACN,MAAM,KAAK,aAAa,MAAM;AAAA,IAC9B,SAAS,WAAW,uHAAuH;AAAA,IAC3I,UAAU;AAAA,IACV,YAAY,wEAAwE,kCAAkC;AAAA,EACxH,EAAE;AAAA;AASG,IAAM,aAAa,OACxB,MACA,IACA,UAA+B,CAAC,MACT;AAAA,EACvB,IAAI,CAAC,WAAW,KAAK,EAAE,GAAG;AAAA,IACxB,MAAM,IAAI,SACR,8HAA8H,MAChI;AAAA,EACF;AAAA,EAEA,MAAM,UAAU,MAAM,YAAY,IAAI;AAAA,EACtC,MAAM,SAAS,QAAQ,YAAY,OACjC,CAAC,eAAe,WAAW,aAAa,OAC1C;AAAA,EACA,IAAI,OAAO,SAAS,GAAG;AAAA,IACrB,MAAM,IAAI,SACR,mBAAmB,OAAO,0FAC5B;AAAA,EACF;AAAA,EAGA,QAAQ,gBAAgB,QAAQ;AAAA,EAChC,IAAI,QAAQ,OAAO,UAAU,SAAS,KAAK,CAAC,YAAY,QAAQ,OAAO,EAAE,GAAG;AAAA,IAC1E,MAAM,IAAI,SACR,YAAY,iDACd;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,KAAK,aAAa,EAAE;AAAA,EAChC,IAAI,WAAW,GAAG,GAAG;AAAA,IACnB,IAAI,CAAC,QAAQ,OAAO;AAAA,MAClB,MAAM,IAAI,SACR,GAAG,8DACL;AAAA,IACF;AAAA,IACA,MAAM,GAAG,KAAK,EAAE,OAAO,MAAM,WAAW,KAAK,CAAC;AAAA,EAChD;AAAA,EAOA,MAAM,WAAW,IAAI,IAAI;AAAA,IACvB;AAAA,IACA;AAAA,IACA,GAAI,QAAQ,OAAO,UAAU,SAAS,IAAI,CAAC,YAAY,QAAQ,EAAE,KAAK,CAAC;AAAA,EACzE,CAAC;AAAA,EAMD,MAAM,eAAe,QAAQ,QAC1B,QAAQ,CAAC,WACR,OAAO,UAAU,OAAO,cAAc,CAAC,OAAO,WAAW,IAAI,CAAC,CAChE,EACC,OAAO,CAAC,SAAS,SAAS,aAAa,IAAI,CAAC;AAAA,EAC/C,MAAM,YAAY,CAAC,SACjB,aAAa,KAAK,CAAC,SAAS,SAAS,MAAM,IAAI,CAAC;AAAA,EAClD,MAAM,UAAU,MAAM,QAAQ,aAAa,EAAE,eAAe,KAAK,CAAC;AAAA,EAClE,IAAI,SAAS;AAAA,EACb,MAAM,QAAQ,IACZ,QAAQ,IAAI,OAAO,UAAU;AAAA,IAC3B,IACE,SAAS,IAAI,MAAM,IAAI,KACvB,MAAM,KAAK,WAAW,GAAG,KACxB,MAAM,YAAY,KAAK,aAAa,KAAK,MAAM,IAAI,GACpD;AAAA,MACA;AAAA,IACF;AAAA,IACA,MAAM,GAAG,KAAK,aAAa,MAAM,IAAI,GAAG,KAAK,KAAK,MAAM,IAAI,GAAG;AAAA,MAC7D,QAAQ,CAAC,WAAW,CAAC,UAAU,MAAM;AAAA,MACrC,WAAW;AAAA,IACb,CAAC;AAAA,GACF,CACH;AAAA,EAGA,MAAM,WAAW,mBAAmB,SAAS,EAAE;AAAA,EAC/C,MAAM,YAA+C,CAAC;AAAA,EACtD,MAAM,OAAO,OAAO,YAAmC;AAAA,IACrD,MAAM,WAAW,MAAM,QAAQ,SAAS,EAAE,eAAe,KAAK,CAAC;AAAA,IAC/D,MAAM,QAAQ,IACZ,SAAS,IAAI,OAAO,UAAU;AAAA,MAC5B,MAAM,MAAM,KAAK,SAAS,MAAM,IAAI;AAAA,MACpC,IAAI,MAAM,YAAY,GAAG;AAAA,QACvB,MAAM,KAAK,GAAG;AAAA,QACd;AAAA,MACF;AAAA,MACA,UAAU;AAAA,MACV,IAAI,CAAC,WAAW,KAAK,MAAM,IAAI,GAAG;AAAA,QAChC;AAAA,MACF;AAAA,MACA,MAAM,SAAS,MAAM,SAAS,KAAK,OAAO;AAAA,MAC1C,QAAQ,MAAM,UAAU,qBACtB,QACA,UACA,QAAQ,OAAO,QACjB;AAAA,MACA,IAAI,QAAQ,GAAG;AAAA,QACb,MAAM,gBAAgB,KAAK,IAAI;AAAA,QAC/B,UAAU,KAAK,EAAE,OAAO,MAAM,SAAS,KAAK,GAAG,EAAE,CAAC;AAAA,MACpD;AAAA,KACD,CACH;AAAA;AAAA,EAEF,MAAM,KAAK,GAAG;AAAA,EAEd,MAAM,aACJ,QAAQ,QAAQ,cAAc,KAAK,MAAM,iBAAiB;AAAA,EAC5D,MAAM,eAAe,QAAQ,OAAO,aAAa;AAAA,EACjD,MAAM,gBAAgB,eAClB,MAAM,oBAAoB,YAAY,EAAE,IACxC,MAAM,sBAAsB,YAAY,EAAE;AAAA,EAE9C,OAAO;AAAA,IACL,eAAe,gBAAgB,OAAO,WAAW,IAAI,CAAC,YAAY;AAAA,IAClE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,eAAe,iBAAiB;AAAA,EAClC;AAAA;",
-  "debugId": "8631919BA7BA49B664756E2164756E21",
+  "debugId": "1864DE871652686F64756E2164756E21",
   "names": []
 }

package/dist/cli/{chunk-36bxs9c7.js → chunk-nqna8dzp.js}

@@ -7,50 +7,51 @@ import {
 } from "./index.js";
 import {
   deployPlatform
-} from "./chunk-124fvmzq.js";
+} from "./chunk-r5nm9w0c.js";
+import"./chunk-zxd5jrgx.js";
 import"./chunk-zccbjcj0.js";
-import"./chunk-0pmb4tr4.js";
+import {
+  refuseIfEjected
+} from "./chunk-e1n41w9m.js";
 import {
   publishBuildProject,
   ogCacheDir,
   pruneCardCache,
   cardCacheTally
-} from "./chunk-nbyvgnnm.js";
-import"./chunk-desvm72z.js";
+} from "./chunk-hktq4j5r.js";
+import"./chunk-b680sv30.js";
 import {
   deployOutputDir,
   deployStaticDir,
   surfaceAdapterOutput
-} from "./chunk-dpy8qdjf.js";
+} from "./chunk-k45sq16q.js";
+import"./chunk-487b95qy.js";
 import {
   ensureGitignore
 } from "./chunk-yzhm0j9q.js";
-import"./chunk-j1x92mx9.js";
+import"./chunk-j4nfgn2j.js";
 import {
   removedBuildFlags,
   flagList,
   removedBuildFlagsAdvice
-} from "./chunk-9qzgg6mj.js";
+} from "./chunk-34wap3ed.js";
 import {
-  astroBuildDiagnostics
-} from "./chunk-150jk7km.js";
+  astroBuildDiagnostics,
+  buildFailureLocator
+} from "./chunk-4zxh25hc.js";
 import {
   refuseIfDevRunning
-} from "./chunk-tfycddbt.js";
-import {
-  refuseIfEjected
-} from "./chunk-53jqw8z0.js";
-import"./chunk-ckrcm08h.js";
+} from "./chunk-h0qwdbem.js";
+import"./chunk-rtvgmg2j.js";
 import"./chunk-jq5n4avg.js";
-import"./chunk-es8h0v3j.js";
-import"./chunk-dqhg54mr.js";
+import"./chunk-9h8mh2tk.js";
 import {
   prepareProject
-} from "./chunk-297ajdcv.js";
+} from "./chunk-t2h8pwy1.js";
 import {
   serverFeatures
-} from "./chunk-ms9z66nz.js";
-import"./chunk-s0bdnc7v.js";
+} from "./chunk-gwy55cx3.js";
+import"./chunk-q1wwrxzw.js";
 
 // src/cli/commands/build.ts
 import { existsSync } from "node:fs";
@@ -169,7 +170,7 @@ var reportBuild = async (project, distDir, args) => {
 `));
   await runClientAssetChecks(distDir, args);
   if (project.droppedPages > 0) {
-    logger.warn(`${project.droppedPages} page(s) failed frontmatter validation and are missing from this build.`);
+    logger.warn(`${project.droppedPages} page(s) failed validation and are missing from this build.`);
   }
   logger.success(`Built to ${distDir}`);
 };
@@ -236,7 +237,10 @@ var buildCommand = defineCommand({
       if (error instanceof BlumeError || !(error instanceof Error)) {
         throw error;
       }
-      reportDiagnostics(astroBuildDiagnostics(error), root);
+      reportDiagnostics(await astroBuildDiagnostics(error, {
+        locate: buildFailureLocator(project),
+        root
+      }), root);
       process.exit(1);
     }
     await reportCardCache(project, !runtimeDir);
@@ -271,5 +275,5 @@ export {
   runClientAssetChecks
 };
 
-//# debugId=5EAF9E033A01BFBE64756E2164756E21
-//# sourceMappingURL=chunk-36bxs9c7.js.map
+//# debugId=43360653920765D464756E2164756E21
+//# sourceMappingURL=chunk-nqna8dzp.js.map

package/dist/cli/chunk-nqna8dzp.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 { BlumeError } from \"../../core/diagnostics.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 {\n  astroBuildDiagnostics,\n  buildFailureLocator,\n} from \"../build-failure.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { refuseIfDevRunning } from \"../dev-lock.ts\";\nimport { refuseIfEjected } from \"../eject-scripts.ts\";\nimport { logger, reportDiagnostics } 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 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    try {\n      await build({\n        logLevel: \"info\",\n        root: project.context.outDir,\n      });\n    } catch (error) {\n      // Astro rejects when the site fails to compile or render (MDX that\n      // doesn't parse, a component that throws): report that as a build error\n      // at the file it names, not as an internal error blaming Blume. A\n      // BlumeError keeps its own diagnostic.\n      if (error instanceof BlumeError || !(error instanceof Error)) {\n        throw error;\n      }\n      reportDiagnostics(\n        await astroBuildDiagnostics(error, {\n          locate: buildFailureLocator(project),\n          root,\n        }),\n        root\n      );\n      process.exit(1);\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": "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",
+  "debugId": "43360653920765D464756E2164756E21",
+  "names": []
+}

package/dist/cli/{chunk-a57yh0h9.js → chunk-p834rkcn.js}

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
-import"./chunk-124fvmzq.js";
-import"./chunk-zccbjcj0.js";
+import"./chunk-r5nm9w0c.js";
 import {
   packageRoot,
   getBlumeVersion,
@@ -10,16 +9,17 @@ import {
   logger,
   reportDiagnostics
 } from "./index.js";
+import"./chunk-zccbjcj0.js";
 import {
   AGENTS,
   launchInstalledAgent
-} from "./chunk-dv2z0rzf.js";
+} from "./chunk-aafhwx74.js";
 import {
   scanProject
-} from "./chunk-0pmb4tr4.js";
+} from "./chunk-zxd5jrgx.js";
 import {
   siteSkillName
-} from "./chunk-s0bdnc7v.js";
+} from "./chunk-q1wwrxzw.js";
 
 // src/cli/commands/skill.ts
 import { defineCommand } from "citty";
@@ -122,5 +122,5 @@ export {
   skillCommand
 };
 
-//# debugId=3CB1C251215B1BE964756E2164756E21
-//# sourceMappingURL=chunk-a57yh0h9.js.map
+//# debugId=8BB2AE139A5F70AE64756E2164756E21
+//# sourceMappingURL=chunk-p834rkcn.js.map

package/dist/cli/{chunk-a57yh0h9.js.map → chunk-p834rkcn.js.map}

@@ -6,6 +6,6 @@
     "import { existsSync } from \"node:fs\";\n\nimport { join, relative, resolve } from \"pathe\";\n\nimport type { BlumeProject } from \"../core/project-graph.ts\";\nimport { siteSkillName } from \"./site-skill.ts\";\n\n/**\n * `blume skill`'s logic, kept out of the command module so it runs (and is\n * covered) in-process. Writing a product skill is judgment work — what the\n * product is, which tasks matter, where it bites — so it lives in the\n * `blume-write-skill` skill, shipped inside the package. This module only\n * works out where the skill goes and writes the prompt that points a coding\n * agent at the skill and the docs.\n */\n\n/** The skill's directory inside the published package. */\nexport const WRITE_SKILL_DIR = join(\"skills\", \"blume-write-skill\");\n\n/** Where `agents.skills` points when the config doesn't set it. */\nconst DEFAULT_SKILLS_DIR = \"skills\";\n\n/** Where the skill goes, and what the agent needs to know to write it. */\nexport interface SkillPlan {\n  /** The `agents.skills` value to add, when the config has none. */\n  configure?: string;\n  /** The config file to add it to, relative to the project root. */\n  configFile: string;\n  /** The content root, relative to the project root. */\n  contentRoot: string;\n  /** Whether a skill is already there to update. */\n  exists: boolean;\n  /** Where to write the skill, relative to the project root. */\n  file: string;\n  /** The skill's name: the generated site skill's, so it replaces it. */\n  name: string;\n  /** The site's URL, for the skill's absolute links. */\n  site?: string;\n  title: string;\n}\n\n/** Plan the skill for a scanned project. */\nexport const planSkill = (project: BlumeProject): SkillPlan => {\n  const { config, context } = project;\n  const name = siteSkillName(project);\n  const file = resolve(\n    context.root,\n    config.agents.skills ?? DEFAULT_SKILLS_DIR,\n    name,\n    \"SKILL.md\"\n  );\n  const plan: SkillPlan = {\n    configFile: context.configFile\n      ? relative(context.root, context.configFile)\n      : \"blume.config.ts\",\n    contentRoot: relative(context.root, context.contentRoot) || \".\",\n    exists: existsSync(file),\n    file: relative(context.root, file),\n    name,\n    site: config.deployment.options.site,\n    title: config.title,\n  };\n  return config.agents.skills\n    ? plan\n    : { ...plan, configure: `./${DEFAULT_SKILLS_DIR}` };\n};\n\n/** The prompt that hands the plan to a coding agent. */\nexport const writeSkillPrompt = (\n  plan: SkillPlan,\n  options: { skillDir: string; version: string }\n): string => {\n  const { skillDir, version } = options;\n  const lines = [\n    `Write the agent skill for the ${plan.title} docs, a Blume ${version} site.`,\n    \"\",\n    `Follow the blume-write-skill skill: read ${join(skillDir, \"SKILL.md\")} first and work through its workflow.`,\n    \"\",\n    plan.exists\n      ? `A skill already exists at ${plan.file}. Update it against the current docs rather than starting over, and keep what's still true.`\n      : `Write it to ${plan.file}.`,\n    `Its frontmatter \\`name\\` must be \\`${plan.name}\\`: that's the name of the skill Blume generates for this site, and a skill with the same name replaces it.`,\n  ];\n  if (plan.configure) {\n    lines.push(\n      `Then set \\`agents.skills: \"${plan.configure}\"\\` in ${plan.configFile} so the build publishes it.`\n    );\n  }\n  lines.push(\n    \"\",\n    `The docs source is in ${plan.contentRoot}.`,\n    plan.site\n      ? `The site is served at ${plan.site}, so link pages as ${plan.site.replace(/\\/$/u, \"\")}<route>.md.`\n      : `The config has no \\`deployment.site\\`, and the skill's links must be absolute. Ask me for the site's URL, and set it as \\`deployment.site\\` in ${plan.configFile}.`\n  );\n  return lines.join(\"\\n\");\n};\n"
   ],
   "mappings": "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",
-  "debugId": "3CB1C251215B1BE964756E2164756E21",
+  "debugId": "8BB2AE139A5F70AE64756E2164756E21",
   "names": []
 }

package/dist/cli/{chunk-60hz265r.js → chunk-ppa6mg4d.js}

@@ -1,10 +1,13 @@
 #!/usr/bin/env node
 import {
+  referenceRoutes,
+  resolveDocsCollection,
   discoverPages,
   customStaticRoutes,
   hasGeneratedChangelog,
+  buildManifest,
   validateLinks
-} from "./chunk-124fvmzq.js";
+} from "./chunk-r5nm9w0c.js";
 import {
   commandMeta,
   reportInternalError,
@@ -14,17 +17,21 @@ import {
   reportDiagnosticsJson,
   reportDiagnostics
 } from "./index.js";
-import"./chunk-zccbjcj0.js";
 import {
-  buildManifest,
   scanProject
-} from "./chunk-0pmb4tr4.js";
+} from "./chunk-zxd5jrgx.js";
+import {
+  normalizeBasePath
+} from "./chunk-zccbjcj0.js";
+import {
+  generatedFilePaths
+} from "./chunk-487b95qy.js";
 import {
   parseIgnoreFlag
-} from "./chunk-74wfhv79.js";
+} from "./chunk-fnxgtjeq.js";
+import"./chunk-q1wwrxzw.js";
 
 // src/cli/commands/validate.ts
-import { existsSync } from "node:fs";
 import { defineCommand } from "citty";
 import { join } from "pathe";
 var validateCommand = defineCommand({
@@ -56,7 +63,10 @@ var validateCommand = defineCommand({
       const project = await scanProject(root, { mode: "build" });
       diagnostics.push(...project.diagnostics);
       const userPages = project.context.pagesRoot ? await discoverPages(project.context.pagesRoot) : [];
-      const extraRoutes = customStaticRoutes(userPages);
+      const extraRoutes = [
+        ...customStaticRoutes(userPages),
+        ...referenceRoutes(project.config)
+      ];
       if (hasGeneratedChangelog(project, userPages)) {
         extraRoutes.push("/changelog");
       }
@@ -68,14 +78,17 @@ var validateCommand = defineCommand({
         });
         extraRoutes.push(...manifest.routes.flatMap((route) => route.fallback ? [route.path] : []));
       }
-      const publicDir = join(root, "public");
       diagnostics.push(...await validateLinks(project.graph, {
         basePath: project.config.basePath,
         checkExternal: Boolean(args.external),
+        configFile: project.context.configFile ?? undefined,
+        contentRoot: resolveDocsCollection(project.config, root).base,
+        deployBase: normalizeBasePath(project.config.deployment.options.base),
         extraRoutes,
+        generatedFiles: generatedFilePaths(project),
         i18n: project.config.i18n,
         ignore,
-        publicDir: existsSync(publicDir) ? publicDir : null,
+        publicDir: join(root, "public"),
         redirects: project.config.redirects
       }));
     } catch (error) {
@@ -108,5 +121,5 @@ export {
   validateCommand
 };
 
-//# debugId=8AE58981D23D676D64756E2164756E21
-//# sourceMappingURL=chunk-60hz265r.js.map
+//# debugId=0B908AF983A1FB4C64756E2164756E21
+//# sourceMappingURL=chunk-ppa6mg4d.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/validate.ts"],
+  "sourcesContent": [
+    "import { defineCommand } from \"citty\";\nimport { join } from \"pathe\";\n\nimport {\n  customStaticRoutes,\n  discoverPages,\n  hasGeneratedChangelog,\n} from \"../../astro/pages.ts\";\nimport { normalizeBasePath } from \"../../core/base-path.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 { resolveDocsCollection } from \"../../core/sources/collection.ts\";\nimport type { Diagnostic } from \"../../core/types.ts\";\nimport { generatedFilePaths } from \"../../deploy/generated-files.ts\";\nimport { referenceRoutes } from \"../../openapi/references.ts\";\nimport { parseIgnoreFlag } from \"../args.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    ignore: {\n      description:\n        'With --external, skip external links whose URL matches this glob (e.g. \"https://example.com/**\"). Repeat it for more; internal links are always checked.',\n      type: \"string\",\n      valueHint: \"glob\",\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, rawArgs }) {\n    const root = process.cwd();\n    const ignore = parseIgnoreFlag(rawArgs);\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, reference routes (a `scalar()` page), and the\n      // generated changelog index are servable routes the content graph can't\n      // see — without them, a docs link to e.g. a custom landing page fails as\n      // BLUME_BROKEN_LINK.\n      const userPages = project.context.pagesRoot\n        ? await discoverPages(project.context.pagesRoot)\n        : [];\n      const extraRoutes = [\n        ...customStaticRoutes(userPages),\n        ...referenceRoutes(project.config),\n      ];\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      // Links to `public/` files and to the files the build generates\n      // (`/llms.txt`, `/sitemap.xml`) resolve too. With no `public/` folder,\n      // the site ships no public files, so links to one are reported.\n      diagnostics.push(\n        ...(await validateLinks(project.graph, {\n          basePath: project.config.basePath,\n          checkExternal: Boolean(args.external),\n          configFile: project.context.configFile ?? undefined,\n          contentRoot: resolveDocsCollection(project.config, root).base,\n          deployBase: normalizeBasePath(project.config.deployment.options.base),\n          extraRoutes,\n          generatedFiles: generatedFilePaths(project),\n          i18n: project.config.i18n,\n          ignore,\n          publicDir: join(root, \"public\"),\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 stay\n    // 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": "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",
+  "debugId": "0B908AF983A1FB4C64756E2164756E21",
+  "names": []
+}

package/dist/cli/{chunk-s0bdnc7v.js → chunk-q1wwrxzw.js}

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
 import {
   asciiSlugify
-} from "./chunk-124fvmzq.js";
+} from "./chunk-r5nm9w0c.js";
 
 // src/ai/site-skill.ts
 var NAME_MAX = 64;
+var SKILL_MD_PATH = "/skill.md";
 var siteSkillName = (project) => {
   const { site } = project.config.deployment.options;
   const fromTitle = asciiSlugify(project.config.title);
@@ -12,7 +13,7 @@ var siteSkillName = (project) => {
   return name.slice(0, NAME_MAX).replace(/-+$/u, "");
 };
 
-export { siteSkillName };
+export { SKILL_MD_PATH, siteSkillName };
 
-//# debugId=D5EE89A8D7931D3164756E2164756E21
-//# sourceMappingURL=chunk-s0bdnc7v.js.map
+//# debugId=CA3AF8894895500A64756E2164756E21
+//# sourceMappingURL=chunk-q1wwrxzw.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/ai/site-skill.ts"],
+  "sourcesContent": [
+    "import { hasGeneratedChangelog } from \"../astro/pages.ts\";\nimport {\n  mountBasePath,\n  normalizeBasePath,\n  withBasePath,\n} from \"../core/base-path.ts\";\nimport { CHANGELOG_INDEX_ROUTE } from \"../core/changelog-index.ts\";\nimport { discoverPagesSync } from \"../core/custom-pages.ts\";\nimport { isHiddenPage } from \"../core/hidden-pages.ts\";\nimport { metaDescription } from \"../core/manifest.ts\";\nimport type { BlumeProject } from \"../core/project-graph.ts\";\nimport { absoluteUrl } from \"../core/site-url.ts\";\nimport type { NavNode, PageRecord } from \"../core/types.ts\";\nimport { resolveReferences } from \"../openapi/references.ts\";\nimport { docsPhrase } from \"./ai-catalog.ts\";\nimport { API_PAGES_PATH } from \"./api/paths.ts\";\nimport { asciiSlugify } from \"./mcp/discovery.ts\";\nimport {\n  SKILL_DESCRIPTION_MAX,\n  generatesSiteSkill,\n  skillMdArtifact,\n} from \"./skills.ts\";\nimport type { SkillArtifact } from \"./skills.ts\";\n\n/**\n * The site's own agent skill (`agents.skillMd`): a `SKILL.md` in the Agent\n * Skills format, built from what the build already knows — the site's title\n * and description, how to read any page as Markdown, llms.txt and the MCP\n * server, the API references, and a map of the docs with each page's one-line\n * description. No model writes it, so it costs nothing and is current with\n * every build: a guide to the docs rather than a summary of the product. A\n * hand-written skill of the same name in `agents.skills` replaces it.\n */\n\n/** The most pages the map lists; llms.txt holds the rest. */\nexport const MAX_SKILL_PAGES = 200;\n\n/** The Agent Skills spec caps a skill name at 64 characters. */\nconst NAME_MAX = 64;\n\n/** Where the site skill is served besides the discovery index. */\nexport const SKILL_MD_PATH = \"/skill.md\";\n\n/**\n * The site skill's name: the title as a skill name (lowercase alphanumerics\n * and single hyphens), else the site's host, for a title with no Latin\n * letters in it.\n */\nexport const siteSkillName = (project: BlumeProject): string => {\n  const { site } = project.config.deployment.options;\n  const fromTitle = asciiSlugify(project.config.title);\n  const name =\n    fromTitle || asciiSlugify(site ? new URL(site).hostname : \"\") || \"docs\";\n  return name.slice(0, NAME_MAX).replace(/-+$/u, \"\");\n};\n\n/** A title as Markdown link text (brackets escaped, as in llms.txt). */\nconst linkText = (title: string): string =>\n  title.replaceAll(/[\\\\[\\]]/gu, String.raw`\\$&`);\n\n/**\n * Current-version, default-locale pages worth listing: not API operations,\n * and not changelog entries, which the changelog index covers in one line.\n */\nconst mappedPages = (project: BlumeProject): PageRecord[] => {\n  const defaultLocale = project.config.i18n?.defaultLocale;\n  return project.graph.pages.filter(\n    (page) =>\n      !(\n        page.meta.ai.exclude ||\n        page.meta.draft ||\n        isHiddenPage(page, project.graph) ||\n        page.meta.seo.noindex ||\n        page.version !== \"\" ||\n        page.source.name === \"openapi\" ||\n        page.contentType === \"changelog\"\n      ) &&\n      (defaultLocale === undefined || page.locale === defaultLocale)\n  );\n};\n\n/** Renders the page map, listing each page once, up to the cap. */\nclass PageMap {\n  readonly #byRoute: Map<string, PageRecord>;\n  readonly #listed = new Set<string>();\n  readonly #url: (route: string) => string;\n\n  constructor(pages: PageRecord[], url: (route: string) => string) {\n    this.#byRoute = new Map(pages.map((page) => [page.route, page]));\n    this.#url = url;\n  }\n\n  /** How many listable pages the cap left out. */\n  get omitted(): number {\n    return this.#byRoute.size - this.#listed.size;\n  }\n\n  /** The Markdown link line for a route, or nothing when it isn't listed. */\n  line(route: string): string[] {\n    const page = this.#byRoute.get(route);\n    if (\n      !page ||\n      this.#listed.has(route) ||\n      this.#listed.size >= MAX_SKILL_PAGES\n    ) {\n      return [];\n    }\n    this.#listed.add(route);\n    // As `llms.txt` lists it: the page's meta description.\n    const description = metaDescription(page);\n    const summary = description ? `: ${description}` : \"\";\n    return [`- [${linkText(page.title)}](${this.#url(route)})${summary}`];\n  }\n\n  /** One navigation level: its loose pages, then each group under a heading. */\n  level(nodes: NavNode[], depth: number): string[] {\n    const list: string[] = [];\n    const groups: string[] = [];\n    for (const node of nodes) {\n      if (node.kind === \"page\") {\n        list.push(...this.line(node.route));\n        continue;\n      }\n      const blocks = [\n        ...(node.route ? this.line(node.route) : []),\n        ...this.level(node.children, depth + 1),\n      ];\n      if (blocks.length > 0) {\n        groups.push(\n          \"\",\n          `${\"#\".repeat(Math.min(depth, 6))} ${node.label}`,\n          \"\",\n          ...blocks\n        );\n      }\n    }\n    return [...list, ...groups];\n  }\n\n  /** Pages the navigation doesn't reach, in route order. */\n  rest(): string[] {\n    return [...this.#byRoute.keys()]\n      .toSorted((a, b) => a.localeCompare(b))\n      .flatMap((route) => this.line(route));\n  }\n}\n\n/** The \"Reading the docs\" bullets: every agent surface the site serves. */\nconst surfaceLines = (\n  project: BlumeProject,\n  url: (path: string) => string\n): string[] => {\n  const { agents } = project.config;\n  const lines = [\n    `- Any page as Markdown: add \\`.md\\` to its URL (the home page is ${url(\"/index.md\")}). Every page link below already points at the Markdown.`,\n  ];\n  if (agents.llmsTxt.enabled) {\n    lines.push(\n      `- [llms.txt](${url(\"/llms.txt\")}): every page with a one-line summary.`,\n      `- [llms-full.txt](${url(\"/llms-full.txt\")}): every page in one file, for when you need all of it.`\n    );\n  }\n  if (agents.mcp.enabled) {\n    lines.push(\n      `- MCP server at ${url(agents.mcp.route)}, with \\`search_docs\\`, \\`get_page\\`, \\`list_pages\\`, and \\`get_navigation\\`. Connect it to search the docs instead of guessing URLs.`\n    );\n  }\n  if (agents.api) {\n    lines.push(\n      `- [JSON API](${url(API_PAGES_PATH)}): the page index, with each page as JSON and Markdown.`\n    );\n  }\n  const userPages = project.context.pagesRoot\n    ? discoverPagesSync(project.context.pagesRoot)\n    : [];\n  if (hasGeneratedChangelog(project, userPages)) {\n    lines.push(\n      `- [Changelog](${url(`${CHANGELOG_INDEX_ROUTE}.md`)}): release notes, newest first.`\n    );\n  }\n  return lines;\n};\n\n/** The \"API reference\" bullets, one per rendered reference. */\nconst referenceLines = (\n  project: BlumeProject,\n  url: (path: string) => string\n): string[] =>\n  resolveReferences(project.config).map((reference) => {\n    // Scalar renders its own page with no Markdown mirror; Blume-rendered\n    // references are pages like any other, one per operation.\n    const route =\n      reference.kind === \"scalar\"\n        ? reference.route\n        : withBasePath(reference.basePath, reference.route);\n    const pages =\n      reference.kind === \"scalar\"\n        ? \"\"\n        : \", with a page per operation (add `.md` for its Markdown)\";\n    return `- [${linkText(reference.label)}](${url(route)})${pages}.`;\n  });\n\n/** The skill's frontmatter `description`: what it's for and when to use it. */\nconst skillDescription = (project: BlumeProject): string => {\n  const { description, title } = project.config;\n  const summary = description ? ` ${description.trim()}` : \"\";\n  return `Read ${docsPhrase(title, \"docs\")} instead of answering from memory.${summary} Use when a task involves ${title}: how it works, how to set it up or configure it, or its API.`.slice(\n    0,\n    SKILL_DESCRIPTION_MAX\n  );\n};\n\n/** The site skill's `SKILL.md`. */\nconst skillMarkdown = (project: BlumeProject, name: string): string => {\n  const { config } = project;\n  const { site = \"\" } = config.deployment.options;\n  const base = normalizeBasePath(config.deployment.options.base);\n  // Mounted and encoded like llms.txt's links.\n  const url = (path: string): string =>\n    encodeURI(absoluteUrl(site, mountBasePath(base, path)));\n  const markdownUrl = (route: string): string =>\n    url(route === \"/\" ? \"/index.md\" : `${route}.md`);\n\n  const map = new PageMap(mappedPages(project), markdownUrl);\n  const pages = [\n    ...map.level(project.graph.navigation.sidebar, 3),\n    ...map.rest(),\n  ];\n  const { omitted } = map;\n  if (omitted > 0) {\n    pages.push(\n      \"\",\n      config.agents.llmsTxt.enabled\n        ? `…and ${omitted} more. [llms.txt](${url(\"/llms.txt\")}) lists every page.`\n        : `…and ${omitted} more.`\n    );\n  }\n  const references = referenceLines(project, url);\n\n  return [\n    \"---\",\n    `name: ${name}`,\n    `description: ${JSON.stringify(skillDescription(project))}`,\n    \"---\",\n    \"\",\n    `# ${config.title}`,\n    \"\",\n    ...(config.description ? [config.description.trim(), \"\"] : []),\n    `This skill points you at ${docsPhrase(config.title, \"docs\")}, at ${url(\"/\")}. When a task involves ${config.title}, read the relevant page before relying on what you remember: the docs are the source of truth, and they change.`,\n    \"\",\n    \"## Reading the docs\",\n    \"\",\n    ...surfaceLines(project, url),\n    ...(references.length > 0\n      ? [\"\", \"## API reference\", \"\", ...references]\n      : []),\n    ...(pages.length > 0 ? [\"\", \"## Pages\", \"\", ...pages] : []),\n    \"\",\n  ]\n    .join(\"\\n\")\n    .replaceAll(/\\n{3,}/gu, \"\\n\\n\");\n};\n\n/**\n * The generated site skill, or `null` when `agents.skillMd` is off or there\n * is no `deployment.site` to make its links absolute.\n */\nexport const buildSiteSkill = (project: BlumeProject): SkillArtifact | null => {\n  if (!generatesSiteSkill(project.config)) {\n    return null;\n  }\n  const name = siteSkillName(project);\n  return skillMdArtifact(\n    name,\n    skillDescription(project),\n    skillMarkdown(project, name)\n  );\n};\n"
+  ],
+  "mappings": ";;;;;;AAsCA,IAAM,WAAW;AAGV,IAAM,gBAAgB;AAOtB,IAAM,gBAAgB,CAAC,YAAkC;AAAA,EAC9D,QAAQ,SAAS,QAAQ,OAAO,WAAW;AAAA,EAC3C,MAAM,YAAY,aAAa,QAAQ,OAAO,KAAK;AAAA,EACnD,MAAM,OACJ,aAAa,aAAa,OAAO,IAAI,IAAI,IAAI,EAAE,WAAW,EAAE,KAAK;AAAA,EACnE,OAAO,KAAK,MAAM,GAAG,QAAQ,EAAE,QAAQ,QAAQ,EAAE;AAAA;",
+  "debugId": "CA3AF8894895500A64756E2164756E21",
+  "names": []
+}

package/dist/cli/{chunk-ave1wcbr.js → chunk-qcyxkj44.js}

@@ -546,4 +546,4 @@ export {
 };
 
 //# debugId=E6710E6AD54250CC64756E2164756E21
-//# sourceMappingURL=chunk-ave1wcbr.js.map
+//# sourceMappingURL=chunk-qcyxkj44.js.map