blume 1.6.5 → 1.7.0

package/dist/cli/chunk-y3g15rvv.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-ye9zdkgv.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+import {
+  resolveRuntimeDir
+} from "./chunk-xv91q4nm.js";
+import {
+  logger
+} from "./chunk-ey89bjj1.js";
+
+// src/cli/dev-lock.ts
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  rmSync,
+  writeFileSync
+} from "node:fs";
+import { join } from "pathe";
+var lockPath = (outDir) => join(outDir, "dev.lock");
+var isValidPid = (pid) => typeof pid === "number" && Number.isInteger(pid) && pid > 0;
+var isPortNumber = (port) => typeof port === "number";
+var isLockRecord = (data) => typeof data === "object" && data !== null;
+var parseLock = (raw) => {
+  let data;
+  try {
+    data = JSON.parse(raw.trim());
+  } catch {
+    return null;
+  }
+  if (isValidPid(data)) {
+    return { pid: data };
+  }
+  if (isLockRecord(data)) {
+    const { pid, port } = data;
+    if (isValidPid(pid)) {
+      return isPortNumber(port) ? { pid, port } : { pid };
+    }
+  }
+  return null;
+};
+var isProcessAlive = (pid) => {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return error.code === "EPERM";
+  }
+};
+var readDevLock = (outDir) => {
+  const path = lockPath(outDir);
+  if (!existsSync(path)) {
+    return null;
+  }
+  const lock = parseLock(readFileSync(path, "utf-8"));
+  return lock && isProcessAlive(lock.pid) ? lock : null;
+};
+var lockPayload = (port) => {
+  const info = { pid: process.pid };
+  if (port !== undefined) {
+    info.port = port;
+  }
+  return JSON.stringify(info);
+};
+var writeLock = (outDir, port) => {
+  writeFileSync(lockPath(outDir), lockPayload(port));
+};
+
+class DevLockHeldError extends Error {
+  lock;
+  constructor(lock) {
+    super(`A blume dev server (pid ${lock.pid}) already holds the lock.`);
+    this.name = "DevLockHeldError";
+    this.lock = lock;
+  }
+}
+var ownsLock = (outDir) => {
+  const path = lockPath(outDir);
+  if (!existsSync(path)) {
+    return false;
+  }
+  try {
+    return parseLock(readFileSync(path, "utf-8"))?.pid === process.pid;
+  } catch {
+    return false;
+  }
+};
+var tryClaimLock = (outDir, port) => {
+  try {
+    writeFileSync(lockPath(outDir), lockPayload(port), { flag: "wx" });
+    return true;
+  } catch (error) {
+    if (error.code !== "EEXIST") {
+      throw error;
+    }
+    const existing = readDevLock(outDir);
+    if (existing && existing.pid !== process.pid) {
+      throw new DevLockHeldError(existing);
+    }
+    rmSync(lockPath(outDir), { force: true });
+    return false;
+  }
+};
+var acquireDevLock = (outDir, port) => {
+  mkdirSync(outDir, { recursive: true });
+  while (!tryClaimLock(outDir, port)) {}
+  let released = false;
+  return () => {
+    if (released) {
+      return;
+    }
+    released = true;
+    try {
+      if (ownsLock(outDir)) {
+        rmSync(lockPath(outDir), { force: true });
+      }
+    } catch {}
+  };
+};
+var updateDevLockPort = (outDir, port) => {
+  if (ownsLock(outDir)) {
+    writeLock(outDir, port);
+  }
+};
+var describeDevLock = (lock) => lock.port === undefined ? "" : ` at http://localhost:${lock.port}`;
+var refuseIfDevRunning = (root, action, options = {}) => {
+  const lock = readDevLock(resolveRuntimeDir(root, options.runtimeDir));
+  if (lock) {
+    const remedies = options.isolatedHint ? "Reuse that server, stop it first, or re-run with --isolated to build/verify against .blume-verify without touching it." : "Reuse that server or stop it first.";
+    logger.error(`A \`blume dev\` server is running${describeDevLock(lock)}; ${action} would corrupt its .blume runtime. ${remedies}`);
+    process.exit(1);
+  }
+};
+
+export { readDevLock, DevLockHeldError, acquireDevLock, updateDevLockPort, describeDevLock, refuseIfDevRunning };
+
+//# debugId=1007843429DAE30664756E2164756E21
+//# sourceMappingURL=chunk-ye9zdkgv.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/dev-lock.ts"],
+  "sourcesContent": [
+    "import {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  rmSync,\n  writeFileSync,\n} from \"node:fs\";\n\nimport { join } from \"pathe\";\n\nimport { resolveRuntimeDir } from \"../core/project.ts\";\nimport { logger } from \"./log.ts\";\n\n/**\n * A best-effort PID lock in the shared `.blume/` runtime dir. `blume dev`\n * regenerates and serves `.blume` continuously, so a concurrent `build`,\n * `eject`, or second `dev` that regenerates or deletes it out from under the\n * running Vite server corrupts the dev session. The lock lets those commands\n * detect a live dev server and refuse — and, because it records the server's\n * port, point the caller (often an agent that just tried to start its own\n * server) at the URL to reuse instead.\n */\n\nexport interface DevLockInfo {\n  pid: number;\n  /** Port the dev server is bound to, when known. */\n  port?: number;\n}\n\nconst lockPath = (outDir: string): string => join(outDir, \"dev.lock\");\n\n/** What `JSON.parse` can yield for a lock file body. */\ntype LockFileValue =\n  | string\n  | number\n  | boolean\n  | null\n  | LockFileValue[]\n  | { [key: string]: LockFileValue };\n\nconst isValidPid = (pid: LockFileValue | undefined): pid is number =>\n  typeof pid === \"number\" && Number.isInteger(pid) && pid > 0;\n\nconst isPortNumber = (port: LockFileValue | undefined): port is number =>\n  typeof port === \"number\";\n\nconst isLockRecord = (\n  data: LockFileValue\n): data is { pid?: LockFileValue; port?: LockFileValue } =>\n  typeof data === \"object\" && data !== null;\n\n/**\n * Parse a lock file body. Current locks are JSON (`{\"pid\":123,\"port\":3001}`);\n * a bare integer (the pre-port format) still parses as a pid-only lock.\n */\nconst parseLock = (raw: string): DevLockInfo | null => {\n  let data: LockFileValue;\n  try {\n    data = JSON.parse(raw.trim());\n  } catch {\n    return null;\n  }\n  if (isValidPid(data)) {\n    return { pid: data };\n  }\n  if (isLockRecord(data)) {\n    const { pid, port } = data;\n    if (isValidPid(pid)) {\n      return isPortNumber(port) ? { pid, port } : { pid };\n    }\n  }\n  return null;\n};\n\nconst isProcessAlive = (pid: number): boolean => {\n  try {\n    // Signal 0 probes liveness without actually signaling the process.\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    // EPERM means the process exists but belongs to another user — still\n    // live, so the lock must hold (only ESRCH proves it's gone).\n    // SAFETY: `process.kill` failures are errno exceptions.\n    return (error as NodeJS.ErrnoException).code === \"EPERM\";\n  }\n};\n\n/**\n * Read the lock on `outDir` held by a live `blume dev`, or null. A lock left\n * by a process that has since exited (stale) is treated as absent.\n */\nexport const readDevLock = (outDir: string): DevLockInfo | null => {\n  const path = lockPath(outDir);\n  if (!existsSync(path)) {\n    return null;\n  }\n  const lock = parseLock(readFileSync(path, \"utf-8\"));\n  return lock && isProcessAlive(lock.pid) ? lock : null;\n};\n\n/** Whether another live `blume dev` holds the lock on `outDir`. */\nexport const isDevLocked = (outDir: string): boolean =>\n  readDevLock(outDir) !== null;\n\nconst lockPayload = (port?: number): string => {\n  const info: DevLockInfo = { pid: process.pid };\n  if (port !== undefined) {\n    info.port = port;\n  }\n  return JSON.stringify(info);\n};\n\nconst writeLock = (outDir: string, port?: number): void => {\n  writeFileSync(lockPath(outDir), lockPayload(port));\n};\n\n/** Thrown when another live `blume dev` already holds the lock. */\nexport class DevLockHeldError extends Error {\n  readonly lock: DevLockInfo;\n\n  constructor(lock: DevLockInfo) {\n    super(`A blume dev server (pid ${lock.pid}) already holds the lock.`);\n    this.name = \"DevLockHeldError\";\n    this.lock = lock;\n  }\n}\n\nconst ownsLock = (outDir: string): boolean => {\n  const path = lockPath(outDir);\n  if (!existsSync(path)) {\n    return false;\n  }\n  try {\n    return parseLock(readFileSync(path, \"utf-8\"))?.pid === process.pid;\n  } catch {\n    return false;\n  }\n};\n\n/**\n * One atomic claim attempt. Returns `true` when this process wins the `wx`\n * write, `false` when the dir held a stale or our-own leftover lock (now\n * cleared, so the caller should retry). Throws {@link DevLockHeldError} when a\n * live foreign holder owns the dir.\n */\nconst tryClaimLock = (outDir: string, port?: number): boolean => {\n  try {\n    writeFileSync(lockPath(outDir), lockPayload(port), { flag: \"wx\" });\n    return true;\n  } catch (error) {\n    // SAFETY: `writeFileSync` failures are errno exceptions.\n    if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") {\n      throw error;\n    }\n    const existing = readDevLock(outDir);\n    if (existing && existing.pid !== process.pid) {\n      throw new DevLockHeldError(existing);\n    }\n    // Stale or our own leftover: clear it and race for the claim again.\n    rmSync(lockPath(outDir), { force: true });\n    return false;\n  }\n};\n\n/**\n * Write the current process's dev lock into `outDir` and return a release\n * function. The claim is atomic (`wx`): two `blume dev` processes racing the\n * same dir can't both pass a check-then-write — the loser gets a\n * {@link DevLockHeldError} naming the live holder. A stale lock (dead pid) or\n * this process's own leftover is cleared and re-claimed. The release only\n * removes the file if it's still ours, so a newer dev server's lock is never\n * clobbered.\n */\nexport const acquireDevLock = (outDir: string, port?: number): (() => void) => {\n  mkdirSync(outDir, { recursive: true });\n  while (!tryClaimLock(outDir, port)) {\n    // Retry until we win the claim or a live holder makes us throw.\n  }\n  let released = false;\n  return () => {\n    if (released) {\n      return;\n    }\n    released = true;\n    try {\n      if (ownsLock(outDir)) {\n        rmSync(lockPath(outDir), { force: true });\n      }\n    } catch {\n      // Best-effort cleanup; a stale lock is handled by the liveness check.\n    }\n  };\n};\n\n/**\n * Rewrite this process's lock with the port the server actually bound (the\n * lock is acquired before the server starts, and Vite may bump a busy port).\n * A lock owned by another process is left alone.\n */\nexport const updateDevLockPort = (outDir: string, port: number): void => {\n  if (ownsLock(outDir)) {\n    writeLock(outDir, port);\n  }\n};\n\n/** Human-readable location of a locked dev server, e.g. \" at http://localhost:3001\". */\nexport const describeDevLock = (lock: DevLockInfo): string =>\n  lock.port === undefined ? \"\" : ` at http://localhost:${lock.port}`;\n\n/**\n * Exit with an error when a live `blume dev` owns the runtime dir under `root`.\n * `action` names the operation being refused (e.g. \"building\"). `runtimeDir`\n * relocates the checked dir: an isolated verify (`.blume-verify`) targets a dir\n * dev never locks, so it proceeds; a default or `--runtime-dir .blume` run still\n * refuses. Only commands that actually accept `--isolated` (build, check) should\n * set `isolatedHint`, so the refusal never suggests a flag the command ignores.\n */\nexport const refuseIfDevRunning = (\n  root: string,\n  action: string,\n  options: { runtimeDir?: string; isolatedHint?: boolean } = {}\n): void => {\n  const lock = readDevLock(resolveRuntimeDir(root, options.runtimeDir));\n  if (lock) {\n    const remedies = options.isolatedHint\n      ? \"Reuse that server, stop it first, or re-run with --isolated to build/verify against .blume-verify without touching it.\"\n      : \"Reuse that server or stop it first.\";\n    logger.error(\n      `A \\`blume dev\\` server is running${describeDevLock(lock)}; ${action} would corrupt its .blume runtime. ${remedies}`\n    );\n    process.exit(1);\n  }\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "1007843429DAE30664756E2164756E21",
+  "names": []
+}