@b9g/shovel 0.2.7 → 0.2.9

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to Shovel will be documented in this file.
 
+## [0.2.8] - 2026-02-10
+
+### Bug Fixes
+
+- **Config file watching during develop** - `shovel.json` and `package.json` changes are now correctly detected during `shovel develop`. The previous `fs.watch()` approach broke on atomic saves (most editors write to a temp file then rename). Now uses esbuild's native `watchFiles` mechanism which handles this correctly. ([#59](https://github.com/bikeshaving/shovel/issues/59))
+
+### Features
+
+- **Dev server keyboard shortcuts** - `Ctrl+R` (reload), `Ctrl+L` (clear), `Ctrl+C` (quit), `?` (help) shortcuts in the dev server terminal. Only active when stdin is a TTY. ([#60](https://github.com/bikeshaving/shovel/issues/60))
+
 ## [0.2.7] - 2026-02-06
 
 ### Features

package/bin/cli.js

@@ -75,7 +75,7 @@ program.command("develop <entrypoint>").description("Start development server wi
   DEFAULTS.WORKERS
 ).option("--platform <name>", "Runtime platform (node, cloudflare, bun)").action(async (entrypoint, options) => {
   checkPlatformReexec(options);
-  const { developCommand } = await import("../src/_chunks/develop-JUQG2G7M.js");
+  const { developCommand } = await import("../src/_chunks/develop-N265AMEN.js");
   await developCommand(entrypoint, options, config);
 });
 program.command("create [name]").description("Create a new Shovel project").action(async (name) => {
@@ -91,7 +91,7 @@ program.command("build <entrypoint>").description("Build app for production").op
   "Run ServiceWorker lifecycle after build (install or activate, default: activate)"
 ).action(async (entrypoint, options) => {
   checkPlatformReexec(options);
-  const { buildCommand } = await import("../src/_chunks/build-KBQU2OA7.js");
+  const { buildCommand } = await import("../src/_chunks/build-O5LLUOND.js");
   await buildCommand(entrypoint, options, config);
   process.exit(0);
 });

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@b9g/shovel",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "ServiceWorker-first universal deployment platform. Write ServiceWorker apps once, deploy anywhere (Node/Bun/Cloudflare). Registry-based multi-app orchestration.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/bikeshaving/shovel.git"
+    "url": "git+https://github.com/bikeshaving/shovel.git"
   },
   "bin": {
     "shovel": "bin/cli.js",
@@ -16,17 +16,17 @@
   "dependencies": {
     "@b9g/async-context": "^0.2.1",
     "@b9g/cache": "^0.2.2",
-    "@b9g/filesystem": "^0.1.10",
+    "@b9g/filesystem": "^0.2.0",
     "@b9g/http-errors": "^0.2.1",
     "@b9g/node-webworker": "^0.2.1",
     "@b9g/platform": "^0.1.17",
-    "@b9g/platform-bun": "^0.1.15",
+    "@b9g/platform-bun": "^0.1.16",
     "@b9g/platform-cloudflare": "^0.1.15",
     "@b9g/platform-node": "^0.1.17",
     "@clack/prompts": "^0.7.0",
     "@esbuild-plugins/node-globals-polyfill": "^0.2.3",
     "@esbuild-plugins/node-modules-polyfill": "^0.2.2",
-    "@logtape/logtape": "^1.2.0",
+    "@logtape/logtape": "^2.0.0",
     "commander": "^13.1.0",
     "esbuild": "^0.27.2",
     "mime": "^4.0.4",
@@ -37,7 +37,7 @@
     "@b9g/crank": "^0.7.2",
     "@b9g/libuild": "^0.1.22",
     "@b9g/router": "^0.2.2",
-    "@logtape/file": "^1.0.0",
+    "@logtape/file": "^2.0.0",
     "@types/bun": "^1.3.4",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",

package/src/_chunks/{build-KBQU2OA7.js → build-O5LLUOND.js}

@@ -1,7 +1,7 @@
 import {
   ServerBundler,
   loadPlatformModule
-} from "./chunk-ABGHNBNM.js";
+} from "./chunk-DQDUKJQ4.js";
 import {
   findProjectRoot,
   findWorkspaceRoot

package/src/_chunks/{chunk-ABGHNBNM.js → chunk-DQDUKJQ4.js}

@@ -448,10 +448,15 @@ function createConfigPlugin(projectRoot, outDir = "dist", options = {}) {
           const typesPath = join2(serverOutDir, "shovel.d.ts");
           writeFileSync2(typesPath, typesCode);
         }
+        const watchFiles = [
+          join2(projectRoot, "shovel.json"),
+          join2(projectRoot, "package.json")
+        ];
         return {
           contents: configModuleCode,
           loader: "js",
-          resolveDir: projectRoot
+          resolveDir: projectRoot,
+          watchFiles
         };
       });
     }
@@ -720,7 +725,6 @@ var ServerBundler = class {
   #initialBuildComplete;
   #initialBuildResolve;
   #currentOutputs;
-  #configWatchers;
   #dirWatchers;
   #userEntryPath;
   #watchOptions;
@@ -732,7 +736,6 @@ var ServerBundler = class {
     this.#projectRoot = findProjectRoot();
     this.#initialBuildComplete = false;
     this.#currentOutputs = { worker: "" };
-    this.#configWatchers = [];
     this.#dirWatchers = /* @__PURE__ */ new Map();
     this.#userEntryPath = "";
     this.#changedFiles = /* @__PURE__ */ new Set();
@@ -798,9 +801,18 @@ var ServerBundler = class {
     this.#ctx = await ESBuild2.context(buildOptions);
     logger3.debug("Starting esbuild watch mode");
     await this.#ctx.watch();
-    this.#watchConfigFiles();
     return initialBuildPromise;
   }
+  /**
+   * Trigger an immediate rebuild.
+   * Only works in watch mode (after calling watch()).
+   */
+  async rebuild() {
+    if (!this.#ctx) {
+      throw new Error("Cannot rebuild: bundler is not in watch mode");
+    }
+    await this.#ctx.rebuild();
+  }
   /**
    * Stop watching and dispose of resources.
    */
@@ -809,10 +821,6 @@ var ServerBundler = class {
       clearTimeout(this.#rebuildTimeout);
       this.#rebuildTimeout = void 0;
     }
-    for (const watcher of this.#configWatchers) {
-      watcher.close();
-    }
-    this.#configWatchers = [];
     for (const entry of this.#dirWatchers.values()) {
       entry.watcher.close();
     }
@@ -1123,30 +1131,6 @@ These modules are not bundled and won't be available at runtime.`
       }
     }
   }
-  /**
-   * Watch config files for changes.
-   */
-  #watchConfigFiles() {
-    const configFiles = ["shovel.json", "package.json"];
-    for (const filename of configFiles) {
-      const filepath = join5(this.#projectRoot, filename);
-      if (!existsSync4(filepath))
-        continue;
-      try {
-        const watcher = watch(filepath, { persistent: false }, (event) => {
-          if (event === "change") {
-            this.#scheduleRebuild(filepath);
-          }
-        });
-        this.#configWatchers.push(watcher);
-      } catch (err) {
-        logger3.warn("Failed to watch {file}: {error}", {
-          file: filename,
-          error: err
-        });
-      }
-    }
-  }
   /**
    * Update source file watchers from metafile.
    */

package/src/_chunks/{develop-JUQG2G7M.js → develop-N265AMEN.js}

@@ -1,7 +1,7 @@
 import {
   ServerBundler,
   loadPlatformModule
-} from "./chunk-ABGHNBNM.js";
+} from "./chunk-DQDUKJQ4.js";
 import {
   DEFAULTS
 } from "./chunk-7GONPLNW.js";
