blume 2.1.2 → 2.2.0

package/dist/cli/chunk-96snx8yy.js

@@ -0,0 +1,329 @@
+#!/usr/bin/env node
+import {
+  normalizeBasePath,
+  normalizePath,
+  mountBasePath,
+  siteRoot,
+  absoluteUrl2
+} from "./chunk-zccbjcj0.js";
+import {
+  OPENAPI_PATH,
+  API_PAGES_PATH,
+  API_NAVIGATION_PATH,
+  API_SEARCH_PATH,
+  API_CATALOG_PATH,
+  hasApiCatalog,
+  buildApiCatalog,
+  AGENT_SKILLS_INDEX_PATH,
+  servesSkillsIndex,
+  AI_CATALOG_PATH,
+  ARD_MANIFEST_PATH,
+  hasAiCatalog,
+  buildAiCatalog,
+  discoverPagesSync,
+  customStaticRoutes,
+  hasGeneratedChangelog,
+  repoUrl,
+  isHiddenPage,
+  buildRssFeeds,
+  staticFileResolver,
+  SIGNATURES_DIRECTORY_PATH,
+  buildSignaturesDirectory,
+  deployPlatform
+} from "./chunk-dm4mg9bj.js";
+import {
+  SKILL_MD_PATH
+} from "./chunk-79bzzkx4.js";
+
+// src/deploy/generated-files.ts
+import { join } from "pathe";
+
+// src/ai/agent-readability.ts
+var USAGE_TOKENS = [
+  ["search", "search"],
+  ["aiInput", "ai-input"],
+  ["aiTrain", "ai-train"]
+];
+var usagePolicy = (signals) => {
+  if (!signals) {
+    return null;
+  }
+  return Object.fromEntries(USAGE_TOKENS.map(([key, token]) => [token, signals[key]]));
+};
+var askApiUrl = (endpoint, site, abs) => {
+  if (!endpoint) {
+    return abs("/api/ask");
+  }
+  return site && endpoint.startsWith("/") ? absoluteUrl2(site, endpoint) : endpoint;
+};
+var markdownArtifact = (config, abs) => {
+  const negotiates = config.deployment.options.output === "server" && deployPlatform(config.deployment).negotiatesMarkdown;
+  return negotiates ? { contentNegotiation: "text/markdown", pattern: abs("/{route}.md") } : { pattern: abs("/{route}.md") };
+};
+var apiArtifact = (config, abs) => {
+  if (!config.agents.api) {
+    return null;
+  }
+  const api = {
+    openapi: abs(OPENAPI_PATH),
+    pages: abs(API_PAGES_PATH)
+  };
+  if (config.deployment.options.output === "server") {
+    api.search = abs(API_SEARCH_PATH);
+  }
+  return api;
+};
+var wellKnownArtifacts = (config, abs) => {
+  const artifacts = {};
+  if (config.agents.webBotAuth.keys.length > 0) {
+    artifacts.httpMessageSignaturesDirectory = abs("/.well-known/http-message-signatures-directory");
+  }
+  if (hasAiCatalog(config)) {
+    artifacts.aiCatalog = abs(AI_CATALOG_PATH);
+  }
+  if (hasApiCatalog(config)) {
+    artifacts.apiCatalog = abs("/.well-known/api-catalog");
+  }
+  if (servesSkillsIndex(config)) {
+    artifacts.agentSkills = abs("/.well-known/agent-skills/index.json");
+  }
+  return artifacts;
+};
+var buildAgentReadability = (project) => {
+  const { config } = project;
+  if (!config.agents.agentReadability) {
+    return null;
+  }
+  const site = config.deployment.options.site ?? null;
+  const deployBase = normalizeBasePath(config.deployment.options.base);
+  const abs = (path) => {
+    const based = mountBasePath(deployBase, path);
+    return site ? absoluteUrl2(site, based) : based;
+  };
+  const artifacts = {
+    markdown: markdownArtifact(config, abs)
+  };
+  const api = apiArtifact(config, abs);
+  if (api) {
+    artifacts.api = api;
+  }
+  if (config.agents.llmsTxt.enabled) {
+    artifacts.llmsFullTxt = abs("/llms-full.txt");
+    artifacts.llmsTxt = abs("/llms.txt");
+  }
+  if (config.agents.mcp.enabled) {
+    artifacts.mcp = {
+      discovery: abs("/.well-known/mcp.json"),
+      url: abs(config.agents.mcp.route)
+    };
+  }
+  if (config.ai.assistant?.enabled) {
+    artifacts.askApi = askApiUrl(config.ai.assistant.endpoint, site, abs);
+  }
+  Object.assign(artifacts, wellKnownArtifacts(config, abs));
+  if (site && config.seo.sitemap) {
+    artifacts.sitemap = abs("/sitemap.xml");
+  }
+  const feeds = site && config.seo.rss.enabled ? buildRssFeeds(project).map((feed) => abs(feed.path)) : [];
+  if (feeds.length > 0) {
+    artifacts.feeds = feeds;
+  }
+  const version = project.manifest?.blumeVersion;
+  const manifest = {
+    artifacts,
+    description: config.description,
+    generator: version ? `blume@${version}` : undefined,
+    name: config.agents.mcp.name ?? config.title,
+    site
+  };
+  const usage = usagePolicy(config.agents.contentSignals);
+  if (usage) {
+    manifest.contentUsage = usage;
+  }
+  if (config.github) {
+    manifest.repository = repoUrl(config.github);
+  }
+  return manifest;
+};
+
+// src/deploy/robots.ts
+var SIGNAL_TOKENS = [
+  ["search", "search"],
+  ["aiInput", "ai-input"],
+  ["aiTrain", "ai-train"]
+];
+var contentSignalLine = (signals) => {
+  if (!signals) {
+    return null;
+  }
+  const tokens = SIGNAL_TOKENS.map(([key, token]) => `${token}=${signals[key] ? "yes" : "no"}`);
+  return `Content-Signal: ${tokens.join(", ")}`;
+};
+var buildRobots = (project) => {
+  const { config } = project;
+  if (!config.seo.robots) {
+    return null;
+  }
+  const lines = ["User-agent: *"];
+  const signal = contentSignalLine(config.agents.contentSignals);
+  if (signal) {
+    lines.push(signal);
+  }
+  lines.push("Allow: /");
+  const { site } = config.deployment.options;
+  if (site && config.seo.sitemap) {
+    const sitemapPath = mountBasePath(normalizeBasePath(config.deployment.options.base), "/sitemap.xml");
+    lines.push("", `Sitemap: ${absoluteUrl2(site, sitemapPath)}`);
+  }
+  return `${lines.join(`
+`)}
+`;
+};
+
+// src/deploy/sitemap.ts
+import { escape as escapeXml } from "html-escaper";
+var ERROR_ROUTES = new Set(["/404", "/500"]);
+var lastmodTag = (value) => {
+  if (!value) {
+    return "";
+  }
+  const date = new Date(value);
+  return Number.isNaN(date.getTime()) ? "" : `<lastmod>${date.toISOString().slice(0, 10)}</lastmod>`;
+};
+var canonicalElsewhere = (canonical, served) => {
+  if (!canonical) {
+    return false;
+  }
+  const { pathname } = new URL(canonical);
+  let path = pathname;
+  try {
+    path = decodeURI(pathname);
+  } catch {}
+  return normalizePath(path) !== normalizePath(served);
+};
+var URLS_PER_FILE = 50000;
+var renderUrlset = (urls) => `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urls.join(`
+`)}
+</urlset>
+`;
+var buildSitemapFiles = (project) => {
+  const { site } = project.config.deployment.options;
+  if (!(site && project.config.seo.sitemap)) {
+    return null;
+  }
+  const base = siteRoot(site);
+  const deployBase = normalizeBasePath(project.config.deployment.options.base);
+  const { versions } = project.config;
+  const archivedById = new Map((versions?.archived ?? []).map((version) => [version.id, version]));
+  const currentKeys = versions ? new Set(project.graph.pages.flatMap((page) => page.version === "" ? [`${page.versionKey}\x00${page.locale}`] : [])) : null;
+  const archivedExcluded = (page) => {
+    if (!page.version) {
+      return false;
+    }
+    const archived = archivedById.get(page.version);
+    return Boolean(archived?.noindex || archived?.canonical === "latest" && !page.meta.seo.canonical && currentKeys?.has(`${page.versionKey}\x00${page.locale}`));
+  };
+  const seen = new Set;
+  const urls = [];
+  const pushUrl = (route, lastModified) => {
+    const loc = escapeXml(encodeURI(`${base}${route}`));
+    if (seen.has(loc)) {
+      return;
+    }
+    seen.add(loc);
+    urls.push(`  <url><loc>${loc}</loc>${lastmodTag(lastModified)}</url>`);
+  };
+  for (const page of project.graph.pages) {
+    const served = mountBasePath(deployBase, page.route);
+    if (page.meta.draft || isHiddenPage(page, project.graph) || page.meta.seo.noindex || ERROR_ROUTES.has(page.route) || archivedExcluded(page) || canonicalElsewhere(page.meta.seo.canonical, served)) {
+      continue;
+    }
+    pushUrl(served, page.lastModified);
+  }
+  const userPages = project.context.pagesRoot ? discoverPagesSync(project.context.pagesRoot) : [];
+  const extraRoutes = customStaticRoutes(userPages).filter((route) => !ERROR_ROUTES.has(route));
+  if (hasGeneratedChangelog(project, userPages)) {
+    extraRoutes.push("/changelog");
+  }
+  for (const route of extraRoutes) {
+    pushUrl(mountBasePath(deployBase, route));
+  }
+  urls.sort();
+  if (urls.length <= URLS_PER_FILE) {
+    return [{ name: "sitemap.xml", xml: renderUrlset(urls) }];
+  }
+  const chunks = [];
+  const references = [];
+  for (let start = 0;start < urls.length; start += URLS_PER_FILE) {
+    const name = `sitemap-${chunks.length + 1}.xml`;
+    chunks.push({
+      name,
+      xml: renderUrlset(urls.slice(start, start + URLS_PER_FILE))
+    });
+    const loc = escapeXml(encodeURI(`${base}${mountBasePath(deployBase, `/${name}`)}`));
+    references.push(`  <sitemap><loc>${loc}</loc></sitemap>`);
+  }
+  const index = `<?xml version="1.0" encoding="UTF-8"?>
+<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${references.join(`
+`)}
+</sitemapindex>
+`;
+  return [{ name: "sitemap.xml", xml: index }, ...chunks];
+};
+
+// src/deploy/generated-files.ts
+var wellKnownFiles = (config, skills) => {
+  const aiCatalog = buildAiCatalog(config, skills);
+  return [
+    {
+      content: buildSignaturesDirectory(config),
+      label: "Web Bot Auth",
+      path: SIGNATURES_DIRECTORY_PATH
+    },
+    {
+      content: buildApiCatalog(config),
+      label: "RFC 9727",
+      path: API_CATALOG_PATH
+    },
+    { content: aiCatalog, label: "AI Catalog", path: AI_CATALOG_PATH },
+    { content: aiCatalog, label: "ARD manifest", path: ARD_MANIFEST_PATH }
+  ];
+};
+var generatedFilePaths = (project) => {
+  const { config } = project;
+  const paths = [];
+  if (config.agents.llmsTxt.enabled) {
+    paths.push("/llms.txt", "/llms-full.txt");
+  }
+  paths.push(...(buildSitemapFiles(project) ?? []).map((file) => `/${file.name}`));
+  if (buildRobots(project)) {
+    paths.push("/robots.txt");
+  }
+  if (buildAgentReadability(project)) {
+    paths.push("/agent-readability.json");
+  }
+  paths.push(...wellKnownFiles(config, []).flatMap((file) => file.content ? [file.path] : []));
+  if (servesSkillsIndex(config)) {
+    paths.push(AGENT_SKILLS_INDEX_PATH);
+    if (config.agents.skillMd) {
+      paths.push(SKILL_MD_PATH);
+    }
+  }
+  paths.push(...buildRssFeeds(project).map((feed) => feed.path));
+  if (config.agents.api) {
+    paths.push(OPENAPI_PATH, API_PAGES_PATH, API_NAVIGATION_PATH);
+  }
+  if (config.agents.mcp.enabled) {
+    paths.push("/.well-known/mcp.json", "/.well-known/mcp/server-card.json");
+  }
+  return paths;
+};
+var servedFiles = (project) => staticFileResolver(join(project.context.root, "public"), generatedFilePaths(project));
+
+export { generatedFilePaths, servedFiles };
+
+//# debugId=AFE0F5252B96AD6064756E2164756E21
+//# sourceMappingURL=chunk-96snx8yy.js.map

