@nifrajs/cli 2.1.0 → 2.3.0

package/dist/mcp-protocol.js

@@ -1,7 +1,7 @@
 /**
  * The MCP JSON-RPC dispatch now lives in `@nifrajs/mcp` (shared with nifra apps that expose their own
- * MCP server / MCP Apps widgets). This module is a thin re-export so the CLI's existing imports — and
- * the `@nifrajs/cli/mcp` self-host surface — keep resolving here unchanged.
+ * MCP server / MCP Apps widgets). This module is a thin re-export so the CLI's existing imports - and
+ * the `@nifrajs/cli/mcp` self-host surface - keep resolving here unchanged.
  */
 export * from "@nifrajs/mcp/protocol";
 //# sourceMappingURL=mcp-protocol.js.map

package/dist/mcp-render.d.ts

@@ -1,12 +1,12 @@
 /**
- * The `nifra_render` engine + its child-process entry — the page half of `nifra_run`. Where `nifra_run`
+ * The `nifra_render` engine + its child-process entry - the page half of `nifra_run`. Where `nifra_run`
  * runs requests through the BACKEND, this SSRs page routes through the WEB app (`createWebApp`), so an
  * agent can verify a page renders and its loader ran after an edit. Spawned fresh per call (`bun
  * mcp-render.ts <cwd>`) so the project's CURRENT route/loader code is loaded.
  *
- * No build required: a placeholder `clientEntry` is injected (the SSR HTML renders regardless — the
+ * No build required: a placeholder `clientEntry` is injected (the SSR HTML renders regardless - the
  * client bundle only matters for hydration in the browser, not for "did this page render server-side").
- * {@link renderPages} never throws — every failure (no config, a loader error, a render throw) becomes
+ * {@link renderPages} never throws - every failure (no config, a loader error, a render throw) becomes
  * `{ error }` so the agent gets the actionable message.
  */
 export declare function renderPages(cwd: string, requests: unknown): Promise<{

package/dist/mcp-render.js

@@ -1,12 +1,12 @@
 /**
- * The `nifra_render` engine + its child-process entry — the page half of `nifra_run`. Where `nifra_run`
+ * The `nifra_render` engine + its child-process entry - the page half of `nifra_run`. Where `nifra_run`
  * runs requests through the BACKEND, this SSRs page routes through the WEB app (`createWebApp`), so an
  * agent can verify a page renders and its loader ran after an edit. Spawned fresh per call (`bun
  * mcp-render.ts <cwd>`) so the project's CURRENT route/loader code is loaded.
  *
- * No build required: a placeholder `clientEntry` is injected (the SSR HTML renders regardless — the
+ * No build required: a placeholder `clientEntry` is injected (the SSR HTML renders regardless - the
  * client bundle only matters for hydration in the browser, not for "did this page render server-side").
- * {@link renderPages} never throws — every failure (no config, a loader error, a render throw) becomes
+ * {@link renderPages} never throws - every failure (no config, a loader error, a render throw) becomes
  * `{ error }` so the agent gets the actionable message.
  */
 import { inProcessClient } from "@nifrajs/client";
@@ -15,7 +15,7 @@ import { createWebApp } from "@nifrajs/web";
 import { discoverRoutes } from "@nifrajs/web/fs";
 import { loadApp, resolvePlugins } from "./load.js";
 const errString = (err) => err instanceof Error ? `${err.name}: ${err.message}` : String(err);
-/** Load the project, register its SSR plugins, and build the SSR `createWebApp` once — the cost the warm
+/** Load the project, register its SSR plugins, and build the SSR `createWebApp` once - the cost the warm
  * worker amortizes across calls. Never throws (every failure → `{ error }`). Factored out of
  * {@link renderPages} so the cold path (fresh process per call) and the warm worker share one builder. */
 async function buildWebApp(cwd) {
@@ -79,7 +79,7 @@ function redirectConsoleToStderr() {
 /**
  * Warm-worker loop (`--worker`): build the web app ONCE, then SSR each `{ id, input: { requests } }` line
  * against that hot app and reply `{ id, output }`. The parent (`mcp.ts`'s warm-render handler) spawns this,
- * fingerprints the source tree, and restarts the worker when a file changes — so warm reuse never serves a
+ * fingerprints the source tree, and restarts the worker when a file changes - so warm reuse never serves a
  * stale render. Mirrors `mcp-run.ts`'s worker (single backend entry → no per-call entry key needed here).
  */
 async function runWorker(cwd) {
@@ -136,7 +136,7 @@ if (import.meta.main) {
     // The parent (mcp.ts) spawns `bun mcp-render.ts <cwd>` WITHOUT setting the subprocess `cwd` option, so
     // this process inherits the MCP server's working dir, not the app's. SSR resolves `react-dom/server`
     // from `process.cwd()` to share ONE React core with the app's route components (the dual-React fix in
-    // @nifrajs/web-react) — so we must chdir to the app root before any render. Best-effort: a bad path
+    // @nifrajs/web-react) - so we must chdir to the app root before any render. Best-effort: a bad path
     // surfaces later as a load error rather than crashing the child here.
     if (cwd !== process.cwd()) {
         try {
@@ -159,6 +159,14 @@ if (import.meta.main) {
     catch {
         output = { error: "invalid input: expected JSON { requests: [...] }" };
     }
-    process.stdout.write(JSON.stringify(output, null, 2));
+    await Bun.write(Bun.stdout, JSON.stringify(output, null, 2));
+    // Exit explicitly, exactly as the `--worker` branch above already does.
+    //
+    // Loading the app runs its module side effects, and a real app opens things: a database pool, a
+    // Redis client, a metrics interval. Any one of those keeps the event loop alive, so falling off
+    // the end of this module never terminates the process - and the parent is sitting in
+    // `await proc.exited`. The render itself finished; there is nothing left to wait for, and this
+    // process is single-use. `Bun.write` above is awaited so the output is flushed before we exit.
+    process.exit(0);
 }
 //# sourceMappingURL=mcp-render.js.map

package/dist/mcp-render.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-render.js","sourceRoot":"","sources":["../src/mcp-render.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-render.js","sourceRoot":"","sources":["../src/mcp-render.ts"],"names":[],"mappings":"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"}

package/dist/mcp-run.d.ts

@@ -1,6 +1,6 @@
 /**
  * The `nifra_run` engine + its child-process entry. The MCP server spawns this file fresh on every
- * `nifra_run` call (`bun mcp-run.ts <cwd>`) so the project's CURRENT backend code is loaded — picking
+ * `nifra_run` call (`bun mcp-run.ts <cwd>`) so the project's CURRENT backend code is loaded - picking
  * up the agent's latest edits. {@link runBackend} is the pure-ish core (resolve entry → import → run),
  * exported so it's unit-testable in-process; the entry below wires it to stdin/stdout.
  */
@@ -12,7 +12,7 @@ export declare function loadBackend(cwd: string, entry?: string): Promise<{
 }>;
 /**
  * Resolve the backend entry under `cwd`, import it, and run `requests` through its exported app. Never
- * throws — every failure (missing/invalid entry, import/compile/runtime error) becomes `{ error }`, so
+ * throws - every failure (missing/invalid entry, import/compile/runtime error) becomes `{ error }`, so
  * the caller (and the agent) always gets actionable output. An import error here IS the failure the
  * agent needs to see and fix.
  */

package/dist/mcp-run.js

@@ -1,6 +1,6 @@
 /**
  * The `nifra_run` engine + its child-process entry. The MCP server spawns this file fresh on every
- * `nifra_run` call (`bun mcp-run.ts <cwd>`) so the project's CURRENT backend code is loaded — picking
+ * `nifra_run` call (`bun mcp-run.ts <cwd>`) so the project's CURRENT backend code is loaded - picking
  * up the agent's latest edits. {@link runBackend} is the pure-ish core (resolve entry → import → run),
  * exported so it's unit-testable in-process; the entry below wires it to stdin/stdout.
  */
@@ -47,7 +47,7 @@ export async function loadBackend(cwd, entry) {
 }
 /**
  * Resolve the backend entry under `cwd`, import it, and run `requests` through its exported app. Never
- * throws — every failure (missing/invalid entry, import/compile/runtime error) becomes `{ error }`, so
+ * throws - every failure (missing/invalid entry, import/compile/runtime error) becomes `{ error }`, so
  * the caller (and the agent) always gets actionable output. An import error here IS the failure the
  * agent needs to see and fix.
  */

package/dist/mcp.d.ts

@@ -1,27 +1,27 @@
 /**
- * `nifra mcp` — a Model Context Protocol server (stdio) that lets a coding agent (Claude, Cursor, …)
+ * `nifra mcp` - a Model Context Protocol server (stdio) that lets a coding agent (Claude, Cursor, …)
  * act on a nifra project, not just read about it:
  *
- *   - `nifra_context` — this project's API routes + page routes + conventions (see {@link describeProject}).
- *   - `nifra_run`     — run HTTP requests through the project's backend and return structured results
+ *   - `nifra_context` - this project's API routes + page routes + conventions (see {@link describeProject}).
+ *   - `nifra_run`     - run HTTP requests through the project's backend and return structured results
  *     (status, body, errors). The write → run → see-the-failure → fix loop, powered by `@nifrajs/runner`.
  *     Each call runs the backend in a FRESH subprocess, so it reflects the agent's latest edits.
- *   - `nifra_render`  — SSR a page route through the project's web app; returns the rendered HTML (the
+ *   - `nifra_render`  - SSR a page route through the project's web app; returns the rendered HTML (the
  *     page half of `nifra_run`). Fresh subprocess per call; no build needed.
- *   - `nifra_ws`      — verify a WebSocket route with a real Bun WebSocket round-trip.
- *   - `nifra_docs`    — keyword-search the framework docs; returns only the matching sections.
- *   - `nifra_example` — a verified, copy-pasteable snippet for a task (typechecked against the live API,
+ *   - `nifra_ws`      - verify a WebSocket route with a real Bun WebSocket round-trip.
+ *   - `nifra_docs`    - keyword-search the framework docs; returns only the matching sections.
+ *   - `nifra_example` - a verified, copy-pasteable snippet for a task (typechecked against the live API,
  *     so it can't hallucinate a drifted nifra API).
- *   - `nifra_scaffold`— map a URL path to the correct `routes/` file + a contract-correct page stub.
- *   - `nifra_check`   — the drift gate (typecheck + lints, each with a structured fix), for an agent to fix against.
- *   - `nifra_assure`  — route classification + enforcement-evidence gate.
+ *   - `nifra_scaffold`- map a URL path to the correct `routes/` file + a contract-correct page stub.
+ *   - `nifra_check`   - the drift gate (typecheck + lints, each with a structured fix), for an agent to fix against.
+ *   - `nifra_assure`  - route classification + enforcement-evidence gate.
  *   - `nifra_levels`  - the cumulative verification ladder (L0 contract → L4 invariants): what the
  *     project actually proves, and why each level it misses does not hold.
- *   - `nifra_doctor`  — package.json dependency drift detector, with safe local-version auto-fix.
+ *   - `nifra_doctor`  - package.json dependency drift detector, with safe local-version auto-fix.
  *
  * Wire it into a client (e.g. Claude Desktop / Cursor) as: command `nifra`, args `["mcp"]`, run in the
  * project root. The protocol is hand-rolled (newline-delimited JSON-RPC 2.0 over stdio), including
- * standard MCP progress notifications and request cancellation — no SDK dependency, the same
+ * standard MCP progress notifications and request cancellation - no SDK dependency, the same
  * minimal-surface choice as the rest of nifra. The pure dispatch lives in `./mcp-protocol.ts`; this
  * module is the I/O shell (stdin loop, tool wiring, the run subprocess).
  */
@@ -29,7 +29,7 @@ import type { LoadAppOptions, LoadedApp } from "./load.js";
 import { type McpPrompt, type McpResource, type McpServerFeatures, type McpTool } from "./mcp-protocol.js";
 /** A persistent `mcp-run`/`mcp-render` `--worker` subprocess: the backend/web app is loaded ONCE and
  * reused across newline-delimited `{ id, input }` requests, replying `{ id, output }`. The same machinery
- * powers both `nifra_run warm` and `nifra_render warm` — `child` selects which engine, `label` shapes the
+ * powers both `nifra_run warm` and `nifra_render warm` - `child` selects which engine, `label` shapes the
  * cancellation message. The owning handler ({@link createWarmHandler}) fingerprints the source tree and
  * replaces the worker when a file changes, so warm reuse never serves a stale result. Exported for the
  * concurrency test that proves a single per-request cancel doesn't tear down the shared worker. */
@@ -60,7 +60,7 @@ export declare function projectResources(cwd: string, loadAppCached?: (outDirNam
 export declare function projectPrompts(): McpPrompt[];
 export declare function projectFeatures(cwd: string, loadAppCached?: (outDirName?: string) => Promise<LoadedApp>): McpServerFeatures;
 /**
- * Resolve an optional `dir` tool argument — a subdirectory of the project root the caller wants to scope a
+ * Resolve an optional `dir` tool argument - a subdirectory of the project root the caller wants to scope a
  * check/test to (e.g. `nifra check` on `app/` when the MCP server's root is a monorepo). Returns the
  * absolute target, or `null` if `dir` escapes the root (a path-traversal guard: no `..` out, no absolute
  * path elsewhere). `undefined`/empty → the root itself.

package/dist/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAUH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAG1D,OAAO,EAML,KAAK,SAAS,EAEd,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,OAAO,EAIb,MAAM,mBAAmB,CAAA;AA4E1B;;;;;mGAKmG;AACnG,qBAAa,UAAU;IAkBnB,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAlBxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAOrB;IACH,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,MAAM,CAAQ;gBAGpB,KAAK,EAAE,SAAS,GAAG,YAAY,EAC/B,GAAG,EAAE,MAAM,EACF,WAAW,EAAE,MAAM,EACX,KAAK,EAAE,MAAM;IAsBhC,IAAI,IAAI,IAAI;IAIN,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;YA2BtD,UAAU;YAiBV,UAAU;IAUxB,OAAO,CAAC,UAAU;CAkBnB;AAsFD,KAAK,eAAe,GAAG,CACrB,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,cAAc,KACrB,OAAO,CAAC,SAAS,CAAC,CAAA;AAEvB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAA;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CACxD;AAmCD,qGAAqG;AACrG,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,sBAA2B,GACnC,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CA+B7C;AA0CD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAA8B,GACtF,WAAW,EAAE,CAmCf;AAED,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAkE5C;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAA8B,GACtF,iBAAiB,CAEnB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAItF;AAWD,gDAAgD;AAChD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAA8B,GACtF,OAAO,EAAE,CAqdX;AAOD;yFACyF;AACzF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,CAoD/D;AAYD,gHAAgH;AAChH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,EAAE,CAqBvE;AAWD,4GAA4G;AAC5G,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,CAgBnE;AA2BD,uGAAuG;AACvG,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyF9E"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAUH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAG1D,OAAO,EAML,KAAK,SAAS,EAEd,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,OAAO,EAIb,MAAM,mBAAmB,CAAA;AA0G1B;;;;;mGAKmG;AACnG,qBAAa,UAAU;IAkBnB,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAlBxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAOrB;IACH,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,MAAM,CAAQ;gBAGpB,KAAK,EAAE,SAAS,GAAG,YAAY,EAC/B,GAAG,EAAE,MAAM,EACF,WAAW,EAAE,MAAM,EACX,KAAK,EAAE,MAAM;IAsBhC,IAAI,IAAI,IAAI;IAIN,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;YAwCtD,UAAU;YAiBV,UAAU;IAUxB,OAAO,CAAC,UAAU;CAkBnB;AAsFD,KAAK,eAAe,GAAG,CACrB,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,cAAc,KACrB,OAAO,CAAC,SAAS,CAAC,CAAA;AAEvB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAA;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CACxD;AAmCD,qGAAqG;AACrG,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,sBAA2B,GACnC,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CA+B7C;AA0CD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAA8B,GACtF,WAAW,EAAE,CAmCf;AAED,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAkE5C;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAA8B,GACtF,iBAAiB,CAEnB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAItF;AAWD,gDAAgD;AAChD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAA8B,GACtF,OAAO,EAAE,CAqdX;AAOD;yFACyF;AACzF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,CAoD/D;AAYD,gHAAgH;AAChH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,EAAE,CAqBvE;AAWD,4GAA4G;AAC5G,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,CAgBnE;AA2ED,uGAAuG;AACvG,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8E9E"}

package/dist/mcp.js

@@ -1,27 +1,27 @@
 /**
- * `nifra mcp` — a Model Context Protocol server (stdio) that lets a coding agent (Claude, Cursor, …)
+ * `nifra mcp` - a Model Context Protocol server (stdio) that lets a coding agent (Claude, Cursor, …)
  * act on a nifra project, not just read about it:
  *
- *   - `nifra_context` — this project's API routes + page routes + conventions (see {@link describeProject}).
- *   - `nifra_run`     — run HTTP requests through the project's backend and return structured results
+ *   - `nifra_context` - this project's API routes + page routes + conventions (see {@link describeProject}).
+ *   - `nifra_run`     - run HTTP requests through the project's backend and return structured results
  *     (status, body, errors). The write → run → see-the-failure → fix loop, powered by `@nifrajs/runner`.
  *     Each call runs the backend in a FRESH subprocess, so it reflects the agent's latest edits.
- *   - `nifra_render`  — SSR a page route through the project's web app; returns the rendered HTML (the
+ *   - `nifra_render`  - SSR a page route through the project's web app; returns the rendered HTML (the
  *     page half of `nifra_run`). Fresh subprocess per call; no build needed.
- *   - `nifra_ws`      — verify a WebSocket route with a real Bun WebSocket round-trip.
- *   - `nifra_docs`    — keyword-search the framework docs; returns only the matching sections.
- *   - `nifra_example` — a verified, copy-pasteable snippet for a task (typechecked against the live API,
+ *   - `nifra_ws`      - verify a WebSocket route with a real Bun WebSocket round-trip.
+ *   - `nifra_docs`    - keyword-search the framework docs; returns only the matching sections.
+ *   - `nifra_example` - a verified, copy-pasteable snippet for a task (typechecked against the live API,
  *     so it can't hallucinate a drifted nifra API).
- *   - `nifra_scaffold`— map a URL path to the correct `routes/` file + a contract-correct page stub.
- *   - `nifra_check`   — the drift gate (typecheck + lints, each with a structured fix), for an agent to fix against.
- *   - `nifra_assure`  — route classification + enforcement-evidence gate.
+ *   - `nifra_scaffold`- map a URL path to the correct `routes/` file + a contract-correct page stub.
+ *   - `nifra_check`   - the drift gate (typecheck + lints, each with a structured fix), for an agent to fix against.
+ *   - `nifra_assure`  - route classification + enforcement-evidence gate.
  *   - `nifra_levels`  - the cumulative verification ladder (L0 contract → L4 invariants): what the
  *     project actually proves, and why each level it misses does not hold.
- *   - `nifra_doctor`  — package.json dependency drift detector, with safe local-version auto-fix.
+ *   - `nifra_doctor`  - package.json dependency drift detector, with safe local-version auto-fix.
  *
  * Wire it into a client (e.g. Claude Desktop / Cursor) as: command `nifra`, args `["mcp"]`, run in the
  * project root. The protocol is hand-rolled (newline-delimited JSON-RPC 2.0 over stdio), including
- * standard MCP progress notifications and request cancellation — no SDK dependency, the same
+ * standard MCP progress notifications and request cancellation - no SDK dependency, the same
  * minimal-surface choice as the rest of nifra. The pure dispatch lives in `./mcp-protocol.ts`; this
  * module is the I/O shell (stdin loop, tool wiring, the run subprocess).
  */
@@ -43,6 +43,23 @@ function childPath(name) {
     return fileURLToPath(new URL(import.meta.url)).replace(/mcp\.(ts|js)$/, `${name}.$1`);
 }
 /** Spawn `bun <child> <cwd>`, pipe `input` to its stdin, return its stdout (or a stderr-backed error). */
+/**
+ * How long a child gets before it is killed.
+ *
+ * A child loads the app, which runs its module side effects - a database pool, a Redis client, a
+ * metrics interval. Any of those keeps the child's event loop alive after the work is done, and the
+ * parent is sitting in `await proc.exited`. The children now exit explicitly, so this is the backstop
+ * rather than the fix: without it a single wedged child blocks an agent indefinitely, and the caller
+ * has no way to tell "still working" from "never returning".
+ *
+ * Generous enough for a cold start that compiles route modules, short enough that a hang is reported
+ * within one attention span rather than after minutes of polling.
+ */
+const CHILD_TIMEOUT_MS = 30_000;
+const timeoutMessage = (label, ms) => `${label} timed out after ${ms / 1000}s and was terminated.\n` +
+    `The app was loaded but the process did not finish. Most often this is a module-level side effect ` +
+    `that keeps the event loop alive (a database pool, a Redis client, an interval) opened during import ` +
+    `rather than lazily. Check for top-level connections in the app entry or anything it imports.`;
 async function spawnChild(child, cwd, input, label, signal) {
     if (signal?.aborted)
         return `${label} cancelled before it started.`;
@@ -53,6 +70,11 @@ async function spawnChild(child, cwd, input, label, signal) {
     });
     const abort = () => proc.kill();
     signal?.addEventListener("abort", abort, { once: true });
+    let timedOut = false;
+    const timer = setTimeout(() => {
+        timedOut = true;
+        proc.kill();
+    }, CHILD_TIMEOUT_MS);
     try {
         proc.stdin.write(JSON.stringify(input));
         await proc.stdin.end();
@@ -65,9 +87,15 @@ async function spawnChild(child, cwd, input, label, signal) {
             const reason = typeof signal.reason === "string" ? `: ${signal.reason}` : "";
             return `${label} cancelled${reason}.`;
         }
-        return out.trim() || `${label} failed:\n${err.trim() || "(no output)"}`;
+        // A killed child may still have flushed a complete result before the timer fired; prefer real
+        // output over the timeout message so a slow-but-successful render is not reported as a failure.
+        const text = out.trim();
+        if (timedOut && text === "")
+            return timeoutMessage(label, CHILD_TIMEOUT_MS);
+        return text || `${label} failed:\n${err.trim() || "(no output)"}`;
     }
     finally {
+        clearTimeout(timer);
         signal?.removeEventListener("abort", abort);
     }
 }
@@ -99,7 +127,7 @@ function boundedAppend(current, next, max = 12_000) {
 }
 /** A persistent `mcp-run`/`mcp-render` `--worker` subprocess: the backend/web app is loaded ONCE and
  * reused across newline-delimited `{ id, input }` requests, replying `{ id, output }`. The same machinery
- * powers both `nifra_run warm` and `nifra_render warm` — `child` selects which engine, `label` shapes the
+ * powers both `nifra_run warm` and `nifra_render warm` - `child` selects which engine, `label` shapes the
  * cancellation message. The owning handler ({@link createWarmHandler}) fingerprints the source tree and
  * replaces the worker when a file changes, so warm reuse never serves a stale result. Exported for the
  * concurrency test that proves a single per-request cancel doesn't tear down the shared worker. */
@@ -147,12 +175,26 @@ export class WarmWorker {
                 // Per-request cancel: drop just THIS id and resolve its cancellation. The worker is shared
                 // across concurrent requests (`pending` is id-keyed for exactly this reason), so killing the
                 // process here would reject every OTHER in-flight request via the `exited` handler and force a
-                // cold rebuild. Leave it hot — `createWarmHandler` already replaces it on file change.
+                // cold rebuild. Leave it hot - `createWarmHandler` already replaces it on file change.
                 this.pending.delete(id);
+                clearTimeout(timer);
                 const reason = typeof signal?.reason === "string" ? `: ${signal.reason}` : "";
                 resolve(`${this.label} cancelled${reason}.`);
             };
-            const cleanup = () => signal?.removeEventListener("abort", abort);
+            // Same backstop as the cold path: a worker wedged mid-request would otherwise leave this
+            // promise unsettled forever. Drop the id and replace the worker - unlike a per-request cancel,
+            // a timeout means the worker itself is suspect, so the next call should start from a fresh one.
+            const timer = setTimeout(() => {
+                if (!this.pending.delete(id))
+                    return;
+                signal?.removeEventListener("abort", abort);
+                this.stop();
+                resolve(timeoutMessage(this.label, CHILD_TIMEOUT_MS));
+            }, CHILD_TIMEOUT_MS);
+            const cleanup = () => {
+                clearTimeout(timer);
+                signal?.removeEventListener("abort", abort);
+            };
             signal?.addEventListener("abort", abort, { once: true });
             this.pending.set(id, { resolve, reject, cleanup });
             try {
@@ -214,7 +256,7 @@ export class WarmWorker {
 }
 /** A warm handler that reuses a hot {@link WarmWorker} across calls and falls back to a one-shot fresh
  * subprocess on any worker failure. Shared by `nifra_run` (`child: "mcp-run"`, `label: "run"`) and
- * `nifra_render` (`child: "mcp-render"`, `label: "render"`) — the only differences are the engine and the
+ * `nifra_render` (`child: "mcp-render"`, `label: "render"`) - the only differences are the engine and the
  * message label, so there's a single source for the reuse + auto-restart-on-file-change logic. */
 function createWarmHandler(child, cwd, label) {
     let worker;
@@ -442,7 +484,7 @@ export function projectFeatures(cwd, loadAppCached = createCachedAppLoader(cwd))
     return { resources: projectResources(cwd, loadAppCached), prompts: projectPrompts() };
 }
 /**
- * Resolve an optional `dir` tool argument — a subdirectory of the project root the caller wants to scope a
+ * Resolve an optional `dir` tool argument - a subdirectory of the project root the caller wants to scope a
  * check/test to (e.g. `nifra check` on `app/` when the MCP server's root is a monorepo). Returns the
  * absolute target, or `null` if `dir` escapes the root (a path-traversal guard: no `..` out, no absolute
  * path elsewhere). `undefined`/empty → the root itself.
@@ -455,7 +497,7 @@ export function resolveProjectDir(root, dir) {
 }
 /** Consistent error string for a `dir` that escapes the project root. */
 function dirError(dir) {
-    return JSON.stringify({ ok: false, error: `dir must be a subdirectory of the project root — "${dir}" escapes it.` }, null, 2);
+    return JSON.stringify({ ok: false, error: `dir must be a subdirectory of the project root - "${dir}" escapes it.` }, null, 2);
 }
 /** Build the project-scoped tools for `cwd`. */
 export function projectTools(cwd, loadAppCached = createCachedAppLoader(cwd)) {
@@ -464,7 +506,7 @@ export function projectTools(cwd, loadAppCached = createCachedAppLoader(cwd)) {
     return [
         {
             name: "nifra_context",
-            description: "Get this nifra project's surface. Call it once UNFILTERED for a tight INDEX: the route list (API routes as `METHOD path`, page routes as `pattern → file`) + framework conventions + a pointer — cheap even on a big app, no per-route schema dump. Then pass `path` (a route prefix like /api/orders) and/or `kind` (api|pages) to fetch the FULL contract for that slice (body/query/response TS shapes + the exact typed-client call form).",
+            description: "Get this nifra project's surface. Call it once UNFILTERED for a tight INDEX: the route list (API routes as `METHOD path`, page routes as `pattern → file`) + framework conventions + a pointer - cheap even on a big app, no per-route schema dump. Then pass `path` (a route prefix like /api/orders) and/or `kind` (api|pages) to fetch the FULL contract for that slice (body/query/response TS shapes + the exact typed-client call form).",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -487,7 +529,7 @@ export function projectTools(cwd, loadAppCached = createCachedAppLoader(cwd)) {
         },
         {
             name: "nifra_routes",
-            description: "List this project's API routes as STRUCTURED JSON — each `{ method, path, call, body?, query?, response? }`, where `call` is the exact typed-client call form and the shapes are compact TS-typed contracts. For programmatic use (list_routes / get_route_schema) instead of parsing the nifra_context Markdown. No args = every route; pass `path` (a path or prefix like /api/orders) to narrow to those routes.",
+            description: "List this project's API routes as STRUCTURED JSON - each `{ method, path, call, body?, query?, response? }`, where `call` is the exact typed-client call form and the shapes are compact TS-typed contracts. For programmatic use (list_routes / get_route_schema) instead of parsing the nifra_context Markdown. No args = every route; pass `path` (a path or prefix like /api/orders) to narrow to those routes.",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -652,7 +694,7 @@ export function projectTools(cwd, loadAppCached = createCachedAppLoader(cwd)) {
         ...docsTools(loadDocsCorpus, loadExamplesCorpus, loadTypesCorpus),
         {
             name: "nifra_scaffold",
-            description: 'Map a URL path to the CORRECT routes/ file and get a contract-correct page stub. Agents routinely place file routes wrong — this applies the convention for you: ":id"/"[id]" → [id], "*rest" → [...rest], "/" → index. Pass path (e.g. "/users/:id"). Returns the file to create + the route-module contract (loader/action/meta/default) + a stub (ready-to-write for react/preact/solid; path+contract for vue/svelte/vanilla — use nifra_example for those bodies).',
+            description: 'Map a URL path to the CORRECT routes/ file and get a contract-correct page stub. Agents routinely place file routes wrong - this applies the convention for you: ":id"/"[id]" → [id], "*rest" → [...rest], "/" → index. Pass path (e.g. "/users/:id"). Returns the file to create + the route-module contract (loader/action/meta/default) + a stub (ready-to-write for react/preact/solid; path+contract for vue/svelte/vanilla - use nifra_example for those bodies).',
             inputSchema: {
                 type: "object",
                 properties: {
@@ -686,7 +728,7 @@ export function projectTools(cwd, loadAppCached = createCachedAppLoader(cwd)) {
         },
         {
             name: "nifra_check",
-            description: 'Run the project\'s drift gate and return a structured result { ok, typecheck, diagnostics[] }: typecheck (the frontend↔backend contract), plus lints for hand-rolled fetch() to your own API, untyped client("…") calls missing <typeof app>, and server-only imports in routes/. Pass lintsOnly:true for a near-instant lint pass while iterating; run the full gate (default) to confirm the work is done — fix every diagnostic before finishing.',
+            description: 'Run the project\'s drift gate and return a structured result { ok, typecheck, diagnostics[] }: typecheck (the frontend↔backend contract), plus lints for hand-rolled fetch() to your own API, untyped client("…") calls missing <typeof app>, and server-only imports in routes/. Pass lintsOnly:true for a near-instant lint pass while iterating; run the full gate (default) to confirm the work is done - fix every diagnostic before finishing.',
             inputSchema: {
                 type: "object",
                 properties: {
@@ -855,7 +897,7 @@ export function projectTools(cwd, loadAppCached = createCachedAppLoader(cwd)) {
         },
         {
             name: "nifra_doctor",
-            description: "Check this project for packages imported in source but NOT declared in package.json — the Bun-workspace trap where an import resolves at runtime (hoisting/workspace) so tests pass and `bun install` says no changes, yet tsc fails and a fresh/standalone install can't resolve it. Returns { ok, ran, findings[], fixed?, skippedFixes? }. Pass autoFix:true to update package.json only when the dependency version can be inferred locally from an ancestor package.json or installed package metadata; otherwise the tool returns the exact bun add command to run.",
+            description: "Check this project for packages imported in source but NOT declared in package.json - the Bun-workspace trap where an import resolves at runtime (hoisting/workspace) so tests pass and `bun install` says no changes, yet tsc fails and a fresh/standalone install can't resolve it. Returns { ok, ran, findings[], fixed?, skippedFixes? }. Pass autoFix:true to update package.json only when the dependency version can be inferred locally from an ancestor package.json or installed package metadata; otherwise the tool returns the exact bun add command to run.",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -986,6 +1028,51 @@ function namespaceForApp(name, tools, features) {
         features: { resources: namespacedResources, prompts: namespacedPrompts },
     };
 }
+/**
+ * Merge the backend-derived resources/prompts into `base` - and keep a project that cannot be loaded
+ * from deciding whether the server starts at all.
+ *
+ * Resources and prompts are OPTIONAL capabilities extracted from the app's backend, so this load is a
+ * best-effort enrichment. It was awaited unguarded, which made it a hard boot requirement: `loadApp`
+ * needs a web config (`adapter` + `clientModule`) and a `routes/` directory, and a backend-only
+ * project - the shape `create-nifra`'s DEFAULT template produces - has neither. On those projects the
+ * throw escaped before the JSON-RPC loop began, so the server wrote nothing and exited. `nifra
+ * init-agents` would happily register an `.mcp.json` pointing at a server that could never start, and
+ * every tool went with it, including the twelve that never touch the app (docs, examples, types,
+ * check, doctor, levels, test).
+ *
+ * Degrading costs only the backend resources/prompts. Tools that genuinely need the app still fail,
+ * but per call, with their own message - which is a diagnosis instead of a silence.
+ */
+async function backendFeatures(loader, base) {
+    const resources = [...(base.resources ?? [])];
+    const prompts = [...(base.prompts ?? [])];
+    try {
+        const app = await loader();
+        resources.push(...extractBackendResources(app.backend));
+        prompts.push(...extractBackendPrompts(app.backend));
+    }
+    catch {
+        // Not loadable here (no web config, or the config itself throws). The server still serves.
+    }
+    return { resources, prompts };
+}
+/**
+ * The MCP tools the app itself declares via `app.tool(...)`, or none when the app cannot be loaded.
+ *
+ * Same reasoning as {@link backendFeatures}, on the hotter path: this ran on EVERY JSON-RPC message,
+ * so an unloadable project failed `initialize` itself with a `-32603` and the session never opened.
+ * An app's own tools are an extension of the built-in set, so their absence must not withdraw the
+ * built-ins - a backend-only project still gets docs, examples, types, check, doctor, levels and test.
+ */
+async function appDeclaredTools(loader) {
+    try {
+        return extractBackendTools((await loader()).backend);
+    }
+    catch {
+        return [];
+    }
+}
 /** Run the stdio MCP server: read newline-delimited JSON-RPC from stdin, write responses to stdout. */
 export async function runMcpServer(cwd, version) {
     let features;
@@ -996,12 +1083,7 @@ export async function runMcpServer(cwd, version) {
         const allPrompts = [];
         for (const { name, cwd: appCwd } of appEntries) {
             const loader = createCachedAppLoader(appCwd);
-            const app = await loader();
-            const base = projectFeatures(appCwd, loader);
-            const ns = namespaceForApp(name, [], {
-                resources: [...(base.resources ?? []), ...extractBackendResources(app.backend)],
-                prompts: [...(base.prompts ?? []), ...extractBackendPrompts(app.backend)],
-            });
+            const ns = namespaceForApp(name, [], await backendFeatures(loader, projectFeatures(appCwd, loader)));
             allResources.push(...(ns.features.resources ?? []));
             allPrompts.push(...(ns.features.prompts ?? []));
         }
@@ -1009,12 +1091,7 @@ export async function runMcpServer(cwd, version) {
     }
     else {
         const loadAppCached = createCachedAppLoader(cwd);
-        const base = projectFeatures(cwd, loadAppCached);
-        const app = await loadAppCached();
-        features = {
-            resources: [...(base.resources ?? []), ...extractBackendResources(app.backend)],
-            prompts: [...(base.prompts ?? []), ...extractBackendPrompts(app.backend)],
-        };
+        features = await backendFeatures(loadAppCached, projectFeatures(cwd, loadAppCached));
     }
     const loadAppCached = createCachedAppLoader(cwd);
     const serverInfo = { name: "nifra", version };
@@ -1029,22 +1106,17 @@ export async function runMcpServer(cwd, version) {
             const allTools = [];
             for (const { name, cwd: appCwd } of appEntries) {
                 const loader = createCachedAppLoader(appCwd);
-                const app = await loader();
-                const baseTools = projectTools(appCwd, loader);
-                const backendTools = extractBackendTools(app.backend);
-                const ns = namespaceForApp(name, [...baseTools, ...backendTools], {
-                    resources: [],
-                    prompts: [],
-                });
+                const tools = [...projectTools(appCwd, loader), ...(await appDeclaredTools(loader))];
+                const ns = namespaceForApp(name, tools, { resources: [], prompts: [] });
                 allTools.push(...ns.tools);
             }
             activeTools = [...docsTools(loadDocsCorpus, loadExamplesCorpus, loadTypesCorpus), ...allTools];
         }
         else {
-            const app = await loadAppCached();
-            const baseTools = projectTools(cwd, loadAppCached);
-            const backendTools = extractBackendTools(app.backend);
-            activeTools = [...baseTools, ...backendTools];
+            activeTools = [
+                ...projectTools(cwd, loadAppCached),
+                ...(await appDeclaredTools(loadAppCached)),
+            ];
         }
         const response = await handleRpc(message, activeTools, serverInfo, features, {
             state,