feat: restore gateway HMR and add WRN formatting

packages/ai/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/ai",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "description": "Zero-dependency Claude (Anthropic) client for WrNexus apps.",

packages/authz/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/authz",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/cli",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/cli/src/create.ts

@@ -51,7 +51,9 @@ mobile/.expo/
 
 # Editors and operating systems
 .idea/
-.vscode/
+.vscode/*
+!.vscode/settings.json
+!.vscode/extensions.json
 *.swp
 *.swo
 .DS_Store
@@ -132,7 +134,14 @@ const tsconfigRootDir = dirname(fileURLToPath(import.meta.url));
 
 export default tseslint.config(
   {
-    ignores: ["node_modules/**", "dist/**", ".wrnexus/**", "**/.wrnexus/**", "mobile/android/**", "mobile/ios/**"],
+    ignores: [
+      "node_modules/**",
+      "dist/**",
+      ".wrnexus/**",
+      "**/.wrnexus/**",
+      "mobile/android/**",
+      "mobile/ios/**",
+    ],
   },
   {
     languageOptions: {
@@ -187,6 +196,23 @@ indent_style = space
 indent_size = 2
 insert_final_newline = true
 trim_trailing_whitespace = true
+`,
+  ".vscode/settings.json": `{
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  },
+  "prettier.requireConfig": true,
+  "[wrn]": {
+    "editor.defaultFormatter": "wrnexus.wrnexus",
+    "editor.formatOnSave": true
+  }
+}
+`,
+  ".vscode/extensions.json": `{
+  "recommendations": ["wrnexus.wrnexus", "esbenp.prettier-vscode", "dbaeumer.vscode-eslint"]
+}
 `,
   "wrnexus.config.ts": `import type { AppConfig } from "@wrnexus/styles";
 
@@ -274,7 +300,13 @@ Allow: /
 @custom-variant dark (&:where([data-theme="dark"], [data-theme="dark"] *));
 
 body {
-  font-family: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+  font-family:
+    ui-sans-serif,
+    system-ui,
+    -apple-system,
+    "Segoe UI",
+    Roboto,
+    sans-serif;
 }
 `,
   "app/pages/index.wrn": `// Home page (route: /). SSR-first: the view is server-rendered, then components

packages/cli/src/update.ts

@@ -172,6 +172,87 @@ const MIGRATIONS: Migration[] = [
       if (!ctx.dryRun) writeFileSync(file, JSON.stringify(pkg, null, 2) + "\n", "utf8");
     },
   },
+  {
+    version: "0.2.19",
+    id: "vscode-formatting",
+    description: "Add safe VS Code format-on-save defaults and extension recommendations",
+    apply(ctx) {
+      const vscode = join(ctx.appRoot, ".vscode");
+      const settings = join(vscode, "settings.json");
+      const extensions = join(vscode, "extensions.json");
+      const prettierIgnore = join(ctx.appRoot, ".prettierignore");
+      const gitignore = join(ctx.appRoot, ".gitignore");
+
+      const files: Array<[string, string, string]> = [
+        [
+          settings,
+          JSON.stringify(
+            {
+              "editor.defaultFormatter": "esbenp.prettier-vscode",
+              "editor.formatOnSave": true,
+              "editor.codeActionsOnSave": { "source.fixAll.eslint": "explicit" },
+              "prettier.requireConfig": true,
+              "[wrn]": {
+                "editor.defaultFormatter": "wrnexus.wrnexus",
+                "editor.formatOnSave": true,
+              },
+            },
+            null,
+            2,
+          ) + "\n",
+          ".vscode/settings.json",
+        ],
+        [
+          extensions,
+          JSON.stringify(
+            {
+              recommendations: [
+                "wrnexus.wrnexus",
+                "esbenp.prettier-vscode",
+                "dbaeumer.vscode-eslint",
+              ],
+            },
+            null,
+            2,
+          ) + "\n",
+          ".vscode/extensions.json",
+        ],
+      ];
+
+      for (const [file, contents, label] of files) {
+        if (existsSync(file)) continue;
+        ctx.log(`+ ${label}`);
+        if (!ctx.dryRun) {
+          mkdirSync(vscode, { recursive: true });
+          writeFileSync(file, contents, "utf8");
+        }
+      }
+
+      const prettier = existsSync(prettierIgnore) ? readFileSync(prettierIgnore, "utf8") : "";
+      if (!new Set(prettier.split(/\r?\n/).map((line) => line.trim())).has("CLAUDE.md")) {
+        ctx.log("+ .prettierignore: CLAUDE.md");
+        if (!ctx.dryRun) {
+          writeFileSync(prettierIgnore, `${prettier.replace(/\s*$/, "")}\nCLAUDE.md\n`, "utf8");
+        }
+      }
+
+      if (existsSync(gitignore)) {
+        const current = readFileSync(gitignore, "utf8");
+        const lines = current.split(/\r?\n/);
+        const vscodeIgnore = lines.findIndex((line) => line.trim() === ".vscode/");
+        const needed = [".vscode/*", "!.vscode/settings.json", "!.vscode/extensions.json"];
+        if (vscodeIgnore >= 0 || needed.some((entry) => !lines.includes(entry))) {
+          ctx.log("~ .gitignore: track shared VS Code configuration");
+          if (!ctx.dryRun) {
+            const filtered = lines.filter((line) => line.trim() !== ".vscode/");
+            const have = new Set(filtered.map((line) => line.trim()));
+            for (const entry of needed) if (!have.has(entry)) filtered.push(entry);
+            writeFileSync(gitignore, filtered.join("\n").replace(/\n*$/, "\n"), "utf8");
+          }
+        }
+      }
+    },
+  },
 ];
 
 /** Release tooling uses this to require an explicit migration entry per version. */
