runtime-exceptions.json

{
  "$comment": "Scripts that must run on the Node runtime instead of Bun (D-003, R-051). Checked by scripts/check-runtime.ts.",
  "node": [
    {
      "script": "demos/node#dev",
      "reason": "On macOS, Bun emits both add and change for Astro's new .astro/settings.json during the initial update check. The second event restarts the server during startup, which crashes at server.address.port.",
      "evidence": "Reproduced with Bun 1.4.2, Astro 7.3.5 and EmDash 1.2.0 on macOS arm64. Node 24.21.0 starts successfully with a fresh .astro directory."
    },
    {
      "script": "demos/cloudflare#dev",
      "reason": "Cloudflare's Vite plugin (miniflare) crashes under the Bun runtime: `this.#runtimeDispatcher?.close is not a function`.",
      "evidence": "spike S0-3"
    },
    {
      "script": "demos/cloudflare#start",
      "reason": "`wrangler dev` prints Ready under the Bun runtime but every request hangs.",
      "evidence": "spike S0-3"
    },
    {
      "script": ".#e2e",
      "reason": "Under `bun --bun`, child processes see Bun as `node`, so Playwright's Cloudflare web server (`astro dev`) crashes the same way as S0-3. The runner and both demo dev servers stay on Node.",
      "evidence": "W-003 (miniflare `this.#runtimeDispatcher?.close is not a function` under `bun --bun playwright test`)"
    },
    {
      "script": ".#e2e:prod",
      "reason": "Same as `.#e2e`: the runner starts the Cloudflare dev server and `wrangler dev`, which crash or hang under the Bun runtime (S0-3). The Node demo's production server still runs on Bun.",
      "evidence": "W-003, spike S0-3"
    }
  ]
}