blume 1.7.3 → 2.0.1

package/dist/cli/{chunk-cjtn640a.js → chunk-kdp5q7ke.js}

@@ -1,42 +1,46 @@
 #!/usr/bin/env node
-import"./chunk-ct47dqpx.js";
-import"./chunk-0qymqwzz.js";
+import"./chunk-jts8mvcz.js";
 import {
-  scanProject
-} from "./chunk-1jefwnfs.js";
+  resolveRuntimeDir
+} from "./chunk-qkqwkpte.js";
 import {
   refreshBlumeContent,
   showBlumeErrorOverlay,
   generateRuntime
-} from "./chunk-k79xp7av.js";
-import"./chunk-js7saxwm.js";
+} from "./chunk-wgm7m9qk.js";
 import {
   commandMeta,
   normalizeHost,
+  BlumeError,
   logger,
   reportDiagnostics
 } from "./index.js";
+import"./chunk-6crbhc3x.js";
 import {
-  resolveRuntimeDir
-} from "./chunk-7s8hm3b6.js";
-import"./chunk-bf6bt1xt.js";
+  scanProject
+} from "./chunk-fs23ddbb.js";
+import"./chunk-vtk4a6dg.js";
 import"./chunk-jq5n4avg.js";
-import"./chunk-ps4m1xh4.js";
-import"./chunk-nn13znc2.js";
-import"./chunk-vrfp10qk.js";
+import"./chunk-2hn4b8z7.js";
+import"./chunk-zxcczpyx.js";
+import"./chunk-wm7js3j9.js";
+import"./chunk-82bbrxdn.js";
 import {
   DevLockHeldError,
   acquireDevLock,
   updateDevLockPort,
   describeDevLock
-} from "./chunk-vacwm2hv.js";
+} from "./chunk-27g6wdth.js";
 import {
-  parsePort
-} from "./chunk-dwgcp5sm.js";
+  refuseIfEjected
+} from "./chunk-yt5n7ppj.js";
 import {
   prepareProject
-} from "./chunk-esphfr8p.js";
-import"./chunk-garjf5z9.js";
+} from "./chunk-zxh4d9vy.js";
+import {
+  parsePort
+} from "./chunk-ce574jw2.js";
+import"./chunk-ah61y8py.js";
 
 // src/cli/commands/dev.ts
 import { dev } from "astro";
@@ -45,6 +49,19 @@ import { defineCommand } from "citty";
 import { debounce } from "perfect-debounce";
 var routeSignature = (routes) => routes.map((route) => `${route.path} ${route.entryId}`).toSorted().join(`
 `);