@@ -246,6 +327,9 @@ function backupProjectFiles(appRoot: string, from: string, target: string): stri
     "wrnexus.config.mjs",
     "tsconfig.json",
     ".gitignore",
+    ".prettierignore",
+    ".vscode/settings.json",
+    ".vscode/extensions.json",
     "CLAUDE.md",
     "public/llms.txt",
   ]) {

packages/cli/test/create.test.ts

@@ -2,6 +2,7 @@ import { expect, test } from "bun:test";
 import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { format } from "prettier";
 import { scaffoldApp } from "../src/create.ts";
 import { currentCliVersion } from "../src/update-notifier.ts";
 
@@ -69,6 +70,15 @@ test("scaffoldApp pins the current framework and exposes llms.txt publicly", ()
     expect(existsSync(join(root, "public", "llms.txt"))).toBe(true);
     expect(existsSync(join(root, "llms.txt"))).toBe(false);
     expect(readFileSync(join(root, ".prettierignore"), "utf8")).toContain("CLAUDE.md");
+    expect(readFileSync(join(root, ".vscode", "settings.json"), "utf8")).toContain(
+      '"editor.formatOnSave": true',
+    );
+    expect(readFileSync(join(root, ".vscode", "settings.json"), "utf8")).toContain(
+      '"editor.defaultFormatter": "wrnexus.wrnexus"',
+    );
+    expect(readFileSync(join(root, ".vscode", "extensions.json"), "utf8")).toContain(
+      "wrnexus.wrnexus",
+    );
     expect(readFileSync(join(root, "app", "pages", "index.wrn"), "utf8")).toContain(
       'href="/api/hello"',
     );
@@ -77,3 +87,34 @@ test("scaffoldApp pins the current framework and exposes llms.txt publicly", ()
     rmSync(parent, { recursive: true, force: true });
   }
 });
+
+test("scaffoldApp emits Prettier-compliant editor and framework files", async () => {
+  const parent = mkdtempSync(join(tmpdir(), "wrnexus-create-"));
+  const root = join(parent, "formatted-app");
+
+  try {
+    scaffoldApp(root, "formatted-app");
+    for (const relative of [
+      "app/styles/global.css",
+      "eslint.config.js",
+      ".vscode/settings.json",
+      ".vscode/extensions.json",
+    ]) {
+      const file = join(root, relative);
+      const source = readFileSync(file, "utf8");
+      const formatted = await format(source, {
+        filepath: file,
+        printWidth: 100,
+        tabWidth: 2,
+        useTabs: false,
+        semi: true,
+        singleQuote: false,
+        trailingComma: "all",
+        endOfLine: "lf",
+      });
+      expect(formatted).toBe(source);
+    }
+  } finally {
+    rmSync(parent, { recursive: true, force: true });
+  }
+});

packages/cli/test/update.test.ts

@@ -61,3 +61,35 @@ test("0.2.18 migration adds helpers to existing apps and is idempotent", () => {
     rmSync(root, { recursive: true, force: true });
   }
 });