package/dist/cli/chunk-96snx8yy.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../src/deploy/generated-files.ts", "../src/ai/agent-readability.ts", "../src/deploy/robots.ts", "../src/deploy/sitemap.ts"],
+  "sourcesContent": [
+    "import { join } from \"pathe\";\n\nimport { buildAgentReadability } from \"../ai/agent-readability.ts\";\nimport {\n  AI_CATALOG_PATH,\n  ARD_MANIFEST_PATH,\n  buildAiCatalog,\n} from \"../ai/ai-catalog.ts\";\nimport { API_CATALOG_PATH, buildApiCatalog } from \"../ai/api-catalog.ts\";\nimport {\n  API_NAVIGATION_PATH,\n  API_PAGES_PATH,\n  OPENAPI_PATH,\n} from \"../ai/api/paths.ts\";\nimport { SKILL_MD_PATH } from \"../ai/site-skill.ts\";\nimport { AGENT_SKILLS_INDEX_PATH, servesSkillsIndex } from \"../ai/skills.ts\";\nimport type { SkillArtifact } from \"../ai/skills.ts\";\nimport {\n  buildSignaturesDirectory,\n  SIGNATURES_DIRECTORY_PATH,\n} from \"../ai/web-bot-auth.ts\";\nimport type { BlumeProject } from \"../core/project-graph.ts\";\nimport type { ResolvedConfig } from \"../core/schema.ts\";\nimport { staticFileResolver } from \"../core/static-files.ts\";\nimport { buildRobots } from \"./robots.ts\";\nimport { buildRssFeeds } from \"./rss.ts\";\nimport { buildSitemapFiles } from \"./sitemap.ts\";\n\n/** A generated `.well-known` discovery document: `null` content when it's off. */\nexport interface WellKnownFile {\n  content: string | null;\n  label: string;\n  path: string;\n}\n\n/**\n * The generated `.well-known` discovery documents — the Web Bot Auth signature\n * directory, the RFC 9727 API catalog, and the AI catalog under both the\n * ai-catalog spec's well-known URI and the ARD v0.91 one (see\n * `ai/ai-catalog.ts`) — each with `null` content when its feature is off.\n */\nexport const wellKnownFiles = (\n  config: ResolvedConfig,\n  skills: readonly SkillArtifact[]\n): WellKnownFile[] => {\n  const aiCatalog = buildAiCatalog(config, skills);\n  return [\n    {\n      content: buildSignaturesDirectory(config),\n      label: \"Web Bot Auth\",\n      path: SIGNATURES_DIRECTORY_PATH,\n    },\n    {\n      content: buildApiCatalog(config),\n      label: \"RFC 9727\",\n      path: API_CATALOG_PATH,\n    },\n    { content: aiCatalog, label: \"AI Catalog\", path: AI_CATALOG_PATH },\n    { content: aiCatalog, label: \"ARD manifest\", path: ARD_MANIFEST_PATH },\n  ];\n};\n\n/**\n * The files a build serves beside its pages that don't come from `public/`,\n * as base-less root-relative paths: what `publishBuildArtifacts` writes once\n * Astro is done (llms.txt, the sitemap, robots.txt, `agent-readability.json`,\n * the `.well-known` discovery documents, the Agent Skills index, `skill.md`)\n * and the generated endpoints at fixed paths (the RSS feeds, the JSON docs\n * API and its OpenAPI description, the MCP discovery documents). Each is\n * listed under the gate its writer reads, so a feature the config switches\n * off drops its file here too: `blume validate` accepts a link to\n * `/llms.txt` exactly when the build writes one.\n *\n * Read from the config alone, before a build: the skill archives a build\n * publishes beside the index, and the platform files (`_redirects`,\n * `_headers`, `vercel.json`), aren't listed. A page's Markdown copy\n * (`/guide.md`) is its route's, and resolves through the page.\n */\nexport const generatedFilePaths = (project: BlumeProject): string[] => {\n  const { config } = project;\n  const paths: string[] = [];\n  if (config.agents.llmsTxt.enabled) {\n    paths.push(\"/llms.txt\", \"/llms-full.txt\");\n  }\n  paths.push(\n    ...(buildSitemapFiles(project) ?? []).map((file) => `/${file.name}`)\n  );\n  if (buildRobots(project)) {\n    paths.push(\"/robots.txt\");\n  }\n  if (buildAgentReadability(project)) {\n    paths.push(\"/agent-readability.json\");\n  }\n  paths.push(\n    ...wellKnownFiles(config, []).flatMap((file) =>\n      file.content ? [file.path] : []\n    )\n  );\n  if (servesSkillsIndex(config)) {\n    paths.push(AGENT_SKILLS_INDEX_PATH);\n    if (config.agents.skillMd) {\n      paths.push(SKILL_MD_PATH);\n    }\n  }\n  paths.push(...buildRssFeeds(project).map((feed) => feed.path));\n  if (config.agents.api) {\n    paths.push(OPENAPI_PATH, API_PAGES_PATH, API_NAVIGATION_PATH);\n  }\n  if (config.agents.mcp.enabled) {\n    paths.push(\"/.well-known/mcp.json\", \"/.well-known/mcp/server-card.json\");\n  }\n  return paths;\n};\n\n/**\n * Whether a base-less path is a file the project's site serves beside its\n * pages: one in `public/` (`/spec.pdf`, a folder's `index.html`) or one the\n * build generates (`/llms.txt`). What `generateRuntime` and `blume doctor`\n * check navigation entries against, beside the routes, as `blume validate`\n * checks links.\n */\nexport const servedFiles = (\n  project: BlumeProject\n): ((path: string) => boolean) =>\n  staticFileResolver(\n    join(project.context.root, \"public\"),\n    generatedFilePaths(project)\n  );\n",
+    "import { mountBasePath, normalizeBasePath } from \"../core/base-path.ts\";\nimport { repoUrl } from \"../core/github.ts\";\nimport type { BlumeProject } from \"../core/project-graph.ts\";\nimport type { ContentSignalPolicy, ContentSignals } from \"../core/schema.ts\";\nimport { absoluteUrl } from \"../core/site-url.ts\";\nimport { deployPlatform } from \"../deploy/platforms/index.ts\";\nimport { buildRssFeeds } from \"../deploy/rss.ts\";\nimport { AI_CATALOG_PATH, hasAiCatalog } from \"./ai-catalog.ts\";\nimport { hasApiCatalog } from \"./api-catalog.ts\";\nimport { API_PAGES_PATH, API_SEARCH_PATH, OPENAPI_PATH } from \"./api/paths.ts\";\nimport { servesSkillsIndex } from \"./skills.ts\";\n\n/** Token map for the machine-readable content-usage echo. */\nconst USAGE_TOKENS: [keyof ContentSignalPolicy, string][] = [\n  [\"search\", \"search\"],\n  [\"aiInput\", \"ai-input\"],\n  [\"aiTrain\", \"ai-train\"],\n];\n\n/**\n * The configured usage preferences as a `{ token: allowed }` object, or null\n * when the declaration is disabled (`contentSignals: false`). Mirrors the\n * robots.txt `Content-Signal` line so an agent that reads the manifest instead\n * of robots.txt sees the same policy.\n */\nconst usagePolicy = (\n  signals: ContentSignals\n): Record<string, boolean> | null => {\n  if (!signals) {\n    return null;\n  }\n  return Object.fromEntries(\n    USAGE_TOKENS.map(([key, token]) => [token, signals[key]] as const)\n  );\n};\n\n/**\n * The advertised assistant URL. An external endpoint is not served under\n * `deployment.base`, so a root-relative one absolutizes against the site\n * origin alone; the built-in route gets site and base via `abs`.\n */\nconst askApiUrl = (\n  endpoint: string | undefined,\n  site: string | null,\n  abs: (path: string) => string\n): string => {\n  if (!endpoint) {\n    return abs(\"/api/ask\");\n  }\n  return site && endpoint.startsWith(\"/\")\n    ? absoluteUrl(site, endpoint)\n    : endpoint;\n};\n\n/** The `.well-known` discovery URLs a site can publish. */\ninterface WellKnownArtifacts {\n  httpMessageSignaturesDirectory?: string;\n  aiCatalog?: string;\n  apiCatalog?: string;\n  agentSkills?: string;\n}\n\n/** The JSON docs API's entry points; `search` exists on server output only. */\ninterface ApiArtifact {\n  openapi: string;\n  pages: string;\n  search?: string;\n}\n\n/** The agent-facing artifact index the manifest publishes. */\ninterface AgentArtifacts extends WellKnownArtifacts {\n  markdown: { contentNegotiation?: string; pattern: string };\n  api?: ApiArtifact;\n  llmsFullTxt?: string;\n  llmsTxt?: string;\n  mcp?: { discovery: string; url: string };\n  askApi?: string;\n  sitemap?: string;\n  feeds?: string[];\n}\n\n/** The published `agent-readability.json` document. */\nexport interface AgentReadabilityManifest {\n  artifacts: AgentArtifacts;\n  description?: string;\n  generator?: string;\n  name: string;\n  site: string | null;\n  contentUsage?: Record<string, boolean>;\n  repository?: string;\n}\n\n/**\n * The raw-Markdown mirror pattern. `Accept: text/markdown` negotiation is\n * advertised only where the deployed site actually honors it — a server build\n * on a platform that declares `negotiatesMarkdown` (Vercel, whose routing\n * config gets the rewrite rules; Cloudflare, whose deploy bundle gets a\n * wrapper Worker — see `deploy/platforms/*`). Static builds and other\n * adapters serve prerendered pages from a static layer with no request-time\n * hook, so agents there should fetch the `.md` pattern directly.\n */\nconst markdownArtifact = (\n  config: BlumeProject[\"config\"],\n  abs: (path: string) => string\n): AgentArtifacts[\"markdown\"] => {\n  const negotiates =\n    config.deployment.options.output === \"server\" &&\n    deployPlatform(config.deployment).negotiatesMarkdown;\n  return negotiates\n    ? { contentNegotiation: \"text/markdown\", pattern: abs(\"/{route}.md\") }\n    : { pattern: abs(\"/{route}.md\") };\n};\n\n/** The JSON docs API's entry points, or null when the API is off. */\nconst apiArtifact = (\n  config: BlumeProject[\"config\"],\n  abs: (path: string) => string\n): ApiArtifact | null => {\n  if (!config.agents.api) {\n    return null;\n  }\n  const api: ApiArtifact = {\n    openapi: abs(OPENAPI_PATH),\n    pages: abs(API_PAGES_PATH),\n  };\n  if (config.deployment.options.output === \"server\") {\n    api.search = abs(API_SEARCH_PATH);\n  }\n  return api;\n};\n\n/** The `.well-known` discovery artifacts the site publishes, if any. */\nconst wellKnownArtifacts = (\n  config: BlumeProject[\"config\"],\n  abs: (path: string) => string\n): WellKnownArtifacts => {\n  const artifacts: WellKnownArtifacts = {};\n  if (config.agents.webBotAuth.keys.length > 0) {\n    artifacts.httpMessageSignaturesDirectory = abs(\n      \"/.well-known/http-message-signatures-directory\"\n    );\n  }\n  if (hasAiCatalog(config)) {\n    artifacts.aiCatalog = abs(AI_CATALOG_PATH);\n  }\n  if (hasApiCatalog(config)) {\n    artifacts.apiCatalog = abs(\"/.well-known/api-catalog\");\n  }\n  if (servesSkillsIndex(config)) {\n    artifacts.agentSkills = abs(\"/.well-known/agent-skills/index.json\");\n  }\n  return artifacts;\n};\n\n/**\n * Build `agent-readability.json`: a root manifest that indexes the project's\n * agent-facing surface — llms.txt, the raw-Markdown mirrors, the JSON docs\n * API and its OpenAPI description, the MCP server, the assistant, sitemap, and feeds\n * — so agents can discover and cite the docs without\n * scraping HTML. URLs are absolute when a `site` is configured and root-relative\n * (still under `deployment.base`) otherwise. Returns null when the manifest is\n * disabled.\n */\nexport const buildAgentReadability = (\n  project: BlumeProject\n): AgentReadabilityManifest | null => {\n  const { config } = project;\n  if (!config.agents.agentReadability) {\n    return null;\n  }\n\n  const site = config.deployment.options.site ?? null;\n  // Every artifact is served under `deployment.base` — with or without a\n  // `site`; concatenate rather than `new URL()` so the subpath is preserved.\n  const deployBase = normalizeBasePath(config.deployment.options.base);\n  const abs = (path: string): string => {\n    const based = mountBasePath(deployBase, path);\n    return site ? absoluteUrl(site, based) : based;\n  };\n\n  const artifacts: AgentArtifacts = {\n    markdown: markdownArtifact(config, abs),\n  };\n  const api = apiArtifact(config, abs);\n  if (api) {\n    artifacts.api = api;\n  }\n  if (config.agents.llmsTxt.enabled) {\n    artifacts.llmsFullTxt = abs(\"/llms-full.txt\");\n    artifacts.llmsTxt = abs(\"/llms.txt\");\n  }\n  if (config.agents.mcp.enabled) {\n    artifacts.mcp = {\n      discovery: abs(\"/.well-known/mcp.json\"),\n      url: abs(config.agents.mcp.route),\n    };\n  }\n  if (config.ai.assistant?.enabled) {\n    artifacts.askApi = askApiUrl(config.ai.assistant.endpoint, site, abs);\n  }\n  Object.assign(artifacts, wellKnownArtifacts(config, abs));\n  if (site && config.seo.sitemap) {\n    artifacts.sitemap = abs(\"/sitemap.xml\");\n  }\n  const feeds =\n    site && config.seo.rss.enabled\n      ? buildRssFeeds(project).map((feed) => abs(feed.path))\n      : [];\n  if (feeds.length > 0) {\n    artifacts.feeds = feeds;\n  }\n\n  const version = project.manifest?.blumeVersion;\n  const manifest: AgentReadabilityManifest = {\n    artifacts,\n    description: config.description,\n    generator: version ? `blume@${version}` : undefined,\n    name: config.agents.mcp.name ?? config.title,\n    site,\n  };\n\n  const usage = usagePolicy(config.agents.contentSignals);\n  if (usage) {\n    manifest.contentUsage = usage;\n  }\n  if (config.github) {\n    manifest.repository = repoUrl(config.github);\n  }\n\n  return manifest;\n};\n",
+    "import { mountBasePath, normalizeBasePath } from \"../core/base-path.ts\";\nimport type { BlumeProject } from \"../core/project-graph.ts\";\nimport type { ContentSignalPolicy, ContentSignals } from \"../core/schema.ts\";\nimport { absoluteUrl } from \"../core/site-url.ts\";\n\n/**\n * Ordered mapping from config field to its `Content-Signal` token. The order\n * fixes the emitted sequence (`search`, then `ai-input`, then `ai-train`).\n */\nconst SIGNAL_TOKENS: [keyof ContentSignalPolicy, string][] = [\n  [\"search\", \"search\"],\n  [\"aiInput\", \"ai-input\"],\n  [\"aiTrain\", \"ai-train\"],\n];\n\n/**\n * The `Content-Signal:` line declaring how crawlers may reuse the site, or null\n * when the declaration is disabled (`contentSignals: false`). Otherwise every\n * signal is emitted with its resolved yes/no value.\n */\nconst contentSignalLine = (signals: ContentSignals): string | null => {\n  if (!signals) {\n    return null;\n  }\n  const tokens = SIGNAL_TOKENS.map(\n    ([key, token]) => `${token}=${signals[key] ? \"yes\" : \"no\"}`\n  );\n  return `Content-Signal: ${tokens.join(\", \")}`;\n};\n\n/**\n * Build a robots.txt that allows all crawlers, declares any configured\n * `Content-Signal` usage preferences, and points to the sitemap when one is\n * available (a `site` is set and the sitemap is enabled). Returns null when\n * robots generation is disabled.\n */\nexport const buildRobots = (project: BlumeProject): string | null => {\n  const { config } = project;\n  if (!config.seo.robots) {\n    return null;\n  }\n\n  const lines = [\"User-agent: *\"];\n  const signal = contentSignalLine(config.agents.contentSignals);\n  if (signal) {\n    lines.push(signal);\n  }\n  lines.push(\"Allow: /\");\n\n  const { site } = config.deployment.options;\n  if (site && config.seo.sitemap) {\n    const sitemapPath = mountBasePath(\n      normalizeBasePath(config.deployment.options.base),\n      \"/sitemap.xml\"\n    );\n    lines.push(\"\", `Sitemap: ${absoluteUrl(site, sitemapPath)}`);\n  }\n  return `${lines.join(\"\\n\")}\\n`;\n};\n",
+    "// html-escaper's five-entity table is XML-safe (`'` → the numeric `&#39;`).\nimport { escape as escapeXml } from \"html-escaper\";\n\nimport {\n  customStaticRoutes,\n  discoverPagesSync,\n  hasGeneratedChangelog,\n} from \"../astro/pages.ts\";\nimport {\n  mountBasePath,\n  normalizeBasePath,\n  normalizePath,\n} from \"../core/base-path.ts\";\nimport { isHiddenPage } from \"../core/hidden-pages.ts\";\nimport type { BlumeProject } from \"../core/project-graph.ts\";\nimport { siteRoot } from \"../core/site-url.ts\";\n\n/**\n * Astro's reserved error routes. A user-authored override (`pages/404.astro`,\n * `pages/500.astro`, or a `404.md` content page — see `writeNotFoundPage` in\n * `astro/generate.ts`) is neither dynamic nor private, so it would otherwise\n * be emitted — but error pages aren't crawlable destinations and must stay out\n * of the sitemap.\n */\nconst ERROR_ROUTES = new Set([\"/404\", \"/500\"]);\n\n/** A `<lastmod>` element (W3C date) when the page has a valid modified date. */\nconst lastmodTag = (value: string | undefined): string => {\n  if (!value) {\n    return \"\";\n  }\n  const date = new Date(value);\n  return Number.isNaN(date.getTime())\n    ? \"\"\n    : `<lastmod>${date.toISOString().slice(0, 10)}</lastmod>`;\n};\n\n/**\n * Whether a page's own `seo.canonical` names another URL. The sitemap lists\n * canonical URLs only, so such a page stays out — `blume audit` reports a\n * listed one as NON_CANONICAL_IN_SITEMAP and expects it unlisted. Compared by\n * decoded path, as the audit does: `served` is the page's path with the\n * deployment base mounted, which the canonical carries too.\n */\nconst canonicalElsewhere = (\n  canonical: string | undefined,\n  served: string\n): boolean => {\n  if (!canonical) {\n    return false;\n  }\n  const { pathname } = new URL(canonical);\n  let path = pathname;\n  try {\n    path = decodeURI(pathname);\n  } catch {\n    // A malformed escape stays as written; it can't match the served path.\n  }\n  return normalizePath(path) !== normalizePath(served);\n};\n\n/** One emitted sitemap artifact: its dist-root filename and XML body. */\nexport interface SitemapFile {\n  name: string;\n  xml: string;\n}\n\n/** The build log line for an emitted sitemap set: one file, or an index. */\nexport const describeSitemapFiles = (files: readonly SitemapFile[]): string =>\n  files.length === 1\n    ? \"Generated sitemap.xml\"\n    : `Generated sitemap.xml (index of ${files.length - 1} sitemap files)`;\n\n/**\n * The sitemaps.org cap on `<url>` entries in a single file. Beyond it,\n * `sitemap.xml` becomes a sitemap index pointing at numbered chunk files —\n * search engines reject an oversized urlset outright.\n */\nconst URLS_PER_FILE = 50_000;\n\nconst renderUrlset = (\n  urls: string[]\n): string => `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n${urls.join(\"\\n\")}\n</urlset>\n`;\n\n/**\n * Build the sitemap files from the route manifest plus the routes the manifest\n * can't see: custom `.astro` pages (most importantly a custom landing `/`) and\n * the generated `/changelog` index. Returns null when the sitemap is disabled\n * or no `site` is configured (absolute URLs are required for a valid sitemap).\n * Drafts, hidden, and `noindex` pages are excluded, and so is a page whose\n * `seo.canonical` points elsewhere.\n *\n * Sites within the per-file URL cap get the single classic `sitemap.xml`;\n * larger sites get `sitemap.xml` as a sitemap index over numbered\n * `sitemap-N.xml` chunks, all served from the same directory robots.txt\n * already points at.\n */\nexport const buildSitemapFiles = (\n  project: BlumeProject\n): SitemapFile[] | null => {\n  const { site } = project.config.deployment.options;\n  if (!(site && project.config.seo.sitemap)) {\n    return null;\n  }\n\n  const base = siteRoot(site);\n  // Routes carry `basePath`; a `deployment.base` subdirectory is mounted on\n  // top of every one, even a route whose first segment matches it: under base\n  // `/guides`, `guides/setup.md` is served at `/guides/guides/setup`.\n  const deployBase = normalizeBasePath(project.config.deployment.options.base);\n\n  // Archived-version pages leave the sitemap when the version is noindexed,\n  // or when their canonical points at a still-existing latest equivalent —\n  // listing a URL whose canonical says \"index the other page\" invites the\n  // noindexed-page-in-sitemap incoherence Docusaurus is known for. A page\n  // that exists only in an archived version stays listed (self-canonical),\n  // and a page's own `seo.canonical` wins over the version's default, as it\n  // does in the page head (see `canonicalElsewhere`).\n  const { versions } = project.config;\n  const archivedById = new Map(\n    (versions?.archived ?? []).map((version) => [version.id, version])\n  );\n  const currentKeys = versions\n    ? new Set(\n        project.graph.pages.flatMap((page) =>\n          page.version === \"\" ? [`${page.versionKey}\\u0000${page.locale}`] : []\n        )\n      )\n    : null;\n  const archivedExcluded = (page: (typeof project.graph.pages)[number]) => {\n    if (!page.version) {\n      return false;\n    }\n    // A non-empty version always names a configured archived entry — that is\n    // the only way detection assigns one.\n    const archived = archivedById.get(page.version);\n    return Boolean(\n      archived?.noindex ||\n      (archived?.canonical === \"latest\" &&\n        !page.meta.seo.canonical &&\n        currentKeys?.has(`${page.versionKey}\\u0000${page.locale}`))\n    );\n  };\n\n  const seen = new Set<string>();\n  const urls: string[] = [];\n  const pushUrl = (route: string, lastModified?: string): void => {\n    // `<loc>` must be a well-formed, XML-escaped URL: percent-encode the path,\n    // then escape XML metacharacters (notably `&`) so a route like\n    // `/Tips & Tricks` doesn't produce invalid XML that gets the whole sitemap\n    // rejected.\n    const loc = escapeXml(encodeURI(`${base}${route}`));\n    if (seen.has(loc)) {\n      return;\n    }\n    seen.add(loc);\n    urls.push(`  <url><loc>${loc}</loc>${lastmodTag(lastModified)}</url>`);\n  };\n  for (const page of project.graph.pages) {\n    const served = mountBasePath(deployBase, page.route);\n    if (\n      page.meta.draft ||\n      isHiddenPage(page, project.graph) ||\n      page.meta.seo.noindex ||\n      ERROR_ROUTES.has(page.route) ||\n      archivedExcluded(page) ||\n      canonicalElsewhere(page.meta.seo.canonical, served)\n    ) {\n      continue;\n    }\n    pushUrl(served, page.lastModified);\n  }\n  // Custom `.astro` pages and the generated changelog index mount outside\n  // `basePath` (they're injected at their pattern — see `blumeIntegration`), so\n  // only the deployment base layers onto their URLs.\n  const userPages = project.context.pagesRoot\n    ? discoverPagesSync(project.context.pagesRoot)\n    : [];\n  const extraRoutes = customStaticRoutes(userPages).filter(\n    (route) => !ERROR_ROUTES.has(route)\n  );\n  if (hasGeneratedChangelog(project, userPages)) {\n    extraRoutes.push(\"/changelog\");\n  }\n  for (const route of extraRoutes) {\n    pushUrl(mountBasePath(deployBase, route));\n  }\n  urls.sort();\n\n  if (urls.length <= URLS_PER_FILE) {\n    return [{ name: \"sitemap.xml\", xml: renderUrlset(urls) }];\n  }\n\n  const chunks: SitemapFile[] = [];\n  const references: string[] = [];\n  for (let start = 0; start < urls.length; start += URLS_PER_FILE) {\n    const name = `sitemap-${chunks.length + 1}.xml`;\n    chunks.push({\n      name,\n      xml: renderUrlset(urls.slice(start, start + URLS_PER_FILE)),\n    });\n    // Chunks sit next to sitemap.xml, so their URLs layer the same deployment\n    // base robots.txt uses for the index.\n    const loc = escapeXml(\n      encodeURI(`${base}${mountBasePath(deployBase, `/${name}`)}`)\n    );\n    references.push(`  <sitemap><loc>${loc}</loc></sitemap>`);\n  }\n  const index = `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<sitemapindex xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n${references.join(\"\\n\")}\n</sitemapindex>\n`;\n  return [{ name: \"sitemap.xml\", xml: index }, ...chunks];\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "AFE0F5252B96AD6064756E2164756E21",
+  "names": []
+}