+var boundPortOf = (server, requested) => {
+  const address = server.address;
+  if (address) {
+    return address.port;
+  }
+  for (const url of server.resolvedUrls.local) {
+    const port = Number(new URL(url).port);
+    if (port > 0) {
+      return port;
+    }
+  }
+  return requested;
+};
 var devCommand = defineCommand({
   args: {
     "content-dir": {
@@ -67,6 +84,7 @@ var devCommand = defineCommand({
   meta: commandMeta.dev,
   async run({ args }) {
     const root = process.cwd();
+    await refuseIfEjected(root, "dev");
     const preview = args.preview ?? false;
     const overrides = args["content-dir"] ? { contentRoot: args["content-dir"] } : undefined;
     const explicitPort = parsePort(args.port);
@@ -98,7 +116,7 @@ var devCommand = defineCommand({
       server: { host: normalizeHost(args.host), open, port: listenPort }
     });
     let server = await createServer(explicitPort, args.open ?? false);
-    const boundPort = server.address.port;
+    const boundPort = boundPortOf(server, port);
     if (boundPort !== port) {
       updateDevLockPort(outDir, boundPort);
       devServerUrl = `http://localhost:${boundPort}`;
@@ -124,6 +142,11 @@ var devCommand = defineCommand({
         reportDiagnostics(next.diagnostics, root);
         showBlumeErrorOverlay(next.diagnostics);
       } catch (error) {
+        if (error instanceof BlumeError) {
+          reportDiagnostics([error.diagnostic], root);
+          showBlumeErrorOverlay([error.diagnostic]);
+          return;
+        }
         logger.error(`Regeneration failed: ${error.message}`);
       }
     }, 80);
@@ -161,5 +184,5 @@ export {
   devCommand
 };
 
-//# debugId=C55DCF2DA51757BB64756E2164756E21
-//# sourceMappingURL=chunk-cjtn640a.js.map
+//# debugId=DAFEE5DB6B0E8A0164756E2164756E21
+//# sourceMappingURL=chunk-kdp5q7ke.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/dev.ts"],
+  "sourcesContent": [
+    "import { dev } from \"astro\";\nimport { watch } from \"chokidar\";\nimport { defineCommand } from \"citty\";\nimport { debounce } from \"perfect-debounce\";\n\nimport { generateRuntime } from \"../../astro/generate.ts\";\nimport {\n  refreshBlumeContent,\n  showBlumeErrorOverlay,\n} from \"../../astro/integration.ts\";\nimport { BlumeError } from \"../../core/diagnostics.ts\";\nimport { scanProject } from \"../../core/project-graph.ts\";\nimport { resolveRuntimeDir } from \"../../core/project.ts\";\nimport { parsePort } from \"../args.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport {\n  acquireDevLock,\n  describeDevLock,\n  DevLockHeldError,\n  updateDevLockPort,\n} from \"../dev-lock.ts\";\nimport { refuseIfEjected } from \"../eject-scripts.ts\";\nimport { normalizeHost } from \"../host-args.ts\";\nimport { logger, reportDiagnostics } from \"../log.ts\";\nimport { prepareProject } from \"../prepare.ts\";\n\n/**\n * A fingerprint of the route set: the sorted `path entryId` pairs. It changes\n * when a page is added, removed, or renamed (a folder rename shifts many at\n * once) but stays equal across pure body edits — so the dev loop can tell a\n * \"structural\" change (needs a content re-sync) from a hot-reloadable one.\n */\nconst routeSignature = (\n  routes: readonly { entryId: string; path: string }[]\n): string =>\n  routes\n    .map((route) => `${route.path} ${route.entryId}`)\n    .toSorted()\n    .join(\"\\n\");\n\n/**\n * The port the dev server actually bound. Astro snapshots `address` when the\n * server first listens, but a config restart that lands during startup leaves\n * that snapshot null: the `astro.config.mjs` written just before the server\n * started can reach Astro's watcher late, and Astro restarts in place before\n * it ever listens. The live resolved URLs follow the restarted server, so read\n * the port from those, then fall back to the one that was asked for.\n */\nconst boundPortOf = (\n  server: Awaited<ReturnType<typeof dev>>,\n  requested: number\n): number => {\n  // SAFETY: Astro types `address` as always set, but it is null at runtime\n  // when a restart replaced the server before its first listen (see above).\n  const address = server.address as typeof server.address | null;\n  if (address) {\n    return address.port;\n  }\n  for (const url of server.resolvedUrls.local) {\n    const port = Number(new URL(url).port);\n    if (port > 0) {\n      return port;\n    }\n  }\n  return requested;\n};\n\nexport const devCommand = defineCommand({\n  args: {\n    \"content-dir\": {\n      description: \"Content folder to scan, overriding config (content.root).\",\n      type: \"string\",\n    },\n    debug: {\n      description: \"Verbose Astro/Vite logging for troubleshooting.\",\n      type: \"boolean\",\n    },\n    host: { description: \"Network host to bind.\", type: \"string\" },\n    open: { description: \"Open the browser on start.\", type: \"boolean\" },\n    port: { description: \"Port to listen on.\", type: \"string\" },\n    preview: {\n      description: \"Include drafts and unpublished CMS content.\",\n      type: \"boolean\",\n    },\n    strict: { description: \"Fail on diagnostics.\", type: \"boolean\" },\n  },\n  meta: commandMeta.dev,\n  async run({ args }) {\n    const root = process.cwd();\n    await refuseIfEjected(root, \"dev\");\n    const preview = args.preview ?? false;\n    const overrides = args[\"content-dir\"]\n      ? { contentRoot: args[\"content-dir\"] }\n      : undefined;\n    // Astro's dev server defaults to 4321 when no port is passed. Feeding the\n    // resolved URL in as the `deployment.site` fallback lets site-gated features\n    // (OG images, canonicals, sitemap) work locally without configuring a site.\n    const explicitPort = parsePort(args.port);\n    const port = explicitPort ?? 4321;\n    let devServerUrl = `http://localhost:${port}`;\n\n    // Claim the shared `.blume` dir BEFORE preparing: `prepareProject`\n    // regenerates the runtime, so even a refused second dev server would\n    // otherwise clobber the running one's generated tree (with this\n    // invocation's port baked in) on its way out. The claim is atomic, so two\n    // simultaneous starts can't both win. Dev never relocates the runtime dir,\n    // so the lock always lives at `<root>/.blume`.\n    const outDir = resolveRuntimeDir(root);\n    let releaseLock: () => void;\n    try {\n      releaseLock = acquireDevLock(outDir, port);\n    } catch (error) {\n      if (error instanceof DevLockHeldError) {\n        logger.error(\n          `A \\`blume dev\\` server is already running${describeDevLock(error.lock)} in this project. Reuse that server instead of starting a second one — two dev servers would corrupt the shared .blume dir. If it crashed, delete .blume/dev.lock.`\n        );\n        process.exit(1);\n      }\n      throw error;\n    }\n    process.on(\"exit\", releaseLock);\n\n    const project = await prepareProject({\n      devServerUrl,\n      mode: \"dev\",\n      overrides,\n      preview,\n      root,\n      strict: args.strict,\n    });\n\n    // A factory so the regenerate loop can recreate the server when a\n    // structural (route-set) change can't be re-synced in place (see below).\n    // `open` is honored on first boot only — a restart must not reopen the\n    // browser.\n    const createServer = (listenPort: number | undefined, open: boolean) =>\n      dev({\n        logLevel: args.debug ? \"debug\" : \"info\",\n        root: project.context.outDir,\n        server: { host: normalizeHost(args.host), open, port: listenPort },\n      });\n\n    let server = await createServer(explicitPort, args.open ?? false);\n\n    // Vite bumps to the next free port when the default is taken, so record\n    // the port the server actually bound — the lock's URL is what a refused\n    // second invocation tells its caller to reuse. The site fallback baked\n    // into the runtime also carries the port, so it must follow suit (below,\n    // once the regeneration closure exists).\n    const boundPort = boundPortOf(server, port);\n    if (boundPort !== port) {\n      updateDevLockPort(outDir, boundPort);\n      devServerUrl = `http://localhost:${boundPort}`;\n    }\n\n    // Mirror any initial diagnostics into the browser overlay now the server\n    // (and its HMR channel) is up.\n    showBlumeErrorOverlay(project.diagnostics);\n\n    let lastSignature = routeSignature(project.manifest.routes);\n\n    // Watch user inputs and regenerate the runtime data on change. A body edit\n    // hot-reloads via Vite (fast path). A route-set change also needs Astro's\n    // content store re-synced: its glob watcher misses directory renames, so a\n    // renamed page would 404 (`getEntry` reads a stale store). Astro hands the\n    // integration `refreshContent` for exactly that — a full loader run\n    // against the live server, after which Astro's own store watcher clears\n    // the route cache and reloads the browser. Only a server that registered\n    // no refresh (none since Astro 5) falls back to a cold restart: stop,\n    // then bring up a fresh container whose cold sync re-globs everything.\n    // perfect-debounce both debounces the watch burst (80ms) and\n    // single-flights the scan: a\n    // trigger during a run never starts a second run, only marks one trailing\n    // rerun after the current settles. Both halves are load-bearing — a plain\n    // debounce once let bursts stack overlapping scans until the heap was\n    // exhausted (observed as an OOM after minutes of looping). The contract is\n    // pinned by test/dev-debounce.test.ts. The task must not reject (the\n    // library re-invokes it from an unhandled .finally), so the body catches\n    // its own errors and always resolves.\n    const regenerate = debounce(async () => {\n      try {\n        const next = await scanProject(root, {\n          devServerUrl,\n          mode: \"dev\",\n          overrides,\n          preview,\n        });\n        const nextSignature = routeSignature(next.manifest.routes);\n        const structural = nextSignature !== lastSignature;\n        // Generate first: the new runtime data (and any staged remote content)\n        // is on disk and published before the store re-syncs against it.\n        await generateRuntime(next);\n        if (structural && !(await refreshBlumeContent())) {\n          await server.stop();\n          server = await createServer(boundPort, false);\n        }\n        // Commit the signature only after the (re)generation succeeded. If the\n        // re-sync or restart above throws mid-sequence, the signature stays\n        // stale so the next watch event retries the structural path.\n        lastSignature = nextSignature;\n        // Surface any content/config errors in the terminal AND the browser\n        // overlay. The terminal report is not redundant: the overlay only\n        // shows once the browser has connected, and it clears on the next HMR\n        // update.\n        reportDiagnostics(next.diagnostics, root);\n        showBlumeErrorOverlay(next.diagnostics);\n      } catch (error) {\n        // A config error the generator raised (an unplannable `components.ts`\n        // override, a missing font file) is a diagnostic: report it in the\n        // terminal and the browser overlay like a scan-time error, so the fix\n        // is visible where the edit happened.\n        if (error instanceof BlumeError) {\n          reportDiagnostics([error.diagnostic], root);\n          showBlumeErrorOverlay([error.diagnostic]);\n          return;\n        }\n        // SAFETY: regeneration failures come from the generator and Astro's\n        // server API, which raise Error instances; only the message is shown.\n        logger.error(`Regeneration failed: ${(error as Error).message}`);\n      }\n    }, 80);\n\n    // The runtime prepared above baked the *requested* port into the site\n    // fallback; if Vite bumped it, regenerate so OG images, canonicals, and\n    // other site-gated URLs point at the port actually serving.\n    if (boundPort !== port) {\n      void regenerate();\n    }\n\n    // Content is watched per source (filesystem uses fs.watch; remote sources\n    // are frozen for the session). The remaining project inputs — user pages,\n    // config, theme, and component overrides — are watched directly.\n    const dirTargets = [project.context.pagesRoot].filter(\n      (target) => target !== null\n    );\n    const fileTargets = [\n      project.context.configFile,\n      project.context.themeFile,\n      project.context.componentsFile,\n    ].filter((target) => target !== null);\n\n    // chokidar handles what raw fs.watch made us hand-roll: recursive\n    // directory watching on every platform, and single files surviving a\n    // rename-replace save (vim and most \"atomic save\" editors), which orphans\n    // an inode-tracking fs.watch watcher after the first write.\n    const projectWatcher = watch([...dirTargets, ...fileTargets], {\n      ignoreInitial: true,\n    }).on(\"all\", regenerate);\n    const disposers = [\n      ...project.sources.map((source) => source.watch?.(regenerate)),\n      () => {\n        void projectWatcher.close();\n      },\n    ].filter((dispose) => dispose !== undefined);\n\n    const shutdown = async () => {\n      for (const dispose of disposers) {\n        dispose();\n      }\n      releaseLock();\n      await server.stop();\n      process.exit(0);\n    };\n\n    process.on(\"SIGINT\", shutdown);\n    process.on(\"SIGTERM\", shutdown);\n  },\n});\n"
+  ],
+  "mappings": "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",
+  "debugId": "DAFEE5DB6B0E8A0164756E2164756E21",
+  "names": []
+}

package/dist/cli/{chunk-5g0w1e2c.js → chunk-kpf8rrjc.js}

@@ -5,23 +5,25 @@ import {
   BlumeError,
   countBySeverity,
   logger,
-  flushStdout
+  flushStdout,
+  reportDiagnostics
 } from "./index.js";
 import {
   AGENTS
-} from "./chunk-0xjyb285.js";
+} from "./chunk-qwsrynx5.js";
 import {
   frontmatter_default,
   i18nEnabled,
   localeCodes,
   localeTargetPath,
+  folderMetaSchema,
   scanBody,
-  scanProject
-} from "./chunk-1jefwnfs.js";
+  createModuleLoader
+} from "./chunk-qkqwkpte.js";
+import"./chunk-jts8mvcz.js";
 import {
-  createModuleLoader,
-  folderMetaSchema
-} from "./chunk-7s8hm3b6.js";
+  scanProject
+} from "./chunk-fs23ddbb.js";
 import {
   seconds,
   money,
@@ -29,7 +31,7 @@ import {
   DISALLOWED_TOOLS,
   runAgentHeadless,
   readAgentOutput
-} from "./chunk-2z47ypj8.js";
+} from "./chunk-fa25z98p.js";
 import {
   writeTextAtomic
 } from "./chunk-jq5n4avg.js";
@@ -197,15 +199,24 @@ var translateSummaryLine = (result, workList) => {
 var diagnosticLines = (diagnostics) => diagnostics.map((diagnostic) => `  ${colors.yellow("⚠")} ${colors.dim(diagnostic.message)}`);
 var driftRows = (workList) => workList.items.flatMap((item) => item.kind === "page" ? [
   {
+    file: item.sourcePath,
     locale: item.locale,
     sourceRel: item.sourceRel,
     status: item.status
   }
 ] : item.entries.map((entry) => ({
+  file: entry.meta.file,
   locale: item.locale,
   sourceRel: entry.meta.sourceRel,
   status: entry.status
 })));
+var driftDiagnostics = (workList) => driftRows(workList).map((row) => ({
+  code: row.status === "missing" ? "BLUME_TRANSLATE_MISSING" : "BLUME_TRANSLATE_STALE",
+  file: row.file,
+  message: row.status === "missing" ? `${row.sourceRel} has no "${row.locale}" translation.` : `The "${row.locale}" translation of ${row.sourceRel} is stale: its source changed since it was translated.`,
+  severity: "error",
+  suggestion: "Run `blume translate --codex` (or `--claude`) to bring the translations up to date."
+}));
 var checkLines = (workList) => [
   ...driftRows(workList).map((row) => `  ${colors.red("✖")} ${row.sourceRel} → ${row.locale} ${colors.dim(row.status)}`),
   ...workList.untracked.map((entry) => `  ${colors.dim(`⊘ ${entry.sourceRel} → ${entry.locale} untracked (adopted by the next translate run)`)}`)
@@ -224,6 +235,7 @@ var checkSummaryLine = (workList) => {
 };
 var hasDrift = (workList) => workList.items.length > 0;
 var checkReportJson = (workList) => {
+  const diagnostics = [...workList.diagnostics, ...driftDiagnostics(workList)];
   const locales = {};
   for (const locale of workList.targetLocales) {
     locales[locale] = { missing: [], stale: [], untracked: [] };
@@ -235,8 +247,8 @@ var checkReportJson = (workList) => {
     locales[entry.locale]?.untracked.push(entry.sourceRel);
   }
   return `${JSON.stringify({
-    diagnostics: workList.diagnostics,
-    summary: countBySeverity(workList.diagnostics),
+    diagnostics,
+    summary: countBySeverity(diagnostics),
     translate: { locales, upToDate: workList.upToDate }
   }, null, 2)}
 `;
@@ -949,15 +961,15 @@ var MAX_CONCURRENCY = 16;
 var parseFlags = (args) => {
   const agents = Object.keys(AGENTS).filter((kind) => args[kind]);
   if (agents.length > 1) {
-    logger.error("Pass exactly one of --claude or --codex.");
+    logger.error("Pass exactly one of --codex or --claude.");
     process.exit(1);
   }
   if (args.check && agents.length > 0) {
-    logger.error("--check is read-only and never runs an agent; drop --claude/--codex.");
+    logger.error("--check is read-only and never runs an agent; drop --codex/--claude.");
     process.exit(1);
   }
   if (!args.check && agents.length === 0) {
-    logger.error("Pass --claude or --codex to choose the agent CLI that translates.");
+    logger.error("Pass --codex or --claude to choose the agent CLI that translates.");
     process.exit(1);
   }
   const timeoutS = args.timeout === undefined ? DEFAULT_TIMEOUT_S : Number(args.timeout);
@@ -1115,7 +1127,7 @@ var translateCommand = defineCommand({
       }
     } catch (error) {
       if (error instanceof BlumeError) {
-        logger.error(error.diagnostic.message);
+        reportDiagnostics([error.diagnostic], root);
         process.exit(1);
       }
       if (error?.code === "ENOENT" && agent) {
@@ -1130,5 +1142,5 @@ export {
   translateCommand
 };
 
-//# debugId=DEFFE7073BCA047464756E2164756E21
-//# sourceMappingURL=chunk-5g0w1e2c.js.map
+//# debugId=E056CB8AC06243D564756E2164756E21
+//# sourceMappingURL=chunk-kpf8rrjc.js.map