+
+test("0.2.19 migration adds VS Code formatting defaults without overwriting settings", () => {
+  const root = mkdtempSync(join(tmpdir(), "wrnexus-update-"));
+  mkdirSync(join(root, "app", "pages"), { recursive: true });
+  mkdirSync(join(root, ".vscode"), { recursive: true });
+  writeFileSync(
+    join(root, "package.json"),
+    JSON.stringify({ name: "editor-app", wrnexus: { version: "0.2.18" } }),
+  );
+  writeFileSync(join(root, ".gitignore"), ".vscode/\n");
+  writeFileSync(join(root, ".prettierignore"), "node_modules/\n");
+  writeFileSync(join(root, ".vscode", "settings.json"), '{"editor.tabSize":4}\n');
+
+  try {
+    updateApp(root, "0.2.19", false);
+    updateApp(root, "0.2.19", false);
+
+    expect(readFileSync(join(root, ".vscode", "settings.json"), "utf8")).toBe(
+      '{"editor.tabSize":4}\n',
+    );
+    expect(readFileSync(join(root, ".vscode", "extensions.json"), "utf8")).toContain(
+      "wrnexus.wrnexus",
+    );
+    expect(readFileSync(join(root, ".prettierignore"), "utf8")).toBe("node_modules/\nCLAUDE.md\n");
+    const gitignore = readFileSync(join(root, ".gitignore"), "utf8");
+    expect(gitignore).not.toContain(".vscode/\n");
+    expect(gitignore).toContain("!.vscode/settings.json");
+    expect(gitignore).toContain("!.vscode/extensions.json");
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});

packages/compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/compiler",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/core",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/csr/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/csr",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/db/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/db",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/dev-server/README.md

@@ -142,7 +142,7 @@ interface ProdOptions {
 
 ### `startGateway(opts)` — multi-app gateway
 
-Serves several apps behind one port and routes each request to the right app by its `Host` header. Each app runs as its own child process (full isolation); the gateway is a thin host-based reverse proxy for HTTP and WebSocket. Apps communicate at runtime via `@wrnexus/pubsub` (use the Redis driver so messages cross processes).
+Serves several apps behind one port and routes each request to the right app by its `Host` header. Each app runs as its own child process (full isolation); the gateway is a thin host-based reverse proxy for HTTP and WebSocket. In development, the gateway supervises every child: editing a page, component, API, or middleware restarts only that app and the HMR client reconnects to display the latest page. Apps communicate at runtime via `@wrnexus/pubsub` (use the Redis driver so messages cross processes).
 
 ```ts
 interface GatewayOptions {

packages/dev-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/dev-server",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/dev-server/src/gateway.ts

@@ -12,6 +12,7 @@
 import { spawn, type ChildProcess } from "node:child_process";
 import { join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { RESTART_EXIT_CODE } from "./restart.ts";
 
 /** Per-app access control, enforced at the gateway before proxying. */
 export interface GatewayAuth {
@@ -71,7 +72,7 @@ export interface RunningGateway {
 interface Target extends GatewayApp {
   port: number;
   origin: string;
-  child: ChildProcess;
+  child?: ChildProcess;
 }
 
 interface WsBridge {
@@ -81,6 +82,18 @@ interface WsBridge {
   queue: (string | ArrayBufferLike | ArrayBufferView)[];
 }
 
+/** Decide whether a gateway child should be relaunched after it exits. */
+export function gatewayRestartDelay(
+  mode: "development" | "production",
+  code: number | null,
+  signal: NodeJS.Signals | null,
+): number | null {
+  if (mode !== "development" || signal) return null;
+  if (code === RESTART_EXIT_CODE) return 0;
+  if (code && code !== 0) return 1200;
+  return null;
+}
+
 /** Fixed-window rate limiter keyed by client IP. */
 function makeRateLimiter(max: number, windowMs: number) {
   const hits = new Map<string, { count: number; reset: number }>();
@@ -196,9 +209,9 @@ function applyEdgeHeaders(res: Response): Response {
 async function waitReady(target: Target, timeoutMs = 15000): Promise<void> {
   const deadline = Date.now() + timeoutMs;
   for (;;) {
-    if (target.child.exitCode !== null) {
+    if (!target.child || target.child.exitCode !== null) {
       throw new Error(
-        `app '${target.name}' exited with code ${target.child.exitCode} during startup`,
+        `app '${target.name}' exited with code ${target.child?.exitCode ?? "unknown"} during startup`,
       );
     }
     try {
@@ -245,28 +258,52 @@ export async function startGateway(opts: GatewayOptions): Promise<RunningGateway
   const displayHost = hostname === "0.0.0.0" || hostname === "::" ? "localhost" : hostname;
   const serveEntry = fileURLToPath(import.meta.resolve("@wrnexus/dev-server/serve-entry"));
 
+  let stopping = false;
   const targets: Target[] = opts.apps.map((app, i) => {
     const appPort = app.port ?? port + 1 + i;
     const dir = resolve(app.dir);
-    const child =
-      mode === "production"
-        ? spawn(process.execPath, [join(dir, "dist", "server.js")], {
-            stdio: "inherit",
-            env: { ...process.env, PORT: String(appPort) },
-          })
-        : spawn(
-            process.execPath,
-            [serveEntry, join(dir, "app"), String(appPort), mode, "127.0.0.1"],
-            {
+    const target: Target = {
+      ...app,
+      port: appPort,
+      origin: `http://127.0.0.1:${appPort}`,
+    };
+
+    const launch = (): void => {
+      if (stopping) return;
+      const child =
+        mode === "production"
+          ? spawn(process.execPath, [join(dir, "dist", "server.js")], {
               stdio: "inherit",
-            },
-          );
-    return { ...app, port: appPort, origin: `http://127.0.0.1:${appPort}`, child };
+              env: { ...process.env, PORT: String(appPort) },
+            })
+          : spawn(
+              process.execPath,
+              [serveEntry, join(dir, "app"), String(appPort), mode, "127.0.0.1"],
+              { stdio: "inherit" },
+            );
+      target.child = child;
+
+      child.once("exit", (code, signal) => {
+        if (stopping || target.child !== child) return;
+        const delay = gatewayRestartDelay(mode, code, signal);
+        if (delay === null) return;
+        if (delay > 0) {
+          console.error(`[wrnexus] app '${target.name}' exited (code ${code}); retrying in 1.2s…`);
+          setTimeout(launch, delay);
+        } else {
+          launch();
+        }
+      });
+    };
+
+    launch();
+    return target;
   });
 
   const stopChildren = () => {
+    stopping = true;
     for (const target of targets) {
-      if (target.child.exitCode === null) target.child.kill();
+      if (target.child?.exitCode === null) target.child.kill();
     }
   };
 