package/dist/cli/{chunk-ckrcm08h.js → chunk-a3ydrqny.js}

@@ -1,78 +1,64 @@
 #!/usr/bin/env node
 import {
-  packageRoot
-} from "./index.js";
-import {
+  BUILTIN_MDX_TAGS,
+  BUILTIN_CHILD_PROPS,
   commandsFor,
   detectProjectPackageManager
-} from "./chunk-124fvmzq.js";
+} from "./chunk-dm4mg9bj.js";
+import {
+  packageRoot
+} from "./index.js";
 
 // src/core/component-diagnostics.ts
 import { relative } from "pathe";
-
-// src/core/builtin-tags.ts
-var BUILTIN_MDX_TAGS = new Set([
-  "Accordion",
-  "AccordionItem",
-  "ApiOverview",
-  "ApiTagOperations",
-  "AutoTypeTable",
-  "Badge",
-  "Callout",
-  "Card",
-  "CardGroup",
-  "CodeBlock",
-  "CodeGroup",
-  "Color",
-  "Column",
-  "Columns",
-  "Component",
-  "Diff",
-  "Expandable",
-  "FileTree",
-  "Frame",
-  "GithubInfo",
-  "Icon",
-  "Math",
-  "Operation",
-  "Panel",
-  "ParamField",
-  "Prompt",
-  "RequestExample",
-  "ResponseExample",
-  "ResponseField",
-  "Step",
-  "Steps",
-  "Tab",
-  "Tabs",
-  "Tile",
-  "Tooltip",
-  "Tree",
-  "TypeTable",
-  "View",
-  "Visibility",
-  "YouTube"
-]);
-
-// src/core/component-diagnostics.ts
 var toKebab = (tag) => tag.replaceAll(/(?<lower>[a-z0-9])(?<upper>[A-Z])/gu, "$<lower>-$<upper>").toLowerCase();
