blume 1.6.5 → 1.6.6

package/dist/cli/chunk-0ewz4trd.js.map

@@ -0,0 +1,15 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/eval.ts", "../src/eval/prompts.ts", "../src/eval/report.ts", "../src/eval/run.ts", "../src/eval/schema.ts", "../src/eval/findings.ts"],
+  "sourcesContent": [
+    "import { existsSync } from \"node:fs\";\n\nimport { defineCommand } from \"citty\";\nimport { join } from \"pathe\";\n\nimport { AGENTS, launchAgent } from \"../../audit/agent.ts\";\nimport type { AgentKind } from \"../../audit/agent.ts\";\nimport { BlumeError } from \"../../core/diagnostics.ts\";\nimport { scanProject } from \"../../core/project-graph.ts\";\nimport { evalFixPrompt, initPrompt } from \"../../eval/prompts.ts\";\nimport {\n  evalReportJson,\n  fixLines,\n  headerLine,\n  questionDetails,\n  questionLine,\n  startLine,\n  summaryLine,\n  warningLines,\n  writeEvalReport,\n} from \"../../eval/report.ts\";\nimport { runEval } from \"../../eval/run.ts\";\nimport type { EvalResult } from \"../../eval/run.ts\";\nimport { EvalsFileError, loadEvalsFile } from \"../../eval/schema.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { reportInternalError } from \"../internal-error.ts\";\nimport { flushStdout, logger } from \"../log.ts\";\n\nconst DEFAULT_FILE = \"evals.yaml\";\n\n/** Reader wall-clock ceiling per question, in seconds. */\nconst DEFAULT_TIMEOUT_S = 180;\n\nconst isAgentKind = (value: string): value is AgentKind => value in AGENTS;\n\n/**\n * Launch the interactive agent CLI, turning a missing executable into the\n * install hint. Only `ENOENT` means \"not installed\" — any other spawn failure\n * (`EACCES`, `EMFILE`, …) must surface as itself.\n */\nconst notInstalled = (agent: AgentKind): never => {\n  const cli = AGENTS[agent];\n  logger.error(\n    `${cli.name} (\\`${cli.bin}\\`) was not found on PATH. Install it with \\`${cli.install}\\`.`\n  );\n  return process.exit(1);\n};\n\nconst launchAgentCode = async (\n  agent: AgentKind,\n  prompt: string\n): Promise<number> => {\n  try {\n    return await launchAgent(AGENTS[agent].bin, prompt);\n  } catch (error) {\n    // SAFETY: only the `code` tag is inspected; a spawn failure throws an\n    // ErrnoException, and any other thrown value fails the comparison and\n    // rethrows unchanged.\n    if ((error as NodeJS.ErrnoException)?.code !== \"ENOENT\") {\n      throw error;\n    }\n    return notInstalled(agent);\n  }\n};\n\n/** The fraction of run (non-skipped) questions that passed. */\nexport const passFraction = (result: EvalResult): number => {\n  const ran = result.results.length - result.counts.skip;\n  return ran === 0 ? 1 : result.counts.pass / ran;\n};\n\ninterface EvalFlags {\n  action?: string;\n  agent: string;\n  file: string;\n  fix?: boolean;\n  json?: boolean;\n  threshold?: string;\n  timeout?: string;\n}\n\n/** Validate the flag surface, exiting with a message on the first offense. */\nconst parseFlags = (args: EvalFlags) => {\n  if (!isAgentKind(args.agent)) {\n    logger.error(`Invalid --agent \"${args.agent}\" (use claude | codex).`);\n    process.exit(1);\n  }\n  if (args.action !== undefined && args.action !== \"init\") {\n    logger.error(`Unknown action \"${args.action}\" (did you mean \"init\"?).`);\n    process.exit(1);\n  }\n  if (args.json && args.fix) {\n    logger.error(\"--json and --fix are mutually exclusive.\");\n    process.exit(1);\n  }\n  const threshold = args.threshold === undefined ? 1 : Number(args.threshold);\n  if (!Number.isFinite(threshold) || threshold < 0 || threshold > 1) {\n    logger.error(`Invalid --threshold \"${args.threshold}\" (use 0..1).`);\n    process.exit(1);\n  }\n  const timeoutS =\n    args.timeout === undefined ? DEFAULT_TIMEOUT_S : Number(args.timeout);\n  if (!Number.isInteger(timeoutS) || timeoutS <= 0) {\n    logger.error(`Invalid --timeout \"${args.timeout}\" (whole seconds).`);\n    process.exit(1);\n  }\n  return { agent: args.agent, threshold, timeoutS };\n};\n\n/** `blume eval --fix`: hand the failing report to the interactive agent. */\nconst runFixHandoff = async (\n  agent: AgentKind,\n  result: EvalResult,\n  root: string,\n  threshold: number\n): Promise<void> => {\n  const count = result.counts.fail + result.counts.error;\n  if (count === 0) {\n    return;\n  }\n  const cli = AGENTS[agent];\n  const report = await writeEvalReport(result, root, threshold);\n  process.stderr.write(\n    `  Handing ${count} failed question${count === 1 ? \"\" : \"s\"} to ${cli.name}…\\n\\n`\n  );\n  const code = await launchAgentCode(agent, evalFixPrompt(report));\n  if (code !== 0) {\n    process.exit(code);\n  }\n};\n\n/** `blume eval init`: draft a starter evals file via the interactive agent. */\nconst runInit = async (agent: AgentKind, file: string): Promise<void> => {\n  const path = join(process.cwd(), file);\n  if (existsSync(path)) {\n    logger.error(\n      `${file} already exists — edit it directly, or pass --file to draft elsewhere.`\n    );\n    process.exit(1);\n  }\n  const code = await launchAgentCode(agent, initPrompt(file));\n  if (code !== 0) {\n    process.exit(code);\n  }\n};\n\nexport const evalCommand = defineCommand({\n  args: {\n    action: {\n      description: 'Optional action: \"init\" drafts a starter evals file.',\n      required: false,\n      type: \"positional\",\n    },\n    agent: {\n      default: \"claude\",\n      description: \"Agent CLI that reads and grades the docs: claude | codex.\",\n      type: \"string\",\n    },\n    file: {\n      default: DEFAULT_FILE,\n      description: \"The evals file to run.\",\n      type: \"string\",\n    },\n    fix: {\n      description:\n        \"After a failing run, hand the report to the agent to fix the docs interactively.\",\n      type: \"boolean\",\n    },\n    json: {\n      description: \"Emit the report as JSON on stdout (for CI/editors).\",\n      type: \"boolean\",\n    },\n    threshold: {\n      description:\n        \"Minimum passing fraction (0..1) before the run exits non-zero. Defaults to 1.\",\n      type: \"string\",\n    },\n    timeout: {\n      description: `Reader time limit per question, in seconds. Defaults to ${DEFAULT_TIMEOUT_S}.`,\n      type: \"string\",\n    },\n    verbose: {\n      description: \"Include the reader's full answer under each failure.\",\n      type: \"boolean\",\n    },\n  },\n  meta: commandMeta.eval,\n  async run({ args }) {\n    const root = process.cwd();\n    const { agent, threshold, timeoutS } = parseFlags(args);\n    if (args.action === \"init\") {\n      await runInit(agent, args.file);\n      return;\n    }\n\n    let result: EvalResult;\n    try {\n      // `scanProject`, not `prepareProject`: the eval reads the content tree\n      // and never regenerates the runtime, so it doesn't contend with a\n      // running dev server. Same reasoning as `blume audit`.\n      const project = await scanProject(root, { mode: \"build\" });\n      const evalsPath = join(root, args.file);\n      const { evals, raw } = await loadEvalsFile(evalsPath);\n\n      process.stderr.write(`${headerLine(evals.questions.length, agent)}\\n\\n`);\n      result = await runEval({\n        agent,\n        evals,\n        evalsPath,\n        onProgress: (event) => {\n          // Straight to stderr, not `logger.info` — consola drops info-level\n          // lines in test and CI environments.\n          if (event.kind === \"question-start\") {\n            process.stderr.write(\n              `${startLine(event.id, event.index, event.total)}\\n`\n            );\n            return;\n          }\n          const lines = [\n            questionLine(event.result),\n            ...questionDetails(event.result, Boolean(args.verbose)),\n          ];\n          process.stderr.write(`${lines.join(\"\\n\")}\\n`);\n        },\n        project,\n        rawEvals: raw,\n        readerTimeoutMs: timeoutS * 1000,\n      });\n    } catch (error) {\n      if (error instanceof EvalsFileError) {\n        logger.error(error.message);\n        process.exit(1);\n      }\n      if (error instanceof BlumeError) {\n        logger.error(error.diagnostic.message);\n        process.exit(1);\n      }\n      // SAFETY: only the `code` tag is inspected; a spawn failure throws an\n      // ErrnoException, and any other thrown value fails the comparison and\n      // falls through to the internal-error report.\n      if ((error as NodeJS.ErrnoException)?.code === \"ENOENT\") {\n        notInstalled(agent);\n      }\n      reportInternalError(error);\n      process.exit(1);\n    }\n\n    const tail = [\n      \"\",\n      ...warningLines(result, root),\n      ...fixLines(result, root),\n      \"\",\n      `  ${summaryLine(result)}`,\n      \"\",\n    ];\n    process.stderr.write(tail.join(\"\\n\"));\n\n    const failed = passFraction(result) < threshold;\n\n    if (args.fix) {\n      // The gate is a CI concern; a handoff run succeeds when the agent\n      // session does, not when the docs already passed.\n      await runFixHandoff(agent, result, root, threshold);\n      return;\n    }\n\n    if (args.json) {\n      process.stdout.write(evalReportJson(result, root, threshold));\n      if (failed) {\n        // `process.exit` doesn't flush a piped stdout — without this the JSON\n        // is truncated mid-write in exactly the CI setups that consume it.\n        await flushStdout();\n        process.exit(1);\n      }\n      return;\n    }\n\n    if (failed) {\n      process.exit(1);\n    }\n  },\n});\n",
+    "import type { EvalQuestion } from \"./schema.ts\";\n\n/**\n * The reader's instructions. The agent is spawned in an empty directory with\n * its file/shell/web tools disabled, so the prompt's job is to direct it at\n * the MCP docs tools and forbid the one escape hatch that remains: answering\n * from prior knowledge of the product.\n */\nexport const readerPrompt = (question: EvalQuestion): string =>\n  `You are evaluating whether a product's documentation can answer a user's question.\n\nAnswer the question below using ONLY the connected documentation tools (search_docs, get_page, list_pages, get_navigation). Rules:\n- Do not use prior knowledge about the product. Do not guess.\n- Do not read files, run commands, or access the network.\n- Search first, then read the most relevant pages with get_page.\n- If the documentation does not contain the answer, say exactly what information is missing instead of inventing one.\n\nQuestion: ${question.question}\n\nReply with a concise answer containing the specific facts the documentation provides. Plain text only.`;\n\n/** The judge's instructions: grade the answer against the expected facts. */\nexport const judgePrompt = (question: EvalQuestion, answer: string): string => {\n  const facts = question.expected.map((fact) => `- ${fact}`).join(\"\\n\");\n  return `You are grading an answer against expected facts. Do not use any tools.\n\nQuestion: ${question.question}\n\nExpected facts — each must be present in substance (paraphrase is fine, contradiction is not):\n${facts}\n\nAnswer to grade:\n\"\"\"\n${answer}\n\"\"\"\n\nAn answer that states the documentation lacks the information FAILS.\n\nReply with ONLY this JSON object on a single line, no markdown fences:\n{\"pass\": true|false, \"score\": 0.0-1.0, \"missing\": [\"expected facts absent or contradicted\"], \"notes\": \"one sentence\"}`;\n};\n\n/** The `--fix` handoff prompt: where the report is and the ground rules. */\nexport const evalFixPrompt = (reportPath: string): string =>\n  `Fix the documentation gaps found by \\`blume eval\\` in this project.\n\nThe full report is at ${reportPath}. It is JSON: each entry in \\`eval.results\\` with status \"fail\" is one question the documentation could not answer. Each carries the \\`question\\`, the \\`expected\\` facts, the judge's \\`missing\\` facts, and the reader agent's \\`answer\\` (what the docs currently convey). The matching \\`diagnostics\\` entry names the source \\`file\\` of the page that should answer it.\n\nWork through every failed question:\n1. Read the page named in the finding (or choose the best page when none is named).\n2. Edit the documentation so it states the missing facts explicitly. Add prose, not filler; keep the page's voice.\n3. Never delete questions from the evals file or weaken expected facts.\n\nWhen you are done, run \\`blume eval\\` to verify, and repeat until every question passes.`;\n\n/** The `eval init` prompt: draft a starter evals file from the docs. */\nexport const initPrompt = (evalsPath: string): string =>\n  `Draft a starter evals file for \\`blume eval\\` in this documentation project.\n\nRead the documentation source pages in this project and write ${evalsPath} with about 10 high-value questions a real user would ask — installation, configuration, deployment, and the project's headline features. For each question, list the expected facts a correct answer must state, grounded in what the documentation actually promises (never invent facts the docs don't state).\n\nThe file format is YAML:\n\nquestions:\n  - id: kebab-case-slug\n    question: One user question?\n    expected:\n      - a fact the answer must contain\n      - another required fact\n    routes:\n      - /route/of/the/page/that/answers/it\n\nRules:\n- Every \\`expected\\` fact must be verifiable in the docs today.\n- Prefer questions whose answers live on one page; set \\`routes\\` to that page.\n- Keep ids unique and questions short.\n\nWhen you are done, print the file and suggest running \\`blume eval\\` to try it.`;\n",
+    "import { mkdtemp, writeFile } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\n\nimport { colors } from \"consola/utils\";\nimport type { ColorFunction } from \"consola/utils\";\nimport { join, relative } from \"pathe\";\n\nimport { AGENTS } from \"../audit/agent.ts\";\nimport { duration, money, seconds } from \"../cli/report-format.ts\";\nimport { countBySeverity } from \"../core/diagnostics.ts\";\nimport type { EvalResult, QuestionResult, QuestionStatus } from \"./run.ts\";\n\nconst GLYPH = {\n  error: \"!\",\n  fail: \"✖\",\n  pass: \"✔\",\n  skip: \"⊘\",\n} satisfies Record<QuestionStatus, string>;\n\nconst STATUS_COLOR = {\n  error: colors.yellow,\n  fail: colors.red,\n  pass: colors.green,\n  skip: colors.dim,\n} satisfies Record<QuestionStatus, ColorFunction>;\n\n/** Longest id gets the room; everything shorter aligns to it. */\nconst ID_PAD = 28;\n\n/** One question's progress/report line: glyph, id, status, score, time, cost. */\nexport const questionLine = (result: QuestionResult): string => {\n  const color = STATUS_COLOR[result.status];\n  const glyph = color(GLYPH[result.status]);\n  const id = result.id.padEnd(ID_PAD);\n  if (result.status === \"skip\") {\n    return `  ${glyph} ${id} ${colors.dim(\"skipped\")}`;\n  }\n  const score = result.score === undefined ? \"\" : result.score.toFixed(2);\n  const cost = money(result.costUsd);\n  const cells = [\n    color(result.status),\n    score,\n    colors.dim(seconds(result.durationMs)),\n    cost === \"\" ? \"\" : colors.dim(cost),\n  ]\n    .filter((cell) => cell !== \"\")\n    .join(\"  \");\n  return `  ${glyph} ${id} ${cells}`;\n};\n\n/** Indented context under a question's line: missing facts, error detail. */\nexport const questionDetails = (\n  result: QuestionResult,\n  verbose: boolean\n): string[] => {\n  const lines: string[] = [];\n  if (result.status === \"fail\") {\n    for (const fact of result.missing) {\n      lines.push(`      ${colors.dim(`missing: ${fact}`)}`);\n    }\n  }\n  if (result.status === \"error\" && result.detail) {\n    lines.push(`      ${colors.dim(result.detail)}`);\n  }\n  if (verbose && result.answer && result.status !== \"pass\") {\n    lines.push(\n      ...result.answer\n        .split(\"\\n\")\n        .map((line) => `      ${colors.dim(`> ${line}`)}`)\n    );\n  }\n  return lines;\n};\n\n/** The one-line totals: `9 passed · 2 failed · 1 skipped · 1m 42s · $0.71`. */\nexport const summaryLine = (result: EvalResult): string => {\n  const { counts } = result;\n  const parts = [\n    `${counts.pass} passed`,\n    counts.fail > 0 ? `${counts.fail} failed` : \"\",\n    counts.error > 0 ? `${counts.error} errored` : \"\",\n    counts.skip > 0 ? `${counts.skip} skipped` : \"\",\n    duration(result.durationMs),\n    money(result.costUsd),\n  ].filter((part) => part !== \"\");\n  return parts.join(\" · \");\n};\n\n/** The header line the command prints before the first question runs. */\nexport const headerLine = (total: number, agent: EvalResult[\"agent\"]): string =>\n  `${colors.bold(\"blume eval\")}  ${total} question(s) · ${AGENTS[agent].name}`;\n\n/** The dim announce line while a question's agents run. */\nexport const startLine = (id: string, index: number, total: number): string =>\n  `  ${colors.dim(`▸ ${id} (${index + 1}/${total})`)}`;\n\n/** `fix:` pointers for failed questions, naming the file that resolves each. */\nexport const fixLines = (result: EvalResult, root: string): string[] =>\n  result.diagnostics\n    .filter((diagnostic) => diagnostic.code !== \"BLUME_EVAL_ROUTE_UNKNOWN\")\n    .map((finding) => {\n      const site = finding.file\n        ? `${relative(root, finding.file)}${finding.line ? `:${finding.line}` : \"\"}`\n        : \"\";\n      return `  ${colors.cyan(\"fix:\")} ${site} ${colors.dim(finding.message)}`;\n    });\n\n/** Dim warnings for route hints that no longer match a page. */\nexport const warningLines = (result: EvalResult, root: string): string[] =>\n  result.diagnostics\n    .filter((diagnostic) => diagnostic.code === \"BLUME_EVAL_ROUTE_UNKNOWN\")\n    .map((finding) => {\n      const site = finding.file\n        ? ` ${relative(root, finding.file)}${finding.line ? `:${finding.line}` : \"\"}`\n        : \"\";\n      return `  ${colors.yellow(\"⚠\")}${site} ${colors.dim(finding.message)}`;\n    });\n\n/** The human report, written to stderr by the command. */\nexport const formatEvalReport = (\n  result: EvalResult,\n  root: string,\n  options: { verbose?: boolean } = {}\n): string => {\n  const lines: string[] = [headerLine(result.results.length, result.agent), \"\"];\n\n  for (const question of result.results) {\n    lines.push(\n      questionLine(question),\n      ...questionDetails(question, Boolean(options.verbose))\n    );\n  }\n  lines.push(\"\");\n\n  // The finding tells the author which file fixes which failure.\n  const failures = fixLines(result, root);\n  lines.push(...failures);\n  if (failures.length > 0) {\n    lines.push(\"\");\n  }\n\n  lines.push(`  ${summaryLine(result)}`, \"\");\n  return lines.join(\"\\n\");\n};\n\n/**\n * The machine-readable report. The `diagnostics` + `summary` shape matches\n * `blume validate --json` and `blume audit --json` exactly — anything parsing\n * those keeps working — with the eval run's own results alongside.\n */\nexport const evalReportJson = (\n  result: EvalResult,\n  root: string,\n  threshold: number\n): string => {\n  const diagnostics = result.diagnostics.map((diagnostic) =>\n    diagnostic.file\n      ? { ...diagnostic, file: relative(root, diagnostic.file) }\n      : diagnostic\n  );\n  return `${JSON.stringify(\n    {\n      diagnostics,\n      eval: {\n        agent: result.agent,\n        costUsd: result.costUsd,\n        counts: result.counts,\n        durationMs: result.durationMs,\n        results: result.results,\n        threshold,\n      },\n      summary: countBySeverity(result.diagnostics),\n    },\n    null,\n    2\n  )}\\n`;\n};\n\n/**\n * Write the full JSON report where a `--fix` agent can read it — a file\n * rather than inline prompt text, because a long run's answers would exceed\n * the platform's argv limit.\n */\nexport const writeEvalReport = async (\n  result: EvalResult,\n  root: string,\n  threshold: number\n): Promise<string> => {\n  const dir = await mkdtemp(join(tmpdir(), \"blume-eval-\"));\n  const path = join(dir, \"report.json\");\n  await writeFile(path, evalReportJson(result, root, threshold));\n  return path;\n};\n",
+    "import { mkdir, mkdtemp, writeFile } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\n\nimport { join } from \"pathe\";\n\nimport { buildMcpData } from \"../ai/mcp/data.ts\";\nimport { AGENTS } from \"../audit/agent.ts\";\nimport type { AgentKind } from \"../audit/agent.ts\";\nimport type { BlumeProject } from \"../core/project-graph.ts\";\nimport type { Diagnostic } from \"../core/types.ts\";\nimport {\n  agentArgs,\n  parseVerdict,\n  readAgentOutput,\n  runAgentHeadless,\n  writeMcpConfig,\n} from \"./agents.ts\";\nimport type { HeadlessRunner } from \"./agents.ts\";\nimport { questionFinding, routeFindings } from \"./findings.ts\";\nimport { judgePrompt, readerPrompt } from \"./prompts.ts\";\nimport type { EvalQuestion, EvalsFile } from \"./schema.ts\";\n\n/** Reader runs search and read several pages; the judge grades one answer. */\nconst DEFAULT_READER_TIMEOUT_MS = 180_000;\nconst DEFAULT_JUDGE_TIMEOUT_MS = 60_000;\n\nexport type QuestionStatus = \"error\" | \"fail\" | \"pass\" | \"skip\";\n\n/** One question's outcome, carrying everything the reports print. */\nexport interface QuestionResult {\n  answer?: string;\n  costUsd?: number;\n  /** Why the run errored (timeout, agent failure, unparseable verdict). */\n  detail?: string;\n  durationMs: number;\n  expected: string[];\n  id: string;\n  missing: string[];\n  notes?: string;\n  question: string;\n  routes: string[];\n  score?: number;\n  status: QuestionStatus;\n}\n\nexport interface EvalResult {\n  agent: AgentKind;\n  /** Total spend, when the agent CLI reports it (claude does, codex doesn't). */\n  costUsd?: number;\n  counts: Record<QuestionStatus, number>;\n  diagnostics: Diagnostic[];\n  durationMs: number;\n  results: QuestionResult[];\n}\n\nexport type EvalProgress =\n  | {\n      kind: \"question-end\";\n      index: number;\n      result: QuestionResult;\n      total: number;\n    }\n  | { kind: \"question-start\"; id: string; index: number; total: number };\n\nexport interface EvalRunOptions {\n  agent: AgentKind;\n  evals: EvalsFile;\n  /** Where the evals file lives, for findings with no usable route hint. */\n  evalsPath: string;\n  judgeTimeoutMs?: number;\n  onProgress?: (event: EvalProgress) => void;\n  project: BlumeProject;\n  /** The evals file's raw text, for line-anchoring findings. */\n  rawEvals: string;\n  readerTimeoutMs?: number;\n  /** The spawn function — injectable so tests never launch a real agent. */\n  run?: HeadlessRunner;\n}\n\ninterface QuestionContext {\n  bin: string;\n  dir: string;\n  judgeTimeoutMs: number;\n  kind: AgentKind;\n  mcp: Awaited<ReturnType<typeof writeMcpConfig>>;\n  readerTimeoutMs: number;\n  run: HeadlessRunner;\n}\n\nconst errored = (\n  question: EvalQuestion,\n  detail: string,\n  durationMs: number\n): QuestionResult => ({\n  detail,\n  durationMs,\n  expected: question.expected,\n  id: question.id,\n  missing: [],\n  question: question.question,\n  routes: question.routes,\n  status: \"error\",\n});\n\n/** Run one question: a fresh empty cwd, the reader, then the judge. */\nconst runQuestion = async (\n  question: EvalQuestion,\n  index: number,\n  context: QuestionContext\n): Promise<QuestionResult> => {\n  const started = performance.now();\n  const elapsed = () => Math.round(performance.now() - started);\n\n  // An empty working directory per invocation is the fresh-eyes guardrail:\n  // even if a tool restriction slips, there is nothing here to read.\n  const workDir = join(context.dir, `work-${index}`);\n  await mkdir(workDir, { recursive: true });\n\n  const answerPath = join(workDir, \"answer.txt\");\n  const reader = await context.run(\n    context.bin,\n    agentArgs(context.kind, { lastMessagePath: answerPath, mcp: context.mcp }),\n    {\n      cwd: workDir,\n      prompt: readerPrompt(question),\n      timeoutMs: context.readerTimeoutMs,\n    }\n  );\n  const answer = await readAgentOutput(context.kind, reader, answerPath);\n  if (answer.isError) {\n    return {\n      ...errored(question, `reader ${answer.detail ?? \"failed\"}`, elapsed()),\n      costUsd: answer.costUsd,\n    };\n  }\n\n  const verdictPath = join(workDir, \"verdict.txt\");\n  const judge = await context.run(\n    context.bin,\n    agentArgs(context.kind, { lastMessagePath: verdictPath }),\n    {\n      cwd: workDir,\n      prompt: judgePrompt(question, answer.text),\n      timeoutMs: context.judgeTimeoutMs,\n    }\n  );\n  const graded = await readAgentOutput(context.kind, judge, verdictPath);\n  const costUsd =\n    answer.costUsd === undefined && graded.costUsd === undefined\n      ? undefined\n      : (answer.costUsd ?? 0) + (graded.costUsd ?? 0);\n  if (graded.isError) {\n    return {\n      ...errored(question, `judge ${graded.detail ?? \"failed\"}`, elapsed()),\n      answer: answer.text,\n      costUsd,\n    };\n  }\n\n  const verdict = parseVerdict(graded.text);\n  if (!verdict) {\n    return {\n      ...errored(question, \"judge returned no parseable verdict\", elapsed()),\n      answer: answer.text,\n      costUsd,\n    };\n  }\n\n  return {\n    answer: answer.text,\n    costUsd,\n    durationMs: elapsed(),\n    expected: question.expected,\n    id: question.id,\n    missing: verdict.missing,\n    notes: verdict.notes || undefined,\n    question: question.question,\n    routes: question.routes,\n    score: verdict.score,\n    status: verdict.pass ? \"pass\" : \"fail\",\n  };\n};\n\n/**\n * Run every question through the reader/judge pair, sequentially: each\n * question is already two agent sessions, and a serial run keeps progress\n * output ordered and cost attribution obvious.\n */\nexport const runEval = async (options: EvalRunOptions): Promise<EvalResult> => {\n  const started = performance.now();\n  const kind = options.agent;\n  const run = options.run ?? runAgentHeadless;\n  const anchor = { path: options.evalsPath, raw: options.rawEvals };\n\n  const dir = await mkdtemp(join(tmpdir(), \"blume-eval-\"));\n  const snapshotPath = join(dir, \"mcp-data.json\");\n  await writeFile(\n    snapshotPath,\n    JSON.stringify(await buildMcpData(options.project))\n  );\n  const mcp = await writeMcpConfig(dir, snapshotPath);\n\n  const context: QuestionContext = {\n    bin: AGENTS[kind].bin,\n    dir,\n    judgeTimeoutMs: options.judgeTimeoutMs ?? DEFAULT_JUDGE_TIMEOUT_MS,\n    kind,\n    mcp,\n    readerTimeoutMs: options.readerTimeoutMs ?? DEFAULT_READER_TIMEOUT_MS,\n    run,\n  };\n\n  const diagnostics: Diagnostic[] = [];\n  const results: QuestionResult[] = [];\n  const { questions } = options.evals;\n\n  for (const [index, question] of questions.entries()) {\n    diagnostics.push(...routeFindings(question, options.project, anchor));\n\n    if (question.skip) {\n      results.push({\n        durationMs: 0,\n        expected: question.expected,\n        id: question.id,\n        missing: [],\n        question: question.question,\n        routes: question.routes,\n        status: \"skip\",\n      });\n      continue;\n    }\n\n    options.onProgress?.({\n      id: question.id,\n      index,\n      kind: \"question-start\",\n      total: questions.length,\n    });\n    // Sequential by design: each question is already two agent sessions, and\n    // a serial run keeps progress output ordered and cost attribution obvious.\n    // oxlint-disable-next-line no-await-in-loop\n    const result = await runQuestion(question, index, context);\n    results.push(result);\n    if (result.status === \"fail\" || result.status === \"error\") {\n      diagnostics.push(\n        questionFinding(\n          question,\n          {\n            detail: result.detail,\n            missing: result.missing,\n            status: result.status,\n          },\n          options.project,\n          anchor\n        )\n      );\n    }\n    options.onProgress?.({\n      index,\n      kind: \"question-end\",\n      result,\n      total: questions.length,\n    });\n  }\n\n  const counts = {\n    error: 0,\n    fail: 0,\n    pass: 0,\n    skip: 0,\n  } satisfies Record<QuestionStatus, number>;\n  for (const result of results) {\n    counts[result.status] += 1;\n  }\n  const costs = results.flatMap((result) =>\n    result.costUsd === undefined ? [] : [result.costUsd]\n  );\n\n  return {\n    agent: kind,\n    costUsd:\n      costs.length > 0\n        ? costs.reduce((total, cost) => total + cost, 0)\n        : undefined,\n    counts,\n    diagnostics,\n    durationMs: Math.round(performance.now() - started),\n    results,\n  };\n};\n",
+    "import { readFile } from \"node:fs/promises\";\n\nimport { load } from \"js-yaml\";\nimport { z } from \"zod\";\n\nimport { YAML_SCHEMA } from \"../core/yaml.ts\";\n\n/** Question ids are kebab-case slugs so they read well in reports and CI logs. */\nconst ID_PATTERN = /^[a-z0-9][a-z0-9-]*$/u;\n\nconst questionSchema = z.strictObject({\n  expected: z\n    .array(z.string().min(1))\n    .min(1, \"expected must list at least one fact\"),\n  id: z\n    .string()\n    .regex(ID_PATTERN, \"id must be a kebab-case slug (a-z, 0-9, dashes)\"),\n  question: z.string().min(1),\n  routes: z\n    .union([z.string(), z.array(z.string())])\n    .default([])\n    .transform((value) => (Array.isArray(value) ? value : [value])),\n  severity: z.enum([\"error\", \"warning\"]).default(\"error\"),\n  skip: z.boolean().default(false),\n});\n\n/** One author-written eval: a question plus the facts a passing answer states. */\nexport type EvalQuestion = z.infer<typeof questionSchema>;\n\nconst fullSchema = z.strictObject({\n  questions: z.array(questionSchema).min(1),\n  version: z.literal(1).default(1),\n});\n\n/**\n * The evals file schema. A bare top-level list of questions is accepted as\n * shorthand — `loadEvalsFile` wraps it before validating, rather than a\n * `z.union`, so schema errors name the offending field instead of collapsing\n * into an opaque \"invalid union\" issue.\n */\nexport const evalsFileSchema = fullSchema.superRefine((value, context) => {\n  const seen = new Set<string>();\n  for (const question of value.questions) {\n    if (seen.has(question.id)) {\n      context.addIssue({\n        code: z.ZodIssueCode.custom,\n        message: `duplicate question id \"${question.id}\"`,\n        path: [\"questions\"],\n      });\n    }\n    seen.add(question.id);\n  }\n});\n\nexport type EvalsFile = z.infer<typeof evalsFileSchema>;\n\n/** A problem loading or validating the evals file, with the path it names. */\nexport class EvalsFileError extends Error {\n  readonly path: string;\n\n  constructor(path: string, message: string) {\n    super(message);\n    this.name = \"EvalsFileError\";\n    this.path = path;\n  }\n}\n\nconst describeIssues = (error: z.ZodError): string =>\n  error.issues\n    .map((issue) => {\n      const at = issue.path.length > 0 ? ` at ${issue.path.join(\".\")}` : \"\";\n      return `${issue.message}${at}`;\n    })\n    .join(\"; \");\n\n/**\n * Read and validate an evals file. Returns the parsed questions plus the raw\n * text, kept so findings can anchor to the line a question is defined on.\n */\nexport const loadEvalsFile = async (\n  path: string\n): Promise<{ evals: EvalsFile; raw: string }> => {\n  let raw: string;\n  try {\n    raw = await readFile(path, \"utf-8\");\n  } catch {\n    throw new EvalsFileError(\n      path,\n      `No evals file found at ${path}. Run \\`blume eval init\\` to draft one.`\n    );\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = load(raw, { schema: YAML_SCHEMA });\n  } catch (error) {\n    const detail = error instanceof Error ? error.message : String(error);\n    throw new EvalsFileError(path, `Invalid YAML in ${path}: ${detail}`);\n  }\n\n  // The bare-list shorthand: a top-level sequence of questions.\n  const candidate = Array.isArray(parsed) ? { questions: parsed } : parsed;\n  const result = evalsFileSchema.safeParse(candidate);\n  if (!result.success) {\n    throw new EvalsFileError(\n      path,\n      `Invalid evals file at ${path}: ${describeIssues(result.error)}`\n    );\n  }\n  return { evals: result.data, raw };\n};\n\n/**\n * The 1-based line where a question's `id:` entry appears in the raw evals\n * file, so a finding with no route hint can still point somewhere editable.\n */\nexport const locateQuestion = (raw: string, id: string): number | undefined => {\n  const pattern = new RegExp(`^\\\\s*-?\\\\s*id:\\\\s*[\"']?${id}[\"']?\\\\s*$`, \"u\");\n  const lines = raw.split(\"\\n\");\n  for (const [index, line] of lines.entries()) {\n    if (pattern.test(line)) {\n      return index + 1;\n    }\n  }\n  return undefined;\n};\n",
+    "import type { BlumeProject } from \"../core/project-graph.ts\";\nimport type { Diagnostic } from \"../core/types.ts\";\nimport { locateQuestion } from \"./schema.ts\";\nimport type { EvalQuestion } from \"./schema.ts\";\n\nconst DOCS_URL = \"https://useblume.dev/docs/reference/eval\";\n\n/** Where a finding should anchor when no route hint matches a page. */\nexport interface EvalsAnchor {\n  path: string;\n  raw: string;\n}\n\n/** The manifest route a hint names, if any. */\nconst hintedRoute = (question: EvalQuestion, project: BlumeProject) => {\n  for (const hint of question.routes) {\n    const route = project.manifest.routes.find(\n      (candidate) => candidate.path === hint\n    );\n    if (route) {\n      return route;\n    }\n  }\n};\n\n/**\n * Warnings for route hints that name no manifest route — docs move, and a\n * finding that silently anchors to the evals file instead of the page it\n * used to name is a debugging session; a warning is a one-line fix.\n */\nexport const routeFindings = (\n  question: EvalQuestion,\n  project: BlumeProject,\n  anchor: EvalsAnchor\n): Diagnostic[] => {\n  const known = new Set(project.manifest.routes.map((route) => route.path));\n  return question.routes\n    .filter((hint) => !known.has(hint))\n    .map((hint) => ({\n      code: \"BLUME_EVAL_ROUTE_UNKNOWN\",\n      docsUrl: DOCS_URL,\n      file: anchor.path,\n      line: locateQuestion(anchor.raw, question.id),\n      message: `Question \"${question.id}\" hints at route \"${hint}\", which matches no page.`,\n      severity: \"warning\" as const,\n      suggestion:\n        \"Update the question's `routes` to the page's current route, or remove the hint.\",\n    }));\n};\n\n/** What the finding needs to know about how the question went. */\nexport interface QuestionOutcome {\n  /** Why the run errored, when it did. */\n  detail?: string;\n  /** The expected facts the judge found absent or contradicted. */\n  missing: string[];\n  status: \"error\" | \"fail\";\n}\n\n/**\n * The diagnostic for a failed or errored question, anchored to the page that\n * should have answered it (via the first matching route hint) or, failing\n * that, to the question's line in the evals file.\n */\nexport const questionFinding = (\n  question: EvalQuestion,\n  outcome: QuestionOutcome,\n  project: BlumeProject,\n  anchor: EvalsAnchor\n): Diagnostic => {\n  const route = hintedRoute(question, project);\n  const site = route\n    ? { file: route.sourcePath, url: route.path }\n    : { file: anchor.path, line: locateQuestion(anchor.raw, question.id) };\n\n  if (outcome.status === \"error\") {\n    return {\n      code: \"BLUME_EVAL_QUESTION_ERROR\",\n      docsUrl: DOCS_URL,\n      message: `Eval run failed for \"${question.question}\"${\n        outcome.detail ? ` — ${outcome.detail}` : \"\"\n      }.`,\n      severity: question.severity,\n      suggestion:\n        \"Rerun `blume eval`; if it persists, check the agent CLI installation and the failure detail.\",\n      ...site,\n    };\n  }\n\n  const missing =\n    outcome.missing.length > 0\n      ? ` — missing: ${outcome.missing.join(\"; \")}`\n      : \"\";\n  return {\n    code: \"BLUME_EVAL_QUESTION_FAILED\",\n    docsUrl: DOCS_URL,\n    message: `Docs could not answer: \"${question.question}\"${missing}`,\n    severity: question.severity,\n    suggestion:\n      \"State the missing facts on this page, then rerun `blume eval`.\",\n    ...site,\n  };\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "D2F08D9122CA47D464756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-27gtm2ym.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+
+// src/core/trim.ts
+var trimStart = (text, char) => {
+  let start = 0;
+  while (start < text.length && text[start] === char) {
+    start += 1;
+  }
+  return text.slice(start);
+};
+var trimEnd = (text, char) => {
+  let end = text.length;
+  while (end > 0 && text[end - 1] === char) {
+    end -= 1;
+  }
+  return text.slice(0, end);
+};
+var trimChar = (text, char) => trimEnd(trimStart(text, char), char);
+
+// src/core/base-path.ts
+var normalizeBasePath = (input) => {
+  if (!input) {
+    return "";
+  }
+  const trimmed = input.trim().split("/").filter(Boolean).join("/");
+  return trimmed === "" ? "" : `/${trimmed}`;
+};
+var normalizePath = (path) => {
+  const trimmed = trimEnd(path, "/");
+  return trimmed === "" ? "/" : trimmed;
+};
+var normalizeRoute = (input) => {
+  const trimmed = trimEnd(input.trim(), "/");
+  if (trimmed === "") {
+    return "/";
+  }
+  return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+};
+var isInternalPath = (target) => target.startsWith("/") && !target.startsWith("//");
+var withBasePath = (basePath, route) => {
+  if (!basePath || !isInternalPath(route)) {
+    return route;
+  }
+  if (route === basePath || route.startsWith(`${basePath}/`)) {
+    return route;
+  }
+  return route === "/" ? basePath : `${basePath}${route}`;
+};
+var withComposedBasePath = (deployBase, basePath, route) => {
+  const composed = `${deployBase}${basePath}`;
+  if (composed && isInternalPath(route) && (route === composed || route.startsWith(`${composed}/`))) {
+    return route;
+  }
+  return withBasePath(deployBase, withBasePath(basePath, route));
+};
+var stripBasePath = (basePath, route) => {
+  if (!basePath) {
+    return route;
+  }
+  if (route === basePath) {
+    return "/";
+  }
+  return route.startsWith(`${basePath}/`) ? route.slice(basePath.length) : route;
+};
+
+export { trimEnd, trimChar, normalizeBasePath, normalizePath, normalizeRoute, isInternalPath, withBasePath, withComposedBasePath, stripBasePath };
+
+//# debugId=208B4F87BEF51A7364756E2164756E21
+//# sourceMappingURL=chunk-27gtm2ym.js.map

package/dist/cli/chunk-27gtm2ym.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/core/trim.ts", "../src/core/base-path.ts"],
+  "sourcesContent": [
+    "/**\n * Single-character trimming, done without regular expressions.\n *\n * The obvious spellings — `/^\\/+/`, `/\\/+$/`, `/^\\/+|\\/+$/g` — take quadratic\n * time on a run of the trimmed character, because a failed match at one start\n * position tells the engine nothing about the next one. Every caller here trims\n * a value that comes from outside Blume (a configured route, a spec URL, a site\n * origin), so the slow path is reachable from user input rather than only from\n * our own literals. These loops are linear and allocation-free.\n */\n\n/** Drop every leading `char` (`\"///a\"` -> `\"a\"` for `\"/\"`). */\nexport const trimStart = (text: string, char: string): string => {\n  let start = 0;\n  while (start < text.length && text[start] === char) {\n    start += 1;\n  }\n  return text.slice(start);\n};\n\n/** Drop every trailing `char` (`\"a///\"` -> `\"a\"` for `\"/\"`). */\nexport const trimEnd = (text: string, char: string): string => {\n  let end = text.length;\n  while (end > 0 && text[end - 1] === char) {\n    end -= 1;\n  }\n  return text.slice(0, end);\n};\n\n/** Drop every leading *and* trailing `char` (`\"///a///\"` -> `\"a\"`). */\nexport const trimChar = (text: string, char: string): string =>\n  trimEnd(trimStart(text, char), char);\n",
+    "/**\n * The site-wide `basePath` — a mount point that prepends a segment to every\n * generated route (`/docs/getting-started`) while staying invisible to the\n * navigation tree (see `core/navigation.ts`, which builds groups from a page's\n * base-less `navPath` and takes URLs from its based `route`). This is distinct\n * from a per-source `prefix` (a namespace that *does* create a sidebar group)\n * and from `deployment.base` (Astro's host-subdirectory base); the two compose,\n * stacking as `{deployment.base}/{basePath}/page`.\n *\n * These helpers run server-side (config, route construction, the link checker,\n * redirects, the markdown link plugin). The client-side counterpart lives in\n * `components/islands/base-path.ts` and serves `deployment.base` via `BASE_URL`.\n */\n\nimport { trimEnd } from \"./trim.ts\";\n\n/**\n * Canonicalize a configured base path to either `\"\"` (none) or `/seg[/seg…]`\n * (leading slash, no trailing slash, collapsed inner slashes). A blank value or\n * bare `/` normalizes to `\"\"`, so an unset/`\"/\"` base is a clean no-op.\n */\nexport const normalizeBasePath = (input?: string): string => {\n  if (!input) {\n    return \"\";\n  }\n  // Splitting on \"/\" and dropping the empty parts trims the edges and collapses\n  // inner runs in one linear pass; the regex spellings of both are quadratic on\n  // a long run of slashes (see `core/trim.ts`).\n  const trimmed = input.trim().split(\"/\").filter(Boolean).join(\"/\");\n  return trimmed === \"\" ? \"\" : `/${trimmed}`;\n};\n\n/**\n * Normalize a served path for comparison: drop the trailing slash (Astro serves\n * `/docs` and `/docs/` as the same page) and collapse an empty path to `/`.\n */\nexport const normalizePath = (path: string): string => {\n  const trimmed = trimEnd(path, \"/\");\n  return trimmed === \"\" ? \"/\" : trimmed;\n};\n\n/**\n * Canonicalize a route-ish string (a configured route, a page path, an agent-\n * supplied route) to `/` or `/seg[/seg…]`: trimmed, exactly one leading slash,\n * no trailing slash. The shared spelling of what openapi/references,\n * ai/ask-context, and ai/mcp/server each hand-rolled with slightly different\n * regexes.\n */\nexport const normalizeRoute = (input: string): string => {\n  const trimmed = trimEnd(input.trim(), \"/\");\n  if (trimmed === \"\") {\n    return \"/\";\n  }\n  return trimmed.startsWith(\"/\") ? trimmed : `/${trimmed}`;\n};\n\n/**\n * Whether a link target is a root-relative internal path (`/x`) — the only\n * shape a base path applies to. Protocol-relative (`//host`), absolute URLs,\n * other schemes (`mailto:`), fragments (`#x`), and relative paths are excluded.\n */\nexport const isInternalPath = (target: string): boolean =>\n  target.startsWith(\"/\") && !target.startsWith(\"//\");\n\n/**\n * Whether a rendered link should open in a new tab: an absolute http(s) URL or\n * a protocol-relative one (`//host/path`). Other schemes (`mailto:`, `tel:`)\n * also leave the site but hand off to another application, where a `_blank`\n * target only opens an empty tab beside it. The one predicate behind every\n * chrome link, so a header action and a sidebar featured link treat the same\n * href alike.\n */\nexport const isExternalUrl = (target: string): boolean =>\n  /^https?:\\/\\//iu.test(target) || target.startsWith(\"//\");\n\n/**\n * Idempotently prepend `basePath` to a root-relative route. A route already\n * equal to or nested under the base is returned unchanged, so authors who write\n * the base by hand (`/docs/x`) aren't double-prefixed to `/docs/docs/x`.\n */\nexport const withBasePath = (basePath: string, route: string): string => {\n  if (!basePath || !isInternalPath(route)) {\n    return route;\n  }\n  if (route === basePath || route.startsWith(`${basePath}/`)) {\n    return route;\n  }\n  return route === \"/\" ? basePath : `${basePath}${route}`;\n};\n\n/**\n * {@link withBasePath} for the composed `deployment.base` + `basePath` stack\n * (`/base` + `/docs` serves pages at `/base/docs/x`). The hand-written-base\n * promise applies per layer: authors write `basePath` by hand (see\n * `markdown/base-links.ts`), so a `/docs/x` link gains only the deployment base\n * (`/base/docs/x`) rather than being double-prefixed to `/base/docs/docs/x`,\n * and a route already under the full composite is returned unchanged.\n */\nexport const withComposedBasePath = (\n  deployBase: string,\n  basePath: string,\n  route: string\n): string => {\n  const composed = `${deployBase}${basePath}`;\n  if (\n    composed &&\n    isInternalPath(route) &&\n    (route === composed || route.startsWith(`${composed}/`))\n  ) {\n    return route;\n  }\n  return withBasePath(deployBase, withBasePath(basePath, route));\n};\n\n/**\n * Remove `basePath` from the front of a route (`/docs/guide` -> `/guide`,\n * `/docs` -> `/`). A route not under the base is returned unchanged. Inverse of\n * {@link withBasePath}; used to resolve public assets, which live at the site\n * root regardless of the base.\n */\nexport const stripBasePath = (basePath: string, route: string): string => {\n  if (!basePath) {\n    return route;\n  }\n  if (route === basePath) {\n    return \"/\";\n  }\n  return route.startsWith(`${basePath}/`)\n    ? route.slice(basePath.length)\n    : route;\n};\n"
+  ],
+  "mappings": ";;;AAYO,IAAM,YAAY,CAAC,MAAc,SAAyB;AAAA,EAC/D,IAAI,QAAQ;AAAA,EACZ,OAAO,QAAQ,KAAK,UAAU,KAAK,WAAW,MAAM;AAAA,IAClD,SAAS;AAAA,EACX;AAAA,EACA,OAAO,KAAK,MAAM,KAAK;AAAA;AAIlB,IAAM,UAAU,CAAC,MAAc,SAAyB;AAAA,EAC7D,IAAI,MAAM,KAAK;AAAA,EACf,OAAO,MAAM,KAAK,KAAK,MAAM,OAAO,MAAM;AAAA,IACxC,OAAO;AAAA,EACT;AAAA,EACA,OAAO,KAAK,MAAM,GAAG,GAAG;AAAA;AAInB,IAAM,WAAW,CAAC,MAAc,SACrC,QAAQ,UAAU,MAAM,IAAI,GAAG,IAAI;;;ACV9B,IAAM,oBAAoB,CAAC,UAA2B;AAAA,EAC3D,IAAI,CAAC,OAAO;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EAIA,MAAM,UAAU,MAAM,KAAK,EAAE,MAAM,GAAG,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG;AAAA,EAChE,OAAO,YAAY,KAAK,KAAK,IAAI;AAAA;AAO5B,IAAM,gBAAgB,CAAC,SAAyB;AAAA,EACrD,MAAM,UAAU,QAAQ,MAAM,GAAG;AAAA,EACjC,OAAO,YAAY,KAAK,MAAM;AAAA;AAUzB,IAAM,iBAAiB,CAAC,UAA0B;AAAA,EACvD,MAAM,UAAU,QAAQ,MAAM,KAAK,GAAG,GAAG;AAAA,EACzC,IAAI,YAAY,IAAI;AAAA,IAClB,OAAO;AAAA,EACT;AAAA,EACA,OAAO,QAAQ,WAAW,GAAG,IAAI,UAAU,IAAI;AAAA;AAQ1C,IAAM,iBAAiB,CAAC,WAC7B,OAAO,WAAW,GAAG,KAAK,CAAC,OAAO,WAAW,IAAI;AAkB5C,IAAM,eAAe,CAAC,UAAkB,UAA0B;AAAA,EACvE,IAAI,CAAC,YAAY,CAAC,eAAe,KAAK,GAAG;AAAA,IACvC,OAAO;AAAA,EACT;AAAA,EACA,IAAI,UAAU,YAAY,MAAM,WAAW,GAAG,WAAW,GAAG;AAAA,IAC1D,OAAO;AAAA,EACT;AAAA,EACA,OAAO,UAAU,MAAM,WAAW,GAAG,WAAW;AAAA;AAW3C,IAAM,uBAAuB,CAClC,YACA,UACA,UACW;AAAA,EACX,MAAM,WAAW,GAAG,aAAa;AAAA,EACjC,IACE,YACA,eAAe,KAAK,MACnB,UAAU,YAAY,MAAM,WAAW,GAAG,WAAW,IACtD;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EACA,OAAO,aAAa,YAAY,aAAa,UAAU,KAAK,CAAC;AAAA;AASxD,IAAM,gBAAgB,CAAC,UAAkB,UAA0B;AAAA,EACxE,IAAI,CAAC,UAAU;AAAA,IACb,OAAO;AAAA,EACT;AAAA,EACA,IAAI,UAAU,UAAU;AAAA,IACtB,OAAO;AAAA,EACT;AAAA,EACA,OAAO,MAAM,WAAW,GAAG,WAAW,IAClC,MAAM,MAAM,SAAS,MAAM,IAC3B;AAAA;",
+  "debugId": "208B4F87BEF51A7364756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-2aj8ddew.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/cli/command-meta.ts
+var commandMeta = {
+  add: {
+    description: "Install a source component or template from the registry.",
+    name: "add"
+  },
+  audit: {
+    description: "Audit the built site for SEO and site-health issues.",
+    name: "audit"
+  },
+  build: {
+    description: "Build the docs site for production.",
+    name: "build"
+  },
+  check: {
+    description: "Type-check the docs site with astro check.",
+    name: "check"
+  },
+  dev: {
+    description: "Start the Blume development server.",
+    name: "dev"
+  },
+  doctor: {
+    description: "Diagnose common configuration and content problems.",
+    name: "doctor"
+  },
+  eject: {
+    description: "Promote the generated runtime into an owned Astro project.",
+    name: "eject"
+  },
+  eval: {
+    description: "Test the docs: an agent answers your questions using only the documentation.",
+    name: "eval"
+  },
+  init: {
+    description: "Scaffold a minimal Blume project.",
+    name: "init"
+  },
+  "mcp-stdio": {
+    description: "Serve an MCP data snapshot over stdio (internal, used by `blume eval`).",
+    name: "mcp-stdio"
+  },
+  preview: {
+    description: "Preview the last production build.",
+    name: "preview"
+  },
+  sync: {
+    description: "Re-fetch remote content sources and regenerate the runtime.",
+    name: "sync"
+  },
+  translate: {
+    description: "Translate docs into the configured locales with a local agent CLI.",
+    name: "translate"
+  },
+  validate: {
+    description: "Validate internal, anchor, asset, and external links.",
+    name: "validate"
+  },
+  version: {
+    description: "Freeze the current docs as an archived version.",
+    name: "version"
+  }
+};
+
+export { __require, commandMeta };
+
+//# debugId=3DF60EB79641093164756E2164756E21
+//# sourceMappingURL=chunk-2aj8ddew.js.map

package/dist/cli/chunk-2aj8ddew.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/command-meta.ts"],
+  "sourcesContent": [
+    "import type { CommandMeta } from \"citty\";\n\n/**\n * Every command's `meta`, held apart from the command modules themselves.\n *\n * The CLI entry loads each command lazily (see `lazy-command.ts`), but citty\n * still reads every subcommand's `meta` to render `blume --help` and to match\n * an unknown name against aliases. Keeping that table here lets those paths\n * run without importing a single command module — `dev` alone drags in Astro,\n * `mcp-stdio` the MCP SDK. The command modules read their `meta` from this\n * table too, so the entry and the command can't drift.\n */\nexport const commandMeta = {\n  add: {\n    description: \"Install a source component or template from the registry.\",\n    name: \"add\",\n  },\n  audit: {\n    description: \"Audit the built site for SEO and site-health issues.\",\n    name: \"audit\",\n  },\n  build: {\n    description: \"Build the docs site for production.\",\n    name: \"build\",\n  },\n  check: {\n    description: \"Type-check the docs site with astro check.\",\n    name: \"check\",\n  },\n  dev: {\n    description: \"Start the Blume development server.\",\n    name: \"dev\",\n  },\n  doctor: {\n    description: \"Diagnose common configuration and content problems.\",\n    name: \"doctor\",\n  },\n  eject: {\n    description: \"Promote the generated runtime into an owned Astro project.\",\n    name: \"eject\",\n  },\n  eval: {\n    description:\n      \"Test the docs: an agent answers your questions using only the documentation.\",\n    name: \"eval\",\n  },\n  init: {\n    description: \"Scaffold a minimal Blume project.\",\n    name: \"init\",\n  },\n  \"mcp-stdio\": {\n    description:\n      \"Serve an MCP data snapshot over stdio (internal, used by `blume eval`).\",\n    name: \"mcp-stdio\",\n  },\n  preview: {\n    description: \"Preview the last production build.\",\n    name: \"preview\",\n  },\n  sync: {\n    description: \"Re-fetch remote content sources and regenerate the runtime.\",\n    name: \"sync\",\n  },\n  translate: {\n    description:\n      \"Translate docs into the configured locales with a local agent CLI.\",\n    name: \"translate\",\n  },\n  validate: {\n    description: \"Validate internal, anchor, asset, and external links.\",\n    name: \"validate\",\n  },\n  version: {\n    description: \"Freeze the current docs as an archived version.\",\n    name: \"version\",\n  },\n} satisfies Record<string, CommandMeta>;\n"
+  ],
+  "mappings": ";;;;;AAYO,IAAM,cAAc;AAAA,EACzB,KAAK;AAAA,IACH,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,OAAO;AAAA,IACL,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,OAAO;AAAA,IACL,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,OAAO;AAAA,IACL,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,KAAK;AAAA,IACH,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,QAAQ;AAAA,IACN,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,OAAO;AAAA,IACL,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,MAAM;AAAA,IACJ,aACE;AAAA,IACF,MAAM;AAAA,EACR;AAAA,EACA,MAAM;AAAA,IACJ,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,aAAa;AAAA,IACX,aACE;AAAA,IACF,MAAM;AAAA,EACR;AAAA,EACA,SAAS;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,MAAM;AAAA,IACJ,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,WAAW;AAAA,IACT,aACE;AAAA,IACF,MAAM;AAAA,EACR;AAAA,EACA,UAAU;AAAA,IACR,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,SAAS;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AACF;",
+  "debugId": "3DF60EB79641093164756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-3k0kzs6d.js

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

package/dist/cli/chunk-3k0kzs6d.js.map

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

package/dist/cli/chunk-3r94j3tc.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+import {
+  packageRoot
+} from "./chunk-6kzzpsx8.js";
+
+// src/registry/registry.ts
+import { join } from "pathe";
+var packageSrc = join(packageRoot(), "src");
+var layoutComponent = (config) => {
+  const target = `components/blume/${config.file}`;
+  return {
+    description: config.description,
+    files: [
+      {
+        rewrite: true,
+        source: `components/layout/${config.file}`,
+        target
+      }
+    ],
+    name: config.name,
+    postInstall: [
+      "Register it in components.ts:",
+      '  import { defineComponents } from "blume";',
+      `  import ${config.slot} from "./${target}";`,
+      "",
+      `  export default defineComponents({ layout: { ${config.slot} } });`,
+      "",
+      "It imports the rest from `blume/*`, so it matches the built-in until you edit it."
+    ]
+  };
+};
+var contentComponent = (config) => {
+  const target = `components/blume/${config.file}`;
+  return {
+    description: config.description,
+    files: [
+      {
+        rewrite: true,
+        source: `components/content/${config.file}`,
+        target
+      }
+    ],
+    name: config.name,
+    postInstall: [
+      "Register it in components.ts:",
+      '  import { defineComponents } from "blume";',
+      `  import ${config.tag} from "./${target}";`,
+      "",
+      `  export default defineComponents({ mdx: { ${config.tag} } });`,
+      "",
+      "It imports the rest from `blume/*`, so it matches the built-in until you edit it."
+    ]
+  };
+};
+var CONTENT_COMPONENTS = [
+  {
+    description: "Aside for notes, tips, and warnings.",
+    file: "Callout.astro",
+    name: "callout",
+    tag: "Callout"
+  },
+  {
+    description: "A linkable card with icon, title, and body.",
+    file: "Card.astro",
+    name: "card",
+    tag: "Card"
+  },
+  {
+    description: "A responsive grid of cards.",
+    file: "CardGroup.astro",
+    name: "card-group",
+    tag: "CardGroup"
+  },
+  {
+    description: "Tabbed code blocks for multiple languages.",
+    file: "CodeGroup.astro",
+    name: "code-group",
+    tag: "CodeGroup"
+  },
+  {
+    description: "A small status/label badge.",
+    file: "Badge.astro",
+    name: "badge",
+    tag: "Badge"
+  },
+  {
+    description: "A numbered list of steps.",
+    file: "Steps.astro",
+    name: "steps",
+    tag: "Steps"
+  },
+  {
+    description: "A single step within Steps.",
+    file: "Step.astro",
+    name: "step",
+    tag: "Step"
+  },
+  {
+    description: "A tabbed content panel.",
+    file: "Tabs.astro",
+    name: "tabs",
+    tag: "Tabs"
+  },
+  {
+    description: "A single tab within Tabs.",
+    file: "Tab.astro",
+    name: "tab",
+    tag: "Tab"
+  },
+  {
+    description: "A collapsible accordion group.",
+    file: "Accordion.astro",
+    name: "accordion",
+    tag: "Accordion"
+  },
+  {
+    description: "A single item within an Accordion.",
+    file: "AccordionItem.astro",
+    name: "accordion-item",
+    tag: "AccordionItem"
+  },
+  {
+    description: "A multi-column layout.",
+    file: "Columns.astro",
+    name: "columns",
+    tag: "Columns"
+  },
+  {
+    description: "A single column within Columns.",
+    file: "Column.astro",
+    name: "column",
+    tag: "Column"
+  },
+  {
+    description: "A bordered frame around an image or embed.",
+    file: "Frame.astro",
+    name: "frame",
+    tag: "Frame"
+  },
+  {
+    description: "An inline expand/collapse disclosure.",
+    file: "Expandable.astro",
+    name: "expandable",
+    tag: "Expandable"
+  },
+  {
+    description: "A titled content panel.",
+    file: "Panel.astro",
+    name: "panel",
+    tag: "Panel"
+  },
+  {
+    description: "A hover tooltip.",
+    file: "Tooltip.astro",
+    name: "tooltip",
+    tag: "Tooltip"
+  },
+  {
+    description: "A compact linkable tile.",
+    file: "Tile.astro",
+    name: "tile",
+    tag: "Tile"
+  },
+  {
+    description: "A styled prompt / terminal block.",
+    file: "Prompt.astro",
+    name: "prompt",
+    tag: "Prompt"
+  },
+  {
+    description: "A responsive, privacy-friendly YouTube embed.",
+    file: "YouTube.astro",
+    name: "youtube",
+    tag: "YouTube"
+  }
+];
+var registry = [
+  layoutComponent({
+    description: "The top navigation bar (logo, search, nav links).",
+    file: "Header.astro",
+    name: "header",
+    slot: "Header"
+  }),
+  layoutComponent({
+    description: "The sidebar navigation tree.",
+    file: "NavTree.astro",
+    name: "sidebar",
+    slot: "Sidebar"
+  }),
+  layoutComponent({
+    description: "The breadcrumb trail shown above page content.",
+    file: "Breadcrumbs.astro",
+    name: "breadcrumbs",
+    slot: "Breadcrumbs"
+  }),
+  layoutComponent({
+    description: "The on-this-page table of contents.",
+    file: "TableOfContents.astro",
+    name: "table-of-contents",
+    slot: "TableOfContents"
+  }),
+  layoutComponent({
+    description: "The previous/next pagination footer.",
+    file: "Pagination.astro",
+    name: "pagination",
+    slot: "Pagination"
+  }),
+  layoutComponent({
+    description: 'The "Was this page helpful?" feedback rating.',
+    file: "PageFeedback.astro",
+    name: "feedback",
+    slot: "Feedback"
+  }),
+  ...CONTENT_COMPONENTS.map(contentComponent)
+];
+var findItem = (name) => registry.find((item) => item.name === name);
+
+export { packageSrc, registry, findItem };
+
+//# debugId=2BDCE672B82B453C64756E2164756E21
+//# sourceMappingURL=chunk-3r94j3tc.js.map