nowaki 0.15.0 → 0.16.1

package/README.md

@@ -31,6 +31,43 @@ nowaki prerender [dir]    # Static site generation (SSG)
 
 Scaffold a new app with `npm create nowaki@latest my-app`.
 
+### First-load JS per route
+
+`nowaki build` (and `nowaki prerender`) prints the gzip size of the JS each page route loads
+first: the islands runtime and the islands the page can render, through its layouts and
+components, plus the live runtime for live islands. The lazy SPA router chunk is not counted.
+The same data goes to `dist/route-js.json`.
+
+A route can set a budget in KB. The build **fails** when the route goes over it:
+
+```tsx
+export const budget = { js: 12 };   // at most 12 KB of gzip JS on first load
+export const budget = { js: 0 };    // a content page: no client JS at all
+```
+
+The value must be a number literal. An unreadable `budget` fails the build instead of being
+ignored.
+
+### MCP for coding agents
+
+While `nowaki dev` runs, it serves a read-only [MCP](https://modelcontextprotocol.io)
+endpoint at `http://127.0.0.1:<port>/__nowaki/mcp`; the startup banner prints it.
+Add it to Claude Code with:
+
+```bash
+claude mcp add --transport http nowaki http://127.0.0.1:3000/__nowaki/mcp
+```
+
+Tools:
+
+- `routes`: the route table in match order (pattern, file, page/API, exports such as `revalidate` and `csrf`), plus layouts, middleware, and boundaries
+- `module_graph`: what a file imports and which files import it, and the islands with their `live` flag
+- `recent_errors`: the last 50 build, SSR, live, and HMR errors, with time, file, and stack
+- `dev_config`: port, `--host`, plugins, `NOWAKI_*` flags, and Jetstream connections and rooms
+
+The endpoint answers only requests from this machine (loopback peer, `Host`, and
+`Origin`), even with `--host`. `nowaki start` and the deploy adapters don't serve it.
+
 ## How it works
 
 The native binary is distributed as platform-specific optional dependencies

package/bin/nowaki.js

@@ -1,8 +1,12 @@
 #!/usr/bin/env node
 "use strict";
 
-// Forwards args and stdio unchanged to the prebuilt Rust nowaki binary.
-// No postinstall: the platform package is resolved and exec'd at runtime.
+// Runs the prebuilt Rust nowaki binary with the same args, env, and stdio.
+// No postinstall: the platform package is resolved at runtime.
+//
+// On Unix the Node process is replaced by the binary (process.execve, Node >= 22.15 / 23.11),
+// so no Node process stays resident next to `nowaki start` (about 45 MB, #91) and signals reach
+// the binary directly. Elsewhere (Windows, older Node) it falls back to a child process.
 
 const { spawnSync } = require("node:child_process");
 const { resolveBinary } = require("../lib/resolve.js");
@@ -15,7 +19,17 @@ try {
   process.exit(1);
 }
 
-const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+const args = process.argv.slice(2);
+
+if (typeof process.execve === "function" && process.platform !== "win32") {
+  try {
+    process.execve(binary, [binary, ...args], process.env); // does not return on success
+  } catch {
+    // e.g. a noexec mount: fall through to spawnSync, which reports its own error
+  }
+}
+
+const result = spawnSync(binary, args, { stdio: "inherit" });
 
 if (result.error) {
   console.error(`[nowaki] failed to launch the binary: ${result.error.message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nowaki",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "description": "The Nowaki CLI — Rust-powered bundler, dev server, and SSG for the Nowaki web framework",
   "license": "MIT",
   "author": "Tettu0530",
@@ -28,11 +28,11 @@
     "lib/"
   ],
   "optionalDependencies": {
-    "@nowaki-dev/cli-darwin-arm64": "0.15.0",
-    "@nowaki-dev/cli-darwin-x64": "0.15.0",
-    "@nowaki-dev/cli-linux-x64-gnu": "0.15.0",
-    "@nowaki-dev/cli-linux-arm64-gnu": "0.15.0",
-    "@nowaki-dev/cli-win32-x64": "0.15.0"
+    "@nowaki-dev/cli-darwin-arm64": "0.16.1",
+    "@nowaki-dev/cli-darwin-x64": "0.16.1",
+    "@nowaki-dev/cli-linux-x64-gnu": "0.16.1",
+    "@nowaki-dev/cli-linux-arm64-gnu": "0.16.1",
+    "@nowaki-dev/cli-win32-x64": "0.16.1"
   },
   "engines": {
     "node": ">=22"