+var LIST = new Intl.ListFormat("en", { type: "conjunction" });
 var validateUsedComponents = (pages, extraTags, registryNames) => {
+  const users = new Map;
+  for (const page of pages) {
+    for (const tag of page.componentsUsed ?? []) {
+      if (!(BUILTIN_MDX_TAGS.has(tag) || extraTags.has(tag))) {
+        users.set(tag, [...users.get(tag) ?? [], page]);
+      }
+    }
+  }
+  return [...users].map(([tag, using]) => {
+    const name = toKebab(tag);
+    const suggestion = registryNames.has(name) ? `Run \`blume add ${name}\` to install it, or register <${tag}> in components.ts (mdx).` : `Register <${tag}> in components.ts (mdx), or add an islands/${tag}.tsx component.`;
+    const routes = using.map((page) => page.route);
+    const [first] = using;
+    return {
+      code: "BLUME_UNKNOWN_COMPONENT",
+      file: first?.sourcePath ?? first?.id,
+      message: routes.length === 1 ? `<${tag}> is used in ${LIST.format(routes)} but isn't a known component.` : `<${tag}> is used on ${routes.length} pages but isn't a known component: ${LIST.format(routes)}.`,
+      severity: "warning",
+      suggestion
+    };
+  });
+};
+var EITHER = new Intl.ListFormat("en", { type: "disjunction" });
+var quoted = (names) => names.map((name) => `\`${name}\``);
+var unknownPropDiagnostics = (pages, extraTags) => {
   const diagnostics = [];
   const seen = new Set;
   for (const page of pages) {
-    for (const tag of page.componentsUsed ?? []) {
-      if (BUILTIN_MDX_TAGS.has(tag) || extraTags.has(tag) || seen.has(tag)) {
+    for (const use of page.unknownProps ?? []) {
+      const file = use.file ?? page.sourcePath ?? page.id;
+      const key = `${file}:${use.line}:${use.column}`;
+      if (extraTags.has(use.tag) || seen.has(key)) {
         continue;
       }
-      seen.add(tag);
-      const name = toKebab(tag);
-      const suggestion = registryNames.has(name) ? `Run \`blume add ${name}\` to install it, or register <${tag}> in components.ts (mdx).` : `Register <${tag}> in components.ts (mdx), or add an islands/${tag}.tsx component.`;
+      seen.add(key);
+      const accepted = BUILTIN_CHILD_PROPS.get(use.tag) ?? [];
+      const takes = accepted.length > 0 ? `, and use the props ${use.tag} takes: ${LIST.format(quoted(accepted))}` : `; ${use.tag} takes no props`;
       diagnostics.push({
-        code: "BLUME_UNKNOWN_COMPONENT",
-        file: page.sourcePath ?? page.id,
-        message: `<${tag}> is used in ${page.route} but isn't a known component.`,
+        code: "BLUME_UNKNOWN_PROP",
+        column: use.column,
+        file,
+        line: use.line,
+        message: `<${use.tag}> in ${page.route} has no children, and ${use.tag} doesn't take ${EITHER.format(quoted(use.props))}, so it renders without what ${use.props.length === 1 ? "that prop" : "those props"} meant to show.`,
         severity: "warning",
-        suggestion
+        suggestion: `Put the content between the tags (<${use.tag}>…</${use.tag}>)${takes}.`
       });
     }
   }
@@ -318,7 +304,7 @@ var missingDependencyDiagnostic = async (config, root, severity, frameworks = []
   };
 };
 
-export { validateUsedComponents, missingExampleDiagnostics, discoverIslands, EXAMPLE_SCAN_GLOB, exampleScanRoots, discoverExamples, exampleMarkdownLookup, missingDependencyDiagnostic };
+export { validateUsedComponents, unknownPropDiagnostics, missingExampleDiagnostics, discoverIslands, EXAMPLE_SCAN_GLOB, exampleScanRoots, discoverExamples, exampleMarkdownLookup, missingDependencyDiagnostic };
 
-//# debugId=88F80DB4180F01D164756E2164756E21
-//# sourceMappingURL=chunk-ckrcm08h.js.map
+//# debugId=01581CA3D72AB06264756E2164756E21
+//# sourceMappingURL=chunk-a3ydrqny.js.map