blume 1.7.3 → 2.0.1

package/dist/cli/chunk-6hsn950k.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/registry/eject.ts"],
+  "sourcesContent": [
+    "import { existsSync } from \"node:fs\";\nimport { cp, mkdir, readFile, rm, writeFile } from \"node:fs/promises\";\n\nimport { join, relative } from \"pathe\";\n\nimport { buildAskData } from \"../ai/ask-data.ts\";\nimport { resolveAskBackend } from \"../ai/ask.ts\";\nimport { buildRawMarkdown } from \"../ai/markdown.ts\";\nimport { buildMcpData } from \"../ai/mcp/data.ts\";\nimport { buildMcpDiscovery, buildMcpServerCard } from \"../ai/mcp/discovery.ts\";\nimport { planComponentSlots } from \"../astro/component-slots.ts\";\nimport {\n  EXAMPLE_SCAN_GLOB,\n  discoverExamples,\n  exampleMarkdownLookup,\n  exampleScanRoots,\n} from \"../astro/examples.ts\";\nimport {\n  analyzeComponentsFile,\n  buildRuntimeData,\n  clientFeaturesFor,\n  collectStaged,\n  detectNeedsReact,\n  detectUsesMath,\n  languageIconCssFor,\n} from \"../astro/generate.ts\";\nimport { discoverIslands } from \"../astro/islands.ts\";\nimport { customOgRoutes, discoverPages, routeIsTaken } from \"../astro/pages.ts\";\nimport {\n  askComponentTemplate,\n  askEndpointTemplate,\n  astroConfigTemplate,\n  catchAllPageTemplate,\n  changelogIndexTemplate,\n  contentConfigTemplate,\n  exampleMapTemplate,\n  exampleSlug,\n  examplesPageTemplate,\n  exampleWrapperTemplate,\n  featuresTemplate,\n  mcpEndpointTemplate,\n  mcpPageFile,\n  mixedbreadSearchEndpointTemplate,\n  notFoundPageTemplate,\n  ogEndpointTemplate,\n  rawMarkdownEndpointTemplate,\n  rssEndpointTemplate,\n  runtimeDependencies,\n  runtimeTsconfigTemplate,\n  searchClientTemplate,\n  searchEndpointTemplate,\n  staticJsonEndpointTemplate,\n} from \"../astro/templates.ts\";\nimport { buildIncludeGraph } from \"../core/includes.ts\";\nimport { packageRoot } from \"../core/package-root.ts\";\nimport { scanProject } from \"../core/project-graph.ts\";\nimport type { BlumeProject } from \"../core/project-graph.ts\";\nimport {\n  resolveDocsCollection,\n  sourcesOfKind,\n} from \"../core/sources/collection.ts\";\nimport type { ProjectContext } from \"../core/types.ts\";\nimport { buildRssFeeds, renderRssFeed } from \"../deploy/rss.ts\";\nimport type { OpenApiData } from \"../openapi/model.ts\";\nimport { hasScalarReferences } from \"../openapi/references.ts\";\nimport { buildReferenceFiles } from \"../openapi/scalar.ts\";\nimport { isOpenApiSource } from \"../openapi/source.ts\";\nimport { buildSearchDocuments } from \"../search/documents.ts\";\nimport {\n  examplesEntryTemplate,\n  tailwindEntryTemplate,\n} from \"../theme/entry.ts\";\nimport { buildThemeCss } from \"../theme/palette.ts\";\nimport { rebaseSourceDirectives } from \"../theme/sources.ts\";\nimport { twoslashCss } from \"../theme/twoslash.ts\";\n\nconst toPosix = (path: string): string => path.split(\"\\\\\").join(\"/\");\n\n/** The portable `@source` guess: blume in the project's own node_modules. */\nconst LOCAL_BLUME_SOURCE = \"../../node_modules/blume/src/**/*.{astro,ts,tsx}\";\n\n/**\n * The `@source` glob pointing Tailwind at Blume's own source, relative to the\n * ejected `src/generated/app.css`. The project-local `node_modules/blume` is\n * preferred (portable, and under pnpm the symlink survives version bumps), but\n * hoisted installs (npm/yarn workspaces lift blume into the workspace root's\n * node_modules) would make that guess match nothing and silently drop utility\n * classes — so fall back to the package's real installed location, and when\n * even that fails, warn instead of failing silently.\n *\n * Exported for testing.\n */\nexport const blumeSourceGlob = (\n  root: string,\n  genDir: string,\n  resolveBlumeRoot: () => string = packageRoot\n): string => {\n  if (existsSync(join(root, \"node_modules\", \"blume\"))) {\n    return LOCAL_BLUME_SOURCE;\n  }\n  try {\n    const src = join(resolveBlumeRoot(), \"src\");\n    return `${toPosix(relative(genDir, src))}/**/*.{astro,ts,tsx}`;\n  } catch {\n    console.warn(\n      'blume: could not locate the installed blume package; src/generated/app.css keeps its default `@source \"../../node_modules/blume/...\"` glob. If blume is hoisted elsewhere, point that glob at its install location or Blume\\'s utility classes will be missing.'\n    );\n    return LOCAL_BLUME_SOURCE;\n  }\n};\n\n/** The `blume:openapi` payload for the ejected app (`{}` when none). */\nconst ejectOpenApiData = (project: BlumeProject): OpenApiData => {\n  const source = project.sources.find(isOpenApiSource);\n  return source ? source.openApiData() : {};\n};\n\n/**\n * The assistant endpoint plus, unless the backend runs its own retrieval (Inkeep),\n * its grounding snapshot. Empty when the assistant is disabled.\n */\nconst askFiles = async (\n  project: BlumeProject,\n  srcDir: string,\n  genDir: string\n): Promise<{ content: string; path: string }[]> => {\n  const { assistant } = project.config.ai;\n  if (!(assistant?.enabled && !assistant.endpoint)) {\n    const endpointPath = join(srcDir, \"pages\", \"api\", \"ask.ts\");\n    if (existsSync(endpointPath)) {\n      const content = await readFile(endpointPath, \"utf-8\");\n      if (content.startsWith(\"// Generated by Blume. Do not edit.\")) {\n        await rm(endpointPath, { force: true });\n      }\n    }\n    await rm(join(genDir, \"ask-data.json\"), { force: true });\n    return [];\n  }\n  const backend = resolveAskBackend(assistant.provider);\n  const files = [\n    {\n      content: askEndpointTemplate(backend, {\n        cors: assistant.cors,\n        instructions: assistant.instructions,\n        retrieval: assistant.retrieval,\n      }),\n      path: join(srcDir, \"pages\", \"api\", \"ask.ts\"),\n    },\n  ];\n  if (backend.grounded) {\n    files.push({\n      content: `${JSON.stringify(await buildAskData(project))}\\n`,\n      path: join(genDir, \"ask-data.json\"),\n    });\n  }\n  return files;\n};\n\n/** Whether the ejected app hosts the MCP server (enabled and route free). */\nconst hostsMcp = (\n  project: BlumeProject,\n  userPages: { pattern: string }[]\n): boolean =>\n  project.config.agents.mcp.enabled &&\n  !routeIsTaken(\n    userPages,\n    project.graph.pages,\n    project.config.agents.mcp.route\n  );\n\n/**\n * The `.well-known` MCP discovery routes, injected as prerendered pages\n * alongside the user's own so the ejected Astro config wires them in. Empty\n * when the server is disabled or its route is already owned by a page.\n */\nconst mcpDiscoveryPages = (\n  project: BlumeProject,\n  userPages: { pattern: string }[]\n): { entrypoint: string; pattern: string }[] =>\n  hostsMcp(project, userPages)\n    ? [\n        {\n          entrypoint: \"src/blume-mcp/discovery.ts\",\n          pattern: \"/.well-known/mcp.json\",\n        },\n        {\n          entrypoint: \"src/blume-mcp/server-card.ts\",\n          pattern: \"/.well-known/mcp/server-card.json\",\n        },\n      ]\n    : [];\n\n/**\n * The MCP data snapshot, server endpoint, and `.well-known` discovery\n * documents, mirroring `writeMcpFiles` in generate.ts. Empty when the server\n * is disabled or its route is already owned by a page.\n */\nconst mcpFiles = async (\n  project: BlumeProject,\n  userPages: { pattern: string }[],\n  srcDir: string,\n  genDir: string\n): Promise<{ content: string; path: string }[]> => {\n  if (!hostsMcp(project, userPages)) {\n    return [];\n  }\n  const { route } = project.config.agents.mcp;\n  const data = await buildMcpData(project);\n  const discoveryInput = {\n    base: data.base,\n    name: data.name,\n    route,\n    site: data.site,\n    version: data.version,\n  };\n  return [\n    {\n      content: `${JSON.stringify(data)}\\n`,\n      path: join(genDir, \"mcp-data.json\"),\n    },\n    {\n      content: mcpEndpointTemplate(),\n      path: join(srcDir, \"pages\", mcpPageFile(route)),\n    },\n    {\n      content: staticJsonEndpointTemplate(buildMcpDiscovery(discoveryInput)),\n      path: join(srcDir, \"blume-mcp\", \"discovery.ts\"),\n    },\n    {\n      content: staticJsonEndpointTemplate(buildMcpServerCard(discoveryInput)),\n      path: join(srcDir, \"blume-mcp\", \"server-card.ts\"),\n    },\n  ];\n};\n\n/**\n * The `/changelog` index page, mirroring `shouldGenerateChangelog` in\n * generate.ts: emitted when `type: changelog` entries or a release-backed\n * changelog source exist, unless a user page already owns the route.\n */\nconst changelogFiles = (\n  project: BlumeProject,\n  userPages: { pattern: string }[],\n  srcDir: string,\n  options: Parameters<typeof changelogIndexTemplate>[0]\n): { content: string; path: string }[] => {\n  const hasChangelog = project.graph.pages.some(\n    (page) =>\n      page.contentType === \"changelog\" &&\n      !(page.meta.draft || page.meta.sidebar.hidden)\n  );\n  const hasChangelogSource =\n    sourcesOfKind(project.config, \"github-releases\").length > 0;\n  if (\n    !(hasChangelog || hasChangelogSource) ||\n    routeIsTaken(userPages, project.graph.pages, \"/changelog\")\n  ) {\n    return [];\n  }\n  return [\n    {\n      content: changelogIndexTemplate(options),\n      path: join(srcDir, \"pages\", \"changelog.astro\"),\n    },\n  ];\n};\n\n/** Contents of the configured `examples.css`, or `\"\"` when unset/absent. */\n/**\n * Read a user stylesheet that eject inlines into a generated entry under\n * `genDir`, re-rooting its relative `@source` paths from the user's file.\n * Resolves to an empty string when the file is unset or absent.\n */\nconst readUserCss = async (\n  file: string | null,\n  genDir: string\n): Promise<string> => {\n  if (!(file && existsSync(file))) {\n    return \"\";\n  }\n  const css = await readFile(file, \"utf-8\");\n  return rebaseSourceDirectives(css, { from: file, to: genDir });\n};\n\n/**\n * The per-example preview route `<Component />` iframes embed, nested under\n * `basePath` so it stays reachable behind a proxy that only forwards the\n * base. Empty when the project has no examples.\n */\nconst examplesPreviewFiles = (\n  srcDir: string,\n  basePath: string,\n  hasExamples: boolean\n): { content: string; path: string }[] =>\n  hasExamples\n    ? [\n        {\n          content: examplesPageTemplate(),\n          path: join(\n            srcDir,\n            \"pages\",\n            ...basePath.split(\"/\").filter(Boolean),\n            \"blume-examples\",\n            \"[...path].astro\"\n          ),\n        },\n      ]\n    : [];\n\n/**\n * The packages the ejected app imports by bare name: Astro, Tailwind's Vite\n * plugin, `blume` itself, the integrations the config wires in, whatever the\n * configured adapters declare, and React when islands, examples, or the assistant\n * render with it (Blume ships React, so projects rarely list it). They have\n * to be the project's own dependencies after eject — under a strict linker\n * such as pnpm nothing else makes them resolvable, and `astro build` fails.\n * The hidden runtime reaches the same packages through its `node_modules`\n * junction into Blume's own, so only eject declares the ones its generated\n * files import directly: the AI SDK the assistant route streams through (unless\n * `ai.assistant.endpoint` points elsewhere, when no route is written) and the EPUB\n * generator's browser bundle `features.ts` loads.\n */\nconst ejectDependencies = (\n  options: Parameters<typeof runtimeDependencies>[0]\n): string[] => {\n  const { assistant } = options.config.ai;\n  return [\n    ...new Set([\n      \"astro\",\n      \"@tailwindcss/vite\",\n      \"blume\",\n      ...runtimeDependencies(options),\n      ...(options.needsReact ? [\"react\", \"react-dom\"] : []),\n      ...(assistant?.enabled && !assistant.endpoint ? [\"ai\"] : []),\n      ...(options.config.export.epub ? [\"epub-gen-memory\"] : []),\n    ]),\n  ];\n};\n\nconst ejectIntegrationBridge = (\n  config: BlumeProject[\"config\"],\n  root: string,\n  configFile: string | null\n): Parameters<typeof astroConfigTemplate>[0][\"integrationBridge\"] =>\n  config.integrations.length > 0 && configFile\n    ? { configFile: toPosix(relative(root, configFile)) }\n    : undefined;\n\n/**\n * Promote the generated runtime into the project as an owned Astro app. After\n * eject the project has a normal `astro.config.mjs` and `src/`, the `blume` CLI\n * is no longer required, and the `blume` package remains importable.\n *\n * Returns the written files plus non-fatal warnings, mirroring the generated\n * runtime (e.g. a Scalar reference spec that wasn't found, or a reference\n * route colliding with a content page), and the packages the ejected app\n * imports by bare name, for the caller to add to package.json.\n */\nexport const eject = async (\n  root: string\n): Promise<{ dependencies: string[]; files: string[]; warnings: string[] }> => {\n  const project = await scanProject(root, { mode: \"build\" });\n  const { context, config } = project;\n\n  const srcDir = join(root, \"src\");\n  const genDir = join(srcDir, \"generated\");\n  const assistantEnabled = config.ai.assistant?.enabled ?? false;\n  const exportPdf = config.export.pdf;\n  const exportEpub = config.export.epub;\n\n  // Discover examples first and expose them on the project, so the agent-facing\n  // Markdown built below (raw `.md`, MCP) downlevels `<Component>` to its source.\n  const examples = await discoverExamples(root, config.examples.source);\n  project.examples = exampleMarkdownLookup(examples.examples);\n\n  const [\n    pages,\n    needsReactRaw,\n    usesMath,\n    userTheme,\n    userExamplesCss,\n    rawMarkdown,\n    islands,\n    overrideAnalysis,\n  ] = await Promise.all([\n    context.pagesRoot ? discoverPages(context.pagesRoot) : Promise.resolve([]),\n    detectNeedsReact(root),\n    detectUsesMath(root),\n    readUserCss(context.themeFile, genDir),\n    readUserCss(\n      config.examples.css ? join(root, config.examples.css) : null,\n      genDir\n    ),\n    buildRawMarkdown(project),\n    discoverIslands(root),\n    analyzeComponentsFile(context.componentsFile),\n  ]);\n  // The `islands/` convention and `components.ts` share the same static plan\n  // the CLI uses, with every import written relative to its generated file so\n  // the ejected app builds from any checkout (like the example wrappers below).\n  const slotPlan = planComponentSlots(islands.islands, overrideAnalysis, {\n    relativeTo: genDir,\n  });\n  // Island/example/override frameworks drive which Astro renderers the ejected\n  // config wires in; React also switches on for project `.tsx`/`.jsx` and the assistant.\n  const frameworks = new Set<string>([\n    ...islands.islands.map((island) => island.framework),\n    ...examples.examples.map((example) => example.framework),\n    ...slotPlan.frameworks,\n  ]);\n  const needsReact =\n    needsReactRaw || assistantEnabled || frameworks.has(\"react\");\n  const needsVue = frameworks.has(\"vue\");\n  const needsSvelte = frameworks.has(\"svelte\");\n\n  // A project-relative context so generated files use portable paths.\n  const relContext: ProjectContext = {\n    ...context,\n    contentRoot: toPosix(relative(root, context.contentRoot)),\n    distDir: \"./dist\",\n    outDir: \".\",\n    pagesRoot: context.pagesRoot\n      ? `./${toPosix(relative(root, context.pagesRoot))}`\n      : null,\n    root: \".\",\n  };\n  // The `docs` collection resolves its base against the real project root and\n  // is then relativized like everything else, so the ejected content config\n  // never bakes in the absolute path `eject` happened to run from.\n  const docsCollection = resolveDocsCollection(config, root);\n  const relCollection = {\n    ...docsCollection,\n    base: toPosix(relative(root, docsCollection.base)),\n  };\n\n  const relPages = [\n    ...pages.map((page) => ({\n      entrypoint: toPosix(relative(root, page.entrypoint)),\n      pattern: page.pattern,\n    })),\n    ...mcpDiscoveryPages(project, pages),\n  ];\n\n  // Non-filesystem sources eject their materialized MDX into `<root>/blume-staged`\n  // (a dedicated dir so it never clashes with a content root literally named\n  // `content`; the relative `staged` collection points there).\n  const staged = collectStaged(project);\n  const hasStaged = staged.size > 0;\n  const stagedDir = \"blume-staged\";\n  const features = await clientFeaturesFor(project);\n  const languageIcons = await languageIconCssFor(project);\n\n  const files: {\n    path: string;\n    content: string;\n    /** Don't overwrite a file the user already owns (e.g. a tuned tsconfig). */\n    skipIfExists?: boolean;\n  }[] = [\n    {\n      content: astroConfigTemplate({\n        askPath: \"./src/generated/Ask.astro\",\n        config,\n        contentRoot: relContext.contentRoot,\n        contentRoutes: project.manifest.routes.map((route) => route.path),\n        context: relContext,\n        examplesPath: \"./src/generated/examples.ts\",\n        examplesThemePath: \"./src/generated/examples.css\",\n        features,\n        featuresPath: \"./src/generated/features.ts\",\n        // No CLI publishes the runtime data modules in memory after eject, so\n        // the config aliases each to the JSON snapshot written below.\n        generatedModulesDir: \"./src/generated\",\n        integrationBridge: ejectIntegrationBridge(\n          config,\n          root,\n          context.configFile\n        ),\n        needsReact,\n        needsSvelte,\n        needsVue,\n        pages: relPages,\n        searchClientPath: \"./src/generated/search-client.ts\",\n        themePath: \"./src/generated/app.css\",\n      }),\n      path: join(root, \"astro.config.mjs\"),\n    },\n    {\n      content: runtimeTsconfigTemplate(),\n      path: join(root, \"tsconfig.json\"),\n      // Never clobber a hand-tuned tsconfig; only write ours if none exists.\n      skipIfExists: true,\n    },\n    {\n      content: contentConfigTemplate({\n        collection: relCollection,\n        config,\n        context: relContext,\n        staged: hasStaged,\n        stagedBase: stagedDir,\n      }),\n      path: join(srcDir, \"content.config.ts\"),\n    },\n    {\n      content: catchAllPageTemplate({\n        exportEpub,\n        exportPdf,\n        mathEnabled: usesMath,\n        needsReact,\n      }),\n      path: join(srcDir, \"pages\", \"[...slug].astro\"),\n    },\n    {\n      content: slotPlan.module,\n      path: join(genDir, \"components.ts\"),\n    },\n    // The example map the catch-all imports; written even when empty so the\n    // `blume:examples` alias always resolves.\n    {\n      content: exampleMapTemplate(examples.examples, config.basePath),\n      path: join(genDir, \"examples.ts\"),\n    },\n    {\n      // The isolated Tailwind entry for `<Component />` preview frames.\n      // Relative sources keep the ejected app portable.\n      content: examplesEntryTemplate({\n        configTokens: buildThemeCss(config.theme),\n        sources: exampleScanRoots(root, examples.dir).map(\n          (dir) => `${relative(genDir, dir)}/${EXAMPLE_SCAN_GLOB}`\n        ),\n        userCss: userExamplesCss,\n      }),\n      path: join(genDir, \"examples.css\"),\n    },\n    {\n      content: tailwindEntryTemplate({\n        configTokens: buildThemeCss(config.theme),\n        languageIcons,\n        // Relative paths from src/generated/app.css keep the ejected app\n        // portable; the blume glob resolves the real install location when\n        // the package is hoisted out of the project's own node_modules.\n        sources: [\n          blumeSourceGlob(root, genDir),\n          \"../../**/*.{astro,mdx,ts,tsx}\",\n        ],\n        twoslashCss: twoslashCss(),\n        userTheme,\n      }),\n      path: join(genDir, \"app.css\"),\n    },\n    { content: buildRuntimeData(project), path: join(genDir, \"data.json\") },\n    // The header's Ask trigger behind the `blume:ask` alias. Always written — it\n    // renders nothing when Ask is off — so the alias always resolves.\n    {\n      content: askComponentTemplate(assistantEnabled),\n      path: join(genDir, \"Ask.astro\"),\n    },\n    {\n      content: `${JSON.stringify(ejectOpenApiData(project))}\\n`,\n      path: join(genDir, \"openapi.json\"),\n    },\n    {\n      content: `${JSON.stringify(rawMarkdown)}\\n`,\n      path: join(genDir, \"raw-markdown.json\"),\n    },\n    {\n      // The partial → including-pages map behind `includeHmrPlugin`, which the\n      // ejected astro.config wires at this exact path — without the file every\n      // hot update's read would silently no-op and partial edits would serve\n      // stale pages. A snapshot like the rest of `src/generated`: the ejected\n      // app owns (and may regenerate or prune) it.\n      content: `${JSON.stringify(buildIncludeGraph(project.graph.pages))}\\n`,\n      path: join(genDir, \"includes.json\"),\n    },\n    {\n      content: rawMarkdownEndpointTemplate(\"md\"),\n      path: join(srcDir, \"pages\", \"[...slug].md.ts\"),\n    },\n    {\n      content: rawMarkdownEndpointTemplate(\"mdx\"),\n      path: join(srcDir, \"pages\", \"[...slug].mdx.ts\"),\n    },\n  ];\n\n  if (assistantEnabled) {\n    files.push(...(await askFiles(project, srcDir, genDir)));\n  }\n\n  if (config.seo.og.enabled) {\n    files.push({\n      content: ogEndpointTemplate(\n        customOgRoutes(pages, config.title, config.seo.og.titles),\n        { pageDescriptions: config.seo.og.description !== false }\n      ),\n      path: join(srcDir, \"pages\", \"og\", \"[...slug].png.ts\"),\n    });\n  }\n\n  // The hosted MCP server and the `/changelog` index, mirrored from the\n  // generated runtime (each helper returns `[]` when its feature is off).\n  files.push(\n    ...(await mcpFiles(project, pages, srcDir, genDir)),\n    ...changelogFiles(project, pages, srcDir, {\n      exportEpub,\n      exportPdf,\n      needsReact,\n      staged: hasStaged,\n    })\n  );\n\n  // Default 404 page, unless the project already owns `/404` (a custom\n  // `pages/404.astro` or a `404.md` content page). The ejected project owns the\n  // file afterwards and can edit or remove it.\n  if (!routeIsTaken(pages, project.graph.pages, \"/404\")) {\n    files.push({\n      content: notFoundPageTemplate(),\n      path: join(srcDir, \"pages\", \"404.astro\"),\n    });\n  }\n\n  // The client-feature loaders behind the `blume:features` alias, and the\n  // provider-specific client loader behind `blume:search-client`.\n  files.push(\n    {\n      content: featuresTemplate(features),\n      path: join(genDir, \"features.ts\"),\n    },\n    {\n      content: searchClientTemplate(config),\n      path: join(genDir, \"search-client.ts\"),\n    }\n  );\n\n  const searchAdapter = config.search.provider;\n  if (searchAdapter.mode === \"static\") {\n    const documents = await buildSearchDocuments(project);\n    files.push(\n      {\n        content: `${JSON.stringify(documents)}\\n`,\n        path: join(genDir, \"search.json\"),\n      },\n      {\n        content: searchEndpointTemplate(),\n        path: join(srcDir, \"pages\", \"blume-search.json.ts\"),\n      }\n    );\n  }\n\n  if (searchAdapter.kind === \"mixedbread\") {\n    files.push({\n      content: mixedbreadSearchEndpointTemplate(searchAdapter.options),\n      path: join(srcDir, \"pages\", \"api\", \"search.ts\"),\n    });\n  }\n\n  const feeds = buildRssFeeds(project);\n  if (feeds.length > 0) {\n    const feedXml = Object.fromEntries(\n      feeds.map((feed) => [feed.type, renderRssFeed(feed)])\n    );\n    files.push(\n      {\n        content: `${JSON.stringify(feedXml)}\\n`,\n        path: join(genDir, \"rss.json\"),\n      },\n      {\n        content: rssEndpointTemplate(),\n        path: join(srcDir, \"pages\", \"[section]\", \"rss.xml.ts\"),\n      }\n    );\n  }\n\n  // Scalar API/AsyncAPI reference pages, mirrored from the generated runtime so\n  // the ejected app keeps its reference routes — including the warnings (a\n  // missing spec file, a route collision), which the caller surfaces exactly\n  // like the generated-runtime path does.\n  const warnings: string[] = [];\n  if (hasScalarReferences(config)) {\n    const references = await buildReferenceFiles({\n      config,\n      contentRoutes: new Set(project.graph.pages.map((page) => page.route)),\n      root,\n    });\n    warnings.push(...references.warnings);\n    for (const file of references.files) {\n      files.push({\n        content: file.content,\n        path: join(srcDir, \"pages\", file.pagePath),\n      });\n    }\n  }\n\n  // Per-override and per-example live wrappers referenced by the maps above.\n  files.push(\n    ...slotPlan.wrappers.map((wrapper) => ({\n      content: wrapper.content,\n      path: join(genDir, \"component-slots\", `${wrapper.name}.astro`),\n    })),\n    ...examples.examples.map((example) => ({\n      content: exampleWrapperTemplate(example, join(genDir, \"examples\")),\n      path: join(genDir, \"examples\", `${exampleSlug(example.path)}.astro`),\n    })),\n    ...examplesPreviewFiles(\n      srcDir,\n      config.basePath,\n      examples.examples.length > 0\n    )\n  );\n\n  // Materialize staged source bodies under `<root>/blume-staged/<source>/<ref>`,\n  // matching the relative `staged` collection base in the ejected config.\n  for (const [entryId, content] of staged) {\n    files.push({ content, path: join(root, stagedDir, entryId) });\n  }\n\n  const written = files.filter(\n    (file) => !(file.skipIfExists && existsSync(file.path))\n  );\n  await Promise.all(\n    written.map(async (file) => {\n      await mkdir(join(file.path, \"..\"), { recursive: true });\n      await writeFile(file.path, file.content, \"utf-8\");\n    })\n  );\n\n  // Materialized source assets (e.g. downloaded Notion images) live under the\n  // hidden runtime's public dir; copy them into the owned project's `public/`\n  // so the staged content's `/blume-assets/…` references still resolve.\n  const assetsSrc = join(context.outDir, \"public\", \"blume-assets\");\n  if (existsSync(assetsSrc)) {\n    await cp(assetsSrc, join(root, \"public\", \"blume-assets\"), {\n      recursive: true,\n    });\n  }\n\n  // The hidden runtime is no longer the source of truth.\n  await rm(context.outDir, { force: true, recursive: true });\n\n  return {\n    dependencies: ejectDependencies({\n      config,\n      needsReact,\n      needsSvelte,\n      needsVue,\n    }),\n    files: written.map((file) => file.path),\n    warnings,\n  };\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "038C2E34744E4EC964756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-6vm74dry.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+import {
+  discoverIslands,
+  missingDependencyDiagnostic
+} from "./chunk-wm7js3j9.js";
+import {
+  packageRoot,
+  commandMeta,
+  loadEnvFiles,
+  reportInternalError,
+  BlumeError,
+  logger,
+  flushStdout,
+  reportDiagnosticsJson,
+  reportDiagnostics
+} from "./index.js";
+import"./chunk-qkqwkpte.js";
+import {
+  ComponentOverridesError,
+  analyzeComponentOverrides
+} from "./chunk-vtk4a6dg.js";
+import"./chunk-jts8mvcz.js";
+import {
+  scanProject
+} from "./chunk-fs23ddbb.js";
+import"./chunk-jq5n4avg.js";
+import {
+  unregisteredSnapshotDiagnostics
+} from "./chunk-qs4q5p4e.js";
+import {
+  serverFeatures,
+  checkRequiredSecrets
+} from "./chunk-ah61y8py.js";
+
+// src/cli/commands/doctor.ts
+import { readFileSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { defineCommand } from "citty";
+import { join } from "pathe";
+import { satisfies } from "semver";
+var FALLBACK_NODE_RANGE = ">=22.12.0";
+var componentsDiagnostics = async (componentsFile) => {
+  if (!componentsFile) {
+    return [];
+  }
+  try {
+    analyzeComponentOverrides(await readFile(componentsFile, "utf-8"), componentsFile);
+    return [];
+  } catch (error) {
+    if (error instanceof ComponentOverridesError) {
+      return error.issues;
+    }
+    throw error;
+  }
+};
+var supportedNodeRange = () => {
+  try {
+    const pkg = JSON.parse(readFileSync(join(packageRoot(), "package.json"), "utf-8"));
+    return pkg.engines?.node || FALLBACK_NODE_RANGE;
+  } catch {
+    return FALLBACK_NODE_RANGE;
+  }
+};
+var doctorCommand = defineCommand({
+  args: {
+    json: {
+      description: "Emit diagnostics as JSON on stdout (for CI/editors).",
+      type: "boolean"
+    }
+  },
+  meta: commandMeta.doctor,
+  async run({ args }) {
+    const root = process.cwd();
+    const diagnostics = [];
+    const nodeRange = supportedNodeRange();
+    if (!satisfies(process.versions.node, nodeRange)) {
+      diagnostics.push({
+        code: "BLUME_NODE_VERSION",
+        message: `Node ${process.versions.node} is outside the supported range (${nodeRange}).`,
+        severity: "warning"
+      });
+    }
+    loadEnvFiles(root);
+    try {
+      const project = await scanProject(root, { mode: "build" });
+      diagnostics.push(...project.diagnostics, ...unregisteredSnapshotDiagnostics(project));
+      const { config } = project;
+      const { islands } = await discoverIslands(root);
+      const dependencies = await missingDependencyDiagnostic(config, root, "error", islands.map((island) => island.framework));
+      if (dependencies) {
+        diagnostics.push(dependencies);
+      }
+      diagnostics.push(...await componentsDiagnostics(project.context.componentsFile), ...checkRequiredSecrets(config));
+      const features = serverFeatures(config);
+      if (features.length > 0 && config.deployment.options.output === "static") {
+        const { kind } = config.deployment;
+        diagnostics.push({
+          code: "BLUME_SERVER_FEATURE_REQUIRED",
+          message: `${features.join(", ")} ${features.length === 1 ? "requires" : "require"} server output.`,
+          severity: "error",
+          suggestion: kind === "static" ? 'Set deployment to a host adapter from "blume/deploy" (e.g. `deployment: vercel()`).' : `Drop \`output: "static"\` from \`deployment: ${kind}()\` to build for the server.`
+        });
+      }
+      if (!args.json) {
+        logger.info(`Pages: ${project.graph.pages.length}`);
+        logger.info(`Output: ${config.deployment.options.output}`);
+        logger.info(`Adapter: ${config.deployment.kind}`);
+        logger.info(`Search: ${config.search.provider.kind}`);
+        logger.info(`References: ${config.reference.map((adapter) => adapter.kind).join(", ") || "none"}`);
+        logger.info(`Analytics: ${config.analytics.map((adapter) => adapter.kind).join(", ") || "none"}`);
+        logger.info(`Sources: ${config.content.sources.map((source) => source.kind).join(", ")}`);
+        const { assistant } = config.ai;
+        let assistantSummary = "off";
+        if (assistant?.enabled) {
+          assistantSummary = assistant.endpoint ? "external endpoint" : assistant.provider.kind;
+        }
+        logger.info(`Assistant: ${assistantSummary}`);
+      }
+    } catch (error) {
+      if (error instanceof BlumeError) {
+        diagnostics.push(error.diagnostic);
+      } else {
+        reportInternalError(error);
+        process.exit(1);
+      }
+    }
+    if (args.json) {
+      if (reportDiagnosticsJson(diagnostics, root)) {
+        await flushStdout();
+        process.exit(1);
+      }
+      return;
+    }
+    const hadErrors = reportDiagnostics(diagnostics, root);
+    if (diagnostics.length === 0) {
+      logger.success("No problems found.");
+    }
+    if (hadErrors) {
+      process.exit(1);
+    }
+  }
+});
+export {
+  doctorCommand
+};
+
+//# debugId=57C3E0688A0BB3FA64756E2164756E21
+//# sourceMappingURL=chunk-6vm74dry.js.map

package/dist/cli/chunk-6vm74dry.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/doctor.ts"],
+  "sourcesContent": [
+    "import { readFileSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\n\nimport { defineCommand } from \"citty\";\nimport { join } from \"pathe\";\nimport { satisfies } from \"semver\";\n\nimport { discoverIslands } from \"../../astro/islands.ts\";\nimport { missingDependencyDiagnostic } from \"../../astro/runtime-deps.ts\";\nimport {\n  analyzeComponentOverrides,\n  ComponentOverridesError,\n} from \"../../core/component-overrides.ts\";\nimport { BlumeError } from \"../../core/diagnostics.ts\";\nimport { packageRoot } from \"../../core/package-root.ts\";\nimport { scanProject } from \"../../core/project-graph.ts\";\nimport { serverFeatures } from \"../../core/server-features.ts\";\nimport type { Diagnostic } from \"../../core/types.ts\";\nimport { unregisteredSnapshotDiagnostics } from \"../../core/version-cut.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { loadEnvFiles } from \"../env.ts\";\nimport { reportInternalError } from \"../internal-error.ts\";\nimport {\n  flushStdout,\n  logger,\n  reportDiagnostics,\n  reportDiagnosticsJson,\n} from \"../log.ts\";\nimport { checkRequiredSecrets } from \"../required-secrets.ts\";\n\nconst FALLBACK_NODE_RANGE = \">=22.12.0\";\n\n/**\n * Plan `components.ts` the way `blume dev`/`build` do, reporting each override\n * that can't be planned — a non-static form, or an import of a file that\n * doesn't exist — with its own line. The scan alone never reads the file, so\n * without this doctor would pass a project whose build fails.\n */\nconst componentsDiagnostics = async (\n  componentsFile: string | null\n): Promise<Diagnostic[]> => {\n  if (!componentsFile) {\n    return [];\n  }\n  try {\n    analyzeComponentOverrides(\n      await readFile(componentsFile, \"utf-8\"),\n      componentsFile\n    );\n    return [];\n  } catch (error) {\n    if (error instanceof ComponentOverridesError) {\n      return error.issues;\n    }\n    throw error;\n  }\n};\n\n/** The supported Node range, read from the package's own `engines` field so\n * doctor can never drift from what the package actually declares. */\nconst supportedNodeRange = (): string => {\n  try {\n    // SAFETY: this parses blume's own package.json; the optional fields cover\n    // an `engines` block going missing, and a bad read falls to the catch.\n    const pkg = JSON.parse(\n      readFileSync(join(packageRoot(), \"package.json\"), \"utf-8\")\n    ) as { engines?: { node?: string } };\n    return pkg.engines?.node || FALLBACK_NODE_RANGE;\n  } catch {\n    return FALLBACK_NODE_RANGE;\n  }\n};\n\nexport const doctorCommand = defineCommand({\n  args: {\n    json: {\n      description: \"Emit diagnostics as JSON on stdout (for CI/editors).\",\n      type: \"boolean\",\n    },\n  },\n  meta: commandMeta.doctor,\n  async run({ args }) {\n    const root = process.cwd();\n    const diagnostics: Diagnostic[] = [];\n\n    const nodeRange = supportedNodeRange();\n    if (!satisfies(process.versions.node, nodeRange)) {\n      diagnostics.push({\n        code: \"BLUME_NODE_VERSION\",\n        message: `Node ${process.versions.node} is outside the supported range (${nodeRange}).`,\n        severity: \"warning\",\n      });\n    }\n\n    // Read `.env` files first, as `blume dev`/`build` do: remote sources read\n    // their tokens during the scan, and the secrets check below reads them too.\n    loadEnvFiles(root);\n\n    try {\n      const project = await scanProject(root, { mode: \"build\" });\n      diagnostics.push(\n        ...project.diagnostics,\n        ...unregisteredSnapshotDiagnostics(project)\n      );\n\n      const { config } = project;\n      // The packages and secrets a build would need: an adapter's missing SDK\n      // fails the build, and a missing secret fails at the first request.\n      const { islands } = await discoverIslands(root);\n      const dependencies = await missingDependencyDiagnostic(\n        config,\n        root,\n        \"error\",\n        islands.map((island) => island.framework)\n      );\n      if (dependencies) {\n        diagnostics.push(dependencies);\n      }\n      diagnostics.push(\n        ...(await componentsDiagnostics(project.context.componentsFile)),\n        ...checkRequiredSecrets(config)\n      );\n      const features = serverFeatures(config);\n      if (\n        features.length > 0 &&\n        config.deployment.options.output === \"static\"\n      ) {\n        // A host adapter already names the target, so only its\n        // `output: \"static\"` stands in the way; otherwise name one.\n        const { kind } = config.deployment;\n        diagnostics.push({\n          code: \"BLUME_SERVER_FEATURE_REQUIRED\",\n          message: `${features.join(\", \")} ${features.length === 1 ? \"requires\" : \"require\"} server output.`,\n          severity: \"error\",\n          suggestion:\n            kind === \"static\"\n              ? 'Set deployment to a host adapter from \"blume/deploy\" (e.g. `deployment: vercel()`).'\n              : `Drop \\`output: \"static\"\\` from \\`deployment: ${kind}()\\` to build for the server.`,\n        });\n      }\n\n      if (!args.json) {\n        logger.info(`Pages: ${project.graph.pages.length}`);\n        logger.info(`Output: ${config.deployment.options.output}`);\n        logger.info(`Adapter: ${config.deployment.kind}`);\n        logger.info(`Search: ${config.search.provider.kind}`);\n        logger.info(\n          `References: ${config.reference.map((adapter) => adapter.kind).join(\", \") || \"none\"}`\n        );\n        logger.info(\n          `Analytics: ${config.analytics.map((adapter) => adapter.kind).join(\", \") || \"none\"}`\n        );\n        logger.info(\n          `Sources: ${config.content.sources.map((source) => source.kind).join(\", \")}`\n        );\n        const { assistant } = config.ai;\n        let assistantSummary = \"off\";\n        if (assistant?.enabled) {\n          assistantSummary = assistant.endpoint\n            ? \"external endpoint\"\n            : assistant.provider.kind;\n        }\n        logger.info(`Assistant: ${assistantSummary}`);\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    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      if (reportDiagnosticsJson(diagnostics, root)) {\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 problems found.\");\n    }\n    if (hadErrors) {\n      process.exit(1);\n    }\n  },\n});\n"
+  ],
+  "mappings": "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",
+  "debugId": "57C3E0688A0BB3FA64756E2164756E21",
+  "names": []
+}

package/dist/cli/{chunk-yg63d42r.js → chunk-79jhk4py.js}

@@ -5,7 +5,9 @@ import {
   BlumeError,
   locateFrontmatterKey,
   logger,
-  flushStdout
+  flushStdout,
+  reportDiagnostics,
+  closestMatch
 } from "./index.js";
 import {
   CHECKS,
@@ -16,31 +18,29 @@ import {
   AGENTS,
   writeAgentReport,
   fixPrompt,
-  launchAgent
-} from "./chunk-0xjyb285.js";
-import {
-  deployStaticDir,
-  examplesRouteBase
-} from "./chunk-ps4m1xh4.js";
+  launchInstalledAgent
+} from "./chunk-qwsrynx5.js";
 import {
   frontmatter_default,
-  scanProject
-} from "./chunk-1jefwnfs.js";
-import {
-  SITE_INFERRING_ADAPTERS
-} from "./chunk-7s8hm3b6.js";
-import {
   gradeExternal,
-  probeAll
-} from "./chunk-vh9w1sgp.js";
-import"./chunk-ct47dqpx.js";
-import"./chunk-0qymqwzz.js";
+  probeAll,
+  deployPlatform
+} from "./chunk-qkqwkpte.js";
 import {
   normalizeBasePath,
   normalizePath,
   withBasePath,
   stripBasePath
-} from "./chunk-2mzebbbz.js";
+} from "./chunk-jts8mvcz.js";
+import {
+  deployStaticDir
+} from "./chunk-82bbrxdn.js";
+import {
+  examplesRouteBase
+} from "./chunk-2hn4b8z7.js";
+import {
+  scanProject
+} from "./chunk-fs23ddbb.js";
 
 // src/cli/commands/audit.ts
 import { defineCommand } from "citty";
