create-stitchkit 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -6,6 +6,21 @@ is declared in the template root catalog.
 
 ## [Unreleased]
 
+## [0.3.2] — 2026-08-17
+
+### Changed
+
+- **The template targets Stitchkit 0.50.0 and binds process signals through the
+  framework.** Generated backends replace the hand-written shutdown coordinator
+  with `bindProcessSignals(server, …)`: MCP and Prisma close in `onComplete`, the
+  exit code is set there, and failures are reported by phase. The manual version
+  the template used to ship reported a failing `mcp.close()` as a failed
+  shutdown, did nothing on a third signal, and collapsed the grace period when a
+  supervisor delivered two signals at once.
+- **The repository example declares its domain error message once.**
+  `GITHUB_UNAVAILABLE` carries its text in the `defineErrors` definition instead
+  of repeating it at the throw site.
+
 ## [0.3.1] — 2026-08-15
 
 ### Changed

package/examples/repository/packages/backend/src/domain/errors.ts

@@ -4,6 +4,8 @@ import { z } from 'zod';
 export const { errors: domainErrors, codes: domainErrorCodes } = defineErrors({
   GITHUB_UNAVAILABLE: {
     status: 503,
+    // Declared once here instead of at every throw site.
+    message: 'GitHub repository data is temporarily unavailable',
     details: z.object({ cause: z.string() }),
   },
 });

package/examples/repository/packages/backend/src/domain/repository/github-cache.ts

