blume 1.6.5 → 1.7.0

package/dist/cli/chunk-ey89bjj1.js

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+
+// src/core/diagnostics.ts
+import { colors } from "consola/utils";
+import { relative } from "pathe";
+
+class BlumeError extends Error {
+  diagnostic;
+  constructor(diagnostic) {
+    super(diagnostic.message);
+    this.name = "BlumeError";
+    this.diagnostic = diagnostic;
+  }
+}
+var DOCS_BASE = "https://useblume.dev";
+var DOCS_DEPLOYMENT = "/docs/deployment";
+var DOCS_REFERENCE_CLI = "/docs/reference/cli";
+var DOCS_CONTENT_SOURCES = "/docs/content/sources";
+var DOCS_CONTENT_NAVIGATION = "/docs/content/navigation";
+var DOCS_CONTENT_INCLUDES = "/docs/content/includes";
+var DOCS_PATHS = new Map(Object.entries({
+  BLUME_ADAPTER_REQUIRED: DOCS_DEPLOYMENT,
+  BLUME_ASSETS_UNCHECKED: DOCS_REFERENCE_CLI,
+  BLUME_ASSET_FETCH_FAILED: DOCS_CONTENT_SOURCES,
+  BLUME_BROKEN_ANCHOR: DOCS_REFERENCE_CLI,
+  BLUME_BROKEN_ASSET: DOCS_REFERENCE_CLI,
+  BLUME_BROKEN_LINK: DOCS_REFERENCE_CLI,
+  BLUME_CONFIG_INVALID: "/docs/configuration",
+  BLUME_CONFIG_LOAD_FAILED: "/docs/configuration",
+  BLUME_CONTENT_ROOT_MISSING: DOCS_CONTENT_SOURCES,
+  BLUME_DEAD_LINK: DOCS_REFERENCE_CLI,
+  BLUME_DUPLICATE_ROUTE: DOCS_CONTENT_NAVIGATION,
+  BLUME_DUPLICATE_SIDEBAR_ORDER: DOCS_CONTENT_NAVIGATION,
+  BLUME_FRONTMATTER_INVALID: "/docs/reference/frontmatter",
+  BLUME_INCLUDE_CYCLE: DOCS_CONTENT_INCLUDES,
+  BLUME_INCLUDE_NOT_FOUND: DOCS_CONTENT_INCLUDES,
+  BLUME_INCLUDE_OUTSIDE_ROOT: DOCS_CONTENT_INCLUDES,
+  BLUME_MDX_CURLY_ANCHOR: "/docs/content/syntax",
+  BLUME_META_INVALID: "/docs/content/meta",
+  BLUME_META_LOAD_FAILED: "/docs/content/meta",
+  BLUME_MISSING_SECRET: DOCS_DEPLOYMENT,
+  BLUME_NAV_DUPLICATE_LABEL: DOCS_CONTENT_NAVIGATION,
+  BLUME_NAV_HIDDEN_IN_SIDEBAR: DOCS_CONTENT_NAVIGATION,
+  BLUME_NAV_INDEX_TITLE_MISMATCH: DOCS_CONTENT_NAVIGATION,
+  BLUME_NAV_MISSING_PAGE: DOCS_CONTENT_NAVIGATION,
+  BLUME_NODE_VERSION: "/docs/quickstart",
+  BLUME_SERVER_FEATURE_REQUIRED: DOCS_DEPLOYMENT,
+  BLUME_SIDEBAR_DISPLAY_IGNORED: DOCS_CONTENT_NAVIGATION,
+  BLUME_SOURCE_FETCH_FAILED: DOCS_CONTENT_SOURCES,
+  BLUME_SOURCE_MISCONFIGURED: DOCS_CONTENT_SOURCES,
+  BLUME_SOURCE_OFFLINE: DOCS_CONTENT_SOURCES,
+  BLUME_SOURCE_SDK_MISSING: DOCS_CONTENT_SOURCES,
+  BLUME_SOURCE_UNAVAILABLE: DOCS_CONTENT_SOURCES,
+  BLUME_UNKNOWN_COMPONENT: "/docs/configuration/customization",
+  BLUME_UNKNOWN_ICON: DOCS_CONTENT_NAVIGATION,
+  BLUME_WIKILINK_AMBIGUOUS: DOCS_CONTENT_SOURCES,
+  BLUME_WIKILINK_UNRESOLVED: DOCS_CONTENT_SOURCES
+}));
+var resolveDocsUrl = (code) => {
+  const path = DOCS_PATHS.get(code);
+  return path ? `${DOCS_BASE}${path}` : undefined;
+};
+var enrichDiagnostic = (diagnostic) => diagnostic.docsUrl ? diagnostic : { ...diagnostic, docsUrl: resolveDocsUrl(diagnostic.code) };
+var REGEXP_SPECIAL = /[$()*+.?[\\\]^{|}]/gu;
+var escapeRegExp = (value) => value.replaceAll(REGEXP_SPECIAL, String.raw`\$&`);
+var isKeySegment = (segment) => typeof segment === "string";
+var stepSegment = (source, segment, cursor) => {
+  if (!isKeySegment(segment)) {
+    return { index: -1, next: cursor, stop: false };
+  }
+  const matcher = new RegExp(`(?<![\\w$])${escapeRegExp(segment)}\\s*[:=]`, "gu");
+  matcher.lastIndex = cursor;
+  const match = matcher.exec(source);
+  if (!match) {
+    return { index: -1, next: cursor, stop: true };
+  }
+  return { index: match.index, next: matcher.lastIndex, stop: false };
+};
+var locatePath = (source, path) => {
+  let cursor = 0;
+  let found = -1;
+  for (const segment of path) {
+    const step = stepSegment(source, segment, cursor);
+    if (step.stop) {
+      break;
+    }
+    cursor = step.next;
+    if (step.index >= 0) {
+      found = step.index;
+    }
+  }
+  if (found < 0) {
+    return;
+  }
+  const before = source.slice(0, found);
+  const lastNewline = before.lastIndexOf(`
+`);
+  return { column: found - lastNewline, line: before.split(`
+`).length };
+};
+var FRONTMATTER = /^---\r?\n(?<body>[\s\S]*?)\r?\n---/u;
+var locateFrontmatterKey = (source, path) => {
+  const block = FRONTMATTER.exec(source);
+  if (!block) {
+    return;
+  }
+  const position = locatePath(block.groups?.body ?? "", path);
+  return position && { column: position.column, line: position.line + 1 };
+};
+var diagnosticsFromIssues = (issues, options) => issues.map((issue) => {
+  const schemaPath = issue.path.join(".");
+  const position = options.source ? locatePath(options.source, issue.path) : undefined;
+  return {
+    code: options.code,
+    column: position?.column,
+    file: options.file,
+    line: position?.line,
+    message: schemaPath ? `${schemaPath}: ${issue.message}` : issue.message,
+    schemaPath: schemaPath || undefined,
+    severity: "error"
+  };
+});
+var diagnosticsFromZod = (error, options) => diagnosticsFromIssues(error.issues.map((issue) => ({
+  message: issue.message,
+  path: issue.path.filter((segment) => typeof segment !== "symbol")
+})), options);
+var severityColor = (severity) => {
+  if (severity === "error") {
+    return colors.red;
+  }
+  if (severity === "warning") {
+    return colors.yellow;
+  }
+  return colors.blue;
+};
+var formatDiagnostic = (diagnostic, root) => {
+  const color = severityColor(diagnostic.severity);
+  const lines = [
+    `${color(colors.bold(diagnostic.code))} ${diagnostic.message}`
+  ];
+  if (diagnostic.url) {
+    lines.push(`  ${colors.dim(`at ${diagnostic.url}`)}`);
+  }
+  if (diagnostic.file) {
+    const location = root ? relative(root, diagnostic.file) : diagnostic.file;
+    const column = diagnostic.column === undefined ? "" : `:${diagnostic.column}`;
+    const position = diagnostic.line === undefined ? "" : `:${diagnostic.line}${column}`;
+    const label = diagnostic.url ? "in" : "at";
+    lines.push(`  ${colors.dim(`${label} ${location}${position}`)}`);
+  }
+  if (diagnostic.suggestion) {
+    lines.push(`  ${colors.cyan(`fix: ${diagnostic.suggestion}`)}`);
+  }
+  if (diagnostic.docsUrl) {
+    lines.push(`  ${colors.dim(`docs: ${diagnostic.docsUrl}`)}`);
+  }
+  return lines.join(`
+`);
+};
+var hasErrors = (diagnostics) => diagnostics.some((d) => d.severity === "error");
+var countBySeverity = (diagnostics) => {
+  const counts = { error: 0, info: 0, warning: 0 };
+  for (const diagnostic of diagnostics) {
+    counts[diagnostic.severity] += 1;
+  }
+  return counts;
+};
+
+// src/cli/log.ts
+import { consola } from "consola";
+import { relative as relative2 } from "pathe";
+var logger = consola.withTag("blume");
+var flushStdout = () => new Promise((resolve) => {
+  process.stdout.write("", () => resolve());
+});
+var reportDiagnosticsJson = (diagnostics, root) => {
+  const enriched = diagnostics.map((diagnostic) => {
+    const withDocs = enrichDiagnostic(diagnostic);
+    return withDocs.file && root ? { ...withDocs, file: relative2(root, withDocs.file) } : withDocs;
+  });
+  process.stdout.write(`${JSON.stringify({ diagnostics: enriched, summary: countBySeverity(diagnostics) }, null, 2)}
+`);
+  return hasErrors(diagnostics);
+};
+var reportDiagnostics = (diagnostics, root) => {
+  if (diagnostics.length === 0) {
+    return false;
+  }
+  for (const diagnostic of diagnostics) {
+    process.stderr.write(`${formatDiagnostic(enrichDiagnostic(diagnostic), root)}
+`);
+  }
+  const counts = countBySeverity(diagnostics);
+  const summary = [
+    counts.error ? `${counts.error} error(s)` : null,
+    counts.warning ? `${counts.warning} warning(s)` : null
+  ].filter(Boolean).join(", ");
+  if (summary) {
+    process.stderr.write(`
+${summary}
+`);
+  }
+  return hasErrors(diagnostics);
+};
+
+export { BlumeError, enrichDiagnostic, locateFrontmatterKey, diagnosticsFromIssues, diagnosticsFromZod, hasErrors, countBySeverity, logger, flushStdout, reportDiagnosticsJson, reportDiagnostics };
+
+//# debugId=ACFDBD3E8C054D7D64756E2164756E21
+//# sourceMappingURL=chunk-ey89bjj1.js.map

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

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/core/diagnostics.ts", "../src/cli/log.ts"],
+  "sourcesContent": [
+    "import { colors } from \"consola/utils\";\nimport { relative } from \"pathe\";\nimport type { ZodError } from \"zod\";\n\nimport type { Diagnostic } from \"./types.ts\";\n\n/** A recoverable error carrying a structured diagnostic. */\nexport class BlumeError extends Error {\n  readonly diagnostic: Diagnostic;\n\n  constructor(diagnostic: Diagnostic) {\n    super(diagnostic.message);\n    this.name = \"BlumeError\";\n    this.diagnostic = diagnostic;\n  }\n}\n\nexport const createDiagnostic = (diagnostic: Diagnostic): Diagnostic =>\n  diagnostic;\n\n/** Docs site base; diagnostic help links resolve against it. */\nconst DOCS_BASE = \"https://useblume.dev\";\n\nconst DOCS_DEPLOYMENT = \"/docs/deployment\";\nconst DOCS_REFERENCE_CLI = \"/docs/reference/cli\";\nconst DOCS_CONTENT_SOURCES = \"/docs/content/sources\";\nconst DOCS_CONTENT_NAVIGATION = \"/docs/content/navigation\";\nconst DOCS_CONTENT_INCLUDES = \"/docs/content/includes\";\n\n/** Diagnostic code → the docs page that explains it. */\nconst DOCS_PATHS = new Map(\n  Object.entries({\n    BLUME_ADAPTER_REQUIRED: DOCS_DEPLOYMENT,\n    BLUME_ASSETS_UNCHECKED: DOCS_REFERENCE_CLI,\n    BLUME_ASSET_FETCH_FAILED: DOCS_CONTENT_SOURCES,\n    BLUME_BROKEN_ANCHOR: DOCS_REFERENCE_CLI,\n    BLUME_BROKEN_ASSET: DOCS_REFERENCE_CLI,\n    BLUME_BROKEN_LINK: DOCS_REFERENCE_CLI,\n    BLUME_CONFIG_INVALID: \"/docs/configuration\",\n    BLUME_CONFIG_LOAD_FAILED: \"/docs/configuration\",\n    BLUME_CONTENT_ROOT_MISSING: DOCS_CONTENT_SOURCES,\n    BLUME_DEAD_LINK: DOCS_REFERENCE_CLI,\n    BLUME_DUPLICATE_ROUTE: DOCS_CONTENT_NAVIGATION,\n    BLUME_DUPLICATE_SIDEBAR_ORDER: DOCS_CONTENT_NAVIGATION,\n    BLUME_FRONTMATTER_INVALID: \"/docs/reference/frontmatter\",\n    BLUME_INCLUDE_CYCLE: DOCS_CONTENT_INCLUDES,\n    BLUME_INCLUDE_NOT_FOUND: DOCS_CONTENT_INCLUDES,\n    BLUME_INCLUDE_OUTSIDE_ROOT: DOCS_CONTENT_INCLUDES,\n    BLUME_MDX_CURLY_ANCHOR: \"/docs/content/syntax\",\n\n    BLUME_META_INVALID: \"/docs/content/meta\",\n    BLUME_META_LOAD_FAILED: \"/docs/content/meta\",\n    BLUME_MISSING_SECRET: DOCS_DEPLOYMENT,\n    BLUME_NAV_DUPLICATE_LABEL: DOCS_CONTENT_NAVIGATION,\n    BLUME_NAV_HIDDEN_IN_SIDEBAR: DOCS_CONTENT_NAVIGATION,\n    BLUME_NAV_INDEX_TITLE_MISMATCH: DOCS_CONTENT_NAVIGATION,\n    BLUME_NAV_MISSING_PAGE: DOCS_CONTENT_NAVIGATION,\n    BLUME_NODE_VERSION: \"/docs/quickstart\",\n    BLUME_SERVER_FEATURE_REQUIRED: DOCS_DEPLOYMENT,\n    BLUME_SIDEBAR_DISPLAY_IGNORED: DOCS_CONTENT_NAVIGATION,\n    BLUME_SOURCE_FETCH_FAILED: DOCS_CONTENT_SOURCES,\n    BLUME_SOURCE_MISCONFIGURED: DOCS_CONTENT_SOURCES,\n    BLUME_SOURCE_OFFLINE: DOCS_CONTENT_SOURCES,\n    BLUME_SOURCE_SDK_MISSING: DOCS_CONTENT_SOURCES,\n    BLUME_SOURCE_UNAVAILABLE: DOCS_CONTENT_SOURCES,\n    BLUME_UNKNOWN_COMPONENT: \"/docs/configuration/customization\",\n    BLUME_UNKNOWN_ICON: DOCS_CONTENT_NAVIGATION,\n    BLUME_WIKILINK_AMBIGUOUS: DOCS_CONTENT_SOURCES,\n    BLUME_WIKILINK_UNRESOLVED: DOCS_CONTENT_SOURCES,\n  })\n);\n\n/** The docs URL that explains a diagnostic code, if one is mapped. */\nexport const resolveDocsUrl = (code: string): string | undefined => {\n  const path = DOCS_PATHS.get(code);\n  return path ? `${DOCS_BASE}${path}` : undefined;\n};\n\n/** Fill in `docsUrl` from the code map where a diagnostic doesn't set its own. */\nexport const enrichDiagnostic = (diagnostic: Diagnostic): Diagnostic =>\n  diagnostic.docsUrl\n    ? diagnostic\n    : { ...diagnostic, docsUrl: resolveDocsUrl(diagnostic.code) };\n\nconst REGEXP_SPECIAL = /[$()*+.?[\\\\\\]^{|}]/gu;\nconst escapeRegExp = (value: string): string =>\n  value.replaceAll(REGEXP_SPECIAL, String.raw`\\$&`);\n\n/** A key segment scans the source text; an array index has no key to find. */\nconst isKeySegment = (segment: string | number): segment is string =>\n  typeof segment === \"string\";\n\n/**\n * Best-effort source position for a Zod issue path (e.g. `[\"seo\", \"title\"]`) in\n * the raw config / frontmatter text. Narrows key-by-key — finding each string\n * segment as a `key:`/`key =` at or after the previous match — so a nested key\n * lands under its parent. Array indices are skipped. Returns 1-based line/column,\n * or undefined when nothing matches.\n */\nconst stepSegment = (\n  source: string,\n  segment: string | number,\n  cursor: number\n) => {\n  // A non-string path segment (array index) is skipped without moving on.\n  if (!isKeySegment(segment)) {\n    return { index: -1, next: cursor, stop: false };\n  }\n  // The negative lookbehind keeps a segment like `title` from matching the\n  // tail of an unrelated key such as `subtitle:`.\n  const matcher = new RegExp(\n    `(?<![\\\\w$])${escapeRegExp(segment)}\\\\s*[:=]`,\n    \"gu\"\n  );\n  matcher.lastIndex = cursor;\n  const match = matcher.exec(source);\n  if (!match) {\n    return { index: -1, next: cursor, stop: true };\n  }\n  return { index: match.index, next: matcher.lastIndex, stop: false };\n};\n\nconst locatePath = (\n  source: string,\n  path: readonly (string | number)[]\n): { column: number; line: number } | undefined => {\n  let cursor = 0;\n  let found = -1;\n  for (const segment of path) {\n    const step = stepSegment(source, segment, cursor);\n    if (step.stop) {\n      break;\n    }\n    cursor = step.next;\n    if (step.index >= 0) {\n      found = step.index;\n    }\n  }\n  if (found < 0) {\n    return;\n  }\n  const before = source.slice(0, found);\n  const lastNewline = before.lastIndexOf(\"\\n\");\n  return { column: found - lastNewline, line: before.split(\"\\n\").length };\n};\n\n/** The YAML front matter block of a `.md`/`.mdx` source, if it has one. */\nconst FRONTMATTER = /^---\\r?\\n(?<body>[\\s\\S]*?)\\r?\\n---/u;\n\n/**\n * Locate a front matter key in a content file, e.g. `[\"seo\", \"description\"]` in\n * `docs/api.mdx`. Scoped to the front matter block so a `title:` written in the\n * page body can't be mistaken for the front matter key of the same name; returns\n * undefined when the file has no front matter or the key isn't set (a missing\n * key has no line to point at — callers anchor to the file instead).\n */\nexport const locateFrontmatterKey = (\n  source: string,\n  path: readonly (string | number)[]\n): { column: number; line: number } | undefined => {\n  const block = FRONTMATTER.exec(source);\n  if (!block) {\n    return;\n  }\n  // `locatePath` reports lines 1-based within the text it was given, and the\n  // front matter body starts one line below the opening `---`.\n  const position = locatePath(block.groups?.body ?? \"\", path);\n  return position && { column: position.column, line: position.line + 1 };\n};\n\n/**\n * Convert generic validation issues (message + path, the shape shared by Zod\n * and Standard Schema issues) into Blume diagnostics, anchored to a file.\n */\nexport const diagnosticsFromIssues = (\n  issues: readonly {\n    message: string;\n    path: readonly (string | number)[];\n  }[],\n  options: { code: string; file?: string; source?: string }\n): Diagnostic[] =>\n  issues.map((issue) => {\n    const schemaPath = issue.path.join(\".\");\n    const position = options.source\n      ? locatePath(options.source, issue.path)\n      : undefined;\n    return {\n      code: options.code,\n      column: position?.column,\n      file: options.file,\n      line: position?.line,\n      message: schemaPath ? `${schemaPath}: ${issue.message}` : issue.message,\n      schemaPath: schemaPath || undefined,\n      severity: \"error\",\n    } satisfies Diagnostic;\n  });\n\n/** Convert a ZodError into Blume diagnostics, anchored to a file. */\nexport const diagnosticsFromZod = (\n  error: ZodError,\n  options: { code: string; file?: string; source?: string }\n): Diagnostic[] =>\n  diagnosticsFromIssues(\n    error.issues.map((issue) => ({\n      message: issue.message,\n      // Zod 4 paths are PropertyKey[]; a symbol segment has no place in a\n      // dotted schema path or a source-position scan.\n      path: issue.path.filter(\n        (segment): segment is string | number => typeof segment !== \"symbol\"\n      ),\n    })),\n    options\n  );\n\nconst severityColor = (severity: Diagnostic[\"severity\"]) => {\n  if (severity === \"error\") {\n    return colors.red;\n  }\n  if (severity === \"warning\") {\n    return colors.yellow;\n  }\n  return colors.blue;\n};\n\n/** Format a single diagnostic for terminal output. */\nexport const formatDiagnostic = (\n  diagnostic: Diagnostic,\n  root?: string\n): string => {\n  const color = severityColor(diagnostic.severity);\n  const lines: string[] = [\n    `${color(colors.bold(diagnostic.code))} ${diagnostic.message}`,\n  ];\n\n  // An audit finding is about a built URL, and names the source file that fixes\n  // it as a second line (\"at /docs/api\" / \"in docs/api.mdx:3:2\"). Everything\n  // else is about a file alone, and keeps the original single `at file` line.\n  if (diagnostic.url) {\n    lines.push(`  ${colors.dim(`at ${diagnostic.url}`)}`);\n  }\n  if (diagnostic.file) {\n    const location = root ? relative(root, diagnostic.file) : diagnostic.file;\n    const column =\n      diagnostic.column === undefined ? \"\" : `:${diagnostic.column}`;\n    const position =\n      diagnostic.line === undefined ? \"\" : `:${diagnostic.line}${column}`;\n    const label = diagnostic.url ? \"in\" : \"at\";\n    lines.push(`  ${colors.dim(`${label} ${location}${position}`)}`);\n  }\n\n  if (diagnostic.suggestion) {\n    lines.push(`  ${colors.cyan(`fix: ${diagnostic.suggestion}`)}`);\n  }\n\n  if (diagnostic.docsUrl) {\n    lines.push(`  ${colors.dim(`docs: ${diagnostic.docsUrl}`)}`);\n  }\n\n  return lines.join(\"\\n\");\n};\n\nexport const hasErrors = (diagnostics: Diagnostic[]): boolean =>\n  diagnostics.some((d) => d.severity === \"error\");\n\nexport const countBySeverity = (diagnostics: Diagnostic[]) => {\n  const counts = { error: 0, info: 0, warning: 0 } satisfies Record<\n    Diagnostic[\"severity\"],\n    number\n  >;\n  for (const diagnostic of diagnostics) {\n    counts[diagnostic.severity] += 1;\n  }\n  return counts;\n};\n",
+    "import { consola } from \"consola\";\nimport { relative } from \"pathe\";\n\nimport {\n  countBySeverity,\n  enrichDiagnostic,\n  formatDiagnostic,\n  hasErrors,\n} from \"../core/diagnostics.ts\";\nimport type { Diagnostic } from \"../core/types.ts\";\n\nexport const logger = consola.withTag(\"blume\");\n\n/**\n * Resolve once stdout has drained. `process.exit` doesn't flush a piped stdout,\n * so await this before exiting non-zero after writing machine-readable output\n * (e.g. `--json`), otherwise the payload can be truncated in CI.\n */\nexport const flushStdout = (): Promise<void> =>\n  // oxlint-disable-next-line promise/avoid-new -- adapt stdout's write callback\n  new Promise((resolve) => {\n    process.stdout.write(\"\", () => resolve());\n  });\n\n/**\n * Print diagnostics as a JSON document on stdout for CI and editors: each is\n * enriched with its `docsUrl` and its `file` made root-relative. Returns whether\n * any were errors, matching {@link reportDiagnostics}.\n */\nexport const reportDiagnosticsJson = (\n  diagnostics: Diagnostic[],\n  root?: string\n): boolean => {\n  const enriched = diagnostics.map((diagnostic) => {\n    const withDocs = enrichDiagnostic(diagnostic);\n    return withDocs.file && root\n      ? { ...withDocs, file: relative(root, withDocs.file) }\n      : withDocs;\n  });\n  process.stdout.write(\n    `${JSON.stringify(\n      { diagnostics: enriched, summary: countBySeverity(diagnostics) },\n      null,\n      2\n    )}\\n`\n  );\n  return hasErrors(diagnostics);\n};\n\n/** Print a batch of diagnostics and return whether any were errors. */\nexport const reportDiagnostics = (\n  diagnostics: Diagnostic[],\n  root?: string\n): boolean => {\n  if (diagnostics.length === 0) {\n    return false;\n  }\n\n  for (const diagnostic of diagnostics) {\n    process.stderr.write(\n      `${formatDiagnostic(enrichDiagnostic(diagnostic), root)}\\n`\n    );\n  }\n\n  const counts = countBySeverity(diagnostics);\n  const summary = [\n    counts.error ? `${counts.error} error(s)` : null,\n    counts.warning ? `${counts.warning} warning(s)` : null,\n  ]\n    .filter(Boolean)\n    .join(\", \");\n  if (summary) {\n    process.stderr.write(`\\n${summary}\\n`);\n  }\n\n  return hasErrors(diagnostics);\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "ACFDBD3E8C054D7D64756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-j6pxe0dt.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+import {
+  absoluteUrl
+} from "./chunk-vxv4x1n8.js";
+import {
+  resolveReferences
+} from "./chunk-xv91q4nm.js";
+import {
+  normalizeBasePath,
+  withBasePath
+} from "./chunk-27gtm2ym.js";
+
+// src/ai/api/paths.ts
+var OPENAPI_PATH = "/openapi.json";
+var API_BASE = "/api/docs";
+var API_PAGES_PATH = `${API_BASE}/pages.json`;
+var API_PAGE_PATH = `${API_BASE}/pages/{route}.json`;
+var API_NAVIGATION_PATH = `${API_BASE}/navigation.json`;
+var API_SEARCH_PATH = `${API_BASE}/search`;
+var pageParam = (route) => route === "/" ? "index" : route.slice(1);
+var pageJsonPath = (route) => `${API_BASE}/pages/${pageParam(route)}.json`;
+
+// src/ai/api-catalog.ts
+var API_CATALOG_PATH = "/.well-known/api-catalog";
+var API_CATALOG_TYPE = "application/linkset+json";
+var HTTP_URL = /^https?:\/\//u;
+var linksetEntries = (config) => {
+  const site = config.deployment.site ?? null;
+  const deployBase = normalizeBasePath(config.deployment.base);
+  const abs = (path) => {
+    const based = withBasePath(deployBase, path);
+    return site ? absoluteUrl(site, based) : based;
+  };
+  const entries = [];
+  for (const reference of resolveReferences(config)) {
+    const docRoute = reference.renderer === "blume" ? withBasePath(reference.basePath, reference.route) : reference.route;
+    const entry = {
+      anchor: abs(docRoute),
+      "service-doc": [{ href: abs(docRoute), type: "text/html" }]
+    };
+    if (HTTP_URL.test(reference.spec)) {
+      entry["service-desc"] = [{ href: reference.spec }];
+    }
+    entries.push(entry);
+  }
+  if (config.ai.api) {
+    entries.push({
+      anchor: abs(API_BASE),
+      "service-desc": [{ href: abs(OPENAPI_PATH), type: "application/json" }],
+      "service-doc": [{ href: abs("/"), type: "text/html" }]
+    });
+  }
+  if (config.ai.mcp.enabled) {
+    entries.push({
+      anchor: abs(config.ai.mcp.route),
+      "service-desc": [
+        { href: abs("/.well-known/mcp.json"), type: "application/json" }
+      ],
+      "service-doc": [{ href: abs("/"), type: "text/html" }]
+    });
+  }
+  return entries;
+};
+var hasApiCatalog = (config) => linksetEntries(config).length > 0;
+
+export { OPENAPI_PATH, API_PAGES_PATH, API_PAGE_PATH, API_NAVIGATION_PATH, API_SEARCH_PATH, pageJsonPath, API_CATALOG_PATH, API_CATALOG_TYPE, hasApiCatalog };
+
+//# debugId=41C2FD41D67952F664756E2164756E21
+//# sourceMappingURL=chunk-j6pxe0dt.js.map

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

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/ai/api/paths.ts", "../src/ai/api-catalog.ts"],
+  "sourcesContent": [
+    "/**\n * Where the JSON docs API and its OpenAPI description are served. Base-less\n * (like every route Blume emits); callers layer `deployment.base` on top.\n * Under `/api/` alongside the Ask AI endpoint (`/api/ask`) so the namespace a\n * Blume site reserves for live endpoints stays one prefix, and under its own\n * `docs` segment so a search provider's proxy at `/api/search` never collides.\n */\n\nexport const OPENAPI_PATH = \"/openapi.json\";\nexport const API_BASE = \"/api/docs\";\nexport const API_PAGES_PATH = `${API_BASE}/pages.json`;\nexport const API_PAGE_PATH = `${API_BASE}/pages/{route}.json`;\nexport const API_NAVIGATION_PATH = `${API_BASE}/navigation.json`;\nexport const API_SEARCH_PATH = `${API_BASE}/search`;\n\n/** The `pages/{route}.json` path segment for a route (`index` for home). */\nexport const pageParam = (route: string): string =>\n  route === \"/\" ? \"index\" : route.slice(1);\n\n/** The base-less served path of a route's per-page JSON document. */\nexport const pageJsonPath = (route: string): string =>\n  `${API_BASE}/pages/${pageParam(route)}.json`;\n",
+    "import { normalizeBasePath, withBasePath } from \"../core/base-path.ts\";\nimport type { ResolvedConfig } from \"../core/schema.ts\";\nimport { absoluteUrl } from \"../core/site-url.ts\";\nimport { resolveReferences } from \"../openapi/references.ts\";\nimport { API_BASE, OPENAPI_PATH } from \"./api/paths.ts\";\n\n/**\n * RFC 9727 API catalog: a linkset (RFC 9264) at `/.well-known/api-catalog`\n * enumerating the APIs a publisher offers, so agents can discover them from\n * the domain alone. Blume already knows the site's APIs — the configured\n * OpenAPI/AsyncAPI references and the hosted MCP server — so the catalog is\n * generated, never hand-written: one entry per API, anchored at its docs\n * route (the RFC's own examples anchor on developer-portal pages), with\n * `service-doc` pointing at the rendered reference and `service-desc` at the\n * spec when it lives at a fetchable URL. The site's own JSON docs API is an\n * entry too, described by its generated `/openapi.json`.\n */\n\nexport const API_CATALOG_PATH = \"/.well-known/api-catalog\";\nexport const API_CATALOG_TYPE = \"application/linkset+json\";\n\n/** An RFC 9264 linkset entry, restricted to the relations Blume emits. */\ninterface LinksetEntry {\n  anchor: string;\n  \"service-desc\"?: { href: string; type?: string }[];\n  \"service-doc\"?: { href: string; type: string }[];\n}\n\nconst HTTP_URL = /^https?:\\/\\//u;\n\n/** The catalog's linkset entries; empty when the site publishes no APIs. */\nconst linksetEntries = (config: ResolvedConfig): LinksetEntry[] => {\n  const site = config.deployment.site ?? null;\n  const deployBase = normalizeBasePath(config.deployment.base);\n  const abs = (path: string): string => {\n    const based = withBasePath(deployBase, path);\n    return site ? absoluteUrl(site, based) : based;\n  };\n\n  const entries: LinksetEntry[] = [];\n  for (const reference of resolveReferences(config)) {\n    // Blume-rendered pages mount under `basePath`; Scalar pages stay at the\n    // raw route (see `referenceRoutes`).\n    const docRoute =\n      reference.renderer === \"blume\"\n        ? withBasePath(reference.basePath, reference.route)\n        : reference.route;\n    const entry: LinksetEntry = {\n      anchor: abs(docRoute),\n      \"service-doc\": [{ href: abs(docRoute), type: \"text/html\" }],\n    };\n    // A local spec file is parsed into pages, not served, so only a remote\n    // spec has a fetchable `service-desc` URL.\n    if (HTTP_URL.test(reference.spec)) {\n      entry[\"service-desc\"] = [{ href: reference.spec }];\n    }\n    entries.push(entry);\n  }\n\n  if (config.ai.api) {\n    entries.push({\n      anchor: abs(API_BASE),\n      \"service-desc\": [{ href: abs(OPENAPI_PATH), type: \"application/json\" }],\n      \"service-doc\": [{ href: abs(\"/\"), type: \"text/html\" }],\n    });\n  }\n\n  if (config.ai.mcp.enabled) {\n    entries.push({\n      anchor: abs(config.ai.mcp.route),\n      \"service-desc\": [\n        { href: abs(\"/.well-known/mcp.json\"), type: \"application/json\" },\n      ],\n      \"service-doc\": [{ href: abs(\"/\"), type: \"text/html\" }],\n    });\n  }\n  return entries;\n};\n\n/** Whether the site has anything to catalog — gates every emission surface. */\nexport const hasApiCatalog = (config: ResolvedConfig): boolean =>\n  linksetEntries(config).length > 0;\n\n/** The `application/linkset+json` document, or null when there are no APIs. */\nexport const buildApiCatalog = (config: ResolvedConfig): string | null => {\n  const linkset = linksetEntries(config);\n  if (linkset.length === 0) {\n    return null;\n  }\n  return `${JSON.stringify({ linkset }, null, 2)}\\n`;\n};\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;AAQO,IAAM,eAAe;AACrB,IAAM,WAAW;AACjB,IAAM,iBAAiB,GAAG;AAC1B,IAAM,gBAAgB,GAAG;AACzB,IAAM,sBAAsB,GAAG;AAC/B,IAAM,kBAAkB,GAAG;AAG3B,IAAM,YAAY,CAAC,UACxB,UAAU,MAAM,UAAU,MAAM,MAAM,CAAC;AAGlC,IAAM,eAAe,CAAC,UAC3B,GAAG,kBAAkB,UAAU,KAAK;;;ACH/B,IAAM,mBAAmB;AACzB,IAAM,mBAAmB;AAShC,IAAM,WAAW;AAGjB,IAAM,iBAAiB,CAAC,WAA2C;AAAA,EACjE,MAAM,OAAO,OAAO,WAAW,QAAQ;AAAA,EACvC,MAAM,aAAa,kBAAkB,OAAO,WAAW,IAAI;AAAA,EAC3D,MAAM,MAAM,CAAC,SAAyB;AAAA,IACpC,MAAM,QAAQ,aAAa,YAAY,IAAI;AAAA,IAC3C,OAAO,OAAO,YAAY,MAAM,KAAK,IAAI;AAAA;AAAA,EAG3C,MAAM,UAA0B,CAAC;AAAA,EACjC,WAAW,aAAa,kBAAkB,MAAM,GAAG;AAAA,IAGjD,MAAM,WACJ,UAAU,aAAa,UACnB,aAAa,UAAU,UAAU,UAAU,KAAK,IAChD,UAAU;AAAA,IAChB,MAAM,QAAsB;AAAA,MAC1B,QAAQ,IAAI,QAAQ;AAAA,MACpB,eAAe,CAAC,EAAE,MAAM,IAAI,QAAQ,GAAG,MAAM,YAAY,CAAC;AAAA,IAC5D;AAAA,IAGA,IAAI,SAAS,KAAK,UAAU,IAAI,GAAG;AAAA,MACjC,MAAM,kBAAkB,CAAC,EAAE,MAAM,UAAU,KAAK,CAAC;AAAA,IACnD;AAAA,IACA,QAAQ,KAAK,KAAK;AAAA,EACpB;AAAA,EAEA,IAAI,OAAO,GAAG,KAAK;AAAA,IACjB,QAAQ,KAAK;AAAA,MACX,QAAQ,IAAI,QAAQ;AAAA,MACpB,gBAAgB,CAAC,EAAE,MAAM,IAAI,YAAY,GAAG,MAAM,mBAAmB,CAAC;AAAA,MACtE,eAAe,CAAC,EAAE,MAAM,IAAI,GAAG,GAAG,MAAM,YAAY,CAAC;AAAA,IACvD,CAAC;AAAA,EACH;AAAA,EAEA,IAAI,OAAO,GAAG,IAAI,SAAS;AAAA,IACzB,QAAQ,KAAK;AAAA,MACX,QAAQ,IAAI,OAAO,GAAG,IAAI,KAAK;AAAA,MAC/B,gBAAgB;AAAA,QACd,EAAE,MAAM,IAAI,uBAAuB,GAAG,MAAM,mBAAmB;AAAA,MACjE;AAAA,MACA,eAAe,CAAC,EAAE,MAAM,IAAI,GAAG,GAAG,MAAM,YAAY,CAAC;AAAA,IACvD,CAAC;AAAA,EACH;AAAA,EACA,OAAO;AAAA;AAIF,IAAM,gBAAgB,CAAC,WAC5B,eAAe,MAAM,EAAE,SAAS;",
+  "debugId": "41C2FD41D67952F664756E2164756E21",
+  "names": []
+}