@@ -67,7 +67,7 @@ var pageSite = (context, page, key) => {
 
 // src/audit/url.ts
 var serverRoutes = (context) => {
-  const mcp = context.project.config.ai?.mcp;
+  const mcp = context.project.config.agents?.mcp;
   return mcp?.enabled ? [normalizePath(mcp.route)] : [];
 };
 var isServed = (context, path) => context.byUrl.has(path) || context.files.has(path) || context.files.has(`${path}/index.html`) || serverRoutes(context).includes(path);
@@ -114,7 +114,7 @@ var resolveHref = (pageUrl, href, origin, deployBase = "") => {
     }
     return { kind: "external", url: parsed.toString() };
   }
-  const base = pageUrl === "/" ? "https://blume.invalid/" : `https://blume.invalid${pageUrl}/`;
+  const base = `https://blume.invalid${pageUrl}`;
   let resolved;
   try {
     resolved = new URL(target, base);
@@ -138,8 +138,8 @@ var resolveAsset = (context, page, asset, missingId, kind, found) => {
   if (asset.src.startsWith("data:")) {
     return null;
   }
-  const origin = siteOrigin(context.project.config.deployment.site);
-  const resolved = resolveHref(page.url, asset.src, origin, normalizeBasePath(context.project.config.deployment.base));
+  const origin = siteOrigin(context.project.config.deployment.options.site);
+  const resolved = resolveHref(page.url, asset.src, origin, normalizeBasePath(context.project.config.deployment.options.base));
   if (resolved.kind === "external" || resolved.kind === "ignored") {
     return null;
   }
@@ -397,7 +397,7 @@ var dnsAidChecks = {
     if (!context.origin) {
       return [];
     }
-    const host = dnsAidHost(context.project.config.deployment.site);
+    const host = dnsAidHost(context.project.config.deployment.options.site);
     if (!host) {
       return [];
     }
@@ -419,7 +419,7 @@ var isNonCanonical = (page, deployBase) => {
   }
 };
 var comparable = (context) => {
-  const deployBase = normalizeBasePath(context.project.config.deployment.base);
+  const deployBase = normalizeBasePath(context.project.config.deployment.options.base);
   return context.pages.filter((page) => page.indexable && !page.route?.fallback && !isNonCanonical(page, deployBase));
 };
 var reportGroups = (context, pages, id, key, describe, frontmatterKey) => {
@@ -468,7 +468,7 @@ var duplicateChecks = {
 };
 
 // src/audit/checks/i18n.ts
-var deployBaseOf = (context) => normalizeBasePath(context.project.config.deployment.base);
+var deployBaseOf = (context) => normalizeBasePath(context.project.config.deployment.options.base);
 var X_DEFAULT = "x-default";
 var isValidBcp47 = (tag) => {
   try {
@@ -592,7 +592,7 @@ var parseCanonical = (canonical) => {
   }
 };
 var canonicalChecks = (context, page) => {
-  const { site } = context.project.config.deployment;
+  const { site } = context.project.config.deployment.options;
   const origin = siteOrigin(site);
   if (ERROR_ROUTES.has(page.url)) {
     return [];
@@ -616,7 +616,7 @@ var canonicalChecks = (context, page) => {
     }
     return found;
   }
-  const target = normalizePath(stripBasePath(normalizeBasePath(context.project.config.deployment.base), decodePath(canonical.pathname)));
+  const target = normalizePath(stripBasePath(normalizeBasePath(context.project.config.deployment.options.base), decodePath(canonical.pathname)));
   if (target === normalizePath(page.url)) {
     return found;
   }
@@ -640,13 +640,13 @@ var indexabilityChecks = {
   category: "indexability",
   run(context) {
     const found = [];
-    if (!context.project.config.deployment.site) {
-      const { adapter } = context.project.config.deployment;
+    if (!context.project.config.deployment.options.site) {
+      const { deployment } = context.project.config;
       const site = {
         file: context.project.context.configFile ?? undefined,
         url: "/"
       };
-      found.push(adapter && SITE_INFERRING_ADAPTERS.has(adapter) ? finding("BLUME_AUDIT_SITE_INFERRED_AT_DEPLOY", site, `deployment.site is not set in this build — on ${adapter} it is inferred from the platform env at deploy time, so canonical URLs, Open Graph images, and the sitemap are only missing from this local artifact.`) : finding("BLUME_AUDIT_SITE_NOT_SET", site, "deployment.site is not set, so no canonical URLs, Open Graph images, or sitemap can be generated."));
+      found.push(deployPlatform(deployment).env ? finding("BLUME_AUDIT_SITE_INFERRED_AT_DEPLOY", site, `deployment.site is not set in this build — on ${deployment.kind} it is inferred from the platform env at deploy time, so canonical URLs, Open Graph images, and the sitemap are only missing from this local artifact.`) : finding("BLUME_AUDIT_SITE_NOT_SET", site, "deployment.site is not set, so no canonical URLs, Open Graph images, or sitemap can be generated."));
     }
     for (const page of context.pages) {
       found.push(...canonicalChecks(context, page));
@@ -718,8 +718,8 @@ var linkChecks = {
   category: "links",
   run(context) {
     const found = [];
-    const origin = siteOrigin(context.project.config.deployment.site);
-    const deployBase = normalizeBasePath(context.project.config.deployment.base);
+    const origin = siteOrigin(context.project.config.deployment.options.site);
+    const deployBase = normalizeBasePath(context.project.config.deployment.options.base);
     const brokenChrome = new Map;
     const redirectedChrome = new Map;
     const brokenChromeAnchors = new Map;
@@ -802,7 +802,7 @@ var linkChecks = {
 // src/audit/checks/llms.ts
 var isLlmsToggleObject = (value) => typeof value === "object" && value !== null;
 var llmsConfig = (context) => {
-  const value = context.project.config.ai?.llmsTxt;
+  const value = context.project.config.agents?.llmsTxt;
   if (isLlmsToggleObject(value)) {
     return { enabled: value.enabled, openapi: value.openapi };
   }
@@ -843,8 +843,8 @@ var llmsChecks = {
       ];
     }
     const found = [];
-    const origin = siteOrigin(context.project.config.deployment.site);
-    const deployBase = normalizeBasePath(context.project.config.deployment.base);
+    const origin = siteOrigin(context.project.config.deployment.options.site);
+    const deployBase = normalizeBasePath(context.project.config.deployment.options.base);
     const listed = new Set;
     for (const entry of llms.entries) {
       const path = entryPath(entry.url, origin, deployBase);
@@ -916,7 +916,7 @@ var networkChecks = {
       return [];
     }
     const found = [];
-    const deployBase = normalizeBasePath(context.project.config.deployment.base);
+    const deployBase = normalizeBasePath(context.project.config.deployment.options.base);
     const targets = context.pages.map((page) => liveUrl(origin, page, deployBase));
     const robotsUrl = new URL(`${deployBase}/robots.txt`, origin).toString();
     const sitemapUrl = new URL(`${deployBase}/sitemap.xml`, origin).toString();
@@ -948,8 +948,8 @@ var networkChecks = {
 var externalChecks = {
   category: "network",
   async run(context) {
-    const origin = siteOrigin(context.project.config.deployment.site);
-    const deployBase = normalizeBasePath(context.project.config.deployment.base);
+    const origin = siteOrigin(context.project.config.deployment.options.site);
+    const deployBase = normalizeBasePath(context.project.config.deployment.options.base);
     const linkers = new Map;
     for (const page of context.pages) {
       for (const link of page.links) {
@@ -1034,8 +1034,8 @@ var ogImageChecks = {
       sizes.set(path, pending);
       return pending;
     };
-    const origin = siteOrigin(context.project.config.deployment.site);
-    const deployBase = normalizeBasePath(context.project.config.deployment.base);
+    const origin = siteOrigin(context.project.config.deployment.options.site);
+    const deployBase = normalizeBasePath(context.project.config.deployment.options.base);
     const candidates = [];
     for (const page of context.pages) {
       const src = page.og["og:image"];
@@ -1107,7 +1107,7 @@ var robotsChecks = {
   category: "robots",
   run(context) {
     const { robots } = context;
-    const { site } = context.project.config.deployment;
+    const { site } = context.project.config.deployment.options;
     if (!context.project.config.seo.robots) {
       return [];
     }
@@ -1199,7 +1199,7 @@ var sitemapChecks = {
   category: "sitemap",
   run(context) {
     const { sitemap } = context;
-    const { site } = context.project.config.deployment;
+    const { site } = context.project.config.deployment.options;
     if (!(site && context.project.config.seo.sitemap)) {
       return [];
     }
@@ -1225,7 +1225,7 @@ var sitemapChecks = {
       }
     }
     const origin = siteOrigin(site);
-    const deployBase = normalizeBasePath(context.project.config.deployment.base);
+    const deployBase = normalizeBasePath(context.project.config.deployment.options.base);
     const listed = sitemapPaths(context, deployBase);
     for (const loc of sitemap.urls) {
       found.push(...checkListedUrl(context, loc, origin, sitemap.file, deployBase));
@@ -1248,7 +1248,7 @@ var socialChecks = {
   category: "social",
   run(context) {
     const found = [];
-    const hasSite = Boolean(context.project.config.deployment.site);
+    const hasSite = Boolean(context.project.config.deployment.options.site);
     const required = ogRequired(hasSite);
     for (const page of context.pages) {
       if (!page.indexable) {
@@ -1702,6 +1702,22 @@ var resolveRedirects = (redirects, served) => {
   });
 };
 
+// src/audit/terms.ts
+var shortId = (id) => id.replace("BLUME_AUDIT_", "").toLowerCase();
+var checkTerms = () => [
+  ...new Set([
+    ...CHECKS.map((check) => check.category),
+    ...CHECKS.map((check) => shortId(check.id))
+  ])
+];
+var unknownCheckTerms = (terms) => {
+  const known = new Set(checkTerms());
+  return terms.filter((raw) => {
+    const term = raw.trim().toLowerCase();
+    return !(known.has(term) || known.has(term.replace(/^blume_audit_/u, "")));
+  });
+};
+
 // src/audit/run.ts
 var MODULES = [
   contentChecks,
@@ -1747,7 +1763,7 @@ var readSources = async (pages) => {
 };
 var matches = (id, terms) => {
   const meta = CHECKS.find((check) => check.id === id);
-  const short = id.replace("BLUME_AUDIT_", "").toLowerCase();
+  const short = shortId(id);
   return terms.some((raw) => {
     const term = raw.trim().toLowerCase();
     return term === short || term === id.toLowerCase() || term === meta?.category;
@@ -1770,7 +1786,7 @@ var runAudit = async (options) => {
   const context = {
     byUrl,
     files: crawl.files,
-    graph: buildGraph(crawl.pages, siteOrigin(project.config.deployment.site), normalizeBasePath(project.config.deployment.base)),
+    graph: buildGraph(crawl.pages, siteOrigin(project.config.deployment.options.site), normalizeBasePath(project.config.deployment.options.base)),
     llms: crawl.llms,
     origin,
     pages: crawl.pages,
@@ -1812,21 +1828,31 @@ var runAudit = async (options) => {
 var SEVERITIES = ["error", "warning", "info"];
 var failingSeverities = (gate) => new Set(SEVERITIES.slice(0, SEVERITIES.indexOf(gate) + 1));
 var splitTerms = (value) => value ? value.split(",").map((term) => term.trim()).filter(Boolean) : [];
+var rejectUnknownTerms = (terms) => {
+  const unknown = unknownCheckTerms(terms);
+  if (unknown.length === 0) {
+    return;
+  }
+  const known = checkTerms();
+  const listed = unknown.map((term) => {
+    const suggestion = closestMatch(term.trim().toLowerCase(), known);
+    return suggestion ? `"${term}" (did you mean "${suggestion}"?)` : `"${term}"`;
+  }).join(", ");
+  logger.error(`--only/--skip name no check or category: ${listed}. Run \`blume audit --list-checks\` for every check id and category.`);
+  process.exit(1);
+};
 var shouldFail = (result, gate) => {
   const failing = failingSeverities(gate);
   return result.diagnostics.some((d) => failing.has(d.severity));
 };
 var launchAgentCode = async (agent, prompt) => {
   const cli = AGENTS[agent];
-  try {
-    return await launchAgent(cli.bin, prompt);
-  } catch (error) {
-    if (error?.code !== "ENOENT") {
-      throw error;
-    }
+  const code = await launchInstalledAgent(cli.bin, prompt);
+  if (code === null) {
     logger.error(`${cli.name} (\`${cli.bin}\`) was not found on PATH. Install it with \`${cli.install}\`.`);
     return process.exit(1);
   }
+  return code;
 };
 var auditCommand = defineCommand({
   args: {
@@ -1890,7 +1916,7 @@ var auditCommand = defineCommand({
     }
     const agents = Object.keys(AGENTS).filter((kind) => args[kind]);
     if (agents.length > 1) {
-      logger.error("Pass at most one of --claude or --codex.");
+      logger.error("Pass at most one of --codex or --claude.");
       process.exit(1);
     }
     const [agent] = agents;
@@ -1898,15 +1924,18 @@ var auditCommand = defineCommand({
       logger.error(`--json and --${agent} are mutually exclusive.`);
       process.exit(1);
     }
+    const only = splitTerms(args.only);
+    const skip = splitTerms(args.skip);
+    rejectUnknownTerms([...only, ...skip]);
     let result;
     try {
       const project = await scanProject(root, { mode: "build" });
       result = await runAudit({
         external: args.external,
-        only: splitTerms(args.only),
+        only,
         origin: args.url,
         project,
-        skip: splitTerms(args.skip)
+        skip
       });
     } catch (error) {
       if (error instanceof NoBuildError) {
@@ -1914,7 +1943,7 @@ var auditCommand = defineCommand({
         process.exit(1);
       }
       if (error instanceof BlumeError) {
-        logger.error(error.diagnostic.message);
+        reportDiagnostics([error.diagnostic], root);
         process.exit(1);
       }
       reportInternalError(error);
@@ -1956,5 +1985,5 @@ export {
   shouldFail
 };
 
-//# debugId=59B0974018DD3C3464756E2164756E21
-//# sourceMappingURL=chunk-yg63d42r.js.map
+//# debugId=5DFBDEAD3AD54A7664756E2164756E21
+//# sourceMappingURL=chunk-79jhk4py.js.map