create-nwire 0.13.0 → 0.13.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nwire",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "description": "Scaffolder for new Nwire projects. Run `pnpm create nwire <name>` or `npm create nwire <name>` to bootstrap.",
   "keywords": [
     "nwire",

package/templates/enterprise/README.md

@@ -16,19 +16,24 @@ pnpm dev
 
 ## Try
 
+`pnpm dev` serves the wire + Studio on http://localhost:4000.
+
 ```bash
 # submit a post (becomes pending, auto-moderation triggers)
-curl -X POST http://localhost:3000/api/posts \
+curl -X POST http://localhost:4000/api/posts \
   -H "content-type: application/json" \
   -d '{"authorId":"alice","body":"Hello, world!"}'
 
-# read the dashboard projection
-curl http://localhost:3000/api/queue
+# read the dashboard projection — copy a pending postId from here
+curl http://localhost:4000/api/queue
 
-# decide a borderline one manually
-curl -X POST http://localhost:3000/api/posts/<id>/approve \
+# decide one manually (paste the postId from /api/queue above)
+curl -X POST http://localhost:4000/api/posts/<postId>/approve \
   -H "content-type: application/json" \
   -d '{"moderatorId":"miri"}'
+
+# all posts by an author, across statuses
+curl "http://localhost:4000/api/posts/by-author?authorId=alice"
 ```
 
 ## Test
@@ -42,8 +47,8 @@ pnpm test
 ```
 {{PROJECT_NAME}}/
 ├── app/
-│   ├── main.ts                              ← endpoint + app.start + run
-│   ├── api.ts                               ← httpInterface — wires every route
+│   ├── main.ts                              ← endpoint().use(httpKoa()).mount(app).run()
+│   ├── api.ts                               ← wires[] — every route + handler pair
 │   └── app.ts                               ← createApp({ modules: [...] })
 ├── modules/
 │   └── posts/                               ← bounded context: posts moderation
@@ -90,11 +95,11 @@ actor (`defineActor`) versus a direct DB write inside a handler.
 
 ## Studio
 
-`api.inspect(app)` mounts the `/_nwire/*` introspection surface. Point
-Studio at this app:
+`pnpm dev` already serves Studio alongside the wire on http://localhost:4000.
+For the standalone Studio process (multi-project shell, process manager):
 
 ```bash
-npx -p @nwire/cli nwire studio
+pnpm studio
 ```
 
 You'll get live traces, action / event / workflow browsers, projection

package/templates/enterprise/app/api.ts

@@ -18,6 +18,8 @@ export const wires = [
   { binding: approvePostRoute, handler: approvePostHandler },
   { binding: rejectPostRoute, handler: rejectPostHandler },
   { binding: listQueueRoute, handler: listQueueHandler },
-  { binding: getPostRoute, handler: getPostHandler },
+  // Literal `/posts/by-author` must be wired before the `/posts/:postId`
+  // param route — otherwise `:postId` captures "by-author" and shadows it.
   { binding: postsByAuthorRoute, handler: postsByAuthorHandler },
+  { binding: getPostRoute, handler: getPostHandler },
 ] as const;

package/templates/enterprise/app/main.ts

@@ -1,12 +1,12 @@
 /**
  * Entry — the only file that boots a real HTTP server.
  *
- *   pnpm dev
+ *   pnpm dev   # wire + Studio on http://localhost:4000
  *
- *   curl -X POST http://localhost:3000/api/posts \
+ *   curl -X POST http://localhost:4000/api/posts \
  *        -H "content-type: application/json" \
  *        -d '{"authorId":"alice","body":"Hello, world!"}'
- *   curl http://localhost:3000/api/queue
+ *   curl http://localhost:4000/api/queue
  *
  * `app` is a pure value — routes are wired in `./app` on import.
  * This file adds the one side effect: binding a port and serving traffic.

package/templates/enterprise/modules/posts/projections/queue-dashboard.ts

@@ -74,7 +74,10 @@ export const queueDashboard = defineProjection<QueueState>(
 
     when(PostWasApproved, (state, event) => {
       const item = state.byId[event.postId];
-      if (!item) return state;
+      // Only a pending post transitions. Re-applying a decision (a duplicate
+      // event, or an approve after a reject) must be a no-op — otherwise the
+      // pending counter is decremented twice and the totals drift negative.
+      if (!item || item.status !== "pending") return state;
       return {
         byId: {
           ...state.byId,
@@ -96,7 +99,9 @@ export const queueDashboard = defineProjection<QueueState>(
 
     when(PostWasRejected, (state, event) => {
       const item = state.byId[event.postId];
-      if (!item) return state;
+      // Same idempotency guard as approve: a post that already left the queue
+      // must not decrement `pending` a second time.
+      if (!item || item.status !== "pending") return state;
       return {
         byId: {
           ...state.byId,

package/templates/enterprise/package.json

@@ -11,17 +11,17 @@
     "cache": "nwire cache"
   },
   "dependencies": {
-    "@nwire/app": "^0.13.0",
-    "@nwire/endpoint": "^0.13.0",
-    "@nwire/forge": "^0.13.0",
-    "@nwire/koa": "^0.13.0",
-    "@nwire/messages": "^0.13.0",
-    "@nwire/wires": "^0.13.0",
+    "@nwire/app": "^0.13.1",
+    "@nwire/endpoint": "^0.13.1",
+    "@nwire/forge": "^0.13.1",
+    "@nwire/koa": "^0.13.1",
+    "@nwire/messages": "^0.13.1",
+    "@nwire/wires": "^0.13.1",
     "zod": "^4.0.0"
   },
   "devDependencies": {
-    "@nwire/cli": "^0.13.0",
-    "@nwire/test-kit": "^0.13.0",
+    "@nwire/cli": "^0.13.1",
+    "@nwire/test-kit": "^0.13.1",
     "@types/node": "^22.19.9",
     "typescript": "^5.9.0",
     "vitest": "^4.0.18"

package/templates/mcp/_pnpm-workspace.yaml

@@ -1,6 +1,12 @@
-# pnpm 11 reads build-allow + run settings here (not the package.json
-# "pnpm" field). esbuild backs vite-node; allow its build, and skip the
+# pnpm reads build-allow + run settings here (not the package.json "pnpm"
+# field). This server runs TypeScript via tsx, which pulls esbuild — a
+# dependency with a build script. pnpm gates build scripts: without an
+# explicit decision it writes an `allowBuilds` stub and exits non-zero on
+# the very first `pnpm install`. Pre-approve esbuild here so install is
+# clean out of the box. `onlyBuiltDependencies` covers older pnpm; skip the
 # pre-run deps check so `pnpm dev` runs clean right after install.
+allowBuilds:
+  esbuild: true
 onlyBuiltDependencies:
   - esbuild
 verifyDepsBeforeRun: false

package/templates/mcp/package.json

@@ -10,10 +10,10 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@nwire/app": "^0.13.0",
-    "@nwire/endpoint": "^0.13.0",
-    "@nwire/mcp": "^0.13.0",
-    "@nwire/wires": "^0.13.0",
+    "@nwire/app": "^0.13.1",
+    "@nwire/endpoint": "^0.13.1",
+    "@nwire/mcp": "^0.13.1",
+    "@nwire/wires": "^0.13.1",
     "zod": "^4.0.0"
   },
   "devDependencies": {

package/templates/minimal/AGENTS.md

@@ -9,12 +9,19 @@ handler never knows which transport called it.
 ```ts
 import { createApp } from "@nwire/app";
 import { endpoint } from "@nwire/endpoint";
-import { get } from "@nwire/wires/http";
+import { post } from "@nwire/wires/http";
 import { httpKoa } from "@nwire/koa";
+import { z } from "zod";
 
 const app = createApp({ appName: "app" });
-app.wire(get("/hello"), async () => ({ message: "hello" }));
-await endpoint("app", { port: 3000 }).use(httpKoa()).mount(app).run();
+// The route declares its schema; the handler receives the validated input.
+app.wire(post("/hello", { body: z.object({ name: z.string().min(1) }) }), async (input) => ({
+  message: `Hello, ${input.name}!`,
+}));
+await endpoint("app", { port: Number(process.env.PORT) || 3000 })
+  .use(httpKoa())
+  .mount(app)
+  .run();
 ```
 
 ## What's installed (don't import beyond these)
@@ -33,5 +40,5 @@ This tier is HTTP-only. Add capabilities by installing the package first:
 
 ## Commands
 
-- `pnpm dev` — run the app (HTTP on :3000). `pnpm test` — tests.
+- `pnpm dev` — wire + Studio on http://localhost:4000. `pnpm test` — tests.
 - `pnpm doctor` — health-check the setup. `pnpm studio` — trace console.

package/templates/minimal/README.md

@@ -16,8 +16,10 @@ pnpm dev
 
 ## Try
 
+`pnpm dev` serves the wire + Studio on http://localhost:4000.
+
 ```bash
-curl -X POST http://localhost:3000/hello \
+curl -X POST http://localhost:4000/hello \
   -H "content-type: application/json" \
   -d '{"name":"Alice"}'
 ```
@@ -33,8 +35,9 @@ pnpm test
 ```
 {{PROJECT_NAME}}/
 ├── app/
-│   ├── main.ts            ← endpoint().serve(api).run()
-│   ├── api.ts             ← httpInterface().wire(route, handler)
+│   ├── main.ts            ← endpoint().use(httpKoa()).mount(app).run()
+│   ├── app.ts             ← createApp().wire(...) — the app value
+│   ├── api.ts             ← wires[] (route + handler pairs)
 │   └── routes/
 │       └── hello.ts       ← POST /hello — route + handler pair
 └── __tests__/
@@ -51,13 +54,20 @@ pnpm test
 
 ## What you get free
 
-| Feature                                | Comes from        |
-| -------------------------------------- | ----------------- |
-| Zod request validation                 | `@nwire/http`     |
-| OpenAPI schema (visit `/openapi.json`) | `@nwire/http`     |
-| Scalar UI docs (visit `/docs`)         | `@nwire/http`     |
-| Graceful SIGTERM drain                 | `@nwire/endpoint` |
-| K8s probes on port 9400                | `@nwire/endpoint` |
+| Feature                              | Comes from        |
+| ------------------------------------ | ----------------- |
+| Zod request validation               | `@nwire/koa`      |
+| Graceful SIGTERM drain               | `@nwire/endpoint` |
+| K8s probes (port 9400/`$PROBE_PORT`) | `@nwire/endpoint` |
+
+OpenAPI + Scalar docs are one opt-in away — pass them to the transport:
+
+```ts
+endpoint("{{PROJECT_NAME}}")
+  .use(httpKoa({ openapi: { auto: true }, docs: true })) // /openapi.json + /docs
+  .mount(app)
+  .run();
+```
 
 ## Grow up
 

package/templates/minimal/app/main.ts

@@ -1,9 +1,9 @@
 /**
  * Entry — the only file that boots a real HTTP server.
  *
- *   pnpm dev
+ *   pnpm dev   # wire + Studio on http://localhost:4000
  *
- *   curl -X POST http://localhost:3000/hello \
+ *   curl -X POST http://localhost:4000/hello \
  *        -H "content-type: application/json" \
  *        -d '{"name":"Alice"}'
  *
@@ -18,4 +18,7 @@ import { endpoint } from "@nwire/endpoint";
 import { httpKoa } from "@nwire/koa";
 import { app } from "./app";
 
-await endpoint("{{PROJECT_NAME}}", { port: 3000 }).use(httpKoa()).mount(app).run();
+await endpoint("{{PROJECT_NAME}}", { port: Number(process.env.PORT) || 3000 })
+  .use(httpKoa())
+  .mount(app)
+  .run();

package/templates/minimal/package.json

@@ -11,14 +11,14 @@
     "cache": "nwire cache"
   },
   "dependencies": {
-    "@nwire/app": "^0.13.0",
-    "@nwire/endpoint": "^0.13.0",
-    "@nwire/koa": "^0.13.0",
-    "@nwire/wires": "^0.13.0",
+    "@nwire/app": "^0.13.1",
+    "@nwire/endpoint": "^0.13.1",
+    "@nwire/koa": "^0.13.1",
+    "@nwire/wires": "^0.13.1",
     "zod": "^4.0.0"
   },
   "devDependencies": {
-    "@nwire/cli": "^0.13.0",
+    "@nwire/cli": "^0.13.1",
     "@types/node": "^22.19.9",
     "typescript": "^5.9.0",
     "vitest": "^4.0.18"

package/templates/service/AGENTS.md

@@ -58,7 +58,7 @@ listener file (not `on` — `on` is for lifecycle hooks).
 
 ## Commands
 
-- `pnpm dev` — run the app (HTTP on :3000).
+- `pnpm dev` — wire + Studio on http://localhost:4000.
 - `pnpm test` — run the test suite.
 - `pnpm doctor` — health-check the project setup.
 - `pnpm studio` — open the live trace/inspect console.

package/templates/service/README.md

@@ -16,18 +16,20 @@ pnpm dev
 
 ## Try
 
+`pnpm dev` serves the wire + Studio on http://localhost:4000.
+
 ```bash
 # create a todo
-curl -X POST http://localhost:3000/api/todos \
+curl -X POST http://localhost:4000/api/todos \
   -H "content-type: application/json" \
   -H "x-user-id: alice" \
   -d '{"text":"buy milk"}'
 
 # list this user's todos
-curl -H "x-user-id: alice" http://localhost:3000/api/todos
+curl -H "x-user-id: alice" http://localhost:4000/api/todos
 
 # complete one
-curl -X POST http://localhost:3000/api/todos/<id>/complete \
+curl -X POST http://localhost:4000/api/todos/<id>/complete \
   -H "x-user-id: alice"
 ```
 

package/templates/service/app/main.ts

@@ -1,13 +1,13 @@
 /**
  * Entry — the only file that boots a real HTTP server.
  *
- *   pnpm dev
+ *   pnpm dev   # wire + Studio on http://localhost:4000
  *
- *   curl -X POST http://localhost:3000/api/todos \
+ *   curl -X POST http://localhost:4000/api/todos \
  *        -H "content-type: application/json" \
  *        -H "x-user-id: alice" \
  *        -d '{"text":"buy milk"}'
- *   curl -H "x-user-id: alice" http://localhost:3000/api/todos
+ *   curl -H "x-user-id: alice" http://localhost:4000/api/todos
  *
  * `app` is a pure value — routes are wired in `./app` on import.
  * This file adds the one side effect: binding a port and serving traffic.

package/templates/service/package.json

@@ -11,16 +11,16 @@
     "cache": "nwire cache"
   },
   "dependencies": {
-    "@nwire/app": "^0.13.0",
-    "@nwire/endpoint": "^0.13.0",
-    "@nwire/handler": "^0.13.0",
-    "@nwire/koa": "^0.13.0",
-    "@nwire/wires": "^0.13.0",
+    "@nwire/app": "^0.13.1",
+    "@nwire/endpoint": "^0.13.1",
+    "@nwire/handler": "^0.13.1",
+    "@nwire/koa": "^0.13.1",
+    "@nwire/wires": "^0.13.1",
     "koa": "^2.16.1",
     "zod": "^4.0.0"
   },
   "devDependencies": {
-    "@nwire/cli": "^0.13.0",
+    "@nwire/cli": "^0.13.1",
     "@types/koa": "^2.15.0",
     "@types/node": "^22.19.9",
     "typescript": "^5.9.0",