packages/dev-server/src/index.ts

@@ -28,9 +28,9 @@ import { createHandlers, type WsData } from "./runtime.ts";
 import { createDevAssetServer } from "./assets.ts";
 import { HmrHub } from "./hmr.ts";
 import { startWatcher } from "./watch.ts";
+import { RESTART_EXIT_CODE } from "./restart.ts";
 
-/** Exit code the child uses to ask the dev supervisor for a fresh process. */
-export const RESTART_EXIT_CODE = 97;
+export { RESTART_EXIT_CODE } from "./restart.ts";
 
 export interface ServeOptions {
   appDir: string;

packages/dev-server/src/restart.ts

@@ -0,0 +1,2 @@
+/** Exit code a dev-server child uses to request a clean supervisor restart. */
+export const RESTART_EXIT_CODE = 97;

packages/dev-server/test/gateway.test.ts

@@ -4,6 +4,7 @@ import {
   forwardAuthFailure,
   forwardAuthHeaders,
   gatewayProxyHeaders,
+  gatewayRestartDelay,
 } from "../src/gateway.ts";
 
 test("gateway uses platform-safe hostname defaults", () => {
@@ -56,3 +57,11 @@ test("forward auth describes the original gateway request", () => {
   expect(headers.get("cookie")).toBe("session=abc");
   expect(headers.get("authorization")).toBe("Bearer token");
 });
+
+test("gateway respawns development apps after an HMR restart exit", () => {
+  expect(gatewayRestartDelay("development", 97, null)).toBe(0);
+  expect(gatewayRestartDelay("development", 1, null)).toBe(1200);
+  expect(gatewayRestartDelay("development", 0, null)).toBeNull();
+  expect(gatewayRestartDelay("development", 97, "SIGTERM")).toBeNull();
+  expect(gatewayRestartDelay("production", 97, null)).toBeNull();
+});

packages/encryption/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/encryption",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/helpers/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/helpers",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "description": "Safe convenience helpers for WrNexus request contexts and common application flows.",

packages/i18n/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/i18n",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/jwt/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/jwt",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/mobile/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/mobile",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/native/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/native",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/oauth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/oauth",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/pubsub/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/pubsub",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/queue/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/queue",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/reactive/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/reactive",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/router/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/router",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/ssr/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/ssr",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/styles/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/styles",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/test/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/test",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/tracking/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/tracking",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/ui",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/uploader/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/uploader",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/validation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/validation",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "private": true,
   "type": "module",
   "main": "src/index.ts",