@@ -10,6 +10,7 @@ import {
 import { getLogger } from "@logtape/logtape";
 import { resolvePlatform } from "@b9g/platform";
 import { networkInterfaces } from "os";
+import { exec } from "child_process";
 var logger = getLogger(["shovel", "develop"]);
 function getDisplayUrls(host, port) {
   const urls = {
@@ -56,6 +57,8 @@ async function developCommand(entrypoint, options, config) {
     const platformModule = await loadPlatformModule(platformName);
     const platformESBuildConfig = platformModule.getESBuildConfig();
     let devServer = null;
+    const localUrl = `http://localhost:${port}`;
+    const SHORTCUTS_HELP = "Ctrl+R (reload) Ctrl+O (open) Ctrl+C (quit) ? (help)";
     const startOrReloadServer = async (workerPath) => {
       if (!devServer) {
         devServer = await platformModule.createDevServer({
@@ -73,6 +76,9 @@ async function developCommand(entrypoint, options, config) {
         } else {
           logger.info("Server running at {url}", { url: urls.local });
         }
+        if (process.stdin.isTTY) {
+          logger.info(SHORTCUTS_HELP);
+        }
       } else {
         await devServer.reload(workerPath);
       }
@@ -109,6 +115,56 @@ async function developCommand(entrypoint, options, config) {
     };
     process.on("SIGINT", () => shutdown("SIGINT"));
     process.on("SIGTERM", () => shutdown("SIGTERM"));
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+      process.stdin.resume();
+      process.stdin.setEncoding("utf8");
+      process.on("SIGCONT", () => {
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+      });
+      process.stdin.on("data", async (key) => {
+        switch (key) {
+          case "":
+            logger.info("Manual reload...");
+            await bundler.rebuild();
+            break;
+          case "\f":
+            console.clear();
+            break;
+          case "":
+            await shutdown("SIGINT");
+            break;
+          case "":
+            process.stdin.setRawMode(false);
+            process.kill(process.pid, "SIGTSTP");
+            break;
+          case "":
+            await shutdown("SIGQUIT");
+            break;
+          case "":
+            await shutdown("SIGINT");
+            break;
+          case "": {
+            const cmd = process.platform === "win32" ? "start" : process.platform === "darwin" ? "open" : "xdg-open";
+            exec(`${cmd} ${localUrl}`);
+            break;
+          }
+          case "\r":
+            process.stdout.write("\n");
+            break;
+          case "\x7F":
+            process.stdout.write("\b \b");
+            break;
+          case "?":
+            logger.info(SHORTCUTS_HELP);
+            break;
+          default:
+            process.stdout.write(key);
+            break;
+        }
+      });
+    }
     await new Promise(() => {
     });
   } catch (error) {