@@ -197,7 +197,6 @@ export class GitHubRepositoryCache {
     } catch (error) {
       if (previous) return serialize(previous, 'stale');
       throw domainErrors.GITHUB_UNAVAILABLE({
-        message: 'GitHub repository data is temporarily unavailable',
         details: { cause: error instanceof Error ? error.message : 'Unknown upstream error' },
         hint: 'Retry after the upstream service recovers',
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-stitchkit",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Create a production-shaped Stitchkit application",
   "license": "MIT",
   "author": "Max Listov <maxlistov@gmail.com>",

package/template/bun.lock

@@ -138,7 +138,7 @@
     },
   },
   "catalog": {
-    "stitchkit": "^0.49.2",
+    "stitchkit": "^0.50.0",
   },
   "packages": {
     "@ai-sdk/gateway": ["@ai-sdk/gateway@4.0.46", "", { "dependencies": { "@ai-sdk/provider": "4.0.7", "@ai-sdk/provider-utils": "5.0.25", "@vercel/oidc": "3.2.0" }, "peerDependencies": { "zod": "^3.25.76 || ^4.1.8" } }, "sha512-LIAO6kAG8fpXQb9L0iwPk1FIbXftvqnyC56v5NEAzeWTeL8fUsy/Hx86VPBTWEDFdwbVprjWifJOAqS6AOj3mA=="],
@@ -1117,7 +1117,7 @@
 
     "std-env": ["std-env@3.10.0", "", {}, "sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg=="],
 
-    "stitchkit": ["stitchkit@0.49.2", "", { "dependencies": { "ky": "^2.0.2" }, "peerDependencies": { "@modelcontextprotocol/ext-apps": "^1.7.2", "@modelcontextprotocol/server": "^2.0.0", "@socket.io/bun-engine": "^0.1.1", "@socket.io/component-emitter": "^3.1.2", "@tanstack/react-query": ">=5", "@types/bun": "^1.3.14", "ai": "^7.0.0", "react": ">=18", "react-query-kit": "^3.3.3", "socket.io": "^4.8.3", "socket.io-client": "^4.8.3", "srvx": "^0.12.5", "zod": "^4.4.3" }, "optionalPeers": ["@modelcontextprotocol/ext-apps", "@modelcontextprotocol/server", "@socket.io/bun-engine", "@socket.io/component-emitter", "@tanstack/react-query", "@types/bun", "ai", "react", "react-query-kit", "socket.io", "socket.io-client", "srvx"] }, "sha512-QP0I//fs/khC+bTqYungjpZskAseQAB/Lm8UOx3mZDx+rmYtdsBhlAn0I0hBYE/du9jag5rE032s9HrZgT2VXg=="],
+    "stitchkit": ["stitchkit@0.50.0", "", { "dependencies": { "ky": "^2.0.2" }, "peerDependencies": { "@modelcontextprotocol/ext-apps": "^1.7.2", "@modelcontextprotocol/server": "^2.0.0", "@socket.io/bun-engine": "^0.1.1", "@socket.io/component-emitter": "^3.1.2", "@tanstack/react-query": ">=5", "@types/bun": "^1.3.14", "ai": "^7.0.0", "react": ">=18", "react-query-kit": "^3.3.3", "socket.io": "^4.8.3", "socket.io-client": "^4.8.3", "srvx": "^0.12.5", "zod": "^4.4.3" }, "optionalPeers": ["@modelcontextprotocol/ext-apps", "@modelcontextprotocol/server", "@socket.io/bun-engine", "@socket.io/component-emitter", "@tanstack/react-query", "@types/bun", "ai", "react", "react-query-kit", "socket.io", "socket.io-client", "srvx"] }, "sha512-lMadqgQ9aryAhULyA0biVjx9bn86HOUhcUj809TyHy2MuUZSnL9qI4fiByQbVAqlxW6i1a1RLAeguEJeu6jwWg=="],
 
     "stringify-entities": ["stringify-entities@4.0.4", "", { "dependencies": { "character-entities-html4": "^2.0.0", "character-entities-legacy": "^3.0.0" } }, "sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg=="],
 

package/template/package.json

@@ -7,7 +7,7 @@
     "packages/*"
   ],
   "catalog": {
-    "stitchkit": "^0.49.2"
+    "stitchkit": "^0.50.0"
   },
   "scripts": {
     "dev": "bun scripts/dev.ts",

package/template/packages/backend/src/index.ts

@@ -1,7 +1,12 @@
 import { env } from '@app/config';
 import { appIdentity } from '@app/config/identity';
 import { wrapInRequestContext } from 'stitchkit/observability';
-import { createServer, generateOpenApiDocument, openApiRoute } from 'stitchkit/server';
+import {
+  bindProcessSignals,
+  createServer,
+  generateOpenApiDocument,
+  openApiRoute,
+} from 'stitchkit/server';
 import { createMcpHandler, createMcpHttpRoute } from 'stitchkit/tools';
 import { prisma } from './lib/db';
 import { createSurface } from './surface';
@@ -39,33 +44,22 @@ async function main(): Promise<void> {
     wrapFetch: (fetch) => wrapInRequestContext(fetch),
   });
 
-  const shutdownController = new AbortController();
-  let shutdownPromise: Promise<void> | undefined;
-
-  function shutdown(): Promise<void> {
-    if (shutdownPromise) {
-      shutdownController.abort();
-      return shutdownPromise;
-    }
-
-    shutdownPromise = (async () => {
-      await server.shutdown({
-        gracePeriodMs: 30_000,
-        signal: shutdownController.signal,
-      });
+  // The server owns HTTP and Socket.IO; MCP, Prisma and the exit code are the
+  // application's and close after the drain. A second signal forces this same
+  // shutdown, a third hands the signal back to its default disposition.
+  bindProcessSignals(server, {
+    shutdown: { gracePeriodMs: 30_000 },
+    onComplete: async (result) => {
       await mcp.close();
       await prisma.$disconnect();
-    })();
-    return shutdownPromise;
-  }
-
-  const onSignal = () =>
-    void shutdown().catch((error: unknown) => {
-      console.error('Shutdown failed', error);
-    });
+      process.exitCode = result.outcome === 'clean' ? 0 : 1;
+    },
+    onError: (phase, error) => {
+      console.error(`Shutdown failed during ${phase}`, error);
+      process.exitCode = 1;
+    },
+  });
 
-  process.on('SIGTERM', onSignal);
-  process.on('SIGINT', onSignal);
   console.log(`API listening on http://127.0.0.1:${env.API_PORT}`);
 }